archeious/marchwarden
1
0
Fork 0
Code Issues 14 Pull requests Projects Releases Packages Wiki Activity Actions

M2.1: marchwarden ask CLI command #8

New issue
Closed
opened 2026-04-08 20:48:42 +00:00 by claude-code · 0 comments
claude-code commented 2026-04-08 20:48:42 +00:00
Collaborator
Copy link

Phase 2 — CLI Shim, milestone 1.

Goal

Human-usable marchwarden ask "question" command that drives the web researcher end-to-end via the MCP server.

Scope

  • cli/main.py — Click app, ask subcommand
  • Args: positional question; flags --depth [shallow|balanced|deep], --budget INT, --max-iterations INT
  • Connects to the web researcher via the MCP server (spawn python -m researchers.web.server as subprocess, talk via MCP stdio client) — not a direct WebResearcher import
  • Build ResearchConstraints from flags, call the research tool
  • Pretty-print: answer, citations w/ raw_excerpts, gaps grouped by category, discovery events, open questions, confidence + factors, cost metadata, trace_id footer
  • Register marchwarden script entry point in pyproject.toml

Tests

  • CliRunner test with a mocked MCP client returning a fixture ResearchResult
  • Verify all contract fields render

Deliverable

End-to-end question → formatted answer in terminal, going through the real MCP transport.

Branch

feat/cli-ask

Phase 2 — CLI Shim, milestone 1. ## Goal Human-usable `marchwarden ask "question"` command that drives the web researcher end-to-end via the MCP server. ## Scope - `cli/main.py` — Click app, `ask` subcommand - Args: positional `question`; flags `--depth [shallow|balanced|deep]`, `--budget INT`, `--max-iterations INT` - **Connects to the web researcher via the MCP server** (spawn `python -m researchers.web.server` as subprocess, talk via MCP stdio client) — not a direct `WebResearcher` import - Build `ResearchConstraints` from flags, call the `research` tool - Pretty-print: answer, citations w/ raw_excerpts, gaps grouped by category, discovery events, open questions, confidence + factors, cost metadata, trace_id footer - Register `marchwarden` script entry point in `pyproject.toml` ## Tests - CliRunner test with a mocked MCP client returning a fixture `ResearchResult` - Verify all contract fields render ## Deliverable End-to-end question → formatted answer in terminal, going through the real MCP transport. ## Branch `feat/cli-ask`
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
feat/step-durations
chore/makefile
feat/depth-presets
feat/per-step-logging
fix/budget-display-clarity
feat/costs-command
feat/cost-ledger
feat/structured-logging
fix/mcp-env-propagation
fix/budget-enforcement
fix/model-default-id
fix/synthesis-truncation
chore/docker-test-env
feat/cli-replay
feat/cli-ask
feat/mcp-server
feat/open-questions
feat/agent-loop
feat/trace-logger
feat/search-fetch-tools
feat/contract-models
No results found.
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: archeious/marchwarden#8
No description provided.
Delete branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?