-
Notifications
You must be signed in to change notification settings - Fork 0
Flagship Demonstration
Keshav edited this page Jul 29, 2026
·
1 revision
The portfolio demonstration proves a complete engineering story rather than presenting disconnected screens. It evolves with each release and remains reproducible in CI and on a demonstration machine.
The maintained application contains:
- Next.js storefront;
- NestJS checkout service;
- Go inventory service;
- Python recommendation service;
- Java payment mock;
- PostgreSQL;
- Redis;
- Docker Compose;
- Kubernetes manifests;
- OpenTelemetry instrumentation.
The fixture intentionally contains versioned incident scenarios. Every scenario documents its trigger, expected signals, safe remediation, and regression verification.
- The desktop agent discovers the repository.
- It identifies application and data services with evidence.
- StackCendra generates a local environment proposal.
- Configuration analysis identifies required values.
- A change introduces
ANALYTICS_DATABASE_URL. - Git analysis associates the requirement with the analytics worker.
- Production lacks the required configuration reference.
- Deployment readiness falls and promotion is blocked.
- The user synchronizes the configuration schema and creates a secret reference.
- Connectivity and policy checks pass.
- Deployment progresses through testing and staging.
- A production canary raises error rate and latency.
- StackCendra correlates the incident with a timeout change.
- The system recommends restoring the last validated timeout.
- Authorized users approve the action.
- A constrained runner performs the rollback.
- Health gates verify recovery.
- StackCendra creates a sanitized local reproduction of the original failure.
- A regression test and postmortem draft are generated.
- The complete evidence and approval timeline remains in the audit trail.
| Release | Demonstrated section |
|---|---|
| 0.1 | Repository and service discovery |
| 0.2 | Local environment generation and startup |
| 0.3 | Missing-variable detection and readiness block |
| 0.4 | Authorized connection to a demonstration VM |
| 0.5 | Repeatable remote validation action |
| 0.6 | Health-gated canary and rollback |
| 0.7 | Change and pull-request correlation |
| 0.8 | Runtime topology and health |
| 0.9 | Evidence-backed incident hypothesis |
| 1.0 | Sanitized production-to-local reproduction |
| 1.1 | Collaborative approval and postmortem |
The demonstration must:
- run from a documented clean state;
- use deterministic scenario seeds;
- show source evidence for inferred facts;
- expose uncertainty and conflicting evidence;
- avoid real customer data and production credentials;
- produce a machine-readable result report;
- preserve traces and audit references;
- fail clearly if a prerequisite is missing.
The demonstration should let a reviewer see:
- a secure Rust desktop and local systems component;
- an advanced Next.js and TypeScript product interface;
- a concurrent Go infrastructure control plane;
- an evidence-driven Python intelligence service;
- cross-language contracts and PostgreSQL data design;
- Docker, Kubernetes, Git, cloud, SSH, and OpenTelemetry integration;
- durable, approval-based automation;
- explicit security and human-control boundaries.
Technologies appear only when they own a necessary responsibility in the scenario.
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