Skip to content

Commit 6448c12

Browse files
Kurt Overmierclaude
andcommitted
docs(blast,surface): link cc-taskrunner as reference integration
Both packages are now powering downstream integrations in cc-taskrunner (Stackbilt-dev/cc-taskrunner#21, #22). Added "Downstream integrations" sections to both READMEs pointing at the taskrunner as a real-world example of wiring these primitives into a governance workflow. blast: - Documents cc-taskrunner 1.5.0's 4-level severity ladder with gate behavior table - Explains the auto_safe downgrade on critical severity - Points at compute_blast_radius() in taskrunner.sh surface: - Documents cc-taskrunner 1.4.0's mission brief fingerprint injection - Mentions the 80-line cap and graceful no-op behavior - Points at build_fingerprint() in taskrunner.sh Both sections help readers understand how these zero-dep analysis packages compose with real autonomous-agent workflows. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 2525747 commit 6448c12

File tree

2 files changed

+27
-0
lines changed

2 files changed

+27
-0
lines changed

packages/blast/README.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -104,6 +104,23 @@ Resolves a single import specifier to an absolute file path, or `null` for bare
104104
- **Code review automation** — surface hot files to reviewers who might otherwise miss architectural impact
105105
- **Self-improvement bots** — require blast radius <N before auto-queueing fix tasks
106106
107+
## Downstream integrations
108+
109+
### cc-taskrunner — autonomous agent safety gate
110+
111+
[cc-taskrunner](https://github.com/Stackbilt-dev/cc-taskrunner) runs Claude Code in unattended sessions to execute queued tasks. Starting in **1.5.0**, it calls `charter blast --format json` on files referenced by each task prompt and classifies the result on a 4-level severity ladder:
112+
113+
| Affected files | Severity | Behavior |
114+
|---|---|---|
115+
| 0–4 | `low` | silent |
116+
| 5–19 | `medium` | silent |
117+
| 20–49 | `high` | warning injected into mission brief |
118+
| 50+ | `critical` | warning injected; **`auto_safe` execution refused** |
119+
120+
Critical severity downgrades `auto_safe` tasks to "requires operator approval" **before** spawning Claude Code, preventing catastrophic blast-radius changes from silently landing in autonomous pipelines. Thresholds are tunable via `CC_BLAST_WARN` and `CC_BLAST_BLOCK` env vars.
121+
122+
This is the reference implementation for wiring `@stackbilt/blast` into a governance workflow. See [cc-taskrunner/taskrunner.sh](https://github.com/Stackbilt-dev/cc-taskrunner/blob/main/taskrunner.sh) — look for `compute_blast_radius()` and the "Blast radius preflight gate" comment block.
123+
107124
## Requirements
108125
109126
- Node >= 18

packages/surface/README.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -113,6 +113,16 @@ Renders a surface as a compact markdown summary suitable for injection into AI c
113113
114114
Any router with the `router.METHOD('/path', handler)` pattern will work; only the framework label depends on import detection.
115115
116+
## Downstream integrations
117+
118+
### cc-taskrunner — mission brief fingerprinting
119+
120+
[cc-taskrunner](https://github.com/Stackbilt-dev/cc-taskrunner) runs Claude Code in unattended sessions. Starting in **1.4.0**, it calls `charter surface --markdown` on the target repo and injects the result as a `## Project Context (auto-generated)` section in every mission brief. This gives the agent an immediate routes + schema map so it doesn't burn exploration turns figuring out the codebase layout.
121+
122+
Output is capped at 80 lines to protect the prompt budget, and the whole feature no-ops gracefully when charter isn't installed. Opt out via `CC_DISABLE_FINGERPRINT=1`.
123+
124+
See [cc-taskrunner/taskrunner.sh](https://github.com/Stackbilt-dev/cc-taskrunner/blob/main/taskrunner.sh) — look for `build_fingerprint()` and the "Project fingerprint" comment block.
125+
116126
## Requirements
117127
118128
- Node >= 18

0 commit comments

Comments
 (0)