create-principles-disciple 1.132.2 → 1.132.3

package/release-manager/dist/prompts.js

@@ -0,0 +1,231 @@
+import { select, confirm, input } from '@inquirer/prompts';
+import * as path from 'path';
+import * as os from 'os';
+import { detectWorkspace } from './utils/env.js';
+import { MVP_CHANNELS } from './mvp-config.js';
+import { setLanguage, getLanguage, t } from './i18n.js';
+// Fix-4 (P0-BUG-4): Supported pi-ai providers for the interactive prompt.
+// Keep in sync with packages/principles-core pi-ai adapter capabilities.
+const RUNTIME_PROFILE_PROVIDERS = [
+    { name: 'openai', value: 'openai' },
+    { name: 'anthropic', value: 'anthropic' },
+    { name: 'deepseek', value: 'deepseek' },
+    { name: 'skip — configure later in console', value: '__skip__' },
+];
+/**
+ * Fix-4 (P0-BUG-4): Interactive prompt for LLM runtime profile.
+ *
+ * Why this exists: without a configured runtimeProfile, `.pd/config.yaml`
+ * leaves `pd.default` provider/model/apiKeyEnv empty, and LLM-dependent
+ * features (diagnose, candidate intake, internalization) fail silently
+ * (rc-9: no silent fallback). This prompt collects the values up front so
+ * first-run experience is not broken.
+ *
+ * Returns `undefined` when the user skips — installer falls back to empty
+ * profile and surfaces a clear next-action pointing to the console settings.
+ */
+async function promptRuntimeProfile() {
+    const configure = await confirm({
+        message: 'Configure LLM runtime profile now? (recommended for first-time users — needed for pain diagnosis and principle generation)',
+        default: true,
+    });
+    if (!configure)
+        return undefined;
+    const providerChoice = await select({
+        message: 'Select LLM provider:',
+        choices: RUNTIME_PROFILE_PROVIDERS,
+        default: 'openai',
+    });
+    if (providerChoice === '__skip__')
+        return undefined;
+    const apiKeyEnv = await input({
+        message: 'Enter API key environment variable name (e.g. OPENAI_API_KEY), or "skip" to skip:',
+        default: providerChoice === 'openai' ? 'OPENAI_API_KEY'
+            : providerChoice === 'anthropic' ? 'ANTHROPIC_API_KEY'
+                : providerChoice === 'deepseek' ? 'DEEPSEEK_API_KEY'
+                    : 'LLM_API_KEY',
+        validate: (value) => {
+            const trimmed = value.trim();
+            if (!trimmed)
+                return 'Environment variable name cannot be empty (enter "skip" to skip)';
+            if (trimmed.toLowerCase() === 'skip')
+                return true;
+            if (!/^[A-Z_][A-Z0-9_]*$/.test(trimmed)) {
+                return 'Must be a valid environment variable name (uppercase letters, digits, underscore; cannot start with a digit). Enter "skip" to skip.';
+            }
+            return true;
+        },
+    });
+    if (apiKeyEnv.trim().toLowerCase() === 'skip')
+        return undefined;
+    // Model is optional — sensible defaults exist per provider, user can override
+    // via console later. We don't prompt for it to keep onboarding short.
+    const modelDefault = providerChoice === 'openai' ? 'gpt-4o-mini'
+        : providerChoice === 'anthropic' ? 'claude-3-5-haiku-latest'
+            : providerChoice === 'deepseek' ? 'deepseek-chat'
+                : '';
+    return {
+        provider: providerChoice,
+        model: modelDefault,
+        apiKeyEnv: apiKeyEnv.trim(),
+    };
+}
+/**
+ * ADR-0020 §2.3: Prompt for host target (interactive mode only).
+ *
+ * Default is 'openclaw' for backward compatibility. Operators who also use
+ * Codex CLI should select 'codex' or 'all'.
+ */
+async function promptHost(defaultHost = 'openclaw') {
+    return await select({
+        message: 'Select host platform / 选择主机平台',
+        choices: [
+            {
+                name: 'OpenClaw (default)',
+                value: 'openclaw',
+                description: 'Writes ~/.openclaw/openclaw.json — PD runs as an OpenClaw plugin.',
+            },
+            {
+                name: 'Codex CLI',
+                value: 'codex',
+                description: 'Writes ~/.codex/hooks.json — PD runs as a Codex hook subprocess.',
+            },
+            {
+                name: 'All hosts',
+                value: 'all',
+                description: 'Writes both OpenClaw and Codex configs — for operators using multiple hosts.',
+            },
+        ],
+        default: defaultHost,
+    });
+}
+async function promptLanguage() {
+    return await select({
+        message: 'Select language / 选择语言',
+        choices: [
+            { name: 'English', value: 'en' },
+            { name: '中文', value: 'zh' },
+        ],
+        default: 'zh',
+    });
+}
+async function promptInstallMode(defaultMode = 'smart') {
+    return await select({
+        message: t('install_mode'),
+        choices: [
+            {
+                name: t('smart_merge') + ' — ' + t('smart_mode_desc'),
+                value: 'smart',
+                description: t('smart_mode_desc'),
+            },
+            {
+                name: t('force_overwrite') + ' — ' + t('force_mode_desc'),
+                value: 'force',
+                description: t('force_mode_desc'),
+            },
+        ],
+        default: defaultMode,
+    });
+}
+async function promptWorkspace(workspaceInfo) {
+    const choices = [
+        {
+            name: `${t('use_detected')}: ${workspaceInfo.detectedPath}`,
+            value: 'detected',
+        },
+        {
+            name: t('custom_dir'),
+            value: 'custom',
+        },
+    ];
+    const selection = await select({
+        message: `${t('workspace_dir')} ${workspaceInfo.hasPrinciples ? '(Principles detected)' : ''}`,
+        choices,
+        default: 'detected',
+    });
+    if (selection === 'custom') {
+        return await input({
+            message: t('enter_path'),
+            default: path.join(os.homedir(), 'clawd'),
+            validate: (value) => {
+                if (!value.trim())
+                    return t('path_empty_error');
+                return true;
+            },
+        });
+    }
+    return workspaceInfo.detectedPath;
+}
+function showMvpCoreChannels() {
+    console.log(`\n${t('mvp_channels')}`);
+    for (const ch of MVP_CHANNELS) {
+        const labels = {
+            prompt: { en: 'soft principle injection', zh: '软原则注入' },
+            code_tool_hook: { en: 'Rule Host hard enforcement', zh: 'Rule Host 强制约束' },
+            defer_archive: { en: 'graceful deferral', zh: '优雅延迟' },
+        };
+        console.log(`  ${ch} — ${labels[ch]?.[getLanguage()] ?? labels[ch]?.en ?? ''}`);
+    }
+    console.log();
+}
+async function promptConfirm(options) {
+    console.log(`\n${t('install_config')}`);
+    console.log(`  ${t('language')}: ${options.language}`);
+    console.log(`  Host platform: ${options.host ?? 'openclaw (default)'}`);
+    console.log(`  ${t('mode')}: ${options.mode === 'force' ? t('force_overwrite') : t('smart_merge')}`);
+    console.log(`  ${t('workspace')}: ${options.workspaceDir}`);
+    console.log(`  ${t('mvp_channels_enabled')}: ${MVP_CHANNELS.join(', ')}`);
+    // Fix-4: surface runtime profile status so user knows whether LLM features will work.
+    if (options.runtimeProfile) {
+        console.log(`  LLM runtime profile: ${options.runtimeProfile.provider} / ${options.runtimeProfile.model} (key: $${options.runtimeProfile.apiKeyEnv})`);
+    }
+    else {
+        console.log(`  LLM runtime profile: not configured (configure later via console)`);
+    }
+    return await confirm({
+        message: t('confirm_install'),
+        default: true,
+    });
+}
+export async function runPrompts(cliOptions = {}, workspaceInfo) {
+    const wsInfo = workspaceInfo || detectWorkspace();
+    const language = cliOptions.language ?? await promptLanguage();
+    setLanguage(language);
+    // ADR-0020 §2.3: prompt for host target if not supplied via --host.
+    const host = cliOptions.host ?? await promptHost();
+    let { mode } = cliOptions;
+    if (!mode) {
+        const defaultMode = wsInfo.isFirstInstall ? 'force' : 'smart';
+        if (!wsInfo.isFirstInstall && wsInfo.coreFiles && wsInfo.coreFiles.length > 0) {
+            console.log(`\n${t('existing_core_files')} ${wsInfo.coreFiles.join(', ')}`);
+            console.log(`  ${t('smart_mode_desc')}\n`);
+        }
+        mode = await promptInstallMode(defaultMode);
+    }
+    const workspaceDir = cliOptions.workspaceDir ?? await promptWorkspace(wsInfo);
+    showMvpCoreChannels();
+    // Fix-4 (P0-BUG-4): collect LLM runtime profile after channels are shown,
+    // before final confirmation. Skipped automatically in non-interactive mode
+    // (caller passes runtimeProfile via cliOptions or leaves it undefined).
+    const runtimeProfile = cliOptions.runtimeProfile !== undefined
+        ? cliOptions.runtimeProfile
+        : await promptRuntimeProfile();
+    const options = {
+        language,
+        mode,
+        workspaceDir,
+        channels: [...MVP_CHANNELS],
+        overwriteConfig: false,
+        host,
+        runtimeProfile,
+        stopGateway: cliOptions.stopGateway === true,
+    };
+    const confirmed = await promptConfirm(options);
+    if (!confirmed) {
+        console.log(`\n${t('cancel_install')}\n`);
+        return null;
+    }
+    return options;
+}
+export { confirm, input, select };
+//# sourceMappingURL=prompts.js.map

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

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

package/release-manager/dist/skill-language.d.ts

@@ -0,0 +1,32 @@
+export type SkillLanguage = 'zh' | 'en';
+export declare const SKILL_LANGUAGE_ROOTS: Record<SkillLanguage, string>;
+export interface SkillLanguageResult {
+    applied: boolean;
+    /** rc-9: structured reason whenever selection did NOT apply. */
+    note?: string;
+}
+/**
+ * Detect the single declared language root.
+ * Returns null when zero, both, or malformed entries are declared — callers
+ * treat that as "no explicit selection" and fall back to the product default.
+ */
+export declare function detectSkillLanguage(manifestRaw: unknown): SkillLanguage | null;
+/**
+ * Pure manifest transform: strip every language skill root, then declare
+ * exactly the selected language's root. Non-language entries (e.g. future
+ * non-localized skill dirs) are preserved; non-string junk entries are
+ * dropped (the host drops them anyway during normalization).
+ * Returns null when the manifest has no skills array to select for.
+ */
+export declare function applySkillLanguageToManifest(manifestRaw: unknown, language: SkillLanguage): {
+    manifest: Record<string, unknown>;
+    changed: boolean;
+} | null;
+/**
+ * Apply language selection to the manifest inside an installed extension dir.
+ * Never throws — this is a post-copy hardening step, and failing it must not
+ * roll back an otherwise complete install. Every skip path returns a
+ * structured note for the caller to surface (rc-9).
+ */
+export declare function applySkillLanguageSelection(extDir: string, language: SkillLanguage): SkillLanguageResult;
+//# sourceMappingURL=skill-language.d.ts.map

