dino-spec 9.8.0 → 9.10.0

package/README.md

@@ -10,11 +10,12 @@
 <__|-|__|
 ```
 
-**dino-spec** brings structured, context-aware development to [Claude Code](https://claude.ai/code). It automatically maintains session state, provides 33 MCP tools, and enables intelligent context retrieval with real-time statusline display.
+**dino-spec** brings structured, context-aware development to [Claude Code](https://claude.ai/code). It automatically maintains session state, provides 47 MCP tools, and enables intelligent context retrieval with real-time statusline display.
 
 ## Features
 
-- **MCP Integration** - 33 tools + 19 resources auto-configured during init
+- **MCP Integration** - 47 tools + 29 resources auto-configured during init
+- **Enhanced Observability** - Execution tree, memory access log, context transitions with HTML/JSON export (v9.10.0)
 - **Session State** - Automatic tracking of focus, test/build/lint status, blockers
 - **Persistent Memory** - Decisions, patterns, learnings survive across sessions
 - **Interactive Memory Browser** - TUI for browsing memories with vim-style navigation (v9.0.0)
@@ -106,6 +107,10 @@ Access via `@dino://` in Claude Code:
 | `@dino://handoff` | Agent handoff context |
 | `@dino://memories/summary` | All memories overview |
 | `@dino://retrieval/ranked` | Session-relevant files |
+| `@dino://traces/tree` | Execution tree overview (v9.10.0) |
+| `@dino://traces/memory-access` | Memory access log (v9.10.0) |
+| `@dino://traces/context-graph` | Context transition graph (v9.10.0) |
+| `@dino://traces/overview` | Combined trace overview (v9.10.0) |
 
 ## MCP Tools
 
@@ -133,6 +138,10 @@ Key tools available via Claude Code:
 | `dino_embed_stats` | Vector store statistics |
 | `dino_chunk_file` | AST-based semantic chunking |
 | `dino_chunk_analyze` | Chunking analysis |
+| `dino_effort_recommend` | Recommend effort level based on task complexity (v9.9.0) |
+| `dino_trace_export` | Export execution traces to JSON or HTML (v9.10.0) |
+| `dino_memory_access_stats` | View memory operation statistics (v9.10.0) |
+| `dino_context_transitions` | View context transition history (v9.10.0) |
 
 ## Specialized Agents
 

