@g3nomaly/skills 0.3.0 → 1.0.0

package/dist/filetree/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/filetree/frontmatter.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,KAAK,GAAG,KAAK,CAAC;AASpB;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY;IAC7C,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAElC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,mBAAmB,CAAC,IAAI,EAAE;YAClC,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,KAAK,+BAA+B,EAAE;SAChF,CAAC,CAAC;IACL,CAAC;IAED,MAAM,WAAW,GAAY,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEzD,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAC1F,MAAM,IAAI,mBAAmB,CAAC,IAAI,EAAE;YAClC,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,6BAA6B,EAAE;SACnE,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;AAC3C,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,OAAO,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC;AAChD,CAAC;AAED,iFAAiF;AACjF,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE/B,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAE/C,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,KAAK,KAAK,CAAC,CAAC;IACxF,IAAI,OAAO,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAEhC,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACzC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;KAC9D,CAAC;AACJ,CAAC"}

package/dist/filetree/generate.d.ts

@@ -0,0 +1,16 @@
+import { type TreeLevel } from "./levels";
+/**
+ * Rebuilds one folder's index from the entries directly under it, replacing
+ * whatever was there. Plans and phases are read from `<name>/<name>.md`, tasks
+ * from `tasks/<id>.md`, so the result only depends on that one folder.
+ *
+ * @throws FileValidationError when an entry fails its schema or its identifier
+ *   does not match the folder or file it was read from
+ */
+export declare function generateIndex(dir: string, level: TreeLevel): Promise<void>;
+/**
+ * Rebuilds every index in the tree, from the root folder down.
+ * Run `ensureTree` first — a plan or phase without its folder throws here.
+ */
+export declare function generateTree(root: string): Promise<void>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/filetree/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/filetree/generate.ts"],"names":[],"mappings":"AAOA,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAKvD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhF;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D"}

package/dist/filetree/generate.js

@@ -0,0 +1,62 @@
+// packages/skills/src/filetree/generate.ts
+import { resolve } from "node:path";
+import { parseFile } from "../schemas/validation";
+import { PlanIndexSchema } from "../schemas/plan";
+import { PhaseIndexSchema } from "../schemas/phase";
+import { TaskIndexSchema } from "../schemas/task";
+import { CHILD_LEVEL } from "./levels";
+import { childDirFor, indexPathFor } from "./paths";
+import { listEntryNames } from "./entries";
+import { readEntry } from "./read";
+/**
+ * Rebuilds one folder's index from the entries directly under it, replacing
+ * whatever was there. Plans and phases are read from `<name>/<name>.md`, tasks
+ * from `tasks/<id>.md`, so the result only depends on that one folder.
+ *
+ * @throws FileValidationError when an entry fails its schema or its identifier
+ *   does not match the folder or file it was read from
+ */
+export async function generateIndex(dir, level) {
+    switch (level) {
+        case "root":
+            await writeIndex(dir, level, PlanIndexSchema, { plans: await collect(dir, level) });
+            return;
+        case "plan":
+            await writeIndex(dir, level, PhaseIndexSchema, { phases: await collect(dir, level) });
+            return;
+        case "phase":
+            await writeIndex(dir, level, TaskIndexSchema, { tasks: await collect(dir, level) });
+            return;
+    }
+}
+/**
+ * Rebuilds every index in the tree, from the root folder down.
+ * Run `ensureTree` first — a plan or phase without its folder throws here.
+ */
+export async function generateTree(root) {
+    await generateFrom(resolve(root), "root");
+}
+/** `dir` is absolute; `childDirFor` keeps it that way down the walk. */
+async function generateFrom(dir, level) {
+    await generateIndex(dir, level);
+    const child = CHILD_LEVEL[level];
+    if (child === null)
+        return;
+    for (const name of await listEntryNames(dir, level)) {
+        await generateFrom(childDirFor(dir, name), child);
+    }
+}
+/** Reads and validates every entry of `dir`, in queue order. */
+async function collect(dir, level) {
+    const entries = [];
+    for (const name of await listEntryNames(dir, level)) {
+        entries.push((await readEntry(dir, level, name)).meta);
+    }
+    return entries;
+}
+async function writeIndex(dir, level, schema, index) {
+    const file = indexPathFor(dir, level);
+    const validated = parseFile(schema, file, index);
+    await Bun.write(file, `${JSON.stringify(validated, null, 2)}\n`);
+}
+//# sourceMappingURL=generate.js.map

