@quolu/lattice 0.12.18 → 0.12.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quolu/lattice",
-  "version": "0.12.18",
+  "version": "0.12.20",
   "description": "Lattice — phase-aware TODO graph compiler and conflict-aware orchestration runtime",
   "type": "module",
   "license": "MIT",

package/src/todo-gantt-html.mjs

@@ -1,12 +1,9 @@
 import { createHash } from 'node:crypto';
 
-import {
-  renderTodoMarkdownDocument,
-  serializeJsonForScript,
-} from './todo-markdown-renderer.mjs';
+import { serializeJsonForScript } from './todo-markdown-renderer.mjs';
 import { renderTodoGanttSvg, TODO_GANTT_STATUS_PRESENTATION } from './todo-gantt-svg.mjs';
 
-export const TODO_GANTT_RENDERER_VERSION = 'lattice.todo_gantt_renderer.v14';
+export const TODO_GANTT_RENDERER_VERSION = 'lattice.todo_gantt_renderer.v16';
 export const TODO_GANTT_PROSE_MAX_BYTES = 8 * 1024 * 1024;
 export const TODO_GANTT_HTML_MAX_BYTES = 24 * 1024 * 1024;
 
@@ -46,22 +43,29 @@ function refKey(ref) {
   return JSON.stringify([ref.project_id, ref.plan_key, ref.task_id]);
 }
 