package/release-manager/dist/skill-language.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-language.d.ts","sourceRoot":"","sources":["../src/skill-language.ts"],"names":[],"mappings":"AAuBA,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,CAAC;AAExC,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAG9D,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAaD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAU9E;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,OAAO,EACpB,QAAQ,EAAE,aAAa,GACtB;IAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAWhE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,mBAAmB,CAuBxG"}

package/release-manager/dist/skill-language.js

@@ -0,0 +1,107 @@
+/**
+ * Install-time skill-language selection (PR #1332 follow-up, ERR-097).
+ *
+ * OpenClaw (verified on installed 2026.7.1-2) publishes plugin skills by
+ * directory NAME: every immediate child of a declared `skills` root that
+ * contains a SKILL.md is linked into ~/.openclaw/plugin-skills/<name>, the
+ * first declaration wins, and later same-name roots only produce
+ * "plugin skill name collision" warnings. There is no locale mechanism.
+ *
+ * Consequence: exactly ONE language root may be declared. The published
+ * manifest declares the product default (zh); installs requested with
+ * `--lang en` rewrite the INSTALLED manifest to the en root at
+ * materialization time. The shipped package stays zh-only so any
+ * materialization path that forgets to select degrades to the
+ * collision-free default instead of regressing to 23 collision warnings.
+ *
+ * The same transform (detect + re-apply) is mirrored in
+ * packages/pd-console/src/server/routes/update.ts so console updates
+ * preserve the user's language choice; keep the two in sync.
+ */
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+export const SKILL_LANGUAGE_ROOTS = {
+    zh: 'templates/langs/zh/skills',
+    en: 'templates/langs/en/skills',
+};
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isLanguageSkillRoot(entry, language) {
+    if (typeof entry !== 'string')
+        return false;
+    const normalized = entry.replaceAll('\\', '/');
+    const languages = language ? [language] : ['zh', 'en'];
+    return languages.some((lang) => normalized === SKILL_LANGUAGE_ROOTS[lang]);
+}
+/**
+ * Detect the single declared language root.
+ * Returns null when zero, both, or malformed entries are declared — callers
+ * treat that as "no explicit selection" and fall back to the product default.
+ */
+export function detectSkillLanguage(manifestRaw) {
+    if (!isRecord(manifestRaw) || !Array.isArray(manifestRaw.skills))
+        return null;
+    const languages = new Set();
+    for (const entry of manifestRaw.skills) {
+        if (isLanguageSkillRoot(entry, 'zh'))
+            languages.add('zh');
+        else if (isLanguageSkillRoot(entry, 'en'))
+            languages.add('en');
+    }
+    if (languages.size !== 1)
+        return null;
+    for (const language of languages)
+        return language;
+    return null;
+}
+/**
+ * Pure manifest transform: strip every language skill root, then declare
+ * exactly the selected language's root. Non-language entries (e.g. future
+ * non-localized skill dirs) are preserved; non-string junk entries are
+ * dropped (the host drops them anyway during normalization).
+ * Returns null when the manifest has no skills array to select for.
+ */
+export function applySkillLanguageToManifest(manifestRaw, language) {
+    if (!isRecord(manifestRaw) || !Array.isArray(manifestRaw.skills))
+        return null;
+    const skills = manifestRaw.skills;
+    const kept = skills.filter((entry) => typeof entry === 'string' && !isLanguageSkillRoot(entry));
+    const next = [...kept, SKILL_LANGUAGE_ROOTS[language]];
+    const unchanged = next.length === skills.length && next.every((entry, i) => entry === skills[i]);
+    if (unchanged)
+        return { manifest: manifestRaw, changed: false };
+    return { manifest: { ...manifestRaw, skills: next }, changed: true };
+}
+/**
+ * Apply language selection to the manifest inside an installed extension dir.
+ * Never throws — this is a post-copy hardening step, and failing it must not
+ * roll back an otherwise complete install. Every skip path returns a
+ * structured note for the caller to surface (rc-9).
+ */
+export function applySkillLanguageSelection(extDir, language) {
+    const manifestPath = join(extDir, 'openclaw.plugin.json');
+    if (!existsSync(manifestPath)) {
+        return { applied: false, note: 'manifest_missing' };
+    }
+    const templateRoot = join(extDir, SKILL_LANGUAGE_ROOTS[language]);
+    if (!existsSync(templateRoot)) {
+        return { applied: false, note: `skill_templates_missing:${SKILL_LANGUAGE_ROOTS[language]}` };
+    }
+    let manifestRaw;
+    try {
+        manifestRaw = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+    }
+    catch {
+        return { applied: false, note: 'manifest_unparseable' };
+    }
+    const shaped = applySkillLanguageToManifest(manifestRaw, language);
+    if (shaped === null) {
+        return { applied: false, note: 'manifest_has_no_skills_array' };
+    }
+    if (shaped.changed) {
+        writeFileSync(manifestPath, JSON.stringify(shaped.manifest, null, 2) + '\n', 'utf-8');
+    }
+    return { applied: true };
+}
+//# sourceMappingURL=skill-language.js.map

