@quolu/lattice 0.59.0 → 0.60.0

package/src/todo-structure-store.mjs

@@ -18,6 +18,7 @@ import {
   readTodoStructureFinalization,
   readTodoStructureRealizationChain,
   readTodoStructureSource,
+  todoStructureSourceRef,
 } from './todo-store.mjs';
 
 const SHA = /^[0-9a-f]{40}$/u;
@@ -373,6 +374,33 @@ export async function readTodoStructureFinalizationsForStatus(options = {}) {
   return entries.sort((left, right) => compareText(left.plan_key, right.plan_key));
 }
 
+/**
+ * 既存のstructure input writerで直せるplanned sourceの破損だけを診断する。
+ * binding／compile／finalizationは同writerでは直せないため、ここで修理可能と
+ * 偽って案内しない。
+ */
+export async function readTodoStructureArtifactDiagnostics(options = {}) {
+  const repoRoot = options.repoRoot ?? process.cwd();
+  const store = options.store ?? await readTodoStore({ repoRoot, now: options.now });
+  const diagnostics = [];
+  for (const member of store.members) {
+    const planKey = member.plan.plan_key;
+    try {
+      await readTodoStructureSource({ repoRoot, planKey });
+    } catch (error) {
+      if (error?.code !== 'INVALID_TODO_STRUCTURE_SET') throw error;
+      const reason = error?.detail?.reason ?? error?.message ?? 'structure_artifact_invalid';
+      diagnostics.push({
+        plan_key: planKey,
+        artifact_path: todoStructureSourceRef(planKey),
+        reason,
+        next_command: `lattice todo structure input --plan ${planKey} --input <corrected-structure-set.json> --json`,
+      });
+    }
+  }
+  return diagnostics;
+}
+
 function validateTaskMigration(taskMigration) {
   if (!Array.isArray(taskMigration) || taskMigration.length === 0) {
     fail('STRUCTURE_MIGRATION_INVALID', 'task_migration_missing');