contract-driven-delivery 1.8.1 → 1.10.0

package/assets/specs-templates/design.md

@@ -1,23 +1,26 @@
-# Technical Design
+---
+change-id: <id>
+schema-version: 0.1.0
+last-changed: <date>
+---
 
-## Architecture Summary
+# Design: <change-id>
 
-## Affected Components
-
-## API Design
+## Summary
 
-## Data / Schema Design
+(1 paragraph: what changes architecturally and why)
 
-## UI / UX Design
+## Affected Components
 
-## Env / Config Design
+| component | file path(s) | nature of change |
+|---|---|---|
 
-## Error Handling
+## Key Decisions
 
-## Performance Considerations
+- **Decision**: rationale — rejected alternative: reason rejected
 
-## Security Considerations
+## Migration / Rollback
 
-## Deployment / Rollback
+(Prose description. SQL and code go in migration files, not here.)
 
-## Architecture Decision Notes
+## Open Risks

package/assets/specs-templates/test-plan.md

@@ -1,31 +1,25 @@
-# Test Plan
+---
+change-id: <id>
+schema-version: 0.1.0
+last-changed: <date>
+risk: low | medium | high
+tier: 0 | 1 | 2 | 3 | 4 | 5
+---
 
-## Acceptance Criteria Mapping
-| requirement | test family | planned file/spec | expected evidence |
-|---|---|---|---|
-
-## Unit Tests
-
-## Contract Tests
-
-## Integration Tests
+# Test Plan: <change-id>
 
-## E2E Tests
+## Acceptance Criteria → Test Mapping
 
-## Visual Tests / Review
-
-## Data Boundary Tests
-
-## Resilience Tests
-
-## Fuzz / Monkey Operation Tests
+| criterion id | test family | test file path | tier |
+|---|---|---|---|
+| AC-1 | unit | tests/unit/test_xxx.py | 0 |
 
-## Stress Tests
+## Test Families Required
 
-## Soak Tests
+Mark all that apply: unit / contract / integration / e2e / data-boundary / resilience / monkey / stress / soak
 
-## Mutation Checks
+## Out of Scope
 
-## Commands
+## Notes
 
-## CI/CD Gate Mapping
+(Keep this section under 10 lines. Implementation detail belongs in the test files themselves.)

package/dist/cli/index.js

@@ -26,6 +26,7 @@ var ASSET = {
   specsTemplates: join(ASSETS_DIR, "specs-templates"),
   testsTemplates: join(ASSETS_DIR, "tests-templates"),
   ci: join(ASSETS_DIR, "ci"),
+  githubWorkflows: join(ASSETS_DIR, "github-workflows"),
   hooks: join(ASSETS_DIR, "hooks"),
   claudeTemplate: join(ASSETS_DIR, "CLAUDE.template.md"),
   agentsTemplate: join(ASSETS_DIR, "AGENTS.template.md")
@@ -224,6 +225,18 @@ function detectStack(repoRoot) {
 }
 
 // src/commands/init.ts
+function readCondaEnvName(cwd) {
+  const envYml = join4(cwd, "environment.yml");
+  if (!existsSync3(envYml))
+    return "base";
+  try {
+    const content = readFileSync2(envYml, "utf8");
+    const match = content.match(/^name:\s*(.+)$/m);
+    return match ? match[1].trim() : "base";
+  } catch {
+    return "base";
+  }
+}
 function loadCiTemplate(stack) {
   const templatePath = join4(ASSETS_DIR, "ci-templates", `${stack}.yml`);
   if (!existsSync3(templatePath))
@@ -326,6 +339,13 @@ async function init(opts) {
       );
       track(ciCreated);
       log.ok(`ci/ \u2014 ${ciCount} file(s) written.`);
+      const { count: wfCount, created: wfCreated } = copyDirTracked(
+        ASSET.githubWorkflows,
+        join4(cwd, ".github", "workflows"),
+        { overwrite: opts.force, label: ".github/workflows" }
+      );
+      track(wfCreated);
+      log.ok(`.github/workflows/ \u2014 ${wfCount} file(s) written.`);
       const detection = detectStack(cwd);
       if (detection.polyglot) {
         const PYTHON_STACKS = ["conda", "poetry", "uv", "pip"];
@@ -345,12 +365,17 @@ async function init(opts) {
       } else {
         log.warn("Could not detect stack \u2014 CI placeholder left in place.");
       }
-      const ciYmlDest = join4(cwd, "ci", "github-actions", "contract-driven-gates.yml");
+      const ciYmlDest = join4(cwd, ".github", "workflows", "contract-driven-gates.yml");
       if (existsSync3(ciYmlDest)) {
         const template = loadCiTemplate(detection.primary);
         if (template) {
           const original = readFileSync2(ciYmlDest, "utf8");
-          const patched = patchFastGateYml(original, template, detection.primary);
+          let patched = patchFastGateYml(original, template, detection.primary);
+          if (detection.primary === "conda" && patched.includes("{{conda-env-name}}")) {
+            const envName = readCondaEnvName(cwd);
+            patched = patched.replace(/\{\{conda-env-name\}\}/g, envName);
+            log.ok(`Conda environment name set to: ${envName}`);
+          }
           if (patched !== original) {
             writeFileSync(ciYmlDest, patched, "utf8");
             log.ok(`CI fast-gate patched for stack: ${detection.primary}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "contract-driven-delivery",
-  "version": "1.8.1",
+  "version": "1.10.0",
   "description": "Contract-driven delivery kit CLI — spec-first, test-first AI-assisted delivery for brownfield systems",
   "keywords": [
     "contract-driven",