greprag 5.49.6 → 5.49.9

package/dist/commands/corpus/tags.js.map

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

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

@@ -0,0 +1,15 @@
+/** corpus-announce — the SessionStart announce that names the api-docs-tagged
+ *  corpus stores on tap + the directive to SEARCH them before answering from
+ *  training data. The reminder-interrupt "announce" half (load-once schema,
+ *  never a per-turn nag).
+ *
+ *  WHY: the tenant carries vendor/API reference banks (Stripe, QuickBooks,
+ *  Cloudflare, Procore, Claude Code docs) as corpus stores tagged `api-docs`.
+ *  An agent that doesn't know they exist answers from stale training data. This
+ *  surfaces the set once per session, with the one command that searches it.
+ *
+ *  Lean by construction: silent unless the tenant actually has api-docs-tagged
+ *  stores (env.corpusApiDocs precomputed by the hook). adr: adr/corpus-tags.md */
+import { ReminderModule } from './reminder-types';
+export declare function buildCorpusAnnounce(names: string[]): string | null;
+export declare const corpusAnnounceModule: ReminderModule;

package/dist/commands/corpus-reminder.js

@@ -0,0 +1,34 @@
+"use strict";
+/** corpus-announce — the SessionStart announce that names the api-docs-tagged
+ *  corpus stores on tap + the directive to SEARCH them before answering from
+ *  training data. The reminder-interrupt "announce" half (load-once schema,
+ *  never a per-turn nag).
+ *
+ *  WHY: the tenant carries vendor/API reference banks (Stripe, QuickBooks,
+ *  Cloudflare, Procore, Claude Code docs) as corpus stores tagged `api-docs`.
+ *  An agent that doesn't know they exist answers from stale training data. This
+ *  surfaces the set once per session, with the one command that searches it.
+ *
+ *  Lean by construction: silent unless the tenant actually has api-docs-tagged
+ *  stores (env.corpusApiDocs precomputed by the hook). adr: adr/corpus-tags.md */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.corpusAnnounceModule = void 0;
+exports.buildCorpusAnnounce = buildCorpusAnnounce;
+function buildCorpusAnnounce(names) {
+    if (!names || names.length === 0)
+        return null;
+    const shown = names.slice(0, 8);
+    const more = names.length > shown.length ? ` (+${names.length - shown.length} more)` : '';
+    return [
+        `[greprag corpus — API/reference banks on tap: ${shown.join(', ')}${more}.]`,
+        'If a corpus covers the domain you\'re in, SEARCH IT before answering from training data:',
+        '`greprag corpus search "<your question>" --tag api-docs`  (or --store <name> for one bank).',
+    ].join('\n');
+}
+exports.corpusAnnounceModule = {
+    id: 'corpus-announce',
+    detect: (_env) => ({ tier: 'silent' }), // never a per-turn nag
+    announce: (env) => buildCorpusAnnounce(env.corpusApiDocs || []),
+    reminder: () => null,
+};
+//# sourceMappingURL=corpus-reminder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"corpus-reminder.js","sourceRoot":"","sources":["../../src/commands/corpus-reminder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;kFAWkF;;;AAIlF,kDASC;AATD,SAAgB,mBAAmB,CAAC,KAAe;IACjD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1F,OAAO;QACL,iDAAiD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI;QAC5E,0FAA0F;QAC1F,6FAA6F;KAC9F,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,uBAAuB;IACvF,QAAQ,EAAE,CAAC,GAAgB,EAAiB,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC;IAC3F,QAAQ,EAAE,GAAkB,EAAE,CAAC,IAAI;CACpC,CAAC"}

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

@@ -13,46 +13,26 @@
  *  network, no clock — the hook does ALL I/O. Keeping detect/tier a pure function is what
  *  makes the detect→silent transition (the auto-stop) unit-testable (the regression-lock). */
 import { Tier, ReminderModule } from './reminder-types';
-/** The firing-tier ladder (docs/reminder-interrupt.md §Firing tiers). `silent`
- *  is the off rung; the other three escalate wording intensity with the cost of
- *  inaction: ambient = soft pointer, nudge = imperative + reason, nag = LOUD
- *  forced-decision. */
 export type FrictionTier = Tier;
