memory-journal-mcp 8.0.1 → 9.1.0

package/dist/handlers/resources/shared.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Memory Journal MCP Server - Resource Shared Types & Helpers
+ *
+ * Shared types, helpers, and utilities used by all resource group modules.
+ */
+import type { IDatabaseAdapter } from '../../database/core/interfaces.js';
+import type { VectorSearchManager } from '../../vector/vector-search-manager/index.js';
+import type { ToolFilterConfig } from '../../filtering/tool-filter.js';
+import type { McpIcon, ProjectRegistryEntry } from '../../types/index.js';
+import type { GitHubIntegration } from '../../github/github-integration/index.js';
+import type { Scheduler } from '../../server/scheduler.js';
+import type { ServerRuntime } from '../../utils/maintenance-lock.js';
+/** Successful result from resolveGitHubRepo */
+export interface GitHubRepoResolved {
+    owner: string;
+    repo: string;
+    branch: string | null;
+    lastModified: string;
+    /** Narrowed non-null reference — safe to use without `!` after guard */
+    github: GitHubIntegration;
+}
+/**
+ * Resolve GitHub owner/repo or return a ResourceResult error.
+ *
+ * Encapsulates the three-step guard pattern used by all GitHub resource
+ * handlers: check github integration → getRepoInfo → validate owner/repo.
+ *
+ * @param github - The default GitHub integration instance
+ * @param config - The briefing configuration containing project registry
+ * @param targetRepo - Optional target repository name to dynamically resolve
+ * @returns Resolved repo info, or a ResourceResult error to return directly
+ */
+export declare function resolveGitHubRepo(github: GitHubIntegration | null | undefined, config?: BriefingConfig, targetRepo?: string, runtime?: ServerRuntime): Promise<GitHubRepoResolved | ResourceResult>;
+/**
+ * Type guard: returns true if the result is a ResourceResult error.
+ */
+export declare function isResourceError(result: GitHubRepoResolved | ResourceResult): result is ResourceResult;
+/**
+ * Configuration for the memory://briefing resource.
+ * All values have sensible defaults — users opt-in via env vars or CLI flags.
+ */
+export interface BriefingConfig {
+    /** Number of recent commits to include in git history (default: 3) */
+    commitCount: number;
+    /** Number of recent journal entries to include (default: 3) */
+    entryCount: number;
+    /** Number of recent session summaries to display (default: 1) */
+    summaryCount?: number;
+    /** Include team DB entries in briefing preview (default: false) */
+    includeTeam: boolean;
+    /** Number of open issues to list with titles; 0 = count only (default: 0) */
+    issueCount: number;
+    /** Number of PRs to list with titles; 0 = count only (default: 0) */
+    prCount: number;
+    /** Show PR status breakdown (open/merged/closed) instead of simple count (default: false) */
+    prStatusBreakdown: boolean;
+    /** Number of milestones to list in briefing; 0 = hide (default: 3) */
+    milestoneCount?: number;
+    /** Path to the user's rules file (e.g., .gemini/GEMINI.md) for awareness in briefing */
+    rulesFilePath?: string;
+    /** Path to the user's skills directory for awareness in briefing */
+    skillsDirPath?: string;
+    /** Number of recent workflow runs to list; 0 = latest-only status (default: 0) */
+    workflowCount: number;
+    /** Show workflow run status breakdown (passing/failing/pending) (default: false) */
+    workflowStatusBreakdown: boolean;
+    /** Aggregate Copilot review state across recent PRs in briefing (default: false) */
+    copilotReviews: boolean;
+    /** Workflow summary string for the memory://workflows resource (env: MEMORY_JOURNAL_WORKFLOW_SUMMARY) */
+    workflowSummary?: string;
+    /** Default GitHub Project number for Kanban resources and issue tools (env: DEFAULT_PROJECT_NUMBER) */
+    defaultProjectNumber?: number;
+    /** Default workspace ID for isolating journal entries */
+    defaultWorkspaceId?: string;
+    /** Project registry mapping dynamic repo IDs to local paths and kanban boards */
+    projectRegistry?: Record<string, ProjectRegistryEntry>;
+    /** Allowlisted directory roots for strict filesystem jailing of agent read access */
+    allowedIoRoots?: string[];
+    /** Minimum significance score for entries to be included in the briefing (default: 0.3) */
+    briefingImportanceThreshold?: number;
+}
+/** Default briefing configuration — preserves pre-existing behavior */
+export declare const DEFAULT_BRIEFING_CONFIG: BriefingConfig;
+/**
+ * Resource context for handlers that need extended access
+ */
+export interface ResourceContext {
+    db: IDatabaseAdapter;
+    teamDb?: IDatabaseAdapter;
+    vectorManager?: VectorSearchManager;
+    filterConfig?: ToolFilterConfig | null;
+    github?: GitHubIntegration | null;
+    scheduler?: Scheduler | null;
+    briefingConfig?: BriefingConfig;
+    runtime?: ServerRuntime;
+    resourceCount?: number;
+}
+/**
+ * Resource handler result with optional annotations for MCP 2025-11-25
+ */
+export interface ResourceResult {
+    data: unknown;
+    annotations?: {
+        lastModified?: string;
+    };
+}
+/**
+ * Internal resource definition with db handler
+ */
+export interface InternalResourceDef {
+    uri: string;
+    name: string;
+    title: string;
+    description: string;
+    mimeType: string;
+    icons?: McpIcon[];
+    annotations?: {
+        audience?: ('user' | 'assistant')[];
+        priority?: number;
+        lastModified?: string;
+        autoRead?: boolean;
+        sessionInit?: boolean;
+    };
+    capabilities?: {
+        requiresTeamScope?: boolean;
+        requiresAdminScope?: boolean;
+        requiresAuditScope?: boolean;
+    };
+    handler: (uri: string, context: ResourceContext) => unknown;
+}
+/**
+ * Calculate milestone completion percentage from open/closed issue counts.
+ * Shared helper to avoid duplicated logic across resource handlers.
+ */
+export declare function milestoneCompletionPct(openIssues: number, closedIssues: number): number;
+//# sourceMappingURL=shared.d.ts.map

