@yeison.restrepo.r/code-conductor 1.52.3 → 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 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 and any `CLAUDE.md`, `CLAUDE.local.md` or npm manifest at any depth (`[BUG-080]`, `[BUG-081]`, `[BUG-082]`); 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.**
@@ -506,7 +506,6 @@ The backup and temp rules keep the installer's own backups and crash-stranded te
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
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.
509
- - **`[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.
510
509
  - **The `P7` false positive** described under [Guard 3, and what it learned](#guard-3-and-what-it-learned) is still live.
511
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.
512
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",
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",
@@ -24,6 +24,7 @@ export const WRITE_SURFACE = [RUN_FILE, ENVELOPE_FILE, '.claude/memory/session-s
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
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.
27
28
  export const CONTROL_PLANE = [
28
29
  '.claude/hooks/**', 'project-template/.claude/hooks/**',
29
30
  '.opencode/plugin/**', 'project-template/.opencode/plugin/**',
@@ -42,8 +43,55 @@ export const CONTROL_PLANE = [
42
43
  '.claude/flow-status.mjs', 'project-template/.claude/flow-status.mjs',
43
44
  '.github/workflows/**', '.github/actions/**',
44
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',
45
94
  ];
46
- export const CONTROL_PLANE_NAMES = ['claude.md', 'claude.local.md', 'package.json', 'package-lock.json', 'npm-shrinkwrap.json', '.npmrc'];
47
95
  // Where /cc-orchestrate writes each agent's final message for `handback` to read: inside
48
96
  // the surface, and cleared with the run so file names never collide across runs.
49
97
  export const HANDBACK_DIR = '.conductor/handback';