@swarmvaultai/engine 0.6.1 → 0.6.3

package/README.md

@@ -195,7 +195,7 @@ This matters because many "OpenAI-compatible" backends only implement part of th
 - EPUB inputs split into chapter-level manifests with shared group metadata so books stay navigable instead of becoming one giant source
 - CSV and TSV inputs produce bounded tabular summaries with delimiter-aware previews and compact column hints
 - XLSX inputs extract workbook-level and sheet-level previews, while PPTX inputs extract slide text plus speaker notes when present
-- JavaScript, JSX, TypeScript, TSX, Python, Go, Rust, Java, Kotlin, Scala, Lua, Zig, C#, C, C++, PHP, Ruby, and PowerShell inputs are treated as code sources and compiled into both source pages and `wiki/code/` module pages
+- JavaScript, JSX, TypeScript, TSX, Bash/shell script, Python, Go, Rust, Java, Kotlin, Scala, Dart, Lua, Zig, C#, C, C++, PHP, Ruby, and PowerShell inputs are treated as code sources and compiled into both source pages and `wiki/code/` module pages
 - `.rst` and `.rest` inputs are treated as first-class text sources with lightweight heading and directive normalization before analysis
 - code manifests can carry `repoRelativePath`, and compile writes `state/code-index.json` so local imports can resolve across an ingested repo tree
 - repo-aware manifests, graph nodes, and graph pages can also carry `sourceClass` so first-party, third-party, resource, and generated material can be filtered and reported separately

package/dist/index.d.ts

@@ -65,7 +65,7 @@ type SourceCaptureType = "arxiv" | "doi" | "tweet" | "article" | "url";
 type SourceClass = "first_party" | "third_party" | "resource" | "generated";
 type ManagedSourceKind = "directory" | "file" | "github_repo" | "crawl_url";
 type ManagedSourceStatus = "ready" | "missing" | "error";
-type CodeLanguage = "javascript" | "jsx" | "typescript" | "tsx" | "python" | "go" | "rust" | "java" | "kotlin" | "scala" | "lua" | "zig" | "csharp" | "c" | "cpp" | "php" | "ruby" | "powershell";
+type CodeLanguage = "javascript" | "jsx" | "typescript" | "tsx" | "bash" | "python" | "go" | "rust" | "java" | "kotlin" | "scala" | "dart" | "lua" | "zig" | "csharp" | "c" | "cpp" | "php" | "ruby" | "powershell";
 type CodeSymbolKind = "function" | "class" | "interface" | "type_alias" | "enum" | "variable" | "struct" | "trait";
 type OrchestrationRole = "research" | "audit" | "context" | "safety";
 declare const webSearchProviderTypeSchema: z.ZodEnum<{

package/dist/index.js

@@ -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)) {
@@ -17212,7 +17688,7 @@ async function bootstrapDemo(rootDir, input) {
 }
 
 // src/mcp.ts
-var SERVER_VERSION = "0.6.1";
+var SERVER_VERSION = "0.6.3";
 async function createMcpServer(rootDir) {
   const server = new McpServer({
     name: "swarmvault",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmvaultai/engine",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "description": "Core engine for SwarmVault: ingest, compile, query, lint, and provider abstractions.",
   "type": "module",
   "main": "dist/index.js",
@@ -42,7 +42,8 @@
   "scripts": {
     "build": "test -f ../viewer/dist/index.html || pnpm --dir ../viewer build; tsup src/index.ts --format esm --dts && rm -rf dist/viewer && mkdir -p dist/viewer && cp -R ../viewer/dist/. dist/viewer/",
     "test": "SWARMVAULT_ALLOW_PRIVATE_URLS=1 vitest run",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "node ../../scripts/check-release-sync.mjs && node ../../scripts/check-published-manifests.mjs"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",