memory-journal-mcp 8.0.1 → 9.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAOpE,UAAU,YAAY;IAClB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAE/B,2CAA2C;IAC3C,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAEjC,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;IAE7C,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAA;CAClB;AAMD;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC5C,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;IAEhC,oDAAoD;IACpD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAExC,2CAA2C;IAC3C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAE7B,oCAAoC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;gBAE1C,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,YAAY;IAmB1F;;OAEG;IACH,UAAU,IAAI,aAAa;CAW9B;AAMD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,qBAAqB;gBAC1C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQjE;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,qBAAqB;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQjE;AAMD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,qBAAqB;gBAC1C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQjE;AAMD;;GAEG;AACH,qBAAa,aAAc,SAAQ,qBAAqB;IACpD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;gBAElC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CASrE;AAMD;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,qBAAqB;gBAChD,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAavD;AAMD;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,qBAAqB;gBAC7C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQjE;AAMD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,qBAAqB;gBAC1C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQjE;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,qBAAqB;gBAC7C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQjE;AAMD;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,qBAAqB;IACxD,QAAQ,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,EAAE,CAAA;gBAG1D,OAAO,EAAE,MAAM,EACf,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,EAAE,EACrD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAU5B,UAAU,IAAI,aAAa;CAKvC"}

package/dist/types/filtering.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Memory Journal MCP Server - Tool Filtering Types
+ */
+/**
+ * Tool group identifiers for Memory Journal
+ */
+export type ToolGroup = 'core' | 'search' | 'analytics' | 'relationships' | 'io' | 'admin' | 'github' | 'git' | 'backup' | 'team' | 'codemode';
+/**
+ * Meta-group identifiers for common multi-group selections
+ */
+export type MetaGroup = 'starter' | 'essential' | 'full' | 'readonly';
+/**
+ * Tool filter rule
+ */
+export interface ToolFilterRule {
+    /** Rule type: include or exclude */
+    type: 'include' | 'exclude';
+    /** Target: group name or tool name */
+    target: string;
+    /** Whether target is a group (true) or individual tool (false) */
+    isGroup: boolean;
+}
+/**
+ * Parsed tool filter configuration
+ */
+export interface ToolFilterConfig {
+    /** Original filter string */
+    raw: string;
+    /** Parsed rules in order */
+    rules: ToolFilterRule[];
+    /** Set of enabled tool names after applying rules */
+    enabledTools: Set<string>;
+}
+//# sourceMappingURL=filtering.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filtering.d.ts","sourceRoot":"","sources":["../../src/types/filtering.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GACf,MAAM,GACN,QAAQ,GACR,WAAW,GACX,eAAe,GACf,IAAI,GACJ,OAAO,GACP,QAAQ,GACR,KAAK,GACL,QAAQ,GACR,MAAM,GACN,UAAU,CAAA;AAEhB;;GAEG;AACH,MAAM,MAAM,SAAS,GACf,SAAS,GACT,WAAW,GACX,MAAM,GACN,UAAU,CAAA;AAEhB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,oCAAoC;IACpC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAA;IAE3B,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAA;IAEd,kEAAkE;IAClE,OAAO,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAA;IAEX,4BAA4B;IAC5B,KAAK,EAAE,cAAc,EAAE,CAAA;IAEvB,qDAAqD;IACrD,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAC5B"}

package/dist/types/github.d.ts

