@happyvertical/smrt-dev-mcp 0.47.2 → 0.49.0

package/dist/tool-catalog-Zl-bcimC.js

@@ -0,0 +1,643 @@
+//#region src/tool-catalog.ts
+var REVIEW_SKILL_NAME = "smrt-code-review";
+var JSON_SCHEMA_2020_12 = "https://json-schema.org/draft/2020-12/schema";
+function compareToolNames(left, right) {
+	return left < right ? -1 : left > right ? 1 : 0;
+}
+/**
+* Stable success/error envelope for development tools. `data` preserves each
+* tool's existing payload exactly; coverage/diagnostics are promoted only when
+* the underlying result actually reports them.
+*/
+var DEV_MCP_OUTPUT_SCHEMA = {
+	$schema: JSON_SCHEMA_2020_12,
+	type: "object",
+	additionalProperties: false,
+	required: [
+		"ok",
+		"coverage",
+		"diagnostics",
+		"data"
+	],
+	properties: {
+		ok: { type: "boolean" },
+		coverage: {
+			type: ["object", "null"],
+			additionalProperties: true
+		},
+		diagnostics: {
+			type: "array",
+			items: {
+				type: "object",
+				additionalProperties: true
+			}
+		},
+		data: {}
+	}
+};
+var KNOWLEDGE_DETAIL_DESCRIPTION = "summary: authored package docs are listed by path to stay inside tool-result budgets. full: embed package docs and matching modules with structural object facts. complete: embed all modules and return full package records.";
+var DATABASE_URL_PROPERTY = {
+	type: "string",
+	description: "Optional dev database URL override (read-only diagnostics); prefer SMRT_DEV_DB_URL or cli.database config"
+};
+var DATABASE_TYPE_PROPERTY = {
+	type: "string",
+	enum: [
+		"sqlite",
+		"postgres",
+		"duckdb"
+	],
+	description: "Optional engine hint for dbUrl or the environment connection (sqlite, postgres, duckdb); inferred from the URL scheme when omitted"
+};
+var PROJECT_PATH_PROPERTY = {
+	type: "string",
+	description: "Project root to boot manifests from (default: the server working directory; ignored by the HTTP host, which boots once)"
+};
+var LIMIT_PROPERTY = {
+	type: "number",
+	description: "Row budget for result lists (default 50, capped at 500)"
+};
+var TOOLS = [
+	{
+		name: "generate-smrt-class",
+		description: "Generate a complete SMRT class with @smrt() decorator",
+		inputSchema: {
+			type: "object",
+			properties: {
+				className: {
+					type: "string",
+					description: "Name of the class (PascalCase)"
+				},
+				properties: {
+					type: "array",
+					description: "Array of property definitions",
+					items: {
+						type: "object",
+						properties: {
+							name: { type: "string" },
+							type: {
+								type: "string",
+								enum: [
+									"text",
+									"integer",
+									"decimal",
+									"boolean",
+									"datetime",
+									"json"
+								]
+							},
+							required: { type: "boolean" },
+							nullable: { type: "boolean" },
+							description: { type: "string" },
+							defaultValue: { oneOf: [
+								{ type: "string" },
+								{ type: "number" },
+								{ type: "boolean" },
+								{ type: "object" },
+								{ type: "null" }
+							] }
+						},
+						required: ["name", "type"]
+					}
+				},
+				baseClass: {
+					type: "string",
+					enum: ["SmrtObject", "SmrtCollection"],
+					default: "SmrtObject"
+				},
+				template: {
+					type: "string",
+					enum: [
+						"basic",
+						"global-catalog",
+						"optional-catalog",
+						"tenant-project-object",
+						"tenant-event-log-object",
+						"cross-package-reference"
+					],
+					default: "basic"
+				},
+				tableName: { type: "string" },
+				conflictColumns: {
+					type: "array",
+					items: { type: "string" }
+				},
+				tenantScoped: { oneOf: [{ type: "boolean" }, {
+					type: "object",
+					properties: {
+						mode: {
+							type: "string",
+							enum: ["required", "optional"]
+						},
+						field: { type: "string" },
+						autoFilter: { type: "boolean" },
+						autoPopulate: { type: "boolean" },
+						allowSuperAdminBypass: { type: "boolean" }
+					}
+				}] },
+				includeTenantIdField: { type: "boolean" },
+				relationships: {
+					type: "array",
+					items: {
+						type: "object",
+						properties: {
+							name: { type: "string" },
+							type: {
+								type: "string",
+								enum: [
+									"foreignKey",
+									"crossPackageRef",
+									"oneToMany",
+									"manyToMany"
+								]
+							},
+							related: { type: "string" },
+							required: { type: "boolean" },
+							nullable: { type: "boolean" },
+							description: { type: "string" },
+							validate: { type: "boolean" },
+							foreignKey: { type: "string" },
+							through: { type: "string" },
+							sourceKey: { type: "string" },
+							targetKey: { type: "string" }
+						},
+						required: [
+							"name",
+							"type",
+							"related"
+						]
+					}
+				},
+				includeCompanionSnippets: {
+					type: "boolean",
+					default: false
+				},
+				includeApiConfig: {
+					type: "boolean",
+					default: true
+				},
+				includeMcpConfig: {
+					type: "boolean",
+					default: true
+				},
+				includeCliConfig: {
+					type: "boolean",
+					default: true
+				}
+			},
+			required: ["className", "properties"]
+		}
+	},
+	{
+		name: "introspect-project",
+		description: "Scan a directory for SMRT objects. Returns a compact summary by default; pass detail: \"full\" for field, schema, and method details.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				directory: {
+					type: "string",
+					description: "Project directory (default: cwd)"
+				},
+				manifestPath: {
+					type: "string",
+					description: "Optional manifest path. Defaults to .smrt/manifest.json, dist/manifest.json, then source scanning."
+				},
+				detail: {
+					type: "string",
+					enum: ["summary", "full"],
+					default: "summary",
+					description: "summary: one compact record per object. full: complete field/schema/method detail (large)."
+				},
+				maxChars: {
+					type: "number",
+					description: "Character budget for the `objects` payload. Objects past the budget are omitted and reported under `truncated`. Project metadata and diagnostics are always returned in full, so the serialized response is somewhat larger than this budget."
+				},
+				cursor: {
+					type: "string",
+					description: "Resume after this className (objects are sorted alphabetically). Pass a previous response's `nextCursor` to read the next page instead of raising maxChars."
+				},
+				limit: {
+					type: "number",
+					description: "Maximum objects per page, applied before the character budget"
+				},
+				includeFields: {
+					type: "boolean",
+					description: "Include field details (detail: \"full\" only)"
+				},
+				includeRelationships: {
+					type: "boolean",
+					description: "Analyze relationships (detail: \"full\" only)"
+				},
+				includeMethods: {
+					type: "boolean",
+					description: "Include public method details (detail: \"full\" only)"
+				}
+			}
+		}
+	},
+	{
+		name: "review-smrt-project",
+		description: "Advisory ecosystem alignment review for downstream SMRT projects",
+		inputSchema: {
+			type: "object",
+			properties: {
+				directory: {
+					type: "string",
+					description: "Project directory (default: cwd)"
+				},
+				rootDir: {
+					type: "string",
+					description: "Compatibility alias for directory"
+				},
+				includeSourceEvidence: {
+					type: "boolean",
+					description: "Include file and line evidence in findings",
+					default: true
+				},
+				maxFindings: {
+					type: "number",
+					description: "Optional maximum number of findings to return"
+				}
+			}
+		}
+	},
+	{
+		name: "reflect-knowledge",
+		description: "Report deterministic SMRT + HappyVertical SDK knowledge coverage and freshness",
+		inputSchema: {
+			type: "object",
+			properties: { rootDir: {
+				type: "string",
+				description: "Project root directory (default: cwd)"
+			} }
+		}
+	},
+	{
+		name: "reflect-domain-knowledge",
+		description: "Report domain-scoped SMRT knowledge artifacts, SDK packages, and freshness",
+		inputSchema: {
+			type: "object",
+			properties: {
+				rootDir: { type: "string" },
+				scope: {
+					type: "string",
+					enum: [
+						"project",
+						"local",
+						"package",
+						"sdk",
+						"installed"
+					],
+					default: "project"
+				},
+				package: { type: "string" }
+			}
+		}
+	},
+	{
+		name: "check-knowledge-freshness",
+		description: "Run deterministic freshness checks for SMRT agent knowledge",
+		inputSchema: {
+			type: "object",
+			properties: {
+				rootDir: { type: "string" },
+				changed: {
+					type: "boolean",
+					description: "Limit stale-pattern checks to changed files"
+				},
+				strict: {
+					type: "boolean",
+					description: "Treat stale-pattern findings as errors"
+				}
+			}
+		}
+	},
+	{
+		name: "build-context",
+		description: "Build model-ready SMRT context. task: \"review\" routes changedFiles/focus to package experts and returns file-anchored findings, package hints, and a prompt bundle; task: \"architecture\" ranks packages by the idea text and returns the bundle plus recommendations. Replaces build-review-context, build-domain-review-context, build-architecture-context, and build-domain-architecture-context.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				task: {
+					type: "string",
+					enum: ["review", "architecture"],
+					description: "review: changed files and focus. architecture: an idea or documentation."
+				},
+				rootDir: { type: "string" },
+				changedFiles: {
+					type: "array",
+					items: { type: "string" },
+					description: "Files to route to package experts (task: review)"
+				},
+				focus: {
+					type: "string",
+					description: "Concern to prioritise"
+				},
+				documentation: {
+					type: "string",
+					description: "Existing docs, notes, or requirements"
+				},
+				idea: {
+					type: "string",
+					description: "Product or implementation idea (task: architecture)"
+				},
+				scope: {
+					type: "string",
+					enum: [
+						"project",
+						"local",
+						"package",
+						"sdk",
+						"installed"
+					],
+					default: "project"
+				},
+				package: {
+					type: "string",
+					description: "Package name or short name to focus"
+				},
+				mode: {
+					type: "string",
+					enum: [
+						"findings",
+						"prompt-bundle",
+						"both"
+					],
+					default: "both",
+					description: "task: review only"
+				},
+				detail: {
+					type: "string",
+					enum: [
+						"summary",
+						"full",
+						"complete"
+					],
+					default: "summary",
+					description: KNOWLEDGE_DETAIL_DESCRIPTION
+				}
+			},
+			required: ["task"]
+		}
+	},
+	{
+		name: "smrt-review",
+		description: "Deprecated compatibility name for build-context with task: \"review\"; removed in the next minor release. For a formal downstream review, first call get-agent-skill with { \"name\": \"smrt-code-review\" }.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				rootDir: { type: "string" },
+				changedFiles: {
+					type: "array",
+					items: { type: "string" }
+				},
+				focus: { type: "string" },
+				documentation: { type: "string" },
+				mode: {
+					type: "string",
+					enum: [
+						"findings",
+						"prompt-bundle",
+						"both"
+					],
+					default: "both"
+				},
+				detail: {
+					type: "string",
+					enum: [
+						"summary",
+						"full",
+						"complete"
+					],
+					default: "summary",
+					description: KNOWLEDGE_DETAIL_DESCRIPTION
+				}
+			}
+		}
+	},
+	{
+		name: "build-package-specialist-context",
+		description: "Build deterministic package specialist context for the SMRT workbench",
+		inputSchema: {
+			type: "object",
+			properties: {
+				rootDir: { type: "string" },
+				package: {
+					type: "string",
+					description: "Package name or short package query, e.g. @happyvertical/smrt-content or content"
+				},
+				focus: { type: "string" }
+			},
+			required: ["package"]
+		}
+	},
+	{
+		name: "smrt-architecture",
+		description: "Deprecated compatibility name for build-context with task: \"architecture\"; removed in the next minor release.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				rootDir: { type: "string" },
+				idea: { type: "string" },
+				documentation: { type: "string" },
+				focus: { type: "string" },
+				detail: {
+					type: "string",
+					enum: [
+						"summary",
+						"full",
+						"complete"
+					],
+					default: "summary",
+					description: KNOWLEDGE_DETAIL_DESCRIPTION
+				}
+			}
+		}
+	},
+	{
+		name: "list-agent-skills",
+		description: "List bundled harness-agnostic agent skills shipped with smrt-dev-mcp",
+		inputSchema: {
+			type: "object",
+			properties: {}
+		}
+	},
+	{
+		name: "get-agent-skill",
+		description: "Return a bundled harness-agnostic agent skill as Markdown plus optional references",
+		inputSchema: {
+			type: "object",
+			properties: {
+				name: {
+					type: "string",
+					enum: [REVIEW_SKILL_NAME],
+					description: "Bundled agent skill name"
+				},
+				includeReferences: {
+					type: "boolean",
+					default: true,
+					description: "Include referenced files with the skill bundle"
+				}
+			},
+			required: ["name"]
+		}
+	},
+	{
+		name: "migration-status",
+		description: "Live migration status from the _smrt_schema_migrations system table (runtime provenance; read-only)",
+		inputSchema: {
+			type: "object",
+			properties: {
+				dbUrl: DATABASE_URL_PROPERTY,
+				dbType: DATABASE_TYPE_PROPERTY,
+				limit: LIMIT_PROPERTY
+			}
+		}
+	},
+	{
+		name: "job-health",
+		description: "Live job queue health from the _smrt_jobs/_smrt_workers system tables (runtime provenance; read-only)",
+		inputSchema: {
+			type: "object",
+			properties: {
+				dbUrl: DATABASE_URL_PROPERTY,
+				dbType: DATABASE_TYPE_PROPERTY,
+				limit: LIMIT_PROPERTY
+			}
+		}
+	},
+	{
+		name: "schedule-health",
+		description: "Live agent schedule health from the _smrt_agent_schedules system table (runtime provenance; read-only; sensitive agentConfig never read)",
+		inputSchema: {
+			type: "object",
+			properties: {
+				dbUrl: DATABASE_URL_PROPERTY,
+				dbType: DATABASE_TYPE_PROPERTY,
+				limit: LIMIT_PROPERTY
+			}
+		}
+	},
+	{
+		name: "dispatch-health",
+		description: "Live dispatch health from the _smrt_dispatch/_smrt_dispatch_subscriptions system tables (runtime provenance; read-only; payloads never read)",
+		inputSchema: {
+			type: "object",
+			properties: {
+				dbUrl: DATABASE_URL_PROPERTY,
+				dbType: DATABASE_TYPE_PROPERTY,
+				limit: LIMIT_PROPERTY
+			}
+		}
+	},
+	{
+		name: "recent-changes",
+		description: "Tail of the _smrt_changes change feed (runtime provenance; read-only; filter by table/tenant)",
+		inputSchema: {
+			type: "object",
+			properties: {
+				dbUrl: DATABASE_URL_PROPERTY,
+				dbType: DATABASE_TYPE_PROPERTY,
+				since: {
+					type: "number",
+					description: "Cursor to read after (default 0)"
+				},
+				tables: {
+					type: "array",
+					items: { type: "string" },
+					description: "Restrict to these physical table names"
+				},
+				tenantId: {
+					type: "string",
+					description: "Tenant narrowing filter"
+				},
+				limit: LIMIT_PROPERTY
+			}
+		}
+	},
+	{
+		name: "registry-drift",
+		description: "Registry drift report; _smrt_registry is retired and reported as such, never queried (read-only)",
+		inputSchema: {
+			type: "object",
+			properties: {
+				dbUrl: DATABASE_URL_PROPERTY,
+				dbType: DATABASE_TYPE_PROPERTY
+			}
+		}
+	},
+	{
+		name: "runtime-registry",
+		description: "Sanitized snapshot of the booted ObjectRegistry from the project and installed manifests (booted provenance; read-only; no project code executed)",
+		inputSchema: {
+			type: "object",
+			properties: {
+				projectPath: PROJECT_PATH_PROPERTY,
+				objects: {
+					type: "array",
+					items: { type: "string" },
+					description: "Restrict field/method detail to these simple or qualified object names"
+				},
+				detail: {
+					type: "boolean",
+					description: "Include field and method detail for every object (default: only when objects is given)"
+				},
+				cursor: {
+					type: "string",
+					description: "Resume after this qualified object name; pass a previous response's `page.nextCursor`"
+				},
+				limit: {
+					type: "number",
+					description: "Objects per page (default 50, capped at 500)"
+				}
+			}
+		}
+	},
+	{
+		name: "runtime-object",
+		description: "One booted object: sanitized fields, methods, tenancy, inheritance, and the DDL the registry would generate (booted provenance; read-only)",
+		inputSchema: {
+			type: "object",
+			properties: {
+				projectPath: PROJECT_PATH_PROPERTY,
+				name: {
+					type: "string",
+					description: "Simple or qualified object name"
+				},
+				engine: {
+					type: "string",
+					enum: [
+						"sqlite",
+						"postgres",
+						"duckdb"
+					],
+					description: "Engine for the DDL preview (default: registry default)"
+				}
+			},
+			required: ["name"]
+		}
+	},
+	{
+		name: "runtime-schema-diff",
+		description: "Booted registry schemas versus the live dev database using the db:diff comparer; introspection only, drops/relaxations never proposed (runtime provenance; read-only)",
+		inputSchema: {
+			type: "object",
+			properties: {
+				projectPath: PROJECT_PATH_PROPERTY,
+				dbUrl: DATABASE_URL_PROPERTY,
+				dbType: DATABASE_TYPE_PROPERTY
+			}
+		}
+	}
+].map((tool) => ({
+	...tool,
+	inputSchema: {
+		...tool.inputSchema,
+		$schema: JSON_SCHEMA_2020_12
+	},
+	outputSchema: DEV_MCP_OUTPUT_SCHEMA
+})).sort((left, right) => compareToolNames(left.name, right.name));
+//#endregion
+export { TOOLS as n, REVIEW_SKILL_NAME as t };
+
+//# sourceMappingURL=tool-catalog-Zl-bcimC.js.map