mirror of
https://github.com/fabro-sh/fabro.git
synced 2026-09-11 22:53:00 +00:00
Fabro
parent
11abb2e288
commit
90529dc91d
4 changed files with 58 additions and 29 deletions
|
|
@ -1,43 +1,37 @@
|
|||
{
|
||||
"timestamp": "2026-04-01T13:08:48.924178Z",
|
||||
"current_node": "preflight_compile",
|
||||
"timestamp": "2026-04-01T13:09:09.324266Z",
|
||||
"current_node": "preflight_lint",
|
||||
"completed_nodes": [
|
||||
"start",
|
||||
"toolchain",
|
||||
"preflight_compile"
|
||||
"preflight_compile",
|
||||
"preflight_lint"
|
||||
],
|
||||
"node_retries": {},
|
||||
"context_values": {
|
||||
"graph.model_stylesheet": "\n * { model: claude-opus-4-6; }\n ",
|
||||
"internal.retry_count.toolchain": 0,
|
||||
"graph.goal": "# Add storage directory check to `fabro doctor`\n\n## Context\n\n`fabro doctor` validates the installation but doesn't check that the storage directory (where runs, store data, etc. live) exists and is usable. Adding this check surfaces misconfiguration early — e.g. a `storage_dir` override pointing to a nonexistent or read-only path.\n\n## Plan\n\n### 1. Add `check_storage_dir` pure function in `doctor.rs`\n\n**File:** `lib/crates/fabro-cli/src/commands/doctor.rs`\n\nAdd a function like the existing `check_config`:\n\n```rust\nfn check_storage_dir(path: &Path, readable: bool, writable: bool) -> CheckResult\n```\n\n- **Summary always shows the resolved path** (e.g. `/Users/you/.fabro`) — same pattern as `check_config` which puts the path in `summary`.\n- **Pass** — dir exists, readable, writable.\n- **Error** — dir doesn't exist, or not readable, or not writable. Remediation: create it or fix permissions.\n- Details (verbose): existence, read, write status as individual lines.\n\n### 2. Gather state in `run_doctor`\n\nBefore the pure-checks section, resolve the storage dir and probe it:\n\n```rust\nlet storage_dir = cli_settings.storage_dir();\nlet exists = storage_dir.is_dir();\nlet readable = std::fs::read_dir(&storage_dir).is_ok();\nlet writable = tempfile::tempfile_in(&storage_dir).is_ok(); // or write+remove a temp file\n```\n\nUse `std::fs` directly — no async/live probe needed for local filesystem checks.\n\n### 3. Add to \"Required\" section\n\nInsert `check_storage_dir` result into the \"Required\" section, after the \"Configuration\" check and before \"LLM providers\" — storage is fundamental.\n\n### 4. Add unit tests\n\nFollow the existing test pattern (pure function tests with synthetic inputs). Cover:\n- Dir exists + readable + writable → Pass\n- Dir doesn't exist → Error\n- Dir exists but not writable → Error\n\nUse a `tempdir` for real filesystem assertions in a couple of tests.\n\n### 5. Add integration tests in `it/cmd/doctor.rs`\n\n**File:** `lib/crates/fabro-cli/tests/it/cmd/doctor.rs` (existing, has 4 tests)\n\nAdd 2 tests using the existing `test_context!()` + `fabro_snapshot!` pattern:\n\n- **`storage_dir_shown_in_output`** — `TestContext` already creates a temp `storage_dir` and sets `FABRO_STORAGE_DIR`. Run `doctor --dry-run`, snapshot-assert that \"Storage directory\" line appears with the path in the summary.\n- **`storage_dir_missing_shows_error`** — Override `FABRO_STORAGE_DIR` to a nonexistent path via `.env(\"FABRO_STORAGE_DIR\", \"/tmp/nonexistent-fabro-xyz\")`. Run `doctor --dry-run`, snapshot-assert that the check shows error status with the path and remediation text.\n\nBoth tests use `--dry-run` to skip live probes and `fabro_snapshot!` for inline snapshot assertions. Add a filter to normalize the temp dir path (e.g. `[STORAGE_DIR]`).\n\n## Files to modify\n\n- `lib/crates/fabro-cli/src/commands/doctor.rs` — new check function + gather state + wire into section + unit tests\n- `lib/crates/fabro-cli/tests/it/cmd/doctor.rs` — 2 new integration tests\n\n## Verification\n\n- `cargo nextest run -p fabro-cli -- doctor` — unit + integration tests pass\n- `cargo clippy --workspace -- -D warnings` — no lint issues\n- `fabro doctor` — shows new \"Storage directory\" check with the resolved path\n- `fabro doctor -v` — shows detail lines for existence/read/write\n- `FABRO_STORAGE_DIR=/nonexistent fabro doctor` — shows error for missing dir\n",
|
||||
"internal.retry_count.start": 0,
|
||||
"failure_class": "",
|
||||
"internal.retry_count.preflight_compile": 0,
|
||||
"command.stderr": "",
|
||||
"thread.toolchain.current_node": "preflight_compile",
|
||||
"command.output": "",
|
||||
"failure_signature": "",
|
||||
"current_node": "preflight_compile",
|
||||
"current.preamble": "Goal: # Add storage directory check to `fabro doctor`\n\n## Context\n\n`fabro doctor` validates the installation but doesn't check that the storage directory (where runs, store data, etc. live) exists and is usable. Adding this check surfaces misconfiguration early — e.g. a `storage_dir` override pointing to a nonexistent or read-only path.\n\n## Plan\n\n### 1. Add `check_storage_dir` pure function in `doctor.rs`\n\n**File:** `lib/crates/fabro-cli/src/commands/doctor.rs`\n\nAdd a function like the existing `check_config`:\n\n```rust\nfn check_storage_dir(path: &Path, readable: bool, writable: bool) -> CheckResult\n```\n\n- **Summary always shows the resolved path** (e.g. `/Users/you/.fabro`) — same pattern as `check_config` which puts the path in `summary`.\n- **Pass** — dir exists, readable, writable.\n- **Error** — dir doesn't exist, or not readable, or not writable. Remediation: create it or fix permissions.\n- Details (verbose): existence, read, write status as individual lines.\n\n### 2. Gather state in `run_doctor`\n\nBefore the pure-checks section, resolve the storage dir and probe it:\n\n```rust\nlet storage_dir = cli_settings.storage_dir();\nlet exists = storage_dir.is_dir();\nlet readable = std::fs::read_dir(&storage_dir).is_ok();\nlet writable = tempfile::tempfile_in(&storage_dir).is_ok(); // or write+remove a temp file\n```\n\nUse `std::fs` directly — no async/live probe needed for local filesystem checks.\n\n### 3. Add to \"Required\" section\n\nInsert `check_storage_dir` result into the \"Required\" section, after the \"Configuration\" check and before \"LLM providers\" — storage is fundamental.\n\n### 4. Add unit tests\n\nFollow the existing test pattern (pure function tests with synthetic inputs). Cover:\n- Dir exists + readable + writable → Pass\n- Dir doesn't exist → Error\n- Dir exists but not writable → Error\n\nUse a `tempdir` for real filesystem assertions in a couple of tests.\n\n### 5. Add integration tests in `it/cmd/doctor.rs`\n\n**File:** `lib/crates/fabro-cli/tests/it/cmd/doctor.rs` (existing, has 4 tests)\n\nAdd 2 tests using the existing `test_context!()` + `fabro_snapshot!` pattern:\n\n- **`storage_dir_shown_in_output`** — `TestContext` already creates a temp `storage_dir` and sets `FABRO_STORAGE_DIR`. Run `doctor --dry-run`, snapshot-assert that \"Storage directory\" line appears with the path in the summary.\n- **`storage_dir_missing_shows_error`** — Override `FABRO_STORAGE_DIR` to a nonexistent path via `.env(\"FABRO_STORAGE_DIR\", \"/tmp/nonexistent-fabro-xyz\")`. Run `doctor --dry-run`, snapshot-assert that the check shows error status with the path and remediation text.\n\nBoth tests use `--dry-run` to skip live probes and `fabro_snapshot!` for inline snapshot assertions. Add a filter to normalize the temp dir path (e.g. `[STORAGE_DIR]`).\n\n## Files to modify\n\n- `lib/crates/fabro-cli/src/commands/doctor.rs` — new check function + gather state + wire into section + unit tests\n- `lib/crates/fabro-cli/tests/it/cmd/doctor.rs` — 2 new integration tests\n\n## Verification\n\n- `cargo nextest run -p fabro-cli -- doctor` — unit + integration tests pass\n- `cargo clippy --workspace -- -D warnings` — no lint issues\n- `fabro doctor` — shows new \"Storage directory\" check with the resolved path\n- `fabro doctor -v` — shows detail lines for existence/read/write\n- `FABRO_STORAGE_DIR=/nonexistent fabro doctor` — shows error for missing dir\n\n\n## Completed stages\n- **toolchain**: success\n - Script: `command -v cargo >/dev/null || { curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y && sudo ln -sf $HOME/.cargo/bin/* /usr/local/bin/; }; cargo --version 2>&1`\n - Stdout:\n ```\n cargo 1.94.0 (85eff7c80 2026-01-15)\n ```\n - Stderr: (empty)\n",
|
||||
"internal.retry_count.preflight_lint": 0,
|
||||
"internal.retry_count.toolchain": 0,
|
||||
"graph.model_stylesheet": "\n * { model: claude-opus-4-6; }\n ",
|
||||
"graph.goal": "# Add storage directory check to `fabro doctor`\n\n## Context\n\n`fabro doctor` validates the installation but doesn't check that the storage directory (where runs, store data, etc. live) exists and is usable. Adding this check surfaces misconfiguration early — e.g. a `storage_dir` override pointing to a nonexistent or read-only path.\n\n## Plan\n\n### 1. Add `check_storage_dir` pure function in `doctor.rs`\n\n**File:** `lib/crates/fabro-cli/src/commands/doctor.rs`\n\nAdd a function like the existing `check_config`:\n\n```rust\nfn check_storage_dir(path: &Path, readable: bool, writable: bool) -> CheckResult\n```\n\n- **Summary always shows the resolved path** (e.g. `/Users/you/.fabro`) — same pattern as `check_config` which puts the path in `summary`.\n- **Pass** — dir exists, readable, writable.\n- **Error** — dir doesn't exist, or not readable, or not writable. Remediation: create it or fix permissions.\n- Details (verbose): existence, read, write status as individual lines.\n\n### 2. Gather state in `run_doctor`\n\nBefore the pure-checks section, resolve the storage dir and probe it:\n\n```rust\nlet storage_dir = cli_settings.storage_dir();\nlet exists = storage_dir.is_dir();\nlet readable = std::fs::read_dir(&storage_dir).is_ok();\nlet writable = tempfile::tempfile_in(&storage_dir).is_ok(); // or write+remove a temp file\n```\n\nUse `std::fs` directly — no async/live probe needed for local filesystem checks.\n\n### 3. Add to \"Required\" section\n\nInsert `check_storage_dir` result into the \"Required\" section, after the \"Configuration\" check and before \"LLM providers\" — storage is fundamental.\n\n### 4. Add unit tests\n\nFollow the existing test pattern (pure function tests with synthetic inputs). Cover:\n- Dir exists + readable + writable → Pass\n- Dir doesn't exist → Error\n- Dir exists but not writable → Error\n\nUse a `tempdir` for real filesystem assertions in a couple of tests.\n\n### 5. Add integration tests in `it/cmd/doctor.rs`\n\n**File:** `lib/crates/fabro-cli/tests/it/cmd/doctor.rs` (existing, has 4 tests)\n\nAdd 2 tests using the existing `test_context!()` + `fabro_snapshot!` pattern:\n\n- **`storage_dir_shown_in_output`** — `TestContext` already creates a temp `storage_dir` and sets `FABRO_STORAGE_DIR`. Run `doctor --dry-run`, snapshot-assert that \"Storage directory\" line appears with the path in the summary.\n- **`storage_dir_missing_shows_error`** — Override `FABRO_STORAGE_DIR` to a nonexistent path via `.env(\"FABRO_STORAGE_DIR\", \"/tmp/nonexistent-fabro-xyz\")`. Run `doctor --dry-run`, snapshot-assert that the check shows error status with the path and remediation text.\n\nBoth tests use `--dry-run` to skip live probes and `fabro_snapshot!` for inline snapshot assertions. Add a filter to normalize the temp dir path (e.g. `[STORAGE_DIR]`).\n\n## Files to modify\n\n- `lib/crates/fabro-cli/src/commands/doctor.rs` — new check function + gather state + wire into section + unit tests\n- `lib/crates/fabro-cli/tests/it/cmd/doctor.rs` — 2 new integration tests\n\n## Verification\n\n- `cargo nextest run -p fabro-cli -- doctor` — unit + integration tests pass\n- `cargo clippy --workspace -- -D warnings` — no lint issues\n- `fabro doctor` — shows new \"Storage directory\" check with the resolved path\n- `fabro doctor -v` — shows detail lines for existence/read/write\n- `FABRO_STORAGE_DIR=/nonexistent fabro doctor` — shows error for missing dir\n",
|
||||
"failure_class": "",
|
||||
"internal.node_visit_count": 1,
|
||||
"internal.thread_id": "preflight_compile",
|
||||
"outcome": "success",
|
||||
"graph.rankdir": "LR",
|
||||
"thread.start.current_node": "toolchain",
|
||||
"internal.run_id": "01KN4JD6GJTC3PHC8G80EA950B",
|
||||
"thread.preflight_compile.current_node": "preflight_lint",
|
||||
"internal.fidelity": "compact",
|
||||
"internal.thread_id": "toolchain"
|
||||
"internal.retry_count.start": 0,
|
||||
"current.preamble": "Goal: # Add storage directory check to `fabro doctor`\n\n## Context\n\n`fabro doctor` validates the installation but doesn't check that the storage directory (where runs, store data, etc. live) exists and is usable. Adding this check surfaces misconfiguration early — e.g. a `storage_dir` override pointing to a nonexistent or read-only path.\n\n## Plan\n\n### 1. Add `check_storage_dir` pure function in `doctor.rs`\n\n**File:** `lib/crates/fabro-cli/src/commands/doctor.rs`\n\nAdd a function like the existing `check_config`:\n\n```rust\nfn check_storage_dir(path: &Path, readable: bool, writable: bool) -> CheckResult\n```\n\n- **Summary always shows the resolved path** (e.g. `/Users/you/.fabro`) — same pattern as `check_config` which puts the path in `summary`.\n- **Pass** — dir exists, readable, writable.\n- **Error** — dir doesn't exist, or not readable, or not writable. Remediation: create it or fix permissions.\n- Details (verbose): existence, read, write status as individual lines.\n\n### 2. Gather state in `run_doctor`\n\nBefore the pure-checks section, resolve the storage dir and probe it:\n\n```rust\nlet storage_dir = cli_settings.storage_dir();\nlet exists = storage_dir.is_dir();\nlet readable = std::fs::read_dir(&storage_dir).is_ok();\nlet writable = tempfile::tempfile_in(&storage_dir).is_ok(); // or write+remove a temp file\n```\n\nUse `std::fs` directly — no async/live probe needed for local filesystem checks.\n\n### 3. Add to \"Required\" section\n\nInsert `check_storage_dir` result into the \"Required\" section, after the \"Configuration\" check and before \"LLM providers\" — storage is fundamental.\n\n### 4. Add unit tests\n\nFollow the existing test pattern (pure function tests with synthetic inputs). Cover:\n- Dir exists + readable + writable → Pass\n- Dir doesn't exist → Error\n- Dir exists but not writable → Error\n\nUse a `tempdir` for real filesystem assertions in a couple of tests.\n\n### 5. Add integration tests in `it/cmd/doctor.rs`\n\n**File:** `lib/crates/fabro-cli/tests/it/cmd/doctor.rs` (existing, has 4 tests)\n\nAdd 2 tests using the existing `test_context!()` + `fabro_snapshot!` pattern:\n\n- **`storage_dir_shown_in_output`** — `TestContext` already creates a temp `storage_dir` and sets `FABRO_STORAGE_DIR`. Run `doctor --dry-run`, snapshot-assert that \"Storage directory\" line appears with the path in the summary.\n- **`storage_dir_missing_shows_error`** — Override `FABRO_STORAGE_DIR` to a nonexistent path via `.env(\"FABRO_STORAGE_DIR\", \"/tmp/nonexistent-fabro-xyz\")`. Run `doctor --dry-run`, snapshot-assert that the check shows error status with the path and remediation text.\n\nBoth tests use `--dry-run` to skip live probes and `fabro_snapshot!` for inline snapshot assertions. Add a filter to normalize the temp dir path (e.g. `[STORAGE_DIR]`).\n\n## Files to modify\n\n- `lib/crates/fabro-cli/src/commands/doctor.rs` — new check function + gather state + wire into section + unit tests\n- `lib/crates/fabro-cli/tests/it/cmd/doctor.rs` — 2 new integration tests\n\n## Verification\n\n- `cargo nextest run -p fabro-cli -- doctor` — unit + integration tests pass\n- `cargo clippy --workspace -- -D warnings` — no lint issues\n- `fabro doctor` — shows new \"Storage directory\" check with the resolved path\n- `fabro doctor -v` — shows detail lines for existence/read/write\n- `FABRO_STORAGE_DIR=/nonexistent fabro doctor` — shows error for missing dir\n\n\n## Completed stages\n- **toolchain**: success\n - Script: `command -v cargo >/dev/null || { curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y && sudo ln -sf $HOME/.cargo/bin/* /usr/local/bin/; }; cargo --version 2>&1`\n - Stdout:\n ```\n cargo 1.94.0 (85eff7c80 2026-01-15)\n ```\n - Stderr: (empty)\n- **preflight_compile**: success\n - Script: `cargo check -q --workspace 2>&1`\n - Stdout: (empty)\n - Stderr: (empty)\n",
|
||||
"failure_signature": "",
|
||||
"thread.toolchain.current_node": "preflight_compile",
|
||||
"graph.rankdir": "LR",
|
||||
"current_node": "preflight_lint",
|
||||
"command.output": "",
|
||||
"internal.retry_count.preflight_compile": 0,
|
||||
"internal.run_id": "01KN4JD6GJTC3PHC8G80EA950B"
|
||||
},
|
||||
"node_outcomes": {
|
||||
"toolchain": {
|
||||
"status": "success",
|
||||
"context_updates": {
|
||||
"command.output": "cargo 1.94.0 (85eff7c80 2026-01-15)\n",
|
||||
"command.stderr": ""
|
||||
},
|
||||
"notes": "Script completed: command -v cargo >/dev/null || { curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y && sudo ln -sf $HOME/.cargo/bin/* /usr/local/bin/; }; cargo --version 2>&1",
|
||||
"usage": null
|
||||
},
|
||||
"preflight_compile": {
|
||||
"status": "success",
|
||||
"context_updates": {
|
||||
|
|
@ -47,15 +41,34 @@
|
|||
"notes": "Script completed: cargo check -q --workspace 2>&1",
|
||||
"usage": null
|
||||
},
|
||||
"toolchain": {
|
||||
"status": "success",
|
||||
"context_updates": {
|
||||
"command.stderr": "",
|
||||
"command.output": "cargo 1.94.0 (85eff7c80 2026-01-15)\n"
|
||||
},
|
||||
"notes": "Script completed: command -v cargo >/dev/null || { curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y && sudo ln -sf $HOME/.cargo/bin/* /usr/local/bin/; }; cargo --version 2>&1",
|
||||
"usage": null
|
||||
},
|
||||
"start": {
|
||||
"status": "success",
|
||||
"usage": null
|
||||
},
|
||||
"preflight_lint": {
|
||||
"status": "success",
|
||||
"context_updates": {
|
||||
"command.stderr": "",
|
||||
"command.output": ""
|
||||
},
|
||||
"notes": "Script completed: cargo clippy -q --workspace -- -D warnings 2>&1",
|
||||
"usage": null
|
||||
}
|
||||
},
|
||||
"next_node_id": "preflight_lint",
|
||||
"next_node_id": "implement",
|
||||
"node_visits": {
|
||||
"toolchain": 1,
|
||||
"preflight_compile": 1,
|
||||
"start": 1,
|
||||
"preflight_compile": 1
|
||||
"preflight_lint": 1,
|
||||
"toolchain": 1
|
||||
}
|
||||
}
|
||||
5
nodes/preflight_lint/script_invocation.json
Normal file
5
nodes/preflight_lint/script_invocation.json
Normal file
|
|
@ -0,0 +1,5 @@
|
|||
{
|
||||
"command": "cargo clippy -q --workspace -- -D warnings 2>&1",
|
||||
"language": "shell",
|
||||
"timeout_ms": null
|
||||
}
|
||||
5
nodes/preflight_lint/script_timing.json
Normal file
5
nodes/preflight_lint/script_timing.json
Normal file
|
|
@ -0,0 +1,5 @@
|
|||
{
|
||||
"duration_ms": 17441,
|
||||
"exit_code": 0,
|
||||
"timed_out": false
|
||||
}
|
||||
6
nodes/preflight_lint/status.json
Normal file
6
nodes/preflight_lint/status.json
Normal file
|
|
@ -0,0 +1,6 @@
|
|||
{
|
||||
"status": "success",
|
||||
"notes": "Script completed: cargo clippy -q --workspace -- -D warnings 2>&1",
|
||||
"failure_reason": null,
|
||||
"timestamp": "2026-04-01T13:09:09.317777Z"
|
||||
}
|
||||
Loading…
Add table
Reference in a new issue