@captain_z/zsk 1.8.7 → 1.8.9

package/dist/core/task-plan-adapter.js

@@ -0,0 +1,298 @@
+import { evaluateTaskDecomposition, } from "./task-decomposition.js";
+const TARGET_SCORE = 100;
+const SIDE_EFFECT_FIELDS = new Set([
+    "issuePath",
+    "publish",
+    "writeIssue",
+    "gate",
+    "dispatch",
+    "agent",
+    "nextSkill",
+    "workflowNext",
+    "route",
+    "staffing",
+]);
+const PRIORITY_ORDER = {
+    P0: 0,
+    P1: 1,
+    P2: 2,
+    P3: 3,
+};
+export function createTaskPlan(decomposition) {
+    const assessment = evaluateTaskDecomposition(decomposition);
+    const taskGroups = Array.from(groupCandidates(decomposition.candidates).entries()).map(([groupTitle, candidates]) => {
+        const workMode = candidates.some((candidate) => candidate.workMode === "HITL")
+            ? "HITL"
+            : "AFK";
+        return {
+            id: slugify(groupTitle),
+            title: groupTitle,
+            priority: highestPriority(candidates),
+            workMode,
+            verticalSlices: candidates.map(toVerticalSlice),
+        };
+    });
+    return {
+        version: 1,
+        kind: "task-plan",
+        sourceEngine: "task-decomposition",
+        source: decomposition.source,
+        assessment,
+        localSideEffects: "none",
+        workflowSideEffects: [],
+        taskGroups,
+        boundedSpikes: decomposition.candidates
+            .filter((candidate) => candidate.type === "spike")
+            .map(toBoundedSpike),
+    };
+}
+export function evaluateTaskPlan(plan) {
+    const diagnostics = [
+        ...diagnosePlanShape(plan),
+        ...diagnoseTaskGroups(plan),
+        ...diagnoseSideEffects(plan),
+        ...diagnoseBoundedSpikes(plan),
+    ];
+    const status = diagnostics.some((diagnostic) => diagnostic.severity === "failure")
+        ? "invalid"
+        : diagnostics.length > 0
+            ? "warning"
+            : "valid";
+    return {
+        status,
+        targetScore: TARGET_SCORE,
+        score: scoreDiagnostics(diagnostics),
+        diagnostics,
+    };
+}
+function groupCandidates(candidates) {
+    const groups = new Map();
+    for (const candidate of candidates) {
+        const existing = groups.get(candidate.group) ?? [];
+        existing.push(candidate);
+        groups.set(candidate.group, existing);
+    }
+    return groups;
+}
+function toVerticalSlice(candidate) {
+    return {
+        id: candidate.id,
+        title: candidate.title,
+        priority: candidate.priority,
+        type: candidate.type,
+        workMode: candidate.workMode,
+        hitlReason: candidate.hitlReason,
+        blockedBy: [...candidate.blockedBy],
+        unblocks: [...candidate.unblocks],
+        acceptanceCriteria: [...candidate.acceptanceCriteria],
+        todo: [...candidate.todo],
+        checkpoints: { ...candidate.checkpoints },
+        validation: [...candidate.validation],
+        sourceRefs: [...(candidate.sourceRefs ?? [])],
+    };
+}
+function toBoundedSpike(candidate) {
+    return {
+        candidateId: candidate.id,
+        timebox: "30m",
+        problem: candidate.title,
+        output: "A minimal vertical-slice task list or explicit blocker that can be reviewed without further exploration.",
+        acceptanceCriteria: [...candidate.acceptanceCriteria],
+    };
+}
+function highestPriority(candidates) {
+    return candidates.reduce((highest, candidate) => {
+        return PRIORITY_ORDER[candidate.priority] < PRIORITY_ORDER[highest] ? candidate.priority : highest;
+    }, "P3");
+}
+function diagnosePlanShape(plan) {
+    const diagnostics = [];
+    if (plan.version !== 1 || plan.kind !== "task-plan") {
+        diagnostics.push(diagnostic({
+            code: "invalid-task-plan-shape",
+            severity: "failure",
+            message: "Task plan artifact must use version 1 and kind task-plan.",
+            evidence: [String(plan.version), String(plan.kind)],
+        }));
+    }
+    if (plan.sourceEngine !== "task-decomposition") {
+        diagnostics.push(diagnostic({
+            code: "missing-shared-decomposition-source",
+            severity: "failure",
+            message: "Task plan artifact must be derived from the shared task decomposition engine.",
+            evidence: [String(plan.sourceEngine)],
+        }));
+    }
+    if (!plan.source?.kind) {
+        diagnostics.push(diagnostic({
+            code: "missing-task-plan-source",
+            severity: "failure",
+            message: "Task plan artifact must preserve the decomposition source kind.",
+            evidence: [],
+        }));
+    }
+    if (!plan.assessment || plan.assessment.status === "invalid") {
+        diagnostics.push(diagnostic({
+            code: "invalid-task-decomposition-assessment",
+            severity: "failure",
+            message: "Task plan artifact must preserve a non-invalid shared decomposition assessment.",
+            evidence: plan.assessment ? [plan.assessment.status] : [],
+        }));
+    }
+    if (!Array.isArray(plan.taskGroups) || plan.taskGroups.length === 0) {
+        diagnostics.push(diagnostic({
+            code: "missing-task-plan-fields",
+            severity: "failure",
+            message: "Task plan artifact must include at least one task group.",
+            evidence: [],
+        }));
+    }
+    if (plan.localSideEffects !== "none") {
+        diagnostics.push(diagnostic({
+            code: "local-side-effect",
+            severity: "failure",
+            message: "Task plan adapter must not write issue markdown or other local workflow artifacts by default.",
+            evidence: [String(plan.localSideEffects)],
+        }));
+    }
+    if (!Array.isArray(plan.workflowSideEffects) || plan.workflowSideEffects.length > 0) {
+        diagnostics.push(diagnostic({
+            code: "workflow-side-effect",
+            severity: "failure",
+            message: "Task plan adapter must not execute gate, staffing, issue publishing, dispatch, or workflow routing.",
+            evidence: Array.isArray(plan.workflowSideEffects) ? plan.workflowSideEffects.map(String) : [],
+        }));
+    }
+    return diagnostics;
+}
+function diagnoseTaskGroups(plan) {
+    if (!Array.isArray(plan.taskGroups))
+        return [];
+    return plan.taskGroups.flatMap((group) => {
+        const diagnostics = [];
+        if (!group.id || !group.title || !group.priority || !group.workMode || !Array.isArray(group.verticalSlices)) {
+            diagnostics.push(groupDiagnostic(group, "missing-task-plan-fields", "failure", "Task group is missing required fields.", []));
+        }
+        for (const slice of group.verticalSlices ?? []) {
+            diagnostics.push(...diagnoseVerticalSlice(group, slice));
+        }
+        return diagnostics;
+    });
+}
+function diagnoseVerticalSlice(group, slice) {
+    const diagnostics = [];
+    const missingRequired = !slice.id ||
+        !slice.title ||
+        !slice.priority ||
+        !slice.type ||
+        !slice.workMode ||
+        !Array.isArray(slice.blockedBy) ||
+        !Array.isArray(slice.unblocks) ||
+        !Array.isArray(slice.acceptanceCriteria) ||
+        slice.acceptanceCriteria.length === 0 ||
+        !Array.isArray(slice.todo) ||
+        slice.todo.length === 0 ||
+        !slice.checkpoints?.ready ||
+        !slice.checkpoints.green ||
+        !slice.checkpoints.review ||
+        !slice.checkpoints.verify ||
+        !Array.isArray(slice.validation) ||
+        slice.validation.length === 0;
+    if (missingRequired) {
+        diagnostics.push(sliceDiagnostic(group, slice, "missing-task-plan-fields", "failure", "Vertical slice is missing executable task plan fields.", []));
+    }
+    if (slice.workMode === "HITL" && !slice.hitlReason) {
+        diagnostics.push(sliceDiagnostic(group, slice, "missing-hitl-reason", "failure", "HITL vertical slices must preserve the bounded human-in-loop reason.", []));
+    }
+    return diagnostics;
+}
+function diagnoseSideEffects(plan) {
+    const diagnostics = [];
+    for (const field of Object.keys(plan)) {
+        if (SIDE_EFFECT_FIELDS.has(field)) {
+            diagnostics.push(diagnostic({
+                code: "workflow-side-effect",
+                severity: "failure",
+                message: `Task plan artifact must not include workflow side-effect field ${field}.`,
+                evidence: [field],
+            }));
+        }
+    }
+    if (!Array.isArray(plan.taskGroups))
+        return diagnostics;
+    for (const group of plan.taskGroups) {
+        for (const field of Object.keys(group)) {
+            if (SIDE_EFFECT_FIELDS.has(field)) {
+                diagnostics.push(groupDiagnostic(group, "workflow-side-effect", "failure", `Task group must not include workflow side-effect field ${field}.`, [field]));
+            }
+        }
+        for (const slice of group.verticalSlices ?? []) {
+            for (const field of Object.keys(slice)) {
+                if (SIDE_EFFECT_FIELDS.has(field)) {
+                    diagnostics.push(sliceDiagnostic(group, slice, "workflow-side-effect", "failure", `Vertical slice must not include workflow side-effect field ${field}.`, [field]));
+                }
+            }
+        }
+    }
+    return diagnostics;
+}
+function diagnoseBoundedSpikes(plan) {
+    if (!Array.isArray(plan.boundedSpikes))
+        return [];
+    return plan.boundedSpikes.flatMap((spike) => {
+        if (spike.timebox === "30m" &&
+            spike.problem?.trim() &&
+            spike.output?.trim() &&
+            Array.isArray(spike.acceptanceCriteria) &&
+            spike.acceptanceCriteria.length > 0) {
+            return [];
+        }
+        return [
+            diagnostic({
+                code: "invalid-bounded-spike",
+                severity: "failure",
+                message: "Bounded spike must include timebox, problem, output, and acceptance criteria.",
+                evidence: [spike.candidateId],
+            }),
+        ];
+    });
+}
+function scoreDiagnostics(diagnostics) {
+    const penalty = diagnostics.reduce((total, diagnostic) => {
+        return total + (diagnostic.severity === "failure" ? 20 : 10);
+    }, 0);
+    return Math.max(0, TARGET_SCORE - penalty);
+}
+function slugify(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "") || "task-group";
+}
+function diagnostic(input) {
+    return {
+        evidence: [],
+        ...input,
+    };
+}
+function groupDiagnostic(group, code, severity, message, evidence) {
+    return diagnostic({
+        code,
+        severity,
+        groupId: group.id,
+        message,
+        evidence,
+    });
+}
+function sliceDiagnostic(group, slice, code, severity, message, evidence) {
+    return diagnostic({
+        code,
+        severity,
+        groupId: group.id,
+        sliceId: slice.id,
+        message,
+        evidence,
+    });
+}
+//# sourceMappingURL=task-plan-adapter.js.map

