@takuhon/cli 0.6.1 → 0.7.0

package/dist/index.js

@@ -1,8 +1,79 @@
 #!/usr/bin/env node
 
 // src/index.ts
+import { readFileSync as readFileSync2 } from "fs";
+
+// src/validate-command.ts
 import { readFileSync } from "fs";
-var pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+import { validate } from "@takuhon/core";
+var DEFAULT_PATH = "takuhon.json";
+var USAGE = `Usage: takuhon validate [path]
+
+Validate a takuhon.json against the takuhon schema. With no path, validates
+./takuhon.json in the current working directory.
+
+Exit codes: 0 = valid, 1 = invalid, 2 = file missing / unreadable / not JSON.
+`;
+function runValidate(args = []) {
+  if (args[0] === "--help" || args[0] === "-h") {
+    return { code: 0, stdout: USAGE, stderr: "" };
+  }
+  if (args.length > 1) {
+    return {
+      code: 2,
+      stdout: "",
+      stderr: "takuhon: `validate` takes at most one path argument.\nRun `takuhon validate --help` for usage.\n"
+    };
+  }
+  return validateFile(args[0]);
+}
+function validateFile(pathArg) {
+  const target = pathArg ?? DEFAULT_PATH;
+  let raw;
+  try {
+    raw = readFileSync(target, "utf8");
+  } catch {
+    return {
+      code: 2,
+      stdout: "",
+      stderr: `takuhon: cannot read '${target}'. Pass a path, or run from a directory containing a takuhon.json.
+`
+    };
+  }
+  let data;
+  try {
+    data = JSON.parse(raw);
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    return {
+      code: 2,
+      stdout: "",
+      stderr: `takuhon: '${target}' is not valid JSON: ${detail}
+`
+    };
+  }
+  const result = validate(data);
+  if (result.ok) {
+    return {
+      code: 0,
+      stdout: `${target}: valid (schemaVersion ${result.data.schemaVersion}).
+`,
+      stderr: ""
+    };
+  }
+  const count = result.errors.length;
+  const lines = result.errors.map((error) => `  ${error.pointer || "/"}: ${error.message}`);
+  return {
+    code: 1,
+    stdout: "",
+    stderr: `${target}: invalid (${count} error${count === 1 ? "" : "s"}):
+${lines.join("\n")}
+`
+  };
+}
+
+// src/index.ts
+var pkg = JSON.parse(readFileSync2(new URL("../package.json", import.meta.url), "utf8"));
 var VERSION = pkg.version;
 var HELP = `takuhon ${VERSION}
 
@@ -12,11 +83,14 @@ Usage:
   takuhon --version            Show the installed CLI version
   takuhon --help               Show this help
 
+Commands:
+  takuhon validate [path]      Validate a takuhon.json (default: ./takuhon.json)
+
 Scaffolding a new profile project:
   npx create-takuhon my-profile
   npx create-takuhon my-profile --license CC-BY-4.0
 
-Subcommands (dev / validate / sync / export / migrate / restore) are planned
+Subcommands (dev / sync / export / migrate / restore) are planned
 for a future release. Track progress at:
 
   https://github.com/takuhon-dev/takuhon
@@ -32,6 +106,12 @@ function main(argv) {
     process.stdout.write(HELP);
     return 0;
   }
+  if (first === "validate") {
+    const { code, stdout, stderr } = runValidate(argv.slice(1));
+    if (stdout) process.stdout.write(stdout);
+    if (stderr) process.stderr.write(stderr);
+    return code;
+  }
   process.stderr.write(
     `takuhon: unknown command '${first}'
 Run \`takuhon --help\` for usage. For scaffolding a new project, use \`create-takuhon\`.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * `@takuhon/cli` entry point — the `takuhon` command.\n *\n * At present this exposes only `--version` / `--help` plus a pointer to\n * `create-takuhon` for scaffolding. The dev / validate / sync / export /\n * migrate / restore subcommands land in subsequent releases. The bare-name\n * `takuhon` npm package (`packages/takuhon/`) redirects here via a 4-line\n * shim, so `npm i -g takuhon && takuhon --help` and `npm i -g @takuhon/cli\n * && takuhon --help` give the same output.\n */\n\nimport { readFileSync } from 'node:fs';\n\n// Source the reported version from package.json (read at runtime relative to\n// this module) so `takuhon --version` can never drift from the published\n// release — there is no hand-maintained version literal to fall out of sync.\nconst pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')) as {\n  version: string;\n};\nconst VERSION = pkg.version;\n\nconst HELP = `takuhon ${VERSION}\n\nTakuhon — open-source portable profile API server.\n\nUsage:\n  takuhon --version            Show the installed CLI version\n  takuhon --help               Show this help\n\nScaffolding a new profile project:\n  npx create-takuhon my-profile\n  npx create-takuhon my-profile --license CC-BY-4.0\n\nSubcommands (dev / validate / sync / export / migrate / restore) are planned\nfor a future release. Track progress at:\n\n  https://github.com/takuhon-dev/takuhon\n`;\n\nfunction main(argv: readonly string[]): number {\n  const first = argv[0];\n\n  if (first === '--version' || first === '-v') {\n    process.stdout.write(`${VERSION}\\n`);\n    return 0;\n  }\n\n  if (first === undefined || first === '--help' || first === '-h') {\n    process.stdout.write(HELP);\n    return 0;\n  }\n\n  process.stderr.write(\n    `takuhon: unknown command '${first}'\\n` +\n      `Run \\`takuhon --help\\` for usage. For scaffolding a new project, use \\`create-takuhon\\`.\\n`,\n  );\n  return 2;\n}\n\nprocess.exit(main(process.argv.slice(2)));\n"],"mappings":";;;AAaA,SAAS,oBAAoB;AAK7B,IAAM,MAAM,KAAK,MAAM,aAAa,IAAI,IAAI,mBAAmB,YAAY,GAAG,GAAG,MAAM,CAAC;AAGxF,IAAM,UAAU,IAAI;AAEpB,IAAM,OAAO,WAAW,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAkB/B,SAAS,KAAK,MAAiC;AAC7C,QAAM,QAAQ,KAAK,CAAC;AAEpB,MAAI,UAAU,eAAe,UAAU,MAAM;AAC3C,YAAQ,OAAO,MAAM,GAAG,OAAO;AAAA,CAAI;AACnC,WAAO;AAAA,EACT;AAEA,MAAI,UAAU,UAAa,UAAU,YAAY,UAAU,MAAM;AAC/D,YAAQ,OAAO,MAAM,IAAI;AACzB,WAAO;AAAA,EACT;AAEA,UAAQ,OAAO;AAAA,IACb,6BAA6B,KAAK;AAAA;AAAA;AAAA,EAEpC;AACA,SAAO;AACT;AAEA,QAAQ,KAAK,KAAK,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/validate-command.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * `@takuhon/cli` entry point — the `takuhon` command.\n *\n * At present this exposes `--version` / `--help`, the `validate` command, and\n * a pointer to `create-takuhon` for scaffolding. The dev / sync / export /\n * migrate / restore subcommands land in subsequent releases. The bare-name\n * `takuhon` npm package (`packages/takuhon/`) redirects here via a 4-line\n * shim, so `npm i -g takuhon && takuhon --help` and `npm i -g @takuhon/cli\n * && takuhon --help` give the same output.\n */\n\nimport { readFileSync } from 'node:fs';\n\nimport { runValidate } from './validate-command.js';\n\n// Source the reported version from package.json (read at runtime relative to\n// this module) so `takuhon --version` can never drift from the published\n// release — there is no hand-maintained version literal to fall out of sync.\nconst pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')) as {\n  version: string;\n};\nconst VERSION = pkg.version;\n\nconst HELP = `takuhon ${VERSION}\n\nTakuhon — open-source portable profile API server.\n\nUsage:\n  takuhon --version            Show the installed CLI version\n  takuhon --help               Show this help\n\nCommands:\n  takuhon validate [path]      Validate a takuhon.json (default: ./takuhon.json)\n\nScaffolding a new profile project:\n  npx create-takuhon my-profile\n  npx create-takuhon my-profile --license CC-BY-4.0\n\nSubcommands (dev / sync / export / migrate / restore) are planned\nfor a future release. Track progress at:\n\n  https://github.com/takuhon-dev/takuhon\n`;\n\nfunction main(argv: readonly string[]): number {\n  const first = argv[0];\n\n  if (first === '--version' || first === '-v') {\n    process.stdout.write(`${VERSION}\\n`);\n    return 0;\n  }\n\n  if (first === undefined || first === '--help' || first === '-h') {\n    process.stdout.write(HELP);\n    return 0;\n  }\n\n  if (first === 'validate') {\n    const { code, stdout, stderr } = runValidate(argv.slice(1));\n    if (stdout) process.stdout.write(stdout);\n    if (stderr) process.stderr.write(stderr);\n    return code;\n  }\n\n  process.stderr.write(\n    `takuhon: unknown command '${first}'\\n` +\n      `Run \\`takuhon --help\\` for usage. For scaffolding a new project, use \\`create-takuhon\\`.\\n`,\n  );\n  return 2;\n}\n\nprocess.exit(main(process.argv.slice(2)));\n","/**\n * `takuhon validate [path]` — validate a `takuhon.json` against `@takuhon/core`.\n *\n * All argument handling and the validation itself live here as pure,\n * side-effect-free functions so the whole command is unit-testable: `index.ts`\n * runs `process.exit(main(...))` at module top level and is therefore not\n * import-safe. `runValidate` reads the target file itself but returns its\n * output as strings plus an exit code, leaving the actual stdout/stderr writes\n * and `process.exit` to the caller.\n *\n * Exit codes:\n *   0 — the document is valid (or `--help` was requested)\n *   1 — the document was read and parsed but failed schema validation\n *   2 — the command could not run: bad arguments, a missing/unreadable file,\n *       or a file that is not valid JSON (operational errors, distinct from an\n *       invalid-but-readable document)\n */\n\nimport { readFileSync } from 'node:fs';\n\nimport { validate } from '@takuhon/core';\n\n/** Default profile filename, resolved relative to the current working directory. */\nconst DEFAULT_PATH = 'takuhon.json';\n\nconst USAGE = `Usage: takuhon validate [path]\n\nValidate a takuhon.json against the takuhon schema. With no path, validates\n./takuhon.json in the current working directory.\n\nExit codes: 0 = valid, 1 = invalid, 2 = file missing / unreadable / not JSON.\n`;\n\nexport interface ValidateOutcome {\n  /** Process exit code (see module docstring). */\n  readonly code: number;\n  /** Text destined for stdout (empty when there is nothing to print). */\n  readonly stdout: string;\n  /** Text destined for stderr (empty when there is nothing to print). */\n  readonly stderr: string;\n}\n\n/**\n * Run `takuhon validate` against the arguments that follow the subcommand\n * (i.e. `process.argv.slice(2)` minus the leading `\"validate\"`).\n *\n * Handles `--help` / `-h` and rejects extra positionals, then validates the\n * `takuhon.json` at the single optional path argument (default\n * `./takuhon.json`). Never throws and never writes to the process streams —\n * the caller renders the returned `stdout` / `stderr` and exits with `code`.\n */\nexport function runValidate(args: readonly string[] = []): ValidateOutcome {\n  if (args[0] === '--help' || args[0] === '-h') {\n    return { code: 0, stdout: USAGE, stderr: '' };\n  }\n\n  if (args.length > 1) {\n    return {\n      code: 2,\n      stdout: '',\n      stderr:\n        'takuhon: `validate` takes at most one path argument.\\n' +\n        'Run `takuhon validate --help` for usage.\\n',\n    };\n  }\n\n  return validateFile(args[0]);\n}\n\n/** Read, parse, and schema-validate the profile at `pathArg` (default `./takuhon.json`). */\nfunction validateFile(pathArg?: string): ValidateOutcome {\n  const target = pathArg ?? DEFAULT_PATH;\n\n  let raw: string;\n  try {\n    raw = readFileSync(target, 'utf8');\n  } catch {\n    return {\n      code: 2,\n      stdout: '',\n      stderr: `takuhon: cannot read '${target}'. Pass a path, or run from a directory containing a takuhon.json.\\n`,\n    };\n  }\n\n  let data: unknown;\n  try {\n    data = JSON.parse(raw);\n  } catch (error) {\n    const detail = error instanceof Error ? error.message : String(error);\n    return {\n      code: 2,\n      stdout: '',\n      stderr: `takuhon: '${target}' is not valid JSON: ${detail}\\n`,\n    };\n  }\n\n  const result = validate(data);\n  if (result.ok) {\n    return {\n      code: 0,\n      stdout: `${target}: valid (schemaVersion ${result.data.schemaVersion}).\\n`,\n      stderr: '',\n    };\n  }\n\n  const count = result.errors.length;\n  const lines = result.errors.map((error) => `  ${error.pointer || '/'}: ${error.message}`);\n  return {\n    code: 1,\n    stdout: '',\n    stderr: `${target}: invalid (${count} error${count === 1 ? '' : 's'}):\\n${lines.join('\\n')}\\n`,\n  };\n}\n"],"mappings":";;;AAaA,SAAS,gBAAAA,qBAAoB;;;ACK7B,SAAS,oBAAoB;AAE7B,SAAS,gBAAgB;AAGzB,IAAM,eAAe;AAErB,IAAM,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA0BP,SAAS,YAAY,OAA0B,CAAC,GAAoB;AACzE,MAAI,KAAK,CAAC,MAAM,YAAY,KAAK,CAAC,MAAM,MAAM;AAC5C,WAAO,EAAE,MAAM,GAAG,QAAQ,OAAO,QAAQ,GAAG;AAAA,EAC9C;AAEA,MAAI,KAAK,SAAS,GAAG;AACnB,WAAO;AAAA,MACL,MAAM;AAAA,MACN,QAAQ;AAAA,MACR,QACE;AAAA,IAEJ;AAAA,EACF;AAEA,SAAO,aAAa,KAAK,CAAC,CAAC;AAC7B;AAGA,SAAS,aAAa,SAAmC;AACvD,QAAM,SAAS,WAAW;AAE1B,MAAI;AACJ,MAAI;AACF,UAAM,aAAa,QAAQ,MAAM;AAAA,EACnC,QAAQ;AACN,WAAO;AAAA,MACL,MAAM;AAAA,MACN,QAAQ;AAAA,MACR,QAAQ,yBAAyB,MAAM;AAAA;AAAA,IACzC;AAAA,EACF;AAEA,MAAI;AACJ,MAAI;AACF,WAAO,KAAK,MAAM,GAAG;AAAA,EACvB,SAAS,OAAO;AACd,UAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACpE,WAAO;AAAA,MACL,MAAM;AAAA,MACN,QAAQ;AAAA,MACR,QAAQ,aAAa,MAAM,wBAAwB,MAAM;AAAA;AAAA,IAC3D;AAAA,EACF;AAEA,QAAM,SAAS,SAAS,IAAI;AAC5B,MAAI,OAAO,IAAI;AACb,WAAO;AAAA,MACL,MAAM;AAAA,MACN,QAAQ,GAAG,MAAM,0BAA0B,OAAO,KAAK,aAAa;AAAA;AAAA,MACpE,QAAQ;AAAA,IACV;AAAA,EACF;AAEA,QAAM,QAAQ,OAAO,OAAO;AAC5B,QAAM,QAAQ,OAAO,OAAO,IAAI,CAAC,UAAU,KAAK,MAAM,WAAW,GAAG,KAAK,MAAM,OAAO,EAAE;AACxF,SAAO;AAAA,IACL,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,QAAQ,GAAG,MAAM,cAAc,KAAK,SAAS,UAAU,IAAI,KAAK,GAAG;AAAA,EAAO,MAAM,KAAK,IAAI,CAAC;AAAA;AAAA,EAC5F;AACF;;;AD5FA,IAAM,MAAM,KAAK,MAAMC,cAAa,IAAI,IAAI,mBAAmB,YAAY,GAAG,GAAG,MAAM,CAAC;AAGxF,IAAM,UAAU,IAAI;AAEpB,IAAM,OAAO,WAAW,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqB/B,SAAS,KAAK,MAAiC;AAC7C,QAAM,QAAQ,KAAK,CAAC;AAEpB,MAAI,UAAU,eAAe,UAAU,MAAM;AAC3C,YAAQ,OAAO,MAAM,GAAG,OAAO;AAAA,CAAI;AACnC,WAAO;AAAA,EACT;AAEA,MAAI,UAAU,UAAa,UAAU,YAAY,UAAU,MAAM;AAC/D,YAAQ,OAAO,MAAM,IAAI;AACzB,WAAO;AAAA,EACT;AAEA,MAAI,UAAU,YAAY;AACxB,UAAM,EAAE,MAAM,QAAQ,OAAO,IAAI,YAAY,KAAK,MAAM,CAAC,CAAC;AAC1D,QAAI,OAAQ,SAAQ,OAAO,MAAM,MAAM;AACvC,QAAI,OAAQ,SAAQ,OAAO,MAAM,MAAM;AACvC,WAAO;AAAA,EACT;AAEA,UAAQ,OAAO;AAAA,IACb,6BAA6B,KAAK;AAAA;AAAA;AAAA,EAEpC;AACA,SAAO;AACT;AAEA,QAAQ,KAAK,KAAK,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC;","names":["readFileSync","readFileSync"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takuhon/cli",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "create-takuhon scaffolding plus dev/validate/sync/export/migrate/restore commands",
   "license": "Apache-2.0",
   "author": "Takuhon contributors",
@@ -48,7 +48,7 @@
   },
   "dependencies": {
     "@clack/prompts": "^0.11.0",
-    "@takuhon/core": "0.6.1"
+    "@takuhon/core": "0.7.0"
   },
   "scripts": {
     "typecheck": "tsc",