@kamilio/wire 0.1.8 → 0.1.10

package/node_modules/toolcraft/node_modules/@poe-code/task-list/README.md

@@ -14,6 +14,8 @@ Multi-list task manager with pluggable storage backends.
 
 The task lifecycle is `draft -> planned -> in-progress -> done -> archived`. `archived` is terminal.
 
+In Workers or browsers, pass a `@poe-code/safe-fs` filesystem through `fs` for Markdown and YAML stores. It must support exclusive writes, rename, unlink, and rmdir for atomic updates and locks. Node uses its host filesystem by default. GitHub stores work with an explicit `auth.token`; automatic `gh` authentication requires a host runner.
+
 ## Public API
 
 - `openTaskList(options)`: opens a task store and returns a `TaskList`
@@ -46,7 +48,7 @@ interface EventDef<TState extends string = string> {
 
 Pass a custom machine with `openTaskList({ stateMachine })`. If omitted, the package uses `defaultStateMachine`, whose event names are `plan`, `start`, `complete`, and `archive`.
 
-## Options
+## Configuration Options
 
 | Option            | Type                                           | Default                    | Behavior                                                                                                          |
 | ----------------- | ---------------------------------------------- | -------------------------- | ----------------------------------------------------------------------------------------------------------------- |
@@ -59,7 +61,7 @@ Pass a custom machine with `openTaskList({ stateMachine })`. If omitted, the pac
 | `fs`              | `TaskListFs`                                   | `node:fs/promises` adapter | Injectable filesystem, primarily for tests.                                                                       |
 | `stateMachine`    | `StateMachineDef`                              | `defaultStateMachine`      | Overrides the task lifecycle used by `create`, `fire`, `canFire`, and `events`.                                   |
 
-## Env vars
+## Environment Variables
 
 | Env var   | Behavior                                                        |
 | --------- | --------------------------------------------------------------- |
@@ -103,6 +105,11 @@ await plans.list("plans").reorder(["api-shape-providers", "memory"]);
 
 `frontmatterMode: "strict"` expects full task frontmatter (`kind`, `version`, `name`, `state`, and related task fields). `frontmatterMode: "passthrough"` keeps unrelated frontmatter keys as task metadata and writes back only the task-owned fields (`name`, `description`, `state`), so existing plan metadata is preserved.
 
+List names, task ids, and task names are validated before writes. The
+`markdown-dir` backend accepts the normal macOS `/tmp` system alias, preserves
+numeric filename prefixes for passthrough documents, and removes invalid stale
+lock files before acquiring a new lock.
+
 ### `yaml-file`
 
 ```ts
@@ -125,6 +132,9 @@ await planning.fire("review-release", "plan");
 await planning.fire("review-release", "start");
 ```
 
+Archived tasks cannot be used as move anchors. Alphabetical listing with
+`includeArchived` sorts active and archived tasks together.
+
 ### `gh-issues`
 
 ```ts
@@ -155,6 +165,9 @@ await project.move(created.id, { after: "42" });
 
 `gh-issues` exposes one list named `${project.owner}/${project.number}`. `create()` ignores `TaskCreate.id` because GitHub assigns issue numbers. `fire(state)` writes the Project v2 `Status` field to the matching single-select option. `move()` reorders project items.
 
+Issue ids must be canonical decimal issue numbers. Required state names are
+checked for blank entries before project lookup or mutation.
+
 If the GitHub Project v2 board has not been set up manually, run `poe-code tasks sync <list>` before opening the backend. `openTaskList({ type: "gh-issues" })` no longer requires manual board setup when the board was provisioned with `tasks sync` first.
 
 ## Verifying and provisioning the GitHub Project v2 board
@@ -231,7 +244,7 @@ interface SyncGhProjectReport extends VerifyGhProjectReport {
 }
 ```
 
-The CLI exposes the same verification and provisioning flow:
+The root CLI exposes verification, provisioning, and task mutation commands:
 
 ```sh
 poe-code tasks verify <list> --workflow ./WORKFLOW.md --repo octo-org/octo-repo --project octo-org/7 --states queued,agent-running,human-review,done,failed,archived --json
@@ -249,6 +262,18 @@ poe-code tasks sync <list> --workflow ./WORKFLOW.md --repo octo-org/octo-repo --
 | `--json`                   | `verify`, `sync` | Prints the report as JSON.                          |
 | `--yes`                    | `sync`           | Confirms non-interactive provisioning.              |
 
+Additional task backend commands:
+
+| Command                                 | Purpose                                               |
+| --------------------------------------- | ----------------------------------------------------- |
+| `poe-code tasks move`                   | Move tasks between workflow-configured backends.      |
+| `poe-code tasks import`                 | Import Markdown task files into a configured backend. |
+| `poe-code tasks get <id>`               | Read one task.                                        |
+| `poe-code tasks set <id>`               | Update one task.                                      |
+| `poe-code tasks set-state <id> <state>` | Set one task's state.                                 |
+| `poe-code tasks next <id>`              | Advance one task to the next workflow state.          |
+| `poe-code tasks comment <id>`           | Add a task comment when the backend supports it.      |
+
 The `Status` field name and option names are matched case-sensitively. The field must be named `Status`, and required option names must match exactly. For example, `status` is treated as a missing field, and `Done` is treated as missing when the required state is `done`.
 
 In v1, if sync creates a new GitHub Project v2 board, the CLI prints the new project number and does not rewrite `WORKFLOW.md`. The operator must update `WORKFLOW.md` by hand with the printed `<owner>/<number>`.

package/node_modules/toolcraft/node_modules/@poe-code/task-list/dist/backends/gh-issues-client.d.ts

@@ -1,4 +1,4 @@
-import { type Runner } from "@poe-code/process-runner";
+import type { Runner } from "@poe-code/process-runner";
 export interface GhClientOptions {
     token: string;
     endpoint?: string;

package/node_modules/toolcraft/node_modules/@poe-code/task-list/dist/backends/gh-issues-client.js

@@ -1,5 +1,5 @@
-import { text } from "node:stream/consumers";
-import { createHostRunner } from "@poe-code/process-runner";
+import { createDefaultRunner } from "#task-list-host";
+import { UserError } from "@poe-code/user-error";
 const DEFAULT_ENDPOINT = "https://api.github.com/graphql";
 const USER_AGENT = "poe-code-task-list/0.0.1";
 const AUTH_ERROR = "gh auth token failed; install gh, run 'gh auth login', or pass auth: { token }";
@@ -18,6 +18,9 @@ export function createGhClient(options) {
                 body: JSON.stringify({ query, variables })
             });
             const body = await response.text();
+            if (response.status === 401) {
+                throw new UserError("GitHub rejected your credentials (HTTP 401). Your token is missing or expired - run 'gh auth login', or pass a valid token via auth: { token }.");
+            }
             if (response.status !== 200) {
                 throw new Error(`GitHub GraphQL request failed with status ${response.status}: ${body}`);
             }
@@ -37,7 +40,7 @@ export async function resolveAuth(options) {
     if (options.explicitToken !== undefined) {
         return options.explicitToken;
     }
-    const runner = options.runner ?? createHostRunner();
+    const runner = options.runner ?? createDefaultRunner();
     const handle = runner.exec({
         command: "gh",
         args: ["auth", "token"],
@@ -56,10 +59,18 @@ export async function resolveAuth(options) {
     return token;
 }
 export function resolveEndpoint(options = {}) {
-    const env = options.env ?? process.env;
+    const env = options.env ?? globalThis.process?.env ?? {};
     const host = env.GH_HOST;
     if (host !== undefined && host !== "" && host !== "github.com") {
         return `https://${host}/api/graphql`;
     }
     return DEFAULT_ENDPOINT;
 }