package/dist/handlers/resources/shared.d.ts.map

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

package/dist/handlers/resources/staleness.d.ts

@@ -0,0 +1,3 @@
+import type { InternalResourceDef } from './shared.js';
+export declare function getStalenessResourceDefinitions(): InternalResourceDef[];
+//# sourceMappingURL=staleness.d.ts.map

package/dist/handlers/resources/staleness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staleness.d.ts","sourceRoot":"","sources":["../../../src/handlers/resources/staleness.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACR,mBAAmB,EAGtB,MAAM,aAAa,CAAA;AAuCpB,wBAAgB,+BAA+B,IAAI,mBAAmB,EAAE,CAiKvE"}

package/dist/handlers/resources/team.d.ts

@@ -0,0 +1,6 @@
+import type { InternalResourceDef } from './shared.js';
+/**
+ * Get team resource definitions
+ */
+export declare function getTeamResourceDefinitions(): InternalResourceDef[];
+//# sourceMappingURL=team.d.ts.map

package/dist/handlers/resources/team.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team.d.ts","sourceRoot":"","sources":["../../../src/handlers/resources/team.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACR,mBAAmB,EAGtB,MAAM,aAAa,CAAA;AA+BpB;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,mBAAmB,EAAE,CAyGlE"}

package/dist/handlers/resources/templates.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Memory Journal MCP Server - Template Resource Definitions
+ *
+ * Resources with URI templates (parameterized):
+ * projects/{number}/timeline, issues/{issue_number}/entries, prs/{pr_number}/entries,
+ * prs/{pr_number}/timeline, kanban/{project_number}, kanban/{project_number}/diagram
+ */
+import type { InternalResourceDef } from './shared.js';
+/**
+ * Get template resource definitions
+ */
+export declare function getTemplateResourceDefinitions(): InternalResourceDef[];
+//# sourceMappingURL=templates.d.ts.map

package/dist/handlers/resources/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/handlers/resources/templates.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAmB,MAAM,aAAa,CAAA;AAMvE;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,mBAAmB,EAAE,CAubtE"}

package/dist/handlers/resources/tools-catalog.d.ts

@@ -0,0 +1,3 @@
+import type { InternalResourceDef } from './shared.js';
+export declare function getToolsCatalogResourceDefinitions(): InternalResourceDef[];
+//# sourceMappingURL=tools-catalog.d.ts.map

package/dist/handlers/resources/tools-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-catalog.d.ts","sourceRoot":"","sources":["../../../src/handlers/resources/tools-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAmB,MAAM,aAAa,CAAA;AAGvE,wBAAgB,kCAAkC,IAAI,mBAAmB,EAAE,CAoF1E"}

package/dist/handlers/tools/admin/batch-tools.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition, ToolContext } from '../../../types/index.js';
+export declare function getBatchTools(context: ToolContext): ToolDefinition[];
+//# sourceMappingURL=batch-tools.d.ts.map

package/dist/handlers/tools/admin/batch-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-tools.d.ts","sourceRoot":"","sources":["../../../../src/handlers/tools/admin/batch-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAoB,MAAM,yBAAyB,CAAA;AAkB5F,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,EAAE,CAkRpE"}

package/dist/handlers/tools/admin/core-tools.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition, ToolContext } from '../../../types/index.js';
+export declare function getCoreTools(context: ToolContext): ToolDefinition[];
+//# sourceMappingURL=core-tools.d.ts.map

package/dist/handlers/tools/admin/core-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-tools.d.ts","sourceRoot":"","sources":["../../../../src/handlers/tools/admin/core-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAgB1E,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,EAAE,CAoNnE"}

package/dist/handlers/tools/admin/index.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition, ToolContext } from '../../../types/index.js';
+export declare function getAdminTools(context: ToolContext): ToolDefinition[];
+//# sourceMappingURL=index.d.ts.map

package/dist/handlers/tools/admin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/handlers/tools/admin/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAgB1E,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,EAAE,CAkCpE"}

package/dist/handlers/tools/admin/lifecycle-tools.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition, ToolContext } from '../../../types/index.js';
+export declare function getLifecycleTools(context: ToolContext): ToolDefinition[];
+//# sourceMappingURL=lifecycle-tools.d.ts.map

package/dist/handlers/tools/admin/lifecycle-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-tools.d.ts","sourceRoot":"","sources":["../../../../src/handlers/tools/admin/lifecycle-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAM1E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,EAAE,CAwExE"}

package/dist/handlers/tools/admin/misc-tools.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition, ToolContext } from '../../../types/index.js';
+export declare function getMiscTools(context: ToolContext): ToolDefinition[];
+//# sourceMappingURL=misc-tools.d.ts.map

package/dist/handlers/tools/admin/misc-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc-tools.d.ts","sourceRoot":"","sources":["../../../../src/handlers/tools/admin/misc-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAQ1E,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,EAAE,CA8HnE"}

package/dist/handlers/tools/admin/project-tools.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition, ToolContext } from '../../../types/index.js';
+export declare function getProjectTools(context: ToolContext): ToolDefinition[];
+//# sourceMappingURL=project-tools.d.ts.map

package/dist/handlers/tools/admin/project-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-tools.d.ts","sourceRoot":"","sources":["../../../../src/handlers/tools/admin/project-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAiE1E,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,EAAE,CA2PtE"}