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.
- package/README.md +23 -7
- package/dist/core/compilation/compile-checker.d.ts +3 -2
- package/dist/core/goal/goal-state.d.ts +1 -0
- package/dist/core/orchestrator/runtime-orchestrator.d.ts +1 -0
- package/dist/core/queue/lock.d.ts +3 -0
- package/dist/core/verification/rdd-receipt.d.ts +6 -0
- package/dist/core/verification/verification-runner.d.ts +11 -2
- package/dist/index.js +1217 -596
- package/dist/library.js +391 -140
- package/dist/validation/schemas.d.ts +65 -26
- package/docs/generated/cli.md +8 -0
- package/package.json +1 -1
- package/presets/agy/AGENTS.md +1 -1
- package/presets/agy/scripts/invoke-hook.cjs +43 -24
- package/presets/agy/skills/backlog/SKILL.md +1 -1
- package/presets/agy/skills/cc-spec-mutation/SKILL.md +1 -1
- package/presets/agy/skills/cc-tdd-cycle/SKILL.md +1 -1
- package/presets/agy/skills/evaluation/SKILL.md +1 -1
- package/presets/agy/skills/openspec/SKILL.md +10 -6
- package/presets/agy/skills/testing-tdd/SKILL.md +3 -3
- package/presets/agy/workflows/cc-api-contract.md +1 -1
- package/presets/agy/workflows/cc-ask.md +2 -2
- package/presets/agy/workflows/cc-db-migration.md +1 -1
- package/presets/agy/workflows/cc-feature.md +1 -1
- package/presets/agy/workflows/cc-fix.md +1 -1
- package/presets/agy/workflows/cc-iterative.md +1 -1
- package/presets/agy/workflows/cc-odd.md +2 -2
- package/presets/agy/workflows/cc-openspec.md +1 -1
- package/presets/agy/workflows/cc-spec-mutation.md +2 -2
- package/presets/agy/workflows/cc-tdd-cycle.md +2 -2
- package/presets/claude/CLAUDE.md +1 -1
- package/presets/claude/commands/cc/api-contract.md +1 -1
- package/presets/claude/commands/cc/ask.md +2 -2
- package/presets/claude/commands/cc/db-migration.md +1 -1
- package/presets/claude/commands/cc/feature.md +1 -1
- package/presets/claude/commands/cc/fix.md +1 -1
- package/presets/claude/commands/cc/iterative.md +1 -1
- package/presets/claude/commands/cc/odd.md +2 -2
- package/presets/claude/commands/cc/openspec.md +5 -5
- package/presets/claude/commands/cc/spec-mutation.md +2 -2
- package/presets/claude/commands/cc/tdd-cycle.md +3 -3
- package/presets/claude/settings.json +6 -101
- package/presets/claude/skills/backlog/SKILL.md +1 -1
- package/presets/claude/skills/evaluation/SKILL.md +1 -1
- package/presets/claude/skills/openspec/SKILL.md +10 -6
- package/presets/claude/skills/testing-tdd/SKILL.md +3 -3
- package/presets/codex/AGENTS.md +1 -1
- package/presets/codex/commands/cc-ask.md +2 -2
- package/presets/codex/skills/backlog/SKILL.md +1 -1
- package/presets/codex/skills/cc-api-contract/SKILL.md +1 -1
- package/presets/codex/skills/cc-db-migration/SKILL.md +1 -1
- package/presets/codex/skills/cc-feature/SKILL.md +1 -1
- package/presets/codex/skills/cc-fix/SKILL.md +1 -1
- package/presets/codex/skills/cc-iterative/SKILL.md +1 -1
- package/presets/codex/skills/cc-odd/SKILL.md +2 -2
- package/presets/codex/skills/cc-openspec/SKILL.md +10 -8
- package/presets/codex/skills/cc-spec-mutation/SKILL.md +2 -2
- package/presets/codex/skills/cc-tdd-cycle/SKILL.md +2 -2
- package/presets/codex/skills/django-testing/SKILL.md +1 -1
- package/presets/codex/skills/evaluation/SKILL.md +1 -1
- package/presets/codex/skills/openspec/SKILL.md +10 -6
- package/presets/codex/skills/python-django-stack/SKILL.md +1 -1
- package/presets/codex/skills/testing-tdd/SKILL.md +3 -3
- package/presets/cursor/AGENTS.md +1 -1
- package/presets/cursor/commands/cc/api-contract.md +1 -1
- package/presets/cursor/commands/cc/ask.md +2 -2
- package/presets/cursor/commands/cc/db-migration.md +1 -1
- package/presets/cursor/commands/cc/feature.md +1 -1
- package/presets/cursor/commands/cc/fix.md +1 -1
- package/presets/cursor/commands/cc/iterative.md +1 -1
- package/presets/cursor/commands/cc/odd.md +2 -2
- package/presets/cursor/commands/cc/openspec.md +10 -8
- package/presets/cursor/commands/cc/spec-mutation.md +2 -2
- package/presets/cursor/commands/cc/tdd-cycle.md +2 -2
- package/presets/cursor/skills/backlog/SKILL.md +1 -1
- package/presets/cursor/skills/evaluation/SKILL.md +1 -1
- package/presets/cursor/skills/openspec/SKILL.md +10 -6
- package/presets/cursor/skills/testing-tdd/SKILL.md +3 -3
- package/presets/gemini/GEMINI.md +1 -1
- package/presets/gemini/commands/cc/api-contract.toml +1 -1
- package/presets/gemini/commands/cc/ask.toml +2 -2
- package/presets/gemini/commands/cc/db-migration.toml +1 -1
- package/presets/gemini/commands/cc/feature.toml +1 -1
- package/presets/gemini/commands/cc/fix.toml +1 -1
- package/presets/gemini/commands/cc/iterative.toml +1 -1
- package/presets/gemini/commands/cc/odd.toml +2 -2
- package/presets/gemini/commands/cc/openspec.toml +10 -8
- package/presets/gemini/commands/cc/spec-mutation.toml +2 -2
- package/presets/gemini/commands/cc/tdd-cycle.toml +2 -2
- package/presets/muse/AGENTS.md +1 -1
- package/presets/opencode/agents/implementer.md +1 -1
- package/presets/opencode/agents/tester.md +1 -1
- package/presets/opencode/commands/cc-api-contract.md +1 -1
- package/presets/opencode/commands/cc-ask.md +2 -2
- package/presets/opencode/commands/cc-db-migration.md +1 -1
- package/presets/opencode/commands/cc-feature.md +1 -1
- package/presets/opencode/commands/cc-fix.md +1 -1
- package/presets/opencode/commands/cc-iterative.md +1 -1
- package/presets/opencode/commands/cc-odd.md +2 -2
- package/presets/opencode/commands/cc-openspec.md +2 -2
- package/presets/opencode/commands/cc-spec-mutation.md +2 -2
- package/presets/opencode/commands/cc-tdd-cycle.md +2 -2
- package/presets/opencode/prompts/v1.0.0/implementer.md +1 -1
- package/presets/opencode/prompts/v1.0.0/tester.md +1 -1
- package/presets/opencode/skills/backlog/SKILL.md +1 -1
- package/presets/opencode/skills/django-testing/SKILL.md +1 -0
- package/presets/opencode/skills/evaluation/SKILL.md +1 -1
- package/presets/opencode/skills/openspec/SKILL.md +10 -6
- package/presets/opencode/skills/python-django-stack/SKILL.md +1 -0
- package/presets/opencode/skills/python-fastapi-stack/SKILL.md +1 -0
- package/presets/opencode/skills/spring-boot-kotlin/SKILL.md +1 -0
- package/presets/opencode/skills/sqlalchemy/SKILL.md +1 -0
- package/presets/opencode/skills/testing-tdd/SKILL.md +3 -3
- package/presets/pi/AGENTS.md +1 -1
- package/presets/shared/invoke-hook.cjs +43 -24
- package/src/presets/manifests/claude.yml +1 -1
- package/src/presets/shared-skills.yml +30 -0
- package/src/presets/targets/pi.yml +1 -1
package/README.md
CHANGED
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
**Stop prompting. Start orchestrating.**
|
|
4
4
|
|
|
5
|
-
[](https://badge.socket.dev/npm/package/cc-codeconductor/1.7.1)
|
|
6
|
+
[](https://codeconductor.appsutiles.dev/)
|
|
6
7
|
|
|
7
8
|
CodeConductor is an open-source framework for building structured, reproducible
|
|
8
9
|
AI-assisted software engineering workflows.
|
|
@@ -15,12 +16,19 @@ contracts, task cards, and risk-based routing.
|
|
|
15
16
|
>
|
|
16
17
|
> ## Current Scope
|
|
17
18
|
>
|
|
18
|
-
> Published package is **1.
|
|
19
|
+
> Published package is **1.7.1** (current stable line: **1.7.x**). Limitations
|
|
19
20
|
> matrix:
|
|
20
21
|
> [docs/current-status.md](docs/current-status.md). This repository:
|
|
21
22
|
> `bun run dev …` (not `npx`) while iterating.
|
|
22
23
|
>
|
|
23
|
-
>
|
|
24
|
+
> Included in **1.7.0**: runner-captured TDD, persistent RED validation,
|
|
25
|
+
> OpenSpec completion fixes, shared skills, safer hooks and Claude
|
|
26
|
+
> installation, atomic Goal DAG claims, native delta specs, and scorecards
|
|
27
|
+
> that preserve unmeasured signals. See the
|
|
28
|
+
> [post-v1.6.1 guide](docs/post-v1.6.1.md) for the earlier commit range and
|
|
29
|
+
> upgrade steps.
|
|
30
|
+
>
|
|
31
|
+
> Shipped in the 1.7.x stable line:
|
|
24
32
|
>
|
|
25
33
|
> - `npx cc-codeconductor setup --target <target> --yes` — onboarding flow
|
|
26
34
|
> - `npx cc-codeconductor init` — detects project stack, writes
|
|
@@ -188,6 +196,13 @@ Agent phases: validate-backlog → discover → design → **test** → implemen
|
|
|
188
196
|
review. Test-before-implement is required whenever both phases apply.
|
|
189
197
|
`/cc-tdd-cycle` enforces Red → Green → Refactor (`tester` then `implementer`).
|
|
190
198
|
|
|
199
|
+
In the unreleased checkout, `tdd capture` runs and records RED/GREEN suites.
|
|
200
|
+
When `BACKLOG.md` Global requires TDD, closing a test card validates and persists
|
|
201
|
+
RED before implementation changes the candidate; GREEN must still match the
|
|
202
|
+
current candidate. `done` preserves
|
|
203
|
+
agent edits in `tasks.md`, and `archive` gates unchecked boxes. See
|
|
204
|
+
[the delivery and evidence guide](docs/post-v1.6.1.md#entrega-openspec-y-evidencia-tdd).
|
|
205
|
+
|
|
191
206
|
### Receipt-Driven Development
|
|
192
207
|
|
|
193
208
|
RDD binds local verification evidence to the exact code, tests, contracts,
|
|
@@ -325,14 +340,14 @@ Task Card → Risk Classification → Routing Policy → Conductor Agent → Del
|
|
|
325
340
|
|
|
326
341
|
## Supply chain
|
|
327
342
|
|
|
328
|
-
Published **1.
|
|
343
|
+
Published **1.7.1** declares two production dependencies (`package.json`
|
|
329
344
|
`dependencies`; same on
|
|
330
345
|
[npm](https://www.npmjs.com/package/cc-codeconductor)). Neither has further
|
|
331
346
|
npm transitive dependencies.
|
|
332
347
|
|
|
333
348
|
```mermaid
|
|
334
349
|
graph LR
|
|
335
|
-
cc["cc-codeconductor@1.
|
|
350
|
+
cc["cc-codeconductor@1.7.1"]
|
|
336
351
|
zod["zod@^3.23.8"]
|
|
337
352
|
yaml["yaml@^2.4.5"]
|
|
338
353
|
cc --> zod
|
|
@@ -692,7 +707,8 @@ npx cc-codeconductor odd handoff --id delivery-001 --output json
|
|
|
692
707
|
```
|
|
693
708
|
|
|
694
709
|
Subcommands: `validate` / `scan` / `plan` / `analyze` / `status` / `next` /
|
|
695
|
-
`start` / `done` / `block` / `
|
|
710
|
+
`start` / `done` / `block` / `unblock` / `archive`, plus implemented, unreleased
|
|
711
|
+
`sync` / `verify` gates. `analyze` is read-only coverage
|
|
696
712
|
(FR/SC → tasks → tests). Planned changes use capability-scoped delta specs;
|
|
697
713
|
archive synchronizes validated deltas into durable specs before filing the
|
|
698
714
|
change. Illegal status transitions fail closed. See
|
|
@@ -860,7 +876,7 @@ codeconductor/
|
|
|
860
876
|
|
|
861
877
|
## Roadmap
|
|
862
878
|
|
|
863
|
-
Published package: **1.
|
|
879
|
+
Published package: **1.7.x (current stable: 1.7.1)**. Remaining gaps (sandbox, policy compiler, full
|
|
864
880
|
stack-specific asset pruning): [docs/current-status.md](docs/current-status.md).
|
|
865
881
|
Release history: [CHANGELOG.md](CHANGELOG.md).
|
|
866
882
|
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Compile Check — runs a build command via
|
|
2
|
+
* Compile Check — runs a build command via node:child_process, captures output,
|
|
3
3
|
* parses errors, and returns structured results for re-injection.
|
|
4
4
|
*/
|
|
5
5
|
export interface CompileError {
|
|
@@ -48,6 +48,7 @@ export declare function isAllowlistedTestCommand(command: string | string[]): bo
|
|
|
48
48
|
*/
|
|
49
49
|
export declare function parseCompileErrors(stderr: string): CompileError[];
|
|
50
50
|
/**
|
|
51
|
-
* Run a compile check
|
|
51
|
+
* Run a compile check with configurable timeout. Uses `node:child_process`
|
|
52
|
+
* because the published bundle runs under Node (`npx cc-codeconductor`).
|
|
52
53
|
*/
|
|
53
54
|
export declare function runCompileCheck(options?: CompileCheckOptions): Promise<CompileResult>;
|
|
@@ -20,6 +20,7 @@ export interface OrchestratorNextResult {
|
|
|
20
20
|
readyCount: number;
|
|
21
21
|
}
|
|
22
22
|
export declare function getNextTask(projectRoot: string, projectName: string): Promise<Result<OrchestratorNextResult, Error>>;
|
|
23
|
+
export declare function claimNextTask(projectRoot: string, projectName: string): Promise<Result<OrchestratorNextResult, Error>>;
|
|
23
24
|
export declare function startTask(projectRoot: string, taskId: string, agent?: string): Promise<Result<void, Error>>;
|
|
24
25
|
export declare function completeTask(projectRoot: string, taskId: string, evidenceIds?: string[]): Promise<Result<void, Error>>;
|
|
25
26
|
export declare function formatGoalStatus(graph: GoalGraphInput): string;
|
|
@@ -28,6 +28,12 @@ export interface ReceiptVerification {
|
|
|
28
28
|
readonly actualHash: string;
|
|
29
29
|
readonly changedPaths: readonly string[];
|
|
30
30
|
}
|
|
31
|
+
/**
|
|
32
|
+
* True only when this receipt was minted by captureReceipt in this project:
|
|
33
|
+
* the nonce is well-formed, a registry entry exists for it, and the entry
|
|
34
|
+
* binds the nonce to this exact manifest. Anything else fails closed.
|
|
35
|
+
*/
|
|
36
|
+
export declare function isRegisteredReceipt(projectRoot: string, receipt: RddReceipt): Promise<boolean>;
|
|
31
37
|
export declare function isRddReceipt(value: unknown): value is RddReceipt;
|
|
32
38
|
export declare function captureReceipt(projectRoot: string, input: {
|
|
33
39
|
readonly taskId: string;
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { GoalGraphInput } from '../../validation/schemas';
|
|
2
|
+
import { type TddValidationRecordInput } from '../../validation/schemas';
|
|
2
3
|
import type { TddSuiteEvidence } from '../../domain/loop/loop-state';
|
|
3
4
|
import { type Result } from '../../utils/result';
|
|
4
5
|
import { type RddReceipt } from './rdd-receipt';
|
|
@@ -74,13 +75,21 @@ export declare function captureTddSuiteEvidence(projectRoot: string, taskId: str
|
|
|
74
75
|
}, Error>>;
|
|
75
76
|
/**
|
|
76
77
|
* Load TDD suite evidence written by `captureTddSuiteEvidence`. Hand-edited
|
|
77
|
-
* files (wrong source/type/`capturedBy`) are rejected
|
|
78
|
+
* files (wrong source/type/`capturedBy`) are rejected, and so is a receipt
|
|
79
|
+
* that no longer matches the current project.
|
|
78
80
|
*/
|
|
79
81
|
export declare function loadTddSuiteEvidence(projectRoot: string, taskId: string, evidenceId: string): Promise<Result<TddSuiteEvidence & {
|
|
80
82
|
receipt: RddReceipt;
|
|
81
83
|
}, Error>>;
|
|
84
|
+
/**
|
|
85
|
+
* Validate the RED evidence of a task against the current project and persist
|
|
86
|
+
* a record so later project changes do not invalidate it. With several fresh
|
|
87
|
+
* REDs the latest `receipt.capturedAt` wins (tie: greater evidence id).
|
|
88
|
+
*/
|
|
89
|
+
export declare function recordRedValidation(projectRoot: string, taskId: string): Promise<Result<TddValidationRecordInput, Error>>;
|
|
82
90
|
/**
|
|
83
91
|
* True when the verification runner stored TDD evidence for this task.
|
|
84
|
-
* Handmade JSON (wrong source/type/capturedBy) does not count.
|
|
92
|
+
* Handmade JSON (wrong source/type/capturedBy) does not count. RED is also
|
|
93
|
+
* accepted from a matching validation record written by `recordRedValidation`.
|
|
85
94
|
*/
|
|
86
95
|
export declare function hasTddRunnerEvidence(projectRoot: string, taskId: string, expectedPhase?: 'red' | 'green'): Promise<boolean>;
|