@rejot-dev/thalo-cli 0.0.0

package/dist/commands/init.js

@@ -0,0 +1,192 @@
+import pc from "picocolors";
+import * as fs from "node:fs";
+import * as path from "node:path";
+
+//#region src/commands/init.ts
+const ENTITIES_THALO = `{{TIMESTAMP}} define-entity journal "Personal thoughts, reflections, and experiences" ^journal
+  # Metadata
+  subject: string | link ; "Subject name/slug (use ^self for personal)"
+  type: string ; "idea, reflection, experience, doubt, question, etc."
+  mood?: string ; "Free text mood"
+  context?: string ; "What prompted this entry"
+  # Sections
+  Entry ; "The journal entry content"
+
+{{TIMESTAMP}} define-entity opinion "Formed stances on topics" ^opinion
+  # Metadata
+  confidence: "high" | "medium" | "low"
+  supersedes?: link ; "Reference to previous stance"
+  related?: link[] ; "Related entries"
+  # Sections
+  Claim ; "Core opinion in 1-2 sentences"
+  Reasoning ; "Bullet points supporting the claim"
+  Caveats? ; "Edge cases, limitations, exceptions"
+
+{{TIMESTAMP}} define-entity reference "External resources or local files" ^reference
+  # Metadata
+  url?: string ; "Full URL to external resource"
+  file?: string ; "Path to local file"
+  ref-type: "article" | "video" | "tweet" | "paper" | "book" | "other"
+  author?: string | link ; "Creator/author name"
+  published?: datetime ; "Publication date"
+  status?: "unread" | "read" | "processed" = "unread"
+  # Sections
+  Summary? ; "Brief summary of the content"
+  Key Takeaways? ; "Bullet points of main insights"
+  Related? ; "Links to related entries"
+
+{{TIMESTAMP}} define-entity lore "Facts and insights about subjects or yourself" ^lore
+  # Metadata
+  type: "fact" | "insight" ; "fact = verifiable info, insight = learned wisdom"
+  subject: string | link ; "Subject name/slug (use ^self for personal lore)"
+  date?: date-range ; "Relevant date or date range"
+  # Sections
+  Description ; "The lore content"
+
+{{TIMESTAMP}} define-entity me "Entity to allow for self-references" ^self
+  # Sections
+  Bio ; "Need at least one section"
+`;
+const AGENTS_MD = `# THALO - Thought And Lore Language
+
+Entity schemas are defined in \`entities.thalo\`.
+
+## Entry Syntax
+
+\`\`\`
+{timestamp} {directive} {entity} "Title" [^link-id] [#tags...]
+  {key}: {value}
+  ...
+
+  # Section
+  {content}
+
+\`\`\`
+
+- **timestamp**: ISO 8601 local time with timezone (\`2026-01-05T15:30Z\`)
+- **directive**: \`create\` or \`update\`
+- **entity**: \`journal\`, \`opinion\`, \`reference\`, or \`lore\`
+- **^link-id**: Optional explicit ID for cross-referencing
+- **#tag**: Optional categorization tags
+
+## Metadata
+
+Metadata fields are indented key-value pairs. See \`entities.thalo\` for required/optional
+fields per entity. Values can be:
+
+- Strings: \`author: "Jane Doe"\` or unquoted \`author: Jane Doe\`
+- Links: \`subject: ^self\` or \`related: ^my-other-entry\`
+- Dates: \`published: 2023-03-16\`
+- Date ranges: \`date: 2020 ~ 2021\`
+
+## Sections
+
+Content sections start with \`# SectionName\` (indented). **All content must be within a section.**
+Each entity type defines which sections are required/optional in \`entities.thalo\`.
+
+## Example
+
+\`\`\`thalo
+2026-01-05T16:00Z create opinion "TypeScript enums should be avoided" ^opinion-ts-enums #typescript
+  confidence: "high"
+
+  # Claim
+  TypeScript enums should be replaced with \`as const\` objects.
+
+  # Reasoning
+  - Enums generate runtime code
+  - \`as const\` provides the same type safety with zero overhead
+
+\`\`\`
+
+## Tips
+
+- Run \`date -u +"%Y-%m-%dT%H:%MZ"\` to get the current timestamp
+- Use \`thalo check\` to validate entries against schemas
+`;
+const PERSONAL_BIO_MD = `\`\`\`thalo
+{{TIMESTAMP}} define-synthesis "Personal Bio" ^bio-synthesis #profile
+  sources: lore where subject = ^self
+
+  # Prompt
+  Write a narrative bio from the collected facts and insights.
+  Keep it professional but personable.
+\`\`\`
+
+# Personal Bio
+`;
+function initAction(ctx) {
+	const { options, args } = ctx;
+	const targetDir = args.length > 0 ? path.resolve(args[0]) : process.cwd();
+	const timestamp = (/* @__PURE__ */ new Date()).toISOString().slice(0, 16) + "Z";
+	const dryRun = options["dry-run"];
+	const force = options["force"];
+	if (dryRun) {
+		console.log(pc.dim("Dry run mode - no files will be created"));
+		console.log();
+	}
+	console.log(pc.bold("Initializing THALO..."));
+	console.log();
+	const files = [
+		{
+			path: "entities.thalo",
+			content: ENTITIES_THALO.replace(/\{\{TIMESTAMP\}\}/g, timestamp)
+		},
+		{
+			path: "AGENTS.md",
+			content: AGENTS_MD
+		},
+		{
+			path: "personal-bio.md",
+			content: PERSONAL_BIO_MD.replace(/\{\{TIMESTAMP\}\}/g, timestamp)
+		}
+	];
+	let createdCount = 0;
+	let warningCount = 0;
+	for (const file of files) {
+		const fullPath = path.join(targetDir, file.path);
+		const exists = fs.existsSync(fullPath);
+		if (exists && !force) {
+			console.log(`${pc.yellow("⚠")} ${pc.yellow("warning:")} ${file.path} already exists, skipping`);
+			warningCount++;
+			continue;
+		}
+		if (exists && force) console.log(`${pc.yellow("⚠")} ${pc.yellow("overwriting:")} ${file.path}`);
+		if (!dryRun) fs.writeFileSync(fullPath, file.content, "utf-8");
+		console.log(`${pc.green("✓")} Created: ${pc.dim(file.path)}`);
+		createdCount++;
+	}
+	console.log();
+	if (warningCount > 0) console.log(`${pc.yellow("Warnings:")} ${warningCount} file(s) already exist`);
+	if (dryRun) console.log(pc.dim("Run without --dry-run to create files."));
+	else if (createdCount > 0) console.log(`${pc.green("✓")} Done! Created ${createdCount} file(s).`);
+}
+const initCommand = {
+	name: "init",
+	description: "Initialize THALO with entity definitions and documentation",
+	args: {
+		name: "directory",
+		description: "Target directory (defaults to current directory)",
+		required: false,
+		multiple: false
+	},
+	options: {
+		"dry-run": {
+			type: "boolean",
+			short: "n",
+			description: "Show what would be created without making changes",
+			default: false
+		},
+		force: {
+			type: "boolean",
+			short: "f",
+			description: "Overwrite existing files",
+			default: false
+		}
+	},
+	action: initAction
+};
+
+//#endregion
+export { initCommand };
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","names":["initCommand: CommandDef"],"sources":["../../src/commands/init.ts"],"sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport pc from \"picocolors\";\nimport type { CommandDef, CommandContext } from \"../cli.js\";\n\n// ─────────────────────────────────────────────────────────────────────────────\n// File Templates\n// ─────────────────────────────────────────────────────────────────────────────\n\nconst ENTITIES_THALO = `{{TIMESTAMP}} define-entity journal \"Personal thoughts, reflections, and experiences\" ^journal\n  # Metadata\n  subject: string | link ; \"Subject name/slug (use ^self for personal)\"\n  type: string ; \"idea, reflection, experience, doubt, question, etc.\"\n  mood?: string ; \"Free text mood\"\n  context?: string ; \"What prompted this entry\"\n  # Sections\n  Entry ; \"The journal entry content\"\n\n{{TIMESTAMP}} define-entity opinion \"Formed stances on topics\" ^opinion\n  # Metadata\n  confidence: \"high\" | \"medium\" | \"low\"\n  supersedes?: link ; \"Reference to previous stance\"\n  related?: link[] ; \"Related entries\"\n  # Sections\n  Claim ; \"Core opinion in 1-2 sentences\"\n  Reasoning ; \"Bullet points supporting the claim\"\n  Caveats? ; \"Edge cases, limitations, exceptions\"\n\n{{TIMESTAMP}} define-entity reference \"External resources or local files\" ^reference\n  # Metadata\n  url?: string ; \"Full URL to external resource\"\n  file?: string ; \"Path to local file\"\n  ref-type: \"article\" | \"video\" | \"tweet\" | \"paper\" | \"book\" | \"other\"\n  author?: string | link ; \"Creator/author name\"\n  published?: datetime ; \"Publication date\"\n  status?: \"unread\" | \"read\" | \"processed\" = \"unread\"\n  # Sections\n  Summary? ; \"Brief summary of the content\"\n  Key Takeaways? ; \"Bullet points of main insights\"\n  Related? ; \"Links to related entries\"\n\n{{TIMESTAMP}} define-entity lore \"Facts and insights about subjects or yourself\" ^lore\n  # Metadata\n  type: \"fact\" | \"insight\" ; \"fact = verifiable info, insight = learned wisdom\"\n  subject: string | link ; \"Subject name/slug (use ^self for personal lore)\"\n  date?: date-range ; \"Relevant date or date range\"\n  # Sections\n  Description ; \"The lore content\"\n\n{{TIMESTAMP}} define-entity me \"Entity to allow for self-references\" ^self\n  # Sections\n  Bio ; \"Need at least one section\"\n`;\n\nconst AGENTS_MD = `# THALO - Thought And Lore Language\n\nEntity schemas are defined in \\`entities.thalo\\`.\n\n## Entry Syntax\n\n\\`\\`\\`\n{timestamp} {directive} {entity} \"Title\" [^link-id] [#tags...]\n  {key}: {value}\n  ...\n\n  # Section\n  {content}\n\n\\`\\`\\`\n\n- **timestamp**: ISO 8601 local time with timezone (\\`2026-01-05T15:30Z\\`)\n- **directive**: \\`create\\` or \\`update\\`\n- **entity**: \\`journal\\`, \\`opinion\\`, \\`reference\\`, or \\`lore\\`\n- **^link-id**: Optional explicit ID for cross-referencing\n- **#tag**: Optional categorization tags\n\n## Metadata\n\nMetadata fields are indented key-value pairs. See \\`entities.thalo\\` for required/optional\nfields per entity. Values can be:\n\n- Strings: \\`author: \"Jane Doe\"\\` or unquoted \\`author: Jane Doe\\`\n- Links: \\`subject: ^self\\` or \\`related: ^my-other-entry\\`\n- Dates: \\`published: 2023-03-16\\`\n- Date ranges: \\`date: 2020 ~ 2021\\`\n\n## Sections\n\nContent sections start with \\`# SectionName\\` (indented). **All content must be within a section.**\nEach entity type defines which sections are required/optional in \\`entities.thalo\\`.\n\n## Example\n\n\\`\\`\\`thalo\n2026-01-05T16:00Z create opinion \"TypeScript enums should be avoided\" ^opinion-ts-enums #typescript\n  confidence: \"high\"\n\n  # Claim\n  TypeScript enums should be replaced with \\`as const\\` objects.\n\n  # Reasoning\n  - Enums generate runtime code\n  - \\`as const\\` provides the same type safety with zero overhead\n\n\\`\\`\\`\n\n## Tips\n\n- Run \\`date -u +\"%Y-%m-%dT%H:%MZ\"\\` to get the current timestamp\n- Use \\`thalo check\\` to validate entries against schemas\n`;\n\nconst PERSONAL_BIO_MD = `\\`\\`\\`thalo\n{{TIMESTAMP}} define-synthesis \"Personal Bio\" ^bio-synthesis #profile\n  sources: lore where subject = ^self\n\n  # Prompt\n  Write a narrative bio from the collected facts and insights.\n  Keep it professional but personable.\n\\`\\`\\`\n\n# Personal Bio\n`;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Init Action\n// ─────────────────────────────────────────────────────────────────────────────\n\nfunction initAction(ctx: CommandContext): void {\n  const { options, args } = ctx;\n\n  // Determine target directory\n  const targetDir = args.length > 0 ? path.resolve(args[0]) : process.cwd();\n\n  // Get current timestamp for entity definitions\n  const now = new Date();\n  const timestamp = now.toISOString().slice(0, 16) + \"Z\"; // YYYY-MM-DDTHH:MMZ\n\n  const dryRun = options[\"dry-run\"] as boolean;\n  const force = options[\"force\"] as boolean;\n\n  if (dryRun) {\n    console.log(pc.dim(\"Dry run mode - no files will be created\"));\n    console.log();\n  }\n\n  console.log(pc.bold(\"Initializing THALO...\"));\n  console.log();\n\n  const files = [\n    { path: \"entities.thalo\", content: ENTITIES_THALO.replace(/\\{\\{TIMESTAMP\\}\\}/g, timestamp) },\n    { path: \"AGENTS.md\", content: AGENTS_MD },\n    { path: \"personal-bio.md\", content: PERSONAL_BIO_MD.replace(/\\{\\{TIMESTAMP\\}\\}/g, timestamp) },\n  ];\n\n  let createdCount = 0;\n  let warningCount = 0;\n\n  for (const file of files) {\n    const fullPath = path.join(targetDir, file.path);\n    const exists = fs.existsSync(fullPath);\n\n    if (exists && !force) {\n      console.log(\n        `${pc.yellow(\"⚠\")} ${pc.yellow(\"warning:\")} ${file.path} already exists, skipping`,\n      );\n      warningCount++;\n      continue;\n    }\n\n    if (exists && force) {\n      console.log(`${pc.yellow(\"⚠\")} ${pc.yellow(\"overwriting:\")} ${file.path}`);\n    }\n\n    if (!dryRun) {\n      fs.writeFileSync(fullPath, file.content, \"utf-8\");\n    }\n\n    console.log(`${pc.green(\"✓\")} Created: ${pc.dim(file.path)}`);\n    createdCount++;\n  }\n\n  // Summary\n  console.log();\n  if (warningCount > 0) {\n    console.log(`${pc.yellow(\"Warnings:\")} ${warningCount} file(s) already exist`);\n  }\n\n  if (dryRun) {\n    console.log(pc.dim(\"Run without --dry-run to create files.\"));\n  } else if (createdCount > 0) {\n    console.log(`${pc.green(\"✓\")} Done! Created ${createdCount} file(s).`);\n  }\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Command Definition\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport const initCommand: CommandDef = {\n  name: \"init\",\n  description: \"Initialize THALO with entity definitions and documentation\",\n  args: {\n    name: \"directory\",\n    description: \"Target directory (defaults to current directory)\",\n    required: false,\n    multiple: false,\n  },\n  options: {\n    \"dry-run\": {\n      type: \"boolean\",\n      short: \"n\",\n      description: \"Show what would be created without making changes\",\n      default: false,\n    },\n    force: {\n      type: \"boolean\",\n      short: \"f\",\n      description: \"Overwrite existing files\",\n      default: false,\n    },\n  },\n  action: initAction,\n};\n"],"mappings":";;;;;AASA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CvB,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0DlB,MAAM,kBAAkB;;;;;;;;;;;AAgBxB,SAAS,WAAW,KAA2B;CAC7C,MAAM,EAAE,SAAS,SAAS;CAG1B,MAAM,YAAY,KAAK,SAAS,IAAI,KAAK,QAAQ,KAAK,GAAG,GAAG,QAAQ,KAAK;CAIzE,MAAM,6BADM,IAAI,MAAM,EACA,aAAa,CAAC,MAAM,GAAG,GAAG,GAAG;CAEnD,MAAM,SAAS,QAAQ;CACvB,MAAM,QAAQ,QAAQ;AAEtB,KAAI,QAAQ;AACV,UAAQ,IAAI,GAAG,IAAI,0CAA0C,CAAC;AAC9D,UAAQ,KAAK;;AAGf,SAAQ,IAAI,GAAG,KAAK,wBAAwB,CAAC;AAC7C,SAAQ,KAAK;CAEb,MAAM,QAAQ;EACZ;GAAE,MAAM;GAAkB,SAAS,eAAe,QAAQ,sBAAsB,UAAU;GAAE;EAC5F;GAAE,MAAM;GAAa,SAAS;GAAW;EACzC;GAAE,MAAM;GAAmB,SAAS,gBAAgB,QAAQ,sBAAsB,UAAU;GAAE;EAC/F;CAED,IAAI,eAAe;CACnB,IAAI,eAAe;AAEnB,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,WAAW,KAAK,KAAK,WAAW,KAAK,KAAK;EAChD,MAAM,SAAS,GAAG,WAAW,SAAS;AAEtC,MAAI,UAAU,CAAC,OAAO;AACpB,WAAQ,IACN,GAAG,GAAG,OAAO,IAAI,CAAC,GAAG,GAAG,OAAO,WAAW,CAAC,GAAG,KAAK,KAAK,2BACzD;AACD;AACA;;AAGF,MAAI,UAAU,MACZ,SAAQ,IAAI,GAAG,GAAG,OAAO,IAAI,CAAC,GAAG,GAAG,OAAO,eAAe,CAAC,GAAG,KAAK,OAAO;AAG5E,MAAI,CAAC,OACH,IAAG,cAAc,UAAU,KAAK,SAAS,QAAQ;AAGnD,UAAQ,IAAI,GAAG,GAAG,MAAM,IAAI,CAAC,YAAY,GAAG,IAAI,KAAK,KAAK,GAAG;AAC7D;;AAIF,SAAQ,KAAK;AACb,KAAI,eAAe,EACjB,SAAQ,IAAI,GAAG,GAAG,OAAO,YAAY,CAAC,GAAG,aAAa,wBAAwB;AAGhF,KAAI,OACF,SAAQ,IAAI,GAAG,IAAI,yCAAyC,CAAC;UACpD,eAAe,EACxB,SAAQ,IAAI,GAAG,GAAG,MAAM,IAAI,CAAC,iBAAiB,aAAa,WAAW;;AAQ1E,MAAaA,cAA0B;CACrC,MAAM;CACN,aAAa;CACb,MAAM;EACJ,MAAM;EACN,aAAa;EACb,UAAU;EACV,UAAU;EACX;CACD,SAAS;EACP,WAAW;GACT,MAAM;GACN,OAAO;GACP,aAAa;GACb,SAAS;GACV;EACD,OAAO;GACL,MAAM;GACN,OAAO;GACP,aAAa;GACb,SAAS;GACV;EACF;CACD,QAAQ;CACT"}

