@blxzer/pactile 0.5.0 → 0.6.0-beta.4

package/dist/core/task/kernel-cli.js

@@ -0,0 +1,429 @@
+/**
+ * Stateless Kernel JSON CLI (stdin → stdout). Stage 2 write channel for
+ * Task core state: create / start / record-gate / archive / patch project
+ * the legacy task.json surface as the same command. `transition` stays the
+ * Stage 1 kernel.json-only hop (no status rewrite).
+ */
+import { scanContractMigration, } from "./contract-migrate.js";
+import { isPlainObject, taskRecordSchema } from "./schema.js";
+import { KernelError, isKernelPhase, isNonNegativeInt, } from "./kernel-contract.js";
+import { applyKernelArchive, applyKernelCreate, applyKernelPatch, applyKernelRecordGate, applyKernelStart, applyKernelTransition, readKernel, inspectTaskProjection, repairTaskProjection, } from "./kernel-store.js";
+import { addTaskDependency, checkTaskClose, closeTaskKernel, createTaskKernel, readTaskKernel, recordTaskReview, recordTaskRunResult, resumeTaskRun, startTaskRun, } from "./task-kernel.js";
+export function handleKernelRequest(input, options = {}) {
+    try {
+        return dispatchKernelRequest(input, options.cwd);
+    }
+    catch (err) {
+        return toFailure(err);
+    }
+}
+export async function runKernelJsonCli(io = {}) {
+    const stdin = io.stdin ?? process.stdin;
+    const stdout = io.stdout ?? process.stdout;
+    const raw = (await readAll(stdin)).trim();
+    let parsed;
+    try {
+        parsed = raw === "" ? {} : JSON.parse(raw);
+    }
+    catch (err) {
+        const response = {
+            ok: false,
+            error: {
+                code: "INVALID_REQUEST",
+                message: `stdin is not JSON: ${err instanceof Error ? err.message : String(err)}`,
+            },
+        };
+        stdout.write(`${JSON.stringify(response)}\n`);
+        return 1;
+    }
+    const response = handleKernelRequest(parsed, { cwd: io.cwd });
+    stdout.write(`${JSON.stringify(response)}\n`);
+    return response.ok ? 0 : 1;
+}
+function dispatchKernelRequest(input, cwd) {
+    if (!isPlainObject(input)) {
+        throw new KernelError("INVALID_REQUEST", "request must be a JSON object");
+    }
+    const op = input.op;
+    if (op === "inspect-projection") {
+        return { ok: true, op, ...inspectTaskProjection({ taskDir: requireTaskDir(input.taskDir), cwd: optionalCwd(input.cwd, cwd) }) };
+    }
+    if (op === "repair-projection") {
+        if (!isNonNegativeInt(input.expectedCanonicalRevision) ||
+            (input.expectedCurrentFingerprint !== null && typeof input.expectedCurrentFingerprint !== "string")) {
+            throw new KernelError("INVALID_REQUEST", "repair requires expectedCanonicalRevision and expectedCurrentFingerprint");
+        }
+        return { ok: true, op, ...repairTaskProjection({
+                taskDir: requireTaskDir(input.taskDir), cwd: optionalCwd(input.cwd, cwd),
+                expectedCanonicalRevision: input.expectedCanonicalRevision,
+                expectedCurrentFingerprint: input.expectedCurrentFingerprint,
+            }) };
+    }
+    if (op === "read") {
+        const taskDir = requireTaskDir(input.taskDir);
+        const result = readKernel({
+            taskDir,
+            cwd: optionalCwd(input.cwd, cwd),
+        });
+        return { ok: true, op: "read", ...result };
+    }
+    if (op === "transition") {
+        const request = parseTransitionRequest(input, cwd);
+        const result = applyKernelTransition(request);
+        return { ok: true, op: "transition", ...result };
+    }
+    if (op === "create") {
+        const result = applyKernelCreate(parseCreateRequest(input, cwd));
+        return { ok: true, op: "create", ...result };
+    }
+    if (op === "start") {
+        const result = applyKernelStart(parseStartRequest(input, cwd));
+        return { ok: true, op: "start", ...result };
+    }
+    if (op === "record-gate") {
+        const result = applyKernelRecordGate(parseRecordGateRequest(input, cwd));
+        return { ok: true, op: "record-gate", ...result };
+    }
+    if (op === "archive") {
+        const result = applyKernelArchive(parseArchiveRequest(input, cwd));
+        return { ok: true, op: "archive", ...result };
+    }
+    if (op === "patch") {
+        const result = applyKernelPatch(parsePatchRequest(input, cwd));
+        return { ok: true, op: "patch", ...result };
+    }
+    if (op === "migrate") {
+        return { ok: true, op: "migrate", ...parseMigrateDryRun(input, cwd) };
+    }
+    const taskCwd = optionalCwd(input.cwd, cwd);
+    const taskRoot = requestRoot(input.root, taskCwd);
+    if (op === "task-read") {
+        const taskDir = requireTaskDir(input.taskDir);
+        return { ok: true, op, result: readTaskKernel({ root: taskRoot, taskDir, cwd: taskCwd }) };
+    }
+    if (op === "task-create") {
+        if (!isPlainObject(input.definition))
+            throw new KernelError("INVALID_REQUEST", "definition must be a JSON object");
+        const request = {
+            root: taskRoot, taskDir: requireTaskDir(input.taskDir),
+            definition: input.definition,
+            actor: requireString(input.actor, "actor"), idempotencyKey: requireString(input.idempotencyKey, "idempotencyKey"),
+            cwd: taskCwd,
+        };
+        return { ok: true, op, result: createTaskKernel(request) };
+    }
+    if (op === "dependency-add") {
+        return { ok: true, op, result: addTaskDependency({
+                root: taskRoot, taskDir: requireTaskDir(input.taskDir), expectedRevision: requireRevision(input.expectedRevision),
+                dependencyId: requireString(input.dependencyId, "dependencyId"), actor: requireString(input.actor, "actor"),
+                idempotencyKey: requireString(input.idempotencyKey, "idempotencyKey"), cwd: taskCwd,
+            }) };
+    }
+    if (op === "run-start") {
+        if (!isPlainObject(input.input) || !isPlainObject(input.authorization))
+            throw new KernelError("INVALID_REQUEST", "run-start requires input and authorization objects");
+        if (input.workspace !== undefined && input.workspace !== null && !isPlainObject(input.workspace))
+            throw new KernelError("INVALID_REQUEST", "workspace must be a JSON object");
+        if (input.host !== undefined && input.host !== null && !isPlainObject(input.host))
+            throw new KernelError("INVALID_REQUEST", "host must be a JSON object");
+        const request = {
+            root: taskRoot, taskDir: requireTaskDir(input.taskDir), expectedRevision: requireRevision(input.expectedRevision),
+            actor: requireString(input.actor, "actor"), idempotencyKey: requireString(input.idempotencyKey, "idempotencyKey"),
+            input: input.input, authorization: input.authorization,
+            ...(input.initialState === undefined ? {} : { initialState: requireString(input.initialState, "initialState") }),
+            ...(input.writeSetSnapshot === undefined ? {} : { writeSetSnapshot: parseStringArray(input.writeSetSnapshot, "writeSetSnapshot", true) }),
+            ...(input.estimatedDurations === undefined ? {} : { estimatedDurations: input.estimatedDurations }),
+            ...(input.workspace ? { workspace: input.workspace } : {}),
+            ...(input.host ? { host: input.host } : {}),
+            cwd: taskCwd,
+        };
+        return { ok: true, op, result: startTaskRun(request) };
+    }
+    if (op === "run-resume") {
+        return { ok: true, op, result: resumeTaskRun({
+                root: taskRoot, taskDir: requireTaskDir(input.taskDir), expectedRevision: requireRevision(input.expectedRevision), runId: requireString(input.runId, "runId"),
+                actor: requireString(input.actor, "actor"), idempotencyKey: requireString(input.idempotencyKey, "idempotencyKey"), cwd: taskCwd,
+            }) };
+    }
+    if (op === "run-result") {
+        if (input.failure !== undefined && input.failure !== null && !isPlainObject(input.failure))
+            throw new KernelError("INVALID_REQUEST", "failure must be a JSON object");
+        const request = {
+            root: taskRoot, taskDir: requireTaskDir(input.taskDir), expectedRevision: requireRevision(input.expectedRevision), runId: requireString(input.runId, "runId"),
+            outcome: requireString(input.outcome, "outcome"),
+            ...(input.summary === undefined ? {} : { summary: requireString(input.summary, "summary") }),
+            evidenceRefs: input.evidenceRefs === undefined ? [] : parseStringArray(input.evidenceRefs, "evidenceRefs"),
+            candidateEntries: input.candidateEntries === undefined ? [] : input.candidateEntries,
+            ...(input.measurementRefs === undefined ? {} : { measurementRefs: input.measurementRefs }),
+            ...(input.failure ? { failure: input.failure } : {}),
+            actor: requireString(input.actor, "actor"), idempotencyKey: requireString(input.idempotencyKey, "idempotencyKey"), cwd: taskCwd,
+        };
+        return { ok: true, op, result: recordTaskRunResult(request) };
+    }
+    if (op === "review-record") {
+        if (input.acceptanceEvidence !== undefined && input.acceptanceEvidence !== null && !isPlainObject(input.acceptanceEvidence))
+            throw new KernelError("INVALID_REQUEST", "acceptanceEvidence must be a JSON object");
+        if (input.unresolvedBlockers !== undefined)
+            parseStringArray(input.unresolvedBlockers, "unresolvedBlockers", true);
+        const request = {
+            root: taskRoot, taskDir: requireTaskDir(input.taskDir), expectedRevision: requireRevision(input.expectedRevision), runId: requireString(input.runId, "runId"),
+            candidateSnapshotId: requireString(input.candidateSnapshotId, "candidateSnapshotId"), candidateFingerprint: requireString(input.candidateFingerprint, "candidateFingerprint"), reviewer: requireString(input.reviewer, "reviewer"),
+            decision: requireString(input.decision, "decision"),
+            evidenceRefs: parseStringArray(input.evidenceRefs, "evidenceRefs"),
+            ...(input.acceptanceEvidence ? { acceptanceEvidence: input.acceptanceEvidence } : {}),
+            ...(input.unresolvedBlockers ? { unresolvedBlockers: parseStringArray(input.unresolvedBlockers, "unresolvedBlockers", true) } : {}),
+            ...(input.measurementRef === undefined ? {} : { measurementRef: requireString(input.measurementRef, "measurementRef") }),
+            actor: requireString(input.actor, "actor"), idempotencyKey: requireString(input.idempotencyKey, "idempotencyKey"), cwd: taskCwd,
+        };
+        return { ok: true, op, result: recordTaskReview(request) };
+    }
+    if (op === "task-close-check") {
+        if (!isPlainObject(input.deliveryEvidence))
+            throw new KernelError("INVALID_REQUEST", "deliveryEvidence must be a JSON object");
+        if (!isPlainObject(input.candidateObservation))
+            throw new KernelError("INVALID_REQUEST", "candidateObservation must be a JSON object");
+        const request = {
+            root: taskRoot, taskDir: requireTaskDir(input.taskDir), expectedRevision: requireRevision(input.expectedRevision),
+            runId: requireString(input.runId, "runId"), reviewId: requireString(input.reviewId, "reviewId"),
+            candidateObservation: input.candidateObservation,
+            deliveryEvidence: input.deliveryEvidence, cwd: taskCwd,
+        };
+        return { ok: true, op, errors: checkTaskClose(request) };
+    }
+    if (op === "task-close") {
+        if (!isPlainObject(input.deliveryEvidence))
+            throw new KernelError("INVALID_REQUEST", "deliveryEvidence must be a JSON object");
+        if (!isPlainObject(input.candidateObservation))
+            throw new KernelError("INVALID_REQUEST", "candidateObservation must be a JSON object");
+        const request = {
+            root: taskRoot, taskDir: requireTaskDir(input.taskDir), expectedRevision: requireRevision(input.expectedRevision),
+            runId: requireString(input.runId, "runId"), reviewId: requireString(input.reviewId, "reviewId"),
+            candidateObservation: input.candidateObservation,
+            deliveryEvidence: input.deliveryEvidence,
+            actor: requireString(input.actor, "actor"), idempotencyKey: requireString(input.idempotencyKey, "idempotencyKey"), cwd: taskCwd,
+        };
+        return { ok: true, op, result: closeTaskKernel(request) };
+    }
+    throw new KernelError("INVALID_REQUEST", `unsupported Kernel op: ${String(op)}`);
+}
+function parseTransitionRequest(input, cwd) {
+    if (!isKernelPhase(input.targetPhase)) {
+        throw new KernelError("INVALID_REQUEST", "targetPhase is not a Kernel phase");
+    }
+    if (!isNonNegativeInt(input.expectedRevision)) {
+        throw new KernelError("INVALID_REQUEST", "expectedRevision must be a non-negative integer");
+    }
+    const request = {
+        taskDir: requireTaskDir(input.taskDir),
+        expectedRevision: input.expectedRevision,
+        targetPhase: input.targetPhase,
+        actor: requireString(input.actor, "actor"),
+        idempotencyKey: requireString(input.idempotencyKey, "idempotencyKey"),
+        cwd: optionalCwd(input.cwd, cwd),
+    };
+    if (input.evidence !== undefined) {
+        request.evidence = requireString(input.evidence, "evidence");
+    }
+    if (input.gate !== undefined) {
+        request.gate = input.gate;
+    }
+    if (input.policy !== undefined) {
+        request.policy = input.policy;
+    }
+    return request;
+}
+function parseCreateRequest(input, cwd) {
+    return {
+        taskDir: requireTaskDir(input.taskDir),
+        actor: requireString(input.actor, "actor"),
+        idempotencyKey: requireString(input.idempotencyKey, "idempotencyKey"),
+        record: parseRecord(input.record),
+        extras: parseExtras(input.extras),
+        evidence: input.evidence === undefined
+            ? undefined
+            : requireString(input.evidence, "evidence"),
+        gate: input.gate,
+        policy: input.policy,
+        cwd: optionalCwd(input.cwd, cwd),
+    };
+}
+function parseStartRequest(input, cwd) {
+    if (!isNonNegativeInt(input.expectedRevision)) {
+        throw new KernelError("INVALID_REQUEST", "expectedRevision must be a non-negative integer");
+    }
+    return {
+        taskDir: requireTaskDir(input.taskDir),
+        expectedRevision: input.expectedRevision,
+        actor: requireString(input.actor, "actor"),
+        idempotencyKey: requireString(input.idempotencyKey, "idempotencyKey"),
+        record: parseRecord(input.record),
+        extras: parseExtras(input.extras),
+        evidence: input.evidence === undefined
+            ? undefined
+            : requireString(input.evidence, "evidence"),
+        gate: input.gate,
+        policy: input.policy,
+        cwd: optionalCwd(input.cwd, cwd),
+    };
+}
+function parseRecordGateRequest(input, cwd) {
+    if (!isNonNegativeInt(input.expectedRevision)) {
+        throw new KernelError("INVALID_REQUEST", "expectedRevision must be a non-negative integer");
+    }
+    if (!isPlainObject(input.record)) {
+        throw new KernelError("INVALID_REQUEST", "record must be a JSON object");
+    }
+    return {
+        taskDir: requireTaskDir(input.taskDir),
+        expectedRevision: input.expectedRevision,
+        actor: requireString(input.actor, "actor"),
+        idempotencyKey: requireString(input.idempotencyKey, "idempotencyKey"),
+        transition: requireString(input.transition, "transition"),
+        gateName: requireString(input.gate, "gate"),
+        record: input.record,
+        extras: parseExtras(input.extras),
+        evidence: input.evidence === undefined
+            ? undefined
+            : requireString(input.evidence, "evidence"),
+        cwd: optionalCwd(input.cwd, cwd),
+    };
+}
+function parseArchiveRequest(input, cwd) {
+    if (!isNonNegativeInt(input.expectedRevision)) {
+        throw new KernelError("INVALID_REQUEST", "expectedRevision must be a non-negative integer");
+    }
+    return {
+        taskDir: requireTaskDir(input.taskDir),
+        expectedRevision: input.expectedRevision,
+        actor: requireString(input.actor, "actor"),
+        idempotencyKey: requireString(input.idempotencyKey, "idempotencyKey"),
+        record: parseRecord(input.record),
+        extras: parseExtras(input.extras),
+        evidence: input.evidence === undefined
+            ? undefined
+            : requireString(input.evidence, "evidence"),
+        gate: input.gate,
+        policy: input.policy,
+        cwd: optionalCwd(input.cwd, cwd),
+    };
+}
+function parsePatchRequest(input, cwd) {
+    if (!isNonNegativeInt(input.expectedRevision)) {
+        throw new KernelError("INVALID_REQUEST", "expectedRevision must be a non-negative integer");
+    }
+    if (input.record !== undefined && input.record !== null && !isPlainObject(input.record)) {
+        throw new KernelError("INVALID_REQUEST", "record must be a JSON object");
+    }
+    return {
+        taskDir: requireTaskDir(input.taskDir),
+        expectedRevision: input.expectedRevision,
+        actor: requireString(input.actor, "actor"),
+        idempotencyKey: requireString(input.idempotencyKey, "idempotencyKey"),
+        record: input.record,
+        extras: parseExtras(input.extras),
+        evidence: input.evidence === undefined
+            ? undefined
+            : requireString(input.evidence, "evidence"),
+        gate: input.gate,
+        policy: input.policy,
+        cwd: optionalCwd(input.cwd, cwd),
+    };
+}
+function parseRecord(value) {
+    try {
+        return taskRecordSchema.parse(value);
+    }
+    catch (err) {
+        throw new KernelError("INVALID_REQUEST", `record is not a canonical task.json shape: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+function parseMigrateDryRun(input, cwd) {
+    if (input.dryRun !== true) {
+        throw new KernelError("INVALID_REQUEST", "migrate is read-only and requires dryRun: true");
+    }
+    const root = typeof input.cwd === "string" && input.cwd.trim() !== ""
+        ? input.cwd
+        : cwd ?? process.cwd();
+    const tasksDir = input.tasksDir === undefined || input.tasksDir === null
+        ? undefined
+        : requireString(input.tasksDir, "tasksDir");
+    return scanContractMigration({ root, tasksDir });
+}
+function parseExtras(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (!isPlainObject(value)) {
+        throw new KernelError("INVALID_REQUEST", "extras must be a JSON object");
+    }
+    return value;
+}
+function requireTaskDir(value) {
+    return requireString(value, "taskDir");
+}
+function requireString(value, field) {
+    if (typeof value !== "string" || value.trim() === "") {
+        throw new KernelError("INVALID_REQUEST", `${field} must be a non-empty string`);
+    }
+    return value;
+}
+function requireRevision(value) {
+    if (!isNonNegativeInt(value))
+        throw new KernelError("INVALID_REQUEST", "expectedRevision must be a non-negative integer");
+    return value;
+}
+function requestRoot(value, cwd) {
+    if (value === undefined || value === null)
+        return cwd ?? process.cwd();
+    return requireString(value, "root");
+}
+function parseStringArray(value, field, allowEmpty = true) {
+    if (!Array.isArray(value) || value.some((item) => typeof item !== "string" || !item.trim())) {
+        throw new KernelError("INVALID_REQUEST", `${field} must be an array of non-empty strings`);
+    }
+    if (!allowEmpty && value.length === 0)
+        throw new KernelError("INVALID_REQUEST", `${field} must contain at least one reference`);
+    return [...value];
+}
+function optionalCwd(fromRequest, fallback) {
+    if (fromRequest === undefined || fromRequest === null)
+        return fallback;
+    if (typeof fromRequest !== "string" || fromRequest.trim() === "") {
+        throw new KernelError("INVALID_REQUEST", "cwd must be a non-empty string");
+    }
+    return fromRequest;
+}
+function toFailure(err) {
+    if (err instanceof KernelError) {
+        const failure = {
+            ok: false,
+            error: { code: err.code, message: err.message },
+        };
+        if (err.code === "HALF_CONVERSION") {
+            failure.halfConversion = {
+                kernelPersisted: true,
+                projectionPersisted: false,
+            };
+        }
+        return failure;
+    }
+    return {
+        ok: false,
+        error: {
+            code: "INVALID_REQUEST",
+            message: err instanceof Error ? err.message : String(err),
+        },
+    };
+}
+function readAll(stream) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        stream.on("data", (chunk) => {
+            chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
+        });
+        stream.on("end", () => {
+            resolve(Buffer.concat(chunks).toString("utf-8"));
+        });
+        stream.on("error", reject);
+    });
+}
+//# sourceMappingURL=kernel-cli.js.map

package/dist/core/task/kernel-cli.js.map

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

package/dist/core/task/kernel-contract.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Stage 1 Kernel Data Contract (P28 D05 / P30 Stage 1).
+ *
+ * Frozen here: record categories (identity, revision, 3D state, Transition
+ * Request, atomic audit) and legal phase edges. Disk field names are an
+ * implementation choice for this wave; user-visible `task.json.status`
+ * enumerations are not switched.
+ */
+import { type PactileTaskRecord } from "./schema.js";
+import { type PolicyCeilingV1, type ResolvedProviderV1 } from "../pactile/provider.js";
+import { type TileEvidenceKindV1 } from "../pactile/tile.js";
+/** Compatibility policy is supplied at the surface, never a registry in the store. */
+export type KernelExtrasBoundary = (extras: Record<string, unknown>, record: {
+    id?: string;
+    parent?: string | null;
+    children?: string[];
+}, phase: "create" | "start" | "archive" | "patch") => void;
+/** New host-neutral callers explicitly opt out of legacy projection defaults. */
+export declare const neutralKernelExtrasBoundary: KernelExtrasBoundary;
+export interface ProviderResolutionFact {
+    readonly tileId: string;
+    readonly authorized: boolean;
+    readonly resolution: ResolvedProviderV1;
+}
+export interface EvidenceFact {
+    readonly ref: string;
+    readonly exists: boolean;
+    readonly kind: TileEvidenceKindV1;
+    readonly fingerprint: string;
+}
+export interface EvidenceFactPort {
+    /** Lookup a logical handle only; no source body or credential arguments. */
+    lookup(ref: string): EvidenceFact | null;
+}
+export interface CompositionValidationInput {
+    /** Already compiled, model-selected order. This port never loads or sorts Tiles. */
+    /** fingerprint is the M0 manifest decoder fingerprint, NOT a compiler/SKILL bundle fingerprint. */
+    readonly tiles: readonly {
+        readonly manifest: unknown;
+        readonly fingerprint: string;
+    }[];
+    readonly policyCeiling: PolicyCeilingV1;
+    readonly providers: readonly ProviderResolutionFact[];
+    readonly evidenceRefs?: readonly string[];
+    readonly requireEvidence?: boolean;
+    readonly attempts?: Readonly<Record<string, number>>;
+}
+export type CompositionReasonCode = "invalid-composition" | "invalid-tile" | "fingerprint-mismatch" | "duplicate-tile" | "dependency-missing" | "dependency-order" | "tile-conflict" | "policy-exceeded" | "attempt-limit" | "provider-missing" | "provider-invalid" | "provider-unavailable" | "provider-unauthorized" | "provider-assurance" | "provider-policy" | "evidence-invalid" | "evidence-missing";
+export interface CompositionValidationOutcome {
+    readonly outcome: "accepted" | "rejected";
+    readonly reasonCodes: readonly CompositionReasonCode[];
+    readonly selectedTileIds: readonly string[];
+    readonly fingerprint: string;
+}
+export interface CompositionValidationPort {
+    validate(input: CompositionValidationInput, evidence?: EvidenceFactPort): CompositionValidationOutcome;
+}
+/** Pure contract validation: no catalog, provider selection/probe, host or filesystem. */
+export declare function validateComposition(input: CompositionValidationInput, evidence?: EvidenceFactPort): CompositionValidationOutcome;
+export declare const compositionValidationPort: CompositionValidationPort;
+export declare const KERNEL_SCHEMA_VERSION: 1;
+export declare const KERNEL_JSON_BASENAME = "kernel.json";
+export declare const KERNEL_PHASES: readonly ["open", "define", "approve", "execute", "verify", "integrate", "close"];
+export type KernelPhase = (typeof KERNEL_PHASES)[number];
+export declare const KERNEL_CONDITIONS: readonly ["ready", "active", "waiting", "blocked"];
+export type KernelCondition = (typeof KERNEL_CONDITIONS)[number];
+export declare const KERNEL_OUTCOMES: readonly ["completed", "cancelled", "failed"];
+export type KernelOutcome = (typeof KERNEL_OUTCOMES)[number];
+export type KernelErrorCode = "INVALID_REQUEST" | "NOT_FOUND" | "REVISION_CONFLICT" | "INVALID_TRANSITION" | "GATE_HOOK_UNIMPLEMENTED" | "POLICY_HOOK_UNIMPLEMENTED" | "IDEMPOTENCY_MISMATCH" | "CORRUPT_STATE" | "LOCK_TIMEOUT" | "HALF_CONVERSION" | "DEPENDENCY_UNSATISFIED" | "TASK_GATE_UNSATISFIED" | "ACCEPTANCE_EVIDENCE_MISSING" | "CANDIDATE_MISMATCH" | "REVIEW_NOT_INDEPENDENT" | "INVALID_DELIVERY_EVIDENCE" | "LEGACY_TASK_REQUIRES_DEFINITION" | "LEGACY_TASK_REQUIRES_COORDINATION";
+export declare class KernelError extends Error {
+    readonly code: KernelErrorCode;
+    constructor(code: KernelErrorCode, message: string);
+}
+export interface KernelState {
+    phase: KernelPhase;
+    condition: KernelCondition;
+    outcome: KernelOutcome | null;
+}
+export interface KernelIdentity {
+    taskId: string;
+}
+export interface KernelAuditEvent {
+    id: string;
+    at: string;
+    actor: string;
+    idempotencyKey: string;
+    evidence: string | null;
+    from: KernelState & {
+        revision: number;
+    };
+    to: KernelState & {
+        revision: number;
+    };
+}
+export interface KernelGates {
+    schemaVersion: 1;
+    transitions: Record<string, Record<string, unknown>>;
+}
+export interface KernelLegacyProjection {
+    status: string;
+    record: PactileTaskRecord;
+    extras: Record<string, unknown>;
+}
+export interface KernelSnapshot {
+    schemaVersion: typeof KERNEL_SCHEMA_VERSION;
+    identity: KernelIdentity;
+    revision: number;
+    phase: KernelPhase;
+    condition: KernelCondition;
+    outcome: KernelOutcome | null;
+    audit: KernelAuditEvent[];
+    gates: KernelGates;
+    projection: KernelLegacyProjection | null;
+}
+export declare const KERNEL_COMMAND_OPS: readonly ["read", "transition", "create", "start", "record-gate", "archive", "patch", "migrate", "inspect-projection", "repair-projection", "task-read", "task-create", "dependency-add", "run-start", "run-resume", "run-result", "review-record", "task-close-check", "task-close"];
+export type KernelCommandOp = (typeof KERNEL_COMMAND_OPS)[number];
+export interface TransitionRequest {
+    taskDir: string;
+    expectedRevision: number;
+    targetPhase: KernelPhase;
+    actor: string;
+    idempotencyKey: string;
+    evidence?: string;
+    /** Stage 1 placeholder — if present, the transition is rejected (not fake-green). */
+    gate?: unknown;
+    /** Stage 1 placeholder — if present, the transition is rejected (not fake-green). */
+    policy?: unknown;
+    cwd?: string;
+}
+export interface LegacyTaskProjection {
+    status: string;
+    id: string;
+    name: string;
+    title: string;
+}
+/**
+ * Legal Kernel phase edges for Stage 1. Integrate is optional (P28);
+ * Close is reachable from Verify or Integrate. Condition/outcome are
+ * derived from the target phase — they are not independently requested.
+ */
+export declare const KERNEL_PHASE_EDGES: readonly (readonly [
+    KernelPhase,
+    KernelPhase
+])[];
+export declare function emptyKernelGates(): KernelGates;
+export declare function isKernelPhase(value: unknown): value is KernelPhase;
+export declare function isKernelCondition(value: unknown): value is KernelCondition;
+export declare function isKernelOutcome(value: unknown): value is KernelOutcome;
+export declare function isLegalPhaseEdge(from: KernelPhase, to: KernelPhase): boolean;
+export declare function deriveStateForPhase(phase: KernelPhase): KernelState;
+/**
+ * Read-only projection of the legacy `task.json.status` enum onto Kernel
+ * 3D state. Does not mutate user-visible status names.
+ */
+export declare function projectLegacyStatus(status: string): KernelState;
+/**
+ * User-visible `task.json.status` names stay on the Stage 1 enum.
+ * Approve maps to planning so start-execution is the only planning→in_progress cut.
+ */
+export declare function kernelPhaseToLegacyStatus(phase: KernelPhase): string;
+export declare function hopsToExecute(from: KernelPhase): KernelPhase[];
+export declare function hopsToClose(from: KernelPhase): KernelPhase[];
+export declare function parseKernelSnapshot(input: unknown): KernelSnapshot;
+export declare function isNonNegativeInt(value: unknown): value is number;
+export declare function requireNonEmptyString(value: unknown, field: string): string;
+export declare function hookIsPresent(value: unknown): boolean;
+//# sourceMappingURL=kernel-contract.d.ts.map

package/dist/core/task/kernel-contract.d.ts.map

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