@captain_z/zsk 1.8.7 → 1.8.9

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;

package/dist/core/task-decomposition.js

@@ -0,0 +1,325 @@
+const TARGET_SCORE = 100;
+const SIDE_EFFECT_FIELDS = new Set([
+    "issuePath",
+    "publish",
+    "writeIssue",
+    "gate",
+    "dispatch",
+    "agent",
+    "nextSkill",
+    "workflowNext",
+    "route",
+]);
+const LAYER_ONLY_PATTERNS = [
+    /\bdata\s+layer\b/i,
+    /\bapi\s+layer\b/i,
+    /\bui\s+layer\b/i,
+    /\bfrontend\s+layer\b/i,
+    /\bbackend\s+layer\b/i,
+    /\bmodels?\b/i,
+    /\brepositories\b/i,
+    /\bcontrollers\b/i,
+    /\broutes\b/i,
+    /\bscreens\b/i,
+    /\bservices?\b/i,
+];
+const OBSERVABLE_BEHAVIOR_PATTERNS = [
+    /\buser\b/i,
+    /\bworkflow\b/i,
+    /\bbehavior\b/i,
+    /\bscenario\b/i,
+    /\baccepts?\b/i,
+    /\brejects?\b/i,
+    /\bshows?\b/i,
+    /\breturns?\b/i,
+    /\bpersists?\b/i,
+    /\breports?\b/i,
+    /\bcan\b/i,
+    /\bwhen\b/i,
+    /\bgiven\b/i,
+    /\bthen\b/i,
+];
+const ORDERING_PATTERNS = [
+    /\bdepends?\b/i,
+    /\bafter\b/i,
+    /\bbefore\b/i,
+    /\bfirst\b/i,
+    /\bthen\b/i,
+    /\bnext\b/i,
+    /\bexists\b/i,
+    /\blayer\b/i,
+    /\bunblocks?\b/i,
+];
+export function createTaskDecomposition(input) {
+    return {
+        version: 1,
+        source: {
+            kind: input.kind,
+            title: input.title,
+        },
+        candidates: input.candidates?.map(normalizeCandidate) ?? [fallbackClarificationCandidate(input)],
+    };
+}
+export function evaluateTaskDecomposition(result) {
+    const diagnostics = [
+        ...diagnoseResultShape(result),
+        ...diagnoseCandidateCompleteness(result.candidates),
+        ...diagnoseHorizontalSlicing(result.candidates),
+        ...diagnoseDependencyClarity(result.candidates),
+        ...diagnoseHitlBoundaries(result.candidates),
+        ...diagnoseSideEffects(result),
+    ];
+    const status = diagnostics.some((diagnostic) => diagnostic.severity === "failure")
+        ? "invalid"
+        : diagnostics.length > 0
+            ? "warning"
+            : "valid";
+    return {
+        status,
+        targetScore: TARGET_SCORE,
+        score: scoreDiagnostics(diagnostics),
+        diagnostics,
+    };
+}
+function normalizeCandidate(candidate) {
+    return {
+        ...candidate,
+        blockedBy: candidate.blockedBy ?? [],
+        unblocks: candidate.unblocks ?? [],
+        acceptanceCriteria: candidate.acceptanceCriteria ?? [],
+        todo: candidate.todo ?? [],
+        validation: candidate.validation ?? [],
+    };
+}
+function fallbackClarificationCandidate(input) {
+    const title = input.title ? `Clarify vertical slices for ${input.title}` : "Clarify vertical slices";
+    return {
+        id: "task-decomposition-clarification",
+        title,
+        group: "task-decomposition",
+        priority: "P0",
+        type: "spike",
+        workMode: "HITL",
+        hitlReason: "human-decision",
+        blockedBy: [],
+        unblocks: [],
+        acceptanceCriteria: [
+            "A reviewed vertical-slice task list exists with observable acceptance criteria and explicit dependencies.",
+        ],
+        todo: [
+            "Ready: collect the source plan, PRD, spec, conversation summary, or issue body.",
+            "Red: identify any horizontal, unverifiable, or dependency-ambiguous slices.",
+            "Green: rewrite into independently verifiable task candidates.",
+            "Verify: run the task decomposition assessment and record remaining gaps.",
+        ],
+        checkpoints: {
+            ready: "Source material is available for task decomposition.",
+            red: "Quality gaps are identified before publishing tasks.",
+            green: "Candidates are rewritten as vertical slices.",
+            review: "No workflow side effects are embedded in the candidates.",
+            verify: "Task decomposition assessment is valid or gaps are explicit.",
+        },
+        validation: [
+            {
+                kind: "eval",
+                expected: "evaluateTaskDecomposition reports valid candidates or explicit diagnostics.",
+            },
+        ],
+        sourceRefs: input.body ? ["input.body"] : [],
+    };
+}
+function diagnoseResultShape(result) {
+    const diagnostics = [];
+    if (result.version !== 1) {
+        diagnostics.push(diagnostic({
+            code: "unsupported-version",
+            severity: "failure",
+            message: "Task decomposition result must use version 1.",
+            evidence: [String(result.version)],
+        }));
+    }
+    if (!result.source?.kind) {
+        diagnostics.push(diagnostic({
+            code: "missing-source-kind",
+            severity: "failure",
+            message: "Task decomposition result must record the consumed source kind.",
+            evidence: [],
+        }));
+    }
+    if (!Array.isArray(result.candidates) || result.candidates.length === 0) {
+        diagnostics.push(diagnostic({
+            code: "missing-candidates",
+            severity: "failure",
+            message: "Task decomposition must output at least one task candidate.",
+            evidence: [],
+        }));
+    }
+    return diagnostics;
+}
+function diagnoseCandidateCompleteness(candidates) {
+    return candidates.flatMap((candidate) => {
+        const diagnostics = [];
+        const requiredStrings = [
+            ["id", "missing-id"],
+            ["title", "missing-title"],
+            ["group", "missing-group"],
+            ["priority", "missing-priority"],
+            ["type", "missing-type"],
+            ["workMode", "missing-work-mode"],
+        ];
+        for (const [field, code] of requiredStrings) {
+            const value = candidate[field];
+            if (typeof value !== "string" || value.trim().length === 0) {
+                diagnostics.push(candidateDiagnostic(candidate, code, "failure", `Candidate is missing ${String(field)}.`, []));
+            }
+        }
+        if (!Array.isArray(candidate.blockedBy)) {
+            diagnostics.push(candidateDiagnostic(candidate, "missing-dependency-metadata", "failure", "Candidate must include blockedBy dependency metadata.", []));
+        }
+        if (!Array.isArray(candidate.unblocks)) {
+            diagnostics.push(candidateDiagnostic(candidate, "missing-unblock-metadata", "failure", "Candidate must include unblocks relationship metadata.", []));
+        }
+        if (!Array.isArray(candidate.acceptanceCriteria) || candidate.acceptanceCriteria.length === 0) {
+            diagnostics.push(candidateDiagnostic(candidate, "missing-acceptance-criteria", "failure", "Candidate must include observable acceptance criteria.", []));
+        }
+        if (!Array.isArray(candidate.todo) || candidate.todo.length === 0) {
+            diagnostics.push(candidateDiagnostic(candidate, "missing-todo", "failure", "Candidate must include executable todo steps.", []));
+        }
+        if (!hasRequiredCheckpoints(candidate.checkpoints)) {
+            diagnostics.push(candidateDiagnostic(candidate, "missing-checkpoints", "failure", "Candidate must include ready, green, review, and verify checkpoints.", []));
+        }
+        if (!Array.isArray(candidate.validation) || candidate.validation.length === 0) {
+            diagnostics.push(candidateDiagnostic(candidate, "missing-validation", "failure", "Candidate must include validation hooks.", []));
+        }
+        return diagnostics;
+    });
+}
+function diagnoseHorizontalSlicing(candidates) {
+    return candidates.flatMap((candidate) => {
+        const titleAndGroup = `${candidate.title} ${candidate.group} ${candidate.todo?.join(" ") ?? ""}`;
+        const layerOnlySignals = LAYER_ONLY_PATTERNS.filter((pattern) => pattern.test(titleAndGroup)).length;
+        const observableSignals = [
+            candidate.title,
+            ...candidate.acceptanceCriteria,
+            ...candidate.todo,
+        ].filter((text) => OBSERVABLE_BEHAVIOR_PATTERNS.some((pattern) => pattern.test(text))).length;
+        if (layerOnlySignals >= 2 && observableSignals === 0) {
+            return [
+                candidateDiagnostic(candidate, "horizontal-slice", "failure", "Candidate is sliced by implementation layer instead of a thin, independently verifiable behavior.", [candidate.title]),
+            ];
+        }
+        return [];
+    });
+}
+function diagnoseDependencyClarity(candidates) {
+    if (candidates.length <= 1)
+        return [];
+    const ids = new Set(candidates.map((candidate) => candidate.id));
+    const diagnostics = [];
+    const linkedCandidateCount = candidates.filter((candidate) => candidate.blockedBy.length > 0 || candidate.unblocks.length > 0).length;
+    if (linkedCandidateCount === 0 && candidates.some(hasOrderingSignal)) {
+        diagnostics.push(diagnostic({
+            code: "dependency-ambiguous",
+            severity: "failure",
+            message: "Task candidates imply ordering but do not make dependencies or unblock relationships explicit.",
+            evidence: candidates.map((candidate) => candidate.id),
+        }));
+    }
+    for (const candidate of candidates) {
+        for (const dependency of candidate.blockedBy) {
+            if (!ids.has(dependency)) {
+                diagnostics.push(candidateDiagnostic(candidate, "unknown-dependency", "failure", "Candidate depends on an unknown task id.", [dependency]));
+            }
+        }
+        for (const unblocked of candidate.unblocks) {
+            if (!ids.has(unblocked)) {
+                diagnostics.push(candidateDiagnostic(candidate, "unknown-unblock", "failure", "Candidate unblocks an unknown task id.", [unblocked]));
+            }
+        }
+    }
+    return diagnostics;
+}
+function hasOrderingSignal(candidate) {
+    const checkpointText = candidate.checkpoints
+        ? Object.values(candidate.checkpoints).filter((value) => typeof value === "string")
+        : [];
+    const validationText = candidate.validation.map((hook) => (typeof hook === "string" ? hook : hook.expected));
+    const text = [
+        candidate.title,
+        candidate.group,
+        candidate.type,
+        ...candidate.todo,
+        ...candidate.acceptanceCriteria,
+        ...checkpointText,
+        ...validationText,
+    ].join(" ");
+    return ORDERING_PATTERNS.some((pattern) => pattern.test(text));
+}
+function diagnoseHitlBoundaries(candidates) {
+    return candidates.flatMap((candidate) => {
+        if (candidate.workMode === "AFK")
+            return [];
+        if (candidate.workMode !== "HITL") {
+            return [
+                candidateDiagnostic(candidate, "invalid-work-mode", "failure", "Candidate workMode must be AFK or HITL.", [String(candidate.workMode)]),
+            ];
+        }
+        if (!candidate.hitlReason) {
+            return [
+                candidateDiagnostic(candidate, "missing-hitl-reason", "failure", "HITL candidates must be limited to human decision, credentials, external environment, or destructive operation.", []),
+            ];
+        }
+        return [];
+    });
+}
+function diagnoseSideEffects(result) {
+    const diagnostics = [];
+    for (const field of Object.keys(result)) {
+        if (SIDE_EFFECT_FIELDS.has(field)) {
+            diagnostics.push(diagnostic({
+                code: "workflow-side-effect",
+                severity: "failure",
+                message: `Task decomposition result must not include workflow side-effect field ${field}.`,
+                evidence: [field],
+            }));
+        }
+    }
+    for (const candidate of result.candidates) {
+        for (const field of Object.keys(candidate)) {
+            if (SIDE_EFFECT_FIELDS.has(field)) {
+                diagnostics.push(candidateDiagnostic(candidate, "workflow-side-effect", "failure", `Task candidate must not include workflow side-effect field ${field}.`, [field]));
+            }
+        }
+    }
+    return diagnostics;
+}
+function hasRequiredCheckpoints(checkpoints) {
+    if (!checkpoints)
+        return false;
+    return ["ready", "green", "review", "verify"].every((key) => {
+        const value = checkpoints[key];
+        return typeof value === "string" && value.trim().length > 0;
+    });
+}
+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 diagnostic(input) {
+    return {
+        evidence: [],
+        ...input,
+    };
+}
+function candidateDiagnostic(candidate, code, severity, message, evidence) {
+    return diagnostic({
+        code,
+        severity,
+        candidateId: candidate.id,
+        message,
+        evidence,
+    });
+}
+//# sourceMappingURL=task-decomposition.js.map

package/dist/core/task-decomposition.js.map

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

package/dist/core/task-plan-adapter.d.ts

@@ -0,0 +1,57 @@
+import { type TaskCandidate, type TaskDecompositionAssessment, type TaskDecompositionResult, type TaskValidationHook } from "./task-decomposition.js";
+export type TaskPlanVerticalSlice = {
+    id: string;
+    title: string;
+    priority: TaskCandidate["priority"];
+    type: TaskCandidate["type"];
+    workMode: TaskCandidate["workMode"];
+    hitlReason?: TaskCandidate["hitlReason"];
+    blockedBy: string[];
+    unblocks: string[];
+    acceptanceCriteria: string[];
+    todo: string[];
+    checkpoints: TaskCandidate["checkpoints"];
+    validation: TaskValidationHook[];
+    sourceRefs: string[];
+};
+export type TaskPlanGroup = {
+    id: string;
+    title: string;
+    priority: TaskCandidate["priority"];
+    workMode: TaskCandidate["workMode"];
+    verticalSlices: TaskPlanVerticalSlice[];
+};
+export type BoundedTaskSpike = {
+    candidateId: string;
+    timebox: "30m";
+    problem: string;
+    output: string;
+    acceptanceCriteria: string[];
+};
+export type TaskPlanArtifact = {
+    version: 1;
+    kind: "task-plan";
+    sourceEngine: "task-decomposition";
+    source: TaskDecompositionResult["source"];
+    assessment: TaskDecompositionAssessment;
+    localSideEffects: "none";
+    workflowSideEffects: [];
+    taskGroups: TaskPlanGroup[];
+    boundedSpikes: BoundedTaskSpike[];
+};
+export type TaskPlanDiagnostic = {
+    code: string;
+    severity: "warning" | "failure";
+    groupId?: string;
+    sliceId?: string;
+    message: string;
+    evidence: string[];
+};
+export type TaskPlanAssessment = {
+    status: "valid" | "warning" | "invalid";
+    targetScore: 100;
+    score: number;
+    diagnostics: TaskPlanDiagnostic[];
+};
+export declare function createTaskPlan(decomposition: TaskDecompositionResult): TaskPlanArtifact;
+export declare function evaluateTaskPlan(plan: TaskPlanArtifact): TaskPlanAssessment;