greprag 5.55.0 → 5.57.0

package/dist/commands/loadout-reminder.d.ts

@@ -0,0 +1,37 @@
+/** loadout-registrar — the bundled Interrupt-System module that activates
+ *  equipped loadouts (docs/loadout.md §activation model, adr/loadout.md). Modeled
+ *  on `assistantDoctrine`: a data-driven announce over a per-tenant signal the
+ *  hook assembles into `env`. THE one piece of executable code in the loadout
+ *  feature — shipped in the CLI binary, identical for every tenant. Nothing that
+ *  crosses the tenant wall is code; only the inert announce declarations
+ *  (env.equippedLoadouts) it renders.
+ *
+ *  Two firing layers, both at launch (docs/loadout.md — "one advisor line, expert
+ *  keywords as the sensor"):
+ *
+ *    - SessionStart (announce): ONE advisor pointer line per equipped loadout.
+ *      The agent boots knowing the system exists + how to load it. Detect-
+ *      independent (collectAnnounces renders every module's announce).
+ *    - Per-turn (Match on env.promptText): when the prompt hits any equipped
+ *      loadout's derived keywords, fire ONE thin "→ greprag load <advisor>"
+ *      reminder; the advisor routes to the matched expert on demand.
+ *
+ *  PURE over ReminderEnv — the hook owns all I/O (SessionStart fetch → local
+ *  cache; per-turn cache read), so detect→announce + the keyword match are the
+ *  unit-testable regression-locks. */
+import { ReminderEnv, Detection, ReminderModule } from './reminder-types';
+/** Which equipped loadouts does the prompt touch? PURE — a keyword hit is a
+ *  case-insensitive substring match against the prompt text. Returns the
+ *  matched decls (empty when no prompt / no equipped loadouts / no hit). */
+export declare function matchLoadouts(promptText: string | null | undefined, equipped: ReminderEnv['equippedLoadouts']): NonNullable<ReminderEnv['equippedLoadouts']>;
+/** SessionStart announce block — one advisor pointer per equipped loadout. */
+export declare function buildLoadoutAnnounce(equipped: ReminderEnv['equippedLoadouts']): string | null;
+/** The per-turn Match: fire ONE advisor-load pointer per matched loadout. */
+export declare function buildLoadoutReminder(matched: NonNullable<ReminderEnv['equippedLoadouts']>): string | null;
+/** Detect = the per-turn Match gate. Silent unless the prompt hits a keyword of
+ *  some equipped loadout (which also implies there ARE equipped loadouts). The
+ *  ambient "has loadouts" state drives the ANNOUNCE, which collectAnnounces reads
+ *  independent of detect — so the detector stays a pure Match gate (no per-turn
+ *  billboard). detail.matched carries the hit set for the reminder. */
+export declare function loadoutDetect(env: ReminderEnv): Detection;
+export declare const loadoutRegistrarModule: ReminderModule;

package/dist/commands/loadout-reminder.js

