lumin-repo-lens-write-gate

Lumin Repo Lens Write Gate

This is the code-change transaction surface for lumin-repo-lens. It owns pre-write and post-write together because post-write reads the pre-write-advisory.<invocationId>.json produced by the same change.

Keep the human-facing answer short and kind. The assistant reads the cold artifacts; the human gets the next concrete step.

Core Contract

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

Use hedging like "looks like" only when the internal label is degraded or unknown.

Shared Engine

The shared engine lives in the sibling audit skill:

node ${CLAUDE_PLUGIN_ROOT}/skills/lumin-repo-lens/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 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:pre-write and /lumin-repo-lens:post-write.

References To Load

• Read <SKILL_ROOT>/references/command-routing.md first for slash-command routing.
• Read <SKILL_ROOT>/references/pre-write-intent-shape.md before constructing or repairing intent JSON.
• Read <SKILL_ROOT>/canonical/pre-write-gate.md for the pre-write protocol, domain-cluster hints, exact shape lookup, and advisory language.
• Read <SKILL_ROOT>/canonical/any-contamination.md for planned type escapes, contaminated reuse demotion, and post-write escape deltas.
• Read <SKILL_ROOT>/references/lifecycle-modes.md when exact flags, exit codes, or artifact names matter.
• Read <SKILL_ROOT>/references/glossary.md and <SKILL_ROOT>/references/false-positive-index.md when advisory output surfaces FP/tier terms that need explanation. The long FP case ledger is maintainer-only; do not load it for ordinary pre-write/post-write.

Pre-Write

Run before adding, implementing, refactoring, moving, renaming, or extending code when a compact intent can be inferred.

Do not ask normal chat users to hand-write JSON. Infer the smallest intent you can from the request, stream it via --intent - or write a temporary intent file, then run:

<audit-repo> --pre-write --root <repo> --output <dir> --intent <file|->

Read the invocation-specific advisory path printed by pre-write before coding during the same uninterrupted change transaction. It is also recorded as artifactPaths.invocationSpecific in the advisory JSON and as manifest.preWrite.advisoryPath when run through the orchestrator. pre-write-advisory.latest.json is only a convenience pointer; use the explicit pre-write-advisory.<invocationId>.json path for post-write across session or task boundaries.

Planned file paths may be grounded NEW_FILE and still carry DOMAIN_CLUSTER_DETECTED when the same directory already has a matching prefix, suffix, or domain-token family. Treat that as a reuse/review hint before creating a new owner file.

P4 shape lookup is exact. Prefer shape.typeLiteral or shape.hash in the intent when asking for shape reuse. Field-name-only shapes are reported as unknown, not fuzzy matches.

Report existing owners/helpers/types/dependencies in plain language, with compact proof only when needed.

Post-Write

Run after the same change when a pre-write advisory exists:

<audit-repo> --post-write --root <repo> --output <dir> --pre-write-advisory <advisory>

Check:

• silent-new type escapes
• planned-but-not-observed escapes
• scan-range parity against the pre-write run
• unexpected new files in the scan range outside intent.files
• advisory failures plus baseline, capability, and scan-range confidence

If post-write cannot find the advisory, say that the post-write check is unknown and name the missing file. Do not invent a clean result. Do not use pre-write-advisory.latest.json after another pre-write run has happened; rerun pre-write or pass the invocation-specific advisory.

Output

Use four short blocks when reporting to a human:

1. What I checked
2. What already exists / changed
3. What needs attention
4. Next command or coding-agent prompt

Keep raw JSON paths, FP ids, and tier names behind the answer unless the user asks for proof or maintainer detail.

Hand Off

If the user shifts to repo-wide structure, dead code, cycles, or a refactor-plan, hand off to lumin-repo-lens. If the user shifts to canonical draft or drift validation, hand off to lumin-repo-lens-canon.