@plusplusoneplusplus/coc 1.0.0

package/dist/server/wiki/types.d.ts

@@ -0,0 +1,260 @@
+/**
+ * Wiki Types
+ *
+ * Type definitions for the wiki data layer. Contains types copied from
+ * deep-wiki that are consumed by wiki-data, context-builder,
+ * file-watcher, and conversation-session-manager.
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+/**
+ * High-level project information inferred from config files and README.
+ */
+export interface ProjectInfo {
+    /** Project name (from package.json, Cargo.toml, etc.) */
+    name: string;
+    /** Brief description inferred from README or config */
+    description: string;
+    /** Primary programming language */
+    language: string;
+    /** Build system (e.g., "npm + webpack", "cargo", "go modules") */
+    buildSystem: string;
+    /** Entry point files relative to repo root */
+    entryPoints: string[];
+}
+/**
+ * A single component/package/directory in the codebase.
+ */
+export interface ComponentInfo {
+    /** Unique lowercase kebab-case identifier */
+    id: string;
+    /** Human-readable component name */
+    name: string;
+    /** Path relative to repo root (e.g., "src/auth/") */
+    path: string;
+    /** One-sentence purpose description */
+    purpose: string;
+    /** Key files in this component (relative to repo root) */
+    keyFiles: string[];
+    /** IDs of components this component depends on */
+    dependencies: string[];
+    /** IDs of components that depend on this component */
+    dependents: string[];
+    /** Complexity level */
+    complexity: 'low' | 'medium' | 'high';
+    /** Category this component belongs to */
+    category: string;
+    /** Domain slug from large-repo discovery (only set for large repos) */
+    domain?: string;
+    /** Optional line ranges for monolithic files — [[start, end], ...] */
+    lineRanges?: [number, number][];
+    /** IDs of original components merged into this one (set by consolidation phase) */
+    mergedFrom?: string[];
+}
+/**
+ * A named category for grouping modules.
+ */
+export interface CategoryInfo {
+    /** Category name (e.g., "core", "infra", "api") */
+    name: string;
+    /** Short description of what this category contains */
+    description: string;
+}
+/**
+ * Information about a top-level area in a large repo.
+ */
+export interface DomainInfo {
+    /** Unique kebab-case identifier (derived from area path) */
+    id: string;
+    /** Human-readable area name */
+    name: string;
+    /** Path relative to repo root */
+    path: string;
+    /** Brief description of the area */
+    description: string;
+    /** IDs of components belonging to this domain */
+    components: string[];
+}
+/**
+ * The complete component graph — output of Phase 1 (Discovery).
+ */
+export interface ComponentGraph {
+    /** High-level project information */
+    project: ProjectInfo;
+    /** All discovered components */
+    components: ComponentInfo[];
+    /** Component categories */
+    categories: CategoryInfo[];
+    /** Architecture notes (free-text summary) */
+    architectureNotes: string;
+    /** Top-level domains (only present for large repos with 3000+ files) */
+    domains?: DomainInfo[];
+    /** Theme area metadata (populated by theme command) */
+    themes?: ThemeMeta[];
+}
+/** A key concept identified in a component. */
+export interface KeyConcept {
+    name: string;
+    description: string;
+    codeRef?: string;
+}
+/** A public API entry point of a component. */
+export interface PublicAPIEntry {
+    name: string;
+    signature: string;
+    description: string;
+}
+/** An illustrative code example from a component. */
+export interface CodeExample {
+    title: string;
+    code: string;
+    file?: string;
+    lines?: [number, number];
+}
+/** An internal dependency (another component in the same project). */
+export interface InternalDependency {
+    component: string;
+    usage: string;
+}
+/** An external dependency (third-party package). */
+export interface ExternalDependency {
+    package: string;
+    usage: string;
+}
+/**
+ * Deep analysis result for a single component.
+ */
+export interface ComponentAnalysis {
+    /** Component ID (matches ComponentInfo.id) */
+    componentId: string;
+    /** High-level overview paragraph */
+    overview: string;
+    /** Key concepts and abstractions */
+    keyConcepts: KeyConcept[];
+    /** Public API entries */
+    publicAPI: PublicAPIEntry[];
+    /** Internal architecture description */
+    internalArchitecture: string;
+    /** Data flow description */
+    dataFlow: string;
+    /** Design patterns used */
+    patterns: string[];
+    /** Error handling strategy */
+    errorHandling: string;
+    /** Illustrative code examples */
+    codeExamples: CodeExample[];
+    /** Dependencies (internal + external) */
+    dependencies: {
+        internal: InternalDependency[];
+        external: ExternalDependency[];
+    };
+    /** Suggested Mermaid diagram for the module */
+    suggestedDiagram: string;
+    /** All source files examined during analysis (repo-relative paths) */
+    sourceFiles?: string[];
+}
+/**
+ * Theme area metadata stored in module-graph.json.
+ */
+export interface ThemeMeta {
+    /** Unique theme identifier */
+    id: string;
+    /** Human-readable title */
+    title: string;
+    /** Theme description */
+    description: string;
+    /** Layout strategy */
+    layout: 'single' | 'area';
+    /** Articles within this theme area */
+    articles: {
+        slug: string;
+        title: string;
+        path: string;
+    }[];
+    /** IDs of components involved in this theme */
+    involvedComponentIds: string[];
+    /** Directory path for the theme area output */
+    directoryPath: string;
+    /** Timestamp when this theme was generated */
+    generatedAt: number;
+    /** Git hash at generation time */
+    gitHash?: string;
+}
+/**
+ * Callback type for sending a prompt to the AI and receiving a response.
+ * Decoupled from the HTTP handler layer so data-layer modules can use it.
+ */
+export type AskAIFunction = (prompt: string, options?: {
+    model?: string;
+    workingDirectory?: string;
+    onStreamingChunk?: (chunk: string) => void;
+}) => Promise<string>;
+/**
+ * Options for the `deep-wiki serve` command (wiki-specific variant).
+ * Lives under wiki/ to avoid collision with CoC's top-level ServeCommandOptions.
+ */
+export interface WikiServeCommandOptions {
+    /** Port to listen on (default: 3000) */
+    port?: number;
+    /** Host/address to bind to (default: '0.0.0.0') */
+    host?: string;
+    /** Generate wiki before serving (path to repo) */
+    generate?: string;
+    /** Watch repo for changes (requires --generate) */
+    watch?: boolean;
+    /** Enable AI Q&A and deep-dive features */
+    ai?: boolean;
+    /** AI model for Q&A sessions */
+    model?: string;
+    /** Open browser on start */
+    open?: boolean;
+    /** Website theme */
+    theme?: string;
+    /** Override project title */
+    title?: string;
+    /** Verbose logging */
+    verbose?: boolean;
+}
+export type WebsiteTheme = 'light' | 'dark' | 'auto';
+export type ArticleType = 'component' | 'index' | 'architecture' | 'getting-started' | 'domain-index' | 'domain-architecture';
+export interface GeneratedArticle {
+    type: ArticleType;
+    slug: string;
+    title: string;
+    content: string;
+    componentId?: string;
+    domainId?: string;
+}
+export type PhaseName = 'discovery' | 'consolidation' | 'analysis' | 'writing';
+export interface PhaseConfig {
+    model?: string;
+    timeout?: number;
+    concurrency?: number;
+    depth?: 'shallow' | 'normal' | 'deep';
+    skipAI?: boolean;
+}
+export type PhasesConfig = Partial<Record<PhaseName, PhaseConfig>>;
+export interface GenerateCommandOptions {
+    repoPath?: string;
+    output: string;
+    model?: string;
+    concurrency?: number;
+    timeout?: number;
+    focus?: string;
+    depth: 'shallow' | 'normal' | 'deep';
+    force: boolean;
+    useCache: boolean;
+    phase?: number;
+    endPhase?: number;
+    verbose: boolean;
+    skipWebsite?: boolean;
+    theme?: WebsiteTheme;
+    title?: string;
+    seeds?: string;
+    noCluster?: boolean;
+    strict?: boolean;
+    largeRepoThreshold?: number;
+    config?: string;
+    phases?: PhasesConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/server/wiki/types.d.ts.map

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

package/dist/server/wiki/types.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Wiki Types
+ *
+ * Type definitions for the wiki data layer. Contains types copied from
+ * deep-wiki that are consumed by wiki-data, context-builder,
+ * file-watcher, and conversation-session-manager.
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/server/wiki/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/server/wiki/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}

