@mbsi/mkcmd 0.2.0

package/README.md

@@ -0,0 +1,109 @@
+# mkcmd
+
+A remote node executable for scaffolding other remote node executables with sensible defaults.
+
+## Features
+
+- **Interactive Project Setup** - Prompts for project name, target directory, and description using `@clack/prompts`
+- **Full CLI Scaffold** - Generates a complete CLI project structure with configuration files
+- **Core Utilities Included** - Ships with `file-builder.ts` and `file-utils.ts` for dynamic code generation
+- **TypeScript & Bun** - Pre-configured TypeScript settings and Bun runtime support
+- **Dynamic Core Copying** - Automatically copies all core CLI files to your new project
+
+## What Gets Scaffolding
+
+When you run `mkcmd init`, it creates:
+
+```
+project-name/
+├── src/
+│   ├── core/
+│   │   ├── cli.ts          # CLI framework with command registration
+│   │   ├── log.ts          # Logging helpers (single/multi info/warn/err, title)
+│   │   ├── file-builder.ts # Indentation-aware file builder
+│   │   └── file-utils.ts   # Path caching and file writing utilities
+│   ├── commands/
+│   │   └── index.ts        # Command registration hook
+│   └── config.ts           # Project configuration
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+## Installation
+
+### For Development
+
+```bash
+bun install
+```
+
+### From npm (after publishing)
+
+```bash
+npm install -g mkcmd
+# or
+bun install -g mkcmd
+```
+
+## Usage
+
+### Development
+
+```bash
+# Show help
+bun run src/index.ts --help
+
+# Show version
+bun run src/index.ts --version
+
+# Initialize a new CLI project
+bun run src/index.ts init
+```
+
+### Using Built Distribution
+
+```bash
+# Build for Bun runtime
+bun run build
+bun dist/index.js --help
+
+# Build standalone executable
+bun run build:exe
+./dist/mkcmd --help
+```
+
+### After Installation (from npm)
+
+```bash
+mkcmd --help
+mkcmd init
+```
+
+The `init` command will prompt you for:
+- Project name
+- Target directory (defaults to `./<project-name>`)
+- Project description
+
+## Building for npm
+
+To build and prepare for publishing:
+
+```bash
+# Build the bundled JS file (requires Bun runtime)
+bun run build
+
+# Build standalone executable (works without Bun)
+bun run build:exe
+
+# Publish to npm
+npm publish
+```
+
+**Note**: The default build (`bun run build`) produces a bundled JS file that requires Bun to run. The standalone executable (`bun run build:exe`) works independently but is platform-specific.
+
+## Development
+
+This project was created using `bun init` in bun v1.2.13. [Bun](https://bun.sh) is a fast all-in-one JavaScript runtime.
+
+See [AGENTS.md](./AGENTS.md) for development guidelines and [RETRO.md](./RETRO.md) for session retrospective.

package/bun.lock

@@ -0,0 +1,44 @@
+{
+  "lockfileVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "mkcmd",
+      "dependencies": {
+        "@clack/prompts": "^0.11.0",
+        "@types/figlet": "^1.7.0",
+        "figlet": "^1.9.4",
+      },
+      "devDependencies": {
+        "@types/bun": "latest",
+      },
+      "peerDependencies": {
+        "typescript": "^5",
+      },
+    },
+  },
+  "packages": {
+    "@clack/core": ["@clack/core@0.5.0", "", { "dependencies": { "picocolors": "^1.0.0", "sisteransi": "^1.0.5" } }, "sha512-p3y0FIOwaYRUPRcMO7+dlmLh8PSRcrjuTndsiA0WAFbWES0mLZlrjVoBRZ9DzkPFJZG6KGkJmoEAY0ZcVWTkow=="],
+
+    "@clack/prompts": ["@clack/prompts@0.11.0", "", { "dependencies": { "@clack/core": "0.5.0", "picocolors": "^1.0.0", "sisteransi": "^1.0.5" } }, "sha512-pMN5FcrEw9hUkZA4f+zLlzivQSeQf5dRGJjSUbvVYDLvpKCdQx5OaknvKzgbtXOizhP+SJJJjqEbOe55uKKfAw=="],
+
+    "@types/bun": ["@types/bun@1.3.5", "", { "dependencies": { "bun-types": "1.3.5" } }, "sha512-RnygCqNrd3srIPEWBd5LFeUYG7plCoH2Yw9WaZGyNmdTEei+gWaHqydbaIRkIkcbXwhBT94q78QljxN0Sk838w=="],
+
+    "@types/figlet": ["@types/figlet@1.7.0", "", {}, "sha512-KwrT7p/8Eo3Op/HBSIwGXOsTZKYiM9NpWRBJ5sVjWP/SmlS+oxxRvJht/FNAtliJvja44N3ul1yATgohnVBV0Q=="],
+
+    "@types/node": ["@types/node@25.0.3", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-W609buLVRVmeW693xKfzHeIV6nJGGz98uCPfeXI1ELMLXVeKYZ9m15fAMSaUPBHYLGFsVRcMmSCksQOrZV9BYA=="],
+
+    "bun-types": ["bun-types@1.3.5", "", { "dependencies": { "@types/node": "*" } }, "sha512-inmAYe2PFLs0SUbFOWSVD24sg1jFlMPxOjOSSCYqUgn4Hsc3rDc7dFvfVYjFPNHtov6kgUeulV4SxbuIV/stPw=="],
+
+    "commander": ["commander@14.0.2", "", {}, "sha512-TywoWNNRbhoD0BXs1P3ZEScW8W5iKrnbithIl0YH+uCmBd0QpPOA8yc82DS3BIE5Ma6FnBVUsJ7wVUDz4dvOWQ=="],
+
+    "figlet": ["figlet@1.9.4", "", { "dependencies": { "commander": "^14.0.0" }, "bin": { "figlet": "bin/index.js" } }, "sha512-uN6QE+TrzTAHC1IWTyrc4FfGo2KH/82J8Jl1tyKB7+z5DBit/m3D++Iu5lg91qJMnQQ3vpJrj5gxcK/pk4R9tQ=="],
+
+    "picocolors": ["picocolors@1.1.1", "", {}, "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA=="],
+
+    "sisteransi": ["sisteransi@1.0.5", "", {}, "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
+  }
+}