@phyzess/pappra 0.1.0-beta.14 → 0.1.0-beta.19

package/dist/cli/commands/host.js

@@ -1,17 +1,28 @@
 import { homedir } from 'node:os';
-import { join, resolve } from 'node:path';
+import { isAbsolute, join, resolve } from 'node:path';
 import { HostIntegrationService } from '../../hosts/integration/service.js';
-import { exportHostPluginBundle } from '../../hosts/integration/bundle-export.js';
+import { exportHostPluginBundle, } from '../../hosts/integration/bundle-export.js';
+import { readPiBootstrapConfig } from '../../hosts/integration/bootstrap-config.js';
+import { readPiRecoveryConfig } from '../../hosts/integration/recovery-config.js';
 import { applyHostMcp, planHostMcp, verifyHostMcp, } from '../../app/host-mcp.js';
 import { probeHost } from '../../app/host-probe.js';
 import { HOST_SUPPORT, isSupportedVersion, } from '../../hosts/integration/support.js';
-import { getPackageInfo } from '../../package-info.js';
-export const hostUsage = 'pappra host <detect|describe|plan|install|verify|bundle|mcp> --host <pi|codex|claude>\n' +
+import { getPackageInfo, getPackageRoot } from '../../package-info.js';
+export const hostUsage = 'pappra host <detect|describe|probe|plan|install|uninstall|verify|bundle|mcp> --host <pi|codex|claude>\n' +
     '  [--host-root <dir>] [--host-version <version>] [--out <dir>]\n' +
-    '  [--mode project-settings|plugin] [--apply] [--json]\n' +
+    '  [--mode project-settings|plugin] [--scope project|user] [--marketplace] [--apply] [--json]\n' +
+    '  probe --host <name> [--host-root <dir>] [--json]\n' +
+    '  uninstall --host <name> [--host-root <dir> | --scope user] [--apply] [--force]\n' +
+    '    --force asserts all host writers are stopped and archives unknown locks; edited assets remain preserved.\n' +
+    '  mcp <plan|install|verify> --host <name> [--host-root <dir>] [--apply] [--json]\n' +
+    '  bundle --host pi --out <new-private-dir> [--bootstrap-config <abs-file> |\n' +
+    '    --recovery-config <abs-file>] [--transition-extension]\n' +
     '\n' +
     'bundle exports a host-native plugin/package directory and never registers it or\n' +
-    'claims host callability.';
+    'claims host callability. Recovery and transition extensions are opt-in Pi bundle\n' +
+    'artifacts; --recovery-config must pin an exact task-local session and binding.\n' +
+    'Exports do not install, trust, load, launch or transfer; native quiescence and\n' +
+    'interactive session takeover remain unsupported.';
 /** Codex only loads lifecycle hooks from its user configuration directory. */
 function codexHome() {
     const configured = process.env['CODEX_HOME'];
@@ -66,8 +77,9 @@ export async function runHostCommand(options, output) {
         }
         if (options.action !== 'plan' &&
             options.action !== 'install' &&
+            options.action !== 'uninstall' &&
             options.action !== 'verify') {
-            output.stderr('pappra host: --scope user is only valid for plan, install, or verify.\n');
+            output.stderr('pappra host: --scope user is only valid for plan, install, uninstall, or verify.\n');
             return 2;
         }
     }
@@ -197,15 +209,109 @@ export async function runHostCommand(options, output) {
         }
         return diagnosticStatus(result.status);
     }
