opencode-athena 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,628 @@
+export { default as OpenCodeAthena, default } from './plugin/index.js';
+import { z } from 'zod';
+import '@opencode-ai/plugin';
+
+/**
+ * Shared TypeScript type definitions for OpenCode Athena
+ */
+/**
+ * Options passed to the install command
+ */
+interface InstallOptions {
+    preset: string;
+    yes: boolean;
+    advanced: boolean;
+    global: boolean;
+    local: boolean;
+}
+/**
+ * Subscription information gathered during install
+ */
+interface SubscriptionAnswers {
+    hasClaude: boolean;
+    claudeTier: "max5x" | "max20x" | "pro" | "none";
+    hasOpenAI: boolean;
+    hasGoogle: boolean;
+    googleAuth: "antigravity" | "personal" | "api" | "none";
+}
+/**
+ * Methodology preferences gathered during install
+ */
+interface MethodologyAnswers {
+    defaultTrack: "quick-flow" | "bmad-method" | "enterprise";
+    autoStatusUpdate: boolean;
+}
+/**
+ * Feature selections gathered during install
+ */
+interface FeatureAnswers {
+    enabledFeatures: string[];
+    mcps: string[];
+}
+/**
+ * Advanced options gathered during install
+ */
+interface AdvancedAnswers {
+    parallelStoryLimit?: number;
+    experimental?: string[];
+}
+/**
+ * Model assignments for each agent role
+ */
+interface ModelAnswers {
+    sisyphus: string;
+    oracle: string;
+    librarian: string;
+    frontend?: string;
+    documentWriter?: string;
+    multimodalLooker?: string;
+}
+/**
+ * All answers from the install wizard
+ */
+interface InstallAnswers {
+    subscriptions: SubscriptionAnswers;
+    models: ModelAnswers;
+    methodology: MethodologyAnswers;
+    features: FeatureAnswers;
+    advanced: AdvancedAnswers;
+    installLocation: "global" | "local";
+}
+/**
+ * Athena configuration file structure
+ */
+interface AthenaConfig {
+    $schema?: string;
+    version: string;
+    subscriptions: {
+        claude: {
+            enabled: boolean;
+            tier: "max5x" | "max20x" | "pro" | "none";
+        };
+        openai: {
+            enabled: boolean;
+        };
+        google: {
+            enabled: boolean;
+            authMethod: "antigravity" | "personal" | "api" | "none";
+        };
+    };
+    models: {
+        sisyphus: string;
+        oracle: string;
+        librarian: string;
+        frontend?: string;
+        documentWriter?: string;
+        multimodalLooker?: string;
+    };
+    bmad: {
+        defaultTrack: "quick-flow" | "bmad-method" | "enterprise";
+        autoStatusUpdate: boolean;
+        parallelStoryLimit: number;
+    };
+    features: {
+        bmadBridge: boolean;
+        autoStatus: boolean;
+        parallelExecution: boolean;
+        notifications: boolean;
+        contextMonitor: boolean;
+        commentChecker: boolean;
+        lspTools: boolean;
+    };
+    mcps: {
+        context7: boolean;
+        exa: boolean;
+        grepApp: boolean;
+    };
+}
+/**
+ * Prerequisites check result
+ */
+interface Prerequisites {
+    opencode: {
+        installed: boolean;
+        version?: string;
+        compatible: boolean;
+    };
+    athena: {
+        installed: boolean;
+        version?: string;
+    };
+    node: {
+        installed: boolean;
+        version?: string;
+        compatible: boolean;
+    };
+}
+/**
+ * Story status in sprint tracking
+ */
+type StoryStatus = "pending" | "in_progress" | "completed" | "blocked" | "needs_review";
+/**
+ * Internal tracker status (includes transitional states)
+ */
+type TrackerStatus = StoryStatus | "loading";
+/**
+ * Tracked story state
+ */
+interface TrackedStory {
+    id: string;
+    content: string;
+    status: TrackerStatus;
+    startedAt: string;
+    completedAt?: string;
+}
+/**
+ * Sprint status structure (from sprint-status.yaml)
+ */
+interface SprintStatus {
+    sprint_number?: number;
+    current_epic?: string;
+    current_story?: string | null;
+    completed_stories: string[];
+    pending_stories: string[];
+    in_progress_stories: string[];
+    blocked_stories: string[];
+    stories_needing_review?: string[];
+    story_updates?: Record<string, {
+        status: StoryStatus;
+        updated_at: string;
+        notes?: string;
+        completion_summary?: string;
+    }>;
+    last_modified?: string;
+}
+/**
+ * Story tracker persistent state
+ */
+interface TrackerState {
+    currentStory: TrackedStory | null;
+    sessionId: string;
+    projectDir: string;
+    history: Array<{
+        storyId: string;
+        status: string;
+        timestamp: string;
+    }>;
+}
+/**
+ * Result from athena_get_story tool
+ */
+interface GetStoryResult {
+    storyId?: string;
+    story?: string;
+    architecture?: string;
+    prd?: string;
+    sprint?: {
+        currentEpic: string;
+        completedStories: number;
+        pendingStories: number;
+        blockedStories: number;
+    };
+    instructions?: string;
+    error?: string;
+    suggestion?: string;
+    sprintProgress?: {
+        completed: number;
+        total: number;
+    };
+}
+/**
+ * Result from athena_update_status tool
+ */
+interface UpdateStatusResult {
+    success?: boolean;
+    storyId?: string;
+    newStatus?: StoryStatus;
+    updatedAt?: string;
+    sprintProgress?: {
+        completed: number;
+        inProgress: number;
+        pending: number;
+        blocked: number;
+        total: number;
+        percentComplete: number;
+    };
+    nextStory?: string | null;
+    error?: string;
+}
+
+/**
+ * Complete Athena configuration schema
+ */
+declare const AthenaConfigSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    version: z.ZodString;
+    subscriptions: z.ZodObject<{
+        claude: z.ZodObject<{
+            enabled: z.ZodBoolean;
+            tier: z.ZodEnum<["max5x", "max20x", "pro", "none"]>;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+            tier: "max5x" | "max20x" | "pro" | "none";
+        }, {
+            enabled: boolean;
+            tier: "max5x" | "max20x" | "pro" | "none";
+        }>;
+        openai: z.ZodObject<{
+            enabled: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+        }, {
+            enabled: boolean;
+        }>;
+        google: z.ZodObject<{
+            enabled: z.ZodBoolean;
+            authMethod: z.ZodEnum<["antigravity", "personal", "api", "none"]>;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+            authMethod: "none" | "antigravity" | "personal" | "api";
+        }, {
+            enabled: boolean;
+            authMethod: "none" | "antigravity" | "personal" | "api";
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        openai: {
+            enabled: boolean;
+        };
+        google: {
+            enabled: boolean;
+            authMethod: "none" | "antigravity" | "personal" | "api";
+        };
+        claude: {
+            enabled: boolean;
+            tier: "max5x" | "max20x" | "pro" | "none";
+        };
+    }, {
+        openai: {
+            enabled: boolean;
+        };
+        google: {
+            enabled: boolean;
+            authMethod: "none" | "antigravity" | "personal" | "api";
+        };
+        claude: {
+            enabled: boolean;
+            tier: "max5x" | "max20x" | "pro" | "none";
+        };
+    }>;
+    models: z.ZodObject<{
+        sisyphus: z.ZodString;
+        oracle: z.ZodString;
+        librarian: z.ZodString;
+        frontend: z.ZodOptional<z.ZodString>;
+        documentWriter: z.ZodOptional<z.ZodString>;
+        multimodalLooker: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        sisyphus: string;
+        oracle: string;
+        librarian: string;
+        frontend?: string | undefined;
+        documentWriter?: string | undefined;
+        multimodalLooker?: string | undefined;
+    }, {
+        sisyphus: string;
+        oracle: string;
+        librarian: string;
+        frontend?: string | undefined;
+        documentWriter?: string | undefined;
+        multimodalLooker?: string | undefined;
+    }>;
+    bmad: z.ZodObject<{
+        defaultTrack: z.ZodEnum<["quick-flow", "bmad-method", "enterprise"]>;
+        autoStatusUpdate: z.ZodBoolean;
+        parallelStoryLimit: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        defaultTrack: "quick-flow" | "bmad-method" | "enterprise";
+        autoStatusUpdate: boolean;
+        parallelStoryLimit: number;
+    }, {
+        defaultTrack: "quick-flow" | "bmad-method" | "enterprise";
+        autoStatusUpdate: boolean;
+        parallelStoryLimit: number;
+    }>;
+    features: z.ZodObject<{
+        bmadBridge: z.ZodBoolean;
+        autoStatus: z.ZodBoolean;
+        parallelExecution: z.ZodBoolean;
+        notifications: z.ZodBoolean;
+        contextMonitor: z.ZodBoolean;
+        commentChecker: z.ZodBoolean;
+        lspTools: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        bmadBridge: boolean;
+        autoStatus: boolean;
+        parallelExecution: boolean;
+        notifications: boolean;
+        contextMonitor: boolean;
+        commentChecker: boolean;
+        lspTools: boolean;
+    }, {
+        bmadBridge: boolean;
+        autoStatus: boolean;
+        parallelExecution: boolean;
+        notifications: boolean;
+        contextMonitor: boolean;
+        commentChecker: boolean;
+        lspTools: boolean;
+    }>;
+    mcps: z.ZodObject<{
+        context7: z.ZodBoolean;
+        exa: z.ZodBoolean;
+        grepApp: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        context7: boolean;
+        exa: boolean;
+        grepApp: boolean;
+    }, {
+        context7: boolean;
+        exa: boolean;
+        grepApp: boolean;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    subscriptions: {
+        openai: {
+            enabled: boolean;
+        };
+        google: {
+            enabled: boolean;
+            authMethod: "none" | "antigravity" | "personal" | "api";
+        };
+        claude: {
+            enabled: boolean;
+            tier: "max5x" | "max20x" | "pro" | "none";
+        };
+    };
+    models: {
+        sisyphus: string;
+        oracle: string;
+        librarian: string;
+        frontend?: string | undefined;
+        documentWriter?: string | undefined;
+        multimodalLooker?: string | undefined;
+    };
+    bmad: {
+        defaultTrack: "quick-flow" | "bmad-method" | "enterprise";
+        autoStatusUpdate: boolean;
+        parallelStoryLimit: number;
+    };
+    features: {
+        bmadBridge: boolean;
+        autoStatus: boolean;
+        parallelExecution: boolean;
+        notifications: boolean;
+        contextMonitor: boolean;
+        commentChecker: boolean;
+        lspTools: boolean;
+    };
+    mcps: {
+        context7: boolean;
+        exa: boolean;
+        grepApp: boolean;
+    };
+    version: string;
+    $schema?: string | undefined;
+}, {
+    subscriptions: {
+        openai: {
+            enabled: boolean;
+        };
+        google: {
+            enabled: boolean;
+            authMethod: "none" | "antigravity" | "personal" | "api";
+        };
+        claude: {
+            enabled: boolean;
+            tier: "max5x" | "max20x" | "pro" | "none";
+        };
+    };
+    models: {
+        sisyphus: string;
+        oracle: string;
+        librarian: string;
+        frontend?: string | undefined;
+        documentWriter?: string | undefined;
+        multimodalLooker?: string | undefined;
+    };
+    bmad: {
+        defaultTrack: "quick-flow" | "bmad-method" | "enterprise";
+        autoStatusUpdate: boolean;
+        parallelStoryLimit: number;
+    };
+    features: {
+        bmadBridge: boolean;
+        autoStatus: boolean;
+        parallelExecution: boolean;
+        notifications: boolean;
+        contextMonitor: boolean;
+        commentChecker: boolean;
+        lspTools: boolean;
+    };
+    mcps: {
+        context7: boolean;
+        exa: boolean;
+        grepApp: boolean;
+    };
+    version: string;
+    $schema?: string | undefined;
+}>;
+/**
+ * Schema for athena_get_story arguments
+ */
+declare const GetStoryArgsSchema: z.ZodObject<{
+    storyId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    storyId?: string | undefined;
+}, {
+    storyId?: string | undefined;
+}>;
+/**
+ * Schema for athena_update_status arguments
+ */
+declare const UpdateStatusArgsSchema: z.ZodObject<{
+    storyId: z.ZodString;
+    status: z.ZodEnum<["in_progress", "completed", "blocked", "needs_review"]>;
+    notes: z.ZodOptional<z.ZodString>;
+    completionSummary: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "in_progress" | "completed" | "blocked" | "needs_review";
+    storyId: string;
+    notes?: string | undefined;
+    completionSummary?: string | undefined;
+}, {
+    status: "in_progress" | "completed" | "blocked" | "needs_review";
+    storyId: string;
+    notes?: string | undefined;
+    completionSummary?: string | undefined;
+}>;
+/**
+ * Story status enum for sprint tracking
+ */
+declare const StoryStatusEnum: z.ZodEnum<["pending", "in_progress", "completed", "blocked", "needs_review"]>;
+/**
+ * Tracker status enum (includes transitional states)
+ */
+declare const TrackerStatusEnum: z.ZodEnum<["pending", "in_progress", "completed", "blocked", "needs_review", "loading"]>;
+/**
+ * Schema for sprint-status.yaml content
+ */
+declare const SprintStatusSchema: z.ZodObject<{
+    sprint_number: z.ZodOptional<z.ZodNumber>;
+    current_epic: z.ZodOptional<z.ZodString>;
+    current_story: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    completed_stories: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    pending_stories: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    in_progress_stories: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    blocked_stories: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    stories_needing_review: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    story_updates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        status: z.ZodEnum<["pending", "in_progress", "completed", "blocked", "needs_review"]>;
+        updated_at: z.ZodString;
+        notes: z.ZodOptional<z.ZodString>;
+        completion_summary: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "pending" | "in_progress" | "completed" | "blocked" | "needs_review";
+        updated_at: string;
+        notes?: string | undefined;
+        completion_summary?: string | undefined;
+    }, {
+        status: "pending" | "in_progress" | "completed" | "blocked" | "needs_review";
+        updated_at: string;
+        notes?: string | undefined;
+        completion_summary?: string | undefined;
+    }>>>;
+    last_modified: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    completed_stories: string[];
+    pending_stories: string[];
+    in_progress_stories: string[];
+    blocked_stories: string[];
+    sprint_number?: number | undefined;
+    current_epic?: string | undefined;
+    current_story?: string | null | undefined;
+    stories_needing_review?: string[] | undefined;
+    story_updates?: Record<string, {
+        status: "pending" | "in_progress" | "completed" | "blocked" | "needs_review";
+        updated_at: string;
+        notes?: string | undefined;
+        completion_summary?: string | undefined;
+    }> | undefined;
+    last_modified?: string | undefined;
+}, {
+    sprint_number?: number | undefined;
+    current_epic?: string | undefined;
+    current_story?: string | null | undefined;
+    completed_stories?: string[] | undefined;
+    pending_stories?: string[] | undefined;
+    in_progress_stories?: string[] | undefined;
+    blocked_stories?: string[] | undefined;
+    stories_needing_review?: string[] | undefined;
+    story_updates?: Record<string, {
+        status: "pending" | "in_progress" | "completed" | "blocked" | "needs_review";
+        updated_at: string;
+        notes?: string | undefined;
+        completion_summary?: string | undefined;
+    }> | undefined;
+    last_modified?: string | undefined;
+}>;
+
+/**
+ * Current version of OpenCode Athena
+ * Updated during release process
+ */
+declare const VERSION = "0.0.1";
+/**
+ * Package name for CLI display
+ */
+declare const PACKAGE_NAME = "opencode-athena";
+/**
+ * CLI display name
+ */
+declare const DISPLAY_NAME = "OpenCode Athena";
+/**
+ * Configuration paths
+ */
+declare const CONFIG_PATHS: {
+    /** Global OpenCode config directory */
+    readonly globalConfigDir: string;
+    /** Global Athena config file */
+    readonly globalAthenaConfig: string;
+    /** Global OpenCode config file */
+    readonly globalOpencodeConfig: string;
+    /** Global oh-my-opencode config file */
+    readonly globalOmoConfig: string;
+    /** Commands directory */
+    readonly commandsDir: string;
+    /** Plugin directory */
+    readonly pluginDir: string;
+    /** Athena state file (for story tracking) */
+    readonly stateFile: string;
+};
+/**
+ * Project-specific paths (relative to project root)
+ */
+declare const PROJECT_PATHS: {
+    /** Local Athena config */
+    readonly localConfig: ".opencode/athena.json";
+    /** BMAD directory */
+    readonly bmadDir: "docs";
+    /** BMAD docs directory (deprecated - same as bmadDir in v6) */
+    readonly bmadDocsDir: "docs";
+    /** Sprint status file */
+    readonly sprintStatus: "docs/implementation-artifacts/sprint-status.yaml";
+    /** Stories directory */
+    readonly storiesDir: "docs/implementation-artifacts/stories";
+    /** Architecture document */
+    readonly architecture: "docs/project-planning-artifacts/architecture.md";
+    /** PRD document */
+    readonly prd: "docs/project-planning-artifacts/PRD.md";
+};
+/**
+ * Default configuration values
+ */
+declare const DEFAULTS: {
+    /** Default BMAD track for new projects */
+    readonly defaultTrack: "bmad-method";
+    /** Whether to auto-update sprint status */
+    readonly autoStatusUpdate: true;
+    /** Maximum parallel stories */
+    readonly parallelStoryLimit: 3;
+    /** Default features enabled */
+    readonly features: {
+        readonly bmadBridge: true;
+        readonly autoStatus: true;
+        readonly parallelExecution: true;
+        readonly notifications: true;
+        readonly contextMonitor: true;
+        readonly commentChecker: true;
+        readonly lspTools: true;
+    };
+    /** Default MCPs enabled */
+    readonly mcps: {
+        readonly context7: true;
+        readonly exa: true;
+        readonly grepApp: true;
+    };
+};
+
+export { type AthenaConfig, AthenaConfigSchema, CONFIG_PATHS, DEFAULTS, DISPLAY_NAME, GetStoryArgsSchema, type GetStoryResult, type InstallAnswers, type InstallOptions, PACKAGE_NAME, PROJECT_PATHS, type Prerequisites, type SprintStatus, SprintStatusSchema, type StoryStatus, StoryStatusEnum, type TrackedStory, type TrackerState, type TrackerStatus, TrackerStatusEnum, UpdateStatusArgsSchema, type UpdateStatusResult, VERSION };