@wirecat/cli-template 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -3,6 +3,18 @@
 Notable changes to `@wirecat/cli-template`. One section per version, newest first; versions follow
 [semantic versioning](https://semver.org), so before `1.0.0` the skeleton may still change.
 
+## 0.1.1 — 25.10.2026
+
+### Fixed
+
+- **`npx @wirecat/cli-template new` works.** It stopped with `template.json lists ".gitignore", but the package has
+  no such file`, because npm renames `.gitignore` when it installs a package. The package now ships the file under
+  another name, and `new` and `upgrade` write it as `.gitignore`.
+- **`new` and `upgrade` work on Windows.** `new` now marks `bin/release` and the other scripts as executable in
+  git, so a CLI made on Windows can still run them on Linux and macOS. `upgrade` no longer reads every file as
+  edited when git checked it out with Windows line endings, and it downloads the earlier template version without
+  needing a shell for `npm`.
+
 ## 0.1.0 — 25.10.2026
 
 ### Added

package/config/wirecat/biome.base.json

@@ -120,6 +120,23 @@
         "!**/fixtures/**"
       ]
     },
+    {
+      "path": "./config/wirecat/no-sqlite-driver.grit",
+      "includes": [
+        "**",
+        "!**/*.test.*",
+        "!**/*.spec.*",
+        "!**/test/**",
+        "!**/tests/**",
+        "!**/__tests__/**",
+        "!**/fixtures/**",
+        "!**/testing/**",
+        "!**/scripts/**",
+        "!**/bench/**",
+        "!**/performance/**",
+        "!**/contracts/**"
+      ]
+    },
     {
       "path": "./config/wirecat/no-unbounded-spread.grit",
       "includes": [

package/config/wirecat/manifest.json

@@ -2,7 +2,7 @@
   "source": "https://github.com/WireCatLabs/community",
   "revision": "2b0f124f6375939bba10c28a7f091923323e9a13",
   "files": {
-    "biome.base.json": "5d265b71896cdb0454260fa8d897bd517f61de512f16831e5d5273f29775f9f3",
+    "biome.base.json": "63760337a2e68522ad75e0ba163635785a01ec34dbd3cf338a09a4145932cf2a",
     "cspell.json": "8241122ed4d461976a838099b265ef8f2689a066608257b6fdc250d9b49b58aa",
     "lefthook.yml": "2f65a2e3103006d43f6d6f0a07ab333c132286157763222a59a5a22676acd391",
     "markdownlint.json": "5ed7d6980054c539f3f3c0e47a090f1a725b15be2c486a769a836bc6cd48ad2d",
@@ -14,7 +14,8 @@
     "release-lock-info.mjs": "4abab1f01ceee7d4c709222e923c9a6fc634bcf7b8b64d745a9ac495993310e0",
     "release-lock.sh": "bef364092c4ab595f3b9b4130e23570c8306223228cdfa3e9384230f3b7f4a49",
     "rumdl.toml": "048b929176f13234324f5825d1e811397f1491b9cb6684a1953e268e2c2ed863",
-    "check.mjs": "34b266411eaab7707030915f645308e86784b1574b21fa44ca974861a90c9ce1"
+    "check.mjs": "34b266411eaab7707030915f645308e86784b1574b21fa44ca974861a90c9ce1",
+    "no-sqlite-driver.grit": "19e1f510a88ddd9df44d6db43c1c9b603c3e5bbec03a3f65305b72eac7f09389"
   },
   "packageManager": "pnpm@11.20.0",
   "node": ">=22",
@@ -29,6 +30,8 @@
   },
   "fileRevisions": {
     "release-lock.sh": "49e630a99d758e3e113749bef2049b258c7262e3",
-    "release-lock-info.mjs": "49e630a99d758e3e113749bef2049b258c7262e3"
+    "release-lock-info.mjs": "49e630a99d758e3e113749bef2049b258c7262e3",
+    "biome.base.json": "06c612c609d870f0ba00010612e0413f65340408",
+    "no-sqlite-driver.grit": "06c612c609d870f0ba00010612e0413f65340408"
   }
 }

package/config/wirecat/no-sqlite-driver.grit

