wikimem 0.8.0 → 0.8.2

package/dist/core/sync/slack.js

@@ -0,0 +1,173 @@
+/** Slack Sync — fetches channels, messages, users and writes raw markdown for ingest. */
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+async function slackApi(endpoint, token, params = {}) {
+    const url = new URL(`https://slack.com/api/${endpoint}`);
+    for (const [k, v] of Object.entries(params))
+        url.searchParams.set(k, v);
+    const res = await fetch(url.toString(), {
+        headers: { Authorization: `Bearer ${token}` },
+    });
+    if (!res.ok)
+        return { data: undefined, error: `HTTP ${res.status}: ${res.statusText}` };
+    const json = (await res.json());
+    if (!json.ok)
+        return { data: undefined, error: json.error ?? 'Unknown Slack API error' };
+    return { data: json, error: undefined };
+}
+async function fetchAllChannels(token, maxChannels) {
+    const channels = [];
+    const errors = [];
+    let cursor = '';
+    while (channels.length < maxChannels) {
+        const params = {
+            types: 'public_channel',
+            limit: String(Math.min(200, maxChannels - channels.length)),
+            exclude_archived: 'true',
+        };
+        if (cursor)
+            params['cursor'] = cursor;
+        const { data, error } = await slackApi('conversations.list', token, params);
+        if (error) {
+            errors.push(`conversations.list: ${error}`);
+            break;
+        }
+        if (data?.channels)
+            channels.push(...data.channels);
+        cursor = data?.response_metadata?.next_cursor ?? '';
+        if (!cursor)
+            break;
+    }
+    return { channels: channels.slice(0, maxChannels), errors };
+}
+async function fetchUserMap(token) {
+    const userMap = new Map();
+    const errors = [];
+    let cursor = '';
+    for (let page = 0; page < 3; page++) { // 3 pages = 600 users max
+        const params = { limit: '200' };
+        if (cursor)
+            params['cursor'] = cursor;
+        const { data, error } = await slackApi('users.list', token, params);
+        if (error) {
+            errors.push(`users.list: ${error}`);
+            break;
+        }
+        if (data?.members) {
+            for (const u of data.members) {
+                const name = u.profile?.display_name || u.profile?.real_name || u.real_name || u.name;
+                userMap.set(u.id, name);
+            }
+        }
+        cursor = data?.response_metadata?.next_cursor ?? '';
+        if (!cursor)
+            break;
+    }
+    return { userMap, errors };
+}
+function resolveUserMentions(text, userMap) {
+    return text.replace(/<@(U[A-Z0-9]+)>/g, (_match, userId) => {
+        const name = userMap.get(userId);
+        return name ? `@${name}` : `@unknown-${userId}`;
+    });
+}
+function tsToIso(ts) {
+    const seconds = parseFloat(ts);
+    if (Number.isNaN(seconds))
+        return ts;
+    return new Date(seconds * 1000).toISOString();
+}
+function frontmatter(fields) {
+    const lines = ['---'];
+    for (const [k, v] of Object.entries(fields)) {
+        lines.push(`${k}: '${v.replace(/'/g, "''")}'`);
+    }
+    lines.push('---', '');
+    return lines.join('\n');
+}
+export async function syncSlack(options) {
+    const start = Date.now();
+    const errors = [];
+    let filesWritten = 0;
+    const maxChannels = options.maxChannels ?? 10;
+    const maxMessages = options.maxMessagesPerChannel ?? 100;
+    const sinceTs = options.since
+        ? String(new Date(options.since).getTime() / 1000)
+        : undefined;
+    const dateStr = new Date().toISOString().slice(0, 10);
+    const outDir = join(options.vaultRoot, 'raw', dateStr);
+    mkdirSync(outDir, { recursive: true });
+    // 1. Fetch user map for @mention resolution
+    const { userMap, errors: userErrors } = await fetchUserMap(options.token);
+    errors.push(...userErrors);
+    // 2. Fetch channels
+    let channels;
+    if (options.channels && options.channels.length > 0) {
+        // Use provided channel IDs — still fetch list to get metadata
+        const { channels: allChannels, errors: chErrors } = await fetchAllChannels(options.token, 1000);
+        errors.push(...chErrors);
+        const targetSet = new Set(options.channels);
+        channels = allChannels.filter((c) => targetSet.has(c.id));
+    }
+    else {
+        const { channels: fetched, errors: chErrors } = await fetchAllChannels(options.token, maxChannels);
+        errors.push(...chErrors);
+        channels = fetched;
+    }
+    // 3. Write channel index
+    if (channels.length > 0) {
+        const indexLines = [
+            frontmatter({ addedBy: 'connector', source: 'slack', type: 'channel-index' }),
+            `# Slack Channels (${channels.length})`, '',
+        ];
+        for (const ch of channels) {
+            const purpose = ch.purpose?.value ? ` - ${ch.purpose.value}` : '';
+            indexLines.push(`- **#${ch.name}** (${ch.num_members ?? '?'} members)${purpose}`);
+        }
+        writeFileSync(join(outDir, 'slack-channels.md'), indexLines.join('\n'));
+        filesWritten++;
+    }
+    // 4. Fetch and write history for each channel
+    for (const ch of channels) {
+        const params = {
+            channel: ch.id,
+            limit: String(maxMessages),
+        };
+        if (sinceTs)
+            params['oldest'] = sinceTs;
+        const { data, error } = await slackApi('conversations.history', options.token, params);
+        if (error) {
+            errors.push(`#${ch.name} history: ${error}`);
+            continue;
+        }
+        const messages = data?.messages ?? [];
+        if (messages.length === 0)
+            continue;
+        const lines = [
+            frontmatter({ addedBy: 'connector', source: 'slack', channel: ch.name }),
+            `# #${ch.name}`, '',
+        ];
+        // Messages come newest-first from Slack, reverse for chronological
+        const sorted = [...messages].reverse();
+        for (const msg of sorted) {
+            if (!msg.text || msg.subtype === 'channel_join')
+                continue;
+            const author = msg.user ? (userMap.get(msg.user) ?? msg.user) : 'bot';
+            const time = msg.ts ? tsToIso(msg.ts) : '';
+            const resolved = resolveUserMentions(msg.text, userMap);
+            const threadTag = msg.reply_count ? ` (${msg.reply_count} replies)` : '';
+            lines.push(`**${author}** _${time}_${threadTag}`);
+            lines.push(`> ${resolved.replace(/\n/g, '\n> ')}`, '');
+        }
+        const filename = `slack-${ch.name.replace(/[^a-z0-9-_]/gi, '-')}.md`;
+        writeFileSync(join(outDir, filename), lines.join('\n'));
+        filesWritten++;
+    }
+    return {
+        provider: 'slack',
+        filesWritten,
+        errors,
+        duration: Date.now() - start,
+    };
+}
+//# sourceMappingURL=slack.js.map

