@crewbie/cli 0.1.0-alpha.49 → 0.1.0-alpha.50

package/dist/setup/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/setup/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAA0B,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,CAAC,MAAM,OAAO,GAAG;;;;;;;kEAO2C,CAAC;AAEnE,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;CAU1B,CAAC;AAEF,0GAA0G;AAC1G,MAAM,CAAC,MAAM,aAAa,GAAG,uGAAuG,CAAC;AACrI,MAAM,CAAC,MAAM,WAAW,GAAG,8BAA8B,CAAC;AAE1D,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC;AAC7D,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC3C,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;AAE5D,MAAM,UAAU,YAAY,CAAC,IAAU;IACrC,oHAAoH;IACpH,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAU,EAAE,MAAc;IAChD,0EAA0E;IAC1E,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;IACvF,MAAM,MAAM,GAA2B;QACrC,WAAW,EAAE,ihCAAihC;QAC9hC,QAAQ,EAAE;;;;;;;qTAOuS;QACjT,OAAO,EAAE;;;;;;;sTAOyS;QAClT,SAAS,EAAE;;;;;;;4LAO6K;QACxL,MAAM,EAAE;;;;;;;6RAOiR;QACzR,QAAQ,EAAE;;;;;;;4YAO8X;QACxY,QAAQ,EAAE;;;;;;;0QAO4P;KACvQ,CAAC;IACF,OAAO;gBACO,IAAI,CAAC,EAAE;eACR,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;;EAEzC,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;IAExD,IAAI,CAAC,EAAE;;EAET,IAAI,CAAC,OAAO;;EAEZ,IAAI,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS;;EAEhJ,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,yBAAyB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,kCAAkC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;;EAEhP,aAAa;;EAEb,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,sEAAsE,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,4HAA4H,CAAC,CAAC,CAAC,EAAE;;EAE5P,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,YAAY,MAAM,CAAC,CAAC,CAAC,EAAE;kBACzC,IAAI,CAAC,EAAE,kCAAkC,IAAI,CAAC,EAAE;;EAEhE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,4BAA4B,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;iCACzE,IAAI,CAAC,EAAE;;EAEtC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,wMAAwM,CAAC,CAAC,CAAC,EAAE,GAAG,WAAW;CAC/O,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuCjC,OAAO;CACR,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgGnB,OAAO;CACR,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,cAAc,GAAG,KAAK,EAAE,eAAe,GAAG,KAAK,EAAE,cAAc,GAAG,KAAK;IAC/F,MAAM,KAAK,GAAG;;;;;;;;;2DAS2C,WAAW;;;CAGrE,CAAC;IACA,OAAO;QACL,oCAAoC,EAAE,gBAAgB,CAAC,KAAK,EAAE,eAAe,CAAC;QAC9E,4CAA4C,EAAE,iBAAiB,CAAC,KAAK,EAAE,eAAe,IAAI,cAAc,CAAC;QACzG,wCAAwC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiC5C,KAAK;;;;;;;CAON;QACG,sCAAsC,EAAE,cAAc,CAAC,KAAK,CAAC;QAC7D,mCAAmC,EAAE;;;;;;;;;;;;;;;EAevC,KAAK;;;;;;CAMN;QACG,wCAAwC,EAAE;;;EAG5C,cAAc,CAAC,CAAC,CAAC,yCAAyC,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;;;;EAkB/D,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyDL,KAAK;;;;;;;;;;CAUN;QACG,sCAAsC,EAAE;;;;;;;;;;;;;;;;;EAiB1C,KAAK;;;;;;;;;;;;;;EAcL,KAAK;;;;;;;;;;;;;;;;;;;;;EAqBL,KAAK;;;;;;;;;;;;;;;CAeN;KACE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/setup/templates.ts"],"names":[],"mappings":"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"}

package/docs/operations.md

@@ -99,7 +99,7 @@ requires approved network/proxy/CA configuration, not `strict-ssl=false`.
 Review the package contents with `npm pack --dry-run`, then bootstrap with
 `npm publish --access public --tag next`. Complete any 2FA challenge directly
 with npm. Verify the published version using
-`npm view @crewbie/cli@0.1.0-alpha.49 version --registry=https://registry.npmjs.org`.
+`npm view @crewbie/cli@0.1.0-alpha.50 version --registry=https://registry.npmjs.org`.
 
 After the package exists, open its npm **Settings > Trusted publishing**, choose
 GitHub Actions, and configure:
@@ -207,6 +207,14 @@ additions) must fit GitHub's documented 30,000-character custom agent maximum. I
 it does not, init stops before adoption and asks the user to shorten the original;
 it never truncates instructions. Available from alpha.12; earlier releases stopped at 400 words.
 
