@know-graph/core 0.4.0

package/dist/connectors/notion-connector.js

@@ -0,0 +1,246 @@
+import { createCache } from './cache.js';
+import { createRateLimiter } from './rate-limiter.js';
+// --- Notion URL Utilities ---
+const NOTION_URL_PATTERN = /^https?:\/\/(www\.)?notion\.(so|site)\//;
+const NOTION_PAGE_ID_PATTERN = /([a-f0-9]{32}|[a-f0-9-]{36})(?:\?|$)/;
+export function isNotionUrl(url) {
+    return NOTION_URL_PATTERN.test(url);
+}
+export function extractNotionPageId(url) {
+    const match = url.match(NOTION_PAGE_ID_PATTERN);
+    if (!match)
+        return undefined;
+    return match[1].replace(/-/g, '');
+}
+// --- Fetch-based Notion API Client ---
+export function createNotionApiClient(apiKey) {
+    const baseUrl = 'https://api.notion.com/v1';
+    const headers = {
+        Authorization: `Bearer ${apiKey}`,
+        'Notion-Version': '2022-06-28',
+        'Content-Type': 'application/json',
+    };
+    function extractTitle(page) {
+        const properties = page.properties;
+        if (!properties)
+            return 'Untitled';
+        for (const value of Object.values(properties)) {
+            const prop = value;
+            if (prop.type === 'title') {
+                const titleArray = prop.title;
+                if (titleArray && titleArray.length > 0) {
+                    return titleArray.map((t) => t.plain_text).join('');
+                }
+            }
+        }
+        return 'Untitled';
+    }
+    function extractStatus(page) {
+        const properties = page.properties;
+        if (!properties)
+            return undefined;
+        const status = properties['Status'];
+        if (status?.type === 'status') {
+            const statusValue = status.status;
+            return statusValue?.name;
+        }
+        return undefined;
+    }
+    return {
+        async getPage(pageId) {
+            const response = await fetch(`${baseUrl}/pages/${pageId}`, { headers });
+            if (!response.ok) {
+                throw new Error(`Notion API error: ${response.status} ${response.statusText}`);
+            }
+            const data = (await response.json());
+            return {
+                id: data.id,
+                url: data.url,
+                title: extractTitle(data),
+                lastEditedTime: data.last_edited_time,
+                status: extractStatus(data),
+            };
+        },
+        async searchPages(query) {
+            const response = await fetch(`${baseUrl}/search`, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify({
+                    query,
+                    filter: { value: 'page', property: 'object' },
+                    page_size: 10,
+                }),
+            });
+            if (!response.ok) {
+                throw new Error(`Notion API error: ${response.status} ${response.statusText}`);
+            }
+            const data = (await response.json());
+            return data.results.map((page) => ({
+                id: page.id,
+                url: page.url,
+                title: extractTitle(page),
+                lastEditedTime: page.last_edited_time,
+                status: extractStatus(page),
+            }));
+        },
+    };
+}
+function getAllEntities(dbManager) {
+    const rows = dbManager.db
+        .prepare('SELECT * FROM entities ORDER BY name ASC')
+        .all();
+    return rows.map((row) => {
+        const tags = dbManager.db
+            .prepare('SELECT tag FROM tags WHERE entity_id = ?')
+            .all(row.id).map((t) => t.tag);
+        const links = dbManager.db
+            .prepare('SELECT link_type, url, title FROM links WHERE entity_id = ?')
+            .all(row.id).map((l) => ({
+            type: l.link_type,
+            url: l.url,
+            title: l.title ?? undefined,
+        }));
+        return {
+            id: row.id,
+            filePath: row.file_path,
+            name: row.name,
+            entityType: row.entity_type,
+            description: row.description,
+            rawDocstring: row.raw_docstring,
+            signature: row.signature,
+            parent: row.parent,
+            language: row.language,
+            line: row.line,
+            column: row.column_num,
+            owner: row.owner,
+            status: row.status,
+            metadata: JSON.parse(row.metadata_json),
+            tags,
+            links,
+            fileHash: row.file_hash,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    });
+}
+function filterEntities(entities, filter) {
+    if (!filter)
+        return entities;
+    return entities.filter((entity) => {
+        if (filter.owner && entity.owner !== filter.owner)
+            return false;
+        if (filter.tags && filter.tags.length > 0) {
+            const hasMatchingTag = filter.tags.some((t) => entity.tags.includes(t));
+            if (!hasMatchingTag)
+                return false;
+        }
+        return true;
+    });
+}
+export function createNotionConnector(deps = {}) {
+    const cache = deps.cache ?? createCache({ ttlMs: 5 * 60 * 1000 });
+    const rateLimiter = deps.rateLimiter ??
+        createRateLimiter({ maxTokens: 3, refillRate: 3, refillIntervalMs: 1000 });
+    return {
+        name: 'notion',
+        supportedLinkTypes: ['notion'],
+        validate(config) {
+            const issues = [];
+            if (!config.api_key_env) {
+                issues.push({
+                    field: 'api_key_env',
+                    message: 'api_key_env is required (env variable name for Notion API key)',
+                });
+            }
+            else if (!process.env[config.api_key_env]) {
+                issues.push({
+                    field: 'api_key_env',
+                    message: `Environment variable "${config.api_key_env}" is not set`,
+                });
+            }
+            return { valid: issues.length === 0, issues };
+        },
+        async sync(options) {
+            const startTime = Date.now();
+            const { dbManager, config, entityFilter, dryRun } = options;
+            const errors = [];
+            const linksAdded = 0;
+            let linksUpdated = 0;
+            const apiKey = config.api_key_env
+                ? process.env[config.api_key_env]
+                : undefined;
+            if (!apiKey) {
+                return {
+                    connector: 'notion',
+                    entitiesProcessed: 0,
+                    linksAdded: 0,
+                    linksUpdated: 0,
+                    errors: [
+                        {
+                            entityId: '',
+                            message: 'Notion API key not found in environment',
+                            code: 'AUTH_MISSING',
+                        },
+                    ],
+                    duration: Date.now() - startTime,
+                };
+            }
+            const apiClient = deps.apiClient ?? createNotionApiClient(apiKey);
+            const allEntities = getAllEntities(dbManager);
+            const entities = filterEntities(allEntities, entityFilter);
+            for (const entity of entities) {
+                const notionLinks = entity.links.filter((l) => l.type === 'notion' || (l.url && isNotionUrl(l.url)));
+                for (const link of notionLinks) {
+                    const pageId = extractNotionPageId(link.url);
+                    if (!pageId)
+                        continue;
+                    try {
+                        const cached = cache.get(pageId);
+                        let page;
+                        if (cached) {
+                            page = cached;
+                        }
+                        else {
+                            await rateLimiter.acquire();
+                            page = await apiClient.getPage(pageId);
+                            cache.set(pageId, page);
+                        }
+                        if (!dryRun) {
+                            // Delete old link and insert updated one
+                            dbManager.db
+                                .prepare('DELETE FROM links WHERE entity_id = ? AND url = ?')
+                                .run(entity.id, link.url);
+                            dbManager.insertLinks(entity.id, [
+                                {
+                                    type: 'notion',
+                                    url: link.url,
+                                    title: page.title,
+                                },
+                            ]);
+                            linksUpdated++;
+                        }
+                        else {
+                            linksUpdated++;
+                        }
+                    }
+                    catch (err) {
+                        errors.push({
+                            entityId: entity.id,
+                            message: `Failed to fetch Notion page ${pageId}: ${err instanceof Error ? err.message : String(err)}`,
+                            code: 'FETCH_ERROR',
+                        });
+                    }
+                }
+            }
+            return {
+                connector: 'notion',
+                entitiesProcessed: entities.length,
+                linksAdded,
+                linksUpdated,
+                errors,
+                duration: Date.now() - startTime,
+            };
+        },
+    };
+}
+//# sourceMappingURL=notion-connector.js.map

package/dist/connectors/notion-connector.js.map

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

package/dist/connectors/rate-limiter.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @knowgraph
+ * type: module
+ * description: Token bucket rate limiter for connector API calls
+ * owner: knowgraph-core
+ * status: experimental
+ * tags: [connector, rate-limiter, throttle, api]
+ * context:
+ *   business_goal: Prevent API rate limit violations when syncing with external services
+ *   domain: connectors
+ */
+export interface RateLimiter {
+    acquire(): Promise<void>;
+    tryAcquire(): boolean;
+    readonly availableTokens: number;
+}
+export interface RateLimiterOptions {
+    readonly maxTokens: number;
+    readonly refillRate: number;
+    readonly refillIntervalMs: number;
+}
+export declare function createRateLimiter(options: RateLimiterOptions): RateLimiter;
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/connectors/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/connectors/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,WAAW;IAC1B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,IAAI,OAAO,CAAC;IACtB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAgD1E"}

package/dist/connectors/rate-limiter.js

@@ -0,0 +1,54 @@
+/**
+ * @knowgraph
+ * type: module
+ * description: Token bucket rate limiter for connector API calls
+ * owner: knowgraph-core
+ * status: experimental
+ * tags: [connector, rate-limiter, throttle, api]
+ * context:
+ *   business_goal: Prevent API rate limit violations when syncing with external services
+ *   domain: connectors
+ */
+export function createRateLimiter(options) {
+    const { maxTokens, refillRate, refillIntervalMs } = options;
+    let tokens = maxTokens;
+    let lastRefillTime = Date.now();
+    function refill() {
+        const now = Date.now();
+        const elapsed = now - lastRefillTime;
+        const intervals = Math.floor(elapsed / refillIntervalMs);
+        if (intervals > 0) {
+            tokens = Math.min(maxTokens, tokens + intervals * refillRate);
+            lastRefillTime = now;
+        }
+    }
+    function tryAcquire() {
+        refill();
+        if (tokens > 0) {
+            tokens--;
+            return true;
+        }
+        return false;
+    }
+    async function acquire() {
+        if (tryAcquire())
+            return;
+        const waitTime = refillIntervalMs - (Date.now() - lastRefillTime);
+        await new Promise((resolve) => setTimeout(resolve, Math.max(0, waitTime)));
+        refill();
+        if (tokens > 0) {
+            tokens--;
+            return;
+        }
+        return acquire();
+    }
+    return {
+        acquire,
+        tryAcquire,
+        get availableTokens() {
+            refill();
+            return tokens;
+        },
+    };
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/connectors/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/connectors/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAcH,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IAC3D,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC;IAC5D,IAAI,MAAM,GAAG,SAAS,CAAC;IACvB,IAAI,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEhC,SAAS,MAAM;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,GAAG,GAAG,cAAc,CAAC;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,gBAAgB,CAAC,CAAC;QAEzD,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC,CAAC;YAC9D,cAAc,GAAG,GAAG,CAAC;QACvB,CAAC;IACH,CAAC;IAED,SAAS,UAAU;QACjB,MAAM,EAAE,CAAC;QACT,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACf,MAAM,EAAE,CAAC;YACT,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,UAAU,OAAO;QACpB,IAAI,UAAU,EAAE;YAAE,OAAO;QAEzB,MAAM,QAAQ,GAAG,gBAAgB,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,cAAc,CAAC,CAAC;QAClE,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;QACjF,MAAM,EAAE,CAAC;QAET,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACf,MAAM,EAAE,CAAC;YACT,OAAO;QACT,CAAC;QAED,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;IAED,OAAO;QACL,OAAO;QACP,UAAU;QACV,IAAI,eAAe;YACjB,MAAM,EAAE,CAAC;YACT,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/connectors/registry.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @knowgraph
+ * type: module
+ * description: Connector registry that manages and orchestrates external knowledge connectors
+ * owner: knowgraph-core
+ * status: experimental
+ * tags: [connector, registry, factory, orchestration]
+ * context:
+ *   business_goal: Enable pluggable external knowledge source integration
+ *   domain: connectors
+ */
+import type { ConnectorRegistry } from './types.js';
+export declare function createConnectorRegistry(): ConnectorRegistry;
+export declare function createDefaultConnectorRegistry(): ConnectorRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/connectors/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/connectors/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAEV,iBAAiB,EAGlB,MAAM,YAAY,CAAC;AA2EpB,wBAAgB,uBAAuB,IAAI,iBAAiB,CAE3D;AAED,wBAAgB,8BAA8B,IAAI,iBAAiB,CAKlE"}

package/dist/connectors/registry.js

@@ -0,0 +1,72 @@
+import { createNotionConnector } from './notion-connector.js';
+import { createJiraConnector } from './jira-connector.js';
+function createRegistry() {
+    const connectors = [];
+    return {
+        register(connector) {
+            const existing = connectors.findIndex((c) => c.name === connector.name);
+            if (existing !== -1) {
+                connectors[existing] = connector;
+            }
+            else {
+                connectors.push(connector);
+            }
+        },
+        getConnector(name) {
+            return connectors.find((c) => c.name === name);
+        },
+        listConnectors() {
+            return connectors.map((c) => c.name);
+        },
+        async syncAll(options) {
+            const { configs, dbManager, entityFilter, dryRun, onProgress } = options;
+            const results = [];
+            for (const connector of connectors) {
+                const config = configs[connector.name];
+                if (!config || !config.enabled) {
+                    continue;
+                }
+                const validation = connector.validate(config);
+                if (!validation.valid) {
+                    const errorMessages = validation.issues
+                        .map((i) => `${i.field}: ${i.message}`)
+                        .join('; ');
+                    results.push({
+                        connector: connector.name,
+                        entitiesProcessed: 0,
+                        linksAdded: 0,
+                        linksUpdated: 0,
+                        errors: [
+                            {
+                                entityId: '',
+                                message: `Configuration invalid: ${errorMessages}`,
+                                code: 'CONFIG_INVALID',
+                            },
+                        ],
+                        duration: 0,
+                    });
+                    continue;
+                }
+                const result = await connector.sync({
+                    dbManager,
+                    config,
+                    entityFilter,
+                    dryRun,
+                });
+                results.push(result);
+                onProgress?.(connector.name, result);
+            }
+            return results;
+        },
+    };
+}
+export function createConnectorRegistry() {
+    return createRegistry();
+}
+export function createDefaultConnectorRegistry() {
+    const registry = createRegistry();
+    registry.register(createNotionConnector());
+    registry.register(createJiraConnector());
+    return registry;
+}
+//# sourceMappingURL=registry.js.map

package/dist/connectors/registry.js.map

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

package/dist/connectors/types.d.ts

@@ -0,0 +1,142 @@
+/**
+ * @knowgraph
+ * type: interface
+ * description: Type definitions and Zod schemas for the connector plugin system
+ * owner: knowgraph-core
+ * status: experimental
+ * tags: [connector, types, interface, zod]
+ * context:
+ *   business_goal: Define contracts for external knowledge connectors
+ *   domain: connectors
+ */
+import { z } from 'zod';
+import type { DatabaseManager } from '../indexer/database.js';
+import type { LinkType } from '../types/entity.js';
+import type { ConnectorConfig } from '../types/manifest.js';
+export declare const ConnectorValidationIssueSchema: z.ZodObject<{
+    field: z.ZodString;
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    field: string;
+}, {
+    message: string;
+    field: string;
+}>;
+export declare const ConnectorValidationResultSchema: z.ZodObject<{
+    valid: z.ZodBoolean;
+    issues: z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        message: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        field: string;
+    }, {
+        message: string;
+        field: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    valid: boolean;
+    issues: {
+        message: string;
+        field: string;
+    }[];
+}, {
+    valid: boolean;
+    issues: {
+        message: string;
+        field: string;
+    }[];
+}>;
+export declare const ConnectorErrorSchema: z.ZodObject<{
+    entityId: z.ZodString;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    entityId: string;
+    code?: string | undefined;
+}, {
+    message: string;
+    entityId: string;
+    code?: string | undefined;
+}>;
+export declare const ConnectorSyncResultSchema: z.ZodObject<{
+    connector: z.ZodString;
+    entitiesProcessed: z.ZodNumber;
+    linksAdded: z.ZodNumber;
+    linksUpdated: z.ZodNumber;
+    errors: z.ZodArray<z.ZodObject<{
+        entityId: z.ZodString;
+        message: z.ZodString;
+        code: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        entityId: string;
+        code?: string | undefined;
+    }, {
+        message: string;
+        entityId: string;
+        code?: string | undefined;
+    }>, "many">;
+    duration: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    connector: string;
+    entitiesProcessed: number;
+    linksAdded: number;
+    linksUpdated: number;
+    errors: {
+        message: string;
+        entityId: string;
+        code?: string | undefined;
+    }[];
+    duration: number;
+}, {
+    connector: string;
+    entitiesProcessed: number;
+    linksAdded: number;
+    linksUpdated: number;
+    errors: {
+        message: string;
+        entityId: string;
+        code?: string | undefined;
+    }[];
+    duration: number;
+}>;
+export type ConnectorValidationIssue = z.infer<typeof ConnectorValidationIssueSchema>;
+export type ConnectorValidationResult = z.infer<typeof ConnectorValidationResultSchema>;
+export type ConnectorError = z.infer<typeof ConnectorErrorSchema>;
+export type ConnectorSyncResult = z.infer<typeof ConnectorSyncResultSchema>;
+export type { ConnectorConfig } from '../types/manifest.js';
+export interface ConnectorSyncOptions {
+    readonly dbManager: DatabaseManager;
+    readonly config: ConnectorConfig;
+    readonly entityFilter?: {
+        readonly owner?: string;
+        readonly tags?: readonly string[];
+    };
+    readonly dryRun: boolean;
+}
+export interface Connector {
+    readonly name: string;
+    readonly supportedLinkTypes: readonly LinkType[];
+    validate(config: ConnectorConfig): ConnectorValidationResult;
+    sync(options: ConnectorSyncOptions): Promise<ConnectorSyncResult>;
+}
+export interface SyncAllOptions {
+    readonly dbManager: DatabaseManager;
+    readonly configs: Readonly<Record<string, ConnectorConfig>>;
+    readonly entityFilter?: {
+        readonly owner?: string;
+        readonly tags?: readonly string[];
+    };
+    readonly dryRun: boolean;
+    readonly onProgress?: (connectorName: string, result: ConnectorSyncResult) => void;
+}
+export interface ConnectorRegistry {
+    register(connector: Connector): void;
+    getConnector(name: string): Connector | undefined;
+    listConnectors(): readonly string[];
+    syncAll(options: SyncAllOptions): Promise<readonly ConnectorSyncResult[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/connectors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/connectors/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAI5D,eAAO,MAAM,8BAA8B;;;;;;;;;EAGzC,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;EAG1C,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOpC,CAAC;AAIH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAC5C,OAAO,8BAA8B,CACtC,CAAC;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,+BAA+B,CACvC,CAAC;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAI5E,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAI5D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE;QACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;KACnC,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,kBAAkB,EAAE,SAAS,QAAQ,EAAE,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,yBAAyB,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,YAAY,CAAC,EAAE;QACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;KACnC,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,CACpB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,mBAAmB,KACxB,IAAI,CAAC;CACX;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IACrC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAClD,cAAc,IAAI,SAAS,MAAM,EAAE,CAAC;IACpC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC,CAAC;CAC3E"}

package/dist/connectors/types.js

@@ -0,0 +1,35 @@
+/**
+ * @knowgraph
+ * type: interface
+ * description: Type definitions and Zod schemas for the connector plugin system
+ * owner: knowgraph-core
+ * status: experimental
+ * tags: [connector, types, interface, zod]
+ * context:
+ *   business_goal: Define contracts for external knowledge connectors
+ *   domain: connectors
+ */
+import { z } from 'zod';
+// --- Zod Schemas ---
+export const ConnectorValidationIssueSchema = z.object({
+    field: z.string(),
+    message: z.string(),
+});
+export const ConnectorValidationResultSchema = z.object({
+    valid: z.boolean(),
+    issues: z.array(ConnectorValidationIssueSchema),
+});
+export const ConnectorErrorSchema = z.object({
+    entityId: z.string(),
+    message: z.string(),
+    code: z.string().optional(),
+});
+export const ConnectorSyncResultSchema = z.object({
+    connector: z.string(),
+    entitiesProcessed: z.number(),
+    linksAdded: z.number(),
+    linksUpdated: z.number(),
+    errors: z.array(ConnectorErrorSchema),
+    duration: z.number(),
+});
+//# sourceMappingURL=types.js.map

package/dist/connectors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/connectors/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,sBAAsB;AAEtB,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;IAClB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,8BAA8B,CAAC;CAChD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC7B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC;IACrC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC"}

package/dist/coverage/__tests__/fixtures/mixed-project/annotated.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @knowgraph
+ * type: module
+ * description: An annotated TypeScript file for testing
+ * owner: test-team
+ * status: stable
+ */
+export declare function hello(): string;
+//# sourceMappingURL=annotated.d.ts.map

package/dist/coverage/__tests__/fixtures/mixed-project/annotated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotated.d.ts","sourceRoot":"","sources":["../../../../../src/coverage/__tests__/fixtures/mixed-project/annotated.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,KAAK,IAAI,MAAM,CAE9B"}

package/dist/coverage/__tests__/fixtures/mixed-project/annotated.js

@@ -0,0 +1,11 @@
+/**
+ * @knowgraph
+ * type: module
+ * description: An annotated TypeScript file for testing
+ * owner: test-team
+ * status: stable
+ */
+export function hello() {
+    return 'hello';
+}
+//# sourceMappingURL=annotated.js.map

package/dist/coverage/__tests__/fixtures/mixed-project/annotated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotated.js","sourceRoot":"","sources":["../../../../../src/coverage/__tests__/fixtures/mixed-project/annotated.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,KAAK;IACnB,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/coverage/__tests__/fixtures/mixed-project/unannotated.d.ts

@@ -0,0 +1,2 @@
+export declare function goodbye(): string;
+//# sourceMappingURL=unannotated.d.ts.map