@sheason/pi-coding-agent 0.74.1-sheason.0 → 0.78.0-sheason.0.6.0-alpha.2

package/dist/modes/serve/serve-mode.js

@@ -0,0 +1,217 @@
+import { APP_NAME, getChangelogPath, VERSION } from "../../config.js";
+import { KeybindingsManager } from "../../core/keybindings.js";
+import { LocalAgentSessionProxy } from "../../core/local-agent-session-proxy.js";
+import { getNewEntries, parseChangelog } from "../../utils/changelog.js";
+import { formatKeyText } from "../interactive/components/keybinding-hints.js";
+import { AgentHttpServer } from "./http-server.js";
+const DEFAULT_PORT = 8080;
+/** Get the display text for a keybinding (theme-independent). */
+function keyText(kb, keybinding) {
+    const keys = kb.getKeys(keybinding);
+    if (keys.length === 0)
+        return "";
+    return formatKeyText(keys.join("/"));
+}
+/** Generate structured banner data for serve/connect. */
+export function generateBanner(session) {
+    // Use the app's KeybindingsManager which includes app-specific bindings
+    const kb = KeybindingsManager.create();
+    const expandedHints = [
+        { key: keyText(kb, "app.interrupt"), description: "to interrupt" },
+        { key: keyText(kb, "app.clear"), description: "to clear" },
+        { key: `${keyText(kb, "app.clear")} twice`, description: "to exit" },
+        { key: keyText(kb, "app.exit"), description: "to exit (empty)" },
+        { key: keyText(kb, "app.suspend"), description: "to suspend" },
+        { key: keyText(kb, "tui.editor.deleteToLineEnd"), description: "to delete to end" },
+        { key: keyText(kb, "app.thinking.cycle"), description: "to cycle thinking level" },
+        {
+            key: `${keyText(kb, "app.model.cycleForward")}/${keyText(kb, "app.model.cycleBackward")}`,
+            description: "to cycle models",
+        },
+        { key: keyText(kb, "app.model.select"), description: "to select model" },
+        { key: keyText(kb, "app.tools.expand"), description: "to expand tools" },
+        { key: keyText(kb, "app.thinking.toggle"), description: "to expand thinking" },
+        { key: keyText(kb, "app.editor.external"), description: "for external editor" },
+        { key: "/", description: "for commands" },
+        { key: "!", description: "to run bash" },
+        { key: "!!", description: "to run bash (no context)" },
+        { key: keyText(kb, "app.message.followUp"), description: "to queue follow-up" },
+        { key: keyText(kb, "app.message.dequeue"), description: "to edit all queued messages" },
+        { key: keyText(kb, "app.clipboard.pasteImage"), description: "to paste image" },
+        { key: "drop files", description: "to attach" },
+    ];
+    const compactHints = [
+        { key: keyText(kb, "app.interrupt"), description: "interrupt" },
+        { key: `${keyText(kb, "app.clear")}/${keyText(kb, "app.exit")}`, description: "clear/exit" },
+        { key: "/", description: "commands" },
+        { key: "!", description: "bash" },
+        { key: keyText(kb, "app.tools.expand"), description: "more" },
+    ];
+    const compactOnboarding = `Press ${keyText(kb, "app.tools.expand")} to show full startup help and loaded resources.`;
+    const onboarding = `Pi can explain its own features and look up its docs. Ask it how to use or extend Pi.`;
+    // Gather loaded resources from the session
+    const loadedResources = [];
+    const rl = session.resourceLoader;
+    // Context files
+    const contextFiles = rl.getAgentsFiles().agentsFiles;
+    if (contextFiles.length > 0) {
+        loadedResources.push({
+            name: "Context",
+            compactList: contextFiles.map((f) => f.path).join(", "),
+            expandedList: contextFiles.map((f) => f.path).join("\n"),
+        });
+    }
+    // Skills
+    const skills = rl.getSkills().skills;
+    if (skills.length > 0) {
+        loadedResources.push({
+            name: "Skills",
+            compactList: skills
+                .map((s) => s.name)
+                .sort()
+                .join(", "),
+            expandedList: skills.map((s) => s.filePath).join("\n"),
+        });
+    }
+    // Prompts (templates)
+    const templates = session.promptTemplates;
+    if (templates.length > 0) {
+        loadedResources.push({
+            name: "Prompts",
+            compactList: templates
+                .map((t) => `/${t.name}`)
+                .sort()
+                .join(", "),
+            expandedList: templates.map((t) => t.filePath).join("\n"),
+        });
+    }
+    // Extensions — tool registration and events work, UI calls degrade to no-ops
+    const extensions = rl.getExtensions().extensions;
+    if (extensions.length > 0) {
+        loadedResources.push({
+            name: "Extensions",
+            compactList: extensions.map((e) => e.path.split("/").pop() ?? e.path).join(", "),
+            expandedList: extensions.map((e) => e.path).join("\n"),
+        });
+    }
+    // Themes (custom only)
+    const themes = rl.getThemes().themes.filter((t) => t.sourcePath);
+    if (themes.length > 0) {
+        loadedResources.push({
+            name: "Themes",
+            compactList: themes
+                .map((t) => t.name ?? "")
+                .filter(Boolean)
+                .sort()
+                .join(", "),
+            expandedList: themes.map((t) => t.sourcePath).join("\n"),
+        });
+    }
+    // Diagnostics
+    const diagnostics = [];
+    const skillDiagnostics = rl.getSkills().diagnostics;
+    if (skillDiagnostics.length > 0) {
+        diagnostics.push({ label: "Skill conflicts", entries: skillDiagnostics });
+    }
+    const promptDiagnostics = rl.getPrompts().diagnostics;
+    if (promptDiagnostics.length > 0) {
+        diagnostics.push({ label: "Prompt conflicts", entries: promptDiagnostics });
+    }
+    const extensionErrors = rl.getExtensions().errors;
+    if (extensionErrors.length > 0) {
+        diagnostics.push({
+            label: "Extension issues",
+            entries: extensionErrors.map((e) => ({
+                type: "error",
+                message: e.error,
+                path: e.path,
+            })),
+        });
+    }
+    // Changelog — only show new entries since last seen version (same logic as local mode)
+    let changelogMarkdown;
+    const lastVersion = session.settingsManager.getLastChangelogVersion();
+    const changelogEntries = parseChangelog(getChangelogPath());
+    if (lastVersion && changelogEntries.length > 0) {
+        const newEntries = getNewEntries(changelogEntries, lastVersion);
+        if (newEntries.length > 0) {
+            changelogMarkdown = newEntries.map((e) => e.content).join("\n\n");
+        }
+    }
+    return {
+        appName: APP_NAME,
+        version: VERSION,
+        expandedHints,
+        compactHints,
+        compactOnboarding,
+        onboarding,
+        loadedResources,
+        diagnostics,
+        changelogMarkdown,
+    };
+}
+export async function runServeMode(runtime, options = {}) {
+    const port = options.port ?? DEFAULT_PORT;
+    const proxy = new LocalAgentSessionProxy(runtime);
+    // Generate and set banner data for connect clients
+    proxy.setBanner(generateBanner(runtime.session));
+    const server = new AgentHttpServer(proxy);
+    // Bind extensions — no UI context (hasUI() === false), tool registration
+    // and event subscriptions work normally. UI calls degrade to no-ops.
+    const rebindSession = async () => {
+        const session = runtime.session;
+        await session.bindExtensions({
+            commandContextActions: {
+                waitForIdle: () => session.agent.waitForIdle(),
+                newSession: async (newSessionOptions) => runtime.newSession(newSessionOptions),
+                fork: async (entryId, forkOptions) => {
+                    const result = await runtime.fork(entryId, forkOptions);
+                    return { cancelled: result.cancelled };
+                },
+                navigateTree: async (targetId, navigateOptions) => {
+                    const result = await session.navigateTree(targetId, {
+                        summarize: navigateOptions?.summarize,
+                        customInstructions: navigateOptions?.customInstructions,
+                        replaceInstructions: navigateOptions?.replaceInstructions,
+                        label: navigateOptions?.label,
+                    });
+                    return { cancelled: result.cancelled };
+                },
+                switchSession: async (sessionPath, switchOptions) => {
+                    return runtime.switchSession(sessionPath, switchOptions);
+                },
+                reload: async () => {
+                    await session.reload();
+                },
+            },
+            abortHandler: () => {
+                // No UI to reset in serve mode
+            },
+            onError: (err) => {
+                process.stderr.write(`[serve] Extension error (${err.extensionPath}): ${err.error}\n`);
+            },
+        });
+    };
+    // Set up beforeSessionInvalidate callback
+    runtime.setBeforeSessionInvalidate(() => {
+        // No UI to reset in serve mode
+    });
+    // Set up rebindSession — must call bindExtensions for each new session
+    // so extension event handlers (session_start, etc.) fire correctly.
+    // Also re-subscribe proxy listeners so SSE events keep flowing.
+    runtime.setRebindSession(async (session, reason) => {
+        proxy.resubscribe(reason);
+        await rebindSession();
+        // Update banner after session replacement
+        proxy.setBanner(generateBanner(session));
+    });
+    // Initial bind for the first session
+    await rebindSession();
+    await server.start(port);
+    // Log to stderr so stdout stays clean
+    process.stderr.write(`[serve] Listening on port ${port}\n`);
+    process.stderr.write(`[serve] Connect with: pi --mode connect --url http://localhost:${port}\n`);
+    // Keep process alive
+    return new Promise(() => { });
+}
+//# sourceMappingURL=serve-mode.js.map

package/dist/modes/serve/serve-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-mode.js","sourceRoot":"","sources":["../../../src/modes/serve/serve-mode.ts"],"names":[],"mappings":"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","sourcesContent":["import { APP_NAME, getChangelogPath, VERSION } from \"../../config.ts\";\nimport type { AgentSession } from \"../../core/agent-session.ts\";\nimport type {\n\tBannerData,\n\tBannerKeyHint,\n\tLoadedResourceSection,\n\tResourceDiagnosticEntry,\n} from \"../../core/agent-session-proxy.ts\";\nimport type { AgentSessionRuntime } from \"../../core/agent-session-runtime.ts\";\nimport { type AppKeybinding, KeybindingsManager } from \"../../core/keybindings.ts\";\nimport { LocalAgentSessionProxy } from \"../../core/local-agent-session-proxy.ts\";\nimport { getNewEntries, parseChangelog } from \"../../utils/changelog.ts\";\nimport { formatKeyText } from \"../interactive/components/keybinding-hints.ts\";\nimport { AgentHttpServer } from \"./http-server.ts\";\n\nexport interface ServeModeOptions {\n\tport?: number;\n}\n\nconst DEFAULT_PORT = 8080;\n\n/** Get the display text for a keybinding (theme-independent). */\nfunction keyText(kb: KeybindingsManager, keybinding: string): string {\n\tconst keys = kb.getKeys(keybinding as AppKeybinding);\n\tif (keys.length === 0) return \"\";\n\treturn formatKeyText(keys.join(\"/\"));\n}\n\n/** Generate structured banner data for serve/connect. */\nexport function generateBanner(session: AgentSession): BannerData {\n\t// Use the app's KeybindingsManager which includes app-specific bindings\n\tconst kb = KeybindingsManager.create();\n\n\tconst expandedHints: BannerKeyHint[] = [\n\t\t{ key: keyText(kb, \"app.interrupt\"), description: \"to interrupt\" },\n\t\t{ key: keyText(kb, \"app.clear\"), description: \"to clear\" },\n\t\t{ key: `${keyText(kb, \"app.clear\")} twice`, description: \"to exit\" },\n\t\t{ key: keyText(kb, \"app.exit\"), description: \"to exit (empty)\" },\n\t\t{ key: keyText(kb, \"app.suspend\"), description: \"to suspend\" },\n\t\t{ key: keyText(kb, \"tui.editor.deleteToLineEnd\"), description: \"to delete to end\" },\n\t\t{ key: keyText(kb, \"app.thinking.cycle\"), description: \"to cycle thinking level\" },\n\t\t{\n\t\t\tkey: `${keyText(kb, \"app.model.cycleForward\")}/${keyText(kb, \"app.model.cycleBackward\")}`,\n\t\t\tdescription: \"to cycle models\",\n\t\t},\n\t\t{ key: keyText(kb, \"app.model.select\"), description: \"to select model\" },\n\t\t{ key: keyText(kb, \"app.tools.expand\"), description: \"to expand tools\" },\n\t\t{ key: keyText(kb, \"app.thinking.toggle\"), description: \"to expand thinking\" },\n\t\t{ key: keyText(kb, \"app.editor.external\"), description: \"for external editor\" },\n\t\t{ key: \"/\", description: \"for commands\" },\n\t\t{ key: \"!\", description: \"to run bash\" },\n\t\t{ key: \"!!\", description: \"to run bash (no context)\" },\n\t\t{ key: keyText(kb, \"app.message.followUp\"), description: \"to queue follow-up\" },\n\t\t{ key: keyText(kb, \"app.message.dequeue\"), description: \"to edit all queued messages\" },\n\t\t{ key: keyText(kb, \"app.clipboard.pasteImage\"), description: \"to paste image\" },\n\t\t{ key: \"drop files\", description: \"to attach\" },\n\t];\n\tconst compactHints: BannerKeyHint[] = [\n\t\t{ key: keyText(kb, \"app.interrupt\"), description: \"interrupt\" },\n\t\t{ key: `${keyText(kb, \"app.clear\")}/${keyText(kb, \"app.exit\")}`, description: \"clear/exit\" },\n\t\t{ key: \"/\", description: \"commands\" },\n\t\t{ key: \"!\", description: \"bash\" },\n\t\t{ key: keyText(kb, \"app.tools.expand\"), description: \"more\" },\n\t];\n\tconst compactOnboarding = `Press ${keyText(kb, \"app.tools.expand\")} to show full startup help and loaded resources.`;\n\tconst onboarding = `Pi can explain its own features and look up its docs. Ask it how to use or extend Pi.`;\n\n\t// Gather loaded resources from the session\n\tconst loadedResources: LoadedResourceSection[] = [];\n\tconst rl = session.resourceLoader;\n\n\t// Context files\n\tconst contextFiles = rl.getAgentsFiles().agentsFiles;\n\tif (contextFiles.length > 0) {\n\t\tloadedResources.push({\n\t\t\tname: \"Context\",\n\t\t\tcompactList: contextFiles.map((f) => f.path).join(\", \"),\n\t\t\texpandedList: contextFiles.map((f) => f.path).join(\"\\n\"),\n\t\t});\n\t}\n\n\t// Skills\n\tconst skills = rl.getSkills().skills;\n\tif (skills.length > 0) {\n\t\tloadedResources.push({\n\t\t\tname: \"Skills\",\n\t\t\tcompactList: skills\n\t\t\t\t.map((s) => s.name)\n\t\t\t\t.sort()\n\t\t\t\t.join(\", \"),\n\t\t\texpandedList: skills.map((s) => s.filePath).join(\"\\n\"),\n\t\t});\n\t}\n\n\t// Prompts (templates)\n\tconst templates = session.promptTemplates;\n\tif (templates.length > 0) {\n\t\tloadedResources.push({\n\t\t\tname: \"Prompts\",\n\t\t\tcompactList: templates\n\t\t\t\t.map((t) => `/${t.name}`)\n\t\t\t\t.sort()\n\t\t\t\t.join(\", \"),\n\t\t\texpandedList: templates.map((t) => t.filePath).join(\"\\n\"),\n\t\t});\n\t}\n\n\t// Extensions — tool registration and events work, UI calls degrade to no-ops\n\tconst extensions = rl.getExtensions().extensions;\n\tif (extensions.length > 0) {\n\t\tloadedResources.push({\n\t\t\tname: \"Extensions\",\n\t\t\tcompactList: extensions.map((e) => e.path.split(\"/\").pop() ?? e.path).join(\", \"),\n\t\t\texpandedList: extensions.map((e) => e.path).join(\"\\n\"),\n\t\t});\n\t}\n\n\t// Themes (custom only)\n\tconst themes = rl.getThemes().themes.filter((t) => t.sourcePath);\n\tif (themes.length > 0) {\n\t\tloadedResources.push({\n\t\t\tname: \"Themes\",\n\t\t\tcompactList: themes\n\t\t\t\t.map((t) => t.name ?? \"\")\n\t\t\t\t.filter(Boolean)\n\t\t\t\t.sort()\n\t\t\t\t.join(\", \"),\n\t\t\texpandedList: themes.map((t) => t.sourcePath!).join(\"\\n\"),\n\t\t});\n\t}\n\n\t// Diagnostics\n\tconst diagnostics: Array<{ label: string; entries: ResourceDiagnosticEntry[] }> = [];\n\n\tconst skillDiagnostics = rl.getSkills().diagnostics;\n\tif (skillDiagnostics.length > 0) {\n\t\tdiagnostics.push({ label: \"Skill conflicts\", entries: skillDiagnostics as ResourceDiagnosticEntry[] });\n\t}\n\n\tconst promptDiagnostics = rl.getPrompts().diagnostics;\n\tif (promptDiagnostics.length > 0) {\n\t\tdiagnostics.push({ label: \"Prompt conflicts\", entries: promptDiagnostics as ResourceDiagnosticEntry[] });\n\t}\n\n\tconst extensionErrors = rl.getExtensions().errors;\n\tif (extensionErrors.length > 0) {\n\t\tdiagnostics.push({\n\t\t\tlabel: \"Extension issues\",\n\t\t\tentries: extensionErrors.map((e) => ({\n\t\t\t\ttype: \"error\" as const,\n\t\t\t\tmessage: e.error,\n\t\t\t\tpath: e.path,\n\t\t\t})),\n\t\t});\n\t}\n\n\t// Changelog — only show new entries since last seen version (same logic as local mode)\n\tlet changelogMarkdown: string | undefined;\n\tconst lastVersion = session.settingsManager.getLastChangelogVersion();\n\tconst changelogEntries = parseChangelog(getChangelogPath());\n\tif (lastVersion && changelogEntries.length > 0) {\n\t\tconst newEntries = getNewEntries(changelogEntries, lastVersion);\n\t\tif (newEntries.length > 0) {\n\t\t\tchangelogMarkdown = newEntries.map((e) => e.content).join(\"\\n\\n\");\n\t\t}\n\t}\n\n\treturn {\n\t\tappName: APP_NAME,\n\t\tversion: VERSION,\n\t\texpandedHints,\n\t\tcompactHints,\n\t\tcompactOnboarding,\n\t\tonboarding,\n\t\tloadedResources,\n\t\tdiagnostics,\n\t\tchangelogMarkdown,\n\t};\n}\n\nexport async function runServeMode(runtime: AgentSessionRuntime, options: ServeModeOptions = {}): Promise<void> {\n\tconst port = options.port ?? DEFAULT_PORT;\n\tconst proxy = new LocalAgentSessionProxy(runtime);\n\n\t// Generate and set banner data for connect clients\n\tproxy.setBanner(generateBanner(runtime.session));\n\n\tconst server = new AgentHttpServer(proxy);\n\n\t// Bind extensions — no UI context (hasUI() === false), tool registration\n\t// and event subscriptions work normally. UI calls degrade to no-ops.\n\tconst rebindSession = async (): Promise<void> => {\n\t\tconst session = runtime.session;\n\t\tawait session.bindExtensions({\n\t\t\tcommandContextActions: {\n\t\t\t\twaitForIdle: () => session.agent.waitForIdle(),\n\t\t\t\tnewSession: async (newSessionOptions) => runtime.newSession(newSessionOptions),\n\t\t\t\tfork: async (entryId, forkOptions) => {\n\t\t\t\t\tconst result = await runtime.fork(entryId, forkOptions);\n\t\t\t\t\treturn { cancelled: result.cancelled };\n\t\t\t\t},\n\t\t\t\tnavigateTree: async (targetId, navigateOptions) => {\n\t\t\t\t\tconst result = await session.navigateTree(targetId, {\n\t\t\t\t\t\tsummarize: navigateOptions?.summarize,\n\t\t\t\t\t\tcustomInstructions: navigateOptions?.customInstructions,\n\t\t\t\t\t\treplaceInstructions: navigateOptions?.replaceInstructions,\n\t\t\t\t\t\tlabel: navigateOptions?.label,\n\t\t\t\t\t});\n\t\t\t\t\treturn { cancelled: result.cancelled };\n\t\t\t\t},\n\t\t\t\tswitchSession: async (sessionPath, switchOptions) => {\n\t\t\t\t\treturn runtime.switchSession(sessionPath, switchOptions);\n\t\t\t\t},\n\t\t\t\treload: async () => {\n\t\t\t\t\tawait session.reload();\n\t\t\t\t},\n\t\t\t},\n\t\t\tabortHandler: () => {\n\t\t\t\t// No UI to reset in serve mode\n\t\t\t},\n\t\t\tonError: (err) => {\n\t\t\t\tprocess.stderr.write(`[serve] Extension error (${err.extensionPath}): ${err.error}\\n`);\n\t\t\t},\n\t\t});\n\t};\n\n\t// Set up beforeSessionInvalidate callback\n\truntime.setBeforeSessionInvalidate(() => {\n\t\t// No UI to reset in serve mode\n\t});\n\n\t// Set up rebindSession — must call bindExtensions for each new session\n\t// so extension event handlers (session_start, etc.) fire correctly.\n\t// Also re-subscribe proxy listeners so SSE events keep flowing.\n\truntime.setRebindSession(async (session, reason) => {\n\t\tproxy.resubscribe(reason);\n\t\tawait rebindSession();\n\t\t// Update banner after session replacement\n\t\tproxy.setBanner(generateBanner(session));\n\t});\n\n\t// Initial bind for the first session\n\tawait rebindSession();\n\n\tawait server.start(port);\n\n\t// Log to stderr so stdout stays clean\n\tprocess.stderr.write(`[serve] Listening on port ${port}\\n`);\n\tprocess.stderr.write(`[serve] Connect with: pi --mode connect --url http://localhost:${port}\\n`);\n\n\t// Keep process alive\n\treturn new Promise(() => {});\n}\n"]}

