justfile

set shell := ["bash", "-uc"]
export PYTHONDONTWRITEBYTECODE := "1"

bootstrap:
    cd engine && python3 -m pip install -e ".[dev]"

demo:
    cd engine && python3 -m zero_engine.demo

example:
    PYTHONPATH="$PWD/engine/src" python3 examples/paper-trading/run.py

strategy-example:
    PYTHONPATH="$PWD/engine/src" python3 examples/paper-trading/strategy_demo.py

strategy-plugin-example:
    PYTHONPATH="$PWD/engine/src:$PWD/examples/strategy-plugin" python3 examples/strategy-plugin/run.py

momentum-strategy-plugin-example:
    PYTHONPATH="$PWD/engine/src:$PWD/examples/momentum-strategy-plugin" python3 examples/momentum-strategy-plugin/run.py

strategy-runner-example:
    PYTHONPATH="$PWD/engine/src" python3 examples/strategy-runner/run.py

market-data-adapter-example:
    PYTHONPATH="$PWD/engine/src:$PWD/examples/market-data-adapter" python3 examples/market-data-adapter/run.py

funding-rate-adapter-example:
    PYTHONPATH="$PWD/examples/funding-rate-adapter" python3 examples/funding-rate-adapter/run.py

intelligence-catalog-page-example:
    PYTHONPATH="$PWD/engine/src" python3 examples/intelligence-catalog-page/build.py

network-leaderboard-example:
    PYTHONPATH="$PWD/engine/src" python3 examples/network-leaderboard/build.py

network-profile-page-example:
    PYTHONPATH="$PWD/engine/src" python3 examples/network-profile-page/build.py

network-stale-profile-example:
    PYTHONPATH="$PWD/engine/src" python3 examples/network-stale-profile/build.py --output /tmp/zero-stale-profile.json >/dev/null

network-empty-profile-example:
    PYTHONPATH="$PWD/engine/src" python3 examples/network-empty-profile/build.py --output /tmp/zero-empty-profile.json >/dev/null

network-leaderboard-page-example:
    PYTHONPATH="$PWD/engine/src" python3 examples/network-leaderboard-page/build.py

network-index-page-example:
    PYTHONPATH="$PWD/engine/src" python3 examples/network-index-page/build.py

runtime-loop-example:
    PYTHONPATH="$PWD/engine/src" python3 examples/runtime-loop/run.py

memory-core-example:
    rm -rf artifacts/memory-example
    PYTHONPATH="$PWD/engine/src" python3 -m zero_engine.memory extract --decisions examples/memory-core/decisions.jsonl --store artifacts/memory-example/memory.jsonl --knowledge artifacts/memory-example/knowledge.md --now 2026-05-01T00:00:00Z
    test -f artifacts/memory-example/memory.jsonl
    test -f artifacts/memory-example/knowledge.md
    ! rg '40500|1400|notional_usd|private_key|wallet_address' artifacts/memory-example

genesis-example:
    rm -rf artifacts/genesis-example
    PYTHONPATH="$PWD/engine/src" python3 -m zero_engine.genesis plan --proposals examples/genesis/proposals.jsonl --journal artifacts/genesis-example/genesis.jsonl --now 2026-05-01T00:00:00Z
    PYTHONPATH="$PWD/engine/src" python3 -m zero_engine.genesis status --journal artifacts/genesis-example/genesis.jsonl --now 2026-05-01T00:00:00Z
    test -f artifacts/genesis-example/genesis.jsonl
    rg '"decision":"accepted"' artifacts/genesis-example/genesis.jsonl
    rg '"decision":"rejected"' artifacts/genesis-example/genesis.jsonl
    rg '"decision":"escalated"' artifacts/genesis-example/genesis.jsonl
    ! rg 'private_key|wallet_address|exchange_order_id|notional_usd' artifacts/genesis-example

