docs(ship): one execute program per review pass; the meter read sits in the budget command's program (GSTA-167)

capy SKILL.md and budget-handoff.md state the pass order: build, check --next,
review-log --start per role, BEFORE, create, poll, AFTER, settle, collect. The Capy
token-cap line no longer asks for a meter-only program. Tests pin both and show close
has no budget_check_skipped stop for a multi-role reservation.

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
This commit is contained in:
garrytanandcapy-ai[bot] committed 2026-10-30 00:09:27 +00:00
1 parent 5d0be936d4
commit 4ec30fe145
5 files changed
+40 -2

No files matched your search

+25
View File
@@ -236,6 +236,31 @@ describe('the budget section states both contracts', () => {
expect(tmpl).toMatch(/--prior-reading[\s\S]{0,200}previous call/);
expect(tmpl).toMatch(/older than the run's last reading is ignored/);
});
// Value: protects=no gstack prose tells the agent to read the meter in a call of its own (each such call costs a full context, about 0.2M on #34/#36); fails_when=capy SKILL.md keeps "one execute program returning only that number" or the section asks for a meter-only call;
// why_new=the template test above never read the Capy skill; seam=none; no_claim=how often an agent obeys the prose
test('the Capy skill reads the meter inside the budget command\'s program and names no meter-only call', () => {
const capy = fs.readFileSync(path.join(import.meta.dir, '..', 'capy', 'skill', 'gstack', 'SKILL.md'), 'utf8');
const caps = capy.slice(capy.indexOf('Token caps on /ship'), capy.indexOf('/ship reviewers on Capy'));
expect(caps.length).toBeGreaterThan(0);
expect(caps).not.toContain('returning only that number');
expect(caps).toMatch(/inside the same (?:execute )?program as the\s+`gstack-ship-budget` command/);
for (const text of [capy, tmpl]) expect(text).not.toMatch(/read it again in your next call|meter-only call(?!s? (?:is|are) never)/);
});
// Value: protects=each review pass is one execute program in a fixed order, so the readers' reading pair brackets only them and no build, start or poll costs its own parent call; fails_when=the order breaks (a start after the readers are created, a settle after collect) or later builds hand-copy flags instead of --like;
// why_new=no test reads the pass order; seam=none; no_claim=the model's adherence
test('a review pass is one execute program: build, check --next, review-log --start, BEFORE, create, poll, AFTER and settle, collect', () => {
const capy = fs.readFileSync(path.join(import.meta.dir, '..', 'capy', 'skill', 'gstack', 'SKILL.md'), 'utf8');
const pass = capy.slice(capy.indexOf('/ship reviewers on Capy'), capy.indexOf('## Plan, approve, ship'));
expect(pass).toMatch(/one execute program per review pass/);
const order = ['gstack-review-packet build', 'check --next', 'gstack-review-log --start', 'BEFORE', 'tools.subagent.create', 'tools.subagent.get', 'AFTER', 'gstack-ship-budget settle', 'gstack-review-packet collect'];
for (const text of [pass, tmpl.slice(tmpl.indexOf('**One program per review pass.**'))]) {
const at = order.map(o => text.indexOf(o));
expect(at.every(i => i >= 0), order.filter((_, k) => at[k]! < 0).join(',')).toBe(true);
expect([...at].sort((a, b) => a - b)).toEqual(at);
}
expect(pass).toContain('--like');
expect(pass).not.toContain("with the plan run's flags");
});
test('a batch names one role per reader and is settled with the dispatch program\'s own reading pair', () => {
expect(tmpl).toMatch(/one role per (?:reader|`DISPATCH:` line)/);
expect(tmpl).toMatch(/Settle each batch in the program that dispatched it[\s\S]{0,300}--dispatched-at <before> --reading <after> --readers <n>/);
+1
View File
@@ -113,6 +113,7 @@ describe('gstack-review-log --start under a token cap', () => {
expect(h.ledger(run.ledger).reservations.find((r: any) => r.id === id).state).toBe('settled');
const close = h.sb(['close', '--run', run.run, '--reading', '10']);
expect(close.out).not.toContain('BUDGET_CHECK_SKIPPED');
expect(close.out).not.toContain('reason=budget_check_skipped');
expect(close.code, close.out).toBe(0);
});