@@ -0,0 +1,78 @@
+"use strict";
+/** loadout-registrar — the bundled Interrupt-System module that activates
+ *  equipped loadouts (docs/loadout.md §activation model, adr/loadout.md). Modeled
+ *  on `assistantDoctrine`: a data-driven announce over a per-tenant signal the
+ *  hook assembles into `env`. THE one piece of executable code in the loadout
+ *  feature — shipped in the CLI binary, identical for every tenant. Nothing that
+ *  crosses the tenant wall is code; only the inert announce declarations
+ *  (env.equippedLoadouts) it renders.
+ *
+ *  Two firing layers, both at launch (docs/loadout.md — "one advisor line, expert
+ *  keywords as the sensor"):
+ *
+ *    - SessionStart (announce): ONE advisor pointer line per equipped loadout.
+ *      The agent boots knowing the system exists + how to load it. Detect-
+ *      independent (collectAnnounces renders every module's announce).
+ *    - Per-turn (Match on env.promptText): when the prompt hits any equipped
+ *      loadout's derived keywords, fire ONE thin "→ greprag load <advisor>"
+ *      reminder; the advisor routes to the matched expert on demand.
+ *
+ *  PURE over ReminderEnv — the hook owns all I/O (SessionStart fetch → local
+ *  cache; per-turn cache read), so detect→announce + the keyword match are the
+ *  unit-testable regression-locks. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadoutRegistrarModule = void 0;
+exports.matchLoadouts = matchLoadouts;
+exports.buildLoadoutAnnounce = buildLoadoutAnnounce;
+exports.buildLoadoutReminder = buildLoadoutReminder;
+exports.loadoutDetect = loadoutDetect;
+/** Which equipped loadouts does the prompt touch? PURE — a keyword hit is a
+ *  case-insensitive substring match against the prompt text. Returns the
+ *  matched decls (empty when no prompt / no equipped loadouts / no hit). */
+function matchLoadouts(promptText, equipped) {
+    const prompt = (promptText || '').toLowerCase();
+    if (!prompt.trim() || !equipped || equipped.length === 0)
+        return [];
+    return equipped.filter((l) => (l.keywords || []).some((kw) => {
+        const k = kw.trim().toLowerCase();
+        return k.length >= 3 && prompt.includes(k);
+    }));
+}
+/** SessionStart announce block — one advisor pointer per equipped loadout. */
+function buildLoadoutAnnounce(equipped) {
+    const decls = (equipped || []).filter((l) => l.announceLine);
+    if (decls.length === 0)
+        return null;
+    return [
+        '[greprag loadouts — equipped skill bundles (served on demand via `greprag load`):]',
+        ...decls.map((l) => `  ${l.announceLine}`),
+    ].join('\n');
+}
+/** The per-turn Match: fire ONE advisor-load pointer per matched loadout. */
+function buildLoadoutReminder(matched) {
+    if (matched.length === 0)
+        return null;
+    return matched
+        .map((l) => `🎒 your equipped loadout "${l.name}" covers this → \`greprag load ${l.advisor}\` (it routes to the right expert)`)
+        .join('\n');
+}
+/** Detect = the per-turn Match gate. Silent unless the prompt hits a keyword of
+ *  some equipped loadout (which also implies there ARE equipped loadouts). The
+ *  ambient "has loadouts" state drives the ANNOUNCE, which collectAnnounces reads
+ *  independent of detect — so the detector stays a pure Match gate (no per-turn
+ *  billboard). detail.matched carries the hit set for the reminder. */
+function loadoutDetect(env) {
+    const matched = matchLoadouts(env.promptText, env.equippedLoadouts);
+    if (matched.length === 0)
+        return { tier: 'silent' };
+    return { tier: 'nudge', detail: { matched } };
+}
+exports.loadoutRegistrarModule = {
+    id: 'loadout-registrar',
+    // The announce says "greprag load" — depends on the load primer teaching it.
+    dependsOn: ['load-primer'],
+    detect: loadoutDetect,
+    announce: (env) => buildLoadoutAnnounce(env.equippedLoadouts),
+    reminder: (d) => buildLoadoutReminder(d.detail?.matched || []),
+};
+//# sourceMappingURL=loadout-reminder.js.map

package/dist/commands/loadout-reminder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadout-reminder.js","sourceRoot":"","sources":["../../src/commands/loadout-reminder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;sCAoBsC;;;AAOtC,sCAUC;AAGD,oDAOC;AAGD,oDAKC;AAOD,sCAIC;AA1CD;;4EAE4E;AAC5E,SAAgB,aAAa,CAC3B,UAAqC,EACrC,QAAyC;IAEzC,MAAM,MAAM,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpE,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE;QAC3D,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAClC,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,8EAA8E;AAC9E,SAAgB,oBAAoB,CAAC,QAAyC;IAC5E,MAAM,KAAK,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IAC7D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO;QACL,oFAAoF;QACpF,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,YAAY,EAAE,CAAC;KAC3C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,6EAA6E;AAC7E,SAAgB,oBAAoB,CAAC,OAAqD;IACxF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,6BAA6B,CAAC,CAAC,IAAI,kCAAkC,CAAC,CAAC,OAAO,oCAAoC,CAAC;SAC9H,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;;;uEAIuE;AACvE,SAAgB,aAAa,CAAC,GAAgB;IAC5C,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACpE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACpD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC;AAChD,CAAC;AAEY,QAAA,sBAAsB,GAAmB;IACpD,EAAE,EAAE,mBAAmB;IACvB,6EAA6E;IAC7E,SAAS,EAAE,CAAC,aAAa,CAAC;IAC1B,MAAM,EAAE,aAAa;IACrB,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC7D,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAE,CAAC,CAAC,MAAM,EAAE,OAAwD,IAAI,EAAE,CAAC;CACjH,CAAC"}

