tools/

action-log-scan paginates through an agent's server-side action log (get_action_log) and reports the distinct event_types seen, with per-type counts, the owning category, and an example summary.

Action Visualizer — interactive web tool for exploring the game action space.

Command agents-by-system reads the latest agent snapshots from daily-summary.db, joins them against the spacemolt knowledge base (systems + pois), and renders an HTML page grouping agents by the empire of the system they are currently in, then by system, then POI.

bulk-buy-order places buy orders for every item in the crafting database to seed market data.

bulk-sell-order sells items from station storage by creating sell orders.

Command craft-dashboard serves a live HTML dashboard for Executor B's dispatched craft plans: each plan's DAG rendered as a mermaid flowchart (done nodes faded grey, dispatched nodes bold/gold, parked nodes red) plus a per-item progress table.

Command daily-summary connects to game agents, captures state snapshots, stores them in SQLite, and generates diff reports showing day-over-day changes.

Command faction-dashboard collects comprehensive faction data from member agents into the shared knowledge base and renders static HTML dashboards.

Command fit is an offline ship-fitting calculator.

Command fleet-report prints a per-agent hauler report: current location and credits, the agent's starting balance, total and since-midnight credit deltas, and realized arbitrage profit.

Command haul-dashboard renders a self-contained hauler dashboard HTML file from the durable haul_results + fleet_timeseries history in market.db and the live fleet-status.json.

Command haul-distances reports, for each hauler in the live fleet-status file, the jump distance from its current system to the nearest AVAILABLE arbitrage opportunity's buy system — using the same jump graph and name resolution the hauler ranker uses.

haul-pnl reconciles each hauler's TRUE realized profit-and-loss from the server-side action log against the numbers recorded in market.db.

Command kb-drift-audit compares the knowledge-base sqlite DB against the authoritative catalog/map JSON files in data/game-api/ and reports:

Command market-prune enforces a retention window on the market_orders table.

Command market-recompute-ohlcv repairs market_ohlcv rows poisoned by the game's "not for sale" sentinel price (999999).

Command market-snapshot summarizes a raw view_market response snapshot: how many orders match a given source (e.g.

Command market-stats prints summary statistics for the market intelligence database (default: ~/spacemolt/spacemolt/data/market.db).

Command overmind-status serves a live HTML status page for one or more overminds.

Example: Integrating slog into play_as/main.go This shows how to add configurable log levels to the existing tool

Command run-skill connects an agent to the game server and executes one or more named skills from data/skills/ in sequence.

server-cmd sends a raw command to the game server using an agent's credentials and prints the full JSON response.

Command skill-graph reads a skill YAML file and outputs a DOT digraph representation suitable for rendering with Graphviz.

skill-tree reads skills.json and generates Graphviz DOT files (one per category) showing the skill dependency tree.

Slog demonstration - comparing std log vs log/slog

Command spar runs a controlled PvP sparring match between two or more of our own agents in a non-empire arena, so combat mechanics are observable and testable.

Command view-learning provides interactive access to agent learning records.

Command view-market provides interactive access to market data.