greprag 5.83.2 → 5.85.0

package/dist/hook.js

@@ -141,8 +141,8 @@ const procedure_shadow_1 = require("./procedure-shadow");
 const inline_atom_hook_1 = require("./inline-atom-hook");
 const inline_atom_background_1 = require("./inline-atom-background");
 const reminder_injector_1 = require("./reminder-injector");
-const skill_landing_1 = require("./skill-landing");
-const skill_mirror_client_1 = require("./skill-mirror-client");
+const skill_git_ingest_1 = require("./skill-git-ingest");
+const agents_1 = require("./commands/agents");
 const repodoc_client_1 = require("./repodoc-client");
 const native_skill_pending_1 = require("./native-skill-pending");
 const doc_mirror_client_1 = require("./doc-mirror-client");
@@ -851,41 +851,6 @@ async function fetchEnrichmentDown(apiUrl, apiKey) {
         return null;
     }
 }
-/** SessionStart pass: the Skill Learning Loop's LANDING leg
- *  (docs/skill-learning-loop.md — the write-back is CODE, not agent
- *  voluntarism). Fetch pending gains → auto-land reference-tier into each
- *  skill's docs/learnings.md → POST landed statuses back → return the report
- *  for the announce. Undefined on any error → announce silent, gains stay
- *  pending for the next session start. */
-async function fetchAndLandSkillGains(apiUrl, apiKey, anchor, cwd) {
-    try {
-        const res = await fetch(`${apiUrl}/v1/skillgain/${anchor.projectId}/pending`, {
-            headers: { 'Authorization': `Bearer ${apiKey}` },
-        });
-        if (!res.ok)
-            return undefined;
-        const data = await res.json();
-        const pending = (data.gains || []).filter(g => g.nodeId && g.skill && g.text);
-        if (pending.length === 0)
-            return undefined;
-        const homeDir = process.env.HOME || process.env.USERPROFILE || '';
-        const { report, statusUpdates } = (0, skill_landing_1.landPendingGains)(pending, cwd, homeDir, anchor.projectName);
-        if (statusUpdates.length > 0) {
-            try {
-                await fetch(`${apiUrl}/v1/skillgain/${anchor.projectId}/status`, {
-                    method: 'POST',
-                    headers: { 'Authorization': `Bearer ${apiKey}`, 'Content-Type': 'application/json' },
-                    body: JSON.stringify({ projectName: anchor.projectName, updates: statusUpdates }),
-                });
-            }
-            catch { /* statuses re-sync next start — the stamp keeps lands idempotent */ }
-        }
-        return report.landed.length > 0 ? report : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
 /** Manifest-liveness policy — mirror of core's assessLiveness threshold (the CLI
  *  is a zero-dep artifact, so the tiny policy is duplicated, like
  *  DOCPTR_ANNOUNCE_LIMIT). A doc must cite ≥3 in-repo paths with ≥60% dead before
@@ -1156,18 +1121,6 @@ async function store(input, source = 'claude-code') {
         }
         catch { /* fail-open — an inline-atom miss never fails the Stop hook */ }
     }
-    // Skill mirror (docs/load-system.md Tier 3): a skill-load turn shadows that
-    // skill's current markdown into the tenant's load store — upload ONLY on
-    // change (local hash state), so an unchanged skill costs zero network.
-    // Follower semantics: files stay canonical. Best-effort, never throws.
-    if (provenance === 'skill-injection') {
-        const mirrorSkill = (0, turn_provenance_1.provenanceHint)(provenance, turn.userPrompt);
-        if (mirrorSkill) {
-            await (0, skill_mirror_client_1.maybeMirrorSkill)({
-                skill: mirrorSkill, cwd, apiUrl: cfg.apiUrl, apiKey: cfg.apiKey,
-            });
-        }
-    }
     // Repo chunk index (adr/node-identity-port.md): the chunks are DERIVED from a
     // document plus the node graph committed beside it, so they are rebuilt when
     // the document moves rather than when someone remembers to run a push. Same
