mirror of
https://github.com/garrytan/gstack.git
synced 2026-10-31 22:14:25 +01:00
Garry Tanandcapy-ai[bot]
53db038c6b
* fix(ship-budget): calibrate projections from the run's own meter, settle dispatch reservations when reviewers return (GST-101) The /ship budget projected every step and dispatch from fixed constants (7.43M per dispatch, 2.25M per default step) plus a fixed 4.48M reserve, so real caps refused work that cost 3-20x less (GSTA-152 PR B, GSTA-2). Each settled reservation is now measured on the next reading, and the run projects with its own factor (max actual/prior of its last three measurements x 1.5), the prior only before the first measurement. The default tail reserve scales with the step factor; the stop overhead keeps its fit. Reservations of reviewers admitted one at a time no longer pile up: check --returned settles named dispatches, --finish settles the pass's dispatches of that step, and a step change settles consumed dispatches. DRIFT and BUDGET_DRIFT lines print projected against actual. Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> * fix: pre-landing review fixes (GST-101) Unseen charges (settle --unknown, a Claude-metered outside voice) are booked at their reservation and never measured, so they cannot shrink the dispatch factor. The handoff holds back the same calibrated reserve as check, so a delegate verdict is one the handoff admits. Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> * docs(ship-budget): handoff sub-cap subtracts unknown charges and the calibrated reserve Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> * chore: changelog (Unreleased) for GST-101 ship-budget calibration Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> * test(ship-budget): give the GSTA-152 PR B replay an explicit 120s timeout It spawns about 100 CLI processes; on windows-latest it ran past the shard runner's 30s per-test timeout (windows-free-shard 5, run 40917695070), and on 2 cores it sat at bare bun test's 5s default. Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> --------- Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
51 lines
3.3 KiB
TypeScript
Executable File
51 lines
3.3 KiB
TypeScript
Executable File
#!/usr/bin/env -S bun --no-env-file --config=/dev/null
|
|
/**
|
|
* gstack-ship-budget — the /ship token budget and fresh-context handoff
|
|
* (docs/ship-budget.md). An admission cap: no step or dispatch starts unless
|
|
* used + open reservations + unknown + its projection + the tail and stop
|
|
* reserve fit under the cap.
|
|
*
|
|
* start --record <path> [--token-cap <n|none>] [--meter capy|claude|estimate] [--reading <n>] [--prior-reading <n>]
|
|
* [--session <id>|--nonce <v>] [--reserve <n>] [--delegate auto|never] [--calibration <file>] [--ledger <path>]
|
|
* check --run <id>|--record <path> --step <id> --next <id|dispatch:<role>[,<role>...]> [--reading <n>] [--prior-reading <n>] [--returned <id>[,<id>...]]
|
|
* settle --run|--record --reservation <id> [--unknown] [--reading <n>] release --run|--record --reservation <id>
|
|
* handoff --run|--record --from <step> --to <step> --base origin/<base> [--reviewed-tree <t>] [--trail <f> --trail-run <id>]
|
|
* [--sub-cap <n>] [--reading <n>] [--child-session <id>]
|
|
* launch --in <brief> (Claude Code: background headless child with explicit permissions)
|
|
* verify-handoff --in <brief> [--reading <n>] [--session <id>]
|
|
* return --run <child> --to <step> [--changed <sections>] [--status complete|refused|incomplete] [--reading <n>]
|
|
* reconcile --run|--record (--return <file>|--handoff <sha256>) [--reading <n>]
|
|
* resume --record <path>|--run <id> [--reading <n>] [--meter <m>] [--session <id>] [--token-cap <n> --approved-by <who> --words <text>]
|
|
* [--rebuild-from-record]
|
|
* close --run|--record [--reading <n>] [--approved-by <who> --words <text>]
|
|
*
|
|
* Exit: 0 continue/delegate · 3 stop (the next step does not start) · 2 usage
|
|
* or validation (stderr). Logic: lib/ship-budget.ts, lib/ship-budget-cli.ts,
|
|
* lib/ship-handoff.ts.
|
|
*/
|
|
import { BudgetError } from '../lib/ship-budget';
|
|
import { cmdCheck, cmdClose, cmdResume, cmdSettle, cmdStart, type Outcome } from '../lib/ship-budget-cli';
|
|
import { cmdHandoff, cmdLaunch, cmdReconcile, cmdReturn, cmdVerifyHandoff } from '../lib/ship-handoff';
|
|
|
|
const [command, ...rest] = process.argv.slice(2);
|
|
const ctx = { env: process.env, cwd: process.cwd() };
|
|
const commands: Record<string, () => Outcome> = {
|
|
start: () => cmdStart(rest, ctx), check: () => cmdCheck(rest, ctx), settle: () => cmdSettle(rest, ctx), release: () => cmdSettle(rest, ctx, true),
|
|
handoff: () => cmdHandoff(rest, ctx), launch: () => cmdLaunch(rest, ctx), 'verify-handoff': () => cmdVerifyHandoff(rest, ctx), return: () => cmdReturn(rest, ctx),
|
|
reconcile: () => cmdReconcile(rest, ctx), resume: () => cmdResume(rest, ctx), close: () => cmdClose(rest, ctx),
|
|
};
|
|
if (!command || command === '--help' || command === '-h' || !commands[command]) {
|
|
const text = (await Bun.file(import.meta.path).text()).split('\n').slice(2, 26).map(l => l.replace(/^ \* ?/, '')).join('\n');
|
|
(command && command !== '--help' && command !== '-h' ? console.error : console.log)(text);
|
|
process.exit(command && command !== '--help' && command !== '-h' ? 2 : 0);
|
|
}
|
|
try {
|
|
const out = commands[command]!();
|
|
if (out.stdout.length) console.log(out.stdout.join('\n'));
|
|
process.exit(out.exit);
|
|
} catch (e) {
|
|
if (!(e instanceof BudgetError)) throw e;
|
|
if (e.exit === 3) console.log(e.message); else console.error(e.message);
|
|
process.exit(e.exit);
|
|
}
|