@happyvertical/smrt-cli 0.53.2 → 0.53.4

package/dist/app/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `@happyvertical/smrt-cli/app` — the application operations behind
+ * `smrt app <operation>`, plus the shared lock, lease, identity, process,
+ * readiness, and portability primitives they are built from.
+ *
+ * Importing this entry has no side effects (unlike the package root, which
+ * runs the CLI).
+ */
+export { type AcquireWriterLeaseOptions, acquireWriterLease, createProviderReadinessProbe, findInstalledPackage, isStaleOperationLock, lockOwnerPid, type OperationLock, PROVIDER_READINESS_SETTINGS, type ProviderReadinessOptions, processExists, RECLAIM_MUTEX_FILE, type ReadinessComponent, type ReadinessContext, type ReclaimOutcome, readActiveWriterLease, reclaimStaleRecord, resolveReadinessModule, type WriterLease, type WriterLeaseRecord, withOperationLock, } from '@happyvertical/smrt-app-runtime';
+export { APP_COMMANDS, APP_RECOVERY, type AppErrorEnvelope, errorEnvelope, type RunAppCommandOptions, renderAppHelp, runAppCommand, } from './cli.js';
+export { AppCommandError, redactSecrets } from './errors.js';
+export { type ApplicationStateRootOptions, assertExternalArtifactPath, type ExternalArtifactPathOptions, type FingerprintRuntime, prepareApplicationStateRoot, type ResolveApplicationIdOptions, resolveApplicationId, resolveApplicationStateRoot, runtimeConfigurationFingerprint, type StateCustodyOptions, } from './identity.js';
+export { launchVite, prepareMigration, resolveViteEntry, runWorker, ViteLauncherError, validateMcpAppsIfPresent, type WorkerKind, } from './launchers.js';
+export { APP_OPERATIONS, type AppOperation, type PortabilityAdapter, runApplicationOperation, } from './operations.js';
+export { type ExportResult, executeImportPlan, exportApplication, type ImportExecutor, type ImportResult, importApplication, importedRowsMatchBundle, type LogicalExportBundle, type ManifestTable, manifestTables, type PlannedImportTable, type PortabilityContext, type PortabilityRuntime, planImportTables, serializeExportBundle, validateImportBundle, } from './portability.js';
+export { ASSET_MANIFEST_SCHEMA_VERSION, type AssetBundle, type AssetImportJournal, type AssetManifestEntry, type AssetPayload, AssetPortabilityError, assertAssetRoot, bundleContentDigest, collectFilesystemAssets, digestBytes, finishFilesystemAssets, hasCommittedImportJournal, MAX_ASSET_BYTES, MAX_ASSET_COUNT, MAX_BUNDLE_BYTES, MAX_TOTAL_ASSET_BYTES, markFilesystemAssetsCommitted, type PortableRow, type PortableTable, publishFilesystemAssets, readSensitiveBundle, recoverFilesystemAssets, rollbackFilesystemAssets, type StagedAssets, stageFilesystemAssets, type VerifiedAsset, type VerifiedAssets, verifyFilesystemAssets, verifyPublishedFilesystemAssets, } from './portability-assets.js';
+export { type ApplicationProcessRecord, checkOwnedProcess, matchesApplicationProcess, type OwnedProcessState, readOwnedProcess, sendTerminationSignal, verifyOwnedProcess, WEB_LAUNCHER_NAME, writeProcessRecord, } from './process-record.js';
+export { type AppCommandDependencies, type AppCommandIo, type AppContext, type CommandRunner, cliExecutablePath, type RunOptions, type RuntimeEnvironment, runtimeEnvironment, webLauncherPath, } from './runtime.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,KAAK,yBAAyB,EAC9B,kBAAkB,EAClB,4BAA4B,EAC5B,oBAAoB,EACpB,oBAAoB,EACpB,YAAY,EACZ,KAAK,aAAa,EAClB,2BAA2B,EAC3B,KAAK,wBAAwB,EAC7B,aAAa,EACb,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,iBAAiB,GAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,KAAK,gBAAgB,EACrB,aAAa,EACb,KAAK,oBAAoB,EACzB,aAAa,EACb,aAAa,GACd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EACL,KAAK,2BAA2B,EAChC,0BAA0B,EAC1B,KAAK,2BAA2B,EAChC,KAAK,kBAAkB,EACvB,2BAA2B,EAC3B,KAAK,2BAA2B,EAChC,oBAAoB,EACpB,2BAA2B,EAC3B,+BAA+B,EAC/B,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,iBAAiB,EACjB,wBAAwB,EACxB,KAAK,UAAU,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,YAAY,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,6BAA6B,EAC7B,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,WAAW,EACX,sBAAsB,EACtB,yBAAyB,EACzB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,6BAA6B,EAC7B,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,KAAK,YAAY,EACjB,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,sBAAsB,EACtB,+BAA+B,GAChC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,KAAK,wBAAwB,EAC7B,iBAAiB,EACjB,yBAAyB,EACzB,KAAK,iBAAiB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,kBAAkB,EAClB,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/app/launchers.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Process wrappers: explicit schema preparation (`migrate`), deployed job
+ * workers (`worker`), and the Vite launcher (`dev`, `build`, `vite`).
+ *
+ * Ported from the template's `scripts/smrt-prepare-migration.mjs`,
+ * `scripts/smrt-worker.mjs`, `scripts/smrt-vite.mjs`, and
+ * `scripts/smrt-mcp-apps.mjs`.
+ */
+import { type AppContext } from './runtime.js';
+/**
+ * Prepare the schema explicitly: under the operation lock, refuse while a
+ * local writer is live, establish local storage custody without creating
+ * schema or bootstrap records, then run `smrt db:migrate`.
+ */
+export declare function prepareMigration(context: AppContext): Promise<number>;
+/** Worker kinds. `task` when omitted; anything else is a usage error. */
+export type WorkerKind = 'task' | 'schedule';
+/** Parse `smrt app worker [kind]`, refusing anything but `task`/`schedule`. */
+export declare function parseWorkerKind(args: readonly string[]): WorkerKind;
+/**
+ * Start a deployed job worker. Resolves once the runner is started; the
+ * process stays alive until SIGINT/SIGTERM closes the runtime.
+ */
+export declare function runWorker(context: AppContext, args: string[]): Promise<number>;
+/** Failure of the Vite launcher; rendered as `s-m-r-t Vite launcher: …`. */
+export declare class ViteLauncherError extends Error {
+}
+/** Resolve the application's installed Vite CLI entry, refusing unsafe paths. */
+export declare function resolveViteEntry(sourceRoot: string): string;
+/**
+ * Run the application's Vite CLI in this process with `args` verbatim. The
+ * caller has already loaded `.env` without overriding the shell.
+ */
+export declare function launchVite(context: AppContext, args: string[]): Promise<number>;
+/**
+ * Validate opt-in portable MCP Apps metadata (`./mcp-apps`) when present.
+ * Returns the exit code; findings go to stderr.
+ */
+export declare function validateMcpAppsIfPresent(context: AppContext): Promise<number>;
+//# sourceMappingURL=launchers.d.ts.map

package/dist/app/launchers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launchers.d.ts","sourceRoot":"","sources":["../../src/app/launchers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH,OAAO,EAAE,KAAK,UAAU,EAAqB,MAAM,cAAc,CAAC;AAElE;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAyC3E;AAED,yEAAyE;AACzE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;AAI7C,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAOnE;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,MAAM,CAAC,CA2GjB;AAED,4EAA4E;AAC5E,qBAAa,iBAAkB,SAAQ,KAAK;CAAG;AAE/C,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAyC3D;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,MAAM,CAAC,CAkBjB"}

package/dist/app/operations.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Local/deployed application operations: install, setup, recover, start,
+ * stop, doctor, open, backup, export, import.
+ *
+ * Ported from the template's `scripts/smrt-app.mjs`. Output JSON, exit
+ * codes, state files, and environment variables are unchanged so the
+ * template's `pnpm app:*` scripts can become `smrt app <operation>`.
+ */
+import type { ResolvedApplicationRuntime } from '@happyvertical/smrt-config';
+import type { ExportResult, ImportResult, PortabilityContext } from './portability.js';
+import { type AppContext } from './runtime.js';
+/** Operations implemented by this module. */
+export declare const APP_OPERATIONS: readonly ["install", "setup", "recover", "start", "stop", "doctor", "open", "backup", "export", "import"];
+/** One of {@link APP_OPERATIONS}. */
+export type AppOperation = (typeof APP_OPERATIONS)[number];
+/** Throw unless the configured profile is `local`. */
+export declare function assertLocalOperation(context: AppContext, operation: string): Promise<ResolvedApplicationRuntime>;
+/** Portability adapter contract (built-in or an application override). */
+export interface PortabilityAdapter {
+    exportApplication(context: PortabilityContext): Promise<ExportResult>;
+    importApplication(context: PortabilityContext): Promise<ImportResult>;
+}
+/**
+ * Run one application operation. Resolves to the process exit code; throws
+ * on failure (the caller renders the error envelope).
+ */
+export declare function runApplicationOperation(context: AppContext, operation: AppOperation, args: string[]): Promise<number>;
+//# sourceMappingURL=operations.d.ts.map

