@ornexus/neocortex 4.60.18 → 4.60.19

package/packages/client/dist/effects/invoke-effect-gateways.d.ts

@@ -0,0 +1,22 @@
+import type { InvokeEffectContext } from '../../../shared/dist/strict-readonly.js';
+import type { CacheProvider } from '../types/index.js';
+import { resolveClosedProcessProfile } from '../../../shared/dist/strict-readonly.js';
+export interface ClosedProcessResult {
+    readonly status: number | null;
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly projected: boolean;
+}
+export type ClosedProcessWriter = (profile: ReturnType<typeof resolveClosedProcessProfile>) => ClosedProcessResult;
+export declare function createCapabilityCache(authority: InvokeEffectContext, delegate: CacheProvider, category: 'auth-cache' | 'tier-cache'): CacheProvider;
+export declare function executeClosedProcess(authority: InvokeEffectContext, profileName: 'node-version', cwd: string, writer: ClosedProcessWriter, phase?: 'client-preflight' | 'engine'): ClosedProcessResult;
+export declare function executeClosedGitInspection(authority: InvokeEffectContext, profileName: 'git-status' | 'git-rev-parse', cwd: string, writer: ClosedProcessWriter, phase?: 'client-preflight' | 'engine'): ClosedProcessResult;
+export declare function executeSchedulerManifestWrite(authority: InvokeEffectContext, writer: () => void): boolean;
+export declare function executeSchedulerProcess<T>(authority: InvokeEffectContext, command: {
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly safeUserScope: true;
+}, writer: () => T, projected: () => T): T;
+/** The primary invoke request is a declared query transport, not a mutation. */
+export declare function executeInvokeQueryTransport<T>(transportKind: string, writer: () => Promise<T>): Promise<T>;
+export declare function executeSecondaryNetworkMutation<T>(authority: InvokeEffectContext, transportKind: 'secondary-mutation', writer: () => Promise<T>, projected: () => Promise<T>): Promise<T>;

package/packages/client/dist/effects/invoke-effect-gateways.js

@@ -0,0 +1 @@
+import{assertDeclaredNetworkTransport as i,resolveClosedProcessProfile as a,StrictReadOnlyError as c}from"../../../shared/dist/strict-readonly.js";function d(t,e,r){const o={phase:"client-preflight",domain:"client-persistence",category:r,operation:"update"};return Object.freeze({get:n=>e.get(n),set:(n,s,u)=>t.executeAsync(o,()=>e.set(n,s,u),async()=>{}),clear:()=>t.executeAsync(o,()=>e.clear(),async()=>{})})}function f(t,e,r,o,n="engine"){const s=a(e,r);return t.execute({phase:n,domain:"external-effect",category:"process",operation:"spawn"},()=>o(s),()=>({status:null,stdout:"",stderr:"",projected:!0}))}function h(t,e,r,o,n="engine"){const s=a(e,r);return t.execute({phase:n,domain:"external-effect",category:"git",operation:"spawn"},()=>o(s),()=>({status:null,stdout:"",stderr:"",projected:!0}))}function g(t,e){return t.execute({phase:"client-preflight",domain:"client-persistence",category:"scheduler-session",operation:"create"},()=>(e(),!0),()=>!1)}function y(t,e,r,o){if(!l(e))throw new c("readonly-physical-boundary-unsafe","boundary");return t.execute({phase:"client-preflight",domain:"external-effect",category:"process",operation:"spawn"},r,o)}function l(t){if(t.args.length>8||t.args.some(n=>n.length>512||/[\r\n\0]/u.test(n)))return!1;const e=t.args,r=n=>!!(n&&/^[A-Za-z0-9_.:@-]{1,180}$/u.test(n)),o=n=>!!(n&&(n.startsWith("/")||/^[A-Za-z]:[\\/]/u.test(n))&&!n.split(/[\\/]/u).includes(".."));return t.command==="systemctl"?e[0]==="--user"&&(e.length===2&&e[1]==="daemon-reload"||e.length===4&&e[1]==="enable"&&e[2]==="--now"&&r(e[3])||e.length===3&&(e[1]==="start"||e[1]==="stop")&&r(e[2])||e.length===4&&e[1]==="status"&&r(e[2])&&e[3]==="--no-pager"):t.command==="launchctl"?e.length===3&&(e[0]==="load"||e[0]==="unload")&&e[1]==="-w"&&o(e[2])||e.length===2&&e[0]==="list"&&r(e[1]):t.command==="schtasks"?e.length===6&&e[0]==="/Create"&&e[1]==="/TN"&&r(e[2])&&e[3]==="/XML"&&o(e[4])&&e[5]==="/F"||e.length===3&&(e[0]==="/Run"||e[0]==="/End")&&e[1]==="/TN"&&r(e[2])||e.length===5&&e[0]==="/Query"&&e[1]==="/TN"&&r(e[2])&&e[3]==="/FO"&&e[4]==="LIST":t.command==="crontab"&&e.length===1&&e[0]==="-l"}async function x(t,e){return i(t),e()}async function m(t,e,r,o){if(e!=="secondary-mutation")throw new c("readonly-physical-boundary-unsafe","boundary");return t.executeAsync({phase:"client-preflight",domain:"external-effect",category:"network-mutation",operation:"send"},r,o)}export{d as createCapabilityCache,h as executeClosedGitInspection,f as executeClosedProcess,x as executeInvokeQueryTransport,g as executeSchedulerManifestWrite,y as executeSchedulerProcess,m as executeSecondaryNetworkMutation};

