greprag 5.49.15 → 5.50.0

package/dist/procedure.js

@@ -0,0 +1,269 @@
+"use strict";
+/** Procedure System — pure core + local store (docs/procedure-system.md).
+ *
+ *  A *procedure* is the repo-specific recipe behind an operational intent
+ *  (deploy / push / release / commit / merge). The system's job: when the user
+ *  asks for one, inject the known recipe + its gate BEFORE the agent moves, so
+ *  the operational verb runs cleanly instead of by trial-and-error.
+ *
+ *  This module is the PROOF slice — Tier 1 (deterministic keyword trigger) +
+ *  REPLAY (inject a seeded/learned recipe). It is intentionally local-file
+ *  backed, mirroring guard.ts's matchset cache: the UserPromptSubmit hook reads
+ *  it on the hot path, so there is NO network here (server persistence + the
+ *  LEARN/Stop-hook capture leg land later — docs/procedure-system.md phases).
+ *
+ *  Pure (matchProcedure / buildProcedureInjection / GIT_SEED_SET) is split from
+ *  the I/O (read/writeProcedureStore) so the matcher + injection text are
+ *  testable without touching disk — the coordinate-gate.ts shape.
+ */
+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.GIT_SEED_SET = exports.PROCEDURE_STORE_VERSION = void 0;
+exports.procedureStorePath = procedureStorePath;
+exports.readProcedureStore = readProcedureStore;
+exports.writeProcedureStore = writeProcedureStore;
+exports.upsertProcedure = upsertProcedure;
+exports.removeProcedure = removeProcedure;
+exports.intentSuppressed = intentSuppressed;
+exports.matchProcedure = matchProcedure;
+exports.buildProcedureInjection = buildProcedureInjection;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+exports.PROCEDURE_STORE_VERSION = '1';
+// ---------- Store I/O (local, hot-path) --------------------------------------
+function stateDir() {
+    const home = process.env.HOME || process.env.USERPROFILE || '';
+    return path.join(home, '.greprag', 'state');
+}
+/** Beside the matchset cache (guard.ts), keyed by project_id so it survives
+ *  renames/worktrees and stays per-project. */
+function procedureStorePath(projectId) {
+    return path.join(stateDir(), `procedures-${projectId}.json`);
+}
+/** Read the project's procedure store. Returns an empty store on any miss —
+ *  fail-open, so a read error never blocks the hot path. */
+function readProcedureStore(projectId) {
+    try {
+        const raw = fs.readFileSync(procedureStorePath(projectId), 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (parsed && Array.isArray(parsed.procedures)) {
+            return { version: parsed.version || exports.PROCEDURE_STORE_VERSION, procedures: parsed.procedures };
+        }
+    }
+    catch { /* missing / unreadable → empty */ }
+    return { version: exports.PROCEDURE_STORE_VERSION, procedures: [] };
+}
+function writeProcedureStore(projectId, store) {
+    const file = procedureStorePath(projectId);
+    const dir = path.dirname(file);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(file, JSON.stringify(store, null, 2) + '\n');
+}
+/** Insert-or-replace by verb. Destructive existing procedures are NOT silently
+ *  downgraded: a learned/auto write can't overwrite a destructive=true seed
+ *  (callers pass `force` for an explicit operator re-seed). Returns the store. */
+function upsertProcedure(store, proc, force = false) {
+    const existing = store.procedures.find(p => p.verb === proc.verb);
+    if (existing && existing.destructive && !force && proc.status !== 'seeded') {
+        return store; // protect the gate — never auto-overwrite a destructive seed
+    }
+    const next = store.procedures.filter(p => p.verb !== proc.verb);
+    next.push({ ...proc, updatedAt: proc.updatedAt || new Date().toISOString() });
+    return { version: store.version || exports.PROCEDURE_STORE_VERSION, procedures: next };
+}
+function removeProcedure(store, verb) {
+    return {
+        version: store.version || exports.PROCEDURE_STORE_VERSION,
+        procedures: store.procedures.filter(p => p.verb !== verb),
+    };
+}
+// ---------- Matching (PURE) --------------------------------------------------
+/** Does a trigger phrase occur in the (lowercased) prompt? Single tokens match
+ *  whole-word (`deploy` ≠ `redeployment`); multi-word phrases match as a
+ *  substring (`ship it`). */
+function triggerHits(promptLower, triggerLower) {
+    if (!triggerLower)
+        return false;
+    if (/\s/.test(triggerLower))
+        return promptLower.includes(triggerLower);
+    const re = new RegExp(`(^|[^a-z0-9])${escapeRegex(triggerLower)}([^a-z0-9]|$)`);
+    return re.test(promptLower);
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+// ---------- Intent guard (PURE) ----------------------------------------------
+/** Tier-1 intent guard — cheap, deterministic suppression of keyword
+ *  false-fires. A substring match injects on a *mention*, not a *request*
+ *  (docs/procedure-system.md): bare "deploy" fires on "don't deploy yet" and
+ *  "push" on "push back the deadline". For safe verbs that's noise; for a
+ *  destructive verb a false ⛔ gate is actively misleading. Suppresses two
+ *  classes — this is the deterministic stopgap; Tier-2's prompt-judge replaces
+ *  it with real intent recognition. */
+const INTENT_NEGATIONS = [
+    "don't", 'dont', 'not', 'no', 'never', 'without', 'avoid', "won't", 'wont',
+    "didn't", 'didnt', 'cannot', "can't", 'cant', 'stop',
+];
+/** The trigger token living inside a common NON-command phrase. */
+const INTENT_COLLISION_PHRASES = [
+    'push back', 'push for', 'push notification', 'push notifications', 'pushover',
+    'merge conflict', 'merge conflicts', 'merge request', 'merge sort',
+    'press release', 'release notes', 'release candidate', 'release date',
+    'commit message', 'commit hash', 'commit history', 'commit sha',
+];
+/** True if a raw trigger hit should be SUPPRESSED — it reads as a mention, not
+ *  a request. PURE. (1) the trigger only appears inside a collision phrase;
+ *  (2) a negation sits within 3 tokens before the trigger. */
+function intentSuppressed(promptLower, triggerLower) {
+    // (1) collision phrase — suppress only if the trigger has NO other occurrence
+    //     outside the collision phrase (a real command alongside the mention wins).
+    for (const phrase of INTENT_COLLISION_PHRASES) {
+        if (phrase.includes(triggerLower) && promptLower.includes(phrase)) {
+            const stripped = promptLower.split(phrase).join(' · ');
+            if (!triggerHits(stripped, triggerLower))
+                return true;
+        }
+    }
+    // (2) negation within 3 tokens before the trigger ("don't deploy", "no merge").
+    const idx = promptLower.search(new RegExp(`(^|[^a-z0-9])${escapeRegex(triggerLower)}([^a-z0-9]|$)`));
+    if (idx >= 0) {
+        const before = promptLower.slice(0, idx).split(/[^a-z']+/).filter(Boolean);
+        const window = ' ' + before.slice(-3).join(' ') + ' ';
+        if (INTENT_NEGATIONS.some(neg => window.includes(' ' + neg + ' ')))
+            return true;
+    }
+    return false;
+}
+/** Match a user prompt against the store. Returns the procedure whose
+ *  LONGEST trigger phrase hits (most-specific wins — `git push` beats `push`,
+ *  `ship a release` beats `ship`), or null. PURE — no I/O. The Tier-1 intent
+ *  guard filters mention-not-request hits unless `ignoreIntentGuard` is set
+ *  (the `match` dry-run uses it to explain a suppression). */
+function matchProcedure(prompt, store, opts = {}) {
+    if (!prompt)
+        return null;
+    const promptLower = prompt.toLowerCase();
+    let best = null;
+    let bestLen = -1;
+    for (const procedure of store.procedures) {
+        for (const trigger of procedure.triggers) {
+            const t = trigger.toLowerCase();
+            if (!triggerHits(promptLower, t))
+                continue;
+            if (!opts.ignoreIntentGuard && intentSuppressed(promptLower, t))
+                continue;
+            if (t.length > bestLen) {
+                best = { procedure, trigger };
+                bestLen = t.length;
+            }
+        }
+    }
+    return best;
+}
+// ---------- Injection text (PURE) --------------------------------------------
+/** The additionalContext block injected at UserPromptSubmit when a procedure
+ *  matches. Leads with the gate for destructive verbs (the guardrail is the
+ *  point); otherwise leads with the steps. Bounded + labeled so the agent reads
+ *  it as a known recipe, not a new instruction to reason about. */
+function buildProcedureInjection(proc) {
+    const lines = [];
+    const tag = proc.destructive ? ' ⚠ DESTRUCTIVE' : '';
+    lines.push(`[Procedure: ${proc.verb} — ${proc.status}${tag}] This repo has a known recipe for "${proc.verb}".`);
+    if (proc.destructive && proc.caveats) {
+        lines.push(`  ⛔ GATE: ${proc.caveats}`);
+        lines.push(`  STEPS (only after approval): ${proc.steps}`);
+    }
+    else {
+        lines.push(`  STEPS: ${proc.steps}`);
+        if (proc.caveats)
+            lines.push(`  GATE: ${proc.caveats}`);
+    }
+    if (proc.endpoint)
+        lines.push(`  ENDPOINT (done when): ${proc.endpoint}`);
+    lines.push(proc.destructive
+        ? `  Follow the gate exactly. Never run the steps without a fresh approval this turn.`
+        : `  Use this recipe. If it no longer works, say so — that's a stale procedure to re-learn.`);
+    return lines.join('\n');
+}
+// ---------- The git-ecosystem seed set ---------------------------------------
+/** The five operational verbs Travis conflates, encoded with their real recipes
+ *  + gates (docs/procedure-system.md). The deliberate contradiction —
+ *  deploy = don't-ask, push = always-ask — is exactly what trips a learning
+ *  dev; both gates ship on day one. `push` is destructive → seed-only. */
+exports.GIT_SEED_SET = [
+    {
+        verb: 'commit',
+        triggers: ['commit', 'check in', 'check it in', 'checkpoint this', 'land it'],
+        steps: 'git add -A && git commit -m "wip: <msg>"; then merge the feature branch into the default branch, prune the worktree, delete the merged branch (the /commit flow).',
+        caveats: 'Scope = only MY work — never sweep a parallel workstream\'s pending changes. STOPS before push.',
+        endpoint: 'changes committed and the feature branch merged into default',
+        status: 'seeded',
+    },
+    {
+        verb: 'merge',
+        triggers: ['merge', 'merge the branch', 'merge to main', 'merge into main'],
+        steps: 'git checkout <default> && git merge <branch> (folded into the commit flow).',
+        caveats: 'Another session live in this repo? Coordinate with the peer before merging shared state.',
+        endpoint: 'branch merged into the default branch with no conflicts',
+        status: 'seeded',
+    },
+    {
+        verb: 'push',
+        triggers: ['push', 'git push', 'push to remote', 'push it up', 'push upstream'],
+        steps: 'git push',
+        caveats: 'git push triggers a PRODUCTION deploy. STOP and get explicit fresh approval before pushing — never push without a fresh "yes" this turn.',
+        endpoint: 'operator approved the push AND it completed',
+        status: 'seeded',
+        destructive: true,
+    },
+    {
+        verb: 'deploy',
+        triggers: ['deploy', 'deploy the api', 'deploy the worker', 'redeploy'],
+        steps: 'cd packages/api && npm run deploy',
+        caveats: 'Routine — after a core fix + commit, run this WITHOUT asking. This is the wrangler deploy of the API worker; it is NOT a git push.',
+        endpoint: 'wrangler prints the published worker version (deploy success output)',
+        status: 'seeded',
+    },
+    {
+        verb: 'release',
+        triggers: ['release', 'ship it', 'ship a release', 'cut a release', 'publish the release', 'do a release'],
+        steps: 'Run the /release flow — greprag\'s actual ship path (version bump + publish).',
+        caveats: 'greprag ships via /release — NOT /commit and NOT /deploy. Do not conflate the three: commit lands code, deploy pushes the worker, release publishes a version.',
+        endpoint: 'the release is published (new version live)',
+        status: 'seeded',
+    },
+];
+//# sourceMappingURL=procedure.js.map

package/dist/procedure.js.map

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

package/dist/skill-landing.d.ts

@@ -0,0 +1,88 @@
+/** Skill-gain landing — the Skill Learning Loop's write-back half
+ *  (docs/skill-learning-loop.md §fuse shape, operator-ratified 2026-07-01).
+ *
+ *  THE SHAPE (Tony Stark's briefcase suit): the server-side distiller packaged
+ *  each gain as a focused doc + a blind one-liner. This leg — pure code, never
+ *  agent voluntarism (the skill-tuning autopsy's law) — lands both files:
+ *
+ *    docs/learned/<slug>.md   the laser-focused learning doc
+ *    SKILL.md (EOF)           one FUSE line: the one-liner + the schematic
+ *                             telling the NEXT invocation exactly what to do —
+ *                             expand the doc, fold it in where it belongs,
+ *                             delete the fuse and the doc.
+ *
+ *  The fuse is self-applying because it loads WITH the skill: the next agent
+ *  to invoke the skill reads it as part of the skill's own instructions, does
+ *  the short tune with the whole skill in context (the only actor that ever
+ *  legitimately has it), and the skill converges clean. If a run skips the
+ *  tune, the fuse persists as ordinary progressive disclosure — the learning
+ *  stays live either way (graceful degradation, no failure mode).
+ *
+ *  Guards: CAP 3 undigested fuses per skill (overflow waits server-side —
+ *  a skill drowning in briefcases isn't being used anyway); every artifact
+ *  stamped `skillgain:<id>`; `greprag skillgain reject <id>` is the undo
+ *  (removes fuse + doc). Landing routes through resolveSkillDir — the ONE
+ *  seam that swaps to the greprag-load skill store when skills move into the
+ *  CLI (the no-SKILL.md endgame).
+ *
+ *  Write-target routing (the trap): greprag's bundled skills publish from the
+ *  repo source (packages/cli/skill/<name>/) — ~/.claude/skills/<name>/ is an
+ *  init-overwritten artifact. Bundled + repo present → repo source; otherwise
+ *  the global skills dir; neither → the gain stays pending. */
+export interface PendingSkillGain {
+    nodeId: string;
+    skill: string;
+    gainType: 'rule' | 'scope' | 'reference';
+    text: string;
+    oneLiner?: string;
+    docSlug?: string;
+    docBody?: string;
+}
+/** Skills that ship FROM the greprag repo — their canonical source is
+ *  packages/cli/skill/<name>/; the installed copy is overwritten at init. */
+export declare const BUNDLED_SKILLS: string[];
+export declare const LEARNED_DIR_RELPATH: string;
+/** v1 legacy zone — reject still scans it for stamps landed before the recut. */
+export declare const LEARNINGS_RELPATH: string;
+/** Max undigested fuse lines a SKILL.md may carry; past this, new gains wait
+ *  server-side. Operator-ratified (2026-07-01). */
+export declare const MAX_FUSES_PER_SKILL = 3;
+/** Resolve the canonical directory for a skill. `existsFn` injectable for
+ *  tests. Order: bundled repo source (when cwd IS the greprag repo) → global
+ *  skills dir → null (defer). THE storage seam — the greprag-load skill-store
+ *  backend replaces this resolution, nothing above it. */
+export declare function resolveSkillDir(skill: string, cwd: string, homeDir: string, existsFn?: (p: string) => boolean): string | null;
+export declare function hasGainStamp(content: string, nodeId: string): boolean;
+/** Count undigested fuse lines in a SKILL.md body (digested ones were deleted
+ *  by the tune, so the count self-heals as briefcases get absorbed). PURE. */
+export declare function countFuses(skillMdContent: string): number;
+/** The fuse line — the briefcase's button. One line, blind (the one-liner
+ *  names the learning; the mass lives in the doc), carrying the exact
+ *  schematic for the next invocation. PURE — unit-tested. */
+export declare function buildFuseLine(gain: PendingSkillGain, docRelPath: string, projectName: string, dateISO: string): string;
+export type LandOutcome = 'landed' | 'already-landed' | 'capped' | 'deferred';
+/** Land ONE briefcase: write the learned doc + append the fuse to SKILL.md.
+ *  Deterministic file work only — never throws (failure defers the gain). */
+export declare function landBriefcase(gain: PendingSkillGain, cwd: string, homeDir: string, projectName: string): LandOutcome;
+/** Remove a gain's artifacts wherever they landed — the `skillgain reject`
+ *  undo: the fuse line (SKILL.md), the learned doc, and any v1-legacy
+ *  learnings.md line. Returns true if anything was removed. Never throws. */
+export declare function removeLandedGain(skill: string, nodeId: string, cwd: string, homeDir: string): boolean;
+export interface SkillGainLandingReport {
+    /** Briefcases landed this session start (for the informational announce). */
+    landed: Array<{
+        nodeId: string;
+        skill: string;
+        oneLiner: string;
+    }>;
+}
+/** The full landing pass. Every gain with a payload lands as a briefcase
+ *  (capped per skill + per start); payload-less/unroutable gains stay pending.
+ *  Returns the report (announce) + the status updates to POST back. */
+export declare function landPendingGains(pending: PendingSkillGain[], cwd: string, homeDir: string, projectName: string): {
+    report: SkillGainLandingReport;
+    statusUpdates: Array<{
+        nodeId: string;
+        status: 'landed';
+    }>;
+};

package/dist/skill-landing.js

@@ -0,0 +1,220 @@
+"use strict";
+/** Skill-gain landing — the Skill Learning Loop's write-back half
+ *  (docs/skill-learning-loop.md §fuse shape, operator-ratified 2026-07-01).
+ *
+ *  THE SHAPE (Tony Stark's briefcase suit): the server-side distiller packaged
+ *  each gain as a focused doc + a blind one-liner. This leg — pure code, never
+ *  agent voluntarism (the skill-tuning autopsy's law) — lands both files:
+ *
+ *    docs/learned/<slug>.md   the laser-focused learning doc
+ *    SKILL.md (EOF)           one FUSE line: the one-liner + the schematic
+ *                             telling the NEXT invocation exactly what to do —
+ *                             expand the doc, fold it in where it belongs,
+ *                             delete the fuse and the doc.
+ *
+ *  The fuse is self-applying because it loads WITH the skill: the next agent
+ *  to invoke the skill reads it as part of the skill's own instructions, does
+ *  the short tune with the whole skill in context (the only actor that ever
+ *  legitimately has it), and the skill converges clean. If a run skips the
+ *  tune, the fuse persists as ordinary progressive disclosure — the learning
+ *  stays live either way (graceful degradation, no failure mode).
+ *
+ *  Guards: CAP 3 undigested fuses per skill (overflow waits server-side —
+ *  a skill drowning in briefcases isn't being used anyway); every artifact
+ *  stamped `skillgain:<id>`; `greprag skillgain reject <id>` is the undo
+ *  (removes fuse + doc). Landing routes through resolveSkillDir — the ONE
+ *  seam that swaps to the greprag-load skill store when skills move into the
+ *  CLI (the no-SKILL.md endgame).
+ *
+ *  Write-target routing (the trap): greprag's bundled skills publish from the
+ *  repo source (packages/cli/skill/<name>/) — ~/.claude/skills/<name>/ is an
+ *  init-overwritten artifact. Bundled + repo present → repo source; otherwise
+ *  the global skills dir; neither → the gain stays pending. */
+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.MAX_FUSES_PER_SKILL = exports.LEARNINGS_RELPATH = exports.LEARNED_DIR_RELPATH = exports.BUNDLED_SKILLS = void 0;
+exports.resolveSkillDir = resolveSkillDir;
+exports.hasGainStamp = hasGainStamp;
+exports.countFuses = countFuses;
+exports.buildFuseLine = buildFuseLine;
+exports.landBriefcase = landBriefcase;
+exports.removeLandedGain = removeLandedGain;
+exports.landPendingGains = landPendingGains;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+/** Skills that ship FROM the greprag repo — their canonical source is
+ *  packages/cli/skill/<name>/; the installed copy is overwritten at init. */
+exports.BUNDLED_SKILLS = ['greprag', 'commander', 'content-advisor', 'mechanic'];
+exports.LEARNED_DIR_RELPATH = path.join('docs', 'learned');
+/** v1 legacy zone — reject still scans it for stamps landed before the recut. */
+exports.LEARNINGS_RELPATH = path.join('docs', 'learnings.md');
+/** Max undigested fuse lines a SKILL.md may carry; past this, new gains wait
+ *  server-side. Operator-ratified (2026-07-01). */
+exports.MAX_FUSES_PER_SKILL = 3;
+/** Resolve the canonical directory for a skill. `existsFn` injectable for
+ *  tests. Order: bundled repo source (when cwd IS the greprag repo) → global
+ *  skills dir → null (defer). THE storage seam — the greprag-load skill-store
+ *  backend replaces this resolution, nothing above it. */
+function resolveSkillDir(skill, cwd, homeDir, existsFn = fs.existsSync) {
+    if (!/^[A-Za-z0-9._-]+$/.test(skill))
+        return null; // path-safe names only
+    if (exports.BUNDLED_SKILLS.includes(skill)) {
+        const repoSrc = path.join(cwd, 'packages', 'cli', 'skill', skill);
+        if (existsFn(repoSrc))
+            return repoSrc;
+    }
+    const global = path.join(homeDir, '.claude', 'skills', skill);
+    if (existsFn(global))
+        return global;
+    return null;
+}
+function hasGainStamp(content, nodeId) {
+    return content.includes(`skillgain:${nodeId}`);
+}
+/** Count undigested fuse lines in a SKILL.md body (digested ones were deleted
+ *  by the tune, so the count self-heals as briefcases get absorbed). PURE. */
+function countFuses(skillMdContent) {
+    return (skillMdContent.match(/<!-- skillgain:[0-9a-f]{8}/g) || []).length;
+}
+/** The fuse line — the briefcase's button. One line, blind (the one-liner
+ *  names the learning; the mass lives in the doc), carrying the exact
+ *  schematic for the next invocation. PURE — unit-tested. */
+function buildFuseLine(gain, docRelPath, projectName, dateISO) {
+    return (`⚙ SKILL UPDATE PENDING (${gain.gainType}) — ${gain.oneLiner} `
+        + `→ BEFORE working: read ${docRelPath.replace(/\\/g, '/')}, fold the learning into this `
+        + `skill where it belongs (one small edit, keep it lean), then DELETE this line and the doc. `
+        + `Bogus? \`greprag skillgain reject ${gain.nodeId}\` instead. `
+        + `<!-- skillgain:${gain.nodeId} ${dateISO.slice(0, 10)} project:${projectName} -->`);
+}
+/** Land ONE briefcase: write the learned doc + append the fuse to SKILL.md.
+ *  Deterministic file work only — never throws (failure defers the gain). */
+function landBriefcase(gain, cwd, homeDir, projectName) {
+    try {
+        if (!gain.oneLiner || !gain.docSlug || !gain.docBody)
+            return 'deferred'; // payload-less legacy row
+        const dir = resolveSkillDir(gain.skill, cwd, homeDir);
+        if (!dir)
+            return 'deferred';
+        const skillMd = path.join(dir, 'SKILL.md');
+        let body;
+        try {
+            body = fs.readFileSync(skillMd, 'utf-8');
+        }
+        catch {
+            return 'deferred';
+        }
+        if (hasGainStamp(body, gain.nodeId))
+            return 'already-landed';
+        if (countFuses(body) >= exports.MAX_FUSES_PER_SKILL)
+            return 'capped';
+        // Doc first (a fuse pointing at a missing doc is the one broken state).
+        const docRel = path.join(exports.LEARNED_DIR_RELPATH, `${gain.docSlug}.md`);
+        const docAbs = path.join(dir, docRel);
+        fs.mkdirSync(path.dirname(docAbs), { recursive: true });
+        fs.writeFileSync(docAbs, gain.docBody.trimEnd()
+            + `\n\n<!-- skillgain:${gain.nodeId} — auto-landed by the Skill Learning Loop; deleted when digested -->\n`);
+        const fuse = buildFuseLine(gain, docRel, projectName, new Date().toISOString());
+        fs.writeFileSync(skillMd, body + (body.endsWith('\n') ? '' : '\n') + fuse + '\n');
+        return 'landed';
+    }
+    catch {
+        return 'deferred';
+    }
+}
+/** Remove a gain's artifacts wherever they landed — the `skillgain reject`
+ *  undo: the fuse line (SKILL.md), the learned doc, and any v1-legacy
+ *  learnings.md line. Returns true if anything was removed. Never throws. */
+function removeLandedGain(skill, nodeId, cwd, homeDir) {
+    try {
+        const dir = resolveSkillDir(skill, cwd, homeDir);
+        if (!dir)
+            return false;
+        let removed = false;
+        for (const file of [path.join(dir, 'SKILL.md'), path.join(dir, exports.LEARNINGS_RELPATH)]) {
+            try {
+                const content = fs.readFileSync(file, 'utf-8');
+                if (!hasGainStamp(content, nodeId))
+                    continue;
+                fs.writeFileSync(file, content.split('\n')
+                    .filter(line => !line.includes(`skillgain:${nodeId}`)).join('\n'));
+                removed = true;
+            }
+            catch { /* file absent — fine */ }
+        }
+        const learnedDir = path.join(dir, exports.LEARNED_DIR_RELPATH);
+        try {
+            for (const f of fs.readdirSync(learnedDir)) {
+                const p = path.join(learnedDir, f);
+                try {
+                    if (hasGainStamp(fs.readFileSync(p, 'utf-8'), nodeId)) {
+                        fs.unlinkSync(p);
+                        removed = true;
+                    }
+                }
+                catch { /* unreadable — skip */ }
+            }
+        }
+        catch { /* no learned dir — fine */ }
+        return removed;
+    }
+    catch {
+        return false;
+    }
+}
+/** Bound the file work per session start; overflow waits (still pending). */
+const MAX_LANDS_PER_START = 5;
+/** The full landing pass. Every gain with a payload lands as a briefcase
+ *  (capped per skill + per start); payload-less/unroutable gains stay pending.
+ *  Returns the report (announce) + the status updates to POST back. */
+function landPendingGains(pending, cwd, homeDir, projectName) {
+    const report = { landed: [] };
+    const statusUpdates = [];
+    for (const gain of pending) {
+        if (report.landed.length >= MAX_LANDS_PER_START)
+            break;
+        const outcome = landBriefcase(gain, cwd, homeDir, projectName);
+        if (outcome === 'landed' || outcome === 'already-landed') {
+            statusUpdates.push({ nodeId: gain.nodeId, status: 'landed' });
+            if (outcome === 'landed') {
+                report.landed.push({
+                    nodeId: gain.nodeId, skill: gain.skill, oneLiner: gain.oneLiner || gain.text,
+                });
+            }
+        }
+        // 'capped' / 'deferred' → stays pending, retried next session start
+    }
+    return { report, statusUpdates };
+}
+//# sourceMappingURL=skill-landing.js.map

package/dist/skill-landing.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "greprag",
-  "version": "5.49.15",
+  "version": "5.50.0",
   "description": "GrepRAG — agent memory for Claude Code, Codex, and OpenCode.",
   "main": "dist/index.js",
   "bin": {

package/skill/commander/SKILL.md

@@ -83,7 +83,7 @@ greprag discord handoff --session <8-hex> --project <name> --ttl 60 --no-watch
 
 Tell the user: *"Handoff pinned for 60 min. Reply on Discord — your messages route to this session."*
 
-> Safety net: if `greprag inbox watchers` shows no watcher for your 8-hex (auto-arm disabled, or it died and the next turn hasn't re-armed yet), arm one under **Monitor (persistent:true)**: `while true; do greprag inbox watch --session <8-hex> --json; echo "[restart]" >&2; sleep 1; done`.
+> Safety net: if `greprag inbox watchers` shows no watcher for your 8-hex (auto-arm disabled, or it died and the next turn hasn't re-armed yet), arm one under **Monitor (persistent:true)** with the exit-aware relauncher: `while true; do greprag inbox watch --session <8-hex> --json --owner-pid <pid>; case $? in 0|64) break;; esac; sleep 1; done`. (The `case $? in 0|64) break` is required — it breaks on clean/consumer-gone (0) and fatal/bad-key (64) so the loop never busy-respawns an orphan; only a crash relaunches. A bare `while true; …; sleep 1; done` without it is the 2026-06-04 OOM orphan — don't use that form.)
 
 ### Orchestrator handoff (`--orchestrator`) — the only mode that arms
 
@@ -95,7 +95,7 @@ Run under **Monitor (persistent:true)**, wrapped so a process death auto-recover
 greprag discord handoff --session <8-hex> --project <name> --ttl 60 --orchestrator --no-watch && \
 while true; do
   greprag inbox watch --json
-  echo "[wrapper] watcher exited, restarting in 1s" >&2
+  case $? in 0|64) break;; esac   # 0 = clean/consumer-gone, 64 = fatal/bad-key — don't respawn an orphan
   sleep 1
 done
 ```