@silvermoon-work/task-builder-cli 0.0.0 → 0.1.0-canary-261109-1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 silvermoon-work contributors
+
+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/README.md

@@ -1,3 +1,140 @@
 # @silvermoon-work/task-builder-cli
 
-Bootstrap placeholder package. The real CLI for composing and configuring generic task pipelines lives in [silvermoon-work/task-engine](https://github.com/silvermoon-work/task-engine).
+Independent Commander 14 CLI and reusable command runner for
+[@silvermoon-work/task-builder](../task-builder/README.md).
+The core owns read-only tree transformations; this package owns argument parsing,
+help, version, output rendering, host paths, file writes and executable signals.
+It does not implement bundling or CAR encoding itself.
+
+This package and the extracted core APIs are **not yet published**. The old
+`task-builder@0.1.0-canary-261109-1` binary is not this CLI. Use the
+[two-tarball development workflow](../../docs/end-to-end-verification.md) until
+explicitly authorized releases are available.
+
+## Commands
+
+```text
+task-builder init <new-directory> [--name <name>] [--cli-version <specifier>] [--builder-version <specifier>]
+task-builder build <task.build.yaml> [--root <directory>] [--trusted-contract]
+task-builder car <bundle-directory> <output.car> [--cid-file <output.cid>]
+task-builder check <bundle.car> [--expected-cid <cid>]
+```
+
+The original `task-builder <task.build.yaml> [build options]` shorthand is
+Commander's default build command, not a second hand-written parser.
+
+```text
+task-builder --help
+task-builder build --help
+task-builder help car
+task-builder --version
+task-builder check bundle.car --format text
+task-builder --format json check bundle.car
+```
+
+Commander provides required arguments, allowed choices, option parsing and help.
+Duplicate options are rejected through Commander option events.
+`--format json|text` works before or after a subcommand. Results/errors default
+to JSON for compatibility with the original CLI; `--format text` selects
+human-readable summaries. Help/version remain text.
+
+Success result shapes are unchanged:
+
+| Command | JSON result |
+| --- | --- |
+| init | `{ directory, files, nextSteps }` |
+| build | `{ directory, files }` |
+| car | `{ car, cid, cidFile? }` |
+| check | `{ cid, declaration, bytes, files }` |
+
+Failures go to stderr, never success-shaped stdout. JSON errors use
+`{ error: { code, message } }`. Exit codes are 0 for success/help/version,
+2 for Commander usage errors, 1 for operation errors, 130 for SIGINT and
+143 for SIGTERM. There is no automatic install, overwrite, upload, pin or publish.
+
+## Init composition
+
+Core init returns a package-manager-neutral template tree with Task sources,
+JSON contract, shared text Schema, greeting resource and private SDK package.
+The CLI adds:
+
+- build/CAR/check npm scripts referencing the `task-builder` binary;
+- direct dev dependencies on **both** CLI and core;
+- the pnpm version, scoped esbuild approval and release-age exceptions.
+
+Default CLI/core versions come from the installed package metadata, not a moving
+`canary` tag. `--cli-version` selects the CLI dependency. An explicit
+`--builder-version` also adds a scoped pnpm override so a local core tarball is
+used by the CLI's transitive dependency as well. This is useful before publication
+and avoids accidentally mixing the new CLI with the old published core.
+The override and scoped release-age exceptions live in `pnpm-workspace.yaml`,
+not the obsolete `package.json#pnpm` configuration. Exemptions use selected
+package names, so local `file:` specs are not incorrectly treated as npm versions.
+
+Init only writes into a new directory whose parent exists and is canonical.
+It does not merge with an existing project or modify an ancestor package.
+`--name` defaults to `task-project`. Additional Task template settings are
+available through the library's `createCliTaskProject` options, not new CLI flags.
+
+## Reusable runner
+
+```ts
+import { runTaskBuilderCli } from "@silvermoon-work/task-builder-cli";
+
+const exitCode = await runTaskBuilderCli(
+  ["build", "task.build.yaml", "--format", "json"],
+  {
+    cwd: projectDirectory,
+    signal,
+    stdout: { write: (text) => output.write(text) },
+    stderr: { write: (text) => diagnostics.write(text) },
+  },
+);
+```
+
+Each invocation has its own Commander instance and returns an exit code.
+Importing the library does not run a command, change `process.exitCode`, install
+signal handlers or start a service. Programmatic abort returns 130; only `bin.js`
+owns process SIGINT/SIGTERM and their corresponding executable exit codes.
+`createCliTaskProject(options)` can be used independently to decorate a template
+without writing it to disk or installing packages.
+
+## Node adapters
+
+```ts
+import { buildTaskBundle } from "@silvermoon-work/task-builder";
+import {
+  directoryTree,
+  writeDirectory,
+  writeStreamFile,
+} from "@silvermoon-work/task-builder-cli/node";
+
+const input = await directoryTree(projectDirectory);
+const output = await buildTaskBundle(input, options);
+await writeDirectory(output, newOutputDirectory);
+```
+
+The directory adapter is a live view, not an atomic snapshot or OS sandbox.
+Confined links support pnpm's virtual store; escaping links and special files
+are rejected. Writes use backpressure, cancellation and exclusive file creation.
+Only newly created files/directories are removed on failure; existing output
+is never overwritten. CAR and CID paths cannot be inside the Bundle directory
+or equal each other. A failed CID sidecar write removes the newly created CAR.
+
+## Repository development
+
+```text
+pnpm --filter @silvermoon-work/task-builder-cli... build
+node packages/task-builder-cli/dist/bin.js --help
+node packages/task-builder-cli/dist/bin.js build packages/task-builder/examples/echo/task.build.yaml
+pnpm --filter @silvermoon-work/task-builder-cli test
+pnpm check
+```
+
+The example build fails explicitly if its output already exists.
+CLI and core are separately mapped publishable libraries. Publish the exact
+core dependency before tagging this CLI; this package needs its own npm package
+identity and Trusted Publisher configuration. No release is performed by build.
+The modified core must receive a new version first: do not publish this CLI
+against the old `task-builder@0.1.0-canary-261109-1`, which lacks `./tree` and
+the current init/CAR APIs.

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import { runTaskBuilderCli } from "./index.js";
+const controller = new AbortController();
+let interrupted;
+const interrupt = () => {
+    interrupted = 130;
+    controller.abort(new Error("Task builder interrupted by SIGINT."));
+};
+const terminate = () => {
+    interrupted = 143;
+    controller.abort(new Error("Task builder interrupted by SIGTERM."));
+};
+process.once("SIGINT", interrupt);
+process.once("SIGTERM", terminate);
+try {
+    const code = await runTaskBuilderCli(process.argv.slice(2), { signal: controller.signal });
+    process.exitCode = interrupted ?? code;
+}
+finally {
+    process.removeListener("SIGINT", interrupt);
+    process.removeListener("SIGTERM", terminate);
+}
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;AACzC,IAAI,WAA+B,CAAC;AACpC,MAAM,SAAS,GAAG,GAAG,EAAE;IACrB,WAAW,GAAG,GAAG,CAAC;IAClB,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC,CAAC;AACrE,CAAC,CAAC;AACF,MAAM,SAAS,GAAG,GAAG,EAAE;IACrB,WAAW,GAAG,GAAG,CAAC;IAClB,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC,CAAC;AACtE,CAAC,CAAC;AACF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAClC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AACnC,IAAI,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3F,OAAO,CAAC,QAAQ,GAAG,WAAW,IAAI,IAAI,CAAC;AACzC,CAAC;QAAS,CAAC;IACT,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC5C,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AAC/C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import { type ReadOptions } from "@silvermoon-work/task-builder/tree";
+export { createCliTaskProject, type CliTaskProjectOptions } from "./project.js";
+export interface CliWriter {
+    write(text: string): void | boolean;
+}
+export interface TaskBuilderCliOptions extends ReadOptions {
+    readonly cwd?: string;
+    readonly stdout?: CliWriter;
+    readonly stderr?: CliWriter;
+}
+/** Run one invocation without starting listeners, installing signal handlers or exiting the process. */
+export declare function runTaskBuilderCli(argv: readonly string[], options?: TaskBuilderCliOptions): Promise<number>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAIlF,OAAO,EAAE,oBAAoB,EAAE,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAEhF,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC;CACrC;AACD,MAAM,WAAW,qBAAsB,SAAQ,WAAW;IACxD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;CAC7B;AAuBD,wGAAwG;AACxG,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,MAAM,CAAC,CAsNjB"}

package/dist/index.js

@@ -0,0 +1,191 @@
+import { basename, dirname, isAbsolute, relative, resolve, sep } from "node:path";
+import { unlink } from "node:fs/promises";
+import { Command, CommanderError, InvalidArgumentError, Option } from "commander";
+import { memoryFile } from "@silvermoon-work/task-builder/tree";
+import { directoryTree, writeDirectory, writeStreamFile } from "./node.js";
+import { cliVersion, createCliTaskProject } from "./project.js";
+export { createCliTaskProject } from "./project.js";
+function singleOption(command, option) {
+    let seen = false;
+    command.addOption(option);
+    command.on(`option:${option.name()}`, () => {
+        if (seen)
+            throw new InvalidArgumentError(`Duplicate option --${option.name()}.`);
+        seen = true;
+    });
+}
+/** Run one invocation without starting listeners, installing signal handlers or exiting the process. */
+export async function runTaskBuilderCli(argv, options = {}) {
+    const stdout = options.stdout ?? process.stdout;
+    const stderr = options.stderr ?? process.stderr;
+    const cwd = resolve(options.cwd ?? process.cwd());
+    const readOptions = options.signal ? { signal: options.signal } : {};
+    let diagnostics = "";
+    const program = new Command();
+    let activeCommand = program;
+    const render = (command, result, text) => {
+        stdout.write(command.optsWithGlobals().format === "text"
+            ? `${text}\n`
+            : `${JSON.stringify(result)}\n`);
+    };
+    const formatOption = () => new Option("--format <format>", "Output format for results and errors").choices([
+        "json",
+        "text",
+    ]);
+    const buildOptions = (command) => {
+        singleOption(command, new Option("--root <directory>", "Read-only input root (default: current directory)"));
+        singleOption(command, new Option("--trusted-contract", "Allow execution of trusted code contracts"));
+    };
+    const build = async (config, command) => {
+        const flags = command.optsWithGlobals();
+        const root = resolve(cwd, flags.root ?? cwd);
+        const input = await directoryTree(root);
+        const file = (isAbsolute(config) ? relative(root, config) : config).split(sep).join("/");
+        const { buildTaskBundle, readTaskBuild } = await import("@silvermoon-work/task-builder");
+        const definition = await readTaskBuild(input, file, {
+            ...readOptions,
+            allowContractExecution: flags.trustedContract === true,
+        });
+        const tree = await buildTaskBundle(input, definition.options);
+        const directory = resolve(root, ...definition.outDirectory.split("/"));
+        const files = await writeDirectory(tree, directory, readOptions);
+        render(command, { directory, files }, `Built ${files.length} files into ${directory}`);
+    };
+    try {
+        options.signal?.throwIfAborted();
+        program
+            .name("task-builder")
+            .description("Initialize, build, encode and verify Task Bundles using read-only file trees.")
+            .version(await cliVersion(), "-v, --version")
+            .exitOverride()
+            .configureOutput({
+            writeOut: (text) => {
+                stdout.write(text);
+            },
+            writeErr: (text) => {
+                diagnostics += text;
+            },
+        });
+        program.addHelpText("after", "\nLegacy shorthand: task-builder <task.build.yaml> [build options]");
+        program.hook("preSubcommand", (_parent, command) => {
+            activeCommand = command;
+        });
+        singleOption(program, formatOption().default("json"));
+        const init = program
+            .command("init")
+            .description("Create a new task project; never install, overwrite or edit ancestor packages.")
+            .argument("<directory>", "New project directory (parent must exist)");
+        singleOption(init, formatOption());
+        singleOption(init, new Option("--name <name>", "Lowercase npm project name").default("task-project"));
+        singleOption(init, new Option("--cli-version <specifier>", "CLI dependency specifier (default: installed CLI version)"));
+        singleOption(init, new Option("--builder-version <specifier>", "Select and override the core builder dependency (default: installed version)"));
+        init.action(async (directory, _flags, command) => {
+            const flags = command.optsWithGlobals();
+            const tree = await createCliTaskProject({
+                ...(flags.name !== undefined ? { name: flags.name } : {}),
+                ...(flags.cliVersion !== undefined ? { cliVersion: flags.cliVersion } : {}),
+                ...(flags.builderVersion !== undefined ? { builderVersion: flags.builderVersion } : {}),
+            });
+            const output = resolve(cwd, directory);
+            const files = await writeDirectory(tree, output, readOptions);
+            const nextSteps = ["pnpm install", "pnpm build", "pnpm car", "pnpm check"];
+            render(command, { directory: output, files, nextSteps }, `Created ${output}\nNext: enter that directory and run ${nextSteps.join(", ")}`);
+        });
+        const buildCommand = program
+            .command("build", { isDefault: true })
+            .description("Compile a task build declaration into a new Bundle directory.")
+            .argument("<config>", "Build YAML path within --root");
+        singleOption(buildCommand, formatOption());
+        buildOptions(buildCommand);
+        buildCommand.action(async (config, _flags, command) => build(config, command));
+        const car = program
+            .command("car")
+            .description("Stream a canonical CAR v1 from a Bundle directory with bounded block staging.")
+            .argument("<directory>", "Input Bundle directory")
+            .argument("<output>", "New CAR output file");
+        singleOption(car, formatOption());
+        singleOption(car, new Option("--cid-file <path>", "Also write the root CID into a new file"));
+        car.action(async (directory, output, _flags, command) => {
+            const flags = command.optsWithGlobals();
+            const input = resolve(cwd, directory);
+            const destination = resolve(cwd, output);
+            const cidFile = flags.cidFile === undefined ? undefined : resolve(cwd, flags.cidFile);
+            if (cidFile === destination)
+                throw new Error("CAR and CID output paths must differ.");
+            for (const path of [destination, ...(cidFile === undefined ? [] : [cidFile])]) {
+                const distance = relative(input, path);
+                if (!distance ||
+                    (distance !== ".." && !distance.startsWith(`..${sep}`) && !distance.includes(":")))
+                    throw new Error("CAR outputs must not be inside the input Bundle directory.");
+            }
+            const { encodeTaskBundleCar } = await import("@silvermoon-work/task-builder/car");
+            const archive = await encodeTaskBundleCar(await directoryTree(input), readOptions);
+            let installed = false;
+            try {
+                await writeStreamFile(archive.stream, destination, readOptions);
+                installed = true;
+                if (cidFile !== undefined)
+                    await writeStreamFile(memoryFile(Buffer.from(`${archive.cid}\n`), readOptions), cidFile, readOptions);
+                render(command, { car: destination, cid: archive.cid, ...(cidFile !== undefined ? { cidFile } : {}) }, `Wrote ${destination}\nRoot CID: ${archive.cid}`);
+            }
+            catch (error) {
+                if (installed)
+                    await unlink(destination);
+                throw error;
+            }
+            finally {
+                await archive.close();
+            }
+        });
+        const check = program
+            .command("check")
+            .description("Verify a complete CAR, canonical file tree, manifest, Schemas and resource bytes.")
+            .argument("<car>", "CAR file to inspect");
+        singleOption(check, formatOption());
+        singleOption(check, new Option("--expected-cid <cid>", "Require this exact Bundle root CID"));
+        check.action(async (carFile, _flags, command) => {
+            const flags = command.optsWithGlobals();
+            const path = resolve(cwd, carFile);
+            const input = await directoryTree(dirname(path));
+            const { readTaskBundleCar } = await import("@silvermoon-work/task-builder/car");
+            const archive = await readTaskBundleCar(await input.read(basename(path), readOptions), {
+                ...readOptions,
+                ...(flags.expectedCid !== undefined ? { expectedCid: flags.expectedCid } : {}),
+            });
+            try {
+                render(command, {
+                    cid: archive.cid,
+                    declaration: archive.declaration,
+                    bytes: archive.bytes,
+                    files: archive.files,
+                }, `Verified ${archive.files} files (${archive.bytes} bytes)\nRoot CID: ${archive.cid}`);
+            }
+            finally {
+                await archive.close();
+            }
+        });
+        if (argv.length === 0)
+            program.outputHelp();
+        else
+            await program.parseAsync([...argv], { from: "user" });
+        return 0;
+    }
+    catch (error) {
+        if (error instanceof CommanderError && error.exitCode === 0)
+            return 0;
+        const usage = error instanceof CommanderError;
+        const code = usage
+            ? "invalid_arguments"
+            : error instanceof Error && "code" in error && typeof error.code === "string"
+                ? error.code
+                : options.signal?.aborted
+                    ? "interrupted"
+                    : "operation_failed";
+        const message = diagnostics.trim() || (error instanceof Error ? error.message : String(error));
+        stderr.write(activeCommand.optsWithGlobals().format === "text"
+            ? `${message}\n`
+            : `${JSON.stringify({ error: { code, message } })}\n`);
+        return options.signal?.aborted ? 130 : usage ? 2 : 1;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAClF,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAClF,OAAO,EAAE,UAAU,EAAoB,MAAM,oCAAoC,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,oBAAoB,EAA8B,MAAM,cAAc,CAAC;AAuBhF,SAAS,YAAY,CAAC,OAAgB,EAAE,MAAc;IACpD,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,CAAC,EAAE,CAAC,UAAU,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE;QACzC,IAAI,IAAI;YAAE,MAAM,IAAI,oBAAoB,CAAC,sBAAsB,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACjF,IAAI,GAAG,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED,wGAAwG;AACxG,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAuB,EACvB,UAAiC,EAAE;IAEnC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAChD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAChD,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAClD,MAAM,WAAW,GAAgB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAClF,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAC9B,IAAI,aAAa,GAAG,OAAO,CAAC;IAC5B,MAAM,MAAM,GAAG,CAAC,OAAgB,EAAE,MAAc,EAAE,IAAY,EAAE,EAAE;QAChE,MAAM,CAAC,KAAK,CACV,OAAO,CAAC,eAAe,EAAe,CAAC,MAAM,KAAK,MAAM;YACtD,CAAC,CAAC,GAAG,IAAI,IAAI;YACb,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAClC,CAAC;IACJ,CAAC,CAAC;IACF,MAAM,YAAY,GAAG,GAAG,EAAE,CACxB,IAAI,MAAM,CAAC,mBAAmB,EAAE,sCAAsC,CAAC,CAAC,OAAO,CAAC;QAC9E,MAAM;QACN,MAAM;KACP,CAAC,CAAC;IACL,MAAM,YAAY,GAAG,CAAC,OAAgB,EAAE,EAAE;QACxC,YAAY,CACV,OAAO,EACP,IAAI,MAAM,CAAC,oBAAoB,EAAE,mDAAmD,CAAC,CACtF,CAAC;QACF,YAAY,CACV,OAAO,EACP,IAAI,MAAM,CAAC,oBAAoB,EAAE,2CAA2C,CAAC,CAC9E,CAAC;IACJ,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,KAAK,EAAE,MAAc,EAAE,OAAgB,EAAE,EAAE;QACvD,MAAM,KAAK,GAAG,OAAO,CAAC,eAAe,EAAc,CAAC;QACpD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzF,MAAM,EAAE,eAAe,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,+BAA+B,CAAC,CAAC;QACzF,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE;YAClD,GAAG,WAAW;YACd,sBAAsB,EAAE,KAAK,CAAC,eAAe,KAAK,IAAI;SACvD,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;QAC9D,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QACvE,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QACjE,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,SAAS,KAAK,CAAC,MAAM,eAAe,SAAS,EAAE,CAAC,CAAC;IACzF,CAAC,CAAC;IACF,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;QACjC,OAAO;aACJ,IAAI,CAAC,cAAc,CAAC;aACpB,WAAW,CAAC,+EAA+E,CAAC;aAC5F,OAAO,CAAC,MAAM,UAAU,EAAE,EAAE,eAAe,CAAC;aAC5C,YAAY,EAAE;aACd,eAAe,CAAC;YACf,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;gBACjB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;YACD,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;gBACjB,WAAW,IAAI,IAAI,CAAC;YACtB,CAAC;SACF,CAAC,CAAC;QACL,OAAO,CAAC,WAAW,CACjB,OAAO,EACP,oEAAoE,CACrE,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;YACjD,aAAa,GAAG,OAAO,CAAC;QAC1B,CAAC,CAAC,CAAC;QACH,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,OAAO;aACjB,OAAO,CAAC,MAAM,CAAC;aACf,WAAW,CAAC,gFAAgF,CAAC;aAC7F,QAAQ,CAAC,aAAa,EAAE,2CAA2C,CAAC,CAAC;QACxE,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QACnC,YAAY,CACV,IAAI,EACJ,IAAI,MAAM,CAAC,eAAe,EAAE,4BAA4B,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAClF,CAAC;QACF,YAAY,CACV,IAAI,EACJ,IAAI,MAAM,CACR,2BAA2B,EAC3B,2DAA2D,CAC5D,CACF,CAAC;QACF,YAAY,CACV,IAAI,EACJ,IAAI,MAAM,CACR,+BAA+B,EAC/B,8EAA8E,CAC/E,CACF,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,SAAiB,EAAE,MAAe,EAAE,OAAgB,EAAE,EAAE;YACzE,MAAM,KAAK,GAAG,OAAO,CAAC,eAAe,EAAa,CAAC;YACnD,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC;gBACtC,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzD,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3E,GAAG,CAAC,KAAK,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxF,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YACvC,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;YAC9D,MAAM,SAAS,GAAG,CAAC,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;YAC3E,MAAM,CACJ,OAAO,EACP,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,EACvC,WAAW,MAAM,wCAAwC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChF,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,MAAM,YAAY,GAAG,OAAO;aACzB,OAAO,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;aACrC,WAAW,CAAC,+DAA+D,CAAC;aAC5E,QAAQ,CAAC,UAAU,EAAE,+BAA+B,CAAC,CAAC;QACzD,YAAY,CAAC,YAAY,EAAE,YAAY,EAAE,CAAC,CAAC;QAC3C,YAAY,CAAC,YAAY,CAAC,CAAC;QAC3B,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,MAAe,EAAE,OAAgB,EAAE,EAAE,CAC9E,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CACvB,CAAC;QACF,MAAM,GAAG,GAAG,OAAO;aAChB,OAAO,CAAC,KAAK,CAAC;aACd,WAAW,CAAC,+EAA+E,CAAC;aAC5F,QAAQ,CAAC,aAAa,EAAE,wBAAwB,CAAC;aACjD,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;QAC/C,YAAY,CAAC,GAAG,EAAE,YAAY,EAAE,CAAC,CAAC;QAClC,YAAY,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC,mBAAmB,EAAE,yCAAyC,CAAC,CAAC,CAAC;QAC9F,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,SAAiB,EAAE,MAAc,EAAE,MAAe,EAAE,OAAgB,EAAE,EAAE;YACxF,MAAM,KAAK,GAAG,OAAO,CAAC,eAAe,EAAsC,CAAC;YAC5E,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YACtC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACzC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACtF,IAAI,OAAO,KAAK,WAAW;gBAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;YACtF,KAAK,MAAM,IAAI,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9E,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;gBACvC,IACE,CAAC,QAAQ;oBACT,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;oBAElF,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;YAClF,CAAC;YACD,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,mCAAmC,CAAC,CAAC;YAClF,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,MAAM,aAAa,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC;YACnF,IAAI,SAAS,GAAG,KAAK,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,eAAe,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;gBAChE,SAAS,GAAG,IAAI,CAAC;gBACjB,IAAI,OAAO,KAAK,SAAS;oBACvB,MAAM,eAAe,CACnB,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,WAAW,CAAC,EACxD,OAAO,EACP,WAAW,CACZ,CAAC;gBACJ,MAAM,CACJ,OAAO,EACP,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EACrF,SAAS,WAAW,eAAe,OAAO,CAAC,GAAG,EAAE,CACjD,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,SAAS;oBAAE,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;gBACzC,MAAM,KAAK,CAAC;YACd,CAAC;oBAAS,CAAC;gBACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACxB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,OAAO;aAClB,OAAO,CAAC,OAAO,CAAC;aAChB,WAAW,CACV,mFAAmF,CACpF;aACA,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;QAC5C,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;QACpC,YAAY,CAAC,KAAK,EAAE,IAAI,MAAM,CAAC,sBAAsB,EAAE,oCAAoC,CAAC,CAAC,CAAC;QAC9F,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,OAAe,EAAE,MAAe,EAAE,OAAgB,EAAE,EAAE;YACxE,MAAM,KAAK,GAAG,OAAO,CAAC,eAAe,EAA0C,CAAC;YAChF,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YACnC,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YACjD,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,mCAAmC,CAAC,CAAC;YAChF,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,EAAE;gBACrF,GAAG,WAAW;gBACd,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/E,CAAC,CAAC;YACH,IAAI,CAAC;gBACH,MAAM,CACJ,OAAO,EACP;oBACE,GAAG,EAAE,OAAO,CAAC,GAAG;oBAChB,WAAW,EAAE,OAAO,CAAC,WAAW;oBAChC,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,KAAK,EAAE,OAAO,CAAC,KAAK;iBACrB,EACD,YAAY,OAAO,CAAC,KAAK,WAAW,OAAO,CAAC,KAAK,sBAAsB,OAAO,CAAC,GAAG,EAAE,CACrF,CAAC;YACJ,CAAC;oBAAS,CAAC;gBACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACxB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,UAAU,EAAE,CAAC;;YACvC,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3D,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,cAAc,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QACtE,MAAM,KAAK,GAAG,KAAK,YAAY,cAAc,CAAC;QAC9C,MAAM,IAAI,GAAG,KAAK;YAChB,CAAC,CAAC,mBAAmB;YACrB,CAAC,CAAC,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;gBAC3E,CAAC,CAAC,KAAK,CAAC,IAAI;gBACZ,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO;oBACvB,CAAC,CAAC,aAAa;oBACf,CAAC,CAAC,kBAAkB,CAAC;QAC3B,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/F,MAAM,CAAC,KAAK,CACV,aAAa,CAAC,eAAe,EAAwB,CAAC,MAAM,KAAK,MAAM;YACrE,CAAC,CAAC,GAAG,OAAO,IAAI;YAChB,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,CACxD,CAAC;QACF,OAAO,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;AACH,CAAC"}

package/dist/node.d.ts

@@ -0,0 +1,8 @@
+import { type ReadonlyFileTree, type ReadOptions } from "@silvermoon-work/task-builder/tree";
+/** Consume one stream with backpressure; remove only the newly created file on failure. */
+export declare function writeStreamFile(stream: ReadableStream<Uint8Array>, file: string, options?: ReadOptions): Promise<void>;
+/** A live read-only view, not an atomic snapshot. Confined dependency links are followed. */
+export declare function directoryTree(directory: string): Promise<ReadonlyFileTree>;
+/** Write sequentially into a new directory; never replace an existing output. */
+export declare function writeDirectory(tree: ReadonlyFileTree, directory: string, options?: ReadOptions): Promise<readonly string[]>;
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAIA,OAAO,EAKL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAEjB,MAAM,oCAAoC,CAAC;AAS5C,2FAA2F;AAC3F,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAmCf;AAED,6FAA6F;AAC7F,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2ChF;AAED,iFAAiF;AACjF,wBAAsB,cAAc,CAClC,IAAI,EAAE,gBAAgB,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CA6C5B"}

package/dist/node.js

@@ -0,0 +1,148 @@
+import { constants } from "node:fs";
+import { mkdir, open, readdir, realpath, rmdir, stat, unlink } from "node:fs/promises";
+import { dirname, join, relative, resolve, sep } from "node:path";
+import { Readable } from "node:stream";
+import { checkTreePath, listTree, streamChunks, treeError, } from "@silvermoon-work/task-builder/tree";
+function inside(root, path) {
+    const distance = relative(root, path);
+    return (!distance || (!distance.startsWith(`..${sep}`) && distance !== ".." && !distance.includes(":")));
+}
+/** Consume one stream with backpressure; remove only the newly created file on failure. */
+export async function writeStreamFile(stream, file, options = {}) {
+    let handle;
+    try {
+        options.signal?.throwIfAborted();
+        handle = await open(file, "wx");
+    }
+    catch (error) {
+        await stream.cancel(error);
+        throw error;
+    }
+    try {
+        for await (const chunk of streamChunks(stream, options)) {
+            let offset = 0;
+            while (offset < chunk.byteLength) {
+                options.signal?.throwIfAborted();
+                const { bytesWritten } = await handle.write(chunk, offset);
+                if (!bytesWritten)
+                    throw new Error(`Output write made no progress: ${file}`);
+                offset += bytesWritten;
+            }
+        }
+        await handle.close();
+    }
+    catch (error) {
+        const errors = [error];
+        try {
+            await handle.close();
+        }
+        catch (cleanupError) {
+            errors.push(cleanupError);
+        }
+        try {
+            await unlink(file);
+        }
+        catch (cleanupError) {
+            errors.push(cleanupError);
+        }
+        if (errors.length > 1)
+            throw new AggregateError(errors, "Stream write and cleanup failed.");
+        throw error;
+    }
+}
+/** A live read-only view, not an atomic snapshot. Confined dependency links are followed. */
+export async function directoryTree(directory) {
+    const root = await realpath(resolve(directory));
+    if (!(await stat(root)).isDirectory())
+        throw treeError("ENOTDIR", root, "Input must be a directory");
+    const locate = async (path) => {
+        checkTreePath(path);
+        const target = await realpath(join(root, ...path.split("/")));
+        if (!inside(root, target))
+            throw treeError("EINVAL", path, "Link escapes input tree");
+        return target;
+    };
+    return Object.freeze({
+        async list(path, options = {}) {
+            options.signal?.throwIfAborted();
+            const entries = [];
+            for (const entry of await readdir(await locate(path), { withFileTypes: true })) {
+                options.signal?.throwIfAborted();
+                const child = path ? `${path}/${entry.name}` : entry.name;
+                const target = entry.isSymbolicLink() ? await locate(child) : undefined;
+                const info = target ? await stat(target) : entry;
+                if (!info.isFile() && !info.isDirectory())
+                    throw treeError("EINVAL", child, "Tree contains a special file");
+                entries.push({
+                    name: entry.name,
+                    kind: info.isDirectory() ? "directory" : "file",
+                    ...(target !== undefined ? { target: relative(root, target).split(sep).join("/") } : {}),
+                });
+            }
+            return entries.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+        },
+        async read(path, options = {}) {
+            options.signal?.throwIfAborted();
+            const target = await locate(path);
+            if (!(await stat(target)).isFile())
+                throw treeError("EISDIR", path, "Expected a regular file");
+            const handle = await open(target, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
+            return Readable.toWeb(handle.createReadStream({
+                highWaterMark: 65_536,
+                ...(options.signal ? { signal: options.signal } : {}),
+            }));
+        },
+    });
+}
+/** Write sequentially into a new directory; never replace an existing output. */
+export async function writeDirectory(tree, directory, options = {}) {
+    options.signal?.throwIfAborted();
+    const output = resolve(directory);
+    const parent = await realpath(dirname(output));
+    if (parent !== dirname(output))
+        throw new Error("Output parent must be canonical, without links.");
+    await mkdir(output, { recursive: false });
+    const files = [];
+    const directories = [output];
+    const write = async (path) => {
+        for (const entry of await listTree(tree, path, options)) {
+            options.signal?.throwIfAborted();
+            const child = path ? `${path}/${entry.name}` : entry.name;
+            const target = join(output, ...child.split("/"));
+            if (entry.kind === "directory") {
+                await mkdir(target);
+                directories.push(target);
+                await write(child);
+            }
+            else {
+                await writeStreamFile(await tree.read(child, options), target, options);
+                files.push(target);
+            }
+        }
+    };
+    try {
+        await write("");
+        return files.map((file) => relative(output, file).split(sep).join("/")).sort();
+    }
+    catch (error) {
+        const errors = [error];
+        for (const file of [...files].reverse())
+            try {
+                await unlink(file);
+            }
+            catch (cleanupError) {
+                errors.push(cleanupError);
+            }
+        for (const directory of [...directories].reverse())
+            try {
+                await rmdir(directory);
+            }
+            catch (cleanupError) {
+                errors.push(cleanupError);
+            }
+        if (errors.length > 1)
+            throw new AggregateError(errors, "Build failed and output cleanup failed.");
+        throw error;
+    }
+}
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

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

package/dist/project.d.ts

@@ -0,0 +1,10 @@
+import type { TaskProjectOptions } from "@silvermoon-work/task-builder/init";
+import { type ReadonlyFileTree } from "@silvermoon-work/task-builder/tree";
+export interface CliTaskProjectOptions extends TaskProjectOptions {
+    readonly cliVersion?: string;
+    readonly builderVersion?: string;
+}
+export declare function cliVersion(): Promise<string>;
+/** Add CLI scripts and installation policy to the core's package-manager-neutral template. */
+export declare function createCliTaskProject(options?: CliTaskProjectOptions): Promise<ReadonlyFileTree>;
+//# sourceMappingURL=project.d.ts.map

package/dist/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAML,KAAK,gBAAgB,EACtB,MAAM,oCAAoC,CAAC;AAE5C,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAiBD,wBAAgB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAK5C;AAED,8FAA8F;AAC9F,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,gBAAgB,CAAC,CAqE3B"}

package/dist/project.js

@@ -0,0 +1,81 @@
+import { readFile } from "node:fs/promises";
+import { fileTree, listTree, memoryFile, readBytes, } from "@silvermoon-work/task-builder/tree";
+async function packageVersion(url, name) {
+    const value = JSON.parse(await readFile(url, "utf8"));
+    if (!value ||
+        typeof value !== "object" ||
+        Array.isArray(value) ||
+        !("name" in value) ||
+        value.name !== name ||
+        !("version" in value) ||
+        typeof value.version !== "string")
+        throw new Error(`Invalid installed package metadata: ${name}`);
+    return value.version;
+}
+export function cliVersion() {
+    return packageVersion(new URL("../package.json", import.meta.url), "@silvermoon-work/task-builder-cli");
+}
+/** Add CLI scripts and installation policy to the core's package-manager-neutral template. */
+export async function createCliTaskProject(options = {}) {
+    const { cliVersion: selectedCliVersion, builderVersion: selectedBuilderVersion, ...coreOptions } = options;
+    const { createTaskProject } = await import("@silvermoon-work/task-builder/init");
+    const template = createTaskProject(coreOptions);
+    const cli = selectedCliVersion ?? (await cliVersion());
+    const builder = selectedBuilderVersion ??
+        (await packageVersion(new URL("../package.json", import.meta.resolve("@silvermoon-work/task-builder")), "@silvermoon-work/task-builder"));
+    for (const specifier of [cli, builder])
+        if (!specifier.trim() || [...specifier].some((char) => char.charCodeAt(0) < 32))
+            throw new Error("Dependency specifiers must be nonempty without control characters.");
+    const value = JSON.parse(Buffer.from(await readBytes(template, "package.json", 65_536)).toString());
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("Core template package.json must contain an object.");
+    const manifest = {
+        ...value,
+        packageManager: "pnpm@11.22.0",
+        scripts: {
+            build: "task-builder build task.build.yaml",
+            car: "task-builder car dist bundle.car --cid-file bundle.cid",
+            check: "task-builder check bundle.car",
+        },
+        devDependencies: {
+            "@silvermoon-work/task-builder-cli": cli,
+            "@silvermoon-work/task-builder": builder,
+        },
+    };
+    const readers = new Map();
+    const walk = async (path) => {
+        for (const entry of await listTree(template, path)) {
+            const child = path ? `${path}/${entry.name}` : entry.name;
+            if (entry.kind === "directory")
+                await walk(child);
+            else
+                readers.set(child, (readOptions) => template.read(child, readOptions));
+        }
+    };
+    await walk("");
+    const { stringify } = await import("yaml");
+    const files = new Map([
+        ["package.json", `${JSON.stringify(manifest, null, 2)}\n`],
+        [
+            "pnpm-workspace.yaml",
+            stringify({
+                allowBuilds: { esbuild: true },
+                ...(selectedBuilderVersion !== undefined
+                    ? { overrides: { "@silvermoon-work/task-builder": builder } }
+                    : {}),
+                minimumReleaseAgeExclude: [
+                    "@silvermoon-work/task-builder-cli",
+                    "@silvermoon-work/task-builder",
+                    "@potential-guide/task-sdk",
+                    "@potential-guide/task-protocol@0.1.0-rc.2",
+                ],
+            }),
+        ],
+    ]);
+    for (const [path, contents] of files) {
+        const bytes = Buffer.from(contents);
+        readers.set(path, (readOptions) => memoryFile(bytes, readOptions));
+    }
+    return fileTree(readers);
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,SAAS,GAGV,MAAM,oCAAoC,CAAC;AAO5C,KAAK,UAAU,cAAc,CAAC,GAAQ,EAAE,IAAY;IAClD,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/D,IACE,CAAC,KAAK;QACN,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC;QAClB,KAAK,CAAC,IAAI,KAAK,IAAI;QACnB,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC;QACrB,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QAEjC,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,EAAE,CAAC,CAAC;IACjE,OAAO,KAAK,CAAC,OAAO,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,cAAc,CACnB,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAC3C,mCAAmC,CACpC,CAAC;AACJ,CAAC;AAED,8FAA8F;AAC9F,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAAiC,EAAE;IAEnC,MAAM,EACJ,UAAU,EAAE,kBAAkB,EAC9B,cAAc,EAAE,sBAAsB,EACtC,GAAG,WAAW,EACf,GAAG,OAAO,CAAC;IACZ,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,oCAAoC,CAAC,CAAC;IACjF,MAAM,QAAQ,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,kBAAkB,IAAI,CAAC,MAAM,UAAU,EAAE,CAAC,CAAC;IACvD,MAAM,OAAO,GACX,sBAAsB;QACtB,CAAC,MAAM,cAAc,CACnB,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,+BAA+B,CAAC,CAAC,EAChF,+BAA+B,CAChC,CAAC,CAAC;IACL,KAAK,MAAM,SAAS,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC;QACpC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;YAC7E,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IAC1F,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAC/B,MAAM,CAAC,IAAI,CAAC,MAAM,SAAS,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAC1E,CAAC;IACF,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAG;QACf,GAAG,KAAK;QACR,cAAc,EAAE,cAAc;QAC9B,OAAO,EAAE;YACP,KAAK,EAAE,oCAAoC;YAC3C,GAAG,EAAE,wDAAwD;YAC7D,KAAK,EAAE,+BAA+B;SACvC;QACD,eAAe,EAAE;YACf,mCAAmC,EAAE,GAAG;YACxC,+BAA+B,EAAE,OAAO;SACzC;KACF,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC9C,MAAM,IAAI,GAAG,KAAK,EAAE,IAAY,EAAiB,EAAE;QACjD,KAAK,MAAM,KAAK,IAAI,MAAM,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;YACnD,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;YAC1D,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;gBAAE,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC;;gBAC7C,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC,CAAC;IACF,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC;QACpB,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;QAC1D;YACE,qBAAqB;YACrB,SAAS,CAAC;gBACR,WAAW,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;gBAC9B,GAAG,CAAC,sBAAsB,KAAK,SAAS;oBACtC,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,+BAA+B,EAAE,OAAO,EAAE,EAAE;oBAC7D,CAAC,CAAC,EAAE,CAAC;gBACP,wBAAwB,EAAE;oBACxB,mCAAmC;oBACnC,+BAA+B;oBAC/B,2BAA2B;oBAC3B,2CAA2C;iBAC5C;aACF,CAAC;SACH;KACF,CAAC,CAAC;IACH,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,KAAK,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC"}

package/package.json

@@ -1,14 +1,60 @@
 {
   "name": "@silvermoon-work/task-builder-cli",
-  "version": "0.0.0",
-  "description": "Command-line interface for composing and configuring generic task pipelines. Bootstrap placeholder only.",
+  "version": "0.1.0-canary-261109-1",
+  "description": "Commander-based Task Builder CLI and reusable command runner.",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js"
+    }
+  },
+  "bin": {
+    "task-builder": "./dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
   "license": "MIT",
+  "dependencies": {
+    "commander": "14.0.3",
+    "yaml": "2.9.1",
+    "@silvermoon-work/task-builder": "0.1.0-canary-261109-2"
+  },
+  "devDependencies": {
+    "@potential-guide/task-sdk": "0.1.0-rc.2",
+    "@silvermoon-work/task-protocol": "0.1.0-canary-261109-2"
+  },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/silvermoon-work/task-engine.git"
+    "url": "git+https://github.com/silvermoon-work/task-engine.git",
+    "directory": "packages/task-builder-cli"
   },
-  "homepage": "https://github.com/silvermoon-work/task-engine#readme",
+  "homepage": "https://github.com/silvermoon-work/task-engine/tree/main/packages/task-builder-cli#readme",
   "bugs": {
     "url": "https://github.com/silvermoon-work/task-engine/issues"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "node -e \"for (const path of ['dist', '.cache']) require('node:fs').rmSync(path, { recursive: true, force: true })\"",
+    "lint": "biome lint .",
+    "test": "tsx --test \"test/*.test.ts\"",
+    "typecheck": "tsc -b --pretty false"
   }
 }