greprag 5.53.0 → 5.53.1

package/dist/mechanic-friction.js

@@ -0,0 +1,368 @@
+"use strict";
+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.MECHANIC_REPLY_MESSAGE_TYPE = exports.MECHANIC_LIVE_MESSAGE_TYPE = exports.MECHANIC_FRICTION_MESSAGE_TYPE = void 0;
+exports.buildMechanicFrictionBody = buildMechanicFrictionBody;
+exports.buildMechanicFrictionPayload = buildMechanicFrictionPayload;
+exports.buildManualMechanicFrictionEvent = buildManualMechanicFrictionEvent;
+exports.postMechanicFriction = postMechanicFriction;
+exports.fanoutMechanicLive = fanoutMechanicLive;
+exports.postMechanicReply = postMechanicReply;
+exports.forwardStressMechanicFriction = forwardStressMechanicFriction;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const project_anchor_1 = require("./project-anchor");
+const session_id_1 = require("./session-id");
+const harness_1 = require("./harness");
+exports.MECHANIC_FRICTION_MESSAGE_TYPE = 'mechanic_friction';
+exports.MECHANIC_LIVE_MESSAGE_TYPE = 'mechanic_live';
+exports.MECHANIC_REPLY_MESSAGE_TYPE = 'mechanic_reply';
+function stateDir() {
+    const home = process.env.HOME || process.env.USERPROFILE || os.homedir();
+    return path.join(home, '.greprag', 'state');
+}
+function getFlag(args, flag) {
+    const idx = args.indexOf(flag);
+    if (idx === -1 || idx + 1 >= args.length)
+        return undefined;
+    return args[idx + 1];
+}
+function getFlags(args, flag) {
+    const out = [];
+    for (let i = 0; i < args.length - 1; i++)
+        if (args[i] === flag)
+            out.push(args[i + 1]);
+    return out;
+}
+function parseFileFlag(raw) {
+    const lastColon = raw.lastIndexOf(':');
+    if (lastColon <= 0)
+        return { path: raw };
+    const tail = raw.slice(lastColon + 1);
+    if (/^\d+(-\d+)?$/.test(tail))
+        return { path: raw.slice(0, lastColon), lines: tail };
+    return { path: raw };
+}
+function positionalBody(args) {
+    const bodyFile = getFlag(args, '--body-file');
+    if (bodyFile)
+        return fs.readFileSync(bodyFile, 'utf-8');
+    if (args.includes('--stdin'))
+        return fs.readFileSync(0, 'utf-8');
+    const valueFlags = new Set([
+        '--tier', '--stress', '--stress-score', '--turn-count', '--signal',
+        '--from-session', '--file', '--body-file', '--source', '--platform',
+        '--transcript', '--to', '--session', '--friction-id', '--friction',
+    ]);
+    for (let i = 0; i < args.length; i++) {
+        if (args[i].startsWith('--'))
+            continue;
+        if (i > 0 && valueFlags.has(args[i - 1]))
+            continue;
+        return args[i];
+    }
+    return null;
+}
+function coerceTier(raw) {
+    return raw === 'sentence' || raw === 'mechanism' || raw === 'unsure' ? raw : 'unsure';
+}
+function numFlag(args, flag) {
+    const raw = getFlag(args, flag);
+    if (raw === undefined)
+        return null;
+    const n = Number(raw);
+    return Number.isFinite(n) ? n : null;
+}
+function buildMechanicFrictionBody(e) {
+    const lines = [
+        '[GrepRAG mechanic friction]',
+        `Source: ${e.source}${e.platform ? `/${e.platform}` : ''}`,
+        `Project: ${e.projectName} (${e.projectId.slice(0, 8)})`,
+        `Session: ${e.sourceSessionId || 'unknown'}`,
+        `CWD: ${e.cwd}`,
+        `Tier guess: ${e.tier}`,
+        `Stress: ${e.stress ?? 'n/a'}${e.stressScore !== undefined && e.stressScore !== null ? ` (score ${e.stressScore})` : ''}`,
+        e.turnCount !== undefined && e.turnCount !== null ? `Turn count: ${e.turnCount}` : '',
+        e.signals.length ? `Signals: ${e.signals.join(', ')}` : '',
+        e.files?.length ? `Files: ${e.files.map(f => f.lines ? `${f.path}:${f.lines}` : f.path).join(', ')}` : '',
+        '',
+        'Summary:',
+        e.summary,
+        '',
+        'Mechanic action: investigate the root cause, repair Tier 0/1 when safe, and ping the source session plus the operator for gates/status.',
+    ].filter(Boolean);
+    if (e.sourceSessionId) {
+        lines.push(`Reply to source: greprag mechanic reply --to ${e.sourceSessionId} "..." --friction-id <this-message-id>`);
+    }
+    return lines.join('\n');
+}
+function buildMechanicFrictionPayload(e) {
+    const references = { mechanic_friction: e };
+    if (e.files?.length)
+        references.files = e.files;
+    const payload = {
+        to: 'me',
+        body: buildMechanicFrictionBody(e),
+        message_type: exports.MECHANIC_FRICTION_MESSAGE_TYPE,
+        from_project_id: e.projectId,
+        references,
+        payload: { mechanic_friction: e },
+    };
+    if (e.sourceSessionId)
+        payload.from_session_id = e.sourceSessionId;
+    return payload;
+}
+function buildManualMechanicFrictionEvent(args, cwd = process.cwd()) {
+    const anchor = (0, project_anchor_1.readAnchor)(cwd);
+    const summary = positionalBody(args);
+    if (!summary || !summary.trim()) {
+        throw new Error('Usage: greprag mechanic friction "<summary>" [--tier sentence|mechanism|unsure] [--signal repetition] [--stress 1|2]');
+    }
+    return {
+        source: getFlag(args, '--source') || 'manual',
+        summary: summary.trim(),
+        cwd,
+        projectId: anchor.projectId,
+        projectName: anchor.projectName,
+        sourceSessionId: (0, session_id_1.truncateSessionId)(getFlag(args, '--from-session') || (0, session_id_1.readSessionEnv)()),
+        tier: coerceTier(getFlag(args, '--tier')),
+        stress: numFlag(args, '--stress'),
+        stressScore: numFlag(args, '--stress-score'),
+        turnCount: numFlag(args, '--turn-count'),
+        signals: getFlags(args, '--signal'),
+        transcriptPath: getFlag(args, '--transcript') || null,
+        files: getFlags(args, '--file').map(parseFileFlag),
+        platform: (0, harness_1.normalizeHarness)(getFlag(args, '--platform')) || (0, harness_1.inferCurrentHarness)(),
+        createdAt: new Date().toISOString(),
+    };
+}
+async function postMechanicFriction(apiUrl, apiKey, event, timeoutMs = 2500) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetch(`${apiUrl.replace(/\/+$/, '')}/v1/inbox/send`, {
+            method: 'POST',
+            headers: { 'Authorization': `Bearer ${apiKey}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify(buildMechanicFrictionPayload(event)),
+            signal: controller.signal,
+        });
+        const json = await res.json().catch(() => ({}));
+        if (!res.ok)
+            throw new Error(json.error || `API ${res.status}`);
+        return json;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function ownHandle() {
+    return (0, session_id_1.readIdentityAlias)() || 'me';
+}
+function sessionAddress(sessionId) {
+    const handle = ownHandle();
+    if (handle === 'me' || handle === 'self') {
+        throw new Error('No cached greprag identity handle; run `greprag identity` or `greprag init` before session-targeted mechanic sends.');
+    }
+    return `${handle}@greprag.com/${sessionId}`;
+}
+async function fetchLiveWatchers(apiUrl, apiKey) {
+    const res = await fetch(`${apiUrl.replace(/\/+$/, '')}/v1/inbox/watchers`, {
+        headers: { Authorization: `Bearer ${apiKey}` },
+    });
+    const data = await res.json().catch(() => ({}));
+    if (!res.ok)
+        throw new Error(data.error || `API ${res.status}`);
+    return Array.isArray(data.watchers) ? data.watchers : [];
+}
+function buildMechanicLiveBody(e) {
+    return [
+        '[GrepRAG mechanic is LIVE]',
+        `Mechanic source project: ${e.projectName} (${e.projectId.slice(0, 8)})`,
+        `Mechanic session: ${e.mechanicSessionId || 'project-wide'}`,
+        `Your session: ${e.targetSessionId}`,
+        '',
+        'Default assumption: you are NOT the Mechanic.',
+        'This is a tenant-wide mechanic rail for live friction from any project.',
+        'For friction, do NOT use generic `greprag send`.',
+        'Use the typed mechanic rail:',
+        `greprag mechanic friction "<summary>" --tier sentence|mechanism|unsure --signal <why> --platform <harness> --from-session ${e.targetSessionId}`,
+        '',
+        'Then keep working unless blocked. The Mechanic can reply on the mechanic rail for follow-up coordination.',
+    ].join('\n');
+}
+async function fanoutMechanicLive(apiUrl, apiKey, input) {
+    const watchers = await fetchLiveWatchers(apiUrl, apiKey);
+    const seen = new Set();
+    let attempted = 0;
+    let sent = 0;
+    let skipped = 0;
+    const errors = [];
+    for (const w of watchers) {
+        const session = (0, session_id_1.truncateSessionId)(w.session_id || null);
+        if (!session || seen.has(session)) {
+            skipped++;
+            continue;
+        }
+        seen.add(session);
+        if (input.mechanicSessionId && session === input.mechanicSessionId) {
+            skipped++;
+            continue;
+        }
+        // The Mechanic is a tenant-level role: friction from any live project should
+        // know the typed rail. Skip service/null rows, but do not same-project gate.
+        if (!w.project_id && !w.project_name) {
+            skipped++;
+            continue;
+        }
+        attempted++;
+        const event = {
+            projectId: input.projectId,
+            projectName: input.projectName,
+            mechanicSessionId: input.mechanicSessionId,
+            targetSessionId: session,
+            cwd: input.cwd,
+            createdAt: new Date().toISOString(),
+        };
+        try {
+            const res = await fetch(`${apiUrl.replace(/\/+$/, '')}/v1/inbox/send`, {
+                method: 'POST',
+                headers: { 'Authorization': `Bearer ${apiKey}`, 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    to: sessionAddress(session),
+                    body: buildMechanicLiveBody(event),
+                    message_type: exports.MECHANIC_LIVE_MESSAGE_TYPE,
+                    from_project_id: input.projectId,
+                    from_session_id: input.fromSessionId || input.mechanicSessionId || undefined,
+                    references: { mechanic_live: event },
+                    payload: { mechanic_live: event },
+                }),
+            });
+            const json = await res.json().catch(() => ({}));
+            if (!res.ok)
+                throw new Error(json.error || `API ${res.status}`);
+            sent++;
+        }
+        catch (err) {
+            errors.push(`${session}: ${err.message}`);
+        }
+    }
+    return { attempted, sent, skipped, errors };
+}
+async function postMechanicReply(apiUrl, apiKey, args, cwd = process.cwd()) {
+    const target = (0, session_id_1.truncateSessionId)(getFlag(args, '--to') || getFlag(args, '--session'));
+    if (!target)
+        throw new Error('Usage: greprag mechanic reply --to <8hex-session> "<message>" [--friction-id <id>]');
+    const body = positionalBody(args);
+    if (!body || !body.trim())
+        throw new Error('Usage: greprag mechanic reply --to <8hex-session> "<message>" [--friction-id <id>]');
+    const anchor = (0, project_anchor_1.readAnchor)(cwd);
+    const senderSessionId = (0, session_id_1.truncateSessionId)(getFlag(args, '--from-session') || (0, session_id_1.readSessionEnv)());
+    const event = {
+        projectId: anchor.projectId,
+        projectName: anchor.projectName,
+        senderSessionId,
+        targetSessionId: target,
+        frictionId: getFlag(args, '--friction-id') || getFlag(args, '--friction') || null,
+        createdAt: new Date().toISOString(),
+    };
+    const lines = [
+        '[GrepRAG mechanic reply]',
+        `Project: ${event.projectName} (${event.projectId.slice(0, 8)})`,
+        event.frictionId ? `Friction: ${event.frictionId}` : '',
+        `Sender session: ${event.senderSessionId || 'unknown'}`,
+        '',
+        body.trim(),
+        '',
+        `Reply on mechanic rail: greprag mechanic reply --to ${event.senderSessionId || '<sender-session>'} "..."${event.frictionId ? ` --friction-id ${event.frictionId}` : ''}`,
+    ].filter(Boolean).join('\n');
+    const res = await fetch(`${apiUrl.replace(/\/+$/, '')}/v1/inbox/send`, {
+        method: 'POST',
+        headers: { 'Authorization': `Bearer ${apiKey}`, 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            to: sessionAddress(target),
+            body: lines,
+            message_type: exports.MECHANIC_REPLY_MESSAGE_TYPE,
+            from_project_id: anchor.projectId,
+            from_session_id: senderSessionId || undefined,
+            references: { mechanic_reply: event },
+            payload: { mechanic_reply: event },
+        }),
+    });
+    const json = await res.json().catch(() => ({}));
+    if (!res.ok)
+        throw new Error(json.error || `API ${res.status}`);
+    return json;
+}
+function forwardStampPath(projectId, sessionId) {
+    return path.join(stateDir(), `mechanic-friction-forward-${projectId}-${sessionId}.json`);
+}
+function shouldForward(projectId, sessionId, turnCount, stress) {
+    try {
+        const prior = JSON.parse(fs.readFileSync(forwardStampPath(projectId, sessionId), 'utf-8'));
+        return prior.turnCount !== turnCount || prior.stress !== stress;
+    }
+    catch {
+        return true;
+    }
+}
+function stampForward(projectId, sessionId, turnCount, stress) {
+    const file = forwardStampPath(projectId, sessionId);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, JSON.stringify({ turnCount, stress, at: new Date().toISOString() }, null, 2) + '\n');
+}
+async function forwardStressMechanicFriction(input) {
+    if (!shouldForward(input.projectId, input.sourceSessionId, input.turnCount, input.stress))
+        return;
+    const event = {
+        source: 'hook',
+        summary: 'Live stress detector fired for this working session. The session is likely repeating a tool/action, retrying after errors, or churning on the same file.',
+        cwd: input.cwd,
+        projectId: input.projectId,
+        projectName: input.projectName,
+        sourceSessionId: input.sourceSessionId,
+        tier: 'unsure',
+        stress: input.stress,
+        stressScore: input.stressScore ?? null,
+        turnCount: input.turnCount,
+        signals: ['live-stress', input.stress >= 2 ? 'high' : 'elevated'],
+        transcriptPath: input.transcriptPath ?? null,
+        platform: input.platform ?? null,
+        createdAt: new Date().toISOString(),
+    };
+    await postMechanicFriction(input.apiUrl, input.apiKey, event);
+    stampForward(input.projectId, input.sourceSessionId, input.turnCount, input.stress);
+}
+//# sourceMappingURL=mechanic-friction.js.map

package/dist/mechanic-friction.js.map

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

package/dist/mechanic-role.d.ts

@@ -0,0 +1,20 @@
+import { ProjectAnchor } from './project-anchor';
+export declare const MECHANIC_ROLE = "mechanic";
+export declare function isMechanicProject(anchor: ProjectAnchor): boolean;
+export declare function readMechanicSessionId(anchor: ProjectAnchor): string | null;
+export declare function readMechanicRoleEpoch(anchor: ProjectAnchor): string | null;
+export declare function isMechanicSession(anchor: ProjectAnchor, sessionId: string | null | undefined): boolean;
+export declare function setMechanicProject(cwd: string, sessionId?: string | null): {
+    anchor: ProjectAnchor;
+    anchorPath: string;
+    mechanicSessionId: string | null;
+};
+export declare function clearMechanicProject(cwd: string): {
+    anchor: ProjectAnchor;
+    anchorPath: string;
+};
+export declare function readMechanicRole(cwd: string): {
+    anchor: ProjectAnchor;
+    isMechanic: boolean;
+    mechanicSessionId: string | null;
+};

package/dist/mechanic-role.js

@@ -0,0 +1,107 @@
+"use strict";
+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.MECHANIC_ROLE = void 0;
+exports.isMechanicProject = isMechanicProject;
+exports.readMechanicSessionId = readMechanicSessionId;
+exports.readMechanicRoleEpoch = readMechanicRoleEpoch;
+exports.isMechanicSession = isMechanicSession;
+exports.setMechanicProject = setMechanicProject;
+exports.clearMechanicProject = clearMechanicProject;
+exports.readMechanicRole = readMechanicRole;
+const fs = __importStar(require("fs"));
+const project_anchor_1 = require("./project-anchor");
+const session_id_1 = require("./session-id");
+exports.MECHANIC_ROLE = 'mechanic';
+const MECHANIC_SESSION_KEY = 'mechanic_session_id';
+const MECHANIC_EPOCH_KEY = 'mechanic_role_set_at';
+function isMechanicProject(anchor) {
+    return anchor.role === exports.MECHANIC_ROLE;
+}
+function readRawAnchor(anchorPath) {
+    try {
+        return JSON.parse(fs.readFileSync(anchorPath, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+function writeRawAnchor(anchorPath, raw) {
+    fs.writeFileSync(anchorPath, JSON.stringify(raw, null, 2) + '\n');
+}
+function readMechanicSessionId(anchor) {
+    const raw = readRawAnchor(anchor.anchorPath);
+    return (0, session_id_1.truncateSessionId)(typeof raw[MECHANIC_SESSION_KEY] === 'string' ? raw[MECHANIC_SESSION_KEY] : null);
+}
+function readMechanicRoleEpoch(anchor) {
+    const raw = readRawAnchor(anchor.anchorPath);
+    const value = raw[MECHANIC_EPOCH_KEY];
+    return typeof value === 'string' && value.trim() ? value : null;
+}
+function isMechanicSession(anchor, sessionId) {
+    if (!isMechanicProject(anchor))
+        return false;
+    const mechanicSessionId = readMechanicSessionId(anchor);
+    if (!mechanicSessionId)
+        return true;
+    return (0, session_id_1.truncateSessionId)(sessionId) === mechanicSessionId;
+}
+function setMechanicProject(cwd, sessionId) {
+    const { anchorPath } = (0, project_anchor_1.setProjectRole)(cwd, exports.MECHANIC_ROLE);
+    const raw = readRawAnchor(anchorPath);
+    raw.role = exports.MECHANIC_ROLE;
+    raw[MECHANIC_EPOCH_KEY] = new Date().toISOString();
+    const mechanicSessionId = (0, session_id_1.truncateSessionId)(sessionId);
+    if (mechanicSessionId)
+        raw[MECHANIC_SESSION_KEY] = mechanicSessionId;
+    else
+        delete raw[MECHANIC_SESSION_KEY];
+    writeRawAnchor(anchorPath, raw);
+    return { anchor: (0, project_anchor_1.readAnchor)(cwd), anchorPath, mechanicSessionId };
+}
+function clearMechanicProject(cwd) {
+    const { anchorPath } = (0, project_anchor_1.setProjectRole)(cwd, null);
+    const raw = readRawAnchor(anchorPath);
+    delete raw.role;
+    delete raw[MECHANIC_SESSION_KEY];
+    delete raw[MECHANIC_EPOCH_KEY];
+    writeRawAnchor(anchorPath, raw);
+    return { anchor: (0, project_anchor_1.readAnchor)(cwd), anchorPath };
+}
+function readMechanicRole(cwd) {
+    const anchor = (0, project_anchor_1.readAnchor)(cwd);
+    return { anchor, isMechanic: isMechanicProject(anchor), mechanicSessionId: readMechanicSessionId(anchor) };
+}
+//# sourceMappingURL=mechanic-role.js.map

package/dist/mechanic-role.js.map

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

package/dist/opencode-plugin.bundle.js

@@ -1746,9 +1746,9 @@ function crushMessages(messages, opts) {
 }
 
 // src/session-id.ts
-function armMonitorCommand(short, ownerPid, assistant = false) {
+function armMonitorCommand(short, ownerPid, assistant = false, mechanic = false) {
   const owner = ownerPid ? ` --owner-pid ${ownerPid}` : "";
-  const role = assistant ? " --assistant" : "";
+  const role = mechanic ? " --mechanic" : assistant ? " --assistant" : "";
   const watch = `greprag inbox watch --session ${short} --json${owner}${role}`;
   return `while true; do ${watch}; case $? in 0|64) break;; esac; sleep 1; done`;
 }
@@ -1756,7 +1756,7 @@ function armMonitorCommand(short, ownerPid, assistant = false) {
 // src/commands/inbox-primer-reminder.ts
 function buildInboxPrimer(env) {
   const codex = env.platform === "codex";
-  const arm = armMonitorCommand(env.short, env.ownerPid, env.assistant);
+  const arm = armMonitorCommand(env.short, env.ownerPid, env.assistant, env.mechanic);
   return [
     // LEAD — the forcing function (restored 2026-06-22). ARM is an ALARM, not reference:
     // you are unreachable until you do it, and it must be re-done every time the watcher
@@ -1928,7 +1928,7 @@ function buildArmReminder(d, env) {
   if (d.tier === "silent")
     return null;
   const unread = Number(d.detail && d.detail.unread || 0);
-  const arm = env ? `ToolSearch select:Monitor \u2192 persistent Monitor (timeout_ms:3600000) command: \`${armMonitorCommand(env.short, env.ownerPid, env.assistant)}\`` : `arm your Monitor inbox watcher`;
+  const arm = env ? `ToolSearch select:Monitor \u2192 persistent Monitor (timeout_ms:3600000) command: \`${armMonitorCommand(env.short, env.ownerPid, env.assistant, env.mechanic)}\`` : `arm your Monitor inbox watcher`;
   const grounded = `greprag reads your watcher as DOWN (isLocallyArmed=false \u2014 a real pidfile check on your session, NOT a timer; the hook CAN see your watcher)`;
   if (unread > 0) {
     return `\u26A0 A peer messaged you (${unread} waiting) & ${grounded}. You're unreachable. Arm + answer NOW, don't reason past this: ${arm}, then \`greprag inbox\`.`;
@@ -1955,7 +1955,25 @@ function frictionReminderTier(stress) {
     return "nudge";
   return "silent";
 }
-function buildFrictionReminder(tier) {
+function routeCommand(env) {
+  const platform = env?.platform || "<harness>";
+  return `greprag mechanic friction "<summary>" --tier sentence|mechanism|unsure --signal <why> --platform ${platform}`;
+}
+function buildMechanicLiveNotice(env) {
+  return `GrepRAG Mechanic is live. Default assumption: this working session is NOT the Mechanic; route future friction with \`${routeCommand(env)}\`, then keep working. Check role only when needed: \`greprag mechanic role\`.`;
+}
+function buildFrictionReminder(tier, env) {
+  const routed = !!env?.mechanicLive && !env?.mechanic;
+  if (routed) {
+    switch (tier) {
+      case "nag":
+        return `\u26A0 FRICTION HIGH (live signal: repetition / errors / churn) \u2014 a live Mechanic exists, so this stress signal is being auto-forwarded. Add specifics if useful: \`${routeCommand(env)}\`; otherwise keep working.`;
+      case "nudge":
+        return `\u26A0 Friction detected (live signal) \u2014 a live Mechanic exists, so this stress signal is being auto-forwarded. Add specifics if useful: \`${routeCommand(env)}\`; otherwise keep working.`;
+      default:
+        return null;
+    }
+  }
   switch (tier) {
     case "nag":
       return '\u26A0 FRICTION HIGH (live signal: repetition / errors / churn) \u2014 STOP pushing through; fix the PATTERN now \u2192 `greprag load reflex-chip` (sentence-tier) or `greprag load workshop-chip` (machinery), then spawn_task. No friction? say "clear" + continue.';
@@ -1970,10 +1988,11 @@ var WORKSHOP_METHOD = "spawn a workshop chip \u2014 `greprag load workshop-chip`
 function buildMechanicAnnounce() {
   return [
     "[Active Mechanic \u2014 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 \u2014 repeated yourself, fought a tool, got corrected \u22652\xD7 on the same thing, or rediscovered something already known \u2014 fix the PATTERN now; do not push through.",
-    `SENTENCE-TIER friction (the fix is words in a file you own \u2014 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 \u2014 no gate to wait at.`,
-    `MECHANISM-TIER friction (the fix is machinery \u2014 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) \xB7 log (`greprag fix log "<obs>"` to queue it for /mechanic) \xB7 ask-human (the operator must decide).',
+    "DEFAULT POSTURE: assume this session is NOT the Mechanic. The exception is explicit role signal: `greprag mechanic role` says `current: ... (will arm with --mechanic)` or the hook names this session as mechanic.",
+    'WHEN friction happens in a normal working session \u2014 repeated yourself, fought a tool, got corrected >=2x on the same thing, or rediscovered something already known \u2014 send `greprag mechanic friction "<summary>" --tier sentence|mechanism|unsure --signal <why> --platform <harness>` and keep working. The stress hook auto-forwards broad repetition/error/churn.',
+    `WHEN this session IS the Mechanic: fix the PATTERN now; do not push through. SENTENCE-TIER friction (words in a file you own \u2014 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 \u2014 no gate to wait at.`,
+    `MECHANISM-TIER friction for the Mechanic (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): route (`greprag mechanic friction ...`) \xB7 fix (Mechanic or local blocking repair) \xB7 log (`greprag fix log "<obs>"` to queue it for /mechanic) \xB7 ask-human (the operator must decide).',
     "Every repair is ROOT-CAUSE \u2014 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 \u2014 repetition / errors / churn), never on a timer \u2014 act on it, or say "clear" and continue.'
   ].join("\n");
@@ -1981,10 +2000,25 @@ function buildMechanicAnnounce() {
 var mechanicFrictionModule = {
   id: "mechanic-friction",
   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)
+  // Stress fires the real friction reminder. A designated Mechanic also creates a
+  // one-shot ambient route notice per source session/role epoch (hook-stamped).
+  detect: (env) => {
+    const tier = frictionReminderTier(env.stress);
+    if (tier !== "silent")
+      return { tier };
+    if (env.mechanicLiveNotice && !env.mechanic)
+      return { tier: "ambient" };
+    return { tier: "silent" };
+  },
+  announce: (env = {}) => {
+    const base = buildMechanicAnnounce();
+    if (env.mechanicLive && !env.mechanic)
+      return `${base}
+
+${buildMechanicLiveNotice(env)}`;
+    return base;
+  },
+  reminder: (d, env) => d.tier === "ambient" ? buildMechanicLiveNotice(env) : buildFrictionReminder(d.tier, env)
 };
 
 // src/commands/coordinate-gate.ts

package/dist/session-id.d.ts

@@ -79,7 +79,7 @@ export declare function buildSessionIdContext(short: string, alias?: string | nu
  *  made the wrapper unsafe before. The layers: this loop relaunches a dead
  *  SUPERVISOR; the supervisor respawns a dead SSE CHILD; EPIPE-terminal stops
  *  everything when the consumer leaves. adr: adr/monitor-resilience.md */
-export declare function armMonitorCommand(short: string, ownerPid?: number | null, assistant?: boolean): string;
+export declare function armMonitorCommand(short: string, ownerPid?: number | null, assistant?: boolean, mechanic?: boolean): string;
 /** Handle `greprag-hook session-id`. Reads the Claude Code hook payload
  *  from `input.session_id`, emits a JSON response with hookSpecificOutput.
  *  additionalContext to stdout. Silent on missing session_id (other hook