@ornexus/neocortex 4.60.66 → 4.60.68

package/packages/client/dist/continuity/runner-bootstrap-policy.js

@@ -1 +1,172 @@
-const e={REQUIRED_DURABLE_COMMAND:"runner-bootstrap-required-durable-command",REQUIRED_UNKNOWN_GOAL_LOOP_OPERATION:"runner-bootstrap-required-unknown-goal-loop-operation",OPTIONAL_OPERATOR_COMMAND:"runner-bootstrap-optional-operator-command",SKIPPED_BOOTSTRAP_IN_PROGRESS:"runner-bootstrap-skipped-bootstrap-in-progress",SKIPPED_RUNNER_PLATFORM:"runner-bootstrap-skipped-runner-platform",SKIPPED_GOAL_LOOP_TICK:"runner-bootstrap-skipped-goal-loop-tick",SKIPPED_JOBS_COMMAND:"runner-bootstrap-skipped-jobs-command",SKIPPED_RUNNER_COMMAND:"runner-bootstrap-skipped-runner-command",SKIPPED_NON_CONTINUITY_COMMAND:"runner-bootstrap-skipped-non-continuity-command"},P=new Set(["goal","goals","durable-goal","continuity-goal","59"]),N=new Set(["loop","loops","durable-loop","continuity-loop","60"]),f=new Set(["jobs","job","continuity-jobs","61"]),R=new Set(["runner","neocortex-runner","continuity-runner","62"]),E=new Map([["goal-tick","goal"],["loop-tick","loop"]]),s=new Set(["create","start","resume","activate","run","run-once","restart","continue","unpause"]),p=new Set(["status","doctor","cancel","pause","report","reports","log","logs"]),S=new Set([...s,...p,"tick"]),A=/^@?(?:goal|loop|job)-[a-z0-9][a-z0-9._-]*$/i;function b(r){const o=T(r),n=l(o[0]);if(!n)return u("unknown","none",!1);const a=E.get(n);if(a)return u(a,"tick",!0);const i=d(n);return i==="unknown"?u("unknown","none",!1):u(i,O(_(o)),!0)}function k(r,o={}){if(C(o))return t(r,e.SKIPPED_BOOTSTRAP_IN_PROGRESS,"runner bootstrap skipped because a bootstrap guard is active.");if(D(o.platformTarget)==="runner")return t(r,e.SKIPPED_RUNNER_PLATFORM,"runner bootstrap skipped for runner platform invocation.");if((r.kind==="goal"||r.kind==="loop")&&r.operation==="tick")return t(r,e.SKIPPED_GOAL_LOOP_TICK,`runner bootstrap skipped for ${r.kind} tick operation.`);if(r.kind==="jobs")return t(r,e.SKIPPED_JOBS_COMMAND,"runner bootstrap skipped for jobs command.");if(r.kind==="runner")return t(r,e.SKIPPED_RUNNER_COMMAND,"runner bootstrap skipped for runner command.");if(r.kind!=="goal"&&r.kind!=="loop")return t(r,e.SKIPPED_NON_CONTINUITY_COMMAND,"runner bootstrap skipped for non-continuity command.");if(p.has(r.operation))return{action:"optional",failurePolicy:"fail-open",command:r.kind,operation:r.operation,reasonCodes:[e.OPTIONAL_OPERATOR_COMMAND],publicSummary:`runner bootstrap optional for ${r.kind} operator command.`,publicSafe:!0};const n=s.has(r.operation)||r.operation==="none"?e.REQUIRED_DURABLE_COMMAND:e.REQUIRED_UNKNOWN_GOAL_LOOP_OPERATION;return{action:"required",failurePolicy:"fail-closed",command:r.kind,operation:r.operation==="none"?"create":r.operation,reasonCodes:[n],publicSummary:`runner bootstrap required for durable ${r.kind} command.`,publicSafe:!0}}function M(r,o={}){return k(b(r),o)}function t(r,o,n){return{action:"skipped",failurePolicy:"not-applicable",command:r.kind,operation:r.operation,reasonCodes:[o],publicSummary:n,publicSafe:!0}}function u(r,o,n){return{kind:r,operation:o,recognizedAlias:n,publicSafe:!0}}function d(r){return P.has(r)?"goal":N.has(r)?"loop":f.has(r)?"jobs":R.has(r)?"runner":"unknown"}function O(r){const o=l(r);return o?S.has(o)?o:"unknown":"none"}function _(r){const o=r[1];if(o)return A.test(o)?r[2]:o}function T(r){return r.trim().split(/\s+/).filter(Boolean).slice(0,3)}function l(r){return(r??"").trim().toLowerCase().replace(/^\*/,"")}function D(r){return(r??"").trim().toLowerCase()}function C(r){return r.bootstrapInProgress?!0:c(r.environment?.NEOCORTEX_RUNNER_BOOTSTRAP_IN_PROGRESS)||c(r.environment?.NEOCORTEX_BOOTSTRAP_IN_PROGRESS)}function c(r){return/^(1|true|yes|on)$/i.test(r??"")}export{e as RUNNER_BOOTSTRAP_POLICY_REASON_CODES,k as classifyRunnerBootstrapPolicy,M as classifyRunnerBootstrapPolicyFromArgs,b as parseRunnerBootstrapCommandIntent};
+/**
+ * @license FSL-1.1
+ * Copyright (c) 2026 OrNexus AI
+ *
+ * P181.03 -- public-safe runner bootstrap classifier for durable goal/loop
+ * operations.
+ */
+export const RUNNER_BOOTSTRAP_POLICY_REASON_CODES = {
+    REQUIRED_DURABLE_COMMAND: 'runner-bootstrap-required-durable-command',
+    REQUIRED_UNKNOWN_GOAL_LOOP_OPERATION: 'runner-bootstrap-required-unknown-goal-loop-operation',
+    OPTIONAL_OPERATOR_COMMAND: 'runner-bootstrap-optional-operator-command',
+    SKIPPED_BOOTSTRAP_IN_PROGRESS: 'runner-bootstrap-skipped-bootstrap-in-progress',
+    SKIPPED_RUNNER_PLATFORM: 'runner-bootstrap-skipped-runner-platform',
+    SKIPPED_GOAL_LOOP_TICK: 'runner-bootstrap-skipped-goal-loop-tick',
+    SKIPPED_JOBS_COMMAND: 'runner-bootstrap-skipped-jobs-command',
+    SKIPPED_RUNNER_COMMAND: 'runner-bootstrap-skipped-runner-command',
+    SKIPPED_NON_CONTINUITY_COMMAND: 'runner-bootstrap-skipped-non-continuity-command',
+};
+const GOAL_COMMAND_ALIASES = new Set(['goal', 'goals', 'durable-goal', 'continuity-goal', '59']);
+const LOOP_COMMAND_ALIASES = new Set(['loop', 'loops', 'durable-loop', 'continuity-loop', '60']);
+const JOBS_COMMAND_ALIASES = new Set(['jobs', 'job', 'continuity-jobs', '61']);
+const RUNNER_COMMAND_ALIASES = new Set(['runner', 'neocortex-runner', 'continuity-runner', '62']);
+const GOAL_LOOP_TICK_ALIASES = new Map([
+    ['goal-tick', 'goal'],
+    ['loop-tick', 'loop'],
+]);
+const REQUIRED_OPERATIONS = new Set([
+    'create',
+    'start',
+    'resume',
+    'activate',
+    'run',
+    'run-once',
+    'restart',
+    'continue',
+    'unpause',
+]);
+const OPTIONAL_OPERATIONS = new Set([
+    'status',
+    'doctor',
+    'cancel',
+    'pause',
+    'report',
+    'reports',
+    'log',
+    'logs',
+]);
+const KNOWN_OPERATIONS = new Set([
+    ...REQUIRED_OPERATIONS,
+    ...OPTIONAL_OPERATIONS,
+    'tick',
+]);
+const PUBLIC_TARGET_TOKEN_RE = /^@?(?:goal|loop|job)-[a-z0-9][a-z0-9._-]*$/i;
+export function parseRunnerBootstrapCommandIntent(args) {
+    const tokens = publicCommandTokens(args);
+    const first = normalizeToken(tokens[0]);
+    if (!first)
+        return intent('unknown', 'none', false);
+    const tickAliasKind = GOAL_LOOP_TICK_ALIASES.get(first);
+    if (tickAliasKind)
+        return intent(tickAliasKind, 'tick', true);
+    const kind = commandKindForToken(first);
+    if (kind === 'unknown')
+        return intent('unknown', 'none', false);
+    if (kind === 'jobs' || kind === 'runner') {
+        return intent(kind, operationForToken(publicOperationToken(tokens)), true);
+    }
+    return intent(kind, operationForToken(publicOperationToken(tokens)), true);
+}
+export function classifyRunnerBootstrapPolicy(commandIntent, context = {}) {
+    if (isBootstrapInProgress(context)) {
+        return skipped(commandIntent, RUNNER_BOOTSTRAP_POLICY_REASON_CODES.SKIPPED_BOOTSTRAP_IN_PROGRESS, 'runner bootstrap skipped because a bootstrap guard is active.');
+    }
+    if (normalizePlatformTarget(context.platformTarget) === 'runner') {
+        return skipped(commandIntent, RUNNER_BOOTSTRAP_POLICY_REASON_CODES.SKIPPED_RUNNER_PLATFORM, 'runner bootstrap skipped for runner platform invocation.');
+    }
+    if ((commandIntent.kind === 'goal' || commandIntent.kind === 'loop') && commandIntent.operation === 'tick') {
+        return skipped(commandIntent, RUNNER_BOOTSTRAP_POLICY_REASON_CODES.SKIPPED_GOAL_LOOP_TICK, `runner bootstrap skipped for ${commandIntent.kind} tick operation.`);
+    }
+    if (commandIntent.kind === 'jobs') {
+        return skipped(commandIntent, RUNNER_BOOTSTRAP_POLICY_REASON_CODES.SKIPPED_JOBS_COMMAND, 'runner bootstrap skipped for jobs command.');
+    }
+    if (commandIntent.kind === 'runner') {
+        return skipped(commandIntent, RUNNER_BOOTSTRAP_POLICY_REASON_CODES.SKIPPED_RUNNER_COMMAND, 'runner bootstrap skipped for runner command.');
+    }
+    if (commandIntent.kind !== 'goal' && commandIntent.kind !== 'loop') {
+        return skipped(commandIntent, RUNNER_BOOTSTRAP_POLICY_REASON_CODES.SKIPPED_NON_CONTINUITY_COMMAND, 'runner bootstrap skipped for non-continuity command.');
+    }
+    if (OPTIONAL_OPERATIONS.has(commandIntent.operation)) {
+        return {
+            action: 'optional',
+            failurePolicy: 'fail-open',
+            command: commandIntent.kind,
+            operation: commandIntent.operation,
+            reasonCodes: [RUNNER_BOOTSTRAP_POLICY_REASON_CODES.OPTIONAL_OPERATOR_COMMAND],
+            publicSummary: `runner bootstrap optional for ${commandIntent.kind} operator command.`,
+            publicSafe: true,
+        };
+    }
+    const reasonCode = REQUIRED_OPERATIONS.has(commandIntent.operation) || commandIntent.operation === 'none'
+        ? RUNNER_BOOTSTRAP_POLICY_REASON_CODES.REQUIRED_DURABLE_COMMAND
+        : RUNNER_BOOTSTRAP_POLICY_REASON_CODES.REQUIRED_UNKNOWN_GOAL_LOOP_OPERATION;
+    return {
+        action: 'required',
+        failurePolicy: 'fail-closed',
+        command: commandIntent.kind,
+        operation: commandIntent.operation === 'none' ? 'create' : commandIntent.operation,
+        reasonCodes: [reasonCode],
+        publicSummary: `runner bootstrap required for durable ${commandIntent.kind} command.`,
+        publicSafe: true,
+    };
+}
+export function classifyRunnerBootstrapPolicyFromArgs(args, context = {}) {
+    return classifyRunnerBootstrapPolicy(parseRunnerBootstrapCommandIntent(args), context);
+}
+function skipped(commandIntent, reasonCode, publicSummary) {
+    return {
+        action: 'skipped',
+        failurePolicy: 'not-applicable',
+        command: commandIntent.kind,
+        operation: commandIntent.operation,
+        reasonCodes: [reasonCode],
+        publicSummary,
+        publicSafe: true,
+    };
+}
+function intent(kind, operation, recognizedAlias) {
+    return { kind, operation, recognizedAlias, publicSafe: true };
+}
+function commandKindForToken(token) {
+    if (GOAL_COMMAND_ALIASES.has(token))
+        return 'goal';
+    if (LOOP_COMMAND_ALIASES.has(token))
+        return 'loop';
+    if (JOBS_COMMAND_ALIASES.has(token))
+        return 'jobs';
+    if (RUNNER_COMMAND_ALIASES.has(token))
+        return 'runner';
+    return 'unknown';
+}
+function operationForToken(token) {
+    const normalized = normalizeToken(token);
+    if (!normalized)
+        return 'none';
+    return KNOWN_OPERATIONS.has(normalized) ? normalized : 'unknown';
+}
+function publicOperationToken(tokens) {
+    const second = tokens[1];
+    if (!second)
+        return undefined;
+    if (PUBLIC_TARGET_TOKEN_RE.test(second))
+        return tokens[2];
+    return second;
+}
+function publicCommandTokens(args) {
+    return args.trim().split(/\s+/).filter(Boolean).slice(0, 3);
+}
+function normalizeToken(token) {
+    return (token ?? '').trim().toLowerCase().replace(/^\*/, '');
+}
+function normalizePlatformTarget(platformTarget) {
+    return (platformTarget ?? '').trim().toLowerCase();
+}
+function isBootstrapInProgress(context) {
+    if (context.bootstrapInProgress)
+        return true;
+    return truthyGuard(context.environment?.NEOCORTEX_RUNNER_BOOTSTRAP_IN_PROGRESS)
+        || truthyGuard(context.environment?.NEOCORTEX_BOOTSTRAP_IN_PROGRESS);
+}
+function truthyGuard(value) {
+    return /^(1|true|yes|on)$/i.test(value ?? '');
+}