box0-cli 0.1.0

package/.github/workflows/test.yml

@@ -0,0 +1,26 @@
+name: Test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [18, 20, 22]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+
+      - run: npm ci
+      - run: npm run build
+      - run: npm test

package/AGENTS.md

@@ -0,0 +1,12 @@
+# box0
+
+
+## Plan-driven Development
+- Always plan a markdown at plans/ before you code
+- Remember to update the related plans after you finish your work.
+- When every task is completed, make sure you check the task checkbox in the corresponding plan.
+- A plan should at least contain `features`/`show case`, `designs overview`, `TODOS`, `new deps`, `test cases` sections.
+  - always use the features/show case to present what you're going to build.
+  - use checklist in `TODOS` section, for each checkbox, you must have a clear descripion of what to do and list all the files that will be modified.
+  - in `new deps` section, you must list all the new external dependencies that will be added.
+  - in `test cases` section, use checklist format to list all the test cases that should be covered.

package/README.md

@@ -0,0 +1,51 @@
+# box0-cli
+
+Production-ready TypeScript CLI baseline for the box0 project. Command name: **box0**.
+
+## Requirements
+
+- Node.js ≥ 18
+
+## Install
+
+```bash
+npm install -g box0-cli
+```
+
+Or link locally during development:
+
+```bash
+npm run build
+npm link
+box0 <command>
+```
+
+## Usage
+
+```bash
+# Show help and version
+box0 --help
+box0 --version
+
+# Test command (verifies the command system)
+box0 ping          # prints: pong
+
+# Unknown commands show an error and exit with code 1
+box0 foo
+```
+
+## Development
+
+```bash
+npm install
+npm run build
+```
+
+## Exit codes
+
+- `0` — success (help, version, or a successful command like `ping`)
+- `1` — usage error (unknown command or invalid usage)
+
+## License
+
+MIT

package/bin/box0.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+await import(join(__dirname, "..", "dist", "index.js"));

package/dist/index.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { createRequire } from "module";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import chalk from "chalk";
+import { Command } from "commander";
+
+// src/commands/ping.ts
+function registerPing(program2) {
+  program2.command("ping").description("Test command \u2014 prints pong to verify the command system works").action(() => {
+    console.log("pong");
+  });
+}
+
+// src/index.ts
+var __dirname = dirname(fileURLToPath(import.meta.url));
+var require2 = createRequire(import.meta.url);
+var pkg = require2(join(__dirname, "..", "package.json"));
+var program = new Command();
+program.configureOutput({
+  outputError: (str, write) => {
+    if (str.includes("unknown command")) {
+      const cmd = process.argv[2] ?? "unknown";
+      write(chalk.red(`Unknown command '${cmd}'. See box0 --help.
+`));
+    } else {
+      write(str);
+    }
+  }
+});
+program.name("box0").description("box0 CLI \u2014 production-ready TypeScript CLI baseline").version(pkg.version);
+registerPing(program);
+program.exitOverride((err) => {
+  if (err.code === "commander.unknownCommand") {
+    process.exit(1);
+  }
+  process.exit(err.exitCode ?? 1);
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/commands/ping.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { createRequire } from \"module\";\nimport { dirname, join } from \"path\";\nimport { fileURLToPath } from \"url\";\nimport chalk from \"chalk\";\nimport { Command } from \"commander\";\nimport { registerPing } from \"./commands/ping.js\";\nimport { logger } from \"./utils/logger.js\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst require = createRequire(import.meta.url);\nconst pkg = require(join(__dirname, \"..\", \"package.json\")) as { version: string };\n\nconst program = new Command();\n\nprogram.configureOutput({\n  outputError: (str, write) => {\n    if (str.includes(\"unknown command\")) {\n      const cmd = process.argv[2] ?? \"unknown\";\n      write(chalk.red(`Unknown command '${cmd}'. See box0 --help.\\n`));\n    } else {\n      write(str);\n    }\n  },\n});\n\nprogram\n  .name(\"box0\")\n  .description(\"box0 CLI — production-ready TypeScript CLI baseline\")\n  .version(pkg.version);\n\nregisterPing(program);\n\nprogram.exitOverride((err) => {\n  if (err.code === \"commander.unknownCommand\") {\n    process.exit(1);\n  }\n  process.exit(err.exitCode ?? 1);\n});\n\nprogram.parse();","import { Command } from \"commander\";\n\nexport function registerPing(program: Command): void {\n  program\n    .command(\"ping\")\n    .description(\"Test command — prints pong to verify the command system works\")\n    .action(() => {\n      console.log(\"pong\");\n    });\n}\n"],"mappings":";;;AACA,SAAS,qBAAqB;AAC9B,SAAS,SAAS,YAAY;AAC9B,SAAS,qBAAqB;AAC9B,OAAO,WAAW;AAClB,SAAS,eAAe;;;ACHjB,SAAS,aAAaA,UAAwB;AACnD,EAAAA,SACG,QAAQ,MAAM,EACd,YAAY,oEAA+D,EAC3E,OAAO,MAAM;AACZ,YAAQ,IAAI,MAAM;AAAA,EACpB,CAAC;AACL;;;ADAA,IAAM,YAAY,QAAQ,cAAc,YAAY,GAAG,CAAC;AACxD,IAAMC,WAAU,cAAc,YAAY,GAAG;AAC7C,IAAM,MAAMA,SAAQ,KAAK,WAAW,MAAM,cAAc,CAAC;AAEzD,IAAM,UAAU,IAAI,QAAQ;AAE5B,QAAQ,gBAAgB;AAAA,EACtB,aAAa,CAAC,KAAK,UAAU;AAC3B,QAAI,IAAI,SAAS,iBAAiB,GAAG;AACnC,YAAM,MAAM,QAAQ,KAAK,CAAC,KAAK;AAC/B,YAAM,MAAM,IAAI,oBAAoB,GAAG;AAAA,CAAuB,CAAC;AAAA,IACjE,OAAO;AACL,YAAM,GAAG;AAAA,IACX;AAAA,EACF;AACF,CAAC;AAED,QACG,KAAK,MAAM,EACX,YAAY,0DAAqD,EACjE,QAAQ,IAAI,OAAO;AAEtB,aAAa,OAAO;AAEpB,QAAQ,aAAa,CAAC,QAAQ;AAC5B,MAAI,IAAI,SAAS,4BAA4B;AAC3C,YAAQ,KAAK,CAAC;AAAA,EAChB;AACA,UAAQ,KAAK,IAAI,YAAY,CAAC;AAChC,CAAC;AAED,QAAQ,MAAM;","names":["program","require"]}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "box0-cli",
+  "version": "0.1.0",
+  "description": "Make your coding agent works like OpenClawd",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "box0": "./bin/box0.js"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "start": "box0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "cli",
+    "box0"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^4.0.18"
+  }
+}

