@rejot-dev/thalo 0.0.0

package/dist/commands/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":["info: QueryEntryInfo","sinceMarker: ChangeMarker | null","parseQueryStringService","results: InstanceEntry[]","entries: QueryEntryInfo[]"],"sources":["../../src/commands/query.ts"],"sourcesContent":["/**\n * Query command - executes a query on a workspace and returns structured results.\n */\n\nimport type { Workspace } from \"../model/workspace.js\";\nimport type { Query, QueryCondition } from \"../services/query.js\";\nimport type { InstanceEntry, Timestamp } from \"../ast/ast-types.js\";\nimport {\n  parseQueryString as parseQueryStringService,\n  validateQueryEntities,\n  executeQueries,\n  formatQuery,\n} from \"../services/query.js\";\nimport { findEntryFile, getEntrySourceText } from \"../services/synthesis.js\";\nimport { formatTimestamp } from \"../formatters.js\";\nimport {\n  parseCheckpoint,\n  type ChangeMarker,\n  type ChangeTracker,\n} from \"../services/change-tracker/change-tracker.js\";\n\n/**\n * Convert a timestamp to epoch milliseconds for correct comparison across timezones\n */\nfunction timestampToEpoch(ts: Timestamp): number {\n  const isoStr = formatTimestamp(ts);\n  return Date.parse(isoStr);\n}\n\n/**\n * Parse an ISO timestamp string to epoch milliseconds\n */\nfunction parseTimestampToEpoch(isoStr: string): number {\n  return Date.parse(isoStr);\n}\n\n// Re-export parseQueryString from service for backward compatibility\nexport { parseQueryString } from \"../services/query.js\";\n\n// ===================\n// Types\n// ===================\n\n/**\n * Information about a condition in a query.\n */\nexport interface QueryConditionInfo {\n  kind: QueryCondition[\"kind\"];\n  /** For field conditions */\n  field?: string;\n  value?: string;\n  /** For tag conditions */\n  tag?: string;\n  /** For link conditions */\n  link?: string;\n}\n\n/**\n * Information about an entry that matched a query.\n */\nexport interface QueryEntryInfo {\n  /** File path containing the entry */\n  file: string;\n  /** Formatted timestamp string */\n  timestamp: string;\n  /** Entity type (e.g., \"lore\", \"opinion\") */\n  entity: string;\n  /** Entry title */\n  title: string;\n  /** Link ID if present */\n  linkId: string | null;\n  /** Tags on the entry */\n  tags: string[];\n  /** 1-based start line */\n  startLine: number;\n  /** 1-based end line */\n  endLine: number;\n  /** Raw source text of the entry (optional, for \"raw\" format) */\n  rawText?: string;\n}\n\n/**\n * Result of running the query command (single query).\n */\nexport interface QueryResult {\n  /** The parsed query */\n  query: Query;\n  /** Formatted query string for display */\n  queryString: string;\n  /** Matching entries */\n  entries: QueryEntryInfo[];\n  /** Total count (may be more than entries.length if limited) */\n  totalCount: number;\n}\n\n/**\n * Result of running queries (multiple queries).\n */\nexport interface QueriesResult {\n  /** The parsed queries */\n  queries: Query[];\n  /** Formatted query string for display */\n  queryString: string;\n  /** Matching entries (deduplicated across all queries) */\n  entries: QueryEntryInfo[];\n  /** Total count (may be more than entries.length if limited) */\n  totalCount: number;\n}\n\n/**\n * Error result when queries reference unknown entities.\n */\nexport interface QueryValidationError {\n  kind: \"unknown-entities\";\n  /** The unknown entity names */\n  entities: string[];\n  /** Human-readable error message */\n  message: string;\n}\n\n/**\n * Options for running the query command.\n */\nexport interface RunQueryOptions {\n  /** Maximum number of results to return */\n  limit?: number;\n  /** Include raw source text in results */\n  includeRawText?: boolean;\n  /** Whether to validate that queried entities exist (default: true) */\n  validateEntities?: boolean;\n  /**\n   * Only return entries since this checkpoint.\n   * Format: \"ts:2026-01-10T15:00Z\" for timestamp-based filtering.\n   * Format: \"git:abc123\" for git-based filtering (requires tracker option).\n   */\n  since?: string;\n  /**\n   * Change tracker for git-based filtering.\n   * Required when using git checkpoints (git:...).\n   */\n  tracker?: ChangeTracker;\n}\n\n/**\n * Error result when a checkpoint is invalid or missing required options.\n */\nexport interface CheckpointError {\n  kind: \"invalid-checkpoint\";\n  /** Human-readable error message */\n  message: string;\n}\n\n/**\n * Convert an InstanceEntry to QueryEntryInfo.\n */\nfunction toQueryEntryInfo(\n  entry: InstanceEntry,\n  file: string,\n  workspace: Workspace,\n  includeRawText: boolean,\n): QueryEntryInfo {\n  const info: QueryEntryInfo = {\n    file,\n    timestamp: formatTimestamp(entry.header.timestamp),\n    entity: entry.header.entity,\n    title: entry.header.title.value,\n    linkId: entry.header.link?.id ?? null,\n    tags: entry.header.tags.map((t) => t.name),\n    startLine: entry.location.startPosition.row + 1,\n    endLine: entry.location.endPosition.row + 1,\n  };\n\n  if (includeRawText) {\n    const model = workspace.getModel(file);\n    if (model) {\n      info.rawText = getEntrySourceText(entry, model.source);\n    }\n  }\n\n  return info;\n}\n\n/**\n * Run multiple queries on a workspace.\n * Supports comma-separated query syntax like \"lore, journal where #career\".\n *\n * @param workspace - The workspace to query\n * @param queryString - The query string to parse and execute (may contain multiple queries)\n * @param options - Query options\n * @returns Structured query results, validation error, checkpoint error, or null if query syntax is invalid\n */\nexport async function runQueries(\n  workspace: Workspace,\n  queryString: string,\n  options: RunQueryOptions = {},\n): Promise<QueriesResult | QueryValidationError | CheckpointError | null> {\n  const { limit, includeRawText = false, validateEntities = true, since, tracker } = options;\n\n  // Parse and validate the since checkpoint if provided\n  let sinceMarker: ChangeMarker | null = null;\n\n  if (since) {\n    sinceMarker = parseCheckpoint(since);\n    if (!sinceMarker) {\n      return {\n        kind: \"invalid-checkpoint\",\n        message: `Invalid checkpoint format: '${since}'. Use 'ts:2026-01-10T15:00Z' for timestamps or 'git:abc123' for git commits.`,\n      };\n    }\n\n    // Git checkpoints require a tracker\n    if (sinceMarker.type === \"git\" && !tracker) {\n      return {\n        kind: \"invalid-checkpoint\",\n        message: `Git checkpoints require a change tracker. Provide a tracker option or use timestamp checkpoints (ts:...).`,\n      };\n    }\n  }\n\n  // Parse the queries\n  const queries = parseQueryStringService(queryString);\n  if (!queries) {\n    return null;\n  }\n\n  // Validate entity names if requested\n  if (validateEntities) {\n    const unknownEntities = validateQueryEntities(workspace, queries);\n    if (unknownEntities.length > 0) {\n      return {\n        kind: \"unknown-entities\",\n        entities: unknownEntities,\n        message: `Unknown entity type${unknownEntities.length > 1 ? \"s\" : \"\"}: ${unknownEntities.map((e) => `'${e}'`).join(\", \")}. Define ${unknownEntities.length > 1 ? \"them\" : \"it\"} using 'define-entity'.`,\n      };\n    }\n  }\n\n  let results: InstanceEntry[];\n\n  if (sinceMarker?.type === \"git\" && tracker) {\n    // Use change tracker for git-based filtering\n    const changedResult = await tracker.getChangedEntries(workspace, queries, sinceMarker);\n    results = changedResult.entries;\n  } else {\n    // Execute all queries\n    results = executeQueries(workspace, queries);\n\n    // Filter by since timestamp if provided\n    if (sinceMarker?.type === \"ts\") {\n      const sinceEpoch = parseTimestampToEpoch(sinceMarker.value);\n      results = results.filter((entry) => {\n        const entryEpoch = timestampToEpoch(entry.header.timestamp);\n        return entryEpoch > sinceEpoch;\n      });\n    }\n  }\n\n  // Convert to QueryEntryInfo\n  const entries: QueryEntryInfo[] = [];\n  const limitedResults = limit && limit > 0 ? results.slice(0, limit) : results;\n\n  for (const entry of limitedResults) {\n    const file = findEntryFile(workspace, entry);\n    if (file) {\n      entries.push(toQueryEntryInfo(entry, file, workspace, includeRawText));\n    }\n  }\n\n  return {\n    queries,\n    queryString: queries.map(formatQuery).join(\", \"),\n    entries,\n    totalCount: results.length,\n  };\n}\n\n/**\n * Run the query command on a workspace.\n * For backward compatibility, this only supports a single query.\n * Use `runQueries` for multiple queries or comma-separated syntax.\n *\n * @param workspace - The workspace to query\n * @param queryString - The query string to parse and execute\n * @param options - Query options\n * @returns Structured query results, validation error, checkpoint error, or null if query is invalid\n */\nexport async function runQuery(\n  workspace: Workspace,\n  queryString: string,\n  options: RunQueryOptions = {},\n): Promise<QueryResult | QueryValidationError | CheckpointError | null> {\n  const result = await runQueries(workspace, queryString, options);\n\n  if (!result) {\n    return null;\n  }\n\n  // Return errors as-is\n  if (\"kind\" in result) {\n    return result;\n  }\n\n  // For backward compatibility, return single query format\n  // If multiple queries were parsed, use the first one\n  return {\n    query: result.queries[0],\n    queryString: result.queryString,\n    entries: result.entries,\n    totalCount: result.totalCount,\n  };\n}\n\n/**\n * Type guard to check if a query result is a validation error.\n */\nexport function isQueryValidationError(\n  result: QueryResult | QueriesResult | QueryValidationError | CheckpointError | null,\n): result is QueryValidationError {\n  return result !== null && \"kind\" in result && result.kind === \"unknown-entities\";\n}\n\n/**\n * Type guard to check if a query result is a checkpoint error.\n */\nexport function isCheckpointError(\n  result: QueryResult | QueriesResult | QueryValidationError | CheckpointError | null,\n): result is CheckpointError {\n  return result !== null && \"kind\" in result && result.kind === \"invalid-checkpoint\";\n}\n\n/**\n * Type guard to check if a query result is any error type.\n */\nexport function isQueryError(\n  result: QueryResult | QueriesResult | QueryValidationError | CheckpointError | null,\n): result is QueryValidationError | CheckpointError {\n  return result !== null && \"kind\" in result;\n}\n\n/**\n * Type guard to check if a query result is a successful result (not an error).\n */\nexport function isQuerySuccess(\n  result: QueryResult | QueryValidationError | CheckpointError | null,\n): result is QueryResult {\n  return result !== null && !(\"kind\" in result);\n}\n\n/**\n * Type guard to check if a queries result is a successful result (not an error).\n */\nexport function isQueriesSuccess(\n  result: QueriesResult | QueryValidationError | CheckpointError | null,\n): result is QueriesResult {\n  return result !== null && !(\"kind\" in result);\n}\n"],"mappings":";;;;;;;;;AAwBA,SAAS,iBAAiB,IAAuB;CAC/C,MAAM,SAAS,gBAAgB,GAAG;AAClC,QAAO,KAAK,MAAM,OAAO;;;;;AAM3B,SAAS,sBAAsB,QAAwB;AACrD,QAAO,KAAK,MAAM,OAAO;;;;;AA0H3B,SAAS,iBACP,OACA,MACA,WACA,gBACgB;CAChB,MAAMA,OAAuB;EAC3B;EACA,WAAW,gBAAgB,MAAM,OAAO,UAAU;EAClD,QAAQ,MAAM,OAAO;EACrB,OAAO,MAAM,OAAO,MAAM;EAC1B,QAAQ,MAAM,OAAO,MAAM,MAAM;EACjC,MAAM,MAAM,OAAO,KAAK,KAAK,MAAM,EAAE,KAAK;EAC1C,WAAW,MAAM,SAAS,cAAc,MAAM;EAC9C,SAAS,MAAM,SAAS,YAAY,MAAM;EAC3C;AAED,KAAI,gBAAgB;EAClB,MAAM,QAAQ,UAAU,SAAS,KAAK;AACtC,MAAI,MACF,MAAK,UAAU,mBAAmB,OAAO,MAAM,OAAO;;AAI1D,QAAO;;;;;;;;;;;AAYT,eAAsB,WACpB,WACA,aACA,UAA2B,EAAE,EAC2C;CACxE,MAAM,EAAE,OAAO,iBAAiB,OAAO,mBAAmB,MAAM,OAAO,YAAY;CAGnF,IAAIC,cAAmC;AAEvC,KAAI,OAAO;AACT,gBAAc,gBAAgB,MAAM;AACpC,MAAI,CAAC,YACH,QAAO;GACL,MAAM;GACN,SAAS,+BAA+B,MAAM;GAC/C;AAIH,MAAI,YAAY,SAAS,SAAS,CAAC,QACjC,QAAO;GACL,MAAM;GACN,SAAS;GACV;;CAKL,MAAM,UAAUC,iBAAwB,YAAY;AACpD,KAAI,CAAC,QACH,QAAO;AAIT,KAAI,kBAAkB;EACpB,MAAM,kBAAkB,sBAAsB,WAAW,QAAQ;AACjE,MAAI,gBAAgB,SAAS,EAC3B,QAAO;GACL,MAAM;GACN,UAAU;GACV,SAAS,sBAAsB,gBAAgB,SAAS,IAAI,MAAM,GAAG,IAAI,gBAAgB,KAAK,MAAM,IAAI,EAAE,GAAG,CAAC,KAAK,KAAK,CAAC,WAAW,gBAAgB,SAAS,IAAI,SAAS,KAAK;GAChL;;CAIL,IAAIC;AAEJ,KAAI,aAAa,SAAS,SAAS,QAGjC,YADsB,MAAM,QAAQ,kBAAkB,WAAW,SAAS,YAAY,EAC9D;MACnB;AAEL,YAAU,eAAe,WAAW,QAAQ;AAG5C,MAAI,aAAa,SAAS,MAAM;GAC9B,MAAM,aAAa,sBAAsB,YAAY,MAAM;AAC3D,aAAU,QAAQ,QAAQ,UAAU;AAElC,WADmB,iBAAiB,MAAM,OAAO,UAAU,GACvC;KACpB;;;CAKN,MAAMC,UAA4B,EAAE;CACpC,MAAM,iBAAiB,SAAS,QAAQ,IAAI,QAAQ,MAAM,GAAG,MAAM,GAAG;AAEtE,MAAK,MAAM,SAAS,gBAAgB;EAClC,MAAM,OAAO,cAAc,WAAW,MAAM;AAC5C,MAAI,KACF,SAAQ,KAAK,iBAAiB,OAAO,MAAM,WAAW,eAAe,CAAC;;AAI1E,QAAO;EACL;EACA,aAAa,QAAQ,IAAI,YAAY,CAAC,KAAK,KAAK;EAChD;EACA,YAAY,QAAQ;EACrB;;;;;;;;;;;;AAaH,eAAsB,SACpB,WACA,aACA,UAA2B,EAAE,EACyC;CACtE,MAAM,SAAS,MAAM,WAAW,WAAW,aAAa,QAAQ;AAEhE,KAAI,CAAC,OACH,QAAO;AAIT,KAAI,UAAU,OACZ,QAAO;AAKT,QAAO;EACL,OAAO,OAAO,QAAQ;EACtB,aAAa,OAAO;EACpB,SAAS,OAAO;EAChB,YAAY,OAAO;EACpB;;;;;AAMH,SAAgB,uBACd,QACgC;AAChC,QAAO,WAAW,QAAQ,UAAU,UAAU,OAAO,SAAS;;;;;AAMhE,SAAgB,kBACd,QAC2B;AAC3B,QAAO,WAAW,QAAQ,UAAU,UAAU,OAAO,SAAS;;;;;AAMhE,SAAgB,aACd,QACkD;AAClD,QAAO,WAAW,QAAQ,UAAU;;;;;AAMtC,SAAgB,eACd,QACuB;AACvB,QAAO,WAAW,QAAQ,EAAE,UAAU;;;;;AAMxC,SAAgB,iBACd,QACyB;AACzB,QAAO,WAAW,QAAQ,EAAE,UAAU"}