package/dist/package-manager-cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package-manager-cli.d.ts","sourceRoot":"","sources":["../src/package-manager-cli.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAkUtE,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAoB1E;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAiK3E","sourcesContent":["import chalk from \"chalk\";\nimport { spawn } from \"child_process\";\nimport { selectConfig } from \"./cli/config-selector.js\";\nimport {\n\tAPP_NAME,\n\tgetAgentDir,\n\tgetSelfUpdateCommand,\n\tgetSelfUpdateUnavailableInstruction,\n\tPACKAGE_NAME,\n\ttype SelfUpdateCommand,\n\tVERSION,\n} from \"./config.js\";\nimport { DefaultPackageManager } from \"./core/package-manager.js\";\nimport { SettingsManager } from \"./core/settings-manager.js\";\nimport { shouldUseWindowsShell } from \"./utils/child-process.js\";\nimport { getLatestPiRelease, isNewerPackageVersion } from \"./utils/version-check.js\";\n\nexport type PackageCommand = \"install\" | \"remove\" | \"update\" | \"list\";\n\ntype UpdateTarget = { type: \"all\" } | { type: \"self\" } | { type: \"extensions\"; source?: string };\n\ninterface PackageCommandOptions {\n\tcommand: PackageCommand;\n\tsource?: string;\n\tupdateTarget?: UpdateTarget;\n\tlocal: boolean;\n\tforce: boolean;\n\thelp: boolean;\n\tinvalidOption?: string;\n\tinvalidArgument?: string;\n\tmissingOptionValue?: string;\n\tconflictingOptions?: string;\n}\n\nfunction reportSettingsErrors(settingsManager: SettingsManager, context: string): void {\n\tconst errors = settingsManager.drainErrors();\n\tfor (const { scope, error } of errors) {\n\t\tconsole.error(chalk.yellow(`Warning (${context}, ${scope} settings): ${error.message}`));\n\t\tif (error.stack) {\n\t\t\tconsole.error(chalk.dim(error.stack));\n\t\t}\n\t}\n}\n\nfunction getPackageCommandUsage(command: PackageCommand): string {\n\tswitch (command) {\n\t\tcase \"install\":\n\t\t\treturn `${APP_NAME} install <source> [-l]`;\n\t\tcase \"remove\":\n\t\t\treturn `${APP_NAME} remove <source> [-l]`;\n\t\tcase \"update\":\n\t\t\treturn `${APP_NAME} update [source|self|pi] [--self] [--extensions] [--extension <source>] [--force]`;\n\t\tcase \"list\":\n\t\t\treturn `${APP_NAME} list`;\n\t}\n}\n\nfunction printPackageCommandHelp(command: PackageCommand): void {\n\tswitch (command) {\n\t\tcase \"install\":\n\t\t\tconsole.log(`${chalk.bold(\"Usage:\")}\n  ${getPackageCommandUsage(\"install\")}\n\nInstall a package and add it to settings.\n\nOptions:\n  -l, --local    Install project-locally (.pi/settings.json)\n\nExamples:\n  ${APP_NAME} install npm:@foo/bar\n  ${APP_NAME} install git:github.com/user/repo\n  ${APP_NAME} install git:git@github.com:user/repo\n  ${APP_NAME} install https://github.com/user/repo\n  ${APP_NAME} install ssh://git@github.com/user/repo\n  ${APP_NAME} install ./local/path\n`);\n\t\t\treturn;\n\n\t\tcase \"remove\":\n\t\t\tconsole.log(`${chalk.bold(\"Usage:\")}\n  ${getPackageCommandUsage(\"remove\")}\n\nRemove a package and its source from settings.\nAlias: ${APP_NAME} uninstall <source> [-l]\n\nOptions:\n  -l, --local    Remove from project settings (.pi/settings.json)\n\nExamples:\n  ${APP_NAME} remove npm:@foo/bar\n  ${APP_NAME} uninstall npm:@foo/bar\n`);\n\t\t\treturn;\n\n\t\tcase \"update\":\n\t\t\tconsole.log(`${chalk.bold(\"Usage:\")}\n  ${getPackageCommandUsage(\"update\")}\n\nUpdate pi and installed packages.\n\nOptions:\n  --self                  Update pi only\n  --extensions            Update installed packages only\n  --extension <source>    Update one package only\n  --force                 Reinstall pi even if the current version is latest\n\nShort forms:\n  ${APP_NAME} update                Update pi and all extensions\n  ${APP_NAME} update <source>       Update one package\n  ${APP_NAME} update pi             Update pi only (self works as alias to pi)\n`);\n\t\t\treturn;\n\n\t\tcase \"list\":\n\t\t\tconsole.log(`${chalk.bold(\"Usage:\")}\n  ${getPackageCommandUsage(\"list\")}\n\nList installed packages from user and project settings.\n`);\n\t\t\treturn;\n\t}\n}\n\nfunction parsePackageCommand(args: string[]): PackageCommandOptions | undefined {\n\tconst [rawCommand, ...rest] = args;\n\tlet command: PackageCommand | undefined;\n\tif (rawCommand === \"uninstall\") {\n\t\tcommand = \"remove\";\n\t} else if (rawCommand === \"install\" || rawCommand === \"remove\" || rawCommand === \"update\" || rawCommand === \"list\") {\n\t\tcommand = rawCommand;\n\t}\n\tif (!command) {\n\t\treturn undefined;\n\t}\n\n\tlet local = false;\n\tlet force = false;\n\tlet help = false;\n\tlet invalidOption: string | undefined;\n\tlet invalidArgument: string | undefined;\n\tlet missingOptionValue: string | undefined;\n\tlet conflictingOptions: string | undefined;\n\tlet source: string | undefined;\n\tlet selfFlag = false;\n\tlet extensionsFlag = false;\n\tlet extensionFlagSource: string | undefined;\n\n\tfor (let index = 0; index < rest.length; index++) {\n\t\tconst arg = rest[index];\n\t\tif (arg === \"-h\" || arg === \"--help\") {\n\t\t\thelp = true;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg === \"-l\" || arg === \"--local\") {\n\t\t\tif (command === \"install\" || command === \"remove\") {\n\t\t\t\tlocal = true;\n\t\t\t} else {\n\t\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg === \"--self\") {\n\t\t\tif (command === \"update\") {\n\t\t\t\tselfFlag = true;\n\t\t\t} else {\n\t\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg === \"--extensions\") {\n\t\t\tif (command === \"update\") {\n\t\t\t\textensionsFlag = true;\n\t\t\t} else {\n\t\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg === \"--force\") {\n\t\t\tif (command === \"update\") {\n\t\t\t\tforce = true;\n\t\t\t} else {\n\t\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg === \"--extension\") {\n\t\t\tif (command !== \"update\") {\n\t\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst value = rest[index + 1];\n\t\t\tif (!value || value.startsWith(\"-\")) {\n\t\t\t\tmissingOptionValue = missingOptionValue ?? arg;\n\t\t\t} else if (extensionFlagSource) {\n\t\t\t\tconflictingOptions = conflictingOptions ?? \"--extension can only be provided once\";\n\t\t\t\tindex++;\n\t\t\t} else {\n\t\t\t\textensionFlagSource = value;\n\t\t\t\tindex++;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg.startsWith(\"-\")) {\n\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (!source) {\n\t\t\tsource = arg;\n\t\t} else {\n\t\t\tinvalidArgument = invalidArgument ?? arg;\n\t\t}\n\t}\n\n\tlet updateTarget: UpdateTarget | undefined;\n\tif (command === \"update\") {\n\t\tif (extensionFlagSource) {\n\t\t\tif (selfFlag || extensionsFlag) {\n\t\t\t\tconflictingOptions = conflictingOptions ?? \"--extension cannot be combined with --self or --extensions\";\n\t\t\t}\n\t\t\tif (source) {\n\t\t\t\tconflictingOptions = conflictingOptions ?? \"--extension cannot be combined with a positional source\";\n\t\t\t}\n\t\t\tupdateTarget = { type: \"extensions\", source: extensionFlagSource };\n\t\t} else if (source) {\n\t\t\tconst sourceIsSelf = source === \"self\" || source === \"pi\";\n\t\t\tif (sourceIsSelf) {\n\t\t\t\tupdateTarget = extensionsFlag ? { type: \"all\" } : { type: \"self\" };\n\t\t\t} else {\n\t\t\t\tif (extensionsFlag || selfFlag) {\n\t\t\t\t\tconflictingOptions =\n\t\t\t\t\t\tconflictingOptions ?? \"positional update targets cannot be combined with --self or --extensions\";\n\t\t\t\t}\n\t\t\t\tupdateTarget = { type: \"extensions\", source };\n\t\t\t}\n\t\t} else if (selfFlag && extensionsFlag) {\n\t\t\tupdateTarget = { type: \"all\" };\n\t\t} else if (selfFlag) {\n\t\t\tupdateTarget = { type: \"self\" };\n\t\t} else if (extensionsFlag) {\n\t\t\tupdateTarget = { type: \"extensions\" };\n\t\t} else {\n\t\t\tupdateTarget = { type: \"all\" };\n\t\t}\n\t}\n\n\treturn {\n\t\tcommand,\n\t\tsource,\n\t\tupdateTarget,\n\t\tlocal,\n\t\tforce,\n\t\thelp,\n\t\tinvalidOption,\n\t\tinvalidArgument,\n\t\tmissingOptionValue,\n\t\tconflictingOptions,\n\t};\n}\n\nfunction updateTargetIncludesSelf(target: UpdateTarget): boolean {\n\treturn target.type === \"all\" || target.type === \"self\";\n}\n\nfunction updateTargetIncludesExtensions(target: UpdateTarget): boolean {\n\treturn target.type === \"all\" || target.type === \"extensions\";\n}\n\nfunction printSelfUpdateUnavailable(npmCommand?: string[], updatePackageName = PACKAGE_NAME): void {\n\tconsole.error(`error: ${APP_NAME} cannot self-update this installation.`);\n\tconsole.error(getSelfUpdateUnavailableInstruction(PACKAGE_NAME, npmCommand, updatePackageName));\n\n\tconst entrypoint = process.argv[1];\n\tif (entrypoint) {\n\t\tconsole.error(\"\");\n\t\tconsole.error(`Location of pi executable: ${entrypoint}`);\n\t}\n}\n\nfunction printSelfUpdateFallback(command: SelfUpdateCommand): void {\n\tconsole.error(chalk.dim(`If this keeps failing, run this command yourself: ${command.display}`));\n}\n\ninterface SelfUpdatePlan {\n\tpackageName: string;\n\tshouldRun: boolean;\n}\n\nasync function getSelfUpdatePlan(force: boolean): Promise<SelfUpdatePlan> {\n\tif (force) {\n\t\treturn { packageName: PACKAGE_NAME, shouldRun: true };\n\t}\n\n\ttry {\n\t\tconst latestRelease = await getLatestPiRelease(VERSION);\n\t\tconst packageName = latestRelease?.packageName ?? PACKAGE_NAME;\n\t\tif (!latestRelease || packageName !== PACKAGE_NAME || isNewerPackageVersion(latestRelease.version, VERSION)) {\n\t\t\treturn { packageName, shouldRun: true };\n\t\t}\n\t} catch {\n\t\treturn { packageName: PACKAGE_NAME, shouldRun: true };\n\t}\n\n\tconsole.log(chalk.green(`${APP_NAME} is already up to date (v${VERSION})`));\n\treturn { packageName: PACKAGE_NAME, shouldRun: false };\n}\n\nasync function runSelfUpdate(command: SelfUpdateCommand): Promise<void> {\n\tconsole.log(chalk.dim(`Updating ${APP_NAME} with ${command.display}...`));\n\tfor (const step of command.steps ?? [command]) {\n\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\t// Windows package managers are commonly .cmd shims. Use the shell so Node can execute them.\n\t\t\tconst child = spawn(step.command, step.args, {\n\t\t\t\tstdio: \"inherit\",\n\t\t\t\tshell: shouldUseWindowsShell(step.command),\n\t\t\t});\n\t\t\tchild.on(\"error\", (error) => {\n\t\t\t\treject(error);\n\t\t\t});\n\t\t\tchild.on(\"close\", (code, signal) => {\n\t\t\t\tif (code === 0) {\n\t\t\t\t\tresolve();\n\t\t\t\t} else if (signal) {\n\t\t\t\t\treject(new Error(`${step.display} terminated by signal ${signal}`));\n\t\t\t\t} else {\n\t\t\t\t\treject(new Error(`${step.display} exited with code ${code ?? \"unknown\"}`));\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\t}\n}\n\nexport async function handleConfigCommand(args: string[]): Promise<boolean> {\n\tif (args[0] !== \"config\") {\n\t\treturn false;\n\t}\n\n\tconst cwd = process.cwd();\n\tconst agentDir = getAgentDir();\n\tconst settingsManager = SettingsManager.create(cwd, agentDir);\n\treportSettingsErrors(settingsManager, \"config command\");\n\tconst packageManager = new DefaultPackageManager({ cwd, agentDir, settingsManager });\n\tconst resolvedPaths = await packageManager.resolve();\n\n\tawait selectConfig({\n\t\tresolvedPaths,\n\t\tsettingsManager,\n\t\tcwd,\n\t\tagentDir,\n\t});\n\n\tprocess.exit(0);\n}\n\nexport async function handlePackageCommand(args: string[]): Promise<boolean> {\n\tconst options = parsePackageCommand(args);\n\tif (!options) {\n\t\treturn false;\n\t}\n\n\tif (options.help) {\n\t\tprintPackageCommandHelp(options.command);\n\t\treturn true;\n\t}\n\n\tif (options.invalidOption) {\n\t\tconsole.error(chalk.red(`Unknown option ${options.invalidOption} for \"${options.command}\".`));\n\t\tconsole.error(chalk.dim(`Use \"${APP_NAME} --help\" or \"${getPackageCommandUsage(options.command)}\".`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tif (options.missingOptionValue) {\n\t\tconsole.error(chalk.red(`Missing value for ${options.missingOptionValue}.`));\n\t\tconsole.error(chalk.dim(`Usage: ${getPackageCommandUsage(options.command)}`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tif (options.invalidArgument) {\n\t\tconsole.error(chalk.red(`Unexpected argument ${options.invalidArgument}.`));\n\t\tconsole.error(chalk.dim(`Usage: ${getPackageCommandUsage(options.command)}`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tif (options.conflictingOptions) {\n\t\tconsole.error(chalk.red(options.conflictingOptions));\n\t\tconsole.error(chalk.dim(`Usage: ${getPackageCommandUsage(options.command)}`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tconst source = options.source;\n\tif ((options.command === \"install\" || options.command === \"remove\") && !source) {\n\t\tconsole.error(chalk.red(`Missing ${options.command} source.`));\n\t\tconsole.error(chalk.dim(`Usage: ${getPackageCommandUsage(options.command)}`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tconst cwd = process.cwd();\n\tconst agentDir = getAgentDir();\n\tconst settingsManager = SettingsManager.create(cwd, agentDir);\n\treportSettingsErrors(settingsManager, \"package command\");\n\tconst selfUpdateNpmCommand = settingsManager.getGlobalSettings().npmCommand;\n\n\tconst packageManager = new DefaultPackageManager({ cwd, agentDir, settingsManager });\n\n\tpackageManager.setProgressCallback((event) => {\n\t\tif (event.type === \"start\") {\n\t\t\tprocess.stdout.write(chalk.dim(`${event.message}\\n`));\n\t\t}\n\t});\n\n\ttry {\n\t\tswitch (options.command) {\n\t\t\tcase \"install\":\n\t\t\t\tawait packageManager.installAndPersist(source!, { local: options.local });\n\t\t\t\tconsole.log(chalk.green(`Installed ${source}`));\n\t\t\t\treturn true;\n\n\t\t\tcase \"remove\": {\n\t\t\t\tconst removed = await packageManager.removeAndPersist(source!, { local: options.local });\n\t\t\t\tif (!removed) {\n\t\t\t\t\tconsole.error(chalk.red(`No matching package found for ${source}`));\n\t\t\t\t\tprocess.exitCode = 1;\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\t\t\t\tconsole.log(chalk.green(`Removed ${source}`));\n\t\t\t\treturn true;\n\t\t\t}\n\n\t\t\tcase \"list\": {\n\t\t\t\tconst configuredPackages = packageManager.listConfiguredPackages();\n\t\t\t\tconst userPackages = configuredPackages.filter((pkg) => pkg.scope === \"user\");\n\t\t\t\tconst projectPackages = configuredPackages.filter((pkg) => pkg.scope === \"project\");\n\n\t\t\t\tif (configuredPackages.length === 0) {\n\t\t\t\t\tconsole.log(chalk.dim(\"No packages installed.\"));\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\n\t\t\t\tconst formatPackage = (pkg: (typeof configuredPackages)[number]) => {\n\t\t\t\t\tconst display = pkg.filtered ? `${pkg.source} (filtered)` : pkg.source;\n\t\t\t\t\tconsole.log(`  ${display}`);\n\t\t\t\t\tif (pkg.installedPath) {\n\t\t\t\t\t\tconsole.log(chalk.dim(`    ${pkg.installedPath}`));\n\t\t\t\t\t}\n\t\t\t\t};\n\n\t\t\t\tif (userPackages.length > 0) {\n\t\t\t\t\tconsole.log(chalk.bold(\"User packages:\"));\n\t\t\t\t\tfor (const pkg of userPackages) {\n\t\t\t\t\t\tformatPackage(pkg);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tif (projectPackages.length > 0) {\n\t\t\t\t\tif (userPackages.length > 0) console.log();\n\t\t\t\t\tconsole.log(chalk.bold(\"Project packages:\"));\n\t\t\t\t\tfor (const pkg of projectPackages) {\n\t\t\t\t\t\tformatPackage(pkg);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\treturn true;\n\t\t\t}\n\n\t\t\tcase \"update\": {\n\t\t\t\tconst target = options.updateTarget ?? { type: \"all\" };\n\t\t\t\tif (updateTargetIncludesExtensions(target)) {\n\t\t\t\t\tconst updateSource = target.type === \"extensions\" ? target.source : undefined;\n\t\t\t\t\tawait packageManager.update(updateSource);\n\t\t\t\t\tif (updateSource) {\n\t\t\t\t\t\tconsole.log(chalk.green(`Updated ${updateSource}`));\n\t\t\t\t\t} else {\n\t\t\t\t\t\tconsole.log(chalk.green(\"Updated packages\"));\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tif (updateTargetIncludesSelf(target)) {\n\t\t\t\t\tconst selfUpdatePlan = await getSelfUpdatePlan(options.force);\n\t\t\t\t\tif (!selfUpdatePlan.shouldRun) {\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\t\t\t\t\tconst selfUpdateCommand = getSelfUpdateCommand(\n\t\t\t\t\t\tPACKAGE_NAME,\n\t\t\t\t\t\tselfUpdateNpmCommand,\n\t\t\t\t\t\tselfUpdatePlan.packageName,\n\t\t\t\t\t);\n\t\t\t\t\tif (!selfUpdateCommand) {\n\t\t\t\t\t\tprintSelfUpdateUnavailable(selfUpdateNpmCommand, selfUpdatePlan.packageName);\n\t\t\t\t\t\tprocess.exitCode = 1;\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\t\t\t\t\ttry {\n\t\t\t\t\t\tawait runSelfUpdate(selfUpdateCommand);\n\t\t\t\t\t} catch (error: unknown) {\n\t\t\t\t\t\tconst message = error instanceof Error ? error.message : \"Unknown package command error\";\n\t\t\t\t\t\tconsole.error(chalk.red(`Error: ${message}`));\n\t\t\t\t\t\tprintSelfUpdateFallback(selfUpdateCommand);\n\t\t\t\t\t\tprocess.exitCode = 1;\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\t\t\t\t\tconsole.log(chalk.green(`Updated ${APP_NAME}`));\n\t\t\t\t}\n\t\t\t\treturn true;\n\t\t\t}\n\t\t}\n\t} catch (error: unknown) {\n\t\tconst message = error instanceof Error ? error.message : \"Unknown package command error\";\n\t\tconsole.error(chalk.red(`Error: ${message}`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n}\n"]}
+{"version":3,"file":"package-manager-cli.d.ts","sourceRoot":"","sources":["../src/package-manager-cli.ts"],"names":[],"mappings":"AAuBA,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAgXtE,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAoB1E;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAgL3E","sourcesContent":["import { Markdown, type MarkdownTheme } from \"@sheason/pi-tui\";\nimport chalk from \"chalk\";\nimport { selectConfig } from \"./cli/config-selector.ts\";\nimport {\n\tAPP_NAME,\n\tdetectInstallMethod,\n\tgetAgentDir,\n\tgetPackageDir,\n\tgetSelfUpdateCommand,\n\tgetSelfUpdateUnavailableInstruction,\n\tPACKAGE_NAME,\n\ttype SelfUpdateCommand,\n\tVERSION,\n} from \"./config.ts\";\nimport { DefaultPackageManager } from \"./core/package-manager.ts\";\nimport { SettingsManager } from \"./core/settings-manager.ts\";\nimport { spawnProcess } from \"./utils/child-process.ts\";\nimport { getLatestPiRelease, isNewerPackageVersion } from \"./utils/version-check.ts\";\nimport {\n\tcleanupWindowsSelfUpdateQuarantine,\n\tquarantineWindowsNativeDependencies,\n} from \"./utils/windows-self-update.ts\";\n\nexport type PackageCommand = \"install\" | \"remove\" | \"update\" | \"list\";\n\ntype UpdateTarget = { type: \"all\" } | { type: \"self\" } | { type: \"extensions\"; source?: string };\n\nconst SELF_UPDATE_NOTE_MARKDOWN_THEME: MarkdownTheme = {\n\theading: (text) => chalk.bold(chalk.yellow(text)),\n\tlink: (text) => chalk.cyan(text),\n\tlinkUrl: (text) => chalk.dim(text),\n\tcode: (text) => chalk.yellow(text),\n\tcodeBlock: (text) => chalk.dim(text),\n\tcodeBlockBorder: (text) => chalk.dim(text),\n\tquote: (text) => chalk.dim(text),\n\tquoteBorder: (text) => chalk.dim(text),\n\thr: (text) => chalk.dim(text),\n\tlistBullet: (text) => chalk.yellow(text),\n\tbold: (text) => chalk.bold(text),\n\titalic: (text) => chalk.italic(text),\n\tstrikethrough: (text) => chalk.strikethrough(text),\n\tunderline: (text) => chalk.underline(text),\n};\n\ninterface PackageCommandOptions {\n\tcommand: PackageCommand;\n\tsource?: string;\n\tupdateTarget?: UpdateTarget;\n\tlocal: boolean;\n\tforce: boolean;\n\thelp: boolean;\n\tinvalidOption?: string;\n\tinvalidArgument?: string;\n\tmissingOptionValue?: string;\n\tconflictingOptions?: string;\n}\n\nfunction reportSettingsErrors(settingsManager: SettingsManager, context: string): void {\n\tconst errors = settingsManager.drainErrors();\n\tfor (const { scope, error } of errors) {\n\t\tconsole.error(chalk.yellow(`Warning (${context}, ${scope} settings): ${error.message}`));\n\t\tif (error.stack) {\n\t\t\tconsole.error(chalk.dim(error.stack));\n\t\t}\n\t}\n}\n\nfunction getPackageCommandUsage(command: PackageCommand): string {\n\tswitch (command) {\n\t\tcase \"install\":\n\t\t\treturn `${APP_NAME} install <source> [-l]`;\n\t\tcase \"remove\":\n\t\t\treturn `${APP_NAME} remove <source> [-l]`;\n\t\tcase \"update\":\n\t\t\treturn `${APP_NAME} update [source|self|pi] [--self] [--extensions] [--extension <source>] [--force]`;\n\t\tcase \"list\":\n\t\t\treturn `${APP_NAME} list`;\n\t}\n}\n\nfunction printPackageCommandHelp(command: PackageCommand): void {\n\tswitch (command) {\n\t\tcase \"install\":\n\t\t\tconsole.log(`${chalk.bold(\"Usage:\")}\n  ${getPackageCommandUsage(\"install\")}\n\nInstall a package and add it to settings.\n\nOptions:\n  -l, --local    Install project-locally (.pi/settings.json)\n\nExamples:\n  ${APP_NAME} install npm:@foo/bar\n  ${APP_NAME} install git:github.com/user/repo\n  ${APP_NAME} install git:git@github.com:user/repo\n  ${APP_NAME} install https://github.com/user/repo\n  ${APP_NAME} install ssh://git@github.com/user/repo\n  ${APP_NAME} install ./local/path\n`);\n\t\t\treturn;\n\n\t\tcase \"remove\":\n\t\t\tconsole.log(`${chalk.bold(\"Usage:\")}\n  ${getPackageCommandUsage(\"remove\")}\n\nRemove a package and its source from settings.\nAlias: ${APP_NAME} uninstall <source> [-l]\n\nOptions:\n  -l, --local    Remove from project settings (.pi/settings.json)\n\nExamples:\n  ${APP_NAME} remove npm:@foo/bar\n  ${APP_NAME} uninstall npm:@foo/bar\n`);\n\t\t\treturn;\n\n\t\tcase \"update\":\n\t\t\tconsole.log(`${chalk.bold(\"Usage:\")}\n  ${getPackageCommandUsage(\"update\")}\n\nUpdate pi and installed packages.\n\nOptions:\n  --self                  Update pi only\n  --extensions            Update installed packages only\n  --extension <source>    Update one package only\n  --force                 Reinstall pi even if the current version is latest\n\nShort forms:\n  ${APP_NAME} update                Update pi and all extensions\n  ${APP_NAME} update <source>       Update one package\n  ${APP_NAME} update pi             Update pi only (self works as alias to pi)\n`);\n\t\t\treturn;\n\n\t\tcase \"list\":\n\t\t\tconsole.log(`${chalk.bold(\"Usage:\")}\n  ${getPackageCommandUsage(\"list\")}\n\nList installed packages from user and project settings.\n`);\n\t\t\treturn;\n\t}\n}\n\nfunction parsePackageCommand(args: string[]): PackageCommandOptions | undefined {\n\tconst [rawCommand, ...rest] = args;\n\tlet command: PackageCommand | undefined;\n\tif (rawCommand === \"uninstall\") {\n\t\tcommand = \"remove\";\n\t} else if (rawCommand === \"install\" || rawCommand === \"remove\" || rawCommand === \"update\" || rawCommand === \"list\") {\n\t\tcommand = rawCommand;\n\t}\n\tif (!command) {\n\t\treturn undefined;\n\t}\n\n\tlet local = false;\n\tlet force = false;\n\tlet help = false;\n\tlet invalidOption: string | undefined;\n\tlet invalidArgument: string | undefined;\n\tlet missingOptionValue: string | undefined;\n\tlet conflictingOptions: string | undefined;\n\tlet source: string | undefined;\n\tlet selfFlag = false;\n\tlet extensionsFlag = false;\n\tlet extensionFlagSource: string | undefined;\n\n\tfor (let index = 0; index < rest.length; index++) {\n\t\tconst arg = rest[index];\n\t\tif (arg === \"-h\" || arg === \"--help\") {\n\t\t\thelp = true;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg === \"-l\" || arg === \"--local\") {\n\t\t\tif (command === \"install\" || command === \"remove\") {\n\t\t\t\tlocal = true;\n\t\t\t} else {\n\t\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg === \"--self\") {\n\t\t\tif (command === \"update\") {\n\t\t\t\tselfFlag = true;\n\t\t\t} else {\n\t\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg === \"--extensions\") {\n\t\t\tif (command === \"update\") {\n\t\t\t\textensionsFlag = true;\n\t\t\t} else {\n\t\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg === \"--force\") {\n\t\t\tif (command === \"update\") {\n\t\t\t\tforce = true;\n\t\t\t} else {\n\t\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg === \"--extension\") {\n\t\t\tif (command !== \"update\") {\n\t\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst value = rest[index + 1];\n\t\t\tif (!value || value.startsWith(\"-\")) {\n\t\t\t\tmissingOptionValue = missingOptionValue ?? arg;\n\t\t\t} else if (extensionFlagSource) {\n\t\t\t\tconflictingOptions = conflictingOptions ?? \"--extension can only be provided once\";\n\t\t\t\tindex++;\n\t\t\t} else {\n\t\t\t\textensionFlagSource = value;\n\t\t\t\tindex++;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (arg.startsWith(\"-\")) {\n\t\t\tinvalidOption = invalidOption ?? arg;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (!source) {\n\t\t\tsource = arg;\n\t\t} else {\n\t\t\tinvalidArgument = invalidArgument ?? arg;\n\t\t}\n\t}\n\n\tlet updateTarget: UpdateTarget | undefined;\n\tif (command === \"update\") {\n\t\tif (extensionFlagSource) {\n\t\t\tif (selfFlag || extensionsFlag) {\n\t\t\t\tconflictingOptions = conflictingOptions ?? \"--extension cannot be combined with --self or --extensions\";\n\t\t\t}\n\t\t\tif (source) {\n\t\t\t\tconflictingOptions = conflictingOptions ?? \"--extension cannot be combined with a positional source\";\n\t\t\t}\n\t\t\tupdateTarget = { type: \"extensions\", source: extensionFlagSource };\n\t\t} else if (source) {\n\t\t\tconst sourceIsSelf = source === \"self\" || source === \"pi\";\n\t\t\tif (sourceIsSelf) {\n\t\t\t\tupdateTarget = extensionsFlag ? { type: \"all\" } : { type: \"self\" };\n\t\t\t} else {\n\t\t\t\tif (extensionsFlag || selfFlag) {\n\t\t\t\t\tconflictingOptions =\n\t\t\t\t\t\tconflictingOptions ?? \"positional update targets cannot be combined with --self or --extensions\";\n\t\t\t\t}\n\t\t\t\tupdateTarget = { type: \"extensions\", source };\n\t\t\t}\n\t\t} else if (selfFlag && extensionsFlag) {\n\t\t\tupdateTarget = { type: \"all\" };\n\t\t} else if (selfFlag) {\n\t\t\tupdateTarget = { type: \"self\" };\n\t\t} else if (extensionsFlag) {\n\t\t\tupdateTarget = { type: \"extensions\" };\n\t\t} else {\n\t\t\tupdateTarget = { type: \"all\" };\n\t\t}\n\t}\n\n\treturn {\n\t\tcommand,\n\t\tsource,\n\t\tupdateTarget,\n\t\tlocal,\n\t\tforce,\n\t\thelp,\n\t\tinvalidOption,\n\t\tinvalidArgument,\n\t\tmissingOptionValue,\n\t\tconflictingOptions,\n\t};\n}\n\nfunction updateTargetIncludesSelf(target: UpdateTarget): boolean {\n\treturn target.type === \"all\" || target.type === \"self\";\n}\n\nfunction updateTargetIncludesExtensions(target: UpdateTarget): boolean {\n\treturn target.type === \"all\" || target.type === \"extensions\";\n}\n\nfunction printSelfUpdateUnavailable(npmCommand?: string[], updatePackageName = PACKAGE_NAME): void {\n\tconsole.error(`error: ${APP_NAME} cannot self-update this installation.`);\n\tconsole.error(getSelfUpdateUnavailableInstruction(PACKAGE_NAME, npmCommand, updatePackageName));\n\n\tconst entrypoint = process.argv[1];\n\tif (entrypoint) {\n\t\tconsole.error(\"\");\n\t\tconsole.error(`Location of pi executable: ${entrypoint}`);\n\t}\n}\n\nfunction printSelfUpdateFallback(command: SelfUpdateCommand): void {\n\tconsole.error(chalk.dim(`If this keeps failing, run this command yourself: ${command.display}`));\n}\n\nfunction printSelfUpdateNote(note: string): void {\n\tconst trimmedNote = note.trim();\n\tif (!trimmedNote) {\n\t\treturn;\n\t}\n\n\tconsole.log();\n\tconsole.log(chalk.bold(chalk.yellow(\"Update note\")));\n\ttry {\n\t\tconst width = Math.max(20, process.stdout.columns ?? 80);\n\t\tconst renderedLines = new Markdown(trimmedNote, 0, 0, SELF_UPDATE_NOTE_MARKDOWN_THEME)\n\t\t\t.render(width)\n\t\t\t.map((line) => line.trimEnd());\n\t\tconsole.log(renderedLines.join(\"\\n\"));\n\t} catch {\n\t\tconsole.log(trimmedNote);\n\t}\n\tconsole.log();\n}\n\ninterface SelfUpdatePlan {\n\tpackageName: string;\n\tshouldRun: boolean;\n\tnote?: string;\n}\n\nasync function getSelfUpdatePlan(force: boolean): Promise<SelfUpdatePlan> {\n\tif (force) {\n\t\treturn { packageName: PACKAGE_NAME, shouldRun: true };\n\t}\n\n\ttry {\n\t\tconst latestRelease = await getLatestPiRelease(VERSION);\n\t\tconst packageName = latestRelease?.packageName ?? PACKAGE_NAME;\n\t\tif (!latestRelease || packageName !== PACKAGE_NAME || isNewerPackageVersion(latestRelease.version, VERSION)) {\n\t\t\treturn { packageName, shouldRun: true, ...(latestRelease?.note ? { note: latestRelease.note } : {}) };\n\t\t}\n\t} catch {\n\t\treturn { packageName: PACKAGE_NAME, shouldRun: true };\n\t}\n\n\tconsole.log(chalk.green(`${APP_NAME} is already up to date (v${VERSION})`));\n\treturn { packageName: PACKAGE_NAME, shouldRun: false };\n}\n\nasync function runSelfUpdate(command: SelfUpdateCommand): Promise<void> {\n\tconsole.log(chalk.dim(`Updating ${APP_NAME} with ${command.display}...`));\n\tfor (const step of command.steps ?? [command]) {\n\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\tconst child = spawnProcess(step.command, step.args, {\n\t\t\t\tstdio: \"inherit\",\n\t\t\t});\n\t\t\tchild.on(\"error\", (error) => {\n\t\t\t\treject(error);\n\t\t\t});\n\t\t\tchild.on(\"close\", (code, signal) => {\n\t\t\t\tif (code === 0) {\n\t\t\t\t\tresolve();\n\t\t\t\t} else if (signal) {\n\t\t\t\t\treject(new Error(`${step.display} terminated by signal ${signal}`));\n\t\t\t\t} else {\n\t\t\t\t\treject(new Error(`${step.display} exited with code ${code ?? \"unknown\"}`));\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\t}\n}\n\nfunction prepareWindowsNpmSelfUpdate(): void {\n\tif (process.platform !== \"win32\") {\n\t\treturn;\n\t}\n\n\tconst packageDir = getPackageDir();\n\tcleanupWindowsSelfUpdateQuarantine(packageDir);\n\tquarantineWindowsNativeDependencies(packageDir);\n}\n\nexport async function handleConfigCommand(args: string[]): Promise<boolean> {\n\tif (args[0] !== \"config\") {\n\t\treturn false;\n\t}\n\n\tconst cwd = process.cwd();\n\tconst agentDir = getAgentDir();\n\tconst settingsManager = SettingsManager.create(cwd, agentDir);\n\treportSettingsErrors(settingsManager, \"config command\");\n\tconst packageManager = new DefaultPackageManager({ cwd, agentDir, settingsManager });\n\tconst resolvedPaths = await packageManager.resolve();\n\n\tawait selectConfig({\n\t\tresolvedPaths,\n\t\tsettingsManager,\n\t\tcwd,\n\t\tagentDir,\n\t});\n\n\tprocess.exit(0);\n}\n\nexport async function handlePackageCommand(args: string[]): Promise<boolean> {\n\tconst options = parsePackageCommand(args);\n\tif (!options) {\n\t\treturn false;\n\t}\n\n\tif (options.help) {\n\t\tprintPackageCommandHelp(options.command);\n\t\treturn true;\n\t}\n\n\tif (options.invalidOption) {\n\t\tconsole.error(chalk.red(`Unknown option ${options.invalidOption} for \"${options.command}\".`));\n\t\tconsole.error(chalk.dim(`Use \"${APP_NAME} --help\" or \"${getPackageCommandUsage(options.command)}\".`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tif (options.missingOptionValue) {\n\t\tconsole.error(chalk.red(`Missing value for ${options.missingOptionValue}.`));\n\t\tconsole.error(chalk.dim(`Usage: ${getPackageCommandUsage(options.command)}`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tif (options.invalidArgument) {\n\t\tconsole.error(chalk.red(`Unexpected argument ${options.invalidArgument}.`));\n\t\tconsole.error(chalk.dim(`Usage: ${getPackageCommandUsage(options.command)}`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tif (options.conflictingOptions) {\n\t\tconsole.error(chalk.red(options.conflictingOptions));\n\t\tconsole.error(chalk.dim(`Usage: ${getPackageCommandUsage(options.command)}`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tconst source = options.source;\n\tif ((options.command === \"install\" || options.command === \"remove\") && !source) {\n\t\tconsole.error(chalk.red(`Missing ${options.command} source.`));\n\t\tconsole.error(chalk.dim(`Usage: ${getPackageCommandUsage(options.command)}`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n\n\tconst cwd = process.cwd();\n\tconst agentDir = getAgentDir();\n\tconst settingsManager = SettingsManager.create(cwd, agentDir);\n\treportSettingsErrors(settingsManager, \"package command\");\n\tconst selfUpdateNpmCommand = settingsManager.getGlobalSettings().npmCommand;\n\n\tconst packageManager = new DefaultPackageManager({ cwd, agentDir, settingsManager });\n\n\tpackageManager.setProgressCallback((event) => {\n\t\tif (event.type === \"start\") {\n\t\t\tprocess.stdout.write(chalk.dim(`${event.message}\\n`));\n\t\t}\n\t});\n\n\ttry {\n\t\tswitch (options.command) {\n\t\t\tcase \"install\":\n\t\t\t\tawait packageManager.installAndPersist(source!, { local: options.local });\n\t\t\t\tconsole.log(chalk.green(`Installed ${source}`));\n\t\t\t\treturn true;\n\n\t\t\tcase \"remove\": {\n\t\t\t\tconst removed = await packageManager.removeAndPersist(source!, { local: options.local });\n\t\t\t\tif (!removed) {\n\t\t\t\t\tconsole.error(chalk.red(`No matching package found for ${source}`));\n\t\t\t\t\tprocess.exitCode = 1;\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\t\t\t\tconsole.log(chalk.green(`Removed ${source}`));\n\t\t\t\treturn true;\n\t\t\t}\n\n\t\t\tcase \"list\": {\n\t\t\t\tconst configuredPackages = packageManager.listConfiguredPackages();\n\t\t\t\tconst userPackages = configuredPackages.filter((pkg) => pkg.scope === \"user\");\n\t\t\t\tconst projectPackages = configuredPackages.filter((pkg) => pkg.scope === \"project\");\n\n\t\t\t\tif (configuredPackages.length === 0) {\n\t\t\t\t\tconsole.log(chalk.dim(\"No packages installed.\"));\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\n\t\t\t\tconst formatPackage = (pkg: (typeof configuredPackages)[number]) => {\n\t\t\t\t\tconst display = pkg.filtered ? `${pkg.source} (filtered)` : pkg.source;\n\t\t\t\t\tconsole.log(`  ${display}`);\n\t\t\t\t\tif (pkg.installedPath) {\n\t\t\t\t\t\tconsole.log(chalk.dim(`    ${pkg.installedPath}`));\n\t\t\t\t\t}\n\t\t\t\t};\n\n\t\t\t\tif (userPackages.length > 0) {\n\t\t\t\t\tconsole.log(chalk.bold(\"User packages:\"));\n\t\t\t\t\tfor (const pkg of userPackages) {\n\t\t\t\t\t\tformatPackage(pkg);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tif (projectPackages.length > 0) {\n\t\t\t\t\tif (userPackages.length > 0) console.log();\n\t\t\t\t\tconsole.log(chalk.bold(\"Project packages:\"));\n\t\t\t\t\tfor (const pkg of projectPackages) {\n\t\t\t\t\t\tformatPackage(pkg);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\treturn true;\n\t\t\t}\n\n\t\t\tcase \"update\": {\n\t\t\t\tconst target = options.updateTarget ?? { type: \"all\" };\n\t\t\t\tif (updateTargetIncludesExtensions(target)) {\n\t\t\t\t\tconst updateSource = target.type === \"extensions\" ? target.source : undefined;\n\t\t\t\t\tawait packageManager.update(updateSource);\n\t\t\t\t\tif (updateSource) {\n\t\t\t\t\t\tconsole.log(chalk.green(`Updated ${updateSource}`));\n\t\t\t\t\t} else {\n\t\t\t\t\t\tconsole.log(chalk.green(\"Updated packages\"));\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tif (updateTargetIncludesSelf(target)) {\n\t\t\t\t\tconst selfUpdatePlan = await getSelfUpdatePlan(options.force);\n\t\t\t\t\tif (!selfUpdatePlan.shouldRun) {\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\t\t\t\t\tconst installMethod = detectInstallMethod();\n\t\t\t\t\tif (process.platform === \"win32\" && installMethod !== \"npm\" && installMethod !== \"pnpm\") {\n\t\t\t\t\t\tconsole.error(\n\t\t\t\t\t\t\tchalk.red(`${APP_NAME} self-update on Windows is only supported for npm and pnpm installs.`),\n\t\t\t\t\t\t);\n\t\t\t\t\t\tconsole.error(chalk.dim(`Detected install method: ${installMethod}. Update ${APP_NAME} manually.`));\n\t\t\t\t\t\tprocess.exitCode = 1;\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\t\t\t\t\tconst selfUpdateCommand = getSelfUpdateCommand(\n\t\t\t\t\t\tPACKAGE_NAME,\n\t\t\t\t\t\tselfUpdateNpmCommand,\n\t\t\t\t\t\tselfUpdatePlan.packageName,\n\t\t\t\t\t);\n\t\t\t\t\tif (!selfUpdateCommand) {\n\t\t\t\t\t\tprintSelfUpdateUnavailable(selfUpdateNpmCommand, selfUpdatePlan.packageName);\n\t\t\t\t\t\tprocess.exitCode = 1;\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\t\t\t\t\tif (selfUpdatePlan.note) {\n\t\t\t\t\t\tprintSelfUpdateNote(selfUpdatePlan.note);\n\t\t\t\t\t}\n\t\t\t\t\ttry {\n\t\t\t\t\t\tif (installMethod === \"npm\") {\n\t\t\t\t\t\t\tprepareWindowsNpmSelfUpdate();\n\t\t\t\t\t\t}\n\t\t\t\t\t\tawait runSelfUpdate(selfUpdateCommand);\n\t\t\t\t\t} catch (error: unknown) {\n\t\t\t\t\t\tconst message = error instanceof Error ? error.message : \"Unknown package command error\";\n\t\t\t\t\t\tconsole.error(chalk.red(`Error: ${message}`));\n\t\t\t\t\t\tprintSelfUpdateFallback(selfUpdateCommand);\n\t\t\t\t\t\tprocess.exitCode = 1;\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\t\t\t\t\tconsole.log(chalk.green(`Updated ${APP_NAME}`));\n\t\t\t\t}\n\t\t\t\treturn true;\n\t\t\t}\n\t\t}\n\t} catch (error: unknown) {\n\t\tconst message = error instanceof Error ? error.message : \"Unknown package command error\";\n\t\tconsole.error(chalk.red(`Error: ${message}`));\n\t\tprocess.exitCode = 1;\n\t\treturn true;\n\t}\n}\n"]}

package/dist/package-manager-cli.js

@@ -1,11 +1,28 @@
+import { Markdown } from "@sheason/pi-tui";
 import chalk from "chalk";
-import { spawn } from "child_process";
 import { selectConfig } from "./cli/config-selector.js";
-import { APP_NAME, getAgentDir, getSelfUpdateCommand, getSelfUpdateUnavailableInstruction, PACKAGE_NAME, VERSION, } from "./config.js";
+import { APP_NAME, detectInstallMethod, getAgentDir, getPackageDir, getSelfUpdateCommand, getSelfUpdateUnavailableInstruction, PACKAGE_NAME, VERSION, } from "./config.js";
 import { DefaultPackageManager } from "./core/package-manager.js";
 import { SettingsManager } from "./core/settings-manager.js";
-import { shouldUseWindowsShell } from "./utils/child-process.js";
+import { spawnProcess } from "./utils/child-process.js";
 import { getLatestPiRelease, isNewerPackageVersion } from "./utils/version-check.js";
+import { cleanupWindowsSelfUpdateQuarantine, quarantineWindowsNativeDependencies, } from "./utils/windows-self-update.js";
+const SELF_UPDATE_NOTE_MARKDOWN_THEME = {
+    heading: (text) => chalk.bold(chalk.yellow(text)),
+    link: (text) => chalk.cyan(text),
+    linkUrl: (text) => chalk.dim(text),
+    code: (text) => chalk.yellow(text),
+    codeBlock: (text) => chalk.dim(text),
+    codeBlockBorder: (text) => chalk.dim(text),
+    quote: (text) => chalk.dim(text),
+    quoteBorder: (text) => chalk.dim(text),
+    hr: (text) => chalk.dim(text),
+    listBullet: (text) => chalk.yellow(text),
+    bold: (text) => chalk.bold(text),
+    italic: (text) => chalk.italic(text),
+    strikethrough: (text) => chalk.strikethrough(text),
+    underline: (text) => chalk.underline(text),
+};
 function reportSettingsErrors(settingsManager, context) {
     const errors = settingsManager.drainErrors();
     for (const { scope, error } of errors) {
@@ -252,6 +269,25 @@ function printSelfUpdateUnavailable(npmCommand, updatePackageName = PACKAGE_NAME
 function printSelfUpdateFallback(command) {
     console.error(chalk.dim(`If this keeps failing, run this command yourself: ${command.display}`));
 }
+function printSelfUpdateNote(note) {
+    const trimmedNote = note.trim();
+    if (!trimmedNote) {
+        return;
+    }
+    console.log();
+    console.log(chalk.bold(chalk.yellow("Update note")));
+    try {
+        const width = Math.max(20, process.stdout.columns ?? 80);
+        const renderedLines = new Markdown(trimmedNote, 0, 0, SELF_UPDATE_NOTE_MARKDOWN_THEME)
+            .render(width)
+            .map((line) => line.trimEnd());
+        console.log(renderedLines.join("\n"));
+    }
+    catch {
+        console.log(trimmedNote);
+    }
+    console.log();
+}
 async function getSelfUpdatePlan(force) {
     if (force) {
         return { packageName: PACKAGE_NAME, shouldRun: true };
@@ -260,7 +296,7 @@ async function getSelfUpdatePlan(force) {
         const latestRelease = await getLatestPiRelease(VERSION);
         const packageName = latestRelease?.packageName ?? PACKAGE_NAME;
         if (!latestRelease || packageName !== PACKAGE_NAME || isNewerPackageVersion(latestRelease.version, VERSION)) {
-            return { packageName, shouldRun: true };
+            return { packageName, shouldRun: true, ...(latestRelease?.note ? { note: latestRelease.note } : {}) };
         }
     }
     catch {
@@ -273,10 +309,8 @@ async function runSelfUpdate(command) {
     console.log(chalk.dim(`Updating ${APP_NAME} with ${command.display}...`));
     for (const step of command.steps ?? [command]) {
         await new Promise((resolve, reject) => {
-            // Windows package managers are commonly .cmd shims. Use the shell so Node can execute them.
-            const child = spawn(step.command, step.args, {
+            const child = spawnProcess(step.command, step.args, {
                 stdio: "inherit",
-                shell: shouldUseWindowsShell(step.command),
             });
             child.on("error", (error) => {
                 reject(error);
@@ -295,6 +329,14 @@ async function runSelfUpdate(command) {
         });
     }
 }
+function prepareWindowsNpmSelfUpdate() {
+    if (process.platform !== "win32") {
+        return;
+    }
+    const packageDir = getPackageDir();
+    cleanupWindowsSelfUpdateQuarantine(packageDir);
+    quarantineWindowsNativeDependencies(packageDir);
+}
 export async function handleConfigCommand(args) {
     if (args[0] !== "config") {
         return false;
@@ -428,13 +470,26 @@ export async function handlePackageCommand(args) {
                     if (!selfUpdatePlan.shouldRun) {
                         return true;
                     }
+                    const installMethod = detectInstallMethod();
+                    if (process.platform === "win32" && installMethod !== "npm" && installMethod !== "pnpm") {
+                        console.error(chalk.red(`${APP_NAME} self-update on Windows is only supported for npm and pnpm installs.`));
+                        console.error(chalk.dim(`Detected install method: ${installMethod}. Update ${APP_NAME} manually.`));
+                        process.exitCode = 1;
+                        return true;
+                    }
                     const selfUpdateCommand = getSelfUpdateCommand(PACKAGE_NAME, selfUpdateNpmCommand, selfUpdatePlan.packageName);
                     if (!selfUpdateCommand) {
                         printSelfUpdateUnavailable(selfUpdateNpmCommand, selfUpdatePlan.packageName);
                         process.exitCode = 1;
                         return true;
                     }
+                    if (selfUpdatePlan.note) {
+                        printSelfUpdateNote(selfUpdatePlan.note);
+                    }
                     try {
+                        if (installMethod === "npm") {
+                            prepareWindowsNpmSelfUpdate();
+                        }
                         await runSelfUpdate(selfUpdateCommand);
                     }
                     catch (error) {