Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 4 additions & 5 deletions docs/architecture/ADMIN_QUERY_API_ARCHITECTURE.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Admin Query API Architecture

**Status:** Approved Architecture
**Phase:** Phase 3 Remediation Complete / Phase 4 Active / DiagnosticsTelemetry Runtime Complete / DeliveryOperations Discovery/Audit Complete / DeliveryOperations Blueprint Proposed Next
**Phase:** Phase 3 Remediation Complete / Phase 4 Active / DiagnosticsTelemetry Runtime Complete / DeliveryOperations Blueprint Approved / Runtime Implementation Next

## 1. Purpose

Expand Down Expand Up @@ -227,9 +227,8 @@ The approved implementation sequence is:
Phase 3 Remediation Complete.
Phase 4 Active.
DiagnosticsTelemetry Runtime complete
DeliveryOperations discovery/audit and blueprint design authorized next
DeliveryOperations Owner approval pending
DeliveryOperations Runtime not authorized
DeliveryOperations Blueprint Approved
DeliveryOperations Runtime Next
Reporting/dashboard blocked
No release or tag authorized

Expand All @@ -238,6 +237,6 @@ No release or tag authorized
- `SecuritySignals`: Runtime implemented.
- `AuthoritativeAudit`: Runtime implemented.
- `DiagnosticsTelemetry`: Runtime implemented
- `DeliveryOperations`: Discovery/audit and blueprint design authorized next
- `DeliveryOperations`: Blueprint Approved / Runtime Next. The implementation must strictly follow the merged Blueprint.

Approval of this architecture document alone does not authorize Composer, Runtime, schema, test, tag, or release changes.
15 changes: 12 additions & 3 deletions docs/architecture/ADMIN_QUERY_DELIVERY_OPERATIONS_BLUEPRINT.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,18 @@
# DeliveryOperations Admin Query Blueprint

**Status:** Proposed / Pending Owner Approval
**Runtime Not Authorized**
**Status:** Owner Approved / Runtime Authorized / Implementation Pending

This document defines the complete proposed contract for adding the new Admin Query API path for `DeliveryOperations`.
## Approval Record

- Owner approval completed on July 24, 2026.
- The approved blueprint was merged through PR #124.
- Merge commit: `f5ff025c9a539162c7e8dd42c0d7b43044894a6f`.
- Runtime must be implemented in a subsequent PR from the latest `main`.
- The implementation is strictly bound to the contracts documented in this blueprint, including covering all persisted fields with package-owned, safe filter contracts.
- No authorization to modify the protected `v1.0.0` primitive Runtime.
- No schema, Composer, CI, host, reporting, dashboard, tag, or release work is authorized.

This document defines the complete approved contract for adding the new Admin Query API path for `DeliveryOperations`.