package/dist/filetree/generate.js.map

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

package/dist/filetree/index.d.ts

@@ -0,0 +1,17 @@
+export { LEVELS, INDEX_FILES, CHILD_LEVEL, ENTRY_KIND, ENTRY_TYPE, ID_FIELD, TASKS_DIR, MARKDOWN, } from "./levels";
+export type { TreeLevel } from "./levels";
+export { indexPathFor, entryPathFor, childDirFor, tasksDirFor, levelFor } from "./paths";
+export { listEntryNames } from "./entries";
+export { readDocument, readFrontmatter } from "./frontmatter";
+export type { Document } from "./frontmatter";
+export { readEntry } from "./read";
+export type { EntryOf, EntryDocument } from "./read";
+export { listAllEntries, locateEntry, locateEntryOfType, resolveParent } from "./locate";
+export type { EntryLocation, ParentFolder } from "./locate";
+export { setEntryStatus, setStatusLine } from "./status";
+export type { StatusChange } from "./status";
+export { removeEntry } from "./remove";
+export { resolveFiletreeRoot } from "./root";
+export { ensureTree } from "./ensure";
+export { generateIndex, generateTree } from "./generate";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/filetree/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,MAAM,EACN,WAAW,EACX,WAAW,EACX,UAAU,EACV,UAAU,EACV,QAAQ,EACR,SAAS,EACT,QAAQ,GACT,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEzF,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC9D,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzF,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/filetree/index.js

@@ -0,0 +1,13 @@
+// packages/skills/src/filetree/index.ts
+export { LEVELS, INDEX_FILES, CHILD_LEVEL, ENTRY_KIND, ENTRY_TYPE, ID_FIELD, TASKS_DIR, MARKDOWN, } from "./levels";
+export { indexPathFor, entryPathFor, childDirFor, tasksDirFor, levelFor } from "./paths";
+export { listEntryNames } from "./entries";
+export { readDocument, readFrontmatter } from "./frontmatter";
+export { readEntry } from "./read";
+export { listAllEntries, locateEntry, locateEntryOfType, resolveParent } from "./locate";
+export { setEntryStatus, setStatusLine } from "./status";
+export { removeEntry } from "./remove";
+export { resolveFiletreeRoot } from "./root";
+export { ensureTree } from "./ensure";
+export { generateIndex, generateTree } from "./generate";
+//# sourceMappingURL=index.js.map

package/dist/filetree/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/filetree/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,OAAO,EACL,MAAM,EACN,WAAW,EACX,WAAW,EACX,UAAU,EACV,UAAU,EACV,QAAQ,EACR,SAAS,EACT,QAAQ,GACT,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEzF,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAG9D,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGnC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/filetree/levels.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The three depths of the tree, named after the folder that holds them.
+ * A `root` folder holds plans, a `plan` folder holds phases, a `phase` folder
+ * holds tasks. Every `paths`, `entries` and `filetree` function is keyed by this.
+ */
+export declare const LEVELS: readonly ["root", "plan", "phase"];
+export type TreeLevel = (typeof LEVELS)[number];
+/** Index file each level writes, in the folder whose entries it lists. */
+export declare const INDEX_FILES: Record<TreeLevel, string>;
+/** Level of the folder opened by an entry, or `null` where entries are leaves. */
+export declare const CHILD_LEVEL: Record<TreeLevel, TreeLevel | null>;
+/** What a level's entries are called, for messages and hook output. */
+export declare const ENTRY_TYPE: Record<TreeLevel, "plan" | "phase" | "task">;
+/** Frontmatter field carrying an entry's identifier, per level. */
+export declare const ID_FIELD: Record<TreeLevel, "name" | "id">;
+/** Folder inside a phase holding its task files. */
+export declare const TASKS_DIR = "tasks";
+/**
+ * How a level's entries sit on disk. A `folder` entry owns a directory named
+ * after it holding `<name>.md`; a `file` entry is a `.md` file in `TASKS_DIR`.
+ */
+export declare const ENTRY_KIND: Record<TreeLevel, "folder" | "file">;
+/** Extension of every file carrying an entry's frontmatter. */
+export declare const MARKDOWN = ".md";
+//# sourceMappingURL=levels.d.ts.map

package/dist/filetree/levels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"levels.d.ts","sourceRoot":"","sources":["../../src/filetree/levels.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,MAAM,YAAI,MAAM,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAEzD,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhD,0EAA0E;AAC1E,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAIjD,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAI3D,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAInE,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAIrD,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,SAAS,UAAU,CAAC;AAEjC;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,QAAQ,GAAG,MAAM,CAI3D,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,QAAQ,QAAQ,CAAC"}

package/dist/filetree/levels.js

@@ -0,0 +1,45 @@
+// packages/skills/src/filetree/levels.ts
+/**
+ * The three depths of the tree, named after the folder that holds them.
+ * A `root` folder holds plans, a `plan` folder holds phases, a `phase` folder
+ * holds tasks. Every `paths`, `entries` and `filetree` function is keyed by this.
+ */
+export const LEVELS = ["root", "plan", "phase"];
+/** Index file each level writes, in the folder whose entries it lists. */
+export const INDEX_FILES = {
+    root: "root-index.json",
+    plan: "plan-index.json",
+    phase: "phase-index.json",
+};
+/** Level of the folder opened by an entry, or `null` where entries are leaves. */
+export const CHILD_LEVEL = {
+    root: "plan",
+    plan: "phase",
+    phase: null,
+};
+/** What a level's entries are called, for messages and hook output. */
+export const ENTRY_TYPE = {
+    root: "plan",
+    plan: "phase",
+    phase: "task",
+};
+/** Frontmatter field carrying an entry's identifier, per level. */
+export const ID_FIELD = {
+    root: "name",
+    plan: "name",
+    phase: "id",
+};
+/** Folder inside a phase holding its task files. */
+export const TASKS_DIR = "tasks";
+/**
+ * How a level's entries sit on disk. A `folder` entry owns a directory named
+ * after it holding `<name>.md`; a `file` entry is a `.md` file in `TASKS_DIR`.
+ */
+export const ENTRY_KIND = {
+    root: "folder",
+    plan: "folder",
+    phase: "file",
+};
+/** Extension of every file carrying an entry's frontmatter. */
+export const MARKDOWN = ".md";
+//# sourceMappingURL=levels.js.map

package/dist/filetree/levels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"levels.js","sourceRoot":"","sources":["../../src/filetree/levels.ts"],"names":[],"mappings":"AAAA,yCAAyC;AAEzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAIzD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,WAAW,GAA8B;IACpD,IAAI,EAAG,iBAAiB;IACxB,IAAI,EAAG,iBAAiB;IACxB,KAAK,EAAE,kBAAkB;CAC1B,CAAC;AAEF,kFAAkF;AAClF,MAAM,CAAC,MAAM,WAAW,GAAwC;IAC9D,IAAI,EAAG,MAAM;IACb,IAAI,EAAG,OAAO;IACd,KAAK,EAAE,IAAI;CACZ,CAAC;AAEF,uEAAuE;AACvE,MAAM,CAAC,MAAM,UAAU,GAAiD;IACtE,IAAI,EAAG,MAAM;IACb,IAAI,EAAG,OAAO;IACd,KAAK,EAAE,MAAM;CACd,CAAC;AAEF,mEAAmE;AACnE,MAAM,CAAC,MAAM,QAAQ,GAAqC;IACxD,IAAI,EAAG,MAAM;IACb,IAAI,EAAG,MAAM;IACb,KAAK,EAAE,IAAI;CACZ,CAAC;AAEF,oDAAoD;AACpD,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC;AAEjC;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAyC;IAC9D,IAAI,EAAG,QAAQ;IACf,IAAI,EAAG,QAAQ;IACf,KAAK,EAAE,MAAM;CACd,CAAC;AAEF,+DAA+D;AAC/D,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,CAAC"}

package/dist/filetree/locate.d.ts

