mcp-ai-agent-guidelines 0.12.6 → 0.13.0

package/README.md

@@ -178,7 +178,7 @@ Demos are automatically regenerated when tool code changes via GitHub Actions.
 
 ## Features & Tools
 
-**27 professional tools** for AI-powered development workflows. Each tool is rated by complexity:
+**32 professional tools** (31 active + 1 unified tool) for AI-powered development workflows. Each tool is rated by complexity:
 
 **⭐ Complexity Ratings:**
 
@@ -192,21 +192,24 @@ Demos are automatically regenerated when tool code changes via GitHub Actions.
 
 ---
 
-### 🎨 Prompt Builders (9 tools)
+### 🎨 Prompt Builders (10 tools)
 
 Build structured, effective prompts for various use cases.
 
-| Tool                                          | Purpose                                                         | Complexity | Learn More                                                           |
-| --------------------------------------------- | --------------------------------------------------------------- | ---------- | -------------------------------------------------------------------- |
-| `hierarchical-prompt-builder`                 | Multi-level specificity prompts (context → goal → requirements) | ⭐⭐       | [Guide](./docs/tools/hierarchical-prompt-builder.md)                 |
-| `code-analysis-prompt-builder`                | Code review prompts (security, performance, maintainability)    | ⭐⭐       | [Guide](./docs/tools/code-analysis-prompt-builder.md)                |
-| `architecture-design-prompt-builder`          | Architecture design with scale-appropriate guidance             | ⭐⭐⭐     | [Guide](./docs/tools/architecture-design-prompt-builder.md)          |
-| `digital-enterprise-architect-prompt-builder` | Enterprise architecture with mentor perspectives & research     | ⭐⭐⭐⭐   | [Guide](./docs/tools/digital-enterprise-architect-prompt-builder.md) |
-| `debugging-assistant-prompt-builder`          | Systematic debugging prompts with structured analysis           | ⭐⭐       | [Guide](./docs/tools/debugging-assistant-prompt-builder.md)          |
-| `l9-distinguished-engineer-prompt-builder`    | L9 (Distinguished Engineer) high-level technical design         | ⭐⭐⭐⭐⭐ | [Guide](./docs/tools/l9-distinguished-engineer-prompt-builder.md)    |
-| `documentation-generator-prompt-builder`      | Technical docs tailored to audience (API, user guide, spec)     | ⭐⭐       | [Guide](./docs/tools/documentation-generator-prompt-builder.md)      |
-| `domain-neutral-prompt-builder`               | Generic templates with objectives and workflows                 | ⭐⭐⭐     | [Guide](./docs/tools/domain-neutral-prompt-builder.md)               |
-| `security-hardening-prompt-builder`           | Security analysis with OWASP/compliance focus                   | ⭐⭐⭐     | [Guide](./docs/tools/security-hardening-prompt-builder.md)           |
+> **⚠️ Deprecation Notice**: Six individual prompt tools (`hierarchical-prompt-builder`, `prompting-hierarchy-evaluator`, `hierarchy-level-selector`, `prompt-chaining-builder`, `prompt-flow-builder`, `quick-developer-prompts-builder`) are deprecated as of v0.14.0 and will be removed in v0.15.0. Use `prompt-hierarchy` instead. See [Migration Guide](./docs/migration.md) for details.
+
+| Tool                                          | Purpose                                                                                     | Complexity | Learn More                                                           |
+| --------------------------------------------- | ------------------------------------------------------------------------------------------- | ---------- | -------------------------------------------------------------------- |
+| `prompt-hierarchy` ⭐ **NEW**                  | Unified prompt API with 6 modes: build, evaluate, select-level, chain, flow, quick         | ⭐⭐⭐     | [Guide](./docs/api/prompt-hierarchy.md)                              |
+| `hierarchical-prompt-builder` 🔻              | ⚠️ **Deprecated** - Use `prompt-hierarchy` mode=`build` instead                             | ⭐⭐       | [Guide](./docs/tools/hierarchical-prompt-builder.md)                 |
+| `code-analysis-prompt-builder`                | Code review prompts (security, performance, maintainability)                                | ⭐⭐       | [Guide](./docs/tools/code-analysis-prompt-builder.md)                |
+| `architecture-design-prompt-builder`          | Architecture design with scale-appropriate guidance                                         | ⭐⭐⭐     | [Guide](./docs/tools/architecture-design-prompt-builder.md)          |
+| `digital-enterprise-architect-prompt-builder` | Enterprise architecture with mentor perspectives & research                                 | ⭐⭐⭐⭐   | [Guide](./docs/tools/digital-enterprise-architect-prompt-builder.md) |
+| `debugging-assistant-prompt-builder`          | Systematic debugging prompts with structured analysis                                       | ⭐⭐       | [Guide](./docs/tools/debugging-assistant-prompt-builder.md)          |
+| `l9-distinguished-engineer-prompt-builder`    | L9 (Distinguished Engineer) high-level technical design                                     | ⭐⭐⭐⭐⭐ | [Guide](./docs/tools/l9-distinguished-engineer-prompt-builder.md)    |
+| `documentation-generator-prompt-builder`      | Technical docs tailored to audience (API, user guide, spec)                                 | ⭐⭐       | [Guide](./docs/tools/documentation-generator-prompt-builder.md)      |
+| `domain-neutral-prompt-builder`               | Generic templates with objectives and workflows                                             | ⭐⭐⭐     | [Guide](./docs/tools/domain-neutral-prompt-builder.md)               |
+| `security-hardening-prompt-builder`           | Security analysis with OWASP/compliance focus                                               | ⭐⭐⭐     | [Guide](./docs/tools/security-hardening-prompt-builder.md)           |
 
 ### 🔍 Code Analysis & Quality (7 tools)
 
