root/fusion
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(FN-1216): rename extension tools to fn_* across CLI and docs

Browse Source 
- Rename all pi extension tool registrations from kb_* to fn_* across task, mission, and agent tool families
- Update extension and skill-sync tests plus Fusion skill docs/workflows to assert and document the new fn_* tool names
- Align product-identity strings across core, dashboard, and CLI references, including GitHub import examples, User-Agent headers, and terminal TERM_PROGRAM
- Add a @gsxdsm/fusion minor changeset describing the extension tool-prefix rename
This commit is contained in:
gsxdsm
2026-04-08 14:26:30 -07:00
parent 375d46d31b
commit e78d05e02c
32 changed files with 371 additions and 366 deletions
Download Patch File Download Diff File Expand all files Collapse all files

38
packages/cli/skill/fusion/references/best-practices.md
View File

@@ -13,7 +13,7 @@
- Write one-liner descriptions like "fix the bug"
- Include implementation details the AI should figure out
- Create tasks that are too large (break into smaller tasks or use missions)
- Duplicate existing tasks — check `kb_task_list` first
- Duplicate existing tasks — check `fn_task_list` first
## Task Size Guidelines
@@ -29,14 +29,14 @@ For work larger than L, use missions to break it into phases.
| Scenario | Tool |
|----------|------|
| Quick task with clear scope | `kb_task_create` |
| Vague idea needing refinement | `kb_task_plan` |
| Large project with phases | `kb_mission_create` + hierarchy |
| Task failed, needs retry | `kb_task_retry` |
| Task needs manual intervention | `kb_task_pause` |
| Completed task needs follow-up | `kb_task_refine` |
| Clean up done tasks | `kb_task_archive` |
| Import external work | `kb_task_import_github*` |
| Quick task with clear scope | `fn_task_create` |
| Vague idea needing refinement | `fn_task_plan` |
| Large project with phases | `fn_mission_create` + hierarchy |
| Task failed, needs retry | `fn_task_retry` |
| Task needs manual intervention | `fn_task_pause` |
| Completed task needs follow-up | `fn_task_refine` |
| Clean up done tasks | `fn_task_archive` |
| Import external work | `fn_task_import_github*` |
## Dependency Management
@@ -49,10 +49,10 @@ For work larger than L, use missions to break it into phases.
## Working with the AI Engine
- **Don't fight the automation** — let triage, scheduler, and executor do their jobs
- **Pause if needed** — use `kb_task_pause` when you want manual control
- **Pause if needed** — use `fn_task_pause` when you want manual control
- **Steer don't micromanage** — use steering comments (via CLI `fn task steer`) to guide the AI without rewriting the spec
- **Check progress** — use `kb_task_show` to monitor step completion
- **Let it fail and retry** — if a task fails, check the log, then `kb_task_retry`
- **Check progress** — use `fn_task_show` to monitor step completion
- **Let it fail and retry** — if a task fails, check the log, then `fn_task_retry`
## Mission Planning Tips
@@ -66,18 +66,18 @@ For work larger than L, use missions to break it into phases.
## Common Patterns
**Bug fix flow:**
1. `kb_task_create` with bug description (current vs expected behavior)
1. `fn_task_create` with bug description (current vs expected behavior)
2. Wait for triage to generate specification
3. Monitor with `kb_task_show` until done
3. Monitor with `fn_task_show` until done
**Feature development flow:**
1. `kb_task_plan` to refine requirements
1. `fn_task_plan` to refine requirements
2. Check the task in triage → todo → in-progress
3. Review in `kb_task_show` when in-review
3. Review in `fn_task_show` when in-review
4. Task auto-merges to main
**Large project flow:**
1. `kb_mission_create` with project overview
1. `fn_mission_create` with project overview
2. Add milestones for each phase
3. Add slices and features for the first milestone
4. Activate first slice, create and link tasks
@@ -85,7 +85,7 @@ For work larger than L, use missions to break it into phases.
6. Activate next slice (or use auto-advance)
**GitHub issue triage flow:**
1. `kb_task_browse_github_issues` to see what's open
2. `kb_task_import_github_issue` for high-priority issues
1. `fn_task_browse_github_issues` to see what's open
2. `fn_task_import_github_issue` for high-priority issues
3. Tasks enter triage and get AI-specified
4. Monitor board as AI works through them

56
packages/cli/skill/fusion/references/extension-tools.md
View File

