@vfarcic/dot-ai 0.174.0 → 0.175.0

package/dist/core/user-prompts-loader.d.ts

@@ -0,0 +1,66 @@
+/**
+ * User Prompts Loader
+ *
+ * Loads user-defined prompts from a git repository.
+ * Supports any git provider (GitHub, GitLab, Gitea, Forgejo, Bitbucket, etc.)
+ *
+ * Environment variables:
+ * - DOT_AI_USER_PROMPTS_REPO: Git repository URL (required to enable)
+ * - DOT_AI_USER_PROMPTS_BRANCH: Branch to use (default: main)
+ * - DOT_AI_USER_PROMPTS_PATH: Subdirectory within repo (default: root)
+ * - DOT_AI_GIT_TOKEN: Authentication token (optional)
+ * - DOT_AI_USER_PROMPTS_CACHE_TTL: Cache TTL in seconds (default: 86400 = 24h)
+ */
+import { Logger } from './error-handling';
+import { Prompt } from '../tools/prompts';
+/**
+ * Configuration for user prompts repository
+ */
+export interface UserPromptsConfig {
+    repoUrl: string;
+    branch: string;
+    subPath: string;
+    gitToken?: string;
+    cacheTtlSeconds: number;
+}
+/**
+ * Cache state for tracking repository freshness
+ */
+interface CacheState {
+    lastPullTime: number;
+    localPath: string;
+}
+/**
+ * Read user prompts configuration from environment variables
+ * Returns null if DOT_AI_USER_PROMPTS_REPO is not set
+ */
+export declare function getUserPromptsConfig(): UserPromptsConfig | null;
+/**
+ * Get the cache directory for user prompts
+ * Tries project-relative tmp first, falls back to system temp
+ */
+export declare function getCacheDirectory(): string;
+/**
+ * Insert authentication token into git URL
+ * Works with any HTTPS git URL (GitHub, GitLab, Gitea, Bitbucket, etc.)
+ */
+export declare function insertTokenInUrl(url: string, token: string): string;
+/**
+ * Sanitize URL for logging (remove credentials)
+ */
+export declare function sanitizeUrlForLogging(url: string): string;
+/**
+ * Load user prompts from the configured git repository
+ * Returns empty array if not configured or on error
+ */
+export declare function loadUserPrompts(logger: Logger, forceRefresh?: boolean): Promise<Prompt[]>;
+/**
+ * Clear the cache state (useful for testing)
+ */
+export declare function clearUserPromptsCache(): void;
+/**
+ * Get current cache state (for testing/debugging)
+ */
+export declare function getUserPromptsCacheState(): CacheState | null;
+export {};
+//# sourceMappingURL=user-prompts-loader.d.ts.map

package/dist/core/user-prompts-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-prompts-loader.d.ts","sourceRoot":"","sources":["../../src/core/user-prompts-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,OAAO,EAAE,MAAM,EAAkB,MAAM,kBAAkB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,UAAU,UAAU;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAKD;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,GAAG,IAAI,CAkB/D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAqB1C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CASnE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUzD;AAmJD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,OAAe,GAC5B,OAAO,CAAC,MAAM,EAAE,CAAC,CAmDnB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,UAAU,GAAG,IAAI,CAE5D"}

package/dist/core/user-prompts-loader.js

