@happyvertical/smrt-core 0.51.32 → 0.51.33

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) ?? {};