@weavelogic/knowledge-graph-agent 0.3.0 → 0.4.0

package/dist/workflow/workflows/realtime-collab.d.ts

@@ -0,0 +1,245 @@
+/**
+ * Real-Time Collaboration Workflow
+ *
+ * Durable workflow that monitors documentation changes and
+ * autonomously manages task specification generation.
+ *
+ * Uses Workflow DevKit's "use workflow" and "use step" directives
+ * for durable execution with automatic retry and replay.
+ *
+ * @module workflow/workflows/realtime-collab
+ */
+/**
+ * World state representation for GOAP planning
+ *
+ * Tracks the current state of documentation and development readiness.
+ */
+export interface WorldState {
+    /** Whether a specification document exists */
+    hasSpecification: boolean;
+    /** Completeness score from 0 to 1 */
+    specCompleteness: number;
+    /** Whether acceptance criteria have been defined */
+    hasAcceptanceCriteria: boolean;
+    /** Whether task is fully defined */
+    taskDefined: boolean;
+    /** Whether there are no blockers preventing development */
+    blockersFree: boolean;
+    /** Whether development has started */
+    developmentStarted: boolean;
+    /** Time since last document change in milliseconds */
+    timeSinceLastChange: number;
+    /** Timestamp of last document change */
+    lastChangeTimestamp: number;
+    /** List of active collaborator IDs */
+    activeCollaborators: string[];
+    /** List of pending gaps to address */
+    pendingGaps: string[];
+}
+/**
+ * Event emitted when a node is updated in the knowledge graph
+ */
+export interface NodeUpdateEvent {
+    /** Node ID that was updated */
+    nodeId: string;
+    /** Type of update (created, modified, deleted) */
+    updateType: 'created' | 'modified' | 'deleted';
+    /** Path to the document */
+    docPath: string;
+    /** Timestamp of the update */
+    timestamp: Date;
+    /** User who made the change */
+    userId?: string;
+    /** Change summary */
+    changeSummary?: string;
+}
+/**
+ * Individual gap identified during analysis
+ */
+export interface Gap {
+    /** Type of gap (missing_section, incomplete_content, etc.) */
+    type: 'missing_section' | 'incomplete_content' | 'unclear_requirements' | 'missing_tests';
+    /** Human-readable description */
+    description: string;
+    /** Severity level */
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    /** Suggested content to fill the gap */
+    suggestedContent?: string;
+    /** Location in document where gap was found */
+    location?: string;
+}
+/**
+ * Result of gap analysis on a document
+ */
+export interface GapAnalysis {
+    /** Path to analyzed document */
+    docPath: string;
+    /** Overall completeness score from 0 to 1 */
+    completeness: number;
+    /** List of identified gaps */
+    gaps: Gap[];
+    /** Recommendations for improvement */
+    recommendations: string[];
+    /** Timestamp of analysis */
+    analyzedAt: Date;
+}
+/**
+ * Generated task specification from documentation
+ */
+export interface TaskSpec {
+    /** Unique task identifier */
+    id: string;
+    /** Task version */
+    version: string;
+    /** Task title */
+    title: string;
+    /** Detailed description */
+    description: string;
+    /** Priority level */
+    priority: 'low' | 'medium' | 'high' | 'critical';
+    /** List of requirements */
+    requirements: string[];
+    /** Acceptance criteria that must be met */
+    acceptanceCriteria: string[];
+    /** Estimated complexity (1-10 scale) */
+    estimatedComplexity: number;
+    /** Source document path */
+    sourceDoc: string;
+    /** Generation timestamp */
+    generatedAt: Date;
+    /** Confidence score for the specification */
+    confidence: number;
+}
+/**
+ * Step in a GOAP plan
+ */
+export interface GOAPStep {
+    /** Action to take */
+    action: string;
+    /** Cost of this action */
+    cost: number;
+    /** Expected state after this action */
+    expectedState: Partial<WorldState>;
+    /** Prerequisites that must be true */
+    preconditions?: Partial<WorldState>;
+}
+/**
+ * GOAP plan for achieving a goal
+ */
+export interface GOAPPlan {
+    /** Goal being pursued */
+    goal: string;
+    /** Whether the goal is achievable */
+    achievable: boolean;
+    /** Ordered list of steps */
+    steps: GOAPStep[];
+    /** Total cost of the plan */
+    totalCost: number;
+    /** Confidence in plan success */
+    confidence: number;
+}
+/**
+ * Main real-time collaboration workflow
+ *
+ * This durable workflow:
+ * 1. Monitors documentation for changes
+ * 2. Analyzes gaps when changes occur
+ * 3. Generates task specs when documentation is sufficient
+ * 4. Auto-generates missing docs after inactivity timeout
+ *
+ * The workflow uses "use workflow" directive for durability,
+ * ensuring it can survive restarts and failures.
+ *
+ * @param graphId - Knowledge graph identifier
+ * @param docPath - Path to monitor for documentation
+ * @param options - Workflow configuration options
+ *
+ * @example
+ * ```typescript
+ * await realtimeCollaborationWorkflow('graph-123', '/docs/feature.md', {
+ *   inactivityTimeout: 5 * 60 * 1000, // 5 minutes
+ *   autoStartThreshold: 0.7
+ * });
+ * ```
+ */
+export declare function realtimeCollaborationWorkflow(graphId: string, docPath: string, options?: {
+    /** Timeout before auto-generating missing docs (ms) */
+    inactivityTimeout?: number;
+    /** Completeness threshold to trigger development */
+    autoStartThreshold?: number;
+}): Promise<void>;
+/**
+ * Gap detection workflow - runs on document change
+ *
+ * Lightweight workflow that performs gap analysis without
+ * the full collaboration loop. Use this for quick checks.
+ *
+ * @param docPath - Path to document to analyze
+ * @returns Gap analysis results
+ *
+ * @example
+ * ```typescript
+ * const analysis = await gapDetectionWorkflow('/docs/api-spec.md');
+ * console.log(`Completeness: ${analysis.completeness * 100}%`);
+ * console.log(`Gaps found: ${analysis.gaps.length}`);
+ * ```
+ */
+export declare function gapDetectionWorkflow(docPath: string): Promise<GapAnalysis>;
+/**
+ * Task specification workflow - generates spec from docs
+ *
+ * Complete workflow that analyzes documentation and generates
+ * a task specification. Includes gap analysis as part of the process.
+ *
+ * @param docPath - Path to source documentation
+ * @returns Generated task specification
+ *
+ * @example
+ * ```typescript
+ * const spec = await taskSpecWorkflow('/docs/new-feature.md');
+ * console.log(`Generated task: ${spec.title}`);
+ * console.log(`Priority: ${spec.priority}`);
+ * console.log(`Complexity: ${spec.estimatedComplexity}/10`);
+ * ```
+ */
+export declare function taskSpecWorkflow(docPath: string): Promise<TaskSpec>;
+/**
+ * Document enhancement workflow - fills gaps automatically
+ *
+ * Workflow that analyzes documentation, identifies gaps, and
+ * generates content to fill those gaps.
+ *
+ * @param docPath - Path to document to enhance
+ * @returns Object containing analysis and generated content
+ *
+ * @example
+ * ```typescript
+ * const result = await documentEnhancementWorkflow('/docs/incomplete.md');
+ * console.log(`Filled ${result.generatedContent.length} gaps`);
+ * ```
+ */
+export declare function documentEnhancementWorkflow(docPath: string): Promise<{
+    analysis: GapAnalysis;
+    generatedContent: string[];
+}>;
+/**
+ * GOAP planning workflow - creates action plan
+ *
+ * Workflow that analyzes current state and creates an optimal
+ * plan to achieve the specified goal.
+ *
+ * @param docPath - Path to source documentation
+ * @param goal - Goal to achieve
+ * @returns GOAP plan with steps and costs
+ *
+ * @example
+ * ```typescript
+ * const plan = await goapPlanningWorkflow('/docs/feature.md', 'start-development');
+ * if (plan.achievable) {
+ *   console.log(`Plan has ${plan.steps.length} steps`);
+ *   console.log(`Total cost: ${plan.totalCost}`);
+ * }
+ * ```
+ */
+export declare function goapPlanningWorkflow(docPath: string, goal: string): Promise<GOAPPlan>;
+//# sourceMappingURL=realtime-collab.d.ts.map

package/dist/workflow/workflows/realtime-collab.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weavelogic/knowledge-graph-agent",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Knowledge graph agent for Claude Code - generates knowledge graphs, initializes docs, and integrates with claude-flow",
   "type": "module",
   "main": "dist/index.js",