@weavelogic/knowledge-graph-agent 0.9.0 → 0.10.1

package/README.md

@@ -10,8 +10,9 @@ A powerful NPM library for creating and managing knowledge graphs for Claude Cod
 | Category | Features |
 |----------|----------|
 | **Core** | Knowledge graph generation, Obsidian integration, CLAUDE.md management |
-| **Cultivation** | Codebase analysis, seed generation, deep analysis with claude-flow |
+| **Cultivation** | Codebase analysis, seed generation, deep analysis with claude-flow, doc cultivation |
 | **Agents** | Multi-agent system, rules engine, workflows, MCP server with 30+ tools |
+| **Claude Hooks** | Capture all interactions, hierarchical storage, sub-agent tracking, swarm tracking |
 | **Services** | Service management, config migrations, health monitoring |
 | **Enterprise** | Chunking, backup/recovery, advanced caching, diagnostics |
 | **Integrations** | Workflow DevKit, RuVector semantic search, Exochain audit trail |
@@ -431,6 +432,110 @@ npx @weavelogic/knowledge-graph-agent mcp start
 
 ---
 
+## Claude Code Hooks
+
+Capture all Claude Code interactions and store them in a hierarchical knowledge graph structure.
+
+### Installation
+
+```bash
+# Install hooks to capture all interactions
+kg hooks install
+
+# Check hooks status
+kg hooks status
+
+# View captured sessions
+kg hooks sessions
+```
+
+### Features
+
+- **Hierarchical Storage**: Sessions → Conversations → Messages → Tool Calls
+- **Sub-Agent Tracking**: Automatically tracks Task tool spawns
+- **Swarm Tracking**: Captures claude-flow swarm operations
+- **Markdown Generation**: Creates documentation for all interactions
+- **Tool Output Separation**: Stores tool outputs in dedicated files
+
+### Hook Events Captured
+
+| Event | Description |
+|-------|-------------|
+| `UserPromptSubmit` | All user prompts |
+| `PreToolUse` | Tool invocations with inputs |
+| `PostToolUse` | Tool results and outputs |
+| `Stop` | Session completion |
+| `PreCompact` | Before context compaction |
+
+### Storage Structure
+
+```
+.kg/claude/
+├── sessions/           # JSON session data
+├── agents/            # Sub-agent tracking
+├── tool-outputs/      # Separated tool outputs
+├── docs/
+│   ├── sessions/      # Session markdown docs
+│   ├── conversations/ # Conversation logs
+│   └── agents/        # Sub-agent markdown docs
+```
+
+### Programmatic Usage
+
+```typescript
+import { HookCaptureSystem, generateHookConfig } from '@weavelogic/knowledge-graph-agent';
+
+// Create capture system
+const capture = new HookCaptureSystem('/project', {
+  createMarkdown: true,
+  separateToolOutputs: true,
+  captureSubAgents: true,
+  captureSwarms: true,
+});
+
+// Start a session
+const session = capture.startSession('Development Session', 'Feature implementation');
+
+// Handle hook events
+capture.handleHookEvent({
+  event: 'UserPromptSubmit',
+  timestamp: new Date().toISOString(),
+  userPrompt: 'Help me implement...',
+});
+
+// End session
+const completedSession = capture.endSession();
+```
+
+---
+
+## Document Cultivation
+
+Automatically build out comprehensive documentation using claude-flow swarm orchestration.
+
+### Usage
+
+```bash
+# Cultivate documentation with swarm agents
+kg cultivate --path /project
+
+# Include SOP compliance analysis
+kg cultivate --include-sops
+
+# Dry run to preview
+kg cultivate --dry-run
+```
+
+### Features
+
+- **7-Phase Cultivation Process**: Structure analysis through completion
+- **Development Planning**: Generates phased development plans
+- **Infrastructure Planning**: Creates dev/staging/production infrastructure plans
+- **SOP Compliance**: Integrates AI-SDLC SOP analysis
+- **Swarm Orchestration**: Uses claude-flow for parallel documentation generation
+
+---
+
 ## Enterprise Features
 
 ### Chunker for Large Documents