package/src/commands/ping.ts

@@ -0,0 +1,10 @@
+import { Command } from "commander";
+
+export function registerPing(program: Command): void {
+  program
+    .command("ping")
+    .description("Test command — prints pong to verify the command system works")
+    .action(() => {
+      console.log("pong");
+    });
+}

package/src/index.ts

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+import { createRequire } from "module";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import chalk from "chalk";
+import { Command } from "commander";
+import { registerPing } from "./commands/ping.js";
+import { logger } from "./utils/logger.js";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+const pkg = require(join(__dirname, "..", "package.json")) as { version: string };
+
+const program = new Command();
+
+program.configureOutput({
+  outputError: (str, write) => {
+    if (str.includes("unknown command")) {
+      const cmd = process.argv[2] ?? "unknown";
+      write(chalk.red(`Unknown command '${cmd}'. See box0 --help.\n`));
+    } else {
+      write(str);
+    }
+  },
+});
+
+program
+  .name("box0")
+  .description("box0 CLI — production-ready TypeScript CLI baseline")
+  .version(pkg.version);
+
+registerPing(program);
+
+program.exitOverride((err) => {
+  if (err.code === "commander.unknownCommand") {
+    process.exit(1);
+  }
+  process.exit(err.exitCode ?? 1);
+});
+
+program.parse();

package/src/utils/logger.ts

@@ -0,0 +1,16 @@
+import chalk from "chalk";
+
+export const logger = {
+  info(msg: string): void {
+    console.log(chalk.blue(msg));
+  },
+  success(msg: string): void {
+    console.log(chalk.green(msg));
+  },
+  warn(msg: string): void {
+    console.warn(chalk.yellow(msg));
+  },
+  error(msg: string): void {
+    console.error(chalk.red(msg));
+  },
+};

package/tests/cli.test.ts

@@ -0,0 +1,67 @@
+import { execFile } from "child_process";
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { describe, expect, it } from "vitest";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const BIN = join(__dirname, "..", "bin", "box0.js");
+const PKG = JSON.parse(
+  readFileSync(join(__dirname, "..", "package.json"), "utf-8"),
+);
+
+interface RunResult {
+  stdout: string;
+  stderr: string;
+  exitCode: number;
+}
+
+function run(...args: string[]): Promise<RunResult> {
+  return new Promise((resolve) => {
+    execFile("node", [BIN, ...args], (error, stdout, stderr) => {
+      resolve({
+        stdout: stdout.trim(),
+        stderr: stderr.trim(),
+        exitCode: error?.code ? Number(error.code) : 0,
+      });
+    });
+  });
+}
+
+describe("box0 --help", () => {
+  it("exits 0 and shows program name and commands", async () => {
+    const { stdout, exitCode } = await run("--help");
+    expect(exitCode).toBe(0);
+    expect(stdout).toContain("box0");
+    expect(stdout).toContain("ping");
+  });
+});
+
+describe("box0 --version", () => {
+  it("exits 0 and prints version from package.json", async () => {
+    const { stdout, exitCode } = await run("--version");
+    expect(exitCode).toBe(0);
+    expect(stdout).toBe(PKG.version);
+  });
+});
+
+describe("box0 ping", () => {
+  it("exits 0 and prints pong", async () => {
+    const { stdout, exitCode } = await run("ping");
+    expect(exitCode).toBe(0);
+    expect(stdout).toBe("pong");
+  });
+});
+
+describe("box0 <unknown command>", () => {
+  it("exits 1", async () => {
+    const { exitCode } = await run("unknowncmd");
+    expect(exitCode).toBe(1);
+  });
+
+  it("shows a helpful error message", async () => {
+    const { stderr } = await run("unknowncmd");
+    expect(stderr).toContain("Unknown command");
+    expect(stderr).toContain("--help");
+  });
+});

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/tsup.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+  entry: ["src/index.ts"],
+  format: ["esm"],
+  target: "node18",
+  clean: true,
+  outDir: "dist",
+  sourcemap: true,
+});