@baoanaz/cviauto-core 0.6.5

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 `.cviauto/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,CAC3B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOlC"}

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"}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@baoanaz/cviauto-core",
+  "version": "0.6.5",
+  "description": "Cviauto core SDK — channel and task domain primitives consumed by the Cviauto CLI and downstream Node services",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./channel": {
+      "types": "./dist/channel/index.d.ts",
+      "import": "./dist/channel/index.js",
+      "default": "./dist/channel/index.js"
+    },
+    "./mem": {
+      "types": "./dist/mem/index.d.ts",
+      "import": "./dist/mem/index.js",
+      "default": "./dist/mem/index.js"
+    },
+    "./task": {
+      "types": "./dist/task/index.d.ts",
+      "import": "./dist/task/index.js",
+      "default": "./dist/task/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.js",
+      "default": "./dist/testing/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "keywords": [
+    "cviauto",
+    "channel",
+    "sdk",
+    "agent",
+    "events"
+  ],
+  "author": "Mindfold LLC",
+  "license": "AGPL-3.0-only",
+  "devDependencies": {
+    "@eslint/js": "^9.18.0",
+    "@types/node": "^20.17.10",
+    "eslint": "^9.18.0",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.21.0",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=18.17.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/baoanaz/cviauto-trellis.git"
+  },
+  "scripts": {
+    "build": "pnpm run clean && tsc",
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/ test/",
+    "lint:fix": "eslint src/ test/ --fix",
+    "typecheck": "tsc --noEmit"
+  }
+}