oh-my-opencode-kikokikok 2.13.0

package/dist/features/background-agent/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types";
+export { BackgroundManager } from "./manager";

package/dist/features/background-agent/manager.d.ts

@@ -0,0 +1,41 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { BackgroundTask, LaunchInput } from "./types";
+interface EventProperties {
+    sessionID?: string;
+    info?: {
+        id?: string;
+    };
+    [key: string]: unknown;
+}
+interface Event {
+    type: string;
+    properties?: EventProperties;
+}
+export declare class BackgroundManager {
+    private tasks;
+    private notifications;
+    private client;
+    private directory;
+    private pollingInterval?;
+    constructor(ctx: PluginInput);
+    launch(input: LaunchInput): Promise<BackgroundTask>;
+    getTask(id: string): BackgroundTask | undefined;
+    getTasksByParentSession(sessionID: string): BackgroundTask[];
+    getAllDescendantTasks(sessionID: string): BackgroundTask[];
+    findBySession(sessionID: string): BackgroundTask | undefined;
+    private checkSessionTodos;
+    handleEvent(event: Event): void;
+    markForNotification(task: BackgroundTask): void;
+    getPendingNotifications(sessionID: string): BackgroundTask[];
+    clearNotifications(sessionID: string): void;
+    private clearNotificationsForTask;
+    private startPolling;
+    private stopPolling;
+    cleanup(): void;
+    private notifyParentSession;
+    private formatDuration;
+    private hasRunningTasks;
+    private pruneStaleTasksAndNotifications;
+    private pollRunningTasks;
+}
+export {};

package/dist/features/background-agent/manager.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/features/background-agent/types.d.ts

@@ -0,0 +1,38 @@
+export type BackgroundTaskStatus = "running" | "completed" | "error" | "cancelled";
+export interface TaskProgress {
+    toolCalls: number;
+    lastTool?: string;
+    lastUpdate: Date;
+    lastMessage?: string;
+    lastMessageAt?: Date;
+}
+export interface BackgroundTask {
+    id: string;
+    sessionID: string;
+    parentSessionID: string;
+    parentMessageID: string;
+    description: string;
+    prompt: string;
+    agent: string;
+    status: BackgroundTaskStatus;
+    startedAt: Date;
+    completedAt?: Date;
+    result?: string;
+    error?: string;
+    progress?: TaskProgress;
+    parentModel?: {
+        providerID: string;
+        modelID: string;
+    };
+}
+export interface LaunchInput {
+    description: string;
+    prompt: string;
+    agent: string;
+    parentSessionID: string;
+    parentMessageID: string;
+    parentModel?: {
+        providerID: string;
+        modelID: string;
+    };
+}

package/dist/features/builtin-commands/commands.d.ts

@@ -0,0 +1,2 @@
+import type { BuiltinCommandName, BuiltinCommands } from "./types";
+export declare function loadBuiltinCommands(disabledCommands?: BuiltinCommandName[]): BuiltinCommands;

package/dist/features/builtin-commands/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types";
+export * from "./commands";

package/dist/features/builtin-commands/templates/init-deep.d.ts

