cc-codeconductor 1.5.0 → 1.5.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 (144) hide show
  1. package/README.md +20 -7
  2. package/dist/domain/product/entities.d.ts +1 -1
  3. package/dist/index.js +521 -246
  4. package/dist/library.js +47 -3
  5. package/dist/validation/schemas.d.ts +183 -21
  6. package/docs/generated/cli.md +8 -0
  7. package/package.json +1 -1
  8. package/presets/agy/workflows/cc-api-contract.md +4 -5
  9. package/presets/agy/workflows/cc-backlog.md +4 -5
  10. package/presets/agy/workflows/cc-clarify.md +4 -5
  11. package/presets/agy/workflows/cc-council.md +4 -5
  12. package/presets/agy/workflows/cc-db-migration.md +4 -5
  13. package/presets/agy/workflows/cc-explore.md +4 -5
  14. package/presets/agy/workflows/cc-feature.md +4 -5
  15. package/presets/agy/workflows/cc-fix.md +4 -5
  16. package/presets/agy/workflows/cc-handoff.md +8 -5
  17. package/presets/agy/workflows/cc-iterative.md +4 -5
  18. package/presets/agy/workflows/cc-odd.md +4 -3
  19. package/presets/agy/workflows/cc-openspec.md +5 -6
  20. package/presets/agy/workflows/cc-pagespeed.md +4 -5
  21. package/presets/agy/workflows/cc-prototype.md +4 -5
  22. package/presets/agy/workflows/cc-refactor.md +4 -5
  23. package/presets/agy/workflows/cc-review.md +4 -5
  24. package/presets/agy/workflows/cc-scorecard.md +4 -5
  25. package/presets/agy/workflows/cc-security.md +4 -5
  26. package/presets/agy/workflows/cc-spec-mutation.md +4 -5
  27. package/presets/agy/workflows/cc-tdd-cycle.md +4 -5
  28. package/presets/agy/workflows/cc-test-plan.md +4 -5
  29. package/presets/agy/workflows/cc-triage.md +4 -5
  30. package/presets/claude/CLAUDE.md +6 -5
  31. package/presets/claude/commands/cc/api-contract.md +4 -5
  32. package/presets/claude/commands/cc/backlog.md +4 -5
  33. package/presets/claude/commands/cc/clarify.md +4 -5
  34. package/presets/claude/commands/cc/council.md +4 -5
  35. package/presets/claude/commands/cc/db-migration.md +4 -5
  36. package/presets/claude/commands/cc/explore.md +4 -5
  37. package/presets/claude/commands/cc/feature.md +4 -5
  38. package/presets/claude/commands/cc/fix.md +4 -5
  39. package/presets/claude/commands/cc/handoff.md +8 -5
  40. package/presets/claude/commands/cc/iterative.md +4 -5
  41. package/presets/claude/commands/cc/odd.md +4 -3
  42. package/presets/claude/commands/cc/openspec.md +23 -7
  43. package/presets/claude/commands/cc/pagespeed.md +4 -5
  44. package/presets/claude/commands/cc/prototype.md +4 -5
  45. package/presets/claude/commands/cc/refactor.md +4 -5
  46. package/presets/claude/commands/cc/review.md +4 -5
  47. package/presets/claude/commands/cc/scorecard.md +4 -5
  48. package/presets/claude/commands/cc/security.md +4 -5
  49. package/presets/claude/commands/cc/spec-mutation.md +4 -5
  50. package/presets/claude/commands/cc/tdd-cycle.md +4 -5
  51. package/presets/claude/commands/cc/test-plan.md +4 -5
  52. package/presets/claude/commands/cc/triage.md +4 -5
  53. package/presets/claude/settings.json +32 -78
  54. package/presets/codex/config.toml +2 -0
  55. package/presets/codex/skills/cc-api-contract/SKILL.md +4 -5
  56. package/presets/codex/skills/cc-backlog/SKILL.md +4 -5
  57. package/presets/codex/skills/cc-clarify/SKILL.md +4 -5
  58. package/presets/codex/skills/cc-council/SKILL.md +10 -5
  59. package/presets/codex/skills/cc-db-migration/SKILL.md +4 -5
  60. package/presets/codex/skills/cc-explore/SKILL.md +4 -5
  61. package/presets/codex/skills/cc-feature/SKILL.md +4 -5
  62. package/presets/codex/skills/cc-fix/SKILL.md +4 -5
  63. package/presets/codex/skills/cc-handoff/SKILL.md +8 -5
  64. package/presets/codex/skills/cc-iterative/SKILL.md +4 -5
  65. package/presets/codex/skills/cc-odd/SKILL.md +4 -3
  66. package/presets/codex/skills/cc-openspec/SKILL.md +11 -6
  67. package/presets/codex/skills/cc-pagespeed/SKILL.md +4 -5
  68. package/presets/codex/skills/cc-prototype/SKILL.md +4 -5
  69. package/presets/codex/skills/cc-refactor/SKILL.md +4 -5
  70. package/presets/codex/skills/cc-review/SKILL.md +4 -5
  71. package/presets/codex/skills/cc-scorecard/SKILL.md +4 -5
  72. package/presets/codex/skills/cc-security/SKILL.md +4 -5
  73. package/presets/codex/skills/cc-spec-mutation/SKILL.md +4 -5
  74. package/presets/codex/skills/cc-tdd-cycle/SKILL.md +4 -5
  75. package/presets/codex/skills/cc-test-plan/SKILL.md +4 -5
  76. package/presets/codex/skills/cc-triage/SKILL.md +4 -5
  77. package/presets/cursor/commands/cc/api-contract.md +4 -5
  78. package/presets/cursor/commands/cc/backlog.md +4 -5
  79. package/presets/cursor/commands/cc/clarify.md +4 -5
  80. package/presets/cursor/commands/cc/council.md +4 -5
  81. package/presets/cursor/commands/cc/db-migration.md +4 -5
  82. package/presets/cursor/commands/cc/explore.md +4 -5
  83. package/presets/cursor/commands/cc/feature.md +4 -5
  84. package/presets/cursor/commands/cc/fix.md +4 -5
  85. package/presets/cursor/commands/cc/handoff.md +8 -5
  86. package/presets/cursor/commands/cc/iterative.md +4 -5
  87. package/presets/cursor/commands/cc/odd.md +4 -3
  88. package/presets/cursor/commands/cc/openspec.md +5 -6
  89. package/presets/cursor/commands/cc/pagespeed.md +4 -5
  90. package/presets/cursor/commands/cc/prototype.md +4 -5
  91. package/presets/cursor/commands/cc/refactor.md +4 -5
  92. package/presets/cursor/commands/cc/review.md +4 -5
  93. package/presets/cursor/commands/cc/scorecard.md +4 -5
  94. package/presets/cursor/commands/cc/security.md +4 -5
  95. package/presets/cursor/commands/cc/spec-mutation.md +4 -5
  96. package/presets/cursor/commands/cc/tdd-cycle.md +4 -5
  97. package/presets/cursor/commands/cc/test-plan.md +4 -5
  98. package/presets/cursor/commands/cc/triage.md +4 -5
  99. package/presets/gemini/commands/cc/api-contract.toml +4 -5
  100. package/presets/gemini/commands/cc/backlog.toml +4 -5
  101. package/presets/gemini/commands/cc/clarify.toml +4 -5
  102. package/presets/gemini/commands/cc/council.toml +4 -5
  103. package/presets/gemini/commands/cc/db-migration.toml +4 -5
  104. package/presets/gemini/commands/cc/explore.toml +4 -5
  105. package/presets/gemini/commands/cc/feature.toml +4 -5
  106. package/presets/gemini/commands/cc/fix.toml +4 -5
  107. package/presets/gemini/commands/cc/handoff.toml +8 -5
  108. package/presets/gemini/commands/cc/iterative.toml +4 -5
  109. package/presets/gemini/commands/cc/odd.toml +4 -3
  110. package/presets/gemini/commands/cc/openspec.toml +5 -6
  111. package/presets/gemini/commands/cc/pagespeed.toml +4 -5
  112. package/presets/gemini/commands/cc/prototype.toml +4 -5
  113. package/presets/gemini/commands/cc/refactor.toml +4 -5
  114. package/presets/gemini/commands/cc/review.toml +4 -5
  115. package/presets/gemini/commands/cc/scorecard.toml +4 -5
  116. package/presets/gemini/commands/cc/security.toml +4 -5
  117. package/presets/gemini/commands/cc/spec-mutation.toml +4 -5
  118. package/presets/gemini/commands/cc/tdd-cycle.toml +4 -5
  119. package/presets/gemini/commands/cc/test-plan.toml +4 -5
  120. package/presets/gemini/commands/cc/triage.toml +4 -5
  121. package/presets/opencode/commands/cc-api-contract.md +4 -5
  122. package/presets/opencode/commands/cc-backlog.md +4 -5
  123. package/presets/opencode/commands/cc-clarify.md +4 -5
  124. package/presets/opencode/commands/cc-council.md +4 -5
  125. package/presets/opencode/commands/cc-db-migration.md +4 -5
  126. package/presets/opencode/commands/cc-explore.md +4 -5
  127. package/presets/opencode/commands/cc-feature.md +4 -5
  128. package/presets/opencode/commands/cc-fix.md +4 -5
  129. package/presets/opencode/commands/cc-handoff.md +8 -5
  130. package/presets/opencode/commands/cc-iterative.md +4 -5
  131. package/presets/opencode/commands/cc-odd.md +4 -3
  132. package/presets/opencode/commands/cc-openspec.md +6 -7
  133. package/presets/opencode/commands/cc-pagespeed.md +4 -5
  134. package/presets/opencode/commands/cc-prototype.md +4 -5
  135. package/presets/opencode/commands/cc-refactor.md +4 -5
  136. package/presets/opencode/commands/cc-review.md +4 -5
  137. package/presets/opencode/commands/cc-scorecard.md +4 -5
  138. package/presets/opencode/commands/cc-security.md +4 -5
  139. package/presets/opencode/commands/cc-spec-mutation.md +4 -5
  140. package/presets/opencode/commands/cc-tdd-cycle.md +4 -5
  141. package/presets/opencode/commands/cc-test-plan.md +4 -5
  142. package/presets/opencode/commands/cc-triage.md +4 -5
  143. package/src/presets/manifests/codex.yml +3 -0
  144. package/src/presets/models/roles.yml +26 -28
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  **Stop prompting. Start orchestrating.**
4
4
 
