@identikey/coding-mcp 2.0.1

package/build/personas/sentinel/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Sentinel — Security/AuthZ/AuthN/Threat Modeling
+ * Mission: Build in security and privacy from the outset, enabling speed without handing keys to attackers.
+ */
+import { BasePersona, PersonaContext } from "../types.js";
+export declare class SentinelPersona extends BasePersona {
+    constructor();
+    enhanceSystemPrompt(basePrompt: string, _context: PersonaContext): string;
+    enhanceUserPrompt(userPrompt: string, _context: PersonaContext): string;
+}
+declare const sentinel: SentinelPersona;
+export default sentinel;
+//# sourceMappingURL=index.d.ts.map

package/build/personas/sentinel/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/personas/sentinel/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAiB,MAAM,aAAa,CAAC;AAuCzE,qBAAa,eAAgB,SAAQ,WAAW;;IAU9C,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM;IAkBzE,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM;CAGxE;AAID,QAAA,MAAM,QAAQ,iBAAwB,CAAC;AAGvC,eAAe,QAAQ,CAAC"}

package/build/personas/sentinel/index.js

@@ -0,0 +1,62 @@
+/**
+ * Sentinel — Security/AuthZ/AuthN/Threat Modeling
+ * Mission: Build in security and privacy from the outset, enabling speed without handing keys to attackers.
+ */
+import { BasePersona } from "../types.js";
+const sentinelTraits = {
+    personality: "a sober security engineer who integrates controls that enable fast delivery without compromising boundaries",
+    communicationStyle: {
+        formality: "formal",
+        humor: "serious",
+        tone: ["risk-first", "precise", "policy-as-code"],
+    },
+    preferredProvider: "openai",
+    providerPreferences: {
+        reasoning: "medium",
+        temperature: 0.25,
+    },
+    expertise: [
+        "AuthN/AuthZ (OIDC/OAuth2.1, tokens, RBAC/ABAC/ReBAC)",
+        "Threat modeling (STRIDE/LINDDUN, abuse cases, risk rating)",
+        "AppSec (XSS/CSRF/SSRF, rate limits, CSP, headers)",
+        "Secrets & crypto (KMS/HSM, rotation, mTLS, envelope encryption)",
+        "Platform security (segmentation, egress, zero trust, WAF)",
+        "Supply chain & audit (SBOM, signing, scanning, audit logs)",
+    ],
+    quirks: [
+        "Starts with assumptions; ends with tests and gates",
+        "Refuses long-lived tokens without justification",
+        "Insists on least privilege and tamper-evident logs",
+    ],
+    catchphrases: {
+        greeting: ["Assumptions first."],
+        conclusion: ["Controls in place; attack replay blocked."],
+    },
+};
+export class SentinelPersona extends BasePersona {
+    constructor() {
+        super("sentinel", "Sentinel", "Security strategist for auth boundaries, controls, and validation", sentinelTraits);
+    }
+    enhanceSystemPrompt(basePrompt, _context) {
+        let enhanced = basePrompt;
+        enhanced += this.buildPersonalityInstructions();
+        enhanced += "\n### Method:\n";
+        enhanced += "1) List assumptions and assets.\n";
+        enhanced += "2) Identify threats and cheapest effective controls.\n";
+        enhanced += "3) Specify policies and integration points.\n";
+        enhanced += "4) Provide tests and gates.\n";
+        enhanced += "\n### Output Style:\n";
+        enhanced += "- Controls as steps; policies as code where possible.\n";
+        enhanced +=
+            "- End with `Validate:` (attack replay, scanner, policy tests).\n";
+        return enhanced;
+    }
+    enhanceUserPrompt(userPrompt, _context) {
+        return `${userPrompt}\n\nProvide: auth boundary design, controls list, policy/code hooks, and Validate.`;
+    }
+}
+// Auto-register Sentinel
+import { PersonaRegistry } from "../types.js";
+const sentinel = new SentinelPersona();
+PersonaRegistry.register(sentinel);
+export default sentinel;

package/build/personas/types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Core persona types and interfaces
+ */
+export interface PersonaTraits {
+    /** Core personality descriptor */
+    personality?: string;
+    /** Communication style preferences */
+    communicationStyle?: {
+        formality: "formal" | "casual" | "mixed";
+        humor: "dry" | "playful" | "serious";
+        tone?: string[];
+    };
+    /** Expertise areas and knowledge domains */
+    expertise: string[];
+    /** Behavioral quirks and patterns */
+    quirks?: string[];
+    /** Catchphrases or signature expressions */
+    catchphrases?: Record<string, string[]>;
+    /** Preferred AI provider for this persona */
+    preferredProvider?: "xai" | "openai";
+    /** Provider-specific preferences */
+    providerPreferences?: {
+        reasoning?: "low" | "medium" | "high";
+        temperature?: number;
+        maxTokens?: number;
+    };
+}
+export type ToneStyle = "concise" | "detailed" | "humorous" | "straight";
+export type OutputFormat = "tldr" | "detailed" | "dual";
+export type AudienceLevel = "beginner" | "intermediate" | "expert" | "auto";
+export interface PersonaContext {
+    /** Current task being addressed */
+    task: string;
+    /** Type of analysis being performed */
+    analysisType: "comprehensive" | "advice" | "research" | "review";
+    /** User's interaction history (if available) */
+    conversationContext?: string[];
+    /** Reasoning effort level */
+    reasoningEffort?: "low" | "medium" | "high";
+    /** Tone control for response style */
+    toneStyle?: ToneStyle;
+    /** Output format preference */
+    outputFormat?: OutputFormat;
+    /** Target audience level */
+    audienceLevel?: AudienceLevel;
+    /** Include visual diagrams if applicable */
+    includeDiagrams?: boolean;
+    /** User's constraints or context for empathy */
+    userConstraints?: string;
+    /** Override provider for this request */
+    providerOverride?: "xai" | "openai";
+}
+export interface Persona {
+    /** Unique identifier for the persona */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Brief description of the persona */
+    description: string;
+    /** Personality traits and characteristics */
+    traits: PersonaTraits;
+    /** Generate persona-specific system prompt additions */
+    enhanceSystemPrompt(basePrompt: string, context: PersonaContext): string;
+    /** Transform/enhance user prompts with persona flavor */
+    enhanceUserPrompt(userPrompt: string, context: PersonaContext): string;
+    /** Post-process responses to add persona character */
+    processResponse?(response: string, context: PersonaContext): string;
+    /** Format response according to output preferences */
+    formatOutput?(response: string, context: PersonaContext): string;
+}
+export declare abstract class BasePersona implements Persona {
+    id: string;
+    name: string;
+    description: string;
+    traits: PersonaTraits;
+    constructor(id: string, name: string, description: string, traits: PersonaTraits);
+    abstract enhanceSystemPrompt(basePrompt: string, context: PersonaContext): string;
+    abstract enhanceUserPrompt(userPrompt: string, context: PersonaContext): string;
+    /** Optional response processing - can be overridden by specific personas */
+    processResponse(response: string, context: PersonaContext): string;
+    /** Helper to build personality instruction block */
+    protected buildPersonalityInstructions(): string;
+}
+/** Registry to manage available personas */
+export declare class PersonaRegistry {
+    private static personas;
+    static register(persona: Persona): void;
+    static get(id: string): Persona | undefined;
+    static list(): Persona[];
+}
+//# sourceMappingURL=types.d.ts.map

package/build/personas/types.d.ts.map

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

package/build/personas/types.js

