@aladac/hu 0.1.0-a1

package/plans/velvety-enchanting-ocean.md

@@ -0,0 +1,92 @@
+# Plan: Remove Multi-Model/Ensemble Feature from Extraction
+
+## Summary
+Remove the multi-model ensemble feature from the extraction system. Testing showed single `minicpm-v:8b` outperforms all ensemble combinations. The `--model` flag remains for selecting which single model to use.
+
+## Files to Modify
+
+### 1. `src/prompts/extract/extractor.py`
+
+**Remove:**
+- `MODEL_PRESETS` dict (lines 20-26)
+- `SYNTHESIS_PROMPT` constant (lines 28-48)
+- `synthesis_model` parameter from `Extractor.__init__`
+- `models`, `num_models`, `preset` parameters from `Extractor.__init__`
+- `self._models` instance variable logic for multi-model
+- `_synthesize()` method (lines 290-328)
+- Multi-model loop/synthesis branches in extraction methods
+
+**Keep:**
+- `ModelResult` dataclass (used for error tracking even with single model)
+- `model_results` field in `ExtractionResult`/`SceneResult` (simplify to single result)
+- `_get_models_to_use()` - simplify to return single model
+- Single model extraction logic
+
+**Simplify `Extractor.__init__`:**
+```python
+def __init__(
+    self,
+    host: Optional[str] = None,
+    backend: Optional[str] = None,
+    model: Optional[str] = None,  # Single model selection
+    nsfw: bool = True,
+):
+```
+
+**Simplify extraction methods pattern:**
+```python
+def extract_character(self, image_path: Path) -> ExtractionResult:
+    model = self._get_model_to_use()  # Returns single model
+    try:
+        content = self.client.generate(model=model, prompt=prompt, image_path=image_path)
+        return ExtractionResult(content=content, model=model, ...)
+    except ClientError as e:
+        return ExtractionResult(content="", model=model, error=str(e), ...)
+```
+
+### 2. `src/prompts/extract/cli.py`
+
+**Remove:**
+- `parse_models_option()` function (lines 29-44)
+- `--models, -M` option from all commands
+- `models_list`, `num_models`, `preset` variables throughout
+- Multi-model display logic (`if result.model_results and len(...) > 1`)
+- `extract presets` command (lines 851-870)
+- Import of `MODEL_PRESETS`
+
+**Keep:**
+- `--model, -m` option for single model selection
+- All other CLI functionality
+
+**Affected commands:**
+- `extract character` - remove `--models` option
+- `extract style` - remove `--models` option
+- `extract scene` - remove `--models` option
+- `extract all` - remove `--models` option
+
+### 3. `scripts/multi_extract.py`
+
+**Delete entire file** - standalone multi-model script no longer needed.
+
+## Verification
+
+After changes:
+```bash
+# Should work
+uv run prompts extract character image.png
+uv run prompts extract character image.png --model minicpm-v:8b
+uv run prompts extract style image.png
+uv run prompts extract scene comic.png
+
+# Should error (removed)
+uv run prompts extract character image.png --models 2
+uv run prompts extract character image.png --models thorough
+uv run prompts extract presets
+```
+
+## Order of Changes
+
+1. Remove `scripts/multi_extract.py`
+2. Simplify `extractor.py` - remove synthesis, multi-model logic
+3. Simplify `cli.py` - remove `--models` options and `presets` command
+4. Test with `uv run prompts extract character <image> --model minicpm-v:8b`

package/plans/wiggly-sparking-pixel.md

@@ -0,0 +1,48 @@
+# Plan: CMS Cache Modernization
+
+## Deliverables
+
+Created two files in `/Users/chi/Projects/jam/`:
+
+### DRAFT.md - Analysis Document
+Documents all caching issues found in CMS, Fuse-Hotel, and Neon:
+- 3 Critical issues (missing TTL, blocking KEYS, silent lock failures)
+- 4 High priority issues (TTL mismatch, scattered config, stampede risk, no invalidation)
+- 5 Medium priority issues (naming, headers, cascade, sync blocking, mixed systems)
+- 4 Architecture recommendations
+
+### PLAN.md - Implementation Plan
+6-phase migration strategy for humans:
+
+**Phase 1: Foundation**
+- Create `Cache::Config` with centralized TTLs
+- Create `Cache::V2::Base` with proper error handling
+- Add feature flags for rollout control
+
+**Phase 2: Dual-Write**
+- Write to both old and new cache
+- No changes to read path
+- Populate new cache in production
+
+**Phase 3: Verification**
+- Compare old vs new cache values on reads
+- Log/alert on mismatches
+- Fix issues until 0 mismatches for 48h
+
+**Phase 4: Shadow Read**
+- Read from new cache, fallback to old
+- Monitor hit rates and latency
+- Run for 1 week minimum
+
+**Phase 5: Migration**
+- Gradual rollout: 10% → 25% → 50% → 100%
+- Stop legacy writes
+- Remove legacy code after 2 weeks stable
+
+**Phase 6: Enhancements**
+- Cache warming
+- Cache headers for frontend
+- Cascade invalidation
+- Observability dashboard
+
+Includes rollback procedures and success criteria for each phase.

