@happyvertical/smrt-core 0.51.32 → 0.51.34

package/dist/dispatch/types.d.ts

@@ -1,5 +1,10 @@
-import { DatabaseInterface } from '@happyvertical/sql';
-import { DispatchTenantScope } from './tenant-resolver.js';
+/**
+ * Type definitions for the Dispatch system
+ *
+ * Provides inter-agent communication through persistent dispatch messages.
+ */
+import type { DatabaseInterface } from '@happyvertical/sql';
+import type { DispatchTenantScope } from './tenant-resolver.js';
 /**
  * Dispatch message status
  */

package/dist/embedded-write-queue.d.ts

@@ -1,4 +1,4 @@
-import { DatabaseInterface } from '@happyvertical/sql';
+import { type DatabaseInterface } from '@happyvertical/sql';
 interface QueueableDatabase {
     url?: string;
 }

package/dist/embeddings/provider.d.ts

@@ -1,4 +1,11 @@
-import { EmbeddingProviderType, ProjectEmbeddingConfig } from './types';
+/**
+ * Embedding Provider
+ *
+ * Unified interface for generating embeddings using local models or AI APIs.
+ * Supports transformers.js packages for local inference and @happyvertical/ai
+ * for cloud embeddings.
+ */
+import type { EmbeddingProviderType, ProjectEmbeddingConfig } from './types';
 export type OptionalModuleImporter = (moduleName: string) => Promise<unknown>;
 export declare const LOCAL_TRANSFORMERS_PACKAGES: readonly ["@huggingface/transformers", "@xenova/transformers"];
 export type LocalTransformersPackage = (typeof LOCAL_TRANSFORMERS_PACKAGES)[number];

package/dist/embeddings/storage.d.ts

@@ -1,5 +1,11 @@
-import { DatabaseInterface, VectorCapabilities } from '@happyvertical/sql';
-import { StoredEmbedding } from './types';
+/**
+ * Embedding Storage Operations
+ *
+ * CRUD operations for the _smrt_embeddings system table.
+ * Supports both JSON-based and native vector storage strategies.
+ */
+import type { DatabaseInterface, VectorCapabilities } from '@happyvertical/sql';
+import type { StoredEmbedding } from './types';
 /**
  * Storage operations for embeddings in _smrt_embeddings table
  */

package/dist/filesystem-loader.d.ts

@@ -1,4 +1,19 @@
-import { FilesystemAdapter, FilesystemAdapterOptions } from '@happyvertical/files';
+/**
+ * Filesystem adapter acquisition boundary.
+ *
+ * `@happyvertical/files` statically imports @aws-sdk/client-s3 and reaches
+ * googleapis from its root, so SmrtClass must not import it eagerly — that
+ * single edge put the whole files SDK into every downstream SSR bundle
+ * (#1977/#1978). Filesystem support is acquired here instead:
+ *
+ *  - Runtimes with node_modules (Node, tsx, vite dev, externalized SSR) work
+ *    unchanged: the adapter is loaded on first use via a bundler-invisible
+ *    import.
+ *  - Fully-bundled deployments opt in explicitly with
+ *    `import '@happyvertical/smrt-core/filesystem'` at server startup, which
+ *    registers the statically-imported adapter factory.
+ */
+import type { FilesystemAdapter, FilesystemAdapterOptions } from '@happyvertical/files';
 export type FilesystemAdapterFactory = (options: FilesystemAdapterOptions) => Promise<FilesystemAdapter>;
 /**
  * Registers the factory used to satisfy `fs` options on SmrtClass instances.

package/dist/generators/changes-route.d.ts

@@ -1,4 +1,37 @@
-import { DatabaseInterface } from '@happyvertical/sql';
+/**
+ * Generated `_changes` HTTP route for the change feed (issue #1758).
+ *
+ * Handles `GET {basePath}/_changes` in the REST generator: an auth-guarded,
+ * tenant-scoped cursor read over the `_smrt_changes` log. This module keeps
+ * the feed logic out of `rest.ts` (which only registers the path) so
+ * sibling generator changes stay conflict-free.
+ *
+ * Contract (part of the client/mobile sync contract, PRD #1755):
+ * - `GET {basePath}/_changes?since=<cursor>&tables=<a,b>&limit=<n>` returns
+ *   `{ changes, cursor, resyncRequired?, resyncCursor? }` — see
+ *   `getChangesSince` for the exact cursor guarantee (strictly monotonic;
+ *   reads miss no committed changes under concurrent writers).
+ *   `resyncRequired: true` — served as HTTP 200, it is protocol state rather
+ *   than an error — means the cursor cannot be served incrementally (pruned
+ *   out of the retained window, or foreign/reset) and the client must
+ *   re-fetch its data in full, then resume from `resyncCursor`.
+ * - **Auth is fail-closed** (#1540 posture): the route requires the
+ *   generator's `authMiddleware`. Without one configured, every request is
+ *   refused with 401 — the feed spans all tables, so per-model
+ *   `api: { public }` opt-outs deliberately do NOT apply to it.
+ * - **Tenant scoping** follows the active tenant context through the same
+ *   dependency-inversion hook the DispatchBus uses: with tenancy enabled, a
+ *   request only ever sees its own tenant's changes plus global rows; with
+ *   tenancy enabled but no active tenant, only global rows (fail-closed).
+ * - **Table/row authorization** (#3020): the read additionally applies the
+ *   consumer-supplied `authorizeChangeFeed`/`isChangeFeedEntryVisible` hooks,
+ *   if registered (`change-feed-authz.ts`), via
+ *   `getAuthorizedTenantScopedChangesSince()`. REST has no `locals`, so the
+ *   hooks receive `locals: undefined` and the `authMiddleware`-processed
+ *   `Request` as `request` — a REST-hosting consumer identifies the principal
+ *   from `request`. Unregistered, behavior is unchanged from pre-#3020.
+ */
+import type { DatabaseInterface } from '@happyvertical/sql';
 /**
  * Structural copy of `APIConfig['authMiddleware']` (from `rest.ts`) so this
  * module never imports the generator back (keeps the dependency one-way).

package/dist/generators/custom-action.d.ts

@@ -1,5 +1,13 @@
-import { ApiHttpMethod, ToolEffect } from '../registry/types.js';
-import { MethodDefinition, SmartObjectManifest } from '../scanner/types.js';
+/**
+ * Canonical custom-action metadata and transport-safe result helpers.
+ *
+ * Custom actions are intentionally distinct from generated CRUD. Their target
+ * is derived from method metadata: instance methods target an item and static
+ * methods target the collection. API route configuration may shape an HTTP
+ * route, but it cannot change a method's receiver.
+ */
+import type { ApiHttpMethod, ToolEffect } from '../registry/types.js';
+import type { MethodDefinition, SmartObjectManifest } from '../scanner/types.js';
 export type CustomActionScope = 'item' | 'collection';
 export type { ToolEffect } from '../registry/types.js';
 /**

package/dist/generators/events-route.d.ts

@@ -1,7 +1,44 @@
-import { DatabaseInterface } from '@happyvertical/sql';
-import { ChangeSignal } from '../change-signals.js';
-import { DispatchTenantScope } from '../dispatch/tenant-resolver.js';
-import { ChangesAuthMiddleware } from './changes-route.js';
+/**
+ * Generated `_events` SSE route — live change signals (issue #1763, SERVER
+ * half; parent PRD #1755).
+ *
+ * Handles `GET {basePath}/_events` in the REST generator: an auth-guarded,
+ * tenant-scoped Server-Sent-Events stream of coarse change signals ({table,
+ * operation, rowId, tenantId} + a `seq` cursor in the SSE `id:` field). It is
+ * the push companion to the pull-based `_changes` route (#1758): a subscriber
+ * reacts to a signal by re-reading through the authorized collection routes,
+ * so **no row payload ever crosses this channel** — authorization stays
+ * entirely on the read path.
+ *
+ * The stream lifecycle (subscribe, catch-up replay, heartbeat, teardown) lives
+ * in {@link buildChangeEventStream} so it is written and tested once; both the
+ * REST generator here and the generated SvelteKit route import it. `rest.ts`
+ * only registers the path.
+ *
+ * Contract:
+ * - **Fail-closed auth** (identical to `_changes`, #1540 posture): no
+ *   `authMiddleware` configured → 401; the middleware may return a Response to
+ *   short-circuit (e.g. 403). The feed spans every table, so per-model
+ *   `api: { public }` opt-outs deliberately do not apply.
+ * - **Tenant scope is captured ONCE at connection open** — signal delivery
+ *   happens from a different async context (the writer's afterSave, possibly
+ *   another request or replica) with no tenant ALS active, so the filter must
+ *   be the value resolved at subscribe time, not re-resolved per signal.
+ * - **Cross-origin is opt-in** (#1861): `rest.ts` now wraps `_events` in its
+ *   CORS layer. With the fail-closed default it stays same-origin only, but
+ *   when the generator is configured with `enableCors`, an `allowedOrigins`
+ *   allowlist, and `allowCredentials: true`, an allow-listed cross-origin
+ *   browser client can subscribe with a credentialed `EventSource`
+ *   (`withCredentials: true`) — the response echoes the specific origin (never
+ *   `*`) plus `Access-Control-Allow-Credentials: true`, so its cookies reach
+ *   the same fail-closed auth guard. The CORS layer only lets the cookie
+ *   through; it never authorizes — the auth middleware + captured tenant scope
+ *   are unchanged, so the read posture holds identically across origins.
+ */
+import type { DatabaseInterface } from '@happyvertical/sql';
+import { type ChangeSignal } from '../change-signals.js';
+import { type DispatchTenantScope } from '../dispatch/tenant-resolver.js';
+import { type ChangesAuthMiddleware } from './changes-route.js';
 /** Options for the `_events` route handler. */
 export interface EventsRouteOptions {
     /** The generator's configured auth middleware, if any. */

package/dist/generators/mcp-runtime-template.d.ts

@@ -1,5 +1,16 @@
-import { CustomActionScope } from './custom-action.js';
-import { MCPConfig, MCPContext } from './mcp.js';
+/**
+ * Runtime bootstrap template for generated MCP servers
+ *
+ * This template provides stdio transport integration for SMRT-generated MCP servers.
+ * It handles:
+ * - Server initialization with @modelcontextprotocol/server v2
+ * - Tool registration from MCPGenerator
+ * - Stdio transport connection
+ * - Error handling and logging
+ * - Graceful shutdown
+ */
+import type { CustomActionScope } from './custom-action.js';
+import type { MCPConfig, MCPContext } from './mcp.js';
 export interface RuntimeOptions {
     /** Server name (defaults to package name) */
     name?: string;

package/dist/generators/mcp.d.ts

@@ -1,4 +1,9 @@
-import { ToolJsonSchema } from './tool-schema.js';
+/**
+ * MCP (Model Context Protocol) server generator for smrt objects
+ *
+ * Exposes smrt objects as AI tools for Claude, GPT, and other AI models
+ */
+import { type ToolJsonSchema } from './tool-schema.js';
 /**
  * Runtime tool-call arguments. They arrive as untyped JSON from the MCP client,
  * so individual keys are narrowed (`as`) at each action's boundary.

package/dist/generators/rest.d.ts

@@ -1,8 +1,13 @@
-import { default as http } from 'node:http';
-import { SmrtCollection } from '../collection';
-import { SmrtObject } from '../object';
-import { RegisteredClass } from '../registry/types';
-import { PlaybookPreflightProvider } from './preflight-route';
+/**
+ * High-performance REST API generator for smrt objects using Node.js HTTP server
+ *
+ * Designed for minimal bundle size and maximum performance
+ */
+import http from 'node:http';
+import type { SmrtCollection } from '../collection';
+import type { SmrtObject } from '../object';
+import type { RegisteredClass } from '../registry/types';
+import { type PlaybookPreflightProvider } from './preflight-route';
 export interface APIConfig {
     basePath?: string;
     enableCors?: boolean;

package/dist/generators/tool-schema.d.ts

@@ -1,4 +1,4 @@
-import { CustomActionMetadata, ToolEffect } from './custom-action.js';
+import { type CustomActionMetadata, type ToolEffect } from './custom-action.js';
 /**
  * Transport-agnostic tool-descriptor builder (#1812, tracer).
  *

package/dist/hierarchical.d.ts

@@ -1,4 +1,40 @@
-import { SmrtCollection } from './collection';
+/**
+ * SmrtHierarchical — base class for self-referencing tree hierarchies.
+ *
+ * Provides batched parent/children/ancestors/descendants/hierarchy traversal
+ * and a cycle-safe `moveTo`. Replaces five copies of the same logic across
+ * Place, Event, Tag, Account, and Zone.
+ *
+ * Examples in the monorepo:
+ *
+ * | Subclass | Domain                                         |
+ * |----------|------------------------------------------------|
+ * | Place    | hierarchical geographic places                 |
+ * | Event    | nestable event hierarchy (game → period → …)   |
+ * | Tag      | tag taxonomies and category trees              |
+ * | Account  | chart of accounts                              |
+ * | Zone     | placement zones inside a digital property      |
+ *
+ * Convention: every subclass uses `parentId: string | null` referencing
+ * another row in the same table (or STI base table) by UUID. Classes whose
+ * self-reference has different semantics — e.g. `Fact.previousFactId` (an
+ * evolution chain) or `Asset.sourceAssetId` (a derivation DAG) — should
+ * NOT extend SmrtHierarchical. Use descriptive names and class-specific
+ * methods instead.
+ *
+ * @example
+ * ```typescript
+ * @smrt({ tableStrategy: 'sti', api: true })
+ * export class Place extends SmrtHierarchical {
+ *   name = '';
+ * }
+ *
+ * const ancestors = await place.getAncestors();
+ * const descendants = await place.getDescendants(); // BFS, one query per level
+ * await place.moveTo(newParent);                    // cycle-checked
+ * ```
+ */
+import type { SmrtCollection } from './collection';
 import { SmrtObject } from './object';
 /**
  * Aggregate hierarchy view: ancestors (root-first), self, and all descendants

package/dist/interceptors.d.ts

@@ -1,4 +1,48 @@
-import { SmrtObject } from './object.js';
+/**
+ * Global Interceptors System for SMRT Collections and Objects
+ *
+ * Provides a plugin architecture for intercepting collection and object operations.
+ * This enables external packages (like @happyvertical/smrt-tenancy) to register
+ * interceptors without creating circular dependencies.
+ *
+ * Pattern: Static methods on GlobalInterceptors class with globalThis state
+ * (matches ObjectRegistry pattern for cross-module state sharing)
+ *
+ * @example Basic interceptor registration
+ * ```typescript
+ * import { GlobalInterceptors } from '@happyvertical/smrt-core';
+ *
+ * // Register a beforeList interceptor
+ * GlobalInterceptors.register({
+ *   beforeList(className, options) {
+ *     console.log(`Listing ${className}`);
+ *     return options; // Return modified options
+ *   }
+ * });
+ * ```
+ *
+ * @example Tenancy interceptor (from smrt-tenancy)
+ * ```typescript
+ * GlobalInterceptors.register({
+ *   beforeList(className, options, context) {
+ *     const tenantId = getCurrentTenantId();
+ *     if (tenantId && isTenantScoped(className)) {
+ *       return {
+ *         ...options,
+ *         where: { ...options.where, tenantId }
+ *       };
+ *     }
+ *     return options;
+ *   },
+ *   beforeSave(instance, context) {
+ *     // Validate tenant on save
+ *   }
+ * });
+ * ```
+ *
+ * @see https://github.com/happyvertical/smrt/issues/675
+ */
+import type { SmrtObject } from './object.js';
 /**
  * Context passed to interceptors with operation metadata
  */

package/dist/junction.d.ts

@@ -1,3 +1,27 @@
+/**
+ * SmrtJunction — base class for two-sided junction (many-to-many) collections.
+ *
+ * A junction collection manages rows that link a "left" entity to a "right" entity,
+ * typically with discriminator fields (relationship/role) and an optional sortOrder.
+ * Examples in the monorepo:
+ *
+ * | Subclass                       | Left field    | Right field | Discriminator   |
+ * |--------------------------------|---------------|-------------|-----------------|
+ * | ContentAssetCollection         | contentId     | assetId     | relationship    |
+ * | PerformerOwnedAssetCollection  | performerId   | assetId     | role            |
+ * | PlaceAssetCollection           | placeId       | assetId     | relationship    |
+ * | EventParticipantCollection     | eventId       | profileId   | role            |
+ * | FactContentCollection          | factId        | contentId   | relationship    |
+ *
+ * Each subclass declares `leftField` / `rightField` (camelCase) and optionally
+ * overrides `sortField` (defaults to `'sortOrder'`; set `null` to disable ORDER BY).
+ *
+ * Polymorphic subclasses (where "left" or "right" is a composite key like
+ * `metaType + metaId`) may override `byLeft` / `byRight` / `attach` / `detach`
+ * with diverging signatures — see `AssetAssociationCollection` for a reference.
+ *
+ * @typeParam TItem - The junction row class (extends `SmrtObject`)
+ */
 import { SmrtCollection } from './collection';
 import { SmrtObject } from './object';
 /**

package/dist/knowledge-config.d.ts

@@ -1,4 +1,4 @@
-import { DomainKnowledgeConfig } from '@happyvertical/smrt-types';
+import type { DomainKnowledgeConfig } from '@happyvertical/smrt-types';
 export declare const DEFAULT_KNOWLEDGE_CONFIG: DomainKnowledgeConfig;
 /** Resolve the file and package portions of the documented knowledge precedence. */
 export declare function resolveFileKnowledgeConfig(rootDir: string, packageName: string | undefined): Promise<DomainKnowledgeConfig>;

package/dist/knowledge-discovery.d.ts

@@ -1,26 +1,3 @@
-export interface ScopedPackageDirectory {
-    /** Scope entry name; consumers may select by alias rather than manifest name. */
-    name: string;
-    /** Original node_modules path, retained for workspace-relative reporting. */
-    directory: string;
-    /** Resolved path for identity comparisons or absolute snapshot links. */
-    realDirectory: string;
-}
-/**
- * Enumerate scope entries without descending into pnpm's linked dependency graph.
- * Selection, workspace discovery and enrichment remain caller policies.
- */
-export declare function discoverScopedPackageDirectories(scopeDirectories: string[]): ScopedPackageDirectory[];
-/** Read authored docs only; never load artifacts, package code or object scans. */
-export declare function readPackageAgentDoc(directory: string, options?: {
-    inspectAdapter?: boolean;
-}): {
-    hasAgentsMd: boolean;
-    hasClaudeMd: boolean;
-    hasClaudeShim: boolean;
-    agentsContent: string;
-    claudeContent: string;
-    source: "AGENTS.md" | "CLAUDE.md" | null;
-    content: string | null;
-};
+/** Compatibility exports; filesystem knowledge is owned by the lightweight scanner. */
+export { discoverScopedPackageDirectories, readPackageAgentDoc, type ScopedPackageDirectory, } from '@happyvertical/smrt-scanner/knowledge';
 //# sourceMappingURL=knowledge-discovery.d.ts.map

package/dist/knowledge-discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge-discovery.d.ts","sourceRoot":"","sources":["../src/knowledge-discovery.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,sBAAsB;IACrC,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,gBAAgB,EAAE,MAAM,EAAE,GACzB,sBAAsB,EAAE,CAwB1B;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO;;;;;;;;EA0B3C"}
+{"version":3,"file":"knowledge-discovery.d.ts","sourceRoot":"","sources":["../src/knowledge-discovery.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,OAAO,EACL,gCAAgC,EAChC,mBAAmB,EACnB,KAAK,sBAAsB,GAC5B,MAAM,uCAAuC,CAAC"}

package/dist/knowledge-discovery.js

@@ -1,54 +1,2 @@
-import { existsSync, readFileSync, readdirSync, realpathSync } from "node:fs";
-import { join } from "node:path";
-//#region src/knowledge-discovery.ts
-/**
-* Enumerate scope entries without descending into pnpm's linked dependency graph.
-* Selection, workspace discovery and enrichment remain caller policies.
-*/
-function discoverScopedPackageDirectories(scopeDirectories) {
-	const packages = [];
-	for (const scopeDirectory of new Set(scopeDirectories)) {
-		let entries;
-		try {
-			entries = readdirSync(scopeDirectory, { withFileTypes: true });
-		} catch {
-			continue;
-		}
-		for (const entry of entries) {
-			if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;
-			const directory = join(scopeDirectory, entry.name);
-			try {
-				packages.push({
-					name: entry.name,
-					directory,
-					realDirectory: realpathSync(directory)
-				});
-			} catch {}
-		}
-	}
-	return packages;
-}
-/** Read authored docs only; never load artifacts, package code or object scans. */
-function readPackageAgentDoc(directory, options = {}) {
-	const agentsPath = join(directory, "AGENTS.md");
-	const claudePath = join(directory, "CLAUDE.md");
-	const hasAgentsMd = existsSync(agentsPath);
-	const hasClaudeMd = existsSync(claudePath);
-	const agentsContent = hasAgentsMd ? readFileSync(agentsPath, "utf8") : "";
-	const claudeContent = hasClaudeMd && (!hasAgentsMd || options.inspectAdapter) ? readFileSync(claudePath, "utf8") : "";
-	const hasClaudeShim = hasClaudeMd && claudeContent.trim() === "@AGENTS.md";
-	const source = hasAgentsMd ? "AGENTS.md" : hasClaudeMd && !hasClaudeShim ? "CLAUDE.md" : null;
-	return {
-		hasAgentsMd,
-		hasClaudeMd,
-		hasClaudeShim,
-		agentsContent,
-		claudeContent,
-		source,
-		content: hasAgentsMd ? agentsContent : source ? claudeContent : null
-	};
-}
-//#endregion
+import { discoverScopedPackageDirectories, readPackageAgentDoc } from "@happyvertical/smrt-scanner/knowledge";
 export { discoverScopedPackageDirectories, readPackageAgentDoc };
-
-//# sourceMappingURL=knowledge-discovery.js.map

package/dist/knowledge-graph.d.ts

@@ -1,95 +1,3 @@
-import { DomainKnowledgeManifest } from '@happyvertical/smrt-types';
-/**
- * Discovers every currently-buildable per-package artifact path under
- * `<rootDir>/packages/*`, preferring the published `dist/smrt-knowledge.json`
- * over the local dev `.smrt/smrt-knowledge.json` when both exist. Shared by
- * the generator (which needs the manifest content) and the freshness check
- * (which only needs to know whether the current SET of artifacts matches
- * what the graph was built from — a newly built package, or a package that
- * newly started exporting `./smrt-knowledge.json`, must mark the graph stale
- * even though every artifact the graph already knows about is unchanged).
- */
-export declare function discoverKnowledgeArtifactPaths(rootDir: string): string[];
-/** One package's `smrt-knowledge.json`, located relative to the graph root. */
-export interface KnowledgeGraphInput {
-    /** Path to the artifact, relative to the repo root, POSIX-separated. */
-    artifactPath: string;
-    manifest: DomainKnowledgeManifest;
-}
-export interface KnowledgeGraphPackageNode {
-    name: string;
-    version?: string;
-    artifactPath: string;
-    tags: string[];
-    risks: string[];
-    summary?: string;
-    objectCount: number;
-}
-export interface KnowledgeGraphObjectNode {
-    /** `<packageName>#<qualifiedName-or-name>`, this graph's stable object id. */
-    id: string;
-    packageName: string;
-    name: string;
-    qualifiedName?: string;
-    collection: string;
-    tableName?: string;
-    tableStrategy?: 'cti' | 'sti';
-    extends?: string;
-}
-export type KnowledgeGraphEdgeType = 'crossPackageRef' | 'sti' | 'junction' | 'hierarchical' | 'polymorphic' | 'systemTable';
-export interface KnowledgeGraphEdge {
-    type: KnowledgeGraphEdgeType;
-    /** Object id (or `<packageName>#<extends>`-style unresolved target) this edge starts from. */
-    from: string;
-    /**
-     * Object id the edge points to when resolvable against a scanned object;
-     * otherwise the raw declared target (e.g. a qualified name this run did
-     * not scan), so the edge is still readable rather than dropped.
-     */
-    to?: string;
-    /** Declaring field name, for `crossPackageRef` edges. */
-    field?: string;
-}
-export interface SmrtKnowledgeGraph {
-    schemaVersion: 1;
-    generatedAt: string;
-    /** `artifactPath -> sha256(content)`, sorted by key; the freshness input. */
-    sourceHashes: Record<string, string>;
-    packages: KnowledgeGraphPackageNode[];
-    objects: KnowledgeGraphObjectNode[];
-    edges: KnowledgeGraphEdge[];
-}
-export interface BuildKnowledgeGraphOptions {
-    /**
-     * The graph currently on disk, when regenerating. `generatedAt` is
-     * preserved from it rather than reset to the clock whenever the rebuilt
-     * graph is otherwise semantically identical — the same pattern
-     * `preserveKnowledgeGeneratedAt` uses for per-package artifacts
-     * (`packages/core/src/vite-plugin/index.ts`) — so re-running the generator
-     * with nothing merged actually changed does not churn the file (#2872
-     * review).
-     */
-    previousGraph?: SmrtKnowledgeGraph;
-}
-/** Builds the merged graph. Deterministic: every array is sorted. */
-export declare function buildKnowledgeGraph(inputs: KnowledgeGraphInput[], options?: BuildKnowledgeGraphOptions): SmrtKnowledgeGraph;
-/** Deterministic `JSON.stringify` — object keys are sorted at every level. */
-export declare function stableStringify(value: unknown): string;
-export interface KnowledgeGraphFreshnessIssue {
-    severity: 'error' | 'warning';
-    code: 'missing-knowledge-graph' | 'stale-knowledge-graph' | 'knowledge-graph-source-missing';
-    message: string;
-    file?: string;
-}
-/**
- * Checks the merged graph's recorded `sourceHashes` against the current
- * content of each per-package artifact it was built from — the same pattern
- * `knowledge.ts`/`smrt-dev-mcp` use for a single package's `sourceHashes`.
- *
- * `graphPath` and each `artifactPath` in the graph are resolved relative to
- * `rootDir` (the repo root).
- */
-export declare function checkKnowledgeGraphFreshness(rootDir: string, graphPath: string, options?: {
-    requireArtifact?: boolean;
-}): KnowledgeGraphFreshnessIssue[];
+/** Compatibility exports; graph algorithms are owned by the lightweight scanner. */
+export { type BuildKnowledgeGraphOptions, buildKnowledgeGraph, checkKnowledgeGraphFreshness, discoverKnowledgeArtifactPaths, type KnowledgeGraphEdge, type KnowledgeGraphEdgeType, type KnowledgeGraphFreshnessIssue, type KnowledgeGraphInput, type KnowledgeGraphObjectNode, type KnowledgeGraphPackageNode, type SmrtKnowledgeGraph, stableStringify, } from '@happyvertical/smrt-scanner/knowledge';
 //# sourceMappingURL=knowledge-graph.d.ts.map

package/dist/knowledge-graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge-graph.d.ts","sourceRoot":"","sources":["../src/knowledge-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,KAAK,EACV,uBAAuB,EAExB,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAexE;AAED,+EAA+E;AAC/E,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,uBAAuB,CAAC;CACnC;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,8EAA8E;IAC9E,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,sBAAsB,GAC9B,iBAAiB,GACjB,KAAK,GACL,UAAU,GACV,cAAc,GACd,aAAa,GACb,aAAa,CAAC;AAElB,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,8FAA8F;IAC9F,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,CAAC,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,QAAQ,EAAE,yBAAyB,EAAE,CAAC;IACtC,OAAO,EAAE,wBAAwB,EAAE,CAAC;IACpC,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAUD,MAAM,WAAW,0BAA0B;IACzC;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,kBAAkB,CAAC;CACpC;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,mBAAmB,EAAE,EAC7B,OAAO,GAAE,0BAA+B,GACvC,kBAAkB,CAoKpB;AAOD,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD;AA+BD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,EACA,yBAAyB,GACzB,uBAAuB,GACvB,gCAAgC,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1C,4BAA4B,EAAE,CA0FhC"}
+{"version":3,"file":"knowledge-graph.d.ts","sourceRoot":"","sources":["../src/knowledge-graph.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,OAAO,EACL,KAAK,0BAA0B,EAC/B,mBAAmB,EACnB,4BAA4B,EAC5B,8BAA8B,EAC9B,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,4BAA4B,EACjC,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,eAAe,GAChB,MAAM,uCAAuC,CAAC"}