greprag 5.73.10 → 5.73.12

package/dist/codex-chip-hooks.js

@@ -66,7 +66,7 @@ function context(input) {
         `Parent session: ${chip.parent.sessionId || 'not recorded'}`,
         `Finish by committing the durable result and reporting the commit artifact to the parent, including checks, caveats, and a Cleanup line naming archive/task, worktree, and branch actions. The optional host command is ${cli} codex chip report ${chip.id}.`,
         // adr: adr/codex-landing-doctrine.md — default parent-owned landing + the one FIX exception.
-        'Landing: the parent owns merge, archive, and cleanup — do not merge, push, deploy, clean up, or edit the parent checkout. ONE exception: a mission whose first line begins `FIX:` (emitted by `greprag fix spawn`) carries its own Phase 3 landing contract — after peer conferral it merges its branch to main itself; cleanup stays native (`Cleanup: archive task; Codex may prune managed worktree; branch may be deleted after merge` plus `Clearance: safe to archive`), and push/release stays operator-gated for ordinary repair missions unless release/deploy was explicitly provisioned as mission completion.',
+        'Landing: the parent owns merge, archive, and cleanup — do not merge, push, deploy, clean up, or edit the parent checkout. FIX exception: a mission whose first line begins `FIX:` (emitted by `greprag fix spawn`) is writable in its isolated checkout/worktree, but stops for human approval before landing or cleanup. `greprag fix spawn` only prints the mission; visible Codex task dispatch creates the isolated checkout/worktree.',
     ];
     if ((0, model_1.chipMissionKind)(chip) === 'fix') {
         lines.push('Harness: Codex. Mission: visible native FIX chip with ordinary writable authority, not an internal subagent.', 'Scope: repair GrepRAG-owned harness surfaces in this checkout: load entries, skill templates, docs, hook context, CLI messages, and tests. Codex owns native task creation, worktrees, permissions, Git, and task lifecycle.', 'Own diagnosis, implementation, tests, commit, and parent report. Inspect Codex behavior only far enough to correct GrepRAG guidance or report a precise external blocker.', 'FIX peer handoff: if a peer offers to coordinate, integrate, rework, or take over a harness repair, hand off branch/commit, dirty files, checks, blockers, and caveats. Do not defend patch ownership; peers may take ownership within their assigned GrepRAG harness scope.', 'Visible delegation route: load `codex-chip-spawn` and create the child with `codex_app__create_thread` using the current project worktree target; load `chip-leader` for multi-chip seams. Never use `multi_agent_v1__spawn_agent` for a visible chip.');

package/dist/codex-chip-hooks.js.map

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

package/dist/commands/agent-doctrine-file.d.ts

@@ -1,4 +1,4 @@
-/** Pure full-file follower helpers for canonical agent doctrine.
+/** Pure full-file follower helpers for canonical GrepRAG Instructions.
  *
  * Follower files must stay byte-faithful instruction files. Ownership state
  * lives outside the markdown in the GrepRAG parity manifest.

package/dist/commands/agent-doctrine-file.js

@@ -1,5 +1,5 @@
 "use strict";
-/** Pure full-file follower helpers for canonical agent doctrine.
+/** Pure full-file follower helpers for canonical GrepRAG Instructions.
  *
  * Follower files must stay byte-faithful instruction files. Ownership state
  * lives outside the markdown in the GrepRAG parity manifest.

package/dist/commands/agents.d.ts

@@ -1,6 +1,31 @@
-/** `greprag agents` — canonical agent-doctrine adoption and materialization. */
+/** `greprag instructions` — canonical GrepRAG Instructions adoption/materialization.
+ *
+ *  `greprag agents` remains as a compatibility alias. */
 type Harness = 'claude-code' | 'codex' | 'opencode';
 type Scope = 'global' | 'repo';
+interface OriginalInstructionSnapshot {
+    snapshotName?: string;
+    harness: Harness;
+    path: string;
+    scope: Scope;
+    projectId: string | null;
+    directory: string;
+    status: 'present' | 'missing';
+    content: string;
+    contentHash: string;
+    capturedAt: string;
+    source: 'git-history' | 'disk' | 'missing';
+    sourceRef?: string | null;
+    reason?: string | null;
+}
+export interface FollowerTarget {
+    harness: Harness;
+    actualPath: string;
+    manifestPath: string;
+    note?: string;
+    combinedAgents?: boolean;
+}
+export declare function collectOriginalSnapshots(targets: FollowerTarget[], scope: Scope, projectId: string | null, directory: string): OriginalInstructionSnapshot[];
 export interface AgentDoctrineBootstrapResult {
     canonicalScopes: Scope[];
     currentFollowers: number;
@@ -9,7 +34,8 @@ export interface AgentDoctrineBootstrapResult {
 }
 /** Init-time seed for the active harness. No canon is a clean no-op; only a
  * missing/empty follower is written. Every existing nonmatching file requires
- * an explicit `agents push` or `agents pull`. */
+ * an explicit `instructions push` or `instructions pull`. */
 export declare function bootstrapAgentDoctrine(apiKey: string, harness: Harness): Promise<AgentDoctrineBootstrapResult>;
+export declare function runInstructions(args: string[]): Promise<void>;
 export declare function runAgents(args: string[]): Promise<void>;
 export {};

package/dist/commands/agents.js

@@ -1,5 +1,7 @@
 "use strict";
-/** `greprag agents` — canonical agent-doctrine adoption and materialization. */
+/** `greprag instructions` — canonical GrepRAG Instructions adoption/materialization.
+ *
+ *  `greprag agents` remains as a compatibility alias. */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -34,7 +36,9 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectOriginalSnapshots = collectOriginalSnapshots;
 exports.bootstrapAgentDoctrine = bootstrapAgentDoctrine;
+exports.runInstructions = runInstructions;
 exports.runAgents = runAgents;
 const crypto = __importStar(require("node:crypto"));
 const fs = __importStar(require("node:fs"));
@@ -43,24 +47,35 @@ const path = __importStar(require("node:path"));
 const project_anchor_1 = require("../project-anchor");
 const proc_1 = require("../proc");
 const agent_doctrine_file_1 = require("./agent-doctrine-file");
-const HELP = `greprag agents — canonical CLAUDE.md / AGENTS.md doctrine
+function help(commandName) {
+    const aliasNote = commandName === 'agents'
+        ? '\n\nNOTE\n  `greprag agents` is a deprecated alias. Use `greprag instructions`.'
+        : '';
+    return `greprag ${commandName} — canonical GrepRAG Instructions for CLAUDE.md / AGENTS.md
 
 USAGE
-  greprag agents pull <file> [--scope global|repo] [--harness <name>] [--push]
-  greprag agents push [--scope global|repo|all] [--check] [--force]
-  greprag agents adopt <file> [--scope global|repo] [--harness <name>] [--no-sync]
-  greprag agents revise <file> [--scope global|repo] [--harness <name>] [--no-sync]
-  greprag agents overlay set <harness> <file> [--scope global|repo] [--no-sync]
-  greprag agents overlay derive <harness> <shared-file> <rendered-file> [--scope global|repo] [--no-sync]
-  greprag agents overlay clear <harness> [--scope global|repo] [--no-sync]
-  greprag agents sync [--scope global|repo|all] [--check] [--force]
-  greprag agents status [--scope global|repo|all]
+  greprag ${commandName} pull <file> [--scope global|repo] [--harness <name>] [--push]
+  greprag ${commandName} push [--scope global|repo|all] [--check] [--force]
+  greprag ${commandName} adopt <file> [--scope global|repo] [--harness <name>] [--no-sync]
+  greprag ${commandName} revise <file> [--scope global|repo] [--harness <name>] [--no-sync]
+  greprag ${commandName} overlay set <harness> <file> [--scope global|repo] [--no-sync]
+  greprag ${commandName} overlay derive <harness> <shared-file> <rendered-file> [--scope global|repo] [--no-sync]
+  greprag ${commandName} overlay clear <harness> [--scope global|repo] [--no-sync]
+  greprag ${commandName} snapshot create --name <name> [--scope global|repo|all] [--harness <name>] [--from-ref <git-ref>] [--force]
+  greprag ${commandName} snapshot list [--scope global|repo|all]
+  greprag ${commandName} snapshot show <name> [--scope global|repo|all]
+  greprag ${commandName} restore --snapshot <name> [--scope global|repo|all] [--harness <name>] [--check] [--force]
+  greprag ${commandName} sync [--scope global|repo|all] [--check] [--force]
+  greprag ${commandName} status [--scope global|repo|all]
 
 MODEL
-  Adopt and revise copy source bytes exactly; no model rewrites doctrine.
+  Adopt and revise copy source bytes exactly; no model rewrites instructions.
+  The first adoption stores Original Snapshots for every managed follower.
   Harness translations are raw additive suffixes. Pull writes disk to canon.
   Push writes canon to disk only when the external sync baseline is clean.
-  Status/check never writes.`;
+  Snapshots are named exact-byte rollback points and do not change canon.
+  Status/check never writes.${aliasNote}`;
+}
 function config(apiKeyOverride) {
     return {
         apiUrl: process.env.GREPRAG_API_URL || 'https://api.greprag.com',
@@ -81,6 +96,51 @@ function repoRoot(cwd = process.cwd()) {
         return path.resolve(cwd);
     }
 }
+function fileGitRoot(filePath) {
+    try {
+        return String((0, proc_1.safeExecFileSync)('git', ['-C', path.dirname(filePath), 'rev-parse', '--show-toplevel'], {
+            encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'],
+        })).trim();
+    }
+    catch {
+        return null;
+    }
+}
+function gitFileAt(root, ref, relativePath) {
+    try {
+        return String((0, proc_1.safeExecFileSync)('git', ['-C', root, 'show', `${ref}:${relativePath}`], {
+            encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'],
+            maxBuffer: 1024 * 1024,
+        }));
+    }
+    catch {
+        return null;
+    }
+}
+function firstInstructionTouch(root, relativePath) {
+    try {
+        const out = String((0, proc_1.safeExecFileSync)('git', [
+            '-C', root,
+            'log',
+            '--reverse',
+            '--format=%H',
+            '--all',
+            '-G', 'Agent Doctrine|Doctrine Mirror|agent doctrine|greprag agents|greprag instructions|GrepRAG Instructions',
+            '--',
+            relativePath,
+        ], {
+            encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'],
+            maxBuffer: 1024 * 1024,
+        })).trim();
+        return out.split(/\r?\n/).find(Boolean) || null;
+    }
+    catch {
+        return null;
+    }
+}
+function looksManagedOrRenamed(content) {
+    return /Agent Doctrine|Doctrine Mirror|agent doctrine|greprag agents|greprag instructions|GrepRAG Instructions/i.test(content);
+}
 function relativeDirectory(root, requested) {
     const absolute = requested
         ? path.resolve(root, requested)
@@ -138,6 +198,146 @@ function parityUnitName(scope, projectId, directory) {
         : crypto.createHash('sha256').update(directory).digest('hex').slice(0, 8);
     return `agent-doctrine-${projectId.slice(0, 8)}-${suffix}`;
 }
+function snapshotContentHash(value) {
+    return crypto.createHash('sha256').update(value).digest('hex');
+}
+function normalizeSnapshotName(value) {
+    const name = (value || '').trim();
+    if (!/^[a-z0-9][a-z0-9._-]{0,79}$/i.test(name)) {
+        throw new Error('snapshot name must be 1-80 chars: letters, numbers, dot, underscore, or dash');
+    }
+    return name;
+}
+function snapshotNameOf(snapshot) {
+    return snapshot.snapshotName || 'original';
+}
+function originalSnapshotForTarget(target, scope, projectId, directory, capturedAt) {
+    const base = {
+        snapshotName: 'original',
+        harness: target.harness,
+        path: target.manifestPath,
+        scope,
+        projectId,
+        directory,
+        capturedAt,
+    };
+    if (!fs.existsSync(target.actualPath)) {
+        return {
+            ...base,
+            status: 'missing',
+            content: '',
+            contentHash: snapshotContentHash(''),
+            source: 'missing',
+            sourceRef: null,
+            reason: 'follower file did not exist at adoption time',
+        };
+    }
+    const diskContent = fs.readFileSync(target.actualPath, 'utf8');
+    if (looksManagedOrRenamed(diskContent)) {
+        const gitRoot = fileGitRoot(target.actualPath);
+        if (gitRoot) {
+            const rel = path.relative(gitRoot, target.actualPath).replace(/\\/g, '/');
+            const firstTouch = firstInstructionTouch(gitRoot, rel);
+            if (firstTouch) {
+                const historical = gitFileAt(gitRoot, `${firstTouch}^`, rel);
+                if (historical !== null) {
+                    return {
+                        ...base,
+                        status: 'present',
+                        content: historical,
+                        contentHash: snapshotContentHash(historical),
+                        source: 'git-history',
+                        sourceRef: `${firstTouch}^`,
+                        reason: `pre-GrepRAG-Instructions snapshot from parent of ${firstTouch.slice(0, 12)}`,
+                    };
+                }
+            }
+        }
+    }
+    return {
+        ...base,
+        status: 'present',
+        content: diskContent,
+        contentHash: snapshotContentHash(diskContent),
+        source: 'disk',
+        sourceRef: null,
+        reason: looksManagedOrRenamed(diskContent)
+            ? 'historical pre-instructions file was not recoverable; captured disk bytes'
+            : 'captured disk bytes before first GrepRAG Instructions adoption',
+    };
+}
+function diskSnapshotForTarget(target, scope, projectId, directory, snapshotName, capturedAt) {
+    const base = {
+        snapshotName,
+        harness: target.harness,
+        path: target.manifestPath,
+        scope,
+        projectId,
+        directory,
+        capturedAt,
+    };
+    if (!fs.existsSync(target.actualPath)) {
+        return {
+            ...base,
+            status: 'missing',
+            content: '',
+            contentHash: snapshotContentHash(''),
+            source: 'missing',
+            sourceRef: null,
+            reason: `snapshot ${snapshotName}: follower file did not exist`,
+        };
+    }
+    const content = fs.readFileSync(target.actualPath, 'utf8');
+    return {
+        ...base,
+        status: 'present',
+        content,
+        contentHash: snapshotContentHash(content),
+        source: 'disk',
+        sourceRef: null,
+        reason: `snapshot ${snapshotName}: captured disk bytes`,
+    };
+}
+function gitRefSnapshotForTarget(target, scope, projectId, directory, snapshotName, capturedAt, ref) {
+    const base = {
+        snapshotName,
+        harness: target.harness,
+        path: target.manifestPath,
+        scope,
+        projectId,
+        directory,
+        capturedAt,
+    };
+    const gitRoot = fileGitRoot(target.actualPath);
+    if (gitRoot) {
+        const rel = path.relative(gitRoot, target.actualPath).replace(/\\/g, '/');
+        const content = gitFileAt(gitRoot, ref, rel);
+        if (content !== null) {
+            return {
+                ...base,
+                status: 'present',
+                content,
+                contentHash: snapshotContentHash(content),
+                source: 'git-history',
+                sourceRef: ref,
+                reason: `snapshot ${snapshotName}: captured ${rel} from ${ref}`,
+            };
+        }
+    }
+    return {
+        ...base,
+        status: 'missing',
+        content: '',
+        contentHash: snapshotContentHash(''),
+        source: 'missing',
+        sourceRef: ref,
+        reason: `snapshot ${snapshotName}: no file at ${ref}`,
+    };
+}
+function collectOriginalSnapshots(targets, scope, projectId, directory) {
+    const capturedAt = new Date().toISOString();
+    return targets.map((target) => originalSnapshotForTarget(target, scope, projectId, directory, capturedAt));
+}
 function uniqueNonempty(values) {
     const seen = new Set();
     const out = [];
@@ -228,6 +428,13 @@ function inferHarness(file, explicit) {
         return explicit;
     return file && path.basename(file).toUpperCase() === 'CLAUDE.MD' ? 'claude-code' : 'codex';
 }
+function parseOptionalHarness(explicit) {
+    if (!explicit)
+        return undefined;
+    if (explicit === 'claude-code' || explicit === 'codex' || explicit === 'opencode')
+        return explicit;
+    throw new Error('--harness must be claude-code, codex, or opencode');
+}
 function inferScope(file, explicit) {
     if (explicit === 'global' || explicit === 'repo')
         return explicit;
@@ -334,6 +541,9 @@ async function exactSourceCommand(args, mode) {
             sourcePath,
             content,
             expectedRevision: endpointMode === 'revise' ? current?.revision ?? null : null,
+            originalSnapshots: endpointMode === 'adopt'
+                ? collectOriginalSnapshots(ctx.targets, scope, ctx.projectId, ctx.directory)
+                : undefined,
             followers: ctx.targets.map((target) => ({
                 harness: target.harness,
                 path: target.manifestPath,
@@ -343,6 +553,10 @@ async function exactSourceCommand(args, mode) {
     });
     const verb = mode === 'pull' ? 'Pulled' : mode === 'adopt' ? 'Adopted' : 'Revised';
     console.log(`${verb} ${body.document.scopeKey} revision ${body.document.revision}.`);
+    if (endpointMode === 'adopt' && body.document.originalSnapshots?.length) {
+        const historical = body.document.originalSnapshots.filter((s) => s.source === 'git-history').length;
+        console.log(`Original Snapshots stored: ${body.document.originalSnapshots.length} (${historical} from git history).`);
+    }
     const shouldPush = mode === 'pull'
         ? args.includes('--push')
         : !args.includes('--no-sync');
@@ -422,6 +636,218 @@ async function overlayCommand(args) {
         await syncOne({ scope, args, check: false, force: args.includes('--force') });
     }
 }
+function originalSnapshotForRenderTarget(doc, target, scope, projectId, directory, snapshotName) {
+    const snapshots = doc.originalSnapshots || [];
+    return snapshots.find((snapshot) => snapshot.harness === target.harness
+        && snapshotNameOf(snapshot) === snapshotName
+        && snapshot.path === target.manifestPath
+        && snapshot.scope === scope
+        && (scope === 'global' || snapshot.projectId === projectId)
+        && snapshot.directory === directory) || null;
+}
+async function restoreOne(params) {
+    const ctx = context(params.scope, params.args);
+    const doc = await fetchDocument(params.scope, ctx.projectId, ctx.directory);
+    if (!doc) {
+        console.log(`${params.scope}: no canonical doctrine`);
+        return { canonical: false, current: 0, changed: 0, blocked: 0 };
+    }
+    const stats = { canonical: true, current: 0, changed: 0, blocked: 0 };
+    for (const target of ctx.targets.filter(t => targetMatchesHarness(t, params.harness))) {
+        const snapshot = originalSnapshotForRenderTarget(doc, target, params.scope, ctx.projectId, ctx.directory, params.snapshotName);
+        if (!snapshot) {
+            console.log(`  blocked  ${target.actualPath} — no snapshot '${params.snapshotName}' stored for this follower`);
+            stats.blocked++;
+            continue;
+        }
+        const exists = fs.existsSync(target.actualPath);
+        const source = exists ? fs.readFileSync(target.actualPath, 'utf8') : '';
+        const alreadyOriginal = snapshot.status === 'missing'
+            ? !exists
+            : exists && source === snapshot.content;
+        if (alreadyOriginal) {
+            console.log(`  current  ${target.actualPath}`);
+            stats.current++;
+            continue;
+        }
+        const currentRender = renderForTarget(doc, target);
+        const cleanManagedFollower = !exists || source === currentRender;
+        if (!cleanManagedFollower && !params.force) {
+            console.log(`  blocked  ${target.actualPath} — local edits differ from the current GrepRAG render; rerun with --force only after saving them`);
+            stats.blocked++;
+            continue;
+        }
+        const action = snapshot.status === 'missing' ? 'remove' : 'restore';
+        const sourceNote = snapshot.source === 'git-history' && snapshot.sourceRef
+            ? `${snapshot.source}:${snapshot.sourceRef}`
+            : snapshot.source;
+        console.log(`  ${params.check ? `would-${action}` : action} ${target.actualPath} — snapshot '${params.snapshotName}' from ${sourceNote}`);
+        stats.changed++;
+        if (params.check)
+            continue;
+        if (snapshot.status === 'missing') {
+            if (exists)
+                fs.rmSync(target.actualPath);
+        }
+        else {
+            fs.mkdirSync(path.dirname(target.actualPath), { recursive: true });
+            fs.writeFileSync(target.actualPath, snapshot.content, 'utf8');
+        }
+    }
+    return stats;
+}
+async function restoreCommand(args) {
+    const snapshotName = normalizeSnapshotName(flag(args, '--snapshot'));
+    const requested = flag(args, '--scope') || 'all';
+    if (!['global', 'repo', 'all'].includes(requested)) {
+        throw new Error('--scope must be global|repo|all');
+    }
+    const harness = parseOptionalHarness(flag(args, '--harness'));
+    const scopes = requested === 'all' ? ['global', 'repo'] : [requested];
+    const check = args.includes('--check');
+    let changed = 0;
+    let blocked = 0;
+    for (const scope of scopes) {
+        console.log(`${scope}:`);
+        const stats = await restoreOne({
+            scope,
+            args,
+            check,
+            force: args.includes('--force'),
+            snapshotName,
+            harness,
+        });
+        changed += stats.changed;
+        blocked += stats.blocked;
+    }
+    if (changed > 0 && !check) {
+        console.log('Restored snapshot bytes. Canon is unchanged; run `greprag instructions pull <file>` to promote restored bytes back into canon.');
+    }
+    if (check && changed > 0) {
+        console.error(`${changed} follower(s) would be restored.`);
+        process.exitCode = 1;
+    }
+    if (blocked > 0)
+        process.exitCode = 1;
+}
+function snapshotSummary(doc) {
+    const out = new Map();
+    for (const snapshot of doc.originalSnapshots || []) {
+        const name = snapshotNameOf(snapshot);
+        const rows = out.get(name) || [];
+        rows.push(snapshot);
+        out.set(name, rows);
+    }
+    return out;
+}
+async function snapshotCreateOne(params) {
+    const ctx = context(params.scope, params.args);
+    const doc = await fetchDocument(params.scope, ctx.projectId, ctx.directory);
+    if (!doc) {
+        console.log(`${params.scope}: no canonical doctrine`);
+        return 0;
+    }
+    const targets = ctx.targets.filter(t => targetMatchesHarness(t, params.harness));
+    const capturedAt = new Date().toISOString();
+    const snapshots = targets.map((target) => params.fromRef
+        ? gitRefSnapshotForTarget(target, params.scope, ctx.projectId, ctx.directory, params.snapshotName, capturedAt, params.fromRef)
+        : diskSnapshotForTarget(target, params.scope, ctx.projectId, ctx.directory, params.snapshotName, capturedAt));
+    const body = await apiJson('/v1/agents/snapshot', {
+        method: 'POST',
+        body: JSON.stringify({
+            scope: params.scope,
+            projectId: ctx.projectId,
+            directory: ctx.directory,
+            snapshotName: params.snapshotName,
+            snapshots,
+            replace: params.force,
+            expectedRevision: doc.revision,
+        }),
+    });
+    const present = snapshots.filter((snapshot) => snapshot.status === 'present').length;
+    console.log(`${params.scope}: stored snapshot '${params.snapshotName}' for ${snapshots.length} follower(s) (${present} present) at revision ${body.document.revision}.`);
+    return snapshots.length;
+}
+async function snapshotListOne(scope, args) {
+    const ctx = context(scope, args);
+    const doc = await fetchDocument(scope, ctx.projectId, ctx.directory);
+    if (!doc) {
+        console.log(`${scope}: no canonical doctrine`);
+        return;
+    }
+    console.log(`${scope}: ${doc.scopeKey} revision ${doc.revision}`);
+    const groups = snapshotSummary(doc);
+    if (groups.size === 0) {
+        console.log('  no snapshots');
+        return;
+    }
+    for (const [name, rows] of [...groups.entries()].sort(([a], [b]) => a.localeCompare(b))) {
+        const present = rows.filter((row) => row.status === 'present').length;
+        const capturedAt = rows.map((row) => row.capturedAt).sort()[0] || '(unknown)';
+        console.log(`  ${name}: ${rows.length} follower(s), ${present} present, first captured ${capturedAt}`);
+    }
+}
+async function snapshotShowOne(scope, args, snapshotName) {
+    const ctx = context(scope, args);
+    const doc = await fetchDocument(scope, ctx.projectId, ctx.directory);
+    if (!doc) {
+        console.log(`${scope}: no canonical doctrine`);
+        return;
+    }
+    const rows = (doc.originalSnapshots || [])
+        .filter((snapshot) => snapshotNameOf(snapshot) === snapshotName);
+    console.log(`${scope}: ${doc.scopeKey} revision ${doc.revision}`);
+    if (rows.length === 0) {
+        console.log(`  snapshot '${snapshotName}' not found`);
+        return;
+    }
+    for (const row of rows) {
+        const ref = row.sourceRef ? ` ${row.sourceRef}` : '';
+        console.log(`  ${row.harness} ${row.path}`);
+        console.log(`    ${row.status} ${row.source}${ref} ${row.contentHash}`);
+        if (row.reason)
+            console.log(`    ${row.reason}`);
+    }
+}
+async function snapshotCommand(args) {
+    const action = args[0];
+    const requested = flag(args, '--scope') || 'all';
+    if (!['global', 'repo', 'all'].includes(requested)) {
+        throw new Error('--scope must be global|repo|all');
+    }
+    const scopes = requested === 'all' ? ['global', 'repo'] : [requested];
+    if (action === 'create') {
+        const snapshotName = normalizeSnapshotName(flag(args, '--name'));
+        const harness = parseOptionalHarness(flag(args, '--harness'));
+        const fromRef = flag(args, '--from-ref');
+        let count = 0;
+        for (const scope of scopes) {
+            count += await snapshotCreateOne({
+                scope,
+                args,
+                snapshotName,
+                fromRef,
+                force: args.includes('--force'),
+                harness,
+            });
+        }
+        if (count > 0)
+            console.log('Snapshot storage only changed rollback metadata; canon render bytes are unchanged.');
+        return;
+    }
+    if (action === 'list') {
+        for (const scope of scopes)
+            await snapshotListOne(scope, args);
+        return;
+    }
+    if (action === 'show') {
+        const snapshotName = normalizeSnapshotName(args[1] && !args[1].startsWith('-') ? args[1] : flag(args, '--name'));
+        for (const scope of scopes)
+            await snapshotShowOne(scope, args, snapshotName);
+        return;
+    }
+    throw new Error('snapshot requires create, list, or show');
+}
 async function syncCommand(args, checkOverride = false) {
     const requested = flag(args, '--scope') || 'all';
     if (!['global', 'repo', 'all'].includes(requested)) {
@@ -445,7 +871,7 @@ async function syncCommand(args, checkOverride = false) {
 }
 /** Init-time seed for the active harness. No canon is a clean no-op; only a
  * missing/empty follower is written. Every existing nonmatching file requires
- * an explicit `agents push` or `agents pull`. */
+ * an explicit `instructions push` or `instructions pull`. */
 async function bootstrapAgentDoctrine(apiKey, harness) {
     const result = {
         canonicalScopes: [], currentFollowers: 0, changedFollowers: 0, blockedFollowers: 0,
@@ -462,10 +888,10 @@ async function bootstrapAgentDoctrine(apiKey, harness) {
     }
     return result;
 }
-async function runAgents(args) {
+async function runInstructionsCommand(args, commandName) {
     const sub = args[0];
     if (!sub || sub === 'help' || sub === '--help' || sub === '-h') {
-        console.log(HELP);
+        console.log(help(commandName));
         return;
     }
     if (sub === 'pull')
@@ -478,13 +904,23 @@ async function runAgents(args) {
         return exactSourceCommand(args.slice(1), 'revise');
     if (sub === 'overlay')
         return overlayCommand(args.slice(1));
+    if (sub === 'snapshot')
+        return snapshotCommand(args.slice(1));
+    if (sub === 'restore')
+        return restoreCommand(args.slice(1));
     if (sub === 'optimize') {
-        throw new Error('agents optimize was removed: use lossless agents pull or explicit agents overlay');
+        throw new Error(`${commandName} optimize was removed: use lossless ${commandName} pull or explicit ${commandName} overlay`);
     }
     if (sub === 'sync')
         return syncCommand(args.slice(1));
     if (sub === 'status')
         return syncCommand(args.slice(1), true);
-    throw new Error(`unknown agents command: ${sub}`);
+    throw new Error(`unknown ${commandName} command: ${sub}`);
+}
+async function runInstructions(args) {
+    return runInstructionsCommand(args, 'instructions');
+}
+async function runAgents(args) {
+    return runInstructionsCommand(args, 'agents');
 }
 //# sourceMappingURL=agents.js.map