package/dist/constants.d.ts

@@ -0,0 +1,31 @@
+//#region src/constants.d.ts
+/**
+ * Language constants for Thalo syntax.
+ * Shared across packages (thalo, thalo-lsp, thalo-cli, etc.)
+ */
+/** Directives for instance entries (create/update lore, opinion, etc.) */
+declare const INSTANCE_DIRECTIVES: readonly ["create", "update"];
+/** Directives for schema entries (define-entity/alter-entity) */
+declare const SCHEMA_DIRECTIVES: readonly ["define-entity", "alter-entity"];
+/** Directives for synthesis entries (define-synthesis/actualize-synthesis) */
+declare const SYNTHESIS_DIRECTIVES: readonly ["define-synthesis", "actualize-synthesis"];
+/** All directives */
+declare const ALL_DIRECTIVES: readonly ["create", "update", "define-entity", "alter-entity", "define-synthesis", "actualize-synthesis"];
+/** Primitive types for field definitions */
+declare const PRIMITIVE_TYPES: readonly ["string", "datetime", "daterange", "link", "number"];
+/** Block headers used in define-entity/alter-entity */
+declare const SCHEMA_BLOCK_HEADERS: readonly ["# Metadata", "# Sections", "# Remove Metadata", "# Remove Sections"];
+type InstanceDirective = (typeof INSTANCE_DIRECTIVES)[number];
+type SchemaDirective = (typeof SCHEMA_DIRECTIVES)[number];
+type SynthesisDirective = (typeof SYNTHESIS_DIRECTIVES)[number];
+type Directive = (typeof ALL_DIRECTIVES)[number];
+type PrimitiveType = (typeof PRIMITIVE_TYPES)[number];
+type SchemaBlockHeader = (typeof SCHEMA_BLOCK_HEADERS)[number];
+declare function isInstanceDirective(value: string): value is InstanceDirective;
+declare function isSchemaDirective(value: string): value is SchemaDirective;
+declare function isSynthesisDirective(value: string): value is SynthesisDirective;
+declare function isDirective(value: string): value is Directive;
+declare function isPrimitiveType(value: string): value is PrimitiveType;
+//#endregion
+export { ALL_DIRECTIVES, Directive, INSTANCE_DIRECTIVES, InstanceDirective, PRIMITIVE_TYPES, PrimitiveType, SCHEMA_BLOCK_HEADERS, SCHEMA_DIRECTIVES, SYNTHESIS_DIRECTIVES, SchemaBlockHeader, SchemaDirective, SynthesisDirective, isDirective, isInstanceDirective, isPrimitiveType, isSchemaDirective, isSynthesisDirective };
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","names":[],"sources":["../src/constants.ts"],"sourcesContent":[],"mappings":";;AAUA;AAGA;AAGA;AAGA;AAWa,cApBA,mBAoBgF,EAAA,SAAA,CAAA,QAAA,EAAA,QAAA,CAAA;AAO7F;AAWY,cAnCC,iBAmC2B,EAAA,SAAA,CAAA,eAAmB,EAAA,cAAA,CAAA;AAC3D;AACY,cAlCC,oBAkC4B,EAAA,SAAA,CAAA,kBAAoB,EAAA,qBAAA,CAAA;AAC7D;AACY,cAjCC,cAiCuB,EAAA,SAAA,CAAA,QAAe,EAAA,QAAA,EAAA,eAAA,EAAA,cAAA,EAAA,kBAAA,EAAA,qBAAA,CAAA;AACnD;AAMgB,cA7BH,eA6BsB,EAAA,SAA0B,CAAA,QAAA,EAAiB,UAAA,EAAA,WAAA,EAAA,MAAA,EAAA,QAAA,CAAA;AAI9E;AAIgB,cA9BH,oBA8BiD,EAAA,SAAA,CAAA,YAAkB,EAAA,YAAA,EAAA,mBAAA,EAAA,mBAAA,CAAA;AAIhE,KAvBJ,iBAAA,GAuByC,CAAA,OAvBb,mBAuBsB,CAAA,CAAA,MAAA,CAAA;AAI9C,KA1BJ,eAAA,GA0BmB,CAAA,OA1BO,iBA0BgC,CAAA,CAAA,MAAA,CAAA;KAzB1D,kBAAA,WAA6B;KAC7B,SAAA,WAAoB;KACpB,aAAA,WAAwB;KACxB,iBAAA,WAA4B;iBAMxB,mBAAA,0BAA6C;iBAI7C,iBAAA,0BAA2C;iBAI3C,oBAAA,0BAA8C;iBAI9C,WAAA,0BAAqC;iBAIrC,eAAA,0BAAyC"}

