@compilr-dev/cli 0.6.1 → 0.6.3

package/dist/guide/guide-content.js

@@ -1,196 +0,0 @@
-/**
- * Guide Content
- *
- * Documentation for the compilr_guide tool.
- * Uses shared content from shared-content.ts for topics that overlap with tutorials.
- */
-import { CONTENT_TOPICS, topicToPlainText, searchContentTopics, getAllTopicIds, } from './shared-content.js';
-// =============================================================================
-// Guide-Only Entries (not in tutorials)
-// =============================================================================
-const GUIDE_ONLY_ENTRIES = [
-    {
-        id: 'overview',
-        title: 'Compilr Dev CLI Overview',
-        keywords: ['overview', 'what is', 'introduction', 'about', 'compilr'],
-        content: `
-Compilr Dev CLI is an AI-powered coding assistant that helps you build software projects.
-
-Key features:
-- Multi-LLM support (Claude, OpenAI, Gemini, Ollama)
-- Project management with structured workflows
-- Requirements gathering with /design command
-- Backlog tracking with /backlog command
-- Team agents for specialized assistance ($arch, $pm, $qa, etc.)
-- Session persistence and context management
-
-The CLI has two main interfaces:
-1. Dashboard - A menu-based interface for project management
-2. REPL - A command-line interface for chatting with the AI
-
-Run "compilr" to start. Use /help to see all commands.
-`.trim(),
-    },
-    {
-        id: 'workflow-modes',
-        title: 'Workflow Modes',
-        keywords: ['workflow', 'flexible', 'guided', 'mode'],
-        content: `
-Two workflow modes are available:
-
-Flexible (recommended):
-- Work at your own pace
-- AI responds to your requests
-- No enforced structure
-- Best for experienced developers
-
-Guided:
-- AI suggests next steps
-- Tracks work item progress
-- More structured approach
-- Best for learning the workflow
-
-Switch modes with /workflow command.
-
-The footer shows current mode: "mode: Normal" or "mode: Guided"
-`.trim(),
-    },
-    {
-        id: 'workflow-recommended',
-        title: 'Recommended Workflow',
-        keywords: ['workflow', 'how to', 'best practice', 'process'],
-        content: `
-Recommended workflow for new projects:
-
-1. Create project with /new
-   - Choose your tech stack
-   - Set up git repository
-
-2. Plan with /design
-   - Describe what you want to build
-   - AI asks clarifying questions
-   - Generates PRD and backlog items
-
-3. Review backlog with /backlog
-   - See all work items
-   - Prioritize tasks
-   - Pick one to start
-
-4. Build features
-   - Ask AI to implement from backlog
-   - "Build REQ-001: User authentication"
-   - Review and iterate
-
-5. Manage context
-   - Use /compact when context fills up
-   - Add /anchors for important decisions
-   - Use /resume to continue later
-`.trim(),
-    },
-    {
-        id: 'command-resume',
-        title: '/resume Command',
-        keywords: ['/resume', 'resume', 'session', 'continue', 'previous'],
-        content: `
-/resume - Continue a previous session.
-
-Sessions are auto-saved after each AI response.
-
-The overlay shows:
-- Recent: Sessions from current project
-- All: Sessions from all projects
-- Session date, message count, and preview
-
-Actions:
-  j/k      Navigate sessions
-  /        Search sessions
-  Enter    Resume selected session
-  d        Delete session
-  q/Esc    Close
-
-What's saved in a session:
-- Conversation history (all messages)
-- Todo list items
-- Workflow state (mode, current work item)
-- Token usage
-
-What's NOT in sessions (per-project instead):
-- Anchors (persistent across sessions)
-- Team agent configurations
-- Documents (PRD, backlog, etc.)
-
-Cross-project sessions show a warning before resuming.
-`.trim(),
-    },
-    {
-        id: 'command-team',
-        title: '/team Command',
-        keywords: ['/team', 'team', 'agents', 'manage'],
-        content: `
-/team - View and manage team agents.
-
-The overlay shows:
-- All available agents
-- Current agent (marked with ★)
-- Agent status and context usage
-
-Tabs:
-  Agents     List of all agents
-  Context    Per-agent token usage
-
-Switch agents by selecting one and pressing Enter.
-Or use $ prefix in REPL: $arch, $pm, $qa, etc.
-`.trim(),
-    },
-];
-// =============================================================================
-// Combined Guide Entries
-// =============================================================================
-/**
- * Build guide entries from shared content and guide-only entries.
- */
-function buildGuideEntries() {
-    const entries = [...GUIDE_ONLY_ENTRIES];
-    // Convert shared content topics to guide entries
-    for (const topic of CONTENT_TOPICS) {
-        entries.push({
-            id: topic.id,
-            title: topic.title,
-            keywords: topic.keywords,
-            content: topicToPlainText(topic),
-        });
-    }
-    return entries;
-}
-export const guideEntries = buildGuideEntries();
-// =============================================================================
-// Search Functions
-// =============================================================================
-/**
- * Search guide entries by keyword or topic.
- */
-export function searchGuide(query) {
-    const q = query.toLowerCase().trim();
-    // Exact ID match
-    const exactMatch = guideEntries.find((e) => e.id === q);
-    if (exactMatch)
-        return [exactMatch];
-    // Command match (e.g., "/design" or "design")
-    const cmdQuery = q.startsWith('/') ? q : `/${q}`;
-    const cmdMatch = guideEntries.find((e) => e.keywords.includes(cmdQuery) || e.keywords.includes(q));
-    if (cmdMatch)
-        return [cmdMatch];
-    // Keyword search
-    const matches = guideEntries.filter((e) => e.keywords.some((k) => k.includes(q) || q.includes(k)) ||
-        e.title.toLowerCase().includes(q) ||
-        e.content.toLowerCase().includes(q));
-    return matches.slice(0, 3); // Return top 3 matches
-}
-/**
- * Get all available topics for listing.
- */
-export function getGuideTopics() {
-    return guideEntries.map((e) => e.id);
-}
-// Re-export shared content helpers for use elsewhere
-export { searchContentTopics, getAllTopicIds };