@@ -0,0 +1,60 @@
+/**
+ * Core persona types and interfaces
+ */
+export class BasePersona {
+    id;
+    name;
+    description;
+    traits;
+    constructor(id, name, description, traits) {
+        this.id = id;
+        this.name = name;
+        this.description = description;
+        this.traits = traits;
+    }
+    /** Optional response processing - can be overridden by specific personas */
+    processResponse(response, context) {
+        return response;
+    }
+    /** Helper to build personality instruction block */
+    buildPersonalityInstructions() {
+        const { personality, communicationStyle, quirks, catchphrases } = this.traits;
+        let instructions = `\n## Persona: ${this.name}\n`;
+        instructions += `You are ${personality}\n\n`;
+        if (communicationStyle) {
+            instructions += `### Communication Style:\n`;
+            instructions += `- Formality: ${communicationStyle.formality}\n`;
+            instructions += `- Humor: ${communicationStyle.humor}\n`;
+            if (communicationStyle.tone) {
+                instructions += `- Tone: ${communicationStyle.tone.join(", ")}\n`;
+            }
+        }
+        if (quirks && quirks.length > 0) {
+            instructions += `\n### Behavioral Patterns:\n`;
+            quirks.forEach(quirk => {
+                instructions += `- ${quirk}\n`;
+            });
+        }
+        if (catchphrases && Object.keys(catchphrases).length > 0) {
+            instructions += `\n### Signature Expressions:\n`;
+            instructions += `Use these phrases naturally when appropriate:\n`;
+            Object.entries(catchphrases).forEach(([context, phrases]) => {
+                instructions += `- ${context}: ${phrases.join(", ")}\n`;
+            });
+        }
+        return instructions;
+    }
+}
+/** Registry to manage available personas */
+export class PersonaRegistry {
+    static personas = new Map();
+    static register(persona) {
+        this.personas.set(persona.id, persona);
+    }
+    static get(id) {
+        return this.personas.get(id);
+    }
+    static list() {
+        return Array.from(this.personas.values());
+    }
+}

package/build/personas/xavier/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Xavier - Pragmatic MVP strategist; favors simplest path that works now
+ * Default Provider: xAI (Grok / Grok-4)
+ * Note: Operates in normal business context; never mentions psychic powers or the X‑Men.
+ */
+import { BasePersona, PersonaContext } from "../types.js";
+export declare class XavierPersona extends BasePersona {
+    constructor();
+    enhanceSystemPrompt(basePrompt: string, context: PersonaContext): string;
+    enhanceUserPrompt(userPrompt: string, context: PersonaContext): string;
+}
+declare const xavier: XavierPersona;
+export default xavier;
+//# sourceMappingURL=index.d.ts.map

package/build/personas/xavier/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/personas/xavier/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAiB,MAAM,aAAa,CAAC;AAwCzE,qBAAa,aAAc,SAAQ,WAAW;;IAU5C,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM;IA6BxE,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM;CAWvE;AAID,QAAA,MAAM,MAAM,eAAsB,CAAC;AAGnC,eAAe,MAAM,CAAC"}

package/build/personas/xavier/index.js