package/dist/constants.js

@@ -0,0 +1,51 @@
+//#region src/constants.ts
+/**
+* Language constants for Thalo syntax.
+* Shared across packages (thalo, thalo-lsp, thalo-cli, etc.)
+*/
+/** Directives for instance entries (create/update lore, opinion, etc.) */
+const INSTANCE_DIRECTIVES = ["create", "update"];
+/** Directives for schema entries (define-entity/alter-entity) */
+const SCHEMA_DIRECTIVES = ["define-entity", "alter-entity"];
+/** Directives for synthesis entries (define-synthesis/actualize-synthesis) */
+const SYNTHESIS_DIRECTIVES = ["define-synthesis", "actualize-synthesis"];
+/** All directives */
+const ALL_DIRECTIVES = [
+	...INSTANCE_DIRECTIVES,
+	...SCHEMA_DIRECTIVES,
+	...SYNTHESIS_DIRECTIVES
+];
+/** Primitive types for field definitions */
+const PRIMITIVE_TYPES = [
+	"string",
+	"datetime",
+	"daterange",
+	"link",
+	"number"
+];
+/** Block headers used in define-entity/alter-entity */
+const SCHEMA_BLOCK_HEADERS = [
+	"# Metadata",
+	"# Sections",
+	"# Remove Metadata",
+	"# Remove Sections"
+];
+function isInstanceDirective(value) {
+	return INSTANCE_DIRECTIVES.includes(value);
+}
+function isSchemaDirective(value) {
+	return SCHEMA_DIRECTIVES.includes(value);
+}
+function isSynthesisDirective(value) {
+	return SYNTHESIS_DIRECTIVES.includes(value);
+}
+function isDirective(value) {
+	return ALL_DIRECTIVES.includes(value);
+}
+function isPrimitiveType(value) {
+	return PRIMITIVE_TYPES.includes(value);
+}
+
+//#endregion
+export { ALL_DIRECTIVES, INSTANCE_DIRECTIVES, PRIMITIVE_TYPES, SCHEMA_BLOCK_HEADERS, SCHEMA_DIRECTIVES, SYNTHESIS_DIRECTIVES, isDirective, isInstanceDirective, isPrimitiveType, isSchemaDirective, isSynthesisDirective };
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["/**\n * Language constants for Thalo syntax.\n * Shared across packages (thalo, thalo-lsp, thalo-cli, etc.)\n */\n\n// ===================\n// Directives\n// ===================\n\n/** Directives for instance entries (create/update lore, opinion, etc.) */\nexport const INSTANCE_DIRECTIVES = [\"create\", \"update\"] as const;\n\n/** Directives for schema entries (define-entity/alter-entity) */\nexport const SCHEMA_DIRECTIVES = [\"define-entity\", \"alter-entity\"] as const;\n\n/** Directives for synthesis entries (define-synthesis/actualize-synthesis) */\nexport const SYNTHESIS_DIRECTIVES = [\"define-synthesis\", \"actualize-synthesis\"] as const;\n\n/** All directives */\nexport const ALL_DIRECTIVES = [\n  ...INSTANCE_DIRECTIVES,\n  ...SCHEMA_DIRECTIVES,\n  ...SYNTHESIS_DIRECTIVES,\n] as const;\n\n// ===================\n// Primitive Types (for schema definitions)\n// ===================\n\n/** Primitive types for field definitions */\nexport const PRIMITIVE_TYPES = [\"string\", \"datetime\", \"daterange\", \"link\", \"number\"] as const;\n\n// ===================\n// Schema Block Headers\n// ===================\n\n/** Block headers used in define-entity/alter-entity */\nexport const SCHEMA_BLOCK_HEADERS = [\n  \"# Metadata\",\n  \"# Sections\",\n  \"# Remove Metadata\",\n  \"# Remove Sections\",\n] as const;\n\n// ===================\n// Type Utilities\n// ===================\n\nexport type InstanceDirective = (typeof INSTANCE_DIRECTIVES)[number];\nexport type SchemaDirective = (typeof SCHEMA_DIRECTIVES)[number];\nexport type SynthesisDirective = (typeof SYNTHESIS_DIRECTIVES)[number];\nexport type Directive = (typeof ALL_DIRECTIVES)[number];\nexport type PrimitiveType = (typeof PRIMITIVE_TYPES)[number];\nexport type SchemaBlockHeader = (typeof SCHEMA_BLOCK_HEADERS)[number];\n\n// ===================\n// Type Guards\n// ===================\n\nexport function isInstanceDirective(value: string): value is InstanceDirective {\n  return (INSTANCE_DIRECTIVES as readonly string[]).includes(value);\n}\n\nexport function isSchemaDirective(value: string): value is SchemaDirective {\n  return (SCHEMA_DIRECTIVES as readonly string[]).includes(value);\n}\n\nexport function isSynthesisDirective(value: string): value is SynthesisDirective {\n  return (SYNTHESIS_DIRECTIVES as readonly string[]).includes(value);\n}\n\nexport function isDirective(value: string): value is Directive {\n  return (ALL_DIRECTIVES as readonly string[]).includes(value);\n}\n\nexport function isPrimitiveType(value: string): value is PrimitiveType {\n  return (PRIMITIVE_TYPES as readonly string[]).includes(value);\n}\n"],"mappings":";;;;;;AAUA,MAAa,sBAAsB,CAAC,UAAU,SAAS;;AAGvD,MAAa,oBAAoB,CAAC,iBAAiB,eAAe;;AAGlE,MAAa,uBAAuB,CAAC,oBAAoB,sBAAsB;;AAG/E,MAAa,iBAAiB;CAC5B,GAAG;CACH,GAAG;CACH,GAAG;CACJ;;AAOD,MAAa,kBAAkB;CAAC;CAAU;CAAY;CAAa;CAAQ;CAAS;;AAOpF,MAAa,uBAAuB;CAClC;CACA;CACA;CACA;CACD;AAiBD,SAAgB,oBAAoB,OAA2C;AAC7E,QAAQ,oBAA0C,SAAS,MAAM;;AAGnE,SAAgB,kBAAkB,OAAyC;AACzE,QAAQ,kBAAwC,SAAS,MAAM;;AAGjE,SAAgB,qBAAqB,OAA4C;AAC/E,QAAQ,qBAA2C,SAAS,MAAM;;AAGpE,SAAgB,YAAY,OAAmC;AAC7D,QAAQ,eAAqC,SAAS,MAAM;;AAG9D,SAAgB,gBAAgB,OAAuC;AACrE,QAAQ,gBAAsC,SAAS,MAAM"}

package/dist/files.d.ts

@@ -0,0 +1,58 @@
+import { Workspace } from "./model/workspace.js";
+import "./parser.native.js";
+
+//#region src/files.d.ts
+
+/**
+ * Default file extensions for thalo files.
+ */
+declare const DEFAULT_EXTENSIONS: string[];
+/**
+ * Collect all thalo files from a directory recursively.
+ *
+ * Skips hidden directories (starting with .) and node_modules.
+ *
+ * @param dir - Directory to search
+ * @param extensions - File extensions to include (default: .thalo, .md)
+ * @returns Array of absolute file paths
+ */
+declare function collectThaloFiles(dir: string, extensions?: string[]): Promise<string[]>;
+/**
+ * Load a workspace from a directory.
+ *
+ * Discovers all .thalo and .md files in the directory and loads them
+ * into a new Workspace instance.
+ *
+ * @param cwd - Working directory to load files from
+ * @param extensions - File extensions to include (default: .thalo, .md)
+ * @returns The loaded workspace
+ * @throws Error if directory doesn't exist or no files found
+ *
+ * @example
+ * ```typescript
+ * import { loadWorkspaceFromDirectory } from "@rejot-dev/thalo/files";
+ *
+ * const workspace = await loadWorkspaceFromDirectory("./my-thalo-project");
+ * ```
+ */
+declare function loadWorkspaceFromDirectory(cwd: string, extensions?: string[]): Promise<Workspace>;
+/**
+ * Load a workspace from specific files.
+ *
+ * @param files - Array of file paths to load
+ * @returns The loaded workspace
+ *
+ * @example
+ * ```typescript
+ * import { loadWorkspaceFromFiles } from "@rejot-dev/thalo/files";
+ *
+ * const workspace = await loadWorkspaceFromFiles([
+ *   "./entries.thalo",
+ *   "./syntheses.thalo",
+ * ]);
+ * ```
+ */
+declare function loadWorkspaceFromFiles(files: string[]): Promise<Workspace>;
+//#endregion
+export { DEFAULT_EXTENSIONS, collectThaloFiles, loadWorkspaceFromDirectory, loadWorkspaceFromFiles };
+//# sourceMappingURL=files.d.ts.map

package/dist/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","names":[],"sources":["../src/files.ts"],"sourcesContent":[],"mappings":";;;;;;;;cAgBa;;;;;;;;;;iBAWS,iBAAA,sCAGnB;;;;;;;;;;;;;;;;;;;iBAiDmB,0BAAA,sCAGnB,QAAQ;;;;;;;;;;;;;;;;;iBAkDW,sBAAA,mBAAyC,QAAQ"}

package/dist/files.js

