tasks
Generalize Task-Specific Read Operations
Replace task-specific CLI and RPC read APIs with space/schema-driven operations so Forma does not treat tasks as a core concept.
Goal
Replace task-specific CLI and RPC read APIs with generic, space/schema-driven operations so Forma does not treat tasks as a built-in content type.
Context
Forma's product model is a Markdown-backed content workspace. Content categories such as tasks, members, notes, or guidelines are configured spaces, not core ontology.
Forma previously exposed task-specialized surfaces such as tasks.list, tasks.inspect, and board.show. They were useful for the repository's dogfooding workflow, but their names implied that task was a built-in Forma concept.
In Scope
- Review the previous
tasks.*andboard.showCLI/RPC surfaces. - Define equivalent generic read operations in terms of configured spaces, views, schemas, or query projections.
- Decide whether task-specific aliases should be removed, renamed, or kept temporarily as project-workspace conveniences before the next internal release.
- Update built-in Agent guidance after the generic operations exist.
- Preserve the ability for this repository's configured
tasksspace to support task selection and board review through configuration rather than product assumptions.
Out of Scope
- Implementing write operations.
- Designing task transition policies.
- Removing the repository's configured
tasksspace. - Changing starter-kit content unless it is needed to demonstrate the generic operation shape.
Acceptance Criteria
- Forma has a documented generic replacement path for
tasks.list,tasks.inspect, andboard.show. - Product-facing docs and built-in skills no longer present
taskas a core Forma concept. - The repository dogfooding workflow can still inspect configured task-like content through generic operations.
Progress
- Added
forma view render <view-id-or-path> --jsonas the generic CLI path for configured list, table, kanban, and graph projections. - Updated Agent-facing guidance to use
list --space,inspect, andview renderfor read workflows. - Removed the public
forma tasks ...andforma board showCLI helpers so the CLI no longer presents task-like content as a built-in product concept. - Removed legacy RPC/core
tasks.list,tasks.inspect, andboard.showoperations. Genericlist,inspect, andview.rendernow cover configured task-like workflows.
Completion Evidence
- Current CLI help exposes generic
list,inspect, andviewcommands and no task- or board-specific command group. forma list --space tasks --json,forma inspect --space tasks generalize-task-specific-read-operations --json, andforma view render .forma/views/task-board --jsonpass against this repository.- Product code, docs, examples, skills, and workflows contain no active
tasks.list,tasks.inspect,board.show,forma tasks, orforma boardsurface; the remaining RPC strings are a rejection regression test. - The focused RPC rejection test passed and confirms all three removed legacy methods return
Method not found. mise run checkpassed on 2026-07-17 across pnpm, Rust, and the Zed WASM target.