@aria_asi/cli 0.2.40 → 0.2.41

package/dist/assets/hooks/codex-native/lib/project-boundary-cognition.mjs

@@ -0,0 +1,143 @@
+const PROJECT_WORK_RX = /\b(?:project|phase|implement|wire|upgrade|fix|repair|continue|finish|execute|end[-\s]?to[-\s]?end|qa|test|verify|ledger|connector|terminal|runtime|hook|skill|autofire|atlas|repo|codebase|first[-\s]?class|symptom\s+fix|doctrine|harness)\b/i;
+const COMPLETION_CLAIM_RX = /\b(?:done|complete|completed|ready|verified|fixed|finished|shipped|implemented|wired|first[-\s]?class|end[-\s]?to[-\s]?end)\b/i;
+const OWNER_CORRECTION_RX = /\b(?:you(?:\s+are|'re| were)?\s+right|u\s+r\s+right|i\s+am\s+right|another\s+failure|that'?s\s+(?:a\s+)?failure|ledger\s+failur\w*|symptom\s+fix|not\s+(?:a\s+)?first[-\s]?class|why\s+(?:not|haven'?t|didn'?t)|self[-\s]?audit|auto[-\s]?trigg\w*|fire\s+(?:the\s+)?skills?|fix\s+what\s+u?\s*found|corrected[\s\S]{0,40}\b\d+(?:k|\+)?\s+times)\b/i;
+const ASSISTANT_CORRECTION_ACK_RX = /\b(?:you(?:\s+are|'re| were)?\s+right|i\s+should\s+have|i\s+missed|i\s+was\s+wrong|that\s+was\s+(?:a\s+)?miss|i\s+failed\s+to)\b/i;
+
+export const PROJECT_START_TADABBUR_QUESTIONS = Object.freeze([
+  'What is the exact project object under reflection, not the surface request?',
+  'Which owner, doctrine, runtime, repo, and no-harm constraints bind the first action?',
+  'What evidence is missing before action, and what source will be checked first?',
+  'What repeated correction or hidden mechanism failure could recur if not handled now?',
+  'What observable predicate will prove the start action and final closeout succeeded?',
+]);
+
+// Aligned 1:1 to atlas kernel QIYAS_PERSPECTIVES (deterministic-cognitive-kernel.mjs:18)
+// for consistency across all project-boundary + end-phase QA receipts. 2026-05-17 F2.
+export const PROJECT_END_QIYAS_PERSPECTIVES = Object.freeze([
+  'Owner-Hamza-now',
+  'Owner-Hamza-future',
+  'operator-client',
+  'investor-or-buyer',
+  'LLM-consumer',
+  'human-end-user',
+  'skeptic',
+  'compliance',
+  'engineering-quality',
+  'cognitive-load',
+  'scale',
+  'Islamic-scholar',
+  'clinical-scholar',
+  'red-team-attacker',
+  'future-self',
+]);
+
+export function detectProjectBoundaryNeed(userText = '', assistantText = '') {
+  const user = String(userText || '');
+  const assistant = String(assistantText || '');
+  const projectLike = PROJECT_WORK_RX.test(user) || user.length >= 180;
+  const completionClaim = COMPLETION_CLAIM_RX.test(assistant);
+  const ownerCorrection = OWNER_CORRECTION_RX.test(user) || ASSISTANT_CORRECTION_ACK_RX.test(assistant);
+  return {
+    required: projectLike || completionClaim || ownerCorrection,
+    projectLike,
+    completionClaim,
+    ownerCorrection,
+  };
+}
+
+export function buildProjectStartBoundary({
+  userText = '',
+  cognitiveRuntimeReceipts = null,
+  source = 'project-start-boundary',
+} = {}) {
+  const need = detectProjectBoundaryNeed(userText);
+  const tadabbur = cognitiveRuntimeReceipts?.tadabbur || {};
+  const qiyas = cognitiveRuntimeReceipts?.qiyas || {};
+  const tadabburOk = tadabbur.ok === true && tadabbur.stageCount === 12;
+  return {
+    schema: 'aria.project_boundary_cognition.v1',
+    phase: 'project_start',
+    source,
+    required: need.required,
+    ok: !need.required || tadabburOk,
+    trigger: need,
+    startTadabbur: {
+      required: need.required,
+      ok: !need.required || tadabburOk,
+      expectedStages: 12,
+      observedStages: Number(tadabbur.stageCount || 0),
+      mode: tadabbur.mode || null,
+      questions: [...PROJECT_START_TADABBUR_QUESTIONS],
+    },
+    endQiyasContract: {
+      requiredAtClose: need.required,
+      expectedPerspectives: PROJECT_END_QIYAS_PERSPECTIVES.length,
+      preloadedPerspectives: Number(qiyas.perspectiveCount || 0),
+      status: need.required ? 'pending_phase_close' : 'not_required',
+    },
+  };
+}
+
+export function evaluateProjectEndBoundary({
+  userText = '',
+  assistantText = '',
+  endPhaseQaAutofire = null,
+  source = 'project-end-boundary',
+} = {}) {
+  const need = detectProjectBoundaryNeed(userText, assistantText);
+  const receipt = endPhaseQaAutofire?.receipt || endPhaseQaAutofire || {};
+  const qiyasPass = Array.isArray(receipt.qiyas_15_pass) && receipt.qiyas_15_pass.length === PROJECT_END_QIYAS_PERSPECTIVES.length;
+  const qiyasPerspectiveCount = Number(receipt.cognitive_qiyas_15?.perspectives || 0);
+  const tadabburStageCount = Number(receipt.cognitive_tadabbur_12?.stages || 0);
+  const claimVerdict = receipt.claim_gate?.verdict || null;
+  const claimOk = !claimVerdict || ['verified', 'verified_narrowly'].includes(claimVerdict);
+  const missing = [];
+  if (need.required && qiyasPerspectiveCount !== PROJECT_END_QIYAS_PERSPECTIVES.length) missing.push('qiyas_15_perspective_count');
+  if (need.required && !qiyasPass) missing.push('qiyas_15_pass_entries');
+  if (need.required && tadabburStageCount !== 12) missing.push('tadabbur_12_closeout_count');
+  if (need.required && !claimOk) missing.push('claim_gate_verified_or_narrowly_verified');
+  return {
+    schema: 'aria.project_boundary_cognition.v1',
+    phase: 'project_end',
+    source,
+    required: need.required,
+    ok: !need.required || missing.length === 0,
+    trigger: need,
+    endQiyas: {
+      required: need.required,
+      ok: !need.required || (qiyasPerspectiveCount === PROJECT_END_QIYAS_PERSPECTIVES.length && qiyasPass),
+      expectedPerspectives: PROJECT_END_QIYAS_PERSPECTIVES.length,
+      observedPerspectives: qiyasPerspectiveCount,
+      passEntries: Array.isArray(receipt.qiyas_15_pass) ? receipt.qiyas_15_pass.length : 0,
+    },
+    closeoutTadabbur: {
+      expectedStages: 12,
+      observedStages: tadabburStageCount,
+    },
+    claimGate: {
+      verdict: claimVerdict,
+      ok: claimOk,
+    },
+    missing,
+  };
+}
+
+export function formatProjectBoundaryPrompt(boundary) {
+  if (!boundary?.required) return 'Project boundary: not required for this turn.';
+  return [
+    'Project boundary: start Tadabbur-12 is required before action; end Qiyas-15 is required before closeout.',
+    `Start Tadabbur: ${boundary.startTadabbur?.ok ? 'pass' : 'missing'} (${boundary.startTadabbur?.observedStages || 0}/${boundary.startTadabbur?.expectedStages || 12})`,
+    'Automatic start questions:',
+    ...PROJECT_START_TADABBUR_QUESTIONS.map((question, index) => `${index + 1}. ${question}`),
+    `End Qiyas pending: ${boundary.endQiyasContract?.expectedPerspectives || 15} perspectives at phase close.`,
+  ].join('\n');
+}
+
+export function formatProjectBoundaryBlock(boundary) {
+  return [
+    'Project boundary cognition failed before release.',
+    `phase: ${boundary?.phase || 'unknown'}`,
+    `missing: ${(boundary?.missing || []).join(', ') || 'project_start_tadabbur_12'}`,
+    'required repair: run Tadabbur-12 at project start and Qiyas-15 at phase close, then re-check the claim gate from evidence.',
+  ].join('\n');
+}