+Generated (non-adopted) charters ship no generic domain advice such as "test
+edge cases" or "consider accessibility"; capable models already know it and it
+adds context to every launch. Only Crewbie workflow invariants remain (tester,
+reviewer, coordinator, improver). Put the repository's own observable checks and
+non-negotiables in each role's `checks` and `nonNegotiables`; the setup review
+flags roles that have none. Shared rules such as PR headings live once in
+`.crewbie/instructions.md`, which every launch embeds, rather than in each charter.
+
 Archival requires the exact inspected source hash, rejects conflicting archives
 or edited originals, and is idempotent. Archives are written before originals
 are removed. Installation previews name both actions. Adding these adoptions is
@@ -601,13 +609,30 @@ observations, not a universal instruction ban or proof that a particular number
 of words is harmful.
 
 Crewbie's documentation/profile overlap, generic-advice (including generic
-agent charters), unverified-link, npm-script/package-manifest, broad-root-scope
-and unconditional full-suite signals are **engineering heuristics**,
+agent charters), unverified-link, npm-script/package-manifest and
+unconditional full-suite signals are **engineering heuristics**,
 not validated causal rules from the paper. They identify concrete material for
 human review. Necessary standalone context and explicit merge/compliance gates
 should be retained. Contradictions, domain relevance and actual benefit still
 need semantic review and representative before/after task evidence.
