{
  "checker": {
    "details": {
      "checks": [
        {
          "check": "install",
          "details": {
            "argv": [
              "<host-path>",
              "--help"
            ],
            "kind": "cli",
            "needs_browser": false,
            "needs_credentials": false,
            "returncode": 0,
            "scope": "partial: install",
            "stderr": "",
            "stdout": "usage: shan-fin [-h] {cli,tkinter} ...\n\nPersonal Finance Quant Engine\n\npositional arguments:\n  {cli,tkinter}  Frontend to launch\n    cli          Launch the terminal CLI\n    tkinter      Launch the Desktop GUI\n\noptions:\n  -h, --help     show this help message and exit",
            "working": false
          },
          "optional": false,
          "status": "PASS"
        },
        {
          "check": "start",
          "details": {
            "argv": [
              "<host-path>",
              "cli",
              "--help"
            ],
            "blocker": "wrong subcommand or usage-only response: {\"returncode\": 0, \"stdout\": \"usage: shan-fin cli [-h] [--config CONFIG] [--rules RULES] [--snapshot]\\n                    [--restore RESTORE] [--auto] [--cron] [--docs]\\n\\noptions:\\n  -h, --help         show this help message and exit\\n  --config CONFIG    Path to config.toml\\n  --rules RULES      Path to rules.toml\\n  --snapshot         Snapshot the DuckDB database instead of running ETL\\n  --restore RESTORE  Path to backup zip file to restore (requires --config)\\n  --auto             Bypass confirmation prompts and automatically start the\\n                     pipeline\\n  --cron             Run completely unattended and exit immediately after\\n                     completion (implies --auto)\\n  --docs             Open the documentation and guides window, then exit\\n\", \"stderr\": \"\", \"needs_credentials\": false, \"needs_browser\": false}",
            "kind": "cli",
            "needs_browser": false,
            "needs_credentials": false,
            "returncode": 0,
            "stderr": "",
            "stdout": "usage: shan-fin cli [-h] [--config CONFIG] [--rules RULES] [--snapshot]\n                    [--restore RESTORE] [--auto] [--cron] [--docs]\n\noptions:\n  -h, --help         show this help message and exit\n  --config CONFIG    Path to config.toml\n  --rules RULES      Path to rules.toml\n  --snapshot         Snapshot the DuckDB database instead of running ETL\n  --restore RESTORE  Path to backup zip file to restore (requires --config)\n  --auto             Bypass confirmation prompts and automatically start the\n                     pipeline\n  --cron             Run completely unattended and exit immediately after\n[excerpt truncated]",
            "working": false
          },
          "optional": false,
          "status": "FAIL"
        }
      ],
      "scope": "partial checks",
      "working": false
    },
    "status": "FAIL"
  },
  "deviations": [
    "README 'Install' says `pip install personal-finance-etl`; used the repo checkout with `uv sync` per docs/getting-started/installation.md instead. Guest python3 is 3.12.3, project requires >=3.13, so uv supplied 3.13.",
    "`shan-fin cli --docs` and `shan-fin` desktop need Qt or GTK for pywebview/tkinter, not installed; not installed here (no browser/GUI installs attempted).",
    "Full ETL run not executed: no user financial inputs available."
  ],
  "main_blocker": "No personal financial source data, config, or rules file in the guest; the ETL cannot validate.",
  "operation": "Installed the package with `uv sync` and ran `shan-fin --help` and `shan-fin cli --help` (install + start). The documented ETL run (`shan-fin cli --config ... --rules ... --auto`) was attempted and fails at config validation because the user's personal source data is absent.",
  "operation_scope": "Install and CLI launch verified. The ETL run needs user-owned inputs: config.toml, financial rules TOML, source DB folder, statements folder, and 7 reference CSVs (column master, MF ISIN mapping, benchmark mapping, benchmark master, macro parameters, opening balances, currency mapping). None exist in the VM. Desktop launch needs a GUI (Qt/GTK) that is not present.",
  "outcome": "blocked",
  "steps": [
    "curl -LsSf https://astral.sh/uv/install.sh | sh (uv 0.13.1; README Install section uses pip, docs/getting-started/installation.md recommends uv sync)",
    "uv sync (Python 3.13 managed by uv, 0 exit)",
    "<host-path> --help",
    "<host-path> cli --help",
    "shan-fin cli --config /nonexistent/config.toml --rules /nonexistent/rules.toml --auto (fails: 'Critical Pipeline Failure: Financial rules config not found')"
  ],
  "stuck_step": "Quick Start step 1-4: running the pipeline requires user-owned config.toml, financial_rules.toml and source data files.",
  "suggested_fix": "Provide SOURCE_DB_FOLDER, STATEMENTS_FOLDER, the seven reference CSVs and a financial rules TOML, then run `.venv/bin/shan-fin cli --config <config.toml> --rules <rules.toml> --auto` (or `--cron`). For a GUI-free probe, the checker can use the install/start checks in probe.json."
}