7441c9f298
All findings from the inaugural LeadValidator audit resolved and confirmed. Release gate: PASS. VV_ISSUE_002 (BLOCKER): 15 OpenAPI specs verified present covering all 20 route groups (46 endpoints documented in docs/openapi/) VV_ISSUE_003 (MAJOR): Remove any types from src/db/pool.ts — replaced pool.query shim with unknown[] + Object.defineProperty, zero any types, eslint-disable suppressions removed VV_ISSUE_004 (MAJOR): Remove raw Pool from ScaffoldController and HealthDetailedController — injected AgentRepository/CredentialRepository and DbProbe interface respectively; added CredentialRepository.findActiveClientId() VV_ISSUE_005 (MAJOR): Add unit tests for 5 untested services — ComplianceStatusStore, EventPublisher, MarketplaceService, OIDCTrustPolicyService, UsageService VV_ISSUE_006 (MAJOR): Add integration tests for 7 missing route groups — analytics, billing, tiers, webhooks, marketplace, oidc-trust-policies, oidc-token-exchange VV_ISSUE_001 (MINOR): Create missing design.md and tasks.md in 4 OpenSpec archives — all archives now complete Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2.0 KiB
2.0 KiB
Engineering Docs — Task Tracker
All tasks complete. Archive committed 2026-04-02.
WS1 — Core Knowledge Base (10 documents)
- 1.1 Create
docs/engineering/README.md— directory index and reading path - 1.2 Create
docs/engineering/01-overview.md— company mission, product vision, system purpose, team structure - 1.3 Create
docs/engineering/02-architecture.md— component diagram, data flows, deployment topology, technology rationale - 1.4 Create
docs/engineering/03-tech-stack.md— full stack with ADRs (Express, PostgreSQL, Redis, TypeScript, OPA, Vault) - 1.5 Create
docs/engineering/04-codebase-structure.md— annotated directory map covering all top-level directories and key files - 1.6 Create
docs/engineering/05-services.md— deep dives for AgentService, OAuth2Service, CredentialService, AuditService, VaultClient, OPA engine, Web Dashboard, Prometheus/Grafana - 1.7 Create
docs/engineering/06-walkthroughs.md— annotated traces for token issuance, agent registration, and credential rotation (with file:line references) - 1.8 Create
docs/engineering/07-dev-setup.md— < 30 min onboarding from clone to running local stack - 1.9 Create
docs/engineering/08-workflow.md— OpenSpec → Architect → Developer → QA → merge cycle and PR standards - 1.10 Create
docs/engineering/09-testing.md— framework, test types, coverage gates, how to run and write tests
WS2 — Operations and Integration
- 2.1 Create
docs/engineering/10-deployment.md— Docker build/run, Terraform multi-region, env config, monitoring runbooks - 2.2 Create
docs/engineering/11-sdk-guide.md— Node.js, Python, Go, Java SDK integration with installation, auth, operations, error handling
WS3 — Quality and Review
- 3.1 CTO review — all documents reviewed against PRD standards (calibration, accuracy, completeness)
- 3.2 QA sign-off — cross-link validation, code example verification