maestro-economics 0.2.0

Econometric analysis engine for agents. OLS, FE, IV/2SLS, DiD, RDD, Event Study, Causal Forest.

maestro-economics

maestro-economics is the canonical repository for the Maestro economics skill, the mecon CLI, the run(ctx) runtime contract, and the Modal worker used by RA Compute.

This repo exists to keep four things aligned:

• agent guidance
• packaging and PyPI release
• workspace/runtime execution
• cloud worker implementation

Scope

This repository currently contains:

• mecon CLI for setup, workspace tracking, sync, submit, watch, logs, download
• run(ctx) runtime with progress, logs, checkpoints, data loading, and transform helpers
• Modal worker entrypoints for GPU execution
• economics method registry and analysis scaffolding
• agent skill documentation used to guide professor-facing and agent-facing workflows

Canonical flow

pip install maestro-economics

mecon setup
mecon whoami

mecon workspace init
mecon add run.py data.parquet
mecon sync

mecon submit run.py --gpu l4
mecon watch <job_id>
mecon logs -f <job_id>
mecon sync

download still exists, but workspace mode should normally use sync to pull output/ artifacts back.

Worker contract

Jobs must expose run(ctx).

def run(ctx):
    ctx.log("Loading data")
    ctx.progress(0.1, "Loading data")

    # read from ctx.data_dir
    # write artifacts to ctx.output_dir

    ctx.save_checkpoint(step=1)
    ctx.progress(1.0, "Done")
    return {"diagnostics": {"converged": True}}

Available helpers:

• ctx.progress(pct, message)
• ctx.log(message)
• ctx.save_checkpoint(**arrays)
• ctx.load_checkpoint()
• ctx.has_checkpoint
• ctx.data_dir
• ctx.output_dir
• ctx.config
• ctx.gpu

Install and verify

python3 -m pip install -e .
pytest -q
python3 -m compileall src/maestro_economics

Plugin packaging

This repository now includes root-level plugin manifests for both ecosystems:

• Claude Code: .claude-plugin/plugin.json
• Claude marketplace: .claude-plugin/marketplace.json
• Codex: .codex-plugin/plugin.json

The repository itself is the plugin root. A separate Codex marketplace catalog is intentionally not added here because this repo is a single plugin source, not a multi-plugin catalog.

Repository rule

Do not introduce a second runtime repo. If the skill, CLI, PyPI package, and worker drift apart again, the product becomes unreliable immediately.