@vfarcic/dot-ai 0.171.0 → 0.172.0

package/README.md

@@ -39,6 +39,13 @@ DevOps AI Toolkit brings AI-powered intelligence to platform engineering, Kubern
 - Automated repository setup with governance files
 - Shared prompt libraries for consistent workflows
 
+## Deployment Options
+
+- **[Kubernetes Setup](https://devopstoolkit.ai/docs/mcp/setup/kubernetes-setup/)** - Recommended: Full features with autonomous capability scanning
+- **[ToolHive Setup](https://devopstoolkit.ai/docs/mcp/setup/kubernetes-toolhive-setup/)** - Operator-managed Kubernetes deployment
+- **[Docker Setup](https://devopstoolkit.ai/docs/mcp/setup/docker-setup/)** - Local development (manual capability scanning only)
+- **[NPX Setup](https://devopstoolkit.ai/docs/mcp/setup/npx-setup/)** - Quick trials with Node.js
+
 [Read the Documentation](https://devopstoolkit.ai/docs/mcp/)
 
 ## Support

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

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

package/dist/core/discovery.js

@@ -413,12 +413,34 @@ class KubernetesDiscovery {
                 // Parse the standard kubectl api-resources format:
                 // NAME                                SHORTNAMES   APIVERSION                        NAMESPACED   KIND
                 // pods                                po           v1                                true         Pod
+                // bindings                                         v1                                true         Binding (no shortname)
                 const parts = line.trim().split(/\s+/);
-                if (parts.length < 5) {
-                    // Skip malformed lines
+                if (parts.length < 4) {
+                    // Skip truly malformed lines (need at least name, apiVersion, namespaced, kind)
                     return null;
                 }
-                const [name, shortNames, apiVersion, namespaced, kind] = parts;
+                let name, shortNames, apiVersion, namespaced, kind;
+                if (parts.length === 4) {
+                    // No shortnames column: name, apiVersion, namespaced, kind
+                    [name, apiVersion, namespaced, kind] = parts;
+                    shortNames = '';
+                }
+                else {
+                    // parts.length >= 5: Has shortnames column: name, shortNames, apiVersion, namespaced, kind
+                    // But need to verify column 2 is actually shortnames, not apiVersion
+                    // apiVersion matches patterns like "v1", "apps/v1", "networking.k8s.io/v1"
+                    const col2 = parts[1];
+                    const looksLikeApiVersion = col2.includes('/') || /^v\d/.test(col2);
+                    if (looksLikeApiVersion) {
+                        // Column 2 is apiVersion, no shortnames
+                        [name, apiVersion, namespaced, kind] = parts;
+                        shortNames = '';
+                    }
+                    else {
+                        // Column 2 is shortnames
+                        [name, shortNames, apiVersion, namespaced, kind] = parts;
+                    }
+                }
                 // Extract group from apiVersion (e.g., "apps/v1" -> "apps", "v1" -> "")
                 let group = '';
                 if (apiVersion && apiVersion.includes('/')) {

package/dist/tools/organizational-data.d.ts

@@ -40,6 +40,9 @@ export declare const ORGANIZATIONAL_DATA_TOOL_INPUT_SCHEMA: {
         apiVersion: z.ZodString;
     }, z.core.$strip>>;
     resourceList: z.ZodOptional<z.ZodString>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        full: "full";
+    }>>;
     collection: z.ZodOptional<z.ZodString>;
     interaction_id: z.ZodOptional<z.ZodString>;
 };

package/dist/tools/organizational-data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"organizational-data.d.ts","sourceRoot":"","sources":["../../src/tools/organizational-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAehD,eAAO,MAAM,6BAA6B,kBAAkB,CAAC;AAC7D,eAAO,MAAM,oCAAoC,+jBAAyjB,CAAC;AAG3mB,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BjD,CAAC;AAklBF;;GAEG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,KAAK,GAAG,IAAI,EACpB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,CA0Hd"}
+{"version":3,"file":"organizational-data.d.ts","sourceRoot":"","sources":["../../src/tools/organizational-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAehD,eAAO,MAAM,6BAA6B,kBAAkB,CAAC;AAC7D,eAAO,MAAM,oCAAoC,+jBAAyjB,CAAC;AAG3mB,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BjD,CAAC;AA0sBF;;GAEG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,KAAK,GAAG,IAAI,EACpB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,CA0Hd"}

package/dist/tools/organizational-data.js

@@ -78,8 +78,10 @@ exports.ORGANIZATIONAL_DATA_TOOL_INPUT_SCHEMA = {
         group: zod_1.z.string(),
         apiVersion: zod_1.z.string()
     }).optional().describe('Kubernetes resource reference (for capabilities operations)'),
-    // Resource list for specific resource scanning
-    resourceList: zod_1.z.string().optional().describe('Comma-separated list of resources to scan (format: Kind.group or Kind for core resources)'),
+    // Resource list for specific resource scanning (fire-and-forget when no sessionId)
+    resourceList: zod_1.z.string().optional().describe('Comma-separated list of resources to scan (format: Kind.group or Kind for core resources). When provided without sessionId, triggers a fire-and-forget targeted scan.'),
+    // Fire-and-forget scan mode (for controller integration)
+    mode: zod_1.z.enum(['full']).optional().describe('Scan mode: "full" triggers a fire-and-forget full cluster scan that returns immediately and scans all resources in the cluster. Mutually exclusive with resourceList.'),
     // Collection name for capabilities (allows using different collections for different purposes)
     collection: zod_1.z.string().optional().describe('Collection name for capabilities operations (default: "capabilities", use "capabilities-policies" for pre-populated test data)'),
     interaction_id: zod_1.z.string().optional().describe('INTERNAL ONLY - Do not populate. Used for evaluation dataset generation.')
@@ -197,6 +199,85 @@ function createCapabilityScanCompletionResponse(sessionId, totalProcessed, succe
         userNote: "The above options are available for you to choose from - the system will not execute them automatically."
     };
 }
+/**
+ * Handle fire-and-forget capability scanning (PRD #216 - Controller Integration)
+ *
+ * This function provides a simplified API for automated controllers to trigger
+ * capability scans without going through the interactive workflow.
+ *
+ * Two modes:
+ * 1. mode: "full" - Triggers full cluster scan
+ * 2. resourceList: "Kind.group,Kind.group" - Triggers targeted scan
+ *
+ * Both modes return immediately with { status: "started" } and run scanning in background.
+ */
+async function handleFireAndForgetScan(args, logger, requestId, capabilityService) {
+    const isFullScan = args.mode === 'full';
+    const isTargetedScan = !!args.resourceList;
+    logger.info('Fire-and-forget scan initiated', {
+        requestId,
+        mode: isFullScan ? 'full' : 'targeted',
+        resourceList: args.resourceList
+    });
+    // Create a session for progress tracking (controllers can optionally poll for status)
+    const sessionId = `cap-scan-${Date.now()}-${(0, crypto_1.randomUUID)().substring(0, 8)}`;
+    const session = {
+        sessionId,
+        currentStep: 'scanning',
+        startedAt: new Date().toISOString(),
+        lastActivity: new Date().toISOString(),
+        selectedResources: isFullScan ? 'all' : undefined,
+        resourceList: args.resourceList,
+        currentResourceIndex: 0
+    };
+    // If targeted scan, parse and validate resources
+    const parsedResources = isTargetedScan && !isFullScan
+        ? args.resourceList.split(',').map((r) => r.trim()).filter((r) => r.length > 0)
+        : [];
+    if (isTargetedScan && !isFullScan) {
+        if (parsedResources.length === 0) {
+            return {
+                success: false,
+                operation: 'scan',
+                dataType: 'capabilities',
+                error: {
+                    message: 'Empty resource list',
+                    details: 'resourceList parameter must contain at least one resource'
+                }
+            };
+        }
+        session.selectedResources = parsedResources;
+    }
+    // Save session for progress tracking
+    saveCapabilitySession(session);
+    // Start scanning in background (don't await) - fire and forget
+    (0, capability_scan_workflow_1.handleScanning)(session, { ...args, response: undefined }, logger, requestId, capabilityService, parseNumericResponse, transitionCapabilitySession, cleanupCapabilitySession, createCapabilityScanCompletionResponse).catch(error => {
+        logger.error('Background fire-and-forget scan failed', error, {
+            requestId,
+            sessionId: session.sessionId,
+            mode: isFullScan ? 'full' : 'targeted'
+        });
+    });
+    // Return immediately - don't wait for scan to complete
+    const resourceCount = parsedResources.length > 0 ? parsedResources.length : undefined;
+    return {
+        success: true,
+        operation: 'scan',
+        dataType: 'capabilities',
+        status: 'started',
+        mode: isFullScan ? 'full' : 'targeted',
+        sessionId: session.sessionId,
+        message: isFullScan
+            ? 'Full cluster scan initiated. Scan runs in background.'
+            : `Scan initiated for ${resourceCount} resource(s). Scan runs in background.`,
+        ...(resourceCount && { resourceCount }),
+        checkProgress: {
+            dataType: 'capabilities',
+            operation: 'progress',
+            sessionId: session.sessionId
+        }
+    };
+}
 /**
  * Handle capabilities operations - PRD #48 Implementation
  */
@@ -481,6 +562,19 @@ async function handleCapabilityScan(args, logger, requestId) {
         vectorDB: 'healthy',
         embeddings: 'available'
     });
+    // ============================================================================
+    // FIRE-AND-FORGET MODE (PRD #216 - Controller Integration)
+    // ============================================================================
+    // Check for fire-and-forget parameters BEFORE interactive workflow
+    // This allows controllers to trigger scans without going through the interactive steps
+    // ============================================================================
+    const isFireAndForget = !args.sessionId && (args.mode === 'full' || args.resourceList);
+    if (isFireAndForget) {
+        return await handleFireAndForgetScan(args, logger, requestId, capabilityService);
+    }
+    // ============================================================================
+    // INTERACTIVE WORKFLOW MODE (Existing behavior for human users)
+    // ============================================================================
     // Get or create session with step-based state management
     const session = getOrCreateCapabilitySession(args.sessionId, args, logger, requestId);
     // Validate client is on correct step - only for existing sessions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vfarcic/dot-ai",
-  "version": "0.171.0",
+  "version": "0.172.0",
   "description": "AI-powered development productivity platform that enhances software development workflows through intelligent automation and AI-driven assistance",
   "mcpName": "io.github.vfarcic/dot-ai",
   "main": "dist/index.js",

package/shared-prompts/prd-close.md

@@ -82,7 +82,7 @@ Proceed with closure? (yes/no)
 
 ### Step 3: Update PRD File
 
-Update the PRD metadata and add completion work log:
+Update the PRD metadata:
 
 **Metadata Updates:**
 ```markdown
@@ -91,34 +91,6 @@ Update the PRD metadata and add completion work log:
 **Completed**: [Current Date] [or] **Closed**: [Current Date]
 ```
 
-**Add Work Log Entry:**
-```markdown
-### [Date]: PRD Closure - [Reason Category]
-**Duration**: N/A (administrative closure)
-**Status**: [Complete/Closed]
-
-**Closure Summary**:
-[Explain why PRD is being closed]
-
-**Implementation Evidence**: [If applicable]
-[Link to external project, previous PR, or existing functionality]
-
-**Key Points**:
-- [What was requested in original PRD]
-- [How/where it was implemented, or why no longer needed]
-- [Any gaps or differences from original requirements]
-
-[If "Already Implemented"]
-**Functionality Delivered**:
-- [Feature 1] - Implemented in [location/project]
-- [Feature 2] - Implemented in [location/project]
-
-[If "No Longer Needed"]
-**Reason for Closure**:
-- [Why requirements changed]
-- [What superseded this PRD]
-```
-
 ### Step 4: Move PRD to Archive
 
 Move the PRD file to the done directory and update roadmap:
@@ -219,7 +191,6 @@ git commit -m "docs(prd-[number]): close PRD #[number] - [brief reason] [skip ci
 
 - Moved PRD to prds/done/ directory
 - Updated PRD status to [Complete/Closed]
-- Added work log documenting [closure reason]
 - Updated GitHub issue description with new path
 - [Implementation details or reason]
 
@@ -296,7 +267,7 @@ Requirements have evolved and this PRD is out of scope.
 
 ## Success Criteria
 
-✅ **PRD file updated** with completion/closure metadata and work log
+✅ **PRD file updated** with completion/closure metadata
 ✅ **PRD archived** to `prds/done/` directory
 ✅ **GitHub issue updated** with new PRD path
 ✅ **GitHub issue closed** with comprehensive closure comment
@@ -307,6 +278,6 @@ Requirements have evolved and this PRD is out of scope.
 
 - **No PR required**: This workflow commits directly to main for documentation-only changes
 - **Skip CI**: Always include `[skip ci]` to avoid unnecessary CI runs
-- **Comprehensive documentation**: Ensure work log and issue comment clearly explain closure
+- **Comprehensive documentation**: Ensure issue comment clearly explains closure reason
 - **Implementation references**: Link to external projects, repos, or PRs where functionality exists
 - **Gap acknowledgment**: Be honest about what's implemented vs. what's missing

package/shared-prompts/prd-update-progress.md

@@ -17,7 +17,7 @@ You are helping update an existing Product Requirements Document (PRD) based on
 3. **Map Changes to PRD Items** - Intelligently connect work to requirements
 4. **Propose Updates** - Suggest checkbox completions and requirement changes
 5. **User Confirmation** - Verify proposals and handle edge cases
-6. **Update PRD** - Apply changes and add work log entry
+6. **Update PRD** - Apply changes to checkboxes and status
 7. **Flag Divergences** - Alert when actual work differs from planned work
 8. **Commit Progress Updates** - Preserve progress checkpoint
 9. **Continue to Next Task** - Prompt user to run /prd-next
@@ -181,26 +181,6 @@ Present a comprehensive breakdown:
 **CLEARLY list what still needs to be done.**
 **DO NOT claim "everything is done" unless ALL items are truly complete.**
 
-### Work Log Updates
-Propose adding a work log entry summarizing completed work:
-```markdown
-### [Date]: Implementation Progress Update
-**Duration**: [X hours estimated based on commit timestamps]
-**Commits**: [X commits] 
-**Primary Focus**: [Main area of work based on file changes]
-
-**Completed PRD Items**:
-- [x] [Requirement] - Evidence: [specific files/changes]
-- [x] [Second requirement] - Evidence: [specific files/changes]
-
-**Additional Work Done**:
-- [Unexpected work that emerged during implementation]
-- [Refactoring or improvements not originally planned]
-
-**Next Session Priorities**:
-- [Items that should be worked on next based on current state]
-```
-
 ## Step 5: Implementation vs Plan Analysis
 
 ### Divergence Detection
@@ -243,10 +223,9 @@ Wait for user confirmation before making changes, and handle:
 
 When applying updates:
 1. **Update only confirmed items** - Don't make assumptions
-2. **Add detailed work log entry** with evidence links
-3. **Update status sections** to reflect current phase
-4. **Preserve unchecked items** that still need work
-5. **Update completion percentages** realistically
+2. **Update status sections** to reflect current phase
+3. **Preserve unchecked items** that still need work
+4. **Update completion percentages** realistically
 
 ## Step 7.5: Code Example Validation
 
@@ -299,7 +278,6 @@ git commit -m "feat(prd-X): implement [brief description of completed work]
 
 - [Brief list of key implementation achievements]
 - Updated PRD checkboxes for completed items
-- Added work log entry with progress summary
 
 Progress: X% complete - [next major milestone]"
 ```