hiiro 0.1.306 → 0.1.308.pre.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9c183cf3e7fe7b583062f06764f09217bf361884d993bf9e50ce57ea8244a82e
-  data.tar.gz: d93c261665ed81c3dcfee23fd3fe885b2ed5e8b980a23075486b1d9de35cfe11
+  metadata.gz: 5133c5b05e6f2040b092c49a8ff75a1e665f9506d5a6b7afc9078dcd9c3d20a2
+  data.tar.gz: bea25caa37de50a810b76b72b8eebe5eb1fd37141542aaea21da1932e3dbae9d
 SHA512:
-  metadata.gz: f64a5fb53855bb8968b48598224ad5b6a11ec18f64a6985141b8fb547a54aad9be36ed4b64c6f815eb7d5fbfdcda7d57f168d9754840f06632e2b9343a5f2b50
-  data.tar.gz: 85f1544552f1137f8222ae2fe8bbf48c61a79838f76352743ad367941175216ee9945f2b55cd2007c5ad58045a165d978d7cdbf1c79d090d104ff5f9f4090a7d
+  metadata.gz: 321291e9a574a533d3647c7c4a54040fdbf993c174923958a4d1fdb7936bee373c838c689ca10fb50b48940d4a9aefc662c4a72714442271c7180eccf82d748f
+  data.tar.gz: 15d46bd5f44affa4fb6418f6f76e61cef848a4ade2a975cba450825aeb730da8362fbc0a885241bad31bae4969f752063de95d9143ab72127576850cf3c4e804

data/CHANGELOG.md

@@ -1,6 +1,57 @@
 ```markdown
 # Changelog
 
+## [0.1.308.pre.1] - 2026-03-31
+
+### Added
+- `Hiiro::Effects` injectable interface for testable file system and command execution
+- `null_fs` to `TestHarness` for testing without side effects
+- Effects helpers and accessors to `TestHarness` for controlled effect simulation
+- `Hiiro::Invocation` and `Hiiro::InvocationResolution` tracking in PaneHome SQLite migration
+
+### Changed
+- Refactor effects layer: expose `executor` and `fs` as accessors on `Hiiro::Effects`
+- `h-db` command now includes h-pane in SQLite migration
+- Gem version handling: treat non-main branches as pre-release in publish script
+
+### Fixed
+- `h-branch co` and `h-branch rm` restore extra argument pass-through
+- Test suite: add missing `TestHarness` stubs and fix pre-existing test failures
+- Test fixtures: anchor `load_bin` path to project root instead of `Dir.pwd`
+
+### Deprecated
+- `SystemCallCapture` — use `Hiiro::Effects` helpers in `TestHarness` instead
+
+## [Unreleased]
+
+### Added
+- `Hiiro::DB` — SQLite foundation via Sequel; `DB.setup!` creates all tables, `DB.connection` establishes connection eagerly at load time; supports `HIIRO_TEST_DB=sqlite::memory:` for tests
+- `lib/hiiro/db.rb` — one-time YAML→SQLite migration (`migrate_yaml!`) guarded by `schema_migrations` table; dual-write mode (`dual_write?` / `disable_dual_write!`) for gradual cutover
+- `lib/hiiro/branch.rb` — `Hiiro::Branch` Sequel model for worktree branch records
+- `lib/hiiro/tracked_pr.rb` — `Hiiro::TrackedPr` Sequel model for tracked PR records (`:prs` table)
+- `lib/hiiro/link.rb` — `Hiiro::Link` Sequel model with `matches?`, `display_string`, `to_h` helpers
+- `lib/hiiro/project.rb` — `Hiiro::Project` Sequel model
+- `lib/hiiro/pane_home.rb` — `Hiiro::PaneHome` Sequel model with `data_json` JSON blob
+- `lib/hiiro/pin_record.rb` — `Hiiro::PinRecord` Sequel model for per-command key-value pin storage
+- `lib/hiiro/task_record.rb` — `Hiiro::TaskRecord` Sequel model for task metadata
+- `lib/hiiro/app_record.rb` — `Hiiro::AppRecord` Sequel model for app directory mappings
+- `lib/hiiro/assignment.rb` — `Hiiro::Assignment` Sequel model for worktree→branch assignments
+- `lib/hiiro/reminder.rb` — `Hiiro::Reminder` Sequel model
+- `lib/hiiro/invocation.rb` — `Hiiro::Invocation` and `Hiiro::InvocationResolution` Sequel models; every CLI invocation is recorded to SQLite for history/analytics
+- `bin/h-db` — new subcommand: `h db status`, `h db tables`, `h db q <sql>`, `h db migrate`, `h db restore`
+
+### Changed
+- `lib/hiiro/todo.rb` — `TodoItem` is now a `Sequel::Model`; `TodoManager` reads/writes via SQLite with YAML dual-write fallback
+- `lib/hiiro/tags.rb` — `Tag` is now a `Sequel::Model`; tag operations persist to SQLite with YAML dual-write fallback
+- `lib/hiiro/pinned_pr_manager.rb` — `PinnedPR` is now a `Sequel::Model` (`lib/hiiro/pinned_pr.rb`); `PinnedPRManager` reads/writes via SQLite with YAML dual-write
+- `lib/hiiro/projects.rb` — `Projects#from_config` reads from `Hiiro::Project` SQLite model with YAML fallback
+- `lib/hiiro/tasks.rb` — `TaskManager::Config` reads/writes tasks and apps via `Hiiro::TaskRecord` and `Hiiro::AppRecord` SQLite models
+- `bin/h-branch` — `BranchManager` reads/writes via `Hiiro::Branch` and `Hiiro::TrackedPr` SQLite models with YAML dual-write fallback; adds `q`/`query` subcommands for raw SQL inspection
+- `bin/h-link` — reads/writes links via `Hiiro::Link` SQLite model with YAML dual-write fallback; adds `q`/`query` subcommands
+- `bin/h-pane` — load/save pane homes via `Hiiro::PaneHome` model with YAML dual-write
+- `bin/h-pr` — adds `q`/`query` subcommands for inspecting PR records via raw SQL
+- `plugins/pins.rb` — `Pin` class reads/writes via `Hiiro::PinRecord` SQLite model with YAML dual-write fallback
+
 ## [0.1.306] - 2026-03-30
 
 ### Changed

data/CLAUDE.md

@@ -221,6 +221,38 @@ git.move_worktree(from, to)       # Rename worktree
 git.current_pr                    # Get current PR info
 ```
 
+### Hiiro::DB (lib/hiiro/db.rb)
+
+SQLite persistence layer backed by Sequel. All data is stored in `~/.config/hiiro/hiiro.db`.
+
+**Setup:** `Hiiro::DB.setup!` is called at startup — creates any missing tables, then runs a one-time YAML→SQLite migration if the DB is new.
+
+**Model registration:** Each Sequel model calls `Hiiro::DB.register(self)` so `setup!` can create its table:
+
+```ruby
+class Hiiro::MyModel < Sequel::Model(:my_table)
+  Hiiro::DB.register(self)
+
+  def self.create_table!(db)
+    db.create_table?(:my_table) do
+      primary_key :id
+      String :name, null: false
+    end
+  end
+end
+```
+
+**Dual-write:** During rollout, models write to both SQLite and YAML. Once migration is stable, call `Hiiro::DB.disable_dual_write!` to stop YAML writes.
+
+**Test isolation:** Set `ENV['HIIRO_TEST_DB'] = 'sqlite::memory:'` before requiring `hiiro` to get a clean in-memory DB per test run. Call `Hiiro::DB.setup!` after require.
+
+**`h db` subcommand:** Inspect and manage the database:
+- `h db status` — show connection info and migration state
+- `h db tables` — list all tables with row counts
+- `h db q <sql>` — run raw SQL and print results
+- `h db migrate` — re-run YAML import (if not yet migrated)
+- `h db restore` — restore YAML files from SQLite data
+
 ### Hiiro::Fuzzyfind (lib/hiiro/fuzzyfind.rb)
 
 Integration with `sk` (skim) or `fzf` fuzzy finders:
@@ -246,6 +278,26 @@ tm.active                         # Items not done/skipped
 tm.filter_by_task("feature")      # Items for specific task
 ```
 
+### Invocation Tracking (lib/hiiro/invocation.rb)
+
+Every CLI invocation is automatically recorded to SQLite via `Hiiro::Invocation` and `Hiiro::InvocationResolution`. This happens in `Hiiro.init` — no extra setup needed.
+
+**Schema:**
+- `Hiiro::Invocation` — records `bin_name`, `argv_json`, `cwd`, `invoked_at`
+- `Hiiro::InvocationResolution` — linked to an invocation; records `resolved_name`, `resolution_type` (exact/prefix/abbreviated), `subcmd`
+
+**Query recent invocations:**
+```ruby
+Hiiro::Invocation.order(Sequel.desc(:invoked_at)).limit(20).each do |inv|
+  puts "#{inv.invoked_at}  #{inv.bin_name} #{JSON.parse(inv.argv_json).join(' ')}"
+end
+```
+
+Or via `h db q`:
+```bash
+h db q "SELECT bin_name, argv_json, invoked_at FROM invocations ORDER BY invoked_at DESC LIMIT 10"
+```
+
 ### Hiiro::Shell (lib/hiiro/shell.rb)
 
 Utility for piping content to external commands: