[batur]

Summary

Implements the TypeScript AI engineering baseline 0.1.0 with Spec Kit, Cucumber/Gherkin, Vitest TDD, contract-first profiles, traceability, approval gates, and formal OpenCode integration.

Delivery evidence

• Lane: Full
• Feature spec: specs/001-engineering-baseline/spec.md
• Requirement IDs: FR-001 through FR-018
• Success criteria: SC-001 through SC-012
• Gate 1: approved and recorded in specs/001-engineering-baseline/checklists/gate-1.md
• Gate 2: approved and recorded in specs/001-engineering-baseline/checklists/gate-2.md

Behavior and TDD

• Cucumber: 41 scenarios, 169 steps passing
• Vitest: 59 tests passing
• Cucumber dry run: passing
• Contract/provider tests: passing
• Meaningful RED evidence and final verification are recorded in specs/001-engineering-baseline/verification.yaml.

Contract impact

• Profiles: OpenAPI, AsyncAPI, GraphQL, gRPC/Protobuf
• Authoritative REST contract: contracts/openapi/baseline-api.yaml
• Generated artifacts: updated and drift-checked
• Compatibility: migration parity preserved; breaking fixtures fail as expected

OpenCode integration

• Official Spec Kit 1.0.5 OpenCode integration installed
• .opencode/commands/speckit.*.md generated
• .specify/integration.json defaults to opencode
• .specify/integrations/opencode.manifest.json tracks managed files
• Fresh, brownfield, and idempotent lifecycle coverage added

Verification

• pnpm baseline:check
• pnpm format:check
• pnpm lint
• pnpm typecheck
• pnpm test
• pnpm test:bdd:dry
• pnpm test:bdd
• pnpm contracts:check
• pnpm build
• pnpm secrets:scan
• pnpm run audit

Risk / rollback

This is a baseline/tooling migration. The prior code-first OpenAPI generator was removed only after semantic and public-export parity checks. Rollback is a normal commit revert before merge; final merge approval remains human-controlled.

Human review checklist

• Scope, requirements, and success criteria reviewed.
• Gate 1 and Gate 2 records reviewed.
• Contract selectors and generated artifacts reviewed.
• CI, documentation, ADRs, and OpenCode integration reviewed.
• AI-generated changes received manual review.

[batur]

.