Skip to content

docs(planning): TARGET_ARCHITECTURE v3 drift review - #4405

Merged
vybe merged 2 commits into
devfrom
docs/target-architecture-refresh
Nov 11, 2026
Merged

vybe merged 2 commits into
devfrom
docs/target-architecture-refresh

Conversation

@trinity-ability

Copy link
Copy Markdown
Contributor

What

A drift review of docs/planning/TARGET_ARCHITECTURE.md against dev at 13d32e22f. No change of direction; the pull-coordination model is untouched.

1. Stale facts corrected

2. "Decisions That Stand but Are Not Yet Honoured" — a new table under "What Does Not Change". The three-layer rule, the single Axios instance, models.py and the WebSocket client are kept as decisions, with the measured gap beside each.

3. "Proposed Targets (v3 draft — not adopted)" — five targets the doc did not have: non-blocking request path, one owner for the terminal transition, failure distinguishable from empty, versioned contracts, frontend data layer. The section says it binds nothing until each target is accepted or cut. This is the part that needs a decision in review.

4. PULL_MIGRATION_STATUS.md — Phase 4 (#2532) is merged, not in review. Nothing else in that file was re-verified, and the file says so.

Not done

  • No tracking issue; this PR has none to close.
  • CLAUDE.md's Memory Files row still describes the doc as v2.
  • Counts in the new table are grep-based and approximate.

Verification

Docs only. Each "today" fact was checked by grep on 13d32e22f. No test references either file, and the diff has no hits against the enterprise-docs guard pattern.

🤖 Generated with Claude Code

Corrects facts that no longer match dev: PostgreSQL is the default and
the images refuse SQLite (#4233), the database driver is synchronous
SQLAlchemy over psycopg2, the scheduler job store is in-memory, trigger
idempotency uses the idempotency_keys table, and the runtime is
pluggable. Open Question 2 is marked resolved.

Adds a table of decisions that stand but that the code does not yet
honour, and a Proposed Targets section (not adopted, not binding).

PULL_MIGRATION_STATUS: Phase 4 (#2532) is merged, not in review.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
This was referenced Nov 9, 2026
…king issues

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>

@vybe vybe left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

merge-train: batch validated on train/20261110-2234 (#4454, all checks green)

@vybe
vybe merged commit 446614b into dev Nov 11, 2026
25 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants