@ornexus/neocortex 4.60.68 → 4.60.69

package/packages/client/dist/state/state-json-repair.js

@@ -1,785 +1,3 @@
-/**
- * @license FSL-1.1
- * Copyright (c) 2026 OrNexus AI
- *
- * Client-owned `.neocortex/state.json` automatic repair helpers.
- */
-import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync, copyFileSync, } from 'node:fs';
-import { join } from 'node:path';
-import { randomBytes } from 'node:crypto';
-import { planStateMigration, StateMigrationHardStopError, } from '../../../shared/dist/state/index.js';
-import { applyStateMigration, previewStateMigration, StateMigrationApplyError, } from '../migrations/state-json.js';
-import { readGitLifecycleRuntimeSync, verifyAcceptedGitLifecycleStoryCheckpointSync, } from '../git/git-lifecycle-store.js';
-export class StateRepairHardStopError extends Error {
-    reasonCode;
-    constructor(message, reasonCode) {
-        super(message);
-        this.reasonCode = reasonCode;
-        this.name = 'StateRepairHardStopError';
-    }
-}
-export const P189_STATE_SHAPE_GAP_CODE = 'P189-GAP-STATE-SHAPE';
-export const EPIC_AGGREGATE_REASON_CODES = {
-    reconciled: 'epic_aggregate_reconciled',
-    totalRecounted: 'epic_total_stories_recounted',
-    completedRecounted: 'epic_completed_stories_recounted',
-    statusPromotedDone: 'epic_status_promoted_done',
-    completedAtSet: 'epic_completed_at_set',
-    stateNotObject: 'epic_aggregate_state_not_object',
-    epicsNotObject: 'epic_aggregate_epics_not_object',
-    storiesNotObject: 'epic_aggregate_stories_not_object',
-    scopeProjected: 'epic_aggregate_scope_projected',
-    epicNotObject: 'epic_aggregate_epic_not_object',
-    epicIdConflict: 'epic_aggregate_epic_id_conflict',
-    storyListNotArray: 'epic_aggregate_story_list_not_array',
-    storyRefInvalid: 'epic_aggregate_story_ref_invalid',
-    storyRefDuplicate: 'epic_aggregate_story_ref_duplicate',
-    storyMissing: 'epic_aggregate_story_missing',
-    storyNotObject: 'epic_aggregate_story_not_object',
-    storyIdConflict: 'epic_aggregate_story_id_conflict',
-    storyEpicConflict: 'epic_aggregate_story_epic_conflict',
-    terminalIncompleteConflict: 'epic_aggregate_terminal_incomplete_conflict',
-};
-const STORY_AGGREGATE_TARGET_TRIGGERS = new Set([
-    'yolo',
-    'implement',
-    'diagnose',
-    'research',
-    'write-spec',
-    'create-tasks',
-    'refactor-suggest',
-    'property-tests',
-    'validate-tests',
-    'qa-gate',
-    'update-project-memory',
-    'commit-push',
-    'sync-main',
-    'create-pr',
-    'review-pr',
-    'merge-pr',
-    'review',
-]);
-const EPIC_AGGREGATE_TARGET_TRIGGERS = new Set([
-    'yoloop',
-    'auto-yolo',
-    'epic-runner',
-    'story-runner',
-    'loop-yolo',
-    'auto-epic',
-]);
-function isPlainObject(value) {
-    return value !== null && typeof value === 'object' && !Array.isArray(value);
-}
-function nowIso() {
-    return new Date().toISOString();
-}
-function backupTimestamp() {
-    return nowIso().replace(/[:.]/g, '-');
-}
-function sortedStringArray(value) {
-    if (!Array.isArray(value))
-        return [];
-    return value.filter((entry) => typeof entry === 'string' && entry.length > 0);
-}
-function normalizeAggregateRepairTrigger(args) {
-    const [firstToken] = args.trim().split(/\s+/, 1);
-    if (!firstToken)
-        return null;
-    return firstToken.replace(/^@?\*/, '').replace(/^@/, '').toLowerCase();
-}
-function firstTokenIsStoryReference(args) {
-    const [firstToken] = args.trim().split(/\s+/, 1);
-    if (!firstToken)
-        return false;
-    const normalized = firstToken.replace(/^@/, '');
-    return /^[A-Z]?\d+(?:\.\d+)+$/i.test(normalized)
-        || /(?:^|\/)[A-Z]?\d+(?:\.\d+)+\.story\.md$/i.test(normalized);
-}
-function extractStoryIdFromArgs(args) {
-    const storyFileMatch = args.match(/(?:^|[/@\s])([A-Z]?\d+(?:\.\d+)+)\.story\.md\b/i);
-    if (storyFileMatch?.[1])
-        return storyFileMatch[1];
-    const storyIdMatch = args.match(/(?:^|\s|@)([A-Z]?\d+(?:\.\d+)+)(?=$|\s)/i);
-    return storyIdMatch?.[1] ?? null;
-}
-/** Materialization has no story/epic acceptance authority to replay or repair. */
-export function isInlineYoloMaterialization(args, canonicalCommandId) {
-    if (typeof args !== 'string')
-        return false;
-    const command = canonicalCommandId ?? normalizeAggregateRepairTrigger(args);
-    return (command === 'yolo' || command === 'yolo-inline')
-        && triggerRemainder(args).length > 0 && extractStoryIdFromArgs(args) === null;
-}
-function triggerRemainder(args) {
-    const trimmed = args.trim();
-    const firstWhitespace = trimmed.search(/\s/);
-    return firstWhitespace === -1 ? '' : trimmed.slice(firstWhitespace).trim();
-}
-function firstPositionalArg(args) {
-    const positional = triggerRemainder(args)
-        .split(/\s+/)
-        .find((token) => token.length > 0 && !token.startsWith('-'));
-    return positional ? positional.replace(/^@/, '').replace(/^['"]|['"]$/g, '') : null;
-}
-function resolveEpicId(candidate, epicsMap) {
-    const normalized = candidate.replace(/^@/, '').replace(/^epic-/i, '');
-    const withoutExtension = normalized.replace(/\.md$/i, '');
-    const candidates = [
-        withoutExtension,
-        withoutExtension.toUpperCase(),
-        /^p\d+$/i.test(withoutExtension)
-            ? `P${withoutExtension.replace(/^p/i, '')}`
-            : null,
-        /^\d+$/.test(withoutExtension) ? `P${withoutExtension}` : null,
-    ].filter((entry) => typeof entry === 'string' && entry.length > 0);
-    for (const entry of candidates) {
-        if (isPlainObject(epicsMap[entry]))
-            return entry;
-    }
-    return null;
-}
-function extractEpicIdFromCanonicalFile(args, epicsMap) {
-    const match = args.match(/(?:^|[/@\s])epic-(P?\d+)\.md\b/i);
-    if (!match?.[1])
-        return null;
-    return resolveEpicId(match[1], epicsMap);
-}
-function inferAggregateRepairTargetEpicId(state, args, canonicalCommandId) {
-    if (typeof args !== 'string' || args.trim().length === 0)
-        return undefined;
-    if (!isPlainObject(state.epics) || !isPlainObject(state.stories))
-        return undefined;
-    const trigger = args.trim();
-    const normalizedTrigger = canonicalCommandId ?? normalizeAggregateRepairTrigger(trigger);
-    const mayTargetStory = (normalizedTrigger !== null && STORY_AGGREGATE_TARGET_TRIGGERS.has(normalizedTrigger))
-        || firstTokenIsStoryReference(trigger);
-    if (mayTargetStory) {
-        const storyId = extractStoryIdFromArgs(trigger);
-        const story = storyId ? state.stories[storyId] : undefined;
-        if (isPlainObject(story) && typeof story.epic_id === 'string' && isPlainObject(state.epics[story.epic_id])) {
-            return story.epic_id;
-        }
-        // Inline *yolo materializes the story only after admission. The explicit
-        // canonical ID still provides a safe existing-epic scope; never fall back
-        // to reconciling unrelated epics merely because the story shell is absent.
-        const inlineEpicId = storyId?.split('.')[0];
-        if (inlineEpicId && isPlainObject(state.epics[inlineEpicId]))
-            return inlineEpicId;
-    }
-    if (normalizedTrigger !== null && EPIC_AGGREGATE_TARGET_TRIGGERS.has(normalizedTrigger)) {
-        const fromFile = extractEpicIdFromCanonicalFile(trigger, state.epics);
-        if (fromFile)
-            return fromFile;
-        const targetArg = firstPositionalArg(trigger);
-        if (targetArg) {
-            const fromArg = resolveEpicId(targetArg, state.epics);
-            if (fromArg)
-                return fromArg;
-        }
-    }
-    return undefined;
-}
-const COMPLETION_RECONCILIATION_REASON = 'pr_merged_issue_closed_reconciled';
-const INVALID_WORKFLOW_ISSUE_REASON = 'invalid_workflow_issue_removed';
-function normalizePublicStatus(value) {
-    return typeof value === 'string' ? value.trim().toLowerCase().replace(/[_\s]+/g, '-') : '';
-}
-const DONE_LIKE_STORY_STATUSES = new Set(['done', 'completed', 'merged']);
-const TERMINAL_EPIC_STATUSES = new Set(['done', 'completed', 'merged']);
-export function isP189DoneLikeStoryStatus(value) {
-    return DONE_LIKE_STORY_STATUSES.has(normalizePublicStatus(value));
-}
-function isP189TerminalEpicStatus(value) {
-    return TERMINAL_EPIC_STATUSES.has(normalizePublicStatus(value));
-}
-function throwEpicAggregateHardStop(reasonCode, message) {
-    throw new StateRepairHardStopError(`${message} (${P189_STATE_SHAPE_GAP_CODE} if this shape is intentionally new).`, reasonCode);
-}
-function cloneJsonState(state) {
-    return JSON.parse(JSON.stringify(state));
-}
-function assertFullAggregateCoverage(state, options) {
-    const scope = options.scope ?? state.scope;
-    if (!isPlainObject(scope))
-        return;
-    const kind = typeof scope.kind === 'string' ? scope.kind : null;
-    const omittedStoryCount = typeof scope.omittedStoryCount === 'number' ? scope.omittedStoryCount : 0;
-    const omittedEpicCount = typeof scope.omittedEpicCount === 'number' ? scope.omittedEpicCount : 0;
-    if (kind === 'projected' || omittedStoryCount > 0 || omittedEpicCount > 0) {
-        throwEpicAggregateHardStop(EPIC_AGGREGATE_REASON_CODES.scopeProjected, '[Neocortex] state.json aggregate reconciliation stopped: projected or partial state coverage cannot prove epic aggregates.');
-    }
-}
-function validateEpicAggregateStoryIds(epicId, storyRefs) {
-    const storyIds = [];
-    const seen = new Set();
-    for (const storyRef of storyRefs) {
-        if (typeof storyRef !== 'string' || storyRef.length === 0) {
-            throwEpicAggregateHardStop(EPIC_AGGREGATE_REASON_CODES.storyRefInvalid, `[Neocortex] state.json aggregate reconciliation stopped: epic "${sanitizePublicId(epicId)}" has a non-string or empty story reference.`);
-        }
-        if (seen.has(storyRef)) {
-            throwEpicAggregateHardStop(EPIC_AGGREGATE_REASON_CODES.storyRefDuplicate, `[Neocortex] state.json aggregate reconciliation stopped: epic "${sanitizePublicId(epicId)}" lists story "${sanitizePublicId(storyRef)}" more than once.`);
-        }
-        seen.add(storyRef);
-        storyIds.push(storyRef);
-    }
-    return storyIds;
-}
-function validateListedStoryForEpic(epicId, storyId, storiesMap) {
-    const story = storiesMap[storyId];
-    if (story === undefined) {
-        throwEpicAggregateHardStop(EPIC_AGGREGATE_REASON_CODES.storyMissing, `[Neocortex] state.json aggregate reconciliation stopped: epic "${sanitizePublicId(epicId)}" references missing story "${sanitizePublicId(storyId)}".`);
-    }
-    if (!isPlainObject(story)) {
-        throwEpicAggregateHardStop(EPIC_AGGREGATE_REASON_CODES.storyNotObject, `[Neocortex] state.json aggregate reconciliation stopped: story "${sanitizePublicId(storyId)}" is not an object.`);
-    }
-    if (story.id !== storyId) {
-        throwEpicAggregateHardStop(EPIC_AGGREGATE_REASON_CODES.storyIdConflict, `[Neocortex] state.json aggregate reconciliation stopped: story key "${sanitizePublicId(storyId)}" conflicts with its id field.`);
-    }
-    if (story.epic_id !== epicId) {
-        throwEpicAggregateHardStop(EPIC_AGGREGATE_REASON_CODES.storyEpicConflict, `[Neocortex] state.json aggregate reconciliation stopped: story "${sanitizePublicId(storyId)}" does not belong to epic "${sanitizePublicId(epicId)}".`);
-    }
-    return story;
-}
-function addAggregateReason(reasonCodes, reasonCode) {
-    if (!reasonCodes.includes(reasonCode))
-        reasonCodes.push(reasonCode);
-}
-export function reconcileEpicAggregatesInState(input, options = {}) {
-    if (!isPlainObject(input)) {
-        throwEpicAggregateHardStop(EPIC_AGGREGATE_REASON_CODES.stateNotObject, '[Neocortex] state.json aggregate reconciliation stopped: top-level state must be an object.');
-    }
-    if (!isPlainObject(input.epics)) {
-        throwEpicAggregateHardStop(EPIC_AGGREGATE_REASON_CODES.epicsNotObject, '[Neocortex] state.json aggregate reconciliation stopped: `epics` must be an object before counts are authoritative.');
-    }
-    if (!isPlainObject(input.stories)) {
-        throwEpicAggregateHardStop(EPIC_AGGREGATE_REASON_CODES.storiesNotObject, '[Neocortex] state.json aggregate reconciliation stopped: `stories` must be an object before counts are authoritative.');
-    }
-    assertFullAggregateCoverage(input, options);
-    const migrated = cloneJsonState(input);
-    const epicsMap = migrated.epics;
-    const storiesMap = migrated.stories;
-    const allReasonCodes = [];
-    const changes = [];
-    const effectiveDoneStoryIds = new Set(options.effectiveDoneStoryIds ?? []);
-    for (const [epicId, epic] of Object.entries(epicsMap)) {
-        if (options.targetEpicId && epicId !== options.targetEpicId)
-            continue;
-        if (!isPlainObject(epic)) {
-            throwEpicAggregateHardStop(EPIC_AGGREGATE_REASON_CODES.epicNotObject, `[Neocortex] state.json aggregate reconciliation stopped: epic "${sanitizePublicId(epicId)}" is not an object.`);
-        }
-        if (epic.id !== epicId) {
-            throwEpicAggregateHardStop(EPIC_AGGREGATE_REASON_CODES.epicIdConflict, `[Neocortex] state.json aggregate reconciliation stopped: epic key "${sanitizePublicId(epicId)}" conflicts with its id field.`);
-        }
-        if (!Array.isArray(epic.stories)) {
-            throwEpicAggregateHardStop(EPIC_AGGREGATE_REASON_CODES.storyListNotArray, `[Neocortex] state.json aggregate reconciliation stopped: epic "${sanitizePublicId(epicId)}" has non-array stories.`);
-        }
-        const storyIds = validateEpicAggregateStoryIds(epicId, epic.stories);
-        const totalStories = storyIds.length;
-        const completedStories = storyIds.filter((storyId) => {
-            const story = validateListedStoryForEpic(epicId, storyId, storiesMap);
-            return isP189DoneLikeStoryStatus(story.status) || effectiveDoneStoryIds.has(storyId);
-        }).length;
-        const allListedStoriesDoneLike = totalStories > 0 && completedStories === totalStories;
-        if (isP189TerminalEpicStatus(epic.status) && !allListedStoriesDoneLike && totalStories > 0) {
-            throwEpicAggregateHardStop(EPIC_AGGREGATE_REASON_CODES.terminalIncompleteConflict, `[Neocortex] state.json aggregate reconciliation stopped: terminal epic "${sanitizePublicId(epicId)}" has incomplete listed stories.`);
-        }
-        // Derived counts/status must not dirty the epic branch after its atomic story
-        // commit. Keep all ownership/coverage/terminal-conflict validation above;
-        // the verified runtime overlay and server projection own effective counts.
-        if (options.preserveGitLifecycleAggregates
-            && (epic.branch_mode === 'epic' || typeof epic.execution_branch === 'string'))
-            continue;
-        const perEpicReasons = [];
-        const previous = {
-            total_stories: epic.total_stories,
-            completed_stories: epic.completed_stories,
-            status: epic.status,
-            completed_at: epic.completed_at,
-        };
-        if (epic.total_stories !== totalStories) {
-            epic.total_stories = totalStories;
-            addAggregateReason(perEpicReasons, EPIC_AGGREGATE_REASON_CODES.totalRecounted);
-        }
-        if (epic.completed_stories !== completedStories) {
-            epic.completed_stories = completedStories;
-            addAggregateReason(perEpicReasons, EPIC_AGGREGATE_REASON_CODES.completedRecounted);
-        }
-        const shouldPromote = !isP189TerminalEpicStatus(epic.status) && allListedStoriesDoneLike;
-        if (shouldPromote) {
-            epic.status = 'done';
-            addAggregateReason(perEpicReasons, EPIC_AGGREGATE_REASON_CODES.statusPromotedDone);
-            if (epic.completed_at === undefined || epic.completed_at === null) {
-                epic.completed_at = options.nowIso ?? nowIso();
-                addAggregateReason(perEpicReasons, EPIC_AGGREGATE_REASON_CODES.completedAtSet);
-            }
-        }
-        if (perEpicReasons.length > 0) {
-            addAggregateReason(perEpicReasons, EPIC_AGGREGATE_REASON_CODES.reconciled);
-            for (const reasonCode of perEpicReasons)
-                addAggregateReason(allReasonCodes, reasonCode);
-            changes.push({
-                epicId,
-                reasonCodes: perEpicReasons,
-                previous,
-                next: {
-                    total_stories: totalStories,
-                    completed_stories: completedStories,
-                    status: epic.status,
-                    completed_at: epic.completed_at,
-                },
-            });
-        }
-    }
-    return {
-        mutated: JSON.stringify(migrated) !== JSON.stringify(input),
-        state: migrated,
-        reasonCodes: allReasonCodes,
-        changes,
-    };
-}
-function nestedRecord(input, key) {
-    const value = input[key];
-    return isPlainObject(value) ? value : null;
-}
-function hasIssueClosedEvidence(story) {
-    const audit = nestedRecord(story, 'issueCloseAudit') ?? nestedRecord(story, 'issue_close_audit');
-    if (audit) {
-        const event = normalizePublicStatus(audit.event).replace(/-/g, '_');
-        const publicSafe = audit.publicSafe === true || audit.public_safe === true;
-        const rawLogForbidden = audit.rawLogStorage === 'forbidden' || audit.raw_log_storage === 'forbidden';
-        if (event === 'story_issue_closed' && publicSafe && rawLogForbidden)
-            return true;
-    }
-    const completion = nestedRecord(story, 'completionEvidence') ?? nestedRecord(story, 'completion_evidence');
-    const completionIssueState = normalizePublicStatus(completion?.issueState ?? completion?.issue_state ?? completion?.state);
-    return story.issue_closed === true
-        || normalizePublicStatus(story.issue_state ?? story.issueState ?? story.workflow_issue_state) === 'closed'
-        || completionIssueState === 'closed';
-}
-function hasPrMergedEvidence(story) {
-    const completion = nestedRecord(story, 'completionEvidence') ?? nestedRecord(story, 'completion_evidence');
-    const scopedCi = nestedRecord(story, 'scopedCiEvidence') ?? nestedRecord(story, 'scoped_ci_evidence');
-    const states = [
-        story.physicalMergeStatus,
-        story.pr_state,
-        story.prState,
-        story.pull_request_state,
-        story.pullRequestState,
-        completion?.prState,
-        completion?.pr_state,
-        completion?.pullRequestState,
-        scopedCi?.prState,
-    ].map(normalizePublicStatus);
-    return story.merged === true
-        || states.includes('merged')
-        || normalizePublicStatus(scopedCi?.finalState) === 'can-merge' && story.merged === true;
-}
-function hasConflictingCompletionEvidence(story) {
-    const completion = nestedRecord(story, 'completionEvidence') ?? nestedRecord(story, 'completion_evidence');
-    const states = [
-        story.pr_state,
-        story.prState,
-        story.pull_request_state,
-        story.pullRequestState,
-        completion?.prState,
-        completion?.pr_state,
-        completion?.pullRequestState,
-    ].map(normalizePublicStatus);
-    const mergedSignal = hasPrMergedEvidence(story);
-    const deniedSignal = ['denied-external-gate', 'denied-local-or-repo', 'not-attempted'].includes(normalizePublicStatus(story.physicalMergeStatus));
-    const closedWithoutMergeSignal = states.includes('closed') || states.includes('closed-unmerged');
-    return (mergedSignal && (story.merged === false || deniedSignal || closedWithoutMergeSignal))
-        || (story.merged === true && deniedSignal);
-}
-function upsertCompletionDebt(existing, storyId, reconciledAt) {
-    const id = `state-completion-reconciliation:${sanitizePublicId(storyId)}`;
-    const next = existing.filter(isPlainObject).map((entry) => ({ ...entry }));
-    const incoming = {
-        id,
-        status: 'open',
-        reason: 'stale_state_completion_evidence_observed',
-        reason_codes: [COMPLETION_RECONCILIATION_REASON],
-        category: 'state/completion-reconciliation',
-        story_id: sanitizePublicId(storyId),
-        public_safe: true,
-        raw_log_storage: 'forbidden',
-        created_at: reconciledAt,
-        last_seen_at: reconciledAt,
-        occurrences: 1,
-    };
-    const index = next.findIndex((entry) => entry.id === id);
-    if (index < 0)
-        return [...next, incoming];
-    const current = next[index];
-    next[index] = {
-        ...current,
-        ...incoming,
-        created_at: typeof current.created_at === 'string' ? current.created_at : reconciledAt,
-        occurrences: Math.max(1, typeof current.occurrences === 'number' ? current.occurrences : 1) + 1,
-    };
-    return next;
-}
-function reconcileCompletionEvidence(migrated, changes, reasonCodes, targetEpicId) {
-    const storiesMap = isPlainObject(migrated.stories) ? migrated.stories : null;
-    if (!storiesMap)
-        return;
-    const reconciliations = [];
-    const reconciledAt = nowIso();
-    for (const [storyId, story] of Object.entries(storiesMap)) {
-        if (!isPlainObject(story))
-            continue;
-        const storyEpicId = typeof story.epic_id === 'string' ? story.epic_id : storyId.split('.')[0];
-        if (targetEpicId && storyEpicId !== targetEpicId)
-            continue;
-        const status = normalizePublicStatus(story.status);
-        if (hasConflictingCompletionEvidence(story)) {
-            throw new StateRepairHardStopError(`[Neocortex] state.json repair stopped: story "${storyId}" has conflicting PR merge completion evidence. ` +
-                'Resolve .neocortex/state.json manually before invoking Neocortex.', 'conflicting_completion_evidence');
-        }
-        if (status !== 'pr-reviewed')
-            continue;
-        if (!hasPrMergedEvidence(story) || !hasIssueClosedEvidence(story))
-            continue;
-        const previousStatus = typeof story.status === 'string' ? story.status : status;
-        const stepsCompleted = sortedStringArray(story.steps_completed);
-        story.status = 'done';
-        story.last_step = 'step-c-12-merge-pr';
-        story.steps_completed = Array.from(new Set([...stepsCompleted, 'step-c-12-merge-pr']));
-        story.merged = true;
-        story.physicalMergeStatus = 'merged';
-        story.completion_reconciled_at = reconciledAt;
-        changes.push(`reconciled completion evidence for story ${storyId}`);
-        reasonCodes.push(COMPLETION_RECONCILIATION_REASON);
-        reconciliations.push({
-            schemaVersion: 1,
-            publicSafe: true,
-            rawLogStorage: 'forbidden',
-            storyId: sanitizePublicId(storyId),
-            previousStatus,
-            nextStatus: 'done',
-            reasonCodes: [COMPLETION_RECONCILIATION_REASON],
-            reconciledAt,
-        });
-        migrated.state_repair_debt = upsertCompletionDebt(Array.isArray(migrated.state_repair_debt) ? migrated.state_repair_debt : [], storyId, reconciledAt);
-    }
-    if (reconciliations.length > 0) {
-        migrated.state_completion_reconciliations = [
-            ...(Array.isArray(migrated.state_completion_reconciliations) ? migrated.state_completion_reconciliations.filter(isPlainObject) : []),
-            ...reconciliations,
-        ];
-    }
-}
-function removeInvalidWorkflowIssues(migrated, changes, reasonCodes) {
-    const storiesMap = isPlainObject(migrated.stories) ? migrated.stories : null;
-    if (!storiesMap)
-        return;
-    for (const [storyId, story] of Object.entries(storiesMap)) {
-        if (!isPlainObject(story) || !Object.prototype.hasOwnProperty.call(story, 'workflow_issue'))
-            continue;
-        if (typeof story.workflow_issue === 'number' && Number.isFinite(story.workflow_issue))
-            continue;
-        delete story.workflow_issue;
-        changes.push(`removed invalid workflow_issue from story ${sanitizePublicId(storyId)}`);
-        reasonCodes.push(INVALID_WORKFLOW_ISSUE_REASON);
-    }
-}
-function repairStateObject(input, options = {}) {
-    if (Array.isArray(input.stories)) {
-        throw new StateRepairHardStopError('[Neocortex] state.json repair stopped: `stories` is an Array. Convert it to an object keyed by story ID or run `*migrate-state --preview` for guidance.', 'stories_array_ambiguous');
-    }
-    if (isPlainObject(input.epics)) {
-        for (const [epicId, epic] of Object.entries(input.epics)) {
-            if (isPlainObject(epic) && epic.stories !== undefined && !Array.isArray(epic.stories)) {
-                throw new StateRepairHardStopError(`[Neocortex] state.json repair stopped: epic "${epicId}" has non-array \`stories\`. Repair this ambiguous shape manually before invoking Neocortex.`, 'epic_stories_not_array');
-            }
-        }
-    }
-    if (input.schema_version !== undefined && input.schema_version !== 0 && input.schema_version !== 1) {
-        throw new StateRepairHardStopError(`[Neocortex] state.json repair stopped: schema_version=${String(input.schema_version)} is not a safe automatic downgrade target. ` +
-            'Run `*migrate-state --preview` or repair the schema version manually.', 'unsupported_schema_version');
-    }
-    // Preserve the complete tracked state during targetless materialization.
-    // Structural corruption above still fails closed; targeted execution keeps
-    // its normal repair and physical checkpoint validation below.
-    if (isInlineYoloMaterialization(options.args, options.canonicalCommandId)) {
-        // No historical reconciliation here, but appending a new story must not
-        // reinterpret a malformed map or overwrite a record with conflicting ID.
-        for (const key of ['epics', 'stories']) {
-            const collection = input[key];
-            if (collection === undefined)
-                continue;
-            if (!isPlainObject(collection))
-                throw new StateRepairHardStopError('[Neocortex] inline materialization stopped: invalid state collection.', 'inline_state_collection_invalid');
-            for (const [id, record] of Object.entries(collection)) {
-                if (!isPlainObject(record))
-                    throw new StateRepairHardStopError('[Neocortex] inline materialization stopped: invalid state record.', 'inline_state_record_invalid');
-                if (record.id !== undefined && record.id !== id)
-                    throw new StateRepairHardStopError('[Neocortex] inline materialization stopped: conflicting state identity.', 'inline_state_identity_conflict');
-            }
-        }
-        return { mutated: false, state: input, reasonCodes: [], changes: [] };
-    }
-    let migrationDecision;
-    try {
-        migrationDecision = planStateMigration(input);
-    }
-    catch (error) {
-        if (error instanceof StateMigrationHardStopError) {
-            throw new StateRepairHardStopError(`[Neocortex] state.json repair stopped by shared migration planner: ${error.message}`, error.reasonCode);
-        }
-        throw error;
-    }
-    let migrated = JSON.parse(JSON.stringify(migrationDecision.kind === 'migrate' ? migrationDecision.plan.targetState : input));
-    const changes = migrationDecision.kind === 'migrate'
-        ? migrationDecision.plan.steps.map((operation) => `shared migration ${operation.kind}: ${operation.target}`)
-        : [];
-    const reasonCodes = migrationDecision.kind === 'migrate' ? ['state_migration_shared_plan'] : [];
-    let aggregateChanges = [];
-    const targetEpicId = inferAggregateRepairTargetEpicId(migrated, options.args, options.canonicalCommandId);
-    removeInvalidWorkflowIssues(migrated, changes, reasonCodes);
-    reconcileCompletionEvidence(migrated, changes, reasonCodes, targetEpicId);
-    if (typeof options.args === 'string') {
-        const aggregateRepair = reconcileEpicAggregatesInState(migrated, {
-            nowIso: options.nowIso,
-            targetEpicId,
-            effectiveDoneStoryIds: options.effectiveDoneStoryIds,
-            preserveGitLifecycleAggregates: true,
-        });
-        if (aggregateRepair.mutated) {
-            migrated = aggregateRepair.state;
-            aggregateChanges = aggregateRepair.changes;
-            for (const reasonCode of aggregateRepair.reasonCodes)
-                reasonCodes.push(reasonCode);
-            for (const change of aggregateRepair.changes) {
-                changes.push(`reconciled aggregate for epic ${sanitizePublicId(change.epicId)}`);
-            }
-        }
-    }
-    const mutated = JSON.stringify(migrated) !== JSON.stringify(input);
-    if (mutated) {
-        const repairedAt = options.nowIso ?? nowIso();
-        const uniqueReasonCodes = Array.from(new Set(reasonCodes));
-        if (aggregateChanges.length > 0) {
-            appendAggregateReconciliationAudit(migrated, aggregateChanges, repairedAt);
-        }
-        migrated.last_updated = repairedAt;
-        migrated.state_migration_repairs = [
-            ...(Array.isArray(migrated.state_migration_repairs) ? migrated.state_migration_repairs : []),
-            {
-                schemaVersion: 1,
-                action: 'client_auto_repair',
-                reasonCodes: uniqueReasonCodes,
-                repairedAt,
-            },
-        ];
-        migrated.state_repair_debt = upsertStateRepairDebt(Array.isArray(migrated.state_repair_debt) ? migrated.state_repair_debt : [], uniqueReasonCodes, repairedAt);
-    }
-    return {
-        mutated,
-        state: migrated,
-        reasonCodes: Array.from(new Set(reasonCodes)),
-        changes,
-    };
-}
-function safeAggregateCount(value) {
-    return typeof value === 'number' && Number.isFinite(value) ? value : null;
-}
-function safeAggregateStatus(value) {
-    const normalized = normalizePublicStatus(value);
-    return normalized.length > 0 ? sanitizePublicText(normalized).slice(0, 80) : null;
-}
-function aggregateAuditEntry(change, repairedAt) {
-    return {
-        schemaVersion: 1,
-        publicSafe: true,
-        epicId: sanitizePublicId(change.epicId),
-        reasonCodes: change.reasonCodes.map(sanitizePublicText).filter(Boolean),
-        previous: {
-            total_stories: safeAggregateCount(change.previous.total_stories),
-            completed_stories: safeAggregateCount(change.previous.completed_stories),
-            status: safeAggregateStatus(change.previous.status),
-            completed_at_present: typeof change.previous.completed_at === 'string' && change.previous.completed_at.length > 0,
-        },
-        next: {
-            total_stories: change.next.total_stories,
-            completed_stories: change.next.completed_stories,
-            status: safeAggregateStatus(change.next.status),
-            completed_at_present: typeof change.next.completed_at === 'string' && change.next.completed_at.length > 0,
-        },
-        repairedAt,
-    };
-}
-function upsertAggregateRepairDebt(existing, changes, repairedAt) {
-    let next = existing
-        .filter(isPlainObject)
-        .map((entry) => ({ ...entry }));
-    for (const change of changes) {
-        const epicId = sanitizePublicId(change.epicId);
-        const reasonCodes = Array.from(new Set(change.reasonCodes.map(sanitizePublicText).filter(Boolean))).sort();
-        const id = `state-aggregate-reconciliation:${epicId}`;
-        const incoming = {
-            id,
-            status: 'open',
-            reason: 'epic_aggregate_reconciled',
-            reason_codes: reasonCodes,
-            category: 'state/epic-aggregate-reconciliation',
-            epic_id: epicId,
-            created_at: repairedAt,
-            last_seen_at: repairedAt,
-            occurrences: 1,
-        };
-        const index = next.findIndex((entry) => entry.id === id);
-        if (index < 0) {
-            next = [...next, incoming];
-            continue;
-        }
-        const current = next[index];
-        next[index] = {
-            ...current,
-            ...incoming,
-            created_at: typeof current.created_at === 'string' ? current.created_at : repairedAt,
-            occurrences: Math.max(1, typeof current.occurrences === 'number' ? current.occurrences : 1) + 1,
-        };
-    }
-    return next;
-}
-function appendAggregateReconciliationAudit(migrated, changes, repairedAt) {
-    migrated.state_aggregate_reconciliations = [
-        ...(Array.isArray(migrated.state_aggregate_reconciliations)
-            ? migrated.state_aggregate_reconciliations.filter(isPlainObject)
-            : []),
-        ...changes.map((change) => aggregateAuditEntry(change, repairedAt)),
-    ];
-    migrated.state_repair_debt = upsertAggregateRepairDebt(Array.isArray(migrated.state_repair_debt) ? migrated.state_repair_debt : [], changes, repairedAt);
-}
-function upsertStateRepairDebt(existing, reasonCodes, repairedAt) {
-    const safeCodes = Array.from(new Set(reasonCodes.map(sanitizePublicText).filter(Boolean))).sort();
-    const id = `state-drift-repair:${safeCodes.join('+') || 'unknown'}`;
-    const next = existing
-        .filter(isPlainObject)
-        .map((entry) => ({ ...entry }));
-    const incoming = {
-        id,
-        status: 'open',
-        reason: 'state_json_drift_repaired',
-        reason_codes: safeCodes,
-        category: 'state/drift-repair',
-        created_at: repairedAt,
-        last_seen_at: repairedAt,
-        occurrences: 1,
-    };
-    const index = next.findIndex((entry) => entry.id === id);
-    if (index < 0)
-        return [...next, incoming];
-    const current = next[index];
-    next[index] = {
-        ...current,
-        ...incoming,
-        created_at: typeof current.created_at === 'string' ? current.created_at : repairedAt,
-        occurrences: Math.max(1, typeof current.occurrences === 'number' ? current.occurrences : 1) + 1,
-    };
-    return next;
-}
-function sanitizePublicText(value) {
-    return value
-        .replace(/\b(sk|ghp|gho|github_pat|xoxb|AKIA)[A-Za-z0-9_-]{8,}\b/g, '[redacted]')
-        .replace(/(password|passwd|secret|token|api[_-]?key)\s*[:=]\s*[^,\s)]+/gi, '$1=[redacted]')
-        .replace(/https?:\/\/[^\s)]+/gi, '[url-redacted]')
-        .replace(/[^a-z0-9_+-]+/gi, '_')
-        .replace(/^_+|_+$/g, '')
-        .slice(0, 120);
-}
-function sanitizePublicId(value) {
-    return value.replace(/[^a-z0-9_.:-]+/gi, '_').replace(/^_+|_+$/g, '').slice(0, 120) || 'unknown';
-}
-export function maybeRepairStateJsonBeforeInvoke(projectRoot, options = {}) {
-    const stateDir = join(projectRoot, '.neocortex');
-    const statePath = join(stateDir, 'state.json');
-    if (!existsSync(statePath)) {
-        return { repaired: false, reasonCodes: [], changes: [] };
-    }
-    let migrationReceipt;
-    if (!isInlineYoloMaterialization(options.args, options.canonicalCommandId)) {
-        try {
-            const plan = previewStateMigration(projectRoot);
-            if (plan)
-                migrationReceipt = applyStateMigration(projectRoot, plan);
-        }
-        catch (error) {
-            const reasonCode = error instanceof StateMigrationApplyError ? error.reasonCode : 'state_migration_apply_failed';
-            throw new StateRepairHardStopError(`[Neocortex] state.json migration stopped before invoke: ${error instanceof Error ? error.message : String(error)}. No unverified state was used.`, reasonCode);
-        }
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(readFileSync(statePath, 'utf8'));
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        throw new StateRepairHardStopError(`[Neocortex] state.json repair stopped: invalid JSON in .neocortex/state.json (${msg}). No files were overwritten. Fix the JSON or restore a backup, then rerun.`, 'invalid_json');
-    }
-    if (!isPlainObject(parsed)) {
-        throw new StateRepairHardStopError('[Neocortex] state.json repair stopped: top-level state must be a JSON object. Restore a valid .neocortex/state.json before invoking Neocortex.', 'state_not_object');
-    }
-    const targetEpicId = inferAggregateRepairTargetEpicId(parsed, options.args, options.canonicalCommandId);
-    const effectiveDoneStoryIds = isInlineYoloMaterialization(options.args, options.canonicalCommandId)
-        ? [] : collectPhysicallyVerifiedRuntimeDoneStories(projectRoot, parsed, targetEpicId);
-    const repair = repairStateObject(parsed, { ...options, effectiveDoneStoryIds });
-    if (!repair.mutated) {
-        if (!migrationReceipt)
-            return { repaired: false, reasonCodes: [], changes: [] };
-        return {
-            repaired: true,
-            reasonCodes: ['state_migration_transaction_applied'],
-            backupPath: migrationReceipt.backupHash
-                ? `.neocortex/state.json.migration-backup-${migrationReceipt.operationId}`
-                : undefined,
-            changes: [`shared state migration ${migrationReceipt.outcome}`],
-        };
-    }
-    mkdirSync(stateDir, { recursive: true });
-    const ts = backupTimestamp();
-    const backupPath = join(stateDir, `state.json.backup-${ts}`);
-    const tmpPath = join(stateDir, `state.json.tmp.${randomBytes(6).toString('hex')}`);
-    copyFileSync(statePath, backupPath);
-    writeFileSync(tmpPath, `${JSON.stringify(repair.state, null, 2)}\n`, 'utf8');
-    renameSync(tmpPath, statePath);
-    const publicBackupPath = `.neocortex/state.json.backup-${ts}`;
-    process.stderr.write(`[Neocortex P156.05] state.json auto-repaired before invoke; backup=${publicBackupPath}; reasonCodes=${repair.reasonCodes.join(',')}; changes=${repair.changes.join('; ')}\n`);
-    return {
-        repaired: true,
-        reasonCodes: repair.reasonCodes,
-        backupPath: publicBackupPath,
-        changes: repair.changes,
-    };
-}
-/**
- * The tracked file cannot contain post-commit checkpoint truth without changing
- * the commit it proves. Count only sidecar `done` overlays whose checkpoint can
- * be recomputed from the current repository, and never copy that overlay into
- * the tracked story document.
- */
-function collectPhysicallyVerifiedRuntimeDoneStories(projectRoot, tracked, targetEpicId) {
-    const runtime = readGitLifecycleRuntimeSync(projectRoot);
-    const trackedEpics = isPlainObject(tracked.epics) ? tracked.epics : {};
-    const trackedStories = isPlainObject(tracked.stories) ? tracked.stories : {};
-    const verified = [];
-    for (const [storyId, overlay] of Object.entries(runtime.stories)) {
-        if (!isPlainObject(overlay) || !isP189DoneLikeStoryStatus(overlay.status) || !overlay.checkpoint)
-            continue;
-        const story = isPlainObject(trackedStories[storyId]) ? trackedStories[storyId] : null;
-        const epicId = typeof story?.epic_id === 'string' ? story.epic_id : storyId.split('.')[0];
-        if (!epicId || targetEpicId && epicId !== targetEpicId)
-            continue;
-        const trackedEpic = isPlainObject(trackedEpics[epicId]) ? trackedEpics[epicId] : null;
-        const runtimeEpic = isPlainObject(runtime.epics[epicId]) ? runtime.epics[epicId] : null;
-        const branchMode = runtimeEpic?.branch_mode ?? trackedEpic?.branch_mode;
-        const executionBranch = runtimeEpic?.execution_branch ?? trackedEpic?.execution_branch;
-        if (branchMode !== 'epic' || typeof executionBranch !== 'string')
-            continue;
-        const receipt = verifyAcceptedGitLifecycleStoryCheckpointSync(projectRoot, overlay.checkpoint, storyId, epicId, executionBranch);
-        if (receipt.verdict === 'verified')
-            verified.push(storyId);
-    }
-    return verified.sort();
-}
+import{existsSync as F,mkdirSync as J,readFileSync as q,renameSync as B,writeFileSync as H,copyFileSync as W}from"node:fs";import{join as x}from"node:path";import{randomBytes as V}from"node:crypto";import{planStateMigration as Z,StateMigrationHardStopError as U}from"../../../shared/dist/state/index.js";import{applyStateMigration as K,previewStateMigration as Y,StateMigrationApplyError as Q}from"../migrations/state-json.js";import{readGitLifecycleRuntimeSync as X,verifyAcceptedGitLifecycleStoryCheckpointSync as ee}from"../git/git-lifecycle-store.js";class S extends Error{reasonCode;constructor(t,o){super(t),this.reasonCode=o,this.name="StateRepairHardStopError"}}const te="P189-GAP-STATE-SHAPE",f={reconciled:"epic_aggregate_reconciled",totalRecounted:"epic_total_stories_recounted",completedRecounted:"epic_completed_stories_recounted",statusPromotedDone:"epic_status_promoted_done",completedAtSet:"epic_completed_at_set",stateNotObject:"epic_aggregate_state_not_object",epicsNotObject:"epic_aggregate_epics_not_object",storiesNotObject:"epic_aggregate_stories_not_object",scopeProjected:"epic_aggregate_scope_projected",epicNotObject:"epic_aggregate_epic_not_object",epicIdConflict:"epic_aggregate_epic_id_conflict",storyListNotArray:"epic_aggregate_story_list_not_array",storyRefInvalid:"epic_aggregate_story_ref_invalid",storyRefDuplicate:"epic_aggregate_story_ref_duplicate",storyMissing:"epic_aggregate_story_missing",storyNotObject:"epic_aggregate_story_not_object",storyIdConflict:"epic_aggregate_story_id_conflict",storyEpicConflict:"epic_aggregate_story_epic_conflict",terminalIncompleteConflict:"epic_aggregate_terminal_incomplete_conflict"},oe=new Set(["yolo","implement","diagnose","research","write-spec","create-tasks","refactor-suggest","property-tests","validate-tests","qa-gate","update-project-memory","commit-push","sync-main","create-pr","review-pr","merge-pr","review"]),re=new Set(["yoloop","auto-yolo","epic-runner","story-runner","loop-yolo","auto-epic"]);function d(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)}function j(){return new Date().toISOString()}function ne(){return j().replace(/[:.]/g,"-")}function ie(e){return Array.isArray(e)?e.filter(t=>typeof t=="string"&&t.length>0):[]}function k(e){const[t]=e.trim().split(/\s+/,1);return t?t.replace(/^@?\*/,"").replace(/^@/,"").toLowerCase():null}function se(e){const[t]=e.trim().split(/\s+/,1);if(!t)return!1;const o=t.replace(/^@/,"");return/^[A-Z]?\d+(?:\.\d+)+$/i.test(o)||/(?:^|\/)[A-Z]?\d+(?:\.\d+)+\.story\.md$/i.test(o)}function R(e){const t=e.match(/(?:^|[/@\s])([A-Z]?\d+(?:\.\d+)+)\.story\.md\b/i);return t?.[1]?t[1]:e.match(/(?:^|\s|@)([A-Z]?\d+(?:\.\d+)+)(?=$|\s)/i)?.[1]??null}function I(e,t){if(typeof e!="string")return!1;const o=t??k(e);return(o==="yolo"||o==="yolo-inline")&&$(e).length>0&&R(e)===null}function $(e){const t=e.trim(),o=t.search(/\s/);return o===-1?"":t.slice(o).trim()}function ce(e){const t=$(e).split(/\s+/).find(o=>o.length>0&&!o.startsWith("-"));return t?t.replace(/^@/,"").replace(/^['"]|['"]$/g,""):null}function O(e,t){const r=e.replace(/^@/,"").replace(/^epic-/i,"").replace(/\.md$/i,""),s=[r,r.toUpperCase(),/^p\d+$/i.test(r)?`P${r.replace(/^p/i,"")}`:null,/^\d+$/.test(r)?`P${r}`:null].filter(c=>typeof c=="string"&&c.length>0);for(const c of s)if(d(t[c]))return c;return null}function ae(e,t){const o=e.match(/(?:^|[/@\s])epic-(P?\d+)\.md\b/i);return o?.[1]?O(o[1],t):null}function P(e,t,o){if(typeof t!="string"||t.trim().length===0||!d(e.epics)||!d(e.stories))return;const r=t.trim(),s=o??k(r);if(s!==null&&oe.has(s)||se(r)){const l=R(r),a=l?e.stories[l]:void 0;if(d(a)&&typeof a.epic_id=="string"&&d(e.epics[a.epic_id]))return a.epic_id;const n=l?.split(".")[0];if(n&&d(e.epics[n]))return n}if(s!==null&&re.has(s)){const l=ae(r,e.epics);if(l)return l;const a=ce(r);if(a){const n=O(a,e.epics);if(n)return n}}}const E="pr_merged_issue_closed_reconciled",pe="invalid_workflow_issue_removed";function b(e){return typeof e=="string"?e.trim().toLowerCase().replace(/[_\s]+/g,"-"):""}const le=new Set(["done","completed","merged"]),de=new Set(["done","completed","merged"]);function T(e){return le.has(b(e))}function M(e){return de.has(b(e))}function h(e,t){throw new S(`${t} (${te} if this shape is intentionally new).`,e)}function ue(e){return JSON.parse(JSON.stringify(e))}function fe(e,t){const o=t.scope??e.scope;if(!d(o))return;const r=typeof o.kind=="string"?o.kind:null,s=typeof o.omittedStoryCount=="number"?o.omittedStoryCount:0,c=typeof o.omittedEpicCount=="number"?o.omittedEpicCount:0;(r==="projected"||s>0||c>0)&&h(f.scopeProjected,"[Neocortex] state.json aggregate reconciliation stopped: projected or partial state coverage cannot prove epic aggregates.")}function ge(e,t){const o=[],r=new Set;for(const s of t)(typeof s!="string"||s.length===0)&&h(f.storyRefInvalid,`[Neocortex] state.json aggregate reconciliation stopped: epic "${u(e)}" has a non-string or empty story reference.`),r.has(s)&&h(f.storyRefDuplicate,`[Neocortex] state.json aggregate reconciliation stopped: epic "${u(e)}" lists story "${u(s)}" more than once.`),r.add(s),o.push(s);return o}function _e(e,t,o){const r=o[t];return r===void 0&&h(f.storyMissing,`[Neocortex] state.json aggregate reconciliation stopped: epic "${u(e)}" references missing story "${u(t)}".`),d(r)||h(f.storyNotObject,`[Neocortex] state.json aggregate reconciliation stopped: story "${u(t)}" is not an object.`),r.id!==t&&h(f.storyIdConflict,`[Neocortex] state.json aggregate reconciliation stopped: story key "${u(t)}" conflicts with its id field.`),r.epic_id!==e&&h(f.storyEpicConflict,`[Neocortex] state.json aggregate reconciliation stopped: story "${u(t)}" does not belong to epic "${u(e)}".`),r}function v(e,t){e.includes(t)||e.push(t)}function me(e,t={}){d(e)||h(f.stateNotObject,"[Neocortex] state.json aggregate reconciliation stopped: top-level state must be an object."),d(e.epics)||h(f.epicsNotObject,"[Neocortex] state.json aggregate reconciliation stopped: `epics` must be an object before counts are authoritative."),d(e.stories)||h(f.storiesNotObject,"[Neocortex] state.json aggregate reconciliation stopped: `stories` must be an object before counts are authoritative."),fe(e,t);const o=ue(e),r=o.epics,s=o.stories,c=[],l=[],a=new Set(t.effectiveDoneStoryIds??[]);for(const[n,i]of Object.entries(r)){if(t.targetEpicId&&n!==t.targetEpicId)continue;d(i)||h(f.epicNotObject,`[Neocortex] state.json aggregate reconciliation stopped: epic "${u(n)}" is not an object.`),i.id!==n&&h(f.epicIdConflict,`[Neocortex] state.json aggregate reconciliation stopped: epic key "${u(n)}" conflicts with its id field.`),Array.isArray(i.stories)||h(f.storyListNotArray,`[Neocortex] state.json aggregate reconciliation stopped: epic "${u(n)}" has non-array stories.`);const p=ge(n,i.stories),g=p.length,m=p.filter(A=>{const z=_e(n,A,s);return T(z.status)||a.has(A)}).length,_=g>0&&m===g;if(M(i.status)&&!_&&g>0&&h(f.terminalIncompleteConflict,`[Neocortex] state.json aggregate reconciliation stopped: terminal epic "${u(n)}" has incomplete listed stories.`),t.preserveGitLifecycleAggregates&&(i.branch_mode==="epic"||typeof i.execution_branch=="string"))continue;const y=[],N={total_stories:i.total_stories,completed_stories:i.completed_stories,status:i.status,completed_at:i.completed_at};if(i.total_stories!==g&&(i.total_stories=g,v(y,f.totalRecounted)),i.completed_stories!==m&&(i.completed_stories=m,v(y,f.completedRecounted)),!M(i.status)&&_&&(i.status="done",v(y,f.statusPromotedDone),(i.completed_at===void 0||i.completed_at===null)&&(i.completed_at=t.nowIso??j(),v(y,f.completedAtSet))),y.length>0){v(y,f.reconciled);for(const A of y)v(c,A);l.push({epicId:n,reasonCodes:y,previous:N,next:{total_stories:g,completed_stories:m,status:i.status,completed_at:i.completed_at}})}}return{mutated:JSON.stringify(o)!==JSON.stringify(e),state:o,reasonCodes:c,changes:l}}function w(e,t){const o=e[t];return d(o)?o:null}function ye(e){const t=w(e,"issueCloseAudit")??w(e,"issue_close_audit");if(t){const s=b(t.event).replace(/-/g,"_"),c=t.publicSafe===!0||t.public_safe===!0,l=t.rawLogStorage==="forbidden"||t.raw_log_storage==="forbidden";if(s==="story_issue_closed"&&c&&l)return!0}const o=w(e,"completionEvidence")??w(e,"completion_evidence"),r=b(o?.issueState??o?.issue_state??o?.state);return e.issue_closed===!0||b(e.issue_state??e.issueState??e.workflow_issue_state)==="closed"||r==="closed"}function D(e){const t=w(e,"completionEvidence")??w(e,"completion_evidence"),o=w(e,"scopedCiEvidence")??w(e,"scoped_ci_evidence"),r=[e.physicalMergeStatus,e.pr_state,e.prState,e.pull_request_state,e.pullRequestState,t?.prState,t?.pr_state,t?.pullRequestState,o?.prState].map(b);return e.merged===!0||r.includes("merged")||b(o?.finalState)==="can-merge"&&e.merged===!0}function he(e){const t=w(e,"completionEvidence")??w(e,"completion_evidence"),o=[e.pr_state,e.prState,e.pull_request_state,e.pullRequestState,t?.prState,t?.pr_state,t?.pullRequestState].map(b),r=D(e),s=["denied-external-gate","denied-local-or-repo","not-attempted"].includes(b(e.physicalMergeStatus)),c=o.includes("closed")||o.includes("closed-unmerged");return r&&(e.merged===!1||s||c)||e.merged===!0&&s}function Se(e,t,o){const r=`state-completion-reconciliation:${u(t)}`,s=e.filter(d).map(n=>({...n})),c={id:r,status:"open",reason:"stale_state_completion_evidence_observed",reason_codes:[E],category:"state/completion-reconciliation",story_id:u(t),public_safe:!0,raw_log_storage:"forbidden",created_at:o,last_seen_at:o,occurrences:1},l=s.findIndex(n=>n.id===r);if(l<0)return[...s,c];const a=s[l];return s[l]={...a,...c,created_at:typeof a.created_at=="string"?a.created_at:o,occurrences:Math.max(1,typeof a.occurrences=="number"?a.occurrences:1)+1},s}function be(e,t,o,r){const s=d(e.stories)?e.stories:null;if(!s)return;const c=[],l=j();for(const[a,n]of Object.entries(s)){if(!d(n))continue;const i=typeof n.epic_id=="string"?n.epic_id:a.split(".")[0];if(r&&i!==r)continue;const p=b(n.status);if(he(n))throw new S(`[Neocortex] state.json repair stopped: story "${a}" has conflicting PR merge completion evidence. Resolve .neocortex/state.json manually before invoking Neocortex.`,"conflicting_completion_evidence");if(p!=="pr-reviewed"||!D(n)||!ye(n))continue;const g=typeof n.status=="string"?n.status:p,m=ie(n.steps_completed);n.status="done",n.last_step="step-c-12-merge-pr",n.steps_completed=Array.from(new Set([...m,"step-c-12-merge-pr"])),n.merged=!0,n.physicalMergeStatus="merged",n.completion_reconciled_at=l,t.push(`reconciled completion evidence for story ${a}`),o.push(E),c.push({schemaVersion:1,publicSafe:!0,rawLogStorage:"forbidden",storyId:u(a),previousStatus:g,nextStatus:"done",reasonCodes:[E],reconciledAt:l}),e.state_repair_debt=Se(Array.isArray(e.state_repair_debt)?e.state_repair_debt:[],a,l)}c.length>0&&(e.state_completion_reconciliations=[...Array.isArray(e.state_completion_reconciliations)?e.state_completion_reconciliations.filter(d):[],...c])}function we(e,t,o){const r=d(e.stories)?e.stories:null;if(r)for(const[s,c]of Object.entries(r))!d(c)||!Object.prototype.hasOwnProperty.call(c,"workflow_issue")||typeof c.workflow_issue=="number"&&Number.isFinite(c.workflow_issue)||(delete c.workflow_issue,t.push(`removed invalid workflow_issue from story ${u(s)}`),o.push(pe))}function ve(e,t={}){if(Array.isArray(e.stories))throw new S("[Neocortex] state.json repair stopped: `stories` is an Array. Convert it to an object keyed by story ID or run `*migrate-state --preview` for guidance.","stories_array_ambiguous");if(d(e.epics)){for(const[i,p]of Object.entries(e.epics))if(d(p)&&p.stories!==void 0&&!Array.isArray(p.stories))throw new S(`[Neocortex] state.json repair stopped: epic "${i}" has non-array \`stories\`. Repair this ambiguous shape manually before invoking Neocortex.`,"epic_stories_not_array")}if(e.schema_version!==void 0&&e.schema_version!==0&&e.schema_version!==1)throw new S(`[Neocortex] state.json repair stopped: schema_version=${String(e.schema_version)} is not a safe automatic downgrade target. Run \`*migrate-state --preview\` or repair the schema version manually.`,"unsupported_schema_version");if(I(t.args,t.canonicalCommandId)){for(const i of["epics","stories"]){const p=e[i];if(p!==void 0){if(!d(p))throw new S("[Neocortex] inline materialization stopped: invalid state collection.","inline_state_collection_invalid");for(const[g,m]of Object.entries(p)){if(!d(m))throw new S("[Neocortex] inline materialization stopped: invalid state record.","inline_state_record_invalid");if(m.id!==void 0&&m.id!==g)throw new S("[Neocortex] inline materialization stopped: conflicting state identity.","inline_state_identity_conflict")}}}return{mutated:!1,state:e,reasonCodes:[],changes:[]}}let o;try{o=Z(e)}catch(i){throw i instanceof U?new S(`[Neocortex] state.json repair stopped by shared migration planner: ${i.message}`,i.reasonCode):i}let r=JSON.parse(JSON.stringify(o.kind==="migrate"?o.plan.targetState:e));const s=o.kind==="migrate"?o.plan.steps.map(i=>`shared migration ${i.kind}: ${i.target}`):[],c=o.kind==="migrate"?["state_migration_shared_plan"]:[];let l=[];const a=P(r,t.args,t.canonicalCommandId);if(we(r,s,c),be(r,s,c,a),typeof t.args=="string"){const i=me(r,{nowIso:t.nowIso,targetEpicId:a,effectiveDoneStoryIds:t.effectiveDoneStoryIds,preserveGitLifecycleAggregates:!0});if(i.mutated){r=i.state,l=i.changes;for(const p of i.reasonCodes)c.push(p);for(const p of i.changes)s.push(`reconciled aggregate for epic ${u(p.epicId)}`)}}const n=JSON.stringify(r)!==JSON.stringify(e);if(n){const i=t.nowIso??j(),p=Array.from(new Set(c));l.length>0&&je(r,l,i),r.last_updated=i,r.state_migration_repairs=[...Array.isArray(r.state_migration_repairs)?r.state_migration_repairs:[],{schemaVersion:1,action:"client_auto_repair",reasonCodes:p,repairedAt:i}],r.state_repair_debt=Ce(Array.isArray(r.state_repair_debt)?r.state_repair_debt:[],p,i)}return{mutated:n,state:r,reasonCodes:Array.from(new Set(c)),changes:s}}function G(e){return typeof e=="number"&&Number.isFinite(e)?e:null}function L(e){const t=b(e);return t.length>0?C(t).slice(0,80):null}function Ae(e,t){return{schemaVersion:1,publicSafe:!0,epicId:u(e.epicId),reasonCodes:e.reasonCodes.map(C).filter(Boolean),previous:{total_stories:G(e.previous.total_stories),completed_stories:G(e.previous.completed_stories),status:L(e.previous.status),completed_at_present:typeof e.previous.completed_at=="string"&&e.previous.completed_at.length>0},next:{total_stories:e.next.total_stories,completed_stories:e.next.completed_stories,status:L(e.next.status),completed_at_present:typeof e.next.completed_at=="string"&&e.next.completed_at.length>0},repairedAt:t}}function xe(e,t,o){let r=e.filter(d).map(s=>({...s}));for(const s of t){const c=u(s.epicId),l=Array.from(new Set(s.reasonCodes.map(C).filter(Boolean))).sort(),a=`state-aggregate-reconciliation:${c}`,n={id:a,status:"open",reason:"epic_aggregate_reconciled",reason_codes:l,category:"state/epic-aggregate-reconciliation",epic_id:c,created_at:o,last_seen_at:o,occurrences:1},i=r.findIndex(g=>g.id===a);if(i<0){r=[...r,n];continue}const p=r[i];r[i]={...p,...n,created_at:typeof p.created_at=="string"?p.created_at:o,occurrences:Math.max(1,typeof p.occurrences=="number"?p.occurrences:1)+1}}return r}function je(e,t,o){e.state_aggregate_reconciliations=[...Array.isArray(e.state_aggregate_reconciliations)?e.state_aggregate_reconciliations.filter(d):[],...t.map(r=>Ae(r,o))],e.state_repair_debt=xe(Array.isArray(e.state_repair_debt)?e.state_repair_debt:[],t,o)}function Ce(e,t,o){const r=Array.from(new Set(t.map(C).filter(Boolean))).sort(),s=`state-drift-repair:${r.join("+")||"unknown"}`,c=e.filter(d).map(i=>({...i})),l={id:s,status:"open",reason:"state_json_drift_repaired",reason_codes:r,category:"state/drift-repair",created_at:o,last_seen_at:o,occurrences:1},a=c.findIndex(i=>i.id===s);if(a<0)return[...c,l];const n=c[a];return c[a]={...n,...l,created_at:typeof n.created_at=="string"?n.created_at:o,occurrences:Math.max(1,typeof n.occurrences=="number"?n.occurrences:1)+1},c}function C(e){return e.replace(/\b(sk|ghp|gho|github_pat|xoxb|AKIA)[A-Za-z0-9_-]{8,}\b/g,"[redacted]").replace(/(password|passwd|secret|token|api[_-]?key)\s*[:=]\s*[^,\s)]+/gi,"$1=[redacted]").replace(/https?:\/\/[^\s)]+/gi,"[url-redacted]").replace(/[^a-z0-9_+-]+/gi,"_").replace(/^_+|_+$/g,"").slice(0,120)}function u(e){return e.replace(/[^a-z0-9_.:-]+/gi,"_").replace(/^_+|_+$/g,"").slice(0,120)||"unknown"}function Te(e,t={}){const o=x(e,".neocortex"),r=x(o,"state.json");if(!F(r))return{repaired:!1,reasonCodes:[],changes:[]};let s;if(!I(t.args,t.canonicalCommandId))try{const _=Y(e);_&&(s=K(e,_))}catch(_){const y=_ instanceof Q?_.reasonCode:"state_migration_apply_failed";throw new S(`[Neocortex] state.json migration stopped before invoke: ${_ instanceof Error?_.message:String(_)}. No unverified state was used.`,y)}let c;try{c=JSON.parse(q(r,"utf8"))}catch(_){const y=_ instanceof Error?_.message:String(_);throw new S(`[Neocortex] state.json repair stopped: invalid JSON in .neocortex/state.json (${y}). No files were overwritten. Fix the JSON or restore a backup, then rerun.`,"invalid_json")}if(!d(c))throw new S("[Neocortex] state.json repair stopped: top-level state must be a JSON object. Restore a valid .neocortex/state.json before invoking Neocortex.","state_not_object");const l=P(c,t.args,t.canonicalCommandId),a=I(t.args,t.canonicalCommandId)?[]:Ie(e,c,l),n=ve(c,{...t,effectiveDoneStoryIds:a});if(!n.mutated)return s?{repaired:!0,reasonCodes:["state_migration_transaction_applied"],backupPath:s.backupHash?`.neocortex/state.json.migration-backup-${s.operationId}`:void 0,changes:[`shared state migration ${s.outcome}`]}:{repaired:!1,reasonCodes:[],changes:[]};J(o,{recursive:!0});const i=ne(),p=x(o,`state.json.backup-${i}`),g=x(o,`state.json.tmp.${V(6).toString("hex")}`);W(r,p),H(g,`${JSON.stringify(n.state,null,2)}
+`,"utf8"),B(g,r);const m=`.neocortex/state.json.backup-${i}`;return process.stderr.write(`[Neocortex P156.05] state.json auto-repaired before invoke; backup=${m}; reasonCodes=${n.reasonCodes.join(",")}; changes=${n.changes.join("; ")}
+`),{repaired:!0,reasonCodes:n.reasonCodes,backupPath:m,changes:n.changes}}function Ie(e,t,o){const r=X(e),s=d(t.epics)?t.epics:{},c=d(t.stories)?t.stories:{},l=[];for(const[a,n]of Object.entries(r.stories)){if(!d(n)||!T(n.status)||!n.checkpoint)continue;const i=d(c[a])?c[a]:null,p=typeof i?.epic_id=="string"?i.epic_id:a.split(".")[0];if(!p||o&&p!==o)continue;const g=d(s[p])?s[p]:null,m=d(r.epics[p])?r.epics[p]:null,_=m?.branch_mode??g?.branch_mode,y=m?.execution_branch??g?.execution_branch;if(_!=="epic"||typeof y!="string")continue;ee(e,n.checkpoint,a,p,y).verdict==="verified"&&l.push(a)}return l.sort()}export{f as EPIC_AGGREGATE_REASON_CODES,te as P189_STATE_SHAPE_GAP_CODE,S as StateRepairHardStopError,I as isInlineYoloMaterialization,T as isP189DoneLikeStoryStatus,Te as maybeRepairStateJsonBeforeInvoke,me as reconcileEpicAggregatesInState};