@@ -1525,7 +1478,7 @@ async function recap(input, mode = 'plain', opts = {}) {
         return;
     // Ensure the machine's desk-line is up (idempotent singleton). One per machine,
     // not per session — it long-polls the cloud and answers "what's truly live?"
-    // from local pidfile truth, so the Front Desk never reads a stale registry.
+    // from local pidfile truth, so the live-session list never comes from a stale registry.
     // The lock makes this a no-op on every SessionStart after the first.
     // adr: adr/desk-line-relay.md
     try {
@@ -1602,10 +1555,9 @@ async function recap(input, mode = 'plain', opts = {}) {
     // Enrichment-health signal (fix c2eb8777) — the live Gemini probe verdict.
     // Null when healthy or unreachable; a positive failure fires the outage announce.
     const enrichmentDownPromise = fetchEnrichmentDown(cfg.apiUrl, cfg.apiKey);
-    // Skill Learning Loop landing leg (docs/skill-learning-loop.md): pending
-    // gains → auto-land references into learnings docs, hold rule/scope
-    // proposals for the announce. Best-effort; undefined → announce silent.
-    const skillGainsPromise = fetchAndLandSkillGains(cfg.apiUrl, cfg.apiKey, anchor, cwd);
+    // The Skill Learning Loop no longer lands gains into skill folders: git owns
+    // skills and GrepRAG never edits their content (adr/skill-ownership-git.md).
+    const skillGainsPromise = Promise.resolve(undefined);
     // Tier-3 skill activation manifest (docs/load-system.md): fetch canonical
     // full descriptions, then omit skills this harness already advertises
     // natively. Best-effort; the renderer remains pure. The same roster is what
@@ -1613,6 +1565,20 @@ async function recap(input, mode = 'plain', opts = {}) {
     // extra round trip unless one is stale. adr: adr/skill-bundle-shape.md
     const mirroredSkillsPromise = (async () => {
         try {
+            // Git owns skills: ingest what is committed before reading the roster,
+            // so launchers and the manifest see the committed content. Cheap when
+            // nothing changed (one git ls-tree per source).
+            // adr: adr/skill-ownership-git.md
+            try {
+                const sources = (0, skill_git_ingest_1.gitSkillSources)(cwd);
+                const projectId = sources.find(source => source.scope === 'project')?.projectId;
+                const mirrorHashes = await (0, skill_git_ingest_1.fetchMirrorHashes)(cfg.apiUrl, cfg.apiKey, projectId);
+                await (0, skill_git_ingest_1.ingestCommittedSkills)({
+                    apiUrl: cfg.apiUrl, apiKey: cfg.apiKey, sources, mirrorHashes,
+                    harness: platform, sessionId: input.session_id,
+                });
+            }
+            catch { /* best effort: the next session start retries */ }
             const params = new URLSearchParams({ scope: 'effective', projectId: anchor.projectId });
             const res = await fetch(`${cfg.apiUrl}/v1/skillmirror?${params.toString()}`, {
                 headers: { 'Authorization': `Bearer ${cfg.apiKey}` },
@@ -1635,6 +1601,16 @@ async function recap(input, mode = 'plain', opts = {}) {
             return undefined;
         }
     })();
+    // The Codex/OpenCode AGENTS.md files follow ~/.claude/CLAUDE.md, the git
+    // source, and GrepRAG's read-only copy follows its last commit.
+    // adr: adr/skill-ownership-git.md
+    const instructionsPromise = (async () => {
+        try {
+            (0, agents_1.renderGlobalInstructions)();
+            await (0, agents_1.mirrorCommittedInstructions)({ apiUrl: cfg.apiUrl, apiKey: cfg.apiKey });
+        }
+        catch { /* best effort: the next session start retries */ }
+    })();
     // Equipped-loadouts signal (docs/loadout.md §activation model): the recipient's
     // self-inflating skill bundles. SessionStart fetch → the ONE advisor announce
     // line each; ALSO cached locally so the per-turn Match sensor reads it without
@@ -1726,6 +1702,7 @@ async function recap(input, mode = 'plain', opts = {}) {
         updateAvailablePromise,
         bodyPromise,
     ]);
+    await instructionsPromise;
     const equippedLoadouts = loadoutState.decls;
     // Loadout version-gate deficiency (docs/loadout.md §Version gating step 3): a
     // pending loadout whose equip floor is ABOVE the installed CLI version can't be

package/dist/index.js

@@ -75,7 +75,6 @@ const agents_1 = require("./commands/agents");
 const loadout_1 = require("./commands/loadout");
 const persona_1 = require("./commands/persona");
 const email_1 = require("./commands/email");
-const sms_1 = require("./commands/sms");
 const codex_1 = require("./commands/codex");
 const opencode_relay_1 = require("./commands/opencode-relay");
 const opencode_watch_1 = require("./commands/opencode-watch");
@@ -395,7 +394,7 @@ async function inbox(args) {
         // --local: the ground-truth view. Skip the cloud entirely and report the
         // sessions whose watcher process is alive on THIS machine right now (pidfile
         // ∩ OS liveness). This is what the desk-line returns when the cloud asks the
-        // machine "what's truly active?" — and the answer the Front Desk should show.
+        // machine "what's truly active?".
         // The cloud `/attached` registry below can list dead sessions for minutes;
         // this never can. adr: adr/monitor-resilience.md
         if (subArgs.includes('--local')) {
@@ -635,11 +634,6 @@ async function inbox(args) {
         // Indent each body line so multi-line markdown stays visually grouped
         for (const line of msg.body.split('\n'))
             console.log(`  ${line}`);
-        // Front Desk relay: the operator reached this session through the
-        // receptionist — answer on the rail they came in on, NOT the bare handle.
-        if (msg.references?.reply_to) {
-            console.log(`  ↩ reply on the operator's rail: greprag send --to ${msg.references.reply_to} "your reply"`);
-        }
         // References block — only printed when present, formatted as a compact section.
         const refs = msg.references;
         if (refs && (refs.memory_ids?.length || refs.artifacts?.length || refs.files?.length)) {
@@ -725,16 +719,6 @@ function parseSendAddress(addr) {
         }
         return { ok: true, targetKind: 'discord', target: snowflake };
     }
-    // sms: prefix — the Front Desk return leg (a connected session replies to the
-    // operator's phone). Own addressing grammar like discord:; server-side
-    // /v1/inbox/send resolves the phone against sms_pairings. adr: docs/front-desk-switchboard.md §4
-    if (addr.startsWith('sms:')) {
-        const phone = addr.slice('sms:'.length);
-        if (!/^\+?[0-9]{8,15}$/.test(phone)) {
-            return { ok: false, error: `sms address "${addr}" must be sms:<E.164 phone, e.g. sms:+16045551234>.` };
-        }
-        return { ok: true, targetKind: 'sms', target: phone };
-    }
     const segments = addr.split('/');
     if (segments.length > 2) {
         return { ok: false, error: `address "${addr}" has too many segments. The v0.12 grammar is\n` +
@@ -843,12 +827,6 @@ function buildReferences(args) {
     if (inReplyTo) {
         references = { ...(references ?? {}), in_reply_to: inReplyTo };
     }
-    // --approval: flag this front-desk ping as an approval request so the Front
-    // Desk offers a one-tap APPROVE (relay "yes") + CONNECT. Applies on top of any
-    // references shape (incl. --ref-json). adr: adr/address-grammar.md
-    if (args.includes('--approval')) {
-        references = { ...(references ?? {}), approval: true };
-    }
     return references;
 }
 /** greprag send "<text>" --to-desk --type <internal-type>
@@ -949,7 +927,7 @@ async function send(args) {
     // Project broadcasts were removed (2026-06-07). A project-name target has no
     // scope to send to — reject it. Session/chip traffic belongs on a session id;
     // first contact goes to the bare-handle front desk.
-    // adr: adr/address-grammar.md, docs/front-desk-switchboard.md §1
+    // adr: adr/address-grammar.md
     if (parsed.ok && parsed.targetKind === 'project') {
         console.error(`address "${to}" targets a whole project — project broadcasts were removed.\n` +
             `  Send to one session:   --to <handle>@greprag.com/<session-uuid>\n` +
@@ -978,11 +956,11 @@ async function send(args) {
         process.exit(1);
     }
     // A positional body carrying a LITERAL \n (backslash-n) is sent verbatim and
-    // renders as raw "\n" on SMS, not a line break (fix e8aa3f83). Warn at the
+    // renders as raw "\n", not a line break (fix e8aa3f83). Warn at the
     // moment so the author switches to --body-file/--stdin (real newlines) instead
     // of silently shipping a mangled message.
     if (/\\n/.test(body) && !args.includes('--stdin') && getFlag(args, '--body-file') === undefined) {
-        console.error('Warning: body contains a literal "\\n" — sent as-is (raw on SMS). For real newlines use --body-file or --stdin.');
+        console.error('Warning: body contains a literal "\\n" — sent as-is, not as a line break. For real newlines use --body-file or --stdin.');
     }
     const references = buildReferences(args);
     const payload = { to, body };
@@ -1002,12 +980,6 @@ async function send(args) {
         console.log(`Sent to discord:${delivered.snowflake}`);
         return;
     }
-    // SMS destinations (Front Desk return leg) also short-circuit the inbox table
-    // — delivered to the operator's phone via Twilio, no row/id/retract.
-    if (delivered?.kind === 'sms' && delivered.phone) {
-        console.log(`Sent to sms:${delivered.phone}`);
-        return;
-    }
     // Render the delivered-to in the v0.11 single-segment grammar.
     // adr: adr/numeric-handles.md, adr/address-grammar.md
     const base = delivered.handle || `${delivered.tenant}@greprag.com`;
@@ -1050,7 +1022,7 @@ async function send(args) {
     if (retractCode)
         console.log(`Retract: greprag retract ${retractCode}`);
 }
-/** greprag discord <pair|unpair|me> — Discord DM bridge to inbox. */
+/** greprag discord <pair|unpair|me|typing> — pair Discord so sessions can DM you. */
 async function discord(args) {
     const sub = args[0];
     if (!sub || sub === 'help' || sub === '--help') {
@@ -1102,112 +1074,6 @@ async function discord(args) {
         console.log(`Project:          ${result.project_name}`);
         console.log(`Paired at:        ${result.paired_at}`);
         console.log(`Last inbound DM:  ${result.last_seen_inbound_at ?? '(never)'}`);
-        if (result.handoff) {
-            console.log(`Handoff (active):`);
-            console.log(`  Project:  ${result.handoff.project_name}`);
-            console.log(`  Session:  ${result.handoff.session_id}`);
-            console.log(`  Expires:  ${result.handoff.expires_at}`);
-        }
-        else {
-            console.log(`Handoff:          (none — DMs route to default project)`);
-        }
-        return;
-    }
-    if (sub === 'handoff') {
-        // Resolve project: --project <name> overrides anchor's project_id.
-        const projectFlag = getFlag(args, '--project');
-        let projectId;
-        let projectNameForWatch;
-        if (projectFlag) {
-            projectNameForWatch = projectFlag;
-            const res = await fetch(`${cfg.apiUrl}/v1/inbox/projects`, {
-                headers: { 'Authorization': `Bearer ${cfg.apiKey}` },
-            });
-            const json = (await res.json());
-            const hit = json.projects?.find(p => p.project_name.toLowerCase() === projectFlag.toLowerCase());
-            if (!hit) {
-                console.error(`Error: project "${projectFlag}" not found under this tenant`);
-                process.exit(1);
-            }
-            projectId = hit.project_id;
-        }
-        else {
-            const anchor = (0, project_anchor_1.readAnchor)(process.cwd());
-            if (!anchor.projectId) {
-                console.error('No project anchor in current directory. Run: greprag init, or pass --project <name>.');
-                process.exit(1);
-            }
-            projectId = anchor.projectId;
-            projectNameForWatch = anchor.projectName;
-        }
-        // Resolve session id: --session <id> overrides CLAUDE_SESSION_ID env.
-        const sessionFlag = getFlag(args, '--session');
-        const rawSession = sessionFlag || (0, session_id_1.readSessionEnv)() || '';
-        const sessionId = (0, session_id_1.truncateSessionId)(rawSession);
-        if (!sessionId) {
-            console.error('No session id available. Pass --session <8-hex>, or run inside a Claude Code session\n' +
-                '(Claude Code sets CLAUDE_CODE_SESSION_ID).');
-            process.exit(1);
-        }
-        // Optional TTL.
-        const ttlFlag = getFlag(args, '--ttl');
-        const ttlMinutes = ttlFlag ? parseInt(ttlFlag, 10) : undefined;
-        if (ttlFlag && (!Number.isFinite(ttlMinutes) || ttlMinutes <= 0)) {
-            console.error(`Error: --ttl must be a positive integer (got "${ttlFlag}")`);
-            process.exit(1);
-        }
-        const result = await (0, discord_1.callDiscordHandoff)({ apiUrl: cfg.apiUrl, apiKey: cfg.apiKey }, { projectId: projectId, sessionId, ttlMinutes });
-        if (!result.ok) {
-            console.error(`Error: ${result.error}`);
-            process.exit(1);
-        }
-        // --no-watch skips the inline watcher (for scripted "just pin" usage).
-        if (args.includes('--no-watch')) {
-            console.log(`Pinned ${result.project_name} / ${result.session_id} for ${result.ttl_minutes} min.`);
-            console.log(`Expires: ${result.expires_at}`);
-            console.log(`Bot DM'd you a confirmation. Reply on Discord to route to this session.`);
-            console.log(`(skipped inbox watcher — pass without --no-watch to stream DMs to stdout.)`);
-            return;
-        }
-        // --orchestrator: tenant-wide watcher (sees inbox traffic to/from any
-        // project under this tenant). The pin still routes the user's DMs to
-        // (this project, this session) — only the watcher's scope changes.
-        // Used by an orchestrator session that wants portfolio-wide visibility
-        // while keeping its own DM conversation anchored to itself.
-        const orchestrator = args.includes('--orchestrator');
-        // Inline watcher — the whole point of handoff. Pin the route AND listen
-        // for inbox events on the same SSE stream. When invoked under Monitor,
-        // each printed line becomes one notification, so the agent sees every
-        // event the moment it lands. Process blocks until killed.
-        console.error(`[handoff] Pinned ${result.project_name} / ${result.session_id} for ${result.ttl_minutes} min.`);
-        console.error(`[handoff] Bot DM'd you a confirmation. Reply on Discord — replies stream here.`);
-        if (orchestrator) {
-            console.error(`[handoff] Orchestrator mode — watcher is tenant-wide. You will see inbox events from any project under this tenant.`);
-        }
-        else {
-            console.error(`[handoff] Listening for DMs to session ${result.session_id} on project ${result.project_name}...`);
-        }
-        await (0, inbox_watch_1.runInboxWatch)({
-            // Orchestrator mode: tenant-wide watcher (no project/session filter).
-            // Otherwise: filter to this project + session.
-            project: orchestrator ? undefined : projectNameForWatch,
-            session: orchestrator ? undefined : sessionId,
-            json: args.includes('--json'),
-            // Direct mode (no supervisor): handoff PINS the route before watching,
-            // so a supervised respawn would re-invoke `handoff` and re-pin on every
-            // child restart. Supervision is scoped to `inbox watch` only; keep
-            // handoff's prior in-process behavior. adr: adr/monitor-resilience.md
-            noSupervise: true,
-        });
-        return;
-    }
-    if (sub === 'unhandoff') {
-        const result = await (0, discord_1.callDiscordUnhandoff)({ apiUrl: cfg.apiUrl, apiKey: cfg.apiKey });
-        if (!result.ok) {
-            console.error(`Error: ${result.error}`);
-            process.exit(1);
-        }
-        console.log('Handoff cleared. DMs revert to default project routing.');
         return;
     }
     if (sub === 'typing') {
@@ -1328,8 +1194,8 @@ Commands:
   agents <adopt|optimize|sync|status>
                                   Canonical global/repo CLAUDE.md + AGENTS.md doctrine.
   doctor [--inspect] [--yes]       Diagnose + repair orphan project_ids and identity drift
-  desk [--json]                    Inspect the Agent Front Desk and live routing state.
-  sms <command>                    Configure or inspect SMS front-desk routing.
+  desk <run|ensure|status>         The desk line: this machine answers which sessions
+                                   are live when the cloud asks.
   smell "<text>"                   Shortcut for \`greprag fix log "<text>"\`.
   context status [--session <id>]  Context-size governor readout: live tokens, threshold,
                                    % consumed, turns since the crossover advisory last fired.
@@ -1414,10 +1280,8 @@ Inbox (email-style messaging across tenants):
   retract <code>                Pull back a previously-sent message (code is printed on send).
   discord pair                  Pair Discord DMs to this project — generates a code to DM the bot.
   discord unpair                Remove the Discord pairing.
-  discord me                    Show current Discord pairing + handoff state.
-  discord handoff [--ttl N]     Pin DMs to this session for N min (default 60); bot DMs a confirmation.
-  discord unhandoff             Clear the handoff pin (DMs revert to default project).
-  discord typing                Refresh the "typing…" indicator on the paired DM thread.
+  discord me                    Show current Discord pairing state.
+  discord typing               Refresh the "typing…" indicator on the paired DM thread.
   send "body" --to discord:<snowflake>
                                 Outbound DM to a paired Discord user from any session.
                                 Unread → hard delete. Read → body replaced with a retracted notice.
@@ -1576,6 +1440,11 @@ Skills (opt-in advisor skills bundled with the CLI):
   skill uninstall <name>        Remove a previously-installed advisor
   skill source stamp <name> --project <p> --path <rel> [--path <rel>...] [--baseline <ref>]
                                 Stamp a skill-staleness baseline against local Git
+  skill history <name>          Every revision of a mirrored skill: date, author, reason, changes
+  skill diff <name> <revA> [<revB>]
+                                Unified diff between two revisions (revB defaults to current)
+  skill revert <name> --to <rev> --reason "<why>" --expected-hash <current-hash>
+                                Make an old revision current again, as a new revision
 
 Load (on-demand doctrine — the CLI is the payload, no .md files):
   load                          Browse the catalog (chip-spawn, codex chips, mechanic, …)
@@ -1603,11 +1472,11 @@ Persona (tenant-scoped speaking instructions):
   persona show                  Show the active Persona.
   persona clear                 Remove the active Persona.
 
-GrepRAG Instructions (canonical global/repo CLAUDE.md + AGENTS.md):
-  instructions pull <file> [--scope global|repo] [--push]
-                                Pull disk instructions into canon.
-  instructions push [--scope global|repo|all] [--check] [--force]
-                                Render canon back to managed instruction files.
+Instructions (~/.claude/CLAUDE.md in the dotclaude git repo is the source):
+  instructions render [--check] Write ~/.codex/AGENTS.md and
+                                ~/.config/opencode/AGENTS.md from the git CLAUDE.md
+                                plus ~/.claude/instructions/<harness>.md.
+  instructions status           Show whether each rendered file is current.
   agents ...                    Deprecated alias for instructions.
 
 Project metadata (rename / merge / list):
@@ -1663,7 +1532,6 @@ const HELP_GROUPS = [
     ['fix', fix_1.runFix],
     ['mechanic', mechanic_1.runMechanic],
     ['discord', discord],
-    ['sms', sms_1.runSms],
     ['codex', codex_1.runCodex],
     ['identity', identity_1.runIdentity],
     ['project', project_1.runProject],
@@ -1974,7 +1842,6 @@ async function main() {
         case 'send': return send(subArgs);
         case 'retract': return retract(subArgs);
         case 'discord': return discord(subArgs);
-        case 'sms': return (0, sms_1.runSms)(subArgs);
         case 'codex': return (0, codex_1.runCodex)(subArgs);
         case 'expand': return expand(subArgs);
         case 'search': return (0, search_1.runSearch)(subArgs); // one lexical search across everything (adr/searchable-store-kinds.md)

package/dist/native-adapter-refresh.js

@@ -1,9 +1,9 @@
 "use strict";
-/** Keep installed native skill adapters at canon.
+/** Keep installed Codex/OpenCode launchers at canon.
  *
- *  Adapters were written only by explicit syncs (init, `skill mirror sync`,
- *  `--only`), so a canon change made anywhere — `skill mirror apply`, another
- *  session, another machine — left them behind until someone re-synced by hand.
+ *  Launchers were written only by explicit syncs (init, `skill mirror sync`),
+ *  so a canon change ingested anywhere — another session, another machine —
+ *  left them behind until someone re-synced by hand.
  *
  *  SessionStart calls this with the mirror roster it already fetched. Detection
  *  is local: each managed adapter's stamps against the roster. Only a stale
@@ -16,7 +16,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.readAdapterStamps = readAdapterStamps;
 exports.staleNativeAdapters = staleNativeAdapters;
 exports.refreshNativeAdapters = refreshNativeAdapters;
-const claude_lifecycle_cutover_1 = require("./claude-lifecycle-cutover");
 const native_skill_mirror_1 = require("./native-skill-mirror");
 const skill_mirror_files_1 = require("./skill-mirror-files");
 /** The identity stamps a generated adapter carries in its frontmatter. */
@@ -37,8 +36,7 @@ function readAdapterStamps(content) {
 function staleNativeAdapters(params) {
     const globalRoot = (0, native_skill_mirror_1.nativeSkillRoot)(params.platform, params.homeDir);
     const roots = [globalRoot];
-    // Claude adapters live only in the home root (claude-lifecycle-cutover.ts).
-    const projectRoot = params.projectDir && params.platform !== 'claude-code'
+    const projectRoot = params.projectDir
         ? (0, native_skill_mirror_1.writerOwnedProjectSkillRoot)(params.platform, params.projectDir, params.homeDir)
         : null;
     if (projectRoot)
@@ -80,10 +78,11 @@ function staleNativeAdapters(params) {
 }
 /** Rewrite each stale managed adapter of this harness from canon, through the
  *  writer the sync commands use. One adapter per write, so a diverged one holds
- *  back no other. A harness without native adapters is a no-op. */
+ *  back no other. A harness without native adapters is a no-op, Claude Code
+ *  included: it reads skills from their git folders (adr/skill-ownership-git.md). */
 async function refreshNativeAdapters(params) {
     const platform = params.platform;
-    if (platform !== 'claude-code' && platform !== 'codex' && platform !== 'opencode') {
+    if (platform !== 'codex' && platform !== 'opencode') {
         return { refreshed: 0, blocked: 0 };
     }
     const stale = staleNativeAdapters({ ...params, platform });
@@ -94,15 +93,13 @@ async function refreshNativeAdapters(params) {
         if (!skill)
             continue; // canon unreachable: the next session start retries
         try {
-            const result = platform === 'claude-code'
-                ? (0, claude_lifecycle_cutover_1.applyClaudeLifecycleCutover)({ skills: [skill], names: [skill.skillName], homeDir: params.homeDir })
-                : (0, native_skill_mirror_1.applyNativeSkillMirror)({
-                    platform,
-                    skills: [skill],
-                    homeDir: params.homeDir,
-                    projectDir: params.projectDir,
-                    prune: false,
-                });
+            const result = (0, native_skill_mirror_1.applyNativeSkillMirror)({
+                platform,
+                skills: [skill],
+                homeDir: params.homeDir,
+                projectDir: params.projectDir,
+                prune: false,
+            });
             refreshed += result.updated;
             blocked += result.blocked;
         }

package/dist/native-skill-mirror.js

@@ -321,127 +321,49 @@ function canonicalContentHash(skill) {
 function canonicalLookupArgs(skill) {
     return `--skill-id ${canonicalSkillId(skill)}`;
 }
-function canonicalWriteArgs(skill) {
-    if (skill.scope !== 'project' || !skill.projectId)
-        return '';
-    const replaces = (skill.replaces || []).map(id => ` --replaces ${id}`).join('');
-    return `--scope project --project-id ${skill.projectId}${replaces}`;
-}
-function canonicalEditArgs(skill) {
-    return [canonicalLookupArgs(skill), canonicalWriteArgs(skill)].filter(Boolean).join(' ');
-}
-function nativeCreationLocations(platform) {
-    if (platform === 'codex') {
-        return '`~/.codex/skills/<new-name>/SKILL.md` (global) or `<repo>/.agents/skills/<new-name>/SKILL.md` (project)';
-    }
-    if (platform === 'opencode') {
-        return '`~/.config/opencode/skills/<new-name>/SKILL.md` (global) or `<repo>/.opencode/skills/<new-name>/SKILL.md` (project)';
-    }
-    return '`~/.claude/skills/<new-name>/SKILL.md` (global) or `<repo>/.claude/skills/<new-name>/SKILL.md` (project)';
-}
-function renderChangeSkillLine(params) {
-    const exportCommand = `greprag skill mirror export ${params.skillName} ${params.identityArg} --to <dir>`;
-    const applyCommand = `greprag skill mirror apply <dir> --skill ${params.skillName} ${params.editArgs} --expected-hash <exported-hash>`;
-    if (params.platform === 'codex') {
-        return `- **Change this skill:** run \`greprag load skill-change\`, then \`${exportCommand}\`; patch the exported Markdown files non-interactively; run \`${applyCommand}\`; then \`${params.syncCommand}\`; then verify with \`${params.loadCommand}\`.`;
-    }
-    return `- **Change this skill:** run \`greprag load skill-change\`, then \`greprag skill edit ${params.skillName} ${params.editArgs}\`, then \`${params.syncCommand}\`, then verify with \`${params.loadCommand}\`.`;
-}
-function renderEditingSection(platform, params) {
-    const exportCommand = `greprag skill mirror export ${params.skillName} ${params.identityArg} --to <dir>`;
-    const applyCommand = `greprag skill mirror apply <dir> --skill ${params.skillName} ${params.editArgs} --expected-hash <exported-hash>`;
-    if (platform === 'codex') {
-        return `## Editing
-
-Codex agents must use the non-interactive mirror path:
-
-\`\`\`bash
-${exportCommand}
-# patch the exported Markdown files with normal file edits
-${applyCommand}
-\`\`\`
-
-Do not launch an interactive editor from Codex. If using \`greprag skill edit\` as an export helper, include \`--no-open\` and run the printed apply command after patching.
-`;
-    }
-    return `## Editing
-
-To edit this skill, run the guarded editor flow:
-
-\`\`\`bash
-greprag skill edit ${params.skillName} ${params.editArgs}
-\`\`\`
-
-Manual path:
-
-\`\`\`bash
-${exportCommand}
-${applyCommand}
-\`\`\`
-`;
+/** Where the skill's one true copy lives: git. adr: adr/skill-ownership-git.md */
+function gitSkillFolder(skill) {
+    return skill.scope === 'project'
+        ? `\`<repo>/.claude/skills/${skill.skillName}/\`${skill.projectName ? ` in the ${skill.projectName} repo` : ''}`
+        : `\`~/.claude/skills/${skill.skillName}/\` in the dotclaude repo`;
 }
 function renderAdapterBody(platform, skill) {
     const skillName = skill.skillName;
     const skillId = canonicalSkillId(skill);
     const identityArg = canonicalLookupArgs(skill);
-    const editArgs = canonicalEditArgs(skill);
-    const creationLocations = nativeCreationLocations(platform);
     const syncCommand = (0, skill_activation_manifest_1.nativeAdapterInstallCommand)(platform, [skillName]);
-    const creationLine = platform === 'claude-code'
-        ? '- **Create another skill:** use the normal native creation path and leave it unmanaged until a separate Claude cutover is approved.'
-        : `- **Create another skill:** create a normal native skill at ${creationLocations}; run \`${syncCommand} --dry-run\` and confirm it says \`adopt\`; then run \`${syncCommand}\`. GrepRAG adopts it as canon and replaces the native package with an adapter.`;
     const companions = skill.files.map(file => file.path).filter(relative => relative !== 'SKILL.md').sort();
     const harnessArg = `--harness ${platform}`;
     const loadCommand = `greprag load ${skillName} ${identityArg} ${harnessArg}`;
-    const changeSkillLine = renderChangeSkillLine({
-        platform,
-        skillName,
-        editArgs,
-        identityArg,
-        syncCommand,
-        loadCommand,
-    });
-    const editingSection = renderEditingSection(platform, { skillName, editArgs, identityArg });
     const companionLines = companions.length
         ? companions.map(relative => `- \`greprag load ${skillName} ${relative} ${identityArg} ${harnessArg}\``).join('\n')
-        : '- No companion docs are mirrored into this native adapter.';
+        : '- No companion docs are mirrored into this launcher.';
     return `# ${skillName}
 
 ## GENERATED ADAPTER — NEVER EDIT
 
-This is a disposable GrepRAG launcher for ${platform}, not canonical skill content. Never edit or copy this adapter, and never use \`greprag skill install\` to create or change a mirrored skill.
-
-Do not add or maintain project-state/doc pointers here. Current project state belongs in repo docs and the GrepRAG doc mirror; \`greprag load ${skillName} ${identityArg} ${harnessArg}\` discovers relevant state docs dynamically.
+This is a disposable GrepRAG launcher for ${platform}, not skill content. The skill lives in git at ${gitSkillFolder(skill)}; GrepRAG mirrors the committed files read-only and this launcher loads them.
 
 Required action chains:
 
 - **Use this skill:** run \`${loadCommand}\` before acting.
-${changeSkillLine}
-${creationLine}
+- **Change this skill:** edit ${gitSkillFolder(skill)} with normal file edits, commit, then run \`${syncCommand}\` (session start does it too) and verify with \`${loadCommand}\`. Uncommitted edits are never served. History and rollback are git log / git revert on that folder.
+- **Create another skill:** create \`~/.claude/skills/<new-name>/SKILL.md\` (dotclaude repo, global) or \`<repo>/.claude/skills/<new-name>/SKILL.md\` (project), commit, then run \`${syncCommand}\`.
 
 Authority: ${skillId}
 Source binding: ${sourceBindingState(skill)}
 Canonical content hash: ${canonicalContentHash(skill)}
 ${typeof skill.revision === 'number' ? `Mirror revision: ${skill.revision}` : 'Mirror revision: unknown'}
 
-${editingSection}
-
-Snapshot rollback:
-
-\`\`\`bash
-greprag skill mirror snapshot list ${skillName} ${identityArg}
-greprag skill mirror snapshot promote ${skillName} --name <snapshot> ${editArgs} --expected-hash <current-hash>
-\`\`\`
-
 ## Mandatory Invocation
 
 When this skill activates, run:
 
 \`\`\`bash
-greprag load ${skillName} ${identityArg} ${harnessArg}
+${loadCommand}
 \`\`\`
 
-Read and follow that canonical payload before responding or taking action.
+Read and follow that payload before responding or taking action.
 
 ## Companion Docs