DGR-018: Define canonical Ralph and Gitea metadata schema #2

Closed
opened 2026-07-16 20:36:01 +00:00 by popov · 0 comments
Owner

DGR-018: Define canonical Ralph and Gitea metadata schema

  • Status / triage: completed; passes: true
  • Execution mode: AFK
  • Milestone: M0
  • Dependencies: DGR-017
  • Blocks (derived): DGR-021, DGR-025
  • Labels: area:planning, area:gitea, type:infrastructure, priority:p0, ready-for-agent
  • Evidence class: model-free
  • Hardware: none
  • Model: generic
  • Upstream: no

Objective / description

Fresh Ralph session: read .scratch/distributed-gguf-runtime/RALPH-CONTEXT.md, source issue .scratch/distributed-gguf-runtime/issues/018-define-canonical-ralph-and-gitea-metadata-schema.md, and evidence READMEs for dependencies (DGR-017) before changing code. Inspect live source/tests rather than trusting legacy pass states. Objective: Make prd.json the validated source from which Markdown and Gitea issues can later be generated losslessly.

Acceptance criteria

  • Define fields for stable ID/title, labels, milestone, type, dependsOn, derived blocks, triage, evidence class, and hardware/model/upstream flags.
  • Validate that all stories start passes: false, use known dependencies, and have unique stable IDs.
  • Reject cycles, missing dependencies, mismatched generated blocks, duplicate titles/IDs, and generated artifacts claiming authority over prd.json.
  • Add deterministic model-free tests for parse, validation, and generation round trips.
  • Applicable shared quality gates in prd.json pass, and the evidence handoff records exact commands/results, changed files, limitations, and dependency handoff.

Shared quality gates

  • Targeted deterministic tests pass; Python changes also pass python -m compileall packages tests.
  • git diff --check passes.
  • Default tests are model-download-free, API-credit-free, and GPU-free.
  • Evidence README records exact changed files, commands/results, limitations, and dependency handoff; no fabricated evidence or inherited completion credit.

Evidence handoff

Verified evidence: .scratch/distributed-gguf-runtime/evidence/DGR-018/README.md. Legacy evidence remains provenance only and grants no implementation completion credit.

<!-- GENERATED FROM prd.json — DO NOT EDIT AS AN INDEPENDENT SOURCE. prd.json IS AUTHORITATIVE. --> # DGR-018: Define canonical Ralph and Gitea metadata schema - **Status / triage:** completed; `passes: true` - **Execution mode:** `AFK` - **Milestone:** `M0` - **Dependencies:** `DGR-017` - **Blocks (derived):** `DGR-021`, `DGR-025` - **Labels:** `area:planning`, `area:gitea`, `type:infrastructure`, `priority:p0`, `ready-for-agent` - **Evidence class:** `model-free` - **Hardware:** `none` - **Model:** `generic` - **Upstream:** `no` ## Objective / description Fresh Ralph session: read `.scratch/distributed-gguf-runtime/RALPH-CONTEXT.md`, source issue `.scratch/distributed-gguf-runtime/issues/018-define-canonical-ralph-and-gitea-metadata-schema.md`, and evidence READMEs for dependencies (DGR-017) before changing code. Inspect live source/tests rather than trusting legacy pass states. Objective: Make `prd.json` the validated source from which Markdown and Gitea issues can later be generated losslessly. ## Acceptance criteria - [x] Define fields for stable ID/title, labels, milestone, type, `dependsOn`, derived `blocks`, triage, evidence class, and hardware/model/upstream flags. - [x] Validate that all stories start `passes: false`, use known dependencies, and have unique stable IDs. - [x] Reject cycles, missing dependencies, mismatched generated `blocks`, duplicate titles/IDs, and generated artifacts claiming authority over `prd.json`. - [x] Add deterministic model-free tests for parse, validation, and generation round trips. - [x] Applicable shared quality gates in `prd.json` pass, and the evidence handoff records exact commands/results, changed files, limitations, and dependency handoff. ## Shared quality gates - Targeted deterministic tests pass; Python changes also pass `python -m compileall packages tests`. - `git diff --check` passes. - Default tests are model-download-free, API-credit-free, and GPU-free. - Evidence README records exact changed files, commands/results, limitations, and dependency handoff; no fabricated evidence or inherited completion credit. ## Evidence handoff Verified evidence: `.scratch/distributed-gguf-runtime/evidence/DGR-018/README.md`. Legacy evidence remains provenance only and grants no implementation completion credit. <!-- ralph-story-id: DGR-018 -->
popov added this to the M0 milestone 2026-07-16 20:36:01 +00:00
popov closed this issue 2026-07-16 20:36:47 +00:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: popov/neuron-tai#2