@captain_z/zsk 1.8.2 → 1.8.4

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

@@ -0,0 +1,323 @@
+const COMMON_CRITERIA = [
+    {
+        id: "GATE-INPUT-01",
+        label: "Required upstream artifacts exist and are non-empty.",
+        weight: 2,
+        required: true,
+        test: (ctx) => ctx.artifacts.every((artifact) => artifact.exists && artifact.bytes > 0),
+        evidence: (ctx) => ctx.artifacts.map((artifact) => `${artifact.key}: ${artifact.exists ? `${artifact.bytes} bytes` : "missing"} (${artifact.path})`),
+        gap: "One or more required upstream artifacts are missing or empty.",
+    },
+    {
+        id: "GATE-RULES-01",
+        label: "PROJECT-CONFIG.md and SYSTEM-SPEC.md constraints are available or explicitly not required for this stage.",
+        weight: 1,
+        required: true,
+        test: (ctx) => {
+            if (["preproposal", "coding", "fix", "smoke", "review", "ready", "verify", "acceptance", "archive"].includes(ctx.stage))
+                return true;
+            return hasContent(ctx, "project-config") && hasContent(ctx, "system-spec");
+        },
+        evidence: (ctx) => ["project-config", "system-spec"].map((key) => `${key}: ${hasContent(ctx, key) ? "present" : "missing"}`),
+        gap: "Project/system rules are not available for a stage that must obey them before handoff.",
+    },
+    {
+        id: "GATE-TEMPLATE-01",
+        label: "Upstream content is not placeholder-only or template filler.",
+        weight: 1,
+        required: true,
+        test: (ctx) => allPrimaryContent(ctx, (content) => {
+            const text = content.toLowerCase();
+            const placeholders = ["<fill-me>", "<project", "<module", "todo:", "tbd", "lorem ipsum"];
+            return !placeholders.some((placeholder) => text.includes(placeholder));
+        }),
+        evidence: (ctx) => primaryArtifacts(ctx).map((artifact) => `${artifact.key}: ${artifact.bytes} bytes`),
+        gap: "At least one upstream artifact still looks like a placeholder or template filler.",
+    },
+    {
+        id: "GATE-CONTENT-01",
+        label: "Upstream content has enough detail for reliable handoff.",
+        weight: 1,
+        test: (ctx) => {
+            const artifacts = primaryArtifacts(ctx);
+            if (artifacts.length === 0)
+                return true;
+            return artifacts.every((artifact) => wordCount(ctx.contentByKey.get(artifact.key) ?? "") >= 40);
+        },
+        evidence: (ctx) => primaryArtifacts(ctx).map((artifact) => `${artifact.key}: ${wordCount(ctx.contentByKey.get(artifact.key) ?? "")} words`),
+        gap: "At least one upstream artifact is very short; treat this as a quality gap unless the project explicitly accepts the risk.",
+    },
+    {
+        id: "GATE-TRACE-01",
+        label: "Claims trace to source, requirement, acceptance, design, task, issue, or evidence identifiers.",
+        weight: 1,
+        test: (ctx) => combinedContent(ctx).match(/\b(FR|NFR|AC|SPEC|DES|TASK|ISSUE|EVIDENCE|ADR|REQ)-?\d+\b/i) !== null ||
+            (ctx.stage === "preproposal" && ctx.artifacts.length === 0) ||
+            /traceability|source|evidence|acceptance|scenario/i.test(combinedContent(ctx)),
+        evidence: (ctx) => [`trace terms found: ${/traceability|source|evidence|acceptance|scenario/i.test(combinedContent(ctx)) ? "yes" : "no"}`],
+        gap: "Traceability is weak; the next stage may rely on chat memory instead of source-backed IDs or evidence.",
+    },
+    {
+        id: "GATE-UNCERTAINTY-01",
+        label: "Open questions, assumptions, risks, or blockers are explicit instead of silently resolved.",
+        weight: 1,
+        test: (ctx) => (ctx.stage === "preproposal" && ctx.artifacts.length === 0) ||
+            /open questions?|assumptions?|risks?|blockers?|constraints?|unknowns?|n\/a|none/i.test(combinedContent(ctx)),
+        evidence: (ctx) => [`uncertainty section marker found: ${/open questions?|assumptions?|risks?|blockers?|constraints?|unknowns?/i.test(combinedContent(ctx)) ? "yes" : "n/a or none marker required"}`],
+        gap: "Uncertainty handling is not explicit enough for a downstream stage to decide whether to continue or ask.",
+    },
+    {
+        id: "GATE-STAGE-CHALLENGE-01",
+        label: "Existing current-stage artifacts expose a skill-local Stage Challenge Gate summary.",
+        weight: 2,
+        required: true,
+        test: (ctx) => {
+            const artifacts = currentStageArtifacts(ctx);
+            if (artifacts.length === 0)
+                return true;
+            return artifacts.every((artifact) => {
+                const content = ctx.contentByKey.get(artifact.key) ?? "";
+                return hasStageChallengeGateMarker(content) && hasStageChallengeGateStatus(content);
+            });
+        },
+        evidence: (ctx) => {
+            const artifacts = currentStageArtifacts(ctx);
+            if (artifacts.length === 0)
+                return ["current stage artifact: not present"];
+            return artifacts.map((artifact) => {
+                const content = ctx.contentByKey.get(artifact.key) ?? "";
+                const hasGate = hasStageChallengeGateMarker(content);
+                const hasStatus = hasStageChallengeGateStatus(content);
+                return `${artifact.key}: gate=${hasGate ? "yes" : "no"}, status=${hasStatus ? "yes" : "no"} (${artifact.path})`;
+            });
+        },
+        gap: "An existing current-stage artifact must show the skill-local Stage Challenge Gate focus and PASS/NEEDS_REPAIR/BLOCKED/WAIVED status before downstream handoff.",
+    },
+];
+const STAGE_CRITERIA = {
+    design: [
+        {
+            id: "DESIGN-ENTRY-SPEC-01",
+            label: "Spec contains observable acceptance criteria.",
+            weight: 1,
+            required: true,
+            artifactKeys: ["spec"],
+            test: (ctx) => hasPattern(ctx, ["spec"], /acceptance criteria|验收|given\s+.*when\s+.*then|AC-?\d+/is),
+            evidence: () => ["spec acceptance marker required"],
+            gap: "Design cannot safely start until the spec exposes observable acceptance criteria.",
+        },
+        {
+            id: "DESIGN-ENTRY-SPEC-02",
+            label: "Spec covers edge, negative, boundary, or error scenarios.",
+            weight: 1,
+            artifactKeys: ["spec"],
+            test: (ctx) => hasPattern(ctx, ["spec"], /edge cases?|negative|boundary|error|failure|异常|边界/is),
+            evidence: () => ["spec edge/negative/boundary marker required"],
+            gap: "Spec lacks explicit non-happy-path coverage.",
+        },
+        {
+            id: "DESIGN-ENTRY-SPEC-03",
+            label: "Spec names NFR or quality attributes, with missing thresholds marked as 未指定 when needed.",
+            weight: 1,
+            artifactKeys: ["spec"],
+            test: (ctx) => hasPattern(ctx, ["spec"], /NFR|non-functional|performance|security|reliability|accessibility|observability|未指定|质量/is),
+            evidence: () => ["spec NFR/quality marker required"],
+            gap: "Spec does not expose quality attributes enough for design tradeoffs.",
+        },
+        {
+            id: "DESIGN-ENTRY-CONTROL-01",
+            label: "Permission/auth/privacy/data-access behavior has a behavior-level control matrix before design starts.",
+            weight: 2,
+            required: true,
+            artifactKeys: ["spec"],
+            test: (ctx) => !touchesControlConcern(ctx, ["spec"]) || hasControlMatrix(ctx, ["spec"]),
+            evidence: (ctx) => [`control concern: ${touchesControlConcern(ctx, ["spec"]) ? "triggered" : "not triggered"}`],
+            gap: "Spec touches a control concern but lacks a behavior-level control matrix.",
+        },
+    ],
+    task: [
+        {
+            id: "TASK-ENTRY-DES-01",
+            label: "Design includes useful diagrams or explicitly states why diagrams are N/A.",
+            weight: 1,
+            artifactKeys: ["design"],
+            test: (ctx) => hasPattern(ctx, ["design"], /```mermaid|diagram|C4|sequence|state|data flow|flowchart|图|N\/A/is),
+            evidence: () => ["design diagram or N/A rationale marker required"],
+            gap: "Task breakdown needs a reviewable design view or explicit diagram N/A rationale.",
+        },
+        {
+            id: "TASK-ENTRY-DES-02",
+            label: "Design records ADR/decision-record entries for task planning.",
+            weight: 1,
+            required: true,
+            artifactKeys: ["design"],
+            test: (ctx) => hasPattern(ctx, ["design"], /ADR-?\d+|Architecture Decision Record|Decision Record|ADR\s*\/|##\s*ADR|决策记录/is),
+            evidence: () => ["design ADR/decision-record marker required"],
+            gap: "Design lacks ADR/decision-record entries required for task planning.",
+        },
+        {
+            id: "TASK-ENTRY-CONTROL-01",
+            label: "Triggered permission/auth/privacy/data-access behavior has a design control traceability matrix.",
+            weight: 2,
+            required: true,
+            artifactKeys: ["spec", "design"],
+            test: (ctx) => !touchesControlConcern(ctx, ["spec", "design"]) || hasControlMatrix(ctx, ["design"]),
+            evidence: (ctx) => [`control concern: ${touchesControlConcern(ctx, ["spec", "design"]) ? "triggered" : "not triggered"}`],
+            gap: "Spec or design touches a control concern but design lacks a control traceability matrix.",
+        },
+    ],
+    coding: [
+        {
+            id: "CODING-ENTRY-TASK-01",
+            label: "Tasks use Kiro-style nested checkbox groups and subtasks.",
+            weight: 2,
+            required: true,
+            artifactKeys: ["tasks"],
+            test: (ctx) => hasPattern(ctx, ["tasks"], /^- \[ \] \d+\. .+$/m) && hasPattern(ctx, ["tasks"], /^\s+- \[ \] \d+\.\d+ .+$/m),
+            evidence: () => ["task list must contain '- [ ] 1.' and indented '- [ ] 1.1' items"],
+            gap: "Coding should not start from flat or vague tasks; use Kiro-style groups and subtasks.",
+        },
+        {
+            id: "CODING-ENTRY-TASK-02",
+            label: "Each implementation slice has verification or evidence hooks.",
+            weight: 1,
+            required: true,
+            artifactKeys: ["tasks"],
+            test: (ctx) => hasPattern(ctx, ["tasks"], /verification|evidence|test command|pnpm|npm|pytest|vitest|playwright|验证|证据/is),
+            evidence: () => ["task verification/evidence marker required"],
+            gap: "Tasks do not define how each slice proves completion.",
+        },
+    ],
+    fix: [
+        {
+            id: "FIX-ENTRY-ISSUE-01",
+            label: "Issue anchor exposes expected behavior, actual behavior, and evidence.",
+            weight: 2,
+            required: true,
+            artifactKeys: ["issue-record"],
+            test: (ctx) => hasPattern(ctx, ["issue-record"], /expected|actual|evidence|repro|steps|root cause|fix route|预期|实际|证据|复现/is),
+            evidence: () => ["issue record must expose expected/actual/evidence markers"],
+            gap: "Fix should not start without an issue anchor that records expected/actual behavior and evidence.",
+        },
+    ],
+    smoke: [
+        {
+            id: "SMOKE-ENTRY-TEST-01",
+            label: "Test basis is traceable before local smoke claims pass.",
+            weight: 2,
+            required: true,
+            artifactKeys: ["tasks"],
+            test: (ctx) => hasPattern(ctx, ["tasks"], /test basis|acceptance|AC-?\d+|FR-?\d+|scenario|regression|验收|回归/is),
+            evidence: () => ["tasks must link tests to acceptance/scenario/regression basis"],
+            gap: "Smoke cannot treat passing commands as meaningful without a traceable test basis.",
+        },
+    ],
+    review: [
+        {
+            id: "REVIEW-TARGET-01",
+            label: "Explicit review target exists and is treated as the review contract when supplied.",
+            weight: 2,
+            required: true,
+            artifactKeys: ["review-target"],
+            test: (ctx) => !ctx.reviewTarget || hasContent(ctx, "review-target"),
+            evidence: (ctx) => [
+                `review target: ${ctx.reviewTarget ?? "module implementation review"}`,
+                `review mode: ${ctx.reviewMode ?? "implementation"}`,
+            ],
+            gap: "The explicit review target is missing or has no reviewable content.",
+        },
+        {
+            id: "REVIEW-ENTRY-TEST-01",
+            label: "Smoke evidence distinguishes passed, failed, skipped, and unrun checks.",
+            weight: 1,
+            required: true,
+            artifactKeys: ["smoke"],
+            test: (ctx) => ctx.reviewMode !== "implementation" || hasPattern(ctx, ["smoke"], /passed|failed|skipped|unrun|exit status|command|evidence|通过|失败|跳过/is),
+            evidence: (ctx) => [ctx.reviewMode === "implementation" ? "smoke pass/fail/skipped/unrun markers required" : "explicit target review does not require module smoke input"],
+            gap: "Review needs precise test result status, not only a generic all-passed claim.",
+        },
+        {
+            id: "REVIEW-PREPROPOSAL-01",
+            label: "Preproposal/raw-source reviews check product, roadmap, UX, assumptions, or readiness evidence instead of module spec artifacts.",
+            weight: 1,
+            artifactKeys: ["review-target"],
+            test: (ctx) => !["preproposal", "raw-source"].includes(ctx.reviewMode ?? "implementation") ||
+                hasPattern(ctx, ["review-target"], /product|problem|user|persona|journey|roadmap|mvp|phase|ux|flow|assumption|risk|blocker|source|evidence|产品|用户|路线图|阶段|流程|假设|风险|证据/is),
+            evidence: (ctx) => [`target-aware raw review: ${["preproposal", "raw-source"].includes(ctx.reviewMode ?? "implementation") ? "required" : "n/a"}`],
+            gap: "Raw/preproposal review target lacks product, roadmap, UX, assumption, risk, source, or evidence markers.",
+        },
+    ],
+};
+export function evaluateStageQualityCriteria(input) {
+    const { stage, reviewTarget, reviewMode, artifacts, contentByKey, knownStages } = input;
+    const ctx = { stage, ...(reviewTarget ? { reviewTarget, reviewMode } : {}), artifacts, contentByKey };
+    const specs = [
+        ...(!knownStages.includes(stage) ? [unknownStageCriterion(stage, knownStages)] : []),
+        ...COMMON_CRITERIA,
+        ...(STAGE_CRITERIA[stage] ?? []),
+    ];
+    return specs.map((spec) => {
+        const passed = spec.test(ctx);
+        return {
+            id: spec.id,
+            label: spec.label,
+            weight: spec.weight,
+            passed,
+            required: spec.required === true,
+            evidence: spec.evidence(ctx),
+            ...(passed ? {} : { gap: spec.gap }),
+        };
+    });
+}
+function unknownStageCriterion(stage, knownStages) {
+    return {
+        id: "GATE-STAGE-00",
+        label: `Stage '${stage}' is known to the gate assessment contract.`,
+        weight: 2,
+        required: true,
+        test: () => false,
+        evidence: () => [`known stages: ${knownStages.join(", ")}`],
+        gap: "Unknown stage; define its required inputs before using gate assessment.",
+    };
+}
+function hasContent(ctx, key) {
+    return (ctx.contentByKey.get(key)?.trim().length ?? 0) > 0;
+}
+function primaryArtifacts(ctx) {
+    return ctx.artifacts.filter((artifact) => !["project-config", "system-spec", "raw-manifest"].includes(artifact.key));
+}
+function currentStageArtifacts(ctx) {
+    return ctx.artifacts.filter((artifact) => artifact.key === `current-${ctx.stage}`);
+}
+function hasStageChallengeGateMarker(content) {
+    return /(^|\n)#{2,6}\s+Stage Challenge Gate\b/i.test(content) ||
+        /(^|\n)\s*[-*]?\s*Stage artifact clarity\s*:/i.test(content);
+}
+function hasStageChallengeGateStatus(content) {
+    return /(^|\n)\s*[-*]?\s*Stage artifact clarity\s*:\s*(PASS|NEEDS_REPAIR|BLOCKED|WAIVED)\b/i.test(content);
+}
+function allPrimaryContent(ctx, test) {
+    const artifacts = primaryArtifacts(ctx);
+    if (artifacts.length === 0)
+        return ctx.artifacts.every((artifact) => artifact.exists && artifact.bytes > 0);
+    return artifacts.every((artifact) => {
+        const content = ctx.contentByKey.get(artifact.key);
+        return typeof content === "string" && test(content);
+    });
+}
+function combinedContent(ctx) {
+    return [...ctx.contentByKey.values()].join("\n\n");
+}
+function hasPattern(ctx, keys, pattern) {
+    return keys.some((key) => pattern.test(ctx.contentByKey.get(key) ?? ""));
+}
+function touchesControlConcern(ctx, keys) {
+    return hasPattern(ctx, keys, /auth(?:entication|orization)?|permission|access control|role|tenant|privacy|data access|compliance|audit|credential|PII|RBAC|ABAC|权限|认证|授权|角色|租户|隐私|审计|合规|凭证/is);
+}
+function hasControlMatrix(ctx, keys) {
+    return hasPattern(ctx, keys, /control (?:traceability )?matrix|control matrix|permission matrix|access control matrix|权限(?:追踪|控制)?矩阵|Source Rule|Subject \/ Actor|Action \/ Capability|Resource \/ Data|Enforcement Point/is);
+}
+function wordCount(content) {
+    return content.split(/\s+/).filter(Boolean).length;
+}
+//# sourceMappingURL=stage-quality-criteria.js.map

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

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

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

@@ -0,0 +1,13 @@
+import type { GateAssessment, GateCriterion, GateStatus } from "./stage-quality-contracts.js";
+export type StageQualityDecisionSummary = {
+    score: number;
+    status: GateStatus;
+    decision: GateAssessment["decision"];
+    blockers: string[];
+    gaps: string[];
+    waiver?: GateAssessment["waiver"];
+    nextAction: string;
+};
+export declare function summarizeStageQualityDecision(criteria: GateCriterion[], threshold: number, acceptRisk: string | undefined): StageQualityDecisionSummary;
+export declare function renderGateAssessmentMarkdown(assessment: GateAssessment): string;
+export declare function renderWaiverMarkdown(assessment: GateAssessment): string;

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

@@ -0,0 +1,122 @@
+export function summarizeStageQualityDecision(criteria, threshold, acceptRisk) {
+    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 blockers = criteria
+        .filter((criterion) => criterion.required && !criterion.passed)
+        .map((criterion) => `${criterion.id}: ${criterion.gap ?? criterion.label}`);
+    const gaps = criteria.filter((criterion) => !criterion.passed).map((criterion) => `${criterion.id}: ${criterion.gap ?? criterion.label}`);
+    const belowThreshold = score < threshold;
+    const waiverAllowed = blockers.length === 0 && belowThreshold && Boolean(acceptRisk);
+    const status = blockers.length > 0
+        ? "BLOCKED"
+        : waiverAllowed
+            ? "WAIVED"
+            : 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),
+    };
+}
+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),
+        "",
+        "## 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 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) {
+    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 "Ask for human confirmation, improve upstream artifacts, or rerun with --accept-risk and a concrete reason.";
+    return "Do not start the stage; fix missing required artifacts or required criteria first.";
+}
+//# 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":"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"}

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

@@ -1,56 +1,9 @@
 import type { ProjectConfig } from "./config.js";
-export type GateAssessmentOptions = {
-    stage: string;
-    module?: 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;
-    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;
-};
+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 createGateRunId(now?: Date): string;