package/dist/core/sync/slack.js.map

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

package/dist/core/vault.d.ts

@@ -27,6 +27,28 @@ export declare function getVaultConfig(root: string): VaultConfig;
 export declare function ensureVaultDirs(config: VaultConfig): void;
 export declare function readWikiPage(filePath: string): WikiPage;
 export declare function writeWikiPage(filePath: string, content: string, frontmatter: Record<string, unknown>): void;
+/** Version entry stored in .wikimem/versions/<slug>.versions.json */
+export interface PageVersion {
+    version: number;
+    timestamp: string;
+    content: string;
+    frontmatter: Record<string, unknown>;
+    source?: string;
+    actor?: string;
+}
+/**
+ * Write a wiki page with temporal versioning (COMP-MP-002 + COMP-MP-005).
+ * - Adds `learned_at`, `fact_version`, `ingest_session` to frontmatter
+ * - If the page already exists, archives the previous version to .wikimem/versions/
+ * - Maintains `previous_versions` count in frontmatter
+ */
+export declare function writeWikiPageVersioned(filePath: string, content: string, frontmatter: Record<string, unknown>, vaultRoot: string, options?: {
+    source?: string;
+    actor?: string;
+    sessionId?: string;
+}): void;
+/** Read version history for a page */
+export declare function readPageVersions(vaultRoot: string, slug: string): PageVersion[];
 export declare function listWikiPages(wikiDir: string): string[];
 export declare function extractWikilinks(content: string): string[];
 export declare function getVaultStats(config: VaultConfig): VaultStats;

