@captain_z/zsk 1.8.3 → 1.8.5

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

@@ -0,0 +1,105 @@
+export type GateAssessmentOptions = {
+    stage: string;
+    module?: string;
+    issue?: string;
+    reviewTarget?: string;
+    threshold?: number;
+    acceptRisk?: string;
+    verbose?: boolean;
+};
+export type GateStatus = "READY" | "NEEDS_CONFIRMATION" | "BLOCKED" | "WAIVED";
+export type OutputQualityStatus = "PASS" | "NEEDS_CLARIFICATION" | "NEEDS_REPAIR" | "BLOCKED" | "WAIVED";
+export type OutputQualityCheck = {
+    artifactKey: string;
+    path: string;
+    present: boolean;
+    valid: boolean;
+    status?: OutputQualityStatus;
+    owner?: string;
+    sourceBasis: string[];
+    blockingItems: string[];
+    nextAction?: string;
+    waiver?: string[];
+    updatedAt?: string;
+    gap?: string;
+};
+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;
+    children?: GateArtifactChild[];
+};
+export type GateArtifactChild = {
+    path: string;
+    status: "included" | "unreadable";
+    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[];
+    outputQualityChecks: OutputQualityCheck[];
+    blockers: string[];
+    gaps: string[];
+    waiver?: {
+        reason: string;
+        appliedAt: string;
+    };
+    nextAction: string;
+};
+export type GateAssessmentBundle = {
+    assessment: GateAssessment;
+    artifacts: {
+        dir: string;
+        jsonPath: string;
+        markdownPath: string;
+        detailJsonPath?: string;
+        detailMarkdownPath?: string;
+        waiverPath?: string;
+    };
+    markdown: string;
+    waiverMarkdown?: string;
+};
+export type StageQualityArtifactSpec = {
+    key: string;
+    moduleStage?: string;
+    path?: (config: import("./config.js").ProjectConfig, moduleId?: string) => string;
+};
+export type StageQualityCriterionSpec = {
+    id: string;
+    label: string;
+    weight: number;
+    required?: boolean;
+    artifactKeys?: string[];
+    test: (ctx: StageQualityCriterionContext) => boolean;
+    evidence: (ctx: StageQualityCriterionContext) => string[];
+    gap: string;
+};
+export type StageQualityCriterionContext = {
+    stage: string;
+    reviewTarget?: string;
+    reviewMode?: ReviewGateMode;
+    artifacts: GateArtifact[];
+    contentByKey: Map<string, string>;
+};
+export type ReviewGateMode = "implementation" | "preproposal" | "raw-source" | "zsk-workspace" | "stage-doc" | "design-source" | "code-target" | "target-path";
+export declare const DEFAULT_STAGE_QUALITY_THRESHOLD = 9;

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

@@ -0,0 +1,2 @@
+export const DEFAULT_STAGE_QUALITY_THRESHOLD = 9;
+//# sourceMappingURL=stage-quality-contracts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stage-quality-contracts.js","sourceRoot":"","sources":["../../src/core/stage-quality-contracts.ts"],"names":[],"mappings":"AAqHA,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { GateArtifact, GateCriterion, StageQualityCriterionContext } from "./stage-quality-contracts.js";
+export declare function evaluateStageQualityCriteria(input: {
+    stage: string;
+    reviewTarget: string | undefined;
+    reviewMode: StageQualityCriterionContext["reviewMode"];
+    artifacts: GateArtifact[];
+    contentByKey: Map<string, string>;
+    knownStages: string[];
+}): GateCriterion[];

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

@@ -0,0 +1,286 @@
+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.",
+    },
+];
+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 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,15 @@
+import type { GateAssessment, GateCriterion, GateStatus, OutputQualityCheck } 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, outputQualityChecks?: OutputQualityCheck[]): StageQualityDecisionSummary;
+export declare function renderGateAssessmentMarkdown(assessment: GateAssessment): string;
+export declare function renderGateAssessmentSummaryMarkdown(assessment: GateAssessment): string;
+export declare function summarizeGateAssessmentJson(assessment: GateAssessment): Record<string, unknown>;
+export declare function renderWaiverMarkdown(assessment: GateAssessment): string;