feat(P-001, P-002): 0pt→N0D quality delegation + internal OpenAPI
Security Scan (SIAX Cloud) / security (push) Successful in 14s
CI (SIAX Cloud) / security (pull_request) Successful in 18s
Security Scan (SIAX Cloud) / security (pull_request) Successful in 18s
CI (SIAX Cloud) / quality (pull_request) Failing after 20s
CI (SIAX Cloud) / quality (push) Failing after 23s
CI (SIAX Cloud) / integration (pull_request) Failing after 26s
CI (SIAX Cloud) / integration (push) Failing after 29s
CI (SIAX Cloud) / security (push) Successful in 29s

P-001 (owner-seam):
- Add runDataQuality(input: RunDataQualityInput) to N0dClient
  → POST /v1/n0d/quality/run (n0dRunDataQuality operation)
- Replace generic createJob in quality-service.ts with runDataQuality
  — N0D OWNS quality execution; 0pt delegates via the specific route
- MockN0dClient + HttpN0dClient implementations
- Add contract test: runDataQuality → /v1/n0d/quality/run

P-002 (internal OpenAPI):
- Add 5 quality operations to contracts/openapi.yaml:
  0pt.quality.run, 0pt.quality.list_runs, 0pt.quality.bridge_run,
  0pt.quality.checks, 0pt.quality.reports
- Add 0pt.n0dGetJobResult (P-001 retrieval endpoint)
- Add P-002 fixture verifying n0dGetJobResult registration +
  round-trip delegation (runDataQuality → getJobResult)

29 operations in catalog (was 21). 0pt now has a complete
quality-internal OpenAPI with honest N0D delegation boundary.
This commit is contained in:
2026-09-08 22:12:47 +02:00
committed by admin
parent 4514d97e13
commit 2d7035a3e8
5 changed files with 258 additions and 21 deletions
+99
View File
@@ -367,6 +367,105 @@ paths:
$ref: "#/components/schemas/ProvenanceRecord"
"401":
$ref: "#/components/responses/Unauthorized"
# ---------------------------------------------------------------------------
# Quality — P-002 internal OpenAPI (0pt quality delegation to N0D)
# ---------------------------------------------------------------------------
/api/0pt/quality/runs:
post:
operationId: 0pt.quality.run
summary: Execute quality checks for a dataset; delegates to N0D via n0dRunDataQuality when any rule needs the GE backend.
x-siax-status: target
tags: [Quality]
requestBody:
required: true
content:
application/json:
schema:
type: object
required: [tenant_id, dataset_id]
properties:
tenant_id: { type: string }
dataset_id: { type: string }
dataset_version: { type: integer }
responses:
"201":
description: Quality run accepted (status=delegated when offloaded to N0D).
"404":
description: No active rules for the dataset.
get:
operationId: 0pt.quality.list_runs
summary: List quality runs for a tenant.
x-siax-status: target
tags: [Quality]
parameters:
- { name: tenant_id, in: query, required: true, schema: { type: string } }
responses:
"200":
description: List of quality runs.
/api/0pt/quality/bridge-run:
post:
operationId: 0pt.quality.bridge_run
summary: Advisory quality bridge — auto-provisions baseline rules, runs QualityService.runQuality; Python engine calls through here. Fail-open.
x-siax-status: target
tags: [Quality]
requestBody:
required: true
content:
application/json:
schema:
type: object
required: [tenant_id, dataset_id]
properties:
tenant_id: { type: string }
dataset_id: { type: string }
responses:
"200":
description: Run + any open issues.
/api/0pt/quality/checks:
get:
operationId: 0pt.quality.checks
summary: List active quality checks/rules for a tenant+dataset.
x-siax-status: target
tags: [Quality]
parameters:
- { name: tenant_id, in: query, required: true, schema: { type: string } }
- { name: dataset_id, in: query, required: true, schema: { type: string } }
responses:
"200":
description: Active quality rules.
/api/0pt/quality/reports:
get:
operationId: 0pt.quality.reports
summary: Retrieve quality reports / Great Expectations results for a run.
x-siax-status: target
tags: [Quality]
parameters:
- { name: run_id, in: query, required: true, schema: { type: string } }
responses:
"200":
description: Quality report.
# ---------------------------------------------------------------------------
# N0D interop — 0pt consumption of N0D owner operations (P-001 owner-seam)
# ---------------------------------------------------------------------------
/api/0pt/n0d/results/{jobId}:
get:
operationId: 0pt.n0dGetJobResult
summary: Retrieve the result of an N0D-delegated quality job (n0dGetJobResult). Polls N0D after the quality run is delegated.
x-siax-status: target
tags: [Quality, N0D]
parameters:
- { name: jobId, in: path, required: true, schema: { type: string } }
responses:
"200":
description: N0D job result (outcome, metrics, ST0RE artifact refs).
"404":
description: Job not found or foreign-tenant probe.
components:
securitySchemes:
bearerAuth: