greprag 5.65.2 → 5.65.3

package/dist/native-skill-mirror.d.ts

@@ -0,0 +1,30 @@
+/** Materialize exact GrepRAG skill mirrors into native harness registries. */
+import { type SkillFile } from './skill-mirror-files';
+export type NativeSkillPlatform = 'claude-code' | 'codex' | 'opencode';
+export interface NativeMirroredSkill {
+    skillName: string;
+    files: SkillFile[];
+}
+export interface NativeSkillMirrorResult {
+    installed: number;
+    updated: number;
+    current: number;
+    removed: number;
+    skipped: number;
+    blocked: number;
+}
+export declare function nativeSkillRoot(platform: NativeSkillPlatform, homeDir?: string): string;
+/** Apply an exact snapshot. Existing non-GrepRAG directories are never touched. */
+export declare function applyNativeSkillMirror(params: {
+    platform: NativeSkillPlatform;
+    skills: NativeMirroredSkill[];
+    homeDir?: string;
+    prune?: boolean;
+}): NativeSkillMirrorResult;
+export declare function syncNativeSkillMirror(params: {
+    platform: NativeSkillPlatform;
+    apiUrl: string;
+    apiKey: string;
+    homeDir?: string;
+}): Promise<NativeSkillMirrorResult>;
+export declare function nativeSkillMirrorSummary(result: NativeSkillMirrorResult): string;

package/dist/native-skill-mirror.js