package/release-manager/dist/skill-language.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-language.js","sourceRoot":"","sources":["../src/skill-language.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI5B,MAAM,CAAC,MAAM,oBAAoB,GAAkC;IACjE,EAAE,EAAE,2BAA2B;IAC/B,EAAE,EAAE,2BAA2B;CAChC,CAAC;AAQF,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc,EAAE,QAAwB;IACnE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAoB,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxE,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,KAAK,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAoB;IACtD,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9E,MAAM,SAAS,GAAG,IAAI,GAAG,EAAiB,CAAC;IAC3C,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;QACvC,IAAI,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC;YAAE,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;aACrD,IAAI,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC;YAAE,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,KAAK,MAAM,QAAQ,IAAI,SAAS;QAAE,OAAO,QAAQ,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B,CAC1C,WAAoB,EACpB,QAAuB;IAEvB,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9E,MAAM,MAAM,GAAc,WAAW,CAAC,MAAM,CAAC;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CACpD,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CACzD,CAAC;IACF,MAAM,IAAI,GAAa,CAAC,GAAG,IAAI,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjE,MAAM,SAAS,GACb,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACjF,IAAI,SAAS;QAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAChE,OAAO,EAAE,QAAQ,EAAE,EAAE,GAAG,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACvE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAc,EAAE,QAAuB;IACjF,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAC1D,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;IACtD,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,2BAA2B,oBAAoB,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;IAC/F,CAAC;IACD,IAAI,WAAoB,CAAC;IACzB,IAAI,CAAC;QACH,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAAC;IAC1D,CAAC;IACD,MAAM,MAAM,GAAG,4BAA4B,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACnE,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,8BAA8B,EAAE,CAAC;IAClE,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC"}

package/release-manager/dist/uninstaller.d.ts

@@ -0,0 +1,55 @@
+import { type HostTarget } from './installers/index.js';
+export interface UninstallResult {
+    success: boolean;
+    removedDirs: string[];
+    removedFiles: string[];
+    removedGlobalShims: string[];
+    skippedGlobalShims: string[];
+    preservedPaths: string[];
+    error?: string;
+}
+interface SharedRuntimeUninstallPlan {
+    removeSharedRuntime: boolean;
+    remainingHosts: ('codex' | 'openclaw')[];
+    manifestHasTarget: boolean;
+    warning?: string;
+}
+export declare function planSharedRuntimeUninstall(host: HostTarget): SharedRuntimeUninstallPlan;
+/**
+ * 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 declare function checkInstallStatus(host?: HostTarget): {
+    isInstalled: boolean;
+    paths: {
+        exists: boolean;
+        path: string;
+        name: string;
+        type: 'dir' | 'file';
+    }[];
+};
+/**
+ * 检查 shim 文件是否由 Principles Disciple 创建
+ * 通过读取文件内容，确认其目标指向 PD 安装目录
+ */
+export declare function isPdOwnedShim(shimPath: string): boolean;
+export declare function uninstall(options?: {
+    force?: boolean;
+    lang?: string;
+    /**
+     * ADR-0020 §2.3: Host target for uninstall.
+     * - 'openclaw' — clean up OpenClaw config only.
+     * - 'codex'    — clean up Codex hooks only.
+     * - 'all' (default) — clean up both hosts.
+     *
+     * Default is 'all' for thorough cleanup (unlike install where default
+     * is 'openclaw' for backward compatibility).
+     */
+    host?: HostTarget;
+}): Promise<UninstallResult>;
+export {};
+//# sourceMappingURL=uninstaller.d.ts.map

package/release-manager/dist/uninstaller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstaller.d.ts","sourceRoot":"","sources":["../src/uninstaller.ts"],"names":[],"mappings":"AA2BA,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAG3E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,0BAA0B;IAClC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,cAAc,EAAE,CAAC,OAAO,GAAG,UAAU,CAAC,EAAE,CAAC;IACzC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,UAAU,GAAG,0BAA0B,CA0BvF;AAMD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,UAAkB,GAAG;IAC5D,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE;QACL,MAAM,EAAE,OAAO,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;KACtB,EAAE,CAAC;CACL,CAwCA;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAkBvD;AA2FD,wBAAsB,SAAS,CAC7B,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;CACd,GACL,OAAO,CAAC,eAAe,CAAC,CA6M1B"}