@claudemini/shit-cli 1.0.3

package/.claude/settings.json

@@ -0,0 +1,81 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "shit log session-start"
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "shit log session-end"
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "shit log user-prompt-submit"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "shit log pre-tool-use"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "shit log post-tool-use"
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "shit log notification"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "shit log stop"
+          }
+        ]
+      }
+    ]
+  }
+}

package/.claude/settings.local.json

@@ -0,0 +1,19 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git remote add:*)",
+      "Bash(git push:*)",
+      "Bash(npm publish:*)",
+      "Bash(npm whoami:*)",
+      "WebFetch(domain:www.npmjs.com)",
+      "Bash(npm config delete:*)",
+      "Bash(sudo chown:*)",
+      "Bash(npm cache clean:*)",
+      "Bash(npm install:*)",
+      "Bash(git add:*)",
+      "Bash(git commit -m \"$\\(cat <<''EOF''\n更新包名和版本号\n\n- 包名改为 @cluademini/shit-cli\n- 版本号升至 1.0.3\nEOF\n\\)\")",
+      "Bash(git commit:*)",
+      "Bash(npm config set:*)"
+    ]
+  }
+}

package/COMPARISON.md

@@ -0,0 +1,92 @@
+# Project Structure Comparison
+
+## Directory Layout
+
+```
+your-project/
+├── .claude/                    # Claude Code configuration
+│   └── settings.json           # Hook configurations
+├── .entire/                    # Entire tool (session management)
+│   ├── metadata/
+│   │   └── <session-id>/
+│   │       ├── full.jsonl      # Complete transcript
+│   │       ├── prompt.txt      # User prompts
+│   │       ├── context.md      # Session context
+│   │       └── summary.txt     # Session summary
+│   ├── logs/
+│   └── settings.json
+└── .shit-logs/                 # shit-cli (hook event logging)
+    ├── <session-id>/
+    │   ├── events.jsonl        # Hook events only
+    │   ├── prompts.txt         # User prompts
+    │   ├── context.md          # Session context
+    │   ├── summary.txt         # Session summary
+    │   └── metadata.json       # Session metadata
+    └── index.txt               # Global index
+```
+
+## Feature Comparison
+
+| Feature | `.entire` | `.shit-logs` |
+|---------|-----------|--------------|
+| **Scope** | Complete session transcript | Hook events only |
+| **Location** | Project root | Project root ✓ |
+| **Session-based** | ✓ | ✓ |
+| **Transcript** | `full.jsonl` (all messages) | `events.jsonl` (hooks only) |
+| **Prompts** | `prompt.txt` | `prompts.txt` |
+| **Context** | `context.md` | `context.md` |
+| **Summary** | `summary.txt` | `summary.txt` |
+| **Checkpoints** | Git shadow branches | Not implemented |
+| **CLI** | `entire` commands | `shit` commands |
+| **Auto-init** | `entire enable` | `shit init` |
+
+## Key Differences
+
+### `.entire` (Entire Tool)
+- **Purpose**: Complete session management and checkpointing
+- **Data**: Full conversation transcript (user + assistant messages)
+- **Features**: Git integration, checkpoints, session replay
+- **Trigger**: Automatic (entire daemon)
+
+### `.shit-logs` (shit-cli)
+- **Purpose**: Hook event logging and analysis
+- **Data**: Hook events only (tool calls, session events)
+- **Features**: Session aggregation, event filtering, cleanup
+- **Trigger**: Hook-based (Claude Code hooks)
+
+## Use Cases
+
+### Use `.entire` when you need:
+- Complete session history
+- Git-based checkpointing
+- Session replay and analysis
+- Cross-session context
+
+### Use `.shit-logs` when you need:
+- Hook event debugging
+- Tool usage analysis
+- Session statistics
+- Lightweight logging
+
+## Both Together
+
+Running both systems provides:
+- **Complete coverage**: Full transcript + hook events
+- **Different perspectives**: Conversation flow + tool execution
+- **Complementary data**: `.entire` for context, `.shit-logs` for debugging
+
+## .gitignore
+
+Both directories are typically excluded from git:
+
+```gitignore
+# Entire tool
+.entire/store/
+.entire/monitor.pid
+.entire/monitor.sessions.json
+
+# shit-cli logs
+.shit-logs/
+```
+
+Note: `.entire/settings.json` and `.entire/.gitignore` are usually committed.

package/DESIGN_PHILOSOPHY.md

@@ -0,0 +1,138 @@
+# shit-cli Design Philosophy
+
+## Core Vision
+
+### 1. Human-AI Interaction Memory System
+Long-term memory storage for human-AI interactions, not just temporary logs. Each session is analyzed for semantic meaning — what was the intent, what changed, what's the risk.
+
+### 2. Code Review Bot Data Support
+Provide reliable, structured data to support code review automation. The bot doesn't need to parse raw events — it gets pre-classified changes, risk assessments, and review hints.
+
+## Architecture
+
+```
+Human ↔ AI (Claude Code)
+         ↓ (hooks)
+    Event Ingestion (log.js)
+         ↓
+    Semantic Extraction (extract.js)
+         ↓
+    Session State (session.js) + Reports (report.js)
+         ↓
+    Memory System (.shit-logs + index.json)
+         ↓
+    Code Review Bot / Human Queries
+```
+
+### Three-Layer Architecture
+
+1. **Ingestion Layer** — `log.js` reads stdin, parses events, dispatches
+2. **Intelligence Layer** — `extract.js` classifies intent, changes, risk
+3. **Storage Layer** — `session.js` manages state, `report.js` generates outputs
+
+## Semantic Model
+
+### Intent Extraction
+From user prompts, extract:
+- **Goal**: What the user is trying to accomplish
+- **Type**: bugfix, feature, refactor, debug, test, docs, etc.
+- **Scope**: Which domains are involved (auth, api, database, etc.)
+
+### Change Extraction
+From tool events, extract:
+- **Files**: Categorized (source, test, config, doc, script, infra, deps, migration)
+- **Operations**: What was done to each file (read, write, edit)
+- **Commands**: Categorized (test, build, git, deploy, install, lint, database)
+
+### Session Classification
+Combining intent + changes:
+- **Type**: Dominant activity category
+- **Risk**: Assessment based on file count, config changes, test coverage
+- **Review Hints**: Actionable flags for code review bots
+
+## File Structure
+
+```
+.shit-logs/
+├── index.json               # Cross-session index (file history, session types)
+└── <session-id>/
+    ├── events.jsonl          # Raw hook events (complete history)
+    ├── state.json            # Incremental processing state
+    ├── summary.json          # Bot data interface (v2 schema)
+    ├── summary.txt           # Human-readable semantic report
+    ├── prompts.txt           # User prompts with timestamps
+    └── metadata.json         # Lightweight session metadata
+```
+
+## Key Design Decisions
+
+### 1. Rule-Based Classification (No AI Dependency)
+Intent and change classification use simple pattern matching rules. This ensures:
+- Zero latency — runs during hook processing
+- Zero cost — no API calls
+- Predictable — deterministic output
+- Offline — works without network
+
+### 2. Cross-Session Index
+The `index.json` file enables:
+- File history queries ("how often was this file changed?")
+- Session type filtering ("show all bugfix sessions")
+- Risk tracking over time
+- Bot can query without scanning all sessions
+
+### 3. summary.json v2 Schema
+Upgraded from v1 (statistics-only) to v2 (semantic):
+- **v1**: event counts, file lists, tool usage
+- **v2**: intent, type, risk, review_hints, categorized changes/commands
+
+### 4. Incremental Processing
+State is maintained incrementally in `state.json`. Each event updates the state, and reports are regenerated from the latest state. This means:
+- Fast processing per event (~5ms)
+- Reports always reflect current session state
+- No need to re-read events.jsonl
+
+### 5. Best-Effort Shadow Branches
+Git shadow branches and index updates are best-effort — failures don't affect core logging. This ensures hooks never block Claude Code.
+
+## Bot Integration Patterns
+
+### Direct File Read
+```javascript
+const summary = JSON.parse(fs.readFileSync('.shit-logs/<id>/summary.json'));
+// Use summary.review_hints for automated review decisions
+```
+
+### Cross-Session Query
+```javascript
+const index = JSON.parse(fs.readFileSync('.shit-logs/index.json'));
+// Find all sessions that touched a specific file
+const sessions = index.file_history['src/auth/service.ts'];
+// Filter by type or risk
+const risky = index.sessions.filter(s => s.risk === 'high');
+```
+
+### CLI Query (for humans)
+```bash
+shit query --file=src/auth/service.ts  # File history
+shit query --type=bugfix --recent=5    # Recent bugfixes
+shit query --risk=high --json          # High-risk as JSON
+```
+
+## Comparison with `.entire`
+
+| Aspect | `.entire` | `.shit-logs` |
+|--------|-----------|--------------|
+| **Data Source** | Full transcript | Hook events |
+| **Intelligence** | Raw messages | Semantic extraction |
+| **Bot Interface** | Parse messages | Structured JSON (v2) |
+| **Cross-Session** | No | Index with file history |
+| **Review Hints** | No | Tests, risk, coverage |
+| **Purpose** | Conversation memory | Operation intelligence |
+
+## Future Enhancements
+
+- AI-powered intent extraction (optional, when available)
+- Diff-level change tracking (what exactly changed in each edit)
+- Session linking (detect related sessions across time)
+- Anomaly detection (unusual patterns in session activity)
+- Bot API endpoint (serve session data over HTTP)

package/QUICKSTART.md

@@ -0,0 +1,109 @@
+# Quick Start Guide
+
+## Installation
+
+```bash
+# Clone or download shit-cli
+cd ~/Desktop/shit-cli
+
+# Install globally
+npm link
+
+# Or add to PATH
+echo 'export PATH="$HOME/Desktop/shit-cli/bin:$PATH"' >> ~/.zshrc
+source ~/.zshrc
+```
+
+## Setup (One-time)
+
+```bash
+# Navigate to your project
+cd /path/to/your/project
+
+# Initialize hooks
+shit init
+```
+
+This creates `.claude/settings.json` with all necessary hooks.
+
+## Verify Installation
+
+```bash
+# Check if shit is available
+shit help
+
+# Should output:
+# shit-cli - Session-based Hook Intelligence Tracker
+# Usage: shit <command> [options]
+# ...
+```
+
+## Usage
+
+Once initialized, hooks will automatically log events to `~/.shit-logs/`.
+
+### View your sessions
+
+```bash
+# List all sessions
+shit list
+
+# View specific session
+shit view <session-id>
+```
+
+### Clean up old logs
+
+```bash
+# Preview what will be deleted
+shit clean --days=7 --dry-run
+
+# Actually delete
+shit clean --days=7
+```
+
+## Troubleshooting
+
+### Command not found: shit
+
+If `npm link` doesn't work, use the full path:
+
+```bash
+node ~/Desktop/shit-cli/bin/shit.js init
+```
+
+Or create an alias:
+
+```bash
+echo 'alias shit="node ~/Desktop/shit-cli/bin/shit.js"' >> ~/.zshrc
+source ~/.zshrc
+```
+
+### Hooks not working
+
+1. Check if `.claude/settings.json` exists in your project
+2. Verify hooks are registered: `cat .claude/settings.json`
+3. Restart Claude Code
+
+### Logs not appearing
+
+1. Check log directory: `ls -la ~/.shit-logs/`
+2. Verify hooks are being triggered (check Claude Code output)
+3. Test manually:
+   ```bash
+   echo '{"session_id":"test-123","hook_event_name":"Test"}' | shit log test
+   shit list
+   ```
+
+## Uninstall
+
+```bash
+# Remove global link
+npm unlink -g shit-cli
+
+# Remove logs
+rm -rf ~/.shit-logs
+
+# Remove hooks from project
+# Edit .claude/settings.json and remove shit-related hooks
+```

package/README.md

@@ -0,0 +1,258 @@
+# shit-cli
+
+**S**ession-based **H**ook **I**ntelligence **T**racker
+
+A memory system for human-AI interactions, designed to provide reliable data support for code review automation.
+
+## Design Vision
+
+1. **Human-AI Interaction Memory System** - Long-term memory, not temporary logs
+2. **Code Review Bot Data Support** - Structured semantic data for intelligent code review
+
+See [DESIGN_PHILOSOPHY.md](./DESIGN_PHILOSOPHY.md) for detailed design rationale.
+
+## Installation
+
+```bash
+cd shit-cli
+npm link
+```
+
+Or use directly:
+```bash
+node bin/shit.js <command>
+```
+
+## Usage
+
+### Initialize hooks
+
+```bash
+cd /path/to/your/project
+shit init
+```
+
+Registers all hooks in `.claude/settings.json` automatically.
+
+### List sessions
+
+```bash
+shit list
+```
+
+Output:
+```
+3 session(s):
+
+1. f608c31e  [bugfix]  risk:medium
+   Fix auth timeout by adjusting retry logic
+   45min | 42 events | 28 tools | 3 files | 0 errors
+   2/27/2026, 3:15:00 PM
+
+2. a1b2c3d4  [feature]  risk:low
+   Add user profile endpoint
+   30min | 28 events | 15 tools | 2 files | 0 errors
+   2/26/2026, 10:30:00 AM
+```
+
+### View session details
+
+```bash
+shit view f608c31e-453c-435a-b0e2-3116dc56ad71
+shit view f608c31e-453c-435a-b0e2-3116dc56ad71 --json  # Include raw JSON
+```
+
+Output includes: intent, changes by category, tools, commands, review hints (tests run, build verified, config changed, etc.).
+
+### Query session memory
+
+```bash
+shit query --recent=5                         # Recent 5 sessions
+shit query --file=src/auth/auth.service.ts    # Sessions that modified this file
+shit query --type=bugfix                      # All bugfix sessions
+shit query --risk=high                        # High-risk sessions
+shit query --type=feature --json              # JSON output for bot consumption
+```
+
+### Shadow branches
+
+```bash
+shit shadow                     # List shadow branches
+shit shadow info <branch>       # Show branch details
+```
+
+### Clean old sessions
+
+```bash
+shit clean --days=7 --dry-run   # Preview
+shit clean --days=7             # Delete sessions older than 7 days
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `init` | Initialize hooks in .claude/settings.json |
+| `log <hook-type>` | Log a hook event from stdin (called by hooks) |
+| `list` | List all sessions with type, intent, risk |
+| `view <session-id> [--json]` | View semantic session report |
+| `query [options]` | Query session memory across sessions |
+| `shadow [info <branch>]` | List or inspect shadow branches |
+| `clean [--days=N] [--dry-run]` | Clean old sessions |
+| `help` | Show help |
+
+## Architecture
+
+```
+shit-cli/
+├── bin/shit.js              # CLI entry point
+├── lib/
+│   ├── config.js            # Shared config: getProjectRoot(), getLogDir(), toRelative()
+│   ├── extract.js           # Semantic extraction: intent, changes, classification
+│   ├── report.js            # Report generation: summary.json v2, summary.txt, metadata
+│   ├── session.js           # Session state management + cross-session index
+│   ├── log.js               # Event ingestion dispatcher (stdin → parse → extract → save)
+│   ├── init.js              # shit init (hook registration)
+│   ├── list.js              # shit list (semantic session listing)
+│   ├── view.js              # shit view (semantic report display)
+│   ├── query.js             # shit query (cross-session memory queries)
+│   ├── clean.js             # shit clean (session cleanup)
+│   ├── shadow.js            # shit shadow (branch listing)
+│   └── git-shadow.js        # Git plumbing for shadow branches
+```
+
+## Data Model
+
+### Session Directory
+
+```
+.shit-logs/
+├── index.json                              # Cross-session index (file history, types)
+└── <session-id>/
+    ├── events.jsonl                        # Raw hook events
+    ├── state.json                          # Incremental processing state
+    ├── summary.json                        # Bot data interface (v2 schema)
+    ├── summary.txt                         # Human-readable semantic report
+    ├── prompts.txt                         # User prompts with timestamps
+    └── metadata.json                       # Lightweight session metadata
+```
+
+### summary.json v2 Schema
+
+```json
+{
+  "version": "2.0",
+  "session": {
+    "id": "f608c31e...",
+    "start": "2026-02-27T10:00:00Z",
+    "end": "2026-02-27T10:45:00Z",
+    "duration_minutes": 45,
+    "type": "bugfix",
+    "intent": "Fix authentication timeout issue",
+    "risk": "medium",
+    "summary": "Fixed: Fix authentication timeout issue"
+  },
+  "changes": {
+    "files": [{
+      "path": "src/auth/auth.service.ts",
+      "category": "source",
+      "operations": ["edit"],
+      "editCount": 2,
+      "editSummary": "Modified timeout logic"
+    }],
+    "summary": { "source": 3, "test": 1 }
+  },
+  "activity": {
+    "tools": { "Read": 15, "Edit": 3, "Bash": 5 },
+    "commands": {
+      "test": ["npm run test"],
+      "git": ["git status"]
+    },
+    "errors": []
+  },
+  "review_hints": {
+    "tests_run": true,
+    "build_verified": false,
+    "files_without_tests": ["src/auth/auth.service.ts"],
+    "large_change": false,
+    "config_changed": false,
+    "migration_added": false
+  },
+  "prompts": ["Fix the auth timeout bug", "Run the tests"],
+  "scope": ["auth"]
+}
+```
+
+### Cross-Session Index
+
+```json
+{
+  "project": "my-project",
+  "sessions": [{
+    "id": "f608c31e...",
+    "date": "2026-02-27",
+    "type": "bugfix",
+    "intent": "Fix auth timeout",
+    "files": ["src/auth/auth.service.ts"],
+    "duration": 45,
+    "risk": "medium"
+  }],
+  "file_history": {
+    "src/auth/auth.service.ts": ["f608c31e...", "a1b2c3d4..."]
+  }
+}
+```
+
+## Session Types
+
+| Type | Description |
+|------|-------------|
+| `bugfix` | Bug fixes |
+| `feature` | New features |
+| `refactor` | Code restructuring |
+| `debug` | Investigation/debugging |
+| `test` | Test writing/updates |
+| `docs` | Documentation |
+| `devops` | CI/CD, deployment |
+| `upgrade` | Dependency updates |
+| `config` | Configuration changes |
+| `style` | Formatting, UI |
+| `security` | Security-related |
+| `perf` | Performance optimization |
+| `unknown` | Unclassified |
+
+## Risk Levels
+
+- **low**: Few files, no config/migration changes, tests run
+- **medium**: Multiple files, some config changes
+- **high**: Many files (>10), migration changes, infra changes without tests
+
+## Bot Integration
+
+```javascript
+// Read session data
+const summary = JSON.parse(fs.readFileSync('.shit-logs/<id>/summary.json'));
+
+// Check review hints
+if (!summary.review_hints.tests_run && summary.changes.files.length > 0) {
+  review.warn('Files modified but no tests run');
+}
+if (summary.review_hints.migration_added) {
+  review.flag('Database migration requires careful review');
+}
+
+// Query file history via index
+const index = JSON.parse(fs.readFileSync('.shit-logs/index.json'));
+const history = index.file_history['src/auth/auth.service.ts'];
+if (history.length > 3) {
+  review.note('This file has been modified frequently');
+}
+```
+
+## Environment Variables
+
+- `SHIT_LOG_DIR`: Custom log directory (default: `./.shit-logs` in project root)
+
+## License
+
+MIT