generated from coulomb/repo-seed
116 lines
2.5 KiB
Markdown
116 lines
2.5 KiB
Markdown
---
|
|
id: ITC-WP-0003
|
|
type: workplan
|
|
title: "Validation Indexes And Generated Views"
|
|
domain: canon
|
|
repo: info-tech-canon
|
|
status: proposed
|
|
priority: high
|
|
created: "2026-05-23"
|
|
updated: "2026-05-23"
|
|
depends_on_workplans:
|
|
- ITC-WP-0001
|
|
- ITC-WP-0002
|
|
state_hub_workstream_id: "510e6d15-ac2a-48ee-9ef1-3d14c21e16aa"
|
|
---
|
|
|
|
# ITC-WP-0003 - Validation Indexes And Generated Views
|
|
|
|
## Goal
|
|
|
|
Add repeatable validation, schema stubs, indexes, and generated views so the
|
|
canon can be maintained by humans and consumed by tools.
|
|
|
|
## Intent
|
|
|
|
The first validation pass should be useful before it is complete. Missing
|
|
optional artifacts should be warnings. Broken required paths and manifest
|
|
inconsistencies should fail visibly.
|
|
|
|
## Tasks
|
|
|
|
### T01 - Make targets
|
|
|
|
```task
|
|
id: ITC-WP-0003-T01
|
|
status: todo
|
|
priority: high
|
|
state_hub_task_id: "246d5671-9585-43e1-880c-cc4ce728459f"
|
|
```
|
|
|
|
- Add `make validate`.
|
|
- Add `make index`.
|
|
- Add `make tree`.
|
|
- Add `make agent-briefs`.
|
|
|
|
### T02 - Structural validation
|
|
|
|
```task
|
|
id: ITC-WP-0003-T02
|
|
status: todo
|
|
priority: high
|
|
state_hub_task_id: "8db6058f-754f-4d92-a93f-d4119b2cad55"
|
|
```
|
|
|
|
- Check required top-level files.
|
|
- Check required `infospace/` directories.
|
|
- Check `canon.yaml` paths.
|
|
- Check `infospace/artifacts/index.yaml`.
|
|
- Warn about missing optional agent briefs, concepts, mappings, and examples.
|
|
|
|
### T03 - Schemas
|
|
|
|
```task
|
|
id: ITC-WP-0003-T03
|
|
status: todo
|
|
priority: high
|
|
state_hub_task_id: "ea3c6e98-fb3c-44fd-9f54-9a934ab62455"
|
|
```
|
|
|
|
- Add minimal schemas for:
|
|
- standard
|
|
- concept
|
|
- mapping
|
|
- profile
|
|
- assimilation
|
|
- interface card
|
|
- agent brief
|
|
- workplan
|
|
|
|
### T04 - Generated views
|
|
|
|
```task
|
|
id: ITC-WP-0003-T04
|
|
status: todo
|
|
priority: high
|
|
state_hub_task_id: "b33bbda7-8ec6-48b2-a637-571a87473c5a"
|
|
```
|
|
|
|
- Generate `views/by-standard.md`.
|
|
- Generate `views/by-concept.md`.
|
|
- Generate `views/by-profile.md`.
|
|
- Generate `views/by-mapping-target.md`.
|
|
- Generate `views/kernel-overview.md`.
|
|
- Mark generated files clearly.
|
|
|
|
### T05 - Ownership and duplication checks
|
|
|
|
```task
|
|
id: ITC-WP-0003-T05
|
|
status: todo
|
|
priority: medium
|
|
state_hub_task_id: "01469609-91fb-48e3-b6e5-11e6342b29af"
|
|
```
|
|
|
|
- Create a first concept ownership index.
|
|
- Detect duplicate concept candidates.
|
|
- Produce a cross-standard import matrix.
|
|
- Report unresolved ownership conflicts.
|
|
|
|
## Acceptance
|
|
|
|
- `make validate` is the primary confidence command.
|
|
- Validation produces machine-readable output.
|
|
- Generated views can be refreshed deterministically.
|
|
- Concept ownership can be inspected even before all concept pages exist.
|