cc-codeconductor 1.6.1 → 1.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (118) hide show
  1. package/README.md +23 -7
  2. package/dist/core/compilation/compile-checker.d.ts +3 -2
  3. package/dist/core/goal/goal-state.d.ts +1 -0
  4. package/dist/core/orchestrator/runtime-orchestrator.d.ts +1 -0
  5. package/dist/core/queue/lock.d.ts +3 -0
  6. package/dist/core/verification/rdd-receipt.d.ts +6 -0
  7. package/dist/core/verification/verification-runner.d.ts +11 -2
  8. package/dist/index.js +1217 -596
  9. package/dist/library.js +391 -140
  10. package/dist/validation/schemas.d.ts +65 -26
  11. package/docs/generated/cli.md +8 -0
  12. package/package.json +1 -1
  13. package/presets/agy/AGENTS.md +1 -1
  14. package/presets/agy/scripts/invoke-hook.cjs +43 -24
  15. package/presets/agy/skills/backlog/SKILL.md +1 -1
  16. package/presets/agy/skills/cc-spec-mutation/SKILL.md +1 -1
  17. package/presets/agy/skills/cc-tdd-cycle/SKILL.md +1 -1
  18. package/presets/agy/skills/evaluation/SKILL.md +1 -1
  19. package/presets/agy/skills/openspec/SKILL.md +10 -6
  20. package/presets/agy/skills/testing-tdd/SKILL.md +3 -3
  21. package/presets/agy/workflows/cc-api-contract.md +1 -1
  22. package/presets/agy/workflows/cc-ask.md +2 -2
  23. package/presets/agy/workflows/cc-db-migration.md +1 -1
  24. package/presets/agy/workflows/cc-feature.md +1 -1
  25. package/presets/agy/workflows/cc-fix.md +1 -1
  26. package/presets/agy/workflows/cc-iterative.md +1 -1
  27. package/presets/agy/workflows/cc-odd.md +2 -2
  28. package/presets/agy/workflows/cc-openspec.md +1 -1
  29. package/presets/agy/workflows/cc-spec-mutation.md +2 -2
  30. package/presets/agy/workflows/cc-tdd-cycle.md +2 -2
  31. package/presets/claude/CLAUDE.md +1 -1
  32. package/presets/claude/commands/cc/api-contract.md +1 -1
  33. package/presets/claude/commands/cc/ask.md +2 -2
  34. package/presets/claude/commands/cc/db-migration.md +1 -1
  35. package/presets/claude/commands/cc/feature.md +1 -1
  36. package/presets/claude/commands/cc/fix.md +1 -1
  37. package/presets/claude/commands/cc/iterative.md +1 -1
  38. package/presets/claude/commands/cc/odd.md +2 -2
  39. package/presets/claude/commands/cc/openspec.md +5 -5
  40. package/presets/claude/commands/cc/spec-mutation.md +2 -2
  41. package/presets/claude/commands/cc/tdd-cycle.md +3 -3
  42. package/presets/claude/settings.json +6 -101
  43. package/presets/claude/skills/backlog/SKILL.md +1 -1
  44. package/presets/claude/skills/evaluation/SKILL.md +1 -1
  45. package/presets/claude/skills/openspec/SKILL.md +10 -6
  46. package/presets/claude/skills/testing-tdd/SKILL.md +3 -3
  47. package/presets/codex/AGENTS.md +1 -1
  48. package/presets/codex/commands/cc-ask.md +2 -2
  49. package/presets/codex/skills/backlog/SKILL.md +1 -1
  50. package/presets/codex/skills/cc-api-contract/SKILL.md +1 -1
  51. package/presets/codex/skills/cc-db-migration/SKILL.md +1 -1
  52. package/presets/codex/skills/cc-feature/SKILL.md +1 -1
  53. package/presets/codex/skills/cc-fix/SKILL.md +1 -1
  54. package/presets/codex/skills/cc-iterative/SKILL.md +1 -1
  55. package/presets/codex/skills/cc-odd/SKILL.md +2 -2
  56. package/presets/codex/skills/cc-openspec/SKILL.md +10 -8
  57. package/presets/codex/skills/cc-spec-mutation/SKILL.md +2 -2
  58. package/presets/codex/skills/cc-tdd-cycle/SKILL.md +2 -2
  59. package/presets/codex/skills/django-testing/SKILL.md +1 -1
  60. package/presets/codex/skills/evaluation/SKILL.md +1 -1
  61. package/presets/codex/skills/openspec/SKILL.md +10 -6
  62. package/presets/codex/skills/python-django-stack/SKILL.md +1 -1
  63. package/presets/codex/skills/testing-tdd/SKILL.md +3 -3
  64. package/presets/cursor/AGENTS.md +1 -1
  65. package/presets/cursor/commands/cc/api-contract.md +1 -1
  66. package/presets/cursor/commands/cc/ask.md +2 -2
  67. package/presets/cursor/commands/cc/db-migration.md +1 -1
  68. package/presets/cursor/commands/cc/feature.md +1 -1
  69. package/presets/cursor/commands/cc/fix.md +1 -1
  70. package/presets/cursor/commands/cc/iterative.md +1 -1
  71. package/presets/cursor/commands/cc/odd.md +2 -2
  72. package/presets/cursor/commands/cc/openspec.md +10 -8
  73. package/presets/cursor/commands/cc/spec-mutation.md +2 -2
  74. package/presets/cursor/commands/cc/tdd-cycle.md +2 -2
  75. package/presets/cursor/skills/backlog/SKILL.md +1 -1
  76. package/presets/cursor/skills/evaluation/SKILL.md +1 -1
  77. package/presets/cursor/skills/openspec/SKILL.md +10 -6
  78. package/presets/cursor/skills/testing-tdd/SKILL.md +3 -3
  79. package/presets/gemini/GEMINI.md +1 -1
  80. package/presets/gemini/commands/cc/api-contract.toml +1 -1
  81. package/presets/gemini/commands/cc/ask.toml +2 -2
  82. package/presets/gemini/commands/cc/db-migration.toml +1 -1
  83. package/presets/gemini/commands/cc/feature.toml +1 -1
  84. package/presets/gemini/commands/cc/fix.toml +1 -1
  85. package/presets/gemini/commands/cc/iterative.toml +1 -1
  86. package/presets/gemini/commands/cc/odd.toml +2 -2
  87. package/presets/gemini/commands/cc/openspec.toml +10 -8
  88. package/presets/gemini/commands/cc/spec-mutation.toml +2 -2
  89. package/presets/gemini/commands/cc/tdd-cycle.toml +2 -2
  90. package/presets/muse/AGENTS.md +1 -1
  91. package/presets/opencode/agents/implementer.md +1 -1
  92. package/presets/opencode/agents/tester.md +1 -1
  93. package/presets/opencode/commands/cc-api-contract.md +1 -1
  94. package/presets/opencode/commands/cc-ask.md +2 -2
  95. package/presets/opencode/commands/cc-db-migration.md +1 -1
  96. package/presets/opencode/commands/cc-feature.md +1 -1
  97. package/presets/opencode/commands/cc-fix.md +1 -1
  98. package/presets/opencode/commands/cc-iterative.md +1 -1
  99. package/presets/opencode/commands/cc-odd.md +2 -2
  100. package/presets/opencode/commands/cc-openspec.md +2 -2
  101. package/presets/opencode/commands/cc-spec-mutation.md +2 -2
  102. package/presets/opencode/commands/cc-tdd-cycle.md +2 -2
  103. package/presets/opencode/prompts/v1.0.0/implementer.md +1 -1
  104. package/presets/opencode/prompts/v1.0.0/tester.md +1 -1
  105. package/presets/opencode/skills/backlog/SKILL.md +1 -1
  106. package/presets/opencode/skills/django-testing/SKILL.md +1 -0
  107. package/presets/opencode/skills/evaluation/SKILL.md +1 -1
  108. package/presets/opencode/skills/openspec/SKILL.md +10 -6
  109. package/presets/opencode/skills/python-django-stack/SKILL.md +1 -0
  110. package/presets/opencode/skills/python-fastapi-stack/SKILL.md +1 -0
  111. package/presets/opencode/skills/spring-boot-kotlin/SKILL.md +1 -0
  112. package/presets/opencode/skills/sqlalchemy/SKILL.md +1 -0
  113. package/presets/opencode/skills/testing-tdd/SKILL.md +3 -3
  114. package/presets/pi/AGENTS.md +1 -1
  115. package/presets/shared/invoke-hook.cjs +43 -24
  116. package/src/presets/manifests/claude.yml +1 -1
  117. package/src/presets/shared-skills.yml +30 -0
  118. package/src/presets/targets/pi.yml +1 -1
@@ -290,6 +290,6 @@ and confirmed failing; list the failing test paths in `artifacts` so the
290
290
 
291
291
  Invoke via `/cc-tdd-cycle`, `/cc-feature`, or the orchestrator (test before
292
292
  implement). Do not invoke other agents. Invoke skill `testing-tdd`.
293
- Deliverable is incomplete without `captureTddSuiteEvidence` when TDD is required.
293
+ Deliverable is incomplete without `npx cc-codeconductor tdd capture` when TDD is required.
294
294
  Record the matching RDD receipt and report it with the test evidence. A changed
295
295
  candidate requires a new verification before handoff.
@@ -28,7 +28,7 @@ If `openspec status` reports an active change folder:
28
28
  3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
29
29
  4. Next command spelling on this runner: `/cc-api-contract`
30
30
 
31
- Local development: `bun run dev <same argv>`. Published package: `npx cc-codeconductor`.
31
+ Run the CLI as `npx cc-codeconductor <same argv>`.
32
32
 
33
33
  ---
34
34
 
@@ -15,10 +15,10 @@ Do **not** run the recommended `/cc-` command unless the human confirms.
15
15
 
16
16
  ## Step 1 — Recommend (deterministic)
17
17
 
18
- Run (local repo: `bun run dev`; published package: `npx cc-codeconductor`):
18
+ Run `npx cc-codeconductor`:
19
19
 
20
20
  ```bash
21
- bun run dev ask "$ARGUMENTS" --output json
21
+ npx cc-codeconductor ask "$ARGUMENTS" --output json
22
22
  ```
23
23
 
24
24
  or:
@@ -29,7 +29,7 @@ If `openspec status` reports an active change folder:
29
29
  3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
30
30
  4. Next command spelling on this runner: `/cc-db-migration`
31
31
 
32
- Local development: `bun run dev <same argv>`. Published package: `npx cc-codeconductor`.
32
+ Run the CLI as `npx cc-codeconductor <same argv>`.
33
33
 
34
34
  ---
35
35
 
@@ -51,7 +51,7 @@ If `openspec status` reports an active change folder:
51
51
  3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
52
52
  4. Next command spelling on this runner: `/cc-feature`
53
53
 
54
- Local development: `bun run dev <same argv>`. Published package: `npx cc-codeconductor`.
54
+ Run the CLI as `npx cc-codeconductor <same argv>`.
55
55
 
56
56
  Skills: `using-cc-skills`, `openspec`, `testing-tdd`, `evaluation`.
57
57
  Do not skip `openspec analyze` when a change folder is active.
@@ -61,7 +61,7 @@ If `openspec status` reports an active change folder:
61
61
  3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
62
62
  4. Next command spelling on this runner: `/cc-fix`
63
63
 
64
- Local development: `bun run dev <same argv>`. Published package: `npx cc-codeconductor`.
64
+ Run the CLI as `npx cc-codeconductor <same argv>`.
65
65
 
66
66
  ---
67
67
 
@@ -29,7 +29,7 @@ If `openspec status` reports an active change folder:
29
29
  3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
30
30
  4. Next command spelling on this runner: `/cc-iterative`
31
31
 
32
- Local development: `bun run dev <same argv>`. Published package: `npx cc-codeconductor`.
32
+ Run the CLI as `npx cc-codeconductor <same argv>`.
33
33
 
34
34
  ---
35
35
 
@@ -7,8 +7,8 @@ description: Create or resume an opt-in Delivery Ledger for substantial authoriz
7
7
  ## Step 0 — CCEP Bootstrap
8
8
 
9
9
  ```bash
10
- bun run dev ccep profile odd --output json
11
- bun run dev ccep compile --command odd --phase <phase-id> "$ARGUMENTS" --view prompt --output json
10
+ npx cc-codeconductor ccep profile odd --output json
11
+ npx cc-codeconductor ccep compile --command odd --phase <phase-id> "$ARGUMENTS" --view prompt --output json
12
12
  ```
13
13
 
14
14
  Pass each subagent only the compiled `prompt` for its phase.
@@ -59,7 +59,7 @@ If `openspec status` reports an active change folder:
59
59
  3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
60
60
  4. Next command spelling on this runner: `/cc-openspec`
61
61
 
62
- Local development: `bun run dev <same argv>`. Published package: `npx cc-codeconductor`.
62
+ Run the CLI as `npx cc-codeconductor <same argv>`.
63
63
 
64
64
  ---
65
65
 
@@ -96,7 +96,7 @@ For each pending card: `npx cc-codeconductor openspec next`, then invoke the lis
96
96
  - implement → `implementer`
97
97
  - review → `reviewer`
98
98
 
99
- Run each phase as a subagent with isolated context. Implementer uses a git worktree. Discover is read-only (never writes code); implementer ticks `tasks.md` boxes (`- [ ]` → `- [x]`, only `x`/`X` counts). If implementation reveals a design problem, pause and reconcile planning artifacts first (any direction, planning-only, confirm each edit); if the intent changed, open a fresh item with `/cc-backlog`.
99
+ Run each phase as a subagent with isolated context. Implementer uses a git worktree. Discover is read-only (never writes code); `done` ticks each card's boxes and the implementer ticks any other `tasks.md` box (`- [ ]` → `- [x]`, only `x`/`X` counts). If implementation reveals a design problem, pause and reconcile planning artifacts first (any direction, planning-only, confirm each edit); if the intent changed, open a fresh item with `/cc-backlog`.
100
100
 
101
101
  ---
102
102
 
@@ -39,7 +39,7 @@ If `openspec status` reports an active change folder:
39
39
  3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
40
40
  4. Next command spelling on this runner: `/cc-spec-mutation`
41
41
 
42
- Local development: `bun run dev <same argv>`. Published package: `npx cc-codeconductor`.
42
+ Run the CLI as `npx cc-codeconductor <same argv>`.
43
43
 
44
44
  ---
45
45
 
@@ -101,7 +101,7 @@ aborts the pipeline with scorecard 0 (Specification Gaming).
101
101
  ## Stage 3 — TDD under the three laws (`tdd_craftsman`)
102
102
 
103
103
  Delegates to the `/cc-tdd-cycle` state machine (`tddCycleStateMachine` in
104
- `domain/loop`). Evidence must be captured with `captureTddSuiteEvidence` — do
104
+ `domain/loop`). Evidence must be captured with `npx cc-codeconductor tdd capture` — do
105
105
  not hand-edit JSON under `.codeconductor/evidence/`.
106
106
 
107
107
  1. **Law 1 (RED):** no production code except to make a failing test pass. A
@@ -38,7 +38,7 @@ If `openspec status` reports an active change folder:
38
38
  3. If analyze `stop` is true or any finding is CRITICAL, stop. Do not delegate to implementer.
39
39
  4. Next command spelling on this runner: `/cc-tdd-cycle`
40
40
 
41
- Local development: `bun run dev <same argv>`. Published package: `npx cc-codeconductor`.
41
+ Run the CLI as `npx cc-codeconductor <same argv>`.
42
42
 
43
43
  ---
44
44
 
@@ -58,7 +58,7 @@ Mixing phases invalidates the cycle.
58
58
  ## Verifiable phase gates
59
59
 
60
60
  RED → GREEN and GREEN → REFACTOR are enforced by `tddCycleStateMachine` in
61
- `domain/loop`. Evidence must be captured with `captureTddSuiteEvidence` (verification
61
+ `domain/loop`. Evidence must be captured with `npx cc-codeconductor tdd capture` (verification
62
62
  runner) — do not hand-edit JSON under `.codeconductor/evidence/`.
63
63
 
64
64
  - RED→GREEN requires runner evidence that the suite **failed**.
@@ -232,4 +232,4 @@ tests. On **REJECT**, stop and escalate to the orchestrator.
232
232
  Invoke via `/cc-feature`, `/cc-fix`, `/cc-tdd-cycle`, or the orchestrator.
233
233
  Do not invoke other agents. Invoke skill `testing-tdd`.
234
234
  Deliverable is incomplete without a passing suite and runner TDD evidence when
235
- TDD is required. Scorecard: `bun run dev scorecard create --from-diff`.
235
+ TDD is required. Scorecard: `npx cc-codeconductor scorecard create --from-diff`.
@@ -301,4 +301,4 @@ and confirmed failing; list the failing test paths in `artifacts` so the
301
301
 
302
302
  Invoke via `/cc-tdd-cycle`, `/cc-feature`, or the orchestrator (test before
303
303
  implement). Do not invoke other agents. Invoke skill `testing-tdd`.
304
- Deliverable is incomplete without `captureTddSuiteEvidence` when TDD is required.
304
+ Deliverable is incomplete without `npx cc-codeconductor tdd capture` when TDD is required.
@@ -29,7 +29,7 @@ the item here.
29
29
  4. Create `BACKLOG.md` from `presets/templates/BACKLOG.md` or append under
30
30
  `## Items`. Do not rewrite `## Global` or `## Archive`.
31
31
  5. Next ID = max numeric suffix in Items + Archive + 1, zero-padded (`BC-013`).
32
- 6. `bun run dev openspec validate` (or `npx cc-codeconductor`). Fix until valid.
32
+ 6. `npx cc-codeconductor openspec validate`. Fix until valid.
33
33
  7. `openspec plan BC-xxx` for each **new** item this run. Then tell the user
34
34
  to run `/cc-openspec`.
35
35
 
@@ -41,6 +41,7 @@ quality:
41
41
  reviewed_by: codeconductor-core
42
42
  version: 0.1.0
43
43
  ---
44
+
44
45
  ## When to Use
45
46
 
46
47
  - Writing any test in `apps/*/tests/` or `apps/*/tests.py`
@@ -25,7 +25,7 @@ Pass threshold: weighted score >= 2.0 and no criterion at 0.
25
25
 
26
26
  ## Process
27
27
 
28
- Local: `bun run dev`. Published: `npx cc-codeconductor`.
28
+ The CLI is always `npx cc-codeconductor`.
29
29
 
30
30
  ```text
31
31
  scorecard create --task BC-001 --from-diff
@@ -24,7 +24,7 @@ coding rules.
24
24
 
25
25
  ## Process
26
26
 
27
- Local CLI is `bun run dev`. Published package is `npx cc-codeconductor`.
27
+ The CLI is always `npx cc-codeconductor`.
28
28
 
29
29
  1. `openspec validate` — must pass before delivery. If you reached this
30
30
  workflow on your own (the user did not ask for OpenSpec) and there is no
@@ -40,9 +40,13 @@ Local CLI is `bun run dev`. Published package is `npx cc-codeconductor`.
40
40
  5. Phases: discover (`repo-explorer`) → design (`architect`) → test (`tester`) →
41
41
  implement (`implementer`) → review (`reviewer`). If Global `TDD required: yes`,
42
42
  test runs before implement. Discover is read-only: it never writes code.
43
- 6. `openspec done` on test/implement requires `captureTddSuiteEvidence`. Handmade
44
- evidence JSON is rejected. The implementer ticks `tasks.md` boxes
45
- (`- [ ]` → `- [x]`) as each FR lands; only `x`/`X` counts as done.
43
+ 6. `openspec done` on test/implement needs runner evidence: run
44
+ `npx cc-codeconductor tdd capture --task <cardId> --phase red|green --command "<test command>"`
45
+ first (RED on the test card, GREEN on the implement card). Handmade evidence JSON is
46
+ rejected. It is `ev-tdd-*` evidence, not an RDD receipt (`ev-rdd-*`, `rdd verify`).
47
+ `done` ticks that card's `tasks.md` boxes and keeps your edits; the implementer ticks
48
+ any other box it adds (`- [ ]` → `- [x]`, only `x`/`X` counts). `archive` fails while
49
+ boxes stay unchecked (override: `--allow-unchecked`).
46
50
  7. When implementation reveals a design problem, pause and reconcile the planning
47
51
  artifacts first — in any direction (a later artifact may force revising an
48
52
  earlier one). Planning artifacts only in that step, never code; confirm each
@@ -54,7 +58,7 @@ Local CLI is `bun run dev`. Published package is `npx cc-codeconductor`.
54
58
  9. `scorecard create --task BC-xxx --from-diff` then record a verdict.
55
59
  10. `openspec archive` only after human review when `Review required: yes` and
56
60
  the scorecard is PASS. Archive re-checks planning artifacts and analyze
57
- CRITICALs, and warns on unchecked `tasks.md` boxes.
61
+ CRITICALs, and fails on unchecked `tasks.md` boxes (override: `--allow-unchecked`), ticks the BACKLOG acceptance criteria.
58
62
 
59
63
  Status machine: `TODO` → `READY` → `PLANNED` → `IN_PROGRESS` → `REVIEW` → `DONE`
60
64
  → Archive. `BLOCKED` returns to `READY`. Reviewer rejection: `REVIEW` →
@@ -111,4 +115,4 @@ delivery read-only and record unavailable visual or emulator evidence as pending
111
115
  - [ ] `tasks.md` boxes ticked as FRs land
112
116
  - [ ] `openspec verify --output json` checked before archive
113
117
  - [ ] `scorecard create --from-diff` recorded
114
- - [ ] Suite check (optional): `bun run dev scorecard suite-run --suite workflow-gates`
118
+ - [ ] Suite check (optional): `npx cc-codeconductor scorecard suite-run --suite workflow-gates`
@@ -45,6 +45,7 @@ quality:
45
45
  reviewed_by: codeconductor-core
46
46
  version: 0.1.0
47
47
  ---
48
+
48
49
  ## When to Use
49
50
 
50
51
  - Writing any new view, service method, or API endpoint
@@ -44,6 +44,7 @@ quality:
44
44
  reviewed_by: codeconductor-core
45
45
  version: 0.1.0
46
46
  ---
47
+
47
48
  ## When to Use
48
49
 
49
50
  - Writing any new endpoint, router, or schema
@@ -42,6 +42,7 @@ quality:
42
42
  reviewed_by: codeconductor-core
43
43
  version: 0.1.0
44
44
  ---
45
+
45
46
  # Spring Boot + Kotlin
46
47
 
47
48
  ## Project Structure
@@ -43,6 +43,7 @@ quality:
43
43
  reviewed_by: codeconductor-core
44
44
  version: 0.1.0
45
45
  ---
46
+
46
47
  ## When to Use
47
48
 
48
49
  - Defining new SQLAlchemy models
@@ -11,7 +11,7 @@ description:
11
11
  ## Overview
12
12
 
13
13
  Red (failing test) → Green (minimal code) → Refactor. Evidence comes from
14
- `captureTddSuiteEvidence`, not handmade JSON.
14
+ `npx cc-codeconductor tdd capture`, not handmade JSON.
15
15
 
16
16
  ## When to Use
17
17
 
@@ -29,7 +29,7 @@ Red (failing test) → Green (minimal code) → Refactor. Evidence comes from
29
29
  when TDD is required).
30
30
  5. Cover happy path, edge, and error for each behavior.
31
31
 
32
- Local: `bun run dev`. Pyramid default: many unit, fewer integration, rare E2E.
32
+ Pyramid default: many unit, fewer integration, rare E2E.
33
33
 
34
34
  ## Common Rationalizations
35
35
 
@@ -50,4 +50,4 @@ Local: `bun run dev`. Pyramid default: many unit, fewer integration, rare E2E.
50
50
  - [ ] Suite failed before implement
51
51
  - [ ] Suite passed after implement
52
52
  - [ ] Runner evidence exists (not handmade)
53
- - [ ] Optional: `bun run dev scorecard suite-run --suite workflow-gates`
53
+ - [ ] Optional: `npx cc-codeconductor scorecard suite-run --suite workflow-gates`
@@ -42,7 +42,7 @@ act as that role for the rest of the step.
42
42
 
43
43
  ## Receipt integrity
44
44
 
45
- - For any implementation, test, review, handoff, or delivery decision, capture or verify the current RDD receipt with `bun run dev rdd`.
45
+ - For any implementation, test, review, handoff, or delivery decision, capture or verify the current RDD receipt with `npx cc-codeconductor rdd`.
46
46
  - A receipt is valid only for its exact candidate. If code, tests, contracts, or runner configuration changed, repeat the affected verification.
47
47
  - TDD and Mutation Testing retain their existing gates; RDD verifies that their observed evidence still belongs to the current candidate.
48
48
 
@@ -3,7 +3,7 @@
3
3
 
4
4
  const { spawnSync } = require('node:child_process');
5
5
  const { existsSync, readFileSync, realpathSync } = require('node:fs');
6
- const { delimiter, join, resolve } = require('node:path');
6
+ const { delimiter, dirname, join, resolve } = require('node:path');
7
7
 
8
8
  const VALID_EVENTS = ['pre-tool', 'post-tool', 'session-start'];
9
9
  const SPAWN_TIMEOUT = 10000;
@@ -17,17 +17,15 @@ const args = rawArgs.filter((arg) => {
17
17
  const event = args.find((a) => VALID_EVENTS.includes(a)) || 'pre-tool';
18
18
  const extra = args.filter((a) => a !== event);
19
19
  const isAgy = process.argv.some((a) => a === '--format=agy') || extra.includes('--format=agy');
20
+ const failClosed = process.env.CC_HOOK_FAIL_CLOSED === '1' || extra.includes('--fail-closed');
21
+ const checkOnly = extra.includes('--check');
22
+ const runnerExtra = extra.filter(arg => arg !== '--fail-closed' && arg !== '--check');
20
23
 
21
24
  function findProjectRoot() {
22
- const candidates = [
23
- process.env.PROJECT_ROOT,
24
- process.env.CLAUDE_PROJECT_DIR,
25
- process.env.WORKSPACE_DIR,
26
- process.cwd(),
27
- resolve(__dirname, '..', '..'),
28
- ].filter(Boolean);
29
-
30
- for (const dir of candidates) {
25
+ const explicit = process.env.PROJECT_ROOT || process.env.CLAUDE_PROJECT_DIR || process.env.WORKSPACE_DIR;
26
+ if (explicit) return resolve(explicit);
27
+ let dir = process.cwd();
28
+ while (true) {
31
29
  if (
32
30
  existsSync(join(dir, 'package.json')) ||
33
31
  existsSync(join(dir, '.git')) ||
@@ -36,8 +34,11 @@ function findProjectRoot() {
36
34
  ) {
37
35
  return dir;
38
36
  }
37
+ const parent = dirname(dir);
38
+ if (parent === dir) break;
39
+ dir = parent;
39
40
  }
40
- return resolve(__dirname, '..', '..');
41
+ return process.cwd();
41
42
  }
42
43
 
43
44
  const projectRoot = findProjectRoot();
@@ -55,7 +56,7 @@ const input = process.stdin.isTTY ? '' : readFileSync(0, 'utf8');
55
56
  */
56
57
  function tryRun(bin, runArgs) {
57
58
  try {
58
- const result = spawnSync(bin, runArgs, {
59
+ const result = spawnSync(bin, checkOnly ? [...runArgs.slice(0, runArgs.indexOf('hook')), '--help'] : runArgs, {
59
60
  cwd: projectRoot,
60
61
  stdio: ['pipe', 'pipe', 'pipe'],
61
62
  input,
@@ -71,27 +72,40 @@ function tryRun(bin, runArgs) {
71
72
  process.stderr.write(result.stderr);
72
73
  }
73
74
  if (result.status === 0) {
75
+ if (checkOnly) {
76
+ process.stdout.write(JSON.stringify({ operational: true, failClosed }) + '\n');
77
+ process.exit(0);
78
+ }
74
79
  if (result.stdout) process.stdout.write(result.stdout);
75
80
  process.exit(0);
76
81
  }
77
- if (!isAgy && result.status === 2) {
78
- process.exit(2);
82
+ if (!checkOnly && result.status === 2) {
83
+ if (isAgy) process.stdout.write(JSON.stringify({ decision: 'deny', reason: 'CodeConductor runner denied the tool.' }) + '\n');
84
+ process.exit(isAgy ? 0 : 2);
79
85
  }
80
- return false;
86
+ fallback();
81
87
  } catch {
82
88
  return false;
83
89
  }
84
90
  }
85
91
 
86
92
  function fallback() {
93
+ if (checkOnly) {
94
+ process.stdout.write(JSON.stringify({ operational: false, failClosed }) + '\n');
95
+ process.exit(1);
96
+ }
97
+ const denied = event === 'pre-tool' && failClosed;
98
+ if (denied || event === 'session-start') {
99
+ process.stderr.write('CodeConductor guard unavailable: install cc-codeconductor locally or enable CC_DEV=1 for trusted development.\n');
100
+ }
87
101
  if (isAgy) {
88
102
  if (event === 'post-tool' || event === 'session-start') {
89
103
  process.stdout.write('{}\n');
90
104
  } else {
91
- process.stdout.write('{"decision":"allow"}\n');
105
+ process.stdout.write(JSON.stringify(denied ? { decision: 'deny', reason: 'CodeConductor guard unavailable' } : { decision: 'allow' }) + '\n');
92
106
  }
93
107
  }
94
- process.exit(0);
108
+ process.exit(denied && !isAgy ? 2 : 0);
95
109
  }
96
110
 
97
111
  try {
@@ -101,18 +115,20 @@ try {
101
115
  // tryRun(), so the pre-check is redundant — dropping it halves the spawn
102
116
  // count (and the worst-case latency) for the common case where bun exists.
103
117
  const srcMain = join(projectRoot, 'src', 'cli', 'main.ts');
104
- if (existsSync(srcMain)) {
105
- tryRun('bun', ['run', srcMain, 'hook', event, ...extra]);
118
+ if (process.env.CC_DEV === '1' && existsSync(srcMain)) {
119
+ const metadata = JSON.parse(readFileSync(join(projectRoot, 'package.json'), 'utf8'));
120
+ if (metadata.name === 'cc-codeconductor') tryRun('bun', ['run', srcMain, 'hook', event, ...runnerExtra]);
106
121
  }
107
122
 
108
123
  const packaged = join(projectRoot, 'node_modules', 'cc-codeconductor', 'dist', 'index.js');
109
124
  if (existsSync(packaged)) {
110
- tryRun(process.execPath, [packaged, 'hook', event, ...extra]);
125
+ tryRun(process.execPath, [packaged, 'hook', event, ...runnerExtra]);
111
126
  }
112
127
 
113
128
  const localDist = join(projectRoot, 'dist', 'index.js');
114
- if (existsSync(localDist)) {
115
- tryRun(process.execPath, [localDist, 'hook', event, ...extra]);
129
+ if (process.env.CC_DEV === '1' && existsSync(localDist)) {
130
+ const metadata = JSON.parse(readFileSync(join(projectRoot, 'package.json'), 'utf8'));
131
+ if (metadata.name === 'cc-codeconductor') tryRun(process.execPath, [localDist, 'hook', event, ...runnerExtra]);
116
132
  }
117
133
 
118
134
  // Locate global npm installs without invoking npx or Windows .cmd shims.
@@ -122,9 +138,12 @@ try {
122
138
  join(binDir, '..', 'lib', 'node_modules', 'cc-codeconductor', 'dist', 'index.js'),
123
139
  ];
124
140
  const executable = join(binDir, 'cc-codeconductor');
125
- if (existsSync(executable)) candidates.push(realpathSync(executable));
141
+ if (existsSync(executable)) {
142
+ const resolved = realpathSync(executable);
143
+ if (resolved.endsWith(join('cc-codeconductor', 'dist', 'index.js'))) candidates.push(resolved);
144
+ }
126
145
  for (const candidate of candidates) {
127
- if (existsSync(candidate)) tryRun(process.execPath, [candidate, 'hook', event, ...extra]);
146
+ if (existsSync(candidate)) tryRun(process.execPath, [candidate, 'hook', event, ...runnerExtra]);
128
147
  }
129
148
  }
130
149
  } catch {
@@ -7,7 +7,7 @@ entries:
7
7
  template: true
8
8
  - src: claude/settings.json
9
9
  dest: .claude/settings.json
10
- strategy: overwrite
10
+ strategy: merge-json
11
11
  globalStrategy: merge-json
12
12
  - src: shared/invoke-hook.cjs
13
13
  dest: .claude/hooks/invoke-hook.cjs
@@ -102,3 +102,33 @@ skills:
102
102
  targets: [claude, codex, cursor, opencode, agy]
103
103
  - name: api-versioning
104
104
  targets: [claude, codex, cursor, opencode, agy]
105
+ # Stack skills migrated from duplicated preset copies (BC-026). Never list
106
+ # cursor here: its copies keep `paths:` or differ and stay hand-maintained.
107
+ - name: android
108
+ targets: [claude, codex, opencode]
109
+ - name: backlog
110
+ targets: [claude, codex, opencode, agy]
111
+ - name: conductor-setup
112
+ targets: [claude, codex, opencode]
113
+ - name: django-testing
114
+ targets: [claude, codex, opencode]
115
+ - name: find-skills
116
+ targets: [claude, codex, opencode, seo-hotel]
117
+ - name: laravel-specialist
118
+ targets: [claude, codex, opencode]
119
+ - name: pagespeed-insights
120
+ targets: [claude, codex, opencode, seo-hotel]
121
+ - name: pagespeed-perf
122
+ targets: [claude, codex, opencode]
123
+ - name: php-pro
124
+ targets: [claude, codex, opencode]
125
+ - name: python-django-stack
126
+ targets: [claude, codex, opencode]
127
+ - name: python-fastapi-stack
128
+ targets: [claude, codex, opencode]
129
+ - name: spring-boot-kotlin
130
+ targets: [claude, codex, opencode]
131
+ - name: sqlalchemy
132
+ targets: [claude, codex, opencode]
133
+ - name: security
134
+ targets: [claude, opencode]
@@ -2,7 +2,7 @@ target: pi
2
2
  invocation: hyphen
3
3
  commandFormat: markdown
4
4
  contextFile: AGENTS.md
5
- # ODD is available through `bun run dev odd`; Pi installs no slash-prompt files.
5
+ # ODD is available through `npx cc-codeconductor odd`; Pi installs no slash-prompt files.
6
6
  # No Task tool or subagents (deliberate design choice, per pi's own docs) —
7
7
  # same style as opencode and agy, which share the reason.
8
8
  subagentInvocationStyle: invoke-with-context