@vfarcic/dot-ai 0.116.0 → 0.117.0

package/dist/core/doc-testing-types.d.ts

@@ -1,127 +0,0 @@
-/**
- * Documentation Testing Types
- *
- * Flexible TypeScript interfaces for the documentation testing system.
- * Designed to let AI agents dynamically identify and categorize testable content.
- */
-/**
- * Main session object that tracks a documentation validation workflow
- */
-export interface ValidationSession {
-    sessionId: string;
-    filePath: string;
-    startTime: string;
-    currentPhase: ValidationPhase;
-    status: SessionStatus;
-    metadata: SessionMetadata;
-    sections?: DocumentSection[];
-    sectionResults?: Record<string, SectionTestResult>;
-}
-/**
- * Session metadata with counters and summary information
- */
-export interface SessionMetadata {
-    totalSections: number;
-    completedSections: number;
-    sectionStatus: Record<string, SectionStatus>;
-    nextItemId: number;
-    sessionDir: string;
-    lastUpdated: string;
-}
-/**
- * The five phases of documentation validation workflow
- */
-export declare enum ValidationPhase {
-    SCAN = "scan",// Find all testable items in the documentation
-    TEST = "test",// Execute tests on the found items
-    ANALYZE = "analyze",// Analyze results and categorize issues
-    FIX = "fix",// Generate fixes for identified problems
-    DONE = "done"
-}
-/**
- * Overall status of a validation session
- */
-export declare enum SessionStatus {
-    ACTIVE = "active",// Session is currently being worked on
-    COMPLETED = "completed",// All phases completed successfully
-    FAILED = "failed",// Session failed due to errors
-    PAUSED = "paused"
-}
-/**
- * Status of a document section during validation
- */
-export declare enum SectionStatus {
-    PENDING = "pending",// Section not yet processed
-    SCANNING = "scanning",// Currently identifying testable items
-    TESTING = "testing",// Currently executing validation items  
-    ANALYZING = "analyzing",// Currently analyzing test results
-    FIXING = "fixing",// Currently generating fixes
-    COMPLETED = "completed",// Section validation completed successfully
-    FAILED = "failed"
-}
-/**
- * Logical section of a document for validation
- */
-export interface DocumentSection {
-    id: string;
-    title: string;
-}
-/**
- * Individual issue or recommendation with tracking
- */
-export interface FixableItem {
-    id: number;
-    text: string;
-    status: 'pending' | 'fixed' | 'deferred' | 'failed';
-    explanation?: string;
-}
-/**
- * Structured test results for a section (JSON format from client agent)
- *
- * Note: Format was consolidated in PRD #34 - issues now contain both problems and solutions
- * in format "[Location]: [Problem]. Fix: [Solution]"
- */
-export interface SectionTestResult {
-    whatWasDone: string;
-    issues: FixableItem[];
-}
-/**
- * Workflow step returned by MCP interface to guide AI agents
- */
-export interface WorkflowStep {
-    sessionId: string;
-    phase: ValidationPhase;
-    prompt: string;
-    nextPhase?: ValidationPhase;
-    nextAction?: string;
-    instruction?: string;
-    agentInstructions?: string;
-    workflow: {
-        completed: ValidationPhase[];
-        current: ValidationPhase;
-        remaining: ValidationPhase[];
-    };
-    data?: any;
-}
-/**
- * Phase-specific result tracking
- */
-export interface PhaseResult {
-    phase: ValidationPhase;
-    startTime: string;
-    endTime?: string;
-    status: PhaseStatus;
-    summary: string;
-    nextPhase?: ValidationPhase;
-    aiInsights?: string;
-}
-/**
- * Status of a validation phase
- */
-export declare enum PhaseStatus {
-    PENDING = "pending",
-    IN_PROGRESS = "in_progress",
-    COMPLETED = "completed",
-    FAILED = "failed"
-}
-//# sourceMappingURL=doc-testing-types.d.ts.map

package/dist/core/doc-testing-types.d.ts.map

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

package/dist/core/doc-testing-types.js