@@ -4,7 +4,7 @@ All tools are registered via the pi extension. They are available in any pi agen
## Task Tools
### kb_task_create
### fn_task_create
Create a new task on the Fusion board. Enters triage for AI specification.
@@ -15,7 +15,7 @@ Create a new task on the Fusion board. Enters triage for AI specification.
Returns: task ID, column, dependencies, path
### kb_task_update
### fn_task_update
Update fields on an existing task (title, description, dependencies).
@@ -28,7 +28,7 @@ Update fields on an existing task (title, description, dependencies).
Returns: task ID, list of updated fields
### kb_task_list
### fn_task_list
List all tasks grouped by column.
@@ -39,7 +39,7 @@ List all tasks grouped by column.
Returns: formatted task list grouped by column
### kb_task_show
### fn_task_show
Show full task details including steps, progress, prompt preview, and log.
@@ -49,7 +49,7 @@ Show full task details including steps, progress, prompt preview, and log.
Returns: task details with steps, prompt preview (500 chars), last 5 log entries
### kb_task_attach
### fn_task_attach
Attach a file to a task. Copies file to task's attachments directory.
@@ -60,7 +60,7 @@ Attach a file to a task. Copies file to task's attachments directory.
Supported formats: png, jpg, jpeg, gif, webp, txt, log, json, yaml, yml, toml, csv, xml
### kb_task_pause
### fn_task_pause
Pause automation for a task. Scheduler and executor will skip this task.
@@ -68,7 +68,7 @@ Pause automation for a task. Scheduler and executor will skip this task.
|-----------|------|----------|-------------|
| `id` | string | ✓ | Task ID |
### kb_task_unpause
### fn_task_unpause
Resume automation for a paused task.
@@ -76,7 +76,7 @@ Resume automation for a paused task.
|-----------|------|----------|-------------|
| `id` | string | ✓ | Task ID |
### kb_task_retry
### fn_task_retry
Retry a failed task. Clears error state, moves to todo for re-execution.
@@ -84,7 +84,7 @@ Retry a failed task. Clears error state, moves to todo for re-execution.
|-----------|------|----------|-------------|
| `id` | string | ✓ | Task ID (must be in failed state) |
### kb_task_duplicate
### fn_task_duplicate
Duplicate a task. Creates a fresh copy in triage with same title and description.
@@ -92,7 +92,7 @@ Duplicate a task. Creates a fresh copy in triage with same title and description
|-----------|------|----------|-------------|
| `id` | string | ✓ | Source task ID to duplicate |
### kb_task_refine
### fn_task_refine
Create a follow-up task for a completed task. New task depends on the original.
@@ -101,7 +101,7 @@ Create a follow-up task for a completed task. New task depends on the original.
| `id` | string | ✓ | Task ID (must be done or in-review) |
| `feedback` | string | ✓ | What needs to be refined (1-2000 chars) |
### kb_task_archive
### fn_task_archive
Archive a done task. Moves from done → archived.
@@ -109,7 +109,7 @@ Archive a done task. Moves from done → archived.
|-----------|------|----------|-------------|
| `id` | string | ✓ | Task ID (must be in done column) |
### kb_task_unarchive
### fn_task_unarchive
Restore an archived task. Moves from archived → done.
@@ -117,7 +117,7 @@ Restore an archived task. Moves from archived → done.
|-----------|------|----------|-------------|
| `id` | string | ✓ | Task ID (must be in archived column) |
### kb_task_delete
### fn_task_delete
Permanently delete a task. Cannot be undone.
@@ -125,7 +125,7 @@ Permanently delete a task. Cannot be undone.
|-----------|------|----------|-------------|
| `id` | string | ✓ | Task ID |
### kb_task_plan
### fn_task_plan
Create a task via AI-guided planning mode. Non-interactive when called from extension.
@@ -135,7 +135,7 @@ Create a task via AI-guided planning mode. Non-interactive when called from exte
## GitHub Tools
### kb_task_import_github
### fn_task_import_github
Batch import GitHub issues as Fusion tasks.
@@ -145,7 +145,7 @@ Batch import GitHub issues as Fusion tasks.
| `limit` | number | — | Max issues (default: 30, max: 100) |
| `labels` | string[] | — | Label names to filter by |
### kb_task_import_github_issue
### fn_task_import_github_issue
Import a single GitHub issue by number.
@@ -155,7 +155,7 @@ Import a single GitHub issue by number.
| `repo` | string | ✓ | Repository name |
| `issueNumber` | number | ✓ | GitHub issue number |
### kb_task_browse_github_issues
### fn_task_browse_github_issues
Browse open issues from a repository before importing.
@@ -168,7 +168,7 @@ Browse open issues from a repository before importing.
## Mission Tools
### kb_mission_create
### fn_mission_create
Create a new mission — a high-level objective spanning multiple milestones.
@@ -178,11 +178,11 @@ Create a new mission — a high-level objective spanning multiple milestones.
| `description` | string | — | Detailed objectives and context |
| `autoAdvance` | boolean | — | Auto-activate next slice on completion |
### kb_mission_list
### fn_mission_list
List all missions with current status. No parameters.
### kb_mission_show
### fn_mission_show
Show mission details with full hierarchy.
@@ -190,7 +190,7 @@ Show mission details with full hierarchy.
|-----------|------|----------|-------------|
| `id` | string | ✓ | Mission ID (e.g., M-001) |
### kb_mission_delete
### fn_mission_delete
Delete a mission and all children. Tasks are NOT deleted.
@@ -198,7 +198,7 @@ Delete a mission and all children. Tasks are NOT deleted.
|-----------|------|----------|-------------|
| `id` | string | ✓ | Mission ID |
### kb_milestone_add
### fn_milestone_add
Add a milestone to a mission.
@@ -208,7 +208,7 @@ Add a milestone to a mission.
| `title` | string | ✓ | Milestone title |
| `description` | string | — | Milestone description |
### kb_slice_add
### fn_slice_add
Add a slice to a milestone.
@@ -218,7 +218,7 @@ Add a slice to a milestone.
| `title` | string | ✓ | Slice title |
| `description` | string | — | Slice description |
### kb_feature_add
### fn_feature_add
Add a feature to a slice.
@@ -229,7 +229,7 @@ Add a feature to a slice.
| `description` | string | — | Feature description |
| `acceptanceCriteria` | string | — | Acceptance criteria |
### kb_slice_activate
### fn_slice_activate
Activate a pending slice for implementation.
@@ -237,7 +237,7 @@ Activate a pending slice for implementation.
|-----------|------|----------|-------------|
| `id` | string | ✓ | Slice ID (must be pending) |
### kb_feature_link_task
### fn_feature_link_task
Link a feature to a kb task. Updates feature status to triaged.
@@ -246,7 +246,7 @@ Link a feature to a kb task. Updates feature status to triaged.
| `featureId` | string | ✓ | Feature ID (e.g., F-001) |
| `taskId` | string | ✓ | Task ID (e.g., KB-001) |
### kb_agent_stop
### fn_agent_stop
Stop (pause) a running agent. Transitions the agent from running/active to paused state.
@@ -254,7 +254,7 @@ Stop (pause) a running agent. Transitions the agent from running/active to pause
|-----------|------|----------|-------------|
| `id` | string | ✓ | Agent ID to stop (e.g., agent-abc123) |
### kb_agent_start
### fn_agent_start
Start (resume) a stopped agent. Transitions the agent from paused to active state.