@@ -0,0 +1,230 @@
+"use strict";
+/** Materialize exact GrepRAG skill mirrors into native harness registries. */
+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.nativeSkillRoot = nativeSkillRoot;
+exports.applyNativeSkillMirror = applyNativeSkillMirror;
+exports.syncNativeSkillMirror = syncNativeSkillMirror;
+exports.nativeSkillMirrorSummary = nativeSkillMirrorSummary;
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const skill_mirror_files_1 = require("./skill-mirror-files");
+const SKILL_NAME_RE = /^[A-Za-z0-9._-]{1,64}$/;
+const STATE_FILE = '.greprag-mirror.json';
+function nativeSkillRoot(platform, homeDir = os.homedir()) {
+    if (platform === 'claude-code')
+        return path.join(homeDir, '.claude', 'skills');
+    if (platform === 'codex')
+        return path.join(homeDir, '.codex', 'skills');
+    return path.join(homeDir, '.config', 'opencode', 'skills');
+}
+function emptyState() {
+    return { version: 1, skills: {} };
+}
+function readState(root) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(path.join(root, STATE_FILE), 'utf8'));
+        if (parsed?.version === 1 && parsed.skills && typeof parsed.skills === 'object')
+            return parsed;
+    }
+    catch { /* first run or corrupt state: existing directories remain unmanaged */ }
+    return emptyState();
+}
+function writeState(root, state) {
+    fs.mkdirSync(root, { recursive: true });
+    fs.writeFileSync(path.join(root, STATE_FILE), JSON.stringify(state, null, 2) + '\n', 'utf8');
+}
+function targetPath(root, skillName) {
+    const target = path.resolve(root, skillName);
+    const prefix = path.resolve(root) + path.sep;
+    if (!target.startsWith(prefix))
+        throw new Error('skill target escapes native root');
+    return target;
+}
+function filePath(target, relative) {
+    const resolved = path.resolve(target, ...relative.split('/'));
+    const prefix = path.resolve(target) + path.sep;
+    if (!resolved.startsWith(prefix))
+        throw new Error('skill file escapes target directory');
+    return resolved;
+}
+function readManagedFiles(target, managed) {
+    try {
+        return managed.files.map(relative => ({
+            path: relative,
+            content: fs.readFileSync(filePath(target, relative), 'utf8'),
+        }));
+    }
+    catch {
+        return null;
+    }
+}
+function removeTrackedFiles(target, relativeFiles) {
+    const directories = new Set();
+    for (const relative of relativeFiles) {
+        const file = filePath(target, relative);
+        try {
+            fs.unlinkSync(file);
+        }
+        catch { /* missing or locked: preserve and continue */ }
+        let dir = path.dirname(file);
+        while (dir.startsWith(path.resolve(target) + path.sep)) {
+            directories.add(dir);
+            dir = path.dirname(dir);
+        }
+    }
+    for (const dir of [...directories].sort((a, b) => b.length - a.length)) {
+        try {
+            fs.rmdirSync(dir);
+        }
+        catch { /* nonempty directories are preserved */ }
+    }
+    try {
+        fs.rmdirSync(target);
+    }
+    catch { /* nonempty target is preserved */ }
+}
+/** Apply an exact snapshot. Existing non-GrepRAG directories are never touched. */
+function applyNativeSkillMirror(params) {
+    const root = nativeSkillRoot(params.platform, params.homeDir);
+    const state = readState(root);
+    const result = {
+        installed: 0, updated: 0, current: 0, removed: 0, skipped: 0, blocked: 0,
+    };
+    const present = new Set();
+    for (const skill of params.skills) {
+        if (!SKILL_NAME_RE.test(skill.skillName)) {
+            result.skipped++;
+            continue;
+        }
+        present.add(skill.skillName);
+        if (!skill.files.some(file => file.path === 'SKILL.md')
+            || !skill.files.every(skill_mirror_files_1.isSafeMirroredSkillFile)) {
+            result.skipped++;
+            continue;
+        }
+        const target = targetPath(root, skill.skillName);
+        const managed = state.skills[skill.skillName];
+        if (fs.existsSync(target) && !managed) {
+            result.skipped++;
+            continue;
+        }
+        const nextHash = (0, skill_mirror_files_1.computeSkillFileHash)(skill.files);
+        if (managed) {
+            const currentFiles = readManagedFiles(target, managed);
+            if (!currentFiles || (0, skill_mirror_files_1.computeSkillFileHash)(currentFiles) !== managed.hash) {
+                result.blocked++;
+                continue;
+            }
+            if (managed.hash === nextHash) {
+                result.current++;
+                continue;
+            }
+        }
+        fs.mkdirSync(target, { recursive: true });
+        for (const file of skill.files) {
+            const destination = filePath(target, file.path);
+            fs.mkdirSync(path.dirname(destination), { recursive: true });
+            fs.writeFileSync(destination, file.content, 'utf8');
+        }
+        if (managed) {
+            const nextPaths = new Set(skill.files.map(file => file.path));
+            removeTrackedFiles(target, managed.files.filter(relative => !nextPaths.has(relative)));
+            result.updated++;
+        }
+        else {
+            result.installed++;
+        }
+        state.skills[skill.skillName] = {
+            hash: nextHash,
+            files: skill.files.map(file => file.path).sort(),
+        };
+    }
+    if (params.prune) {
+        for (const [skillName, managed] of Object.entries(state.skills)) {
+            if (present.has(skillName))
+                continue;
+            const target = targetPath(root, skillName);
+            const currentFiles = readManagedFiles(target, managed);
+            if (!currentFiles || (0, skill_mirror_files_1.computeSkillFileHash)(currentFiles) !== managed.hash) {
+                result.blocked++;
+                continue;
+            }
+            removeTrackedFiles(target, managed.files);
+            delete state.skills[skillName];
+            result.removed++;
+        }
+    }
+    writeState(root, state);
+    return result;
+}
+async function syncNativeSkillMirror(params) {
+    const list = await fetch(`${params.apiUrl}/v1/skillmirror`, {
+        headers: { Authorization: `Bearer ${params.apiKey}` },
+    });
+    if (!list.ok)
+        throw new Error(`skill mirror list failed: HTTP ${list.status}`);
+    const data = await list.json();
+    const names = (data.skills || [])
+        .map(row => row.skillName)
+        .filter((name) => typeof name === 'string' && SKILL_NAME_RE.test(name));
+    const fetched = await Promise.all(names.map(async (skillName) => {
+        const response = await fetch(`${params.apiUrl}/v1/skillmirror/${encodeURIComponent(skillName)}`, {
+            headers: { Authorization: `Bearer ${params.apiKey}` },
+        });
+        if (!response.ok)
+            return null;
+        const body = await response.json();
+        return Array.isArray(body.files) ? { skillName, files: body.files } : null;
+    }));
+    if (fetched.some(skill => skill === null)) {
+        throw new Error('skill mirror snapshot incomplete; existing native adapters preserved');
+    }
+    const skills = fetched;
+    return applyNativeSkillMirror({
+        platform: params.platform,
+        skills,
+        homeDir: params.homeDir,
+        prune: true,
+    });
+}
+function nativeSkillMirrorSummary(result) {
+    const active = result.installed + result.updated + result.current;
+    const exceptions = result.skipped + result.blocked;
+    return `Native skill mirror: ${active} active, ${result.removed} removed`
+        + (exceptions ? `, ${exceptions} preserved collision(s)` : '');
+}
+//# sourceMappingURL=native-skill-mirror.js.map

