@ginkoai/cli 1.0.0 → 1.4.1

package/dist/lib/sync/uploader.js

@@ -0,0 +1,188 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-07
+ * @tags: [sync, upload, progress, batch, task-026]
+ * @related: [sync.ts, scanner.ts, conflict-detector.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [axios]
+ */
+/**
+ * Node Uploader (TASK-026)
+ *
+ * Uploads local nodes to cloud knowledge graph:
+ * - Batch uploads with progress tracking
+ * - Relationship creation after nodes uploaded
+ * - Error handling with retry logic
+ * - Real-time progress reporting
+ */
+import axios from 'axios';
+/**
+ * Upload nodes to cloud with progress tracking
+ */
+export async function uploadNodes(nodes, graphId, token, apiUrl, onProgress) {
+    const baseUrl = apiUrl || process.env.GINKO_API_URL || 'https://app.ginkoai.com';
+    const result = {
+        total: nodes.length,
+        uploaded: 0,
+        failed: 0,
+        skipped: 0,
+        relationshipsCreated: 0,
+        errors: [],
+    };
+    // Map to store nodeId by title for relationship creation
+    const nodeIdMap = new Map();
+    // Phase 1: Upload nodes
+    for (const node of nodes) {
+        try {
+            const nodeId = await uploadSingleNode(node, graphId, token, baseUrl);
+            if (nodeId) {
+                nodeIdMap.set(`${node.type}:${node.title}`, nodeId);
+                result.uploaded++;
+            }
+            else {
+                result.skipped++;
+            }
+            // Report progress
+            if (onProgress) {
+                onProgress({ ...result });
+            }
+        }
+        catch (error) {
+            result.failed++;
+            result.errors.push({
+                node,
+                error: error.message,
+            });
+            // Continue with other nodes even if one fails
+        }
+    }
+    // Phase 2: Create relationships
+    for (const node of nodes) {
+        const sourceId = nodeIdMap.get(`${node.type}:${node.title}`);
+        if (!sourceId || node.relationships.length === 0) {
+            continue;
+        }
+        for (const relationship of node.relationships) {
+            try {
+                // Find target node ID
+                let targetId;
+                if (relationship.targetId) {
+                    targetId = relationship.targetId;
+                }
+                else if (relationship.targetTitle) {
+                    // Try to find in uploaded nodes
+                    for (const [key, id] of nodeIdMap.entries()) {
+                        if (key.includes(relationship.targetTitle)) {
+                            targetId = id;
+                            break;
+                        }
+                    }
+                }
+                if (targetId) {
+                    await createRelationship(sourceId, targetId, relationship.type, graphId, token, baseUrl);
+                    result.relationshipsCreated++;
+                }
+            }
+            catch (error) {
+                // Log relationship errors but don't fail the sync
+                console.warn(`⚠️  Failed to create relationship: ${error.message}`);
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Upload a single node to cloud
+ */
+async function uploadSingleNode(node, graphId, token, baseUrl) {
+    try {
+        const response = await axios.post(`${baseUrl}/api/v1/knowledge/nodes`, {
+            type: node.type,
+            graphId,
+            data: {
+                title: node.title,
+                content: node.content,
+                status: node.status,
+                tags: node.tags,
+                ...node.metadata,
+            },
+        }, {
+            headers: {
+                'Authorization': `Bearer ${token}`,
+                'Content-Type': 'application/json',
+            },
+        });
+        return response.data.node?.id || response.data.id || null;
+    }
+    catch (error) {
+        if (error.response?.status === 409) {
+            // Node already exists - not an error
+            return null;
+        }
+        throw new Error(`Failed to upload ${node.title}: ${error.message}`);
+    }
+}
+/**
+ * Create relationship between nodes
+ */
+async function createRelationship(sourceId, targetId, type, graphId, token, baseUrl) {
+    try {
+        await axios.post(`${baseUrl}/api/v1/knowledge/relationships`, {
+            sourceId,
+            targetId,
+            type,
+            graphId,
+            properties: {},
+        }, {
+            headers: {
+                'Authorization': `Bearer ${token}`,
+                'Content-Type': 'application/json',
+            },
+        });
+    }
+    catch (error) {
+        // Relationship might already exist - not a critical error
+        if (error.response?.status === 409) {
+            return;
+        }
+        throw new Error(`Failed to create relationship: ${error.message}`);
+    }
+}
+/**
+ * Batch upload nodes (future optimization)
+ */
+export async function batchUploadNodes(nodes, graphId, token, baseUrl, batchSize = 10) {
+    const nodeIds = [];
+    // Split into batches
+    for (let i = 0; i < nodes.length; i += batchSize) {
+        const batch = nodes.slice(i, i + batchSize);
+        try {
+            const response = await axios.post(`${baseUrl}/api/v1/knowledge/nodes/batch`, {
+                graphId,
+                nodes: batch.map(node => ({
+                    type: node.type,
+                    data: {
+                        title: node.title,
+                        content: node.content,
+                        status: node.status,
+                        tags: node.tags,
+                        ...node.metadata,
+                    },
+                })),
+            }, {
+                headers: {
+                    'Authorization': `Bearer ${token}`,
+                    'Content-Type': 'application/json',
+                },
+            });
+            nodeIds.push(...(response.data.nodeIds || []));
+        }
+        catch (error) {
+            throw new Error(`Batch upload failed: ${error.message}`);
+        }
+    }
+    return nodeIds;
+}
+//# sourceMappingURL=uploader.js.map

package/dist/lib/sync/uploader.js.map

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

package/dist/lib/write-dispatcher/adapters/graph-adapter.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @fileType: adapter
+ * @status: current
+ * @updated: 2025-11-02
+ * @tags: [write-adapter, graph, neo4j, cloud, multi-tenant, adr-041]
+ * @related: [../write-dispatcher.ts, ../../api/v1/graph/_cloud-graph-client.ts, local-adapter.ts]
+ * @priority: critical
+ * @complexity: medium
+ * @dependencies: []
+ */
+import type { WriteAdapter, KnowledgeDocument, WriteResult } from '../write-dispatcher.js';
+/**
+ * GraphAdapter Configuration
+ */
+export interface GraphAdapterConfig {
+    apiUrl: string;
+    bearerToken: string;
+    graphId: string;
+    timeout?: number;
+}
+/**
+ * GraphAdapter
+ *
+ * Writes knowledge documents to Neo4j cloud graph via REST API.
+ * Implements multi-tenant writes using CloudGraphClient.
+ *
+ * Environment Variables:
+ * - GINKO_GRAPH_ENABLED: 'true' to enable graph writes
+ * - GINKO_GRAPH_API_URL: Graph API endpoint (default: https://mcp.ginko.ai)
+ * - GINKO_GRAPH_TOKEN: Bearer token for authentication
+ * - GINKO_GRAPH_ID: Graph ID for user's namespace
+ *
+ * Usage:
+ * ```typescript
+ * const adapter = new GraphAdapter({
+ *   apiUrl: process.env.GINKO_GRAPH_API_URL || 'https://mcp.ginko.ai',
+ *   bearerToken: process.env.GINKO_GRAPH_TOKEN || '',
+ *   graphId: process.env.GINKO_GRAPH_ID || ''
+ * });
+ *
+ * dispatcher.registerAdapter(adapter);
+ * ```
+ */
+export declare class GraphAdapter implements WriteAdapter {
+    name: string;
+    private config;
+    constructor(config: GraphAdapterConfig);
+    /**
+     * Check if adapter is enabled via environment variable
+     */
+    enabled(): boolean;
+    /**
+     * Write knowledge document to graph via REST API
+     */
+    write(document: KnowledgeDocument): Promise<WriteResult>;
+    /**
+     * Create node in graph via REST API
+     */
+    private createNode;
+    /**
+     * Map KnowledgeDocument to Neo4j node data
+     */
+    private mapDocumentToNodeData;
+    /**
+     * Get adapter configuration (for debugging)
+     */
+    getConfig(): {
+        apiUrl: string;
+        graphId: string;
+        hasToken: boolean;
+    };
+}
+/**
+ * Create GraphAdapter from environment variables
+ */
+export declare function createGraphAdapterFromEnv(): GraphAdapter;
+//# sourceMappingURL=graph-adapter.d.ts.map

package/dist/lib/write-dispatcher/adapters/graph-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-adapter.d.ts","sourceRoot":"","sources":["../../../../src/lib/write-dispatcher/adapters/graph-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACZ,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,YAAa,YAAW,YAAY;IAC/C,IAAI,SAAW;IACf,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,EAAE,kBAAkB;IAStC;;OAEG;IACH,OAAO,IAAI,OAAO;IAMlB;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IAwB9D;;OAEG;YACW,UAAU;IAiDxB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAwC7B;;OAEG;IACH,SAAS,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE;CAOpE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,YAAY,CAOxD"}

package/dist/lib/write-dispatcher/adapters/graph-adapter.js

@@ -0,0 +1,178 @@
+/**
+ * @fileType: adapter
+ * @status: current
+ * @updated: 2025-11-02
+ * @tags: [write-adapter, graph, neo4j, cloud, multi-tenant, adr-041]
+ * @related: [../write-dispatcher.ts, ../../api/v1/graph/_cloud-graph-client.ts, local-adapter.ts]
+ * @priority: critical
+ * @complexity: medium
+ * @dependencies: []
+ */
+/**
+ * GraphAdapter
+ *
+ * Writes knowledge documents to Neo4j cloud graph via REST API.
+ * Implements multi-tenant writes using CloudGraphClient.
+ *
+ * Environment Variables:
+ * - GINKO_GRAPH_ENABLED: 'true' to enable graph writes
+ * - GINKO_GRAPH_API_URL: Graph API endpoint (default: https://mcp.ginko.ai)
+ * - GINKO_GRAPH_TOKEN: Bearer token for authentication
+ * - GINKO_GRAPH_ID: Graph ID for user's namespace
+ *
+ * Usage:
+ * ```typescript
+ * const adapter = new GraphAdapter({
+ *   apiUrl: process.env.GINKO_GRAPH_API_URL || 'https://mcp.ginko.ai',
+ *   bearerToken: process.env.GINKO_GRAPH_TOKEN || '',
+ *   graphId: process.env.GINKO_GRAPH_ID || ''
+ * });
+ *
+ * dispatcher.registerAdapter(adapter);
+ * ```
+ */
+export class GraphAdapter {
+    name = 'graph';
+    config;
+    constructor(config) {
+        this.config = {
+            apiUrl: config.apiUrl,
+            bearerToken: config.bearerToken,
+            graphId: config.graphId,
+            timeout: config.timeout || 10000,
+        };
+    }
+    /**
+     * Check if adapter is enabled via environment variable
+     */
+    enabled() {
+        return process.env.GINKO_GRAPH_ENABLED === 'true' &&
+            !!this.config.bearerToken &&
+            !!this.config.graphId;
+    }
+    /**
+     * Write knowledge document to graph via REST API
+     */
+    async write(document) {
+        if (!this.enabled()) {
+            throw new Error('GraphAdapter is not enabled. Check GINKO_GRAPH_ENABLED environment variable.');
+        }
+        try {
+            // Map KnowledgeDocument to graph node data
+            const nodeData = this.mapDocumentToNodeData(document);
+            // POST to /api/v1/graph/nodes
+            const response = await this.createNode(document.type, nodeData);
+            return {
+                source: 'graph',
+                id: response.nodeId,
+                timestamp: new Date().toISOString(),
+            };
+        }
+        catch (error) {
+            throw new Error(`GraphAdapter write failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Create node in graph via REST API
+     */
+    async createNode(label, data) {
+        const url = `${this.config.apiUrl}/api/v1/graph/nodes`;
+        const payload = {
+            graphId: this.config.graphId,
+            label,
+            data,
+        };
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+        try {
+            // Add Vercel bypass token to URL if available (for deployment protection)
+            let requestUrl = url;
+            const bypassToken = process.env.VERCEL_AUTOMATION_BYPASS_SECRET;
+            if (bypassToken) {
+                requestUrl += `?x-vercel-set-bypass-cookie=true&x-vercel-protection-bypass=${bypassToken}`;
+            }
+            const response = await fetch(requestUrl, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${this.config.bearerToken}`,
+                },
+                body: JSON.stringify(payload),
+                signal: controller.signal,
+                redirect: 'follow', // Follow redirects (should be default, but explicitly set)
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                const errorBody = await response.text().catch(() => 'Unknown error');
+                throw new Error(`HTTP ${response.status}: ${errorBody}`);
+            }
+            const result = await response.json();
+            return result;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            throw error;
+        }
+    }
+    /**
+     * Map KnowledgeDocument to Neo4j node data
+     */
+    mapDocumentToNodeData(document) {
+        const nodeData = {
+            id: document.id,
+            title: document.title,
+            content: document.content,
+            ...document.data,
+        };
+        // Add metadata if provided
+        if (document.metadata) {
+            if (document.metadata.tags) {
+                nodeData.tags = document.metadata.tags;
+            }
+            if (document.metadata.status) {
+                nodeData.status = document.metadata.status;
+            }
+            if (document.metadata.category) {
+                nodeData.category = document.metadata.category;
+            }
+            if (document.metadata.impact) {
+                nodeData.impact = document.metadata.impact;
+            }
+            if (document.metadata.files) {
+                nodeData.files = document.metadata.files;
+            }
+            if (document.metadata.timestamp) {
+                nodeData.timestamp = document.metadata.timestamp;
+            }
+            // Include any other metadata fields
+            Object.entries(document.metadata).forEach(([key, value]) => {
+                if (!['tags', 'status', 'category', 'impact', 'files', 'timestamp'].includes(key)) {
+                    nodeData[key] = value;
+                }
+            });
+        }
+        return nodeData;
+    }
+    /**
+     * Get adapter configuration (for debugging)
+     */
+    getConfig() {
+        return {
+            apiUrl: this.config.apiUrl,
+            graphId: this.config.graphId,
+            hasToken: !!this.config.bearerToken,
+        };
+    }
+}
+/**
+ * Create GraphAdapter from environment variables
+ */
+export function createGraphAdapterFromEnv() {
+    return new GraphAdapter({
+        apiUrl: process.env.GINKO_GRAPH_API_URL || 'https://mcp.ginko.ai',
+        bearerToken: process.env.GINKO_GRAPH_TOKEN || '',
+        graphId: process.env.GINKO_GRAPH_ID || '',
+        timeout: parseInt(process.env.GINKO_GRAPH_TIMEOUT || '10000', 10),
+    });
+}
+//# sourceMappingURL=graph-adapter.js.map

package/dist/lib/write-dispatcher/adapters/graph-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-adapter.js","sourceRoot":"","sources":["../../../../src/lib/write-dispatcher/adapters/graph-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkBH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,YAAY;IACvB,IAAI,GAAG,OAAO,CAAC;IACP,MAAM,CAAqB;IAEnC,YAAY,MAA0B;QACpC,IAAI,CAAC,MAAM,GAAG;YACZ,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,KAAK;SACjC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,MAAM;YAC1C,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW;YACzB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,QAA2B;QACrC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;QAClG,CAAC;QAED,IAAI,CAAC;YACH,2CAA2C;YAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;YAEtD,8BAA8B;YAC9B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAEhE,OAAO;gBACL,MAAM,EAAE,OAAO;gBACf,EAAE,EAAE,QAAQ,CAAC,MAAM;gBACnB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,8BAA8B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACvF,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,UAAU,CACtB,KAAa,EACb,IAAyB;QAEzB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,qBAAqB,CAAC;QAEvD,MAAM,OAAO,GAAG;YACd,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,KAAK;YACL,IAAI;SACL,CAAC;QAEF,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE5E,IAAI,CAAC;YACH,0EAA0E;YAC1E,IAAI,UAAU,GAAG,GAAG,CAAC;YACrB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC;YAChE,IAAI,WAAW,EAAE,CAAC;gBAChB,UAAU,IAAI,+DAA+D,WAAW,EAAE,CAAC;YAC7F,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE;gBACvC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,eAAe,EAAE,UAAU,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE;iBACrD;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;gBAC7B,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,QAAQ,EAAE,QAAQ,EAAE,2DAA2D;aAChF,CAAC,CAAC;YAEH,YAAY,CAAC,SAAS,CAAC,CAAC;YAExB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC;gBACrE,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC,CAAC;YAC3D,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA0E,CAAC;YAC7G,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACK,qBAAqB,CAAC,QAA2B;QACvD,MAAM,QAAQ,GAAwB;YACpC,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,GAAG,QAAQ,CAAC,IAAI;SACjB,CAAC;QAEF,2BAA2B;QAC3B,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACtB,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAC3B,QAAQ,CAAC,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;YACzC,CAAC;YACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAC7B,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC7C,CAAC;YACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBAC/B,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACjD,CAAC;YACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAC7B,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC7C,CAAC;YACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;gBAC5B,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;YAC3C,CAAC;YACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;gBAChC,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC;YACnD,CAAC;YAED,oCAAoC;YACpC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;gBACzD,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBAClF,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBACxB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC1B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW;SACpC,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO,IAAI,YAAY,CAAC;QACtB,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,sBAAsB;QACjE,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE;QAChD,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE;QACzC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,EAAE,EAAE,CAAC;KAClE,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/write-dispatcher/adapters/local-adapter.d.ts

@@ -0,0 +1,133 @@
+/**
+ * @fileType: adapter
+ * @status: current
+ * @updated: 2025-11-02
+ * @tags: [write-adapter, local, filesystem, markdown, dual-write, adr-041]
+ * @related: [../write-dispatcher.ts, graph-adapter.ts, ../../packages/cli/src/core/session-log-manager.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: [fs-extra]
+ */
+import type { WriteAdapter, KnowledgeDocument, WriteResult } from '../write-dispatcher.js';
+/**
+ * LocalAdapter Configuration
+ */
+export interface LocalAdapterConfig {
+    ginkoDir: string;
+    archiveDir?: string;
+}
+/**
+ * LocalAdapter
+ *
+ * Writes knowledge documents to local filesystem as Markdown files.
+ * Used during dual-write migration period for safety and rollback capability.
+ *
+ * Environment Variables:
+ * - GINKO_DUAL_WRITE: 'true' to enable local writes alongside graph writes
+ *
+ * File Structure:
+ * - ADR: .ginko/archive/ADR/ADR-{number}-{slug}.md
+ * - PRD: .ginko/archive/PRD/PRD-{number}-{slug}.md
+ * - Pattern: .ginko/archive/patterns/{slug}.md
+ * - Gotcha: .ginko/archive/gotchas/{slug}.md
+ * - LogEntry: .ginko/sessions/{user}/current-session-log.md (append)
+ *
+ * Usage:
+ * ```typescript
+ * const adapter = new LocalAdapter({
+ *   ginkoDir: '/path/to/.ginko'
+ * });
+ *
+ * dispatcher.registerAdapter(adapter);
+ * ```
+ */
+export declare class LocalAdapter implements WriteAdapter {
+    name: string;
+    private config;
+    constructor(config: LocalAdapterConfig);
+    /**
+     * Check if adapter is enabled via environment variable
+     */
+    enabled(): boolean;
+    /**
+     * Write knowledge document to local filesystem
+     */
+    write(document: KnowledgeDocument): Promise<WriteResult>;
+    /**
+     * Write document to appropriate location
+     */
+    private writeDocument;
+    /**
+     * Write ADR to docs/adr/
+     */
+    private writeADR;
+    /**
+     * Write PRD to docs/PRD/
+     */
+    private writePRD;
+    /**
+     * Write Pattern to archive/patterns/
+     */
+    private writePattern;
+    /**
+     * Write Gotcha to archive/gotchas/
+     */
+    private writeGotcha;
+    /**
+     * Write ContextModule to context/modules/
+     */
+    private writeContextModule;
+    /**
+     * Append LogEntry to session log
+     */
+    private appendLogEntry;
+    /**
+     * Write Session to archive/
+     */
+    private writeSession;
+    /**
+     * Write CodeFile to archive/code/
+     */
+    private writeCodeFile;
+    /**
+     * Format ADR markdown with frontmatter
+     */
+    private formatADR;
+    /**
+     * Format PRD markdown with frontmatter
+     */
+    private formatPRD;
+    /**
+     * Format Pattern markdown
+     */
+    private formatPattern;
+    /**
+     * Format Gotcha markdown
+     */
+    private formatGotcha;
+    /**
+     * Format ContextModule markdown
+     */
+    private formatContextModule;
+    /**
+     * Format log entry for appending
+     */
+    private formatLogEntry;
+    /**
+     * Build YAML frontmatter from object
+     */
+    private buildFrontmatter;
+    /**
+     * Slugify a string for filename
+     */
+    private slugify;
+    /**
+     * Extract number from ID (e.g., 'adr_042' -> 42)
+     */
+    private extractNumber;
+}
+/**
+ * Create LocalAdapter from environment and Ginko directory
+ */
+export declare function createLocalAdapterFromEnv(ginkoDir: string): Promise<LocalAdapter>;
+//# sourceMappingURL=local-adapter.d.ts.map

package/dist/lib/write-dispatcher/adapters/local-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-adapter.d.ts","sourceRoot":"","sources":["../../../../src/lib/write-dispatcher/adapters/local-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACZ,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,YAAa,YAAW,YAAY;IAC/C,IAAI,SAAW;IACf,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,EAAE,kBAAkB;IAOtC;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IAoB9D;;OAEG;YACW,aAAa;IAuB3B;;OAEG;YACW,QAAQ;IAetB;;OAEG;YACW,QAAQ;IAetB;;OAEG;YACW,YAAY;IAc1B;;OAEG;YACW,WAAW;IAczB;;OAEG;YACW,kBAAkB;IAchC;;OAEG;YACW,cAAc;IAc5B;;OAEG;YACW,YAAY;IAa1B;;OAEG;YACW,aAAa;IAc3B;;OAEG;IACH,OAAO,CAAC,SAAS;IAWjB;;OAEG;IACH,OAAO,CAAC,SAAS;IAWjB;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAqBtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoBxB;;OAEG;IACH,OAAO,CAAC,OAAO;IAQf;;OAEG;IACH,OAAO,CAAC,aAAa;CAItB;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAEvF"}