package/dist/multi-agent/activity.d.ts

@@ -1,21 +0,0 @@
-/**
- * Activity Recording Module
- *
- * Provides a global function for tools to record team activity.
- * The SharedContextManager is set by the REPL when a team is active.
- */
-import type { SharedContextManager, TeamActivityType } from './shared-context.js';
-/**
- * Set the active SharedContextManager for activity recording
- * Called by the REPL when a team is initialized
- */
-export declare function setActiveSharedContext(ctx: SharedContextManager | null): void;
-/**
- * Get the active SharedContextManager
- */
-export declare function getActiveSharedContext(): SharedContextManager | null;
-/**
- * Record team activity
- * Safe to call even if no team is active (will be a no-op)
- */
-export declare function recordTeamActivity(agentId: string, action: TeamActivityType, summary: string): void;

package/dist/multi-agent/activity.js

@@ -1,34 +0,0 @@
-/**
- * Activity Recording Module
- *
- * Provides a global function for tools to record team activity.
- * The SharedContextManager is set by the REPL when a team is active.
- */
-// Module-level reference to the active SharedContextManager
-let activeSharedContext = null;
-/**
- * Set the active SharedContextManager for activity recording
- * Called by the REPL when a team is initialized
- */
-export function setActiveSharedContext(ctx) {
-    activeSharedContext = ctx;
-}
-/**
- * Get the active SharedContextManager
- */
-export function getActiveSharedContext() {
-    return activeSharedContext;
-}
-/**
- * Record team activity
- * Safe to call even if no team is active (will be a no-op)
- */
-export function recordTeamActivity(agentId, action, summary) {
-    if (activeSharedContext) {
-        activeSharedContext.recordActivity({
-            agentId,
-            action,
-            summary,
-        });
-    }
-}

package/dist/multi-agent/agent-selection.d.ts

