info-tech-canon/workplans/ITC-WP-0003-validation-indexes-and-generated-views.md

id, type, title, domain, repo, status, priority, created, updated, depends_on_workplans, state_hub_workstream_id

id	type	title	domain	repo	status	priority	created	updated	depends_on_workplans	state_hub_workstream_id
ITC-WP-0003	workplan	Validation Indexes And Generated Views	canon	info-tech-canon	finished	high	2026-05-23	2026-05-23	ITC-WP-0001 ITC-WP-0002	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

id: ITC-WP-0003-T01
status: done
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

id: ITC-WP-0003-T02
status: done
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

id: ITC-WP-0003-T03
status: done
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

id: ITC-WP-0003-T04
status: done
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

id: ITC-WP-0003-T05
status: done
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.

Implementation Notes

• Added make validate, make index, make tree, and make agent-briefs.
• Added structural validation for required files, infospace directories, canon.yaml paths, schema presence, artifact index integrity, relationship targets, and optional collection warnings.
• Added initial schemas for standards, concepts, mappings, profiles, assimilation records, interface cards, agent briefs, and workplans.
• Added deterministic generated views and indexes for standards, concepts, profiles, mapping targets, kernel overview, import matrix, artifact tree, and global agent guidance.