5
- [![Socket Badge](https://badge.socket.dev/npm/package/cc-codeconductor/1.5.0)](https://badge.socket.dev/npm/package/cc-codeconductor/1.5.0)
5
+ [![Socket Badge](https://badge.socket.dev/npm/package/cc-codeconductor/1.5.1)](https://badge.socket.dev/npm/package/cc-codeconductor/1.5.1)
6
6
 
7
7
  CodeConductor is an open-source framework for building structured, reproducible
8
8
  AI-assisted software engineering workflows.
@@ -15,7 +15,7 @@ contracts, task cards, and risk-based routing.
15
15
  >
16
16
  > ## Current Scope
17
17
  >
18
- > Published package is **1.5.0** (current stable line: **1.5.x**). Limitations
18
+ > Published package is **1.5.1** (current stable line: **1.5.x**). Limitations
19
19
  > matrix:
20
20
  > [docs/current-status.md](docs/current-status.md). This repository:
21
21
  > `bun run dev …` (not `npx`) while iterating.
@@ -146,8 +146,9 @@ engineering skill. Re-install presets after upgrading.
146
146
  closed.
147
147
  - **Schemas.** `ExecutionContext.ast.source` includes `product-graph`.
148
148
  `ReviewerOutput` finding `axis` is extended with Staff Engineer axes.
149
- - **CCEP bootstrap.** Installed slash commands run `ccep parse` → `resolve` →
150
- `profile` → `evaluate` before delegating to agents. Agent JSON must validate
149
+ - **CCEP bootstrap.** Installed slash commands run `ccep profile` → `compile`
150
+ (one role-scoped prompt per delegated phase) → `evaluate` before delegating
151
+ to agents. Agent JSON must validate
151
152
  against Zod; unknown output schemas fail closed.
152
153
 
153
154
  ### Slash commands
@@ -324,14 +325,14 @@ Task Card → Risk Classification → Routing Policy → Conductor Agent → Del
324
325
 
325
326
  ## Supply chain
326
327
 
327
- Published **1.5.0** declares two production dependencies (`package.json`
328
+ Published **1.5.1** declares two production dependencies (`package.json`
328
329
  `dependencies`; same on
329
330
  [npm](https://www.npmjs.com/package/cc-codeconductor)). Neither has further
330
331
  npm transitive dependencies.
331
332
 
332
333
  ```mermaid
333
334
  graph LR
334
- cc["cc-codeconductor@1.5.0"]
335
+ cc["cc-codeconductor@1.5.1"]
335
336
  zod["zod@^3.23.8"]
336
337
  yaml["yaml@^2.4.5"]
337
338
  cc --> zod
@@ -653,6 +654,7 @@ npx cc-codeconductor ccep parse --command review "PR #42" --output json
653
654
  npx cc-codeconductor ccep profile tdd-cycle --output json
654
655
  npx cc-codeconductor ccep resolve --command feature "Add CRUD" --output json
655
656
  npx cc-codeconductor ccep compile --command feature --phase intake --role task-coach "Add CRUD" --output json
657
+ npx cc-codeconductor ccep compile --command feature --phase intake --view prompt --record-telemetry --execution-id exec-1 --task-id task-1 --context-strategy artifact "Add CRUD" --output json
656
658
  npx cc-codeconductor ccep validate --command feature --phase implement --role implementer --output json \
657
659
  --input @implementer-output.json
658
660
  npx cc-codeconductor ccep evaluate --command feature --input @planner.json --output json
@@ -665,6 +667,12 @@ Subcommands: `parse` / `profile` / `resolve` / `compile` / `validate` /
665
667
  Zod schema for that role. `consensus` exit codes: `0` APPROVED, `1` REJECTED,
666
668
  `2` ESCALATED. Full protocol: [docs/CCEP.md](docs/CCEP.md).
667
669
 
670
+ `compile --view prompt|layers|full` controls the returned representation;
671
+ `full` remains the default. `--record-telemetry` appends local compilation
672
+ sizes and timing to `.codeconductor/events.jsonl`; unavailable provider and
673
+ token metrics are recorded as `unknown`. `--execution-id`, `--task-id`, and
674
+ `--context-strategy` add correlation metadata when recording telemetry.
675
+
668
676
  #### `openspec` — backlog delivery loop
669
677
 
670
678
  ```bash
@@ -680,6 +688,7 @@ npx cc-codeconductor openspec block BC-001-implement --reason "waiting on design
680
688
  npx cc-codeconductor openspec unblock BC-001-implement
681
689
  npx cc-codeconductor openspec archive BC-001
682
690
  npx cc-codeconductor odd read delivery-001
691
+ npx cc-codeconductor odd handoff --id delivery-001 --output json
683
692
  ```
684
693
 
685
694
  Subcommands: `validate` / `scan` / `plan` / `analyze` / `status` / `next` /
@@ -689,6 +698,10 @@ archive synchronizes validated deltas into durable specs before filing the
689
698
  change. Illegal status transitions fail closed. See
690
699
  [docs/SDD.md](docs/SDD.md) and the OpenSpec skill.
691
700
 
701
+ `odd handoff` derives a compact envelope from the Delivery Ledger and current
702
+ workspace state. It contains the task, scope, evidence, changed paths, and next
703
+ action; it does not return the ledger body or a conversation transcript.
704
+
692
705
  #### Product OS — `ingest` / `product` / `orchestrate` / `impact` / `verify`
693
706
 
694
707
  ```bash
@@ -847,7 +860,7 @@ codeconductor/
847
860
 
848
861
  ## Roadmap
849
862
 
850
- Published package: **1.5.x (current stable: 1.5.0)**. Remaining gaps (sandbox, policy compiler, full
863
+ Published package: **1.5.x (current stable: 1.5.1)**. Remaining gaps (sandbox, policy compiler, full
851
864
  stack-specific asset pruning): [docs/current-status.md](docs/current-status.md).
852
865
  Release history: [CHANGELOG.md](CHANGELOG.md).
853
866
 
@@ -6,6 +6,6 @@ export type ConfidenceLevel = 'low' | 'medium' | 'high';
6
6
  export type ProductNodeType = 'product' | 'domain' | 'capability' | 'requirement' | 'decision' | 'component' | 'flow' | 'contract' | 'metric' | 'risk' | 'task' | 'evidence';
7
7
  export type GraphRelation = 'implements' | 'depends_on' | 'documents' | 'affects' | 'evidences' | 'blocks' | 'contains';
8
8
  export type MemoryLayer = 'operational' | 'semantic' | 'episodic' | 'procedural' | 'strategic';
9
- export type ProductEventType = 'task.started' | 'task.completed' | 'decision.recorded' | 'evidence.added' | 'ingest.completed' | 'goal.updated' | 'blocker.detected' | 'verification.completed' | 'feedback.processed';
9
+ export type ProductEventType = 'task.started' | 'task.completed' | 'decision.recorded' | 'evidence.added' | 'ingest.completed' | 'goal.updated' | 'blocker.detected' | 'verification.completed' | 'feedback.processed' | 'context.compiled';
10
10
  export declare const PRODUCT_NODE_TYPES: readonly ProductNodeType[];
11
11
  export declare const GRAPH_RELATIONS: readonly GraphRelation[];