package/dist/commands/loadout.d.ts

@@ -0,0 +1,15 @@
+/** greprag loadout — cross-tenant skill-bundle gifting (docs/loadout.md,
+ *  adr/loadout.md). A loadout is a directed private GIFT: you SEND a bundle of
+ *  skills to another tenant; it lands at their front desk as a cold open; their
+ *  operator EQUIPS or DECLINES; on equip it copies into their load store and
+ *  self-inflates via the Interrupt System — no harness skills-dir write.
+ *
+ *    loadout send --to <handle>@greprag.com --skill <name> [--dir <path>] …
+ *    loadout list | status
+ *    loadout open <id>
+ *    loadout equip <id>  (alias: accept) | decline <id>
+ *    loadout unequip <name> [--delete-skills]
+ *
+ *  Thin HTTP wrapper over /v1/loadout (the CLI is core-free). --skill resolves
+ *  server-side from your mirror store; --dir reads a skill dir from disk here. */
+export declare function runLoadout(args: string[]): Promise<void>;

package/dist/commands/loadout.js

@@ -0,0 +1,320 @@
+"use strict";
+/** greprag loadout — cross-tenant skill-bundle gifting (docs/loadout.md,
+ *  adr/loadout.md). A loadout is a directed private GIFT: you SEND a bundle of
+ *  skills to another tenant; it lands at their front desk as a cold open; their
+ *  operator EQUIPS or DECLINES; on equip it copies into their load store and
+ *  self-inflates via the Interrupt System — no harness skills-dir write.
+ *
+ *    loadout send --to <handle>@greprag.com --skill <name> [--dir <path>] …
+ *    loadout list | status
+ *    loadout open <id>
+ *    loadout equip <id>  (alias: accept) | decline <id>
+ *    loadout unequip <name> [--delete-skills]
+ *
+ *  Thin HTTP wrapper over /v1/loadout (the CLI is core-free). --skill resolves
+ *  server-side from your mirror store; --dir reads a skill dir from disk here. */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runLoadout = runLoadout;
+const skill_mirror_client_1 = require("../skill-mirror-client");
+const skill_landing_1 = require("../skill-landing");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+function getConfig() {
+    return {
+        apiUrl: process.env.GREPRAG_API_URL || 'https://api.greprag.com',
+        apiKey: process.env.GREPRAG_API_KEY || '',
+    };
+}
+/** This CLI's installed version (bundled package.json) — stamped on every loadout
+ *  call as `x-greprag-cli-version` (docs/loadout.md §Version gating). The server
+ *  uses it to stamp the equip floor at `send` (the recipient needs ≥ the sender's
+ *  version) and to GATE `equip` (a below-floor client → 426, never a silent 500).
+ *  Null → header omitted (server falls back to its floor default). */
+function cliVersion() {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, '..', '..', 'package.json'), 'utf-8'));
+        return typeof pkg.version === 'string' ? pkg.version : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** All values for a repeatable flag (`--skill a --skill b`). */
+function getFlags(args, flag) {
+    const out = [];
+    for (let i = 0; i < args.length; i++)
+        if (args[i] === flag && i + 1 < args.length)
+            out.push(args[i + 1]);
+    return out;
+}
+function getFlag(args, flag) {
+    const idx = args.indexOf(flag);
+    return idx === -1 || idx + 1 >= args.length ? undefined : args[idx + 1];
+}
+const HELP = `greprag loadout — gift a skill bundle to another tenant (docs/loadout.md)
+
+A loadout is an OFFER, never a delivery: the recipient's operator equips it. On
+equip it copies into their load store (served by \`greprag load\`) and
+self-inflates via the Interrupt System — nothing is written to ~/.claude/skills.
+
+USAGE
+  greprag loadout send --to <handle>@greprag.com --skill <name> [--skill <n> …]
+                       [--dir <path>] [--advisor <name>] [--note "equip me"] [--line "…"]
+        Freeze + send a loadout. --skill pulls each skill from YOUR mirror store
+        (use it once so it mirrors, or pass --dir). --dir <path> snapshots a
+        skill directory straight from disk. --advisor names the router skill that
+        gets the SessionStart pointer (default: the first skill).
+
+  greprag loadout list              Offered loadouts at your front desk.
+  greprag loadout open <id>         Manifest + a bounded content preview.
+  greprag loadout equip <id>        Equip it (alias: accept).
+  greprag loadout decline <id>      Decline — GCs the snapshot.
+  greprag loadout status            Loadouts you've sent + their state.
+  greprag loadout unequip <name> [--delete-skills]
+                                    Stop a loadout's auto-inflate (optionally
+                                    delete the copied advisor skill too).`;
+async function api(method, pathname, body) {
+    const cfg = getConfig();
+    if (!cfg.apiKey) {
+        console.error('GREPRAG_API_KEY not set — run `greprag init` first.');
+        process.exit(1);
+    }
+    const headers = {
+        'Authorization': `Bearer ${cfg.apiKey}`, 'Content-Type': 'application/json',
+    };
+    const ver = cliVersion();
+    if (ver)
+        headers['x-greprag-cli-version'] = ver; // stamp the floor (send) / gate the equip
+    const res = await fetch(`${cfg.apiUrl}${pathname}`, {
+        method,
+        headers,
+        body: body === undefined ? undefined : JSON.stringify(body),
+    });
+    let data = {};
+    try {
+        data = await res.json();
+    }
+    catch { /* non-JSON */ }
+    return { ok: res.ok, status: res.status, data };
+}
+function fail(data, status) {
+    console.error(`Error${status ? ` (${status})` : ''}: ${data.error || 'request failed'}`);
+    process.exit(1);
+}
+// ---------- send --------------------------------------------------------------
+async function send(args) {
+    const to = getFlag(args, '--to');
+    if (!to) {
+        console.error('loadout send: --to <handle>@greprag.com is required');
+        process.exit(1);
+    }
+    const skills = getFlags(args, '--skill');
+    const dirs = getFlags(args, '--dir');
+    const advisor = getFlag(args, '--advisor');
+    const note = getFlag(args, '--note');
+    const line = getFlag(args, '--line');
+    // --dir: read each skill dir off disk here (the escape hatch for unmirrored skills).
+    const dirSkills = [];
+    const homeDir = process.env.HOME || process.env.USERPROFILE || '';
+    for (const d of dirs) {
+        // Accept either a path to a skill dir OR a bare skill name (resolved like the mirror).
+        const dirPath = d.includes('/') || d.includes('\\') || path.isAbsolute(d)
+            ? d : ((0, skill_landing_1.resolveSkillDir)(d, process.cwd(), homeDir) || d);
+        const files = (0, skill_mirror_client_1.collectSkillFiles)(dirPath);
+        if (!files) {
+            console.error(`loadout send: no SKILL.md under --dir "${d}" (${dirPath})`);
+            process.exit(1);
+        }
+        dirSkills.push({ name: path.basename(dirPath), files });
+    }
+    if (skills.length === 0 && dirSkills.length === 0) {
+        console.error('loadout send: pass at least one --skill <name> or --dir <path>');
+        process.exit(1);
+    }
+    const { ok, status, data } = await api('POST', '/v1/loadout/send', {
+        to, skills, dirSkills, advisor, note, line,
+    });
+    if (!ok)
+        fail(data, status);
+    const manifest = data.manifest;
+    const names = (manifest?.skills || []).map((s) => s.name).join(', ');
+    console.log(`🎒 Loadout sent to ${data.to} — id ${data.id}`);
+    console.log(`   advisor: ${data.advisor} · skills: ${names} · ${manifest?.totalBytes ?? 0} bytes`);
+    console.log(`   It's an offer — they run \`greprag loadout open ${data.id}\` then equip/decline.`);
+}
+// ---------- list / status -----------------------------------------------------
+function printLoadoutRow(l) {
+    const m = l.manifest;
+    const skills = (m?.skills || []).map((s) => s.name).join(', ');
+    const from = l.fromHandle || l.fromTenantId;
+    const note = l.note ? ` — "${l.note}"` : '';
+    console.log(`  ${l.id}  [${l.status}]  from ${from}  advisor=${l.advisor}${note}`);
+    console.log(`      skills: ${skills}`);
+}
+async function list() {
+    const { ok, status, data } = await api('GET', '/v1/loadout/inbox');
+    if (!ok)
+        fail(data, status);
+    const rows = data.loadouts || [];
+    if (rows.length === 0) {
+        console.log('No loadouts offered. (A gift lands here as a front-desk cold open.)');
+        return;
+    }
+    console.log(`\n${rows.length} loadout(s) offered — \`greprag loadout open <id>\` to review:\n`);
+    rows.forEach(printLoadoutRow);
+    console.log('');
+}
+async function status() {
+    const { ok, status: st, data } = await api('GET', '/v1/loadout/sent');
+    if (!ok)
+        fail(data, st);
+    const rows = data.loadouts || [];
+    if (rows.length === 0) {
+        console.log('You have not sent any loadouts.');
+        return;
+    }
+    console.log(`\nLoadouts you've sent:\n`);
+    for (const l of rows) {
+        const m = l.manifest;
+        const skills = (m?.skills || []).map((s) => s.name).join(', ');
+        console.log(`  ${l.id}  [${l.status}]  → ${l.toTenantId}  advisor=${l.advisor}  (${skills})`);
+    }
+    console.log('');
+}
+// ---------- open --------------------------------------------------------------
+async function open(id) {
+    if (!id) {
+        console.error('loadout open <id>');
+        process.exit(1);
+    }
+    const { ok, status, data } = await api('GET', `/v1/loadout/${encodeURIComponent(id)}`);
+    if (!ok)
+        fail(data, status);
+    const l = data.loadout;
+    const m = l.manifest;
+    console.log(`\n🎒 Loadout ${l.id}  [${l.status}]`);
+    console.log(`   from: ${l.fromHandle || l.fromTenantId}   advisor: ${l.advisor}`);
+    if (l.note)
+        console.log(`   note: "${l.note}"`);
+    console.log(`\n   Announce (self-inflates at every SessionStart once equipped):`);
+    console.log(`     ${m.announce.line}`);
+    console.log(`\n   Skills (${m.skills.length}, ${m.totalBytes} bytes total):`);
+    for (const s of m.skills) {
+        console.log(`     • ${s.name} — ${s.description || '(no description)'}`);
+        for (const f of s.files)
+            console.log(`         ${f.path} (${f.bytes} bytes)`);
+    }
+    const preview = data.preview || [];
+    if (preview.length) {
+        console.log(`\n   Preview (head of each file — never auto-ingested):`);
+        for (const p of preview) {
+            console.log(`\n   ── ${p.skill}/${p.path} ${'─'.repeat(Math.max(0, 40 - p.path.length))}`);
+            console.log(p.head.split('\n').map((ln) => `   ${ln}`).join('\n'));
+            if (p.truncated)
+                console.log('   …');
+        }
+    }
+    console.log(`\n   Equip: greprag loadout equip ${l.id}   ·   Decline: greprag loadout decline ${l.id}\n`);
+}
+// ---------- equip / decline ---------------------------------------------------
+async function equip(id, args) {
+    if (!id) {
+        console.error('loadout equip <id>');
+        process.exit(1);
+    }
+    const toSkills = args.includes('--to-skills');
+    const { ok, status, data } = await api('POST', `/v1/loadout/${encodeURIComponent(id)}/equip`, { toSkills });
+    if (!ok) {
+        // 426 Upgrade Required — this loadout needs a newer greprag than we're running.
+        // A clear, non-scary refusal (not a generic error), with the fix. The grant is
+        // left offered, so the same id equips after upgrading. docs/loadout.md §Version gating.
+        if (status === 426) {
+            const ur = data.updateRequired || {};
+            console.error(`⛔ Can't equip yet — this loadout needs greprag ≥ v${ur.needed || '?'} (you're on v${ur.current || 'unknown'}).`);
+            console.error(`   Upgrade: npm i -g greprag@latest`);
+            console.error(`   Then:    greprag loadout equip ${id}`);
+            process.exit(1);
+        }
+        fail(data, status);
+    }
+    const decl = data.equipped;
+    const copied = data.skillsCopied || [];
+    console.log(`✅ Equipped — ${copied.length} skill(s) copied to your load store: ${copied.join(', ')}`);
+    console.log(`   Auto-inflates next session:`);
+    console.log(`     ${decl.announceLine}`);
+    console.log(`   Sensor keywords (${decl.keywords.length}): ${decl.keywords.slice(0, 12).join(' · ')}${decl.keywords.length > 12 ? ' …' : ''}`);
+    console.log(`   Load it now: greprag load ${decl.advisor}`);
+}
+async function decline(id) {
+    if (!id) {
+        console.error('loadout decline <id>');
+        process.exit(1);
+    }
+    const { ok, status, data } = await api('POST', `/v1/loadout/${encodeURIComponent(id)}/decline`);
+    if (!ok)
+        fail(data, status);
+    console.log(`Declined loadout ${id} — its snapshot was discarded.`);
+}
+// ---------- unequip -----------------------------------------------------------
+async function unequip(name, args) {
+    if (!name) {
+        console.error('loadout unequip <name>');
+        process.exit(1);
+    }
+    const deleteSkills = args.includes('--delete-skills');
+    const { ok, status, data } = await api('POST', '/v1/loadout/unequip', { name, deleteSkills });
+    if (!ok)
+        fail(data, status);
+    console.log(`Unequipped "${name}" — the auto-inflate pointer is removed.${deleteSkills ? ' Advisor skill copy deleted.' : ''}`);
+}
+async function runLoadout(args) {
+    const sub = args[0];
+    const rest = args.slice(1);
+    switch (sub) {
+        case 'send': return send(rest);
+        case 'list': return list();
+        case 'status': return status();
+        case 'open': return open(rest[0]);
+        case 'equip':
+        case 'accept': return equip(rest[0], rest);
+        case 'decline': return decline(rest[0]);
+        case 'unequip': return unequip(rest[0], rest);
+        default:
+            console.log(HELP);
+            return;
+    }
+}
+//# sourceMappingURL=loadout.js.map

