You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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>
[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 |
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.
Copy file name to clipboardExpand all lines: packages/surface/README.md
+10Lines changed: 10 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -113,6 +113,16 @@ Renders a surface as a compact markdown summary suitable for injection into AI c
113
113
114
114
Any router with the `router.METHOD('/path', handler)` pattern will work; only the framework label depends on import detection.
115
115
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.
0 commit comments