@captain_z/zsk 1.8.3 → 1.8.5

package/dist/core/stage-quality-rendering.js

@@ -0,0 +1,240 @@
+import { statusRank } from "./stage-output-quality.js";
+export function summarizeStageQualityDecision(criteria, threshold, acceptRisk, outputQualityChecks = []) {
+    const total = criteria.reduce((sum, criterion) => sum + criterion.weight, 0);
+    const earned = criteria.filter((criterion) => criterion.passed).reduce((sum, criterion) => sum + criterion.weight, 0);
+    const score = total === 0 ? 10 : roundScore((earned / total) * 10);
+    const outputQualityBlockers = outputQualityChecks
+        .filter((check) => !check.valid || check.status === "NEEDS_REPAIR" || check.status === "BLOCKED")
+        .map((check) => `${check.artifactKey}: ${check.gap ?? `Output Quality Check is ${check.status}`}`);
+    const outputQualityClarifications = outputQualityChecks
+        .filter((check) => check.valid && check.status === "NEEDS_CLARIFICATION")
+        .map((check) => `${check.artifactKey}: Output Quality Check needs clarification (${check.path})`);
+    const outputQualityWaivers = outputQualityChecks
+        .filter((check) => check.valid && check.status === "WAIVED")
+        .map((check) => `${check.artifactKey}: Output Quality Check is waived (${check.path})`);
+    const criteriaBlockers = criteria
+        .filter((criterion) => criterion.required && !criterion.passed)
+        .map((criterion) => `${criterion.id}: ${criterion.gap ?? criterion.label}`);
+    const criteriaGaps = criteria
+        .filter((criterion) => !criterion.passed)
+        .map((criterion) => `${criterion.id}: ${criterion.gap ?? criterion.label}`);
+    const blockers = outputQualityBlockers.length > 0 ? outputQualityBlockers : criteriaBlockers;
+    const gaps = outputQualityBlockers.length > 0
+        ? []
+        : criteriaGaps.concat(outputQualityClarifications, outputQualityWaivers);
+    const belowThreshold = score < threshold;
+    const waiverAllowed = blockers.length === 0 && belowThreshold && Boolean(acceptRisk);
+    const outputQualityStatus = mappedOutputQualityStatus(outputQualityChecks);
+    const status = blockers.length > 0
+        ? "BLOCKED"
+        : outputQualityStatus === "NEEDS_CONFIRMATION"
+            ? "NEEDS_CONFIRMATION"
+            : outputQualityStatus === "WAIVED"
+                ? "WAIVED"
+                : waiverAllowed
+                    ? "WAIVED"
+                    : outputQualityChecks.length > 0
+                        ? "READY"
+                        : belowThreshold
+                            ? "NEEDS_CONFIRMATION"
+                            : "READY";
+    const decision = status === "READY" || status === "WAIVED"
+        ? "proceed"
+        : status === "NEEDS_CONFIRMATION"
+            ? "human-confirmation-required"
+            : "blocked";
+    const waiver = waiverAllowed ? { reason: acceptRisk, appliedAt: new Date().toISOString() } : undefined;
+    return {
+        score,
+        status,
+        decision,
+        blockers,
+        gaps,
+        ...(waiver ? { waiver } : {}),
+        nextAction: nextActionFor(status, outputQualityChecks),
+    };
+}
+export function renderGateAssessmentMarkdown(assessment) {
+    return [
+        "# Stage Gate Assessment",
+        "",
+        `- Stage: \`${assessment.stage}\``,
+        ...(assessment.module ? [`- Module: \`${assessment.module}\``] : []),
+        ...(assessment.reviewTarget ? [`- Review target: \`${assessment.reviewTarget}\``] : []),
+        ...(assessment.reviewMode ? [`- Review mode: \`${assessment.reviewMode}\``] : []),
+        `- Score: ${assessment.score}/10`,
+        `- Threshold: ${assessment.threshold}/10`,
+        `- Status: \`${assessment.status}\``,
+        `- Decision: \`${assessment.decision}\``,
+        `- Next action: ${assessment.nextAction}`,
+        "",
+        "## Artifacts",
+        "",
+        "| Key | Path | Status | Bytes |",
+        "| --- | --- | --- | --- |",
+        ...assessment.artifacts.map((artifact) => `| ${artifact.key} | \`${artifact.path}\` | ${artifact.exists ? "present" : "missing"} | ${artifact.bytes} |`),
+        ...renderArtifactChildren(assessment),
+        "",
+        "## Output Quality",
+        "",
+        ...renderOutputQualityChecks(assessment.outputQualityChecks),
+        "",
+        "## Criteria",
+        "",
+        "| ID | Result | Required | Weight | Gap | Evidence |",
+        "| --- | --- | --- | --- | --- | --- |",
+        ...assessment.criteria.map((criterion) => `| ${criterion.id} | ${criterion.passed ? "PASS" : "FAIL"} | ${criterion.required ? "yes" : "no"} | ${criterion.weight} | ${criterion.gap ?? ""} | ${criterion.evidence.join("<br>")} |`),
+        "",
+        "## Blockers",
+        "",
+        ...(assessment.blockers.length > 0 ? assessment.blockers.map((blocker) => `- ${blocker}`) : ["- none"]),
+        "",
+        "## Gaps",
+        "",
+        ...(assessment.gaps.length > 0 ? assessment.gaps.map((gap) => `- ${gap}`) : ["- none"]),
+        ...(assessment.waiver ? [
+            "",
+            "## Risk Acceptance",
+            "",
+            `- Reason: ${assessment.waiver.reason}`,
+            `- Applied at: ${assessment.waiver.appliedAt}`,
+        ] : []),
+        "",
+    ].join("\n");
+}
+export function renderGateAssessmentSummaryMarkdown(assessment) {
+    return [
+        "# Stage Gate Summary",
+        "",
+        `- Stage: \`${assessment.stage}\``,
+        ...(assessment.module ? [`- Module: \`${assessment.module}\``] : []),
+        ...(assessment.reviewTarget ? [`- Review target: \`${assessment.reviewTarget}\``] : []),
+        `- Status: \`${assessment.status}\``,
+        `- Decision: \`${assessment.decision}\``,
+        `- Blockers: ${assessment.blockers.length}`,
+        `- Gaps: ${assessment.gaps.length}`,
+        `- Next action: ${assessment.nextAction}`,
+        "",
+        "## Output Quality",
+        "",
+        ...renderOutputQualityChecks(assessment.outputQualityChecks),
+        "",
+        "## Blockers",
+        "",
+        ...(assessment.blockers.length > 0 ? assessment.blockers.map((blocker) => `- ${blocker}`) : ["- none"]),
+        "",
+        "## Gaps",
+        "",
+        ...(assessment.gaps.length > 0 ? assessment.gaps.map((gap) => `- ${gap}`) : ["- none"]),
+        "",
+        "## Links",
+        "",
+        ...assessment.artifacts.map((artifact) => `- ${artifact.key}: \`${artifact.path}\` (${artifact.exists ? "present" : "missing"})`),
+        "",
+    ].join("\n");
+}
+export function summarizeGateAssessmentJson(assessment) {
+    return {
+        version: assessment.version,
+        runId: assessment.runId,
+        stage: assessment.stage,
+        ...(assessment.module ? { module: assessment.module } : {}),
+        ...(assessment.reviewTarget ? { reviewTarget: assessment.reviewTarget } : {}),
+        ...(assessment.reviewMode ? { reviewMode: assessment.reviewMode } : {}),
+        status: assessment.status,
+        decision: assessment.decision,
+        blockerCount: assessment.blockers.length,
+        gapCount: assessment.gaps.length,
+        blockers: assessment.blockers,
+        gaps: assessment.gaps,
+        outputQualityChecks: assessment.outputQualityChecks,
+        nextAction: assessment.nextAction,
+        artifacts: assessment.artifacts.map((artifact) => ({
+            key: artifact.key,
+            path: artifact.path,
+            exists: artifact.exists,
+            bytes: artifact.bytes,
+        })),
+        ...(assessment.waiver ? { waiver: assessment.waiver } : {}),
+    };
+}
+export function renderWaiverMarkdown(assessment) {
+    return [
+        "# Risk Acceptance",
+        "",
+        `- Stage: \`${assessment.stage}\``,
+        ...(assessment.module ? [`- Module: \`${assessment.module}\``] : []),
+        `- Score: ${assessment.score}/10`,
+        `- Threshold: ${assessment.threshold}/10`,
+        `- Reason: ${assessment.waiver?.reason ?? ""}`,
+        `- Applied at: ${assessment.waiver?.appliedAt ?? ""}`,
+        "",
+        "## Accepted Gaps",
+        "",
+        ...(assessment.gaps.length > 0 ? assessment.gaps.map((gap) => `- ${gap}`) : ["- none"]),
+        "",
+        "This waiver does not convert missing required artifacts into PASS. It only records an explicit human risk decision for quality gaps that are below the configured threshold.",
+        "",
+    ].join("\n");
+}
+function roundScore(value) {
+    return Math.round(value * 10) / 10;
+}
+function renderArtifactChildren(assessment) {
+    const rows = assessment.artifacts.flatMap((artifact) => (artifact.children ?? []).map((child) => `| ${artifact.key} | \`${child.path}\` | ${child.status} | ${child.bytes} |`));
+    if (rows.length === 0)
+        return [];
+    return [
+        "",
+        "## Artifact Children",
+        "",
+        "| Parent | Path | Status | Bytes |",
+        "| --- | --- | --- | --- |",
+        ...rows,
+    ];
+}
+function nextActionFor(status, outputQualityChecks = []) {
+    const firstClarification = outputQualityChecks.find((check) => check.status === "NEEDS_CLARIFICATION");
+    const firstRepair = outputQualityChecks.find((check) => check.status === "NEEDS_REPAIR");
+    const firstBlocked = outputQualityChecks.find((check) => check.status === "BLOCKED" || !check.valid);
+    if (status === "READY")
+        return "Proceed to the requested stage with the recorded assessment evidence.";
+    if (status === "WAIVED")
+        return "Proceed with the accepted risk and carry the gaps into the next stage output.";
+    if (status === "NEEDS_CONFIRMATION") {
+        return firstClarification
+            ? `Run Clarification Prelude for ${firstClarification.artifactKey} (${firstClarification.path}).`
+            : "Ask for human confirmation, improve upstream artifacts, or rerun with --accept-risk and a concrete reason.";
+    }
+    if (firstRepair)
+        return `Return to the owning stage skill to repair ${firstRepair.artifactKey} (${firstRepair.path}).`;
+    if (firstBlocked)
+        return `Do not start the stage; resolve ${firstBlocked.artifactKey} (${firstBlocked.path}): ${firstBlocked.gap ?? "blocked"}.`;
+    return "Do not start the stage; fix missing required artifacts or required criteria first.";
+}
+function mappedOutputQualityStatus(checks) {
+    const validChecks = checks.filter((check) => check.valid && check.status);
+    if (validChecks.length === 0)
+        return undefined;
+    const strongest = validChecks
+        .map((check) => check.status)
+        .filter((status) => Boolean(status))
+        .sort((a, b) => statusRank(b) - statusRank(a))[0];
+    if (strongest === "NEEDS_REPAIR" || strongest === "BLOCKED")
+        return "BLOCKED";
+    if (strongest === "NEEDS_CLARIFICATION")
+        return "NEEDS_CONFIRMATION";
+    if (strongest === "WAIVED")
+        return "WAIVED";
+    return "READY";
+}
+function renderOutputQualityChecks(checks) {
+    if (checks.length === 0)
+        return ["- No stage document Output Quality Check was required for this assessment."];
+    return checks.map((check) => {
+        const status = check.status ? `\`${check.status}\`` : "invalid";
+        const detail = check.valid ? "" : `; ${check.gap ?? "invalid"}`;
+        return `- ${check.artifactKey}: ${status} (${check.path})${detail}`;
+    });
+}
+//# sourceMappingURL=stage-quality-rendering.js.map

package/dist/core/stage-quality-rendering.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-quality-rendering.js","sourceRoot":"","sources":["../../src/core/stage-quality-rendering.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAYvD,MAAM,UAAU,6BAA6B,CAC3C,QAAyB,EACzB,SAAiB,EACjB,UAA8B,EAC9B,sBAA4C,EAAE;IAE9C,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,GAAG,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,GAAG,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACtH,MAAM,KAAK,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IACnE,MAAM,qBAAqB,GAAG,mBAAmB;SAC9C,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,cAAc,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC;SAChG,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,WAAW,KAAK,KAAK,CAAC,GAAG,IAAI,2BAA2B,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACrG,MAAM,2BAA2B,GAAG,mBAAmB;SACpD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,qBAAqB,CAAC;SACxE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,WAAW,+CAA+C,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;IACpG,MAAM,oBAAoB,GAAG,mBAAmB;SAC7C,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC;SAC3D,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,WAAW,qCAAqC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;IAC1F,MAAM,gBAAgB,GAAG,QAAQ;SAC9B,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;SAC9D,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC,EAAE,KAAK,SAAS,CAAC,GAAG,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9E,MAAM,YAAY,GAAG,QAAQ;SAC1B,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC;SACxC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC,EAAE,KAAK,SAAS,CAAC,GAAG,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9E,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAC7F,MAAM,IAAI,GAAG,qBAAqB,CAAC,MAAM,GAAG,CAAC;QAC3C,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,2BAA2B,EAAE,oBAAoB,CAAC,CAAC;IAC3E,MAAM,cAAc,GAAG,KAAK,GAAG,SAAS,CAAC;IACzC,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IACrF,MAAM,mBAAmB,GAAG,yBAAyB,CAAC,mBAAmB,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAe,QAAQ,CAAC,MAAM,GAAG,CAAC;QAC5C,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,mBAAmB,KAAK,oBAAoB;YAC5C,CAAC,CAAC,oBAAoB;YACtB,CAAC,CAAC,mBAAmB,KAAK,QAAQ;gBAChC,CAAC,CAAC,QAAQ;gBACV,CAAC,CAAC,aAAa;oBACb,CAAC,CAAC,QAAQ;oBACV,CAAC,CAAC,mBAAmB,CAAC,MAAM,GAAG,CAAC;wBAC9B,CAAC,CAAC,OAAO;wBACT,CAAC,CAAC,cAAc;4BACd,CAAC,CAAC,oBAAoB;4BACtB,CAAC,CAAC,OAAO,CAAC;IACtB,MAAM,QAAQ,GAAG,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,QAAQ;QACxD,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,KAAK,oBAAoB;YAC/B,CAAC,CAAC,6BAA6B;YAC/B,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAoB,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACjH,OAAO;QACL,KAAK;QACL,MAAM;QACN,QAAQ;QACR,QAAQ;QACR,IAAI;QACJ,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,UAAU,EAAE,aAAa,CAAC,MAAM,EAAE,mBAAmB,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,UAA0B;IACrE,OAAO;QACL,yBAAyB;QACzB,EAAE;QACF,cAAc,UAAU,CAAC,KAAK,IAAI;QAClC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,eAAe,UAAU,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,sBAAsB,UAAU,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,oBAAoB,UAAU,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,YAAY,UAAU,CAAC,KAAK,KAAK;QACjC,gBAAgB,UAAU,CAAC,SAAS,KAAK;QACzC,eAAe,UAAU,CAAC,MAAM,IAAI;QACpC,iBAAiB,UAAU,CAAC,QAAQ,IAAI;QACxC,kBAAkB,UAAU,CAAC,UAAU,EAAE;QACzC,EAAE;QACF,cAAc;QACd,EAAE;QACF,iCAAiC;QACjC,2BAA2B;QAC3B,GAAG,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,QAAQ,CAAC,GAAG,QAAQ,QAAQ,CAAC,IAAI,QAAQ,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,MAAM,QAAQ,CAAC,KAAK,IAAI,CAAC;QACxJ,GAAG,sBAAsB,CAAC,UAAU,CAAC;QACrC,EAAE;QACF,mBAAmB;QACnB,EAAE;QACF,GAAG,yBAAyB,CAAC,UAAU,CAAC,mBAAmB,CAAC;QAC5D,EAAE;QACF,aAAa;QACb,EAAE;QACF,sDAAsD;QACtD,uCAAuC;QACvC,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,SAAS,CAAC,EAAE,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,SAAS,CAAC,MAAM,MAAM,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QACnO,EAAE;QACF,aAAa;QACb,EAAE;QACF,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACvG,EAAE;QACF,SAAS;QACT,EAAE;QACF,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACvF,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;YACtB,EAAE;YACF,oBAAoB;YACpB,EAAE;YACF,aAAa,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE;YACvC,iBAAiB,UAAU,CAAC,MAAM,CAAC,SAAS,EAAE;SAC/C,CAAC,CAAC,CAAC,EAAE,CAAC;QACP,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,mCAAmC,CAAC,UAA0B;IAC5E,OAAO;QACL,sBAAsB;QACtB,EAAE;QACF,cAAc,UAAU,CAAC,KAAK,IAAI;QAClC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,eAAe,UAAU,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,sBAAsB,UAAU,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,eAAe,UAAU,CAAC,MAAM,IAAI;QACpC,iBAAiB,UAAU,CAAC,QAAQ,IAAI;QACxC,eAAe,UAAU,CAAC,QAAQ,CAAC,MAAM,EAAE;QAC3C,WAAW,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE;QACnC,kBAAkB,UAAU,CAAC,UAAU,EAAE;QACzC,EAAE;QACF,mBAAmB;QACnB,EAAE;QACF,GAAG,yBAAyB,CAAC,UAAU,CAAC,mBAAmB,CAAC;QAC5D,EAAE;QACF,aAAa;QACb,EAAE;QACF,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACvG,EAAE;QACF,SAAS;QACT,EAAE;QACF,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACvF,EAAE;QACF,UAAU;QACV,EAAE;QACF,GAAG,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,QAAQ,CAAC,GAAG,OAAO,QAAQ,CAAC,IAAI,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC;QACjI,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,UAA0B;IACpE,OAAO;QACL,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,YAAY,EAAE,UAAU,CAAC,QAAQ,CAAC,MAAM;QACxC,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,MAAM;QAChC,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,mBAAmB,EAAE,UAAU,CAAC,mBAAmB;QACnD,UAAU,EAAE,UAAU,CAAC,UAAU;QACjC,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACjD,GAAG,EAAE,QAAQ,CAAC,GAAG;YACjB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,KAAK,EAAE,QAAQ,CAAC,KAAK;SACtB,CAAC,CAAC;QACH,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,UAA0B;IAC7D,OAAO;QACL,mBAAmB;QACnB,EAAE;QACF,cAAc,UAAU,CAAC,KAAK,IAAI;QAClC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,eAAe,UAAU,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,YAAY,UAAU,CAAC,KAAK,KAAK;QACjC,gBAAgB,UAAU,CAAC,SAAS,KAAK;QACzC,aAAa,UAAU,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,EAAE;QAC9C,iBAAiB,UAAU,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,EAAE;QACrD,EAAE;QACF,kBAAkB;QAClB,EAAE;QACF,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACvF,EAAE;QACF,8KAA8K;QAC9K,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;AACrC,CAAC;AAED,SAAS,sBAAsB,CAAC,UAA0B;IACxD,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CACrD,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,QAAQ,CAAC,GAAG,QAAQ,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,MAAM,MAAM,KAAK,CAAC,KAAK,IAAI,CAAC,CACvH,CAAC;IACF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,OAAO;QACL,EAAE;QACF,sBAAsB;QACtB,EAAE;QACF,oCAAoC;QACpC,2BAA2B;QAC3B,GAAG,IAAI;KACR,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,MAAkB,EAAE,sBAA4C,EAAE;IACvF,MAAM,kBAAkB,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,qBAAqB,CAAC,CAAC;IACvG,MAAM,WAAW,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,cAAc,CAAC,CAAC;IACzF,MAAM,YAAY,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrG,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,uEAAuE,CAAC;IACvG,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,+EAA+E,CAAC;IAChH,IAAI,MAAM,KAAK,oBAAoB,EAAE,CAAC;QACpC,OAAO,kBAAkB;YACvB,CAAC,CAAC,iCAAiC,kBAAkB,CAAC,WAAW,KAAK,kBAAkB,CAAC,IAAI,IAAI;YACjG,CAAC,CAAC,4GAA4G,CAAC;IACnH,CAAC;IACD,IAAI,WAAW;QAAE,OAAO,8CAA8C,WAAW,CAAC,WAAW,KAAK,WAAW,CAAC,IAAI,IAAI,CAAC;IACvH,IAAI,YAAY;QAAE,OAAO,mCAAmC,YAAY,CAAC,WAAW,KAAK,YAAY,CAAC,IAAI,MAAM,YAAY,CAAC,GAAG,IAAI,SAAS,GAAG,CAAC;IACjJ,OAAO,oFAAoF,CAAC;AAC9F,CAAC;AAED,SAAS,yBAAyB,CAAC,MAA4B;IAC7D,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1E,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/C,MAAM,SAAS,GAAG,WAAW;SAC1B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC;SAC5B,MAAM,CAAC,CAAC,MAAM,EAAwC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;SACzE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,IAAI,SAAS,KAAK,cAAc,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC9E,IAAI,SAAS,KAAK,qBAAqB;QAAE,OAAO,oBAAoB,CAAC;IACrE,IAAI,SAAS,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC5C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,yBAAyB,CAAC,MAA4B;IAC7D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,4EAA4E,CAAC,CAAC;IAC/G,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QAChE,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,GAAG,IAAI,SAAS,EAAE,CAAC;QAChE,OAAO,KAAK,KAAK,CAAC,WAAW,KAAK,MAAM,KAAK,KAAK,CAAC,IAAI,IAAI,MAAM,EAAE,CAAC;IACtE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/core/stage-quality.d.ts

