docs(14-04): complete analysis orchestration and API plan

This commit is contained in:
curo1305
2026-06-23 15:54:49 +02:00
parent ba48d625dd
commit 1ae9930ca7
3 changed files with 248 additions and 7 deletions
+8 -4
View File
@@ -6,14 +6,14 @@ current_phase: 14
current_phase_name: selective-analysis-and-byte-cache
status: in_progress
stopped_at: Phase 14 Plan 02 complete
last_updated: "2026-06-23T13:36:12.544Z"
last_updated: "2026-06-23T13:54:37.493Z"
last_activity: 2026-06-23
last_activity_desc: Phase 14 Plan 02 schema + service helpers complete
progress:
total_phases: 6
completed_phases: 3
total_plans: 30
completed_plans: 24
completed_plans: 25
percent: 50
---
@@ -26,7 +26,7 @@ progress:
## Current Position
Phase: 14 (selective-analysis-and-byte-cache) — IN PROGRESS
Plan: 4 of 9
Plan: 5 of 9
Status: Plans 14-01 and 14-02 complete. Next: execute 14-03 (analysis API)
Last activity: 2026-06-23 — Phase 14 Plan 02 schema + service helpers complete
@@ -65,6 +65,7 @@ Last activity: 2026-06-23 — Phase 14 Plan 02 schema + service helpers complete
| Phase 14 P01 | 15m | 2 tasks | 5 files |
| Phase 14 P02 | 12m | 2 tasks | 5 files |
| Phase 14 P03 | 14m | - tasks | - files |
| Phase 14 P04 | 12m | 2 tasks | 4 files |
## Accumulated Context
@@ -112,7 +113,7 @@ _Updated at each phase transition._
| Field | Value |
|---|---|
| Last session | 2026-06-23T13:34:48.853Z |
| Last session | 2026-06-23T13:52:54.296Z |
| Next action | Execute 14-03 (analysis API router) |
| Pending decisions | None |
| Resume file | .planning/phases/14-selective-analysis-and-byte-cache/14-03-PLAN.md |
@@ -151,3 +152,6 @@ _Updated at each phase transition._
- [Phase ?]: [Phase 14 P03]: retain_or_reuse_cache_entry reactivates evicted rows — unique constraint prevents duplicate insert for same version_key
- [Phase ?]: [Phase 14 P03]: api/cloud/analysis.py as aggregator router so Plan 01 RED tests can import before all routes implemented
- [Phase ?]: [Phase 14 P03]: CacheStatusOut enforces T-14-02/T-14-08 by design — object_key absent at type level
- [Phase ?]: Phase 14 P04: estimate_scope uses durable cloud_items metadata only (T-14-04)
- [Phase ?]: Phase 14 P04: live_metadata_changed flag bypasses already-current fallback when provider confirms etag changed
- [Phase ?]: Phase 14 P04: AnalysisJobOut per-stage counts always int (never None)