@ornexus/neocortex 4.60.71 → 4.60.73

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

@@ -27,7 +27,48 @@ export type YoloopSessionMode = 'directory' | 'epic-file' | 'epic-id';
 export type YoloopLockOwnerKind = 'client' | 'server';
 export type YoloopLockOwnerPidState = 'live' | 'stale' | 'unknown';
 export type YoloopLockLeaseState = 'active' | 'expired' | 'unknown';
-export type YoloopPersistenceCapability = 'rollover-session-v1' | 'successor-transition-v1' | 'continuation-replan-v1';
+export type YoloopPersistenceCapability = 'rollover-session-v1' | 'successor-transition-v1' | 'continuation-replan-v1' | 'cross-epic-continuation-reconcile-v1';
+export interface YoloopCrossEpicReconciliationEvidenceV1 {
+    readonly schemaVersion: 'YoloopCrossEpicReconciliationEvidence/1.0';
+    readonly repositoryFingerprint: string;
+    readonly identityHash: string;
+    readonly sourceEpicId: string;
+    readonly sourceGraphRevision: string;
+    readonly targetEpicId: string;
+    readonly targetGraphRevision: string;
+    readonly storeRevision: number;
+    readonly writerEpoch: number;
+    readonly runId: string;
+    readonly runStatus: 'success' | 'exhausted';
+    readonly runRevision: number;
+    readonly snapshotHash: string | null;
+    readonly continuationSessionHash: string;
+    readonly pendingAuthorityHash: string;
+    readonly pendingAuthorityCount: 0 | 1;
+    readonly lockActive: false;
+    readonly currentSessionActive: false;
+    readonly journalActive: false;
+    readonly decision: 'eligible';
+    readonly reasonCodes: readonly string[];
+    readonly publicSafe: true;
+}
+export interface YoloopCrossEpicReconciliationReceiptV1 {
+    readonly schemaVersion: 'YoloopCrossEpicReconciliationReceipt/1.0';
+    readonly operationId: string;
+    readonly idempotencyKey: string;
+    readonly payloadHash: string;
+    readonly sourceEpicId: string;
+    readonly sourceGraphRevision: string;
+    readonly targetEpicId: string;
+    readonly targetGraphRevision: string;
+    readonly runId: string;
+    readonly previousSessionHash: string;
+    readonly nextSessionHash: string;
+    readonly retiredAuthorityHash: string;
+    readonly retiredAuthorityCount: 0 | 1;
+    readonly outcome: 'cross-epic-reconciled';
+    readonly publicSafe: true;
+}
 /** Lock file payload. Mirrors server-internal `LockMetadata` (v1.1 schema). */
 export interface YoloopPersistedLock {
     readonly pid: number;
@@ -350,6 +391,29 @@ export type YoloopStateOperation = {
     readonly nextSession: Readonly<Record<string, unknown>>;
     readonly payloadHash: string;
     readonly receipt: Readonly<Record<string, unknown>>;
+} | {
+    readonly type: 'reconcile_cross_epic_continuation';
+    readonly operationId: string;
+    readonly idempotencyKey: string;
+    readonly expectedCommonRevision: number;
+    readonly expectedWriterEpoch: number;
+    readonly expectedIdentityHash: string;
+    readonly sourceEpicId: string;
+    readonly sourceGraphRevision: string;
+    readonly targetEpicId: string;
+    readonly targetGraphRevision: string;
+    readonly expectedRunId: string;
+    readonly expectedRunStatus: 'success' | 'exhausted';
+    readonly expectedRunRevision: number;
+    readonly expectedSnapshotHash: string | null;
+    readonly sourceSessionId: string;
+    readonly expectedSessionHash: string;
+    readonly expectedPendingHash: string;
+    readonly expectedPendingCount: 0 | 1;
+    readonly nextSession: Readonly<Record<string, unknown>>;
+    readonly nextSessionHash: string;
+    readonly payloadHash: string;
+    readonly receipt: YoloopCrossEpicReconciliationReceiptV1;
 } | {
     readonly type: 'recovery_attempted';
     readonly attempt: YoloopRecoveryAttemptRef;

package/packages/client/dist/yoloop/shared-yoloop-types.js

@@ -1 +1,33 @@
-const R=50;export{R as RECOVERY_HISTORY_CAP};
+/**
+ * P117.07: Inlined byte-identical types from `@neocortex/shared/types/yoloop-persistence`
+ *          + `@neocortex/shared/yoloop/recovery-types` (RECOVERY_HISTORY_CAP).
+ *
+ * Same regression class as P117.01 (checkpoint inline). Mirrors P92.01 server
+ * SSoT-Shadow precedent — server `shared-types.ts` does the same for tier-config.
+ *
+ * Live regression: 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/yoloop/**`
+ * causes runtime `ERR_MODULE_NOT_FOUND` on globally installed `@ornexus/neocortex`,
+ * silently disabling P101.06/P101.07 yoloop client state persistence (warning on
+ * every CLI invocation, fail-soft per design but feature effectively off).
+ *
+ * Sync responsibility: `yoloop-shared-sync.test.ts` (client-side drift test) +
+ * `shared-types-sync.test.ts` (server-side cross-package sanity, P92.03 baseline).
+ *
+ * Defense-in-depth: `validate-pre-publish.js` ships `validateClientNoSharedImport()`
+ * (P117.01 expanded by P117.07 to cover yoloop dist) — match = exit 1 (publish blocked).
+ *
+ * DO NOT EDIT WITHOUT also editing `packages/shared/src/types/yoloop-persistence.ts`
+ * + `packages/shared/src/yoloop/recovery-types.ts`.
+ */
+// === P117.07: byte-identical from @neocortex/shared/yoloop/recovery-types ===
+/**
+ * P104.06 -- FIFO cap for `state.recovery_history[]` in
+ * `.neocortex/yoloop-state.json`. When the array exceeds this size, the
+ * client drops oldest entries. Bound is heuristic: ~50 attempts × ~300
+ * bytes/entry = ~15 KB worst case in state.json (negligible).
+ */
+export const RECOVERY_HISTORY_CAP = 50;
+// === END P117.07 ===

package/packages/client/dist/yoloop/target-normalization.js

@@ -1 +1,180 @@
-import{existsSync as h}from"node:fs";import{resolve as p}from"node:path";import{formatFrontmatterDiagnostic as A}from"../errors/frontmatter-diagnostics.js";const O=/^\*?(yoloop|auto-yolo|epic-runner|story-runner|loop-yolo|auto-epic)\b/i,T=/^@neocortex\b\s*/i,_=/\[[^\]\r\n]*\]\(([^)\r\n]+)\)/g,E=/^[A-Za-z0-9._-]+(?:\/[A-Za-z0-9._-]+)*\/?$/,R=/^epic-[A-Za-z0-9._-]+\.md$/i;function g(t){if(typeof t!="string")return null;let e=t.trimStart(),n=!1;const r=e.match(T);r&&(e=e.slice(r[0].length).trimStart(),n=!0);const o=e.match(O);return o?Object.freeze({triggerToken:o[0],remainder:e.slice(o[0].length).trim(),agentSelectorRemoved:n}):null}function v(t){return g(t)!==null}function u(t){return Object.freeze({ok:!1,errorCode:"INVALID_YOLOOP_TARGET",reasonCode:t,message:`INVALID_YOLOOP_TARGET: ${A(t)}`})}function k(t){let e=t.trim().replace(/^@/,"").replace(/^\.\//,"");if(/^[A-Za-z][A-Za-z0-9+.-]*:/.test(e)||e.startsWith("//"))return{ok:!1,failure:"external"};if(e.startsWith("/")||e.startsWith("~")||/^[A-Za-z]:[\\/]/.test(e)||e.includes("\\")||e.includes("\0"))return{ok:!1,failure:"unsafe-path"};const n=e.split("/").filter(Boolean);return!e||!E.test(e)||n.some(r=>r==="."||r==="..")?{ok:!1,failure:"unsafe-path"}:!e.endsWith("/")&&!e.toLowerCase().endsWith(".md")?{ok:!1,failure:"malformed"}:(e=e.replace(/^\.\//,""),{ok:!0,target:e})}function $(t){return`markdown-link-target-${t}`}function b(t){return`raw-target-${t}`}function w(t,e){return t.startsWith("@")||e.includes("/")||e.includes("\\")||e.startsWith(".")||e.startsWith("~")||e.toLowerCase().endsWith(".md")||/^[A-Za-z][A-Za-z0-9+.-]*:/.test(e)}function z(t,e){if(!e||!R.test(t)||h(p(e,t)))return t;const n=`docs/epics/${t}`;return h(p(e,n))?n:t}function f(t){return Object.freeze([...t])}function W(t,e={}){const n=g(t);if(!n)return Object.freeze({ok:!0,args:typeof t=="string"?t:"",changed:!1,reasonCodes:f(["yoloop-target-unchanged"])});const r=[];n.agentSelectorRemoved&&r.push("agent-selector-removed");const o=n.remainder;if(!o){const a=n.triggerToken;return Object.freeze({ok:!0,args:a,changed:a!==t,reasonCodes:f(r.length>0?r:["yoloop-target-unchanged"])})}const i=[...o.matchAll(_)],d=o.startsWith("[")||o.includes("](");if(i.length>1)return u("markdown-link-target-ambiguous");if(d&&i.length===0)return u("markdown-link-target-malformed");if(i.length===1){const a=i[0];if(a[0]!==o)return u("markdown-link-target-ambiguous");const s=k(a[1]);if(!s.ok)return u($(s.failure));const l=z(s.target,e.projectRoot);return r.push("markdown-link-target-normalized"),l!==s.target&&r.push("basename-target-canonicalized"),Object.freeze({ok:!0,args:`${n.triggerToken} @${l}`,changed:!0,reasonCodes:f(r)})}const c=o.match(/^@?([^\s]+)$/)?.[1];if(c){let a=c;if(w(o,c)){const l=k(c);if(!l.ok)return u(b(l.failure));a=l.target}const s=z(a,e.projectRoot);if(s!==c)return r.push("basename-target-canonicalized"),Object.freeze({ok:!0,args:`${n.triggerToken} @${s}`,changed:!0,reasonCodes:f(r)})}const m=`${n.triggerToken}${o?` ${o}`:""}`;return Object.freeze({ok:!0,args:m,changed:m!==t,reasonCodes:f(r.length>0?r:["yoloop-target-unchanged"])})}function P(t,e){const n=W(t,{projectRoot:e});if(!n.ok)return null;const r=g(n.args);if(!r?.remainder)return null;const o=r.remainder.match(/(?:^|\s)@([^\s]+)/);if(o)return o[1];const i=r.remainder.split(/\s+/).find(d=>d.length>0&&!d.startsWith("-"));return i?i.replace(/^(?:"|')|(?:"|')$/g,""):null}export{P as extractYoloopTargetPath,v as isYoloopInvocation,W as normalizeYoloopTargetArgs,g as parseYoloopInvocation};
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { formatFrontmatterDiagnostic } from '../errors/frontmatter-diagnostics.js';
+const YOLOOP_TRIGGER_RE = /^\*?(yoloop|auto-yolo|epic-runner|story-runner|loop-yolo|auto-epic)\b/i;
+const AGENT_SELECTOR_RE = /^@neocortex\b\s*/i;
+const MARKDOWN_LINK_RE = /\[[^\]\r\n]*\]\(([^)\r\n]+)\)/g;
+const SAFE_PROJECT_PATH_RE = /^[A-Za-z0-9._-]+(?:\/[A-Za-z0-9._-]+)*\/?$/;
+const EPIC_BASENAME_RE = /^epic-[A-Za-z0-9._-]+\.md$/i;
+export function parseYoloopInvocation(args) {
+    if (typeof args !== 'string')
+        return null;
+    let remaining = args.trimStart();
+    let agentSelectorRemoved = false;
+    const selector = remaining.match(AGENT_SELECTOR_RE);
+    if (selector) {
+        remaining = remaining.slice(selector[0].length).trimStart();
+        agentSelectorRemoved = true;
+    }
+    const trigger = remaining.match(YOLOOP_TRIGGER_RE);
+    if (!trigger)
+        return null;
+    return Object.freeze({
+        triggerToken: trigger[0],
+        remainder: remaining.slice(trigger[0].length).trim(),
+        agentSelectorRemoved,
+    });
+}
+export function isYoloopInvocation(args) {
+    return parseYoloopInvocation(args) !== null;
+}
+function failure(reasonCode) {
+    return Object.freeze({
+        ok: false,
+        errorCode: 'INVALID_YOLOOP_TARGET',
+        reasonCode,
+        message: `INVALID_YOLOOP_TARGET: ${formatFrontmatterDiagnostic(reasonCode)}`,
+    });
+}
+function validateProjectTarget(rawTarget) {
+    let target = rawTarget.trim().replace(/^@/, '').replace(/^\.\//, '');
+    if (/^[A-Za-z][A-Za-z0-9+.-]*:/.test(target) || target.startsWith('//')) {
+        return { ok: false, failure: 'external' };
+    }
+    if (target.startsWith('/') ||
+        target.startsWith('~') ||
+        /^[A-Za-z]:[\\/]/.test(target) ||
+        target.includes('\\') ||
+        target.includes('\0')) {
+        return { ok: false, failure: 'unsafe-path' };
+    }
+    const segments = target.split('/').filter(Boolean);
+    if (!target ||
+        !SAFE_PROJECT_PATH_RE.test(target) ||
+        segments.some((segment) => segment === '.' || segment === '..')) {
+        return { ok: false, failure: 'unsafe-path' };
+    }
+    if (!target.endsWith('/') && !target.toLowerCase().endsWith('.md')) {
+        return { ok: false, failure: 'malformed' };
+    }
+    target = target.replace(/^\.\//, '');
+    return { ok: true, target };
+}
+function markdownFailure(failureCode) {
+    return `markdown-link-target-${failureCode}`;
+}
+function rawFailure(failureCode) {
+    return `raw-target-${failureCode}`;
+}
+function isPathLikeRawTarget(remainder, target) {
+    return remainder.startsWith('@') ||
+        target.includes('/') ||
+        target.includes('\\') ||
+        target.startsWith('.') ||
+        target.startsWith('~') ||
+        target.toLowerCase().endsWith('.md') ||
+        /^[A-Za-z][A-Za-z0-9+.-]*:/.test(target);
+}
+function canonicalizeEpicBasename(target, projectRoot) {
+    if (!projectRoot || !EPIC_BASENAME_RE.test(target))
+        return target;
+    if (existsSync(resolve(projectRoot, target)))
+        return target;
+    const canonical = `docs/epics/${target}`;
+    return existsSync(resolve(projectRoot, canonical)) ? canonical : target;
+}
+function freezeReasonCodes(reasonCodes) {
+    return Object.freeze([...reasonCodes]);
+}
+export function normalizeYoloopTargetArgs(args, options = {}) {
+    const parsed = parseYoloopInvocation(args);
+    if (!parsed) {
+        return Object.freeze({
+            ok: true,
+            args: typeof args === 'string' ? args : '',
+            changed: false,
+            reasonCodes: freezeReasonCodes(['yoloop-target-unchanged']),
+        });
+    }
+    const reasons = [];
+    if (parsed.agentSelectorRemoved)
+        reasons.push('agent-selector-removed');
+    const remainder = parsed.remainder;
+    if (!remainder) {
+        const normalizedArgs = parsed.triggerToken;
+        return Object.freeze({
+            ok: true,
+            args: normalizedArgs,
+            changed: normalizedArgs !== args,
+            reasonCodes: freezeReasonCodes(reasons.length > 0 ? reasons : ['yoloop-target-unchanged']),
+        });
+    }
+    const links = [...remainder.matchAll(MARKDOWN_LINK_RE)];
+    const hasMarkdownLinkSyntax = remainder.startsWith('[') || remainder.includes('](');
+    if (links.length > 1)
+        return failure('markdown-link-target-ambiguous');
+    if (hasMarkdownLinkSyntax && links.length === 0)
+        return failure('markdown-link-target-malformed');
+    if (links.length === 1) {
+        const link = links[0];
+        if (link[0] !== remainder)
+            return failure('markdown-link-target-ambiguous');
+        const validation = validateProjectTarget(link[1]);
+        if (!validation.ok)
+            return failure(markdownFailure(validation.failure));
+        const target = canonicalizeEpicBasename(validation.target, options.projectRoot);
+        reasons.push('markdown-link-target-normalized');
+        if (target !== validation.target)
+            reasons.push('basename-target-canonicalized');
+        return Object.freeze({
+            ok: true,
+            args: `${parsed.triggerToken} @${target}`,
+            changed: true,
+            reasonCodes: freezeReasonCodes(reasons),
+        });
+    }
+    const rawTarget = remainder.match(/^@?([^\s]+)$/)?.[1];
+    if (rawTarget) {
+        let validatedTarget = rawTarget;
+        if (isPathLikeRawTarget(remainder, rawTarget)) {
+            const validation = validateProjectTarget(rawTarget);
+            if (!validation.ok)
+                return failure(rawFailure(validation.failure));
+            validatedTarget = validation.target;
+        }
+        const target = canonicalizeEpicBasename(validatedTarget, options.projectRoot);
+        if (target !== rawTarget) {
+            reasons.push('basename-target-canonicalized');
+            return Object.freeze({
+                ok: true,
+                args: `${parsed.triggerToken} @${target}`,
+                changed: true,
+                reasonCodes: freezeReasonCodes(reasons),
+            });
+        }
+    }
+    const normalizedArgs = `${parsed.triggerToken}${remainder ? ` ${remainder}` : ''}`;
+    return Object.freeze({
+        ok: true,
+        args: normalizedArgs,
+        changed: normalizedArgs !== args,
+        reasonCodes: freezeReasonCodes(reasons.length > 0 ? reasons : ['yoloop-target-unchanged']),
+    });
+}
+export function extractYoloopTargetPath(args, projectRoot) {
+    const normalized = normalizeYoloopTargetArgs(args, { projectRoot });
+    if (!normalized.ok)
+        return null;
+    const parsed = parseYoloopInvocation(normalized.args);
+    if (!parsed?.remainder)
+        return null;
+    const atPath = parsed.remainder.match(/(?:^|\s)@([^\s]+)/);
+    if (atPath)
+        return atPath[1];
+    const positional = parsed.remainder.split(/\s+/).find((token) => {
+        return token.length > 0 && !token.startsWith('-');
+    });
+    if (!positional)
+        return null;
+    return positional.replace(/^(?:"|')|(?:"|')$/g, '');
+}

package/packages/client/dist/yoloop/yoloop-client-state-store.d.ts

@@ -41,6 +41,7 @@ export declare function createDefaultCounters(nowIso: string): YoloopPersistedCo
 /** Build default state envelope (no lock, default counters). */
 export declare function createDefaultState(nowIso: string): YoloopPersistedState;
 export declare class YoloopClientStateStore {
+    private readonly projectRoot;
     private readonly stateDir;
     private readonly statePath;
     private readonly lockPath;
@@ -78,6 +79,13 @@ export declare class YoloopClientStateStore {
         readonly idempotencyKey?: string;
     }, nowIso?: string): Promise<YoloopRunTransitionReceiptV1>;
     private applyOperation;
+    /**
+     * Runtime v2 is authoritative once present. Missing/non-Git/v1 projects keep
+     * the legacy checkout-local adapter; a corrupt v2 never falls back.
+     */
+    private readCommonAuthorityIfPresent;
+    /** Apply legacy operation semantics to the common authority under its Git CAS. */
+    private applyCommonOperation;
     private reserveContinuationAuthority;
     private acknowledgeContinuationAuthority;
     private repairContinuationAuthority;