@netgreener/runtime 0.1.0

package/fixtures/dual-view-projection.v1.json

@@ -0,0 +1,53 @@
+{
+  "schema_name": "netgreener.observation.dual_view_golden.v1",
+  "contract_status": "observation_source_admitted_draft",
+  "purpose": "Cross-language dual-view projection parity (semantic envelope → protobuf JSON view). Additive validators only; no upload or TCK default flip.",
+  "rules": "project via admitted enum/shape mapping; digest with observation projection canonicalizer (sort keys; omit null; comma-colon JSON)",
+  "semantic_envelope": {
+    "schema_name": "netgreener.observation.v1",
+    "schema_version": 1,
+    "contract_status": "mp0_draft",
+    "batch_id": "bat_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "batch_sequence": "1",
+    "emitted_at": "2026-09-12T15:00:00Z",
+    "source": {
+      "language": "python",
+      "runtime_name": "cpython",
+      "runtime_version": "3.11.9",
+      "adapter_name": "netgreener-runtime",
+      "adapter_version": "0.1.0",
+      "runtime_instance_id": "rti_bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+      "capability_ids": ["CAP-R1"],
+      "deployment_mode": "local"
+    },
+    "routing": {
+      "project_id": 42,
+      "workload_id": "api",
+      "service_name": "api"
+    },
+    "privacy": {
+      "content_capture": "none",
+      "dimension_policy": "allowlist",
+      "route_policy": "template_or_unknown",
+      "dropped_dimension_count": 0
+    },
+    "events": [
+      {
+        "event_id": "evt_cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+        "sequence": "1",
+        "wall_time_unix_nano": "1787500805000000000",
+        "monotonic_time_ns": "5000000000",
+        "clock_source": "runtime_monotonic",
+        "record_type": "adapter_health",
+        "facts": {
+          "component": "adapter",
+          "status": "ok",
+          "reason_codes": [],
+          "counters": { "queue_depth": 0 }
+        }
+      }
+    ]
+  },
+  "expected_projection_digest": "sha256:c0000c0e7698a55a6907eb3f4d8061e22c95557557006fc5904eacd26a57a41d",
+  "expected_byte_length": 1108
+}

package/fixtures/identity-preimages.v1.json

@@ -0,0 +1,42 @@
+{
+  "schema_name": "netgreener.observation.identity_preimages.v1",
+  "contract_status": "observation_source_admitted_draft",
+  "algorithm": "sha256(length_prefixed(domain, components...)); 4-byte big-endian lengths",
+  "cases": [
+    {
+      "name": "runtime_instance_fixed_nonce",
+      "domain": "netgreener.observation.v1/runtime-instance",
+      "components": [
+        "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+      ],
+      "expected_id": "rti_e83199561ca1184e69dd68079f3859da717e38033711b63fde959422168ebd5e"
+    },
+    {
+      "name": "event_seq_1",
+      "domain": "netgreener.observation.v1/event",
+      "components": [
+        "rti_e83199561ca1184e69dd68079f3859da717e38033711b63fde959422168ebd5e",
+        "1"
+      ],
+      "expected_id": "evt_05e147d2c9270fb09b1b9caf05922d3fd18face18c7c3bc5c6d21af3df8fa1fc"
+    },
+    {
+      "name": "batch_seq_1",
+      "domain": "netgreener.observation.v1/batch",
+      "components": [
+        "rti_e83199561ca1184e69dd68079f3859da717e38033711b63fde959422168ebd5e",
+        "1"
+      ],
+      "expected_id": "bat_fd9c302bcb34cc281e44766798e0043577cb691dba223e63e99092d045931829"
+    },
+    {
+      "name": "runtime_window_close_1",
+      "domain": "netgreener.observation.v1/runtime-window",
+      "components": [
+        "rti_eb023154e6299b5e607a3e467fcd96eaf844730fe4fcf3a3543580b2e1f7185e",
+        "1"
+      ],
+      "expected_id": "rtw_22e5fb5c15ef2a50f6d7fe742cd62fe7ca61e53bc40606aa4a90b952556e1e64"
+    }
+  ]
+}

package/fixtures/mp2_shadow_digest_golden.v1.json

@@ -0,0 +1,47 @@
+{
+  "schema_name": "netgreener.mp2.shadow_digest_golden.v1",
+  "schema_version": 1,
+  "purpose": "Cross-language canonical payload digests for NETGREENER_MP2_SHADOW_COMPARE. Digest-only; no dual-POST or upload cutover.",
+  "algorithm": "sha256",
+  "encoding": "utf-8",
+  "canonical_json": {
+    "ensure_ascii": false,
+    "separators": [",", ":"],
+    "sort_keys": true
+  },
+  "cases": [
+    {
+      "id": "run_session_window_minimal",
+      "kind": "run_session_window",
+      "payload": {
+        "project_id": 1,
+        "runtime_window_id": "rtw_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+        "start_time": "2026-09-15T00:00:00.000Z",
+        "end_time": "2026-09-15T00:05:00.000Z",
+        "server_name": null,
+        "energy_kwh": null,
+        "session_metadata": {
+          "service_runtime_v0": {
+            "framework": "express",
+            "window_seconds": 60
+          }
+        }
+      },
+      "payload_sha256": "53e1bae2966f7d7f0739c9002ca110dfecb13e74c0c7838e8d687122f46f3e17"
+    },
+    {
+      "id": "observation_batch_minimal",
+      "kind": "observation_batch",
+      "payload": {
+        "schema_name": "netgreener.observation.v1",
+        "schema_version": 1,
+        "batch_id": "bat_bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+        "events": [],
+        "routing": {
+          "project_id": 1
+        }
+      },
+      "payload_sha256": "700e24823469d384d57e9efd74fac5652a87804b5e7fa570fa44e67eba4d7808"
+    }
+  ]
+}

package/fixtures/projection-batch-document.v1.json

@@ -0,0 +1,170 @@
+{
+  "protocol_major": 1,
+  "protocol_minor": 1,
+  "batch_id": "bat_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+  "batch_sequence": "9007199254740993",
+  "emitted_at": "2026-09-13T12:00:01Z",
+  "source": {
+    "language": "python",
+    "runtime_name": "cpython",
+    "runtime_version": "3.11.0",
+    "adapter_name": "fixture-adapter",
+    "adapter_version": "0.0.0",
+    "runtime_instance_id": "rti_bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+    "capability_ids": [
+      "CAP-R1",
+      "CAP-R2",
+      "CAP-R3",
+      "CAP-R4",
+      "CAP-R5",
+      "CAP-R6"
+    ],
+    "deployment_mode": "DEPLOYMENT_MODE_LOCAL"
+  },
+  "routing": {
+    "organization_id": "9007199254740992",
+    "project_id": "9007199254740993",
+    "workload_id": "fixture-workload",
+    "service_name": "fixture-service",
+    "environment": "fixture"
+  },
+  "privacy": {
+    "content_capture": "CONTENT_CAPTURE_NONE",
+    "dimension_policy": "DIMENSION_POLICY_ALLOWLIST",
+    "route_policy": "ROUTE_POLICY_TEMPLATE_OR_UNKNOWN",
+    "dropped_dimension_count": "0"
+  },
+  "window": {
+    "runtime_window_id": "rtw_cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+    "state": "WINDOW_STATE_CLOSED",
+    "start_time": "2026-09-13T12:00:00Z",
+    "end_time": "2026-09-13T12:00:01Z"
+  },
+  "events": [
+    {
+      "event_id": "evt_1111111111111111111111111111111111111111111111111111111111111111",
+      "sequence": "1",
+      "wall_time_unix_nano": "1789300800001000000",
+      "monotonic_time_ns": "1001000000",
+      "clock_source": "CLOCK_SOURCE_PROCESS_MONOTONIC",
+      "clock_epoch_id": "fixture-clock-1",
+      "execution_id": "fixture-execution-1",
+      "operation_event": {
+        "operation": {
+          "kind": "OPERATION_KIND_TASK",
+          "unit_type": "OPERATION_UNIT_TASK",
+          "name": "fixture.task.live",
+          "identity_source": "IDENTITY_SOURCE_DECLARED"
+        },
+        "phase": "OPERATION_PHASE_FINISH",
+        "outcome": "OUTCOME_OK",
+        "duration_ns": "0"
+      }
+    },
+    {
+      "event_id": "evt_2222222222222222222222222222222222222222222222222222222222222222",
+      "sequence": "2",
+      "wall_time_unix_nano": "1789300800002000000",
+      "monotonic_time_ns": "1002000000",
+      "clock_source": "CLOCK_SOURCE_PROCESS_MONOTONIC",
+      "clock_epoch_id": "fixture-clock-1",
+      "runtime_window_id": "rtw_cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+      "operation_summary": {
+        "operation": {
+          "kind": "OPERATION_KIND_TASK",
+          "unit_type": "OPERATION_UNIT_TASK",
+          "name": "fixture.task.summary",
+          "identity_source": "IDENTITY_SOURCE_DECLARED"
+        },
+        "calls": "23",
+        "errors": "0",
+        "duration_ns_sum": "1000000000",
+        "duration_ns_max": "100000000",
+        "concurrency_max": 4
+      }
+    },
+    {
+      "event_id": "evt_3333333333333333333333333333333333333333333333333333333333333333",
+      "sequence": "3",
+      "wall_time_unix_nano": "1789300800003000000",
+      "monotonic_time_ns": "1003000000",
+      "clock_source": "CLOCK_SOURCE_PROCESS_MONOTONIC",
+      "clock_epoch_id": "fixture-clock-1",
+      "external_call": {
+        "parent_operation_event_id": "evt_1111111111111111111111111111111111111111111111111111111111111111",
+        "provider": "fixture-provider",
+        "service": "fixture-api",
+        "operation": "fixture.operation",
+        "destination_domain": "api.example.invalid",
+        "attempts": "2",
+        "errors": "1",
+        "duration_ns": "80000",
+        "usage": [
+          {
+            "unit": "input_tokens",
+            "value": "0",
+            "source": "USAGE_SOURCE_PROVIDER_RESPONSE"
+          },
+          {
+            "unit": "output_tokens",
+            "value": "18446744073709551615",
+            "source": "USAGE_SOURCE_PROVIDER_RESPONSE"
+          }
+        ]
+      }
+    },
+    {
+      "event_id": "evt_4444444444444444444444444444444444444444444444444444444444444444",
+      "sequence": "4",
+      "wall_time_unix_nano": "1789300800004000000",
+      "monotonic_time_ns": "1004000000",
+      "clock_source": "CLOCK_SOURCE_PROCESS_MONOTONIC",
+      "clock_epoch_id": "fixture-clock-1",
+      "resource_sample": {
+        "scope": "RESOURCE_SCOPE_DEVICE",
+        "sample_kind": "SAMPLE_KIND_SNAPSHOT",
+        "subject_id": "fixture-gpu-0",
+        "measurements": [
+          {
+            "name": "MEASUREMENT_NAME_GPU_ENERGY",
+            "value": "0.125000000001",
+            "unit": "MEASUREMENT_UNIT_J",
+            "temporality": "TEMPORALITY_DELTA",
+            "source": "fixture-device-counter",
+            "coverage": "0.999999999999",
+            "counter_epoch_id": "fixture-counter-1"
+          },
+          {
+            "name": "MEASUREMENT_NAME_GPU_UTILIZATION",
+            "value": "0",
+            "unit": "MEASUREMENT_UNIT_RATIO",
+            "temporality": "TEMPORALITY_GAUGE",
+            "source": "fixture-device-gauge",
+            "coverage": "1"
+          }
+        ]
+      }
+    },
+    {
+      "event_id": "evt_5555555555555555555555555555555555555555555555555555555555555555",
+      "sequence": "5",
+      "wall_time_unix_nano": "1789300800005000000",
+      "monotonic_time_ns": "1005000000",
+      "clock_source": "CLOCK_SOURCE_PROCESS_MONOTONIC",
+      "clock_epoch_id": "fixture-clock-1",
+      "adapter_health": {
+        "component": "HEALTH_COMPONENT_ADAPTER",
+        "status": "HEALTH_STATUS_DEGRADED",
+        "reason_codes": [
+          "FIXTURE_COUNTER_LIMIT"
+        ],
+        "counters": {
+          "dropped_events": "18446744073709551615",
+          "retries": "0",
+          "queue_depth": "0"
+        }
+      }
+    }
+  ],
+  "experiment_note": "fixture-all-records"
+}

