@ornexus/neocortex 4.60.73 → 4.60.75

package/packages/client/dist/state/project-state-snapshot.js

@@ -1,1731 +1 @@
-/**
- * @license FSL-1.1
- * Copyright (c) 2026 OrNexus AI
- *
- * Pure request-scoped projection helpers for invoke state snapshots.
- */
-import { createHash } from 'node:crypto';
-import { analyzeDependencyDag, StructuralDagError, } from './structural-dag-projection.js';
-import { classifyInvocationShapeV2 } from './invocation-shape.js';
-const RECENT_STORY_LIMIT = 12;
-const REASON_CODE_LIMIT = 16;
-const EPIC_LIFECYCLE_CLASSIFICATIONS = ['active', 'archived', 'rolled-back', 'synthetic', 'orphan'];
-// Publish-safe shadow of packages/shared/src/yoloop/status-policy.ts. The
-// standalone client tarball cannot take a runtime dependency on @neocortex/shared.
-const YOLOOP_ACTIVE_STORY_STATUS_SET = new Set([
-    'in-progress', 'branch-ready', 'diagnose', 'research', 'write-spec',
-    'create-tasks', 'implemented', 'refactor-suggest-done',
-    'property-tests-emitted', 'tests-validated', 'qa-gate-passed',
-    'memory-updated', 'committed', 'synced', 'pr-created', 'pr-reviewed',
-    'partial',
-]);
-/**
- * P224.01 bounded common-authority evidence for a future invoke handoff.
- * This module remains pure: callers read the private store elsewhere and pass
- * only the already-redacted projection. Absolute paths, source bytes, unknown
- * private fields and certificates are intentionally impossible to project.
- */
-export function projectEpicOperationalEvidenceForRequest(value) {
-    const hash = /^[a-f0-9]{64}$/;
-    const safeId = /^P[1-9][0-9]*(?:\.[0-9]+)*$/;
-    const safeBranch = /^[A-Za-z0-9][A-Za-z0-9._/-]{0,239}$/;
-    if (value.schemaVersion !== 'EpicOperationalPublicProjection/1.0'
-        || !hash.test(value.repositoryFingerprint)
-        || !hash.test(value.identityHash)
-        || !safeId.test(value.epicId)
-        || !safeBranch.test(value.executionBranch)
-        || !hash.test(value.graphRevision)
-        || !Number.isSafeInteger(value.storeRevision) || value.storeRevision < 0
-        || !Number.isSafeInteger(value.writerEpoch) || value.writerEpoch < 1
-        || (value.runId !== null && value.runId.length > 128)
-        || (value.runStatus !== null && value.runStatus.length > 32)
-        || (value.runRevision !== null && (!Number.isSafeInteger(value.runRevision) || value.runRevision < 0))
-        || (value.snapshotHash !== null && !hash.test(value.snapshotHash))
-        || !hash.test(value.continuationSessionHash)
-        || !hash.test(value.pendingAuthorityHash)
-        || !Number.isSafeInteger(value.pendingAuthorityCount) || value.pendingAuthorityCount < 0
-        || value.pendingAuthorityCount > 1_024
-        || value.reasonCodes.length > 16
-        || value.reasonCodes.some((reason) => !/^[a-z0-9][a-z0-9-]{0,79}$/.test(reason))
-        || value.publicSafe !== true) {
-        throw new Error('epic-operational-projection-invalid');
-    }
-    return Object.freeze({
-        schemaVersion: value.schemaVersion,
-        repositoryFingerprint: value.repositoryFingerprint,
-        identityHash: value.identityHash,
-        epicId: value.epicId,
-        executionBranch: value.executionBranch,
-        graphRevision: value.graphRevision,
-        storeRevision: value.storeRevision,
-        writerEpoch: value.writerEpoch,
-        runId: value.runId,
-        runStatus: value.runStatus,
-        runRevision: value.runRevision,
-        snapshotHash: value.snapshotHash,
-        continuationSessionHash: value.continuationSessionHash,
-        pendingAuthorityHash: value.pendingAuthorityHash,
-        pendingAuthorityCount: value.pendingAuthorityCount,
-        lockActive: value.lockActive,
-        currentSessionActive: value.currentSessionActive,
-        journalActive: value.journalActive,
-        reasonCodes: [...value.reasonCodes],
-        publicSafe: true,
-    });
-}
-const policy = (commandId, stateProjectionPolicy, options = {}) => ({
-    commandId,
-    stateProjectionPolicy,
-    ...options,
-});
-// P198.03: local publish-safe shadow of the P198.01 shared command-context
-// projection policies. The published CLI does not ship `packages/shared/dist`, so
-// this file must not add a runtime `@neocortex/shared` import until packaging is
-// changed. Keep ids/aliases/numbers aligned with the public command registry.
-const COMMAND_POLICY_BY_ID = Object.freeze({
-    status: policy('status', 'full'),
-    'arch-plan': policy('arch-plan', 'full'),
-    'arch-prd': policy('arch-prd', 'full'),
-    'arch-architecture': policy('arch-architecture', 'epic-targeted', { structuralRequired: true }),
-    'arch-api-contracts': policy('arch-api-contracts', 'epic-targeted', { structuralRequired: true }),
-    'arch-api-integrations': policy('arch-api-integrations', 'epic-targeted', { structuralRequired: true }),
-    'arch-database': policy('arch-database', 'epic-targeted', { structuralRequired: true }),
-    'arch-security': policy('arch-security', 'epic-targeted', { structuralRequired: true }),
-    'arch-design-system': policy('arch-design-system', 'epic-targeted', { structuralRequired: true }),
-    'arch-ux-design': policy('arch-ux-design', 'epic-targeted', { structuralRequired: true }),
-    'arch-performance': policy('arch-performance', 'epic-targeted', { structuralRequired: true }),
-    'arch-testing': policy('arch-testing', 'epic-targeted', { structuralRequired: true }),
-    'arch-infrastructure': policy('arch-infrastructure', 'epic-targeted', { structuralRequired: true }),
-    'arch-review': policy('arch-review', 'epic-targeted', { structuralRequired: true }),
-    'arch-fitness-functions': policy('arch-fitness-functions', 'epic-targeted', { structuralRequired: true }),
-    'create-epic': policy('create-epic', 'epic-summary'),
-    'idea-diagnose': policy('idea-diagnose', 'full'),
-    'idea-research': policy('idea-research', 'epic-targeted', { structuralRequired: true }),
-    'generate-epic': policy('generate-epic', 'epic-targeted', { structuralRequired: true }),
-    exec: policy('exec', 'story-targeted', { structuralRequired: true }),
-    yolo: policy('yolo', 'story-targeted', { structuralRequired: true }),
-    'yolo-inline': policy('yolo-inline', 'story-targeted', { structuralRequired: true }),
-    epic: policy('epic', 'epic-targeted', { structuralRequired: true }),
-    'setup-branch': policy('setup-branch', 'story-targeted', { structuralRequired: true }),
-    diagnose: policy('diagnose', 'adaptive-targeted'),
-    'diagnose-inline': policy('diagnose-inline', 'full'),
-    research: policy('research', 'adaptive-targeted'),
-    'research-inline': policy('research-inline', 'full'),
-    'write-spec': policy('write-spec', 'story-targeted', { structuralRequired: true }),
-    'create-tasks': policy('create-tasks', 'story-targeted', { structuralRequired: true }),
-    implement: policy('implement', 'story-targeted', { structuralRequired: true }),
-    commit: policy('commit', 'story-targeted', { structuralRequired: true }),
-    'commit-push': policy('commit', 'story-targeted', { structuralRequired: true }),
-    sync: policy('sync', 'story-targeted', { structuralRequired: true }),
-    'sync-main': policy('sync', 'story-targeted', { structuralRequired: true }),
-    'create-pr': policy('create-pr', 'story-targeted', { structuralRequired: true }),
-    review: policy('review', 'story-targeted'),
-    'review-pr': policy('review', 'story-targeted'),
-    merge: policy('merge', 'story-targeted', { structuralRequired: true }),
-    'merge-pr': policy('merge', 'story-targeted', { structuralRequired: true }),
-    'fix-blocked': policy('fix-blocked', 'story-targeted'),
-    'finalize-epic': policy('finalize-epic', 'epic-targeted'),
-    'resolve-conflicts': policy('resolve-conflicts', 'story-targeted'),
-    'update-memory': policy('update-memory', 'full'),
-    'update-project-memory': policy('update-memory', 'story-targeted', { structuralRequired: true }),
-    refactor: policy('refactor', 'adaptive-targeted'),
-    'refactor-suggest': policy('refactor', 'story-targeted', { structuralRequired: true }),
-    cleanup: policy('cleanup', 'full'),
-    audit: policy('audit', 'full'),
-    'tech-debt': policy('tech-debt', 'full'),
-    menu: policy('menu', 'full'),
-    plans: policy('plans', 'full'),
-    billing: policy('billing', 'full'),
-    subscribe: policy('subscribe', 'full'),
-    'qa-scan': policy('qa-scan', 'full'),
-    yoloop: policy('yoloop', 'yoloop-targeted', { structuralRequired: true }),
-    'migrate-state': policy('migrate-state', 'full'),
-    'migrate-project-id': policy('migrate-project-id', 'full'),
-    'policy-audit': policy('policy-audit', 'full'),
-    'mutation-test': policy('mutation-test', 'full'),
-    'sync-openapi': policy('sync-openapi', 'full'),
-    'generate-pacts': policy('generate-pacts', 'full'),
-    'verify-pacts': policy('verify-pacts', 'full'),
-    'property-test': policy('property-test', 'full'),
-    'property-tests': policy('property-test', 'story-targeted', { structuralRequired: true }),
-    'chaos-plan': policy('chaos-plan', 'full'),
-    'ui-ux-review': policy('ui-ux-review', 'adaptive-targeted'),
-    'solyd-system': policy('solyd-system', 'adaptive-targeted'),
-    goal: policy('goal', 'continuity-scoped'),
-    loop: policy('loop', 'continuity-scoped'),
-    jobs: policy('jobs', 'continuity-scoped'),
-    runner: policy('runner', 'continuity-scoped'),
-    'goal-tick': policy('goal-tick', 'continuity-scoped'),
-    'loop-tick': policy('loop-tick', 'continuity-scoped'),
-    'validate-tests': policy('validate-tests', 'story-targeted', { structuralRequired: true }),
-    'qa-gate': policy('qa-gate', 'story-targeted', { structuralRequired: true }),
-});
-const COMMAND_ALIAS_TO_ID = Object.freeze({
-    st: 'status',
-    arquitetura: 'arch-plan',
-    architecture: 'arch-plan',
-    arch: 'arch-plan',
-    prd: 'arch-prd',
-    'product-requirements': 'arch-prd',
-    'arch-doc': 'arch-architecture',
-    'tech-architecture': 'arch-architecture',
-    'api-contracts': 'arch-api-contracts',
-    'api-contract': 'arch-api-contracts',
-    'api-integrations': 'arch-api-integrations',
-    'api-int': 'arch-api-integrations',
-    'database-schema': 'arch-database',
-    'db-schema': 'arch-database',
-    db: 'arch-database',
-    'cyber-security': 'arch-security',
-    security: 'arch-security',
-    sec: 'arch-security',
-    'design-system': 'arch-design-system',
-    ds: 'arch-design-system',
-    'atomic-design': 'arch-design-system',
-    'ux-design': 'arch-ux-design',
-    ux: 'arch-ux-design',
-    wireframes: 'arch-ux-design',
-    wireframe: 'arch-ux-design',
-    'user-flows': 'arch-ux-design',
-    performance: 'arch-performance',
-    perf: 'arch-performance',
-    'capacity-planning': 'arch-performance',
-    capacity: 'arch-performance',
-    'arch-perf': 'arch-performance',
-    'performance-strategy': 'arch-performance',
-    'testing-strategy': 'arch-testing',
-    'test-plan': 'arch-testing',
-    'test-strategy': 'arch-testing',
-    'arch-test': 'arch-testing',
-    infrastructure: 'arch-infrastructure',
-    infra: 'arch-infrastructure',
-    'deploy-plan': 'arch-infrastructure',
-    deployment: 'arch-infrastructure',
-    'arch-infra': 'arch-infrastructure',
-    'arch-deploy': 'arch-infrastructure',
-    'review-consolidation': 'arch-review',
-    consolidation: 'arch-review',
-    'architecture-review': 'arch-review',
-    'arch-consolidation': 'arch-review',
-    fitness: 'arch-fitness-functions',
-    'fitness-functions': 'arch-fitness-functions',
-    archfit: 'arch-fitness-functions',
-    'arch-fit': 'arch-fitness-functions',
-    'fit-funcs': 'arch-fitness-functions',
-    'criar-epic': 'create-epic',
-    planejamento: 'create-epic',
-    'idea-diag': 'idea-diagnose',
-    'idea-pesq': 'idea-research',
-    'gerar-epic': 'generate-epic',
-    executar: 'exec',
-    pipeline: 'exec',
-    'parallel-epic': 'epic',
-    setup: 'setup-branch',
-    branch: 'setup-branch',
-    diag: 'diagnose',
-    diagnostico: 'diagnose',
-    c02: 'diagnose',
-    pesquisar: 'research',
-    pesq: 'research',
-    'research-fix': 'research',
-    c03: 'research',
-    spec: 'write-spec',
-    especificacao: 'write-spec',
-    c04: 'write-spec',
-    tasks: 'create-tasks',
-    tarefas: 'create-tasks',
-    c05: 'create-tasks',
-    impl: 'implement',
-    implementar: 'implement',
-    c06: 'implement',
-    push: 'commit',
-    'commit_push': 'commit',
-    cp: 'commit',
-    c07: 'commit',
-    sincronizar: 'sync',
-    c08: 'sync',
-    pr: 'create-pr',
-    c09: 'create-pr',
-    revisar: 'review',
-    c11: 'review',
-    mesclar: 'merge',
-    c12: 'merge',
-    fix: 'fix-blocked',
-    corrigir: 'fix-blocked',
-    finalizar: 'finalize-epic',
-    conflitos: 'resolve-conflicts',
-    memoria: 'update-memory',
-    refactoring: 'refactor',
-    refact: 'refactor',
-    refac: 'refactor',
-    rf: 'refactor',
-    'cleanup-code': 'refactor',
-    'code-cleanup': 'refactor',
-    'code-quality': 'refactor',
-    'improve-code': 'refactor',
-    modernize: 'refactor',
-    modernization: 'refactor',
-    legacy: 'refactor',
-    'legacy-code': 'refactor',
-    'debt-pay': 'refactor',
-    'pay-debt': 'refactor',
-    'debt-reduction': 'refactor',
-    'smell-fix': 'refactor',
-    'fix-smells': 'refactor',
-    'code-smells': 'refactor',
-    strangler: 'refactor',
-    'strangler-fig': 'refactor',
-    limpar: 'cleanup',
-    limpeza: 'cleanup',
-    auditar: 'audit',
-    auditoria: 'audit',
-    debt: 'tech-debt',
-    debts: 'tech-debt',
-    'debt-list': 'tech-debt',
-    'tech-debts': 'tech-debt',
-    td: 'tech-debt',
-    help: 'menu',
-    ajuda: 'menu',
-    '?': 'menu',
-    commands: 'menu',
-    cmds: 'menu',
-    planos: 'plans',
-    pricing: 'plans',
-    bill: 'billing',
-    subscription: 'billing',
-    sub: 'billing',
-    upgrade: 'subscribe',
-    checkout: 'subscribe',
-    qa: 'qa-scan',
-    'qa-test': 'qa-scan',
-    'visual-qa': 'qa-scan',
-    'e2e-scan': 'qa-scan',
-    troubleshoot: 'qa-scan',
-    'debug-ui': 'qa-scan',
-    scan: 'qa-scan',
-    a11y: 'qa-scan',
-    accessibility: 'qa-scan',
-    wcag: 'qa-scan',
-    'auto-yolo': 'yoloop',
-    'epic-runner': 'yoloop',
-    'story-runner': 'yoloop',
-    'loop-yolo': 'yoloop',
-    'auto-epic': 'yoloop',
-    migrate: 'migrate-state',
-    'state-migrate': 'migrate-state',
-    'schema-migrate': 'migrate-state',
-    policy: 'policy-audit',
-    'audit-policy': 'policy-audit',
-    'policy-history': 'policy-audit',
-    policies: 'policy-audit',
-    mutation: 'mutation-test',
-    stryker: 'mutation-test',
-    'kill-mutants': 'mutation-test',
-    'openapi-sync': 'sync-openapi',
-    'api-sync': 'sync-openapi',
-    'spec-sync': 'sync-openapi',
-    'regen-openapi': 'sync-openapi',
-    pacts: 'generate-pacts',
-    'gen-pacts': 'generate-pacts',
-    'regen-pacts': 'generate-pacts',
-    'create-pacts': 'generate-pacts',
-    'verify-pact': 'verify-pacts',
-    'pact-verify': 'verify-pacts',
-    'check-pacts': 'verify-pacts',
-    'pact-check': 'verify-pacts',
-    property: 'property-test',
-    pbt: 'property-test',
-    proptest: 'property-test',
-    'invariant-test': 'property-test',
-    chaos: 'chaos-plan',
-    gameday: 'chaos-plan',
-    'resilience-test': 'chaos-plan',
-    'ux-review': 'ui-ux-review',
-    'design-review': 'ui-ux-review',
-    'visual-review': 'ui-ux-review',
-    'product-polish': 'ui-ux-review',
-    'security-system': 'solyd-system',
-    'authorized-security': 'solyd-system',
-    'sec-system': 'solyd-system',
-    goals: 'goal',
-    'durable-goal': 'goal',
-    'continuity-goal': 'goal',
-    loops: 'loop',
-    'durable-loop': 'loop',
-    'continuity-loop': 'loop',
-    job: 'jobs',
-    'continuity-jobs': 'jobs',
-    'neocortex-runner': 'runner',
-    'continuity-runner': 'runner',
-});
-const COMMAND_NUMBER_TO_ID = Object.freeze({
-    '1': 'status',
-    '3': 'arch-plan',
-    '4': 'arch-prd',
-    '5': 'arch-architecture',
-    '6': 'arch-api-contracts',
-    '7': 'arch-api-integrations',
-    '8': 'arch-database',
-    '9': 'arch-security',
-    '10': 'arch-design-system',
-    '11': 'arch-ux-design',
-    '12': 'arch-performance',
-    '13': 'arch-testing',
-    '14': 'arch-infrastructure',
-    '15': 'arch-review',
-    '16': 'arch-fitness-functions',
-    '17': 'create-epic',
-    '18': 'idea-diagnose',
-    '19': 'idea-research',
-    '20': 'generate-epic',
-    '21': 'exec',
-    '22': 'yolo',
-    '23': 'epic',
-    '24': 'setup-branch',
-    '25': 'diagnose',
-    '26': 'research',
-    '27': 'write-spec',
-    '28': 'create-tasks',
-    '29': 'implement',
-    '30': 'commit',
-    '31': 'sync',
-    '32': 'create-pr',
-    '33': 'review',
-    '34': 'merge',
-    '35': 'fix-blocked',
-    '36': 'finalize-epic',
-    '37': 'resolve-conflicts',
-    '38': 'update-memory',
-    '39': 'refactor',
-    '40': 'cleanup',
-    '41': 'audit',
-    '42': 'tech-debt',
-    '43': 'menu',
-    '44': 'plans',
-    '45': 'billing',
-    '46': 'subscribe',
-    '47': 'qa-scan',
-    '48': 'yoloop',
-    '49': 'migrate-state',
-    '50': 'policy-audit',
-    '51': 'mutation-test',
-    '52': 'sync-openapi',
-    '53': 'generate-pacts',
-    '54': 'verify-pacts',
-    '55': 'property-test',
-    '56': 'chaos-plan',
-    '57': 'ui-ux-review',
-    '58': 'solyd-system',
-    '59': 'goal',
-    '60': 'loop',
-    '61': 'jobs',
-    '62': 'runner',
-});
-function safeToken(value, maxLength = 120) {
-    if (typeof value !== 'string')
-        return undefined;
-    const trimmed = value.trim();
-    if (!trimmed)
-        return undefined;
-    return trimmed.replace(/[^a-z0-9_.:-]+/gi, '_').slice(0, maxLength);
-}
-function safeCanonicalToken(value, maxLength = 120) {
-    if (typeof value !== 'string')
-        return undefined;
-    const trimmed = value.trim();
-    const safe = safeToken(value, maxLength);
-    return safe === trimmed ? safe : undefined;
-}
-function safeGitRef(value) {
-    if (typeof value !== 'string')
-        return undefined;
-    const trimmed = value.trim();
-    if (!trimmed || trimmed.length > 240 || !/^[A-Za-z0-9][A-Za-z0-9._/-]*$/.test(trimmed)
-        || trimmed.includes('..') || trimmed.includes('//') || trimmed.includes('@{')
-        || trimmed.endsWith('/') || trimmed.endsWith('.')
-        || trimmed.split('/').some((part) => !part || part.startsWith('.') || part.endsWith('.lock')))
-        return undefined;
-    return trimmed;
-}
-function safeWriteRef(value) {
-    if (typeof value !== 'string')
-        return undefined;
-    const normalized = value.replace(/\\/g, '/');
-    if (!normalized || normalized.length > 240 || normalized.startsWith('/')
-        || /^[A-Za-z]:/.test(normalized) || normalized.includes('..') || normalized.includes('//')
-        || normalized.split('/').includes('.') || !/^[A-Za-z0-9._/:@#-]+$/.test(normalized))
-        return undefined;
-    return normalized;
-}
-function safeWriteRefs(value) {
-    if (value === undefined)
-        return undefined;
-    if (!Array.isArray(value) || value.length > 128)
-        return undefined;
-    const refs = value.map(safeWriteRef);
-    if (refs.some((ref) => ref === undefined))
-        return undefined;
-    return [...new Set(refs)].sort((left, right) => left.localeCompare(right, 'en'));
-}
-function isActiveYoloopStory(status) {
-    return typeof status === 'string'
-        && YOLOOP_ACTIVE_STORY_STATUS_SET.has(status.trim().toLowerCase().replace(/_/g, '-'));
-}
-function pickPublicScalarFields(value, allowlist) {
-    const result = {};
-    for (const key of allowlist) {
-        const field = value[key];
-        if (typeof field === 'string' || typeof field === 'boolean'
-            || typeof field === 'number' && Number.isFinite(field))
-            result[key] = field;
-        else if (Array.isArray(field) && field.every((item) => typeof item === 'string'))
-            result[key] = [...field];
-    }
-    return result;
-}
-function publicResumeCheckpoint(storyId, story) {
-    const value = story.checkpoint;
-    if (!isRecord(value) || value.schemaVersion !== 1 || value.storyId !== storyId
-        || value.epicId !== story.epic_id || !safeGitRef(value.branch)
-        || typeof value.baseSha !== 'string' || !/^[0-9a-f]{7,64}$/i.test(value.baseSha)
-        || typeof value.headSha !== 'string' || !/^[0-9a-f]{7,64}$/i.test(value.headSha)
-        || value.baseSha === value.headSha || !safeCanonicalToken(value.idempotencyKey)
-        || typeof value.recordedAt !== 'string' || !Number.isFinite(Date.parse(value.recordedAt))
-        || !Array.isArray(value.commits) || value.commits.length === 0 || value.commits.length > 256
-        || value.commits.some((sha) => typeof sha !== 'string' || !/^[0-9a-f]{7,64}$/i.test(sha))
-        || !Array.isArray(value.receiptRefs) || value.receiptRefs.length === 0 || value.receiptRefs.length > 256
-        || value.receiptRefs.some((ref) => typeof ref !== 'string' || ref.length > 240 || ref.includes('..')
-            || !/^[A-Za-z0-9._:/#\-[\]]+$/.test(ref))
-        || !isRecord(value.qaReceipt) || value.qaReceipt.kind !== 'story_qa_evidence'
-        || value.qaReceipt.producer !== 'local-yolo-tdd'
-        || !['passed', 'blocked'].includes(String(value.qaVerdict))
-        || !['approved', 'changes-requested', 'pending'].includes(String(value.reviewVerdict)))
-        return undefined;
-    if (value.reviewVerdict === 'pending' ? value.reviewReceipt !== undefined : !isRecord(value.reviewReceipt))
-        return undefined;
-    // collectStateSnapshot already validated field values. Re-project the exact
-    // public allowlist so later hooks or synthetic callers cannot append content.
-    const result = pickPublicScalarFields(value, [
-        'schemaVersion', 'storyId', 'epicId', 'branch', 'baseSha', 'headSha',
-        'idempotencyKey', 'dispatchId', 'bundleId', 'bundleDigest', 'graphRevision',
-        'claimRevision', 'qaVerdict', 'reviewVerdict', 'recordedAt', 'commits',
-        'receiptRefs',
-    ]);
-    result.qaReceipt = pickPublicScalarFields(value.qaReceipt, [
-        'schemaVersion', 'kind', 'producer', 'evidenceVersion', 'storyId', 'epicId',
-        'contract', 'command', 'manifestDigest', 'gateIds', 'resultDigest', 'baseSha',
-        'headSha', 'bundleDigest', 'graphRevision', 'sourceEvidenceDigest', 'verdict',
-        'checkedAt', 'receiptRef',
-    ]);
-    if (isRecord(value.reviewReceipt)) {
-        result.reviewReceipt = pickPublicScalarFields(value.reviewReceipt, [
-            'schemaVersion', 'kind', 'producer', 'storyId', 'epicId', 'baseSha',
-            'headSha', 'bundleDigest', 'graphRevision', 'sourceEvidenceDigest',
-            'qaReceiptRef', 'verdict', 'reviewedAt', 'receiptRef',
-        ]);
-    }
-    return result;
-}
-function publicCheckpointVerification(storyId, story) {
-    const value = story.checkpoint_verification;
-    if (!isRecord(value) || value.schemaVersion !== 1
-        || value.kind !== 'story_checkpoint_physical_verification'
-        || value.producer !== 'client-p205-transient-v1' || value.publicSafe !== true
-        || value.storyId !== storyId || value.epicId !== story.epic_id
-        || !['verified', 'rejected'].includes(String(value.verdict)))
-        return undefined;
-    return pickPublicScalarFields(value, [
-        'schemaVersion', 'kind', 'producer', 'storyId', 'epicId', 'branch',
-        'baseSha', 'headSha', 'aggregateHeadSha', 'commitBodyDigest',
-        'changedPathsDigest', 'claimVerification', 'effectiveClaimRevision',
-        'command', 'manifestDigest', 'gateIds', 'resultDigest', 'graphRevision',
-        'executionEvidenceDigest', 'sourceEvidenceDigest', 'verifiedAt', 'verdict',
-        'reasonCodes', 'publicSafe',
-    ]);
-}
-function publicSchedulingCheckpointEvidence(storyId, story) {
-    const value = story.scheduling_checkpoint_evidence;
-    const allowed = new Set([
-        'schemaVersion', 'kind', 'producer', 'storyId', 'epicId', 'branch', 'baseSha', 'headSha',
-        'graphRevision', 'effectiveClaimRevision', 'sourceEvidenceDigest', 'verifiedAt', 'reasonCodes',
-        'integrationAuthorized', 'publicSafe',
-    ]);
-    if (!isRecord(value) || Object.keys(value).some((key) => !allowed.has(key))
-        || value.schemaVersion !== 1 || value.kind !== 'story_scheduling_checkpoint_evidence'
-        || value.producer !== 'client-git-physical-v1' || value.publicSafe !== true
-        || value.integrationAuthorized !== false || value.storyId !== storyId || value.epicId !== story.epic_id
-        || !safeGitRef(value.branch) || typeof value.baseSha !== 'string' || !/^[0-9a-f]{40,64}$/i.test(value.baseSha)
-        || typeof value.headSha !== 'string' || !/^[0-9a-f]{40,64}$/i.test(value.headSha)
-        || typeof value.graphRevision !== 'string' || !/^[0-9a-f]{64}$/i.test(value.graphRevision)
-        || typeof value.effectiveClaimRevision !== 'string' || !/^[0-9a-f]{64}$/i.test(value.effectiveClaimRevision)
-        || typeof value.sourceEvidenceDigest !== 'string' || !/^[0-9a-f]{64}$/i.test(value.sourceEvidenceDigest)
-        || typeof value.verifiedAt !== 'string' || !Number.isFinite(Date.parse(value.verifiedAt))
-        || !Array.isArray(value.reasonCodes) || value.reasonCodes.length !== 1
-        || value.reasonCodes[0] !== 'checkpoint-git-scheduling-verified')
-        return undefined;
-    return pickPublicScalarFields(value, [...allowed]);
-}
-function projectSchedulingLane(storyId, story) {
-    const projected = { ...story };
-    const evidence = publicSchedulingCheckpointEvidence(storyId, story);
-    if (evidence) {
-        projected.scheduling_checkpoint_evidence = evidence;
-        delete projected.checkpoint;
-        delete projected.checkpoint_verification;
-    }
-    else {
-        delete projected.scheduling_checkpoint_evidence;
-    }
-    return projected;
-}
-function isRecord(value) {
-    return value !== null && typeof value === 'object' && !Array.isArray(value);
-}
-function safeReasonCodes(...groups) {
-    const seen = new Set();
-    const reasonCodes = [];
-    for (const group of groups) {
-        for (const reasonCode of group ?? []) {
-            const safe = safeToken(reasonCode, 80);
-            if (!safe || seen.has(safe))
-                continue;
-            seen.add(safe);
-            reasonCodes.push(safe);
-            if (reasonCodes.length >= REASON_CODE_LIMIT)
-                return reasonCodes;
-        }
-    }
-    return reasonCodes;
-}
-function normalizeCommandToken(input) {
-    return input.trim().replace(/^@?\*/, '').replace(/^@/, '').toLowerCase();
-}
-function leadingCommandToken(input) {
-    return input.trim().split(/\s+/, 1)[0] ?? '';
-}
-function resolveCommandProjectionPolicy(args) {
-    // The exact published @epic-P{N} spelling is a one-token command and its
-    // own target. It must receive the same structural projection as *epic.
-    if (/^@epic-P[0-9]{1,12}$/.test(args.trim()))
-        return COMMAND_POLICY_BY_ID.epic;
-    const token = leadingCommandToken(args);
-    if (!token)
-        return COMMAND_POLICY_BY_ID.menu;
-    const normalized = normalizeCommandToken(token);
-    const commandId = COMMAND_NUMBER_TO_ID[normalized]
-        ?? COMMAND_ALIAS_TO_ID[normalized]
-        ?? normalized;
-    return COMMAND_POLICY_BY_ID[commandId] ?? null;
-}
-function createFullScope(trigger, snapshot, commandPolicy, projectionMode = 'full-compatible', reasonCodes = ['full-state']) {
-    return {
-        kind: 'full',
-        commandId: commandPolicy?.commandId ?? null,
-        stateProjectionPolicy: commandPolicy?.stateProjectionPolicy ?? null,
-        projectionMode,
-        trigger,
-        targetEpicId: null,
-        targetStoryId: null,
-        includedStoryCount: Object.keys(snapshot.stories).length,
-        includedEpicCount: Object.keys(snapshot.epics).length,
-        omittedStoryCount: 0,
-        omittedEpicCount: 0,
-        reason: 'full-state',
-        reasonCodes: safeReasonCodes(reasonCodes),
-    };
-}
-function fullSnapshot(trigger, snapshot, commandPolicy, projectionMode = 'full-compatible', reasonCodes = ['full-state']) {
-    const scope = createFullScope(trigger, snapshot, commandPolicy, projectionMode, reasonCodes);
-    return withStateSummary({
-        ...snapshot,
-        scope,
-    }, snapshot, scope);
-}
-function firstTokenIsStoryReference(args) {
-    const [firstToken] = args.trim().split(/\s+/, 1);
-    if (!firstToken)
-        return false;
-    return (/^[A-Z]?\d+(?:\.\d+)+$/i.test(firstToken.replace(/^@/, '')) ||
-        /(?:^|\/)[A-Z]?\d+(?:\.\d+)+\.story\.md$/i.test(firstToken.replace(/^@/, '')));
-}
-function extractStoryId(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;
-}
-function triggerRemainder(args) {
-    const trimmed = args.trim();
-    const firstWhitespace = trimmed.search(/\s/);
-    return firstWhitespace === -1 ? '' : trimmed.slice(firstWhitespace).trim();
-}
-function positionalTokens(args) {
-    return triggerRemainder(args)
-        .split(/\s+/)
-        .map((token) => token.replace(/^@/, '').replace(/^['"]|['"]$/g, ''))
-        .filter((token) => token.length > 0 && !token.startsWith('-'));
-}
-function firstPositionalArg(args) {
-    return positionalTokens(args)[0] ?? null;
-}
-function resolveEpicId(candidate, snapshot) {
-    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 (snapshot.epics[entry])
-            return entry;
-    }
-    return null;
-}
-function extractEpicIdFromCanonicalFile(args, snapshot) {
-    const match = args.match(/(?:^|[/@\s])epic-(P?\d+)\.md\b/i);
-    if (!match?.[1])
-        return null;
-    return resolveEpicId(match[1], snapshot);
-}
-function extractTargetEpicId(args, snapshot) {
-    const directEpic = args.trim().match(/^@epic-(P[0-9]{1,12})$/);
-    if (directEpic)
-        return resolveEpicId(directEpic[1], snapshot);
-    const fromFile = extractEpicIdFromCanonicalFile(args, snapshot);
-    if (fromFile)
-        return fromFile;
-    for (const token of positionalTokens(args)) {
-        if (/^[A-Z]?\d+(?:\.\d+)+$/i.test(token))
-            continue;
-        const fromToken = resolveEpicId(token, snapshot);
-        if (fromToken)
-            return fromToken;
-    }
-    return null;
-}
-function extractYoloopTargetEpicId(args, snapshot) {
-    const fromTarget = extractTargetEpicId(args, snapshot);
-    if (fromTarget)
-        return fromTarget;
-    const yoloop = snapshot.yoloop;
-    const sessionEpicId = yoloop?.state?.currentSession?.currentEpicId;
-    if (typeof sessionEpicId === 'string' && snapshot.epics[sessionEpicId]) {
-        return sessionEpicId;
-    }
-    const lockEpicId = yoloop?.lock?.currentEpicId ?? yoloop?.lock?.epicId;
-    if (typeof lockEpicId === 'string' && snapshot.epics[lockEpicId]) {
-        return lockEpicId;
-    }
-    return null;
-}
-function explicitYoloopEpicCandidate(args) {
-    const fromFile = args.match(/(?:^|[/@\s])epic-(P?\d+)\.md\b/i)?.[1];
-    if (fromFile)
-        return /^P/i.test(fromFile) ? fromFile.toUpperCase() : `P${fromFile}`;
-    for (const token of positionalTokens(args)) {
-        if (/^P\d+$/i.test(token))
-            return token.toUpperCase();
-        if (/^\d+$/.test(token))
-            return `P${token}`;
-    }
-    return null;
-}
-function storyEpicId(story, storyId) {
-    if (typeof story.epic_id === 'string' && story.epic_id.length > 0) {
-        return story.epic_id;
-    }
-    const derived = storyId.split('.').slice(0, -1).join('.');
-    return derived.length > 0 ? derived : null;
-}
-function isTerminalStoryStatus(status) {
-    return typeof status === 'string' && ['done', 'completed', 'merged', 'cancelled', 'canceled', 'abandoned'].includes(status.toLowerCase());
-}
-function addStoryAndDependencies(storyId, snapshot, includedStoryIds) {
-    if (includedStoryIds.has(storyId))
-        return;
-    const story = snapshot.stories[storyId];
-    if (!story)
-        return;
-    includedStoryIds.add(storyId);
-    const dependsOn = story.depends_on;
-    if (!Array.isArray(dependsOn))
-        return;
-    for (const dependencyId of dependsOn) {
-        if (typeof dependencyId === 'string') {
-            addStoryAndDependencies(dependencyId, snapshot, includedStoryIds);
-        }
-    }
-}
-function buildProjectedStories(targetStoryId, snapshot) {
-    const analysis = analyzeDependencyDag(snapshot.stories, [targetStoryId]);
-    const projectedStories = {};
-    for (const storyId of analysis.orderedIds) {
-        const story = snapshot.stories[storyId];
-        if (story) {
-            projectedStories[storyId] = story;
-        }
-    }
-    return projectedStories;
-}
-function buildProjectedEpics(projectedStories, snapshot, requiredEpicIds = []) {
-    const projectedEpics = {};
-    for (const epicId of requiredEpicIds) {
-        if (snapshot.epics[epicId]) {
-            projectedEpics[epicId] = snapshot.epics[epicId];
-        }
-    }
-    for (const [storyId, story] of Object.entries(projectedStories)) {
-        const epicId = storyEpicId(story, storyId);
-        if (epicId && snapshot.epics[epicId]) {
-            projectedEpics[epicId] = snapshot.epics[epicId];
-        }
-    }
-    return projectedEpics;
-}
-function addEpicAndDependencies(epicId, snapshot, includedEpicIds) {
-    if (includedEpicIds.has(epicId))
-        return;
-    const epic = snapshot.epics[epicId];
-    if (!epic)
-        return;
-    includedEpicIds.add(epicId);
-    const dependsOn = epic.depends_on;
-    if (!Array.isArray(dependsOn))
-        return;
-    for (const dependencyId of dependsOn) {
-        if (typeof dependencyId === 'string' && dependencyId.length > 0) {
-            addEpicAndDependencies(dependencyId, snapshot, includedEpicIds);
-        }
-    }
-}
-function buildProjectedYoloopEpics(targetEpicId, projectedStories, snapshot) {
-    const epicAnalysis = analyzeDependencyDag(snapshot.epics, [targetEpicId]);
-    const requiredEpicIds = new Set(epicAnalysis.orderedIds);
-    for (const [storyId, story] of Object.entries(projectedStories)) {
-        const parentEpicId = storyEpicId(story, storyId);
-        if (parentEpicId && snapshot.epics[parentEpicId])
-            requiredEpicIds.add(parentEpicId);
-    }
-    const projectedEpics = {};
-    for (const epicId of [...requiredEpicIds].sort((left, right) => left.localeCompare(right, 'en'))) {
-        const epic = snapshot.epics[epicId];
-        if (!epic)
-            continue;
-        projectedEpics[epicId] = epicId === targetEpicId ? epic : compactStructuralEpic(epicId, epic);
-    }
-    return projectedEpics;
-}
-function buildProjectedYoloopStories(targetEpicId, targetEpic, snapshot) {
-    const storyIds = targetEpic.stories;
-    if (!Array.isArray(storyIds)
-        || storyIds.some((storyId) => typeof storyId !== 'string' || storyId.length === 0)) {
-        throw new StructuralDagError('STRUCTURAL_DEPENDENCY_MISSING', {
-            nodes: 0,
-            edges: 0,
-            malformedStoryMemberships: 1,
-        });
-    }
-    const analysis = analyzeDependencyDag(snapshot.stories, storyIds);
-    const projectedStories = {};
-    for (const storyId of analysis.orderedIds) {
-        const story = snapshot.stories[storyId];
-        if (story) {
-            projectedStories[storyId] = storyEpicId(story, storyId) === targetEpicId
-                ? projectSchedulingLane(storyId, story)
-                : compactStructuralStory(storyId, story);
-        }
-    }
-    return projectedStories;
-}
-function buildTargetEpicCoverage(targetEpicId, targetEpic, projectedStories) {
-    const declaredStoryIds = [...targetEpic.stories]
-        .sort((left, right) => left.localeCompare(right, 'en'));
-    const includedStoryIds = Object.entries(projectedStories)
-        .filter(([storyId, story]) => storyEpicId(story, storyId) === targetEpicId)
-        .map(([storyId]) => storyId)
-        .sort((left, right) => left.localeCompare(right, 'en'));
-    const membershipSha256 = createHash('sha256')
-        .update(`target-epic-coverage-v1\0${JSON.stringify({ targetEpicId, declaredStoryIds, includedStoryIds })}`)
-        .digest('hex');
-    return {
-        schemaVersion: 'TargetEpicCoverage/1.0',
-        targetEpicId,
-        declaredStoryIds,
-        includedStoryIds,
-        membershipSha256,
-        publicSafe: true,
-    };
-}
-function compactStructuralStory(storyId, story) {
-    const dependsOn = Array.isArray(story.depends_on)
-        ? [...new Set(story.depends_on.filter((value) => typeof value === 'string' && value.length > 0))]
-            .sort((left, right) => left.localeCompare(right, 'en'))
-        : [];
-    const compact = {
-        id: safeToken(story.id) ?? storyId,
-        ...(safeToken(story.epic_id) ? { epic_id: safeToken(story.epic_id) } : {}),
-        ...(safeToken(story.status, 40) ? { status: safeToken(story.status, 40) } : {}),
-        depends_on: dependsOn,
-    };
-    const schedulingEvidence = publicSchedulingCheckpointEvidence(storyId, story);
-    if (!isActiveYoloopStory(story.status)) {
-        return { ...compact, ...(schedulingEvidence ? { scheduling_checkpoint_evidence: schedulingEvidence } : {}) };
-    }
-    const source = story.source === 'create-epic' || story.source === 'discovered'
-        ? story.source : undefined;
-    const branchName = safeGitRef(story.branch_name);
-    const lastStep = safeCanonicalToken(story.last_step, 120);
-    const steps = Array.isArray(story.steps_completed) && story.steps_completed.length <= 64
-        ? story.steps_completed.map((step) => safeCanonicalToken(step, 120))
-        : [];
-    const validSteps = steps.length > 0 && steps.every((step) => step !== undefined)
-        ? steps : undefined;
-    const prNumber = typeof story.pr_number === 'number' && Number.isSafeInteger(story.pr_number)
-        && story.pr_number > 0 ? story.pr_number : undefined;
-    const checkpoint = publicResumeCheckpoint(storyId, story);
-    const checkpointVerification = checkpoint ? publicCheckpointVerification(storyId, story) : undefined;
-    return {
-        ...compact,
-        ...(source ? { source } : {}),
-        ...(branchName ? { branch_name: branchName } : {}),
-        ...(lastStep ? { last_step: lastStep } : {}),
-        ...(validSteps ? { steps_completed: validSteps } : {}),
-        ...(prNumber ? { pr_number: prNumber } : {}),
-        ...(checkpoint ? { checkpoint } : {}),
-        ...(checkpointVerification ? { checkpoint_verification: checkpointVerification } : {}),
-        ...(schedulingEvidence ? { scheduling_checkpoint_evidence: schedulingEvidence } : {}),
-        ...(safeWriteRefs(story.files_to_modify) !== undefined
-            ? { files_to_modify: safeWriteRefs(story.files_to_modify) } : {}),
-        ...(safeWriteRefs(story.contracts) !== undefined
-            ? { contracts: safeWriteRefs(story.contracts) } : {}),
-        ...(safeWriteRefs(story.contract_refs) !== undefined
-            ? { contract_refs: safeWriteRefs(story.contract_refs) } : {}),
-        ...(safeWriteRefs(story.shared_surfaces) !== undefined
-            ? { shared_surfaces: safeWriteRefs(story.shared_surfaces) } : {}),
-    };
-}
-function compactStructuralEpic(epicId, epic) {
-    const stories = Array.isArray(epic.stories)
-        ? [...new Set(epic.stories.filter((value) => typeof value === 'string' && value.length > 0))]
-            .sort((left, right) => left.localeCompare(right, 'en'))
-        : [];
-    const dependsOn = Array.isArray(epic.depends_on)
-        ? [...new Set(epic.depends_on.filter((value) => typeof value === 'string' && value.length > 0))]
-            .sort((left, right) => left.localeCompare(right, 'en'))
-        : [];
-    return {
-        id: safeToken(epic.id) ?? epicId,
-        ...(safeToken(epic.status, 40) ? { status: safeToken(epic.status, 40) } : {}),
-        ...(safeToken(epic.lifecycle_classification, 40)
-            ? { lifecycle_classification: safeToken(epic.lifecycle_classification, 40) }
-            : {}),
-        stories,
-        depends_on: dependsOn,
-    };
-}
-function buildYoloopDiscoveryProjection(trigger, snapshot, commandPolicy) {
-    const storyAnalysis = analyzeDependencyDag(snapshot.stories);
-    const epicAnalysis = analyzeDependencyDag(snapshot.epics);
-    const projectedStories = Object.fromEntries(storyAnalysis.orderedIds.map((storyId) => [
-        storyId,
-        compactStructuralStory(storyId, snapshot.stories[storyId]),
-    ]));
-    const projectedEpics = Object.fromEntries(epicAnalysis.orderedIds.map((epicId) => [
-        epicId,
-        compactStructuralEpic(epicId, snapshot.epics[epicId]),
-    ]));
-    const scope = {
-        kind: 'projected',
-        commandId: commandPolicy.commandId,
-        stateProjectionPolicy: commandPolicy.stateProjectionPolicy,
-        projectionMode: 'yoloop-discovery',
-        trigger,
-        targetEpicId: null,
-        targetStoryId: null,
-        includedStoryCount: storyAnalysis.orderedIds.length,
-        includedEpicCount: epicAnalysis.orderedIds.length,
-        omittedStoryCount: 0,
-        omittedEpicCount: 0,
-        reason: 'targeted-invocation',
-        reasonCodes: safeReasonCodes([
-            'structural-required',
-            'yoloop-discovery',
-            `structural-edges-${storyAnalysis.edgeCount + epicAnalysis.edgeCount}`,
-            'content-fields-omitted',
-        ]),
-    };
-    return withStateSummary({
-        ...snapshot,
-        stories: projectedStories,
-        epics: projectedEpics,
-        scope,
-    }, snapshot, scope);
-}
-function buildProjectedTargetEpicStories(targetEpic, snapshot) {
-    const includedStoryIds = new Set();
-    const storyIds = targetEpic.stories;
-    if (Array.isArray(storyIds)) {
-        for (const storyId of storyIds) {
-            if (typeof storyId === 'string') {
-                addStoryAndDependencies(storyId, snapshot, includedStoryIds);
-            }
-        }
-    }
-    const projectedStories = {};
-    for (const storyId of includedStoryIds) {
-        const story = snapshot.stories[storyId];
-        if (story) {
-            projectedStories[storyId] = story;
-        }
-    }
-    return projectedStories;
-}
-function buildEpicStubs(snapshot) {
-    const projectedEpics = {};
-    for (const [epicId, epic] of Object.entries(snapshot.epics)) {
-        projectedEpics[epicId] = {
-            id: safeToken(epic.id) ?? epicId,
-            ...(safeToken(epic.status) ? { status: safeToken(epic.status) } : {}),
-            ...(EPIC_LIFECYCLE_CLASSIFICATIONS.includes(epic.lifecycle_classification)
-                ? { lifecycle_classification: epic.lifecycle_classification }
-                : {}),
-            ...(typeof epic.total_stories === 'number' && Number.isFinite(epic.total_stories)
-                ? { total_stories: epic.total_stories }
-                : {}),
-            ...(typeof epic.completed_stories === 'number' && Number.isFinite(epic.completed_stories)
-                ? { completed_stories: epic.completed_stories }
-                : {}),
-        };
-    }
-    return projectedEpics;
-}
-function countStatuses(records) {
-    const counts = {};
-    for (const record of Object.values(records)) {
-        const status = safeToken(record.status, 40) ?? 'unknown';
-        counts[status] = (counts[status] ?? 0) + 1;
-    }
-    return counts;
-}
-function countEpicLifecycles(records) {
-    const counts = Object.fromEntries(EPIC_LIFECYCLE_CLASSIFICATIONS.map((classification) => [classification, 0]));
-    for (const record of Object.values(records)) {
-        const classification = EPIC_LIFECYCLE_CLASSIFICATIONS.includes(record.lifecycle_classification)
-            ? record.lifecycle_classification
-            : 'active';
-        counts[classification] = (counts[classification] ?? 0) + 1;
-    }
-    return counts;
-}
-function isActiveEpicLifecycle(snapshot, epicId) {
-    if (!epicId)
-        return true;
-    const epic = snapshot.epics[epicId];
-    if (!epic)
-        return true;
-    return !EPIC_LIFECYCLE_CLASSIFICATIONS.includes(epic.lifecycle_classification) || epic.lifecycle_classification === 'active';
-}
-function sortableStoryTimestamp(story) {
-    for (const key of ['last_updated', 'updated_at', 'completed_at', 'created_at', 'discovered_at']) {
-        const value = story[key];
-        if (typeof value !== 'string')
-            continue;
-        const parsed = Date.parse(value);
-        if (Number.isFinite(parsed))
-            return parsed;
-    }
-    return 0;
-}
-function recentStories(snapshot) {
-    return Object.entries(snapshot.stories)
-        .map(([id, story]) => ({ id, story, timestamp: sortableStoryTimestamp(story) }))
-        .sort((left, right) => right.timestamp - left.timestamp || left.id.localeCompare(right.id))
-        .slice(0, RECENT_STORY_LIMIT)
-        .map(({ id, story }) => ({
-        id,
-        ...(safeToken(story.epic_id) ? { epicId: safeToken(story.epic_id) } : {}),
-        ...(safeToken(story.status, 40) ? { status: safeToken(story.status, 40) } : {}),
-        ...(safeToken(story.last_step ?? story.lastStep) ? { lastStep: safeToken(story.last_step ?? story.lastStep) } : {}),
-        ...(safeToken(story.last_updated ?? story.updated_at ?? story.completed_at ?? story.created_at)
-            ? { lastUpdated: safeToken(story.last_updated ?? story.updated_at ?? story.completed_at ?? story.created_at) }
-            : {}),
-    }));
-}
-function currentSessionRef(snapshot) {
-    const session = snapshot.current_session;
-    if (!session)
-        return undefined;
-    const ref = {
-        activeEpicId: safeToken(session.active_epic_id) ?? null,
-        activeStoryId: safeToken(session.active_story_id) ?? null,
-        activeStepId: safeToken(session.active_step_id) ?? null,
-        sessionId: safeToken(session.session_id) ?? null,
-        startedAt: safeToken(session.started_at) ?? null,
-    };
-    return Object.values(ref).some((value) => value !== null && value !== undefined) ? ref : undefined;
-}
-function yoloopSessionRef(snapshot) {
-    const yoloop = snapshot.yoloop;
-    if (!isRecord(yoloop))
-        return undefined;
-    const state = isRecord(yoloop.state) ? yoloop.state : undefined;
-    const currentSession = isRecord(state?.currentSession) ? state.currentSession : undefined;
-    const lock = isRecord(yoloop.lock) ? yoloop.lock : undefined;
-    const ref = {
-        ...(typeof yoloop.active === 'boolean' ? { active: yoloop.active } : {}),
-        currentEpicId: safeToken(currentSession?.currentEpicId ?? yoloop.currentEpicId) ?? null,
-        currentStoryId: safeToken(currentSession?.currentStoryId ?? yoloop.currentStoryId) ?? null,
-        sessionId: safeToken(currentSession?.sessionId ?? yoloop.sessionId) ?? null,
-        lockEpicId: safeToken(lock?.currentEpicId ?? lock?.epicId) ?? null,
-    };
-    return Object.keys(ref).length > 0 ? ref : undefined;
-}
-function continuitySessionRef(snapshot) {
-    const continuity = snapshot.continuity;
-    if (!isRecord(continuity))
-        return undefined;
-    const reasonCodes = Array.isArray(continuity.reasonCodes)
-        ? continuity.reasonCodes.filter((entry) => typeof entry === 'string')
-        : undefined;
-    return {
-        present: true,
-        activeJobId: safeToken(continuity.activeJobId ?? continuity.jobId) ?? null,
-        activeGoalId: safeToken(continuity.activeGoalId ?? continuity.goalId) ?? null,
-        activeLoopId: safeToken(continuity.activeLoopId ?? continuity.loopId) ?? null,
-        ...(reasonCodes && reasonCodes.length > 0 ? { reasonCodes: safeReasonCodes(reasonCodes) } : {}),
-    };
-}
-function deriveActiveRef(snapshot, session, yoloop) {
-    const sessionStoryId = safeToken(session?.activeStoryId);
-    const sessionEpicId = safeToken(session?.activeEpicId);
-    const sessionStepId = safeToken(session?.activeStepId);
-    const sessionStoryEpicId = sessionStoryId && snapshot.stories[sessionStoryId]
-        ? storyEpicId(snapshot.stories[sessionStoryId], sessionStoryId)
-        : null;
-    if ((sessionStoryId || sessionEpicId || sessionStepId) && isActiveEpicLifecycle(snapshot, sessionEpicId ?? sessionStoryEpicId)) {
-        return {
-            epicId: sessionEpicId ?? null,
-            storyId: sessionStoryId ?? null,
-            stepId: sessionStepId ?? null,
-        };
-    }
-    const yoloopStoryId = safeToken(yoloop?.currentStoryId);
-    const yoloopEpicId = safeToken(yoloop?.currentEpicId ?? yoloop?.lockEpicId);
-    if ((yoloopStoryId || yoloopEpicId) && isActiveEpicLifecycle(snapshot, yoloopEpicId)) {
-        return {
-            epicId: yoloopEpicId ?? null,
-            storyId: yoloopStoryId ?? null,
-            stepId: null,
-        };
-    }
-    const latestNonTerminal = Object.entries(snapshot.stories)
-        .map(([id, story]) => ({ id, story, timestamp: sortableStoryTimestamp(story) }))
-        .filter(({ id, story }) => !isTerminalStoryStatus(story.status) && isActiveEpicLifecycle(snapshot, storyEpicId(story, id)))
-        .sort((left, right) => right.timestamp - left.timestamp || left.id.localeCompare(right.id))[0];
-    if (latestNonTerminal) {
-        return {
-            epicId: storyEpicId(latestNonTerminal.story, latestNonTerminal.id),
-            storyId: latestNonTerminal.id,
-            stepId: safeToken(latestNonTerminal.story.last_step ?? latestNonTerminal.story.lastStep) ?? null,
-        };
-    }
-    return { epicId: null, storyId: null, stepId: null };
-}
-function buildStateSummary(sourceSnapshot, scope) {
-    const storyStatus = countStatuses(sourceSnapshot.stories);
-    const epicStatus = countStatuses(sourceSnapshot.epics);
-    const epicLifecycle = countEpicLifecycles(sourceSnapshot.epics);
-    const activeEpics = Object.values(sourceSnapshot.epics).filter((epic) => {
-        const lifecycle = EPIC_LIFECYCLE_CLASSIFICATIONS.includes(epic.lifecycle_classification)
-            ? epic.lifecycle_classification
-            : 'active';
-        return lifecycle === 'active' && !isTerminalStoryStatus(epic.status);
-    }).length;
-    const session = currentSessionRef(sourceSnapshot);
-    const yoloop = yoloopSessionRef(sourceSnapshot);
-    const continuity = continuitySessionRef(sourceSnapshot);
-    const active = deriveActiveRef(sourceSnapshot, session, yoloop);
-    const recent = recentStories(sourceSnapshot);
-    const reasonCodes = safeReasonCodes(scope.reasonCodes, [
-        'state-summary-attached',
-        'state-summary-bounded',
-        `projection-${scope.projectionMode ?? scope.kind}`,
-        scope.stateProjectionPolicy ? `policy-${scope.stateProjectionPolicy}` : 'policy-unknown',
-        recent.length >= RECENT_STORY_LIMIT ? 'recent-stories-capped' : 'recent-stories-bounded',
-        active.storyId || active.epicId ? 'active-ref-derived' : 'active-ref-empty',
-        yoloop ? 'yoloop-session-present' : 'yoloop-session-absent',
-        continuity ? 'continuity-session-present' : 'continuity-session-absent',
-    ]);
-    return {
-        schemaVersion: 1,
-        totals: {
-            stories: Object.keys(sourceSnapshot.stories).length,
-            epics: Object.keys(sourceSnapshot.epics).length,
-            storyStatus,
-            epicStatus,
-            epicLifecycle,
-            activeEpics,
-            blockedStories: storyStatus.blocked ?? 0,
-        },
-        active,
-        blockedCount: storyStatus.blocked ?? 0,
-        recentStories: recent,
-        ...(session ? { currentSession: session } : {}),
-        ...(yoloop ? { currentYoloopSession: yoloop } : {}),
-        ...(continuity ? { currentContinuitySession: continuity } : {}),
-        projection: {
-            commandId: scope.commandId ?? null,
-            stateProjectionPolicy: scope.stateProjectionPolicy ?? null,
-            projectionMode: scope.projectionMode,
-            scopeKind: scope.kind,
-            includedStoryCount: scope.includedStoryCount,
-            includedEpicCount: scope.includedEpicCount ?? Object.keys(sourceSnapshot.epics).length,
-            omittedStoryCount: scope.omittedStoryCount,
-            omittedEpicCount: scope.omittedEpicCount,
-            reason: scope.reason,
-        },
-        reasonCodes,
-        publicSafe: true,
-    };
-}
-function withStateSummary(projected, sourceSnapshot, scope) {
-    return {
-        ...projected,
-        stateSummary: buildStateSummary(sourceSnapshot, scope),
-    };
-}
-function buildCreateEpicProjection(trigger, snapshot, commandPolicy) {
-    const projectedEpics = {};
-    for (const epicId of Object.keys(snapshot.epics)) {
-        projectedEpics[epicId] = { id: epicId };
-    }
-    const scope = {
-        kind: 'projected',
-        commandId: commandPolicy.commandId,
-        stateProjectionPolicy: commandPolicy.stateProjectionPolicy,
-        projectionMode: 'summary-only',
-        trigger,
-        targetEpicId: null,
-        targetStoryId: null,
-        includedStoryCount: 0,
-        includedEpicCount: Object.keys(projectedEpics).length,
-        omittedStoryCount: Object.keys(snapshot.stories).length,
-        omittedEpicCount: 0,
-        reason: 'epic-summary',
-        reasonCodes: ['epic-summary', 'stories-omitted', 'epic-stubs-only'],
-    };
-    return withStateSummary({
-        ...snapshot,
-        stories: {},
-        epics: projectedEpics,
-        scope,
-    }, snapshot, scope);
-}
-function buildSummaryOnlyProjection(trigger, snapshot, commandPolicy, reasonCodes = ['summary-only', 'stories-omitted'], projectionMode = 'summary-only') {
-    const projectedEpics = buildEpicStubs(snapshot);
-    const scope = {
-        kind: 'projected',
-        commandId: commandPolicy.commandId,
-        stateProjectionPolicy: commandPolicy.stateProjectionPolicy,
-        projectionMode,
-        trigger,
-        targetEpicId: null,
-        targetStoryId: null,
-        includedStoryCount: 0,
-        includedEpicCount: Object.keys(projectedEpics).length,
-        omittedStoryCount: Object.keys(snapshot.stories).length,
-        omittedEpicCount: Math.max(0, Object.keys(snapshot.epics).length - Object.keys(projectedEpics).length),
-        reason: 'summary-only',
-        reasonCodes: safeReasonCodes(reasonCodes),
-    };
-    return withStateSummary({
-        ...snapshot,
-        stories: {},
-        epics: projectedEpics,
-        scope,
-    }, snapshot, scope);
-}
-function buildStoryProjection(trigger, snapshot, commandPolicy, targetStoryId, projectionMode, reasonCodes) {
-    const targetStory = snapshot.stories[targetStoryId];
-    if (!targetStory) {
-        throw new StructuralDagError('STRUCTURAL_TARGET_NOT_FOUND', {
-            stories: Object.keys(snapshot.stories).length,
-            epics: Object.keys(snapshot.epics).length,
-            targetKind: 'story',
-        });
-    }
-    const targetEpicId = storyEpicId(targetStory, targetStoryId);
-    if (!targetEpicId) {
-        throw new StructuralDagError('STRUCTURAL_TARGET_NOT_FOUND', {
-            stories: Object.keys(snapshot.stories).length,
-            epics: Object.keys(snapshot.epics).length,
-            targetKind: 'epic',
-        });
-    }
-    const targetEpic = snapshot.epics[targetEpicId];
-    if (!targetEpic) {
-        throw new StructuralDagError('STRUCTURAL_TARGET_NOT_FOUND', {
-            stories: Object.keys(snapshot.stories).length,
-            epics: Object.keys(snapshot.epics).length,
-            targetKind: 'epic',
-        });
-    }
-    // Direct *yolo needs the same epic topology seen by *yoloop so a standalone
-    // invocation can bootstrap the canonical P207 graph epoch. Other story
-    // commands remain dependency-scoped. Stories outside the owning epic are
-    // retained only as compact structural dependencies by the yoloop projector.
-    const yoloEpicGraph = projectionMode === 'yolo-story';
-    const projectedStories = yoloEpicGraph
-        ? buildProjectedYoloopStories(targetEpicId, targetEpic, snapshot)
-        : buildProjectedStories(targetStoryId, snapshot);
-    const projectedEpics = yoloEpicGraph
-        ? buildProjectedYoloopEpics(targetEpicId, projectedStories, snapshot)
-        : buildProjectedEpics(projectedStories, snapshot);
-    if (!projectedStories[targetStoryId] || !projectedEpics[targetEpicId]) {
-        throw new StructuralDagError('STRUCTURAL_TARGET_NOT_FOUND', {
-            stories: Object.keys(projectedStories).length,
-            epics: Object.keys(projectedEpics).length,
-            targetKind: 'story',
-        });
-    }
-    const scope = {
-        kind: 'projected',
-        commandId: commandPolicy.commandId,
-        stateProjectionPolicy: commandPolicy.stateProjectionPolicy,
-        projectionMode,
-        trigger,
-        targetEpicId,
-        targetStoryId,
-        includedStoryCount: Object.keys(projectedStories).length,
-        includedEpicCount: Object.keys(projectedEpics).length,
-        omittedStoryCount: Math.max(0, Object.keys(snapshot.stories).length - Object.keys(projectedStories).length),
-        omittedEpicCount: Math.max(0, Object.keys(snapshot.epics).length - Object.keys(projectedEpics).length),
-        reason: 'targeted-invocation',
-        reasonCodes: safeReasonCodes(reasonCodes, yoloEpicGraph ? ['epic-graph-authority-complete'] : []),
-    };
-    return withStateSummary({
-        ...snapshot,
-        stories: projectedStories,
-        epics: projectedEpics,
-        scope,
-    }, snapshot, scope);
-}
-function buildTargetedEpicProjection(trigger, snapshot, commandPolicy, targetEpicId, projectionMode, reasonCodes) {
-    const targetEpic = snapshot.epics[targetEpicId];
-    if (!targetEpic) {
-        throw new StructuralDagError('STRUCTURAL_TARGET_NOT_FOUND', {
-            stories: Object.keys(snapshot.stories).length,
-            epics: Object.keys(snapshot.epics).length,
-            targetKind: 'epic',
-        });
-    }
-    const projectedStories = buildProjectedTargetEpicStories(targetEpic, snapshot);
-    const projectedEpics = buildProjectedEpics(projectedStories, snapshot, [targetEpicId]);
-    if (!projectedEpics[targetEpicId]) {
-        throw new StructuralDagError('STRUCTURAL_TARGET_NOT_FOUND', {
-            stories: Object.keys(projectedStories).length,
-            epics: Object.keys(projectedEpics).length,
-            targetKind: 'epic',
-        });
-    }
-    const scope = {
-        kind: 'projected',
-        commandId: commandPolicy.commandId,
-        stateProjectionPolicy: commandPolicy.stateProjectionPolicy,
-        projectionMode,
-        trigger,
-        targetEpicId,
-        targetStoryId: null,
-        includedStoryCount: Object.keys(projectedStories).length,
-        includedEpicCount: Object.keys(projectedEpics).length,
-        omittedStoryCount: Math.max(0, Object.keys(snapshot.stories).length - Object.keys(projectedStories).length),
-        omittedEpicCount: Math.max(0, Object.keys(snapshot.epics).length - Object.keys(projectedEpics).length),
-        reason: 'targeted-invocation',
-        reasonCodes: safeReasonCodes(reasonCodes),
-    };
-    return withStateSummary({
-        ...snapshot,
-        stories: projectedStories,
-        epics: projectedEpics,
-        scope,
-    }, snapshot, scope);
-}
-function buildYoloopProjection(trigger, snapshot, commandPolicy) {
-    const explicitCandidate = explicitYoloopEpicCandidate(trigger);
-    const explicitTargetEpicId = extractTargetEpicId(trigger, snapshot);
-    if (explicitCandidate && !explicitTargetEpicId) {
-        throw new StructuralDagError('STRUCTURAL_TARGET_NOT_FOUND', {
-            stories: Object.keys(snapshot.stories).length,
-            epics: Object.keys(snapshot.epics).length,
-            targetKind: 'epic',
-        });
-    }
-    const targetEpicId = extractYoloopTargetEpicId(trigger, snapshot);
-    const shape = classifyInvocationShapeV2({
-        commandId: commandPolicy.commandId,
-        explicitYoloopEpicId: explicitTargetEpicId,
-        sessionYoloopEpicId: explicitTargetEpicId ? null : targetEpicId,
-    });
-    if (shape === 'yoloop-discovery')
-        return buildYoloopDiscoveryProjection(trigger, snapshot, commandPolicy);
-    if (!targetEpicId || (shape !== 'yoloop-target' && shape !== 'yoloop-session')) {
-        throw new StructuralDagError('STRUCTURAL_TARGET_NOT_FOUND', {
-            stories: Object.keys(snapshot.stories).length,
-            epics: Object.keys(snapshot.epics).length,
-            targetKind: 'epic',
-        });
-    }
-    const targetEpic = snapshot.epics[targetEpicId];
-    if (!targetEpic) {
-        throw new StructuralDagError('STRUCTURAL_TARGET_NOT_FOUND', {
-            stories: Object.keys(snapshot.stories).length,
-            epics: Object.keys(snapshot.epics).length,
-            targetKind: 'epic',
-        });
-    }
-    const projectedStories = buildProjectedYoloopStories(targetEpicId, targetEpic, snapshot);
-    const projectedEpics = buildProjectedYoloopEpics(targetEpicId, projectedStories, snapshot);
-    if (!projectedEpics[targetEpicId]) {
-        throw new StructuralDagError('STRUCTURAL_TARGET_NOT_FOUND', {
-            stories: Object.keys(projectedStories).length,
-            epics: Object.keys(projectedEpics).length,
-            targetKind: 'epic',
-        });
-    }
-    const projectionMode = shape;
-    const scope = {
-        kind: 'projected',
-        commandId: commandPolicy.commandId,
-        stateProjectionPolicy: commandPolicy.stateProjectionPolicy,
-        projectionMode,
-        trigger,
-        targetEpicId,
-        targetStoryId: null,
-        targetEpicCoverage: buildTargetEpicCoverage(targetEpicId, targetEpic, projectedStories),
-        includedStoryCount: Object.keys(projectedStories).length,
-        includedEpicCount: Object.keys(projectedEpics).length,
-        omittedStoryCount: Math.max(0, Object.keys(snapshot.stories).length - Object.keys(projectedStories).length),
-        omittedEpicCount: Math.max(0, Object.keys(snapshot.epics).length - Object.keys(projectedEpics).length),
-        reason: 'targeted-invocation',
-        reasonCodes: ['structural-required', projectionMode, 'yoloop-targeted'],
-    };
-    return withStateSummary({
-        ...snapshot,
-        stories: projectedStories,
-        epics: projectedEpics,
-        scope,
-    }, snapshot, scope);
-}
-function buildPayloadGuardrailEpics(snapshot, retainedStoryIds) {
-    const projectedEpics = {};
-    for (const [epicId, epic] of Object.entries(snapshot.epics)) {
-        const retainedEpicStories = Array.isArray(epic.stories)
-            ? epic.stories.filter((storyId) => typeof storyId === 'string' && retainedStoryIds.has(storyId))
-            : [];
-        projectedEpics[epicId] = {
-            id: safeToken(epic.id) ?? epicId,
-            ...(safeToken(epic.status, 40) ? { status: safeToken(epic.status, 40) } : {}),
-            ...(typeof epic.total_stories === 'number' && Number.isFinite(epic.total_stories)
-                ? { total_stories: epic.total_stories }
-                : {}),
-            ...(typeof epic.completed_stories === 'number' && Number.isFinite(epic.completed_stories)
-                ? { completed_stories: epic.completed_stories }
-                : {}),
-            ...(retainedEpicStories.length > 0 ? { stories: retainedEpicStories } : {}),
-            ...(retainedEpicStories.length > 0 && Array.isArray(epic.depends_on)
-                ? { depends_on: epic.depends_on.filter((value) => typeof value === 'string' && value.length > 0) }
-                : {}),
-            ...(retainedEpicStories.length > 0 && (epic.branch_mode === 'epic' || epic.branch_mode === 'story')
-                ? { branch_mode: epic.branch_mode }
-                : {}),
-            ...(retainedEpicStories.length > 0 && typeof epic.execution_branch === 'string'
-                ? { execution_branch: epic.execution_branch }
-                : {}),
-            ...(retainedEpicStories.length > 0 && typeof epic.origin_branch === 'string'
-                ? { origin_branch: epic.origin_branch }
-                : {}),
-            ...(retainedEpicStories.length > 0 && (epic.branch_lease === null || typeof epic.branch_lease === 'object')
-                ? { branch_lease: epic.branch_lease }
-                : {}),
-            ...(retainedEpicStories.length > 0 && (epic.origin_binding === null || typeof epic.origin_binding === 'object')
-                ? { origin_binding: epic.origin_binding }
-                : {}),
-            ...(retainedEpicStories.length > 0 && (epic.aggregate_qa_receipt === null || typeof epic.aggregate_qa_receipt === 'object')
-                ? { aggregate_qa_receipt: epic.aggregate_qa_receipt }
-                : {}),
-        };
-    }
-    return projectedEpics;
-}
-function sourceStoryTotal(snapshot) {
-    return snapshot.stateSummary?.totals.stories
-        ?? ((snapshot.scope?.includedStoryCount ?? Object.keys(snapshot.stories).length) + (snapshot.scope?.omittedStoryCount ?? 0));
-}
-function sourceEpicTotal(snapshot) {
-    return snapshot.stateSummary?.totals.epics
-        ?? ((snapshot.scope?.includedEpicCount ?? Object.keys(snapshot.epics).length) + (snapshot.scope?.omittedEpicCount ?? 0));
-}
-function updateStateSummaryForPayloadGuardrail(snapshot, scope) {
-    if (!snapshot.stateSummary)
-        return undefined;
-    return {
-        ...snapshot.stateSummary,
-        projection: {
-            ...snapshot.stateSummary.projection,
-            scopeKind: 'projected',
-            projectionMode: scope.projectionMode,
-            includedStoryCount: scope.includedStoryCount,
-            includedEpicCount: scope.includedEpicCount ?? snapshot.stateSummary.projection.includedEpicCount,
-            omittedStoryCount: scope.omittedStoryCount,
-            omittedEpicCount: scope.omittedEpicCount,
-            reason: 'body-size',
-        },
-        reasonCodes: safeReasonCodes(snapshot.stateSummary.reasonCodes, ['payload-size-guardrail', 'state-summary-preserved', 'nonessential-state-degraded']),
-    };
-}
-/**
- * P198.04 -- deterministic post-assembly state degradation.
- *
- * This helper is intentionally pure and request-only. It removes historical story
- * bodies that are not structural for the already-projected request, converts the
- * epic map to public stubs, keeps `stateSummary`, and preserves structural-required
- * story/yolo/yoloop target state instead of silently corrupting it.
- */
-export function degradeStateSnapshotForPayloadLimit(snapshot) {
-    const scope = snapshot.scope;
-    const retainedStoryIds = new Set();
-    const preserveProjectedStructuralStories = scope?.projectionMode === 'structural-required'
-        || scope?.projectionMode === 'yolo-story'
-        || scope?.projectionMode === 'yoloop-target'
-        || scope?.projectionMode === 'yoloop-session'
-        || scope?.projectionMode === 'yoloop-discovery';
-    if (preserveProjectedStructuralStories) {
-        for (const storyId of Object.keys(snapshot.stories)) {
-            retainedStoryIds.add(storyId);
-        }
-    }
-    else if (scope?.targetStoryId) {
-        addStoryAndDependencies(scope.targetStoryId, snapshot, retainedStoryIds);
-    }
-    const projectedStories = {};
-    for (const storyId of retainedStoryIds) {
-        const story = snapshot.stories[storyId];
-        if (story)
-            projectedStories[storyId] = story;
-    }
-    const projectedEpics = buildPayloadGuardrailEpics(snapshot, retainedStoryIds);
-    const includedStoryCount = Object.keys(projectedStories).length;
-    const includedEpicCount = Object.keys(projectedEpics).length;
-    const omittedStoryCount = Math.max(0, sourceStoryTotal(snapshot) - includedStoryCount);
-    const omittedEpicCount = Math.max(0, sourceEpicTotal(snapshot) - includedEpicCount);
-    const projectionMode = preserveProjectedStructuralStories
-        ? scope?.projectionMode ?? 'structural-required'
-        : scope?.projectionMode === 'yolo-story'
-            ? 'yolo-story'
-            : 'summary-only';
-    const nextScope = {
-        kind: 'projected',
-        commandId: scope?.commandId ?? null,
-        stateProjectionPolicy: scope?.stateProjectionPolicy ?? null,
-        projectionMode,
-        targetEpicId: scope?.targetEpicId ?? null,
-        targetStoryId: scope?.targetStoryId ?? null,
-        ...(scope?.targetEpicCoverage ? { targetEpicCoverage: scope.targetEpicCoverage } : {}),
-        includedStoryCount,
-        includedEpicCount,
-        omittedStoryCount,
-        omittedEpicCount,
-        reason: 'body-size',
-        reasonCodes: safeReasonCodes(scope?.reasonCodes, [
-            'payload-size-guardrail',
-            retainedStoryIds.size > 0 ? 'structural-targets-preserved' : 'stories-omitted',
-            'epics-stubbed',
-            'state-summary-preserved',
-            'redundant-trigger-omitted',
-        ]),
-    };
-    const stateSummary = updateStateSummaryForPayloadGuardrail(snapshot, nextScope);
-    return {
-        ...snapshot,
-        stories: projectedStories,
-        epics: projectedEpics,
-        scope: nextScope,
-        ...(stateSummary ? { stateSummary } : {}),
-    };
-}
-/**
- * Return a request-scoped state snapshot for invoke commands.
- *
- * The function is intentionally pure. Structural uncertainty fails closed;
- * callers must surface the public code instead of sending a full-state fallback.
- */
-export function projectStateSnapshotForInvoke(args, snapshot) {
-    const trigger = args.trim();
-    const commandPolicy = resolveCommandProjectionPolicy(trigger);
-    try {
-        if (!commandPolicy) {
-            if (firstTokenIsStoryReference(trigger)) {
-                const storyReferencePolicy = policy('story-reference', 'story-targeted');
-                const targetStoryId = extractStoryId(trigger);
-                if (targetStoryId) {
-                    return buildStoryProjection(trigger, snapshot, storyReferencePolicy, targetStoryId, 'targeted-story', ['story-reference-targeted']);
-                }
-            }
-            return buildSummaryOnlyProjection(trigger, snapshot, policy('unknown', 'adaptive-targeted'), ['unknown-command-summary-only']);
-        }
-        if (commandPolicy.stateProjectionPolicy === 'epic-summary') {
-            return buildCreateEpicProjection(trigger, snapshot, commandPolicy);
-        }
-        if (commandPolicy.stateProjectionPolicy === 'yoloop-targeted') {
-            return buildYoloopProjection(trigger, snapshot, commandPolicy);
-        }
-        const targetStoryId = extractStoryId(trigger);
-        if (commandPolicy.stateProjectionPolicy === 'story-targeted') {
-            if (targetStoryId) {
-                const invocationShape = classifyInvocationShapeV2({ commandId: commandPolicy.commandId, targetStoryId });
-                const yoloStory = invocationShape === 'yolo-story';
-                return buildStoryProjection(trigger, snapshot, commandPolicy, targetStoryId, yoloStory ? 'yolo-story' : commandPolicy.structuralRequired ? 'structural-required' : 'targeted-story', [yoloStory ? 'yolo-story' : commandPolicy.structuralRequired ? 'structural-required' : 'targeted-story']);
-            }
-            if (commandPolicy.commandId === 'yolo' || commandPolicy.commandId === 'yolo-inline') {
-                const invocationShape = classifyInvocationShapeV2({ commandId: commandPolicy.commandId });
-                return buildSummaryOnlyProjection(trigger, snapshot, commandPolicy, ['yolo-inline', 'stories-omitted', 'historical-content-omitted'], invocationShape ?? 'yolo-inline');
-            }
-            // Commit without a story is an exact root working-tree workflow. It
-            // needs no story graph, but a malformed or unknown target must not gain
-            // this summary-only escape from structural target validation.
-            if (commandPolicy.commandId === 'commit' && /^\*?(?:commit|commit-push)$/i.test(trigger)) {
-                return buildSummaryOnlyProjection(trigger, snapshot, commandPolicy, ['working-tree-commit', 'stories-omitted', 'historical-content-omitted']);
-            }
-            return commandPolicy.structuralRequired
-                ? (() => {
-                    throw new StructuralDagError('STRUCTURAL_TARGET_NOT_FOUND', {
-                        stories: Object.keys(snapshot.stories).length,
-                        epics: Object.keys(snapshot.epics).length,
-                        targetKind: 'story',
-                    });
-                })()
-                : buildSummaryOnlyProjection(trigger, snapshot, commandPolicy, ['story-target-missing-summary-only']);
-        }
-        if (commandPolicy.stateProjectionPolicy === 'adaptive-targeted') {
-            if (targetStoryId && snapshot.stories[targetStoryId]) {
-                return buildStoryProjection(trigger, snapshot, commandPolicy, targetStoryId, 'targeted-story', ['adaptive-story-targeted']);
-            }
-            const targetEpicId = extractTargetEpicId(trigger, snapshot);
-            if (targetEpicId) {
-                return buildTargetedEpicProjection(trigger, snapshot, commandPolicy, targetEpicId, 'targeted-epic', ['adaptive-epic-targeted']);
-            }
-            return buildSummaryOnlyProjection(trigger, snapshot, commandPolicy, ['adaptive-summary-only', 'target-unresolved-summary-only']);
-        }
-        if (commandPolicy.stateProjectionPolicy === 'epic-targeted') {
-            // The root *arch-plan pipeline delegates its current stage with the
-            // internal marker `epic-arch`. It has no user-selected epic yet; keep
-            // this exact marker only when the bounded root checkpoint names the
-            // same stage. The server still verifies the accounting receipt.
-            if (commandPolicy.commandId.startsWith('arch-')
-                && /(?:^|\s)epic-arch\s*$/i.test(trigger)
-                && snapshot.archPlan?.execution?.currentStageCommand === commandPolicy.commandId) {
-                return buildSummaryOnlyProjection(trigger, snapshot, commandPolicy, ['architecture-root-delegated']);
-            }
-            const targetEpicId = extractTargetEpicId(trigger, snapshot);
-            if (targetEpicId) {
-                return buildTargetedEpicProjection(trigger, snapshot, commandPolicy, targetEpicId, commandPolicy.structuralRequired ? 'structural-required' : 'targeted-epic', [commandPolicy.structuralRequired ? 'structural-required' : 'targeted-epic']);
-            }
-            return commandPolicy.structuralRequired
-                ? (() => {
-                    throw new StructuralDagError('STRUCTURAL_TARGET_NOT_FOUND', {
-                        stories: Object.keys(snapshot.stories).length,
-                        epics: Object.keys(snapshot.epics).length,
-                        targetKind: 'epic',
-                    });
-                })()
-                : buildSummaryOnlyProjection(trigger, snapshot, commandPolicy, ['epic-target-missing-summary-only']);
-        }
-        if (commandPolicy.stateProjectionPolicy === 'continuity-scoped') {
-            return buildSummaryOnlyProjection(trigger, snapshot, commandPolicy, ['continuity-scoped-summary-only']);
-        }
-        return buildSummaryOnlyProjection(trigger, snapshot, commandPolicy, ['policy-full-summary-only']);
-    }
-    catch (error) {
-        if (error instanceof StructuralDagError)
-            throw error;
-        if (commandPolicy?.structuralRequired) {
-            throw new StructuralDagError('STRUCTURAL_DEPENDENCY_MISSING', {
-                stories: Object.keys(snapshot.stories).length,
-                epics: Object.keys(snapshot.epics).length,
-                projectionErrors: 1,
-            });
-        }
-        return buildSummaryOnlyProjection(trigger, snapshot, commandPolicy ?? policy('unknown', 'adaptive-targeted'), ['projection-error-summary-only']);
-    }
-}
-const V2_INVOCATION_SHAPES = new Set([
-    'yolo-story',
-    'yolo-inline',
-    'yoloop-target',
-    'yoloop-session',
-    'yoloop-discovery',
-]);
-function projectedEdgeCount(snapshot) {
-    let edges = 0;
-    for (const collection of [snapshot.stories, snapshot.epics]) {
-        for (const entry of Object.values(collection)) {
-            if (Array.isArray(entry.depends_on)) {
-                edges += entry.depends_on.filter((value) => typeof value === 'string').length;
-            }
-        }
-    }
-    return edges;
-}
-/**
- * Versioned result contract for the five structural YOLO/yoloop shapes.
- * Other command families retain their existing projection policy and return
- * null because they are outside StateProjectionV2's closed shape union.
- */
-export function projectStateSnapshotResultV2ForInvoke(args, snapshot) {
-    const commandPolicy = resolveCommandProjectionPolicy(args.trim());
-    if (!commandPolicy
-        || !['yolo', 'yolo-inline', 'yoloop'].includes(commandPolicy.commandId)) {
-        return null;
-    }
-    try {
-        const projected = projectStateSnapshotForInvoke(args, snapshot);
-        const shape = projected.scope?.projectionMode;
-        if (!shape || !V2_INVOCATION_SHAPES.has(shape)) {
-            throw new StructuralDagError('STRUCTURAL_DEPENDENCY_MISSING', {
-                stories: Object.keys(projected.stories).length,
-                epics: Object.keys(projected.epics).length,
-                projectionShapeErrors: 1,
-            });
-        }
-        return Object.freeze({
-            ok: true,
-            version: 2,
-            shape,
-            snapshot: projected,
-            included: {
-                epics: projected.scope?.includedEpicCount ?? Object.keys(projected.epics).length,
-                stories: projected.scope?.includedStoryCount ?? Object.keys(projected.stories).length,
-                edges: projectedEdgeCount(projected),
-            },
-            omitted: {
-                epics: projected.scope?.omittedEpicCount ?? 0,
-                stories: projected.scope?.omittedStoryCount ?? 0,
-            },
-            cycleCount: 0,
-        });
-    }
-    catch (error) {
-        if (!(error instanceof StructuralDagError))
-            throw error;
-        return Object.freeze({
-            ok: false,
-            code: error.code,
-            publicDetails: error.publicDetails,
-        });
-    }
-}
+import{createHash as B}from"node:crypto";import{analyzeDependencyDag as C,StructuralDagError as y}from"./structural-dag-projection.js";import{classifyInvocationShapeV2 as O}from"./invocation-shape.js";const U=12,J=16,k=["active","archived","rolled-back","synthetic","orphan"],X=new Set(["in-progress","branch-ready","diagnose","research","write-spec","create-tasks","implemented","refactor-suggest-done","property-tests-emitted","tests-validated","qa-gate-passed","memory-updated","committed","synced","pr-created","pr-reviewed","partial"]);function Q(r){return r==="STRUCTURAL_TARGET_NOT_FOUND"?"registration-missing":r==="STRUCTURAL_DEPENDENCY_CYCLE"?"dependency-cycle":"dependency-missing"}function Fe(r){const e=/^[a-f0-9]{64}$/,t=/^P[1-9][0-9]*(?:\.[0-9]+)*$/,i=/^[A-Za-z0-9][A-Za-z0-9._/-]{0,239}$/;if(r.schemaVersion!=="EpicOperationalPublicProjection/1.0"||!e.test(r.repositoryFingerprint)||!e.test(r.identityHash)||!t.test(r.epicId)||!i.test(r.executionBranch)||!e.test(r.graphRevision)||!Number.isSafeInteger(r.storeRevision)||r.storeRevision<0||!Number.isSafeInteger(r.writerEpoch)||r.writerEpoch<1||r.runId!==null&&r.runId.length>128||r.runStatus!==null&&r.runStatus.length>32||r.runRevision!==null&&(!Number.isSafeInteger(r.runRevision)||r.runRevision<0)||r.snapshotHash!==null&&!e.test(r.snapshotHash)||!e.test(r.continuationSessionHash)||!e.test(r.pendingAuthorityHash)||!Number.isSafeInteger(r.pendingAuthorityCount)||r.pendingAuthorityCount<0||r.pendingAuthorityCount>1024||r.reasonCodes.length>16||r.reasonCodes.some(c=>!/^[a-z0-9][a-z0-9-]{0,79}$/.test(c))||r.publicSafe!==!0)throw new Error("epic-operational-projection-invalid");return Object.freeze({schemaVersion:r.schemaVersion,repositoryFingerprint:r.repositoryFingerprint,identityHash:r.identityHash,epicId:r.epicId,executionBranch:r.executionBranch,graphRevision:r.graphRevision,storeRevision:r.storeRevision,writerEpoch:r.writerEpoch,runId:r.runId,runStatus:r.runStatus,runRevision:r.runRevision,snapshotHash:r.snapshotHash,continuationSessionHash:r.continuationSessionHash,pendingAuthorityHash:r.pendingAuthorityHash,pendingAuthorityCount:r.pendingAuthorityCount,lockActive:r.lockActive,currentSessionActive:r.currentSessionActive,journalActive:r.journalActive,reasonCodes:[...r.reasonCodes],publicSafe:!0})}const o=(r,e,t={})=>({commandId:r,stateProjectionPolicy:e,...t}),A=Object.freeze({status:o("status","full"),"arch-plan":o("arch-plan","full"),"arch-prd":o("arch-prd","full"),"arch-architecture":o("arch-architecture","epic-targeted",{structuralRequired:!0}),"arch-api-contracts":o("arch-api-contracts","epic-targeted",{structuralRequired:!0}),"arch-api-integrations":o("arch-api-integrations","epic-targeted",{structuralRequired:!0}),"arch-database":o("arch-database","epic-targeted",{structuralRequired:!0}),"arch-security":o("arch-security","epic-targeted",{structuralRequired:!0}),"arch-design-system":o("arch-design-system","epic-targeted",{structuralRequired:!0}),"arch-ux-design":o("arch-ux-design","epic-targeted",{structuralRequired:!0}),"arch-performance":o("arch-performance","epic-targeted",{structuralRequired:!0}),"arch-testing":o("arch-testing","epic-targeted",{structuralRequired:!0}),"arch-infrastructure":o("arch-infrastructure","epic-targeted",{structuralRequired:!0}),"arch-review":o("arch-review","epic-targeted",{structuralRequired:!0}),"arch-fitness-functions":o("arch-fitness-functions","epic-targeted",{structuralRequired:!0}),"create-epic":o("create-epic","epic-summary"),"idea-diagnose":o("idea-diagnose","full"),"idea-research":o("idea-research","epic-targeted",{structuralRequired:!0}),"generate-epic":o("generate-epic","epic-targeted",{structuralRequired:!0}),exec:o("exec","story-targeted",{structuralRequired:!0}),yolo:o("yolo","story-targeted",{structuralRequired:!0}),"yolo-inline":o("yolo-inline","story-targeted",{structuralRequired:!0}),epic:o("epic","epic-targeted",{structuralRequired:!0}),"setup-branch":o("setup-branch","story-targeted",{structuralRequired:!0}),diagnose:o("diagnose","adaptive-targeted"),"diagnose-inline":o("diagnose-inline","full"),research:o("research","adaptive-targeted"),"research-inline":o("research-inline","full"),"write-spec":o("write-spec","story-targeted",{structuralRequired:!0}),"create-tasks":o("create-tasks","story-targeted",{structuralRequired:!0}),implement:o("implement","story-targeted",{structuralRequired:!0}),commit:o("commit","story-targeted",{structuralRequired:!0}),"commit-push":o("commit","story-targeted",{structuralRequired:!0}),sync:o("sync","story-targeted",{structuralRequired:!0}),"sync-main":o("sync","story-targeted",{structuralRequired:!0}),"create-pr":o("create-pr","story-targeted",{structuralRequired:!0}),review:o("review","story-targeted"),"review-pr":o("review","story-targeted"),merge:o("merge","story-targeted",{structuralRequired:!0}),"merge-pr":o("merge","story-targeted",{structuralRequired:!0}),"fix-blocked":o("fix-blocked","story-targeted"),"finalize-epic":o("finalize-epic","epic-targeted"),"resolve-conflicts":o("resolve-conflicts","story-targeted"),"update-memory":o("update-memory","full"),"update-project-memory":o("update-memory","story-targeted",{structuralRequired:!0}),refactor:o("refactor","adaptive-targeted"),"refactor-suggest":o("refactor","story-targeted",{structuralRequired:!0}),cleanup:o("cleanup","full"),audit:o("audit","full"),"tech-debt":o("tech-debt","full"),menu:o("menu","full"),plans:o("plans","full"),billing:o("billing","full"),subscribe:o("subscribe","full"),"qa-scan":o("qa-scan","full"),yoloop:o("yoloop","yoloop-targeted",{structuralRequired:!0}),"migrate-state":o("migrate-state","full"),"migrate-project-id":o("migrate-project-id","full"),"policy-audit":o("policy-audit","full"),"mutation-test":o("mutation-test","full"),"sync-openapi":o("sync-openapi","full"),"generate-pacts":o("generate-pacts","full"),"verify-pacts":o("verify-pacts","full"),"property-test":o("property-test","full"),"property-tests":o("property-test","story-targeted",{structuralRequired:!0}),"chaos-plan":o("chaos-plan","full"),"ui-ux-review":o("ui-ux-review","adaptive-targeted"),"solyd-system":o("solyd-system","adaptive-targeted"),goal:o("goal","continuity-scoped"),loop:o("loop","continuity-scoped"),jobs:o("jobs","continuity-scoped"),runner:o("runner","continuity-scoped"),"goal-tick":o("goal-tick","continuity-scoped"),"loop-tick":o("loop-tick","continuity-scoped"),"validate-tests":o("validate-tests","story-targeted",{structuralRequired:!0}),"qa-gate":o("qa-gate","story-targeted",{structuralRequired:!0})}),ee=Object.freeze({st:"status",arquitetura:"arch-plan",architecture:"arch-plan",arch:"arch-plan",prd:"arch-prd","product-requirements":"arch-prd","arch-doc":"arch-architecture","tech-architecture":"arch-architecture","api-contracts":"arch-api-contracts","api-contract":"arch-api-contracts","api-integrations":"arch-api-integrations","api-int":"arch-api-integrations","database-schema":"arch-database","db-schema":"arch-database",db:"arch-database","cyber-security":"arch-security",security:"arch-security",sec:"arch-security","design-system":"arch-design-system",ds:"arch-design-system","atomic-design":"arch-design-system","ux-design":"arch-ux-design",ux:"arch-ux-design",wireframes:"arch-ux-design",wireframe:"arch-ux-design","user-flows":"arch-ux-design",performance:"arch-performance",perf:"arch-performance","capacity-planning":"arch-performance",capacity:"arch-performance","arch-perf":"arch-performance","performance-strategy":"arch-performance","testing-strategy":"arch-testing","test-plan":"arch-testing","test-strategy":"arch-testing","arch-test":"arch-testing",infrastructure:"arch-infrastructure",infra:"arch-infrastructure","deploy-plan":"arch-infrastructure",deployment:"arch-infrastructure","arch-infra":"arch-infrastructure","arch-deploy":"arch-infrastructure","review-consolidation":"arch-review",consolidation:"arch-review","architecture-review":"arch-review","arch-consolidation":"arch-review",fitness:"arch-fitness-functions","fitness-functions":"arch-fitness-functions",archfit:"arch-fitness-functions","arch-fit":"arch-fitness-functions","fit-funcs":"arch-fitness-functions","criar-epic":"create-epic",planejamento:"create-epic","idea-diag":"idea-diagnose","idea-pesq":"idea-research","gerar-epic":"generate-epic",executar:"exec",pipeline:"exec","parallel-epic":"epic",setup:"setup-branch",branch:"setup-branch",diag:"diagnose",diagnostico:"diagnose",c02:"diagnose",pesquisar:"research",pesq:"research","research-fix":"research",c03:"research",spec:"write-spec",especificacao:"write-spec",c04:"write-spec",tasks:"create-tasks",tarefas:"create-tasks",c05:"create-tasks",impl:"implement",implementar:"implement",c06:"implement",push:"commit",commit_push:"commit",cp:"commit",c07:"commit",sincronizar:"sync",c08:"sync",pr:"create-pr",c09:"create-pr",revisar:"review",c11:"review",mesclar:"merge",c12:"merge",fix:"fix-blocked",corrigir:"fix-blocked",finalizar:"finalize-epic",conflitos:"resolve-conflicts",memoria:"update-memory",refactoring:"refactor",refact:"refactor",refac:"refactor",rf:"refactor","cleanup-code":"refactor","code-cleanup":"refactor","code-quality":"refactor","improve-code":"refactor",modernize:"refactor",modernization:"refactor",legacy:"refactor","legacy-code":"refactor","debt-pay":"refactor","pay-debt":"refactor","debt-reduction":"refactor","smell-fix":"refactor","fix-smells":"refactor","code-smells":"refactor",strangler:"refactor","strangler-fig":"refactor",limpar:"cleanup",limpeza:"cleanup",auditar:"audit",auditoria:"audit",debt:"tech-debt",debts:"tech-debt","debt-list":"tech-debt","tech-debts":"tech-debt",td:"tech-debt",help:"menu",ajuda:"menu","?":"menu",commands:"menu",cmds:"menu",planos:"plans",pricing:"plans",bill:"billing",subscription:"billing",sub:"billing",upgrade:"subscribe",checkout:"subscribe",qa:"qa-scan","qa-test":"qa-scan","visual-qa":"qa-scan","e2e-scan":"qa-scan",troubleshoot:"qa-scan","debug-ui":"qa-scan",scan:"qa-scan",a11y:"qa-scan",accessibility:"qa-scan",wcag:"qa-scan","auto-yolo":"yoloop","epic-runner":"yoloop","story-runner":"yoloop","loop-yolo":"yoloop","auto-epic":"yoloop",migrate:"migrate-state","state-migrate":"migrate-state","schema-migrate":"migrate-state",policy:"policy-audit","audit-policy":"policy-audit","policy-history":"policy-audit",policies:"policy-audit",mutation:"mutation-test",stryker:"mutation-test","kill-mutants":"mutation-test","openapi-sync":"sync-openapi","api-sync":"sync-openapi","spec-sync":"sync-openapi","regen-openapi":"sync-openapi",pacts:"generate-pacts","gen-pacts":"generate-pacts","regen-pacts":"generate-pacts","create-pacts":"generate-pacts","verify-pact":"verify-pacts","pact-verify":"verify-pacts","check-pacts":"verify-pacts","pact-check":"verify-pacts",property:"property-test",pbt:"property-test",proptest:"property-test","invariant-test":"property-test",chaos:"chaos-plan",gameday:"chaos-plan","resilience-test":"chaos-plan","ux-review":"ui-ux-review","design-review":"ui-ux-review","visual-review":"ui-ux-review","product-polish":"ui-ux-review","security-system":"solyd-system","authorized-security":"solyd-system","sec-system":"solyd-system",goals:"goal","durable-goal":"goal","continuity-goal":"goal",loops:"loop","durable-loop":"loop","continuity-loop":"loop",job:"jobs","continuity-jobs":"jobs","neocortex-runner":"runner","continuity-runner":"runner"}),te=Object.freeze({1:"status",3:"arch-plan",4:"arch-prd",5:"arch-architecture",6:"arch-api-contracts",7:"arch-api-integrations",8:"arch-database",9:"arch-security",10:"arch-design-system",11:"arch-ux-design",12:"arch-performance",13:"arch-testing",14:"arch-infrastructure",15:"arch-review",16:"arch-fitness-functions",17:"create-epic",18:"idea-diagnose",19:"idea-research",20:"generate-epic",21:"exec",22:"yolo",23:"epic",24:"setup-branch",25:"diagnose",26:"research",27:"write-spec",28:"create-tasks",29:"implement",30:"commit",31:"sync",32:"create-pr",33:"review",34:"merge",35:"fix-blocked",36:"finalize-epic",37:"resolve-conflicts",38:"update-memory",39:"refactor",40:"cleanup",41:"audit",42:"tech-debt",43:"menu",44:"plans",45:"billing",46:"subscribe",47:"qa-scan",48:"yoloop",49:"migrate-state",50:"policy-audit",51:"mutation-test",52:"sync-openapi",53:"generate-pacts",54:"verify-pacts",55:"property-test",56:"chaos-plan",57:"ui-ux-review",58:"solyd-system",59:"goal",60:"loop",61:"jobs",62:"runner"});function d(r,e=120){if(typeof r!="string")return;const t=r.trim();if(t)return t.replace(/[^a-z0-9_.:-]+/gi,"_").slice(0,e)}function T(r,e=120){if(typeof r!="string")return;const t=r.trim(),i=d(r,e);return i===t?i:void 0}function w(r){if(typeof r!="string")return;const e=r.trim();if(!(!e||e.length>240||!/^[A-Za-z0-9][A-Za-z0-9._/-]*$/.test(e)||e.includes("..")||e.includes("//")||e.includes("@{")||e.endsWith("/")||e.endsWith(".")||e.split("/").some(t=>!t||t.startsWith(".")||t.endsWith(".lock"))))return e}function re(r){if(typeof r!="string")return;const e=r.replace(/\\/g,"/");if(!(!e||e.length>240||e.startsWith("/")||/^[A-Za-z]:/.test(e)||e.includes("..")||e.includes("//")||e.split("/").includes(".")||!/^[A-Za-z0-9._/:@#-]+$/.test(e)))return e}function S(r){if(r===void 0||!Array.isArray(r)||r.length>128)return;const e=r.map(re);if(!e.some(t=>t===void 0))return[...new Set(e)].sort((t,i)=>t.localeCompare(i,"en"))}function ie(r){return typeof r=="string"&&X.has(r.trim().toLowerCase().replace(/_/g,"-"))}function v(r,e){const t={};for(const i of e){const c=r[i];typeof c=="string"||typeof c=="boolean"||typeof c=="number"&&Number.isFinite(c)?t[i]=c:Array.isArray(c)&&c.every(n=>typeof n=="string")&&(t[i]=[...c])}return t}function ce(r,e){const t=e.checkpoint;if(!h(t)||t.schemaVersion!==1||t.storyId!==r||t.epicId!==e.epic_id||!w(t.branch)||typeof t.baseSha!="string"||!/^[0-9a-f]{7,64}$/i.test(t.baseSha)||typeof t.headSha!="string"||!/^[0-9a-f]{7,64}$/i.test(t.headSha)||t.baseSha===t.headSha||!T(t.idempotencyKey)||typeof t.recordedAt!="string"||!Number.isFinite(Date.parse(t.recordedAt))||!Array.isArray(t.commits)||t.commits.length===0||t.commits.length>256||t.commits.some(c=>typeof c!="string"||!/^[0-9a-f]{7,64}$/i.test(c))||!Array.isArray(t.receiptRefs)||t.receiptRefs.length===0||t.receiptRefs.length>256||t.receiptRefs.some(c=>typeof c!="string"||c.length>240||c.includes("..")||!/^[A-Za-z0-9._:/#\-[\]]+$/.test(c))||!h(t.qaReceipt)||t.qaReceipt.kind!=="story_qa_evidence"||t.qaReceipt.producer!=="local-yolo-tdd"||!["passed","blocked"].includes(String(t.qaVerdict))||!["approved","changes-requested","pending"].includes(String(t.reviewVerdict))||(t.reviewVerdict==="pending"?t.reviewReceipt!==void 0:!h(t.reviewReceipt)))return;const i=v(t,["schemaVersion","storyId","epicId","branch","baseSha","headSha","idempotencyKey","dispatchId","bundleId","bundleDigest","graphRevision","claimRevision","qaVerdict","reviewVerdict","recordedAt","commits","receiptRefs"]);return i.qaReceipt=v(t.qaReceipt,["schemaVersion","kind","producer","evidenceVersion","storyId","epicId","contract","command","manifestDigest","gateIds","resultDigest","baseSha","headSha","bundleDigest","graphRevision","sourceEvidenceDigest","verdict","checkedAt","receiptRef"]),h(t.reviewReceipt)&&(i.reviewReceipt=v(t.reviewReceipt,["schemaVersion","kind","producer","storyId","epicId","baseSha","headSha","bundleDigest","graphRevision","sourceEvidenceDigest","qaReceiptRef","verdict","reviewedAt","receiptRef"])),i}function ne(r,e){const t=e.checkpoint_verification;if(!(!h(t)||t.schemaVersion!==1||t.kind!=="story_checkpoint_physical_verification"||t.producer!=="client-p205-transient-v1"||t.publicSafe!==!0||t.storyId!==r||t.epicId!==e.epic_id||!["verified","rejected"].includes(String(t.verdict))))return v(t,["schemaVersion","kind","producer","storyId","epicId","branch","baseSha","headSha","aggregateHeadSha","commitBodyDigest","changedPathsDigest","claimVerification","effectiveClaimRevision","command","manifestDigest","gateIds","resultDigest","graphRevision","executionEvidenceDigest","sourceEvidenceDigest","verifiedAt","verdict","reasonCodes","publicSafe"])}function M(r,e){const t=e.scheduling_checkpoint_evidence,i=new Set(["schemaVersion","kind","producer","storyId","epicId","branch","baseSha","headSha","graphRevision","effectiveClaimRevision","sourceEvidenceDigest","verifiedAt","reasonCodes","integrationAuthorized","publicSafe"]);if(!(!h(t)||Object.keys(t).some(c=>!i.has(c))||t.schemaVersion!==1||t.kind!=="story_scheduling_checkpoint_evidence"||t.producer!=="client-git-physical-v1"||t.publicSafe!==!0||t.integrationAuthorized!==!1||t.storyId!==r||t.epicId!==e.epic_id||!w(t.branch)||typeof t.baseSha!="string"||!/^[0-9a-f]{40,64}$/i.test(t.baseSha)||typeof t.headSha!="string"||!/^[0-9a-f]{40,64}$/i.test(t.headSha)||typeof t.graphRevision!="string"||!/^[0-9a-f]{64}$/i.test(t.graphRevision)||typeof t.effectiveClaimRevision!="string"||!/^[0-9a-f]{64}$/i.test(t.effectiveClaimRevision)||typeof t.sourceEvidenceDigest!="string"||!/^[0-9a-f]{64}$/i.test(t.sourceEvidenceDigest)||typeof t.verifiedAt!="string"||!Number.isFinite(Date.parse(t.verifiedAt))||!Array.isArray(t.reasonCodes)||t.reasonCodes.length!==1||t.reasonCodes[0]!=="checkpoint-git-scheduling-verified"))return v(t,[...i])}function oe(r,e){const t={...e},i=M(r,e);return i?(t.scheduling_checkpoint_evidence=i,delete t.checkpoint,delete t.checkpoint_verification):delete t.scheduling_checkpoint_evidence,t}function h(r){return r!==null&&typeof r=="object"&&!Array.isArray(r)}function _(...r){const e=new Set,t=[];for(const i of r)for(const c of i??[]){const n=d(c,80);if(!(!n||e.has(n))&&(e.add(n),t.push(n),t.length>=J))return t}return t}function se(r){return r.trim().replace(/^@?\*/,"").replace(/^@/,"").toLowerCase()}function ae(r){return r.trim().split(/\s+/,1)[0]??""}function z(r){if(/^@epic-P[0-9]{1,12}$/.test(r.trim()))return A.epic;const e=ae(r);if(!e)return A.menu;const t=se(e),i=te[t]??ee[t]??t;return A[i]??null}function de(r,e,t,i="full-compatible",c=["full-state"]){return{kind:"full",commandId:t?.commandId??null,stateProjectionPolicy:t?.stateProjectionPolicy??null,projectionMode:i,trigger:r,targetEpicId:null,targetStoryId:null,includedStoryCount:Object.keys(e.stories).length,includedEpicCount:Object.keys(e.epics).length,omittedStoryCount:0,omittedEpicCount:0,reason:"full-state",reasonCodes:_(c)}}function Le(r,e,t,i="full-compatible",c=["full-state"]){const n=de(r,e,t,i,c);return I({...e,scope:n},e,n)}function ue(r){const[e]=r.trim().split(/\s+/,1);return e?/^[A-Z]?\d+(?:\.\d+)+$/i.test(e.replace(/^@/,""))||/(?:^|\/)[A-Z]?\d+(?:\.\d+)+\.story\.md$/i.test(e.replace(/^@/,"")):!1}function F(r){const e=r.match(/(?:^|[/@\s])([A-Z]?\d+(?:\.\d+)+)\.story\.md\b/i);return e?.[1]?e[1]:r.match(/(?:^|\s|@)([A-Z]?\d+(?:\.\d+)+)(?=$|\s)/i)?.[1]??null}function le(r){const e=r.trim(),t=e.search(/\s/);return t===-1?"":e.slice(t).trim()}function q(r){return le(r).split(/\s+/).map(e=>e.replace(/^@/,"").replace(/^['"]|['"]$/g,"")).filter(e=>e.length>0&&!e.startsWith("-"))}function $e(r){return q(r)[0]??null}function P(r,e){const i=r.replace(/^@/,"").replace(/^epic-/i,"").replace(/\.md$/i,""),c=[i,i.toUpperCase(),/^p\d+$/i.test(i)?`P${i.replace(/^p/i,"")}`:null,/^\d+$/.test(i)?`P${i}`:null].filter(n=>typeof n=="string"&&n.length>0);for(const n of c)if(e.epics[n])return n;return null}function pe(r,e){const t=r.match(/(?:^|[/@\s])epic-(P?\d+)\.md\b/i);return t?.[1]?P(t[1],e):null}function R(r,e){const t=r.trim().match(/^@epic-(P[0-9]{1,12})$/);if(t)return P(t[1],e);const i=pe(r,e);if(i)return i;for(const c of q(r)){if(/^[A-Z]?\d+(?:\.\d+)+$/i.test(c))continue;const n=P(c,e);if(n)return n}return null}function fe(r,e){const t=R(r,e);if(t)return t;const i=e.yoloop,c=i?.state?.currentSession?.currentEpicId;if(typeof c=="string"&&e.epics[c])return c;const n=i?.lock?.currentEpicId??i?.lock?.epicId;return typeof n=="string"&&e.epics[n]?n:null}function ye(r){const e=r.match(/(?:^|[/@\s])epic-(P?\d+)\.md\b/i)?.[1];if(e)return/^P/i.test(e)?e.toUpperCase():`P${e}`;for(const t of q(r)){if(/^P\d+$/i.test(t))return t.toUpperCase();if(/^\d+$/.test(t))return`P${t}`}return null}function j(r,e){if(typeof r.epic_id=="string"&&r.epic_id.length>0)return r.epic_id;const t=e.split(".").slice(0,-1).join(".");return t.length>0?t:null}function L(r){return typeof r=="string"&&["done","completed","merged","cancelled","canceled","abandoned"].includes(r.toLowerCase())}function x(r,e,t){if(t.has(r))return;const i=e.stories[r];if(!i)return;t.add(r);const c=i.depends_on;if(Array.isArray(c))for(const n of c)typeof n=="string"&&x(n,e,t)}function me(r,e){const t=C(e.stories,[r]),i={};for(const c of t.orderedIds){const n=e.stories[c];n&&(i[c]=n)}return i}function $(r,e,t=[]){const i={};for(const c of t)e.epics[c]&&(i[c]=e.epics[c]);for(const[c,n]of Object.entries(r)){const s=j(n,c);s&&e.epics[s]&&(i[s]=e.epics[s])}return i}function ge(r,e,t){if(t.has(r))return;const i=e.epics[r];if(!i)return;t.add(r);const c=i.depends_on;if(Array.isArray(c))for(const n of c)typeof n=="string"&&n.length>0&&ge(n,e,t)}function V(r,e,t){const i=C(t.epics,[r]),c=new Set(i.orderedIds);for(const[s,a]of Object.entries(e)){const u=j(a,s);u&&t.epics[u]&&c.add(u)}const n={};for(const s of[...c].sort((a,u)=>a.localeCompare(u,"en"))){const a=t.epics[s];a&&(n[s]=s===r?a:H(s,a))}return n}function G(r,e,t){const i=e.stories;if(!Array.isArray(i)||i.some(s=>typeof s!="string"||s.length===0))throw new y("STRUCTURAL_DEPENDENCY_MISSING",{nodes:0,edges:0,malformedStoryMemberships:1});const c=C(t.stories,i),n={};for(const s of c.orderedIds){const a=t.stories[s];a&&(n[s]=j(a,s)===r?oe(s,a):Y(s,a))}return n}function he(r,e,t){const i=[...e.stories].sort((s,a)=>s.localeCompare(a,"en")),c=Object.entries(t).filter(([s,a])=>j(a,s)===r).map(([s])=>s).sort((s,a)=>s.localeCompare(a,"en")),n=B("sha256").update(`target-epic-coverage-v1\0${JSON.stringify({targetEpicId:r,declaredStoryIds:i,includedStoryIds:c})}`).digest("hex");return{schemaVersion:"TargetEpicCoverage/1.0",targetEpicId:r,declaredStoryIds:i,includedStoryIds:c,membershipSha256:n,publicSafe:!0}}function Y(r,e){const t=Array.isArray(e.depends_on)?[...new Set(e.depends_on.filter(m=>typeof m=="string"&&m.length>0))].sort((m,E)=>m.localeCompare(E,"en")):[],i={id:d(e.id)??r,...d(e.epic_id)?{epic_id:d(e.epic_id)}:{},...d(e.status,40)?{status:d(e.status,40)}:{},depends_on:t},c=M(r,e);if(!ie(e.status))return{...i,...c?{scheduling_checkpoint_evidence:c}:{}};const n=e.source==="create-epic"||e.source==="discovered"?e.source:void 0,s=w(e.branch_name),a=T(e.last_step,120),u=Array.isArray(e.steps_completed)&&e.steps_completed.length<=64?e.steps_completed.map(m=>T(m,120)):[],l=u.length>0&&u.every(m=>m!==void 0)?u:void 0,f=typeof e.pr_number=="number"&&Number.isSafeInteger(e.pr_number)&&e.pr_number>0?e.pr_number:void 0,p=ce(r,e),g=p?ne(r,e):void 0;return{...i,...n?{source:n}:{},...s?{branch_name:s}:{},...a?{last_step:a}:{},...l?{steps_completed:l}:{},...f?{pr_number:f}:{},...p?{checkpoint:p}:{},...g?{checkpoint_verification:g}:{},...c?{scheduling_checkpoint_evidence:c}:{},...S(e.files_to_modify)!==void 0?{files_to_modify:S(e.files_to_modify)}:{},...S(e.contracts)!==void 0?{contracts:S(e.contracts)}:{},...S(e.contract_refs)!==void 0?{contract_refs:S(e.contract_refs)}:{},...S(e.shared_surfaces)!==void 0?{shared_surfaces:S(e.shared_surfaces)}:{}}}function H(r,e){const t=Array.isArray(e.stories)?[...new Set(e.stories.filter(c=>typeof c=="string"&&c.length>0))].sort((c,n)=>c.localeCompare(n,"en")):[],i=Array.isArray(e.depends_on)?[...new Set(e.depends_on.filter(c=>typeof c=="string"&&c.length>0))].sort((c,n)=>c.localeCompare(n,"en")):[];return{id:d(e.id)??r,...d(e.status,40)?{status:d(e.status,40)}:{},...d(e.lifecycle_classification,40)?{lifecycle_classification:d(e.lifecycle_classification,40)}:{},stories:t,depends_on:i}}function be(r,e,t){const i=C(e.stories),c=C(e.epics),n=Object.fromEntries(i.orderedIds.map(u=>[u,Y(u,e.stories[u])])),s=Object.fromEntries(c.orderedIds.map(u=>[u,H(u,e.epics[u])])),a={kind:"projected",commandId:t.commandId,stateProjectionPolicy:t.stateProjectionPolicy,projectionMode:"yoloop-discovery",trigger:r,targetEpicId:null,targetStoryId:null,includedStoryCount:i.orderedIds.length,includedEpicCount:c.orderedIds.length,omittedStoryCount:0,omittedEpicCount:0,reason:"targeted-invocation",reasonCodes:_(["structural-required","yoloop-discovery",`structural-edges-${i.edgeCount+c.edgeCount}`,"content-fields-omitted"])};return I({...e,stories:n,epics:s,scope:a},e,a)}function _e(r,e){const t=new Set,i=r.stories;if(Array.isArray(i))for(const n of i)typeof n=="string"&&x(n,e,t);const c={};for(const n of t){const s=e.stories[n];s&&(c[n]=s)}return c}function Se(r){const e={};for(const[t,i]of Object.entries(r.epics))e[t]={id:d(i.id)??t,...d(i.status)?{status:d(i.status)}:{},...k.includes(i.lifecycle_classification)?{lifecycle_classification:i.lifecycle_classification}:{},...typeof i.total_stories=="number"&&Number.isFinite(i.total_stories)?{total_stories:i.total_stories}:{},...typeof i.completed_stories=="number"&&Number.isFinite(i.completed_stories)?{completed_stories:i.completed_stories}:{}};return e}function K(r){const e={};for(const t of Object.values(r)){const i=d(t.status,40)??"unknown";e[i]=(e[i]??0)+1}return e}function je(r){const e=Object.fromEntries(k.map(t=>[t,0]));for(const t of Object.values(r)){const i=k.includes(t.lifecycle_classification)?t.lifecycle_classification:"active";e[i]=(e[i]??0)+1}return e}function N(r,e){if(!e)return!0;const t=r.epics[e];return t?!k.includes(t.lifecycle_classification)||t.lifecycle_classification==="active":!0}function Z(r){for(const e of["last_updated","updated_at","completed_at","created_at","discovered_at"]){const t=r[e];if(typeof t!="string")continue;const i=Date.parse(t);if(Number.isFinite(i))return i}return 0}function Ie(r){return Object.entries(r.stories).map(([e,t])=>({id:e,story:t,timestamp:Z(t)})).sort((e,t)=>t.timestamp-e.timestamp||e.id.localeCompare(t.id)).slice(0,U).map(({id:e,story:t})=>({id:e,...d(t.epic_id)?{epicId:d(t.epic_id)}:{},...d(t.status,40)?{status:d(t.status,40)}:{},...d(t.last_step??t.lastStep)?{lastStep:d(t.last_step??t.lastStep)}:{},...d(t.last_updated??t.updated_at??t.completed_at??t.created_at)?{lastUpdated:d(t.last_updated??t.updated_at??t.completed_at??t.created_at)}:{}}))}function Ce(r){const e=r.current_session;if(!e)return;const t={activeEpicId:d(e.active_epic_id)??null,activeStoryId:d(e.active_story_id)??null,activeStepId:d(e.active_step_id)??null,sessionId:d(e.session_id)??null,startedAt:d(e.started_at)??null};return Object.values(t).some(i=>i!=null)?t:void 0}function ke(r){const e=r.yoloop;if(!h(e))return;const t=h(e.state)?e.state:void 0,i=h(t?.currentSession)?t.currentSession:void 0,c=h(e.lock)?e.lock:void 0,n={...typeof e.active=="boolean"?{active:e.active}:{},currentEpicId:d(i?.currentEpicId??e.currentEpicId)??null,currentStoryId:d(i?.currentStoryId??e.currentStoryId)??null,sessionId:d(i?.sessionId??e.sessionId)??null,lockEpicId:d(c?.currentEpicId??c?.epicId)??null};return Object.keys(n).length>0?n:void 0}function ve(r){const e=r.continuity;if(!h(e))return;const t=Array.isArray(e.reasonCodes)?e.reasonCodes.filter(i=>typeof i=="string"):void 0;return{present:!0,activeJobId:d(e.activeJobId??e.jobId)??null,activeGoalId:d(e.activeGoalId??e.goalId)??null,activeLoopId:d(e.activeLoopId??e.loopId)??null,...t&&t.length>0?{reasonCodes:_(t)}:{}}}function Ee(r,e,t){const i=d(e?.activeStoryId),c=d(e?.activeEpicId),n=d(e?.activeStepId),s=i&&r.stories[i]?j(r.stories[i],i):null;if((i||c||n)&&N(r,c??s))return{epicId:c??null,storyId:i??null,stepId:n??null};const a=d(t?.currentStoryId),u=d(t?.currentEpicId??t?.lockEpicId);if((a||u)&&N(r,u))return{epicId:u??null,storyId:a??null,stepId:null};const l=Object.entries(r.stories).map(([f,p])=>({id:f,story:p,timestamp:Z(p)})).filter(({id:f,story:p})=>!L(p.status)&&N(r,j(p,f))).sort((f,p)=>p.timestamp-f.timestamp||f.id.localeCompare(p.id))[0];return l?{epicId:j(l.story,l.id),storyId:l.id,stepId:d(l.story.last_step??l.story.lastStep)??null}:{epicId:null,storyId:null,stepId:null}}function Re(r,e){const t=K(r.stories),i=K(r.epics),c=je(r.epics),n=Object.values(r.epics).filter(g=>(k.includes(g.lifecycle_classification)?g.lifecycle_classification:"active")==="active"&&!L(g.status)).length,s=Ce(r),a=ke(r),u=ve(r),l=Ee(r,s,a),f=Ie(r),p=_(e.reasonCodes,["state-summary-attached","state-summary-bounded",`projection-${e.projectionMode??e.kind}`,e.stateProjectionPolicy?`policy-${e.stateProjectionPolicy}`:"policy-unknown",f.length>=U?"recent-stories-capped":"recent-stories-bounded",l.storyId||l.epicId?"active-ref-derived":"active-ref-empty",a?"yoloop-session-present":"yoloop-session-absent",u?"continuity-session-present":"continuity-session-absent"]);return{schemaVersion:1,totals:{stories:Object.keys(r.stories).length,epics:Object.keys(r.epics).length,storyStatus:t,epicStatus:i,epicLifecycle:c,activeEpics:n,blockedStories:t.blocked??0},active:l,blockedCount:t.blocked??0,recentStories:f,...s?{currentSession:s}:{},...a?{currentYoloopSession:a}:{},...u?{currentContinuitySession:u}:{},projection:{commandId:e.commandId??null,stateProjectionPolicy:e.stateProjectionPolicy??null,projectionMode:e.projectionMode,scopeKind:e.kind,includedStoryCount:e.includedStoryCount,includedEpicCount:e.includedEpicCount??Object.keys(r.epics).length,omittedStoryCount:e.omittedStoryCount,omittedEpicCount:e.omittedEpicCount,reason:e.reason},reasonCodes:p,publicSafe:!0}}function I(r,e,t){return{...r,stateSummary:Re(e,t)}}function Oe(r,e,t){const i={};for(const n of Object.keys(e.epics))i[n]={id:n};const c={kind:"projected",commandId:t.commandId,stateProjectionPolicy:t.stateProjectionPolicy,projectionMode:"summary-only",trigger:r,targetEpicId:null,targetStoryId:null,includedStoryCount:0,includedEpicCount:Object.keys(i).length,omittedStoryCount:Object.keys(e.stories).length,omittedEpicCount:0,reason:"epic-summary",reasonCodes:["epic-summary","stories-omitted","epic-stubs-only"]};return I({...e,stories:{},epics:i,scope:c},e,c)}function b(r,e,t,i=["summary-only","stories-omitted"],c="summary-only"){const n=Se(e),s={kind:"projected",commandId:t.commandId,stateProjectionPolicy:t.stateProjectionPolicy,projectionMode:c,trigger:r,targetEpicId:null,targetStoryId:null,includedStoryCount:0,includedEpicCount:Object.keys(n).length,omittedStoryCount:Object.keys(e.stories).length,omittedEpicCount:Math.max(0,Object.keys(e.epics).length-Object.keys(n).length),reason:"summary-only",reasonCodes:_(i)};return I({...e,stories:{},epics:n,scope:s},e,s)}function D(r,e,t,i,c,n){const s=e.stories[i];if(!s)throw new y("STRUCTURAL_TARGET_NOT_FOUND",{stories:Object.keys(e.stories).length,epics:Object.keys(e.epics).length,targetKind:"story"});const a=j(s,i);if(!a)throw new y("STRUCTURAL_TARGET_NOT_FOUND",{stories:Object.keys(e.stories).length,epics:Object.keys(e.epics).length,targetKind:"epic"});const u=e.epics[a];if(!u)throw new y("STRUCTURAL_TARGET_NOT_FOUND",{stories:Object.keys(e.stories).length,epics:Object.keys(e.epics).length,targetKind:"epic"});const l=c==="yolo-story",f=l?G(a,u,e):me(i,e),p=l?V(a,f,e):$(f,e);if(!f[i]||!p[a])throw new y("STRUCTURAL_TARGET_NOT_FOUND",{stories:Object.keys(f).length,epics:Object.keys(p).length,targetKind:"story"});const g={kind:"projected",commandId:t.commandId,stateProjectionPolicy:t.stateProjectionPolicy,projectionMode:c,trigger:r,targetEpicId:a,targetStoryId:i,includedStoryCount:Object.keys(f).length,includedEpicCount:Object.keys(p).length,omittedStoryCount:Math.max(0,Object.keys(e.stories).length-Object.keys(f).length),omittedEpicCount:Math.max(0,Object.keys(e.epics).length-Object.keys(p).length),reason:"targeted-invocation",reasonCodes:_(n,l?["epic-graph-authority-complete"]:[])};return I({...e,stories:f,epics:p,scope:g},e,g)}function W(r,e,t,i,c,n){const s=e.epics[i];if(!s)throw new y("STRUCTURAL_TARGET_NOT_FOUND",{stories:Object.keys(e.stories).length,epics:Object.keys(e.epics).length,targetKind:"epic"});const a=_e(s,e),u=$(a,e,[i]);if(!u[i])throw new y("STRUCTURAL_TARGET_NOT_FOUND",{stories:Object.keys(a).length,epics:Object.keys(u).length,targetKind:"epic"});const l={kind:"projected",commandId:t.commandId,stateProjectionPolicy:t.stateProjectionPolicy,projectionMode:c,trigger:r,targetEpicId:i,targetStoryId:null,includedStoryCount:Object.keys(a).length,includedEpicCount:Object.keys(u).length,omittedStoryCount:Math.max(0,Object.keys(e.stories).length-Object.keys(a).length),omittedEpicCount:Math.max(0,Object.keys(e.epics).length-Object.keys(u).length),reason:"targeted-invocation",reasonCodes:_(n)};return I({...e,stories:a,epics:u,scope:l},e,l)}function Ae(r,e,t){const i=ye(r),c=R(r,e);if(i&&!c)throw new y("STRUCTURAL_TARGET_NOT_FOUND",{stories:Object.keys(e.stories).length,epics:Object.keys(e.epics).length,targetKind:"epic"});const n=fe(r,e),s=O({commandId:t.commandId,explicitYoloopEpicId:c,sessionYoloopEpicId:c?null:n});if(s==="yoloop-discovery")return be(r,e,t);if(!n||s!=="yoloop-target"&&s!=="yoloop-session")throw new y("STRUCTURAL_TARGET_NOT_FOUND",{stories:Object.keys(e.stories).length,epics:Object.keys(e.epics).length,targetKind:"epic"});const a=e.epics[n];if(!a)throw new y("STRUCTURAL_TARGET_NOT_FOUND",{stories:Object.keys(e.stories).length,epics:Object.keys(e.epics).length,targetKind:"epic"});const u=G(n,a,e),l=V(n,u,e);if(!l[n])throw new y("STRUCTURAL_TARGET_NOT_FOUND",{stories:Object.keys(u).length,epics:Object.keys(l).length,targetKind:"epic"});const f=s,p={kind:"projected",commandId:t.commandId,stateProjectionPolicy:t.stateProjectionPolicy,projectionMode:f,trigger:r,targetEpicId:n,targetStoryId:null,targetEpicCoverage:he(n,a,u),includedStoryCount:Object.keys(u).length,includedEpicCount:Object.keys(l).length,omittedStoryCount:Math.max(0,Object.keys(e.stories).length-Object.keys(u).length),omittedEpicCount:Math.max(0,Object.keys(e.epics).length-Object.keys(l).length),reason:"targeted-invocation",reasonCodes:["structural-required",f,"yoloop-targeted"]};return I({...e,stories:u,epics:l,scope:p},e,p)}function Te(r,e){const t={};for(const[i,c]of Object.entries(r.epics)){const n=Array.isArray(c.stories)?c.stories.filter(s=>typeof s=="string"&&e.has(s)):[];t[i]={id:d(c.id)??i,...d(c.status,40)?{status:d(c.status,40)}:{},...typeof c.total_stories=="number"&&Number.isFinite(c.total_stories)?{total_stories:c.total_stories}:{},...typeof c.completed_stories=="number"&&Number.isFinite(c.completed_stories)?{completed_stories:c.completed_stories}:{},...n.length>0?{stories:n}:{},...n.length>0&&Array.isArray(c.depends_on)?{depends_on:c.depends_on.filter(s=>typeof s=="string"&&s.length>0)}:{},...n.length>0&&(c.branch_mode==="epic"||c.branch_mode==="story")?{branch_mode:c.branch_mode}:{},...n.length>0&&typeof c.execution_branch=="string"?{execution_branch:c.execution_branch}:{},...n.length>0&&typeof c.origin_branch=="string"?{origin_branch:c.origin_branch}:{},...n.length>0&&(c.branch_lease===null||typeof c.branch_lease=="object")?{branch_lease:c.branch_lease}:{},...n.length>0&&(c.origin_binding===null||typeof c.origin_binding=="object")?{origin_binding:c.origin_binding}:{},...n.length>0&&(c.aggregate_qa_receipt===null||typeof c.aggregate_qa_receipt=="object")?{aggregate_qa_receipt:c.aggregate_qa_receipt}:{},...n.length>0&&(c.head_reconciliation_receipt===null||typeof c.head_reconciliation_receipt=="object")?{head_reconciliation_receipt:c.head_reconciliation_receipt}:{}}}return t}function we(r){return r.stateSummary?.totals.stories??(r.scope?.includedStoryCount??Object.keys(r.stories).length)+(r.scope?.omittedStoryCount??0)}function qe(r){return r.stateSummary?.totals.epics??(r.scope?.includedEpicCount??Object.keys(r.epics).length)+(r.scope?.omittedEpicCount??0)}function Pe(r,e){if(r.stateSummary)return{...r.stateSummary,projection:{...r.stateSummary.projection,scopeKind:"projected",projectionMode:e.projectionMode,includedStoryCount:e.includedStoryCount,includedEpicCount:e.includedEpicCount??r.stateSummary.projection.includedEpicCount,omittedStoryCount:e.omittedStoryCount,omittedEpicCount:e.omittedEpicCount,reason:"body-size"},reasonCodes:_(r.stateSummary.reasonCodes,["payload-size-guardrail","state-summary-preserved","nonessential-state-degraded"])}}function Ve(r){const e=r.scope,t=new Set,i=e?.projectionMode==="structural-required"||e?.projectionMode==="yolo-story"||e?.projectionMode==="yoloop-target"||e?.projectionMode==="yoloop-session"||e?.projectionMode==="yoloop-discovery";if(i)for(const m of Object.keys(r.stories))t.add(m);else e?.targetStoryId&&x(e.targetStoryId,r,t);const c={};for(const m of t){const E=r.stories[m];E&&(c[m]=E)}const n=Te(r,t),s=Object.keys(c).length,a=Object.keys(n).length,u=Math.max(0,we(r)-s),l=Math.max(0,qe(r)-a),f=i?e?.projectionMode??"structural-required":e?.projectionMode==="yolo-story"?"yolo-story":"summary-only",p={kind:"projected",commandId:e?.commandId??null,stateProjectionPolicy:e?.stateProjectionPolicy??null,projectionMode:f,targetEpicId:e?.targetEpicId??null,targetStoryId:e?.targetStoryId??null,...e?.targetEpicCoverage?{targetEpicCoverage:e.targetEpicCoverage}:{},includedStoryCount:s,includedEpicCount:a,omittedStoryCount:u,omittedEpicCount:l,reason:"body-size",reasonCodes:_(e?.reasonCodes,["payload-size-guardrail",t.size>0?"structural-targets-preserved":"stories-omitted","epics-stubbed","state-summary-preserved","redundant-trigger-omitted"])},g=Pe(r,p);return{...r,stories:c,epics:n,scope:p,...g?{stateSummary:g}:{}}}function xe(r,e){const t=r.trim(),i=z(t);try{if(!i){if(ue(t)){const n=o("story-reference","story-targeted"),s=F(t);if(s)return D(t,e,n,s,"targeted-story",["story-reference-targeted"])}return b(t,e,o("unknown","adaptive-targeted"),["unknown-command-summary-only"])}if(i.stateProjectionPolicy==="epic-summary")return Oe(t,e,i);if(i.stateProjectionPolicy==="yoloop-targeted")return Ae(t,e,i);const c=F(t);if(i.stateProjectionPolicy==="story-targeted"){if(c){const s=O({commandId:i.commandId,targetStoryId:c})==="yolo-story";return D(t,e,i,c,s?"yolo-story":i.structuralRequired?"structural-required":"targeted-story",[s?"yolo-story":i.structuralRequired?"structural-required":"targeted-story"])}if(i.commandId==="yolo"||i.commandId==="yolo-inline"){const n=O({commandId:i.commandId});return b(t,e,i,["yolo-inline","stories-omitted","historical-content-omitted"],n??"yolo-inline")}return i.commandId==="commit"&&/^\*?(?:commit|commit-push)$/i.test(t)?b(t,e,i,["working-tree-commit","stories-omitted","historical-content-omitted"]):i.structuralRequired?(()=>{throw new y("STRUCTURAL_TARGET_NOT_FOUND",{stories:Object.keys(e.stories).length,epics:Object.keys(e.epics).length,targetKind:"story"})})():b(t,e,i,["story-target-missing-summary-only"])}if(i.stateProjectionPolicy==="adaptive-targeted"){if(c&&e.stories[c])return D(t,e,i,c,"targeted-story",["adaptive-story-targeted"]);const n=R(t,e);return n?W(t,e,i,n,"targeted-epic",["adaptive-epic-targeted"]):b(t,e,i,["adaptive-summary-only","target-unresolved-summary-only"])}if(i.stateProjectionPolicy==="epic-targeted"){if(i.commandId.startsWith("arch-")&&/(?:^|\s)epic-arch\s*$/i.test(t)&&e.archPlan?.execution?.currentStageCommand===i.commandId)return b(t,e,i,["architecture-root-delegated"]);const n=R(t,e);return n?W(t,e,i,n,i.structuralRequired?"structural-required":"targeted-epic",[i.structuralRequired?"structural-required":"targeted-epic"]):i.structuralRequired?(()=>{throw new y("STRUCTURAL_TARGET_NOT_FOUND",{stories:Object.keys(e.stories).length,epics:Object.keys(e.epics).length,targetKind:"epic"})})():b(t,e,i,["epic-target-missing-summary-only"])}return i.stateProjectionPolicy==="continuity-scoped"?b(t,e,i,["continuity-scoped-summary-only"]):b(t,e,i,["policy-full-summary-only"])}catch(c){if(c instanceof y)throw c;if(i?.structuralRequired)throw new y("STRUCTURAL_DEPENDENCY_MISSING",{stories:Object.keys(e.stories).length,epics:Object.keys(e.epics).length,projectionErrors:1});return b(t,e,i??o("unknown","adaptive-targeted"),["projection-error-summary-only"])}}const Ne=new Set(["yolo-story","yolo-inline","yoloop-target","yoloop-session","yoloop-discovery"]);function De(r){let e=0;for(const t of[r.stories,r.epics])for(const i of Object.values(t))Array.isArray(i.depends_on)&&(e+=i.depends_on.filter(c=>typeof c=="string").length);return e}function Ge(r,e){const t=z(r.trim());if(!t||!["yolo","yolo-inline","yoloop"].includes(t.commandId))return null;try{const i=xe(r,e),c=i.scope?.projectionMode;if(!c||!Ne.has(c))throw new y("STRUCTURAL_DEPENDENCY_MISSING",{stories:Object.keys(i.stories).length,epics:Object.keys(i.epics).length,projectionShapeErrors:1});return Object.freeze({ok:!0,version:2,shape:c,snapshot:i,included:{epics:i.scope?.includedEpicCount??Object.keys(i.epics).length,stories:i.scope?.includedStoryCount??Object.keys(i.stories).length,edges:De(i)},omitted:{epics:i.scope?.omittedEpicCount??0,stories:i.scope?.omittedStoryCount??0},cycleCount:0})}catch(i){if(!(i instanceof y))throw i;return Object.freeze({ok:!1,code:i.code,publicDetails:{...i.publicDetails,...i.code==="STRUCTURAL_CONTEXT_TOO_LARGE"?{}:{planningCause:Q(i.code)}}})}}export{Ve as degradeStateSnapshotForPayloadLimit,Q as planningProjectionCauseForStructuralCode,Fe as projectEpicOperationalEvidenceForRequest,xe as projectStateSnapshotForInvoke,Ge as projectStateSnapshotResultV2ForInvoke};