dxkit-describe

dxkit-describe

This skill turns a repo into a shareable, honest picture: what dxkit can see about the stack and its HTTP contracts, and — the part that builds trust — how much of it dxkit actually resolved versus inferred or could not see.

It is zero-write by default. Nothing lands in the repo unless the user explicitly saves the HTML map with --out.

The one command

vyuh-dxkit describe [path]            # terminal summary (zero-write)
vyuh-dxkit describe --json            # the versioned repo card (dxkit.repo-card.v1)
vyuh-dxkit describe --html            # the contract-map HTML to stdout
vyuh-dxkit describe --html --out map.html   # save the map (explicit opt-in write)

Everything is computed from the code (flow spine, seams, models) via the same canonical analyzers the gate uses — no new heuristics, no second confidence scale.

What it produces

• A repo card: stack, routes, calls, bindings, and models, each count broken down by epistemic label:
  • observed — dxkit parsed the source itself,
  • derived — from a declared contract (a spec) dxkit trusts but didn't see,
  • inferred — a heuristic binding that carries a confidence and may be wrong,
  • unknown — the fact exists but can't be resolved (a runtime URL, a missing scanner).
• The seams, which a linter cannot see:
  • unresolved calls — client calls that reach no served route (integration gaps),
  • unconsumed routes — served routes nothing calls (dead-surface candidates).
• A holistic contract-map HTML: a self-contained, offline, light/dark page that joins dxkit's OWN call graph (deeper than graphify — it keeps the framework/stdlib calls graphify drops) to the HTTP contract layer, ACROSS repos. Swimlanes per repo, left→right callers → routes → handlers; seams (broken call / dead route) glow; cross-repo edges are distinct; each handler expands on click to its internal + framework calls (the depth graphify can't see). The honesty rides on the picture. When a .dxkit/workspace.json declares local-path participants, the map spans them (offline — it never fetches).