@ornexus/neocortex 4.59.1

package/packages/client/dist/memory/shared-project-memory-types.d.ts

@@ -0,0 +1,370 @@
+/**
+ * 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.
+ */
+export type ProjectMemoryTargetId = 'canonical' | 'claude-code' | 'codex' | 'gemini-cli' | 'antigravity' | 'vscode' | 'cursor' | 'opencode' | 'openclaw' | 'kimi' | 'github-copilot-cli';
+export type ProjectMemoryTemplateKind = 'neocortex-md' | 'claude-md' | 'agents-md' | 'gemini-md' | 'copilot-instructions' | 'cursor-rule';
+export interface ProjectMemoryBudget {
+    readonly maxLines: number;
+    readonly maxBytes: number;
+}
+export type ProjectMemoryLinkPolicy = 'mandatory-semantic-symlink' | 'symlink-backed-wrapper' | 'safe-include-fallback';
+export interface ProjectMemoryLinkRequirement {
+    readonly canonicalSource: typeof CANONICAL_PROJECT_MEMORY_SOURCE;
+    readonly semanticFileRequired: boolean;
+    readonly symlinkBacked: boolean;
+    readonly wrapperAllowed: boolean;
+    readonly includeFallbackAllowed: boolean;
+    readonly requiresWrapperPreservation: boolean;
+    readonly fallbackIsCompatibilityRemediation: boolean;
+    readonly policy: ProjectMemoryLinkPolicy;
+    readonly notes: string;
+}
+export interface ProjectMemoryTarget {
+    readonly targetId: ProjectMemoryTargetId;
+    readonly platformName: string;
+    readonly canonicalSource: typeof CANONICAL_PROJECT_MEMORY_SOURCE;
+    readonly primaryFile: string;
+    readonly secondaryFiles: readonly string[];
+    readonly ownedBlockName: string;
+    readonly templateKind: ProjectMemoryTemplateKind;
+    readonly budget: ProjectMemoryBudget;
+    readonly linkRequirement: ProjectMemoryLinkRequirement;
+    readonly bidirectionalReference: ProjectMemoryBidirectionalReference;
+    readonly requiresWrapperPreservation: boolean;
+    readonly notes: string;
+}
+export interface ProjectMemoryBidirectionalReference {
+    readonly canonicalSource: typeof CANONICAL_PROJECT_MEMORY_SOURCE;
+    readonly resolvesVia: ProjectMemoryLinkPolicy;
+    readonly feedbackTrigger: '*update-memory';
+    readonly guidance: string;
+}
+export type ArchitectureReferenceSource = 'architecture-root' | 'fallback-file';
+export interface ArchitectureReference {
+    readonly path: string;
+    readonly title: string;
+    readonly purpose: string;
+    readonly suggestedUsage: string;
+    readonly source: ArchitectureReferenceSource;
+}
+export interface BootstrapArchitectureMemory {
+    readonly universalLaws?: readonly string[];
+    readonly businessContext?: readonly string[];
+    readonly activeContext?: readonly string[];
+    readonly repositoryMap?: readonly string[];
+    readonly environmentPractices?: readonly string[];
+    readonly platformMemoryContract?: readonly string[];
+    readonly maintenanceRules?: readonly string[];
+    readonly importantReferences?: readonly ArchitectureReference[];
+    readonly architectureReferences?: readonly ArchitectureReference[];
+    readonly heuristics?: readonly string[];
+}
+export declare const CANONICAL_PROJECT_MEMORY_SOURCE: "NEOCORTEX.md";
+export declare const PROJECT_MEMORY_TARGET_IDS: readonly ["claude-code", "codex", "gemini-cli", "antigravity", "vscode", "cursor", "opencode", "openclaw", "kimi", "github-copilot-cli"];
+export declare const PROJECT_MEMORY_TARGETS: {
+    readonly canonical: {
+        readonly targetId: "canonical";
+        readonly platformName: "Neocortex Canonical Memory";
+        readonly canonicalSource: "NEOCORTEX.md";
+        readonly primaryFile: "NEOCORTEX.md";
+        readonly secondaryFiles: readonly ["AGENTS.md", "CLAUDE.md", "GEMINI.md"];
+        readonly ownedBlockName: "NEOCORTEX-MEMORY";
+        readonly templateKind: "neocortex-md";
+        readonly budget: {
+            readonly maxLines: 220;
+            readonly maxBytes: 18000;
+        };
+        readonly linkRequirement: {
+            readonly canonicalSource: "NEOCORTEX.md";
+            readonly semanticFileRequired: true;
+            readonly symlinkBacked: true;
+            readonly wrapperAllowed: false;
+            readonly includeFallbackAllowed: false;
+            readonly requiresWrapperPreservation: false;
+            readonly fallbackIsCompatibilityRemediation: true;
+            readonly policy: "mandatory-semantic-symlink";
+            readonly notes: "Semantic platform memory file must resolve to NEOCORTEX.md through a symlink; do not replace it with an unrelated wrapper or copied frontmatter.";
+        };
+        readonly bidirectionalReference: ProjectMemoryBidirectionalReference;
+        readonly requiresWrapperPreservation: false;
+        readonly notes: "Canonical compact project memory source for platform symlinks and wrappers. Store only summaries, indexes, and links to architecture docs here.";
+    };
+    readonly 'claude-code': {
+        readonly targetId: "claude-code";
+        readonly platformName: "Claude Code";
+        readonly canonicalSource: "NEOCORTEX.md";
+        readonly primaryFile: "CLAUDE.md";
+        readonly secondaryFiles: readonly [".claude/agents/neocortex.md"];
+        readonly ownedBlockName: "NEOCORTEX-MEMORY";
+        readonly templateKind: "claude-md";
+        readonly budget: {
+            readonly maxLines: 320;
+            readonly maxBytes: 28000;
+        };
+        readonly linkRequirement: {
+            readonly canonicalSource: "NEOCORTEX.md";
+            readonly semanticFileRequired: true;
+            readonly symlinkBacked: true;
+            readonly wrapperAllowed: false;
+            readonly includeFallbackAllowed: false;
+            readonly requiresWrapperPreservation: false;
+            readonly fallbackIsCompatibilityRemediation: true;
+            readonly policy: "mandatory-semantic-symlink";
+            readonly notes: "Semantic platform memory file must resolve to NEOCORTEX.md through a symlink; do not replace it with an unrelated wrapper or copied frontmatter.";
+        };
+        readonly bidirectionalReference: ProjectMemoryBidirectionalReference;
+        readonly requiresWrapperPreservation: false;
+        readonly notes: "Claude Code project memory. Resolve to NEOCORTEX.md; keep root content concise and link deeper docs with @path references.";
+    };
+    readonly codex: {
+        readonly targetId: "codex";
+        readonly platformName: "Codex CLI";
+        readonly canonicalSource: "NEOCORTEX.md";
+        readonly primaryFile: "AGENTS.md";
+        readonly secondaryFiles: readonly [".codex/agents/neocortex.toml"];
+        readonly ownedBlockName: "NEOCORTEX-MEMORY";
+        readonly templateKind: "agents-md";
+        readonly budget: {
+            readonly maxLines: 220;
+            readonly maxBytes: 18000;
+        };
+        readonly linkRequirement: {
+            readonly canonicalSource: "NEOCORTEX.md";
+            readonly semanticFileRequired: true;
+            readonly symlinkBacked: true;
+            readonly wrapperAllowed: false;
+            readonly includeFallbackAllowed: false;
+            readonly requiresWrapperPreservation: false;
+            readonly fallbackIsCompatibilityRemediation: true;
+            readonly policy: "mandatory-semantic-symlink";
+            readonly notes: "Semantic platform memory file must resolve to NEOCORTEX.md through a symlink; do not replace it with an unrelated wrapper or copied frontmatter.";
+        };
+        readonly bidirectionalReference: ProjectMemoryBidirectionalReference;
+        readonly requiresWrapperPreservation: true;
+        readonly notes: "Codex root instructions. Uppercase AGENTS.md is required on case-sensitive filesystems.";
+    };
+    readonly 'gemini-cli': {
+        readonly targetId: "gemini-cli";
+        readonly platformName: "Gemini CLI";
+        readonly canonicalSource: "NEOCORTEX.md";
+        readonly primaryFile: "GEMINI.md";
+        readonly secondaryFiles: readonly [".gemini/agents/neocortex.md"];
+        readonly ownedBlockName: "NEOCORTEX-MEMORY";
+        readonly templateKind: "gemini-md";
+        readonly budget: {
+            readonly maxLines: 260;
+            readonly maxBytes: 22000;
+        };
+        readonly linkRequirement: {
+            readonly canonicalSource: "NEOCORTEX.md";
+            readonly semanticFileRequired: true;
+            readonly symlinkBacked: true;
+            readonly wrapperAllowed: false;
+            readonly includeFallbackAllowed: false;
+            readonly requiresWrapperPreservation: false;
+            readonly fallbackIsCompatibilityRemediation: true;
+            readonly policy: "mandatory-semantic-symlink";
+            readonly notes: "Semantic platform memory file must resolve to NEOCORTEX.md through a symlink; do not replace it with an unrelated wrapper or copied frontmatter.";
+        };
+        readonly bidirectionalReference: ProjectMemoryBidirectionalReference;
+        readonly requiresWrapperPreservation: false;
+        readonly notes: "Gemini CLI context file. Prefer shallow @file.md imports for detailed architecture docs.";
+    };
+    readonly antigravity: {
+        readonly targetId: "antigravity";
+        readonly platformName: "Antigravity";
+        readonly canonicalSource: "NEOCORTEX.md";
+        readonly primaryFile: "GEMINI.md";
+        readonly secondaryFiles: readonly [".gemini/agents/neocortex.md"];
+        readonly ownedBlockName: "NEOCORTEX-MEMORY";
+        readonly templateKind: "gemini-md";
+        readonly budget: {
+            readonly maxLines: 260;
+            readonly maxBytes: 22000;
+        };
+        readonly linkRequirement: {
+            readonly canonicalSource: "NEOCORTEX.md";
+            readonly semanticFileRequired: true;
+            readonly symlinkBacked: true;
+            readonly wrapperAllowed: false;
+            readonly includeFallbackAllowed: false;
+            readonly requiresWrapperPreservation: false;
+            readonly fallbackIsCompatibilityRemediation: true;
+            readonly policy: "mandatory-semantic-symlink";
+            readonly notes: "Semantic platform memory file must resolve to NEOCORTEX.md through a symlink; do not replace it with an unrelated wrapper or copied frontmatter.";
+        };
+        readonly bidirectionalReference: ProjectMemoryBidirectionalReference;
+        readonly requiresWrapperPreservation: false;
+        readonly notes: "Antigravity currently shares GEMINI.md behavior with the Gemini target stubs.";
+    };
+    readonly vscode: {
+        readonly targetId: "vscode";
+        readonly platformName: "VS Code / GitHub Copilot";
+        readonly canonicalSource: "NEOCORTEX.md";
+        readonly primaryFile: ".github/copilot-instructions.md";
+        readonly secondaryFiles: readonly [".github/instructions/neocortex.instructions.md", ".github/agents/neocortex.agent.md"];
+        readonly ownedBlockName: "NEOCORTEX-MEMORY";
+        readonly templateKind: "copilot-instructions";
+        readonly budget: {
+            readonly maxLines: 180;
+            readonly maxBytes: 14000;
+        };
+        readonly linkRequirement: {
+            readonly canonicalSource: "NEOCORTEX.md";
+            readonly semanticFileRequired: true;
+            readonly symlinkBacked: true;
+            readonly wrapperAllowed: true;
+            readonly includeFallbackAllowed: false;
+            readonly requiresWrapperPreservation: true;
+            readonly fallbackIsCompatibilityRemediation: true;
+            readonly policy: "symlink-backed-wrapper";
+            readonly notes: "Platform wrapper/frontmatter is allowed only when the semantic memory payload remains symlink-backed by NEOCORTEX.md.";
+        };
+        readonly bidirectionalReference: ProjectMemoryBidirectionalReference;
+        readonly requiresWrapperPreservation: true;
+        readonly notes: "VS Code and GitHub Copilot always-on repository instructions.";
+    };
+    readonly cursor: {
+        readonly targetId: "cursor";
+        readonly platformName: "Cursor";
+        readonly canonicalSource: "NEOCORTEX.md";
+        readonly primaryFile: ".cursor/rules/neocortex.mdc";
+        readonly secondaryFiles: readonly ["AGENTS.md"];
+        readonly ownedBlockName: "NEOCORTEX-MEMORY";
+        readonly templateKind: "cursor-rule";
+        readonly budget: {
+            readonly maxLines: 180;
+            readonly maxBytes: 14000;
+        };
+        readonly linkRequirement: {
+            readonly canonicalSource: "NEOCORTEX.md";
+            readonly semanticFileRequired: true;
+            readonly symlinkBacked: true;
+            readonly wrapperAllowed: true;
+            readonly includeFallbackAllowed: false;
+            readonly requiresWrapperPreservation: true;
+            readonly fallbackIsCompatibilityRemediation: true;
+            readonly policy: "symlink-backed-wrapper";
+            readonly notes: "Platform wrapper/frontmatter is allowed only when the semantic memory payload remains symlink-backed by NEOCORTEX.md.";
+        };
+        readonly bidirectionalReference: ProjectMemoryBidirectionalReference;
+        readonly requiresWrapperPreservation: true;
+        readonly notes: "Cursor rule memory. Use AGENTS.md as compatibility fallback when Cursor rules are absent.";
+    };
+    readonly opencode: {
+        readonly targetId: "opencode";
+        readonly platformName: "OpenCode";
+        readonly canonicalSource: "NEOCORTEX.md";
+        readonly primaryFile: "AGENTS.md";
+        readonly secondaryFiles: readonly [".opencode/AGENTS.md", ".opencode/agents/neocortex-root.md", ".opencode/agents/neocortex.md", ".agent/skills/neocortex/SKILL.md"];
+        readonly ownedBlockName: "NEOCORTEX-MEMORY";
+        readonly templateKind: "agents-md";
+        readonly budget: {
+            readonly maxLines: 220;
+            readonly maxBytes: 18000;
+        };
+        readonly linkRequirement: {
+            readonly canonicalSource: "NEOCORTEX.md";
+            readonly semanticFileRequired: true;
+            readonly symlinkBacked: true;
+            readonly wrapperAllowed: false;
+            readonly includeFallbackAllowed: false;
+            readonly requiresWrapperPreservation: false;
+            readonly fallbackIsCompatibilityRemediation: true;
+            readonly policy: "mandatory-semantic-symlink";
+            readonly notes: "Semantic platform memory file must resolve to NEOCORTEX.md through a symlink; do not replace it with an unrelated wrapper or copied frontmatter.";
+        };
+        readonly bidirectionalReference: ProjectMemoryBidirectionalReference;
+        readonly requiresWrapperPreservation: true;
+        readonly notes: "OpenCode agent memory. It consumes AGENTS.md-compatible instructions and must resolve to canonical NEOCORTEX.md.";
+    };
+    readonly openclaw: {
+        readonly targetId: "openclaw";
+        readonly platformName: "OpenClaw";
+        readonly canonicalSource: "NEOCORTEX.md";
+        readonly primaryFile: ".openclaw/skills/neocortex/SKILL.md";
+        readonly secondaryFiles: readonly ["~/.openclaw/skills/neocortex/SKILL.md"];
+        readonly ownedBlockName: "NEOCORTEX-MEMORY";
+        readonly templateKind: "agents-md";
+        readonly budget: {
+            readonly maxLines: 220;
+            readonly maxBytes: 18000;
+        };
+        readonly linkRequirement: {
+            readonly canonicalSource: "NEOCORTEX.md";
+            readonly semanticFileRequired: true;
+            readonly symlinkBacked: true;
+            readonly wrapperAllowed: true;
+            readonly includeFallbackAllowed: true;
+            readonly requiresWrapperPreservation: true;
+            readonly fallbackIsCompatibilityRemediation: true;
+            readonly policy: "safe-include-fallback";
+            readonly notes: "Use a safe include/import only for platforms that cannot consume symlinks directly; the include must resolve back to NEOCORTEX.md.";
+        };
+        readonly bidirectionalReference: ProjectMemoryBidirectionalReference;
+        readonly requiresWrapperPreservation: true;
+        readonly 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.";
+    };
+    readonly kimi: {
+        readonly targetId: "kimi";
+        readonly platformName: "Kimi";
+        readonly canonicalSource: "NEOCORTEX.md";
+        readonly primaryFile: "KIMI.md";
+        readonly secondaryFiles: readonly ["AGENTS.md", ".kimi/skills/neocortex/SKILL.md"];
+        readonly ownedBlockName: "NEOCORTEX-MEMORY";
+        readonly templateKind: "agents-md";
+        readonly budget: {
+            readonly maxLines: 220;
+            readonly maxBytes: 18000;
+        };
+        readonly linkRequirement: {
+            readonly canonicalSource: "NEOCORTEX.md";
+            readonly semanticFileRequired: true;
+            readonly symlinkBacked: true;
+            readonly wrapperAllowed: true;
+            readonly includeFallbackAllowed: true;
+            readonly requiresWrapperPreservation: true;
+            readonly fallbackIsCompatibilityRemediation: true;
+            readonly policy: "safe-include-fallback";
+            readonly notes: "Use a safe include/import only for platforms that cannot consume symlinks directly; the include must resolve back to NEOCORTEX.md.";
+        };
+        readonly bidirectionalReference: ProjectMemoryBidirectionalReference;
+        readonly requiresWrapperPreservation: true;
+        readonly notes: "Kimi memory entrypoint. Prefer a symlink to NEOCORTEX.md; use a compact include only if the host cannot follow symlinks.";
+    };
+    readonly 'github-copilot-cli': {
+        readonly targetId: "github-copilot-cli";
+        readonly platformName: "GitHub Copilot CLI / gh alias";
+        readonly canonicalSource: "NEOCORTEX.md";
+        readonly primaryFile: ".github/copilot-instructions.md";
+        readonly secondaryFiles: readonly ["AGENTS.md"];
+        readonly ownedBlockName: "NEOCORTEX-MEMORY";
+        readonly templateKind: "copilot-instructions";
+        readonly budget: {
+            readonly maxLines: 180;
+            readonly maxBytes: 14000;
+        };
+        readonly linkRequirement: {
+            readonly canonicalSource: "NEOCORTEX.md";
+            readonly semanticFileRequired: true;
+            readonly symlinkBacked: true;
+            readonly wrapperAllowed: true;
+            readonly includeFallbackAllowed: true;
+            readonly requiresWrapperPreservation: true;
+            readonly fallbackIsCompatibilityRemediation: true;
+            readonly policy: "safe-include-fallback";
+            readonly notes: "Use a safe include/import only for platforms that cannot consume symlinks directly; the include must resolve back to NEOCORTEX.md.";
+        };
+        readonly bidirectionalReference: ProjectMemoryBidirectionalReference;
+        readonly requiresWrapperPreservation: true;
+        readonly notes: "GitHub Copilot CLI or gh alias instructions. Resolve compact memory back to NEOCORTEX.md without copying private prompt bodies.";
+    };
+};
+export declare function getProjectMemoryTarget(targetId: ProjectMemoryTargetId): ProjectMemoryTarget;
+export declare function isProjectMemoryTargetId(value: string): value is ProjectMemoryTargetId;
+export declare function listProjectMemoryTargets(): readonly ProjectMemoryTarget[];
+export declare function renderArchitectureReferenceTable(references: readonly ArchitectureReference[]): string;

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

