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

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 shazhou-ww
+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,251 @@
-# Temporary Holding Version
+# @silvermoon-work/task-builder
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Build Task Bundles with esbuild from a read-only file tree into another read-only
+file tree. No pguide command protocol, Gulp, Vinyl, CAR, network, publication, or
+output-directory management is part of the transformation.
+
+## Transformation
+
+```ts
+import {
+  buildTaskBundle,
+  type ReadonlyFileTree,
+} from "@silvermoon-work/task-builder";
+
+const output: ReadonlyFileTree = await buildTaskBundle(input, {
+  name: "Echo",
+  runtime: { minVersion: "22.13.0" },
+  source: {
+    entry: "src/main.ts",
+    contract: {
+      input: { type: "object", properties: { text: { type: "string" } } },
+      result: { type: "string" },
+      message: false,
+    },
+    mode: "explicit",
+  },
+  include: [{ from: "assets/**", to: "resources/" }],
+  binary: ["resources/images/**"],
+  signal,
+});
+
+const entries = await output.list("");
+const resource = await output.read("resources/config.json", { signal });
+```
+
+The input variable is a caller-supplied tree, not a host path:
+
+```ts
+interface ReadonlyFileTree {
+  list(path: string, options?: { signal?: AbortSignal }): Promise<readonly {
+    name: string;
+    kind: "file" | "directory";
+    target?: string;
+  }[]>;
+  read(path: string, options?: {
+    signal?: AbortSignal;
+  }): Promise<ReadableStream<Uint8Array>>;
+}
+```
+
+`""` lists the root. Listings contain direct children, with names rather than
+full paths. Logical paths use `/` on every OS; absolute paths, traversal,
+backslashes, colons and control characters are rejected. Missing paths, wrong
+file/directory kinds, invalid entries and input failures are explicit errors.
+Every read must return a new stream of the same bytes. The caller must keep the
+input version and its lifetime stable while using the output.
+An optional `target` is a canonical path inside the same tree for an alias;
+ordinary virtual trees need not provide it. The directory adapter supplies it
+for confined links so package imports resolve from their real dependency
+location, including pnpm's virtual store.
+
+## Streaming and ownership
+
+The generated primary Schemas are `schemas/input.json`, `schemas/result.json`
+and `schemas/message.json`; the manifest references those exact paths.
+Additional contract Schemas use a name-to-Schema object, for example
+`schemas: { user: UserSchema, address: AddressSchema }`, and become
+`schemas/shared/user.json` and `schemas/shared/address.json`. Names must be
+single portable file-name stems with no traversal, separators, reserved device
+names, non-NFC spellings or case-insensitive collisions. Array declarations are
+rejected rather than automatically numbered. Named Schemas are sorted by name
+for deterministic output, independent of object insertion order.
+Author-supplied `$id` and `$ref` values are preserved. Primary fallback IDs
+remain unchanged; shared definitions without an `$id` receive
+`https://task.invalid/schema/shared/<URI-encoded-name>`. References use Schema
+identities, not object keys; missing references or conflicting identities fail.
+Existing output directories are not renamed automatically; rebuild into a new
+directory to obtain the new layout.
+
+- Module source, package metadata and contracts are aggregated **per file**
+  because esbuild's `onLoad` requires complete bytes. Source reads and the module
+  graph have separate byte/file/path budgets; this is not a fully streaming JS
+  compiler.
+- Building reads resource listings, but does not open resource contents.
+  `output.read()` itself does not open the input resource either: first demand
+  does. Resource chunks pass through with backpressure, without whole-resource
+  aggregation or a temporary snapshot. Normalization buffers at most an upstream
+  chunk plus its transformed bytes and UTF-8 decoder state. Input adapters should
+  emit reasonably sized chunks; the Node adapter uses 64 KiB.
+- Text validates incremental UTF-8 and normalizes CRLF/lone CR to LF, including
+  CRLF and UTF-8 sequences split across chunks. BOM and all other bytes are
+  preserved. Explicit binary resource globs preserve bytes exactly.
+- Cancel or abort of a resource stream cancels its upstream reader. Each read
+  has independent normalization and cancellation state. The build signal applies
+  only to construction; output reads use their own signal.
+- Generated Worker, manifest and Schema bytes are owned by the output. Readers
+  receive copies. Resources retain a reference to the input, not a byte snapshot;
+  changing or closing the input changes or breaks subsequent reads.
+- Manifest, path collisions, Schema closure and generated bytes are validated
+  before build returns. Resource UTF-8, input failures and byte capacities can
+  fail later during reading, including at EOF. **A returned tree is not proof
+  that all resource bytes have been validated.** Consume every file to EOF before
+  treating it as a distributable Bundle. Partial reads do not validate the tail.
+- Resource capacity accounting tracks the maximum observed normalized length per
+  logical file across reads, so repeated/concurrent reads do not double-count.
+  Protocol defaults remain 64 MiB per file/total, 256 files and 512 paths.
+
+## Modules and contracts
+
+An esbuild namespace confines module loading to the input tree. `enhanced-resolve`
+uses a tree-backed filesystem for relative imports, extension resolution,
+`.js` to `.ts` aliases, `node_modules`, package exports/imports and Node
+import/require conditions. Only Node builtins remain external. Missing
+dependencies never fall back to the builder's own node_modules.
+
+Dependencies must be present in the input tree. There is no install, network
+resolver, automatic tsconfig discovery, tsconfig path mapping, arbitrary asset
+loader or externally supplied esbuild plugin in this first implementation.
+Compilation targets Node 22 CommonJS and rejects non-static import/require calls.
+The build host must use Node >=22.13; execution runtime eligibility belongs to
+the Engine.
+
+`source.mode` defaults to `explicit`: the entry calls the SDK's `runTask`
+itself. `callback` wraps a lazily imported callback; `exportName` defaults to
+`default` and is only accepted in that mode. `source.sdk` defaults to
+`@silvermoon-work/task-sdk` for callback wrappers and can explicitly select an
+SDK already present in the tree. The SDK has not been migrated into this
+repository; existing projects can supply `@potential-guide/task-sdk`.
+Recognized SDK `binding.js`/`binding.ts` modules are replaced with the resolved
+Bundle declaration without evaluating the Worker or author callback.
+
+`source.contract` accepts an object, a tree-relative JSON file, or a trusted
+TS/JS module default-exporting `{ input, result, message, schemas? }`. Objects
+can contain plain JSON Schema or supported TypeBox 0.34.52 schemas; transforms
+and unsupported metadata/format semantics are rejected. Code contracts require
+`allowContractExecution: true`. They are compiled using the same tree resolver,
+then **executed as trusted Node code, not in a sandbox**. Builtins and global
+APIs can have side effects; a read-only tree is not an execution security boundary.
+Their `__filename`, `__dirname` and `import.meta.url` are logical `task-tree:///`
+locations, not host source paths. Use JSON contracts for non-executing builds.
+
+For example, a JSON contract can share one definition between input and result:
+
+```json
+{
+  "input": {
+    "type": "object",
+    "properties": {
+      "user": { "$ref": "https://example.invalid/schemas/user" }
+    }
+  },
+  "result": { "$ref": "https://example.invalid/schemas/user" },
+  "message": false,
+  "schemas": {
+    "user": {
+      "$id": "https://example.invalid/schemas/user",
+      "type": "object",
+      "properties": { "name": { "type": "string" } }
+    }
+  }
+}
+```
+
+Text contracts reject duplicate JSON/YAML keys during strict parsing, including
+escaped JSON keys with the same decoded spelling. JS/TS objects can overwrite
+duplicate keys before evaluation returns; that information cannot be recovered
+by the builder. Case-insensitive name collisions are still checked after
+evaluation. The build YAML and final `task.yaml` protocol structure do not change;
+the latter only lists the newly named files in `include`.
+
+## Standalone CLI
+
+The Node adapter is deliberately separate:
+
+```ts
+import { directoryTree, writeDirectory } from "@silvermoon-work/task-builder/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 under concurrent
+filesystem changes. It follows links only to regular files/directories within
+the chosen root, allowing confined pnpm dependency links. It rejects escaping
+links and special files; this is not an OS sandbox.
+
+Create `task.build.yaml`:
+
+```yaml
+name: Echo
+runtime:
+  minVersion: "22.13.0"
+source:
+  entry: src/main.ts
+  contract: src/contract.json
+  mode: explicit
+include:
+  - from: assets/**
+    to: resources/
+outDirectory: dist
+binary: []
+```
+
+All source paths and include globs are relative to this file; include destinations
+and binary globs refer to final Bundle paths. Include rules skip dot entries and
+node_modules, must match a file, and cannot overlap or traverse the output.
+The existing author `$schema` URI is accepted when explicitly supplied; it is
+not rewritten. Unknown configuration fields are rejected.
+
+```sh
+task-builder task.build.yaml --root <project-directory>
+# Trusted TypeBox module contract:
+task-builder task.build.yaml --root <project-directory> --trusted-contract
+```
+
+In this repository, after building the package:
+
+```sh
+pnpm --filter @silvermoon-work/task-builder build
+node packages/task-builder/dist/cli.js task.build.yaml --root <project-directory>
+```
+
+The CLI streams files sequentially into a **new** output directory and returns
+JSON `{ directory, files }` only after every stream completes. The output's
+parent must already exist and be canonical. Existing output is never replaced;
+on failure, only newly created files/directories are removed. Build interruption
+aborts active I/O. There is no init, watch, CAR generation or publication.
+
+Try the included [Echo task](./examples/echo/task.build.yaml) from the repository
+root after installation and build:
+
+```sh
+node packages/task-builder/dist/cli.js packages/task-builder/examples/echo/task.build.yaml
+```
+
+The root includes the installed dependency tree, so this example can bundle the
+published SDK used by the repository's tests. The generated directory is
+`packages/task-builder/examples/echo/dist`. It contains a real SDK Worker meant
+to be started by a Task Engine, not executed directly as a standalone script.
+
+## Validation
+
+```sh
+pnpm --filter @silvermoon-work/task-builder... build
+pnpm --filter @silvermoon-work/task-builder test
+pnpm check
+```
+
+The contract conversion and SDK binding behavior were extracted from
+potential-guide's MIT-licensed author tooling; its license notice is retained.

package/dist/cli.d.ts

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

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+import { resolve, sep } from "node:path";
+import { buildTaskBundle, readTaskBuild } from "./index.js";
+import { directoryTree, writeDirectory } from "./node.js";
+const help = `Usage: task-builder <task.build.yaml> [--root <directory>] [--trusted-contract]
+
+Build a Task Bundle into the build file's outDirectory (must not exist).
+Paths in the build file are relative to that file inside --root (default: cwd).
+Resources are streamed to disk; no CAR, upload, or pguide command protocol.
+Code contracts are executed only with --trusted-contract; JSON contracts need no flag.
+`;
+async function main(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        process.stdout.write(help);
+        return;
+    }
+    let root = process.cwd();
+    let file;
+    let trusted = false;
+    for (let index = 0; index < argv.length; index++) {
+        const arg = argv[index];
+        if (arg === "--root") {
+            const value = argv[++index];
+            if (!value || value.startsWith("--"))
+                throw new Error("--root requires a directory.");
+            root = resolve(value);
+        }
+        else if (arg === "--trusted-contract")
+            trusted = true;
+        else if (arg.startsWith("-") || file !== undefined)
+            throw new Error(help);
+        else
+            file = arg;
+    }
+    if (!file)
+        throw new Error(help);
+    const controller = new AbortController();
+    const interrupt = () => controller.abort(new Error("Build interrupted."));
+    process.once("SIGINT", interrupt);
+    process.once("SIGTERM", interrupt);
+    try {
+        const input = await directoryTree(root);
+        const definition = await readTaskBuild(input, file.split(sep).join("/"), {
+            signal: controller.signal,
+            allowContractExecution: trusted,
+        });
+        const tree = await buildTaskBundle(input, definition.options);
+        const directory = resolve(root, ...definition.outDirectory.split("/"));
+        const files = await writeDirectory(tree, directory, { signal: controller.signal });
+        process.stdout.write(`${JSON.stringify({ directory, files })}\n`);
+    }
+    finally {
+        process.removeListener("SIGINT", interrupt);
+        process.removeListener("SIGTERM", interrupt);
+    }
+}
+void main(process.argv.slice(2)).catch((error) => {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/contract.d.ts

@@ -0,0 +1,7 @@
+import { type JsonObject } from "@silvermoon-work/task-protocol";
+export declare function toTaskSchema(value: unknown): unknown;
+export declare function contractSchemas(value: unknown): {
+    path: string;
+    document: JsonObject;
+}[];
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAuCzF,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAqDpD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,UAAU,CAAA;CAAE,EAAE,CAyDxF"}

package/dist/contract.js

@@ -0,0 +1,146 @@
+import { Kind, OptionalKind, ReadonlyKind } from "@sinclair/typebox";
+import { isTaskBundlePath, json } from "@silvermoon-work/task-protocol";
+const kinds = new Set([
+    "Object",
+    "String",
+    "Number",
+    "Integer",
+    "Boolean",
+    "Null",
+    "Literal",
+    "Array",
+    "Tuple",
+    "Union",
+    "Intersect",
+    "Record",
+    "Ref",
+    "Never",
+]);
+const maps = new Set([
+    "properties",
+    "patternProperties",
+    "$defs",
+    "definitions",
+    "dependentSchemas",
+]);
+const singles = new Set([
+    "items",
+    "additionalProperties",
+    "unevaluatedProperties",
+    "propertyNames",
+    "contains",
+    "not",
+    "if",
+    "then",
+    "else",
+    "unevaluatedItems",
+]);
+const arrays = new Set(["anyOf", "allOf", "oneOf", "prefixItems"]);
+export function toTaskSchema(value) {
+    let nodes = 0;
+    function visit(value, schema, depth) {
+        if (++nodes > 16_384 || depth > 64)
+            throw new Error("Contract Schema budget exceeded.");
+        if (value === null || typeof value !== "object") {
+            if (["function", "symbol", "undefined", "bigint"].includes(typeof value))
+                throw new Error("Contract must contain only JSON semantics.");
+            return value;
+        }
+        if (Array.isArray(value))
+            return value.map((child) => visit(child, schema, depth + 1));
+        const node = value;
+        for (const symbol of Object.getOwnPropertySymbols(node))
+            if (![Kind, OptionalKind, ReadonlyKind, Symbol.for("TypeBox.Hint")].includes(symbol))
+                throw new Error("Unsupported TypeBox metadata or transform.");
+        if (node[Kind] !== undefined && !kinds.has(String(node[Kind])))
+            throw new Error(`Unsupported TypeBox kind: ${String(node[Kind])}.`);
+        if (schema &&
+            ["format", "contentEncoding", "contentMediaType", "contentSchema"].some((key) => Object.hasOwn(node, key)))
+            throw new Error("Engine does not enforce format or content annotations.");
+        if (schema &&
+            node[Kind] === "Tuple" &&
+            node.additionalItems !== undefined &&
+            node.additionalItems !== false)
+            throw new Error("Unsupported TypeBox Tuple additionalItems override.");
+        const output = {};
+        for (const [key, child] of Object.entries(node)) {
+            if (schema && node[Kind] === "Tuple" && (key === "items" || key === "additionalItems"))
+                continue;
+            let result;
+            if (schema && maps.has(key)) {
+                if (!child || typeof child !== "object" || Array.isArray(child))
+                    throw new Error("Invalid Schema map.");
+                result = Object.fromEntries(Object.entries(child).map(([name, entry]) => [name, visit(entry, true, depth + 1)]));
+            }
+            else
+                result = visit(child, schema && (singles.has(key) || arrays.has(key)), depth + 1);
+            Object.defineProperty(output, key, { value: result, enumerable: true });
+        }
+        if (schema && node[Kind] === "Tuple") {
+            const items = visit(node.items ?? [], true, depth + 1);
+            if (!Array.isArray(items))
+                throw new Error("Invalid TypeBox Tuple items.");
+            if (items.length)
+                output.prefixItems = items;
+            output.items = false;
+        }
+        return output;
+    }
+    return visit(value, true, 0);
+}
+export function contractSchemas(value) {
+    if (!value ||
+        typeof value !== "object" ||
+        Array.isArray(value) ||
+        !("input" in value) ||
+        !("result" in value) ||
+        !("message" in value) ||
+        Object.keys(value).some((key) => !["input", "result", "message", "schemas"].includes(key)))
+        throw new Error("Contract must contain { input, result, message, schemas? }.");
+    const schemas = "schemas" in value ? value.schemas : {};
+    if (!schemas || typeof schemas !== "object" || Array.isArray(schemas))
+        throw new Error("Contract schemas must be a name-to-Schema object, not an array.");
+    const shared = Object.entries(schemas).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+    const names = new Set();
+    for (const [name] of shared) {
+        if (!name ||
+            name.includes("/") ||
+            !isTaskBundlePath(name) ||
+            !isTaskBundlePath(`schemas/shared/${name}.json`) ||
+            names.has(name.toLowerCase()))
+            throw new Error(`Shared Schema names must be unique portable file names: ${name}`);
+        names.add(name.toLowerCase());
+    }
+    const entries = [
+        { path: "schemas/input.json", identity: "0", schema: value.input },
+        { path: "schemas/result.json", identity: "1", schema: value.result },
+        { path: "schemas/message.json", identity: "2", schema: value.message },
+        ...shared.map(([name, schema]) => ({
+            path: `schemas/shared/${name}.json`,
+            identity: `shared/${encodeURIComponent(name)}`,
+            schema,
+        })),
+    ];
+    return entries.map(({ path, identity, schema }, index) => {
+        const normalized = json(toTaskSchema(schema));
+        const id = `https://task.invalid/schema/${identity}`;
+        if (typeof normalized === "boolean") {
+            if (!index)
+                throw new Error("Task input Schema must be an object.");
+            return {
+                path,
+                document: { $id: id, ...(normalized ? {} : { not: {} }) },
+            };
+        }
+        if (!normalized || typeof normalized !== "object" || Array.isArray(normalized))
+            throw new Error("Contract Schema must be an object or boolean.");
+        return {
+            path,
+            document: {
+                ...normalized,
+                $id: normalized.$id ?? id,
+            },
+        };
+    });
+}
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

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

package/dist/esbuild.d.ts

@@ -0,0 +1,14 @@
+import type { ResolvedTaskBundle } from "@silvermoon-work/task-protocol";
+import { type ReadonlyFileTree, type ReadOptions } from "./tree.js";
+export interface CompileOptions extends ReadOptions {
+    readonly fileBytes: number;
+    readonly sourceBytes: number;
+    readonly sourceFiles: number;
+    readonly traversalPaths: number;
+    readonly binding?: ResolvedTaskBundle;
+    readonly callbackExport?: string;
+    readonly sdk?: string;
+}
+export declare function compileTree(tree: ReadonlyFileTree, entry: string, options: CompileOptions): Promise<Uint8Array>;
+export declare function evaluateContract(bytes: Uint8Array): unknown;
+//# sourceMappingURL=esbuild.d.ts.map

package/dist/esbuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"esbuild.d.ts","sourceRoot":"","sources":["../src/esbuild.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAkC,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAiCpG,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,UAAU,CAAC,CA0NrB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAkB3D"}