@felan-ai/felan 0.12.11 → 0.13.0

package/README.md

@@ -7,380 +7,96 @@ Pi's interactive TUI.
 npx @felan-ai/felan
 ```
 
-The package exposes the `felan` binary. It stores model credentials, settings,
-sessions, agents, and runtime state under `~/.felan` by default; set
-`FELAN_AGENT_DIR` to select another directory. Use `/login` inside the TUI to
-configure provider-owned model credentials without a Felan account. Felan reads
-global settings from `~/.felan/settings.json` and does not load Pi project
-settings. Pi project trust does not apply to Felan's fixed resource policy, so
-Felan starts without a project trust prompt.
+The package exposes the `felan` binary. It owns local credentials, settings,
+session and agent storage paths, built-in extension selection, dependency
+onboarding, lifecycle, and TUI presentation. Portable feature behavior remains
+in the `@felan-ai/ext-*` packages.
 
-Local memory is enabled by default and works without a Felan account or cloud
-connection. It consolidates settled root-session evidence into an inspectable
-Markdown wiki. The canonical project store is outside the customer repository:
+> [!IMPORTANT]
+> The local host uses the current user's filesystem and process permissions. It
+> is not a sandbox.
 
-```text
-$FELAN_AGENT_DIR/memory/v1/projects/<project-hash>/
-  state.json
-  current/summary.md
-  current/index.md
-  current/pages/...
-```
-
-The project hash is derived from the canonical Git root, or the canonical cwd
-when no repository exists. Root-session storage receives a non-authoritative
-copy at `storage/sessions/<root-id>/.memory`; child sessions can read that copy
-but ordinary edits never publish it. Felan does not create `<repository>/.memory`
-and does not synchronize local memory with cloud team memory.
-Each session receives one hidden persisted memory-context entry at startup;
-provider calls reuse it, and compaction or tree navigation restores it only if
-it is no longer on the active branch. That entry is excluded from memory
-evidence processing. Once it loads successfully, the welcome screen's
-`[Context]` section lists the projected `.memory/summary.md` path alongside
-project instructions so the loaded summary can be opened directly. The summary
-is orientation only: substantive memory-backed answers should follow the
-projected absolute `index.md` links to relevant pages and cite page paths and
-their `Sources` session IDs.
-
-Use `/memory status`, `/memory run`, `/memory enable`, `/memory disable`, or
-`/memory open` to inspect and control local processing. A missing local model
-credential never prevents startup or recall of existing memory; processing
-remains pending until a configured model is available. Processing is idle
-batched while Felan runs and catches up on the next launch after shutdown. The
-enable/disable commands persist `felanTui.memoryProcessing` and do not remove
-the memory recall extension.
-
-After checkpoints are recorded, the TUI coordinator owns idle batching,
-startup recovery, retries, and shutdown cancellation. Each batch runs one
-disposable headless Pi memory-dreamer session against staging. It reads the
-immutable `.dreaming/input` manifest and transcripts, edits staged `.memory`
-files in place, and returns only a concise completion summary. The worker has
-no normal Felan extensions, skills, repository context, credentials, or
-process execution; its active tools are limited to `read`, `ls`, `edit`, and
-`write`. The worker has no separate turn, tool-call, or per-file I/O budgets;
-the only execution failsafe is a one-hour wall-clock timeout. The coordinator
-validates and publishes the staged filesystem output, so model, validation,
-cancellation, timeout, or publication failures leave evidence pending for
-retry. The worker uses the active root-session model when it is authenticated;
-if that model is unavailable, it falls back to another authenticated available
-model. With no authenticated model, evidence remains pending. The portable
-`@felan-ai/ext-memory` extension only recalls memory and records root
-checkpoints; it does not schedule dreaming.
-
-Evidence ingestion is separate from the worker's file-tool policy. The host
-opens each checkpoint's append-only JSONL session with a bounded snapshot and
-streams only the visible active-branch delta; abandoned branches, hidden
-memory-context entries, and unrelated large tool output are not staged. Source
-files may be much larger than the evidence sent to the model. After redaction,
-each staged transcript is capped at 256 KiB. A changed, missing, or malformed
-checkpoint source remains pending without blocking valid checkpoints in the
-same batch; it is retried by `/memory run`, a newer cursor, or a later launch.
-The dreamer updates affected pages and cross-links, preserves valid historical
-source entries, marks superseded or conflicting claims, and performs a bounded
-semantic maintenance pass before publication. Root-index links in each session
-projection are rebased to that projection's absolute `.memory` path; canonical
-memory remains unchanged.
-
-Felan suppresses Pi's version notification, bundled changelog, package update
-notifications, and install/update telemetry. Update behavior is owned by the
-Felan application.
-
-Each session uses a `HostAgentRuntime` with host path access. Its cwd resolves
-relative paths, while file operations and process working directories can use
-any path available to the current user. Pi's session runtime recreates the host
-runtime, filtered settings, resources, and session composition for new, resume,
-fork, clone, and import flows, then rebinds the active interactive UI. Host mode
-is not an isolation boundary.
-
-Root sessions store extension state under
-`$FELAN_AGENT_DIR/storage/sessions/<encoded-root-session-id>`. Every nested
-subagent shares its root session's storage path. Longer-retention agent state
-uses `$FELAN_AGENT_DIR/storage/agent`. Storage handles remain scoped to their
-declared roots, while ordinary runtime file operations can access these and
-other host paths directly.
-
-Only source-controlled built-in Felan extensions can be imported. External
-packages, extensions, configured skill paths, prompts, themes, and Pi context
-files remain filtered. Agent Core separately loads one instruction file from
-the session cwd, preferring `AGENTS.md` over `CLAUDE.md`. Agent Skills are
-loaded from `~/.agents/skills` and `<workspace>/.agents/skills` and are shared
-with local subagents.
-The built-in powerline reads `~/.felan/powerline.json` (or
-`$FELAN_AGENT_DIR/powerline.json`) once when it initializes. Its subscription
-segment obtains the active Codex or Claude OAuth token through Felan's
-`ModelRuntime` and requests usage from that provider's fixed endpoint.
-
-All built-in extensions are enabled by default. Toggle them in
-`~/.felan/settings.json`:
-
-```json
-{
-  "builtinExtensions": {
-    "subagents": true,
-    "askUser": true,
-    "tasks": true,
-    "prewalk": true,
-    "context": true,
-    "markitdown": true,
-    "mcp": true,
-    "webAccess": true,
-    "browser": true,
-    "backgroundBash": true,
-    "codex": true,
-    "rtkOptimizer": true,
-    "memory": true,
-    "powerline": false,
-    "outputStyle": true
-  }
-}
-```
-
-The built-in output-style extension adds a bounded `## Output Style` section
-to the system prompt for root and child sessions. Select its instructions with
-the global `outputStyle` setting:
-
-```json
-{
-  "outputStyle": "explanatory"
-}
-```
-
-Supported values are `concise` and `explanatory`. `concise` is the default.
-Invalid values stop session construction with a settings error. Styles are
-built into Felan; this setting cannot load prompt text or ambient files. The
-selection is captured when a session runtime is created, so restart Felan after
-changing it.
-
-On the first interactive startup with a missing external runtime dependency,
-Felan opens a dependency wizard before the first prompt. MarkItDown can be
-installed into Felan's managed Python environment or disabled. RTK can be
-installed with its pinned official installer or skipped while its
-binary-independent output compaction remains active. Background Bash is
-disabled when required POSIX process utilities are unavailable. The reviewed
-`agent-browser` CLI can be installed into Felan's managed agent storage or the
-Browser extension can be disabled. Choices are stored in global settings,
-never prompt in non-interactive sessions, and can be revisited with
-`/dependencies`. Install actions always require explicit confirmation.
-
-The local transcript groups adjacent tool calls by default, with one concise
-action row per call beneath each group title. Press `Ctrl+O` to show bounded
-result previews. Use `/tools` or `Alt+T` to inspect the complete arguments and
-result for one root-session call. Selected subagent transcripts use the same
-grouped or full tool rendering and `Ctrl+O` previews. Subagent completion
-notices stay on one summary line by default; `Ctrl+O` shows a bounded preview
-and `Alt+A` opens full agent details. Grouped reads from projected or canonical
-local memory appear as `Memory Recall`; conservative read-only Codex commands
-receive the same label without hiding mutating or arbitrary shell commands.
-To restore Pi's original ungrouped rendering, set:
-
-```json
-{
-  "felanTui": {
-    "toolDisplay": "full"
-  }
-}
-```
-
-Supported values are `grouped` and `full`; `grouped` is the default.
-
-`askUser` provides the sequential `ask_user` tool. The local host presents
-single questions or 1-4 question wizards as searchable overlays or inline
-dialogs, with multi-select, freeform answers, and optional comments.
+## Requirements and quick start
 
