@captain_z/zsk 1.8.6 → 1.8.8

package/dist/core/validation-packet.js

@@ -0,0 +1,313 @@
+const REAL_WIRING_EVIDENCE = new Set(["integration", "smoke", "manual", "review"]);
+const TARGET_SCORE = 100;
+export function evaluateValidationPacket(packet) {
+    const diagnostics = [
+        ...diagnoseAcceptanceMapping(packet),
+        ...diagnoseImplementationLoop(packet),
+        ...diagnoseContractTiers(packet),
+        ...diagnoseBugfixRedEvidence(packet),
+        ...diagnoseMockOnlyCriticalPaths(packet),
+        ...diagnoseImplementationAssertions(packet),
+        ...diagnoseMissingNegativeEvidence(packet),
+        ...diagnoseQualitySignals(packet),
+    ];
+    const status = assessmentStatus(diagnostics);
+    const score = scoreDiagnostics(diagnostics);
+    return {
+        status,
+        targetScore: TARGET_SCORE,
+        score,
+        confidence: confidenceFor(status, score),
+        nextActions: nextActionsFor(diagnostics),
+        diagnostics,
+    };
+}
+export function formatValidationPacketForPullRequest(packet) {
+    const assessment = evaluateValidationPacket(packet);
+    const lines = [
+        "### Validation packet",
+        `Validation: ${assessment.status}`,
+        `Score: ${assessment.score}/${assessment.targetScore}`,
+        `Confidence: ${assessment.confidence}`,
+        "",
+        "Acceptance criteria",
+    ];
+    for (const criterion of packet.acceptanceCriteria) {
+        lines.push(`- ${criterion.id}: ${criterion.description}`);
+        for (const evidenceId of criterion.evidence) {
+            const evidence = packet.evidence.find((candidate) => candidate.id === evidenceId);
+            if (!evidence) {
+                lines.push(`  - ${evidenceId} [missing]`);
+                continue;
+            }
+            lines.push(`  - ${evidence.id} [${evidence.kind}/${evidence.status}]: ${evidence.behavior}`);
+        }
+    }
+    if (packet.implementationLoop) {
+        lines.push("", "Implementation loop");
+        lines.push(`- strategy: ${packet.implementationLoop.strategy}`);
+        for (const cycle of packet.implementationLoop.cycles) {
+            lines.push(`- ${cycle.behavior}${cycle.sourceId ? ` (${cycle.sourceId})` : ""}`);
+            lines.push(`  - RED: ${cycle.redEvidence ?? cycle.noRedReason ?? "missing"}`);
+            lines.push(`  - GREEN: ${cycle.greenEvidence || "missing"}`);
+            if (cycle.refactorEvidence) {
+                lines.push(`  - REFACTOR: ${cycle.refactorEvidence}`);
+            }
+            if (cycle.changedFiles && cycle.changedFiles.length > 0) {
+                lines.push(`  - changed files: ${joinList(cycle.changedFiles)}`);
+            }
+        }
+    }
+    if (packet.contractTiers) {
+        lines.push("", "Contract tiers");
+        lines.push(`- intrinsic engineering: ${joinList(packet.contractTiers.intrinsicEngineering)}`);
+        lines.push(`- contextual spec/design/task: ${joinList(packet.contractTiers.contextualSpecDesignTask)}`);
+        lines.push(`- workflow governance: ${joinList(packet.contractTiers.workflowGovernance)}`);
+    }
+    if (packet.mockBoundary) {
+        lines.push("", "Mock boundary");
+        lines.push(`- mocked: ${joinList(packet.mockBoundary.mocked)}`);
+        lines.push(`- real: ${joinList(packet.mockBoundary.real)}`);
+        lines.push(`- integration required: ${joinList(packet.mockBoundary.integrationRequired)}`);
+    }
+    if (assessment.diagnostics.length > 0) {
+        lines.push("", "Gaps");
+        for (const item of assessment.diagnostics) {
+            lines.push(`- ${item.code} [${item.severity}/${item.tier}]: ${item.message}`);
+        }
+    }
+    return lines.join("\n");
+}
+function diagnoseAcceptanceMapping(packet) {
+    return packet.acceptanceCriteria.flatMap((criterion) => {
+        const referenced = criterion.evidence
+            .map((id) => packet.evidence.find((evidence) => evidence.id === id))
+            .filter((evidence) => Boolean(evidence));
+        const passing = referenced.filter((evidence) => evidence.status === "pass");
+        if (passing.length === 0) {
+            return [
+                diagnostic({
+                    code: "acceptance-criteria-unmapped",
+                    severity: "failure",
+                    tier: "contextual-spec-design-task",
+                    message: `Acceptance criterion ${criterion.id} has no passing evidence.`,
+                    evidence: criterion.evidence,
+                }),
+            ];
+        }
+        const covering = passing.filter((evidence) => evidence.covers?.includes(criterion.id));
+        if (covering.length > 0)
+            return [];
+        return [
+            diagnostic({
+                code: "evidence-does-not-cover-criterion",
+                severity: "failure",
+                tier: "contextual-spec-design-task",
+                message: `Acceptance criterion ${criterion.id} references passing evidence that does not explicitly cover it.`,
+                evidence: passing.map((evidence) => evidence.id),
+            }),
+        ];
+    });
+}
+function diagnoseImplementationLoop(packet) {
+    if (!isMeaningfulBehaviorChange(packet))
+        return [];
+    const loop = packet.implementationLoop;
+    if (!loop || loop.cycles.length === 0) {
+        return [
+            diagnostic({
+                code: "missing-implementation-loop",
+                severity: "warning",
+                tier: "intrinsic-engineering",
+                message: "Meaningful coding changes should record a per-behavior TDD, tracer-bullet, or focused-validation loop.",
+                evidence: [],
+            }),
+        ];
+    }
+    const diagnostics = [];
+    for (const cycle of loop.cycles) {
+        if (!cycle.greenEvidence?.trim()) {
+            diagnostics.push(diagnostic({
+                code: "missing-cycle-green-evidence",
+                severity: "failure",
+                tier: "intrinsic-engineering",
+                message: `Implementation cycle ${cycle.behavior} has no GREEN evidence.`,
+                evidence: [cycle.behavior],
+            }));
+        }
+        if (loop.strategy === "tdd" && !cycle.redEvidence?.trim() && !cycle.noRedReason?.trim()) {
+            diagnostics.push(diagnostic({
+                code: "missing-cycle-red-evidence",
+                severity: "warning",
+                tier: "intrinsic-engineering",
+                message: `TDD cycle ${cycle.behavior} has no RED evidence or explicit no-red reason.`,
+                evidence: [cycle.behavior],
+            }));
+        }
+    }
+    return diagnostics;
+}
+function diagnoseContractTiers(packet) {
+    if (!isMeaningfulBehaviorChange(packet))
+        return [];
+    if (packet.contractTiers)
+        return [];
+    return [
+        diagnostic({
+            code: "missing-contract-tiers",
+            severity: "warning",
+            tier: "intrinsic-engineering",
+            message: "Coding validation packets should mark intrinsic, contextual, and workflow-governance contract tiers.",
+            evidence: [],
+        }),
+    ];
+}
+function diagnoseBugfixRedEvidence(packet) {
+    if (packet.change?.kind !== "bugfix")
+        return [];
+    if (packet.change.noRedReason)
+        return [];
+    if (packet.evidence.some((evidence) => evidence.red))
+        return [];
+    return [
+        diagnostic({
+            code: "missing-red-evidence",
+            severity: "warning",
+            tier: "intrinsic-engineering",
+            message: "Bug fix packet has no red evidence or explicit reason why red-first was not possible.",
+            evidence: [],
+        }),
+    ];
+}
+function diagnoseMockOnlyCriticalPaths(packet) {
+    const boundary = packet.mockBoundary;
+    if (!boundary || boundary.integrationRequired.length === 0)
+        return [];
+    const missing = boundary.integrationRequired.filter((requiredPath) => !hasRealWiringEvidenceFor(packet.evidence, requiredPath));
+    if (missing.length === 0)
+        return [];
+    return [
+        diagnostic({
+            code: "mock-only-critical-path",
+            severity: "failure",
+            tier: "intrinsic-engineering",
+            message: "Critical integration path is represented only by mocked or unit evidence.",
+            evidence: missing,
+        }),
+    ];
+}
+function hasRealWiringEvidenceFor(evidenceList, requiredPath) {
+    return evidenceList.some((evidence) => evidence.status === "pass" &&
+        REAL_WIRING_EVIDENCE.has(evidence.kind) &&
+        evidenceMatchesRequiredPath(evidence, requiredPath));
+}
+function evidenceMatchesRequiredPath(evidence, requiredPath) {
+    const required = normalizeEvidenceText(requiredPath);
+    const candidates = [
+        evidence.id,
+        evidence.behavior,
+        ...(evidence.covers ?? []),
+        ...(evidence.exercises ?? []),
+    ].map(normalizeEvidenceText).filter(Boolean);
+    return candidates.some((candidate) => candidate === required || candidate.includes(required));
+}
+function diagnoseImplementationAssertions(packet) {
+    return packet.evidence
+        .filter((evidence) => evidence.assertion === "implementation")
+        .map((evidence) => diagnostic({
+        code: "implementation-detail-assertion",
+        severity: "warning",
+        tier: "intrinsic-engineering",
+        message: `Evidence ${evidence.id} asserts implementation details instead of observable behavior.`,
+        evidence: [evidence.id],
+    }));
+}
+function diagnoseMissingNegativeEvidence(packet) {
+    if (packet.change?.kind !== "feature" && packet.change?.kind !== "bugfix")
+        return [];
+    if (packet.evidence.some((evidence) => evidence.negative))
+        return [];
+    return [
+        diagnostic({
+            code: "missing-negative-evidence",
+            severity: "warning",
+            tier: "intrinsic-engineering",
+            message: "Feature or bugfix packet has no negative evidence for invalid, failing, or guarded behavior.",
+            evidence: [],
+        }),
+    ];
+}
+function diagnoseQualitySignals(packet) {
+    const signals = packet.qualitySignals;
+    if (!signals)
+        return [];
+    return [
+        ...qualityListDiagnostic("placeholder-left-in-code", "failure", signals.placeholders),
+        ...qualityListDiagnostic("hack-left-in-code", "failure", signals.hacks),
+        ...qualityListDiagnostic("style-issue", "warning", signals.styleIssues),
+        ...qualityListDiagnostic("type-issue", "warning", signals.typeIssues),
+        ...qualityListDiagnostic("error-handling-gap", "warning", signals.errorHandlingGaps),
+        ...qualityListDiagnostic("scope-violation", "failure", signals.scopeViolations),
+        ...qualityListDiagnostic("contract-violation", "failure", signals.contractViolations),
+        ...(signals.broadRefactor
+            ? [
+                diagnostic({
+                    code: "broad-refactor-without-validation",
+                    severity: "warning",
+                    tier: "intrinsic-engineering",
+                    message: "Packet reports broad refactor risk; require focused validation evidence before trusting green tests.",
+                    evidence: [],
+                }),
+            ]
+            : []),
+    ];
+}
+function qualityListDiagnostic(code, severity, values) {
+    if (!values || values.length === 0)
+        return [];
+    return [
+        diagnostic({
+            code,
+            severity,
+            tier: "intrinsic-engineering",
+            message: `${code} detected in validation packet.`,
+            evidence: values,
+        }),
+    ];
+}
+function diagnostic(d) {
+    return d;
+}
+function assessmentStatus(diagnostics) {
+    if (diagnostics.some((diagnostic) => diagnostic.severity === "failure"))
+        return "untrusted";
+    if (diagnostics.length > 0)
+        return "warning";
+    return "trusted";
+}
+function scoreDiagnostics(diagnostics) {
+    const penalty = diagnostics.reduce((total, diagnostic) => {
+        return total + (diagnostic.severity === "failure" ? 35 : 15);
+    }, 0);
+    return Math.max(0, TARGET_SCORE - penalty);
+}
+function confidenceFor(status, score) {
+    if (status === "untrusted" || score < 70)
+        return "low";
+    if (status === "warning" || score < 90)
+        return "medium";
+    return "high";
+}
+function nextActionsFor(diagnostics) {
+    return Array.from(new Set(diagnostics.map((diagnostic) => `${diagnostic.code}: ${diagnostic.message}`)));
+}
+function isMeaningfulBehaviorChange(packet) {
+    return packet.change?.kind === "feature" || packet.change?.kind === "bugfix";
+}
+function normalizeEvidenceText(value) {
+    return value.trim().toLowerCase().replace(/[^a-z0-9]+/g, " ").replace(/\s+/g, " ").trim();
+}
+function joinList(values) {
+    return values.length > 0 ? values.join(", ") : "none";
+}
+//# sourceMappingURL=validation-packet.js.map