@@ -0,0 +1,103 @@
+import { createWorkspace } from "./parser.native.js";
+import { readFile, readdir, stat } from "node:fs/promises";
+import { join, resolve } from "node:path";
+
+//#region src/files.ts
+/**
+* Default file extensions for thalo files.
+*/
+const DEFAULT_EXTENSIONS = [".thalo", ".md"];
+/**
+* Collect all thalo files from a directory recursively.
+*
+* Skips hidden directories (starting with .) and node_modules.
+*
+* @param dir - Directory to search
+* @param extensions - File extensions to include (default: .thalo, .md)
+* @returns Array of absolute file paths
+*/
+async function collectThaloFiles(dir, extensions = DEFAULT_EXTENSIONS) {
+	const files = [];
+	async function walk(currentDir) {
+		let entries;
+		try {
+			entries = await readdir(currentDir, { withFileTypes: true });
+		} catch {
+			return;
+		}
+		for (const entry of entries) {
+			const fullPath = join(currentDir, entry.name);
+			if (entry.isDirectory()) {
+				if (!entry.name.startsWith(".") && entry.name !== "node_modules") await walk(fullPath);
+			} else if (entry.isFile()) {
+				if (extensions.some((ext) => entry.name.endsWith(ext))) files.push(fullPath);
+			}
+		}
+	}
+	await walk(dir);
+	return files;
+}
+/**
+* Load a workspace from a directory.
+*
+* Discovers all .thalo and .md files in the directory and loads them
+* into a new Workspace instance.
+*
+* @param cwd - Working directory to load files from
+* @param extensions - File extensions to include (default: .thalo, .md)
+* @returns The loaded workspace
+* @throws Error if directory doesn't exist or no files found
+*
+* @example
+* ```typescript
+* import { loadWorkspaceFromDirectory } from "@rejot-dev/thalo/files";
+*
+* const workspace = await loadWorkspaceFromDirectory("./my-thalo-project");
+* ```
+*/
+async function loadWorkspaceFromDirectory(cwd, extensions = DEFAULT_EXTENSIONS) {
+	const resolvedCwd = resolve(cwd);
+	try {
+		if (!(await stat(resolvedCwd)).isDirectory()) throw new Error(`Path is not a directory: ${cwd}`);
+	} catch (err) {
+		if (err instanceof Error && "code" in err && err.code === "ENOENT") throw new Error(`Directory not found: ${cwd}`);
+		throw err;
+	}
+	const files = await collectThaloFiles(resolvedCwd, extensions);
+	if (files.length === 0) throw new Error(`No ${extensions.join(" or ")} files found in ${cwd}`);
+	const workspace = createWorkspace();
+	for (const file of files) {
+		const source = await readFile(file, "utf-8");
+		workspace.addDocument(source, { filename: file });
+	}
+	return workspace;
+}
+/**
+* Load a workspace from specific files.
+*
+* @param files - Array of file paths to load
+* @returns The loaded workspace
+*
+* @example
+* ```typescript
+* import { loadWorkspaceFromFiles } from "@rejot-dev/thalo/files";
+*
+* const workspace = await loadWorkspaceFromFiles([
+*   "./entries.thalo",
+*   "./syntheses.thalo",
+* ]);
+* ```
+*/
+async function loadWorkspaceFromFiles(files) {
+	const workspace = createWorkspace();
+	for (const file of files) {
+		const resolvedPath = resolve(file);
+		const source = await readFile(resolvedPath, "utf-8");
+		workspace.addDocument(source, { filename: resolvedPath });
+	}
+	return workspace;
+}
+
+//#endregion
+export { DEFAULT_EXTENSIONS, collectThaloFiles, loadWorkspaceFromDirectory, loadWorkspaceFromFiles };
+//# sourceMappingURL=files.js.map

package/dist/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","names":["files: string[]"],"sources":["../src/files.ts"],"sourcesContent":["/**\n * Node.js-only file utilities for loading Thalo workspaces.\n *\n * This module provides helpers for discovering and loading .thalo and .md files.\n * It should only be used in Node.js environments (CLI, scripts, GitHub Actions).\n *\n * @module @rejot-dev/thalo/files\n */\n\nimport { readdir, readFile, stat } from \"node:fs/promises\";\nimport { join, resolve } from \"node:path\";\nimport { createWorkspace, type Workspace } from \"./parser.native.js\";\n\n/**\n * Default file extensions for thalo files.\n */\nexport const DEFAULT_EXTENSIONS = [\".thalo\", \".md\"];\n\n/**\n * Collect all thalo files from a directory recursively.\n *\n * Skips hidden directories (starting with .) and node_modules.\n *\n * @param dir - Directory to search\n * @param extensions - File extensions to include (default: .thalo, .md)\n * @returns Array of absolute file paths\n */\nexport async function collectThaloFiles(\n  dir: string,\n  extensions: string[] = DEFAULT_EXTENSIONS,\n): Promise<string[]> {\n  const files: string[] = [];\n\n  async function walk(currentDir: string): Promise<void> {\n    let entries;\n    try {\n      entries = await readdir(currentDir, { withFileTypes: true });\n    } catch {\n      return;\n    }\n\n    for (const entry of entries) {\n      const fullPath = join(currentDir, entry.name);\n\n      if (entry.isDirectory()) {\n        // Skip hidden directories and node_modules\n        if (!entry.name.startsWith(\".\") && entry.name !== \"node_modules\") {\n          await walk(fullPath);\n        }\n      } else if (entry.isFile()) {\n        if (extensions.some((ext) => entry.name.endsWith(ext))) {\n          files.push(fullPath);\n        }\n      }\n    }\n  }\n\n  await walk(dir);\n  return files;\n}\n\n/**\n * Load a workspace from a directory.\n *\n * Discovers all .thalo and .md files in the directory and loads them\n * into a new Workspace instance.\n *\n * @param cwd - Working directory to load files from\n * @param extensions - File extensions to include (default: .thalo, .md)\n * @returns The loaded workspace\n * @throws Error if directory doesn't exist or no files found\n *\n * @example\n * ```typescript\n * import { loadWorkspaceFromDirectory } from \"@rejot-dev/thalo/files\";\n *\n * const workspace = await loadWorkspaceFromDirectory(\"./my-thalo-project\");\n * ```\n */\nexport async function loadWorkspaceFromDirectory(\n  cwd: string,\n  extensions: string[] = DEFAULT_EXTENSIONS,\n): Promise<Workspace> {\n  const resolvedCwd = resolve(cwd);\n\n  // Check if directory exists\n  try {\n    const dirStat = await stat(resolvedCwd);\n    if (!dirStat.isDirectory()) {\n      throw new Error(`Path is not a directory: ${cwd}`);\n    }\n  } catch (err) {\n    if (err instanceof Error && \"code\" in err && err.code === \"ENOENT\") {\n      throw new Error(`Directory not found: ${cwd}`);\n    }\n    throw err;\n  }\n\n  // Collect all thalo files\n  const files = await collectThaloFiles(resolvedCwd, extensions);\n\n  if (files.length === 0) {\n    throw new Error(`No ${extensions.join(\" or \")} files found in ${cwd}`);\n  }\n\n  // Create workspace and add documents\n  const workspace = createWorkspace();\n\n  for (const file of files) {\n    const source = await readFile(file, \"utf-8\");\n    workspace.addDocument(source, { filename: file });\n  }\n\n  return workspace;\n}\n\n/**\n * Load a workspace from specific files.\n *\n * @param files - Array of file paths to load\n * @returns The loaded workspace\n *\n * @example\n * ```typescript\n * import { loadWorkspaceFromFiles } from \"@rejot-dev/thalo/files\";\n *\n * const workspace = await loadWorkspaceFromFiles([\n *   \"./entries.thalo\",\n *   \"./syntheses.thalo\",\n * ]);\n * ```\n */\nexport async function loadWorkspaceFromFiles(files: string[]): Promise<Workspace> {\n  const workspace = createWorkspace();\n\n  for (const file of files) {\n    const resolvedPath = resolve(file);\n    const source = await readFile(resolvedPath, \"utf-8\");\n    workspace.addDocument(source, { filename: resolvedPath });\n  }\n\n  return workspace;\n}\n"],"mappings":";;;;;;;;AAgBA,MAAa,qBAAqB,CAAC,UAAU,MAAM;;;;;;;;;;AAWnD,eAAsB,kBACpB,KACA,aAAuB,oBACJ;CACnB,MAAMA,QAAkB,EAAE;CAE1B,eAAe,KAAK,YAAmC;EACrD,IAAI;AACJ,MAAI;AACF,aAAU,MAAM,QAAQ,YAAY,EAAE,eAAe,MAAM,CAAC;UACtD;AACN;;AAGF,OAAK,MAAM,SAAS,SAAS;GAC3B,MAAM,WAAW,KAAK,YAAY,MAAM,KAAK;AAE7C,OAAI,MAAM,aAAa,EAErB;QAAI,CAAC,MAAM,KAAK,WAAW,IAAI,IAAI,MAAM,SAAS,eAChD,OAAM,KAAK,SAAS;cAEb,MAAM,QAAQ,EACvB;QAAI,WAAW,MAAM,QAAQ,MAAM,KAAK,SAAS,IAAI,CAAC,CACpD,OAAM,KAAK,SAAS;;;;AAM5B,OAAM,KAAK,IAAI;AACf,QAAO;;;;;;;;;;;;;;;;;;;;AAqBT,eAAsB,2BACpB,KACA,aAAuB,oBACH;CACpB,MAAM,cAAc,QAAQ,IAAI;AAGhC,KAAI;AAEF,MAAI,EADY,MAAM,KAAK,YAAY,EAC1B,aAAa,CACxB,OAAM,IAAI,MAAM,4BAA4B,MAAM;UAE7C,KAAK;AACZ,MAAI,eAAe,SAAS,UAAU,OAAO,IAAI,SAAS,SACxD,OAAM,IAAI,MAAM,wBAAwB,MAAM;AAEhD,QAAM;;CAIR,MAAM,QAAQ,MAAM,kBAAkB,aAAa,WAAW;AAE9D,KAAI,MAAM,WAAW,EACnB,OAAM,IAAI,MAAM,MAAM,WAAW,KAAK,OAAO,CAAC,kBAAkB,MAAM;CAIxE,MAAM,YAAY,iBAAiB;AAEnC,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,SAAS,MAAM,SAAS,MAAM,QAAQ;AAC5C,YAAU,YAAY,QAAQ,EAAE,UAAU,MAAM,CAAC;;AAGnD,QAAO;;;;;;;;;;;;;;;;;;AAmBT,eAAsB,uBAAuB,OAAqC;CAChF,MAAM,YAAY,iBAAiB;AAEnC,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,eAAe,QAAQ,KAAK;EAClC,MAAM,SAAS,MAAM,SAAS,cAAc,QAAQ;AACpD,YAAU,YAAY,QAAQ,EAAE,UAAU,cAAc,CAAC;;AAG3D,QAAO"}

