recala-cli 0.6.0__tar.gz

recala_cli-0.6.0/.gitignore

@@ -0,0 +1,262 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+.venv/
+venv/
+
+# Node
+node_modules/
+.astro/
+
+# Environment
+.env
+.env.local
+.env.production
+.env.test
+!apps/web/.env.production
+
+# Backup files
+*.bak
+
+# IDE
+.vscode/
+.idea/
+
+# Claude Code session state — must NEVER be committed.
+# `.claude/worktrees/` holds short-lived per-agent working dirs (see
+# docs/parallel_claude_sessions.md). Anything in `.claude/` is local
+# scratch state for the running session, not source code.
+.claude/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Build
+apps/web/dist/
+apps/api/dist/
+
+# Coverage
+coverage.xml
+.coverage
+htmlcov/
+
+# Netlify
+.netlify/
+
+# Supabase CLI ephemeral state
+supabase/.branches/
+supabase/.temp/
+
+# Playwright / MCP test artifacts
+.playwright-mcp/
+playwright-report/
+test-results/
+/apps/api/ab_test_output/
+/apps/api/niche_test_output/
+/apps/api/test_output/
+/apps/video/out/
+/baseline_articles/
+*.png
+*.jpg
+*.jpeg
+*.webp
+*.gif
+# But DO ship transactional-email assets (referenced by absolute URL from
+# email templates, must deploy to https://recala.co/email/...)
+!apps/web/public/email/**
+# ...and the social-share og:image rendered by apps/web/scripts/og/render-og.mjs
+!apps/web/public/og-home.png
+# ...and the favicon / app-icon set rendered by apps/web/scripts/brand/build-favicons.mjs
+!apps/web/public/favicon.png
+!apps/web/public/favicon-32x32.png
+!apps/web/public/apple-touch-icon.png
+!apps/web/public/icon-192.png
+!apps/web/public/icon-512.png
+# ...and the square wordmark logo that Organization.logo points at (apps/web/src/lib/brand.ts)
+!apps/web/public/logo.png
+# ...and the landing film's poster frame (apps/web/src/components/landing/funnel/FunnelFilm.astro)
+!apps/web/public/video/recala-film-poster.webp
+/niche_test_output
+/test_output
+/product-hunt*
+/result*
+!/apps/api/src/writer/acceptance/result.py
+/article*.md
+/canary*.md
+/baseline_articles/baseline_results.json
+
+# Compounding-loop durable artifacts — keep these committed (they are baselines
+# and ledgers, not scratch runs; the /tmp wipe of 2026-06-12 lost b0_baseline)
+!apps/api/results/b0_baseline.jsonl
+!apps/api/results/b0_cohort.json
+!apps/api/results/loop_ledger.jsonl
+apps/api/docs/gold_standard/evidence/
+apps/api/docs/gold_standard/images_canary_*/*.png
+
+# Semaforo de las baterias de mutacion (tests/conftest.py). Efimero por diseno.
+.mutation-running
+
+# Token OAuth de WordPress (harness/authorize_wordpress.py). CREDENCIAL, no artefacto.
+.env.wordpress-token.json
+
+# Estado efimero de las baterias de mutacion: nunca se versiona.
+*.pristine
+.mutation-running
+.mutation.lock
+
+# Ledgers de corrida — NUNCA versionados.
+# Contienen la evidencia del CLIENTE. Git no es un almacen documental: es historial
+# permanente, replicable y sin borrado real. La verificabilidad NO justifica eso, y
+# ademas no la aporta: la URL que un motor sigue va en el propio articulo. El ledger
+# sirve para auditoria INTERNA, que es otra propiedad. Ver 2026-08-14.
+brain/00_Meta/corpus/ledgers/
+
+# Local runtime configuration and independently hosted founder review.
+/.local/
+/tools/launch-review/
+
+# Private execution evidence is retained locally; publish selected reports explicitly.
+/brain/30_Investigation/workspace-consolidation-2026-09-14/
+
+# Consolidation: preserve raw local research and test output without publishing it
+/brain/00_Meta/brain-hygiene-2026-09-14/before/
+/brain/00_Meta/corpus/aspirational-six/
+/brain/00_Meta/corpus/blind-eval-v1/
+/brain/00_Meta/corpus/blind-eval-v2/
+/brain/00_Meta/corpus/brand-portals-round-03/
+/brain/00_Meta/corpus/brand-portals-round-04/
+/brain/00_Meta/corpus/six-brands-archetypes/
+/brain/00_Meta/corpus/writer-blind-lab-protocol-v2/
+/brain/00_Meta/corpus/writer-blind-lab-protocol-v2-smoke/
+/brain/00_Meta/corpus/writer-blind-lab-v3/
+/brain/00_Meta/corpus/writer-blind-round-02/
+/brain/00_Meta/corpus/writer-blind-round-02-dry-check/
+/brain/30_Investigation/brand-portal-round-03/art-direction-live/browser/
+/brain/30_Investigation/brand-portal-round-03/art-direction-live/grammars/
+/brain/30_Investigation/brand-portal-round-03/browser-qa/
+/brain/30_Investigation/brand-portal-round-03/evidence/
+/brain/30_Investigation/brand-portal-round-03/sources/
+/brain/30_Investigation/brand-portal-round-03/system-integration-pre-signals-private/
+/brain/30_Investigation/brand-portal-round-03/system-integration-private/
+/brain/30_Investigation/brand-portal-round-03/visual-admission-pre-toc-r2-private/
+/brain/30_Investigation/brand-portal-round-03/visual-admission-private/
+/brain/30_Investigation/dogfood-publication-2026-09-14/detector-boundary-fix/before/
+/brain/30_Investigation/dogfood-publication-2026-09-14/detector-modal-stop-fix/before/
+/brain/30_Investigation/dogfood-publication-2026-09-14/publisher-independent-review/pytest-final/
+/brain/30_Investigation/dogfood-publication-2026-09-14/publisher-independent-review/pytest-tmp/
+/brain/30_Investigation/dogfood-publication-2026-09-14/publisher/reused-image-before/
+/brain/30_Investigation/dogfood-publication-2026-09-14/revalidation-adapter/
+/brain/30_Investigation/dogfood-publication-2026-09-14/runtime/
+/brain/30_Investigation/dogfood-publication-2026-09-14/site/
+/brain/30_Investigation/editorial-intake-2026-09-14/admission/
+/brain/30_Investigation/editorial-intake-2026-09-14/editorial-natural/before/
+/brain/30_Investigation/editorial-intake-2026-09-14/editorial-natural/repair-before/
+/brain/30_Investigation/editorial-intake-2026-09-14/editorial-research/.firecrawl/
+/brain/30_Investigation/editorial-intake-2026-09-14/evidence-completion/before/
+/brain/30_Investigation/editorial-intake-2026-09-14/evidence-completion/before-queue-race-repair/
+/brain/30_Investigation/editorial-intake-2026-09-14/evidence-completion/delta-files/
+/brain/30_Investigation/editorial-intake-2026-09-14/evidence-completion/session-start/
+/brain/30_Investigation/editorial-intake-2026-09-14/images/
+/brain/30_Investigation/editorial-intake-2026-09-14/intake-repair/offline_guard/
+/brain/30_Investigation/editorial-intake-2026-09-14/intake-repair/preimages/
+/brain/30_Investigation/editorial-intake-2026-09-14/intake-repair/review-repair/preimages/
+/brain/30_Investigation/editorial-intake-2026-09-14/intake-v2-review/offline_guard/
+/brain/30_Investigation/editorial-intake-2026-09-14/root-repairs/
+/brain/30_Investigation/editorial-intake-2026-09-14/runtime/
+/brain/30_Investigation/editorial-intake-2026-09-14/site/
+/brain/30_Investigation/editorial-intake-2026-09-14/sources/
+/brain/30_Investigation/editorial-intake-2026-09-14/visual-repair/
+/brain/30_Investigation/editorial-intake-2026-09-14/visual-research/.firecrawl/
+/brain/30_Investigation/ingestion-benchmark-2026-09-09/corrected-root/
+/brain/30_Investigation/ingestion-benchmark-2026-09-09/diagnosis/after/
+/brain/30_Investigation/ingestion-benchmark-2026-09-09/diagnosis/before/
+/brain/30_Investigation/ingestion-benchmark-2026-09-09/diagnosis/offline_guard/
+/brain/30_Investigation/ingestion-benchmark-2026-09-09/documents/native/
+/brain/30_Investigation/ingestion-benchmark-2026-09-09/documents/reference/
+/brain/30_Investigation/ingestion-benchmark-2026-09-09/native/
+/brain/30_Investigation/ingestion-benchmark-2026-09-09/next-intake/admission-ui-v1-preimages/
+/brain/30_Investigation/ingestion-benchmark-2026-09-09/next-intake/page-evidence-preimages/
+/brain/30_Investigation/ingestion-benchmark-2026-09-09/reference/
+/brain/30_Investigation/ingestion-benchmark-2026-09-09/site/
+/brain/30_Investigation/launch-execution-2026-09-07/company-source-baseline/
+/brain/30_Investigation/launch-execution-2026-09-08/atomic-source-instruction-v1-after/
+/brain/30_Investigation/launch-execution-2026-09-08/atomic-source-instruction-v1-before/
+/brain/30_Investigation/launch-execution-2026-09-08/atomic-source-instruction-v1-red-tests/
+/brain/30_Investigation/launch-execution-2026-09-08/body-effective-retry-v1-after/
+/brain/30_Investigation/launch-execution-2026-09-08/body-effective-retry-v1-before/
+/brain/30_Investigation/launch-execution-2026-09-08/body-effective-retry-v1-red-tests/
+/brain/30_Investigation/launch-execution-2026-09-08/citation-baseline/
+/brain/30_Investigation/launch-execution-2026-09-08/classifier-precision-baseline/
+/brain/30_Investigation/launch-execution-2026-09-08/competitor-publication-v1-after/
+/brain/30_Investigation/launch-execution-2026-09-08/competitor-publication-v1-before/
+/brain/30_Investigation/launch-execution-2026-09-08/competitor-publication-v2-after/
+/brain/30_Investigation/launch-execution-2026-09-08/competitor-publication-v2-before/
+/brain/30_Investigation/launch-execution-2026-09-08/competitor-publication-v3-after/
+/brain/30_Investigation/launch-execution-2026-09-08/competitor-publication-v3-before/
+/brain/30_Investigation/launch-execution-2026-09-08/deliverable-fix-after/
+/brain/30_Investigation/launch-execution-2026-09-08/deliverable-fix-baseline/
+/brain/30_Investigation/launch-execution-2026-09-08/deliverable-fix-v2-after/
+/brain/30_Investigation/launch-execution-2026-09-08/deliverable-independent-tests/
+/brain/30_Investigation/launch-execution-2026-09-08/editorial-handoff-baseline/
+/brain/30_Investigation/launch-execution-2026-09-08/export-completion-baseline/
+/brain/30_Investigation/launch-execution-2026-09-08/export-completion-v1-after/
+/brain/30_Investigation/launch-execution-2026-09-08/export-completion-v2-after/
+/brain/30_Investigation/launch-execution-2026-09-08/fifth-quality-after/apps/
+/brain/30_Investigation/launch-execution-2026-09-08/fifth-quality-after/src/
+/brain/30_Investigation/launch-execution-2026-09-08/fifth-quality-before/apps/
+/brain/30_Investigation/launch-execution-2026-09-08/fifth-quality-before/src/
+/brain/30_Investigation/launch-execution-2026-09-08/fifth-quality-final-red-tests/
+/brain/30_Investigation/launch-execution-2026-09-08/fifth-quality-v2-after/apps/
+/brain/30_Investigation/launch-execution-2026-09-08/fifth-quality-v2-after/src/
+/brain/30_Investigation/launch-execution-2026-09-08/fifth-quality-v3-after/apps/
+/brain/30_Investigation/launch-execution-2026-09-08/fifth-quality-v3-after/src/
+/brain/30_Investigation/launch-execution-2026-09-08/graph-handbook-anchors-v1-after/
+/brain/30_Investigation/launch-execution-2026-09-08/graph-handbook-anchors-v1-before/
+/brain/30_Investigation/launch-execution-2026-09-08/graph-handbook-anchors-v2-after/
+/brain/30_Investigation/launch-execution-2026-09-08/graph-handbook-anchors-v2-before/
+/brain/30_Investigation/launch-execution-2026-09-08/graph-source-eligibility-v1-after/
+/brain/30_Investigation/launch-execution-2026-09-08/graph-source-eligibility-v1-before/
+/brain/30_Investigation/launch-execution-2026-09-08/hero-receipt-persistence-v1-after/
+/brain/30_Investigation/launch-execution-2026-09-08/hero-receipt-persistence-v1-before/
+/brain/30_Investigation/launch-execution-2026-09-08/image-direction-baseline/
+/brain/30_Investigation/launch-execution-2026-09-08/judge-claim-scope-after/src/
+/brain/30_Investigation/launch-execution-2026-09-08/judge-claim-scope-before/
+/brain/30_Investigation/launch-execution-2026-09-08/judge-claim-scope-v2-after/src/
+/brain/30_Investigation/launch-execution-2026-09-08/judge-claim-scope-v3-after/src/
+/brain/30_Investigation/launch-execution-2026-09-08/judge-claim-scope-v4-after/src/
+/brain/30_Investigation/launch-execution-2026-09-08/judge-token-precision-baseline/
+/brain/30_Investigation/launch-execution-2026-09-08/main-release-independent-guard/
+/brain/30_Investigation/launch-execution-2026-09-08/main-release-v2-guard/
+/brain/30_Investigation/launch-execution-2026-09-08/openai-truncation-baseline/
+/brain/30_Investigation/launch-execution-2026-09-08/quality-independent-tests/
+/brain/30_Investigation/launch-execution-2026-09-08/quality-receipt-fix-baseline/
+/brain/30_Investigation/launch-execution-2026-09-08/queue-commission-after/
+/brain/30_Investigation/launch-execution-2026-09-08/reader-advice-attribution-v1-after/src/
+/brain/30_Investigation/launch-execution-2026-09-08/reader-advice-attribution-v1-before/
+/brain/30_Investigation/launch-execution-2026-09-08/reader-advice-attribution-v2-after/src/
+/brain/30_Investigation/launch-execution-2026-09-08/reader-advice-attribution-v2-before/
+/brain/30_Investigation/launch-execution-2026-09-08/review-lost-write-fixture-v1-after/
+/brain/30_Investigation/launch-execution-2026-09-08/review-lost-write-fixture-v1-before/
+/brain/30_Investigation/launch-execution-2026-09-08/review-lost-write-fixture-v1-staging/
+/brain/30_Investigation/launch-execution-2026-09-08/revise-dangling-after/
+/brain/30_Investigation/launch-execution-2026-09-08/revise-dangling-before/
+/brain/30_Investigation/launch-execution-2026-09-08/scout-discovery-provenance-v1-after/
+/brain/30_Investigation/launch-execution-2026-09-08/scout-discovery-provenance-v1-before/
+/brain/30_Investigation/launch-execution-2026-09-08/section-contract-baseline/
+/brain/30_Investigation/launch-execution-2026-09-08/seventh-quality-v1-after/
+/brain/30_Investigation/launch-execution-2026-09-08/seventh-quality-v1-before/
+/brain/30_Investigation/launch-execution-2026-09-08/seventh-quality-v2-after/
+/brain/30_Investigation/launch-execution-2026-09-08/seventh-quality-v2-before/
+/brain/30_Investigation/launch-execution-2026-09-08/seventh-quality-v3-after/
+/brain/30_Investigation/launch-execution-2026-09-08/seventh-quality-v3-before/
+/brain/30_Investigation/launch-execution-2026-09-08/slot-hero-contract-after/
+/brain/30_Investigation/launch-execution-2026-09-08/slot-hero-contract-before/
+/brain/30_Investigation/launch-execution-2026-09-08/slot-hero-contract-v2-after/
+/brain/30_Investigation/launch-execution-2026-09-08/slot-hero-contract-v2-before/
+/brain/30_Investigation/launch-execution-2026-09-08/structural-labels-baseline/
+/brain/30_Investigation/references-restoration-2026-09-14/runtime/
+/apps/api/.coverage.*
+/apps/api/tests/golden/builder_v3/