@@ -0,0 +1,15 @@
+language js
+
+or {
+  `import $_ from $source`,
+  `import $source`,
+  `export { $_ } from $source`,
+  `export * from $source`,
+  `export * as $_ from $source`,
+  `export type { $_ } from $source`,
+  `import($source)`,
+  `require($source)`
+} where {
+  $source <: r"^[\"'`](?:node:sqlite|bun:sqlite|better-sqlite3|drizzle-orm)(?:/.*)?[\"'`]$",
+  register_diagnostic(span=$source, message="The shared store belongs to cli-core (WC-STORE-5): a CLI opens no SQLite driver and writes no SQL against it. Ask cli-core for a store method.", severity="error")
+}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0";
+export declare const VERSION = "0.1.1";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,2 +1,2 @@
-export const VERSION = "0.1.0";
+export const VERSION = "0.1.1";
 //# sourceMappingURL=version.js.map

package/{.gitignore → gitignore}

@@ -39,4 +39,6 @@ coverage/
 /.claude/workflows
 
 *.tgz
+# The package's copy of this file, made by kit:build.
+/gitignore
 /CLEANUP.md

package/kit/README.md

@@ -116,8 +116,12 @@ A conflict leaves git markers, and `template.json` keeps the new state under `pe
 - `"bin": { "cli-template": "kit/dist/main.js" }`, and `kit/dist` in `files`. No ignore file inside `kit/`: npm
   applies it and drops `kit/dist` from the package. npm also never packs `pnpm-lock.yaml`, so it is not a seed; the
   new CLI makes its own on `pnpm install`.
-- Every template-owned file and seed in `files`. npm drops a nested `.gitignore` and any `.npmrc`; the test in
-  `kit/test/package.test.ts` runs the bin from a real tarball to catch that.
-- `kit:build` (`tsc -p kit`) run by `build`, because `bin/release` publishes with `--ignore-scripts`. Node does not
-  strip types under `node_modules`, so the bin must be JavaScript.
+- Every template-owned file and seed in `files`. npm drops a nested `.gitignore` and any `.npmrc` when it packs.
+  When it installs a package, it renames `.gitignore` to `.npmignore`. So the package ships the root `.gitignore` as
+  `gitignore`, and `new` and `upgrade` read it back as `.gitignore`. The test in `kit/test/package.test.ts` runs the
+  bin from a tarball installed with `npm install` to catch that.
+- `kit:build` (`tsc -p kit`, then the copy to `gitignore`) run by `build`, because `bin/release` and CI pack with
+  `--ignore-scripts`. Node does not strip types under `node_modules`, so the bin must be JavaScript.
+- `pnpm kit:e2e` packs this repository, installs the tarball with npm, runs `new` and then `pnpm install` and
+  `pnpm ci:quick` in the new CLI. It needs the network and takes a few minutes, so it is not part of `pnpm test`.
 - `kit/test/**/*.test.ts` in vitest's `include`; `kit/dist` is ignored by the root `**/dist` rules of Biome and git.

package/kit/dist/new.js

@@ -5,7 +5,7 @@ import { createInterface } from "node:readline/promises";
 import { promisify } from "node:util";
 import { ask, choiceList, INTERVIEW, labelOf, NAME_QUESTIONS, parseAnswer } from "./interview.js";
 import { MANIFEST, sha256 } from "./manifest.js";
-import { renderTemplate } from "./source.js";
+import { PACKED_AS, renderTemplate } from "./source.js";
 const run = promisify(execFile);
 const REFERENCES = {
     messenger: ["whatsapp-cli", "tg-cli", "max-cli"],
@@ -140,7 +140,7 @@ export const cliPackageJson = (text, names) => {
         next.bin = Object.fromEntries(Object.entries(pkg.bin).filter(([, value]) => !isKit(value)));
     }
     if (Array.isArray(pkg.files))
-        next.files = pkg.files.filter((entry) => !isKit(entry));
+        next.files = pkg.files.filter((entry) => !isKit(entry) && !Object.values(PACKED_AS).includes(entry));
     if (typeof pkg.scripts === "object" && pkg.scripts) {
         next.scripts = Object.fromEntries(Object.entries(pkg.scripts)
             .filter(([key]) => !key.startsWith("kit:"))
@@ -192,6 +192,12 @@ const writeOut = async (dir, path, content, mode = 0o644) => {
     await writeFile(full, content);
     await chmod(full, mode);
 };
+// Git for Windows sets core.fileMode=false, so a later `git add -A` there records every file as 644; a mode set
+// in the index survives that add.
+export const markExecutable = async (cwd, paths) => {
+    if (paths.length)
+        await run("git", ["add", "--chmod=+x", "--", ...paths], { cwd });
+};
 export const manualSteps = (names) => [
     `1. Create the repository ${names.owner}/${names.name} and its main ruleset (cli-base docs/standards/new-cli.md).`,
     `2. Set npm trusted publishing for ${names.package}, naming release.yml (WC-REL-11), and add any secrets.`,
@@ -232,6 +238,7 @@ export const runNew = async (cwd, source, args, io) => {
     };
     await writeOut(target, MANIFEST, `${JSON.stringify(manifest, null, 2)}\n`);
     await run("git", ["init", "-q", "-b", "main"], { cwd: target });
+    await markExecutable(target, [...rendered].filter(([, file]) => file.mode & 0o111).map(([path]) => path));
     const warnings = languageWarnings(answers.contentLang ?? []);
     return [
         `Created ${target} from ${source.name}@${source.version}.`,

package/kit/dist/rename.js

@@ -19,6 +19,7 @@ export const renamer = (placeholders, names) => {
     return (text) => text.replace(pattern, (match) => table.get(match) ?? match);
 };
 const isBinary = (content) => content.subarray(0, 8000).includes(0);
+export const withLf = (content) => isBinary(content) || !content.includes(13) ? content : Buffer.from(content.toString("utf8").replaceAll("\r\n", "\n"));
 export const renameContent = (rename, content) => isBinary(content) ? content : Buffer.from(rename(content.toString("utf8")), "utf8");
 const KIT_CONFIG = /(^|\/)(vitest\.config\.ts|biome\.json|cspell\.json|tsconfig[^/]*\.json|\.markdownlint-cli2\.jsonc)$/;
 // The template's configs name kit/ so its own checks cover the copy tool; a CLI has no kit/, and the

package/kit/dist/source.js

@@ -1,7 +1,8 @@
 import { execFile } from "node:child_process";
+import { existsSync } from "node:fs";
 import { mkdtemp, readdir, readFile, rm, stat } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { join, relative, sep } from "node:path";
+import { dirname, join, relative, sep } from "node:path";
 import { fileURLToPath } from "node:url";
 import { promisify } from "node:util";
 import { classify, MANIFEST, parseTemplateManifest, readJson, } from "./manifest.js";
@@ -18,6 +19,15 @@ export const loadSource = async (root) => {
     return { root, name: pkg.name, version: pkg.version, manifest };
 };
 const SKIP_DIRS = new Set([".git", "node_modules"]);
+// npm renames .gitignore to .npmignore when it installs a package, so the package ships it as gitignore.
+export const PACKED_AS = { ".gitignore": "gitignore" };
+const onDisk = async (root, path) => {
+    const packed = PACKED_AS[path];
+    const full = join(root, path);
+    if (!packed)
+        return full;
+    return (await stat(full).catch(() => undefined)) ? full : join(root, packed);
+};
 const walk = async (dir) => {
     const entries = await readdir(dir, { withFileTypes: true });
     const nested = await Promise.all(entries.map(async (entry) => {
@@ -29,7 +39,7 @@ const walk = async (dir) => {
     return nested.flat();
 };
 const listEntry = async (root, entry) => {
-    const path = join(root, entry);
+    const path = await onDisk(root, entry);
     const info = await stat(path).catch(() => undefined);
     if (!info)
         throw new Error(`${MANIFEST} lists "${entry}", but the package has no such ${entry.endsWith("/") ? "folder" : "file"}`);
@@ -45,26 +55,40 @@ export const listTemplate = async (source) => {
         return kind ? [[path, kind]] : [];
     }));
 };
+// npm cannot set the executable bit when it installs on Windows, so a shebang stands in for it there. A .ts or .js
+// entry point carries one for node, not for the shell.
+const isExecutable = (path, content, mode) => (mode & 0o111) !== 0 || (content.subarray(0, 2).toString() === "#!" && !/\.[cm]?[jt]sx?$/.test(path));
 export const renderTemplate = async (source, names) => {
     const rename = renamer(source.manifest.placeholders, names);
     const listed = await listTemplate(source);
     const rendered = await Promise.all([...listed].map(async ([path, kind]) => {
-        const full = join(source.root, path);
+        const full = await onDisk(source.root, path);
         const [content, info] = await Promise.all([readFile(full), stat(full)]);
         const renamed = renameContent(rename, stripKit(path, content));
-        return [rename(path), { kind, content: renamed, mode: info.mode & 0o777 }];
+        const mode = isExecutable(path, content, info.mode) ? 0o755 : 0o644;
+        return [rename(path), { kind, content: renamed, mode }];
     }));
     return new Map(rendered);
 };
+// On Windows npm is npm.cmd, which execFile cannot start without a shell; npm-cli.js beside node runs anywhere.
+export const npmCommand = (args) => {
+    const home = dirname(process.execPath);
+    const cli = [
+        join(home, "node_modules/npm/bin/npm-cli.js"),
+        join(home, "../lib/node_modules/npm/bin/npm-cli.js"),
+    ].find((path) => existsSync(path));
+    return cli ? [process.execPath, [cli, ...args]] : ["npm", args];
+};
 export const fetchPublished = async (name, version) => {
     const dir = await mkdtemp(join(tmpdir(), "cli-template-"));
-    const { stdout } = await run("npm", ["pack", `${name}@${version}`, "--silent", "--pack-destination", dir]).catch((error) => {
+    const { stdout } = await run(...npmCommand(["pack", `${name}@${version}`, "--silent", "--pack-destination", dir])).catch((error) => {
         throw new Error(`could not download ${name}@${version} from npm, which upgrade needs as the merge base: ${error.message}`);
     });
     const tarball = stdout.trim().split("\n").pop() ?? "";
     const dispose = () => rm(dir, { recursive: true, force: true });
     try {
-        await run("tar", ["-xzf", join(dir, tarball), "-C", dir]);
+        // GNU tar reads "C:" in a path as a remote host, so the archive is named relative to its folder.
+        await run("tar", ["-xzf", tarball], { cwd: dir });
         return { source: await loadSource(join(dir, "package")), dispose };
     }
     catch (error) {

package/kit/dist/upgrade.js

@@ -5,10 +5,13 @@ import { dirname, join } from "node:path";
 import { createInterface } from "node:readline/promises";
 import { promisify } from "node:util";
 import { classify, MANIFEST, readCliManifest, sha256 } from "./manifest.js";
+import { markExecutable } from "./new.js";
+import { withLf } from "./rename.js";
 import { renderTemplate } from "./source.js";
 const run = promisify(execFile);
 const MODES = ["apply", "replace", "skip"];
-const readMaybe = (path) => readFile(path).catch(() => undefined);
+// Git for Windows checks text out with CRLF by default; the template's hashes and merges are of LF text.
+const readMaybe = (path) => readFile(path).then(withLf, () => undefined);
 const requireCleanTree = async (cwd) => {
     const { stdout } = await run("git", ["status", "--porcelain"], { cwd }).catch(() => {
         throw new Error(`${cwd} is not a git repository; upgrade needs one so every change can be seen and undone`);
@@ -173,11 +176,14 @@ export const runUpgrade = async (cwd, target, fetchVersion, options, io) => {
     };
     const results = [];
     const conflicts = [];
+    const executable = [];
     try {
         for (const change of changes) {
             const { outcome, content } = await planned(change, await choose(change));
             if (content)
                 await writeAs(join(cwd, change.path), content, change.ours ? undefined : change.theirs.mode);
+            if (content && !change.ours && change.theirs.mode & 0o111)
+                executable.push(change.path);
             if (outcome === "conflict")
                 conflicts.push(change.path);
             results.push(`  ${change.path} (${change.state}): ${outcome}`);
@@ -186,6 +192,7 @@ export const runUpgrade = async (cwd, target, fetchVersion, options, io) => {
     finally {
         rl?.close();
     }
+    await markExecutable(cwd, executable);
     const footer = ["Then re-run community's adopt-standards.py for config/wirecat/, which upgrade never touches."];
     const files = Object.fromEntries([...owned].map(([path, file]) => [path, sha256(file.content)]));
     if (conflicts.length) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-template",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Start a new WireCat CLI: a working skeleton on cli-base and cli-core, copied by new and kept current by upgrade",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",
@@ -46,7 +46,7 @@
     "tsconfig.scripts.json",
     "tsconfig.test.json",
     "vitest.config.ts",
-    ".gitignore"
+    "gitignore"
   ],
   "scripts": {
     "build": "tsc --build --force && pnpm kit:build",
@@ -76,8 +76,9 @@
     "prepare": "lefthook install || true",
     "prepack": "pnpm build",
     "docs:spell": "cspell lint --config cspell.json --no-progress README.md",
-    "kit:build": "tsc -p kit",
-    "kit:typecheck": "tsc -p kit/tsconfig.test.json"
+    "kit:build": "tsc -p kit && node -e \"require('node:fs').copyFileSync('.gitignore', 'gitignore')\"",
+    "kit:typecheck": "tsc -p kit/tsconfig.test.json",
+    "kit:e2e": "bash kit/e2e.sh"
   },
   "dependencies": {
     "@modelcontextprotocol/server": "2.3.0",

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = "0.1.0"
+export const VERSION = "0.1.1"