@awak-app/simy-cli 0.5.72 → 0.5.74

package/src/startup-preflight.js

@@ -0,0 +1,44 @@
+import { createCodingLoopSnapshot } from "./orchestrator/contract.js";
+import { validateCharter } from "./orchestrator/charter-validation.js";
+
+// Reuse the execution charter rather than inventing a second approval policy.
+// These checks inspect local metadata only; model access requires real dispatch.
+export function startupRequirementChecks(request = {}) {
+  const checks = [{ key: "model_access", status: "unknown", blocking: false,
+    summary: "Signing in does not prove access to the requested model. Access is checked on dispatch without a paid preflight request.",
+    action: { id: "review_model_access", type: "inspect_provider", label: "Review provider and model settings" } }];
+  if (!String(request.requirement || "").trim()) {
+    checks.push({ key: "task_requirements", status: "unknown", blocking: false,
+      summary: "Environment check only. Supply the task requirement to check acceptance criteria and design approval.",
+      action: { id: "provide_requirement", type: "edit_requirements", label: "Provide task requirements" } });
+    return checks;
+  }
+  const { charter } = createCodingLoopSnapshot({ runId: "preflight", request });
+  const findings = validateCharter(charter);
+  for (const [key, code, passed, actionId, label] of [
+    ["acceptance_criteria", "EXPLICIT_ACCEPTANCE_CRITERIA_REQUIRED", "Acceptance criteria satisfy the task risk policy.", "provide_acceptance_criteria", "Provide explicit acceptance criteria"],
+    ["design_review", "DESIGN_REVIEW_REQUIRED", "Design approval satisfies the task risk policy.", "approve_design", "Provide design review and approval evidence"],
+    ["required_checks", "REQUIRED_CI_CHECKS_MISSING", "Required checks satisfy the task risk policy.", "provide_required_checks", "Provide CI and security check names"],
+  ]) {
+    const finding = findings.find(item => item.code === code);
+    checks.push({ key, status: finding ? "failed" : "passed", blocking: Boolean(finding),
+      summary: finding?.explanation || passed,
+      ...(finding ? { code, action: { id: actionId, type: "edit_requirements", label } } : {}) });
+  }
+  checks.push({ key: "assurance_selection", status: "unknown", blocking: false,
+    summary: "The executor must verify the five-level comparison and user selection in existing decision evidence before material implementation.",
+    action: { id: "review_assurance_selection", type: "review_decision_evidence", label: "Review assurance level and selection evidence" } });
+  checks.push({ key: "external_dependencies", status: "unknown", blocking: false,
+    summary: "Confirm test accounts, external resources and permissions required by the acceptance criteria. Local readiness does not certify Cloud entitlement.",
+    action: { id: "confirm_external_dependencies", type: "edit_requirements", label: "Confirm external inputs and permissions" } });
+  return checks;
+}
+
+export function summarizeStartupChecks(checks) {
+  const blockers = checks.filter(check => check.status === "failed" && check.blocking !== false);
+  const unknown = checks.filter(check => check.status === "unknown");
+  return { status: blockers.length ? "blocked" : unknown.length ? "needs_confirmation" : "ready",
+    blocker_keys: blockers.map(check => check.key), unknown_keys: unknown.map(check => check.key),
+    actions: checks.flatMap(check => check.action ? [{ check_key: check.key, ...check.action }]
+      : (check.recovery?.actions || []).map(action => ({ check_key: check.key, ...action }))) };
+}