contract-driven-delivery 1.10.0 → 1.11.0

package/assets/specs-templates/tasks.md

@@ -1,3 +1,10 @@
+---
+change-id: <change-id>
+status: in-progress
+---
+
+<!-- [x]=done [-]=N/A [ ]=pending -->
+
 # Tasks
 
 ## 1. Preparation

package/dist/cli/index.js

@@ -1,7 +1,368 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/utils/logger.ts
+var RESET, CYAN, GREEN, YELLOW, RED, DIM, log;
+var init_logger = __esm({
+  "src/utils/logger.ts"() {
+    "use strict";
+    RESET = "\x1B[0m";
+    CYAN = "\x1B[36m";
+    GREEN = "\x1B[32m";
+    YELLOW = "\x1B[33m";
+    RED = "\x1B[31m";
+    DIM = "\x1B[2m";
+    log = {
+      info(msg) {
+        console.log(`${CYAN}\u2139${RESET}  ${msg}`);
+      },
+      ok(msg) {
+        console.log(`${GREEN}\u2713${RESET}  ${msg}`);
+      },
+      warn(msg) {
+        console.log(`${YELLOW}\u26A0${RESET}  ${msg}`);
+      },
+      error(msg) {
+        console.error(`${RED}\u2717${RESET}  ${msg}`);
+      },
+      dim(msg) {
+        console.log(`${DIM}   ${msg}${RESET}`);
+      },
+      blank() {
+        console.log("");
+      }
+    };
+  }
+});
+
+// src/commands/archive.ts
+var archive_exports = {};
+__export(archive_exports, {
+  archive: () => archive
+});
+import { join as join10 } from "path";
+import { existsSync as existsSync9, mkdirSync as mkdirSync4, renameSync, readFileSync as readFileSync6, writeFileSync as writeFileSync3, appendFileSync, cpSync as cpSync2, rmSync as rmSync2 } from "fs";
+async function archive(changeId) {
+  const cwd = process.cwd();
+  const changeDir = join10(cwd, "specs", "changes", changeId);
+  const archiveYear = (/* @__PURE__ */ new Date()).getFullYear().toString();
+  const archiveBase = join10(cwd, "specs", "archive", archiveYear);
+  const archiveDir = join10(archiveBase, changeId);
+  const indexPath = join10(cwd, "specs", "archive", "INDEX.md");
+  if (!existsSync9(changeDir)) {
+    log.error(`Change not found: specs/changes/${changeId}`);
+    process.exit(1);
+  }
+  if (existsSync9(archiveDir)) {
+    log.error(`Already archived: specs/archive/${archiveYear}/${changeId}`);
+    process.exit(1);
+  }
+  const tasksPath = join10(changeDir, "tasks.md");
+  if (existsSync9(tasksPath)) {
+    const content = readFileSync6(tasksPath, "utf8");
+    if (content.includes("status: gate-blocked")) {
+      log.warn("tasks.md has status: gate-blocked \u2014 archiving anyway (change was paused).");
+    }
+    const pending = (content.match(/^\s*-\s*\[ \]/gm) || []).length;
+    if (pending > 0) {
+      log.warn(`${pending} task(s) still pending ([ ]). Archive anyway.`);
+    }
+  }
+  if (!existsSync9(archiveBase)) {
+    mkdirSync4(archiveBase, { recursive: true });
+  }
+  try {
+    renameSync(changeDir, archiveDir);
+  } catch (err) {
+    if (err.code === "EXDEV") {
+      cpSync2(changeDir, archiveDir, { recursive: true });
+      rmSync2(changeDir, { recursive: true, force: true });
+    } else {
+      throw err;
+    }
+  }
+  log.ok(`Archived: specs/changes/${changeId} \u2192 specs/archive/${archiveYear}/${changeId}`);
+  const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  const indexLine = `| ${changeId} | ${archiveYear} | ${today} | specs/archive/${archiveYear}/${changeId}/ |
+`;
+  if (!existsSync9(indexPath)) {
+    writeFileSync3(indexPath, `# Archive Index
+
+| change-id | year | archived-date | path |
+|---|---|---|---|
+${indexLine}`, "utf8");
+  } else {
+    appendFileSync(indexPath, indexLine, "utf8");
+  }
+  log.ok(`Index updated: specs/archive/INDEX.md`);
+  log.blank();
+  log.info(`Next: promote durable learnings from archive.md to contracts/ or CLAUDE.md`);
+}
+var init_archive = __esm({
+  "src/commands/archive.ts"() {
+    "use strict";
+    init_logger();
+  }
+});
+
+// src/commands/abandon.ts
+var abandon_exports = {};
+__export(abandon_exports, {
+  abandon: () => abandon
+});
+import { join as join11 } from "path";
+import { existsSync as existsSync10, readFileSync as readFileSync7, writeFileSync as writeFileSync4, appendFileSync as appendFileSync2, mkdirSync as mkdirSync5 } from "fs";
+async function abandon(changeId, opts) {
+  const cwd = process.cwd();
+  const changeDir = join11(cwd, "specs", "changes", changeId);
+  const tasksPath = join11(changeDir, "tasks.md");
+  if (!existsSync10(changeDir)) {
+    log.error(`Change not found: specs/changes/${changeId}`);
+    process.exit(1);
+  }
+  if (existsSync10(tasksPath)) {
+    let content = readFileSync7(tasksPath, "utf8");
+    if (content.match(/^status:/m)) {
+      content = content.replace(/^status: .*/m, "status: abandoned");
+    } else {
+      content = `---
+change-id: ${changeId}
+status: abandoned
+---
+
+` + content;
+    }
+    writeFileSync4(tasksPath, content, "utf8");
+  }
+  const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  const archiveDir = join11(cwd, "specs", "archive");
+  const indexPath = join11(archiveDir, "INDEX.md");
+  const reason = opts.reason ?? "no reason given";
+  const indexLine = `| ${changeId} | abandoned | ${today} | ${reason} |
+`;
+  if (!existsSync10(archiveDir)) {
+    mkdirSync5(archiveDir, { recursive: true });
+  }
+  if (!existsSync10(indexPath)) {
+    writeFileSync4(indexPath, `# Archive Index
+
+| change-id | status | date | notes |
+|---|---|---|---|
+${indexLine}`, "utf8");
+  } else {
+    appendFileSync2(indexPath, indexLine, "utf8");
+  }
+  log.ok(`Change ${changeId} marked as abandoned.`);
+  log.info(`specs/changes/${changeId}/ remains on disk (git history preserved).`);
+  log.info(`Run \`cdd-kit archive ${changeId}\` to physically move it, or leave it for git history.`);
+}
+var init_abandon = __esm({
+  "src/commands/abandon.ts"() {
+    "use strict";
+    init_logger();
+  }
+});
+
+// src/commands/migrate.ts
+var migrate_exports = {};
+__export(migrate_exports, {
+  migrate: () => migrate
+});
+import { join as join12 } from "path";
+import { existsSync as existsSync11, readdirSync as readdirSync6, readFileSync as readFileSync8, writeFileSync as writeFileSync5 } from "fs";
+function migrateOne(changeId, changeDir, dryRun) {
+  const changed = [];
+  const warnings = [];
+  const tasksPath = join12(changeDir, "tasks.md");
+  if (existsSync11(tasksPath)) {
+    let content = readFileSync8(tasksPath, "utf8");
+    const norm = content.replace(/\r\n/g, "\n");
+    let modified = false;
+    if (!norm.startsWith("---")) {
+      const bareStatusMatch = norm.match(/^status:\s*(\S+)/m);
+      const inferredStatus = bareStatusMatch ? bareStatusMatch[1] : "in-progress";
+      if (bareStatusMatch) {
+        content = content.replace(/^status:\s*\S+[ \t]*\n?/m, "");
+      }
+      content = `---
+change-id: ${changeId}
+status: ${inferredStatus}
+---
+
+` + content;
+      modified = true;
+    }
+    if (!content.includes("[x]=done")) {
+      content = content.replace(
+        /^(---\n[\s\S]*?---\n)/,
+        `$1
+<!-- [x]=done [-]=N/A [ ]=pending -->
+`
+      );
+      modified = true;
+    }
+    if (modified) {
+      changed.push("tasks.md: added YAML frontmatter (status: in-progress) + legend comment");
+      if (!dryRun)
+        writeFileSync5(tasksPath, content, "utf8");
+    }
+  } else {
+    warnings.push("tasks.md not found \u2014 skipping frontmatter migration");
+  }
+  const classifPath = join12(changeDir, "change-classification.md");
+  if (existsSync11(classifPath)) {
+    const content = readFileSync8(classifPath, "utf8");
+    const hasNewTierFormat = /^## Tier\s*\n\s*-\s*\d\s*$/m.test(content);
+    if (!hasNewTierFormat) {
+      const oldMatch = content.match(/\*\*Tier[:\*]+\s*(?:Tier\s*)?(\d)/i) ?? content.match(/^-?\s*Tier:\s*(?:Tier\s*)?(\d)/mi);
+      const detectedTier = oldMatch ? oldMatch[1] : null;
+      if (detectedTier) {
+        const addition = `
+## Tier
+- ${detectedTier}
+`;
+        if (!content.includes("\n## Tier\n")) {
+          changed.push(
+            `change-classification.md: appended "## Tier\\n- ${detectedTier}" (converted from old format)`
+          );
+          if (!dryRun)
+            writeFileSync5(classifPath, content + addition, "utf8");
+        }
+      } else {
+        warnings.push(
+          "change-classification.md: could not detect tier (no **Tier:** N or ## Tier N found). gate tier-based agent-log checks will be skipped for this change."
+        );
+      }
+    }
+  }
+  return { changed, warnings };
+}
+async function migrate(changeId, opts = {}) {
+  const cwd = process.cwd();
+  const dryRun = opts.dryRun ?? false;
+  const idsToMigrate = [];
+  if (opts.all) {
+    const changesDir = join12(cwd, "specs", "changes");
+    if (!existsSync11(changesDir)) {
+      log.info("No specs/changes/ directory found \u2014 nothing to migrate.");
+      return;
+    }
+    idsToMigrate.push(
+      ...readdirSync6(changesDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name)
+    );
+  } else if (changeId) {
+    const specificDir = join12(cwd, "specs", "changes", changeId);
+    if (!existsSync11(specificDir)) {
+      log.error(`Change not found: specs/changes/${changeId}`);
+      process.exit(1);
+    }
+    idsToMigrate.push(changeId);
+  } else {
+    log.error("Usage: cdd-kit migrate <change-id>  |  cdd-kit migrate --all  [--dry-run]");
+    process.exit(1);
+  }
+  if (idsToMigrate.length === 0) {
+    log.info("No changes found to migrate.");
+    return;
+  }
+  if (dryRun) {
+    log.info("Dry run \u2014 no files will be written.");
+    log.blank();
+  }
+  let migratedCount = 0;
+  let upToDateCount = 0;
+  for (const id of idsToMigrate) {
+    const changeDir = join12(cwd, "specs", "changes", id);
+    if (!existsSync11(changeDir)) {
+      log.warn(`  ${id}: directory not found \u2014 skipping`);
+      continue;
+    }
+    const { changed, warnings } = migrateOne(id, changeDir, dryRun);
+    if (changed.length > 0) {
+      log.ok(`  ${id}: migrated`);
+      for (const c of changed)
+        log.info(`    + ${c}`);
+      migratedCount++;
+    } else {
+      log.info(`  ${id}: already up to date`);
+      upToDateCount++;
+    }
+    for (const w of warnings) {
+      log.warn(`  ${id}: ${w}`);
+    }
+  }
+  log.blank();
+  if (dryRun) {
+    log.info(`Dry run complete: ${migratedCount} change(s) would be updated, ${upToDateCount} already up to date.`);
+  } else {
+    log.ok(`Migration complete: ${migratedCount} updated, ${upToDateCount} already up to date.`);
+    if (migratedCount > 0) {
+      log.info('Next: git add specs/changes/ && git commit -m "chore: migrate changes to v1.11.0 format"');
+    }
+  }
+}
+var init_migrate = __esm({
+  "src/commands/migrate.ts"() {
+    "use strict";
+    init_logger();
+  }
+});
+
+// src/commands/list-changes.ts
+var list_changes_exports = {};
+__export(list_changes_exports, {
+  listChanges: () => listChanges
+});
+import { join as join13 } from "path";
+import { existsSync as existsSync12, readdirSync as readdirSync7, readFileSync as readFileSync9 } from "fs";
+async function listChanges() {
+  const cwd = process.cwd();
+  const changesDir = join13(cwd, "specs", "changes");
+  log.blank();
+  const active = [];
+  if (existsSync12(changesDir)) {
+    active.push(...readdirSync7(changesDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name));
+  }
+  if (active.length === 0) {
+    log.info("No active changes in specs/changes/");
+  } else {
+    log.info("Active changes:");
+    for (const id of active) {
+      const tasksPath = join13(changesDir, id, "tasks.md");
+      let status = "in-progress";
+      let pending = 0;
+      if (existsSync12(tasksPath)) {
+        const content = readFileSync9(tasksPath, "utf8");
+        if (content.includes("status: gate-blocked"))
+          status = "gate-blocked";
+        else if (content.includes("status: abandoned"))
+          status = "abandoned";
+        pending = (content.match(/^\s*-\s*\[ \]/gm) || []).length;
+      }
+      const pendingStr = pending > 0 ? ` (${pending} pending)` : "";
+      log.info(`  ${id}  [${status}]${pendingStr}`);
+    }
+  }
+  log.blank();
+}
+var init_list_changes = __esm({
+  "src/commands/list-changes.ts"() {
+    "use strict";
+    init_logger();
+  }
+});
+
 // src/cli/index.ts