package/dist/commands/lsp.js

@@ -0,0 +1,26 @@
+import { ProposedFeatures, createConnection } from "vscode-languageserver/node.js";
+import { startServer } from "@rejot-dev/thalo-lsp";
+
+//#region src/commands/lsp.ts
+/**
+* LSP command - starts the Language Server Protocol server
+*
+* This is used by editors (VS Code, etc.) to provide language features.
+* Communication happens over stdio.
+*/
+const lspCommand = {
+	name: "lsp",
+	description: "Start the Language Server Protocol server (for editor integration)",
+	options: { stdio: {
+		type: "boolean",
+		description: "Use stdio transport (default, accepted for compatibility)",
+		default: false
+	} },
+	action: () => {
+		startServer(createConnection(ProposedFeatures.all, process.stdin, process.stdout));
+	}
+};
+
+//#endregion
+export { lspCommand };
+//# sourceMappingURL=lsp.js.map

package/dist/commands/lsp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp.js","names":["lspCommand: CommandDef","createLspConnection"],"sources":["../../src/commands/lsp.ts"],"sourcesContent":["import {\n  createConnection as createLspConnection,\n  ProposedFeatures,\n} from \"vscode-languageserver/node.js\";\nimport { startServer } from \"@rejot-dev/thalo-lsp\";\nimport type { CommandDef } from \"../cli.js\";\n\n/**\n * LSP command - starts the Language Server Protocol server\n *\n * This is used by editors (VS Code, etc.) to provide language features.\n * Communication happens over stdio.\n */\nexport const lspCommand: CommandDef = {\n  name: \"lsp\",\n  description: \"Start the Language Server Protocol server (for editor integration)\",\n  options: {\n    stdio: {\n      type: \"boolean\",\n      description: \"Use stdio transport (default, accepted for compatibility)\",\n      default: false,\n    },\n  },\n  action: () => {\n    // Create connection explicitly with stdio streams\n    // Note: --stdio is accepted for compatibility with vscode-languageclient but is always the default\n    const connection = createLspConnection(ProposedFeatures.all, process.stdin, process.stdout);\n    startServer(connection);\n  },\n};\n"],"mappings":";;;;;;;;;;AAaA,MAAaA,aAAyB;CACpC,MAAM;CACN,aAAa;CACb,SAAS,EACP,OAAO;EACL,MAAM;EACN,aAAa;EACb,SAAS;EACV,EACF;CACD,cAAc;AAIZ,cADmBC,iBAAoB,iBAAiB,KAAK,QAAQ,OAAO,QAAQ,OAAO,CACpE;;CAE1B"}

package/dist/commands/merge-driver.js

@@ -0,0 +1,99 @@
+import pc from "picocolors";
+import { mergeThaloFiles } from "@rejot-dev/thalo";
+import * as fs from "node:fs";
+
+//#region src/commands/merge-driver.ts
+/**
+* Git merge driver command
+*
+* Called by Git with: thalo merge-driver %O %A %B %P
+* - %O = base file (common ancestor)
+* - %A = ours file (current/local version) - MODIFIED IN PLACE
+* - %B = theirs file (incoming version)
+* - %P = path in repository (for display)
+*
+* Exit codes:
+* - 0: Clean merge (no conflicts)
+* - 1: Conflicts detected
+* - 2: Fatal error (file read/write failure)
+*/
+async function mergeDriverAction(ctx) {
+	const { args, options } = ctx;
+	if (args.length < 3) {
+		console.error(pc.red("Error: merge-driver requires 3 file arguments"));
+		console.error("Usage: thalo merge-driver <base> <ours> <theirs> [<path>]");
+		process.exit(2);
+	}
+	const [basePath, oursPath, theirsPath] = args;
+	const repoPath = args[3] || oursPath;
+	let base, ours, theirs;
+	try {
+		[base, ours, theirs] = await Promise.all([
+			fs.promises.readFile(basePath, "utf-8"),
+			fs.promises.readFile(oursPath, "utf-8"),
+			fs.promises.readFile(theirsPath, "utf-8")
+		]);
+	} catch (err) {
+		const message = err instanceof Error ? err.message : String(err);
+		console.error(pc.red(`Error reading files: ${message}`));
+		process.exit(2);
+	}
+	const showBase = options["diff3"];
+	const result = mergeThaloFiles(base, ours, theirs, {
+		showBase,
+		markerStyle: showBase ? "diff3" : "git"
+	});
+	try {
+		await fs.promises.writeFile(oursPath, result.content, "utf-8");
+	} catch (err) {
+		const message = err instanceof Error ? err.message : String(err);
+		console.error(pc.red(`Error writing merged file: ${message}`));
+		process.exit(2);
+	}
+	if (!options["quiet"]) if (result.success) {
+		console.log(pc.green(`✓ Auto-merged ${repoPath}`));
+		console.log(pc.dim(`  ${result.stats.totalEntries} entries, ${result.stats.autoMerged} auto-merged`));
+	} else {
+		console.log(pc.yellow(`⚠ Conflicts in ${repoPath}`));
+		console.log(pc.dim(`  ${result.conflicts.length} conflict(s) to resolve`));
+		if (options["verbose"]) {
+			console.log();
+			for (const conflict of result.conflicts) console.log(`  ${pc.yellow("•")} ${conflict.message}`);
+		}
+	}
+	process.exit(result.success ? 0 : 1);
+}
+const mergeDriverCommand = {
+	name: "merge-driver",
+	description: "Git merge driver for thalo files (internal use)",
+	args: {
+		name: "files",
+		description: "Base, ours, theirs, and optional path",
+		required: true,
+		multiple: true
+	},
+	options: {
+		quiet: {
+			type: "boolean",
+			short: "q",
+			description: "Suppress output",
+			default: false
+		},
+		verbose: {
+			type: "boolean",
+			short: "v",
+			description: "Show detailed conflict information",
+			default: false
+		},
+		diff3: {
+			type: "boolean",
+			description: "Use diff3 conflict style (show base)",
+			default: false
+		}
+	},
+	action: mergeDriverAction
+};
+
+//#endregion
+export { mergeDriverCommand };
+//# sourceMappingURL=merge-driver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"merge-driver.js","names":["base: string","ours: string","theirs: string","mergeDriverCommand: CommandDef"],"sources":["../../src/commands/merge-driver.ts"],"sourcesContent":["import * as fs from \"node:fs\";\nimport { mergeThaloFiles } from \"@rejot-dev/thalo\";\nimport type { CommandDef, CommandContext } from \"../cli.js\";\nimport pc from \"picocolors\";\n\n/**\n * Git merge driver command\n *\n * Called by Git with: thalo merge-driver %O %A %B %P\n * - %O = base file (common ancestor)\n * - %A = ours file (current/local version) - MODIFIED IN PLACE\n * - %B = theirs file (incoming version)\n * - %P = path in repository (for display)\n *\n * Exit codes:\n * - 0: Clean merge (no conflicts)\n * - 1: Conflicts detected\n * - 2: Fatal error (file read/write failure)\n */\nasync function mergeDriverAction(ctx: CommandContext): Promise<void> {\n  const { args, options } = ctx;\n\n  if (args.length < 3) {\n    console.error(pc.red(\"Error: merge-driver requires 3 file arguments\"));\n    console.error(\"Usage: thalo merge-driver <base> <ours> <theirs> [<path>]\");\n    process.exit(2);\n  }\n\n  const [basePath, oursPath, theirsPath] = args;\n  const repoPath = args[3] || oursPath;\n\n  let base: string, ours: string, theirs: string;\n  try {\n    [base, ours, theirs] = await Promise.all([\n      fs.promises.readFile(basePath, \"utf-8\"),\n      fs.promises.readFile(oursPath, \"utf-8\"),\n      fs.promises.readFile(theirsPath, \"utf-8\"),\n    ]);\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    console.error(pc.red(`Error reading files: ${message}`));\n    process.exit(2);\n  }\n\n  const showBase = options[\"diff3\"] as boolean;\n  const result = mergeThaloFiles(base, ours, theirs, {\n    showBase,\n    markerStyle: showBase ? \"diff3\" : \"git\",\n  });\n\n  try {\n    await fs.promises.writeFile(oursPath, result.content, \"utf-8\");\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    console.error(pc.red(`Error writing merged file: ${message}`));\n    process.exit(2);\n  }\n\n  if (!options[\"quiet\"]) {\n    if (result.success) {\n      console.log(pc.green(`✓ Auto-merged ${repoPath}`));\n      console.log(\n        pc.dim(`  ${result.stats.totalEntries} entries, ${result.stats.autoMerged} auto-merged`),\n      );\n    } else {\n      console.log(pc.yellow(`⚠ Conflicts in ${repoPath}`));\n      console.log(pc.dim(`  ${result.conflicts.length} conflict(s) to resolve`));\n\n      if (options[\"verbose\"]) {\n        console.log();\n        for (const conflict of result.conflicts) {\n          console.log(`  ${pc.yellow(\"•\")} ${conflict.message}`);\n        }\n      }\n    }\n  }\n\n  process.exit(result.success ? 0 : 1);\n}\n\nexport const mergeDriverCommand: CommandDef = {\n  name: \"merge-driver\",\n  description: \"Git merge driver for thalo files (internal use)\",\n  args: {\n    name: \"files\",\n    description: \"Base, ours, theirs, and optional path\",\n    required: true,\n    multiple: true,\n  },\n  options: {\n    quiet: {\n      type: \"boolean\",\n      short: \"q\",\n      description: \"Suppress output\",\n      default: false,\n    },\n    verbose: {\n      type: \"boolean\",\n      short: \"v\",\n      description: \"Show detailed conflict information\",\n      default: false,\n    },\n    diff3: {\n      type: \"boolean\",\n      description: \"Use diff3 conflict style (show base)\",\n      default: false,\n    },\n  },\n  action: mergeDriverAction,\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,eAAe,kBAAkB,KAAoC;CACnE,MAAM,EAAE,MAAM,YAAY;AAE1B,KAAI,KAAK,SAAS,GAAG;AACnB,UAAQ,MAAM,GAAG,IAAI,gDAAgD,CAAC;AACtE,UAAQ,MAAM,4DAA4D;AAC1E,UAAQ,KAAK,EAAE;;CAGjB,MAAM,CAAC,UAAU,UAAU,cAAc;CACzC,MAAM,WAAW,KAAK,MAAM;CAE5B,IAAIA,MAAcC,MAAcC;AAChC,KAAI;AACF,GAAC,MAAM,MAAM,UAAU,MAAM,QAAQ,IAAI;GACvC,GAAG,SAAS,SAAS,UAAU,QAAQ;GACvC,GAAG,SAAS,SAAS,UAAU,QAAQ;GACvC,GAAG,SAAS,SAAS,YAAY,QAAQ;GAC1C,CAAC;UACK,KAAK;EACZ,MAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAChE,UAAQ,MAAM,GAAG,IAAI,wBAAwB,UAAU,CAAC;AACxD,UAAQ,KAAK,EAAE;;CAGjB,MAAM,WAAW,QAAQ;CACzB,MAAM,SAAS,gBAAgB,MAAM,MAAM,QAAQ;EACjD;EACA,aAAa,WAAW,UAAU;EACnC,CAAC;AAEF,KAAI;AACF,QAAM,GAAG,SAAS,UAAU,UAAU,OAAO,SAAS,QAAQ;UACvD,KAAK;EACZ,MAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAChE,UAAQ,MAAM,GAAG,IAAI,8BAA8B,UAAU,CAAC;AAC9D,UAAQ,KAAK,EAAE;;AAGjB,KAAI,CAAC,QAAQ,SACX,KAAI,OAAO,SAAS;AAClB,UAAQ,IAAI,GAAG,MAAM,iBAAiB,WAAW,CAAC;AAClD,UAAQ,IACN,GAAG,IAAI,KAAK,OAAO,MAAM,aAAa,YAAY,OAAO,MAAM,WAAW,cAAc,CACzF;QACI;AACL,UAAQ,IAAI,GAAG,OAAO,kBAAkB,WAAW,CAAC;AACpD,UAAQ,IAAI,GAAG,IAAI,KAAK,OAAO,UAAU,OAAO,yBAAyB,CAAC;AAE1E,MAAI,QAAQ,YAAY;AACtB,WAAQ,KAAK;AACb,QAAK,MAAM,YAAY,OAAO,UAC5B,SAAQ,IAAI,KAAK,GAAG,OAAO,IAAI,CAAC,GAAG,SAAS,UAAU;;;AAM9D,SAAQ,KAAK,OAAO,UAAU,IAAI,EAAE;;AAGtC,MAAaC,qBAAiC;CAC5C,MAAM;CACN,aAAa;CACb,MAAM;EACJ,MAAM;EACN,aAAa;EACb,UAAU;EACV,UAAU;EACX;CACD,SAAS;EACP,OAAO;GACL,MAAM;GACN,OAAO;GACP,aAAa;GACb,SAAS;GACV;EACD,SAAS;GACP,MAAM;GACN,OAAO;GACP,aAAa;GACb,SAAS;GACV;EACD,OAAO;GACL,MAAM;GACN,aAAa;GACb,SAAS;GACV;EACF;CACD,QAAQ;CACT"}

package/dist/commands/query.js

@@ -0,0 +1,162 @@
+import { loadWorkspace, relativePath, resolveFiles } from "../files.js";
+import pc from "picocolors";
+import { formatQueryResultRaw, isCheckpointError, isQueryValidationError, parseCheckpoint, runQuery } from "@rejot-dev/thalo";
+import { NotInGitRepoError, createChangeTracker } from "@rejot-dev/thalo/change-tracker/node";
+
+//#region src/commands/query.ts
+/**
+* Format entry with colors for default display
+*/
+function formatEntryDefault(entry) {
+	const lines = [];
+	const tags = entry.tags.map((t) => `#${t}`).join(" ");
+	lines.push(`${pc.dim(entry.timestamp)} ${pc.cyan(entry.entity)} ${pc.bold(entry.title)}${entry.linkId ? " " + pc.green(`^${entry.linkId}`) : ""}${tags ? " " + pc.yellow(tags) : ""}`);
+	lines.push(`  ${pc.dim(`${relativePath(entry.file)}:${entry.startLine}-${entry.endLine}`)}`);
+	return lines.join("\n");
+}
+/**
+* Format entry for JSON output
+*/
+function formatEntryJson(entry) {
+	return {
+		file: relativePath(entry.file),
+		timestamp: entry.timestamp,
+		entity: entry.entity,
+		title: entry.title,
+		tags: entry.tags,
+		link: entry.linkId,
+		location: {
+			startLine: entry.startLine,
+			endLine: entry.endLine
+		}
+	};
+}
+async function queryAction(ctx) {
+	const { options, args } = ctx;
+	const queryStr = args[0];
+	if (!queryStr) {
+		console.error(pc.red("Error: Query string is required"));
+		console.error(`\nUsage: thalo query "<query>"`);
+		console.error(`\nExamples:`);
+		console.error(`  thalo query 'lore'`);
+		console.error(`  thalo query 'lore where #career'`);
+		console.error(`  thalo query 'opinion where subject = "topic"'`);
+		process.exit(2);
+	}
+	const format = options["json"] ? "json" : options["format"] || "default";
+	if (format === "json") process.env["NO_COLOR"] = "1";
+	const limitStr = options["limit"];
+	const limit = limitStr ? parseInt(limitStr, 10) : void 0;
+	const since = options["since"];
+	const targetPaths = args.slice(1);
+	const files = await resolveFiles(targetPaths.length > 0 ? targetPaths : ["."]);
+	if (files.length === 0) {
+		console.log("No .thalo or .md files found.");
+		process.exit(0);
+	}
+	const workspace = await loadWorkspace(files);
+	let tracker;
+	if (since) {
+		if (parseCheckpoint(since)?.type === "git") try {
+			tracker = await createChangeTracker({ cwd: process.cwd() });
+		} catch (err) {
+			if (err instanceof NotInGitRepoError) {
+				console.error(pc.red(`Error: Cannot use git checkpoint "${since}" - not in a git repository`));
+				console.error(pc.dim(`Directory: ${err.cwd}`));
+			} else {
+				const message = err instanceof Error ? err.message : String(err);
+				console.error(pc.red(`Error: Failed to create git tracker for checkpoint "${since}"`));
+				console.error(pc.dim(message));
+			}
+			process.exit(2);
+		}
+	}
+	const result = await runQuery(workspace, queryStr, {
+		limit,
+		includeRawText: format === "raw",
+		since,
+		tracker
+	});
+	if (!result) {
+		console.error(pc.red(`Error: Invalid query syntax`));
+		console.error(pc.dim(`Query: ${queryStr}`));
+		process.exit(2);
+	}
+	if (isQueryValidationError(result)) {
+		console.error(pc.red(`Error: ${result.message}`));
+		process.exit(2);
+	}
+	if (isCheckpointError(result)) {
+		console.error(pc.red(`Error: ${result.message}`));
+		process.exit(2);
+	}
+	if (format === "json") {
+		console.log(JSON.stringify({
+			query: result.queryString,
+			count: result.totalCount,
+			results: result.entries.map(formatEntryJson)
+		}, null, 2));
+		return;
+	}
+	if (format === "raw") {
+		const lines = formatQueryResultRaw(result);
+		for (const line of lines) console.log(line);
+		return;
+	}
+	console.log();
+	console.log(`Query: ${pc.cyan(result.queryString)}`);
+	console.log(`Found: ${pc.bold(String(result.totalCount))} entries`);
+	if (result.entries.length > 0) {
+		console.log();
+		for (const entry of result.entries) console.log(formatEntryDefault(entry));
+	}
+	if (limit && result.totalCount > limit) {
+		console.log();
+		console.log(pc.dim(`(showing ${limit} of ${result.totalCount} results)`));
+	}
+	console.log();
+}
+const queryCommand = {
+	name: "query",
+	description: "Query entries by entity type, tags, links, or metadata",
+	usage: "\"<query>\" [paths...]",
+	args: {
+		name: "query",
+		description: "Query string (e.g., 'lore where #career', 'opinion where subject = \"topic\"')",
+		required: true,
+		multiple: true
+	},
+	options: {
+		format: {
+			type: "string",
+			short: "f",
+			description: "Output format",
+			choices: [
+				"default",
+				"json",
+				"raw"
+			],
+			default: "default"
+		},
+		json: {
+			type: "boolean",
+			description: "Output as JSON (shorthand for --format json)",
+			default: false
+		},
+		limit: {
+			type: "string",
+			short: "n",
+			description: "Maximum number of results to show"
+		},
+		since: {
+			type: "string",
+			short: "s",
+			description: "Only show entries since checkpoint (ts:2026-01-10T15:00Z or git:abc123)"
+		}
+	},
+	action: queryAction
+};
+
+//#endregion
+export { queryCommand };
+//# sourceMappingURL=query.js.map

