wikimem 0.3.0 → 0.8.1

package/dist/core/oauth-defaults.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Bundled OAuth App Credentials for WikiMem
+ *
+ * WikiMem registers its own OAuth apps on each platform (like Claude, VS Code, gh CLI).
+ * Users click "Connect" → consent screen → done. No manual app registration needed.
+ *
+ * For CLI/desktop apps:
+ * - GitHub Device Flow: only client_id needed (public, no secret)
+ * - Google "Desktop app": client_id + client_secret (both non-confidential per Google's docs)
+ * - Slack/Linear/Jira: client_id + client_secret (shipped in code, overridable via env vars)
+ *
+ * Resolution order: bundled defaults → env vars → config.yaml
+ * Env vars always override bundled defaults (for development/self-hosted).
+ */
+export interface OAuthAppCredentials {
+    clientId: string;
+    clientSecret: string;
+}
+export interface ProviderDefaults {
+    /** Standard OAuth credentials (client_id + client_secret) */
+    credentials?: OAuthAppCredentials;
+    /** GitHub-specific: Device Flow client_id (no secret needed) */
+    deviceFlowClientId?: string;
+}
+/** Get bundled OAuth credentials for a provider. Returns null if none configured. */
+export declare function getBundledCredentials(provider: string): OAuthAppCredentials | null;
+/** Get bundled GitHub Device Flow client_id. Returns null if none configured. */
+export declare function getBundledDeviceFlowClientId(): string | null;
+/** Check if a provider has any bundled credentials (standard or device flow). */
+export declare function hasBundledDefaults(provider: string): boolean;
+//# sourceMappingURL=oauth-defaults.d.ts.map

package/dist/core/oauth-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-defaults.d.ts","sourceRoot":"","sources":["../../src/core/oauth-defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAgDD,qFAAqF;AACrF,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAElF;AAED,iFAAiF;AACjF,wBAAgB,4BAA4B,IAAI,MAAM,GAAG,IAAI,CAE5D;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK5D"}

package/dist/core/oauth-defaults.js

@@ -0,0 +1,77 @@
+/**
+ * Bundled OAuth App Credentials for WikiMem
+ *
+ * WikiMem registers its own OAuth apps on each platform (like Claude, VS Code, gh CLI).
+ * Users click "Connect" → consent screen → done. No manual app registration needed.
+ *
+ * For CLI/desktop apps:
+ * - GitHub Device Flow: only client_id needed (public, no secret)
+ * - Google "Desktop app": client_id + client_secret (both non-confidential per Google's docs)
+ * - Slack/Linear/Jira: client_id + client_secret (shipped in code, overridable via env vars)
+ *
+ * Resolution order: bundled defaults → env vars → config.yaml
+ * Env vars always override bundled defaults (for development/self-hosted).
+ */
+// ── Pre-registered WikiMem OAuth app credentials ──
+// Register apps and paste credentials here. They ship with the npm package.
+// Users can override via WIKIMEM_{PROVIDER}_CLIENT_ID env vars.
+const BUNDLED = {
+    github: {
+        // GitHub OAuth App — Device Flow enabled
+        // Register: https://github.com/settings/developers → New OAuth App
+        // Homepage URL: https://github.com/naman10parikh/llmwiki
+        // Callback URL: http://localhost:3456/api/auth/callback
+        // Check "Enable Device Flow"
+        // Only client_id needed for device flow (no secret)
+        deviceFlowClientId: 'Ov23liPXlZFPixXov4vx',
+    },
+    google: {
+    // Google OAuth — "Desktop" application type
+    // Register: https://console.cloud.google.com/apis/credentials
+    // Application type: Desktop app (secret is non-confidential for desktop apps)
+    // Enable: Gmail API, Google Drive API
+    // credentials: {
+    //   clientId: '...apps.googleusercontent.com',
+    //   clientSecret: 'GOCSPX-...',
+    // },
+    },
+    slack: {
+    // Slack App
+    // Register: https://api.slack.com/apps → Create New App → From scratch
+    // OAuth & Permissions → scopes: channels:history, channels:read, users:read
+    // Redirect URL: http://localhost:3456/api/auth/callback
+    // credentials: { clientId: '...', clientSecret: '...' },
+    },
+    linear: {
+    // Linear OAuth App
+    // Register: https://linear.app/settings/api → OAuth Applications → Create new
+    // Callback URL: http://localhost:3456/api/auth/callback
+    // credentials: { clientId: '...', clientSecret: '...' },
+    },
+    jira: {
+    // Atlassian/Jira OAuth 2.0 App
+    // Register: https://developer.atlassian.com/console/myapps/
+    // Create → OAuth 2.0 integration
+    // Callback URL: http://localhost:3456/api/auth/callback
+    // Scopes: read:jira-work, read:jira-user, offline_access
+    // credentials: { clientId: '...', clientSecret: '...' },
+    },
+};
+/** Get bundled OAuth credentials for a provider. Returns null if none configured. */
+export function getBundledCredentials(provider) {
+    return BUNDLED[provider]?.credentials ?? null;
+}
+/** Get bundled GitHub Device Flow client_id. Returns null if none configured. */
+export function getBundledDeviceFlowClientId() {
+    return BUNDLED.github?.deviceFlowClientId ?? null;
+}
+/** Check if a provider has any bundled credentials (standard or device flow). */
+export function hasBundledDefaults(provider) {
+    const p = BUNDLED[provider];
+    if (!p)
+        return false;
+    if (provider === 'github')
+        return !!(p.deviceFlowClientId || p.credentials);
+    return !!p.credentials;
+}
+//# sourceMappingURL=oauth-defaults.js.map

package/dist/core/oauth-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-defaults.js","sourceRoot":"","sources":["../../src/core/oauth-defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAcH,qDAAqD;AACrD,4EAA4E;AAC5E,gEAAgE;AAChE,MAAM,OAAO,GAAqC;IAChD,MAAM,EAAE;QACN,yCAAyC;QACzC,mEAAmE;QACnE,yDAAyD;QACzD,wDAAwD;QACxD,6BAA6B;QAC7B,oDAAoD;QACpD,kBAAkB,EAAE,sBAAsB;KAC3C;IACD,MAAM,EAAE;IACN,4CAA4C;IAC5C,8DAA8D;IAC9D,8EAA8E;IAC9E,sCAAsC;IACtC,iBAAiB;IACjB,+CAA+C;IAC/C,gCAAgC;IAChC,KAAK;KACN;IACD,KAAK,EAAE;IACL,YAAY;IACZ,uEAAuE;IACvE,4EAA4E;IAC5E,wDAAwD;IACxD,yDAAyD;KAC1D;IACD,MAAM,EAAE;IACN,mBAAmB;IACnB,8EAA8E;IAC9E,wDAAwD;IACxD,yDAAyD;KAC1D;IACD,IAAI,EAAE;IACJ,+BAA+B;IAC/B,4DAA4D;IAC5D,iCAAiC;IACjC,wDAAwD;IACxD,yDAAyD;IACzD,yDAAyD;KAC1D;CACF,CAAC;AAEF,qFAAqF;AACrF,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,OAAO,OAAO,CAAC,QAAQ,CAAC,EAAE,WAAW,IAAI,IAAI,CAAC;AAChD,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,4BAA4B;IAC1C,OAAO,OAAO,CAAC,MAAM,EAAE,kBAAkB,IAAI,IAAI,CAAC;AACpD,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5B,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACrB,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,IAAI,CAAC,CAAC,WAAW,CAAC,CAAC;IAC5E,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;AACzB,CAAC"}

package/dist/core/observer.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Automation 2: Observer (Self-Improvement Engine)
+ *
+ * Runs nightly at 3am (or on demand) to score every wiki page for quality,
+ * find orphans, flag contradictions, and identify knowledge gaps.
+ *
+ * Reports saved to .wikimem/observer-reports/YYYY-MM-DD.json
+ * Auto-committed as: wiki: observe: nightly quality scan
+ */
+import type { VaultConfig } from './vault.js';
+export interface PageScore {
+    page: string;
+    title: string;
+    score: number;
+    maxScore: number;
+    breakdown: {
+        hasSummary: boolean;
+        hasLinksOut: boolean;
+        hasLinksIn: boolean;
+        wordCount: number;
+        hasTags: boolean;
+        freshness: number;
+        readability: number;
+    };
+    issues: string[];
+}
+export interface OrphanPage {
+    page: string;
+    title: string;
+    slug: string;
+}
+export interface PotentialContradiction {
+    pageA: string;
+    titleA: string;
+    pageB: string;
+    titleB: string;
+    reason: string;
+}
+/**
+ * Lightweight heuristic: two pages share a topic keyword in their title
+ * but their summaries contain opposing sentiment words.
+ */
+/** Exported for lint + UI — heuristic opposing-summary pairs across related pages */
+export declare function flagContradictions(pagePaths: string[]): PotentialContradiction[];
+export interface KnowledgeGap {
+    mentionedTopic: string;
+    mentionedIn: string[];
+    mentionCount: number;
+}
+export interface ObserverOptions {
+    maxPagesToReview?: number;
+    /** Max budget per run in USD (default: $2.00). Limits how many pages can be auto-improved. */
+    maxBudget?: number;
+    /** When true, use LLM to improve the weakest pages (not just score them) */
+    autoImprove?: boolean;
+    /** Max pages to auto-improve per run (default: 3) */
+    maxImprovements?: number;
+    /** Model to use for observer LLM calls (overrides config default) */
+    model?: string;
+}
+export interface ImprovementResult {
+    page: string;
+    title: string;
+    originalScore: number;
+    newScore?: number;
+    action: string;
+    improved: boolean;
+    error?: string;
+}
+export interface ObserverReport {
+    date: string;
+    generatedAt: string;
+    totalPages: number;
+    pagesReviewed: number;
+    averageScore: number;
+    maxScore: number;
+    scores: PageScore[];
+    orphans: OrphanPage[];
+    contradictions: PotentialContradiction[];
+    gaps: KnowledgeGap[];
+    topIssues: Array<{
+        issue: string;
+        count: number;
+    }>;
+    improvements: ImprovementResult[];
+}
+export declare function getObserverReportsDir(vaultRoot: string): string;
+export declare function runObserver(config: VaultConfig, options?: ObserverOptions): Promise<ObserverReport>;
+export declare function listObserverReports(vaultRoot: string): string[];
+export declare function readObserverReport(vaultRoot: string, date: string): ObserverReport | null;
+export declare function startObserverCron(config: VaultConfig): void;
+export declare function stopObserverCron(): void;
+export declare function isObserverCronRunning(): boolean;
+//# sourceMappingURL=observer.d.ts.map

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

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