@captain_z/zsk 1.8.7 → 1.8.8

package/dist/core/review-skill-policy.js

@@ -0,0 +1,278 @@
+import { evaluateValidationPacket, } from "./validation-packet.js";
+export function evaluateReviewSkillPolicy(input) {
+    const materials = input.materials ?? {};
+    const diagnostics = [];
+    const missingContext = collectMissingContext(input);
+    if (!input.target) {
+        diagnostics.push({
+            code: "missing-review-target",
+            severity: "failure",
+            message: "Review needs an explicit diff, branch, file range, path, or provided code target.",
+        });
+    }
+    if (input.mode === "strict" && !materials.gateEvidence) {
+        diagnostics.push({
+            code: "strict-missing-gate-evidence",
+            severity: "failure",
+            message: "Strict review is workflow-governed and requires workflow-provided gate evidence.",
+        });
+    }
+    const validationAssessment = materials.validationPacket ? evaluateValidationPacket(materials.validationPacket) : undefined;
+    const findings = collectFindings(validationAssessment);
+    if (validationAssessment?.status === "untrusted") {
+        diagnostics.push({
+            code: "untrusted-validation-packet",
+            severity: "warning",
+            message: "Validation packet contains failures or fake-green indicators; review must report them as findings.",
+        });
+    }
+    else if (validationAssessment?.status === "warning") {
+        diagnostics.push({
+            code: "validation-packet-warning",
+            severity: "warning",
+            message: "Validation packet has warning-level evidence gaps; review must surface the confidence impact.",
+        });
+    }
+    const lanes = buildLanes(input, missingContext);
+    const status = diagnostics.some((diagnostic) => diagnostic.severity === "failure") ? "blocked" : "reviewable";
+    const risks = [
+        ...missingContext.map((context) => `${context} missing; related review lanes run at lower confidence.`),
+        ...(materials.validationPacket ? [] : ["validation packet missing; test and evidence trust must be checked from raw artifacts."]),
+        ...findings.map((finding) => finding.risk),
+    ];
+    const nextActions = nextActionsFor(status, diagnostics, missingContext);
+    return {
+        status,
+        confidence: confidenceFor(status, input.mode, missingContext, diagnostics),
+        quality: qualityFor({
+            status,
+            mode: input.mode,
+            missingContext,
+            diagnostics,
+            lanes,
+            findings,
+            nextActions,
+        }),
+        missingContext,
+        risks,
+        lanes,
+        diagnostics,
+        findings,
+        nextActions,
+    };
+}
+function collectMissingContext(input) {
+    const materials = input.materials ?? {};
+    const missing = [
+        materials.spec ? undefined : "spec",
+        materials.tasks ? undefined : "tasks",
+        materials.validationPacket ? undefined : "validation-packet",
+        materials.anchorPacket || materials.sessionAnchor ? undefined : "anchor-packet",
+    ].filter((item) => Boolean(item));
+    if (input.mode !== "direct" && !materials.gateEvidence) {
+        missing.push("gate-evidence");
+    }
+    return missing;
+}
+function buildLanes(input, missingContext) {
+    const materials = input.materials ?? {};
+    const depth = input.depth ?? "standard";
+    const deepExecutor = input.staffing?.subagentsAvailable ? "subagent" : "sequential";
+    const base = [
+        {
+            id: "task-goal",
+            status: materials.tasks ? "checked" : "risk",
+            reason: materials.tasks ? "Task goals are available for target alignment." : "No task material was supplied.",
+        },
+        {
+            id: "spec-alignment",
+            status: materials.spec ? "checked" : "risk",
+            reason: materials.spec ? "Spec is available for requirement alignment." : "No spec material was supplied.",
+        },
+        {
+            id: "code-quality",
+            status: input.target ? "checked" : "not-applicable",
+            reason: input.target ? "Review target is available for code-quality inspection." : "No review target was supplied.",
+        },
+        {
+            id: "best-practices",
+            status: materials.bestPractices && materials.bestPractices.length > 0 ? "checked" : "risk",
+            reason: materials.bestPractices && materials.bestPractices.length > 0
+                ? "Best-practice material is available."
+                : "No best-practice material was supplied.",
+        },
+        {
+            id: "anchor-session",
+            status: missingContext.includes("anchor-packet") ? "risk" : "checked",
+            reason: missingContext.includes("anchor-packet")
+                ? "No anchor or session packet was supplied."
+                : "Anchor or session material is available.",
+        },
+        {
+            id: "tests-evidence",
+            status: missingContext.includes("validation-packet") ? "risk" : "checked",
+            reason: missingContext.includes("validation-packet")
+                ? "No validation packet was supplied."
+                : "Validation packet is available for evidence trust checks.",
+            executor: depth === "deep" ? deepExecutor : undefined,
+        },
+    ];
+    if (depth !== "deep")
+        return base;
+    const riskAreas = new Set(input.touchedRiskAreas ?? []);
+    return [
+        ...base.map((lane) => ({ ...lane, executor: lane.executor ?? deepExecutor })),
+        {
+            id: "security-data",
+            status: riskAreas.has("security") ? "checked" : "risk",
+            reason: riskAreas.has("security")
+                ? "Security-sensitive surface is included in deep review lanes."
+                : "Deep review should confirm whether security/data risk is touched.",
+            executor: deepExecutor,
+        },
+        {
+            id: "architecture-api",
+            status: riskAreas.has("architecture") ? "checked" : "risk",
+            reason: riskAreas.has("architecture")
+                ? "Architecture/API surface is included in deep review lanes."
+                : "Deep review should confirm whether API or dependency risk is touched.",
+            executor: deepExecutor,
+        },
+        {
+            id: "frontend-a11y",
+            status: riskAreas.has("frontend") ? "checked" : "not-applicable",
+            reason: riskAreas.has("frontend")
+                ? "Frontend/a11y surface is included in deep review lanes."
+                : "No frontend surface was declared.",
+            executor: deepExecutor,
+        },
+        {
+            id: "performance-reliability",
+            status: riskAreas.has("performance") ? "checked" : "not-applicable",
+            reason: riskAreas.has("performance")
+                ? "Performance/reliability surface is included in deep review lanes."
+                : "No performance or reliability surface was declared.",
+            executor: deepExecutor,
+        },
+    ];
+}
+function collectFindings(assessment) {
+    if (!assessment || assessment.status === "trusted")
+        return [];
+    const severity = assessment.status === "untrusted" ? "IMPORTANT" : "MINOR";
+    return [
+        {
+            severity,
+            title: assessment.status === "untrusted"
+                ? "Validation packet is not trustworthy enough to support a PASS verdict."
+                : "Validation packet has evidence gaps that lower review confidence.",
+            evidence: assessment.diagnostics.map((diagnostic) => `${diagnostic.code}: ${diagnostic.message}`),
+            risk: assessment.status === "untrusted"
+                ? "Green tests may be fake-green, mock-only, or disconnected from the changed behavior."
+                : "Review may overstate confidence if warning-level validation gaps are not called out.",
+            suggestedFix: assessment.status === "untrusted"
+                ? "Add behavior-level evidence for the real critical path, then rerun review."
+                : "Add the missing validation evidence or explicitly report the residual confidence gap.",
+        },
+    ];
+}
+function confidenceFor(status, mode, missingContext, diagnostics) {
+    if (status === "blocked" || diagnostics.some((diagnostic) => diagnostic.severity === "failure"))
+        return "low";
+    if (diagnostics.some((diagnostic) => diagnostic.severity === "warning"))
+        return "medium";
+    if (mode === "direct" && missingContext.length > 0)
+        return "medium";
+    if (missingContext.length >= 4)
+        return "low";
+    if (missingContext.length > 0)
+        return "medium";
+    return "high";
+}
+function qualityFor(input) {
+    const warningCount = input.diagnostics.filter((diagnostic) => diagnostic.severity === "warning").length;
+    const failureCount = input.diagnostics.filter((diagnostic) => diagnostic.severity === "failure").length;
+    const untrustedValidationCount = input.diagnostics.filter((diagnostic) => diagnostic.code === "untrusted-validation-packet").length;
+    const otherWarningCount = Math.max(0, warningCount - untrustedValidationCount);
+    const riskLaneCount = input.lanes.filter((lane) => lane.status === "risk").length;
+    const checkedLaneCount = input.lanes.filter((lane) => lane.status === "checked").length;
+    const applicableLaneCount = input.lanes.filter((lane) => lane.status !== "not-applicable").length;
+    const laneCoverage = applicableLaneCount === 0 ? 0 : Math.round((checkedLaneCount / applicableLaneCount) * 100);
+    const hasValidationGap = input.missingContext.includes("validation-packet");
+    const hasAnchorGap = input.missingContext.includes("anchor-packet");
+    const hasWorkflowGateGap = input.missingContext.includes("gate-evidence");
+    const hasEvidenceFinding = input.findings.some((finding) => finding.evidence.length > 0 && finding.suggestedFix.length > 0);
+    const coverageScore = clampScore(laneCoverage - input.missingContext.length * 4);
+    const evidenceTrustScore = clampScore(100 -
+        (hasValidationGap ? 30 : 0) -
+        (hasAnchorGap ? 10 : 0) -
+        (hasWorkflowGateGap ? 8 : 0) -
+        untrustedValidationCount * 45 -
+        otherWarningCount * 20 -
+        failureCount * 55);
+    const findingReadinessScore = clampScore((input.status === "blocked" ? 35 : 85) +
+        (hasEvidenceFinding ? 10 : 0) -
+        (riskLaneCount > 0 ? Math.min(20, riskLaneCount * 4) : 0) -
+        failureCount * 30);
+    const riskClarityScore = clampScore(70 +
+        input.missingContext.length * 4 +
+        input.findings.length * 6 +
+        warningCount * 5 -
+        failureCount * 20);
+    const actionabilityScore = clampScore(input.nextActions.length === 0
+        ? 35
+        : 75 + Math.min(20, input.nextActions.length * 4) - failureCount * 25);
+    const overallScore = clampScore(Math.round(coverageScore * 0.25 +
+        evidenceTrustScore * 0.25 +
+        findingReadinessScore * 0.2 +
+        riskClarityScore * 0.15 +
+        actionabilityScore * 0.15));
+    return {
+        coverageScore,
+        evidenceTrustScore,
+        findingReadinessScore,
+        riskClarityScore,
+        actionabilityScore,
+        overallScore,
+        notes: qualityNotes(input, {
+            coverageScore,
+            evidenceTrustScore,
+            findingReadinessScore,
+            riskClarityScore,
+            actionabilityScore,
+            overallScore,
+        }),
+    };
+}
+function qualityNotes(input, scores) {
+    const notes = [];
+    if (input.mode === "direct" && input.missingContext.length > 0) {
+        notes.push("Direct review remains reviewable; missing optional context lowers coverage and evidence scores.");
+    }
+    if (input.mode !== "direct" && input.missingContext.includes("gate-evidence")) {
+        notes.push("Governed or strict review is missing workflow-owned gate evidence.");
+    }
+    if (input.diagnostics.some((diagnostic) => diagnostic.severity === "warning")) {
+        notes.push("Warning diagnostics reduce evidence trust and must be surfaced in the review verdict.");
+    }
+    if (input.status === "blocked") {
+        notes.push("Blocked review cannot claim completion until failure diagnostics are resolved.");
+    }
+    if (scores.overallScore >= 90) {
+        notes.push("Quality signal is strong enough for a high-confidence review verdict when findings support it.");
+    }
+    return notes;
+}
+function clampScore(value) {
+    return Math.max(0, Math.min(100, Math.round(value)));
+}
+function nextActionsFor(status, diagnostics, missingContext) {
+    if (status === "blocked") {
+        return diagnostics.map((diagnostic) => `${diagnostic.code}: ${diagnostic.message}`);
+    }
+    return [
+        "Produce findings first with severity, file/line, risk, evidence, and suggested fix.",
+        ...missingContext.map((context) => `Declare missing ${context} and lower related lane confidence.`),
+    ];
+}
+//# sourceMappingURL=review-skill-policy.js.map

package/dist/core/review-skill-policy.js.map

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

package/dist/core/source-snapshot-adapters.d.ts

@@ -3,6 +3,9 @@ import { type OriginInference } from "./origin-detection.js";
 import { type SourceSnapshotAdapterId } from "./source-adapter-normalization.js";
 export type PrepareSyncOptions = {
     source?: string;
+    resource?: string;
+    lane?: string;
+    consumer?: string;
     all?: boolean;
     allowNetwork?: boolean;
     authState?: string;

package/dist/core/source-snapshot-adapters.js.map

@@ -1 +1 @@
-{"version":3,"file":"source-snapshot-adapters.js","sourceRoot":"","sources":["../../src/core/source-snapshot-adapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,qBAAqB,GAItB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAwB,MAAM,uBAAuB,CAAC;AAChF,OAAO,EACL,2BAA2B,GAE5B,MAAM,mCAAmC,CAAC;AAwE3C,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,MAAc,EACd,MAAqB,EACrB,KAAkB,EAClB,IAAwB,EACxB,uBAA8E;IAE9E,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/C,MAAM,oBAAoB,GAAG,MAAM,uBAAuB,CAAC,YAAY,CAAC,CAAC;IACzE,MAAM,IAAI,GAAoB;QAC5B,eAAe,EAAE,CAAC;QAClB,SAAS,EAAE,KAAK,CAAC,EAAE;QACnB,UAAU,EAAE,KAAK,CAAC,IAAI;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,GAAG;QAClB,QAAQ;QACR,oBAAoB;KACrB,CAAC;IACF,OAAO;QACL,MAAM;QACN,MAAM;QACN,KAAK;QACL,MAAM;QACN,MAAM;QACN,IAAI;QACJ,QAAQ;QACR,YAAY;QACZ,oBAAoB;QACpB,IAAI;KACL,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAA8B,EAC9B,QAAuC;IAEvC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzD,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEtE,MAAM,eAAe,GAAG,2BAA2B,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACpF,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QACjE,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;IAC5B,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,YAAY;QAAE,OAAO,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAChF,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,KAAK;QAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClE,OAAO,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAAc;IACzD,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,gCAAgC,CAAC;IAChE,IAAI,MAAM,KAAK,YAAY;QAAE,OAAO,0BAA0B,CAAC;IAC/D,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,iCAAiC,CAAC;IAC/D,OAAO,4BAA4B,CAAC;AACtC,CAAC"}
+{"version":3,"file":"source-snapshot-adapters.js","sourceRoot":"","sources":["../../src/core/source-snapshot-adapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,qBAAqB,GAItB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAwB,MAAM,uBAAuB,CAAC;AAChF,OAAO,EACL,2BAA2B,GAE5B,MAAM,mCAAmC,CAAC;AA2E3C,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,MAAc,EACd,MAAqB,EACrB,KAAkB,EAClB,IAAwB,EACxB,uBAA8E;IAE9E,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/C,MAAM,oBAAoB,GAAG,MAAM,uBAAuB,CAAC,YAAY,CAAC,CAAC;IACzE,MAAM,IAAI,GAAoB;QAC5B,eAAe,EAAE,CAAC;QAClB,SAAS,EAAE,KAAK,CAAC,EAAE;QACnB,UAAU,EAAE,KAAK,CAAC,IAAI;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,GAAG;QAClB,QAAQ;QACR,oBAAoB;KACrB,CAAC;IACF,OAAO;QACL,MAAM;QACN,MAAM;QACN,KAAK;QACL,MAAM;QACN,MAAM;QACN,IAAI;QACJ,QAAQ;QACR,YAAY;QACZ,oBAAoB;QACpB,IAAI;KACL,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAA8B,EAC9B,QAAuC;IAEvC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzD,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEtE,MAAM,eAAe,GAAG,2BAA2B,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACpF,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QACjE,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;IAC5B,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,YAAY;QAAE,OAAO,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAChF,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,KAAK;QAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClE,OAAO,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAAc;IACzD,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,gCAAgC,CAAC;IAChE,IAAI,MAAM,KAAK,YAAY;QAAE,OAAO,0BAA0B,CAAC;IAC/D,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,iCAAiC,CAAC;IAC/D,OAAO,4BAA4B,CAAC;AACtC,CAAC"}

package/dist/core/task-decomposition.d.ts

@@ -0,0 +1,64 @@
+export type TaskDecompositionSourceKind = "plan" | "prd" | "spec" | "conversation-summary" | "issue";
+export type TaskPriority = "P0" | "P1" | "P2" | "P3";
+export type TaskWorkMode = "AFK" | "HITL";
+export type TaskCandidateType = "feature" | "bugfix" | "implementation" | "validation" | "documentation" | "migration" | "spike" | "decision";
+export type TaskCheckpointMap = {
+    ready: string;
+    red?: string;
+    green: string;
+    refactor?: string;
+    review: string;
+    verify: string;
+    done?: string;
+};
+export type TaskValidationHook = string | {
+    kind: "unit" | "integration" | "smoke" | "static" | "manual" | "review" | "eval";
+    command?: string;
+    expected: string;
+};
+export type TaskCandidate = {
+    id: string;
+    title: string;
+    group: string;
+    priority: TaskPriority;
+    type: TaskCandidateType;
+    workMode: TaskWorkMode;
+    hitlReason?: "human-decision" | "credentials" | "external-environment" | "destructive-operation";
+    blockedBy: string[];
+    unblocks: string[];
+    acceptanceCriteria: string[];
+    todo: string[];
+    checkpoints: TaskCheckpointMap;
+    validation: TaskValidationHook[];
+    sourceRefs?: string[];
+};
+export type TaskDecompositionInput = {
+    kind: TaskDecompositionSourceKind;
+    title?: string;
+    body?: string;
+    candidates?: TaskCandidate[];
+};
+export type TaskDecompositionResult = {
+    version: 1;
+    source: {
+        kind: TaskDecompositionSourceKind;
+        title?: string;
+    };
+    candidates: TaskCandidate[];
+};
+export type TaskDecompositionDiagnosticSeverity = "warning" | "failure";
+export type TaskDecompositionDiagnostic = {
+    code: string;
+    severity: TaskDecompositionDiagnosticSeverity;
+    candidateId?: string;
+    message: string;
+    evidence: string[];
+};
+export type TaskDecompositionAssessment = {
+    status: "valid" | "warning" | "invalid";
+    targetScore: 100;
+    score: number;
+    diagnostics: TaskDecompositionDiagnostic[];
+};
+export declare function createTaskDecomposition(input: TaskDecompositionInput): TaskDecompositionResult;
+export declare function evaluateTaskDecomposition(result: TaskDecompositionResult): TaskDecompositionAssessment;