[P1][Plan 4] SF-035 — Retire the divergent Python FastAPI product architecture

[Ankit6149]

Confirmed problem

The repository contains the active Next.js product and a separate Python FastAPI “SignalFlow Model Stub” with local generation defaults, stub post/presentation generation, and its own launch pipeline. Python CI can pass while validating an older product that users do not run.

Scope

• Declare the Next.js web application and its shared services as the canonical product.
• Inventory Python modules, tests, workflows, docs, and consumers.
• Port any uniquely valuable logic into shared canonical services only when justified.
• Archive or remove the divergent stub application and its production claims.
• Update CI so every required check proves the active product.

Acceptance criteria

• The repository has one documented product architecture.
• No stub generator or parallel launch pipeline is represented as production functionality.
• CI failures/successes correspond to the active web/MCP product.
• Any retained Python tooling has a narrow explicit role and does not duplicate product APIs.
• Setup and contribution docs no longer direct developers into two products.

Required verification

• Dependency/reference inventory before deletion.
• Clean-clone tests and build after consolidation.
• CI workflow review proving all jobs have product value.
• Public documentation truth check.