package/dist/commands/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":["lines: string[]","queryCommand: CommandDef"],"sources":["../../src/commands/query.ts"],"sourcesContent":["import {\n  runQuery,\n  formatQueryResultRaw,\n  isQueryValidationError,\n  isCheckpointError,\n  type QueryEntryInfo,\n} from \"@rejot-dev/thalo\";\nimport { createChangeTracker, NotInGitRepoError } from \"@rejot-dev/thalo/change-tracker/node\";\nimport { parseCheckpoint } from \"@rejot-dev/thalo\";\nimport pc from \"picocolors\";\nimport type { CommandDef, CommandContext } from \"../cli.js\";\nimport { resolveFiles, loadWorkspace, relativePath } from \"../files.js\";\n\ntype OutputFormat = \"default\" | \"json\" | \"raw\";\n\n/**\n * Format entry with colors for default display\n */\nfunction formatEntryDefault(entry: QueryEntryInfo): string {\n  const lines: string[] = [];\n  const tags = entry.tags.map((t) => `#${t}`).join(\" \");\n\n  lines.push(\n    `${pc.dim(entry.timestamp)} ${pc.cyan(entry.entity)} ${pc.bold(entry.title)}${entry.linkId ? \" \" + pc.green(`^${entry.linkId}`) : \"\"}${tags ? \" \" + pc.yellow(tags) : \"\"}`,\n  );\n  lines.push(`  ${pc.dim(`${relativePath(entry.file)}:${entry.startLine}-${entry.endLine}`)}`);\n\n  return lines.join(\"\\n\");\n}\n\n/**\n * Format entry for JSON output\n */\nfunction formatEntryJson(entry: QueryEntryInfo): object {\n  return {\n    file: relativePath(entry.file),\n    timestamp: entry.timestamp,\n    entity: entry.entity,\n    title: entry.title,\n    tags: entry.tags,\n    link: entry.linkId,\n    location: {\n      startLine: entry.startLine,\n      endLine: entry.endLine,\n    },\n  };\n}\n\nasync function queryAction(ctx: CommandContext): Promise<void> {\n  const { options, args } = ctx;\n\n  // Get query string\n  const queryStr = args[0];\n  if (!queryStr) {\n    console.error(pc.red(\"Error: Query string is required\"));\n    console.error(`\\nUsage: thalo query \"<query>\"`);\n    console.error(`\\nExamples:`);\n    console.error(`  thalo query 'lore'`);\n    console.error(`  thalo query 'lore where #career'`);\n    console.error(`  thalo query 'opinion where subject = \"topic\"'`);\n    process.exit(2);\n  }\n\n  // Handle format - --json flag overrides --format option\n  const jsonFlag = options[\"json\"] as boolean;\n  const format = jsonFlag ? \"json\" : (options[\"format\"] as OutputFormat) || \"default\";\n  if (format === \"json\") {\n    process.env[\"NO_COLOR\"] = \"1\";\n  }\n\n  // Handle limit\n  const limitStr = options[\"limit\"] as string | undefined;\n  const limit = limitStr ? parseInt(limitStr, 10) : undefined;\n\n  // Handle since checkpoint\n  const since = options[\"since\"] as string | undefined;\n\n  // Determine target paths\n  const targetPaths = args.slice(1);\n  const searchPaths = targetPaths.length > 0 ? targetPaths : [\".\"];\n\n  // Collect and load files\n  const files = await resolveFiles(searchPaths);\n  if (files.length === 0) {\n    console.log(\"No .thalo or .md files found.\");\n    process.exit(0);\n  }\n\n  const workspace = await loadWorkspace(files);\n\n  // Create tracker if git checkpoint is used\n  let tracker;\n  if (since) {\n    const marker = parseCheckpoint(since);\n    if (marker?.type === \"git\") {\n      try {\n        tracker = await createChangeTracker({ cwd: process.cwd() });\n      } catch (err) {\n        if (err instanceof NotInGitRepoError) {\n          console.error(\n            pc.red(`Error: Cannot use git checkpoint \"${since}\" - not in a git repository`),\n          );\n          console.error(pc.dim(`Directory: ${err.cwd}`));\n        } else {\n          const message = err instanceof Error ? err.message : String(err);\n          console.error(pc.red(`Error: Failed to create git tracker for checkpoint \"${since}\"`));\n          console.error(pc.dim(message));\n        }\n        process.exit(2);\n      }\n    }\n  }\n\n  // Execute query using shared command\n  const result = await runQuery(workspace, queryStr, {\n    limit,\n    includeRawText: format === \"raw\",\n    since,\n    tracker,\n  });\n\n  if (!result) {\n    console.error(pc.red(`Error: Invalid query syntax`));\n    console.error(pc.dim(`Query: ${queryStr}`));\n    process.exit(2);\n  }\n\n  // Handle validation errors\n  if (isQueryValidationError(result)) {\n    console.error(pc.red(`Error: ${result.message}`));\n    process.exit(2);\n  }\n\n  // Handle checkpoint errors\n  if (isCheckpointError(result)) {\n    console.error(pc.red(`Error: ${result.message}`));\n    process.exit(2);\n  }\n\n  // Output results\n  if (format === \"json\") {\n    console.log(\n      JSON.stringify(\n        {\n          query: result.queryString,\n          count: result.totalCount,\n          results: result.entries.map(formatEntryJson),\n        },\n        null,\n        2,\n      ),\n    );\n    return;\n  }\n\n  if (format === \"raw\") {\n    // Output raw entry text using shared formatter\n    const lines = formatQueryResultRaw(result);\n    for (const line of lines) {\n      console.log(line);\n    }\n    return;\n  }\n\n  // Default format with colors\n  console.log();\n  console.log(`Query: ${pc.cyan(result.queryString)}`);\n  console.log(`Found: ${pc.bold(String(result.totalCount))} entries`);\n\n  if (result.entries.length > 0) {\n    console.log();\n    for (const entry of result.entries) {\n      console.log(formatEntryDefault(entry));\n    }\n  }\n\n  if (limit && result.totalCount > limit) {\n    console.log();\n    console.log(pc.dim(`(showing ${limit} of ${result.totalCount} results)`));\n  }\n\n  console.log();\n}\n\nexport const queryCommand: CommandDef = {\n  name: \"query\",\n  description: \"Query entries by entity type, tags, links, or metadata\",\n  usage: '\"<query>\" [paths...]',\n  args: {\n    name: \"query\",\n    description: \"Query string (e.g., 'lore where #career', 'opinion where subject = \\\"topic\\\"')\",\n    required: true,\n    multiple: true,\n  },\n  options: {\n    format: {\n      type: \"string\",\n      short: \"f\",\n      description: \"Output format\",\n      choices: [\"default\", \"json\", \"raw\"],\n      default: \"default\",\n    },\n    json: {\n      type: \"boolean\",\n      description: \"Output as JSON (shorthand for --format json)\",\n      default: false,\n    },\n    limit: {\n      type: \"string\",\n      short: \"n\",\n      description: \"Maximum number of results to show\",\n    },\n    since: {\n      type: \"string\",\n      short: \"s\",\n      description: \"Only show entries since checkpoint (ts:2026-01-10T15:00Z or git:abc123)\",\n    },\n  },\n  action: queryAction,\n};\n"],"mappings":"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"}