package/dist/formatters.d.ts

@@ -0,0 +1,39 @@
+import { Timestamp } from "./ast/ast-types.js";
+import { ActualizeResult } from "./commands/actualize.js";
+import { CheckResult, DiagnosticInfo } from "./commands/check.js";
+import { QueryResult } from "./commands/query.js";
+
+//#region src/formatters.d.ts
+
+/**
+ * Output format style for diagnostics.
+ */
+type DiagnosticFormat = "default" | "compact" | "github";
+/**
+ * Format a timestamp to ISO-like string for comparisons and display.
+ * Example: "2026-01-07T12:00Z" or "2026-01-07T12:00+05:30"
+ */
+declare function formatTimestamp(ts: Timestamp): string;
+/**
+ * Format a single diagnostic.
+ */
+declare function formatDiagnostic(d: DiagnosticInfo, format?: DiagnosticFormat): string;
+/**
+ * Format check results as an array of lines.
+ */
+declare function formatCheckResult(result: CheckResult, format?: DiagnosticFormat): string[];
+/**
+ * Format query results as an array of lines.
+ */
+declare function formatQueryResult(result: QueryResult): string[];
+/**
+ * Format query results in raw format (just the entry source text).
+ */
+declare function formatQueryResultRaw(result: QueryResult): string[];
+/**
+ * Format actualize results as an array of lines.
+ */
+declare function formatActualizeResult(result: ActualizeResult): string[];
+//#endregion
+export { DiagnosticFormat, formatActualizeResult, formatCheckResult, formatDiagnostic, formatQueryResult, formatQueryResultRaw, formatTimestamp };
+//# sourceMappingURL=formatters.d.ts.map

package/dist/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","names":[],"sources":["../src/formatters.ts"],"sourcesContent":[],"mappings":";;;;;;;AA6NA;AA+EA;;KAtRY,gBAAA;;;;;iBAUI,eAAA,KAAoB;;;;iBAiFpB,gBAAA,IAAoB,yBAAwB;;;;iBAc5C,iBAAA,SACN,sBACA;;;;iBAiEM,iBAAA,SAA0B;;;;iBA2B1B,oBAAA,SAA6B;;;;iBA+E7B,qBAAA,SAA8B"}

package/dist/formatters.js

@@ -0,0 +1,200 @@
+import { formatCheckpoint } from "./services/change-tracker/change-tracker.js";
+import { isSyntaxError } from "./ast/ast-types.js";
+
+//#region src/formatters.ts
+/**
+* Format a timestamp to ISO-like string for comparisons and display.
+* Example: "2026-01-07T12:00Z" or "2026-01-07T12:00+05:30"
+*/
+function formatTimestamp(ts) {
+	return `${`${ts.date.year}-${String(ts.date.month).padStart(2, "0")}-${String(ts.date.day).padStart(2, "0")}`}T${`${String(ts.time.hour).padStart(2, "0")}:${String(ts.time.minute).padStart(2, "0")}`}${isSyntaxError(ts.timezone) ? "" : ts.timezone.value}`;
+}
+/**
+* Format a relative path from CWD (if applicable).
+* This is a no-op since we don't have access to process.cwd() in all environments.
+* CLI tools should handle path relativization themselves.
+*/
+function formatPath(path) {
+	return path;
+}
+/**
+* Format a single diagnostic in default style.
+*/
+function formatDiagnosticDefault(d) {
+	return `  ${`${d.line}:${d.column}`.padEnd(8)} ${d.severity.padEnd(7)} ${d.message}  ${d.code}`;
+}
+/**
+* Format a single diagnostic in compact style.
+*/
+function formatDiagnosticCompact(d) {
+	return `${`${formatPath(d.file)}:${d.line}:${d.column}`}: ${d.severity[0].toUpperCase()} [${d.code}] ${d.message}`;
+}
+/**
+* Escape a string for use in GitHub Actions annotation property values.
+* Property values require: % → %25, \n → %0A, \r → %0D, : → %3A, , → %2C
+*/
+function escapeGithubProperty(value) {
+	return value.replace(/%/g, "%25").replace(/\r/g, "%0D").replace(/\n/g, "%0A").replace(/:/g, "%3A").replace(/,/g, "%2C");
+}
+/**
+* Escape a string for use in GitHub Actions annotation message.
+* Messages require: % → %25, \n → %0A, \r → %0D
+*/
+function escapeGithubMessage(value) {
+	return value.replace(/%/g, "%25").replace(/\r/g, "%0D").replace(/\n/g, "%0A");
+}
+/**
+* Map internal severity to GitHub Actions annotation level.
+* GitHub Actions supports: error, warning, notice (not "info")
+*/
+function toGithubSeverity(severity) {
+	return severity === "info" ? "notice" : severity;
+}
+/**
+* Format a single diagnostic in GitHub Actions style.
+*/
+function formatDiagnosticGithub(d) {
+	const severity = toGithubSeverity(d.severity);
+	const file = escapeGithubProperty(d.file);
+	const title = escapeGithubProperty(d.code);
+	const message = escapeGithubMessage(d.message);
+	return `::${severity} file=${file},line=${d.line},col=${d.column},endLine=${d.endLine},endColumn=${d.endColumn},title=${title}::${message}`;
+}
+/**
+* Format a single diagnostic.
+*/
+function formatDiagnostic(d, format = "default") {
+	switch (format) {
+		case "compact": return formatDiagnosticCompact(d);
+		case "github": return formatDiagnosticGithub(d);
+		default: return formatDiagnosticDefault(d);
+	}
+}
+/**
+* Format check results as an array of lines.
+*/
+function formatCheckResult(result, format = "default") {
+	const lines = [];
+	if (format === "default") for (const [file, diagnostics] of result.diagnosticsByFile) {
+		lines.push("");
+		lines.push(formatPath(file));
+		for (const d of diagnostics) lines.push(formatDiagnosticDefault(d));
+	}
+	else for (const [, diagnostics] of result.diagnosticsByFile) for (const d of diagnostics) lines.push(formatDiagnostic(d, format));
+	if (format !== "github") {
+		lines.push("");
+		const parts = [];
+		if (result.errorCount > 0) parts.push(`${result.errorCount} error${result.errorCount !== 1 ? "s" : ""}`);
+		if (result.warningCount > 0) parts.push(`${result.warningCount} warning${result.warningCount !== 1 ? "s" : ""}`);
+		if (result.infoCount > 0) parts.push(`${result.infoCount} info`);
+		const summary = parts.length > 0 ? parts.join(", ") : "no issues";
+		lines.push(`${result.filesChecked} files checked, ${summary}`);
+	}
+	return lines;
+}
+/**
+* Format a query entry in default style.
+*/
+function formatQueryEntryDefault(entry) {
+	const lines = [];
+	const link = entry.linkId ? ` ^${entry.linkId}` : "";
+	const tags = entry.tags.length > 0 ? " " + entry.tags.map((t) => `#${t}`).join(" ") : "";
+	lines.push(`${entry.timestamp} ${entry.entity} ${entry.title}${link}${tags}`);
+	lines.push(`  ${formatPath(entry.file)}:${entry.startLine}-${entry.endLine}`);
+	return lines;
+}
+/**
+* Format query results as an array of lines.
+*/
+function formatQueryResult(result) {
+	const lines = [];
+	lines.push("");
+	lines.push(`Query: ${result.queryString}`);
+	lines.push(`Found: ${result.totalCount} entries`);
+	if (result.entries.length > 0) {
+		lines.push("");
+		for (const entry of result.entries) lines.push(...formatQueryEntryDefault(entry));
+	}
+	if (result.entries.length < result.totalCount) {
+		lines.push("");
+		lines.push(`(showing ${result.entries.length} of ${result.totalCount} results)`);
+	}
+	lines.push("");
+	return lines;
+}
+/**
+* Format query results in raw format (just the entry source text).
+*/
+function formatQueryResultRaw(result) {
+	const lines = [];
+	for (const entry of result.entries) if (entry.rawText) {
+		lines.push(entry.rawText);
+		lines.push("");
+	}
+	return lines;
+}
+/**
+* Format a synthesis entry for actualize output.
+*/
+function formatActualizeEntry(entry) {
+	return entry.rawText.split("\n");
+}
+/**
+* Format a single synthesis output.
+*/
+function formatSynthesisOutput(synthesis) {
+	const lines = [];
+	if (synthesis.isUpToDate) {
+		lines.push(`✓ ${formatPath(synthesis.file)}: ${synthesis.title} - up to date`);
+		return lines;
+	}
+	lines.push("");
+	lines.push(`=== Synthesis: ${synthesis.title} (${formatPath(synthesis.file)}) ===`);
+	lines.push(`Target: ^${synthesis.linkId}`);
+	lines.push(`Sources: ${synthesis.sources.join(", ")}`);
+	if (synthesis.lastCheckpoint) lines.push(`Last checkpoint: ${formatCheckpoint(synthesis.lastCheckpoint)}`);
+	lines.push("");
+	lines.push("--- User Prompt ---");
+	if (synthesis.prompt) lines.push(synthesis.prompt);
+	else lines.push("(no prompt defined)");
+	lines.push("");
+	lines.push(`--- Changed Entries (${synthesis.entries.length}) ---`);
+	for (const entry of synthesis.entries) {
+		lines.push("");
+		lines.push(...formatActualizeEntry(entry));
+	}
+	const checkpointValue = formatCheckpoint(synthesis.currentCheckpoint);
+	lines.push("");
+	lines.push("--- Instructions ---");
+	lines.push(`1. Update the content directly below the \`\`\`thalo block in ${formatPath(synthesis.file)}`);
+	lines.push(`2. Place output BEFORE any subsequent \`\`\`thalo blocks`);
+	lines.push(`3. Append to the thalo block: actualize-synthesis ^${synthesis.linkId}`);
+	lines.push(`   with metadata: checkpoint: "${checkpointValue}"`);
+	lines.push("");
+	lines.push("─".repeat(60));
+	return lines;
+}
+/**
+* Format actualize results as an array of lines.
+*/
+function formatActualizeResult(result) {
+	const lines = [];
+	if (result.syntheses.length === 0) {
+		lines.push("No synthesis definitions found.");
+		return lines;
+	}
+	let hasOutput = false;
+	for (const synthesis of result.syntheses) {
+		if (!synthesis.isUpToDate) hasOutput = true;
+		lines.push(...formatSynthesisOutput(synthesis));
+	}
+	if (!hasOutput) {
+		lines.push("");
+		lines.push("All syntheses are up to date.");
+	}
+	return lines;
+}
+
+//#endregion
+export { formatActualizeResult, formatCheckResult, formatDiagnostic, formatQueryResult, formatQueryResultRaw, formatTimestamp };
+//# sourceMappingURL=formatters.js.map

