@ginkoai/cli 1.0.0 → 1.4.1

package/dist/lib/sync/logger.js

@@ -0,0 +1,202 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-07
+ * @tags: [sync, logging, rollback, audit, task-026]
+ * @related: [sync.ts, uploader.ts]
+ * @priority: medium
+ * @complexity: low
+ * @dependencies: [fs]
+ */
+/**
+ * Sync Logger (TASK-026)
+ *
+ * Logs sync operations for audit and rollback:
+ * - Stores sync metadata (timestamp, nodes uploaded, conflicts)
+ * - Enables rollback to previous state
+ * - Provides sync history
+ */
+import fs from 'fs/promises';
+import path from 'path';
+import { homedir } from 'os';
+/**
+ * Sync logger for tracking sync operations
+ */
+export class SyncLogger {
+    graphId;
+    syncId;
+    logDir;
+    logFile;
+    constructor(graphId) {
+        this.graphId = graphId;
+        this.syncId = this.generateSyncId();
+        // Store logs in user's home directory
+        this.logDir = path.join(homedir(), '.ginko', 'sync-logs');
+        this.logFile = path.join(this.logDir, `${this.syncId}.json`);
+    }
+    /**
+     * Initialize logger (create directories)
+     */
+    async init() {
+        try {
+            await fs.mkdir(this.logDir, { recursive: true });
+        }
+        catch (error) {
+            throw new Error(`Failed to initialize sync logger: ${error.message}`);
+        }
+    }
+    /**
+     * Log sync operation
+     */
+    async logSync(log) {
+        try {
+            const fullLog = {
+                syncId: this.syncId,
+                ...log,
+            };
+            await fs.writeFile(this.logFile, JSON.stringify(fullLog, null, 2), 'utf-8');
+            // Also append to history file
+            await this.appendToHistory(fullLog);
+        }
+        catch (error) {
+            console.warn(`⚠️  Failed to write sync log: ${error.message}`);
+        }
+    }
+    /**
+     * Append to sync history
+     */
+    async appendToHistory(log) {
+        try {
+            const historyFile = path.join(this.logDir, 'history.jsonl');
+            const entry = JSON.stringify(log) + '\n';
+            await fs.appendFile(historyFile, entry, 'utf-8');
+        }
+        catch (error) {
+            // Non-critical error
+            console.warn(`⚠️  Failed to append to history: ${error.message}`);
+        }
+    }
+    /**
+     * Get sync log by ID
+     */
+    async getSyncLog(syncId) {
+        try {
+            const logFile = path.join(this.logDir, `${syncId}.json`);
+            const content = await fs.readFile(logFile, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    /**
+     * Get all sync logs
+     */
+    async getAllSyncLogs() {
+        try {
+            const files = await fs.readdir(this.logDir);
+            const logs = [];
+            for (const file of files) {
+                if (file.endsWith('.json') && file !== 'history.jsonl') {
+                    const content = await fs.readFile(path.join(this.logDir, file), 'utf-8');
+                    logs.push(JSON.parse(content));
+                }
+            }
+            // Sort by timestamp (newest first)
+            return logs.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+        }
+        catch (error) {
+            return [];
+        }
+    }
+    /**
+     * Get sync history from JSONL file
+     */
+    async getSyncHistory() {
+        try {
+            const historyFile = path.join(this.logDir, 'history.jsonl');
+            const content = await fs.readFile(historyFile, 'utf-8');
+            const logs = content
+                .split('\n')
+                .filter(line => line.trim())
+                .map(line => JSON.parse(line));
+            return logs.reverse(); // Newest first
+        }
+        catch (error) {
+            return [];
+        }
+    }
+    /**
+     * Generate unique sync ID
+     */
+    generateSyncId() {
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        return `sync-${timestamp}`;
+    }
+    /**
+     * Get log file path
+     */
+    getLogPath() {
+        return this.logFile;
+    }
+    /**
+     * Get sync ID
+     */
+    getSyncId() {
+        return this.syncId;
+    }
+    /**
+     * Clean up old logs (keep last N)
+     */
+    async cleanupOldLogs(keepCount = 10) {
+        try {
+            const logs = await this.getAllSyncLogs();
+            if (logs.length <= keepCount) {
+                return;
+            }
+            // Delete oldest logs
+            const logsToDelete = logs.slice(keepCount);
+            for (const log of logsToDelete) {
+                const logFile = path.join(this.logDir, `${log.syncId}.json`);
+                try {
+                    await fs.unlink(logFile);
+                }
+                catch (error) {
+                    // Ignore errors when deleting old logs
+                }
+            }
+        }
+        catch (error) {
+            // Non-critical error
+            console.warn(`⚠️  Failed to cleanup old logs: ${error.message}`);
+        }
+    }
+}
+/**
+ * Get sync statistics
+ */
+export function getSyncStats(logs) {
+    if (logs.length === 0) {
+        return {
+            totalSyncs: 0,
+            totalNodesUploaded: 0,
+            totalRelationships: 0,
+            averageDuration: 0,
+            successRate: 0,
+        };
+    }
+    const totalSyncs = logs.length;
+    const totalNodesUploaded = logs.reduce((sum, log) => sum + log.nodesUploaded, 0);
+    const totalRelationships = logs.reduce((sum, log) => sum + log.relationshipsCreated, 0);
+    const averageDuration = logs.reduce((sum, log) => sum + log.duration, 0) / totalSyncs;
+    const successfulSyncs = logs.filter(log => log.nodesFailed === 0).length;
+    const successRate = (successfulSyncs / totalSyncs) * 100;
+    return {
+        totalSyncs,
+        totalNodesUploaded,
+        totalRelationships,
+        averageDuration: Math.round(averageDuration),
+        successRate: Math.round(successRate * 10) / 10,
+    };
+}
+//# sourceMappingURL=logger.js.map

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

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

package/dist/lib/sync/parser.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-07
+ * @tags: [sync, parser, markdown, yaml, task-026]
+ * @related: [scanner.ts, sync.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [gray-matter, crypto]
+ */
+export interface ParsedNode {
+    title: string;
+    content: string;
+    hash: string;
+    status: string;
+    tags: string[];
+    frontmatter: Record<string, any>;
+    relationships: Array<{
+        type: 'IMPLEMENTS' | 'REFERENCES' | 'TAGGED_WITH';
+        targetId?: string;
+        targetTitle?: string;
+    }>;
+}
+/**
+ * Parse markdown file with YAML frontmatter
+ */
+export declare function parseMarkdownFile(filePath: string): Promise<ParsedNode>;
+/**
+ * Validate parsed node has required fields
+ */
+export declare function validateParsedNode(node: ParsedNode): boolean;
+//# sourceMappingURL=parser.d.ts.map

package/dist/lib/sync/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmBH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,aAAa,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,YAAY,GAAG,YAAY,GAAG,aAAa,CAAC;QAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAiC7E;AAgJD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAE5D"}

package/dist/lib/sync/parser.js

@@ -0,0 +1,180 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-07
+ * @tags: [sync, parser, markdown, yaml, task-026]
+ * @related: [scanner.ts, sync.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [gray-matter, crypto]
+ */
+/**
+ * Markdown Parser (TASK-026)
+ *
+ * Parses markdown files with YAML frontmatter to extract:
+ * - Title (from frontmatter or first h1)
+ * - Content (full markdown)
+ * - Metadata (YAML frontmatter)
+ * - Status, tags, dependencies
+ * - Relationships (IMPLEMENTS, REFERENCES, TAGGED_WITH)
+ *
+ * Supports both ADR and PRD formats with flexible parsing
+ */
+import fs from 'fs/promises';
+import matter from 'gray-matter';
+import crypto from 'crypto';
+/**
+ * Parse markdown file with YAML frontmatter
+ */
+export async function parseMarkdownFile(filePath) {
+    try {
+        const fileContent = await fs.readFile(filePath, 'utf-8');
+        const { data: frontmatter, content } = matter(fileContent);
+        // Generate content hash for duplicate detection
+        const hash = generateHash(content);
+        // Extract title
+        const title = extractTitle(frontmatter, content, filePath);
+        // Extract status
+        const status = extractStatus(frontmatter, content);
+        // Extract tags
+        const tags = extractTags(frontmatter, content);
+        // Extract relationships
+        const relationships = extractRelationships(frontmatter, content);
+        return {
+            title,
+            content: fileContent, // Full content including frontmatter
+            hash,
+            status,
+            tags,
+            frontmatter,
+            relationships,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to parse ${filePath}: ${error.message}`);
+    }
+}
+/**
+ * Extract title from frontmatter or content
+ */
+function extractTitle(frontmatter, content, filePath) {
+    // Try frontmatter title
+    if (frontmatter.title) {
+        return frontmatter.title;
+    }
+    // Try first h1 heading
+    const h1Match = content.match(/^#\s+(.+)$/m);
+    if (h1Match) {
+        return h1Match[1].trim();
+    }
+    // Fallback to filename
+    const filename = filePath.split('/').pop() || 'Unknown';
+    return filename.replace(/\.md$/, '').replace(/-/g, ' ');
+}
+/**
+ * Extract status from frontmatter or content
+ */
+function extractStatus(frontmatter, content) {
+    // Try frontmatter
+    if (frontmatter.status) {
+        const status = frontmatter.status.toLowerCase();
+        // Normalize common status values
+        if (['accepted', 'approved', 'active', 'current'].includes(status)) {
+            return 'active';
+        }
+        if (['proposed', 'draft', 'pending'].includes(status)) {
+            return 'draft';
+        }
+        if (['deprecated', 'superseded', 'archived'].includes(status)) {
+            return 'archived';
+        }
+        return status;
+    }
+    // Try to find status in content (ADR format)
+    const statusMatch = content.match(/\*\*Status:\*\*\s+(\w+)/i);
+    if (statusMatch) {
+        return statusMatch[1].toLowerCase();
+    }
+    // Default to active
+    return 'active';
+}
+/**
+ * Extract tags from frontmatter or content
+ */
+function extractTags(frontmatter, content) {
+    const tags = [];
+    // From frontmatter
+    if (Array.isArray(frontmatter.tags)) {
+        tags.push(...frontmatter.tags);
+    }
+    else if (typeof frontmatter.tags === 'string') {
+        tags.push(...frontmatter.tags.split(',').map((t) => t.trim()));
+    }
+    // From content (look for tags in metadata section)
+    const tagsMatch = content.match(/tags?:\s*\[([^\]]+)\]/i);
+    if (tagsMatch) {
+        const contentTags = tagsMatch[1].split(',').map((t) => t.trim());
+        tags.push(...contentTags);
+    }
+    // Deduplicate
+    return [...new Set(tags)];
+}
+/**
+ * Extract relationships from frontmatter and content
+ */
+function extractRelationships(frontmatter, content) {
+    const relationships = [];
+    // IMPLEMENTS relationships (from frontmatter or content)
+    if (frontmatter.implements) {
+        const implements_ = Array.isArray(frontmatter.implements)
+            ? frontmatter.implements
+            : [frontmatter.implements];
+        implements_.forEach((target) => {
+            relationships.push({
+                type: 'IMPLEMENTS',
+                targetTitle: target,
+            });
+        });
+    }
+    // REFERENCES relationships (from frontmatter.related)
+    if (Array.isArray(frontmatter.related)) {
+        frontmatter.related.forEach((target) => {
+            // Clean up markdown file extensions
+            const cleanTarget = target.replace(/\.md$/, '');
+            relationships.push({
+                type: 'REFERENCES',
+                targetTitle: cleanTarget,
+            });
+        });
+    }
+    // References in content (ADR-### or PRD-### mentions)
+    const adrRefs = content.match(/\b(ADR-\d+)\b/g) || [];
+    const prdRefs = content.match(/\b(PRD-\d+)\b/g) || [];
+    [...adrRefs, ...prdRefs].forEach(ref => {
+        // Avoid duplicates
+        if (!relationships.some(r => r.targetTitle === ref)) {
+            relationships.push({
+                type: 'REFERENCES',
+                targetTitle: ref,
+            });
+        }
+    });
+    return relationships;
+}
+/**
+ * Generate content hash for duplicate detection
+ */
+function generateHash(content) {
+    return crypto
+        .createHash('sha256')
+        .update(content)
+        .digest('hex')
+        .substring(0, 16);
+}
+/**
+ * Validate parsed node has required fields
+ */
+export function validateParsedNode(node) {
+    return !!(node.title && node.content && node.hash);
+}
+//# sourceMappingURL=parser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../src/lib/sync/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,MAAM,MAAM,QAAQ,CAAC;AAgB5B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,QAAgB;IACtD,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACzD,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QAE3D,gDAAgD;QAChD,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QAEnC,gBAAgB;QAChB,MAAM,KAAK,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAE3D,iBAAiB;QACjB,MAAM,MAAM,GAAG,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAEnD,eAAe;QACf,MAAM,IAAI,GAAG,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAE/C,wBAAwB;QACxB,MAAM,aAAa,GAAG,oBAAoB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAEjE,OAAO;YACL,KAAK;YACL,OAAO,EAAE,WAAW,EAAE,qCAAqC;YAC3D,IAAI;YACJ,MAAM;YACN,IAAI;YACJ,WAAW;YACX,aAAa;SACd,CAAC;IAEJ,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,WAAgB,EAAE,OAAe,EAAE,QAAgB;IACvE,wBAAwB;IACxB,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,WAAW,CAAC,KAAK,CAAC;IAC3B,CAAC;IAED,uBAAuB;IACvB,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC7C,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,uBAAuB;IACvB,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,SAAS,CAAC;IACxD,OAAO,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,WAAgB,EAAE,OAAe;IACtD,kBAAkB;IAClB,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAChD,iCAAiC;QACjC,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACnE,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACtD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,YAAY,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9D,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,6CAA6C;IAC7C,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9D,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACtC,CAAC;IAED,oBAAoB;IACpB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,WAAgB,EAAE,OAAe;IACpD,MAAM,IAAI,GAAa,EAAE,CAAC;IAE1B,mBAAmB;IACnB,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;SAAM,IAAI,OAAO,WAAW,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAChD,IAAI,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,mDAAmD;IACnD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC1D,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;IAC5B,CAAC;IAED,cAAc;IACd,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,WAAgB,EAAE,OAAe;IAK7D,MAAM,aAAa,GAId,EAAE,CAAC;IAER,yDAAyD;IACzD,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC;YACvD,CAAC,CAAC,WAAW,CAAC,UAAU;YACxB,CAAC,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAE7B,WAAW,CAAC,OAAO,CAAC,CAAC,MAAc,EAAE,EAAE;YACrC,aAAa,CAAC,IAAI,CAAC;gBACjB,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,MAAM;aACpB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,sDAAsD;IACtD,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAc,EAAE,EAAE;YAC7C,oCAAoC;YACpC,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAChD,aAAa,CAAC,IAAI,CAAC;gBACjB,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,WAAW;aACzB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,sDAAsD;IACtD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;IACtD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;IAEtD,CAAC,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QACrC,mBAAmB;QACnB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,GAAG,CAAC,EAAE,CAAC;YACpD,aAAa,CAAC,IAAI,CAAC;gBACjB,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,GAAG;aACjB,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,OAAe;IACnC,OAAO,MAAM;SACV,UAAU,CAAC,QAAQ,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC;SACf,MAAM,CAAC,KAAK,CAAC;SACb,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAgB;IACjD,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;AACrD,CAAC"}

package/dist/lib/sync/scanner.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-07
+ * @tags: [sync, scanner, filesystem, task-026]
+ * @related: [sync.ts, parser.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [glob]
+ */
+export interface LocalNode {
+    type: 'ADR' | 'PRD' | 'ContextModule';
+    title: string;
+    content: string;
+    filePath: string;
+    status: string;
+    tags: string[];
+    hash: string;
+    metadata: Record<string, any>;
+    relationships: Array<{
+        type: 'IMPLEMENTS' | 'REFERENCES' | 'TAGGED_WITH';
+        targetId?: string;
+        targetTitle?: string;
+    }>;
+}
+/**
+ * Scan local filesystem for knowledge files
+ */
+export declare function scanLocalKnowledge(basePath: string): Promise<LocalNode[]>;
+/**
+ * Get file statistics for reporting
+ */
+export declare function getFileStats(nodes: LocalNode[]): Record<string, number>;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/lib/sync/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAoBH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,eAAe,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,aAAa,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,YAAY,GAAG,YAAY,GAAG,aAAa,CAAC;QAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAyC/E;AA4BD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKvE"}

package/dist/lib/sync/scanner.js

@@ -0,0 +1,97 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-07
+ * @tags: [sync, scanner, filesystem, task-026]
+ * @related: [sync.ts, parser.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [glob]
+ */
+/**
+ * File Scanner (TASK-026)
+ *
+ * Scans local filesystem for knowledge files:
+ * - ADRs: docs/adr/ADR-*.md
+ * - PRDs: docs/PRD/PRD-*.md
+ * - Modules: .ginko/modules/*.md (future support)
+ *
+ * Returns structured LocalNode objects with metadata and relationships
+ */
+import glob from 'glob';
+import path from 'path';
+import { promisify } from 'util';
+import { parseMarkdownFile } from './parser.js';
+const globAsync = promisify(glob);
+/**
+ * Scan local filesystem for knowledge files
+ */
+export async function scanLocalKnowledge(basePath) {
+    const nodes = [];
+    try {
+        // Scan ADRs
+        const adrPattern = path.join(basePath, 'docs/adr/ADR-*.md');
+        const adrFiles = await globAsync(adrPattern);
+        for (const filePath of adrFiles) {
+            try {
+                const parsed = await parseMarkdownFile(filePath);
+                const node = convertToLocalNode(parsed, 'ADR', filePath);
+                nodes.push(node);
+            }
+            catch (error) {
+                console.warn(`⚠️  Failed to parse ${filePath}: ${error.message}`);
+            }
+        }
+        // Scan PRDs
+        const prdPattern = path.join(basePath, 'docs/PRD/PRD-*.md');
+        const prdFiles = await globAsync(prdPattern);
+        for (const filePath of prdFiles) {
+            try {
+                const parsed = await parseMarkdownFile(filePath);
+                const node = convertToLocalNode(parsed, 'PRD', filePath);
+                nodes.push(node);
+            }
+            catch (error) {
+                console.warn(`⚠️  Failed to parse ${filePath}: ${error.message}`);
+            }
+        }
+        // Future: Scan modules
+        // const modulePattern = path.join(basePath, '.ginko/modules/*.md');
+        // const moduleFiles = await glob(modulePattern);
+    }
+    catch (error) {
+        throw new Error(`Failed to scan knowledge files: ${error.message}`);
+    }
+    return nodes;
+}
+/**
+ * Convert parsed markdown to LocalNode structure
+ */
+function convertToLocalNode(parsed, type, filePath) {
+    return {
+        type,
+        title: parsed.title,
+        content: parsed.content,
+        filePath,
+        status: parsed.status || 'active',
+        tags: parsed.tags || [],
+        hash: parsed.hash,
+        metadata: {
+            ...parsed.frontmatter,
+            priority: parsed.frontmatter?.priority || 'medium',
+            audience: parsed.frontmatter?.audience || [],
+            dependencies: parsed.frontmatter?.dependencies || [],
+        },
+        relationships: parsed.relationships,
+    };
+}
+/**
+ * Get file statistics for reporting
+ */
+export function getFileStats(nodes) {
+    return nodes.reduce((acc, node) => {
+        acc[node.type] = (acc[node.type] || 0) + 1;
+        return acc;
+    }, {});
+}
+//# sourceMappingURL=scanner.js.map

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

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

package/dist/lib/sync/uploader.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @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]
+ */
+import { LocalNode } from './scanner.js';
+export interface UploadProgress {
+    total: number;
+    uploaded: number;
+    failed: number;
+    skipped: number;
+    relationshipsCreated: number;
+}
+export interface UploadResult extends UploadProgress {
+    errors: Array<{
+        node: LocalNode;
+        error: string;
+    }>;
+}
+/**
+ * Upload nodes to cloud with progress tracking
+ */
+export declare function uploadNodes(nodes: LocalNode[], graphId: string, token: string, apiUrl?: string, onProgress?: (progress: UploadProgress) => void): Promise<UploadResult>;
+/**
+ * Batch upload nodes (future optimization)
+ */
+export declare function batchUploadNodes(nodes: LocalNode[], graphId: string, token: string, baseUrl: string, batchSize?: number): Promise<string[]>;
+//# sourceMappingURL=uploader.d.ts.map

package/dist/lib/sync/uploader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploader.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/uploader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAaH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,YAAa,SAAQ,cAAc;IAClD,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,SAAS,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,SAAS,EAAE,EAClB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,GAC9C,OAAO,CAAC,YAAY,CAAC,CAwFvB;AAoFD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,SAAS,EAAE,EAClB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAAW,GACrB,OAAO,CAAC,MAAM,EAAE,CAAC,CAuCnB"}