@claudexor/review 3.1.1 → 3.2.0

package/dist/sealedReviewEnvelope.js

@@ -0,0 +1,176 @@
+export const RELEASE_NATIVE_CHECKLIST_ITEMS = [
+    "sealed_evidence",
+    "intent_and_scope",
+    "runtime_and_security",
+    "tests_and_release",
+];
+export const SEALED_REVIEW_SEVERITY_VALUES = [
+    "BLOCK",
+    "FIX_FIRST",
+    "WARN",
+    "NIT",
+    "OUT_OF_SCOPE",
+    "INSUFFICIENT_EVIDENCE",
+    "NEEDS_HUMAN",
+];
+export const SEALED_REVIEW_CATEGORY_VALUES = [
+    "correctness",
+    "regression",
+    "security",
+    "performance",
+    "maintainability",
+    "test_gap",
+    "spec_gap",
+    "deploy",
+    "architecture",
+    "ux",
+];
+const SEALED_REVIEW_SEVERITIES = new Set(SEALED_REVIEW_SEVERITY_VALUES);
+const SEALED_REVIEW_CATEGORIES = new Set(SEALED_REVIEW_CATEGORY_VALUES);
+const BLOCKING_SEVERITIES = new Set(["BLOCK", "FIX_FIRST", "NEEDS_HUMAN", "INSUFFICIENT_EVIDENCE"]);
+/** Deterministic persisted transcript projection for sealed native reviews. */
+export function sealedReviewTranscriptChunk(event) {
+    if (!isRecord(event) || event["type"] !== "message")
+        return null;
+    if (isRecord(event["payload"]) && event["payload"]["auth_switched"] === true)
+        return null;
+    const text = event["text"];
+    if (typeof text !== "string" || text.length === 0)
+        return null;
+    return text.endsWith("\n") ? text : `${text}\n`;
+}
+export function sealedReviewTranscriptFromEvents(events) {
+    // HarnessEvent.final is the cross-harness typed-answer contract. Adapter
+    // provenance such as payload.final_source remains preserved in raw events
+    // and pinned by adapter conformance, but is not a second finality authority.
+    const finals = events.filter((event) => isRecord(event) && event["type"] === "message" && event["final"] === true);
+    if (finals.length !== 1) {
+        throw new Error(`sealed review requires exactly one typed final message; observed ${finals.length}`);
+    }
+    const transcript = sealedReviewTranscriptChunk(finals[0]);
+    if (transcript === null) {
+        throw new Error("sealed review final message has no projectable text");
+    }
+    return transcript;
+}
+/** Dependency-free decision parser shared by the product and receipt verifier.
+ * Full product normalization still runs the canonical ReviewFinding schema. */
+export function parseSealedReviewDecisionEnvelopeDetailed(text) {
+    const empty = (error) => ({
+        findings: [],
+        rawFindings: [],
+        malformed: 0,
+        error,
+        blocks: [],
+    });
+    const source = text.trim();
+    if (source.length === 0)
+        return empty("no sealed review envelope");
+    let envelope;
+    try {
+        envelope = JSON.parse(source);
+    }
+    catch {
+        return empty("sealed review output must be exactly one JSON object with no surrounding prose");
+    }
+    const blocks = [envelope];
+    const fail = (error, rawFindings = [], findings = [], malformed = 0) => ({
+        findings,
+        rawFindings,
+        malformed,
+        error,
+        blocks,
+    });
+    if (!isRecord(envelope) || !hasExactKeys(envelope, ["completion", "findings"])) {
+        return fail("invalid sealed review envelope shape");
+    }
+    const completion = envelope["completion"];
+    const rawFindings = envelope["findings"];
+    if (!isRecord(completion) ||
+        !hasExactKeys(completion, ["checklist", "findingCount", "verdict"]) ||
+        !Array.isArray(rawFindings)) {
+        return fail("invalid sealed completion shape");
+    }
+    const checklist = completion["checklist"];
+    if (!Array.isArray(checklist) ||
+        checklist.length !== RELEASE_NATIVE_CHECKLIST_ITEMS.length ||
+        checklist.some((row, index) => {
+            if (!isRecord(row) || !hasOnlyKeys(row, ["item", "completed", "note"]))
+                return true;
+            if (row["item"] !== RELEASE_NATIVE_CHECKLIST_ITEMS[index] || row["completed"] !== true)
+                return true;
+            return row["note"] !== undefined && typeof row["note"] !== "string";
+        })) {
+        return fail("sealed checklist must contain the four exact completed items in order", rawFindings);
+    }
+    const findingCount = completion["findingCount"];
+    if (!Number.isSafeInteger(findingCount) || findingCount < 0) {
+        return fail("findingCount must be a non-negative integer", rawFindings);
+    }
+    if (findingCount !== rawFindings.length) {
+        return fail("findingCount does not match findings.length", rawFindings);
+    }
+    const findings = rawFindings.filter(isSealedReviewFinding).map((finding) => ({
+        severity: finding["severity"],
+    }));
+    const malformed = rawFindings.length - findings.length;
+    if (malformed > 0) {
+        return fail("sealed findings contain malformed items", rawFindings, findings, malformed);
+    }
+    const expectedVerdict = findings.some((finding) => BLOCKING_SEVERITIES.has(finding.severity))
+        ? "FAIL"
+        : "PASS";
+    if (completion["verdict"] !== expectedVerdict) {
+        return fail(`completion verdict must be ${expectedVerdict} for these findings`, rawFindings, findings);
+    }
+    return { findings, rawFindings, malformed: 0, error: null, blocks };
+}
+function isSealedReviewFinding(value) {
+    if (!isRecord(value) || !SEALED_REVIEW_SEVERITIES.has(value["severity"]))
+        return false;
+    const id = value["id"];
+    if (id != null && (typeof id !== "string" || id.length === 0))
+        return false;
+    const category = value["category"];
+    if (category != null && !SEALED_REVIEW_CATEGORIES.has(category))
+        return false;
+    const criteria = value["linked_acceptance_criteria"];
+    if (criteria != null &&
+        !isArrayOf(criteria, (item) => typeof item === "string" && item.length > 0))
+        return false;
+    const proposedFix = value["proposed_fix"];
+    if (proposedFix != null && typeof proposedFix !== "string")
+        return false;
+    return isFindingEvidence(value["evidence"]);
+}
+function isFindingEvidence(value) {
+    if (value == null)
+        return true;
+    if (!isRecord(value))
+        return false;
+    return (isOptionalArrayOf(value["files"], (item) => isRecord(item) &&
+        typeof item["path"] === "string" &&
+        (item["lines"] === undefined ||
+            item["lines"] === null ||
+            typeof item["lines"] === "string")) &&
+        isOptionalArrayOf(value["diff_hunks"], (item) => typeof item === "string") &&
+        isOptionalArrayOf(value["commands"], (item) => isRecord(item) && typeof item["command"] === "string") &&
+        isOptionalArrayOf(value["logs"], (item) => isRecord(item) && typeof item["path"] === "string"));
+}
+function isOptionalArrayOf(value, predicate) {
+    return value === undefined || isArrayOf(value, predicate);
+}
+function isArrayOf(value, predicate) {
+    return Array.isArray(value) && value.every(predicate);
+}
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function hasExactKeys(value, keys) {
+    return Object.keys(value).length === keys.length && hasOnlyKeys(value, keys);
+}
+function hasOnlyKeys(value, keys) {
+    const allowed = new Set(keys);
+    return Object.keys(value).every((key) => allowed.has(key));
+}
+//# sourceMappingURL=sealedReviewEnvelope.js.map

package/dist/sealedReviewEnvelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sealedReviewEnvelope.js","sourceRoot":"","sources":["../src/sealedReviewEnvelope.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudexor/review",
-  "version": "3.1.1",
+  "version": "3.2.0",
   "license": "MIT",
   "description": "Deterministic gates, cross-family review, finding revalidation, route proof, convergence, readiness-debt.",
   "type": "module",
@@ -16,11 +16,11 @@
     "dist"
   ],
   "dependencies": {
-    "@claudexor/context": "3.1.1",
-    "@claudexor/config": "3.1.1",
-    "@claudexor/core": "3.1.1",
-    "@claudexor/schema": "3.1.1",
-    "@claudexor/util": "3.1.1"
+    "@claudexor/config": "3.2.0",
+    "@claudexor/context": "3.2.0",
+    "@claudexor/core": "3.2.0",
+    "@claudexor/schema": "3.2.0",
+    "@claudexor/util": "3.2.0"
   },
   "repository": {
     "type": "git",