lumin-repo-lens-lab-canon

Lumin Repo Lens Canon

This is the maintainer-facing canonical fact surface for lumin-repo-lens-lab. It owns canon-draft and check-canon together because draft output is reviewed, promoted, and later checked for drift as one lifecycle.

Default voice is concise and factual. This surface may use colder terminology than the audit surface, but every claim still needs machine evidence and scan range. Do not use casual hedging. If evidence is missing or degraded, emit unknown or a degraded status directly with the scan range.

Core Contract

NO STRUCTURAL CLAIM WITHOUT MACHINE EVIDENCE
NO ABSENCE CLAIM WITHOUT STATED SCAN RANGE

Shared Engine

The shared engine lives in the sibling audit skill:

node ${CLAUDE_PLUGIN_ROOT}/skills/lumin-repo-lens-lab/scripts/audit-repo.mjs

In a maintainer checkout, the equivalent command is:

node audit-repo.mjs

Slash commands still read <SKILL_ROOT>/references/command-routing.md from the shared audit skill for exact flag routing. Below, <SKILL_ROOT> means ${CLAUDE_PLUGIN_ROOT}/skills/lumin-repo-lens-lab in plugin installs, or the repo root in a maintainer checkout.

Below, <audit-repo> means whichever of the two commands above applies to the current context.

This surface owns /lumin-repo-lens-lab:canon-draft and /lumin-repo-lens-lab:check-canon.

References To Load

• Read <SKILL_ROOT>/references/command-routing.md first for slash-command routing.
• Read <SKILL_ROOT>/references/lifecycle-modes.md when exact flags, exit codes, or artifact names matter.
• Read <SKILL_ROOT>/canonical/canon-drift.md for drift categories, parser contract, per-source Markdown reports, and canon-drift.json shape.
• Read <SKILL_ROOT>/canonical/fact-model.md, <SKILL_ROOT>/canonical/identity-and-alias.md, and <SKILL_ROOT>/canonical/classification-gates.md when a drift category, identity, or label set is ambiguous.

Canon Draft

Use when current artifacts should propose canonical facts for review:

<audit-repo> --canon-draft --root <repo> --output <dir> --sources <sources>

Drafts are proposals, not promoted truth. The model may summarize why a draft changed, but a human or maintainer process still promotes it.

Check Canon

Use when promoted canonical/ facts should be compared against fresh artifacts:

<audit-repo> --check-canon --root <repo> --output <dir> --sources <sources>

If a source is missing, skipped, degraded, or diagnostic-only, surface that status. Do not turn "skipped" into "clean."

Output

Use short maintainer blocks:

1. Sources checked
2. Drift found or skipped sources
3. Files written
4. Promotion or follow-up step

For full details, cite canon-drift.json, per-source canon-drift.<source>.md, and manifest.json.

Hand Off

If the user shifts to general repo structure, cleanup priority, or refactor-plan coaching, hand off to lumin-repo-lens-lab. If the user shifts to code changes before or after implementation, hand off to lumin-repo-lens-lab-write-gate.