@happyvertical/smrt-core 0.51.31 → 0.51.33

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"}

package/dist/knowledge-graph.js

@@ -1,268 +1,2 @@
-import { createHash } from "node:crypto";
-import { existsSync, readFileSync, readdirSync } from "node:fs";
-import { join, relative } from "node:path";
-//#region src/knowledge-graph.ts
-/**
-* Cross-package knowledge graph (#2863).
-*
-* Each package's own `smrt-knowledge.json` (see `knowledge.ts`) is a
-* per-package projection. Nothing merges them, so cross-package invariants
-* that the scanner manifest already carries — `@crossPackageRef` targets, STI
-* parent/child pairs, junction/hierarchical/polymorphic base usage, and
-* `_smrt_` system-table ownership — live only as prose in the root
-* `AGENTS.md`. This module builds the merged, deterministic root artifact
-* (`.smrt/smrt-knowledge-graph.json`) from whichever per-package artifacts
-* are present, and checks it for staleness the same way `knowledge.ts` checks
-* a package artifact: by comparing recorded `sourceHashes` against the
-* current file content.
-*
-* This module never invents an edge: every edge is a direct read of a field
-* already emitted into a package's `DomainKnowledgeManifest` (`related`,
-* `tableStrategy`, `extends`, `relationshipFeatures`, `tableName`).
-*/
-/**
-* 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).
-*/
-function discoverKnowledgeArtifactPaths(rootDir) {
-	const packagesDir = join(rootDir, "packages");
-	if (!existsSync(packagesDir)) return [];
-	const paths = [];
-	for (const entry of readdirSync(packagesDir, { withFileTypes: true })) {
-		if (!entry.isDirectory()) continue;
-		const packageDir = join(packagesDir, entry.name);
-		const found = [join(packageDir, "dist", "smrt-knowledge.json"), join(packageDir, ".smrt", "smrt-knowledge.json")].find((path) => existsSync(path));
-		if (found) paths.push(relative(rootDir, found).split("\\").join("/"));
-	}
-	return paths.sort();
-}
-function hashContent(content) {
-	return createHash("sha256").update(content).digest("hex");
-}
-function objectId(packageName, object) {
-	return `${packageName}#${object.qualifiedName ?? object.name}`;
-}
-/** Builds the merged graph. Deterministic: every array is sorted. */
-function buildKnowledgeGraph(inputs, options = {}) {
-	const sortedInputs = [...inputs].sort((a, b) => a.artifactPath.localeCompare(b.artifactPath));
-	const sourceHashes = {};
-	const packages = [];
-	const objects = [];
-	const edges = [];
-	const idByQualifiedName = /* @__PURE__ */ new Map();
-	const idBySimpleName = /* @__PURE__ */ new Map();
-	const idBySimpleNamePerPackage = /* @__PURE__ */ new Map();
-	for (const input of sortedInputs) {
-		const manifestPackageName = input.manifest.packageName ?? input.artifactPath;
-		for (const object of input.manifest.objects) {
-			const packageName = object.packageName ?? manifestPackageName;
-			const perPackage = idBySimpleNamePerPackage.get(packageName) ?? /* @__PURE__ */ new Map();
-			const id = objectId(packageName, object);
-			idByQualifiedName.set(object.qualifiedName ?? id, id);
-			const bySimple = idBySimpleName.get(object.name) ?? /* @__PURE__ */ new Set();
-			bySimple.add(id);
-			idBySimpleName.set(object.name, bySimple);
-			perPackage.set(object.name, id);
-			idBySimpleNamePerPackage.set(packageName, perPackage);
-		}
-	}
-	const resolveTarget = (raw, declaringPackageName) => {
-		if (!raw) return void 0;
-		if (idByQualifiedName.has(raw)) return idByQualifiedName.get(raw);
-		if (declaringPackageName) {
-			const sameId = idBySimpleNamePerPackage.get(declaringPackageName)?.get(raw);
-			if (sameId) return sameId;
-		}
-		const bySimple = idBySimpleName.get(raw);
-		if (bySimple && bySimple.size === 1) return [...bySimple][0];
-	};
-	const seenObjectIds = /* @__PURE__ */ new Set();
-	for (const input of sortedInputs) {
-		sourceHashes[input.artifactPath] = hashContent(stableStringify(input.manifest));
-		const packageName = input.manifest.packageName ?? input.artifactPath;
-		packages.push({
-			name: packageName,
-			version: input.manifest.packageVersion,
-			artifactPath: input.artifactPath,
-			tags: [...input.manifest.tags].sort(),
-			risks: [...input.manifest.risks].sort(),
-			summary: input.manifest.summary,
-			objectCount: input.manifest.objects.length
-		});
-		for (const object of input.manifest.objects) {
-			const objectPackageName = object.packageName ?? packageName;
-			const id = objectId(objectPackageName, object);
-			if (!seenObjectIds.has(id)) {
-				seenObjectIds.add(id);
-				objects.push({
-					id,
-					packageName: objectPackageName,
-					name: object.name,
-					qualifiedName: object.qualifiedName,
-					collection: object.collection,
-					tableName: object.tableName,
-					tableStrategy: object.tableStrategy,
-					extends: object.extends
-				});
-			}
-			for (const field of object.relationships) {
-				if (field.type !== "crossPackageRef") continue;
-				edges.push({
-					type: "crossPackageRef",
-					from: id,
-					to: resolveTarget(field.related) ?? field.related,
-					field: field.name
-				});
-			}
-			if (object.tableStrategy === "sti" && object.extends) edges.push({
-				type: "sti",
-				from: id,
-				to: resolveTarget(object.extends, objectPackageName) ?? `${objectPackageName}#${object.extends}`
-			});
-			for (const feature of object.relationshipFeatures) if (feature === "SmrtJunction") edges.push({
-				type: "junction",
-				from: id
-			});
-			else if (feature === "SmrtHierarchical") edges.push({
-				type: "hierarchical",
-				from: id
-			});
-			else if (feature === "SmrtPolymorphicAssociation") edges.push({
-				type: "polymorphic",
-				from: id
-			});
-			if (object.tableName?.startsWith("_smrt_")) edges.push({
-				type: "systemTable",
-				from: id,
-				to: object.tableName
-			});
-		}
-	}
-	packages.sort((a, b) => a.name.localeCompare(b.name));
-	objects.sort((a, b) => a.id.localeCompare(b.id));
-	edges.sort((a, b) => {
-		const key = (edge) => `${edge.type}|${edge.from}|${edge.to ?? ""}|${edge.field ?? ""}`;
-		return key(a).localeCompare(key(b));
-	});
-	const graph = {
-		schemaVersion: 1,
-		generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-		sourceHashes: sortRecord(sourceHashes),
-		packages,
-		objects,
-		edges
-	};
-	const { previousGraph } = options;
-	if (previousGraph && semanticGraphJson(previousGraph) === semanticGraphJson(graph)) return {
-		...graph,
-		generatedAt: previousGraph.generatedAt
-	};
-	return graph;
-}
-function semanticGraphJson(graph) {
-	const { generatedAt: _generatedAt, ...rest } = graph;
-	return stableStringify(rest);
-}
-/** Deterministic `JSON.stringify` — object keys are sorted at every level. */
-function stableStringify(value) {
-	return JSON.stringify(sortValue(value));
-}
-function sortValue(value) {
-	if (Array.isArray(value)) return value.map(sortValue);
-	if (value && typeof value === "object") {
-		const sorted = Object.create(null);
-		for (const key of Object.keys(value).sort()) sorted[key] = sortValue(value[key]);
-		return sorted;
-	}
-	return value;
-}
-function sortRecord(record) {
-	const sorted = {};
-	for (const key of Object.keys(record).sort()) sorted[key] = record[key];
-	return sorted;
-}
-/**
-* 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).
-*/
-function checkKnowledgeGraphFreshness(rootDir, graphPath, options = {}) {
-	const issues = [];
-	const absoluteGraphPath = `${rootDir}/${graphPath}`;
-	if (!existsSync(absoluteGraphPath)) {
-		if (!options.requireArtifact) return issues;
-		issues.push({
-			severity: "error",
-			code: "missing-knowledge-graph",
-			message: `${graphPath} does not exist; run \`pnpm knowledge:graph\``,
-			file: graphPath
-		});
-		return issues;
-	}
-	let graph;
-	try {
-		graph = JSON.parse(readFileSync(absoluteGraphPath, "utf8"));
-	} catch (error) {
-		issues.push({
-			severity: "error",
-			code: "stale-knowledge-graph",
-			message: `${graphPath} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`,
-			file: graphPath
-		});
-		return issues;
-	}
-	const recordedPaths = Object.keys(graph.sourceHashes ?? {});
-	for (const [artifactPath, expectedHash] of Object.entries(graph.sourceHashes ?? {})) {
-		const absoluteArtifactPath = `${rootDir}/${artifactPath}`;
-		if (!existsSync(absoluteArtifactPath)) {
-			issues.push({
-				severity: "error",
-				code: "knowledge-graph-source-missing",
-				message: `${artifactPath} used to build ${graphPath} no longer exists`,
-				file: graphPath
-			});
-			continue;
-		}
-		let manifest;
-		try {
-			manifest = JSON.parse(readFileSync(absoluteArtifactPath, "utf8"));
-		} catch (error) {
-			issues.push({
-				severity: "error",
-				code: "stale-knowledge-graph",
-				message: `${artifactPath} is not valid JSON (${error instanceof Error ? error.message : String(error)}); run \`pnpm knowledge:graph\``,
-				file: graphPath
-			});
-			continue;
-		}
-		if (hashContent(stableStringify(manifest)) !== expectedHash) issues.push({
-			severity: "error",
-			code: "stale-knowledge-graph",
-			message: `${artifactPath} changed since ${graphPath} was generated; run \`pnpm knowledge:graph\``,
-			file: graphPath
-		});
-	}
-	const currentPaths = discoverKnowledgeArtifactPaths(rootDir);
-	const recordedSet = new Set(recordedPaths);
-	const newPaths = currentPaths.filter((path) => !recordedSet.has(path));
-	if (newPaths.length > 0) issues.push({
-		severity: "error",
-		code: "stale-knowledge-graph",
-		message: `${newPaths.join(", ")} ${newPaths.length === 1 ? "is a new package artifact" : "are new package artifacts"} not yet merged into ${graphPath}; run \`pnpm knowledge:graph\``,
-		file: graphPath
-	});
-	return issues;
-}
-//#endregion
+import { buildKnowledgeGraph, checkKnowledgeGraphFreshness, discoverKnowledgeArtifactPaths, stableStringify } from "@happyvertical/smrt-scanner/knowledge";
 export { buildKnowledgeGraph, checkKnowledgeGraphFreshness, discoverKnowledgeArtifactPaths, stableStringify };