+async function text(stream) {
+    const decoder = new TextDecoder();
+    let result = "";
+    for await (const chunk of stream) {
+        result += typeof chunk === "string" ? decoder.decode() + chunk : decoder.decode(chunk, { stream: true });
+    }
+    return result + decoder.decode();
+}

package/node_modules/toolcraft/node_modules/@poe-code/task-list/dist/backends/markdown-dir.js

@@ -1,6 +1,6 @@
-import path from "node:path";
+import { path } from "../paths.js";
 import { parseDocument, stringify } from "yaml";
-import taskSchema from "../schema/task.schema.json" with { type: "json" };
+import { TASK_SCHEMA_ID } from "../schema/ids.js";
 import { eventsFromState, findEvent } from "../state-machine.js";
 import { resolveStateMachine } from "../state.js";
 import { AnchorNotFoundError, InvalidTransitionError, MalformedTaskError, OrderMismatchError, TaskAlreadyExistsError, TaskNotFoundError } from "../types.js";
@@ -9,7 +9,6 @@ const ARCHIVE_DIRECTORY_NAME = "archive";
 const MARKDOWN_EXTENSION = ".md";
 const TASK_KIND = "task";
 const TASK_VERSION = 1;
-const TASK_SCHEMA_ID = taskSchema.$id;
 const MIN_PREFIX_WIDTH = 2;
 const RESERVED_FRONTMATTER_KEYS = new Set([
     "$schema",
@@ -504,7 +503,7 @@ function createTasksView(deps, layout, list) {
             const desiredFilename = activeTaskFilename(entry.id, desiredOrder, width);
             if (entry.filename !== desiredFilename) {
                 const fromPath = path.join(listDirectoryPath, entry.filename);
-                const stagingPath = path.join(listDirectoryPath, `${desiredFilename}.staging-${process.pid}-${index}`);
+                const stagingPath = path.join(listDirectoryPath, `${desiredFilename}.staging-${crypto.randomUUID()}-${index}`);
                 const targetPath = path.join(listDirectoryPath, desiredFilename);
                 try {
                     await deps.fs.rename(fromPath, stagingPath);

package/node_modules/toolcraft/node_modules/@poe-code/task-list/dist/backends/utils.js

@@ -1,5 +1,6 @@
-import { randomUUID } from "node:crypto";
-import path from "node:path";
+import { path } from "../paths.js";
+const LOCK_WAIT_MS = 30_000;
+const LOCK_RETRY_MS = 10;
 export function compareCreated(left, right) {
     const leftCreated = typeof left.raw.created === "string" ? left.raw.created : "";
     const rightCreated = typeof right.raw.created === "string" ? right.raw.created : "";
@@ -10,7 +11,14 @@ export function compareCreated(left, right) {
         return 1;
     if (rightCreated === "")
         return -1;
-    return leftCreated.localeCompare(rightCreated);
+    const leftTimestamp = Date.parse(leftCreated);
+    const rightTimestamp = Date.parse(rightCreated);
+    if (Number.isNaN(leftTimestamp)) {
+        return Number.isNaN(rightTimestamp) ? leftCreated.localeCompare(rightCreated) : 1;
+    }
+    if (Number.isNaN(rightTimestamp))
+        return -1;
+    return leftTimestamp - rightTimestamp;
 }
 export function applyOrder(entries, order) {
     if (order === "alphabetical") {
@@ -77,9 +85,8 @@ export async function statIfExists(fs, filePath) {
 }
 export async function rejectSymbolicLinkComponents(fs, filePath) {
     const resolvedPath = path.resolve(filePath);
-    const rootPath = path.parse(resolvedPath).root;
-    const components = resolvedPath.slice(rootPath.length).split(path.sep).filter(Boolean);
-    let currentPath = rootPath;
+    const components = resolvedPath.slice(1).split("/").filter(Boolean);
+    let currentPath = "/";
     for (const component of components) {
         currentPath = path.join(currentPath, component);
         try {
@@ -99,7 +106,7 @@ export async function rejectSymbolicLinkComponents(fs, filePath) {
     }
 }
 export async function writeAtomically(fs, filePath, content) {
-    const tempPath = `${filePath}.${process.pid}.${randomUUID()}.tmp`;
+    const tempPath = `${filePath}.${crypto.randomUUID()}.tmp`;
     let tempCreated = false;
     await fs.mkdir(path.dirname(filePath), { recursive: true });
     try {
@@ -123,62 +130,48 @@ export async function writeAtomically(fs, filePath, content) {
     }
 }
 export async function withFileLock(fs, lockPath, operation) {
+    await rejectSymbolicLinkComponents(fs, lockPath);
     await fs.mkdir(path.dirname(lockPath), { recursive: true });
+    const ownerPath = path.join(lockPath, crypto.randomUUID());
+    const deadline = Date.now() + LOCK_WAIT_MS;
     for (;;) {
+        await rejectSymbolicLinkComponents(fs, lockPath);
         try {
-            await fs.writeFile(lockPath, String(process.pid), { encoding: "utf8", flag: "wx" });
+            await fs.mkdir(lockPath);
             break;
         }
         catch (error) {
             if (!hasErrorCode(error, "EEXIST")) {
-                await fs.unlink(lockPath).catch(() => undefined);
                 throw error;
             }
-            if (await removeAbandonedLock(fs, lockPath)) {
-                continue;
+            if (Date.now() >= deadline) {
+                throw new Error(`Timed out waiting for task-list lock: ${lockPath}. ` +
+                    "An abandoned or legacy lock must only be removed after confirming all task-list operations have stopped.");
             }
-            await Promise.resolve();
+            await new Promise((done) => setTimeout(done, LOCK_RETRY_MS));
         }
     }
+    await rejectSymbolicLinkComponents(fs, ownerPath);
+    await fs.mkdir(ownerPath);
+    let outcome;
     try {
-        return await operation();
-    }
-    finally {
-        await fs.unlink(lockPath);
-    }
-}
-async function removeAbandonedLock(fs, lockPath) {
-    let content;
-    try {
-        content = await fs.readFile(lockPath, "utf8");
+        outcome = { result: await operation() };
     }
     catch (error) {
-        if (hasErrorCode(error, "ENOENT")) {
-            return true;
-        }
-        throw error;
-    }
-    const owner = Number(content);
-    if (Number.isInteger(owner) && owner > 0 && isProcessRunning(owner)) {
-        return false;
+        outcome = { error };
     }
     try {
-        await fs.unlink(lockPath);
-        return true;
+        await rejectSymbolicLinkComponents(fs, ownerPath);
+        await fs.rmdir(ownerPath);
+        await fs.rmdir(lockPath);
     }
     catch (error) {
-        if (hasErrorCode(error, "ENOENT")) {
-            return true;
+        if ("error" in outcome) {
+            throw new AggregateError([outcome.error, error], "Task-list operation and lock release failed");
         }
         throw error;
     }
-}
-function isProcessRunning(pid) {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch (error) {
-        return !hasErrorCode(error, "ESRCH");
-    }
+    if ("error" in outcome)
+        throw outcome.error;
+    return outcome.result;
 }

package/node_modules/toolcraft/node_modules/@poe-code/task-list/dist/backends/yaml-file.js

@@ -1,16 +1,13 @@
-import path from "node:path";
+import { path } from "../paths.js";
 import { isMap, parseDocument } from "yaml";
-import storeSchema from "../schema/store.schema.json" with { type: "json" };
-import taskSchema from "../schema/task.schema.json" with { type: "json" };
+import { STORE_SCHEMA_ID, TASK_SCHEMA_ID } from "../schema/ids.js";
 import { eventsFromState, findEvent } from "../state-machine.js";
 import { resolveStateMachine } from "../state.js";
 import { AnchorNotFoundError, InvalidTransitionError, MalformedTaskError, OrderMismatchError, TaskAlreadyExistsError, TaskNotFoundError } from "../types.js";
 import { applyOrder, isTrimmedPrintableIdentifier, isRecord, rejectSymbolicLinkComponents, sortStrings, statIfExists, validateTaskId, validateTaskName, withFileLock, writeAtomically } from "./utils.js";
 const STORE_KIND = "task-store";
-const STORE_SCHEMA_ID = storeSchema.$id;
 const STORE_VERSION = 1;
 const TASK_KIND = "task";
-const TASK_SCHEMA_ID = taskSchema.$id;
 const TASK_VERSION = 1;
 const RESERVED_TASK_KEYS = new Set([
     "$schema",

package/node_modules/toolcraft/node_modules/@poe-code/task-list/dist/default-host.d.ts

@@ -0,0 +1,2 @@
+export { createHostFileSystem as createDefaultFileSystem } from "@poe-code/safe-fs/node";
+export { createHostRunner as createDefaultRunner } from "@poe-code/process-runner";

package/node_modules/toolcraft/node_modules/@poe-code/task-list/dist/default-host.js

@@ -0,0 +1,2 @@
+export { createHostFileSystem as createDefaultFileSystem } from "@poe-code/safe-fs/node";
+export { createHostRunner as createDefaultRunner } from "@poe-code/process-runner";

package/node_modules/toolcraft/node_modules/@poe-code/task-list/dist/default-host.workerd.d.ts

@@ -0,0 +1,4 @@
+import type { FileSystem } from "@poe-code/safe-fs/contracts";
+import type { Runner } from "@poe-code/process-runner";
+export declare function createDefaultFileSystem(): FileSystem;
+export declare function createDefaultRunner(): Runner;

package/node_modules/toolcraft/node_modules/@poe-code/task-list/dist/default-host.workerd.js

@@ -0,0 +1,6 @@
+export function createDefaultFileSystem() {
+    throw new Error("Task lists require an injected filesystem in this runtime.");
+}
+export function createDefaultRunner() {
+    throw new Error("GitHub authentication requires an explicit token or injected runner in this runtime.");
+}

package/node_modules/toolcraft/node_modules/@poe-code/task-list/dist/filesystem.d.ts

@@ -0,0 +1,3 @@
+import type { FileSystem } from "@poe-code/safe-fs/contracts";
+import type { TaskListFs } from "./types.js";
+export declare function taskListFileSystem(fs?: TaskListFs | FileSystem): TaskListFs;

package/node_modules/toolcraft/node_modules/@poe-code/task-list/dist/filesystem.js

@@ -0,0 +1,32 @@
+import { createDefaultFileSystem } from "#task-list-host";
+export function taskListFileSystem(fs = createDefaultFileSystem()) {
+    if (!("capabilities" in fs))
+        return fs;
+    return {
+        async lstat(path) { const stat = await fs.lstat(path); return { isSymbolicLink: () => stat.type === "symlink" }; },
+        mkdir: (path, options) => fs.mkdir(path, options),
+        async readFile(path) { return new TextDecoder("utf-8", { ignoreBOM: true }).decode(await fs.readFile(path)); },
+        async readdir(path) { return (await fs.readdir(path)).map(entry => entry.name); },
+        rename: (from, to) => fs.rename(from, to),
+        async rmdir(path) {
+            if (!fs.rmdir)
+                throw new Error("Task lists require filesystem rmdir support.");
+            await fs.rmdir(path);
+        },
+        async stat(path) {
+            const stat = await fs.stat(path);
+            return { isDirectory: () => stat.type === "directory", isFile: () => stat.type === "file", mtimeMs: stat.mtimeMs };
+        },
+        async unlink(path) {
+            if (!fs.unlink)
+                throw new Error("Task lists require filesystem unlink support.");
+            await fs.unlink(path);
+        },
+        async writeFile(path, data, options) {
+            const flag = typeof options === "object" ? options.flag : undefined;
+            if (flag !== undefined && flag !== "w" && flag !== "wx" && flag !== "a" && flag !== "ax")
+                throw new Error("Unsupported task-list write flag.");
+            await fs.writeFile(path, typeof data === "string" ? new TextEncoder().encode(data) : data, { flag });
+        }
+    };
+}

package/node_modules/toolcraft/node_modules/@poe-code/task-list/dist/move.js

@@ -1,5 +1,5 @@
-import * as fsPromises from "node:fs/promises";
-import path from "node:path";
+import { taskListFileSystem } from "./filesystem.js";
+import { path } from "./paths.js";
 import { findEvent } from "./state-machine.js";
 import { openTaskList } from "./open.js";
 export async function moveTasks(options) {
@@ -127,7 +127,7 @@ function readOnlyTargetOptions(options, dryRun) {
     return {
         ...options,
         create: true,
-        fs: createDryRunFs(options.fs ?? fsPromises, options.path, options.type)
+        fs: createDryRunFs(taskListFileSystem(options.fs), options.path, options.type)
     };
 }
 function createDryRunFs(fs, targetPath, targetType) {

package/node_modules/toolcraft/node_modules/@poe-code/task-list/dist/open.js

@@ -1,4 +1,4 @@
-import * as fsPromises from "node:fs/promises";
+import { taskListFileSystem } from "./filesystem.js";
 import { ghIssuesBackend } from "./backends/gh-issues.js";
 import { resolveAuth, resolveEndpoint } from "./backends/gh-issues-client.js";
 import { markdownDirBackend } from "./backends/markdown-dir.js";
@@ -9,9 +9,6 @@ export const backendFactories = {
     "markdown-dir": markdownDirBackend,
     "yaml-file": yamlFileBackend
 };
-function createDefaultFs() {
-    return fsPromises;
-}
 export async function openTaskList(options) {
     const type = getOwnProperty(options, "type");
     switch (type) {
@@ -43,7 +40,7 @@ async function openFileBackend(options) {
             ? "strict"
             : (getOwnProperty(markdownOptions, "frontmatterMode") ?? "strict"),
         create: getOwnProperty(options, "create") ?? false,
-        fs: getOwnProperty(options, "fs") ?? createDefaultFs(),
+        fs: taskListFileSystem(getOwnProperty(options, "fs")),
         stateMachine
     };
     return factory(deps);

package/node_modules/toolcraft/node_modules/@poe-code/task-list/dist/paths.d.ts

@@ -0,0 +1,12 @@
+export declare const path: {
+    resolve(...parts: string[]): string;
+    basename: typeof import("@poe-code/safe-fs/contracts").basename;
+    dirname: typeof import("packages/safe-fs/dist/contracts/virtual-path.js").dirname;
+    extname: typeof import("@poe-code/safe-fs/contracts").extname;
+    join: typeof import("@poe-code/safe-fs/contracts").joinPath;
+    isAbsolute: typeof import("@poe-code/safe-fs/contracts").isAbsolutePath;
+    normalize: typeof import("@poe-code/safe-fs/contracts").joinPath;
+    relative: (from: string, to: string) => string;
+    sep: "/";
+    delimiter: ":";
+};

package/node_modules/toolcraft/node_modules/@poe-code/task-list/dist/paths.js

@@ -0,0 +1,7 @@
+import { posixPath } from "@poe-code/safe-fs/contracts";
+export const path = {
+    ...posixPath,
+    resolve(...parts) {
+        return posixPath.resolve(globalThis.process?.cwd?.() ?? "/", ...parts);
+    }
+};

package/node_modules/toolcraft/node_modules/@poe-code/task-list/dist/schema/ids.d.ts

@@ -0,0 +1,2 @@
+export declare const STORE_SCHEMA_ID = "https://poe-platform.github.io/poe-code/schemas/task-list/store.schema.json";
+export declare const TASK_SCHEMA_ID = "https://poe-platform.github.io/poe-code/schemas/task-list/task.schema.json";

package/node_modules/toolcraft/node_modules/@poe-code/task-list/dist/schema/ids.js

@@ -0,0 +1,6 @@
+// Kept in sync with the sibling *.schema.json files by ids.test.ts. Inlined as
+// constants so every artifact surface (tsc dist, esbuild bundles) works without
+// runtime file lookups, and without JSON import attributes — a syntax error
+// before Node 18.20 despite the >=18.18 engines floor (#517).
+export const STORE_SCHEMA_ID = "https://poe-platform.github.io/poe-code/schemas/task-list/store.schema.json";
+export const TASK_SCHEMA_ID = "https://poe-platform.github.io/poe-code/schemas/task-list/task.schema.json";

package/node_modules/toolcraft/node_modules/@poe-code/task-list/dist/types.d.ts

@@ -1,3 +1,4 @@
+import type { FileSystem } from "@poe-code/safe-fs/contracts";
 import type { StateMachineDef } from "./state-machine.js";
 export type TaskState = "draft" | "planned" | "in-progress" | "done" | "archived";
 export interface Task {
@@ -70,17 +71,18 @@ export interface TaskListFs {
     mkdir(path: string, options?: {
         recursive?: boolean;
     }): Promise<void>;
-    readFile(path: string, encoding: BufferEncoding): Promise<string>;
+    readFile(path: string, encoding: "utf8"): Promise<string>;
     readdir(path: string): Promise<string[]>;
     rename(fromPath: string, toPath: string): Promise<void>;
+    rmdir(path: string): Promise<void>;
     stat(path: string): Promise<{
         isDirectory(): boolean;
         isFile(): boolean;
         mtimeMs: number;
     }>;
     unlink(path: string): Promise<void>;
-    writeFile(path: string, data: string | NodeJS.ArrayBufferView, options?: BufferEncoding | {
-        encoding?: BufferEncoding;
+    writeFile(path: string, data: string | Uint8Array, options?: "utf8" | {
+        encoding?: "utf8";
         flag?: string;
     }): Promise<void>;
 }
@@ -131,7 +133,7 @@ export interface OpenMarkdownDirOptions {
     create?: boolean;
     singleList?: string;
     frontmatterMode?: "strict" | "passthrough";
-    fs?: TaskListFs;
+    fs?: TaskListFs | FileSystem;
     stateMachine?: StateMachineDef;
 }
 export interface OpenYamlFileOptions {
@@ -139,7 +141,7 @@ export interface OpenYamlFileOptions {
     path: string;
     defaults?: TaskDefaults;
     create?: boolean;
-    fs?: TaskListFs;
+    fs?: TaskListFs | FileSystem;
     stateMachine?: StateMachineDef;
 }
 export interface OpenGhIssuesOptions {

package/node_modules/toolcraft/node_modules/@poe-code/task-list/package.json

@@ -1,7 +1,6 @@
 {
-  "name": "@poe-code/task-list",
-  "version": "0.0.1",
   "private": true,
+  "license": "MIT",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,9 +16,21 @@
     "test:unit": "cd ../.. && vitest run packages/task-list/src"
   },
   "files": [
-    "dist"
+    "dist",
+    "LICENSE"
   ],
-  "dependencies": {
-    "yaml": "*"
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/poe-platform/poe-code.git",
+    "directory": "packages/task-list"
+  },
+  "imports": {
+    "#task-list-host": {
+      "types": "./src/default-host.ts",
+      "workerd": "./dist/default-host.workerd.js",
+      "browser": "./dist/default-host.workerd.js",
+      "worker": "./dist/default-host.workerd.js",
+      "default": "./dist/default-host.js"
+    }
   }
 }

package/node_modules/toolcraft/node_modules/@poe-code/terminal-text/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Poe Platform
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/node_modules/toolcraft/node_modules/@poe-code/terminal-text/README.md

@@ -0,0 +1,12 @@
+# Terminal text
+
+Make untrusted text safe to display in terminal fields without dropping characters.
+Works in browsers, Workers and Node.js with no runtime dependencies.
+
+```ts
+import { escapeTerminalText } from "@poe-code/terminal-text";
+
+escapeTerminalText("Résumé 日本語"); // ordinary Unicode is unchanged
+```
+
+Control characters and bidirectional formatting marks become visible Unicode escapes.

package/node_modules/toolcraft/node_modules/@poe-code/terminal-text/dist/index.d.ts

@@ -0,0 +1,2 @@
+/** Makes untrusted text safe to embed in a human-readable terminal field. */
+export declare function escapeTerminalText(text: string): string;

package/node_modules/toolcraft/node_modules/@poe-code/terminal-text/dist/index.js

@@ -0,0 +1,20 @@
+/** Makes untrusted text safe to embed in a human-readable terminal field. */
+export function escapeTerminalText(text) {
+    let result = "";
+    for (const character of text) {
+        const code = character.codePointAt(0);
+        if (code <= 0x1f ||
+            (code >= 0x7f && code <= 0x9f) ||
+            code === 0x061c ||
+            code === 0x200e ||
+            code === 0x200f ||
+            (code >= 0x202a && code <= 0x202e) ||
+            (code >= 0x2066 && code <= 0x2069)) {
+            result += `\\u${code.toString(16).padStart(4, "0")}`;
+        }
+        else {
+            result += character;
+        }
+    }
+    return result;
+}

package/node_modules/toolcraft/node_modules/@poe-code/terminal-text/package.json

@@ -0,0 +1,22 @@
+{
+  "private": true,
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "node ../../scripts/guard-package-dist.mjs && tsc",
+    "test:unit": "cd ../.. && vitest run packages/terminal-text",
+    "lint": "eslint src && tsc --noEmit"
+  }
+}