-The 600-word root-guidance review threshold is advisory, not a gate. Scoped
+
+The assessment also checks the six smells catalogued in
+[*Configuration Smells in AGENTS.md Files*](https://arxiv.org/abs/2606.15828)
+(see the README table). Static signals: `lint-leakage` (style rules a
+linter/formatter enforces; a warning when one is configured, advisory
+otherwise), `context-bloat`, `blind-reference` (a document path whose line
+does not say what it holds or when to read it), and `init-fossilization` (a file
+with exactly one commit while at least ten later commits landed; skipped when
+history is unavailable, such as shallow clones). Skill leakage and conflicting
+instructions need judgment and are checked by the model rubric only.
+
+Always-loaded guidance is limited to 200 lines (`limits.guidanceLines`), after
+Anthropic's recommendation for always-loaded instruction files, which the
+smells study also uses. Longer existing files get a `context-bloat` warning.
+Proposed guidance replacements over the limit are rejected, and nothing is
+truncated. Custom-agent charters are not counted: GitHub's prompt character
+limit applies to them. Gloaguen et al. establish no harmful length, so the limit
+is a starting point to validate with `crewbie eval`. Scoped
 Copilot instructions need valid YAML `applyTo` globs. When relocating domain
 guidance, review the source reduction and destination together; preserve policy
 coverage and host-specific instruction support. Every finding must explicitly
@@ -672,11 +697,21 @@ An LLM's suitability rationale is a proposal, not a benchmark certification.
   "modelProfile": "balanced",
   "execution": {
     "maxLaunchesPerBatch": 20,
-    "maxAttemptsPerTask": 3
+    "maxAttemptsPerTask": 3,
+    "maxTokensPerFeature": 2000000
   }
 }
 ```
 
+`maxTokensPerFeature` is optional and has no default, because no evidence-backed
+value exists. When set, each launch first sums the **Observed tokens** Crewbie
+recorded in the attribution block of every task PR into the plan's feature branch.
+At or above the ceiling, further implementation and review launches stop with a
+visible reason; running sessions are unchanged. PRs without measured usage are
+counted separately, so the total is a lower bound and never zero-filled. Review-
+report PRs and unreported subagent/tool usage are not included. Raise the ceiling
+in a reviewed config change to continue. `preflight` shows the spent total.
+
 These configuration fields are optional for legacy configurations so parsing does
 not change approved plan hashes. Absent limits use 20/3. Changing the profile alone
 does not reassign models. Each Crewbie-initiated implementation/review launch
@@ -690,7 +725,8 @@ publishes a new issue for it; that issue gets its own initial launch, which stil
 counts toward the shared task and batch allowances. An earlier issue that is still
 open must be reconciled (closed) first.
 The budget covers Crewbie requests, not the number of internal backend sessions,
-tokens, monetary spend, manual PR follow-ups, onboarding, planning or nightly work.
+monetary spend, manual PR follow-ups, onboarding, planning or nightly work; only
+`maxTokensPerFeature` looks at tokens.
 
 **Upgrading an in-flight batch:** pre-alpha.10 launch claims have no trustworthy
 complete attempt ledger. Further automatic launches in that batch stop visibly,
@@ -1031,6 +1067,15 @@ Operational cursors live on the orphan `crewbie/runtime` branch, separately from
 human-facing memory. It records the latest reviewed fingerprint/outcome per work
 item, so no-change analysis can advance without opening a pointless PR.
 
+Every proposed change states a `hypothesis` (the recurring failure it should
+prevent) and an `expectedOutcome` (the observable signal in later runs), each at
+most 60 words. The improvement PR adds them to `.crewbie/rationale.md`, a bounded
+ledger of the last 100 entries that lands only when a human merges the PR. It is
+loaded into the improver's context, never into implementation launches, so
+later analysis can check whether a rule delivered its expected outcome and
+propose narrowing or removing rules that did not. The ledger itself cannot be
+proposed as a change.
+
 The reserved proposal branch is `crewbie/improvements`. Concurrent file changes,
 a branch behind its base, or a leftover closed proposal branch stop updates for
 human reconciliation rather than force-pushing over work. Merge, close and
@@ -1054,6 +1099,21 @@ heading would block auto-merge after the session ended, with nobody left to fix
 it. There is no default word limit because none is evidence-backed. Human review
 still evaluates rationale and evidence.
 
+The same check reports the word count of every memory file the PR adds or
+changes, read at its head: `.crewbie/instructions.md`, hot files against
+`limits.hot`, and cold/archive topics against `limits.topic`. It never fails on
+memory. Instead, before every launch on a `crewbie/<feature>` branch, Crewbie
+checks the shared and role hot files. When one is over `limits.hot`, Crewbie
+moves its oldest list entries (the top of the file; agents add new entries at the
+end) into a new `cold/earlier-<date>.md` topic until the hot file is at 80% of
+its budget. It links that topic from the matching `index.md`, rebases relative
+links, and commits everything as one commit on the feature branch. Headings and
+prose stay in place. If the branch moved or the commit fails, the launch
+continues with memory as-is, and demotion is retried at the next launch. Agent
+PR branches and the default branch are never rewritten. Hot memory merged over
+budget after a feature's last launch is still loaded, and it is demoted at the
+next launch. Launch prompts show each embedded file's `words/limit`.
+
 Copilot's final session summary replaces the specialist's own PR description.
 During attribution Crewbie restores the specialist's last description (its own
 Copilot edit containing `Specialist: crewbie-<role>`) as the PR body and saves
@@ -1078,8 +1138,11 @@ PR metadata, not code, approvals or merge state, and avoids another paid
 implementation run merely to repair prose.
 
 Cloud hosts inject the active charter and may protect its file path from agent
-tools. Record injection separately from file-read attestations; respect those
-restrictions. Native Copilot Memory is a separate platform feature, not Crewbie's
+tools; respect those restrictions. Agents no longer attest which memory they
+read. Each launch ledger ref points at an annotated tag (which fires no
+workflows) recording the embedded files and their hashes, plus anything too large
+to embed or absent. Reports show that as "memory: embedded"; older launches show
+"unreported". Native Copilot Memory is a separate platform feature, not Crewbie's
 reviewed role history or approval of proposed shared decisions.
 
 ## Reports and privacy
@@ -1108,7 +1171,29 @@ bundled SDK runtime against a loopback-only synthetic provider without paid mode
 calls.
 
 Before broader release, run a consenting personal/organization account matrix:
-select the actual profile/model, inspect memory-read attestations and issue/PR
+select the actual profile/model, inspect the recorded launch contexts and issue/PR
 linkage, exercise maintenance authentication, and confirm private publishing.
 No live test is implied by a fixture passing. Registry publishing, trademark
 clearance, and paid cloud runs require the project owner's separate decision.
+
+### Guidance evaluation
+
+Guidance and memory cost context on every launch; research on repository
+context files found they often raise cost without improving task success. Check
+this for your own repository rather than assuming it:
+
+1. Create two sandbox repositories from the same commit. In both, install the
+   **latest published** Crewbie release, never a local build:
+   `gh release view --repo mvanderbend-msoft/crewbie --json assets` and
+   `npm install --global --ignore-scripts <tgz asset URL>`.
+2. Keep guidance and memory in the guided sandbox. In the bare sandbox, reduce
+   `AGENTS.md`, scoped instructions, charters' repository sections and
+   `.crewbie` hot/index files to their Crewbie defaults.
+3. Approve and run the same plan in both. Wait for attribution on each task PR.
+4. Run `crewbie eval --guided owner/guided --bare owner/bare [--feature crewbie/x] [--json]`.
+
+The comparison reports merged tasks, measured coverage and observed tokens per
+merged task per arm. Token cost is compared only when every task in both arms
+has measured usage. It warns on unequal task counts and fewer than five tasks per
+arm; one run does not prove a cause. When guidance costs more without merging
+more tasks, review what it adds.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewbie/cli",
-  "version": "0.1.0-alpha.49",
+  "version": "0.1.0-alpha.50",
   "description": "A repository-aware AI implementation crew for existing and greenfield projects.",
   "license": "MIT",
   "repository": {