truthful-plan-surfaces — Povrchy plánu se odvozují z dodávky a nic z toho, co ukazují, se nepíše vedle repozitáře

•AKTIVNÍ 13 of 23 issues done

připraveno

9

blokováno

1

aktivní

0

verify

0

hotovo

13

zrušeno

0

Problém

Změřeno 2026-10-16 na master d1162668036 (v0.27.0): /roadmap/ uvádí 8 z 38 milníků, ty s ručně napsanou verzí 0.1-1.0; stav úkolů se odvozuje pouze z razítek a nic jej nesrovnává se sloučenou prací (I2653 sloučené #1097 stále READY); /ui/roadmap uváděl nejnovější release 0.26.0 pod hlavičkou 0.27.0; vstupní stránka uvádí současnost v ručně psané próze toml; box art přežívá mimo rozsah pravidla diagramů; kód zvýrazňují tři enginy, jeden načítaný z CDN. ADR 0166.

Výsledek

Každý povrch plánu kreslí každý milník v pořadí grafu, každý úkol s deklarovaným stavem vedle stupně dodání odvozeného z větví, pull requestů, mergů, tagů a publikovaného webu; zmergovaný, ale nezaznamenaný úkol zčervená trunk po uplynutí okna; žádný milník nenese typovanou verzi; každý vztah je nakreslený, klikatelný diagram; každý blok kódu zvýrazňuje jeden engine s jednou paletou odvozenou z tokenů.

Aktuální stav

Stav z razítek; plán rozvoje filtrovaný ručním polem; text úvodní stránky psaný ručně; tři zvýrazňovače; pravidlo diagramů pokrývá jen dokumenty, zdroje webu a šablony.

Cílový stav

schopnosti plan.delivery a plan.drift; verze odvozená z tagů; /roadmap/, /plan/, úvodní stránka, /ui/roadmap a PLAN_STATUS.md čtou jedno odvození; homepage-check odmítá prózu o současném stavu; pravidlo diagramů v2 nad ADR, pravidly, příručkou a markdownem UI; syntect všude.

Rozsah

• apps/majordomus-cli/src/plan.rs
• apps/majordomus-cli/src/capability/builtin/plan.rs
• apps/majordomus-cli/src/ui
• apps/majordomus-cli/src/web
• lib/project.awk
• lib/project.sh
• lib/plan.sh
• scripts/generate-site-data
• scripts/ci
• site/templates
• site/content-src
• site/data
• share/ui
• share/design
• share/schemas
• příručka
• .ai/repo/project/milestones
• .ai/repo/rules/project
• .ai/repo/adrs
• docs/PLANNING.md
• docs/DIAGRAMS.md
• test/cases

Mimo rozsah

• Zapisování razítek životního cyklu z odvození; merge není přijetí a o stavu DONE nadále rozhodují důkazy (ADR 0166, alternativy).
• Přepis awk enginu stavů; dodávka je jen v Rustu.

Kritéria přijetí

• plan.delivery odpoví na stupeň jeho dokazujícím objektem pro každý úkol a nepřečtený forge je hlášen jako nepřečtený
• ci trunku odmítne úkol mergnutý a nezaznamenaný po deklarovaném okně a jmenuje příkaz, který to vyřeší
• Žádný záznam milníku nenese version a schéma ho odmítá
• /roadmap/ a /ui/roadmap uvádějí každý milník plánu v pořadí grafu, s odvozenou fází každého úkolu odkazující na jeho důkaz
• homepage-check odmítá větu o současném stavu v site/data
• Kontrola diagramů pokrývá ADR, pravidla, handbook a markdown UI a nenajde žádnou ASCII grafiku
• Jeden zvýrazňovač: žádný highlight.js ani zvýrazňovač z CDN na žádném povrchu a kontrola jej odmítne

Validace

• bin/majordomus plan validate
• bash test/run.sh 3100_an_issue_delivery_is_inferred 3101_merged_work_unrecorded_is_drift 3102_a_milestone_version_is_inferred 3103_the_roadmap_draws_every_milestone 3104_the_ui_roadmap_reads_delivery 3105_the_homepage_states_no_present_it_does_not_read 3106_every_published_tree_draws_its_diagrams 3107_one_highlighter

Požadované důkazy

• delivery_inferred
• drift_gated
• surfaces_read_one_derivation
• diagrams_and_code_unified

Rizika

• Kontrola driftu zčervená trunk při přistání pro každý už sloučený a nezaznamenaný úkol; I2748 je zaznamená dřív, než se kontrola stane blokující.
• syntect přidává k době buildu a velikosti spustitelného souboru; změřeno v I2747 před přistáním.

Úkoly

Každý z nich je prováděcí kontrakt s vlastními kritérii přijetí, validačním příkazem a požadovanými důkazy. Sloupec wave je vrstva grafu závislostí, v níž úkol leží.

Graf

flowchart LR
    I2740["I2740<br/>An issue's delivery is inferred from branches, pull requests, merges, tags and the published site"]:::done
    I2741["I2741<br/>Merged work the plan has not recorded is drift, and on the trunk past a window it is red"]:::done
    I2742["I2742<br/>A milestone's version is inferred from the release that carried it, never typed"]:::done
    I2743["I2743<br/>The public roadmap draws every milestone in the graph's order, each issue with its inferred delivery"]:::ready
    I2744["I2744<br/>The UI roadmap reads delivery and the releases themselves, and its now is where work is"]:::ready
    I2745["I2745<br/>The landing page states no present it does not read"]:::done
    I2746["I2746<br/>Every published tree draws its diagrams, and every diagram is the interactive viewer"]:::done
    I2747["I2747<br/>Every code block on every surface is highlighted by one engine with one palette"]:::ready
    I2748["I2748<br/>The drift already on the trunk is settled before the gate is made blocking"]:::blocked
    I2749["I2749<br/>A commit that only plans an issue is not its delivery"]:::ready
    I2750["I2750<br/>The trunk's drift gate reads the forge before it judges"]:::ready
    I2850["I2850<br/>the published PR Drain carries its pull requests, and counts pull requests rather than plan issues"]:::done
    I2851["I2851<br/>the homepage's product view counts the delivery the history proves beside the statuses the records declare, each count a link"]:::ready
    I2852["I2852<br/>every class a UI screen gives an element is one the UI's stylesheet defines"]:::done
    I3020["I3020<br/>The Knowledge screen states nothing about the repository that its checkout could not observe"]:::done
    I3021["I3021<br/>The Knowledge screen shows each review command as code with what it does as a sentence"]:::done
    I3022["I3022<br/>An empty knowledge queue is one sentence that says how a record arrives, not two empty tables"]:::done
    I3023["I3023<br/>The Knowledge screen reads in review order, in plain labels, and leads to the knowledge manual"]:::done
    I3024["I3024<br/>The Knowledge screen's manual link names a page the site has, on the server and on Pages"]:::done
    I3025["I3025<br/>Every Knowledge tile reads whole at a phone's width"]:::done
    I3079["I3079<br/>The links of the Deployments table on /ui/delivery meet the target size at every audited width"]:::ready
    I3271["I3271<br/>plan.drift reports a source it could not observe as unknown, never as a drift finding"]:::ready
    I3319["I3319<br/>No record names a repository a design was studied in"]:::ready
    I2740 --> I2741
    I2740 --> I2743
    I2740 --> I2744
    I2740 --> I2851
    I2741 --> I2748
    I2741 --> I2749
    I2741 --> I2750
    I2741 --> I3271
    I2742 --> I2743
    I2749 --> I2748
    I2750 --> I2748
    classDef done stroke:#16a34a,fill:#dcfce7,color:#14532d,stroke-width:2px
    classDef active stroke:#2563eb,fill:#eff6ff,color:#1e3a8a,stroke-width:2px
    classDef verify stroke:#7c3aed,fill:#f5f3ff,color:#4c1d95,stroke-width:2px
    classDef ready stroke:#0891b2,fill:#ecfeff,color:#164e63,stroke-width:2px
    classDef planned stroke:#0891b2,fill:#ecfeff,color:#164e63,stroke-width:2px
    classDef blocked stroke:#b45309,fill:#fffbeb,color:#78350f,stroke-width:2px
    classDef cancelled stroke:#6b7280,fill:#f9fafb,color:#374151,stroke-width:2px
    classDef superseded stroke:#6b7280,fill:#f9fafb,color:#374151,stroke-width:2px

Kanonický záznam: .ai/repo/project/milestones/truthful-plan-surfaces.yaml. Přečtěte ho zpět pomocí majordomus plan show truthful-plan-surfaces.