@@ -1,55 +0,0 @@
-/**
- * Agent Selection Helpers
- *
- * Provides functions for selecting the best agent for a task:
- * - findAgentForRole: Find an agent by role (LRU selection if multiple)
- * - findAgentById: Find an agent by ID
- * - getAvailableSpecialists: Get all non-default agents
- *
- * Uses Least Recently Used (LRU) selection when multiple agents have the same role.
- * This spreads work across agents and prepares for future background execution
- * where we'll prefer idle agents.
- */
-import type { AgentTeam } from './team.js';
-import type { TeamAgent } from './team-agent.js';
-import type { AgentRole } from './types.js';
-/**
- * Find the best agent for a given role.
- * If multiple agents have the same role, selects the least recently used.
- *
- * @param team - The agent team
- * @param role - The role to find (e.g., 'arch', 'dev', 'qa')
- * @returns The best matching agent, or null if none found
- */
-export declare function findAgentForRole(team: AgentTeam, role: AgentRole): TeamAgent | null;
-/**
- * Find an agent by ID.
- *
- * @param team - The agent team
- * @param id - The agent ID (e.g., 'arch', 'dev-1', 'my-custom-agent')
- * @returns The agent, or null if not found
- */
-export declare function findAgentById(team: AgentTeam, id: string): TeamAgent | null;
-/**
- * Get all specialist agents (non-default agents).
- * Useful for listing available delegation targets.
- *
- * @param team - The agent team
- * @returns Array of specialist agents
- */
-export declare function getAvailableSpecialists(team: AgentTeam): TeamAgent[];
-/**
- * Get a summary of available specialists for the coordinator.
- * Returns a formatted string listing specialists by role.
- *
- * @param team - The agent team
- * @returns Formatted string of available specialists
- */
-export declare function getSpecialistsSummary(team: AgentTeam): string;
-/**
- * Check if the team has any specialists available for delegation.
- *
- * @param team - The agent team
- * @returns True if there are specialist agents
- */
-export declare function hasSpecialists(team: AgentTeam): boolean;

package/dist/multi-agent/agent-selection.js

@@ -1,90 +0,0 @@
-/**
- * Agent Selection Helpers
- *
- * Provides functions for selecting the best agent for a task:
- * - findAgentForRole: Find an agent by role (LRU selection if multiple)
- * - findAgentById: Find an agent by ID
- * - getAvailableSpecialists: Get all non-default agents
- *
- * Uses Least Recently Used (LRU) selection when multiple agents have the same role.
- * This spreads work across agents and prepares for future background execution
- * where we'll prefer idle agents.
- */
-/**
- * Find the best agent for a given role.
- * If multiple agents have the same role, selects the least recently used.
- *
- * @param team - The agent team
- * @param role - The role to find (e.g., 'arch', 'dev', 'qa')
- * @returns The best matching agent, or null if none found
- */
-export function findAgentForRole(team, role) {
-    const agents = team.getAll();
-    // Filter to agents with matching role
-    const candidates = agents.filter((agent) => agent.role === role);
-    if (candidates.length === 0) {
-        return null;
-    }
-    if (candidates.length === 1) {
-        return candidates[0];
-    }
-    // Multiple candidates: select Least Recently Used (LRU)
-    // Sort by lastActivity ascending (oldest first)
-    candidates.sort((a, b) => a.lastActivity.getTime() - b.lastActivity.getTime());
-    return candidates[0];
-}
-/**
- * Find an agent by ID.
- *
- * @param team - The agent team
- * @param id - The agent ID (e.g., 'arch', 'dev-1', 'my-custom-agent')
- * @returns The agent, or null if not found
- */
-export function findAgentById(team, id) {
-    return team.get(id) ?? null;
-}
-/**
- * Get all specialist agents (non-default agents).
- * Useful for listing available delegation targets.
- *
- * @param team - The agent team
- * @returns Array of specialist agents
- */
-export function getAvailableSpecialists(team) {
-    return team.getAll().filter((agent) => agent.id !== 'default');
-}
-/**
- * Get a summary of available specialists for the coordinator.
- * Returns a formatted string listing specialists by role.
- *
- * @param team - The agent team
- * @returns Formatted string of available specialists
- */
-export function getSpecialistsSummary(team) {
-    const specialists = getAvailableSpecialists(team);
-    if (specialists.length === 0) {
-        return 'No specialist agents available. Add agents via /team.';
-    }
-    // Group by role
-    const byRole = new Map();
-    for (const agent of specialists) {
-        const list = byRole.get(agent.role) ?? [];
-        list.push(agent);
-        byRole.set(agent.role, list);
-    }
-    const lines = [];
-    for (const [role, agents] of byRole) {
-        const agentList = agents.map((a) => `$${a.id}`).join(', ');
-        lines.push(`- ${role}: ${agentList}`);
-    }
-    return lines.join('\n');
-}
-/**
- * Check if the team has any specialists available for delegation.
- *
- * @param team - The agent team
- * @returns True if there are specialist agents
- */
-export function hasSpecialists(team) {
-    return getAvailableSpecialists(team).length > 0;
-}

package/dist/multi-agent/artifacts.d.ts

