@blxzer/pactile 0.5.0 → 0.6.0-beta.2

package/dist/core/task/p36-artifact-migrate.js

@@ -0,0 +1,293 @@
+/**
+ * P36 wave B — artifact dual-read + optional write (not wave C).
+ *
+ * User default: keep reading old task.json / evidence. Maintainer may write
+ * required_controls + Topology projections. Never delete
+ * business prose. Archive is read-only. Failure rolls back to dual-read.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { resolveRequiredControls } from "./full-quality.js";
+import { projectLegacyStatus } from "./kernel-contract.js";
+import { STAGE5_SCHEMA_VERSION, defaultDependencyGraph, defaultTopology, expandDependsOnToRequires, topologyKindFromChildren, } from "./ondemand-topology.js";
+import { loadTaskRecord, writeTaskRecord } from "./records.js";
+import { isPlainObject } from "./schema.js";
+export const P36_ARTIFACT_SOURCE = "p36-artifact-migrate";
+export function planArtifactMigration(options) {
+    const root = path.resolve(options.root);
+    const tasksRoot = options.tasksDir
+        ? path.resolve(options.tasksDir)
+        : path.join(root, ".pactile", "tasks");
+    const degraded = [];
+    const tasks = [];
+    const writable = [];
+    for (const file of collectFiles(tasksRoot)) {
+        const scanned = scanTaskArtifact(file, tasksRoot);
+        if (scanned.degraded) {
+            degraded.push(scanned.degraded);
+            continue;
+        }
+        if (!scanned.task)
+            continue;
+        tasks.push(scanned.task);
+        if (scanned.write)
+            writable.push(scanned.write);
+    }
+    const dualRead = tasks.filter((task) => task.dualRead).length;
+    const activeDualRead = tasks.filter((task) => task.dualRead && !task.archive && isActiveStatus(task.status)).length;
+    const archiveSkipped = tasks.filter((task) => task.archive).length;
+    return {
+        scanned: tasks.length,
+        dualRead,
+        activeDualRead,
+        archiveSkipped,
+        writable,
+        tasks,
+        degraded,
+        continueOk: tasks.length === 0 || tasks.every((task) => task.continueOk),
+    };
+}
+export function applyArtifactMigration(options) {
+    const snapshots = [];
+    let written = 0;
+    try {
+        for (const target of options.plan.writable) {
+            if (options.onBeforeWrite)
+                options.onBeforeWrite(target);
+            if (!fs.existsSync(target.path)) {
+                throw new Error(`missing ${target.path}`);
+            }
+            snapshots.push({
+                path: target.path,
+                content: fs.readFileSync(target.path, "utf-8"),
+            });
+            writeArtifactTarget(target);
+            written += 1;
+        }
+        return { ok: true, wrote: written > 0, written, rolledBack: false };
+    }
+    catch (err) {
+        restoreSnapshots(snapshots);
+        return {
+            ok: false,
+            wrote: false,
+            written: 0,
+            rolledBack: snapshots.length > 0,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+export function formatArtifactVernacular(plan, writeArtifacts) {
+    const lines = [
+        writeArtifacts
+            ? `产物：将写入 ${plan.writable.length} 个投影（required_controls / Topology；不删正文）。归档 ${plan.archiveSkipped} 个只读。`
+            : `产物：${plan.activeDualRead} 个进行中的任务仍按旧形状可读，这次不用改它们。归档 ${plan.archiveSkipped} 个只读。`,
+    ];
+    if (plan.degraded.length > 0) {
+        lines.push(`degraded：${plan.degraded.length}（仍可再跑 update）`);
+    }
+    else {
+        lines.push("degraded：无");
+    }
+    return lines;
+}
+function writeArtifactTarget(target) {
+    const record = loadTaskRecord({ taskDir: path.dirname(target.path) });
+    writeTaskRecord({
+        taskDir: path.dirname(target.path),
+        record,
+        extra: target.extra ?? {},
+    });
+}
+function restoreSnapshots(snapshots) {
+    for (const snapshot of [...snapshots].reverse()) {
+        if (snapshot.content === null) {
+            if (fs.existsSync(snapshot.path))
+                fs.unlinkSync(snapshot.path);
+            continue;
+        }
+        fs.writeFileSync(snapshot.path, snapshot.content, "utf-8");
+    }
+}
+function scanTaskArtifact(file, tasksRoot) {
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(file, "utf-8"));
+    }
+    catch {
+        return { degraded: `${file}: task.json is not readable JSON` };
+    }
+    if (!isPlainObject(parsed)) {
+        return { degraded: `${file}: task.json is not an object` };
+    }
+    const id = typeof parsed.id === "string" ? parsed.id : path.basename(path.dirname(file));
+    const status = typeof parsed.status === "string" ? parsed.status : "";
+    const archive = isArchivePath(tasksRoot, file);
+    const continueOk = status.trim() !== "";
+    if (continueOk) {
+        projectLegacyStatus(status);
+    }
+    const missing = [];
+    const extra = {};
+    if (!hasRequiredControls(parsed)) {
+        missing.push("required_controls");
+        extra.required_controls = resolveRequiredControls({
+            rigor: inferLegacyRigor(parsed),
+        });
+    }
+    const parent = typeof parsed.parent === "string" && parsed.parent.trim() !== ""
+        ? parsed.parent
+        : null;
+    const children = asStringArray(parsed.children);
+    if (!hasTopology(parsed)) {
+        missing.push("topology");
+        extra.topology = defaultTopology({
+            id,
+            parent,
+            children,
+        });
+    }
+    else {
+        const repaired = repairMisclassifiedTopology(parsed, { id, parent, children });
+        if (repaired) {
+            missing.push("topology");
+            extra.topology = repaired;
+        }
+    }
+    const dependsOn = asStringArray(parsed.depends_on);
+    if (!hasDependencyGraph(parsed) && dependsOn.length > 0) {
+        missing.push("dependency_graph");
+        extra.dependency_graph = expandDependsOnToRequires(defaultDependencyGraph(), id, dependsOn);
+    }
+    const dualRead = missing.length > 0;
+    const writable = dualRead && !archive && Object.keys(extra).length > 0;
+    return {
+        task: {
+            path: file,
+            id,
+            status,
+            archive,
+            continueOk,
+            dualRead,
+            writable,
+            missing,
+        },
+        write: writable
+            ? {
+                path: file,
+                extra,
+            }
+            : undefined,
+    };
+}
+function collectFiles(root) {
+    if (!fs.existsSync(root))
+        return [];
+    const out = [];
+    const stack = [root];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        if (current === undefined)
+            continue;
+        let entries;
+        try {
+            entries = fs.readdirSync(current, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const full = path.join(current, entry.name);
+            if (entry.isDirectory()) {
+                stack.push(full);
+            }
+            else if (entry.isFile() && entry.name === "task.json") {
+                out.push(full);
+            }
+        }
+    }
+    return out.sort();
+}
+function isArchivePath(root, file) {
+    const rel = path.relative(root, file).replace(/\\/g, "/");
+    return rel.split("/").includes("archive");
+}
+function hasRequiredControls(parsed) {
+    const raw = parsed.required_controls;
+    return (isPlainObject(raw) && (raw.rigor === "lite" || raw.rigor === "full"));
+}
+function hasTopology(parsed) {
+    const raw = parsed.topology;
+    return isPlainObject(raw) && (raw.kind === "single" || raw.kind === "parent-child");
+}
+function repairMisclassifiedTopology(parsed, record) {
+    const raw = parsed.topology;
+    if (!isPlainObject(raw))
+        return null;
+    const parentId = raw.parent_id === null || raw.parent_id === undefined
+        ? record.parent
+        : typeof raw.parent_id === "string" && raw.parent_id.trim() !== ""
+            ? raw.parent_id.trim()
+            : null;
+    const children = uniqueStrings([
+        ...asStringArray(raw.children),
+        ...record.children,
+    ]);
+    const expectedKind = topologyKindFromChildren(children);
+    if (raw.kind === expectedKind)
+        return null;
+    return {
+        schema_version: STAGE5_SCHEMA_VERSION,
+        kind: expectedKind,
+        parent_id: parentId,
+        children,
+    };
+}
+function uniqueStrings(values) {
+    const out = [];
+    for (const value of values) {
+        if (typeof value !== "string")
+            continue;
+        const id = value.trim();
+        if (!id || out.includes(id))
+            continue;
+        out.push(id);
+    }
+    return out;
+}
+function hasDependencyGraph(parsed) {
+    const raw = parsed.dependency_graph;
+    return isPlainObject(raw) && Array.isArray(raw.edges);
+}
+function inferLegacyRigor(parsed) {
+    const meta = isPlainObject(parsed.meta) ? parsed.meta : {};
+    const candidates = [
+        parsed.task_kind,
+        parsed.task_type,
+        parsed.kind,
+        parsed.mode,
+        meta.task_kind,
+        meta.task_type,
+        meta.classification,
+        meta.mode,
+    ];
+    for (const value of candidates) {
+        if (typeof value !== "string")
+            continue;
+        const normalized = value.toLowerCase().replace(/_/g, "-");
+        if (normalized.includes("full"))
+            return "full";
+        if (normalized.includes("lite"))
+            return "lite";
+    }
+    return "lite";
+}
+function isActiveStatus(status) {
+    return !["completed", "done", "cancelled", "canceled"].includes(status);
+}
+function asStringArray(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((item) => typeof item === "string");
+}
+//# sourceMappingURL=p36-artifact-migrate.js.map

package/dist/core/task/p36-artifact-migrate.js.map

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

package/dist/core/task/p36-wave-c.d.ts

@@ -0,0 +1,39 @@
+/**
+ * P36 Wave C: confirm-gated stop-read of leftover Task fields.
+ *
+ * Written only after `pactile update` confirm. Dry-run and refusal never write.
+ * Runtime closeout reads this flag; leftover kind/mode/classification stay
+ * dual-read until it exists.
+ */
+import { type ContractMigrateReport } from "./contract-migrate.js";
+export declare const WAVE_C_STATE_REL = ".pactile/.p36-wave-c.json";
+export declare const WAVE_C_SCHEMA_VERSION = 1;
+export interface WaveCState {
+    schema_version: number;
+    wave: "C";
+    confirmed: boolean;
+    confirmedAt: string | null;
+}
+export interface WaveCPlan {
+    confirmed: boolean;
+    scanned: number;
+    leftoverCloseout: number;
+    alreadyNewShape: number;
+    vernacular: string[];
+}
+export declare function waveCStatePath(root: string): string;
+export declare function emptyWaveCState(): WaveCState;
+export declare function readWaveCState(root: string): WaveCState;
+export declare function isWaveCConfirmed(root: string): boolean;
+export declare function writeWaveCConfirmed(root: string, at?: Date): WaveCState;
+export declare function planWaveC(options: {
+    root: string;
+    report?: ContractMigrateReport;
+}): WaveCPlan;
+export declare function formatWaveCVernacular(plan: {
+    confirmed: boolean;
+    scanned: number;
+    leftoverCloseout: number;
+    alreadyNewShape: number;
+}): string[];
+//# sourceMappingURL=p36-wave-c.d.ts.map