-/** Ambient (calm-state) cadence: one soft pointer every N turns. The low-rate
- *  trickle for a capability with no live bad-state to gate on. */
-export declare const AMBIENT_EVERY_N = 5;
-/** Decide the friction reminder's firing tier from the live state bag — PURE so
- *  the ladder is unit-testable (the regression-lock rung). DYNAMIC: urgency tracks
- *  the live stress level (docs/stress-trigger.md), not a hand-set knob.
- *
- *    stress HIGH (2)     → nag    — LOUD forced-decision; fires while the live bad
- *                                   state holds and goes silent the instant it flips.
- *    stress ELEVATED (1) → nudge  — imperative + reason, while elevated.
- *    stress CALM (0)     → ambient every Nth turn (turnCount % AMBIENT_EVERY_N),
- *                                   else silent.
- *
- *  Defensive: non-finite inputs collapse to 0 (calm / turn 0 → silent), so a
- *  missing or corrupt state bag can never escalate — fail-quiet by construction. */
-export declare function frictionReminderTier(turnCount: number, stress: number): FrictionTier;
-/** SessionStart announce — the mechanic-launch schema, loaded ONCE. The heavy
- *  half of the pair: it (1) TEACHES the method the per-turn reminder triggers, so
- *  the reminder stays a thin pointer, and (2) PRIMES adherence — the agent acts on
- *  a reminder for a capability it was *taught*, not a cold mid-session imperative
- *  (the no-orphan invariant, docs/reminder-interrupt.md). Written for an AGENT under
- *  token pressure per the doc's authoring rules: action-first, reason+method
- *  bundled, directive-framed, token-minimal. ~150 tokens; amortized over the
- *  session. */
-export declare function buildMechanicAnnounce(): string;
-/** Per-turn reminder line for a given tier — the thin pointer back at the announce
- *  schema; null on `silent`. Wording intensity scales with the tier (the doc):
- *  ambient = soft pointer, nudge = imperative + reason, nag = LOUD forced-decision.
- *  Every non-silent line is action-first, bundles reason+method, and ends on a
- *  forced binary (act → spawn / clear → continue) so it CONVERTS instead of becoming
- *  wallpaper (the fix-`16a29a8b` banner-blindness failure mode). Grounded to the
- *  live signal where there is one (nudge/nag name the stress). The act-now directive
- *  envelope (authoring rule #4) is applied by the hook, not here — this module owns
- *  the wording, the caller owns the framing. */
+/** The friction reminder fires ONLY on DETECTED STRESS (docs/stress-trigger.md) —
+ *  no turn-cadence ambient nagging (that was the wallpaper removed 2026-06-22).
+ *  `computeStress` (the validated AUC-0.835 composite: repetition · retry ·
+ *  seq-trigram · errors · churn) emits the level; this maps it to a tier:
+ *    HIGH (2)     → nag   (LOUD)
+ *    ELEVATED (1) → nudge (the detector fires pre-error at this band)
+ *    CALM (0)     → silent — the reminder NEVER fires at rest.
+ *  Defensive: a non-finite stress collapses to calm (fail-quiet). */
+export declare function frictionReminderTier(stress: number): FrictionTier;
+/** The per-turn reminder line — fires only on detected stress, points back at the
+ *  primer's repair vehicles, ends on a forced binary so it converts. null = calm. */
 export declare function buildFrictionReminder(tier: FrictionTier): string | null;
+/** SessionStart primer — the active-Mechanic schema, loaded ONCE. Full doctrine
+ *  inline (a PRIMER, not a pointer): it teaches WHEN friction is a fix-now signal,
+ *  the two repair vehicles (reflex vs workshop, by friction tier), and the modes.
+ *  Depends on the chip concept being loaded first (chip-spawn-pointer) — it names
+ *  chip vehicles. Written for an agent under token pressure: action-first,
+ *  reason+method bundled, no per-turn nag to lean on. */
+export declare function buildMechanicAnnounce(): string;
 /** Persisted fire-counter (docs/reminder-interrupt.md §Measurement). The
  *  DENOMINATOR of the adherence ratio: how many friction reminders were shown, by
  *  tier. The numerator (reflex chips actually spawned after a reminder) is the next
@@ -83,10 +63,8 @@ export declare function tallyFrictionFire(prior: FrictionStats | null, tier: Fri
  *  path calls this when it sees a chip preloaded from the reflex-chip template land
  *  after a reminder. Never decrements; idempotency is the caller's concern. */
 export declare function tallyReflexSpawn(prior: FrictionStats | null): FrictionStats;
