@astrosheep/keiyaku 2.9.5 → 2.9.7

package/build/core/audit/report.js

@@ -0,0 +1,38 @@
+export function collectFindings(input) {
+    const findings = [];
+    const selector = `keiyaku @${input.contractId}`;
+    if (input.rehearsal.status === "clean")
+        findings.push({ code: "BASE_DRIFT", detail: `${input.rehearsal.oldBase} -> ${input.rehearsal.newBase}`, nextCommand: `${selector} renew` });
+    if (input.rehearsal.status === "conflict")
+        findings.push({ code: "RENEW_CONFLICT", detail: input.rehearsal.paths.join(", "), nextCommand: `${selector} renew` });
+    if (input.rehearsal.status === "unknown")
+        findings.push({ code: "RENEW_UNKNOWN", detail: `${input.rehearsal.cause.code}: ${input.rehearsal.cause.message}`, nextCommand: `${selector} audit` });
+    for (const row of input.scope?.filter((item) => item.class === "violated") ?? [])
+        findings.push({ code: "SCOPE_RESIDUE", detail: `${row.path}: ${row.residue.length} unexplained changes`, nextCommand: `${selector} amend --scope-add ${JSON.stringify(row.path)}` });
+    if (input.verification.status === "evaluated") {
+        for (const result of input.verification.results) {
+            if (result.status === "executed" && result.exitCode !== 0)
+                findings.push({ code: "VERIFICATION_FAILED", detail: `${result.label} exited ${result.exitCode}`, nextCommand: result.command });
+            if (result.status === "unverifiable")
+                findings.push({ code: "VERIFICATION_UNVERIFIABLE", detail: `${result.label}: ${result.cause}`, nextCommand: result.command });
+        }
+    }
+    const residue = input.readiness.deliveryResidue;
+    if (residue.tracked.length + residue.staged.length + residue.unstaged.length + residue.untracked.length > 0)
+        findings.push({ code: "DELIVERY_RESIDUE", detail: `registered delivery worktree has uncommitted residue at ${input.deliveryCwd}`, nextCommand: `git -C ${JSON.stringify(input.deliveryCwd)} status --short` });
+    if (input.readiness.arc.max > 0 && input.readiness.arc.open === null && input.readiness.arc.looseCommits.length > 0)
+        findings.push({ code: "LOOSE_COMMITS", detail: `${input.readiness.arc.looseCommits.length} loose commits after fence`, nextCommand: `printf '# Continue\\n\\n## Objective\\nReceipt loose commits.\\n\\n## Brief\\nContinue delivery.\\n' | ${selector} arc` });
+    if (input.readiness.renewSession.open)
+        findings.push({ code: "RENEW_SESSION_OPEN", detail: "renew recovery session is open", nextCommand: `${selector} renew --continue` });
+    if (input.readiness.rewriteGuard.liveProjection)
+        findings.push({ code: "LIVE_REWRITE_GUARD", detail: "a live projection owns the delivery worktree", nextCommand: "keiyaku status" });
+    for (const dependency of input.readiness.dependencies.filter((item) => !item.satisfied))
+        findings.push({ code: "DEPENDENCY_OPEN", detail: `dependency ${dependency.id} is ${dependency.state}`, nextCommand: `keiyaku @${dependency.id} log` });
+    if (input.readiness.petition.state === "petitioned" && input.readiness.petition.queue?.position !== 1)
+        findings.push({ code: "PETITION_QUEUE", detail: `petition queue position ${input.readiness.petition.queue?.position ?? "unknown"}`, nextCommand: "keiyaku status" });
+    return findings;
+}
+export function emptyRaceReport(input) {
+    const findings = [{ code: "COORDINATE_RACE", detail: input.detail, nextCommand: `keiyaku @${input.contractId} audit`, race: input.race }];
+    return { contract: input.contractId, coordinates: input.coordinates, terms: input.terms, rehearsal: { status: "unknown", cause: { code: "COORDINATE_RACE", message: input.detail } }, candidate: null, diff: null, presentation: null, files: null, scope: null, verification: { status: "not_evaluated", reason: "coordinate_race", results: [] }, readiness: null, findings, counts: { files: 0, selected: 0, omitted: 0, inScope: 0, downgraded: 0, violated: 0, findings: 1 } };
+}