@silkweave/cli 1.3.0

package/.turbo/turbo-build.log

@@ -0,0 +1,18 @@
+
+
+> @silkweave/cli@1.3.0 build /Users/atomic/projects/ai/silkweave/packages/cli
+> tsup
+
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Using tsup config: /Users/atomic/projects/ai/silkweave/packages/cli/tsup.config.ts
+CLI Target: es2022
+CLI Cleaning output folder
+ESM Build start
+ESM build/index.js     3.19 KB
+ESM build/index.js.map 5.64 KB
+ESM ⚡️ Build success in 9ms
+DTS Build start
+DTS ⚡️ Build success in 565ms
+DTS build/index.d.ts 103.00 B

package/.turbo/turbo-check.log

@@ -0,0 +1,13 @@
+
+
+> @silkweave/cli@1.3.0 check /Users/atomic/projects/ai/silkweave/packages/cli
+> pnpm lint && pnpm typecheck
+
+
+> @silkweave/cli@1.3.0 lint /Users/atomic/projects/ai/silkweave/packages/cli
+> eslint
+
+
+> @silkweave/cli@1.3.0 typecheck /Users/atomic/projects/ai/silkweave/packages/cli
+> tsc --noEmit
+

package/.turbo/turbo-lint.log

@@ -0,0 +1,5 @@
+
+
+> @silkweave/cli@1.3.0 lint /Users/atomic/projects/ai/silkweave/packages/cli
+> eslint
+

package/.turbo/turbo-prepack.log

@@ -0,0 +1,26 @@
+
+
+> @silkweave/cli@1.3.0 prepack /Users/atomic/projects/ai/mcphero/packages/cli
+> pnpm clean && pnpm build
+
+
+> @silkweave/cli@1.3.0 clean /Users/atomic/projects/ai/mcphero/packages/cli
+> rimraf build
+
+
+> @silkweave/cli@1.3.0 build /Users/atomic/projects/ai/mcphero/packages/cli
+> tsup
+
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Using tsup config: /Users/atomic/projects/ai/mcphero/packages/cli/tsup.config.ts
+CLI Target: es2022
+CLI Cleaning output folder
+ESM Build start
+ESM build/index.js     3.19 KB
+ESM build/index.js.map 5.64 KB
+ESM ⚡️ Build success in 9ms
+DTS Build start
+DTS ⚡️ Build success in 613ms
+DTS build/index.d.ts 103.00 B

package/README.md