@@ -0,0 +1,2 @@
+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."},c={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."},a={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 t(o){return{canonicalSource:e,resolvesVia:o.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 l=["claude-code","codex","gemini-cli","antigravity","vscode","cursor","opencode","openclaw","kimi","github-copilot-cli"],s={canonical:{targetId:"canonical",platformName:"Neocortex Canonical Memory",canonicalSource:e,primaryFile:e,secondaryFiles:["AGENTS.md","CLAUDE.md","GEMINI.md"],ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"neocortex-md",budget:{maxLines:220,maxBytes:18e3},linkRequirement:r,bidirectionalReference:t(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:[".claude/agents/neocortex.md"],ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"claude-md",budget:{maxLines:320,maxBytes:28e3},linkRequirement:r,bidirectionalReference:t(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:[".codex/agents/neocortex.toml"],ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"agents-md",budget:{maxLines:220,maxBytes:18e3},linkRequirement:r,bidirectionalReference:t(r),requiresWrapperPreservation:!0,notes:"Codex root instructions. Uppercase AGENTS.md is required on case-sensitive filesystems."},"gemini-cli":{targetId:"gemini-cli",platformName:"Gemini CLI",canonicalSource:e,primaryFile:"GEMINI.md",secondaryFiles:[".gemini/agents/neocortex.md"],ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"gemini-md",budget:{maxLines:260,maxBytes:22e3},linkRequirement:r,bidirectionalReference:t(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:[".gemini/agents/neocortex.md"],ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"gemini-md",budget:{maxLines:260,maxBytes:22e3},linkRequirement:r,bidirectionalReference:t(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:[".github/instructions/neocortex.instructions.md",".github/agents/neocortex.agent.md"],ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"copilot-instructions",budget:{maxLines:180,maxBytes:14e3},linkRequirement:c,bidirectionalReference:t(c),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:["AGENTS.md"],ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"cursor-rule",budget:{maxLines:180,maxBytes:14e3},linkRequirement:c,bidirectionalReference:t(c),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:[".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:t(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:["~/.openclaw/skills/neocortex/SKILL.md"],ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"agents-md",budget:{maxLines:220,maxBytes:18e3},linkRequirement:a,bidirectionalReference:t(a),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:["AGENTS.md",".kimi/skills/neocortex/SKILL.md"],ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"agents-md",budget:{maxLines:220,maxBytes:18e3},linkRequirement:a,bidirectionalReference:t(a),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:["AGENTS.md"],ownedBlockName:"NEOCORTEX-MEMORY",templateKind:"copilot-instructions",budget:{maxLines:180,maxBytes:14e3},linkRequirement:a,bidirectionalReference:t(a),requiresWrapperPreservation:!0,notes:"GitHub Copilot CLI or gh alias instructions. Resolve compact memory back to NEOCORTEX.md without copying private prompt bodies."}};function d(o){return s[o]}function p(o){return o==="canonical"||l.includes(o)}function u(){return l.map(o=>s[o])}function y(o){const n=i=>i.replace(/\|/g,"\\|").replace(/\n/g," ");return["| Path | Title | Purpose | Suggested Usage |","| --- | --- | --- | --- |",...o.map(i=>`| ${n(i.path)} | ${n(i.title)} | ${n(i.purpose)} | ${n(i.suggestedUsage)} |`)].join(`
+`)}export{e as CANONICAL_PROJECT_MEMORY_SOURCE,s as PROJECT_MEMORY_TARGETS,l as PROJECT_MEMORY_TARGET_IDS,d as getProjectMemoryTarget,p as isProjectMemoryTargetId,u as listProjectMemoryTargets,y as renderArchitectureReferenceTable};

package/packages/client/dist/policy/architecture-policy.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @license FSL-1.1
+ * Copyright (c) 2026 OrNexus AI
+ *
+ * This file is part of Neocortex CLI, licensed under the
+ * Functional Source License, Version 1.1 (FSL-1.1).
+ *
+ * Change Date: February 20, 2029
+ * Change License: MIT
+ *
+ * See the LICENSE file in the project root for full license text.
+ */
+import type { ArchitecturePolicy, ArchitecturePolicyValidationResult } from './shared-policy-types.js';
+/**
+ * Relative path from project root to consumer policy file.
+ * Consumer copies `architecture-policy.template.json` (from repo root) to
+ * this path and edits.
+ */
+export declare const POLICY_FILE_PATH = ".neocortex/architecture-policy.json";
+/**
+ * Pure function validator. Zero I/O. Deterministic.
+ *
+ * Returns `ArchitecturePolicyValidationResult` with:
+ * - `valid: true` iff all required fields correct and no hard errors
+ * - `errors`: hard failures (schema version mismatch, bad mode, type errors)
+ * - `warnings`: soft issues (unknown optional fields -- forward-compat)
+ */
+export declare function validatePolicy(candidate: unknown): ArchitecturePolicyValidationResult;
+/**
+ * Async reader. NEVER throws.
+ *
+ * Returns `undefined` when:
+ * - file does not exist (ENOENT; silent, expected default)
+ * - permission denied (EACCES; warns stderr)
+ * - malformed JSON (warns stderr with path)
+ * - schema invalid (warns stderr with error list)
+ *
+ * Returns typed `ArchitecturePolicy` on full success.
+ */
+export declare function readArchitecturePolicy(projectRoot: string): Promise<ArchitecturePolicy | undefined>;

package/packages/client/dist/policy/architecture-policy.js

@@ -0,0 +1,2 @@
+import{readFile as u}from"node:fs/promises";import{join as d}from"node:path";const p=".neocortex/architecture-policy.json",f=Object.freeze(["interactive","yoloop_friendly","fully_automated"]),y=Object.freeze(["aws","gcp","oci","azure","any"]),_=Object.freeze(["REST","GraphQL","tRPC"]),g=Object.freeze(["sync","async","hybrid"]),m=Object.freeze(["mobile-first","desktop-first","responsive"]),O=Object.freeze(["conservative","balanced","aggressive"]),b=Object.freeze(["TDD","test-after","BDD"]),h=new Set(["primary_persona","cloud_provider","api_style","integration_style","ui_priority","refactor_aggressiveness","test_workflow"]);function v(n){const r=[],o=[];if(typeof n!="object"||n===null||Array.isArray(n))return{valid:!1,errors:Object.freeze(["Policy must be a plain object"]),warnings:Object.freeze([])};const t=n;if(t.schema_version!==1&&r.push(`schema_version must be 1, got ${JSON.stringify(t.schema_version)}`),(typeof t.mode!="string"||!f.includes(t.mode))&&r.push(`mode must be one of [${f.join(", ")}], got ${JSON.stringify(t.mode)}`),t.defaults!==void 0&&t.defaults!==null)if(typeof t.defaults!="object"||Array.isArray(t.defaults))r.push("defaults must be an object");else{const e=t.defaults;for(const c of Object.keys(e))h.has(c)||o.push(`defaults.${c}: unknown field (ignored)`);e.primary_persona!==void 0&&e.primary_persona!==null&&typeof e.primary_persona!="string"&&r.push("defaults.primary_persona must be string or null"),i(e,"cloud_provider",y,r),i(e,"api_style",_,r),i(e,"integration_style",g,r),i(e,"ui_priority",m,r),i(e,"refactor_aggressiveness",O,r),i(e,"test_workflow",b,r)}return t.preserved_interactions!==void 0&&t.preserved_interactions!==null&&(!Array.isArray(t.preserved_interactions)||!t.preserved_interactions.every(e=>typeof e=="string"))&&r.push("preserved_interactions must be array of strings"),{valid:r.length===0,errors:Object.freeze(r),warnings:Object.freeze(o)}}async function A(n){const r=d(n,p);let o;try{o=await u(r,"utf8")}catch(s){if(s.code==="ENOENT")return;const l=s.message??String(s);console.warn(`[Neocortex] architecture-policy read failed (${r}): ${l}`);return}const t=o.replace(/^/,"").replace(/\r\n/g,`
+`);let e;try{e=JSON.parse(t)}catch(s){const a=s.message??String(s);console.warn(`[Neocortex] architecture-policy malformed JSON (${r}): ${a}. Proceeding without policy.`);return}const c=v(e);if(!c.valid){console.warn(`[Neocortex] architecture-policy schema invalid (${r}): ${c.errors.join("; ")}. Proceeding without policy.`);return}return e}function i(n,r,o,t){const e=n[r];e!=null&&(typeof e!="string"||!o.includes(e))&&t.push(`defaults.${r} must be one of [${o.join(", ")}] or null, got ${JSON.stringify(e)}`)}export{p as POLICY_FILE_PATH,A as readArchitecturePolicy,v as validatePolicy};

package/packages/client/dist/policy/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license FSL-1.1
+ * Copyright (c) 2026 OrNexus AI
+ *
+ * Barrel export for Epic P107.02 policy reader module.
+ */
+export { readArchitecturePolicy, validatePolicy, POLICY_FILE_PATH, } from './architecture-policy.js';
+export type { ArchitecturePolicy, ArchitectureDefaults, ArchitecturePolicyValidationResult, PolicyMode, } from './shared-policy-types.js';

package/packages/client/dist/policy/index.js

@@ -0,0 +1 @@
+import{readArchitecturePolicy as c,validatePolicy as i,POLICY_FILE_PATH as o}from"./architecture-policy.js";export{o as POLICY_FILE_PATH,c as readArchitecturePolicy,i as validatePolicy};

package/packages/client/dist/policy/shared-policy-types.d.ts

@@ -0,0 +1,89 @@
+/**
+ * P119.02: Inlined byte-identical types from
+ * `@neocortex/shared/types/architecture-policy`.
+ *
+ * SSoT-Shadow pattern (P92.01 server precedent extended by P117.01 to client
+ * checkpoint dist + P117.07 to client yoloop dist). Client tarball is published
+ * standalone via `@ornexus/neocortex` and does NOT include `@neocortex/shared`
+ * as a runtime dependency (workspace package, excluded from tarball per
+ * `.npmignore` + `tsconfig.build.json`). Any non-erased import of
+ * `@neocortex/shared` in `packages/client/dist/**` causes runtime
+ * `ERR_MODULE_NOT_FOUND` on globally installed `@ornexus/neocortex`.
+ *
+ * Pre-P119.02, three files leaked `import type` statements from
+ * `@neocortex/shared` in the published v4.19.1 tarball:
+ *   - dist/policy/architecture-policy.d.ts
+ *   - dist/policy/index.d.ts
+ *   - dist/commands/invoke.d.ts (imported `YoloopPersistedState`)
+ *
+ * Type-only `import type` is erased at runtime (no module resolution attempt),
+ * but produces TS2307 in consumer projects that try to use the types via
+ * globally-installed CLI (`npm install -g @ornexus/neocortex`).
+ *
+ * Sync responsibility: `policy-shared-sync.test.ts` (client-side drift test,
+ * mirror of `checkpoint-shared-sync.test.ts` P117.01). Drift test fails CI
+ * if these diverge from SSoT canonical at
+ * `packages/shared/src/types/architecture-policy.ts`.
+ *
+ * Defense-in-depth: `validate-pre-publish.js` ships
+ * `validateClientNoSharedImport()` (P117.01) scanning client dist for
+ * `@neocortex/shared` runtime references. P119.02 expands its scope to also
+ * walk `dist/policy/` and `dist/commands/` (in addition to checkpoint + yoloop
+ * coverage from P117).
+ *
+ * DO NOT EDIT WITHOUT also editing
+ * `packages/shared/src/types/architecture-policy.ts`.
+ */
+/**
+ * Policy mode controls how server-side injector treats consumer defaults.
+ *
+ * - `interactive`: Ask user on every decision (pre-P107 behavior, backward compat).
+ * - `yoloop_friendly`: Apply `defaults.*` when set + log audit entry (P107.05).
+ * - `fully_automated`: Apply `defaults.*` silently; still preserves `preserved_interactions`.
+ */
+export type PolicyMode = 'interactive' | 'yoloop_friendly' | 'fully_automated';
+/**
+ * Optional default values that drive step prompt behavior.
+ * All fields are optional -- unset fields fall back to interactive questions.
+ * Each field maps to a specific stepId via `POLICY_FIELD_BY_STEP` (server-side).
+ */
+export interface ArchitectureDefaults {
+    /** For step-a-01 PRD generation. Free-form string (e.g. "B2B SaaS buyer"). */
+    readonly primary_persona?: string;
+    /** For step-a-02 architecture choices. */
+    readonly cloud_provider?: 'aws' | 'gcp' | 'oci' | 'azure' | 'any';
+    /** For step-a-03 api-contracts. */
+    readonly api_style?: 'REST' | 'GraphQL' | 'tRPC';
+    /** For step-a-04 api-integrations. */
+    readonly integration_style?: 'sync' | 'async' | 'hybrid';
+    /** For step-a-08 ux-design. */
+    readonly ui_priority?: 'mobile-first' | 'desktop-first' | 'responsive';
+    /** For step-r-03 refactor-plan. */
+    readonly refactor_aggressiveness?: 'conservative' | 'balanced' | 'aggressive';
+    /** For step-c-04 write-spec. */
+    readonly test_workflow?: 'TDD' | 'test-after' | 'BDD';
+}
+/**
+ * Top-level policy shape persisted in `.neocortex/architecture-policy.json`.
+ * Consumer copies `architecture-policy.template.json` from repo root and edits.
+ */
+export interface ArchitecturePolicy {
+    /** Wire-format version. Must be literal 1 in v1. */
+    readonly schema_version: 1;
+    readonly mode: PolicyMode;
+    readonly defaults?: ArchitectureDefaults;
+    /**
+     * stepIds that ALWAYS require human interaction, regardless of mode.
+     * Defaults to `ARCHITECTURE_POLICY_DEFAULT_PRESERVED` if absent.
+     */
+    readonly preserved_interactions?: readonly string[];
+}
+/**
+ * Output of `validateArchitecturePolicy()` (server-side P107.03 exports validator).
+ * Fail-soft shape: validation errors NEVER throw; caller decides action.
+ */
+export interface ArchitecturePolicyValidationResult {
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+    readonly warnings: readonly string[];
+}

package/packages/client/dist/resilience/circuit-breaker.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @license FSL-1.1
+ * Copyright (c) 2026 OrNexus AI
+ *
+ * This file is part of Neocortex CLI, licensed under the
+ * Functional Source License, Version 1.1 (FSL-1.1).
+ *
+ * Change Date: February 20, 2029
+ * Change License: MIT
+ *
+ * See the LICENSE file in the project root for full license text.
+ */
+export type CircuitState = 'CLOSED' | 'OPEN' | 'HALF_OPEN';
+export interface CircuitBreakerConfig {
+    /** Number of failures within window to trip circuit. Default: 3 */
+    failureThreshold: number;
+    /** Window in ms for counting failures. Default: 60_000 (60s) */
+    failureWindowMs: number;
+    /** Time in ms before OPEN transitions to HALF_OPEN. Default: 60_000 (60s) */
+    halfOpenAfterMs: number;
+    /** Path to persist circuit state. Default: ~/.neocortex/.circuit-state */
+    stateFilePath: string;
+}
+export interface FailureRecord {
+    timestamp: number;
+}
+export interface CircuitBreakerState {
+    state: CircuitState;
+    failures: FailureRecord[];
+    openedAt: number | null;
+    lastProbeAt: number | null;
+}
+export declare class ClientCircuitBreaker {
+    private readonly config;
+    private internalState;
+    constructor(config?: Partial<CircuitBreakerConfig>, initialState?: CircuitBreakerState);
+    /**
+     * Check if a request can be made to the server.
+     * Returns false if circuit is OPEN (fail-fast to cache).
+     */
+    canCall(): boolean;
+    /**
+     * Record a successful server response. Closes the circuit.
+     */
+    recordSuccess(): Promise<void>;
+    /**
+     * Record a failed server response. Opens circuit after threshold failures in window.
+     */
+    recordFailure(): Promise<void>;
+    /**
+     * Get current circuit breaker state (copy).
+     */
+    getState(): CircuitBreakerState;
+    /**
+     * Reset circuit breaker to initial CLOSED state.
+     */
+    reset(): Promise<void>;
+    /**
+     * Load circuit breaker state from disk.
+     */
+    static loadFromDisk(path?: string): Promise<ClientCircuitBreaker>;
+    /**
+     * Remove failures outside the counting window.
+     */
+    private pruneExpiredFailures;
+    /**
+     * Persist state to disk with atomic write.
+     */
+    private saveToDisk;
+}

package/packages/client/dist/resilience/circuit-breaker.js

@@ -0,0 +1 @@
+import{readFile as l,writeFile as o,mkdir as h}from"node:fs/promises";import{dirname as u}from"node:path";import{homedir as c}from"node:os";import{join as f}from"node:path";const n={failureThreshold:3,failureWindowMs:6e4,halfOpenAfterMs:6e4,stateFilePath:f(c(),".neocortex",".circuit-state")},r={state:"CLOSED",failures:[],openedAt:null,lastProbeAt:null};class i{config;internalState;constructor(t,e){this.config={...n,...t},this.internalState=e?{...e}:{...r,failures:[]}}canCall(){switch(this.pruneExpiredFailures(),this.internalState.state){case"CLOSED":return!0;case"OPEN":{const t=Date.now(),e=this.internalState.openedAt??0;return t-e>=this.config.halfOpenAfterMs?(this.internalState.state="HALF_OPEN",this.internalState.lastProbeAt=t,!0):!1}case"HALF_OPEN":return!0;default:return!0}}async recordSuccess(){this.internalState.state="CLOSED",this.internalState.failures=[],this.internalState.openedAt=null,this.internalState.lastProbeAt=null,await this.saveToDisk()}async recordFailure(){const t=Date.now();this.internalState.failures.push({timestamp:t}),this.pruneExpiredFailures(),this.internalState.failures.length>=this.config.failureThreshold&&(this.internalState.state="OPEN",this.internalState.openedAt=t),this.internalState.state==="HALF_OPEN"&&(this.internalState.state="OPEN",this.internalState.openedAt=t),await this.saveToDisk()}getState(){return this.pruneExpiredFailures(),{state:this.internalState.state,failures:[...this.internalState.failures],openedAt:this.internalState.openedAt,lastProbeAt:this.internalState.lastProbeAt}}async reset(){this.internalState={...r,failures:[]},await this.saveToDisk()}static async loadFromDisk(t){const e=t??n.stateFilePath;try{const s=await l(e,"utf8"),a=JSON.parse(s);return!a.state||!Array.isArray(a.failures)?new i({stateFilePath:e}):new i({stateFilePath:e},a)}catch{return new i({stateFilePath:e})}}pruneExpiredFailures(){const t=Date.now()-this.config.failureWindowMs;this.internalState.failures=this.internalState.failures.filter(e=>e.timestamp>t)}async saveToDisk(){try{const t=u(this.config.stateFilePath);await h(t,{recursive:!0});const e=`${this.config.stateFilePath}.tmp`,s=JSON.stringify(this.internalState,null,2);await o(e,s,"utf8");const{rename:a}=await import("node:fs/promises");await a(e,this.config.stateFilePath)}catch{}}}export{i as ClientCircuitBreaker};