package/dist/agents/context-distributor.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Multi-Agent Context Distributor - v9.5.0
+ *
+ * Intelligent context distribution for specialized sub-agents.
+ * Key features:
+ * - Focused context slices per agent type
+ * - Session state coordination
+ * - Parallel agent orchestration
+ * - Context budget management
+ */
+import { type SubagentType } from './index.js';
+/**
+ * Context slice types
+ */
+export type ContextSliceType = 'focus-area' | 'dependencies' | 'recent-changes' | 'test-context' | 'session-state' | 'memories' | 'blockers' | 'plan-context' | 'error-context';
+/**
+ * Context slice with content
+ */
+export interface ContextSlice {
+    type: ContextSliceType;
+    name: string;
+    content: string;
+    tokenEstimate: number;
+    priority: number;
+    relevance: number;
+}
+/**
+ * Agent context profile
+ */
+export interface AgentContextProfile {
+    agentName: string;
+    subagentType: SubagentType;
+    requiredSlices: ContextSliceType[];
+    optionalSlices: ContextSliceType[];
+    maxTokenBudget: number;
+    priorityWeights: Partial<Record<ContextSliceType, number>>;
+}
+/**
+ * Distributed context for an agent
+ */
+export interface DistributedContext {
+    agentName: string;
+    slices: ContextSlice[];
+    totalTokens: number;
+    budgetUtilization: number;
+    omittedSlices: ContextSlice[];
+}
+/**
+ * Agent coordination state
+ */
+export interface AgentCoordinationState {
+    activeAgents: string[];
+    completedAgents: string[];
+    pendingHandoffs: AgentHandoff[];
+    sharedContext: Map<string, string>;
+    lastUpdated: string;
+}
+/**
+ * Agent handoff request
+ */
+export interface AgentHandoff {
+    fromAgent: string;
+    toAgent: string;
+    context: string;
+    reason: string;
+    timestamp: string;
+}
+/**
+ * Orchestration request
+ */
+export interface OrchestrationRequest {
+    task: string;
+    taskType: 'research' | 'plan' | 'implement' | 'test' | 'review';
+    projectDir: string;
+    focusArea?: string;
+    constraints?: {
+        maxAgents?: number;
+        sequential?: boolean;
+        tokenBudget?: number;
+    };
+}
+/**
+ * Orchestration result
+ */
+export interface OrchestrationResult {
+    agents: {
+        name: string;
+        context: DistributedContext;
+        order: number;
+        dependencies: string[];
+    }[];
+    handoffs: AgentHandoff[];
+    estimatedTokens: number;
+}
+/**
+ * Default context profiles per agent type
+ */
+export declare const AGENT_CONTEXT_PROFILES: Record<string, AgentContextProfile>;
+/**
+ * Collect focus area context
+ */
+export declare function collectFocusAreaContext(projectDir: string, focusArea?: string): Promise<ContextSlice | null>;
+/**
+ * Collect session state context
+ */
+export declare function collectSessionStateContext(projectDir: string): Promise<ContextSlice | null>;
+/**
+ * Collect recent changes context
+ */
+export declare function collectRecentChangesContext(projectDir: string): Promise<ContextSlice | null>;
+/**
+ * Collect memories context
+ */
+export declare function collectMemoriesContext(projectDir: string): Promise<ContextSlice | null>;
+/**
+ * Collect blockers context
+ */
+export declare function collectBlockersContext(projectDir: string): Promise<ContextSlice | null>;
+/**
+ * Collect test context
+ */
+export declare function collectTestContext(projectDir: string): Promise<ContextSlice | null>;
+/**
+ * Collect all available context slices
+ */
+export declare function collectAllSlices(projectDir: string, focusArea?: string): Promise<ContextSlice[]>;
+/**
+ * Distribute context to an agent based on its profile
+ */
+export declare function distributeContext(slices: ContextSlice[], profile: AgentContextProfile): DistributedContext;
+/**
+ * Get context profile for an agent
+ */
+export declare function getContextProfile(agentName: string): AgentContextProfile | null;
+/**
+ * Load coordination state
+ */
+export declare function loadCoordinationState(projectDir: string): Promise<AgentCoordinationState>;
+/**
+ * Save coordination state
+ */
+export declare function saveCoordinationState(state: AgentCoordinationState, projectDir: string): Promise<void>;
+/**
+ * Register agent as active
+ */
+export declare function registerActiveAgent(agentName: string, projectDir: string): Promise<void>;
+/**
+ * Mark agent as completed
+ */
+export declare function markAgentCompleted(agentName: string, projectDir: string, result?: string): Promise<void>;
+/**
+ * Request handoff to another agent
+ */
+export declare function requestHandoff(fromAgent: string, toAgent: string, context: string, reason: string, projectDir: string): Promise<void>;
+/**
+ * Get pending handoffs for an agent
+ */
+export declare function getPendingHandoffs(agentName: string, projectDir: string): Promise<AgentHandoff[]>;
+/**
+ * Clear pending handoff
+ */
+export declare function clearHandoff(handoff: AgentHandoff, projectDir: string): Promise<void>;
+/**
+ * Determine agents needed for a task
+ */
+export declare function selectAgentsForTask(taskType: OrchestrationRequest['taskType']): string[];
+/**
+ * Orchestrate multi-agent task execution
+ */
+export declare function orchestrateTask(request: OrchestrationRequest): Promise<OrchestrationResult>;
+/**
+ * Format distributed context for display
+ */
+export declare function formatDistributedContext(context: DistributedContext): string;
+/**
+ * Format orchestration result for display
+ */
+export declare function formatOrchestrationResult(result: OrchestrationResult): string;
+//# sourceMappingURL=context-distributor.d.ts.map

package/dist/agents/context-distributor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-distributor.d.ts","sourceRoot":"","sources":["../../src/agents/context-distributor.ts"],"names":[],"mappings":"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"}