@ornexus/neocortex 4.60.71 → 4.60.73

package/packages/client/dist/memory/shared-project-memory-types.js

@@ -1,2 +1,253 @@
-function i(...t){return t.map(a=>({scope:"project",path:a}))}const e="NEOCORTEX.md",r={canonicalSource:e,semanticFileRequired:!0,symlinkBacked:!0,wrapperAllowed:!1,includeFallbackAllowed:!1,requiresWrapperPreservation:!1,fallbackIsCompatibilityRemediation:!0,policy:"mandatory-semantic-symlink",notes:"Semantic platform memory file must resolve to NEOCORTEX.md through a symlink; do not replace it with an unrelated wrapper or copied frontmatter."},l={canonicalSource:e,semanticFileRequired:!0,symlinkBacked:!0,wrapperAllowed:!0,includeFallbackAllowed:!1,requiresWrapperPreservation:!0,fallbackIsCompatibilityRemediation:!0,policy:"symlink-backed-wrapper",notes:"Platform wrapper/frontmatter is allowed only when the semantic memory payload remains symlink-backed by NEOCORTEX.md."},c={canonicalSource:e,semanticFileRequired:!0,symlinkBacked:!0,wrapperAllowed:!0,includeFallbackAllowed:!0,requiresWrapperPreservation:!0,fallbackIsCompatibilityRemediation:!0,policy:"safe-include-fallback",notes:"Use a safe include/import only for platforms that cannot consume symlinks directly; the include must resolve back to NEOCORTEX.md."};function o(t){return{canonicalSource:e,resolvesVia:t.policy,feedbackTrigger:"*update-memory",guidance:"Treat NEOCORTEX.md as canonical project memory; consult it before platform-specific memory, and run *update-memory when durable project context changes should flow back to the canonical source."}}const s=["claude-code","codex","grok","gemini-cli","antigravity","vscode","cursor","opencode","openclaw","kimi","github-copilot-cli"],m={canonical:{targetId:"canonical",platformName:"Neocortex Canonical Memory",canonicalSource:e,primaryFile:e,secondaryFiles:i("AGENTS.md","CLAUDE.md","GEMINI.md"),ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"neocortex-md",budget:{maxLines:220,maxBytes:18e3},linkRequirement:r,bidirectionalReference:o(r),requiresWrapperPreservation:!1,notes:"Canonical compact project memory source for platform symlinks and wrappers. Store only summaries, indexes, and links to architecture docs here."},"claude-code":{targetId:"claude-code",platformName:"Claude Code",canonicalSource:e,primaryFile:"CLAUDE.md",secondaryFiles:i(".claude/agents/neocortex.md"),ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"claude-md",budget:{maxLines:320,maxBytes:28e3},linkRequirement:r,bidirectionalReference:o(r),requiresWrapperPreservation:!1,notes:"Claude Code project memory. Resolve to NEOCORTEX.md; keep root content concise and link deeper docs with @path references."},codex:{targetId:"codex",platformName:"Codex CLI",canonicalSource:e,primaryFile:"AGENTS.md",secondaryFiles:i(".codex/agents/neocortex.toml"),ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"agents-md",budget:{maxLines:220,maxBytes:18e3},linkRequirement:r,bidirectionalReference:o(r),requiresWrapperPreservation:!0,notes:"Codex root instructions. Uppercase AGENTS.md is required on case-sensitive filesystems."},grok:{targetId:"grok",platformName:"Grok Build",canonicalSource:e,primaryFile:"AGENTS.md",secondaryFiles:i(".grok/skills/neocortex/SKILL.md"),ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"agents-md",budget:{maxLines:220,maxBytes:18e3},linkRequirement:r,bidirectionalReference:o(r),requiresWrapperPreservation:!0,notes:"Grok Build reads AGENTS.md and the project-local Neocortex Skill; both resolve to canonical NEOCORTEX.md context."},"gemini-cli":{targetId:"gemini-cli",platformName:"Gemini CLI",canonicalSource:e,primaryFile:"GEMINI.md",secondaryFiles:i(".gemini/agents/neocortex.md"),ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"gemini-md",budget:{maxLines:260,maxBytes:22e3},linkRequirement:r,bidirectionalReference:o(r),requiresWrapperPreservation:!1,notes:"Gemini CLI context file. Prefer shallow @file.md imports for detailed architecture docs."},antigravity:{targetId:"antigravity",platformName:"Antigravity",canonicalSource:e,primaryFile:"GEMINI.md",secondaryFiles:i(".gemini/agents/neocortex.md"),ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"gemini-md",budget:{maxLines:260,maxBytes:22e3},linkRequirement:r,bidirectionalReference:o(r),requiresWrapperPreservation:!1,notes:"Antigravity currently shares GEMINI.md behavior with the Gemini target stubs."},vscode:{targetId:"vscode",platformName:"VS Code / GitHub Copilot",canonicalSource:e,primaryFile:".github/copilot-instructions.md",secondaryFiles:i(".github/instructions/neocortex.instructions.md",".github/agents/neocortex.agent.md"),ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"copilot-instructions",budget:{maxLines:180,maxBytes:14e3},linkRequirement:l,bidirectionalReference:o(l),requiresWrapperPreservation:!0,notes:"VS Code and GitHub Copilot always-on repository instructions."},cursor:{targetId:"cursor",platformName:"Cursor",canonicalSource:e,primaryFile:".cursor/rules/neocortex.mdc",secondaryFiles:i("AGENTS.md"),ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"cursor-rule",budget:{maxLines:180,maxBytes:14e3},linkRequirement:l,bidirectionalReference:o(l),requiresWrapperPreservation:!0,notes:"Cursor rule memory. Use AGENTS.md as compatibility fallback when Cursor rules are absent."},opencode:{targetId:"opencode",platformName:"OpenCode",canonicalSource:e,primaryFile:"AGENTS.md",secondaryFiles:i(".opencode/AGENTS.md",".opencode/agents/neocortex-root.md",".opencode/agents/neocortex.md",".agent/skills/neocortex/SKILL.md"),ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"agents-md",budget:{maxLines:220,maxBytes:18e3},linkRequirement:r,bidirectionalReference:o(r),requiresWrapperPreservation:!0,notes:"OpenCode agent memory. It consumes AGENTS.md-compatible instructions and must resolve to canonical NEOCORTEX.md."},openclaw:{targetId:"openclaw",platformName:"OpenClaw",canonicalSource:e,primaryFile:".openclaw/skills/neocortex/SKILL.md",secondaryFiles:[{scope:"user",path:".openclaw/skills/neocortex/SKILL.md"}],ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"agents-md",budget:{maxLines:220,maxBytes:18e3},linkRequirement:c,bidirectionalReference:o(c),requiresWrapperPreservation:!0,notes:"OpenClaw Skill thin-client memory entrypoint. Use the project Skill path when --create-project is requested; do not mutate ~/.openclaw/openclaw.json, and keep memory content public-safe."},kimi:{targetId:"kimi",platformName:"Kimi",canonicalSource:e,primaryFile:"KIMI.md",secondaryFiles:i("AGENTS.md",".kimi/skills/neocortex/SKILL.md"),ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"agents-md",budget:{maxLines:220,maxBytes:18e3},linkRequirement:c,bidirectionalReference:o(c),requiresWrapperPreservation:!0,notes:"Kimi memory entrypoint. Prefer a symlink to NEOCORTEX.md; use a compact include only if the host cannot follow symlinks."},"github-copilot-cli":{targetId:"github-copilot-cli",platformName:"GitHub Copilot CLI / gh alias",canonicalSource:e,primaryFile:".github/copilot-instructions.md",secondaryFiles:i("AGENTS.md"),ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"copilot-instructions",budget:{maxLines:180,maxBytes:14e3},linkRequirement:c,bidirectionalReference:o(c),requiresWrapperPreservation:!0,notes:"GitHub Copilot CLI or gh alias instructions. Resolve compact memory back to NEOCORTEX.md without copying private prompt bodies."}};function p(t){return m[t]}function u(t){return t==="canonical"||s.includes(t)}function y(){return s.map(t=>m[t])}function E(t){const a=n=>n.replace(/\|/g,"\\|").replace(/\n/g," ");return["| Path | Title | Purpose | Suggested Usage |","| --- | --- | --- | --- |",...t.map(n=>`| ${a(n.path)} | ${a(n.title)} | ${a(n.purpose)} | ${a(n.suggestedUsage)} |`)].join(`
-`)}export{e as CANONICAL_PROJECT_MEMORY_SOURCE,m as PROJECT_MEMORY_TARGETS,s as PROJECT_MEMORY_TARGET_IDS,p as getProjectMemoryTarget,u as isProjectMemoryTargetId,y as listProjectMemoryTargets,E as renderArchitectureReferenceTable};
+/**
+ * P130.06: Client-side SSoT-Shadow mirror for project memory targets.
+ *
+ * The published client tarball must not import the workspace-only shared package
+ * at runtime. Keep this file in sync with `packages/shared/src/project-memory-*`
+ * and enforce drift through the P130.06 release tests.
+ */
+function projectFileRefs(...paths) {
+    return paths.map((path) => ({ scope: 'project', path }));
+}
+export const CANONICAL_PROJECT_MEMORY_SOURCE = 'NEOCORTEX.md';
+const MANDATORY_SEMANTIC_SYMLINK = {
+    canonicalSource: CANONICAL_PROJECT_MEMORY_SOURCE,
+    semanticFileRequired: true,
+    symlinkBacked: true,
+    wrapperAllowed: false,
+    includeFallbackAllowed: false,
+    requiresWrapperPreservation: false,
+    fallbackIsCompatibilityRemediation: true,
+    policy: 'mandatory-semantic-symlink',
+    notes: 'Semantic platform memory file must resolve to NEOCORTEX.md through a symlink; do not replace it with an unrelated wrapper or copied frontmatter.',
+};
+const SYMLINK_BACKED_WRAPPER = {
+    canonicalSource: CANONICAL_PROJECT_MEMORY_SOURCE,
+    semanticFileRequired: true,
+    symlinkBacked: true,
+    wrapperAllowed: true,
+    includeFallbackAllowed: false,
+    requiresWrapperPreservation: true,
+    fallbackIsCompatibilityRemediation: true,
+    policy: 'symlink-backed-wrapper',
+    notes: 'Platform wrapper/frontmatter is allowed only when the semantic memory payload remains symlink-backed by NEOCORTEX.md.',
+};
+const SAFE_INCLUDE_FALLBACK = {
+    canonicalSource: CANONICAL_PROJECT_MEMORY_SOURCE,
+    semanticFileRequired: true,
+    symlinkBacked: true,
+    wrapperAllowed: true,
+    includeFallbackAllowed: true,
+    requiresWrapperPreservation: true,
+    fallbackIsCompatibilityRemediation: true,
+    policy: 'safe-include-fallback',
+    notes: 'Use a safe include/import only for platforms that cannot consume symlinks directly; the include must resolve back to NEOCORTEX.md.',
+};
+function bidirectionalReference(requirement) {
+    return {
+        canonicalSource: CANONICAL_PROJECT_MEMORY_SOURCE,
+        resolvesVia: requirement.policy,
+        feedbackTrigger: '*update-memory',
+        guidance: 'Treat NEOCORTEX.md as canonical project memory; consult it before platform-specific memory, and run *update-memory when durable project context changes should flow back to the canonical source.',
+    };
+}
+export const PROJECT_MEMORY_TARGET_IDS = [
+    'claude-code',
+    'codex',
+    'grok',
+    'gemini-cli',
+    'antigravity',
+    'vscode',
+    'cursor',
+    'opencode',
+    'openclaw',
+    'kimi',
+    'github-copilot-cli',
+];
+export const PROJECT_MEMORY_TARGETS = {
+    canonical: {
+        targetId: 'canonical',
+        platformName: 'Neocortex Canonical Memory',
+        canonicalSource: CANONICAL_PROJECT_MEMORY_SOURCE,
+        primaryFile: CANONICAL_PROJECT_MEMORY_SOURCE,
+        secondaryFiles: projectFileRefs('AGENTS.md', 'CLAUDE.md', 'GEMINI.md'),
+        ownedBlockName: 'NEOCORTEX-MEMORY',
+        templateKind: 'neocortex-md',
+        budget: { maxLines: 220, maxBytes: 18_000 },
+        linkRequirement: MANDATORY_SEMANTIC_SYMLINK,
+        bidirectionalReference: bidirectionalReference(MANDATORY_SEMANTIC_SYMLINK),
+        requiresWrapperPreservation: false,
+        notes: 'Canonical compact project memory source for platform symlinks and wrappers. Store only summaries, indexes, and links to architecture docs here.',
+    },
+    'claude-code': {
+        targetId: 'claude-code',
+        platformName: 'Claude Code',
+        canonicalSource: CANONICAL_PROJECT_MEMORY_SOURCE,
+        primaryFile: 'CLAUDE.md',
+        secondaryFiles: projectFileRefs('.claude/agents/neocortex.md'),
+        ownedBlockName: 'NEOCORTEX-MEMORY',
+        templateKind: 'claude-md',
+        budget: { maxLines: 320, maxBytes: 28_000 },
+        linkRequirement: MANDATORY_SEMANTIC_SYMLINK,
+        bidirectionalReference: bidirectionalReference(MANDATORY_SEMANTIC_SYMLINK),
+        requiresWrapperPreservation: false,
+        notes: 'Claude Code project memory. Resolve to NEOCORTEX.md; keep root content concise and link deeper docs with @path references.',
+    },
+    codex: {
+        targetId: 'codex',
+        platformName: 'Codex CLI',
+        canonicalSource: CANONICAL_PROJECT_MEMORY_SOURCE,
+        primaryFile: 'AGENTS.md',
+        secondaryFiles: projectFileRefs('.codex/agents/neocortex.toml'),
+        ownedBlockName: 'NEOCORTEX-MEMORY',
+        templateKind: 'agents-md',
+        budget: { maxLines: 220, maxBytes: 18_000 },
+        linkRequirement: MANDATORY_SEMANTIC_SYMLINK,
+        bidirectionalReference: bidirectionalReference(MANDATORY_SEMANTIC_SYMLINK),
+        requiresWrapperPreservation: true,
+        notes: 'Codex root instructions. Uppercase AGENTS.md is required on case-sensitive filesystems.',
+    },
+    grok: {
+        targetId: 'grok',
+        platformName: 'Grok Build',
+        canonicalSource: CANONICAL_PROJECT_MEMORY_SOURCE,
+        primaryFile: 'AGENTS.md',
+        secondaryFiles: projectFileRefs('.grok/skills/neocortex/SKILL.md'),
+        ownedBlockName: 'NEOCORTEX-MEMORY',
+        templateKind: 'agents-md',
+        budget: { maxLines: 220, maxBytes: 18_000 },
+        linkRequirement: MANDATORY_SEMANTIC_SYMLINK,
+        bidirectionalReference: bidirectionalReference(MANDATORY_SEMANTIC_SYMLINK),
+        requiresWrapperPreservation: true,
+        notes: 'Grok Build reads AGENTS.md and the project-local Neocortex Skill; both resolve to canonical NEOCORTEX.md context.',
+    },
+    'gemini-cli': {
+        targetId: 'gemini-cli',
+        platformName: 'Gemini CLI',
+        canonicalSource: CANONICAL_PROJECT_MEMORY_SOURCE,
+        primaryFile: 'GEMINI.md',
+        secondaryFiles: projectFileRefs('.gemini/agents/neocortex.md'),
+        ownedBlockName: 'NEOCORTEX-MEMORY',
+        templateKind: 'gemini-md',
+        budget: { maxLines: 260, maxBytes: 22_000 },
+        linkRequirement: MANDATORY_SEMANTIC_SYMLINK,
+        bidirectionalReference: bidirectionalReference(MANDATORY_SEMANTIC_SYMLINK),
+        requiresWrapperPreservation: false,
+        notes: 'Gemini CLI context file. Prefer shallow @file.md imports for detailed architecture docs.',
+    },
+    antigravity: {
+        targetId: 'antigravity',
+        platformName: 'Antigravity',
+        canonicalSource: CANONICAL_PROJECT_MEMORY_SOURCE,
+        primaryFile: 'GEMINI.md',
+        secondaryFiles: projectFileRefs('.gemini/agents/neocortex.md'),
+        ownedBlockName: 'NEOCORTEX-MEMORY',
+        templateKind: 'gemini-md',
+        budget: { maxLines: 260, maxBytes: 22_000 },
+        linkRequirement: MANDATORY_SEMANTIC_SYMLINK,
+        bidirectionalReference: bidirectionalReference(MANDATORY_SEMANTIC_SYMLINK),
+        requiresWrapperPreservation: false,
+        notes: 'Antigravity currently shares GEMINI.md behavior with the Gemini target stubs.',
+    },
+    vscode: {
+        targetId: 'vscode',
+        platformName: 'VS Code / GitHub Copilot',
+        canonicalSource: CANONICAL_PROJECT_MEMORY_SOURCE,
+        primaryFile: '.github/copilot-instructions.md',
+        secondaryFiles: projectFileRefs('.github/instructions/neocortex.instructions.md', '.github/agents/neocortex.agent.md'),
+        ownedBlockName: 'NEOCORTEX-MEMORY',
+        templateKind: 'copilot-instructions',
+        budget: { maxLines: 180, maxBytes: 14_000 },
+        linkRequirement: SYMLINK_BACKED_WRAPPER,
+        bidirectionalReference: bidirectionalReference(SYMLINK_BACKED_WRAPPER),
+        requiresWrapperPreservation: true,
+        notes: 'VS Code and GitHub Copilot always-on repository instructions.',
+    },
+    cursor: {
+        targetId: 'cursor',
+        platformName: 'Cursor',
+        canonicalSource: CANONICAL_PROJECT_MEMORY_SOURCE,
+        primaryFile: '.cursor/rules/neocortex.mdc',
+        secondaryFiles: projectFileRefs('AGENTS.md'),
+        ownedBlockName: 'NEOCORTEX-MEMORY',
+        templateKind: 'cursor-rule',
+        budget: { maxLines: 180, maxBytes: 14_000 },
+        linkRequirement: SYMLINK_BACKED_WRAPPER,
+        bidirectionalReference: bidirectionalReference(SYMLINK_BACKED_WRAPPER),
+        requiresWrapperPreservation: true,
+        notes: 'Cursor rule memory. Use AGENTS.md as compatibility fallback when Cursor rules are absent.',
+    },
+    opencode: {
+        targetId: 'opencode',
+        platformName: 'OpenCode',
+        canonicalSource: CANONICAL_PROJECT_MEMORY_SOURCE,
+        primaryFile: 'AGENTS.md',
+        secondaryFiles: projectFileRefs('.opencode/AGENTS.md', '.opencode/agents/neocortex-root.md', '.opencode/agents/neocortex.md', '.agent/skills/neocortex/SKILL.md'),
+        ownedBlockName: 'NEOCORTEX-MEMORY',
+        templateKind: 'agents-md',
+        budget: { maxLines: 220, maxBytes: 18_000 },
+        linkRequirement: MANDATORY_SEMANTIC_SYMLINK,
+        bidirectionalReference: bidirectionalReference(MANDATORY_SEMANTIC_SYMLINK),
+        requiresWrapperPreservation: true,
+        notes: 'OpenCode agent memory. It consumes AGENTS.md-compatible instructions and must resolve to canonical NEOCORTEX.md.',
+    },
+    openclaw: {
+        targetId: 'openclaw',
+        platformName: 'OpenClaw',
+        canonicalSource: CANONICAL_PROJECT_MEMORY_SOURCE,
+        primaryFile: '.openclaw/skills/neocortex/SKILL.md',
+        secondaryFiles: [{ scope: 'user', path: '.openclaw/skills/neocortex/SKILL.md' }],
+        ownedBlockName: 'NEOCORTEX-MEMORY',
+        templateKind: 'agents-md',
+        budget: { maxLines: 220, maxBytes: 18_000 },
+        linkRequirement: SAFE_INCLUDE_FALLBACK,
+        bidirectionalReference: bidirectionalReference(SAFE_INCLUDE_FALLBACK),
+        requiresWrapperPreservation: true,
+        notes: 'OpenClaw Skill thin-client memory entrypoint. Use the project Skill path when --create-project is requested; do not mutate ~/.openclaw/openclaw.json, and keep memory content public-safe.',
+    },
+    kimi: {
+        targetId: 'kimi',
+        platformName: 'Kimi',
+        canonicalSource: CANONICAL_PROJECT_MEMORY_SOURCE,
+        primaryFile: 'KIMI.md',
+        secondaryFiles: projectFileRefs('AGENTS.md', '.kimi/skills/neocortex/SKILL.md'),
+        ownedBlockName: 'NEOCORTEX-MEMORY',
+        templateKind: 'agents-md',
+        budget: { maxLines: 220, maxBytes: 18_000 },
+        linkRequirement: SAFE_INCLUDE_FALLBACK,
+        bidirectionalReference: bidirectionalReference(SAFE_INCLUDE_FALLBACK),
+        requiresWrapperPreservation: true,
+        notes: 'Kimi memory entrypoint. Prefer a symlink to NEOCORTEX.md; use a compact include only if the host cannot follow symlinks.',
+    },
+    'github-copilot-cli': {
+        targetId: 'github-copilot-cli',
+        platformName: 'GitHub Copilot CLI / gh alias',
+        canonicalSource: CANONICAL_PROJECT_MEMORY_SOURCE,
+        primaryFile: '.github/copilot-instructions.md',
+        secondaryFiles: projectFileRefs('AGENTS.md'),
+        ownedBlockName: 'NEOCORTEX-MEMORY',
+        templateKind: 'copilot-instructions',
+        budget: { maxLines: 180, maxBytes: 14_000 },
+        linkRequirement: SAFE_INCLUDE_FALLBACK,
+        bidirectionalReference: bidirectionalReference(SAFE_INCLUDE_FALLBACK),
+        requiresWrapperPreservation: true,
+        notes: 'GitHub Copilot CLI or gh alias instructions. Resolve compact memory back to NEOCORTEX.md without copying private prompt bodies.',
+    },
+};
+export function getProjectMemoryTarget(targetId) {
+    return PROJECT_MEMORY_TARGETS[targetId];
+}
+export function isProjectMemoryTargetId(value) {
+    return value === 'canonical' || PROJECT_MEMORY_TARGET_IDS.includes(value);
+}
+export function listProjectMemoryTargets() {
+    return PROJECT_MEMORY_TARGET_IDS.map((targetId) => PROJECT_MEMORY_TARGETS[targetId]);
+}
+export function renderArchitectureReferenceTable(references) {
+    const escapeCell = (value) => value.replace(/\|/g, '\\|').replace(/\n/g, ' ');
+    const rows = references.map((reference) => `| ${escapeCell(reference.path)} | ${escapeCell(reference.title)} | ${escapeCell(reference.purpose)} | ${escapeCell(reference.suggestedUsage)} |`);
+    return [
+        '| Path | Title | Purpose | Suggested Usage |',
+        '| --- | --- | --- | --- |',
+        ...rows,
+    ].join('\n');
+}

package/packages/client/dist/migrations/epic-lifecycle-backfill.d.ts

@@ -0,0 +1,97 @@
+import { type ContinuitySqliteAdapter, type ContinuitySqliteAdapterLoadResult } from '../continuity/sqlite-store.js';
+import { type EpicLifecycleBackfillReceiptV1, type EpicOperationalIdentityV1, type EpicOperationalRollbackReceiptV1 } from '../git/epic-operational-state.js';
+export type EpicLifecycleBackfillSourceKind = 'common-runtime' | 'tracked-state' | 'legacy-yoloop-state' | 'legacy-yoloop-lock' | 'sqlite-projection';
+export interface EpicLifecycleBackfillSourceV1 {
+    readonly schemaVersion: 'EpicLifecycleBackfillSource/1.0';
+    readonly kind: EpicLifecycleBackfillSourceKind;
+    readonly sourceFingerprint: string;
+    readonly presence: 'missing' | 'present' | 'corrupt' | 'unsafe' | 'unsupported' | 'unavailable';
+    readonly byteLength: number | null;
+    readonly byteDigest: string | null;
+    readonly canonicalDigest: string | null;
+    readonly sourceSchema: string | null;
+    readonly status: 'candidate' | 'projection' | 'activity' | 'blocked' | 'absent';
+    readonly role: 'authority-candidate' | 'projection' | 'activity-signal';
+    readonly reasonCodes: readonly string[];
+    readonly publicSafe: true;
+}
+export interface EpicLifecycleManagedClientFenceV1 {
+    readonly clientId: string;
+    readonly writerEpoch: number;
+    readonly capabilities: readonly string[];
+    readonly activeWriter: boolean;
+}
+export interface EpicLifecycleBackfillPlanV1 {
+    readonly schemaVersion: 'EpicLifecycleBackfillPlan/1.0';
+    readonly operationId: string;
+    readonly idempotencyKey: string;
+    readonly repositoryFingerprint: string;
+    readonly identity: EpicOperationalIdentityV1;
+    readonly expectedRuntimeSchema: 0 | 1 | 2;
+    readonly expectedRevision: number;
+    readonly expectedWriterEpoch: number;
+    readonly nextWriterEpoch: number;
+    readonly sourceInventory: readonly EpicLifecycleBackfillSourceV1[];
+    readonly sourceInventoryDigest: string;
+    readonly requiredSourceDigest: string;
+    readonly checkoutCount: number;
+    readonly checkoutSetDigest: string;
+    readonly managedClientFenceDigest: string;
+    readonly selectedYoloopSourceFingerprint: string | null;
+    readonly selectedYoloopCanonicalDigest: string;
+    readonly trackedStateMigration: {
+        readonly outcome: 'migrate' | 'unchanged';
+        readonly operationId: string | null;
+        readonly sourceByteDigest: string;
+        readonly targetByteDigest: string;
+        readonly sourceCanonicalHash: string | null;
+        readonly targetCanonicalHash: string | null;
+    };
+    readonly conflicts: readonly string[];
+    readonly blockers: readonly string[];
+    readonly proposedEffects: readonly string[];
+    readonly rollbackPreconditions: readonly string[];
+    readonly authorityPostimageDigest: string;
+    readonly planDigest: string;
+    readonly publicSafe: true;
+}
+/** Opaque and process-local. JSON/spread/structural mocks cannot authorize. */
+export interface EpicLifecycleBackfillApproval {
+    readonly __epicLifecycleBackfillApproval: never;
+}
+export interface EpicLifecycleBackfillHooks {
+    readonly afterBackup?: () => void | Promise<void>;
+    readonly afterPrepared?: () => void | Promise<void>;
+    readonly afterAuthorityApplied?: () => void | Promise<void>;
+    readonly afterTrackedProjection?: () => void | Promise<void>;
+    readonly afterProjectionsApplied?: () => void | Promise<void>;
+}
+export interface EpicLifecycleBackfillOptions {
+    readonly epicId: string;
+    readonly executionBranch: string;
+    readonly graphRevision: string;
+    readonly originBindingDigest: string;
+    readonly managedClients?: readonly EpicLifecycleManagedClientFenceV1[];
+    readonly nowIso?: string;
+    readonly sqliteAdapter?: ContinuitySqliteAdapter;
+    readonly sqliteAdapterLoader?: () => Promise<ContinuitySqliteAdapterLoadResult>;
+}
+export interface EpicLifecycleBackfillApplyResult {
+    readonly applied: boolean;
+    readonly replay: boolean;
+    readonly receipt: EpicLifecycleBackfillReceiptV1;
+    readonly revision: number;
+    readonly writerEpoch: number;
+}
+export declare function previewEpicLifecycleBackfill(projectRoot: string, options: EpicLifecycleBackfillOptions): Promise<EpicLifecycleBackfillPlanV1>;
+export declare function approveEpicLifecycleBackfill(plan: EpicLifecycleBackfillPlanV1): EpicLifecycleBackfillApproval;
+export declare function applyEpicLifecycleBackfill(projectRoot: string, plan: EpicLifecycleBackfillPlanV1, approval?: EpicLifecycleBackfillApproval, hooks?: EpicLifecycleBackfillHooks): Promise<EpicLifecycleBackfillApplyResult>;
+export declare function rollbackEpicLifecycleBackfill(input: {
+    readonly projectRoot: string;
+    readonly targetOperationId: string;
+    readonly expectedRevision: number;
+    readonly expectedWriterEpoch: number;
+}): Promise<{
+    readonly receipt: EpicOperationalRollbackReceiptV1;
+    readonly revision: number;
+}>;