toolcraft 0.0.97 → 0.0.99

package/README.md

@@ -354,7 +354,16 @@ Toolcraft exports a fixed HTTP error hierarchy for transports and generated API
 Each error carries `status`, optional `code`, optional `requestId`, and serializable `request` and
 `response` context.
 
-CLI picks `rich` by default, `--json` switches to `json`. SDK calls return the raw handler value. MCP calls with `result:` return the handler value as `structuredContent` using the configured MCP casing; MCP calls without `result:` keep content-block behavior.
+CLI picks `rich` by default. Enable the generated output selector when starting the CLI:
+
+```ts
+await runCLI(root, { controls: { output: true } });
+```
+
+Then choose structured output with `mytool command --output json`. The selector also accepts `rich`,
+`md`, and `markdown`. SDK calls return the raw handler value. MCP calls with `result:` return the
+handler value as `structuredContent` using the configured MCP casing; MCP calls without `result:`
+keep content-block behavior.
 
 ## MCP proxy: adopt an existing MCP server
 
@@ -578,6 +587,7 @@ additional long CLI flags. For example, `rawResponse` normally maps to `--raw-re
 - `services?: TServices` — merged into every handler context.
 - `version?: string` — surfaced via `--version`.
 - `presets?: boolean` — enables `--preset <path>` for loading parameter defaults from JSON files.
+- `controls?: { debug?, logLevel?, output?, verbose?, yes? }` — enables generated global CLI controls. Set `output: true` to expose `--output <rich|md|markdown|json>`.
 - `apiVersion?: string` — for `requires.apiVersion`.
 - `humanInLoop?: HumanInLoopRuntimeOptions`
 - `errorReports?: boolean | { dir?: string }`

package/composition.json

@@ -48,7 +48,7 @@
     },
     {
       "name": "toolcraft",
-      "version": "0.0.97",
+      "version": "0.0.99",
       "license": "MIT"
     },
     {

package/dist/composition.json

@@ -48,7 +48,7 @@
     },
     {
       "name": "toolcraft",
-      "version": "0.0.97",
+      "version": "0.0.99",
       "license": "MIT"
     },
     {

package/dist/file-change-renderer.d.ts

@@ -0,0 +1,9 @@
+import { type FileChange, type FileChangeDisplayMode } from "toolcraft-design";
+import type { Renderers } from "./index.js";
+export interface FileChangeResult {
+    changes: readonly FileChange[];
+}
+export interface FileChangeRendererOptions {
+    mode?: FileChangeDisplayMode;
+}
+export declare function createFileChangeRenderers<TResult extends FileChangeResult = FileChangeResult>(options?: FileChangeRendererOptions): Renderers<TResult>;

package/dist/file-change-renderer.js

@@ -0,0 +1,10 @@
+import { renderFileChanges } from "toolcraft-design";
+export function createFileChangeRenderers(options = {}) {
+    return {
+        rich: (result) => {
+            process.stdout.write(`${renderFileChanges(result.changes, { mode: options.mode })}\n`);
+        },
+        markdown: (result) => renderFileChanges(result.changes, { mode: options.mode, format: "markdown" }),
+        json: (result) => result
+    };
+}

package/dist/index.compile-check.js

@@ -1,5 +1,6 @@
 import { S } from "toolcraft-schema";
 import { defineCommand, defineGroup } from "./index.js";
+import { createFileChangeRenderers } from "./file-change-renderer.js";
 const ignoredScope = ["cli", "sdk"];
 const ignoredSecrets = {
     apiKey: { env: "API_KEY" },
@@ -29,6 +30,14 @@ const ignoredCommand = defineCommand({
         };
     },
 });
+const ignoredFileChangeCommand = defineCommand({
+    name: "status",
+    params: S.Object({}),
+    render: createFileChangeRenderers({ mode: "status" }),
+    handler: async () => ({
+        changes: [{ kind: "added", path: "flows/morning.json", newContent: "{}\n" }]
+    })
+});
 const ignoredGroup = defineGroup({
     name: "root",
     scope: ignoredScope,

package/dist/index.d.ts

@@ -208,6 +208,8 @@ export { ApprovalDeclinedError, ToolcraftBugError, UserError };
 export { createRuntimeLogger, isLogLevel, shouldEmitDiagnostic } from "./runtime-logging.js";
 export { findPackageMetadata, packageMetadata } from "./package-metadata.js";
 export type { PackageMetadata } from "./package-metadata.js";
+export type { FileChangeRendererOptions, FileChangeResult } from "./file-change-renderer.js";
+export type { FileChange, FileChangeDisplayMode, FileChangeKind } from "toolcraft-design";
 export type { DiagnosticLogEvent, LogLevel, RuntimeLogger, RuntimeLoggerInput } from "./runtime-logging.js";
 export type { AnySchema, ArraySchema, BooleanSchema, EnumSchema, JsonSchema, NumberSchema, ObjectSchema, OptionalSchema, Static, StringSchema } from "toolcraft-schema";
 export type { HumanInLoopConfig, HumanInLoopPending, HumanInLoopRuntimeOptions };

package/node_modules/toolcraft-design/dist/components/file-changes.d.ts

@@ -0,0 +1,16 @@
+export type FileChangeKind = "added" | "modified" | "deleted" | "renamed";
+export type FileChangeDisplayMode = "status" | "diff";
+export type FileChangeOutputFormat = "terminal" | "markdown";
+export interface FileChange {
+    path: string;
+    kind: FileChangeKind;
+    oldPath?: string;
+    conflict?: boolean;
+    oldContent?: string;
+    newContent?: string;
+}
+export interface RenderFileChangesOptions {
+    mode?: FileChangeDisplayMode;
+    format?: FileChangeOutputFormat;
+}
+export declare function renderFileChanges(changes: readonly FileChange[], options?: RenderFileChangesOptions): string;

package/node_modules/toolcraft-design/dist/components/file-changes.js

@@ -0,0 +1,162 @@
+import { color } from "./color.js";
+const STATUS_MARKERS = {
+    added: "A",
+    modified: "M",
+    deleted: "D",
+    renamed: "R"
+};
+const STATUS_LABELS = {
+    added: "added",
+    modified: "modified",
+    deleted: "deleted",
+    renamed: "renamed"
+};
+function changePath(change) {
+    if (change.kind === "renamed" && change.oldPath) {
+        return `${change.oldPath} -> ${change.path}`;
+    }
+    return change.path;
+}
+function colorStatusMarker(change, marker) {
+    if (change.conflict) {
+        return color.red.bold(marker);
+    }
+    switch (change.kind) {
+        case "added":
+            return color.green(marker);
+        case "modified":
+            return color.yellow(marker);
+        case "deleted":
+            return color.red(marker);
+        case "renamed":
+            return color.cyan(marker);
+    }
+}
+function formatSummary(changes) {
+    const counts = new Map();
+    let conflicts = 0;
+    for (const change of changes) {
+        counts.set(change.kind, (counts.get(change.kind) ?? 0) + 1);
+        if (change.conflict) {
+            conflicts += 1;
+        }
+    }
+    const details = Object.keys(STATUS_LABELS)
+        .flatMap((kind) => {
+        const count = counts.get(kind) ?? 0;
+        return count > 0 ? [`${count} ${STATUS_LABELS[kind]}`] : [];
+    });
+    if (conflicts > 0) {
+        details.push(`${conflicts} ${conflicts === 1 ? "conflict" : "conflicts"}`);
+    }
+    return `${changes.length} ${changes.length === 1 ? "change" : "changes"} (${details.join(", ")})`;
+}
+function renderStatus(changes, format) {
+    const lines = changes.map((change) => {
+        const marker = `${STATUS_MARKERS[change.kind]}${change.conflict ? "!" : " "}`;
+        const renderedMarker = format === "terminal" ? colorStatusMarker(change, marker) : marker;
+        return `${renderedMarker} ${changePath(change)}`;
+    });
+    const output = [...lines, "", formatSummary(changes)].join("\n");
+    return format === "markdown" ? `\`\`\`text\n${output}\n\`\`\`` : output;
+}
+function diffPath(prefix, path) {
+    return `${prefix}/${path}`;
+}
+function contentLines(content) {
+    const lines = content.split("\n");
+    if (lines.at(-1) === "") {
+        lines.pop();
+    }
+    return lines;
+}
+function commonPrefixLength(oldLines, newLines) {
+    const limit = Math.min(oldLines.length, newLines.length);
+    let index = 0;
+    while (index < limit && oldLines[index] === newLines[index]) {
+        index += 1;
+    }
+    return index;
+}
+function commonSuffixLength(oldLines, newLines, prefixLength) {
+    const limit = Math.min(oldLines.length, newLines.length) - prefixLength;
+    let length = 0;
+    while (length < limit &&
+        oldLines[oldLines.length - length - 1] === newLines[newLines.length - length - 1]) {
+        length += 1;
+    }
+    return length;
+}
+function hunkRange(startIndex, count) {
+    const lineNumber = count === 0 ? 0 : startIndex + 1;
+    return `${lineNumber},${count}`;
+}
+function createUnifiedHunk(oldContent, newContent) {
+    const oldLines = contentLines(oldContent);
+    const newLines = contentLines(newContent);
+    const prefixLength = commonPrefixLength(oldLines, newLines);
+    const suffixLength = commonSuffixLength(oldLines, newLines, prefixLength);
+    const context = 3;
+    const oldChangeEnd = oldLines.length - suffixLength;
+    const newChangeEnd = newLines.length - suffixLength;
+    const oldStart = Math.max(0, prefixLength - context);
+    const newStart = Math.max(0, prefixLength - context);
+    const oldEnd = Math.min(oldLines.length, oldChangeEnd + context);
+    const newEnd = Math.min(newLines.length, newChangeEnd + context);
+    const oldCount = oldEnd - oldStart;
+    const newCount = newEnd - newStart;
+    const before = oldLines.slice(oldStart, prefixLength).map((line) => ` ${line}`);
+    const removed = oldLines.slice(prefixLength, oldChangeEnd).map((line) => `-${line}`);
+    const added = newLines.slice(prefixLength, newChangeEnd).map((line) => `+${line}`);
+    const after = oldLines.slice(oldChangeEnd, oldEnd).map((line) => ` ${line}`);
+    return [
+        `@@ -${hunkRange(oldStart, oldCount)} +${hunkRange(newStart, newCount)} @@`,
+        ...before,
+        ...removed,
+        ...added,
+        ...after
+    ].join("\n");
+}
+function createChangePatch(change) {
+    const oldPath = change.kind === "added"
+        ? "/dev/null"
+        : diffPath("a", change.oldPath ?? change.path);
+    const newPath = change.kind === "deleted" ? "/dev/null" : diffPath("b", change.path);
+    const oldContent = change.kind === "added" ? "" : (change.oldContent ?? "");
+    const newContent = change.kind === "deleted" ? "" : (change.newContent ?? "");
+    const headers = [`--- ${oldPath}`, `+++ ${newPath}`];
+    if (oldContent !== newContent) {
+        return [...headers, createUnifiedHunk(oldContent, newContent)].join("\n");
+    }
+    return headers.join("\n");
+}
+function colorDiffLine(line) {
+    if (line.startsWith("@@")) {
+        return color.cyan(line);
+    }
+    if (line.startsWith("+++") || line.startsWith("---")) {
+        return color.bold(line);
+    }
+    if (line.startsWith("+")) {
+        return color.green(line);
+    }
+    if (line.startsWith("-")) {
+        return color.red(line);
+    }
+    return line;
+}
+function renderDiff(changes, format) {
+    const output = changes.map(createChangePatch).join("\n\n");
+    if (format === "markdown") {
+        return `\`\`\`diff\n${output}\n\`\`\``;
+    }
+    return output.split("\n").map(colorDiffLine).join("\n");
+}
+export function renderFileChanges(changes, options = {}) {
+    if (changes.length === 0) {
+        return "No file changes.";
+    }
+    const mode = options.mode ?? "status";
+    const format = options.format ?? "terminal";
+    return mode === "diff" ? renderDiff(changes, format) : renderStatus(changes, format);
+}

package/node_modules/toolcraft-design/dist/components/index.d.ts

@@ -10,6 +10,8 @@ export { formatCommandNotFound } from "./command-errors.js";
 export { formatCommandNotFoundPanel } from "./command-errors.js";
 export { renderTable } from "./table.js";
 export type { TableColumn, RenderTableOptions } from "./table.js";
+export { renderFileChanges } from "./file-changes.js";
+export type { FileChange, FileChangeDisplayMode, FileChangeKind, FileChangeOutputFormat, RenderFileChangesOptions } from "./file-changes.js";
 export { renderCatalog } from "./catalog.js";
 export type { CatalogGroup, CatalogItem, CatalogMetric, CatalogTone, RenderCatalogOptions } from "./catalog.js";
 export { getTemplatePartialNames, renderTemplate, resolveTemplatePartials } from "./template.js";

package/node_modules/toolcraft-design/dist/components/index.js

@@ -6,5 +6,6 @@ export { helpFormatter, formatColumns, formatCommand, formatUsage, formatOption,
 export { formatCommandNotFound } from "./command-errors.js";
 export { formatCommandNotFoundPanel } from "./command-errors.js";
 export { renderTable } from "./table.js";
+export { renderFileChanges } from "./file-changes.js";
 export { renderCatalog } from "./catalog.js";
 export { getTemplatePartialNames, renderTemplate, resolveTemplatePartials } from "./template.js";

package/node_modules/toolcraft-design/dist/index.d.ts

@@ -19,6 +19,8 @@ export { formatCommandNotFound } from "./components/command-errors.js";
 export { formatCommandNotFoundPanel } from "./components/command-errors.js";
 export { renderTable } from "./components/table.js";
 export type { TableColumn, RenderTableOptions } from "./components/table.js";
+export { renderFileChanges } from "./components/file-changes.js";
+export type { FileChange, FileChangeDisplayMode, FileChangeKind, FileChangeOutputFormat, RenderFileChangesOptions } from "./components/file-changes.js";
 export { renderCatalog } from "./components/catalog.js";
 export type { CatalogGroup, CatalogItem, CatalogMetric, CatalogTone, RenderCatalogOptions } from "./components/catalog.js";
 export { renderDetailCard } from "./components/detail-card.js";

package/node_modules/toolcraft-design/dist/index.js

@@ -15,6 +15,7 @@ export * as helpFormatterPlain from "./components/help-formatter-plain.js";
 export { formatCommandNotFound } from "./components/command-errors.js";
 export { formatCommandNotFoundPanel } from "./components/command-errors.js";
 export { renderTable } from "./components/table.js";
+export { renderFileChanges } from "./components/file-changes.js";
 export { renderCatalog } from "./components/catalog.js";
 export { renderDetailCard } from "./components/detail-card.js";
 export { renderInspectorCard } from "./components/inspector-card.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolcraft",
-  "version": "0.0.97",
+  "version": "0.0.99",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",
@@ -70,6 +70,10 @@
       "types": "./dist/frontmatter.d.ts",
       "import": "./dist/frontmatter.js"
     },
+    "./file-changes": {
+      "types": "./dist/file-change-renderer.d.ts",
+      "import": "./dist/file-change-renderer.js"
+    },
     "./process-runner": {
       "types": "./dist/process-runner.d.ts",
       "import": "./dist/process-runner.js"
@@ -100,7 +104,7 @@
     "postpack": "node ../../scripts/manage-bundled-workspace-deps.mjs cleanup . toolcraft-design @poe-code/frontmatter @poe-code/agent-mcp-config @poe-code/agent-human-in-loop @poe-code/task-list @poe-code/agent-defs @poe-code/config-mutations @poe-code/process-runner tiny-mcp-client auth-store"
   },
   "dependencies": {
-    "toolcraft-schema": "0.0.97",
+    "toolcraft-schema": "0.0.99",
     "commander": "^13.1.0",
     "fast-string-width": "^3.0.2",
     "fast-wrap-ansi": "^0.2.0",