@@ -0,0 +1,202 @@
+/**
+ * Memory Journal MCP Server - GitHub Integration Types
+ */
+/**
+ * GitHub project information
+ */
+export interface GitHubProject {
+    number: number;
+    title: string;
+    url: string;
+    state: 'OPEN' | 'CLOSED';
+}
+/**
+ * GitHub issue information
+ */
+export interface GitHubIssue {
+    number: number;
+    title: string;
+    url: string;
+    state: 'OPEN' | 'CLOSED';
+    milestone?: {
+        number: number;
+        title: string;
+    } | null;
+}
+/**
+ * GitHub pull request information
+ */
+export interface GitHubPullRequest {
+    number: number;
+    title: string;
+    url: string;
+    state: 'OPEN' | 'CLOSED' | 'MERGED';
+    headRef?: string;
+}
+/**
+ * GitHub milestone information
+ */
+export interface GitHubMilestone {
+    number: number;
+    title: string;
+    description: string | null;
+    state: 'open' | 'closed';
+    url: string;
+    dueOn: string | null;
+    openIssues: number;
+    closedIssues: number;
+    createdAt: string;
+    updatedAt: string;
+    creator: string | null;
+}
+/**
+ * GitHub workflow run information
+ */
+export interface GitHubWorkflowRun {
+    id: number;
+    name: string;
+    status: 'queued' | 'in_progress' | 'completed';
+    conclusion: 'success' | 'failure' | 'cancelled' | 'skipped' | null;
+    url: string;
+    headBranch: string;
+    headSha: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * GitHub PR review
+ */
+export interface GitHubReview {
+    id: number;
+    author: string;
+    state: 'APPROVED' | 'CHANGES_REQUESTED' | 'COMMENTED' | 'DISMISSED' | 'PENDING';
+    body: string | null;
+    submittedAt: string;
+    isCopilot: boolean;
+}
+/**
+ * GitHub PR review comment (file-level)
+ */
+export interface GitHubReviewComment {
+    id: number;
+    author: string;
+    body: string;
+    path: string;
+    line: number | null;
+    side: 'LEFT' | 'RIGHT';
+    createdAt: string;
+    isCopilot: boolean;
+}
+/**
+ * Copilot review summary for a PR
+ */
+export interface CopilotReviewSummary {
+    prNumber: number;
+    state: 'approved' | 'changes_requested' | 'commented' | 'none';
+    commentCount: number;
+    comments: GitHubReviewComment[];
+}
+/**
+ * Auto-captured project context
+ */
+export interface ProjectContext {
+    repoName: string | null;
+    branch: string | null;
+    commit: string | null;
+    remoteUrl: string | null;
+    projects: GitHubProject[];
+    issues: GitHubIssue[];
+    pullRequests: GitHubPullRequest[];
+    workflowRuns: GitHubWorkflowRun[];
+    milestones: GitHubMilestone[];
+    degraded?: string[];
+}
+/**
+ * Repository statistics (stars, forks, watchers)
+ */
+export interface RepoStats {
+    stars: number;
+    forks: number;
+    watchers: number;
+    openIssues: number;
+    size: number;
+    defaultBranch: string;
+}
+/**
+ * Aggregated traffic data (14-day rolling)
+ */
+export interface TrafficData {
+    clones: {
+        total: number;
+        unique: number;
+        dailyAvg: number;
+    };
+    views: {
+        total: number;
+        unique: number;
+        dailyAvg: number;
+    };
+    period: string;
+}
+/**
+ * Traffic referrer source
+ */
+export interface TrafficReferrer {
+    referrer: string;
+    count: number;
+    uniques: number;
+}
+/**
+ * Popular repository path
+ */
+export interface PopularPath {
+    path: string;
+    title: string;
+    count: number;
+    uniques: number;
+}
+/**
+ * Status option for single-select field in Projects v2
+ */
+export interface ProjectV2StatusOption {
+    id: string;
+    name: string;
+    color?: string;
+}
+/**
+ * Project item in a Kanban board
+ */
+export interface ProjectV2Item {
+    id: string;
+    title: string;
+    url: string;
+    type: 'ISSUE' | 'PULL_REQUEST' | 'DRAFT_ISSUE';
+    status: string | null;
+    number?: number;
+    labels?: string[];
+    assignees?: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Kanban column (grouped by Status)
+ */
+export interface KanbanColumn {
+    status: string;
+    statusOptionId: string;
+    items: ProjectV2Item[];
+}
+/**
+ * Full Kanban board response
+ */
+export interface KanbanBoard {
+    projectId: string;
+    projectNumber: number;
+    projectTitle: string;
+    statusFieldId: string;
+    statusOptions: ProjectV2StatusOption[];
+    columns: KanbanColumn[];
+    totalItems: number;
+    truncated?: boolean;
+}
+//# sourceMappingURL=github.d.ts.map

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

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

package/dist/types/index.d.ts

@@ -0,0 +1,326 @@
+/**
+ * Memory Journal MCP Server - Type Definitions
+ *
+ * Barrel file re-exporting all types from sub-modules, plus types
+ * that depend on external imports (SqliteAdapter, VectorSearchManager, etc.).
+ */
+import type { IDatabaseAdapter } from '../database/core/interfaces.js';
+import type { VectorSearchManager } from '../vector/vector-search-manager/index.js';
+import type { GitHubIntegration } from '../github/github-integration/index.js';
+import type { ProgressContext } from '../utils/progress-utils.js';
+export type { ToolGroup, MetaGroup, ToolFilterRule, ToolFilterConfig } from './filtering.js';
+export type { ErrorCategory, ErrorResponse, ErrorContext } from './error-types.js';
+export { MemoryJournalMcpError, ConnectionError, QueryError, ValidationError, ResourceNotFoundError, ConfigurationError, PermissionError, } from './errors.js';
+export type { EntryType, SignificanceType, RelationshipType, JournalEntry, Tag, Relationship, Embedding, ImportanceBreakdown, ImportanceResult, EntryRevision, Anchor, AnchorStatus, CreateEntryInput, CreateTeamEntryInput, } from './entities.js';
+export { ENTRY_TYPES, RELATIONSHIP_TYPES, SIGNIFICANCE_TYPES } from './entities.js';
+export type { GitHubProject, GitHubIssue, GitHubPullRequest, GitHubMilestone, GitHubWorkflowRun, GitHubReview, GitHubReviewComment, CopilotReviewSummary, ProjectContext, RepoStats, TrafficData, TrafficReferrer, PopularPath, ProjectV2StatusOption, ProjectV2Item, KanbanColumn, KanbanBoard, } from './github.js';
+/**
+ * MCP Tool Annotations (MCP Spec 2025-11-25)
+ *
+ * Behavioral hints for AI clients to understand tool characteristics.
+ */
+export interface ToolAnnotations {
+    /** Tool does not modify state (idempotent reads) */
+    readOnlyHint?: boolean;
+    /** Tool may permanently delete/destroy data */
+    destructiveHint?: boolean;
+    /** Repeated calls with same args produce same result */
+    idempotentHint?: boolean;
+    /** Tool interacts with external services (network, APIs) */
+    openWorldHint?: boolean;
+}
+/**
+ * MCP Resource Annotations (MCP Spec 2025-11-25)
+ */
+export interface ResourceAnnotations {
+    /** Intended audience: 'user' or 'assistant' */
+    audience?: ('user' | 'assistant')[];
+    /** Importance level from 0.0 (optional) to 1.0 (required) */
+    priority?: number;
+    /** ISO 8601 timestamp of last modification */
+    lastModified?: string;
+}
+/**
+ * MCP Icon Definition (MCP Spec 2025-11-25)
+ *
+ * Icons can be added to servers, tools, resources, and prompts for
+ * visual representation in client interfaces.
+ */
+export interface McpIcon {
+    /** Icon source - URL or data URI */
+    src: string;
+    /** MIME type (e.g., 'image/svg+xml', 'image/png') */
+    mimeType?: string;
+    /** Size descriptors (e.g., ['48x48'], ['any']) */
+    sizes?: string[];
+}
+import type { ToolGroup, ToolFilterConfig } from './filtering.js';
+/**
+ * Tool definition for registration
+ */
+export interface ToolDefinition {
+    /** Unique tool name */
+    name: string;
+    /** Human-readable display title (MCP 2025-11-25) */
+    title: string;
+    /** Human-readable description */
+    description: string;
+    /** Tool group for filtering */
+    group: ToolGroup;
+    /** Zod schema for input validation */
+    inputSchema: unknown;
+    /** Zod schema for output validation (MCP 2025-11-25 outputSchema) */
+    outputSchema?: unknown;
+    /** Behavioral hints for AI clients */
+    annotations: ToolAnnotations;
+    /** Security capabilities required to execute this tool */
+    capabilities?: {
+        requiresTeamScope?: boolean;
+        requiresAdminScope?: boolean;
+        mutatesState?: boolean;
+    };
+    /** Tool handler function */
+    handler: (params: unknown) => unknown;
+}
+/**
+ * Shape returned by `getTools()` for MCP SDK registration.
+ * Derived from `ToolDefinition` but excludes internal fields (group, handler).
+ */
+export interface ToolRegistration {
+    name: string;
+    /** Human-readable display title (MCP 2025-11-25) */
+    title?: string;
+    description: string;
+    inputSchema: unknown;
+    outputSchema?: unknown;
+    annotations: ToolAnnotations;
+    icons?: {
+        iconUrl: string;
+        title: string;
+        description: string;
+    };
+}
+export interface ProjectRegistryEntry {
+    path: string;
+    project_number?: number;
+}
+/**
+ * Tool handler configuration options
+ */
+import type { ServerRuntime } from '../utils/maintenance-lock.js';
+import type { SubscriptionManager } from '../server/subscription-manager.js';
+import type { BriefingConfig } from '../handlers/resources/shared.js';
+export interface ToolHandlerConfig {
+    /** Default GitHub Project number for auto-assignment */
+    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>;
+    /** Additional team database mappings (label -> path) for cross-team discovery */
+    additionalTeamDbs?: Record<string, string>;
+    /** Allowlisted roots for file IO */
+    allowedIoRoots?: string[];
+    /**
+     * SEC-1.1: Central dispatch function for Code Mode.
+     * Routes sandbox tool calls through callTool() so OAuth scope checks,
+     * maintenance-mode guards, and audit interception apply to inner calls.
+     * When absent, Code Mode falls back to calling raw tool handlers directly.
+     */
+    dispatch?: (name: string, args: Record<string, unknown>) => Promise<unknown>;
+    /**
+     * SEC-1.2: Active tool filter for Code Mode universe scoping.
+     * When set, Code Mode only exposes tools that are in filterConfig.enabledTools,
+     * ensuring operators' --tool-filter restrictions are enforced inside the sandbox.
+     */
+    filterConfig?: ToolFilterConfig | null;
+    /**
+     * Server runtime context for tracking instance-bound globals (Audit logger, Maintenance Lock).
+     */
+    /** Server auth configuration passed down for strict security gates */
+    authEnabled?: boolean;
+    oauthEnabled?: boolean;
+    codemodeEnabled?: boolean;
+    codemodeInternalFullAccess?: boolean;
+    /** Enable autonomous MCP tool and parameter healing/interception (default: true) */
+    agentHealing?: boolean;
+    /** Default role for un-registered authors (default: denied) */
+    teamDefaultRole?: 'admin' | 'member' | 'viewer' | 'denied';
+    /** Admin author to bootstrap if team_members table is empty */
+    teamAdmin?: string;
+    /**
+     * Server runtime context for tracking instance-bound globals (Audit logger, Maintenance Lock).
+     */
+    runtime?: ServerRuntime;
+    /**
+     * Optional subscription manager for triggering real-time MCP notifications.
+     */
+    subscriptionManager?: SubscriptionManager;
+    /** Optional briefing configuration for Code Mode dynamic resolution. */
+    briefingConfig?: BriefingConfig;
+    /** Server-configured auto-prune archive age threshold (days) */
+    archiveOlderThanDays?: number;
+    /** Server-configured auto-prune soft-delete age threshold (days) */
+    pruneOlderThanDays?: number;
+    /** Server-configured auto-prune hard-delete age threshold (days) */
+    hardDeleteOlderThanDays?: number;
+    /** Server-configured auto-prune importance threshold (0.0-1.0) */
+    pruneImportanceThreshold?: number;
+}
+/**
+ * Tool execution context passed to all tool group modules
+ */
+export interface ToolContext {
+    /** Database adapter */
+    db: IDatabaseAdapter;
+    /** Team database adapter (optional, requires TEAM_DB_PATH) */
+    teamDb?: IDatabaseAdapter;
+    /** Vector search manager (optional) */
+    vectorManager?: VectorSearchManager;
+    /** Team vector search manager (optional, bound to team DB) */
+    teamVectorManager?: VectorSearchManager;
+    /** GitHub integration (optional) */
+    github?: GitHubIntegration;
+    /** Handler configuration */
+    config?: ToolHandlerConfig;
+    /** Progress reporting context */
+    progress?: ProgressContext;
+    /** Authentication context injected by transport */
+    auth?: {
+        sub?: string;
+        subject?: string;
+        scopes?: string[];
+    };
+}
+/**
+ * Resource definition for MCP
+ */
+export interface ResourceDefinition {
+    /** Resource URI template */
+    uri: string;
+    /** Human-readable name */
+    name: string;
+    /** Human-readable display title */
+    title: string;
+    /** Description */
+    description: string;
+    /** MIME type */
+    mimeType: string;
+    /** Resource metadata annotations */
+    annotations?: ResourceAnnotations;
+    /** Security capabilities required to read this resource */
+    capabilities?: {
+        requiresTeamScope?: boolean;
+        requiresAdminScope?: boolean;
+        requiresAuditScope?: boolean;
+    };
+    /** Resource handler - NOTE: db is passed at runtime, not in the definition */
+    handler: (uri: string) => Promise<unknown>;
+}
+/**
+ * Prompt definition for MCP
+ */
+export interface PromptDefinition {
+    /** Prompt name */
+    name: string;
+    /** Description */
+    description: string;
+    /** Argument definitions */
+    arguments?: {
+        name: string;
+        description: string;
+        required?: boolean;
+    }[];
+    /** Prompt handler */
+    handler: (args: Record<string, string>) => Promise<unknown>;
+}
+/**
+ * Server configuration
+ */
+export interface ServerConfig {
+    /** Path to SQLite database file */
+    dbPath: string;
+    /** GitHub personal access token */
+    githubToken?: string;
+    /** GitHub organization token (for org projects) */
+    githubOrgToken?: string;
+    /** Default organization name */
+    defaultOrg?: string;
+    /** Tool filter string */
+    toolFilter?: string;
+    /** Default GitHub Project number for auto-assignment */
+    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>;
+    /** Enable semantic search */
+    enableSemanticSearch: boolean;
+    /** Sentence transformer model name */
+    modelName: string;
+    /** Default role for un-registered authors (default: denied) */
+    teamDefaultRole?: 'admin' | 'member' | 'viewer' | 'denied';
+    /** Admin author to bootstrap if team_members table is empty */
+    teamAdmin?: string;
+    /** Whether to persist metrics to disk across server restarts */
+    persistMetrics?: boolean;
+    /** Custom path to the metrics JSON file. If not provided, it is derived from dbPath */
+    metricsPath?: string;
+}
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: Partial<ServerConfig>;
+/**
+ * Backup file information
+ */
+export interface BackupInfo {
+    /** Backup filename */
+    filename: string;
+    /** Full path to backup file */
+    path: string;
+    /** File size in bytes */
+    sizeBytes: number;
+    /** Backup creation time (ISO 8601) */
+    createdAt: string;
+}
+/**
+ * Server health and diagnostics status
+ */
+export interface HealthStatus {
+    /** Database statistics */
+    database: {
+        path: string;
+        sizeBytes: number;
+        entryCount: number;
+        deletedEntryCount: number;
+        relationshipCount: number;
+        tagCount: number;
+    };
+    /** Backup information */
+    backups: {
+        directory: string;
+        count: number;
+        lastBackup: {
+            filename: string;
+            createdAt: string;
+            sizeBytes: number;
+        } | null;
+    };
+    /** Vector search index status */
+    vectorIndex: {
+        available: boolean;
+        itemCount: number;
+        modelName: string | null;
+    } | null;
+    /** Tool filter configuration */
+    toolFilter: {
+        active: boolean;
+        enabledCount: number;
+        totalCount: number;
+        filterString: string | null;
+    };
+    /** Health check timestamp (ISO 8601) */
+    timestamp: string;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/utils/config-manager.d.ts

@@ -0,0 +1,24 @@
+import { EventEmitter } from 'node:events';
+import { type ToolFilterConfig } from '../filtering/tool-filter.js';
+import type { BriefingConfig } from '../handlers/resources/shared.js';
+export interface DynamicConfig {
+    rawToolFilter: string | undefined;
+    toolFilterConfig: ToolFilterConfig | null;
+    briefingConfig: BriefingConfig;
+    codemodeInternalFullAccess?: boolean | undefined;
+}
+export declare class ConfigManager extends EventEmitter {
+    private config;
+    private readonly initialCodemodeFullAccess;
+    private configFilePath?;
+    private watcher?;
+    private isWriting;
+    constructor(initialConfig: DynamicConfig, configFilePath?: string);
+    getConfig(): DynamicConfig;
+    updateConfig(newConfig: Partial<DynamicConfig>, persist?: boolean): void;
+    close(): void;
+    private persistToFile;
+    private watchFile;
+    private reloadFromFile;
+}
+//# sourceMappingURL=config-manager.d.ts.map

package/dist/utils/config-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.d.ts","sourceRoot":"","sources":["../../src/utils/config-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1C,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AAErE,MAAM,WAAW,aAAa;IAC1B,aAAa,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACzC,cAAc,EAAE,cAAc,CAAA;IAC9B,0BAA0B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACnD;AAED,qBAAa,aAAc,SAAQ,YAAY;IAC3C,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAS;IACnD,OAAO,CAAC,cAAc,CAAC,CAAoB;IAC3C,OAAO,CAAC,OAAO,CAAC,CAAc;IAC9B,OAAO,CAAC,SAAS,CAAQ;gBAEb,aAAa,EAAE,aAAa,EAAE,cAAc,CAAC,EAAE,MAAM;IAW1D,SAAS,IAAI,aAAa;IAI1B,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE,OAAO,UAAQ,GAAG,IAAI;IAatE,KAAK,IAAI,IAAI;IAIpB,OAAO,CAAC,aAAa;IA+CrB,OAAO,CAAC,SAAS;IA+BjB,OAAO,CAAC,cAAc;CA2DzB"}

package/dist/utils/config-resolver.d.ts

@@ -0,0 +1,41 @@
+import type { Command } from 'commander';
+export interface ResolvedConfigValue<T> {
+    value: T;
+    source: 'cli' | 'env' | 'config' | 'default';
+}
+export declare class ConfigResolver {
+    private command;
+    private cliOptions;
+    private configFileOptions;
+    loadedConfigPath?: string;
+    constructor(command: Command, cliOptions: Record<string, unknown>, configPathOverride?: string);
+    private loadEnvFiles;
+    private loadConfigFile;
+    /**
+     * Resolves a configuration option following precedence:
+     * CLI flag > Env Var > Config File > Default
+     */
+    resolve<T>(cliKey: string, envKey?: string, parser?: (val: unknown) => T): T | undefined;
+    private _parseNumeric;
+    /**
+     * Helper to resolve a required numeric value
+     */
+    resolveIntRequired(cliKey: string, envKey?: string, min?: number, max?: number): number;
+    /**
+     * Helper to resolve an optional numeric value
+     */
+    resolveInt(cliKey: string, envKey?: string, min?: number, max?: number): number | undefined;
+    /**
+     * Helper to resolve an optional numeric value (supports floats)
+     */
+    resolveNumber(cliKey: string, envKey?: string, min?: number, max?: number): number | undefined;
+    /**
+     * Helper to resolve a boolean value
+     */
+    resolveBool(cliKey: string, envKey?: string): boolean | undefined;
+    /**
+     * Helper to resolve a string array (e.g. from comma separated string or actual array)
+     */
+    resolveStringArray(cliKey: string, envKey?: string): string[] | undefined;
+}
+//# sourceMappingURL=config-resolver.d.ts.map

package/dist/utils/config-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/config-resolver.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAIxC,MAAM,WAAW,mBAAmB,CAAC,CAAC;IAClC,KAAK,EAAE,CAAC,CAAA;IACR,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAA;CAC/C;AAED,qBAAa,cAAc;IAMnB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,UAAU;IANtB,OAAO,CAAC,iBAAiB,CAA8B;IAChD,gBAAgB,CAAC,EAAE,MAAM,CAAA;gBAIpB,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3C,kBAAkB,CAAC,EAAE,MAAM;IAM/B,OAAO,CAAC,YAAY;IAiCpB,OAAO,CAAC,cAAc;IA0CtB;;;OAGG;IACI,OAAO,CAAC,CAAC,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,GAC7B,CAAC,GAAG,SAAS;IA2ChB,OAAO,CAAC,aAAa;IAiBrB;;OAEG;IACI,kBAAkB,CACrB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,GACb,MAAM;IAQT;;OAEG;IACI,UAAU,CACb,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,GACb,MAAM,GAAG,SAAS;IAQrB;;OAEG;IACI,aAAa,CAChB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,GACb,MAAM,GAAG,SAAS;IAQrB;;OAEG;IACI,WAAW,CACd,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GAChB,OAAO,GAAG,SAAS;IAStB;;OAEG;IACI,kBAAkB,CACrB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GAChB,MAAM,EAAE,GAAG,SAAS;CAc1B"}