Skip to content

Commit 2d6ab06

Browse files
committed
feat: establish cas platform v0.1 foundation
0 parents  commit 2d6ab06

36 files changed

Lines changed: 1112 additions & 0 deletions

.github/CODEOWNERS

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
* @OgeonX-Ai
2+
/.github/ @OgeonX-Ai
3+
/infra/ @OgeonX-Ai
4+
/scripts/ @OgeonX-Ai
5+
/docs/threat-model.md @OgeonX-Ai

.github/pull_request_template.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
## Outcome
2+
3+
## Security and operational impact
4+
5+
## Validation
6+
7+
- [ ] `./scripts/validate.ps1`
8+
- [ ] Azure what-if reviewed when infrastructure behavior changes
9+
- [ ] No secrets or tenant-specific values committed
10+
- [ ] Documentation and threat model updated
11+

.github/workflows/validate.yml

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
name: Validate platform
2+
3+
on:
4+
pull_request:
5+
push:
6+
branches: [main]
7+
8+
permissions:
9+
contents: read
10+
11+
concurrency:
12+
group: validate-${{ github.workflow }}-${{ github.ref }}
13+
cancel-in-progress: true
14+
15+
jobs:
16+
validate:
17+
runs-on: windows-latest
18+
timeout-minutes: 15
19+
steps:
20+
- name: Checkout
21+
uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
22+
with:
23+
persist-credentials: false
24+
25+
- name: Validate
26+
shell: pwsh
27+
run: ./scripts/validate.ps1
28+

.gitignore

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
.azure/
2+
.bicep/
3+
.tmp/
4+
*.local.bicepparam
5+
*.whatif.json
6+
*.whatif.txt
7+

.planning/PROJECT.md

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
# CAS Platform
2+
3+
## What This Is
4+
5+
CAS Platform is the Azure deployment and observability foundation for the
6+
Coding Autopilot System portfolio. It gives AI-native development workloads a
7+
repeatable, environment-isolated, identity-first platform that can be reviewed
8+
and validated safely before any Azure deployment.
9+
10+
## Core Value
11+
12+
An operator can confidently understand and validate a secure CAS Azure
13+
environment before deploying it.
14+
15+
## Requirements
16+
17+
### Validated
18+
19+
(None yet - ship to validate)
20+
21+
### Active
22+
23+
- [ ] Provision environment-isolated Azure foundations from reusable Bicep.
24+
- [ ] Use system-assigned managed identity and no embedded secrets.
25+
- [ ] Provide centralized telemetry, cost controls, tags, and safe what-if.
26+
- [ ] Publish architecture, threat model, operations, and contribution evidence.
27+
28+
### Out of Scope
29+
30+
- Automatic Azure deployment - v0.1 stops at safe validation and what-if.
31+
- Workload business logic - owned by CAS workload repositories.
32+
- Static credentials - managed identity is mandatory.
33+
- Shared production networking - requires explicit landing-zone decisions.
34+
35+
## Context
36+
37+
The CAS portfolio needs a credible production platform connecting its
38+
orchestration and reference-product repositories. This repository owns Azure
39+
infrastructure definitions and operational proof, not application execution or
40+
developer workstation setup.
41+
42+
## Constraints
43+
44+
- **Identity**: System-assigned managed identities and least privilege only.
45+
- **Secrets**: No secrets, keys, or tokens in templates, parameters, or outputs.
46+
- **Compute**: Container Apps for container workloads; Flex Consumption Linux
47+
for future event-driven Functions where appropriate.
48+
- **Safety**: No Azure resources may be deployed during v0.1 implementation.
49+
- **Portability**: One module graph must support dev, test, and production.
50+
51+
## Key Decisions
52+
53+
| Decision | Rationale | Outcome |
54+
|----------|-----------|---------|
55+
| Subscription-scope orchestrator | Creates isolated resource groups consistently | Pending |
56+
| Container Apps for v0.1 compute | Fits containerized CAS services and managed identity | Pending |
57+
| Azure Monitor diagnostics without shared keys | Preserves no-secret requirement | Pending |
58+
| Deployment workflow deferred | Identity and approvals must be designed first | Pending |
59+
60+
## Evolution
61+
62+
This document evolves at phase transitions and milestone boundaries. After each
63+
phase, requirements and decisions are updated from verification evidence.
64+
65+
---
66+
*Last updated: 2026-06-11 after initialization*
67+

