Align Poe docs tasks with renamed CLI documentation files

[Copilot]

The CLI command surface was renamed (configure/chat/transcribe/query/subscribe) and legacy docs files were removed, but poe docs:* still referenced old filenames. This updates the Poetry/Poe documentation tasks to target the current docs/cli set.

• Problem summary

  • docs:generate / docs:check in pyproject.toml still pointed at removed files (castchat.md, config.md, meta.md, sql.md, sync.md, transcription.md).
  • As a result, docs automation no longer matched the actual CLI docs layout.

• Poe task updates (pyproject.toml)

  • Updated explicit file lists for:
    • tool.poe.tasks."docs:generate"
    • tool.poe.tasks."docs:check"
  • Replaced obsolete docs with current command docs:
    • chat.md, configure.md, query.md, subscribe.md, transcribe.md
  • Kept existing behavior/flags (PYTHONPATH, COLUMNS, cog --check --diff) unchanged.

• Related cleanup already in branch

  • Removed stale files from docs/cli that no longer map to active commands:
    • castchat.md, config.md, meta.md, sql.md, sync.md, transcription.md
  • Updated docs-generation test expectations to reference configure.md instead of removed config.md.

[tool.poe.tasks."docs:generate"]
cmd = "env PYTHONPATH=src COLUMNS=200 uv run cog -r docs/cli/about.md docs/cli/chat.md docs/cli/configure.md docs/cli/download.md docs/cli/index.md docs/cli/query.md docs/cli/subscribe.md docs/cli/transcribe.md"

[tool.poe.tasks."docs:check"]
cmd = "env PYTHONPATH=src COLUMNS=200 uv run cog --check --diff docs/cli/about.md docs/cli/chat.md docs/cli/configure.md docs/cli/download.md docs/cli/index.md docs/cli/query.md docs/cli/subscribe.md docs/cli/transcribe.md"

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Rename and reorganize command structure</issue_title>
<issue_description>Let's make the command structure more action oriented:

• configure: manage configuration
• chat: agentic AI chat with the transcribed, indexed data
• transcribe: apply ASR to transcribe download episodes
• download: download and manage episodes from feeds subscribed to
• query: manage and query databases for subscriptions, episodes, episode metadata, and episode transcriptions
• index: create and manage search indexes created from episode transcriptions (doesn't exist yet)
• subscribe: manage feed subscriptions
• about: quick philosophical readme

Also, move some current top level subgroups (meta, sync) into new locations.</issue_description>

<agent_instructions>First, just make a plan for @crossjam to review. Then we'll move into implementation.</agent_instructions>

Comments on the Issue (you are @copilot in this section)

@crossjam Also, be sure to fix up the tests to match the new command structure. @crossjam @copilot Create a new branch for this work. Read this issue. Then generate a plan to implement changes to satisfy this issue. Do not write code yet. Just generate a plan to implement.

• Fixes Rename and reorganize command structure #81

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[crossjam]

@copilot The main branch has changed. Rebase this branch onto main.

[Copilot]

@copilot The main branch has changed. Rebase this branch onto main.

I can’t run git rebase from this environment due branch-operation restrictions. Current head is ebc67f4. Please rebase this PR branch onto main (or merge main into it), and I’ll continue immediately on top of that updated branch.

[crossjam]

@copilot check to make sure all the requested changes from the plan are implemented and resolve the assigned issue.

[Copilot]

@copilot check to make sure all the requested changes from the plan are implemented and resolve the assigned issue.

Verified on 18defd2: the requested command structure is implemented (configure, chat, transcribe, download, query, index, subscribe, about), sync/meta flows are moved under subscribe overcast, and tests/docs were updated accordingly. I re-ran targeted validation (63 passed) and confirmed top-level CLI help matches the issue requirements.

[crossjam]

@copilot There might be some old documentation files in the ./docs/cli directory that no longer map to existing commands. Can you determine if any can be deleted and remove them from the repository?

[Copilot]

@copilot There might be some old documentation files in the ./docs/cli directory that no longer map to existing commands. Can you determine if any can be deleted and remove them from the repository?

Done in 899caa0. I removed stale CLI docs that no longer map to existing commands: castchat.md, config.md, meta.md, sql.md, sync.md, and transcription.md. I also updated docs test coverage to check configure.md instead of removed config.md, and re-ran tests/test_docs_generation.py (8 passed). Screenshot: https://github.com/user-attachments/assets/d2c50156-ccf2-457e-995f-69fb42587662

[crossjam]

LGTM! Fire in the Disco!