recala_cli-0.6.0/CHANGELOG.md

@@ -0,0 +1,128 @@
+# CLI changes
+
+## 0.6.0
+
+Faster, clearer and complete, and installed from PyPI.
+
+Faster
+
+- `status` asks each question once and all at the same time: about 13 s for a live company instead of about 48 s. Most of what is left is the server's publication calendar.
+- A company name after `--org` is resolved from the sign-in already read plus names remembered for a day, not one read per company: `whoami --org <name>` about 1–2 s instead of about 6 s.
+- `topics list` and `topics up-next list` read the queue in one call; `index status` reads its articles in parallel.
+
+Easier to use
+
+- `-h` works everywhere, and `--org` may come before the command (`recala --org acme status`).
+- A mistyped command names the closest real one, in the root and in every group.
+- `recala completion bash|zsh|fish` prints the tab-completion script; `recala update` installs the newest version with the tool that installed it (uv or pipx), or prints both commands.
+- Every command that writes accepts `--dry-run` and `--yes`. A dry run reads and checks everything, sends nothing and says what it would have sent (`--json`: `{"dry_run": true, "sent": false, ...}`). `--yes` still skips a prompt only for a publishing action with an API key that holds `publish`.
+- Authors and knowledge sources take the 8-character id the lists print (`authors edit`, `article person`, `autoapprove on --author`, `knowledge remove`, `knowledge admit`), like articles and topics.
+- `article list --status <state> --language <code>`: filter the list; each row marks its language and a total line closes it.
+- A command run without `--org` names the company it acted on, on stderr (never with `--json`).
+
+Clearer output
+
+- "Company" everywhere a person reads; `org`, `--org` and the `--json` keys are unchanged.
+- Any server failure reads the same: Recala had a problem on its side, try again in a minute, and where to write. The server's own words stay in `--json` (`details.server_message`). Signed out is one exit code (3) and one sentence on every command, checked before a company is asked for.
+- For a server error, `--json` `message` is now that generic sentence; the server's own text moved to `details.server_message`. Scripts that read `message` for the server's text should read `details.server_message`.
+- Plan and credit lines read for a customer: "5 articles this period, 3 included in the plan", with no "(internal)" and no "6 of 3".
+- Times are in the company's timezone everywhere, including `topics waiting-slots`, `article versions`, `article share`, `index`, `connect status`, `refresh runs` and `notifications list`.
+- A held article's findings are sentences that say what to fix, with units and bounds in words.
+- `calendar` keeps a stopped or waiting date even when it is in the past, as `plan` does; `cadence set --dry-run` merges your change over the saved cadence.
+- `questions show` names failed checks in sentences; `index status` gives Google's verdicts in words.
+- `report authority` lists its six parts under plain names.
+- `topics list` shows 20 per section with "N more: recala topics list --limit 0"; `--json` keeps every row.
+- `authors list` prints the 8-character id, like `knowledge list` and `company show`.
+- `bing data`, `gsc data` and `report monthly` say "1 click" and "1 impression".
+- `connect sitemap` and `cms status` are hidden from help (`index sitemaps show` and `connect status` show the same); both still work.
+
+New commands
+
+- `company languages show|add|remove`: the extra languages that start translations (one past the company's limit is refused before anything is sent).
+- `company profile show`: the company's default author, voice, positioning and default intent.
+- `notifications list` and `notifications read <id>|--all`: what the portal's bell shows.
+- `report monthly [--month YYYY-MM]` shows the client report; `report monthly share` makes a link anyone can read, after you confirm.
+- `refresh show`: the company's auto-refresh setting, what is due and what it cost this month. `refresh pause <article>` and `refresh resume <article>` stop or restart it for one article; `refresh runs <id>` follows one run. The company-wide switch stays in the portal.
+- `knowledge admit <source>`: admit a ready source for use in articles (`--as own|proposed|researched`).
+- `billing invoices`: the company's invoices, with a portal link for payment changes.
+
+Install
+
+- Published on PyPI as `recala-cli`: `uv tool install recala-cli` or `pipx install recala-cli`. Releases are built and published from a `cli-v*` tag by trusted publishing.
+
+Google Search Console's numbers from the terminal.
+
+- `gsc data`: the stored totals, top queries and top pages over Google's final days, like `bing data`. A company that is not connected, must reconnect or has no data yet gets that in words, never a zero. `--json` carries every field.
+
+Bing Webmaster Tools from the terminal.
+
+- `connect bing`: Microsoft sign-in in the browser, then choose the site.
+- `bing status`, `bing sites`, `bing use` and `bing data`: how fresh the numbers are, which sites are verified, which one is the company's, and the stored totals, top queries and top pages. `--json` carries every field.
+
+A date that stopped and waits for a person can take another topic.
+
+- `topics waiting-slots`: the dates waiting for a person, why each stopped, and the Up next topics they may take.
+- `topics replace-slot <slot> <topic>`: put one of those topics on the date. Owners and editors, signed in as themselves; API keys are refused. `calendar` names the command on such a date.
+
+## 0.5.3
+
+Holds, re-runs and costs in plain words, one id that works everywhere, payment links, Sanity article schemas, and the onboarding fixes from the FundsEarth dogfood (#716, #915, #927, #929). Version 0.5.2 was never published, so this release also carries everything in the 0.5.2 section below.
+
+- A held article reads as plain sentences: its title, why (one numbered finding per line), the other reasons, the last check and one next step with the 8-character id. A hold with no explanation asks you to contact support instead of printing a raw code. `--json` output is unchanged.
+- Cost previews and refusals are sentences that name the command that fixes them. A held article's promised free re-run is called a "free re-run" on every plan; a plan credit reads "uses 1 of your plan's articles".
+- `article regenerate`: a re-run the writer refuses now says it was refused, why, what still holds the draft and one next step (exit 6; `--json` carries the details). A refusal for a missing author points at `recala article person`, a run already in progress says to wait, and a daily research stop keeps its reset time. `article status` adds "Last re-run: ..." when one stopped.
+- The 8-character article id the CLI prints works in every article command, including `index`. A malformed id is refused before any request is sent.
+- `article recheck` prints each stopped finding on its own line, prints the refusal header once, and says "1 finding" in the singular.
+- `article approve --read` shows the current text and records that you read it before approving. `--reconfirm-current` refreshes the approval of an already-approved original (human session only).
+- `article create` and `article regenerate` treat a skipped CMS push (auto-publish off) as a normal result: "Ready for review; not pushed to the CMS". `article share --review-link` prints the full review URL, and a disabled review link says why.
+- Add `autoapprove faithful-translations show|enable|disable` (owners; `enable` and `disable` take `--dry-run`): opt in to auto-approving verified translations of articles a person approved (#915). Ordinary auto-approve must also be on.
+- Add `billing link --plan <plan>` (owners): a 30-day payment link for whoever pays, bound to your company. It works once payment links are enabled for the company (#927).
+- Add `authors edit <id>` (owners) to change an author's name, role, bio, links, LinkedIn or expertise; only the fields you pass change.
+- `connect sanity` and `cms connect --provider sanity` accept `--schema-profile post|article` (asked when interactive; default `post`). `status` shows the connected Sanity project, and falls back to the site address when Sanity cannot be read.
+- `connect status` no longer fails when Search Console is not connected; the sitemap is simply not shown.
+- `topics add` puts a manual topic at the top of Up next, prints its title and position, and recovers a half-finished reorder.
+- `calendar` and `plan` say when a day stopped because no topic in the queue has enough of the company's own material, and to answer the material questions or add sources.
+- `company scan` reports what it found instead of "Saved what Recala found" over nothing, and reads a company's catalogue, self-description and palette from its site. A service business's services are saved as its products. AI-overview sources that cannot be read are named as such instead of "other".
+- `company create` says which company is now active and how to switch back; `--no-use` keeps the current one (and no longer claims one is active when there is none).
+- Onboarding previews honour the one free article per email and block a run the gate would refuse; payment hints name `recala billing link`; a deleted company is never switched back to.
+- `credits` and `status` say extras past the allowance are refused (not "comped") for a company without overflow.
+- `topics why` hides empty fields and says what to upload, and with which command, when a topic waits for company material. `knowledge add-url` prints why a page was not added.
+- `--help` lists `company` and `authors` once (`org` and `author` remain aliases), and every command's first sentence fits the help column.
+
+## 0.5.2
+
+Correct published articles from the CLI, and read every status view in plain language (#691, #701).
+
+- Add `article republish` (with `--dry-run`): sends a corrected article to your site, updating its page or publishing it if it has none. It asks first; a held or unapproved article is refused with the next step.
+- `status` shows questions as "N tracked of M allowed" and AI engines by name; `credits` shows the question allowance as "up to N".
+- Times in `status`, `questions`, `calendar` and `topics why` are in the company's timezone; when none is set, "timezone not set; times in UTC" is said once instead of a bare UTC.
+- `questions` lists the tracked questions by area with each engine's latest result; `--all` shows them all.
+- `topics list`, `topics up-next list` and `org list` put the name first and an 8-character id second. Topic commands and `article create --topic` accept that short id, so a copied short id no longer reaches the API as an invalid id.
+- `topics why` prints plain labels instead of internal codes.
+
+## 0.5.1
+
+Fixes the calendar and plan views after the 0.5.0 autopilot work (#683).
+
+- `calendar` shows autopilot publication slots in your local time with plain states, and names the recovery command when a slot needs attention.
+- `plan` shows local times and plain states instead of UTC and internal states.
+- A slot is shown once, beside its appointment, instead of twice.
+
+## 0.5.0
+
+Builds on resumable agent onboarding (#664).
+
+- Reset/interrupted article runs exit 9 immediately with the exact restart command. Failed runs retain their failure code and reason in human output.
+- Preview session and API-key re-runs before confirmation: free re-run or EUR 19. Missing/mismatched cost previews and changed charges require fresh confirmation (exit 10); `--yes` keeps the existing grant rules.
+- JSON calendar responses always include `slots` (an empty list when no cadence slots exist), and `timezone` uses the cadence timezone when available.
+- Published runs say published. Continuing runs and daily research-limit refusals no longer advertise a blind retry.
+- Start article creation asynchronously, wait through short status requests, detach with Ctrl-C or `--no-wait`, and resume with `article run`. Held/failed outcomes use exit 6; daily research allowance stops use exit 8.
+- Add `article regenerate` and `article recheck` with named confirmation, server eligibility, charge mode and clear results. Draft approval names `article submit`; schedule previews honor `--tz`.
+- Refresh expired sessions silently and explain re-login when needed. Refuse legacy credentials before an ineffective all-write grant.
+- Name topics, articles and signers in human output, including pipes. List companies name-first and articles with dates. Keep topic rationale readable.
+- Add `topics up-next list|add|remove|move`; approval explains the next step. Fetch all visible topic pages consistently for humans and JSON.
+- Show cadence slots and publication times in the cadence timezone. Preserve failed-slot reasons and explain blocked autopilot, without duplicating the next onboarding action.
+- Keep onboarding completion retry commands executable and clear obsolete saved failures. Guard cadence and auto-approval consent writes. Preserve refusal recovery under `python -m recala_cli`.
+- Check the existing release pointer once per day for human upgrade notices. Explain disabled API keys by API error code.
+
+The spinner is unchanged (D1 belongs to #669). API hold-detail language and the portal's unknown-hold mapping remain API/portal follow-ups; the CLI retains the supplied code, detail and applicable recovery command.

recala_cli-0.6.0/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.5
+Name: recala-cli
+Version: 0.6.0
+Summary: Drive your Recala company from the terminal, by hand or through an AI agent.
+Project-URL: Homepage, https://recala.co
+Project-URL: Documentation, https://recala.co/developers
+Author: Recala
+Keywords: ai-agents,articles,cli,content,recala
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Requires-Dist: click>=8.1
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest>=8.3; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Recala CLI
+
+Drive your Recala company from the terminal, by hand or through an AI agent.
+Everything the portal does for articles, topics, authors and publishing is a command.
+
+## Install
+
+```
+uv tool install recala-cli
+```
+
+or
+
+```
+pipx install recala-cli
+```
+
+Upgrade with `recala update`, or `uv tool upgrade recala-cli`.
+
+## Sign in
+
+```
+recala login
+```
+
+This opens your browser once. After that, `recala company list` shows your companies and
+`recala company use <name>` picks the one the next commands act on.
+
+## Three examples
+
+```
+recala status
+recala article list
+recala --org "My Company" credits
+```
+
+Add `--json` to any command for output an agent can read. `recala --help` lists every command;
+`recala completion zsh` prints shell completion.
+
+Documentation: https://recala.co/developers

recala_cli-0.6.0/README.md

@@ -0,0 +1,40 @@
+# Recala CLI
+
+Drive your Recala company from the terminal, by hand or through an AI agent.
+Everything the portal does for articles, topics, authors and publishing is a command.
+
+## Install
+
+```
+uv tool install recala-cli
+```
+
+or
+
+```
+pipx install recala-cli
+```
+
+Upgrade with `recala update`, or `uv tool upgrade recala-cli`.
+
+## Sign in
+
+```
+recala login
+```
+
+This opens your browser once. After that, `recala company list` shows your companies and
+`recala company use <name>` picks the one the next commands act on.
+
+## Three examples
+
+```
+recala status
+recala article list
+recala --org "My Company" credits
+```
+
+Add `--json` to any command for output an agent can read. `recala --help` lists every command;
+`recala completion zsh` prints shell completion.
+
+Documentation: https://recala.co/developers

recala_cli-0.6.0/pyproject.toml

@@ -0,0 +1,46 @@
+[project]
+name = "recala-cli"
+version = "0.6.0"
+description = "Drive your Recala company from the terminal, by hand or through an AI agent."
+readme = "README.md"
+authors = [{ name = "Recala" }]
+keywords = ["recala", "cli", "content", "articles", "ai-agents"]
+classifiers = [
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+requires-python = ">=3.11"
+# click is what Typer is built on; using it directly keeps the dependency list to two
+# libraries the API already locks (apps/api/uv.lock), so the CLI adds nothing new.
+dependencies = [
+    "click>=8.1",
+    "httpx>=0.27",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8.3"]
+
+[project.urls]
+Homepage = "https://recala.co"
+Documentation = "https://recala.co/developers"
+
+[project.scripts]
+recala = "recala_cli.main:cli"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/recala_cli"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+addopts = "-q --strict-markers"

recala_cli-0.6.0/scripts/check-dogfood.sh

@@ -0,0 +1,87 @@
+#!/usr/bin/env bash
+# Reproduce the local handoff gates without git writes or a real CLI profile.
+set -euo pipefail
+repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)"
+cd "$repo_root"
+check_scratch="$(mktemp -d)"
+trap 'rm -rf "$check_scratch"' EXIT
+export HOME="$check_scratch" RECALA_CONFIG_DIR="$check_scratch/config"
+export PYTHONPATH="$repo_root/src:$repo_root/apps/api"
+export RECALA_NO_UPDATE_CHECK=1 ASTRO_TELEMETRY_DISABLED=1
+export SENTRY_AUTH_TOKEN='' PUBLIC_SENTRY_DSN='' SENTRY_DSN=''
+export RECALA_CLI_CMD='python3 -m recala_cli'
+api_python="${RECALA_API_TEST_PYTHON:-$repo_root/apps/api/.venv/bin/python}"
+if [[ ! -x "$api_python" ]]; then
+  printf 'Set RECALA_API_TEST_PYTHON to the Python executable with the API test dependencies.\n' >&2
+  exit 2
+fi
+run_check() {
+  printf 'CHECK '
+  printf '%q ' "$@"
+  printf '\n'
+  if "$@"; then
+    printf 'EXIT=0\n'
+  else
+    check_rc=$?
+    printf 'EXIT=%s\n' "$check_rc"
+    return "$check_rc"
+  fi
+}
+(
+  cd apps/cli
+  run_check pytest -q -o addopts=--strict-markers
+)
+api_tests=(apps/api/tests/unit/routers apps/api/tests/unit/api_keys apps/api/tests/test_cli_calls_only_routes_the_api_serves.py apps/api/tests/integration/test_regenerate_endpoint.py apps/api/tests/test_regenerate_handler_parity.py)
+while IFS= read -r test_file; do
+  api_tests+=("$test_file")
+done < <(rg -l 'generate_from_queue|/generate/from-queue|/api/v1/runs/|get_run_state' apps/api/tests --glob 'test*.py' | sort -u)
+run_check "$api_python" -m pytest -q "${api_tests[@]}"
+changed_python=(
+  apps/api/src/routers/generate.py
+  apps/api/src/routers/keys.py
+  apps/api/src/routers/ops.py
+  apps/api/tests/unit/authority/test_commission_identity_guard.py
+  apps/cli/src/recala_cli/auth.py
+  apps/cli/src/recala_cli/client.py
+  apps/cli/src/recala_cli/commands/article.py
+  apps/cli/src/recala_cli/commands/auth.py
+  apps/cli/src/recala_cli/commands/cadence.py
+  apps/cli/src/recala_cli/commands/onboard.py
+  apps/cli/src/recala_cli/commands/org.py
+  apps/cli/src/recala_cli/commands/reads.py
+  apps/cli/src/recala_cli/commands/status.py
+  apps/cli/src/recala_cli/commands/topics.py
+  apps/cli/src/recala_cli/confirm.py
+  apps/cli/src/recala_cli/endpoints.py
+  apps/cli/src/recala_cli/errors.py
+  apps/cli/src/recala_cli/human.py
+  apps/cli/src/recala_cli/labels.py
+  apps/cli/src/recala_cli/onboarding.py
+  apps/cli/src/recala_cli/organizations.py
+  apps/cli/src/recala_cli/runtime.py
+  apps/cli/src/recala_cli/views.py
+  apps/cli/tests/conftest.py
+  apps/cli/tests/test_agent_onboarding.py
+  apps/cli/tests/test_cadence.py
+  apps/cli/tests/test_connect_and_status.py
+  apps/cli/tests/test_content_commands.py
+  apps/cli/tests/test_human_readable.py
+  apps/cli/tests/test_machine_contract.py
+  apps/cli/tests/test_org.py
+  apps/cli/tests/test_org_readable.py
+  apps/cli/tests/test_review_hardening.py
+  apps/cli/src/recala_cli/article_runs.py
+  apps/cli/src/recala_cli/updates.py
+  apps/cli/tests/test_dogfood_fixes.py
+  apps/cli/tests/test_c2_onboarding.py
+  apps/api/tests/test_cli_async_generation.py
+  apps/api/tests/integration/test_regenerate_endpoint.py
+  apps/api/tests/unit/routers/test_api_keys_served.py
+)
+run_check ruff check --config apps/cli/pyproject.toml "${changed_python[@]}"
+run_check git diff --check
+cd apps/web
+run_check npm run docs:cli:check
+run_check npx --no-install vitest run src/lib src/components/developers
+# Includes onboarding checks, SSR externals, bundle budget and CLI release gate.
+run_check npm run build