@@ -0,0 +1,319 @@
+"use strict";
+/**
+ * User Prompts Loader
+ *
+ * Loads user-defined prompts from a git repository.
+ * Supports any git provider (GitHub, GitLab, Gitea, Forgejo, Bitbucket, etc.)
+ *
+ * Environment variables:
+ * - DOT_AI_USER_PROMPTS_REPO: Git repository URL (required to enable)
+ * - DOT_AI_USER_PROMPTS_BRANCH: Branch to use (default: main)
+ * - DOT_AI_USER_PROMPTS_PATH: Subdirectory within repo (default: root)
+ * - DOT_AI_GIT_TOKEN: Authentication token (optional)
+ * - DOT_AI_USER_PROMPTS_CACHE_TTL: Cache TTL in seconds (default: 86400 = 24h)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUserPromptsConfig = getUserPromptsConfig;
+exports.getCacheDirectory = getCacheDirectory;
+exports.insertTokenInUrl = insertTokenInUrl;
+exports.sanitizeUrlForLogging = sanitizeUrlForLogging;
+exports.loadUserPrompts = loadUserPrompts;
+exports.clearUserPromptsCache = clearUserPromptsCache;
+exports.getUserPromptsCacheState = getUserPromptsCacheState;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const platform_utils_1 = require("./platform-utils");
+const prompts_1 = require("../tools/prompts");
+// In-memory cache state (persists across requests within same process)
+let cacheState = null;
+/**
+ * Read user prompts configuration from environment variables
+ * Returns null if DOT_AI_USER_PROMPTS_REPO is not set
+ */
+function getUserPromptsConfig() {
+    const repoUrl = process.env.DOT_AI_USER_PROMPTS_REPO;
+    if (!repoUrl) {
+        return null;
+    }
+    // Validate cache TTL - fallback to default if invalid or negative
+    const parsedTtl = parseInt(process.env.DOT_AI_USER_PROMPTS_CACHE_TTL || '86400', 10);
+    const cacheTtlSeconds = Number.isNaN(parsedTtl) || parsedTtl < 0 ? 86400 : parsedTtl;
+    return {
+        repoUrl,
+        branch: process.env.DOT_AI_USER_PROMPTS_BRANCH || 'main',
+        subPath: process.env.DOT_AI_USER_PROMPTS_PATH || '',
+        gitToken: process.env.DOT_AI_GIT_TOKEN,
+        cacheTtlSeconds,
+    };
+}
+/**
+ * Get the cache directory for user prompts
+ * Tries project-relative tmp first, falls back to system temp
+ */
+function getCacheDirectory() {
+    // Try project-relative tmp directory first
+    const projectTmp = path.join(process.cwd(), 'tmp', 'user-prompts');
+    try {
+        // Ensure parent tmp directory exists
+        const parentTmp = path.join(process.cwd(), 'tmp');
+        if (!fs.existsSync(parentTmp)) {
+            fs.mkdirSync(parentTmp, { recursive: true });
+        }
+        // Test if we can write to it
+        const testFile = path.join(parentTmp, '.write-test');
+        fs.writeFileSync(testFile, 'test');
+        fs.unlinkSync(testFile);
+        return projectTmp;
+    }
+    catch {
+        // Fall back to system temp (works in Docker/K8s)
+        return path.join(os.tmpdir(), 'dot-ai-user-prompts');
+    }
+}
+/**
+ * Insert authentication token into git URL
+ * Works with any HTTPS git URL (GitHub, GitLab, Gitea, Bitbucket, etc.)
+ */
+function insertTokenInUrl(url, token) {
+    try {
+        const parsed = new URL(url);
+        parsed.username = token;
+        return parsed.toString();
+    }
+    catch {
+        // If URL parsing fails, return original
+        return url;
+    }
+}
+/**
+ * Sanitize URL for logging (remove credentials)
+ */
+function sanitizeUrlForLogging(url) {
+    try {
+        const parsed = new URL(url);
+        if (parsed.username)
+            parsed.username = '***';
+        if (parsed.password)
+            parsed.password = '***';
+        return parsed.toString();
+    }
+    catch {
+        // If URL parsing fails, do basic sanitization
+        return url.replace(/\/\/[^@]+@/, '//***@');
+    }
+}
+/**
+ * Validate git branch name to prevent command injection
+ * Allows alphanumeric characters, hyphens, underscores, slashes, and dots
+ */
+function isValidGitBranch(branch) {
+    return /^[a-zA-Z0-9_.\-/]+$/.test(branch);
+}
+/**
+ * Clone the user prompts repository
+ */
+async function cloneRepository(config, localPath, logger) {
+    // Validate branch name to prevent command injection
+    if (!isValidGitBranch(config.branch)) {
+        throw new Error(`Invalid branch name: ${config.branch}`);
+    }
+    const authUrl = config.gitToken
+        ? insertTokenInUrl(config.repoUrl, config.gitToken)
+        : config.repoUrl;
+    const sanitizedUrl = sanitizeUrlForLogging(config.repoUrl);
+    logger.info('Cloning user prompts repository', {
+        url: sanitizedUrl,
+        branch: config.branch,
+        localPath,
+    });
+    try {
+        // Ensure parent directory exists
+        const parentDir = path.dirname(localPath);
+        if (!fs.existsSync(parentDir)) {
+            fs.mkdirSync(parentDir, { recursive: true });
+        }
+        // Remove existing directory if it exists (clean clone)
+        if (fs.existsSync(localPath)) {
+            fs.rmSync(localPath, { recursive: true, force: true });
+        }
+        // Clone with shallow depth for faster operation
+        const cloneCommand = `git clone --depth 1 --branch ${config.branch} "${authUrl}" "${localPath}"`;
+        await (0, platform_utils_1.execAsync)(cloneCommand);
+        logger.info('Successfully cloned user prompts repository', {
+            url: sanitizedUrl,
+            branch: config.branch,
+        });
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        // Sanitize error message in case it contains the token
+        const sanitizedError = config.gitToken
+            ? errorMessage.replaceAll(config.gitToken, '***')
+            : errorMessage;
+        logger.error('Failed to clone user prompts repository', new Error(sanitizedError), {
+            url: sanitizedUrl,
+            branch: config.branch,
+        });
+        throw new Error(`Failed to clone user prompts repository: ${sanitizedError}`);
+    }
+}
+/**
+ * Pull latest changes from the user prompts repository
+ */
+async function pullRepository(config, localPath, logger) {
+    const sanitizedUrl = sanitizeUrlForLogging(config.repoUrl);
+    logger.debug('Pulling user prompts repository', {
+        url: sanitizedUrl,
+        localPath,
+    });
+    try {
+        // Set up credentials for pull if token is provided
+        if (config.gitToken) {
+            const authUrl = insertTokenInUrl(config.repoUrl, config.gitToken);
+            await (0, platform_utils_1.execAsync)(`git -C "${localPath}" remote set-url origin "${authUrl}"`);
+        }
+        await (0, platform_utils_1.execAsync)(`git -C "${localPath}" pull --ff-only`);
+        logger.debug('Successfully pulled user prompts repository', {
+            url: sanitizedUrl,
+        });
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        const sanitizedError = config.gitToken
+            ? errorMessage.replaceAll(config.gitToken, '***')
+            : errorMessage;
+        logger.warn('Failed to pull user prompts repository, using cached version', {
+            url: sanitizedUrl,
+            error: sanitizedError,
+        });
+        // Don't throw - use cached version
+    }
+}
+/**
+ * Ensure the repository is cloned and up-to-date
+ * Returns the path to the prompts directory within the repository
+ */
+async function ensureRepository(config, logger, forceRefresh = false) {
+    const localPath = getCacheDirectory();
+    const now = Date.now();
+    const ttlMs = config.cacheTtlSeconds * 1000;
+    // Check if we need to clone or pull
+    if (!cacheState || !fs.existsSync(cacheState.localPath)) {
+        // First time or cache directory was deleted - clone
+        await cloneRepository(config, localPath, logger);
+        cacheState = { lastPullTime: now, localPath };
+    }
+    else if (forceRefresh || now - cacheState.lastPullTime >= ttlMs) {
+        // Cache expired or force refresh - pull
+        await pullRepository(config, localPath, logger);
+        cacheState.lastPullTime = now;
+    }
+    else {
+        logger.debug('Using cached user prompts repository', {
+            localPath,
+            cacheAge: Math.round((now - cacheState.lastPullTime) / 1000),
+            ttl: config.cacheTtlSeconds,
+        });
+    }
+    // Return path to prompts directory (with optional subPath)
+    return config.subPath
+        ? path.join(localPath, config.subPath)
+        : localPath;
+}
+/**
+ * Load user prompts from the configured git repository
+ * Returns empty array if not configured or on error
+ */
+async function loadUserPrompts(logger, forceRefresh = false) {
+    const config = getUserPromptsConfig();
+    if (!config) {
+        logger.debug('User prompts not configured (DOT_AI_USER_PROMPTS_REPO not set)');
+        return [];
+    }
+    try {
+        const promptsDir = await ensureRepository(config, logger, forceRefresh);
+        if (!fs.existsSync(promptsDir)) {
+            logger.warn('User prompts directory not found in repository', {
+                path: promptsDir,
+                subPath: config.subPath,
+            });
+            return [];
+        }
+        // Load all .md files from the prompts directory
+        const files = fs.readdirSync(promptsDir);
+        const promptFiles = files.filter(file => file.endsWith('.md'));
+        const prompts = [];
+        for (const file of promptFiles) {
+            try {
+                const filePath = path.join(promptsDir, file);
+                const prompt = (0, prompts_1.loadPromptFile)(filePath, 'user');
+                prompts.push(prompt);
+                logger.debug('Loaded user prompt', { name: prompt.name, file });
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                logger.warn('Failed to load user prompt file, skipping', {
+                    file,
+                    error: errorMessage,
+                });
+                // Continue with other prompts
+            }
+        }
+        logger.info('Loaded user prompts from repository', {
+            total: prompts.length,
+            url: sanitizeUrlForLogging(config.repoUrl),
+        });
+        return prompts;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error('Failed to load user prompts, falling back to built-in only', new Error(errorMessage));
+        return [];
+    }
+}
+/**
+ * Clear the cache state (useful for testing)
+ */
+function clearUserPromptsCache() {
+    cacheState = null;
+}
+/**
+ * Get current cache state (for testing/debugging)
+ */
+function getUserPromptsCacheState() {
+    return cacheState ? { ...cacheState } : null;
+}