package/dist/core/validation-packet.js.map

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

package/dist/core/work-ledger.d.ts

@@ -0,0 +1,44 @@
+import type { ProjectConfig } from "./config.js";
+export type WorkEvent = {
+    event?: string;
+    version?: number;
+    occurredAt?: string;
+    producer?: {
+        skill?: string;
+        stage?: string;
+    };
+    workItem?: {
+        id?: string;
+        type?: string;
+        title?: string;
+        project?: string | {
+            id?: string;
+            name?: string;
+        };
+        module?: string | {
+            id?: string;
+            name?: string;
+        };
+        stage?: string;
+        status?: string;
+        sourceArtifacts?: unknown[];
+        externalRefs?: Record<string, unknown>;
+        [key: string]: unknown;
+    };
+    assignment?: Record<string, unknown>;
+    status?: {
+        from?: string;
+        to?: string;
+        [key: string]: unknown;
+    };
+    links?: Record<string, unknown>;
+    evidence?: Record<string, unknown>;
+    [key: string]: unknown;
+};
+export declare function resolveWorkLedgerPath(target: string, config: ProjectConfig): Promise<{
+    workConfigPath: string;
+    ledgerPath: string;
+}>;
+export declare function readWorkEvents(path: string): Promise<WorkEvent[]>;
+export declare function appendWorkEvents(path: string, events: WorkEvent[]): Promise<void>;
+export declare function latestWorkItem(events: WorkEvent[], localId: string): NonNullable<WorkEvent["workItem"]> | undefined;

package/dist/core/work-ledger.js

@@ -0,0 +1,88 @@
+import { access, appendFile, mkdir, readFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import YAML from "yaml";
+import { isPathInside, resolveProjectPath } from "./workspace-conformance.js";
+export async function resolveWorkLedgerPath(target, config) {
+    const workConfigPath = resolveInsideProject(target, config.customize?.work ?? ".zsk/work.yaml");
+    let ledgerRel = ".zsk/work.jsonl";
+    try {
+        const raw = await readFile(workConfigPath, "utf8");
+        const parsed = YAML.parse(raw);
+        if (isRecord(parsed)) {
+            const workConfig = parsed;
+            ledgerRel = workConfig.ledger?.path ?? ledgerRel;
+        }
+    }
+    catch {
+        ledgerRel = ".zsk/work.jsonl";
+    }
+    return {
+        workConfigPath,
+        ledgerPath: resolveInsideProject(target, ledgerRel),
+    };
+}
+export async function readWorkEvents(path) {
+    try {
+        await access(path);
+    }
+    catch {
+        return [];
+    }
+    const raw = await readFile(path, "utf8");
+    const events = [];
+    for (const [index, line] of raw.split(/\r?\n/).entries()) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (isRecord(parsed)) {
+                events.push(parsed);
+                continue;
+            }
+            events.push(invalidWorkEvent(index + 1, "Invalid work event"));
+        }
+        catch {
+            events.push(invalidWorkEvent(index + 1, "Invalid JSONL event"));
+        }
+    }
+    return events;
+}
+export async function appendWorkEvents(path, events) {
+    await mkdir(dirname(path), { recursive: true });
+    await appendFile(path, events.map((event) => JSON.stringify(event)).join("\n") + "\n", "utf8");
+}
+export function latestWorkItem(events, localId) {
+    for (const event of [...events].reverse()) {
+        if (event.workItem?.id === localId)
+            return event.workItem;
+    }
+    return undefined;
+}
+function invalidWorkEvent(line, title) {
+    return {
+        event: "invalid",
+        producer: { skill: "work", stage: "sync" },
+        workItem: {
+            id: `line-${line}`,
+            type: "invalid",
+            title,
+            project: "unknown",
+            module: "unknown",
+            stage: "sync",
+            status: "blocked",
+            sourceArtifacts: [],
+        },
+    };
+}
+function resolveInsideProject(root, value) {
+    const resolved = resolveProjectPath(root, value);
+    if (!isPathInside(resolve(root), resolved)) {
+        throw new Error(`work ledger path must stay inside the project: ${value}`);
+    }
+    return resolved;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=work-ledger.js.map

package/dist/core/work-ledger.js.map

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

package/dist/core/work-provider-adapters.d.ts

@@ -0,0 +1,110 @@
+import type { WorkEvent } from "./work-ledger.js";
+export type WorkProviderConfig = {
+    adapter?: string;
+    mode?: string;
+    workspace?: string;
+    expertCatalog?: {
+        path?: string;
+    };
+    commandPlan?: {
+        executable?: string;
+        mode?: string;
+    };
+    projectMapping?: {
+        strategy?: string;
+        projects?: Record<string, string | undefined>;
+    };
+    statusMapping?: Record<string, string | undefined>;
+    assignment?: Record<string, unknown>;
+};
+export type WorkSyncPlanItem = {
+    line: number;
+    event: string;
+    action: string;
+    localId: string | null;
+    project: string | null;
+    module: string | null;
+    stage: string | null;
+    localStatus: string | null;
+    providerStatus: string | null;
+    remoteRef: unknown;
+    remoteReady: boolean;
+    blockedReasons: string[];
+};
+export type WorkProviderCommand = {
+    line: number;
+    action: string;
+    operation: string;
+    executable: string;
+    argv: string[];
+    display: string;
+    metadata: Record<string, unknown>;
+    dryRun: true;
+    remoteSideEffects: "none";
+    ready: boolean;
+    blockedReasons: string[];
+    notes: string[];
+};
+export type WorkProviderCommandPlan = {
+    mode: "dry-run";
+    adapter: string | null;
+    executable: string;
+    commandCount: number;
+    blockedCount: number;
+    commands: WorkProviderCommand[];
+};
+export type WorkAssignmentCommandInput = {
+    workItem: {
+        id: string;
+        project: string | null;
+        module: string | null;
+        stage: string | null;
+    };
+    assignment: {
+        mode: "agent" | "squad" | "role";
+        role: string;
+        agent: string | null;
+        squad: string | null;
+        providerAgent: string | null;
+        rationale: string;
+    };
+};
+export type WorkProviderExecutableInput = {
+    provider: string;
+    providerConfig: WorkProviderConfig;
+};
+export type WorkProviderItemCommandInput = WorkProviderExecutableInput & {
+    item: WorkSyncPlanItem;
+    event: WorkEvent | undefined;
+    providerConfigured: boolean;
+    executable: string;
+};
+export type WorkProviderAssignmentCommandInput = WorkProviderExecutableInput & {
+    providerConfigured: boolean;
+    workItem: WorkAssignmentCommandInput["workItem"];
+    assignment: WorkAssignmentCommandInput["assignment"];
+    executable: string;
+};
+export type WorkProviderAdapter = {
+    id: string;
+    defaultExecutable: (input: WorkProviderExecutableInput) => string;
+    buildItemCommand: (input: WorkProviderItemCommandInput) => WorkProviderCommand;
+    buildAssignmentCommand: (input: WorkProviderAssignmentCommandInput) => WorkProviderCommand;
+};
+export declare const workProviderAdapters: Record<string, WorkProviderAdapter>;
+export declare function buildProviderCommandPlan(input: {
+    provider: string;
+    providerConfig: WorkProviderConfig;
+    providerConfigured: boolean;
+    items: WorkSyncPlanItem[];
+    events: WorkEvent[];
+}): WorkProviderCommandPlan;
+export declare function buildAssignmentProviderCommandPlan(input: {
+    provider: string;
+    providerConfig: WorkProviderConfig;
+    providerConfigured: boolean;
+    workItem: WorkAssignmentCommandInput["workItem"];
+    assignment: WorkAssignmentCommandInput["assignment"];
+}): WorkProviderCommandPlan;
+export declare function assignmentProviderRef(assignment: Record<string, unknown>, provider: string): string | null;
+export declare function commandDisplayWithMetadata(command: WorkProviderCommand): string;