@aladac/hu 0.1.0-a1 → 0.1.0-a2

package/SAMPLE.md

@@ -1,378 +0,0 @@
-# honbu Hooks: Feature Ideas
-
-Potential features enabled by Claude Code hooks + honbu integration.
-
-## Core Infrastructure
-
-### Session Bus (`~/.claude/bus/`)
-
-A shared data layer for cross-session and cross-instance communication.
-
-```
-~/.claude/bus/
-├── sessions/           # Active session state
-│   ├── {session_id}.json
-│   └── index.json      # All active sessions
-├── messages/           # Inter-session messaging
-│   ├── inbox/
-│   └── outbox/
-├── knowledge/          # Persistent knowledge store
-│   ├── facts.jsonl     # Learned facts
-│   ├── patterns.jsonl  # Code patterns seen
-│   └── decisions.jsonl # Decisions made
-├── locks/              # File locking for coordination
-└── events/             # Event stream (pub/sub)
-```
-
-### Commands
-
-```bash
-# Session management
-honbu bus session register    # Register current session
-honbu bus session list        # List active sessions
-honbu bus session get <id>    # Get session state
-honbu bus session broadcast   # Send to all sessions
-
-# Knowledge store
-honbu bus knowledge add       # Add fact/pattern
-honbu bus knowledge query     # Query knowledge
-honbu bus knowledge export    # Export for context injection
-
-# Messaging
-honbu bus send <session> <msg>  # Send to specific session
-honbu bus recv                   # Check for messages
-honbu bus subscribe <topic>      # Subscribe to topic
-```
-
----
-
-## Feature Ideas by Hook
-
-### SessionStart
-
-**Context Loading**
-```bash
-honbu hooks session-start startup
-```
-- Load recent git commits/changes
-- Inject unresolved TODOs from other sessions
-- Load relevant knowledge from bus
-- Check for messages from other instances
-- Restore environment variables
-
-**Multi-Instance Awareness**
-```bash
-# On startup, check what other instances are doing
-honbu bus session list --project $(pwd)
-# Output: "Instance A is working on auth module, Instance B on tests"
-# Inject this as context to avoid conflicts
-```
-
-**Project State Snapshot**
-```bash
-honbu hooks session-start startup
-# Returns:
-# - Current branch, uncommitted changes
-# - Failed tests from last run
-# - Open PRs affecting this code
-# - Recent errors from logs
-```
-
----
-
-### UserPromptSubmit
-
-**Prompt Enhancement**
-```bash
-honbu hooks user-prompt-submit
-```
-- Detect keywords and auto-inject relevant docs
-- Check knowledge bus for related previous work
-- Add "another instance is editing this file" warnings
-- Inject project conventions reminder
-
-**Smart Routing**
-```bash
-# If prompt mentions "test", inject test conventions
-# If prompt mentions a file, inject its recent history
-# If prompt mentions a pattern seen before, inject learned context
-```
-
-**Deduplication**
-```bash
-# Check if another session already solved this
-honbu bus knowledge query "error: cannot find module X"
-# Returns: "Session abc123 fixed this by running npm install"
-```
-
----
-
-### PreToolUse
-
-**File Coordination**
-```bash
-honbu hooks pre-tool-use file-modify
-```
-- Check if another instance has this file locked
-- Warn about concurrent edits
-- Auto-acquire lock if available
-
-```json
-{
-  "hookSpecificOutput": {
-    "hookEventName": "PreToolUse",
-    "permissionDecision": "deny",
-    "permissionDecisionReason": "File locked by session abc123 (editing auth module)"
-  }
-}
-```
-
-**Command Safety**
-```bash
-honbu hooks pre-tool-use bash
-```
-- Log all commands to knowledge base
-- Block dangerous patterns (rm -rf, force push)
-- Check command against project policies
-- Rate limit expensive operations
-
-**Smart Caching**
-```bash
-honbu hooks pre-tool-use search
-```
-- Cache grep/glob results
-- Return cached results for repeated queries
-- Share search results across sessions
-
----
-
-### PostToolUse
-
-**Learning System**
-```bash
-honbu hooks post-tool-use file-modify
-```
-- Record file modification patterns
-- Learn project structure over time
-- Track which files often change together
-- Build implicit dependency graph
-
-**Auto-Actions**
-```bash
-honbu hooks post-tool-use bash
-```
-- If test failed, record in knowledge bus
-- If build succeeded, clear related error knowledge
-- If command produced useful output, cache it
-
-**Notification Routing**
-```bash
-honbu hooks post-tool-use subagent
-```
-- Notify other sessions about completed work
-- Update shared progress tracker
-- Publish events for interested subscribers
-
----
-
-### Stop / SubagentStop
-
-**Work Handoff**
-```bash
-honbu hooks stop
-```
-- Save unfinished work to bus
-- Record "I was working on X, got to Y"
-- Create resumption context for next session
-- Notify other instances work is available
-
-**Knowledge Extraction**
-```bash
-honbu hooks stop
-```
-- Extract learned facts from conversation
-- Record successful patterns
-- Update project knowledge base
-- Log time spent on task categories
-
----
-
-### PreCompact
-
-**Memory Preservation**
-```bash
-honbu hooks pre-compact auto
-```
-- Extract key facts before context compaction
-- Save important decisions to knowledge bus
-- Create resumption checkpoint
-- Preserve cross-session relevant info
-
----
-
-### SessionEnd
-
-**Cleanup & Sync**
-```bash
-honbu hooks session-end
-```
-- Release all file locks
-- Deregister from session bus
-- Sync local knowledge to global store
-- Generate session summary
-
-**Analytics**
-```bash
-honbu hooks session-end
-```
-- Log session duration, tool usage stats
-- Record success/failure patterns
-- Update productivity metrics
-
----
-
-## Advanced Features
-
-### Cross-Instance Coordination
-
-**Scenario**: Multiple Claude Code instances working on same project
-
-```
-┌─────────────────────────────────────────────────────┐
-│                    honbu bus                       │
-├─────────────────────────────────────────────────────┤
-│  Instance A          Instance B          Instance C  │
-│  (auth module)       (tests)            (docs)       │
-│       │                  │                  │        │
-│       └──────────────────┼──────────────────┘        │
-│                          │                           │
-│              Shared Knowledge Store                  │
-│              File Locks / Coordination               │
-│              Message Passing                         │
-└─────────────────────────────────────────────────────┘
-```
-
-**File Locking**
-```bash
-# PreToolUse: Acquire lock
-honbu bus lock acquire src/auth.ts --session $SESSION_ID
-
-# PostToolUse: Release lock  
-honbu bus lock release src/auth.ts
-
-# Check locks
-honbu bus lock list
-# src/auth.ts - session abc (Instance A)
-# src/tests/auth.test.ts - session def (Instance B)
-```
-
-**Work Broadcasting**
-```bash
-# Instance A finishes auth module
-honbu bus broadcast "auth module complete, ready for integration tests"
-
-# Instance B receives on next UserPromptSubmit
-honbu bus recv
-# "Message from Instance A: auth module complete..."
-```
-
-### Knowledge Accumulation
-
-**Fact Learning**
-```bash
-# After successful debugging
-honbu bus knowledge add \
-  --type "error-solution" \
-  --pattern "ENOENT: no such file" \
-  --solution "Check file path, run npm install" \
-  --confidence 0.9
-
-# Later, on similar error
-honbu bus knowledge query "ENOENT"
-# Returns previous solutions with confidence scores
-```
-
-**Pattern Recognition**
-```bash
-# Track file co-modification
-honbu bus knowledge add \
-  --type "file-coupling" \
-  --files "src/api.ts,src/api.test.ts,src/types.ts" \
-  --frequency 15
-
-# On editing api.ts, suggest related files
-honbu hooks pre-tool-use file-modify
-# Injects: "Files often modified together: api.test.ts, types.ts"
-```
-
-### Smart Context Injection
-
-**SessionStart: Project Awareness**
-```bash
-honbu hooks session-start startup
-```
-Output (injected as context):
-```
-## Project State
-- Branch: feature/auth (3 commits ahead of main)
-- Uncommitted: src/auth.ts (+45), tests/auth.test.ts (+20)
-- Last session: worked on JWT validation, incomplete
-- Other instances: none active
-
-## Recent Knowledge
-- Pattern: This project uses Zod for validation
-- Fact: Auth tokens expire in 24h (from .env discussion)
-- Warning: Don't modify src/legacy/* (marked deprecated)
-
-## Pending Tasks
-- [ ] Add refresh token logic (from session xyz)
-- [ ] Fix flaky test in auth.test.ts
-```
-
-### Event-Driven Workflows
-
-**Pub/Sub System**
-```bash
-# Subscribe to file changes
-honbu bus subscribe "file:src/api/*"
-
-# Publish events
-honbu bus publish "file:src/api/auth.ts" "modified"
-
-# Other sessions receive
-honbu bus recv --topic "file:src/api/*"
-```
-
-**Automated Reactions**
-```bash
-# PostToolUse on test failure
-honbu bus publish "test:fail" "auth.test.ts:45"
-
-# SessionStart checks for failures
-honbu bus query --topic "test:fail" --since "1h"
-# Injects: "Recent test failures: auth.test.ts:45"
-```
-
----
-
-## Implementation Priority
-
-### Phase 1: Core Bus
-- [ ] Session registry
-- [ ] File locking
-- [ ] Basic messaging
-
-### Phase 2: Knowledge Store  
-- [ ] Fact storage/retrieval
-- [ ] Pattern tracking
-- [ ] Context generation
-
-### Phase 3: Advanced Coordination
-- [ ] Pub/sub events
-- [ ] Cross-instance sync
-- [ ] Conflict resolution
-
-### Phase 4: Intelligence
-- [ ] Pattern recognition
-- [ ] Predictive suggestions
-- [ ] Automated learning

package/TODO.md

@@ -1,25 +0,0 @@
-# TODO: honbu data Subcommand
-
-## Phase 1: Core Data Access Commands
-- [ ] Step 1.1: Create data command module structure
-- [ ] Step 1.2: Add data store path utilities
-- [ ] Step 1.3: Implement session list command
-- [ ] Step 1.4: Implement session read command
-- [ ] Step 1.5: Implement stats command
-- [ ] Step 1.6: Implement history command
-
-## Phase 2: Extended Data Access
-- [ ] Step 2.1: Implement todos list command
-- [ ] Step 2.2: Implement todos pending command
-- [ ] Step 2.3: Implement file-history list command
-- [ ] Step 2.4: Implement session current command
-
-## Phase 3: Search and Query
-- [ ] Step 3.1: Implement session search command
-- [ ] Step 3.2: Implement tools usage command
-- [ ] Step 3.3: Implement errors command
-
-## Phase 4: JSONL Parsing Library
-- [ ] Step 4.1: Create JSONL parser module
-- [ ] Step 4.2: Create session transcript parser
-- [ ] Step 4.3: Refactor data commands to use parsers