@happyvertical/smrt-cli 0.51.32 → 0.51.33

package/dist/commands/db-parity.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Live-schema parity reporting for the CLI (#2368)
+ *
+ * Shared by `smrt doctor --db` and `smrt db:status --parity`. Both surfaces
+ * introspect the configured database and compare it to the shape the model
+ * layer assumes — including the hand-DDL `_smrt_*` system tables and an index
+ * policy that does not consult the manifest, since the manifest is the artifact
+ * that dropped the index in the first place (#2356).
+ *
+ * Everything here fails closed: a database that cannot be reached, or an
+ * adapter that cannot describe its tables, is reported as a failure rather
+ * than as "in sync".
+ */
+import { type ConflictTargetInput, type LiveParityFinding, type LiveParitySeverity, type LiveSchemaParityReport } from '@happyvertical/smrt-core';
+/** Options accepted by {@link runLiveSchemaParity}. */
+export interface RunLiveSchemaParityOptions {
+    /** Include `_smrt_*` system tables (default true). */
+    includeSystemTables?: boolean;
+    /**
+     * Load manifests before reading the registry (default true). Callers that
+     * already ran discovery pass false to avoid a second pass.
+     */
+    discover?: boolean;
+}
+/** Result of one CLI-level parity run. */
+export interface LiveSchemaParityOutcome {
+    report: LiveSchemaParityReport | null;
+    /** Human-readable failure reason; non-null exactly when `report` is null. */
+    error: string | null;
+    database: {
+        type: string;
+        url: string;
+    } | null;
+}
+/**
+ * Collect every declared upsert conflict target, keyed by table name.
+ *
+ * The conflict target is a registry property of a persisted object, not a
+ * manifest one: an object may declare `conflictColumns` explicitly, inherit
+ * the CTI `(slug, context)` default, or get the STI
+ * `(slug, context, _meta_type)` triple. Collections share their item table,
+ * but never persist through their own conflict target, so they must not add a
+ * synthetic default target to the parity check. Every collected target needs a
+ * matching UNIQUE index or its object upsert either errors (PostgreSQL) or
+ * duplicates rows.
+ */
+export declare function collectRegistryConflictTargets(): Record<string, ConflictTargetInput[]>;
+/**
+ * Run the parity check against the configured database.
+ *
+ * Never throws for an operational problem: connection and introspection
+ * failures come back as `{ report: null, error }` so both callers can render
+ * them in their own idiom while still failing closed.
+ */
+export declare function runLiveSchemaParity(options?: RunLiveSchemaParityOptions): Promise<LiveSchemaParityOutcome>;
+/** Findings of one severity, ordered by table then target. */
+export declare function selectFindings(report: LiveSchemaParityReport, severity: LiveParitySeverity): LiveParityFinding[];
+/**
+ * Render a parity report as console lines.
+ *
+ * Errors and warnings always print. Informational findings (undeclared tables,
+ * columns and indexes) print only with `verbose`, because on a shared database
+ * they are numerous and expected.
+ */
+export declare function formatParityReport(report: LiveSchemaParityReport, options?: {
+    verbose?: boolean;
+}): string[];
+/** One-line summary used by callers that render their own detail. */
+export declare function summarizeParityReport(report: LiveSchemaParityReport): string;
+//# sourceMappingURL=db-parity.d.ts.map

package/dist/commands/db-parity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-parity.d.ts","sourceRoot":"","sources":["../../src/commands/db-parity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,KAAK,mBAAmB,EAGxB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAE5B,MAAM,0BAA0B,CAAC;AASlC,uDAAuD;AACvD,MAAM,WAAW,0BAA0B;IACzC,sDAAsD;IACtD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,0CAA0C;AAC1C,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACtC,6EAA6E;IAC7E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAChD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,8BAA8B,IAAI,MAAM,CACtD,MAAM,EACN,mBAAmB,EAAE,CACtB,CAkBA;AAsBD;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,uBAAuB,CAAC,CAoDlC;AAQD,8DAA8D;AAC9D,wBAAgB,cAAc,CAC5B,MAAM,EAAE,sBAAsB,EAC9B,QAAQ,EAAE,kBAAkB,GAC3B,iBAAiB,EAAE,CAQrB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,sBAAsB,EAC9B,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,MAAM,EAAE,CAuEV;AAED,qEAAqE;AACrE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAE5E"}

package/dist/commands/db-permissions.d.ts

@@ -0,0 +1,19 @@
+import type { PostgresPermissionPlan } from '@happyvertical/smrt-core';
+import type { CLICommand } from '../cli-generator.js';
+export interface DbPermissionsOptions {
+    json?: boolean;
+    'dry-run'?: boolean;
+    apply?: boolean;
+    'expected-fingerprint'?: string;
+}
+export interface PermissionsOutcome {
+    skipped: boolean;
+    plan: PostgresPermissionPlan | null;
+    error: string | null;
+}
+/** The only mutating caller is the explicit permissions command. */
+export declare function runPostgresPermissions(options?: DbPermissionsOptions, optional?: boolean): Promise<PermissionsOutcome>;
+export declare function formatPermissionsOutcome(outcome: PermissionsOutcome): string[];
+export declare function outputPermissionsOutcome(outcome: PermissionsOutcome, json?: boolean): void;
+export declare const dbPermissionsCommand: CLICommand;
+//# sourceMappingURL=db-permissions.d.ts.map

package/dist/commands/db-permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-permissions.d.ts","sourceRoot":"","sources":["../../src/commands/db-permissions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAKtD,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACpC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,oEAAoE;AACpE,wBAAsB,sBAAsB,CAC1C,OAAO,GAAE,oBAAyB,EAClC,QAAQ,UAAQ,GACf,OAAO,CAAC,kBAAkB,CAAC,CA6E7B;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,kBAAkB,GAC1B,MAAM,EAAE,CAmBV;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,kBAAkB,EAC3B,IAAI,UAAQ,GACX,IAAI,CAIN;AAED,eAAO,MAAM,oBAAoB,EAAE,UA8BlC,CAAC"}

package/dist/commands/db-prune.d.ts

@@ -0,0 +1,70 @@
+/**
+ * db:prune Command — bounded growth for framework-owned tables (#2375).
+ *
+ * The cron entry point for `runRetentionSweep()`: prunes `_smrt_changes`,
+ * `_smrt_ai_usage`, `_smrt_contexts` and `_smrt_dispatch`, plus every task
+ * other packages contribute (job/job-event cleanup from
+ * `@happyvertical/smrt-jobs`, session and token expiry from
+ * `@happyvertical/smrt-users`). Deployments that run a jobs worker already get
+ * the same sweep on an interval; this command is for those that do not, and
+ * for one-off operator runs.
+ *
+ * Defaults come from the framework's documented retention policy and can be
+ * overridden per table on the command line or, persistently, through
+ * `retention` in `smrt.config`. `--dry-run` reports exactly what a real run
+ * would delete, using the same predicates.
+ */
+import type { RetentionPolicy, RetentionSweepResult } from '@happyvertical/smrt-core';
+import type { CLICommand } from '../cli-generator.js';
+/** Parsed CLI options for the `db:prune` command. */
+interface DbPruneOptions {
+    json?: boolean;
+    'dry-run'?: boolean;
+    'changes-days'?: number;
+    'usage-days'?: number;
+    'dispatch-days'?: number;
+    skip?: string;
+}
+/**
+ * Load every installed package that contributes retention tasks.
+ *
+ * A rejected import is always treated as "not installed" — this function
+ * cannot reliably tell a genuine module-resolution miss apart from a package
+ * that resolved but threw during its own top-level evaluation (error shapes
+ * differ across bundlers and runtimes, and `importPackage` is caller-supplied
+ * for exactly that flexibility). It still logs the message on `stderr`
+ * rather than swallowing it outright, so an operator can tell "this project
+ * doesn't depend on jobs/users" apart from "smrt-jobs is installed but broke
+ * on import" without the sweep itself needing to fail over an optional
+ * dependency.
+ *
+ * @returns The specifiers that loaded, in declaration order.
+ */
+export declare function loadRetentionTaskPackages(importPackage: (specifier: string) => Promise<unknown>): Promise<string[]>;
+/**
+ * Merge command-line overrides onto the configured retention policy.
+ *
+ * `--skip` names tasks, not tables, so it covers both the built-in tables and
+ * anything a package registered — the same names `db:prune --json` reports.
+ */
+export declare function buildPrunePolicy(configured: RetentionPolicy | undefined, options: DbPruneOptions): RetentionPolicy;
+/**
+ * Scrub connection-string credentials from per-task failures. The sweep
+ * never throws for a task failure; it stores the driver's error text in
+ * `tasks[].error`, which can echo the DSN, so both output forms render this
+ * redacted copy.
+ */
+export declare function redactSweepResult(result: RetentionSweepResult): RetentionSweepResult;
+/** Render a completed sweep as an operator-readable table. */
+export declare function formatSweepResult(result: RetentionSweepResult): string;
+/**
+ * Names passed to `--skip` that no task in the completed sweep answered to.
+ *
+ * A typo and a package that was never installed look identical on the command
+ * line, so the command says which names it did not recognize rather than
+ * silently doing less than the operator asked for.
+ */
+export declare function unmatchedSkipNames(skip: string | undefined, result: RetentionSweepResult): string[];
+export declare const dbPruneCommand: CLICommand;
+export default dbPruneCommand;
+//# sourceMappingURL=db-prune.d.ts.map

package/dist/commands/db-prune.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-prune.d.ts","sourceRoot":"","sources":["../../src/commands/db-prune.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAOtD,qDAAqD;AACrD,UAAU,cAAc;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAeD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,yBAAyB,CAC7C,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GACrD,OAAO,CAAC,MAAM,EAAE,CAAC,CAenB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,eAAe,GAAG,SAAS,EACvC,OAAO,EAAE,cAAc,GACtB,eAAe,CAkDjB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,oBAAoB,GAC3B,oBAAoB,CAStB;AAED,8DAA8D;AAC9D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAwBtE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,MAAM,EAAE,oBAAoB,GAC3B,MAAM,EAAE,CAMV;AAED,eAAO,MAAM,cAAc,EAAE,UA0H5B,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/commands/db-rollback.d.ts

@@ -0,0 +1,44 @@
+/**
+ * db:rollback Command
+ *
+ * Reverts applied migrations by executing the DOWN script that produced them —
+ * or refuses, loudly and with a non-zero exit, when no DOWN script exists.
+ *
+ * SMRT schema migrations are diff-driven: `db:migrate` derives them from the
+ * manifest at run time and stores no SQL in `_smrt_schema_migrations`, so the
+ * only DOWN this command can honour is the deterministic one `db:migrate`
+ * records for `create_table_<table>` migrations. Everything else is refused
+ * rather than flipped to `rolled_back` with the schema untouched (#2378).
+ * `--mark-only` is the explicit, honestly-labelled opt-in for the record-only
+ * flip that an operator who reverted the schema by hand actually wants.
+ */
+import type { CLICommand } from '../cli-generator.js';
+/** Outcome of trying to reconstruct a migration's DOWN script. */
+export type DownRecovery = {
+    recoverable: true;
+    statements: string[];
+} | {
+    recoverable: false;
+    reason: string;
+};
+/** The fields of a `_smrt_schema_migrations` row this command reasons about. */
+interface RollbackCandidate {
+    name: string;
+    is_reversible: boolean;
+}
+/**
+ * Reconstruct the DOWN script for an applied migration, or explain why it
+ * cannot be reconstructed.
+ *
+ * Recoverable only for `create_table_<table>` rows recorded as reversible: the
+ * DOWN `db:migrate` attached to them is the deterministic
+ * `DROP TABLE IF EXISTS "<table>"`. A row recorded reversible under any other
+ * name came from a caller-supplied `MigrationDefinition` whose SQL was never
+ * persisted, so it is refused rather than guessed at.
+ *
+ * Exported for unit testing.
+ */
+export declare function recoverDownStatements(migration: RollbackCandidate): DownRecovery;
+export declare const dbRollbackCommand: CLICommand;
+export {};
+//# sourceMappingURL=db-rollback.d.ts.map

package/dist/commands/db-rollback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-rollback.d.ts","sourceRoot":"","sources":["../../src/commands/db-rollback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAkEtD,kEAAkE;AAClE,MAAM,MAAM,YAAY,GACpB;IAAE,WAAW,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,GAC3C;IAAE,WAAW,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C,gFAAgF;AAChF,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,iBAAiB,GAC3B,YAAY,CA6Bd;AAQD,eAAO,MAAM,iBAAiB,EAAE,UA+b/B,CAAC"}

package/dist/commands/db-status.d.ts

@@ -0,0 +1,91 @@
+/**
+ * db:status Command
+ *
+ * Shows the current status of database migrations:
+ * - Applied migrations
+ * - Pending migrations
+ * - Drift detection warnings
+ */
+import type { DatabaseInterface } from '@happyvertical/sql';
+import type { CLICommand } from '../cli-generator.js';
+type StatusDrift = {
+    name: string;
+    type: string;
+    recommendation: string;
+};
+type StatusPrecondition = {
+    name: string;
+    status: 'warning' | 'error';
+    message: string;
+    recommendation: string;
+    details?: Record<string, unknown>;
+};
+/** Minimal column shape this command reads (manifest or live db column). */
+type SchemaColumnLike = {
+    name?: string;
+    type?: unknown;
+};
+/**
+ * Minimal schema shape this command reads. Covers both manifest definitions
+ * (`getAllSchemasAsDefinitions()`) and live `getTableSchema()` results, whose
+ * `columns` are keyed records; an array form is tolerated defensively.
+ */
+type SchemaLike = {
+    tableName?: string;
+    columns?: Record<string, SchemaColumnLike> | SchemaColumnLike[];
+};
+export declare function checkTenantIdUuidPreconditions(input: {
+    db: DatabaseInterface;
+    dbType: string;
+    dbUrl: string;
+    manifestSchemas: Record<string, SchemaLike>;
+}): Promise<StatusPrecondition[]>;
+export declare function summarizeSchemaDiff(diff: {
+    added_tables: Array<{
+        tableName: string;
+    }>;
+    changes: Array<{
+        type: string;
+        table: string;
+        name?: string;
+        mismatch?: {
+            expected: string;
+            actual: string;
+        };
+        alteration?: string;
+        foreignKey?: {
+            column: string;
+            referencesTable: string;
+            referencesColumn: string;
+        };
+        advisory?: {
+            severity: 'warning' | 'info';
+            message: string;
+        };
+        sql?: string;
+        sqlStatements?: string[];
+    }>;
+}): StatusDrift[];
+/**
+ * Info-level live-schema notes (#2369): harmless orphan columns, live
+ * defaults the manifest no longer declares, and tables no loaded manifest
+ * declares. Reported separately from `drift` so a JSON consumer counting
+ * drift entries is not tripped by findings that need no action.
+ */
+export declare function summarizeSchemaNotes(diff: {
+    orphan_tables?: string[];
+    changes: Array<{
+        type: string;
+        table: string;
+        name?: string;
+        advisory?: {
+            severity: 'warning' | 'info';
+            message: string;
+        };
+        sql?: string;
+        sqlStatements?: string[];
+    }>;
+}): StatusDrift[];
+export declare const dbStatusCommand: CLICommand;
+export {};
+//# sourceMappingURL=db-status.d.ts.map

package/dist/commands/db-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-status.d.ts","sourceRoot":"","sources":["../../src/commands/db-status.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAwBtD,KAAK,WAAW,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAkCF,4EAA4E;AAC5E,KAAK,gBAAgB,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE1D;;;;GAIG;AACH,KAAK,UAAU,GAAG;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,gBAAgB,EAAE,CAAC;CACjE,CAAC;AA2DF,wBAAsB,8BAA8B,CAAC,KAAK,EAAE;IAC1D,EAAE,EAAE,iBAAiB,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAC7C,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA4DhC;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,YAAY,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3C,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE;YACT,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC;QACF,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE;YACX,MAAM,EAAE,MAAM,CAAC;YACf,eAAe,EAAE,MAAM,CAAC;YACxB,gBAAgB,EAAE,MAAM,CAAC;SAC1B,CAAC;QACF,QAAQ,CAAC,EAAE;YAAE,QAAQ,EAAE,SAAS,GAAG,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7D,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC,CAAC;CACJ,GAAG,WAAW,EAAE,CA0KhB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE;YAAE,QAAQ,EAAE,SAAS,GAAG,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7D,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC,CAAC;CACJ,GAAG,WAAW,EAAE,CAyBhB;AAED,eAAO,MAAM,eAAe,EAAE,UAge7B,CAAC"}

package/dist/commands/dev-knowledge.d.ts

@@ -0,0 +1,10 @@
+/**
+ * dev:knowledge-* commands
+ *
+ * Deterministic SMRT agentic-development knowledge tooling. These commands do
+ * not call model providers; they produce local facts and portable prompt
+ * bundles for Codex, Claude, or another downstream model.
+ */
+import type { CLICommand } from '../cli-generator.js';
+export declare const devKnowledgeCommands: Record<string, CLICommand>;
+//# sourceMappingURL=dev-knowledge.d.ts.map

package/dist/commands/dev-knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-knowledge.d.ts","sourceRoot":"","sources":["../../src/commands/dev-knowledge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAqCtD,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAiN3D,CAAC"}

package/dist/commands/dev-runtime.d.ts

@@ -0,0 +1,14 @@
+import type { CLICommand } from '../cli-generator.js';
+/** Parse repeatable `--arg key=value` flags; numbers/booleans are coerced. */
+export declare function parseToolArgs(raw: string[] | string | undefined): Record<string, unknown>;
+/** Call the in-app plane when a URL is configured; otherwise run locally. */
+export declare function runRuntimeTool(tool: string, args: Record<string, unknown>, options?: {
+    url?: string;
+    token?: string;
+    fetchImpl?: typeof fetch;
+}): Promise<{
+    source: 'dev-plane' | 'local';
+    result: unknown;
+}>;
+export declare const devRuntimeCommands: Record<string, CLICommand>;
+//# sourceMappingURL=dev-runtime.d.ts.map

package/dist/commands/dev-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-runtime.d.ts","sourceRoot":"","sources":["../../src/commands/dev-runtime.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAStD,8EAA8E;AAC9E,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,GACjC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgBzB;AAED,6EAA6E;AAC7E,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAAO,GACvE,OAAO,CAAC;IAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CA+B7D;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAwCzD,CAAC"}

package/dist/commands/dispatch.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Dispatch Commands - CLI tools for inter-agent communication
+ *
+ * Commands for managing the dispatch queue and subscriptions.
+ */
+import type { CLICommand } from '../cli-generator.js';
+/**
+ * Dispatch commands for inter-agent communication
+ */
+export declare const dispatchCommands: Record<string, CLICommand>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/commands/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/commands/dispatch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAiFtD;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAkdvD,CAAC"}

package/dist/commands/docs-claude.d.ts

@@ -0,0 +1,44 @@
+/**
+ * docs:agents / docs:claude commands
+ *
+ * Generates downstream SMRT framework context from installed @happyvertical
+ * packages. AGENTS.md is canonical; docs:claude remains a compatibility alias
+ * that writes to the historical .claude/smrt-framework.md path.
+ */
+import type { DomainKnowledgeModuleDoc } from '@happyvertical/smrt-types';
+import type { CLICommand } from '../cli-generator.js';
+export interface PackageInfo {
+    name: string;
+    version: string;
+    readme: string | null;
+    agentMd?: string | null;
+    /** Backward-compatible alias for older tests/importers. */
+    claudeMd?: string | null;
+    docSource?: 'AGENTS.md' | 'CLAUDE.md' | null;
+    /** Linked module bodies, loaded only for complete snapshots. */
+    moduleDocs?: DomainKnowledgeModuleDoc[];
+    /** Package directory for resolving authored documentation from the snapshot. */
+    directory?: string;
+    /** Module paths without loading their bodies in the default snapshot. */
+    moduleDocPaths?: string[];
+    /**
+     * Installed specifier (`node_modules/<scope>/<entry>`), which differs from
+     * `name` under an `npm:` alias install. Module-doc links use it so they
+     * resolve from the consumer's `node_modules`.
+     */
+    specifier?: string;
+}
+export interface RootDocInfo {
+    filename: string;
+    heading: string;
+    content: string;
+}
+export declare const docsAgentsCommand: CLICommand;
+export declare const docsClaudeCommand: CLICommand;
+export declare function detectMonorepoRoot(): string | null;
+export declare function extractReadmeSections(readme: string, sectionNames: string[]): Record<string, string>;
+export declare function generateMarkdown(packages: PackageInfo[], rootDocs?: RootDocInfo[], sdkPackages?: PackageInfo[], generatedBy?: string, options?: {
+    complete?: boolean;
+}): string;
+export declare const docsCommands: Record<string, CLICommand>;
+//# sourceMappingURL=docs-claude.d.ts.map

package/dist/commands/docs-claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-claude.d.ts","sourceRoot":"","sources":["../../src/commands/docs-claude.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,IAAI,CAAC;IAC7C,gEAAgE;IAChE,UAAU,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACxC,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAuLD,eAAO,MAAM,iBAAiB,EAAE,UAM9B,CAAC;AAEH,eAAO,MAAM,iBAAiB,EAAE,UAO9B,CAAC;AAyHH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAyBlD;AA6BD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EAAE,GACrB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA8CxB;AAiDD,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,WAAW,EAAE,EACvB,QAAQ,CAAC,EAAE,WAAW,EAAE,EACxB,WAAW,CAAC,EAAE,WAAW,EAAE,EAC3B,WAAW,SAAqB,EAChC,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACnC,MAAM,CAmGR;AAED,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAGnD,CAAC"}

package/dist/commands/export.d.ts

@@ -0,0 +1,31 @@
+/**
+ * export Command
+ *
+ * Unified export command for static site generation.
+ * Exports data from database to JSON files based on smrt.config.js export configuration.
+ *
+ * This replaces per-agent export commands (praeco export, caelus export, etc.)
+ * with a single, schema-driven export that respects field-level export annotations.
+ */
+import type { ExportFileConfig } from '@happyvertical/smrt-config';
+import type { DatabaseInterface } from '@happyvertical/sql';
+import type { CLICommand } from '../cli-generator.js';
+/** A single exportable database row keyed by column/field name. */
+type ExportRow = Record<string, unknown>;
+/** WHERE-clause filter map: field name → comparison value. */
+type ExportFilters = Record<string, unknown>;
+/**
+ * Query records with field projection
+ */
+export declare function queryWithProjection(db: DatabaseInterface, tableName: string, types: string[], fields: string[], filters: ExportFilters, orderBy?: string, limit?: number): Promise<ExportRow[]>;
+export declare function formatProjectedRecords(records: ExportRow[], fieldColumns: Array<{
+    field: string;
+    column: string;
+}>): Record<string, unknown>[];
+/**
+ * Get common fields across all types for an export file
+ */
+export declare function getCommonFields(types: string[], fileConfig: ExportFileConfig, fieldExportDefault: boolean): Promise<string[]>;
+export declare const exportCommand: CLICommand;
+export {};
+//# sourceMappingURL=export.d.ts.map

package/dist/commands/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EACV,gBAAgB,EAEjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAmBtD,mEAAmE;AACnE,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEzC,8DAA8D;AAC9D,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA8M7C;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,iBAAiB,EACrB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,SAAS,EAAE,CAAC,CA2GtB;AAiBD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,SAAS,EAAE,EACpB,YAAY,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,6BAavD;AAoCD;;GAEG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,gBAAgB,EAC5B,kBAAkB,EAAE,OAAO,GAC1B,OAAO,CAAC,MAAM,EAAE,CAAC,CAoBnB;AAED,eAAO,MAAM,aAAa,EAAE,UA8R3B,CAAC"}

package/dist/commands/generate.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Code Generation CLI Commands
+ *
+ * Commands for generating code, types, and other artifacts.
+ * Includes generate-types, generate-mcp, generate-routes, and generate-register commands.
+ */
+import type { CLICommand } from '../cli-generator.js';
+/**
+ * Code generation commands for CLI
+ */
+export declare const generateCommands: Record<string, CLICommand>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/commands/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAwDtD;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAqkBvD,CAAC"}

package/dist/commands/git.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Git Commands
+ *
+ * JSON-aware git merge driver for SMRT data files
+ */
+import type { CLICommand } from '../cli-generator.js';
+/**
+ * Structural JSON value types for the merge driver.
+ *
+ * The driver operates on arbitrary parsed JSON (`JSON.parse` output), so values
+ * are modeled as the recursive JSON shape rather than concrete SMRT objects.
+ */
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/**
+ * Merge two arrays of objects by ID
+ *
+ * Logic:
+ * - Union of all objects from both arrays
+ * - When same ID exists in both, newer `updated_at` wins
+ * - Deduplicate by `id` field
+ * - Preserve `_meta_type` for STI support
+ * - Sort by `created_at` (ascending) or `id` for consistent ordering
+ */
+export declare function mergeArraysByKey(base: unknown[], ours: unknown[], theirs: unknown[], keyField?: string): Record<string, unknown>[];
+/**
+ * Merge two JSON objects (non-array case)
+ *
+ * For nested objects, recursively merge.
+ * For arrays of objects with IDs, use array merge logic.
+ * For other values, prefer ours over theirs.
+ */
+export declare function mergeObjects(base: unknown, ours: unknown, theirs: unknown): JsonValue;
+/**
+ * Git commands for SMRT
+ */
+export declare const gitCommands: Record<string, CLICommand>;
+export {};
+//# sourceMappingURL=git.d.ts.map

package/dist/commands/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/commands/git.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;;GAKG;AACH,KAAK,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AACtD,KAAK,SAAS,GAAG,aAAa,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AA4B5E;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,OAAO,EAAE,EACf,IAAI,EAAE,OAAO,EAAE,EACf,MAAM,EAAE,OAAO,EAAE,EACjB,QAAQ,GAAE,MAAa,GACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAgH3B;AAmCD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,OAAO,GACd,SAAS,CAqFX;AA2BD;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CA0SlD,CAAC"}

package/dist/commands/gnode.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Gnode CLI Commands
+ *
+ * Commands for creating and managing gnodes (federated local knowledge bases)
+ */
+import type { CLICommand } from '../cli-generator.js';
+/**
+ * Gnode commands for CLI
+ */
+export declare const gnodeCommands: Record<string, CLICommand>;
+//# sourceMappingURL=gnode.d.ts.map

package/dist/commands/gnode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gnode.d.ts","sourceRoot":"","sources":["../../src/commands/gnode.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAsBtD;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAwHpD,CAAC"}

package/dist/commands/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * CLI Commands - Export all command modules
+ */
+export { configExportCommand } from './config-export.js';
+export { dbDiffCommand } from './db-diff.js';
+export { dbGenerateCommand } from './db-generate.js';
+export { dbHistoryCommand } from './db-history.js';
+export { dbOrphansCommand } from './db-orphans.js';
+export { dbPermissionsCommand } from './db-permissions.js';
+export { dbPruneCommand } from './db-prune.js';
+export { dbRollbackCommand } from './db-rollback.js';
+export { dbStatusCommand } from './db-status.js';
+export { dispatchCommands } from './dispatch.js';
+export { docsCommands } from './docs-claude.js';
+export { exportCommand } from './export.js';
+export { generateCommands } from './generate.js';
+export { gitCommands } from './git.js';
+export { gnodeCommands } from './gnode.js';
+export { initCommands } from './init.js';
+export { playgroundCommands } from './playground.js';
+export { utilityCommands } from './utilities.js';
+export { workbenchCommands } from './workbench.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,11 @@
+/**
+ * SMRT Init Command
+ *
+ * Initialize SMRT in an existing SvelteKit project
+ */
+import type { CLICommand } from '../cli-generator.js';
+/**
+ * Init commands
+ */
+export declare const initCommands: Record<string, CLICommand>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AA+TtD;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAkNnD,CAAC"}