patram 0.8.0 → 0.10.0

package/lib/{layout-stored-queries.js → output/layout-stored-queries.js}

@@ -3,14 +3,14 @@
  * @import { OutputStoredQueryItem } from './output-view.types.ts';
  */
 
-import { parseWhereClause } from './parse-where-clause.js';
+import { parseWhereClause } from '../graph/query/parse.js';
 
 const MAX_STORED_QUERY_WIDTH = 100;
 const MIN_TERM_COLUMN_WIDTH = 20;
 const STORED_QUERY_COLUMN_GAP = 2;
 
 /**
- * @typedef {'field_name' | 'keyword' | 'literal' | 'name' | 'operator' | 'plain'} StoredQuerySegmentKind
+ * @typedef {'description' | 'field_name' | 'keyword' | 'literal' | 'name' | 'operator' | 'plain'} StoredQuerySegmentKind
  */
 
 /**
@@ -56,7 +56,8 @@ function layoutStoredQuery(output_item, name_column_width, term_column_width) {
     name_column_width + STORED_QUERY_COLUMN_GAP,
   );
 
-  return term_lines.map((line_segments, line_index) => {
+  /** @type {StoredQuerySegment[][]} */
+  const output_lines = term_lines.map((line_segments, line_index) => {
     if (line_index === 0) {
       return [
         {
@@ -79,6 +80,21 @@ function layoutStoredQuery(output_item, name_column_width, term_column_width) {
       ...line_segments,
     ];
   });
+
+  if (output_item.description) {
+    for (const description_line of output_item.description.split('\n')) {
+      output_lines.push([
+        {
+          kind: 'description',
+          text: `${' '.repeat(name_column_width + STORED_QUERY_COLUMN_GAP)}${description_line}`,
+        },
+      ]);
+    }
+  }
+
+  output_lines.push([]);
+
+  return output_lines;
 }
 
 /**
@@ -96,7 +112,7 @@ function createStoredQueryPhrases(where_clause) {
 }
 
 /**
- * @param {import('./parse-where-clause.types.ts').ParsedExpression} expression
+ * @param {import('../graph/parse-where-clause.types.ts').ParsedExpression} expression
  * @returns {StoredQuerySegment[][]}
  */
 function createExpressionPhrases(expression) {
@@ -114,7 +130,7 @@ function createExpressionPhrases(expression) {
 }
 
 /**
- * @param {import('./parse-where-clause.types.ts').ParsedExpression} expression
+ * @param {import('../graph/parse-where-clause.types.ts').ParsedExpression} expression
  * @param {'and' | 'or'} operator
  * @param {boolean} should_prefix_operator
  * @returns {StoredQuerySegment[]}
@@ -139,7 +155,7 @@ function createExpressionPhrase(expression, operator, should_prefix_operator) {
 }
 
 /**
- * @param {import('./parse-where-clause.types.ts').ParsedExpression} expression
+ * @param {import('../graph/parse-where-clause.types.ts').ParsedExpression} expression
  * @param {number} parent_precedence
  * @returns {StoredQuerySegment[]}
  */
@@ -159,7 +175,7 @@ function createExpressionSegments(expression, parent_precedence) {
 }
 
 /**
- * @param {import('./parse-where-clause.types.ts').ParsedExpression} expression
+ * @param {import('../graph/parse-where-clause.types.ts').ParsedExpression} expression
  * @returns {StoredQuerySegment[]}
  */
 function createRawExpressionSegments(expression) {
@@ -202,7 +218,7 @@ function createRawExpressionSegments(expression) {
 }
 
 /**
- * @param {import('./parse-where-clause.types.ts').ParsedExpression} expression
+ * @param {import('../graph/parse-where-clause.types.ts').ParsedExpression} expression
  * @returns {number}
  */
 function getExpressionPrecedence(expression) {
@@ -230,7 +246,7 @@ function getBooleanExpressionPrecedence(operator) {
 }
 
 /**
- * @param {import('./parse-where-clause.types.ts').ParsedTerm} term
+ * @param {import('../graph/parse-where-clause.types.ts').ParsedTerm} term
  * @returns {StoredQuerySegment[]}
  */
 function createTermSegments(term) {
@@ -265,7 +281,7 @@ function createTermSegments(term) {
 }
 
 /**
- * @param {import('./parse-where-clause.types.ts').ParsedFieldSetTerm} term
+ * @param {import('../graph/parse-where-clause.types.ts').ParsedFieldSetTerm} term
  * @returns {StoredQuerySegment[]}
  */
 function createFieldSetSegments(term) {
@@ -281,7 +297,7 @@ function createFieldSetSegments(term) {
 }
 
 /**
- * @param {import('./parse-where-clause.types.ts').ParsedAggregateTerm} term
+ * @param {import('../graph/parse-where-clause.types.ts').ParsedAggregateTerm} term
  * @returns {StoredQuerySegment[]}
  */
 function createAggregateSegments(term) {

package/lib/{list-queries.js → output/list-queries.js}

@@ -1,17 +1,18 @@
 /**
- * @import { StoredQueryConfig } from './load-patram-config.types.ts';
+ * @import { StoredQueryConfig } from '../config/load-patram-config.types.ts';
  */
 
 /**
  * List stored queries in stable name order.
  *
  * @param {Record<string, StoredQueryConfig>} stored_queries
- * @returns {{ name: string, where: string }[]}
+ * @returns {{ name: string, where: string, description?: string }[]}
  */
 export function listQueries(stored_queries) {
   return Object.entries(stored_queries)
     .sort(([left_name], [right_name]) => left_name.localeCompare(right_name))
     .map(([name, stored_query]) => ({
+      description: stored_query.description,
       name,
       where: stored_query.where,
     }));

package/lib/{render-check-output.js → output/render-check-output.js}

@@ -1,5 +1,5 @@
 /**
- * @import { PatramDiagnostic } from './load-patram-config.types.ts';
+ * @import { PatramDiagnostic } from '../config/load-patram-config.types.ts';
  * @import { ResolvedOutputMode } from './output-view.types.ts';
  */
 

package/lib/{render-field-discovery.js → output/render-field-discovery.js}

@@ -1,6 +1,6 @@
 /**
  * @import { ResolvedOutputMode } from './output-view.types.ts';
- * @import { FieldDiscoveryResult, FieldDiscoverySuggestion } from './discover-fields.types.ts';
+ * @import { FieldDiscoveryResult, FieldDiscoverySuggestion } from '../scan/discover-fields.types.ts';
  */
 
 import { Ansis } from 'ansis';
@@ -135,7 +135,7 @@ function formatTextFieldSuggestion(field_suggestion, render_options) {
 
 /**
  * @param {string} section_title
- * @param {import('./discover-fields.types.ts').FieldDiscoveryEvidenceReference[]} evidence_references
+ * @param {import('../scan/discover-fields.types.ts').FieldDiscoveryEvidenceReference[]} evidence_references
  * @param {{ header: (value: string) => string, label: (value: string) => string }} render_options
  * @returns {string[]}
  */
@@ -168,7 +168,7 @@ function formatTextEvidenceSection(
 }
 
 /**
- * @param {import('./discover-fields.types.ts').FieldDiscoveryEvidenceReference} evidence_reference
+ * @param {import('../scan/discover-fields.types.ts').FieldDiscoveryEvidenceReference} evidence_reference
  * @returns {string}
  */
 function formatEvidenceReference(evidence_reference) {

package/lib/output/render-output-view.js

@@ -0,0 +1,56 @@
+/**
+ * @import { ParsedCliArguments } from '../cli/arguments.types.ts';
+ * @import { ResolvedOutputMode, OutputView } from './output-view.types.ts';
+ */
+
+import { renderJsonOutput } from './renderers/json.js';
+import { renderPlainOutput } from './renderers/plain.js';
+import { renderRichOutput } from './renderers/rich.js';
+
+/**
+ * Shared command output views.
+ *
+ * Normalizes `query`, `queries`, and `show` results into renderer-specific
+ * output models.
+ *
+ * Kind: output
+ * Status: active
+ * Tracked in: ../../docs/plans/v0/source-anchor-dogfooding.md
+ * Decided by: ../../docs/decisions/cli-output-architecture.md
+ * @patram
+ * @see {@link ./show-document.js}
+ * @see {@link ../../docs/decisions/cli-output-architecture.md}
+ */
+
+export {
+  createOutputView,
+  createRefsOutputView,
+  createShowOutputView,
+} from './view-model/index.js';
+
+/**
+ * Render one shared output view through the resolved renderer.
+ *
+ * @param {OutputView} output_view
+ * @param {ResolvedOutputMode} output_mode
+ * @param {ParsedCliArguments} parsed_arguments
+ * @returns {Promise<string>}
+ */
+export async function renderOutputView(
+  output_view,
+  output_mode,
+  parsed_arguments,
+) {
+  if (output_mode.renderer_name === 'json') {
+    return renderJsonOutput(output_view);
+  }
+
+  if (output_mode.renderer_name === 'plain') {
+    return renderPlainOutput(output_view);
+  }
+
+  return renderRichOutput(output_view, {
+    color_enabled: output_mode.color_enabled,
+    color_mode: parsed_arguments.color_mode,
+  });
+}

package/lib/{render-json-output.js → output/renderers/json.js}

@@ -1,5 +1,5 @@
 /**
- * @import { OutputNodeItem, OutputResolvedLinkItem, OutputStoredQueryItem, OutputView } from './output-view.types.ts';
+ * @import { OutputNodeItem, OutputResolvedLinkItem, OutputStoredQueryItem, OutputView } from '../output-view.types.ts';
  */
 
 /**
@@ -92,9 +92,6 @@ function renderJsonRefsOutput(output_view) {
 function renderJsonShowOutput(output_view) {
   return `${JSON.stringify(
     {
-      document: output_view.document
-        ? formatJsonNodeItem(output_view.document)
-        : undefined,
       incoming_summary: output_view.incoming_summary,
       source: output_view.source,
       resolved_links: output_view.items.map(formatJsonResolvedLink),
@@ -144,13 +141,20 @@ function formatJsonNodeItem(output_item) {
 
 /**
  * @param {OutputStoredQueryItem} output_item
- * @returns {{ name: string, where: string }}
+ * @returns {{ name: string, where: string, description?: string }}
  */
 function formatJsonStoredQuery(output_item) {
-  return {
+  /** @type {{ description?: string, name: string, where: string }} */
+  const stored_query = {
     name: output_item.name,
     where: output_item.where,
   };
+
+  if (output_item.description) {
+    stored_query.description = output_item.description;
+  }
+
+  return stored_query;
 }
 
 /**

package/lib/{render-plain-output.js → output/renderers/plain.js}

@@ -1,16 +1,16 @@
 /**
- * @import { OutputNodeItem, OutputResolvedLinkItem, OutputStoredQueryItem, OutputView, QueryOutputView, RefsOutputView, ShowOutputView } from './output-view.types.ts';
+ * @import { OutputNodeItem, OutputResolvedLinkItem, OutputStoredQueryItem, OutputView, QueryOutputView, RefsOutputView, ShowOutputView } from '../output-view.types.ts';
  */
 
 import {
   formatOutputNodeMetadataRows,
   formatResolvedLinkMetadataRows,
-} from './format-output-metadata.js';
-import { formatNodeHeader } from './format-node-header.js';
-import { formatOutputItemBlock } from './format-output-item-block.js';
-import { layoutIncomingReferenceLines } from './layout-incoming-references.js';
-import { layoutIncomingSummaryLines } from './layout-incoming-summary-lines.js';
-import { layoutStoredQueries } from './layout-stored-queries.js';
+} from '../format-output-metadata.js';
+import { formatNodeHeader } from '../format-node-header.js';
+import { formatOutputItemBlock } from '../format-output-item-block.js';
+import { layoutIncomingReferenceLines } from '../layout-incoming-references.js';
+import { layoutIncomingSummaryLines } from '../layout-incoming-summary-lines.js';
+import { layoutStoredQueries } from '../layout-stored-queries.js';
 
 /**
  * Render the canonical plain output for one output view.
@@ -24,7 +24,7 @@ export function renderPlainOutput(output_view) {
   }
 
   if (output_view.command === 'queries') {
-    return renderPlainStoredQueries(output_view.items);
+    return renderPlainStoredQueries(output_view);
   }
 
   if (output_view.command === 'refs') {
@@ -69,17 +69,23 @@ function renderPlainEmptyQuery(footer) {
 }
 
 /**
- * @param {OutputStoredQueryItem[]} output_items
+ * @param {Extract<OutputView, { command: 'queries' }>} output_view
  * @returns {string}
  */
-function renderPlainStoredQueries(output_items) {
-  if (output_items.length === 0) {
+function renderPlainStoredQueries(output_view) {
+  if (output_view.items.length === 0) {
     return '';
   }
 
-  return `${layoutStoredQueries(output_items)
-    .map(formatPlainStoredQueryLine)
-    .join('\n')}\n`;
+  const output_lines = layoutStoredQueries(output_view.items).map(
+    formatPlainStoredQueryLine,
+  );
+
+  if (output_view.hints.length === 0) {
+    return `${output_lines.join('\n')}\n`;
+  }
+
+  return `${output_lines.join('\n')}\n${output_view.hints.join('\n')}\n`;
 }
 
 /**
@@ -88,29 +94,12 @@ function renderPlainStoredQueries(output_items) {
  */
 function renderPlainShowOutput(output_view) {
   const rendered_source = trimTrailingLineBreaks(output_view.rendered_source);
-  const document_summary = output_view.document
-    ? formatPlainNodeItem(output_view.document)
-    : '';
   const incoming_summary = renderPlainIncomingSummary(output_view);
 
-  if (
-    document_summary.length === 0 &&
-    output_view.items.length === 0 &&
-    incoming_summary.length === 0
-  ) {
+  if (output_view.items.length === 0 && incoming_summary.length === 0) {
     return `${rendered_source}\n`;
   }
-
-  /** @type {string[]} */
-  const summary_items = [];
-
-  if (document_summary.length > 0) {
-    summary_items.push(document_summary);
-  }
-
-  summary_items.push(...output_view.items.map(formatPlainResolvedLinkItem));
-
-  const summary_blocks = summary_items.filter((summary_item) => summary_item);
+  const summary_blocks = output_view.items.map(formatPlainResolvedLinkItem);
 
   if (incoming_summary.length > 0) {
     summary_blocks.push(incoming_summary);
@@ -172,12 +161,24 @@ function formatPlainResolvedLinkItem(output_item) {
  * @returns {string}
  */
 function renderPlainIncomingSummary(output_view) {
+  if (!hasIncomingSummary(output_view.incoming_summary)) {
+    return '';
+  }
+
   const output_lines = layoutIncomingSummaryLines(output_view.incoming_summary);
   output_lines.push('', `Hint: patram refs ${output_view.path}`);
 
   return output_lines.join('\n');
 }
 
+/**
+ * @param {Record<string, number>} incoming_summary
+ * @returns {boolean}
+ */
+function hasIncomingSummary(incoming_summary) {
+  return Object.keys(incoming_summary).length > 0;
+}
+
 /**
  * @param {string} value
  * @returns {string}

package/lib/{render-rich-output.js → output/renderers/rich.js}

@@ -1,6 +1,6 @@
 /**
- * @import { CliColorMode } from './parse-cli-arguments.types.ts';
- * @import { OutputNodeItem, OutputResolvedLinkItem, OutputStoredQueryItem, OutputView, QueryOutputView, RefsOutputView, ShowOutputView } from './output-view.types.ts';
+ * @import { CliColorMode } from '../../cli/arguments.types.ts';
+ * @import { OutputNodeItem, OutputResolvedLinkItem, OutputStoredQueryItem, OutputView, QueryOutputView, RefsOutputView, ShowOutputView } from '../output-view.types.ts';
  */
 
 import { Ansis } from 'ansis';
@@ -8,13 +8,13 @@ import { Ansis } from 'ansis';
 import {
   formatOutputNodeMetadataRows,
   formatResolvedLinkMetadataRows,
-} from './format-output-metadata.js';
-import { formatNodeHeader } from './format-node-header.js';
-import { formatOutputItemBlock } from './format-output-item-block.js';
-import { layoutIncomingReferenceLines } from './layout-incoming-references.js';
-import { layoutIncomingSummaryLines } from './layout-incoming-summary-lines.js';
-import { layoutStoredQueries } from './layout-stored-queries.js';
-import { renderRichSource } from './render-rich-source.js';
+} from '../format-output-metadata.js';
+import { formatNodeHeader } from '../format-node-header.js';
+import { formatOutputItemBlock } from '../format-output-item-block.js';
+import { layoutIncomingReferenceLines } from '../layout-incoming-references.js';
+import { layoutIncomingSummaryLines } from '../layout-incoming-summary-lines.js';
+import { layoutStoredQueries } from '../layout-stored-queries.js';
+import { renderRichSource } from '../rich-source/render.js';
 
 const FULL_WIDTH_DIVIDER = ` ${'─'.repeat(78)} `;
 
@@ -33,7 +33,7 @@ export async function renderRichOutput(output_view, render_options) {
   }
 
   if (output_view.command === 'queries') {
-    return renderRichStoredQueries(output_view.items, ansi);
+    return renderRichStoredQueries(output_view, ansi);
   }
 
   if (output_view.command === 'refs') {
@@ -83,18 +83,24 @@ function renderRichEmptyQuery(footer, ansi) {
 }
 
 /**
- * @param {OutputStoredQueryItem[]} output_items
+ * @param {Extract<OutputView, { command: 'queries' }>} output_view
  * @param {Ansis} ansi
  * @returns {string}
  */
-function renderRichStoredQueries(output_items, ansi) {
-  if (output_items.length === 0) {
+function renderRichStoredQueries(output_view, ansi) {
+  if (output_view.items.length === 0) {
     return '';
   }
 
-  return `${layoutStoredQueries(output_items)
-    .map((line_segments) => formatRichStoredQueryLine(line_segments, ansi))
-    .join('\n')}\n`;
+  const output_lines = layoutStoredQueries(output_view.items).map(
+    (line_segments) => formatRichStoredQueryLine(line_segments, ansi),
+  );
+
+  if (output_view.hints.length === 0) {
+    return `${output_lines.join('\n')}\n`;
+  }
+
+  return `${output_lines.join('\n')}\n${output_view.hints.map((hint) => ansi.gray(hint)).join('\n')}\n`;
 }
 
 /**
@@ -107,20 +113,14 @@ async function renderRichShowOutput(output_view, render_options, ansi) {
   const rendered_source = trimTrailingLineBreaks(
     await renderRichSource(output_view, render_options),
   );
-  const document_summary = output_view.document
-    ? formatRichNodeItem(output_view.document, ansi)
-    : '';
   const incoming_summary = renderRichIncomingSummary(output_view, ansi);
 
-  /** @type {string[]} */
-  const summary_items = [];
-
-  if (document_summary.length > 0) {
-    summary_items.push(document_summary);
+  if (output_view.items.length === 0 && incoming_summary.length === 0) {
+    return `${rendered_source}\n`;
   }
 
-  summary_items.push(
-    ...output_view.items.map((item) => formatRichResolvedLinkItem(item, ansi)),
+  const summary_items = output_view.items.map((item) =>
+    formatRichResolvedLinkItem(item, ansi),
   );
 
   if (incoming_summary.length > 0) {
@@ -165,7 +165,7 @@ function formatRichNodeItem(output_item, ansi) {
 }
 
 /**
- * @param {{ kind: 'field_name' | 'keyword' | 'literal' | 'name' | 'operator' | 'plain', text: string }[]} line_segments
+ * @param {{ kind: 'description' | 'field_name' | 'keyword' | 'literal' | 'name' | 'operator' | 'plain', text: string }[]} line_segments
  * @param {Ansis} ansi
  * @returns {string}
  */
@@ -195,18 +195,26 @@ function formatRichResolvedLinkItem(output_item, ansi) {
  * @returns {string}
  */
 function renderRichIncomingSummary(output_view, ansi) {
+  if (!hasIncomingSummary(output_view.incoming_summary)) {
+    return '';
+  }
+
   const output_lines = layoutIncomingSummaryLines(output_view.incoming_summary);
   output_lines[0] = ansi.bold(output_lines[0]);
 
-  if (Object.keys(output_view.incoming_summary).length === 0) {
-    output_lines[1] = `  ${ansi.gray('none')}`;
-  }
-
   output_lines.push('', ansi.gray(`Hint: patram refs ${output_view.path}`));
 
   return output_lines.join('\n');
 }
 
+/**
+ * @param {Record<string, number>} incoming_summary
+ * @returns {boolean}
+ */
+function hasIncomingSummary(incoming_summary) {
+  return Object.keys(incoming_summary).length > 0;
+}
+
 /**
  * @param {boolean} color_enabled
  * @returns {Ansis}
@@ -216,7 +224,7 @@ function createAnsi(color_enabled) {
 }
 
 /**
- * @param {{ kind: 'field_name' | 'keyword' | 'literal' | 'name' | 'operator' | 'plain', text: string }} line_segment
+ * @param {{ kind: 'description' | 'field_name' | 'keyword' | 'literal' | 'name' | 'operator' | 'plain', text: string }} line_segment
  * @param {Ansis} ansi
  * @returns {string}
  */
@@ -225,6 +233,10 @@ function styleStoredQuerySegment(line_segment, ansi) {
     return ansi.green(line_segment.text);
   }
 
+  if (line_segment.kind === 'description') {
+    return ansi.gray(line_segment.text);
+  }
+
   if (line_segment.kind === 'operator') {
     return ansi.gray(line_segment.text);
   }

package/lib/{resolve-check-target.js → output/resolve-check-target.js}

@@ -1,5 +1,5 @@
 /**
- * @import { PatramDiagnostic } from './load-patram-config.types.ts';
+ * @import { PatramDiagnostic } from '../config/load-patram-config.types.ts';
  */
 import { access, stat } from 'node:fs/promises';
 import { dirname, relative, resolve } from 'node:path';

package/lib/{render-rich-source.js → output/rich-source/render.js}

@@ -2,8 +2,8 @@
 /**
  * @import { ComarkElement, ComarkNode } from 'md4x';
  * @import { BundledLanguage } from 'shiki';
- * @import { CliColorMode } from './parse-cli-arguments.types.ts';
- * @import { OutputResolvedLinkItem, ShowOutputView } from './output-view.types.ts';
+ * @import { CliColorMode } from '../../cli/arguments.types.ts';
+ * @import { OutputResolvedLinkItem, ShowOutputView } from '../output-view.types.ts';
  */
 
 import { extname } from 'node:path';
@@ -969,8 +969,8 @@ function shouldRenderListItemGap(previous_item, next_item, has_blank_line_gap) {
   }
 
   return (
-    isSimpleTopLevelListItem(previous_item) &&
-    isSimpleTopLevelListItem(next_item)
+    isSingleParagraphTopLevelListItem(previous_item) &&
+    isSingleParagraphTopLevelListItem(next_item)
   );
 }
 
@@ -978,7 +978,7 @@ function shouldRenderListItemGap(previous_item, next_item, has_blank_line_gap) {
  * @param {ComarkElement} item_node
  * @returns {boolean}
  */
-function isSimpleTopLevelListItem(item_node) {
+function isSingleParagraphTopLevelListItem(item_node) {
   const item_children = getElementChildren(item_node);
 
   if (item_children.length !== 1) {
@@ -994,7 +994,7 @@ function isSimpleTopLevelListItem(item_node) {
     return false;
   }
 
-  return !extractInlineText(getElementChildren(paragraph_node)).includes('\n');
+  return true;
 }
 
 /**

package/lib/{show-document.js → output/show-document.js}

@@ -1,16 +1,16 @@
 /* eslint-disable max-lines */
 /**
- * @import { BuildGraphResult, GraphNode } from './build-graph.types.ts';
- * @import { PatramClaim } from './parse-claims.types.ts';
- * @import { PatramDiagnostic } from './load-patram-config.types.ts';
+ * @import { BuildGraphResult, GraphNode } from '../graph/build-graph.types.ts';
+ * @import { PatramClaim } from '../parse/parse-claims.types.ts';
+ * @import { PatramDiagnostic } from '../config/load-patram-config.types.ts';
  */
 
 import { readFile } from 'node:fs/promises';
 import { posix, relative, resolve } from 'node:path';
 
-import { resolveDocumentNodeId } from './build-graph-identity.js';
-import { inspectReverseReferences } from './inspect-reverse-references.js';
-import { parseSourceFile } from './parse-claims.js';
+import { resolveDocumentNodeId } from '../graph/build-graph-identity.js';
+import { inspectReverseReferences } from '../graph/inspect-reverse-references.js';
+import { parseSourceFile } from '../parse/parse-claims.js';
 
 /**
  * Show command document rendering.
@@ -20,12 +20,12 @@ import { parseSourceFile } from './parse-claims.js';
  *
  * Kind: output
  * Status: active
- * Tracked in: ../docs/plans/v0/source-anchor-dogfooding.md
- * Decided by: ../docs/decisions/show-output.md
- * Decided by: ../docs/decisions/source-rendering.md
+ * Tracked in: ../../docs/plans/v0/source-anchor-dogfooding.md
+ * Decided by: ../../docs/decisions/show-output.md
+ * Decided by: ../../docs/decisions/source-rendering.md
  * @patram
  * @see {@link ./render-output-view.js}
- * @see {@link ../docs/decisions/show-output.md}
+ * @see {@link ../../docs/decisions/show-output.md}
  */
 
 /**
@@ -107,7 +107,7 @@ export async function loadShowOutput(
  * @param {string} source_text
  * @param {PatramClaim[]} claims
  * @param {BuildGraphResult} graph
- * @param {import('./build-graph.types.ts').BuildGraphResult['document_node_ids']} document_node_ids
+ * @param {import('../graph/build-graph.types.ts').BuildGraphResult['document_node_ids']} document_node_ids
  * @param {Record<string, GraphNode>} graph_nodes
  * @returns {{ incoming_summary: Record<string, number>, path: string, rendered_source: string, resolved_links: Array<{ label: string, reference: number, target: { kind?: string, path: string, status?: string, title: string } }>, source: string }}
  */
@@ -219,7 +219,7 @@ function renderResolvedSourceLine(
  * @param {string} source_file_path
  * @param {PatramClaim} claim
  * @param {number} reference
- * @param {import('./build-graph.types.ts').BuildGraphResult['document_node_ids']} document_node_ids
+ * @param {import('../graph/build-graph.types.ts').BuildGraphResult['document_node_ids']} document_node_ids
  * @param {Record<string, GraphNode>} graph_nodes
  * @returns {{ label: string, reference: number, target: { kind?: string, path: string, status?: string, title: string } }}
  */