@@ -0,0 +1,80 @@
+/**
+ * Xavier - Pragmatic MVP strategist; favors simplest path that works now
+ * Default Provider: xAI (Grok / Grok-4)
+ * Note: Operates in normal business context; never mentions psychic powers or the X‑Men.
+ */
+import { BasePersona } from "../types.js";
+const xavierTraits = {
+    personality: "a pragmatic builder who hunts for the minimum viable path that avoids traps. Speaks plainly, spots yak-shaves, and optimizes for momentum over ceremony",
+    communicationStyle: {
+        formality: "mixed",
+        humor: "serious",
+        tone: ["calm", "precise", "assured", "insightful"],
+    },
+    // Default to xAI → Grok for brisk advisory style
+    preferredProvider: "xai",
+    providerPreferences: {
+        temperature: 0.5,
+    },
+    expertise: [
+        "MVP scoping and slicing",
+        "risk triage and deferral",
+        "KISS-first design",
+        "guardrails to avoid lock-in",
+        "thin-vertical implementation",
+        "delivery sequencing",
+    ],
+    quirks: [
+        "Defaults to smallest coherent slice; flags overengineering",
+        "Calls out 'enterprise overengineering' explicitly and recommends scoping down unless requirements demand complexity",
+        "Calls out assumptions and proposes quick validations",
+        "Keeps options open; avoids irreversible commitments early",
+    ],
+    catchphrases: {
+        greeting: ["Scope the smallest thing."],
+        conclusion: ["Ship the slice; iterate."],
+    },
+};
+export class XavierPersona extends BasePersona {
+    constructor() {
+        super("xavier", "Xavier", "A hyper-perceptive analyst who delivers exactly the information needed, succinctly", xavierTraits);
+    }
+    enhanceSystemPrompt(basePrompt, context) {
+        let enhanced = basePrompt;
+        // Personality instructions and strict cover constraints
+        enhanced += this.buildPersonalityInstructions();
+        enhanced += `\n### Operating Constraints:\n`;
+        enhanced += `- Operate in a normal business context at all times.\n`;
+        enhanced += `- Never mention psychic abilities, mutants, or the X-Men.\n`;
+        enhanced += `- Present insights as careful analysis, not supernatural intuition.\n`;
+        enhanced += `- Call out enterprise overengineering when detected; prefer simpler designs unless hard requirements (compliance, scale, latency, data integrity) mandate complexity.\n`;
+        // Response goals: scope → choose → cut → ship
+        enhanced += `\n### Method:\n`;
+        enhanced += `1) Scope: restate the objective and the thinnest viable slice.\n`;
+        enhanced += `2) Choose: pick the simplest approach that works rn.\n`;
+        enhanced += `3) Cut: list what to defer; name guardrails to avoid paint‑ins.\n`;
+        enhanced += `4) Ship: exact next steps to deliver in hours, not weeks.\n`;
+        // Output shaping
+        enhanced += `\n### Output Style:\n`;
+        enhanced += `- Start with 3-6 bullets max.\n`;
+        enhanced += `- Prefer dead-simple steps, not grand plans.\n`;
+        enhanced += `- Mark assumptions and the fastest validation path.\n`;
+        enhanced += `- Call out future-proofing only when cheap.\n`;
+        enhanced += `- If proposing complexity, name the exact requirement that forces it and include a 'scope down' variant.\n`;
+        return enhanced;
+    }
+    enhanceUserPrompt(userPrompt, context) {
+        const audience = context.audienceLevel || "auto";
+        const level = audience === "expert"
+            ? "expert"
+            : audience === "beginner"
+                ? "beginner"
+                : "mixed";
+        return `${userPrompt}\n\nPlease provide:\n- Key points and decision-ready recommendations\n- Assumptions/unknowns with validation steps\n- Next actions (owner, effort, risk)\n\nAudience: ${level}.`;
+    }
+}
+// Auto-register Xavier
+import { PersonaRegistry } from "../types.js";
+const xavier = new XavierPersona();
+PersonaRegistry.register(xavier);
+export default xavier;

package/build/prompts/architectPrompts.d.ts

@@ -0,0 +1,5 @@
+/**
+ * System prompts for the architect tool
+ */
+export declare const ARCHITECT_SYSTEM_PROMPT = "You are an expert software architect with deep knowledge of design patterns, anti-patterns, scalable software design principles, and modern development practices. Your task is to conduct a comprehensive architectural review and generate actionable improvement plans.\n\n## Analysis Framework\nStructure your response with these sections:\n\n### Executive Summary\nProvide a prioritized checklist of key recommendations with impact/urgency ratings.\n\n### Architectural Overview\nExamine the overall system design, module interdependencies, and cross-cutting concerns. Consider:\n- Architecture patterns (monolithic, microservices, layered, etc.)\n- Technology stack appropriateness and constraints\n- Domain-specific requirements and regulatory considerations\n- Scalability and performance architecture\n\n### Code Quality & Maintainability\nAnalyze code structure, patterns, and anti-patterns:\n- SOLID, DRY, KISS, YAGNI principle adherence\n- Identify anti-patterns and deprecated practices with impact assessment\n- Code organization, naming conventions, and documentation quality\n- Modularity, coupling, cohesion, and separation of concerns\n\n### Security & Performance\nEvaluate:\n- Security vulnerabilities and attack vectors\n- Performance bottlenecks and optimization opportunities\n- Resource utilization and scalability constraints\n- Error handling robustness and fault tolerance\n\n### Testing & Documentation\nAssess:\n- Test coverage, strategy, and quality\n- Documentation completeness and accuracy\n- CI/CD integration and deployment practices\n\n### Alternative Solutions\nFor significant issues, provide multiple design options with trade-off analysis (maintainability vs performance, complexity vs scalability, etc.).\n\n### Prioritized Action Plan\nOrganize recommendations by:\n1. **Critical/Immediate**: Security issues, major bugs\n2. **High Impact/Medium Term**: Architecture improvements, performance optimizations\n3. **Long Term/Strategic**: Major refactoring, technology upgrades\n\nFor each action item, include:\n- Specific implementation steps\n- Estimated effort/complexity\n- Dependencies and prerequisites\n- Success criteria and validation methods\n- Fallback options if issues arise\n\n## Context Adaptation\nTailor recommendations based on project context (startup vs enterprise, legacy vs greenfield, team size, etc.). Ask clarifying questions if the task description lacks sufficient context for optimal recommendations.\n\nProvide both strategic architectural guidance and tactical code-level improvements that a coding agent can implement effectively.";
+//# sourceMappingURL=architectPrompts.d.ts.map

package/build/prompts/architectPrompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architectPrompts.d.ts","sourceRoot":"","sources":["../../src/prompts/architectPrompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,uBAAuB,wiFAsD8F,CAAC"}

package/build/prompts/architectPrompts.js

@@ -0,0 +1,58 @@
+/**
+ * System prompts for the architect tool
+ */
+export const ARCHITECT_SYSTEM_PROMPT = `You are an expert software architect with deep knowledge of design patterns, anti-patterns, scalable software design principles, and modern development practices. Your task is to conduct a comprehensive architectural review and generate actionable improvement plans.
+
+## Analysis Framework
+Structure your response with these sections:
+
+### Executive Summary
+Provide a prioritized checklist of key recommendations with impact/urgency ratings.
+
+### Architectural Overview
+Examine the overall system design, module interdependencies, and cross-cutting concerns. Consider:
+- Architecture patterns (monolithic, microservices, layered, etc.)
+- Technology stack appropriateness and constraints
+- Domain-specific requirements and regulatory considerations
+- Scalability and performance architecture
+
+### Code Quality & Maintainability
+Analyze code structure, patterns, and anti-patterns:
+- SOLID, DRY, KISS, YAGNI principle adherence
+- Identify anti-patterns and deprecated practices with impact assessment
+- Code organization, naming conventions, and documentation quality
+- Modularity, coupling, cohesion, and separation of concerns
+
+### Security & Performance
+Evaluate:
+- Security vulnerabilities and attack vectors
+- Performance bottlenecks and optimization opportunities
+- Resource utilization and scalability constraints
+- Error handling robustness and fault tolerance
+
+### Testing & Documentation
+Assess:
+- Test coverage, strategy, and quality
+- Documentation completeness and accuracy
+- CI/CD integration and deployment practices
+
+### Alternative Solutions
+For significant issues, provide multiple design options with trade-off analysis (maintainability vs performance, complexity vs scalability, etc.).
+
+### Prioritized Action Plan
+Organize recommendations by:
+1. **Critical/Immediate**: Security issues, major bugs
+2. **High Impact/Medium Term**: Architecture improvements, performance optimizations
+3. **Long Term/Strategic**: Major refactoring, technology upgrades
+
+For each action item, include:
+- Specific implementation steps
+- Estimated effort/complexity
+- Dependencies and prerequisites
+- Success criteria and validation methods
+- Fallback options if issues arise
+
+## Context Adaptation
+Tailor recommendations based on project context (startup vs enterprise, legacy vs greenfield, team size, etc.). Ask clarifying questions if the task description lacks sufficient context for optimal recommendations.
+
+Provide both strategic architectural guidance and tactical code-level improvements that a coding agent can implement effectively.`;

package/build/prompts/codeadvicePrompts.d.ts

@@ -0,0 +1,5 @@
+/**
+ * System prompts for the codeadvice tool
+ */
+export declare const CODEADVICE_SYSTEM_PROMPT = "You're an expert software developer. Provide immediate, actionable guidance on the current coding task. Focus on practical improvements, targeted code patterns, or immediate bug fixes.\n\nRespond with:\n\u2022 **Quick Assessment**: One-sentence summary of the main issue or opportunity\n\u2022 **Immediate Actions**: 2-4 bullet points with specific, implementable steps\n\u2022 **Code Examples**: Brief snippets showing the recommended approach (if applicable)\n\u2022 **Why This Helps**: Concise explanation of the benefit\n\u2022 **Next Steps**: Optional follow-up actions if the immediate fix works\n\nKeep it focused, practical, and directly relevant to the code provided. If you need clarification, ask one specific question.";
+//# sourceMappingURL=codeadvicePrompts.d.ts.map

package/build/prompts/codeadvicePrompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeadvicePrompts.d.ts","sourceRoot":"","sources":["../../src/prompts/codeadvicePrompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,wBAAwB,+tBASyF,CAAC"}

package/build/prompts/codeadvicePrompts.js

@@ -0,0 +1,13 @@
+/**
+ * System prompts for the codeadvice tool
+ */
+export const CODEADVICE_SYSTEM_PROMPT = `You're an expert software developer. Provide immediate, actionable guidance on the current coding task. Focus on practical improvements, targeted code patterns, or immediate bug fixes.
+
+Respond with:
+• **Quick Assessment**: One-sentence summary of the main issue or opportunity
+• **Immediate Actions**: 2-4 bullet points with specific, implementable steps
+• **Code Examples**: Brief snippets showing the recommended approach (if applicable)
+• **Why This Helps**: Concise explanation of the benefit
+• **Next Steps**: Optional follow-up actions if the immediate fix works
+
+Keep it focused, practical, and directly relevant to the code provided. If you need clarification, ask one specific question.`;

package/build/prompts/researcherPrompts.d.ts

@@ -0,0 +1,2 @@
+export declare const RESEARCHER_SYSTEM_PROMPT = "You are an expert research assistant specializing in comprehensive information synthesis and source management.\n\nYour core responsibilities:\n1. Synthesize information from multiple sources with critical analysis\n2. Identify patterns, contradictions, and knowledge gaps\n3. Maintain strict source attribution and citation standards\n4. Evaluate source credibility and potential biases\n5. Present findings in a clear, structured format\n\nWhen synthesizing research:\n- **Cross-reference information** across multiple sources\n- **Highlight consensus** where sources agree\n- **Note divergences** where sources conflict\n- **Identify gaps** in available information\n- **Assess credibility** based on source authority and recency\n- **Maintain objectivity** while noting potential biases\n\nCitation standards:\n- Always use [source-id] inline references\n- Group related sources when making claims\n- Distinguish between primary and secondary sources\n- Note publication dates for time-sensitive information\n- Flag unverified or contested claims\n\nQuality indicators to consider:\n- Academic vs. commercial sources\n- Peer-reviewed vs. opinion pieces\n- Primary research vs. aggregated content\n- Author expertise and credentials\n- Publication reputation and impact factor\n\nOutput structure:\n1. **Executive Summary** - Key findings in 2-3 sentences\n2. **Detailed Findings** - Comprehensive analysis with citations\n3. **Conflicting Views** - Areas of disagreement or debate\n4. **Knowledge Gaps** - What couldn't be determined\n5. **Recommendations** - Suggested next steps or areas for deeper research\n\nRemember: Your goal is to provide actionable intelligence, not just information aggregation.";
+//# sourceMappingURL=researcherPrompts.d.ts.map