package/dist/commands/rules.js

@@ -0,0 +1,104 @@
+import pc from "picocolors";
+import { RULE_CATEGORIES, allRules } from "@rejot-dev/thalo";
+
+//#region src/commands/rules.ts
+const severityColor = {
+	error: pc.red,
+	warning: pc.yellow,
+	info: pc.cyan
+};
+/**
+* Group rules by category and sort them
+*/
+function groupRulesByCategory(rules) {
+	const grouped = /* @__PURE__ */ new Map();
+	const sortedCategories = Object.keys(RULE_CATEGORIES).sort((a, b) => RULE_CATEGORIES[a].order - RULE_CATEGORIES[b].order);
+	for (const cat of sortedCategories) grouped.set(cat, []);
+	for (const rule of rules) {
+		const existing = grouped.get(rule.category) ?? [];
+		existing.push(rule);
+		grouped.set(rule.category, existing);
+	}
+	for (const [cat, catRules] of grouped) grouped.set(cat, catRules.sort((a, b) => a.code.localeCompare(b.code)));
+	return grouped;
+}
+function listAction(ctx) {
+	const { options } = ctx;
+	let filteredRules = allRules;
+	if (options["severity"]) filteredRules = allRules.filter((r) => r.defaultSeverity === options["severity"]);
+	if (options["category"]) filteredRules = filteredRules.filter((r) => r.category === options["category"]);
+	if (options["json"]) {
+		const output = filteredRules.map((r) => ({
+			code: r.code,
+			name: r.name,
+			description: r.description,
+			category: r.category,
+			defaultSeverity: r.defaultSeverity
+		}));
+		console.log(JSON.stringify(output, null, 2));
+		return;
+	}
+	console.log();
+	console.log(pc.bold("Available Rules"));
+	const maxCodeLen = Math.max(...filteredRules.map((r) => r.code.length));
+	const grouped = groupRulesByCategory(filteredRules);
+	for (const [category, rules] of grouped) {
+		if (rules.length === 0) continue;
+		const { label } = RULE_CATEGORIES[category];
+		console.log();
+		console.log(pc.cyan(pc.bold(`  ${label}`)));
+		console.log();
+		for (const rule of rules) {
+			const color = severityColor[rule.defaultSeverity] ?? pc.dim;
+			const code = rule.code.padEnd(maxCodeLen);
+			const severity = color(rule.defaultSeverity.padEnd(7));
+			console.log(`    ${pc.bold(code)}  ${severity}  ${pc.dim(rule.description)}`);
+		}
+	}
+	console.log();
+	console.log(pc.dim(`Total: ${filteredRules.length} rules`));
+	console.log();
+}
+const listSubcommand = {
+	name: "list",
+	description: "List all available rules",
+	options: {
+		severity: {
+			type: "string",
+			short: "s",
+			description: "Filter by severity level",
+			choices: [
+				"error",
+				"warning",
+				"info"
+			]
+		},
+		category: {
+			type: "string",
+			short: "c",
+			description: "Filter by category",
+			choices: [
+				"instance",
+				"link",
+				"schema",
+				"metadata",
+				"content"
+			]
+		},
+		json: {
+			type: "boolean",
+			description: "Output as JSON",
+			default: false
+		}
+	},
+	action: listAction
+};
+const rulesCommand = {
+	name: "rules",
+	description: "Manage and inspect linting rules",
+	subcommands: { list: listSubcommand }
+};
+
+//#endregion
+export { rulesCommand };
+//# sourceMappingURL=rules.js.map