package/dist/server/wiki/websocket.d.ts

@@ -0,0 +1,53 @@
+/**
+ * WebSocket Server
+ *
+ * Uses the `ws` library in noServer mode, attached to an existing HTTP server.
+ * Used for live-reload notifications when --watch is enabled.
+ *
+ * Messages (Server → Client):
+ *   { type: "reload", components: string[] }
+ *   { type: "rebuilding", components: string[] }
+ *   { type: "error", message: string }
+ *
+ * Messages (Client → Server):
+ *   { type: "ping" }
+ */
+import * as http from 'http';
+export interface WSClient {
+    send: (data: string) => void;
+    close: () => void;
+}
+export interface WSMessage {
+    type: string;
+    components?: string[];
+    message?: string;
+}
+export type WSMessageHandler = (client: WSClient, message: WSMessage) => void;
+/**
+ * Minimal WebSocket server that attaches to an existing HTTP server.
+ */
+export declare class WebSocketServer {
+    private wss;
+    private clients;
+    private messageHandler?;
+    constructor();
+    get clientCount(): number;
+    /**
+     * Attach the WebSocket server to an HTTP server.
+     * Handles upgrade requests to /ws.
+     */
+    attach(server: http.Server): void;
+    /**
+     * Register a handler for incoming messages.
+     */
+    onMessage(handler: WSMessageHandler): void;
+    /**
+     * Broadcast a message to all connected clients.
+     */
+    broadcast(message: WSMessage): void;
+    /**
+     * Close all connections.
+     */
+    closeAll(): void;
+}
+//# sourceMappingURL=websocket.d.ts.map

