@caupulican/pi-adaptative 0.80.102 → 0.81.0

package/CHANGELOG.md

@@ -1,3 +1,134 @@
+## [0.81.0] - 2026-07-04
+
+### Added
+- Foreground bash commands with no explicit `timeout` are now killed after 600s of continuous
+  silence (no stdout/stderr output), not by total runtime — a command that keeps producing output
+  is never killed by this. Passing an explicit `timeout` disables the silence watchdog in favor of
+  the wall-clock limit; backgrounded (`cmd &`) work is exempt by construction. Wires the
+  `createSilenceWatchdog` primitive from `@caupulican/pi-agent-core`'s reliability kernel into the
+  bash tool.
+- A silently dead provider stream can no longer wedge a turn forever. Every provider stream a
+  session starts is now wrapped once (at construction) with the reliability kernel's
+  `withStreamIdleWatchdog`: it bounds the wait for the first event (120s connect allowance) and the
+  gap between subsequent events (30s idle). On a stall it aborts the inner request and surfaces a
+  retryable `stream stalled` error, which the existing auto-retry path picks up — so a hung
+  connection now fails over instead of hanging. The bound is on silence, never on total runtime, so
+  a stream that keeps emitting is never cut off.
+- Process memory (rss, heap used, external — rounded to MB) is now surfaced as self-telemetry: the
+  `/usage` command prints a "Process" section, and `getAutonomyDiagnosticSnapshot` gains a
+  `processMemory` family rendered by `formatAutonomyDiagnostics`. Unlike the snapshot's other
+  families, `processMemory` reflects live process state rather than recorded session activity, so it
+  is always present, even when nothing else has happened yet.
+
+### Changed
+- truncate and sanitizeBinaryOutput now live in @caupulican/pi-agent-core (single canonical copy).
+- convertToLlm and the custom message types (BashExecutionMessage, CustomMessage, BranchSummaryMessage, CompactionSummaryMessage) now come from @caupulican/pi-agent-core (moved out of `core/messages.ts`); coding-agent re-exports convertToLlm unchanged, so its public API is preserved.
+- The tool-result-details retention helpers (`compactToolResultDetailsForRetention`, `compactRetainedDetails`, and their byte budgets) and the `normalizePath`/`resolvePath` path helpers now come from @caupulican/pi-agent-core (`message-retention` moved to the main entry, path helpers to the `/node` entry). `utils/paths.ts` re-exports `normalizePath`/`resolvePath` unchanged, so its consumers are unaffected.
+- `SessionManager` no longer reads app config. Its constructor and statics (`create`, `open`, `continueRecent`, `forkFrom`, `list`) now take the agent config dir explicitly, and `listAll` takes the sessions-root dir explicitly — the kernel-promotion seam, so `SessionManager` no longer imports `config.ts`. A new host-layer `core/session-manager-factory.ts` (`createSession`, `openSession`, `continueRecentSession`, `forkSession`, `listSessions`, `listAllSessions`) is the single visible place that closes over `getAgentDir()`/`getSessionsDir()` and delegates; call sites that already hold their own agent dir (SDK, session runtime) pass it directly. Behavior is unchanged (`usesDefaultSessionDir()` now compares against the injected agent dir, identical to the previous config-derived value in the CLI).
+- `SessionManager` and the session storage types (`SessionEntry`, `SessionHeader`, `SessionContext`, `SessionInfo`, `SessionTreeNode`, `CompactionEntry`, `BranchSummaryEntry`, `CustomEntry`, `CustomMessageEntry`, `LabelEntry`, `SessionInfoEntry`, `FileEntry`, `ReadonlySessionManager`, `NewSessionOptions`, `SessionListProgress`) and functions (`buildSessionContext`, `migrateSessionEntries`, `parseSessionEntries`, `getLatestCompactionEntry`, `getDefaultSessionDir`, `loadEntriesFromFile`, `findMostRecentSession`, `assertValidSessionId`, `isAutoLearnSessionId`, `CURRENT_SESSION_VERSION`) now come from `@caupulican/pi-agent-core/node` (moved out of `core/session-manager.ts`); `core/session-manager-factory.ts` still wraps it with the same host-layer API, so coding-agent's public surface and behavior are unchanged.
+- The compaction + branch-summarization module (`shouldCompact`, `prepareCompaction`, `compact`, `generateSummary`, `findCutPoint`, `findTurnStartIndex`, `estimateTokens`, `estimateContextTokens`, `calculateContextTokens`, `getLastAssistantUsage`, `serializeConversation`, `DEFAULT_COMPACTION_SETTINGS`, `collectEntriesForBranchSummary`, `prepareBranchEntries`, `generateBranchSummary`, and the `CompactionResult`/`CompactionSettings`/`CompactionPreparation`/`FileOperations` types) now comes from `@caupulican/pi-agent-core/node` (moved out of `core/compaction/`); the `#30` cost-guard triggers (`triggerPercent`, `MIN_COMPACTION_SAVINGS`) ride along unchanged. `AgentSession` still owns the auto-compaction orchestration and calls into the promoted functions; coding-agent re-exports the surface unchanged, so its public API and behavior are preserved.
+- Auto-retry, stalled-stream abort, bash silence watchdog, exec kill escalation, and bash/edit write serialization now ride the shared reliability kernel (@caupulican/pi-agent-core).
+- Provider errors containing auth wording (401/unauthorized/invalid api key) are now terminal instead of retried, even when combined with transient wording (e.g. "fetch failed: 401 unauthorized") — retrying on bad credentials is pointless. Previously such mixed messages were retried.
+- Custom retry settings are now capped at 120s per backoff step (maxDelayMs). Default behavior (2s/4s/8s) is unchanged; only aggressive custom baseDelayMs/maxRetries combinations are affected.
+- The Auto Learn / native-reflection controller moved out of `interactive-mode.ts` into `modes/interactive/auto-learn-controller.ts` (new `AutoLearnController`): the disk-backed run-state machine (state.json + lockfile), the background-learner spawn/prune lifecycle, and the in-process reflection pass now live in one module. `InteractiveMode` constructs it with narrow deps (a live session accessor, the host's self-modification-source resolver, and a small UI callback surface) and delegates at every call-in point; behavior is unchanged.
+- The local-runtime (Ollama) lifecycle moved out of `agent-session.ts` into `core/local-runtime-controller.ts` (new `LocalRuntimeController`): the cached per-server `OllamaRuntime` instances, the "confirmed up this session" flag, the #31 install-on-consent flow, and the #27 router tier-escalation fallback now live in one module. `AgentSession` constructs it with narrow deps (agent dir, a last-assistant-message accessor, the session's UI context/event emitter, and the router's own tier resolver) and delegates at every call-in point (`getLocalRuntime` keeps its public signature); behavior is unchanged.
+- System-prompt construction moved out of `agent-session.ts` into `core/system-prompt-builder.ts` (new `SystemPromptBuilder`): the situational-soul (R6), self-modification, and autonomy guardrail blocks, the per-tool snippet/guideline options assembly, and the `_baseSystemPromptOptions` state now live in one module (distinct from the existing pure `core/system-prompt.ts` string renderer it feeds). `AgentSession` constructs it with narrow accessor deps (cwd, the settings/resource/memory managers, the tool registries, and the active extensions — each read fresh so mid-session reassignment is tracked) and delegates at every call-in point; behavior is unchanged.
+- Autonomy telemetry and the status/diagnostic snapshots moved out of `agent-session.ts` into `core/autonomy-telemetry.ts` (new `AutonomyTelemetry`): the G3 telemetry sink, the G8 gate-outcome recorder plus the bounded gate-outcome history (owning the `_lastAutonomyGateOutcome` / `_gateOutcomeHistory` state), and the `getAutonomyStatusSnapshot` / `getAutonomyDiagnosticSnapshot` builders now live in one module. `AgentSession` constructs it with narrow accessor deps (the session manager, the last router decision, cost/goal/lane getters, and the research/delegation/learning snapshot getters — each read fresh) and delegates at every call-in point (`_emitAutonomyTelemetry`, `_recordGateOutcome`, `getGateOutcomeHistory`, and both public snapshot methods keep their signatures); behavior is unchanged.
+- The background lanes moved out of `agent-session.ts` into `core/background-lane-controller.ts` (new `BackgroundLaneController`): idle goal auto-continue, the autonomous research lane, scout-worker delegation, and the model-fitness probe — plus the shared lane-model/profile/envelope resolution helpers — now live in one module, owning the lane timers, the single-flight guards, the last research-lane skip reason, the live `LaneTracker`, and the in-flight research/worker abort controllers. `AgentSession` constructs it with narrow accessor deps (the session manager, settings, model registry, live model, capability envelope, the model-capability profile, the goal continuation LOOP, the isolated-completion primitive, spawned-usage accounting, and the telemetry sink — each read fresh) and delegates at every call-in point: the idle triggers off the prompt tail, the dispose-time timer clears + lane aborts, the router judge's lane-model resolution, and the public `runResearchLaneOnce` / `runWorkerDelegationOnce` / `runModelFitness` / `getStoredFitnessReports` / `getLaneRecords` methods keep their signatures. The drive-loop boundary is preserved — the controller only ever asks the session to `continueGoalLoop`, never touching `prompt()` or streaming/retry state; behavior is unchanged.
+- The memory subsystem moved out of `agent-session.ts` into `core/memory-controller.ts` (new `MemoryController`): the observe-only local OKF retrieval, the bounded prompt-evidence surfacing pilot, cross-session recall gating/effectiveness, and the plug-and-play `MemoryManager` (bundled file-store + transcript-recall providers plus extension contributions) now live in one module, owning the lazily-built OKF provider, the latest retrieval/prompt-inclusion reports, the reload-safe `MemoryManager`, the recall `EffectivenessTracker`, and the extension-contributed pending providers. `AgentSession` constructs it with narrow accessor deps (settings, the current turn index, agent/workspace dirs, the session id, the child-session flag, and the tool-registry refresh — each read fresh) and delegates at every call-in point: the context-transform hot path (`_runMemoryRetrieval` / `_maybeAppendMemoryEvidenceBlock` stay as one-line delegations so the transform keeps owning the pass ordering), the drive-loop cross-session recall (`shouldAttemptRecall` / prefetch / `recordRecallOutcome`), the context_audit memory diagnostics, dispose-time shutdown, reload's provider reset + re-init, the memory-tool surfacing, and the reflection engine's fresh-memory reads. The public `getMemoryRetrievalReport` / `getMemoryPromptInclusionReport` / `registerMemoryProvider` methods keep their signatures. The controller imports no compaction/context-pipeline internals; behavior is unchanged.
+- The per-turn context pipeline moved out of `agent-session.ts` into `core/context-pipeline.ts` (new `ContextPipeline`): the observe-only context audit, the shadow prompt-policy plan and its correlation with legacy context-gc, the enforcement pilot, the relevance-curation queue plus the fitness-gated curation-model resolver / brain-curation drain / compaction pre-digest, the legacy context-gc pass and its packed-artifact reference release, the tool-output artifact store, and the current-context token estimate now live in one module, owning the latest audit/policy/correlation/enforcement/gc reports, the `BrainCurator` sidecar and its curation/pre-digest skip reasons, and the lazily-built artifact store. `AgentSession` constructs it with narrow accessor deps (the current turn index, the session/settings managers, the model registry, agent/workspace dirs, the active tool names, the disposed flag, the isolated-completion primitive, spawned-usage accounting, and the live `MemoryManager` — each read fresh) and delegates at every call-in point: `_installAgentContextTransform` stays host-side and keeps the pass ordering, with each stage (`_estimateCurrentContextTokens`, `_runContextAudit`, `_runPromptPolicyPlanning`, `_applyContextGc`, `_correlatePromptPolicyWithContextGc`, `_runPromptEnforcement`, `_enqueueRelevanceCuration`, `_maybeDrainBrainCuration`) a one-line delegation; the compaction pre-digest, executor reflex-brain model resolution, runtime tool-artifact-store build, per-turn cost guard, composition dashboard, and dispose-time artifact sweep likewise delegate. The public `getContextAuditReport` / `getPromptPolicyReport` / `getPromptPolicyGcCorrelation` / `getPromptEnforcementReport` / `getContextGcReport` / `getContextCurationStatus` methods keep their signatures. The pipeline reaches `MemoryController` only through the `getMemoryManager` dep (never imports it), and `MemoryController` never imports the pipeline, so the transform stays the single place the two subsystems meet; behavior is unchanged.
+- Two pure computation clusters moved out of `interactive-mode.ts` into new sibling modules. `modes/interactive/history-reload-math.ts` holds the TUI reload-window math (`messagesForTuiHistoryReload`, `estimateTuiHistoryLines`, the text/message tail-trimmers, and the message-text extractors, plus the `TUI_HISTORY_RELOAD_MAX_LINES`/`_WRAP_WIDTH` budgets). `modes/interactive/resource-display.ts` holds the startup "loaded resources" formatters (path/label/scope-group/diagnostics rendering). `InteractiveMode` retains thin `this.`-delegating wrappers only where its stateful display code (`showLoadedResources`, `renderSessionContext`, `addMessageToChat`) or the existing prototype-based tests resolve a formatter through `this`; the rest are called directly from the modules. Behavior is unchanged.
+- The editor-overlay swap that `interactive-mode.ts` repeats ~23× (both showing an overlay in place of the editor — selectors, dialogs, loaders, the reload notice — and restoring the editor afterwards) is now unified behind `modes/interactive/editor-overlay-host.ts` (new `EditorOverlayHost`). Its single `swap(component, options)` method performs the `clear → addChild → focus → requestRender` sequence, parameterizing the real per-site deltas: the focus target (defaults to the mounted component; the selector helper focuses a distinct child), `setFocus` vs `restoreFocus` (the latter for the two selector-return paths that prefer the topmost visible overlay), and the render request (`requestRender()`, `requestRender(true)` for the reload notice, or none where the caller renders later). Per-site cleanup that isn't a swap concern (component `dispose()`, temp-file unlink, clearing the stored selector reference, restoring saved editor text) stays inline at each call site. The editor-*replacement* path (`setCustomEditorComponent`, which clears early, rebuilds the editor, then mounts it) is a different shape and is left as-is. Behavior is unchanged.
+- The resource-profile and external-source menu flows moved out of `interactive-mode.ts` into `modes/interactive/profile-menu-controller.ts` (new `ProfileMenuController`): the `/profiles` command, the resources-hub menu tree (active-profile selection, manage/create/delete/persist profiles, the per-profile library resource-grant editor, and external-root add/remove), and the profile-apply/reload/mutation-refresh logic now live in one module (23 methods). It holds no state of its own — every fact still lives in `settingsManager`, the profile registry, and the session resource loader — so `InteractiveMode` constructs it with narrow deps (a live session accessor and a UI callback surface, including the shared `showSelector`/`EditorOverlayHost`) and keeps thin one-line delegators at the three call-in points (`handleResourcesHubAction`, `handleProfilesCommand`, `refreshAfterProfileMutation`); behavior is unchanged.
+- The auth / login / OAuth dialog flows moved out of `interactive-mode.ts` into `modes/interactive/auth-dialogs-controller.ts` (new `AuthDialogsController`): the `/login` and `/logout` command handling (provider resolution and selection, the auth-type/provider selectors), the subscription (OAuth) login dialog, the API-key login dialog, the Amazon Bedrock setup notice, the in-dialog OAuth select prompt, and post-login model adoption now live in one module (12 methods), together with the auth-provider classification helpers (`isApiKeyLoginProvider`, `isUnknownModel`, `hasDefaultModelProvider`, `BEDROCK_PROVIDER_ID`) that only those flows used. It holds no state of its own — every credential/provider fact still lives in `session.modelRegistry.authStorage` — so `InteractiveMode` constructs it with narrow deps (a live session accessor and a UI callback surface, including the shared `showSelector`/`EditorOverlayHost`) and reaches it at the single external call-in point (`showOAuthSelector`, for `/login` and `/logout`); behavior is unchanged.
+- The config backup/restore commands and the read-only report/easter-egg commands moved out of `interactive-mode.ts` into two new sibling modules. `modes/interactive/config-backup.ts` holds `/config-backup` and `/config-restore` (the profile + resource-settings snapshot and its round-trip, including the pre-restore confirmation and the security rule that restored external roots come back untrusted). `modes/interactive/report-commands.ts` holds the read-only reports (`/usage`, `/changelog`, `/hotkeys`, `/debug`) and the easter-egg renders (`/arminsayshi`, `/dementedelves`, and the kimi-k2.5 daxnuts trigger). Both are plain function modules that operate through a narrow structural `host` seam (the settings manager plus status/error/selector callbacks; or the chat container, TUI, and a few read accessors), so `InteractiveMode` keeps thin wrappers that build the host from `this` at call time — required both because those fields are private and because the existing prototype-based tests invoke the wrappers through `this`. Behavior is unchanged.
+- The model-router turn routing moved out of `agent-session.ts` into `core/model-router-controller.ts` (new `ModelRouterController`): the regex/executor route resolver, the optional bounded routing judge, the executor lane (Level-0 toolkit direct hit plus the speculative brain-refined retry), the per-tier thinking/tool-surface swap around a routed turn, the cheap-research-turn session buffer with mutating-tool escalation to an expensive retry, and the router status/diagnostics report now live in one module, owning the transient per-turn route state (active intent/route, the cheap-turn session buffer, the escalation-requested and retry-in-flight flags) and the sticky last-decision/skip-reason/intent. The parallel routed drive path (`runRoutedTurn`) keeps the actual agent.prompt()/continue() loop host-side — `AgentSession._runAgentPrompt`/`_promptUnserialized` are untouched and reached through a `runAgentPrompt` dep, so the drive loop is never duplicated. `AgentSession` constructs it with narrow accessor deps (the live agent, current model, the session/settings managers, the model registry, agent dir, the reflection abort signal, the base system prompt, the isolated-completion primitive, spawned-usage accounting, the event/telemetry emitters, and the recently-extracted `BackgroundLaneController.resolveLaneModel` / `ContextPipeline.resolveCurationModelIfFit`) and keeps a one-line delegation at every call-in: the routing prep + routed-turn entry in `_promptUnserialized`, the `beforeToolCall` mutating-tool escalation branch (`maybeEscalateToolCall`), the `message_end` cheap-turn buffering (`captureSessionMessage`), the retry-event suppression (`isRetryInFlight`), and the public `getModelRouterStatus` plus the autonomy-telemetry last-decision read. Behavior and event ordering are unchanged.
+- The runtime build and the self-modification-safe extension reload moved out of `agent-session.ts` into `core/runtime-builder.ts` (new `RuntimeBuilder`): the tool-registry assembly (`refreshToolRegistry`), the base-tool-definition + `ExtensionRunner` build (`buildRuntime`), the crown-jewel `reload()` with its snapshot / doctor / commit-or-rollback sequence, and the single-extension live load/unload/reconcile operations now live in one module, owning the five tool-registry maps (base tool definitions, the wrapped tool registry, the definition registry, and the per-tool prompt snippet/guideline maps). The reload snapshot spans state owned by other collaborators — the extension runner and its ref, `agent.state.tools`/`agent.state.systemPrompt`, and `_baseSystemPrompt` — which stay host/agent-owned and are captured and restored through narrow get/set deps so save/restore mutate exactly the same fields as before (the `_extensionRunnerRef.current` update folds into `setExtensionRunner`, matching the host's field-then-ref pattern); only the tool-registry maps are owned by the builder. `_bindExtensionCore` stays host-side (it exposes the session's own public surface to the runner — host identity, not build logic) and is invoked from `buildRuntime` via a `bindExtensionCore` dep. `AgentSession` constructs it with narrow accessor deps (the live agent, cwd, the session/settings managers, the model registry, the resource loader, the extension-runner get/set, the base-system-prompt get/set, the custom-tools/base-override, the requested-active-tool-names request, the profile tool filter + its warning sink, memory subsystem accessors, the goal/context-gc/worker/model-fitness tool callbacks, the isolated-completion primitive and spawned-usage accounting, the doctor context-snapshot/context-usage probes, and the streaming/compacting refusal guards) and keeps byte-identical one-line delegations for the public `reload` / `loadExtensionLive` / `unloadExtensionLive` / `reconcileLoadedExtensions` API and for `getAllTools` / `getToolDefinition`, plus a private `_refreshToolRegistry` delegation for its internal callers. The preflight → doctor → commit/rollback sequence and refusal behavior are unchanged.
+- The extension UI surface moved out of `interactive-mode.ts` into `modes/interactive/extension-ui-host.ts` (new `ExtensionUiHost`): the extension-provided dialogs (`select`/`confirm`/`input`, the multi-line editor, and the overlay-capable `custom` component), the above/below-editor widget mounting, extension status text, the custom footer/header swaps, the custom editor-component swap (`setCustomEditorComponent`, its early `editorContainer.clear()` preserved verbatim), keyboard-shortcut wiring, terminal-input listeners, the extension-error render, and the `ExtensionUIContext` handed to extensions now live in one module (22 methods). It owns exactly the state this cluster mutates (the live selector/input/editor dialog components, the above/below widget maps, the terminal-input unsubscribers, the custom footer/header, and the current custom-editor factory). `InteractiveMode` constructs it with narrow deps (a live session accessor plus a UI callback surface: the stable containers/TUI/overlay-host/footer passed directly, the mutable active editor and built-in header reached through get/set accessors, and the render-core / status operations that stay host-side — working indicator, hidden-thinking label, autocomplete rebuild, tools-expansion, terminal title, and shutdown/abort/reload — exposed as callbacks) and keeps one-line delegations at every call-in point: the session-invalidate reset and `handleReloadCommand`'s `resetExtensionUI`, `bindCurrentSessionExtensions`' context/error/shortcut wiring, the reload and live-refresh shortcut re-wiring, the branch-summary and `/import` confirm/selector/editor prompts, the initial widget render, `stop()`'s listener teardown, and the three `getCustomHeader()` header reads. The extension test suites are the lock — extensions see an identical `ExtensionUIContext`; behavior is unchanged.
+- The residual command/flow/plumbing clusters moved out of `interactive-mode.ts` into thirteen new sibling modules, bringing the file under the 4,000-line cap (5,870 → 3,971): `session-flow-commands.ts` (tree/session/fork navigation and the model selectors), `settings-selector-flow.ts` (`/settings`), `local-model-commands.ts` (`/models` lifecycle and `/fitness`), `autonomy-commands.ts` (`/autonomy`, `/auto-learn`), `session-io-commands.ts` (import/export/share/copy/name), `resource-shell-commands.ts` (`/install-resources`, `/curate`, bash, `/compact`), `external-editor.ts` (`$EDITOR`/`$VISUAL` launch), `autocomplete-provider.ts` (base completion set), `startup-checks.ts` (changelog notice, update/tmux checks, notifications, install telemetry, trust warning), `signal-lifecycle.ts` (SIGTERM/SIGHUP/uncaught handlers, graceful+emergency shutdown, Ctrl+Z suspend), `key-handlers.ts` (editor/global key wiring), `clipboard-input.ts` (image paste + user-input assembly), and `compaction-queue.ts` (post-compaction queue flush). Each is a plain function module operating through a narrow structural `host` seam; `InteractiveMode` keeps thin wrappers that build the host from `this` at call time (with get/set accessors for the fields a flow mutates — e.g. `loadingAnimation`, `isShuttingDown`/`signalCleanupHandlers`, `isBashMode`, the clipboard queue/counter, `compactionQueuedMessages`) both because those members are private and because the existing prototype-based tests invoke the wrappers through `this`. The slash-command router, `handleEvent`, the streaming/status-loader lifecycle, `renderSessionContext`, and the render core stay host-side. Bodies are verbatim; behavior is unchanged.
+- The residual autonomy/session/runtime clusters moved out of `agent-session.ts` into eight new `core/` collaborator classes, bringing the file under the 4,000-line cap (5,387 → 3,963): `reflection-controller.ts` (`ReflectionController` — the native end-of-loop reflection pass, the isolated-completion primitive, and the gated learning-apply/rollback path), `goal-loop-controller.ts` (`GoalLoopController` — the bounded goal auto-continuation loop), `session-analytics.ts` (`SessionAnalytics` — usage/cost/stats accounting, the /context window estimate, and HTML/JSONL export, owning the spawned-usage and daily-usage memo caches), `session-tree-navigator.ts` (`SessionTreeNavigator` — in-file branch switching + fork-selector reads), `model-selection-controller.ts` (`ModelSelectionController` — the manual model switch/cycle and thinking-level set/cycle/clamp, distinct from the per-turn `ModelRouterController`), `bash-execution-controller.ts` (`BashExecutionController` — the `/bash` path and its streaming-deferred pending-message queue), `profile-filter-controller.ts` (`ProfileFilterController` — resource-profile tool/extension gating and reload-time profile model re-apply), and `tool-gate-controller.ts` (`ToolGateController` — the agent `beforeToolCall`/`afterToolCall` hooks: router escalation, autonomy gating, extension tool hooks, and the untrusted-content output boundary). `AgentSession` constructs each with narrow lazy accessor deps and keeps same-signature public delegations at every call-in point, so callers, the constructor dep closures, and the drive loop are untouched (the `model`/`thinkingLevel` getters, the branch-summary abort controller read by `isCompacting`, and the bash-flush call sites all stay host-side). The drive loop (`_promptUnserialized`/`_handleAgentEvent`/`_handlePostAgentRun`), compaction, the retry bridge, and the extension-core wiring stay host-side. Bodies are verbatim; behavior is unchanged.
+
+### Fixed
+- `pi --version` resolved through the full application import graph (~1s to print a version string). A fast path in the CLI entry now answers `--version`/`-v` from already-loaded config (~150ms, −85%); any combined invocation still routes through the full parser unchanged.
+- Auto-compaction could fail or skip invisibly: three bail paths (no model, summarizer auth failure, nothing to compact) ended with no result and no reason, and the TUI rendered nothing for that combination — indistinguishable from broken compaction. Every auto-compaction outcome now carries a `result`, an `errorMessage`, or a new `skipReason` on `compaction_end`, and the TUI renders all of them. The cheap summarizer model (#30) also falls back to the session model when its key resolution fails at request time instead of silently giving up.
+- `pi --help` had regressed from ~160ms to ~400ms: `config.ts`'s `normalizePath` import (needed
+  just to resolve `PI_PACKAGE_DIR`) went through `utils/paths.ts`, which re-exported from
+  `@caupulican/pi-agent-core/node` — a barrel that also loads `SessionManager`, compaction,
+  messages, and process-tree, none of which the help path needs. `utils/paths.ts` now imports from
+  the kernel's new granular `@caupulican/pi-agent-core/paths` subpath instead, restoring `--help` to
+  its ~160ms baseline; behavior and the re-exported surface are unchanged.
+- Bash commands could previously race file-tool (`edit`/`write`) mutations: because a shell command
+  cannot statically declare which files it touches, it wasn't serialized against them at all. The
+  bash tool's foreground command execution now goes through a readers-writer barrier shared with
+  `withFileMutationQueue`: file mutations are readers (still parallel with each other across
+  different files), and bash is the sole writer — it waits for all in-flight/queued file mutations
+  to drain, then runs exclusively while blocking new ones, and queues FIFO against other bash
+  invocations. New `withExclusiveMutationBarrier` in `file-mutation-queue.ts`.
+- `execCommand`'s kill path (used by aborted/timed-out commands, including extensions' `ctx.exec`)
+  now actually escalates to SIGKILL: it previously gated escalation on `ChildProcess.killed`, which
+  Node sets the moment a signal is *sent* rather than when the process dies, so a child trapping
+  SIGTERM survived forever. The kill path now delegates to the reliability kernel's `killTree`
+  (liveness-probed SIGTERM → SIGKILL escalation). Commands also spawn in their own process group on
+  POSIX so aborting kills grandchildren, not just the direct child. Spawn failures (e.g. ENOENT) are
+  now surfaced via a new `ExecResult.errorMessage` field instead of being silently swallowed as a
+  bare `code: 1`.
+- Model adoption ignored the fitness probe's own verdict. Two gates, both fixed:
+  - `/models suggest` (and the manual `/fitness` picker) could probe a model, get zero successes on
+    every one of the six surfaces, and still land it as judge model / Model Router settings because
+    the post-probe role selector opened regardless of the result. `runFitnessAndAssign` — the single
+    site both flows funnel through — now checks the new pure `isProbeAllFailed(report)` predicate
+    (research/core/research/model-fitness.ts) and, on an all-lanes-failed probe, refuses adoption
+    outright: no role assigned, no settings written, just a clear "failed the fitness probe on all
+    surfaces — not configured" message pointing at manual `/model` as the opt-in override. A partial
+    or full pass keeps the existing selector flow unchanged. The predicate itself had a latent
+    vacuous-truth gap: when every lane surface was ungraded (`total: 0`) but the judge ran and
+    failed, `gradedLanes.every(...)` was trivially true over the empty array, so a report with zero
+    lane evidence could still be read as all-lanes-failed — it now requires at least one actually
+    graded lane before returning that verdict.
+  - Manual `/model <ref>` had no gate at all, so a model already known (from a stored fitness
+    report) to fail on every surface, or a local Ollama model whose weights don't fit in RAM, could
+    be set silently and 500 every subsequent turn (llama-server OOM). `AgentSession.setModel` is
+    advisory-only here by design — a human's explicit choice is never blocked — but now emits a
+    `warning` event (the same plain-text channel print/RPC modes already render, never a prompt)
+    when the target has a recorded all-lanes-failed probe on this host, or is an Ollama model whose
+    installed size exceeds ~90% of `os.totalmem()`. This advisory now also covers `cycleModel`
+    (reachable via the `app.model.cycleForward`/`cycleBackward` keybindings and the RPC
+    `cycleModel` call), which previously bypassed it entirely on both the scoped (`--models`) and
+    all-available cycle paths, silently landing on a known-bad or OOM-prone model. The Ollama
+    size/RAM lookup (and `/models remove`) also missed installed models referenced by a bare tag —
+    Ollama's `/api/tags` always reports an explicit tag, defaulting to `:latest`, so an exact-string
+    match silently skipped the check whenever a user typed a bare ref (e.g. `llama3` vs. the
+    installed `llama3:latest`); both call sites now share one `matchesInstalledLocalModel` helper
+    (`core/models/model-ref.ts`) that accounts for the bare/`:latest` pairing.
+- `output-accumulator-io-errors.test.ts`'s `vi.mock("node:fs", ...)` factory returned only the three
+  members the test overrides (`closeSync`, `openSync`, `writeSync`), so any other `node:fs` export
+  accessed during the run — `existsSync`, read at import time by `@caupulican/pi-ai`'s
+  `env-api-keys.ts` — threw inside vitest's mock proxy and surfaced as an unhandled rejection, even
+  though the test's own assertions passed. The mock now spreads the real module
+  (`importOriginal()`) and overrides only the three functions it needs, so unmocked exports stay
+  real.
+- `keyHandlersHost()` snapshotted `editor`, `session`, and `settingsManager` onto the key-handler
+  host object at `setupKeyHandlers()`'s one-time init instead of reading them live off `this`. All
+  three are swappable after init — `editor` via extension custom editors (`setEditor`, whose
+  `onEscape` delegates back through the closures installed on `defaultEditor`), and
+  `session`/`settingsManager` via `/reload`'s runtime-host swap — so Escape handling kept reading
+  the stale pre-swap objects: Escape could fail to abort bash on a reloaded session, and the
+  double-escape `/tree`/`/fork` trigger could read the wrong editor's text. `keyHandlersHost()` now
+  exposes `editor`, `session`, and `settingsManager` as live getters over the instance (matching the
+  existing `isBashMode`/`lastEscapeTime` accessor pattern); `defaultEditor` and `ui` stay plain
+  properties since they're set once and never swapped.
+
+## [0.80.103] - 2026-07-03
+
+### Fixed
+
+- Config-directory override environment variables are now POSIX-valid and actually usable. Because
+  `piConfig.name` is `pi-adaptative`, the derived names were `PI-ADAPTATIVE_CODING_AGENT_DIR` and
+  `PI-ADAPTATIVE_CODING_AGENT_SESSION_DIR` — but a hyphen is invalid in a shell variable name, so
+  `export PI-ADAPTATIVE_CODING_AGENT_DIR=…` is a parse error and the documented override (shown in
+  `pi --help`) silently could not be set. The names are now sanitized to
+  `PI_ADAPTATIVE_CODING_AGENT_DIR` and `PI_ADAPTATIVE_CODING_AGENT_SESSION_DIR`.
+
 ## [0.80.102] - 2026-07-03
 
 ### Fixed

