Skip to content

Two-surface drilldown & stacked-bar UX #15

Closed

Description

@Whamp

Question

Decide the overlay behavior for the two-surface taxonomy. Today BudgetOverlay (src/report-view.ts) has modes sections / drilldown / tools / skill-toggle / trace, and the stacked bar + legend iterate the flat parsed.sections. The top-level table will now show two rows (Combined System Prompt, Combined Tool Definitions), each drilling into contributor rows, some of which drill further (files, skills, tools).

Raise fidelity with /prototype — a rough TUI stub or ASCII mock of:

  • The top-level table with 2 surfaces and the stacked-bar / legend treatment (2 segments, or a contributor-level breakdown within each surface?).
  • 2-level drilldown: Surface → Contributor → Item (file / skill / tool). How do the existing tools and skill-toggle modes fold into a uniform nested drilldown?
  • Where Inactive Available Tools lives (collapsed counterfactual group, today in the tools view) and how Tool Envelope Overhead renders (leaf).
  • Keyboard hints per level.

Decide the shape; do not implement the real overlay.

Output

A prototype artifact (linked) and a decision on the drilldown-mode structure, stacked-bar treatment, and how tools / skill-toggle integrate. Blocked by the data-model ticket.

Activity

  1. self-assigned this
    on Jul 9, 2026
  2. Whamp commented on Jul 9, 2026

    @Whamp
    OwnerAuthor

    Resolution

    Prototype artifact: https://gist.github.com/Whamp/21a11f1b18bc9bb68ede159af1cff97d

    Decision: use Variant A — Surface-first overview, scoped contributor bars.

    • The overview stacked bar shows exactly two counted segments: Combined System Prompt and Combined Tool Definitions.
    • Contributor-level stacked bars appear only after drilling into a selected surface.
    • Navigation uses one recursive drilldown model: Surface → Contributor → Item. Existing tools and skill-toggle behavior should become row capabilities inside that nested model rather than separate navigation worlds.
    • Skill Catalog drilldown keeps the existing Skill Management Session affordances: cycle state, edit, search, save, back.
    • Tool rows become normal item leaves with e to view schema JSON.
    • Inactive Available Tools appears as a collapsed, non-counted counterfactual group under Combined Tool Definitions.
    • Tool Envelope Overhead renders as a counted leaf under Combined Tool Definitions for this UX decision; ticket Tool Envelope Overhead placement still decides whether implementation keeps it global or makes it more granular.

    This resolves the stacked-bar treatment fog: top-level stays surface-only; contributor detail is scoped to surface drilldown.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions