toolcraft 0.0.129 → 0.0.130

package/composition.json

@@ -108,7 +108,7 @@
     },
     {
       "name": "toolcraft",
-      "version": "0.0.129",
+      "version": "0.0.130",
       "license": "MIT"
     },
     {
@@ -118,7 +118,7 @@
     },
     {
       "name": "toolcraft-schema",
-      "version": "0.0.129",
+      "version": "0.0.130",
       "license": "MIT"
     },
     {

package/dist/cli.d.ts

@@ -7,8 +7,14 @@ export { renderErrorReport } from "./error-report.js";
 export type { ErrorReportRenderContext, ErrorReportRenderResult } from "./error-report.js";
 export { configureTheme };
 type Casing = "kebab" | "snake";
+export type CLIHelpDepth = "concise" | "extended";
 export interface CLIControls {
     debug?: boolean;
+    /**
+     * Group `--help` depth. `extended` (default) lists every nested action under the
+     * help target; `concise` lists only direct children.
+     */
+    help?: CLIHelpDepth;
     logLevel?: boolean;
     output?: boolean | CLIOutputControl;
     verbose?: boolean;

package/dist/cli.js

@@ -663,6 +663,7 @@ function resolveCLIControls(controls) {
     validateOutputFormats(outputFormats);
     return {
         debug: controls?.debug === true,
+        help: controls?.help === "concise" ? "concise" : "extended",
         logLevel: controls?.logLevel === true,
         output: controls?.output === true || typeof controls?.output === "object",
         outputFormats,
@@ -1132,11 +1133,31 @@ function formatCommandRowName(node, casing, globalLongOptionFlags) {
     const name = parameterTokens.length === 0 ? baseName : `${baseName} ${parameterTokens.join(" ")}`;
     return name;
 }
-function formatCommandRows(group, scope, casing, globalLongOptionFlags) {
-    return getHelpChildren(group, scope).map((child) => ({
-        name: formatCommandRowName(child, casing, globalLongOptionFlags),
-        description: child.description ?? ""
-    }));
+function formatCommandRows(group, scope, casing, globalLongOptionFlags, help) {
+    if (help === "concise") {
+        return getHelpChildren(group, scope).map((child) => ({
+            name: formatCommandRowName(child, casing, globalLongOptionFlags),
+            description: child.description ?? "",
+            kind: child.kind,
+            depth: 0
+        }));
+    }
+    const rows = [];
+    const visit = (node, depth) => {
+        for (const child of getHelpChildren(node, scope)) {
+            rows.push({
+                name: formatCommandRowName(child, casing, globalLongOptionFlags),
+                description: child.description ?? "",
+                kind: child.kind,
+                depth
+            });
+            if (child.kind === "group") {
+                visit(child, depth + 1);
+            }
+        }
+    };
+    visit(group, 0);
+    return rows;
 }
 function formatGlobalOptionsLine(ctx) {
     const flags = [];
@@ -1222,7 +1243,7 @@ function formatGroupUsageSuffix(group, scope, casing, globalLongOptionFlags) {
 function renderGroupHelp(group, breadcrumb, scope, casing, globalOptions, rootUsageName, isRoot) {
     const sections = [];
     const globalLongOptionFlags = getGlobalLongOptionFlags(globalOptions.presetsEnabled, globalOptions.showVersion, globalOptions.controls);
-    const commandRows = formatCommandRows(group, scope, casing, globalLongOptionFlags);
+    const commandRows = formatCommandRows(group, scope, casing, globalLongOptionFlags, globalOptions.controls.help);
     if (commandRows.length > 0) {
         sections.push(`${text.sectionHeader("Commands")}\n${formatHelpCommandList(commandRows)}`);
     }
@@ -1288,7 +1309,7 @@ function renderJsonHelp(target, root, casing, globalOptions, rootUsageName) {
     const globalLongOptionFlags = getGlobalLongOptionFlags(globalOptions.presetsEnabled, globalOptions.showVersion, globalOptions.controls);
     const node = target.node;
     if (node.kind === "group") {
-        const commandRows = formatCommandRows(node, "cli", casing, globalLongOptionFlags);
+        const commandRows = formatCommandRows(node, "cli", casing, globalLongOptionFlags, globalOptions.controls.help);
         const isRoot = node === root;
         return `${JSON.stringify({
             schemaVersion: 1,
@@ -1297,7 +1318,12 @@ function renderJsonHelp(target, root, casing, globalOptions, rootUsageName) {
             path: target.breadcrumb.filter((segment) => segment.length > 0),
             usage: buildUsageLine(target.breadcrumb, rootUsageName, formatGroupUsageSuffix(node, "cli", casing, globalLongOptionFlags)),
             ...(node.description === undefined ? {} : { description: node.description }),
-            commands: commandRows.map((row) => ({ name: row.name, description: row.description })),
+            commands: commandRows.map((row) => ({
+                name: row.name,
+                description: row.description,
+                kind: row.kind,
+                depth: row.depth
+            })),
             options: isRoot
                 ? collectSchemaGlobalFieldRows(node, "cli", casing, globalLongOptionFlags).map((row) => ({
                     name: row.flags.split(/[ ,]+/)[0]?.replace(/^--/, "") ?? row.flags,

package/dist/composition.json

@@ -108,7 +108,7 @@
     },
     {
       "name": "toolcraft",
-      "version": "0.0.129",
+      "version": "0.0.130",
       "license": "MIT"
     },
     {
@@ -118,7 +118,7 @@
     },
     {
       "name": "toolcraft-schema",
-      "version": "0.0.129",
+      "version": "0.0.130",
       "license": "MIT"
     },
     {

package/node_modules/tiny-stdio-mcp-server/dist/composition.json

@@ -8,7 +8,7 @@
     },
     {
       "name": "toolcraft-schema",
-      "version": "0.0.129",
+      "version": "0.0.130",
       "license": "MIT"
     }
   ]

package/node_modules/toolcraft-design/dist/components/help-formatter-plain.js

@@ -117,7 +117,7 @@ export function formatColumns(opts) {
 export function formatCommandList(commands) {
     return formatColumns({
         rows: commands.map((cmd) => ({
-            left: cmd.name,
+            left: `${" ".repeat((cmd.depth ?? 0) * 2)}${cmd.name}`,
             right: cmd.description
         }))
     });

package/node_modules/toolcraft-design/dist/components/help-formatter.d.ts

@@ -1,6 +1,8 @@
 export interface CommandInfo {
     name: string;
     description: string;
+    /** Nesting depth relative to the help target. Depth 0 is a direct child. */
+    depth?: number;
 }
 export interface OptionInfo {
     flags: string;

package/node_modules/toolcraft-design/dist/components/help-formatter.js

@@ -190,7 +190,7 @@ export function formatOption(flags, description) {
 export function formatCommandList(commands) {
     return formatColumns({
         rows: commands.map((cmd) => ({
-            left: text.command(cmd.name),
+            left: `${" ".repeat((cmd.depth ?? 0) * 2)}${text.command(cmd.name)}`,
             right: cmd.description
         }))
     });

package/node_modules/toolcraft-schema/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolcraft-schema",
-  "version": "0.0.129",
+  "version": "0.0.130",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolcraft",
-  "version": "0.0.129",
+  "version": "0.0.130",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",
@@ -153,7 +153,7 @@
     "yaml"
   ],
   "optionalDependencies": {
-    "toolcraft-schema": "0.0.129",
+    "toolcraft-schema": "0.0.130",
     "toolcraft-design": "*",
     "@poe-code/frontmatter": "*",
     "@poe-code/agent-mcp-config": "*",