package/dist/formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.js","names":["lines: string[]","parts: string[]"],"sources":["../src/formatters.ts"],"sourcesContent":["/**\n * Plain-text formatters for command results.\n *\n * These formatters produce plain text output without any colors or styling.\n * CLI tools can add colors on top using libraries like picocolors.\n * Browser environments can use the structured results directly.\n */\n\nimport type { CheckResult, DiagnosticInfo } from \"./commands/check.js\";\nimport type { QueryResult, QueryEntryInfo } from \"./commands/query.js\";\nimport type {\n  ActualizeResult,\n  SynthesisOutputInfo,\n  ActualizeEntryInfo,\n} from \"./commands/actualize.js\";\nimport { formatCheckpoint } from \"./services/change-tracker/change-tracker.js\";\nimport type { Timestamp } from \"./ast/ast-types.js\";\nimport { isSyntaxError } from \"./ast/ast-types.js\";\n\n/**\n * Output format style for diagnostics.\n */\nexport type DiagnosticFormat = \"default\" | \"compact\" | \"github\";\n\n// ===================\n// Timestamp Formatting\n// ===================\n\n/**\n * Format a timestamp to ISO-like string for comparisons and display.\n * Example: \"2026-01-07T12:00Z\" or \"2026-01-07T12:00+05:30\"\n */\nexport function formatTimestamp(ts: Timestamp): string {\n  const date = `${ts.date.year}-${String(ts.date.month).padStart(2, \"0\")}-${String(ts.date.day).padStart(2, \"0\")}`;\n  const time = `${String(ts.time.hour).padStart(2, \"0\")}:${String(ts.time.minute).padStart(2, \"0\")}`;\n  const tz = isSyntaxError(ts.timezone) ? \"\" : ts.timezone.value;\n  return `${date}T${time}${tz}`;\n}\n\n/**\n * Format a relative path from CWD (if applicable).\n * This is a no-op since we don't have access to process.cwd() in all environments.\n * CLI tools should handle path relativization themselves.\n */\nfunction formatPath(path: string): string {\n  return path;\n}\n\n// ===================\n// Check Formatters\n// ===================\n\n/**\n * Format a single diagnostic in default style.\n */\nfunction formatDiagnosticDefault(d: DiagnosticInfo): string {\n  const loc = `${d.line}:${d.column}`.padEnd(8);\n  const severity = d.severity.padEnd(7);\n  return `  ${loc} ${severity} ${d.message}  ${d.code}`;\n}\n\n/**\n * Format a single diagnostic in compact style.\n */\nfunction formatDiagnosticCompact(d: DiagnosticInfo): string {\n  const loc = `${formatPath(d.file)}:${d.line}:${d.column}`;\n  return `${loc}: ${d.severity[0].toUpperCase()} [${d.code}] ${d.message}`;\n}\n\n/**\n * Escape a string for use in GitHub Actions annotation property values.\n * Property values require: % → %25, \\n → %0A, \\r → %0D, : → %3A, , → %2C\n */\nfunction escapeGithubProperty(value: string): string {\n  return value\n    .replace(/%/g, \"%25\")\n    .replace(/\\r/g, \"%0D\")\n    .replace(/\\n/g, \"%0A\")\n    .replace(/:/g, \"%3A\")\n    .replace(/,/g, \"%2C\");\n}\n\n/**\n * Escape a string for use in GitHub Actions annotation message.\n * Messages require: % → %25, \\n → %0A, \\r → %0D\n */\nfunction escapeGithubMessage(value: string): string {\n  return value.replace(/%/g, \"%25\").replace(/\\r/g, \"%0D\").replace(/\\n/g, \"%0A\");\n}\n\n/**\n * Map internal severity to GitHub Actions annotation level.\n * GitHub Actions supports: error, warning, notice (not \"info\")\n */\nfunction toGithubSeverity(severity: string): string {\n  return severity === \"info\" ? \"notice\" : severity;\n}\n\n/**\n * Format a single diagnostic in GitHub Actions style.\n */\nfunction formatDiagnosticGithub(d: DiagnosticInfo): string {\n  const severity = toGithubSeverity(d.severity);\n  const file = escapeGithubProperty(d.file);\n  const title = escapeGithubProperty(d.code);\n  const message = escapeGithubMessage(d.message);\n\n  return `::${severity} file=${file},line=${d.line},col=${d.column},endLine=${d.endLine},endColumn=${d.endColumn},title=${title}::${message}`;\n}\n\n/**\n * Format a single diagnostic.\n */\nexport function formatDiagnostic(d: DiagnosticInfo, format: DiagnosticFormat = \"default\"): string {\n  switch (format) {\n    case \"compact\":\n      return formatDiagnosticCompact(d);\n    case \"github\":\n      return formatDiagnosticGithub(d);\n    default:\n      return formatDiagnosticDefault(d);\n  }\n}\n\n/**\n * Format check results as an array of lines.\n */\nexport function formatCheckResult(\n  result: CheckResult,\n  format: DiagnosticFormat = \"default\",\n): string[] {\n  const lines: string[] = [];\n\n  if (format === \"default\") {\n    // Group diagnostics by file for cleaner output\n    for (const [file, diagnostics] of result.diagnosticsByFile) {\n      lines.push(\"\");\n      lines.push(formatPath(file));\n      for (const d of diagnostics) {\n        lines.push(formatDiagnosticDefault(d));\n      }\n    }\n  } else {\n    // Flat list for compact/github formats\n    for (const [, diagnostics] of result.diagnosticsByFile) {\n      for (const d of diagnostics) {\n        lines.push(formatDiagnostic(d, format));\n      }\n    }\n  }\n\n  // Summary line (skip for github format)\n  if (format !== \"github\") {\n    lines.push(\"\");\n    const parts: string[] = [];\n    if (result.errorCount > 0) {\n      parts.push(`${result.errorCount} error${result.errorCount !== 1 ? \"s\" : \"\"}`);\n    }\n    if (result.warningCount > 0) {\n      parts.push(`${result.warningCount} warning${result.warningCount !== 1 ? \"s\" : \"\"}`);\n    }\n    if (result.infoCount > 0) {\n      parts.push(`${result.infoCount} info`);\n    }\n\n    const summary = parts.length > 0 ? parts.join(\", \") : \"no issues\";\n    lines.push(`${result.filesChecked} files checked, ${summary}`);\n  }\n\n  return lines;\n}\n\n// ===================\n// Query Formatters\n// ===================\n\n/**\n * Format a query entry in default style.\n */\nfunction formatQueryEntryDefault(entry: QueryEntryInfo): string[] {\n  const lines: string[] = [];\n\n  const link = entry.linkId ? ` ^${entry.linkId}` : \"\";\n  const tags = entry.tags.length > 0 ? \" \" + entry.tags.map((t) => `#${t}`).join(\" \") : \"\";\n\n  lines.push(`${entry.timestamp} ${entry.entity} ${entry.title}${link}${tags}`);\n  lines.push(`  ${formatPath(entry.file)}:${entry.startLine}-${entry.endLine}`);\n\n  return lines;\n}\n\n/**\n * Format query results as an array of lines.\n */\nexport function formatQueryResult(result: QueryResult): string[] {\n  const lines: string[] = [];\n\n  lines.push(\"\");\n  lines.push(`Query: ${result.queryString}`);\n  lines.push(`Found: ${result.totalCount} entries`);\n\n  if (result.entries.length > 0) {\n    lines.push(\"\");\n    for (const entry of result.entries) {\n      lines.push(...formatQueryEntryDefault(entry));\n    }\n  }\n\n  if (result.entries.length < result.totalCount) {\n    lines.push(\"\");\n    lines.push(`(showing ${result.entries.length} of ${result.totalCount} results)`);\n  }\n\n  lines.push(\"\");\n\n  return lines;\n}\n\n/**\n * Format query results in raw format (just the entry source text).\n */\nexport function formatQueryResultRaw(result: QueryResult): string[] {\n  const lines: string[] = [];\n\n  for (const entry of result.entries) {\n    if (entry.rawText) {\n      lines.push(entry.rawText);\n      lines.push(\"\");\n    }\n  }\n\n  return lines;\n}\n\n// ===================\n// Actualize Formatters\n// ===================\n\n/**\n * Format a synthesis entry for actualize output.\n */\nfunction formatActualizeEntry(entry: ActualizeEntryInfo): string[] {\n  return entry.rawText.split(\"\\n\");\n}\n\n/**\n * Format a single synthesis output.\n */\nfunction formatSynthesisOutput(synthesis: SynthesisOutputInfo): string[] {\n  const lines: string[] = [];\n\n  if (synthesis.isUpToDate) {\n    lines.push(`✓ ${formatPath(synthesis.file)}: ${synthesis.title} - up to date`);\n    return lines;\n  }\n\n  lines.push(\"\");\n  lines.push(`=== Synthesis: ${synthesis.title} (${formatPath(synthesis.file)}) ===`);\n  lines.push(`Target: ^${synthesis.linkId}`);\n  lines.push(`Sources: ${synthesis.sources.join(\", \")}`);\n  if (synthesis.lastCheckpoint) {\n    lines.push(`Last checkpoint: ${formatCheckpoint(synthesis.lastCheckpoint)}`);\n  }\n\n  // Output prompt\n  lines.push(\"\");\n  lines.push(\"--- User Prompt ---\");\n  if (synthesis.prompt) {\n    lines.push(synthesis.prompt);\n  } else {\n    lines.push(\"(no prompt defined)\");\n  }\n\n  // Output new entries\n  lines.push(\"\");\n  lines.push(`--- Changed Entries (${synthesis.entries.length}) ---`);\n  for (const entry of synthesis.entries) {\n    lines.push(\"\");\n    lines.push(...formatActualizeEntry(entry));\n  }\n\n  // Output instructions\n  const checkpointValue = formatCheckpoint(synthesis.currentCheckpoint);\n  lines.push(\"\");\n  lines.push(\"--- Instructions ---\");\n  lines.push(\n    `1. Update the content directly below the \\`\\`\\`thalo block in ${formatPath(synthesis.file)}`,\n  );\n  lines.push(`2. Place output BEFORE any subsequent \\`\\`\\`thalo blocks`);\n  lines.push(`3. Append to the thalo block: actualize-synthesis ^${synthesis.linkId}`);\n  lines.push(`   with metadata: checkpoint: \"${checkpointValue}\"`);\n  lines.push(\"\");\n  lines.push(\"─\".repeat(60));\n\n  return lines;\n}\n\n/**\n * Format actualize results as an array of lines.\n */\nexport function formatActualizeResult(result: ActualizeResult): string[] {\n  const lines: string[] = [];\n\n  if (result.syntheses.length === 0) {\n    lines.push(\"No synthesis definitions found.\");\n    return lines;\n  }\n\n  let hasOutput = false;\n\n  for (const synthesis of result.syntheses) {\n    if (!synthesis.isUpToDate) {\n      hasOutput = true;\n    }\n    lines.push(...formatSynthesisOutput(synthesis));\n  }\n\n  if (!hasOutput) {\n    lines.push(\"\");\n    lines.push(\"All syntheses are up to date.\");\n  }\n\n  return lines;\n}\n"],"mappings":"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"}

package/dist/fragment.d.ts

@@ -0,0 +1,22 @@
+import { SyntaxNode } from "./ast/ast-types.js";
+
+//#region src/fragment.d.ts
+
+/**
+ * Supported fragment types for parsing individual expressions.
+ */
+type FragmentType = "query" | "value" | "type_expression";
+/**
+ * Result of parsing a fragment
+ */
+interface ParsedFragment {
+  /** The parsed syntax node */
+  node: SyntaxNode;
+  /** Whether the fragment parsed without errors */
+  valid: boolean;
+  /** Error message if parsing failed */
+  error?: string;
+}
+//#endregion
+export { FragmentType, ParsedFragment };
+//# sourceMappingURL=fragment.d.ts.map

package/dist/fragment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragment.d.ts","names":[],"sources":["../src/fragment.ts"],"sourcesContent":[],"mappings":";;;;;AAMA;AAKA;KALY,YAAA;;;;UAKK,cAAA;;QAET"}