.planning/REQUIREMENTS.md

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
# Requirements: CAS Platform
2+
3+
**Defined:** 2026-06-11
4+
**Core Value:** An operator can confidently understand and validate a secure CAS Azure environment before deploying it.
5+
6+
## v1 Requirements
7+
8+
### Infrastructure
9+
10+
- [x] **INFRA-01**: Operator can build one subscription-scope Bicep entrypoint.
11+
- [x] **INFRA-02**: Operator can select isolated dev, test, or prod parameters.
12+
- [x] **INFRA-03**: Operator receives deterministic naming and mandatory tags.
13+
- [x] **INFRA-04**: Operator can host a container workload in Container Apps.
14+
15+
### Security
16+
17+
- [x] **SEC-01**: Workload uses a system-assigned managed identity.
18+
- [x] **SEC-02**: Templates and parameters contain no credentials or secrets.
19+
- [x] **SEC-03**: Public workload ingress is disabled by default.
20+
- [x] **SEC-04**: Repository publishes a threat model and security policy.
21+
22+
### Operations
23+
24+
- [x] **OPS-01**: Operator receives Log Analytics and Application Insights.
25+
- [x] **OPS-02**: Workload diagnostics route to Log Analytics.
26+
- [x] **OPS-03**: Operator can configure an optional environment budget.
27+
- [x] **OPS-04**: Operator can run a non-deploying Azure what-if.
28+
29+
### Quality
30+
31+
- [x] **QUAL-01**: Contributor can run Bicep and parameter validation locally.
32+
- [x] **QUAL-02**: Repository enforces infrastructure contract tests.
33+
- [x] **QUAL-03**: Repository documents architecture, operations, and contribution flow.
34+
- [x] **QUAL-04**: CI runs validation with least-privilege repository permissions.
35+
36+
## v2 Requirements
37+
38+
- **NET-01**: Operator can enable private networking and controlled egress.
39+
- **GOV-01**: Operator can apply Azure Policy and compliance reporting.
40+
- **DEL-01**: Authorized workload identity can promote reviewed infrastructure.
41+
- **OBS-01**: Operator receives SLO alerts, dashboards, and incident routing.
42+
- **SUP-01**: Releases include SBOM, signatures, and attestations.
43+
44+
## Out of Scope
45+
46+
| Feature | Reason |
47+
|---|---|
48+
| Azure deployment in v0.1 | User explicitly prohibited deployment |
49+
| Workload business logic | Owned by reference product and service repos |
50+
| Static credentials | Conflicts with identity-first architecture |
51+
52+
## Traceability
53+
54+
| Requirement | Phase | Status |
55+
|---|---|---|
56+
| INFRA-01, INFRA-02, INFRA-03, INFRA-04 | Phase 1 | Complete |
57+
| SEC-01, SEC-02, SEC-03, SEC-04 | Phase 1 | Complete |
58+
| OPS-01, OPS-02, OPS-03, OPS-04 | Phase 1 | Complete |
59+
| QUAL-01, QUAL-02, QUAL-03, QUAL-04 | Phase 1 | Complete |
60+
61+
**Coverage:** 16 v1 requirements, 16 mapped, 0 unmapped.
62+
63+
---
64+
*Last updated: 2026-06-11 after v0.1 foundation*
65+

.planning/ROADMAP.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
# Roadmap: CAS Platform
2+
3+
## Phase 1: Safe Azure Foundation
4+
5+
**Goal:** Deliver a useful, non-deploying v0.1 platform foundation.
6+
7+
**Requirements:** INFRA-01 through INFRA-04, SEC-01 through SEC-04, OPS-01
8+
through OPS-04, QUAL-01 through QUAL-04.
9+
10+
**Success criteria:**
11+
1. Bicep and all environment parameter files build successfully.
12+
2. Contract tests prove identity, ingress, environment, and what-if safeguards.
13+
3. Architecture and threat model accurately describe residual risk.
14+
4. Repository can be created publicly and CI can validate the foundation.
15+
16+
## Phase 2: Network and Policy Guardrails
17+
18+
Add private networking, controlled egress, Azure Policy, and compliance
19+
reporting after target subscription architecture is agreed.
20+
21+
## Phase 3: Federated Delivery
22+
23+
Add OIDC/managed-identity deployment workflows, approvals, evidence retention,
24+
and safe promotion between environments.
25+
26+
## Phase 4: Production Operations
27+
28+
Add alerts, SLOs, dashboards, incident routing, release attestations, and
29+
recovery exercises.
30+

.planning/STATE.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# Project State
2+
3+
## Project Reference
4+
5+
See `.planning/PROJECT.md`.
6+
7+
**Core value:** An operator can confidently understand and validate a secure CAS Azure environment before deploying it.
8+
**Current focus:** Phase 2 - Network and Policy Guardrails
9+
10+
## Status
11+
12+
- Phase 1 v0.1 foundation implemented and locally verified.
13+
- No Azure resources deployed.
14+
- Next planned phase: Network and Policy Guardrails.

.planning/config.json

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
{
2+
"mode": "yolo",
3+
"granularity": "coarse",
4+
"parallelization": true,
5+
"commit_docs": true,
6+
"model_profile": "quality",
7+
"workflow": {
8+
"research": true,
9+
"plan_check": true,
10+
"verifier": true,
11+
"nyquist_validation": true,
12+
"auto_advance": false,
13+
"_auto_chain_active": false
14+
}
15+
}
16+
Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
# Plan 01-01: Safe Azure Foundation
2+
3+
## Objective
4+
5+
Deliver a useful, non-deploying Azure platform baseline with environment
6+
isolation, managed identity, observability, cost controls, and validation.
7+
8+
## Tasks
9+
10+
- [x] Establish subscription and module boundaries.
11+
- [x] Implement Bicep entrypoint, modules, and environment parameters.
12+
- [x] Add safe local validation and Azure what-if tooling.
13+
- [x] Add infrastructure contract tests and least-privilege CI.
14+
- [x] Publish architecture, threat model, operations, and community policies.
15+
- [x] Validate, commit, create the public repository, and push.
16+

0 commit comments

Comments
 (0)