package/fixtures/projection-batch.v1.json

@@ -0,0 +1,9 @@
+{
+  "schema_name": "netgreener.observation.projection_golden.v1",
+  "contract_status": "observation_source_admitted_draft",
+  "fixture": "observation/v1/vectors/projection-batch-document.v1.json",
+  "rules": "sort object keys; preserve array order; omit null; UTF-8 JSON separators comma-colon",
+  "expected_digest": "sha256:9eeb66c0283c03dadae5579274e4b550593d835d4aac3aca7add588d851408b7",
+  "byte_length": 4326,
+  "note": "Document admitted beside this golden; planning bindings fixture remains the historical source. Regenerate when schemas/v1 view is derived from admitted Protobuf."
+}

package/fixtures/python_reference_shapes.md

@@ -0,0 +1,24 @@
+# Legacy Python compatibility shapes (read-only)
+
+These fixtures mirror fields produced by the current Python service runtime and
+accepted by the existing API. They are migration fixtures, not the cross-language
+specification. MP0 artifacts in `netgreener_contracts` will define the stable contract;
+Python and Node must both conform without copying one implementation's debt.
+
+| Block | Python origin (reference only) |
+|-------|--------------------------------|
+| `service_runtime_v0` | `netgreener_cli/netgreener/service_runtime_v0.py` → `build_v0` |
+| `external_api_v0` | `netgreener_cli/netgreener/external_api_meter.py` → `build_v0` (+ `by_model`) |
+| `measurement_provenance` / evidence | CLI/API evidence grade helpers (`r9_v0`) |
+| Upload | `POST /api/v1/runsessions/` with `session_metadata` |
+
+Legacy Node compatibility payloads use adapter identifiers such as:
+
+- `express_middleware`
+- `fastify_middleware`
+- `node_process`
+- `bullmq_adapter` (later)
+
+Existing Python identifiers remain readable during migration: `asgi_middleware`,
+`outbound_http`, and the current Celery/collector strings. The shared collector and
+Observation v1 naming rules remain an MP0/MP2 decision.

package/fixtures/session_metadata_runtime_v0.json

@@ -0,0 +1,120 @@
+{
+  "emitter": "node",
+  "schema_note": "Legacy compatibility fixture for Node HTTP runtime flushes. It mirrors current Python service_runtime_v0 / external_api_v0 consumers but is not the MP0 cross-language contract.",
+  "run_context": {
+    "deploy_environment": "staging",
+    "client": "netgreener_node_runtime",
+    "release_tag": "example-1.0.0"
+  },
+  "service_runtime_v0": {
+    "framework": "express",
+    "collector": "express_middleware",
+    "window_seconds": 60.0,
+    "attribution": "cpu_share",
+    "accuracy": "trend",
+    "units": [
+      {
+        "service_unit": "GET /health",
+        "unit_type": "http_route",
+        "calls": 12,
+        "errors": 0,
+        "cpu_seconds_total": 0.04,
+        "energy_kwh": 0.0000012,
+        "carbon_g": 0.0003,
+        "duration_ms": {
+          "avg": 8.5,
+          "max": 22.0
+        }
+      },
+      {
+        "service_unit": "POST /v1/predict",
+        "unit_type": "http_route",
+        "calls": 3,
+        "errors": 1,
+        "cpu_seconds_total": 0.21,
+        "energy_kwh": 0.0000063,
+        "carbon_g": 0.0016,
+        "duration_ms": {
+          "avg": 145.0,
+          "max": 310.0
+        },
+        "peak_rss_kb_max": 256000
+      }
+    ],
+    "allocation_reconciliation_v0": {
+      "schema_version": 1,
+      "window_energy_kwh": 0.0000075,
+      "allocated_energy_kwh": 0.0000075,
+      "residual_energy_kwh": 0.0,
+      "tolerance_kwh": 1e-12,
+      "passed": true,
+      "scope": "endpoint_allocation_arithmetic_only",
+      "endpoint_capture_coverage": null,
+      "capture_completeness": "unknown"
+    }
+  },
+  "external_api_v0": {
+    "collector": "outbound_http",
+    "providers": [
+      {
+        "provider_key": "openai",
+        "calls": 3,
+        "errors": 0,
+        "duration_ms_avg": 820.0,
+        "hosts": ["api.openai.com"],
+        "input_tokens": 1100,
+        "output_tokens": 300,
+        "total_tokens": 1400,
+        "models": ["gpt-4o-mini", "gpt-4o"],
+        "by_model": [
+          {
+            "model": "gpt-4o-mini",
+            "calls": 2,
+            "errors": 0,
+            "input_tokens": 100,
+            "output_tokens": 50,
+            "total_tokens": 150
+          },
+          {
+            "model": "gpt-4o",
+            "calls": 1,
+            "errors": 0,
+            "input_tokens": 1000,
+            "output_tokens": 250,
+            "total_tokens": 1250
+          }
+        ]
+      }
+    ]
+  },
+  "measurement_provenance": {
+    "cpu_source": "process_cpu_time",
+    "memory_source": "process_rss_samples",
+    "energy_model": "tdp_utilization_estimate",
+    "gpu_scope": "none",
+    "gpu_source": "unavailable",
+    "carbon_factor": {
+      "value": 0.4,
+      "unit": "kg_co2e_per_kwh",
+      "source": "default_grid_factor"
+    },
+    "evidence_grades": {
+      "schema_version": 1,
+      "policy_version": "r9_v0",
+      "metrics": {
+        "local_energy": {
+          "metric": "local_energy",
+          "grade": "G1",
+          "reasons": ["estimated_power_tdp"]
+        },
+        "local_carbon": {
+          "metric": "local_carbon",
+          "grade": "G1",
+          "reasons": ["estimated_power_tdp", "default_grid_factor"]
+        }
+      },
+      "combined_floor_grade": "G1",
+      "notes": ["vendor_carbon_separate_ledger"]
+    }
+  }
+}

package/fixtures/session_metadata_with_tenant.json

@@ -0,0 +1,85 @@
+{
+  "$schema": "../../schemas/tenant_attribution_v0/session_metadata.fragment.schema.json",
+  "schema_note": "Node parity fixture — must match fixtures/tenant_attribution_v0/session_metadata_with_tenant.json semantics.",
+  "emitter": "node",
+  "run_context": {
+    "deploy_environment": "production",
+    "client": "deeddex-api",
+    "release_tag": "2026.08.31",
+    "tenant_id": "org_7f3a9c2b",
+    "tenant_source": "jwt_claim:organization_id",
+    "tenant_label": "Acme Corp"
+  },
+  "service_runtime_v0": {
+    "framework": "express",
+    "collector": "express_middleware",
+    "window_seconds": 60.0,
+    "attribution": "cpu_share",
+    "accuracy": "trend",
+    "units": [
+      {
+        "service_unit": "POST /v1/documents/ocr",
+        "unit_type": "http_route",
+        "calls": 84,
+        "errors": 1,
+        "cpu_seconds_total": 1.2,
+        "energy_kwh": 0.000036,
+        "carbon_g": 0.009,
+        "duration_ms": {
+          "avg": 210.0,
+          "max": 890.0
+        }
+      }
+    ],
+    "by_tenant": {
+      "org_7f3a9c2b": {
+        "tenant_id": "org_7f3a9c2b",
+        "calls": 84,
+        "errors": 1,
+        "units": [
+          {
+            "service_unit": "POST /v1/documents/ocr",
+            "unit_type": "http_route",
+            "calls": 84,
+            "errors": 1,
+            "cpu_seconds_total": 1.2,
+            "energy_kwh": 0.000036,
+            "carbon_g": 0.009,
+            "duration_ms": {
+              "avg": 210.0,
+              "max": 890.0
+            }
+          }
+        ]
+      }
+    }
+  },
+  "external_api_v0": {
+    "collector": "outbound_http",
+    "providers": [
+      {
+        "provider_key": "azure_document_intelligence",
+        "calls": 1200,
+        "errors": 3,
+        "duration_ms_avg": 420.0,
+        "hosts": ["eastus.api.cognitive.microsoft.com"]
+      }
+    ],
+    "by_tenant": {
+      "org_7f3a9c2b": {
+        "tenant_id": "org_7f3a9c2b",
+        "calls": 1200,
+        "errors": 3,
+        "providers": [
+          {
+            "provider_key": "azure_document_intelligence",
+            "calls": 1200,
+            "errors": 3,
+            "duration_ms_avg": 420.0,
+            "hosts": ["eastus.api.cognitive.microsoft.com"]
+          }
+        ]
+      }
+    }
+  }
+}