Docs: 'kelos delete --all' and supported resource types undocumented in CLI reference

[kelos-bot]

🤖 Kelos User Agent @gjkim42

Problem

As a new user, I tried to clean up all completed tasks after testing a workflow. I ran kelos delete task --all and it worked — but I only knew about the --all flag by chance after reading the source code. The docs/reference.md CLI reference does not document it anywhere.

Specifically, the reference currently shows:

| `kelos delete <resource> <name>` | Delete a resource |

There is no kelos delete flags section, unlike kelos run, kelos get, and kelos install which each have their own flags subsection. This creates three problems:

1. --all is undocumented — kelos delete task/workspace/taskspawner/agentconfig all support --all for bulk deletion. New users cleaning up after tests won't discover this without reading source code.

2. Command signature is misleading — The reference shows kelos delete <resource> <name> (name appears required), but --all makes name optional. Running kelos delete task without a name gives a helpful error (task name is required (or use --all)), but users won't know to try --all if the docs don't mention it.

3. Supported resource types not listed — The kelos get row at least lists tasks, taskspawners, workspaces inline. The kelos delete row only says <resource> — users have to guess that agentconfigs is also valid (mirroring kelos get agentconfigs).

Expected Fix

Add a kelos delete flags subsection to docs/reference.md, similar to the existing kelos run and kelos get sections:

### `kelos delete` Flags

- `--all`: Delete all resources of the specified type in the namespace (mutually exclusive with providing a name)

Also update the command table row to reflect supported resource types and the optional name:

| `kelos delete <resource> [name]` | Delete a resource (`task`, `workspace`, `taskspawner`, `agentconfig`). Use `--all` to delete all resources of that type |

Evidence

From internal/cli/delete.go and internal/cli/delete_agentconfig.go, all four delete subcommands register --all:

• kelos delete task --all — deletes all tasks in the namespace
• kelos delete workspace --all — deletes all workspaces
• kelos delete taskspawner --all — deletes all task spawners
• kelos delete agentconfig --all — deletes all agent configs

None of this appears in docs/reference.md.

[kelos-bot]

🤖 Kelos Task Status

Task kelos-triage-773 has succeeded. ✅

[kelos-bot]

🤖 Kelos Agent @gjkim42

Kelos Triage Report

Kind: kind/docs
Priority: priority/backlog — Documentation gap, not blocking functionality; the CLI itself provides helpful error messages guiding users to --all
Actor: actor/kelos — Concrete docs-only fix with clear scope and verifiable acceptance criteria

Status: STILL VALID

Evidence:

• Confirmed docs/reference.md line 302 still shows kelos delete <resource> <name> with no flags subsection and no mention of --all or supported resource types
• Confirmed --all flag exists in source: internal/cli/delete.go (task, workspace, taskspawner) and internal/cli/delete_agentconfig.go (agentconfig)
• No merged PRs or commits reference this issue
• The kelos get row (line 301) lists resource types inline but kelos delete does not — inconsistency confirmed

Duplicates found: #576 (covers the same gaps: undocumented --all on kelos delete, missing agentconfig from delete docs, plus --phase on kelos get). Issue #576 is a superset of this issue's scope.

Recommendation: CLOSE as duplicate of #576. All three problems described here (undocumented --all, misleading command signature, missing resource types) are already tracked in #576's Gap 2 and Gap 4. Work on #576 will resolve this issue entirely.