package/dist/app/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/app/operations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAuBH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAO7E,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAO1B,OAAO,EACL,KAAK,UAAU,EAIhB,MAAM,cAAc,CAAC;AAEtB,6CAA6C;AAC7C,eAAO,MAAM,cAAc,2GAWjB,CAAC;AAEX,qCAAqC;AACrC,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AA+G3D,sDAAsD;AACtD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,UAAU,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,0BAA0B,CAAC,CAQrC;AAijBD,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACtE,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACvE;AAkFD;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,UAAU,EACnB,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,MAAM,CAAC,CA+DjB"}

package/dist/app/portability-assets.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Filesystem asset portability for logical export/import bundles.
+ *
+ * Ported unchanged from the template's `scripts/smrt-portability-assets.mjs`:
+ * the bundle format, limits, sanitized failure codes, staging journal, and
+ * crash-recovery rules are a persisted contract.
+ */
+export declare const ASSET_MANIFEST_SCHEMA_VERSION = 1;
+export declare const MAX_ASSET_COUNT = 1000;
+export declare const MAX_ASSET_BYTES: number;
+export declare const MAX_TOTAL_ASSET_BYTES: number;
+export declare const MAX_BUNDLE_BYTES: number;
+/** Row shape of an exported table. */
+export type PortableRow = Record<string, unknown>;
+/** Exported table as it appears in a bundle. */
+export interface PortableTable {
+    name: string;
+    columns: string[];
+    rows: PortableRow[];
+}
+/** One asset entry of the bundle manifest. */
+export interface AssetManifestEntry {
+    key: string;
+    byteLength: number;
+    contentDigest: string;
+    payloadPath: string;
+}
+/** One embedded asset payload. */
+export interface AssetPayload {
+    path: string;
+    encoding: 'base64';
+    data: string;
+}
+/** Asset section of a bundle. */
+export interface AssetBundle {
+    schemaVersion: number;
+    adapter: 'filesystem';
+    entries: AssetManifestEntry[];
+    payloads: AssetPayload[];
+}
+/** Verified asset ready to stage. */
+export interface VerifiedAsset {
+    key: string;
+    bytes: Buffer;
+    contentDigest: string;
+    relativePath: string;
+}
+/** Result of {@link verifyFilesystemAssets}. */
+export interface VerifiedAssets {
+    root: string | null;
+    entries: VerifiedAsset[];
+}
+/** Persisted asset-import journal. */
+export interface AssetImportJournal {
+    schemaVersion: 1;
+    application: string;
+    bundleDigest: string;
+    assetRoot: string;
+    stageRoot: string;
+    phase: 'staging' | 'publishing' | 'published';
+    rootExisted: boolean;
+    entries: Array<{
+        relativePath: string;
+        contentDigest: string;
+    }>;
+    /**
+     * Set once the database transaction for this bundle committed (additive;
+     * journals written by the template scripts never carry it, and those
+     * scripts ignore it). Recovery treats it as proof the rows are this
+     * bundle's; without it, recovery verifies row content instead.
+     */
+    committedAt?: string;
+}
+/** A staged import: journal path plus its in-memory journal. */
+export interface StagedAssets {
+    path: string;
+    journal: AssetImportJournal;
+}
+/** Sanitized asset-portability failure with a stable kebab-case `code`. */
+export declare class AssetPortabilityError extends Error {
+    readonly code: string;
+    constructor(code: string);
+}
+/** `sha256:<hex>` digest of bytes. */
+export declare function digestBytes(value: string | Buffer): string;
+/** Validate an asset root: absolute, outside the source tree, real directory. */
+export declare function assertAssetRoot({ sourceRoot, assetRoot, allowMissing, }: {
+    sourceRoot: string;
+    assetRoot: unknown;
+    allowMissing?: boolean;
+}): string;
+/** Replace provider paths with logical keys while collecting verified payloads. */
+export declare function collectFilesystemAssets({ tables, sourceRoot, assetRoot, onSourceOpened, }: {
+    tables: PortableTable[];
+    sourceRoot: string;
+    assetRoot: string | null | undefined;
+    onSourceOpened?: () => void;
+}): AssetBundle;
+/** Validate every manifest/payload relationship and hydrate destination URIs. */
+export declare function verifyFilesystemAssets({ assetBundle, tables, sourceRoot, assetRoot, }: {
+    assetBundle: unknown;
+    tables: PortableTable[];
+    sourceRoot: string;
+    assetRoot: string | null | undefined;
+}): VerifiedAssets;
+/** Stage verified bytes without publishing anything into the destination root. */
+export declare function stageFilesystemAssets({ verified, stateRoot, appId, bundleDigest, }: {
+    verified: VerifiedAssets;
+    stateRoot: string;
+    appId: string;
+    bundleDigest: string;
+}): StagedAssets | null;
+/** Publish the complete verified tree with one rename that never follows the target. */
+export declare function publishFilesystemAssets(staged: StagedAssets | null, options?: {
+    beforeRename?: () => void;
+}): void;
+/** Re-verify the published tree against the staged journal. */
+export declare function verifyPublishedFilesystemAssets(staged: StagedAssets | null): void;
+/** Record in the journal that this bundle's database transaction committed. */
+export declare function markFilesystemAssetsCommitted(staged: StagedAssets | null): void;
+/**
+ * True when an import journal for `appId` exists, belongs to `bundleDigest`,
+ * and records a committed database transaction.
+ */
+export declare function hasCommittedImportJournal({ stateRoot, appId, bundleDigest, }: {
+    stateRoot: string;
+    appId: string;
+    bundleDigest: string;
+}): boolean;
+/** Verify the published tree and drop the journal. */
+export declare function finishFilesystemAssets(staged: StagedAssets | null): void;
+/** Undo a staged or published import, restoring an empty target. */
+export declare function rollbackFilesystemAssets(staged: StagedAssets | null): void;
+/** Recover a prior crash only when the same bundle and exact target state prove ownership. */
+export declare function recoverFilesystemAssets({ stateRoot, appId, bundleDigest, assetRoot, targetState, }: {
+    stateRoot: string;
+    appId: string;
+    bundleDigest: string;
+    assetRoot: string | null;
+    targetState: 'empty' | 'complete' | 'dirty';
+}): 'none' | 'complete' | 'retry';
+/**
+ * Read an import bundle only when it is a private (mode 0600), regular,
+ * non-symlinked file that does not change while it is read.
+ */
+export declare function readSensitiveBundle(path: string, options?: {
+    onOpened?: () => void;
+}): string;
+/** Digest identifying one serialized bundle for crash recovery. */
+export declare function bundleContentDigest(serialized: string): string;
+//# sourceMappingURL=portability-assets.d.ts.map