package/dist/commands/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","names":["listSubcommand: CommandDef","rulesCommand: CommandDef"],"sources":["../../src/commands/rules.ts"],"sourcesContent":["import { allRules, RULE_CATEGORIES, type RuleCategory, type Rule } from \"@rejot-dev/thalo\";\nimport pc from \"picocolors\";\nimport type { CommandDef, CommandContext } from \"../cli.js\";\n\ntype SeverityKey = \"error\" | \"warning\" | \"info\";\n\nconst severityColor = {\n  error: pc.red,\n  warning: pc.yellow,\n  info: pc.cyan,\n} as const;\n\n/**\n * Group rules by category and sort them\n */\nfunction groupRulesByCategory(rules: Rule[]): Map<RuleCategory, Rule[]> {\n  const grouped = new Map<RuleCategory, Rule[]>();\n\n  // Initialize groups in order\n  const sortedCategories = (Object.keys(RULE_CATEGORIES) as RuleCategory[]).sort(\n    (a, b) => RULE_CATEGORIES[a].order - RULE_CATEGORIES[b].order,\n  );\n\n  for (const cat of sortedCategories) {\n    grouped.set(cat, []);\n  }\n\n  // Group rules\n  for (const rule of rules) {\n    const existing = grouped.get(rule.category) ?? [];\n    existing.push(rule);\n    grouped.set(rule.category, existing);\n  }\n\n  // Sort rules within each category alphabetically by code\n  for (const [cat, catRules] of grouped) {\n    grouped.set(\n      cat,\n      catRules.sort((a, b) => a.code.localeCompare(b.code)),\n    );\n  }\n\n  return grouped;\n}\n\nfunction listAction(ctx: CommandContext): void {\n  const { options } = ctx;\n\n  // Filter by severity if specified\n  let filteredRules = allRules;\n  if (options[\"severity\"]) {\n    filteredRules = allRules.filter((r) => r.defaultSeverity === options[\"severity\"]);\n  }\n\n  // Filter by category if specified\n  if (options[\"category\"]) {\n    filteredRules = filteredRules.filter((r) => r.category === options[\"category\"]);\n  }\n\n  if (options[\"json\"]) {\n    const output = filteredRules.map((r) => ({\n      code: r.code,\n      name: r.name,\n      description: r.description,\n      category: r.category,\n      defaultSeverity: r.defaultSeverity,\n    }));\n    console.log(JSON.stringify(output, null, 2));\n    return;\n  }\n\n  console.log();\n  console.log(pc.bold(\"Available Rules\"));\n\n  const maxCodeLen = Math.max(...filteredRules.map((r) => r.code.length));\n  const grouped = groupRulesByCategory(filteredRules);\n\n  for (const [category, rules] of grouped) {\n    if (rules.length === 0) {\n      continue;\n    }\n\n    const { label } = RULE_CATEGORIES[category];\n    console.log();\n    console.log(pc.cyan(pc.bold(`  ${label}`)));\n    console.log();\n\n    for (const rule of rules) {\n      const color = severityColor[rule.defaultSeverity as SeverityKey] ?? pc.dim;\n      const code = rule.code.padEnd(maxCodeLen);\n      const severity = color(rule.defaultSeverity.padEnd(7));\n      console.log(`    ${pc.bold(code)}  ${severity}  ${pc.dim(rule.description)}`);\n    }\n  }\n\n  console.log();\n  console.log(pc.dim(`Total: ${filteredRules.length} rules`));\n  console.log();\n}\n\nconst listSubcommand: CommandDef = {\n  name: \"list\",\n  description: \"List all available rules\",\n  options: {\n    severity: {\n      type: \"string\",\n      short: \"s\",\n      description: \"Filter by severity level\",\n      choices: [\"error\", \"warning\", \"info\"],\n    },\n    category: {\n      type: \"string\",\n      short: \"c\",\n      description: \"Filter by category\",\n      choices: [\"instance\", \"link\", \"schema\", \"metadata\", \"content\"],\n    },\n    json: {\n      type: \"boolean\",\n      description: \"Output as JSON\",\n      default: false,\n    },\n  },\n  action: listAction,\n};\n\nexport const rulesCommand: CommandDef = {\n  name: \"rules\",\n  description: \"Manage and inspect linting rules\",\n  subcommands: {\n    list: listSubcommand,\n  },\n};\n"],"mappings":";;;;AAMA,MAAM,gBAAgB;CACpB,OAAO,GAAG;CACV,SAAS,GAAG;CACZ,MAAM,GAAG;CACV;;;;AAKD,SAAS,qBAAqB,OAA0C;CACtE,MAAM,0BAAU,IAAI,KAA2B;CAG/C,MAAM,mBAAoB,OAAO,KAAK,gBAAgB,CAAoB,MACvE,GAAG,MAAM,gBAAgB,GAAG,QAAQ,gBAAgB,GAAG,MACzD;AAED,MAAK,MAAM,OAAO,iBAChB,SAAQ,IAAI,KAAK,EAAE,CAAC;AAItB,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,WAAW,QAAQ,IAAI,KAAK,SAAS,IAAI,EAAE;AACjD,WAAS,KAAK,KAAK;AACnB,UAAQ,IAAI,KAAK,UAAU,SAAS;;AAItC,MAAK,MAAM,CAAC,KAAK,aAAa,QAC5B,SAAQ,IACN,KACA,SAAS,MAAM,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,KAAK,CAAC,CACtD;AAGH,QAAO;;AAGT,SAAS,WAAW,KAA2B;CAC7C,MAAM,EAAE,YAAY;CAGpB,IAAI,gBAAgB;AACpB,KAAI,QAAQ,YACV,iBAAgB,SAAS,QAAQ,MAAM,EAAE,oBAAoB,QAAQ,YAAY;AAInF,KAAI,QAAQ,YACV,iBAAgB,cAAc,QAAQ,MAAM,EAAE,aAAa,QAAQ,YAAY;AAGjF,KAAI,QAAQ,SAAS;EACnB,MAAM,SAAS,cAAc,KAAK,OAAO;GACvC,MAAM,EAAE;GACR,MAAM,EAAE;GACR,aAAa,EAAE;GACf,UAAU,EAAE;GACZ,iBAAiB,EAAE;GACpB,EAAE;AACH,UAAQ,IAAI,KAAK,UAAU,QAAQ,MAAM,EAAE,CAAC;AAC5C;;AAGF,SAAQ,KAAK;AACb,SAAQ,IAAI,GAAG,KAAK,kBAAkB,CAAC;CAEvC,MAAM,aAAa,KAAK,IAAI,GAAG,cAAc,KAAK,MAAM,EAAE,KAAK,OAAO,CAAC;CACvE,MAAM,UAAU,qBAAqB,cAAc;AAEnD,MAAK,MAAM,CAAC,UAAU,UAAU,SAAS;AACvC,MAAI,MAAM,WAAW,EACnB;EAGF,MAAM,EAAE,UAAU,gBAAgB;AAClC,UAAQ,KAAK;AACb,UAAQ,IAAI,GAAG,KAAK,GAAG,KAAK,KAAK,QAAQ,CAAC,CAAC;AAC3C,UAAQ,KAAK;AAEb,OAAK,MAAM,QAAQ,OAAO;GACxB,MAAM,QAAQ,cAAc,KAAK,oBAAmC,GAAG;GACvE,MAAM,OAAO,KAAK,KAAK,OAAO,WAAW;GACzC,MAAM,WAAW,MAAM,KAAK,gBAAgB,OAAO,EAAE,CAAC;AACtD,WAAQ,IAAI,OAAO,GAAG,KAAK,KAAK,CAAC,IAAI,SAAS,IAAI,GAAG,IAAI,KAAK,YAAY,GAAG;;;AAIjF,SAAQ,KAAK;AACb,SAAQ,IAAI,GAAG,IAAI,UAAU,cAAc,OAAO,QAAQ,CAAC;AAC3D,SAAQ,KAAK;;AAGf,MAAMA,iBAA6B;CACjC,MAAM;CACN,aAAa;CACb,SAAS;EACP,UAAU;GACR,MAAM;GACN,OAAO;GACP,aAAa;GACb,SAAS;IAAC;IAAS;IAAW;IAAO;GACtC;EACD,UAAU;GACR,MAAM;GACN,OAAO;GACP,aAAa;GACb,SAAS;IAAC;IAAY;IAAQ;IAAU;IAAY;IAAU;GAC/D;EACD,MAAM;GACJ,MAAM;GACN,aAAa;GACb,SAAS;GACV;EACF;CACD,QAAQ;CACT;AAED,MAAaC,eAA2B;CACtC,MAAM;CACN,aAAa;CACb,aAAa,EACX,MAAM,gBACP;CACF"}