Skip to content

Commit f9fb276

Browse files
hindermathhindermath
authored
Merge pull request #203 from hindermath/codex/aeps-engineering-controls-framework
docs: register dormant AEPS engineering controls framework
2 parents 8b42615 + df93f9b commit f9fb276

8 files changed

Lines changed: 360 additions & 21 deletions

File tree

‎docs/README.en.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -65,6 +65,7 @@ combines all four paths in one detailed, source-bound operating model.
6565
| Operation and maintenance | [Maintenance](maintenance/README.en.md), [efficiency guide](maintenance/agentic-workspace-efficiency-guide.en.md), [manpages](man/) |
6666
| Architecture | [Source and Home Runtime](architecture/source-and-home-runtime.en.md), [maintenance TUI](architecture/maintenance-tui.md) |
6767
| Governance and secure development | [Documentation governance](documentation-governance.md), [security](security/README.md), [secure development](secure-development/) |
68+
| AEPS programmes | [Engineering Controls Framework](aeps/engineering-controls/README.md) |
6869
| Technical reference | [Scripts](scripts/README.md), [complete script reference](scripts/reference.md) |
6970
| Audit and troubleshooting | [Troubleshooting](troubleshooting/README.en.md), [project statistics](project-statistics.md) |
7071

‎docs/README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -68,6 +68,7 @@ zusammen.
6868
| Betrieb und Wartung | [Wartung](maintenance/README.md), [Effizienzleitfaden](maintenance/agentic-workspace-efficiency-guide.md), [Manpages](man/) |
6969
| Architektur | [Source und Home Runtime](architecture/source-and-home-runtime.md), [Wartungs-TUI](architecture/maintenance-tui.md) |
7070
| Governance und sichere Entwicklung | [Dokumentations-Governance](documentation-governance.md), [Security](security/README.md), [Secure Development](secure-development/) |
71+
| AEPS-Programme | [Engineering Controls Framework](aeps/engineering-controls/README.md) |
7172
| Technische Referenz | [Skripte](scripts/README.md), [vollständige Skriptreferenz](scripts/reference.md) |
7273
| Prüfung und Fehleranalyse | [Troubleshooting](troubleshooting/README.md), [Projektstatistik](project-statistics.md) |
7374

‎docs/aeps/engineering-controls/README.md‎

Lines changed: 96 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
1+
# AEPS Engineering Controls Framework – ruhender Arbeitsstrang / Dormant Workstream
2+
3+
## Zweck und Status / Purpose and status
4+
5+
Dieser Level-0-Arbeitsstrang bereitet einen allgemeinen Rahmen fuer
6+
Engineering Controls vor. Ein Engineering Control beschreibt eine
7+
nachweisbare Engineering-Eigenschaft, nicht deren konkrete Ausfuehrung durch
8+
ein Preset, einen Validator oder einen KI-Agenten. / *This level-0 workstream
9+
prepares a general Engineering Controls framework. A control describes an
10+
evidenced engineering property, not its concrete execution through a preset,
11+
validator, or AI agent.*
12+
13+
Der aktuelle Zustand ist `BlockedPreconditions`. Der
14+
[Aktivierungsaudit vom 2. August 2026](activation-audits/2026-08-02.json) hat
15+
keinen Analyse- oder Authoring-Lauf gestartet. / *The current state is
16+
`BlockedPreconditions`. The activation audit did not start analysis or
17+
authoring.*
18+
19+
## Verbindliche Reihenfolge / Binding sequence
20+
21+
1. Die AOC-RAW-Reihe RAW-01 bis RAW-09 wird vollstaendig abgeschlossen.
22+
2. Die Analysephase des AEPS Preset Engineering Program wird im kanonischen
23+
Level-0-Repository abgeschlossen.
24+
3. Erst danach darf das Engineering Controls Framework analysiert werden.
25+
4. Das Completion Receipt des Frameworks wird zum Eingangsgate fuer den
26+
spaeteren Entwurf der AEPS-Preset-Lastenheft-Reihe.
27+
28+
*Complete the AOC RAW series and the canonical Preset Engineering analysis
29+
before analysing the Controls Framework. Its Completion Receipt becomes an
30+
input gate for the later preset-engineering intake-series draft.*
31+
32+
Der [maschinenlesbare Aktivierungsvertrag](activation-contract.json) ist fuer
33+
Gates, Evidence-Mindestwerte, Deliverables, Lastenheft-Landkarte und
34+
Stop-Grenzen verbindlich. / *The machine-readable activation contract is
35+
binding for gates, evidence thresholds, deliverables, the proposed intake
36+
map, and stop boundaries.*
37+
38+
## Evidence-Grenze / Evidence boundary
39+
40+
- `hindermath/home-baseline` ist das System of Record.
41+
- AOC ist die primaere, read-only Evidence-Quelle.
42+
- TuiVision, TinyCalc und TinyPl0 sind qualifizierte Vergleichsprojekte.
43+
- Eine Eigenschaft wird nur Control-Kandidat, wenn mindestens zwei Projekte,
44+
zwei unabhaengige Evidence-Ereignisse, Review- oder Completion-Bindung sowie
45+
positive und negative Evidence vorliegen.
46+
- Nicht qualifizierte Beobachtungen bleiben als Eigenschaftscluster sichtbar,
47+
werden aber nicht als Engineering Control bezeichnet.
48+
- AOC-spezifische Technologien, Pfade und Produktentscheidungen bleiben
49+
ausgeschlossen.
50+
51+
*AOC alone never establishes a control candidate. Unqualified observations
52+
remain visible without being labelled as controls, and product-specific
53+
technology decisions remain excluded.*
54+
55+
## Geplante Ergebnisse nach Aktivierung / Planned post-activation outputs
56+
57+
Nach einem vollstaendig bestandenen Audit darf der Arbeitsstrang
58+
ausschliesslich folgende Analyseartefakte erzeugen: / *After a fully passing
59+
audit, the workstream may produce only these analysis artefacts:*
60+
61+
1. Engineering Control Landscape
62+
2. Engineering Control Taxonomy
63+
3. Control-to-Preset Matrix
64+
4. Control-to-Finding Matrix
65+
5. vorgeschlagene AEPS-EC-Lastenheft-Landkarte und Series Map
66+
6. Roadmap
67+
7. hashgebundenes Completion Receipt
68+
69+
Die Landkarte beschreibt zwoelf spaetere Themen von Engineering Control Model
70+
bis Control Deprecation. Sie erzeugt keine aktiven Lastenhefte. / *The map
71+
describes twelve later topics from Engineering Control Model through Control
72+
Deprecation. It creates no active intakes.*
73+
74+
## Stop-Grenze / Stop boundary
75+
76+
Der Analyse-Lauf endet mit `AwaitingEngineeringControlsAuthoringApproval`.
77+
Bis zu einer neuen menschlichen Freigabe sind Control- und
78+
Lastenheft-Authoring, Preset-Aenderung oder -Promotion, Produktimplementierung,
79+
Spec-Kit-Ausfuehrung, Remote Write, Push, Merge und Bypass verboten. / *The
80+
analysis ends in `AwaitingEngineeringControlsAuthoringApproval`. No control or
81+
intake authoring, preset mutation or promotion, product implementation,
82+
Spec-Kit execution, remote write, push, merge, or bypass follows without new
83+
human approval.*
84+
85+
## Dokumentationsauswirkung / Documentation impact
86+
87+
Entscheidung: `UpdateRequired`. Kanonische Quelle und Owner sind dieser
88+
Level-0-Vertrag und der Level-0-AEPS-Maintainer. Zielgruppe sind Maintainer,
89+
Reviewer und KI-Agenten; der Leserpfad fuehrt vom Dokumentationsportal zu
90+
diesem Charter, danach zum Aktivierungsvertrag und aktuellen Audit.
91+
Distributionsklasse ist `sourceOnly`; ein Home-Sync ist nicht erforderlich.
92+
Evidence und Re-Evaluation stehen in
93+
[documentation-impact-evidence.json](documentation-impact-evidence.json). /
94+
*Decision: `UpdateRequired`. This level-0 contract is source-only and requires
95+
no Home sync. Re-evaluate it after the RAW series and Preset Engineering
96+
analysis are complete.*

