@noormdev/sdk 1.0.0-alpha.12 → 1.0.0-alpha.13

package/dist/index.d.ts

@@ -71,10 +71,6 @@ export interface ConnectionResult {
  *         user: 'postgres',
  *         password: 'postgres',
  *     },
- *     paths: {
- *         sql: './sql',
- *         changes: './changes',
- *     },
  * }
  * ```
  */
@@ -84,10 +80,6 @@ export interface Config {
 	isTest: boolean;
 	protected: boolean;
 	connection: ConnectionConfig;
-	paths: {
-		sql: string;
-		changes: string;
-	};
 	identity?: string;
 }
 /**
@@ -623,214 +615,6 @@ export interface Identity {
 	/** How the identity was resolved */
 	source: IdentitySource;
 }
-/**
- * Overview counts for all categories.
- */
-export interface ExploreOverview {
-	tables: number;
-	views: number;
-	procedures: number;
-	functions: number;
-	types: number;
-	indexes: number;
-	foreignKeys: number;
-	triggers: number;
-	locks: number;
-	connections: number;
-}
-/**
- * Table summary for list display.
- */
-export interface TableSummary {
-	name: string;
-	schema?: string;
-	columnCount: number;
-	rowCountEstimate?: number;
-}
-/**
- * Index summary for list display.
- */
-export interface IndexSummary {
-	name: string;
-	schema?: string;
-	tableName: string;
-	tableSchema?: string;
-	columns: string[];
-	isUnique: boolean;
-	isPrimary: boolean;
-}
-/**
- * Foreign key summary for list display.
- */
-export interface ForeignKeySummary {
-	name: string;
-	schema?: string;
-	tableName: string;
-	tableSchema?: string;
-	columns: string[];
-	referencedTable: string;
-	referencedSchema?: string;
-	referencedColumns: string[];
-	onDelete?: string;
-	onUpdate?: string;
-}
-/**
- * Column detail for tables/views.
- */
-export interface ColumnDetail {
-	name: string;
-	dataType: string;
-	isNullable: boolean;
-	defaultValue?: string;
-	isPrimaryKey: boolean;
-	ordinalPosition: number;
-}
-/**
- * Full table detail.
- */
-export interface TableDetail {
-	name: string;
-	schema?: string;
-	columns: ColumnDetail[];
-	indexes: IndexSummary[];
-	foreignKeys: ForeignKeySummary[];
-	rowCountEstimate?: number;
-}
-/**
- * Result of a truncate operation.
- */
-export interface TruncateResult {
-	/** Tables that were truncated */
-	truncated: string[];
-	/** Tables that were preserved */
-	preserved: string[];
-	/** SQL statements executed (or would execute in dry-run) */
-	statements: string[];
-	/** Duration in milliseconds */
-	durationMs: number;
-}
-/**
- * Result of a teardown operation.
- */
-export interface TeardownResult {
-	/** Objects dropped by category */
-	dropped: {
-		tables: string[];
-		views: string[];
-		functions: string[];
-		procedures: string[];
-		types: string[];
-		foreignKeys: string[];
-	};
-	/** Objects preserved */
-	preserved: string[];
-	/** SQL statements executed (or would execute in dry-run) */
-	statements: string[];
-	/** Duration in milliseconds */
-	durationMs: number;
-	/** Post-script execution result (if any) */
-	postScriptResult?: {
-		executed: boolean;
-		error?: string;
-	};
-	/** Number of changes marked as stale (if configName provided) */
-	staleCount?: number;
-	/** ID of the reset record created (if configName provided) */
-	resetRecordId?: number;
-}
-/**
- * Options for running SQL files.
- *
- * @example
- * ```typescript
- * const options: RunOptions = {
- *     force: true,        // Re-run even if unchanged
- *     abortOnError: false // Continue on failures
- * }
- * ```
- */
-export interface RunOptions {
-	/** Re-run files even if unchanged. Default: false */
-	force?: boolean;
-	/** Number of files to run in parallel. Default: 1 (sequential for DDL safety) */
-	concurrency?: number;
-	/** Stop execution on first failure. Default: true */
-	abortOnError?: boolean;
-	/** Report what would run without executing. Default: false */
-	dryRun?: boolean;
-	/** Output rendered SQL without executing. Default: false */
-	preview?: boolean;
-	/** Write preview output to file instead of stdout. Default: null */
-	output?: string | null;
-}
-/**
- * Why a file was skipped.
- */
-export type SkipReason = "unchanged" | "already-run";
-/**
- * Result of executing a single file.
- *
- * @example
- * ```typescript
- * const result: FileResult = {
- *     filepath: '/project/sql/001.sql',
- *     checksum: 'abc123...',
- *     status: 'success',
- *     durationMs: 42,
- * }
- * ```
- */
-export interface FileResult {
-	/** Absolute path to the file */
-	filepath: string;
-	/** SHA-256 hash of file contents */
-	checksum: string;
-	/** Execution status */
-	status: ExecutionStatus;
-	/** Why the file was skipped (only when status is 'skipped') */
-	skipReason?: SkipReason;
-	/** Execution time in milliseconds */
-	durationMs?: number;
-	/** Error message if failed */
-	error?: string;
-	/** Rendered SQL (only in preview mode) */
-	renderedSql?: string;
-}
-/**
- * Overall status of a batch operation.
- */
-export type BatchStatus = "success" | "failed" | "partial";
-/**
- * Result of a batch operation (build, dir).
- *
- * @example
- * ```typescript
- * const result: BatchResult = {
- *     status: 'success',
- *     files: [...],
- *     filesRun: 5,
- *     filesSkipped: 2,
- *     filesFailed: 0,
- *     durationMs: 1234,
- * }
- * ```
- */
-export interface BatchResult {
-	/** Overall status */
-	status: BatchStatus;
-	/** Results for each file */
-	files: FileResult[];
-	/** Number of files executed */
-	filesRun: number;
-	/** Number of files skipped */
-	filesSkipped: number;
-	/** Number of files that failed */
-	filesFailed: number;
-	/** Total execution time in milliseconds */
-	durationMs: number;
-	/** Change ID in tracking table */
-	changeId?: number;
-}
 /**
  * File extension type in changes.
  *
@@ -1130,95 +914,778 @@ export interface FileHistoryRecord {
 	/** Duration in milliseconds */
 	durationMs: number;
 }
-declare class ChangeManager {
-	#private;
-	constructor(context: ChangeContext);
-	/**
-	 * List all changes with status.
-	 *
-	 * Merges changes from disk with status from database.
-	 * Includes orphaned changes (in DB but not on disk).
-	 *
-	 * @returns Array of changes with merged status
-	 */
-	list(): Promise<ChangeListItem[]>;
-	/**
-	 * Run a specific change by name.
-	 *
-	 * @param name - Change name
-	 * @param options - Execution options
-	 * @returns Execution result
-	 */
-	run(name: string, options?: ChangeOptions): Promise<ChangeResult>;
-	/**
-	 * Run a change object directly.
-	 */
-	runChange(change: Change, options?: ChangeOptions): Promise<ChangeResult>;
-	/**
-	 * Revert a specific change by name.
-	 *
-	 * @param name - Change name
-	 * @param options - Execution options
-	 * @returns Execution result
-	 */
-	revert(name: string, options?: ChangeOptions): Promise<ChangeResult>;
-	/**
-	 * Revert a change object directly.
-	 */
-	revertChange(change: Change, options?: ChangeOptions): Promise<ChangeResult>;
-	/**
-	 * Run next N pending changes.
-	 *
-	 * @param count - Number of changes to run (default: 1)
-	 * @param options - Execution options
-	 * @returns Batch result
-	 */
-	next(count?: number, options?: BatchChangeOptions): Promise<BatchChangeResult>;
-	/**
-	 * Fast-forward: run all pending changes.
+/**
+ * Options for creating a new change.
+ */
+export interface CreateChangeOptions {
+	/** Description for the change name */
+	description: string;
+	/** Optional date (defaults to today) */
+	date?: Date;
+}
+/**
+ * Options for adding a file to a change.
+ */
+export interface AddFileOptions {
+	/** Descriptive name for the file */
+	name: string;
+	/** File type */
+	type: ChangeFileType;
+	/** For 'txt' type, the paths to include */
+	paths?: string[];
+	/** Initial content (optional) */
+	content?: string;
+}
+/**
+ * Error when change structure is invalid.
+ */
+export declare class ChangeValidationError extends Error {
+	readonly changeName: string;
+	readonly issue: string;
+	readonly name: "ChangeValidationError";
+	constructor(changeName: string, issue: string);
+}
+/**
+ * Error when change is not found.
+ */
+export declare class ChangeNotFoundError extends Error {
+	readonly changeName: string;
+	readonly name: "ChangeNotFoundError";
+	constructor(changeName: string);
+}
+/**
+ * Error when change is already applied.
+ */
+export declare class ChangeAlreadyAppliedError extends Error {
+	readonly changeName: string;
+	readonly appliedAt: Date;
+	readonly name: "ChangeAlreadyAppliedError";
+	constructor(changeName: string, appliedAt: Date);
+}
+/**
+ * Error when trying to revert an unapplied change.
+ */
+export declare class ChangeNotAppliedError extends Error {
+	readonly changeName: string;
+	readonly name: "ChangeNotAppliedError";
+	constructor(changeName: string);
+}
+/**
+ * Error when change is orphaned (in DB but not on disk).
+ */
+export declare class ChangeOrphanedError extends Error {
+	readonly changeName: string;
+	readonly name: "ChangeOrphanedError";
+	constructor(changeName: string);
+}
+/**
+ * Error when .txt manifest has invalid references.
+ */
+export declare class ManifestReferenceError extends Error {
+	readonly manifestPath: string;
+	readonly missingPath: string;
+	readonly name: "ManifestReferenceError";
+	constructor(manifestPath: string, missingPath: string);
+}
+/**
+ * Options for running SQL files.
+ *
+ * @example
+ * ```typescript
+ * const options: RunOptions = {
+ *     force: true,        // Re-run even if unchanged
+ *     abortOnError: false // Continue on failures
+ * }
+ * ```
+ */
+export interface RunOptions {
+	/** Re-run files even if unchanged. Default: false */
+	force?: boolean;
+	/** Number of files to run in parallel. Default: 1 (sequential for DDL safety) */
+	concurrency?: number;
+	/** Stop execution on first failure. Default: true */
+	abortOnError?: boolean;
+	/** Report what would run without executing. Default: false */
+	dryRun?: boolean;
+	/** Output rendered SQL without executing. Default: false */
+	preview?: boolean;
+	/** Write preview output to file instead of stdout. Default: null */
+	output?: string | null;
+}
+/**
+ * Why a file was skipped.
+ */
+export type SkipReason = "unchanged" | "already-run";
+/**
+ * Result of executing a single file.
+ *
+ * @example
+ * ```typescript
+ * const result: FileResult = {
+ *     filepath: '/project/sql/001.sql',
+ *     checksum: 'abc123...',
+ *     status: 'success',
+ *     durationMs: 42,
+ * }
+ * ```
+ */
+export interface FileResult {
+	/** Absolute path to the file */
+	filepath: string;
+	/** SHA-256 hash of file contents */
+	checksum: string;
+	/** Execution status */
+	status: ExecutionStatus;
+	/** Why the file was skipped (only when status is 'skipped') */
+	skipReason?: SkipReason;
+	/** Execution time in milliseconds */
+	durationMs?: number;
+	/** Error message if failed */
+	error?: string;
+	/** Rendered SQL (only in preview mode) */
+	renderedSql?: string;
+}
+/**
+ * Overall status of a batch operation.
+ */
+export type BatchStatus = "success" | "failed" | "partial";
+/**
+ * Result of a batch operation (build, dir).
+ *
+ * @example
+ * ```typescript
+ * const result: BatchResult = {
+ *     status: 'success',
+ *     files: [...],
+ *     filesRun: 5,
+ *     filesSkipped: 2,
+ *     filesFailed: 0,
+ *     durationMs: 1234,
+ * }
+ * ```
+ */
+export interface BatchResult {
+	/** Overall status */
+	status: BatchStatus;
+	/** Results for each file */
+	files: FileResult[];
+	/** Number of files executed */
+	filesRun: number;
+	/** Number of files skipped */
+	filesSkipped: number;
+	/** Number of files that failed */
+	filesFailed: number;
+	/** Total execution time in milliseconds */
+	durationMs: number;
+	/** Change ID in tracking table */
+	changeId?: number;
+}
+declare class ChangeManager {
+	#private;
+	constructor(context: ChangeContext);
+	/**
+	 * List all changes with status.
+	 *
+	 * Merges changes from disk with status from database.
+	 * Includes orphaned changes (in DB but not on disk).
+	 *
+	 * @returns Array of changes with merged status
+	 */
+	list(): Promise<ChangeListItem[]>;
+	/**
+	 * Run a specific change by name.
+	 *
+	 * @param name - Change name
+	 * @param options - Execution options
+	 * @returns Execution result
+	 */
+	run(name: string, options?: ChangeOptions): Promise<ChangeResult>;
+	/**
+	 * Run a change object directly.
+	 */
+	runChange(change: Change, options?: ChangeOptions): Promise<ChangeResult>;
+	/**
+	 * Revert a specific change by name.
+	 *
+	 * @param name - Change name
+	 * @param options - Execution options
+	 * @returns Execution result
+	 */
+	revert(name: string, options?: ChangeOptions): Promise<ChangeResult>;
+	/**
+	 * Revert a change object directly.
+	 */
+	revertChange(change: Change, options?: ChangeOptions): Promise<ChangeResult>;
+	/**
+	 * Run next N pending changes.
+	 *
+	 * @param count - Number of changes to run (default: 1)
+	 * @param options - Execution options
+	 * @returns Batch result
+	 */
+	next(count?: number, options?: BatchChangeOptions): Promise<BatchChangeResult>;
+	/**
+	 * Fast-forward: run all pending changes.
+	 *
+	 * @param options - Execution options
+	 * @returns Batch result
+	 */
+	ff(options?: BatchChangeOptions): Promise<BatchChangeResult>;
+	/**
+	 * Rewind: revert changes in reverse order.
+	 *
+	 * @param target - Number of changes to revert, or name to revert to
+	 * @param options - Execution options
+	 * @returns Batch result
+	 */
+	rewind(target: number | string, options?: BatchChangeOptions): Promise<BatchChangeResult>;
+	/**
+	 * Get execution history.
+	 *
+	 * @param name - Optional change name (all if not provided)
+	 * @param limit - Max records to return
+	 * @returns Array of history records
+	 */
+	getHistory(name?: string, limit?: number): Promise<ChangeHistoryRecord[]>;
+	/**
+	 * Get file execution history for an operation.
+	 */
+	getFileHistory(operationId: number): Promise<FileHistoryRecord[]>;
+	/**
+	 * Remove a change from disk, database, or both.
+	 *
+	 * @param name - Change name
+	 * @param options - What to remove
+	 */
+	remove(name: string, options: {
+		disk?: boolean;
+		db?: boolean;
+	}): Promise<void>;
+	/**
+	 * Get a specific change by name.
+	 */
+	get(name: string): Promise<ChangeListItem | null>;
+	/**
+	 * Load a change from disk.
+	 */
+	load(name: string): Promise<Change>;
+}
+/**
+ * SDK Types.
+ *
+ * All interfaces and types for the noorm programmatic SDK.
+ */
+/**
+ * Options for creating an SDK context.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage with stored config
+ * const ctx = await createContext({ config: 'dev' })
+ *
+ * // Require test database for safety
+ * const ctx = await createContext({
+ *     config: 'test',
+ *     requireTest: true,
+ * })
+ *
+ * // Allow destructive ops on protected config
+ * const ctx = await createContext({
+ *     config: 'staging',
+ *     allowProtected: true,
+ * })
+ *
+ * // Env-only mode (CI/CD) - no stored config needed
+ * // Requires NOORM_CONNECTION_DIALECT and NOORM_CONNECTION_DATABASE
+ * const ctx = await createContext()
+ *
+ * // Override stored config via NOORM_* env vars
+ * // NOORM_CONNECTION_HOST=override.host
+ * const ctx = await createContext({ config: 'prod' })
+ * ```
+ */
+export interface CreateContextOptions {
+	/**
+	 * Config name from state.
+	 *
+	 * If omitted:
+	 * - Uses `NOORM_CONFIG` env var if set
+	 * - Falls back to env-only mode if `NOORM_CONNECTION_DIALECT`
+	 *   and `NOORM_CONNECTION_DATABASE` are set
+	 */
+	config?: string;
+	/** Project root directory. Defaults to process.cwd() */
+	projectRoot?: string;
+	/** Refuse if config.isTest !== true. Default: false */
+	requireTest?: boolean;
+	/** Allow destructive ops on protected configs. Default: false */
+	allowProtected?: boolean;
+	/** Stage name for stage defaults (from settings.yml) */
+	stage?: string;
+}
+/**
+ * Options for build operations.
+ */
+export interface BuildOptions {
+	/** Skip checksum checks, rebuild everything. Default: false */
+	force?: boolean;
+}
+/**
+ * Options for exporting a table to a .dt file.
+ *
+ * Connection details (db, dialect) come from the context automatically.
+ *
+ * @example
+ * ```typescript
+ * const [result, err] = await ctx.exportTable('users', './exports/users.dtz', {
+ *     passphrase: 'secret',
+ *     batchSize: 5000,
+ * });
+ * ```
+ */
+export interface ExportOptions {
+	/** Passphrase for .dtzx encryption. */
+	passphrase?: string;
+	/** Schema/namespace (e.g., 'public' for PostgreSQL). */
+	schema?: string;
+	/** Rows per batch. Default: 1000. */
+	batchSize?: number;
+}
+/**
+ * Options for importing a .dt file into the database.
+ *
+ * Connection details (db, dialect) come from the context automatically.
+ *
+ * @example
+ * ```typescript
+ * const [result, err] = await ctx.importFile('./exports/users.dtz', {
+ *     onConflict: 'skip',
+ *     truncate: true,
+ * });
+ * ```
+ */
+export interface ImportOptions {
+	/** Passphrase for .dtzx decryption. */
+	passphrase?: string;
+	/** Rows per batch. Default: 1000. */
+	batchSize?: number;
+	/** Conflict strategy. Default: 'fail'. */
+	onConflict?: "fail" | "skip" | "update" | "replace";
+	/** Truncate target table before import. Default: false. */
+	truncate?: boolean;
+}
+export interface ContextState {
+	connection: ConnectionResult | null;
+	config: Config;
+	settings: Settings;
+	identity: Identity;
+	options: CreateContextOptions;
+	projectRoot: string;
+	changeManager: ChangeManager | null;
+}
+export declare class ChangesNamespace {
+	#private;
+	constructor(state: ContextState);
+	/**
+	 * Create a new change directory with change/ and revert/ folders.
+	 *
+	 * @example
+	 * ```typescript
+	 * const change = await ctx.noorm.changes.create({ description: 'add-user-roles' })
+	 * ```
+	 */
+	create(options: CreateChangeOptions): Promise<Change>;
+	/**
+	 * Add a file to a change.
+	 *
+	 * @example
+	 * ```typescript
+	 * const updated = await ctx.noorm.changes.addFile(change, 'change', {
+	 *     name: 'create-table',
+	 *     type: 'sql',
+	 * })
+	 * ```
+	 */
+	addFile(change: Change, folder: "change" | "revert", options: AddFileOptions): Promise<Change>;
+	/**
+	 * Remove a file from a change.
+	 *
+	 * @example
+	 * ```typescript
+	 * await ctx.noorm.changes.removeFile(change, 'change', '001_create-table.sql')
+	 * ```
+	 */
+	removeFile(change: Change, folder: "change" | "revert", filename: string): Promise<Change>;
+	/**
+	 * Rename a file in a change.
+	 *
+	 * @example
+	 * ```typescript
+	 * await ctx.noorm.changes.renameFile(change, 'change', '001_old.sql', 'new-name')
+	 * ```
+	 */
+	renameFile(change: Change, folder: "change" | "revert", oldFilename: string, newDescription: string): Promise<Change>;
+	/**
+	 * Reorder files in a change folder.
+	 *
+	 * @example
+	 * ```typescript
+	 * await ctx.noorm.changes.reorderFiles(change, 'change', ['002_b.sql', '001_a.sql'])
+	 * ```
+	 */
+	reorderFiles(change: Change, folder: "change" | "revert", newOrder: string[]): Promise<Change>;
+	/**
+	 * Delete a change directory from disk.
+	 *
+	 * @example
+	 * ```typescript
+	 * await ctx.noorm.changes.delete(change)
+	 * ```
+	 */
+	delete(change: Change): Promise<void>;
+	/**
+	 * Discover all changes on disk.
+	 *
+	 * @example
+	 * ```typescript
+	 * const changes = await ctx.noorm.changes.discover()
+	 * ```
+	 */
+	discover(): Promise<Change[]>;
+	/**
+	 * Parse a single change from disk by name.
+	 *
+	 * @example
+	 * ```typescript
+	 * const change = await ctx.noorm.changes.parse('2024-01-15-add-users')
+	 * ```
+	 */
+	parse(name: string): Promise<Change>;
+	/**
+	 * Validate a change's structure.
+	 *
+	 * @throws ChangeValidationError if invalid
+	 *
+	 * @example
+	 * ```typescript
+	 * ctx.noorm.changes.validate(change)
+	 * ```
+	 */
+	validate(change: Change): void;
+	/**
+	 * Apply a specific change.
+	 *
+	 * @example
+	 * ```typescript
+	 * const result = await ctx.noorm.changes.apply('2024-01-15-add-users')
+	 * ```
+	 */
+	apply(name: string, options?: ChangeOptions): Promise<ChangeResult>;
+	/**
+	 * Revert a specific change.
+	 *
+	 * @example
+	 * ```typescript
+	 * const result = await ctx.noorm.changes.revert('2024-01-15-add-users')
+	 * ```
+	 */
+	revert(name: string, options?: ChangeOptions): Promise<ChangeResult>;
+	/**
+	 * Apply all pending changes.
+	 *
+	 * @example
+	 * ```typescript
+	 * const result = await ctx.noorm.changes.ff()
+	 * ```
+	 */
+	ff(): Promise<BatchChangeResult>;
+	/**
+	 * Get status of all changes (merged disk + DB).
+	 *
+	 * @example
+	 * ```typescript
+	 * const all = await ctx.noorm.changes.status()
+	 * ```
+	 */
+	status(): Promise<ChangeListItem[]>;
+	/**
+	 * Get only pending (unapplied or reverted) changes.
+	 *
+	 * @example
+	 * ```typescript
+	 * const pending = await ctx.noorm.changes.pending()
+	 * ```
+	 */
+	pending(): Promise<ChangeListItem[]>;
+	/**
+	 * Get execution history.
+	 *
+	 * @example
+	 * ```typescript
+	 * const history = await ctx.noorm.changes.history(10)
+	 * ```
+	 */
+	history(limit?: number): Promise<ChangeHistoryRecord[]>;
+}
+export declare class RunNamespace {
+	#private;
+	constructor(state: ContextState);
+	/**
+	 * Discover SQL files in a directory.
+	 *
+	 * @example
+	 * ```typescript
+	 * const files = await ctx.noorm.run.discover('sql/')
+	 * ```
+	 */
+	discover(dirpath?: string): Promise<string[]>;
+	/**
+	 * Preview SQL files — render templates without executing.
+	 *
+	 * @example
+	 * ```typescript
+	 * const results = await ctx.noorm.run.preview(['sql/001.sql', 'sql/002.sql'])
+	 * ```
+	 */
+	preview(filepaths: string[], output?: string | null): Promise<FileResult[]>;
+	/**
+	 * Execute a single SQL file.
+	 *
+	 * @example
+	 * ```typescript
+	 * await ctx.noorm.run.file('seeds/test-data.sql')
+	 * ```
+	 */
+	file(filepath: string, options?: RunOptions): Promise<FileResult>;
+	/**
+	 * Execute multiple SQL files sequentially.
+	 *
+	 * @example
+	 * ```typescript
+	 * await ctx.noorm.run.files(['functions/utils.sql', 'triggers/audit.sql'])
+	 * ```
+	 */
+	files(filepaths: string[], options?: RunOptions): Promise<BatchResult>;
+	/**
+	 * Execute all SQL files in a directory.
+	 *
+	 * @example
+	 * ```typescript
+	 * await ctx.noorm.run.dir('seeds/')
+	 * ```
+	 */
+	dir(dirpath: string, options?: RunOptions): Promise<BatchResult>;
+	/**
+	 * Execute all SQL files in the schema directory.
+	 *
+	 * @example
+	 * ```typescript
+	 * await ctx.noorm.run.build({ force: true })
+	 * ```
+	 */
+	build(options?: BuildOptions): Promise<BatchResult>;
+}
+/**
+ * Overview counts for all categories.
+ */
+export interface ExploreOverview {
+	tables: number;
+	views: number;
+	procedures: number;
+	functions: number;
+	types: number;
+	indexes: number;
+	foreignKeys: number;
+	triggers: number;
+	locks: number;
+	connections: number;
+}
+/**
+ * Table summary for list display.
+ */
+export interface TableSummary {
+	name: string;
+	schema?: string;
+	columnCount: number;
+	rowCountEstimate?: number;
+}
+/**
+ * Index summary for list display.
+ */
+export interface IndexSummary {
+	name: string;
+	schema?: string;
+	tableName: string;
+	tableSchema?: string;
+	columns: string[];
+	isUnique: boolean;
+	isPrimary: boolean;
+}
+/**
+ * Foreign key summary for list display.
+ */
+export interface ForeignKeySummary {
+	name: string;
+	schema?: string;
+	tableName: string;
+	tableSchema?: string;
+	columns: string[];
+	referencedTable: string;
+	referencedSchema?: string;
+	referencedColumns: string[];
+	onDelete?: string;
+	onUpdate?: string;
+}
+/**
+ * Column detail for tables/views.
+ */
+export interface ColumnDetail {
+	name: string;
+	dataType: string;
+	isNullable: boolean;
+	defaultValue?: string;
+	isPrimaryKey: boolean;
+	ordinalPosition: number;
+}
+/**
+ * Full table detail.
+ */
+export interface TableDetail {
+	name: string;
+	schema?: string;
+	columns: ColumnDetail[];
+	indexes: IndexSummary[];
+	foreignKeys: ForeignKeySummary[];
+	rowCountEstimate?: number;
+}
+/**
+ * Result of a truncate operation.
+ */
+export interface TruncateResult {
+	/** Tables that were truncated */
+	truncated: string[];
+	/** Tables that were preserved */
+	preserved: string[];
+	/** SQL statements executed (or would execute in dry-run) */
+	statements: string[];
+	/** Duration in milliseconds */
+	durationMs: number;
+}
+/**
+ * Result of a teardown operation.
+ */
+export interface TeardownResult {
+	/** Objects dropped by category */
+	dropped: {
+		tables: string[];
+		views: string[];
+		functions: string[];
+		procedures: string[];
+		types: string[];
+		foreignKeys: string[];
+	};
+	/** Objects preserved */
+	preserved: string[];
+	/** SQL statements executed (or would execute in dry-run) */
+	statements: string[];
+	/** Duration in milliseconds */
+	durationMs: number;
+	/** Post-script execution result (if any) */
+	postScriptResult?: {
+		executed: boolean;
+		error?: string;
+	};
+	/** Number of changes marked as stale (if configName provided) */
+	staleCount?: number;
+	/** ID of the reset record created (if configName provided) */
+	resetRecordId?: number;
+}
+/**
+ * Preview of what would be affected by teardown.
+ */
+export interface TeardownPreview {
+	/** Objects that would be dropped */
+	toDrop: {
+		tables: string[];
+		views: string[];
+		functions: string[];
+		procedures: string[];
+		types: string[];
+		foreignKeys: string[];
+	};
+	/** Objects that would be preserved */
+	toPreserve: string[];
+	/** SQL statements that would execute */
+	statements: string[];
+}
+export declare class DbNamespace {
+	#private;
+	constructor(state: ContextState);
+	/**
+	 * List all tables in the database.
 	 *
-	 * @param options - Execution options
-	 * @returns Batch result
+	 * @example
+	 * ```typescript
+	 * const tables = await ctx.noorm.db.listTables()
+	 * ```
 	 */
-	ff(options?: BatchChangeOptions): Promise<BatchChangeResult>;
+	listTables(): Promise<TableSummary[]>;
 	/**
-	 * Rewind: revert changes in reverse order.
+	 * Get detailed information about a table.
 	 *
-	 * @param target - Number of changes to revert, or name to revert to
-	 * @param options - Execution options
-	 * @returns Batch result
+	 * @example
+	 * ```typescript
+	 * const detail = await ctx.noorm.db.describeTable('users')
+	 * ```
 	 */
-	rewind(target: number | string, options?: BatchChangeOptions): Promise<BatchChangeResult>;
+	describeTable(name: string, schema?: string): Promise<TableDetail | null>;
 	/**
-	 * Get execution history.
+	 * Get database overview with counts of all object types.
 	 *
-	 * @param name - Optional change name (all if not provided)
-	 * @param limit - Max records to return
-	 * @returns Array of history records
+	 * @example
+	 * ```typescript
+	 * const overview = await ctx.noorm.db.overview()
+	 * ```
 	 */
-	getHistory(name?: string, limit?: number): Promise<ChangeHistoryRecord[]>;
+	overview(): Promise<ExploreOverview>;
 	/**
-	 * Get file execution history for an operation.
+	 * Preview what teardown would drop without executing.
+	 *
+	 * @example
+	 * ```typescript
+	 * const preview = await ctx.noorm.db.previewTeardown()
+	 * ```
 	 */
-	getFileHistory(operationId: number): Promise<FileHistoryRecord[]>;
+	previewTeardown(): Promise<TeardownPreview>;
 	/**
-	 * Remove a change from disk, database, or both.
+	 * Wipe all data, keeping the schema intact.
 	 *
-	 * @param name - Change name
-	 * @param options - What to remove
+	 * @example
+	 * ```typescript
+	 * const result = await ctx.noorm.db.truncate()
+	 * ```
 	 */
-	remove(name: string, options: {
-		disk?: boolean;
-		db?: boolean;
-	}): Promise<void>;
+	truncate(): Promise<TruncateResult>;
 	/**
-	 * Get a specific change by name.
+	 * Drop all database objects except noorm tracking tables.
+	 *
+	 * @example
+	 * ```typescript
+	 * const result = await ctx.noorm.db.teardown()
+	 * ```
 	 */
-	get(name: string): Promise<ChangeListItem | null>;
+	teardown(): Promise<TeardownResult>;
 	/**
-	 * Load a change from disk.
+	 * Full rebuild: teardown + build.
+	 *
+	 * @example
+	 * ```typescript
+	 * await ctx.noorm.db.reset()
+	 * ```
 	 */
-	load(name: string): Promise<Change>;
+	reset(): Promise<void>;
+	/** @internal Used by NoormOps to wire up reset -> build. */
+	set _buildFn(fn: (opts?: BuildOptions) => Promise<unknown>);
 }
 /**
  * Lock manager types.
@@ -1368,6 +1835,286 @@ export declare class LockExpiredError extends Error {
 	readonly name: "LockExpiredError";
 	constructor(configName: string, identity: string, expiredAt: Date);
 }
+export declare class LockNamespace {
+	#private;
+	constructor(state: ContextState);
+	/**
+	 * Acquire a database lock.
+	 *
+	 * @example
+	 * ```typescript
+	 * const lock = await ctx.noorm.lock.acquire({ timeout: 60000 })
+	 * ```
+	 */
+	acquire(options?: LockOptions$1): Promise<Lock$1>;
+	/**
+	 * Release the current lock.
+	 *
+	 * @example
+	 * ```typescript
+	 * await ctx.noorm.lock.release()
+	 * ```
+	 */
+	release(): Promise<void>;
+	/**
+	 * Get current lock status.
+	 *
+	 * @example
+	 * ```typescript
+	 * const status = await ctx.noorm.lock.status()
+	 * ```
+	 */
+	status(): Promise<LockStatus>;
+	/**
+	 * Execute an operation with automatic lock acquisition and release.
+	 *
+	 * @example
+	 * ```typescript
+	 * await ctx.noorm.lock.withLock(async () => {
+	 *     await ctx.noorm.run.build()
+	 * })
+	 * ```
+	 */
+	withLock<T>(fn: () => Promise<T>, options?: LockOptions$1): Promise<T>;
+	/**
+	 * Force release any database lock regardless of ownership.
+	 *
+	 * @example
+	 * ```typescript
+	 * await ctx.noorm.lock.forceRelease()
+	 * ```
+	 */
+	forceRelease(): Promise<boolean>;
+}
+/**
+ * Vault secret entry (decrypted).
+ */
+export interface VaultSecret {
+	/** Secret key name */
+	key: string;
+	/** Decrypted value */
+	value: string;
+	/** Identity who set this secret */
+	setBy: string;
+	/** When created */
+	createdAt: Date;
+	/** When last updated */
+	updatedAt: Date;
+}
+/**
+ * Result of vault copy operation.
+ */
+export interface VaultCopyResult {
+	/** Keys that were successfully copied */
+	copied: string[];
+	/** Keys that were skipped (already exist and force not set) */
+	skipped: string[];
+	/** Keys that failed with errors */
+	errors: Array<{
+		key: string;
+		error: string;
+	}>;
+}
+/**
+ * Result of vault propagation.
+ */
+export interface VaultPropagationResult {
+	/** Identity hashes that received the vault key */
+	propagatedTo: string[];
+	/** Count of users who already had access */
+	alreadyHadAccess: number;
+}
+/**
+ * Vault status for the current user.
+ */
+export interface VaultStatus {
+	/** Whether the vault is initialized (at least one user has the vault key) */
+	isInitialized: boolean;
+	/** Whether the current user has access to the vault */
+	hasAccess: boolean;
+	/** Number of secrets in the vault */
+	secretCount: number;
+	/** Number of users with vault access */
+	usersWithAccess: number;
+	/** Number of users without vault access */
+	usersWithoutAccess: number;
+}
+/**
+ * Vault event types.
+ *
+ * All events emitted by the vault module. These are merged into
+ * NoormEvents via the VaultEvents interface.
+ */
+/**
+ * Vault events for observer integration.
+ *
+ * Events follow the naming convention `vault:{operation}`.
+ */
+export interface VaultEvents {
+	/** Vault was initialized for the first time */
+	"vault:initialized": {
+		identityHash: string;
+	};
+	/** New vault secret was created */
+	"vault:secret:created": {
+		key: string;
+		setBy: string;
+	};
+	/** Existing vault secret was updated */
+	"vault:secret:updated": {
+		key: string;
+		setBy: string;
+	};
+	/** Vault secret was deleted */
+	"vault:secret:deleted": {
+		key: string;
+	};
+	/** Vault key was propagated to a user */
+	"vault:propagated": {
+		toIdentityHash: string;
+		toEmail: string;
+	};
+	/** Vault copy operation started */
+	"vault:copy:starting": {
+		source: string;
+		destination: string;
+		keys: "all" | number;
+	};
+	/** Vault copy operation completed */
+	"vault:copy:completed": {
+		source: string;
+		destination: string;
+		copied: number;
+		skipped: number;
+		errors: number;
+	};
+}
+/**
+ * Options for vault copy operation.
+ */
+export interface VaultCopyOptions {
+	/** Overwrite existing secrets in destination (default: false) */
+	force?: boolean;
+}
+export declare class VaultNamespace {
+	#private;
+	constructor(state: ContextState);
+	/**
+	 * Initialize the vault for this database.
+	 *
+	 * @example
+	 * ```typescript
+	 * const [vaultKey, err] = await ctx.noorm.vault.init()
+	 * ```
+	 */
+	init(): Promise<[
+		Buffer | null,
+		Error | null
+	]>;
+	/**
+	 * Get vault status.
+	 *
+	 * @example
+	 * ```typescript
+	 * const status = await ctx.noorm.vault.status()
+	 * ```
+	 */
+	status(): Promise<VaultStatus>;
+	/**
+	 * Set a vault secret.
+	 *
+	 * @example
+	 * ```typescript
+	 * const [, err] = await ctx.noorm.vault.set('API_KEY', 'sk-live-...', privateKey)
+	 * ```
+	 */
+	set(key: string, value: string, privateKey: string): Promise<[
+		void,
+		Error | null
+	]>;
+	/**
+	 * Get a vault secret by key.
+	 *
+	 * @example
+	 * ```typescript
+	 * const value = await ctx.noorm.vault.get('API_KEY', privateKey)
+	 * ```
+	 */
+	get(key: string, privateKey: string): Promise<string | null>;
+	/**
+	 * Get all vault secrets.
+	 *
+	 * @example
+	 * ```typescript
+	 * const all = await ctx.noorm.vault.getAll(privateKey)
+	 * ```
+	 */
+	getAll(privateKey: string): Promise<Record<string, VaultSecret>>;
+	/**
+	 * List all vault secret keys (without decrypting values).
+	 *
+	 * @example
+	 * ```typescript
+	 * const keys = await ctx.noorm.vault.list()
+	 * ```
+	 */
+	list(): Promise<string[]>;
+	/**
+	 * Delete a vault secret.
+	 *
+	 * @example
+	 * ```typescript
+	 * const [deleted, err] = await ctx.noorm.vault.delete('OLD_KEY')
+	 * ```
+	 */
+	delete(key: string): Promise<[
+		boolean,
+		Error | null
+	]>;
+	/**
+	 * Check if a vault secret exists.
+	 *
+	 * @example
+	 * ```typescript
+	 * const exists = await ctx.noorm.vault.exists('API_KEY')
+	 * ```
+	 */
+	exists(key: string): Promise<boolean>;
+	/**
+	 * Propagate vault key to all users without access.
+	 *
+	 * @example
+	 * ```typescript
+	 * const result = await ctx.noorm.vault.propagate(privateKey)
+	 * ```
+	 */
+	propagate(privateKey: string): Promise<VaultPropagationResult>;
+	/**
+	 * Copy vault secrets to another config's database.
+	 *
+	 * @example
+	 * ```typescript
+	 * const [result, err] = await ctx.noorm.vault.copy(destConfig, ['API_KEY'], privateKey)
+	 * ```
+	 */
+	copy(destConfig: Config, keys: string[] | "all", privateKey: string, options?: VaultCopyOptions): Promise<[
+		VaultCopyResult | null,
+		Error | null
+	]>;
+}
+export declare class SecretsNamespace {
+	#private;
+	constructor(state: ContextState);
+	/**
+	 * Get a config-scoped secret.
+	 *
+	 * @example
+	 * ```typescript
+	 * const apiKey = ctx.noorm.secrets.get('API_KEY')
+	 * ```
+	 */
+	get(key: string): string | undefined;
+}
 /**
  * Result of processing a SQL file.
  */
@@ -1385,6 +2132,19 @@ interface ProcessResult {
 	 */
 	durationMs?: number;
 }
+export declare class TemplatesNamespace {
+	#private;
+	constructor(state: ContextState);
+	/**
+	 * Render a template file without executing.
+	 *
+	 * @example
+	 * ```typescript
+	 * const result = await ctx.noorm.templates.render('sql/001_users.sql.tmpl')
+	 * ```
+	 */
+	render(filepath: string): Promise<ProcessResult>;
+}
 /**
  * Simple types stored as native JSON values. No encoding tuple needed.
  */
@@ -1547,118 +2307,97 @@ export interface TransferResult {
 	/** Total duration in milliseconds */
 	durationMs: number;
 }
-/**
- * SDK Types.
- *
- * All interfaces and types for the noorm programmatic SDK.
- */
-/**
- * Options for creating an SDK context.
- *
- * @example
- * ```typescript
- * // Basic usage with stored config
- * const ctx = await createContext({ config: 'dev' })
- *
- * // Require test database for safety
- * const ctx = await createContext({
- *     config: 'test',
- *     requireTest: true,
- * })
- *
- * // Allow destructive ops on protected config
- * const ctx = await createContext({
- *     config: 'staging',
- *     allowProtected: true,
- * })
- *
- * // Env-only mode (CI/CD) - no stored config needed
- * // Requires NOORM_CONNECTION_DIALECT and NOORM_CONNECTION_DATABASE
- * const ctx = await createContext()
- *
- * // Override stored config via NOORM_* env vars
- * // NOORM_CONNECTION_HOST=override.host
- * const ctx = await createContext({ config: 'prod' })
- * ```
- */
-export interface CreateContextOptions {
+export declare class TransferNamespace {
+	#private;
+	constructor(state: ContextState);
 	/**
-	 * Config name from state.
+	 * Transfer data to a destination database.
 	 *
-	 * If omitted:
-	 * - Uses `NOORM_CONFIG` env var if set
-	 * - Falls back to env-only mode if `NOORM_CONNECTION_DIALECT`
-	 *   and `NOORM_CONNECTION_DATABASE` are set
+	 * @example
+	 * ```typescript
+	 * const [result, err] = await ctx.noorm.transfer.to(destConfig, {
+	 *     tables: ['users', 'posts'],
+	 *     onConflict: 'skip',
+	 * })
+	 * ```
 	 */
-	config?: string;
-	/** Project root directory. Defaults to process.cwd() */
-	projectRoot?: string;
-	/** Refuse if config.isTest !== true. Default: false */
-	requireTest?: boolean;
-	/** Allow destructive ops on protected configs. Default: false */
-	allowProtected?: boolean;
-	/** Stage name for stage defaults (from settings.yml) */
-	stage?: string;
-}
-/**
- * Options for build operations.
- */
-export interface BuildOptions {
-	/** Skip checksum checks, rebuild everything. Default: false */
-	force?: boolean;
-}
-/**
- * Options for exporting a table to a .dt file.
- *
- * Connection details (db, dialect) come from the context automatically.
- *
- * @example
- * ```typescript
- * const [result, err] = await ctx.exportTable('users', './exports/users.dtz', {
- *     passphrase: 'secret',
- *     batchSize: 5000,
- * });
- * ```
- */
-export interface ExportOptions {
-	/** Passphrase for .dtzx encryption. */
-	passphrase?: string;
-	/** Schema/namespace (e.g., 'public' for PostgreSQL). */
-	schema?: string;
-	/** Rows per batch. Default: 1000. */
-	batchSize?: number;
+	to(destConfig: Config, options?: TransferOptions): Promise<[
+		TransferResult | null,
+		Error | null
+	]>;
+	/**
+	 * Generate a transfer plan without executing.
+	 *
+	 * @example
+	 * ```typescript
+	 * const [plan, err] = await ctx.noorm.transfer.plan(destConfig)
+	 * ```
+	 */
+	plan(destConfig: Config, options?: TransferOptions): Promise<[
+		TransferPlan | null,
+		Error | null
+	]>;
 }
-/**
- * Options for importing a .dt file into the database.
- *
- * Connection details (db, dialect) come from the context automatically.
- *
- * @example
- * ```typescript
- * const [result, err] = await ctx.importFile('./exports/users.dtz', {
- *     onConflict: 'skip',
- *     truncate: true,
- * });
- * ```
- */
-export interface ImportOptions {
-	/** Passphrase for .dtzx decryption. */
-	passphrase?: string;
-	/** Rows per batch. Default: 1000. */
-	batchSize?: number;
-	/** Conflict strategy. Default: 'fail'. */
-	onConflict?: "fail" | "skip" | "update" | "replace";
-	/** Truncate target table before import. Default: false. */
-	truncate?: boolean;
+export declare class DtNamespace {
+	#private;
+	constructor(state: ContextState);
+	/**
+	 * Export a table to a .dt file.
+	 *
+	 * @example
+	 * ```typescript
+	 * const [result, err] = await ctx.noorm.dt.exportTable('users', './exports/users.dtz')
+	 * ```
+	 */
+	exportTable(tableName: string, filepath: string, options?: ExportOptions): Promise<[
+		{
+			rowsWritten: number;
+			bytesWritten: number;
+		} | null,
+		Error | null
+	]>;
+	/**
+	 * Import a .dt file into the connected database.
+	 *
+	 * @example
+	 * ```typescript
+	 * const [result, err] = await ctx.noorm.dt.importFile('./exports/users.dtz', {
+	 *     onConflict: 'skip',
+	 * })
+	 * ```
+	 */
+	importFile(filepath: string, options?: ImportOptions): Promise<[
+		{
+			rowsImported: number;
+			rowsSkipped: number;
+		} | null,
+		Error | null
+	]>;
 }
-export interface ContextState {
-	connection: ConnectionResult | null;
-	config: Config;
-	settings: Settings;
-	identity: Identity;
-	options: CreateContextOptions;
-	projectRoot: string;
-	changeManager: ChangeManager | null;
+export declare class UtilsNamespace {
+	#private;
+	constructor(state: ContextState);
+	/**
+	 * Compute SHA-256 checksum for a file.
+	 *
+	 * @example
+	 * ```typescript
+	 * const checksum = await ctx.noorm.utils.checksum('sql/001_users.sql')
+	 * ```
+	 */
+	checksum(filepath: string): Promise<string>;
+	/**
+	 * Tests if the connection can be established.
+	 *
+	 * @example
+	 * ```typescript
+	 * const result = await ctx.noorm.utils.testConnection()
+	 * ```
+	 */
+	testConnection(): Promise<{
+		ok: boolean;
+		error?: string;
+	}>;
 }
 export type Events<Shape> = keyof Shape;
 declare namespace ObserverEngine {
@@ -2334,62 +3073,12 @@ export interface UpdateEvents {
 		version: string;
 		reason: "user-denied" | "user-deferred";
 	};
-	"global-settings:loaded": {
-		settings: GlobalSettings;
-	};
-	"global-settings:updated": {
-		key: string;
-		value: unknown;
-	};
-}
-/**
- * Vault event types.
- *
- * All events emitted by the vault module. These are merged into
- * NoormEvents via the VaultEvents interface.
- */
-/**
- * Vault events for observer integration.
- *
- * Events follow the naming convention `vault:{operation}`.
- */
-export interface VaultEvents {
-	/** Vault was initialized for the first time */
-	"vault:initialized": {
-		identityHash: string;
-	};
-	/** New vault secret was created */
-	"vault:secret:created": {
-		key: string;
-		setBy: string;
-	};
-	/** Existing vault secret was updated */
-	"vault:secret:updated": {
-		key: string;
-		setBy: string;
-	};
-	/** Vault secret was deleted */
-	"vault:secret:deleted": {
-		key: string;
-	};
-	/** Vault key was propagated to a user */
-	"vault:propagated": {
-		toIdentityHash: string;
-		toEmail: string;
-	};
-	/** Vault copy operation started */
-	"vault:copy:starting": {
-		source: string;
-		destination: string;
-		keys: "all" | number;
+	"global-settings:loaded": {
+		settings: GlobalSettings;
 	};
-	/** Vault copy operation completed */
-	"vault:copy:completed": {
-		source: string;
-		destination: string;
-		copied: number;
-		skipped: number;
-		errors: number;
+	"global-settings:updated": {
+		key: string;
+		value: unknown;
 	};
 }
 /**
@@ -2796,18 +3485,17 @@ export type NoormEventNames = Events<NoormEvents>;
 /**
  * Noorm-specific operations accessed via ctx.noorm.
  *
- * All database management operations — schema, changes, locks,
- * runner, explore, transfer, DT — live here. The shared ContextState
- * keeps connection state in sync with the parent Context.
+ * Domain-aligned sub-namespaces mirror the TUI home screen:
+ * changes, run, db, lock, vault, secrets, templates, transfer, dt, utils.
  *
  * @example
  * ```typescript
  * const ctx = await createContext({ config: 'dev' })
  * await ctx.connect()
  *
- * await ctx.noorm.build()
- * await ctx.noorm.fastForward()
- * const tables = await ctx.noorm.listTables()
+ * await ctx.noorm.run.build()
+ * await ctx.noorm.changes.ff()
+ * const tables = await ctx.noorm.db.listTables()
  * ```
  */
 export declare class NoormOps {
@@ -2817,299 +3505,16 @@ export declare class NoormOps {
 	get settings(): Settings;
 	get identity(): Identity;
 	get observer(): ObserverEngine<NoormEvents>;
-	/**
-	 * List all tables in the database.
-	 *
-	 * @example
-	 * ```typescript
-	 * const tables = await ctx.noorm.listTables()
-	 * ```
-	 */
-	listTables(): Promise<TableSummary[]>;
-	/**
-	 * Get detailed information about a table.
-	 *
-	 * @example
-	 * ```typescript
-	 * const detail = await ctx.noorm.describeTable('users')
-	 * ```
-	 */
-	describeTable(name: string, schema?: string): Promise<TableDetail | null>;
-	/**
-	 * Get database overview with counts of all object types.
-	 *
-	 * @example
-	 * ```typescript
-	 * const overview = await ctx.noorm.overview()
-	 * ```
-	 */
-	overview(): Promise<ExploreOverview>;
-	/**
-	 * Wipe all data, keeping the schema intact.
-	 *
-	 * @example
-	 * ```typescript
-	 * const result = await ctx.noorm.truncate()
-	 * ```
-	 */
-	truncate(): Promise<TruncateResult>;
-	/**
-	 * Drop all database objects except noorm tracking tables.
-	 *
-	 * @example
-	 * ```typescript
-	 * const result = await ctx.noorm.teardown()
-	 * ```
-	 */
-	teardown(): Promise<TeardownResult>;
-	/**
-	 * Execute all SQL files in the schema directory.
-	 *
-	 * @example
-	 * ```typescript
-	 * const result = await ctx.noorm.build({ force: true })
-	 * ```
-	 */
-	build(options?: BuildOptions): Promise<BatchResult>;
-	/**
-	 * Full rebuild: teardown + build.
-	 *
-	 * @example
-	 * ```typescript
-	 * await ctx.noorm.reset()
-	 * ```
-	 */
-	reset(): Promise<void>;
-	/**
-	 * Execute a single SQL file.
-	 *
-	 * @example
-	 * ```typescript
-	 * await ctx.noorm.runFile('seeds/test-data.sql')
-	 * ```
-	 */
-	runFile(filepath: string, options?: RunOptions): Promise<FileResult>;
-	/**
-	 * Execute multiple SQL files sequentially.
-	 *
-	 * @example
-	 * ```typescript
-	 * await ctx.noorm.runFiles(['functions/utils.sql', 'triggers/audit.sql'])
-	 * ```
-	 */
-	runFiles(filepaths: string[], options?: RunOptions): Promise<BatchResult>;
-	/**
-	 * Execute all SQL files in a directory.
-	 *
-	 * @example
-	 * ```typescript
-	 * await ctx.noorm.runDir('seeds/')
-	 * ```
-	 */
-	runDir(dirpath: string, options?: RunOptions): Promise<BatchResult>;
-	/**
-	 * Apply a specific change.
-	 *
-	 * @example
-	 * ```typescript
-	 * const result = await ctx.noorm.applyChange('2024-01-15-add-users')
-	 * ```
-	 */
-	applyChange(name: string, options?: ChangeOptions): Promise<ChangeResult>;
-	/**
-	 * Revert a specific change.
-	 *
-	 * @example
-	 * ```typescript
-	 * const result = await ctx.noorm.revertChange('2024-01-15-add-users')
-	 * ```
-	 */
-	revertChange(name: string, options?: ChangeOptions): Promise<ChangeResult>;
-	/**
-	 * Apply all pending changes.
-	 *
-	 * @example
-	 * ```typescript
-	 * const result = await ctx.noorm.fastForward()
-	 * ```
-	 */
-	fastForward(): Promise<BatchChangeResult>;
-	/**
-	 * Get status of all changes.
-	 *
-	 * @example
-	 * ```typescript
-	 * const changes = await ctx.noorm.getChangeStatus()
-	 * ```
-	 */
-	getChangeStatus(): Promise<ChangeListItem[]>;
-	/**
-	 * Get only pending changes.
-	 *
-	 * @example
-	 * ```typescript
-	 * const pending = await ctx.noorm.getPendingChanges()
-	 * ```
-	 */
-	getPendingChanges(): Promise<ChangeListItem[]>;
-	/**
-	 * Get a config-scoped secret.
-	 *
-	 * @example
-	 * ```typescript
-	 * const apiKey = ctx.noorm.getSecret('API_KEY')
-	 * ```
-	 */
-	getSecret(key: string): string | undefined;
-	/**
-	 * Acquire a database lock.
-	 *
-	 * @example
-	 * ```typescript
-	 * const lock = await ctx.noorm.acquireLock({ timeout: 60000 })
-	 * ```
-	 */
-	acquireLock(options?: LockOptions$1): Promise<Lock$1>;
-	/**
-	 * Release the current lock.
-	 *
-	 * @example
-	 * ```typescript
-	 * await ctx.noorm.releaseLock()
-	 * ```
-	 */
-	releaseLock(): Promise<void>;
-	/**
-	 * Get current lock status.
-	 *
-	 * @example
-	 * ```typescript
-	 * const status = await ctx.noorm.getLockStatus()
-	 * ```
-	 */
-	getLockStatus(): Promise<LockStatus>;
-	/**
-	 * Execute an operation with automatic lock acquisition and release.
-	 *
-	 * @example
-	 * ```typescript
-	 * await ctx.noorm.withLock(async () => {
-	 *     await ctx.noorm.build()
-	 *     await ctx.noorm.fastForward()
-	 * })
-	 * ```
-	 */
-	withLock<T>(fn: () => Promise<T>, options?: LockOptions$1): Promise<T>;
-	/**
-	 * Force release any database lock regardless of ownership.
-	 *
-	 * @example
-	 * ```typescript
-	 * await ctx.noorm.forceReleaseLock()
-	 * ```
-	 */
-	forceReleaseLock(): Promise<boolean>;
-	/**
-	 * Render a template file without executing.
-	 *
-	 * @example
-	 * ```typescript
-	 * const result = await ctx.noorm.renderTemplate('sql/001_users.sql.tmpl')
-	 * ```
-	 */
-	renderTemplate(filepath: string): Promise<ProcessResult>;
-	/**
-	 * Get execution history.
-	 *
-	 * @example
-	 * ```typescript
-	 * const history = await ctx.noorm.getHistory(10)
-	 * ```
-	 */
-	getHistory(limit?: number): Promise<ChangeHistoryRecord[]>;
-	/**
-	 * Compute SHA-256 checksum for a file.
-	 *
-	 * @example
-	 * ```typescript
-	 * const checksum = await ctx.noorm.computeChecksum('sql/001_users.sql')
-	 * ```
-	 */
-	computeChecksum(filepath: string): Promise<string>;
-	/**
-	 * Tests if the connection can be established.
-	 *
-	 * @example
-	 * ```typescript
-	 * const result = await ctx.noorm.testConnection()
-	 * ```
-	 */
-	testConnection(): Promise<{
-		ok: boolean;
-		error?: string;
-	}>;
-	/**
-	 * Transfer data from this context's database to a destination context.
-	 *
-	 * Both contexts must be connected. Uses each context's config for
-	 * connection management.
-	 *
-	 * @example
-	 * ```typescript
-	 * const [result, err] = await source.noorm.transferTo(dest, {
-	 *     tables: ['users', 'posts'],
-	 *     onConflict: 'skip',
-	 * })
-	 * ```
-	 */
-	transferTo(destConfig: Config, options?: TransferOptions): Promise<[
-		TransferResult | null,
-		Error | null
-	]>;
-	/**
-	 * Generate a transfer plan without executing.
-	 *
-	 * @example
-	 * ```typescript
-	 * const [plan, err] = await source.noorm.transferPlan(destConfig)
-	 * ```
-	 */
-	transferPlan(destConfig: Config, options?: TransferOptions): Promise<[
-		TransferPlan | null,
-		Error | null
-	]>;
-	/**
-	 * Export a table to a .dt file.
-	 *
-	 * @example
-	 * ```typescript
-	 * const [result, err] = await ctx.noorm.exportTable('users', './exports/users.dtz')
-	 * ```
-	 */
-	exportTable(tableName: string, filepath: string, options?: ExportOptions): Promise<[
-		{
-			rowsWritten: number;
-			bytesWritten: number;
-		} | null,
-		Error | null
-	]>;
-	/**
-	 * Import a .dt file into the connected database.
-	 *
-	 * @example
-	 * ```typescript
-	 * const [result, err] = await ctx.noorm.importFile('./exports/users.dtz', {
-	 *     onConflict: 'skip',
-	 * })
-	 * ```
-	 */
-	importFile(filepath: string, options?: ImportOptions): Promise<[
-		{
-			rowsImported: number;
-			rowsSkipped: number;
-		} | null,
-		Error | null
-	]>;
+	get changes(): ChangesNamespace;
+	get run(): RunNamespace;
+	get db(): DbNamespace;
+	get lock(): LockNamespace;
+	get vault(): VaultNamespace;
+	get secrets(): SecretsNamespace;
+	get templates(): TemplatesNamespace;
+	get transfer(): TransferNamespace;
+	get dt(): DtNamespace;
+	get utils(): UtilsNamespace;
 }
 /**
  * SDK Context implementation.
@@ -3129,8 +3534,8 @@ export declare class NoormOps {
  *     .execute()
  *
  * // Noorm operations — under namespace
- * await ctx.noorm.build()
- * await ctx.noorm.fastForward()
+ * await ctx.noorm.run.build()
+ * await ctx.noorm.changes.ff()
  *
  * await ctx.disconnect()
  * ```
@@ -3149,9 +3554,9 @@ export declare class Context<DB = unknown, Procs = object, Funcs = object> {
 	 *
 	 * @example
 	 * ```typescript
-	 * await ctx.noorm.build()
-	 * await ctx.noorm.fastForward()
-	 * const tables = await ctx.noorm.listTables()
+	 * await ctx.noorm.run.build()
+	 * await ctx.noorm.changes.ff()
+	 * const tables = await ctx.noorm.db.listTables()
 	 * ```
 	 */
 	get noorm(): NoormOps;