package/dist/commands/loadout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadout.js","sourceRoot":"","sources":["../../src/commands/loadout.ts"],"names":[],"mappings":"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"}

package/dist/commands/reminder-registry.js

@@ -25,6 +25,7 @@ const enrichment_health_reminder_1 = require("./enrichment-health-reminder");
 const skill_gain_reminder_1 = require("./skill-gain-reminder");
 const skill_mirror_reminder_1 = require("./skill-mirror-reminder");
 const procedure_reminder_1 = require("./procedure-reminder");
+const loadout_reminder_1 = require("./loadout-reminder");
 /** Registry order = display order. THE single agent-facing announce/reminder assembly:
  *  the hook does I/O → fills ReminderEnv → collectAnnounces (SessionStart) / collectReminders
  *  (per turn) render every module here in this order. Order preserves the historical recap
@@ -41,6 +42,7 @@ exports.REGISTRY = [
     skill_gain_reminder_1.skillGainAnnounceModule, // announce-only skill-gain landings (docs/skill-learning-loop.md)
     skill_mirror_reminder_1.skillMirrorAnnounceModule, // one-line Tier-3 pointer: your skills travel via greprag load (docs/load-system.md)
     procedure_reminder_1.procedureAnnounceModule, // active project procedures, rendered generically from operator-owned installs
+    loadout_reminder_1.loadoutRegistrarModule, // equipped loadouts: one advisor announce each + per-turn keyword Match (docs/loadout.md)
     setup_reminder_1.setupWarningModule,
     version_reminder_1.versionUpgradeModule, // Deficiency-gated announce — silent unless a newer release exists
     enrichment_health_reminder_1.enrichmentHealthModule, // Deficiency-gated announce — silent unless the Gemini probe fails (fix c2eb8777)

package/dist/commands/reminder-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"reminder-registry.js","sourceRoot":"","sources":["../../src/commands/reminder-registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"reminder-registry.js","sourceRoot":"","sources":["../../src/commands/reminder-registry.ts"],"names":[],"mappings":"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"}

package/dist/commands/reminder-types.d.ts

@@ -52,6 +52,18 @@ export interface ReminderEnv {
         current: string;
         latest: string;
     } | null;
+    /** Deficiency-gated announce signal (docs/loadout.md §Version gating): a PENDING
+     *  loadout requires a NEWER greprag than installed — the recipient can't equip it
+     *  until they upgrade. Set by the hook (SessionStart pending-loadout summaries vs
+     *  the bundled package.json version; picks the highest-floor pending loadout so
+     *  one upgrade satisfies all). null/undefined when no pending loadout is above the
+     *  installed floor. Drives the CONTEXTUALIZED version-upgrade announce — names the
+     *  waiting loadout + the required version. Auto-clears on upgrade (Deficiency). */
+    loadoutUpdateRequired?: {
+        from: string;
+        needed: string;
+        current: string;
+    } | null;
     /** Names of the api-docs-tagged corpus stores (the hook lists `?tag=api-docs`).
      *  Drives the corpus announce: name the on-tap reference banks so an agent
      *  searches them before answering from training data. Empty/undefined → the
@@ -98,10 +110,27 @@ export interface ReminderEnv {
      *  reads the operator-owned procedure store; one generic announce module
      *  renders them. adr/procedure-install-control-plane.md */
     procedureAnnounces?: string[];