evolve-example:
    rm -rf artifacts/evolve-example
    PYTHONPATH="$PWD/engine/src" python3 -m zero_engine.genesis plan --proposals examples/genesis/proposals.jsonl --journal artifacts/evolve-example/genesis.jsonl --now 2026-05-01T00:00:00Z
    PYTHONPATH="$PWD/engine/src" python3 -m zero_engine.evolve run --genesis-journal artifacts/evolve-example/genesis.jsonl --output artifacts/evolve-example --repo-root "$PWD" --now 2026-05-01T00:00:00Z
    PYTHONPATH="$PWD/engine/src" python3 -m zero_engine.evolve status --run artifacts/evolve-example/evolve-run.json --now 2026-05-01T00:00:00Z
    test -f artifacts/evolve-example/evolve-run.json
    test -f artifacts/evolve-example/worktree/candidate.patch
    rg '"schema_version": "zero.evolve.run.v1"' artifacts/evolve-example/evolve-run.json
    rg '"verdict": "pass"' artifacts/evolve-example/evolve-run.json
    rg '"pushes_to_remote": false' artifacts/evolve-example/evolve-run.json
    ! rg 'private_key|wallet_address|exchange_order_id|notional_usd' artifacts/evolve-example

research-example:
    rm -rf artifacts/research-example
    PYTHONPATH="$PWD/engine/src" python3 -m zero_engine.research run --repo-root "$PWD" --output artifacts/research-example/research.json --now 2026-05-01T00:00:00Z
    PYTHONPATH="$PWD/engine/src" python3 -m zero_engine.research status --report artifacts/research-example/research.json --now 2026-05-01T00:00:00Z
    test -f artifacts/research-example/research.json
    rg '"schema_version": "zero.research.report.v1"' artifacts/research-example/research.json
    rg '"hunt"' artifacts/research-example/research.json
    rg '"edge"' artifacts/research-example/research.json
    rg '"convergence"' artifacts/research-example/research.json
    rg '"pushes_to_remote": false' artifacts/research-example/research.json
    ! rg 'private_key|wallet_address|exchange_order_id|notional_usd' artifacts/research-example

decision-stack-example:
    rm -rf artifacts/decision-stack-example
    mkdir -p artifacts/decision-stack-example
    PYTHONPATH="$PWD/engine/src" python3 -m zero_engine.decision --coin BTC --price 40500 --source paper:fixture --sample-size 4 > artifacts/decision-stack-example/decision-stack.json
    test -f artifacts/decision-stack-example/decision-stack.json
    rg '"schema_version": "zero.decision.stack.v1"' artifacts/decision-stack-example/decision-stack.json
    rg '"lenses"' artifacts/decision-stack-example/decision-stack.json
    rg '"layers"' artifacts/decision-stack-example/decision-stack.json
    rg '"modifiers"' artifacts/decision-stack-example/decision-stack.json
    rg '"allowed_to_execute_live": false' artifacts/decision-stack-example/decision-stack.json
    ! rg 'private_key|wallet_address|exchange_order_id|notional_usd|idempotency_key' artifacts/decision-stack-example

network-pages-smoke:
    scripts/network_pages_smoke.py

intelligence-catalog-page-smoke:
    scripts/intelligence_catalog_page_smoke.py

paper-api:
    cd engine && python3 -m zero_engine.api

paper-api-smoke:
    scripts/paper_api_smoke.sh

fresh-clone-rehearsal:
    scripts/fresh_clone_rehearsal.sh

demo-capture:
    scripts/demo_capture.sh

issue-template-check:
    scripts/issue_template_check.py

label-taxonomy-check:
    scripts/label_taxonomy_check.py

github-label-config-check:
    scripts/github_label_sync.py --validate-config

github-label-check repo="zero-intel/zero":
    scripts/github_label_sync.py --repo "{{repo}}" --check

github-label-sync repo="zero-intel/zero":
    scripts/github_label_sync.py --repo "{{repo}}" --apply

launch-issue-config-check:
    scripts/github_launch_issues.py --validate-config

github-launch-issue-check repo="zero-intel/zero":
    scripts/github_launch_issues.py --repo "{{repo}}" --check

github-launch-issue-sync repo="zero-intel/zero":
    scripts/github_launch_issues.py --repo "{{repo}}" --apply

codeowners-check:
    scripts/codeowners_check.py

stale-artifact-check:
    scripts/stale_artifact_check.sh --check

stale-artifact-clean:
    scripts/stale_artifact_check.sh --clean

hardening-gate:
    scripts/hardening_gate.sh

public-readiness:
    scripts/public_readiness_gate.sh

package-dry-run:
    scripts/package_dry_run.sh

registry-readiness:
    scripts/registry_readiness.py
    scripts/registry_launch_packet.py --check
    scripts/mcp_registry_packet.py --check
    scripts/mcp_registry_listing_check.py --json >/dev/null

railway-template-packet:
    scripts/railway_template_packet.py --check

mcp-registry-listing-check:
    scripts/mcp_registry_listing_check.py --json

release-rehearsal:
    scripts/release_rehearsal.sh

release-verify dir:
    scripts/release_verify.py "{{dir}}"

release-provenance dir:
    scripts/release_provenance.py "{{dir}}"

release-evidence tag:
    scripts/release_evidence.py "{{tag}}"

release-preflight: public-proof registry-readiness package-dry-run release-rehearsal draft-release-rehearsal

llms-full:
    scripts/generate_llms_full.py

proof-pack:
    PYTHONPATH="$PWD/engine/src" scripts/proof_pack.py

network-proof-pack:
    PYTHONPATH="$PWD/engine/src" scripts/network_proof_pack.py

live-trading-evidence-check:
    scripts/live_trading_evidence.py verify docs/proof/live/live-trading-evidence.json

public-proof:
    PYTHONPATH="$PWD/engine/src" scripts/proof_pack.py --check
    PYTHONPATH="$PWD/engine/src" scripts/network_proof_pack.py --check
    scripts/live_trading_evidence.py verify docs/proof/live/live-trading-evidence.json
    PYTHONPATH="$PWD/engine/src" scripts/proof_privacy_regression.py
    PYTHONPATH="$PWD/engine/src" python3 -m zero_engine.mcp --smoke
    PYTHONPATH="$PWD/engine/src" scripts/mcp_transcript.py --check

draft-release-rehearsal:
    scripts/draft_release_rehearsal.sh

release-workflow-rehearsal:
    scripts/release_workflow_rehearsal.sh

homebrew-formula release_dir tag:
    scripts/homebrew_formula.py "{{release_dir}}" --tag "{{tag}}"

homebrew-formula-check:
    scripts/homebrew_formula_check.py

railway-smoke:
    scripts/railway_smoke.sh

deployment-evidence url:
    scripts/deployment_evidence.sh "{{url}}"

live-canary-rehearsal url:
    scripts/live_canary_rehearsal.py "{{url}}"

live-canary-verify dir:
    scripts/live_canary_verify.py "{{dir}}"

live-canary-exchange-evidence bundle source:
    scripts/live_canary_exchange_evidence.py "{{bundle}}" "{{source}}"

live-canary-operator url:
    scripts/live_canary_operator.py "{{url}}"

live-canary-operator-verify workflow:
    scripts/live_canary_operator_verify.py "{{workflow}}"

live-cockpit-drill url="http://127.0.0.1:8765":
    scripts/live_cockpit_drill.py "{{url}}"

live-cockpit-drill-verify dir:
    scripts/live_cockpit_drill_verify.py "{{dir}}"

live-cockpit-drill-tamper-rehearsal dir:
    scripts/live_cockpit_drill_tamper_rehearsal.py "{{dir}}"

checksum output *artifacts:
    python3 scripts/write_sha256s.py "{{output}}" {{artifacts}}

engine-lint:
    cd engine && ruff check --no-cache .

engine-format:
    cd engine && ruff format .

engine-test:
    cd engine && PYTHONPATH="$PWD/src" pytest -p no:cacheprovider

cli-lint:
    cd cli && cargo fmt --all --check && cargo clippy --workspace --all-targets -- -D warnings

cli-test:
    cd cli && cargo test --workspace

