@happyvertical/smrt-core 0.45.1 → 0.45.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js CHANGED
@@ -69,6 +69,7 @@ import { generateOpenAPISpec, setupSwaggerUI } from "./generators/swagger.js";
69
69
  import "./generators/index.js";
70
70
  import { SmrtHierarchical } from "./hierarchical.js";
71
71
  import { SmrtJunction } from "./junction.js";
72
+ import { discoverScopedPackageDirectories, readPackageAgentDoc } from "./knowledge-discovery.js";
72
73
  import { AGENT_SURFACE_HASH_PREFIX, MODULE_DOC_HASH_PREFIX, buildDomainKnowledgeManifest, readAgentModuleDocs, resolveAgentModuleDocPaths } from "./knowledge.js";
73
74
  import { getClassConfigResolvers, getConfigResolver, isLazyConfigSentinel, listConfigResolvers, registerConfigResolver, resetConfigResolvers, resolveLazyConfig, unregisterConfigResolver } from "./lazy-config.js";
74
75
  import { DEFAULT_LEARNING_CONFIG, LearningMemory } from "./learning/memory.js";
@@ -88,4 +89,4 @@ import "./system/index.js";
88
89
  import { getTestDatabase } from "./testing/database.js";
89
90
  import "./tools/index.js";
90
91
  import { smrtPlugin } from "./vite-plugin/index.js";
91
- export { AGENT_SURFACE_HASH_PREFIX, AIError, APIGenerator, AiUsageCollector, AiUsagePersistenceHandler, CACHE_INVALIDATION_CHANNEL, CHANGE_FEED_INTERCEPTOR_NAME, CHANGE_FEED_TABLE, CHANGE_SIGNAL_CHANNEL, CLIGenerator, CRUD_OPERATIONS, ConfigurationError, ContentHasher, CosineSimilarity, DEFAULT_AI_COST_RATES, DEFAULT_CHANGES_LIMIT, DEFAULT_DATA_QUERY_PAGE_LIMIT, DEFAULT_DATA_QUERY_RESULT_BYTES, DEFAULT_EMBEDDING_CONFIG, DEFAULT_EVENTS_HEARTBEAT_MS, DEFAULT_EVENTS_MAX_SUBSCRIBERS, DEFAULT_EVENTS_RETRY_AFTER_SECONDS, DEFAULT_FACET_LIMIT, DEFAULT_LEARNING_CONFIG, DEFAULT_LIST_LIMIT, DEFAULT_LIST_ORDER_BY, DEFAULT_POSTGRES_TIMEOUTS, DEFAULT_RETENTION_POLICY, DataQueryValidationError, DatabaseError, Dispatch, DispatchBus, DispatchCollection, DispatchSubscription, DispatchSubscriptionCollection, EmbeddingProvider, EmbeddingStorage, ErrorUtils, FilesystemError, GlobalInterceptors, LearningMemory, LiveSchemaParityError, MAX_CHANGES_LIMIT, MAX_DATA_QUERY_CURSOR_LENGTH, MAX_DATA_QUERY_FACETS, MAX_DATA_QUERY_FILTERS, MAX_DATA_QUERY_FILTER_DEPTH, MAX_DATA_QUERY_IN_VALUES, MAX_DATA_QUERY_OFFSET, MAX_DATA_QUERY_PAGE_LIMIT, MAX_DATA_QUERY_REQUEST_BYTES, MAX_DATA_QUERY_RESULT_BYTES, MAX_DATA_QUERY_WARNINGS, MAX_FACET_FIELDS, MAX_FACET_LIMIT, MAX_LIST_LIMIT, MAX_STI_READ_SCOPE_TYPES, MAX_SYNC_APPLY_BATCH_SIZE, MCPGenerator, MCP_STABLE_CATALOG_TTL_MS, MODULE_DOC_HASH_PREFIX, ManifestBuilder, ManifestGenerator, ManifestManager, MetricsAdapter, NetworkError, ObjectRegistry, PLAYBOOK_PREFLIGHT_CAPABILITY, PLAYBOOK_PREFLIGHT_ROUTE_SEGMENT, POSTGRES_REVISION_GUARD_EXPRESSION, POSTGRES_TIMEOUT_ENV_VARS, PRIVATE_READ_CACHE_CONTROL, PubSubAdapter, QueryBoundsError, QueryOrderByError, RuntimeError, SMRT_COLLECTION_BASE_NAMES, SMRT_CUSTOM_ACTION_ERROR_METADATA_KEY, SYNC_APPLY_ROUTE_SEGMENTS, SYNC_APPLY_UUID_PATTERN, SYSTEM_TABLE_NAMES, SchemaComparer, SignalBus, SignalSanitizer, SmrtClass, SmrtCollection, SmrtError, SmrtHierarchical, SmrtJunction, SmrtMCPServer, SmrtObject, SmrtPolymorphicAssociation, TenantIsolationError, ValidationError, ValidationReport, ValidationUtils, appendChange, applyOneToManyChildAccessors, applyPendingDecoratorRegistrations, applyPostgresRuntimeTimeouts, applySyncWritablePolicy, assertPostgresSystemTimestampsCurrent, broadcastCacheInvalidation, buildCascadePlan, buildChangeEventStream, buildCustomActionInputSchema, buildCustomActionInvocationArgs, buildDefaultListOrderBy, buildDomainKnowledgeManifest, bumpChangeFeed, canonicalReadRepresentation, canonicalizeDataQuery, cascadeReferencesTo, changeEventSubscribersAtCapacity, checkLiveSchemaParity, childAccessorName, classifyDatabaseError, classifyDialectMessage, clearRetentionTasks, clone, computeBodyEtag, computeRuntimeWebManifestHash, computeTableVersionEtag, conditionalJsonResponse, config, convertTypeToJsonSchema, createDataQueryFingerprint, createDispatchBus, createFilesystemAdapter, createInterceptorContext, createMCPServer, createQualifiedName, createRestServer, createSmrtClient, createSmrtServer, crossPackageRef, customActionParameterInputName, detectEngine, discoverManifestEntry, drainChangeFeed, ensureBootstrapSystemTableCompatibility, ensureCacheInvalidationListener, ensureChangeFeedTable, ensureDeferredSystemTableCompatibility, ensureDispatchSubscriptionsSystemTableCompatibility, ensureDispatchSystemTableCompatibility, ensureJobEventsSystemTableCompatibility, ensureJobsSystemTableCompatibility, ensureLegacySystemTableCompatibility, ensureSystemTables, estimateAiUsageCost, eventStreamCapacityExceededResponse, executeCollectionReadPlan, executeToolCall, executeToolCalls, field, findManifestEntryByQualifiedName, foreignKey, formatToolResults, generateDDLForEngine, generateOpenAPISpec, generateSchemaDiff, generateToolFromMethod, generateToolManifest, getAdapterInfo, getCLIHandler, getCacheGeneration, getChangesSince, getClassConfigResolvers, getClassName, getConfigResolver, getDatabaseEngine, getManifest, getPackageFromQualifiedName, getRetentionTasks, getSQLFromDiff, getSystemTableShapes, getTableVersion, getTenantScopedChangesSince, getTestDatabase, handlePlaybookPreflightRoute, hasActionableChanges, ifNoneMatchHasConcreteMatch, ifNoneMatchSatisfied, importOptionalDependency, invalidateCollectionCache, isAbortedTransactionError, isAdvisoryOnlyChange, isApiActionEnabledForObject, isCrudOperation, isCrudToolAction, isDatabaseInterface, isDeterministicDatabaseError, isEmbeddedDatabase, isFrameworkBaseClass, isFromPackage, isLazyConfigSentinel, isManualOrAdvisoryChange, isNotNullViolationError, isPostgresDatabase, isQualifiedName, isRestActionRoutable, isRestRoutePublic, isSmrtCollectionExtendsName, isStaleWrite, isTenantScopedClassResolved, isTransientDatabaseError, isType, isUniqueViolationError, isValid, listConfigResolvers, loadExternalManifest, loadExternalManifestSync, loadLocalTestManifestSync, loadManifestFromPathSync, manifest, manyToMany, meta, migratePostgresSystemTimestamps, normalizeCustomActionFailure, normalizeDataQueryRequest, normalizeDataQueryResult, normalizeDataQuerySchema, normalizeEventsMaxSubscribers, normalizeOnDelete, normalizeTypedHttpError, oneToMany, parse, parseQualifiedName, parseSyncApplyBatch, payloadMatchesRow, planForeignKeyCreation, planPostgresSystemTimestampMigrations, postgresRevisionCandidates, postgresRevisionCondition, processSyncApplyBatch, pruneAiUsage, pruneChangeFeed, pruneExpiredContexts, qualifiedNamesEqual, readAgentModuleDocs, registerChangeFeedWriter, registerCompatibleFieldDecorator, registerConfigResolver, registerFilesystemAdapterFactory, registerOptionalDependency, registerRetentionTask, resetChangeFeedWarnings, resetChangeSignals, resetCollectionCache, resetConfigResolvers, resetVerifiedTables, resolveAgentModuleDocPaths, resolveCustomActionMetadata, resolveDatabase, resolveDbCacheKey, resolveDispatchTenantId, resolveDispatchTenantScope, resolveGetStringFilter, resolveLazyConfig, resolveListLimit, resolveListOffset, resolveMCPToolListCacheHint, resolvePostgresTimeouts, resolveReadCacheControl, resolveRegisteredObjectName, resolveTenantEtagDiscriminator, restFieldReadPermissions, restMethodForApiAction, runCascadeDelete, runRetentionSweep, runWithTenantGate, safeParse, safeStringify, setDispatchTenantResolver, setTenantEntryPointRunner, setTenantScopedClassResolver, setupCLI, setupSwaggerUI, shouldIncludeMethod, signalVisibleToTenant, smrt, smrtPlugin, smrt as smrtRegistry, sortMCPTools, startRestServer, staticManifest, stopCacheInvalidationListeners, stopChangeSignalListeners, stringify, subscribeToChangeSignals, tableExists, tryReserveChangeEventSubscriberSlot, unregisterChangeFeedWriter, unregisterConfigResolver, unregisterRetentionTask, usesEmbeddedRevisionFallback, validateSyncApplyItem, validateToolCall, versionConditionalResponse, warnIfSharedCacheNeutralized, withEmbeddedWriteQueue, withEmbeddedWriteTransaction };
92
+ export { AGENT_SURFACE_HASH_PREFIX, AIError, APIGenerator, AiUsageCollector, AiUsagePersistenceHandler, CACHE_INVALIDATION_CHANNEL, CHANGE_FEED_INTERCEPTOR_NAME, CHANGE_FEED_TABLE, CHANGE_SIGNAL_CHANNEL, CLIGenerator, CRUD_OPERATIONS, ConfigurationError, ContentHasher, CosineSimilarity, DEFAULT_AI_COST_RATES, DEFAULT_CHANGES_LIMIT, DEFAULT_DATA_QUERY_PAGE_LIMIT, DEFAULT_DATA_QUERY_RESULT_BYTES, DEFAULT_EMBEDDING_CONFIG, DEFAULT_EVENTS_HEARTBEAT_MS, DEFAULT_EVENTS_MAX_SUBSCRIBERS, DEFAULT_EVENTS_RETRY_AFTER_SECONDS, DEFAULT_FACET_LIMIT, DEFAULT_LEARNING_CONFIG, DEFAULT_LIST_LIMIT, DEFAULT_LIST_ORDER_BY, DEFAULT_POSTGRES_TIMEOUTS, DEFAULT_RETENTION_POLICY, DataQueryValidationError, DatabaseError, Dispatch, DispatchBus, DispatchCollection, DispatchSubscription, DispatchSubscriptionCollection, EmbeddingProvider, EmbeddingStorage, ErrorUtils, FilesystemError, GlobalInterceptors, LearningMemory, LiveSchemaParityError, MAX_CHANGES_LIMIT, MAX_DATA_QUERY_CURSOR_LENGTH, MAX_DATA_QUERY_FACETS, MAX_DATA_QUERY_FILTERS, MAX_DATA_QUERY_FILTER_DEPTH, MAX_DATA_QUERY_IN_VALUES, MAX_DATA_QUERY_OFFSET, MAX_DATA_QUERY_PAGE_LIMIT, MAX_DATA_QUERY_REQUEST_BYTES, MAX_DATA_QUERY_RESULT_BYTES, MAX_DATA_QUERY_WARNINGS, MAX_FACET_FIELDS, MAX_FACET_LIMIT, MAX_LIST_LIMIT, MAX_STI_READ_SCOPE_TYPES, MAX_SYNC_APPLY_BATCH_SIZE, MCPGenerator, MCP_STABLE_CATALOG_TTL_MS, MODULE_DOC_HASH_PREFIX, ManifestBuilder, ManifestGenerator, ManifestManager, MetricsAdapter, NetworkError, ObjectRegistry, PLAYBOOK_PREFLIGHT_CAPABILITY, PLAYBOOK_PREFLIGHT_ROUTE_SEGMENT, POSTGRES_REVISION_GUARD_EXPRESSION, POSTGRES_TIMEOUT_ENV_VARS, PRIVATE_READ_CACHE_CONTROL, PubSubAdapter, QueryBoundsError, QueryOrderByError, RuntimeError, SMRT_COLLECTION_BASE_NAMES, SMRT_CUSTOM_ACTION_ERROR_METADATA_KEY, SYNC_APPLY_ROUTE_SEGMENTS, SYNC_APPLY_UUID_PATTERN, SYSTEM_TABLE_NAMES, SchemaComparer, SignalBus, SignalSanitizer, SmrtClass, SmrtCollection, SmrtError, SmrtHierarchical, SmrtJunction, SmrtMCPServer, SmrtObject, SmrtPolymorphicAssociation, TenantIsolationError, ValidationError, ValidationReport, ValidationUtils, appendChange, applyOneToManyChildAccessors, applyPendingDecoratorRegistrations, applyPostgresRuntimeTimeouts, applySyncWritablePolicy, assertPostgresSystemTimestampsCurrent, broadcastCacheInvalidation, buildCascadePlan, buildChangeEventStream, buildCustomActionInputSchema, buildCustomActionInvocationArgs, buildDefaultListOrderBy, buildDomainKnowledgeManifest, bumpChangeFeed, canonicalReadRepresentation, canonicalizeDataQuery, cascadeReferencesTo, changeEventSubscribersAtCapacity, checkLiveSchemaParity, childAccessorName, classifyDatabaseError, classifyDialectMessage, clearRetentionTasks, clone, computeBodyEtag, computeRuntimeWebManifestHash, computeTableVersionEtag, conditionalJsonResponse, config, convertTypeToJsonSchema, createDataQueryFingerprint, createDispatchBus, createFilesystemAdapter, createInterceptorContext, createMCPServer, createQualifiedName, createRestServer, createSmrtClient, createSmrtServer, crossPackageRef, customActionParameterInputName, detectEngine, discoverManifestEntry, discoverScopedPackageDirectories, drainChangeFeed, ensureBootstrapSystemTableCompatibility, ensureCacheInvalidationListener, ensureChangeFeedTable, ensureDeferredSystemTableCompatibility, ensureDispatchSubscriptionsSystemTableCompatibility, ensureDispatchSystemTableCompatibility, ensureJobEventsSystemTableCompatibility, ensureJobsSystemTableCompatibility, ensureLegacySystemTableCompatibility, ensureSystemTables, estimateAiUsageCost, eventStreamCapacityExceededResponse, executeCollectionReadPlan, executeToolCall, executeToolCalls, field, findManifestEntryByQualifiedName, foreignKey, formatToolResults, generateDDLForEngine, generateOpenAPISpec, generateSchemaDiff, generateToolFromMethod, generateToolManifest, getAdapterInfo, getCLIHandler, getCacheGeneration, getChangesSince, getClassConfigResolvers, getClassName, getConfigResolver, getDatabaseEngine, getManifest, getPackageFromQualifiedName, getRetentionTasks, getSQLFromDiff, getSystemTableShapes, getTableVersion, getTenantScopedChangesSince, getTestDatabase, handlePlaybookPreflightRoute, hasActionableChanges, ifNoneMatchHasConcreteMatch, ifNoneMatchSatisfied, importOptionalDependency, invalidateCollectionCache, isAbortedTransactionError, isAdvisoryOnlyChange, isApiActionEnabledForObject, isCrudOperation, isCrudToolAction, isDatabaseInterface, isDeterministicDatabaseError, isEmbeddedDatabase, isFrameworkBaseClass, isFromPackage, isLazyConfigSentinel, isManualOrAdvisoryChange, isNotNullViolationError, isPostgresDatabase, isQualifiedName, isRestActionRoutable, isRestRoutePublic, isSmrtCollectionExtendsName, isStaleWrite, isTenantScopedClassResolved, isTransientDatabaseError, isType, isUniqueViolationError, isValid, listConfigResolvers, loadExternalManifest, loadExternalManifestSync, loadLocalTestManifestSync, loadManifestFromPathSync, manifest, manyToMany, meta, migratePostgresSystemTimestamps, normalizeCustomActionFailure, normalizeDataQueryRequest, normalizeDataQueryResult, normalizeDataQuerySchema, normalizeEventsMaxSubscribers, normalizeOnDelete, normalizeTypedHttpError, oneToMany, parse, parseQualifiedName, parseSyncApplyBatch, payloadMatchesRow, planForeignKeyCreation, planPostgresSystemTimestampMigrations, postgresRevisionCandidates, postgresRevisionCondition, processSyncApplyBatch, pruneAiUsage, pruneChangeFeed, pruneExpiredContexts, qualifiedNamesEqual, readAgentModuleDocs, readPackageAgentDoc, registerChangeFeedWriter, registerCompatibleFieldDecorator, registerConfigResolver, registerFilesystemAdapterFactory, registerOptionalDependency, registerRetentionTask, resetChangeFeedWarnings, resetChangeSignals, resetCollectionCache, resetConfigResolvers, resetVerifiedTables, resolveAgentModuleDocPaths, resolveCustomActionMetadata, resolveDatabase, resolveDbCacheKey, resolveDispatchTenantId, resolveDispatchTenantScope, resolveGetStringFilter, resolveLazyConfig, resolveListLimit, resolveListOffset, resolveMCPToolListCacheHint, resolvePostgresTimeouts, resolveReadCacheControl, resolveRegisteredObjectName, resolveTenantEtagDiscriminator, restFieldReadPermissions, restMethodForApiAction, runCascadeDelete, runRetentionSweep, runWithTenantGate, safeParse, safeStringify, setDispatchTenantResolver, setTenantEntryPointRunner, setTenantScopedClassResolver, setupCLI, setupSwaggerUI, shouldIncludeMethod, signalVisibleToTenant, smrt, smrtPlugin, smrt as smrtRegistry, sortMCPTools, startRestServer, staticManifest, stopCacheInvalidationListeners, stopChangeSignalListeners, stringify, subscribeToChangeSignals, tableExists, tryReserveChangeEventSubscriberSlot, unregisterChangeFeedWriter, unregisterConfigResolver, unregisterRetentionTask, usesEmbeddedRevisionFallback, validateSyncApplyItem, validateToolCall, versionConditionalResponse, warnIfSharedCacheNeutralized, withEmbeddedWriteQueue, withEmbeddedWriteTransaction };
@@ -0,0 +1,26 @@
1
+ export interface ScopedPackageDirectory {
2
+ /** Scope entry name; consumers may select by alias rather than manifest name. */
3
+ name: string;
4
+ /** Original node_modules path, retained for workspace-relative reporting. */
5
+ directory: string;
6
+ /** Resolved path for identity comparisons or absolute snapshot links. */
7
+ realDirectory: string;
8
+ }
9
+ /**
10
+ * Enumerate scope entries without descending into pnpm's linked dependency graph.
11
+ * Selection, workspace discovery and enrichment remain caller policies.
12
+ */
13
+ export declare function discoverScopedPackageDirectories(scopeDirectories: string[]): ScopedPackageDirectory[];
14
+ /** Read authored docs only; never load artifacts, package code or object scans. */
15
+ export declare function readPackageAgentDoc(directory: string, options?: {
16
+ inspectAdapter?: boolean;
17
+ }): {
18
+ hasAgentsMd: boolean;
19
+ hasClaudeMd: boolean;
20
+ hasClaudeShim: boolean;
21
+ agentsContent: string;
22
+ claudeContent: string;
23
+ source: "AGENTS.md" | "CLAUDE.md" | null;
24
+ content: string | null;
25
+ };
26
+ //# sourceMappingURL=knowledge-discovery.d.ts.map
@@ -0,0 +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"}
@@ -0,0 +1,54 @@
1
+ import { existsSync, readFileSync, readdirSync, realpathSync } from "node:fs";
2
+ import { join } from "node:path";
3
+ //#region src/knowledge-discovery.ts
4
+ /**
5
+ * Enumerate scope entries without descending into pnpm's linked dependency graph.
6
+ * Selection, workspace discovery and enrichment remain caller policies.
7
+ */
8
+ function discoverScopedPackageDirectories(scopeDirectories) {
9
+ const packages = [];
10
+ for (const scopeDirectory of new Set(scopeDirectories)) {
11
+ let entries;
12
+ try {
13
+ entries = readdirSync(scopeDirectory, { withFileTypes: true });
14
+ } catch {
15
+ continue;
16
+ }
17
+ for (const entry of entries) {
18
+ if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;
19
+ const directory = join(scopeDirectory, entry.name);
20
+ try {
21
+ packages.push({
22
+ name: entry.name,
23
+ directory,
24
+ realDirectory: realpathSync(directory)
25
+ });
26
+ } catch {}
27
+ }
28
+ }
29
+ return packages;
30
+ }
31
+ /** Read authored docs only; never load artifacts, package code or object scans. */
32
+ function readPackageAgentDoc(directory, options = {}) {
33
+ const agentsPath = join(directory, "AGENTS.md");
34
+ const claudePath = join(directory, "CLAUDE.md");
35
+ const hasAgentsMd = existsSync(agentsPath);
36
+ const hasClaudeMd = existsSync(claudePath);
37
+ const agentsContent = hasAgentsMd ? readFileSync(agentsPath, "utf8") : "";
38
+ const claudeContent = hasClaudeMd && (!hasAgentsMd || options.inspectAdapter) ? readFileSync(claudePath, "utf8") : "";
39
+ const hasClaudeShim = hasClaudeMd && claudeContent.trim() === "@AGENTS.md";
40
+ const source = hasAgentsMd ? "AGENTS.md" : hasClaudeMd && !hasClaudeShim ? "CLAUDE.md" : null;
41
+ return {
42
+ hasAgentsMd,
43
+ hasClaudeMd,
44
+ hasClaudeShim,
45
+ agentsContent,
46
+ claudeContent,
47
+ source,
48
+ content: hasAgentsMd ? agentsContent : source ? claudeContent : null
49
+ };
50
+ }
51
+ //#endregion
52
+ export { discoverScopedPackageDirectories, readPackageAgentDoc };
53
+
54
+ //# sourceMappingURL=knowledge-discovery.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"knowledge-discovery.js","names":[],"sources":["../src/knowledge-discovery.ts"],"sourcesContent":["/** Filesystem-only discovery shared by docs snapshots and knowledge indexing. */\nimport type { Dirent } from 'node:fs';\nimport { existsSync, readdirSync, readFileSync, realpathSync } from 'node:fs';\nimport { join } from 'node:path';\n\nexport interface ScopedPackageDirectory {\n /** Scope entry name; consumers may select by alias rather than manifest name. */\n name: string;\n /** Original node_modules path, retained for workspace-relative reporting. */\n directory: string;\n /** Resolved path for identity comparisons or absolute snapshot links. */\n realDirectory: string;\n}\n\n/**\n * Enumerate scope entries without descending into pnpm's linked dependency graph.\n * Selection, workspace discovery and enrichment remain caller policies.\n */\nexport function discoverScopedPackageDirectories(\n scopeDirectories: string[],\n): ScopedPackageDirectory[] {\n const packages: ScopedPackageDirectory[] = [];\n for (const scopeDirectory of new Set(scopeDirectories)) {\n let entries: Dirent[];\n try {\n entries = readdirSync(scopeDirectory, { withFileTypes: true });\n } catch {\n continue;\n }\n for (const entry of entries) {\n if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;\n const directory = join(scopeDirectory, entry.name);\n try {\n packages.push({\n name: entry.name,\n directory,\n realDirectory: realpathSync(directory),\n });\n } catch {\n // Dangling links are not installed packages.\n }\n }\n }\n return packages;\n}\n\n/** Read authored docs only; never load artifacts, package code or object scans. */\nexport function readPackageAgentDoc(\n directory: string,\n options: { inspectAdapter?: boolean } = {},\n) {\n const agentsPath = join(directory, 'AGENTS.md');\n const claudePath = join(directory, 'CLAUDE.md');\n const hasAgentsMd = existsSync(agentsPath);\n const hasClaudeMd = existsSync(claudePath);\n const agentsContent = hasAgentsMd ? readFileSync(agentsPath, 'utf8') : '';\n const claudeContent =\n hasClaudeMd && (!hasAgentsMd || options.inspectAdapter)\n ? readFileSync(claudePath, 'utf8')\n : '';\n const hasClaudeShim = hasClaudeMd && claudeContent.trim() === '@AGENTS.md';\n const source: 'AGENTS.md' | 'CLAUDE.md' | null = hasAgentsMd\n ? 'AGENTS.md'\n : hasClaudeMd && !hasClaudeShim\n ? 'CLAUDE.md'\n : null;\n return {\n hasAgentsMd,\n hasClaudeMd,\n hasClaudeShim,\n agentsContent,\n claudeContent,\n source,\n content: hasAgentsMd ? agentsContent : source ? claudeContent : null,\n };\n}\n"],"mappings":";;;;;;;AAkBA,SAAgB,iCACd,kBAC0B;CAC1B,MAAM,WAAqC,CAAC;CAC5C,KAAK,MAAM,kBAAkB,IAAI,IAAI,gBAAgB,GAAG;EACtD,IAAI;EACJ,IAAI;GACF,UAAU,YAAY,gBAAgB,EAAE,eAAe,KAAK,CAAC;EAC/D,QAAQ;GACN;EACF;EACA,KAAK,MAAM,SAAS,SAAS;GAC3B,IAAI,CAAC,MAAM,YAAY,KAAK,CAAC,MAAM,eAAe,GAAG;GACrD,MAAM,YAAY,KAAK,gBAAgB,MAAM,IAAI;GACjD,IAAI;IACF,SAAS,KAAK;KACZ,MAAM,MAAM;KACZ;KACA,eAAe,aAAa,SAAS;IACvC,CAAC;GACH,QAAQ,CAER;EACF;CACF;CACA,OAAO;AACT;;AAGA,SAAgB,oBACd,WACA,UAAwC,CAAC,GACzC;CACA,MAAM,aAAa,KAAK,WAAW,WAAW;CAC9C,MAAM,aAAa,KAAK,WAAW,WAAW;CAC9C,MAAM,cAAc,WAAW,UAAU;CACzC,MAAM,cAAc,WAAW,UAAU;CACzC,MAAM,gBAAgB,cAAc,aAAa,YAAY,MAAM,IAAI;CACvE,MAAM,gBACJ,gBAAgB,CAAC,eAAe,QAAQ,kBACpC,aAAa,YAAY,MAAM,IAC/B;CACN,MAAM,gBAAgB,eAAe,cAAc,KAAK,MAAM;CAC9D,MAAM,SAA2C,cAC7C,cACA,eAAe,CAAC,gBACd,cACA;CACN,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA,SAAS,cAAc,gBAAgB,SAAS,gBAAgB;CAClE;AACF"}
@@ -1,5 +1,6 @@
1
1
  import { DomainKnowledgeAgentSurface, DomainKnowledgeConfig, DomainKnowledgeManifest, DomainKnowledgeModuleDoc } from '@happyvertical/smrt-types';
2
2
  import { SmartObjectManifest } from './scanner/types.js';
3
+ export { discoverScopedPackageDirectories, readPackageAgentDoc, type ScopedPackageDirectory, } from './knowledge-discovery.js';
3
4
  /**
4
5
  * Minimal package.json shape consumed by the knowledge builder.
5
6
  * `name`/`version` are typed concretely because they flow into the manifest's
@@ -1 +1 @@
1
- {"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../src/knowledge.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,2BAA2B,EAC3B,qBAAqB,EAGrB,uBAAuB,EAEvB,wBAAwB,EAIzB,MAAM,2BAA2B,CAAC;AASnC,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,CAkFzB"}
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;AAKlC,OAAO,KAAK,EACV,2BAA2B,EAC3B,qBAAqB,EAGrB,uBAAuB,EAEvB,wBAAwB,EAIzB,MAAM,2BAA2B,CAAC;AASnC,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,CAkFzB"}
package/dist/knowledge.js CHANGED
@@ -1,6 +1,7 @@
1
1
  import { toSnakeCase } from "./utils/naming.js";
2
2
  import { CRUD_OPERATIONS, isCrudOperation, isCrudToolAction, isFrameworkLifecycleMethod, resolveCustomActionMetadata } from "./generators/custom-action.js";
3
3
  import { isFrameworkBaseClass } from "./registry/framework-base-classes.js";
4
+ import { discoverScopedPackageDirectories, readPackageAgentDoc } from "./knowledge-discovery.js";
4
5
  import { createHash } from "node:crypto";
5
6
  import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
6
7
  import { basename, join, relative, resolve, sep } from "node:path";
@@ -394,15 +395,25 @@ function manifestObjectPackage(object, manifestKey) {
394
395
  * false` closes the surface entirely.
395
396
  *
396
397
  * Custom (non-CRUD, public) method gating is NOT identical across the three
397
- * kinds. `CLIGenerator.listCommands()`/`assertCommandExposed()` additionally
398
- * refuse a framework lifecycle method (`save`, `initialize`, ...) even when a
399
- * class declares its own override — it is the mechanism behind generated
400
- * CRUD, not a distinct action (#2638) — and `resolveCustomMethodNames()`
401
- * below mirrors that same `isFrameworkLifecycleMethod()` check for
402
- * `kind === 'cli'` only (#2657). `api`/`mcp` remain ungated on this: neither
403
- * generator changed in #2650, the mcp.ts wiring is separate #2638 scope still
404
- * pending, and the api-surface fix is a PR #2651 recommendation, not yet
405
- * implemented.
398
+ * kinds. `CLIGenerator.listCommands()`/`assertCommandExposed()` and
399
+ * `MCPGenerator.generateTools()` both refuse a framework lifecycle method
400
+ * (`save`, `initialize`, ...) even when a class declares its own override —
401
+ * it is the mechanism behind generated CRUD, not a distinct action (#2638) —
402
+ * and `resolveCustomMethodNames()` below mirrors that same
403
+ * `isFrameworkLifecycleMethod()` check for `kind === 'cli'` and
404
+ * `kind === 'mcp'` (#2657, #2638). `api` remains ungated on this: the
405
+ * generator did not change in #2650/#2638, and the fix there is a PR #2651
406
+ * recommendation, not yet implemented.
407
+ *
408
+ * `resolveCustomMethodNames()` also mirrors two more `mcp`-only behaviors
409
+ * that follow from its case-folded tool-id namespace (#2638): an `exclude`
410
+ * entry is compared case-insensitively (matching `MCPGenerator`'s own
411
+ * asymmetry fix -- `exclude` used to fail open on a cased entry the way
412
+ * `include` never did), and two method names that fold onto the same tool id
413
+ * (e.g. `Refresh`/`refresh`) are reported once, keeping whichever was
414
+ * declared first, mirroring `MCPGenerator`'s per-object dedup. `cli`/`api`
415
+ * keep declared casing in their command/route names, so neither behavior
416
+ * applies to them.
406
417
  *
407
418
  * This `cli` projection models `CLIGenerator` (`generators/cli.ts`), not the
408
419
  * shipped local CLI transport (`@happyvertical/smrt-cli`'s
@@ -431,13 +442,20 @@ function resolveCrudOperations(config) {
431
442
  function resolveCustomMethodNames(methods, config, kind) {
432
443
  const { include, exclude } = includeExcludeConfig(config);
433
444
  const excluded = new Set(exclude ?? []);
445
+ const excludedLower = kind === "mcp" ? new Set([...excluded].map((entry) => entry.toLowerCase())) : void 0;
446
+ const emittedLower = kind === "mcp" ? /* @__PURE__ */ new Set() : void 0;
434
447
  const names = [];
435
448
  for (const [name, method] of methods) {
436
449
  if (reservesCrudName(kind, name)) continue;
437
- if (kind === "cli" && isFrameworkLifecycleMethod(name)) continue;
450
+ if ((kind === "cli" || kind === "mcp") && isFrameworkLifecycleMethod(name)) continue;
438
451
  if (!method.isPublic) continue;
439
- if (excluded.has(name)) continue;
452
+ if (excludedLower ? excludedLower.has(name.toLowerCase()) : excluded.has(name)) continue;
440
453
  if (include !== void 0 && !include.includes(name)) continue;
454
+ if (emittedLower) {
455
+ const lower = name.toLowerCase();
456
+ if (emittedLower.has(lower)) continue;
457
+ emittedLower.add(lower);
458
+ }
441
459
  names.push(name);
442
460
  }
443
461
  return names;
@@ -683,6 +701,6 @@ function sortJson(value) {
683
701
  return value;
684
702
  }
685
703
  //#endregion
686
- export { AGENT_SURFACE_HASH_PREFIX, MODULE_DOC_HASH_PREFIX, buildDomainKnowledgeManifest, readAgentModuleDocs, resolveAgentModuleDocPaths };
704
+ export { AGENT_SURFACE_HASH_PREFIX, MODULE_DOC_HASH_PREFIX, buildDomainKnowledgeManifest, discoverScopedPackageDirectories, readAgentModuleDocs, readPackageAgentDoc, resolveAgentModuleDocPaths };
687
705
 
688
706
  //# sourceMappingURL=knowledge.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"knowledge.js","names":[],"sources":["../src/knowledge.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';\nimport { basename, join, relative, resolve, sep } from 'node:path';\nimport type {\n DomainKnowledgeAgentSurface,\n DomainKnowledgeConfig,\n DomainKnowledgeField,\n DomainKnowledgeFieldConstraints,\n DomainKnowledgeManifest,\n DomainKnowledgeMethodSignature,\n DomainKnowledgeModuleDoc,\n DomainKnowledgeObject,\n DomainKnowledgeSurface,\n DomainKnowledgeTenant,\n} from '@happyvertical/smrt-types';\nimport {\n CRUD_OPERATIONS,\n isCrudOperation,\n isCrudToolAction,\n isFrameworkLifecycleMethod,\n resolveCustomActionMetadata,\n} from './generators/custom-action.js';\nimport { isFrameworkBaseClass } from './registry/framework-base-classes.js';\nimport type {\n SmartObjectDefinition,\n SmartObjectManifest,\n} from './scanner/types.js';\nimport { toSnakeCase } from './utils/naming.js';\n\n/**\n * Minimal package.json shape consumed by the knowledge builder.\n * `name`/`version` are typed concretely because they flow into the manifest's\n * string-typed metadata fields; everything else is read via `unknown`-accepting\n * helpers (`record()`, `exportKeys()`), so an index signature is sufficient.\n */\nexport interface PackageJsonLike {\n name?: string;\n version?: string;\n [key: string]: unknown;\n}\n\nexport interface BuildDomainKnowledgeOptions {\n manifest: SmartObjectManifest;\n rootDir: string;\n packageJson?: PackageJsonLike;\n manifestPath?: string;\n config?: DomainKnowledgeConfig;\n /**\n * The package's declared view intents and playbooks (#2591), produced by the\n * scanner's agent-surface matcher.\n *\n * Passed in rather than scanned here for one reason: the scanner carries a\n * native parser binary, and `smrt-core`'s main entry is browser-reachable.\n * The Vite plugin already imports the scanner lazily on the Node side and is\n * the one caller that writes this artifact, so it does the scan and hands the\n * result over.\n */\n agentSurface?: DomainKnowledgeAgentSurface;\n}\n\nconst SDK_PACKAGE_NAMES = new Set([\n '@happyvertical/ai',\n '@happyvertical/cache',\n '@happyvertical/documents',\n '@happyvertical/email',\n '@happyvertical/encryption',\n '@happyvertical/files',\n '@happyvertical/geo',\n '@happyvertical/images',\n '@happyvertical/jobs',\n '@happyvertical/json',\n '@happyvertical/logger',\n '@happyvertical/messages',\n '@happyvertical/ocr',\n '@happyvertical/pdf',\n '@happyvertical/projects',\n '@happyvertical/repos',\n '@happyvertical/secrets',\n '@happyvertical/spider',\n '@happyvertical/sql',\n '@happyvertical/utils',\n]);\n\nconst RELATIONSHIP_FIELD_TYPES = new Set([\n 'foreignKey',\n 'crossPackageRef',\n 'oneToMany',\n 'manyToMany',\n]);\n\n/**\n * The generated CRUD verbs, derived from the generators' own list so both\n * halves of this projection — which operations are ENUMERATED\n * (`resolveCrudOperations`) and which method names are RESERVED\n * (`reservesCrudName`) — move together. Reading one from `CRUD_OPERATIONS` and\n * the other from a local copy would let a new verb be suppressed as a custom\n * method while never being added as CRUD, dropping the surface entirely.\n */\nconst STANDARD_OPERATIONS: readonly string[] = CRUD_OPERATIONS;\n\n/**\n * Markdown inline links whose target is a `.md` file — `[label](agents/x.md)`,\n * tolerating an `#anchor` and a `\"title\"`. This is how a package registers a\n * sibling module doc (#2108): the link in `AGENTS.md` IS the registration, so\n * there is no separate index to drift out of sync.\n */\nconst MARKDOWN_MD_LINK =\n /\\[[^\\]]*\\]\\(\\s*([^)\\s#]+\\.md)(?:#[^)\\s]*)?(?:\\s+\"[^\"]*\")?\\s*\\)/g;\n\n/** `sourceHashes` key prefix for a linked module doc, e.g. `moduleDoc:agents/crm.md`. */\nexport const MODULE_DOC_HASH_PREFIX = 'moduleDoc:';\n\n/**\n * `sourceHashes` key prefix for a module declaring a view intent or playbook,\n * e.g. `agentSurface:src/lib/orders.intents.ts` (#2591).\n */\nexport const AGENT_SURFACE_HASH_PREFIX = 'agentSurface:';\n\n/**\n * Module doc paths linked from a package's `AGENTS.md`, relative to the package\n * root and in document order.\n *\n * Instruction chains are additive (see `scripts/check-agents-chain.mjs`), so an\n * oversized package doc is split into `packages/<pkg>/agents/<module>.md` siblings\n * instead of nested `AGENTS.md` files. Only links resolving to an existing file\n * INSIDE the package are accepted — a cross-package reference such as\n * `packages/affiliates/MIGRATION.md` belongs to that package's own chain and is\n * ignored here.\n */\nexport function resolveAgentModuleDocPaths(\n rootDir: string,\n agentDoc: string | undefined,\n): string[] {\n if (!agentDoc) return [];\n const root = resolve(rootDir);\n const paths: string[] = [];\n for (const match of agentDoc.matchAll(MARKDOWN_MD_LINK)) {\n const target = match[1];\n if (target.includes('://')) continue;\n const absolute = resolve(root, target);\n if (absolute !== root && !absolute.startsWith(root + sep)) continue;\n const relativePath = relative(root, absolute).split(sep).join('/');\n if (relativePath === 'AGENTS.md' || relativePath === 'CLAUDE.md') continue;\n if (paths.includes(relativePath)) continue;\n if (!existsSync(absolute) || !statSync(absolute).isFile()) continue;\n paths.push(relativePath);\n }\n return paths;\n}\n\n/** {@link resolveAgentModuleDocPaths}, with each doc's contents read. */\nexport function readAgentModuleDocs(\n rootDir: string,\n agentDoc: string | undefined,\n): DomainKnowledgeModuleDoc[] {\n return resolveAgentModuleDocPaths(rootDir, agentDoc).map((path) => ({\n path,\n module: basename(path, '.md'),\n content: readFileSync(join(rootDir, path), 'utf8'),\n }));\n}\n\nexport function buildDomainKnowledgeManifest(\n options: BuildDomainKnowledgeOptions,\n): DomainKnowledgeManifest {\n const rootDir = options.rootDir;\n const packageJson = options.packageJson ?? readPackageJson(rootDir) ?? {};\n const packageName = options.manifest.packageName ?? packageJson.name;\n const packageVersion = options.manifest.packageVersion ?? packageJson.version;\n const agentDocPath = existingPath(rootDir, 'AGENTS.md');\n const agentDocContent = agentDocPath\n ? readFileSync(agentDocPath, 'utf8')\n : undefined;\n const includeDocs = options.config?.includeDocs !== false;\n const agentDoc = includeDocs ? agentDocContent : undefined;\n // Module doc PATHS are always resolved so their hashes gate freshness even\n // when doc bodies are excluded from the artifact — same stance as `agents`.\n const moduleDocPaths = resolveAgentModuleDocPaths(rootDir, agentDocContent);\n const allDependencies = {\n ...record(packageJson.dependencies),\n ...record(packageJson.devDependencies),\n ...record(packageJson.peerDependencies),\n };\n const manifestObjects = Object.values(options.manifest.objects).filter(\n (object) => object.decoratorConfig?.knowledge !== false,\n );\n const objects = manifestObjects.map((object) =>\n buildKnowledgeObject(object, options.manifest),\n );\n const surfaces = objects.flatMap((object) => object.surfaces);\n const manifestJson = stableJson(normalizeManifestForHash(options.manifest));\n const agentSurface = normalizeAgentSurface(options.agentSurface);\n\n return {\n schemaVersion: 1,\n sensitiveFieldsExcluded: true,\n generatedAt: new Date().toISOString(),\n packageName,\n packageVersion,\n sourceManifestPath: options.manifestPath\n ? relative(rootDir, options.manifestPath)\n : undefined,\n agentDocPath: agentDocPath ? relative(rootDir, agentDocPath) : undefined,\n sourceHashes: sourceHashes({\n manifest: { content: manifestJson },\n packageJson: fileHashSource(existingPath(rootDir, 'package.json')),\n agents: fileHashSource(agentDocPath),\n ...Object.fromEntries(\n moduleDocPaths.map((path) => [\n `${MODULE_DOC_HASH_PREFIX}${path}`,\n fileHashSource(join(rootDir, path)),\n ]),\n ),\n // A module declaring an intent or a playbook is an authored source of\n // this artifact exactly like `AGENTS.md` is, so editing one must mark the\n // artifact stale (#2591).\n ...Object.fromEntries(\n agentSurfaceSourcePaths(agentSurface).map((path) => [\n `${AGENT_SURFACE_HASH_PREFIX}${path}`,\n fileHashSource(join(rootDir, path)),\n ]),\n ),\n }),\n exports: exportKeys(packageJson.exports),\n dependencies: allDependencies,\n smrtDependencies: Object.keys(allDependencies)\n .filter((dep) => dep.startsWith('@happyvertical/smrt-'))\n .sort(),\n sdkDependencies: Object.keys(allDependencies)\n .filter((dep) => SDK_PACKAGE_NAMES.has(dep))\n .sort(),\n tags: options.config?.tags ?? [],\n summary: options.config?.summary,\n risks: options.config?.risks ?? [],\n objects,\n surfaces,\n prompts:\n options.config?.includePrompts === false ? [] : readPrompts(rootDir),\n relationshipsV2: summarizeRelationships(objects, manifestObjects),\n agentDoc,\n moduleDocs:\n includeDocs && moduleDocPaths.length > 0\n ? readAgentModuleDocs(rootDir, agentDocContent)\n : undefined,\n agentSurface,\n };\n}\n\n/**\n * Drop an agent surface that carries nothing.\n *\n * Keeping the key absent for a package that declares no intent, no playbook,\n * and no diagnostic is what makes this field additive in practice: every\n * checked-in artifact for such a package stays byte-identical to what it\n * emitted before the field existed, so adding emission does not churn the\n * repository's knowledge artifacts.\n */\nfunction normalizeAgentSurface(\n surface: DomainKnowledgeAgentSurface | undefined,\n): DomainKnowledgeAgentSurface | undefined {\n if (!surface) return undefined;\n const empty =\n surface.intents.length === 0 &&\n surface.playbooks.length === 0 &&\n surface.diagnostics.length === 0;\n return empty ? undefined : surface;\n}\n\n/** Every package-relative module that contributed to the emitted surface. */\nfunction agentSurfaceSourcePaths(\n surface: DomainKnowledgeAgentSurface | undefined,\n): string[] {\n if (!surface) return [];\n const paths = new Set<string>();\n for (const intent of surface.intents) paths.add(intent.sourceFile);\n for (const playbook of surface.playbooks) paths.add(playbook.sourceFile);\n for (const diagnostic of surface.diagnostics)\n paths.add(diagnostic.sourceFile);\n return [...paths].sort();\n}\n\nfunction buildKnowledgeObject(\n object: SmartObjectDefinition,\n manifest: SmartObjectManifest,\n): DomainKnowledgeObject {\n const knowledge =\n typeof object.decoratorConfig?.knowledge === 'object'\n ? object.decoratorConfig.knowledge\n : {};\n const fields = Object.entries(object.fields)\n .filter(([, field]) => !isSensitiveField(field))\n .map(([name, field]): DomainKnowledgeField => {\n const defaultValue = fieldValue(field, 'default');\n return {\n name,\n type: field.type,\n required: field.required,\n related: field.related,\n columnType: columnType(object, name),\n ...(defaultValue.present ? { default: defaultValue.value } : {}),\n constraints: fieldConstraints(field),\n readonly:\n field.readonly === true || field._meta?.readonly === true\n ? true\n : undefined,\n transient:\n field.transient === true || field._meta?.transient === true\n ? true\n : undefined,\n };\n });\n const sensitiveIdentifiers = sensitiveFieldIdentifiers(object.fields);\n const tenant = sanitizeTenantFacts(\n tenantFacts(object.decoratorConfig?.tenantScoped),\n sensitiveIdentifiers,\n );\n const conflictColumns = object.decoratorConfig?.conflictColumns?.filter(\n (column) => !sensitiveIdentifiers.has(column),\n );\n const relationships = fields\n .filter((field) => RELATIONSHIP_FIELD_TYPES.has(field.type))\n .map((field) => ({\n name: field.name,\n type: field.type,\n required: field.required,\n related: field.related,\n columnType: field.columnType,\n }));\n\n return {\n name: object.className,\n qualifiedName: object.qualifiedName,\n collection: object.collection,\n tableName: object.schema?.tableName,\n packageName: object.packageName,\n extends: object.extends,\n visibility: object.visibility,\n fields,\n relationships,\n methods: Object.keys(object.methods).sort(),\n methodSignatures: methodSignatures(object),\n tenant,\n tableStrategy: object.decoratorConfig?.tableStrategy,\n conflictColumns:\n conflictColumns && conflictColumns.length > 0\n ? conflictColumns\n : undefined,\n surfaces: objectSurfaces(object, manifest),\n relationshipFeatures: relationshipFeatures(object, fields),\n tags: knowledge.tags ?? [],\n summary: knowledge.summary,\n risks: knowledge.risks ?? [],\n };\n}\n\nfunction isSensitiveField(field: SmartObjectDefinition['fields'][string]) {\n return field.sensitive === true || field._meta?.sensitive === true;\n}\n\nfunction sensitiveFieldIdentifiers(\n fields: SmartObjectDefinition['fields'],\n): Set<string> {\n return new Set(\n Object.entries(fields)\n .filter(([, field]) => isSensitiveField(field))\n .flatMap(([name]) => [name, toSnakeCase(name), camelToSnake(name)]),\n );\n}\n\nfunction fieldValue(\n field: SmartObjectDefinition['fields'][string],\n key: 'default' | 'min' | 'max' | 'minLength' | 'maxLength',\n): { present: boolean; value: unknown } {\n if (Object.hasOwn(field, key)) {\n return { present: field[key] !== undefined, value: field[key] };\n }\n const value = field._meta?.[key];\n return { present: value !== undefined, value };\n}\n\nfunction fieldConstraints(\n field: SmartObjectDefinition['fields'][string],\n): DomainKnowledgeFieldConstraints | undefined {\n const constraints: DomainKnowledgeFieldConstraints = {};\n for (const key of ['min', 'max', 'minLength', 'maxLength'] as const) {\n const value = fieldValue(field, key);\n if (value.present && typeof value.value === 'number') {\n constraints[key] = value.value;\n }\n }\n const pattern = normalizePattern(\n (field as { pattern?: unknown }).pattern ?? field._meta?.pattern,\n );\n if (pattern !== undefined) constraints.pattern = pattern;\n return Object.keys(constraints).length > 0 ? constraints : undefined;\n}\n\nfunction normalizePattern(pattern: unknown): string | undefined {\n if (typeof pattern === 'string') return pattern;\n if (pattern instanceof RegExp) return pattern.source;\n if (\n pattern &&\n typeof pattern === 'object' &&\n typeof (pattern as { source?: unknown }).source === 'string'\n ) {\n return (pattern as { source: string }).source;\n }\n return undefined;\n}\n\nfunction tenantFacts(\n tenantScoped: SmartObjectDefinition['decoratorConfig']['tenantScoped'],\n): DomainKnowledgeTenant | undefined {\n if (!tenantScoped) return undefined;\n if (tenantScoped === true) {\n return { scoped: true, mode: 'required', field: 'tenantId' };\n }\n return {\n scoped: true,\n mode: tenantScoped.mode ?? 'required',\n field: tenantScoped.field ?? 'tenantId',\n };\n}\n\nfunction sanitizeTenantFacts(\n tenant: DomainKnowledgeTenant | undefined,\n sensitiveIdentifiers: Set<string>,\n): DomainKnowledgeTenant | undefined {\n if (!tenant?.field || !sensitiveIdentifiers.has(tenant.field)) return tenant;\n return { scoped: tenant.scoped, mode: tenant.mode };\n}\n\nfunction methodSignatures(\n object: SmartObjectDefinition,\n): DomainKnowledgeMethodSignature[] | undefined {\n const signatures = Object.values(object.methods)\n .sort((a, b) => a.name.localeCompare(b.name))\n .map((method) => ({\n name: method.name,\n async: method.async || undefined,\n static: method.isStatic || undefined,\n params:\n method.parameters.length > 0\n ? method.parameters.map(\n (parameter) =>\n `${parameter.name}${parameter.optional ? '?' : ''}: ${parameter.type}`,\n )\n : undefined,\n returns: method.returnType || undefined,\n }));\n return signatures.length > 0 ? signatures : undefined;\n}\n\nfunction objectSurfaces(\n object: SmartObjectDefinition,\n manifest: SmartObjectManifest,\n): DomainKnowledgeSurface[] {\n return [\n ...configuredSurfaces('api', object, manifest),\n ...configuredSurfaces('cli', object, manifest),\n ...configuredSurfaces('mcp', object, manifest),\n ...aiSurfaces(object),\n ];\n}\n\nfunction configuredSurfaces(\n kind: 'api' | 'cli' | 'mcp',\n object: SmartObjectDefinition,\n manifest: SmartObjectManifest,\n): DomainKnowledgeSurface[] {\n const config = object.decoratorConfig?.[kind];\n // NOTE: the `cli` projection models core's `CLIGenerator`, which reserves a\n // CRUD verb unconditionally. That is NOT the shipped local CLI:\n // `@happyvertical/smrt-cli`'s generator reserves one only where the CRUD\n // command is emitted (each of its commands carries its own handler), so with\n // `cli: { include: ['list', 'get'] }` a public `create()` is a reachable\n // `${object}:create` there that this projection does not report.\n //\n // Retargeting this projection at the shipped binary is tracked on #2664.\n // That is a CONTRACT CHANGE rather than a cleanup: the generators genuinely\n // disagree, so `smrt-knowledge.json` snapshots would move. Predates #2646.\n const collectionClass = isSurfaceCollectionClass(manifest, object);\n const operations = configuredOperations(kind, object, config, manifest);\n return operations.map((operation) => {\n const route =\n kind === 'api' && !STANDARD_OPERATIONS.includes(operation)\n ? apiCustomRoute(object, operation, collectionClass)\n : undefined;\n return {\n kind,\n name: surfaceName(kind, object, operation),\n operation,\n objectName: object.qualifiedName ?? object.className,\n path: kind === 'api' ? apiPath(object, operation, route) : undefined,\n method: kind === 'api' ? apiMethod(operation, route) : undefined,\n };\n });\n}\n\n/**\n * `MCPGenerator.buildCustomActionTool()` registers a custom-action tool as\n * `` `${lowerName}_${methodName}`.toLowerCase() `` — lowercasing the WHOLE\n * joined string, not just the object-name prefix. A CRUD verb is already\n * lowercase so this is a no-op there, but a camelCase custom method name\n * (`findByDimensions`) would otherwise report a surface `name` the real tool\n * is never registered under. `CLIGenerator.listCommands()` does not\n * lowercase the method half of its command string, so `cli` keeps the\n * operation as-authored.\n *\n * Note the shapes differ from the transports' own: a `cli` surface `name`\n * here is `object_operation`, while the command a user types is\n * `object:operation`. `operation` is the field to correlate on.\n */\nfunction surfaceName(\n kind: 'api' | 'cli' | 'mcp',\n object: SmartObjectDefinition,\n operation: string,\n): string {\n if (kind === 'api') return `${object.collection}.${operation}`;\n const name = `${object.className.toLowerCase()}_${operation}`;\n return kind === 'mcp' ? name.toLowerCase() : name;\n}\n\n/**\n * A hand-written `SmrtCollection` subclass (`class WidgetCollection extends\n * SmrtCollection<Widget>`) is discovered structurally by the scanner and\n * lands in the manifest even without its own `@smrt()` decorator, so it never\n * registers with `ObjectRegistry`. `MCPGenerator`/`CLIGenerator` iterate\n * `ObjectRegistry`, not the manifest, so such a class never gets its own\n * MCP tools or CLI commands — only its collection-scoped custom actions get\n * REST routes. Reporting full CRUD for it here would over-report a surface\n * that does not exist, trading the #2619 under-report for a new false\n * positive.\n *\n * A deeper subclass (`SpecialCollection extends WidgetCollection`) carries no\n * `extendsTypeArg` of its own, so this walks the extends chain through the\n * manifest — mirroring `isCollectionManifestClass` in\n * `vite-plugin/web-collections.ts` (kept as a separate, lean implementation\n * here rather than imported: that module pulls in the full SvelteKit route\n * generator transitively, which would balloon the standalone `./knowledge`\n * build entry for a ~15-line check).\n */\nfunction isSurfaceCollectionClass(\n manifest: SmartObjectManifest,\n object: SmartObjectDefinition,\n seen: Set<string> = new Set(),\n): boolean {\n // Truthy check (not `!== undefined`) mirrors the scanner: a non-generic\n // base emitting `extendsTypeArg: null` must not be misread as a collection.\n if (object.extends === 'SmrtCollection' || object.extendsTypeArg) {\n return true;\n }\n const parentName = object.extendsQualified || object.extends;\n if (!parentName || seen.has(parentName)) return false;\n seen.add(parentName);\n const parent = findManifestObjectByName(manifest, parentName, object);\n return parent ? isSurfaceCollectionClass(manifest, parent, seen) : false;\n}\n\nfunction findManifestObjectByName(\n manifest: SmartObjectManifest,\n name: string,\n owner: SmartObjectDefinition,\n): SmartObjectDefinition | undefined {\n const entries = Object.entries(manifest.objects);\n if (name.includes(':')) {\n const exact = entries.find(\n ([key, candidate]) => (candidate.qualifiedName ?? key) === name,\n );\n if (exact) return exact[1];\n }\n // Prefer a same-package parent before falling back to a bare simple name:\n // an aggregated manifest can carry several classes sharing one simple name,\n // and resolving the wrong one misclassifies the collection-class carve-out.\n const ownerKey = entries.find(([, candidate]) => candidate === owner)?.[0];\n const ownerPackage = manifestObjectPackage(owner, ownerKey);\n if (ownerPackage) {\n const packageLocal = entries.find(\n ([key, candidate]) =>\n manifestObjectPackage(candidate, key) === ownerPackage &&\n candidate.className === name,\n );\n if (packageLocal) return packageLocal[1];\n }\n return entries.find(([, candidate]) => candidate.className === name)?.[1];\n}\n\n/**\n * An object's owning package. `packageName` is optional on\n * `SmartObjectDefinition` (older manifests and hand-built fixtures omit it),\n * so fall back to the package half of the qualified name — and, when that is\n * absent too, of the manifest key, which is qualified for every entry the\n * scanner writes. Mirrors `manifestObjectPackage` in\n * `vite-plugin/web-collections.ts`, key fallback included: without it an\n * entry carrying only a qualified key resolves no package at all, the\n * same-package preference is skipped, and a duplicate simple name can pick\n * the wrong parent.\n */\nfunction manifestObjectPackage(\n object: SmartObjectDefinition,\n manifestKey?: string,\n): string | undefined {\n if (object.packageName) return object.packageName;\n const qualifiedName = object.qualifiedName ?? manifestKey;\n const separator = qualifiedName?.lastIndexOf(':') ?? -1;\n return separator > 0 ? qualifiedName?.slice(0, separator) : undefined;\n}\n\n/**\n * Operations exposed for one object's `api`/`cli`/`mcp` surface, derived from\n * the same defaults `APIGenerator`/`CLIGenerator`/`MCPGenerator` apply rather\n * than from the presence of a config key (#2619): an omitted config is full\n * CRUD, not a closed surface — an `include` list, when present, is the\n * COMPLETE allowlist for custom methods too; without one, every public\n * method not explicitly excluded is exposed by default. Only `config ===\n * false` closes the surface entirely.\n *\n * Custom (non-CRUD, public) method gating is NOT identical across the three\n * kinds. `CLIGenerator.listCommands()`/`assertCommandExposed()` additionally\n * refuse a framework lifecycle method (`save`, `initialize`, ...) even when a\n * class declares its own override — it is the mechanism behind generated\n * CRUD, not a distinct action (#2638) — and `resolveCustomMethodNames()`\n * below mirrors that same `isFrameworkLifecycleMethod()` check for\n * `kind === 'cli'` only (#2657). `api`/`mcp` remain ungated on this: neither\n * generator changed in #2650, the mcp.ts wiring is separate #2638 scope still\n * pending, and the api-surface fix is a PR #2651 recommendation, not yet\n * implemented.\n *\n * This `cli` projection models `CLIGenerator` (`generators/cli.ts`), not the\n * shipped local CLI transport (`@happyvertical/smrt-cli`'s\n * `cli-generator.ts`, the `smrt <object>:<action>` binary): that generator\n * does not gate on `isFrameworkLifecycleMethod()` today, so a locally\n * overridden lifecycle method the artifact now reports as absent can still\n * be invoked there. Retargeting this projection at the shipped binary is a\n * contract change tracked on #2664, not part of this fix.\n */\nfunction configuredOperations(\n kind: 'api' | 'cli' | 'mcp',\n object: SmartObjectDefinition,\n config: unknown,\n manifest: SmartObjectManifest,\n): string[] {\n if (config === false) return [];\n // The framework's own abstract base classes (SmrtObject, SmrtCollection,\n // ...) are scaffolding, not resources: MCPGenerator/CLIGenerator/route\n // generation all skip them by class identity now (#2642), independent of\n // their `decoratorConfig: {}` shape, so this mirrors the same shared\n // check rather than reporting a synthetic surface for them.\n if (isFrameworkBaseClass(object.className, object.packageName)) return [];\n const collectionClass = isSurfaceCollectionClass(manifest, object);\n const crud = collectionClass ? [] : resolveCrudOperations(config);\n const custom = resolveCustomMethodNames(\n Object.entries(object.methods),\n config,\n kind,\n );\n // REST additionally refuses a custom action whose receiver cannot exist —\n // a collection class emits only collection-scoped routes, and a model class\n // warns and skips a collection-scoped non-static method. Reporting one\n // would advertise a route `generateRoutesForObject` never writes.\n const eligible =\n kind === 'api'\n ? custom.filter(\n (operation) =>\n apiCustomRoute(object, operation, collectionClass) !== undefined,\n )\n : custom;\n return [...crud, ...eligible];\n}\n\nfunction resolveCrudOperations(config: unknown): string[] {\n const { include, exclude } = includeExcludeConfig(config);\n const base = include\n ? STANDARD_OPERATIONS.filter((operation) => include.includes(operation))\n : [...STANDARD_OPERATIONS];\n if (!exclude || exclude.length === 0) return base;\n const excluded = new Set(exclude);\n return base.filter((operation) => !excluded.has(operation));\n}\n\nfunction resolveCustomMethodNames(\n methods: Iterable<[string, { isPublic?: boolean }]>,\n config: unknown,\n kind: 'api' | 'cli' | 'mcp',\n): string[] {\n const { include, exclude } = includeExcludeConfig(config);\n const excluded = new Set(exclude ?? []);\n const names: string[] = [];\n for (const [name, method] of methods) {\n if (reservesCrudName(kind, name)) continue;\n // A framework lifecycle method (save/initialize/...) is never a custom\n // CLI action, even when a class declares its own override — it is the\n // mechanism behind generated CRUD, not a distinct operation, matching\n // CLIGenerator's own isFrameworkLifecycleMethod() gate (#2657). `api`\n // and `mcp` are deliberately left alone — see configuredOperations'\n // doc comment above.\n if (kind === 'cli' && isFrameworkLifecycleMethod(name)) continue;\n if (!method.isPublic) continue;\n if (excluded.has(name)) continue;\n if (include !== undefined && !include.includes(name)) continue;\n names.push(name);\n }\n return names;\n}\n\n/**\n * Whether `kind` reserves `name` for its generated CRUD operation, so the\n * method behind it is not reported as a distinct surface.\n *\n * MCP folds case: its tool ids are lowercased whole\n * (`` `${object}_${method}`.toLowerCase() ``), so a method named `List` lands on\n * the `${object}_list` identifier the CRUD tool already owns and\n * `MCPGenerator` emits no separate tool for it (#2646). REST and the CLI keep\n * the declared casing in their route/command names, so only an exact match is\n * reserved there.\n *\n * Reads the emitters' own predicates rather than re-testing the verb list, and\n * `STANDARD_OPERATIONS` derives from `CRUD_OPERATIONS`, so a change to the\n * shared list reaches both halves of this projection together.\n */\nfunction reservesCrudName(kind: 'api' | 'cli' | 'mcp', name: string): boolean {\n return kind === 'mcp' ? isCrudToolAction(name) : isCrudOperation(name);\n}\n\nfunction includeExcludeConfig(config: unknown): {\n include?: string[];\n exclude?: string[];\n} {\n if (typeof config !== 'object' || config === null || Array.isArray(config)) {\n return {};\n }\n // A non-array `include`/`exclude` is treated as unset rather than\n // throwing later on `.includes()` — mirrors the same defensive stance\n // `shouldIncludeInApi` in `vite-plugin/sveltekit-generator.ts` takes for\n // a scanned decorator config that failed to resolve to an array.\n const record = config as { include?: unknown; exclude?: unknown };\n return {\n include: Array.isArray(record.include) ? record.include : undefined,\n exclude: Array.isArray(record.exclude) ? record.exclude : undefined,\n };\n}\n\nfunction aiSurfaces(object: SmartObjectDefinition): DomainKnowledgeSurface[] {\n return (object.tools ?? []).map((tool) => ({\n kind: 'ai',\n name: tool.function.name,\n operation: tool.function.name,\n description: tool.function.description,\n objectName: object.qualifiedName ?? object.className,\n }));\n}\n\n/** Route facts for one custom action, as `generateRoutesForObject` emits it. */\ninterface ApiCustomRoute {\n scope: 'item' | 'collection';\n segments: string[];\n method: string;\n}\n\n/**\n * Resolve a custom (non-CRUD) action's REST route the way the generator does,\n * or `undefined` when no route is emitted for it at all.\n *\n * A custom action's path is NOT `/collection/action`: `generateRoutesForObject`\n * nests an item-scoped action under `[id]`, and an instance method defaults to\n * item scope. Reporting the collection-shaped path for every public instance\n * method would advertise endpoints that do not exist — the exact failure this\n * projection exists to avoid. Scope comes from the shared\n * `resolveCustomActionMetadata`, the same resolver the REST, CLI, MCP, and\n * WebMCP paths use, so a `routes` override cannot drift between them.\n *\n * `kebabRoutes` is a Vite-plugin option rather than manifest data, so an\n * explicit `routes[action].path` is honored but the generator's optional\n * kebab-casing of a derived segment is not visible here.\n */\nfunction apiCustomRoute(\n object: SmartObjectDefinition,\n operation: string,\n collectionClass: boolean,\n): ApiCustomRoute | undefined {\n const method = object.methods[operation];\n const apiConfig = object.decoratorConfig?.api;\n const defaultScope: 'item' | 'collection' =\n collectionClass || method?.isStatic ? 'collection' : 'item';\n const scope = resolveActionScope(operation, method, apiConfig, defaultScope);\n\n // Mirrors the generator's own skips: a collection class emits only\n // collection-scoped routes, and a model class warns and skips a\n // collection-scoped non-static method (no receiver to bind).\n if (collectionClass) {\n if (scope !== 'collection') return undefined;\n } else if (scope === 'collection' && !method?.isStatic) {\n return undefined;\n }\n\n const route = customRouteConfig(apiConfig, operation);\n const overridden =\n typeof route?.path === 'string'\n ? route.path\n .split('/')\n .map((segment) => segment.trim())\n .filter(Boolean)\n : [];\n return {\n scope,\n segments: overridden.length > 0 ? overridden : [operation],\n method: normalizeApiMethod(route?.method),\n };\n}\n\n/**\n * The shared resolver validates as it resolves — a `routes` entry declaring\n * `effect: 'read'` on a PUT/PATCH/DELETE route throws by design. This\n * projection reads untrusted scanned config and must not fail the whole\n * knowledge build for one malformed action (same defensive stance as\n * {@link includeExcludeConfig}), so fall back to the receiver the method\n * itself dictates — which a route-only override cannot change anyway.\n */\nfunction resolveActionScope(\n operation: string,\n method: SmartObjectDefinition['methods'][string] | undefined,\n apiConfig: unknown,\n defaultScope: 'item' | 'collection',\n): 'item' | 'collection' {\n try {\n return resolveCustomActionMetadata({\n actionName: operation,\n method,\n apiConfig,\n defaultScope,\n }).scope;\n } catch {\n return defaultScope;\n }\n}\n\nfunction customRouteConfig(\n apiConfig: unknown,\n operation: string,\n): { path?: unknown; method?: unknown } | undefined {\n if (typeof apiConfig !== 'object' || apiConfig === null) return undefined;\n const routes = (apiConfig as { routes?: unknown }).routes;\n if (typeof routes !== 'object' || routes === null) return undefined;\n const route = (routes as Record<string, unknown>)[operation];\n return typeof route === 'object' && route !== null\n ? (route as { path?: unknown; method?: unknown })\n : undefined;\n}\n\n/** Mirrors `normalizeApiHttpMethod` in `vite-plugin/sveltekit-generator.ts`. */\nfunction normalizeApiMethod(method: unknown): string {\n const normalized =\n typeof method === 'string' ? method.toUpperCase() : undefined;\n switch (normalized) {\n case 'GET':\n case 'POST':\n case 'PUT':\n case 'PATCH':\n case 'DELETE':\n return normalized;\n default:\n return 'POST';\n }\n}\n\n/**\n * The collection segment of a generated REST route.\n *\n * `generateRoutesForObject` builds its route directory from\n * `objectDef.collection` verbatim, and the runtime dispatcher in\n * `generators/rest.ts` matches the URL segment against `info.collection`\n * verbatim, so this reports that and nothing else (#2630).\n *\n * In particular it does NOT read `api.path`, which configures a different\n * surface: `@happyvertical/smrt-agents`' own agent-facing route map derives\n * `api.path ?? tableName.replace(/_/g, '-')`. Honoring it here produced a\n * hybrid — `api.path` over `collection` — that matched neither transport and\n * named endpoints that 404 on both.\n */\nfunction apiCollectionSegment(object: SmartObjectDefinition): string {\n return object.collection;\n}\n\nfunction apiPath(\n object: SmartObjectDefinition,\n operation: string,\n route?: ApiCustomRoute,\n): string {\n const configuredPath = apiCollectionSegment(object);\n if (route) {\n const base =\n route.scope === 'collection'\n ? `/${configuredPath}`\n : `/${configuredPath}/[id]`;\n return `${base}/${route.segments.join('/')}`;\n }\n if (operation === 'list' || operation === 'create') {\n return `/${configuredPath}`;\n }\n if (STANDARD_OPERATIONS.includes(operation)) {\n return `/${configuredPath}/[id]`;\n }\n return `/${configuredPath}/${operation}`;\n}\n\nfunction apiMethod(operation: string, route?: ApiCustomRoute): string {\n if (route) return route.method;\n switch (operation) {\n case 'list':\n case 'get':\n return 'GET';\n case 'create':\n return 'POST';\n case 'update':\n return 'PATCH';\n case 'delete':\n return 'DELETE';\n default:\n return 'POST';\n }\n}\n\nfunction relationshipFeatures(\n object: SmartObjectDefinition,\n fields: DomainKnowledgeField[],\n): string[] {\n const features = new Set<string>();\n for (const field of fields) {\n if (field.type === 'foreignKey') features.add('foreignKey');\n if (field.type === 'crossPackageRef') features.add('crossPackageRef');\n if (field.type === 'oneToMany') features.add('oneToMany');\n if (field.type === 'manyToMany') features.add('manyToMany');\n }\n if (object.extends === 'SmrtJunction') features.add('SmrtJunction');\n if (object.extends === 'SmrtHierarchical') features.add('SmrtHierarchical');\n if (\n object.extends === 'SmrtPolymorphicAssociation' ||\n fields.some((field) => field.name === 'metaType') ||\n fields.some((field) => field.name === 'metaId')\n ) {\n features.add('SmrtPolymorphicAssociation');\n }\n if (\n Object.keys(object.schema?.columns ?? {}).some(\n (name) => object.schema?.columns[name]?.type === 'UUID',\n )\n ) {\n features.add('uuidColumns');\n }\n return [...features].sort();\n}\n\nfunction summarizeRelationships(\n objects: DomainKnowledgeObject[],\n manifestObjects: SmartObjectDefinition[],\n) {\n const fields = objects.flatMap((object) => object.fields);\n return {\n foreignKeyFields: fields.filter((field) => field.type === 'foreignKey')\n .length,\n crossPackageRefFields: fields.filter(\n (field) => field.type === 'crossPackageRef',\n ).length,\n junctionCollections: objects.filter((object) =>\n object.relationshipFeatures.includes('SmrtJunction'),\n ).length,\n hierarchicalObjects: objects.filter((object) =>\n object.relationshipFeatures.includes('SmrtHierarchical'),\n ).length,\n polymorphicAssociations: objects.filter((object) =>\n object.relationshipFeatures.includes('SmrtPolymorphicAssociation'),\n ).length,\n uuidColumns: manifestObjects.reduce(\n (count, object) =>\n count +\n Object.values(object.schema?.columns ?? {}).filter(\n (column) => column.type === 'UUID',\n ).length,\n 0,\n ),\n };\n}\n\nfunction columnType(\n object: SmartObjectDefinition,\n fieldName: string,\n): string | undefined {\n const columnName = camelToSnake(fieldName);\n return object.schema?.columns[columnName]?.type;\n}\n\nfunction readPrompts(\n rootDir: string,\n): Array<{ filePath: string; key?: string }> {\n const srcDir = join(rootDir, 'src');\n if (!existsSync(srcDir)) return [];\n const prompts: Array<{ filePath: string; key?: string }> = [];\n for (const filePath of walkFiles(srcDir)) {\n if (!filePath.endsWith('.ts')) continue;\n const content = readFileSync(filePath, 'utf8');\n if (!content.includes('definePrompt')) continue;\n const keyMatch = content.match(/definePrompt\\s*\\(\\s*['\"`]([^'\"`]+)['\"`]/);\n prompts.push({\n filePath: relative(rootDir, filePath),\n key: keyMatch?.[1],\n });\n }\n return prompts;\n}\n\nfunction walkFiles(dir: string): string[] {\n const files: string[] = [];\n for (const entry of readdirSync(dir, { withFileTypes: true })) {\n if (\n entry.name === 'node_modules' ||\n entry.name === 'dist' ||\n entry.name === '.svelte-kit'\n ) {\n continue;\n }\n const fullPath = join(dir, entry.name);\n if (entry.isDirectory()) {\n files.push(...walkFiles(fullPath));\n } else if (entry.isFile()) {\n files.push(fullPath);\n }\n }\n return files;\n}\n\nfunction sourceHashes(sources: Record<string, HashSource | undefined>) {\n const hashes: Record<string, string> = {};\n for (const [name, source] of Object.entries(sources)) {\n if (!source) continue;\n const content =\n 'content' in source ? source.content : readFileSync(source.path, 'utf8');\n hashes[name] = createHash('sha256').update(content).digest('hex');\n }\n return hashes;\n}\n\ntype HashSource = { content: string } | { path: string };\n\nfunction fileHashSource(path: string | undefined): HashSource | undefined {\n return path ? { path } : undefined;\n}\n\nfunction existingPath(rootDir: string, path: string): string | undefined {\n const fullPath = join(rootDir, path);\n return existsSync(fullPath) ? fullPath : undefined;\n}\n\nfunction readPackageJson(rootDir: string): PackageJsonLike | null {\n const path = join(rootDir, 'package.json');\n if (!existsSync(path)) return null;\n return JSON.parse(readFileSync(path, 'utf8'));\n}\n\nfunction record(value: unknown): Record<string, string> {\n return typeof value === 'object' && value !== null && !Array.isArray(value)\n ? (value as Record<string, string>)\n : {};\n}\n\nfunction exportKeys(exportsField: unknown): string[] {\n if (typeof exportsField === 'string') return ['.'];\n if (\n typeof exportsField !== 'object' ||\n exportsField === null ||\n Array.isArray(exportsField)\n ) {\n return [];\n }\n return Object.keys(exportsField).sort();\n}\n\nfunction camelToSnake(value: string): string {\n return value\n .replace(/([a-z0-9])([A-Z])/g, '$1_$2')\n .replace(/[-\\s]+/g, '_')\n .toLowerCase();\n}\n\nfunction normalizeManifestForHash(manifest: SmartObjectManifest): unknown {\n const normalized = JSON.parse(JSON.stringify(manifest)) as Record<\n string,\n unknown\n >;\n delete normalized.timestamp;\n return normalized;\n}\n\nfunction stableJson(value: unknown): string {\n return JSON.stringify(sortJson(value), null, 2);\n}\n\nfunction sortJson(value: unknown): unknown {\n if (Array.isArray(value)) return value.map(sortJson);\n if (value && typeof value === 'object') {\n return Object.fromEntries(\n Object.entries(value as Record<string, unknown>)\n .sort(([a], [b]) => a.localeCompare(b))\n .map(([key, entry]) => [key, sortJson(entry)]),\n );\n }\n return value;\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"knowledge.js","names":[],"sources":["../src/knowledge.ts"],"sourcesContent":["export {\n discoverScopedPackageDirectories,\n readPackageAgentDoc,\n type ScopedPackageDirectory,\n} from './knowledge-discovery.js';\n\nimport { createHash } from 'node:crypto';\nimport { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';\nimport { basename, join, relative, resolve, sep } from 'node:path';\nimport type {\n DomainKnowledgeAgentSurface,\n DomainKnowledgeConfig,\n DomainKnowledgeField,\n DomainKnowledgeFieldConstraints,\n DomainKnowledgeManifest,\n DomainKnowledgeMethodSignature,\n DomainKnowledgeModuleDoc,\n DomainKnowledgeObject,\n DomainKnowledgeSurface,\n DomainKnowledgeTenant,\n} from '@happyvertical/smrt-types';\nimport {\n CRUD_OPERATIONS,\n isCrudOperation,\n isCrudToolAction,\n isFrameworkLifecycleMethod,\n resolveCustomActionMetadata,\n} from './generators/custom-action.js';\nimport { isFrameworkBaseClass } from './registry/framework-base-classes.js';\nimport type {\n SmartObjectDefinition,\n SmartObjectManifest,\n} from './scanner/types.js';\nimport { toSnakeCase } from './utils/naming.js';\n\n/**\n * Minimal package.json shape consumed by the knowledge builder.\n * `name`/`version` are typed concretely because they flow into the manifest's\n * string-typed metadata fields; everything else is read via `unknown`-accepting\n * helpers (`record()`, `exportKeys()`), so an index signature is sufficient.\n */\nexport interface PackageJsonLike {\n name?: string;\n version?: string;\n [key: string]: unknown;\n}\n\nexport interface BuildDomainKnowledgeOptions {\n manifest: SmartObjectManifest;\n rootDir: string;\n packageJson?: PackageJsonLike;\n manifestPath?: string;\n config?: DomainKnowledgeConfig;\n /**\n * The package's declared view intents and playbooks (#2591), produced by the\n * scanner's agent-surface matcher.\n *\n * Passed in rather than scanned here for one reason: the scanner carries a\n * native parser binary, and `smrt-core`'s main entry is browser-reachable.\n * The Vite plugin already imports the scanner lazily on the Node side and is\n * the one caller that writes this artifact, so it does the scan and hands the\n * result over.\n */\n agentSurface?: DomainKnowledgeAgentSurface;\n}\n\nconst SDK_PACKAGE_NAMES = new Set([\n '@happyvertical/ai',\n '@happyvertical/cache',\n '@happyvertical/documents',\n '@happyvertical/email',\n '@happyvertical/encryption',\n '@happyvertical/files',\n '@happyvertical/geo',\n '@happyvertical/images',\n '@happyvertical/jobs',\n '@happyvertical/json',\n '@happyvertical/logger',\n '@happyvertical/messages',\n '@happyvertical/ocr',\n '@happyvertical/pdf',\n '@happyvertical/projects',\n '@happyvertical/repos',\n '@happyvertical/secrets',\n '@happyvertical/spider',\n '@happyvertical/sql',\n '@happyvertical/utils',\n]);\n\nconst RELATIONSHIP_FIELD_TYPES = new Set([\n 'foreignKey',\n 'crossPackageRef',\n 'oneToMany',\n 'manyToMany',\n]);\n\n/**\n * The generated CRUD verbs, derived from the generators' own list so both\n * halves of this projection — which operations are ENUMERATED\n * (`resolveCrudOperations`) and which method names are RESERVED\n * (`reservesCrudName`) — move together. Reading one from `CRUD_OPERATIONS` and\n * the other from a local copy would let a new verb be suppressed as a custom\n * method while never being added as CRUD, dropping the surface entirely.\n */\nconst STANDARD_OPERATIONS: readonly string[] = CRUD_OPERATIONS;\n\n/**\n * Markdown inline links whose target is a `.md` file — `[label](agents/x.md)`,\n * tolerating an `#anchor` and a `\"title\"`. This is how a package registers a\n * sibling module doc (#2108): the link in `AGENTS.md` IS the registration, so\n * there is no separate index to drift out of sync.\n */\nconst MARKDOWN_MD_LINK =\n /\\[[^\\]]*\\]\\(\\s*([^)\\s#]+\\.md)(?:#[^)\\s]*)?(?:\\s+\"[^\"]*\")?\\s*\\)/g;\n\n/** `sourceHashes` key prefix for a linked module doc, e.g. `moduleDoc:agents/crm.md`. */\nexport const MODULE_DOC_HASH_PREFIX = 'moduleDoc:';\n\n/**\n * `sourceHashes` key prefix for a module declaring a view intent or playbook,\n * e.g. `agentSurface:src/lib/orders.intents.ts` (#2591).\n */\nexport const AGENT_SURFACE_HASH_PREFIX = 'agentSurface:';\n\n/**\n * Module doc paths linked from a package's `AGENTS.md`, relative to the package\n * root and in document order.\n *\n * Instruction chains are additive (see `scripts/check-agents-chain.mjs`), so an\n * oversized package doc is split into `packages/<pkg>/agents/<module>.md` siblings\n * instead of nested `AGENTS.md` files. Only links resolving to an existing file\n * INSIDE the package are accepted — a cross-package reference such as\n * `packages/affiliates/MIGRATION.md` belongs to that package's own chain and is\n * ignored here.\n */\nexport function resolveAgentModuleDocPaths(\n rootDir: string,\n agentDoc: string | undefined,\n): string[] {\n if (!agentDoc) return [];\n const root = resolve(rootDir);\n const paths: string[] = [];\n for (const match of agentDoc.matchAll(MARKDOWN_MD_LINK)) {\n const target = match[1];\n if (target.includes('://')) continue;\n const absolute = resolve(root, target);\n if (absolute !== root && !absolute.startsWith(root + sep)) continue;\n const relativePath = relative(root, absolute).split(sep).join('/');\n if (relativePath === 'AGENTS.md' || relativePath === 'CLAUDE.md') continue;\n if (paths.includes(relativePath)) continue;\n if (!existsSync(absolute) || !statSync(absolute).isFile()) continue;\n paths.push(relativePath);\n }\n return paths;\n}\n\n/** {@link resolveAgentModuleDocPaths}, with each doc's contents read. */\nexport function readAgentModuleDocs(\n rootDir: string,\n agentDoc: string | undefined,\n): DomainKnowledgeModuleDoc[] {\n return resolveAgentModuleDocPaths(rootDir, agentDoc).map((path) => ({\n path,\n module: basename(path, '.md'),\n content: readFileSync(join(rootDir, path), 'utf8'),\n }));\n}\n\nexport function buildDomainKnowledgeManifest(\n options: BuildDomainKnowledgeOptions,\n): DomainKnowledgeManifest {\n const rootDir = options.rootDir;\n const packageJson = options.packageJson ?? readPackageJson(rootDir) ?? {};\n const packageName = options.manifest.packageName ?? packageJson.name;\n const packageVersion = options.manifest.packageVersion ?? packageJson.version;\n const agentDocPath = existingPath(rootDir, 'AGENTS.md');\n const agentDocContent = agentDocPath\n ? readFileSync(agentDocPath, 'utf8')\n : undefined;\n const includeDocs = options.config?.includeDocs !== false;\n const agentDoc = includeDocs ? agentDocContent : undefined;\n // Module doc PATHS are always resolved so their hashes gate freshness even\n // when doc bodies are excluded from the artifact — same stance as `agents`.\n const moduleDocPaths = resolveAgentModuleDocPaths(rootDir, agentDocContent);\n const allDependencies = {\n ...record(packageJson.dependencies),\n ...record(packageJson.devDependencies),\n ...record(packageJson.peerDependencies),\n };\n const manifestObjects = Object.values(options.manifest.objects).filter(\n (object) => object.decoratorConfig?.knowledge !== false,\n );\n const objects = manifestObjects.map((object) =>\n buildKnowledgeObject(object, options.manifest),\n );\n const surfaces = objects.flatMap((object) => object.surfaces);\n const manifestJson = stableJson(normalizeManifestForHash(options.manifest));\n const agentSurface = normalizeAgentSurface(options.agentSurface);\n\n return {\n schemaVersion: 1,\n sensitiveFieldsExcluded: true,\n generatedAt: new Date().toISOString(),\n packageName,\n packageVersion,\n sourceManifestPath: options.manifestPath\n ? relative(rootDir, options.manifestPath)\n : undefined,\n agentDocPath: agentDocPath ? relative(rootDir, agentDocPath) : undefined,\n sourceHashes: sourceHashes({\n manifest: { content: manifestJson },\n packageJson: fileHashSource(existingPath(rootDir, 'package.json')),\n agents: fileHashSource(agentDocPath),\n ...Object.fromEntries(\n moduleDocPaths.map((path) => [\n `${MODULE_DOC_HASH_PREFIX}${path}`,\n fileHashSource(join(rootDir, path)),\n ]),\n ),\n // A module declaring an intent or a playbook is an authored source of\n // this artifact exactly like `AGENTS.md` is, so editing one must mark the\n // artifact stale (#2591).\n ...Object.fromEntries(\n agentSurfaceSourcePaths(agentSurface).map((path) => [\n `${AGENT_SURFACE_HASH_PREFIX}${path}`,\n fileHashSource(join(rootDir, path)),\n ]),\n ),\n }),\n exports: exportKeys(packageJson.exports),\n dependencies: allDependencies,\n smrtDependencies: Object.keys(allDependencies)\n .filter((dep) => dep.startsWith('@happyvertical/smrt-'))\n .sort(),\n sdkDependencies: Object.keys(allDependencies)\n .filter((dep) => SDK_PACKAGE_NAMES.has(dep))\n .sort(),\n tags: options.config?.tags ?? [],\n summary: options.config?.summary,\n risks: options.config?.risks ?? [],\n objects,\n surfaces,\n prompts:\n options.config?.includePrompts === false ? [] : readPrompts(rootDir),\n relationshipsV2: summarizeRelationships(objects, manifestObjects),\n agentDoc,\n moduleDocs:\n includeDocs && moduleDocPaths.length > 0\n ? readAgentModuleDocs(rootDir, agentDocContent)\n : undefined,\n agentSurface,\n };\n}\n\n/**\n * Drop an agent surface that carries nothing.\n *\n * Keeping the key absent for a package that declares no intent, no playbook,\n * and no diagnostic is what makes this field additive in practice: every\n * checked-in artifact for such a package stays byte-identical to what it\n * emitted before the field existed, so adding emission does not churn the\n * repository's knowledge artifacts.\n */\nfunction normalizeAgentSurface(\n surface: DomainKnowledgeAgentSurface | undefined,\n): DomainKnowledgeAgentSurface | undefined {\n if (!surface) return undefined;\n const empty =\n surface.intents.length === 0 &&\n surface.playbooks.length === 0 &&\n surface.diagnostics.length === 0;\n return empty ? undefined : surface;\n}\n\n/** Every package-relative module that contributed to the emitted surface. */\nfunction agentSurfaceSourcePaths(\n surface: DomainKnowledgeAgentSurface | undefined,\n): string[] {\n if (!surface) return [];\n const paths = new Set<string>();\n for (const intent of surface.intents) paths.add(intent.sourceFile);\n for (const playbook of surface.playbooks) paths.add(playbook.sourceFile);\n for (const diagnostic of surface.diagnostics)\n paths.add(diagnostic.sourceFile);\n return [...paths].sort();\n}\n\nfunction buildKnowledgeObject(\n object: SmartObjectDefinition,\n manifest: SmartObjectManifest,\n): DomainKnowledgeObject {\n const knowledge =\n typeof object.decoratorConfig?.knowledge === 'object'\n ? object.decoratorConfig.knowledge\n : {};\n const fields = Object.entries(object.fields)\n .filter(([, field]) => !isSensitiveField(field))\n .map(([name, field]): DomainKnowledgeField => {\n const defaultValue = fieldValue(field, 'default');\n return {\n name,\n type: field.type,\n required: field.required,\n related: field.related,\n columnType: columnType(object, name),\n ...(defaultValue.present ? { default: defaultValue.value } : {}),\n constraints: fieldConstraints(field),\n readonly:\n field.readonly === true || field._meta?.readonly === true\n ? true\n : undefined,\n transient:\n field.transient === true || field._meta?.transient === true\n ? true\n : undefined,\n };\n });\n const sensitiveIdentifiers = sensitiveFieldIdentifiers(object.fields);\n const tenant = sanitizeTenantFacts(\n tenantFacts(object.decoratorConfig?.tenantScoped),\n sensitiveIdentifiers,\n );\n const conflictColumns = object.decoratorConfig?.conflictColumns?.filter(\n (column) => !sensitiveIdentifiers.has(column),\n );\n const relationships = fields\n .filter((field) => RELATIONSHIP_FIELD_TYPES.has(field.type))\n .map((field) => ({\n name: field.name,\n type: field.type,\n required: field.required,\n related: field.related,\n columnType: field.columnType,\n }));\n\n return {\n name: object.className,\n qualifiedName: object.qualifiedName,\n collection: object.collection,\n tableName: object.schema?.tableName,\n packageName: object.packageName,\n extends: object.extends,\n visibility: object.visibility,\n fields,\n relationships,\n methods: Object.keys(object.methods).sort(),\n methodSignatures: methodSignatures(object),\n tenant,\n tableStrategy: object.decoratorConfig?.tableStrategy,\n conflictColumns:\n conflictColumns && conflictColumns.length > 0\n ? conflictColumns\n : undefined,\n surfaces: objectSurfaces(object, manifest),\n relationshipFeatures: relationshipFeatures(object, fields),\n tags: knowledge.tags ?? [],\n summary: knowledge.summary,\n risks: knowledge.risks ?? [],\n };\n}\n\nfunction isSensitiveField(field: SmartObjectDefinition['fields'][string]) {\n return field.sensitive === true || field._meta?.sensitive === true;\n}\n\nfunction sensitiveFieldIdentifiers(\n fields: SmartObjectDefinition['fields'],\n): Set<string> {\n return new Set(\n Object.entries(fields)\n .filter(([, field]) => isSensitiveField(field))\n .flatMap(([name]) => [name, toSnakeCase(name), camelToSnake(name)]),\n );\n}\n\nfunction fieldValue(\n field: SmartObjectDefinition['fields'][string],\n key: 'default' | 'min' | 'max' | 'minLength' | 'maxLength',\n): { present: boolean; value: unknown } {\n if (Object.hasOwn(field, key)) {\n return { present: field[key] !== undefined, value: field[key] };\n }\n const value = field._meta?.[key];\n return { present: value !== undefined, value };\n}\n\nfunction fieldConstraints(\n field: SmartObjectDefinition['fields'][string],\n): DomainKnowledgeFieldConstraints | undefined {\n const constraints: DomainKnowledgeFieldConstraints = {};\n for (const key of ['min', 'max', 'minLength', 'maxLength'] as const) {\n const value = fieldValue(field, key);\n if (value.present && typeof value.value === 'number') {\n constraints[key] = value.value;\n }\n }\n const pattern = normalizePattern(\n (field as { pattern?: unknown }).pattern ?? field._meta?.pattern,\n );\n if (pattern !== undefined) constraints.pattern = pattern;\n return Object.keys(constraints).length > 0 ? constraints : undefined;\n}\n\nfunction normalizePattern(pattern: unknown): string | undefined {\n if (typeof pattern === 'string') return pattern;\n if (pattern instanceof RegExp) return pattern.source;\n if (\n pattern &&\n typeof pattern === 'object' &&\n typeof (pattern as { source?: unknown }).source === 'string'\n ) {\n return (pattern as { source: string }).source;\n }\n return undefined;\n}\n\nfunction tenantFacts(\n tenantScoped: SmartObjectDefinition['decoratorConfig']['tenantScoped'],\n): DomainKnowledgeTenant | undefined {\n if (!tenantScoped) return undefined;\n if (tenantScoped === true) {\n return { scoped: true, mode: 'required', field: 'tenantId' };\n }\n return {\n scoped: true,\n mode: tenantScoped.mode ?? 'required',\n field: tenantScoped.field ?? 'tenantId',\n };\n}\n\nfunction sanitizeTenantFacts(\n tenant: DomainKnowledgeTenant | undefined,\n sensitiveIdentifiers: Set<string>,\n): DomainKnowledgeTenant | undefined {\n if (!tenant?.field || !sensitiveIdentifiers.has(tenant.field)) return tenant;\n return { scoped: tenant.scoped, mode: tenant.mode };\n}\n\nfunction methodSignatures(\n object: SmartObjectDefinition,\n): DomainKnowledgeMethodSignature[] | undefined {\n const signatures = Object.values(object.methods)\n .sort((a, b) => a.name.localeCompare(b.name))\n .map((method) => ({\n name: method.name,\n async: method.async || undefined,\n static: method.isStatic || undefined,\n params:\n method.parameters.length > 0\n ? method.parameters.map(\n (parameter) =>\n `${parameter.name}${parameter.optional ? '?' : ''}: ${parameter.type}`,\n )\n : undefined,\n returns: method.returnType || undefined,\n }));\n return signatures.length > 0 ? signatures : undefined;\n}\n\nfunction objectSurfaces(\n object: SmartObjectDefinition,\n manifest: SmartObjectManifest,\n): DomainKnowledgeSurface[] {\n return [\n ...configuredSurfaces('api', object, manifest),\n ...configuredSurfaces('cli', object, manifest),\n ...configuredSurfaces('mcp', object, manifest),\n ...aiSurfaces(object),\n ];\n}\n\nfunction configuredSurfaces(\n kind: 'api' | 'cli' | 'mcp',\n object: SmartObjectDefinition,\n manifest: SmartObjectManifest,\n): DomainKnowledgeSurface[] {\n const config = object.decoratorConfig?.[kind];\n // NOTE: the `cli` projection models core's `CLIGenerator`, which reserves a\n // CRUD verb unconditionally. That is NOT the shipped local CLI:\n // `@happyvertical/smrt-cli`'s generator reserves one only where the CRUD\n // command is emitted (each of its commands carries its own handler), so with\n // `cli: { include: ['list', 'get'] }` a public `create()` is a reachable\n // `${object}:create` there that this projection does not report.\n //\n // Retargeting this projection at the shipped binary is tracked on #2664.\n // That is a CONTRACT CHANGE rather than a cleanup: the generators genuinely\n // disagree, so `smrt-knowledge.json` snapshots would move. Predates #2646.\n const collectionClass = isSurfaceCollectionClass(manifest, object);\n const operations = configuredOperations(kind, object, config, manifest);\n return operations.map((operation) => {\n const route =\n kind === 'api' && !STANDARD_OPERATIONS.includes(operation)\n ? apiCustomRoute(object, operation, collectionClass)\n : undefined;\n return {\n kind,\n name: surfaceName(kind, object, operation),\n operation,\n objectName: object.qualifiedName ?? object.className,\n path: kind === 'api' ? apiPath(object, operation, route) : undefined,\n method: kind === 'api' ? apiMethod(operation, route) : undefined,\n };\n });\n}\n\n/**\n * `MCPGenerator.buildCustomActionTool()` registers a custom-action tool as\n * `` `${lowerName}_${methodName}`.toLowerCase() `` — lowercasing the WHOLE\n * joined string, not just the object-name prefix. A CRUD verb is already\n * lowercase so this is a no-op there, but a camelCase custom method name\n * (`findByDimensions`) would otherwise report a surface `name` the real tool\n * is never registered under. `CLIGenerator.listCommands()` does not\n * lowercase the method half of its command string, so `cli` keeps the\n * operation as-authored.\n *\n * Note the shapes differ from the transports' own: a `cli` surface `name`\n * here is `object_operation`, while the command a user types is\n * `object:operation`. `operation` is the field to correlate on.\n */\nfunction surfaceName(\n kind: 'api' | 'cli' | 'mcp',\n object: SmartObjectDefinition,\n operation: string,\n): string {\n if (kind === 'api') return `${object.collection}.${operation}`;\n const name = `${object.className.toLowerCase()}_${operation}`;\n return kind === 'mcp' ? name.toLowerCase() : name;\n}\n\n/**\n * A hand-written `SmrtCollection` subclass (`class WidgetCollection extends\n * SmrtCollection<Widget>`) is discovered structurally by the scanner and\n * lands in the manifest even without its own `@smrt()` decorator, so it never\n * registers with `ObjectRegistry`. `MCPGenerator`/`CLIGenerator` iterate\n * `ObjectRegistry`, not the manifest, so such a class never gets its own\n * MCP tools or CLI commands — only its collection-scoped custom actions get\n * REST routes. Reporting full CRUD for it here would over-report a surface\n * that does not exist, trading the #2619 under-report for a new false\n * positive.\n *\n * A deeper subclass (`SpecialCollection extends WidgetCollection`) carries no\n * `extendsTypeArg` of its own, so this walks the extends chain through the\n * manifest — mirroring `isCollectionManifestClass` in\n * `vite-plugin/web-collections.ts` (kept as a separate, lean implementation\n * here rather than imported: that module pulls in the full SvelteKit route\n * generator transitively, which would balloon the standalone `./knowledge`\n * build entry for a ~15-line check).\n */\nfunction isSurfaceCollectionClass(\n manifest: SmartObjectManifest,\n object: SmartObjectDefinition,\n seen: Set<string> = new Set(),\n): boolean {\n // Truthy check (not `!== undefined`) mirrors the scanner: a non-generic\n // base emitting `extendsTypeArg: null` must not be misread as a collection.\n if (object.extends === 'SmrtCollection' || object.extendsTypeArg) {\n return true;\n }\n const parentName = object.extendsQualified || object.extends;\n if (!parentName || seen.has(parentName)) return false;\n seen.add(parentName);\n const parent = findManifestObjectByName(manifest, parentName, object);\n return parent ? isSurfaceCollectionClass(manifest, parent, seen) : false;\n}\n\nfunction findManifestObjectByName(\n manifest: SmartObjectManifest,\n name: string,\n owner: SmartObjectDefinition,\n): SmartObjectDefinition | undefined {\n const entries = Object.entries(manifest.objects);\n if (name.includes(':')) {\n const exact = entries.find(\n ([key, candidate]) => (candidate.qualifiedName ?? key) === name,\n );\n if (exact) return exact[1];\n }\n // Prefer a same-package parent before falling back to a bare simple name:\n // an aggregated manifest can carry several classes sharing one simple name,\n // and resolving the wrong one misclassifies the collection-class carve-out.\n const ownerKey = entries.find(([, candidate]) => candidate === owner)?.[0];\n const ownerPackage = manifestObjectPackage(owner, ownerKey);\n if (ownerPackage) {\n const packageLocal = entries.find(\n ([key, candidate]) =>\n manifestObjectPackage(candidate, key) === ownerPackage &&\n candidate.className === name,\n );\n if (packageLocal) return packageLocal[1];\n }\n return entries.find(([, candidate]) => candidate.className === name)?.[1];\n}\n\n/**\n * An object's owning package. `packageName` is optional on\n * `SmartObjectDefinition` (older manifests and hand-built fixtures omit it),\n * so fall back to the package half of the qualified name — and, when that is\n * absent too, of the manifest key, which is qualified for every entry the\n * scanner writes. Mirrors `manifestObjectPackage` in\n * `vite-plugin/web-collections.ts`, key fallback included: without it an\n * entry carrying only a qualified key resolves no package at all, the\n * same-package preference is skipped, and a duplicate simple name can pick\n * the wrong parent.\n */\nfunction manifestObjectPackage(\n object: SmartObjectDefinition,\n manifestKey?: string,\n): string | undefined {\n if (object.packageName) return object.packageName;\n const qualifiedName = object.qualifiedName ?? manifestKey;\n const separator = qualifiedName?.lastIndexOf(':') ?? -1;\n return separator > 0 ? qualifiedName?.slice(0, separator) : undefined;\n}\n\n/**\n * Operations exposed for one object's `api`/`cli`/`mcp` surface, derived from\n * the same defaults `APIGenerator`/`CLIGenerator`/`MCPGenerator` apply rather\n * than from the presence of a config key (#2619): an omitted config is full\n * CRUD, not a closed surface — an `include` list, when present, is the\n * COMPLETE allowlist for custom methods too; without one, every public\n * method not explicitly excluded is exposed by default. Only `config ===\n * false` closes the surface entirely.\n *\n * Custom (non-CRUD, public) method gating is NOT identical across the three\n * kinds. `CLIGenerator.listCommands()`/`assertCommandExposed()` and\n * `MCPGenerator.generateTools()` both refuse a framework lifecycle method\n * (`save`, `initialize`, ...) even when a class declares its own override —\n * it is the mechanism behind generated CRUD, not a distinct action (#2638) —\n * and `resolveCustomMethodNames()` below mirrors that same\n * `isFrameworkLifecycleMethod()` check for `kind === 'cli'` and\n * `kind === 'mcp'` (#2657, #2638). `api` remains ungated on this: the\n * generator did not change in #2650/#2638, and the fix there is a PR #2651\n * recommendation, not yet implemented.\n *\n * `resolveCustomMethodNames()` also mirrors two more `mcp`-only behaviors\n * that follow from its case-folded tool-id namespace (#2638): an `exclude`\n * entry is compared case-insensitively (matching `MCPGenerator`'s own\n * asymmetry fix -- `exclude` used to fail open on a cased entry the way\n * `include` never did), and two method names that fold onto the same tool id\n * (e.g. `Refresh`/`refresh`) are reported once, keeping whichever was\n * declared first, mirroring `MCPGenerator`'s per-object dedup. `cli`/`api`\n * keep declared casing in their command/route names, so neither behavior\n * applies to them.\n *\n * This `cli` projection models `CLIGenerator` (`generators/cli.ts`), not the\n * shipped local CLI transport (`@happyvertical/smrt-cli`'s\n * `cli-generator.ts`, the `smrt <object>:<action>` binary): that generator\n * does not gate on `isFrameworkLifecycleMethod()` today, so a locally\n * overridden lifecycle method the artifact now reports as absent can still\n * be invoked there. Retargeting this projection at the shipped binary is a\n * contract change tracked on #2664, not part of this fix.\n */\nfunction configuredOperations(\n kind: 'api' | 'cli' | 'mcp',\n object: SmartObjectDefinition,\n config: unknown,\n manifest: SmartObjectManifest,\n): string[] {\n if (config === false) return [];\n // The framework's own abstract base classes (SmrtObject, SmrtCollection,\n // ...) are scaffolding, not resources: MCPGenerator/CLIGenerator/route\n // generation all skip them by class identity now (#2642), independent of\n // their `decoratorConfig: {}` shape, so this mirrors the same shared\n // check rather than reporting a synthetic surface for them.\n if (isFrameworkBaseClass(object.className, object.packageName)) return [];\n const collectionClass = isSurfaceCollectionClass(manifest, object);\n const crud = collectionClass ? [] : resolveCrudOperations(config);\n const custom = resolveCustomMethodNames(\n Object.entries(object.methods),\n config,\n kind,\n );\n // REST additionally refuses a custom action whose receiver cannot exist —\n // a collection class emits only collection-scoped routes, and a model class\n // warns and skips a collection-scoped non-static method. Reporting one\n // would advertise a route `generateRoutesForObject` never writes.\n const eligible =\n kind === 'api'\n ? custom.filter(\n (operation) =>\n apiCustomRoute(object, operation, collectionClass) !== undefined,\n )\n : custom;\n return [...crud, ...eligible];\n}\n\nfunction resolveCrudOperations(config: unknown): string[] {\n const { include, exclude } = includeExcludeConfig(config);\n const base = include\n ? STANDARD_OPERATIONS.filter((operation) => include.includes(operation))\n : [...STANDARD_OPERATIONS];\n if (!exclude || exclude.length === 0) return base;\n const excluded = new Set(exclude);\n return base.filter((operation) => !excluded.has(operation));\n}\n\nfunction resolveCustomMethodNames(\n methods: Iterable<[string, { isPublic?: boolean }]>,\n config: unknown,\n kind: 'api' | 'cli' | 'mcp',\n): string[] {\n const { include, exclude } = includeExcludeConfig(config);\n const excluded = new Set(exclude ?? []);\n // MCP tool ids are case-folded, so `MCPGenerator` compares `exclude`\n // case-insensitively too (`exclude: ['Refresh']` must suppress a method\n // declared `refresh`, and vice versa, #2638) -- mirror that here for\n // `kind === 'mcp'` only. `cli`/`api` keep the declared casing in their\n // command/route names (same asymmetry `reservesCrudName` documents below),\n // so an exact-match `exclude` stays correct for them.\n const excludedLower =\n kind === 'mcp'\n ? new Set([...excluded].map((entry) => entry.toLowerCase()))\n : undefined;\n // Tool ids already claimed for this object's `mcp` surface, so two\n // distinctly-cased method names (e.g. `Refresh`/`refresh`) that fold onto\n // the same MCP tool id are reported once, not twice -- mirroring\n // `MCPGenerator`'s per-object dedup (first declared wins, #2638). `cli`/\n // `api` need no such set: their command/route names keep declared casing,\n // so two cased method names never collide there.\n const emittedLower = kind === 'mcp' ? new Set<string>() : undefined;\n const names: string[] = [];\n for (const [name, method] of methods) {\n if (reservesCrudName(kind, name)) continue;\n // A framework lifecycle method (save/initialize/...) is never a custom\n // CLI or MCP action, even when a class declares its own override — it is\n // the mechanism behind generated CRUD, not a distinct operation, matching\n // CLIGenerator's and MCPGenerator's own isFrameworkLifecycleMethod() gate\n // (#2657, #2638). `api` is deliberately left alone — see\n // configuredOperations' doc comment above.\n if ((kind === 'cli' || kind === 'mcp') && isFrameworkLifecycleMethod(name))\n continue;\n if (!method.isPublic) continue;\n if (\n excludedLower ? excludedLower.has(name.toLowerCase()) : excluded.has(name)\n )\n continue;\n if (include !== undefined && !include.includes(name)) continue;\n if (emittedLower) {\n const lower = name.toLowerCase();\n if (emittedLower.has(lower)) continue;\n emittedLower.add(lower);\n }\n names.push(name);\n }\n return names;\n}\n\n/**\n * Whether `kind` reserves `name` for its generated CRUD operation, so the\n * method behind it is not reported as a distinct surface.\n *\n * MCP folds case: its tool ids are lowercased whole\n * (`` `${object}_${method}`.toLowerCase() ``), so a method named `List` lands on\n * the `${object}_list` identifier the CRUD tool already owns and\n * `MCPGenerator` emits no separate tool for it (#2646). REST and the CLI keep\n * the declared casing in their route/command names, so only an exact match is\n * reserved there.\n *\n * Reads the emitters' own predicates rather than re-testing the verb list, and\n * `STANDARD_OPERATIONS` derives from `CRUD_OPERATIONS`, so a change to the\n * shared list reaches both halves of this projection together.\n */\nfunction reservesCrudName(kind: 'api' | 'cli' | 'mcp', name: string): boolean {\n return kind === 'mcp' ? isCrudToolAction(name) : isCrudOperation(name);\n}\n\nfunction includeExcludeConfig(config: unknown): {\n include?: string[];\n exclude?: string[];\n} {\n if (typeof config !== 'object' || config === null || Array.isArray(config)) {\n return {};\n }\n // A non-array `include`/`exclude` is treated as unset rather than\n // throwing later on `.includes()` — mirrors the same defensive stance\n // `shouldIncludeInApi` in `vite-plugin/sveltekit-generator.ts` takes for\n // a scanned decorator config that failed to resolve to an array.\n const record = config as { include?: unknown; exclude?: unknown };\n return {\n include: Array.isArray(record.include) ? record.include : undefined,\n exclude: Array.isArray(record.exclude) ? record.exclude : undefined,\n };\n}\n\nfunction aiSurfaces(object: SmartObjectDefinition): DomainKnowledgeSurface[] {\n return (object.tools ?? []).map((tool) => ({\n kind: 'ai',\n name: tool.function.name,\n operation: tool.function.name,\n description: tool.function.description,\n objectName: object.qualifiedName ?? object.className,\n }));\n}\n\n/** Route facts for one custom action, as `generateRoutesForObject` emits it. */\ninterface ApiCustomRoute {\n scope: 'item' | 'collection';\n segments: string[];\n method: string;\n}\n\n/**\n * Resolve a custom (non-CRUD) action's REST route the way the generator does,\n * or `undefined` when no route is emitted for it at all.\n *\n * A custom action's path is NOT `/collection/action`: `generateRoutesForObject`\n * nests an item-scoped action under `[id]`, and an instance method defaults to\n * item scope. Reporting the collection-shaped path for every public instance\n * method would advertise endpoints that do not exist — the exact failure this\n * projection exists to avoid. Scope comes from the shared\n * `resolveCustomActionMetadata`, the same resolver the REST, CLI, MCP, and\n * WebMCP paths use, so a `routes` override cannot drift between them.\n *\n * `kebabRoutes` is a Vite-plugin option rather than manifest data, so an\n * explicit `routes[action].path` is honored but the generator's optional\n * kebab-casing of a derived segment is not visible here.\n */\nfunction apiCustomRoute(\n object: SmartObjectDefinition,\n operation: string,\n collectionClass: boolean,\n): ApiCustomRoute | undefined {\n const method = object.methods[operation];\n const apiConfig = object.decoratorConfig?.api;\n const defaultScope: 'item' | 'collection' =\n collectionClass || method?.isStatic ? 'collection' : 'item';\n const scope = resolveActionScope(operation, method, apiConfig, defaultScope);\n\n // Mirrors the generator's own skips: a collection class emits only\n // collection-scoped routes, and a model class warns and skips a\n // collection-scoped non-static method (no receiver to bind).\n if (collectionClass) {\n if (scope !== 'collection') return undefined;\n } else if (scope === 'collection' && !method?.isStatic) {\n return undefined;\n }\n\n const route = customRouteConfig(apiConfig, operation);\n const overridden =\n typeof route?.path === 'string'\n ? route.path\n .split('/')\n .map((segment) => segment.trim())\n .filter(Boolean)\n : [];\n return {\n scope,\n segments: overridden.length > 0 ? overridden : [operation],\n method: normalizeApiMethod(route?.method),\n };\n}\n\n/**\n * The shared resolver validates as it resolves — a `routes` entry declaring\n * `effect: 'read'` on a PUT/PATCH/DELETE route throws by design. This\n * projection reads untrusted scanned config and must not fail the whole\n * knowledge build for one malformed action (same defensive stance as\n * {@link includeExcludeConfig}), so fall back to the receiver the method\n * itself dictates — which a route-only override cannot change anyway.\n */\nfunction resolveActionScope(\n operation: string,\n method: SmartObjectDefinition['methods'][string] | undefined,\n apiConfig: unknown,\n defaultScope: 'item' | 'collection',\n): 'item' | 'collection' {\n try {\n return resolveCustomActionMetadata({\n actionName: operation,\n method,\n apiConfig,\n defaultScope,\n }).scope;\n } catch {\n return defaultScope;\n }\n}\n\nfunction customRouteConfig(\n apiConfig: unknown,\n operation: string,\n): { path?: unknown; method?: unknown } | undefined {\n if (typeof apiConfig !== 'object' || apiConfig === null) return undefined;\n const routes = (apiConfig as { routes?: unknown }).routes;\n if (typeof routes !== 'object' || routes === null) return undefined;\n const route = (routes as Record<string, unknown>)[operation];\n return typeof route === 'object' && route !== null\n ? (route as { path?: unknown; method?: unknown })\n : undefined;\n}\n\n/** Mirrors `normalizeApiHttpMethod` in `vite-plugin/sveltekit-generator.ts`. */\nfunction normalizeApiMethod(method: unknown): string {\n const normalized =\n typeof method === 'string' ? method.toUpperCase() : undefined;\n switch (normalized) {\n case 'GET':\n case 'POST':\n case 'PUT':\n case 'PATCH':\n case 'DELETE':\n return normalized;\n default:\n return 'POST';\n }\n}\n\n/**\n * The collection segment of a generated REST route.\n *\n * `generateRoutesForObject` builds its route directory from\n * `objectDef.collection` verbatim, and the runtime dispatcher in\n * `generators/rest.ts` matches the URL segment against `info.collection`\n * verbatim, so this reports that and nothing else (#2630).\n *\n * In particular it does NOT read `api.path`, which configures a different\n * surface: `@happyvertical/smrt-agents`' own agent-facing route map derives\n * `api.path ?? tableName.replace(/_/g, '-')`. Honoring it here produced a\n * hybrid — `api.path` over `collection` — that matched neither transport and\n * named endpoints that 404 on both.\n */\nfunction apiCollectionSegment(object: SmartObjectDefinition): string {\n return object.collection;\n}\n\nfunction apiPath(\n object: SmartObjectDefinition,\n operation: string,\n route?: ApiCustomRoute,\n): string {\n const configuredPath = apiCollectionSegment(object);\n if (route) {\n const base =\n route.scope === 'collection'\n ? `/${configuredPath}`\n : `/${configuredPath}/[id]`;\n return `${base}/${route.segments.join('/')}`;\n }\n if (operation === 'list' || operation === 'create') {\n return `/${configuredPath}`;\n }\n if (STANDARD_OPERATIONS.includes(operation)) {\n return `/${configuredPath}/[id]`;\n }\n return `/${configuredPath}/${operation}`;\n}\n\nfunction apiMethod(operation: string, route?: ApiCustomRoute): string {\n if (route) return route.method;\n switch (operation) {\n case 'list':\n case 'get':\n return 'GET';\n case 'create':\n return 'POST';\n case 'update':\n return 'PATCH';\n case 'delete':\n return 'DELETE';\n default:\n return 'POST';\n }\n}\n\nfunction relationshipFeatures(\n object: SmartObjectDefinition,\n fields: DomainKnowledgeField[],\n): string[] {\n const features = new Set<string>();\n for (const field of fields) {\n if (field.type === 'foreignKey') features.add('foreignKey');\n if (field.type === 'crossPackageRef') features.add('crossPackageRef');\n if (field.type === 'oneToMany') features.add('oneToMany');\n if (field.type === 'manyToMany') features.add('manyToMany');\n }\n if (object.extends === 'SmrtJunction') features.add('SmrtJunction');\n if (object.extends === 'SmrtHierarchical') features.add('SmrtHierarchical');\n if (\n object.extends === 'SmrtPolymorphicAssociation' ||\n fields.some((field) => field.name === 'metaType') ||\n fields.some((field) => field.name === 'metaId')\n ) {\n features.add('SmrtPolymorphicAssociation');\n }\n if (\n Object.keys(object.schema?.columns ?? {}).some(\n (name) => object.schema?.columns[name]?.type === 'UUID',\n )\n ) {\n features.add('uuidColumns');\n }\n return [...features].sort();\n}\n\nfunction summarizeRelationships(\n objects: DomainKnowledgeObject[],\n manifestObjects: SmartObjectDefinition[],\n) {\n const fields = objects.flatMap((object) => object.fields);\n return {\n foreignKeyFields: fields.filter((field) => field.type === 'foreignKey')\n .length,\n crossPackageRefFields: fields.filter(\n (field) => field.type === 'crossPackageRef',\n ).length,\n junctionCollections: objects.filter((object) =>\n object.relationshipFeatures.includes('SmrtJunction'),\n ).length,\n hierarchicalObjects: objects.filter((object) =>\n object.relationshipFeatures.includes('SmrtHierarchical'),\n ).length,\n polymorphicAssociations: objects.filter((object) =>\n object.relationshipFeatures.includes('SmrtPolymorphicAssociation'),\n ).length,\n uuidColumns: manifestObjects.reduce(\n (count, object) =>\n count +\n Object.values(object.schema?.columns ?? {}).filter(\n (column) => column.type === 'UUID',\n ).length,\n 0,\n ),\n };\n}\n\nfunction columnType(\n object: SmartObjectDefinition,\n fieldName: string,\n): string | undefined {\n const columnName = camelToSnake(fieldName);\n return object.schema?.columns[columnName]?.type;\n}\n\nfunction readPrompts(\n rootDir: string,\n): Array<{ filePath: string; key?: string }> {\n const srcDir = join(rootDir, 'src');\n if (!existsSync(srcDir)) return [];\n const prompts: Array<{ filePath: string; key?: string }> = [];\n for (const filePath of walkFiles(srcDir)) {\n if (!filePath.endsWith('.ts')) continue;\n const content = readFileSync(filePath, 'utf8');\n if (!content.includes('definePrompt')) continue;\n const keyMatch = content.match(/definePrompt\\s*\\(\\s*['\"`]([^'\"`]+)['\"`]/);\n prompts.push({\n filePath: relative(rootDir, filePath),\n key: keyMatch?.[1],\n });\n }\n return prompts;\n}\n\nfunction walkFiles(dir: string): string[] {\n const files: string[] = [];\n for (const entry of readdirSync(dir, { withFileTypes: true })) {\n if (\n entry.name === 'node_modules' ||\n entry.name === 'dist' ||\n entry.name === '.svelte-kit'\n ) {\n continue;\n }\n const fullPath = join(dir, entry.name);\n if (entry.isDirectory()) {\n files.push(...walkFiles(fullPath));\n } else if (entry.isFile()) {\n files.push(fullPath);\n }\n }\n return files;\n}\n\nfunction sourceHashes(sources: Record<string, HashSource | undefined>) {\n const hashes: Record<string, string> = {};\n for (const [name, source] of Object.entries(sources)) {\n if (!source) continue;\n const content =\n 'content' in source ? source.content : readFileSync(source.path, 'utf8');\n hashes[name] = createHash('sha256').update(content).digest('hex');\n }\n return hashes;\n}\n\ntype HashSource = { content: string } | { path: string };\n\nfunction fileHashSource(path: string | undefined): HashSource | undefined {\n return path ? { path } : undefined;\n}\n\nfunction existingPath(rootDir: string, path: string): string | undefined {\n const fullPath = join(rootDir, path);\n return existsSync(fullPath) ? fullPath : undefined;\n}\n\nfunction readPackageJson(rootDir: string): PackageJsonLike | null {\n const path = join(rootDir, 'package.json');\n if (!existsSync(path)) return null;\n return JSON.parse(readFileSync(path, 'utf8'));\n}\n\nfunction record(value: unknown): Record<string, string> {\n return typeof value === 'object' && value !== null && !Array.isArray(value)\n ? (value as Record<string, string>)\n : {};\n}\n\nfunction exportKeys(exportsField: unknown): string[] {\n if (typeof exportsField === 'string') return ['.'];\n if (\n typeof exportsField !== 'object' ||\n exportsField === null ||\n Array.isArray(exportsField)\n ) {\n return [];\n }\n return Object.keys(exportsField).sort();\n}\n\nfunction camelToSnake(value: string): string {\n return value\n .replace(/([a-z0-9])([A-Z])/g, '$1_$2')\n .replace(/[-\\s]+/g, '_')\n .toLowerCase();\n}\n\nfunction normalizeManifestForHash(manifest: SmartObjectManifest): unknown {\n const normalized = JSON.parse(JSON.stringify(manifest)) as Record<\n string,\n unknown\n >;\n delete normalized.timestamp;\n return normalized;\n}\n\nfunction stableJson(value: unknown): string {\n return JSON.stringify(sortJson(value), null, 2);\n}\n\nfunction sortJson(value: unknown): unknown {\n if (Array.isArray(value)) return value.map(sortJson);\n if (value && typeof value === 'object') {\n return Object.fromEntries(\n Object.entries(value as Record<string, unknown>)\n .sort(([a], [b]) => a.localeCompare(b))\n .map(([key, entry]) => [key, sortJson(entry)]),\n );\n }\n return value;\n}\n"],"mappings":"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"}
@@ -3,7 +3,7 @@ var staticManifest = {
3
3
  "version": "1.0.0",
4
4
  "timestamp": 0,
5
5
  "packageName": "@happyvertical/smrt-core",
6
- "packageVersion": "0.45.1",
6
+ "packageVersion": "0.45.3",
7
7
  "objects": {
8
8
  "@happyvertical/smrt-core:SmrtClass": {
9
9
  "name": "smrtclass",