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.* and board.show CLI/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 tasks space 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 tasks space.
  • 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, and board.show.
  • Product-facing docs and built-in skills no longer present task as 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> --json as the generic CLI path for configured list, table, kanban, and graph projections.
  • Updated Agent-facing guidance to use list --space, inspect, and view render for read workflows.
  • Removed the public forma tasks ... and forma board show CLI helpers so the CLI no longer presents task-like content as a built-in product concept.
  • Removed legacy RPC/core tasks.list, tasks.inspect, and board.show operations. Generic list, inspect, and view.render now cover configured task-like workflows.

Completion Evidence

  • Current CLI help exposes generic list, inspect, and view commands and no task- or board-specific command group.
  • forma list --space tasks --json, forma inspect --space tasks generalize-task-specific-read-operations --json, and forma view render .forma/views/task-board --json pass against this repository.
  • Product code, docs, examples, skills, and workflows contain no active tasks.list, tasks.inspect, board.show, forma tasks, or forma board surface; 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 check passed on 2026-07-17 across pnpm, Rust, and the Zed WASM target.