obsidian-accomplishments-mcp 0.1.10 → 0.1.11

package/dist/tools/decision-document-tools.js

@@ -0,0 +1,260 @@
+/**
+ * Decision & Document Management Tools
+ *
+ * Category 5: Decision & Document Management
+ * - manage_documents: Consolidated tool for document/decision management
+ *   - get_decision_history: Get decision history for a topic
+ *   - supersede_document: Update document based on decision
+ *   - get_document_history: Get document version history
+ *   - check_freshness: Check if document is up-to-date
+ *
+ * DEPRECATED:
+ * - create_decision: Use create_entity with type: 'decision' instead
+ */
+import { workstreamNormalizer } from '../services/v2/workstream-normalizer.js';
+// =============================================================================
+// Manage Documents (Consolidated Tool)
+// =============================================================================
+/**
+ * Consolidated tool for document and decision management.
+ * Dispatches to the appropriate handler based on action.
+ */
+export async function manageDocuments(input, deps) {
+    const { action } = input;
+    switch (action) {
+        case 'get_decision_history': {
+            const result = await getDecisionHistory({
+                topic: input.topic,
+                workstream: input.workstream,
+                include_superseded: input.include_superseded,
+                include_archived: input.include_archived,
+            }, deps);
+            return { action: 'get_decision_history', ...result };
+        }
+        case 'supersede_document': {
+            if (!input.document_id || !input.decision_id || !input.new_content || !input.change_summary) {
+                throw new Error('supersede_document requires document_id, decision_id, new_content, and change_summary');
+            }
+            const result = await supersedeDocument({
+                document_id: input.document_id,
+                decision_id: input.decision_id,
+                new_content: input.new_content,
+                change_summary: input.change_summary,
+            }, deps);
+            return { action: 'supersede_document', ...result };
+        }
+        case 'get_document_history': {
+            if (!input.document_id) {
+                throw new Error('get_document_history requires document_id');
+            }
+            const result = await getDocumentHistory({
+                document_id: input.document_id,
+            }, deps);
+            return { action: 'get_document_history', ...result };
+        }
+        case 'check_freshness': {
+            if (!input.document_id) {
+                throw new Error('check_freshness requires document_id');
+            }
+            const result = await checkDocumentFreshness({
+                document_id: input.document_id,
+            }, deps);
+            return { action: 'check_freshness', ...result };
+        }
+        default:
+            throw new Error(`Unknown action: ${action}`);
+    }
+}
+// =============================================================================
+// =============================================================================
+// Get Decision History
+// =============================================================================
+/**
+ * Get decision history for a topic or workstream.
+ * By default includes archived decisions since most decisions are archived after being decided.
+ */
+export async function getDecisionHistory(input, deps) {
+    const { topic, include_superseded } = input;
+    // Default to including archived decisions (most decisions are archived after being decided)
+    const include_archived = input.include_archived ?? true;
+    // Normalize workstream for consistent querying
+    const normalizedWorkstream = input.workstream
+        ? workstreamNormalizer.normalize(input.workstream).normalized
+        : undefined;
+    // Get all decisions
+    const decisions = await deps.getAllDecisions({
+        workstream: normalizedWorkstream,
+        includeSuperseded: include_superseded,
+        includeArchived: include_archived,
+    });
+    // Filter by topic if provided
+    const filtered = topic
+        ? decisions.filter((d) => d.title.toLowerCase().includes(topic.toLowerCase()))
+        : decisions;
+    // Build decision list
+    const decisionList = filtered.map((d) => ({
+        id: d.id,
+        title: d.title,
+        status: d.status,
+        decided_on: d.decided_on || d.created_at,
+        affects: d.affects || [],
+        superseded_by: undefined, // Would need reverse lookup
+    }));
+    // Build decision chains (supersession chains)
+    const chains = [];
+    const processed = new Set();
+    for (const d of filtered) {
+        if (processed.has(d.id))
+            continue;
+        // Find the chain this decision belongs to
+        const history = [];
+        let current = d;
+        // Walk back through supersedes
+        while (current?.supersedes) {
+            const prev = await deps.getEntity(current.supersedes);
+            if (prev && prev.type === 'decision') {
+                history.unshift(prev.id);
+                processed.add(prev.id);
+                current = prev;
+            }
+            else {
+                break;
+            }
+        }
+        if (history.length > 0) {
+            chains.push({
+                current: d.id,
+                history,
+            });
+        }
+        processed.add(d.id);
+    }
+    return {
+        decisions: decisionList,
+        decision_chains: chains,
+    };
+}
+// =============================================================================
+// Supersede Document
+// =============================================================================
+/**
+ * Update a document based on a decision, creating a new version.
+ */
+export async function supersedeDocument(input, deps) {
+    const { document_id, decision_id, new_content, change_summary } = input;
+    // Get the document
+    const doc = await deps.getEntity(document_id);
+    if (!doc || doc.type !== 'document') {
+        throw new Error(`Document not found: ${document_id}`);
+    }
+    // Get the decision
+    const decision = await deps.getEntity(decision_id);
+    if (!decision || decision.type !== 'decision') {
+        throw new Error(`Decision not found: ${decision_id}`);
+    }
+    const document = doc;
+    const currentVersion = parseInt(document.version || '1', 10);
+    const newVersion = currentVersion + 1;
+    // Update the document
+    // Note: We store the decision reference in implementation_context since
+    // Document doesn't have a supersedes_decision field
+    // Note: previous_version is now a single DocumentId (not an array)
+    // The old document's next_version will be auto-synced by the runtime
+    await deps.updateDocument(document_id, {
+        content: new_content,
+        version: String(newVersion),
+        implementation_context: `Updated per decision ${decision_id}: ${change_summary}`,
+        previous_version: document.id, // Reference to previous version (single ID)
+    });
+    return {
+        document_id,
+        new_version: newVersion,
+        decision_id,
+        previous_version_ref: `${document_id}@v${currentVersion}`,
+    };
+}
+// =============================================================================
+// Get Document History
+// =============================================================================
+/**
+ * Get version history for a document.
+ */
+export async function getDocumentHistory(input, deps) {
+    const { document_id } = input;
+    const doc = await deps.getEntity(document_id);
+    if (!doc || doc.type !== 'document') {
+        throw new Error(`Document not found: ${document_id}`);
+    }
+    const document = doc;
+    const currentVersion = parseInt(document.version || '1', 10);
+    // Build history from previous_versions
+    const history = [];
+    // Current version
+    history.push({
+        version: currentVersion,
+        date: document.updated_at,
+        // Note: supersedes_decision would need to be parsed from implementation_context
+        // or stored separately in a real implementation
+        supersedes_decision: undefined,
+        change_summary: 'Current version',
+    });
+    // Previous versions (simplified - would need more metadata in real impl)
+    if (document.previous_version) {
+        for (let i = document.previous_version.length - 1; i >= 0; i--) {
+            history.push({
+                version: currentVersion - (document.previous_version.length - i),
+                date: document.created_at, // Would need actual dates
+                change_summary: 'Previous version',
+            });
+        }
+    }
+    return {
+        document_id,
+        current_version: currentVersion,
+        history,
+    };
+}
+// =============================================================================
+// Check Document Freshness
+// =============================================================================
+/**
+ * Check if a document is up-to-date with related decisions.
+ */
+export async function checkDocumentFreshness(input, deps) {
+    const { document_id } = input;
+    const doc = await deps.getEntity(document_id);
+    if (!doc || doc.type !== 'document') {
+        throw new Error(`Document not found: ${document_id}`);
+    }
+    const document = doc;
+    const staleReasons = [];
+    const suggestedUpdates = [];
+    // Check for newer decisions that might affect this document
+    const relatedDecisions = await deps.getDecisionsAffectingDocument(document_id);
+    for (const decision of relatedDecisions) {
+        if (decision.decided_on && decision.decided_on > document.updated_at) {
+            staleReasons.push({
+                type: 'newer_decision',
+                detail: `Decision "${decision.title}" was made after last document update`,
+                entity_id: decision.id,
+            });
+            suggestedUpdates.push(`Review and incorporate decision: ${decision.title}`);
+        }
+    }
+    // Check for TODO items in content
+    const hasTodos = await deps.searchContent(document_id, 'TODO|FIXME|XXX');
+    if (hasTodos) {
+        staleReasons.push({
+            type: 'todo_items',
+            detail: 'Document contains TODO/FIXME items',
+        });
+        suggestedUpdates.push('Address TODO items in document');
+    }
+    return {
+        document_id,
+        is_fresh: staleReasons.length === 0,
+        stale_reasons: staleReasons,
+        suggested_updates: suggestedUpdates,
+    };
+}
+//# sourceMappingURL=decision-document-tools.js.map

package/dist/tools/decision-document-tools.js.map

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

package/dist/tools/entity-management-tools.d.ts

@@ -0,0 +1,79 @@
+/**
+ * V2 Entity Management Tools
+ *
+ * MCP tools for creating, updating, archiving, and restoring entities.
+ */
+import { Entity, EntityId, EntityType, EntityStatus } from '../models/v2-types.js';
+import { CreateEntityInput, CreateEntityOutput, UpdateEntityInput, UpdateEntityOutput, UpdateEntityStatusInput, UpdateEntityStatusOutput, ArchiveEntityInput, ArchiveEntityOutput, ArchiveMilestoneInput, ArchiveMilestoneOutput, RestoreFromArchiveInput, RestoreFromArchiveOutput, EntityFull } from './tool-types.js';
+export interface EntityManagementDependencies {
+    getEntity: (id: EntityId) => Promise<Entity | null>;
+    getNextId: (type: EntityType) => Promise<EntityId>;
+    getChildren: (parentId: EntityId) => Promise<Entity[]>;
+    entityExists: (id: EntityId) => boolean;
+    getEntityType: (id: EntityId) => EntityType | null;
+    writeEntity: (entity: Entity) => Promise<void>;
+    moveToArchive: (id: EntityId, archivePath?: string) => Promise<string>;
+    restoreFromArchive: (id: EntityId) => Promise<string>;
+    validateStatusTransition: (entity: Entity, newStatus: EntityStatus) => {
+        valid: boolean;
+        reason?: string;
+    };
+    computeCascadeEffects: (entity: Entity, newStatus: EntityStatus) => Promise<EntityId[]>;
+    addToCanvas?: (entity: Entity, canvasPath: string) => Promise<boolean>;
+    removeFromCanvas?: (id: EntityId, canvasPath: string) => Promise<boolean>;
+    toEntityFull: (entity: Entity) => Promise<EntityFull>;
+    getCurrentTimestamp: () => string;
+}
+export interface RelationshipValidationError {
+    field: string;
+    message: string;
+    invalidId?: EntityId;
+}
+/**
+ * Validate entity relationships before creation/update.
+ * Checks that:
+ * 1. All referenced entity IDs exist (or are in the batch being created)
+ * 2. Relationship types are valid (e.g., decisions can't enable milestones)
+ *
+ * @param type - The entity type being created/updated
+ * @param data - The entity data containing relationships
+ * @param deps - Dependencies for entity lookup
+ * @param batchIds - Optional map of IDs being created in the same batch (id -> type)
+ */
+export declare function validateRelationships(type: EntityType, data: Record<string, unknown>, deps: {
+    entityExists: (id: EntityId) => boolean;
+    getEntityType: (id: EntityId) => EntityType | null;
+}, batchIds?: Map<EntityId, EntityType>): RelationshipValidationError[];
+/**
+ * Create a new entity with optional dependencies and relationships.
+ */
+export declare function createEntity(input: CreateEntityInput, deps: EntityManagementDependencies): Promise<CreateEntityOutput>;
+/**
+ * Update entity fields and/or modify relationships.
+ * Enhanced to support:
+ * - Status updates with validation and cascade (replaces update_entity_status)
+ * - Archive operations (replaces archive_entity, archive_milestone)
+ * - Restore operations (replaces restore_from_archive)
+ */
+export declare function updateEntity(input: UpdateEntityInput, deps: EntityManagementDependencies): Promise<UpdateEntityOutput>;
+/**
+ * @deprecated Use updateEntity({ id, status, status_note, cascade }) instead.
+ * Dedicated status update with optional note and cascade.
+ */
+export declare function updateEntityStatus(input: UpdateEntityStatusInput, deps: EntityManagementDependencies): Promise<UpdateEntityStatusOutput>;
+/**
+ * @deprecated Use updateEntity({ id, archived: true, archive_options }) instead.
+ * Archive a single entity.
+ */
+export declare function archiveEntity(input: ArchiveEntityInput, deps: EntityManagementDependencies): Promise<ArchiveEntityOutput>;
+/**
+ * @deprecated Use updateEntity({ id, archived: true, archive_options: { cascade: true } }) instead.
+ * Archive a milestone and all its children.
+ */
+export declare function archiveMilestone(input: ArchiveMilestoneInput, deps: EntityManagementDependencies): Promise<ArchiveMilestoneOutput>;
+/**
+ * @deprecated Use updateEntity({ id, archived: false, restore_options }) instead.
+ * Restore an archived entity.
+ */
+export declare function restoreFromArchive(input: RestoreFromArchiveInput, deps: EntityManagementDependencies): Promise<RestoreFromArchiveOutput>;
+//# sourceMappingURL=entity-management-tools.d.ts.map

package/dist/tools/entity-management-tools.d.ts.map

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