docs-check:
    test -f AGENTS.md
    test -L CLAUDE.md
    test -L GEMINI.md
    test "$(readlink CLAUDE.md)" = "AGENTS.md"
    test "$(readlink GEMINI.md)" = "AGENTS.md"
    test -f .cursor/rules/global.mdc
    test -f .claude/commands/README.md
    test -f .claude/commands/paper-backtest.md
    test -f .claude/commands/verify-schema.md
    test -f .claude/commands/proof-pack.md
    test -f .claude/commands/mcp-transcript.md
    test -f .claude/commands/new-strategy.md
    test -f .github/copilot-instructions.md
    test -f .github/workflows/mcp-registry.yml
    test -f .devcontainer/Dockerfile
    test -f .devcontainer/devcontainer.json
    test -f .devcontainer/README.md
    test -f .github/ISSUE_TEMPLATE/agent_task.yml
    test -f .github/ISSUE_TEMPLATE/bug_report.yml
    test -f .github/ISSUE_TEMPLATE/design_review.yml
    test -f .github/ISSUE_TEMPLATE/docs_gap.yml
    test -f .github/ISSUE_TEMPLATE/feature_request.yml
    test -f .github/ISSUE_TEMPLATE/safety_review.yml
    test -f .github/ISSUE_TEMPLATE/strategy_example.yml
    test -f .github/ISSUE_TEMPLATE/config.yml
    test -f .github/CODEOWNERS
    test -f .github/labels.yml
    test -f llms.txt
    test -f docs/llms.txt
    test -f docs/llms-full.txt
    test -f docs/assets/readme-terminal.svg
    test -f docs/proof/README.md
    test -f docs/proof/demo/README.md
    test -f docs/proof/demo/proof-pack.json
    test -f docs/proof/demo/paper-decisions.csv
    test -f docs/proof/demo/paper-proof.svg
    test -f docs/proof/network/README.md
    test -f docs/proof/network/network-proof-pack.json
    test -f docs/proof/network/profile.json
    test -f docs/proof/network/profile-verification.json
    test -f docs/proof/network/leaderboard.json
    test -f docs/proof/network/identity/identity_bundle.json
    test -f docs/proof/network/identity/SHA256SUMS
    test -f docs/proof/live/README.md
    test -f docs/proof/live/live-trading-evidence.json
    test -f docs/proof/privacy-regression/README.md
    test -f docs/proof/privacy-regression/wallet-like-profile.json
    test -f docs/proof/privacy-regression/raw-exchange-id-profile.json
    test -f docs/local-development.md
    test -f docs/first-10-minutes.md
    test -f docs/demo-terminal.md
    test -f docs/cli-quickstart.md
    test -f docs/cli-doctor-troubleshooting.md
    test -f docs/api.md
    test -f docs/agent-architecture.md
    test -f docs/mcp.md
    test -f docs/mcp-registry.md
    test -f docs/mcp/transcript.jsonl
    test -f docs/api-compatibility.md
    test -f docs/runtime-bus.md
    test -f docs/journal-integrity.md
    test -f docs/memory-core.md
    test -f docs/genesis.md
    test -f docs/evolve.md
    test -f docs/research.md
    test -f docs/decision-stack.md
    test -f docs/strategy-plugins.md
    test -f docs/market-data-adapters.md
    test -f docs/positioning.md
    test -f docs/open-core-boundary.md
    test -f docs/zero-network.md
    test -f docs/network-freshness.md
    test -f docs/zero-intelligence.md
    test -f docs/threat-model.md
    test -f docs/failure-modes-autonomous-loop.md
    test -f docs/incident-runbooks.md
    test -f docs/incident-postmortems/README.md
    test -f docs/incident-postmortems/TEMPLATE.md
    test -f docs/dependency-policy.md
    test -f docs/distribution.md
    test -f docs/registry-launch.md
    test -f docs/hyperliquid-readonly.md
    test -f docs/live-certification.md
    test -f docs/live-cockpit.md
    test -f docs/live-evidence.md
    test -f docs/live-canary-operator.md
    test -f docs/operator-context.md
    test -f docs/deployment-identity.md
    test -f docs/model-gateway.md
    test -f docs/operator-isolation.md
    test -f docs/immune-system.md
    test -f docs/production-readiness.md
    test -f docs/public-upgrade.md
    test -f docs/autonomous-os-plan.md
    test -f docs/agentic-contribution.md
    test -f docs/contributor-issue-board.md
    test -f docs/qa-onboarding-checklist.md
    test -f docs/label-taxonomy.md
    test -f docs/release.md
    test -f docs/release-verification.md
    test -f docs/releases/v0.1.1.md
    test -f docs/releases/v0.1.2.md
    test -f docs/releases/v0.1.1-evidence.md
    test -f docs/releases/v0.1.2-evidence.md
    test -f docs/launch-scorecard.md
    test -f docs/backlog.md
    test -f docs/launch-issues.md
    test -x scripts/contributor_board_check.py
    test -f .github/RELEASE_TEMPLATE.md
    test -f examples/paper-trading/run.py
    test -f examples/paper-trading/strategy_demo.py
    test -f examples/paper-trading/scenario.json
    test -f examples/paper-trading/candles.jsonl
    test -f examples/strategy-plugin/README.md
    test -f examples/strategy-plugin/plugin.py
    test -f examples/strategy-plugin/run.py
    test -f examples/momentum-strategy-plugin/README.md
    test -f examples/momentum-strategy-plugin/plugin.py
    test -f examples/momentum-strategy-plugin/run.py
    test -f examples/strategy-runner/README.md
    test -f examples/strategy-runner/close-strength.yaml
    test -x examples/strategy-runner/run.py
    test -f examples/market-data-adapter/README.md
    test -f examples/market-data-adapter/adapter.py
    test -f examples/market-data-adapter/candles.jsonl
    test -f examples/market-data-adapter/run.py
    test -f examples/funding-rate-adapter/README.md
    test -f examples/funding-rate-adapter/adapter.py
    test -f examples/funding-rate-adapter/funding_rates.jsonl
    test -f examples/funding-rate-adapter/run.py
    test -f examples/runtime-loop/README.md
    test -x examples/runtime-loop/run.py
    test -f examples/memory-core/README.md
    test -f examples/memory-core/decisions.jsonl
    test -f examples/genesis/README.md
    test -f examples/genesis/proposals.jsonl
    test -f examples/evolve/README.md
    test -f examples/research/README.md
    test -f examples/network-leaderboard/README.md
    test -f examples/network-leaderboard/build.py
    test -f examples/network-leaderboard/profiles.jsonl
    test -f examples/network-profile-page/README.md
    test -f examples/network-profile-page/build.py
    test -f examples/network-stale-profile/README.md
    test -f examples/network-stale-profile/build.py
    test -f examples/network-stale-profile/stale-profile.json
    test -f examples/network-empty-profile/README.md
    test -x examples/network-empty-profile/build.py
    test -f examples/network-empty-profile/empty-profile.json
    test -f examples/network-leaderboard-page/README.md
    test -f examples/network-leaderboard-page/build.py
    test -f examples/network-index-page/README.md
    test -f examples/network-index-page/build.py
    test -f examples/intelligence-catalog-page/README.md
    test -f examples/intelligence-catalog-page/build.py
    test -f contracts/paper-api/v2_status.json
    test -f contracts/paper-api/execute_accepted.json
    test -f contracts/paper-api/execute_rejected.json
    test -f contracts/paper-api/memory.json
    test -f contracts/paper-api/genesis.json
    test -f contracts/paper-api/evolve.json
    test -f contracts/paper-api/research.json
    test -f contracts/paper-api/decision_stack.json
    test -f contracts/deployment/claim.json
    test -f contracts/deployment/heartbeat.json
    test -f contracts/live/evidence.json
    test -f contracts/live/receipts.json
    test -f contracts/network/profile.json
    test -f contracts/network/empty-profile.json
    test -f contracts/network/leaderboard.json
    test -f contracts/network/ingestion.json
    test -f contracts/network/profile.html
    test -f contracts/network/empty-profile.html
    test -f contracts/network/stale-profile.html
    test -f contracts/network/leaderboard.html
    test -f contracts/network/index.html
    test -f contracts/intelligence/snapshot.json
    test -f contracts/intelligence/catalog.json
    test -f contracts/intelligence/catalog.html
    test -f contracts/intelligence/commercial.json
    test -f contracts/intelligence/model_gateway.json
    test -f contracts/intelligence/model_gateway_health.json
    test -f contracts/intelligence/model_gateway_audit.json
    test -f contracts/distribution/registry-launch.json
    test -f contracts/distribution/mcp-registry.json
    test -f contracts/distribution/railway-template.json
    test -f server.json
    test -f openapi/zero-paper-api.v1.yaml
    test -x scripts/assemble_release_assets.sh
    test -x scripts/install.sh
    test -x scripts/railway_template_packet.py
    test -x scripts/demo_capture.sh
    test -x scripts/issue_template_check.py
    test -x scripts/label_taxonomy_check.py
    test -x scripts/github_label_sync.py
    test -x scripts/github_launch_issues.py
    test -x scripts/codeowners_check.py
    test -x scripts/stale_artifact_check.sh
    test -x scripts/openapi_contract_check.py
    test -x scripts/network_pages_smoke.py
    test -x scripts/intelligence_catalog_page_smoke.py
    test -x scripts/package_dry_run.sh
    test -x scripts/registry_readiness.py
    test -x scripts/registry_launch_packet.py
    test -x scripts/mcp_registry_packet.py
    test -x scripts/mcp_registry_listing_check.py
    test -x scripts/homebrew_formula.py
    test -x scripts/homebrew_formula_check.py
    test -x scripts/release_provenance.py
    test -x scripts/release_verify.py
    test -x scripts/journal_verify.py
    test -x scripts/journal_anchor_cadence.py
    test -x scripts/release_evidence.py
    test -x scripts/generate_llms_full.py
    test -x scripts/proof_pack.py
    test -x scripts/network_proof_pack.py
    test -x scripts/live_trading_evidence.py
    test -x scripts/release_rehearsal.sh
    test -x scripts/draft_release_rehearsal.sh
    test -x scripts/release_workflow_rehearsal.sh
    test -x scripts/hardening_gate.sh
    test -x scripts/public_readiness_gate.sh
    test -x scripts/railway_start.sh
    test -x scripts/railway_doctor.py
    test -x scripts/deployment_identity_evidence.py
    test -x scripts/network_profile_verify.py
    test -x scripts/deployment_evidence.py
    test -x scripts/deployment_evidence_verify.py
    test -x scripts/deployment_rollback_rehearsal.py
    test -x scripts/deployment_evidence.sh
    test -x scripts/live_canary_rehearsal.py
    test -x scripts/live_canary_verify.py
    test -x scripts/live_canary_exchange_evidence.py
    test -x scripts/live_canary_operator.py
    test -x scripts/live_canary_operator_verify.py
    test -x scripts/live_cockpit_drill.py
    test -x scripts/live_cockpit_drill_verify.py
    test -x scripts/live_cockpit_drill_tamper_rehearsal.py
    test -x scripts/fresh_clone_rehearsal.sh
    test -x scripts/railway_smoke.sh
    test -f Dockerfile
    test -f compose.yaml
    test -f railway.toml
    test -f docs/railway-deploy.md
    python3 scripts/openapi_contract_check.py
    scripts/issue_template_check.py
    scripts/label_taxonomy_check.py
    scripts/github_label_sync.py --validate-config
    scripts/github_launch_issues.py --validate-config
    scripts/contributor_board_check.py
    scripts/codeowners_check.py
    scripts/homebrew_formula_check.py
    PYTHONPATH="$PWD/engine/src" python3 -m zero_engine.mcp --smoke
    PYTHONPATH="$PWD/engine/src" scripts/mcp_transcript.py --check
    scripts/generate_llms_full.py --check
    PYTHONPATH="$PWD/engine/src" scripts/proof_pack.py --check
    PYTHONPATH="$PWD/engine/src" scripts/network_proof_pack.py --check
    scripts/live_trading_evidence.py verify docs/proof/live/live-trading-evidence.json
    PYTHONPATH="$PWD/engine/src" scripts/proof_privacy_regression.py

container-build:
    docker build -t zero-public:local .

container-demo: container-build
    docker run --rm zero-public:local

container-example: container-build
    docker run --rm zero-public:local python /app/examples/paper-trading/run.py

lint: stale-artifact-clean engine-lint cli-lint docs-check public-proof issue-template-check label-taxonomy-check github-label-config-check launch-issue-config-check codeowners-check homebrew-formula-check hardening-gate public-readiness

test: engine-test cli-test

container-smoke:
    docker build -t zero-public:local .
    docker run --rm zero-public:local
    docker run --rm zero-public:local python /app/examples/paper-trading/run.py

ci: lint test paper-api-smoke fresh-clone-rehearsal example strategy-example strategy-plugin-example momentum-strategy-plugin-example strategy-runner-example market-data-adapter-example funding-rate-adapter-example intelligence-catalog-page-example runtime-loop-example memory-core-example genesis-example evolve-example research-example decision-stack-example network-leaderboard-example network-profile-page-example network-stale-profile-example network-empty-profile-example network-leaderboard-page-example network-index-page-example network-pages-smoke intelligence-catalog-page-smoke registry-readiness package-dry-run release-rehearsal draft-release-rehearsal public-readiness