-`mcp` provides one OAuth-only remote MCP gateway. It merges
-`$FELAN_AGENT_DIR/mcp.json` with `<cwd>/.mcp.json`; the project file has higher
-precedence for same-name servers. It does not discover `.pi/mcp.json`, Cursor,
-Claude, Codex, or other ambient host configuration. A minimal Felan-owned
-config is:
+Felan supports Node.js 22.19.0 or newer. Repository development and CI use
+Node.js 22.20.0 with pnpm 9.15.5.
 
-```json
-{
-  "mcpServers": {
-    "notion": {
-      "url": "https://mcp.notion.com/mcp",
-      "auth": "oauth"
-    }
-  }
-}
+```sh
+felan
+/login
 ```
 
-Servers in the Felan-owned file must explicitly use `auth: "oauth"`. Standard
-project entries with `type: "http"` and a URL may omit `auth`; Felan treats
-those entries as OAuth. The initial port supports remote HTTP MCP servers
-through Streamable HTTP with classified SSE fallback. Unsupported project
-entries such as stdio, sockets, bearer tokens, and custom headers are skipped
-with a warning rather than executed. Direct tools and MCP Apps are not loaded.
-Optional per-server `oauth` fields are `clientId`, `clientSecret`,
-`clientSecretEnv`, `scope`, `redirectUri`, `clientName`, `clientUri`, and
-`authorizationParams`. Dynamic client registration is used when no client ID
-is configured. A client secret or `clientSecretEnv` requires `clientId`;
-prefer the environment reference over storing a client secret in the file.
-The default callback is `http://127.0.0.1:3118/callback`; set `redirectUri` to
-the exact pre-registered loopback callback when using a configured client.
-
-Run `/mcp` to inspect configured servers, list tools, reconnect, authenticate,
-or log out. `/mcp auth [server]` opens a server picker when its argument is
-omitted. Configuration is loaded at startup;
-run `/reload` after editing either file. The model uses the `mcp` gateway tool
-for status, explicit reconnects, search, describe, and remote tool calls. A
-`disconnected` status only means that the current session has no live transport;
-model discovery and call actions reconnect lazily with stored credentials. The
-local host follows the upstream adapter's browser + PKCE loopback flow and
-stores tokens and dynamic-client
-credentials in the OS credential store, bound to the Felan agent directory,
-server name, server URL, OAuth client/redirect/scope profile, and
-authorization-server issuer. It fails closed when that store is unavailable.
-Print-mode subagents never open a browser or callback listener; they can reuse
-credentials established by a root TUI session. MCP metadata and results are
-bounded and explicitly marked as untrusted remote content.
-
-`tasks` provides `TaskCreate`, `TaskUpdate`, `TaskList`, and `TaskGet` over one
-dependency-aware graph shared by the root session and every nested subagent.
-Task state lives under
-`$FELAN_AGENT_DIR/storage/sessions/<encoded-root-session-id>/tasks`. Use `/tasks`
-or `Ctrl+Shift+T` to inspect list, detail, and graph views.
-
-`webAccess` provides bounded web search, source verification, readable URL
-fetching, and stored-content retrieval. Search supports OpenAI/Codex, Exa,
-Brave, and self-hosted SearXNG. Configure providers in
-`$FELAN_AGENT_DIR/web-search.json`. Model-facing web content is explicitly
-encoded as untrusted external data; private and reserved network targets are
-blocked by default.
-
-`browser` registers one browser tool backed by the reviewed `agent-browser`
-CLI. Ask the tool for the version-matched `core` or specialized skill before
-browser actions, then pass literal CLI arguments for navigation, snapshots,
-interactions, and screenshots. Bare screenshots are attached directly when the
-selected model accepts image input; browser pages, skill text, and CLI output
-remain untrusted data.
-
-`markitdown` extends ordinary `read` calls for DOC/DOCX, PPT/PPTX, XLS/XLSX,
-RTF, EPUB, and Outlook MSG files. It intentionally leaves PDFs, images, audio,
-and generic archives to their existing or explicit workflows. Input,
-conversion time, and output are
-bounded; a content-hash Markdown cache preserves normal offset/limit reads, and
-every result marks extracted document text as untrusted. The extension never
-downloads Python packages automatically. Run `/markitdown` for status or
-`/markitdown install` to explicitly install the managed converter. If the
-converter is absent, conversion interception remains disabled.
-
-`backgroundBash` augments `bash` with detached processes for models outside the
-`openai` and `openai-codex` providers. Logs and process metadata live under
-`$FELAN_AGENT_DIR/storage/sessions/<encoded-root-session-id>/background-bash/<workspace-key>/jobs`.
-Use `/background-bash` or `Ctrl+Shift+J` to inspect them. Required POSIX process
-utilities are probed through the active runtime; the tools remain inactive on
-incompatible runtimes.
-
-`codex` activates `exec_command`, `write_stdin`, `apply_patch`, and
-`view_image` for GPT models on the exact `openai` and `openai-codex` providers.
-`view_image` is included only for models with image input. It restores the
-ordinary coding tools when another model is selected. Root and nested sessions
-load the same optional request controls from `$FELAN_AGENT_DIR/codex.json`; see
-the extension package README for the three supported fields.
-
-`rtkOptimizer` delegates command rewrites to a managed or `PATH` `rtk`
-executable available in the active runtime and compacts noisy command, read,
-and grep results. It
-supports both ordinary `bash` calls and Codex `exec_command` / `write_stdin`
-calls; Codex result envelopes remain intact while only their `Output:` payloads
-are compacted. Configuration is shared by root and nested sessions at
-`$FELAN_AGENT_DIR/storage/agent/rtk-optimizer/config.json`. Use `/rtk` for
-interactive settings, runtime verification, explicit installation, and session
-savings metrics. Missing RTK bypasses rewriting without disabling output
-compaction.
-
-## System prompt append
-
-The TUI reads one optional `$FELAN_AGENT_DIR/APPEND_SYSTEM.md` file when each
-session is constructed (`~/.felan/APPEND_SYSTEM.md` by default). Missing and
-blank files add nothing; other read failures stop session construction with the
-filesystem error. The file extends Agent Core's Felan prompt after enabled
-extension capabilities.
-
-Agent Core also reads at most one instruction file from each session's cwd
-through the active `AgentRuntime`, with `AGENTS.md` taking precedence over
-`CLAUDE.md`. Missing, unreadable, and blank instruction files are nonfatal.
-Child persona instructions follow the application append, root project
-instructions follow those consumer appends using Pi's path-labeled context-file
-format, and explicit Agent Skills and the current working directory are added
-last. The progressive-context extension remains responsible only for instruction
-files below the session cwd.
+Run an initial prompt or continue the most recent session for the current
+directory:
 