@@ -1,197 +0,0 @@
-/**
- * ArtifactStore - Storage for team artifacts
- *
- * Artifacts are named pieces of work that agents can publish and reference:
- * - design: Architecture, API specs, data models
- * - plan: Sprint plans, task breakdowns, timelines
- * - review: Code reviews, security audits, feedback
- * - decision: Architectural decisions, trade-off analysis
- * - note: General notes, meeting summaries
- */
-/**
- * Artifact types
- */
-export type ArtifactType = 'design' | 'plan' | 'review' | 'decision' | 'note';
-/**
- * Full artifact structure
- */
-export interface Artifact {
-    id: string;
-    name: string;
-    agent: string;
-    type: ArtifactType;
-    content: string;
-    summary: string;
-    version: number;
-    createdAt: Date;
-    updatedAt: Date;
-    mentions: string[];
-    referencedBy: string[];
-}
-/**
- * Artifact summary for the shared context index
- */
-export interface ArtifactSummary {
-    id: string;
-    name: string;
-    agent: string;
-    type: ArtifactType;
-    summary: string;
-    updatedAt: Date;
-}
-/**
- * Options for creating an artifact
- */
-export interface CreateArtifactOptions {
-    name: string;
-    agent: string;
-    type: ArtifactType;
-    content: string;
-    summary?: string;
-}
-/**
- * Options for updating an artifact
- */
-export interface UpdateArtifactOptions {
-    content?: string;
-    summary?: string;
-    type?: ArtifactType;
-}
-/**
- * Serialized artifact for persistence
- */
-export interface SerializedArtifact {
-    id: string;
-    name: string;
-    agent: string;
-    type: ArtifactType;
-    content: string;
-    summary: string;
-    version: number;
-    createdAt: string;
-    updatedAt: string;
-    mentions?: string[];
-    referencedBy?: string[];
-}
-/**
- * Artifact index for persistence
- */
-export interface ArtifactIndex {
-    version: number;
-    artifacts: Array<{
-        id: string;
-        name: string;
-        agent: string;
-        type: ArtifactType;
-        summary: string;
-        updatedAt: string;
-    }>;
-    updatedAt: string;
-}
-/**
- * Manages artifact storage and retrieval
- */
-export declare class ArtifactStore {
-    private readonly basePath;
-    private readonly artifacts;
-    private readonly nameToId;
-    private updatedAt;
-    constructor(basePath: string);
-    /**
-     * Get the artifacts directory path
-     */
-    private getArtifactsDir;
-    /**
-     * Get the index file path
-     */
-    private getIndexPath;
-    /**
-     * Get the path for an artifact file
-     */
-    private getArtifactPath;
-    /**
-     * Ensure artifacts directory exists
-     */
-    private ensureDir;
-    /**
-     * Create a new artifact
-     */
-    create(options: CreateArtifactOptions): Artifact;
-    /**
-     * Get an artifact by ID
-     */
-    get(id: string): Artifact | undefined;
-    /**
-     * Get an artifact by name (case-insensitive)
-     */
-    getByName(name: string): Artifact | undefined;
-    /**
-     * Update an artifact
-     */
-    update(id: string, options: UpdateArtifactOptions): Artifact | undefined;
-    /**
-     * Delete an artifact
-     */
-    delete(id: string): boolean;
-    /**
-     * Rename an artifact
-     */
-    rename(id: string, newName: string): Artifact | undefined;
-    /**
-     * List all artifacts
-     */
-    list(): Artifact[];
-    /**
-     * List artifacts by agent
-     */
-    listByAgent(agent: string): Artifact[];
-    /**
-     * List artifacts by type
-     */
-    listByType(type: ArtifactType): Artifact[];
-    /**
-     * Search artifacts by name or content
-     */
-    search(query: string): Artifact[];
-    /**
-     * Get artifact count
-     */
-    get size(): number;
-    /**
-     * Check if an artifact exists by name
-     */
-    has(name: string): boolean;
-    /**
-     * Check if an artifact exists by ID
-     */
-    hasId(id: string): boolean;
-    /**
-     * Generate a summary from content
-     * Simple extraction of first meaningful lines
-     */
-    private generateSummary;
-    /**
-     * Get summaries for shared context injection
-     */
-    getSummaries(): ArtifactSummary[];
-    /**
-     * Save all artifacts to disk
-     */
-    save(): void;
-    /**
-     * Save just the index file
-     */
-    private saveIndex;
-    /**
-     * Load artifacts from disk
-     */
-    load(): void;
-    /**
-     * Clear all artifacts (including from disk)
-     */
-    clear(): void;
-    /**
-     * Get the last update timestamp
-     */
-    getLastUpdated(): Date;
-}