@@ -592,13 +697,25 @@ const execution = await workflow.start('document-analysis', {
 | `kg dashboard serve` | Serve production build |
 | `kg dashboard status` | Check dashboard status |
 
-### Documentation
+### Documentation & Cultivation
 
 | Command | Description |
 |---------|-------------|
 | `kg docs init` | Initialize docs directory |
 | `kg analyze` | Analyze & migrate to knowledge graph |
 | `kg convert docs` | Convert docs/ to docs-nn/ |
+| `kg cultivate` | Cultivate docs using swarm orchestration |
+| `kg cultivate --include-sops` | Include SOP compliance analysis |
+
+### Claude Code Hooks
+
+| Command | Description |
+|---------|-------------|
+| `kg hooks install` | Install hooks to capture interactions |
+| `kg hooks uninstall` | Remove hooks configuration |
+| `kg hooks status` | Show hooks status |
+| `kg hooks sessions` | List captured sessions |
+| `kg hooks export` | Export captured sessions |
 
 ### Configuration
 
@@ -724,6 +841,53 @@ import {
 
 ## Changelog
 
+### v0.10.1
+
+**Default Directory Fix:**
+- Changed default target directory from `docs-nn` to `docs`
+- `kg analyze`, `kg convert docs`, and related commands now output to `docs/` by default
+- Use `--target docs-nn` if you specifically need the old behavior
+- Updated help text and documentation to reflect the change
+
+### v0.10.0
+
+**Claude Code Hooks System:**
+- **Hook Capture System** - Capture all Claude interactions (prompts, responses, tool calls)
+- **Hierarchical Storage** - Sessions → Conversations → Messages → Tool Calls
+- **Sub-Agent Tracking** - Automatically tracks Task tool spawns with full context
+- **Swarm Tracking** - Captures claude-flow swarm operations
+- **Markdown Generation** - Creates documentation for sessions, conversations, agents
+- **Tool Output Separation** - Stores tool outputs in dedicated JSON files
+- **CLI Commands** - `kg hooks install/uninstall/status/sessions/export`
+- Comprehensive type definitions with Zod validation
+- 22 new tests for hook system
+
+### v0.9.0
+
+**Document Cultivation System:**
+- **Doc Cultivation Command** - `kg cultivate` for automated documentation buildout
+- **7-Phase Cultivation Process** - Structure → Content → Architecture → Development → Infrastructure → Review → Completion
+- **Development Planning** - Generates phased development plans with tasks
+- **Infrastructure Planning** - Creates dev/staging/production infrastructure plans
+- **SOP Compliance Analysis** - Integrates AI-SDLC SOP requirements
+- **Swarm Orchestration** - Uses claude-flow for parallel documentation generation
+- Support for multi-service projects (api, backend, frontend, admin)
+
+### v0.8.8
+
+- Added `src/{service}/docs` directory scanning and copying for doc generation
+- Enhanced service documentation detection
+
+### v0.8.7
+
+- Improved Python project detection for doc generation
+- Better handling of `requirements.txt` and `pyproject.toml`
+
+### v0.8.6
+
+- Fixed vault-sync.test.ts timeout issues
+- Improved test stability
+
 ### v0.7.4
 
 - Fixed repository URL in package.json to match actual GitHub repo name

package/dist/_virtual/index10.js

@@ -1,5 +1,5 @@
-var dist = {};
+var lib = {};
 export {
-  dist as __exports
+  lib as __exports
 };
 //# sourceMappingURL=index10.js.map

package/dist/_virtual/index11.js

@@ -1,5 +1,5 @@
-var lib = {};
+var dist = {};
 export {
-  lib as __exports
+  dist as __exports
 };
 //# sourceMappingURL=index11.js.map

package/dist/_virtual/index8.js

@@ -1,5 +1,5 @@
-var dist = {};
+var commonjs = {};
 export {
-  dist as __exports
+  commonjs as __exports
 };
 //# sourceMappingURL=index8.js.map

package/dist/_virtual/index9.js

@@ -1,5 +1,5 @@
-var commonjs = {};
+var dist = {};
 export {
-  commonjs as __exports
+  dist as __exports
 };
 //# sourceMappingURL=index9.js.map

package/dist/claude/hook-capture.d.ts

@@ -0,0 +1,209 @@
+/**
+ * Hook Capture System
+ *
+ * Captures all Claude interactions (prompts, responses, tool calls)
+ * and stores them in the knowledge graph with hierarchical structure.
+ *
+ * @module claude/hook-capture
+ */
+import { SessionId, ClaudeSession, ClaudeConversation } from './types.js';
+/**
+ * Hook event types from Claude Code
+ */
+export type HookEventType = 'PreToolUse' | 'PostToolUse' | 'UserPromptSubmit' | 'Stop' | 'PreCompact';
+/**
+ * Raw hook event data received from Claude Code
+ */
+export interface HookEventData {
+    event: HookEventType;
+    timestamp: string;
+    sessionId?: string;
+    toolName?: string;
+    toolInput?: Record<string, unknown>;
+    toolOutput?: string;
+    userPrompt?: string;
+    exitCode?: number;
+    duration?: number;
+    error?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Capture configuration options
+ */
+export interface CaptureConfig {
+    /** Base directory for storing captured data */
+    storageDir: string;
+    /** Whether to store in knowledge graph format */
+    useKnowledgeGraph: boolean;
+    /** Whether to create markdown documents */
+    createMarkdown: boolean;
+    /** Whether to track tool outputs separately */
+    separateToolOutputs: boolean;
+    /** Maximum content length to store (truncates if exceeded) */
+    maxContentLength: number;
+    /** Whether to capture sub-agent spawns */
+    captureSubAgents: boolean;
+    /** Whether to capture swarm operations */
+    captureSwarms: boolean;
+    /** Whether to capture workflow executions */
+    captureWorkflows: boolean;
+    /** Tags to add to all captured items */
+    defaultTags: string[];
+}
+/**
+ * Default configuration
+ */
+export declare const DEFAULT_CAPTURE_CONFIG: CaptureConfig;
+/**
+ * Hook Capture System
+ *
+ * Manages the capture and storage of all Claude interactions.
+ */
+export declare class HookCaptureSystem {
+    private config;
+    private state;
+    private projectRoot;
+    constructor(projectRoot: string, config?: Partial<CaptureConfig>);
+    /**
+     * Ensure storage directory exists
+     */
+    private ensureStorageDir;
+    /**
+     * Create empty token usage
+     */
+    private createEmptyTokenUsage;
+    /**
+     * Create empty aggregated token usage
+     */
+    private createEmptyAggregatedTokenUsage;
+    /**
+     * Create base metadata
+     */
+    private createBaseMetadata;
+    /**
+     * Get current git branch
+     */
+    private getGitBranch;
+    /**
+     * Start a new session
+     */
+    startSession(name?: string, purpose?: string): ClaudeSession;
+    /**
+     * End the current session
+     */
+    endSession(): ClaudeSession | null;
+    /**
+     * Start a new conversation
+     */
+    startConversation(model?: string, systemPrompt?: string): ClaudeConversation;
+    /**
+     * Handle hook events
+     */
+    handleHookEvent(event: HookEventData): void;
+    /**
+     * Handle user prompt submission
+     */
+    private handleUserPrompt;
+    /**
+     * Handle pre-tool use event
+     */
+    private handlePreToolUse;
+    /**
+     * Handle post-tool use event
+     */
+    private handlePostToolUse;
+    /**
+     * Handle session stop event
+     */
+    private handleSessionStop;
+    /**
+     * Handle pre-compact event
+     */
+    private handlePreCompact;
+    /**
+     * Handle sub-agent spawn
+     */
+    private handleSubAgentSpawn;
+    /**
+     * Handle sub-agent completion
+     */
+    private handleSubAgentComplete;
+    /**
+     * Handle swarm operation
+     */
+    private handleSwarmOperation;
+    /**
+     * Categorize tool calls
+     */
+    private categorizeToolCall;
+    /**
+     * Aggregate session tokens
+     */
+    private aggregateSessionTokens;
+    /**
+     * Truncate content to max length
+     */
+    private truncateContent;
+    /**
+     * Get storage path for an entity
+     */
+    private getStoragePath;
+    /**
+     * Get markdown path for an entity
+     */
+    private getMarkdownPath;
+    /**
+     * Save session to storage
+     */
+    private saveSession;
+    /**
+     * Save session as markdown
+     */
+    private saveSessionMarkdown;
+    /**
+     * Save message to storage
+     */
+    private saveMessage;
+    /**
+     * Append message to conversation log
+     */
+    private appendToConversationLog;
+    /**
+     * Save tool call to storage
+     */
+    private saveToolCall;
+    /**
+     * Save sub-agent to storage
+     */
+    private saveSubAgent;
+    /**
+     * Save sub-agent as markdown
+     */
+    private saveSubAgentMarkdown;
+    /**
+     * Get current session
+     */
+    getCurrentSession(): ClaudeSession | null;
+    /**
+     * Get current conversation
+     */
+    getCurrentConversation(): ClaudeConversation | null;
+    /**
+     * Load session from storage
+     */
+    loadSession(sessionId: SessionId): ClaudeSession | null;
+    /**
+     * List all stored sessions
+     */
+    listSessions(): SessionId[];
+}
+/**
+ * Process hook event from stdin (for use as CLI hook)
+ */
+export declare function processHookEvent(projectRoot: string, eventType: HookEventType, config?: Partial<CaptureConfig>): Promise<void>;
+/**
+ * Generate Claude Code hook configuration
+ */
+export declare function generateHookConfig(projectRoot: string): Record<string, unknown>;
+export default HookCaptureSystem;
+//# sourceMappingURL=hook-capture.d.ts.map

package/dist/claude/hook-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-capture.d.ts","sourceRoot":"","sources":["../../src/claude/hook-capture.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EACL,SAAS,EAOT,aAAa,EACb,kBAAkB,EAqBnB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,aAAa,GACb,kBAAkB,GAClB,MAAM,GACN,YAAY,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,2CAA2C;IAC3C,cAAc,EAAE,OAAO,CAAC;IACxB,+CAA+C;IAC/C,mBAAmB,EAAE,OAAO,CAAC;IAC7B,8DAA8D;IAC9D,gBAAgB,EAAE,MAAM,CAAC;IACzB,0CAA0C;IAC1C,gBAAgB,EAAE,OAAO,CAAC;IAC1B,0CAA0C;IAC1C,aAAa,EAAE,OAAO,CAAC;IACvB,6CAA6C;IAC7C,gBAAgB,EAAE,OAAO,CAAC;IAC1B,wCAAwC;IACxC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAUpC,CAAC;AA0BF;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM;IAepE;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAQ7B;;OAEG;IACH,OAAO,CAAC,+BAA+B;IASvC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;IACH,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa;IAwC5D;;OAEG;IACH,UAAU,IAAI,aAAa,GAAG,IAAI;IAsBlC;;OAEG;IACH,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,kBAAkB;IA4B5E;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAoB3C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoCxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0FxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA2CzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoC3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAwB9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA+B5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAqB9B;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,OAAO,CAAC,WAAW;IASnB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA6C3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAMnB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAqC/B;;OAEG;IACH,OAAO,CAAC,YAAY;IAwBpB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAiD5B;;OAEG;IACH,iBAAiB,IAAI,aAAa,GAAG,IAAI;IAIzC;;OAEG;IACH,sBAAsB,IAAI,kBAAkB,GAAG,IAAI;IAKnD;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa,GAAG,IAAI;IAYvD;;OAEG;IACH,YAAY,IAAI,SAAS,EAAE;CAc5B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,aAAa,EACxB,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC,CAiCf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+B/E;AAED,eAAe,iBAAiB,CAAC"}