@ornexus/neocortex 4.60.73 → 4.60.74

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

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