package/dist/server/wiki/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../../src/server/wiki/websocket.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAO7B,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,KAAK,IAAI,CAAC;AAM9E;;GAEG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,GAAG,CAAqB;IAChC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,cAAc,CAAC,CAAmB;;IAM1C,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI;IAwCjC;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAI1C;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI;IAOnC;;OAEG;IACH,QAAQ,IAAI,IAAI;CAMnB"}

package/dist/server/wiki/websocket.js

@@ -0,0 +1,132 @@
+"use strict";
+/**
+ * WebSocket Server
+ *
+ * Uses the `ws` library in noServer mode, attached to an existing HTTP server.
+ * Used for live-reload notifications when --watch is enabled.
+ *
+ * Messages (Server → Client):
+ *   { type: "reload", components: string[] }
+ *   { type: "rebuilding", components: string[] }
+ *   { type: "error", message: string }
+ *
+ * Messages (Client → Server):
+ *   { type: "ping" }
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketServer = void 0;
+const WS = __importStar(require("ws"));
+// ============================================================================
+// WebSocketServer
+// ============================================================================
+/**
+ * Minimal WebSocket server that attaches to an existing HTTP server.
+ */
+class WebSocketServer {
+    constructor() {
+        this.clients = new Set();
+        this.wss = new WS.WebSocketServer({ noServer: true });
+    }
+    get clientCount() {
+        return this.clients.size;
+    }
+    /**
+     * Attach the WebSocket server to an HTTP server.
+     * Handles upgrade requests to /ws.
+     */
+    attach(server) {
+        server.on('upgrade', (req, socket, head) => {
+            if (req.url !== '/ws') {
+                socket.destroy();
+                return;
+            }
+            this.wss.handleUpgrade(req, socket, head, (wsSocket) => {
+                const client = {
+                    send: (data) => {
+                        if (wsSocket.readyState === WS.WebSocket.OPEN) {
+                            wsSocket.send(data);
+                        }
+                    },
+                    close: () => {
+                        wsSocket.close();
+                        this.clients.delete(client);
+                    },
+                };
+                this.clients.add(client);
+                wsSocket.on('message', (raw) => {
+                    try {
+                        const parsed = JSON.parse(raw.toString());
+                        if (this.messageHandler) {
+                            this.messageHandler(client, parsed);
+                        }
+                    }
+                    catch {
+                        // Ignore parse errors
+                    }
+                });
+                wsSocket.on('close', () => {
+                    this.clients.delete(client);
+                });
+            });
+        });
+    }
+    /**
+     * Register a handler for incoming messages.
+     */
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    /**
+     * Broadcast a message to all connected clients.
+     */
+    broadcast(message) {
+        const data = JSON.stringify(message);
+        for (const client of this.clients) {
+            client.send(data);
+        }
+    }
+    /**
+     * Close all connections.
+     */
+    closeAll() {
+        for (const client of this.clients) {
+            client.close();
+        }
+        this.clients.clear();
+    }
+}
+exports.WebSocketServer = WebSocketServer;
+//# sourceMappingURL=websocket.js.map

package/dist/server/wiki/websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.js","sourceRoot":"","sources":["../../../src/server/wiki/websocket.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGH,uCAAyB;AAmBzB,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;GAEG;AACH,MAAa,eAAe;IAKxB;QAHQ,YAAO,GAAkB,IAAI,GAAG,EAAE,CAAC;QAIvC,IAAI,CAAC,GAAG,GAAG,IAAI,EAAE,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,WAAW;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,MAAmB;QACtB,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YACvC,IAAI,GAAG,CAAC,GAAG,KAAK,KAAK,EAAE,CAAC;gBACpB,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,OAAO;YACX,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,EAAE;gBACnD,MAAM,MAAM,GAAa;oBACrB,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE;wBACnB,IAAI,QAAQ,CAAC,UAAU,KAAK,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;4BAC5C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;wBACxB,CAAC;oBACL,CAAC;oBACD,KAAK,EAAE,GAAG,EAAE;wBACR,QAAQ,CAAC,KAAK,EAAE,CAAC;wBACjB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBAChC,CAAC;iBACJ,CAAC;gBAEF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBAEzB,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE;oBAC3B,IAAI,CAAC;wBACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;wBAC1C,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;4BACtB,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;wBACxC,CAAC;oBACL,CAAC;oBAAC,MAAM,CAAC;wBACL,sBAAsB;oBAC1B,CAAC;gBACL,CAAC,CAAC,CAAC;gBAEH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;oBACtB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAChC,CAAC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,OAAyB;QAC/B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,OAAkB;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACrC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAChC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACL,CAAC;IAED;;OAEG;IACH,QAAQ;QACJ,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAChC,MAAM,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACJ;AAnFD,0CAmFC"}