@@ -0,0 +1 @@
+export declare const INIT_DEEP_TEMPLATE = "# /init-deep\n\nGenerate hierarchical AGENTS.md files. Root + complexity-scored subdirectories.\n\n## Usage\n\n```\n/init-deep                      # Update mode: modify existing + create new where warranted\n/init-deep --create-new         # Read existing \u2192 remove all \u2192 regenerate from scratch\n/init-deep --max-depth=2        # Limit directory depth (default: 3)\n```\n\n---\n\n## Workflow (High-Level)\n\n1. **Discovery + Analysis** (concurrent)\n   - Fire background explore agents immediately\n   - Main session: bash structure + LSP codemap + read existing AGENTS.md\n2. **Score & Decide** - Determine AGENTS.md locations from merged findings\n3. **Generate** - Root first, then subdirs in parallel\n4. **Review** - Deduplicate, trim, validate\n\n<critical>\n**TodoWrite ALL phases. Mark in_progress \u2192 completed in real-time.**\n```\nTodoWrite([\n  { id: \"discovery\", content: \"Fire explore agents + LSP codemap + read existing\", status: \"pending\", priority: \"high\" },\n  { id: \"scoring\", content: \"Score directories, determine locations\", status: \"pending\", priority: \"high\" },\n  { id: \"generate\", content: \"Generate AGENTS.md files (root + subdirs)\", status: \"pending\", priority: \"high\" },\n  { id: \"review\", content: \"Deduplicate, validate, trim\", status: \"pending\", priority: \"medium\" }\n])\n```\n</critical>\n\n---\n\n## Phase 1: Discovery + Analysis (Concurrent)\n\n**Mark \"discovery\" as in_progress.**\n\n### Fire Background Explore Agents IMMEDIATELY\n\nDon't wait\u2014these run async while main session works.\n\n```\n// Fire all at once, collect results later\nbackground_task(agent=\"explore\", prompt=\"Project structure: PREDICT standard patterns for detected language \u2192 REPORT deviations only\")\nbackground_task(agent=\"explore\", prompt=\"Entry points: FIND main files \u2192 REPORT non-standard organization\")\nbackground_task(agent=\"explore\", prompt=\"Conventions: FIND config files (.eslintrc, pyproject.toml, .editorconfig) \u2192 REPORT project-specific rules\")\nbackground_task(agent=\"explore\", prompt=\"Anti-patterns: FIND 'DO NOT', 'NEVER', 'ALWAYS', 'DEPRECATED' comments \u2192 LIST forbidden patterns\")\nbackground_task(agent=\"explore\", prompt=\"Build/CI: FIND .github/workflows, Makefile \u2192 REPORT non-standard patterns\")\nbackground_task(agent=\"explore\", prompt=\"Test patterns: FIND test configs, test structure \u2192 REPORT unique conventions\")\n```\n\n<dynamic-agents>\n**DYNAMIC AGENT SPAWNING**: After bash analysis, spawn ADDITIONAL explore agents based on project scale:\n\n| Factor | Threshold | Additional Agents |\n|--------|-----------|-------------------|\n| **Total files** | >100 | +1 per 100 files |\n| **Total lines** | >10k | +1 per 10k lines |\n| **Directory depth** | \u22654 | +2 for deep exploration |\n| **Large files (>500 lines)** | >10 files | +1 for complexity hotspots |\n| **Monorepo** | detected | +1 per package/workspace |\n| **Multiple languages** | >1 | +1 per language |\n\n```bash\n# Measure project scale first\ntotal_files=$(find . -type f -not -path '*/node_modules/*' -not -path '*/.git/*' | wc -l)\ntotal_lines=$(find . -type f \\( -name \"*.ts\" -o -name \"*.py\" -o -name \"*.go\" \\) -not -path '*/node_modules/*' -exec wc -l {} + 2>/dev/null | tail -1 | awk '{print $1}')\nlarge_files=$(find . -type f \\( -name \"*.ts\" -o -name \"*.py\" \\) -not -path '*/node_modules/*' -exec wc -l {} + 2>/dev/null | awk '$1 > 500 {count++} END {print count+0}')\nmax_depth=$(find . -type d -not -path '*/node_modules/*' -not -path '*/.git/*' | awk -F/ '{print NF}' | sort -rn | head -1)\n```\n\nExample spawning:\n```\n// 500 files, 50k lines, depth 6, 15 large files \u2192 spawn 5+5+2+1 = 13 additional agents\nbackground_task(agent=\"explore\", prompt=\"Large file analysis: FIND files >500 lines, REPORT complexity hotspots\")\nbackground_task(agent=\"explore\", prompt=\"Deep modules at depth 4+: FIND hidden patterns, internal conventions\")\nbackground_task(agent=\"explore\", prompt=\"Cross-cutting concerns: FIND shared utilities across directories\")\n// ... more based on calculation\n```\n</dynamic-agents>\n\n### Main Session: Concurrent Analysis\n\n**While background agents run**, main session does:\n\n#### 1. Bash Structural Analysis\n```bash\n# Directory depth + file counts\nfind . -type d -not -path '*/\\.*' -not -path '*/node_modules/*' -not -path '*/venv/*' -not -path '*/dist/*' -not -path '*/build/*' | awk -F/ '{print NF-1}' | sort -n | uniq -c\n\n# Files per directory (top 30)\nfind . -type f -not -path '*/\\.*' -not -path '*/node_modules/*' | sed 's|/[^/]*$||' | sort | uniq -c | sort -rn | head -30\n\n# Code concentration by extension\nfind . -type f \\( -name \"*.py\" -o -name \"*.ts\" -o -name \"*.tsx\" -o -name \"*.js\" -o -name \"*.go\" -o -name \"*.rs\" \\) -not -path '*/node_modules/*' | sed 's|/[^/]*$||' | sort | uniq -c | sort -rn | head -20\n\n# Existing AGENTS.md / CLAUDE.md\nfind . -type f \\( -name \"AGENTS.md\" -o -name \"CLAUDE.md\" \\) -not -path '*/node_modules/*' 2>/dev/null\n```\n\n#### 2. Read Existing AGENTS.md\n```\nFor each existing file found:\n  Read(filePath=file)\n  Extract: key insights, conventions, anti-patterns\n  Store in EXISTING_AGENTS map\n```\n\nIf `--create-new`: Read all existing first (preserve context) \u2192 then delete all \u2192 regenerate.\n\n#### 3. LSP Codemap (if available)\n```\nlsp_servers()  # Check availability\n\n# Entry points (parallel)\nlsp_document_symbols(filePath=\"src/index.ts\")\nlsp_document_symbols(filePath=\"main.py\")\n\n# Key symbols (parallel)\nlsp_workspace_symbols(filePath=\".\", query=\"class\")\nlsp_workspace_symbols(filePath=\".\", query=\"interface\")\nlsp_workspace_symbols(filePath=\".\", query=\"function\")\n\n# Centrality for top exports\nlsp_find_references(filePath=\"...\", line=X, character=Y)\n```\n\n**LSP Fallback**: If unavailable, rely on explore agents + AST-grep.\n\n### Collect Background Results\n\n```\n// After main session analysis done, collect all task results\nfor each task_id: background_output(task_id=\"...\")\n```\n\n**Merge: bash + LSP + existing + explore findings. Mark \"discovery\" as completed.**\n\n---\n\n## Phase 2: Scoring & Location Decision\n\n**Mark \"scoring\" as in_progress.**\n\n### Scoring Matrix\n\n| Factor | Weight | High Threshold | Source |\n|--------|--------|----------------|--------|\n| File count | 3x | >20 | bash |\n| Subdir count | 2x | >5 | bash |\n| Code ratio | 2x | >70% | bash |\n| Unique patterns | 1x | Has own config | explore |\n| Module boundary | 2x | Has index.ts/__init__.py | bash |\n| Symbol density | 2x | >30 symbols | LSP |\n| Export count | 2x | >10 exports | LSP |\n| Reference centrality | 3x | >20 refs | LSP |\n\n### Decision Rules\n\n| Score | Action |\n|-------|--------|\n| **Root (.)** | ALWAYS create |\n| **>15** | Create AGENTS.md |\n| **8-15** | Create if distinct domain |\n| **<8** | Skip (parent covers) |\n\n### Output\n```\nAGENTS_LOCATIONS = [\n  { path: \".\", type: \"root\" },\n  { path: \"src/hooks\", score: 18, reason: \"high complexity\" },\n  { path: \"src/api\", score: 12, reason: \"distinct domain\" }\n]\n```\n\n**Mark \"scoring\" as completed.**\n\n---\n\n## Phase 3: Generate AGENTS.md\n\n**Mark \"generate\" as in_progress.**\n\n### Root AGENTS.md (Full Treatment)\n\n```markdown\n# PROJECT KNOWLEDGE BASE\n\n**Generated:** {TIMESTAMP}\n**Commit:** {SHORT_SHA}\n**Branch:** {BRANCH}\n\n## OVERVIEW\n{1-2 sentences: what + core stack}\n\n## STRUCTURE\n\\`\\`\\`\n{root}/\n\u251C\u2500\u2500 {dir}/    # {non-obvious purpose only}\n\u2514\u2500\u2500 {entry}\n\\`\\`\\`\n\n## WHERE TO LOOK\n| Task | Location | Notes |\n|------|----------|-------|\n\n## CODE MAP\n{From LSP - skip if unavailable or project <10 files}\n\n| Symbol | Type | Location | Refs | Role |\n|--------|------|----------|------|------|\n\n## CONVENTIONS\n{ONLY deviations from standard}\n\n## ANTI-PATTERNS (THIS PROJECT)\n{Explicitly forbidden here}\n\n## UNIQUE STYLES\n{Project-specific}\n\n## COMMANDS\n\\`\\`\\`bash\n{dev/test/build}\n\\`\\`\\`\n\n## NOTES\n{Gotchas}\n```\n\n**Quality gates**: 50-150 lines, no generic advice, no obvious info.\n\n### Subdirectory AGENTS.md (Parallel)\n\nLaunch document-writer agents for each location:\n\n```\nfor loc in AGENTS_LOCATIONS (except root):\n  background_task(agent=\"document-writer\", prompt=\\`\n    Generate AGENTS.md for: ${loc.path}\n    - Reason: ${loc.reason}\n    - 30-80 lines max\n    - NEVER repeat parent content\n    - Sections: OVERVIEW (1 line), STRUCTURE (if >5 subdirs), WHERE TO LOOK, CONVENTIONS (if different), ANTI-PATTERNS\n  \\`)\n```\n\n**Wait for all. Mark \"generate\" as completed.**\n\n---\n\n## Phase 4: Review & Deduplicate\n\n**Mark \"review\" as in_progress.**\n\nFor each generated file:\n- Remove generic advice\n- Remove parent duplicates\n- Trim to size limits\n- Verify telegraphic style\n\n**Mark \"review\" as completed.**\n\n---\n\n## Final Report\n\n```\n=== init-deep Complete ===\n\nMode: {update | create-new}\n\nFiles:\n  \u2713 ./AGENTS.md (root, {N} lines)\n  \u2713 ./src/hooks/AGENTS.md ({N} lines)\n\nDirs Analyzed: {N}\nAGENTS.md Created: {N}\nAGENTS.md Updated: {N}\n\nHierarchy:\n  ./AGENTS.md\n  \u2514\u2500\u2500 src/hooks/AGENTS.md\n```\n\n---\n\n## Anti-Patterns\n\n- **Static agent count**: MUST vary agents based on project size/depth\n- **Sequential execution**: MUST parallel (explore + LSP concurrent)\n- **Ignoring existing**: ALWAYS read existing first, even with --create-new\n- **Over-documenting**: Not every dir needs AGENTS.md\n- **Redundancy**: Child never repeats parent\n- **Generic content**: Remove anything that applies to ALL projects\n- **Verbose style**: Telegraphic or die";