package/dist/core/task/p36-wave-c.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"p36-wave-c.d.ts","sourceRoot":"","sources":["../../../src/core/task/p36-wave-c.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAG/B,eAAO,MAAM,gBAAgB,8BAA8B,CAAC;AAC5D,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,MAAM,WAAW,UAAU;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,GAAG,CAAC;IACV,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,eAAe,IAAI,UAAU,CAO5C;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAmBvD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,EAAE,GAAE,IAAiB,GACpB,UAAU,CAWZ;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC,GAAG,SAAS,CA4BZ;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,MAAM,EAAE,CAWX"}

package/dist/core/task/p36-wave-c.js

@@ -0,0 +1,100 @@
+/**
+ * P36 Wave C: confirm-gated stop-read of leftover Task fields.
+ *
+ * Written only after `pactile update` confirm. Dry-run and refusal never write.
+ * Runtime closeout reads this flag; leftover kind/mode/classification stay
+ * dual-read until it exists.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { scanContractMigration, } from "./contract-migrate.js";
+import { isPlainObject } from "./schema.js";
+export const WAVE_C_STATE_REL = ".pactile/.p36-wave-c.json";
+export const WAVE_C_SCHEMA_VERSION = 1;
+export function waveCStatePath(root) {
+    return path.join(path.resolve(root), WAVE_C_STATE_REL);
+}
+export function emptyWaveCState() {
+    return {
+        schema_version: WAVE_C_SCHEMA_VERSION,
+        wave: "C",
+        confirmed: false,
+        confirmedAt: null,
+    };
+}
+export function readWaveCState(root) {
+    const file = waveCStatePath(root);
+    if (!fs.existsSync(file))
+        return emptyWaveCState();
+    try {
+        const parsed = JSON.parse(fs.readFileSync(file, "utf-8"));
+        if (!isPlainObject(parsed))
+            return emptyWaveCState();
+        return {
+            schema_version: parsed.schema_version === WAVE_C_SCHEMA_VERSION
+                ? WAVE_C_SCHEMA_VERSION
+                : WAVE_C_SCHEMA_VERSION,
+            wave: "C",
+            confirmed: parsed.confirmed === true,
+            confirmedAt: typeof parsed.confirmedAt === "string" ? parsed.confirmedAt : null,
+        };
+    }
+    catch {
+        return emptyWaveCState();
+    }
+}
+export function isWaveCConfirmed(root) {
+    return readWaveCState(root).confirmed;
+}
+export function writeWaveCConfirmed(root, at = new Date()) {
+    const state = {
+        schema_version: WAVE_C_SCHEMA_VERSION,
+        wave: "C",
+        confirmed: true,
+        confirmedAt: at.toISOString(),
+    };
+    const file = waveCStatePath(root);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, `${JSON.stringify(state, null, 2)}\n`, "utf-8");
+    return state;
+}
+export function planWaveC(options) {
+    const confirmed = isWaveCConfirmed(options.root);
+    const report = options.report ?? scanContractMigration({ root: options.root });
+    const leftoverPaths = new Set();
+    for (const finding of report.findings) {
+        if (finding.kind === "retired-field" ||
+            finding.kind === "children-inferred-parent" ||
+            finding.kind === "file-inferred-rigor" ||
+            finding.kind === "legacy-parent") {
+            leftoverPaths.add(finding.path);
+        }
+    }
+    const leftoverCloseout = leftoverPaths.size;
+    const alreadyNewShape = Math.max(0, report.scanned - leftoverCloseout);
+    return {
+        confirmed,
+        scanned: report.scanned,
+        leftoverCloseout,
+        alreadyNewShape,
+        vernacular: formatWaveCVernacular({
+            confirmed,
+            scanned: report.scanned,
+            leftoverCloseout,
+            alreadyNewShape,
+        }),
+    };
+}
+export function formatWaveCVernacular(plan) {
+    if (plan.confirmed) {
+        return [
+            "已确认停读旧形状。新任务只认 topology / required_controls，不再靠 leftover kind/mode/classification 推断 Rigor / Parent。",
+        ];
+    }
+    return [
+        "确认后才会停读旧形状：不再把 leftover kind/mode/classification 当 Rigor/Parent 唯一真相。",
+        `已扫描 ${plan.scanned} 个任务：${plan.alreadyNewShape} 个已是新形状，${plan.leftoverCloseout} 个仍靠旧字段。`,
+        "拒绝或失败：项目仍能 Continue / Close，可再跑 update。",
+    ];
+}
+//# sourceMappingURL=p36-wave-c.js.map

package/dist/core/task/p36-wave-c.js.map

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

package/dist/core/task/paths.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Task directory naming.
+ *
+ * User-created task dirs follow the `MM-DD-slug` pattern produced by
+ * `.pactile/scripts/common/task_store.py::cmd_create`:
+ *
+ *     <tasks-dir>/05-13-pactile-core-sdk-package/
+ *
+ * Pactile also creates system onboarding tasks during `pactile init` using a
+ * `00-slug` prefix, such as `00-bootstrap-guidelines` and `00-join-new-developer`.
+ *
+ * `MM` is the two-digit month, `DD` is the two-digit day, and `slug` is
+ * a lower-kebab-case identifier composed of `[a-z0-9-]+` characters.
+ */
+export interface TaskDirParts {
+    /**
+     * The directory prefix. Dated tasks use `MM-DD`; Pactile system onboarding
+     * tasks use `00`.
+     */
+    prefix: string;
+    /** Two-digit month for dated tasks, or `null` for `00-*` system tasks. */
+    month: string | null;
+    /** Two-digit day for dated tasks, or `null` for `00-*` system tasks. */
+    day: string | null;
+    slug: string;
+}
+/**
+ * Validate a task directory base name (no slashes). Returns the parsed
+ * components when valid, or `null` when the name does not match a canonical
+ * task dir shape.
+ *
+ * Throws `TypeError` if `name` is not a string — guards downstream code
+ * from accidentally validating `Buffer`, `Path`, or other inputs.
+ */
+export declare function validateTaskDirName(name: string): TaskDirParts | null;
+export declare function isValidTaskDirName(name: string): boolean;
+//# sourceMappingURL=paths.d.ts.map

package/dist/core/task/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/core/task/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,wEAAwE;IACxE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAqBrE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/dist/core/task/paths.js

@@ -0,0 +1,49 @@
+/**
+ * Task directory naming.
+ *
+ * User-created task dirs follow the `MM-DD-slug` pattern produced by
+ * `.pactile/scripts/common/task_store.py::cmd_create`:
+ *
+ *     <tasks-dir>/05-13-pactile-core-sdk-package/
+ *
+ * Pactile also creates system onboarding tasks during `pactile init` using a
+ * `00-slug` prefix, such as `00-bootstrap-guidelines` and `00-join-new-developer`.
+ *
+ * `MM` is the two-digit month, `DD` is the two-digit day, and `slug` is
+ * a lower-kebab-case identifier composed of `[a-z0-9-]+` characters.
+ */
+const DATED_TASK_DIR_RE = /^(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])-([a-z0-9]+(?:-[a-z0-9]+)*)$/;
+const SYSTEM_TASK_DIR_RE = /^00-(bootstrap-guidelines|join-[a-z0-9]+(?:-[a-z0-9]+)*)$/;
+/**
+ * Validate a task directory base name (no slashes). Returns the parsed
+ * components when valid, or `null` when the name does not match a canonical
+ * task dir shape.
+ *
+ * Throws `TypeError` if `name` is not a string — guards downstream code
+ * from accidentally validating `Buffer`, `Path`, or other inputs.
+ */
+export function validateTaskDirName(name) {
+    if (typeof name !== "string") {
+        throw new TypeError("task directory name must be a string");
+    }
+    const dated = DATED_TASK_DIR_RE.exec(name);
+    if (dated) {
+        const [, month, day, slug] = dated;
+        if (month === undefined || day === undefined || slug === undefined) {
+            return null;
+        }
+        return { prefix: `${month}-${day}`, month, day, slug };
+    }
+    const system = SYSTEM_TASK_DIR_RE.exec(name);
+    if (system) {
+        const [, slug] = system;
+        if (slug === undefined)
+            return null;
+        return { prefix: "00", month: null, day: null, slug };
+    }
+    return null;
+}
+export function isValidTaskDirName(name) {
+    return validateTaskDirName(name) !== null;
+}
+//# sourceMappingURL=paths.js.map

package/dist/core/task/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/core/task/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,iBAAiB,GACrB,oEAAoE,CAAC;AACvE,MAAM,kBAAkB,GACtB,2DAA2D,CAAC;AAe9D;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,SAAS,CAAC,sCAAsC,CAAC,CAAC;IAC9D,CAAC;IACD,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;QACnC,IAAI,KAAK,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACnE,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,IAAI,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IACzD,CAAC;IAED,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,EAAE,IAAI,CAAC,GAAG,MAAM,CAAC;QACxB,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACpC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACxD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,mBAAmB,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;AAC5C,CAAC"}

package/dist/core/task/phase.d.ts

@@ -0,0 +1,27 @@
+import type { PactileTaskRecord } from "./schema.js";
+/**
+ * Coarse-grained Pactile task phase derived from task status.
+ *
+ * This mapping is a **legacy machine alias** of {@link PactileTaskRecord.status}
+ * (`plan` / `implement` / …). Humans and agents should use Kernel Phase
+ * titles from `projectKernelSurface` (Open / Define / Approve / Execute /
+ * Verify / Integrate? / Close) — not these names, and not `planning`.
+ *
+ * Mapping:
+ *
+ *   status              | phase
+ *   --------------------|-----------
+ *   planning            | plan
+ *   in_progress         | implement
+ *   review              | review
+ *   completed | done    | completed
+ *   <anything else>     | unknown
+ */
+export type PactileTaskPhase = "plan" | "implement" | "review" | "completed" | "unknown";
+/**
+ * Infer the phase of a task from either its parsed record or its raw
+ * status string. Accepts a record so callers that already have one don't
+ * need to re-pluck `status` first.
+ */
+export declare function inferTaskPhase(recordOrStatus: PactileTaskRecord | string | null | undefined): PactileTaskPhase;
+//# sourceMappingURL=phase.d.ts.map

package/dist/core/task/phase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase.d.ts","sourceRoot":"","sources":["../../../src/core/task/phase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,WAAW,GACX,QAAQ,GACR,WAAW,GACX,SAAS,CAAC;AAEd;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,cAAc,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAC5D,gBAAgB,CAkBlB"}

package/dist/core/task/phase.js

@@ -0,0 +1,24 @@
+/**
+ * Infer the phase of a task from either its parsed record or its raw
+ * status string. Accepts a record so callers that already have one don't
+ * need to re-pluck `status` first.
+ */
+export function inferTaskPhase(recordOrStatus) {
+    const status = typeof recordOrStatus === "string"
+        ? recordOrStatus
+        : recordOrStatus?.status;
+    switch (status) {
+        case "planning":
+            return "plan";
+        case "in_progress":
+            return "implement";
+        case "review":
+            return "review";
+        case "completed":
+        case "done":
+            return "completed";
+        default:
+            return "unknown";
+    }
+}
+//# sourceMappingURL=phase.js.map

package/dist/core/task/phase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase.js","sourceRoot":"","sources":["../../../src/core/task/phase.ts"],"names":[],"mappings":"AA2BA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,cAA6D;IAE7D,MAAM,MAAM,GACV,OAAO,cAAc,KAAK,QAAQ;QAChC,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC;IAC7B,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,UAAU;YACb,OAAO,MAAM,CAAC;QAChB,KAAK,aAAa;YAChB,OAAO,WAAW,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,WAAW,CAAC;QACjB,KAAK,MAAM;YACT,OAAO,WAAW,CAAC;QACrB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/core/task/records.d.ts

@@ -0,0 +1,48 @@
+import { emptyTaskRecord, type PactileTaskRecord } from "./schema.js";
+export interface LoadTaskRecordOptions {
+    /** Absolute or repo-relative directory containing `task.json`. */
+    taskDir: string;
+    /** Optional repo root used to resolve relative `taskDir` values. */
+    cwd?: string;
+}
+export interface WriteTaskRecordOptions {
+    /** Absolute or repo-relative directory containing `task.json`. */
+    taskDir: string;
+    /** Canonical record to persist. Unknown fields on disk are preserved. */
+    record: PactileTaskRecord;
+    /** Optional repo root used to resolve relative `taskDir` values. */
+    cwd?: string;
+    /**
+     * Non-canonical projection fields owned by a Kernel Command
+     * (`execution_approval`, `quality_gate_results`, …). Canonical keys are ignored.
+     */
+    extra?: Record<string, unknown>;
+}
+/**
+ * Read a task.json file and return a canonicalized record.
+ *
+ * Unknown fields on disk that are not part of the canonical 24-field
+ * shape are NOT returned — `loadTaskRecord` is the structured public API.
+ * To preserve unknown fields across a load/write cycle, callers should
+ * use {@link writeTaskRecord}, which merges canonical updates on top of
+ * the on-disk JSON object instead of overwriting it.
+ */
+export declare function loadTaskRecord(options: LoadTaskRecordOptions): PactileTaskRecord;
+/**
+ * Write a task.json file with canonical field ordering. Unknown fields
+ * already present on disk are preserved verbatim — only the canonical
+ * fields are overwritten by `record`. Field order: canonical fields
+ * first (in `TASK_RECORD_FIELD_ORDER`), then any preserved unknown
+ * fields in their original insertion order. If an existing `task.json` is
+ * present but cannot be parsed as a JSON object, the write is rejected instead
+ * of silently replacing potentially recoverable local data.
+ *
+ * The directory containing `task.json` is created if it does not exist.
+ *
+ * Stage 2 (P28/P30): Kernel Commands may call this for same-command
+ * legacy projection. Do not add another `writeFileSync`
+ * primitive for `task.json`.
+ */
+export declare function writeTaskRecord(options: WriteTaskRecordOptions): void;
+export { emptyTaskRecord };
+//# sourceMappingURL=records.d.ts.map