@wirecat/cli-template 0.0.0-stage → 0.1.1

package/src/program.ts

@@ -0,0 +1,53 @@
+import { join } from "node:path"
+import { resolvePaths } from "@wirecat/cli-base"
+import {
+  commandsCommand,
+  configCommand,
+  createProgram as createSharedProgram,
+  outputFor,
+  type ProgramDefinition,
+  type ProgramOptions,
+  type RunOptions,
+  run as runShared,
+  skillCommand,
+  upgradeCommand,
+} from "@wirecat/cli-core/cli"
+import { appUpdate } from "@wirecat/cli-core/update"
+import type { Command } from "commander"
+import { doctorCommand } from "./commands/doctor.js"
+import { mcpCommand } from "./commands/mcp.js"
+import { configuration } from "./config.js"
+import { IDENTITY, PACKAGE, SKILL } from "./identity.js"
+
+const update = appUpdate({
+  packageName: PACKAGE,
+  command: IDENTITY.command,
+  version: IDENTITY.version,
+  entry: import.meta.url,
+  statePath: (env) =>
+    join(resolvePaths({ appName: IDENTITY.appName, prefix: IDENTITY.envPrefix, env }).state, "update-check.json"),
+  enabled: (env) => configuration.resolveSettings({}, { env, needsProfile: false }).updateCheck,
+  offVariables: [`${IDENTITY.envPrefix}_NO_UPDATE_CHECK`],
+})
+
+export const definition = (): ProgramDefinition => ({
+  app: IDENTITY,
+  configuration: { resolveSettings: configuration.resolveSettings },
+  commands: () => [
+    commandsCommand(IDENTITY),
+    doctorCommand(),
+    skillCommand(IDENTITY, SKILL),
+    mcpCommand(),
+    upgradeCommand(IDENTITY, PACKAGE, (command) => ({
+      ...outputFor(command),
+      installer: () => update.installer({}),
+      latest: () => update.latest({}),
+      install: (argv) => update.runUpdate(argv, {}),
+    })),
+    configCommand(IDENTITY, configuration),
+  ],
+})
+
+export const createProgram = (options?: ProgramOptions): Command => createSharedProgram(definition(), options)
+
+export const run = (argv: string[], options?: RunOptions): Promise<number> => runShared(argv, definition(), options)

package/src/roots.test.ts

@@ -0,0 +1,80 @@
+import { existsSync } from "node:fs"
+import { homedir } from "node:os"
+import { join } from "node:path"
+import { expect, it } from "vitest"
+import { run } from "./program.js"
+
+const ran = async (argv: string[]) => {
+  const out: string[] = []
+  const err: string[] = []
+  const code = await run(argv, {
+    streams: { data: (text) => out.push(text), diagnostic: (text) => err.push(text) },
+    tty: false,
+  })
+  return { code, out: out.join("\n"), err: err.join("\n") }
+}
+
+it.each([
+  ["--verbose"],
+  ["--quiet"],
+  ["--trace"],
+  ["--debug"],
+  ["--timeout", "30s"],
+  ["--offline"],
+  ["--no-input"],
+  ["--max-input-bytes", "1024"],
+  ["--max-output-bytes", "0"],
+  ["--brief"],
+  ["--full"],
+  ["--yes"],
+  ["--record"],
+  ["--no-record"],
+])("doctor runs with the global option %s", async (...flag) => {
+  const { code, out } = await ran([...flag, "doctor", "--json"])
+  expect(code).toBe(0)
+  expect(JSON.parse(out).item.version).toEqual(expect.any(String))
+})
+
+it("--jsonl prints one object per line", async () => {
+  const { code, out } = await ran(["--jsonl", "personal", "config", "show"])
+  expect(code).toBe(0)
+  for (const line of out.split("\n").filter(Boolean)) expect(() => JSON.parse(line)).not.toThrow()
+})
+
+it("--dry-run previews a write without making it", async () => {
+  const { code } = await ran(["--dry-run", "personal", "config", "set", "limit", "5", "--json"])
+  expect(code).toBe(0)
+  const { out } = await ran(["personal", "config", "show", "--json"])
+  expect(JSON.parse(out).item.settings).toContainEqual(expect.objectContaining({ setting: "limit", value: 20 }))
+})
+
+it("config set and unset change one setting and put it back", async () => {
+  for (const scope of [[], ["--defaults"], ["--personal"], ["--bot"]]) {
+    expect((await ran(["personal", "config", "set", "limit", "7", ...scope, "--json"])).code).toBe(0)
+    expect((await ran(["personal", "config", "unset", "limit", ...scope, "--json"])).code).toBe(0)
+  }
+})
+
+it("config show --bot shows what a bot command would get", async () => {
+  const { code, out } = await ran(["personal", "config", "show", "--bot", "--json"])
+  expect(code).toBe(0)
+  expect(JSON.parse(out).item.profile).toBe("personal")
+})
+
+it("commands info exports the schemas and reasons", async () => {
+  const { code, out } = await ran(["commands", "info", "--json"])
+  expect(code).toBe(0)
+  expect(out.length).toBeGreaterThan(0)
+})
+
+it("skill install writes the skill for Claude Code", async () => {
+  const { code } = await ran(["skill", "install", "--for", "claude", "--json"])
+  expect(code).toBe(0)
+  expect(existsSync(join(homedir(), ".claude", "skills", "app-cli", "SKILL.md"))).toBe(true)
+})
+
+it("help prints the first screen", async () => {
+  const { code, out } = await ran(["help"])
+  expect(code).toBe(0)
+  expect(out).toContain("app")
+})