package/dist/native-skill-mirror.js.map

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

package/dist/opencode-plugin.bundle.js

@@ -1828,7 +1828,7 @@ var OPENCODE_CHIP_SPAWN_POINTER = [
 ].join("\n");
 var CODEX_CHIP_SPAWN_POINTER = [
   "[greprag Codex delegation \u2014 internal subagent, 1\u20132-chip quick path with the initiator as LEAD, or a separate LEAD for larger/seamed missions.]",
-  "\u2022 About to delegate a Codex task? \u2192 run `greprag load codex-chip-spawn` FIRST. Use exact first-line titles `LEAD: <Mission>` and `Chip A/B/C: <Specific Purview>`. Chips are ordinary writable native tasks; completion is a native Codex task reply to the LEAD after committing. A `MECHANIC: <Mission>` task loads `greprag load mechanic` first."
+  "\u2022 About to delegate a Codex task? \u2192 run `greprag load codex-chip-spawn` FIRST. Use exact first-line titles `LEAD: <Mission>`, `Chip A/B/C: <Specific Purview>`, and `FIX: <one friction unit>`. Chips are ordinary writable native tasks; completion is a native Codex task reply to the LEAD after committing. A `FIX:` task loads `greprag load mechanic` first."
 ].join("\n");
 var loadPrimerModule = {
   id: "load-primer",
@@ -2224,9 +2224,14 @@ function buildSkillMirrorAnnounce(m) {
     return `[greprag load skills: all ${m.count} canonical mirrored skills are already advertised by this harness; use \`greprag load <skill>\` to read the canonical payload.]`;
   }
   const header = [
-    "## GrepRAG Load Skills",
-    `These ${m.skills.length} canonical mirrored skills are available through \`greprag load\`` + (m.nativeCount > 0 ? ` (${m.nativeCount} native-advertised duplicate${m.nativeCount === 1 ? "" : "s"} omitted)` : "") + ".",
-    "When the user names a skill (with or without `/`) or the task clearly matches a description below, run `greprag load <skill>` before acting. The command returns the full canonical method; this list is its activation index.",
+    "## GrepRAG Skill Adapter Fallback",
+    `Native registration is missing for ${m.skills.length} mirrored skills; their exact payload remains available through \`greprag load\`` + (m.nativeCount > 0 ? ` (${m.nativeCount} native-advertised duplicate${m.nativeCount === 1 ? "" : "s"} omitted)` : "") + ".",
+    "",
+    "### Trigger Rules",
+    "If the user names a skill (with or without `/`) OR the request clearly matches a skill's description below, you MUST activate that skill for the current turn. Match meaning, not exact keywords.",
+    "",
+    "### Invocation",
+    "To activate a skill, run `greprag load <skill-name>` before responding or taking action. Read the returned instructions completely, then follow them for the current turn.",
     ""
   ].join("\n");
   let output = header;

package/dist/skill-mirror-client.d.ts

@@ -9,10 +9,8 @@
  *  last-mirrored hash per skill so an unchanged skill costs one hash pass and
  *  ZERO network. Markdown only, v1 — SKILL.md + docs/**\/*.md; script-bearing
  *  assets stay file-bound (see the spec's named gaps). */
-export interface SkillFile {
-    path: string;
-    content: string;
-}
+import { type SkillFile } from './skill-mirror-files';
+export type { SkillFile } from './skill-mirror-files';
 /** Collect the skill's markdown: SKILL.md (required) + docs/**\/*.md, capped.
  *  Returns null when the dir has no SKILL.md. Never throws. */
 export declare function collectSkillFiles(skillDir: string): SkillFile[] | null;
@@ -34,4 +32,3 @@ export declare function maybeMirrorSkill(params: {
     apiUrl: string;
     apiKey: string;
 }): Promise<MirrorOutcome>;
-export {};

package/dist/skill-mirror-client.js

@@ -51,8 +51,9 @@ exports.writeMirrorState = writeMirrorState;
 exports.maybeMirrorSkill = maybeMirrorSkill;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const crypto = __importStar(require("crypto"));
 const skill_landing_1 = require("./skill-landing");
+const native_skill_mirror_1 = require("./native-skill-mirror");
+const skill_mirror_files_1 = require("./skill-mirror-files");
 /** Mirrors the server's caps (SKILL_MIRROR_* in @greprag/core — the CLI is
  *  core-free, so the numbers are restated; the server re-validates anyway). */
 const MAX_FILES = 20;
@@ -110,11 +111,19 @@ function collectSkillFiles(skillDir) {
 }
 /** Deterministic content hash over path+content pairs. PURE — unit-tested. */
 function computeMirrorHash(files) {
-    const h = crypto.createHash('sha256');
-    for (const f of [...files].sort((a, b) => a.path.localeCompare(b.path))) {
-        h.update(f.path).update('\0').update(f.content).update('\0');
+    return (0, skill_mirror_files_1.computeSkillFileHash)(files);
+}
+function materializeLocally(skillName, files) {
+    for (const platform of ['claude-code', 'codex', 'opencode']) {
+        try {
+            (0, native_skill_mirror_1.applyNativeSkillMirror)({
+                platform,
+                skills: [{ skillName, files }],
+                prune: false,
+            });
+        }
+        catch { /* local adapter failure never breaks turn capture */ }
     }
-    return h.digest('hex');
 }
 function statePath() {
     const home = process.env.HOME || process.env.USERPROFILE || '';
@@ -152,8 +161,10 @@ async function maybeMirrorSkill(params) {
             return 'skipped';
         const hash = computeMirrorHash(files);
         const state = readMirrorState();
-        if (state.skills[params.skill]?.hash === hash)
+        if (state.skills[params.skill]?.hash === hash) {
+            materializeLocally(params.skill, files);
             return 'fresh';
+        }
         const res = await fetch(`${params.apiUrl}/v1/skillmirror/${encodeURIComponent(params.skill)}`, {
             method: 'POST',
             headers: { 'Authorization': `Bearer ${params.apiKey}`, 'Content-Type': 'application/json' },
@@ -163,6 +174,7 @@ async function maybeMirrorSkill(params) {
             return 'skipped';
         state.skills[params.skill] = { hash, mirroredAt: new Date().toISOString() };
         writeMirrorState(state);
+        materializeLocally(params.skill, files);
         return 'mirrored';
     }
     catch {

package/dist/skill-mirror-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-mirror-client.js","sourceRoot":"","sources":["../src/skill-mirror-client.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;0DAU0D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmB1D,8CA8BC;AAGD,8CAMC;AAWD,0CAQC;AAED,4CAMC;AAOD,4CA+BC;AAzHD,uCAAyB;AACzB,2CAA6B;AAC7B,+CAAiC;AACjC,mDAAkD;AAElD;+EAC+E;AAC/E,MAAM,SAAS,GAAG,EAAE,CAAC;AACrB,MAAM,cAAc,GAAG,OAAO,CAAC;AAO/B;+DAC+D;AAC/D,SAAgB,iBAAiB,CAAC,QAAgB;IAChD,IAAI,CAAC;QACH,MAAM,KAAK,GAAgB,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAChD,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YAAC,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;QACxE,IAAI,IAAI,CAAC,MAAM,GAAG,cAAc;YAAE,OAAO,IAAI,CAAC,CAAC,8CAA8C;QAC7F,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,GAAW,EAAQ,EAAE;YAC9C,IAAI,OAAoB,CAAC;YACzB,IAAI,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,OAAO;YAAC,CAAC;YACjF,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;gBACrE,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS;oBAAE,OAAO;gBACtC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;gBACnC,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;gBACnC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;oBAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;oBAAC,SAAS;gBAAC,CAAC;gBACtD,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;oBAAE,SAAS;gBACpD,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;oBAC9C,IAAI,OAAO,CAAC,MAAM,IAAI,cAAc;wBAAE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC/E,CAAC;gBAAC,MAAM,CAAC,CAAC,uBAAuB,CAAC,CAAC;YACrC,CAAC;QACH,CAAC,CAAC;QACF,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,SAAgB,iBAAiB,CAAC,KAAkB;IAClD,MAAM,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACxE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC;AAMD,SAAS,SAAS;IAChB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;IAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;AACnE,CAAC;AAED,SAAgB,eAAe;IAC7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,EAAE,OAAO,CAAC,CAAyB,CAAC;QACzF,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YACjE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAA+B,EAAE,CAAC;QAC5D,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,gCAAgC,CAAC,CAAC;IAC5C,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AACxB,CAAC;AAED,SAAgB,gBAAgB,CAAC,KAAkB;IACjD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC;QACzB,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC,CAAC,+DAA+D,CAAC,CAAC;AAC7E,CAAC;AAMD,mFAAmF;AAC5E,KAAK,UAAU,gBAAgB,CAAC,MAKtC;IACC,IAAI,CAAC;QACH,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACnE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;QAClE,MAAM,GAAG,GAAG,IAAA,+BAAe,EAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC/D,IAAI,CAAC,GAAG;YAAE,OAAO,SAAS,CAAC;QAC3B,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAE7B,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;QAChC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,KAAK,IAAI;YAAE,OAAO,OAAO,CAAC;QAE9D,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,mBAAmB,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE;YAC7F,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,eAAe,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC3F,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;SACnD,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,SAAS,CAAC;QAE9B,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QAC5E,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACxB,OAAO,UAAU,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}
+{"version":3,"file":"skill-mirror-client.js","sourceRoot":"","sources":["../src/skill-mirror-client.ts"],"names":[],"mappings":"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"}

package/dist/skill-mirror-files.d.ts

@@ -0,0 +1,6 @@
+export interface SkillFile {
+    path: string;
+    content: string;
+}
+export declare function computeSkillFileHash(files: SkillFile[]): string;
+export declare function isSafeMirroredSkillFile(file: SkillFile): boolean;

package/dist/skill-mirror-files.js

@@ -0,0 +1,51 @@
+"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.computeSkillFileHash = computeSkillFileHash;
+exports.isSafeMirroredSkillFile = isSafeMirroredSkillFile;
+const crypto = __importStar(require("node:crypto"));
+function computeSkillFileHash(files) {
+    const hash = crypto.createHash('sha256');
+    for (const file of [...files].sort((a, b) => a.path.localeCompare(b.path))) {
+        hash.update(file.path).update('\0').update(file.content).update('\0');
+    }
+    return hash.digest('hex');
+}
+function isSafeMirroredSkillFile(file) {
+    if (file.path === 'SKILL.md')
+        return true;
+    return /^docs\/(?!.*(?:^|\/)\.\.(?:\/|$))[A-Za-z0-9._\/-]+\.md$/.test(file.path);
+}
+//# sourceMappingURL=skill-mirror-files.js.map

package/dist/skill-mirror-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-mirror-files.js","sourceRoot":"","sources":["../src/skill-mirror-files.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA,oDAMC;AAED,0DAGC;AAlBD,oDAAsC;AAOtC,SAAgB,oBAAoB,CAAC,KAAkB;IACrD,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC3E,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,SAAgB,uBAAuB,CAAC,IAAe;IACrD,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,yDAAyD,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnF,CAAC"}

package/package.json

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

package/skill/greprag/docs/codex-chip.md

@@ -6,14 +6,15 @@ Use `greprag load codex-chip-spawn` for the three-primitives method:
   worktree, manifest, inbox, or goal);
 - quick mode: rename the current task `LEAD: <Mission>` and directly spawn
   1–2 visible `Chip A/B: <Specific Purview>` worktree tasks;
-- Leader mode: create a separate `LEAD: <Mission>` task before spawning
+- Leader mode: rename the current task `PLANNER: <Mission>`, then create a
+  separate `LEAD: <Mission>` task before that LEAD spawns
   `Chip A/B/C: <Specific Purview>` children for seams or larger orchestration.
 
 Normal chips are writable and own discovery, design, implementation, tests, and
 commit. Preserve the Codex-provided worktree, committed result artifact, and
 parent cleanup. The child opening prompt starts with the exact visible title
-alone (`Chip A: <Specific Purview>`, `LEAD: <Mission>`, `ADVISOR: <Purview>`, or
-`MECHANIC: <Mission>`) and then has exactly three sections:
+alone (`Chip A: <Specific Purview>`, `LEAD: <Mission>`, `PLANNER: <Mission>`,
+`ADVISOR: <Purview>`, or `FIX: <one friction unit>`) and then has exactly three sections:
 `Setup — do this FIRST`, `Task`, and `Report when done`. It has no lease,
 read-only, mandatory nested-goal, or nonce/ACK requirement. Completion is the
 native Codex parent-child task reply: commit the durable result, then reply to

package/skill/templates/chip-leader.md

@@ -1,4 +1,4 @@
-# Leader Mission
+# Planner + Leader Mission
 
 Load this method when the work needs a dedicated orchestrator: more than the
 quick 1–2 visible chips, shared files or contracts, ordering, integration, or
@@ -6,13 +6,23 @@ another coordination seam.
 
 ## Identity first
 
-Before any child is created, the orchestrating task becomes the dedicated
-leader by renaming itself exactly:
+This is the explicit Leader shape. Before any child is created, the initiating
+task becomes the planner by renaming itself exactly:
+
+```text
+PLANNER: <Mission>
+```
+
+The PLANNER then creates one separate task whose exact first-line title is:
 
 ```text
 LEAD: <Mission>
 ```
 
+Do not leave the initiator unnamed, and do not name it LEAD when it creates a
+separate LEAD. The title split makes planning authority and execution
+leadership visible before fanout.
+
 Children use the exact ordinal discoverability schema:
 
 ```text
@@ -24,13 +34,21 @@ Chip C: <Specific Purview>
 Naming identifies the workstream and makes the task legible. It does not grant
 execution authority; every child remains an ordinary writable chip.
 
+<!-- adr: adr/codex-lead-native-goal.md -->
+After the PLANNER creates it and before fanout, the dedicated LEAD creates a
+native top-level mission goal with `create_goal`, then runs `get_goal` and
+verifies the active goal names this mission before fanout. That native goal
+tracks the LEAD mission; it is not a GrepRAG lease, durable manifest, or child
+permission gate.
+
 ## Quick versus Leader
 
 - **Quick:** the current task renames itself `LEAD: <Mission>` and directly
   spawns 1–2 children. No separate leader task is created.
-- **Leader:** the initiator creates a separate `LEAD: <Mission>` task. That
-  dedicated task owns decomposition, child dispatch, seam reconciliation,
-  checks, integration, parent messaging, and cleanup.
+- **Leader:** the initiator first renames itself `PLANNER: <Mission>`, then
+  creates a separate `LEAD: <Mission>` task. That dedicated task owns
+  decomposition, child dispatch, seam reconciliation, checks, integration,
+  parent messaging, and cleanup.
 
 This template is for the second shape. If the mission fits the quick shape,
 load `greprag load codex-chip-spawn` and keep the initiator as the implicit
@@ -56,14 +74,18 @@ ordering in the brief rather than relying on hidden coordination metadata.
 
 ## Dispatch and closeout
 
-1. Rename the leader task before the first child spawn.
-2. Spawn each `Chip A/B/C: <Specific Purview>` with its own visible worktree
-   and the mission context it needs.
-   A child titled exactly `MECHANIC: <Mission>` must make `greprag load mechanic`
-   its first Setup action before diagnosis or edits.
-3. Keep children writable and let them investigate, edit, test, and commit
+1. Rename the initiating task `PLANNER: <Mission>` before any child creation.
+2. Create the separate `LEAD: <Mission>` task; do not dispatch worker chips
+   directly from the PLANNER.
+3. In the dedicated LEAD, create the native top-level mission goal with
+   `create_goal`, then verify it with `get_goal`.
+4. From the LEAD, spawn each `Chip A/B/C: <Specific Purview>` with its own
+   visible worktree and the mission context it needs.
+   A `FIX: <one friction unit>` child must make `greprag load mechanic` its
+   first Setup action before diagnosis or edits.
+5. Keep children writable and let them investigate, edit, test, and commit
    within their worktrees.
-4. Require each child to return `DONE` or `BLOCKED` through the native
+6. Require each child to return `DONE` or `BLOCKED` through the native
    parent-child task result, including the commit, checks, and caveats. Use
    `greprag send` only for explicit cross-harness or peer messaging:
 
@@ -73,9 +95,9 @@ ordering in the brief rather than relying on hidden coordination metadata.
      --from-session <child-session>
    ```
 
-5. Review reports, reconcile seams in the planned order, run the whole-mission
+7. Review reports, reconcile seams in the planned order, run the whole-mission
    checks, and send the parent a concise closeout.
-6. The parent owns integration and cleanup. Do not silently delete a child
+8. The parent owns integration and cleanup. Do not silently delete a child
    worktree or treat a report as acceptance.
 
 Do not introduce a separate read-only, lease, nested-goal, or delivery-proof