@@ -1,64 +1,9 @@
 import type { ProjectConfig } from "./config.js";
-export type GateAssessmentOptions = {
-    stage: string;
-    module?: string;
-    issue?: string;
-    reviewTarget?: string;
-    threshold?: number;
-    acceptRisk?: string;
-};
-export type GateStatus = "READY" | "NEEDS_CONFIRMATION" | "BLOCKED" | "WAIVED";
-export type GateCriterion = {
-    id: string;
-    label: string;
-    weight: number;
-    passed: boolean;
-    required: boolean;
-    evidence: string[];
-    gap?: string;
-};
-export type GateArtifact = {
-    key: string;
-    path: string;
-    exists: boolean;
-    bytes: number;
-};
-export type GateAssessment = {
-    version: 1;
-    runId: string;
-    stage: string;
-    module?: string;
-    reviewTarget?: string;
-    reviewMode?: ReviewGateMode;
-    threshold: number;
-    score: number;
-    status: GateStatus;
-    decision: "proceed" | "human-confirmation-required" | "blocked";
-    artifacts: GateArtifact[];
-    criteria: GateCriterion[];
-    blockers: string[];
-    gaps: string[];
-    waiver?: {
-        reason: string;
-        appliedAt: string;
-    };
-    nextAction: string;
-};
-export type GateAssessmentBundle = {
-    assessment: GateAssessment;
-    artifacts: {
-        dir: string;
-        jsonPath: string;
-        markdownPath: string;
-        waiverPath?: string;
-    };
-    markdown: string;
-    waiverMarkdown?: string;
-};
-export type ReviewGateMode = "implementation" | "preproposal" | "raw-source" | "zsk-workspace" | "stage-doc" | "design-source" | "code-target" | "target-path";
+import { normalizeReviewTargetPath, reviewModeForReviewTarget } from "./stage-quality-artifacts.js";
+import type { GateAssessment, GateAssessmentBundle, GateAssessmentOptions, GateArtifact, GateCriterion, GateStatus, ReviewGateMode } from "./stage-quality-contracts.js";
+export type { GateAssessment, GateAssessmentBundle, GateAssessmentOptions, GateArtifact, GateCriterion, GateStatus, ReviewGateMode, };
+export { normalizeReviewTargetPath, reviewModeForReviewTarget };
 export declare function writeGateAssessment(target: string, config: ProjectConfig, opts: GateAssessmentOptions): Promise<GateAssessmentBundle>;
 export declare function gateThresholdForStage(config: ProjectConfig, stage: string): number | undefined;
 export declare function buildGateAssessment(target: string, config: ProjectConfig, opts: GateAssessmentOptions): Promise<GateAssessmentBundle>;
-export declare function normalizeReviewTargetPath(target: string, value: string | undefined): string | undefined;
-export declare function reviewModeForReviewTarget(reviewTarget: string | undefined): ReviewGateMode | undefined;
 export declare function createGateRunId(now?: Date): string;