package/dist/app/portability-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portability-assets.d.ts","sourceRoot":"","sources":["../../src/app/portability-assets.ts"],"names":[],"mappings":"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"}

package/dist/app/portability.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Logical application export/import (schemaVersion 2 bundles).
+ *
+ * Ported unchanged from the template's `scripts/smrt-portability.mjs`: the
+ * bundle shape, non-portable table/column rules, parent-first import plan,
+ * empty-target rule, and asset staging/recovery are a persisted contract.
+ */
+import type { DatabaseInterface } from '@happyvertical/sql';
+import { type AssetBundle, type PortableRow, type PortableTable } from './portability-assets.js';
+/** Column definition fields the import planner reads from the manifest. */
+export interface PortableColumnDefinition {
+    primaryKey?: boolean;
+    notNull?: boolean;
+    foreignKey?: {
+        table?: string;
+    };
+    [key: string]: unknown;
+}
+/** Manifest-derived application table. */
+export interface ManifestTable {
+    name: string;
+    columns: string[];
+    columnDefinitions: Record<string, PortableColumnDefinition>;
+    foreignKeys: Array<{
+        column: string;
+        referencesTable: string;
+    }>;
+    primaryKeys: string[];
+}
+/** Planned import step; `deferredColumns` are filled by a later UPDATE. */
+export interface PlannedImportTable extends ManifestTable {
+    deferredColumns: Set<string>;
+}
+/** A schemaVersion-2 logical bundle. */
+export interface LogicalExportBundle {
+    schemaVersion: 2;
+    application: string;
+    profile: string;
+    exportedAt: string;
+    tables: PortableTable[];
+    assets: AssetBundle;
+}
+/** Runtime selection the adapter needs. */
+export interface PortabilityRuntime {
+    profile: string;
+    providers: {
+        database: {
+            engine: string;
+        };
+    };
+}
+/** Context for {@link exportApplication} / {@link importApplication}. */
+export interface PortabilityContext {
+    appId: string;
+    sourceRoot: string;
+    stateRoot: string;
+    runtime: PortabilityRuntime;
+    env: Record<string, string | undefined>;
+    paths: {
+        root: string;
+        assets: string;
+    } | null;
+    assetRoot: string | null;
+    path?: string;
+    /** Test seam: observe import phases (`assets-staged`, …). */
+    onImportPhase?: (phase: string) => Promise<void> | void;
+    /** Test seam: replace the database opener. */
+    openDatabase?: (options: Record<string, unknown>) => Promise<DatabaseInterface>;
+}
+/** Read the application tables from `<sourceRoot>/.smrt/manifest.json`. */
+export declare function manifestTables(sourceRoot: string): ManifestTable[];
+/** Parent-first insertion plan with nullable cycle edges deferred to updates. */
+export declare function planImportTables(tables: ManifestTable[]): PlannedImportTable[];
+/** Reject bundles that do not exactly match the generated schema. */
+export declare function validateImportBundle(bundle: {
+    tables: unknown[];
+}, expected: Map<string, Pick<ManifestTable, 'name' | 'columns'>>): void;
+/** JSON cannot represent SQLite's lossless BigInt results; decimal strings do. */
+export declare function serializeExportBundle(bundle: unknown): string;
+/** Result reported by `smrt app export`. */
+export interface ExportResult {
+    path: string;
+    tableCount: number;
+    assetsIncluded: true;
+    assetCount: number;
+}
+/** Write a logical export bundle without replacing an existing file. */
+export declare function exportApplication(context: PortabilityContext): Promise<ExportResult>;
+/** Minimal query surface the import plan needs (a transaction handle). */
+export interface ImportExecutor {
+    query(sql: string, ...params: unknown[]): Promise<{
+        rows: Array<Record<string, unknown>>;
+    }>;
+}
+/** Execute a prevalidated parent-first import against one database transaction. */
+export declare function executeImportPlan(tx: ImportExecutor, plan: PlannedImportTable[], exportedByName: Map<string, {
+    rows: PortableRow[];
+}>): Promise<number>;
+/**
+ * True when every planned table holds exactly the bundle's rows (as a
+ * multiset over the bundle's columns). This is the evidence an interrupted
+ * import's recovery needs when no commit marker was recorded: matching
+ * per-table counts alone do not prove the rows are this bundle's.
+ */
+export declare function importedRowsMatchBundle(db: ImportExecutor, plan: PlannedImportTable[], exportedByName: Map<string, {
+    rows: PortableRow[];
+}>): Promise<boolean>;
+/** Result reported by `smrt app import`. */
+export interface ImportResult {
+    path: string;
+    rowCount: number;
+    assetsIncluded: true;
+    assetCount: number;
+}
+/** Import a logical bundle into an empty application database. */
+export declare function importApplication(context: PortabilityContext): Promise<ImportResult>;
+//# sourceMappingURL=portability.d.ts.map

