create-principles-disciple 1.132.2 → 1.132.3

package/release-manager/dist/uninstaller.js

@@ -0,0 +1,409 @@
+/**
+ * Uninstaller module
+ *
+ * ⚠️ Safety principles:
+ * 1. Only delete plugin system files (~/.openclaw/extensions/principles-disciple)
+ * 2. Only delete plugin config files (~/.openclaw/principles-disciple.json)
+ * 3. Never delete any files from user workspace:
+ *    - MD files (AGENTS.md, SOUL.md, etc.)
+ *    - Memory files (.principles/ directory)
+ *    - State files (.state/ directory)
+ *    - Any user data
+ *
+ * ADR-0020 §2.3: Multi-host uninstall. Host-side config cleanup (openclaw.json
+ * entries, ~/.codex/hooks.json entries, wrapper scripts) is delegated to
+ * HostInstaller.uninstall() implementations. Workspace user data is always
+ * preserved regardless of host target.
+ */
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import fse from 'fs-extra';
+import * as path from 'path';
+import * as os from 'os';
+import { confirm } from '@inquirer/prompts';
+import { logger } from './utils/logger.js';
+import { getOpenClawConfigDir, getPluginExtDir, checkOpenClawGateway } from './utils/env.js';
+import { getGlobalShimPaths, getInstalledBinDir, getPdRuntimeDir, getInstallManifestPath, isWindows } from './mvp-config.js';
+import { parseInstallManifest } from '@principles/install-layout';
+import { setLanguage, t, getLanguage } from './i18n.js';
+import { getHostInstallers } from './installers/index.js';
+export function planSharedRuntimeUninstall(host) {
+    if (host === 'all') {
+        return { removeSharedRuntime: true, remainingHosts: [], manifestHasTarget: true };
+    }
+    try {
+        const raw = JSON.parse(readFileSync(getInstallManifestPath(), 'utf8'));
+        const parsed = parseInstallManifest(raw);
+        if (!parsed.manifest) {
+            return {
+                removeSharedRuntime: false,
+                remainingHosts: [],
+                manifestHasTarget: false,
+                warning: `${parsed.error ?? 'install_manifest_malformed'}; shared runtime preserved. Re-run uninstall --host all after repairing ~/.pd/install.json.`,
+            };
+        }
+        const manifestHasTarget = parsed.manifest.hosts.includes(host);
+        const remainingHosts = parsed.manifest.hosts.filter(candidate => candidate !== host);
+        return { removeSharedRuntime: remainingHosts.length === 0, remainingHosts, manifestHasTarget };
+    }
+    catch (error) {
+        return {
+            removeSharedRuntime: false,
+            remainingHosts: [],
+            manifestHasTarget: false,
+            warning: `install_manifest_unreadable: ${error instanceof Error ? error.message : String(error)}; shared runtime preserved. Re-run uninstall --host all after repairing ~/.pd/install.json.`,
+        };
+    }
+}
+async function detectAndSetLanguage(lang) {
+    setLanguage(lang === 'en' ? 'en' : 'zh');
+}
+/**
+ * Check install status across all hosts (OpenClaw + Codex).
+ *
+ * ADR-0020 §2.3: Detects PD install markers for each registered host.
+ * Returns aggregated status so `pd status` / `npx create-principles-disciple
+ * status` shows the full picture regardless of which host was selected
+ * during install.
+ */
+export function checkInstallStatus(host = 'all') {
+    const configDir = getOpenClawConfigDir();
+    const lang = getLanguage();
+    // OpenClaw paths
+    const openclawPaths = [
+        { path: getPluginExtDir(), name: lang === 'zh' ? '插件扩展目录' : 'Plugin extension directory', type: 'dir' },
+        { path: path.join(configDir, 'principles-disciple.json'), name: lang === 'zh' ? 'OpenClaw 配置文件' : 'OpenClaw config file', type: 'file' },
+    ];
+    // Codex paths (ADR-0020).
+    // NOTE: ~/.codex/hooks.json is intentionally NOT in this deletion set.
+    // It is a shared host config file — CodexHostInstaller.uninstall() removes
+    // only PD-owned entries (matched by __pd_marker) from it. If it were listed
+    // here, the generic delete loop below would delete the entire file,
+    // destroying the user's non-PD Codex hooks. Also, including it would make
+    // isInstalled=true for any user who merely has a hooks.json, even if PD
+    // was never installed.
+    const pdCodexDir = path.join(os.homedir(), '.pd', 'codex');
+    const codexPaths = [
+        { path: path.join(pdCodexDir, 'pd-hooks.marker'), name: lang === 'zh' ? 'Codex 安装标记' : 'Codex install marker', type: 'file' },
+        { path: path.join(pdCodexDir, 'pd-hook-entry.cjs'), name: lang === 'zh' ? 'Codex 钩子入口' : 'Codex hook entry script', type: 'file' },
+    ];
+    const allPaths = host === 'openclaw'
+        ? openclawPaths
+        : host === 'codex'
+            ? codexPaths
+            : [...openclawPaths, ...codexPaths];
+    const checkedPaths = allPaths.map(p => ({
+        exists: existsSync(p.path),
+        path: p.path,
+        name: p.name,
+        type: p.type,
+    }));
+    const isInstalled = checkedPaths.some(p => p.exists);
+    return { isInstalled, paths: checkedPaths };
+}
+/**
+ * 检查 shim 文件是否由 Principles Disciple 创建
+ * 通过读取文件内容，确认其目标指向 PD 安装目录
+ */
+export function isPdOwnedShim(shimPath) {
+    try {
+        const content = readFileSync(shimPath, 'utf-8');
+        const pdBinDir = getInstalledBinDir();
+        const pdBinPath = isWindows()
+            ? path.join(pdBinDir, 'pd.cmd')
+            : path.join(pdBinDir, 'pd');
+        if (isWindows()) {
+            // Windows cmd/ps1 shim 应包含 PD 安装路径
+            return content.includes(pdBinDir) || content.includes(pdBinPath);
+        }
+        else {
+            // Unix shim 通常是符号链接或脚本，检查是否指向 PD 安装目录
+            return content.includes(pdBinDir) || content.includes(pdBinPath);
+        }
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Clean up global pd shim files
+ * Only deletes shims that were created by Principles Disciple
+ */
+async function removeGlobalPdShim() {
+    const removed = [];
+    const skipped = [];
+    const shimPaths = getGlobalShimPaths();
+    if (shimPaths.length === 0) {
+        logger.info(t('cannot_detect_npm_global'));
+        return { removed, skipped };
+    }
+    for (const shimPath of shimPaths) {
+        if (!existsSync(shimPath)) {
+            skipped.push(shimPath);
+            continue;
+        }
+        if (!isPdOwnedShim(shimPath)) {
+            logger.warn(`${t('global_command_skip_not_owned')}: ${shimPath}`);
+            skipped.push(shimPath);
+            continue;
+        }
+        try {
+            await fse.remove(shimPath);
+            removed.push(shimPath);
+            logger.success(`${t('global_command_deleted')}: ${shimPath}`);
+        }
+        catch (error) {
+            logger.warn(`${t('global_command_delete_failed')}: ${shimPath} - ${error instanceof Error ? error.message : String(error)}`);
+            skipped.push(shimPath);
+        }
+    }
+    return { removed, skipped };
+}
+/**
+ * Get user workspace path (for showing preservation notice)
+ */
+function getWorkspacePath() {
+    const configDir = getOpenClawConfigDir();
+    const configPath = path.join(configDir, 'principles-disciple.json');
+    if (!existsSync(configPath))
+        return null;
+    // Read and parse JSON directly — require() would execute the file if its
+    // extension ever changed, and the path must stay inside the config dir.
+    const resolved = path.resolve(configPath);
+    if (resolved !== configPath && !resolved.startsWith(configDir + path.sep)) {
+        return null;
+    }
+    try {
+        const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+        if (config && typeof config === 'object' && !Array.isArray(config)) {
+            const workspace = Reflect.get(config, 'workspace');
+            return typeof workspace === 'string' && workspace.length > 0 ? workspace : null;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Execute uninstall
+ *
+ * @param options.force Skip confirmation prompt (dangerous, for scripts only)
+ * @param options.host   ADR-0020: 'openclaw' | 'codex' | 'all' (default 'all')
+ */
+const REMOVE_RETRY_ATTEMPTS = 3;
+const REMOVE_RETRY_DELAY_MS = 1000;
+async function removeWithRetry(targetPath, _type) {
+    for (let attempt = 1; attempt <= REMOVE_RETRY_ATTEMPTS; attempt++) {
+        try {
+            await fse.remove(targetPath);
+            return;
+        }
+        catch (error) {
+            const errMsg = error instanceof Error ? error.message : String(error);
+            const isLockError = errMsg.includes('EPERM') || errMsg.includes('EBUSY') || errMsg.includes('permission');
+            if (!isLockError || attempt === REMOVE_RETRY_ATTEMPTS)
+                throw error;
+            await new Promise(r => setTimeout(r, REMOVE_RETRY_DELAY_MS * attempt));
+        }
+    }
+}
+export async function uninstall(options = {}) {
+    await detectAndSetLanguage(options.lang);
+    const hostTarget = options.host ?? 'all';
+    const result = {
+        success: false,
+        removedDirs: [],
+        removedFiles: [],
+        removedGlobalShims: [],
+        skippedGlobalShims: [],
+        preservedPaths: [],
+    };
+    try {
+        const gatewayStatus = hostTarget === 'codex'
+            ? { isRunning: false, port: undefined, pid: undefined }
+            : await checkOpenClawGateway();
+        if (gatewayStatus.isRunning) {
+            const portInfo = gatewayStatus.port ? ` (port ${gatewayStatus.port})` : '';
+            const pidInfo = gatewayStatus.pid ? `, PID ${gatewayStatus.pid}` : '';
+            logger.warn(`OpenClaw gateway is running${portInfo}${pidInfo}.`);
+            logger.warn(isWindows()
+                ? '文件可能被占用导致删除失败。建议先关闭 OpenClaw（openclaw gateway stop），然后重新运行卸载。'
+                : 'Files may be locked. Stop OpenClaw first (openclaw gateway stop), then re-run uninstall.');
+            console.log('');
+        }
+        // 1. Check install status
+        const status = checkInstallStatus(hostTarget);
+        const runtimePlan = planSharedRuntimeUninstall(hostTarget);
+        if (runtimePlan.warning)
+            logger.warn(runtimePlan.warning);
+        if (!status.isInstalled && !runtimePlan.manifestHasTarget) {
+            logger.warn(t('no_install_detected'));
+            result.success = true;
+            return result;
+        }
+        // 2. Get workspace path and show preservation notice
+        const workspaceDir = getWorkspacePath();
+        console.log('\n');
+        logger.warn(t('uninstall_warning_title'));
+        console.log(`   ${t('uninstall_warning_msg')}`);
+        console.log('\n');
+        if (workspaceDir && existsSync(workspaceDir)) {
+            logger.info(t('workspace_files_preserved'));
+            console.log(`   📁 ${t('workspace_dir_label')}: ${workspaceDir}`);
+            console.log(`   📄 ${t('md_files_preserved')}`);
+            console.log(`   📁 ${t('principles_dir_preserved')}`);
+            console.log(`   📁 ${t('state_dir_preserved')}`);
+            console.log('\n');
+        }
+        // 3. Show what will be deleted
+        logger.info(t('plugin_files_will_delete'));
+        for (const p of status.paths) {
+            if (p.exists) {
+                const icon = p.type === 'dir' ? '📁' : '📄';
+                console.log(`  ${icon} ${p.name}: ${p.path}`);
+            }
+        }
+        console.log('\n');
+        // 4. Confirm uninstall (unless --force)
+        if (!options.force) {
+            const confirmed = await confirm({
+                message: t('confirm_uninstall'),
+                default: false,
+            });
+            if (!confirmed) {
+                logger.info(t('uninstall_cancelled'));
+                result.success = true;
+                return result;
+            }
+        }
+        // 5. Execute deletion (only plugin system files)
+        const deleteErrors = [];
+        for (const p of status.paths) {
+            if (!p.exists)
+                continue;
+            try {
+                await removeWithRetry(p.path, p.type);
+                if (p.type === 'dir') {
+                    result.removedDirs.push(p.path);
+                }
+                else {
+                    result.removedFiles.push(p.path);
+                }
+                logger.success(`${t('deleted')}: ${p.name}`);
+            }
+            catch (error) {
+                const errMsg = error instanceof Error ? error.message : String(error);
+                const isPermError = errMsg.includes('EPERM') || errMsg.includes('permission') || errMsg.includes('access denied') || errMsg.includes('EBUSY');
+                if (isPermError) {
+                    logger.error(`${t('delete_failed')}: ${p.name} - ${errMsg}`);
+                    logger.warn(isWindows()
+                        ? '文件被占用，请先关闭 OpenClaw（openclaw gateway stop），然后手动删除目录或重新运行卸载。'
+                        : 'File is locked. Stop OpenClaw first (openclaw gateway stop), then re-run uninstall or delete manually.');
+                }
+                else {
+                    logger.error(`${t('delete_failed')}: ${p.name} - ${errMsg}`);
+                }
+                deleteErrors.push({ name: p.name, error: errMsg });
+            }
+        }
+        // 6. The pd shim belongs to the shared runtime. Keep it while another host
+        // remains attached; otherwise a host-scoped uninstall breaks that host.
+        if (runtimePlan.removeSharedRuntime) {
+            console.log('\n');
+            logger.info(t('cleaning_global_commands'));
+            const { removed, skipped } = await removeGlobalPdShim();
+            result.removedGlobalShims = removed;
+            result.skippedGlobalShims = skipped;
+        }
+        else {
+            logger.info('Keeping the shared pd command because another host still uses the runtime.');
+        }
+        // 6.5. ADR-0020 §2.3: Clean up host-side configs via HostInstallers.
+        // Replaces the old cleanupOpenClawConfig() with multi-host delegation.
+        const hostInstallers = getHostInstallers(hostTarget);
+        for (const installer of hostInstallers) {
+            try {
+                const ctx = {
+                    language: getLanguage(),
+                    force: options.force === true,
+                };
+                const hostResult = await installer.uninstall(ctx);
+                if (hostResult.success) {
+                    if (hostResult.removedPaths.length > 0) {
+                        logger.success(`Host "${installer.hostId}": cleaned ${hostResult.removedPaths.length} path(s)`);
+                    }
+                }
+                else {
+                    logger.warn(`Host "${installer.hostId}" cleanup: ${hostResult.reason ?? 'partial failure'}. Next: ${hostResult.nextAction}`);
+                }
+            }
+            catch (err) {
+                // rc-9: never silently swallow — surface the failure.
+                logger.warn(`Host "${installer.hostId}" cleanup threw: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        // Shared runtime is removed only after the final host is uninstalled.
+        let sharedRuntimeRemovalFailed = false;
+        if (runtimePlan.removeSharedRuntime && existsSync(getPdRuntimeDir())) {
+            try {
+                await removeWithRetry(getPdRuntimeDir(), 'dir');
+                result.removedDirs.push(getPdRuntimeDir());
+            }
+            catch (err) {
+                sharedRuntimeRemovalFailed = true;
+                deleteErrors.push({ name: 'PD shared runtime', error: err instanceof Error ? err.message : String(err) });
+            }
+        }
+        if (runtimePlan.removeSharedRuntime && !sharedRuntimeRemovalFailed && existsSync(getInstallManifestPath())) {
+            try {
+                await removeWithRetry(getInstallManifestPath(), 'file');
+                result.removedFiles.push(getInstallManifestPath());
+            }
+            catch (err) {
+                deleteErrors.push({ name: 'PD install manifest', error: err instanceof Error ? err.message : String(err) });
+            }
+        }
+        else if (!runtimePlan.removeSharedRuntime && runtimePlan.remainingHosts.length > 0) {
+            writeFileSync(getInstallManifestPath(), JSON.stringify({
+                layoutVersion: 1,
+                mode: 'canonical',
+                hosts: runtimePlan.remainingHosts,
+            }, null, 2) + '\n', 'utf8');
+        }
+        // 7. Record preserved paths
+        if (workspaceDir) {
+            result.preservedPaths.push(workspaceDir);
+            if (existsSync(path.join(workspaceDir, '.principles'))) {
+                result.preservedPaths.push(path.join(workspaceDir, '.principles'));
+            }
+            if (existsSync(path.join(workspaceDir, '.state'))) {
+                result.preservedPaths.push(path.join(workspaceDir, '.state'));
+            }
+        }
+        result.success = deleteErrors.length === 0;
+        if (deleteErrors.length > 0) {
+            result.error = deleteErrors.map(e => `${e.name}: ${e.error}`).join('; ');
+        }
+        console.log('\n');
+        if (deleteErrors.length > 0) {
+            logger.warn(t('uninstall_partial') || '卸载部分完成 — 部分文件未能删除，请按上方提示处理。');
+        }
+        else {
+            logger.success(t('uninstall_complete'));
+        }
+        console.log('\n');
+        if (result.preservedPaths.length > 0) {
+            logger.info(t('personal_data_preserved'));
+            result.preservedPaths.forEach(p => console.log(`   ${p}`));
+            console.log('\n');
+            logger.info(t('manual_cleanup_hint'));
+        }
+        return result;
+    }
+    catch (error) {
+        result.error = error instanceof Error ? error.message : String(error);
+        logger.error(`${t('uninstall_failed')}: ${result.error}`);
+        return result;
+    }
+}
+//# sourceMappingURL=uninstaller.js.map

package/release-manager/dist/uninstaller.js.map

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

package/release-manager/dist/update/atomic-file.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Atomic record adapter (SPEC §8).
+ *
+ * Atomicity: readers see either the old record or the new record — never a
+ * partial write. Durability: the selected record survives a crash. The two
+ * are tested separately; rename alone does NOT guarantee durability, so the
+ * writer fsyncs the record file before renaming and flushes the containing
+ * directory where the platform allows it.
+ *
+ * Platform notes (deliberate, documented):
+ * - POSIX: file fsync + directory fd fsync after rename.
+ * - Windows: file fsync + rename; Node cannot fsync a directory handle on
+ *   Windows, so durability of the RENAME itself relies on the filesystem
+ *   journal. As a compensating control the record is REREAD and verified
+ *   after the rename — a torn state fails loud instead of silently lying.
+ * - Windows rename after large writes can transiently fail EPERM/EACCES
+ *   while antivirus holds handles; the rename is retried within a bounded
+ *   window and fails loud afterwards (never falls back to non-atomic copy).
+ */
+export declare class AtomicRecordError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export interface AtomicWriteResult {
+    readonly path: string;
+    /** True when the post-rename reread reproduced the intended record bytes. */
+    readonly verified: boolean;
+}
+/**
+ * Replaces `recordPath` with `recordText` atomically:
+ * temp file (same directory) → fsync → rename → directory flush → reread.
+ * `recordText` must be the exact intended bytes; the reread must match.
+ */
+export declare function writeRecordAtomically(recordPath: string, recordText: string): AtomicWriteResult;
+//# sourceMappingURL=atomic-file.d.ts.map

package/release-manager/dist/update/atomic-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-file.d.ts","sourceRoot":"","sources":["../../src/update/atomic-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAIxC;CACF;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AA0DD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,iBAAiB,CAiC/F"}

package/release-manager/dist/update/atomic-file.js

@@ -0,0 +1,120 @@
+/**
+ * Atomic record adapter (SPEC §8).
+ *
+ * Atomicity: readers see either the old record or the new record — never a
+ * partial write. Durability: the selected record survives a crash. The two
+ * are tested separately; rename alone does NOT guarantee durability, so the
+ * writer fsyncs the record file before renaming and flushes the containing
+ * directory where the platform allows it.
+ *
+ * Platform notes (deliberate, documented):
+ * - POSIX: file fsync + directory fd fsync after rename.
+ * - Windows: file fsync + rename; Node cannot fsync a directory handle on
+ *   Windows, so durability of the RENAME itself relies on the filesystem
+ *   journal. As a compensating control the record is REREAD and verified
+ *   after the rename — a torn state fails loud instead of silently lying.
+ * - Windows rename after large writes can transiently fail EPERM/EACCES
+ *   while antivirus holds handles; the rename is retried within a bounded
+ *   window and fails loud afterwards (never falls back to non-atomic copy).
+ */
+import { closeSync, existsSync, fsyncSync, openSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from 'node:fs';
+import { randomUUID } from 'node:crypto';
+import { dirname, join } from 'node:path';
+export class AtomicRecordError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'AtomicRecordError';
+        this.code = code;
+    }
+}
+function isDirectory(directoryPath) {
+    return existsSync(directoryPath) && statSync(directoryPath).isDirectory();
+}
+function fsyncDirectory(directoryPath) {
+    // Directory fd fsync is POSIX-only; on Windows this is a documented no-op
+    // compensated by the post-rename reread verification below.
+    if (process.platform === 'win32')
+        return;
+    let descriptor;
+    try {
+        descriptor = openSync(directoryPath, 'r');
+        fsyncSync(descriptor);
+    }
+    catch {
+        // Some filesystems refuse directory fsync entirely; the file-level fsync
+        // already ran. Failing the whole write here would trade a durable-enough
+        // record for no record.
+    }
+    finally {
+        if (descriptor !== undefined)
+            closeSync(descriptor);
+    }
+}
+const RENAME_RETRY_DELAYS_MS = [50, 100, 200, 400, 800, 800, 800, 800];
+/**
+ * Synchronous bounded sleep for the rename retry loop. Atomics.wait is
+ * intentional here: this module is a synchronous CLI code path where
+ * blocking the thread IS the requested behaviour (there is no concurrent
+ * work to yield to), and Node.js — unlike browsers — permits Atomics.wait on
+ * the main thread. It returns 'timed-out' after the delay, which is exactly
+ * the sleep semantics we need.
+ */
+function sleepSync(delayMs) {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, delayMs);
+}
+function renameWithWindowsRetry(source, destination) {
+    for (let attempt = 0;; attempt += 1) {
+        try {
+            renameSync(source, destination);
+            return;
+        }
+        catch (error) {
+            const code = typeof error === 'object' && error !== null && Object.hasOwn(error, 'code')
+                ? String(Reflect.get(error, 'code'))
+                : 'unknown';
+            const delayMs = RENAME_RETRY_DELAYS_MS[attempt];
+            if (!['EPERM', 'EACCES', 'EAGAIN'].includes(code) || delayMs === undefined) {
+                throw new AtomicRecordError('atomic_rename_failed', `Atomic record replacement failed (${code}): ${source} -> ${destination}. The previous record is untouched.`);
+            }
+            sleepSync(delayMs);
+        }
+    }
+}
+/**
+ * Replaces `recordPath` with `recordText` atomically:
+ * temp file (same directory) → fsync → rename → directory flush → reread.
+ * `recordText` must be the exact intended bytes; the reread must match.
+ */
+export function writeRecordAtomically(recordPath, recordText) {
+    const directory = dirname(recordPath);
+    if (!isDirectory(directory)) {
+        throw new AtomicRecordError('atomic_directory_missing', `Record directory does not exist: ${directory}`);
+    }
+    // UUID-named temp file: pid+timestamp naming collides when two atomic
+    // writes land in the same millisecond, and the 'wx' exclusive flag then
+    // fails the second write spuriously.
+    const tempPath = join(directory, `.record-${randomUUID()}.tmp`);
+    let descriptor;
+    try {
+        descriptor = openSync(tempPath, 'wx');
+        writeFileSync(descriptor, recordText);
+        fsyncSync(descriptor);
+        closeSync(descriptor);
+        descriptor = undefined;
+        renameWithWindowsRetry(tempPath, recordPath);
+        fsyncDirectory(directory);
+        const reread = existsSync(recordPath) ? readFileSync(recordPath, 'utf8') : null;
+        if (reread !== recordText) {
+            throw new AtomicRecordError('atomic_verify_failed', `Post-rename verification failed for ${recordPath}: the record on disk does not match the intended bytes. The previous record may or may not be in place — recovery must consult the journal.`);
+        }
+        return { path: recordPath, verified: true };
+    }
+    catch (error) {
+        if (descriptor !== undefined)
+            closeSync(descriptor);
+        rmSync(tempPath, { force: true });
+        throw error;
+    }
+}
+//# sourceMappingURL=atomic-file.js.map

package/release-manager/dist/update/atomic-file.js.map

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

package/release-manager/dist/update/bootstrap-protocol.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Bootstrap process protocol (SPEC §6.1) — strict single-JSON-object in,
+ * strict single-JSON-object out.
+ *
+ * Companion, Console, and the installer speak to the bootstrap through this
+ * one protocol. The transport layer (stdin/stdout around this pure handler)
+ * stays thin so the contract itself is testable: exactly one parseable JSON
+ * object per direction, stable reason codes, and a next action on every
+ * failure (rc-9, cli-1 semantics applied to the protocol boundary).
+ */
+import type { ReleaseChannelName } from './product-identity.js';
+import type { ReleaseManager } from './release-manager.js';
+export type BootstrapRequestOp = 'inspect' | 'check' | 'apply' | 'rollback';
+export type BootstrapRequest = {
+    readonly op: 'inspect';
+} | {
+    readonly op: 'check';
+    readonly channel: ReleaseChannelName;
+} | {
+    readonly op: 'apply';
+    readonly releaseId: string;
+} | {
+    readonly op: 'rollback';
+};
+export interface BootstrapOkResponse {
+    readonly ok: true;
+    readonly result: unknown;
+}
+export interface BootstrapFailureResponse {
+    readonly ok: false;
+    readonly reason: string;
+    readonly message: string;
+    readonly nextAction: string;
+}
+export type BootstrapResponse = BootstrapOkResponse | BootstrapFailureResponse;
+export declare class BootstrapProtocolError extends Error {
+    readonly reason: string;
+    constructor(reason: string, message: string);
+}
+/**
+ * Parses exactly ONE JSON object from the raw request text. Trailing data,
+ * non-objects, arrays, and unknown/missing fields are hard errors — a
+ * protocol peer that emits garbage gets a structured refusal, never a
+ * best-effort guess.
+ */
+export declare function parseBootstrapRequest(raw: string): BootstrapRequest;
+/** Serializes exactly one JSON object for stdout (no banners, no extra text). */
+export declare function serializeBootstrapResponse(response: BootstrapResponse): string;
+/**
+ * Dispatches a parsed request against a ReleaseManager and produces the
+ * protocol response. Manager failures become structured refusals — the
+ * protocol never leaks stack traces into the response object.
+ */
+export declare function handleBootstrapRequest(request: BootstrapRequest, manager: ReleaseManager): Promise<BootstrapResponse>;
+//# sourceMappingURL=bootstrap-protocol.d.ts.map