-
Notifications
You must be signed in to change notification settings - Fork 0
Phase 0 Execution Backlog
This backlog converts the Phase 0 outcome into ordered, reviewable work packages. Status reflects the repository at the start of Phase 0 and is updated as work is completed.
flowchart LR
Docs["P0-001 Documentation"] --> Tools["P0-002 Toolchain"]
Tools --> Hygiene["P0-003 Repository hygiene"]
Hygiene --> Workspace["P0-004 Monorepo"]
Workspace --> Web["P0-005 Next.js shell"]
Workspace --> UI["P0-006 Shared UI"]
UI --> Desktop["P0-007 Tauri shell"]
Workspace --> Contracts["P0-008 Contracts"]
Contracts --> Identity["P0-009 Identity skeleton"]
Web --> Telemetry["P0-010 Telemetry"]
Desktop --> Telemetry
Contracts --> CI["P0-011 CI and security"]
Telemetry --> Validation["P0-012 Foundation validation"]
CI --> Validation
Identity --> Validation
Status: Local source complete; hosted Wiki blocked by private-repository feature availability
Deliver:
- StackCendra README;
- versioned Wiki source and hosted GitHub Wiki;
- product, architecture, security, data, quality, and roadmap pages;
- initial ADRs;
- terminology and release 0.1 acceptance criteria.
Accept when:
- internal links validate;
- README contains no Lovable identity;
- hosted Wiki and
docs/wikimatch; - open decisions and risks are visible.
Status: Installed; Docker first-launch verification pending
Deliver:
- Node.js 24 LTS;
- pnpm 10 through Corepack;
- Rust stable MSVC, rustfmt, and clippy;
- Docker Desktop with Compose v2 and WSL 2 backend;
- verified Git, Visual C++ tools, WebView2, and WSL;
- recorded exact versions.
Accept when:
- verification commands succeed from a fresh terminal;
- Docker engine can run a disposable hello-world container after the user reviews its agreement;
- no unsupported Node runtime remains active.
Status: Planned
Deliver:
- remove obsolete Lovable metadata and packages;
- choose and enforce the pnpm lockfile;
- add license decision, contribution guidance, code of conduct if public collaboration begins, and security policy;
- define branch, commit, changelog, and release conventions;
- add editor configuration and safe ignores.
Accept when:
- repository identity is consistently StackCendra;
- no conflicting JavaScript lockfiles remain;
- dependency and ownership policies are documented.
Status: Planned
Deliver:
-
pnpm-workspace.yaml; - root package metadata and pinned package manager;
-
apps,packages, and active language directories; - shared TypeScript, lint, and formatting policies;
- root validation commands;
- dependency-boundary checks.
Accept when:
- a clean checkout installs with a frozen lockfile;
- root validation discovers every active package;
- inactive future services are not scaffolded merely to fill the tree.
Status: Planned
Deliver:
- Next.js 16.2 Active LTS application using App Router;
- root layout, error boundaries, metadata, and product routes;
- query and client-state boundaries;
- authenticated-shell placeholder without selecting a provider prematurely;
- preserved useful prototype views.
Accept when:
- the application runs through documented commands;
- routes match the release 0.1 information architecture;
- no Vite or React Router runtime dependency remains in the web shell;
- current security patches are pinned.
Status: Planned
Deliver:
- shared UI package and design tokens;
- accessible navigation, forms, tables, graphs, status, and evidence components;
- product terminology applied throughout;
- future sprint/video features removed from primary navigation.
Accept when:
- web and desktop can consume the same components;
- keyboard and screen-reader checks pass for the foundation shell;
- mock state is clearly labeled and isolated.
Status: Planned
Deliver:
- Tauri 2 application;
- explicit command allowlist;
- safe window, update, deep-link, tray, notification, and storage policies;
- desktop-compatible shared UI entry;
- development signing and capability configuration.
Accept when:
- Tauri runs using the Rust stable MSVC toolchain;
- a harmless version command crosses the typed IPC boundary;
- unregistered commands are denied;
- web builds contain no privileged desktop bridge.
Status: Planned
Deliver:
- identifier, error, pagination, evidence, event, and audit conventions;
- representative OpenAPI, Protocol Buffer, and JSON Schema contracts;
- schema validation and compatibility tests;
- generated-client policy.
Accept when:
- active languages validate representative messages;
- breaking contract changes fail CI;
- secret fields are classified explicitly.
Status: Planned
Deliver:
- organization, user, membership, device, project, repository, service, and environment models;
- development-only device-pairing flow;
- authorization interfaces without premature enterprise features;
- audit-event persistence path.
Accept when:
- a development user can create an organization and project and pair one device;
- tenant isolation and denial paths are tested;
- no production authentication claim is made.
Status: Planned
Deliver:
- OpenTelemetry initialization;
- trace and correlation propagation;
- structured logging and redaction;
- local collector profile;
- baseline metrics for active components.
Accept when:
- a representative web request and desktop command are traceable;
- secrets and high-cardinality paths are absent from exported telemetry;
- telemetry failure does not break product behavior.
Status: Planned
Deliver:
- formatting, linting, type checking, tests, and contract validation;
- secret scanning and dependency review;
- artifact provenance and SBOM plan;
- Windows and Linux matrices for active components;
- cache policy that does not compromise reproducibility.
Accept when:
- required checks block an intentionally failing change;
- fixture tests run on supported platforms;
- release artifacts can be traced to source and workflow.
Status: Planned
Deliver:
- clean-machine setup rehearsal;
- Phase 0 demonstration;
- documentation reconciliation;
- risk and decision review;
- release 0.1 kickoff checklist.
Accept when:
- every Phase 0 exit criterion has linked evidence;
- unresolved questions do not block release 0.1;
- setup works from the documented commands;
- the project makes no claim unsupported by running behavior.
- Work packages are completed in dependency order unless a documented reason permits parallel work.
- Each package ends with evidence, not only changed files.
- Product, security, and contract documentation changes accompany implementation.
- A work package may be split into issues, but its acceptance criteria remain stable unless a decision record changes them.
- Tool or framework upgrades during Phase 0 are explicit changes, not incidental lockfile movement.
StackCendra is currently in Phase 0. The complete Phase 0–13 plan is versioned in the main repository under docs/wiki; later-phase pages describe intended behavior, not current implementation.
- Phase 0 foundation
- Phase 0 backlog
- Release 0.1 discovery
- Phase delivery framework
- Roadmap
- Wiki review guide
- Risks and decisions