@@ -242,22 +245,85 @@ Multi-phase design orchestration with constraint enforcement.
 | ------------------ | ---------------------------------------------------------------------------------- | ---------- | ----------------------------------------- |
 | `design-assistant` | Constraint-driven design sessions with artifact generation (ADRs, specs, roadmaps) | ⭐⭐⭐⭐   | [Guide](./docs/tools/design-assistant.md) |
 
-### 🛠️ Utilities (5 tools)
+### 📝 Specification Tools (3 tools)
+
+Generate and manage project specifications using Spec-Kit methodology.
+
+| Tool                | Purpose                                                                      | Complexity | Learn More                        |
+| ------------------- | ---------------------------------------------------------------------------- | ---------- | --------------------------------- |
+| `speckit-generator` | Generate complete Spec-Kit artifacts (7 files) with constitutional validation | ⭐⭐⭐     | [Guide](./docs/speckit/README.md) |
+| `validate-spec`     | Validate spec.md against constitutional constraints for compliance           | ⭐⭐       | [Usage](./docs/speckit/usage.md)  |
+| `update-progress`   | Track progress.md updates with completed tasks and metrics                   | ⭐⭐       | [Usage](./docs/speckit/usage.md)  |
+
+**📖 [Spec-Kit Documentation](./docs/speckit/README.md)** - Complete guide to specification-driven development
+
+### 🛠️ Utilities (3 tools)
 
 Supporting tools for workflow optimization.
 
-| Tool                            | Purpose                                                                             | Complexity | Learn More                                             |
-| ------------------------------- | ----------------------------------------------------------------------------------- | ---------- | ------------------------------------------------------ |
-| `memory-context-optimizer`      | Optimize prompt caching and context window usage                                    | ⭐⭐       | [Guide](./docs/tools/memory-context-optimizer.md)      |
-| `mode-switcher`                 | Switch between agent operation modes (planning, debugging, refactoring)             | ⭐         | [Guide](./docs/tools/mode-switcher.md)                 |
-| `prompting-hierarchy-evaluator` | Evaluate prompts with numeric scoring (clarity, specificity, completeness)          | ⭐⭐       | [Guide](./docs/tools/prompting-hierarchy-evaluator.md) |
-| `hierarchy-level-selector`      | Select optimal prompting level for task complexity                                  | ⭐         | [Guide](./docs/tools/hierarchy-level-selector.md)      |
-| `spark-prompt-builder`          | Build UI/UX product prompts with structured inputs (colors, typography, components) | ⭐⭐⭐     | [Guide](./docs/tools/spark-prompt-builder.md)          |
+| Tool                       | Purpose                                                         | Complexity | Learn More                                        |
+| -------------------------- | --------------------------------------------------------------- | ---------- | ------------------------------------------------- |
+| `memory-context-optimizer` | Optimize prompt caching and context window usage                | ⭐⭐       | [Guide](./docs/tools/memory-context-optimizer.md) |
+| `mode-switcher`            | Switch between agent operation modes (planning, debugging, etc.) | ⭐         | [Guide](./docs/tools/mode-switcher.md)            |
+| `spark-prompt-builder`     | Build UI/UX product prompts with structured inputs              | ⭐⭐⭐     | [Guide](./docs/tools/spark-prompt-builder.md)     |
+
+**Deprecated Utilities** (use `prompt-hierarchy` instead):
+
+| Tool                            | Replacement                           | Status                    |
+| ------------------------------- | ------------------------------------- | ------------------------- |
+| `prompting-hierarchy-evaluator` | `prompt-hierarchy` mode=`evaluate`    | ⚠️ Deprecated in v0.14.0  |
+| `hierarchy-level-selector`      | `prompt-hierarchy` mode=`select-level` | ⚠️ Deprecated in v0.14.0  |
+| `quick-developer-prompts-builder` | `prompt-hierarchy` mode=`quick`      | ⚠️ Deprecated in v0.14.0  |
+| `prompt-chaining-builder`       | `prompt-hierarchy` mode=`chain`       | ⚠️ Deprecated in v0.14.0  |
+| `prompt-flow-builder`           | `prompt-hierarchy` mode=`flow`        | ⚠️ Deprecated in v0.14.0  |
 
 **💡 Pro Tip**: Start with ⭐ tools to learn the basics, then progress to ⭐⭐⭐+ tools for advanced workflows.
 
 ---
 
+## Output Strategies
+
+MCP AI Agent Guidelines supports **7 output strategies** for different documentation needs, allowing you to format the same analysis in multiple ways. Additionally, **6 cross-cutting capabilities** can be added to any output format for automation and visualization.
+
+### Available Output Approaches
+
+| Strategy | Best For | Documentation |
+|----------|----------|---------------|
+| **Chat** (Default) | Quick responses, interactive sessions | Simple markdown for LLM chat |
+| **RFC** | Feature proposals, team alignment | Request for Comments format |
+| **ADR** | Architectural decisions, design rationale | Architecture Decision Records |
+| **SDD** | Agile workflows, sprint planning | Spec-Driven Development (spec.md, plan.md, tasks.md) |
+| **SpecKit** | Complex projects, GitHub workflows | Premium `.specify/` directory structure |
+| **TOGAF** | Enterprise architecture, governance | TOGAF ADM deliverables |
+| **Enterprise** | Executive presentations, compliance | Traditional docs (TDD, HLD, LLD) |
+
+### Cross-Cutting Capabilities
+
+Add these to **any** output strategy:
+
+- **workflow** - CI/CD pipeline definitions (GitHub Actions, GitLab CI)
+- **diagram** - Visual documentation (Mermaid, PlantUML)
+- **shell-script** - Automation scripts (Bash, PowerShell)
+- **config** - Configuration files (JSON, YAML)
+- **issues** - GitHub issue templates
+- **pr-template** - Pull request templates
+
+### Usage Example
+
+```typescript
+// Generate SpecKit with workflows and diagrams
+const result = await server.callTool('design-assistant', {
+  action: 'generate-artifacts',
+  sessionId: 'my-session',
+  outputFormat: 'speckit',
+  crossCutting: ['workflow', 'diagram', 'config'],
+});
+```
+
+**📖 [Complete Output Strategies Guide](./docs/output-strategies.md)** - Detailed documentation with examples for all 7 strategies
+
+---
+
 ## VS Code Integration (One-Click)
 
 Use buttons below to add this MCP server to VS Code (User Settings → mcp.servers):