package/dist/core/vault.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vault.d.ts","sourceRoot":"","sources":["../../src/core/vault.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAUxD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAOzD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAevD;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,IAAI,CAON;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAmBvD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAS1D;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,CAsC7D;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD"}
+{"version":3,"file":"vault.d.ts","sourceRoot":"","sources":["../../src/core/vault.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAUxD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAOzD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAevD;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,IAAI,CAON;AAED,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAChE,IAAI,CAkDN;AAED,sCAAsC;AACtC,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAQ/E;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAmBvD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAS1D;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,CAsC7D;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/core/vault.js

@@ -43,6 +43,71 @@ export function writeWikiPage(filePath, content, frontmatter) {
     const output = matter.stringify(content, frontmatter);
     writeFileSync(filePath, output, 'utf-8');
 }
+/**
+ * Write a wiki page with temporal versioning (COMP-MP-002 + COMP-MP-005).
+ * - Adds `learned_at`, `fact_version`, `ingest_session` to frontmatter
+ * - If the page already exists, archives the previous version to .wikimem/versions/
+ * - Maintains `previous_versions` count in frontmatter
+ */
+export function writeWikiPageVersioned(filePath, content, frontmatter, vaultRoot, options) {
+    const now = new Date().toISOString();
+    const slug = basename(filePath, extname(filePath));
+    const versionsDir = join(vaultRoot, '.wikimem', 'versions');
+    const versionsFile = join(versionsDir, `${slug}.versions.json`);
+    // Load existing versions
+    let versions = [];
+    if (existsSync(versionsFile)) {
+        try {
+            versions = JSON.parse(readFileSync(versionsFile, 'utf-8'));
+        }
+        catch { /* corrupted file — start fresh */ }
+    }
+    // If the page already exists, archive the current content as a version
+    if (existsSync(filePath)) {
+        try {
+            const existing = readWikiPage(filePath);
+            versions.push({
+                version: versions.length + 1,
+                timestamp: existing.frontmatter['updated'] ?? existing.frontmatter['learned_at'] ?? now,
+                content: existing.content,
+                frontmatter: existing.frontmatter,
+                source: existing.frontmatter['sources']?.[0],
+                actor: existing.frontmatter['added_by'] ?? 'unknown',
+            });
+        }
+        catch { /* file exists but unreadable — skip archival */ }
+    }
+    const newVersion = versions.length + 1;
+    // Enrich frontmatter with temporal fields
+    frontmatter['learned_at'] = now;
+    frontmatter['fact_version'] = newVersion;
+    frontmatter['previous_versions'] = versions.length;
+    if (options?.sessionId) {
+        frontmatter['ingest_session'] = options.sessionId;
+    }
+    if (options?.actor) {
+        frontmatter['added_by'] = options.actor;
+    }
+    // Write the page
+    writeWikiPage(filePath, content, frontmatter);
+    // Persist version history
+    if (!existsSync(versionsDir)) {
+        mkdirSync(versionsDir, { recursive: true });
+    }
+    writeFileSync(versionsFile, JSON.stringify(versions, null, 2), 'utf-8');
+}
+/** Read version history for a page */
+export function readPageVersions(vaultRoot, slug) {
+    const versionsFile = join(vaultRoot, '.wikimem', 'versions', `${slug}.versions.json`);
+    if (!existsSync(versionsFile))
+        return [];
+    try {
+        return JSON.parse(readFileSync(versionsFile, 'utf-8'));
+    }
+    catch {
+        return [];
+    }
+}
 export function listWikiPages(wikiDir) {
     if (!existsSync(wikiDir))
         return [];

package/dist/core/vault.js.map

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

package/dist/core/webhooks.d.ts

@@ -0,0 +1,13 @@
+export interface WebhookPayload {
+    provider: string;
+    event: string;
+    title: string;
+    content: string;
+    metadata: Record<string, string>;
+    rawBody?: string;
+}
+export declare function parseGitHubWebhook(headers: Record<string, string>, body: unknown, secret?: string): WebhookPayload | null;
+export declare function parseSlackWebhook(headers: Record<string, string>, body: unknown): WebhookPayload | null;
+export declare function parseGenericWebhook(body: unknown, secret?: string, signature?: string): WebhookPayload | null;
+export declare function webhookToMarkdown(payload: WebhookPayload): string;
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/core/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/core/webhooks.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA6DD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,EAAE,OAAO,EACb,MAAM,CAAC,EAAE,MAAM,GACd,cAAc,GAAG,IAAI,CA8EvB;AAiBD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,EAAE,OAAO,GACZ,cAAc,GAAG,IAAI,CA6DvB;AAYD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,OAAO,EACb,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GACjB,cAAc,GAAG,IAAI,CAwBvB;AAID,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAiBjE"}

package/dist/core/webhooks.js

@@ -0,0 +1,206 @@
+import { createHmac, timingSafeEqual } from 'node:crypto';
+// ── HMAC helpers ────────────────────────────────────────────────────────────
+function verifyHmacSha256(body, secret, signature, prefix = '') {
+    try {
+        const expected = prefix + createHmac('sha256', secret).update(body, 'utf-8').digest('hex');
+        if (expected.length !== signature.length)
+            return false;
+        return timingSafeEqual(Buffer.from(expected, 'utf-8'), Buffer.from(signature, 'utf-8'));
+    }
+    catch {
+        return false;
+    }
+}
+function safeStringify(body) {
+    if (typeof body === 'string')
+        return body;
+    try {
+        return JSON.stringify(body);
+    }
+    catch {
+        return '';
+    }
+}
+export function parseGitHubWebhook(headers, body, secret) {
+    try {
+        const rawBody = safeStringify(body);
+        if (secret) {
+            const sig = headers['x-hub-signature-256'] ?? headers['X-Hub-Signature-256'] ?? '';
+            if (!sig || !verifyHmacSha256(rawBody, secret, sig, 'sha256='))
+                return null;
+        }
+        const event = headers['x-github-event'] ?? headers['X-GitHub-Event'] ?? '';
+        const data = (typeof body === 'string' ? JSON.parse(body) : body);
+        if (event === 'push') {
+            const push = data;
+            const commits = push.commits ?? [];
+            const commitLines = commits
+                .map((c) => `- \`${(c.id ?? '').slice(0, 7)}\` ${c.message ?? '(no message)'} (${c.author?.name ?? 'unknown'})`)
+                .join('\n');
+            return {
+                provider: 'github',
+                event: 'push',
+                title: `Push to ${push.ref ?? 'unknown'} in ${push.repository?.full_name ?? 'unknown'}`,
+                content: commitLines || '(no commits)',
+                metadata: {
+                    ref: String(push.ref ?? ''),
+                    repo: String(push.repository?.full_name ?? ''),
+                    pusher: String(push.pusher?.name ?? ''),
+                    commitCount: String(commits.length),
+                },
+                rawBody,
+            };
+        }
+        if (event === 'issues') {
+            const iss = data;
+            const issue = iss.issue;
+            if (!issue)
+                return null;
+            return {
+                provider: 'github',
+                event: `issues.${iss.action ?? 'unknown'}`,
+                title: `Issue #${issue.number ?? '?'}: ${issue.title ?? '(untitled)'}`,
+                content: issue.body ?? '(no body)',
+                metadata: {
+                    action: String(iss.action ?? ''),
+                    repo: String(iss.repository?.full_name ?? ''),
+                    author: String(issue.user?.login ?? ''),
+                    url: String(issue.html_url ?? ''),
+                    state: String(issue.state ?? ''),
+                },
+                rawBody,
+            };
+        }
+        if (event === 'pull_request') {
+            const pr = data;
+            const pull = pr.pull_request;
+            if (!pull)
+                return null;
+            const action = pr.action === 'closed' && pull.merged ? 'merged' : (pr.action ?? 'unknown');
+            return {
+                provider: 'github',
+                event: `pull_request.${action}`,
+                title: `PR #${pull.number ?? '?'}: ${pull.title ?? '(untitled)'}`,
+                content: pull.body ?? '(no body)',
+                metadata: {
+                    action,
+                    repo: String(pr.repository?.full_name ?? ''),
+                    author: String(pull.user?.login ?? ''),
+                    url: String(pull.html_url ?? ''),
+                    state: String(pull.state ?? ''),
+                },
+                rawBody,
+            };
+        }
+        // Unsupported GitHub event
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+export function parseSlackWebhook(headers, body) {
+    try {
+        const data = (typeof body === 'string' ? JSON.parse(body) : body);
+        const rawBody = safeStringify(body);
+        // URL verification challenge — return a payload the caller can detect
+        if ('type' in data && data.type === 'url_verification') {
+            const challenge = data.challenge ?? '';
+            return {
+                provider: 'slack',
+                event: 'url_verification',
+                title: 'Slack URL Verification',
+                content: challenge,
+                metadata: { challenge },
+                rawBody,
+            };
+        }
+        // Slash command format (form-encoded parsed to object)
+        if ('command' in data && typeof data['command'] === 'string') {
+            const cmd = data;
+            return {
+                provider: 'slack',
+                event: 'slash_command',
+                title: `Slash command: ${cmd['command'] ?? '/unknown'}`,
+                content: cmd['text'] ?? '',
+                metadata: {
+                    command: String(cmd['command'] ?? ''),
+                    user: String(cmd['user_name'] ?? ''),
+                    channel: String(cmd['channel_name'] ?? ''),
+                    team: String(cmd['team_domain'] ?? ''),
+                },
+                rawBody,
+            };
+        }
+        // Event callback
+        if ('type' in data && data.type === 'event_callback') {
+            const ecb = data;
+            const evt = ecb.event;
+            if (!evt)
+                return null;
+            return {
+                provider: 'slack',
+                event: `event.${evt.type ?? 'unknown'}`,
+                title: `Slack ${evt.type ?? 'event'} in ${evt.channel ?? 'unknown'}`,
+                content: evt.text ?? '',
+                metadata: {
+                    eventType: String(evt.type ?? ''),
+                    user: String(evt.user ?? ''),
+                    channel: String(evt.channel ?? ''),
+                    ts: String(evt.ts ?? ''),
+                    team: String(ecb.team_id ?? ''),
+                },
+                rawBody,
+            };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+export function parseGenericWebhook(body, secret, signature) {
+    try {
+        const rawBody = safeStringify(body);
+        if (secret && signature) {
+            if (!verifyHmacSha256(rawBody, secret, signature))
+                return null;
+        }
+        const data = (typeof body === 'string' ? JSON.parse(body) : body);
+        if (!data.content && !data.title)
+            return null;
+        return {
+            provider: data.source ?? 'generic',
+            event: 'ingest',
+            title: data.title ?? `Webhook Ingest ${new Date().toISOString()}`,
+            content: data.content ?? '',
+            metadata: {
+                ...data.metadata,
+                ...(data.tags?.length ? { tags: data.tags.join(', ') } : {}),
+            },
+            rawBody,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// ── Markdown conversion ─────────────────────────────────────────────────────
+export function webhookToMarkdown(payload) {
+    const receivedAt = new Date().toISOString();
+    const metaEntries = Object.entries(payload.metadata).filter(([, v]) => v);
+    const metaBlock = metaEntries.length > 0
+        ? `\n## Metadata\n${metaEntries.map(([k, v]) => `- **${k}:** ${v}`).join('\n')}\n`
+        : '';
+    return `---
+addedBy: webhook
+source: ${payload.provider}
+event: ${payload.event}
+receivedAt: ${receivedAt}
+---
+# ${payload.title}
+
+${payload.content}
+${metaBlock}`;
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/core/webhooks.js.map

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

package/dist/mcp-server.d.ts

@@ -4,12 +4,17 @@
  * Implements the Model Context Protocol without the SDK dependency.
  * Reads newline-delimited JSON from stdin, writes responses to stdout.
  *
- * Tools exposed:
- *   wikimem_search  — BM25 keyword search over wiki pages
- *   wikimem_read    — Read a specific wiki page by title or filename
- *   wikimem_list    — List all wiki pages with metadata
- *   wikimem_status  — Vault statistics (page count, words, orphans, …)
- *   wikimem_ingest  — Ingest a file or URL into the vault (async)
+ * Tools exposed (10):
+ *   wikimem_search      — BM25 keyword search over wiki pages
+ *   wikimem_read        — Read a specific wiki page by title or filename
+ *   wikimem_list        — List all wiki pages with metadata
+ *   wikimem_status      — Vault statistics (page count, words, orphans, …)
+ *   wikimem_ingest      — Ingest a file or URL into the vault (async)
+ *   wikimem_observe     — Quality observer: scores, orphans, contradictions, gaps
+ *   wikimem_improve     — LLM-powered improvement suggestions for weak pages
+ *   wikimem_pipeline    — Pipeline status: recent runs, connector health
+ *   wikimem_scrape      — Scrape a URL and ingest into the vault
+ *   wikimem_connectors  — Manage data source connectors (list/add/remove/sync)
  */
 export declare function startMcpServer(vault: string): Promise<void>;
 //# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA4YH,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0CjE"}
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAyeH,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0CjE"}