package/build/prompts/researcherPrompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"researcherPrompts.d.ts","sourceRoot":"","sources":["../../src/prompts/researcherPrompts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,krDAsCwD,CAAC"}

package/build/prompts/researcherPrompts.js

@@ -0,0 +1,39 @@
+export const RESEARCHER_SYSTEM_PROMPT = `You are an expert research assistant specializing in comprehensive information synthesis and source management.
+
+Your core responsibilities:
+1. Synthesize information from multiple sources with critical analysis
+2. Identify patterns, contradictions, and knowledge gaps
+3. Maintain strict source attribution and citation standards
+4. Evaluate source credibility and potential biases
+5. Present findings in a clear, structured format
+
+When synthesizing research:
+- **Cross-reference information** across multiple sources
+- **Highlight consensus** where sources agree
+- **Note divergences** where sources conflict
+- **Identify gaps** in available information
+- **Assess credibility** based on source authority and recency
+- **Maintain objectivity** while noting potential biases
+
+Citation standards:
+- Always use [source-id] inline references
+- Group related sources when making claims
+- Distinguish between primary and secondary sources
+- Note publication dates for time-sensitive information
+- Flag unverified or contested claims
+
+Quality indicators to consider:
+- Academic vs. commercial sources
+- Peer-reviewed vs. opinion pieces
+- Primary research vs. aggregated content
+- Author expertise and credentials
+- Publication reputation and impact factor
+
+Output structure:
+1. **Executive Summary** - Key findings in 2-3 sentences
+2. **Detailed Findings** - Comprehensive analysis with citations
+3. **Conflicting Views** - Areas of disagreement or debate
+4. **Knowledge Gaps** - What couldn't be determined
+5. **Recommendations** - Suggested next steps or areas for deeper research
+
+Remember: Your goal is to provide actionable intelligence, not just information aggregation.`;

package/build/tools/architect.d.ts

@@ -0,0 +1,32 @@
+import { z } from "zod";
+/**
+ * Architect tool
+ *   - Calls an AI model (xAI Grok or OpenAI GPT-5) to generate comprehensive architectural reviews
+ *   - Input: 'task' (description of the task), 'code' (one or more code files concatenated)
+ *   - Provides detailed analysis with executive summary, architectural overview, and prioritized action plans
+ */
+export declare const architectToolName = "architect";
+export declare const architectToolDescription = "Conducts comprehensive architectural reviews and generates detailed improvement plans for codebases.";
+export declare const ArchitectToolSchema: z.ZodObject<{
+    task: z.ZodString;
+    code: z.ZodString;
+    reasoning_effort: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+    persona: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    task: string;
+    reasoning_effort?: "low" | "medium" | "high" | undefined;
+    persona?: string | undefined;
+}, {
+    code: string;
+    task: string;
+    reasoning_effort?: "low" | "medium" | "high" | undefined;
+    persona?: string | undefined;
+}>;
+export declare function runArchitectTool(args: z.infer<typeof ArchitectToolSchema>): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=architect.d.ts.map

package/build/tools/architect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architect.d.ts","sourceRoot":"","sources":["../../src/tools/architect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB;;;;;GAKG;AAEH,eAAO,MAAM,iBAAiB,cAAc,CAAC;AAC7C,eAAO,MAAM,wBAAwB,yGACmE,CAAC;AAEzG,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAiB9B,CAAC;AAEH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC;;;;;GAiD1C"}

package/build/tools/architect.js

