interpretable-context-methodology-template

Dashboard Prototype

icm dashboard starts a local, read-only dashboard for an ICM workspace.

icm dashboard examples/completed-project-plan

By default, the dashboard opens at http://127.0.0.1:8765/. If that port is busy, ICM tries nearby ports. Use --no-open when you want to start the server without opening a browser:

icm dashboard examples/completed-project-plan --no-open

What It Shows

• Stage states from icm status --json.
• Review queue findings from icm review ... --json.
• Human acceptance from shared/acceptance-log.md.
• Workspace health findings from icm doctor --json.
• Source links back to workspace markdown files.
• Source-preview excerpts for stage contracts, reviewed outputs, finding-related files, and matching acceptance-log rows.
• The exact CLI commands that produced the dashboard data.
• Copy buttons for review, acceptance, and JSON source commands.

The prototype does not write workflow state, edit files, mark handoffs accepted, or use a database. It gives you copyable terminal commands for review and acceptance, then shows acceptance that was recorded by icm accept or by directly editing shared/acceptance-log.md. Close the browser or stop the server and the workspace still works through the same CLI commands.

Useful Examples

Run against the completed project-planning example:

icm dashboard examples/completed-project-plan

Run against your current workspace:

icm dashboard .

Choose a port:

icm dashboard . --port 8780

Bind only to localhost unless you have a specific reason to expose it elsewhere:

icm dashboard . --host 127.0.0.1

Data Contract

The dashboard consumes the same JSON contract documented in json-output.md:

icm status . --json
icm review stages/01_discovery --workspace . --json
icm accept stages/01_discovery --workspace . --json
icm doctor . --json

That keeps the browser view honest. If the dashboard and terminal disagree, the terminal JSON is the contract to debug first.

The dashboard labels review-passing outputs as machine passing until a human records acceptance. Accepted handoffs come from handoff-acceptance.md. The review queue shows copyable icm review ... and icm accept ... commands, plus source previews for the contract, output, and acceptance-log row, so the browser remains read-only while the filesystem remains authoritative.

This site is open source. Improve this page.