-/** The active Mechanic, recast onto the detector model (docs/reminder-interrupt.md
- *  §Registry spec). `detect` is stress-gated — the friction signal IS the live
- *  deficiency; `announce` teaches the reflex-chip schema once; `reminder` is the thin
- *  per-turn line. Wired through the container (reminder-registry.ts). Unlike the
- *  watcher-arm reference module (binary, auto-silences when armed), this one is
- *  GRADED — silent at calm, escalating with the live stress level. */
+/** The active Mechanic — a PRIMER-ONLY module (docs/load-system.md): one strong
+ *  SessionStart announce, no per-turn reminder (the friction nag was removed
+ *  2026-06-22 as wallpaper). `dependsOn` the chip-spawn pointer so the chip concept
+ *  it references is already loaded — the boot sequence places it AFTER chips. */
 export declare const mechanicFrictionModule: ReminderModule;

package/dist/commands/friction-reminder.js

@@ -14,82 +14,64 @@
  *  network, no clock — the hook does ALL I/O. Keeping detect/tier a pure function is what
  *  makes the detect→silent transition (the auto-stop) unit-testable (the regression-lock). */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mechanicFrictionModule = exports.AMBIENT_EVERY_N = void 0;
+exports.mechanicFrictionModule = void 0;
 exports.frictionReminderTier = frictionReminderTier;
-exports.buildMechanicAnnounce = buildMechanicAnnounce;
 exports.buildFrictionReminder = buildFrictionReminder;
+exports.buildMechanicAnnounce = buildMechanicAnnounce;
 exports.tallyFrictionFire = tallyFrictionFire;
 exports.tallyReflexSpawn = tallyReflexSpawn;
 const state_trigger_1 = require("./state-trigger");