package/dist/interfaces/rest-api.d.ts

@@ -101,6 +101,14 @@ export declare class RestApiRouter {
      * Handle resource sync requests from controller
      */
     private handleResourceSyncRequest;
+    /**
+     * Handle prompts list requests
+     */
+    private handlePromptsListRequest;
+    /**
+     * Handle prompt get requests
+     */
+    private handlePromptsGetRequest;
     /**
      * Set CORS headers
      */

package/dist/interfaces/rest-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rest-api.d.ts","sourceRoot":"","sources":["../../src/interfaces/rest-api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAGtC;;GAEG;AACH,oBAAY,UAAU;IACpB,EAAE,MAAM;IACR,WAAW,MAAM;IACjB,SAAS,MAAM;IACf,kBAAkB,MAAM;IACxB,qBAAqB,MAAM;IAC3B,mBAAmB,MAAM;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,GAAG,CAAC;KACf,CAAC;IACF,IAAI,CAAC,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,IAAI,CAAC,EAAE;QACL,MAAM,EAAE,GAAG,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,IAAI,CAAC,EAAE;QACL,KAAK,EAAE,QAAQ,EAAE,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,cAAc,CAAa;gBAGjC,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM;IAoBrC;;OAEG;IACG,aAAa,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAyFzF;;OAEG;IACH,OAAO,CAAC,YAAY;IAyCpB;;OAEG;YACW,mBAAmB;IA2CjC;;OAEG;YACW,mBAAmB;IAgGjC;;OAEG;YACW,iBAAiB;IA8B/B;;OAEG;YACW,yBAAyB;IAgEvC;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;YACW,gBAAgB;IAK9B;;OAEG;YACW,iBAAiB;IAyB/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIvC;;OAEG;IACH,SAAS,IAAI,aAAa;CAG3B"}
+{"version":3,"file":"rest-api.d.ts","sourceRoot":"","sources":["../../src/interfaces/rest-api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAItC;;GAEG;AACH,oBAAY,UAAU;IACpB,EAAE,MAAM;IACR,WAAW,MAAM;IACjB,SAAS,MAAM;IACf,kBAAkB,MAAM;IACxB,qBAAqB,MAAM;IAC3B,mBAAmB,MAAM;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,GAAG,CAAC;KACf,CAAC;IACF,IAAI,CAAC,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,IAAI,CAAC,EAAE;QACL,MAAM,EAAE,GAAG,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,IAAI,CAAC,EAAE;QACL,KAAK,EAAE,QAAQ,EAAE,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,cAAc,CAAa;gBAGjC,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM;IAoBrC;;OAEG;IACG,aAAa,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IA2GzF;;OAEG;IACH,OAAO,CAAC,YAAY;IAuDpB;;OAEG;YACW,mBAAmB;IA2CjC;;OAEG;YACW,mBAAmB;IAgGjC;;OAEG;YACW,iBAAiB;IA8B/B;;OAEG;YACW,yBAAyB;IAgEvC;;OAEG;YACW,wBAAwB;IA0CtC;;OAEG;YACW,uBAAuB;IAsDrC;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;YACW,gBAAgB;IAK9B;;OAEG;YACW,iBAAiB;IAyB/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIvC;;OAEG;IACH,SAAS,IAAI,aAAa;CAG3B"}

package/dist/interfaces/rest-api.js

@@ -10,6 +10,7 @@ exports.RestApiRouter = exports.HttpStatus = void 0;
 const node_url_1 = require("node:url");
 const openapi_generator_1 = require("./openapi-generator");
 const resource_sync_handler_1 = require("./resource-sync-handler");
+const prompts_1 = require("../tools/prompts");
 /**
  * HTTP status codes for REST responses
  */
@@ -118,6 +119,25 @@ class RestApiRouter {
                         await this.sendErrorResponse(res, requestId, HttpStatus.NOT_FOUND, 'NOT_FOUND', 'Unknown resources endpoint');
                     }
                     break;
+                case 'prompts':
+                    if (req.method === 'GET') {
+                        await this.handlePromptsListRequest(req, res, requestId);
+                    }
+                    else {
+                        await this.sendErrorResponse(res, requestId, HttpStatus.METHOD_NOT_ALLOWED, 'METHOD_NOT_ALLOWED', 'Only GET method allowed for prompts list');
+                    }
+                    break;
+                case 'prompt':
+                    if (req.method === 'POST' && pathMatch.promptName) {
+                        await this.handlePromptsGetRequest(req, res, requestId, pathMatch.promptName, body);
+                    }
+                    else if (req.method !== 'POST') {
+                        await this.sendErrorResponse(res, requestId, HttpStatus.METHOD_NOT_ALLOWED, 'METHOD_NOT_ALLOWED', 'Only POST method allowed for prompt get');
+                    }
+                    else {
+                        await this.sendErrorResponse(res, requestId, HttpStatus.BAD_REQUEST, 'BAD_REQUEST', 'Prompt name is required');
+                    }
+                    break;
                 default:
                     await this.sendErrorResponse(res, requestId, HttpStatus.NOT_FOUND, 'NOT_FOUND', 'Unknown API endpoint');
             }
@@ -139,6 +159,8 @@ class RestApiRouter {
         // /api/v1/tools/{toolName} -> tool execution
         // /api/v1/openapi -> OpenAPI spec
         // /api/v1/resources/sync -> resource sync from controller
+        // /api/v1/prompts -> prompts list
+        // /api/v1/prompts/{promptName} -> prompt get
         const basePath = `${this.config.basePath}/${this.config.version}`;
         if (!pathname.startsWith(basePath)) {
             return null;
@@ -162,6 +184,16 @@ class RestApiRouter {
         if (cleanPath === 'resources/sync') {
             return { endpoint: 'resources', action: 'sync' };
         }
+        // Handle prompts endpoints
+        if (cleanPath === 'prompts') {
+            return { endpoint: 'prompts' };
+        }
+        if (cleanPath.startsWith('prompts/')) {
+            const promptName = cleanPath.substring(8); // Remove 'prompts/'
+            if (promptName) {
+                return { endpoint: 'prompt', promptName };
+            }
+        }
         return null;
     }
     /**
@@ -347,6 +379,69 @@ class RestApiRouter {
             await this.sendErrorResponse(res, requestId, HttpStatus.INTERNAL_SERVER_ERROR, 'SYNC_ERROR', 'Resource sync failed', { error: errorMessage });
         }
     }
+    /**
+     * Handle prompts list requests
+     */
+    async handlePromptsListRequest(req, res, requestId) {
+        try {
+            this.logger.info('Processing prompts list request', { requestId });
+            const result = await (0, prompts_1.handlePromptsListRequest)({}, this.logger, requestId);
+            const response = {
+                success: true,
+                data: result,
+                meta: {
+                    timestamp: new Date().toISOString(),
+                    requestId,
+                    version: this.config.version
+                }
+            };
+            await this.sendJsonResponse(res, HttpStatus.OK, response);
+            this.logger.info('Prompts list request completed', {
+                requestId,
+                promptCount: result.prompts?.length || 0
+            });
+        }
+        catch (error) {
+            this.logger.error('Prompts list request failed', error instanceof Error ? error : new Error(String(error)), {
+                requestId
+            });
+            await this.sendErrorResponse(res, requestId, HttpStatus.INTERNAL_SERVER_ERROR, 'PROMPTS_LIST_ERROR', 'Failed to list prompts');
+        }
+    }
+    /**
+     * Handle prompt get requests
+     */
+    async handlePromptsGetRequest(req, res, requestId, promptName, body) {
+        try {
+            this.logger.info('Processing prompt get request', { requestId, promptName });
+            const result = await (0, prompts_1.handlePromptsGetRequest)({ name: promptName, arguments: body?.arguments }, this.logger, requestId);
+            const response = {
+                success: true,
+                data: result,
+                meta: {
+                    timestamp: new Date().toISOString(),
+                    requestId,
+                    version: this.config.version
+                }
+            };
+            await this.sendJsonResponse(res, HttpStatus.OK, response);
+            this.logger.info('Prompt get request completed', {
+                requestId,
+                promptName
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error('Prompt get request failed', error instanceof Error ? error : new Error(String(error)), {
+                requestId,
+                promptName
+            });
+            // Check if it's a validation error (missing required arguments or prompt not found)
+            const isValidationError = errorMessage.includes('Missing required arguments') ||
+                errorMessage.includes('Prompt not found');
+            await this.sendErrorResponse(res, requestId, isValidationError ? HttpStatus.BAD_REQUEST : HttpStatus.INTERNAL_SERVER_ERROR, isValidationError ? 'VALIDATION_ERROR' : 'PROMPT_GET_ERROR', errorMessage);
+        }
+    }
     /**
      * Set CORS headers
      */

package/dist/tools/prompts.d.ts

@@ -2,24 +2,42 @@
  * MCP Prompts Handler - Manages shared prompt library
  */
 import { Logger } from '../core/error-handling';
+export interface PromptArgument {
+    name: string;
+    description?: string;
+    required?: boolean;
+}
 export interface PromptMetadata {
     name: string;
     description: string;
     category: string;
+    arguments?: PromptArgument[];
 }
 export interface Prompt {
     name: string;
     description: string;
     content: string;
+    arguments?: PromptArgument[];
+    source: 'built-in' | 'user';
 }
 /**
  * Loads and parses a prompt file with YAML frontmatter
  */
-export declare function loadPromptFile(filePath: string): Prompt;
+export declare function loadPromptFile(filePath: string, source?: 'built-in' | 'user'): Prompt;
+/**
+ * Loads built-in prompts from the shared-prompts directory
+ */
+export declare function loadBuiltInPrompts(logger: Logger, baseDir?: string): Prompt[];
+/**
+ * Merge built-in and user prompts with collision detection
+ * Built-in prompts take precedence over user prompts with the same name
+ */
+export declare function mergePrompts(builtInPrompts: Prompt[], userPrompts: Prompt[], logger: Logger): Prompt[];
 /**
- * Loads all prompts from the shared-prompts directory
+ * Loads all prompts (built-in + user) with collision detection
+ * This is the main entry point for loading prompts
  */
-export declare function loadAllPrompts(logger: Logger, baseDir?: string): Prompt[];
+export declare function loadAllPrompts(logger: Logger, baseDir?: string, forceRefresh?: boolean): Promise<Prompt[]>;
 /**
  * Handle prompts/list MCP request
  */

package/dist/tools/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/tools/prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAOhD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA4CvD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAoCzE;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,CAsCd;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,CAoEd"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/tools/prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAOhD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC;CAC7B;AA8ED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,UAAU,GAAG,MAAmB,GAAG,MAAM,CAmCjG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAoC7E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,cAAc,EAAE,MAAM,EAAE,EACxB,WAAW,EAAE,MAAM,EAAE,EACrB,MAAM,EAAE,MAAM,GACb,MAAM,EAAE,CAgBV;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,EAChB,YAAY,GAAE,OAAe,GAC5B,OAAO,CAAC,MAAM,EAAE,CAAC,CA0BnB;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,CA4Cd;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,CAiGd"}

package/dist/tools/prompts.js

@@ -37,16 +37,90 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadPromptFile = loadPromptFile;
+exports.loadBuiltInPrompts = loadBuiltInPrompts;
+exports.mergePrompts = mergePrompts;
 exports.loadAllPrompts = loadAllPrompts;
 exports.handlePromptsListRequest = handlePromptsListRequest;
 exports.handlePromptsGetRequest = handlePromptsGetRequest;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const error_handling_1 = require("../core/error-handling");
+/**
+ * Parses YAML frontmatter with support for nested arguments array
+ */
+function parseYamlFrontmatter(yaml) {
+    const metadata = {};
+    const lines = yaml.split('\n');
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        // Check for arguments array start
+        if (line.match(/^arguments:\s*$/)) {
+            const args = [];
+            i++;
+            // Parse array items (lines starting with "  - ")
+            while (i < lines.length && lines[i].match(/^\s+-\s/)) {
+                const arg = { name: '' };
+                // First line of array item: "  - name: value"
+                const firstLineMatch = lines[i].match(/^\s+-\s+(\w+):\s*(.*)$/);
+                if (firstLineMatch) {
+                    const [, key, value] = firstLineMatch;
+                    if (key === 'name') {
+                        arg.name = value.trim().replace(/^["']|["']$/g, '');
+                    }
+                    else if (key === 'description') {
+                        arg.description = value.trim().replace(/^["']|["']$/g, '');
+                    }
+                    else if (key === 'required') {
+                        arg.required = value.trim().toLowerCase() === 'true';
+                    }
+                }
+                i++;
+                // Continue parsing properties of this array item (lines starting with "    ")
+                while (i < lines.length && lines[i].match(/^\s{4,}\w+:/)) {
+                    const propMatch = lines[i].match(/^\s+(\w+):\s*(.*)$/);
+                    if (propMatch) {
+                        const [, key, value] = propMatch;
+                        if (key === 'name') {
+                            arg.name = value.trim().replace(/^["']|["']$/g, '');
+                        }
+                        else if (key === 'description') {
+                            arg.description = value.trim().replace(/^["']|["']$/g, '');
+                        }
+                        else if (key === 'required') {
+                            arg.required = value.trim().toLowerCase() === 'true';
+                        }
+                    }
+                    i++;
+                }
+                if (arg.name) {
+                    args.push(arg);
+                }
+            }
+            if (args.length > 0) {
+                metadata.arguments = args;
+            }
+        }
+        else {
+            // Simple key-value pair
+            const match = line.match(/^([^:]+):\s*(.+)$/);
+            if (match) {
+                const [, key, value] = match;
+                const cleanValue = value.trim().replace(/^["']|["']$/g, '');
+                const trimmedKey = key.trim();
+                if (trimmedKey !== 'arguments') {
+                    metadata[trimmedKey] = cleanValue;
+                }
+            }
+            i++;
+        }
+    }
+    return metadata;
+}
 /**
  * Loads and parses a prompt file with YAML frontmatter
  */
-function loadPromptFile(filePath) {
+function loadPromptFile(filePath, source = 'built-in') {
     try {
         const content = fs.readFileSync(filePath, 'utf8');
         // Parse YAML frontmatter
@@ -55,18 +129,8 @@ function loadPromptFile(filePath) {
             throw new Error(`Invalid prompt file format: missing YAML frontmatter in ${filePath}`);
         }
         const [, frontmatterYaml, promptContent] = frontmatterMatch;
-        // Simple YAML parsing for our specific format
-        const metadata = {};
-        const lines = frontmatterYaml.split('\n');
-        for (const line of lines) {
-            const match = line.match(/^([^:]+):\s*(.+)$/);
-            if (match) {
-                const [, key, value] = match;
-                // Remove quotes if present
-                const cleanValue = value.trim().replace(/^["']|["']$/g, '');
-                metadata[key.trim()] = cleanValue;
-            }
-        }
+        // Parse YAML with support for arguments array
+        const metadata = parseYamlFrontmatter(frontmatterYaml);
         if (!metadata.name || !metadata.description || !metadata.category) {
             throw new Error(`Missing required metadata in ${filePath}: name, description, category`);
         }
@@ -74,6 +138,8 @@ function loadPromptFile(filePath) {
             name: metadata.name,
             description: metadata.description,
             content: promptContent.trim(),
+            arguments: metadata.arguments,
+            source,
         };
     }
     catch (error) {
@@ -81,9 +147,9 @@ function loadPromptFile(filePath) {
     }
 }
 /**
- * Loads all prompts from the shared-prompts directory
+ * Loads built-in prompts from the shared-prompts directory
  */
-function loadAllPrompts(logger, baseDir) {
+function loadBuiltInPrompts(logger, baseDir) {
     try {
         const promptsDir = baseDir ?? path.join(__dirname, '..', '..', 'shared-prompts');
         if (!fs.existsSync(promptsDir)) {
@@ -96,15 +162,15 @@ function loadAllPrompts(logger, baseDir) {
         for (const file of promptFiles) {
             try {
                 const filePath = path.join(promptsDir, file);
-                const prompt = loadPromptFile(filePath);
+                const prompt = loadPromptFile(filePath, 'built-in');
                 prompts.push(prompt);
-                logger.debug('Loaded prompt', { name: prompt.name, file });
+                logger.debug('Loaded built-in prompt', { name: prompt.name, file });
             }
             catch (error) {
                 logger.error(`Failed to load prompt file ${file}`, error);
             }
         }
-        logger.info('Loaded prompts from shared library', {
+        logger.info('Loaded built-in prompts from shared library', {
             total: prompts.length,
             promptsDir,
         });
@@ -115,18 +181,71 @@ function loadAllPrompts(logger, baseDir) {
         return [];
     }
 }
+/**
+ * Merge built-in and user prompts with collision detection
+ * Built-in prompts take precedence over user prompts with the same name
+ */
+function mergePrompts(builtInPrompts, userPrompts, logger) {
+    const builtInNames = new Set(builtInPrompts.map(p => p.name));
+    const merged = [...builtInPrompts];
+    for (const userPrompt of userPrompts) {
+        if (builtInNames.has(userPrompt.name)) {
+            logger.warn('User prompt name collision with built-in prompt, skipping user prompt', {
+                name: userPrompt.name,
+                message: 'Built-in prompt takes precedence',
+            });
+            continue;
+        }
+        merged.push(userPrompt);
+    }
+    return merged;
+}
+/**
+ * Loads all prompts (built-in + user) with collision detection
+ * This is the main entry point for loading prompts
+ */
+async function loadAllPrompts(logger, baseDir, forceRefresh = false) {
+    // Load built-in prompts (synchronous)
+    const builtInPrompts = loadBuiltInPrompts(logger, baseDir);
+    // Load user prompts from git repository (async, graceful failure)
+    let userPrompts = [];
+    try {
+        const { loadUserPrompts } = await Promise.resolve().then(() => __importStar(require('../core/user-prompts-loader.js')));
+        userPrompts = await loadUserPrompts(logger, forceRefresh);
+    }
+    catch (error) {
+        logger.debug('User prompts loader not available or failed', {
+            error: error instanceof Error ? error.message : 'Unknown error',
+        });
+    }
+    // Merge with collision detection
+    const allPrompts = mergePrompts(builtInPrompts, userPrompts, logger);
+    logger.info('Loaded all prompts', {
+        builtIn: builtInPrompts.length,
+        user: userPrompts.length,
+        total: allPrompts.length,
+        collisions: builtInPrompts.length + userPrompts.length - allPrompts.length,
+    });
+    return allPrompts;
+}
 /**
  * Handle prompts/list MCP request
  */
 async function handlePromptsListRequest(args, logger, requestId) {
     try {
         logger.info('Processing prompts/list request', { requestId });
-        const prompts = loadAllPrompts(logger, process.env.NODE_ENV === 'test' ? args?.baseDir : undefined);
-        // Convert to MCP prompts/list response format
-        const promptList = prompts.map(prompt => ({
-            name: prompt.name,
-            description: prompt.description,
-        }));
+        const prompts = await loadAllPrompts(logger, process.env.NODE_ENV === 'test' ? args?.baseDir : undefined);
+        // Convert to MCP prompts/list response format (include arguments if present)
+        const promptList = prompts.map(prompt => {
+            const item = {
+                name: prompt.name,
+                description: prompt.description,
+            };
+            if (prompt.arguments && prompt.arguments.length > 0) {
+                item.arguments = prompt.arguments;
+            }
+            return item;
+        });
         logger.info('Prompts list generated', {
             requestId,
             promptCount: promptList.length,
@@ -157,7 +276,7 @@ async function handlePromptsGetRequest(args, logger, requestId) {
         if (!args.name) {
             throw new Error('Missing required parameter: name');
         }
-        const prompts = loadAllPrompts(logger, process.env.NODE_ENV === 'test' ? args?.baseDir : undefined);
+        const prompts = await loadAllPrompts(logger, process.env.NODE_ENV === 'test' ? args?.baseDir : undefined);
         const prompt = prompts.find(p => p.name === args.name);
         if (!prompt) {
             throw error_handling_1.ErrorHandler.createError(error_handling_1.ErrorCategory.VALIDATION, error_handling_1.ErrorSeverity.MEDIUM, `Prompt not found: ${args.name}`, {
@@ -166,9 +285,30 @@ async function handlePromptsGetRequest(args, logger, requestId) {
                 requestId,
             });
         }
+        // Validate required arguments if prompt has arguments defined
+        const providedArgs = args.arguments || {};
+        if (prompt.arguments && prompt.arguments.length > 0) {
+            const missingRequired = prompt.arguments
+                .filter(arg => arg.required && !providedArgs[arg.name])
+                .map(arg => arg.name);
+            if (missingRequired.length > 0) {
+                throw error_handling_1.ErrorHandler.createError(error_handling_1.ErrorCategory.VALIDATION, error_handling_1.ErrorSeverity.MEDIUM, `Missing required arguments: ${missingRequired.join(', ')}`, {
+                    operation: 'prompts_get',
+                    component: 'PromptsHandler',
+                    requestId,
+                    input: { promptName: prompt.name, missingArguments: missingRequired },
+                });
+            }
+        }
+        // Substitute {{argumentName}} placeholders in content
+        let processedContent = prompt.content;
+        for (const [argName, argValue] of Object.entries(providedArgs)) {
+            processedContent = processedContent.replaceAll(`{{${argName}}}`, String(argValue));
+        }
         logger.info('Prompt found and returned', {
             requestId,
             promptName: prompt.name,
+            argumentsProvided: Object.keys(providedArgs).length,
         });
         // Convert to MCP prompts/get response format
         return {
@@ -178,7 +318,7 @@ async function handlePromptsGetRequest(args, logger, requestId) {
                     role: 'user',
                     content: {
                         type: 'text',
-                        text: prompt.content,
+                        text: processedContent,
                     },
                 },
             ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vfarcic/dot-ai",
-  "version": "0.174.0",
+  "version": "0.175.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-start.md

@@ -2,6 +2,10 @@
 name: prd-start
 description: Start working on a PRD implementation
 category: project-management
+arguments:
+  - name: prdNumber
+    description: PRD number to start working on (e.g., 306)
+    required: false
 ---
 
 # PRD Start - Begin Implementation Work
@@ -20,9 +24,19 @@ You are helping initiate active implementation work on a specific Product Requir
 4. **Identify Starting Point** - Determine the best first implementation task
 5. **Begin Implementation** - Launch into actual development work
 
-## Step 0: Context Awareness Check
+## Step 0: Check for PRD Argument
 
-**FIRST: Check if PRD context is already clear from recent conversation:**
+**If `prdNumber` argument is provided ({{prdNumber}}):**
+- Skip Step 0 context check and Step 1 auto-detection
+- Use PRD #{{prdNumber}} directly
+- Proceed to Step 2 (PRD Readiness Validation)
+
+**If `prdNumber` argument is NOT provided:**
+- Continue to context awareness check below
+
+## Step 0b: Context Awareness Check
+
+**Check if PRD context is already clear from recent conversation:**
 
 **Skip detection/analysis if recent conversation shows:**
 - **Recent PRD work discussed** - "We just worked on PRD 29", "Just completed PRD update", etc.
@@ -31,7 +45,7 @@ You are helping initiate active implementation work on a specific Product Requir
 - **Clear work context** - Discussion of specific features, tasks, or requirements for a known PRD
 
 **If context is clear:**
-- Skip to Step 2 (PRD Readiness Validation) using the known PRD 
+- Skip to Step 2 (PRD Readiness Validation) using the known PRD
 - Use conversation history to understand current state and recent progress
 - Proceed directly with readiness validation based on known PRD status