package/dist/agents/definitions/code-scorer-agent.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Code Scorer Agent Definition
+ *
+ * @module agents/definitions/code-scorer-agent
+ */
+import type { AgentDefinition } from "../types.js";
+/**
+ * Agent for analyzing code quality and returning clean code scores.
+ * Provides 0-100 scoring with breakdown by category (hygiene, coverage, TypeScript, etc.).
+ */
+export declare const codeScorerAgent: AgentDefinition;
+//# sourceMappingURL=code-scorer-agent.d.ts.map

package/dist/agents/definitions/code-scorer-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-scorer-agent.d.ts","sourceRoot":"","sources":["../../../src/agents/definitions/code-scorer-agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,eAgC7B,CAAC"}

package/dist/agents/definitions/code-scorer-agent.js

@@ -0,0 +1,42 @@
+/**
+ * Code Scorer Agent Definition
+ *
+ * @module agents/definitions/code-scorer-agent
+ */
+/**
+ * Agent for analyzing code quality and returning clean code scores.
+ * Provides 0-100 scoring with breakdown by category (hygiene, coverage, TypeScript, etc.).
+ */
+export const codeScorerAgent = {
+    name: "code-scorer",
+    description: "Analyzes code quality and returns a 0-100 clean code score with breakdown by category",
+    capabilities: ["code-analysis", "quality-metrics", "scoring"],
+    toolName: "clean-code-scorer",
+    inputSchema: {
+        type: "object",
+        properties: {
+            coverageMetrics: {
+                type: "object",
+                properties: {
+                    lines: { type: "number" },
+                    branches: { type: "number" },
+                    functions: { type: "number" },
+                    statements: { type: "number" },
+                },
+            },
+            projectPath: { type: "string" },
+            codeContent: { type: "string" },
+            language: { type: "string" },
+            framework: { type: "string" },
+        },
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            overallScore: { type: "number" },
+            breakdown: { type: "object" },
+            recommendations: { type: "array" },
+        },
+    },
+};
+//# sourceMappingURL=code-scorer-agent.js.map

package/dist/agents/definitions/code-scorer-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-scorer-agent.js","sourceRoot":"","sources":["../../../src/agents/definitions/code-scorer-agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC/C,IAAI,EAAE,aAAa;IACnB,WAAW,EACV,uFAAuF;IACxF,YAAY,EAAE,CAAC,eAAe,EAAE,iBAAiB,EAAE,SAAS,CAAC;IAC7D,QAAQ,EAAE,mBAAmB;IAC7B,WAAW,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACX,eAAe,EAAE;gBAChB,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACX,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC5B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC7B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC9B;aACD;YACD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC/B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC/B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC5B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC7B;KACD;IACD,YAAY,EAAE;QACb,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACX,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAChC,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC7B,eAAe,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;SAClC;KACD;CACD,CAAC"}

package/dist/agents/definitions/design-agent.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Design Assistant Agent Definition
+ *
+ * @module agents/definitions/design-agent
+ */
+import type { AgentDefinition } from "../types.js";
+/**
+ * Agent for orchestrating multi-phase design workflows.
+ * Manages design sessions with constraint validation, coverage enforcement, and artifact generation.
+ */
+export declare const designAgent: AgentDefinition;
+//# sourceMappingURL=design-agent.d.ts.map

package/dist/agents/definitions/design-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-agent.d.ts","sourceRoot":"","sources":["../../../src/agents/definitions/design-agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,eAqDzB,CAAC"}

package/dist/agents/definitions/design-agent.js

