@weftlet/core

Package version in this checkout/archive: @weftlet/[email protected]. The matching toolkit is @weftlet/[email protected].

Graph records, provider and adapter contracts, and deterministic keying utilities for Weftlet, an evidence-backed context-graph toolkit for AI development agents.

The core package has no runtime dependencies. Install @weftlet/toolkit for the CLI, MCP server, extraction, storage and graph queries.

Repository adapters should construct physical-file nodes with the public factory:

import { repositoryFileNode } from '@weftlet/core';

const file = repositoryFileNode('src/worker.spec.ts');
// { id: 'component:file:src/worker.spec.ts', label: 'src/worker.spec.ts', kind: 'Evidence' }

Markdown/MDX/text documents use document:<path> and Document; .spec.<extension> and .test.<extension> files use component:file:<path> and Evidence; other files use that file prefix and Component. Extension matching ignores case, while path spelling is retained. Supply a repository-relative path using the repository's canonical spelling. This pure mapping does not resolve paths, read files, detect every testing convention or approve product intent. Keep business-concept identities separate. Adapters can add attributes without changing the factory's id or kind; use the same node for mocked/DI/decorator-bearing tests and production sources. This API is available starting with 0.4.0; it is absent from 0.3.0.

Licensed under Apache-2.0; see LICENSE and NOTICE for attribution.

Version 0.7.0 adds the neutral exploration contracts GraphNeighborsRequest, GraphNeighborhood and GraphExplorationService for exact-node one-hop reads. graphPredicates supplies the shared runtime relation vocabulary used by extraction and query inputs. The toolkit supplies the RDF-backed implementation; core does not load a graph database, provider or repository.

GraphPathsRequest, GraphPaths and GraphPathQueryService describe bounded cited paths between exact snapshot endpoints, including work/depth limits, continuation and unexplored frontier. These contracts are available starting with 0.7.0.