@@ -1,53 +0,0 @@
-"use strict";
-/**
- * Documentation Testing Types
- *
- * Flexible TypeScript interfaces for the documentation testing system.
- * Designed to let AI agents dynamically identify and categorize testable content.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PhaseStatus = exports.SectionStatus = exports.SessionStatus = exports.ValidationPhase = void 0;
-/**
- * The five phases of documentation validation workflow
- */
-var ValidationPhase;
-(function (ValidationPhase) {
-    ValidationPhase["SCAN"] = "scan";
-    ValidationPhase["TEST"] = "test";
-    ValidationPhase["ANALYZE"] = "analyze";
-    ValidationPhase["FIX"] = "fix";
-    ValidationPhase["DONE"] = "done"; // Mark session as completed
-})(ValidationPhase || (exports.ValidationPhase = ValidationPhase = {}));
-/**
- * Overall status of a validation session
- */
-var SessionStatus;
-(function (SessionStatus) {
-    SessionStatus["ACTIVE"] = "active";
-    SessionStatus["COMPLETED"] = "completed";
-    SessionStatus["FAILED"] = "failed";
-    SessionStatus["PAUSED"] = "paused"; // Session temporarily paused
-})(SessionStatus || (exports.SessionStatus = SessionStatus = {}));
-/**
- * Status of a document section during validation
- */
-var SectionStatus;
-(function (SectionStatus) {
-    SectionStatus["PENDING"] = "pending";
-    SectionStatus["SCANNING"] = "scanning";
-    SectionStatus["TESTING"] = "testing";
-    SectionStatus["ANALYZING"] = "analyzing";
-    SectionStatus["FIXING"] = "fixing";
-    SectionStatus["COMPLETED"] = "completed";
-    SectionStatus["FAILED"] = "failed"; // Section validation failed
-})(SectionStatus || (exports.SectionStatus = SectionStatus = {}));
-/**
- * Status of a validation phase
- */
-var PhaseStatus;
-(function (PhaseStatus) {
-    PhaseStatus["PENDING"] = "pending";
-    PhaseStatus["IN_PROGRESS"] = "in_progress";
-    PhaseStatus["COMPLETED"] = "completed";
-    PhaseStatus["FAILED"] = "failed";
-})(PhaseStatus || (exports.PhaseStatus = PhaseStatus = {}));

package/dist/core/nushell-runtime.d.ts

@@ -1,39 +0,0 @@
-/**
- * Nushell Runtime Checker
- *
- * Detects Nushell installation and provides installation guidance.
- */
-export interface NushellVersionInfo {
-    installed: boolean;
-    version: string | null;
-    error?: string;
-}
-export declare class NushellRuntime {
-    /**
-     * Check if Nushell is installed on the system
-     */
-    checkInstalled(): Promise<boolean>;
-    /**
-     * Get the installed Nushell version
-     * Returns null if Nushell is not installed
-     */
-    getVersion(): Promise<string | null>;
-    /**
-     * Get comprehensive version information
-     */
-    getVersionInfo(): Promise<NushellVersionInfo>;
-    /**
-     * Get the official installation documentation URL
-     */
-    getInstallationUrl(): string;
-    /**
-     * Validate Nushell installation and return detailed status
-     */
-    validateRuntime(): Promise<{
-        ready: boolean;
-        message: string;
-        versionInfo?: NushellVersionInfo;
-        installationUrl?: string;
-    }>;
-}
-//# sourceMappingURL=nushell-runtime.d.ts.map

package/dist/core/nushell-runtime.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"nushell-runtime.d.ts","sourceRoot":"","sources":["../../src/core/nushell-runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAOD,qBAAa,cAAc;IACzB;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IASxC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAW1C;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,kBAAkB,CAAC;IA2BnD;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC;QAC/B,KAAK,EAAE,OAAO,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,kBAAkB,CAAC;QACjC,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CA2BH"}

package/dist/core/nushell-runtime.js

@@ -1,103 +0,0 @@
-"use strict";
-/**
- * Nushell Runtime Checker
- *
- * Detects Nushell installation and provides installation guidance.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NushellRuntime = void 0;
-const child_process_1 = require("child_process");
-const util_1 = require("util");
-const execAsync = (0, util_1.promisify)(child_process_1.exec);
-/**
- * Official Nushell installation documentation
- */
-const INSTALL_URL = 'https://www.nushell.sh/book/installation.html';
-class NushellRuntime {
-    /**
-     * Check if Nushell is installed on the system
-     */
-    async checkInstalled() {
-        try {
-            await execAsync('nu --version');
-            return true;
-        }
-        catch (error) {
-            return false;
-        }
-    }
-    /**
-     * Get the installed Nushell version
-     * Returns null if Nushell is not installed
-     */
-    async getVersion() {
-        try {
-            const { stdout } = await execAsync('nu --version');
-            // Parse version from output like "0.95.0" or "nushell 0.95.0"
-            const versionMatch = stdout.trim().match(/(\d+\.\d+\.\d+)/);
-            return versionMatch ? versionMatch[1] : null;
-        }
-        catch (error) {
-            return null;
-        }
-    }
-    /**
-     * Get comprehensive version information
-     */
-    async getVersionInfo() {
-        const installed = await this.checkInstalled();
-        if (!installed) {
-            return {
-                installed: false,
-                version: null,
-                error: 'Nushell is not installed'
-            };
-        }
-        const version = await this.getVersion();
-        if (!version) {
-            return {
-                installed: true,
-                version: null,
-                error: 'Unable to determine Nushell version'
-            };
-        }
-        return {
-            installed: true,
-            version
-        };
-    }
-    /**
-     * Get the official installation documentation URL
-     */
-    getInstallationUrl() {
-        return INSTALL_URL;
-    }
-    /**
-     * Validate Nushell installation and return detailed status
-     */
-    async validateRuntime() {
-        const versionInfo = await this.getVersionInfo();
-        if (!versionInfo.installed) {
-            return {
-                ready: false,
-                message: `Nushell is not installed. Please install Nushell from: ${INSTALL_URL}`,
-                versionInfo,
-                installationUrl: INSTALL_URL
-            };
-        }
-        if (!versionInfo.version) {
-            return {
-                ready: false,
-                message: `Unable to determine Nushell version. Please ensure Nushell is properly installed from: ${INSTALL_URL}`,
-                versionInfo,
-                installationUrl: INSTALL_URL
-            };
-        }
-        return {
-            ready: true,
-            message: `Nushell ${versionInfo.version} is ready`,
-            versionInfo
-        };
-    }
-}
-exports.NushellRuntime = NushellRuntime;

package/dist/core/platform-operations.d.ts

@@ -1,70 +0,0 @@
-/**
- * Platform Operations Discovery
- *
- * Orchestrates tool-based discovery and mapping of Nu shell script operations.
- * All data fetching logic lives in tools, this module handles orchestration.
- */
-import { AIProvider } from './ai-provider.interface';
-import { Logger } from './error-handling';
-export { Operation, OperationCommand } from '../tools/platform/discover-operations.tool';
-import { Operation } from '../tools/platform/discover-operations.tool';
-export interface MatchedOperation {
-    tool: string;
-    operation: string;
-    command: string[];
-    description: string;
-}
-export interface IntentMapping {
-    matched: boolean;
-    operation?: MatchedOperation;
-    reason?: string;
-}
-export interface ParameterMetadata {
-    name: string;
-    type: 'string' | 'number' | 'boolean' | 'choice';
-    required: boolean;
-    description: string;
-    default?: any;
-    choices?: string[];
-}
-export interface PlatformSession {
-    sessionId: string;
-    intent: string;
-    matchedOperation: MatchedOperation;
-    parameters: ParameterMetadata[];
-    answers: Record<string, any>;
-    currentStep: 'collectParameters' | 'confirm' | 'execute' | 'complete';
-    createdAt: string;
-    updatedAt: string;
-}
-/**
- * Discover available operations from Nu shell scripts
- * Uses tool for data fetching and prompt injection for AI parsing
- */
-export declare function discoverOperations(aiProvider: AIProvider, logger: Logger): Promise<Operation[]>;
-/**
- * Map user intent to a specific operation using AI
- */
-export declare function mapIntentToOperation(intent: string, operations: Operation[], aiProvider: AIProvider, logger: Logger): Promise<IntentMapping>;
-/**
- * Get parameters for a specific operation using Nushell's structured JSON output
- */
-export declare function getOperationParameters(command: string[], logger: Logger): Promise<ParameterMetadata[]>;
-/**
- * Create and persist a platform session
- */
-export declare function createSession(sessionId: string, intent: string, matchedOperation: MatchedOperation, parameters: ParameterMetadata[], logger: Logger): Promise<PlatformSession>;
-/**
- * Load a platform session from file
- */
-export declare function loadSession(sessionId: string, logger: Logger): PlatformSession | null;
-/**
- * Execute a platform operation with collected parameters
- */
-export declare function executeOperation(session: PlatformSession, answers: Record<string, any>, logger: Logger): Promise<{
-    success: boolean;
-    message?: string;
-    error?: string;
-    missingParameters?: string[];
-}>;
-//# sourceMappingURL=platform-operations.d.ts.map

package/dist/core/platform-operations.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"platform-operations.d.ts","sourceRoot":"","sources":["../../src/core/platform-operations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAM1C,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAGzF,OAAO,EAAE,SAAS,EAAE,MAAM,4CAA4C,CAAC;AAEvE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACjD,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,WAAW,EAAE,mBAAmB,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,SAAS,EAAE,CAAC,CAkCtB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,SAAS,EAAE,EACvB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,aAAa,CAAC,CAoCxB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAuE9B;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,gBAAgB,EAClC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC,CA8B1B;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,eAAe,GAAG,IAAI,CAmBxB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAkE/F"}