+    /** Equipped loadouts (docs/loadout.md, adr/loadout.md) — the recipient's
+     *  self-inflating skill bundles. The hook fetches /v1/loadout/equipped at
+     *  SessionStart (→ the ONE advisor announce line each) AND caches them locally
+     *  so the per-turn read is network-free (→ the Match keyword sensor). Each
+     *  decl is inert DATA (the pointer line + derived keywords), never code.
+     *  Empty/undefined → the loadout-registrar module stays silent. */
+    equippedLoadouts?: Array<{
+        name: string;
+        advisor: string;
+        announceLine: string;
+        keywords: string[];
+    }>;
     /** Auto-surfaced episodic-memory injection — the hook owns the recall-intent gate +
      *  the search + the confidence gate + framing; the memory-reflex module routes the
      *  framed string as its per-turn reminder. Null = nothing cleared the gate this turn. */
     memoryHit?: string | null;
+    /** The user's prompt text (the `prompt` read surface for a Match trigger —
+     *  docs/reminder-interrupt.md, the landed map). Present only on the per-turn
+     *  UserPromptSubmit env; undefined at SessionStart/PreToolUse. The loadout
+     *  keyword sensor is its first live consumer (the `prompt` source had none). */
+    promptText?: string | null;
     /** The Bash command about to run (the `command` read surface for a Match trigger).
      *  Present only on the PreToolUse env; undefined at UserPromptSubmit. */
     toolCommand?: string | null;