@@ -0,0 +1,67 @@
+# @silkweave/cli
+
+CLI adapter for [Silkweave](https://github.com/atomicbi/silkweave) — turn your actions into a complete command-line application with help text, option parsing, and styled terminal output via clack.
+
+## Install
+
+```bash
+pnpm add @silkweave/core @silkweave/cli
+```
+
+## Usage
+
+```typescript
+import { silkweave } from '@silkweave/core'
+import { cli } from '@silkweave/cli'
+import { GreetAction } from './actions/greet.js'
+
+await silkweave({ name: 'mytool', description: 'My CLI Tool', version: '1.0.0' })
+  .adapter(cli())
+  .action(GreetAction)
+  .start()
+```
+
+```
+$ mytool greet --name "World" --enthusiastic
+◇ mytool - greet
+ℹ HELLO, WORLD!!!
+```
+
+## How Zod Types Map to CLI Options
+
+| Zod Type | CLI Representation |
+|----------|-------------------|
+| `z.string()` | `--option-name <string>` |
+| `z.number()` | `--option-name <number>` |
+| `z.boolean()` | `--option-name` / `--no-option-name` |
+| `z.enum([...])` | `--option-name <choice>` with choices validation |
+| `z.record()` | `--option-name <json>` |
+| `.default(value)` | Sets the default in help text |
+| `.describe('...')` | Sets the option description |
+
+Field names are automatically converted to `kebab-case`. Action names become subcommands.
+
+## Positional Arguments
+
+Use the `args` property on an action to promote fields to positional arguments:
+
+```typescript
+const DeployAction = createAction({
+  name: 'deploy',
+  input: z.object({
+    environment: z.string(),
+    dryRun: z.boolean().default(false)
+  }),
+  args: ['environment'],
+  // ...
+})
+```
+
+```
+$ mytool deploy production --dry-run
+```
+
+## See Also
+
+- [Silkweave README](https://github.com/atomicbi/silkweave) — Full documentation
+- [`@silkweave/core`](https://www.npmjs.com/package/@silkweave/core) — Core library

package/build/index.d.ts

@@ -0,0 +1,5 @@
+import { AdapterFactory } from '@silkweave/core';
+
+declare const cli: AdapterFactory;
+
+export { cli };

package/build/index.js

@@ -0,0 +1,85 @@
+// src/adapter/cli.ts
+import { intro, log } from "@clack/prompts";
+import { unwrap } from "@silkweave/core";
+import { createCLILogger } from "@silkweave/logger";
+import { camelCase, kebabCase } from "change-case";
+import { Command } from "commander";
+import z from "zod";
+function handleCLIError(error) {
+  if (error instanceof z.ZodError) {
+    log.error("Validation Error", { withGuide: false });
+    for (const issue of error.issues) {
+      log.error(`${issue.path}: ${issue.message}`);
+    }
+  } else if (error instanceof Error) {
+    log.error(error.message);
+  } else if (typeof error === "string") {
+    log.error(error);
+  } else {
+    log.error(JSON.stringify(error));
+  }
+}
+function parseCLIInput(action, args) {
+  const tmpArgs = args.slice(0, -1);
+  const rawInput = tmpArgs.pop();
+  action.args?.forEach((k, index) => {
+    rawInput[k] = args[index];
+  });
+  const { error, data } = action.input.safeParse(rawInput);
+  if (error || !data) {
+    handleCLIError(error);
+    process.exit();
+  }
+  return data;
+}
+var cli = () => {
+  return (options, baseContext) => {
+    const context = baseContext.fork({ adapter: "cli" });
+    const program = new Command().name(options.name).description(options.description).version(options.version);
+    return {
+      context,
+      start: async (actions) => {
+        for (const action of actions) {
+          const name = kebabCase(action.name);
+          const command = program.command(name).description(action.description);
+          const shape = action.input.shape;
+          const keys = Object.keys(shape);
+          for (const key of keys) {
+            const [type, { defaultValue }] = unwrap(shape[key]);
+            const description = type.description;
+            const isArgument = action.args?.includes(key);
+            if (isArgument) {
+              command.argument(`[${camelCase(key)}]`, description, defaultValue);
+            } else if (type instanceof z.ZodBoolean) {
+              command.option(`--${kebabCase(key)}`, description, defaultValue);
+              command.option(`--no-${kebabCase(key)}`);
+            } else if (type instanceof z.ZodNumber) {
+              command.option(`--${kebabCase(key)} <number>`, description, defaultValue);
+            } else if (type instanceof z.ZodString || type instanceof z.ZodEnum) {
+              command.option(`--${kebabCase(key)} <string>`, description, defaultValue);
+            } else if (type instanceof z.ZodObject || type instanceof z.ZodRecord || type instanceof z.ZodArray) {
+              command.option(`--${kebabCase(key)} <json>`, description ?? "", JSON.parse, defaultValue);
+            } else {
+              throw new Error(`Invalid zod type: ${type.def.type}`);
+            }
+          }
+          command.action((...args) => {
+            const logger = createCLILogger();
+            const input = parseCLIInput(action, args);
+            intro(`${options.name} - ${action.name}`);
+            action.run(input, context.fork({ logger, command })).then((result) => {
+              logger.info(JSON.stringify(result, null, 2));
+            }).catch(handleCLIError);
+          });
+        }
+        program.parse();
+      },
+      stop: async () => {
+      }
+    };
+  };
+};
+export {
+  cli
+};
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapter/cli.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { intro, log } from '@clack/prompts'\nimport { Action, AdapterFactory, unwrap } from '@silkweave/core'\nimport { createCLILogger } from '@silkweave/logger'\nimport { camelCase, kebabCase } from 'change-case'\nimport { Command } from 'commander'\nimport z from 'zod'\n\nfunction handleCLIError(error: unknown) {\n  if (error instanceof z.ZodError) {\n    log.error('Validation Error', { withGuide: false })\n    for (const issue of error.issues) {\n      log.error(`${issue.path}: ${issue.message}`)\n    }\n  } else if (error instanceof Error) {\n    log.error(error.message)\n  } else if (typeof error === 'string') {\n    log.error(error)\n  } else {\n    log.error(JSON.stringify(error))\n  }\n}\n\nfunction parseCLIInput(action: Action, args: any[]) {\n  const tmpArgs = args.slice(0, -1)\n  const rawInput = tmpArgs.pop()\n  action.args?.forEach((k, index) => { rawInput[k] = args[index] })\n  const { error, data } = action.input.safeParse(rawInput)\n  if (error || !data) {\n    handleCLIError(error)\n    process.exit()\n  }\n\n  return data\n}\n\nexport const cli: AdapterFactory = () => {\n  return (options, baseContext) => {\n    const context = baseContext.fork({ adapter: 'cli' })\n    const program = new Command()\n      .name(options.name)\n      .description(options.description)\n      .version(options.version)\n\n    return {\n      context,\n      start: async (actions) => {\n        for (const action of actions) {\n          const name = kebabCase(action.name)\n          const command = program.command(name).description(action.description)\n          const shape = action.input.shape\n          const keys = Object.keys(shape)\n          for (const key of keys) {\n            const [type, { defaultValue }] = unwrap(shape[key])\n            const description = type.description\n            const isArgument = action.args?.includes(key)\n            if (isArgument) {\n              command.argument(`[${camelCase(key)}]`, description, defaultValue)\n            } else if (type instanceof z.ZodBoolean) {\n              command.option(`--${kebabCase(key)}`, description, defaultValue)\n              command.option(`--no-${kebabCase(key)}`)\n            } else if (type instanceof z.ZodNumber) {\n              command.option(`--${kebabCase(key)} <number>`, description, defaultValue)\n            } else if (type instanceof z.ZodString || type instanceof z.ZodEnum) {\n              command.option(`--${kebabCase(key)} <string>`, description, defaultValue)\n            } else if (type instanceof z.ZodObject || type instanceof z.ZodRecord || type instanceof z.ZodArray) {\n              command.option(`--${kebabCase(key)} <json>`, description ?? '', JSON.parse, defaultValue)\n            } else {\n              throw new Error(`Invalid zod type: ${type.def.type}`)\n            }\n          }\n          command.action((...args) => {\n            const logger = createCLILogger()\n            const input = parseCLIInput(action, args)\n            intro(`${options.name} - ${action.name}`)\n            action.run(input, context.fork({ logger, command })).then((result) => {\n              logger.info(JSON.stringify(result, null, 2))\n            }).catch(handleCLIError)\n          })\n        }\n        program.parse()\n      },\n      stop: async () => { }\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@silkweave/cli",
+  "version": "1.3.0",
+  "description": "Silkweave CLI Adapter",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/atomicbi/silkweave.git",
+    "directory": "packages/cli"
+  },
+  "type": "module",
+  "main": "build/index.js",
+  "types": "build/index.d.ts",
+  "dependencies": {
+    "@clack/prompts": "^1.0.1",
+    "change-case": "^5.4.4",
+    "commander": "^13.1.0",
+    "zod": "^4.3.6",
+    "@silkweave/core": "1.3.0",
+    "@silkweave/logger": "1.3.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@stylistic/eslint-plugin": "^5.10.0",
+    "@types/node": "^22.0.0",
+    "rimraf": "^6.1.3",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.56.1"
+  },
+  "scripts": {
+    "clean": "rimraf build",
+    "build": "tsup",
+    "watch": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint",
+    "check": "pnpm lint && pnpm typecheck"
+  }
+}