-import { readFileSync as readFileSync6 } from "fs";
+import { readFileSync as readFileSync10 } from "fs";
 import { fileURLToPath as fileURLToPath2 } from "url";
-import { dirname as dirname3, join as join10 } from "path";
+import { dirname as dirname3, join as join14 } from "path";
 import { Command } from "commander";
 
 // src/commands/init.ts
@@ -33,6 +394,7 @@ var ASSET = {
 };
 
 // src/utils/copy.ts
+init_logger();
 import {
   mkdirSync,
   existsSync,
@@ -40,36 +402,6 @@ import {
   copyFileSync
 } from "fs";
 import { join as join2, dirname as dirname2, relative } from "path";
-
-// src/utils/logger.ts
-var RESET = "\x1B[0m";
-var CYAN = "\x1B[36m";
-var GREEN = "\x1B[32m";
-var YELLOW = "\x1B[33m";
-var RED = "\x1B[31m";
-var DIM = "\x1B[2m";
-var log = {
-  info(msg) {
-    console.log(`${CYAN}\u2139${RESET}  ${msg}`);
-  },
-  ok(msg) {
-    console.log(`${GREEN}\u2713${RESET}  ${msg}`);
-  },
-  warn(msg) {
-    console.log(`${YELLOW}\u26A0${RESET}  ${msg}`);
-  },
-  error(msg) {
-    console.error(`${RED}\u2717${RESET}  ${msg}`);
-  },
-  dim(msg) {
-    console.log(`${DIM}   ${msg}${RESET}`);
-  },
-  blank() {
-    console.log("");
-  }
-};
-
-// src/utils/copy.ts
 function ensureDir(dir) {
   mkdirSync(dir, { recursive: true });
 }
@@ -141,6 +473,9 @@ function copyFileTracked(src, dest, opts = {}) {
   return { written: true, created: isNew };
 }
 
+// src/commands/init.ts
+init_logger();
+
 // src/utils/stack-detect.ts
 import { existsSync as existsSync2, readFileSync } from "fs";
 import { join as join3 } from "path";
@@ -417,6 +752,7 @@ async function init(opts) {
 import { join as join5 } from "path";
 import { existsSync as existsSync4, mkdirSync as mkdirSync2, readdirSync as readdirSync3, copyFileSync as copyFileSync2, readFileSync as readFileSync3 } from "fs";
 import { createHash } from "crypto";
+init_logger();
 import { homedir as homedir2 } from "os";
 function fileHash(filePath) {
   const buf = readFileSync3(filePath);
@@ -531,6 +867,7 @@ async function update(opts) {
 // src/commands/new-change.ts
 import { join as join6 } from "path";
 import { existsSync as existsSync5, readdirSync as readdirSync4 } from "fs";
+init_logger();
 var REQUIRED_TEMPLATES = [
   "change-request.md",
   "change-classification.md",
@@ -589,6 +926,7 @@ async function newChange(name, opts) {
 import { join as join7 } from "path";
 import { existsSync as existsSync6 } from "fs";
 import { spawnSync } from "child_process";
+init_logger();
 var VALIDATORS = [
   {
     flag: "contracts",
@@ -672,6 +1010,7 @@ async function validate(opts) {
 }
 
 // src/commands/gate.ts
+init_logger();
 import { existsSync as existsSync7, readFileSync as readFileSync4, readdirSync as readdirSync5 } from "fs";
 import { join as join8 } from "path";
 import { spawnSync as spawnSync2 } from "child_process";
@@ -683,10 +1022,18 @@ var REQUIRED_FILES = [
   "tasks.md"
 ];
 var TIER_PATTERN = /\b(tier\s*[0-5]|low|medium|high|critical)\b/i;
+var MIN_CHARS = {
+  "change-classification.md": 200,
+  "test-plan.md": 200,
+  "ci-gates.md": 150,
+  "change-request.md": 100,
+  "tasks.md": 100
+};
 function meaningfulChars(text) {
   return text.split("\n").map((l) => l.trim()).filter((l) => l).filter((l) => !l.startsWith("#")).filter((l) => !/^[|\s\-:]+$/.test(l)).filter((l) => !l.startsWith("<!--")).join("").length;
 }
-async function gate(changeId) {
+async function gate(changeId, opts = {}) {
+  const strict = opts.strict ?? false;
   const cwd = process.cwd();
   const changeDir = join8(cwd, "specs", "changes", changeId);
   if (!existsSync7(changeDir)) {
@@ -694,6 +1041,7 @@ async function gate(changeId) {
     process.exit(1);
   }
   const errors = [];
+  const warnings = [];
   for (const f of REQUIRED_FILES) {
     if (!existsSync7(join8(changeDir, f))) {
       errors.push(`missing required artifact: ${f}`);
@@ -702,8 +1050,9 @@ async function gate(changeId) {
   if (errors.length === 0) {
     for (const f of REQUIRED_FILES) {
       const content = readFileSync4(join8(changeDir, f), "utf8");
-      if (meaningfulChars(content) < 100) {
-        errors.push(`${f}: appears to be a stub (< 100 meaningful chars)`);
+      const minChars = MIN_CHARS[f] ?? 100;
+      if (meaningfulChars(content) < minChars) {
+        errors.push(`${f}: appears to be a stub (< ${minChars} meaningful chars)`);
       }
     }
     const classifPath = join8(changeDir, "change-classification.md");
@@ -714,6 +1063,18 @@ async function gate(changeId) {
       }
     }
   }
+  const tasksPath = join8(changeDir, "tasks.md");
+  if (existsSync7(tasksPath)) {
+    const tasksContent = readFileSync4(tasksPath, "utf8");
+    const nonArchivePending = (tasksContent.match(/^\s*-\s*\[ \] (?!7\.[12])/gm) || []).length;
+    if (nonArchivePending > 0) {
+      if (strict) {
+        errors.push(`${nonArchivePending} task(s) still pending (use [-] for N/A items, [x] for done). Run gate without --strict during development.`);
+      } else {
+        warnings.push(`${nonArchivePending} task(s) still pending (warning only in non-strict mode)`);
+      }
+    }
+  }
   const agentLogDir = join8(changeDir, "agent-log");
   if (existsSync7(agentLogDir)) {
     const logFiles = readdirSync5(agentLogDir).filter((f) => f.endsWith(".md"));
@@ -731,8 +1092,69 @@ async function gate(changeId) {
           errors.push(`agent-log/${f}: status=blocked requires concrete "next-action:" line (>= 10 chars, not "none")`);
         }
       }
+      if (strict) {
+        const artifactsMatch = content.match(/- artifacts:([\s\S]*?)(?:\n- |\n#|$)/);
+        if (artifactsMatch) {
+          const artifactLines = artifactsMatch[1].split("\n").filter((l) => l.trim().startsWith("-"));
+          for (const line of artifactLines) {
+            const pointer = line.replace(/^\s*-\s*[\w-]+:\s*/, "").trim();
+            const pathPart = pointer.split(":")[0];
+            if (pathPart.includes("/") && !pointer.startsWith("http")) {
+              const abs = join8(cwd, pathPart);
+              if (!existsSync7(abs)) {
+                errors.push(`agent-log/${f}: artifact pointer not found: ${pathPart}`);
+              }
+            }
+          }
+        }
+      }
+    }
+    const classifPath = join8(changeDir, "change-classification.md");
+    if (existsSync7(classifPath)) {
+      const classificationContent = readFileSync4(classifPath, "utf8");
+      const tierMatch = classificationContent.match(/^## Tier\s*\n\s*-\s*(\d)\s*$/m);
+      const tier = tierMatch ? parseInt(tierMatch[1]) : null;
+      if (tier !== null) {
+        const agentLogFiles = readdirSync5(agentLogDir).map((f) => f.replace(".md", ""));
+        if (tier <= 1) {
+          for (const required of ["e2e-resilience-engineer", "monkey-test-engineer", "stress-soak-engineer"]) {
+            if (!agentLogFiles.includes(required)) {
+              errors.push(`Tier ${tier} change requires agent-log/${required}.md (high-risk change \u2014 E2E/monkey/stress testing mandatory)`);
+            }
+          }
+        }
+        if (tier <= 3) {
+          for (const required of ["contract-reviewer", "qa-reviewer"]) {
+            if (!agentLogFiles.includes(required)) {
+              errors.push(`Tier ${tier} change requires agent-log/${required}.md`);
+            }
+          }
+        }
+      }
+    }
+  } else {
+    const classifPath = join8(changeDir, "change-classification.md");
+    if (existsSync7(classifPath)) {
+      const classificationContent = readFileSync4(classifPath, "utf8");
+      const tierMatch = classificationContent.match(/^## Tier\s*\n\s*-\s*(\d)\s*$/m);
+      const tier = tierMatch ? parseInt(tierMatch[1]) : null;
+      if (tier !== null) {
+        if (tier <= 1) {
+          for (const required of ["e2e-resilience-engineer", "monkey-test-engineer", "stress-soak-engineer"]) {
+            errors.push(`Tier ${tier} change requires agent-log/${required}.md (high-risk change \u2014 E2E/monkey/stress testing mandatory)`);
+          }
+        }
+        if (tier <= 3) {
+          for (const required of ["contract-reviewer", "qa-reviewer"]) {
+            errors.push(`Tier ${tier} change requires agent-log/${required}.md`);
+          }
+        }
+      }
     }
   }
+  for (const w of warnings) {
+    log.warn(`  ${w}`);
+  }
   if (errors.length > 0) {
     log.error(`gate failed for change: ${changeId}`);
     for (const e of errors) {
@@ -741,7 +1163,7 @@ async function gate(changeId) {
     process.exit(1);
   }
   log.info(`gate: running contract validators for ${changeId}\u2026`);
-  const r = spawnSync2(process.execPath, [process.argv[1], "validate"], {
+  const r = spawnSync2(process.execPath, [process.argv[1], "validate", "--contracts", "--env", "--ci", "--versions"], {
     cwd,
     stdio: "inherit"
   });
@@ -749,12 +1171,16 @@ async function gate(changeId) {
     log.error(`gate failed for change: ${changeId} (validators returned non-zero)`);
     process.exit(1);
   }
+  for (const w of warnings) {
+    log.warn(`  ${w}`);
+  }
   log.ok(`gate passed for change: ${changeId}`);
 }
 
 // src/commands/install-hooks.ts
 import { existsSync as existsSync8, readFileSync as readFileSync5, writeFileSync as writeFileSync2, chmodSync, mkdirSync as mkdirSync3 } from "fs";
 import { join as join9 } from "path";
+init_logger();
 var START_MARKER = "# cdd-kit-managed-block-start";
 var END_MARKER = "# cdd-kit-managed-block-end";
 async function installHooks() {
@@ -807,7 +1233,7 @@ async function installHooks() {
 
 // src/cli/index.ts
 var __dirname2 = dirname3(fileURLToPath2(import.meta.url));
-var pkg = JSON.parse(readFileSync6(join10(__dirname2, "..", "..", "package.json"), "utf8"));
+var pkg = JSON.parse(readFileSync10(join14(__dirname2, "..", "..", "package.json"), "utf8"));
 var program = new Command();
 program.name("cdd-kit").description("Contract-Driven Delivery Kit CLI").version(pkg.version);
 program.command("init").description(
@@ -832,8 +1258,24 @@ program.command("validate").description("Run validation scripts (defaults to all
     versions: opts.versions
   })
 );
-program.command("gate <change-id>").description("Run full orchestration gate for a change (required artifacts, content, tier, contracts)").action(async (id) => {
-  await gate(id);
+program.command("gate <change-id>").description("Run full orchestration gate for a change (required artifacts, content, tier, contracts)").option("--strict", "Treat pending tasks (except section 7) as errors, and validate artifact pointers", false).action(async (id, opts) => {
+  await gate(id, { strict: opts.strict });
+});
+program.command("archive <change-id>").description("Move a completed change from specs/changes/ to specs/archive/<year>/").action(async (changeId) => {
+  const { archive: archive2 } = await Promise.resolve().then(() => (init_archive(), archive_exports));
+  await archive2(changeId);
+});
+program.command("abandon <change-id>").description("Mark a change as abandoned (updates tasks.md status, records in INDEX.md)").option("--reason <text>", "reason for abandonment").action(async (changeId, opts) => {
+  const { abandon: abandon2 } = await Promise.resolve().then(() => (init_abandon(), abandon_exports));
+  await abandon2(changeId, opts);
+});
+program.command("migrate [change-id]").description("Upgrade existing change directories to v1.11.0 format (tasks.md frontmatter + tier format)").option("--all", "Migrate all changes in specs/changes/", false).option("--dry-run", "Show what would change without writing files", false).action(async (changeId, opts = {}) => {
+  const { migrate: migrate2 } = await Promise.resolve().then(() => (init_migrate(), migrate_exports));
+  await migrate2(changeId, opts);
+});
+program.command("list").description("List active changes in specs/changes/").action(async () => {
+  const { listChanges: listChanges2 } = await Promise.resolve().then(() => (init_list_changes(), list_changes_exports));
+  await listChanges2();
 });
 program.command("install-hooks").description("Install pre-commit hook that runs cdd-kit gate on staged changes").action(async () => {
   await installHooks();

package/package.json

@@ -1,15 +1,18 @@
 {
   "name": "contract-driven-delivery",
-  "version": "1.10.0",
-  "description": "Contract-driven delivery kit CLI — spec-first, test-first AI-assisted delivery for brownfield systems",
+  "version": "1.11.0",
+  "description": "Claude Code kit that turns AI agents into a disciplined engineering team: contracts-first, test-first, spec-first. Every change is classified, contracted, TDD-ed, implemented, and gate-verified by an orchestrated multi-agent flow.",
   "keywords": [
     "contract-driven",
+    "claude-code",
+    "ai-agents",
     "sdd",
     "tdd",
-    "claude-code",
-    "ai",
     "specs",
-    "contracts"
+    "contracts",
+    "brownfield",
+    "multi-agent",
+    "cdd-kit"
   ],
   "license": "MIT",
   "author": "Contract-Driven Delivery Contributors",