package/src/testing/argv-log.ts

@@ -0,0 +1 @@
+export { ARGV_LOG, argvLogSetup as default } from "@wirecat/cli-core/testing"

package/src/testing/sandbox.ts

@@ -0,0 +1,25 @@
+import { tmpdir } from "node:os"
+import { join } from "node:path"
+import { afterAll } from "vitest"
+import { ARGV_LOG } from "./argv-log.js"
+
+const saved = { ...process.env }
+
+// cli-base's setup already gave this file a fresh TMPDIR and HOME, a keyring that throws and no network.
+const sandbox = tmpdir()
+process.env.APP_CONFIG_DIR = join(sandbox, "config")
+process.env.APP_STATE_DIR = join(sandbox, "state")
+process.env.APP_CACHE_DIR = join(sandbox, "cache")
+process.env.MESSAGING_STORE = join(sandbox, "messages.db")
+process.env.WIRECAT_STATE_DIR = join(sandbox, "wirecat")
+process.env.APP_NO_UPDATE_CHECK = "1"
+process.env.APP_TEST_ARGV_LOG = ARGV_LOG
+delete process.env.APP_PROFILE
+delete process.env.APP_READ_ONLY
+delete process.env.AI_AGENT
+delete process.env.CLAUDECODE
+
+afterAll(() => {
+  for (const key of Object.keys(process.env)) if (!(key in saved)) delete process.env[key]
+  Object.assign(process.env, saved)
+})

package/src/version.ts

@@ -0,0 +1 @@
+export const VERSION = "0.1.1"

package/template.json

@@ -0,0 +1,40 @@
+{
+  "files": [
+    ".github/",
+    ".gitignore",
+    ".gitleaks.toml",
+    ".vale.ini",
+    "AGENTS.md",
+    "bin/release",
+    "docs/dev/design-questions.md",
+    "docs/dev/reference-clis.md",
+    "docs/dev/skills/",
+    "docs/dev/TESTING.md",
+    "lefthook.yml",
+    "scripts/audit.sh",
+    "tsconfig.json",
+    "tsconfig.scripts.json",
+    "tsconfig.test.json"
+  ],
+  "seeds": [
+    ".markdownlint-cli2.jsonc",
+    "CHANGELOG.md",
+    "CLAUDE.md",
+    "LICENSE",
+    "README.md",
+    "SECURITY.md",
+    "biome.json",
+    "config/wirecat/",
+    "contracts/",
+    "cspell.json",
+    "docs/",
+    "lint/",
+    "package.json",
+    "pnpm-workspace.yaml",
+    "scripts/",
+    "skills/",
+    "src/",
+    "vitest.config.ts"
+  ],
+  "placeholders": { "command": "app", "package": "@wirecat/app-cli", "repository": "WireCatLabs/app-cli" }
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "@wirecat/cli-base/tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["src/**/*.test.ts", "src/testing/**"]
+}

package/tsconfig.scripts.json

@@ -0,0 +1 @@
+{ "extends": ["./tsconfig.json", "@wirecat/cli-base/tsconfig.scripts.json"] }

package/tsconfig.test.json

@@ -0,0 +1 @@
+{ "extends": ["./tsconfig.json", "@wirecat/cli-base/tsconfig.test.json"] }

package/vitest.config.ts

@@ -0,0 +1,19 @@
+import { defineConfig } from "vitest/config"
+
+export default defineConfig({
+  // Oxc does not resolve TypeScript package exports; tsc still checks the project configs.
+  tsconfig: "./node_modules/@wirecat/cli-base/config/tsconfig.base.json",
+  test: {
+    include: ["src/**/*.test.ts", "scripts/**/*.test.ts", "kit/test/**/*.test.ts"],
+    maxWorkers: 4,
+    setupFiles: ["@wirecat/cli-base/testing/setup", "src/testing/sandbox.ts"],
+    globalSetup: ["src/testing/argv-log.ts"],
+    coverage: {
+      provider: "v8",
+      include: ["src/**/*.ts"],
+      exclude: ["src/**/*.test.ts", "src/testing/**", "src/bin/**"],
+      reporter: ["text-summary", "json-summary"],
+      thresholds: { lines: 90, statements: 90, functions: 80, branches: 70 },
+    },
+  },
+})