@rejot-dev/thalo-cli 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 - present ReJot Nederland B.V., and individual contributors.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,179 @@
+# thalo-cli
+
+A command-line linter for thalo files. Runs diagnostics on `.thalo` and `.md` files containing thalo
+syntax.
+
+## Installation
+
+```bash
+# From the monorepo root
+pnpm install
+pnpm exec turbo run build --filter=@rejot-dev/thalo-cli
+
+# Run directly
+node apps/thalo-cli/dist/mod.js --help
+```
+
+## Usage
+
+```bash
+thalo [options] [files or directories...]
+```
+
+### Basic Examples
+
+```bash
+# Check all files in a directory
+thalo notes/
+
+# Check specific files
+thalo file.thalo journal.md
+
+# Check current directory
+thalo
+```
+
+## Options
+
+| Option                | Description                                            |
+| --------------------- | ------------------------------------------------------ |
+| `-h, --help`          | Show help message                                      |
+| `-v, --version`       | Show version number                                    |
+| `-q, --quiet`         | Only show errors, suppress warnings and info           |
+| `-f, --format <fmt>`  | Output format: `default`, `json`, `compact`, `github`  |
+| `--no-color`          | Disable colored output                                 |
+| `--severity <level>`  | Minimum severity to report: `error`, `warning`, `info` |
+| `--max-warnings <n>`  | Exit with error if warnings exceed threshold           |
+| `--rule <rule>=<sev>` | Set rule severity (can be repeated)                    |
+| `--list-rules`        | List all available rules                               |
+| `-w, --watch`         | Watch files for changes and re-run                     |
+
+## Output Formats
+
+### Default
+
+Colored output with file location, severity, rule code, and message:
+
+```
+/path/to/file.md:1:1 ERROR [unknown-entity] Unknown entity type 'lore'.
+/path/to/file.md:3:11 WARNING [unresolved-link] Unresolved link '^self'.
+```
+
+### JSON (`-f json`)
+
+Structured JSON output for tooling integration:
+
+```json
+{
+  "files": 11,
+  "issues": 70,
+  "errors": 54,
+  "warnings": 16,
+  "info": 0,
+  "diagnostics": [
+    {
+      "file": "/path/to/file.md",
+      "line": 1,
+      "column": 1,
+      "endLine": 9,
+      "endColumn": 1,
+      "severity": "error",
+      "code": "unknown-entity",
+      "message": "Unknown entity type 'lore'."
+    }
+  ]
+}
+```
+
+### Compact (`-f compact`)
+
+Minimal single-line format:
+
+```
+/path/to/file.md:1:1: E [unknown-entity] Unknown entity type 'lore'.
+/path/to/file.md:3:11: W [unresolved-link] Unresolved link '^self'.
+```
+
+### GitHub Actions (`-f github`)
+
+Workflow commands for GitHub Actions annotations:
+
+```
+::error file=/path/to/file.md,line=1,col=1,endLine=9,endColumn=1,title=unknown-entity::Unknown entity type 'lore'.
+::warning file=/path/to/file.md,line=3,col=11,endLine=3,endColumn=17,title=unresolved-link::Unresolved link '^self'.
+```
+
+## Rules
+
+List all available rules with `--list-rules`:
+
+| Rule                       | Default | Description                      |
+| -------------------------- | ------- | -------------------------------- |
+| `unknown-entity`           | error   | Unknown entity type used         |
+| `missing-required-field`   | error   | Required metadata field missing  |
+| `unknown-field`            | warning | Unknown metadata field used      |
+| `invalid-field-type`       | error   | Field value has wrong type       |
+| `missing-required-section` | error   | Required section missing         |
+| `unknown-section`          | warning | Unknown section used             |
+| `unresolved-link`          | warning | Link reference not found         |
+| `duplicate-link-id`        | error   | Same link ID used multiple times |
+
+### Configuring Rules
+
+Override rule severities with `--rule`:
+
+```bash
+# Disable a rule
+thalo --rule unknown-entity=off notes/
+
+# Change severity
+thalo --rule unresolved-link=error notes/
+
+# Multiple rules
+thalo --rule unknown-entity=off --rule unknown-field=off notes/
+```
+
+Valid severities: `error`, `warning`, `info`, `off`
+
+## CI Integration
+
+### GitHub Actions
+
+```yaml
+- name: Lint thalo files
+  run: thalo -f github notes/
+```
+
+### Warning Threshold
+
+Fail if too many warnings:
+
+```bash
+thalo --max-warnings 10 notes/
+```
+
+### JSON Report
+
+Generate a report file:
+
+```bash
+thalo -f json notes/ > thalo-report.json
+```
+
+## Watch Mode
+
+Re-run on file changes:
+
+```bash
+thalo -w notes/
+```
+
+Press `Ctrl+C` to exit.
+
+## Exit Codes
+
+| Code | Meaning                               |
+| ---- | ------------------------------------- |
+| `0`  | No errors                             |
+| `1`  | Errors found or max warnings exceeded |
+| `2`  | Invalid arguments                     |

package/bin/run.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/mod.js";

package/dist/cli.js

@@ -0,0 +1,175 @@
+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
+*/
+function toParseArgsConfig(options) {
+	const config = {};
+	for (const [name, def] of Object.entries(options)) {
+		const optConfig = { type: def.type };
+		if (def.short) optConfig.short = def.short;
+		if (def.default !== void 0) optConfig.default = def.default;
+		if (def.multiple !== void 0) optConfig.multiple = def.multiple;
+		config[name] = optConfig;
+	}
+	return config;
+}
+/**
+* Global options available to all commands
+*/
+const globalOptions = {
+	help: {
+		type: "boolean",
+		short: "h",
+		description: "Show help for the command",
+		default: false
+	},
+	version: {
+		type: "boolean",
+		short: "V",
+		description: "Show version number",
+		default: false
+	},
+	"no-color": {
+		type: "boolean",
+		description: "Disable colored output",
+		default: false
+	}
+};
+/**
+* Generate help text for a command
+*/
+function generateHelp(command, commandPath = []) {
+	const lines = [];
+	const fullCommandName = commandPath.length > 0 ? commandPath.join(" ") : "thalo";
+	lines.push("");
+	lines.push(pc.bold(command.description));
+	lines.push("");
+	lines.push(pc.bold("USAGE"));
+	let usageLine = `  ${fullCommandName}`;
+	if (command.subcommands && Object.keys(command.subcommands).length > 0) usageLine += " <command>";
+	if (command.options && Object.keys(command.options).length > 0) usageLine += " [options]";
+	if (command.args) {
+		const argName = command.args.multiple ? `<${command.args.name}...>` : `<${command.args.name}>`;
+		usageLine += command.args.required ? ` ${argName}` : ` [${argName}]`;
+	}
+	if (command.usage) usageLine = `  ${fullCommandName} ${command.usage}`;
+	lines.push(usageLine);
+	lines.push("");
+	if (command.subcommands && Object.keys(command.subcommands).length > 0) {
+		lines.push(pc.bold("COMMANDS"));
+		const subcommandNames = Object.keys(command.subcommands);
+		const maxLen = Math.max(...subcommandNames.map((n) => n.length));
+		for (const [name, subcmd] of Object.entries(command.subcommands)) {
+			const paddedName = name.padEnd(maxLen + 2);
+			lines.push(`  ${pc.cyan(paddedName)}${subcmd.description}`);
+		}
+		lines.push("");
+		lines.push(`  Run '${fullCommandName} <command> --help' for more information on a command.`);
+		lines.push("");
+	}
+	const allOptions = {
+		...globalOptions,
+		...command.options
+	};
+	if (Object.keys(allOptions).length > 0) {
+		lines.push(pc.bold("OPTIONS"));
+		const optionEntries = Object.entries(allOptions);
+		const optionStrings = optionEntries.map(([name, def]) => {
+			return `${def.short ? `-${def.short}, ` : "    "}${`--${name}`}${def.type === "string" ? ` <${def.choices ? def.choices.join("|") : "value"}>` : ""}`;
+		});
+		const maxOptLen = Math.max(...optionStrings.map((s) => s.length));
+		for (let i = 0; i < optionEntries.length; i++) {
+			const [, def] = optionEntries[i];
+			const optStr = optionStrings[i].padEnd(maxOptLen + 2);
+			let description = def.description;
+			if (def.default !== void 0 && def.default !== false && def.default !== "") description += pc.dim(` (default: ${def.default})`);
+			lines.push(`  ${pc.dim(optStr)}${description}`);
+		}
+		lines.push("");
+	}
+	return lines.join("\n");
+}
+/**
+* Find a command by traversing the path
+*/
+function findCommand(root, args) {
+	let current = root;
+	const commandPath = ["thalo"];
+	const remainingArgs = [...args];
+	while (remainingArgs.length > 0) {
+		const nextArg = remainingArgs[0];
+		if (nextArg.startsWith("-")) break;
+		if (current.subcommands && current.subcommands[nextArg]) {
+			current = current.subcommands[nextArg];
+			commandPath.push(nextArg);
+			remainingArgs.shift();
+		} else break;
+	}
+	return {
+		command: current,
+		commandPath,
+		remainingArgs
+	};
+}
+/**
+* Parse and run a command
+*/
+function runCli(rootCommand, argv = process.argv.slice(2)) {
+	const { command, commandPath, remainingArgs } = findCommand(rootCommand, argv);
+	const parseArgsOptions = toParseArgsConfig({
+		...globalOptions,
+		...command.options
+	});
+	let parsed;
+	try {
+		parsed = parseArgs({
+			args: remainingArgs,
+			options: parseArgsOptions,
+			allowPositionals: true,
+			strict: true
+		});
+	} catch (err) {
+		if (err instanceof Error) {
+			console.error(pc.red(`Error: ${err.message}`));
+			console.error(`\nRun '${commandPath.join(" ")} --help' for usage information.`);
+		}
+		process.exit(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);
+	}
+	if (values["help"]) {
+		console.log(generateHelp(command, commandPath));
+		process.exit(0);
+	}
+	if (command.subcommands && Object.keys(command.subcommands).length > 0 && !command.action) {
+		console.log(generateHelp(command, commandPath));
+		process.exit(0);
+	}
+	if (command.action) {
+		const ctx = {
+			options: values,
+			args: positionals,
+			command,
+			commandPath
+		};
+		Promise.resolve(command.action(ctx)).catch((err) => {
+			console.error(pc.red(`Error: ${err instanceof Error ? err.message : err}`));
+			process.exit(1);
+		});
+	} else {
+		console.log(generateHelp(command, commandPath));
+		process.exit(0);
+	}
+}
+
+//#endregion
+export { runCli };
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +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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"}

