@rejot-dev/thalo-cli 0.2.0 → 0.2.1

package/dist/cli.js

@@ -1,8 +1,8 @@
+import { formatVersion, getVersionInfo } from "./version.js";
 import { parseArgs } from "node:util";
 import pc from "picocolors";
 
 //#region src/cli.ts
-const VERSION = "0.1.0";
 /**
 * Convert our option definitions to node:util parseArgs config
 */
@@ -142,8 +142,14 @@ function runCli(rootCommand, argv = process.argv.slice(2)) {
 	const { values, positionals } = parsed;
 	if (values["no-color"]) process.env["NO_COLOR"] = "1";
 	if (values["version"] && commandPath.length === 1) {
-		console.log(`thalo v${VERSION}`);
-		process.exit(0);
+		getVersionInfo().then((info) => {
+			console.log(formatVersion(info));
+			process.exit(0);
+		}).catch(() => {
+			console.log("thalo (version unknown)");
+			process.exit(0);
+		});
+		return;
 	}
 	if (values["help"]) {
 		console.log(generateHelp(command, commandPath));

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","names":["config: ParseArgsConfig[\"options\"]","optConfig: NonNullable<ParseArgsConfig[\"options\"]>[string]","globalOptions: Record<string, OptionDef>","lines: string[]","parsed: ReturnType<typeof parseArgs>","ctx: CommandContext"],"sources":["../src/cli.ts"],"sourcesContent":["import { parseArgs, type ParseArgsConfig } from \"node:util\";\nimport pc from \"picocolors\";\n\nconst VERSION = \"0.1.0\";\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Option definition for a command\n */\nexport interface OptionDef {\n  type: \"boolean\" | \"string\";\n  short?: string;\n  description: string;\n  default?: string | boolean;\n  choices?: string[];\n  multiple?: boolean;\n}\n\n/**\n * Command definition\n */\nexport interface CommandDef {\n  name: string;\n  description: string;\n  usage?: string;\n  options?: Record<string, OptionDef>;\n  args?: {\n    name: string;\n    description: string;\n    required?: boolean;\n    multiple?: boolean;\n  };\n  subcommands?: Record<string, CommandDef>;\n  action?: (ctx: CommandContext) => void | Promise<void>;\n}\n\n/**\n * Parsed command context passed to action handlers\n */\nexport interface CommandContext {\n  options: Record<string, string | boolean | string[]>;\n  args: string[];\n  command: CommandDef;\n  commandPath: string[];\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Framework\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Convert our option definitions to node:util parseArgs config\n */\nfunction toParseArgsConfig(options: Record<string, OptionDef>): ParseArgsConfig[\"options\"] {\n  const config: ParseArgsConfig[\"options\"] = {};\n\n  for (const [name, def] of Object.entries(options)) {\n    const optConfig: NonNullable<ParseArgsConfig[\"options\"]>[string] = {\n      type: def.type,\n    };\n\n    if (def.short) {\n      optConfig.short = def.short;\n    }\n\n    if (def.default !== undefined) {\n      optConfig.default = def.default;\n    }\n\n    if (def.multiple !== undefined) {\n      optConfig.multiple = def.multiple;\n    }\n\n    config[name] = optConfig;\n  }\n\n  return config;\n}\n\n/**\n * Global options available to all commands\n */\nconst globalOptions: Record<string, OptionDef> = {\n  help: {\n    type: \"boolean\",\n    short: \"h\",\n    description: \"Show help for the command\",\n    default: false,\n  },\n  version: {\n    type: \"boolean\",\n    short: \"V\",\n    description: \"Show version number\",\n    default: false,\n  },\n  \"no-color\": {\n    type: \"boolean\",\n    description: \"Disable colored output\",\n    default: false,\n  },\n};\n\n/**\n * Generate help text for a command\n */\nexport function generateHelp(command: CommandDef, commandPath: string[] = []): string {\n  const lines: string[] = [];\n  const fullCommandName = commandPath.length > 0 ? commandPath.join(\" \") : \"thalo\";\n\n  // Header\n  lines.push(\"\");\n  lines.push(pc.bold(command.description));\n  lines.push(\"\");\n\n  // Usage\n  lines.push(pc.bold(\"USAGE\"));\n  let usageLine = `  ${fullCommandName}`;\n\n  if (command.subcommands && Object.keys(command.subcommands).length > 0) {\n    usageLine += \" <command>\";\n  }\n\n  if (command.options && Object.keys(command.options).length > 0) {\n    usageLine += \" [options]\";\n  }\n\n  if (command.args) {\n    const argName = command.args.multiple ? `<${command.args.name}...>` : `<${command.args.name}>`;\n    usageLine += command.args.required ? ` ${argName}` : ` [${argName}]`;\n  }\n\n  if (command.usage) {\n    usageLine = `  ${fullCommandName} ${command.usage}`;\n  }\n\n  lines.push(usageLine);\n  lines.push(\"\");\n\n  // Subcommands\n  if (command.subcommands && Object.keys(command.subcommands).length > 0) {\n    lines.push(pc.bold(\"COMMANDS\"));\n\n    const subcommandNames = Object.keys(command.subcommands);\n    const maxLen = Math.max(...subcommandNames.map((n) => n.length));\n\n    for (const [name, subcmd] of Object.entries(command.subcommands)) {\n      const paddedName = name.padEnd(maxLen + 2);\n      lines.push(`  ${pc.cyan(paddedName)}${subcmd.description}`);\n    }\n\n    lines.push(\"\");\n    lines.push(`  Run '${fullCommandName} <command> --help' for more information on a command.`);\n    lines.push(\"\");\n  }\n\n  // Options\n  const allOptions = { ...globalOptions, ...command.options };\n  if (Object.keys(allOptions).length > 0) {\n    lines.push(pc.bold(\"OPTIONS\"));\n\n    const optionEntries = Object.entries(allOptions);\n    const optionStrings = optionEntries.map(([name, def]) => {\n      const shortFlag = def.short ? `-${def.short}, ` : \"    \";\n      const longFlag = `--${name}`;\n      const valueHint =\n        def.type === \"string\" ? ` <${def.choices ? def.choices.join(\"|\") : \"value\"}>` : \"\";\n      return `${shortFlag}${longFlag}${valueHint}`;\n    });\n    const maxOptLen = Math.max(...optionStrings.map((s) => s.length));\n\n    for (let i = 0; i < optionEntries.length; i++) {\n      const [, def] = optionEntries[i];\n      const optStr = optionStrings[i].padEnd(maxOptLen + 2);\n      let description = def.description;\n\n      if (def.default !== undefined && def.default !== false && def.default !== \"\") {\n        description += pc.dim(` (default: ${def.default})`);\n      }\n\n      lines.push(`  ${pc.dim(optStr)}${description}`);\n    }\n\n    lines.push(\"\");\n  }\n\n  return lines.join(\"\\n\");\n}\n\n/**\n * Find a command by traversing the path\n */\nfunction findCommand(\n  root: CommandDef,\n  args: string[],\n): { command: CommandDef; commandPath: string[]; remainingArgs: string[] } {\n  let current = root;\n  const commandPath = [\"thalo\"];\n  const remainingArgs = [...args];\n\n  while (remainingArgs.length > 0) {\n    const nextArg = remainingArgs[0];\n\n    // Stop if it's an option\n    if (nextArg.startsWith(\"-\")) {\n      break;\n    }\n\n    // Check if it's a subcommand\n    if (current.subcommands && current.subcommands[nextArg]) {\n      current = current.subcommands[nextArg];\n      commandPath.push(nextArg);\n      remainingArgs.shift();\n    } else {\n      // Not a subcommand, must be a positional arg\n      break;\n    }\n  }\n\n  return { command: current, commandPath, remainingArgs };\n}\n\n/**\n * Parse and run a command\n */\nexport function runCli(rootCommand: CommandDef, argv: string[] = process.argv.slice(2)): void {\n  // Find the target command\n  const { command, commandPath, remainingArgs } = findCommand(rootCommand, argv);\n\n  // Merge global options with command options\n  const allOptions = { ...globalOptions, ...command.options };\n  const parseArgsOptions = toParseArgsConfig(allOptions);\n\n  // Parse arguments\n  let parsed: ReturnType<typeof parseArgs>;\n  try {\n    parsed = parseArgs({\n      args: remainingArgs,\n      options: parseArgsOptions,\n      allowPositionals: true,\n      strict: true,\n    });\n  } catch (err) {\n    if (err instanceof Error) {\n      console.error(pc.red(`Error: ${err.message}`));\n      console.error(`\\nRun '${commandPath.join(\" \")} --help' for usage information.`);\n    }\n    process.exit(2);\n  }\n\n  const { values, positionals } = parsed;\n\n  // Handle no-color by setting env var (picocolors respects NO_COLOR)\n  if (values[\"no-color\"]) {\n    process.env[\"NO_COLOR\"] = \"1\";\n  }\n\n  // Handle version (only at root level)\n  if (values[\"version\"] && commandPath.length === 1) {\n    console.log(`thalo v${VERSION}`);\n    process.exit(0);\n  }\n\n  // Handle help\n  if (values[\"help\"]) {\n    console.log(generateHelp(command, commandPath));\n    process.exit(0);\n  }\n\n  // If command has subcommands but no action and no subcommand was specified, show help\n  if (command.subcommands && Object.keys(command.subcommands).length > 0 && !command.action) {\n    console.log(generateHelp(command, commandPath));\n    process.exit(0);\n  }\n\n  // Run the command action\n  if (command.action) {\n    const ctx: CommandContext = {\n      options: values as Record<string, string | boolean | string[]>,\n      args: positionals,\n      command,\n      commandPath,\n    };\n\n    Promise.resolve(command.action(ctx)).catch((err) => {\n      console.error(pc.red(`Error: ${err instanceof Error ? err.message : err}`));\n      process.exit(1);\n    });\n  } else {\n    console.log(generateHelp(command, commandPath));\n    process.exit(0);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"cli.js","names":["config: ParseArgsConfig[\"options\"]","optConfig: NonNullable<ParseArgsConfig[\"options\"]>[string]","globalOptions: Record<string, OptionDef>","lines: string[]","parsed: ReturnType<typeof parseArgs>","ctx: CommandContext"],"sources":["../src/cli.ts"],"sourcesContent":["import { parseArgs, type ParseArgsConfig } from \"node:util\";\nimport pc from \"picocolors\";\nimport { getVersionInfo, formatVersion } from \"./version.js\";\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Option definition for a command\n */\nexport interface OptionDef {\n  type: \"boolean\" | \"string\";\n  short?: string;\n  description: string;\n  default?: string | boolean;\n  choices?: string[];\n  multiple?: boolean;\n}\n\n/**\n * Command definition\n */\nexport interface CommandDef {\n  name: string;\n  description: string;\n  usage?: string;\n  options?: Record<string, OptionDef>;\n  args?: {\n    name: string;\n    description: string;\n    required?: boolean;\n    multiple?: boolean;\n  };\n  subcommands?: Record<string, CommandDef>;\n  action?: (ctx: CommandContext) => void | Promise<void>;\n}\n\n/**\n * Parsed command context passed to action handlers\n */\nexport interface CommandContext {\n  options: Record<string, string | boolean | string[]>;\n  args: string[];\n  command: CommandDef;\n  commandPath: string[];\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Framework\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Convert our option definitions to node:util parseArgs config\n */\nfunction toParseArgsConfig(options: Record<string, OptionDef>): ParseArgsConfig[\"options\"] {\n  const config: ParseArgsConfig[\"options\"] = {};\n\n  for (const [name, def] of Object.entries(options)) {\n    const optConfig: NonNullable<ParseArgsConfig[\"options\"]>[string] = {\n      type: def.type,\n    };\n\n    if (def.short) {\n      optConfig.short = def.short;\n    }\n\n    if (def.default !== undefined) {\n      optConfig.default = def.default;\n    }\n\n    if (def.multiple !== undefined) {\n      optConfig.multiple = def.multiple;\n    }\n\n    config[name] = optConfig;\n  }\n\n  return config;\n}\n\n/**\n * Global options available to all commands\n */\nconst globalOptions: Record<string, OptionDef> = {\n  help: {\n    type: \"boolean\",\n    short: \"h\",\n    description: \"Show help for the command\",\n    default: false,\n  },\n  version: {\n    type: \"boolean\",\n    short: \"V\",\n    description: \"Show version number\",\n    default: false,\n  },\n  \"no-color\": {\n    type: \"boolean\",\n    description: \"Disable colored output\",\n    default: false,\n  },\n};\n\n/**\n * Generate help text for a command\n */\nexport function generateHelp(command: CommandDef, commandPath: string[] = []): string {\n  const lines: string[] = [];\n  const fullCommandName = commandPath.length > 0 ? commandPath.join(\" \") : \"thalo\";\n\n  // Header\n  lines.push(\"\");\n  lines.push(pc.bold(command.description));\n  lines.push(\"\");\n\n  // Usage\n  lines.push(pc.bold(\"USAGE\"));\n  let usageLine = `  ${fullCommandName}`;\n\n  if (command.subcommands && Object.keys(command.subcommands).length > 0) {\n    usageLine += \" <command>\";\n  }\n\n  if (command.options && Object.keys(command.options).length > 0) {\n    usageLine += \" [options]\";\n  }\n\n  if (command.args) {\n    const argName = command.args.multiple ? `<${command.args.name}...>` : `<${command.args.name}>`;\n    usageLine += command.args.required ? ` ${argName}` : ` [${argName}]`;\n  }\n\n  if (command.usage) {\n    usageLine = `  ${fullCommandName} ${command.usage}`;\n  }\n\n  lines.push(usageLine);\n  lines.push(\"\");\n\n  // Subcommands\n  if (command.subcommands && Object.keys(command.subcommands).length > 0) {\n    lines.push(pc.bold(\"COMMANDS\"));\n\n    const subcommandNames = Object.keys(command.subcommands);\n    const maxLen = Math.max(...subcommandNames.map((n) => n.length));\n\n    for (const [name, subcmd] of Object.entries(command.subcommands)) {\n      const paddedName = name.padEnd(maxLen + 2);\n      lines.push(`  ${pc.cyan(paddedName)}${subcmd.description}`);\n    }\n\n    lines.push(\"\");\n    lines.push(`  Run '${fullCommandName} <command> --help' for more information on a command.`);\n    lines.push(\"\");\n  }\n\n  // Options\n  const allOptions = { ...globalOptions, ...command.options };\n  if (Object.keys(allOptions).length > 0) {\n    lines.push(pc.bold(\"OPTIONS\"));\n\n    const optionEntries = Object.entries(allOptions);\n    const optionStrings = optionEntries.map(([name, def]) => {\n      const shortFlag = def.short ? `-${def.short}, ` : \"    \";\n      const longFlag = `--${name}`;\n      const valueHint =\n        def.type === \"string\" ? ` <${def.choices ? def.choices.join(\"|\") : \"value\"}>` : \"\";\n      return `${shortFlag}${longFlag}${valueHint}`;\n    });\n    const maxOptLen = Math.max(...optionStrings.map((s) => s.length));\n\n    for (let i = 0; i < optionEntries.length; i++) {\n      const [, def] = optionEntries[i];\n      const optStr = optionStrings[i].padEnd(maxOptLen + 2);\n      let description = def.description;\n\n      if (def.default !== undefined && def.default !== false && def.default !== \"\") {\n        description += pc.dim(` (default: ${def.default})`);\n      }\n\n      lines.push(`  ${pc.dim(optStr)}${description}`);\n    }\n\n    lines.push(\"\");\n  }\n\n  return lines.join(\"\\n\");\n}\n\n/**\n * Find a command by traversing the path\n */\nfunction findCommand(\n  root: CommandDef,\n  args: string[],\n): { command: CommandDef; commandPath: string[]; remainingArgs: string[] } {\n  let current = root;\n  const commandPath = [\"thalo\"];\n  const remainingArgs = [...args];\n\n  while (remainingArgs.length > 0) {\n    const nextArg = remainingArgs[0];\n\n    // Stop if it's an option\n    if (nextArg.startsWith(\"-\")) {\n      break;\n    }\n\n    // Check if it's a subcommand\n    if (current.subcommands && current.subcommands[nextArg]) {\n      current = current.subcommands[nextArg];\n      commandPath.push(nextArg);\n      remainingArgs.shift();\n    } else {\n      // Not a subcommand, must be a positional arg\n      break;\n    }\n  }\n\n  return { command: current, commandPath, remainingArgs };\n}\n\n/**\n * Parse and run a command\n */\nexport function runCli(rootCommand: CommandDef, argv: string[] = process.argv.slice(2)): void {\n  // Find the target command\n  const { command, commandPath, remainingArgs } = findCommand(rootCommand, argv);\n\n  // Merge global options with command options\n  const allOptions = { ...globalOptions, ...command.options };\n  const parseArgsOptions = toParseArgsConfig(allOptions);\n\n  // Parse arguments\n  let parsed: ReturnType<typeof parseArgs>;\n  try {\n    parsed = parseArgs({\n      args: remainingArgs,\n      options: parseArgsOptions,\n      allowPositionals: true,\n      strict: true,\n    });\n  } catch (err) {\n    if (err instanceof Error) {\n      console.error(pc.red(`Error: ${err.message}`));\n      console.error(`\\nRun '${commandPath.join(\" \")} --help' for usage information.`);\n    }\n    process.exit(2);\n  }\n\n  const { values, positionals } = parsed;\n\n  // Handle no-color by setting env var (picocolors respects NO_COLOR)\n  if (values[\"no-color\"]) {\n    process.env[\"NO_COLOR\"] = \"1\";\n  }\n\n  // Handle version (only at root level)\n  if (values[\"version\"] && commandPath.length === 1) {\n    getVersionInfo()\n      .then((info) => {\n        console.log(formatVersion(info));\n        process.exit(0);\n      })\n      .catch(() => {\n        console.log(\"thalo (version unknown)\");\n        process.exit(0);\n      });\n    return;\n  }\n\n  // Handle help\n  if (values[\"help\"]) {\n    console.log(generateHelp(command, commandPath));\n    process.exit(0);\n  }\n\n  // If command has subcommands but no action and no subcommand was specified, show help\n  if (command.subcommands && Object.keys(command.subcommands).length > 0 && !command.action) {\n    console.log(generateHelp(command, commandPath));\n    process.exit(0);\n  }\n\n  // Run the command action\n  if (command.action) {\n    const ctx: CommandContext = {\n      options: values as Record<string, string | boolean | string[]>,\n      args: positionals,\n      command,\n      commandPath,\n    };\n\n    Promise.resolve(command.action(ctx)).catch((err) => {\n      console.error(pc.red(`Error: ${err instanceof Error ? err.message : err}`));\n      process.exit(1);\n    });\n  } else {\n    console.log(generateHelp(command, commandPath));\n    process.exit(0);\n  }\n}\n"],"mappings":"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"}

package/dist/commands/check.js

@@ -1,9 +1,9 @@
 import { relativePath, resolveFilesSync } from "../files.js";
 import { createWorkspace } from "@rejot-dev/thalo/node";
 import pc from "picocolors";
+import * as path from "node:path";
 import { formatDiagnostic, runCheck } from "@rejot-dev/thalo";
 import * as fs from "node:fs";
-import * as path from "node:path";
 
 //#region src/commands/check.ts
 const SEVERITY_ORDER = {

package/dist/commands/format.js

@@ -1,9 +1,9 @@
 import { relativePath } from "../files.js";
 import { createWorkspace } from "@rejot-dev/thalo/node";
 import pc from "picocolors";
-import { runFormat } from "@rejot-dev/thalo";
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
+import { runFormat } from "@rejot-dev/thalo";
 import ignore from "ignore";
 
 //#region src/commands/format.ts

package/dist/commands/init.js

@@ -1,6 +1,6 @@
 import pc from "picocolors";
-import * as fs from "node:fs";
 import * as path from "node:path";
+import * as fs from "node:fs";
 
 //#region src/commands/init.ts
 const ENTITIES_THALO = `{{TIMESTAMP}} define-entity journal "Personal thoughts, reflections, and experiences" ^journal

package/dist/commands/setup-merge-driver.js

@@ -1,8 +1,8 @@
 import { promisify } from "node:util";
 import pc from "picocolors";
+import { execFile } from "node:child_process";
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
-import { execFile } from "node:child_process";
 
 //#region src/commands/setup-merge-driver.ts
 const execFile$1 = promisify(execFile);

package/dist/files.js

@@ -1,9 +1,9 @@
 import { createWorkspace } from "@rejot-dev/thalo/node";
 import pc from "picocolors";
-import * as fs from "node:fs";
 import { readFile, readdir, stat } from "node:fs/promises";
 import * as path from "node:path";
 import { join, resolve } from "node:path";
+import * as fs from "node:fs";
 
 //#region src/files.ts
 /**

package/dist/version.js

@@ -0,0 +1,79 @@
+import { isInitialized, isUsingNative } from "@rejot-dev/thalo/node";
+import { promisify } from "node:util";
+import { exec } from "node:child_process";
+import { readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+
+//#region src/version.ts
+const execAsync = promisify(exec);
+const packageRoot = join(dirname(fileURLToPath(import.meta.url)), "..");
+/**
+* Get the package version from package.json
+*/
+async function getPackageVersion() {
+	try {
+		const content = await readFile(join(packageRoot, "package.json"), "utf-8");
+		return JSON.parse(content).version || "unknown";
+	} catch {
+		return "unknown";
+	}
+}
+/**
+* Get git commit hash if running from a git repository
+*/
+async function getGitHash() {
+	try {
+		const { stdout } = await execAsync("git rev-parse --short HEAD", { cwd: packageRoot });
+		return stdout.trim() || null;
+	} catch {
+		return null;
+	}
+}
+/**
+* Check if there are uncommitted changes in the git repo
+*/
+async function isGitDirty() {
+	try {
+		const { stdout } = await execAsync("git status --porcelain", { cwd: packageRoot });
+		return stdout.trim().length > 0;
+	} catch {
+		return false;
+	}
+}
+/**
+* Get the parser backend being used (native, wasm, or unknown if not initialized)
+*/
+function getParserBackend() {
+	if (!isInitialized()) return "unknown";
+	return isUsingNative() ? "native" : "wasm";
+}
+/**
+* Get all version information
+*/
+async function getVersionInfo() {
+	const [version, gitHash, gitDirty] = await Promise.all([
+		getPackageVersion(),
+		getGitHash(),
+		isGitDirty()
+	]);
+	return {
+		version,
+		gitHash,
+		gitDirty,
+		parserBackend: getParserBackend()
+	};
+}
+/**
+* Format version info as a string for display
+*/
+function formatVersion(info) {
+	let versionStr = `thalo v${info.version}`;
+	if (info.gitHash) versionStr += ` (${info.gitHash}${info.gitDirty ? "-dirty" : ""})`;
+	versionStr += ` [${info.parserBackend}]`;
+	return versionStr;
+}
+
+//#endregion
+export { formatVersion, getVersionInfo };
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","names":[],"sources":["../src/version.ts"],"sourcesContent":["import { exec } from \"node:child_process\";\nimport { readFile } from \"node:fs/promises\";\nimport { promisify } from \"node:util\";\nimport { fileURLToPath } from \"node:url\";\nimport { dirname, join } from \"node:path\";\nimport { isInitialized, isUsingNative } from \"@rejot-dev/thalo/node\";\n\nconst execAsync = promisify(exec);\n\n// Compute package root once at module level\n// In dist/, go up one level to find package.json\n// In src/, go up one level to find package.json\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst packageRoot = join(__dirname, \"..\");\n\n/**\n * Get the package version from package.json\n */\nasync function getPackageVersion(): Promise<string> {\n  try {\n    const packageJsonPath = join(packageRoot, \"package.json\");\n    const content = await readFile(packageJsonPath, \"utf-8\");\n    const pkg = JSON.parse(content);\n    return pkg.version || \"unknown\";\n  } catch {\n    return \"unknown\";\n  }\n}\n\n/**\n * Get git commit hash if running from a git repository\n */\nasync function getGitHash(): Promise<string | null> {\n  try {\n    const { stdout } = await execAsync(\"git rev-parse --short HEAD\", { cwd: packageRoot });\n    return stdout.trim() || null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Check if there are uncommitted changes in the git repo\n */\nasync function isGitDirty(): Promise<boolean> {\n  try {\n    const { stdout } = await execAsync(\"git status --porcelain\", { cwd: packageRoot });\n    return stdout.trim().length > 0;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Get the parser backend being used (native, wasm, or unknown if not initialized)\n */\nfunction getParserBackend(): \"native\" | \"wasm\" | \"unknown\" {\n  if (!isInitialized()) {\n    return \"unknown\";\n  }\n  return isUsingNative() ? \"native\" : \"wasm\";\n}\n\n/**\n * Version info structure\n */\nexport interface VersionInfo {\n  version: string;\n  gitHash: string | null;\n  gitDirty: boolean;\n  parserBackend: \"native\" | \"wasm\" | \"unknown\";\n}\n\n/**\n * Get all version information\n */\nexport async function getVersionInfo(): Promise<VersionInfo> {\n  const [version, gitHash, gitDirty] = await Promise.all([\n    getPackageVersion(),\n    getGitHash(),\n    isGitDirty(),\n  ]);\n\n  return {\n    version,\n    gitHash,\n    gitDirty,\n    parserBackend: getParserBackend(),\n  };\n}\n\n/**\n * Format version info as a string for display\n */\nexport function formatVersion(info: VersionInfo): string {\n  let versionStr = `thalo v${info.version}`;\n\n  if (info.gitHash) {\n    versionStr += ` (${info.gitHash}${info.gitDirty ? \"-dirty\" : \"\"})`;\n  }\n\n  versionStr += ` [${info.parserBackend}]`;\n\n  return versionStr;\n}\n"],"mappings":";;;;;;;;AAOA,MAAM,YAAY,UAAU,KAAK;AAMjC,MAAM,cAAc,KADF,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC,EACrB,KAAK;;;;AAKzC,eAAe,oBAAqC;AAClD,KAAI;EAEF,MAAM,UAAU,MAAM,SADE,KAAK,aAAa,eAAe,EACT,QAAQ;AAExD,SADY,KAAK,MAAM,QAAQ,CACpB,WAAW;SAChB;AACN,SAAO;;;;;;AAOX,eAAe,aAAqC;AAClD,KAAI;EACF,MAAM,EAAE,WAAW,MAAM,UAAU,8BAA8B,EAAE,KAAK,aAAa,CAAC;AACtF,SAAO,OAAO,MAAM,IAAI;SAClB;AACN,SAAO;;;;;;AAOX,eAAe,aAA+B;AAC5C,KAAI;EACF,MAAM,EAAE,WAAW,MAAM,UAAU,0BAA0B,EAAE,KAAK,aAAa,CAAC;AAClF,SAAO,OAAO,MAAM,CAAC,SAAS;SACxB;AACN,SAAO;;;;;;AAOX,SAAS,mBAAkD;AACzD,KAAI,CAAC,eAAe,CAClB,QAAO;AAET,QAAO,eAAe,GAAG,WAAW;;;;;AAgBtC,eAAsB,iBAAuC;CAC3D,MAAM,CAAC,SAAS,SAAS,YAAY,MAAM,QAAQ,IAAI;EACrD,mBAAmB;EACnB,YAAY;EACZ,YAAY;EACb,CAAC;AAEF,QAAO;EACL;EACA;EACA;EACA,eAAe,kBAAkB;EAClC;;;;;AAMH,SAAgB,cAAc,MAA2B;CACvD,IAAI,aAAa,UAAU,KAAK;AAEhC,KAAI,KAAK,QACP,eAAc,KAAK,KAAK,UAAU,KAAK,WAAW,WAAW,GAAG;AAGlE,eAAc,KAAK,KAAK,cAAc;AAEtC,QAAO"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rejot-dev/thalo-cli",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "type": "module",
   "repository": {
     "type": "git",
@@ -30,10 +30,10 @@
     "prettier": "^3.5.3",
     "vscode-languageserver": "^9.0.1",
     "web-tree-sitter": "^0.25.0",
-    "@rejot-dev/thalo": "0.2.0",
-    "@rejot-dev/thalo-lsp": "0.2.0",
-    "@rejot-dev/thalo-prettier": "0.2.0",
-    "@rejot-dev/tree-sitter-thalo": "0.2.0"
+    "@rejot-dev/thalo": "0.2.1",
+    "@rejot-dev/thalo-lsp": "0.2.1",
+    "@rejot-dev/thalo-prettier": "0.2.1",
+    "@rejot-dev/tree-sitter-thalo": "0.2.1"
   },
   "optionalDependencies": {
     "tree-sitter": "^0.25.0"