-/** Ambient (calm-state) cadence: one soft pointer every N turns. The low-rate
- *  trickle for a capability with no live bad-state to gate on. */
-exports.AMBIENT_EVERY_N = 5;
-/** Decide the friction reminder's firing tier from the live state bag — PURE so
- *  the ladder is unit-testable (the regression-lock rung). DYNAMIC: urgency tracks
- *  the live stress level (docs/stress-trigger.md), not a hand-set knob.
- *
- *    stress HIGH (2)     → nag    — LOUD forced-decision; fires while the live bad
- *                                   state holds and goes silent the instant it flips.
- *    stress ELEVATED (1) → nudge  — imperative + reason, while elevated.
- *    stress CALM (0)     → ambient every Nth turn (turnCount % AMBIENT_EVERY_N),
- *                                   else silent.
- *
- *  Defensive: non-finite inputs collapse to 0 (calm / turn 0 → silent), so a
- *  missing or corrupt state bag can never escalate — fail-quiet by construction. */
-function frictionReminderTier(turnCount, stress) {
+/** The friction reminder fires ONLY on DETECTED STRESS (docs/stress-trigger.md) —
+ *  no turn-cadence ambient nagging (that was the wallpaper removed 2026-06-22).
+ *  `computeStress` (the validated AUC-0.835 composite: repetition · retry ·
+ *  seq-trigram · errors · churn) emits the level; this maps it to a tier:
+ *    HIGH (2)     → nag   (LOUD)
+ *    ELEVATED (1) → nudge (the detector fires pre-error at this band)
+ *    CALM (0)     → silent — the reminder NEVER fires at rest.
+ *  Defensive: a non-finite stress collapses to calm (fail-quiet). */
+function frictionReminderTier(stress) {
     const s = Number.isFinite(stress) ? stress : 0;
-    const t = Number.isFinite(turnCount) ? turnCount : 0;
     if (s >= state_trigger_1.STRESS_HIGH)
         return 'nag';
     if (s >= state_trigger_1.STRESS_ELEVATED)
         return 'nudge';
-    if (t >= 1 && t % exports.AMBIENT_EVERY_N === 0)
-        return 'ambient';
     return 'silent';
 }
-// ---------- Authored text (announce + per-turn reminder) ---------------------
-/** The HOW string — the method every tier points at. Kept in one place so the
- *  announce and the per-turn line can never drift on the spawn mechanic. */
-const SPAWN_METHOD = 'spawn a fire-and-forget reflex chip (spawn_task → packages/cli/skill/templates/reflex-chip.md)';
-/** SessionStart announce — the mechanic-launch schema, loaded ONCE. The heavy
- *  half of the pair: it (1) TEACHES the method the per-turn reminder triggers, so
- *  the reminder stays a thin pointer, and (2) PRIMES adherence — the agent acts on
- *  a reminder for a capability it was *taught*, not a cold mid-session imperative
- *  (the no-orphan invariant, docs/reminder-interrupt.md). Written for an AGENT under
- *  token pressure per the doc's authoring rules: action-first, reason+method
- *  bundled, directive-framed, token-minimal. ~150 tokens; amortized over the
- *  session. */
-function buildMechanicAnnounce() {
-    return [
-        '[Active Mechanic — keep the harness healthy IN-SESSION. Friction is a signal to fix now, not to defer.]',
-        'WHEN you hit friction this session — repeated yourself, fought a tool, got corrected ≥2× on the same thing, or rediscovered something already known — fix the PATTERN now; do not push through.',
-        `HOW: ${SPAWN_METHOD}. The chip is preloaded with the mechanic tools + live \`greprag mechanic status\`, so it orients instantly, lands a Tier-0 born-shadow repair, and ends — no gate to wait at.`,
-        'MODES: fix (land the repair) · log (`greprag fix log "<obs>"` when it is a mechanism for /mechanic later) · ask-human (the operator must decide).',
-        'WHY now: immediate-fix beats the backlog — the moment that produced the friction still holds the context the fix needs; deferred, that context is gone.',
-        'A per-turn reminder fires LOUD when live friction is detected — act on it, or say "clear" and continue.',
-    ].join('\n');
-}
-/** Per-turn reminder line for a given tier — the thin pointer back at the announce
- *  schema; null on `silent`. Wording intensity scales with the tier (the doc):
- *  ambient = soft pointer, nudge = imperative + reason, nag = LOUD forced-decision.
- *  Every non-silent line is action-first, bundles reason+method, and ends on a
- *  forced binary (act → spawn / clear → continue) so it CONVERTS instead of becoming
- *  wallpaper (the fix-`16a29a8b` banner-blindness failure mode). Grounded to the
- *  live signal where there is one (nudge/nag name the stress). The act-now directive
- *  envelope (authoring rule #4) is applied by the hook, not here — this module owns
- *  the wording, the caller owns the framing. */
+/** The per-turn reminder line — fires only on detected stress, points back at the
+ *  primer's repair vehicles, ends on a forced binary so it converts. null = calm. */
 function buildFrictionReminder(tier) {
     switch (tier) {
         case 'nag':
-            return `⚠ FRICTION HIGH (live signal: repetition / errors / churn) — STOP pushing through; fix the PATTERN now → ${SPAWN_METHOD}. No friction? say "clear" + continue.`;
+            return '⚠ FRICTION HIGH (live signal: repetition / errors / churn) — STOP pushing through; fix the PATTERN now → `greprag load reflex-chip` (sentence-tier) or `greprag load workshop-chip` (machinery), then spawn_task. No friction? say "clear" + continue.';
         case 'nudge':
-            return `⚠ Friction rising — if you have repeated yourself or fought a tool, fix it now → ${SPAWN_METHOD}. Otherwise say "clear" + continue.`;
-        case 'ambient':
-            return `💡 Hit friction since the last check (repeated yourself, fought a tool, corrected ≥2×)? → ${SPAWN_METHOD}. If not, say "clear" + continue.`;
+            return '⚠ Friction detected (live signal) — if you have repeated yourself, fought a tool, or hit a wall, fix the PATTERN now → `greprag load reflex-chip` (sentence-tier) or `greprag load workshop-chip` (machinery), then spawn_task. Otherwise say "clear" + continue.';
         default:
             return null;
     }
 }
+// ---------- The Mechanic primer (announce-only) ------------------------------
+/** The method the primer points at. `greprag load reflex-chip` carries the full
+ *  in-the-moment repair-chip schema; `greprag load workshop-chip` the heavier
+ *  mechanism-tier one. Kept in one place so the two branches never drift. */
+const REFLEX_METHOD = 'spawn a fire-and-forget reflex chip — `greprag load reflex-chip` for the method, then `spawn_task`';
+const WORKSHOP_METHOD = 'spawn a workshop chip — `greprag load workshop-chip` (investigates + drafts the repair, parks at your merge gate)';
+/** SessionStart primer — the active-Mechanic schema, loaded ONCE. Full doctrine
+ *  inline (a PRIMER, not a pointer): it teaches WHEN friction is a fix-now signal,
+ *  the two repair vehicles (reflex vs workshop, by friction tier), and the modes.
+ *  Depends on the chip concept being loaded first (chip-spawn-pointer) — it names
+ *  chip vehicles. Written for an agent under token pressure: action-first,
+ *  reason+method bundled, no per-turn nag to lean on. */
+function buildMechanicAnnounce() {
+    return [
+        '[Active Mechanic — keep the harness healthy IN-SESSION. Friction is a signal to fix NOW, not to defer; the moment that produced it still holds the context the fix needs.]',
+        'WHEN you hit friction this session — repeated yourself, fought a tool, got corrected ≥2× on the same thing, or rediscovered something already known — fix the PATTERN now; do not push through.',
+        `SENTENCE-TIER friction (the fix is words in a file you own — a skill / doc / CLAUDE.md): ${REFLEX_METHOD}. The chip is preloaded with the mechanic tools + live \`greprag mechanic status\`, lands a Tier-0 born-shadow repair, and ends — no gate to wait at.`,
+        `MECHANISM-TIER friction (the fix is machinery — a hook / gate / trigger / code, anything you can't fix in words): ${WORKSHOP_METHOD}.`,
+        'MODES (when unsure which, or when it is not a chip): fix (land the repair inline) · log (`greprag fix log "<obs>"` to queue it for /mechanic) · ask-human (the operator must decide).',
+        'Every repair is ROOT-CAUSE — fix the pattern that makes the friction class possible, never a guard on today\'s trigger.',
+        'A per-turn reminder fires ONLY when live friction is DETECTED (the stress signal — repetition / errors / churn), never on a timer — act on it, or say "clear" and continue.',
+    ].join('\n');
+}
 /** Normalize any prior-stats blob (possibly missing/partial/corrupt) into a fully
  *  populated FrictionStats. Pure, total. */
 function normalizeStats(prior) {
@@ -132,15 +114,15 @@ function tallyReflexSpawn(prior) {
     return s;
 }
 // ---------- Registry module --------------------------------------------------
-/** The active Mechanic, recast onto the detector model (docs/reminder-interrupt.md
- *  §Registry spec). `detect` is stress-gated — the friction signal IS the live
- *  deficiency; `announce` teaches the reflex-chip schema once; `reminder` is the thin
- *  per-turn line. Wired through the container (reminder-registry.ts). Unlike the
- *  watcher-arm reference module (binary, auto-silences when armed), this one is
- *  GRADED — silent at calm, escalating with the live stress level. */
+/** The active Mechanic — a PRIMER-ONLY module (docs/load-system.md): one strong
+ *  SessionStart announce, no per-turn reminder (the friction nag was removed
+ *  2026-06-22 as wallpaper). `dependsOn` the chip-spawn pointer so the chip concept
+ *  it references is already loaded — the boot sequence places it AFTER chips. */
 exports.mechanicFrictionModule = {
     id: 'mechanic-friction',
-    detect: (env) => ({ tier: frictionReminderTier(env.turnCount, env.stress) }),
+    dependsOn: ['chip-spawn-pointer'],
+    // Fires ONLY on detected stress (elevated/high) — no turn-cadence nag.
+    detect: (env) => ({ tier: frictionReminderTier(env.stress) }),
     announce: () => buildMechanicAnnounce(),
     reminder: (d) => buildFrictionReminder(d.tier),
 };

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

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

package/dist/commands/init.js

@@ -300,20 +300,13 @@ async function runInit(opts) {
                 optionalSkills.push(entry.name);
         }
     }
-    // Step 6b: Install the chip-spawn doc to ~/.claude/docs/chip-spawn.md. The
-    // global CLAUDE.md (Step 3b of the skill) carries only a single loud pointer
-    // to this file; the actual chip-spawn protocol lives here, read on demand
-    // by the agent when about to call spawn_task. Keeping the protocol out of
-    // CLAUDE.md saves tokens on every session that doesn't spawn a chip.
-    const docsDir = path.join(os.homedir(), '.claude', 'docs');
-    const chipSpawnSrc = path.join(__dirname, '../../skill/templates/chip-spawn.md');
-    if (fs.existsSync(chipSpawnSrc)) {
-        if (!fs.existsSync(docsDir))
-            fs.mkdirSync(docsDir, { recursive: true });
-        const chipSpawnDest = path.join(docsDir, 'chip-spawn.md');
-        fs.copyFileSync(chipSpawnSrc, chipSpawnDest);
-        changes.push(`Installed chip-spawn doc → ${chipSpawnDest}`);
-    }
+    // Step 6b RETIRED 2026-06-22 (docs/load-system.md): the chip-spawn protocol is
+    // no longer copied to ~/.claude/docs/chip-spawn.md. greprag function never
+    // depends on a `.md` file on disk — the doctrine ships in the binary and is
+    // loaded on demand via `greprag load chip-spawn` (the Interrupt System's
+    // chip-spawn POINTER announce names the trigger + the command). One less
+    // install-time file write, and it works in every project, not just where the
+    // file happened to be installed.
     // Step 7: Patch ~/.claude/CLAUDE.md greprag CLI section (migrates legacy ## Inbox).
     const claudeMdPatched = patchGlobalClaudeMd();
     changes.push(claudeMdPatched ? 'Patched ~/.claude/CLAUDE.md greprag CLI section' : '~/.claude/CLAUDE.md greprag CLI section already up to date');