Skip to content

docs: one analytics story, and the images catch up with the consolidated surface (issue #181) - #184

Merged
edgehero merged 1 commit into
mainfrom
docs/insights-only-docs
Aug 12, 2026
Merged

docs: one analytics story, and the images catch up with the consolidated surface (issue #181)#184
edgehero merged 1 commit into
mainfrom
docs/insights-only-docs

Conversation

@edgehero

Copy link
Copy Markdown
Owner

Last slice of #181: every doc and both READMEs now describe the one analytics surface, and the screenshot set matches what ships.

What

  • docs/costs.md and docs/graph.md lose their view/command sections and survive as the semantics references behind what the insights page draws (the class table, the edge evidence classes, the attribution rules, the honest limits). The surface list in costs.md becomes: the page, insights whatif, and dispatch_costs.
  • docs/insights.md speaks the bare grammar, gains the budget and trend-line reading bullets (the lever framing included), and points the what-if at insights whatif.
  • demo.md gains the i beat and the exact new footer; workflows.md and launch-kit.md updated.
  • README.md: the intro bullet, the when-to-use paragraph (bare /dispatch insights, budget dials named as the one real cost lever), the admin-panel section rewritten around the i key and the page, the plain-commands list, and the usage-ledger sentence. admin/README.md: the three analytics bullets merge into one insights story. The no-dash rule holds in both.
  • Images: costs-view.svg/.png deleted (the view is gone); dispatch-dashboard.svg's footer line rewritten to the shipped footer (i insights, row width preserved at exactly 80 characters inside the borders) and its PNG re-rendered at the exact prior 1803x1811; insights-view.png regenerated from the page WITH the budget panel, cumulative line and flow multiples; graph-view.png kept byte-unchanged as the topology close-up. Changed references bump to ?v=0.12.0.

Specs UNCHANGED, checked: this slice states what the code slices shipped and changes no behaviour. Suite green in the CI posture (2192 tests, 0 skipped, live Valkey).

…ted surface (issue #181)

The last slice of #181: every doc and both READMEs now describe the
one analytics surface.

- docs/costs.md and docs/graph.md lose their view/command sections and
  survive as the semantics references behind what the insights page
  draws; docs/insights.md speaks the bare grammar, gains the budget
  and trend-line reading bullets, and points the what-if at
  insights whatif; demo.md's shot list gains the i beat and the exact
  new footer; workflows.md and launch-kit.md updated.
- README.md: the intro bullet, the when-to-use paragraph (bare
  /dispatch insights, budget dials named as the one real lever), the
  admin-panel section rewritten around the i key and the page, the
  command list, and the usage-ledger sentence. admin/README.md: the
  three analytics bullets merge into one insights story. Dash rule
  holds in both.
- Images: costs-view.svg/png DELETED (the view is gone);
  dispatch-dashboard.svg's footer line rewritten to the shipped
  footer (i insights; row width preserved at 80 chars inside borders)
  and its PNG re-rendered at the exact prior 1803x1811;
  insights-view.png regenerated from the page WITH the budget panel,
  cumulative line and flow multiples; graph-view.png kept byte-
  unchanged as the topology close-up. Changed references bump to
  ?v=0.12.0.

Specs UNCHANGED, checked: this slice states what the code slices
shipped and changes no behaviour.

Suite green in the CI posture: 2192 tests, 0 skipped, live Valkey.

Signed-off-by: Rob Boerman <robboerman@live.nl>
@edgehero
edgehero merged commit d826df9 into main Aug 12, 2026
17 of 18 checks passed
edgehero added a commit that referenced this pull request Aug 12, 2026
Ships the insights consolidation: issues #175 and #181, PRs #176-#180
and #182-#184.

- admin 0.8.0: insights is the ONE analytics surface. Bare /dispatch
  insights (and the panel's i key) writes and opens the self-contained
  page: budget dials with used-vs-cap facts and the worker's own
  states, plan verdicts, daily + cumulative + per-flow spend charts,
  the four breakdowns, and the trigger/flow topology with schedule
  tips and spend badges. insights whatif is the estimator. The COSTS
  and GRAPH views and the costs/graph subcommands are REMOVED; the
  cost-fold correctness fixes (requested-window proration, flowKey,
  other/other, truncated-ledger counter) and the byTrigger/byRepo/
  dailyByFlow folds ride along. dispatch_costs is unchanged.
- worker 0.3.0 and receiver 0.2.1 are unchanged since v0.10.0 and
  their publishes skip.
- Image ?v= tags normalized to this release's version.

Suite green in the CI posture: 2192 tests, 0 skipped, live Valkey.

Signed-off-by: Rob Boerman <robboerman@live.nl>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant