{"_id":"@boldblackai/create-bclaw","_rev":"9-65fa811747eb835e78311f92def5f0cc","name":"@boldblackai/create-bclaw","dist-tags":{"latest":"1.0.2"},"versions":{"0.1.0":{"name":"@boldblackai/create-bclaw","version":"0.1.0","keywords":["create","scaffold","hermes","harness","ecs","fargate","slack","aws"],"license":"MIT","_id":"@boldblackai/create-bclaw@0.1.0","maintainers":[{"name":"boldblack","email":"npm@boldblack.ai"},{"name":"ecanals","email":"enriquecanals@gmail.com"},{"name":"capotej","email":"jcapote@gmail.com"}],"homepage":"https://github.com/boldblackai/create-bclaw#readme","bugs":{"url":"https://github.com/boldblackai/create-bclaw/issues"},"bin":{"create-bclaw":"dist/cli.js"},"dist":{"shasum":"57cfeed6d0d91089facc3455404178e2ffd27eed","tarball":"https://registry.npmjs.org/@boldblackai/create-bclaw/-/create-bclaw-0.1.0.tgz","fileCount":25,"integrity":"sha512-PQdh4I9MirGXY3dROy3YLBnUZxENny0Qddjv5q1T+i5Og302BHm+aU58FZBQ8pI0IoZenEMyrhDJyxnjsZBQgg==","signatures":[{"sig":"MEQCIHkExk2rvvjfDwljZq/mha0sXzTCCFWVMcB4CuX707LaAiAsNpezA5SnaJr4QoYWIDZwfZtrsYvVIhw3fHldzu6Ztw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":188354},"type":"module","engines":{"node":">=22"},"gitHead":"597d39bcdee15ee2ac19954b12e43e01646b5001","scripts":{"lint":"biome check .","test":"tsc && node --test","build":"tsc","format":"biome format --write .","prepare":"tsc","lint:fix":"biome check --write ."},"_npmUser":{"name":"capotej","email":"jcapote@gmail.com"},"deprecated":"Renamed to @boldblackai/create-dispatch — use npx @boldblackai/create-dispatch","repository":{"url":"git+https://github.com/boldblackai/create-bclaw.git","type":"git"},"_npmVersion":"11.12.1","description":"Scaffold a renamed Hermes Agent claw (Slack socket-mode bot on AWS ECS Fargate).","directories":{},"_nodeVersion":"26.0.0","dependencies":{"@clack/prompts":"1.6.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.9.0","devDependencies":{"typescript":"6.0.3","@types/node":"22.20.0","@biomejs/biome":"2.5.1"},"_npmOperationalInternal":{"tmp":"tmp/create-bclaw_0.1.0_1782619555560_0.7183966253504834","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@boldblackai/create-bclaw","version":"0.2.0","keywords":["create","scaffold","hermes","harness","ecs","fargate","slack","aws"],"license":"MIT","_id":"@boldblackai/create-bclaw@0.2.0","maintainers":[{"name":"boldblack","email":"npm@boldblack.ai"},{"name":"ecanals","email":"enriquecanals@gmail.com"},{"name":"capotej","email":"jcapote@gmail.com"}],"homepage":"https://github.com/boldblackai/create-bclaw#readme","bugs":{"url":"https://github.com/boldblackai/create-bclaw/issues"},"bin":{"create-bclaw":"dist/cli.js"},"dist":{"shasum":"f7cb8abd541f7b5f7d863622cdb6414f658ee0b1","tarball":"https://registry.npmjs.org/@boldblackai/create-bclaw/-/create-bclaw-0.2.0.tgz","fileCount":25,"integrity":"sha512-zzVRw3XxqKKwMYQa31PNFa63QZ+3agMzkgJk9qloDT/r4rpkXok9neX16WfICDrJbN0WS1XqBajPrtwyvipcMQ==","signatures":[{"sig":"MEUCIQDOSMrMT9Es8NHejkUhNV9oX/tbV8wXE6pPsGn9EzbSwAIgMewE+XgcNG51ExqCq94gx97UJTLl0UZY7aKet0lh4QE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":205667},"type":"module","engines":{"node":">=22"},"gitHead":"b94528f2623ba89f3887be2316760648b992730c","scripts":{"lint":"biome check .","test":"tsc && node --test","build":"tsc","format":"biome format --write .","prepare":"tsc","lint:fix":"biome check --write ."},"_npmUser":{"name":"capotej","email":"jcapote@gmail.com"},"deprecated":"Renamed to @boldblackai/create-dispatch — use npx @boldblackai/create-dispatch","repository":{"url":"git+https://github.com/boldblackai/create-bclaw.git","type":"git"},"_npmVersion":"11.12.1","description":"Scaffold a renamed Hermes Agent claw (Slack socket-mode bot on AWS ECS Fargate).","directories":{},"_nodeVersion":"26.0.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.9.0","devDependencies":{"typescript":"6.0.3","@types/node":"22.20.0","@biomejs/biome":"2.5.1"},"_npmOperationalInternal":{"tmp":"tmp/create-bclaw_0.2.0_1782661406042_0.16308291687433973","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@boldblackai/create-bclaw","version":"0.3.0","keywords":["create","scaffold","hermes","harness","ecs","fargate","slack","aws"],"license":"MIT","_id":"@boldblackai/create-bclaw@0.3.0","maintainers":[{"name":"boldblack","email":"npm@boldblack.ai"},{"name":"ecanals","email":"enriquecanals@gmail.com"},{"name":"capotej","email":"jcapote@gmail.com"}],"homepage":"https://github.com/boldblackai/create-bclaw#readme","bugs":{"url":"https://github.com/boldblackai/create-bclaw/issues"},"bin":{"create-bclaw":"dist/cli.js"},"dist":{"shasum":"dbb5bba21252a95274c6d098683978b1f579ff44","tarball":"https://registry.npmjs.org/@boldblackai/create-bclaw/-/create-bclaw-0.3.0.tgz","fileCount":22,"integrity":"sha512-MEPu8/NJxDTzZ3ml8jesvv4P8Wn6U8oe9tloRYmI8y3EtqudPtGmryOPSA8tfbAafg0Ejqu+FoUOYUNrH2oeug==","signatures":[{"sig":"MEQCIGtZyV4Bu86RtZUsDMvmLckpWgRjmGhVsiyBhi/gt3j6AiA/SFXE3Ua+XM4upyHzVTC4VKpdnR4nfWrsw0099VvcMg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":162024},"type":"module","engines":{"node":">=22"},"gitHead":"598127498551af0ccd0c706260b425226be1a75b","scripts":{"lint":"biome check .","test":"tsc && node --test","build":"tsc","format":"biome format --write .","prepare":"tsc","lint:fix":"biome check --write ."},"_npmUser":{"name":"capotej","email":"jcapote@gmail.com"},"deprecated":"Renamed to @boldblackai/create-dispatch — use npx @boldblackai/create-dispatch","repository":{"url":"git+https://github.com/boldblackai/create-bclaw.git","type":"git"},"_npmVersion":"11.12.1","description":"Scaffold a renamed Hermes Agent claw (Slack socket-mode bot on AWS ECS Fargate).","directories":{},"_nodeVersion":"26.0.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.9.0","devDependencies":{"typescript":"6.0.3","@types/node":"22.20.0","@biomejs/biome":"2.5.1"},"_npmOperationalInternal":{"tmp":"tmp/create-bclaw_0.3.0_1782748732356_0.8364131995402446","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@boldblackai/create-bclaw","version":"0.3.1","keywords":["create","scaffold","hermes","harness","ecs","fargate","slack","aws"],"license":"MIT","_id":"@boldblackai/create-bclaw@0.3.1","maintainers":[{"name":"boldblack","email":"npm@boldblack.ai"},{"name":"ecanals","email":"enriquecanals@gmail.com"},{"name":"capotej","email":"jcapote@gmail.com"}],"homepage":"https://github.com/boldblackai/create-bclaw#readme","bugs":{"url":"https://github.com/boldblackai/create-bclaw/issues"},"bin":{"create-bclaw":"dist/cli.js"},"dist":{"shasum":"2f0e5030ab6f7d744633959b2a4109f97d3d7cff","tarball":"https://registry.npmjs.org/@boldblackai/create-bclaw/-/create-bclaw-0.3.1.tgz","fileCount":22,"integrity":"sha512-4Pa0+j4W2l+jNLauFUr+HF4piuc+TI+zOYV25iVgBP860z16y7OP+SDKHULEkc5FYNiFkps6Ap7BdDRPf8jh/A==","signatures":[{"sig":"MEUCIHfl//V1fgICOPE3QwJZBw0N6ofWUE8ujsMIWZ9Lzmn5AiEAgRPESOiN8stdi0UTvIPFFFRT2sGfRFuVH+84r+W5+V8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":164606},"type":"module","engines":{"node":">=22"},"gitHead":"738f9ca1c10a2f387710988a789c7b8cf60f10d6","scripts":{"lint":"biome check .","test":"tsc && node --test","build":"tsc","format":"biome format --write .","prepare":"tsc","lint:fix":"biome check --write ."},"_npmUser":{"name":"capotej","email":"jcapote@gmail.com"},"deprecated":"Renamed to @boldblackai/create-dispatch — use npx @boldblackai/create-dispatch","repository":{"url":"git+https://github.com/boldblackai/create-bclaw.git","type":"git"},"_npmVersion":"11.12.1","description":"Scaffold a renamed Hermes Agent claw (Slack socket-mode bot on AWS ECS Fargate).","directories":{},"_nodeVersion":"26.0.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.9.0","devDependencies":{"typescript":"6.0.3","@types/node":"22.20.0","@biomejs/biome":"2.5.1"},"_npmOperationalInternal":{"tmp":"tmp/create-bclaw_0.3.1_1783626739792_0.9919648401197669","host":"s3://npm-registry-packages-npm-production"}},"1.0.0":{"name":"@boldblackai/create-bclaw","version":"1.0.0","keywords":["create","scaffold","hermes","harness","ecs","slack","aws"],"license":"MIT","_id":"@boldblackai/create-bclaw@1.0.0","maintainers":[{"name":"boldblack","email":"npm@boldblack.ai"},{"name":"ecanals","email":"enriquecanals@gmail.com"},{"name":"capotej","email":"jcapote@gmail.com"}],"homepage":"https://github.com/boldblackai/create-bclaw#readme","bugs":{"url":"https://github.com/boldblackai/create-bclaw/issues"},"bin":{"create-bclaw":"dist/cli.js"},"dist":{"shasum":"d7f5634d89d61b7d8bb88a76edd5411c36c5e435","tarball":"https://registry.npmjs.org/@boldblackai/create-bclaw/-/create-bclaw-1.0.0.tgz","fileCount":23,"integrity":"sha512-37ePsF4/idc2AvlIuB86NnfD9D0HjeqS4ZZhyztoI2VOr1f9bwAluyuOegmS+eUZXdFGSJiTmraJtpIgnqzbXw==","signatures":[{"sig":"MEYCIQDC+D9KObrWrQY3J4VPz2CfaBVJBTv2RnXFhxQD1KWe2gIhAJI7SEyTKBUQMjOihpg//rwM2jyiGUB9bOxnbrISKY7V","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":194493},"type":"module","engines":{"node":">=22"},"gitHead":"9dba651b08454e1e5ba69148b9e3ebfee5d6a289","scripts":{"lint":"biome check .","test":"tsc && node --test","build":"tsc","format":"biome format --write .","prepare":"tsc","lint:fix":"biome check --write ."},"_npmUser":{"name":"capotej","email":"jcapote@gmail.com"},"deprecated":"Renamed to @boldblackai/create-dispatch — use npx @boldblackai/create-dispatch","repository":{"url":"git+https://github.com/boldblackai/create-bclaw.git","type":"git"},"_npmVersion":"11.12.1","description":"Deploy your own long-running Hermes agent on Slack + AWS","directories":{},"_nodeVersion":"26.0.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.9.0","devDependencies":{"typescript":"6.0.3","@types/node":"22.20.0","@biomejs/biome":"2.5.1"},"_npmOperationalInternal":{"tmp":"tmp/create-bclaw_1.0.0_1784072411097_0.4143321753901217","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@boldblackai/create-bclaw","version":"1.0.1","keywords":["create","scaffold","hermes","harness","ecs","slack","aws"],"license":"MIT","_id":"@boldblackai/create-bclaw@1.0.1","maintainers":[{"name":"boldblack","email":"npm@boldblack.ai"},{"name":"ecanals","email":"enriquecanals@gmail.com"},{"name":"capotej","email":"jcapote@gmail.com"}],"homepage":"https://bclaw.sh","bugs":{"url":"https://github.com/boldblackai/create-bclaw/issues"},"bin":{"create-bclaw":"dist/cli.js"},"dist":{"shasum":"2fa49ca8b50e1ed5144ae097cfe85f8d3fbbced2","tarball":"https://registry.npmjs.org/@boldblackai/create-bclaw/-/create-bclaw-1.0.1.tgz","fileCount":23,"integrity":"sha512-Ide+uGCyBzLPBAdDgFaOyjXyw1/8ZclunPbu1pJVAa0WhvrlfmlNcJllWTMS3B9k6bV2eYV5epzBRaWAxKJbrA==","signatures":[{"sig":"MEUCIFmJT/DDxE87sn/gEpavxPtBKVSbZF/kFQwYek6RHmkhAiEAq+4ZdUcaSwr/olqT0B+O34seCyvGbqW6SNTg5R9rxfw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":202216},"type":"module","engines":{"node":">=22"},"gitHead":"1eb59f3fcf836957cd1995e574c15d60b53d8644","scripts":{"lint":"pnpm lint:ts && pnpm lint:md","test":"tsc && node --test","build":"tsc","format":"oxfmt --write .","lint:md":"markdownlint-cli2 \"**/*.md\" \"#node_modules\"","lint:ts":"oxlint .","prepare":"tsc","lint:fix":"oxlint --fix .","format:check":"oxfmt --check ."},"_npmUser":{"name":"capotej","email":"jcapote@gmail.com"},"deprecated":"Renamed to @boldblackai/create-dispatch — use npx @boldblackai/create-dispatch","repository":{"url":"git+https://github.com/boldblackai/create-bclaw.git","type":"git"},"_npmVersion":"11.12.1","description":"CLI to generate bclaw repositories","directories":{},"_nodeVersion":"26.0.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.9.0","devDependencies":{"typescript":"^7.0.2","@types/node":"22.20.0","markdownlint-cli2":"0.17.2"},"_npmOperationalInternal":{"tmp":"tmp/create-bclaw_1.0.1_1784213858496_0.6252302381209365","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@boldblackai/create-bclaw","version":"1.0.2","keywords":["create","scaffold","hermes","harness","ecs","slack","aws"],"license":"MIT","_id":"@boldblackai/create-bclaw@1.0.2","maintainers":[{"name":"boldblack","email":"npm@boldblack.ai"},{"name":"ecanals","email":"enriquecanals@gmail.com"},{"name":"capotej","email":"jcapote@gmail.com"}],"homepage":"https://bclaw.sh","bugs":{"url":"https://github.com/boldblackai/create-bclaw/issues"},"bin":{"create-bclaw":"dist/cli.js"},"dist":{"shasum":"288d1a0479e428fcd9fc25a71c53f18299d85a3d","tarball":"https://registry.npmjs.org/@boldblackai/create-bclaw/-/create-bclaw-1.0.2.tgz","fileCount":24,"integrity":"sha512-7B5k6Zcebw5ZCCRcIYxx1uSj5bl4V3vrh2GWrLIozJyxdoh5RQInSGEBRkVBsmwvgMWiaMZFBh99qmjO2I6HQA==","signatures":[{"sig":"MEYCIQCI7NEar9wcyBGWDklJQnhZnu1tmKM5B8gRevoP66ii1AIhAOXkv0x/qnbLGGFVNFLM95OnUs0ulz1xYZ1v84BiKHU5","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@boldblackai%2fcreate-bclaw@1.0.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":230715},"type":"module","engines":{"node":">=22"},"gitHead":"142a35452612eddcefe0fc8e4fa70aa6287de5ad","scripts":{"lint":"pnpm lint:ts && pnpm lint:md","test":"tsc && node --test","build":"tsc","format":"oxfmt --write .","lint:md":"markdownlint-cli2 \"**/*.md\" \"#node_modules\"","lint:ts":"oxlint .","prepare":"tsc","lint:fix":"oxlint --fix .","format:check":"oxfmt --check ."},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:2a520ac2-9760-46b4-a1f2-1fa0c69ac192"}},"deprecated":"Renamed to @boldblackai/create-dispatch — use npx @boldblackai/create-dispatch","repository":{"url":"git+https://github.com/boldblackai/create-bclaw.git","type":"git"},"_npmVersion":"12.0.2","description":"CLI to generate bclaw repositories","directories":{},"_nodeVersion":"22.23.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.9.0","devDependencies":{"typescript":"^7.0.2","@types/node":"22.20.0","markdownlint-cli2":"0.17.2"},"_npmOperationalInternal":{"tmp":"tmp/create-bclaw_1.0.2_1785612730919_0.29978330941174547","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-06-28T04:05:55.385Z","modified":"2026-08-16T00:01:59.544Z","0.1.0":"2026-06-28T04:05:55.703Z","0.2.0":"2026-06-28T15:43:26.209Z","0.3.0":"2026-06-29T15:58:52.496Z","0.3.1":"2026-07-09T19:52:19.946Z","1.0.0":"2026-07-14T23:40:11.241Z","1.0.1":"2026-07-16T14:57:38.634Z","1.0.2":"2026-08-01T19:32:11.065Z"},"bugs":{"url":"https://github.com/boldblackai/create-bclaw/issues"},"license":"MIT","homepage":"https://bclaw.sh","keywords":["create","scaffold","hermes","harness","ecs","slack","aws"],"repository":{"url":"git+https://github.com/boldblackai/create-bclaw.git","type":"git"},"description":"CLI to generate bclaw repositories","maintainers":[{"name":"boldblack","email":"npm@boldblack.ai"},{"name":"capotej","email":"jcapote@gmail.com"},{"name":"ecanals","email":"enriquecanals@gmail.com"}],"readme":"# @boldblackai/create-bclaw\n\nCreate a repository for your own bclaw, deployed to your own AWS account.\n\n## What is a bclaw?\n\nbclaw is short for \"**B**usinessClaw\": an opinionated deployment of [hermes-agent](https://hermes-agent.nousresearch.com/) configured as a\nlong-running [\"claw\"](https://www.cnet.com/tech/services-and-software/claw-ai-explainer-openclaw-nvidia/) within your Slack workspace.\n\nCreate, customize and deploy as many as you'd like. Each generated bclaw repository corresponds to one specific long-running agent and Slack application/user.\n\nFor example, you could generate a `@swe-pal` for a \"Devin\" type experience: code reviews, pull requests, etc. Or, a `@reportclaw` that posts reports at scheduled times to configured channels.\n\n## How it works\n\n1. Generate your bclaw repository\n\n    npx @boldblackai/create-bclaw swe-pal\n\n2. Follow the instructions in the README to create the IAM user and policy to get the `AWS_ACCESS_KEY_ID` and `AWS_SECRET_ACCESS_KEY` for `.env`. This also\nwalks you through creating and installing the Slack app into your workspace to get the `SLACK_APP_TOKEN` and `SLACK_BOT_TOKEN` you'll need later.\n\n3. The generated repository is a set of skills, so open up `swe-pal` in your favorite harness ([Pi](https://boldblackai.github.io/harness/agents/pi/), [Hermes](https://boldblackai.github.io/harness/agents/hermes/), [OpenCode](https://boldblackai.github.io/harness/agents/opencode/))\n\n4. Run the `/setup-bclaw` skill. This will prompt you for an inference provider, it supports [OpenRouter](https://openrouter.ai/), [ZAI](https://z.ai/subscribe), and [Anthropic](https://www.anthropic.com/) out of the box, but trivial\nto use any that [hermes-agent already supports](https://hermes-agent.nousresearch.com/docs/integrations/providers/).\n\n5. To manage it (update running image version, update skills/SOUL.md, etc) you can use the `/manage-bclaw` skill.\n\n6. To uninstall it, run the `/teardown-bclaw` skill.\n\n## What you get\n\n- [hermes-agent](https://hermes-agent.nousresearch.com/docs) running on AWS ECS (EC2 launch type) — a single container instance in an Auto Scaling Group with a persistent EBS data volume — via our [hardened](https://boldblackai.github.io/harness/security/) [harness](https://github.com/boldblackai/harness) Docker image.\n\n- GitHub & Slack integration\n\n- SQLite-backed persistent state on a retained gp3 EBS volume (local block storage — SQLite WAL is unsafe on NFS).\n\n## Usage\n\n```bash\nnpx @boldblackai/create-bclaw <name>\n# or equivalently\nnpm init @boldblackai/bclaw <name>\n```\n\nIf no name is given (and stdin is a TTY), you'll be prompted for one.\n\n`<name>` must match `^[a-zA-Z]([a-zA-Z0-9-]*[a-zA-Z0-9])?$` and be 1–59 characters. It becomes\nthe CloudFormation stack name, IAM role prefix (`<name>-exec`, `<name>-task`,\n`<name>-instance`), ECS cluster/service, log group, SSM namespace (`/<name>/`),\nKMS alias (`alias/<name>-ssm`), and EBS volume tag (`<name>-data`). The\n59-char ceiling keeps the `-exec`/`-task`/`-instance` role suffixes under\nIAM's 64-char role-name limit. A name containing the literal region token\n`us-east-1` is rejected (it would be corrupted by region substitution).\n\nYou can also pass the AWS region the claw will deploy into. It is substituted\ninto the generated claw (notably the deployer IAM policy's `kms:ViaService`,\nwhich is a static JSON that can't use CloudFormation's `${AWS::Region}`):\n\n```bash\nnpx @boldblackai/create-bclaw <name> --region us-west-2\n```\n\n`--region` must match `^[a-z]{2}(-gov)?-[a-z]+-[0-9]+$` (any AWS region,\nincluding GovCloud/China) and defaults to `us-east-1`. If omitted and stdin\nis a TTY you'll be prompted; otherwise the default is used silently.\n\n### Options\n\n- `--region <region>` — AWS region to bake into the claw (default `us-east-1`). Substituted into the deployer IAM policy's `kms:ViaService` so the claw works in that region.\n- `--force` — generate into a non-empty target directory, merging with existing files (default: refuse).\n- `--version`, `-V` — print the version.\n- `--help`, `-h` — show help.\n\n## Development\n\n```bash\npnpm install          # installs deps + builds dist/ (prepare)\npnpm build            # tsc\npnpm exec tsc --noEmit  # typecheck only\npnpm lint             # oxlint .\npnpm format:check     # oxfmt --check (CI gate)\npnpm test             # tsc && node --test (golden test)\n```\n\n### Publishing\n\nReleases are automated via npm OIDC trusted publishing. Open a release PR\ntitled `release v<version>`; merging it triggers `tag-on-merge.yml` which\ntags, publishes to npm (with provenance), and creates the GitHub release.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}