@@ -0,0 +1,75 @@
+import { z } from "zod";
+import { callAIProvider } from "../common/apiClient.js";
+import { callAIWithPersona } from "../common/personaClient.js";
+import { chooseProvider, } from "../common/providerConfig.js";
+import { ARCHITECT_SYSTEM_PROMPT } from "../prompts/architectPrompts.js";
+/**
+ * Architect tool
+ *   - Calls an AI model (xAI Grok or OpenAI GPT-5) to generate comprehensive architectural reviews
+ *   - Input: 'task' (description of the task), 'code' (one or more code files concatenated)
+ *   - Provides detailed analysis with executive summary, architectural overview, and prioritized action plans
+ */
+export const architectToolName = "architect";
+export const architectToolDescription = "Conducts comprehensive architectural reviews and generates detailed improvement plans for codebases.";
+export const ArchitectToolSchema = z.object({
+    task: z.string().min(1, "Task description is required."),
+    code: z
+        .string()
+        .min(1, "Code string is required (one or more files concatenated)."),
+    reasoning_effort: z
+        .enum(["low", "medium", "high"])
+        .optional()
+        .describe("How hard the model should think (low/medium/high). High uses more reasoning tokens but provides better analysis."),
+    persona: z
+        .string()
+        .optional()
+        .describe("Persona to apply (e.g., 'charles' for British architect). Leave empty for standard analysis."),
+});
+export async function runArchitectTool(args) {
+    const { task, code, reasoning_effort = "high", persona } = args;
+    try {
+        // Use persona-aware client if persona is specified
+        const result = persona
+            ? await callAIWithPersona({
+                systemPrompt: ARCHITECT_SYSTEM_PROMPT,
+                task,
+                code,
+                analysisType: "comprehensive",
+                reasoningEffort: reasoning_effort,
+                personaId: persona,
+            })
+            : await (async () => {
+                const selectedProvider = chooseProvider({
+                    analysisType: "comprehensive",
+                    reasoningEffort: reasoning_effort,
+                    textHint: task,
+                });
+                return callAIProvider({
+                    systemPrompt: ARCHITECT_SYSTEM_PROMPT,
+                    task,
+                    code,
+                    analysisType: "comprehensive",
+                    reasoningEffort: reasoning_effort,
+                    provider: selectedProvider,
+                });
+            })();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: result,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Architect Error: ${error.message || error}`,
+                },
+            ],
+        };
+    }
+}

package/build/tools/ask.d.ts

@@ -0,0 +1,39 @@
+import { z } from "zod";
+/**
+ * Ask tool - Smart routing to the best persona based on query analysis
+ * Primary UX for natural language interaction with personas
+ */
+export declare const askToolName = "ask";
+export declare const askToolDescription = "Ask a question naturally and get routed to the best expert persona automatically. You can also address a persona directly, e.g., 'ask xavier: <your question>' or 'charles: <your question>' to force that persona.";
+export declare const AskToolSchema: z.ZodObject<{
+    persona_id: z.ZodDefault<z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"auto">, z.ZodString]>>>;
+    query: z.ZodString;
+    context: z.ZodOptional<z.ZodString>;
+    hint: z.ZodOptional<z.ZodString>;
+    explain_routing: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    reasoning_effort: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"low">, z.ZodLiteral<"medium">, z.ZodLiteral<"high">]>>;
+    provider: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"xai">, z.ZodLiteral<"openai">]>>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    persona_id: string;
+    explain_routing: boolean;
+    context?: string | undefined;
+    reasoning_effort?: "low" | "medium" | "high" | undefined;
+    hint?: string | undefined;
+    provider?: "xai" | "openai" | undefined;
+}, {
+    query: string;
+    context?: string | undefined;
+    reasoning_effort?: "low" | "medium" | "high" | undefined;
+    persona_id?: string | undefined;
+    hint?: string | undefined;
+    explain_routing?: boolean | undefined;
+    provider?: "xai" | "openai" | undefined;
+}>;
+export declare function runAskTool(args: z.infer<typeof AskToolSchema>): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=ask.d.ts.map

package/build/tools/ask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask.d.ts","sourceRoot":"","sources":["../../src/tools/ask.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;GAGG;AAEH,eAAO,MAAM,WAAW,QAAQ,CAAC;AACjC,eAAO,MAAM,kBAAkB,wNACwL,CAAC;AAExN,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;EAsCxB,CAAC;AAEH,wBAAsB,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC;;;;;GAiHnE"}