@@ -0,0 +1,63 @@
+/**
+ * Design Assistant Agent Definition
+ *
+ * @module agents/definitions/design-agent
+ */
+/**
+ * Agent for orchestrating multi-phase design workflows.
+ * Manages design sessions with constraint validation, coverage enforcement, and artifact generation.
+ */
+export const designAgent = {
+    name: "design-assistant",
+    description: "Orchestrates multi-phase design workflows with constraint validation",
+    capabilities: ["design", "architecture", "specification", "planning"],
+    toolName: "design-assistant",
+    inputSchema: {
+        type: "object",
+        properties: {
+            action: {
+                type: "string",
+                enum: [
+                    "start-session",
+                    "advance-phase",
+                    "validate-phase",
+                    "evaluate-pivot",
+                    "generate-strategic-pivot-prompt",
+                    "generate-artifacts",
+                    "enforce-coverage",
+                    "enforce-consistency",
+                    "get-status",
+                    "load-constraints",
+                    "select-methodology",
+                    "enforce-cross-session-consistency",
+                    "generate-enforcement-prompts",
+                    "generate-constraint-documentation",
+                    "generate-context-aware-guidance",
+                ],
+            },
+            sessionId: { type: "string" },
+            config: {
+                type: "object",
+                properties: {
+                    context: { type: "string" },
+                    goal: { type: "string" },
+                    requirements: { type: "array", items: { type: "string" } },
+                    sessionId: { type: "string" },
+                    coverageThreshold: { type: "number" },
+                    enablePivots: { type: "boolean" },
+                    outputFormats: { type: "array", items: { type: "string" } },
+                    templateRefs: { type: "array", items: { type: "string" } },
+                },
+            },
+            phaseId: { type: "string" },
+            content: { type: "string" },
+            constraintId: { type: "string" },
+            artifactTypes: {
+                type: "array",
+                items: { type: "string", enum: ["adr", "specification", "roadmap"] },
+            },
+        },
+        required: ["action", "sessionId"],
+    },
+};
+//# sourceMappingURL=design-agent.js.map

package/dist/agents/definitions/design-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-agent.js","sourceRoot":"","sources":["../../../src/agents/definitions/design-agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAoB;IAC3C,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACV,sEAAsE;IACvE,YAAY,EAAE,CAAC,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,CAAC;IACrE,QAAQ,EAAE,kBAAkB;IAC5B,WAAW,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACX,MAAM,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE;oBACL,eAAe;oBACf,eAAe;oBACf,gBAAgB;oBAChB,gBAAgB;oBAChB,iCAAiC;oBACjC,oBAAoB;oBACpB,kBAAkB;oBAClB,qBAAqB;oBACrB,YAAY;oBACZ,kBAAkB;oBAClB,oBAAoB;oBACpB,mCAAmC;oBACnC,8BAA8B;oBAC9B,mCAAmC;oBACnC,iCAAiC;iBACjC;aACD;YACD,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC7B,MAAM,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACX,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC3B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACxB,YAAY,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;oBAC1D,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC7B,iBAAiB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACrC,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;oBACjC,aAAa,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;oBAC3D,YAAY,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;iBAC1D;aACD;YACD,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC3B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC3B,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAChC,aAAa,EAAE;gBACd,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,SAAS,CAAC,EAAE;aACpE;SACD;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;KACjC;CACD,CAAC"}

package/dist/agents/definitions/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Default agent definitions - barrel export and registration
+ *
+ * @module agents/definitions
+ */
+/**
+ * Array of all default agent definitions to be registered.
+ */
+export declare const defaultAgents: import("../types.js").AgentDefinition[];
+/**
+ * Registers all default agents with the agent registry.
+ * Should be called during server startup.
+ */
+export declare function registerDefaultAgents(): void;
+export { codeScorerAgent } from "./code-scorer-agent.js";
+export { designAgent } from "./design-agent.js";
+export { securityAgent } from "./security-agent.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH;;GAEG;AACH,eAAO,MAAM,aAAa,yCAAgD,CAAC;AAE3E;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C;AAGD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/agents/definitions/index.js

@@ -0,0 +1,27 @@
+/**
+ * Default agent definitions - barrel export and registration
+ *
+ * @module agents/definitions
+ */
+import { agentRegistry } from "../registry.js";
+import { codeScorerAgent } from "./code-scorer-agent.js";
+import { designAgent } from "./design-agent.js";
+import { securityAgent } from "./security-agent.js";
+/**
+ * Array of all default agent definitions to be registered.
+ */
+export const defaultAgents = [codeScorerAgent, securityAgent, designAgent];
+/**
+ * Registers all default agents with the agent registry.
+ * Should be called during server startup.
+ */
+export function registerDefaultAgents() {
+    for (const agent of defaultAgents) {
+        agentRegistry.registerAgent(agent);
+    }
+}
+// Export individual agent definitions
+export { codeScorerAgent } from "./code-scorer-agent.js";
+export { designAgent } from "./design-agent.js";
+export { securityAgent } from "./security-agent.js";
+//# sourceMappingURL=index.js.map

package/dist/agents/definitions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,eAAe,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;AAE3E;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACpC,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QACnC,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;AACF,CAAC;AAED,sCAAsC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/agents/definitions/security-agent.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Security Analyzer Agent Definition
+ *
+ * @module agents/definitions/security-agent
+ */
+import type { AgentDefinition } from "../types.js";
+/**
+ * Agent for generating security analysis prompts with OWASP/NIST compliance.
+ * Creates structured prompts for vulnerability assessment and security hardening.
+ */
+export declare const securityAgent: AgentDefinition;
+//# sourceMappingURL=security-agent.d.ts.map

package/dist/agents/definitions/security-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security-agent.d.ts","sourceRoot":"","sources":["../../../src/agents/definitions/security-agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,eA6D3B,CAAC"}

package/dist/agents/definitions/security-agent.js

@@ -0,0 +1,71 @@
+/**
+ * Security Analyzer Agent Definition
+ *
+ * @module agents/definitions/security-agent
+ */
+/**
+ * Agent for generating security analysis prompts with OWASP/NIST compliance.
+ * Creates structured prompts for vulnerability assessment and security hardening.
+ */
+export const securityAgent = {
+    name: "security-analyzer",
+    description: "Generates security analysis prompts with OWASP/NIST compliance checks",
+    capabilities: ["security", "compliance", "owasp", "prompt-generation"],
+    toolName: "security-hardening-prompt-builder",
+    inputSchema: {
+        type: "object",
+        properties: {
+            codeContext: { type: "string" },
+            securityFocus: {
+                type: "string",
+                enum: [
+                    "vulnerability-analysis",
+                    "security-hardening",
+                    "compliance-check",
+                    "threat-modeling",
+                    "penetration-testing",
+                ],
+            },
+            complianceStandards: {
+                type: "array",
+                items: {
+                    type: "string",
+                    enum: [
+                        "OWASP-Top-10",
+                        "NIST-Cybersecurity-Framework",
+                        "ISO-27001",
+                        "SOC-2",
+                        "GDPR",
+                        "HIPAA",
+                        "PCI-DSS",
+                        "NIS2",
+                        "ISO-42001",
+                        "CMMC",
+                    ],
+                },
+            },
+            analysisScope: {
+                type: "array",
+                items: {
+                    type: "string",
+                    enum: [
+                        "input-validation",
+                        "authentication",
+                        "authorization",
+                        "data-encryption",
+                        "session-management",
+                        "error-handling",
+                        "logging-monitoring",
+                        "dependency-security",
+                        "configuration-security",
+                        "api-security",
+                    ],
+                },
+            },
+            language: { type: "string" },
+            framework: { type: "string" },
+        },
+        required: ["codeContext"],
+    },
+};
+//# sourceMappingURL=security-agent.js.map

package/dist/agents/definitions/security-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security-agent.js","sourceRoot":"","sources":["../../../src/agents/definitions/security-agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAoB;IAC7C,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACV,uEAAuE;IACxE,YAAY,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,CAAC;IACtE,QAAQ,EAAE,mCAAmC;IAC7C,WAAW,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACX,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC/B,aAAa,EAAE;gBACd,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE;oBACL,wBAAwB;oBACxB,oBAAoB;oBACpB,kBAAkB;oBAClB,iBAAiB;oBACjB,qBAAqB;iBACrB;aACD;YACD,mBAAmB,EAAE;gBACpB,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE;wBACL,cAAc;wBACd,8BAA8B;wBAC9B,WAAW;wBACX,OAAO;wBACP,MAAM;wBACN,OAAO;wBACP,SAAS;wBACT,MAAM;wBACN,WAAW;wBACX,MAAM;qBACN;iBACD;aACD;YACD,aAAa,EAAE;gBACd,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE;wBACL,kBAAkB;wBAClB,gBAAgB;wBAChB,eAAe;wBACf,iBAAiB;wBACjB,oBAAoB;wBACpB,gBAAgB;wBAChB,oBAAoB;wBACpB,qBAAqB;wBACrB,wBAAwB;wBACxB,cAAc;qBACd;iBACD;aACD;YACD,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC5B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC7B;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KACzB;CACD,CAAC"}

package/dist/agents/execution-graph.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Execution Graph - Observability for agent orchestration
+ *
+ * Tracks handoffs between agents and generates visualization diagrams
+ * for debugging complex workflows and understanding execution flow.
+ *
+ * @module agents/execution-graph
+ */
+/**
+ * Record of a single handoff between agents
+ */
+export interface HandoffRecord {
+    /** Unique identifier for this handoff */
+    id: string;
+    /** Name of the agent initiating the handoff (undefined for user) */
+    sourceAgent?: string;
+    /** Name of the target agent receiving the handoff */
+    targetAgent: string;
+    /** Timestamp when the handoff occurred */
+    timestamp: Date;
+    /** Time in milliseconds to execute the handoff */
+    executionTime: number;
+    /** Whether the handoff completed successfully */
+    success: boolean;
+    /** Error message if the handoff failed */
+    error?: string;
+}
+/**
+ * Configuration options for ExecutionGraph
+ */
+export interface ExecutionGraphOptions {
+    /** Maximum number of records to keep in memory (default: 100) */
+    maxRecords?: number;
+}
+/**
+ * ExecutionGraph tracks agent handoffs and generates visualization diagrams.
+ *
+ * Maintains a rolling buffer of handoff records and can generate Mermaid
+ * diagrams for visualizing execution flow.
+ */
+export declare class ExecutionGraph {
+    private records;
+    private readonly maxRecords;
+    /**
+     * Creates a new ExecutionGraph instance.
+     *
+     * @param options - Configuration options
+     */
+    constructor(options?: ExecutionGraphOptions);
+    /**
+     * Records a handoff between agents.
+     *
+     * Automatically assigns an ID and timestamp. Maintains a rolling buffer
+     * of records up to maxRecords.
+     *
+     * @param record - Handoff data without id and timestamp
+     */
+    recordHandoff(record: Omit<HandoffRecord, "id" | "timestamp">): void;
+    /**
+     * Returns a copy of all recorded handoffs.
+     *
+     * @returns Array of handoff records
+     */
+    getRecords(): HandoffRecord[];
+    /**
+     * Generates a Mermaid flowchart diagram of the execution graph.
+     *
+     * Shows agent handoffs with execution time and error states.
+     *
+     * @returns Mermaid diagram syntax
+     */
+    toMermaid(): string;
+    /**
+     * Generates a Mermaid sequence diagram of the execution graph.
+     *
+     * Shows chronological handoffs between agents with execution time.
+     *
+     * @returns Mermaid sequence diagram syntax
+     */
+    toSequenceDiagram(): string;
+    /**
+     * Clears all recorded handoffs.
+     */
+    clear(): void;
+    /**
+     * Generates a unique ID for a handoff record.
+     *
+     * @returns Unique identifier string
+     */
+    private generateId;
+}
+/**
+ * Singleton instance of ExecutionGraph.
+ * Use this export for global execution graph tracking.
+ */
+export declare const executionGraph: ExecutionGraph;
+//# sourceMappingURL=execution-graph.d.ts.map

package/dist/agents/execution-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-graph.d.ts","sourceRoot":"","sources":["../../src/agents/execution-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IAEX,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IAEpB,0CAA0C;IAC1C,SAAS,EAAE,IAAI,CAAC;IAEhB,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC;IAEtB,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC;IAEjB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IAC1B,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC;;;;OAIG;gBACS,OAAO,CAAC,EAAE,qBAAqB;IAI3C;;;;;;;OAOG;IACH,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,IAAI;IAapE;;;;OAIG;IACH,UAAU,IAAI,aAAa,EAAE;IAI7B;;;;;;OAMG;IACH,SAAS,IAAI,MAAM;IAqBnB;;;;;;OAMG;IACH,iBAAiB,IAAI,MAAM;IA+B3B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACH,OAAO,CAAC,UAAU;CAGlB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,gBAAuB,CAAC"}