-function digest(value) {
-  return createHash('sha256').update(value, 'utf8').digest('hex');
+function compareText(left, right) {
+  return left < right ? -1 : left > right ? 1 : 0;
 }
 
-// The Markdown renderer deliberately permits safe web links for its standalone API.
-// A self-contained gantt permits fragments only, so its known allow-list output is de-linked here.
-function removeNavigation(markup) {
-  return markup.replace(/<a href="[^"]*"(?: title="[^"]*")?>/gu, '<span class="deactivated-link">')
-    .replaceAll('</a>', '</span>');
+function digest(value) {
+  return createHash('sha256').update(value, 'utf8').digest('hex');
 }
 
+/**
+ * Sections carry one row per ToDo, plus the prose accounting for the narratives
+ * behind them.
+ *
+ * The right pane shows the store, not the Markdown: per the 2026-07-19 ruling
+ * the "全工程" list is the plan rendered from the ToDo store, and the original
+ * documents are reached through each ToDo's source reference. The narratives are
+ * still read, because anchor verification needs them, and their size is still
+ * bounded — but they are not rendered into the page.
+ */
 function normalizeSections(readModel, narratives, anchorOutcomes) {
   const supplied = new Map(narratives.map((entry) => [refKey(entry.ref), entry]));
   const outcomes = new Map(anchorOutcomes.map((entry) => [refKey(entry.ref), entry]));
   const result = [];
-  const documents = new Map();
+  const counted = new Set();
   let proseBytes = 0;
   for (const member of readModel.members) {
     const states = new Map(member.tasks.map((state) => [state.task_id, state]));
@@ -70,57 +74,23 @@ function normalizeSections(readModel, narratives, anchorOutcomes) {
       const narrative = supplied.get(refKey(ref));
       const markdown = narrative?.markdown ?? '';
       const narrativeRef = narrative?.narrative_ref ?? task.narrative_ref;
+      // ToDos that share one narrative document count its bytes once.
       const documentKey = narrativeRef === null
         ? refKey(ref) : JSON.stringify([member.plan.plan_key, narrativeRef, digest(markdown)]);
-      let document = documents.get(documentKey);
-      if (document === undefined) {
+      if (!counted.has(documentKey)) {
+        counted.add(documentKey);
         proseBytes += Buffer.byteLength(markdown, 'utf8');
         if (proseBytes > TODO_GANTT_PROSE_MAX_BYTES) {
           throw new TodoGanttRenderError('TODO_SCALE_EXCEEDED', 'todo gantt embedded prose limit exceeded', {
             prose_bytes: proseBytes, prose_limit: TODO_GANTT_PROSE_MAX_BYTES,
           });
         }
-        document = { markdown, narrativeRef, tasks: [], rendered: '' };
-        documents.set(documentKey, document);
       }
       const anchorOutcome = outcomes.get(refKey(ref)) ?? {
         ref, narrative_ref: narrativeRef, anchored: false, reason: 'anchor_missing',
         origin_line: task.narrative_anchor?.origin_line ?? null,
       };
-      const section = {
-        ref, task, state: states.get(task.task_id), documentKey, narrativeRef, anchorOutcome, document,
-      };
-      document.tasks.push(section);
-      result.push(section);
-    }
-  }
-  for (const document of documents.values()) {
-    const taskStatesByLine = new Map();
-    for (const section of document.tasks) {
-      if (!section.anchorOutcome.anchored) continue;
-      const status = DOCUMENT_STATUS[section.state.status] ?? { mark: '?', label: '状態不明' };
-      taskStatesByLine.set(section.anchorOutcome.origin_line, {
-        status: section.state.status,
-        mark: status.mark,
-        label: status.label,
-        narrativeKey: refKey(section.ref),
-        blockedReason: section.state.blocked_reason,
-      });
-    }
-    try {
-      document.rendered = removeNavigation(renderTodoMarkdownDocument(
-        document.markdown,
-        { taskStatesByLine },
-      ).html);
-    } catch (error) {
-      if (error?.code === 'TODO_MARKDOWN_SECTION_TOO_LARGE') {
-        throw new TodoGanttRenderError('TODO_SCALE_EXCEEDED', 'todo gantt narrative section limit exceeded', {
-          narrative_ref: document.narrativeRef,
-          prose_section_bytes: error.detail.actual_bytes,
-          prose_section_limit: error.detail.maximum_bytes,
-        });
-      }
-      throw error;
+      result.push({ ref, task, state: states.get(task.task_id), narrativeRef, anchorOutcome });
     }
   }
   return { sections: result, proseBytes };
@@ -142,16 +112,37 @@ function renderTaskIndexEntry(section, lookup) {
   return `<li><button type="button" data-select-node-key="${escapeHtmlAttribute(selectKey)}"><span class="task-index-status status-${escapeHtmlAttribute(section.state.status)}" role="img" aria-label="${escapeHtmlAttribute(status.label)}">${escapeHtmlText(status.mark)}</span><span class="task-index-reference">${escapeHtmlText(taskReference(section, lookup))}</span><strong>${escapeHtmlText(section.task.title)}</strong>${blockedReason}</button></li>`;
 }
 
-function renderTaskIndex(sections, lookup, folds = new Set()) {
-  const plans = [];
+/** plan_key -> 最終活動時刻。journalの末尾eventが、そのplanが最後に動いた時点。 */
+function planActivity(readModel) {
+  return new Map((readModel?.members ?? []).map((member) => {
+    const events = member.journal?.events ?? [];
+    const last = events.at(-1)?.recorded_at ?? events[0]?.recorded_at ?? '';
+    return [member.plan.plan_key, last];
+  }));
+}
+
+function renderTaskIndex(sections, lookup, folds = new Set(), activity = new Map()) {
+  const byPlan = new Map();
   for (const section of sections) {
-    let plan = plans.at(-1);
-    if (plan === undefined || plan.planKey !== section.ref.plan_key) {
-      plan = { planKey: section.ref.plan_key, tasks: [] };
-      plans.push(plan);
-    }
-    plan.tasks.push(section);
+    if (!byPlan.has(section.ref.plan_key)) byPlan.set(section.ref.plan_key, []);
+    byPlan.get(section.ref.plan_key).push(section);
   }
+  // 全ToDoが図から外れたplanは終わった仕事。読む側が先に見たいのは動いているplanなので、
+  // 動いているものを最終活動の新しい順で上へ、終わったものを古い順で下へまとめる。
+  // plan内のToDo順は登録順のまま触らない。
+  const plans = [...byPlan.entries()].map(([planKey, tasks]) => ({
+    planKey,
+    tasks,
+    settled: tasks.every((section) => folds.has(refKey(section.ref))),
+    lastActivity: activity.get(planKey) ?? '',
+  }));
+  plans.sort((left, right) => {
+    if (left.settled !== right.settled) return left.settled ? 1 : -1;
+    const order = left.settled
+      ? compareText(left.lastActivity, right.lastActivity)
+      : compareText(right.lastActivity, left.lastActivity);
+    return order !== 0 ? order : compareText(left.planKey, right.planKey);
+  });
   return plans.map((plan) => {
     const drawn = plan.tasks.filter((section) => !folds.has(refKey(section.ref)));
     const folded = plan.tasks.filter((section) => folds.has(refKey(section.ref)));
@@ -281,8 +272,8 @@ function renderRightPane(sections, layout, presentation, readModel) {
       : '<p class="fold-note">完走済みのため図には描いていません。図に出すには <code>lattice todo gantt --scope all</code> を実行してください。</p>';
     return `<article class="task-detail" data-detail-key="${escapeHtmlAttribute(key)}" hidden><header><span class="detail-status status-${escapeHtmlAttribute(section.state.status)}">${escapeHtmlText(status.mark)} ${escapeHtmlText(status.label)}</span><span class="detail-reference">${escapeHtmlText(taskReference(section, lookup))}</span></header><h1>${escapeHtmlText(section.task.title)}</h1><p class="detail-category"><strong>カテゴリ:</strong> ${escapeHtmlText(category)}</p>${categoryDescription}<p><strong>正規ID:</strong> <code>${escapeHtmlText(`${section.ref.plan_key}/${section.task.task_id}`)}</code></p>${blockedReason}${readiness}${foldedNote}<section><h2>前提工程</h2>${renderRelationList(incoming.get(key), sectionByKey, lookup, '登録済みの前提工程はありません。', folds)}</section><section><h2>後続工程</h2>${renderRelationList(outgoing.get(key), sectionByKey, lookup, '登録済みの後続工程はありません。', folds)}</section><p class="anchor-status">${escapeHtmlText(anchorText)}</p><details class="task-diagnostics"><summary>開発者向け診断</summary><dl><dt>canonical ref</dt><dd><code>${escapeHtmlText(`${section.ref.project_id}/${section.ref.plan_key}/${section.task.task_id}`)}</code></dd><dt>anchor</dt><dd>${escapeHtmlText(section.anchorOutcome.anchored ? 'verified' : section.anchorOutcome.reason)}</dd></dl></details></article>`;
   }).join('');
-  const taskIndex = renderTaskIndex(sections, lookup, folds);
-  return `<div class="right-toolbar"><button type="button" data-show-overview>概要</button><button type="button" data-show-selected hidden>選択工程へ戻る</button><button type="button" data-show-task-index>元Markdown全文</button></div><div class="right-content">${overview}<div data-right-panel="details" hidden>${details}</div><section class="task-index" data-right-panel="task-index" hidden><h1>全工程</h1><p>Latticeに登録された全工程を、現在の状態とともに登録順で表示しています。</p>${taskIndex}</section></div>`;
+  const taskIndex = renderTaskIndex(sections, lookup, folds, planActivity(readModel));
+  return `<div class="right-toolbar"><button type="button" data-show-overview>概要</button><button type="button" data-show-selected hidden>選択工程へ戻る</button><button type="button" data-show-task-index>全工程一覧</button></div><div class="right-content">${overview}<div data-right-panel="details" hidden>${details}</div><section class="task-index" data-right-panel="task-index" hidden><h1>全工程</h1><p>Latticeに登録された全工程を現在の状態とともに表示しています。planは動いているものを最終活動の新しい順で上に、完走したものを古い順で下にまとめ、plan内は登録順です。</p>${taskIndex}</section></div>`;
 }
 
 function renderDiagramLegend(presentation, layout = null, expandable = false) {