trellis-hgl-core 0.6.0-beta.18

package/dist/task/index.d.ts

@@ -0,0 +1,9 @@
+export type { TrellisTaskRecord, TaskRecordField, } from "./schema.js";
+export { TASK_RECORD_FIELD_ORDER, emptyTaskRecord, taskRecordSchema, } from "./schema.js";
+export type { LoadTaskRecordOptions, WriteTaskRecordOptions, } from "./records.js";
+export { loadTaskRecord, writeTaskRecord, } from "./records.js";
+export type { TaskDirParts } from "./paths.js";
+export { validateTaskDirName, isValidTaskDirName } from "./paths.js";
+export type { TrellisTaskPhase } from "./phase.js";
+export { inferTaskPhase } from "./phase.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/task/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/task/index.ts"],"names":[],"mappings":"AAKA,YAAY,EACV,iBAAiB,EACjB,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/task/index.js

@@ -0,0 +1,9 @@
+// Public task API surface — canonical task record shape, factory,
+// schema, I/O helpers, directory validation, and phase inference.
+//
+// Task API is intentionally independent from the channel API.
+export { TASK_RECORD_FIELD_ORDER, emptyTaskRecord, taskRecordSchema, } from "./schema.js";
+export { loadTaskRecord, writeTaskRecord, } from "./records.js";
+export { validateTaskDirName, isValidTaskDirName } from "./paths.js";
+export { inferTaskPhase } from "./phase.js";
+//# sourceMappingURL=index.js.map

package/dist/task/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/task/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,kEAAkE;AAClE,EAAE;AACF,8DAA8D;AAO9D,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAOrB,OAAO,EACL,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGrE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/task/paths.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Task directory naming.
+ *
+ * User-created task dirs follow the `MM-DD-slug` pattern produced by
+ * `.trellis/scripts/common/task_store.py::cmd_create`:
+ *
+ *     <tasks-dir>/05-13-trellis-core-sdk-package/
+ *
+ * Trellis also creates system onboarding tasks during `trellis 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`; Trellis 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/task/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/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/task/paths.js

@@ -0,0 +1,49 @@
+/**
+ * Task directory naming.
+ *
+ * User-created task dirs follow the `MM-DD-slug` pattern produced by
+ * `.trellis/scripts/common/task_store.py::cmd_create`:
+ *
+ *     <tasks-dir>/05-13-trellis-core-sdk-package/
+ *
+ * Trellis also creates system onboarding tasks during `trellis 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/task/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/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/task/phase.d.ts

@@ -0,0 +1,27 @@
+import type { TrellisTaskRecord } from "./schema.js";
+/**
+ * Coarse-grained Trellis task phase derived from task status.
+ *
+ * Phase is a projection of {@link TrellisTaskRecord.status} only. There is
+ * no separate `current_phase` field stored on disk — `inferTaskPhase`
+ * exists so consumers can render the workflow phase without depending on
+ * `.trellis/workflow.md` parsing.
+ *
+ * Mapping:
+ *
+ *   status              | phase
+ *   --------------------|-----------
+ *   planning            | plan
+ *   in_progress         | implement
+ *   review              | review
+ *   completed | done    | completed
+ *   <anything else>     | unknown
+ */
+export type TrellisTaskPhase = "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: TrellisTaskRecord | string | null | undefined): TrellisTaskPhase;
+//# sourceMappingURL=phase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"phase.d.ts","sourceRoot":"","sources":["../../src/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/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/task/phase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase.js","sourceRoot":"","sources":["../../src/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/task/records.d.ts

@@ -0,0 +1,39 @@
+import { emptyTaskRecord, type TrellisTaskRecord } 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: TrellisTaskRecord;
+    /** Optional repo root used to resolve relative `taskDir` values. */
+    cwd?: string;
+}
+/**
+ * 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): TrellisTaskRecord;
+/**
+ * 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.
+ */
+export declare function writeTaskRecord(options: WriteTaskRecordOptions): void;
+export { emptyTaskRecord };
+//# sourceMappingURL=records.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../src/task/records.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,eAAe,EAGf,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,MAAM,EAAE,iBAAiB,CAAC;IAC1B,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,qBAAqB,GAC7B,iBAAiB,CAYnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAsBrE;AAoCD,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/task/records.js

@@ -0,0 +1,89 @@
+import fs from "node:fs";
+import path from "node:path";
+import { TASK_RECORD_FIELD_ORDER, emptyTaskRecord, isPlainObject, taskRecordSchema, } from "./schema.js";
+const TASK_JSON_BASENAME = "task.json";
+/**
+ * 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 function loadTaskRecord(options) {
+    const file = resolveTaskJsonPath(options.taskDir, options.cwd);
+    const raw = fs.readFileSync(file, "utf-8");
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`Failed to parse ${file}: ${err instanceof Error ? err.message : err}`);
+    }
+    return taskRecordSchema.parse(parsed);
+}
+/**
+ * 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.
+ */
+export function writeTaskRecord(options) {
+    const record = taskRecordSchema.parse(options.record);
+    const file = resolveTaskJsonPath(options.taskDir, options.cwd);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    const existing = readExistingObject(file);
+    const out = {};
+    const recordBag = record;
+    for (const field of TASK_RECORD_FIELD_ORDER) {
+        out[field] = recordBag[field];
+    }
+    if (existing) {
+        for (const key of Object.keys(existing)) {
+            if (!(key in out)) {
+                out[key] = existing[key];
+            }
+        }
+    }
+    const json = JSON.stringify(out, null, 2) + "\n";
+    fs.writeFileSync(file, json, "utf-8");
+}
+function readExistingObject(file) {
+    let raw;
+    try {
+        raw = fs.readFileSync(file, "utf-8");
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return null;
+        throw err;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`Refusing to overwrite corrupt ${file}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    if (!isPlainObject(parsed)) {
+        throw new Error(`Refusing to overwrite non-object task record at ${file}`);
+    }
+    return parsed;
+}
+function resolveTaskJsonPath(taskDir, cwd) {
+    if (path.isAbsolute(taskDir)) {
+        return path.join(taskDir, TASK_JSON_BASENAME);
+    }
+    const base = cwd ?? process.cwd();
+    return path.join(path.resolve(base, taskDir), TASK_JSON_BASENAME);
+}
+// Re-exported so callers can build a starter record without hitting the
+// schema module directly.
+export { emptyTaskRecord };
+//# sourceMappingURL=records.js.map

package/dist/task/records.js.map

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

package/dist/task/schema.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Canonical task.json shape — single source of truth for Trellis tasks.
+ *
+ * The runtime Python writer is `.trellis/scripts/common/task_store.py`
+ * (`cmd_create`). The 24-field shape and field order below mirror that
+ * writer exactly so every TS and Python entry point produces structurally
+ * identical task.json files.
+ *
+ * Downstream consumers (CLI bootstrap, migration tooling, external Node
+ * services) should depend on this type instead of redefining their own
+ * task.json shape.
+ */
+export interface TrellisTaskRecord {
+    id: string;
+    name: string;
+    title: string;
+    description: string;
+    status: string;
+    dev_type: string | null;
+    scope: string | null;
+    package: string | null;
+    priority: string;
+    creator: string;
+    assignee: string;
+    createdAt: string;
+    completedAt: string | null;
+    branch: string | null;
+    base_branch: string | null;
+    worktree_path: string | null;
+    commit: string | null;
+    pr_url: string | null;
+    subtasks: string[];
+    children: string[];
+    parent: string | null;
+    relatedFiles: string[];
+    notes: string;
+    meta: Record<string, unknown>;
+}
+/**
+ * Canonical task field order — matches `task_store.py::cmd_create`. Used
+ * by `writeTaskRecord` so the on-disk JSON layout is deterministic.
+ */
+export declare const TASK_RECORD_FIELD_ORDER: readonly ["id", "name", "title", "description", "status", "dev_type", "scope", "package", "priority", "creator", "assignee", "createdAt", "completedAt", "branch", "base_branch", "worktree_path", "commit", "pr_url", "subtasks", "children", "parent", "relatedFiles", "notes", "meta"];
+export type TaskRecordField = (typeof TASK_RECORD_FIELD_ORDER)[number];
+/**
+ * Lightweight runtime schema for {@link TrellisTaskRecord}. Zero-dep on
+ * purpose — `taskRecordSchema.parse(input)` returns a canonicalized
+ * record, throwing on shape violations; `taskRecordSchema.safeParse`
+ * returns a result discriminated by `success`.
+ *
+ * All canonical fields are required; older partial records are rejected rather
+ * than backfilled with defaults. Unknown fields on the input are intentionally
+ * omitted from this structured output. `writeTaskRecord` preserves unknown
+ * fields already present on disk by merging canonical updates over the existing
+ * JSON object.
+ */
+export declare const taskRecordSchema: {
+    readonly parse: (input: unknown) => TrellisTaskRecord;
+    readonly safeParse: (input: unknown) => {
+        success: true;
+        data: TrellisTaskRecord;
+    } | {
+        success: false;
+        error: Error;
+    };
+};
+/**
+ * Produce a fully-populated canonical-shape {@link TrellisTaskRecord}.
+ *
+ * All 24 fields are present in canonical order. `overrides` shallow-merges
+ * over the defaults — callers supply per-task values (id, name, title,
+ * assignee, createdAt, etc.) and leave null-default fields untouched
+ * unless they have a real value.
+ */
+export declare function emptyTaskRecord(overrides?: Partial<TrellisTaskRecord>): TrellisTaskRecord;
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/task/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/task/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,2RAyBqB,CAAC;AAE1D,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAkCvE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB;4BACd,OAAO,KAAG,iBAAiB;gCAI/B,OAAO,KAEZ;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,iBAAiB,CAAA;KAAE,GAC1C;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE;CAU5B,CAAC;AAwDX;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,SAAS,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACzC,iBAAiB,CA0CnB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAO9E"}

package/dist/task/schema.js

@@ -0,0 +1,220 @@
+/**
+ * Canonical task field order — matches `task_store.py::cmd_create`. Used
+ * by `writeTaskRecord` so the on-disk JSON layout is deterministic.
+ */
+export const TASK_RECORD_FIELD_ORDER = [
+    "id",
+    "name",
+    "title",
+    "description",
+    "status",
+    "dev_type",
+    "scope",
+    "package",
+    "priority",
+    "creator",
+    "assignee",
+    "createdAt",
+    "completedAt",
+    "branch",
+    "base_branch",
+    "worktree_path",
+    "commit",
+    "pr_url",
+    "subtasks",
+    "children",
+    "parent",
+    "relatedFiles",
+    "notes",
+    "meta",
+];
+const STRING_FIELDS = new Set([
+    "id",
+    "name",
+    "title",
+    "description",
+    "status",
+    "priority",
+    "creator",
+    "assignee",
+    "createdAt",
+    "notes",
+]);
+const NULLABLE_STRING_FIELDS = new Set([
+    "dev_type",
+    "scope",
+    "package",
+    "completedAt",
+    "branch",
+    "base_branch",
+    "worktree_path",
+    "commit",
+    "pr_url",
+    "parent",
+]);
+const STRING_ARRAY_FIELDS = new Set([
+    "subtasks",
+    "children",
+    "relatedFiles",
+]);
+/**
+ * Lightweight runtime schema for {@link TrellisTaskRecord}. Zero-dep on
+ * purpose — `taskRecordSchema.parse(input)` returns a canonicalized
+ * record, throwing on shape violations; `taskRecordSchema.safeParse`
+ * returns a result discriminated by `success`.
+ *
+ * All canonical fields are required; older partial records are rejected rather
+ * than backfilled with defaults. Unknown fields on the input are intentionally
+ * omitted from this structured output. `writeTaskRecord` preserves unknown
+ * fields already present on disk by merging canonical updates over the existing
+ * JSON object.
+ */
+export const taskRecordSchema = {
+    parse(input) {
+        return parseTaskRecord(input);
+    },
+    safeParse(input) {
+        try {
+            return { success: true, data: parseTaskRecord(input) };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof Error ? err : new Error(String(err)),
+            };
+        }
+    },
+};
+function parseTaskRecord(input) {
+    if (!isPlainObject(input)) {
+        throw new Error("task record must be a JSON object");
+    }
+    const out = emptyTaskRecord();
+    for (const field of TASK_RECORD_FIELD_ORDER) {
+        if (!(field in input)) {
+            throw new Error(`task.${field} is required`);
+        }
+        const value = input[field];
+        assignField(out, field, value);
+    }
+    return out;
+}
+function assignField(record, field, value) {
+    const bag = record;
+    if (STRING_FIELDS.has(field)) {
+        if (typeof value !== "string") {
+            throw new Error(`task.${field} must be a string`);
+        }
+        bag[field] = value;
+        return;
+    }
+    if (NULLABLE_STRING_FIELDS.has(field)) {
+        if (value !== null && typeof value !== "string") {
+            throw new Error(`task.${field} must be a string or null`);
+        }
+        bag[field] = value;
+        return;
+    }
+    if (STRING_ARRAY_FIELDS.has(field)) {
+        if (!Array.isArray(value) || value.some((v) => typeof v !== "string")) {
+            throw new Error(`task.${field} must be an array of strings`);
+        }
+        bag[field] = [...value];
+        return;
+    }
+    if (field === "meta") {
+        if (!isPlainObject(value)) {
+            throw new Error("task.meta must be a JSON object");
+        }
+        record.meta = cloneJsonObject(value, "task.meta");
+        return;
+    }
+    // Should be unreachable given the field sets cover every canonical field.
+    /* c8 ignore next */
+    throw new Error(`unknown canonical task field: ${field}`);
+}
+/**
+ * Produce a fully-populated canonical-shape {@link TrellisTaskRecord}.
+ *
+ * All 24 fields are present in canonical order. `overrides` shallow-merges
+ * over the defaults — callers supply per-task values (id, name, title,
+ * assignee, createdAt, etc.) and leave null-default fields untouched
+ * unless they have a real value.
+ */
+export function emptyTaskRecord(overrides = {}) {
+    const today = new Date().toISOString().split("T")[0] ?? "";
+    const base = {
+        id: "",
+        name: "",
+        title: "",
+        description: "",
+        status: "planning",
+        dev_type: null,
+        scope: null,
+        package: null,
+        priority: "P2",
+        creator: "",
+        assignee: "",
+        createdAt: today,
+        completedAt: null,
+        branch: null,
+        base_branch: null,
+        worktree_path: null,
+        commit: null,
+        pr_url: null,
+        subtasks: [],
+        children: [],
+        parent: null,
+        relatedFiles: [],
+        notes: "",
+        meta: {},
+    };
+    const record = { ...base, ...overrides };
+    if (overrides.subtasks !== undefined) {
+        record.subtasks = [...overrides.subtasks];
+    }
+    if (overrides.children !== undefined) {
+        record.children = [...overrides.children];
+    }
+    if (overrides.relatedFiles !== undefined) {
+        record.relatedFiles = [...overrides.relatedFiles];
+    }
+    if (overrides.meta !== undefined) {
+        record.meta = cloneJsonObject(overrides.meta, "task.meta");
+    }
+    return record;
+}
+export function isPlainObject(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        !Array.isArray(value) &&
+        Object.getPrototypeOf(value) === Object.prototype);
+}
+function cloneJsonObject(value, path) {
+    const out = {};
+    for (const [key, child] of Object.entries(value)) {
+        out[key] = cloneJsonValue(child, `${path}.${key}`);
+    }
+    return out;
+}
+function cloneJsonValue(value, path) {
+    if (value === null ||
+        typeof value === "string" ||
+        typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new Error(`${path} must be a finite JSON number`);
+        }
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((item, index) => cloneJsonValue(item, `${path}[${index}]`));
+    }
+    if (isPlainObject(value)) {
+        return cloneJsonObject(value, path);
+    }
+    throw new Error(`${path} must contain only JSON values`);
+}
+//# sourceMappingURL=schema.js.map

package/dist/task/schema.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,4 @@
+// Testing helpers placeholder. Exposes nothing in P0; reserved for the
+// public testing surface in later phases.
+export {};
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,0CAA0C"}