greprag 5.49.16 → 5.51.0

package/dist/commands/skill-gain-reminder.js

@@ -0,0 +1,32 @@
+"use strict";
+/** skill-gain-announce — the Skill Learning Loop's SessionStart surface
+ *  (docs/skill-learning-loop.md §fuse shape). PURELY INFORMATIONAL: the
+ *  landing leg already wrote the briefcase (learned doc + fuse line in
+ *  SKILL.md), and the fuse self-applies on the skill's NEXT invocation — this
+ *  block just tells the operator their skills picked something up. Never a
+ *  task; the voluntarism corpse stays buried.
+ *
+ *  The hook does the I/O and passes env.skillGains; this module is PURE
+ *  render. Silent when nothing landed. Startup-only. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.skillGainAnnounceModule = void 0;
+exports.buildSkillGainAnnounce = buildSkillGainAnnounce;
+function buildSkillGainAnnounce(gains) {
+    if (!gains || gains.landed.length === 0)
+        return null;
+    return [
+        '[greprag skills — learned from past runs (Skill Learning Loop):]',
+        ...gains.landed.map((l) => `⚙ ${l.skill} packed a briefcase: ${l.oneLiner}`),
+        'Each lands as a fuse line + focused doc inside the skill and SELF-APPLIES on its next'
+            + ' invocation (the agent folds it in, deletes the fuse). Nothing to do here.'
+            + ' Undo one: `greprag skillgain reject <id>`.',
+    ].join('\n');
+}
+exports.skillGainAnnounceModule = {
+    id: 'skill-gain-announce',
+    detect: (_env) => ({ tier: 'silent' }), // announce-only
+    announce: (env) => buildSkillGainAnnounce(env.skillGains),
+    reannounceOnCompact: false,
+    reminder: () => null,
+};
+//# sourceMappingURL=skill-gain-reminder.js.map

package/dist/commands/skill-gain-reminder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-gain-reminder.js","sourceRoot":"","sources":["../../src/commands/skill-gain-reminder.ts"],"names":[],"mappings":";AAAA;;;;;;;;wDAQwD;;;AAIxD,wDAWC;AAXD,SAAgB,sBAAsB,CACpC,KAAyE;IAEzE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrD,OAAO;QACL,kEAAkE;QAClE,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,wBAAwB,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC5E,uFAAuF;cACrF,4EAA4E;cAC5E,6CAA6C;KAChD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAEY,QAAA,uBAAuB,GAAmB;IACrD,EAAE,EAAE,qBAAqB;IACzB,MAAM,EAAE,CAAC,IAAiB,EAAa,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,gBAAgB;IAChF,QAAQ,EAAE,CAAC,GAAgB,EAAiB,EAAE,CAAC,sBAAsB,CAAC,GAAG,CAAC,UAAU,CAAC;IACrF,mBAAmB,EAAE,KAAK;IAC1B,QAAQ,EAAE,GAAkB,EAAE,CAAC,IAAI;CACpC,CAAC"}

package/dist/commands/skill-mirror-reminder.d.ts

@@ -0,0 +1,15 @@
+/** skill-mirror-announce — the Tier-3 mirror's SessionStart pointer
+ *  (docs/load-system.md §Tier 3). A POINTER, not a list (context economy):
+ *  one line naming the capability + the command — the catalog lives behind
+ *  `greprag load`. This is the "where to find skills" info the operator asked
+ *  for, and the discovery half of trigger parity until the frontrun judge
+ *  lands (see the spec's named gaps).
+ *
+ *  The hook passes env.mirroredSkills (count + a few freshest names); this
+ *  module is PURE render. Silent when nothing is mirrored yet. */
+import { ReminderModule } from './reminder-types';
+export declare function buildSkillMirrorAnnounce(m: {
+    count: number;
+    names: string[];
+} | undefined): string | null;
+export declare const skillMirrorAnnounceModule: ReminderModule;

package/dist/commands/skill-mirror-reminder.js

