@ornexus/neocortex 4.60.73 → 4.60.75

package/packages/client/dist/graph-retrieval/shared-graph-retrieval-contract.js

@@ -1,237 +1 @@
-/**
- * P158.06 client-side SSoT shadow for graph retrieval metadata.
- *
- * Mirrored from @neocortex/shared/graph-retrieval-contract and the public
- * P198.01 command context policy for globally installed clients, where importing
- * shared source/dist subpaths can break before the monorepo build has
- * materialized dist files.
- */
-export const GRAPH_RETRIEVAL_SCHEMA_VERSION = 1;
-export const GRAPH_RETRIEVAL_CLIENT_CONTRACT_VERSION = 'client-pre-command-v1';
-export const COMMAND_CONTEXT_RETRIEVAL_PROFILES = [
-    'utility',
-    'planning',
-    'architecture',
-    'diagnostic',
-    'research',
-    'story-execution',
-    'review',
-    'qa',
-    'security',
-    'continuity',
-    'recovery',
-];
-export const DEFAULT_GRAPH_RETRIEVAL_BUDGETS = {
-    maxItems: 24,
-    maxEdges: 64,
-    maxPayloadBytes: 12 * 1024,
-    maxSnippetChars: 480,
-    maxLabelChars: 160,
-    maxTotalCost: 100,
-};
-const budget = (value) => Object.freeze({ ...value });
-export const CLIENT_GRAPH_RETRIEVAL_PROFILE_BUDGETS = Object.freeze({
-    utility: budget({ maxItems: 4, maxEdges: 8, maxPayloadBytes: 4 * 1024, maxSnippetChars: 280, maxLabelChars: 96, maxTotalCost: 40 }),
-    planning: budget({ maxItems: 12, maxEdges: 48, maxPayloadBytes: 8 * 1024, maxSnippetChars: 360, maxLabelChars: 128, maxTotalCost: 70 }),
-    architecture: budget({ maxItems: 10, maxEdges: 48, maxPayloadBytes: 8 * 1024, maxSnippetChars: 360, maxLabelChars: 128, maxTotalCost: 65 }),
-    diagnostic: budget({ maxItems: 10, maxEdges: 32, maxPayloadBytes: 8 * 1024, maxSnippetChars: 360, maxLabelChars: 128, maxTotalCost: 60 }),
-    research: budget({ maxItems: 10, maxEdges: 32, maxPayloadBytes: 8 * 1024, maxSnippetChars: 360, maxLabelChars: 128, maxTotalCost: 60 }),
-    'story-execution': budget({ maxItems: 6, maxEdges: 32, maxPayloadBytes: 8 * 1024, maxSnippetChars: 320, maxLabelChars: 128, maxTotalCost: 50 }),
-    review: budget({ maxItems: 8, maxEdges: 32, maxPayloadBytes: 8 * 1024, maxSnippetChars: 320, maxLabelChars: 128, maxTotalCost: 55 }),
-    qa: budget({ maxItems: 6, maxEdges: 24, maxPayloadBytes: 8 * 1024, maxSnippetChars: 320, maxLabelChars: 128, maxTotalCost: 50 }),
-    security: budget({ maxItems: 8, maxEdges: 24, maxPayloadBytes: 8 * 1024, maxSnippetChars: 320, maxLabelChars: 128, maxTotalCost: 55 }),
-    continuity: budget({ maxItems: 6, maxEdges: 16, maxPayloadBytes: 4 * 1024, maxSnippetChars: 280, maxLabelChars: 96, maxTotalCost: 45 }),
-    recovery: budget({ maxItems: 8, maxEdges: 32, maxPayloadBytes: 8 * 1024, maxSnippetChars: 320, maxLabelChars: 128, maxTotalCost: 55 }),
-});
-const policy = (seed) => Object.freeze({
-    commandId: seed.commandId,
-    ...(seed.number === undefined ? {} : { number: seed.number }),
-    aliases: Object.freeze([...(seed.aliases ?? [])]),
-    retrievalProfile: seed.retrievalProfile,
-    retrievalBudget: CLIENT_GRAPH_RETRIEVAL_PROFILE_BUDGETS[seed.retrievalProfile],
-});
-const PUBLIC_COMMAND_POLICY_SEEDS = [
-    { commandId: 'status', number: 1, aliases: ['st'], retrievalProfile: 'utility' },
-    { commandId: 'arch-plan', number: 3, aliases: ['arquitetura', 'architecture', 'arch'], retrievalProfile: 'architecture' },
-    { commandId: 'arch-prd', number: 4, aliases: ['prd', 'product-requirements'], retrievalProfile: 'architecture' },
-    { commandId: 'arch-architecture', number: 5, aliases: ['arch-doc', 'tech-architecture'], retrievalProfile: 'architecture' },
-    { commandId: 'arch-api-contracts', number: 6, aliases: ['api-contracts', 'api-contract'], retrievalProfile: 'architecture' },
-    { commandId: 'arch-api-integrations', number: 7, aliases: ['api-integrations', 'api-int'], retrievalProfile: 'architecture' },
-    { commandId: 'arch-database', number: 8, aliases: ['database-schema', 'db-schema', 'db'], retrievalProfile: 'architecture' },
-    { commandId: 'arch-security', number: 9, aliases: ['cyber-security', 'security', 'sec'], retrievalProfile: 'architecture' },
-    { commandId: 'arch-design-system', number: 10, aliases: ['design-system', 'ds', 'atomic-design'], retrievalProfile: 'architecture' },
-    { commandId: 'arch-ux-design', number: 11, aliases: ['ux-design', 'ux', 'wireframes', 'wireframe', 'user-flows'], retrievalProfile: 'architecture' },
-    { commandId: 'arch-performance', number: 12, aliases: ['performance', 'perf', 'capacity-planning', 'capacity', 'arch-perf', 'performance-strategy'], retrievalProfile: 'architecture' },
-    { commandId: 'arch-testing', number: 13, aliases: ['testing-strategy', 'test-plan', 'test-strategy', 'arch-test'], retrievalProfile: 'architecture' },
-    { commandId: 'arch-infrastructure', number: 14, aliases: ['infrastructure', 'infra', 'deploy-plan', 'deployment', 'arch-infra', 'arch-deploy'], retrievalProfile: 'architecture' },
-    { commandId: 'arch-review', number: 15, aliases: ['review-consolidation', 'consolidation', 'architecture-review', 'arch-consolidation'], retrievalProfile: 'architecture' },
-    { commandId: 'arch-fitness-functions', number: 16, aliases: ['fitness', 'fitness-functions', 'archfit', 'arch-fit', 'fit-funcs'], retrievalProfile: 'architecture' },
-    { commandId: 'create-epic', number: 17, aliases: ['criar-epic', 'planejamento'], retrievalProfile: 'planning' },
-    { commandId: 'idea-diagnose', number: 18, aliases: ['idea-diag'], retrievalProfile: 'planning' },
-    { commandId: 'idea-research', number: 19, aliases: ['idea-pesq'], retrievalProfile: 'planning' },
-    { commandId: 'generate-epic', number: 20, aliases: ['gerar-epic'], retrievalProfile: 'planning' },
-    { commandId: 'exec', number: 21, aliases: ['executar', 'pipeline'], retrievalProfile: 'story-execution' },
-    { commandId: 'yolo', number: 22, retrievalProfile: 'story-execution' },
-    { commandId: 'epic', number: 23, aliases: ['parallel-epic'], retrievalProfile: 'story-execution' },
-    { commandId: 'setup-branch', number: 24, aliases: ['setup', 'branch'], retrievalProfile: 'story-execution' },
-    { commandId: 'diagnose', number: 25, aliases: ['diag', 'diagnostico', 'c02'], retrievalProfile: 'diagnostic' },
-    { commandId: 'research', number: 26, aliases: ['pesquisar', 'pesq', 'research-fix', 'c03'], retrievalProfile: 'research' },
-    { commandId: 'write-spec', number: 27, aliases: ['spec', 'especificacao', 'c04'], retrievalProfile: 'story-execution' },
-    { commandId: 'create-tasks', number: 28, aliases: ['tasks', 'tarefas', 'c05'], retrievalProfile: 'story-execution' },
-    { commandId: 'implement', number: 29, aliases: ['impl', 'implementar', 'c06'], retrievalProfile: 'story-execution' },
-    { commandId: 'commit', number: 30, aliases: ['push', 'commit-push', 'commit_push', 'cp', 'c07'], retrievalProfile: 'story-execution' },
-    { commandId: 'sync', number: 31, aliases: ['sincronizar', 'c08'], retrievalProfile: 'story-execution' },
-    { commandId: 'create-pr', number: 32, aliases: ['pr', 'c09'], retrievalProfile: 'story-execution' },
-    { commandId: 'review', number: 33, aliases: ['revisar', 'c11'], retrievalProfile: 'review' },
-    { commandId: 'merge', number: 34, aliases: ['mesclar', 'c12'], retrievalProfile: 'story-execution' },
-    { commandId: 'fix-blocked', number: 35, aliases: ['fix', 'corrigir'], retrievalProfile: 'recovery' },
-    { commandId: 'finalize-epic', number: 36, aliases: ['finalizar'], retrievalProfile: 'recovery' },
-    { commandId: 'resolve-conflicts', number: 37, aliases: ['conflitos'], retrievalProfile: 'recovery' },
-    { commandId: 'update-memory', number: 38, aliases: ['memoria'], retrievalProfile: 'recovery' },
-    { commandId: 'refactor', number: 39, aliases: ['refactoring', 'refact', 'refac', 'rf', 'cleanup-code', 'code-cleanup', 'code-quality', 'improve-code', 'modernize', 'modernization', 'legacy', 'legacy-code', 'debt-pay', 'pay-debt', 'debt-reduction', 'smell-fix', 'fix-smells', 'code-smells', 'strangler', 'strangler-fig'], retrievalProfile: 'recovery' },
-    { commandId: 'cleanup', number: 40, aliases: ['limpar', 'limpeza'], retrievalProfile: 'utility' },
-    { commandId: 'audit', number: 41, aliases: ['auditar', 'auditoria'], retrievalProfile: 'utility' },
-    { commandId: 'tech-debt', number: 42, aliases: ['debt', 'debts', 'debt-list', 'tech-debts', 'td'], retrievalProfile: 'utility' },
-    { commandId: 'menu', number: 43, aliases: ['help', 'ajuda', '?', 'commands', 'cmds'], retrievalProfile: 'utility' },
-    { commandId: 'plans', number: 44, aliases: ['planos', 'pricing'], retrievalProfile: 'utility' },
-    { commandId: 'billing', number: 45, aliases: ['bill', 'subscription', 'sub'], retrievalProfile: 'utility' },
-    { commandId: 'subscribe', number: 46, aliases: ['upgrade', 'checkout'], retrievalProfile: 'utility' },
-    { commandId: 'qa-scan', number: 47, aliases: ['qa', 'qa-test', 'visual-qa', 'e2e-scan', 'troubleshoot', 'debug-ui', 'scan', 'a11y', 'accessibility', 'wcag'], retrievalProfile: 'qa' },
-    { commandId: 'yoloop', number: 48, aliases: ['auto-yolo', 'epic-runner', 'story-runner', 'loop-yolo', 'auto-epic'], retrievalProfile: 'utility' },
-    { commandId: 'migrate-state', number: 49, aliases: ['migrate', 'state-migrate', 'schema-migrate'], retrievalProfile: 'utility' },
-    { commandId: 'policy-audit', number: 50, aliases: ['policy', 'audit-policy', 'policy-history', 'policies'], retrievalProfile: 'utility' },
-    { commandId: 'mutation-test', number: 51, aliases: ['mutation', 'stryker', 'kill-mutants'], retrievalProfile: 'qa' },
-    { commandId: 'sync-openapi', number: 52, aliases: ['openapi-sync', 'api-sync', 'spec-sync', 'regen-openapi'], retrievalProfile: 'utility' },
-    { commandId: 'generate-pacts', number: 53, aliases: ['pacts', 'gen-pacts', 'regen-pacts', 'create-pacts'], retrievalProfile: 'utility' },
-    { commandId: 'verify-pacts', number: 54, aliases: ['verify-pact', 'pact-verify', 'check-pacts', 'pact-check'], retrievalProfile: 'utility' },
-    { commandId: 'property-test', number: 55, aliases: ['property', 'pbt', 'proptest', 'property-tests', 'invariant-test'], retrievalProfile: 'qa' },
-    { commandId: 'chaos-plan', number: 56, aliases: ['chaos', 'gameday', 'resilience-test'], retrievalProfile: 'utility' },
-    { commandId: 'ui-ux-review', number: 57, aliases: ['ux-review', 'design-review', 'visual-review', 'product-polish'], retrievalProfile: 'utility' },
-    { commandId: 'solyd-system', number: 58, aliases: ['security-system', 'authorized-security', 'sec-system'], retrievalProfile: 'security' },
-    { commandId: 'goal', number: 59, aliases: ['goals', 'durable-goal', 'continuity-goal'], retrievalProfile: 'continuity' },
-    { commandId: 'loop', number: 60, aliases: ['loops', 'durable-loop', 'continuity-loop'], retrievalProfile: 'continuity' },
-    { commandId: 'jobs', number: 61, aliases: ['job', 'continuity-jobs'], retrievalProfile: 'continuity' },
-    { commandId: 'runner', number: 62, aliases: ['neocortex-runner', 'continuity-runner'], retrievalProfile: 'continuity' },
-    { commandId: 'migrate-project-id', number: 63, retrievalProfile: 'recovery' },
-];
-const INTERNAL_COMMAND_POLICY_SEEDS = [
-    { commandId: 'diagnose-inline', retrievalProfile: 'diagnostic' },
-    { commandId: 'research-inline', retrievalProfile: 'research' },
-    { commandId: 'yolo-inline', retrievalProfile: 'story-execution' },
-    { commandId: 'goal-tick', retrievalProfile: 'continuity' },
-    { commandId: 'loop-tick', retrievalProfile: 'continuity' },
-];
-export const CLIENT_PUBLIC_COMMAND_CONTEXT_POLICIES = Object.freeze(PUBLIC_COMMAND_POLICY_SEEDS.map(policy));
-export const CLIENT_INTERNAL_COMMAND_CONTEXT_POLICIES = Object.freeze(INTERNAL_COMMAND_POLICY_SEEDS.map(policy));
-export const CLIENT_COMMAND_CONTEXT_POLICIES = Object.freeze([
-    ...CLIENT_PUBLIC_COMMAND_CONTEXT_POLICIES,
-    ...CLIENT_INTERNAL_COMMAND_CONTEXT_POLICIES,
-]);
-export const CLIENT_COMMAND_CONTEXT_POLICY_BY_ID = Object.freeze(Object.fromEntries(CLIENT_COMMAND_CONTEXT_POLICIES.map((entry) => [entry.commandId, entry])));
-export const CLIENT_COMMAND_CONTEXT_POLICY_BY_NUMBER = Object.freeze(Object.fromEntries(CLIENT_PUBLIC_COMMAND_CONTEXT_POLICIES
-    .filter((entry) => entry.number !== undefined)
-    .map((entry) => [entry.number, entry])));
-export const CLIENT_COMMAND_CONTEXT_POLICY_ALIAS_MAP = Object.freeze(Object.fromEntries(CLIENT_PUBLIC_COMMAND_CONTEXT_POLICIES.flatMap((entry) => entry.aliases.map((alias) => [normalizeCommandToken(alias), entry.commandId]))));
-export function normalizeCommandToken(input) {
-    return input.trim().toLowerCase().replace(/^\*/, '');
-}
-function leadingCommandToken(input) {
-    return input.trim().split(/\s+/, 1)[0] ?? '';
-}
-export function listClientPublicCommandContextPolicies() {
-    return CLIENT_PUBLIC_COMMAND_CONTEXT_POLICIES;
-}
-export function listClientInternalCommandContextPolicies() {
-    return CLIENT_INTERNAL_COMMAND_CONTEXT_POLICIES;
-}
-export function listClientCommandContextPolicies() {
-    return CLIENT_COMMAND_CONTEXT_POLICIES;
-}
-export function resolveClientCommandContextPolicy(input) {
-    const token = leadingCommandToken(input);
-    if (!token)
-        return CLIENT_COMMAND_CONTEXT_POLICY_BY_ID['menu'] ?? null;
-    const normalized = normalizeCommandToken(token);
-    if (/^\d+$/.test(normalized)) {
-        return CLIENT_COMMAND_CONTEXT_POLICY_BY_NUMBER[Number.parseInt(normalized, 10)] ?? null;
-    }
-    return CLIENT_COMMAND_CONTEXT_POLICY_BY_ID[normalized]
-        ?? CLIENT_COMMAND_CONTEXT_POLICY_BY_ID[CLIENT_COMMAND_CONTEXT_POLICY_ALIAS_MAP[normalized] ?? '']
-        ?? null;
-}
-const NODE_TYPE_PRIORITY = {
-    CanonicalMemory: 0,
-    Guardrail: 1,
-    Debt: 2,
-    State: 3,
-    Story: 4,
-    Epic: 5,
-    Command: 6,
-    Doc: 7,
-    Package: 8,
-    Api: 9,
-    Route: 10,
-    DbSchema: 11,
-    Flag: 12,
-    BusinessRule: 13,
-    Risk: 14,
-    PlatformMemory: 15,
-};
-export function normalizeGraphRetrievalPath(path) {
-    return path.replace(/\\/g, '/').replace(/\/+/g, '/').replace(/^\.\//, '');
-}
-function stableItemKey(item) {
-    return [item.nodeType, `${item.source.kind}:${normalizeGraphRetrievalPath(item.source.path).toLowerCase()}`, item.stableId.toLowerCase()].join('|');
-}
-function score(item) {
-    return item.score ?? 0;
-}
-export function compareGraphRetrievalItems(a, b) {
-    const scoreDiff = score(b) - score(a);
-    if (scoreDiff !== 0)
-        return scoreDiff;
-    const confidenceDiff = b.confidence - a.confidence;
-    if (confidenceDiff !== 0)
-        return confidenceDiff;
-    const costDiff = a.budgetCost - b.budgetCost;
-    if (costDiff !== 0)
-        return costDiff;
-    const typeDiff = NODE_TYPE_PRIORITY[a.nodeType] - NODE_TYPE_PRIORITY[b.nodeType];
-    if (typeDiff !== 0)
-        return typeDiff;
-    const pathDiff = normalizeGraphRetrievalPath(a.source.path).localeCompare(normalizeGraphRetrievalPath(b.source.path), 'en-US');
-    if (pathDiff !== 0)
-        return pathDiff;
-    return a.stableId.localeCompare(b.stableId, 'en-US');
-}
-export function createGraphRetrievalMetadata(params) {
-    const budget = { ...DEFAULT_GRAPH_RETRIEVAL_BUDGETS, ...params.budgets };
-    const deduped = new Map();
-    for (const item of params.items) {
-        const previous = deduped.get(stableItemKey(item));
-        if (!previous || compareGraphRetrievalItems(item, previous) < 0)
-            deduped.set(stableItemKey(item), item);
-    }
-    const selected = [];
-    const skipped = [];
-    let totalCost = 0;
-    for (const item of [...deduped.values()].sort(compareGraphRetrievalItems)) {
-        const nextCost = totalCost + Math.max(1, item.budgetCost);
-        if (selected.length >= budget.maxItems || nextCost > budget.maxTotalCost) {
-            skipped.push({ stableId: item.stableId, source: item.source, reasonCode: 'budget_exceeded' });
-            continue;
-        }
-        selected.push(item);
-        totalCost = nextCost;
-    }
-    return {
-        schemaVersion: GRAPH_RETRIEVAL_SCHEMA_VERSION,
-        retrievalId: params.retrievalId,
-        query: params.query,
-        budget: { ...budget, totalCost },
-        items: selected,
-        skipped,
-        warnings: params.warnings ?? [],
-        generatedAt: params.generatedAt,
-    };
-}
+const L=1,O="client-pre-command-v1",N=["utility","planning","architecture","diagnostic","research","story-execution","review","qa","security","continuity","recovery"],P={maxItems:24,maxEdges:64,maxPayloadBytes:12288,maxSnippetChars:480,maxLabelChars:160,maxTotalCost:100},i=e=>Object.freeze({...e}),v=Object.freeze({utility:i({maxItems:4,maxEdges:8,maxPayloadBytes:4*1024,maxSnippetChars:280,maxLabelChars:96,maxTotalCost:40}),planning:i({maxItems:12,maxEdges:48,maxPayloadBytes:8*1024,maxSnippetChars:360,maxLabelChars:128,maxTotalCost:70}),architecture:i({maxItems:10,maxEdges:48,maxPayloadBytes:8*1024,maxSnippetChars:360,maxLabelChars:128,maxTotalCost:65}),diagnostic:i({maxItems:10,maxEdges:32,maxPayloadBytes:8*1024,maxSnippetChars:360,maxLabelChars:128,maxTotalCost:60}),research:i({maxItems:10,maxEdges:32,maxPayloadBytes:8*1024,maxSnippetChars:360,maxLabelChars:128,maxTotalCost:60}),"story-execution":i({maxItems:6,maxEdges:32,maxPayloadBytes:8*1024,maxSnippetChars:320,maxLabelChars:128,maxTotalCost:50}),review:i({maxItems:8,maxEdges:32,maxPayloadBytes:8*1024,maxSnippetChars:320,maxLabelChars:128,maxTotalCost:55}),qa:i({maxItems:6,maxEdges:24,maxPayloadBytes:8*1024,maxSnippetChars:320,maxLabelChars:128,maxTotalCost:50}),security:i({maxItems:8,maxEdges:24,maxPayloadBytes:8*1024,maxSnippetChars:320,maxLabelChars:128,maxTotalCost:55}),continuity:i({maxItems:6,maxEdges:16,maxPayloadBytes:4*1024,maxSnippetChars:280,maxLabelChars:96,maxTotalCost:45}),recovery:i({maxItems:8,maxEdges:32,maxPayloadBytes:8*1024,maxSnippetChars:320,maxLabelChars:128,maxTotalCost:55})}),u=e=>Object.freeze({commandId:e.commandId,...e.number===void 0?{}:{number:e.number},aliases:Object.freeze([...e.aliases??[]]),retrievalProfile:e.retrievalProfile,retrievalBudget:v[e.retrievalProfile]}),C=[{commandId:"status",number:1,aliases:["st"],retrievalProfile:"utility"},{commandId:"arch-plan",number:3,aliases:["arquitetura","architecture","arch"],retrievalProfile:"architecture"},{commandId:"arch-prd",number:4,aliases:["prd","product-requirements"],retrievalProfile:"architecture"},{commandId:"arch-architecture",number:5,aliases:["arch-doc","tech-architecture"],retrievalProfile:"architecture"},{commandId:"arch-api-contracts",number:6,aliases:["api-contracts","api-contract"],retrievalProfile:"architecture"},{commandId:"arch-api-integrations",number:7,aliases:["api-integrations","api-int"],retrievalProfile:"architecture"},{commandId:"arch-database",number:8,aliases:["database-schema","db-schema","db"],retrievalProfile:"architecture"},{commandId:"arch-security",number:9,aliases:["cyber-security","security","sec"],retrievalProfile:"architecture"},{commandId:"arch-design-system",number:10,aliases:["design-system","ds","atomic-design"],retrievalProfile:"architecture"},{commandId:"arch-ux-design",number:11,aliases:["ux-design","ux","wireframes","wireframe","user-flows"],retrievalProfile:"architecture"},{commandId:"arch-performance",number:12,aliases:["performance","perf","capacity-planning","capacity","arch-perf","performance-strategy"],retrievalProfile:"architecture"},{commandId:"arch-testing",number:13,aliases:["testing-strategy","test-plan","test-strategy","arch-test"],retrievalProfile:"architecture"},{commandId:"arch-infrastructure",number:14,aliases:["infrastructure","infra","deploy-plan","deployment","arch-infra","arch-deploy"],retrievalProfile:"architecture"},{commandId:"arch-review",number:15,aliases:["review-consolidation","consolidation","architecture-review","arch-consolidation"],retrievalProfile:"architecture"},{commandId:"arch-fitness-functions",number:16,aliases:["fitness","fitness-functions","archfit","arch-fit","fit-funcs"],retrievalProfile:"architecture"},{commandId:"create-epic",number:17,aliases:["criar-epic","planejamento"],retrievalProfile:"planning"},{commandId:"idea-diagnose",number:18,aliases:["idea-diag"],retrievalProfile:"planning"},{commandId:"idea-research",number:19,aliases:["idea-pesq"],retrievalProfile:"planning"},{commandId:"generate-epic",number:20,aliases:["gerar-epic"],retrievalProfile:"planning"},{commandId:"exec",number:21,aliases:["executar","pipeline"],retrievalProfile:"story-execution"},{commandId:"yolo",number:22,retrievalProfile:"story-execution"},{commandId:"epic",number:23,aliases:["parallel-epic"],retrievalProfile:"story-execution"},{commandId:"setup-branch",number:24,aliases:["setup","branch"],retrievalProfile:"story-execution"},{commandId:"diagnose",number:25,aliases:["diag","diagnostico","c02"],retrievalProfile:"diagnostic"},{commandId:"research",number:26,aliases:["pesquisar","pesq","research-fix","c03"],retrievalProfile:"research"},{commandId:"write-spec",number:27,aliases:["spec","especificacao","c04"],retrievalProfile:"story-execution"},{commandId:"create-tasks",number:28,aliases:["tasks","tarefas","c05"],retrievalProfile:"story-execution"},{commandId:"implement",number:29,aliases:["impl","implementar","c06"],retrievalProfile:"story-execution"},{commandId:"commit",number:30,aliases:["push","commit-push","commit_push","cp","c07"],retrievalProfile:"story-execution"},{commandId:"sync",number:31,aliases:["sincronizar","c08"],retrievalProfile:"story-execution"},{commandId:"create-pr",number:32,aliases:["pr","c09"],retrievalProfile:"story-execution"},{commandId:"review",number:33,aliases:["revisar","c11"],retrievalProfile:"review"},{commandId:"merge",number:34,aliases:["mesclar","c12"],retrievalProfile:"story-execution"},{commandId:"fix-blocked",number:35,aliases:["fix","corrigir"],retrievalProfile:"recovery"},{commandId:"finalize-epic",number:36,aliases:["finalizar"],retrievalProfile:"recovery"},{commandId:"resolve-conflicts",number:37,aliases:["conflitos"],retrievalProfile:"recovery"},{commandId:"update-memory",number:38,aliases:["memoria"],retrievalProfile:"recovery"},{commandId:"refactor",number:39,aliases:["refactoring","refact","refac","rf","cleanup-code","code-cleanup","code-quality","improve-code","modernize","modernization","legacy","legacy-code","debt-pay","pay-debt","debt-reduction","smell-fix","fix-smells","code-smells","strangler","strangler-fig"],retrievalProfile:"recovery"},{commandId:"cleanup",number:40,aliases:["limpar","limpeza"],retrievalProfile:"utility"},{commandId:"audit",number:41,aliases:["auditar","auditoria"],retrievalProfile:"utility"},{commandId:"tech-debt",number:42,aliases:["debt","debts","debt-list","tech-debts","td"],retrievalProfile:"utility"},{commandId:"menu",number:43,aliases:["help","ajuda","?","commands","cmds"],retrievalProfile:"utility"},{commandId:"plans",number:44,aliases:["planos","pricing"],retrievalProfile:"utility"},{commandId:"billing",number:45,aliases:["bill","subscription","sub"],retrievalProfile:"utility"},{commandId:"subscribe",number:46,aliases:["upgrade","checkout"],retrievalProfile:"utility"},{commandId:"qa-scan",number:47,aliases:["qa","qa-test","visual-qa","e2e-scan","troubleshoot","debug-ui","scan","a11y","accessibility","wcag"],retrievalProfile:"qa"},{commandId:"yoloop",number:48,aliases:["auto-yolo","epic-runner","story-runner","loop-yolo","auto-epic"],retrievalProfile:"utility"},{commandId:"migrate-state",number:49,aliases:["migrate","state-migrate","schema-migrate"],retrievalProfile:"utility"},{commandId:"policy-audit",number:50,aliases:["policy","audit-policy","policy-history","policies"],retrievalProfile:"utility"},{commandId:"mutation-test",number:51,aliases:["mutation","stryker","kill-mutants"],retrievalProfile:"qa"},{commandId:"sync-openapi",number:52,aliases:["openapi-sync","api-sync","spec-sync","regen-openapi"],retrievalProfile:"utility"},{commandId:"generate-pacts",number:53,aliases:["pacts","gen-pacts","regen-pacts","create-pacts"],retrievalProfile:"utility"},{commandId:"verify-pacts",number:54,aliases:["verify-pact","pact-verify","check-pacts","pact-check"],retrievalProfile:"utility"},{commandId:"property-test",number:55,aliases:["property","pbt","proptest","property-tests","invariant-test"],retrievalProfile:"qa"},{commandId:"chaos-plan",number:56,aliases:["chaos","gameday","resilience-test"],retrievalProfile:"utility"},{commandId:"ui-ux-review",number:57,aliases:["ux-review","design-review","visual-review","product-polish"],retrievalProfile:"utility"},{commandId:"solyd-system",number:58,aliases:["security-system","authorized-security","sec-system"],retrievalProfile:"security"},{commandId:"goal",number:59,aliases:["goals","durable-goal","continuity-goal"],retrievalProfile:"continuity"},{commandId:"loop",number:60,aliases:["loops","durable-loop","continuity-loop"],retrievalProfile:"continuity"},{commandId:"jobs",number:61,aliases:["job","continuity-jobs"],retrievalProfile:"continuity"},{commandId:"runner",number:62,aliases:["neocortex-runner","continuity-runner"],retrievalProfile:"continuity"},{commandId:"migrate-project-id",number:63,retrievalProfile:"recovery"}],g=[{commandId:"diagnose-inline",retrievalProfile:"diagnostic"},{commandId:"research-inline",retrievalProfile:"research"},{commandId:"yolo-inline",retrievalProfile:"story-execution"},{commandId:"goal-tick",retrievalProfile:"continuity"},{commandId:"loop-tick",retrievalProfile:"continuity"}],l=Object.freeze(C.map(u)),p=Object.freeze(g.map(u)),f=Object.freeze([...l,...p]),m=Object.freeze(Object.fromEntries(f.map(e=>[e.commandId,e]))),E=Object.freeze(Object.fromEntries(l.filter(e=>e.number!==void 0).map(e=>[e.number,e]))),_=Object.freeze(Object.fromEntries(l.flatMap(e=>e.aliases.map(a=>[y(a),e.commandId]))));function y(e){return e.trim().toLowerCase().replace(/^\*/,"")}function T(e){return e.trim().split(/\s+/,1)[0]??""}function R(){return l}function S(){return p}function A(){return f}function M(e){const a=T(e);if(!a)return m.menu??null;const t=y(a);return/^\d+$/.test(t)?E[Number.parseInt(t,10)]??null:m[t]??m[_[t]??""]??null}const b={CanonicalMemory:0,Guardrail:1,Debt:2,State:3,Story:4,Epic:5,Command:6,Doc:7,Package:8,Api:9,Route:10,DbSchema:11,Flag:12,BusinessRule:13,Risk:14,PlatformMemory:15};function d(e){return e.replace(/\\/g,"/").replace(/\/+/g,"/").replace(/^\.\//,"")}function I(e){return[e.nodeType,`${e.source.kind}:${d(e.source.path).toLowerCase()}`,e.stableId.toLowerCase()].join("|")}function x(e){return e.score??0}function h(e,a){const t=x(a)-x(e);if(t!==0)return t;const o=a.confidence-e.confidence;if(o!==0)return o;const s=e.budgetCost-a.budgetCost;if(s!==0)return s;const n=b[e.nodeType]-b[a.nodeType];if(n!==0)return n;const r=d(e.source.path).localeCompare(d(a.source.path),"en-US");return r!==0?r:e.stableId.localeCompare(a.stableId,"en-US")}function D(e){const a={...P,...e.budgets},t=new Map;for(const r of e.items){const c=t.get(I(r));(!c||h(r,c)<0)&&t.set(I(r),r)}const o=[],s=[];let n=0;for(const r of[...t.values()].sort(h)){const c=n+Math.max(1,r.budgetCost);if(o.length>=a.maxItems||c>a.maxTotalCost){s.push({stableId:r.stableId,source:r.source,reasonCode:"budget_exceeded"});continue}o.push(r),n=c}return{schemaVersion:1,retrievalId:e.retrievalId,query:e.query,budget:{...a,totalCost:n},items:o,skipped:s,warnings:e.warnings??[],generatedAt:e.generatedAt}}export{f as CLIENT_COMMAND_CONTEXT_POLICIES,_ as CLIENT_COMMAND_CONTEXT_POLICY_ALIAS_MAP,m as CLIENT_COMMAND_CONTEXT_POLICY_BY_ID,E as CLIENT_COMMAND_CONTEXT_POLICY_BY_NUMBER,v as CLIENT_GRAPH_RETRIEVAL_PROFILE_BUDGETS,p as CLIENT_INTERNAL_COMMAND_CONTEXT_POLICIES,l as CLIENT_PUBLIC_COMMAND_CONTEXT_POLICIES,N as COMMAND_CONTEXT_RETRIEVAL_PROFILES,P as DEFAULT_GRAPH_RETRIEVAL_BUDGETS,O as GRAPH_RETRIEVAL_CLIENT_CONTRACT_VERSION,L as GRAPH_RETRIEVAL_SCHEMA_VERSION,h as compareGraphRetrievalItems,D as createGraphRetrievalMetadata,A as listClientCommandContextPolicies,S as listClientInternalCommandContextPolicies,R as listClientPublicCommandContextPolicies,y as normalizeCommandToken,d as normalizeGraphRetrievalPath,M as resolveClientCommandContextPolicy};

package/packages/client/dist/i18n/first-run.js

@@ -1,60 +1,2 @@
-/**
- * @license FSL-1.1
- * Copyright (c) 2026 OrNexus AI
- *
- * First-run messages -- localized welcome strings shown on the user's
- * first `neocortex-client invoke` call. Writes to stderr so it never
- * contaminates instruction output. See P76.02.
- */
-export const FIRST_RUN_MESSAGES = {
-    'en': {
-        banner: '── Welcome to Neocortex ─────────────────────────────────────',
-        intro: 'Looks like this is your first time here. Here are a few commands to get started:',
-        commands: [
-            { label: '@neocortex *menu', description: 'See all available commands' },
-            { label: '@neocortex *arch-plan', description: 'Plan a new project architecture' },
-            { label: '@neocortex *yolo', description: 'Quick implementation mode' },
-            { label: '@neocortex *status', description: 'Check your project status' },
-        ],
-        tip: 'Tip: run `@neocortex *menu` for the full, tier-aware command list.',
-    },
-    'pt-BR': {
-        banner: '── Bem-vindo ao Neocortex ───────────────────────────────────',
-        intro: 'Parece que esta é a sua primeira vez por aqui. Alguns comandos para começar:',
-        commands: [
-            { label: '@neocortex *menu', description: 'Ver todos os comandos disponíveis' },
-            { label: '@neocortex *arch-plan', description: 'Planejar a arquitetura de um novo projeto' },
-            { label: '@neocortex *yolo', description: 'Modo de implementação rápida' },
-            { label: '@neocortex *status', description: 'Ver o status do seu projeto' },
-        ],
-        tip: 'Dica: execute `@neocortex *menu` para a lista completa (já filtrada pelo seu tier).',
-    },
-};
-/** Detect the best locale from process.env.LANG / LC_ALL. Falls back to en. */
-export function detectFirstRunLocale(env = process.env) {
-    const raw = (env.LC_ALL ?? env.LANG ?? '').toLowerCase();
-    if (raw.startsWith('pt'))
-        return 'pt-BR';
-    return 'en';
-}
-/** Render the first-run message as a plain-text block suitable for stderr. */
-export function renderFirstRunMessage(locale) {
-    const msg = FIRST_RUN_MESSAGES[locale];
-    const width = 62;
-    // Find the longest command label for padding
-    const labelWidth = msg.commands.reduce((max, c) => Math.max(max, c.label.length), 0);
-    const lines = [];
-    lines.push(msg.banner);
-    lines.push('');
-    lines.push(msg.intro);
-    lines.push('');
-    for (const cmd of msg.commands) {
-        const padded = cmd.label.padEnd(labelWidth + 2);
-        lines.push(`  ${padded}${cmd.description}`);
-    }
-    lines.push('');
-    lines.push(msg.tip);
-    lines.push(''.padEnd(width, '─'));
-    lines.push('');
-    return lines.join('\n');
-}
+const i={en:{banner:"\u2500\u2500 Welcome to Neocortex \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",intro:"Looks like this is your first time here. Here are a few commands to get started:",commands:[{label:"@neocortex *menu",description:"See all available commands"},{label:"@neocortex *arch-plan",description:"Plan a new project architecture"},{label:"@neocortex *yolo",description:"Quick implementation mode"},{label:"@neocortex *status",description:"Check your project status"}],tip:"Tip: run `@neocortex *menu` for the full, tier-aware command list."},"pt-BR":{banner:"\u2500\u2500 Bem-vindo ao Neocortex \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",intro:"Parece que esta \xE9 a sua primeira vez por aqui. Alguns comandos para come\xE7ar:",commands:[{label:"@neocortex *menu",description:"Ver todos os comandos dispon\xEDveis"},{label:"@neocortex *arch-plan",description:"Planejar a arquitetura de um novo projeto"},{label:"@neocortex *yolo",description:"Modo de implementa\xE7\xE3o r\xE1pida"},{label:"@neocortex *status",description:"Ver o status do seu projeto"}],tip:"Dica: execute `@neocortex *menu` para a lista completa (j\xE1 filtrada pelo seu tier)."}};function c(t=process.env){return(t.LC_ALL??t.LANG??"").toLowerCase().startsWith("pt")?"pt-BR":"en"}function p(t){const o=i[t],n=62,s=o.commands.reduce((r,a)=>Math.max(r,a.label.length),0),e=[];e.push(o.banner),e.push(""),e.push(o.intro),e.push("");for(const r of o.commands){const a=r.label.padEnd(s+2);e.push(`  ${a}${r.description}`)}return e.push(""),e.push(o.tip),e.push("".padEnd(n,"\u2500")),e.push(""),e.join(`
+`)}export{i as FIRST_RUN_MESSAGES,c as detectFirstRunLocale,p as renderFirstRunMessage};

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

@@ -53,6 +53,8 @@ export { ClientCircuitBreaker, type CircuitState, type CircuitBreakerConfig, typ
 export { OfflineTelemetryQueue, type TelemetryEvent, type QueueConfig, type QueueStats, type FlushResult, } from './telemetry/index.js';
 export { getCacheStatus, formatCacheStatus, type CacheStatusInfo, type CacheStatusOptions, } from './commands/cache-status.js';
 export { getSubagentApprovalPolicy, ensureManagedSubagentApprovalPolicy, setSubagentApprovalMode, resetSubagentApprovalMode, ApprovalPolicyConfigError, type ApprovalPolicyConfigOptions, type ApprovalPolicyConfigResult, } from './config.js';
+export { NATIVE_BACKGROUND_REASON_CODES, planEpicBackgroundDispatch, type AuthorizedNativeBackgroundEntryV1, type EpicBackgroundDispatchDecisionV1, type NativeBackgroundAdmissionInput, type NativeBackgroundTaskDirectiveV1, } from './runner/epic-background-dispatcher.js';
+export { NATIVE_BACKGROUND_MAX_POLLS, NativeBackgroundRootError, boundedNativeBackgroundPoll, runNativeBackgroundRoot, type BoundedNativeBackgroundPollResultV1, type NativeBackgroundReservationV1, type NativeBackgroundRootPorts, type NativeBackgroundRootResultV1, } from './runner/headless/background-root.js';
 export { deriveOpaqueNativeAgentHandle, openNativeAgentPrivateStore, resolveNativeAgentPrivateRuntimePaths, } from './continuity/native-agent-store.js';
 export { configCliHandler, type ConfigCliDependencies, } from './commands/config.js';
 export { storyCheckpointCliHandler, parseStoryCheckpointArgs, } from './commands/story-checkpoint.js';

package/packages/client/dist/index.js

@@ -1,47 +1 @@
-/**
- * @license FSL-1.1
- * Copyright (c) 2026 OrNexus AI
- *
- * This file is part of Neocortex CLI, licensed under the
- * Functional Source License, Version 1.1 (FSL-1.1).
- *
- * Change Date: February 20, 2029
- * Change License: MIT
- *
- * See the LICENSE file in the project root for full license text.
- */
-export { ResolverMode, NoOpCache } from './types/index.js';
-export { PUBLIC_PROJECTION_BUNDLE, PUBLIC_PROJECTION_GENERATION_ID, PUBLIC_PROJECTION_BUNDLE_HASH, } from './generated/public-projections.generated.js';
-// ── Implementations ─────────────────────────────────────────────────────
-export { LocalResolver } from './resolvers/local-resolver.js';
-export { RemoteResolver, RemoteResolverError } from './resolvers/remote-resolver.js';
-// ── Cache ──────────────────────────────────────────────────────────────
-export { EncryptedCache } from './cache/index.js';
-// ── Factory ─────────────────────────────────────────────────────────────
-export { createResolver, selectResolver, } from './config/resolver-selection.js';
-// ── Context ─────────────────────────────────────────────────────────────
-export { collectContext, } from './context/context-collector.js';
-export { sanitizeValue, sanitizeRecord, sanitizeObject, } from './context/context-sanitizer.js';
-// ── Machine ──────────────────────────────────────────────────────────────
-export { getMachineFingerprint } from './machine/index.js';
-// ── License ──────────────────────────────────────────────────────────────
-export { LicenseClient } from './license/index.js';
-export { ClaudeCodeAdapter, CursorAdapter, VSCodeAdapter, GeminiAdapter, CodexAdapter, AntigravityAdapter, AdapterRegistry, UnknownTargetError, createDefaultRegistry, detectPlatform, isValidTargetId, } from './adapters/index.js';
-// ── Resilience (Story 42.9) ──────────────────────────────────────────────
-export { ClientCircuitBreaker, DegradationManager, DegradationLevel, FreshnessIndicator, RecoveryDetector, } from './resilience/index.js';
-// ── Telemetry (Story 42.9) ──────────────────────────────────────────────
-export { OfflineTelemetryQueue, } from './telemetry/index.js';
-// ── Commands (Story 42.9) ───────────────────────────────────────────────
-export { getCacheStatus, formatCacheStatus, } from './commands/cache-status.js';
-export { getSubagentApprovalPolicy, ensureManagedSubagentApprovalPolicy, setSubagentApprovalMode, resetSubagentApprovalMode, ApprovalPolicyConfigError, } from './config.js';
-export { deriveOpaqueNativeAgentHandle, openNativeAgentPrivateStore, resolveNativeAgentPrivateRuntimePaths, } from './continuity/native-agent-store.js';
-export { configCliHandler, } from './commands/config.js';
-export { storyCheckpointCliHandler, parseStoryCheckpointArgs, } from './commands/story-checkpoint.js';
-export { beginDirectYoloStoryCommit, finalizeDirectYoloStoryCheckpoint, issueDirectYoloSetupLeaseHandoff, prepareDirectYoloSetup, recoverLegacyDirectYoloStoryCheckpoint, } from './git/direct-yolo-checkpoint.js';
-export { FRONTMATTER_DIAGNOSTIC_CATEGORIES, FRONTMATTER_DIAGNOSTIC_REASON_CODES, getFrontmatterDiagnostic, formatFrontmatterDiagnostic, } from './errors/frontmatter-diagnostics.js';
-// ── Invoke Command (Story 45.2) ────────────────────────────────────────
-export { invoke, invokeCliHandler, collectStateSnapshot, } from './commands/invoke.js';
-// ── Tier Awareness (Epic 60) ─────────────────────────────────────────
-export { TierAwareClient, } from './tier/index.js';
-// ── Project Memory (P130) ──────────────────────────────────────────────
-export { buildProjectMemoryContent, createNodeProjectMemoryFs, writeProjectMemory, writeProjectMemoryTargetFiles, } from './memory/project-memory-writer.js';
+import{ResolverMode as o,NoOpCache as t}from"./types/index.js";import{PUBLIC_PROJECTION_BUNDLE as i,PUBLIC_PROJECTION_GENERATION_ID as n,PUBLIC_PROJECTION_BUNDLE_HASH as p}from"./generated/public-projections.generated.js";import{LocalResolver as l}from"./resolvers/local-resolver.js";import{RemoteResolver as d,RemoteResolverError as s}from"./resolvers/remote-resolver.js";import{EncryptedCache as f}from"./cache/index.js";import{createResolver as A,selectResolver as R}from"./config/resolver-selection.js";import{collectContext as x}from"./context/context-collector.js";import{sanitizeValue as N,sanitizeRecord as S,sanitizeObject as E}from"./context/context-sanitizer.js";import{getMachineFingerprint as D}from"./machine/index.js";import{LicenseClient as y}from"./license/index.js";import{ClaudeCodeAdapter as _,CursorAdapter as I,VSCodeAdapter as h,GeminiAdapter as M,CodexAdapter as k,AntigravityAdapter as B,AdapterRegistry as L,UnknownTargetError as b,createDefaultRegistry as F,detectPlatform as U,isValidTargetId as G}from"./adapters/index.js";import{ClientCircuitBreaker as j,DegradationManager as V,DegradationLevel as Y,FreshnessIndicator as w,RecoveryDetector as z}from"./resilience/index.js";import{OfflineTelemetryQueue as K}from"./telemetry/index.js";import{getCacheStatus as Q,formatCacheStatus as X}from"./commands/cache-status.js";import{getSubagentApprovalPolicy as Z,ensureManagedSubagentApprovalPolicy as $,setSubagentApprovalMode as ee,resetSubagentApprovalMode as re,ApprovalPolicyConfigError as oe}from"./config.js";import{NATIVE_BACKGROUND_REASON_CODES as ae,planEpicBackgroundDispatch as ie}from"./runner/epic-background-dispatcher.js";import{NATIVE_BACKGROUND_MAX_POLLS as pe,NativeBackgroundRootError as ce,boundedNativeBackgroundPoll as le,runNativeBackgroundRoot as me}from"./runner/headless/background-root.js";import{deriveOpaqueNativeAgentHandle as se,openNativeAgentPrivateStore as Ce,resolveNativeAgentPrivateRuntimePaths as fe}from"./continuity/native-agent-store.js";import{configCliHandler as Ae}from"./commands/config.js";import{storyCheckpointCliHandler as ve,parseStoryCheckpointArgs as xe}from"./commands/story-checkpoint.js";import{beginDirectYoloStoryCommit as Ne,finalizeDirectYoloStoryCheckpoint as Se,issueDirectYoloSetupLeaseHandoff as Ee,prepareDirectYoloSetup as Oe,recoverLegacyDirectYoloStoryCheckpoint as De}from"./git/direct-yolo-checkpoint.js";import{FRONTMATTER_DIAGNOSTIC_CATEGORIES as ye,FRONTMATTER_DIAGNOSTIC_REASON_CODES as Pe,getFrontmatterDiagnostic as _e,formatFrontmatterDiagnostic as Ie}from"./errors/frontmatter-diagnostics.js";import{invoke as Me,invokeCliHandler as ke,collectStateSnapshot as Be}from"./commands/invoke.js";import{TierAwareClient as be}from"./tier/index.js";import{buildProjectMemoryContent as Ue,createNodeProjectMemoryFs as Ge,writeProjectMemory as He,writeProjectMemoryTargetFiles as je}from"./memory/project-memory-writer.js";export{L as AdapterRegistry,B as AntigravityAdapter,oe as ApprovalPolicyConfigError,_ as ClaudeCodeAdapter,j as ClientCircuitBreaker,k as CodexAdapter,I as CursorAdapter,Y as DegradationLevel,V as DegradationManager,f as EncryptedCache,ye as FRONTMATTER_DIAGNOSTIC_CATEGORIES,Pe as FRONTMATTER_DIAGNOSTIC_REASON_CODES,w as FreshnessIndicator,M as GeminiAdapter,y as LicenseClient,l as LocalResolver,pe as NATIVE_BACKGROUND_MAX_POLLS,ae as NATIVE_BACKGROUND_REASON_CODES,ce as NativeBackgroundRootError,t as NoOpCache,K as OfflineTelemetryQueue,i as PUBLIC_PROJECTION_BUNDLE,p as PUBLIC_PROJECTION_BUNDLE_HASH,n as PUBLIC_PROJECTION_GENERATION_ID,z as RecoveryDetector,d as RemoteResolver,s as RemoteResolverError,o as ResolverMode,be as TierAwareClient,b as UnknownTargetError,h as VSCodeAdapter,Ne as beginDirectYoloStoryCommit,le as boundedNativeBackgroundPoll,Ue as buildProjectMemoryContent,x as collectContext,Be as collectStateSnapshot,Ae as configCliHandler,F as createDefaultRegistry,Ge as createNodeProjectMemoryFs,A as createResolver,se as deriveOpaqueNativeAgentHandle,U as detectPlatform,$ as ensureManagedSubagentApprovalPolicy,Se as finalizeDirectYoloStoryCheckpoint,X as formatCacheStatus,Ie as formatFrontmatterDiagnostic,Q as getCacheStatus,_e as getFrontmatterDiagnostic,D as getMachineFingerprint,Z as getSubagentApprovalPolicy,Me as invoke,ke as invokeCliHandler,G as isValidTargetId,Ee as issueDirectYoloSetupLeaseHandoff,Ce as openNativeAgentPrivateStore,xe as parseStoryCheckpointArgs,ie as planEpicBackgroundDispatch,Oe as prepareDirectYoloSetup,De as recoverLegacyDirectYoloStoryCheckpoint,re as resetSubagentApprovalMode,fe as resolveNativeAgentPrivateRuntimePaths,me as runNativeBackgroundRoot,E as sanitizeObject,S as sanitizeRecord,N as sanitizeValue,R as selectResolver,ee as setSubagentApprovalMode,ve as storyCheckpointCliHandler,He as writeProjectMemory,je as writeProjectMemoryTargetFiles};

package/packages/client/dist/invocation/invoke-input.js

@@ -1,24 +1 @@
-import { createInvokeInputEnvelopeV2, } from '../../../shared/dist/invocation/index.js';
-export class InvokeInputDecodeError extends Error {
-    source;
-    code = 'INVOCATION_MALFORMED_INPUT';
-    reason = 'invalid-utf8';
-    constructor(source) {
-        super(`${source} must contain valid UTF-8 text. Use --args-file or --stdin with an unmodified UTF-8 document.`);
-        this.source = source;
-        this.name = 'InvokeInputDecodeError';
-    }
-}
-export function decodeExplicitInvokeInput(source, value) {
-    if (typeof value === 'string')
-        return value;
-    try {
-        return new TextDecoder('utf-8', { fatal: true }).decode(value);
-    }
-    catch {
-        throw new InvokeInputDecodeError(source);
-    }
-}
-export function buildInvokeInputEnvelope(source, value) {
-    return createInvokeInputEnvelopeV2(source, decodeExplicitInvokeInput(source, value));
-}
+import{createInvokeInputEnvelopeV2 as n}from"../../../shared/dist/invocation/index.js";class o extends Error{source;code="INVOCATION_MALFORMED_INPUT";reason="invalid-utf8";constructor(e){super(`${e} must contain valid UTF-8 text. Use --args-file or --stdin with an unmodified UTF-8 document.`),this.source=e,this.name="InvokeInputDecodeError"}}function r(t,e){if(typeof e=="string")return e;try{return new TextDecoder("utf-8",{fatal:!0}).decode(e)}catch{throw new o(t)}}function c(t,e){return n(t,r(t,e))}export{o as InvokeInputDecodeError,c as buildInvokeInputEnvelope,r as decodeExplicitInvokeInput};

package/packages/client/dist/license/host-auth-recovery.d.ts

@@ -0,0 +1,158 @@
+import { EncryptedCache } from '../cache/encrypted-cache.js';
+export type AuthCauseV1 = 'valid' | 'near-expiry' | 'expired' | 'not-configured' | 'store-unavailable' | 'store-corrupt' | 'keychain-unavailable' | 'transport-error' | 'timeout' | 'rate-limited' | 'service-unavailable' | 'revoked' | 'scope-denied' | 'client-denied' | 'protocol-invalid' | 'persistence-failed' | 'rotation-uncertain' | 'capability-unavailable' | 'revision-conflict';
+export type AuthRecoveryResultV1 = {
+    readonly status: 'authenticated';
+    readonly generation: number;
+    readonly accessCredential: string;
+    readonly expiresAt: string;
+} | {
+    readonly status: 'refresh-required';
+    readonly cause: AuthCauseV1;
+    readonly action: 'prepare' | 'retry-later' | 'reactivate' | 'request-scope' | 'recover-explicitly' | 'stop';
+} | {
+    readonly status: 'uncertain';
+    readonly cause: 'rotation-uncertain' | 'persistence-failed';
+    readonly recoveryId: string;
+    readonly action: 'reconcile' | 'recover-explicitly';
+} | {
+    readonly status: 'not-configured';
+    readonly action: 'activate';
+};
+export type AuthRecoveryPhase = 'prepared' | 'request-started' | 'response-received' | 'generation-committed' | 'uncertain' | 'completed' | 'aborted-before-request';
+export interface AuthRecoveryJournalV1 {
+    readonly recoveryId: string;
+    readonly operationId: string;
+    readonly idempotencyKey: string;
+    readonly requestDigest: string;
+    readonly owner: string;
+    readonly createdAt: string;
+    readonly expiresAt: string;
+    readonly attemptCount: 0 | 1;
+    readonly replayCount: 0 | 1;
+    readonly phase: AuthRecoveryPhase;
+    readonly responseDigest?: string;
+}
+export interface AuthGenerationDocumentV1 {
+    readonly schemaVersion: 'AuthGeneration/1.0';
+    readonly revision: number;
+    readonly identityHash: string;
+    readonly accepted: null | {
+        readonly generation: number;
+        readonly accessToken: string;
+        readonly accessExpiresAt: string;
+        readonly refreshToken: string | null;
+        readonly refreshExpiresAt: string | null;
+        readonly acceptedAt: string;
+        readonly responseDigest: string;
+    };
+    readonly activeRecovery: AuthRecoveryJournalV1 | null;
+    readonly receipts: readonly {
+        readonly recoveryId: string;
+        readonly operationId: string;
+        readonly outcome: string;
+        readonly completedAt: string;
+    }[];
+}
+export interface AuthGenerationStore {
+    read(identityHash: string): Promise<AuthGenerationDocumentV1 | null>;
+    compareAndSet(expectedRevision: number, document: AuthGenerationDocumentV1): Promise<void>;
+}
+/** Private generation adapter backed by EncryptedCache's mandatory CAS path. */
+export declare class EncryptedAuthGenerationStore implements AuthGenerationStore {
+    private readonly cache;
+    constructor(cache: EncryptedCache);
+    private key;
+    read(identityHash: string): Promise<AuthGenerationDocumentV1 | null>;
+    compareAndSet(expectedRevision: number, document: AuthGenerationDocumentV1): Promise<void>;
+}
+export interface AuthRefreshSuccess {
+    readonly token: string;
+    readonly expiresAt: string;
+    readonly refreshToken?: string | null;
+    readonly refreshExpiresAt?: string | null;
+}
+export interface AuthRecoveryInput {
+    readonly identityHash: string;
+    readonly recoveryId: string;
+    readonly operationId: string;
+    readonly idempotencyKey: string;
+    readonly requestDigest: string;
+    readonly owner: string;
+    readonly leaseMs?: number;
+    readonly timeoutMs?: number;
+    readonly now?: () => number;
+    readonly refresh: (signal?: AbortSignal) => Promise<AuthRefreshSuccess>;
+}
+export declare function createAuthIdentityHash(parts: readonly string[]): string;
+export declare function validateAuthGenerationDocument(value: unknown, expectedIdentityHash?: string): AuthGenerationDocumentV1;
+export declare function recoverHostAuthentication(store: AuthGenerationStore, input: AuthRecoveryInput): Promise<AuthRecoveryResultV1>;
+export type AuthBusinessReplayDecisionV1 = {
+    readonly kind: 'replay-once';
+    readonly recoveryId: string;
+} | {
+    readonly kind: 'reconcile-receipt';
+    readonly operationId: string;
+} | {
+    readonly kind: 'stop';
+    readonly reasonCode: string;
+};
+export declare function decideAuthBusinessReplay(input: {
+    readonly recoveryId: string;
+    readonly operationId: string;
+    readonly generationCommitted: boolean;
+    readonly identityMatches: boolean;
+    readonly requestMatches: boolean;
+    readonly replayCount: number;
+    readonly receipt: 'not-accepted' | 'accepted' | 'unknown';
+    readonly supportsIdempotency: boolean;
+    readonly rotationUncertain: boolean;
+}): AuthBusinessReplayDecisionV1;
+/**
+ * Reserves the single business replay by CAS before returning authorization.
+ * Consumers perform the business effect only after this function succeeds.
+ */
+export declare function reserveAuthBusinessReplay(store: AuthGenerationStore, input: {
+    readonly identityHash: string;
+    readonly recoveryId: string;
+    readonly operationId: string;
+    readonly requestDigest: string;
+    readonly receipt: 'not-accepted' | 'accepted' | 'unknown';
+    readonly supportsIdempotency: boolean;
+    readonly rotationUncertain?: boolean;
+}): Promise<AuthBusinessReplayDecisionV1>;
+/** Records the compare-bound business outcome before a later recovery may replace the journal. */
+export declare function completeAuthRecovery(store: AuthGenerationStore, input: {
+    readonly identityHash: string;
+    readonly recoveryId: string;
+    readonly operationId: string;
+    readonly outcome: string;
+    readonly completedAt?: string;
+}): Promise<AuthGenerationDocumentV1>;
+export type AuthCausalEvidenceV1 = {
+    readonly kind: 'token';
+    readonly credential: string;
+    readonly expiresAt: string;
+    readonly generation: number;
+    readonly now?: number;
+} | {
+    readonly kind: 'configuration';
+    readonly configured: boolean;
+} | {
+    readonly kind: 'store';
+    readonly cause: 'store-unavailable' | 'store-corrupt' | 'keychain-unavailable';
+} | {
+    readonly kind: 'transport';
+    readonly timeout?: boolean;
+    readonly requestStarted?: boolean;
+    readonly recoveryId?: string;
+} | {
+    readonly kind: 'http';
+    readonly status: number;
+    readonly errorCode?: string;
+} | {
+    readonly kind: 'persistence';
+    readonly recoveryId: string;
+};
+/** Pure evidence-to-cause mapping. Generic HTTP status never proves revocation. */
+export declare function classifyAuthCausalEvidence(evidence: AuthCausalEvidenceV1): AuthRecoveryResultV1;
+export declare function newRecoveryId(): string;

package/packages/client/dist/license/host-auth-recovery.js

@@ -0,0 +1 @@
+import{createHash as v,randomUUID as D}from"node:crypto";class K{cache;constructor(t){this.cache=t}key(t){if(!u.test(t))throw new Error("auth-business-identity-mismatch");return`neocortex:auth-generation:v1:${t}`}async read(t){const r=await this.cache.getAuthoritative(this.key(t));if(r===null)return null;try{return d(JSON.parse(r),t)}catch(o){throw new Error("auth-generation-corrupt",{cause:o})}}async compareAndSet(t,r){d(r,r.identityHash);const o=this.key(r.identityHash),i=await this.cache.getAuthoritative(o);let s=0;if(i!==null)try{s=d(JSON.parse(i),r.identityHash).revision}catch(n){throw new Error("auth-generation-corrupt",{cause:n})}if(s!==t||r.revision!==t+1)throw new Error("auth-generation-revision-conflict");await this.cache.setAuthoritative(o,JSON.stringify(r),{expectedPlaintextSha256:i===null?null:v("sha256").update(i).digest("hex")})}}const u=/^[a-f0-9]{64}$/,p=/^[A-Za-z0-9._:-]{1,128}$/;function J(e){if(e.length!==5||e.some(t=>t.length===0||t.length>256||/[\r\n\0]/.test(t)))throw new Error("auth-business-identity-mismatch");return v("sha256").update("neocortex-auth-generation-v1\0").update(e.join("\0")).digest("hex")}function d(e,t){let r;try{r=JSON.stringify(e)}catch{throw new Error("auth-generation-corrupt")}if(!l(e)||typeof r!="string")throw new Error("auth-generation-corrupt");if(Buffer.byteLength(r,"utf8")>256*1024)throw new Error("auth-generation-capacity");const o=e;if(o.schemaVersion!=="AuthGeneration/1.0"||!Number.isSafeInteger(o.revision)||o.revision<0||!u.test(o.identityHash)||t&&o.identityHash!==t||!Array.isArray(o.receipts)||o.receipts.length>32)throw new Error("auth-generation-corrupt");if(!m(e,["schemaVersion","revision","identityHash","accepted","activeRecovery","receipts"]))throw new Error("auth-generation-corrupt");S(o.accepted),H(o.activeRecovery);for(const i of o.receipts)T(i);return o}function C(e){return{schemaVersion:"AuthGeneration/1.0",revision:0,identityHash:e,accepted:null,activeRecovery:null,receipts:[]}}async function h(e,t,r){const o=d({...t,...r,revision:t.revision+1},t.identityHash);return await e.compareAndSet(t.revision,o),o}async function U(e,t){if(!u.test(t.identityHash)||!u.test(t.requestDigest)||![t.recoveryId,t.operationId,t.idempotencyKey,t.owner].every(a=>p.test(a)))return{status:"refresh-required",cause:"protocol-invalid",action:"stop"};const r=t.now??Date.now,o=Math.min(Math.max(t.leaseMs??3e4,1),6e4),i=Math.min(Math.max(t.timeoutMs??3e4,1),3e4);let s;try{s=d(await e.read(t.identityHash)??C(t.identityHash),t.identityHash)}catch(a){return x(a)}const n=s.activeRecovery;if(n)if(n.recoveryId===t.recoveryId){if(!_(n,t))return{status:"refresh-required",cause:"protocol-invalid",action:"stop"};if((n.phase==="generation-committed"||n.phase==="completed")&&s.accepted)return A(s.accepted);if(n.attemptCount===1)return y(t.recoveryId,n.phase==="response-received"?"persistence-failed":"rotation-uncertain");if(Date.parse(n.expiresAt)>r()&&n.owner!==t.owner)return{status:"refresh-required",cause:"revision-conflict",action:"retry-later"}}else{if(n.attemptCount===1&&!["generation-committed","completed","aborted-before-request"].includes(n.phase))return y(n.recoveryId,n.phase==="response-received"?"persistence-failed":"rotation-uncertain");if(n.phase==="generation-committed")return{status:"refresh-required",cause:"revision-conflict",action:"retry-later"};if(n.attemptCount===0&&Date.parse(n.expiresAt)>r())return{status:"refresh-required",cause:"revision-conflict",action:"retry-later"}}const g={recoveryId:t.recoveryId,operationId:t.operationId,idempotencyKey:t.idempotencyKey,requestDigest:t.requestDigest,owner:t.owner,createdAt:new Date(r()).toISOString(),expiresAt:new Date(r()+o).toISOString(),attemptCount:0,replayCount:0,phase:"prepared"};try{(!n||n.recoveryId!==t.recoveryId||n.owner!==t.owner||n.phase!=="prepared")&&(s=await h(e,s,{activeRecovery:g}));const a={...g,attemptCount:1,phase:"request-started"};s=await h(e,s,{activeRecovery:a});let c;try{c=await M(t.refresh,i)}catch{return await q(e,s,a),y(t.recoveryId,"rotation-uncertain")}if(!c.token||c.token.length>65536||!Number.isFinite(Date.parse(c.expiresAt)))return await q(e,s,a),y(t.recoveryId,"rotation-uncertain");const w=v("sha256").update(JSON.stringify(c)).digest("hex"),I={...a,phase:"response-received",responseDigest:w};s=await h(e,s,{activeRecovery:I});const k={generation:(s.accepted?.generation??0)+1,accessToken:c.token,accessExpiresAt:c.expiresAt,refreshToken:c.refreshToken??null,refreshExpiresAt:c.refreshExpiresAt??null,acceptedAt:new Date(r()).toISOString(),responseDigest:w},E={...I,phase:"generation-committed"},b=await h(e,s,{accepted:k,activeRecovery:E});return A(b.accepted)}catch(a){return s.activeRecovery?.attemptCount!==1?x(a):y(t.recoveryId,"persistence-failed")}}function R(e){return!e.identityMatches||!e.requestMatches?{kind:"stop",reasonCode:"auth-business-identity-mismatch"}:e.rotationUncertain||!e.generationCommitted?{kind:"stop",reasonCode:"auth-business-replay-unsafe"}:e.replayCount!==0?{kind:"stop",reasonCode:"auth-business-replay-exhausted"}:e.receipt==="accepted"?{kind:"reconcile-receipt",operationId:e.operationId}:e.receipt==="unknown"&&!e.supportsIdempotency?{kind:"reconcile-receipt",operationId:e.operationId}:{kind:"replay-once",recoveryId:e.recoveryId}}async function B(e,t){let r;try{r=d(await e.read(t.identityHash),t.identityHash)}catch{return{kind:"stop",reasonCode:"auth-business-replay-unsafe"}}const o=r.activeRecovery;if(!o||o.recoveryId!==t.recoveryId||o.operationId!==t.operationId)return{kind:"stop",reasonCode:"auth-business-identity-mismatch"};const i=R({recoveryId:t.recoveryId,operationId:t.operationId,generationCommitted:o.phase==="generation-committed"&&r.accepted!==null,identityMatches:r.identityHash===t.identityHash,requestMatches:o.requestDigest===t.requestDigest,replayCount:o.replayCount,receipt:t.receipt,supportsIdempotency:t.supportsIdempotency,rotationUncertain:t.rotationUncertain===!0||o.phase==="uncertain"});if(i.kind!=="replay-once")return i;try{return await h(e,r,{activeRecovery:{...o,replayCount:1}}),i}catch{return{kind:"stop",reasonCode:"auth-generation-revision-conflict"}}}async function G(e,t){if(!u.test(t.identityHash)||![t.recoveryId,t.operationId,t.outcome].every(n=>p.test(n)))throw new Error("auth-business-identity-mismatch");const r=d(await e.read(t.identityHash),t.identityHash),o=r.activeRecovery;if(!o||o.recoveryId!==t.recoveryId||o.operationId!==t.operationId)throw new Error("auth-business-identity-mismatch");const i=r.receipts.find(n=>n.recoveryId===t.recoveryId);if(i){if(i.operationId!==t.operationId||i.outcome!==t.outcome)throw new Error("auth-business-identity-mismatch");return r}if(o.phase!=="generation-committed"||r.accepted===null)throw new Error("auth-business-replay-unsafe");if(r.receipts.length>=32)throw new Error("auth-generation-capacity");const s=t.completedAt??new Date().toISOString();if(!f(s))throw new Error("auth-business-identity-mismatch");return h(e,r,{activeRecovery:{...o,phase:"completed"},receipts:[...r.receipts,{recoveryId:t.recoveryId,operationId:t.operationId,outcome:t.outcome,completedAt:s}]})}function F(e){switch(e.kind){case"token":{const t=e.now??Date.now(),r=Date.parse(e.expiresAt);return Number.isFinite(r)?r<=t?{status:"refresh-required",cause:"expired",action:"prepare"}:r-t<=3e5?{status:"refresh-required",cause:"near-expiry",action:"prepare"}:{status:"authenticated",generation:e.generation,accessCredential:e.credential,expiresAt:e.expiresAt}:{status:"refresh-required",cause:"protocol-invalid",action:"stop"}}case"configuration":return e.configured?{status:"refresh-required",cause:"store-unavailable",action:"stop"}:{status:"not-configured",action:"activate"};case"store":return{status:"refresh-required",cause:e.cause,action:e.cause==="store-unavailable"?"retry-later":"stop"};case"transport":return e.requestStarted?y(e.recoveryId??"unknown-recovery","rotation-uncertain"):{status:"refresh-required",cause:e.timeout?"timeout":"transport-error",action:"retry-later"};case"http":{const t=e.errorCode??"";return e.status===429?{status:"refresh-required",cause:"rate-limited",action:"retry-later"}:e.status>=500?{status:"refresh-required",cause:"service-unavailable",action:"retry-later"}:t==="invalid_grant"||t==="revoked"?{status:"refresh-required",cause:"revoked",action:"reactivate"}:t==="invalid_scope"||t==="scope_denied"?{status:"refresh-required",cause:"scope-denied",action:"request-scope"}:t==="client_denied"?{status:"refresh-required",cause:"client-denied",action:"stop"}:{status:"refresh-required",cause:"protocol-invalid",action:"stop"}}case"persistence":return y(e.recoveryId,"persistence-failed")}}function P(){return D()}function S(e){if(e!==null){if(!l(e)||!m(e,["generation","accessToken","accessExpiresAt","refreshToken","refreshExpiresAt","acceptedAt","responseDigest"]))throw new Error("auth-generation-corrupt");if(!Number.isSafeInteger(e.generation)||e.generation<1||typeof e.accessToken!="string"||e.accessToken.length===0||e.accessToken.length>65536||e.refreshToken!==null&&(typeof e.refreshToken!="string"||e.refreshToken.length>65536)||!f(e.accessExpiresAt)||!f(e.acceptedAt)||e.refreshExpiresAt!==null&&!f(e.refreshExpiresAt)||!u.test(e.responseDigest))throw new Error("auth-generation-corrupt")}}function H(e){if(e===null)return;if(!l(e)||!m(e,["recoveryId","operationId","idempotencyKey","requestDigest","owner","createdAt","expiresAt","attemptCount","replayCount","phase","responseDigest"],!0))throw new Error("auth-generation-corrupt");const t=["prepared","request-started","response-received","generation-committed","uncertain","completed","aborted-before-request"];if(![e.recoveryId,e.operationId,e.idempotencyKey,e.owner].every(r=>p.test(r))||!u.test(e.requestDigest)||!f(e.createdAt)||!f(e.expiresAt)||![0,1].includes(e.attemptCount)||![0,1].includes(e.replayCount)||!t.includes(e.phase)||e.responseDigest!==void 0&&!u.test(e.responseDigest))throw new Error("auth-generation-corrupt")}function T(e){if(!l(e)||!m(e,["recoveryId","operationId","outcome","completedAt"])||!p.test(e.recoveryId)||!p.test(e.operationId)||!p.test(e.outcome)||!f(e.completedAt))throw new Error("auth-generation-corrupt")}function _(e,t){return e.operationId===t.operationId&&e.idempotencyKey===t.idempotencyKey&&e.requestDigest===t.requestDigest}function A(e){return{status:"authenticated",generation:e.generation,accessCredential:e.accessToken,expiresAt:e.accessExpiresAt}}function y(e,t){return{status:"uncertain",cause:t,recoveryId:e,action:"recover-explicitly"}}function x(e){const t=e instanceof Error?e.message:"";return t==="auth-generation-revision-conflict"||t==="auth-recovery-backpressure"?{status:"refresh-required",cause:"revision-conflict",action:"retry-later"}:t==="auth-generation-corrupt"||t==="auth-generation-path-unsafe"?{status:"refresh-required",cause:"store-corrupt",action:"stop"}:{status:"refresh-required",cause:"store-unavailable",action:"retry-later"}}async function q(e,t,r){try{await h(e,t,{activeRecovery:{...r,phase:"uncertain"}})}catch{}}async function M(e,t){const r=new AbortController;let o;const i=new Promise((s,n)=>{o=setTimeout(()=>{r.abort(),n(new Error("auth-refresh-timeout"))},t),o.unref?.()});try{return await Promise.race([e(r.signal),i])}finally{o&&clearTimeout(o)}}function f(e){return typeof e=="string"&&Number.isFinite(Date.parse(e))}function l(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)}function m(e,t,r=!1){const o=Object.keys(e).sort();return(r?t.slice(0,-1):t).every(s=>o.includes(s))&&o.every(s=>t.includes(s))}export{K as EncryptedAuthGenerationStore,F as classifyAuthCausalEvidence,G as completeAuthRecovery,J as createAuthIdentityHash,R as decideAuthBusinessReplay,P as newRecoveryId,U as recoverHostAuthentication,B as reserveAuthBusinessReplay,d as validateAuthGenerationDocument};