package/dist/app/portability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portability.d.ts","sourceRoot":"","sources":["../../src/app/portability.ts"],"names":[],"mappings":"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"}

package/dist/app/process-record.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Managed web-process record (`<state>/app.pid`).
+ *
+ * Ported from the template's `scripts/smrt-process.mjs`. A recorded pid is
+ * only trusted when the live process's command line proves it is the web
+ * launcher with this record's instance nonce, so a recycled pid is never
+ * signalled.
+ */
+/** Persisted web-process identity. */
+export interface ApplicationProcessRecord {
+    pid: number;
+    instance: string;
+}
+/** File name of the web launcher; part of the process-identity proof. */
+export declare const WEB_LAUNCHER_NAME = "smrt-web.mjs";
+/** Write the private (mode 0600) process record. */
+export declare function writeProcessRecord(path: string, record: ApplicationProcessRecord): void;
+/**
+ * Send SIGTERM. Returns `false` when the process had already exited; any
+ * other failure (e.g. EPERM) is rethrown.
+ */
+export declare function sendTerminationSignal(pid: number, killProcess?: (pid: number, signal: NodeJS.Signals) => unknown): boolean;
+/**
+ * True when `command` is exactly the web launcher started with this record's
+ * nonce: the final argument is `--smrt-instance=<instance>` and the argument
+ * before it is a path whose basename is `smrt-web.mjs` (the CLI's
+ * `bin/smrt-web.mjs`, or the template's `scripts/smrt-web.mjs`). Substring
+ * matches such as `evil-smrt-web.mjs` or a nonce with a suffix are rejected.
+ */
+export declare function matchesApplicationProcess(record: Pick<ApplicationProcessRecord, 'instance'>, command: unknown): boolean;
+/** Result of re-checking a recorded web process. */
+export type OwnedProcessState = 
+/** Live and provably the recorded launcher. */
+'owned'
+/** The pid no longer exists. */
+ | 'gone'
+/** The pid is live but runs something else (recycled pid). */
+ | 'mismatched'
+/** The pid is live but its command line could not be read. */
+ | 'unverifiable';
+/**
+ * Re-check `record` against the live process table. Only `gone` and
+ * `mismatched` justify dropping the record; `unverifiable` (the process
+ * query failed or returned nothing) must keep it and must not signal.
+ */
+export declare function checkOwnedProcess(record: ApplicationProcessRecord): OwnedProcessState;
+/** True only when {@link checkOwnedProcess} proves the record still owned. */
+export declare function verifyOwnedProcess(record: ApplicationProcessRecord): boolean;
+/**
+ * Return the recorded web process when it is live and provably ours;
+ * otherwise remove the stale record and return `null`.
+ */
+export declare function readOwnedProcess(path: string): ApplicationProcessRecord | null;
+//# sourceMappingURL=process-record.d.ts.map