@@ -0,0 +1,33 @@
+"use strict";
+/** skill-mirror-announce — the Tier-3 mirror's SessionStart pointer
+ *  (docs/load-system.md §Tier 3). A POINTER, not a list (context economy):
+ *  one line naming the capability + the command — the catalog lives behind
+ *  `greprag load`. This is the "where to find skills" info the operator asked
+ *  for, and the discovery half of trigger parity until the frontrun judge
+ *  lands (see the spec's named gaps).
+ *
+ *  The hook passes env.mirroredSkills (count + a few freshest names); this
+ *  module is PURE render. Silent when nothing is mirrored yet. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.skillMirrorAnnounceModule = void 0;
+exports.buildSkillMirrorAnnounce = buildSkillMirrorAnnounce;
+function buildSkillMirrorAnnounce(m) {
+    if (!m || m.count <= 0)
+        return null;
+    const sample = m.names.slice(0, 4).join(', ');
+    const more = m.count > 4 ? ', …' : '';
+    return [
+        `[greprag skills — ${m.count} of your skills travel with the harness (auto-mirrored from use, always fresh): ${sample}${more}.]`,
+        'Any machine or harness with the greprag CLI can use them — `greprag load` to browse, '
+            + '`greprag load <skill>` to read one inline. No ~/.claude/skills needed.',
+    ].join('\n');
+}
+exports.skillMirrorAnnounceModule = {
+    id: 'skill-mirror-announce',
+    source: 'prompt',
+    dependsOn: ['load-primer'], // references `greprag load` — the primer establishes it
+    detect: (_env) => ({ tier: 'silent' }), // announce-only
+    announce: (env) => buildSkillMirrorAnnounce(env.mirroredSkills),
+    reminder: () => null,
+};
+//# sourceMappingURL=skill-mirror-reminder.js.map

package/dist/commands/skill-mirror-reminder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-mirror-reminder.js","sourceRoot":"","sources":["../../src/commands/skill-mirror-reminder.ts"],"names":[],"mappings":";AAAA;;;;;;;;kEAQkE;;;AAIlE,4DAWC;AAXD,SAAgB,wBAAwB,CACtC,CAAiD;IAEjD,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACtC,OAAO;QACL,qBAAqB,CAAC,CAAC,KAAK,mFAAmF,MAAM,GAAG,IAAI,IAAI;QAChI,uFAAuF;cACrF,wEAAwE;KAC3E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAEY,QAAA,yBAAyB,GAAmB;IACvD,EAAE,EAAE,uBAAuB;IAC3B,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,CAAC,aAAa,CAAC,EAAE,wDAAwD;IACpF,MAAM,EAAE,CAAC,IAAiB,EAAa,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,gBAAgB;IAChF,QAAQ,EAAE,CAAC,GAAgB,EAAiB,EAAE,CAAC,wBAAwB,CAAC,GAAG,CAAC,cAAc,CAAC;IAC3F,QAAQ,EAAE,GAAkB,EAAE,CAAC,IAAI;CACpC,CAAC"}

package/dist/commands/skillgain.d.ts

@@ -0,0 +1,12 @@
+/** greprag skillgain — the Skill Learning Loop's operator/agent verbs
+ *  (docs/skill-learning-loop.md). The landing leg auto-lands reference gains;
+ *  rule/scope PROPOSALS park at the operator gate and are resolved here:
+ *
+ *    skillgain list            pending gains for this project (all types)
+ *    skillgain done <8hex>     the proposal was applied to the skill (per
+ *                              skill-fix-conventions, diff shown + accepted)
+ *    skillgain reject <8hex>   the proposal was bogus — never show it again
+ *
+ *  Thin client over /v1/skillgain; project resolved from cwd like every
+ *  other command. Self-contained dispatcher + body (the CLI command pattern). */
+export declare function runSkillGain(args: string[]): Promise<void>;

package/dist/commands/skillgain.js

