@quolu/lattice 0.48.0 → 0.49.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quolu/lattice",
-  "version": "0.48.0",
+  "version": "0.49.0",
   "description": "Schedulability compiler for multi-agent development: observe real code boundaries, refactor the conflicting seam, recompile the plan for parallel execution",
   "author": {
     "name": "Quo / クオ at kitepon.dev",

package/src/cli-help.mjs

@@ -75,6 +75,7 @@ Read commands:
 
 Write commands:
   dashboard adopt --json  # 衝突したproject_idの配信元rootを現在repoへ明示的に移す
+  dashboard remove <project_id> --json  # 登録簿から1件外す（対象repoの外からも叩ける）
   note --plan <key> [--task <id>] (--message <text>|--input <file>)
       # ToDoへ作業継続に必要な方針・調査結果・注意をappend-onlyで追記する
   migrate --input <extraction.json> [--serialization-reviewed]
@@ -200,8 +201,10 @@ const SUBCOMMAND_USAGE = Object.freeze({
   'todo snapshot': 'todo snapshot --rebuild --plan <key>',
   'todo gantt': 'todo gantt serve --port <port> [--scope live|all]  # 動的表示のみ。静的HTML生成は廃止',
   'todo gantt serve': 'todo gantt serve --port <0..65535> [--scope live|all]  # loopback動的viewer',
-  'todo dashboard': 'todo dashboard adopt --json  # 配信元rootの衝突を明示的に解消',
+  'todo dashboard': 'todo dashboard adopt --json | remove <project_id> --json'
+    + '  # 配信元rootの衝突を明示的に解消／登録簿から1件外す',
   'todo dashboard adopt': 'todo dashboard adopt --json  # 現在repoをproject_idの配信元として明示採用',
+  'todo dashboard remove': 'todo dashboard remove <project_id> --json  # 登録簿から1件外す（対象repo不在でも可）',
   'todo phase': 'todo phase <status|review|accept|reject|reopen|close-unaudited> --plan <key> [options]'
     + ' | baseline --reason <text> [--except <plan_key>]...',
   'todo phase status': 'todo phase status --plan <key>',

package/src/todo-cli.mjs

@@ -25,6 +25,7 @@ import { projectTodoChainV1 } from './todo-chain.mjs';
 import {
   adoptTodoDashboardActivity,
   ensureTodoDashboardActivity,
+  removeTodoDashboardProject,
 } from './todo-dashboard-registry.mjs';
 import { resolveProjectIdentity } from './project-identity.mjs';
 import { layoutTodoGantt } from './todo-gantt-layout.mjs';
@@ -2568,6 +2569,30 @@ export async function runTodoCli({ argv, cwd, stdout, stderr, env = process.env
     }
   }
 
+  // 登録を外したいprojectのrepoは、もう存在しないことが普通である（それが外す理由になる）。
+  // 通常dispatchより前に処理し、repoRoot解決・store読取・dashboard daemon起動を経由させない。
+  if (argv.length === 4 && argv[0] === 'dashboard' && argv[1] === 'remove'
+    && isTodoIdentifier(argv[2]) && argv[3] === '--json') {
+    try {
+      await removeTodoDashboardProject({ projectId: argv[2], env });
+      const result = {
+        schema: 'lattice.todo_dashboard_remove_result.v1',
+        project_id: argv[2],
+        removed: true,
+        result_digest: '',
+      };
+      result.result_digest = todoSelfDigest(result, 'result_digest');
+      stdout.write(`${JSON.stringify(result)}\n`);
+      return 0;
+    } catch (error) {
+      if (typeof error?.code === 'string' && error.detail !== null
+        && typeof error.detail === 'object') return typedFailure(stderr, error);
+      return typedFailure(stderr, {
+        code: 'INTERNAL_FAILURE', message: error?.constructor?.name ?? 'Error',
+      });
+    }
+  }
+
   let action = null;
   if ((argv.length === 1 && argv[0] === 'status')
     || (argv.length === 2 && argv[0] === 'status' && argv[1] === '--json')) {

package/src/todo-dashboard-registry.mjs

@@ -2,7 +2,7 @@ import { spawn } from 'node:child_process';
 import { randomBytes } from 'node:crypto';
 import { homedir } from 'node:os';
 import {
-  mkdir, open, readdir, readFile, realpath, rename, rm, writeFile,
+  mkdir, open, readdir, readFile, realpath, rename, rm, stat, writeFile,
 } from 'node:fs/promises';
 import path from 'node:path';
 
@@ -157,6 +157,17 @@ export async function readVisibleTodoDashboardProjects({
     || left.project_id.localeCompare(right.project_id, 'en'));
 }
 
+/**
+ * 見るのはrepo_root directoryの存在だけ。`.lattice`の有無で判定すると、storeを持たない
+ * 生きたrepoまで登録簿から消える。ENOENT／ENOTDIR以外のerrorは「消えた証拠」ではないので
+ * 生存扱いのまま残す——判定できない相手を消す方が損害が大きい。
+ */
+async function repoRootPresent(ref) {
+  try { return (await stat(ref)).isDirectory(); } catch (error) {
+    return !['ENOENT', 'ENOTDIR'].includes(error?.code);
+  }
+}
+
 export async function registerTodoDashboardActivity({
   repoRoot, projectId, displayName = projectId, sessionId, env = process.env,
   now = new Date(), adopt = false,
@@ -169,6 +180,7 @@ export async function registerTodoDashboardActivity({
   const canonicalRoot = await realpath(repoRoot);
   const refs = paths(env);
   await mkdir(refs.root, { recursive: true, mode: 0o700 });
+  const pruned = [];
   await withLock(refs.lock, async () => {
     const current = validateRegistry(await readJson(refs.registry, { schema: REGISTRY_SCHEMA, projects: [] }));
     const existing = current.projects.find((entry) => entry.project_id === projectId);
@@ -183,13 +195,45 @@ export async function registerTodoDashboardActivity({
       };
       throw error;
     }
-    const projects = current.projects.filter((entry) => entry.project_id !== projectId);
+    // 死んだ登録を落とす機会はここしかない。登録は全sessionが必ず通る一点であり、
+    // 掃除を「人がコマンドを叩いた時」に置くと、誰も叩かないので永久に積み上がる。
+    const projects = [];
+    for (const entry of current.projects) {
+      if (entry.project_id === projectId) continue;
+      if (await repoRootPresent(entry.repo_root)) projects.push(entry);
+      else pruned.push(entry.project_id);
+    }
     projects.push({ project_id: projectId, display_name: displayName, repo_root: canonicalRoot,
       session_id: sessionId, last_seen_at: now.toISOString() });
     projects.sort((left, right) => left.project_id.localeCompare(right.project_id, 'en'));
+    pruned.sort((left, right) => left.localeCompare(right, 'en'));
+    await atomicJson(refs.registry, { schema: REGISTRY_SCHEMA, projects });
+  });
+  return { projectId, displayName, repoRoot: canonicalRoot, sessionId, adopted: adopt, pruned };
+}
+
+/**
+ * 登録簿から1件を明示的に外す唯一の入口。対象repoが既に消えていても叩けるよう、
+ * storeもdaemonも経由しない。該当が無いのは暗黙の成功にしない——「消したつもり」で
+ * 別のproject_idが残り続ける状態を、成功の応答で隠すことになる。
+ */
+export async function removeTodoDashboardProject({ projectId, env = process.env }) {
+  if (!identifier(projectId)) throw new TypeError('dashboard project id is invalid');
+  const refs = paths(env);
+  await mkdir(refs.root, { recursive: true, mode: 0o700 });
+  await withLock(refs.lock, async () => {
+    const current = validateRegistry(await readJson(refs.registry, { schema: REGISTRY_SCHEMA, projects: [] }));
+    const projects = current.projects.filter((entry) => entry.project_id !== projectId);
+    if (projects.length === current.projects.length) {
+      const error = new Error('dashboard project is not registered');
+      error.code = 'PROJECT_NOT_REGISTERED';
+      // 公開・CLI errorへlocal absolute pathを運ばない。project_idだけで対象を特定できる。
+      error.detail = { project_id: projectId };
+      throw error;
+    }
     await atomicJson(refs.registry, { schema: REGISTRY_SCHEMA, projects });
   });
-  return { projectId, displayName, repoRoot: canonicalRoot, sessionId, adopted: adopt };
+  return { projectId, removed: true };
 }
 
 /** 配信元rootを移す唯一の明示入口。通常activity登録はこのflagを立てない。 */