From 49df819fcc346459bb5632a81e7f22abc088807c Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 25 Feb 2026 01:39:17 +0000 Subject: [PATCH 1/2] Initial plan From 6dbd493ac85e4e7ecc515f8f13d8b63131943e00 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 25 Feb 2026 01:47:15 +0000 Subject: [PATCH 2/2] Add K06 ATA 46 01_WBS: workbreakdown index, RACI, and T001-T006 task files; update tasklist links to v6.0 naming Co-authored-by: AmedeoPelliccia <164860269+AmedeoPelliccia@users.noreply.github.com> --- ...service-contract-set_ACT_I01-R01_ACTIVE.md | 239 +++++++++++++++++ ...ata-46-workbreakdown_IDX_I01-R01_ACTIVE.md | 123 +++++++++ ...AI__k06-ata-46-raci_MAT_I01-R01_ACTIVE.csv | 7 + ...sot-source-ownership_ACT_I01-R01_ACTIVE.md | 175 +++++++++++++ ...2-identifier-grammar_ACT_I01-R01_ACTIVE.md | 207 +++++++++++++++ ...03-schema-definition_ACT_I01-R01_ACTIVE.md | 240 ++++++++++++++++++ ...4-export-publication_ACT_I01-R01_ACTIVE.md | 207 +++++++++++++++ ...-ci-validation-gates_ACT_I01-R01_ACTIVE.md | 207 +++++++++++++++ ..._k06-ata-46-tasklist_IDX_I01-R01_ACTIVE.md | 16 +- 9 files changed, 1413 insertions(+), 8 deletions(-) create mode 100644 AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_BASELINE_PLUS_PR_GEN_LC06_K06-T006_AI__k06-t006-baseline-service-contract-set_ACT_I01-R01_ACTIVE.md create mode 100644 AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_BB_GEN_LC01_K06_AI__k06-ata-46-workbreakdown_IDX_I01-R01_ACTIVE.md create mode 100644 AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_BB_GEN_LC06_K06_AI__k06-ata-46-raci_MAT_I01-R01_ACTIVE.csv create mode 100644 AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T001_AI__k06-t001-ssot-source-ownership_ACT_I01-R01_ACTIVE.md create mode 100644 AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T002_AI__k06-t002-identifier-grammar_ACT_I01-R01_ACTIVE.md create mode 100644 AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T003_AI__k06-t003-schema-definition_ACT_I01-R01_ACTIVE.md create mode 100644 AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T004_AI__k06-t004-export-publication_ACT_I01-R01_ACTIVE.md create mode 100644 AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T005_AI__k06-t005-ci-validation-gates_ACT_I01-R01_ACTIVE.md diff --git a/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_BASELINE_PLUS_PR_GEN_LC06_K06-T006_AI__k06-t006-baseline-service-contract-set_ACT_I01-R01_ACTIVE.md b/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_BASELINE_PLUS_PR_GEN_LC06_K06-T006_AI__k06-t006-baseline-service-contract-set_ACT_I01-R01_ACTIVE.md new file mode 100644 index 00000000..c4fa0473 --- /dev/null +++ b/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_BASELINE_PLUS_PR_GEN_LC06_K06-T006_AI__k06-t006-baseline-service-contract-set_ACT_I01-R01_ACTIVE.md @@ -0,0 +1,239 @@ +--- +title: "Action Item: T006 Baseline Service Contract Set" +type: ACT +project: AMPEL360 +program: SPACET +variant: PLUS +status: ACTIVE +owner: "AI + CERT" +knot_id: K06 +task_id: T006 +ata: "46" +lc_or_subbucket: "LC06" +--- + +# T006: Baseline Service Contract Set + +## Action Items Register + +| ID | Action | Owner | Due Date | Priority | Status | Notes | +| :--- | :--- | :--- | :--- | :--- | :--- | :--- | +| T006-01 | Define baseline freeze criteria | CERT + CM | TBD | High | Open | What qualifies for baseline | +| T006-02 | Select candidate services and contracts | OPS + DATA | TBD | High | Open | Initial baseline set | +| T006-03 | Validate candidates against schema | AI | TBD | High | Open | Schema compliance | +| T006-04 | Validate candidates against CI gates | AI | TBD | High | Open | ID uniqueness/versioning | +| T006-05 | Create frozen baseline manifest | DATA | TBD | High | Open | Immutable reference | +| T006-06 | Publish baseline service contract set | CERT | TBD | High | Open | Integration-grade artifact | + +--- + +## Action Item Details + +### T006-01: Define Baseline Freeze Criteria + +**Created:** 2025-12-17 +**Owner:** CERT + CM +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Define the criteria that services, contracts, and routing configurations must meet to qualify for inclusion in the frozen baseline. + +**Context:** +Clear criteria ensure the baseline contains only integration-grade and ops-ready service contracts. + +**Acceptance Criteria:** +- [ ] Freeze criteria documented +- [ ] Required attributes: schema compliance, CI pass, contract completeness +- [ ] Exclusion criteria defined +- [ ] Approval authority specified + +**Dependencies:** +- T003 (Schema), T005 (CI Gates) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to baseline freeze criteria document + +--- + +### T006-02: Select Candidate Services and Contracts + +**Created:** 2025-12-17 +**Owner:** OPS + DATA +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Identify and select candidate services, contracts, and routing configurations for inclusion in the baseline. + +**Context:** +Initial selection based on operational readiness, contract completeness, and integration coverage. + +**Acceptance Criteria:** +- [ ] Candidate list created +- [ ] Each candidate: service ID, contract ID, description, owner, consumer list +- [ ] Selection rationale documented +- [ ] Gaps identified (missing services/contracts) + +**Dependencies:** +- T006-01 (freeze criteria must be defined) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to candidate selection report + +--- + +### T006-03: Validate Candidates Against Schema + +**Created:** 2025-12-17 +**Owner:** AI +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Validate each candidate service/contract against the published schema (T003). + +**Context:** +Schema validation ensures data integrity and semantic consistency for integration use. + +**Acceptance Criteria:** +- [ ] Each candidate validated against schema +- [ ] Validation results documented +- [ ] Non-compliant candidates flagged for remediation +- [ ] Remediation tracked to completion or exclusion + +**Dependencies:** +- T003 (Schema), T006-02 (candidates) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to schema validation report + +--- + +### T006-04: Validate Candidates Against CI Gates + +**Created:** 2025-12-17 +**Owner:** AI +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Validate each candidate service/contract against CI gate requirements (T005). + +**Context:** +CI gate validation ensures ID uniqueness, versioning compliance, and absence of breaking changes. + +**Acceptance Criteria:** +- [ ] Each candidate validated against CI gates +- [ ] ID uniqueness verified +- [ ] Versioning compliance verified +- [ ] Non-compliant candidates flagged for remediation + +**Dependencies:** +- T005 (CI Gates), T006-02 (candidates) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to CI gate validation report + +--- + +### T006-05: Create Frozen Baseline Manifest + +**Created:** 2025-12-17 +**Owner:** DATA +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Create the frozen baseline manifest containing all validated services and contracts with immutable references. + +**Context:** +The frozen manifest is the integration reference that cannot be changed without versioning. + +**Acceptance Criteria:** +- [ ] Manifest created with all validated items +- [ ] SHA-256 checksums for all items +- [ ] Immutability mechanism documented +- [ ] Version and timestamp recorded + +**Dependencies:** +- T006-03, T006-04 (validation must pass) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to frozen baseline manifest + +--- + +### T006-06: Publish Baseline Service Contract Set + +**Created:** 2025-12-17 +**Owner:** CERT +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Publish the baseline service contract set as the official integration-grade artifact for K06 ATA 46 closure. + +**Context:** +Publication makes the baseline official and enables integration and operations teams to rely on a stable contract set. + +**Acceptance Criteria:** +- [ ] Baseline service contract set published +- [ ] References frozen manifest +- [ ] Approved by CM WG and CERT +- [ ] Linked in P6 Evidence Pack +- [ ] Release record created + +**Dependencies:** +- T006-05 (manifest must be created) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to published baseline service contract set + +--- + +## Task Closure Criteria + +**T006 is closed when:** + +- [ ] Frozen baseline set of services/contracts is produced +- [ ] All items are integration-grade (schema + CI validated) +- [ ] Baseline manifest is published and immutable +- [ ] All sub-actions (T006-01 through T006-06) are completed +- [ ] Evidence links are recorded in P6 Evidence Pack + +--- + +## Statistics + +| Metric | Count | +| :--- | :--- | +| Total Actions | 6 | +| Open | 6 | +| In Progress | 0 | +| Overdue | 0 | +| Completed | 0 | diff --git a/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_BB_GEN_LC01_K06_AI__k06-ata-46-workbreakdown_IDX_I01-R01_ACTIVE.md b/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_BB_GEN_LC01_K06_AI__k06-ata-46-workbreakdown_IDX_I01-R01_ACTIVE.md new file mode 100644 index 00000000..4713d4ae --- /dev/null +++ b/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_BB_GEN_LC01_K06_AI__k06-ata-46-workbreakdown_IDX_I01-R01_ACTIVE.md @@ -0,0 +1,123 @@ +--- +title: "K06 ATA 46 Work Breakdown Structure" +type: IDX +project: AMPEL360 +program: SPACET +variant: PLUS +status: ACTIVE +knot_id: K06 +ata: "46" +lc_or_subbucket: "LC01" +description: "Work Breakdown Structure for K06 (Data Governance / SSOT / Schemas / Identifiers) for ATA 46 (Information Systems / Data Distribution / Data Services)" +--- + +# K06 ATA 46 — Work Breakdown Structure (WBS) + +## Overview + +This index provides the Work Breakdown Structure for closing **K06** (Data Governance / SSOT / Schemas / Identifiers) for **ATA 46** (Information Systems / Data Distribution / Data Services). + +**Purpose:** Converts uncertainty into executable work packages (tasks, owners, inputs/outputs). + +**Closes:** "We don't know what to do next / who owns it." + +**Done when:** T001–T006 exist with owners, acceptance criteria, and artifact links. + +--- + +## 1) Task Summary + +| Task ID | Title | Owner | Status | Artifact Link | +| :--- | :--- | :--- | :--- | :--- | +| T001 | SSOT Source & Ownership | AI + DATA | Open | [T001 Details](46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T001_AI__k06-t001-ssot-source-ownership_ACT_I01-R01_ACTIVE.md) | +| T002 | Identifier Grammar | AI + DATA | Open | [T002 Details](46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T002_AI__k06-t002-identifier-grammar_ACT_I01-R01_ACTIVE.md) | +| T003 | Schema Definition | AI + SE | Open | [T003 Details](46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T003_AI__k06-t003-schema-definition_ACT_I01-R01_ACTIVE.md) | +| T004 | Export Publication | AI + DATA | Open | [T004 Details](46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T004_AI__k06-t004-export-publication_ACT_I01-R01_ACTIVE.md) | +| T005 | CI Validation Gates | AI + CM | Open | [T005 Details](46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T005_AI__k06-t005-ci-validation-gates_ACT_I01-R01_ACTIVE.md) | +| T006 | Baseline Service Contract Set | AI + CERT | Open | [T006 Details](46_AMPEL360_SPACET_Q10_BASELINE_PLUS_PR_GEN_LC06_K06-T006_AI__k06-t006-baseline-service-contract-set_ACT_I01-R01_ACTIVE.md) | + +--- + +## 2) RACI Matrix + +See: [RACI Matrix (CSV)](46_AMPEL360_SPACET_Q10_GEN_PLUS_BB_GEN_LC06_K06_AI__k06-ata-46-raci_MAT_I01-R01_ACTIVE.csv) + +### RACI Summary + +| Task | AI | DATA | CM | SE | CERT | OPS | V&V | +| :--- | :--- | :--- | :--- | :--- | :--- | :--- | :--- | +| T001 (SSOT) | R | A | C | C | I | I | I | +| T002 (IDs) | R | A | C | C | I | I | I | +| T003 (Schema) | R | C | C | A | I | C | I | +| T004 (Export) | R | A | C | C | I | C | I | +| T005 (CI Gates) | R | C | A | C | I | I | I | +| T006 (Baseline) | R | C | C | C | A | C | R | + +**Legend:** +- **R** = Responsible (does the work) +- **A** = Accountable (approves/signs-off) +- **C** = Consulted (provides input) +- **I** = Informed (notified of outcomes) + +--- + +## 3) Dependencies & Sequencing + +``` +T001 (SSOT) --+--> T002 (IDs) --> T003 (Schema) --+--> T004 (Export) --> T006 (Baseline) + | | + +------------------------------------+--> T005 (CI Gates) +``` + +### Dependency Table + +| Task | Depends On | Enables | +| :--- | :--- | :--- | +| T001 | None | T002, T003, T004, T005 | +| T002 | T001 | T003, T004 | +| T003 | T001, T002 | T004, T005 | +| T004 | T001, T002, T003 | T006 | +| T005 | T001, T003 | T006 | +| T006 | T004, T005 | None (closure artifact) | + +--- + +## 4) Acceptance Criteria (WBS Closure) + +This WBS index is **closed** when: + +- [ ] All T001–T006 task files exist and are linked +- [ ] Each task has an assigned owner (not "TBD") +- [ ] Each task has explicit acceptance criteria +- [ ] RACI matrix is approved by CM WG +- [ ] Dependencies are documented and accepted + +--- + +## 5) Cross-Reference Links + +### Parent Index +- [K06 ATA 46 Tasklist](../46_AMPEL360_SPACET_Q10_GEN_PLUS_BB_GEN_LC01_K06_AI__k06-ata-46-tasklist_IDX_I01-R01_ACTIVE.md) + +### Related K06 WBS (Other ATAs) +- [ATA 45 WBS](../../ATA_45/) +- [ATA 91 WBS](../../ATA_91/) +- [ATA 93 WBS](../../ATA_93/) +- [ATA 99 WBS](../../ATA_99/) +- [ATA 101 WBS](../../ATA_101/) + +--- + +## Maintenance + +**Last Updated:** 2025-12-17 +**Update Frequency:** Per task status change +**Maintained By:** AI + DATA Teams + +--- + +## Notes + +- Task IDs (T001–T006) are stable and permanent. +- New tasks (T007+) require CM WG approval and WBS update. +- Evidence of task completion must be linked before status changes to "Closed". diff --git a/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_BB_GEN_LC06_K06_AI__k06-ata-46-raci_MAT_I01-R01_ACTIVE.csv b/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_BB_GEN_LC06_K06_AI__k06-ata-46-raci_MAT_I01-R01_ACTIVE.csv new file mode 100644 index 00000000..73f2c196 --- /dev/null +++ b/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_BB_GEN_LC06_K06_AI__k06-ata-46-raci_MAT_I01-R01_ACTIVE.csv @@ -0,0 +1,7 @@ +Task_ID,Task_Title,AI,DATA,CM,SE,CERT,OPS,V&V,Notes +T001,SSOT Source & Ownership,R,A,C,C,I,I,I,Declares authoritative SSOT for service catalogs/contracts/datasets and defines change control +T002,Identifier Grammar,R,A,C,C,I,I,I,Defines canonical IDs for services/endpoints/contracts/datasets and naming/version constraints +T003,Schema Definition,R,C,C,A,I,C,I,Stabilizes semantics for service payloads/metadata (units/frames/QoS/timing/validity) +T004,Export Publication,R,A,C,C,I,C,I,Defines deterministic export packs (service catalog + contract schemas + manifests) +T005,CI Validation Gates,R,C,A,C,I,I,I,Enforces rules and blocks noncompliant PRs (duplicate IDs/breaking changes without versioning) +T006,Baseline Service Contract Set,R,C,C,C,A,C,R,Produces frozen baseline of services/contracts for integration and ops usage diff --git a/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T001_AI__k06-t001-ssot-source-ownership_ACT_I01-R01_ACTIVE.md b/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T001_AI__k06-t001-ssot-source-ownership_ACT_I01-R01_ACTIVE.md new file mode 100644 index 00000000..1214d8ed --- /dev/null +++ b/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T001_AI__k06-t001-ssot-source-ownership_ACT_I01-R01_ACTIVE.md @@ -0,0 +1,175 @@ +--- +title: "Action Item: T001 SSOT Source & Ownership" +type: ACT +project: AMPEL360 +program: SPACET +variant: PLUS +status: ACTIVE +owner: "AI + DATA" +knot_id: K06 +task_id: T001 +ata: "46" +lc_or_subbucket: "LC06" +--- + +# T001: SSOT Source & Ownership + +## Action Items Register + +| ID | Action | Owner | Due Date | Priority | Status | Notes | +| :--- | :--- | :--- | :--- | :--- | :--- | :--- | +| T001-01 | Identify candidate SSOT sources for service catalogs and contracts | DATA | TBD | High | Open | Survey existing catalogs | +| T001-02 | Define ownership model (primary owner, custodians, consumers) | AI + CM | TBD | High | Open | RACI alignment | +| T001-03 | Document change control process for SSOT | CM | TBD | Medium | Open | CM WG approval required | +| T001-04 | Create SSOT declaration artifact | DATA | TBD | High | Open | Formal documentation | + +--- + +## Action Item Details + +### T001-01: Identify Candidate SSOT Sources + +**Created:** 2025-12-17 +**Owner:** DATA +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Survey and document all existing data sources that contain service catalogs, API endpoint registries, contract definitions, dataset inventories, and routing rules. Evaluate each for SSOT candidacy. + +**Context:** +K06 requires a single authoritative SSOT for information-systems data governance. Without identification of candidate sources, we cannot make an informed decision about which source should be authoritative. + +**Acceptance Criteria:** +- [ ] Complete inventory of existing service catalog and contract data sources +- [ ] Each source documented with: location, owner, update frequency, consumers +- [ ] Candidate sources ranked by SSOT suitability +- [ ] Recommendation documented + +**Dependencies:** +- None (initial task) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to SSOT candidates assessment report + +--- + +### T001-02: Define Ownership Model + +**Created:** 2025-12-17 +**Owner:** AI + CM +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Define the ownership model for the selected SSOT, including primary owner, data custodians, and authorized consumers. + +**Context:** +Clear ownership prevents "orphan data" and ensures accountability for data quality and change control across service catalogs and contracts. + +**Acceptance Criteria:** +- [ ] Primary owner identified and accepted +- [ ] Data custodian roles defined +- [ ] Consumer access model documented +- [ ] Ownership model approved by CM WG + +**Dependencies:** +- T001-01 (need to know which SSOT before defining ownership) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to ownership model document + +--- + +### T001-03: Document Change Control Process + +**Created:** 2025-12-17 +**Owner:** CM +**Due Date:** TBD +**Priority:** Medium +**Status:** Open + +**Description:** +Document the change control process for modifications to the SSOT, including approval workflow and audit trail requirements. + +**Context:** +Change control ensures SSOT integrity for service catalogs, contracts, and routing rules, and provides traceability for certification. + +**Acceptance Criteria:** +- [ ] Change request process documented +- [ ] Approval workflow defined (who approves what) +- [ ] Audit trail requirements specified +- [ ] Process approved by CM WG + +**Dependencies:** +- T001-02 (ownership model must be defined first) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to change control process document + +--- + +### T001-04: Create SSOT Declaration Artifact + +**Created:** 2025-12-17 +**Owner:** DATA +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Create the formal SSOT declaration artifact that documents the authoritative source, ownership, and governance rules for service catalogs, API registries, contracts, and data distribution metadata. + +**Context:** +This artifact serves as the binding declaration that closes the "what is the source of truth?" uncertainty for ATA 46 information systems. + +**Acceptance Criteria:** +- [ ] SSOT declaration document created +- [ ] References T001-01 through T001-03 outputs +- [ ] Signed-off by primary owner +- [ ] Approved by CM WG +- [ ] Linked in evidence pack + +**Dependencies:** +- T001-01, T001-02, T001-03 (all prior tasks) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to SSOT declaration artifact + +--- + +## Task Closure Criteria + +**T001 is closed when:** + +- [ ] Authoritative SSOT for service catalogs, contracts, and datasets is declared +- [ ] Data distribution and routing rule sources are identified and documented +- [ ] Change control process is established and approved +- [ ] All sub-actions (T001-01 through T001-04) are completed +- [ ] Evidence links are recorded in P6 Evidence Pack + +--- + +## Statistics + +| Metric | Count | +| :--- | :--- | +| Total Actions | 4 | +| Open | 4 | +| In Progress | 0 | +| Overdue | 0 | +| Completed | 0 | diff --git a/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T002_AI__k06-t002-identifier-grammar_ACT_I01-R01_ACTIVE.md b/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T002_AI__k06-t002-identifier-grammar_ACT_I01-R01_ACTIVE.md new file mode 100644 index 00000000..bb5dfc1f --- /dev/null +++ b/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T002_AI__k06-t002-identifier-grammar_ACT_I01-R01_ACTIVE.md @@ -0,0 +1,207 @@ +--- +title: "Action Item: T002 Identifier Grammar" +type: ACT +project: AMPEL360 +program: SPACET +variant: PLUS +status: ACTIVE +owner: "AI + DATA" +knot_id: K06 +task_id: T002 +ata: "46" +lc_or_subbucket: "LC06" +--- + +# T002: Identifier Grammar + +## Action Items Register + +| ID | Action | Owner | Due Date | Priority | Status | Notes | +| :--- | :--- | :--- | :--- | :--- | :--- | :--- | +| T002-01 | Survey existing identifier schemes | DATA | TBD | High | Open | Document current patterns | +| T002-02 | Define canonical ID grammar for services and contracts | AI + SE | TBD | High | Open | Formal specification | +| T002-03 | Define deduplication rules | DATA | TBD | Medium | Open | Prevent duplicate IDs | +| T002-04 | Create identifier allocation process | CM | TBD | Medium | Open | Change control integration | +| T002-05 | Publish identifier grammar standard | DATA | TBD | High | Open | STD artifact | + +--- + +## Action Item Details + +### T002-01: Survey Existing Identifier Schemes + +**Created:** 2025-12-17 +**Owner:** DATA +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Survey and document all existing identifier schemes used for data services, API endpoints, service contracts, datasets, and routing rules. + +**Context:** +Understanding existing schemes is necessary to design a compatible canonical grammar that doesn't break existing references. + +**Acceptance Criteria:** +- [ ] Inventory of existing ID schemes documented +- [ ] Each scheme: format, scope, usage context, issuing authority +- [ ] Compatibility constraints identified +- [ ] Gap analysis completed + +**Dependencies:** +- T001 (SSOT must be identified to know where IDs are used) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to identifier survey report + +--- + +### T002-02: Define Canonical ID Grammar + +**Created:** 2025-12-17 +**Owner:** AI + SE +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Define the canonical identifier grammar for all information-systems entities including data services, API endpoints, service contracts, datasets, and routing configurations. + +**Context:** +A stable, unique ID grammar prevents duplicates and enables traceability across the service lifecycle. + +**Acceptance Criteria:** +- [ ] Grammar specification document created +- [ ] Covers: services, endpoints, contracts, datasets, routing configs +- [ ] Format rules: components, separators, length, allowed characters +- [ ] Uniqueness guarantees documented +- [ ] Examples provided for each entity type + +**Dependencies:** +- T002-01 (survey must be complete first) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to identifier grammar specification + +--- + +### T002-03: Define Deduplication Rules + +**Created:** 2025-12-17 +**Owner:** DATA +**Due Date:** TBD +**Priority:** Medium +**Status:** Open + +**Description:** +Define rules and mechanisms to prevent duplicate identifiers from being issued across service registries and contract databases. + +**Context:** +Duplicate IDs cause routing failures, contract conflicts, and traceability breakdowns. + +**Acceptance Criteria:** +- [ ] Deduplication rules documented +- [ ] Collision detection mechanism specified +- [ ] Remediation process for discovered duplicates +- [ ] CI integration requirements defined + +**Dependencies:** +- T002-02 (grammar must be defined to define dedup rules) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to deduplication rules document + +--- + +### T002-04: Create Identifier Allocation Process + +**Created:** 2025-12-17 +**Owner:** CM +**Due Date:** TBD +**Priority:** Medium +**Status:** Open + +**Description:** +Create the process for allocating new identifiers, including request workflow, approval, and registry update. + +**Context:** +Controlled allocation ensures ID uniqueness and maintains registry integrity for services and contracts. + +**Acceptance Criteria:** +- [ ] Allocation process documented +- [ ] Request/approval workflow defined +- [ ] Registry update procedure defined +- [ ] Automation opportunities identified + +**Dependencies:** +- T002-02, T002-03 (grammar and dedup rules) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to allocation process document + +--- + +### T002-05: Publish Identifier Grammar Standard + +**Created:** 2025-12-17 +**Owner:** DATA +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Publish the identifier grammar as a formal standard (STD artifact) for use across ATA 46. + +**Context:** +A published standard enables consistent implementation and provides certification evidence. + +**Acceptance Criteria:** +- [ ] STD artifact created with full grammar specification +- [ ] Approved by CM WG +- [ ] Referenced from P2 (IDs & Registry) partition +- [ ] Linked in evidence pack + +**Dependencies:** +- T002-01 through T002-04 (all prior tasks) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to published identifier grammar STD + +--- + +## Task Closure Criteria + +**T002 is closed when:** + +- [ ] Canonical IDs defined for services/endpoints/contracts/datasets/routing configs +- [ ] Deduplication rules prevent duplicate identifiers +- [ ] Identifier grammar standard is published and approved +- [ ] All sub-actions (T002-01 through T002-05) are completed +- [ ] Evidence links are recorded in P6 Evidence Pack + +--- + +## Statistics + +| Metric | Count | +| :--- | :--- | +| Total Actions | 5 | +| Open | 5 | +| In Progress | 0 | +| Overdue | 0 | +| Completed | 0 | diff --git a/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T003_AI__k06-t003-schema-definition_ACT_I01-R01_ACTIVE.md b/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T003_AI__k06-t003-schema-definition_ACT_I01-R01_ACTIVE.md new file mode 100644 index 00000000..5c6a7cc5 --- /dev/null +++ b/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T003_AI__k06-t003-schema-definition_ACT_I01-R01_ACTIVE.md @@ -0,0 +1,240 @@ +--- +title: "Action Item: T003 Schema Definition" +type: ACT +project: AMPEL360 +program: SPACET +variant: PLUS +status: ACTIVE +owner: "AI + SE" +knot_id: K06 +task_id: T003 +ata: "46" +lc_or_subbucket: "LC06" +--- + +# T003: Schema Definition + +## Action Items Register + +| ID | Action | Owner | Due Date | Priority | Status | Notes | +| :--- | :--- | :--- | :--- | :--- | :--- | :--- | +| T003-01 | Define service payload schema | AI + SE | TBD | High | Open | Core schema structure | +| T003-02 | Define service metadata schema | SE | TBD | High | Open | QoS, timing, validity metadata | +| T003-03 | Define contract interface schema | AI + SE | TBD | High | Open | Contract terms, SLAs | +| T003-04 | Define routing and distribution schema | SE + OPS | TBD | High | Open | Topic/routing/labeling rules | +| T003-05 | Define schema versioning policy | CM | TBD | Medium | Open | Compatibility rules | +| T003-06 | Publish consolidated schema | AI | TBD | High | Open | SCH artifact | + +--- + +## Action Item Details + +### T003-01: Define Service Payload Schema + +**Created:** 2025-12-17 +**Owner:** AI + SE +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Define the schema for service payloads including data format, encoding, field definitions, and validation rules for data services and API endpoints. + +**Context:** +Service payload schemas are the foundation for semantic interoperability and enable downstream consumers to parse and validate data correctly. + +**Acceptance Criteria:** +- [ ] Schema fields defined: payload format, encoding, data types, constraints +- [ ] Field types, formats, and constraints specified +- [ ] Required vs optional fields documented +- [ ] JSON Schema draft created + +**Dependencies:** +- T001 (SSOT), T002 (Identifier grammar) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to service payload schema draft + +--- + +### T003-02: Define Service Metadata Schema + +**Created:** 2025-12-17 +**Owner:** SE +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Define the schema for service metadata including QoS parameters, timing constraints, validity windows, data retention policies, and access control metadata. + +**Context:** +Metadata schemas ensure that consumers understand service characteristics and can integrate reliably. + +**Acceptance Criteria:** +- [ ] Schema fields: QoS, timing, validity, retention, access control +- [ ] Units, tolerances, and frames documented +- [ ] Data retention policy encoding specified +- [ ] JSON Schema draft created + +**Dependencies:** +- T003-01 (payload schema must be defined first) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to service metadata schema draft + +--- + +### T003-03: Define Contract Interface Schema + +**Created:** 2025-12-17 +**Owner:** AI + SE +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Define the schema for service contracts including contract terms, service-level agreements (SLAs), interface specifications, and versioning metadata. + +**Context:** +Standardized contract schemas enable consistent service negotiation and compliance verification. + +**Acceptance Criteria:** +- [ ] Schema fields: contract terms, SLAs, interface specs, versioning +- [ ] Provider/consumer roles encoded +- [ ] Compliance verification rules defined +- [ ] JSON Schema draft created + +**Dependencies:** +- T003-01, T003-02 (payload and metadata schemas must be defined) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to contract interface schema draft + +--- + +### T003-04: Define Routing and Distribution Schema + +**Created:** 2025-12-17 +**Owner:** SE + OPS +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Define the schema for routing rules, topic/labeling conventions, and data distribution configurations that govern how data flows between services. + +**Context:** +Routing and distribution schemas prevent silent interoperability failures and ensure deterministic data flow. + +**Acceptance Criteria:** +- [ ] Routing rule structure defined (topic, label, filter, priority) +- [ ] Distribution configuration schema specified +- [ ] Labeling/tagging convention documented +- [ ] JSON Schema draft created + +**Dependencies:** +- T003-01, T003-02, T003-03 (all prior schemas) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to routing and distribution schema draft + +--- + +### T003-05: Define Schema Versioning Policy + +**Created:** 2025-12-17 +**Owner:** CM +**Due Date:** TBD +**Priority:** Medium +**Status:** Open + +**Description:** +Define the versioning policy for the schema including semantic versioning rules, compatibility requirements, and migration procedures. + +**Context:** +Versioning policy ensures consumers can handle schema evolution without breaking. + +**Acceptance Criteria:** +- [ ] Semantic versioning rules defined +- [ ] Breaking vs non-breaking change definitions +- [ ] Compatibility matrix requirements +- [ ] Migration procedure documented +- [ ] Approved by CM WG + +**Dependencies:** +- T003-01 through T003-04 (schema must exist to version) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to versioning policy document + +--- + +### T003-06: Publish Consolidated Schema + +**Created:** 2025-12-17 +**Owner:** AI +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Publish the consolidated information-systems schema as a formal SCH artifact covering service payloads, metadata, contracts, and routing rules. + +**Context:** +A published schema is the normative reference for all consumers and CI validation. + +**Acceptance Criteria:** +- [ ] Consolidated JSON Schema created (SCH artifact) +- [ ] Documentation artifact created +- [ ] Schema validates sample exports +- [ ] Approved by SE and CM WG +- [ ] Linked in evidence pack + +**Dependencies:** +- T003-01 through T003-05 (all prior tasks) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to published schema SCH artifact + +--- + +## Task Closure Criteria + +**T003 is closed when:** + +- [ ] Semantics for service payloads, metadata, contracts, and routing rules are stabilized +- [ ] Schema versioning policy is established +- [ ] Consolidated schema is published and approved +- [ ] All sub-actions (T003-01 through T003-06) are completed +- [ ] Evidence links are recorded in P6 Evidence Pack + +--- + +## Statistics + +| Metric | Count | +| :--- | :--- | +| Total Actions | 6 | +| Open | 6 | +| In Progress | 0 | +| Overdue | 0 | +| Completed | 0 | diff --git a/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T004_AI__k06-t004-export-publication_ACT_I01-R01_ACTIVE.md b/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T004_AI__k06-t004-export-publication_ACT_I01-R01_ACTIVE.md new file mode 100644 index 00000000..4c1122c5 --- /dev/null +++ b/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T004_AI__k06-t004-export-publication_ACT_I01-R01_ACTIVE.md @@ -0,0 +1,207 @@ +--- +title: "Action Item: T004 Export Publication" +type: ACT +project: AMPEL360 +program: SPACET +variant: PLUS +status: ACTIVE +owner: "AI + DATA" +knot_id: K06 +task_id: T004 +ata: "46" +lc_or_subbucket: "LC06" +--- + +# T004: Export Publication + +## Action Items Register + +| ID | Action | Owner | Due Date | Priority | Status | Notes | +| :--- | :--- | :--- | :--- | :--- | :--- | :--- | +| T004-01 | Define export pack structure | DATA | TBD | High | Open | Manifest + catalog + contracts | +| T004-02 | Define manifest format | AI | TBD | High | Open | Deterministic generation | +| T004-03 | Define contract bundle format | SE + OPS | TBD | High | Open | Link to service registry | +| T004-04 | Create export generation tooling | AI | TBD | Medium | Open | Automation | +| T004-05 | Publish export publication standard | DATA | TBD | High | Open | STD artifact | + +--- + +## Action Item Details + +### T004-01: Define Export Pack Structure + +**Created:** 2025-12-17 +**Owner:** DATA +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Define the structure of deterministic export packs including service catalogs, contract schemas, routing manifests, and metadata bundles. + +**Context:** +Export packs enable downstream consumers (integration, ops monitoring, sim/test harnesses, traceability/DPP exports) to consume service governance data consistently. + +**Acceptance Criteria:** +- [ ] Directory/file structure defined +- [ ] Manifest location and naming specified +- [ ] Service catalog packaging rules defined +- [ ] Contract schema bundling requirements specified +- [ ] Determinism requirements documented + +**Dependencies:** +- T001 (SSOT), T002 (IDs), T003 (Schema) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to export pack structure specification + +--- + +### T004-02: Define Manifest Format + +**Created:** 2025-12-17 +**Owner:** AI +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Define the manifest format for export packs including required fields, generation rules, and integrity verification. + +**Context:** +Manifests enable consumers to verify export completeness and provenance. + +**Acceptance Criteria:** +- [ ] Manifest schema defined (JSON/YAML) +- [ ] Required fields: version, timestamp, sources, checksums +- [ ] Deterministic generation rules documented +- [ ] SHA-256 integrity verification specified + +**Dependencies:** +- T004-01 (structure must be defined first) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to manifest format specification + +--- + +### T004-03: Define Contract Bundle Format + +**Created:** 2025-12-17 +**Owner:** SE + OPS +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Define the format for contract bundles that link export packs to the service registry and provide integration-ready artifacts. + +**Context:** +Contract bundles enable operations and integration teams to consume service contracts with routing and QoS metadata. + +**Acceptance Criteria:** +- [ ] Bundle format defined (directory structure, file formats) +- [ ] Contract-to-service linking rules specified +- [ ] Routing metadata inclusion requirements documented +- [ ] Integration with service registry documented + +**Dependencies:** +- T004-01, T004-02 (structure and manifest) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to contract bundle format specification + +--- + +### T004-04: Create Export Generation Tooling + +**Created:** 2025-12-17 +**Owner:** AI +**Due Date:** TBD +**Priority:** Medium +**Status:** Open + +**Description:** +Create tooling (scripts, CI jobs) to generate export packs deterministically from the service catalog and contract registry. + +**Context:** +Automation ensures consistent export generation and reduces human error. + +**Acceptance Criteria:** +- [ ] Export generation script created +- [ ] CI integration defined +- [ ] Determinism verification (same inputs → same outputs) +- [ ] Documentation for tooling usage + +**Dependencies:** +- T004-01, T004-02, T004-03 (all format specs) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to tooling and documentation + +--- + +### T004-05: Publish Export Publication Standard + +**Created:** 2025-12-17 +**Owner:** DATA +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Publish the export publication rules as a formal standard (STD artifact). + +**Context:** +A published standard enables consistent implementation and provides certification evidence. + +**Acceptance Criteria:** +- [ ] STD artifact created +- [ ] References T004-01 through T004-04 outputs +- [ ] Approved by CM WG +- [ ] Linked in evidence pack + +**Dependencies:** +- T004-01 through T004-04 (all prior tasks) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to published export publication STD + +--- + +## Task Closure Criteria + +**T004 is closed when:** + +- [ ] Deterministic export packs are defined (service catalog + contract schemas + manifests) +- [ ] Export generation tooling is available +- [ ] Export publication standard is published and approved +- [ ] All sub-actions (T004-01 through T004-05) are completed +- [ ] Evidence links are recorded in P6 Evidence Pack + +--- + +## Statistics + +| Metric | Count | +| :--- | :--- | +| Total Actions | 5 | +| Open | 5 | +| In Progress | 0 | +| Overdue | 0 | +| Completed | 0 | diff --git a/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T005_AI__k06-t005-ci-validation-gates_ACT_I01-R01_ACTIVE.md b/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T005_AI__k06-t005-ci-validation-gates_ACT_I01-R01_ACTIVE.md new file mode 100644 index 00000000..f8fb23a1 --- /dev/null +++ b/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T005_AI__k06-t005-ci-validation-gates_ACT_I01-R01_ACTIVE.md @@ -0,0 +1,207 @@ +--- +title: "Action Item: T005 CI Validation Gates" +type: ACT +project: AMPEL360 +program: SPACET +variant: PLUS +status: ACTIVE +owner: "AI + CM" +knot_id: K06 +task_id: T005 +ata: "46" +lc_or_subbucket: "LC06" +--- + +# T005: CI Validation Gates + +## Action Items Register + +| ID | Action | Owner | Due Date | Priority | Status | Notes | +| :--- | :--- | :--- | :--- | :--- | :--- | :--- | +| T005-01 | Define duplicate ID detection rules | CM + AI | TBD | High | Open | Prevent duplicate service IDs | +| T005-02 | Define breaking change validation rules | SE + CM | TBD | High | Open | Schema/contract versioning enforcement | +| T005-03 | Implement CI gate checks | AI | TBD | High | Open | GitHub Actions/CI pipeline | +| T005-04 | Define gate failure remediation | CM | TBD | Medium | Open | Fix/override process | +| T005-05 | Publish CI validation requirements | CM | TBD | High | Open | STD artifact | + +--- + +## Action Item Details + +### T005-01: Define Duplicate ID Detection Rules + +**Created:** 2025-12-17 +**Owner:** CM + AI +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Define the rules that CI gates will use to detect and prevent duplicate service identifiers, endpoint names, and contract IDs across the registry. + +**Context:** +Duplicate IDs cause routing failures, contract conflicts, and silent interoperability breakdowns in data distribution. + +**Acceptance Criteria:** +- [ ] Duplicate detection requirements documented +- [ ] Scope: service IDs, endpoint names, contract IDs, dataset IDs +- [ ] Validation rules: uniqueness, format, namespace isolation +- [ ] Failure conditions defined + +**Dependencies:** +- T001 (SSOT), T002 (Identifier grammar) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to duplicate ID detection rules + +--- + +### T005-02: Define Breaking Change Validation Rules + +**Created:** 2025-12-17 +**Owner:** SE + CM +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Define the rules that CI gates will use to detect breaking changes in schemas and contracts that are not accompanied by proper versioning. + +**Context:** +Unversioned breaking changes in service schemas and contracts cause silent downstream failures. + +**Acceptance Criteria:** +- [ ] Breaking change definitions documented +- [ ] Required actions: version bump, migration guide, consumer notification +- [ ] Validation rules: schema diff, contract compatibility +- [ ] Failure conditions defined + +**Dependencies:** +- T003 (Schema), T005-01 (duplicate ID rules) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to breaking change validation rules + +--- + +### T005-03: Implement CI Gate Checks + +**Created:** 2025-12-17 +**Owner:** AI +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Implement the CI gate checks as automated validations in the CI pipeline (GitHub Actions or equivalent). + +**Context:** +Automated gates enforce governance non-optionally and block noncompliant PRs from merging. + +**Acceptance Criteria:** +- [ ] CI workflow created/updated +- [ ] Duplicate ID checks implemented +- [ ] Breaking change checks implemented +- [ ] Gate pass/fail clearly reported +- [ ] Blocking behavior confirmed + +**Dependencies:** +- T005-01, T005-02 (rules must be defined first) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to CI workflow and sample run + +--- + +### T005-04: Define Gate Failure Remediation + +**Created:** 2025-12-17 +**Owner:** CM +**Due Date:** TBD +**Priority:** Medium +**Status:** Open + +**Description:** +Define the process for remediating CI gate failures including fix workflow, exception process, and override authority. + +**Context:** +Clear remediation process prevents blocked work and provides escape hatch for legitimate exceptions. + +**Acceptance Criteria:** +- [ ] Fix workflow documented +- [ ] Exception request process defined +- [ ] Override authority and approval defined +- [ ] Override audit trail requirements + +**Dependencies:** +- T005-03 (gates must be implemented to fail) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to remediation process document + +--- + +### T005-05: Publish CI Validation Requirements + +**Created:** 2025-12-17 +**Owner:** CM +**Due Date:** TBD +**Priority:** High +**Status:** Open + +**Description:** +Publish the CI validation requirements as a formal standard (STD artifact). + +**Context:** +A published standard enables consistent enforcement and provides certification evidence. + +**Acceptance Criteria:** +- [ ] STD artifact created +- [ ] References T005-01 through T005-04 outputs +- [ ] Approved by CM WG +- [ ] Linked in evidence pack + +**Dependencies:** +- T005-01 through T005-04 (all prior tasks) + +**Progress Updates:** +- 2025-12-17 - Task created + +**Completion Evidence:** +TBD - Link to published CI validation requirements STD + +--- + +## Task Closure Criteria + +**T005 is closed when:** + +- [ ] Duplicate ID detection and breaking change rules are enforced via CI gates +- [ ] Gates block noncompliant PRs from merging +- [ ] CI validation requirements standard is published and approved +- [ ] All sub-actions (T005-01 through T005-05) are completed +- [ ] Evidence links are recorded in P6 Evidence Pack + +--- + +## Statistics + +| Metric | Count | +| :--- | :--- | +| Total Actions | 5 | +| Open | 5 | +| In Progress | 0 | +| Overdue | 0 | +| Completed | 0 | diff --git a/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/46_AMPEL360_SPACET_Q10_GEN_PLUS_BB_GEN_LC01_K06_AI__k06-ata-46-tasklist_IDX_I01-R01_ACTIVE.md b/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/46_AMPEL360_SPACET_Q10_GEN_PLUS_BB_GEN_LC01_K06_AI__k06-ata-46-tasklist_IDX_I01-R01_ACTIVE.md index d3580657..10df9a0d 100644 --- a/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/46_AMPEL360_SPACET_Q10_GEN_PLUS_BB_GEN_LC01_K06_AI__k06-ata-46-tasklist_IDX_I01-R01_ACTIVE.md +++ b/AMPEL360-SPACE-T-PORTAL/STK_AI-ai-ai-ml-engineering/KNOTS/K06_data-governance-ssot-schemas-identifiers/ATA_TASKS/ATA_46/46_AMPEL360_SPACET_Q10_GEN_PLUS_BB_GEN_LC01_K06_AI__k06-ata-46-tasklist_IDX_I01-R01_ACTIVE.md @@ -58,31 +58,31 @@ Each partition corresponds to a dedicated folder. **Do not credit closure** unle - Folder: [01_WBS/](01_WBS/) _Comment:_ Converts uncertainty into executable work packages (tasks, owners, inputs/outputs). -- WBS index: [K06 ATA 46 Work Breakdown](01_WBS/46_00_IDX_LC01_AMPEL360_SPACET_PLUS_k06-ata-46-workbreakdown_I01-R01.md) +- WBS index: [K06 ATA 46 Work Breakdown](01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_BB_GEN_LC01_K06_AI__k06-ata-46-workbreakdown_IDX_I01-R01_ACTIVE.md) _Closes:_ “We don’t know what to do next / who owns it.” _Done when:_ T001–T006 exist with owners, acceptance criteria, and artifact links. -- RACI (CSV): [RACI](01_WBS/46_00_MAT_LC06_AMPEL360_SPACET_PLUS_k06-ata-46-raci_I01-R01.csv) +- RACI (CSV): [RACI](01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_BB_GEN_LC06_K06_AI__k06-ata-46-raci_MAT_I01-R01_ACTIVE.csv) _Closes:_ Responsibility ambiguity (execution vs approval). _Done when:_ CM approval path is explicit and accepted. **Task stubs (minimum set):** -- T001: [SSOT source & ownership](01_WBS/46_00_ACT_LC06_AMPEL360_SPACET_PLUS_k06-t001-ssot-source-ownership_I01-R01.md) +- T001: [SSOT source & ownership](01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T001_AI__k06-t001-ssot-source-ownership_ACT_I01-R01_ACTIVE.md) _Comment:_ Declares authoritative SSOT for service catalogs/contracts/datasets and defines change control. -- T002: [Identifier grammar](01_WBS/46_00_ACT_LC06_AMPEL360_SPACET_PLUS_k06-t002-identifier-grammar_I01-R01.md) +- T002: [Identifier grammar](01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T002_AI__k06-t002-identifier-grammar_ACT_I01-R01_ACTIVE.md) _Comment:_ Defines canonical IDs for services/endpoints/contracts/datasets and naming/version constraints. -- T003: [Schema definition](01_WBS/46_00_ACT_LC06_AMPEL360_SPACET_PLUS_k06-t003-schema-definition_I01-R01.md) +- T003: [Schema definition](01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T003_AI__k06-t003-schema-definition_ACT_I01-R01_ACTIVE.md) _Comment:_ Stabilizes semantics for payloads/metadata (units, frames, QoS, timing, validity). -- T004: [Export publication](01_WBS/46_00_ACT_LC06_AMPEL360_SPACET_PLUS_k06-t004-export-publication_I01-R01.md) +- T004: [Export publication](01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T004_AI__k06-t004-export-publication_ACT_I01-R01_ACTIVE.md) _Comment:_ Defines deterministic export packs (service catalog + contract schemas + manifests). -- T005: [CI validation gates](01_WBS/46_00_ACT_LC06_AMPEL360_SPACET_PLUS_k06-t005-ci-validation-gates_I01-R01.md) +- T005: [CI validation gates](01_WBS/46_AMPEL360_SPACET_Q10_GEN_PLUS_PR_GEN_LC06_K06-T005_AI__k06-t005-ci-validation-gates_ACT_I01-R01_ACTIVE.md) _Comment:_ Enforces rules; blocks noncompliant PRs (duplicate IDs, breaking changes without versioning). -- T006: [Baseline service contract set](01_WBS/46_00_ACT_LC06_AMPEL360_SPACET_PLUS_k06-t006-baseline-service-contract-set_I01-R01.md) +- T006: [Baseline service contract set](01_WBS/46_AMPEL360_SPACET_Q10_BASELINE_PLUS_PR_GEN_LC06_K06-T006_AI__k06-t006-baseline-service-contract-set_ACT_I01-R01_ACTIVE.md) _Comment:_ Produces a frozen baseline of services/contracts for integration and ops usage. ---