@ornexus/neocortex 4.60.67 → 4.60.68

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

@@ -1 +1,237 @@
-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};
+/**
+ * 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,
+    };
+}

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

@@ -1,2 +1,60 @@
-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};
+/**
+ * @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');
+}

package/packages/client/dist/index.js

@@ -1 +1,47 @@
-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 c}from"./resolvers/local-resolver.js";import{RemoteResolver as s,RemoteResolverError as f}from"./resolvers/remote-resolver.js";import{EncryptedCache as d}from"./cache/index.js";import{createResolver as A,selectResolver as x}from"./config/resolver-selection.js";import{collectContext as R}from"./context/context-collector.js";import{sanitizeValue as u,sanitizeRecord as y,sanitizeObject as O}from"./context/context-sanitizer.js";import{getMachineFingerprint as D}from"./machine/index.js";import{LicenseClient as N}from"./license/index.js";import{ClaudeCodeAdapter as I,CursorAdapter as _,VSCodeAdapter as h,GeminiAdapter as M,CodexAdapter as L,AntigravityAdapter as k,AdapterRegistry as F,UnknownTargetError as b,createDefaultRegistry as H,detectPlatform as B,isValidTargetId as U}from"./adapters/index.js";import{ClientCircuitBreaker as G,DegradationManager as Y,DegradationLevel as w,FreshnessIndicator as z,RecoveryDetector as J}from"./resilience/index.js";import{OfflineTelemetryQueue as q}from"./telemetry/index.js";import{getCacheStatus as K,formatCacheStatus as W}from"./commands/cache-status.js";import{getSubagentApprovalPolicy as Z,ensureManagedSubagentApprovalPolicy as $,setSubagentApprovalMode as ee,resetSubagentApprovalMode as re,ApprovalPolicyConfigError as oe}from"./config.js";import{deriveOpaqueNativeAgentHandle as ae,openNativeAgentPrivateStore as ie,resolveNativeAgentPrivateRuntimePaths as ne}from"./continuity/native-agent-store.js";import{configCliHandler as le}from"./commands/config.js";import{storyCheckpointCliHandler as me,parseStoryCheckpointArgs as se}from"./commands/story-checkpoint.js";import{beginDirectYoloStoryCommit as Ce,finalizeDirectYoloStoryCheckpoint as de,issueDirectYoloSetupLeaseHandoff as ge,prepareDirectYoloSetup as Ae,recoverLegacyDirectYoloStoryCheckpoint as xe}from"./git/direct-yolo-checkpoint.js";import{FRONTMATTER_DIAGNOSTIC_CATEGORIES as Re,FRONTMATTER_DIAGNOSTIC_REASON_CODES as Se,getFrontmatterDiagnostic as ue,formatFrontmatterDiagnostic as ye}from"./errors/frontmatter-diagnostics.js";import{invoke as Te,invokeCliHandler as De,collectStateSnapshot as Ee}from"./commands/invoke.js";import{TierAwareClient as Pe}from"./tier/index.js";import{buildProjectMemoryContent as _e,createNodeProjectMemoryFs as he,writeProjectMemory as Me,writeProjectMemoryTargetFiles as Le}from"./memory/project-memory-writer.js";export{F as AdapterRegistry,k as AntigravityAdapter,oe as ApprovalPolicyConfigError,I as ClaudeCodeAdapter,G as ClientCircuitBreaker,L as CodexAdapter,_ as CursorAdapter,w as DegradationLevel,Y as DegradationManager,d as EncryptedCache,Re as FRONTMATTER_DIAGNOSTIC_CATEGORIES,Se as FRONTMATTER_DIAGNOSTIC_REASON_CODES,z as FreshnessIndicator,M as GeminiAdapter,N as LicenseClient,c as LocalResolver,t as NoOpCache,q as OfflineTelemetryQueue,i as PUBLIC_PROJECTION_BUNDLE,p as PUBLIC_PROJECTION_BUNDLE_HASH,n as PUBLIC_PROJECTION_GENERATION_ID,J as RecoveryDetector,s as RemoteResolver,f as RemoteResolverError,o as ResolverMode,Pe as TierAwareClient,b as UnknownTargetError,h as VSCodeAdapter,Ce as beginDirectYoloStoryCommit,_e as buildProjectMemoryContent,R as collectContext,Ee as collectStateSnapshot,le as configCliHandler,H as createDefaultRegistry,he as createNodeProjectMemoryFs,A as createResolver,ae as deriveOpaqueNativeAgentHandle,B as detectPlatform,$ as ensureManagedSubagentApprovalPolicy,de as finalizeDirectYoloStoryCheckpoint,W as formatCacheStatus,ye as formatFrontmatterDiagnostic,K as getCacheStatus,ue as getFrontmatterDiagnostic,D as getMachineFingerprint,Z as getSubagentApprovalPolicy,Te as invoke,De as invokeCliHandler,U as isValidTargetId,ge as issueDirectYoloSetupLeaseHandoff,ie as openNativeAgentPrivateStore,se as parseStoryCheckpointArgs,Ae as prepareDirectYoloSetup,xe as recoverLegacyDirectYoloStoryCheckpoint,re as resetSubagentApprovalMode,ne as resolveNativeAgentPrivateRuntimePaths,O as sanitizeObject,y as sanitizeRecord,u as sanitizeValue,x as selectResolver,ee as setSubagentApprovalMode,me as storyCheckpointCliHandler,Me as writeProjectMemory,Le as writeProjectMemoryTargetFiles};
+/**
+ * @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';

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

@@ -1 +1,24 @@
-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};
+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));
+}

package/packages/client/dist/license/index.js

@@ -1 +1,5 @@
-import{LicenseClient as n}from"./license-client.js";export{n as LicenseClient};
+/**
+ * @license FSL-1.1
+ * Copyright (c) 2026 OrNexus AI
+ */
+export { LicenseClient } from './license-client.js';