‎docs/aeps/engineering-controls/activation-audits/2026-08-02.json‎

Lines changed: 101 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,101 @@
1+
{
2+
"schemaVersion": "1.0",
3+
"documentType": "AepsEngineeringControlsActivationAudit",
4+
"auditId": "9a385ac5-3ee4-4dae-8b17-aa0553741554",
5+
"programId": "aeps-engineering-controls-framework",
6+
"observedAt": "2026-08-01T23:19:35Z",
7+
"activationAttempt": true,
8+
"outcome": "BlockedPreconditions",
9+
"programState": "BlockedPreconditions",
10+
"level0": {
11+
"repository": "hindermath/home-baseline",
12+
"remote": "https://github.com/hindermath/home-baseline.git",
13+
"baseCommit": "b08a8bbc2f831f11677e8a7ca1cfa4fea83b433c",
14+
"cleanBeforeAudit": true
15+
},
16+
"strategicAnchor": {
17+
"url": "https://github.com/hindermath/home-baseline/issues/196",
18+
"state": "OPEN",
19+
"lastUpdatedAt": "2026-08-01T17:59:28Z"
20+
},
21+
"aocEvidence": {
22+
"repository": "hindermath/agent-operations-cockpit",
23+
"baseCommit": "ddba7482163c7e61161ad0b90f4e019844335898",
24+
"workingTree": "DirtyPendingPublication",
25+
"workingTreeStatusSha256": "021ec576350701e3888b85219acdc029cf2e011fd02a2aedc807f87d7522a268",
26+
"seriesManifest": "specs/intake-series/aoc-phase-2/manifest.json",
27+
"seriesManifestSha256": "d408a26f5141bf4011ffdd2e02f32f122286217293d285530c38e742c04b120f",
28+
"seriesReceipt": "specs/intake-series-receipts/aoc-phase-2.json",
29+
"seriesReceiptSha256": "dfff1c8b2b3c3f3eef3e508f2bb70214e2dc625e8db227bb578d6f6fe41c6aad",
30+
"seriesStatus": "NeedsClarification",
31+
"declaredEligible": "RAW-01",
32+
"reviewFindingsLedgerSha256": "647f09a43176b6940c475fbaadc7d2a6908f3a9dcf605bdfe77726f7f33545ec",
33+
"coverageMatrixSha256": "4e2dd1382ec702bc1b5422b3c8df88adb33171de95f0c21b1b843b57ccb7f664"
34+
},
35+
"summary": {
36+
"rawIntakeCount": 9,
37+
"authoringReceiptPresenceCount": 9,
38+
"authoringReceiptBashPassedCount": 9,
39+
"authoringReceiptPowerShellPassedCount": 9,
40+
"currentReadyReviewCount": 2,
41+
"missingCurrentReviewCount": 7,
42+
"seriesCompletedCount": 0,
43+
"perRawCompletionReceiptCount": 0,
44+
"rawSeriesCompletionReceiptPresent": false,
45+
"presetEngineeringAnalysisCompletionReceiptPresentInCanonicalLevel0": false,
46+
"findingCoverage": "IncompleteEvidenceSet",
47+
"blockingFindings": "NotAssessedBecauseRequiredReviewsAndReceiptsAreMissing",
48+
"crossProjectEvidence": "NotAssessedBecauseEarlierActivationGatesFailed"
49+
},
50+
"rawIntakes": [
51+
{"id": "RAW-01", "authoringReceiptValidation": "PassedBashAndPowerShell", "currentReview": "Ready", "reviewValidation": "PassedBashAndPowerShell", "seriesLifecycle": "Eligible", "completionReceipt": "Missing", "activationEligible": false},
52+
{"id": "RAW-02", "authoringReceiptValidation": "PassedBashAndPowerShell", "currentReview": "Ready", "reviewValidation": "PassedBashAndPowerShell", "seriesLifecycle": "Blocked", "completionReceipt": "Missing", "activationEligible": false},
53+
{"id": "RAW-03", "authoringReceiptValidation": "PassedBashAndPowerShell", "currentReview": "Missing", "reviewValidation": "NotApplicable", "seriesLifecycle": "Pending", "completionReceipt": "Missing", "activationEligible": false},
54+
{"id": "RAW-04", "authoringReceiptValidation": "PassedBashAndPowerShell", "currentReview": "Missing", "reviewValidation": "NotApplicable", "seriesLifecycle": "Pending", "completionReceipt": "Missing", "activationEligible": false},
55+
{"id": "RAW-05", "authoringReceiptValidation": "PassedBashAndPowerShell", "currentReview": "Missing", "reviewValidation": "NotApplicable", "seriesLifecycle": "Pending", "completionReceipt": "Missing", "activationEligible": false},
56+
{"id": "RAW-06", "authoringReceiptValidation": "PassedBashAndPowerShell", "currentReview": "Missing", "reviewValidation": "NotApplicable", "seriesLifecycle": "Blocked", "completionReceipt": "Missing", "activationEligible": false},
57+
{"id": "RAW-07", "authoringReceiptValidation": "PassedBashAndPowerShell", "currentReview": "Missing", "reviewValidation": "NotApplicable", "seriesLifecycle": "Blocked", "completionReceipt": "Missing", "activationEligible": false},
58+
{"id": "RAW-08", "authoringReceiptValidation": "PassedBashAndPowerShell", "currentReview": "Missing", "reviewValidation": "NotApplicable", "seriesLifecycle": "Pending", "completionReceipt": "Missing", "activationEligible": false},
59+
{"id": "RAW-09", "authoringReceiptValidation": "PassedBashAndPowerShell", "currentReview": "Missing", "reviewValidation": "NotApplicable", "seriesLifecycle": "Blocked", "completionReceipt": "Missing", "activationEligible": false}
60+
],
61+
"presetEngineering": {
62+
"canonicalLevel0Contract": "Missing",
63+
"analysisCompletionReceipt": "Missing",
64+
"requiredDeliverables": {
65+
"presetInventory": "Missing",
66+
"existingPresetMap": "Missing",
67+
"findingToPresetMatrix": "Missing",
68+
"presetGapAnalysis": "Missing"
69+
},
70+
"nonCanonicalDraft": {
71+
"repository": "hindermath/agent-operations-cockpit",
72+
"commit": "4b77c45cd52b75cbd0082e7a68e6a516b0e9b9eb",
73+
"classification": "DraftInputOnlyNotCanonicalLevel0Evidence"
74+
}
75+
},
76+
"failedGates": [
77+
"SevenRawIntakesMissingCurrentReadyReview",
78+
"AllNineRawIntakesNotSeriesCompleted",
79+
"AllNinePerRawCompletionReceiptsMissing",
80+
"RawSeriesCompletionReceiptMissing",
81+
"CompleteFindingCoverageCannotBeProvenForMissingReviews",
82+
"NoOpenBlockingFindingCannotBeProven",
83+
"CanonicalPresetEngineeringContractMissing",
84+
"PresetEngineeringAnalysisDeliverablesAndCompletionReceiptMissing"
85+
],
86+
"artifactsNotCreated": [
87+
"Source Manifest",
88+
"Engineering Control Landscape",
89+
"Engineering Control Taxonomy",
90+
"Control-to-Preset Matrix",
91+
"Control-to-Finding Matrix",
92+
"Active AEPS Engineering Controls Intakes",
93+
"Engineering Controls Completion Receipt"
94+
],
95+
"requiredHumanDecision": {
96+
"neededNow": true,
97+
"decision": "Authorise continuation of the AOC RAW series beginning with the next bounded lifecycle step for current Ready and Eligible RAW-01, while requiring a valid per-RAW Completion Receipt before final activation evidence is claimed.",
98+
"rerunCondition": "Repeat this audit only after RAW-01 through RAW-09 are Ready and Completed with individual and series Completion Receipts, complete finding coverage, no blocking findings, and a completed canonical Preset Engineering analysis."
99+
},
100+
"nextAction": "StopAndRequestTargetedHumanDecision"
101+
}

‎docs/aeps/engineering-controls/activation-contract.json‎

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
{
2+
"schemaVersion": "1.0",
3+
"documentType": "AepsEngineeringControlsActivationContract",
4+
"programId": "aeps-engineering-controls-framework",
5+
"title": "AEPS Engineering Controls Framework",
6+
"systemOfRecord": "hindermath/home-baseline",
7+
"strategicAnchor": "https://github.com/hindermath/home-baseline/issues/196",
8+
"initialState": "Dormant",
9+
"states": ["Dormant", "BlockedPreconditions", "ActiveEvidenceAnalysis", "AwaitingEngineeringControlsAuthoringApproval", "Completed"],
10+
"activation": {
11+
"mode": "ExplicitHumanInvocation",
12+
"automaticActivationAllowed": false,
13+
"requiredSequence": ["CompleteAocRawSeries", "CompleteAepsPresetEngineeringAnalysis", "AnalyseEngineeringControlsFramework", "PermitAepsPresetEngineeringSeriesDraft"],
14+
"primaryEvidenceRepository": "hindermath/agent-operations-cockpit",
15+
"requiredRawIntakes": ["RAW-01", "RAW-02", "RAW-03", "RAW-04", "RAW-05", "RAW-06", "RAW-07", "RAW-08", "RAW-09"],
16+
"perRawGates": [
17+
"CurrentAuthoringReceiptValidOnBashAndPowerShell",
18+
"CurrentSingleReviewReadyAndHashBound",
19+
"CurrentSingleReviewValidOnBashAndPowerShell",
20+
"SeriesLifecycleCompleted",
21+
"CurrentCompletionReceiptValid",
22+
"AllReviewFindingsDocumented",
23+
"EveryFindingHasCoverageStatus",
24+
"NoBlockingFindingOpen"
25+
],
26+
"seriesGates": ["CurrentRawSeriesCompletionReceiptValid", "SeriesReceiptBindsManifestOrderReviewsFindingsCoverageAndReceipts"],
27+
"presetEngineeringGates": ["CanonicalLevel0ProgramContractPublished", "PresetInventoryComplete", "ExistingPresetMapComplete", "FindingToPresetMatrixComplete", "PresetGapAnalysisComplete", "AnalysisCompletionReceiptCurrent"],
28+
"failureState": "BlockedPreconditions",
29+
"failureAction": "WriteActivationAuditStopAndRequestTargetedHumanDecision",
30+
"successState": "ActiveEvidenceAnalysis"
31+
},
32+
"evidenceBasis": {
33+
"primary": "hindermath/agent-operations-cockpit",
34+
"comparisonRepositories": ["hindermath/TuiVision", "hindermath/TinyCalc", "hindermath/TinyPl0"],
35+
"minimumIndependentProjectsForControlCandidate": 2,
36+
"minimumIndependentEvidenceEvents": 2,
37+
"reviewOrCompletionBindingRequiredPerProject": true,
38+
"positiveEvidenceRequired": true,
39+
"negativeEvidenceOrCounterexampleRequired": true,
40+
"openBlockingFindingAllowed": false,
41+
"singleProjectControlCandidateAllowed": false
42+
},
43+
"propertyCluster": {
44+
"idPattern": "EC-PROP-NNN",
45+
"states": ["Observed", "Repeated", "CrossProjectSupported", "InsufficientEvidence", "Conflicted", "ExcludedProductSpecific"],
46+
"controlCandidateQualificationState": "CrossProjectSupported",
47+
"unqualifiedPropertiesRemainNonNormative": true
48+
},
49+
"deliverables": ["Engineering Control Landscape", "Engineering Control Taxonomy", "Control-to-Preset Matrix", "Control-to-Finding Matrix", "AEPS Engineering Controls Intake Landscape", "AEPS Engineering Controls Series Map", "AEPS Engineering Controls Roadmap", "Completion Receipt"],
50+
"matrixClassifications": {
51+
"controlToPreset": ["ExistingCoverage", "PartialCoverage", "Overlap", "Gap", "NoPresetRelevance"],
52+
"controlToFinding": ["Supports", "Contradicts", "Limits", "Duplicates", "Unrelated"]
53+
},
54+
"proposedIntakeSeries": {
55+
"createsActiveIntakes": false,
56+
"root": "AEPS-EC-01",
57+
"targets": [
58+
{"id": "AEPS-EC-01", "title": "Engineering Control Model", "owner": "Level-0 AEPS Maintainer", "dependsOn": []},
59+
{"id": "AEPS-EC-02", "title": "Engineering Control Taxonomy", "owner": "Level-0 AEPS Maintainer", "dependsOn": ["AEPS-EC-01"]},
60+
{"id": "AEPS-EC-03", "title": "Control Classification", "owner": "AEPS Evidence Steward", "dependsOn": ["AEPS-EC-01", "AEPS-EC-02"]},
61+
{"id": "AEPS-EC-04", "title": "Control Lifecycle", "owner": "Level-0 AEPS Maintainer", "dependsOn": ["AEPS-EC-01", "AEPS-EC-03"]},
62+
{"id": "AEPS-EC-05", "title": "Control Evidence", "owner": "AEPS Evidence Steward", "dependsOn": ["AEPS-EC-01", "AEPS-EC-03"]},
63+
{"id": "AEPS-EC-06", "title": "Control Traceability", "owner": "AEPS Evidence Steward", "dependsOn": ["AEPS-EC-02", "AEPS-EC-05"]},
64+
{"id": "AEPS-EC-07", "title": "Control Validation", "owner": "AEPS Assurance Reviewer", "dependsOn": ["AEPS-EC-03", "AEPS-EC-05", "AEPS-EC-06"]},
65+
{"id": "AEPS-EC-08", "title": "Control Coverage", "owner": "AEPS Evidence Steward", "dependsOn": ["AEPS-EC-02", "AEPS-EC-06", "AEPS-EC-07"]},
66+
{"id": "AEPS-EC-09", "title": "Control Metrics", "owner": "AEPS Assurance Reviewer", "dependsOn": ["AEPS-EC-05", "AEPS-EC-07", "AEPS-EC-08"]},
67+
{"id": "AEPS-EC-10", "title": "Cross-Project Control Validation", "owner": "AEPS Cross-Project Reviewer", "dependsOn": ["AEPS-EC-05", "AEPS-EC-07", "AEPS-EC-09"]},
68+
{"id": "AEPS-EC-11", "title": "Control Promotion", "owner": "Level-0 AEPS Maintainer", "dependsOn": ["AEPS-EC-04", "AEPS-EC-08", "AEPS-EC-09", "AEPS-EC-10"]},
69+
{"id": "AEPS-EC-12", "title": "Control Deprecation", "owner": "Level-0 AEPS Maintainer", "dependsOn": ["AEPS-EC-04", "AEPS-EC-06", "AEPS-EC-11"]}
70+
]
71+
},
72+
"completionState": "AwaitingEngineeringControlsAuthoringApproval",
73+
"prohibitedActions": ["DefineIndividualEngineeringControl", "CreateActiveIntake", "CreatePreset", "ModifyPreset", "PromotePreset", "StartProductImplementation", "StartSpecifyPlanTasksOrImplement", "ModifyEvidenceSourceRepository", "WriteGitHubIssue", "Push", "Merge", "Bypass"]
74+
}

0 commit comments

Comments
 (0)