@@ -0,0 +1,109 @@
+"use strict";
+/** greprag skillgain — the Skill Learning Loop's operator/agent verbs
+ *  (docs/skill-learning-loop.md). The landing leg auto-lands reference gains;
+ *  rule/scope PROPOSALS park at the operator gate and are resolved here:
+ *
+ *    skillgain list            pending gains for this project (all types)
+ *    skillgain done <8hex>     the proposal was applied to the skill (per
+ *                              skill-fix-conventions, diff shown + accepted)
+ *    skillgain reject <8hex>   the proposal was bogus — never show it again
+ *
+ *  Thin client over /v1/skillgain; project resolved from cwd like every
+ *  other command. Self-contained dispatcher + body (the CLI command pattern). */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSkillGain = runSkillGain;
+const project_anchor_1 = require("../project-anchor");
+const skill_landing_1 = require("../skill-landing");
+function getConfig() {
+    return {
+        apiUrl: process.env.GREPRAG_API_URL || 'https://api.greprag.com',
+        apiKey: process.env.GREPRAG_API_KEY || '',
+    };
+}
+const HELP = `greprag skillgain — Skill Learning Loop queue (docs/skill-learning-loop.md)
+
+USAGE
+  greprag skillgain list             Pending gains for this project (not yet landed).
+  greprag skillgain reject <8hex>    The UNDO: mark a gain bogus AND remove its
+                                     landed artifacts (the fuse line in SKILL.md
+                                     + the docs/learned/<slug>.md doc).
+  greprag skillgain done <8hex>      Manually mark a pending gain resolved
+                                     (rarely needed — landing is automatic and a
+                                     digested fuse needs no marking).
+
+Gains land automatically at session start as a briefcase (fuse line + focused
+doc) and SELF-APPLY on the skill's next invocation.`;
+async function runSkillGain(args) {
+    const sub = args[0];
+    const cfg = getConfig();
+    if (!cfg.apiKey) {
+        console.error('GREPRAG_API_KEY not set — run `greprag init` first.');
+        process.exit(1);
+    }
+    const anchor = (0, project_anchor_1.readAnchor)(process.cwd());
+    if (sub === 'list') {
+        const res = await fetch(`${cfg.apiUrl}/v1/skillgain/${anchor.projectId}/pending`, {
+            headers: { 'Authorization': `Bearer ${cfg.apiKey}` },
+        });
+        if (!res.ok) {
+            console.error(`API ${res.status}`);
+            process.exit(1);
+        }
+        const data = await res.json();
+        const gains = data.gains || [];
+        if (gains.length === 0) {
+            console.log('No pending skill gains.');
+            return;
+        }
+        for (const g of gains) {
+            console.log(`[${g.nodeId}] ${g.skill} · ${g.gainType}\n  ${g.text}`);
+        }
+        return;
+    }
+    if (sub === 'done' || sub === 'reject') {
+        const nodeId = (args[1] || '').toLowerCase();
+        if (!/^[0-9a-f]{8}$/.test(nodeId)) {
+            console.error(`Usage: greprag skillgain ${sub} <8hex>`);
+            process.exit(1);
+        }
+        const status = sub === 'done' ? 'landed' : 'rejected';
+        const res = await fetch(`${cfg.apiUrl}/v1/skillgain/${anchor.projectId}/status`, {
+            method: 'POST',
+            headers: { 'Authorization': `Bearer ${cfg.apiKey}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                projectName: anchor.projectName,
+                updates: [{ nodeId, status }],
+            }),
+        });
+        if (!res.ok) {
+            console.error(`API ${res.status}`);
+            process.exit(1);
+        }
+        const data = await res.json();
+        if ((data.updated || 0) === 0) {
+            console.error(`[${nodeId}] not found in ${anchor.projectName}'s skillgain queue.`);
+            process.exit(1);
+        }
+        console.log(`[${nodeId}] → ${status}`);
+        // Reject is the UNDO: also remove any landed artifacts (the fuse line in
+        // SKILL.md + the docs/learned/<slug>.md doc). Skill name via the record.
+        if (sub === 'reject') {
+            try {
+                const gr = await fetch(`${cfg.apiUrl}/v1/skillgain/${anchor.projectId}/gain/${nodeId}`, { headers: { 'Authorization': `Bearer ${cfg.apiKey}` } });
+                if (gr.ok) {
+                    const gd = await gr.json();
+                    if (gd.gain?.skill) {
+                        const homeDir = process.env.HOME || process.env.USERPROFILE || '';
+                        const removed = (0, skill_landing_1.removeLandedGain)(gd.gain.skill, nodeId, process.cwd(), homeDir);
+                        if (removed)
+                            console.log(`  removed landed artifacts from ${gd.gain.skill}`);
+                    }
+                }
+            }
+            catch { /* best-effort — the stamp makes manual cleanup findable */ }
+        }
+        return;
+    }
+    console.log(HELP);
+}
+//# sourceMappingURL=skillgain.js.map

package/dist/commands/skillgain.js.map

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