package/dist/commands/actualize.js

@@ -0,0 +1,124 @@
+import { loadFullWorkspace, relativePath } from "../files.js";
+import pc from "picocolors";
+import { DEFAULT_INSTRUCTIONS_TEMPLATE, generateInstructions, generateTimestamp, runActualize } from "@rejot-dev/thalo";
+import { formatCheckpoint } from "@rejot-dev/thalo/change-tracker";
+import { UncommittedChangesError, createChangeTracker } from "@rejot-dev/thalo/change-tracker/node";
+
+//#region src/commands/actualize.ts
+/**
+* Format a synthesis that is up to date.
+*/
+function formatUpToDate(synthesis) {
+	return pc.green(`✓ ${relativePath(synthesis.file)}: ${synthesis.title} - up to date`);
+}
+/**
+* Format a synthesis with pending entries.
+*/
+function formatSynthesisWithEntries(synthesis, instructionsTemplate) {
+	const lines = [];
+	lines.push("");
+	lines.push(pc.bold(pc.cyan(`=== Synthesis: ${synthesis.title} (${relativePath(synthesis.file)}) ===`)));
+	lines.push(`Target: ${pc.yellow(`^${synthesis.linkId}`)}`);
+	lines.push(`Sources: ${synthesis.sources.join(", ")}`);
+	if (synthesis.lastCheckpoint) {
+		const markerDisplay = synthesis.lastCheckpoint.type === "git" ? `git:${synthesis.lastCheckpoint.value.slice(0, 7)}` : formatCheckpoint(synthesis.lastCheckpoint);
+		lines.push(`Last checkpoint: ${pc.dim(markerDisplay)}`);
+	}
+	lines.push("");
+	lines.push(pc.bold("--- User Prompt ---"));
+	lines.push(synthesis.prompt || pc.dim("(no prompt defined)"));
+	lines.push("");
+	lines.push(pc.bold(`--- Changed Entries (${synthesis.entries.length}) ---`));
+	for (const entry of synthesis.entries) {
+		lines.push("");
+		lines.push(entry.rawText);
+	}
+	const checkpointValue = formatCheckpoint(synthesis.currentCheckpoint);
+	const instructions = generateInstructions(instructionsTemplate, {
+		file: relativePath(synthesis.file),
+		linkId: synthesis.linkId,
+		checkpoint: checkpointValue,
+		timestamp: generateTimestamp()
+	});
+	lines.push("");
+	lines.push(pc.bold("--- Instructions ---"));
+	lines.push(instructions);
+	lines.push("");
+	lines.push(pc.dim("─".repeat(60)));
+	return lines.join("\n");
+}
+async function actualizeAction(ctx) {
+	const { args, options } = ctx;
+	const instructionsTemplate = options["instructions"] || DEFAULT_INSTRUCTIONS_TEMPLATE;
+	const force = options["force"];
+	const { workspace, files } = await loadFullWorkspace();
+	if (files.length === 0) {
+		console.log("No .thalo or .md files found.");
+		process.exit(0);
+	}
+	const tracker = await createChangeTracker({
+		cwd: process.cwd(),
+		force
+	});
+	let result;
+	try {
+		result = await runActualize(workspace, {
+			targetLinkIds: args.length > 0 ? args : void 0,
+			tracker
+		});
+	} catch (error) {
+		if (error instanceof UncommittedChangesError) {
+			console.error(pc.red("Error: Source files have uncommitted changes:"));
+			for (const file of error.files) console.error(pc.yellow(`  - ${file}`));
+			console.error();
+			console.error(pc.dim("Commit your changes or use --force to proceed anyway."));
+			console.error(pc.dim("Note: Using --force may cause already-processed entries to appear again."));
+			process.exit(1);
+		}
+		throw error;
+	}
+	if (result.trackerType === "git") console.log(pc.dim("Using git-based change tracking"));
+	for (const id of result.notFoundLinkIds) console.error(pc.yellow(`Warning: No synthesis found with link ID: ^${id}`));
+	if (args.length > 0 && result.syntheses.length === 0 && result.notFoundLinkIds.length > 0) process.exit(1);
+	if (result.syntheses.length === 0) {
+		console.log(pc.dim("No synthesis definitions found."));
+		process.exit(0);
+	}
+	let hasOutput = false;
+	for (const synthesis of result.syntheses) if (synthesis.isUpToDate) console.log(formatUpToDate(synthesis));
+	else {
+		hasOutput = true;
+		console.log(formatSynthesisWithEntries(synthesis, instructionsTemplate));
+	}
+	if (!hasOutput) {
+		console.log();
+		console.log(pc.green("All syntheses are up to date."));
+	}
+}
+const actualizeCommand = {
+	name: "actualize",
+	description: "Output prompts and entries for pending synthesis updates",
+	args: {
+		name: "links",
+		description: "Link IDs of synthesis definitions to actualize (e.g., ^my-synthesis). If omitted, all syntheses are checked.",
+		required: false,
+		multiple: true
+	},
+	options: {
+		instructions: {
+			type: "string",
+			short: "i",
+			description: "Custom instructions template. Use placeholders: {file}, {linkId}, {checkpoint}"
+		},
+		force: {
+			type: "boolean",
+			short: "f",
+			description: "Proceed even if source files have uncommitted changes. May cause duplicate processing."
+		}
+	},
+	action: actualizeAction
+};
+
+//#endregion
+export { actualizeCommand };
+//# sourceMappingURL=actualize.js.map