## 1. Scope and Design Principle
The DeliveryOperations domain has no superseded post-v1 pagination experiment to rebuild. This is a new post-v1 implementation.
Expand Down
6 changes: 3 additions & 3 deletions docs/audits/DOCUMENTATION_INVENTORY.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,15 +9,15 @@
| `./docs/architecture/FACTORY_AND_PROVIDER_DESIGN.md` | Standards / Architecture Docs | Active | Architectural rules and logging patterns | Reviewed: framework mentions are safe guardrails or explicit prohibitions; no current wording update needed. |
| `./docs/architecture/INTEGRATION_SURFACE_DESIGN.md` | Architecture Docs | Active | Architectural rules and logging patterns | Clarified that package may own domain-scoped reporting and dashboard summary contracts; host owns presentation. |
| `./docs/architecture/PRIMITIVE_READ_QUERY_SUPPORT_DESIGN.md` | Architecture Docs | Active | Protected `v1.0.0` primitive design | Scope explicitly restricted to v1 primitive path; host owns presentation and cross-system analytics. |
| `./docs/architecture/ADMIN_QUERY_API_ARCHITECTURE.md` | Architecture Docs | Active | Approved post-v1 architecture | Phase 3 Remediation Complete / Phase 4 Active / DiagnosticsTelemetry Runtime Complete / DeliveryOperations Design Next. |
| `./docs/architecture/ADMIN_QUERY_API_ARCHITECTURE.md` | Architecture Docs | Active | Approved post-v1 architecture | Phase 3 Remediation Complete / Phase 4 Active / DiagnosticsTelemetry Runtime Complete / DeliveryOperations Blueprint Approved / Runtime Next. |
| `./docs/architecture/ADMIN_QUERY_AUDIT_TRAIL_POC_BLUEPRINT.md` | Architecture Docs | Active (Owner Approved / Runtime Implemented) | Blueprint and implementation status for AuditTrail POC | Owner approval granted; runtime implementation documented. |
| `./docs/architecture/ADMIN_QUERY_AUTHORITATIVE_AUDIT_REBUILD_BLUEPRINT.md` | Architecture Docs | Active (Implemented / Complete) | Blueprint for AuthoritativeAudit Admin Query API | Owner approval recorded on 2026-07-16. Runtime implementation complete. |
| `./docs/architecture/ADMIN_QUERY_BEHAVIOR_TRACE_REBUILD_BLUEPRINT.md` | Architecture Docs | Active (Owner Approved / Runtime Implemented) | BehaviorTrace rebuild blueprint | Runtime implementation is complete. The approved replacement is present, and the superseded post-v1 pagination artifacts were deleted after the test gate passed. |
| `./docs/architecture/ADMIN_QUERY_DELIVERY_OPERATIONS_BLUEPRINT.md` | Architecture Docs | Active (Proposed / Pending Owner Approval) | Proposed Admin Query API architecture for DeliveryOperations | Blueprint defining complete package-owned Admin filtering capabilities. Runtime is not authorized. |
| `./docs/architecture/ADMIN_QUERY_DELIVERY_OPERATIONS_BLUEPRINT.md` | Architecture Docs | Active (Owner Approved / Implementation Pending) | Approved Admin Query API architecture for DeliveryOperations | Blueprint defining complete package-owned Admin filtering capabilities. Runtime is authorized but not implemented. |
| `./docs/architecture/ADMIN_QUERY_DIAGNOSTICS_TELEMETRY_BLUEPRINT.md` | Architecture Docs | Active (Owner Approved / Runtime Implemented / Complete) | Blueprint for DiagnosticsTelemetry Admin Query API | DiagnosticsTelemetry Admin Query Runtime is complete and merged. The protected primitive find()/read() behavior is preserved, the native-PDO distinct-placeholder correction is applied, and Unit, Regression, and strict real-MySQL Integration coverage is present. |
| `./docs/architecture/ADMIN_QUERY_SECURITY_SIGNALS_REBUILD_BLUEPRINT.md` | Architecture Docs | Active (Owner Approved / Runtime Implemented) | SecuritySignals Admin Query Rebuild Blueprint | Runtime implementation is complete. The primitive cursor placeholder correction is applied, coverage is complete, and the superseded post-v1 pagination artifacts were deleted. |
| `./docs/architecture/ADMIN_QUERY_SECURITY_SIGNALS_POST_V1_RETIREMENT_DECISION.md` | Architecture Docs | Active (Owner Decision) | Defines the mandatory retirement boundary for the SecuritySignals post-v1 wrapper | The seven superseded Runtime/test artifacts are outside `v1.0.0`, their wrapper/cursor contracts are not preserved, and they are deleted atomically in the Runtime rebuild. |
| `./docs/roadmap/ADMIN_QUERY_API_ROADMAP.md` | Roadmap Docs | Active | Current post-v1 execution roadmap | Phase 4 remains active; DiagnosticsTelemetry Runtime is complete and merged; DeliveryOperations discovery/audit and blueprint design authorized next; reporting/dashboard remains blocked; no release or tag is authorized. |
| `./docs/roadmap/ADMIN_QUERY_API_ROADMAP.md` | Roadmap Docs | Active | Current post-v1 execution roadmap | Phase 4 remains active; DiagnosticsTelemetry Runtime is complete and merged; DeliveryOperations Blueprint Approved / Runtime Next; reporting/dashboard remains blocked; no release or tag is authorized. |
| `./docs/audits/ADMIN_QUERY_PHASE_1_RUNTIME_COMPATIBILITY_INVENTORY.md` | Historical Audit Docs | Historical | Historical Phase 1 Baseline | |
| `./docs/architecture/logging/CANONICAL_LOGGER_DESIGN_STANDARD.md` | Standards / Architecture Docs | Active | Architectural rules and logging patterns | |
| `./docs/architecture/logging/GLOBAL_LOGGING_RULES.md` | Standards / Architecture Docs | Active | Architectural rules and logging patterns | |
Expand Down
11 changes: 5 additions & 6 deletions docs/roadmap/ADMIN_QUERY_API_ROADMAP.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Admin Query API Roadmap

**Status:** Phase 3 Complete / DiagnosticsTelemetry Runtime Complete and Merged / DeliveryOperations Discovery/Audit Complete / DeliveryOperations Blueprint Proposed Next
**Status:** Phase 3 Complete / DiagnosticsTelemetry Runtime Complete and Merged / DeliveryOperations Blueprint Approved / Runtime Implementation Next

## 1. Scope Boundary

Expand Down Expand Up @@ -95,7 +95,7 @@ These are new post-v1.0 features, not corrections to the first-release Runtime.

- **Status:** Phase 4 is active. DiagnosticsTelemetry Runtime is complete and merged.
- `DiagnosticsTelemetry`: [Owner Approved / Runtime Implemented / Complete](../architecture/ADMIN_QUERY_DIAGNOSTICS_TELEMETRY_BLUEPRINT.md)
- `DeliveryOperations`: Discovery/Audit and Blueprint Design Authorized; Runtime Not Authorized; Owner Approval Pending
- `DeliveryOperations`: Owner Approved / Runtime Authorized / Implementation Pending

### Phase 5 — Reporting and Dashboard Summary Contracts

Expand Down Expand Up @@ -140,9 +140,8 @@ Every implementation phase must prove all of the following:

## 6. Current Gate

- Phase 4 is active;
- DiagnosticsTelemetry Runtime complete and merged;
- DeliveryOperations discovery/audit complete; DeliveryOperations blueprint proposed next;
- DeliveryOperations Owner approval pending;
- DeliveryOperations Runtime not authorized;
- reporting/dashboard blocked;
- DeliveryOperations Runtime is the next step;
- reporting/dashboard does not start until Admin pagination is complete for all six domains;
- no release/tag authorized.
Loading