newspaper_wedding/.aidlc/sensors/aidlc-traceability.md

id, kind, command, default_severity, description, category, matches, input_schema, output_schema, timeout_seconds

id	kind	command	default_severity	description	category	matches	input_schema	output_schema	timeout_seconds
traceability	deterministic	aidlc engine sensor-traceability	advisory	Verifies element-level upstream coverage, downstream targets, and derived orphans in traceability.json	document-traceability	**/traceability.json	output_path stage_slug string string	pass gaps orphans missing_from_table missing_from_upstream_ids invalid_entries invalid_targets findings_count reason boolean string[] string[] string[] string[] string[] string[] integer string	5

traceability sensor

Deterministic element-level verification of each stage's JSON coverage table:

1. Validates the runtime JSON shape and the closed status set.
2. Fails on GAP, ORPHAN, missing coverage rows, or undeclared upstream IDs.
3. Requires non-empty targets for OK, Deferred, and N/A.
4. Resolves upstream IDs from the authored artifacts and fails closed when the expected source is missing or yields no IDs.
5. Verifies deterministic targets where possible: stories, Unit mappings, business rules, and workspace-relative code paths.
6. Derives functional-design orphans from rules.md rather than trusting only the self-reported reverse array.

Expected JSON schema

{
  "stage": "functional-design",
  "unit": "u1-auth",
  "upstream_ids": ["AC1.1.1", "AC1.2.1"],
  "coverage": [
    { "id": "AC1.1.1", "status": "OK", "target": "BR1.1" },
    { "id": "AC1.2.1", "status": "GAP" }
  ],
  "reverse": [
    { "id": "BR1.3", "status": "ORPHAN" }
  ]
}

Valid statuses are OK, GAP, ORPHAN, Deferred, and N/A.