package/dist/commands/actualize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actualize.js","names":["lines: string[]","actualizeCommand: CommandDef"],"sources":["../../src/commands/actualize.ts"],"sourcesContent":["import {\n  runActualize,\n  generateInstructions,\n  generateTimestamp,\n  DEFAULT_INSTRUCTIONS_TEMPLATE,\n  type SynthesisOutputInfo,\n} from \"@rejot-dev/thalo\";\nimport { formatCheckpoint } from \"@rejot-dev/thalo/change-tracker\";\nimport { createChangeTracker, UncommittedChangesError } from \"@rejot-dev/thalo/change-tracker/node\";\nimport pc from \"picocolors\";\nimport type { CommandDef, CommandContext } from \"../cli.js\";\nimport { loadFullWorkspace, relativePath } from \"../files.js\";\n\n/**\n * Format a synthesis that is up to date.\n */\nfunction formatUpToDate(synthesis: SynthesisOutputInfo): string {\n  return pc.green(`✓ ${relativePath(synthesis.file)}: ${synthesis.title} - up to date`);\n}\n\n/**\n * Format a synthesis with pending entries.\n */\nfunction formatSynthesisWithEntries(\n  synthesis: SynthesisOutputInfo,\n  instructionsTemplate: string,\n): string {\n  const lines: string[] = [];\n\n  // Header\n  lines.push(\"\");\n  lines.push(\n    pc.bold(pc.cyan(`=== Synthesis: ${synthesis.title} (${relativePath(synthesis.file)}) ===`)),\n  );\n  lines.push(`Target: ${pc.yellow(`^${synthesis.linkId}`)}`);\n  lines.push(`Sources: ${synthesis.sources.join(\", \")}`);\n\n  if (synthesis.lastCheckpoint) {\n    const markerDisplay =\n      synthesis.lastCheckpoint.type === \"git\"\n        ? `git:${synthesis.lastCheckpoint.value.slice(0, 7)}`\n        : formatCheckpoint(synthesis.lastCheckpoint);\n    lines.push(`Last checkpoint: ${pc.dim(markerDisplay)}`);\n  }\n\n  // Prompt\n  lines.push(\"\");\n  lines.push(pc.bold(\"--- User Prompt ---\"));\n  lines.push(synthesis.prompt || pc.dim(\"(no prompt defined)\"));\n\n  // Entries\n  lines.push(\"\");\n  lines.push(pc.bold(`--- Changed Entries (${synthesis.entries.length}) ---`));\n  for (const entry of synthesis.entries) {\n    lines.push(\"\");\n    lines.push(entry.rawText);\n  }\n\n  // Instructions\n  const checkpointValue = formatCheckpoint(synthesis.currentCheckpoint);\n  const instructions = generateInstructions(instructionsTemplate, {\n    file: relativePath(synthesis.file),\n    linkId: synthesis.linkId,\n    checkpoint: checkpointValue,\n    timestamp: generateTimestamp(),\n  });\n\n  lines.push(\"\");\n  lines.push(pc.bold(\"--- Instructions ---\"));\n  lines.push(instructions);\n  lines.push(\"\");\n  lines.push(pc.dim(\"─\".repeat(60)));\n\n  return lines.join(\"\\n\");\n}\n\nasync function actualizeAction(ctx: CommandContext): Promise<void> {\n  const { args, options } = ctx;\n  const instructionsTemplate = (options[\"instructions\"] as string) || DEFAULT_INSTRUCTIONS_TEMPLATE;\n  const force = options[\"force\"] as boolean;\n\n  // Load full workspace from CWD\n  const { workspace, files } = await loadFullWorkspace();\n  if (files.length === 0) {\n    console.log(\"No .thalo or .md files found.\");\n    process.exit(0);\n  }\n\n  // Create change tracker (auto-detects git)\n  const tracker = await createChangeTracker({ cwd: process.cwd(), force });\n\n  // Run actualize command\n  let result;\n  try {\n    result = await runActualize(workspace, {\n      targetLinkIds: args.length > 0 ? args : undefined,\n      tracker,\n    });\n  } catch (error) {\n    if (error instanceof UncommittedChangesError) {\n      console.error(pc.red(\"Error: Source files have uncommitted changes:\"));\n      for (const file of error.files) {\n        console.error(pc.yellow(`  - ${file}`));\n      }\n      console.error();\n      console.error(pc.dim(\"Commit your changes or use --force to proceed anyway.\"));\n      console.error(\n        pc.dim(\"Note: Using --force may cause already-processed entries to appear again.\"),\n      );\n      process.exit(1);\n    }\n    throw error;\n  }\n\n  // Show tracker type\n  if (result.trackerType === \"git\") {\n    console.log(pc.dim(\"Using git-based change tracking\"));\n  }\n\n  // Warn about not found link IDs\n  for (const id of result.notFoundLinkIds) {\n    console.error(pc.yellow(`Warning: No synthesis found with link ID: ^${id}`));\n  }\n\n  // Exit early if we filtered to specific IDs but found none\n  if (args.length > 0 && result.syntheses.length === 0 && result.notFoundLinkIds.length > 0) {\n    process.exit(1);\n  }\n\n  if (result.syntheses.length === 0) {\n    console.log(pc.dim(\"No synthesis definitions found.\"));\n    process.exit(0);\n  }\n\n  // Output results\n  let hasOutput = false;\n  for (const synthesis of result.syntheses) {\n    if (synthesis.isUpToDate) {\n      console.log(formatUpToDate(synthesis));\n    } else {\n      hasOutput = true;\n      console.log(formatSynthesisWithEntries(synthesis, instructionsTemplate));\n    }\n  }\n\n  if (!hasOutput) {\n    console.log();\n    console.log(pc.green(\"All syntheses are up to date.\"));\n  }\n}\n\nexport const actualizeCommand: CommandDef = {\n  name: \"actualize\",\n  description: \"Output prompts and entries for pending synthesis updates\",\n  args: {\n    name: \"links\",\n    description:\n      \"Link IDs of synthesis definitions to actualize (e.g., ^my-synthesis). If omitted, all syntheses are checked.\",\n    required: false,\n    multiple: true,\n  },\n  options: {\n    instructions: {\n      type: \"string\",\n      short: \"i\",\n      description: \"Custom instructions template. Use placeholders: {file}, {linkId}, {checkpoint}\",\n    },\n    force: {\n      type: \"boolean\",\n      short: \"f\",\n      description:\n        \"Proceed even if source files have uncommitted changes. May cause duplicate processing.\",\n    },\n  },\n  action: actualizeAction,\n};\n"],"mappings":"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"}