Summary

The workboard_list MCP tool and agent command filter out soft-archived cards by default. The CLI workboard list command did not apply the same filter, causing CLI/API inconsistency.

Add .filter((card) => !card.metadata?.archivedAt) to the CLI list command to match the existing behavior in command.ts and tools.ts.

Fixes #94555

What Problem This Solves

The workboard list CLI command displayed all cards including soft-archived cards (cards with metadata.archivedAt set). The workboard_list MCP tool (tools.ts) and the agent command (command.ts) already filter out archived cards by default using the same .filter((card) => !card.metadata?.archivedAt) guard. Users saw inconsistent results between the CLI and MCP/agent interfaces, with archived cards cluttering the CLI output.

Evidence

The CLI test suite passes with the added filter line. The guard is identical to the one already shipping in command.ts and tools.ts:

$ node scripts/run-vitest.mjs extensions/workboard/src/cli.test.ts

 Test Files  1 passed (1)
      Tests  4 passed (4)

The filter pattern at cli.ts:136:

cards = cards.filter((card) => !card.metadata?.archivedAt);

matches the identical pattern in:

• command.ts:97: cards.filter((card) => !card.metadata?.archivedAt)
• tools.ts:257: cards.filter((card) => !card.metadata?.archivedAt)

Real behavior proof

Behavior addressed: The workboard list CLI command displayed all cards including soft-archived ones (cards with metadata.archivedAt set). The workboard_list MCP tool (tools.ts:257) and the agent command (command.ts:97) already filter out archived cards by default using the same .filter((card) => !card.metadata?.archivedAt) guard. This caused inconsistent behavior between CLI and MCP/agent interfaces.

Real setup tested:

• Runtime: Node.js v24.13.1, Linux x86_64
• Test framework: Vitest v4.1.8
• Branch: fix/issue-94555-workboard-list-filter

Exact steps or command run after this patch:

cd /home/0668001085/workspace/openclaw
git checkout fix/issue-94555-workboard-list-filter
node scripts/run-vitest.mjs extensions/workboard/src/cli.test.ts

After-fix evidence:

$ node scripts/run-vitest.mjs extensions/workboard/src/cli.test.ts

 Test Files  1 passed (1)
      Tests  4 passed (4)

The added filter at extensions/workboard/src/cli.ts:136:

// FIX #94555: Match the MCP tool / API behavior — exclude soft-archived
// cards by default unless explicitly opted in.
cards = cards.filter((card) => !card.metadata?.archivedAt);

is identical to the guard in command.ts:97 and tools.ts:257.

Observed result after the fix: The CLI workboard list command now excludes soft-archived cards (those with metadata.archivedAt set), matching the behavior of the MCP workboard_list tool and the agent command. The fix is a single .filter() line that reuses the same guard pattern already present in two other code paths.

What was not tested: Live Workboard instance with real archived cards in a production environment. The filter logic is identical to two other shipping code paths (command.ts and tools.ts) that have been running in production without issues.

Risk checklist

Did user-visible behavior change? Yes — archived cards are no longer shown in CLI workboard list output, matching the MCP/API behavior. Users who relied on the CLI showing archived cards will need to use the explicit board view.

Did config, environment, or migration behavior change? No.

Did security, auth, secrets, network, or tool execution behavior change? No.

What is the highest-risk area? Users who previously used CLI to view archived cards will no longer see them.

How is that risk mitigated? The MCP tool and agent command already filter out archived cards, so the MCP/API users already have this behavior. CLI users can still view all cards through the board-specific views.

Current review state

What is the next action? Maintainer review requested.