@@ -0,0 +1,44 @@
+import { type TreeLevel } from "./levels";
+/** Where one entry sits, from the folder that lists it. */
+export interface EntryLocation {
+    /** Level of `dir` — the folder whose index lists this entry. */
+    level: TreeLevel;
+    /** What this entry is: a `root` folder lists plans, a `phase` folder tasks. */
+    type: "plan" | "phase" | "task";
+    name: string;
+    dir: string;
+    file: string;
+    /** Names from the tree root down to and including this entry. */
+    trail: string[];
+}
+/** Where a folder's entries are listed, and at which level. */
+export interface ParentFolder {
+    dir: string;
+    level: TreeLevel;
+}
+/**
+ * Every entry in the tree, in the order the queue runs: each folder's entries
+ * alphabetically, and each entry's own entries directly after it.
+ */
+export declare function listAllEntries(root: string): Promise<EntryLocation[]>;
+/**
+ * Finds the one entry named `name` anywhere in the tree.
+ *
+ * @throws Error when nothing is named `name`, or when two entries are — a name
+ *   the caller cannot act on is reported rather than resolved by guessing
+ */
+export declare function locateEntry(root: string, name: string): Promise<EntryLocation>;
+/**
+ * `locateEntry` for a caller that only accepts one kind of entry, such as a
+ * hook whose `--in` must name a plan.
+ *
+ * @throws Error when the entry named `name` is of another type
+ */
+export declare function locateEntryOfType(root: string, name: string, type: EntryLocation["type"]): Promise<EntryLocation>;
+/**
+ * Folder whose entries `parent` holds, or the tree root when no parent is named.
+ *
+ * @param parent name of a plan or phase; a task holds nothing
+ */
+export declare function resolveParent(root: string, parent?: string): Promise<ParentFolder>;
+//# sourceMappingURL=locate.d.ts.map

package/dist/filetree/locate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locate.d.ts","sourceRoot":"","sources":["../../src/filetree/locate.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2B,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAInE,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,KAAK,EAAE,SAAS,CAAC;IACjB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,+DAA+D;AAC/D,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,SAAS,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAI3E;AA0BD;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAcpF;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAC1B,OAAO,CAAC,aAAa,CAAC,CAQxB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAWxF"}

package/dist/filetree/locate.js

@@ -0,0 +1,76 @@
+// packages/skills/src/filetree/locate.ts
+import { resolve } from "node:path";
+import { CHILD_LEVEL, ENTRY_TYPE } from "./levels";
+import { childDirFor, entryPathFor } from "./paths";
+import { listEntryNames } from "./entries";
+/**
+ * Every entry in the tree, in the order the queue runs: each folder's entries
+ * alphabetically, and each entry's own entries directly after it.
+ */
+export async function listAllEntries(root) {
+    const found = [];
+    await collectFrom(resolve(root), "root", [], found);
+    return found;
+}
+async function collectFrom(dir, level, trail, found) {
+    const child = CHILD_LEVEL[level];
+    for (const name of await listEntryNames(dir, level)) {
+        const here = [...trail, name];
+        found.push({
+            level,
+            type: ENTRY_TYPE[level],
+            name,
+            dir,
+            file: entryPathFor(dir, level, name),
+            trail: here,
+        });
+        if (child !== null)
+            await collectFrom(childDirFor(dir, name), child, here, found);
+    }
+}
+/**
+ * Finds the one entry named `name` anywhere in the tree.
+ *
+ * @throws Error when nothing is named `name`, or when two entries are — a name
+ *   the caller cannot act on is reported rather than resolved by guessing
+ */
+export async function locateEntry(root, name) {
+    const matches = (await listAllEntries(root)).filter((entry) => entry.name === name);
+    const [first, second] = matches;
+    if (first === undefined) {
+        throw new Error(`nothing in ${resolve(root)} is named "${name}"`);
+    }
+    if (second !== undefined) {
+        throw new Error(`"${name}" is ambiguous: ${first.file} and ${second.file} both answer to it`);
+    }
+    return first;
+}
+/**
+ * `locateEntry` for a caller that only accepts one kind of entry, such as a
+ * hook whose `--in` must name a plan.
+ *
+ * @throws Error when the entry named `name` is of another type
+ */
+export async function locateEntryOfType(root, name, type) {
+    const entry = await locateEntry(root, name);
+    if (entry.type !== type) {
+        throw new Error(`"${name}" is a ${entry.type}, not a ${type}`);
+    }
+    return entry;
+}
+/**
+ * Folder whose entries `parent` holds, or the tree root when no parent is named.
+ *
+ * @param parent name of a plan or phase; a task holds nothing
+ */
+export async function resolveParent(root, parent) {
+    if (parent === undefined)
+        return { dir: resolve(root), level: "root" };
+    const entry = await locateEntry(root, parent);
+    const child = CHILD_LEVEL[entry.level];
+    if (child === null) {
+        throw new Error(`"${parent}" is a ${entry.type}, which holds no entries`);
+    }
+    return { dir: childDirFor(entry.dir, entry.name), level: child };
+}
+//# sourceMappingURL=locate.js.map

