greprag 5.84.0 → 5.85.1

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,130 +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> --reason "<why>"`;
-    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} --reason "<why>"\`, 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> --reason "<why>"`;
-    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} --reason "<why>"
-\`\`\`
-
-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}
-
-History and rollback (every canon write keeps its bytes and reason):
-
-\`\`\`bash
-greprag skill history ${skillName} ${identityArg}
-greprag skill diff ${skillName} <revA> [<revB>] ${identityArg}
-greprag skill revert ${skillName} --to <rev> ${identityArg} --reason "<why>" --expected-hash <current-hash>
-greprag skill mirror snapshot list ${skillName} ${identityArg}
-greprag skill mirror snapshot promote ${skillName} --name <snapshot> ${editArgs} --expected-hash <current-hash> --reason "<why>"
-\`\`\`
-
 ## 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