plugin-quality: config surface, sink reference + config-cascade row

[kyle-sexton]

Parent

Source: PLAN Phase B4, topic plugin-audit-port — plan locked at commit 40a64b5c on
feat/plugin-audit-port.

What to build

plugin-quality's consumer-config surface and sink reference:

• reference/config.md: keys for .claude/plugin-quality.md (sink, zone-behavior criteria,
  repo-map overrides); layering per the config-cascade convention (all three layers — user-global
  ~/.claude/plugin-quality.md, tracked team file, gitignored .local overlay — with merge
  semantics DECLARED); sink resolution ladder (tracked config → infer from the audited plugin's
  marketplace registration → ask + offer persist → local markdown work-item fallback); the
  local-markdown item schema.
• Add the plugin-quality implementers row to docs/conventions/config-cascade/README.md.
• Compat-target reconciliation (do this FIRST): diff the fixture schema below (the live
  handoff-inbox contract this plugin's user-global sink override must reproduce byte-compatibly)
  against the work-items local-markdown adapter shape, and fix the emitted-item schema to
  satisfy BOTH or document the delta — divergence must be resolved in this lane, not discovered at
  cutover.

Fixture — handoff-inbox front-matter schema (captured 2026-07-24 from the inbox README)

id: 20260721-211548-guardrails-source-control-audit   # <UTC yyyymmdd-HHMMSS>-<slug>, sortable + collision-safe
title: <short imperative title>
status: unclaimed        # unclaimed -> claimed -> in-progress -> blocked -> done
priority: high|med|low
created: 2026-07-21T21:15:48Z    # UTC ISO-8601
updated: 2026-07-21T21:15:48Z
producer: SW2030 (Windows/PowerShell)   # consuming env that raised it
source_plugins:
  - guardrails@0.9.5
  - source-control@0.16.0
component_types: [hook, skill, config]   # skill|agent|hook|command|config
claimed_by: null
claimed_at: null
lease_ttl_hours: 24
issues: []
prs: []
resolution: null

Filename = <id>.md; states: unclaimed/claimed/in-progress/blocked/done; claim = status +
claimed_by + claimed_at with lease_ttl_hours reclaim convention.

Acceptance criteria

• grep -c 'plugin-quality' docs/conventions/config-cascade/README.md ≥ 1 (implementers row)
• Merge semantics explicitly declared in reference/config.md (concatenate or per-key, stated)
• Reconciliation outcome recorded: fixture schema vs local-markdown adapter shape — match or
  documented delta with the emitted-item schema decision
• Sink ladder documented with all four rungs and the draft+confirm egress gate cross-referenced

Blocked by

• Audit-hub slice (native edge — the ladder and gate live in the hub; this documents + rows them).

[kyle-sexton]

[kyle-sexton]

Closed by PR #1243 (squash c287fbca). Evidence: config-cascade implementers row landed (per-key override declared); merge semantics declared in reference/config.md; reconciliation recorded — markdown item schema byte-matches the live handoff inbox fixture (captured 2026-07-24), work-items local-markdown adapter storage documented divergent-by-design with seam-CLI-only emission (review-hardened: seam emit now behind the same confirm gate); all four ladder rungs documented with the egress gate cross-referenced and every documented key consumed by the workflow.