package/dist/app/process-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-record.d.ts","sourceRoot":"","sources":["../../src/app/process-record.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,sCAAsC;AACtC,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,yEAAyE;AACzE,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAsBhD,oDAAoD;AACpD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,wBAAwB,GAC/B,IAAI,CAEN;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,OAAsB,GAC3E,OAAO,CAQT;AAWD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,IAAI,CAAC,wBAAwB,EAAE,UAAU,CAAC,EAClD,OAAO,EAAE,OAAO,GACf,OAAO,CAST;AAED,oDAAoD;AACpD,MAAM,MAAM,iBAAiB;AAC3B,+CAA+C;AAC7C,OAAO;AACT,gCAAgC;GAC9B,MAAM;AACR,8DAA8D;GAC5D,YAAY;AACd,8DAA8D;GAC5D,cAAc,CAAC;AAYnB;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,wBAAwB,GAC/B,iBAAiB,CAOnB;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAE5E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GACX,wBAAwB,GAAG,IAAI,CAoCjC"}

package/dist/app/runtime.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Shared per-invocation context for the `smrt app` command group: source
+ * root, application identity, I/O, child-process runners, and the
+ * profile-aware runtime environment.
+ */
+import { type SpawnSyncReturns } from 'node:child_process';
+import type * as AppRuntime from '@happyvertical/smrt-app-runtime';
+import type { ResolvedApplicationRuntime } from '@happyvertical/smrt-config';
+/** Output sinks. Each call receives complete text including the newline. */
+export interface AppCommandIo {
+    stdout(text: string): void;
+    stderr(text: string): void;
+}
+/** Options for a child command run. */
+export interface RunOptions {
+    env?: NodeJS.ProcessEnv;
+    /** Capture stdout/stderr instead of inheriting the terminal. */
+    capture?: boolean;
+    /** Return a failed result instead of throwing. */
+    allowFailure?: boolean;
+    /** Secret-free name used in the failure message. */
+    label?: string;
+    shell?: boolean;
+}
+/** Child-process runner signature. */
+export type CommandRunner = (args: string[], options?: RunOptions) => SpawnSyncReturns<string>;
+/** Replaceable collaborators. Production values are filled in by default. */
+export interface AppCommandDependencies {
+    /** `@happyvertical/smrt-app-runtime` entry points. */
+    runtime: Pick<typeof AppRuntime, 'initializeLocalApplicationRuntime' | 'initializeDeployedApplicationRuntime' | 'prepareLocalDatabaseStorage' | 'resolveLocalRuntimePaths' | 'validateLocalDatabaseStorage'>;
+    /** Resolve the configured runtime after (re)loading `smrt.config`. */
+    resolveRuntime(sourceRoot: string): Promise<ResolvedApplicationRuntime>;
+    /** Run the application's package manager (`pnpm <args>`). */
+    runPackageManager: CommandRunner;
+    /** Run this CLI (`smrt <args>`) as a child process. */
+    runSmrt: CommandRunner;
+    /** Open a URL in the operator's browser. */
+    openBrowser(url: string): void;
+    /** Health probe transport for `start`. */
+    fetch: typeof fetch;
+    /** Delay between readiness polls. */
+    sleep(milliseconds: number): Promise<void>;
+    /** Signal a process (`start` cleanup). */
+    signal(pid: number, signal: NodeJS.Signals): void;
+}
+/** Per-invocation context. */
+export interface AppContext {
+    readonly sourceRoot: string;
+    readonly appId: string;
+    readonly io: AppCommandIo;
+    readonly deps: AppCommandDependencies;
+}
+/** Locate this package's root (`…/smrt-cli`) from the running module. */
+export declare function cliPackageRoot(): string;
+/** Absolute path of the `smrt` executable shipped with this package. */
+export declare function cliExecutablePath(): string;
+/** Absolute path of the web launcher `start` spawns. */
+export declare function webLauncherPath(): string;
+/** Load `<sourceRoot>/.env` without overriding the shell; a missing file is fine. */
+export declare function loadSourceEnvironment(sourceRoot: string): void;
+/** Default package-manager runner: honours a pnpm `npm_execpath`. */
+export declare function createPackageManagerRunner(sourceRoot: string): CommandRunner;
+/** Default self-runner: this package's own `smrt` executable. */
+export declare function createSmrtRunner(sourceRoot: string): CommandRunner;
+/** Default browser opener (`SMRT_OPEN_STUB` writes the URL to a file instead). */
+export declare function createBrowserOpener(sourceRoot: string): (url: string) => void;
+/** Default runtime resolver: reload `smrt.config` without the cache. */
+export declare function resolveConfiguredRuntime(sourceRoot: string): Promise<ResolvedApplicationRuntime>;
+/** Build the default dependency set for `sourceRoot`. */
+export declare function defaultDependencies(sourceRoot: string): Promise<AppCommandDependencies>;
+/** Resolve the application id from `<sourceRoot>/package.json` and `SMRT_APP_ID`. */
+export declare function resolveContextApplicationId(sourceRoot: string): string;
+/** Create or verify the private state root for this invocation. */
+export declare function preparedStateRoot(context: AppContext): string;
+/** Profile-aware child environment, with local storage paths when local. */
+export interface RuntimeEnvironment {
+    env: NodeJS.ProcessEnv;
+    paths: AppRuntime.LocalRuntimePaths | null;
+    assetRoot: string | null;
+}
+/** Compute the environment a web/migration child of this app runs with. */
+export declare function runtimeEnvironment(context: AppContext, runtime: ResolvedApplicationRuntime): RuntimeEnvironment;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/app/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/app/runtime.ts"],"names":[],"mappings":"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"}