package/dist/cli/session-picker.d.ts

@@ -1,7 +1,7 @@
 /**
  * TUI session selector for --resume flag
  */
-import type { SessionInfo, SessionListProgress } from "../core/session-manager.ts";
+import type { SessionInfo, SessionListProgress } from "@caupulican/pi-agent-core/node";
 type SessionsLoader = (onProgress?: SessionListProgress) => Promise<SessionInfo[]>;
 /** Show TUI session selector and return selected session path or null if cancelled */
 export declare function selectSession(currentSessionsLoader: SessionsLoader, allSessionsLoader: SessionsLoader): Promise<string | null>;

package/dist/cli/session-picker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-picker.d.ts","sourceRoot":"","sources":["../../src/cli/session-picker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGnF,KAAK,cAAc,GAAG,CAAC,UAAU,CAAC,EAAE,mBAAmB,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;AAEnF,sFAAsF;AACtF,wBAAsB,aAAa,CAClC,qBAAqB,EAAE,cAAc,EACrC,iBAAiB,EAAE,cAAc,GAC/B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoCxB","sourcesContent":["/**\n * TUI session selector for --resume flag\n */\n\nimport { ProcessTerminal, setKeybindings, TUI } from \"@caupulican/pi-tui\";\nimport { KeybindingsManager } from \"../core/keybindings.ts\";\nimport type { SessionInfo, SessionListProgress } from \"../core/session-manager.ts\";\nimport { SessionSelectorComponent } from \"../modes/interactive/components/session-selector.ts\";\n\ntype SessionsLoader = (onProgress?: SessionListProgress) => Promise<SessionInfo[]>;\n\n/** Show TUI session selector and return selected session path or null if cancelled */\nexport async function selectSession(\n\tcurrentSessionsLoader: SessionsLoader,\n\tallSessionsLoader: SessionsLoader,\n): Promise<string | null> {\n\treturn new Promise((resolve) => {\n\t\tconst ui = new TUI(new ProcessTerminal());\n\t\tconst keybindings = KeybindingsManager.create();\n\t\tsetKeybindings(keybindings);\n\t\tlet resolved = false;\n\n\t\tconst selector = new SessionSelectorComponent(\n\t\t\tcurrentSessionsLoader,\n\t\t\tallSessionsLoader,\n\t\t\t(path: string) => {\n\t\t\t\tif (!resolved) {\n\t\t\t\t\tresolved = true;\n\t\t\t\t\tui.stop();\n\t\t\t\t\tresolve(path);\n\t\t\t\t}\n\t\t\t},\n\t\t\t() => {\n\t\t\t\tif (!resolved) {\n\t\t\t\t\tresolved = true;\n\t\t\t\t\tui.stop();\n\t\t\t\t\tresolve(null);\n\t\t\t\t}\n\t\t\t},\n\t\t\t() => {\n\t\t\t\tui.stop();\n\t\t\t\tprocess.exit(0);\n\t\t\t},\n\t\t\t() => ui.requestRender(),\n\t\t\t{ showRenameHint: false, keybindings },\n\t\t);\n\n\t\tui.addChild(selector);\n\t\tui.setFocus(selector.getSessionList());\n\t\tui.start();\n\t});\n}\n"]}
+{"version":3,"file":"session-picker.d.ts","sourceRoot":"","sources":["../../src/cli/session-picker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAKvF,KAAK,cAAc,GAAG,CAAC,UAAU,CAAC,EAAE,mBAAmB,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;AAEnF,sFAAsF;AACtF,wBAAsB,aAAa,CAClC,qBAAqB,EAAE,cAAc,EACrC,iBAAiB,EAAE,cAAc,GAC/B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoCxB","sourcesContent":["/**\n * TUI session selector for --resume flag\n */\n\nimport type { SessionInfo, SessionListProgress } from \"@caupulican/pi-agent-core/node\";\nimport { ProcessTerminal, setKeybindings, TUI } from \"@caupulican/pi-tui\";\nimport { KeybindingsManager } from \"../core/keybindings.ts\";\nimport { SessionSelectorComponent } from \"../modes/interactive/components/session-selector.ts\";\n\ntype SessionsLoader = (onProgress?: SessionListProgress) => Promise<SessionInfo[]>;\n\n/** Show TUI session selector and return selected session path or null if cancelled */\nexport async function selectSession(\n\tcurrentSessionsLoader: SessionsLoader,\n\tallSessionsLoader: SessionsLoader,\n): Promise<string | null> {\n\treturn new Promise((resolve) => {\n\t\tconst ui = new TUI(new ProcessTerminal());\n\t\tconst keybindings = KeybindingsManager.create();\n\t\tsetKeybindings(keybindings);\n\t\tlet resolved = false;\n\n\t\tconst selector = new SessionSelectorComponent(\n\t\t\tcurrentSessionsLoader,\n\t\t\tallSessionsLoader,\n\t\t\t(path: string) => {\n\t\t\t\tif (!resolved) {\n\t\t\t\t\tresolved = true;\n\t\t\t\t\tui.stop();\n\t\t\t\t\tresolve(path);\n\t\t\t\t}\n\t\t\t},\n\t\t\t() => {\n\t\t\t\tif (!resolved) {\n\t\t\t\t\tresolved = true;\n\t\t\t\t\tui.stop();\n\t\t\t\t\tresolve(null);\n\t\t\t\t}\n\t\t\t},\n\t\t\t() => {\n\t\t\t\tui.stop();\n\t\t\t\tprocess.exit(0);\n\t\t\t},\n\t\t\t() => ui.requestRender(),\n\t\t\t{ showRenameHint: false, keybindings },\n\t\t);\n\n\t\tui.addChild(selector);\n\t\tui.setFocus(selector.getSessionList());\n\t\tui.start();\n\t});\n}\n"]}

package/dist/cli/session-picker.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-picker.js","sourceRoot":"","sources":["../../src/cli/session-picker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qDAAqD,CAAC;AAI/F,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,qBAAqC,EACrC,iBAAiC,EACR;IACzB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/B,MAAM,EAAE,GAAG,IAAI,GAAG,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;QAC1C,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,EAAE,CAAC;QAChD,cAAc,CAAC,WAAW,CAAC,CAAC;QAC5B,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,MAAM,QAAQ,GAAG,IAAI,wBAAwB,CAC5C,qBAAqB,EACrB,iBAAiB,EACjB,CAAC,IAAY,EAAE,EAAE,CAAC;YACjB,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACf,QAAQ,GAAG,IAAI,CAAC;gBAChB,EAAE,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,CAAC,IAAI,CAAC,CAAC;YACf,CAAC;QAAA,CACD,EACD,GAAG,EAAE,CAAC;YACL,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACf,QAAQ,GAAG,IAAI,CAAC;gBAChB,EAAE,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,CAAC,IAAI,CAAC,CAAC;YACf,CAAC;QAAA,CACD,EACD,GAAG,EAAE,CAAC;YACL,EAAE,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAA,CAChB,EACD,GAAG,EAAE,CAAC,EAAE,CAAC,aAAa,EAAE,EACxB,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,CACtC,CAAC;QAEF,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACtB,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC;QACvC,EAAE,CAAC,KAAK,EAAE,CAAC;IAAA,CACX,CAAC,CAAC;AAAA,CACH","sourcesContent":["/**\n * TUI session selector for --resume flag\n */\n\nimport { ProcessTerminal, setKeybindings, TUI } from \"@caupulican/pi-tui\";\nimport { KeybindingsManager } from \"../core/keybindings.ts\";\nimport type { SessionInfo, SessionListProgress } from \"../core/session-manager.ts\";\nimport { SessionSelectorComponent } from \"../modes/interactive/components/session-selector.ts\";\n\ntype SessionsLoader = (onProgress?: SessionListProgress) => Promise<SessionInfo[]>;\n\n/** Show TUI session selector and return selected session path or null if cancelled */\nexport async function selectSession(\n\tcurrentSessionsLoader: SessionsLoader,\n\tallSessionsLoader: SessionsLoader,\n): Promise<string | null> {\n\treturn new Promise((resolve) => {\n\t\tconst ui = new TUI(new ProcessTerminal());\n\t\tconst keybindings = KeybindingsManager.create();\n\t\tsetKeybindings(keybindings);\n\t\tlet resolved = false;\n\n\t\tconst selector = new SessionSelectorComponent(\n\t\t\tcurrentSessionsLoader,\n\t\t\tallSessionsLoader,\n\t\t\t(path: string) => {\n\t\t\t\tif (!resolved) {\n\t\t\t\t\tresolved = true;\n\t\t\t\t\tui.stop();\n\t\t\t\t\tresolve(path);\n\t\t\t\t}\n\t\t\t},\n\t\t\t() => {\n\t\t\t\tif (!resolved) {\n\t\t\t\t\tresolved = true;\n\t\t\t\t\tui.stop();\n\t\t\t\t\tresolve(null);\n\t\t\t\t}\n\t\t\t},\n\t\t\t() => {\n\t\t\t\tui.stop();\n\t\t\t\tprocess.exit(0);\n\t\t\t},\n\t\t\t() => ui.requestRender(),\n\t\t\t{ showRenameHint: false, keybindings },\n\t\t);\n\n\t\tui.addChild(selector);\n\t\tui.setFocus(selector.getSessionList());\n\t\tui.start();\n\t});\n}\n"]}
+{"version":3,"file":"session-picker.js","sourceRoot":"","sources":["../../src/cli/session-picker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qDAAqD,CAAC;AAI/F,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,qBAAqC,EACrC,iBAAiC,EACR;IACzB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/B,MAAM,EAAE,GAAG,IAAI,GAAG,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;QAC1C,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,EAAE,CAAC;QAChD,cAAc,CAAC,WAAW,CAAC,CAAC;QAC5B,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,MAAM,QAAQ,GAAG,IAAI,wBAAwB,CAC5C,qBAAqB,EACrB,iBAAiB,EACjB,CAAC,IAAY,EAAE,EAAE,CAAC;YACjB,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACf,QAAQ,GAAG,IAAI,CAAC;gBAChB,EAAE,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,CAAC,IAAI,CAAC,CAAC;YACf,CAAC;QAAA,CACD,EACD,GAAG,EAAE,CAAC;YACL,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACf,QAAQ,GAAG,IAAI,CAAC;gBAChB,EAAE,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,CAAC,IAAI,CAAC,CAAC;YACf,CAAC;QAAA,CACD,EACD,GAAG,EAAE,CAAC;YACL,EAAE,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAA,CAChB,EACD,GAAG,EAAE,CAAC,EAAE,CAAC,aAAa,EAAE,EACxB,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,CACtC,CAAC;QAEF,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACtB,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC;QACvC,EAAE,CAAC,KAAK,EAAE,CAAC;IAAA,CACX,CAAC,CAAC;AAAA,CACH","sourcesContent":["/**\n * TUI session selector for --resume flag\n */\n\nimport type { SessionInfo, SessionListProgress } from \"@caupulican/pi-agent-core/node\";\nimport { ProcessTerminal, setKeybindings, TUI } from \"@caupulican/pi-tui\";\nimport { KeybindingsManager } from \"../core/keybindings.ts\";\nimport { SessionSelectorComponent } from \"../modes/interactive/components/session-selector.ts\";\n\ntype SessionsLoader = (onProgress?: SessionListProgress) => Promise<SessionInfo[]>;\n\n/** Show TUI session selector and return selected session path or null if cancelled */\nexport async function selectSession(\n\tcurrentSessionsLoader: SessionsLoader,\n\tallSessionsLoader: SessionsLoader,\n): Promise<string | null> {\n\treturn new Promise((resolve) => {\n\t\tconst ui = new TUI(new ProcessTerminal());\n\t\tconst keybindings = KeybindingsManager.create();\n\t\tsetKeybindings(keybindings);\n\t\tlet resolved = false;\n\n\t\tconst selector = new SessionSelectorComponent(\n\t\t\tcurrentSessionsLoader,\n\t\t\tallSessionsLoader,\n\t\t\t(path: string) => {\n\t\t\t\tif (!resolved) {\n\t\t\t\t\tresolved = true;\n\t\t\t\t\tui.stop();\n\t\t\t\t\tresolve(path);\n\t\t\t\t}\n\t\t\t},\n\t\t\t() => {\n\t\t\t\tif (!resolved) {\n\t\t\t\t\tresolved = true;\n\t\t\t\t\tui.stop();\n\t\t\t\t\tresolve(null);\n\t\t\t\t}\n\t\t\t},\n\t\t\t() => {\n\t\t\t\tui.stop();\n\t\t\t\tprocess.exit(0);\n\t\t\t},\n\t\t\t() => ui.requestRender(),\n\t\t\t{ showRenameHint: false, keybindings },\n\t\t);\n\n\t\tui.addChild(selector);\n\t\tui.setFocus(selector.getSessionList());\n\t\tui.start();\n\t});\n}\n"]}

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"","sourcesContent":["#!/usr/bin/env node\n/**\n * CLI entry point for the refactored coding agent.\n * Uses main.ts with AgentSession and new mode modules.\n *\n * Test with: npx tsx src/cli-new.ts [args...]\n */\nimport { APP_NAME } from \"./config.ts\";\nimport { configureHttpDispatcher } from \"./core/http-dispatcher.ts\";\n\nprocess.title = APP_NAME;\nprocess.env.PI_CODING_AGENT = \"true\";\nprocess.emitWarning = (() => {}) as typeof process.emitWarning;\n\n// Configure undici's global dispatcher before provider SDKs issue requests.\n// Runtime settings are applied once SettingsManager has loaded global/project settings.\nconfigureHttpDispatcher();\n\nconst cliArgs = process.argv.slice(2);\nconst [firstArg] = cliArgs;\nconst packageCommands = new Set([\"install\", \"remove\", \"uninstall\", \"update\", \"list\", \"config\"]);\nif ((cliArgs.includes(\"--help\") || cliArgs.includes(\"-h\")) && !packageCommands.has(firstArg ?? \"\")) {\n\tconst [{ parseArgs, printHelp }, { takeOverStdout }] = await Promise.all([\n\t\timport(\"./cli/args.ts\"),\n\t\timport(\"./core/output-guard.ts\"),\n\t]);\n\tconst parsed = parseArgs(cliArgs);\n\tif (parsed.mode === \"json\" || parsed.mode === \"rpc\" || parsed.print || !process.stdin.isTTY) {\n\t\ttakeOverStdout();\n\t}\n\tprintHelp([]);\n\tprocess.exit(0);\n}\n\nconst { main } = await import(\"./main.ts\");\nmain(cliArgs);\n"]}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"","sourcesContent":["#!/usr/bin/env node\n/**\n * CLI entry point for the refactored coding agent.\n * Uses main.ts with AgentSession and new mode modules.\n *\n * Test with: npx tsx src/cli-new.ts [args...]\n */\nimport { APP_NAME, VERSION } from \"./config.ts\";\nimport { configureHttpDispatcher } from \"./core/http-dispatcher.ts\";\n\nprocess.title = APP_NAME;\nprocess.env.PI_CODING_AGENT = \"true\";\nprocess.emitWarning = (() => {}) as typeof process.emitWarning;\n\n// Configure undici's global dispatcher before provider SDKs issue requests.\n// Runtime settings are applied once SettingsManager has loaded global/project settings.\nconfigureHttpDispatcher();\n\nconst cliArgs = process.argv.slice(2);\nconst [firstArg] = cliArgs;\nconst packageCommands = new Set([\"install\", \"remove\", \"uninstall\", \"update\", \"list\", \"config\"]);\n\n// Fast path: version needs nothing beyond config.ts (already loaded). Mirrors main.ts's\n// `parsed.version` output exactly; skipping main's import graph turns ~1s into ~150ms.\nif ((firstArg === \"--version\" || firstArg === \"-v\") && cliArgs.length === 1) {\n\tconsole.log(VERSION);\n\tprocess.exit(0);\n}\nif ((cliArgs.includes(\"--help\") || cliArgs.includes(\"-h\")) && !packageCommands.has(firstArg ?? \"\")) {\n\tconst [{ parseArgs, printHelp }, { takeOverStdout }] = await Promise.all([\n\t\timport(\"./cli/args.ts\"),\n\t\timport(\"./core/output-guard.ts\"),\n\t]);\n\tconst parsed = parseArgs(cliArgs);\n\tif (parsed.mode === \"json\" || parsed.mode === \"rpc\" || parsed.print || !process.stdin.isTTY) {\n\t\ttakeOverStdout();\n\t}\n\tprintHelp([]);\n\tprocess.exit(0);\n}\n\nconst { main } = await import(\"./main.ts\");\nmain(cliArgs);\n"]}

