Files
gstack/bin/gstack-skill-route
T
5df6b5a8cf The prompt-routing hook names your installed bug-fix skill on bug reports, and never puts /verify first (GST-3237) (#4539)
On a bug report, the routing hook now names the installed bug-fix skill
(prove-it, or any skill whose triggers claim bug fixing) alone, so
/verify is never ranked ahead of it.

Why: in B1d, Opus 5.5 loaded prove-it in 29 of 33 sessions when the hook
named it alone and 0 of 20 when it didn't; the old matcher named it on
only 40 of B1's 60 prompts.

Nothing to do: the hook line's wording is unchanged.

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
Co-authored-by: Lubos Buracinsky <159481718+lubosxyz@users.noreply.github.com>
Review-Finding: p1/outside-voice#1 reader=outside-voice
Review-Finding: p1/outside-voice#2 reader=outside-voice
Review-Finding: p1/adversarial-native#1 reader=adversarial-native
Review-Finding: p1/adversarial-native#4 reader=adversarial-native
Review-Finding: p1/specialist-batched#1 reader=testing
Review-Finding: p2/red-team#1 reader=red-team
Review-Finding: p2/specialist-batched#1 reader=testing
2026-11-19 22:04:13 +00:00

66 lines
3.7 KiB
TypeScript
Executable File

#!/usr/bin/env -S bun --no-env-file --config=/dev/null
/**
* gstack-skill-route — show how the skill-route hook scores a prompt (GST-1088).
*
* Usage:
* gstack-skill-route --explain "<prompt>" [--json] [--threshold <n>]
* gstack-skill-route --default <skill_routing|skill_contracts|destructive_guard|ceo_review_gate|autoplan_gate>
*
* Prints the switch state, the threshold, every candidate skill with its
* score, best trigger and source (gstack, or the installed SKILL.md), the
* route the hook would take (up to two skills) and the exact line it
* would inject. Works with the switch off (a dry run): it never injects
* anything. --default prints a switch's SWITCH_DEFAULT (on or off), the value
* setup and gstack-config use when the switch is unset. Exit 0, or 2 on a usage error. Docs: docs/skill-routing-and-contracts.md.
*/
import {
ROUTE_THRESHOLD, SWITCH_DEFAULT, hintLine, installedSkillsDir, readSkillSwitch, routePrompt, scanInstalledSkills,
} from '../lib/skill-route';
const USAGE = 'Usage: gstack-skill-route --explain "<prompt>" [--json] [--threshold <n>]\n gstack-skill-route --default <skill_routing|skill_contracts|destructive_guard|ceo_review_gate|autoplan_gate>';
const args = process.argv.slice(2);
if (args[0] === '--help' || args[0] === '-h') { process.stdout.write(`${USAGE}\n`); process.exit(0); }
if (args[0] === '--default') {
const name = args[1] ?? '';
if (!Object.hasOwn(SWITCH_DEFAULT, name)) {
process.stderr.write(`SKILL_ROUTE_USAGE: --default needs skill_routing, skill_contracts, destructive_guard, ceo_review_gate or autoplan_gate\n${USAGE}\n`);
process.exit(2);
}
process.stdout.write(`${SWITCH_DEFAULT[name as keyof typeof SWITCH_DEFAULT]}\n`);
process.exit(0);
}
const at = args.indexOf('--explain');
const prompt = at >= 0 ? args[at + 1] : undefined;
const tAt = args.indexOf('--threshold');
const threshold = tAt >= 0 ? Number(args[tAt + 1]) : ROUTE_THRESHOLD;
if (prompt === undefined || !Number.isFinite(threshold) || threshold <= 0 || threshold > 1) {
process.stderr.write(`SKILL_ROUTE_USAGE: --explain needs a prompt; --threshold must be in (0, 1]\n${USAGE}\n`);
process.exit(2);
}
const dir = installedSkillsDir();
const { skills, problems } = scanInstalledSkills(dir);
const decision = routePrompt(prompt, skills, threshold);
const sw = readSkillSwitch('skill_routing');
const hint = decision.route ? hintLine(decision.route, '', decision.routes[1]) : null;
const routes = decision.route ? decision.routes.map(r => r.skill) : [];
if (args.includes('--json')) {
process.stdout.write(`${JSON.stringify({
switch: { on: sw.on, source: sw.source }, threshold, skills_dir: dir, skills: skills.length, problems,
candidates: decision.candidates, route: decision.route?.skill ?? null, routes, bug_report: decision.route ? decision.bugReport : false,
reason: decision.route ? null : decision.reason, hint,
}, null, 2)}\n`);
process.exit(0);
}
const lines = [
`switch: skill_routing ${sw.on ? 'on' : 'off'} (${sw.source})${sw.invalid !== undefined ? `, unrecognized value ${JSON.stringify(sw.invalid)}` : ''}`,
`threshold: ${threshold}`,
`skills: ${skills.length} scanned in ${dir}${problems.length ? ` (${problems.join('; ')})` : ''}`,
'candidates:',
...(decision.candidates.length
? decision.candidates.map(c => ` ${c.score.toFixed(2)} /${c.skill} "${c.trigger}" (${c.matched} words, ${c.gstack ? 'gstack' : `installed: ${c.file}`})`)
: [' (none)']),
decision.route ? `route: ${routes.map(r => `/${r}`).join(', ')}${decision.bugReport ? ' (a bug report: the installed skill that claims bug reports)' : ''}` : `route: none (${decision.reason})`,
...(hint ? [`hint: ${hint}`] : []),
];
process.stdout.write(`${lines.join('\n')}\n`);