jared/cc-os

Watch

Fork 0

Template validator CLI: tier computation + section check, with shared tracker lib (#186) #253

New issue

Closed

opened 2026-08-04 11:44:35 +00:00 by jared · 2 comments

jared commented

2026-08-04 11:44:35 +00:00

Owner

Spec: #250
Blocked by #251

Slice

Template validator in os-backlog's Ruby CLI surface: given an issue number, compute the structural tier (capture/ticket/map per ADR-0092) and report missing/malformed sections against the canonical templates. Build the shared lib this and decision-sweep need (tracker fetch, body/section parsing, label ops) — this lib implements #186's surface.

Acceptance criteria

Given an issue with the wayfinder:map label, when validated, then tier is map.
Given a body whose ## headings exactly match the ticket template's (case-sensitive, any order, non-empty after stripping HTML comments/placeholders), when validated, then tier is ticket and validation passes.
Given duplicate headings, wrong heading depth, or an empty required section, when validated, then the specific malformation is reported and validation fails.
Given anything else, when validated, then tier is capture.
Given a Blocked by #NNN reference that cannot be fetched, when validated, then validation fails naming the reference.
Minitest suite at the CLI/lib boundary: fixture bodies + stubbed tracker fetch, no live tracker; fixtures are the authority for accepted/rejected forms.
Ruby, Sandi Metz OOP style; exit code 0 pass / non-zero fail with section report on stdout.

Non-goals

No sweep logic (its own ticket), no label mutations, never runs at capture time.

Spec: #250 Blocked by #251 ## Slice Template validator in os-backlog's Ruby CLI surface: given an issue number, compute the structural tier (capture/ticket/map per ADR-0092) and report missing/malformed sections against the canonical templates. Build the shared lib this and `decision-sweep` need (tracker fetch, body/section parsing, label ops) — this lib implements #186's surface. ## Acceptance criteria - Given an issue with the `wayfinder:map` label, when validated, then tier is `map`. - Given a body whose `##` headings exactly match the ticket template's (case-sensitive, any order, non-empty after stripping HTML comments/placeholders), when validated, then tier is `ticket` and validation passes. - Given duplicate headings, wrong heading depth, or an empty required section, when validated, then the specific malformation is reported and validation fails. - Given anything else, when validated, then tier is `capture`. - Given a `Blocked by #NNN` reference that cannot be fetched, when validated, then validation fails naming the reference. - Minitest suite at the CLI/lib boundary: fixture bodies + stubbed tracker fetch, no live tracker; fixtures are the authority for accepted/rejected forms. - Ruby, Sandi Metz OOP style; exit code 0 pass / non-zero fail with section report on stdout. ## Non-goals No sweep logic (its own ticket), no label mutations, never runs at capture time.

jared added the

ready-for-agent

label

2026-08-04 11:44:35 +00:00

jared referenced this issue

2026-08-04 11:44:35 +00:00

bin/decision-sweep: recommender-blind gate over weighted-decision blocks #254

jared referenced this issue

2026-08-04 11:44:35 +00:00

Enhance triage into the refine agent (standing checklist, self-applied readiness) #255

jared referenced this issue

2026-08-04 11:44:35 +00:00

Check-out protocol: claim, staleness/falsifiability checkpoint, fixed context-load #256

jared referenced this issue

2026-08-04 11:44:47 +00:00

os-backlog: deterministic ticket-filing surface — labels/body-file in the Ruby CLI plus a filer skill or agent #186

jared commented

2026-08-04 14:42:21 +00:00

Author

Owner

Scope amendment from the 2026-08-04 review of #251/#257/#258:

Templates blocker (from #251): plugins/os-backlog/references/templates/ticket.md and spec.md were promoted as annotated section listings — headings carry inline annotations (e.g. ## Slice — one sentence: ...) with no bodies. capture.md has the correct fill-in shape (bare canonical headings + placeholder body). Since the validator built here matches headings case-sensitively against the canonical templates, no real ticket — including #251–#258, which use bare ## Slice — would validate against the current files.

First slice of this ticket: reshape ticket.md and spec.md to the fill-in shape (bare canonical headings, placeholder bodies) consistent with capture.md, then build the validator and its fixtures against the reshaped files.

Scope amendment from the 2026-08-04 review of #251/#257/#258: **Templates blocker (from #251):** `plugins/os-backlog/references/templates/ticket.md` and `spec.md` were promoted as annotated section listings — headings carry inline annotations (e.g. `## Slice — one sentence: ...`) with no bodies. `capture.md` has the correct fill-in shape (bare canonical headings + placeholder body). Since the validator built here matches headings case-sensitively against the canonical templates, no real ticket — including #251–#258, which use bare `## Slice` — would validate against the current files. **First slice of this ticket:** reshape `ticket.md` and `spec.md` to the fill-in shape (bare canonical headings, placeholder bodies) consistent with `capture.md`, then build the validator and its fixtures against the reshaped files.

jared referenced this issue

2026-08-04 14:42:31 +00:00

Harden the close protocol: idempotent close, Resolution.missing_parts, mechanical merge-subsumes-review gate #261

jared commented

2026-08-04 15:46:47 +00:00

Author

Owner

Resolution

Done: Shipped Backlog::TemplateValidator + validate-template CLI + backend fetch surface

Evidence: 120-run minitest suite green, rubocop zero offenses, opus reviewer APPROVE, merged as 643da05

Follow-ups: none

## Resolution **Done:** Shipped Backlog::TemplateValidator + validate-template CLI + backend fetch surface **Evidence:** 120-run minitest suite green, rubocop zero offenses, opus reviewer APPROVE, merged as 643da05 **Follow-ups:** none

jared closed this issue

2026-08-04 15:46:49 +00:00

jared referenced this issue from a commit

2026-08-04 15:57:58 +00:00

os-backlog: template validator CLI + shared tracker fetch lib (#253)

jared referenced this issue from a commit

2026-08-04 15:57:58 +00:00

Merge sdlc/253: template validator CLI (#253)

jared referenced this issue from a commit

2026-08-04 15:57:58 +00:00

Record #253 template validator in os-backlog status leaf

jared referenced this issue