-System prompt inputs are limited to Agent Core, enabled capabilities, the
-single application append above, the selected cwd instruction file, explicit
-Agent Skills, and the current working directory. Pi `SYSTEM.md`, project
-`APPEND_SYSTEM.md`, and other Pi-discovered prompt/context files stay outside
-local composition.
-
-When enabled, `@felan-ai/ext-subagents` uses the session-bound local host and
-provides `Agent`, `list_subagents`,
-`get_subagent_result`, `steer_subagent`, and `cancel_subagent`. A root-scoped
-local host queues every run asynchronously, persists the latest child session
-metadata, delivers completion notices, supports bounded nesting, and uses the
-application's current workspace. The TUI shows each queued or running direct
-child in a full-width interactive rail beneath the powerline status rows, or
-beneath the editor when powerline is disabled. Press Down at the editor's newest
-prompt to enter the rail, use Up/Down to select a child, press Up on the first
-child to return to the editor, and press Enter to open that child in the agent
-navigator. Each child row and the selected-child header show the resolved
-provider/model when available. Use `/agents` or `Alt+A` to open the navigator
-directly, follow live transcripts with the same tool presentation as the main
-agent, send steering messages, or stop active work.
-Runtime shutdown awaits active-child cancellation before Pi teardown.
-Completed-child continuation uses the same child ID and Pi session file while
-replacing the latest result. The default list also
-includes `@felan-ai/ext-powerline` for an ANSI-aware footer with subscription
-usage; it is a direct TUI dependency and is not part of cloud composition.
-
-Local agent definitions are loaded only from bundled Felan definitions,
-`~/.agents/agents/*.md`, `~/.felan/agents/*.md` (or
-`$FELAN_AGENT_DIR/agents/*.md`), `<workspace>/.agents/agents/*.md`, and
-`<workspace>/.felan/agents/*.md`. Project definitions override user and
-bundled definitions; within one scope the Felan-specific directory overrides
-the shared `.agents` directory. Pi ambient agent discovery remains disabled.
-
-The bundled definitions have role-specific model settings: `general` inherits the
-parent model and thinking for implementation or investigation, `explore` uses the
-`low` model tier with thinking `off` for cheap read-only exploration, and `reviewer`
-inherits the parent model and thinking for quality-sensitive review. A definition's
-`model` and `thinking` settings take precedence over `Agent` arguments. When a
-definition omits either setting, the corresponding argument is used; if both omit
-it, the parent setting is inherited. A custom definition with id `explore` replaces
-the bundled definition and can choose its own settings.
-
-Each definition is a Markdown file with flat `key: value` frontmatter and a
-required prompt body. `description` is required; `id` defaults to the filename.
-Optional fields are `model`, `thinking`, `max_turns`, `timeout_seconds`, and
-`allow_nesting`. Definitions do not change tool access: custom children receive
-the normal enabled Felan tools.
-
-```md
----
-description: Review changes for correctness and regressions
-model: high
-thinking: high
-max_turns: 20
-timeout_seconds: 600
-allow_nesting: false
----
-
-Review the requested changes and report findings with file and line references.
+```sh
+felan "inspect this project"
+felan --continue
 ```
 
-Local subagent concurrency defaults to four and depth defaults to three; set
-`felanSubagents.concurrency` and `felanSubagents.maxDepth` in the Felan settings
-file to configure those bounded values.
-
-Local model selectors are deterministic and support explicit inheritance or an
-exact authenticated `provider/model`; exact selectors never fall back. Requested
-thinking levels are checked against that resolved model and unsupported levels
-return `unsupported_thinking` instead of being silently clamped.
+## CLI
 
-```sh
-felan --diagnostics
+```text
+felan [options] [message]
+
+-c, --continue     Continue the most recent session for this directory
+--diagnostics      Print runtime versions and configuration mode
+update             Update a global npm installation of Felan
+-h, --help         Show help
+-v, --version      Print the Felan version
+--verbose          Show verbose startup details
 ```
 
-Diagnostics include the Felan, Agent Core, Pi, and Node.js versions.
+Run `felan update` to check the stable npm release. It updates only a verified
+global npm installation, reports when the installation is current, and tells
+you to restart after a successful update. `npx`, local/source, and other
+package-manager installations are not changed; update those with the command
+that installed them.
+
+Invocations that start or continue an agent session launch the interactive TUI.
+`felan update` and informational flags exit without starting a session. Internal
+headless modes used by subagents and extension adapters are not public CLI entry
+points.
+
+`felan --diagnostics` reports Felan, Agent Core, Pi, and Node.js versions plus
+runtime and credential modes.
+
+## Local state and policy
+
+The default agent directory is `~/.felan`; set `FELAN_AGENT_DIR` to change it.
+It contains local credentials, settings, sessions, agents, extension storage,
+and project memory. Root-session storage is scoped under
+`$FELAN_AGENT_DIR/storage/sessions/<encoded-root-session-id>` and longer-lived
+extension state under `$FELAN_AGENT_DIR/storage/agent`.
+
+The local host loads only source-controlled Felan built-ins, Felan-owned
+settings and prompt appends, explicit Felan agents and Agent Skills, and the
+Agent Core-selected cwd instruction file. Ambient Pi extensions, packages,
+prompts, themes, project settings, and package resources are filtered.
+
+All built-ins are enabled by default, including the Powerline footer in TUI
+sessions. Binary-backed features can remain inactive until their dependency is
+installed or the feature is disabled through `/dependencies`.
+
+Model responses use the built-in `concise` output style by default. Set the
+global `outputStyle` setting to `explanatory` for more reasoning and context;
+the [configuration guide](../../docs/user-guide/configuration.md#output-style)
+documents validation and session-lifecycle behavior.
+
+## Canonical user documentation
+
+The package README intentionally stays short. Use these guides for operational
+details:
+
+- [Getting started](../../docs/getting-started.md)
+- [Local CLI and storage](../../docs/user-guide/local-cli.md)
+- [Configuration](../../docs/user-guide/configuration.md)
+- [Commands and shortcuts](../../docs/user-guide/commands-and-shortcuts.md)
+- [Agents, tasks, and Prewalk](../../docs/user-guide/agents-tasks-and-prewalk.md)
+- [Context and memory](../../docs/user-guide/context-and-memory.md)
+- [Web, MCP, browser, and documents](../../docs/user-guide/web-mcp-and-browser.md)
+- [Runtime and security](../../docs/concepts/runtime-and-security.md)
+- [Extension catalog](../../docs/reference/extension-catalog.md)
 
 ## Development
 
@@ -390,5 +106,9 @@ Source: `apps/tui` in <https://github.com/felan-ai/felan>.
 corepack enable
 pnpm install --frozen-lockfile
 pnpm --filter @felan-ai/felan build
+pnpm --filter @felan-ai/felan type-check
 pnpm --filter @felan-ai/felan test
 ```
+
+Run `pnpm verify` from the repository root for cross-package and packed-binary
+coverage.

package/dist/cli-main.d.ts

@@ -1,8 +1,9 @@
-import { type RunLocalFelanOptions } from './application.js';
+import type { RunLocalFelanOptions } from './application.js';
 export interface CliDependencies {
     readonly writeOutput?: (line: string) => void;
     readonly writeError?: (line: string) => void;
     readonly launch?: (options: RunLocalFelanOptions) => Promise<void>;
+    readonly update?: () => Promise<number>;
 }
 export declare function runCli(args: readonly string[], dependencies?: CliDependencies): Promise<number>;
 //# sourceMappingURL=cli-main.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"cli-main.d.ts","sourceRoot":"","sources":["../src/cli-main.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAG5E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE;AAWD,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,YAAY,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgDzG"}
+{"version":3,"file":"cli-main.d.ts","sourceRoot":"","sources":["../src/cli-main.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAI7D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CACzC;AAYD,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,YAAY,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+DzG"}

package/dist/cli-main.js

@@ -1,19 +1,24 @@
-import { AGENT_CORE_VERSION } from '@felan-ai/agent-core';
-import { VERSION as PI_VERSION } from '@earendil-works/pi-coding-agent';
-import { runLocalFelan } from './application.js';
+import { runFelanUpdate } from './update.js';
 import { FELAN_VERSION } from './version.js';
 const help = `Usage: felan [options] [message]
 
 Options:
   -c, --continue     Continue the most recent session for this directory
   --diagnostics      Print local runtime versions and configuration mode
+  update             Update a global npm installation of Felan
   -h, --help         Show this help
   -v, --version      Print the Felan version
   --verbose          Show verbose startup details`;
 export async function runCli(args, dependencies = {}) {
     const writeOutput = dependencies.writeOutput ?? ((line) => console.log(line));
     const writeError = dependencies.writeError ?? ((line) => console.error(line));
-    const launch = dependencies.launch ?? runLocalFelan;
+    if (args[0] === 'update') {
+        if (args.length !== 1) {
+            writeError('Usage: felan update');
+            return 1;
+        }
+        return dependencies.update?.() ?? runFelanUpdate({ writeOutput, writeError });
+    }
     let continueRecent = false;
     let verbose = false;
     const messageParts = [];
@@ -41,6 +46,10 @@ export async function runCli(args, dependencies = {}) {
             return 0;
         }
         else if (argument === '--diagnostics') {
+            const [{ AGENT_CORE_VERSION }, { VERSION: PI_VERSION }] = await Promise.all([
+                import('@felan-ai/agent-core'),
+                import('@earendil-works/pi-coding-agent'),
+            ]);
             writeOutput(`Felan version: ${FELAN_VERSION}`);
             writeOutput(`Agent Core version: ${AGENT_CORE_VERSION}`);
             writeOutput(`Pi version: ${PI_VERSION}`);
@@ -57,6 +66,10 @@ export async function runCli(args, dependencies = {}) {
             messageParts.push(argument);
         }
     }
+    const launch = dependencies.launch ?? (async (options) => {
+        const { runLocalFelan } = await import('./application.js');
+        await runLocalFelan(options);
+    });
     await launch({
         continueRecent,
         verbose,

package/dist/cli-main.js.map

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

package/dist/update.d.ts

@@ -0,0 +1,14 @@
+export interface NpmResult {
+    readonly status: number;
+    readonly stdout: string;
+    readonly stderr: string;
+}
+export interface RunFelanUpdateOptions {
+    readonly packageDirectory?: string;
+    readonly currentVersion?: string;
+    readonly runNpm?: (args: readonly string[], cwd: string) => Promise<NpmResult>;
+    readonly writeOutput?: (line: string) => void;
+    readonly writeError?: (line: string) => void;
+}
+export declare function runFelanUpdate(options?: RunFelanUpdateOptions): Promise<number>;
+//# sourceMappingURL=update.d.ts.map

package/dist/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/E,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED,wBAAsB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAgEzF"}

package/dist/update.js

@@ -0,0 +1,152 @@
+import { execFile } from 'node:child_process';
+import { existsSync, lstatSync, readFileSync, realpathSync } from 'node:fs';
+import { basename, delimiter, dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { FELAN_VERSION } from './version.js';
+const PACKAGE_NAME = '@felan-ai/felan';
+const PACKAGE_DIRECTORY = ['@felan-ai', 'felan'];
+export async function runFelanUpdate(options = {}) {
+    const writeOutput = options.writeOutput ?? ((line) => console.log(line));
+    const writeError = options.writeError ?? ((line) => console.error(line));
+    const packageDirectory = options.packageDirectory ?? dirname(dirname(fileURLToPath(import.meta.url)));
+    const currentVersion = options.currentVersion ?? FELAN_VERSION;
+    const runNpm = options.runNpm ?? runNpmCommand;
+    const globalRootResult = await runNpm(['root', '--global'], packageDirectory);
+    if (globalRootResult.status !== 0) {
+        writeError(`Could not find npm's global installation: ${commandError(globalRootResult)}`);
+        return 1;
+    }
+    const globalRoot = globalRootResult.stdout.trim();
+    const expectedPackageDirectory = join(globalRoot, ...PACKAGE_DIRECTORY);
+    if (!globalRoot || !samePath(packageDirectory, expectedPackageDirectory) || isSymbolicLink(expectedPackageDirectory)) {
+        writeError('Felan update only supports a verified global npm installation. '
+            + 'Run `npm install --global @felan-ai/felan` to update this installation manually.');
+        return 1;
+    }
+    const packageManifest = readPackageManifest(packageDirectory);
+    if (!packageManifest || packageManifest.name !== PACKAGE_NAME || packageManifest.version !== currentVersion) {
+        writeError('The running Felan package could not be verified. Update it manually with npm.');
+        return 1;
+    }
+    const latestResult = await runNpm(['view', `${PACKAGE_NAME}@latest`, 'version'], packageDirectory);
+    if (latestResult.status !== 0) {
+        writeError(`Could not check for a newer Felan release: ${commandError(latestResult)}`);
+        return 1;
+    }
+    const latestVersion = latestResult.stdout.trim();
+    if (!isStableVersion(latestVersion) || !isStableVersion(currentVersion)) {
+        writeError('npm returned an invalid stable Felan version. Update Felan manually.');
+        return 1;
+    }
+    const comparison = compareVersions(latestVersion, currentVersion);
+    if (comparison <= 0) {
+        writeOutput(`Felan ${currentVersion} is already up to date.`);
+        return 0;
+    }
+    const installResult = await runNpm(['install', '--global', `${PACKAGE_NAME}@${latestVersion}`], packageDirectory);
+    if (installResult.status !== 0) {
+        writeError(`Felan update failed: ${commandError(installResult)}`);
+        return 1;
+    }
+    const installedManifest = readPackageManifest(packageDirectory);
+    if (installedManifest?.name !== PACKAGE_NAME || installedManifest.version !== latestVersion) {
+        writeError(`Felan update could not verify version ${latestVersion}. Update Felan manually.`);
+        return 1;
+    }
+    writeOutput(`Updated Felan from ${currentVersion} to ${latestVersion}. Restart Felan to use the new version.`);
+    return 0;
+}
+async function runNpmCommand(args, cwd) {
+    const npmCommand = resolveNpmCommand();
+    if (!npmCommand) {
+        return { status: 1, stdout: '', stderr: 'npm was not found' };
+    }
+    return new Promise((resolveResult) => {
+        execFile(npmCommand.command, [...npmCommand.arguments, ...args], {
+            cwd,
+            encoding: 'utf8',
+            windowsHide: true,
+        }, (error, stdout, stderr) => {
+            resolveResult({
+                status: error ? (typeof error.code === 'number' ? error.code : 1) : 0,
+                stdout,
+                stderr,
+            });
+        });
+    });
+}
+function resolveNpmCommand() {
+    const npmCliCandidates = [
+        join(dirname(process.execPath), 'node_modules', 'npm', 'bin', 'npm-cli.js'),
+        join(dirname(process.execPath), '..', 'lib', 'node_modules', 'npm', 'bin', 'npm-cli.js'),
+        join(dirname(process.execPath), '..', 'share', 'nodejs', 'npm', 'bin', 'npm-cli.js'),
+    ];
+    for (const candidate of npmCliCandidates) {
+        if (candidate && basename(candidate).toLowerCase() === 'npm-cli.js' && existsSync(candidate)) {
+            return { command: process.execPath, arguments: [candidate] };
+        }
+    }
+    for (const directory of (process.env.PATH ?? '').split(delimiter)) {
+        if (!directory || directory.toLowerCase().includes('node_modules'))
+            continue;
+        const executable = join(directory, process.platform === 'win32' ? 'npm.cmd' : 'npm');
+        if (!existsSync(executable))
+            continue;
+        if (process.platform === 'win32') {
+            const adjacentCli = join(directory, 'node_modules', 'npm', 'bin', 'npm-cli.js');
+            if (existsSync(adjacentCli))
+                return { command: process.execPath, arguments: [adjacentCli] };
+            continue;
+        }
+        return { command: executable, arguments: [] };
+    }
+    return undefined;
+}
+function readPackageManifest(packageDirectory) {
+    try {
+        return JSON.parse(readFileSync(join(packageDirectory, 'package.json'), 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+}
+function isSymbolicLink(path) {
+    try {
+        return lstatSync(path).isSymbolicLink();
+    }
+    catch {
+        return false;
+    }
+}
+function samePath(left, right) {
+    const canonicalLeft = canonicalPath(left);
+    const canonicalRight = canonicalPath(right);
+    const normalizedLeft = process.platform === 'win32' ? canonicalLeft.toLowerCase() : canonicalLeft;
+    const normalizedRight = process.platform === 'win32' ? canonicalRight.toLowerCase() : canonicalRight;
+    return normalizedLeft === normalizedRight;
+}
+function canonicalPath(path) {
+    const resolved = resolve(path);
+    try {
+        return realpathSync(resolved);
+    }
+    catch {
+        return resolved;
+    }
+}
+function isStableVersion(version) {
+    return /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)$/u.test(version);
+}
+function compareVersions(left, right) {
+    const leftParts = left.split('.').map(Number);
+    const rightParts = right.split('.').map(Number);
+    for (let index = 0; index < leftParts.length; index += 1) {
+        if (leftParts[index] !== rightParts[index])
+            return leftParts[index] > rightParts[index] ? 1 : -1;
+    }
+    return 0;
+}
+function commandError(result) {
+    return result.stderr.trim() || result.stdout.trim() || `npm exited with status ${result.status}`;
+}
+//# sourceMappingURL=update.js.map

package/dist/update.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@felan-ai/felan",
-  "version": "0.12.11",
+  "version": "0.13.0",
   "description": "Local Felan terminal agent",
   "license": "MIT",
   "type": "module",
@@ -35,19 +35,19 @@
     "open": "11.0.0",
     "proper-lockfile": "4.1.2",
     "@felan-ai/agent-core": "0.4.9",
-    "@felan-ai/ext-background-bash": "0.3.6",
-    "@felan-ai/ext-browser": "0.1.0",
     "@felan-ai/ext-ask-user": "0.1.3",
-    "@felan-ai/ext-codex": "0.1.5",
+    "@felan-ai/ext-browser": "0.1.0",
+    "@felan-ai/ext-background-bash": "0.3.6",
     "@felan-ai/ext-mcp": "0.1.2",
+    "@felan-ai/ext-codex": "0.1.5",
     "@felan-ai/ext-subagents": "0.4.0",
     "@felan-ai/ext-context": "0.3.1",
-    "@felan-ai/ext-tasks": "0.1.3",
-    "@felan-ai/ext-memory": "0.1.0",
     "@felan-ai/ext-output-style": "0.1.0",
     "@felan-ai/ext-markitdown": "0.1.0",
-    "@felan-ai/ext-prewalk": "0.3.3",
+    "@felan-ai/ext-memory": "0.1.0",
+    "@felan-ai/ext-tasks": "0.1.3",
     "@felan-ai/ext-powerline": "0.4.2",
+    "@felan-ai/ext-prewalk": "0.3.3",
     "@felan-ai/ext-rtk-optimizer": "0.1.1",
     "@felan-ai/ext-web-access": "0.2.0"
   },