cc-devflow 4.5.10 → 4.5.12

package/bin/cc-devflow-cli.js

@@ -60,8 +60,6 @@ Commands:
   config doctor       Validate config and local ignore safety
   query list          List typed runtime query ids
   query <id>          Run a typed runtime query as JSON
-  task-contract       Compile task contract artifacts
-  review              Record durable review ledger events
   next-change-key     Compute the next REQ/FIX change key
   archive-change      Archive a completed change to devflow/changes/archive/YYYY-MM/
   restore-change      Restore an archived change back to devflow/changes/
@@ -115,11 +113,7 @@ Examples:
   cc-devflow config set output.document_language zh-CN --user
   cc-devflow config resolve --cwd /path/to/project --format policy
   cc-devflow query list
-  cc-devflow query ship-readiness --cwd /path/to/project --change REQ-123
   cc-devflow query workflow-context --cwd /path/to/project --change REQ-123 --change-key REQ-123-my-feature --data-only --no-trace --compact
-  cc-devflow query progress --change REQ-123 --change-key REQ-123-my-feature
-  cc-devflow task-contract compile --cwd /path/to/project --change REQ-123 --change-key REQ-123-my-feature
-  cc-devflow review start --cwd /path/to/project --change REQ-123 --change-key REQ-123-my-feature --base-sha abc --head-sha def
 `);
 }
 
@@ -183,6 +177,9 @@ function copyManagedDirectory(src, dest, options = {}) {
   const stats = fs.statSync(src);
   if (stats.isDirectory()) {
     fs.mkdirSync(dest, { recursive: true });
+    if (force) {
+      pruneManagedDirectory(src, dest);
+    }
     const entries = fs.readdirSync(src);
     for (const entry of entries) {
       copyManagedDirectory(path.join(src, entry), path.join(dest, entry), options);
@@ -212,6 +209,23 @@ function copyManagedDirectory(src, dest, options = {}) {
   }
 }
 
+function pruneManagedDirectory(src, dest) {
+  if (!fs.existsSync(dest) || !fs.statSync(dest).isDirectory()) {
+    return;
+  }
+
+  const sourceEntries = new Set(fs.readdirSync(src));
+  for (const entry of fs.readdirSync(dest)) {
+    if (sourceEntries.has(entry)) {
+      continue;
+    }
+
+    const targetPath = path.join(dest, entry);
+    fs.rmSync(targetPath, { recursive: true, force: true });
+    console.log(`[DELETE] ${path.relative(process.cwd(), targetPath)}`);
+  }
+}
+
 function syncDistributedSkills(targetRoot, options = {}) {
   const { force = false } = options;
   const targetClaudeDir = path.join(targetRoot, '.claude');
@@ -540,252 +554,6 @@ async function runQueryCommand(args) {
   return result.ok ? 0 : 2;
 }
 
-async function runTaskContractCommand(args) {
-  const [subcommand, ...rest] = args;
-
-  if (!subcommand || subcommand === '--help' || subcommand === '-h') {
-    console.error('Use: cc-devflow task-contract <compile|validate|migrate> --change <changeId> [--change-key <key>] [--cwd <path>] [--fold-design] [--fold-analysis]');
-    return 3;
-  }
-
-  const options = parseChangeScopedArgs(rest);
-  if (!options.changeId) {
-    console.error('task-contract --change is required.');
-    return 3;
-  }
-
-  if (subcommand === 'compile' || subcommand === 'validate' || subcommand === 'migrate') {
-    const {
-      runCompile,
-      runValidate,
-      runMigrate
-    } = require(path.join(PACKAGE_ROOT, 'lib/skill-runtime/operations/task-contract.js'));
-    const runners = {
-      compile: runCompile,
-      validate: runValidate,
-      migrate: runMigrate
-    };
-    const runner = runners[subcommand];
-    const result = await runner({
-      repoRoot: path.resolve(options.cwd || process.cwd()),
-      changeId: options.changeId,
-      changeKey: options.changeKey,
-      foldDesign: options.rest.includes('--fold-design'),
-      foldAnalysis: options.rest.includes('--fold-analysis')
-    });
-    if (result.code !== 0) {
-      console.error(result.stderr || result.error || `task-contract ${subcommand} failed`);
-      return result.code;
-    }
-    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
-    return result.code;
-  }
-
-  console.error(`Unknown task-contract command: ${subcommand}`);
-  return 3;
-}
-
-function parseReviewStartArgs(args) {
-  const scoped = parseChangeScopedArgs(args);
-  const parsed = {
-    ...scoped,
-    mode: 'implementation',
-    scope: 'current-diff',
-    baseSha: 'unknown',
-    headSha: 'unknown',
-    selectedNodes: [],
-    skippedNodes: [],
-    riskLanes: []
-  };
-
-  for (let i = 0; i < scoped.rest.length; i++) {
-    const arg = scoped.rest[i];
-    if (arg === '--mode') { parsed.mode = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--mode=')) { parsed.mode = arg.slice('--mode='.length); continue; }
-    if (arg === '--scope') { parsed.scope = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--scope=')) { parsed.scope = arg.slice('--scope='.length); continue; }
-    if (arg === '--base-sha') { parsed.baseSha = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--base-sha=')) { parsed.baseSha = arg.slice('--base-sha='.length); continue; }
-    if (arg === '--head-sha') { parsed.headSha = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--head-sha=')) { parsed.headSha = arg.slice('--head-sha='.length); continue; }
-    if (arg === '--selected-node') { parsed.selectedNodes.push(scoped.rest[++i]); continue; }
-    if (arg.startsWith('--selected-node=')) { parsed.selectedNodes.push(arg.slice('--selected-node='.length)); continue; }
-    if (arg === '--skipped-node') { parsed.skippedNodes.push(scoped.rest[++i]); continue; }
-    if (arg.startsWith('--skipped-node=')) { parsed.skippedNodes.push(arg.slice('--skipped-node='.length)); continue; }
-    if (arg === '--risk-lane') { parsed.riskLanes.push(scoped.rest[++i]); continue; }
-    if (arg.startsWith('--risk-lane=')) { parsed.riskLanes.push(arg.slice('--risk-lane='.length)); continue; }
-  }
-
-  return parsed;
-}
-
-function parseReviewEventArgs(args) {
-  const scoped = parseChangeScopedArgs(args);
-  const parsed = {
-    ...scoped,
-    reviewId: null,
-    nodeId: null,
-    mode: 'implementation',
-    target: null,
-    status: null,
-    coverage: [],
-    evidenceRefs: [],
-    findings: [],
-    next: null,
-    findingId: null,
-    severity: null,
-    confidence: null,
-    displayTier: null,
-    fingerprint: null,
-    scope: null,
-    path: null,
-    evidence: null,
-    recommendation: null,
-    route: null,
-    blockingCount: null,
-    warningCount: null,
-    output: null
-  };
-
-  for (let i = 0; i < scoped.rest.length; i++) {
-    const arg = scoped.rest[i];
-    if (arg === '--review-id') { parsed.reviewId = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--review-id=')) { parsed.reviewId = arg.slice('--review-id='.length); continue; }
-    if (arg === '--node-id') { parsed.nodeId = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--node-id=')) { parsed.nodeId = arg.slice('--node-id='.length); continue; }
-    if (arg === '--mode') { parsed.mode = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--mode=')) { parsed.mode = arg.slice('--mode='.length); continue; }
-    if (arg === '--target') { parsed.target = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--target=')) { parsed.target = arg.slice('--target='.length); continue; }
-    if (arg === '--status') { parsed.status = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--status=')) { parsed.status = arg.slice('--status='.length); continue; }
-    if (arg === '--coverage') { parsed.coverage.push(scoped.rest[++i]); continue; }
-    if (arg.startsWith('--coverage=')) { parsed.coverage.push(arg.slice('--coverage='.length)); continue; }
-    if (arg === '--evidence-ref') { parsed.evidenceRefs.push(scoped.rest[++i]); continue; }
-    if (arg.startsWith('--evidence-ref=')) { parsed.evidenceRefs.push(arg.slice('--evidence-ref='.length)); continue; }
-    if (arg === '--finding') { parsed.findings.push(scoped.rest[++i]); continue; }
-    if (arg.startsWith('--finding=')) { parsed.findings.push(arg.slice('--finding='.length)); continue; }
-    if (arg === '--next') { parsed.next = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--next=')) { parsed.next = arg.slice('--next='.length); continue; }
-    if (arg === '--finding-id') { parsed.findingId = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--finding-id=')) { parsed.findingId = arg.slice('--finding-id='.length); continue; }
-    if (arg === '--severity') { parsed.severity = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--severity=')) { parsed.severity = arg.slice('--severity='.length); continue; }
-    if (arg === '--confidence') { parsed.confidence = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--confidence=')) { parsed.confidence = arg.slice('--confidence='.length); continue; }
-    if (arg === '--display-tier') { parsed.displayTier = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--display-tier=')) { parsed.displayTier = arg.slice('--display-tier='.length); continue; }
-    if (arg === '--fingerprint') { parsed.fingerprint = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--fingerprint=')) { parsed.fingerprint = arg.slice('--fingerprint='.length); continue; }
-    if (arg === '--scope') { parsed.scope = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--scope=')) { parsed.scope = arg.slice('--scope='.length); continue; }
-    if (arg === '--path') { parsed.path = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--path=')) { parsed.path = arg.slice('--path='.length); continue; }
-    if (arg === '--evidence') { parsed.evidence = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--evidence=')) { parsed.evidence = arg.slice('--evidence='.length); continue; }
-    if (arg === '--recommendation') { parsed.recommendation = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--recommendation=')) { parsed.recommendation = arg.slice('--recommendation='.length); continue; }
-    if (arg === '--route') { parsed.route = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--route=')) { parsed.route = arg.slice('--route='.length); continue; }
-    if (arg === '--blocking-count') { parsed.blockingCount = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--blocking-count=')) { parsed.blockingCount = arg.slice('--blocking-count='.length); continue; }
-    if (arg === '--warning-count') { parsed.warningCount = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--warning-count=')) { parsed.warningCount = arg.slice('--warning-count='.length); continue; }
-    if (arg === '--output') { parsed.output = scoped.rest[++i]; continue; }
-    if (arg.startsWith('--output=')) { parsed.output = arg.slice('--output='.length); continue; }
-  }
-
-  return parsed;
-}
-
-async function runReviewCommand(args) {
-  const [subcommand, ...rest] = args;
-
-  if (!subcommand || subcommand === '--help' || subcommand === '-h') {
-    console.error('Use: cc-devflow review start --change <changeId> [--change-key <key>] [--cwd <path>]');
-    return 3;
-  }
-
-  const reviewRunners = {
-    start: null,
-    'record-node': 'runReviewRecordNode',
-    'add-finding': 'runReviewAddFinding',
-    close: 'runReviewClose',
-    render: 'runReviewRender'
-  };
-
-  if (subcommand === 'start') {
-    const options = parseReviewStartArgs(rest);
-    if (!options.changeId) {
-      console.error('review start --change is required.');
-      return 3;
-    }
-
-    const { runReviewStart } = require(path.join(PACKAGE_ROOT, 'lib/skill-runtime/operations/review-records.js'));
-    const result = await runReviewStart({
-      repoRoot: path.resolve(options.cwd || process.cwd()),
-      changeId: options.changeId,
-      changeKey: options.changeKey,
-      mode: options.mode,
-      scope: options.scope,
-      baseSha: options.baseSha,
-      headSha: options.headSha,
-      selectedNodes: options.selectedNodes,
-      skippedNodes: options.skippedNodes,
-      riskLanes: options.riskLanes
-    });
-    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
-    return result.code;
-  }
-
-  if (reviewRunners[subcommand]) {
-    const options = parseReviewEventArgs(rest);
-    if (!options.changeId) {
-      console.error(`review ${subcommand} --change is required.`);
-      return 3;
-    }
-
-    const runnerName = reviewRunners[subcommand];
-    const runners = require(path.join(PACKAGE_ROOT, 'lib/skill-runtime/operations/review-records.js'));
-    const result = await runners[runnerName]({
-      repoRoot: path.resolve(options.cwd || process.cwd()),
-      changeId: options.changeId,
-      changeKey: options.changeKey,
-      reviewId: options.reviewId,
-      nodeId: options.nodeId,
-      mode: options.mode,
-      target: options.target,
-      status: options.status,
-      coverage: options.coverage,
-      evidenceRefs: options.evidenceRefs,
-      findings: options.findings,
-      next: options.next,
-      findingId: options.findingId,
-      severity: options.severity,
-      confidence: options.confidence,
-      displayTier: options.displayTier,
-      fingerprint: options.fingerprint,
-      scope: options.scope,
-      path: options.path,
-      evidence: options.evidence,
-      recommendation: options.recommendation,
-      route: options.route,
-      blockingCount: options.blockingCount,
-      warningCount: options.warningCount,
-      output: options.output
-    });
-    if (result.code !== 0) {
-      console.error(result.stderr || result.error || `review ${subcommand} failed`);
-      return result.code;
-    }
-    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
-    return result.code;
-  }
-
-  console.error(`Unknown review command: ${subcommand}`);
-  return 3;
-}
-
 function runNextChangeKey(args) {
   const parsed = { prefix: null, description: null, cwd: null };
 
@@ -948,14 +716,6 @@ async function main() {
     return runQueryCommand(rest);
   }
 
-  if (command === 'task-contract') {
-    return runTaskContractCommand(rest);
-  }
-
-  if (command === 'review') {
-    return runReviewCommand(rest);
-  }
-
   if (command === 'next-change-key') {
     return runNextChangeKey(rest);
   }

package/bin/cc-devflow.js

@@ -1,16 +1,53 @@
 #!/usr/bin/env node
 
-const AdapterRegistry = require('../lib/adapters/registry');
-const ClaudeAdapter = require('../lib/adapters/claude-adapter');
-const CodexAdapter = require('../lib/adapters/codex-adapter');
-const { validateConfig, getDefaultConfig } = require('../lib/adapters/config-validator');
-const logger = require('../lib/adapters/logger');
-const fs = require('fs');
+const { spawnSync } = require('child_process');
 const path = require('path');
-const yaml = require('js-yaml');
+
+const CLI_BIN = path.resolve(__dirname, 'cc-devflow-cli.js');
+const CLI_COMMANDS = new Set([
+    'help',
+    '--help',
+    '-h',
+    'init',
+    'adapt',
+    'config',
+    'query',
+    'next-change-key',
+    'archive-change',
+    'restore-change',
+    'list-archived'
+]);
+
+function runCli(args) {
+    const result = spawnSync(process.execPath, [CLI_BIN, ...args], {
+        stdio: 'inherit'
+    });
+
+    if (result.error) {
+        console.error(`Failed to run cc-devflow CLI: ${result.error.message}`);
+        return 1;
+    }
+
+    return typeof result.status === 'number' ? result.status : 1;
+}
 
 async function main() {
     try {
+        const cliArgs = process.argv.slice(2);
+        const cliCommand = cliArgs[0];
+
+        if (!cliCommand || CLI_COMMANDS.has(cliCommand)) {
+            process.exit(runCli(cliArgs));
+        }
+
+        const AdapterRegistry = require('../lib/adapters/registry');
+        const ClaudeAdapter = require('../lib/adapters/claude-adapter');
+        const CodexAdapter = require('../lib/adapters/codex-adapter');
+        const { validateConfig, getDefaultConfig } = require('../lib/adapters/config-validator');
+        const logger = require('../lib/adapters/logger');
+        const fs = require('fs');
+        const yaml = require('js-yaml');
+
         // 1. Initialize Registry
         const registry = AdapterRegistry.getInstance();
 

package/docs/commands/README.md

@@ -20,7 +20,7 @@ IDCA: cc-investigate -> cc-do -> cc-check -> cc-act
 
 Use maintenance skills separately when needed:
 
-- `cc-spec-init`: bootstrap or repair `devflow/specs/` and `change-meta.json`
+- `cc-spec-init`: bootstrap or repair `devflow/specs/` and ``
 - `cc-simplify`: cleanup pass before ship
 
 Use [skills.sh CLI](https://skills.sh/docs/cli) when you only want one skill:

package/docs/commands/README.zh-CN.md

@@ -20,7 +20,7 @@ IDCA: cc-investigate -> cc-do -> cc-check -> cc-act
 
 维护类动作按需单独调用：
 
-- `cc-spec-init`：初始化或修复 `devflow/specs/` 与 `change-meta.json`
+- `cc-spec-init`：初始化或修复 `devflow/specs/` 与 ``
 - `cc-simplify`：ship 前做清理和坏味道检查
 
 如果你只想安装单个 Skill，再使用 [skills.sh CLI](https://skills.sh/docs/cli)：

package/docs/examples/README.md

@@ -33,6 +33,6 @@ If you need to verify that examples still match the current skill contracts, use
 - Shows:
   - work that is truly verified
   - a case where remote / PR actions are intentionally skipped
-  - `cc-act` leaving exactly one final handoff file, with `resume-index.md` only for local-handoff
+  - `cc-act` leaving exactly one final `handoff/pr-brief.md` file for local handoff
 
 If you need symptom routing or artifact-based lookup, go back to [START-HERE.md](./START-HERE.md).

package/docs/examples/START-HERE.md

@@ -30,7 +30,7 @@ npm run verify:publish
 
 ## Fast Route
 
-### 1. Do you already have a `report-card.json` verdict?
+### 1. Do you already have a verification verdict?
 
 - If **no**, start with [the happy path example](./pdca-loop/README.md) to understand the full loop once.
 - If **yes**, continue below.
@@ -67,14 +67,13 @@ Use this when the only thing you know is the file in front of you.
 | `roadmap.json` | `cc-roadmap` editable machine truth source | [pdca-loop/roadmap.json](./pdca-loop/roadmap.json) |
 | `ROADMAP.md` | `cc-roadmap` generated human view | [pdca-loop/ROADMAP.md](./pdca-loop/ROADMAP.md) |
 | `BACKLOG.md` | deprecated `cc-roadmap` -> `cc-plan` projection | [pdca-loop/BACKLOG.md](./pdca-loop/BACKLOG.md) |
-| `tasks.md` | `cc-plan`, `cc-investigate`, or `cc-do` | [pdca-loop/tasks.md](./pdca-loop/changes/REQ-001-copy-invite-link/planning/tasks.md) |
-| `design.md` | legacy `cc-plan` fallback | [pdca-loop/design.md](./pdca-loop/changes/REQ-001-copy-invite-link/planning/design.md) or [full-design-blocked/design.md](./full-design-blocked/changes/REQ-002-bulk-invite-import/planning/design.md) |
-| `task-manifest.json` | `cc-do` | [pdca-loop/task-manifest.json](./pdca-loop/changes/REQ-001-copy-invite-link/planning/task-manifest.json) |
-| `report-card.json` | `cc-check` | [pdca-loop/report-card.json](./pdca-loop/changes/REQ-001-copy-invite-link/review/report-card.json), [full-design-blocked/report-card.json](./full-design-blocked/changes/REQ-002-bulk-invite-import/review/report-card.json), or [local-handoff/report-card.json](./local-handoff/changes/REQ-003-audit-log-export/review/report-card.json) |
+| `task.md` | `cc-plan`, `cc-investigate`, or `cc-do` | [pdca-loop/task.md](./pdca-loop/changes/REQ-001-copy-invite-link/task.md) |
+| Git diff / commit | `cc-do` or `cc-check` | current branch history and working tree |
+| current response verdict | `cc-check` | the verification summary from the latest run |
 | `pr-brief.md` | `cc-act` | [pdca-loop/pr-brief.md](./pdca-loop/changes/REQ-001-copy-invite-link/handoff/pr-brief.md) |
-| `resume-index.md` | `cc-act` with `local-handoff` | [local-handoff/resume-index.md](./local-handoff/changes/REQ-003-audit-log-export/handoff/resume-index.md) |
+| local `pr-brief.md` | `cc-act` with `local-handoff` | [local-handoff/pr-brief.md](./local-handoff/changes/REQ-003-audit-log-export/handoff/pr-brief.md) |
 
-### Read `report-card.json` Like This
+### Read The Verification Verdict Like This
 
 | Verdict | Reroute | Meaning |
 | --- | --- | --- |
@@ -83,7 +82,7 @@ Use this when the only thing you know is the file in front of you.
 | `blocked` | `cc-do` | proof or execution prerequisites are missing |
 | `blocked` | `cc-plan` | design or scope truth is broken; do not keep coding blindly |
 
-### Read `resume-index.md` Like This
+### Read Local Handoff Like This
 
 Ask only:
 
@@ -118,17 +117,17 @@ If both are true, you are usually in `cc-act` local handoff territory, not back
 
 ## Wrong Turns To Avoid
 
-- Do not jump from `tasks.md` straight to `cc-act`
-- Do not treat green tests as stronger than a `report-card.json` reroute
-- Do not treat `resume-index.md` as proof that planning failed; it may simply mean local handoff
+- Do not jump from `task.md` straight to `cc-act`
+- Do not treat green tests as stronger than a `cc-check` reroute
+- Do not treat `local-handoff` as proof that planning failed; it may simply mean remote actions are intentionally unavailable
 
 ## One-Minute Rule
 
 If you only have one minute, open these files in order:
 
 1. example `README.md`
-2. change `planning/tasks.md`
-3. `report-card.json` or the single final handoff file
+2. change `task.md`
+3. `handoff/pr-brief.md` when present; otherwise the latest Git commit and current verification response
 
 That should already tell you:
 
@@ -140,7 +139,8 @@ That should already tell you:
 
 `devflow/changes/<change>/` should stay lean.
 
-- Durable truth only: `change-meta.json`, `planning/tasks.md`, CLI-generated `task-manifest.json`, review ledger/findings records, optional CLI logs for debug/failure, `report-card.json`, and one final handoff file. Do not generate task `context.md`, `checkpoint.json`, or AI-written process files.
+- Durable truth only: `task.md`, optional `handoff/pr-brief.md`, and incident postmortem files when a real recurring failure needs one. Do not generate process files.
+- Workflow state is Git-owned: keep `task.md` current and commit each completed stage.
 - Legacy `planning/design.md`, `planning/analysis.md`, and `cc-review-*.md` are readable fallback inputs for older examples, not new default writes.
 - Runtime scratch belongs in `devflow/workspaces/<change>/`, not beside the durable record.
 

package/docs/examples/example-bindings.json

@@ -2,17 +2,17 @@
   "updatedAt": "2026-05-13",
   "skills": {
     "cc-roadmap": "5.3.0",
-    "cc-next": "1.0.1",
-    "cc-dev": "1.0.1",
-    "cc-plan": "3.9.0",
-    "cc-investigate": "1.5.0",
-    "cc-do": "1.6.7",
-    "cc-review": "2.0.0",
-    "cc-pr-review": "1.0.0",
-    "cc-pr-land": "1.0.0",
-    "cc-check": "1.11.1",
-    "cc-act": "1.8.8",
-    "cc-spec-init": "1.1.0"
+    "cc-next": "1.1.1",
+    "cc-dev": "1.1.2",
+    "cc-plan": "3.10.1",
+    "cc-investigate": "1.6.1",
+    "cc-do": "1.7.1",
+    "cc-review": "2.1.2",
+    "cc-pr-review": "1.1.1",
+    "cc-pr-land": "1.1.0",
+    "cc-check": "1.12.1",
+    "cc-act": "1.9.1",
+    "cc-spec-init": "1.2.0"
   },
   "examples": [
     {

package/docs/examples/full-design-blocked/README.md

@@ -4,7 +4,7 @@
 
 - Example version: `1.0.0`
 - Last reviewed: `2026-04-17`
-- Bound skills: `cc-roadmap@5.3.0`, `cc-plan@3.9.0`, `cc-do@1.6.7`, `cc-check@1.11.1`
+- Bound skills: `cc-roadmap@5.3.0`, `cc-plan@3.10.1`, `cc-do@1.7.1`, `cc-check@1.12.1`
 
 This example shows a requirement that **looked executable**, but `cc-check` correctly stopped it and sent it back to `cc-plan`.
 
@@ -13,7 +13,7 @@ The shape is intentional:
 - roadmap item is real enough to matter
 - design requires `full-design`
 - tasks were executed far enough to produce evidence
-- `report-card.json` is still `blocked`
+- the verification verdict is still `blocked`
 - reroute is `cc-plan`, not `cc-do`
 
 ## Scenario
@@ -43,10 +43,8 @@ The sample shows what happens when implementation moved before the integration d
 - `roadmap.json` (editable roadmap truth)
 - `ROADMAP.md` (generated view)
 - `BACKLOG.md` (deprecated projection)
-- `changes/REQ-002-bulk-invite-import/planning/tasks.md`
-- `changes/REQ-002-bulk-invite-import/planning/design.md` (legacy fallback sample)
-- `changes/REQ-002-bulk-invite-import/planning/task-manifest.json`
-- `changes/REQ-002-bulk-invite-import/review/report-card.json`
+- `changes/REQ-002-bulk-invite-import/task.md`
+- `changes/REQ-002-bulk-invite-import/task.md`
 
 ## Why There Is No `cc-act` Output
 

package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/{planning/tasks.md → task.md}

@@ -4,7 +4,7 @@
 
 - Requirement version: `REQ-002.v2`
 - Design version: `design.v2`
-- CC-Plan skill version: `3.9.0`
+- CC-Plan skill version: `3.10.1`
 - Work branch: `REQ/002-bulk-invite-import`
 - Source roadmap item: `RM-010`
 - Source roadmap version: `roadmap.v2`
@@ -43,20 +43,25 @@
 ClaudeCode / Codex 执行本计划时，必须把本文件当成任务模板合同，而不是普通 TODO 列表。
 
 - Template source: `assets/TASKS_TEMPLATE.md`
-- Context index first: run `cc-devflow query workflow-context --change <changeId> --change-key <changeKey> --cwd <repo-root> --data-only --no-trace --compact` before opening deep sections; use `packetOnly` plus `mustNotForget` first, verify `sourceHashes`, open `defaultOpen` refs only when needed, and reserve `deepOpen` for matching `openWhen.conditions`.
-- Task selection: read `planning/task-manifest.json.currentTaskId`; if empty, run the ready-task selector before choosing work.
+- CLI resolver: all workflow commands must run through `.claude/skills/cc-dev/scripts/resolve-cc-devflow.sh` or `.codex/skills/cc-dev/scripts/resolve-cc-devflow.sh`; if it cannot prove `query workflow-context` and `next-change-key`, stop blocked.
+- Context first: run resolved CLI `query workflow-context --change <changeId> --change-key <changeKey> --cwd <repo-root> --data-only --no-trace --compact` before opening deep sections.
+- Task selection: use `scripts/select-ready-tasks.sh --tasks devflow/changes/<change-key>/task.md`.
 - Task block rule: read the full task block before coding; title-only execution is invalid.
-- Completion rule: after verification and review gates pass, run the completion script; do not manually edit checkbox, status, or `currentTaskId`.
-- Completion failure: if the script fails, fix the missing review / dependency evidence and rerun it. Do not bypass it by editing JSON or Markdown.
+- Completion rule: after verification and review gates pass, run `scripts/mark-task-complete.sh --tasks devflow/changes/<change-key>/task.md --task <task-id>`.
+- Runtime file ban: do not generate process files beyond this `task.md`.
 
 ```bash
-cc-devflow query workflow-context --change <changeId> --change-key <changeKey> --cwd <repo-root> --data-only --no-trace --compact
-SCRIPT_ROOT=".claude/skills/cc-do/scripts"
+DEVFLOW=".claude/skills/cc-dev/scripts/resolve-cc-devflow.sh"
+if [[ ! -f "$DEVFLOW" && -f ".codex/skills/cc-dev/scripts/resolve-cc-devflow.sh" ]]; then
+  DEVFLOW=".codex/skills/cc-dev/scripts/resolve-cc-devflow.sh"
+fi
+bash "$DEVFLOW" require query workflow-context next-change-key
+bash "$DEVFLOW" query workflow-context --change <changeId> --change-key <changeKey> --cwd <repo-root> --data-only --no-trace --compactSCRIPT_ROOT=".claude/skills/cc-do/scripts"
 if [[ ! -d "$SCRIPT_ROOT" && -d ".codex/skills/cc-do/scripts" ]]; then
   SCRIPT_ROOT=".codex/skills/cc-do/scripts"
 fi
-bash "$SCRIPT_ROOT/select-ready-tasks.sh" --manifest docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/task-manifest.json
-bash "$SCRIPT_ROOT/mark-task-complete.sh" --manifest docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/task-manifest.json --tasks docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/tasks.md --task <task-id>
+bash "$SCRIPT_ROOT/select-ready-tasks.sh" --manifest docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/
+bash "$SCRIPT_ROOT/mark-task-complete.sh" --manifest docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/ --tasks docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/task.md --task <task-id>
 ```
 
 ## Phase 1: Rule Matrix
@@ -68,7 +73,7 @@ bash "$SCRIPT_ROOT/mark-task-complete.sh" --manifest docs/examples/full-design-b
   Read first: `design.md`, `src/invite/bulk-import.ts`
   Verification: `npm test -- src/invite/bulk-import.test.ts`
   Evidence: failing output
-  Completion: after verification evidence and required review records exist, run `SCRIPT_ROOT=".claude/skills/cc-do/scripts"; if [[ ! -d "$SCRIPT_ROOT" && -d ".codex/skills/cc-do/scripts" ]]; then SCRIPT_ROOT=".codex/skills/cc-do/scripts"; fi; bash "$SCRIPT_ROOT/mark-task-complete.sh" --manifest docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/task-manifest.json --tasks docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/tasks.md --task T001`; do not hand-edit status.
+  Completion: after verification evidence and required review records exist, run `SCRIPT_ROOT=".claude/skills/cc-do/scripts"; if [[ ! -d "$SCRIPT_ROOT" && -d ".codex/skills/cc-do/scripts" ]]; then SCRIPT_ROOT=".codex/skills/cc-do/scripts"; fi; bash "$SCRIPT_ROOT/mark-task-complete.sh" --manifest docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/ --tasks docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/task.md --task T001`; do not hand-edit status.
   Test seam: bulk invite rules and admin upload UI behavior
   Public verification path: Run the bulk invite rule and admin panel tests through their public flows
   Allowed mocks: file upload boundary / billing / seat limit boundary
@@ -81,7 +86,7 @@ bash "$SCRIPT_ROOT/mark-task-complete.sh" --manifest docs/examples/full-design-b
   Read first: `design.md`, `src/invite/bulk-import.test.ts`
   Verification: `npm test -- src/invite/bulk-import.test.ts`
   Evidence: passing output + Git diff
-  Completion: after verification evidence and required review records exist, run `SCRIPT_ROOT=".claude/skills/cc-do/scripts"; if [[ ! -d "$SCRIPT_ROOT" && -d ".codex/skills/cc-do/scripts" ]]; then SCRIPT_ROOT=".codex/skills/cc-do/scripts"; fi; bash "$SCRIPT_ROOT/mark-task-complete.sh" --manifest docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/task-manifest.json --tasks docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/tasks.md --task T002`; do not hand-edit status.
+  Completion: after verification evidence and required review records exist, run `SCRIPT_ROOT=".claude/skills/cc-do/scripts"; if [[ ! -d "$SCRIPT_ROOT" && -d ".codex/skills/cc-do/scripts" ]]; then SCRIPT_ROOT=".codex/skills/cc-do/scripts"; fi; bash "$SCRIPT_ROOT/mark-task-complete.sh" --manifest docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/ --tasks docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/task.md --task T002`; do not hand-edit status.
   Test seam: bulk invite rules and admin upload UI behavior
   Public verification path: Run the bulk invite rule and admin panel tests through their public flows
   Allowed mocks: file upload boundary / billing / seat limit boundary
@@ -96,7 +101,7 @@ bash "$SCRIPT_ROOT/mark-task-complete.sh" --manifest docs/examples/full-design-b
   Read first: `design.md`, `src/admin/BulkInvitePanel.tsx`
   Verification: `npm test -- src/admin/BulkInvitePanel.test.tsx`
   Evidence: failing output
-  Completion: after verification evidence and required review records exist, run `SCRIPT_ROOT=".claude/skills/cc-do/scripts"; if [[ ! -d "$SCRIPT_ROOT" && -d ".codex/skills/cc-do/scripts" ]]; then SCRIPT_ROOT=".codex/skills/cc-do/scripts"; fi; bash "$SCRIPT_ROOT/mark-task-complete.sh" --manifest docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/task-manifest.json --tasks docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/tasks.md --task T003`; do not hand-edit status.
+  Completion: after verification evidence and required review records exist, run `SCRIPT_ROOT=".claude/skills/cc-do/scripts"; if [[ ! -d "$SCRIPT_ROOT" && -d ".codex/skills/cc-do/scripts" ]]; then SCRIPT_ROOT=".codex/skills/cc-do/scripts"; fi; bash "$SCRIPT_ROOT/mark-task-complete.sh" --manifest docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/ --tasks docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/task.md --task T003`; do not hand-edit status.
   Test seam: bulk invite rules and admin upload UI behavior
   Public verification path: Run the bulk invite rule and admin panel tests through their public flows
   Allowed mocks: file upload boundary / billing / seat limit boundary
@@ -109,7 +114,7 @@ bash "$SCRIPT_ROOT/mark-task-complete.sh" --manifest docs/examples/full-design-b
   Read first: `design.md`, `src/admin/BulkInvitePanel.test.tsx`
   Verification: `npm test -- src/admin/BulkInvitePanel.test.tsx`
   Evidence: passing output + review notes
-  Completion: after verification evidence and required review records exist, run `SCRIPT_ROOT=".claude/skills/cc-do/scripts"; if [[ ! -d "$SCRIPT_ROOT" && -d ".codex/skills/cc-do/scripts" ]]; then SCRIPT_ROOT=".codex/skills/cc-do/scripts"; fi; bash "$SCRIPT_ROOT/mark-task-complete.sh" --manifest docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/task-manifest.json --tasks docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/tasks.md --task T004`; do not hand-edit status.
+  Completion: after verification evidence and required review records exist, run `SCRIPT_ROOT=".claude/skills/cc-do/scripts"; if [[ ! -d "$SCRIPT_ROOT" && -d ".codex/skills/cc-do/scripts" ]]; then SCRIPT_ROOT=".codex/skills/cc-do/scripts"; fi; bash "$SCRIPT_ROOT/mark-task-complete.sh" --manifest docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/ --tasks docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/task.md --task T004`; do not hand-edit status.
   Test seam: bulk invite rules and admin upload UI behavior
   Public verification path: Run the bulk invite rule and admin panel tests through their public flows
   Allowed mocks: file upload boundary / billing / seat limit boundary
@@ -121,12 +126,12 @@ bash "$SCRIPT_ROOT/mark-task-complete.sh" --manifest docs/examples/full-design-b
   Goal: 为 `cc-check` 准备 bulk invite 的新鲜证据。
   TDD phase: evidence
   Files: `src/admin/BulkInvitePanel.tsx`, `src/invite/bulk-import.ts`
-  Read first: `tasks.md`, `task-manifest.json`
+  Read first: `task.md`
   Verification:
   - `npm test -- src/invite/bulk-import.test.ts`
   - `npm test -- src/admin/BulkInvitePanel.test.tsx`
   Evidence: passing output + review notes
-  Completion: after verification evidence and required review records exist, run `SCRIPT_ROOT=".claude/skills/cc-do/scripts"; if [[ ! -d "$SCRIPT_ROOT" && -d ".codex/skills/cc-do/scripts" ]]; then SCRIPT_ROOT=".codex/skills/cc-do/scripts"; fi; bash "$SCRIPT_ROOT/mark-task-complete.sh" --manifest docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/task-manifest.json --tasks docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/tasks.md --task T005`; do not hand-edit status.
+  Completion: after verification evidence and required review records exist, run `SCRIPT_ROOT=".claude/skills/cc-do/scripts"; if [[ ! -d "$SCRIPT_ROOT" && -d ".codex/skills/cc-do/scripts" ]]; then SCRIPT_ROOT=".codex/skills/cc-do/scripts"; fi; bash "$SCRIPT_ROOT/mark-task-complete.sh" --manifest docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/ --tasks docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/task.md --task T005`; do not hand-edit status.
   Test seam: bulk invite rules and admin upload UI behavior
   Public verification path: Run the bulk invite rule and admin panel tests through their public flows
   Allowed mocks: file upload boundary / billing / seat limit boundary