package/dist/features/builtin-commands/templates/ralph-loop.d.ts

@@ -0,0 +1,2 @@
+export declare const RALPH_LOOP_TEMPLATE = "You are starting a Ralph Loop - a self-referential development loop that runs until task completion.\n\n## How Ralph Loop Works\n\n1. You will work on the task continuously\n2. When you believe the task is FULLY complete, output: `<promise>{{COMPLETION_PROMISE}}</promise>`\n3. If you don't output the promise, the loop will automatically inject another prompt to continue\n4. Maximum iterations: Configurable (default 100)\n\n## Rules\n\n- Focus on completing the task fully, not partially\n- Don't output the completion promise until the task is truly done\n- Each iteration should make meaningful progress toward the goal\n- If stuck, try different approaches\n- Use todos to track your progress\n\n## Exit Conditions\n\n1. **Completion**: Output `<promise>DONE</promise>` (or custom promise text) when fully complete\n2. **Max Iterations**: Loop stops automatically at limit\n3. **Cancel**: User runs `/cancel-ralph` command\n\n## Your Task\n\nParse the arguments below and begin working on the task. The format is:\n`\"task description\" [--completion-promise=TEXT] [--max-iterations=N]`\n\nDefault completion promise is \"DONE\" and default max iterations is 100.";
+export declare const CANCEL_RALPH_TEMPLATE = "Cancel the currently active Ralph Loop.\n\nThis will:\n1. Stop the loop from continuing\n2. Clear the loop state file\n3. Allow the session to end normally\n\nCheck if a loop is active and cancel it. Inform the user of the result.";

