docs(import): folder import, sparse records and per-file views (improvise-lpzu, improvise-8jk6.2)

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VdfEGXA7aJ6ftMsCc9PJze
2026-09-24 20:58:58 -07:00
parent 736e9e5e18
commit ee0ff83a58
5 changed files with 335 additions and 12 deletions
@@ -178,7 +178,14 @@ opening one fails with an error that says so. JSON *import* is unaffected.
 The import wizard analyzes CSV columns and proposes each as a category
 (string-valued), measure (numeric), time dimension (date-like, with optional
 year/month/quarter extraction), or skip. Multiple CSVs merge automatically
-with a synthetic "File" category.
+with a synthetic "File" category, even when their headers differ. A record
+simply has no value for a column its file lacks. A folder argument imports
+every `*.csv` in it, in name order, and each merged file also gets its own view,
+filtered to that file and showing only its columns:
+
+```sh
+improvise import reports/ --no-wizard -o reports.improv
+```

 All model mutations go through a typed command registry, so the same
 operations that back the TUI work headless: