feat: ingest Google Drive projects from inventory policy roots

.project-ledger.json

@@ -0,0 +1,19 @@
+{
+  "project_key": "github.com/mschwar/project-ledger",
+  "display_name": "Project Ledger",
+  "description": "Ledger scanner for mixed project roots across machines and storage surfaces.",
+  "status": "active",
+  "tags": [
+    "ledger",
+    "git",
+    "tooling"
+  ],
+  "canonical_url": "https://github.com/mschwar/project-ledger.git",
+  "repo_name": "project-ledger",
+  "shared": true,
+  "storage_scope": "shared",
+  "last_session_at": "2026-06-03T20:55:55Z",
+  "last_session_summary": "Refreshed the project-ledger scan, regenerated the raw outputs, synced the canonical homelab ledger mirror, and verified the MacBook peer was reachable while matty-pc SSH timed out; inventory-backed roots remained readable.",
+  "next_step": "Keep the scanner synced with new roots, stable identity sidecars, and the homelab ledger mirror.",
+  "last_push_at": ""
+}

README.md

@@ -7,6 +7,7 @@ The scanner is config-driven and emits:
 - `output/projects.csv`
 - `output/projects.json`
 - `output/projects.md`
+- `docs/ledgers/projects-ledger.md` (canonical human-facing ledger mirror)
 
 ## Handoff Docs
 
@@ -52,13 +53,21 @@ python build_ledger.py --config ledger_config.json --output-dir output
 - `children`: inspect each direct child directory and keep the ones that look project-like
 - `git_repos`: recursively find directories that contain `.git`
 - `self`: treat the root itself as one ledger entry
+- `inventory_policy`: read a durable inventory artifact plus a policy file, then promote only the roots marked for ledger ingestion
 
 The default config scans:
 
 - the top-level children of `Documents`
 - nested git repos under `Documents/repos`
 
-Adjust the roots and excludes as needed for other machines, synced folders, or backup dumps.
+Adjust the roots and excludes as needed for other machines, synced folders, backup dumps, or inventory-backed cloud surfaces.
+
+For Google Drive or similar cloud-drive inventories, prefer a policy-backed root instead of recursive mount discovery. Point one root at the mounted folder for operator navigation, but drive candidate selection from:
+- `inventory_jsonl`: durable metadata inventory
+- `policy_path`: root classification policy
+- `policy_crawl_treatments`: usually `["project_discovery"]`
+
+That keeps project-ledger ingestion aligned with the homelab control-plane rule: inventory first, policy second, project promotion third.
 
 If a directory matters but does not have enough obvious signals, add it under `force_include_names` for that root.
 

RUNBOOK.md

@@ -36,6 +36,14 @@ python -m unittest tests\test_build_ledger.py
 5. Add `force_include_names` if important directories are low-signal.
 6. Run the scanner and inspect the Markdown output before trusting the results.
 
+For inventory-backed cloud roots:
+1. Keep `path` pointed at the mounted folder only for operator navigation.
+2. Set `discovery` to `inventory_policy`.
+3. Point `inventory_jsonl` at the durable inventory artifact.
+4. Point `policy_path` at the matching root-policy file.
+5. Restrict `policy_crawl_treatments` to the intended promotion set, usually `project_discovery`.
+6. Verify the resulting entries carry `google-drive:` style project keys and a source label that preserves the policy root.
+
 ## When A Project Is Missing
 
 Check in this order: