@wrongstack/core 0.307.0 → 0.308.0

package/dist/tools/index.js

@@ -3263,6 +3263,7 @@ var RUNTIME_CAPABILITY_MANIFEST = [
       "codebase-skeleton",
       "codebase-repo-map",
       "codebase-impact-analysis",
+      "codebase-invariant-check",
       "dead-code-scan",
       "diff",
       "json",
@@ -4292,13 +4293,50 @@ var HEAVY_BUDGET = {
   maxIterations: 8e3,
   maxToolCalls: 2e4
 };
+var INDEX_READ = [
+  "codebase-stats",
+  "codebase-search",
+  "codebase-skeleton",
+  "codebase-repo-map",
+  "codebase-incoming-calls",
+  "codebase-outgoing-calls"
+];
 var TOOLS = {
+  /** Index-backed code discovery. Spread onto code-facing presets, not browser. */
+  index: INDEX_READ,
   /** Pure read/inspect — safe for analysis and review agents. */
   read: ["read", "grep", "glob", "search", "tree", "mailbox"],
   /** Read + structured inspection (logs, diffs, json, dependency audit). */
-  inspect: ["read", "grep", "glob", "search", "tree", "json", "diff", "logs", "audit", "mailbox"],
+  inspect: [
+    "read",
+    "grep",
+    "glob",
+    "search",
+    "tree",
+    ...INDEX_READ,
+    "json",
+    "diff",
+    "logs",
+    "audit",
+    "mailbox"
+  ],
   /** Read + edit (no shell). For agents that write code/docs but don't run it. */
-  write: ["read", "grep", "glob", "search", "tree", "write", "edit", "replace", "patch", "mailbox"],
+  write: [
+    "read",
+    "grep",
+    "glob",
+    "search",
+    "tree",
+    ...INDEX_READ,
+    "codebase-impact-analysis",
+    "codebase-ast-replace",
+    "codebase-invariant-check",
+    "write",
+    "edit",
+    "replace",
+    "patch",
+    "mailbox"
+  ],
   /** Full build loop: edit + run (lint/format/typecheck/test/bash). */
   build: [
     "read",
@@ -4306,6 +4344,11 @@ var TOOLS = {
     "glob",
     "search",
     "tree",
+    ...INDEX_READ,
+    "codebase-impact-analysis",
+    "codebase-ast-replace",
+    "codebase-invariant-check",
+    "codebase-targeted-test",
     "diff",
     "write",
     "edit",
@@ -4332,7 +4375,18 @@ var TOOLS = {
   /** Dependency management + CVE audit. */
   deps: ["read", "grep", "glob", "install", "outdated", "audit", "json", "mailbox"],
   /** Documentation authoring. */
-  docs: ["read", "grep", "glob", "search", "tree", "write", "edit", "document", "mailbox"],
+  docs: [
+    "read",
+    "grep",
+    "glob",
+    "search",
+    "tree",
+    ...INDEX_READ,
+    "write",
+    "edit",
+    "document",
+    "mailbox"
+  ],
   /** Web research. */
   research: ["read", "grep", "glob", "search", "fetch", "mailbox"]
 };
@@ -4349,7 +4403,7 @@ var DISCOVERY_AGENTS = [
       id: "explore",
       name: "Explore",
       role: "explore",
-      tools: [...TOOLS.read],
+      tools: [...TOOLS.read, ...TOOLS.index],
       prompt: agentPrompt("explore")
     },
     budget: MEDIUM_BUDGET,
@@ -4377,7 +4431,7 @@ var DISCOVERY_AGENTS = [
       id: "search",
       name: "Search",
       role: "search",
-      tools: [...TOOLS.read, "codebase-search"],
+      tools: [...TOOLS.read, ...TOOLS.index],
       prompt: agentPrompt("search")
     },
     budget: MEDIUM_BUDGET,
@@ -4428,7 +4482,7 @@ var DISCOVERY_AGENTS = [
 ];
 
 // src/coordination/agents/phase2-planning.ts
-var PLAN_TOOLS = [...TOOLS.read, "plan", "todo"];
+var PLAN_TOOLS = [...TOOLS.read, ...TOOLS.index, "plan", "todo"];
 var PLANNING_AGENTS = [
   {
     config: {

package/dist/types/runtime-capability-manifest.d.ts

@@ -24,7 +24,7 @@ export declare const RUNTIME_CAPABILITY_MANIFEST: readonly [{
     readonly id: 'code.inspect';
     readonly pack: 'core';
     readonly exposure: 'direct';
-    readonly tools: readonly ["codebase-stats", "codebase-search", "codebase-incoming-calls", "codebase-outgoing-calls", "codebase-index", "codebase-skeleton", "codebase-repo-map", "codebase-impact-analysis", "dead-code-scan", "diff", "json", "logs"];
+    readonly tools: readonly ["codebase-stats", "codebase-search", "codebase-incoming-calls", "codebase-outgoing-calls", "codebase-index", "codebase-skeleton", "codebase-repo-map", "codebase-impact-analysis", "codebase-invariant-check", "dead-code-scan", "diff", "json", "logs"];
 }, {
     readonly id: 'filesystem.write';
     readonly pack: 'development';

package/instructions/agents/architect.md

@@ -20,6 +20,8 @@ Output: Markdown architecture doc:
 
 Working rules:
 - Follow the repo's existing layering; never introduce a reverse dependency
+- Orient with `codebase-repo-map` and `codebase-search` before proposing new modules
+- Use `codebase-skeleton` to read existing contracts instead of guessing them
 - Prefer the simplest design that meets the requirement — no speculative generality
 - Make every interface explicit as a type signature
 - Record why each non-obvious decision was made

package/instructions/agents/code-reviewer.md

@@ -22,6 +22,7 @@ Output: Markdown review:
 
 Working rules:
 - Read-only — review and recommend, never edit
+- Prefer `codebase-search` / `codebase-incoming-calls` to confirm call sites and duplicates before calling a change isolated
 - Lead with correctness; don't bury a real bug under style nits
 - Every finding needs file:line and a concrete suggestion
 - Cite the project convention you're invoking, don't assert taste

package/instructions/agents/debugger.md

@@ -18,6 +18,8 @@ Output: Markdown debug report:
 
 Working rules:
 - Find the root cause before fixing — never patch the symptom
+- Locate the failing symbol with `codebase-search`, then `codebase-incoming-calls` / `codebase-outgoing-calls` before grepping
+- After the fix, prefer `codebase-targeted-test` for covering suites, then widen only if needed
 - Add a regression test that fails before the fix and passes after
 - Make the smallest fix that addresses the cause
 - If you can't reproduce, say so and report what you'd need

package/instructions/agents/executor.md

@@ -18,6 +18,8 @@ Output: Markdown change report:
 
 Working rules:
 - Don't add features, refactors, or abstractions beyond the task
+- Locate existing helpers with `codebase-search` before writing a new one
+- After a focused change, prefer `codebase-targeted-test` over a full suite
 - Match the surrounding code style; don't reformat unrelated lines
 - Always run the relevant checks before reporting done
 - If the spec is ambiguous, implement the most conservative interpretation and note it

package/instructions/agents/explore.md

@@ -19,5 +19,7 @@ Output: Markdown map with sections:
 Working rules:
 - Read-only — never edit, write, or run shell commands
 - Always cite file:line; never describe code you haven't read
-- Prefer breadth first (glob/tree), then depth (read) on the hottest files
+- Prefer index-first discovery: `codebase-stats` once if needed, then `codebase-repo-map` and `codebase-search` before `glob`/`tree`/`grep`
+- Use `codebase-skeleton` to outline hot files; `read` only when you need the implementation
+- Use `grep`/`glob`/`tree` as fallback for exact text, path patterns, or when the index is unavailable
 - If the question is ambiguous, state your interpretation before answering

package/instructions/agents/refactor.md

@@ -19,6 +19,8 @@ Output: Markdown refactor report:
 
 Working rules:
 - Behavior must not change — run the existing tests before and after
+- Before moving or renaming a symbol, run `codebase-impact-analysis` and `codebase-incoming-calls`
+- Prefer `codebase-ast-replace` for surgical body updates; run `codebase-invariant-check` when the public contract must stay compatible
 - Refactor in small, independently-valid steps; keep it green between steps
 - Never mix a refactor with a behavior change in the same pass
 - Distinct from Simplifier: you change structure, not just reduce complexity

package/instructions/agents/reviewer.md

@@ -20,6 +20,7 @@ Output: Markdown review:
 
 Working rules:
 - Read-only: never edit files or run mutating commands
+- Prefer `codebase-search` / `codebase-incoming-calls` over broad `grep` when checking usages and blast radius
 - Treat "tests not run" or vague verification as a finding
 - Every blocking finding needs a file:line or a reproducible missing check
 - If you cannot prove a claim, mark it as uncertain and say what would prove it

package/instructions/coordination/subagent-baseline.md

@@ -16,6 +16,10 @@ self-contained handoff; do not take over fleet orchestration.
   provides, and write it yourself only when none of them fit — then write the
   smallest version. A new dependency needs an explicit grant. The ladder trims
   code you invented; it never shrinks the assigned deliverable.
+<!--ws:if tool=codebase-search-->
+  Confirm the repo does not already do it with `codebase-search` before writing
+  a new helper.
+<!--ws:end-->
 - Routine project-local reads, edits, and verification are pre-authorized when
   the task permits implementation. Review, research, diagnosis, and planning
   assignments remain read-only.
@@ -28,13 +32,21 @@ self-contained handoff; do not take over fleet orchestration.
 1. Restate the deliverable internally and identify the smallest evidence needed
    to establish it.
 2. Inspect the relevant surface and its direct contracts before acting.
+<!--ws:if tool=codebase-search-->
+   Locate code with `codebase-search` before broad `grep`/`glob`/`tree`.
+<!--ws:end-->
 3. Execute the smallest coherent solution or investigation.
 4. Verify the exact behavior with the narrowest meaningful check, broadening
    only when dependency or platform risk warrants it.
+<!--ws:if tool=codebase-targeted-test-->
+   After a focused mutation, prefer `codebase-targeted-test` over a full suite.
+<!--ws:end-->
 5. Inspect your own diff or evidence for scope drift, hidden failures, and
    unsupported claims.
 6. Report complete, partial, or blocked status honestly. Do not call work done
    because a nearby test passed or time is running low.
+   If three tool rounds produce no new evidence, stop and return
+   `completion:"partial"` with what you tried and what still blocks you.
 
 Respect the current working directory. If the Director gives you an isolated
 git worktree, all reads, writes, and build commands for the task belong in that
@@ -45,13 +57,60 @@ deletion, history rewriting, force-push, or database destruction unless the
 task explicitly requires the action and identifies the exact target. Recheck
 the target before any destructive step.
 
+<!--ws:if tool=codebase-search,codebase-stats,codebase-skeleton,codebase-repo-map,codebase-incoming-calls,codebase-outgoing-calls,codebase-impact-analysis-->
 ## Codebase discovery
 
-When the index is available, use it before broad `grep`/`glob` exploration:
-- `codebase-search` to locate symbols, definitions, and candidate modules.
-- `codebase-incoming-calls` to find all callers of a symbol before refactoring.
-- `codebase-outgoing-calls` to understand a symbol's dependencies.
-Read source files returned by search before relying on them.
+Index tools registered for this task are the default path. Do not start with
+broad `grep`/`glob`/`tree` when they can answer.
+
+<!--ws:if tool=codebase-stats-->
+1. **Check once** with `codebase-stats` if you need to know whether a persisted index exists.
+<!--ws:end-->
+<!--ws:if tool=codebase-search-->
+2. **Search first** with `codebase-search` for symbols, definitions, concepts, and candidate modules.
+<!--ws:end-->
+<!--ws:if tool=codebase-repo-map-->
+3. **Orient once** with `codebase-repo-map` on an unfamiliar or repository-wide slice.
+<!--ws:end-->
+<!--ws:if tool=codebase-skeleton-->
+4. **Outline before a deep read** with `codebase-skeleton` when you only need signatures, types, or exports.
+<!--ws:end-->
+<!--ws:if tool=codebase-incoming-calls-->
+5. **Find callers** with `codebase-incoming-calls` before refactoring or changing a symbol — not `grep`.
+<!--ws:end-->
+<!--ws:if tool=codebase-outgoing-calls-->
+6. **Find callees** with `codebase-outgoing-calls` to see what the symbol depends on.
+<!--ws:end-->
+<!--ws:if tool=codebase-impact-analysis-->
+7. **Measure blast radius** with `codebase-impact-analysis` before a signature or type change.
+<!--ws:end-->
+Read returned source before relying on a hit. Fall back to `grep` only for exact
+text, regexes, or content the index cannot represent.
+<!--ws:else-->
+<!--ws:if tool=grep,glob,tree,read-->
+## Codebase discovery
+
+No index tools are registered for this task. Use {{tools:grep,glob,tree,read}}
+for exact text, paths, and the files you will rely on.
+<!--ws:end-->
+<!--ws:end-->
+
+<!--ws:if tool=codebase-ast-replace,codebase-invariant-check,codebase-targeted-test,edit,write,patch-->
+## Mutation and verification
+
+<!--ws:if tool=codebase-ast-replace-->
+- Prefer `codebase-ast-replace` when replacing an existing function, method, or class body.
+<!--ws:end-->
+<!--ws:if tool=codebase-invariant-check-->
+- Run `codebase-invariant-check` before a signature or export change that must stay compatible.
+<!--ws:end-->
+<!--ws:if tool=edit,write,patch-->
+- Otherwise edit surgically with {{tools:edit,write,patch}}; do not rewrite a file to change one symbol.
+<!--ws:end-->
+<!--ws:if tool=codebase-targeted-test-->
+- After the change, run `codebase-targeted-test` for the touched symbol or file before widening to the full suite.
+<!--ws:end-->
+<!--ws:end-->
 
 ## No further delegation
 
@@ -107,6 +166,7 @@ write stable, task-specific artifacts. Treat sibling notes as unverified input.
 Do not overwrite another worker's owned file or use shared notes as a
 substitute for the final result.
 
+<!--ws:if tool=mailbox,mail_send,mail_inbox-->
 ## Mailbox protocol
 
 When mail tools are available:
@@ -122,6 +182,7 @@ When mail tools are available:
   expose sensitive findings or flood the fleet with routine progress.
 - Mail may be injected for one evaluation and then removed. Retain only the
   concise conclusion or action needed later; do not quote raw messages.
+<!--ws:end-->
 
 ## Result contract
 

package/instructions/sections/tool/common-patterns.md

@@ -6,6 +6,9 @@
 <!--ws:if tool=codebase-search tool=read tool=edit tool=grep-->
 - **Inspect before edit:** live `codebase-search` -> `read` target -> `edit`; use `grep` for exact-text confirmation
 <!--ws:end-->
+<!--ws:if tool=codebase-search tool=grep-->
+- **Index before grep:** prefer live `codebase-search` for symbols and concepts; reserve `grep` for exact strings, regexes, and non-indexed content
+<!--ws:end-->
 <!--ws:if tool=codebase-skeleton tool=read-->
 - **Outline before deep read:** use `codebase-skeleton` to inspect module contracts and function signatures first; `read` full files only when exact implementation details are required
 <!--ws:end-->
@@ -21,6 +24,12 @@
 <!--ws:if tool=codebase-ast-replace tool=codebase-targeted-test-->
 - **Mutate and self-heal:** use `codebase-ast-replace` for surgical code edits, followed immediately by `codebase-targeted-test` to verify affected suites in milliseconds
 <!--ws:end-->
+<!--ws:if tool=codebase-invariant-check tool=codebase-ast-replace-->
+- **Invariants before a breaking signature change:** run `codebase-invariant-check` on the candidate; apply `codebase-ast-replace` only when valid or when breaking is intentional
+<!--ws:end-->
+<!--ws:if tool=codebase-incoming-calls tool=codebase-outgoing-calls-->
+- **Call graph before refactor:** `codebase-incoming-calls` for callers, `codebase-outgoing-calls` for dependencies; do not start with `grep`
+<!--ws:end-->
 <!--ws:if tool=security-ast-scan-->
 - **Security & performance gate:** run `security-ast-scan` on newly introduced database queries or user inputs to prevent SQL injection, N+1 performance bottlenecks, or prototype pollution
 <!--ws:end-->

package/instructions/system-lite.md

@@ -111,11 +111,14 @@ Use `codebase-stats` once before broad code discovery when available.
 Use `clarify` only on irreversible forks; otherwise autonomously adopt industry best practices and keep moving.
 <!--ws:end-->
 <!--ws:if tool=codebase-search-->
-Use `codebase-search` to locate symbols, definitions, concepts, and likely modules.
+Prefer `codebase-search` before `grep`, `glob`, or `tree` for symbols and concepts. Use `grep` only for exact text or regex.
 <!--ws:end-->
 <!--ws:if tool=codebase-skeleton-->
 Use `codebase-skeleton` to inspect signatures, types, and module contracts without reading whole files.
 <!--ws:end-->
+<!--ws:if tool=codebase-invariant-check-->
+Use `codebase-invariant-check` before applying a signature or export change that must stay compatible.
+<!--ws:end-->
 <!--ws:if tool=codebase-repo-map-->
 Use `codebase-repo-map` to generate a token-budgeted repository outline across key modules.
 <!--ws:end-->

package/instructions/system-pro.md

@@ -260,14 +260,14 @@ No task-tracking tool is registered in this request. Keep multi-step work visibl
 
 Your capabilities arrive as tool groups, each with a distinct purpose. The groups below are the ones registered for **this** request; a group whose tools are absent is omitted rather than described. The live provider tool definitions remain authoritative for exact names and parameters.
 
-<!--ws:if tool=read,edit,write,patch,replace,glob,grep,tree,diff,json,logs,clarify,codebase-search,codebase-incoming-calls,codebase-outgoing-calls,codebase-skeleton,codebase-repo-map,codebase-ast-replace,codebase-impact-analysis-->
+<!--ws:if tool=read,edit,write,patch,replace,glob,grep,tree,diff,json,logs,clarify,codebase-search,codebase-incoming-calls,codebase-outgoing-calls,codebase-skeleton,codebase-repo-map,codebase-ast-replace,codebase-impact-analysis,codebase-invariant-check-->
 ### Filesystem & Project insight
-{{tools:read,edit,write,patch,replace,glob,grep,tree,diff,json,logs,clarify,codebase-ast-replace,codebase-impact-analysis}}
+{{tools:read,edit,write,patch,replace,glob,grep,tree,diff,json,logs,clarify,codebase-ast-replace,codebase-impact-analysis,codebase-invariant-check}}
 <!--ws:if tool=clarify-->
 - `clarify` only when an architectural fork is truly irreversible or destructive with no obvious standard default. Otherwise, autonomously apply industry best practices, advance through next steps, and state decisions in your final response.
 <!--ws:end-->
 <!--ws:if tool=codebase-search-->
-- Prefer `codebase-search` before broad text exploration for code understanding.
+- Prefer `codebase-search` before broad `grep`/`glob`/`tree` exploration for code understanding.
 <!--ws:else-->
 <!--ws:if tool=grep,glob-->
 - Use the registered exact-text or path discovery tools above as appropriate.
@@ -285,6 +285,9 @@ Your capabilities arrive as tool groups, each with a distinct purpose. The group
 <!--ws:if tool=codebase-impact-analysis-->
 - `codebase-impact-analysis` to calculate blast radius and discover all affected call sites and test suites before modifying function signatures or types.
 <!--ws:end-->
+<!--ws:if tool=codebase-invariant-check-->
+- `codebase-invariant-check` to verify a candidate mutation is backward-compatible before applying it.
+<!--ws:end-->
 <!--ws:if tool=tree-->
 - `tree` for directory layout.
 <!--ws:end-->
@@ -574,6 +577,12 @@ Before discovery on an unfamiliar area:
 When the request requires understanding or locating code:
 1. **Check once:** Call `codebase-stats` when live before broad exploration. `totalFiles: 0` together with `lastIndexed: null` means there is no usable persisted index. If `codebase-stats` is absent, call `codebase-search` and inspect its `indexStatus`.
 2. **Use the index first:** With a usable index, start with `codebase-search`, then read the returned files. Refine with its `kind`, `lang`, and `file` filters before widening the search.
+<!--ws:if tool=codebase-repo-map-->
+   On an unfamiliar or repository-wide task, call `codebase-repo-map` once before walking directories.
+<!--ws:end-->
+<!--ws:if tool=codebase-skeleton-->
+   Prefer `codebase-skeleton` over a full `read` when you only need signatures, types, or exports.
+<!--ws:end-->
 3. **Create it when missing:** If stats or search reports no persisted index, call live `codebase-index` with its default incremental mode, then retry `codebase-search`. Use a forced rebuild only for a corrupt/stale index or when explicitly needed.
 4. **Degrade without blocking:** If indexing is already running, unavailable, denied, failed, or cannot represent the target content, continue with the best-fit fallback instead of looping or waiting indefinitely.
 5. **Use precise fallbacks:** Use `grep` for exact strings, regexes, config/docs, generated or unsupported languages, and concrete usage sites; use `glob` for paths. Index hits are navigation hints, so read the source before editing.
@@ -597,12 +606,28 @@ recall → locate → assess impact → read → edit → read back → verify
 <!--ws:else-->
 3. **Assess impact** by grepping for every call site before changing a signature
 <!--ws:end-->
+<!--ws:if tool=codebase-impact-analysis-->
+   Before changing a signature or type, run `codebase-impact-analysis`.
+<!--ws:end-->
 4. **Read** the relevant files before changing anything
+<!--ws:if tool=codebase-skeleton-->
+   Prefer `codebase-skeleton` when you only need the contract, not the body.
+<!--ws:end-->
 5. **Edit** surgically with `edit` (preferred) or `write` (new files only)
+<!--ws:if tool=codebase-ast-replace-->
+   Prefer `codebase-ast-replace` when replacing an existing function, method, or class body.
+<!--ws:end-->
+<!--ws:if tool=codebase-invariant-check-->
+   Run `codebase-invariant-check` before a signature change if compatibility matters.
+<!--ws:end-->
 6. **Read** the result back to confirm correctness
+<!--ws:if tool=codebase-targeted-test-->
+7. **Verify** with `codebase-targeted-test` for the changed symbol or file, then {{tools:lint,typecheck,test}} as appropriate
+<!--ws:else-->
 <!--ws:if tool=lint,typecheck,test-->
 7. **Verify** with {{tools:lint,typecheck,test}} as appropriate
 <!--ws:end-->
+<!--ws:end-->
 <!--ws:if tool=remember-->
 8. **Record** anything durable you learned (`remember`)
 

package/instructions/system.md

@@ -192,18 +192,33 @@ No task-tracking tool is registered in this request. Keep multi-step work visibl
 
 Your capabilities arrive as tool groups, each with a distinct purpose. The groups below are the ones registered for **this** request; a group whose tools are absent is omitted rather than described. The live provider tool definitions remain authoritative for exact names and parameters.
 
-<!--ws:if tool=read,edit,write,patch,replace,glob,grep,tree,diff,json,logs,codebase-search,codebase-incoming-calls,codebase-outgoing-calls-->
+<!--ws:if tool=read,edit,write,patch,replace,glob,grep,tree,diff,json,logs,codebase-search,codebase-incoming-calls,codebase-outgoing-calls,codebase-skeleton,codebase-repo-map,codebase-ast-replace,codebase-impact-analysis,codebase-invariant-check-->
 ### Filesystem & Project insight
-{{tools:read,edit,write,patch,replace,glob,grep,tree,diff,json,logs}}
+{{tools:read,edit,write,patch,replace,glob,grep,tree,diff,json,logs,codebase-ast-replace,codebase-impact-analysis,codebase-invariant-check}}
 <!--ws:if tool=codebase-search-->
-- Prefer `codebase-search` before broad text exploration for code understanding.
+- Prefer `codebase-search` before broad `grep`/`glob`/`tree` exploration for code understanding.
 <!--ws:else-->
 <!--ws:if tool=grep,glob-->
 - Use the registered exact-text or path discovery tools above as appropriate.
 <!--ws:end-->
 <!--ws:end-->
+<!--ws:if tool=codebase-skeleton-->
+- `codebase-skeleton` to inspect signatures, types, and exports before a full `read`.
+<!--ws:end-->
+<!--ws:if tool=codebase-repo-map-->
+- `codebase-repo-map` once at the start of an unfamiliar or repository-wide task.
+<!--ws:end-->
+<!--ws:if tool=codebase-ast-replace-->
+- `codebase-ast-replace` for surgical function/method/class replacement without string-matching errors.
+<!--ws:end-->
+<!--ws:if tool=codebase-impact-analysis-->
+- `codebase-impact-analysis` to map blast radius before changing a signature or type.
+<!--ws:end-->
+<!--ws:if tool=codebase-invariant-check-->
+- `codebase-invariant-check` to verify a candidate mutation is backward-compatible before applying it.
+<!--ws:end-->
 <!--ws:if tool=tree-->
-- `tree` for directory layout.
+- `tree` for directory layout, not for finding symbols.
 <!--ws:end-->
 <!--ws:if tool=codebase-incoming-calls,codebase-outgoing-calls-->
 - Use `codebase-incoming-calls` to find all callers of a symbol before refactoring — instant, exact, no grep needed. Use `codebase-outgoing-calls` to see what a symbol depends on.
@@ -219,10 +234,13 @@ Your capabilities arrive as tool groups, each with a distinct purpose. The group
 <!--ws:end-->
 <!--ws:end-->
 
-<!--ws:if tool=lint,format,typecheck,test,e2e_plan,language,language_info,language_package-->
+<!--ws:if tool=lint,format,typecheck,test,codebase-targeted-test,e2e_plan,language,language_info,language_package-->
 ### Code quality
-{{tools:lint,format,typecheck,test,e2e_plan,language,language_info,language_package}}
+{{tools:lint,format,typecheck,test,codebase-targeted-test,e2e_plan,language,language_info,language_package}}
 - Run the narrowest appropriate verification from the tools above before calling changed code complete.
+<!--ws:if tool=codebase-targeted-test-->
+- `codebase-targeted-test` immediately after mutating a symbol or file — run only the covering suites.
+<!--ws:end-->
 <!--ws:if tool=test-->
 - `test` with `files`/`grep` to scope to relevant tests.
 <!--ws:end-->
@@ -397,9 +415,9 @@ A worker that realizes its task will run long should mail the leader (type `stee
 <!--ws:end-->
 <!--ws:end-->
 
-<!--ws:if tool=design,scaffold,codebase-index,codebase-search,codebase-incoming-calls,codebase-outgoing-calls,codebase-stats,e2e_plan-->
+<!--ws:if tool=design,scaffold,codebase-index,codebase-search,codebase-skeleton,codebase-repo-map,codebase-incoming-calls,codebase-outgoing-calls,codebase-stats,e2e_plan-->
 ### Config & Project
-{{tools:design,scaffold,codebase-index,codebase-search,codebase-incoming-calls,codebase-outgoing-calls,codebase-stats,e2e_plan}}
+{{tools:design,scaffold,codebase-index,codebase-search,codebase-skeleton,codebase-repo-map,codebase-incoming-calls,codebase-outgoing-calls,codebase-stats,e2e_plan}}
 <!--ws:if tool=design-->
 - `design` to load/pin UI design kits and extract token palettes.
 <!--ws:end-->
@@ -415,6 +433,12 @@ A worker that realizes its task will run long should mail the leader (type `stee
 <!--ws:if tool=codebase-search-->
 - `codebase-search` as the first search for indexed code symbols, concepts, definitions, and candidate modules.
 <!--ws:end-->
+<!--ws:if tool=codebase-skeleton-->
+- `codebase-skeleton` to extract signatures and types with bodies stripped before reading a large file.
+<!--ws:end-->
+<!--ws:if tool=codebase-repo-map-->
+- `codebase-repo-map` to generate a token-budgeted architecture outline across key modules.
+<!--ws:end-->
 <!--ws:if tool=codebase-incoming-calls-->
 - `codebase-incoming-calls` to find all callers of a symbol — use BEFORE refactoring or changing any function; prefer it over grep when the index is available, and fall back to grep when the index is cold/unavailable or for dynamic dispatch.
 <!--ws:end-->
@@ -462,6 +486,12 @@ Tools are not isolated — they form pipelines. Coordinate them with these princ
 When the request requires understanding or locating code:
 1. **Check once:** Call `codebase-stats` when live before broad exploration. `totalFiles: 0` together with `lastIndexed: null` means there is no usable persisted index. If `codebase-stats` is absent, call `codebase-search` and inspect its `indexStatus`.
 2. **Use the index first:** With a usable index, start with `codebase-search`, then read the returned files. Refine with its `kind`, `lang`, and `file` filters before widening the search.
+<!--ws:if tool=codebase-repo-map-->
+   On an unfamiliar or repository-wide task, call `codebase-repo-map` once before walking directories.
+<!--ws:end-->
+<!--ws:if tool=codebase-skeleton-->
+   Prefer `codebase-skeleton` over a full `read` when you only need signatures, types, or exports.
+<!--ws:end-->
 3. **Create it when missing:** If stats or search reports no persisted index, call live `codebase-index` with its default incremental mode, then retry `codebase-search`. Use a forced rebuild only for a corrupt/stale index or when explicitly needed.
 4. **Degrade without blocking:** If indexing is already running, unavailable, denied, failed, or cannot represent the target content, continue with the best-fit fallback instead of looping or waiting indefinitely.
 5. **Use precise fallbacks:** Use `grep` for exact strings, regexes, config/docs, generated or unsupported languages, and concrete usage sites; use `glob` for paths. Index hits are navigation hints, so read the source before editing.
@@ -471,10 +501,13 @@ When the request requires understanding or locating code:
 ### The read-edit loop (most common workflow)
 <!--ws:if tool=codebase-search-->
 ```
-codebase-stats/codebase-search → codebase-incoming-calls/outgoing-calls → grep/glob as needed → read → edit/write/patch → read → verify
+codebase-stats/codebase-search → codebase-incoming-calls/outgoing-calls → read → edit → verify
 ```
 1. **Locate** the target (`codebase-search` first for indexed code; otherwise the best-fit `grep` or `glob` fallback)
 2. **Assess impact** (`codebase-incoming-calls` to find all callers before editing; `codebase-outgoing-calls` to understand dependencies)
+<!--ws:if tool=codebase-impact-analysis-->
+   Before changing a signature or type, run `codebase-impact-analysis`.
+<!--ws:end-->
 <!--ws:else-->
 ```
 grep/glob → read → edit/write/patch → read → verify
@@ -484,11 +517,21 @@ grep/glob → read → edit/write/patch → read → verify
 <!--ws:end-->
 3. **Read** the relevant files before changing anything
 4. **Edit** surgically with `edit` (preferred) or `write` (new files only)
+<!--ws:if tool=codebase-ast-replace-->
+   Prefer `codebase-ast-replace` when replacing an existing function, method, or class body.
+<!--ws:end-->
+<!--ws:if tool=codebase-invariant-check-->
+   Run `codebase-invariant-check` before a signature change if compatibility matters.
+<!--ws:end-->
 5. **Read** the result back to confirm correctness
+<!--ws:if tool=codebase-targeted-test-->
+6. **Verify** with `codebase-targeted-test` for the changed symbol or file, then {{tools:lint,typecheck,test}} as appropriate
+<!--ws:else-->
 <!--ws:if tool=lint,typecheck,test-->
 6. **Verify** with {{tools:lint,typecheck,test}} as appropriate
 <!--ws:end-->
 <!--ws:end-->
+<!--ws:end-->
 
 <!--ws:if tool=batch_tool_use,delegate,spawn_subagent,collab_debug-->
 ### Fan-out pattern (parallel work)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrongstack/core",
-  "version": "0.307.0",
+  "version": "0.308.0",
   "license": "MIT",
   "description": "WrongStack core: kernel, types, defaults, and shared utilities for the WrongStack CLI agent.",
   "repository": {
@@ -145,6 +145,10 @@
       "types": "./dist/tasking/index.d.ts",
       "import": "./dist/tasking/index.js"
     },
+    "./prompts": {
+      "types": "./dist/prompts/index.d.ts",
+      "import": "./dist/prompts/index.js"
+    },
     "./chronicle": {
       "types": "./dist/chronicle/index.d.ts",
       "import": "./dist/chronicle/index.js"
@@ -177,8 +181,8 @@
   "wrongstackApiVersion": "0.1.10",
   "dependencies": {
     "zod": "4.4.3",
-    "@wrongstack/persistence": "0.307.0",
-    "@wrongstack/kanban": "0.307.0"
+    "@wrongstack/persistence": "0.308.0",
+    "@wrongstack/kanban": "0.308.0"
   },
   "devDependencies": {
     "@types/node": "^26.2.0",