package/dist/server/wiki/wiki-backend.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Wiki Backend Types
+ *
+ * Shared interfaces used by the unified ask/explore/generate handlers.
+ * Each interface represents a "resolved context" — the dependencies a handler
+ * needs after the caller has determined which wiki backend is being used.
+ *
+ * - NativeWikiBackend: resolves from WikiManager (multi-tenant)
+ * - DeepWikiBackend: resolves from flat injected options (single-wiki)
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+import type { ContextBuilder } from './context-builder';
+import type { ConversationSessionManager } from './conversation-session-manager';
+import type { AskAIFunction } from './types';
+import type { WikiData } from './wiki-data';
+/** Resolved context for the ask handler core logic. */
+export interface ResolvedAskContext {
+    contextBuilder: ContextBuilder;
+    sendMessage: AskAIFunction;
+    model?: string;
+    workingDirectory?: string;
+    sessionManager?: ConversationSessionManager;
+}
+/** Resolved context for the explore handler core logic. */
+export interface ResolvedExploreContext {
+    wikiData: WikiData;
+    sendMessage: AskAIFunction;
+    model?: string;
+    workingDirectory?: string;
+}
+/**
+ * Minimal wiki object required by the generate handler.
+ * WikiManager's WikiRuntime satisfies this interface.
+ */
+export interface GenerateWiki {
+    registration: {
+        repoPath?: string;
+        wikiDir: string;
+    };
+    wikiData: {
+        graph: any;
+        reload: () => void;
+        getComponentDetail: (id: string) => any;
+    };
+}
+/**
+ * Provider interface for looking up wikis by ID.
+ * WikiManager satisfies this interface natively via its `get()` method.
+ */
+export interface WikiProvider {
+    get(wikiId: string): GenerateWiki | undefined;
+}
+/**
+ * Create a WikiProvider that always returns a single wiki regardless of wikiId.
+ * Used by the deep-wiki standalone server where there is only one wiki.
+ */
+export declare function createSingleWikiProvider(wiki: GenerateWiki): WikiProvider;
+//# sourceMappingURL=wiki-backend.d.ts.map

package/dist/server/wiki/wiki-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-backend.d.ts","sourceRoot":"","sources":["../../../src/server/wiki/wiki-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAM5C,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,aAAa,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,0BAA0B,CAAC;CAC/C;AAMD,2DAA2D;AAC3D,MAAM,WAAW,sBAAsB;IACnC,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,aAAa,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAMD;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB,YAAY,EAAE;QACV,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,QAAQ,EAAE;QAEN,KAAK,EAAE,GAAG,CAAC;QACX,MAAM,EAAE,MAAM,IAAI,CAAC;QAEnB,kBAAkB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,GAAG,CAAC;KAC3C,CAAC;CACL;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;CACjD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAIzE"}

package/dist/server/wiki/wiki-backend.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Wiki Backend Types
+ *
+ * Shared interfaces used by the unified ask/explore/generate handlers.
+ * Each interface represents a "resolved context" — the dependencies a handler
+ * needs after the caller has determined which wiki backend is being used.
+ *
+ * - NativeWikiBackend: resolves from WikiManager (multi-tenant)
+ * - DeepWikiBackend: resolves from flat injected options (single-wiki)
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSingleWikiProvider = createSingleWikiProvider;
+/**
+ * Create a WikiProvider that always returns a single wiki regardless of wikiId.
+ * Used by the deep-wiki standalone server where there is only one wiki.
+ */
+function createSingleWikiProvider(wiki) {
+    return {
+        get: () => wiki,
+    };
+}
+//# sourceMappingURL=wiki-backend.js.map

package/dist/server/wiki/wiki-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-backend.js","sourceRoot":"","sources":["../../../src/server/wiki/wiki-backend.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AAkEH,4DAIC;AARD;;;GAGG;AACH,SAAgB,wBAAwB,CAAC,IAAkB;IACvD,OAAO;QACH,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI;KAClB,CAAC;AACN,CAAC"}