package/dist/cli.js

@@ -5,7 +5,7 @@
  *
  * Test with: npx tsx src/cli-new.ts [args...]
  */
-import { APP_NAME } from "./config.js";
+import { APP_NAME, VERSION } from "./config.js";
 import { configureHttpDispatcher } from "./core/http-dispatcher.js";
 process.title = APP_NAME;
 process.env.PI_CODING_AGENT = "true";
@@ -16,6 +16,12 @@ configureHttpDispatcher();
 const cliArgs = process.argv.slice(2);
 const [firstArg] = cliArgs;
 const packageCommands = new Set(["install", "remove", "uninstall", "update", "list", "config"]);
+// Fast path: version needs nothing beyond config.ts (already loaded). Mirrors main.ts's
+// `parsed.version` output exactly; skipping main's import graph turns ~1s into ~150ms.
+if ((firstArg === "--version" || firstArg === "-v") && cliArgs.length === 1) {
+    console.log(VERSION);
+    process.exit(0);
+}
 if ((cliArgs.includes("--help") || cliArgs.includes("-h")) && !packageCommands.has(firstArg ?? "")) {
     const [{ parseArgs, printHelp }, { takeOverStdout }] = await Promise.all([
         import("./cli/args.js"),

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC;AACzB,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,MAAM,CAAC;AACrC,OAAO,CAAC,WAAW,GAAG,CAAC,GAAG,EAAE,CAAC,EAAC,CAAC,CAA+B,CAAC;AAE/D,4EAA4E;AAC5E,wFAAwF;AACxF,uBAAuB,EAAE,CAAC;AAE1B,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACtC,MAAM,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC;AAC3B,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AAChG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;IACpG,MAAM,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACxE,MAAM,CAAC,eAAe,CAAC;QACvB,MAAM,CAAC,wBAAwB,CAAC;KAChC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC7F,cAAc,EAAE,CAAC;IAClB,CAAC;IACD,SAAS,CAAC,EAAE,CAAC,CAAC;IACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC;AAED,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;AAC3C,IAAI,CAAC,OAAO,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\n/**\n * CLI entry point for the refactored coding agent.\n * Uses main.ts with AgentSession and new mode modules.\n *\n * Test with: npx tsx src/cli-new.ts [args...]\n */\nimport { APP_NAME } from \"./config.ts\";\nimport { configureHttpDispatcher } from \"./core/http-dispatcher.ts\";\n\nprocess.title = APP_NAME;\nprocess.env.PI_CODING_AGENT = \"true\";\nprocess.emitWarning = (() => {}) as typeof process.emitWarning;\n\n// Configure undici's global dispatcher before provider SDKs issue requests.\n// Runtime settings are applied once SettingsManager has loaded global/project settings.\nconfigureHttpDispatcher();\n\nconst cliArgs = process.argv.slice(2);\nconst [firstArg] = cliArgs;\nconst packageCommands = new Set([\"install\", \"remove\", \"uninstall\", \"update\", \"list\", \"config\"]);\nif ((cliArgs.includes(\"--help\") || cliArgs.includes(\"-h\")) && !packageCommands.has(firstArg ?? \"\")) {\n\tconst [{ parseArgs, printHelp }, { takeOverStdout }] = await Promise.all([\n\t\timport(\"./cli/args.ts\"),\n\t\timport(\"./core/output-guard.ts\"),\n\t]);\n\tconst parsed = parseArgs(cliArgs);\n\tif (parsed.mode === \"json\" || parsed.mode === \"rpc\" || parsed.print || !process.stdin.isTTY) {\n\t\ttakeOverStdout();\n\t}\n\tprintHelp([]);\n\tprocess.exit(0);\n}\n\nconst { main } = await import(\"./main.ts\");\nmain(cliArgs);\n"]}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC;AACzB,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,MAAM,CAAC;AACrC,OAAO,CAAC,WAAW,GAAG,CAAC,GAAG,EAAE,CAAC,EAAC,CAAC,CAA+B,CAAC;AAE/D,4EAA4E;AAC5E,wFAAwF;AACxF,uBAAuB,EAAE,CAAC;AAE1B,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACtC,MAAM,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC;AAC3B,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEhG,wFAAwF;AACxF,uFAAuF;AACvF,IAAI,CAAC,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IAC7E,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC;AACD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;IACpG,MAAM,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACxE,MAAM,CAAC,eAAe,CAAC;QACvB,MAAM,CAAC,wBAAwB,CAAC;KAChC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC7F,cAAc,EAAE,CAAC;IAClB,CAAC;IACD,SAAS,CAAC,EAAE,CAAC,CAAC;IACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC;AAED,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;AAC3C,IAAI,CAAC,OAAO,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\n/**\n * CLI entry point for the refactored coding agent.\n * Uses main.ts with AgentSession and new mode modules.\n *\n * Test with: npx tsx src/cli-new.ts [args...]\n */\nimport { APP_NAME, VERSION } from \"./config.ts\";\nimport { configureHttpDispatcher } from \"./core/http-dispatcher.ts\";\n\nprocess.title = APP_NAME;\nprocess.env.PI_CODING_AGENT = \"true\";\nprocess.emitWarning = (() => {}) as typeof process.emitWarning;\n\n// Configure undici's global dispatcher before provider SDKs issue requests.\n// Runtime settings are applied once SettingsManager has loaded global/project settings.\nconfigureHttpDispatcher();\n\nconst cliArgs = process.argv.slice(2);\nconst [firstArg] = cliArgs;\nconst packageCommands = new Set([\"install\", \"remove\", \"uninstall\", \"update\", \"list\", \"config\"]);\n\n// Fast path: version needs nothing beyond config.ts (already loaded). Mirrors main.ts's\n// `parsed.version` output exactly; skipping main's import graph turns ~1s into ~150ms.\nif ((firstArg === \"--version\" || firstArg === \"-v\") && cliArgs.length === 1) {\n\tconsole.log(VERSION);\n\tprocess.exit(0);\n}\nif ((cliArgs.includes(\"--help\") || cliArgs.includes(\"-h\")) && !packageCommands.has(firstArg ?? \"\")) {\n\tconst [{ parseArgs, printHelp }, { takeOverStdout }] = await Promise.all([\n\t\timport(\"./cli/args.ts\"),\n\t\timport(\"./core/output-guard.ts\"),\n\t]);\n\tconst parsed = parseArgs(cliArgs);\n\tif (parsed.mode === \"json\" || parsed.mode === \"rpc\" || parsed.print || !process.stdin.isTTY) {\n\t\ttakeOverStdout();\n\t}\n\tprintHelp([]);\n\tprocess.exit(0);\n}\n\nconst { main } = await import(\"./main.ts\");\nmain(cliArgs);\n"]}