package/plans/zippy-shimmying-fox.md

@@ -0,0 +1,188 @@
+# Plan: Comics Mode for Image Extraction
+
+## Goal
+
+Add `--comics` flag to extract command that produces structured comic page analysis:
+
+```markdown
+## Scene Title
+
+### Panel 1
+Person A and Person B do something:
+- [Person A] You are so cool!
+- [Person B] Thank you, but you suck big-time...
+
+### Panel 2
+Changed location [...]
+```
+
+## Existing Building Blocks
+
+| Component | File | Function |
+|-----------|------|----------|
+| Panel detection | `extractor.py` | `detect_panels()` |
+| Scene extraction | `extractor.py` | `extract_scene()` |
+| Character extraction | `extractor.py` | `extract_all_characters()` |
+| Dialogue OCR | `extractor.py` | `extract_dialogue()` |
+| Prompts | `prompts.py` | `SCENE_PROMPT_*`, `DIALOGUE_PROMPT` |
+
+## Implementation
+
+### 1. New Prompt in `prompts.py`
+
+```python
+COMICS_PROMPT_NSFW = """Analyze this comic page panel by panel.
+
+For each panel, provide:
+1. PANEL NUMBER
+2. CHARACTERS visible (brief description if new)
+3. ACTION - what's happening
+4. DIALOGUE - exact text with speaker attribution [Speaker Name]
+5. SFX - sound effects if any
+
+Format:
+### Panel 1
+**Characters:** Character A (blonde woman), Character B (dark-haired man)
+**Action:** Character A confronts Character B in a bedroom
+**Dialogue:**
+- [Character A] "You're late again!"
+- [Character B] "I can explain..."
+**SFX:** *SLAM*
+
+### Panel 2
+...
+
+Be thorough with dialogue OCR. Include all visible text."""
+```
+
+### 2. New Method in `extractor.py`
+
+```python
+@dataclass
+class ComicsResult:
+    """Result from comics extraction."""
+    image_path: Path
+    panel_count: int
+    layout: str
+    panels: list[dict]  # [{panel_num, characters, action, dialogue, sfx}]
+    raw_response: str
+
+    def to_markdown(self) -> str:
+        """Format as readable comic script."""
+        lines = [f"## {self.image_path.stem}\n"]
+        for panel in self.panels:
+            lines.append(f"### Panel {panel['panel_num']}\n")
+            lines.append(f"{panel['action']}\n")
+            for line in panel['dialogue']:
+                lines.append(f"- {line}")
+            if panel.get('sfx'):
+                lines.append(f"*{panel['sfx']}*\n")
+        return "\n".join(lines)
+
+def extract_comics(self, image_path: Path) -> ComicsResult:
+    """Extract full comic page analysis."""
+    prompt = get_comics_prompt(self.nsfw)
+    response = self.client.generate(self.model, prompt, image_path)
+    panels = self._parse_comics_response(response)
+    return ComicsResult(
+        image_path=image_path,
+        panel_count=len(panels),
+        layout="",
+        panels=panels,
+        raw_response=response
+    )
+
+def _parse_comics_response(self, response: str) -> list[dict]:
+    """Parse structured panel response into list of panel dicts."""
+    # Parse ### Panel N sections
+    # Extract Characters, Action, Dialogue, SFX from each
+    ...
+```
+
+### 3. New CLI Option in `cli.py`
+
+```python
+@extract.command("character")
+@click.option("--comics", is_flag=True, help="Comics mode: panel-by-panel with dialogue")
+def extract_character(path, comics, ...):
+    if comics:
+        return _extract_comics(path, output, ...)
+    # ... existing logic
+
+def _extract_comics(path, output, model, host, backend, nsfw):
+    """Extract comic page with panels and dialogue."""
+    extractor = Extractor(host=host, backend=backend, model=model, nsfw=nsfw)
+    result = extractor.extract_comics(path)
+
+    # Save as comics/comics_{stem}.md
+    output_path = output / "comics" / f"comics_{path.stem}.md"
+    output_path.parent.mkdir(parents=True, exist_ok=True)
+    output_path.write_text(result.to_markdown())
+    click.echo(f"Saved to: {output_path}")
+```
+
+## Files to Modify
+
+1. **`src/prompts/extract/prompts.py`**
+   - Add `COMICS_PROMPT_NSFW` and `COMICS_PROMPT_SFW`
+   - Add `get_comics_prompt(nsfw: bool)` function
+
+2. **`src/prompts/extract/extractor.py`**
+   - Add `ComicsResult` dataclass
+   - Add `extract_comics()` method
+   - Add `_parse_comics_response()` helper
+   - Add `save_comics_result()` function
+
+3. **`src/prompts/extract/cli.py`**
+   - Add `--comics` flag to `extract_character` command
+   - Add `_extract_comics()` and `_batch_extract_comics()` handlers
+
+## Output Structure
+
+```
+output/
+└── comics/
+    ├── comics_page_001.md
+    ├── comics_page_002.md
+    └── _index.json  # optional metadata
+```
+
+## Example Output
+
+```markdown
+## page_001
+
+### Panel 1
+
+Sarah enters the bedroom to find Jake waiting:
+
+- [Sarah] "You're finally here..."
+- [Jake] "I've been waiting all day for you."
+
+### Panel 2
+
+Close-up as they embrace:
+
+- [Sarah] "I missed you so much!"
+
+*SFX: rustle*
+
+### Panel 3
+
+Scene shifts to the bed:
+
+- [Jake] "Let me show you how much I missed you..."
+```
+
+## Verification
+
+```bash
+# Test single comic page
+uv run prompts extract character comic.png --comics -o output/
+
+# Test batch
+uv run prompts extract character comics_dir/ --comics -o output/
+
+# Check output
+cat output/comics/comics_comic.md
+```

package/plugins/installed_plugins.json

@@ -0,0 +1,4 @@
+{
+  "version": 2,
+  "plugins": {}
+}

package/sample-hooks.json

@@ -0,0 +1,298 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks pre-tool-use bash",
+            "timeout": 10
+          }
+        ]
+      },
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks pre-tool-use file-modify",
+            "timeout": 10
+          }
+        ]
+      },
+      {
+        "matcher": "Read",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks pre-tool-use file-read",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Glob|Grep",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks pre-tool-use search",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Task",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks pre-tool-use subagent",
+            "timeout": 10
+          }
+        ]
+      },
+      {
+        "matcher": "WebFetch|WebSearch",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks pre-tool-use web",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Notebook.*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks pre-tool-use notebook",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks post-tool-use bash",
+            "timeout": 30
+          }
+        ]
+      },
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks post-tool-use file-modify",
+            "timeout": 30
+          }
+        ]
+      },
+      {
+        "matcher": "Task",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks post-tool-use subagent",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PermissionRequest": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks permission-request bash",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks permission-request file-modify",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks user-prompt-submit",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "matcher": "permission_prompt",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks notification permission",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "idle_prompt",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks notification idle",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "auth_success",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks notification auth",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "elicitation_dialog",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks notification elicitation",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks stop",
+            "timeout": 10
+          }
+        ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "Evaluate if Claude should stop. Context: $ARGUMENTS. Return {\"ok\": true} to stop or {\"ok\": false, \"reason\": \"explanation\"} to continue.",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks subagent-stop",
+            "timeout": 10
+          }
+        ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "Evaluate if this subagent completed its task. Input: $ARGUMENTS. Return {\"ok\": true} to allow stopping or {\"ok\": false, \"reason\": \"explanation\"} to continue.",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "matcher": "manual",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks pre-compact manual",
+            "timeout": 10
+          }
+        ]
+      },
+      {
+        "matcher": "auto",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks pre-compact auto",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "startup",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks session-start startup",
+            "timeout": 30
+          }
+        ]
+      },
+      {
+        "matcher": "resume",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks session-start resume",
+            "timeout": 30
+          }
+        ]
+      },
+      {
+        "matcher": "clear",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks session-start clear",
+            "timeout": 10
+          }
+        ]
+      },
+      {
+        "matcher": "compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks session-start compact",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "honbu hooks session-end",
+            "timeout": 30
+          }
+        ]
+      }
+    ]
+  }
+}

package/settings.json

@@ -0,0 +1,24 @@
+{
+  "permissions": {
+    "allow": [
+      "WebFetch(domain:raw.githubusercontent.com)",
+      "WebFetch(domain:api.github.com)",
+      "WebFetch(domain:pypi.org)",
+      "WebFetch(domain:www.thoughtasylum.com)",
+      "WebFetch(domain:docs.anthropic.com)",
+      "WebFetch(domain:zed.dev)",
+      "WebFetch(domain:www.npmjs.com)",
+      "WebFetch(domain:crates.io)",
+      "WebFetch(domain:docs.claude.com)",
+      "Read(//Users/chi/Projects/reference/**)",
+      "Glob(//Users/chi/Projects/reference/**)",
+      "Grep(//Users/chi/Projects/reference/**)",
+      "mcp__plugin_ccpp_mcp__*",
+      "WebSearch",
+      "Bash"
+    ]
+  },
+  "enabledPlugins": {
+    "ccpp@personality": true
+  }
+}

package/settings.local.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "Skill(disk)"
+    ]
+  }
+}