package/dist/features/builtin-commands/types.d.ts

@@ -0,0 +1,6 @@
+import type { CommandDefinition } from "../claude-code-command-loader";
+export type BuiltinCommandName = "init-deep" | "ralph-loop" | "cancel-ralph";
+export interface BuiltinCommandConfig {
+    disabled_commands?: BuiltinCommandName[];
+}
+export type BuiltinCommands = Record<string, CommandDefinition>;

package/dist/features/builtin-skills/api/index.d.ts

@@ -0,0 +1 @@
+export * from "./types";

package/dist/features/builtin-skills/api/types.d.ts

@@ -0,0 +1,193 @@
+export type ApiSubcommand = "design" | "document" | "validate" | "generate" | "test" | "mock" | "diff" | "lint";
+export type ApiSpecFormat = "openapi3" | "openapi2" | "asyncapi" | "graphql" | "grpc" | "json-schema";
+export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+export interface DesignInput {
+    description: string;
+    style?: "rest" | "graphql" | "grpc" | "event-driven";
+    version?: string;
+    baseUrl?: string;
+}
+export interface DesignResult {
+    spec: string;
+    format: ApiSpecFormat;
+    endpoints: EndpointSummary[];
+    schemas: SchemaSummary[];
+    suggestions?: DesignSuggestion[];
+}
+export interface EndpointSummary {
+    method: HttpMethod;
+    path: string;
+    operationId: string;
+    summary: string;
+    tags?: string[];
+}
+export interface SchemaSummary {
+    name: string;
+    type: "object" | "array" | "enum" | "union";
+    properties?: number;
+    required?: number;
+}
+export interface DesignSuggestion {
+    type: "naming" | "structure" | "security" | "versioning" | "pagination";
+    message: string;
+    location?: string;
+}
+export interface DocumentInput {
+    source: string;
+    format?: ApiSpecFormat;
+    outputFormat?: "markdown" | "html" | "pdf";
+    includeExamples?: boolean;
+}
+export interface DocumentResult {
+    documentation: string;
+    format: string;
+    sections: DocSection[];
+}
+export interface DocSection {
+    title: string;
+    anchor: string;
+    level: number;
+    content?: string;
+}
+export interface ValidateInput {
+    spec: string;
+    format?: ApiSpecFormat;
+    rules?: string[];
+    severity?: "error" | "warning" | "info";
+}
+export interface ValidateResult {
+    valid: boolean;
+    errors: ValidationIssue[];
+    warnings: ValidationIssue[];
+    info: ValidationIssue[];
+    score?: number;
+}
+export interface ValidationIssue {
+    code: string;
+    message: string;
+    path: string;
+    line?: number;
+    severity: "error" | "warning" | "info";
+    suggestion?: string;
+}
+export interface GenerateInput {
+    spec: string;
+    target: "client" | "server" | "types" | "mocks";
+    language: string;
+    framework?: string;
+    outputPath?: string;
+}
+export interface GenerateResult {
+    files: GeneratedFile[];
+    language: string;
+    framework?: string;
+}
+export interface GeneratedFile {
+    path: string;
+    content: string;
+    type: "code" | "config" | "types";
+}
+export interface TestInput {
+    spec: string;
+    baseUrl: string;
+    auth?: AuthConfig;
+    coverage?: boolean;
+}
+export interface AuthConfig {
+    type: "bearer" | "basic" | "apikey" | "oauth2";
+    credentials: Record<string, string>;
+}
+export interface TestResult {
+    total: number;
+    passed: number;
+    failed: number;
+    skipped: number;
+    duration: number;
+    results: EndpointTestResult[];
+    coverage?: CoverageReport;
+}
+export interface EndpointTestResult {
+    endpoint: string;
+    method: HttpMethod;
+    status: "passed" | "failed" | "skipped";
+    duration: number;
+    statusCode?: number;
+    error?: string;
+}
+export interface CoverageReport {
+    endpoints: {
+        covered: number;
+        total: number;
+        percent: number;
+    };
+    methods: {
+        covered: number;
+        total: number;
+        percent: number;
+    };
+    statusCodes: {
+        covered: number;
+        total: number;
+        percent: number;
+    };
+}
+export interface MockInput {
+    spec: string;
+    port?: number;
+    delay?: number;
+    dynamic?: boolean;
+}
+export interface MockResult {
+    url: string;
+    port: number;
+    endpoints: number;
+    status: "running" | "stopped";
+}
+export interface DiffInput {
+    oldSpec: string;
+    newSpec: string;
+    format?: "text" | "json" | "markdown";
+}
+export interface DiffResult {
+    breaking: ApiChange[];
+    nonBreaking: ApiChange[];
+    summary: DiffSummary;
+}
+export interface ApiChange {
+    type: "added" | "removed" | "modified" | "deprecated";
+    path: string;
+    description: string;
+    breaking: boolean;
+}
+export interface DiffSummary {
+    added: number;
+    removed: number;
+    modified: number;
+    deprecated: number;
+    breakingChanges: number;
+}
+export interface LintInput {
+    spec: string;
+    ruleset?: string;
+    fix?: boolean;
+}
+export interface LintResult {
+    issues: LintIssue[];
+    fixed?: number;
+    score: number;
+}
+export interface LintIssue {
+    rule: string;
+    message: string;
+    path: string;
+    severity: "error" | "warning" | "info";
+    fixable: boolean;
+}
+export interface ApiConfig {
+    defaultFormat?: ApiSpecFormat;
+    lintRuleset?: string;
+    generateDefaults?: {
+        language?: string;
+        framework?: string;
+    };
+}

package/dist/features/builtin-skills/code-index/index.d.ts

@@ -0,0 +1 @@
+export * from "./types";

package/dist/features/builtin-skills/code-index/types.d.ts

@@ -0,0 +1,95 @@
+export type CodeIndexSubcommand = "search" | "similar" | "index" | "status" | "symbols" | "references" | "dependencies" | "explain";
+export type IndexLanguage = "typescript" | "javascript" | "python" | "rust" | "go" | "java" | "kotlin" | "csharp" | "cpp" | "c" | "ruby" | "php" | "swift" | "scala";
+export interface SearchInput {
+    query: string;
+    semantic?: boolean;
+    language?: IndexLanguage;
+    paths?: string[];
+    limit?: number;
+}
+export interface SearchResult {
+    filePath: string;
+    line: number;
+    column: number;
+    snippet: string;
+    score: number;
+    symbolName?: string;
+    symbolKind?: SymbolKind;
+}
+export type SymbolKind = "function" | "method" | "class" | "interface" | "type" | "variable" | "constant" | "enum" | "module" | "namespace";
+export interface SimilarInput {
+    filePath: string;
+    line?: number;
+    symbolName?: string;
+    limit?: number;
+}
+export interface SimilarResult {
+    filePath: string;
+    symbolName: string;
+    symbolKind: SymbolKind;
+    similarity: number;
+    snippet: string;
+}
+export interface IndexInput {
+    paths?: string[];
+    languages?: IndexLanguage[];
+    force?: boolean;
+}
+export interface IndexStatus {
+    indexed: boolean;
+    lastIndexedAt?: string;
+    fileCount: number;
+    symbolCount: number;
+    languages: IndexLanguage[];
+    vectorDbStatus: "connected" | "disconnected" | "indexing";
+}
+export interface SymbolInfo {
+    name: string;
+    kind: SymbolKind;
+    filePath: string;
+    line: number;
+    column: number;
+    signature?: string;
+    documentation?: string;
+    references: number;
+}
+export interface DependencyInfo {
+    name: string;
+    version?: string;
+    usedBy: string[];
+    imports: string[];
+}
+export interface ExplainInput {
+    filePath: string;
+    line?: number;
+    symbolName?: string;
+}
+export interface ExplainResult {
+    summary: string;
+    purpose: string;
+    inputs?: ParameterInfo[];
+    outputs?: string;
+    sideEffects?: string[];
+    relatedSymbols: string[];
+    usageExamples?: string[];
+}
+export interface ParameterInfo {
+    name: string;
+    type: string;
+    description?: string;
+    optional?: boolean;
+}
+export interface CodeIndexConfig {
+    qdrant?: {
+        url: string;
+        apiKey?: string;
+        collectionName?: string;
+    };
+    chroma?: {
+        url?: string;
+        collectionName?: string;
+    };
+    embeddingModel?: string;
+    excludePaths?: string[];
+    includeTests?: boolean;
+}

package/dist/features/builtin-skills/db/index.d.ts

@@ -0,0 +1 @@
+export * from "./types";

package/dist/features/builtin-skills/db/types.d.ts

@@ -0,0 +1,210 @@
+export type DbSubcommand = "query" | "schema" | "migrate" | "analyze" | "optimize" | "explain" | "backup" | "seed";
+export type DbType = "postgresql" | "mysql" | "sqlite" | "mongodb" | "redis" | "elasticsearch" | "dynamodb";
+export interface QueryInput {
+    query: string;
+    database?: string;
+    params?: unknown[];
+    limit?: number;
+    format?: "table" | "json" | "csv";
+}
+export interface QueryResult {
+    rows: Record<string, unknown>[];
+    rowCount: number;
+    duration: number;
+    columns: ColumnInfo[];
+}
+export interface ColumnInfo {
+    name: string;
+    type: string;
+    nullable: boolean;
+}
+export interface SchemaInput {
+    database?: string;
+    table?: string;
+    action?: "show" | "create" | "alter" | "drop";
+}
+export interface SchemaResult {
+    tables: TableSchema[];
+    views?: ViewSchema[];
+    indexes?: IndexSchema[];
+    constraints?: ConstraintSchema[];
+}
+export interface TableSchema {
+    name: string;
+    columns: ColumnSchema[];
+    primaryKey?: string[];
+    indexes?: IndexSchema[];
+    foreignKeys?: ForeignKeySchema[];
+}
+export interface ColumnSchema {
+    name: string;
+    type: string;
+    nullable: boolean;
+    defaultValue?: string;
+    autoIncrement?: boolean;
+    comment?: string;
+}
+export interface ViewSchema {
+    name: string;
+    definition: string;
+    columns: string[];
+}
+export interface IndexSchema {
+    name: string;
+    table: string;
+    columns: string[];
+    unique: boolean;
+    type?: string;
+}
+export interface ConstraintSchema {
+    name: string;
+    type: "primary" | "foreign" | "unique" | "check";
+    table: string;
+    columns: string[];
+    reference?: {
+        table: string;
+        columns: string[];
+    };
+}
+export interface ForeignKeySchema {
+    name: string;
+    columns: string[];
+    referencedTable: string;
+    referencedColumns: string[];
+    onDelete?: string;
+    onUpdate?: string;
+}
+export interface MigrateInput {
+    action: "status" | "up" | "down" | "create" | "generate";
+    name?: string;
+    steps?: number;
+    dryRun?: boolean;
+}
+export interface MigrateResult {
+    action: string;
+    migrations: MigrationInfo[];
+    applied?: number;
+    pending?: number;
+}
+export interface MigrationInfo {
+    id: string;
+    name: string;
+    status: "applied" | "pending" | "failed";
+    appliedAt?: string;
+    duration?: number;
+}
+export interface AnalyzeInput {
+    table?: string;
+    query?: string;
+    includeSlowQueries?: boolean;
+}
+export interface AnalyzeResult {
+    statistics: TableStats[];
+    slowQueries?: SlowQuery[];
+    recommendations: DbRecommendation[];
+}
+export interface TableStats {
+    table: string;
+    rowCount: number;
+    sizeBytes: number;
+    indexSizeBytes: number;
+    lastAnalyzed?: string;
+    bloatPercent?: number;
+}
+export interface SlowQuery {
+    query: string;
+    duration: number;
+    frequency: number;
+    lastExecuted: string;
+    suggestions?: string[];
+}
+export interface DbRecommendation {
+    type: "index" | "query" | "schema" | "maintenance";
+    priority: "high" | "medium" | "low";
+    table?: string;
+    message: string;
+    sql?: string;
+}
+export interface OptimizeInput {
+    target: "query" | "table" | "index";
+    query?: string;
+    table?: string;
+}
+export interface OptimizeResult {
+    original?: string;
+    optimized?: string;
+    improvement?: number;
+    suggestions: OptimizeSuggestion[];
+}
+export interface OptimizeSuggestion {
+    type: string;
+    description: string;
+    impact: "high" | "medium" | "low";
+    sql?: string;
+}
+export interface ExplainInput {
+    query: string;
+    analyze?: boolean;
+    format?: "text" | "json" | "yaml";
+}
+export interface ExplainResult {
+    plan: QueryPlan;
+    cost: number;
+    rows: number;
+    actualTime?: number;
+    warnings?: string[];
+}
+export interface QueryPlan {
+    operation: string;
+    details: string;
+    cost: number;
+    rows: number;
+    children?: QueryPlan[];
+    actualTime?: number;
+    loops?: number;
+}
+export interface BackupInput {
+    target: string;
+    format?: "sql" | "binary" | "archive";
+    compress?: boolean;
+    tables?: string[];
+}
+export interface BackupResult {
+    path: string;
+    size: number;
+    duration: number;
+    tables: number;
+    rows: number;
+}
+export interface SeedInput {
+    source: string;
+    table?: string;
+    truncate?: boolean;
+    count?: number;
+}
+export interface SeedResult {
+    tables: SeedTableResult[];
+    totalRows: number;
+    duration: number;
+}
+export interface SeedTableResult {
+    table: string;
+    inserted: number;
+    errors: number;
+}
+export interface DbConfig {
+    connections?: Record<string, ConnectionConfig>;
+    defaultConnection?: string;
+    migrationsPath?: string;
+    seedsPath?: string;
+}
+export interface ConnectionConfig {
+    type: DbType;
+    host?: string;
+    port?: number;
+    database: string;
+    user?: string;
+    password?: string;
+    ssl?: boolean;
+    uri?: string;
+}

package/dist/features/builtin-skills/debug/index.d.ts

@@ -0,0 +1 @@
+export * from "./types";