Requirements: Partition Provisioning (Phase 2)
Requirements: Partition Provisioning (Phase 2)
Section titled “Requirements: Partition Provisioning (Phase 2)”Functional requirements for the infrastructure changes. Behavior definitions
in Design §9.1/§9.7; construct blueprint in
Design §12.
Configuration
Section titled “Configuration”- REQ-INF-001 —
PartitionMail(src/main/cdk/platforms.ts) SHALL carry a per-partitionsystemServerTokenOpReference(op://Arda-{Env}OAM/SystemEmailServer/credential) with a partition-aware accessor; the canonical op:// mapping SHALL live only there (never in bash).
Pre-Deploy (SystemEmailServer)
Section titled “Pre-Deploy (SystemEmailServer)”- REQ-INF-002 — The Pre-Deploy step SHALL idempotently ensure a Postmark
Server named
SystemEmailServer-{fqn}exists on the partition’s Postmark account: list-by-name; absent → create and captureApiTokens[0]; present → no Postmark mutation (Design §9.1 — Ensure-server idempotency). - REQ-INF-003 — On server creation, the token SHALL be written to the
partition-vault 1Password item
SystemEmailServer(fieldcredential) before any other consumption; on subsequent runs the token SHALL be read from the vault, not from Postmark (DQ-002). - REQ-INF-004 — Custody divergences SHALL behave per
Design §9.1/§9.7: server
present + item missing → heal (re-read via
GET /servers/{id}, create item); item present + server missing → hard error naming both sides, no automatic recreation. - REQ-INF-005 — The token SHALL be emitted only via a 0600 temp file
(
--system-token-out), following the existing temp-file discipline; the prior “no servers at provisioning time” invariant comment and test SHALL be updated to name the SystemEmailServer as the sanctioned exception.
Secret Delivery (CDK)
Section titled “Secret Delivery (CDK)”- REQ-INF-006 —
PartitionEmailStackSHALL gain a NoEchoCfnParameterEmailSystemServerTokenand an SM secret{fqn}-I-EmailSystemServerToken(secretObjectValue: { token: … },RemovalPolicy.RETAIN) plus a typed export{fqn}-API-EmailSystemServerTokenArn;BuiltSHALL expose the secret. All existing resources SHALL be template-identical after the change (DQ-003; Design §8 — PartitionEmailStack). - REQ-INF-007 —
amm.shSHALL pass the third NoEcho parameter on the existing--forcedeploy with the established masking discipline (set +x,::add-mask::); Pre-Deploy failure SHALL abort the partition run before any CFN change. - REQ-INF-008 — No DNS records, zones, or Sender Signatures SHALL be added or modified (DQ-001).
- REQ-INF-009 —
runtime-platform-driftSHALL assert, per active partition: (a) a Postmark server namedSystemEmailServer-{fqn}exists; (b) the SM secret{fqn}-I-EmailSystemServerTokenexists. Checks SHALL work withArda-SystemsOAMshared account tokens only (existence, never values).
Copyright: (c) Arda Systems 2025-2026, All rights reserved
Copyright: © Arda Systems 2025-2026, All rights reserved