package/dist/commands/version-reminder.d.ts

@@ -8,8 +8,20 @@
  *  NOT a new announce kind: it is a primer gated by Deficiency, exactly like setup-warning
  *  (which announces only when there's a drift gap). The hook does the I/O (the daily-cached
  *  npm-registry version check) and passes the verdict as env.updateAvailable; this module
- *  is PURE — announce-only (detect → silent, reminder → null). */
+ *  is PURE — announce-only (detect → silent, reminder → null).
+ *
+ *  Two Deficiency signals, one module (docs/loadout.md §Version gating step 4):
+ *    - env.loadoutUpdateRequired — a PENDING loadout needs a newer greprag than
+ *      installed. Takes precedence + NAMES the waiting loadout (the actionable case:
+ *      "upgrade to equip the gift"). Independent of the npm check, so it fires even
+ *      offline whenever a pending floor is above the installed version.
+ *    - env.updateAvailable — the generic "behind latest published" nudge (fallback). */
 import { ReminderModule } from './reminder-types';
 /** The upgrade announce — null unless the hook detected a newer published version. */
 export declare function buildVersionAnnounce(current: string, latest: string): string;
+/** The CONTEXTUALIZED upgrade announce: a pending loadout is waiting but needs a
+ *  newer greprag to equip. Names the sender + the required floor so the deficiency
+ *  is actionable, not generic. Auto-clears once the installed version reaches the
+ *  floor (the hook stops setting the signal). docs/loadout.md §Version gating. */
+export declare function buildLoadoutUpdateAnnounce(from: string, needed: string, current: string): string;
 export declare const versionUpgradeModule: ReminderModule;

package/dist/commands/version-reminder.js

@@ -9,10 +9,18 @@
  *  NOT a new announce kind: it is a primer gated by Deficiency, exactly like setup-warning
  *  (which announces only when there's a drift gap). The hook does the I/O (the daily-cached
  *  npm-registry version check) and passes the verdict as env.updateAvailable; this module
- *  is PURE — announce-only (detect → silent, reminder → null). */
+ *  is PURE — announce-only (detect → silent, reminder → null).
+ *
+ *  Two Deficiency signals, one module (docs/loadout.md §Version gating step 4):
+ *    - env.loadoutUpdateRequired — a PENDING loadout needs a newer greprag than
+ *      installed. Takes precedence + NAMES the waiting loadout (the actionable case:
+ *      "upgrade to equip the gift"). Independent of the npm check, so it fires even
+ *      offline whenever a pending floor is above the installed version.
+ *    - env.updateAvailable — the generic "behind latest published" nudge (fallback). */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.versionUpgradeModule = void 0;
 exports.buildVersionAnnounce = buildVersionAnnounce;
+exports.buildLoadoutUpdateAnnounce = buildLoadoutUpdateAnnounce;
 /** The upgrade announce — null unless the hook detected a newer published version. */
 function buildVersionAnnounce(current, latest) {
     return [
@@ -20,10 +28,25 @@ function buildVersionAnnounce(current, latest) {
         `Upgrade: \`npm i -g greprag@latest\`. New behavior + fixes land on your next session.`,
     ].join('\n');
 }
+/** The CONTEXTUALIZED upgrade announce: a pending loadout is waiting but needs a
+ *  newer greprag to equip. Names the sender + the required floor so the deficiency
+ *  is actionable, not generic. Auto-clears once the installed version reaches the
+ *  floor (the hook stops setting the signal). docs/loadout.md §Version gating. */
+function buildLoadoutUpdateAnnounce(from, needed, current) {
+    return [
+        `[greprag — 📦 a loadout from ${from} is waiting, but it needs a newer greprag to equip.]`,
+        `It requires greprag ≥ v${needed} (you are on v${current}).`,
+        `Upgrade: \`npm i -g greprag@latest\`, then \`greprag loadout list\` to equip it.`,
+    ].join('\n');
+}
 exports.versionUpgradeModule = {
     id: 'version-upgrade',
     detect: (_env) => ({ tier: 'silent' }), // announce-only
     announce: (env) => {
+        // A waiting loadout that needs an upgrade wins — it names the reason (step 4).
+        const lo = env.loadoutUpdateRequired;
+        if (lo && lo.needed && lo.current)
+            return buildLoadoutUpdateAnnounce(lo.from, lo.needed, lo.current);
         const u = env.updateAvailable;
         if (!u || !u.current || !u.latest)
             return null;

package/dist/commands/version-reminder.js.map

@@ -1 +1 @@
-{"version":3,"file":"version-reminder.js","sourceRoot":"","sources":["../../src/commands/version-reminder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;kEAUkE;;;AAKlE,oDAKC;AAND,sFAAsF;AACtF,SAAgB,oBAAoB,CAAC,OAAe,EAAE,MAAc;IAClE,OAAO;QACL,qCAAqC,MAAM,iBAAiB,OAAO,KAAK;QACxE,uFAAuF;KACxF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAEY,QAAA,oBAAoB,GAAmB;IAClD,EAAE,EAAE,iBAAiB;IACrB,MAAM,EAAE,CAAC,IAAiB,EAAa,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,gBAAgB;IAChF,QAAQ,EAAE,CAAC,GAAgB,EAAiB,EAAE;QAC5C,MAAM,CAAC,GAAG,GAAG,CAAC,eAAe,CAAC;QAC9B,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAC/C,OAAO,oBAAoB,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;IACD,QAAQ,EAAE,GAAkB,EAAE,CAAC,IAAI;CACpC,CAAC"}
+{"version":3,"file":"version-reminder.js","sourceRoot":"","sources":["../../src/commands/version-reminder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;wFAiBwF;;;AAKxF,oDAKC;AAMD,gEAMC;AAlBD,sFAAsF;AACtF,SAAgB,oBAAoB,CAAC,OAAe,EAAE,MAAc;IAClE,OAAO;QACL,qCAAqC,MAAM,iBAAiB,OAAO,KAAK;QACxE,uFAAuF;KACxF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;kFAGkF;AAClF,SAAgB,0BAA0B,CAAC,IAAY,EAAE,MAAc,EAAE,OAAe;IACtF,OAAO;QACL,gCAAgC,IAAI,sDAAsD;QAC1F,0BAA0B,MAAM,iBAAiB,OAAO,IAAI;QAC5D,kFAAkF;KACnF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAEY,QAAA,oBAAoB,GAAmB;IAClD,EAAE,EAAE,iBAAiB;IACrB,MAAM,EAAE,CAAC,IAAiB,EAAa,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,gBAAgB;IAChF,QAAQ,EAAE,CAAC,GAAgB,EAAiB,EAAE;QAC5C,+EAA+E;QAC/E,MAAM,EAAE,GAAG,GAAG,CAAC,qBAAqB,CAAC;QACrC,IAAI,EAAE,IAAI,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,OAAO;YAAE,OAAO,0BAA0B,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;QACrG,MAAM,CAAC,GAAG,GAAG,CAAC,eAAe,CAAC;QAC9B,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAC/C,OAAO,oBAAoB,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;IACD,QAAQ,EAAE,GAAkB,EAAE,CAAC,IAAI;CACpC,CAAC"}