package/dist/app.d.ts

@@ -0,0 +1 @@
+export * from './app/index.js';

package/dist/app.js

@@ -0,0 +1,4 @@
+import { A as AppCommandError, C as runtimeEnvironment, D as resolveApplicationId, E as prepareApplicationStateRoot, M as redactSecrets, O as resolveApplicationStateRoot, S as cliExecutablePath, T as assertExternalArtifactPath, _ as launchVite, a as renderAppHelp, b as runWorker, c as runApplicationOperation, d as matchesApplicationProcess, f as readOwnedProcess, g as ViteLauncherError, h as writeProcessRecord, i as errorEnvelope, k as runtimeConfigurationFingerprint, l as WEB_LAUNCHER_NAME, m as verifyOwnedProcess, n as APP_RECOVERY, o as runAppCommand, p as sendTerminationSignal, s as APP_OPERATIONS, t as APP_COMMANDS, u as checkOwnedProcess, v as prepareMigration, w as webLauncherPath, x as validateMcpAppsIfPresent, y as resolveViteEntry } from "./cli-BRFsobey.js";
+import { C as publishFilesystemAssets, D as stageFilesystemAssets, E as rollbackFilesystemAssets, O as verifyFilesystemAssets, S as markFilesystemAssetsCommitted, T as recoverFilesystemAssets, _ as bundleContentDigest, a as manifestTables, b as finishFilesystemAssets, c as serializeExportBundle, d as AssetPortabilityError, f as MAX_ASSET_BYTES, g as assertAssetRoot, h as MAX_TOTAL_ASSET_BYTES, i as importedRowsMatchBundle, k as verifyPublishedFilesystemAssets, l as validateImportBundle, m as MAX_BUNDLE_BYTES, n as exportApplication, o as planImportTables, p as MAX_ASSET_COUNT, r as importApplication, t as executeImportPlan, u as ASSET_MANIFEST_SCHEMA_VERSION, v as collectFilesystemAssets, w as readSensitiveBundle, x as hasCommittedImportJournal, y as digestBytes } from "./portability-DmQWSSXA.js";
+import { PROVIDER_READINESS_SETTINGS, RECLAIM_MUTEX_FILE, acquireWriterLease, createProviderReadinessProbe, findInstalledPackage, isStaleOperationLock, lockOwnerPid, processExists, readActiveWriterLease, reclaimStaleRecord, resolveReadinessModule, withOperationLock } from "@happyvertical/smrt-app-runtime";
+export { APP_COMMANDS, APP_OPERATIONS, APP_RECOVERY, ASSET_MANIFEST_SCHEMA_VERSION, AppCommandError, AssetPortabilityError, MAX_ASSET_BYTES, MAX_ASSET_COUNT, MAX_BUNDLE_BYTES, MAX_TOTAL_ASSET_BYTES, PROVIDER_READINESS_SETTINGS, RECLAIM_MUTEX_FILE, ViteLauncherError, WEB_LAUNCHER_NAME, acquireWriterLease, assertAssetRoot, assertExternalArtifactPath, bundleContentDigest, checkOwnedProcess, cliExecutablePath, collectFilesystemAssets, createProviderReadinessProbe, digestBytes, errorEnvelope, executeImportPlan, exportApplication, findInstalledPackage, finishFilesystemAssets, hasCommittedImportJournal, importApplication, importedRowsMatchBundle, isStaleOperationLock, launchVite, lockOwnerPid, manifestTables, markFilesystemAssetsCommitted, matchesApplicationProcess, planImportTables, prepareApplicationStateRoot, prepareMigration, processExists, publishFilesystemAssets, readActiveWriterLease, readOwnedProcess, readSensitiveBundle, reclaimStaleRecord, recoverFilesystemAssets, redactSecrets, renderAppHelp, resolveApplicationId, resolveApplicationStateRoot, resolveReadinessModule, resolveViteEntry, rollbackFilesystemAssets, runAppCommand, runApplicationOperation, runWorker, runtimeConfigurationFingerprint, runtimeEnvironment, sendTerminationSignal, serializeExportBundle, stageFilesystemAssets, validateImportBundle, validateMcpAppsIfPresent, verifyFilesystemAssets, verifyOwnedProcess, verifyPublishedFilesystemAssets, webLauncherPath, withOperationLock, writeProcessRecord };