@yeison.restrepo.r/code-conductor 1.52.2 → 1.52.4
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 +1 -3
- package/package.json +1 -1
- package/scripts/orchestrate.mjs +58 -1
package/README.md
CHANGED
|
@@ -483,7 +483,7 @@ The backup and temp rules keep the installer's own backups and crash-stranded te
|
|
|
483
483
|
| `systemMessage` | `default` | yes, for example Guard 2's overwrite prompt | no: the warning is lost |
|
|
484
484
|
- Agent definitions provided by plugins are not searched.
|
|
485
485
|
- `resume` (`[FEAT-055]`) needs approvals that recorded their commit: a run approved before it is refused `ORCH_RESUME_UNANCHORED` and still needs `end`, then `start`, and a Build task entry without a stored SNAP is redone.
|
|
486
|
-
- Unattended mode (`[FEAT-054]`) binds the agents, not the orchestrator session: the run file is inside the orchestrator's write surface, so a hand edit could set `unattended` just as it could forge an approval, and Guard 6 does not stop it. Its deterministic plan check covers only the orchestrator write surface, any `Files` entry outside printable ASCII (`[BUG-086]`) and the control-plane files, including those that run code outside the run (`[BUG-080]`, `[BUG-081]`); every other judgement is the delegated reviewer's.
|
|
486
|
+
- Unattended mode (`[FEAT-054]`) binds the agents, not the orchestrator session: the run file is inside the orchestrator's write surface, so a hand edit could set `unattended` just as it could forge an approval, and Guard 6 does not stop it. Its deterministic plan check covers only the orchestrator write surface, any `Files` entry outside printable ASCII (`[BUG-086]`) and the control-plane files, including those that run code outside the run (git hooks and config-read hook runners, editor and container auto-run files, package-manager and build-system files, CI pipelines) and any `CLAUDE.md`, `CLAUDE.local.md` or package-manager or build-system manifest at any depth (`[BUG-080]`, `[BUG-081]`, `[BUG-082]`, `[BUG-085]`); every other judgement is the delegated reviewer's.
|
|
487
487
|
|
|
488
488
|
The five role agent definitions it dispatches ship from `1.37.0`; their limits are the next item.
|
|
489
489
|
- **The role agents (`1.37.0`) are bounded by their tool masks, and Guard 7 bounds one thing beneath them: the shell.**
|
|
@@ -505,9 +505,7 @@ The backup and temp rules keep the installer's own backups and crash-stranded te
|
|
|
505
505
|
- **`[BUG-077]`, open:** `scripts/orchestrate.mjs` lets `approve spec <path> <sha256>` accept any file path relative to the run root, without checking that it is the spec the `spec` role handed back or that it sits under the run's `docs.specs` folder, so approving the wrong path makes the post-approval hash check in `install` protect that file while later edits to the real spec go undetected. Until it is fixed, confirm that the path you approve is the spec the `spec` role handed back, under the run's recorded specs folder.
|
|
506
506
|
- **`[BUG-078]`, open:** `scripts/orchestrate.mjs` builds a fix round's write scope with the approved plan included, so Guard 5 lets the fix-round `code` agent write to the plan and only the brief's instruction stops it; any change other than checkbox ticks still halts the run with `ORCH_APPROVED_DOC_CHANGED` on the next `install audit` or fix round, and ticks do not affect `tasks.done`. Until it is fixed, check after a fix round that the approved plan's checkboxes are unchanged.
|
|
507
507
|
- **`[BUG-079]`, open:** `scripts/orchestrate.mjs` stores every non-security hand-back's full SNAP in `.claude/memory/orchestrator-run.json` with a 64 KiB cap per SNAP but no cap on the total, so a plan of roughly 80 or more tasks with maximally sized hand-backs can push the run file past the hook's 10 MiB read cap, after which `readRunFile` returns null and Guard 6 downgrades from deny to warn for the rest of the run. Until it is fixed, keep orchestrated plans well under 80 tasks, or split a larger item into several runs.
|
|
508
|
-
- **`[BUG-082]`, open:** the unattended plan check escalates only the root, `.claude/` and `project-template/` `CLAUDE.md` files, so in an `--unattended` run a delegated plan can write a nested `CLAUDE.md` (such as `src/CLAUDE.md`) whose content can reach later reviewers in the same run; hooks and guards are unaffected. Until it is fixed, check an `--unattended` run's diff for new or changed `CLAUDE.md` or `CLAUDE.local.md` files in subdirectories.
|
|
509
508
|
- **`[BUG-083]`, open:** the `publish` job in `.github/workflows/publish.yml` avoids an npm cache only by omitting `cache:` from `actions/setup-node`, which v5+ overrides when `package.json` declares a `packageManager` (or `devEngines.packageManager`) field; no such field exists today, so there is no current impact, but adding one would let the job holding `id-token: write` restore a cache the `verify` job populated. Until it is fixed, do not add a `packageManager` or `devEngines.packageManager` field to `package.json`, or set `package-manager-cache: false` on the `publish` job's `setup-node` step in a fork.
|
|
510
|
-
- **`[BUG-085]`, open:** the unattended plan check's `CONTROL_PLANE` list in `scripts/orchestrate.mjs` does not yet cover config-read hook runners, editor and container auto-run configuration, other package managers' files or other CI systems, so in an `--unattended` run a plan approved only by the delegated review can write files that run code outside the run. Until it is fixed, check an `--unattended` run's diff for changes to such files before committing, opening the project in an editor or container, installing dependencies or pushing.
|
|
511
509
|
- **The `P7` false positive** described under [Guard 3, and what it learned](#guard-3-and-what-it-learned) is still live.
|
|
512
510
|
- **A re-run against an untouched `project.md` prints a recovery hint it cannot prove is needed.** If you install, never write anything into `.claude/memory/project.md`, and install again, you get a line suggesting the file may have been overwritten by a pre-`1.30.0` re-run. It was not; it equals the stub because it was seeded and never edited. The check compares content and **cannot distinguish "seeded and untouched" from "clobbered"**, which is why the wording is hedged to "may have been" rather than "was". This residual is named and accepted in [`BUG-039`'s spec at `:129`](docs/superpowers/specs/2026-09-27-bug039-installer-host-owned-state-design.md), where the alternative (restoring from the host's own git history) was rejected as writing host files out of the host's history with new failure modes. A **fresh** install is silent, which the Quickstart shows.
|
|
513
511
|
- **Three open dossiers**, which are the evidence-collection pipeline working rather than a backlog: a session denial tally, one for interleaved-artifact reports, and an intermittent commit-hook hang in the `snap-build` suite. A dossier holds specimens until a mechanism is characterized by probe; an id is minted only when the written condition is met. `[BUG-047]` is what that pipeline produces when it completes: an out-of-scope note, then a dossier, then four specimens across four sessions, then a mint, then a release.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@yeison.restrepo.r/code-conductor",
|
|
3
|
-
"version": "1.52.
|
|
3
|
+
"version": "1.52.4",
|
|
4
4
|
"description": "A governance layer for Claude Code sessions: hooks that check an agent's commands before they run, a spec-first workflow, and project memory the next session reads.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"agentic-development",
|
package/scripts/orchestrate.mjs
CHANGED
|
@@ -23,6 +23,8 @@ export const WRITE_SURFACE = [RUN_FILE, ENVELOPE_FILE, '.claude/memory/session-s
|
|
|
23
23
|
// Owner decision (BUG-080): the files that enforce the guards or steer later dispatches, in both mirrors. Same notation
|
|
24
24
|
// as WRITE_SURFACE; a trailing `/**` protects the whole directory, so a file added to it is covered too.
|
|
25
25
|
// Owner decision (BUG-081): also the files that run code outside the run, after it ends.
|
|
26
|
+
// Owner decision (BUG-082): a CLAUDE.md or an npm manifest also reaches it at any depth, by its last segment (CONTROL_PLANE_NAMES).
|
|
27
|
+
// Owner decision (BUG-085): also the config-read hook runners, editor and container auto-run files, other package managers, build systems and CI systems.
|
|
26
28
|
export const CONTROL_PLANE = [
|
|
27
29
|
'.claude/hooks/**', 'project-template/.claude/hooks/**',
|
|
28
30
|
'.opencode/plugin/**', 'project-template/.opencode/plugin/**',
|
|
@@ -41,6 +43,54 @@ export const CONTROL_PLANE = [
|
|
|
41
43
|
'.claude/flow-status.mjs', 'project-template/.claude/flow-status.mjs',
|
|
42
44
|
'.github/workflows/**', '.github/actions/**',
|
|
43
45
|
'package.json', 'package-lock.json', 'npm-shrinkwrap.json', '.npmrc',
|
|
46
|
+
// BUG-085: config-read git hook runners.
|
|
47
|
+
'.pre-commit-config.yaml',
|
|
48
|
+
'lefthook.yml', 'lefthook.yaml', 'lefthook.json', 'lefthook.toml', '.lefthook.yml', '.lefthook.yaml', '.lefthook.json', '.lefthook.toml',
|
|
49
|
+
'lefthook-local.yml', 'lefthook-local.yaml', 'lefthook-local.json', 'lefthook-local.toml',
|
|
50
|
+
'.lefthook-local.yml', '.lefthook-local.yaml', '.lefthook-local.json', '.lefthook-local.toml',
|
|
51
|
+
'.lefthook/**', '.lefthook-local/**', '.overcommit.yml',
|
|
52
|
+
'.simple-git-hooks.json', '.simple-git-hooks.js', '.simple-git-hooks.cjs', '.simple-git-hooks.mjs',
|
|
53
|
+
'simple-git-hooks.json', 'simple-git-hooks.js', 'simple-git-hooks.cjs', 'simple-git-hooks.mjs',
|
|
54
|
+
'.huskyrc', '.huskyrc.json', '.huskyrc.yaml', '.huskyrc.yml', '.huskyrc.js', '.huskyrc.cjs', 'husky.config.js', 'husky.config.cjs',
|
|
55
|
+
'.lintstagedrc', '.lintstagedrc.json', '.lintstagedrc.yaml', '.lintstagedrc.yml', '.lintstagedrc.js', '.lintstagedrc.cjs', '.lintstagedrc.mjs',
|
|
56
|
+
'lint-staged.config.js', 'lint-staged.config.cjs', 'lint-staged.config.mjs',
|
|
57
|
+
// BUG-085: editor and container auto-run configuration.
|
|
58
|
+
'.vscode/**', '.idea/**', '.zed/**', '.devcontainer/**', '.devcontainer.json', '.gitpod.yml',
|
|
59
|
+
// BUG-085: other package managers' and build systems' manifests, lockfiles, config and build files.
|
|
60
|
+
'.yarnrc', '.yarnrc.yml', 'yarn.lock', '.yarn/**', '.pnp.cjs', '.pnp.loader.mjs',
|
|
61
|
+
'pnpm-workspace.yaml', 'pnpm-lock.yaml', '.pnpmfile.cjs',
|
|
62
|
+
'bunfig.toml', 'bun.lock', 'bun.lockb',
|
|
63
|
+
'deno.json', 'deno.jsonc', 'deno.lock',
|
|
64
|
+
'pyproject.toml', 'setup.py', 'setup.cfg', 'requirements.txt', 'pipfile', 'pipfile.lock',
|
|
65
|
+
'poetry.lock', 'poetry.toml', 'uv.lock', 'uv.toml', 'pdm.lock',
|
|
66
|
+
'gemfile', 'gemfile.lock', 'gems.rb', 'gems.locked', '.bundle/**',
|
|
67
|
+
'composer.json', 'composer.lock',
|
|
68
|
+
'cargo.toml', 'cargo.lock', '.cargo/**', 'rust-toolchain', 'rust-toolchain.toml', 'build.rs',
|
|
69
|
+
'go.mod', 'go.work',
|
|
70
|
+
'.mvn/**', 'mvnw', 'mvnw.cmd', 'pom.xml', 'gradle/**', 'gradlew', 'gradlew.bat', 'gradle.properties',
|
|
71
|
+
'build.gradle', 'build.gradle.kts', 'settings.gradle', 'settings.gradle.kts',
|
|
72
|
+
'nuget.config', 'packages.lock.json', 'global.json', 'directory.build.props', 'directory.build.targets', 'directory.packages.props',
|
|
73
|
+
// BUG-085: other CI systems' pipeline files.
|
|
74
|
+
'.gitlab-ci.yml', '.circleci/**', 'azure-pipelines.yml', 'azure-pipelines.yaml', '.travis.yml', 'jenkinsfile',
|
|
75
|
+
'bitbucket-pipelines.yml', '.buildkite/**', '.drone.yml', '.woodpecker.yml', '.woodpecker.yaml', '.woodpecker/**',
|
|
76
|
+
'appveyor.yml', '.appveyor.yml', '.gitea/workflows/**', '.forgejo/workflows/**', '.cirrus.yml', '.cirrus.star', '.semaphore/**',
|
|
77
|
+
];
|
|
78
|
+
// Owner decision (BUG-085): the other package managers' and build systems' fixed files also reach it at any depth, like npm's.
|
|
79
|
+
export const CONTROL_PLANE_NAMES = [
|
|
80
|
+
'claude.md', 'claude.local.md', 'package.json', 'package-lock.json', 'npm-shrinkwrap.json', '.npmrc',
|
|
81
|
+
'.yarnrc', '.yarnrc.yml', 'yarn.lock', '.pnp.cjs', '.pnp.loader.mjs',
|
|
82
|
+
'pnpm-workspace.yaml', 'pnpm-lock.yaml', '.pnpmfile.cjs',
|
|
83
|
+
'bunfig.toml', 'bun.lock', 'bun.lockb',
|
|
84
|
+
'deno.json', 'deno.jsonc', 'deno.lock',
|
|
85
|
+
'pyproject.toml', 'setup.py', 'setup.cfg', 'requirements.txt', 'pipfile', 'pipfile.lock',
|
|
86
|
+
'poetry.lock', 'poetry.toml', 'uv.lock', 'uv.toml', 'pdm.lock',
|
|
87
|
+
'gemfile', 'gemfile.lock', 'gems.rb', 'gems.locked',
|
|
88
|
+
'composer.json', 'composer.lock',
|
|
89
|
+
'cargo.toml', 'cargo.lock', 'rust-toolchain', 'rust-toolchain.toml', 'build.rs',
|
|
90
|
+
'go.mod', 'go.work',
|
|
91
|
+
'mvnw', 'mvnw.cmd', 'pom.xml', 'gradlew', 'gradlew.bat', 'gradle.properties',
|
|
92
|
+
'build.gradle', 'build.gradle.kts', 'settings.gradle', 'settings.gradle.kts',
|
|
93
|
+
'nuget.config', 'packages.lock.json', 'global.json', 'directory.build.props', 'directory.build.targets', 'directory.packages.props',
|
|
44
94
|
];
|
|
45
95
|
// Where /cc-orchestrate writes each agent's final message for `handback` to read: inside
|
|
46
96
|
// the surface, and cleared with the run so file names never collide across runs.
|
|
@@ -1084,8 +1134,15 @@ function inSurface(entry) {
|
|
|
1084
1134
|
const glob = taskGlob(entry);
|
|
1085
1135
|
return nonAscii(entry) || ntfsAlias(glob) || reachesList(glob, WRITE_SURFACE);
|
|
1086
1136
|
}
|
|
1137
|
+
// A path the glob matches ends in a segment its last segment matches, except that a `**` there can span a `/`;
|
|
1138
|
+
// then only the text after the last `**` has to match the end of the file name (BUG-082).
|
|
1139
|
+
function namesControlFile(glob) {
|
|
1140
|
+
const last = glob.slice(glob.lastIndexOf('/') + 1);
|
|
1141
|
+
const tail = last.includes('**') ? `**${last.slice(last.lastIndexOf('**') + 2)}` : last;
|
|
1142
|
+
return CONTROL_PLANE_NAMES.some((name) => globToRegExp(tail).test(name));
|
|
1143
|
+
}
|
|
1087
1144
|
// No alias or non-ASCII test: surfaceTask runs inSurface first, and it escalates every alias and every non-ASCII entry.
|
|
1088
|
-
const inControlPlane = (entry) => reachesList(taskGlob(entry), CONTROL_PLANE);
|
|
1145
|
+
const inControlPlane = (entry) => reachesList(taskGlob(entry), CONTROL_PLANE) || namesControlFile(taskGlob(entry));
|
|
1089
1146
|
|
|
1090
1147
|
// Owner decisions (FEAT-054, BUG-080): a plan whose task would write the run's own record, or the files that enforce
|
|
1091
1148
|
// the guards and steer later dispatches, never passes on a delegated verdict. The write surface keeps its reason first.
|