@claudemini/shit-cli 1.4.0 → 1.5.0

package/lib/status.js

@@ -5,20 +5,10 @@
  * Similar to 'entire status' - displays active session info
  */
 
-import { existsSync, readFileSync } from 'fs';
+import { existsSync, readFileSync, readdirSync, statSync } from 'fs';
 import { join } from 'path';
 import { execSync } from 'child_process';
-
-function findProjectRoot() {
-  let dir = process.cwd();
-  while (dir !== '/') {
-    if (existsSync(join(dir, '.git'))) {
-      return dir;
-    }
-    dir = join(dir, '..');
-  }
-  throw new Error('Not in a git repository');
-}
+import { getProjectRoot, SESSION_ID_REGEX } from './config.js';
 
 function getCurrentSession(projectRoot) {
   const shitLogsDir = join(projectRoot, '.shit-logs');
@@ -27,9 +17,11 @@ function getCurrentSession(projectRoot) {
   }
 
   // Find the most recent session directory
-  const { readdirSync, statSync } = await import('fs');
   const sessions = readdirSync(shitLogsDir)
-    .filter(name => name.match(/^\d{4}-\d{2}-\d{2}-[a-f0-9-]+$/)) // session format
+    .filter(name => {
+      const fullPath = join(shitLogsDir, name);
+      return SESSION_ID_REGEX.test(name) && statSync(fullPath).isDirectory();
+    })
     .map(name => ({
       name,
       path: join(shitLogsDir, name),
@@ -90,11 +82,45 @@ function formatDuration(startTime) {
   }
 }
 
+function getTouchedFileCount(state) {
+  const ops = state?.file_ops;
+  if (!ops || typeof ops !== 'object') {
+    return 0;
+  }
+
+  const touched = new Set([
+    ...(Array.isArray(ops.write) ? ops.write : []),
+    ...(Array.isArray(ops.edit) ? ops.edit : []),
+    ...(Array.isArray(ops.read) ? ops.read : []),
+  ].filter(Boolean));
+
+  return touched.size;
+}
+
+function hasShitHooks(settings) {
+  if (!settings?.hooks || typeof settings.hooks !== 'object') {
+    return false;
+  }
+
+  return Object.values(settings.hooks).some(value => {
+    if (typeof value === 'string') {
+      return value.includes('shit log');
+    }
+    if (!Array.isArray(value)) {
+      return false;
+    }
+    return value.some(entry =>
+      Array.isArray(entry?.hooks) &&
+      entry.hooks.some(hook => typeof hook?.command === 'string' && hook.command.includes('shit log'))
+    );
+  });
+}
+
 export default async function status(args) {
   try {
-    const projectRoot = findProjectRoot();
+    const projectRoot = getProjectRoot();
     const gitInfo = getGitInfo(projectRoot);
-    const currentSession = await getCurrentSession(projectRoot);
+    const currentSession = getCurrentSession(projectRoot);
 
     console.log('📊 shit-cli Status\n');
 
@@ -121,7 +147,7 @@ export default async function status(args) {
         console.log(`   Started: ${new Date(state.start_time).toLocaleString()}`);
         console.log(`   Duration: ${formatDuration(state.start_time)}`);
         console.log(`   Events: ${state.event_count || 0}`);
-        console.log(`   Files: ${Object.keys(state.files || {}).length}`);
+        console.log(`   Files: ${getTouchedFileCount(state)}`);
 
         if (state.shadow_branch) {
           console.log(`   Shadow: ${state.shadow_branch}`);
@@ -149,8 +175,7 @@ export default async function status(args) {
     if (existsSync(claudeSettings)) {
       try {
         const settings = JSON.parse(readFileSync(claudeSettings, 'utf-8'));
-        const hasHooks = settings.hooks &&
-          (settings.hooks.session_start || settings.hooks.session_end);
+        const hasHooks = hasShitHooks(settings);
 
         console.log();
         if (hasHooks) {

package/lib/summarize.js

@@ -8,7 +8,7 @@
 
 import { existsSync, readFileSync, writeFileSync } from 'fs';
 import { join } from 'path';
-import { execSync } from 'child_process';
+import { getProjectRoot } from './config.js';
 
 // Default configuration
 const DEFAULT_CONFIG = {
@@ -294,7 +294,7 @@ export async function summarizeSession(projectRoot, sessionId, sessionDir) {
  * CLI command for manual summarization
  */
 export default async function summarize(args) {
-  const projectRoot = findProjectRoot();
+  const projectRoot = getProjectRoot();
   const sessionId = args[0];
 
   if (!sessionId) {
@@ -329,14 +329,3 @@ export default async function summarize(args) {
     process.exit(1);
   }
 }
-
-function findProjectRoot() {
-  let dir = process.cwd();
-  while (dir !== '/') {
-    if (existsSync(join(dir, '.git'))) {
-      return dir;
-    }
-    dir = join(dir, '..');
-  }
-  throw new Error('Not in a git repository');
-}

package/package.json

@@ -1,20 +1,37 @@
 {
   "name": "@claudemini/shit-cli",
-  "version": "1.4.0",
-  "description": "Session-based Hook Intelligence Tracker - CLI tool for logging Claude Code hooks",
+  "version": "1.5.0",
+  "description": "Session-based Hook Intelligence Tracker - Zero-dependency memory system for human-AI coding sessions",
   "type": "module",
   "bin": {
     "shit": "./bin/shit.js"
   },
+  "files": [
+    "bin/",
+    "lib/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "keywords": [
     "claude-code",
+    "gemini-cli",
+    "cursor",
+    "ai-coding",
     "hooks",
-    "logging",
-    "session-tracking"
+    "session-tracking",
+    "code-review",
+    "checkpoint"
   ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anthropics/shit-cli.git"
+  },
   "author": "",
   "license": "MIT",
   "dependencies": {},

package/.claude/settings.json

@@ -1,81 +0,0 @@
-{
-  "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

@@ -1,20 +0,0 @@
-{
-  "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:*)",
-      "WebFetch(domain:github.com)"
-    ]
-  }
-}

package/COMPARISON.md

@@ -1,92 +0,0 @@
-# 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

@@ -1,138 +0,0 @@
-# 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

@@ -1,109 +0,0 @@
-# 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
-```