@blxzer/cursor-trellis-core 0.5.0-beta.4 → 0.5.0

package/dist/task/records.d.ts

@@ -1,48 +0,0 @@
-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;
-    /**
-     * 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): 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.
- *
- * Stage 2 (P28/P30): Kernel Commands may call this for same-command
- * legacy projection. Do not add another packages/core `writeFileSync`
- * primitive for `task.json`.
- */
-export declare function writeTaskRecord(options: WriteTaskRecordOptions): void;
-export { emptyTaskRecord };
-//# sourceMappingURL=records.d.ts.map

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

@@ -1 +0,0 @@
-{"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;IACb;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,qBAAqB,GAC7B,iBAAiB,CAYnB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CA4BrE;AAoCD,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/task/records.js

@@ -1,100 +0,0 @@
-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.
- *
- * Stage 2 (P28/P30): Kernel Commands may call this for same-command
- * legacy projection. Do not add another packages/core `writeFileSync`
- * primitive for `task.json`.
- */
-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 (options.extra) {
-        for (const [key, value] of Object.entries(options.extra)) {
-            if (TASK_RECORD_FIELD_ORDER.includes(key))
-                continue;
-            out[key] = value;
-        }
-    }
-    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

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

package/dist/task/schema.d.ts

@@ -1,77 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,220 +0,0 @@
-/**
- * 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

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

package/dist/testing/index.d.ts

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

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

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

package/dist/testing/index.js

@@ -1,4 +0,0 @@
-// 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

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