package/dist/config.d.ts

@@ -78,6 +78,17 @@ export declare const APP_NAME: string;
 export declare const APP_TITLE: string;
 export declare const CONFIG_DIR_NAME: string;
 export declare const VERSION: string;
+/**
+ * Build a POSIX-valid environment-variable name from an app name and a suffix.
+ *
+ * APP_NAME comes from `piConfig.name`, which may contain characters that are invalid in a shell
+ * env-var name — notably the hyphen in "pi-adaptative". A hyphenated name cannot be exported from
+ * a shell (`export PI-ADAPTATIVE_CODING_AGENT_DIR=…` is a parse error), which silently made the
+ * documented config-dir override unusable. Uppercase, collapse every character outside [A-Z0-9_]
+ * to "_", and prefix "_" if the result would start with a digit (names may not begin with one).
+ * e.g. "pi" -> PI_CODING_AGENT_DIR, "pi-adaptative" -> PI_ADAPTATIVE_CODING_AGENT_DIR.
+ */
+export declare function toEnvVarName(appName: string, suffix: string): string;
 export declare const ENV_AGENT_DIR: string;
 export declare const ENV_SESSION_DIR: string;
 export declare function expandTildePath(path: string): string;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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","sourcesContent":["import { accessSync, constants, existsSync, readFileSync, realpathSync } from \"fs\";\nimport { homedir } from \"os\";\nimport { basename, dirname, join, resolve, sep, win32 } from \"path\";\nimport { fileURLToPath } from \"url\";\nimport { spawnProcessSync } from \"./utils/child-process.ts\";\nimport { normalizePath } from \"./utils/paths.ts\";\n\n// =============================================================================\n// Package Detection\n// =============================================================================\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\nconst PI_ADAPTATIVE_RELEASES_URL = \"https://github.com/Caupulican/pi-adaptative/releases/latest\";\n\n/**\n * Detect if we're running as a Bun compiled binary.\n * Bun binaries have import.meta.url containing \"$bunfs\", \"~BUN\", or \"%7EBUN\" (Bun's virtual filesystem path)\n */\nexport const isBunBinary =\n\timport.meta.url.includes(\"$bunfs\") || import.meta.url.includes(\"~BUN\") || import.meta.url.includes(\"%7EBUN\");\n\n/** Detect if Bun is the runtime (compiled binary or bun run) */\nexport const isBunRuntime = !!process.versions.bun;\n\n// =============================================================================\n// Install Method Detection\n// =============================================================================\n\nexport type InstallMethod = \"bun-binary\" | \"npm\" | \"pnpm\" | \"yarn\" | \"bun\" | \"unknown\";\n\ninterface SelfUpdateCommandStep {\n\tcommand: string;\n\targs: string[];\n\tdisplay: string;\n}\n\nexport interface SelfUpdateCommand extends SelfUpdateCommandStep {\n\tsteps?: SelfUpdateCommandStep[];\n}\n\nfunction makeSelfUpdateCommand(\n\tinstallStep: SelfUpdateCommandStep,\n\tuninstallStep?: SelfUpdateCommandStep,\n): SelfUpdateCommand {\n\tif (!uninstallStep) return installStep;\n\treturn {\n\t\t...installStep,\n\t\tdisplay: `${uninstallStep.display} && ${installStep.display}`,\n\t\tsteps: [uninstallStep, installStep],\n\t};\n}\n\nfunction makeSelfUpdateCommandStep(command: string, args: string[]): SelfUpdateCommandStep {\n\treturn {\n\t\tcommand,\n\t\targs,\n\t\tdisplay: [command, ...args].map((arg) => (/\\s/.test(arg) ? `\"${arg}\"` : arg)).join(\" \"),\n\t};\n}\n\nexport function detectInstallMethod(): InstallMethod {\n\tif (isBunBinary) {\n\t\treturn \"bun-binary\";\n\t}\n\n\tconst resolvedPath = `${__dirname}\\0${process.execPath || \"\"}`.toLowerCase().replace(/\\\\/g, \"/\");\n\n\tif (resolvedPath.includes(\"/pnpm/\") || resolvedPath.includes(\"/.pnpm/\")) {\n\t\treturn \"pnpm\";\n\t}\n\tif (resolvedPath.includes(\"/yarn/\") || resolvedPath.includes(\"/.yarn/\")) {\n\t\treturn \"yarn\";\n\t}\n\tif (isBunRuntime || resolvedPath.includes(\"/install/global/node_modules/\")) {\n\t\treturn \"bun\";\n\t}\n\tif (resolvedPath.includes(\"/npm/\") || resolvedPath.includes(\"/node_modules/\")) {\n\t\treturn \"npm\";\n\t}\n\n\treturn \"unknown\";\n}\n\nfunction getInferredNpmInstall(): { root: string; prefix: string } | undefined {\n\tconst packageDir = getPackageDir();\n\tconst path = process.platform === \"win32\" || packageDir.includes(\"\\\\\") ? win32 : { basename, dirname };\n\tconst parent = path.dirname(packageDir);\n\tlet root: string | undefined;\n\tif (path.basename(parent).startsWith(\"@\") && path.basename(path.dirname(parent)) === \"node_modules\") {\n\t\troot = path.dirname(parent);\n\t} else if (path.basename(parent) === \"node_modules\") {\n\t\troot = parent;\n\t}\n\tif (!root) return undefined;\n\tconst rootParent = path.dirname(root);\n\tif (path.basename(rootParent) === \"lib\") return { root, prefix: path.dirname(rootParent) };\n\t// Windows global npm prefixes use `<prefix>\\\\node_modules`, which is\n\t// indistinguishable from local project installs by path shape alone. Do not\n\t// infer unsupported Windows custom prefixes without `npm root -g` evidence.\n\treturn undefined;\n}\n\nfunction getSelfUpdateCommandForMethod(\n\tmethod: InstallMethod,\n\tinstalledPackageName: string,\n\tupdatePackageName = installedPackageName,\n\tnpmCommand?: string[],\n): SelfUpdateCommand | undefined {\n\tswitch (method) {\n\t\tcase \"bun-binary\":\n\t\t\treturn undefined;\n\t\tcase \"pnpm\":\n\t\t\treturn makeSelfUpdateCommand(\n\t\t\t\tmakeSelfUpdateCommandStep(\"pnpm\", [\n\t\t\t\t\t\"install\",\n\t\t\t\t\t\"-g\",\n\t\t\t\t\t\"--ignore-scripts\",\n\t\t\t\t\t\"--config.minimumReleaseAge=0\",\n\t\t\t\t\tupdatePackageName,\n\t\t\t\t]),\n\t\t\t\tupdatePackageName === installedPackageName\n\t\t\t\t\t? undefined\n\t\t\t\t\t: makeSelfUpdateCommandStep(\"pnpm\", [\"remove\", \"-g\", installedPackageName]),\n\t\t\t);\n\t\tcase \"yarn\":\n\t\t\treturn makeSelfUpdateCommand(\n\t\t\t\tmakeSelfUpdateCommandStep(\"yarn\", [\"global\", \"add\", \"--ignore-scripts\", updatePackageName]),\n\t\t\t\tupdatePackageName === installedPackageName\n\t\t\t\t\t? undefined\n\t\t\t\t\t: makeSelfUpdateCommandStep(\"yarn\", [\"global\", \"remove\", installedPackageName]),\n\t\t\t);\n\t\tcase \"bun\":\n\t\t\treturn makeSelfUpdateCommand(\n\t\t\t\tmakeSelfUpdateCommandStep(\"bun\", [\n\t\t\t\t\t\"install\",\n\t\t\t\t\t\"-g\",\n\t\t\t\t\t\"--ignore-scripts\",\n\t\t\t\t\t\"--minimum-release-age=0\",\n\t\t\t\t\tupdatePackageName,\n\t\t\t\t]),\n\t\t\t\tupdatePackageName === installedPackageName\n\t\t\t\t\t? undefined\n\t\t\t\t\t: makeSelfUpdateCommandStep(\"bun\", [\"uninstall\", \"-g\", installedPackageName]),\n\t\t\t);\n\t\tcase \"npm\": {\n\t\t\tconst [command = \"npm\", ...npmArgs] = npmCommand ?? [];\n\t\t\tconst inferred = npmCommand?.length ? undefined : getInferredNpmInstall();\n\t\t\tconst prefixArgs = [...npmArgs, ...(inferred ? [\"--prefix\", inferred.prefix] : [])];\n\t\t\tconst installStep = makeSelfUpdateCommandStep(command, [\n\t\t\t\t...prefixArgs,\n\t\t\t\t\"install\",\n\t\t\t\t\"-g\",\n\t\t\t\t\"--ignore-scripts\",\n\t\t\t\t\"--min-release-age=0\",\n\t\t\t\tupdatePackageName,\n\t\t\t]);\n\t\t\tconst uninstallStep =\n\t\t\t\tupdatePackageName === installedPackageName\n\t\t\t\t\t? undefined\n\t\t\t\t\t: makeSelfUpdateCommandStep(command, [...prefixArgs, \"uninstall\", \"-g\", installedPackageName]);\n\t\t\treturn makeSelfUpdateCommand(installStep, uninstallStep);\n\t\t}\n\t\tcase \"unknown\":\n\t\t\treturn undefined;\n\t}\n}\n\nfunction readCommandOutput(\n\tcommand: string,\n\targs: string[],\n\toptions: { requireSuccess?: boolean } = {},\n): string | undefined {\n\tconst result = spawnProcessSync(command, args, {\n\t\tencoding: \"utf-8\",\n\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t});\n\tif (result.status === 0) return result.stdout.trim() || undefined;\n\tif (options.requireSuccess) {\n\t\tconst reason = result.error?.message || result.stderr.trim() || `exit code ${result.status ?? \"unknown\"}`;\n\t\tthrow new Error(`Failed to run ${[command, ...args].join(\" \")}: ${reason}`);\n\t}\n\treturn undefined;\n}\n\nfunction getGlobalPackageRoots(method: InstallMethod, _packageName: string, npmCommand?: string[]): string[] {\n\tswitch (method) {\n\t\tcase \"npm\": {\n\t\t\tconst configured = !!npmCommand?.length;\n\t\t\tconst [command = \"npm\", ...npmArgs] = npmCommand ?? [];\n\t\t\tif (configured && command === \"bun\") {\n\t\t\t\tconst bunBin = readCommandOutput(command, [...npmArgs, \"pm\", \"bin\", \"-g\"], {\n\t\t\t\t\trequireSuccess: true,\n\t\t\t\t});\n\t\t\t\tconst roots = [join(homedir(), \".bun\", \"install\", \"global\", \"node_modules\")];\n\t\t\t\tif (bunBin) {\n\t\t\t\t\troots.push(join(dirname(bunBin), \"install\", \"global\", \"node_modules\"));\n\t\t\t\t}\n\t\t\t\treturn roots;\n\t\t\t}\n\t\t\tconst root = readCommandOutput(command, [...npmArgs, \"root\", \"-g\"], {\n\t\t\t\trequireSuccess: configured,\n\t\t\t});\n\t\t\tconst inferred = configured ? undefined : getInferredNpmInstall();\n\t\t\treturn [root, inferred?.root].filter((x): x is string => !!x);\n\t\t}\n\t\tcase \"pnpm\": {\n\t\t\tconst root = readCommandOutput(\"pnpm\", [\"root\", \"-g\"]);\n\t\t\treturn root ? [root, dirname(root)] : [];\n\t\t}\n\t\tcase \"yarn\": {\n\t\t\tconst dir = readCommandOutput(\"yarn\", [\"global\", \"dir\"]);\n\t\t\treturn dir ? [dir, join(dir, \"node_modules\")] : [];\n\t\t}\n\t\tcase \"bun\": {\n\t\t\tconst bunBin = readCommandOutput(\"bun\", [\"pm\", \"bin\", \"-g\"]);\n\t\t\tconst roots = [join(homedir(), \".bun\", \"install\", \"global\", \"node_modules\")];\n\t\t\tif (bunBin) {\n\t\t\t\troots.push(join(dirname(bunBin), \"install\", \"global\", \"node_modules\"));\n\t\t\t}\n\t\t\treturn roots;\n\t\t}\n\t\tcase \"bun-binary\":\n\t\tcase \"unknown\":\n\t\t\treturn [];\n\t}\n}\n\nfunction normalizeExistingPathForComparison(path: string, resolveSymlinks: boolean): string | undefined {\n\tconst resolvedPath = resolve(path);\n\tif (!existsSync(resolvedPath)) {\n\t\treturn undefined;\n\t}\n\tlet normalizedPath = resolvedPath;\n\tif (resolveSymlinks) {\n\t\ttry {\n\t\t\tnormalizedPath = realpathSync(resolvedPath);\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\tif (process.platform === \"win32\") {\n\t\tnormalizedPath = normalizedPath.toLowerCase();\n\t}\n\treturn normalizedPath;\n}\n\nfunction getPathComparisonCandidates(path: string): string[] {\n\treturn Array.from(\n\t\tnew Set(\n\t\t\t[normalizeExistingPathForComparison(path, false), normalizeExistingPathForComparison(path, true)].filter(\n\t\t\t\t(candidate): candidate is string => !!candidate,\n\t\t\t),\n\t\t),\n\t);\n}\n\nfunction getEntrypointPackageDir(): string | undefined {\n\tconst entrypoint = process.argv[1];\n\tif (!entrypoint) return undefined;\n\tlet dir = dirname(entrypoint);\n\twhile (dir !== dirname(dir)) {\n\t\tif (existsSync(join(dir, \"package.json\"))) {\n\t\t\treturn dir;\n\t\t}\n\t\tdir = dirname(dir);\n\t}\n\treturn undefined;\n}\n\nfunction isSelfUpdatePathWritable(): boolean {\n\tconst packageDir = getPackageDir();\n\ttry {\n\t\taccessSync(packageDir, constants.W_OK);\n\t\taccessSync(dirname(packageDir), constants.W_OK);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction isManagedByGlobalPackageManager(method: InstallMethod, packageName: string, npmCommand?: string[]): boolean {\n\tconst packageDirs = [getPackageDir(), getEntrypointPackageDir()].filter((dir): dir is string => !!dir);\n\tconst packageDirCandidates = packageDirs.flatMap((dir) => getPathComparisonCandidates(dir));\n\treturn getGlobalPackageRoots(method, packageName, npmCommand).some((root) => {\n\t\treturn getPathComparisonCandidates(root).some((normalizedRoot) => {\n\t\t\tconst rootPrefix = normalizedRoot.endsWith(sep) ? normalizedRoot : `${normalizedRoot}${sep}`;\n\t\t\treturn packageDirCandidates.some((packageDir) => packageDir.startsWith(rootPrefix));\n\t\t});\n\t});\n}\n\nexport function getSelfUpdateCommand(\n\tpackageName: string,\n\tnpmCommand?: string[],\n\tupdatePackageName = packageName,\n): SelfUpdateCommand | undefined {\n\tconst method = detectInstallMethod();\n\tconst command = getSelfUpdateCommandForMethod(method, packageName, updatePackageName, npmCommand);\n\tif (!command || !isManagedByGlobalPackageManager(method, packageName, npmCommand) || !isSelfUpdatePathWritable()) {\n\t\treturn undefined;\n\t}\n\treturn command;\n}\n\nexport function getSelfUpdateUnavailableInstruction(\n\tpackageName: string,\n\tnpmCommand?: string[],\n\tupdatePackageName = packageName,\n): string {\n\tconst method = detectInstallMethod();\n\tif (method === \"bun-binary\") {\n\t\treturn `Download from: ${PI_ADAPTATIVE_RELEASES_URL}`;\n\t}\n\tconst command = getSelfUpdateCommandForMethod(method, packageName, updatePackageName, npmCommand);\n\tif (command) {\n\t\tif (isManagedByGlobalPackageManager(method, packageName, npmCommand) && !isSelfUpdatePathWritable()) {\n\t\t\treturn `This installation is managed by a global ${method} install, but the install path is not writable. Update it yourself with: ${command.display}`;\n\t\t}\n\t\treturn `This installation is not managed by a global ${method} install. Update it with the package manager, wrapper, or source checkout that provides it.`;\n\t}\n\treturn `Update ${updatePackageName} using the package manager, wrapper, or source checkout that provides this installation.`;\n}\n\nexport function getUpdateInstruction(packageName: string): string {\n\tconst method = detectInstallMethod();\n\tconst command = getSelfUpdateCommandForMethod(method, packageName);\n\tif (command) {\n\t\treturn `Run: ${command.display}`;\n\t}\n\treturn getSelfUpdateUnavailableInstruction(packageName);\n}\n\n// =============================================================================\n// Package Asset Paths (shipped with executable)\n// =============================================================================\n\n/**\n * Get the base directory for resolving package assets (themes, package.json, README.md, CHANGELOG.md).\n * - For Bun binary: returns the directory containing the executable\n * - For Node.js (dist/): returns __dirname (the dist/ directory)\n * - For tsx (src/): returns parent directory (the package root)\n */\nexport function getPackageDir(): string {\n\t// Allow override via environment variable (useful for Nix/Guix where store paths tokenize poorly)\n\tconst envDir = process.env.PI_PACKAGE_DIR;\n\tif (envDir) {\n\t\treturn normalizePath(envDir);\n\t}\n\n\tif (isBunBinary) {\n\t\t// Bun binary: process.execPath points to the compiled executable\n\t\treturn dirname(process.execPath);\n\t}\n\t// Node.js: walk up from __dirname until we find package.json\n\tlet dir = __dirname;\n\twhile (dir !== dirname(dir)) {\n\t\tif (existsSync(join(dir, \"package.json\"))) {\n\t\t\treturn dir;\n\t\t}\n\t\tdir = dirname(dir);\n\t}\n\t// Fallback (shouldn't happen)\n\treturn __dirname;\n}\n\n/**\n * Get path to built-in themes directory (shipped with package)\n * - For Bun binary: theme/ next to executable\n * - For Node.js (dist/): dist/modes/interactive/theme/\n * - For tsx (src/): src/modes/interactive/theme/\n */\nexport function getThemesDir(): string {\n\tif (isBunBinary) {\n\t\treturn join(getPackageDir(), \"theme\");\n\t}\n\t// Theme is in modes/interactive/theme/ relative to src/ or dist/\n\tconst packageDir = getPackageDir();\n\tconst srcOrDist = existsSync(join(packageDir, \"src\")) ? \"src\" : \"dist\";\n\treturn join(packageDir, srcOrDist, \"modes\", \"interactive\", \"theme\");\n}\n\n/**\n * Get path to HTML export template directory (shipped with package)\n * - For Bun binary: export-html/ next to executable\n * - For Node.js (dist/): dist/core/export-html/\n * - For tsx (src/): src/core/export-html/\n */\nexport function getExportTemplateDir(): string {\n\tif (isBunBinary) {\n\t\treturn join(getPackageDir(), \"export-html\");\n\t}\n\tconst packageDir = getPackageDir();\n\tconst srcOrDist = existsSync(join(packageDir, \"src\")) ? \"src\" : \"dist\";\n\treturn join(packageDir, srcOrDist, \"core\", \"export-html\");\n}\n\n/** Get path to package.json */\nexport function getPackageJsonPath(): string {\n\treturn join(getPackageDir(), \"package.json\");\n}\n\n/** Get path to README.md */\nexport function getReadmePath(): string {\n\treturn resolve(join(getPackageDir(), \"README.md\"));\n}\n\n/** Get path to docs directory */\nexport function getDocsPath(): string {\n\treturn resolve(join(getPackageDir(), \"docs\"));\n}\n\n/** Get path to examples directory */\nexport function getExamplesPath(): string {\n\treturn resolve(join(getPackageDir(), \"examples\"));\n}\n\n/** Get path to CHANGELOG.md */\nexport function getChangelogPath(): string {\n\treturn resolve(join(getPackageDir(), \"CHANGELOG.md\"));\n}\n\n/**\n * Get path to built-in interactive assets directory.\n * - For Bun binary: assets/ next to executable\n * - For Node.js (dist/): dist/modes/interactive/assets/\n * - For tsx (src/): src/modes/interactive/assets/\n */\nexport function getInteractiveAssetsDir(): string {\n\tif (isBunBinary) {\n\t\treturn join(getPackageDir(), \"assets\");\n\t}\n\tconst packageDir = getPackageDir();\n\tconst srcOrDist = existsSync(join(packageDir, \"src\")) ? \"src\" : \"dist\";\n\treturn join(packageDir, srcOrDist, \"modes\", \"interactive\", \"assets\");\n}\n\n/** Get path to a bundled interactive asset */\nexport function getBundledInteractiveAssetPath(name: string): string {\n\treturn join(getInteractiveAssetsDir(), name);\n}\n\n/**\n * Get path to bundled resources directory (shipped with package).\n * - For Bun binary: bundled-resources/ next to executable\n * - For Node.js (dist/): dist/bundled-resources/\n * - For tsx (src/): src/bundled-resources/\n */\nexport function getBundledResourcesDir(): string {\n\tif (isBunBinary) {\n\t\treturn join(getPackageDir(), \"bundled-resources\");\n\t}\n\tconst packageDir = getPackageDir();\n\tconst srcOrDist = existsSync(join(packageDir, \"src\")) ? \"src\" : \"dist\";\n\treturn join(packageDir, srcOrDist, \"bundled-resources\");\n}\n\n/**\n * Get path to bundled skills directory.\n */\nexport function getBundledSkillsDir(): string {\n\treturn join(getBundledResourcesDir(), \"skills\");\n}\n\n/**\n * Get path to bundled prompts directory.\n */\nexport function getBundledPromptsDir(): string {\n\treturn join(getBundledResourcesDir(), \"prompts\");\n}\n\n// =============================================================================\n// App Config (from package.json piConfig)\n// =============================================================================\n\ninterface PackageJson {\n\tname?: string;\n\tversion?: string;\n\tpiConfig?: {\n\t\tname?: string;\n\t\tconfigDir?: string;\n\t};\n}\n\nlet pkg: PackageJson = {};\ntry {\n\tpkg = JSON.parse(readFileSync(getPackageJsonPath(), \"utf-8\")) as PackageJson;\n} catch (e: unknown) {\n\tconst err = e as NodeJS.ErrnoException;\n\tif (err.code !== \"ENOENT\") throw e;\n}\n\nconst piConfigName: string | undefined = pkg.piConfig?.name;\nexport const PACKAGE_NAME: string = pkg.name || \"@caupulican/pi-adaptative\";\nexport const APP_NAME: string = piConfigName || \"pi\";\nexport const APP_TITLE: string = piConfigName ? APP_NAME : \"π\";\nexport const CONFIG_DIR_NAME: string = pkg.piConfig?.configDir || \".pi\";\nexport const VERSION: string = pkg.version || \"0.0.0\";\n\n// e.g., PI_CODING_AGENT_DIR or TAU_CODING_AGENT_DIR\nexport const ENV_AGENT_DIR = `${APP_NAME.toUpperCase()}_CODING_AGENT_DIR`;\nexport const ENV_SESSION_DIR = `${APP_NAME.toUpperCase()}_CODING_AGENT_SESSION_DIR`;\n\nexport function expandTildePath(path: string): string {\n\treturn normalizePath(path);\n}\n\nconst DEFAULT_SHARE_VIEWER_URL = \"https://pi.dev/session/\";\n\n/** Get the share viewer URL for a gist ID */\nexport function getShareViewerUrl(gistId: string): string {\n\tconst baseUrl = process.env.PI_SHARE_VIEWER_URL || DEFAULT_SHARE_VIEWER_URL;\n\treturn `${baseUrl}#${gistId}`;\n}\n\n// =============================================================================\n// User Config Paths (~/.pi/agent/*)\n// =============================================================================\n\n/** Get the agent config directory (e.g., ~/.pi/agent/) */\nexport function getAgentDir(): string {\n\tconst envDir = process.env[ENV_AGENT_DIR];\n\tif (envDir) {\n\t\treturn expandTildePath(envDir);\n\t}\n\treturn join(homedir(), CONFIG_DIR_NAME, \"agent\");\n}\n\n/** Get path to user's custom themes directory */\nexport function getCustomThemesDir(): string {\n\treturn join(getAgentDir(), \"themes\");\n}\n\n/** Get path to models.json */\nexport function getModelsPath(): string {\n\treturn join(getAgentDir(), \"models.json\");\n}\n\n/** Get path to auth.json */\nexport function getAuthPath(): string {\n\treturn join(getAgentDir(), \"auth.json\");\n}\n\n/** Get path to settings.json */\nexport function getSettingsPath(): string {\n\treturn join(getAgentDir(), \"settings.json\");\n}\n\n/** Get path to tools directory */\nexport function getToolsDir(): string {\n\treturn join(getAgentDir(), \"tools\");\n}\n\n/** Get path to managed binaries directory (fd, rg) */\nexport function getBinDir(): string {\n\treturn join(getAgentDir(), \"bin\");\n}\n\n/** Get path to prompt templates directory */\nexport function getPromptsDir(): string {\n\treturn join(getAgentDir(), \"prompts\");\n}\n\n/** Get path to reusable profile definitions directory */\nexport function getProfilesDir(agentDir: string = getAgentDir()): string {\n\treturn join(agentDir, \"profiles\");\n}\n\n/** Get path to sessions directory */\nexport function getSessionsDir(): string {\n\treturn join(getAgentDir(), \"sessions\");\n}\n\n/** Get path to debug log file */\nexport function getDebugLogPath(): string {\n\treturn join(getAgentDir(), `${APP_NAME}-debug.log`);\n}\n"]}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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","sourcesContent":["import { accessSync, constants, existsSync, readFileSync, realpathSync } from \"fs\";\nimport { homedir } from \"os\";\nimport { basename, dirname, join, resolve, sep, win32 } from \"path\";\nimport { fileURLToPath } from \"url\";\nimport { spawnProcessSync } from \"./utils/child-process.ts\";\nimport { normalizePath } from \"./utils/paths.ts\";\n\n// =============================================================================\n// Package Detection\n// =============================================================================\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\nconst PI_ADAPTATIVE_RELEASES_URL = \"https://github.com/Caupulican/pi-adaptative/releases/latest\";\n\n/**\n * Detect if we're running as a Bun compiled binary.\n * Bun binaries have import.meta.url containing \"$bunfs\", \"~BUN\", or \"%7EBUN\" (Bun's virtual filesystem path)\n */\nexport const isBunBinary =\n\timport.meta.url.includes(\"$bunfs\") || import.meta.url.includes(\"~BUN\") || import.meta.url.includes(\"%7EBUN\");\n\n/** Detect if Bun is the runtime (compiled binary or bun run) */\nexport const isBunRuntime = !!process.versions.bun;\n\n// =============================================================================\n// Install Method Detection\n// =============================================================================\n\nexport type InstallMethod = \"bun-binary\" | \"npm\" | \"pnpm\" | \"yarn\" | \"bun\" | \"unknown\";\n\ninterface SelfUpdateCommandStep {\n\tcommand: string;\n\targs: string[];\n\tdisplay: string;\n}\n\nexport interface SelfUpdateCommand extends SelfUpdateCommandStep {\n\tsteps?: SelfUpdateCommandStep[];\n}\n\nfunction makeSelfUpdateCommand(\n\tinstallStep: SelfUpdateCommandStep,\n\tuninstallStep?: SelfUpdateCommandStep,\n): SelfUpdateCommand {\n\tif (!uninstallStep) return installStep;\n\treturn {\n\t\t...installStep,\n\t\tdisplay: `${uninstallStep.display} && ${installStep.display}`,\n\t\tsteps: [uninstallStep, installStep],\n\t};\n}\n\nfunction makeSelfUpdateCommandStep(command: string, args: string[]): SelfUpdateCommandStep {\n\treturn {\n\t\tcommand,\n\t\targs,\n\t\tdisplay: [command, ...args].map((arg) => (/\\s/.test(arg) ? `\"${arg}\"` : arg)).join(\" \"),\n\t};\n}\n\nexport function detectInstallMethod(): InstallMethod {\n\tif (isBunBinary) {\n\t\treturn \"bun-binary\";\n\t}\n\n\tconst resolvedPath = `${__dirname}\\0${process.execPath || \"\"}`.toLowerCase().replace(/\\\\/g, \"/\");\n\n\tif (resolvedPath.includes(\"/pnpm/\") || resolvedPath.includes(\"/.pnpm/\")) {\n\t\treturn \"pnpm\";\n\t}\n\tif (resolvedPath.includes(\"/yarn/\") || resolvedPath.includes(\"/.yarn/\")) {\n\t\treturn \"yarn\";\n\t}\n\tif (isBunRuntime || resolvedPath.includes(\"/install/global/node_modules/\")) {\n\t\treturn \"bun\";\n\t}\n\tif (resolvedPath.includes(\"/npm/\") || resolvedPath.includes(\"/node_modules/\")) {\n\t\treturn \"npm\";\n\t}\n\n\treturn \"unknown\";\n}\n\nfunction getInferredNpmInstall(): { root: string; prefix: string } | undefined {\n\tconst packageDir = getPackageDir();\n\tconst path = process.platform === \"win32\" || packageDir.includes(\"\\\\\") ? win32 : { basename, dirname };\n\tconst parent = path.dirname(packageDir);\n\tlet root: string | undefined;\n\tif (path.basename(parent).startsWith(\"@\") && path.basename(path.dirname(parent)) === \"node_modules\") {\n\t\troot = path.dirname(parent);\n\t} else if (path.basename(parent) === \"node_modules\") {\n\t\troot = parent;\n\t}\n\tif (!root) return undefined;\n\tconst rootParent = path.dirname(root);\n\tif (path.basename(rootParent) === \"lib\") return { root, prefix: path.dirname(rootParent) };\n\t// Windows global npm prefixes use `<prefix>\\\\node_modules`, which is\n\t// indistinguishable from local project installs by path shape alone. Do not\n\t// infer unsupported Windows custom prefixes without `npm root -g` evidence.\n\treturn undefined;\n}\n\nfunction getSelfUpdateCommandForMethod(\n\tmethod: InstallMethod,\n\tinstalledPackageName: string,\n\tupdatePackageName = installedPackageName,\n\tnpmCommand?: string[],\n): SelfUpdateCommand | undefined {\n\tswitch (method) {\n\t\tcase \"bun-binary\":\n\t\t\treturn undefined;\n\t\tcase \"pnpm\":\n\t\t\treturn makeSelfUpdateCommand(\n\t\t\t\tmakeSelfUpdateCommandStep(\"pnpm\", [\n\t\t\t\t\t\"install\",\n\t\t\t\t\t\"-g\",\n\t\t\t\t\t\"--ignore-scripts\",\n\t\t\t\t\t\"--config.minimumReleaseAge=0\",\n\t\t\t\t\tupdatePackageName,\n\t\t\t\t]),\n\t\t\t\tupdatePackageName === installedPackageName\n\t\t\t\t\t? undefined\n\t\t\t\t\t: makeSelfUpdateCommandStep(\"pnpm\", [\"remove\", \"-g\", installedPackageName]),\n\t\t\t);\n\t\tcase \"yarn\":\n\t\t\treturn makeSelfUpdateCommand(\n\t\t\t\tmakeSelfUpdateCommandStep(\"yarn\", [\"global\", \"add\", \"--ignore-scripts\", updatePackageName]),\n\t\t\t\tupdatePackageName === installedPackageName\n\t\t\t\t\t? undefined\n\t\t\t\t\t: makeSelfUpdateCommandStep(\"yarn\", [\"global\", \"remove\", installedPackageName]),\n\t\t\t);\n\t\tcase \"bun\":\n\t\t\treturn makeSelfUpdateCommand(\n\t\t\t\tmakeSelfUpdateCommandStep(\"bun\", [\n\t\t\t\t\t\"install\",\n\t\t\t\t\t\"-g\",\n\t\t\t\t\t\"--ignore-scripts\",\n\t\t\t\t\t\"--minimum-release-age=0\",\n\t\t\t\t\tupdatePackageName,\n\t\t\t\t]),\n\t\t\t\tupdatePackageName === installedPackageName\n\t\t\t\t\t? undefined\n\t\t\t\t\t: makeSelfUpdateCommandStep(\"bun\", [\"uninstall\", \"-g\", installedPackageName]),\n\t\t\t);\n\t\tcase \"npm\": {\n\t\t\tconst [command = \"npm\", ...npmArgs] = npmCommand ?? [];\n\t\t\tconst inferred = npmCommand?.length ? undefined : getInferredNpmInstall();\n\t\t\tconst prefixArgs = [...npmArgs, ...(inferred ? [\"--prefix\", inferred.prefix] : [])];\n\t\t\tconst installStep = makeSelfUpdateCommandStep(command, [\n\t\t\t\t...prefixArgs,\n\t\t\t\t\"install\",\n\t\t\t\t\"-g\",\n\t\t\t\t\"--ignore-scripts\",\n\t\t\t\t\"--min-release-age=0\",\n\t\t\t\tupdatePackageName,\n\t\t\t]);\n\t\t\tconst uninstallStep =\n\t\t\t\tupdatePackageName === installedPackageName\n\t\t\t\t\t? undefined\n\t\t\t\t\t: makeSelfUpdateCommandStep(command, [...prefixArgs, \"uninstall\", \"-g\", installedPackageName]);\n\t\t\treturn makeSelfUpdateCommand(installStep, uninstallStep);\n\t\t}\n\t\tcase \"unknown\":\n\t\t\treturn undefined;\n\t}\n}\n\nfunction readCommandOutput(\n\tcommand: string,\n\targs: string[],\n\toptions: { requireSuccess?: boolean } = {},\n): string | undefined {\n\tconst result = spawnProcessSync(command, args, {\n\t\tencoding: \"utf-8\",\n\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t});\n\tif (result.status === 0) return result.stdout.trim() || undefined;\n\tif (options.requireSuccess) {\n\t\tconst reason = result.error?.message || result.stderr.trim() || `exit code ${result.status ?? \"unknown\"}`;\n\t\tthrow new Error(`Failed to run ${[command, ...args].join(\" \")}: ${reason}`);\n\t}\n\treturn undefined;\n}\n\nfunction getGlobalPackageRoots(method: InstallMethod, _packageName: string, npmCommand?: string[]): string[] {\n\tswitch (method) {\n\t\tcase \"npm\": {\n\t\t\tconst configured = !!npmCommand?.length;\n\t\t\tconst [command = \"npm\", ...npmArgs] = npmCommand ?? [];\n\t\t\tif (configured && command === \"bun\") {\n\t\t\t\tconst bunBin = readCommandOutput(command, [...npmArgs, \"pm\", \"bin\", \"-g\"], {\n\t\t\t\t\trequireSuccess: true,\n\t\t\t\t});\n\t\t\t\tconst roots = [join(homedir(), \".bun\", \"install\", \"global\", \"node_modules\")];\n\t\t\t\tif (bunBin) {\n\t\t\t\t\troots.push(join(dirname(bunBin), \"install\", \"global\", \"node_modules\"));\n\t\t\t\t}\n\t\t\t\treturn roots;\n\t\t\t}\n\t\t\tconst root = readCommandOutput(command, [...npmArgs, \"root\", \"-g\"], {\n\t\t\t\trequireSuccess: configured,\n\t\t\t});\n\t\t\tconst inferred = configured ? undefined : getInferredNpmInstall();\n\t\t\treturn [root, inferred?.root].filter((x): x is string => !!x);\n\t\t}\n\t\tcase \"pnpm\": {\n\t\t\tconst root = readCommandOutput(\"pnpm\", [\"root\", \"-g\"]);\n\t\t\treturn root ? [root, dirname(root)] : [];\n\t\t}\n\t\tcase \"yarn\": {\n\t\t\tconst dir = readCommandOutput(\"yarn\", [\"global\", \"dir\"]);\n\t\t\treturn dir ? [dir, join(dir, \"node_modules\")] : [];\n\t\t}\n\t\tcase \"bun\": {\n\t\t\tconst bunBin = readCommandOutput(\"bun\", [\"pm\", \"bin\", \"-g\"]);\n\t\t\tconst roots = [join(homedir(), \".bun\", \"install\", \"global\", \"node_modules\")];\n\t\t\tif (bunBin) {\n\t\t\t\troots.push(join(dirname(bunBin), \"install\", \"global\", \"node_modules\"));\n\t\t\t}\n\t\t\treturn roots;\n\t\t}\n\t\tcase \"bun-binary\":\n\t\tcase \"unknown\":\n\t\t\treturn [];\n\t}\n}\n\nfunction normalizeExistingPathForComparison(path: string, resolveSymlinks: boolean): string | undefined {\n\tconst resolvedPath = resolve(path);\n\tif (!existsSync(resolvedPath)) {\n\t\treturn undefined;\n\t}\n\tlet normalizedPath = resolvedPath;\n\tif (resolveSymlinks) {\n\t\ttry {\n\t\t\tnormalizedPath = realpathSync(resolvedPath);\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\tif (process.platform === \"win32\") {\n\t\tnormalizedPath = normalizedPath.toLowerCase();\n\t}\n\treturn normalizedPath;\n}\n\nfunction getPathComparisonCandidates(path: string): string[] {\n\treturn Array.from(\n\t\tnew Set(\n\t\t\t[normalizeExistingPathForComparison(path, false), normalizeExistingPathForComparison(path, true)].filter(\n\t\t\t\t(candidate): candidate is string => !!candidate,\n\t\t\t),\n\t\t),\n\t);\n}\n\nfunction getEntrypointPackageDir(): string | undefined {\n\tconst entrypoint = process.argv[1];\n\tif (!entrypoint) return undefined;\n\tlet dir = dirname(entrypoint);\n\twhile (dir !== dirname(dir)) {\n\t\tif (existsSync(join(dir, \"package.json\"))) {\n\t\t\treturn dir;\n\t\t}\n\t\tdir = dirname(dir);\n\t}\n\treturn undefined;\n}\n\nfunction isSelfUpdatePathWritable(): boolean {\n\tconst packageDir = getPackageDir();\n\ttry {\n\t\taccessSync(packageDir, constants.W_OK);\n\t\taccessSync(dirname(packageDir), constants.W_OK);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction isManagedByGlobalPackageManager(method: InstallMethod, packageName: string, npmCommand?: string[]): boolean {\n\tconst packageDirs = [getPackageDir(), getEntrypointPackageDir()].filter((dir): dir is string => !!dir);\n\tconst packageDirCandidates = packageDirs.flatMap((dir) => getPathComparisonCandidates(dir));\n\treturn getGlobalPackageRoots(method, packageName, npmCommand).some((root) => {\n\t\treturn getPathComparisonCandidates(root).some((normalizedRoot) => {\n\t\t\tconst rootPrefix = normalizedRoot.endsWith(sep) ? normalizedRoot : `${normalizedRoot}${sep}`;\n\t\t\treturn packageDirCandidates.some((packageDir) => packageDir.startsWith(rootPrefix));\n\t\t});\n\t});\n}\n\nexport function getSelfUpdateCommand(\n\tpackageName: string,\n\tnpmCommand?: string[],\n\tupdatePackageName = packageName,\n): SelfUpdateCommand | undefined {\n\tconst method = detectInstallMethod();\n\tconst command = getSelfUpdateCommandForMethod(method, packageName, updatePackageName, npmCommand);\n\tif (!command || !isManagedByGlobalPackageManager(method, packageName, npmCommand) || !isSelfUpdatePathWritable()) {\n\t\treturn undefined;\n\t}\n\treturn command;\n}\n\nexport function getSelfUpdateUnavailableInstruction(\n\tpackageName: string,\n\tnpmCommand?: string[],\n\tupdatePackageName = packageName,\n): string {\n\tconst method = detectInstallMethod();\n\tif (method === \"bun-binary\") {\n\t\treturn `Download from: ${PI_ADAPTATIVE_RELEASES_URL}`;\n\t}\n\tconst command = getSelfUpdateCommandForMethod(method, packageName, updatePackageName, npmCommand);\n\tif (command) {\n\t\tif (isManagedByGlobalPackageManager(method, packageName, npmCommand) && !isSelfUpdatePathWritable()) {\n\t\t\treturn `This installation is managed by a global ${method} install, but the install path is not writable. Update it yourself with: ${command.display}`;\n\t\t}\n\t\treturn `This installation is not managed by a global ${method} install. Update it with the package manager, wrapper, or source checkout that provides it.`;\n\t}\n\treturn `Update ${updatePackageName} using the package manager, wrapper, or source checkout that provides this installation.`;\n}\n\nexport function getUpdateInstruction(packageName: string): string {\n\tconst method = detectInstallMethod();\n\tconst command = getSelfUpdateCommandForMethod(method, packageName);\n\tif (command) {\n\t\treturn `Run: ${command.display}`;\n\t}\n\treturn getSelfUpdateUnavailableInstruction(packageName);\n}\n\n// =============================================================================\n// Package Asset Paths (shipped with executable)\n// =============================================================================\n\n/**\n * Get the base directory for resolving package assets (themes, package.json, README.md, CHANGELOG.md).\n * - For Bun binary: returns the directory containing the executable\n * - For Node.js (dist/): returns __dirname (the dist/ directory)\n * - For tsx (src/): returns parent directory (the package root)\n */\nexport function getPackageDir(): string {\n\t// Allow override via environment variable (useful for Nix/Guix where store paths tokenize poorly)\n\tconst envDir = process.env.PI_PACKAGE_DIR;\n\tif (envDir) {\n\t\treturn normalizePath(envDir);\n\t}\n\n\tif (isBunBinary) {\n\t\t// Bun binary: process.execPath points to the compiled executable\n\t\treturn dirname(process.execPath);\n\t}\n\t// Node.js: walk up from __dirname until we find package.json\n\tlet dir = __dirname;\n\twhile (dir !== dirname(dir)) {\n\t\tif (existsSync(join(dir, \"package.json\"))) {\n\t\t\treturn dir;\n\t\t}\n\t\tdir = dirname(dir);\n\t}\n\t// Fallback (shouldn't happen)\n\treturn __dirname;\n}\n\n/**\n * Get path to built-in themes directory (shipped with package)\n * - For Bun binary: theme/ next to executable\n * - For Node.js (dist/): dist/modes/interactive/theme/\n * - For tsx (src/): src/modes/interactive/theme/\n */\nexport function getThemesDir(): string {\n\tif (isBunBinary) {\n\t\treturn join(getPackageDir(), \"theme\");\n\t}\n\t// Theme is in modes/interactive/theme/ relative to src/ or dist/\n\tconst packageDir = getPackageDir();\n\tconst srcOrDist = existsSync(join(packageDir, \"src\")) ? \"src\" : \"dist\";\n\treturn join(packageDir, srcOrDist, \"modes\", \"interactive\", \"theme\");\n}\n\n/**\n * Get path to HTML export template directory (shipped with package)\n * - For Bun binary: export-html/ next to executable\n * - For Node.js (dist/): dist/core/export-html/\n * - For tsx (src/): src/core/export-html/\n */\nexport function getExportTemplateDir(): string {\n\tif (isBunBinary) {\n\t\treturn join(getPackageDir(), \"export-html\");\n\t}\n\tconst packageDir = getPackageDir();\n\tconst srcOrDist = existsSync(join(packageDir, \"src\")) ? \"src\" : \"dist\";\n\treturn join(packageDir, srcOrDist, \"core\", \"export-html\");\n}\n\n/** Get path to package.json */\nexport function getPackageJsonPath(): string {\n\treturn join(getPackageDir(), \"package.json\");\n}\n\n/** Get path to README.md */\nexport function getReadmePath(): string {\n\treturn resolve(join(getPackageDir(), \"README.md\"));\n}\n\n/** Get path to docs directory */\nexport function getDocsPath(): string {\n\treturn resolve(join(getPackageDir(), \"docs\"));\n}\n\n/** Get path to examples directory */\nexport function getExamplesPath(): string {\n\treturn resolve(join(getPackageDir(), \"examples\"));\n}\n\n/** Get path to CHANGELOG.md */\nexport function getChangelogPath(): string {\n\treturn resolve(join(getPackageDir(), \"CHANGELOG.md\"));\n}\n\n/**\n * Get path to built-in interactive assets directory.\n * - For Bun binary: assets/ next to executable\n * - For Node.js (dist/): dist/modes/interactive/assets/\n * - For tsx (src/): src/modes/interactive/assets/\n */\nexport function getInteractiveAssetsDir(): string {\n\tif (isBunBinary) {\n\t\treturn join(getPackageDir(), \"assets\");\n\t}\n\tconst packageDir = getPackageDir();\n\tconst srcOrDist = existsSync(join(packageDir, \"src\")) ? \"src\" : \"dist\";\n\treturn join(packageDir, srcOrDist, \"modes\", \"interactive\", \"assets\");\n}\n\n/** Get path to a bundled interactive asset */\nexport function getBundledInteractiveAssetPath(name: string): string {\n\treturn join(getInteractiveAssetsDir(), name);\n}\n\n/**\n * Get path to bundled resources directory (shipped with package).\n * - For Bun binary: bundled-resources/ next to executable\n * - For Node.js (dist/): dist/bundled-resources/\n * - For tsx (src/): src/bundled-resources/\n */\nexport function getBundledResourcesDir(): string {\n\tif (isBunBinary) {\n\t\treturn join(getPackageDir(), \"bundled-resources\");\n\t}\n\tconst packageDir = getPackageDir();\n\tconst srcOrDist = existsSync(join(packageDir, \"src\")) ? \"src\" : \"dist\";\n\treturn join(packageDir, srcOrDist, \"bundled-resources\");\n}\n\n/**\n * Get path to bundled skills directory.\n */\nexport function getBundledSkillsDir(): string {\n\treturn join(getBundledResourcesDir(), \"skills\");\n}\n\n/**\n * Get path to bundled prompts directory.\n */\nexport function getBundledPromptsDir(): string {\n\treturn join(getBundledResourcesDir(), \"prompts\");\n}\n\n// =============================================================================\n// App Config (from package.json piConfig)\n// =============================================================================\n\ninterface PackageJson {\n\tname?: string;\n\tversion?: string;\n\tpiConfig?: {\n\t\tname?: string;\n\t\tconfigDir?: string;\n\t};\n}\n\nlet pkg: PackageJson = {};\ntry {\n\tpkg = JSON.parse(readFileSync(getPackageJsonPath(), \"utf-8\")) as PackageJson;\n} catch (e: unknown) {\n\tconst err = e as NodeJS.ErrnoException;\n\tif (err.code !== \"ENOENT\") throw e;\n}\n\nconst piConfigName: string | undefined = pkg.piConfig?.name;\nexport const PACKAGE_NAME: string = pkg.name || \"@caupulican/pi-adaptative\";\nexport const APP_NAME: string = piConfigName || \"pi\";\nexport const APP_TITLE: string = piConfigName ? APP_NAME : \"π\";\nexport const CONFIG_DIR_NAME: string = pkg.piConfig?.configDir || \".pi\";\nexport const VERSION: string = pkg.version || \"0.0.0\";\n\n/**\n * Build a POSIX-valid environment-variable name from an app name and a suffix.\n *\n * APP_NAME comes from `piConfig.name`, which may contain characters that are invalid in a shell\n * env-var name — notably the hyphen in \"pi-adaptative\". A hyphenated name cannot be exported from\n * a shell (`export PI-ADAPTATIVE_CODING_AGENT_DIR=…` is a parse error), which silently made the\n * documented config-dir override unusable. Uppercase, collapse every character outside [A-Z0-9_]\n * to \"_\", and prefix \"_\" if the result would start with a digit (names may not begin with one).\n * e.g. \"pi\" -> PI_CODING_AGENT_DIR, \"pi-adaptative\" -> PI_ADAPTATIVE_CODING_AGENT_DIR.\n */\nexport function toEnvVarName(appName: string, suffix: string): string {\n\tconst prefix = appName.toUpperCase().replace(/[^A-Z0-9_]/g, \"_\");\n\tconst safePrefix = /^[0-9]/.test(prefix) ? `_${prefix}` : prefix;\n\treturn `${safePrefix}_${suffix}`;\n}\n\nexport const ENV_AGENT_DIR = toEnvVarName(APP_NAME, \"CODING_AGENT_DIR\");\nexport const ENV_SESSION_DIR = toEnvVarName(APP_NAME, \"CODING_AGENT_SESSION_DIR\");\n\nexport function expandTildePath(path: string): string {\n\treturn normalizePath(path);\n}\n\nconst DEFAULT_SHARE_VIEWER_URL = \"https://pi.dev/session/\";\n\n/** Get the share viewer URL for a gist ID */\nexport function getShareViewerUrl(gistId: string): string {\n\tconst baseUrl = process.env.PI_SHARE_VIEWER_URL || DEFAULT_SHARE_VIEWER_URL;\n\treturn `${baseUrl}#${gistId}`;\n}\n\n// =============================================================================\n// User Config Paths (~/.pi/agent/*)\n// =============================================================================\n\n/** Get the agent config directory (e.g., ~/.pi/agent/) */\nexport function getAgentDir(): string {\n\tconst envDir = process.env[ENV_AGENT_DIR];\n\tif (envDir) {\n\t\treturn expandTildePath(envDir);\n\t}\n\treturn join(homedir(), CONFIG_DIR_NAME, \"agent\");\n}\n\n/** Get path to user's custom themes directory */\nexport function getCustomThemesDir(): string {\n\treturn join(getAgentDir(), \"themes\");\n}\n\n/** Get path to models.json */\nexport function getModelsPath(): string {\n\treturn join(getAgentDir(), \"models.json\");\n}\n\n/** Get path to auth.json */\nexport function getAuthPath(): string {\n\treturn join(getAgentDir(), \"auth.json\");\n}\n\n/** Get path to settings.json */\nexport function getSettingsPath(): string {\n\treturn join(getAgentDir(), \"settings.json\");\n}\n\n/** Get path to tools directory */\nexport function getToolsDir(): string {\n\treturn join(getAgentDir(), \"tools\");\n}\n\n/** Get path to managed binaries directory (fd, rg) */\nexport function getBinDir(): string {\n\treturn join(getAgentDir(), \"bin\");\n}\n\n/** Get path to prompt templates directory */\nexport function getPromptsDir(): string {\n\treturn join(getAgentDir(), \"prompts\");\n}\n\n/** Get path to reusable profile definitions directory */\nexport function getProfilesDir(agentDir: string = getAgentDir()): string {\n\treturn join(agentDir, \"profiles\");\n}\n\n/** Get path to sessions directory */\nexport function getSessionsDir(): string {\n\treturn join(getAgentDir(), \"sessions\");\n}\n\n/** Get path to debug log file */\nexport function getDebugLogPath(): string {\n\treturn join(getAgentDir(), `${APP_NAME}-debug.log`);\n}\n"]}