package/dist/filetree/locate.js.map

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

package/dist/filetree/paths.d.ts

@@ -0,0 +1,15 @@
+import { type TreeLevel } from "./levels";
+/** Path of the index file a folder at `level` owns. */
+export declare function indexPathFor(dir: string, level: TreeLevel): string;
+/** Folder owned by a `folder` entry — holds its own file and the level below it. */
+export declare function childDirFor(dir: string, entryName: string): string;
+/** Folder holding a phase's task files. */
+export declare function tasksDirFor(phaseDir: string): string;
+/** Path of the `.md` file describing one entry of a folder at `level`. */
+export declare function entryPathFor(dir: string, level: TreeLevel, entryName: string): string;
+/**
+ * Level of `dir` given the tree it belongs to, from how deep it sits under
+ * `root`. Throws when `dir` sits outside `root` or below a phase folder.
+ */
+export declare function levelFor(root: string, dir: string): TreeLevel;
+//# sourceMappingURL=paths.d.ts.map

package/dist/filetree/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/filetree/paths.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwD,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAEhG,uDAAuD;AACvD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,CAElE;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,2CAA2C;AAC3C,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAIrF;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAe7D"}

package/dist/filetree/paths.js

@@ -0,0 +1,38 @@
+// packages/skills/src/filetree/paths.ts
+import { join, relative, resolve, sep } from "node:path";
+import { ENTRY_KIND, INDEX_FILES, LEVELS, MARKDOWN, TASKS_DIR } from "./levels";
+/** Path of the index file a folder at `level` owns. */
+export function indexPathFor(dir, level) {
+    return join(dir, INDEX_FILES[level]);
+}
+/** Folder owned by a `folder` entry — holds its own file and the level below it. */
+export function childDirFor(dir, entryName) {
+    return join(dir, entryName);
+}
+/** Folder holding a phase's task files. */
+export function tasksDirFor(phaseDir) {
+    return join(phaseDir, TASKS_DIR);
+}
+/** Path of the `.md` file describing one entry of a folder at `level`. */
+export function entryPathFor(dir, level, entryName) {
+    return ENTRY_KIND[level] === "folder"
+        ? join(dir, entryName, `${entryName}${MARKDOWN}`)
+        : join(tasksDirFor(dir), `${entryName}${MARKDOWN}`);
+}
+/**
+ * Level of `dir` given the tree it belongs to, from how deep it sits under
+ * `root`. Throws when `dir` sits outside `root` or below a phase folder.
+ */
+export function levelFor(root, dir) {
+    const rel = relative(resolve(root), resolve(dir));
+    if (rel.startsWith("..")) {
+        throw new Error(`${dir} is not inside the tree at ${root}`);
+    }
+    const depth = rel === "" ? 0 : rel.split(sep).length;
+    const level = LEVELS[depth];
+    if (level === undefined) {
+        throw new Error(`${dir} is ${depth} folders below ${root}; the tree is ${LEVELS.length} deep`);
+    }
+    return level;
+}
+//# sourceMappingURL=paths.js.map

package/dist/filetree/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/filetree/paths.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAkB,MAAM,UAAU,CAAC;AAEhG,uDAAuD;AACvD,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,KAAgB;IACxD,OAAO,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,SAAiB;IACxD,OAAO,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AAC9B,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,OAAO,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AACnC,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,KAAgB,EAAE,SAAiB;IAC3E,OAAO,UAAU,CAAC,KAAK,CAAC,KAAK,QAAQ;QACnC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,SAAS,GAAG,QAAQ,EAAE,CAAC;QACjD,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS,GAAG,QAAQ,EAAE,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,GAAW;IAChD,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAElD,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,8BAA8B,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,KAAK,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAE5B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,OAAO,KAAK,kBAAkB,IAAI,iBAAiB,MAAM,CAAC,MAAM,OAAO,CAAC,CAAC;IACjG,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/filetree/read.d.ts

@@ -0,0 +1,23 @@
+import { type Plan } from "../schemas/plan";
+import { type Phase } from "../schemas/phase";
+import { type Task } from "../schemas/task";
+import { type TreeLevel } from "./levels";
+/** Entry a folder at `L` holds — a root folder holds plans, a plan folder phases. */
+export type EntryOf<L extends TreeLevel> = L extends "root" ? Plan : L extends "plan" ? Phase : Task;
+/** One entry as it sits on disk: where it was read from, its fields, its prose. */
+export interface EntryDocument<L extends TreeLevel> {
+    file: string;
+    meta: EntryOf<L>;
+    body: string;
+}
+/**
+ * Reads one entry of a folder at `level` and checks it against its schema.
+ * Every read of a plan, phase or task file goes through here.
+ *
+ * @param dir folder whose index lists the entry
+ * @param name folder name for a plan or phase, task id for a task
+ * @throws FileValidationError when a field fails its schema, or when the
+ *   identifier inside the file disagrees with the folder or file it was read from
+ */
+export declare function readEntry<L extends TreeLevel>(dir: string, level: L, name: string): Promise<EntryDocument<L>>;
+//# sourceMappingURL=read.d.ts.map

package/dist/filetree/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/filetree/read.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAIpD,qFAAqF;AACrF,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,SAAS,IAAI,CAAC,SAAS,MAAM,GAAG,IAAI,GAAG,CAAC,SAAS,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;AAErG,mFAAmF;AACnF,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,SAAS;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAQD;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,CAAC,SAAS,SAAS,EACjD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAe3B"}

package/dist/filetree/read.js

@@ -0,0 +1,36 @@
+// packages/skills/src/filetree/read.ts
+import { FileValidationError, parseFile } from "../schemas/validation";
+import { PlanSchema } from "../schemas/plan";
+import { PhaseSchema } from "../schemas/phase";
+import { TaskSchema } from "../schemas/task";
+import { ID_FIELD } from "./levels";
+import { entryPathFor } from "./paths";
+import { readDocument } from "./frontmatter";
+const SCHEMAS = {
+    root: PlanSchema,
+    plan: PhaseSchema,
+    phase: TaskSchema,
+};
+/**
+ * Reads one entry of a folder at `level` and checks it against its schema.
+ * Every read of a plan, phase or task file goes through here.
+ *
+ * @param dir folder whose index lists the entry
+ * @param name folder name for a plan or phase, task id for a task
+ * @throws FileValidationError when a field fails its schema, or when the
+ *   identifier inside the file disagrees with the folder or file it was read from
+ */
+export async function readEntry(dir, level, name) {
+    const file = entryPathFor(dir, level, name);
+    const { frontmatter, body } = await readDocument(file);
+    const meta = parseFile(SCHEMAS[level], file, frontmatter);
+    const idField = ID_FIELD[level];
+    const identifier = meta[idField];
+    if (identifier !== name) {
+        throw new FileValidationError(file, [
+            { field: idField, message: `is "${String(identifier)}" but it was read as "${name}"` },
+        ]);
+    }
+    return { file, meta, body };
+}
+//# sourceMappingURL=read.js.map

package/dist/filetree/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/filetree/read.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAa,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAc,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAa,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAkB,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAY7C,MAAM,OAAO,GAAG;IACd,IAAI,EAAG,UAAU;IACjB,IAAI,EAAG,WAAW;IAClB,KAAK,EAAE,UAAU;CACT,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAW,EACX,KAAQ,EACR,IAAY;IAEZ,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAC5C,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,WAAW,CAAe,CAAC;IAExE,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,UAAU,GAAI,IAAgC,CAAC,OAAO,CAAC,CAAC;IAE9D,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,MAAM,IAAI,mBAAmB,CAAC,IAAI,EAAE;YAClC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,MAAM,CAAC,UAAU,CAAC,yBAAyB,IAAI,GAAG,EAAE;SACvF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC9B,CAAC"}

package/dist/filetree/remove.d.ts

@@ -0,0 +1,9 @@
+import type { EntryLocation } from "./locate";
+/**
+ * Deletes an entry — a task's `.md` file, or a plan or phase folder with
+ * everything under it. Removing something already gone is not an error, so a
+ * plan and a phase inside it can both be handed in. Regenerate the tree
+ * afterwards.
+ */
+export declare function removeEntry(entry: EntryLocation): Promise<void>;
+//# sourceMappingURL=remove.d.ts.map

package/dist/filetree/remove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../src/filetree/remove.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAMrE"}

package/dist/filetree/remove.js

@@ -0,0 +1,17 @@
+// packages/skills/src/filetree/remove.ts
+import { rm } from "node:fs/promises";
+import { ENTRY_KIND } from "./levels";
+import { childDirFor } from "./paths";
+/**
+ * Deletes an entry — a task's `.md` file, or a plan or phase folder with
+ * everything under it. Removing something already gone is not an error, so a
+ * plan and a phase inside it can both be handed in. Regenerate the tree
+ * afterwards.
+ */
+export async function removeEntry(entry) {
+    const target = ENTRY_KIND[entry.level] === "folder"
+        ? childDirFor(entry.dir, entry.name)
+        : entry.file;
+    await rm(target, { recursive: true, force: true });
+}
+//# sourceMappingURL=remove.js.map

package/dist/filetree/remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../src/filetree/remove.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAoB;IACpD,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,QAAQ;QACjD,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC;QACpC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;IAEf,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACrD,CAAC"}

package/dist/filetree/root.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Absolute path of the tree, from `skills.settings.filetreeRoot` in
+ * `.g3n.config.json`. Falls back to the schema default when the project has no
+ * config file yet.
+ *
+ * @param projectRoot folder holding `.g3n.config.json`
+ */
+export declare function resolveFiletreeRoot(projectRoot: string): Promise<string>;
+//# sourceMappingURL=root.d.ts.map

package/dist/filetree/root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../../src/filetree/root.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI9E"}

package/dist/filetree/root.js

@@ -0,0 +1,15 @@
+// packages/skills/src/filetree/root.ts
+import { resolve } from "node:path";
+import { loadSkillsConfig } from "@g3nomaly/core/config";
+/**
+ * Absolute path of the tree, from `skills.settings.filetreeRoot` in
+ * `.g3n.config.json`. Falls back to the schema default when the project has no
+ * config file yet.
+ *
+ * @param projectRoot folder holding `.g3n.config.json`
+ */
+export async function resolveFiletreeRoot(projectRoot) {
+    const config = await loadSkillsConfig(projectRoot);
+    return resolve(projectRoot, config.settings.filetreeRoot);
+}
+//# sourceMappingURL=root.js.map

package/dist/filetree/root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.js","sourceRoot":"","sources":["../../src/filetree/root.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,WAAmB;IAC3D,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAEnD,OAAO,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;AAC5D,CAAC"}

package/dist/filetree/status.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import { type TaskStatus } from "../schemas/primitives";
+/** What a status change did, for a caller that reports it. */
+export interface StatusChange<T extends string = TaskStatus> {
+    from: T;
+    to: T;
+}
+/** `setStatusLine` for a plan, phase or task file. */
+export declare function setEntryStatus(file: string, to: TaskStatus): Promise<StatusChange>;
+/**
+ * Rewrites the `status:` line in a file's frontmatter and leaves every other
+ * byte alone, so comments, key order and quoting survive the change. Regenerate
+ * the owning index afterwards — this touches the `.md` file only.
+ *
+ * @param schema the set of statuses the file may hold
+ * @throws FileValidationError when the frontmatter has no `status:` line, or
+ *   holds a status outside `schema`
+ * @throws Error when the file already has status `to`
+ */
+export declare function setStatusLine<T extends string>(file: string, to: T, schema: z.ZodType<T>): Promise<StatusChange<T>>;
+//# sourceMappingURL=status.d.ts.map

package/dist/filetree/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/filetree/status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAMtE,8DAA8D;AAC9D,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,UAAU;IACzD,IAAI,EAAE,CAAC,CAAC;IACR,EAAE,EAAE,CAAC,CAAC;CACP;AAED,sDAAsD;AACtD,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAExF;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,CAAC,SAAS,MAAM,EAClD,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,EACL,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAyB1B"}