commandmate 0.2.4 → 0.2.5

package/dist/cli/commands/docs.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Docs Command
+ * Issue #264: Documentation retrieval (RAG-like usage for AI tools)
+ *
+ * [MF-CONS-001] Uses createDocsCommand() factory + addCommand() pattern,
+ * unified with issue command registration style.
+ *
+ * [SF-003] SRP: This handler only does argument parsing and output formatting.
+ * File I/O and search logic are delegated to DocsReader utility (docs-reader.ts).
+ *
+ * [SF-CONS-005] Uses console.log directly (status command pattern) since this is
+ * an output-only command with no server lifecycle management.
+ *
+ * @module docs-command
+ */
+import { Command } from 'commander';
+/**
+ * Create the docs command.
+ * [MF-CONS-001] Returns a Command instance for program.addCommand().
+ */
+export declare function createDocsCommand(): Command;
+//# sourceMappingURL=docs.d.ts.map

package/dist/cli/commands/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAwE3C"}

package/dist/cli/commands/docs.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * Docs Command
+ * Issue #264: Documentation retrieval (RAG-like usage for AI tools)
+ *
+ * [MF-CONS-001] Uses createDocsCommand() factory + addCommand() pattern,
+ * unified with issue command registration style.
+ *
+ * [SF-003] SRP: This handler only does argument parsing and output formatting.
+ * File I/O and search logic are delegated to DocsReader utility (docs-reader.ts).
+ *
+ * [SF-CONS-005] Uses console.log directly (status command pattern) since this is
+ * an output-only command with no server lifecycle management.
+ *
+ * @module docs-command
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDocsCommand = createDocsCommand;
+const commander_1 = require("commander");
+const types_1 = require("../types");
+const docs_reader_1 = require("../utils/docs-reader");
+/**
+ * Create the docs command.
+ * [MF-CONS-001] Returns a Command instance for program.addCommand().
+ */
+function createDocsCommand() {
+    const docsCommand = new commander_1.Command('docs')
+        .description('Access CommandMate documentation')
+        .option('-s, --section <name>', 'Show specific documentation section')
+        .option('-q, --search <query>', 'Search documentation')
+        .option('-a, --all', 'Show all available section names')
+        .action((options) => {
+        if (options.all) {
+            const sections = (0, docs_reader_1.getAvailableSections)();
+            console.log('Available documentation sections:');
+            console.log('');
+            sections.forEach(s => console.log(`  - ${s}`));
+            console.log('');
+            console.log('Usage: commandmate docs --section <name>');
+            process.exit(types_1.ExitCode.SUCCESS);
+        }
+        if (options.section) {
+            if (!(0, docs_reader_1.isValidSection)(options.section)) {
+                console.error(`Unknown section: ${options.section}`);
+                console.error('');
+                console.error('Available sections:');
+                (0, docs_reader_1.getAvailableSections)().forEach(s => console.error(`  - ${s}`));
+                process.exit(types_1.ExitCode.UNEXPECTED_ERROR);
+            }
+            try {
+                const content = (0, docs_reader_1.readSection)(options.section);
+                console.log(content);
+            }
+            catch (error) {
+                console.error(`Error reading section: ${(0, types_1.getErrorMessage)(error)}`);
+                process.exit(types_1.ExitCode.UNEXPECTED_ERROR);
+            }
+            process.exit(types_1.ExitCode.SUCCESS);
+        }
+        if (options.search) {
+            try {
+                const results = (0, docs_reader_1.searchDocs)(options.search);
+                if (results.length === 0) {
+                    console.log(`No results found for: "${options.search}"`);
+                }
+                else {
+                    console.log(`Search results for: "${options.search}"`);
+                    console.log('');
+                    for (const result of results) {
+                        console.log(`--- ${result.section} ---`);
+                        result.matches.forEach(match => console.log(`  ${match.trim()}`));
+                        console.log('');
+                    }
+                }
+            }
+            catch (error) {
+                console.error(`Search error: ${(0, types_1.getErrorMessage)(error)}`);
+                process.exit(types_1.ExitCode.UNEXPECTED_ERROR);
+            }
+            process.exit(types_1.ExitCode.SUCCESS);
+        }
+        // No option specified: show help
+        const sections = (0, docs_reader_1.getAvailableSections)();
+        console.log('CommandMate Documentation');
+        console.log('');
+        console.log('Available sections:');
+        sections.forEach(s => console.log(`  - ${s}`));
+        console.log('');
+        console.log('Usage:');
+        console.log('  commandmate docs --section <name>   Show specific section');
+        console.log('  commandmate docs --search <query>   Search documentation');
+        console.log('  commandmate docs --all              List all sections');
+        process.exit(types_1.ExitCode.SUCCESS);
+    });
+    return docsCommand;
+}

package/dist/cli/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,WAAW,EAAuB,MAAM,UAAU,CAAC;AA+H5D;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAyIrE"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,WAAW,EAAuB,MAAM,UAAU,CAAC;AAgI5D;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA4IrE"}

package/dist/cli/commands/init.js

@@ -12,6 +12,7 @@ const os_1 = require("os");
 const types_1 = require("../types");
 const logger_1 = require("../utils/logger");
 const preflight_1 = require("../utils/preflight");
+const ai_integration_messages_1 = require("../config/ai-integration-messages");
 const env_setup_1 = require("../utils/env-setup");
 const prompt_1 = require("../utils/prompt");
 const security_logger_1 = require("../utils/security-logger");
@@ -210,6 +211,8 @@ async function initCommand(options) {
             logger.info('  1. Run "commandmate start" to start the server');
         }
         logger.blank();
+        // Issue #264: Display AI tool integration guide
+        console.log(ai_integration_messages_1.AI_INTEGRATION_GUIDE);
         (0, security_logger_1.logSecurityEvent)({
             timestamp: new Date().toISOString(),
             command: 'init',

package/dist/cli/commands/issue.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Issue Command
+ * Issue #264: gh CLI integration for issue management
+ *
+ * [MF-CONS-001] Uses createIssueCommand() factory + addCommand() pattern
+ * because subcommands (create/search/list) require nested Command definition,
+ * which is not possible with the inline program.command().action() pattern
+ * used by init/start/stop/status.
+ *
+ * Security:
+ * - [SEC-MF-001] Input length validation (title: 256, body: 65536)
+ * - [SEC-SF-001] Label sanitization (control/zero-width character removal)
+ * - Command injection prevention: spawnSync with array args (no shell: true)
+ *
+ * @module issue-command
+ */
+import { Command } from 'commander';
+/**
+ * Create the issue command with subcommands.
+ * [MF-CONS-001] Returns a Command instance for program.addCommand().
+ */
+export declare function createIssueCommand(): Command;
+//# sourceMappingURL=issue.d.ts.map

package/dist/cli/commands/issue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/issue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0CpC;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAsG5C"}

package/dist/cli/commands/issue.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * Issue Command
+ * Issue #264: gh CLI integration for issue management
+ *
+ * [MF-CONS-001] Uses createIssueCommand() factory + addCommand() pattern
+ * because subcommands (create/search/list) require nested Command definition,
+ * which is not possible with the inline program.command().action() pattern
+ * used by init/start/stop/status.
+ *
+ * Security:
+ * - [SEC-MF-001] Input length validation (title: 256, body: 65536)
+ * - [SEC-SF-001] Label sanitization (control/zero-width character removal)
+ * - Command injection prevention: spawnSync with array args (no shell: true)
+ *
+ * @module issue-command
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createIssueCommand = createIssueCommand;
+const commander_1 = require("commander");
+const child_process_1 = require("child_process");
+const types_1 = require("../types");
+const input_validators_1 = require("../utils/input-validators");
+/**
+ * gh CLI template name mapping.
+ * Uses front matter `name` values, NOT filenames.
+ * UI URLs use `template=bug_report.md` (filename) for web interface.
+ */
+const TEMPLATE_MAP = {
+    bug: 'Bug Report',
+    feature: 'Feature Request',
+    question: 'Question',
+};
+/**
+ * Check if gh CLI is available.
+ */
+function isGhAvailable() {
+    const result = (0, child_process_1.spawnSync)('gh', ['--version'], {
+        encoding: 'utf-8',
+        timeout: 5000,
+    });
+    return !result.error && result.status === 0;
+}
+/**
+ * Guard: exit with DEPENDENCY_ERROR if gh CLI is not installed.
+ * [DRY] Extracted from repeated checks in create/search/list subcommands.
+ */
+function requireGhCli() {
+    if (!isGhAvailable()) {
+        console.error('Error: gh CLI is not installed. Install it from https://cli.github.com/');
+        process.exit(types_1.ExitCode.DEPENDENCY_ERROR);
+    }
+}
+/**
+ * Create the issue command with subcommands.
+ * [MF-CONS-001] Returns a Command instance for program.addCommand().
+ */
+function createIssueCommand() {
+    const issueCommand = new commander_1.Command('issue')
+        .description('Manage GitHub issues (requires gh CLI)');
+    // Subcommand: create
+    issueCommand
+        .command('create')
+        .description('Create a new GitHub issue')
+        .option('--bug', 'Use bug report template')
+        .option('--feature', 'Use feature request template')
+        .option('--question', 'Use question template')
+        .option('--title <title>', 'Issue title')
+        .option('--body <body>', 'Issue body')
+        .option('--labels <labels>', 'Labels (comma-separated)')
+        .action((options) => {
+        requireGhCli();
+        // [SEC-MF-001] Input length validation
+        if (options.title) {
+            const titleResult = (0, input_validators_1.validateIssueTitle)(options.title);
+            if (!titleResult.valid) {
+                console.error(`Error: ${titleResult.error}`);
+                process.exit(types_1.ExitCode.UNEXPECTED_ERROR);
+            }
+        }
+        if (options.body) {
+            const bodyResult = (0, input_validators_1.validateIssueBody)(options.body);
+            if (!bodyResult.valid) {
+                console.error(`Error: ${bodyResult.error}`);
+                process.exit(types_1.ExitCode.UNEXPECTED_ERROR);
+            }
+        }
+        const args = ['issue', 'create'];
+        // Template selection
+        const templateKey = options.bug ? 'bug' : options.feature ? 'feature' : options.question ? 'question' : null;
+        if (templateKey && TEMPLATE_MAP[templateKey]) {
+            args.push('--template', TEMPLATE_MAP[templateKey]);
+        }
+        if (options.title) {
+            args.push('--title', options.title);
+        }
+        if (options.body) {
+            args.push('--body', options.body);
+        }
+        // [SEC-SF-001] Label sanitization
+        if (options.labels) {
+            const sanitized = options.labels
+                .split(',')
+                .map(l => (0, input_validators_1.sanitizeLabel)(l))
+                .filter(l => l.length > 0)
+                .join(',');
+            if (sanitized) {
+                args.push('--label', sanitized);
+            }
+        }
+        // Execute gh CLI with array args (no shell injection)
+        const result = (0, child_process_1.spawnSync)('gh', args, {
+            stdio: 'inherit',
+            encoding: 'utf-8',
+        });
+        process.exit(result.status ?? types_1.ExitCode.UNEXPECTED_ERROR);
+    });
+    // Subcommand: search
+    issueCommand
+        .command('search <query>')
+        .description('Search GitHub issues')
+        .action((query) => {
+        requireGhCli();
+        const result = (0, child_process_1.spawnSync)('gh', ['issue', 'list', '--search', query], {
+            stdio: 'inherit',
+            encoding: 'utf-8',
+        });
+        process.exit(result.status ?? types_1.ExitCode.UNEXPECTED_ERROR);
+    });
+    // Subcommand: list
+    issueCommand
+        .command('list')
+        .description('List GitHub issues')
+        .action(() => {
+        requireGhCli();
+        const result = (0, child_process_1.spawnSync)('gh', ['issue', 'list'], {
+            stdio: 'inherit',
+            encoding: 'utf-8',
+        });
+        process.exit(result.status ?? types_1.ExitCode.UNEXPECTED_ERROR);
+    });
+    return issueCommand;
+}

package/dist/cli/config/ai-integration-messages.d.ts

@@ -0,0 +1,6 @@
+/**
+ * AI Integration Guide Messages
+ * Issue #264: Display AI tool integration guide after init completion
+ */
+export declare const AI_INTEGRATION_GUIDE = "\n\u001B[1m\u2501\u2501\u2501 AI Tool Integration \u2501\u2501\u2501\u001B[0m\nCommandMate commands can be used from Claude Code or Codex:\n\n  Issue management:\n    commandmate issue create --bug --title \"Title\" --body \"Description\"\n    commandmate issue create --feature --title \"Title\" --body \"Description\"\n    commandmate issue create --question --title \"Question\" --body \"Details\"\n    commandmate issue search \"keyword\"\n    commandmate issue list\n\n  Documentation (RAG):\n    commandmate docs                    # Show all documentation sections\n    commandmate docs --section <name>   # Show specific section\n    commandmate docs --search <query>   # Search documentation\n\n  Tip: Add to your CLAUDE.md or system prompt:\n    \"Use `commandmate --help` to see available commands.\"\n\u001B[1m\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u001B[0m\n";
+//# sourceMappingURL=ai-integration-messages.d.ts.map

package/dist/cli/config/ai-integration-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-integration-messages.d.ts","sourceRoot":"","sources":["../../../src/cli/config/ai-integration-messages.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,oBAAoB,w+BAmBhC,CAAC"}

package/dist/cli/config/ai-integration-messages.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * AI Integration Guide Messages
+ * Issue #264: Display AI tool integration guide after init completion
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AI_INTEGRATION_GUIDE = void 0;
+exports.AI_INTEGRATION_GUIDE = `
+\x1b[1m━━━ AI Tool Integration ━━━\x1b[0m
+CommandMate commands can be used from Claude Code or Codex:
+
+  Issue management:
+    commandmate issue create --bug --title "Title" --body "Description"
+    commandmate issue create --feature --title "Title" --body "Description"
+    commandmate issue create --question --title "Question" --body "Details"
+    commandmate issue search "keyword"
+    commandmate issue list
+
+  Documentation (RAG):
+    commandmate docs                    # Show all documentation sections
+    commandmate docs --section <name>   # Show specific section
+    commandmate docs --search <query>   # Search documentation
+
+  Tip: Add to your CLAUDE.md or system prompt:
+    "Use \`commandmate --help\` to see available commands."
+\x1b[1m━━━━━━━━━━━━━━━━━━━━━━━━━━━\x1b[0m
+`;

package/dist/cli/config/cli-dependencies.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-dependencies.d.ts","sourceRoot":"","sources":["../../../src/cli/config/cli-dependencies.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,eAAe,EAgCzC,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,IAAI,eAAe,EAAE,CAEnD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,eAAe,EAAE,CAE3D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,eAAe,EAAE,CAE3D"}
+{"version":3,"file":"cli-dependencies.d.ts","sourceRoot":"","sources":["../../../src/cli/config/cli-dependencies.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,eAAe,EAsCzC,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,IAAI,eAAe,EAAE,CAEnD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,eAAe,EAAE,CAE3D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,eAAe,EAAE,CAE3D"}

package/dist/cli/config/cli-dependencies.js

@@ -44,6 +44,12 @@ exports.DEPENDENCIES = [
         versionArg: '--version',
         required: false,
     },
+    {
+        name: 'gh CLI',
+        command: 'gh',
+        versionArg: '--version',
+        required: false,
+    },
 ];
 /**
  * Get all dependencies

package/dist/cli/config/security-messages.d.ts

@@ -2,10 +2,12 @@
  * Security Messages
  * Issue #179: Reverse proxy authentication recommendation
  * Shared warning constants for CLI commands (DRY principle)
+ *
+ * [SF-002] GitHub URLs imported from github-links.ts (DRY)
  */
 /**
  * Warning message displayed when CM_BIND=0.0.0.0
  * Used by: init.ts, start.ts, daemon.ts
  */
-export declare const REVERSE_PROXY_WARNING = "\n\u001B[1m\u001B[31mWARNING: Server is exposed to external networks without authentication\u001B[0m\n\nExposing the server without reverse proxy authentication\nis a serious security risk.\n\n\u001B[1mRisks:\u001B[0m\n  File read/write/delete and command execution\n  become accessible to third parties.\n\n\u001B[1mRecommended authentication methods:\u001B[0m\n  - Nginx + Basic Auth\n  - Cloudflare Access\n  - Tailscale\n\nDetails: https://github.com/Kewton/CommandMate/blob/main/docs/security-guide.md\n";
+export declare const REVERSE_PROXY_WARNING: string;
 //# sourceMappingURL=security-messages.d.ts.map

package/dist/cli/config/security-messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"security-messages.d.ts","sourceRoot":"","sources":["../../../src/cli/config/security-messages.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB,igBAgBjC,CAAC"}
+{"version":3,"file":"security-messages.d.ts","sourceRoot":"","sources":["../../../src/cli/config/security-messages.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAgBjC,CAAC"}

package/dist/cli/config/security-messages.js

@@ -3,9 +3,12 @@
  * Security Messages
  * Issue #179: Reverse proxy authentication recommendation
  * Shared warning constants for CLI commands (DRY principle)
+ *
+ * [SF-002] GitHub URLs imported from github-links.ts (DRY)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.REVERSE_PROXY_WARNING = void 0;
+const github_links_1 = require("../../config/github-links");
 /**
  * Warning message displayed when CM_BIND=0.0.0.0
  * Used by: init.ts, start.ts, daemon.ts
@@ -25,5 +28,5 @@ is a serious security risk.
   - Cloudflare Access
   - Tailscale
 
-Details: https://github.com/Kewton/CommandMate/blob/main/docs/security-guide.md
+Details: ${github_links_1.GITHUB_SECURITY_GUIDE_URL}
 `;

package/dist/cli/index.js

@@ -9,6 +9,8 @@ const init_1 = require("./commands/init");
 const start_1 = require("./commands/start");
 const stop_1 = require("./commands/stop");
 const status_1 = require("./commands/status");
+const issue_1 = require("./commands/issue");
+const docs_1 = require("./commands/docs");
 // Read version from package.json
 // eslint-disable-next-line @typescript-eslint/no-require-imports
 const pkg = require('../../package.json');
@@ -37,7 +39,7 @@ program
     .option('--dev', 'Start in development mode')
     .option('--daemon', 'Run in background')
     .option('-p, --port <number>', 'Override port number', parseInt)
-    .option('-i, --issue <number>', 'Start worktree server for specific issue', parseInt)
+    .option('-i, --issue <number>', 'Start server for specific issue worktree', parseInt)
     .option('--auto-port', 'Automatically allocate port for worktree server')
     .action(async (options) => {
     await (0, start_1.startCommand)({
@@ -54,7 +56,7 @@ program
     .command('stop')
     .description('Stop the CommandMate server')
     .option('-f, --force', 'Force stop (SIGKILL)')
-    .option('-i, --issue <number>', 'Stop worktree server for specific issue', parseInt)
+    .option('-i, --issue <number>', 'Stop server for specific issue worktree', parseInt)
     .action(async (options) => {
     await (0, stop_1.stopCommand)({
         force: options.force,
@@ -74,5 +76,16 @@ program
         all: options.all,
     });
 });
+// Issue #264: issue/docs commands (addCommand pattern for subcommand support)
+program.addCommand((0, issue_1.createIssueCommand)());
+program.addCommand((0, docs_1.createDocsCommand)());
+// Issue #264: AI Tool Integration help section
+program.addHelpText('after', `
+AI Tool Integration:
+  Use with Claude Code or Codex to manage issues:
+    commandmate issue create --bug --title "Title" --body "Description"
+    commandmate issue create --question --title "How to..." --body "Details"
+    commandmate docs --section quick-start
+`);
 // Parse and execute
 program.parse();

package/dist/cli/types/index.d.ts

@@ -158,6 +158,29 @@ export interface ConfirmOptions {
     /** Default value if user presses Enter (true = Y, false = N) */
     default?: boolean;
 }
+/**
+ * Options for issue create subcommand
+ * Issue #264: gh CLI integration
+ * [MF-001 YAGNI] IssueOptions interface is NOT defined.
+ * Only IssueCreateOptions and DocsOptions are added.
+ */
+export interface IssueCreateOptions {
+    bug?: boolean;
+    feature?: boolean;
+    question?: boolean;
+    title?: string;
+    body?: string;
+    labels?: string;
+}
+/**
+ * Options for docs command
+ * Issue #264: Documentation retrieval
+ */
+export interface DocsOptions {
+    section?: string;
+    search?: string;
+    all?: boolean;
+}
 /**
  * Extract error message from unknown error
  * Issue #125: DRY - centralized error message extraction

package/dist/cli/types/index.d.ts.map

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

package/dist/cli/utils/docs-reader.d.ts

@@ -0,0 +1,42 @@
+/**
+ * DocsReader Utility
+ * Issue #264: Documentation retrieval for docs command
+ *
+ * [SF-003] SRP: Separated from docs command handler.
+ * This utility manages section mapping, path resolution, file reading, and search logic.
+ * The command handler (docs.ts) only handles argument parsing and output formatting.
+ *
+ * Security:
+ * - [SEC-SF-002] Search query length limit (MAX_SEARCH_QUERY_LENGTH = 256)
+ * - Path traversal prevention via SECTION_MAP whitelist
+ * - [SF-004] package.json anchor-based path resolution
+ *
+ * @module docs-reader
+ */
+/**
+ * Get list of available documentation section names.
+ */
+export declare function getAvailableSections(): string[];
+/**
+ * Check if a section name is valid (exists in the whitelist).
+ */
+export declare function isValidSection(section: string): boolean;
+/**
+ * Read the content of a documentation section.
+ *
+ * @param section - Section name (must be in SECTION_MAP whitelist)
+ * @throws Error if section is invalid or file cannot be read
+ */
+export declare function readSection(section: string): string;
+/**
+ * Search documentation for a query string.
+ * Uses String.prototype.includes() for case-insensitive matching (no regex).
+ *
+ * @param query - Search query (max 256 characters)
+ * @throws Error if query exceeds MAX_SEARCH_QUERY_LENGTH
+ */
+export declare function searchDocs(query: string): Array<{
+    section: string;
+    matches: string[];
+}>;
+//# sourceMappingURL=docs-reader.d.ts.map

package/dist/cli/utils/docs-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-reader.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/docs-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAkDH;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOnD;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA0BvF"}