create-principles-disciple 1.132.2 → 1.132.4

package/release-manager/dist/installers/openclaw-host-installer.js

@@ -0,0 +1,414 @@
+/**
+ * OpenClawHostInstaller — implements HostInstaller for OpenClaw (ADR-0020 §2.3)
+ *
+ * Wraps the existing OpenClaw config write/cleanup logic that previously lived
+ * as private functions in installer.ts and uninstaller.ts. Extracted into a
+ * class so the CLI can route install/uninstall by --host (openclaw | codex).
+ *
+ * NO BEHAVIOR CHANGE: the logic is identical to the pre-refactor private
+ * functions updateOpenClawConfig() / cleanupOpenClawConfig(). The existing
+ * install() / uninstall() entry points delegate to this class.
+ *
+ * Runtime Contract Rules:
+ * - rc-1-treat-as-unknown: openclaw.json parsed as unknown, validated.
+ * - rc-2-no-as-bypass: uses Object.hasOwn + typeof guards, not `as`.
+ * - rc-3-fail-loud-missing: malformed openclaw.json throws.
+ * - rc-5-object-hasown-not-in: uses Object.hasOwn for untrusted keys.
+ * - rc-9-no-silent-fallback: every result includes reason + nextAction.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { validateOpenClawConfig } from '../mvp-config.js';
+// PRI-343: Keep in sync with @principles/core CONVERSATION_ACCESS_CONFIG_KEY
+const CONVERSATION_ACCESS_CONFIG_KEY = 'allowConversationAccess';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Type guard: extracts `.code` from a thrown error without `as NodeJS.ErrnoException`.
+ * ESLint `no-undef` flags the `NodeJS` namespace; this helper avoids it.
+ */
+function getErrorCode(err) {
+    if (err !== null && typeof err === 'object' && Object.hasOwn(err, 'code')) {
+        const { code } = err;
+        return typeof code === 'string' ? code : undefined;
+    }
+    return undefined;
+}
+/**
+ * PRI-343: Pure function — deep-merges allowConversationAccess: true into
+ * the openclaw.json config without mutating the input.
+ *
+ * Ensures plugins.entries['principles-disciple'].hooks.allowConversationAccess
+ * is set to true, creating intermediate objects if missing.
+ * Preserves all other fields.
+ */
+function ensureConversationAccess(config) {
+    const result = { ...config };
+    if (!isRecord(result.plugins))
+        return result;
+    const plugins = { ...result.plugins };
+    if (!isRecord(plugins.entries))
+        return result;
+    const entries = { ...plugins.entries };
+    const rawEntry = entries['principles-disciple'];
+    const entry = isRecord(rawEntry)
+        ? { ...rawEntry }
+        : { enabled: true };
+    const rawHooks = entry.hooks;
+    const hooks = isRecord(rawHooks) ? { ...rawHooks } : {};
+    hooks[CONVERSATION_ACCESS_CONFIG_KEY] = true;
+    entry.hooks = hooks;
+    entries['principles-disciple'] = entry;
+    plugins.entries = entries;
+    result.plugins = plugins;
+    return result;
+}
+function getOpenClawDir() {
+    return path.join(os.homedir(), '.openclaw');
+}
+function getPluginExtDir() {
+    return path.join(getOpenClawDir(), 'extensions', 'principles-disciple');
+}
+/**
+ * OpenClaw host installer — writes/merges ~/.openclaw/openclaw.json and
+ * ~/.openclaw/plugins/installs.json. Does NOT install bundled components
+ * (core/pd-cli/console) — that's the shared installer's job.
+ */
+export class OpenClawHostInstaller {
+    hostId = 'openclaw';
+    async install(_ctx) {
+        // OpenClaw install does not use workspaceDir from ctx — OpenClaw resolves
+        // workspace from its own gateway config. The parameter is required by
+        // the HostInstaller interface contract.
+        void _ctx;
+        const configDir = getOpenClawDir();
+        const configPath = path.join(configDir, 'openclaw.json');
+        // CodeQL TOCTOU fix: use try/catch read instead of existsSync+readFileSync.
+        // The OpenClaw gateway creates openclaw.json on first run; if it doesn't
+        // exist, PD's config is inert until the gateway starts. Not an error.
+        let rawConfig;
+        try {
+            rawConfig = readFileSync(configPath, 'utf-8');
+        }
+        catch (err) {
+            const code = getErrorCode(err);
+            if (code === 'ENOENT') {
+                return {
+                    success: true,
+                    hostId: this.hostId,
+                    configPath,
+                    configAction: 'skipped',
+                    reason: 'openclaw.json does not exist yet — PD plugin entries will be registered when OpenClaw gateway first starts.',
+                    nextAction: `Start OpenClaw gateway (openclaw gateway start), then verify: openclaw plugin list`,
+                };
+            }
+            throw err;
+        }
+        try {
+            const config = JSON.parse(rawConfig);
+            const validation = validateOpenClawConfig(config);
+            if (!validation.valid) {
+                return {
+                    success: false,
+                    hostId: this.hostId,
+                    configPath,
+                    configAction: 'skipped',
+                    reason: `Malformed openclaw.json: ${validation.error}.`,
+                    nextAction: 'Fix ~/.openclaw/openclaw.json manually, then re-run: npx create-principles-disciple install --host openclaw',
+                };
+            }
+            if (config === null || typeof config !== 'object' || Array.isArray(config)) {
+                return {
+                    success: false,
+                    hostId: this.hostId,
+                    configPath,
+                    configAction: 'skipped',
+                    reason: 'openclaw.json parsed as non-object.',
+                    nextAction: 'Fix ~/.openclaw/openclaw.json manually, then re-run installer.',
+                };
+            }
+            // rc-2: isRecord narrows config to Record<string, unknown> without `as` cast.
+            const configObj = isRecord(config) ? { ...config } : {};
+            // Ensure plugins.allow includes principles-disciple
+            if (!configObj.plugins)
+                configObj.plugins = {};
+            if (!isRecord(configObj.plugins)) {
+                return {
+                    success: false,
+                    hostId: this.hostId,
+                    configPath,
+                    configAction: 'skipped',
+                    reason: 'openclaw.json plugins field is malformed (not an object).',
+                    nextAction: 'Fix ~/.openclaw/openclaw.json plugins field manually, then re-run installer.',
+                };
+            }
+            const plugins = { ...configObj.plugins };
+            // plugins.allow: append ONLY when the user already has an allow list —
+            // never create one. Once plugins.allow is non-empty, OpenClaw silently
+            // disables every discovered non-bundled plugin that is NOT on the list,
+            // so creating allow=["principles-disciple"] on a machine that already
+            // auto-loads other plugins (e.g. feishu / tavily) would disable those
+            // plugins. An absent allow list keeps the previous auto-load behavior
+            // (OpenClaw logs an informational notice instead).
+            const allowWasAbsent = plugins.allow === undefined || plugins.allow === null;
+            if (!allowWasAbsent) {
+                if (!Array.isArray(plugins.allow)) {
+                    return {
+                        success: false,
+                        hostId: this.hostId,
+                        configPath,
+                        configAction: 'skipped',
+                        reason: 'openclaw.json plugins.allow is not an array.',
+                        nextAction: 'Fix ~/.openclaw/openclaw.json plugins.allow manually, then re-run installer.',
+                    };
+                }
+                const allow = plugins.allow.filter((a) => typeof a === 'string');
+                if (!allow.includes('principles-disciple')) {
+                    allow.push('principles-disciple');
+                }
+                plugins.allow = allow;
+            }
+            if (!plugins.entries)
+                plugins.entries = {};
+            if (!isRecord(plugins.entries)) {
+                return {
+                    success: false,
+                    hostId: this.hostId,
+                    configPath,
+                    configAction: 'skipped',
+                    reason: 'openclaw.json plugins.entries is malformed.',
+                    nextAction: 'Fix ~/.openclaw/openclaw.json plugins.entries manually, then re-run installer.',
+                };
+            }
+            const entries = { ...plugins.entries };
+            const existingEntry = isRecord(entries['principles-disciple'])
+                ? { ...entries['principles-disciple'] }
+                : {};
+            entries['principles-disciple'] = { ...existingEntry, enabled: true };
+            plugins.entries = entries;
+            configObj.plugins = plugins;
+            // PRI-343: deep-merge allowConversationAccess: true
+            const mergedConfigObj = ensureConversationAccess(configObj);
+            writeFileSync(configPath, JSON.stringify(mergedConfigObj, null, 2));
+            // Write install record to installs.json (the canonical store)
+            this.writeInstallRecord(configDir);
+            return {
+                success: true,
+                hostId: this.hostId,
+                configPath,
+                configAction: 'updated',
+                nextAction: allowWasAbsent
+                    ? 'Verify: openclaw plugin list. Note: plugins.allow was absent and was deliberately NOT created — a non-empty allow list silently disables every other discovered plugin not on it. To silence OpenClaw\u2019s allow-list notice, add ALL discovered plugin ids (see the gateway log) to plugins.allow yourself.'
+                    : 'Verify: openclaw plugin list (should show principles-disciple as enabled)',
+            };
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            return {
+                success: false,
+                hostId: this.hostId,
+                configPath,
+                configAction: 'skipped',
+                reason: `Failed to update openclaw.json: ${reason}`,
+                nextAction: 'Check file permissions on ~/.openclaw/openclaw.json and re-run installer.',
+            };
+        }
+    }
+    /**
+     * Write install record to ~/.openclaw/plugins/installs.json.
+     * Non-fatal on failure — OpenClaw manages this file and will self-heal.
+     */
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    writeInstallRecord(configDir) {
+        const installsDir = path.join(configDir, 'plugins');
+        const installsPath = path.join(installsDir, 'installs.json');
+        try {
+            // CodeQL TOCTOU fix: mkdirSync is idempotent (no pre-check needed);
+            // readFileSync uses try/catch instead of existsSync+read.
+            if (!existsSync(installsDir)) {
+                mkdirSync(installsDir, { recursive: true });
+            }
+            // rc-3/rc-9: Only initialize a fresh record on ENOENT (file doesn't exist).
+            // For any other read/parse failure (EACCES, EIO, malformed JSON), or when the
+            // parsed value is not a record, RETURN without writing — overwriting would
+            // destroy other plugins' installRecords. Non-fatal: OpenClaw self-heals.
+            let installs;
+            try {
+                const raw = readFileSync(installsPath, 'utf-8');
+                const parsed = JSON.parse(raw);
+                if (!isRecord(parsed)) {
+                    // Parsed to a non-object (array/string/null) — preserve original file.
+                    return;
+                }
+                // rc-3/rc-9: if installRecords exists but is not a record (null/array/
+                // string), preserve the original file rather than overwriting it with
+                // an empty object. Missing installRecords is a compatible format and
+                // will be initialized to {} below (CodeRabbit #3762804744).
+                if (Object.hasOwn(parsed, 'installRecords') && !isRecord(parsed.installRecords)) {
+                    return;
+                }
+                installs = parsed;
+            }
+            catch (err) {
+                const code = getErrorCode(err);
+                if (code === 'ENOENT') {
+                    // File doesn't exist — initialize fresh record (first install).
+                    installs = { version: 1, installRecords: {} };
+                }
+                else {
+                    // EACCES / EIO / malformed JSON — preserve original file, do not overwrite.
+                    return;
+                }
+            }
+            // rc-2: isRecord narrows installRecords without `as` cast (ERR-001 recurrence).
+            // Replaces the prior `typeof !== 'object'` check — isRecord also rejects arrays,
+            // which the old check silently allowed through.
+            const installRecords = isRecord(installs.installRecords)
+                ? installs.installRecords
+                : {};
+            const extDir = getPluginExtDir();
+            const pkgPath = path.join(extDir, 'package.json');
+            let version = undefined;
+            try {
+                const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+                if (isRecord(pkg) && Object.hasOwn(pkg, 'version') && typeof pkg.version === 'string') {
+                    ({ version } = pkg);
+                }
+            }
+            catch { /* ignore — ENOENT or malformed package.json */ }
+            installRecords['principles-disciple'] = {
+                source: 'path',
+                installPath: extDir,
+                ...(version ? { version } : {}),
+                installedAt: new Date().toISOString(),
+            };
+            installs.installRecords = installRecords;
+            writeFileSync(installsPath, JSON.stringify(installs, null, 2));
+        }
+        catch {
+            // Non-fatal — installs.json is managed by OpenClaw and will self-heal
+        }
+    }
+    async uninstall(_ctx) {
+        const configDir = getOpenClawDir();
+        const configPath = path.join(configDir, 'openclaw.json');
+        const removedPaths = [];
+        const preservedPaths = [];
+        // CodeQL TOCTOU fix: try/catch read instead of existsSync+readFileSync.
+        let raw;
+        try {
+            raw = readFileSync(configPath, 'utf-8');
+        }
+        catch (err) {
+            const code = getErrorCode(err);
+            if (code === 'ENOENT') {
+                return {
+                    success: true,
+                    hostId: this.hostId,
+                    removedPaths,
+                    preservedPaths,
+                    nextAction: 'openclaw.json not found — nothing to clean.',
+                };
+            }
+            throw err;
+        }
+        try {
+            const config = JSON.parse(raw);
+            if (config === null || typeof config !== 'object' || Array.isArray(config)) {
+                return {
+                    success: false,
+                    hostId: this.hostId,
+                    removedPaths,
+                    preservedPaths,
+                    reason: 'openclaw.json is not an object',
+                    nextAction: 'Inspect ~/.openclaw/openclaw.json manually; PD entries may still be present.',
+                };
+            }
+            // rc-2: isRecord narrows without `as` cast.
+            const configObj = isRecord(config) ? config : {};
+            let modified = false;
+            if (isRecord(configObj.plugins)) {
+                const { plugins } = configObj;
+                // Remove from plugins.allow
+                if (Array.isArray(plugins.allow)) {
+                    const before = plugins.allow.length;
+                    const filtered = plugins.allow.filter((a) => typeof a === 'string' && a !== 'principles-disciple');
+                    plugins.allow = filtered;
+                    if (filtered.length !== before)
+                        modified = true;
+                }
+                // Remove from plugins.entries
+                if (isRecord(plugins.entries)) {
+                    const { entries } = plugins;
+                    if (Object.hasOwn(entries, 'principles-disciple')) {
+                        delete entries['principles-disciple'];
+                        modified = true;
+                    }
+                }
+                // Remove from plugins.installs (legacy field)
+                if (isRecord(plugins.installs)) {
+                    const { installs } = plugins;
+                    if (Object.hasOwn(installs, 'principles-disciple')) {
+                        delete installs['principles-disciple'];
+                        modified = true;
+                    }
+                }
+            }
+            if (modified) {
+                writeFileSync(configPath, JSON.stringify(configObj, null, 2) + '\n');
+                removedPaths.push(configPath);
+                return {
+                    success: true,
+                    hostId: this.hostId,
+                    removedPaths,
+                    preservedPaths,
+                    nextAction: 'openclaw.json cleaned — principles-disciple entries removed.',
+                };
+            }
+            return {
+                success: true,
+                hostId: this.hostId,
+                removedPaths,
+                preservedPaths,
+                nextAction: 'openclaw.json had no principles-disciple entries — nothing to clean.',
+            };
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            return {
+                success: false,
+                hostId: this.hostId,
+                removedPaths,
+                preservedPaths,
+                reason,
+                nextAction: 'Inspect ~/.openclaw/openclaw.json manually; PD entries may still be present.',
+            };
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    detect() {
+        const configDir = getOpenClawDir();
+        // detect() is non-interactive; use English labels (stable, no i18n dep).
+        const paths = [
+            {
+                exists: existsSync(getPluginExtDir()),
+                path: getPluginExtDir(),
+                name: 'Plugin extension directory',
+                type: 'dir',
+            },
+            {
+                exists: existsSync(path.join(configDir, 'principles-disciple.json')),
+                path: path.join(configDir, 'principles-disciple.json'),
+                name: 'OpenClaw config file',
+                type: 'file',
+            },
+        ];
+        return {
+            installed: paths.some((p) => p.exists),
+            paths,
+        };
+    }
+}
+//# sourceMappingURL=openclaw-host-installer.js.map

package/release-manager/dist/installers/openclaw-host-installer.js.map

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

package/release-manager/dist/mvp-config.d.ts

@@ -0,0 +1,197 @@
+export declare const MVP_CHANNELS: readonly ['prompt', 'code_tool_hook', 'defer_archive'];
+export type MvpChannel = (typeof MVP_CHANNELS)[number];
+export declare const MVP_QUIET_FLAGS: readonly ['gfi'];
+export declare const MVP_GONE_FLAGS: readonly ['nocturnal', 'idle_trigger'];
+/**
+ * Product-level feedback defaults (PRI-543). The PD 控制台的"意见反馈"收集的是
+ * 使用者对 PD 产品的功能建议 / Bug,接收者是 PD 项目所有者,而非使用者自己。
+ * 因此 installer 生成的默认 config 预置:
+ * - `maintainer_email`:产品所有者的邮箱(兜底邮箱通道发到这里)。
+ * - `ingest_url` + `ingest_token`:主通道,让新装使用者开箱即可把反馈经 Cloudflare
+ *   relay 落到所有者的 Linear,无需使用者自行配置。
+ *
+ * `ingest_token` 是随发布版分发的固定"产品公共令牌",按 spec §9.2 属反滥用边界
+ * (非安全边界),靠 relay 端 IP 限流兜底。改动此值必须同步更新 Cloudflare Pages
+ * secret `INGEST_TOKEN` 为同一值,并更新 `packages/website` 端 relay 的校验常量;
+ * 同时保持与 `tests/mvp-config.test.ts` 的断言一致(spec §10 双点同步)。
+ */
+export declare const PRODUCT_FEEDBACK_MAINTAINER_EMAIL = "csuzngjh@hotmail.com";
+export declare const PRODUCT_FEEDBACK_INGEST_URL = "https://principles-website.pages.dev/api/feedback";
+export declare const PRODUCT_FEEDBACK_INGEST_TOKEN = "pd_prod_pdxk4of3grc9vws2uz7te8iy";
+export interface ComponentStatus {
+    plugin: 'verified' | 'failed' | 'skipped';
+    cli: 'verified' | 'verified_local_only' | 'failed' | 'skipped';
+    console: 'configured' | 'skipped';
+    consoleEntrypoint?: string;
+    cliLocalPath?: string;
+}
+export interface VerificationResult {
+    features: 'passed' | 'failed' | 'skipped';
+    storyA: 'passed' | 'failed' | 'skipped';
+    storyASkipReason?: string;
+    manifestActivation?: 'verified' | 'missing_hook' | 'missing_setup_entry' | 'skipped';
+}
+export interface InstallSuccessOutput {
+    success: true;
+    workspace: string;
+    components: ComponentStatus;
+    enabledChannels: MvpChannel[];
+    verification: VerificationResult;
+    nextAction: string;
+    /** Task 8: when the installer auto-launches the console via `pd console open`,
+     * this holds the URL the browser was opened to (ends with /welcome). Undefined
+     * when auto-launch was not performed or failed. */
+    consoleUrl?: string;
+}
+export interface InstallFailureOutput {
+    success: false;
+    reason: string;
+    nextAction: string;
+    components?: Partial<ComponentStatus>;
+    verification?: Partial<VerificationResult>;
+}
+export type InstallOutput = InstallSuccessOutput | InstallFailureOutput;
+export declare function validateMvpChannels(channels: unknown): {
+    valid: MvpChannel[];
+    unknowns: string[];
+};
+export declare function parseChannelsOption(raw: unknown): {
+    channels: MvpChannel[];
+    unknowns: string[];
+    error?: string;
+};
+export declare function validateOpenClawConfig(config: unknown): {
+    valid: boolean;
+    error?: string;
+};
+export interface BuildOutputOptions {
+    workspace: string;
+    components: ComponentStatus;
+    channels: MvpChannel[];
+    verification: VerificationResult;
+    /** Task 8: URL the browser was opened to when the installer auto-launched the
+     * console. When provided and the install is complete, the success output's
+     * nextAction references this URL instead of the manual "pd console" instruction. */
+    consoleUrl?: string;
+}
+export declare function buildSuccessOutput(opts: BuildOutputOptions): InstallOutput;
+export declare function buildFailureOutput(reason: string, nextAction: string): InstallFailureOutput;
+export declare function isMvpChannel(value: string): value is MvpChannel;
+export declare function getHomeDir(): string;
+export declare function getOpenClawDir(): string;
+/** Host-neutral PD installation root. Shared runtime must not live under a
+ * host's discovery directory (ADR-0020 / ERR-097). */
+export declare function getPdDir(): string;
+export declare function getPdRuntimeDir(): string;
+export declare function getInstallManifestPath(): string;
+export declare function getPdRuntimeBackupsDir(): string;
+export declare function getPluginExtDir(): string;
+/** Common plugin package used by pd-cli/console. OpenClaw gets an adapter copy
+ * under getPluginExtDir(); Codex-only installs use this host-neutral copy. */
+export declare function getInstalledPluginDir(): string;
+export declare function getInstalledLayoutPackageDir(): string;
+/**
+ * PD 备份根目录（~/.openclaw/pd-backups）—— 必须位于 extensions/ 之外。
+ * OpenClaw 插件发现会扫描 extensions/ 下每个子目录；备份目录内含
+ * package.json(openclaw.extensions) + dist/bundle.js 时会被识别为第二个
+ * principles-disciple 插件，导致每次 gateway 启动都出现
+ * "duplicate plugin id detected" 告警。备份一律放这里，禁止放 extensions/ 内。
+ */
+export declare function getPdBackupsDir(): string;
+export declare function getInstalledPdCliDir(): string;
+export declare function getInstalledBinDir(): string;
+export declare function getInstalledConsoleDir(): string;
+export declare function isWindows(): boolean;
+/**
+ * Fix-4 (P0-BUG-4): Optional runtime profile input collected by the installer
+ * prompt flow. When provided, the generated config.yaml's `pd.default` profile
+ * is pre-filled instead of left empty, so LLM-dependent features (diagnose,
+ * candidate intake, internalization) work on first run instead of failing
+ * silently (rc-9: no silent fallback).
+ *
+ * All fields optional — if undefined, the corresponding config field stays
+ * empty (backward compatible with the previous behavior).
+ */
+export interface RuntimeProfileInput {
+    provider?: string;
+    model?: string;
+    apiKeyEnv?: string;
+}
+/**
+ * PRI-308: Generate .pd/config.yaml content.
+ *
+ * This replaces the old feature-flags.yaml generation.
+ * The config.yaml follows the PdConfig schema from principles-core
+ * (pd-config-types.ts), inlined to avoid a runtime dependency.
+ *
+ * Fix-4 (P0-BUG-4): `runtimeProfile` optional parameter — when provided,
+ * the `pd.default` profile is pre-filled with user-supplied values instead
+ * of being left empty. Empty profile causes LLM features to fail silently.
+ *
+ * PRI-543 (slice 5): `maintainerEmail` optional parameter — when provided,
+ * it pre-fills `feedback.maintainer_email` so the email fallback channel uses
+ * a real address instead of the loader's placeholder. Added so the config
+ * template and pd-config-store stay in sync (spec §10 double-sync).
+ */
+export declare function generateConfigYamlContent(runtimeProfile?: RuntimeProfileInput, maintainerEmail?: string): string;
+/**
+ * PRI-308: Get the path to .pd/config.yaml for a workspace.
+ */
+export declare function getConfigYamlPath(workspaceDir: string): string;
+/**
+ * PRI-308: Full structural validation of .pd/config.yaml.
+ *
+ * Checks all required top-level sections (version, features, runtimeProfiles,
+ * internalAgents) exist and have correct types. This is a lightweight structural
+ * check — deep field validation is done by validatePdConfig() in principles-core.
+ *
+ * Used by the installer to decide whether an existing config.yaml is safe to
+ * preserve. A config missing runtimeProfiles/internalAgents would cause runtime
+ * failures, so it must be rejected.
+ *
+ * Throws on any structural problem with reason + nextAction.
+ */
+export declare function validateConfigYamlFull(workspaceDir: string): void;
+/**
+ * PRI-645: structural validation of an existing config.yaml the installer is
+ * about to preserve (PRI-308 preserve contract).
+ *
+ * The PRI-523 migration that used to live here (adding `host.codex` /
+ * `abstraction_layer_v1` to existing configs) is retired: both entries were
+ * exactly registry defaults, and writing them re-created the default snapshot
+ * PRI-645 removes. Effective values never depended on those entries — the
+ * registry (DEFAULT_FEATURE_FLAGS) resolves both at read time — so retiring
+ * the write changes representation only, never behavior. Existing configs are
+ * now preserved verbatim: no normalization, no cleanup (source=system is an
+ * origin hint, not an auto-delete license — PRI-637).
+ */
+export declare class ExistingConfigVerifyInfraError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare function validateExistingConfigYamlForPreserve(workspaceDir: string): void;
+/**
+ * PRI-308: Read the ENABLED MVP channels from .pd/config.yaml.
+ *
+ * PRI-645: computed with sparse/effective semantics, not raw presence —
+ * the MVP channels are registered core capabilities whose registry default
+ * is ON and which cannot be disabled by omission (PRI-435), so:
+ *   entry absent            → enabled (follows registry default)
+ *   entry { enabled: true }  → enabled
+ *   entry { enabled: false } → disabled (explicit Owner override)
+ * A present-but-malformed entry still fails loud (rc-3).
+ *
+ * Fail-loud: throws on malformed or missing required fields.
+ * Returns empty array if file does not exist (first install).
+ */
+export declare function readEnabledChannelsFromConfigYaml(workspaceDir: string): string[];
+/**
+ * 获取 npm global bin 目录路径
+ */
+export declare function getNpmGlobalBinDir(): string | null;
+/**
+ * 获取所有可能的全局 pd shim 文件路径
+ */
+export declare function getGlobalShimPaths(): string[];
+//# sourceMappingURL=mvp-config.d.ts.map

package/release-manager/dist/mvp-config.d.ts.map

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