+    if (options.action === 'uninstall') {
+        const result = await service.uninstall(options.host, {
+            ...target,
+            apply: options.apply,
+            force: options.force,
+        });
+        if (options.json)
+            output.stdout(`${JSON.stringify(result)}\n`);
+        else {
+            output.stdout(`Status: ${result.status}\n`);
+            for (const file of result.removedFiles)
+                output.stdout(`  removed ${file}\n`);
+            for (const file of result.retainedPaths)
+                output.stdout(`  preserved ${file}\n`);
+            for (const file of result.quarantinedLocks)
+                output.stdout(`  archived lock ${file}\n`);
+            if (!options.apply)
+                output.stdout('  plan only; rerun with --apply to remove managed wiring.\n');
+            printDiagnostics(output, result.diagnostics);
+        }
+        return result.ok ? 0 : 1;
+    }
     if (options.action === 'bundle') {
         if (options.out === null) {
             output.stderr('pappra host bundle requires --out <dir>.\n');
             return 2;
         }
+        if (options.bootstrapConfig !== null) {
+            if (options.host !== 'pi') {
+                output.stderr('pappra host bundle: --bootstrap-config requires --host pi.\n');
+                return 2;
+            }
+            if (!isAbsolute(options.bootstrapConfig)) {
+                output.stderr('pappra host bundle: --bootstrap-config must be an absolute path.\n');
+                return 2;
+            }
+            if (options.marketplace || options.mode !== null || options.apply) {
+                output.stderr('pappra host bundle: --bootstrap-config cannot be combined with --marketplace, --mode or --apply.\n');
+                return 2;
+            }
+        }
         if (!isSupportedVersion(options.host, options.hostVersion)) {
             output.stderr(`Host ${options.host} version ${options.hostVersion ?? '(unknown)'} is outside the pinned ${HOST_SUPPORT[options.host].version} support matrix.\n`);
             return 1;
         }
+        let bootstrap;
+        if (options.bootstrapConfig !== null) {
+            const loaded = readPiBootstrapConfig(options.bootstrapConfig);
+            if (loaded.ok === false) {
+                if (options.json) {
+                    output.stdout(`${JSON.stringify({
+                        ok: false,
+                        command: 'host',
+                        action: 'bundle',
+                        code: loaded.code,
+                        message: loaded.message,
+                    })}\n`);
+                }
+                else {
+                    output.stderr(`pappra host bundle: ${loaded.message}\n`);
+                }
+                return 1;
+            }
+            bootstrap = {
+                config: loaded.config,
+                configBytes: loaded.bytes,
+                configDigest: loaded.digest,
+                artifactPath: join(getPackageRoot(), 'dist/hosts/integration/pappra-bootstrap-extension.mjs'),
+            };
+        }
+        let recovery;
+        if (options.recoveryConfig !== null) {
+            if (options.host !== 'pi') {
+                output.stderr('pappra host bundle: --recovery-config requires --host pi.\n');
+                return 2;
+            }
+            if (!isAbsolute(options.recoveryConfig) ||
+                options.bootstrapConfig !== null ||
+                options.marketplace ||
+                options.mode !== null ||
+                options.apply) {
+                output.stderr('pappra host bundle: --recovery-config requires an absolute path and cannot be combined with --bootstrap-config, --marketplace, --mode or --apply.\n');
+                return 2;
+            }
+            const loaded = readPiRecoveryConfig(options.recoveryConfig);
+            if (loaded.ok === false) {
+                output.stderr(`pappra host bundle: recovery config validation failed (${loaded.code}).\n`);
+                return 1;
+            }
+            recovery = {
+                configFile: options.recoveryConfig,
+                artifactPath: join(getPackageRoot(), 'dist/hosts/integration/pappra-recovery-extension.mjs'),
+            };
+        }
+        if (options.transitionExtension &&
+            (options.host !== 'pi' ||
+                options.bootstrapConfig !== null ||
+                options.marketplace ||
+                options.mode !== null ||
+                options.apply)) {
+            output.stderr('pappra host bundle: --transition-extension requires a plain Pi bundle and cannot be combined with --bootstrap-config, --marketplace, --mode or --apply.\n');
+            return 2;
+        }
         try {
             const exported = await exportHostPluginBundle({
                 host: options.host,
@@ -213,6 +319,15 @@ export async function runHostCommand(options, output) {
                 outDir: options.out,
                 packageVersion: getPackageInfo().version,
                 marketplace: options.marketplace,
+                ...(bootstrap === undefined ? {} : { bootstrap }),
+                ...(recovery === undefined ? {} : { recovery }),
+                ...(options.transitionExtension
+                    ? {
+                        transition: {
+                            artifactPath: join(getPackageRoot(), 'dist/hosts/integration/pappra-session-transition-extension.mjs'),
+                        },
+                    }
+                    : {}),
             });
             if (options.json) {
                 output.stdout(`${JSON.stringify({ ok: true, command: 'host', action: 'bundle', ...exported })}\n`);

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

@@ -1,5 +1,5 @@
 import { type InitChoices } from '../../schemas/init.js';
-import { type InitContext } from '../../app/init.js';
+import { type InitContext, type InitPathObservation, type InitPlanBundle } from '../../app/init.js';
 import type { CliOutput } from '../output.js';
 export interface SelectOption {
     readonly value: string;
@@ -10,7 +10,7 @@ export interface WizardUi {
     intro(message: string): void;
     outro(message: string): void;
     note(message: string, title: string): void;
-    text(message: string, initialValue?: string): Promise<string | symbol>;
+    text(message: string, initialValue?: string, validate?: (value: string) => string | undefined): Promise<string | symbol>;
     select(message: string, options: readonly SelectOption[], initialValue?: string): Promise<string | symbol>;
     multiselect(message: string, options: readonly SelectOption[], initialValues?: readonly string[]): Promise<readonly string[] | symbol>;
     confirm(message: string, initialValue?: boolean): Promise<boolean | symbol>;
@@ -21,7 +21,12 @@ export declare const clackWizardUi: WizardUi;
  * UI-only selection collection. All validation and plan generation remains in
  * the app service; cancelling this function never writes to the workspace.
  */
-export declare function collectInitChoices(context: InitContext, ui: WizardUi): Promise<InitChoices | null>;
+export declare function collectInitChoices(context: InitContext, ui: WizardUi, options?: {
+    readonly reconfigure?: boolean;
+    readonly draft?: InitChoices;
+    readonly reviewOnly?: boolean;
+    readonly pathObservations?: readonly InitPathObservation[];
+}): Promise<InitChoices | null>;
 export interface InitCommandOptions {
     readonly cwd: string;
     readonly configPath: string | null;
@@ -39,6 +44,18 @@ export interface InitCommandOptions {
     /** Rebuilds workspace.json from the selections even when a valid config exists. */
     readonly reconfigure?: boolean;
 }
+export interface InitRuntimeOperationDescription {
+    readonly mode: 'default-self' | 'tarball' | 'version' | 'disabled';
+    readonly runtimeRequested: boolean;
+    readonly targetVersion: string;
+    readonly source: string | null;
+    readonly runtimeRoot: string | null;
+    readonly machineBindingPath: string;
+    readonly previewLines: readonly string[];
+    readonly confirmationMessage: string;
+}
+/** Describes the runtime work this invocation would perform without touching it. */
+export declare function describeInitRuntimeOperation(options: InitCommandOptions, bundle: InitPlanBundle, dataDir?: string): InitRuntimeOperationDescription;
 export interface InitCommandDeps {
     readonly ui?: WizardUi;
     readonly interactive?: boolean;