@ornexus/neocortex 4.60.73 → 4.60.74

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

@@ -1,253 +1,2 @@
-/**
- * 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');
-}
+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};