{ "checker": { "claims": [ { "claim": "qdbd check validates a schema file", "command": " check --strict examples/quickdbd-sample.txt", "evidence": "No errors found. Good job!\n", "expected": "No errors found", "input": "examples/quickdbd-sample.txt", "kind": "claim", "outcome": "Real input produced the expected result: No errors found", "returncode": 0, "source": "A file that passes `qdbd check --strict` pastes into QuickDBD unchanged.", "source_checked": true, "source_file": "README.md", "verdict": "yes" }, { "claim": "qdbd build writes one self-contained HTML diagram", "command": " build examples/quickdbd-sample.txt -o ", "evidence": "\u20267 tables, 7 relationships)\n", "expected": "writes sample HTML page with 7 tables", "input": "examples/quickdbd-sample.txt", "kind": "claim", "outcome": "Real input produced the expected result: 7 tables, 7 relationships", "returncode": 0, "source": "qdbd build schema.txt -o schema.html", "source_checked": true, "source_file": "README.md", "verdict": "yes" }, { "claim": "qdbd mcp serves schema tables to AI agents", "command": " mcp examples/quickdbd-sample.txt tools/call {\"tool\": \"list_tables\", \"arguments\": {}}", "evidence": "\u2026Customer (as c): 5 columns\\n- Order (as o): 4 columns \u2014 Every order belongs to one customer.\\n- OrderLine: 4 columns\\n- Product Catalog (as cat): 2 columns\\n- Product: 4 columns\\n- Address: 4 columns\\n- Wishlist: 2 columns\"}], \"isError\": false}", "expected": "Customer table listed", "input": "{\"tool\": \"list_tables\", \"arguments\": {}}", "kind": "claim", "outcome": "Real input produced the expected result: Customer", "source": "`qdbd mcp` gives Claude, Copilot and Cursor your schema as tools: tables and columns", "source_checked": true, "source_file": "README.md", "verdict": "yes" } ], "cycle_checks": [ { "claim": "Scheduled or looping main behavior", "command": "", "evidence": "Inspected README.md quickstart and src/quickdbd_cli entrypoints (check, build, share, export, layout, path, diff, import, convert, serve, mcp). No cron, scheduler, --once/--now flag, or webhook exists. The only background loop is serve.py's mtime file watcher, which is an interactive live-reload for the editor, not a scheduled cycle, so no manual cycle was triggered.", "expected": "identify the product trigger", "input": "source inspection", "kind": "cycle", "outcome": "Inspected README.md quickstart and src/quickdbd_cli entrypoints (check, build, share, export, layout, path, diff, import, convert, serve, mcp). No cron, scheduler, --once/--now flag, or webhook exists. The only background loop is serve.py's mtime file watcher, which is an interactive live-reload for the editor, not a scheduled cycle, so no manual cycle was triggered.", "source": "repository entry points", "verdict": "yes" } ], "details": { "argv": [ "", "mcp", "examples/quickdbd-sample.txt" ], "kind": "mcp", "scope": "product operation", "serverInfo": { "name": "qdbd", "version": "0.3.3" }, "tool_result": { "content": [ { "text": "7 table(s) in quickdbd-sample\n- Customer (as c): 5 columns\n- Order (as o): 4 columns \u2014 Every order belongs to one customer.\n- OrderLine: 4 columns\n- Product Catalog (as cat): 2 columns\n- Product: 4 columns\n- Address: 4 columns\n- Wishlist: 2 columns", "type": "text" } ], "isError": false }, "tool_result_checked": true, "tool_schema_bytes": 6982, "tools": [ "list_projects", "list_tables", "describe_tables", "search_schema", "join_path", "check_schema", "diff_schema", "render_diagram", "syntax_reference" ], "working": true }, "evidence_strength": "readme_checked", "example_checks": [ { "claim": "Quickstart step 2: validate the sample schema", "command": " check examples/quickdbd-sample.txt", "deferred": false, "evidence": "No errors found. Good job!", "expected": "No errors found", "input": "examples/quickdbd-sample.txt", "kind": "example", "outcome": "command completed successfully", "returncode": 0, "source": "README.md#quickstart", "verdict": "yes" } ], "status": "PASS" }, "deviations": [ "README suggests pipx/pip/uv; used a venv (README-compatible). Installed PyPI quickdbd-cli first, then replaced it with the pinned local checkout.", "/inputs/coldpass-preflight.py does not exist in the guest; ran the supplied --validate --replay instead.", "No browser used; the README quickstart 'qdbd serve' opens a browser and was not run. No README claim depends on it.", "No product cycle exists (no cron/--once/webhook); cycles.json has detected=false.", "Did not run the repo's pytest suite or the VS Code extension; no offline suite counts as operation evidence." ], "fault_owner": null, "main_blocker": null, "operation": "Install quickdbd-cli per README and run the documented quickstart: qdbd check, qdbd build (HTML diagram), and qdbd mcp serving schema tools over stdio (list_tables call returning the 7 sample tables).", "operation_scope": "Linux guest, Python 3.12.3, venv at , sample schema examples/quickdbd-sample.txt. No browser, GitHub gist, or dbt needed; CDP endpoint responded HTTP 200 but was not used because qdbd build/check/mcp are CLI-only. qdbd serve (browser editor) was not exercised.", "outcome": "working", "plain_failure": null, "steps": [ "curl -s $CDP_URL/json/version (HTTP 200, Chrome/155.0.8059.84)", "python3 3.12.3 satisfies README 'Python 3.11+'", "python3 -m venv && install quickdbd-cli (qdbd 0.3.3)", "git init; git remote add origin https://github.com/MarkPhamm/quickdbd-cli; git fetch --depth 1 origin d39602af4436555c3c2d7a3a95acc65e3d46657c; git reset --mixed FETCH_HEAD", " install (local pinned source, 0.3.3)", "qdbd check examples/quickdbd-sample.txt -> No errors found; qdbd check --strict also passes", "qdbd build examples/quickdbd-sample.txt -o -> Wrote ... (7 tables, 7 relationships)", "qdbd mcp examples/quickdbd-sample.txt, tool list_tables -> 7 tables incl. Customer" ], "stuck_step": null, "suggested_fix": "None required for the verified operations." }