package/dist/config.js

@@ -401,9 +401,23 @@ export const APP_NAME = piConfigName || "pi";
 export const APP_TITLE = piConfigName ? APP_NAME : "π";
 export const CONFIG_DIR_NAME = pkg.piConfig?.configDir || ".pi";
 export const VERSION = pkg.version || "0.0.0";
-// e.g., PI_CODING_AGENT_DIR or TAU_CODING_AGENT_DIR
-export const ENV_AGENT_DIR = `${APP_NAME.toUpperCase()}_CODING_AGENT_DIR`;
-export const ENV_SESSION_DIR = `${APP_NAME.toUpperCase()}_CODING_AGENT_SESSION_DIR`;
+/**
+ * Build a POSIX-valid environment-variable name from an app name and a suffix.
+ *
+ * APP_NAME comes from `piConfig.name`, which may contain characters that are invalid in a shell
+ * env-var name — notably the hyphen in "pi-adaptative". A hyphenated name cannot be exported from
+ * a shell (`export PI-ADAPTATIVE_CODING_AGENT_DIR=…` is a parse error), which silently made the
+ * documented config-dir override unusable. Uppercase, collapse every character outside [A-Z0-9_]
+ * to "_", and prefix "_" if the result would start with a digit (names may not begin with one).
+ * e.g. "pi" -> PI_CODING_AGENT_DIR, "pi-adaptative" -> PI_ADAPTATIVE_CODING_AGENT_DIR.
+ */
+export function toEnvVarName(appName, suffix) {
+    const prefix = appName.toUpperCase().replace(/[^A-Z0-9_]/g, "_");
+    const safePrefix = /^[0-9]/.test(prefix) ? `_${prefix}` : prefix;
+    return `${safePrefix}_${suffix}`;
+}
+export const ENV_AGENT_DIR = toEnvVarName(APP_NAME, "CODING_AGENT_DIR");
+export const ENV_SESSION_DIR = toEnvVarName(APP_NAME, "CODING_AGENT_SESSION_DIR");
 export function expandTildePath(path) {
     return normalizePath(path);
 }