From b779785286725c8da462302fb002666475ba8e02 Mon Sep 17 00:00:00 2001 From: gsxdsm Date: Fri, 17 Jul 2026 00:36:21 -0700 Subject: [PATCH] FN-8187: update README feature overview Refresh the README to describe current Fusion capabilities and storage guidance. - Highlight embedded PostgreSQL, Kimi K3, and richer task-chat progress reporting - Document updated GitHub import, dashboard, and per-task override capabilities - Add storage documentation to the resource directory Files changed: README.md | 19 +++++++++++++------ 1 file changed, 13 insertions(+), 6 deletions(-) Fusion-Task-Id: FN-8187 Fusion-Task-Lineage: 696c1f1f-91fe-4256-b6b8-98a6d6b2f2e5 Co-authored-by: Fusion (runfusion.ai) --- README.md | 19 +++++++++++++------ 1 file changed, 13 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index e7f5add91d..68ccc30103 100644 --- a/README.md +++ b/README.md @@ -131,18 +131,24 @@ Every task shows its plan, its reviews, its diffs, and its file changes in real ## What makes it different + + | | | |---|---| | 🧠 **AI planning** | Describe a task in plain language. Planning agents turn it into a `PROMPT.md` plan with steps, file scope, and acceptance criteria. | | πŸ” **Selectable workflows** | Built-ins cover coding, quick fixes, review-heavy work, stepwise execution, plugin-gated Compound Engineering, and PR lifecycle fragments. Pick a workflow per task or author custom ones in the [Workflow Editor](./docs/workflow-editor.md). | | πŸ›‘οΈ **Planner oversight** | Per-task or per-workflow oversight level (`off` / `observe` / `steer` / `autonomous`) governs how closely a planner overseer watches and intervenes β€” merge/PR and destructive actions always require explicit human confirmation. See [Settings Reference](./docs/settings-reference.md#workflow-settings) and [Dashboard Guide](./docs/dashboard-guide.md). | | 🌳 **Worktree isolation** | Each task runs in its own branch and worktree (`fusion/{task-id}`). Parallel tasks. Zero conflicts. Optional [worktrunk](https://github.com/max-sixty/worktrunk) delegation via [`worktrunk.enabled`](./docs/settings-reference.md#worktree-backend-settings) (see [WorktreeBackend abstraction](./docs/architecture.md#worktreebackend-abstraction)). | +| πŸ—„οΈ **PostgreSQL by default** | Fusion uses zero-config embedded PostgreSQL for local runtime metadata. Legacy SQLite files are one-time migration inputs only; use a shared external database for [multi-project and multi-node](./docs/multi-project.md) setups. ([Storage](./docs/storage.md)) | | ⚑ **Smart merge controls** | Passing every gate? Fusion squash-merges and moves on. Opt into manual approval anywhere, inherit the live global auto-merge default, or set explicit per-task auto/manual overrides. | | πŸ›°οΈ **Multi-node mesh** | Laptop, Mac mini, Linux server, cloud VM, phone β€” all synced. Desktop, mobile, web. | -| 🧩 **Any model** | Anthropic, OpenAI, Ollama, Google Generative AI, Z.ai, local runtimes, and user-defined [custom providers](./docs/dashboard-guide.md#custom-providers). Local and cloud coexist, with workflow model/fallback lanes configurable per project. | +| 🧩 **Any model** | Anthropic, OpenAI, Ollama, Google Generative AI, Z.ai, Kimi K3, local runtimes, and user-defined [custom providers](./docs/dashboard-guide.md#custom-providers). Local and cloud coexist, with workflow model/fallback lanes configurable per project. | | 🏒 **Agent companies** | Import pre-built teams β€” 440+ agents across 16 companies β€” and run them autonomously for weeks. | | πŸ“¬ **Inter-agent messaging** | Built-in mailbox between agents. Delegate, clarify, coordinate; engineer-role agents can opt into backlog auto-claim when you want implementation help beyond executor-only pickup. | -| πŸ—¨οΈ **Agent chat** | Direct chat, task chat, attachments, in-chat question cards, resumable streams, and experimental multi-agent Chat Rooms where mentioned members respond directly and ambient members can join up to a cap. ([Chat docs](./docs/dashboard-guide.md#chat-view)) | +| πŸ—¨οΈ **Agent chat** | Direct chat, task chat that proactively narrates step progress, failures, and review outcomes, attachments, in-chat question cards, resumable streams, and experimental multi-agent Chat Rooms where mentioned members respond directly and ambient members can join up to a cap. ([Chat docs](./docs/dashboard-guide.md#chat-view)) | | πŸ—ΊοΈ **Missions** | Hierarchical planning (Mission β†’ Milestone β†’ Slice β†’ Feature β†’ Task) with autopilot and validation contracts. | | πŸ”¬ **Research** | Bounded research runs with web search, GitHub, local docs, and LLM synthesis (plus runtime builtin WebSearch/WebFetch support in planning + synthesis flows when available). Turn findings into tasks. ([Docs](./docs/research.md)) | | πŸ§ͺ **Self-improvement** | Agents reflect on their own output and update their prompts as they learn your codebase. | @@ -221,7 +227,7 @@ Every tab is a different lens on the same live fleet: > Tokens Β· Tools Β· Activity Β· Productivity Β· Team Β· Ecosystem Β· GitHub Β· Signals Β· System Β· Reliability Β· Mission Control β€” every tab is a different lens on the same live fleet. -**The same fleet, your way** β€” Command Center (and the whole dashboard) re-skins live across **70+ color themes**. Here it is in Shadcn Light, Shadcn Dark Gray, and Ember: +**The same fleet, your way** β€” Command Center (and the whole dashboard) re-skins live across **70+ color themes**, including Cobalt, Clay, and Moss. Here it is in Shadcn Light, Shadcn Dark Gray, and Ember: @@ -500,6 +506,7 @@ npx companies.sh add paperclipai/companies/gstack | [Plugin Authoring](./docs/PLUGIN_AUTHORING.md) | Building plugins with lifecycle hooks, routes, tools, runtimes, and dashboard surfaces | | [Remote Access](./docs/remote-access.md) | Tokenized remote dashboard access, Tailscale/Cloudflare setup, and troubleshooting | | [Multi-Project](./docs/multi-project.md) | Central registry, isolation modes, and migration paths | +| [Storage](./docs/storage.md) | PostgreSQL runtime storage, migration compatibility, and file-backed payloads | | [Docker](./docs/docker.md) | Container deployment | --- @@ -514,8 +521,8 @@ npx companies.sh add paperclipai/companies/gstack - **Workflow Steps** β€” Configurable quality gates (pre-merge: blocks merge; post-merge: informational), plus workflow-declared optional steps such as opt-in [Browser Verification](./docs/workflow-steps.md#workflow-declared-optional-steps) - **Workflow-native policy** β€” Fast-mode planning (`leanPlanning` / `autoApproveSpec`), typed triage thresholds, review/approval, step execution, and model/fallback lanes are workflow settings, not hard-coded engine constants ([Settings Reference](./docs/settings-reference.md#workflow-native-triage-policy-settings); [workflow settings](./docs/settings-reference.md#workflow-settings)) - **Planner oversight** β€” Workflow-native `plannerOversightLevel` (`off`/`observe`/`steer`/`autonomous`), with an optional per-task override and a separate notification-verbosity setting; merge/PR progression and destructive actions always require explicit human confirmation, even at `autonomous` ([overview](#planner-oversight); [Settings Reference](./docs/settings-reference.md#workflow-settings)) -- **GitHub + PR lifecycle** β€” Import issues, create PRs, display real-time PR/issue badges, and use workflow-mode PR lifecycle graph fragments where enabled -- **Dashboard** β€” Real-time kanban/list/graph views, agent management, terminal, git manager, mission planner, chat, workflow editor, custom provider setup, and one-click update action +- **GitHub + PR lifecycle** β€” Import issues with optional translation and screenshot attachments, skip previously imported issues even after edits or repository casing changes, create PRs, display real-time PR/issue badges, and use workflow-mode PR lifecycle graph fragments where enabled +- **Dashboard** β€” Real-time kanban/list/graph views, a project Overview with local codebase token estimate and on-disk size, agent management, terminal, git manager, mission planner, chat, workflow editor, custom provider setup, and one-click update action - **Missions** β€” Hierarchical planning (Mission β†’ Milestone β†’ Slice β†’ Feature β†’ Task) with autopilot, validation contracts, fix-feature retries, mission-goal linking, and blocked-handoff semantics - **Multi-Project** β€” Manage multiple projects from a single installation with project isolation - **Custom Providers** β€” Add OpenAI-compatible, OpenAI Responses, Anthropic-compatible, or Google Generative AI providers; saved models appear in Project Models and workflow model dropdowns ([Dashboard Guide](./docs/dashboard-guide.md#custom-providers); [settings shape](./docs/settings-reference.md#customproviders)) @@ -549,7 +556,7 @@ Fusion uses a dual-scope model hierarchy with independent lanes. Global settings **Workflow lanes:** The default workflow exposes Plan/Triage, Executor, Reviewer, and fallback model lanes in **Settings β†’ Project Models**, and advanced workflow settings can declare additional typed model/policy values ([Settings Reference](./docs/settings-reference.md#workflow-settings)). -**Per-Task Overrides:** Tasks can override the executor, validator, and planning lanes with per-task model fields (`modelProvider`/`modelId`, `validatorModelProvider`/`validatorModelId`, `planningModelProvider`/`planningModelId`). +**Per-Task Overrides:** Quick Add and Inline Create let tasks override the planning, executor, validator, and merger lanes; planning, validator, and merger selections also support task-specific thinking levels. (`modelProvider`/`modelId`, `validatorModelProvider`/`validatorModelId`, `planningModelProvider`/`planningModelId`, and merger model/thinking overrides.) **Precedence:** Per-task β†’ Project override β†’ Global lane β†’ `defaultProvider`/`defaultModelId` β†’ Automatic resolution.