@swarmvaultai/engine 0.6.0 → 0.6.2

package/dist/index.js

@@ -21,7 +21,7 @@ import {
   uniqueBy,
   writeFileIfChanged,
   writeJsonFile
-} from "./chunk-FD3LJQ4T.js";
+} from "./chunk-OK5752AP.js";
 
 // src/agents.ts
 import crypto from "crypto";
@@ -1735,6 +1735,7 @@ import TurndownService2 from "turndown";
 import fs6 from "fs/promises";
 import path6 from "path";
 import ts from "typescript";
+import YAML2 from "yaml";
 
 // src/code-tree-sitter.ts
 import fs5 from "fs/promises";
@@ -1758,12 +1759,14 @@ var treeSitterModulePromise;
 var treeSitterInitPromise;
 var languageCache = /* @__PURE__ */ new Map();
 var grammarAssetByLanguage = {
+  bash: { packageName: TREE_SITTER_EXTRA_GRAMMARS_PACKAGE, relativePath: "out/tree-sitter-bash.wasm" },
   python: { packageName: TREE_SITTER_RUNTIME_PACKAGE, relativePath: "wasm/tree-sitter-python.wasm" },
   go: { packageName: TREE_SITTER_RUNTIME_PACKAGE, relativePath: "wasm/tree-sitter-go.wasm" },
   rust: { packageName: TREE_SITTER_RUNTIME_PACKAGE, relativePath: "wasm/tree-sitter-rust.wasm" },
   java: { packageName: TREE_SITTER_RUNTIME_PACKAGE, relativePath: "wasm/tree-sitter-java.wasm" },
   kotlin: { packageName: TREE_SITTER_EXTRA_GRAMMARS_PACKAGE, relativePath: "out/tree-sitter-kotlin.wasm" },
   scala: { packageName: TREE_SITTER_EXTRA_GRAMMARS_PACKAGE, relativePath: "out/tree-sitter-scala.wasm" },
+  dart: { packageName: TREE_SITTER_EXTRA_GRAMMARS_PACKAGE, relativePath: "out/tree-sitter-dart.wasm" },
   lua: { packageName: TREE_SITTER_EXTRA_GRAMMARS_PACKAGE, relativePath: "out/tree-sitter-lua.wasm" },
   zig: { packageName: TREE_SITTER_EXTRA_GRAMMARS_PACKAGE, relativePath: "out/tree-sitter-zig.wasm" },
   csharp: { packageName: TREE_SITTER_RUNTIME_PACKAGE, relativePath: "wasm/tree-sitter-c-sharp.wasm" },
@@ -1830,7 +1833,10 @@ function normalizeSymbolReference(value) {
   return lastSegment.replace(/[,:;]+$/g, "").trim();
 }
 function stripCodeExtension(filePath) {
-  return filePath.replace(/\.(?:[cm]?jsx?|tsx?|mts|cts|py|go|rs|java|kt|kts|scala|sc|lua|zig|cs|php|c|cc|cpp|cxx|h|hh|hpp|hxx)$/i, "");
+  return filePath.replace(
+    /\.(?:[cm]?jsx?|tsx?|mts|cts|sh|bash|zsh|py|go|rs|java|kt|kts|scala|sc|dart|lua|zig|cs|php|c|cc|cpp|cxx|h|hh|hpp|hxx)$/i,
+    ""
+  );
 }
 function manifestModuleName(manifest, language) {
   const repoPath = manifest.repoRelativePath ?? path5.basename(manifest.originalPath ?? manifest.storedPath);
@@ -2264,6 +2270,89 @@ function parseScalaImport(text) {
     reExport: false
   }));
 }
+function bashCommandName(commandNode) {
+  if (!commandNode) {
+    return void 0;
+  }
+  const nameNode = commandNode.childForFieldName("name") ?? findNamedChild(commandNode, "command_name") ?? commandNode.namedChildren.at(0) ?? null;
+  if (!nameNode) {
+    return void 0;
+  }
+  return nodeText(findNamedChild(nameNode, "word") ?? nameNode.namedChildren.at(0) ?? nameNode).trim() || void 0;
+}
+function bashSpecifierLooksLocal(specifier) {
+  return specifier.startsWith(".") || specifier.startsWith("/") || specifier.includes("/") || /\.(?:sh|bash|zsh)$/i.test(specifier);
+}
+function parseBashImport(commandNode) {
+  const commandName = bashCommandName(commandNode);
+  if (commandName !== "source" && commandName !== ".") {
+    return void 0;
+  }
+  const argumentNode = commandNode.childForFieldName("argument") ?? commandNode.namedChildren.find((child) => child && child !== (commandNode.childForFieldName("name") ?? null)) ?? null;
+  const specifier = quotedPath(nodeText(argumentNode));
+  if (!specifier) {
+    return void 0;
+  }
+  return {
+    specifier,
+    importedSymbols: [],
+    isExternal: !bashSpecifierLooksLocal(specifier),
+    reExport: false
+  };
+}
+function parseDartUri(node) {
+  const stringNode = node?.descendantsOfType("string_literal").find((item) => item !== null) ?? null;
+  return stringNode ? quotedPath(stringNode.text) : void 0;
+}
+function dartSpecifierLooksLocal(specifier) {
+  return specifier.startsWith("./") || specifier.startsWith("../") || specifier.startsWith("/") || !specifier.startsWith("package:") && !specifier.includes(":") && specifier.endsWith(".dart");
+}
+function parseDartDirective(node) {
+  if (node.type === "import_or_export") {
+    const importNode = findNamedChild(node, "library_import");
+    if (importNode) {
+      const specifier2 = parseDartUri(
+        findNamedChild(importNode, "configurable_uri") ?? findNamedChild(findNamedChild(importNode, "import_specification"), "configurable_uri") ?? importNode
+      );
+      if (!specifier2) {
+        return void 0;
+      }
+      return {
+        specifier: specifier2,
+        importedSymbols: [],
+        isExternal: !dartSpecifierLooksLocal(specifier2) && !specifier2.startsWith("package:"),
+        reExport: false
+      };
+    }
+    const exportNode = findNamedChild(node, "library_export");
+    if (exportNode) {
+      const specifier2 = parseDartUri(findNamedChild(exportNode, "configurable_uri") ?? exportNode);
+      if (!specifier2) {
+        return void 0;
+      }
+      return {
+        specifier: specifier2,
+        importedSymbols: [],
+        isExternal: !dartSpecifierLooksLocal(specifier2) && !specifier2.startsWith("package:"),
+        reExport: true
+      };
+    }
+    return void 0;
+  }
+  if (node.type !== "part_directive") {
+    return void 0;
+  }
+  const specifier = parseDartUri(findNamedChild(node, "uri") ?? node);
+  if (!specifier) {
+    return void 0;
+  }
+  return {
+    specifier,
+    importedSymbols: [],
+    isExternal: false,
+    reExport: false
+  };
+}
 function parseLuaRequire(node) {
   const stringNode = node.descendantsOfType("string").find((item) => item !== null);
   const identifiers = node.descendantsOfType("identifier").filter((item) => item !== null).map((item) => item.text.trim());
@@ -2425,6 +2514,29 @@ function scalaDefinitionKind(node) {
   }
   return void 0;
 }
+function bashCallNamesFromBody(bodyNode, selfName) {
+  if (!bodyNode) {
+    return [];
+  }
+  return uniqueBy(
+    bodyNode.descendantsOfType("command").filter((item) => item !== null).map((item) => bashCommandName(item)).filter((name) => Boolean(name)).filter((name) => name !== "source" && name !== "." && name !== selfName),
+    (name) => name
+  );
+}
+function dartCallableName(node) {
+  if (!node) {
+    return void 0;
+  }
+  if (node.type === "function_signature") {
+    return extractIdentifier(node.childForFieldName("name") ?? findNamedChild(node, "identifier"));
+  }
+  if (node.type === "constructor_signature") {
+    return extractIdentifier(node.childForFieldName("name") ?? findNamedChild(node, "identifier"));
+  }
+  return extractIdentifier(
+    node.childForFieldName("name") ?? findNamedChild(node, "function_signature") ?? findNamedChild(node, "identifier")
+  );
+}
 function luaFunctionName(node) {
   if (!node) {
     return void 0;
@@ -2447,6 +2559,237 @@ function zigDeclarationKind(node) {
   }
   return void 0;
 }
+function bashCodeAnalysis(manifest, rootNode, diagnostics) {
+  const imports = [];
+  const draftSymbols = [];
+  const exportLabels = [];
+  for (const child of rootNode.namedChildren) {
+    if (!child) {
+      continue;
+    }
+    if (child.type === "command") {
+      const parsed = parseBashImport(child);
+      if (parsed) {
+        imports.push(parsed);
+      }
+      continue;
+    }
+    if (child.type !== "function_definition") {
+      continue;
+    }
+    const name = nodeText(child.childForFieldName("name") ?? child.namedChildren.at(0) ?? null).trim();
+    if (!name) {
+      continue;
+    }
+    draftSymbols.push({
+      name,
+      kind: "function",
+      signature: singleLineSignature(child.text),
+      exported: true,
+      callNames: [],
+      extendsNames: [],
+      implementsNames: [],
+      bodyText: nodeText(child.childForFieldName("body") ?? findNamedChild(child, "compound_statement"))
+    });
+    exportLabels.push(name);
+  }
+  for (let index = 0; index < draftSymbols.length; index += 1) {
+    const functionNode = rootNode.namedChildren.find(
+      (child) => child?.type === "function_definition" && nodeText(child.childForFieldName("name") ?? child.namedChildren.at(0) ?? null).trim() === draftSymbols[index]?.name
+    );
+    draftSymbols[index].callNames = bashCallNamesFromBody(
+      functionNode?.childForFieldName("body") ?? findNamedChild(functionNode, "compound_statement"),
+      draftSymbols[index].name
+    );
+  }
+  return finalizeCodeAnalysis(manifest, "bash", imports, draftSymbols, exportLabels, diagnostics);
+}
+function dartCodeAnalysis(manifest, rootNode, diagnostics) {
+  const imports = [];
+  const draftSymbols = [];
+  const exportLabels = [];
+  let libraryName;
+  const pushScopedFunctions = (bodyNode, scopeName) => {
+    if (!bodyNode) {
+      return;
+    }
+    const children = bodyNode.namedChildren.filter((item) => item !== null);
+    for (let index = 0; index < children.length; index += 1) {
+      const child = children[index];
+      if (!child) {
+        continue;
+      }
+      if (child.type === "method_signature") {
+        const signatureNode = findNamedChild(child, "function_signature") ?? child;
+        const methodName = dartCallableName(signatureNode);
+        if (!methodName) {
+          continue;
+        }
+        const bodyNode2 = children[index + 1]?.type === "function_body" ? children[index + 1] : null;
+        const symbolName2 = `${scopeName}.${methodName}`;
+        const exported2 = !scopeName.startsWith("_") && !methodName.startsWith("_");
+        draftSymbols.push({
+          name: symbolName2,
+          kind: "function",
+          signature: singleLineSignature(`${child.text} ${nodeText(bodyNode2)}`),
+          exported: exported2,
+          callNames: [],
+          extendsNames: [],
+          implementsNames: [],
+          bodyText: nodeText(bodyNode2)
+        });
+        if (exported2) {
+          exportLabels.push(symbolName2);
+        }
+        continue;
+      }
+      if (child.type !== "declaration") {
+        continue;
+      }
+      const constructorNode = findNamedChild(child, "constructor_signature");
+      const constructorName = dartCallableName(constructorNode);
+      if (!constructorName) {
+        continue;
+      }
+      const symbolName = `${scopeName}.${constructorName}`;
+      const exported = !scopeName.startsWith("_") && !constructorName.startsWith("_");
+      draftSymbols.push({
+        name: symbolName,
+        kind: "function",
+        signature: singleLineSignature(child.text),
+        exported,
+        callNames: [],
+        extendsNames: [],
+        implementsNames: [],
+        bodyText: child.text
+      });
+      if (exported) {
+        exportLabels.push(symbolName);
+      }
+    }
+  };
+  const topLevelChildren = rootNode.namedChildren.filter((item) => item !== null);
+  for (let index = 0; index < topLevelChildren.length; index += 1) {
+    const child = topLevelChildren[index];
+    if (!child) {
+      continue;
+    }
+    if (child.type === "library_name") {
+      libraryName = nodeText(findNamedChild(child, "dotted_identifier_list") ?? child.namedChildren.at(-1) ?? null) || libraryName;
+      continue;
+    }
+    if (child.type === "import_or_export" || child.type === "part_directive") {
+      const parsed = parseDartDirective(child);
+      if (parsed) {
+        imports.push(parsed);
+      }
+      continue;
+    }
+    if (child.type === "function_signature") {
+      const functionName = dartCallableName(child);
+      if (!functionName) {
+        continue;
+      }
+      const bodyNode2 = topLevelChildren[index + 1]?.type === "function_body" ? topLevelChildren[index + 1] : null;
+      const exported2 = !functionName.startsWith("_");
+      draftSymbols.push({
+        name: functionName,
+        kind: "function",
+        signature: singleLineSignature(`${child.text} ${nodeText(bodyNode2)}`),
+        exported: exported2,
+        callNames: [],
+        extendsNames: [],
+        implementsNames: [],
+        bodyText: nodeText(bodyNode2)
+      });
+      if (exported2) {
+        exportLabels.push(functionName);
+      }
+      continue;
+    }
+    if (child.type === "mixin_declaration") {
+      const mixinName = extractIdentifier(child.childForFieldName("name") ?? findNamedChild(child, "identifier"));
+      if (!mixinName) {
+        continue;
+      }
+      const bodyNode2 = child.childForFieldName("body") ?? findNamedChild(child, "class_body");
+      const exported2 = !mixinName.startsWith("_");
+      draftSymbols.push({
+        name: mixinName,
+        kind: "trait",
+        signature: singleLineSignature(child.text),
+        exported: exported2,
+        callNames: [],
+        extendsNames: [],
+        implementsNames: [],
+        bodyText: nodeText(bodyNode2) || child.text
+      });
+      if (exported2) {
+        exportLabels.push(mixinName);
+      }
+      pushScopedFunctions(bodyNode2, mixinName);
+      continue;
+    }
+    if (child.type === "enum_declaration") {
+      const enumName = extractIdentifier(child.childForFieldName("name") ?? findNamedChild(child, "identifier"));
+      if (!enumName) {
+        continue;
+      }
+      const exported2 = !enumName.startsWith("_");
+      draftSymbols.push({
+        name: enumName,
+        kind: "enum",
+        signature: singleLineSignature(child.text),
+        exported: exported2,
+        callNames: [],
+        extendsNames: [],
+        implementsNames: [],
+        bodyText: nodeText(child.childForFieldName("body") ?? findNamedChild(child, "enum_body")) || child.text
+      });
+      if (exported2) {
+        exportLabels.push(enumName);
+      }
+      continue;
+    }
+    if (child.type === "extension_declaration") {
+      const extensionName = extractIdentifier(child.childForFieldName("name") ?? findNamedChild(child, "identifier"));
+      const targetType = extractIdentifier(child.childForFieldName("type") ?? findNamedChild(child, "type_identifier")) ?? extensionName;
+      const bodyNode2 = child.childForFieldName("body") ?? findNamedChild(child, "extension_body");
+      if (targetType) {
+        pushScopedFunctions(bodyNode2, targetType);
+      }
+      continue;
+    }
+    if (child.type !== "class_definition") {
+      continue;
+    }
+    const className = extractIdentifier(child.childForFieldName("name") ?? findNamedChild(child, "identifier"));
+    if (!className) {
+      continue;
+    }
+    const superTypes = descendantTypeNames(child.childForFieldName("superclass"));
+    const interfaceTypes = descendantTypeNames(child.childForFieldName("interfaces"));
+    const bodyNode = child.childForFieldName("body") ?? findNamedChild(child, "class_body");
+    const exported = !className.startsWith("_");
+    draftSymbols.push({
+      name: className,
+      kind: "class",
+      signature: singleLineSignature(child.text),
+      exported,
+      callNames: [],
+      extendsNames: superTypes.slice(0, 1),
+      implementsNames: [...superTypes.slice(1), ...interfaceTypes],
+      bodyText: nodeText(bodyNode) || child.text
+    });
+    if (exported) {
+      exportLabels.push(className);
+    }
+    pushScopedFunctions(bodyNode, className);
+  }
+  return finalizeCodeAnalysis(manifest, "dart", imports, draftSymbols, exportLabels, diagnostics, {
+    namespace: libraryName
+  });
+}
 function pythonCodeAnalysis(manifest, rootNode, diagnostics) {
   const imports = [];
   const draftSymbols = [];
@@ -3425,6 +3768,8 @@ async function analyzeTreeSitterCode(manifest, content, language) {
     const diagnostics = diagnosticsFromTree(tree.rootNode);
     const rationales = extractTreeSitterRationales(manifest, language, tree.rootNode);
     switch (language) {
+      case "bash":
+        return { code: bashCodeAnalysis(manifest, tree.rootNode, diagnostics), rationales };
       case "python":
         return { code: pythonCodeAnalysis(manifest, tree.rootNode, diagnostics), rationales };
       case "go":
@@ -3437,6 +3782,8 @@ async function analyzeTreeSitterCode(manifest, content, language) {
         return { code: kotlinCodeAnalysis(manifest, tree.rootNode, diagnostics), rationales };
       case "scala":
         return { code: scalaCodeAnalysis(manifest, tree.rootNode, diagnostics), rationales };
+      case "dart":
+        return { code: dartCodeAnalysis(manifest, tree.rootNode, diagnostics), rationales };
       case "lua":
         return { code: luaCodeAnalysis(manifest, tree.rootNode, diagnostics), rationales };
       case "zig":
@@ -3497,6 +3844,34 @@ function isRelativeSpecifier(specifier) {
 function isLocalIncludeSpecifier(specifier) {
   return specifier.startsWith(".") || specifier.startsWith("/") || specifier.includes("/");
 }
+function bashSpecifierLooksLocal2(specifier) {
+  return isLocalIncludeSpecifier(specifier) || /\.(?:sh|bash|zsh)$/i.test(specifier);
+}
+function dartSpecifierLooksLocal2(specifier) {
+  return specifier.startsWith("./") || specifier.startsWith("../") || specifier.startsWith("/") || !specifier.startsWith("package:") && !specifier.includes(":") && specifier.endsWith(".dart");
+}
+function interpreterFromShebang(content) {
+  if (!content?.startsWith("#!")) {
+    return void 0;
+  }
+  const firstLine = content.split(/\r?\n/, 1)[0]?.slice(2).trim() ?? "";
+  if (!firstLine) {
+    return void 0;
+  }
+  const parts = firstLine.split(/\s+/).filter(Boolean);
+  if (parts.length === 0) {
+    return void 0;
+  }
+  const basename = (value) => path6.posix.basename(value.trim());
+  if (basename(parts[0] ?? "") === "env") {
+    const interpreter = parts.slice(1).find((part) => !part.startsWith("-"));
+    return interpreter ? basename(interpreter) : void 0;
+  }
+  return basename(parts[0] ?? "");
+}
+function isShellInterpreter(value) {
+  return value === "sh" || value === "bash" || value === "zsh";
+}
 function formatDiagnosticCategory(category) {
   switch (category) {
     case ts.DiagnosticCategory.Error:
@@ -3727,7 +4102,10 @@ function makeRationale2(manifest, index, text, kind, symbolName) {
   };
 }
 function stripCodeExtension2(filePath) {
-  return filePath.replace(/\.(?:[cm]?jsx?|tsx?|mts|cts|py|go|rs|java|kt|kts|scala|sc|lua|zig|cs|php|c|cc|cpp|cxx|h|hh|hpp|hxx)$/i, "");
+  return filePath.replace(
+    /\.(?:[cm]?jsx?|tsx?|mts|cts|sh|bash|zsh|py|go|rs|java|kt|kts|scala|sc|dart|lua|zig|cs|php|c|cc|cpp|cxx|h|hh|hpp|hxx)$/i,
+    ""
+  );
 }
 function manifestModuleName2(manifest, language) {
   const repoPath = manifest.repoRelativePath ?? path6.basename(manifest.originalPath ?? manifest.storedPath);
@@ -4032,7 +4410,7 @@ function analyzeTypeScriptLikeCode(manifest, content) {
     rationales: extractTypeScriptRationales(manifest, content, sourceFile)
   };
 }
-function inferCodeLanguage(filePath, mimeType = "") {
+function inferCodeLanguage(filePath, mimeType = "", options = {}) {
   const extension = path6.extname(filePath).toLowerCase();
   if (extension === ".ts" || extension === ".mts" || extension === ".cts") {
     return "typescript";
@@ -4046,6 +4424,9 @@ function inferCodeLanguage(filePath, mimeType = "") {
   if (extension === ".js" || extension === ".mjs" || extension === ".cjs" || mimeType.includes("javascript")) {
     return "javascript";
   }
+  if (extension === ".sh" || extension === ".bash" || extension === ".zsh" || mimeType === "application/x-sh") {
+    return "bash";
+  }
   if (extension === ".py") {
     return "python";
   }
@@ -4064,6 +4445,9 @@ function inferCodeLanguage(filePath, mimeType = "") {
   if (extension === ".scala" || extension === ".sc") {
     return "scala";
   }
+  if (extension === ".dart") {
+    return "dart";
+  }
   if (extension === ".lua") {
     return "lua";
   }
@@ -4088,6 +4472,9 @@ function inferCodeLanguage(filePath, mimeType = "") {
   if ([".cc", ".cpp", ".cxx", ".h", ".hh", ".hpp", ".hxx"].includes(extension)) {
     return "cpp";
   }
+  if (!extension && options.executable && isShellInterpreter(interpreterFromShebang(options.content))) {
+    return "bash";
+  }
   return void 0;
 }
 function modulePageTitle(manifest) {
@@ -4120,6 +4507,43 @@ function manifestBasenameWithoutExtension(manifest) {
   const target = manifest.repoRelativePath ?? manifest.originalPath ?? manifest.storedPath;
   return path6.posix.basename(stripCodeExtension2(normalizeAlias(target)));
 }
+async function readNearestDartPackageInfo(startPath, cache) {
+  let current = path6.resolve(startPath);
+  try {
+    const stat = await fs6.stat(current);
+    if (!stat.isDirectory()) {
+      current = path6.dirname(current);
+    }
+  } catch {
+    current = path6.dirname(current);
+  }
+  while (true) {
+    if (cache.has(current)) {
+      const cached = cache.get(current);
+      return cached === null ? void 0 : cached;
+    }
+    const pubspecPath = path6.join(current, "pubspec.yaml");
+    if (await fs6.access(pubspecPath).then(() => true).catch(() => false)) {
+      try {
+        const content = await fs6.readFile(pubspecPath, "utf8");
+        const parsed = YAML2.parse(content);
+        const packageName = typeof parsed?.name === "string" ? parsed.name.trim() : "";
+        const info = packageName ? { rootDir: current, name: packageName } : null;
+        cache.set(current, info);
+        return info ?? void 0;
+      } catch {
+        cache.set(current, null);
+        return void 0;
+      }
+    }
+    const parent = path6.dirname(current);
+    if (parent === current) {
+      cache.set(current, null);
+      return void 0;
+    }
+    current = parent;
+  }
+}
 async function readNearestGoModulePath(startPath, cache) {
   let current = path6.resolve(startPath);
   try {
@@ -4166,6 +4590,8 @@ function candidateExtensionsFor(language) {
     case "typescript":
     case "tsx":
       return [".ts", ".tsx", ".js", ".jsx", ".mts", ".cts", ".mjs", ".cjs"];
+    case "bash":
+      return [".sh", ".bash", ".zsh"];
     case "python":
       return [".py"];
     case "go":
@@ -4178,6 +4604,8 @@ function candidateExtensionsFor(language) {
       return [".kt", ".kts"];
     case "scala":
       return [".scala", ".sc"];
+    case "dart":
+      return [".dart"];
     case "lua":
       return [".lua"];
     case "zig":
@@ -4199,6 +4627,7 @@ function candidateExtensionsFor(language) {
 async function buildCodeIndex(rootDir, manifests, analyses) {
   const analysesBySourceId = new Map(analyses.map((analysis) => [analysis.sourceId, analysis]));
   const goModuleCache = /* @__PURE__ */ new Map();
+  const dartPackageCache = /* @__PURE__ */ new Map();
   const entries = [];
   for (const manifest of manifests) {
     const analysis = analysesBySourceId.get(manifest.sourceId);
@@ -4223,6 +4652,9 @@ async function buildCodeIndex(rootDir, manifests, analyses) {
       case "python":
         recordAlias(aliases, normalizedModuleName?.replace(/\//g, "."));
         break;
+      case "bash":
+        recordAlias(aliases, basename);
+        break;
       case "rust":
         if (repoRelativePath) {
           recordAlias(aliases, rustModuleAlias(repoRelativePath));
@@ -4244,6 +4676,7 @@ async function buildCodeIndex(rootDir, manifests, analyses) {
       case "java":
       case "kotlin":
       case "scala":
+      case "dart":
       case "csharp":
         if (normalizedNamespace) {
           recordAlias(aliases, `${normalizedNamespace}.${basename}`);
@@ -4253,6 +4686,19 @@ async function buildCodeIndex(rootDir, manifests, analyses) {
             recordAlias(aliases, `${normalizedNamespace}.${symbol.name}`);
           }
         }
+        if (analysis.code.language === "dart" && repoRelativePath) {
+          recordAlias(aliases, basename);
+          const originalPath = manifest.originalPath ? path6.resolve(manifest.originalPath) : path6.resolve(rootDir, manifest.storedPath);
+          const packageInfo = await readNearestDartPackageInfo(originalPath, dartPackageCache);
+          if (packageInfo) {
+            const packageRelativePath = toPosix(path6.relative(packageInfo.rootDir, originalPath));
+            if (packageRelativePath.startsWith("lib/")) {
+              const packagePath = packageRelativePath.slice("lib/".length);
+              recordAlias(aliases, `package:${packageInfo.name}/${packagePath}`);
+              recordAlias(aliases, `package:${packageInfo.name}/${stripCodeExtension2(packagePath)}`);
+            }
+          }
+        }
         break;
       case "lua":
         recordAlias(aliases, basename);
@@ -4387,14 +4833,17 @@ function findImportCandidates(manifest, codeImport, lookup) {
     case "scala":
     case "csharp":
       return aliasMatches(lookup, codeImport.specifier);
+    case "dart":
+      return repoRelativePath && dartSpecifierLooksLocal2(codeImport.specifier) ? repoPathMatches(lookup, ...importResolutionCandidates(repoRelativePath, codeImport.specifier, candidateExtensionsFor(language))) : aliasMatches(lookup, codeImport.specifier);
     case "lua":
       return luaSpecifierLooksLocal(codeImport.specifier) ? repoPathMatches(lookup, ...resolveLuaModuleCandidates(codeImport.specifier)) : aliasMatches(lookup, codeImport.specifier, codeImport.specifier.replace(/\./g, "/"));
     case "zig":
       return repoRelativePath && (!codeImport.isExternal || codeImport.specifier.endsWith(".zig")) ? repoPathMatches(lookup, ...importResolutionCandidates(repoRelativePath, codeImport.specifier, candidateExtensionsFor(language))) : aliasMatches(lookup, codeImport.specifier);
     case "php":
     case "ruby":
+    case "bash":
     case "powershell":
-      if (repoRelativePath && isLocalIncludeSpecifier(codeImport.specifier)) {
+      if (repoRelativePath && (language === "bash" ? bashSpecifierLooksLocal2(codeImport.specifier) : isLocalIncludeSpecifier(codeImport.specifier))) {
         return repoPathMatches(
           lookup,
           ...importResolutionCandidates(repoRelativePath, codeImport.specifier, candidateExtensionsFor(language))
@@ -4438,6 +4887,10 @@ function importLooksLocal(manifest, codeImport, candidates) {
     case "kotlin":
     case "scala":
       return !codeImport.isExternal;
+    case "bash":
+      return bashSpecifierLooksLocal2(codeImport.specifier);
+    case "dart":
+      return dartSpecifierLooksLocal2(codeImport.specifier);
     case "lua":
       return luaSpecifierLooksLocal(codeImport.specifier);
     case "zig":
@@ -6096,8 +6549,8 @@ var MARKDOWN_SEMANTIC_FRONTMATTER_KEYS = [
 function uniqueStrings(values) {
   return [...new Set(values.filter(Boolean))];
 }
-function inferKind(mimeType, filePath) {
-  if (inferCodeLanguage(filePath, mimeType)) {
+function inferKind(mimeType, filePath, detectionOptions = {}) {
+  if (inferCodeLanguage(filePath, mimeType, detectionOptions)) {
     return "code";
   }
   if (isRstFilePath(filePath)) {
@@ -6144,6 +6597,25 @@ function inferKind(mimeType, filePath) {
   }
   return "binary";
 }
+async function localCodeDetectionOptions(absolutePath, payloadBytes) {
+  if (path12.extname(absolutePath)) {
+    return {};
+  }
+  try {
+    const stat = await fs11.stat(absolutePath);
+    const executable = Boolean(stat.mode & 73);
+    if (!executable) {
+      return { executable: false };
+    }
+    const bytes = payloadBytes ?? await fs11.readFile(absolutePath);
+    return {
+      executable,
+      content: bytes.subarray(0, 256).toString("utf8")
+    };
+  } catch {
+    return {};
+  }
+}
 function isRstFilePath(filePath) {
   const extension = path12.extname(filePath).toLowerCase();
   return extension === ".rst" || extension === ".rest";
@@ -7017,7 +7489,8 @@ async function collectDirectoryFiles(rootDir, inputDir, repoRoot, options) {
         continue;
       }
       const mimeType = guessMimeType(absolutePath);
-      let sourceKind = inferKind(mimeType, absolutePath);
+      const detectionOptions = await localCodeDetectionOptions(absolutePath);
+      let sourceKind = inferKind(mimeType, absolutePath, detectionOptions);
       if (sourceKind === "binary" && path12.extname(absolutePath).toLowerCase() === ".zip") {
         const bytes = await fs11.readFile(absolutePath);
         if (isSlackExportArchive(bytes)) {
@@ -7644,8 +8117,9 @@ async function prepareFileInputs(rootDir, absoluteInput, repoRoot, sourceClass)
     }
   }
   const mimeType = guessMimeType(absoluteInput);
-  const sourceKind = inferKind(mimeType, absoluteInput);
-  const language = inferCodeLanguage(absoluteInput, mimeType);
+  const detectionOptions = await localCodeDetectionOptions(absoluteInput, payloadBytes);
+  const sourceKind = inferKind(mimeType, absoluteInput, detectionOptions);
+  const language = inferCodeLanguage(absoluteInput, mimeType, detectionOptions);
   const storedExtension = path12.extname(absoluteInput) || `.${mime.extension(mimeType) || "bin"}`;
   let title;
   let extractedText;
@@ -8077,7 +8551,8 @@ async function collectInboxAttachmentRefs(inputDir, files) {
   const refsBySource = /* @__PURE__ */ new Map();
   for (const absolutePath of files) {
     const mimeType = guessMimeType(absolutePath);
-    const sourceKind = inferKind(mimeType, absolutePath);
+    const detectionOptions = await localCodeDetectionOptions(absolutePath);
+    const sourceKind = inferKind(mimeType, absolutePath, detectionOptions);
     if (sourceKind !== "markdown" && sourceKind !== "html") {
       continue;
     }
@@ -8419,7 +8894,8 @@ async function importInbox(rootDir, inputDir) {
       continue;
     }
     const mimeType = guessMimeType(absolutePath);
-    let sourceKind = inferKind(mimeType, absolutePath);
+    const detectionOptions = await localCodeDetectionOptions(absolutePath);
+    let sourceKind = inferKind(mimeType, absolutePath, detectionOptions);
     if (sourceKind === "binary" && path12.extname(absolutePath).toLowerCase() === ".zip") {
       const bytes = await fs11.readFile(absolutePath);
       if (isSlackExportArchive(bytes)) {
@@ -10579,6 +11055,43 @@ import matter5 from "gray-matter";
 function uniqueStrings2(values) {
   return uniqueBy(values.filter(Boolean), (value) => value);
 }
+var GUIDED_SOURCE_MARKER_PREFIX = "<!-- swarmvault-guided-source:";
+var GUIDED_SOURCE_START_SUFFIX = ":start -->";
+var GUIDED_SOURCE_END_SUFFIX = ":end -->";
+function extractGuidedSourceBlocks(content) {
+  if (!content) {
+    return [];
+  }
+  const blocks = [];
+  let cursor = 0;
+  while (cursor < content.length) {
+    const startIndex = content.indexOf(GUIDED_SOURCE_MARKER_PREFIX, cursor);
+    if (startIndex === -1) {
+      break;
+    }
+    const scopeEndIndex = content.indexOf(GUIDED_SOURCE_START_SUFFIX, startIndex);
+    if (scopeEndIndex === -1) {
+      break;
+    }
+    const scopeId = content.slice(startIndex + GUIDED_SOURCE_MARKER_PREFIX.length, scopeEndIndex);
+    const endMarker = `${GUIDED_SOURCE_MARKER_PREFIX}${scopeId}${GUIDED_SOURCE_END_SUFFIX}`;
+    const endIndex = content.indexOf(endMarker, scopeEndIndex);
+    if (endIndex === -1) {
+      break;
+    }
+    const blockEnd = endIndex + endMarker.length;
+    blocks.push(content.slice(startIndex, blockEnd).trim());
+    cursor = blockEnd;
+  }
+  return uniqueStrings2(blocks);
+}
+function appendGuidedSourceBlocks(body, existingContent) {
+  const blocks = extractGuidedSourceBlocks(existingContent);
+  if (!blocks.length) {
+    return body;
+  }
+  return [body.trimEnd(), "", "## Guided Session Notes", "", ...blocks, ""].join("\n");
+}
 function safeFrontmatter(value) {
   return JSON.parse(JSON.stringify(value));
 }
@@ -10667,7 +11180,7 @@ function detailList(manifest, key) {
   const items = value.split(",").map((item) => item.trim()).filter(Boolean);
   return items.length ? items : void 0;
 }
-function buildSourcePage(manifest, analysis, schemaHash, metadata, relatedOutputs = [], modulePage, decorations) {
+function buildSourcePage(manifest, analysis, schemaHash, metadata, relatedOutputs = [], modulePage, decorations, existingContent) {
   const relativePath = pagePathFor("source", manifest.sourceId);
   const pageId = `source:${manifest.sourceId}`;
   const { sourceHashes, sourceSemanticHashes } = sourceHashesForManifest(manifest);
@@ -10709,61 +11222,64 @@ function buildSourcePage(manifest, analysis, schemaHash, metadata, relatedOutput
     schema_hash: schemaHash,
     ...sourceHashFrontmatter(sourceHashes, sourceSemanticHashes)
   };
-  const body = [
-    `# ${analysis.title}`,
-    "",
-    `Source ID: \`${manifest.sourceId}\``,
-    `Source Kind: \`${manifest.sourceKind}\``,
-    manifest.url ? `Source URL: ${manifest.url}` : `Source Path: \`${manifest.originalPath ?? manifest.storedPath}\``,
-    ...manifest.sourceType ? [`Source Type: \`${manifest.sourceType}\``, ""] : [""],
-    ...manifest.sourceClass ? [`Source Class: \`${manifest.sourceClass}\``, ""] : [],
-    ...manifest.sourceGroupTitle ? [`Source Group: ${manifest.sourceGroupTitle}`] : [],
-    ...manifest.partTitle ? [`Part: ${manifest.partIndex ?? "?"}/${manifest.partCount ?? "?"} - ${manifest.partTitle}`] : [],
-    ...manifest.details && Object.keys(manifest.details).length ? [
+  const body = appendGuidedSourceBlocks(
+    [
+      `# ${analysis.title}`,
       "",
-      "## Source Details",
+      `Source ID: \`${manifest.sourceId}\``,
+      `Source Kind: \`${manifest.sourceKind}\``,
+      manifest.url ? `Source URL: ${manifest.url}` : `Source Path: \`${manifest.originalPath ?? manifest.storedPath}\``,
+      ...manifest.sourceType ? [`Source Type: \`${manifest.sourceType}\``, ""] : [""],
+      ...manifest.sourceClass ? [`Source Class: \`${manifest.sourceClass}\``, ""] : [],
+      ...manifest.sourceGroupTitle ? [`Source Group: ${manifest.sourceGroupTitle}`] : [],
+      ...manifest.partTitle ? [`Part: ${manifest.partIndex ?? "?"}/${manifest.partCount ?? "?"} - ${manifest.partTitle}`] : [],
+      ...manifest.details && Object.keys(manifest.details).length ? [
+        "",
+        "## Source Details",
+        "",
+        ...Object.entries(manifest.details).map(([key, value]) => `- ${key.replace(/_/g, " ")}: ${value}`),
+        ""
+      ] : [],
       "",
-      ...Object.entries(manifest.details).map(([key, value]) => `- ${key.replace(/_/g, " ")}: ${value}`),
-      ""
-    ] : [],
-    "",
-    "## Summary",
-    "",
-    analysis.summary,
-    "",
-    ...analysis.code ? [
-      "## Code Module",
+      "## Summary",
+      "",
+      analysis.summary,
+      "",
+      ...analysis.code ? [
+        "## Code Module",
+        "",
+        `- Language: \`${analysis.code.language}\``,
+        modulePage ? `- Module Page: [[${modulePage.path.replace(/\.md$/, "")}|${modulePage.title}]]` : "- Module Page: Not generated.",
+        `- Exports: ${analysis.code.exports.length ? analysis.code.exports.join(", ") : "None detected."}`,
+        `- Symbols: ${analysis.code.symbols.length ? analysis.code.symbols.map((symbol) => symbol.name).join(", ") : "None detected."}`,
+        analysis.code.diagnostics.length ? `- Diagnostics: ${analysis.code.diagnostics.length}` : "- Diagnostics: None.",
+        ""
+      ] : [],
+      "## Concepts",
+      "",
+      ...analysis.concepts.length ? analysis.concepts.map(
+        (item) => `- [[${pagePathFor("concept", slugify(item.name)).replace(/\.md$/, "")}|${item.name}]]: ${item.description}`
+      ) : ["- None detected."],
+      "",
+      "## Entities",
+      "",
+      ...analysis.entities.length ? analysis.entities.map(
+        (item) => `- [[${pagePathFor("entity", slugify(item.name)).replace(/\.md$/, "")}|${item.name}]]: ${item.description}`
+      ) : ["- None detected."],
       "",
-      `- Language: \`${analysis.code.language}\``,
-      modulePage ? `- Module Page: [[${modulePage.path.replace(/\.md$/, "")}|${modulePage.title}]]` : "- Module Page: Not generated.",
-      `- Exports: ${analysis.code.exports.length ? analysis.code.exports.join(", ") : "None detected."}`,
-      `- Symbols: ${analysis.code.symbols.length ? analysis.code.symbols.map((symbol) => symbol.name).join(", ") : "None detected."}`,
-      analysis.code.diagnostics.length ? `- Diagnostics: ${analysis.code.diagnostics.length}` : "- Diagnostics: None.",
+      "## Claims",
+      "",
+      ...analysis.claims.length ? analysis.claims.map((claim) => `- ${claim.text} [source:${claim.citation}]`) : ["- No claims extracted."],
+      "",
+      "## Questions",
+      "",
+      ...analysis.questions.length ? analysis.questions.map((question) => `- ${question}`) : ["- No follow-up questions yet."],
+      "",
+      ...relatedOutputsSection(relatedOutputs),
       ""
-    ] : [],
-    "## Concepts",
-    "",
-    ...analysis.concepts.length ? analysis.concepts.map(
-      (item) => `- [[${pagePathFor("concept", slugify(item.name)).replace(/\.md$/, "")}|${item.name}]]: ${item.description}`
-    ) : ["- None detected."],
-    "",
-    "## Entities",
-    "",
-    ...analysis.entities.length ? analysis.entities.map(
-      (item) => `- [[${pagePathFor("entity", slugify(item.name)).replace(/\.md$/, "")}|${item.name}]]: ${item.description}`
-    ) : ["- None detected."],
-    "",
-    "## Claims",
-    "",
-    ...analysis.claims.length ? analysis.claims.map((claim) => `- ${claim.text} [source:${claim.citation}]`) : ["- No claims extracted."],
-    "",
-    "## Questions",
-    "",
-    ...analysis.questions.length ? analysis.questions.map((question) => `- ${question}`) : ["- No follow-up questions yet."],
-    "",
-    ...relatedOutputsSection(relatedOutputs),
-    ""
-  ].join("\n");
+    ].join("\n"),
+    existingContent
+  );
   return {
     page: {
       id: pageId,
@@ -10943,7 +11459,7 @@ function buildModulePage(input) {
     content: matter5.stringify(body, frontmatter)
   };
 }
-function buildAggregatePage(kind, name, descriptions, sourceAnalyses, sourceHashes, sourceSemanticHashes, schemaHash, metadata, relativePath, relatedOutputs = [], decorations) {
+function buildAggregatePage(kind, name, descriptions, sourceAnalyses, sourceHashes, sourceSemanticHashes, schemaHash, metadata, relativePath, relatedOutputs = [], decorations, existingContent) {
   const slug = slugify(name);
   const pageId = `${kind}:${slug}`;
   const sourceIds = sourceAnalyses.map((item) => item.sourceId);
@@ -10969,26 +11485,29 @@ function buildAggregatePage(kind, name, descriptions, sourceAnalyses, sourceHash
     schema_hash: schemaHash,
     ...sourceHashFrontmatter(sourceHashes, sourceSemanticHashes)
   };
-  const body = [
-    `# ${name}`,
-    "",
-    "## Summary",
-    "",
-    summary,
-    "",
-    "## Seen In",
-    "",
-    ...sourceAnalyses.map((item) => `- [[${pagePathFor("source", item.sourceId).replace(/\.md$/, "")}|${item.title}]]`),
-    "",
-    "## Source Claims",
-    "",
-    ...sourceAnalyses.flatMap(
-      (item) => item.claims.filter((claim) => claim.text.toLowerCase().includes(name.toLowerCase())).map((claim) => `- ${claim.text} [source:${claim.citation}]`)
-    ),
-    "",
-    ...relatedOutputsSection(relatedOutputs),
-    ""
-  ].join("\n");
+  const body = appendGuidedSourceBlocks(
+    [
+      `# ${name}`,
+      "",
+      "## Summary",
+      "",
+      summary,
+      "",
+      "## Seen In",
+      "",
+      ...sourceAnalyses.map((item) => `- [[${pagePathFor("source", item.sourceId).replace(/\.md$/, "")}|${item.title}]]`),
+      "",
+      "## Source Claims",
+      "",
+      ...sourceAnalyses.flatMap(
+        (item) => item.claims.filter((claim) => claim.text.toLowerCase().includes(name.toLowerCase())).map((claim) => `- ${claim.text} [source:${claim.citation}]`)
+      ),
+      "",
+      ...relatedOutputsSection(relatedOutputs),
+      ""
+    ].join("\n"),
+    existingContent
+  );
   return {
     page: {
       id: pageId,
@@ -11744,7 +12263,8 @@ function buildOutputPage(input) {
     question: input.question,
     output_format: input.outputFormat,
     output_assets: outputAssets,
-    ...input.outputFormat === "slides" ? { marp: true } : {}
+    ...input.outputFormat === "slides" ? { marp: true } : {},
+    ...input.frontmatter ?? {}
   };
   return {
     page: {
@@ -11832,7 +12352,7 @@ function buildOutputPage(input) {
         ...input.citations.map((citation) => `- [source:${citation}]`),
         ""
       ]).join("\n"),
-      frontmatter
+      safeFrontmatter(frontmatter)
     )
   };
 }
@@ -12937,7 +13457,7 @@ async function resolveImageGenerationProvider(rootDir) {
   if (!providerConfig) {
     throw new Error(`No provider configured with id "${preferredProviderId}" for task "imageProvider".`);
   }
-  const { createProvider: createProvider2 } = await import("./registry-XOPLQNZY.js");
+  const { createProvider: createProvider2 } = await import("./registry-TYROWPR5.js");
   return createProvider2(preferredProviderId, providerConfig, rootDir);
 }
 async function generateOutputArtifacts(rootDir, input) {
@@ -13342,6 +13862,7 @@ function pageHashes(pages) {
 }
 async function buildManagedGraphPage(absolutePath, defaults, build) {
   const existingContent = await fileExists(absolutePath) ? await fs19.readFile(absolutePath, "utf8") : null;
+  let carriedContent = existingContent;
   let existing = await loadExistingManagedPageState(absolutePath, {
     status: defaults.status ?? "active",
     managedBy: defaults.managedBy
@@ -13356,6 +13877,7 @@ async function buildManagedGraphPage(absolutePath, defaults, build) {
         status: defaults.status ?? "active",
         managedBy: defaults.managedBy
       });
+      carriedContent = await fs19.readFile(candidatePath, "utf8");
       usedFallbackState = true;
       break;
     }
@@ -13368,13 +13890,13 @@ async function buildManagedGraphPage(absolutePath, defaults, build) {
     managedBy: defaults.managedBy,
     confidence: defaults.confidence
   };
-  let built = build(metadata);
-  if (existingContent && existingContent !== built.content) {
+  let built = build(metadata, carriedContent);
+  if (carriedContent && carriedContent !== built.content) {
     metadata = {
       ...metadata,
       updatedAt: (/* @__PURE__ */ new Date()).toISOString()
     };
-    built = build(metadata);
+    built = build(metadata, carriedContent);
   }
   return built;
 }
@@ -13425,7 +13947,10 @@ async function loadAnalysesBySourceIds(paths, sourceIds) {
   );
   return analyses.filter((analysis) => Boolean(analysis?.sourceId));
 }
-async function buildDashboardRecords(paths, graph, schemaHash, report) {
+async function buildDashboardRecords(config, paths, graph, schemaHash, report) {
+  const dataviewEnabled = config.profile.dataviewBlocks;
+  const profilePresets = config.profile.presets;
+  const dashboardPack = config.profile.dashboardPack;
   const sourcePages = graph.pages.filter((page) => page.kind === "source");
   const reviewPages = graph.pages.filter((page) => page.kind === "output" && page.path.startsWith("outputs/source-reviews/"));
   const briefPages = graph.pages.filter((page) => page.kind === "output" && page.path.startsWith("outputs/source-briefs/"));
@@ -13445,6 +13970,8 @@ async function buildDashboardRecords(paths, graph, schemaHash, report) {
   const stagedGuideBundles = (await Promise.all(
     (await fs19.readdir(paths.approvalsDir, { withFileTypes: true }).catch(() => [])).filter((entry) => entry.isDirectory()).map(async (entry) => await readJsonFile(approvalManifestPath(paths, entry.name)))
   )).filter((manifest) => Boolean(manifest)).filter((manifest) => manifest.bundleType === "guided_source" || manifest.bundleType === "guided_session").sort((left, right) => right.createdAt.localeCompare(left.createdAt)).slice(0, 12);
+  const readerFocusPages = uniqueBy([...guidePages, ...briefPages, ...conceptPages, ...entityPages], (page) => page.id).slice(0, 8);
+  const diligenceSessions = sourceSessions.filter((session) => session.status === "staged" || session.status === "awaiting_input").slice(0, 8);
   const dashboards = [
     {
       relativePath: "dashboards/index.md",
@@ -13462,12 +13989,17 @@ async function buildDashboardRecords(paths, graph, schemaHash, report) {
           "- [[dashboards/contradictions|Contradictions]]",
           "- [[dashboards/open-questions|Open Questions]]",
           "",
-          "```dataview",
-          "TABLE file.mtime AS updated",
-          'FROM "dashboards"',
-          'WHERE file.name != "index"',
-          "SORT file.mtime desc",
-          "```",
+          `Profile Presets: ${profilePresets.length ? profilePresets.map((preset) => `\`${preset}\``).join(", ") : "_default_"}`,
+          `Dashboard Pack: \`${dashboardPack}\``,
+          ...dataviewEnabled ? [
+            "",
+            "```dataview",
+            "TABLE file.mtime AS updated",
+            'FROM "dashboards"',
+            'WHERE file.name != "index"',
+            "SORT file.mtime desc",
+            "```"
+          ] : [],
           ""
         ].join("\n"),
         {
@@ -13488,7 +14020,8 @@ async function buildDashboardRecords(paths, graph, schemaHash, report) {
           backlinks: [],
           schema_hash: schemaHash,
           source_hashes: {},
-          source_semantic_hashes: {}
+          source_semantic_hashes: {},
+          profile_presets: profilePresets
         }
       )
     },
@@ -13500,13 +14033,16 @@ async function buildDashboardRecords(paths, graph, schemaHash, report) {
           "# Recent Sources",
           "",
           ...recentSourcePages.length ? recentSourcePages.map((page) => `- ${page.updatedAt}: [[${page.path.replace(/\.md$/, "")}|${page.title}]]`) : ["- No source pages yet."],
-          "",
-          "```dataview",
-          "TABLE source_type, occurred_at, participants",
-          'FROM "sources"',
-          "SORT updated_at desc",
-          "LIMIT 25",
-          "```",
+          ...dashboardPack === "reader" && readerFocusPages.length ? ["", "## Reader Focus", "", ...readerFocusPages.map((page) => `- [[${page.path.replace(/\.md$/, "")}|${page.title}]]`)] : [],
+          ...dataviewEnabled ? [
+            "",
+            "```dataview",
+            "TABLE source_type, occurred_at, participants",
+            'FROM "sources"',
+            "SORT updated_at desc",
+            "LIMIT 25",
+            "```"
+          ] : [],
           ""
         ].join("\n"),
         {
@@ -13527,7 +14063,8 @@ async function buildDashboardRecords(paths, graph, schemaHash, report) {
           backlinks: [],
           schema_hash: schemaHash,
           source_hashes: {},
-          source_semantic_hashes: {}
+          source_semantic_hashes: {},
+          profile_presets: profilePresets
         }
       )
     },
@@ -13551,13 +14088,21 @@ async function buildDashboardRecords(paths, graph, schemaHash, report) {
               (session) => `- ${session.updatedAt}: \`${session.status}\` [[outputs/source-sessions/${session.scopeId}|${session.scopeTitle}]]`
             )
           ] : [],
-          "",
-          "```dataview",
-          "TABLE occurred_at, source_type, participants, container_title",
-          'FROM "sources"',
-          "SORT occurred_at desc",
-          "LIMIT 25",
-          "```",
+          ...dashboardPack === "reader" && conceptPages.length ? [
+            "",
+            "## Thesis And Hub Pages",
+            "",
+            ...conceptPages.slice(0, 6).map((page) => `- [[${page.path.replace(/\.md$/, "")}|${page.title}]]`)
+          ] : [],
+          ...dataviewEnabled ? [
+            "",
+            "```dataview",
+            "TABLE occurred_at, source_type, participants, container_title",
+            'FROM "sources"',
+            "SORT occurred_at desc",
+            "LIMIT 25",
+            "```"
+          ] : [],
           ""
         ].join("\n"),
         {
@@ -13578,7 +14123,8 @@ async function buildDashboardRecords(paths, graph, schemaHash, report) {
           backlinks: [],
           schema_hash: schemaHash,
           source_hashes: {},
-          source_semantic_hashes: {}
+          source_semantic_hashes: {},
+          profile_presets: profilePresets
         }
       )
     },
@@ -13594,13 +14140,15 @@ async function buildDashboardRecords(paths, graph, schemaHash, report) {
             const sourcePage = sourcePages.find((page) => page.sourceIds.includes(manifest.sourceId));
             return `- ${occurredAt}: ${sourcePage ? `[[${sourcePage.path.replace(/\.md$/, "")}|${sourcePage.title}]]` : manifest.title}`;
           }) : ["- No timeline-aware sources yet."],
-          "",
-          "```dataview",
-          "TABLE occurred_at, participants, container_title",
-          'FROM "sources"',
-          "WHERE occurred_at",
-          "SORT occurred_at desc",
-          "```",
+          ...dataviewEnabled ? [
+            "",
+            "```dataview",
+            "TABLE occurred_at, participants, container_title",
+            'FROM "sources"',
+            "WHERE occurred_at",
+            "SORT occurred_at desc",
+            "```"
+          ] : [],
           ""
         ].join("\n"),
         {
@@ -13621,7 +14169,8 @@ async function buildDashboardRecords(paths, graph, schemaHash, report) {
           backlinks: [],
           schema_hash: schemaHash,
           source_hashes: {},
-          source_semantic_hashes: {}
+          source_semantic_hashes: {},
+          profile_presets: profilePresets
         }
       )
     },
@@ -13643,11 +14192,14 @@ async function buildDashboardRecords(paths, graph, schemaHash, report) {
           ...stagedGuideBundles.length ? stagedGuideBundles.map(
             (bundle) => `- ${bundle.createdAt}: \`${bundle.approvalId}\`${bundle.title ? ` ${bundle.title}` : ""} (${bundle.entries.length} staged entr${bundle.entries.length === 1 ? "y" : "ies"})`
           ) : ["- No staged guided bundles right now."],
-          "",
-          "```dataview",
-          'LIST FROM "outputs/source-sessions"',
-          "SORT file.mtime desc",
-          "```",
+          ...dataviewEnabled ? [
+            "",
+            "```dataview",
+            "TABLE session_status, evidence_state, canonical_targets",
+            'FROM "outputs/source-sessions"',
+            "SORT file.mtime desc",
+            "```"
+          ] : [],
           ""
         ].join("\n"),
         {
@@ -13674,7 +14226,8 @@ async function buildDashboardRecords(paths, graph, schemaHash, report) {
           backlinks: [],
           schema_hash: schemaHash,
           source_hashes: {},
-          source_semantic_hashes: {}
+          source_semantic_hashes: {},
+          profile_presets: profilePresets
         }
       )
     },
@@ -13692,11 +14245,14 @@ async function buildDashboardRecords(paths, graph, schemaHash, report) {
           ...stagedGuideBundles.length ? stagedGuideBundles.map(
             (bundle) => `- ${bundle.createdAt}: \`${bundle.approvalId}\`${bundle.title ? ` ${bundle.title}` : ""} (${bundle.entries.length} staged entr${bundle.entries.length === 1 ? "y" : "ies"})`
           ) : ["- No staged guided bundles right now."],
-          "",
-          "```dataview",
-          'LIST FROM "outputs/source-guides"',
-          "SORT file.mtime desc",
-          "```",
+          ...dataviewEnabled ? [
+            "",
+            "```dataview",
+            "TABLE evidence_state, canonical_targets, file.mtime AS updated",
+            'FROM "outputs/source-guides"',
+            "SORT file.mtime desc",
+            "```"
+          ] : [],
           ""
         ].join("\n"),
         {
@@ -13723,7 +14279,8 @@ async function buildDashboardRecords(paths, graph, schemaHash, report) {
           backlinks: [],
           schema_hash: schemaHash,
           source_hashes: {},
-          source_semantic_hashes: {}
+          source_semantic_hashes: {},
+          profile_presets: profilePresets
         }
       )
     },
@@ -13750,12 +14307,14 @@ async function buildDashboardRecords(paths, graph, schemaHash, report) {
           "",
           ...sourceSessions.length ? sourceSessions.slice(0, 8).map((session) => `- \`${session.status}\` [[outputs/source-sessions/${session.scopeId}|${session.scopeTitle}]]`) : ["- No active source sessions yet."],
           ...report?.suggestedQuestions?.length ? ["", "## Suggested Questions", "", ...report.suggestedQuestions.slice(0, 8).map((question) => `- ${question}`)] : [],
-          "",
-          "```dataview",
-          'TABLE file.folder, file.mtime FROM "concepts" OR "entities"',
-          "SORT file.mtime desc",
-          "LIMIT 30",
-          "```",
+          ...dataviewEnabled ? [
+            "",
+            "```dataview",
+            'TABLE file.folder, file.mtime FROM "concepts" OR "entities"',
+            "SORT file.mtime desc",
+            "LIMIT 30",
+            "```"
+          ] : [],
           ""
         ].join("\n"),
         {
@@ -13784,7 +14343,8 @@ async function buildDashboardRecords(paths, graph, schemaHash, report) {
           backlinks: [],
           schema_hash: schemaHash,
           source_hashes: {},
-          source_semantic_hashes: {}
+          source_semantic_hashes: {},
+          profile_presets: profilePresets
         }
       )
     },
@@ -13807,10 +14367,21 @@ async function buildDashboardRecords(paths, graph, schemaHash, report) {
             ...[...guidePages, ...reviewPages, ...briefPages].slice(0, 12).map((page) => `- [[${page.path.replace(/\.md$/, "")}|${page.title}]]`),
             ""
           ] : [],
-          "```dataview",
-          'LIST FROM "outputs/source-reviews" OR "outputs/source-guides"',
-          "SORT file.mtime desc",
-          "```",
+          ...dashboardPack === "diligence" && diligenceSessions.length ? [
+            "## Active Evidence Review Sessions",
+            "",
+            ...diligenceSessions.map(
+              (session) => `- \`${session.status}\` [[outputs/source-sessions/${session.scopeId}|${session.scopeTitle}]]`
+            ),
+            ""
+          ] : [],
+          ...dataviewEnabled ? [
+            "```dataview",
+            'TABLE evidence_state, session_status, canonical_targets FROM "outputs/source-reviews" OR "outputs/source-guides" OR "outputs/source-sessions"',
+            'WHERE evidence_state = "conflicting"',
+            "SORT file.mtime desc",
+            "```"
+          ] : [],
           ""
         ].join("\n"),
         {
@@ -13831,7 +14402,8 @@ async function buildDashboardRecords(paths, graph, schemaHash, report) {
           backlinks: [],
           schema_hash: schemaHash,
           source_hashes: {},
-          source_semantic_hashes: {}
+          source_semantic_hashes: {},
+          profile_presets: profilePresets
         }
       )
     },
@@ -13849,11 +14421,13 @@ async function buildDashboardRecords(paths, graph, schemaHash, report) {
             "",
             ...sourceSessions.filter((session) => session.status === "awaiting_input" || session.status === "staged").slice(0, 8).map((session) => `- \`${session.status}\` [[outputs/source-sessions/${session.scopeId}|${session.scopeTitle}]]`)
           ] : [],
-          "",
-          "```dataview",
-          'LIST FROM "outputs/source-briefs" OR "outputs/source-reviews" OR "outputs/source-guides" OR "outputs/source-sessions"',
-          "SORT file.mtime desc",
-          "```",
+          ...dataviewEnabled ? [
+            "",
+            "```dataview",
+            'TABLE question_state, session_status, evidence_state FROM "outputs/source-briefs" OR "outputs/source-reviews" OR "outputs/source-guides" OR "outputs/source-sessions"',
+            "SORT file.mtime desc",
+            "```"
+          ] : [],
           ""
         ].join("\n"),
         {
@@ -13874,7 +14448,8 @@ async function buildDashboardRecords(paths, graph, schemaHash, report) {
           backlinks: [],
           schema_hash: schemaHash,
           source_hashes: {},
-          source_semantic_hashes: {}
+          source_semantic_hashes: {},
+          profile_presets: profilePresets
         }
       )
     }
@@ -14766,7 +15341,7 @@ async function syncVaultArtifacts(rootDir, input) {
         confidence: 1,
         compiledFrom: [manifest.sourceId]
       },
-      (metadata) => buildSourcePage(
+      (metadata, existingContent) => buildSourcePage(
         manifest,
         analysis,
         sourceSchemaHash,
@@ -14777,7 +15352,8 @@ async function syncVaultArtifacts(rootDir, input) {
           projectIds: sourceProjectIds,
           extraTags: [...sourceCategoryTags, ...analysis.tags ?? []],
           sourceClass: manifest.sourceClass
-        }
+        },
+        existingContent
       )
     );
     records.push(sourceRecord);
@@ -14867,7 +15443,7 @@ async function syncVaultArtifacts(rootDir, input) {
           compiledFrom: sourceIds,
           statePathCandidates: fallbackPaths
         },
-        (metadata) => buildAggregatePage(
+        (metadata, existingContent) => buildAggregatePage(
           itemKind,
           aggregate.name,
           aggregate.descriptions,
@@ -14886,7 +15462,8 @@ async function syncVaultArtifacts(rootDir, input) {
               ...aggregate.sourceAnalyses.map((item) => item.summary)
             ]),
             sourceClass: aggregateSourceClass2
-          }
+          },
+          existingContent
         )
       );
       if (promoted && previousEntry?.status === "candidate") {
@@ -14940,6 +15517,7 @@ async function syncVaultArtifacts(rootDir, input) {
   );
   const preliminaryPages = [...basePages, ...graphOrientation.records.map((record) => record.page)];
   const dashboardRecords = await buildDashboardRecords(
+    config,
     paths,
     {
       ...baseGraph,
@@ -15179,6 +15757,7 @@ async function refreshIndexesAndSearch(rootDir, pages) {
     compileState?.generatedAt
   ) : { records: [], report: null };
   const dashboardRecords = currentGraph ? await buildDashboardRecords(
+    config,
     paths,
     {
       ...currentGraph,
@@ -16051,21 +16630,27 @@ async function ensureObsidianWorkspace(rootDir) {
   ]);
 }
 async function initVault(rootDir, options = {}) {
-  const profile = options.profile ?? "default";
-  const { paths } = await initWorkspace(rootDir, { profile });
+  const requestedProfile = options.profile ?? "default";
+  const { config, paths } = await initWorkspace(rootDir, { profile: requestedProfile });
+  const profile = config.profile;
+  const isResearchProfile = profile.presets.length > 0 || profile.guidedSessionMode === "canonical_review" || profile.dataviewBlocks;
   await installConfiguredAgents(rootDir);
   const insightsIndexPath = path23.join(paths.wikiDir, "insights", "index.md");
   const now = (/* @__PURE__ */ new Date()).toISOString();
   await writeFileIfChanged(
     insightsIndexPath,
     matter9.stringify(
-      (profile === "personal-research" ? [
+      (isResearchProfile ? [
         "# Insights",
         "",
         "Human-authored research notes live here.",
         "",
         "- Use this folder for thesis notes, reading reflections, synthesis drafts, and decisions you want to keep explicitly human-authored.",
-        "- Guided sessions can stage `wiki/insights/` updates through the approval queue, but SwarmVault never applies them without review.",
+        ...profile.guidedSessionMode === "canonical_review" ? [
+          "- Guided sessions can stage approval-queued updates for canonical pages and fall back to `wiki/insights/` when a claim still needs judgment."
+        ] : [
+          "- Guided sessions fall back to `wiki/insights/` for exploratory synthesis until you decide what should become canonical."
+        ],
         "- Treat these pages as the human judgment layer for your vault.",
         ""
       ] : [
@@ -16148,16 +16733,21 @@ async function initVault(rootDir, options = {}) {
   if (options.obsidian) {
     await ensureObsidianWorkspace(rootDir);
   }
-  if (profile === "personal-research") {
+  if (isResearchProfile) {
     await writeFileIfChanged(
       path23.join(paths.wikiDir, "insights", "research-playbook.md"),
       matter9.stringify(
         [
-          "# Personal Research Playbook",
+          `# ${requestedProfile === "personal-research" ? "Personal Research Playbook" : "Research Playbook"}`,
           "",
           "- Add one source at a time with `swarmvault ingest <input> --guide` or `swarmvault source add <input> --guide`.",
           "- Resume a guided session with `swarmvault source session <source-id-or-session-id>` whenever you want to answer the session prompts directly.",
           "- Review `wiki/outputs/source-briefs/`, `wiki/outputs/source-reviews/`, `wiki/outputs/source-guides/`, and `wiki/outputs/source-sessions/` before accepting staged updates.",
+          ...profile.guidedSessionMode === "canonical_review" ? ["- Use `swarmvault review show --diff` to inspect staged canonical page edits before accepting them."] : ["- Keep exploratory synthesis in `wiki/insights/` until you are ready to promote it into canonical pages."],
+          ...profile.dataviewBlocks ? [
+            "- Dataview-friendly fields are enabled in the dashboards, but every generated page should still read cleanly as plain markdown."
+          ] : [],
+          ...profile.presets.length ? [`- Active profile presets: ${profile.presets.map((preset) => `\`${preset}\``).join(", ")}.`] : [],
           "- Keep unresolved questions visible in `wiki/dashboards/open-questions.md`.",
           "- Use `swarmvault review list` and `swarmvault review show --diff` to decide what becomes canonical.",
           ""
@@ -16165,7 +16755,7 @@ async function initVault(rootDir, options = {}) {
         {
           page_id: "insights:research-playbook",
           kind: "insight",
-          title: "Personal Research Playbook",
+          title: requestedProfile === "personal-research" ? "Personal Research Playbook" : "Research Playbook",
           tags: ["insight", "research", "playbook"],
           source_ids: [],
           project_ids: [],
@@ -17098,7 +17688,7 @@ async function bootstrapDemo(rootDir, input) {
 }
 
 // src/mcp.ts
-var SERVER_VERSION = "0.6.0";
+var SERVER_VERSION = "0.6.2";
 async function createMcpServer(rootDir) {
   const server = new McpServer({
     name: "swarmvault",
@@ -18417,6 +19007,9 @@ var GUIDED_SESSION_QUESTIONS = [
 function defaultGuidedSessionQuestions() {
   return GUIDED_SESSION_QUESTIONS.map((question) => ({ ...question }));
 }
+function splitDelimitedDetail(value) {
+  return value ? value.split(",").map((item) => item.trim()).filter(Boolean) : [];
+}
 function normalizeGuidedAnswerValue(value) {
   return typeof value === "string" && value.trim() ? value.trim() : void 0;
 }
@@ -18445,6 +19038,40 @@ function mergeGuidedSessionQuestions(questions, answers) {
 function answeredGuidedSessionQuestions(questions) {
   return questions.filter((question) => typeof question.answer === "string" && question.answer.trim().length > 0);
 }
+function questionStateForSession(session) {
+  return answeredGuidedSessionQuestions(session.questions).length === session.questions.length ? "answered" : "awaiting_input";
+}
+function manifestsForScope(graph, scope) {
+  if (!graph) {
+    return [];
+  }
+  const scopeSet = new Set(scope.sourceIds);
+  return graph.sources.filter((manifest) => scopeSet.has(manifest.sourceId));
+}
+function scopeSourceType(scope, manifests) {
+  return scope.kind ?? manifests[0]?.sourceKind ?? manifests[0]?.sourceType;
+}
+function scopeOccurredAt(manifests) {
+  return manifests.map((manifest) => manifest.details?.occurred_at).filter((value) => typeof value === "string" && value.trim().length > 0).sort((left, right) => right.localeCompare(left))[0];
+}
+function scopeParticipants(manifests) {
+  return uniqueStrings4(manifests.flatMap((manifest) => splitDelimitedDetail(manifest.details?.participants)));
+}
+function scopeContainerTitle(manifests) {
+  return manifests.find((manifest) => manifest.details?.container_title)?.details?.container_title ?? manifests[0]?.sourceGroupTitle;
+}
+function scopeConversationId(manifests) {
+  return manifests.find((manifest) => manifest.details?.conversation_id)?.details?.conversation_id;
+}
+function classifyGuidedEvidenceState(scope, targetPage, contradictions) {
+  if (contradictions.length) {
+    return "conflicting";
+  }
+  if (!targetPage) {
+    return "needs_judgment";
+  }
+  return targetPage.sourceIds.some((sourceId) => !scope.sourceIds.includes(sourceId)) ? "reinforcing" : "new";
+}
 function renderDeterministicSourceReview(input) {
   const canonicalPages = input.sourcePages.filter((page) => page.kind === "source" || page.kind === "concept" || page.kind === "entity").slice(0, 10);
   const modulePages = input.sourcePages.filter((page) => page.kind === "module").slice(0, 8);
@@ -18545,12 +19172,13 @@ Entities: ${analysis.entities.map((entity) => entity.name).join(", ") || "none"}
   }
 }
 async function buildSourceReviewStagedPage(rootDir, scope) {
-  const { paths } = await loadVaultConfig(rootDir);
+  const { config, paths } = await loadVaultConfig(rootDir);
   const markdown = await generateSourceReviewMarkdown(rootDir, scope);
   if (!markdown) {
     throw new Error(`Could not generate a source review for ${scope.id}.`);
   }
   const graph = await readJsonFile(paths.graphPath);
+  const scopeManifests = manifestsForScope(graph, scope);
   const relatedPages = graph ? scopedSourcePages(graph, scope.sourceIds) : [];
   const relatedPageIds = relatedPages.slice(0, 16).map((page) => page.id);
   const relatedNodeIds = graph ? scopedNodeIds(graph, scope.sourceIds).slice(0, 24) : [];
@@ -18577,13 +19205,26 @@ async function buildSourceReviewStagedPage(rootDir, scope) {
       compiledFrom: scope.sourceIds,
       managedBy: "system",
       confidence: 0.79
+    },
+    frontmatter: {
+      profile_presets: config.profile.presets,
+      source_type: scopeSourceType(scope, scopeManifests),
+      occurred_at: scopeOccurredAt(scopeManifests),
+      participants: scopeParticipants(scopeManifests),
+      container_title: scopeContainerTitle(scopeManifests),
+      conversation_id: scopeConversationId(scopeManifests),
+      question_state: "answered",
+      canonical_targets: relatedPages.filter((page) => page.kind === "source" || page.kind === "concept" || page.kind === "entity").slice(0, 8).map((page) => page.path),
+      evidence_state: findContradictionsForScope(scope, await readGraphReport(rootDir)).length ? "conflicting" : "needs_judgment"
     }
   });
   return { page: output.page, content: output.content };
 }
 function classifySourceGuidePageBuckets(sourcePages, scopeSourceIds) {
   const scopeSet = new Set(scopeSourceIds);
-  const canonicalPages = sourcePages.filter((page) => page.kind === "source" || page.kind === "concept" || page.kind === "entity").slice(0, 12);
+  const canonicalPages = sourcePages.filter(
+    (page) => (page.kind === "source" || page.kind === "concept" || page.kind === "entity") && (page.kind === "source" || page.status !== "candidate")
+  ).slice(0, 12);
   const newPages = canonicalPages.filter((page) => page.sourceIds.every((sourceId) => scopeSet.has(sourceId))).slice(0, 6);
   const reinforcingPages = canonicalPages.filter((page) => page.sourceIds.some((sourceId) => !scopeSet.has(sourceId))).slice(0, 6);
   return { canonicalPages, newPages, reinforcingPages };
@@ -18776,13 +19417,16 @@ Entities: ${analysis.entities.map((entity) => entity.name).join(", ") || "none"}
   }
 }
 async function buildSourceGuideStagedPage(rootDir, scope) {
-  const { paths } = await loadVaultConfig(rootDir);
+  const { config, paths } = await loadVaultConfig(rootDir);
   const markdown = await generateSourceGuideMarkdown(rootDir, scope);
   if (!markdown) {
     throw new Error(`Could not generate a source guide for ${scope.id}.`);
   }
   const graph = await readJsonFile(paths.graphPath);
+  const scopeManifests = manifestsForScope(graph, scope);
   const relatedPages = graph ? scopedSourcePages(graph, scope.sourceIds) : [];
+  const contradictions = findContradictionsForScope(scope, await readGraphReport(rootDir));
+  const selectedTargets = selectGuidedTargetPages(scope, relatedPages, defaultGuidedSessionQuestions());
   const relatedPageIds = relatedPages.slice(0, 18).map((page) => page.id);
   const relatedNodeIds = graph ? scopedNodeIds(graph, scope.sourceIds).slice(0, 28) : [];
   const projectIds = uniqueStrings4(relatedPages.flatMap((page) => page.projectIds));
@@ -18808,6 +19452,17 @@ async function buildSourceGuideStagedPage(rootDir, scope) {
       compiledFrom: scope.sourceIds,
       managedBy: "system",
       confidence: 0.8
+    },
+    frontmatter: {
+      profile_presets: config.profile.presets,
+      source_type: scopeSourceType(scope, scopeManifests),
+      occurred_at: scopeOccurredAt(scopeManifests),
+      participants: scopeParticipants(scopeManifests),
+      container_title: scopeContainerTitle(scopeManifests),
+      conversation_id: scopeConversationId(scopeManifests),
+      question_state: "answered",
+      canonical_targets: selectedTargets.map((page) => page.path),
+      evidence_state: contradictions.length ? "conflicting" : selectedTargets.some((page) => page.sourceIds.some((sourceId) => !scope.sourceIds.includes(sourceId))) ? "reinforcing" : selectedTargets.length ? "new" : "needs_judgment"
     }
   });
   return { page: output.page, content: output.content };
@@ -18864,12 +19519,13 @@ async function prepareGuidedSourceSession(rootDir, scope, answers) {
   return { session, statePath };
 }
 async function buildSourceSessionSavedPage(rootDir, scope, session) {
-  const { paths } = await loadVaultConfig(rootDir);
+  const { config, paths } = await loadVaultConfig(rootDir);
   let graph = await readJsonFile(paths.graphPath);
   if (!graph) {
     await compileVault(rootDir, {});
     graph = await readJsonFile(paths.graphPath);
   }
+  const scopeManifests = manifestsForScope(graph, scope);
   const sourcePages = graph ? scopedSourcePages(graph, scope.sourceIds) : [];
   const analyses = await loadSourceAnalyses(rootDir, scope.sourceIds);
   const report = await readGraphReport(rootDir);
@@ -18883,6 +19539,9 @@ async function buildSourceSessionSavedPage(rootDir, scope, session) {
   ]);
   const relatedNodeIds = graph ? scopedNodeIds(graph, scope.sourceIds).slice(0, 28) : [];
   const projectIds = uniqueStrings4(sourcePages.flatMap((page) => page.projectIds));
+  const evidenceState = contradictions.length > 0 ? "conflicting" : session.targetedPagePaths.some(
+    (targetPath) => sourcePages.some((page) => page.path === targetPath && page.sourceIds.some((sourceId) => !scope.sourceIds.includes(sourceId)))
+  ) ? "reinforcing" : session.targetedPagePaths.length ? "new" : "needs_judgment";
   const relativeBriefPath = session.briefPath && path26.isAbsolute(session.briefPath) ? path26.relative(paths.wikiDir, session.briefPath) : session.briefPath;
   const sessionMarkdown = [
     `# Guided Session: ${scope.title}`,
@@ -18947,6 +19606,18 @@ async function buildSourceSessionSavedPage(rootDir, scope, session) {
       compiledFrom: scope.sourceIds,
       managedBy: "system",
       confidence: 0.81
+    },
+    frontmatter: {
+      profile_presets: config.profile.presets,
+      source_type: scopeSourceType(scope, scopeManifests),
+      occurred_at: scopeOccurredAt(scopeManifests),
+      participants: scopeParticipants(scopeManifests),
+      container_title: scopeContainerTitle(scopeManifests),
+      conversation_id: scopeConversationId(scopeManifests),
+      session_status: session.status,
+      question_state: questionStateForSession(session),
+      canonical_targets: session.targetedPagePaths,
+      evidence_state: evidenceState
     }
   });
   return { page: output.page, content: output.content };
@@ -18959,8 +19630,8 @@ async function persistSourceSessionPage(rootDir, scope, session) {
   await fs22.writeFile(absolutePath, output.content, "utf8");
   return { pageId: output.page.id, sessionPath: absolutePath };
 }
-async function buildGuidedInsightUpdatePages(rootDir, scope, session) {
-  const { paths } = await loadVaultConfig(rootDir);
+async function buildGuidedUpdatePages(rootDir, scope, session) {
+  const { config, paths } = await loadVaultConfig(rootDir);
   let graph = await readJsonFile(paths.graphPath);
   if (!graph) {
     await compileVault(rootDir, {});
@@ -18970,14 +19641,20 @@ async function buildGuidedInsightUpdatePages(rootDir, scope, session) {
     return [];
   }
   const sourcePages = scopedSourcePages(graph, scope.sourceIds);
+  const scopeManifests = manifestsForScope(graph, scope);
   const analyses = await loadSourceAnalyses(rootDir, scope.sourceIds);
   const report = await readGraphReport(rootDir);
   const contradictions = findContradictionsForScope(scope, report);
   const selectedTargets = selectGuidedTargetPages(scope, sourcePages, session.questions);
-  const targetPages = selectedTargets.length ? selectedTargets : [null];
+  const useCanonicalTargets = config.profile.guidedSessionMode === "canonical_review" && selectedTargets.length > 0;
+  const targetPages = useCanonicalTargets ? selectedTargets : [selectedTargets[0] ?? null];
+  session.targetedPagePaths = uniqueStrings4(
+    useCanonicalTargets ? selectedTargets.map((page) => page.path) : selectedTargets.length ? selectedTargets.map((page) => page.path) : session.targetedPagePaths
+  );
   return await Promise.all(
-    targetPages.map(async (targetPage, index) => {
-      const relativePath = targetPage ? insightRelativePathForTarget(targetPage, scope) : `insights/topics/${slugify(scope.title)}.md`;
+    targetPages.map(async (targetPage) => {
+      const evidenceState = classifyGuidedEvidenceState(scope, targetPage, contradictions);
+      const relativePath = useCanonicalTargets && targetPage ? targetPage.path : targetPage ? insightRelativePathForTarget(targetPage, scope) : `insights/topics/${slugify(scope.title)}.md`;
       const absolutePath = path26.join(paths.wikiDir, relativePath);
       const existingContent = await fileExists(absolutePath) ? await fs22.readFile(absolutePath, "utf8") : "";
       const parsed = existingContent ? matter10(existingContent) : { data: {}, content: "" };
@@ -18987,8 +19664,13 @@ async function buildGuidedInsightUpdatePages(rootDir, scope, session) {
       const existingNodeIds = Array.isArray(existingData.node_ids) ? existingData.node_ids.filter((value) => typeof value === "string") : [];
       const existingBacklinks = Array.isArray(existingData.backlinks) ? existingData.backlinks.filter((value) => typeof value === "string") : [];
       const createdAt = typeof existingData.created_at === "string" && existingData.created_at.trim() ? existingData.created_at : (/* @__PURE__ */ new Date()).toISOString();
-      const title = typeof existingData.title === "string" && existingData.title.trim() || (targetPage ? insightTitleForTarget(targetPage, scope) : `${scope.title} Notes`);
-      const baseBody = parsed.content.trim() ? parsed.content.trim() : [`# ${title}`, "", "Human-curated insight page. Guided sessions stage replaceable update blocks here.", ""].join("\n");
+      const title = typeof existingData.title === "string" && existingData.title.trim() || (useCanonicalTargets && targetPage ? targetPage.title : targetPage ? insightTitleForTarget(targetPage, scope) : `${scope.title} Notes`);
+      const baseBody = parsed.content.trim() ? parsed.content.trim() : [
+        `# ${title}`,
+        "",
+        useCanonicalTargets ? "Canonical page maintained by SwarmVault. Guided sessions stage replaceable update blocks here for approval." : "Human-curated insight page. Guided sessions stage replaceable update blocks here.",
+        ""
+      ].join("\n");
       const importance = questionAnswer(
         session.questions,
         "importance",
@@ -19008,6 +19690,7 @@ async function buildGuidedInsightUpdatePages(rootDir, scope, session) {
       const updateBlock = [
         `## Guided Session Update: ${scope.title}`,
         "",
+        `Evidence State: \`${evidenceState}\``,
         `Session: [[outputs/source-sessions/${scope.id}|Guided Session]]`,
         `Source Guide: [[outputs/source-guides/${scope.id}|Source Guide]]`,
         "",
@@ -19035,48 +19718,60 @@ async function buildGuidedInsightUpdatePages(rootDir, scope, session) {
         ""
       ].join("\n");
       const nextBody = replaceMarkedSection(baseBody, scope.id, updateBlock);
-      const content = matter10.stringify(`${nextBody.trimEnd()}
-`, {
-        ...existingData,
-        page_id: typeof existingData.page_id === "string" && existingData.page_id.trim() || `insight:${slugify(relativePath.replace(/\.md$/, ""))}`,
-        kind: "insight",
-        title,
-        tags: uniqueStrings4([
-          ...Array.isArray(existingData.tags) ? existingData.tags.filter((value) => typeof value === "string") : [],
-          ...insightTagsForTarget(targetPage)
-        ]),
-        source_ids: uniqueStrings4([...existingSourceIds, ...scope.sourceIds]),
-        project_ids: uniqueStrings4([...existingProjectIds, ...targetPage?.projectIds ?? []]),
-        node_ids: uniqueStrings4([...existingNodeIds, ...targetPage?.nodeIds ?? []]),
-        freshness: "fresh",
-        status: existingData.status === "archived" ? "archived" : "active",
-        confidence: 0.83,
-        created_at: createdAt,
-        updated_at: (/* @__PURE__ */ new Date()).toISOString(),
-        compiled_from: uniqueStrings4([
-          ...Array.isArray(existingData.compiled_from) ? existingData.compiled_from.filter((value) => typeof value === "string") : [],
-          ...scope.sourceIds
-        ]),
-        managed_by: "human",
-        backlinks: uniqueStrings4([
-          ...existingBacklinks,
-          ...targetPage ? [targetPage.id] : [],
-          `output:source-sessions/${scope.id}`,
-          `output:source-guides/${scope.id}`
-        ]),
-        schema_hash: typeof existingData.schema_hash === "string" ? existingData.schema_hash : "",
-        source_hashes: existingData.source_hashes && typeof existingData.source_hashes === "object" ? existingData.source_hashes : {},
-        source_semantic_hashes: existingData.source_semantic_hashes && typeof existingData.source_semantic_hashes === "object" ? existingData.source_semantic_hashes : {}
-      });
+      const content = matter10.stringify(
+        `${nextBody.trimEnd()}
+`,
+        JSON.parse(
+          JSON.stringify({
+            ...existingData,
+            page_id: typeof existingData.page_id === "string" && existingData.page_id.trim() || (useCanonicalTargets && targetPage ? targetPage.id : `insight:${slugify(relativePath.replace(/\.md$/, ""))}`),
+            kind: useCanonicalTargets && targetPage ? targetPage.kind : "insight",
+            title,
+            tags: uniqueStrings4([
+              ...Array.isArray(existingData.tags) ? existingData.tags.filter((value) => typeof value === "string") : [],
+              ...useCanonicalTargets ? ["guided-session", `guided/${targetPage?.kind ?? "page"}`] : insightTagsForTarget(targetPage)
+            ]),
+            source_ids: uniqueStrings4([...existingSourceIds, ...scope.sourceIds]),
+            project_ids: uniqueStrings4([...existingProjectIds, ...targetPage?.projectIds ?? []]),
+            node_ids: uniqueStrings4([...existingNodeIds, ...targetPage?.nodeIds ?? []]),
+            freshness: "fresh",
+            status: existingData.status === "archived" ? "archived" : "active",
+            confidence: 0.83,
+            created_at: createdAt,
+            updated_at: (/* @__PURE__ */ new Date()).toISOString(),
+            compiled_from: uniqueStrings4([
+              ...Array.isArray(existingData.compiled_from) ? existingData.compiled_from.filter((value) => typeof value === "string") : [],
+              ...scope.sourceIds
+            ]),
+            managed_by: typeof existingData.managed_by === "string" && (existingData.managed_by === "human" || existingData.managed_by === "system") ? existingData.managed_by : useCanonicalTargets ? "system" : "human",
+            backlinks: uniqueStrings4([
+              ...existingBacklinks,
+              ...targetPage ? [targetPage.id] : [],
+              `output:source-sessions/${scope.id}`,
+              `output:source-guides/${scope.id}`
+            ]),
+            schema_hash: typeof existingData.schema_hash === "string" ? existingData.schema_hash : "",
+            source_hashes: existingData.source_hashes && typeof existingData.source_hashes === "object" ? existingData.source_hashes : {},
+            source_semantic_hashes: existingData.source_semantic_hashes && typeof existingData.source_semantic_hashes === "object" ? existingData.source_semantic_hashes : {},
+            profile_presets: config.profile.presets,
+            source_type: scopeSourceType(scope, scopeManifests),
+            occurred_at: scopeOccurredAt(scopeManifests),
+            participants: scopeParticipants(scopeManifests),
+            container_title: scopeContainerTitle(scopeManifests),
+            conversation_id: scopeConversationId(scopeManifests),
+            session_status: session.status,
+            question_state: questionStateForSession(session),
+            canonical_targets: useCanonicalTargets ? selectedTargets.map((page2) => page2.path) : [],
+            evidence_state: evidenceState
+          })
+        )
+      );
       const page = parseStoredPage(relativePath, content, {
         createdAt,
         updatedAt: (/* @__PURE__ */ new Date()).toISOString()
       });
-      if (index === 0) {
-        session.targetedPagePaths = uniqueStrings4([
-          ...session.targetedPagePaths,
-          ...selectedTargets.length ? selectedTargets.map((page2) => page2.path) : [relativePath]
-        ]);
+      if (!useCanonicalTargets && !selectedTargets.length) {
+        session.targetedPagePaths = uniqueStrings4([...session.targetedPagePaths, relativePath]);
       }
       return { page, content, label: "guided-update" };
     })
@@ -19116,7 +19811,7 @@ async function stageSourceGuideForScope(rootDir, scope, options = {}) {
     ...scope,
     briefPath
   });
-  const guidedUpdates = await buildGuidedInsightUpdatePages(rootDir, scope, session);
+  const guidedUpdates = await buildGuidedUpdatePages(rootDir, scope, session);
   session.stagedUpdatePaths = guidedUpdates.map((item) => item.page.path);
   const approval = await stageGeneratedOutputPages(
     rootDir,