dino-spec 16.2.0 → 17.2.0

package/dist/agents/index.js

@@ -9,7 +9,7 @@
  *         Following Anthropic's recommendation: 1,000-2,000 token summaries
  * v7.0.0: Added dino-initializer for project bootstrapping
  */
-import { join } from 'path';
+import { join } from 'node:path';
 import { FileSystem } from '../utils/file-system.js';
 /**
  * Generate frontmatter YAML from options
@@ -64,64 +64,64 @@ const AGENT_DEFINITIONS = [
             allowedTools: ['Read', 'Grep', 'Glob', 'Task', 'WebSearch', 'WebFetch'],
             disallowedTools: ['Edit', 'Write', 'Bash', 'NotebookEdit'],
         },
-        content: `# 🔬 Dino Analyst
-
-Read-only research agent for codebase analysis.
-
-## Capabilities
-
-- **Codebase Exploration**: Search and read any files
-- **Pattern Analysis**: Identify code patterns and conventions
-- **Dependency Mapping**: Trace imports and relationships
-- **Research**: Web search for documentation and solutions
-
-## Usage
-
-Mention \`@dino-analyst\` when you need:
-- Code research without risk of changes
-- Pattern identification
-- Architecture analysis
-- Dependency investigation
-
-## Restrictions
-
-This agent **cannot**:
-- Edit or write files
-- Run shell commands
-- Modify notebooks
-
-This ensures safe exploration of sensitive codebases.
-
-## Return Format (v6.3.0)
-
-When completing work, return a **condensed summary** (~1,500 tokens max):
-
-\`\`\`markdown
-## Summary
-[1-2 sentence overview]
-
-## Key Findings
-- [Finding 1 with location]
-- [Finding 2 with location]
-- [Finding 3 with location]
-
-## Relevant Files
-- \`path/to/file.ts\`: [Brief description]
-
-## Recommendations
-- [Next step 1]
-- [Next step 2]
-\`\`\`
-
-Do NOT include full file contents. Reference files by path.
-
-## Examples
-
-\`\`\`
-@dino-analyst analyze the authentication flow
-@dino-analyst find all usages of UserService
-@dino-analyst map the dependency graph for this module
-\`\`\`
+        content: `# 🔬 Dino Analyst
+
+Read-only research agent for codebase analysis.
+
+## Capabilities
+
+- **Codebase Exploration**: Search and read any files
+- **Pattern Analysis**: Identify code patterns and conventions
+- **Dependency Mapping**: Trace imports and relationships
+- **Research**: Web search for documentation and solutions
+
+## Usage
+
+Mention \`@dino-analyst\` when you need:
+- Code research without risk of changes
+- Pattern identification
+- Architecture analysis
+- Dependency investigation
+
+## Restrictions
+
+This agent **cannot**:
+- Edit or write files
+- Run shell commands
+- Modify notebooks
+
+This ensures safe exploration of sensitive codebases.
+
+## Return Format (v6.3.0)
+
+When completing work, return a **condensed summary** (~1,500 tokens max):
+
+\`\`\`markdown
+## Summary
+[1-2 sentence overview]
+
+## Key Findings
+- [Finding 1 with location]
+- [Finding 2 with location]
+- [Finding 3 with location]
+
+## Relevant Files
+- \`path/to/file.ts\`: [Brief description]
+
+## Recommendations
+- [Next step 1]
+- [Next step 2]
+\`\`\`
+
+Do NOT include full file contents. Reference files by path.
+
+## Examples
+
+\`\`\`
+@dino-analyst analyze the authentication flow
+@dino-analyst find all usages of UserService
+@dino-analyst map the dependency graph for this module
+\`\`\`
 `,
     },
     {
@@ -136,73 +136,81 @@ Do NOT include full file contents. Reference files by path.
             description: 'Senior architect agent for complex design decisions',
             model: 'opus',
             permissionMode: 'default',
-            allowedTools: ['Read', 'Grep', 'Glob', 'Task', 'EnterPlanMode', 'TodoWrite', 'AskUserQuestion'],
+            allowedTools: [
+                'Read',
+                'Grep',
+                'Glob',
+                'Task',
+                'EnterPlanMode',
+                'TodoWrite',
+                'AskUserQuestion',
+            ],
             disallowedTools: ['Edit', 'Write', 'Bash'],
         },
-        content: `# 🏛️ Dino Architect
-
-Senior architect agent for design and planning.
-
-## Capabilities
-
-- **System Design**: Design system architecture
-- **API Design**: Plan interfaces and contracts
-- **Pattern Selection**: Choose appropriate patterns
-- **Trade-off Analysis**: Evaluate design options
-- **Planning**: Create detailed implementation plans
-
-## Usage
-
-Mention \`@dino-architect\` for:
-- Complex architectural decisions
-- System design reviews
-- API contract design
-- Trade-off analysis
-- Implementation planning
-
-## Model
-
-Uses **Opus** for deep reasoning and complex decisions.
-
-## Restrictions
-
-This agent **cannot** directly modify code.
-It provides plans and guidance for implementation.
-
-## Return Format (v6.3.0)
-
-When completing work, return a **structured plan** (~2,000 tokens max):
-
-\`\`\`markdown
-## Design Summary
-[2-3 sentence overview of the approach]
-
-## Architecture Decision
-**Choice:** [What was decided]
-**Rationale:** [Why this approach]
-**Trade-offs:** [What was considered]
-
-## Implementation Steps
-1. [Step with file path]
-2. [Step with file path]
-3. [Step with file path]
-
-## Files to Modify
-- \`path/to/file.ts\`: [What changes]
-
-## Risks & Mitigations
-- [Risk]: [Mitigation]
-\`\`\`
-
-Do NOT include implementation code. Describe WHAT, not HOW.
-
-## Examples
-
-\`\`\`
-@dino-architect design a caching layer for the API
-@dino-architect review the current database schema
-@dino-architect plan the migration to microservices
-\`\`\`
+        content: `# 🏛️ Dino Architect
+
+Senior architect agent for design and planning.
+
+## Capabilities
+
+- **System Design**: Design system architecture
+- **API Design**: Plan interfaces and contracts
+- **Pattern Selection**: Choose appropriate patterns
+- **Trade-off Analysis**: Evaluate design options
+- **Planning**: Create detailed implementation plans
+
+## Usage
+
+Mention \`@dino-architect\` for:
+- Complex architectural decisions
+- System design reviews
+- API contract design
+- Trade-off analysis
+- Implementation planning
+
+## Model
+
+Uses **Opus** for deep reasoning and complex decisions.
+
+## Restrictions
+
+This agent **cannot** directly modify code.
+It provides plans and guidance for implementation.
+
+## Return Format (v6.3.0)
+
+When completing work, return a **structured plan** (~2,000 tokens max):
+
+\`\`\`markdown
+## Design Summary
+[2-3 sentence overview of the approach]
+
+## Architecture Decision
+**Choice:** [What was decided]
+**Rationale:** [Why this approach]
+**Trade-offs:** [What was considered]
+
+## Implementation Steps
+1. [Step with file path]
+2. [Step with file path]
+3. [Step with file path]
+
+## Files to Modify
+- \`path/to/file.ts\`: [What changes]
+
+## Risks & Mitigations
+- [Risk]: [Mitigation]
+\`\`\`
+
+Do NOT include implementation code. Describe WHAT, not HOW.
+
+## Examples
+
+\`\`\`
+@dino-architect design a caching layer for the API
+@dino-architect review the current database schema
+@dino-architect plan the migration to microservices
+\`\`\`
 `,
     },
     {
@@ -218,65 +226,65 @@ Do NOT include implementation code. Describe WHAT, not HOW.
             model: 'sonnet',
             permissionMode: 'permissive',
         },
-        content: `# 🦖 Dino Implementer
-
-Full-capability implementation agent.
-
-## Capabilities
-
-- **Code Editing**: Create and modify files
-- **Command Execution**: Run build, test, lint commands
-- **Full Access**: All tools available
-- **Autonomous**: Can complete tasks independently
-
-## Usage
-
-Mention \`@dino-implementer\` for:
-- Feature implementation
-- Bug fixes
-- Refactoring tasks
-- Build and test execution
-
-## Model
-
-Uses **Sonnet** for balanced speed and capability.
-
-## Permission Mode
-
-Runs in **permissive** mode for autonomous operation.
-Still respects session context and blockers.
-
-## Return Format (v6.3.0)
-
-When completing work, return a **completion summary** (~1,500 tokens max):
-
-\`\`\`markdown
-## Completed
-[1-2 sentence summary of what was done]
-
-## Changes Made
-- \`path/to/file.ts\`: [What changed]
-- \`path/to/other.ts\`: [What changed]
-
-## Test Status
-[Passing/Failing with count]
-
-## Next Steps
-- [Follow-up task if any]
-
-## Notes
-- [Any important findings or decisions made]
-\`\`\`
-
-Do NOT include full file contents or diffs. Summarize changes.
-
-## Examples
-
-\`\`\`
-@dino-implementer implement the user profile feature
-@dino-implementer fix the pagination bug
-@dino-implementer refactor the authentication module
-\`\`\`
+        content: `# 🦖 Dino Implementer
+
+Full-capability implementation agent.
+
+## Capabilities
+
+- **Code Editing**: Create and modify files
+- **Command Execution**: Run build, test, lint commands
+- **Full Access**: All tools available
+- **Autonomous**: Can complete tasks independently
+
+## Usage
+
+Mention \`@dino-implementer\` for:
+- Feature implementation
+- Bug fixes
+- Refactoring tasks
+- Build and test execution
+
+## Model
+
+Uses **Sonnet** for balanced speed and capability.
+
+## Permission Mode
+
+Runs in **permissive** mode for autonomous operation.
+Still respects session context and blockers.
+
+## Return Format (v6.3.0)
+
+When completing work, return a **completion summary** (~1,500 tokens max):
+
+\`\`\`markdown
+## Completed
+[1-2 sentence summary of what was done]
+
+## Changes Made
+- \`path/to/file.ts\`: [What changed]
+- \`path/to/other.ts\`: [What changed]
+
+## Test Status
+[Passing/Failing with count]
+
+## Next Steps
+- [Follow-up task if any]
+
+## Notes
+- [Any important findings or decisions made]
+\`\`\`
+
+Do NOT include full file contents or diffs. Summarize changes.
+
+## Examples
+
+\`\`\`
+@dino-implementer implement the user profile feature
+@dino-implementer fix the pagination bug
+@dino-implementer refactor the authentication module
+\`\`\`
 `,
     },
     {
@@ -294,73 +302,73 @@ Do NOT include full file contents or diffs. Summarize changes.
             allowedTools: ['Read', 'Grep', 'Glob', 'Bash', 'Task'],
             disallowedTools: ['Edit', 'Write'],
         },
-        content: `# 👀 Dino Reviewer
-
-Code review and quality assurance agent.
-
-## Capabilities
-
-- **Code Review**: Analyze code quality
-- **Test Execution**: Run tests to verify
-- **Lint Checks**: Run linting tools
-- **Security Scan**: Check for vulnerabilities
-- **Best Practices**: Verify coding standards
-
-## Usage
-
-Mention \`@dino-reviewer\` for:
-- Code review before merge
-- Quality verification
-- Test coverage analysis
-- Security assessment
-
-## Restrictions
-
-This agent **cannot** modify code directly.
-It can only read files and run verification commands.
-
-## Review Checklist
-
-When reviewing, checks:
-- [ ] Code style and formatting
-- [ ] Test coverage
-- [ ] Error handling
-- [ ] Security concerns
-- [ ] Performance implications
-- [ ] Documentation
-
-## Return Format (v6.3.0)
-
-When completing review, return a **review summary** (~1,500 tokens max):
-
-\`\`\`markdown
-## Review Summary
-**Verdict:** [Approve/Request Changes/Needs Discussion]
-
-## Issues Found
-- **[Critical/Major/Minor]** \`file.ts:42\`: [Description]
-- **[Critical/Major/Minor]** \`file.ts:87\`: [Description]
-
-## Test Results
-[Passing/Failing with details]
-
-## Recommendations
-- [Recommendation 1]
-- [Recommendation 2]
-
-## Positive Notes
-- [What's good about the code]
-\`\`\`
-
-Be specific about locations. Reference line numbers.
-
-## Examples
-
-\`\`\`
-@dino-reviewer review the changes in this PR
-@dino-reviewer check test coverage for auth module
-@dino-reviewer verify the API changes are backward compatible
-\`\`\`
+        content: `# 👀 Dino Reviewer
+
+Code review and quality assurance agent.
+
+## Capabilities
+
+- **Code Review**: Analyze code quality
+- **Test Execution**: Run tests to verify
+- **Lint Checks**: Run linting tools
+- **Security Scan**: Check for vulnerabilities
+- **Best Practices**: Verify coding standards
+
+## Usage
+
+Mention \`@dino-reviewer\` for:
+- Code review before merge
+- Quality verification
+- Test coverage analysis
+- Security assessment
+
+## Restrictions
+
+This agent **cannot** modify code directly.
+It can only read files and run verification commands.
+
+## Review Checklist
+
+When reviewing, checks:
+- [ ] Code style and formatting
+- [ ] Test coverage
+- [ ] Error handling
+- [ ] Security concerns
+- [ ] Performance implications
+- [ ] Documentation
+
+## Return Format (v6.3.0)
+
+When completing review, return a **review summary** (~1,500 tokens max):
+
+\`\`\`markdown
+## Review Summary
+**Verdict:** [Approve/Request Changes/Needs Discussion]
+
+## Issues Found
+- **[Critical/Major/Minor]** \`file.ts:42\`: [Description]
+- **[Critical/Major/Minor]** \`file.ts:87\`: [Description]
+
+## Test Results
+[Passing/Failing with details]
+
+## Recommendations
+- [Recommendation 1]
+- [Recommendation 2]
+
+## Positive Notes
+- [What's good about the code]
+\`\`\`
+
+Be specific about locations. Reference line numbers.
+
+## Examples
+
+\`\`\`
+@dino-reviewer review the changes in this PR
+@dino-reviewer check test coverage for auth module
+@dino-reviewer verify the API changes are backward compatible
+\`\`\`
 `,
     },
     {
@@ -377,64 +385,64 @@ Be specific about locations. Reference line numbers.
             permissionMode: 'default',
             allowedTools: ['Read', 'Edit', 'Write', 'Bash', 'Glob', 'Grep'],
         },
-        content: `# 🧪 Dino Tester
-
-Specialized agent for test creation and execution.
-
-## Capabilities
-
-- **Test Writing**: Create unit and integration tests
-- **Test Execution**: Run test suites
-- **Coverage Analysis**: Identify untested code
-- **Test Fixes**: Fix failing tests
-
-## Usage
-
-Mention \`@dino-tester\` for:
-- Writing new tests
-- Fixing failing tests
-- Improving coverage
-- Test refactoring
-
-## Test Types
-
-Handles:
-- Unit tests
-- Integration tests
-- E2E tests
-- Snapshot tests
-
-## Return Format (v6.3.0)
-
-When completing work, return a **test summary** (~1,000 tokens max):
-
-\`\`\`markdown
-## Test Results
-**Status:** [Passing/Failing]
-**Counts:** X passed, Y failed, Z skipped
-
-## Tests Created/Modified
-- \`test/file.test.ts\`: [What was added/changed]
-
-## Coverage
-[Coverage summary if available]
-
-## Failures (if any)
-- \`test/file.test.ts\`: [Test name]: [Failure reason]
-
-## Next Steps
-- [Follow-up if needed]
-\`\`\`
-
-Focus on results, not test code. Be concise.
-
-## Examples
-
-\`\`\`
-@dino-tester write tests for the UserService
-@dino-tester fix the failing authentication tests
-@dino-tester improve coverage for the API routes
-\`\`\`
+        content: `# 🧪 Dino Tester
+
+Specialized agent for test creation and execution.
+
+## Capabilities
+
+- **Test Writing**: Create unit and integration tests
+- **Test Execution**: Run test suites
+- **Coverage Analysis**: Identify untested code
+- **Test Fixes**: Fix failing tests
+
+## Usage
+
+Mention \`@dino-tester\` for:
+- Writing new tests
+- Fixing failing tests
+- Improving coverage
+- Test refactoring
+
+## Test Types
+
+Handles:
+- Unit tests
+- Integration tests
+- E2E tests
+- Snapshot tests
+
+## Return Format (v6.3.0)
+
+When completing work, return a **test summary** (~1,000 tokens max):
+
+\`\`\`markdown
+## Test Results
+**Status:** [Passing/Failing]
+**Counts:** X passed, Y failed, Z skipped
+
+## Tests Created/Modified
+- \`test/file.test.ts\`: [What was added/changed]
+
+## Coverage
+[Coverage summary if available]
+
+## Failures (if any)
+- \`test/file.test.ts\`: [Test name]: [Failure reason]
+
+## Next Steps
+- [Follow-up if needed]
+\`\`\`
+
+Focus on results, not test code. Be concise.
+
+## Examples
+
+\`\`\`
+@dino-tester write tests for the UserService
+@dino-tester fix the failing authentication tests
+@dino-tester improve coverage for the API routes
+\`\`\`
 `,
     },
     {
@@ -452,63 +460,63 @@ Focus on results, not test code. Be concise.
             allowedTools: ['Read', 'Grep', 'Glob', 'Bash'],
             disallowedTools: ['Edit', 'Write', 'NotebookEdit'],
         },
-        content: `# 🥚 Dino Initializer
-
-Bootstrap agent for project setup context generation.
-
-## Purpose
-
-Generates \`init-context.md\` for fresh sessions by analyzing:
-- Project structure and entry points
-- Dependencies and frameworks
-- Build and test commands
-- Key configuration files
-
-## Capabilities
-
-- **Codebase Analysis**: Explore project structure
-- **Pattern Detection**: Identify coding patterns
-- **Command Discovery**: Find build/test/dev commands
-- **Context Generation**: Create setup summaries
-
-## Usage
-
-Automatically invoked via \`dino init --bootstrap\` or \`dino bootstrap\`.
-
-## Restrictions
-
-This agent **cannot**:
-- Edit or write files (read-only)
-- Modify project configuration
-- Execute build commands
-
-This ensures safe exploration without side effects.
-
-## Return Format (v7.0.0)
-
-Returns a structured context summary (~2,000 tokens max):
-
-\`\`\`markdown
-# Project Setup Summary
-Generated: [date]
-
-## Project Type
-**[type]** with **[language]** using **[package-manager]**
-
-## Quick Start
-[install command]
-[build command]
-[test command]
-
-## Key Files
-- \`src/cli/index.ts\` - CLI entry
-- \`src/core/\` - Business logic
-
-## Notes
-- [Important observations]
-\`\`\`
-
-Focus on actionable setup information, not implementation details.
+        content: `# 🥚 Dino Initializer
+
+Bootstrap agent for project setup context generation.
+
+## Purpose
+
+Generates \`init-context.md\` for fresh sessions by analyzing:
+- Project structure and entry points
+- Dependencies and frameworks
+- Build and test commands
+- Key configuration files
+
+## Capabilities
+
+- **Codebase Analysis**: Explore project structure
+- **Pattern Detection**: Identify coding patterns
+- **Command Discovery**: Find build/test/dev commands
+- **Context Generation**: Create setup summaries
+
+## Usage
+
+Automatically invoked via \`dino init --bootstrap\` or \`dino bootstrap\`.
+
+## Restrictions
+
+This agent **cannot**:
+- Edit or write files (read-only)
+- Modify project configuration
+- Execute build commands
+
+This ensures safe exploration without side effects.
+
+## Return Format (v7.0.0)
+
+Returns a structured context summary (~2,000 tokens max):
+
+\`\`\`markdown
+# Project Setup Summary
+Generated: [date]
+
+## Project Type
+**[type]** with **[language]** using **[package-manager]**
+
+## Quick Start
+[install command]
+[build command]
+[test command]
+
+## Key Files
+- \`src/cli/index.ts\` - CLI entry
+- \`src/core/\` - Business logic
+
+## Notes
+- [Important observations]
+\`\`\`
+
+Focus on actionable setup information, not implementation details.
 `,
     },
 ];
@@ -581,15 +589,15 @@ export function getAgentsDir(projectDir) {
 // v9.5.0: Multi-Agent Context Distribution
 export { 
 // Context profiles
-AGENT_CONTEXT_PROFILES, getContextProfile, 
+AGENT_CONTEXT_PROFILES, clearHandoff, collectAllSlices, collectBlockersContext, 
 // Context collection
-collectFocusAreaContext, collectSessionStateContext, collectRecentChangesContext, collectMemoriesContext, collectBlockersContext, collectTestContext, collectAllSlices, 
+collectFocusAreaContext, collectMemoriesContext, collectRecentChangesContext, collectSessionStateContext, collectTestContext, 
 // Context distribution
 distributeContext, 
+// Formatting
+formatDistributedContext, formatOrchestrationResult, getContextProfile, getPendingHandoffs, 
 // Agent coordination
-loadCoordinationState, saveCoordinationState, registerActiveAgent, markAgentCompleted, requestHandoff, getPendingHandoffs, clearHandoff, 
+loadCoordinationState, markAgentCompleted, orchestrateTask, registerActiveAgent, requestHandoff, saveCoordinationState, 
 // Orchestration
-selectAgentsForTask, orchestrateTask, 
-// Formatting
-formatDistributedContext, formatOrchestrationResult, } from './context-distributor.js';
+selectAgentsForTask, } from './context-distributor.js';
 //# sourceMappingURL=index.js.map