@swarmvaultai/engine 0.6.7 → 0.7.0

package/dist/hooks/claude.js

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+
+// src/hooks/marker-state.ts
+import crypto from "crypto";
+import fs from "fs/promises";
+import os from "os";
+import path from "path";
+function markerState(cwd, agentKey) {
+  const hash = crypto.createHash("sha256").update(cwd).digest("hex");
+  const dir = path.join(os.tmpdir(), "swarmvault-agent-hooks", agentKey, hash);
+  return {
+    dir,
+    markerPath: path.join(dir, "report-read")
+  };
+}
+function isReportPath(value, cwd) {
+  if (typeof value !== "string" || value.length === 0) {
+    return false;
+  }
+  const reportSuffix = path.join("wiki", "graph", "report.md");
+  const normalized = value.replaceAll("\\", "/");
+  const reportNormalized = reportSuffix.replaceAll("\\", "/");
+  if (normalized.endsWith(reportNormalized)) {
+    return true;
+  }
+  return path.resolve(cwd, value) === path.resolve(cwd, reportSuffix);
+}
+function collectCandidatePaths(node, acc = []) {
+  if (typeof node === "string") {
+    acc.push(node);
+    return acc;
+  }
+  if (!node || typeof node !== "object") {
+    return acc;
+  }
+  if (Array.isArray(node)) {
+    for (const item of node) {
+      collectCandidatePaths(item, acc);
+    }
+    return acc;
+  }
+  for (const [key, value] of Object.entries(node)) {
+    if (["path", "filePath", "file_path", "paths", "target", "targets"].includes(key)) {
+      collectCandidatePaths(value, acc);
+      continue;
+    }
+    collectCandidatePaths(value, acc);
+  }
+  return acc;
+}
+function resolveInputCwd(input) {
+  const shaped = input ?? {};
+  const candidate = typeof shaped.cwd === "string" && shaped.cwd || typeof shaped.directory === "string" && shaped.directory || typeof shaped.workspace?.cwd === "string" && shaped.workspace.cwd || typeof shaped.toolInput?.cwd === "string" && shaped.toolInput.cwd || process.cwd();
+  return path.resolve(candidate);
+}
+function resolveToolName(input) {
+  const shaped = input ?? {};
+  return String(shaped.toolName ?? shaped.tool_name ?? shaped.tool?.name ?? shaped.name ?? "");
+}
+async function hasReport(cwd) {
+  try {
+    await fs.access(path.join(cwd, "wiki", "graph", "report.md"));
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function markReportRead(cwd, agentKey) {
+  const state = markerState(cwd, agentKey);
+  await fs.mkdir(state.dir, { recursive: true });
+  await fs.writeFile(state.markerPath, "seen\n", "utf8");
+}
+async function hasSeenReport(cwd, agentKey) {
+  const state = markerState(cwd, agentKey);
+  try {
+    await fs.access(state.markerPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function resetSession(cwd, agentKey) {
+  const state = markerState(cwd, agentKey);
+  await fs.rm(state.dir, { recursive: true, force: true });
+}
+function isBroadSearchTool(toolName) {
+  return /grep|glob|search|find/i.test(toolName);
+}
+async function readHookInput() {
+  let body = "";
+  for await (const chunk of process.stdin) {
+    body += chunk;
+  }
+  if (!body.trim()) {
+    return {};
+  }
+  try {
+    return JSON.parse(body);
+  } catch {
+    return {};
+  }
+}
+var REPORT_NOTE = "SwarmVault graph report exists at wiki/graph/report.md. Read it before broad grep/glob searching.";
+
+// src/hooks/claude.ts
+var AGENT_KEY = "claude";
+function emit(value) {
+  process.stdout.write(`${JSON.stringify(value)}
+`);
+}
+async function main() {
+  const mode = process.argv[2] ?? "";
+  const input = await readHookInput();
+  const cwd = resolveInputCwd(input);
+  if (!await hasReport(cwd)) {
+    emit({});
+    process.exit(0);
+  }
+  if (mode === "session-start") {
+    await resetSession(cwd, AGENT_KEY);
+    emit({
+      hookSpecificOutput: {
+        hookEventName: "SessionStart",
+        additionalContext: REPORT_NOTE
+      }
+    });
+    process.exit(0);
+  }
+  const toolName = resolveToolName(input);
+  if (collectCandidatePaths(input).some((value) => isReportPath(value, cwd))) {
+    await markReportRead(cwd, AGENT_KEY);
+    emit({});
+    process.exit(0);
+  }
+  if (isBroadSearchTool(toolName) && !await hasSeenReport(cwd, AGENT_KEY)) {
+    emit({
+      hookSpecificOutput: {
+        hookEventName: "PreToolUse",
+        additionalContext: REPORT_NOTE
+      }
+    });
+    process.exit(0);
+  }
+  emit({});
+}
+await main();

package/dist/hooks/copilot.js

@@ -0,0 +1,141 @@
+#!/usr/bin/env node
+
+// src/hooks/marker-state.ts
+import crypto from "crypto";
+import fs from "fs/promises";
+import os from "os";
+import path from "path";
+function markerState(cwd, agentKey) {
+  const hash = crypto.createHash("sha256").update(cwd).digest("hex");
+  const dir = path.join(os.tmpdir(), "swarmvault-agent-hooks", agentKey, hash);
+  return {
+    dir,
+    markerPath: path.join(dir, "report-read")
+  };
+}
+function isReportPath(value, cwd) {
+  if (typeof value !== "string" || value.length === 0) {
+    return false;
+  }
+  const reportSuffix = path.join("wiki", "graph", "report.md");
+  const normalized = value.replaceAll("\\", "/");
+  const reportNormalized = reportSuffix.replaceAll("\\", "/");
+  if (normalized.endsWith(reportNormalized)) {
+    return true;
+  }
+  return path.resolve(cwd, value) === path.resolve(cwd, reportSuffix);
+}
+function collectCandidatePaths(node, acc = []) {
+  if (typeof node === "string") {
+    acc.push(node);
+    return acc;
+  }
+  if (!node || typeof node !== "object") {
+    return acc;
+  }
+  if (Array.isArray(node)) {
+    for (const item of node) {
+      collectCandidatePaths(item, acc);
+    }
+    return acc;
+  }
+  for (const [key, value] of Object.entries(node)) {
+    if (["path", "filePath", "file_path", "paths", "target", "targets"].includes(key)) {
+      collectCandidatePaths(value, acc);
+      continue;
+    }
+    collectCandidatePaths(value, acc);
+  }
+  return acc;
+}
+function resolveInputCwd(input) {
+  const shaped = input ?? {};
+  const candidate = typeof shaped.cwd === "string" && shaped.cwd || typeof shaped.directory === "string" && shaped.directory || typeof shaped.workspace?.cwd === "string" && shaped.workspace.cwd || typeof shaped.toolInput?.cwd === "string" && shaped.toolInput.cwd || process.cwd();
+  return path.resolve(candidate);
+}
+function resolveToolName(input) {
+  const shaped = input ?? {};
+  return String(shaped.toolName ?? shaped.tool_name ?? shaped.tool?.name ?? shaped.name ?? "");
+}
+async function hasReport(cwd) {
+  try {
+    await fs.access(path.join(cwd, "wiki", "graph", "report.md"));
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function markReportRead(cwd, agentKey) {
+  const state = markerState(cwd, agentKey);
+  await fs.mkdir(state.dir, { recursive: true });
+  await fs.writeFile(state.markerPath, "seen\n", "utf8");
+}
+async function hasSeenReport(cwd, agentKey) {
+  const state = markerState(cwd, agentKey);
+  try {
+    await fs.access(state.markerPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function resetSession(cwd, agentKey) {
+  const state = markerState(cwd, agentKey);
+  await fs.rm(state.dir, { recursive: true, force: true });
+}
+function isBroadSearchTool(toolName) {
+  return /grep|glob|search|find/i.test(toolName);
+}
+async function readHookInput() {
+  let body = "";
+  for await (const chunk of process.stdin) {
+    body += chunk;
+  }
+  if (!body.trim()) {
+    return {};
+  }
+  try {
+    return JSON.parse(body);
+  } catch {
+    return {};
+  }
+}
+var REPORT_NOTE = "SwarmVault graph report exists at wiki/graph/report.md. Read it before broad grep/glob searching.";
+
+// src/hooks/copilot.ts
+var AGENT_KEY = "copilot";
+function emit(value) {
+  if (value !== void 0) {
+    process.stdout.write(`${JSON.stringify(value)}
+`);
+  }
+}
+async function main() {
+  const mode = process.argv[2] ?? "";
+  const input = await readHookInput();
+  const cwd = resolveInputCwd(input);
+  if (!await hasReport(cwd)) {
+    emit({});
+    process.exit(0);
+  }
+  if (mode === "session-start") {
+    await resetSession(cwd, AGENT_KEY);
+    emit({});
+    process.exit(0);
+  }
+  const toolName = resolveToolName(input);
+  if (collectCandidatePaths(input).some((value) => isReportPath(value, cwd))) {
+    await markReportRead(cwd, AGENT_KEY);
+    emit({});
+    process.exit(0);
+  }
+  if (isBroadSearchTool(toolName) && !await hasSeenReport(cwd, AGENT_KEY)) {
+    emit({
+      permissionDecision: "deny",
+      permissionDecisionReason: REPORT_NOTE
+    });
+    process.exit(0);
+  }
+  emit({});
+}
+await main();

package/dist/hooks/gemini.js

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+
+// src/hooks/marker-state.ts
+import crypto from "crypto";
+import fs from "fs/promises";
+import os from "os";
+import path from "path";
+function markerState(cwd, agentKey) {
+  const hash = crypto.createHash("sha256").update(cwd).digest("hex");
+  const dir = path.join(os.tmpdir(), "swarmvault-agent-hooks", agentKey, hash);
+  return {
+    dir,
+    markerPath: path.join(dir, "report-read")
+  };
+}
+function isReportPath(value, cwd) {
+  if (typeof value !== "string" || value.length === 0) {
+    return false;
+  }
+  const reportSuffix = path.join("wiki", "graph", "report.md");
+  const normalized = value.replaceAll("\\", "/");
+  const reportNormalized = reportSuffix.replaceAll("\\", "/");
+  if (normalized.endsWith(reportNormalized)) {
+    return true;
+  }
+  return path.resolve(cwd, value) === path.resolve(cwd, reportSuffix);
+}
+function collectCandidatePaths(node, acc = []) {
+  if (typeof node === "string") {
+    acc.push(node);
+    return acc;
+  }
+  if (!node || typeof node !== "object") {
+    return acc;
+  }
+  if (Array.isArray(node)) {
+    for (const item of node) {
+      collectCandidatePaths(item, acc);
+    }
+    return acc;
+  }
+  for (const [key, value] of Object.entries(node)) {
+    if (["path", "filePath", "file_path", "paths", "target", "targets"].includes(key)) {
+      collectCandidatePaths(value, acc);
+      continue;
+    }
+    collectCandidatePaths(value, acc);
+  }
+  return acc;
+}
+function resolveInputCwd(input) {
+  const shaped = input ?? {};
+  const candidate = typeof shaped.cwd === "string" && shaped.cwd || typeof shaped.directory === "string" && shaped.directory || typeof shaped.workspace?.cwd === "string" && shaped.workspace.cwd || typeof shaped.toolInput?.cwd === "string" && shaped.toolInput.cwd || process.cwd();
+  return path.resolve(candidate);
+}
+function resolveToolName(input) {
+  const shaped = input ?? {};
+  return String(shaped.toolName ?? shaped.tool_name ?? shaped.tool?.name ?? shaped.name ?? "");
+}
+async function hasReport(cwd) {
+  try {
+    await fs.access(path.join(cwd, "wiki", "graph", "report.md"));
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function markReportRead(cwd, agentKey) {
+  const state = markerState(cwd, agentKey);
+  await fs.mkdir(state.dir, { recursive: true });
+  await fs.writeFile(state.markerPath, "seen\n", "utf8");
+}
+async function hasSeenReport(cwd, agentKey) {
+  const state = markerState(cwd, agentKey);
+  try {
+    await fs.access(state.markerPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function resetSession(cwd, agentKey) {
+  const state = markerState(cwd, agentKey);
+  await fs.rm(state.dir, { recursive: true, force: true });
+}
+function isBroadSearchTool(toolName) {
+  return /grep|glob|search|find/i.test(toolName);
+}
+async function readHookInput() {
+  let body = "";
+  for await (const chunk of process.stdin) {
+    body += chunk;
+  }
+  if (!body.trim()) {
+    return {};
+  }
+  try {
+    return JSON.parse(body);
+  } catch {
+    return {};
+  }
+}
+var REPORT_NOTE = "SwarmVault graph report exists at wiki/graph/report.md. Read it before broad grep/glob searching.";
+
+// src/hooks/gemini.ts
+var AGENT_KEY = "gemini";
+function emit(value) {
+  process.stdout.write(`${JSON.stringify(value)}
+`);
+}
+async function main() {
+  const mode = process.argv[2] ?? "";
+  const input = await readHookInput();
+  const cwd = resolveInputCwd(input);
+  if (!await hasReport(cwd)) {
+    emit({});
+    process.exit(0);
+  }
+  if (mode === "session-start") {
+    await resetSession(cwd, AGENT_KEY);
+    emit({
+      systemMessage: REPORT_NOTE,
+      hookSpecificOutput: {
+        hookEventName: "SessionStart",
+        additionalContext: "SwarmVault graph report: wiki/graph/report.md"
+      }
+    });
+    process.exit(0);
+  }
+  const toolName = resolveToolName(input);
+  if (collectCandidatePaths(input).some((value) => isReportPath(value, cwd))) {
+    await markReportRead(cwd, AGENT_KEY);
+    emit({});
+    process.exit(0);
+  }
+  if (isBroadSearchTool(toolName) && !await hasSeenReport(cwd, AGENT_KEY)) {
+    emit({ systemMessage: REPORT_NOTE });
+    process.exit(0);
+  }
+  emit({});
+}
+await main();

package/dist/hooks/opencode.js

@@ -0,0 +1,50 @@
+// src/hooks/opencode.ts
+import path from "path";
+var reportRelativePath = path.join("wiki", "graph", "report.md");
+var name = "swarmvault-graph-first";
+async function swarmvaultGraphFirst({ client }) {
+  let reportSeen = false;
+  async function hasReport(cwd) {
+    try {
+      await Bun.file(path.join(cwd, reportRelativePath)).arrayBuffer();
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async function note(message) {
+    if (client?.app?.log) {
+      await client.app.log({
+        level: "info",
+        message
+      });
+    }
+  }
+  return {
+    async "session.created"(input) {
+      reportSeen = false;
+      const cwd = input?.session?.cwd ?? process.cwd();
+      if (await hasReport(cwd)) {
+        await note("SwarmVault graph report exists. Read wiki/graph/report.md before broad workspace searching.");
+      }
+    },
+    async "tool.execute.before"(input) {
+      const cwd = input?.session?.cwd ?? process.cwd();
+      if (!await hasReport(cwd)) {
+        return;
+      }
+      const argsText = JSON.stringify(input?.args ?? {});
+      if (argsText.includes("wiki/graph/report.md")) {
+        reportSeen = true;
+        return;
+      }
+      if (!reportSeen && ["glob", "grep"].includes(String(input?.tool ?? ""))) {
+        await note("SwarmVault graph report exists. Read wiki/graph/report.md before broad workspace searching.");
+      }
+    }
+  };
+}
+export {
+  swarmvaultGraphFirst as default,
+  name
+};

package/dist/index.d.ts

@@ -60,12 +60,12 @@ type GuidedSourceSessionStatus = "awaiting_input" | "ready_to_stage" | "staged"
 type VaultProfilePreset = "reader" | "timeline" | "diligence" | "thesis";
 type VaultDashboardPack = "default" | "reader" | "diligence";
 type GuidedSessionMode = "insights_only" | "canonical_review";
-type SourceKind = "markdown" | "text" | "pdf" | "image" | "html" | "docx" | "epub" | "csv" | "xlsx" | "pptx" | "transcript" | "chat_export" | "email" | "calendar" | "binary" | "code";
+type SourceKind = "markdown" | "text" | "pdf" | "image" | "html" | "docx" | "epub" | "csv" | "xlsx" | "pptx" | "odt" | "odp" | "ods" | "jupyter" | "data" | "bibtex" | "rtf" | "org" | "asciidoc" | "transcript" | "chat_export" | "email" | "calendar" | "binary" | "code";
 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" | "bash" | "python" | "go" | "rust" | "java" | "kotlin" | "scala" | "dart" | "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" | "swift" | "elixir" | "ocaml" | "objc" | "rescript" | "solidity" | "html" | "css" | "vue";
 type CodeSymbolKind = "function" | "class" | "interface" | "type_alias" | "enum" | "variable" | "struct" | "trait";
 type OrchestrationRole = "research" | "audit" | "context" | "safety";
 declare const webSearchProviderTypeSchema: z.ZodEnum<{
@@ -245,7 +245,7 @@ interface SourceAttachment {
     mimeType: string;
     originalPath?: string;
 }
-type ExtractionKind = "plain_text" | "html_readability" | "pdf_text" | "docx_text" | "epub_text" | "csv_text" | "xlsx_text" | "pptx_text" | "transcript_text" | "chat_export_text" | "email_text" | "calendar_text" | "image_vision";
+type ExtractionKind = "plain_text" | "html_readability" | "pdf_text" | "docx_text" | "epub_text" | "csv_text" | "xlsx_text" | "pptx_text" | "odt_text" | "odp_text" | "ods_text" | "jupyter_text" | "structured_data" | "bibtex_text" | "rtf_text" | "org_text" | "asciidoc_text" | "transcript_text" | "chat_export_text" | "email_text" | "calendar_text" | "image_vision";
 interface ExtractionTerm {
     name: string;
     description: string;
@@ -1053,7 +1053,6 @@ interface BenchmarkArtifact {
     reductionRatio: number;
     sampleQuestions: string[];
     perQuestion: BenchmarkQuestionResult[];
-    questionResults: BenchmarkQuestionResult[];
     summary: BenchmarkSummary;
 }
 interface EmbeddingCacheEntry {