Research stage: research-summary.json artifact + research: config validation #210

New issue

david · 2026-08-16T21:52:00Z

david commented

2026-08-16 21:52:00 +00:00

Add the research stage's artifact and config surface:

research-summary.json artifact — schema validation + I/O (round-trip; rejects malformed input). Schema in IMPLEMENTATION_PLAN.md (checkedDeps, researchedDeps, updatedFolders, shipped, prUrl, createdAt). This is also the research stage's resume marker.
Committed folder metadata — docs/reference/<slug>/_meta.json ({ name, version, fetchedAt, sources, manifestPath }); consumed by the version gate.
Config validation — research: section in piloop-config.yaml: enabled (default true), merge-method (default squash), max-pages-per-dependency (default 5; 0 = unlimited), max-deps-per-run (default 10; 0 = unlimited), skip-labels (default [chore, documentation]). Strict validation: unknown keys / wrong types abort with kind: config (ADR-013 semantics).

References: ADR-014 (docs/adr/014-research-stage.md), DESIGN.md §3.4 + §7.1.

Add the research stage's artifact and config surface: - **`research-summary.json` artifact** — schema validation + I/O (round-trip; rejects malformed input). Schema in IMPLEMENTATION_PLAN.md (checkedDeps, researchedDeps, updatedFolders, shipped, prUrl, createdAt). This is also the research stage's resume marker. - **Committed folder metadata** — `docs/reference/<slug>/_meta.json` ({ name, version, fetchedAt, sources, manifestPath }); consumed by the version gate. - **Config validation** — `research:` section in `piloop-config.yaml`: `enabled` (default true), `merge-method` (default squash), `max-pages-per-dependency` (default 5; 0 = unlimited), `max-deps-per-run` (default 10; 0 = unlimited), `skip-labels` (default [chore, documentation]). Strict validation: unknown keys / wrong types abort with `kind: config` (ADR-013 semantics). References: ADR-014 (docs/adr/014-research-stage.md), DESIGN.md §3.4 + §7.1.

david added the

pi-loop

label

2026-08-16 21:52:32 +00:00

Sign in to join this conversation.