@laitszkin/apollo-toolkit 3.13.2 → 3.14.0

package/dist/lib/tools/create-specs.js

@@ -0,0 +1,175 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSpecsHandler = createSpecsHandler;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const TEMPLATE_FILENAMES = [
+    'spec.md',
+    'tasks.md',
+    'checklist.md',
+    'contract.md',
+    'design.md',
+];
+const COORDINATION_TEMPLATE = 'coordination.md';
+const PREPARATION_TEMPLATE = 'preparation.md';
+const PLACEHOLDER_NAMES = ['[Feature Name]', '[功能名稱]'];
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .trim()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+function renderContent(content, today, featureName, changeName, batchName) {
+    let rendered = content.replace(/\[YYYY-MM-DD\]/g, today);
+    for (const placeholder of PLACEHOLDER_NAMES) {
+        const escaped = placeholder.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        rendered = rendered.replace(new RegExp(escaped, 'g'), featureName);
+    }
+    rendered = rendered.replace(/\[change_name\]/g, changeName);
+    rendered = rendered.replace(/\[batch_name\]/g, batchName || 'None');
+    return rendered;
+}
+async function createSpecsHandler(args, context) {
+    const stderr = context.stderr || process.stderr;
+    // Parse CLI args manually for portability (no argparse dependency)
+    const parsed = {};
+    const positionalArgs = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg.startsWith('--')) {
+            const eqIndex = arg.indexOf('=');
+            let key;
+            let value;
+            if (eqIndex !== -1) {
+                key = arg.slice(2, eqIndex);
+                value = arg.slice(eqIndex + 1);
+            }
+            else {
+                key = arg.slice(2);
+                const next = args[i + 1];
+                if (next !== undefined && !next.startsWith('--')) {
+                    value = next;
+                    i++;
+                }
+                else {
+                    value = true;
+                }
+            }
+            if (key === 'force' || key === 'with-coordination' || key === 'with-preparation') {
+                parsed[key] = value === true || value === 'true';
+            }
+            else if (key === 'change-name' || key === 'slug') {
+                parsed['change-name'] = String(value);
+            }
+            else if (key === 'batch-name') {
+                parsed['batch-name'] = String(value);
+            }
+            else if (key === 'output-dir') {
+                parsed['output-dir'] = String(value);
+            }
+            else if (key === 'template-dir') {
+                parsed['template-dir'] = String(value);
+            }
+            else if (key === 'help' || key === 'h') {
+                parsed['help'] = true;
+            }
+        }
+        else {
+            positionalArgs.push(arg);
+        }
+    }
+    if (parsed['help']) {
+        const stdout = context.stdout || process.stdout;
+        stdout.write(`Usage: apltk create-specs <feature_name> [options]
+
+Options:
+  --change-name, --slug   Folder name (defaults to slugified feature_name)
+  --batch-name            Optional batch folder name
+  --with-coordination     Create coordination.md (requires --batch-name)
+  --with-preparation      Create preparation.md (requires --batch-name)
+  --output-dir            Output base directory (default: docs/plans)
+  --template-dir          Template directory
+  --force                 Overwrite existing files
+`);
+        return 0;
+    }
+    const featureName = (positionalArgs[0] || '').trim();
+    if (!featureName) {
+        stderr.write('Error: feature_name is required.\n');
+        return 1;
+    }
+    const changeName = parsed['change-name']?.trim() || slugify(featureName);
+    if (!changeName) {
+        stderr.write('Error: Unable to build change_name. Provide --change-name with ASCII letters/numbers.\n');
+        return 1;
+    }
+    const batchName = parsed['batch-name']?.trim() || null;
+    if (parsed['with-coordination'] && !batchName) {
+        stderr.write('Error: --with-coordination requires --batch-name.\n');
+        return 1;
+    }
+    if (parsed['with-preparation'] && !batchName) {
+        stderr.write('Error: --with-preparation requires --batch-name.\n');
+        return 1;
+    }
+    // Resolve template directory
+    const sourceRoot = context.sourceRoot || node_path_1.default.resolve(__dirname, '..', '..', '..');
+    const templateDirRaw = parsed['template-dir'] || node_path_1.default.join(sourceRoot, 'generate-spec', 'references', 'templates');
+    const templateDir = node_path_1.default.resolve(templateDirRaw);
+    if (!node_fs_1.default.existsSync(templateDir)) {
+        stderr.write(`Error: Template directory not found: ${templateDir}\n`);
+        return 1;
+    }
+    // Check template files exist
+    const missingTemplates = TEMPLATE_FILENAMES.filter((name) => !node_fs_1.default.existsSync(node_path_1.default.join(templateDir, name)));
+    if (parsed['with-coordination'] && !node_fs_1.default.existsSync(node_path_1.default.join(templateDir, COORDINATION_TEMPLATE))) {
+        missingTemplates.push(COORDINATION_TEMPLATE);
+    }
+    if (parsed['with-preparation'] && !node_fs_1.default.existsSync(node_path_1.default.join(templateDir, PREPARATION_TEMPLATE))) {
+        missingTemplates.push(PREPARATION_TEMPLATE);
+    }
+    if (missingTemplates.length > 0) {
+        stderr.write(`Error: Missing template files in ${templateDir}: ${missingTemplates.join(', ')}\n`);
+        return 1;
+    }
+    const outputDir = node_path_1.default.resolve(parsed['output-dir'] || 'docs/plans');
+    const today = new Date().toISOString().slice(0, 10);
+    const dateRoot = node_path_1.default.join(outputDir, today);
+    const batchRoot = batchName ? node_path_1.default.join(dateRoot, batchName) : null;
+    const outputRoot = batchRoot ? node_path_1.default.join(batchRoot, changeName) : node_path_1.default.join(dateRoot, changeName);
+    const outputPaths = TEMPLATE_FILENAMES.map((name) => node_path_1.default.join(outputRoot, name));
+    const coordinationPath = (parsed['with-coordination'] && batchRoot) ? node_path_1.default.join(batchRoot, COORDINATION_TEMPLATE) : null;
+    const preparationPath = (parsed['with-preparation'] && batchRoot) ? node_path_1.default.join(batchRoot, PREPARATION_TEMPLATE) : null;
+    const force = parsed['force'] === true;
+    const existingFiles = outputPaths.filter((p) => node_fs_1.default.existsSync(p));
+    if (existingFiles.length > 0 && !force) {
+        stderr.write(`Error: Files already exist: ${existingFiles.join(', ')}. Use --force to overwrite.\n`);
+        return 1;
+    }
+    node_fs_1.default.mkdirSync(outputRoot, { recursive: true });
+    const stdout = context.stdout || process.stdout;
+    const todayStr = today;
+    for (const filename of TEMPLATE_FILENAMES) {
+        const templatePath = node_path_1.default.join(templateDir, filename);
+        const outputPath = node_path_1.default.join(outputRoot, filename);
+        const content = node_fs_1.default.readFileSync(templatePath, 'utf-8');
+        node_fs_1.default.writeFileSync(outputPath, renderContent(content, todayStr, featureName, changeName, batchName), 'utf-8');
+        stdout.write(`${outputPath}\n`);
+    }
+    if (coordinationPath && (force || !node_fs_1.default.existsSync(coordinationPath))) {
+        const templateContent = node_fs_1.default.readFileSync(node_path_1.default.join(templateDir, COORDINATION_TEMPLATE), 'utf-8');
+        node_fs_1.default.writeFileSync(coordinationPath, renderContent(templateContent, todayStr, featureName, changeName, batchName), 'utf-8');
+        stdout.write(`${coordinationPath}\n`);
+    }
+    if (preparationPath && (force || !node_fs_1.default.existsSync(preparationPath))) {
+        const templateContent = node_fs_1.default.readFileSync(node_path_1.default.join(templateDir, PREPARATION_TEMPLATE), 'utf-8');
+        node_fs_1.default.writeFileSync(preparationPath, renderContent(templateContent, todayStr, featureName, changeName, batchName), 'utf-8');
+        stdout.write(`${preparationPath}\n`);
+    }
+    return 0;
+}

package/dist/lib/tools/docs-to-voice.d.ts

@@ -0,0 +1,2 @@
+import type { ToolContext } from '../types';
+export declare function docsToVoiceHandler(args: string[], context: ToolContext): Promise<number>;