package/packages/client/dist/errors/frontmatter-diagnostics.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Public-safe diagnostics for the P204 frontmatter boundary.
+ *
+ * Diagnostic construction intentionally accepts a reason code only. Rejected
+ * source text, wrapper bodies, argv and filesystem paths are never inputs, so
+ * callers cannot accidentally reflect private content into logs.
+ */
+export declare const FRONTMATTER_DIAGNOSTIC_CATEGORIES: readonly ["payload-selection", "target-normalization", "metadata-frontmatter"];
+export type FrontmatterDiagnosticCategory = (typeof FRONTMATTER_DIAGNOSTIC_CATEGORIES)[number];
+export declare const FRONTMATTER_DIAGNOSTIC_REASON_CODES: readonly ["payload-selection-ambiguous", "payload-selection-unavailable", "markdown-link-target-malformed", "markdown-link-target-ambiguous", "markdown-link-target-external", "markdown-link-target-unsafe-path", "raw-target-malformed", "raw-target-external", "raw-target-unsafe-path", "frontmatter-malformed", "frontmatter-oversized", "frontmatter-unsupported-value", "frontmatter-explicit-selection-required"];
+export type FrontmatterDiagnosticReasonCode = (typeof FRONTMATTER_DIAGNOSTIC_REASON_CODES)[number];
+export interface PublicFrontmatterDiagnostic {
+    readonly category: FrontmatterDiagnosticCategory;
+    readonly reasonCode: FrontmatterDiagnosticReasonCode | 'frontmatter-diagnostic-unclassified';
+    readonly summary: string;
+    readonly remediation: string;
+    readonly example?: string;
+}
+export declare function getFrontmatterDiagnostic(reasonCode: string): PublicFrontmatterDiagnostic;
+export declare function formatFrontmatterDiagnostic(reasonCode: string): string;

package/packages/client/dist/errors/frontmatter-diagnostics.js

@@ -0,0 +1 @@
+const l=["payload-selection","target-normalization","metadata-frontmatter"],d=["payload-selection-ambiguous","payload-selection-unavailable","markdown-link-target-malformed","markdown-link-target-ambiguous","markdown-link-target-external","markdown-link-target-unsafe-path","raw-target-malformed","raw-target-external","raw-target-unsafe-path","frontmatter-malformed","frontmatter-oversized","frontmatter-unsupported-value","frontmatter-explicit-selection-required"],t="*yoloop @docs/epics/epic-P204.md",a="docs/epics/epic-P204.md",n=Object.freeze({"payload-selection-ambiguous":Object.freeze({category:"payload-selection",summary:"The explicit Neocortex command could not be selected unambiguously.",remediation:"Pass exactly one explicit trigger and its project-local arguments; keep host wrapper metadata outside the selected payload."}),"payload-selection-unavailable":Object.freeze({category:"payload-selection",summary:"The explicit Neocortex command could not be selected safely.",remediation:"Retry with one explicit trigger. Do not include wrapper frontmatter, conversation history or delegated prompt text."}),"markdown-link-target-malformed":Object.freeze({category:"target-normalization",summary:"The Markdown target is malformed or is not a supported Markdown path.",remediation:"Use one complete Markdown link to a project-relative .md file or a trailing-slash directory.",example:t}),"markdown-link-target-ambiguous":Object.freeze({category:"target-normalization",summary:"More than one target or mixed target syntax was supplied.",remediation:"Pass exactly one raw path or one Markdown link target.",example:t}),"markdown-link-target-external":Object.freeze({category:"target-normalization",summary:"External Markdown targets are not supported.",remediation:"Reference a file already inside the project with a project-relative path.",example:t}),"markdown-link-target-unsafe-path":Object.freeze({category:"target-normalization",summary:"The Markdown target is outside the supported project-relative path boundary.",remediation:"Remove absolute, home, drive, backslash or traversal segments and use a project-relative path.",example:t}),"raw-target-malformed":Object.freeze({category:"target-normalization",summary:"The raw target is not a supported Markdown path.",remediation:"Use one project-relative .md file or a trailing-slash directory.",example:t}),"raw-target-external":Object.freeze({category:"target-normalization",summary:"External raw targets are not supported.",remediation:"Reference a file already inside the project with a project-relative path.",example:t}),"raw-target-unsafe-path":Object.freeze({category:"target-normalization",summary:"The raw target is outside the supported project-relative path boundary.",remediation:"Remove absolute, home, drive, backslash or traversal segments and use a project-relative path.",example:t}),"frontmatter-malformed":Object.freeze({category:"metadata-frontmatter",summary:"The leading YAML frontmatter envelope is malformed.",remediation:"Repair the bounded leading --- envelope and keep generated metadata fields scalar or string-list values.",example:a}),"frontmatter-oversized":Object.freeze({category:"metadata-frontmatter",summary:"The leading YAML frontmatter exceeds the public parsing limits.",remediation:"Reduce the metadata header and keep descriptive content in the Markdown body.",example:a}),"frontmatter-unsupported-value":Object.freeze({category:"metadata-frontmatter",summary:"A frontmatter field uses an unsupported value shape.",remediation:"Use allowlisted scalar fields and bounded string lists only.",example:a}),"frontmatter-explicit-selection-required":Object.freeze({category:"metadata-frontmatter",summary:"Target metadata cannot be projected before explicit file selection.",remediation:"Select one project-relative epic or story target before metadata discovery.",example:a})}),i=Object.freeze({category:"metadata-frontmatter",reasonCode:"frontmatter-diagnostic-unclassified",summary:"The frontmatter operation could not be classified safely.",remediation:"Retry with one explicit project-relative target and a bounded YAML header.",example:a});function m(r){const e=n[r];return e?Object.freeze({reasonCode:r,...e}):i}function s(r){const e=m(r),o=e.example?` Example: ${e.example}.`:"";return`${e.reasonCode} [${e.category}]: ${e.summary} Remediation: ${e.remediation}${o}`}export{l as FRONTMATTER_DIAGNOSTIC_CATEGORIES,d as FRONTMATTER_DIAGNOSTIC_REASON_CODES,s as formatFrontmatterDiagnostic,m as getFrontmatterDiagnostic};