-
-//# sourceMappingURL=knowledge-graph.js.map

package/dist/knowledge.d.ts

@@ -1,7 +1,9 @@
-import { DomainKnowledgeAgentSurface, DomainKnowledgeConfig, DomainKnowledgeManifest, DomainKnowledgeModuleDoc } from '@happyvertical/smrt-types';
-import { SmartObjectManifest } from './scanner/types.js';
+import { AGENT_SURFACE_HASH_PREFIX, MODULE_DOC_HASH_PREFIX, readAgentModuleDocs, resolveAgentModuleDocPaths } from '@happyvertical/smrt-scanner/knowledge';
 export { discoverScopedPackageDirectories, readPackageAgentDoc, type ScopedPackageDirectory, } from './knowledge-discovery.js';
 export { buildKnowledgeGraph, checkKnowledgeGraphFreshness, discoverKnowledgeArtifactPaths, type KnowledgeGraphEdge, type KnowledgeGraphEdgeType, type KnowledgeGraphFreshnessIssue, type KnowledgeGraphInput, type KnowledgeGraphObjectNode, type KnowledgeGraphPackageNode, type SmrtKnowledgeGraph, stableStringify, } from './knowledge-graph.js';
+export { AGENT_SURFACE_HASH_PREFIX, MODULE_DOC_HASH_PREFIX, readAgentModuleDocs, resolveAgentModuleDocPaths, };
+import type { DomainKnowledgeAgentSurface, DomainKnowledgeConfig, DomainKnowledgeManifest } from '@happyvertical/smrt-types';
+import type { SmartObjectManifest } from './scanner/types.js';
 /**
  * Minimal package.json shape consumed by the knowledge builder.
  * `name`/`version` are typed concretely because they flow into the manifest's
@@ -31,26 +33,5 @@ export interface BuildDomainKnowledgeOptions {
      */
     agentSurface?: DomainKnowledgeAgentSurface;
 }
-/** `sourceHashes` key prefix for a linked module doc, e.g. `moduleDoc:agents/crm.md`. */
-export declare const MODULE_DOC_HASH_PREFIX = "moduleDoc:";
-/**
- * `sourceHashes` key prefix for a module declaring a view intent or playbook,
- * e.g. `agentSurface:src/lib/orders.intents.ts` (#2591).
- */
-export declare const AGENT_SURFACE_HASH_PREFIX = "agentSurface:";
-/**
- * Module doc paths linked from a package's `AGENTS.md`, relative to the package
- * root and in document order.
- *
- * Instruction chains are additive (see `scripts/check-agents-chain.mjs`), so an
- * oversized package doc is split into `packages/<pkg>/agents/<module>.md` siblings
- * instead of nested `AGENTS.md` files. Only links resolving to an existing file
- * INSIDE the package are accepted — a cross-package reference such as
- * `packages/affiliates/MIGRATION.md` belongs to that package's own chain and is
- * ignored here.
- */
-export declare function resolveAgentModuleDocPaths(rootDir: string, agentDoc: string | undefined): string[];
-/** {@link resolveAgentModuleDocPaths}, with each doc's contents read. */
-export declare function readAgentModuleDocs(rootDir: string, agentDoc: string | undefined): DomainKnowledgeModuleDoc[];
 export declare function buildDomainKnowledgeManifest(options: BuildDomainKnowledgeOptions): DomainKnowledgeManifest;
 //# sourceMappingURL=knowledge.d.ts.map

package/dist/knowledge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../src/knowledge.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAChC,mBAAmB,EACnB,KAAK,sBAAsB,GAC5B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,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,sBAAsB,CAAC;AAK9B,OAAO,KAAK,EACV,2BAA2B,EAC3B,qBAAqB,EAGrB,uBAAuB,EAEvB,wBAAwB,EAKzB,MAAM,2BAA2B,CAAC;AAanC,OAAO,KAAK,EAEV,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAG5B;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,2BAA2B,CAAC;CAC5C;AAmDD,yFAAyF;AACzF,eAAO,MAAM,sBAAsB,eAAe,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,yBAAyB,kBAAkB,CAAC;AAEzD;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,EAAE,CAgBV;AAED,yEAAyE;AACzE,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,wBAAwB,EAAE,CAM5B;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,2BAA2B,GACnC,uBAAuB,CA0FzB"}
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../src/knowledge.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,EACnB,0BAA0B,EAC3B,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EACL,gCAAgC,EAChC,mBAAmB,EACnB,KAAK,sBAAsB,GAC5B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,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,sBAAsB,CAAC;AAC9B,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,EACnB,0BAA0B,GAC3B,CAAC;AAKF,OAAO,KAAK,EACV,2BAA2B,EAC3B,qBAAqB,EAGrB,uBAAuB,EAMxB,MAAM,2BAA2B,CAAC;AAanC,OAAO,KAAK,EAEV,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAG5B;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,2BAA2B,CAAC;CAC5C;AA0CD,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,2BAA2B,GACnC,uBAAuB,CA0FzB"}

package/dist/knowledge.js

@@ -4,8 +4,9 @@ import { isFrameworkBaseClass } from "./registry/framework-base-classes.js";
 import { discoverScopedPackageDirectories, readPackageAgentDoc } from "./knowledge-discovery.js";
 import { buildKnowledgeGraph, checkKnowledgeGraphFreshness, discoverKnowledgeArtifactPaths, stableStringify } from "./knowledge-graph.js";
 import { createHash } from "node:crypto";
-import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
-import { basename, join, relative, resolve, sep } from "node:path";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { join, relative } from "node:path";
+import { AGENT_SURFACE_HASH_PREFIX, MODULE_DOC_HASH_PREFIX, readAgentModuleDocs, resolveAgentModuleDocPaths } from "@happyvertical/smrt-scanner/knowledge";
 //#region src/knowledge.ts
 var SDK_PACKAGE_NAMES = /* @__PURE__ */ new Set([
 	"@happyvertical/ai",
@@ -44,56 +45,6 @@ var RELATIONSHIP_FIELD_TYPES = /* @__PURE__ */ new Set([
 * method while never being added as CRUD, dropping the surface entirely.
 */
 var STANDARD_OPERATIONS = CRUD_OPERATIONS;
-/**
-* Markdown inline links whose target is a `.md` file — `[label](agents/x.md)`,
-* tolerating an `#anchor` and a `"title"`. This is how a package registers a
-* sibling module doc (#2108): the link in `AGENTS.md` IS the registration, so
-* there is no separate index to drift out of sync.
-*/
-var MARKDOWN_MD_LINK = /\[[^\]]*\]\(\s*([^)\s#]+\.md)(?:#[^)\s]*)?(?:\s+"[^"]*")?\s*\)/g;
-/** `sourceHashes` key prefix for a linked module doc, e.g. `moduleDoc:agents/crm.md`. */
-var MODULE_DOC_HASH_PREFIX = "moduleDoc:";
-/**
-* `sourceHashes` key prefix for a module declaring a view intent or playbook,
-* e.g. `agentSurface:src/lib/orders.intents.ts` (#2591).
-*/
-var AGENT_SURFACE_HASH_PREFIX = "agentSurface:";
-/**
-* Module doc paths linked from a package's `AGENTS.md`, relative to the package
-* root and in document order.
-*
-* Instruction chains are additive (see `scripts/check-agents-chain.mjs`), so an
-* oversized package doc is split into `packages/<pkg>/agents/<module>.md` siblings
-* instead of nested `AGENTS.md` files. Only links resolving to an existing file
-* INSIDE the package are accepted — a cross-package reference such as
-* `packages/affiliates/MIGRATION.md` belongs to that package's own chain and is
-* ignored here.
-*/
-function resolveAgentModuleDocPaths(rootDir, agentDoc) {
-	if (!agentDoc) return [];
-	const root = resolve(rootDir);
-	const paths = [];
-	for (const match of agentDoc.matchAll(MARKDOWN_MD_LINK)) {
-		const target = match[1];
-		if (target.includes("://")) continue;
-		const absolute = resolve(root, target);
-		if (absolute !== root && !absolute.startsWith(root + sep)) continue;
-		const relativePath = relative(root, absolute).split(sep).join("/");
-		if (relativePath === "AGENTS.md" || relativePath === "CLAUDE.md") continue;
-		if (paths.includes(relativePath)) continue;
-		if (!existsSync(absolute) || !statSync(absolute).isFile()) continue;
-		paths.push(relativePath);
-	}
-	return paths;
-}
-/** {@link resolveAgentModuleDocPaths}, with each doc's contents read. */
-function readAgentModuleDocs(rootDir, agentDoc) {
-	return resolveAgentModuleDocPaths(rootDir, agentDoc).map((path) => ({
-		path,
-		module: basename(path, ".md"),
-		content: readFileSync(join(rootDir, path), "utf8")
-	}));
-}
 function buildDomainKnowledgeManifest(options) {
 	const rootDir = options.rootDir;
 	const packageJson = options.packageJson ?? readPackageJson(rootDir) ?? {};