56
packages/cli/skill/fusion/references/fusion-capabilities.md
View File

@@ -9,34 +9,34 @@ Triage → Todo → In Progress → In Review → Done → Archived
| Tool | Purpose |
|------|---------|
| `kb_task_create` | Create a new task in triage |
| `kb_task_update` | Update task title, description, or dependencies |
| `kb_task_list` | List all tasks grouped by column |
| `kb_task_show` | Show full task details, steps, log |
| `kb_task_attach` | Attach a file to a task |
| `kb_task_pause` | Pause automation for a task |
| `kb_task_unpause` | Resume automation for a task |
| `kb_task_retry` | Retry a failed task (clears error, moves to todo) |
| `kb_task_duplicate` | Duplicate a task (copy to triage) |
| `kb_task_refine` | Create refinement task for follow-up work |
| `kb_task_archive` | Archive a done task |
| `kb_task_unarchive` | Restore an archived task |
| `kb_task_delete` | Permanently delete a task |
| `kb_task_import_github` | Batch import GitHub issues as tasks |
| `kb_task_import_github_issue` | Import a single GitHub issue |
| `kb_task_browse_github_issues` | Browse GitHub issues before importing |
| `kb_task_plan` | Create task via AI-guided planning mode |
| `kb_mission_create` | Create a new mission |
| `kb_mission_list` | List all missions |
| `kb_mission_show` | Show mission hierarchy |
| `kb_mission_delete` | Delete a mission |
| `kb_milestone_add` | Add a milestone to a mission |
| `kb_slice_add` | Add a slice to a milestone |
| `kb_feature_add` | Add a feature to a slice |
| `kb_slice_activate` | Activate a pending slice |
| `kb_feature_link_task` | Link a feature to a task |
| `kb_agent_stop` | Stop (pause) a running agent |
| `kb_agent_start` | Start (resume) a stopped agent |
| `fn_task_create` | Create a new task in triage |
| `fn_task_update` | Update task title, description, or dependencies |
| `fn_task_list` | List all tasks grouped by column |
| `fn_task_show` | Show full task details, steps, log |
| `fn_task_attach` | Attach a file to a task |
| `fn_task_pause` | Pause automation for a task |
| `fn_task_unpause` | Resume automation for a task |
| `fn_task_retry` | Retry a failed task (clears error, moves to todo) |
| `fn_task_duplicate` | Duplicate a task (copy to triage) |
| `fn_task_refine` | Create refinement task for follow-up work |
| `fn_task_archive` | Archive a done task |
| `fn_task_unarchive` | Restore an archived task |
| `fn_task_delete` | Permanently delete a task |
| `fn_task_import_github` | Batch import GitHub issues as tasks |
| `fn_task_import_github_issue` | Import a single GitHub issue |
| `fn_task_browse_github_issues` | Browse GitHub issues before importing |
| `fn_task_plan` | Create task via AI-guided planning mode |
| `fn_mission_create` | Create a new mission |
| `fn_mission_list` | List all missions |
| `fn_mission_show` | Show mission hierarchy |
| `fn_mission_delete` | Delete a mission |
| `fn_milestone_add` | Add a milestone to a mission |
| `fn_slice_add` | Add a slice to a milestone |
| `fn_feature_add` | Add a feature to a slice |
| `fn_slice_activate` | Activate a pending slice |
| `fn_feature_link_task` | Link a feature to a task |
| `fn_agent_stop` | Stop (pause) a running agent |
| `fn_agent_start` | Start (resume) a stopped agent |
## CLI Commands (fn)