package/dist/core/task-plan-adapter.js.map

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

package/dist/core/validation-packet.d.ts

@@ -0,0 +1,86 @@
+export type ValidationEvidenceKind = "unit" | "integration" | "smoke" | "manual" | "static" | "review";
+export type ValidationEvidenceStatus = "pass" | "fail" | "skipped";
+export type ContractTier = "intrinsic-engineering" | "contextual-spec-design-task" | "workflow-governance";
+export type ValidationPacket = {
+    version: 1;
+    mode?: "direct" | "governed" | "strict";
+    change?: {
+        kind: "feature" | "bugfix" | "refactor" | "mechanical";
+        summary?: string;
+        noRedReason?: string;
+    };
+    contractTiers?: ValidationContractTiers;
+    implementationLoop?: ValidationImplementationLoop;
+    acceptanceCriteria: ValidationAcceptanceCriterion[];
+    evidence: ValidationEvidence[];
+    mockBoundary?: ValidationMockBoundary;
+    qualitySignals?: ValidationQualitySignals;
+};
+export type ValidationContractTiers = {
+    intrinsicEngineering: string[];
+    contextualSpecDesignTask: string[];
+    workflowGovernance: string[];
+};
+export type ValidationImplementationLoop = {
+    strategy: "tdd" | "tracer-bullet" | "focused-validation";
+    cycles: ValidationImplementationCycle[];
+};
+export type ValidationImplementationCycle = {
+    behavior: string;
+    sourceId?: string;
+    redEvidence?: string;
+    greenEvidence?: string;
+    refactorEvidence?: string;
+    noRedReason?: string;
+    changedFiles?: string[];
+};
+export type ValidationAcceptanceCriterion = {
+    id: string;
+    description: string;
+    evidence: string[];
+};
+export type ValidationEvidence = {
+    id: string;
+    kind: ValidationEvidenceKind;
+    status: ValidationEvidenceStatus;
+    behavior: string;
+    covers?: string[];
+    exercises?: string[];
+    mocked?: string[];
+    assertion?: "behavior" | "implementation";
+    red?: boolean;
+    negative?: boolean;
+};
+export type ValidationMockBoundary = {
+    mocked: string[];
+    real: string[];
+    integrationRequired: string[];
+};
+export type ValidationQualitySignals = {
+    placeholders?: string[];
+    hacks?: string[];
+    broadRefactor?: boolean;
+    styleIssues?: string[];
+    typeIssues?: string[];
+    errorHandlingGaps?: string[];
+    scopeViolations?: string[];
+    contractViolations?: string[];
+};
+export type ValidationDiagnosticSeverity = "warning" | "failure";
+export type ValidationDiagnostic = {
+    code: string;
+    severity: ValidationDiagnosticSeverity;
+    tier: ContractTier;
+    message: string;
+    evidence: string[];
+};
+export type ValidationAssessment = {
+    status: "trusted" | "warning" | "untrusted";
+    targetScore: 100;
+    score: number;
+    confidence: "high" | "medium" | "low";
+    nextActions: string[];
+    diagnostics: ValidationDiagnostic[];
+};
+export declare function evaluateValidationPacket(packet: ValidationPacket): ValidationAssessment;
+export declare function formatValidationPacketForPullRequest(packet: ValidationPacket): string;