@hraness/wordcell 0.20.0 → 0.21.0

package/dist/index-bgfzwt4h.js

@@ -0,0 +1,51 @@
+// @bun
+import {
+  createGraphSnapshot,
+  openGraphAuthority
+} from "./index-bcfn9xah.js";
+import {
+  GraphAuthorityError,
+  validateGraphPercolationOptions
+} from "./index-11621h23.js";
+import {
+  percolateVault
+} from "./index-nd6nynv2.js";
+import {
+  analyzeVault,
+  lookupNote,
+  parseNote
+} from "./index-ekpwvbra.js";
+
+// src/graph-percolation.ts
+async function percolateWithGraph(snapshot, options) {
+  options = validateGraphPercolationOptions(options);
+  const graph = createGraphSnapshot(snapshot);
+  const notes = snapshot.notes.map((note) => parseNote(note.path, note.content));
+  const selected = lookupNote(notes, options.note);
+  if (selected.kind !== "found" || !graph.records.some((record) => record.id === selected.note.id)) {
+    throw new GraphAuthorityError("invalid-input", "Proof-backed percolation requires one unambiguous content note.");
+  }
+  const analysis = analyzeVault(notes, {
+    catalogNoteId: graph.catalogNoteId,
+    mentionScope: (note) => note.id === selected.note.id,
+    maxMentionPairs: 250000
+  });
+  const suggestions = percolateVault(notes, analysis, options);
+  const authority = await openGraphAuthority(snapshot);
+  try {
+    const limits = { rows: 1000, workUnits: 1e6, resultBytes: 1024 * 1024 };
+    const sharedTags = await authority.query({ program: "shared-tags", note: selected.note.id, limits });
+    const sharedConcepts = await authority.query({ program: "shared-concepts", note: selected.note.id, limits });
+    return Object.freeze({
+      schemaVersion: 1,
+      kind: "wordcell.graph-percolation",
+      revision: graph.revision,
+      suggestions,
+      positiveSupport: Object.freeze({ sharedTags, sharedConcepts })
+    });
+  } finally {
+    await authority.close();
+  }
+}
+
+export { percolateWithGraph };

package/dist/{index-bs0yf4pp.js → index-pbr6rv47.js}

@@ -2,10 +2,10 @@
 import {
   MAX_SEARCH_RESULTS,
   openKnowledgeBase
-} from "./index-m7et4rz4.js";
+} from "./index-vdw5yjfa.js";
 import {
   scanVault
-} from "./index-n05s3wsb.js";
+} from "./index-0k2x4nn9.js";
 import {
   runGitCommand
 } from "./index-1gwbassd.js";

package/dist/{index-m7et4rz4.js → index-vdw5yjfa.js}

@@ -1,4 +1,8 @@
 // @bun
+import {
+  UntrustedContentBudgetError,
+  createUntrustedToolResult
+} from "./index-4j3tt0c3.js";
 import {
   expandSearchRequest,
   parseSearchRules,
@@ -6,13 +10,21 @@ import {
 } from "./index-adx6khj5.js";
 import {
   openSemanticSearchSession,
-  recommendedEmbeddingModel,
-  scanVault
-} from "./index-n05s3wsb.js";
+  recommendedEmbeddingModel
+} from "./index-115b07ap.js";
 import {
-  UntrustedContentBudgetError,
-  createUntrustedToolResult
-} from "./index-4j3tt0c3.js";
+  percolateWithGraph
+} from "./index-bgfzwt4h.js";
+import {
+  openGraphAuthority
+} from "./index-bcfn9xah.js";
+import {
+  validateGraphPercolationOptions,
+  validateGraphQueryRequest
+} from "./index-11621h23.js";
+import {
+  scanVault
+} from "./index-0k2x4nn9.js";
 import {
   GitHistoryError,
   gitHistoryForNotes,
@@ -210,10 +222,26 @@ async function openKnowledgeBase(options, dependencies = {}) {
   let closePromise;
   let semanticPromise = injectedSemantic === undefined ? undefined : Promise.resolve(injectedSemantic);
   let gitPromise;
+  let graphAuthorityPromise;
+  let graphOperationTail = Promise.resolve();
   const assertOpen = () => {
     if (closeRequested)
       throw new Error("Knowledge-base session is closed.");
   };
+  const withGraphOperation = (operation) => {
+    assertOpen();
+    const pending = graphOperationTail.then(operation);
+    graphOperationTail = pending.then(() => {
+      return;
+    }, () => {
+      return;
+    });
+    return pending;
+  };
+  const withGraphAuthority = (operation) => withGraphOperation(async () => {
+    graphAuthorityPromise ??= (dependencies.openGraphAuthority ?? openGraphAuthority)(snapshot);
+    return operation(await graphAuthorityPromise);
+  });
   const semantic = () => {
     assertOpen();
     semanticPromise ??= (dependencies.openSemanticSearchSession ?? openSemanticSearchSession)({
@@ -542,6 +570,17 @@ async function openKnowledgeBase(options, dependencies = {}) {
       ...linkOptions,
       direction: "in"
     }),
+    graphQuery: async (request) => {
+      assertOpen();
+      const checked = validateGraphQueryRequest(request);
+      return withGraphAuthority((authority) => authority.query(checked));
+    },
+    graphVerifyResult: async (value) => withGraphAuthority((authority) => authority.verifyResult(value)),
+    percolateWithProofs: async (percolateOptions) => {
+      assertOpen();
+      const checked = validateGraphPercolationOptions(percolateOptions);
+      return withGraphOperation(() => (dependencies.percolateWithGraph ?? percolateWithGraph)(snapshot, checked));
+    },
     search,
     history: async (noteIds, historyOptions = {}) => {
       assertOpen();
@@ -563,9 +602,22 @@ async function openKnowledgeBase(options, dependencies = {}) {
       if (closePromise !== undefined)
         return closePromise;
       closeRequested = true;
-      closePromise = semanticPromise === undefined ? Promise.resolve() : semanticPromise.then((session) => session.close(), () => {
-        return;
-      });
+      closePromise = (async () => {
+        const semanticClose = semanticPromise === undefined ? Promise.resolve() : semanticPromise.then((session) => session.close(), () => {
+          return;
+        });
+        const graphClose = graphOperationTail.then(async () => {
+          await graphAuthorityPromise?.then((authority) => authority.close(), () => {
+            return;
+          });
+        });
+        const results = await Promise.allSettled([semanticClose, graphClose]);
+        const errors = results.filter((result) => result.status === "rejected").map((result) => result.reason);
+        if (errors.length === 1)
+          throw errors[0];
+        if (errors.length > 1)
+          throw new AggregateError(errors, "Knowledge-base stores could not close.");
+      })();
       return closePromise;
     }
   };

package/dist/index-z1w83f81.js

@@ -0,0 +1,4 @@
+// @bun
+var __require = import.meta.require;
+
+export { __require };

package/dist/index.js

@@ -26,28 +26,7 @@ import {
   knowledgeBaseEvaluationRetrieverIds,
   openKnowledgeBaseEvaluation,
   verifyFrozenEvaluationSnapshot
-} from "./index-bs0yf4pp.js";
-import {
-  DEFAULT_PERCOLATION_LIMIT,
-  DEFAULT_PERCOLATION_MIN_SUPPORT,
-  MAX_PERCOLATION_EVIDENCE_PER_CANDIDATE,
-  MAX_PERCOLATION_LIMIT,
-  MAX_PERCOLATION_MENTIONS,
-  MAX_PERCOLATION_MENTION_PAIRS,
-  MAX_PERCOLATION_NOTES,
-  MAX_PERCOLATION_RESULT_NODES,
-  MAX_PERCOLATION_RESULT_UTF8_BYTES,
-  MAX_PERCOLATION_TEXT_UTF8_BYTES,
-  MAX_SCOPED_PERCOLATION_MENTION_PAIRS,
-  PERCOLATION_RESULT_SCHEMA_VERSION,
-  parsePercolationCliOutput,
-  parsePercolationCliOutputV1,
-  parsePercolationCliOutputV2,
-  parsePercolationResult,
-  parsePercolationResultV1,
-  parsePercolationResultV2,
-  percolateVault
-} from "./index-nd6nynv2.js";
+} from "./index-pbr6rv47.js";
 import {
   DEFAULT_SEARCH_RESULTS,
   MAX_SEARCH_CANDIDATES,
@@ -59,34 +38,72 @@ import {
   packSearchContext,
   packUntrustedSearchContext,
   validateKnowledgeBaseSearchHistory
-} from "./index-m7et4rz4.js";
+} from "./index-vdw5yjfa.js";
+import"./index-4j3tt0c3.js";
 import"./index-adx6khj5.js";
 import {
   MAX_EMBEDDING_MODEL_BYTES,
-  MAX_NOTE_UTF8_BYTES,
-  MAX_SCANNED_NOTES,
   MAX_SEMANTIC_DATABASE_IDENTITY_BYTES,
-  MAX_VAULT_UTF8_BYTES,
-  VaultScanBudgetError,
   attestSemanticWarmCache,
   checkpointSemanticWarmCache,
   createVerifiedEmbeddingModelLease,
-  defaultIgnoredDirectories,
   indexSemanticVault,
-  markdownFiles,
   openSemanticSearchSession,
   openSemanticWarmSearchSession,
   qmdIndexerVersion,
-  readVaultNotes,
   recommendedEmbeddingModel,
   recommendedEmbeddingModelSha256,
-  refreshVault,
-  scanVault,
   searchSemanticVault,
   semanticDatabasePath,
   sha256EmbeddingModelFile
-} from "./index-n05s3wsb.js";
-import"./index-4j3tt0c3.js";
+} from "./index-115b07ap.js";
+import {
+  percolateWithGraph
+} from "./index-bgfzwt4h.js";
+import {
+  createGraphSnapshot,
+  openGraphAuthority,
+  queryGraph,
+  rebuildGraph,
+  verifyGraph
+} from "./index-bcfn9xah.js";
+import {
+  GRAPH_LIMITS,
+  GraphAuthorityError,
+  validateGraphQueryRequest
+} from "./index-11621h23.js";
+import {
+  MAX_NOTE_UTF8_BYTES,
+  MAX_SCANNED_NOTES,
+  MAX_VAULT_UTF8_BYTES,
+  VaultScanBudgetError,
+  defaultIgnoredDirectories,
+  markdownFiles,
+  readVaultNotes,
+  refreshVault,
+  scanVault
+} from "./index-0k2x4nn9.js";
+import {
+  DEFAULT_PERCOLATION_LIMIT,
+  DEFAULT_PERCOLATION_MIN_SUPPORT,
+  MAX_PERCOLATION_EVIDENCE_PER_CANDIDATE,
+  MAX_PERCOLATION_LIMIT,
+  MAX_PERCOLATION_MENTIONS,
+  MAX_PERCOLATION_MENTION_PAIRS,
+  MAX_PERCOLATION_NOTES,
+  MAX_PERCOLATION_RESULT_NODES,
+  MAX_PERCOLATION_RESULT_UTF8_BYTES,
+  MAX_PERCOLATION_TEXT_UTF8_BYTES,
+  MAX_SCOPED_PERCOLATION_MENTION_PAIRS,
+  PERCOLATION_RESULT_SCHEMA_VERSION,
+  parsePercolationCliOutput,
+  parsePercolationCliOutputV1,
+  parsePercolationCliOutputV2,
+  parsePercolationResult,
+  parsePercolationResultV1,
+  parsePercolationResultV2,
+  percolateVault
+} from "./index-nd6nynv2.js";
 import {
   GitHistoryError,
   MAX_GIT_HISTORY_COMMITS,
@@ -256,6 +273,7 @@ import {
   wikiLinks
 } from "./index-ekpwvbra.js";
 import"./index-1xxnjn0d.js";
+import"./index-z1w83f81.js";
 // src/oh-adoption.ts
 import { createHash } from "crypto";
 import { posix } from "path";
@@ -567,6 +585,7 @@ function createOhAdoptionPreparerV1(value) {
 export {
   workflowFromUnknown,
   wikiLinks,
+  verifyGraph,
   verifyFrozenEvaluationSnapshot,
   validateSearchQuery,
   validateSearchGitHistoryOptions,
@@ -574,6 +593,7 @@ export {
   validateQueryOptions,
   validateMarkdownAttachments,
   validateKnowledgeBaseSearchHistory,
+  validateGraphQueryRequest,
   validateGitHistoryForNotesRequest,
   validateGitHistoryForNotesOptions,
   validateAttachmentReferences,
@@ -598,10 +618,13 @@ export {
   refreshVault,
   recommendedEmbeddingModelSha256,
   recommendedEmbeddingModel,
+  rebuildGraph,
   readVaultNotes,
   queryVault,
+  queryGraph,
   qmdIndexerVersion,
   planStatuses,
+  percolateWithGraph,
   percolateVault,
   parseRetrievalEvaluationCorpus,
   parsePercolationResultV2,
@@ -621,6 +644,7 @@ export {
   openSemanticSearchSession,
   openKnowledgeBaseEvaluation,
   openKnowledgeBase,
+  openGraphAuthority,
   noteRevision,
   normalizeVaultPath,
   normalizeRepositoryScope,
@@ -658,6 +682,7 @@ export {
   createRepresentativeRetrievalFixture,
   createOhAdoptionPreparerV1,
   createNote,
+  createGraphSnapshot,
   createConceptNote,
   compareAgentGuideAudits,
   classifyRepositoryMemoryRecord,
@@ -772,7 +797,9 @@ export {
   MAX_ATTACHMENT_PATH_BYTES,
   MAX_ANALYZED_NOTES,
   InvalidCanonicalNoteIdError,
+  GraphAuthorityError,
   GitHistoryError,
+  GRAPH_LIMITS,
   FrozenEvaluationSnapshotError,
   DEFAULT_WORKFLOW_OUTPUT_BYTES,
   DEFAULT_SEARCH_RESULTS,

package/dist/navigation.js

@@ -5,6 +5,7 @@ import {
   NavigationBudgetError,
   navigateLinks
 } from "./index-d13v9ckt.js";
+import"./index-z1w83f81.js";
 export {
   navigateLinks,
   NavigationBudgetError,

package/dist/pdf.js

@@ -31,6 +31,7 @@ import"./index-e5fbsywq.js";
 import"./index-gh719d91.js";
 import"./index-mxxxytys.js";
 import"./index-1xxnjn0d.js";
+import"./index-z1w83f81.js";
 
 // src/pdf.ts
 var PDF_CAPTURE_MANIFEST_FILENAME2 = PDF_CAPTURE_MANIFEST_FILENAME;

package/dist/percolate.js

@@ -21,6 +21,7 @@ import {
   percolateVault
 } from "./index-nd6nynv2.js";
 import"./index-ekpwvbra.js";
+import"./index-z1w83f81.js";
 export {
   percolateVault,
   parsePercolationResultV2,

package/dist/portfolio.js

@@ -20,13 +20,19 @@ import {
   selectAuthorizedVaults,
   snapshotPortfolioRegistry,
   validateResolvedPortfolioVaults
-} from "./index-tkpxp48t.js";
-import"./index-m7et4rz4.js";
-import"./index-adx6khj5.js";
-import"./index-n05s3wsb.js";
+} from "./index-51bap0mq.js";
+import"./index-vdw5yjfa.js";
 import"./index-4j3tt0c3.js";
+import"./index-adx6khj5.js";
+import"./index-115b07ap.js";
+import"./index-bgfzwt4h.js";
+import"./index-bcfn9xah.js";
+import"./index-11621h23.js";
+import"./index-0k2x4nn9.js";
+import"./index-nd6nynv2.js";
 import"./index-1gwbassd.js";
 import"./index-x3fthpsc.js";
+import"./index-3rm7cz6h.js";
 import"./index-why54q5p.js";
 import"./index-48pz4jpc.js";
 import"./index-06c9ctr6.js";
@@ -44,6 +50,7 @@ import {
   portfolioVaultIdentity
 } from "./index-ekpwvbra.js";
 import"./index-1xxnjn0d.js";
+import"./index-z1w83f81.js";
 export {
   validateResolvedPortfolioVaults,
   snapshotPortfolioRegistry,

package/dist/query.js

@@ -14,6 +14,7 @@ import {
 } from "./index-48pz4jpc.js";
 import"./index-06c9ctr6.js";
 import"./index-5vwpzb5a.js";
+import"./index-z1w83f81.js";
 export {
   validateQueryOptions,
   queryVault,

package/dist/repository-memory.js

@@ -29,6 +29,7 @@ import {
   validateRepositoryScopeSelection
 } from "./index-06c9ctr6.js";
 import"./index-5vwpzb5a.js";
+import"./index-z1w83f81.js";
 export {
   validateRepositoryScopeSelection,
   terminalPlanStatuses,

package/dist/sdk.js

@@ -10,11 +10,17 @@ import {
   packSearchContext,
   packUntrustedSearchContext,
   validateKnowledgeBaseSearchHistory
-} from "./index-m7et4rz4.js";
-import"./index-adx6khj5.js";
-import"./index-n05s3wsb.js";
+} from "./index-vdw5yjfa.js";
 import"./index-4j3tt0c3.js";
+import"./index-adx6khj5.js";
+import"./index-115b07ap.js";
+import"./index-bgfzwt4h.js";
+import"./index-bcfn9xah.js";
+import"./index-11621h23.js";
+import"./index-0k2x4nn9.js";
+import"./index-nd6nynv2.js";
 import"./index-1gwbassd.js";
+import"./index-3rm7cz6h.js";
 import"./index-why54q5p.js";
 import"./index-48pz4jpc.js";
 import"./index-06c9ctr6.js";
@@ -22,6 +28,7 @@ import"./index-d13v9ckt.js";
 import"./index-5vwpzb5a.js";
 import"./index-ekpwvbra.js";
 import"./index-1xxnjn0d.js";
+import"./index-z1w83f81.js";
 export {
   validateKnowledgeBaseSearchHistory,
   packUntrustedSearchContext,

package/dist/search-rules.js

@@ -17,6 +17,7 @@ import {
 import"./index-48pz4jpc.js";
 import"./index-06c9ctr6.js";
 import"./index-5vwpzb5a.js";
+import"./index-z1w83f81.js";
 export {
   prioritizeSearchHits,
   parseSearchRules,

package/dist/search.js

@@ -12,6 +12,7 @@ import"./index-06c9ctr6.js";
 import"./index-d13v9ckt.js";
 import"./index-5vwpzb5a.js";
 import"./index-ekpwvbra.js";
+import"./index-z1w83f81.js";
 export {
   validateSearchQuery,
   searchExactVault,

package/dist/semantic.js

@@ -14,13 +14,15 @@ import {
   searchSemanticVault,
   semanticDatabasePath,
   sha256EmbeddingModelFile
-} from "./index-n05s3wsb.js";
+} from "./index-115b07ap.js";
+import"./index-0k2x4nn9.js";
 import"./index-why54q5p.js";
 import"./index-48pz4jpc.js";
 import"./index-06c9ctr6.js";
 import"./index-d13v9ckt.js";
 import"./index-5vwpzb5a.js";
 import"./index-ekpwvbra.js";
+import"./index-z1w83f81.js";
 export {
   sha256EmbeddingModelFile,
   semanticDatabasePath,

package/dist/source-inbox.js

@@ -7,6 +7,7 @@ import {
   MAX_SOURCE_INBOX_RESULTS,
   sourceInbox
 } from "./index-pj501bh1.js";
+import"./index-z1w83f81.js";
 export {
   sourceInbox,
   MAX_SOURCE_INBOX_RESULTS,

package/dist/untrusted-content.js

@@ -15,6 +15,7 @@ import {
   projectUntrustedJson
 } from "./index-4j3tt0c3.js";
 import"./index-1xxnjn0d.js";
+import"./index-z1w83f81.js";
 export {
   projectUntrustedJson,
   createUntrustedToolResult,

package/dist/url-intelligence.js

@@ -28,6 +28,7 @@ import"./index-e5fbsywq.js";
 import"./index-gh719d91.js";
 import"./index-mxxxytys.js";
 import"./index-1xxnjn0d.js";
+import"./index-z1w83f81.js";
 
 // src/url-intelligence.ts
 var acquireArchiveTodaySnapshot2 = (...arguments_) => acquireArchiveTodaySnapshot(...arguments_);

package/dist/workflow.js

@@ -10,6 +10,7 @@ import {
   runWorkflow,
   workflowFromUnknown
 } from "./index-h170byqw.js";
+import"./index-z1w83f81.js";
 export {
   workflowFromUnknown,
   runWorkflow,

package/dist/workflows/decision-context.js

@@ -1,13 +1,19 @@
 // @bun
 import {
   decisionContextWorkflow
-} from "../index-8a08v6x8.js";
+} from "../index-59ssmqqm.js";
 import"../index-h170byqw.js";
-import"../index-m7et4rz4.js";
-import"../index-adx6khj5.js";
-import"../index-n05s3wsb.js";
+import"../index-vdw5yjfa.js";
 import"../index-4j3tt0c3.js";
+import"../index-adx6khj5.js";
+import"../index-115b07ap.js";
+import"../index-bgfzwt4h.js";
+import"../index-bcfn9xah.js";
+import"../index-11621h23.js";
+import"../index-0k2x4nn9.js";
+import"../index-nd6nynv2.js";
 import"../index-1gwbassd.js";
+import"../index-3rm7cz6h.js";
 import"../index-why54q5p.js";
 import"../index-48pz4jpc.js";
 import"../index-06c9ctr6.js";
@@ -15,6 +21,7 @@ import"../index-d13v9ckt.js";
 import"../index-5vwpzb5a.js";
 import"../index-ekpwvbra.js";
 import"../index-1xxnjn0d.js";
+import"../index-z1w83f81.js";
 export {
   decisionContextWorkflow
 };

package/dist/workflows/explain-change.js

@@ -3,6 +3,7 @@ import {
   explainChangeWorkflow
 } from "../index-e4fagfjz.js";
 import"../index-h170byqw.js";
+import"../index-z1w83f81.js";
 export {
   explainChangeWorkflow
 };

package/dist/workflows/index.js

@@ -1,7 +1,7 @@
 // @bun
 import {
   decisionContextWorkflow
-} from "../index-8a08v6x8.js";
+} from "../index-59ssmqqm.js";
 import {
   explainChangeWorkflow
 } from "../index-e4fagfjz.js";
@@ -9,11 +9,17 @@ import {
   planRadarWorkflow
 } from "../index-rdd5f7jj.js";
 import"../index-h170byqw.js";
-import"../index-m7et4rz4.js";
-import"../index-adx6khj5.js";
-import"../index-n05s3wsb.js";
+import"../index-vdw5yjfa.js";
 import"../index-4j3tt0c3.js";
+import"../index-adx6khj5.js";
+import"../index-115b07ap.js";
+import"../index-bgfzwt4h.js";
+import"../index-bcfn9xah.js";
+import"../index-11621h23.js";
+import"../index-0k2x4nn9.js";
+import"../index-nd6nynv2.js";
 import"../index-1gwbassd.js";
+import"../index-3rm7cz6h.js";
 import"../index-why54q5p.js";
 import"../index-48pz4jpc.js";
 import"../index-06c9ctr6.js";
@@ -21,6 +27,7 @@ import"../index-d13v9ckt.js";
 import"../index-5vwpzb5a.js";
 import"../index-ekpwvbra.js";
 import"../index-1xxnjn0d.js";
+import"../index-z1w83f81.js";
 export {
   planRadarWorkflow,
   explainChangeWorkflow,

package/dist/workflows/plan-radar.js

@@ -5,6 +5,7 @@ import {
 import"../index-h170byqw.js";
 import"../index-06c9ctr6.js";
 import"../index-5vwpzb5a.js";
+import"../index-z1w83f81.js";
 export {
   planRadarWorkflow
 };