specforge-mcp 0.1.0

package/dist/tools/suggest-tooling/llm-security-catalog.js

@@ -0,0 +1,83 @@
+// tools/suggest-tooling/llm-security-catalog.ts — SPEC-045
+// Builds LLM guardrails and MLOps tooling recommendation lines for suggest_tooling.
+import { readFile } from 'node:fs/promises';
+import { generateMlopsToolingLines } from '../../engine/llm-security/index.js';
+let configCache = null;
+/** Reset in-memory cache (for testing). */
+export function resetLlmSecurityCatalogCache() {
+    configCache = null;
+}
+async function loadConfig() {
+    if (configCache) {
+        return configCache;
+    }
+    try {
+        const configPath = new URL('../../config/llm-guardrails-tooling.json', import.meta.url);
+        const content = await readFile(configPath, 'utf-8');
+        const raw = JSON.parse(content);
+        delete raw._description;
+        delete raw._regulation_date;
+        configCache = raw;
+        return configCache;
+    }
+    catch {
+        return {
+            highRiskDomains: {},
+            unacceptableRiskKeywords: [],
+            guardrailTools: { python: [], node: [], enterprise: [] },
+            mlopsTools: { start: [], scale: [], enterprise: [], llmops: [] },
+        };
+    }
+}
+function formatToolEntry(tool, required) {
+    const requiredTag = required ? ' **(required)**' : '';
+    return [`**${tool.name}**${requiredTag} — ${tool.description}`, `- Docs: ${tool.docsUrl}`, ''];
+}
+/**
+ * Build LLM guardrails and MLOps tooling recommendation lines.
+ * Only emits when llmDetection is present and isLlmProject is true.
+ */
+export async function buildLlmSecurityToolingLines(knowledge) {
+    const detection = knowledge.llmDetection;
+    if (!detection?.isLlmProject) {
+        return [];
+    }
+    const config = await loadConfig();
+    const lang = knowledge.language.toLowerCase();
+    const isNodeProject = lang === 'typescript' || lang === 'javascript';
+    const isPythonProject = lang === 'python';
+    const lines = ['', '## LLM Security & Guardrails', ''];
+    lines.push(`**Provider detectado:** ${detection.provider ?? 'unknown'}`);
+    lines.push(`**Framework:** ${detection.framework}`);
+    if (detection.hasRAG) {
+        lines.push(`**RAG:** detectado${detection.vectorStore ? ` (${detection.vectorStore})` : ''}`);
+    }
+    if (detection.hasToolUse) {
+        lines.push('**Tool Use:** detectado — guardrails **requeridos** para proyectos con tool use');
+    }
+    lines.push('');
+    // Guardrails section
+    lines.push('### Guardrails Recomendados', '');
+    const toolRequired = detection.hasToolUse;
+    if (isPythonProject) {
+        for (const tool of config.guardrailTools.python) {
+            lines.push(...formatToolEntry(tool, toolRequired && tool.name === 'LLM Guard'));
+        }
+    }
+    if (isNodeProject) {
+        for (const tool of config.guardrailTools.node) {
+            lines.push(...formatToolEntry(tool, toolRequired));
+        }
+    }
+    // Enterprise guardrails always shown
+    for (const tool of config.guardrailTools.enterprise) {
+        lines.push(...formatToolEntry(tool, false));
+    }
+    // MLOps section
+    const mlopsLines = generateMlopsToolingLines(detection);
+    if (mlopsLines.length > 0) {
+        lines.push(...mlopsLines);
+    }
+    return lines;
+}
+//# sourceMappingURL=llm-security-catalog.js.map

package/dist/tools/suggest-tooling/llm-security-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-security-catalog.js","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/llm-security-catalog.ts"],"names":[],"mappings":"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"}

package/dist/tools/suggest-tooling/local-first-catalog.d.ts

@@ -0,0 +1,9 @@
+import type { ProjectKnowledge } from '../../types/index.js';
+/** Reset in-memory config cache (for testing). */
+export declare function resetLocalFirstCatalogCache(): void;
+/**
+ * Build local-first tooling recommendation lines.
+ * Only emits when localFirst detection is present and isLocalFirst is true.
+ */
+export declare function buildLocalFirstToolingLines(knowledge: ProjectKnowledge): Promise<string[]>;
+//# sourceMappingURL=local-first-catalog.d.ts.map

package/dist/tools/suggest-tooling/local-first-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-first-catalog.d.ts","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/local-first-catalog.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,gBAAgB,EAGjB,MAAM,sBAAsB,CAAC;AAI9B,kDAAkD;AAClD,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AA+CD;;;GAGG;AACH,wBAAsB,2BAA2B,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA2DhG"}

package/dist/tools/suggest-tooling/local-first-catalog.js

@@ -0,0 +1,103 @@
+// tools/suggest-tooling/local-first-catalog.ts — SPEC-047
+// Builds local-first CRDT, storage, and sync tooling recommendation lines for suggest_tooling.
+import { readFile } from 'node:fs/promises';
+let configCache = null;
+/** Reset in-memory config cache (for testing). */
+export function resetLocalFirstCatalogCache() {
+    configCache = null;
+}
+async function loadConfig() {
+    if (configCache) {
+        return configCache;
+    }
+    try {
+        const configPath = new URL('../../config/local-first-tools.json', import.meta.url);
+        const content = await readFile(configPath, 'utf-8');
+        configCache = JSON.parse(content);
+        return configCache;
+    }
+    catch {
+        return { crdtLibraries: [], storageEngines: [], syncBackends: [] };
+    }
+}
+function formatToolEntry(tool) {
+    const lines = [];
+    lines.push(`**${tool.name}** — ${tool.description ?? tool.name}`);
+    /* v8 ignore next 3 */
+    if (tool.docsUrl) {
+        lines.push(`- Docs: ${tool.docsUrl}`);
+    }
+    /* v8 ignore next 3 */
+    if (tool.status === 'beta') {
+        lines.push('- _Status: beta — evaluate stability for production use_');
+    }
+    lines.push('');
+    return lines;
+}
+function getPlatformTag(framework, stack) {
+    const stackLower = stack.map((s) => s.toLowerCase()).join(' ');
+    const fw = (framework ?? '').toLowerCase();
+    if (fw.includes('react-native') || fw.includes('expo') || stackLower.includes('react-native')) {
+        return 'react-native';
+    }
+    if (fw.includes('flutter') || stackLower.includes('flutter')) {
+        return 'flutter';
+    }
+    if (fw.includes('tauri') || fw.includes('electron') || stackLower.includes('desktop')) {
+        return 'node';
+    }
+    return 'browser';
+}
+/**
+ * Build local-first tooling recommendation lines.
+ * Only emits when localFirst detection is present and isLocalFirst is true.
+ */
+export async function buildLocalFirstToolingLines(knowledge) {
+    const detection = knowledge.localFirst;
+    if (!detection?.isLocalFirst) {
+        return [];
+    }
+    const config = await loadConfig();
+    const platform = getPlatformTag(knowledge.framework, knowledge.stack);
+    const lines = ['', '## Local-First Architecture', ''];
+    // Detected signals summary
+    if (detection.localFirstSignals.length > 0) {
+        lines.push('**Signals detected:**');
+        for (const signal of detection.localFirstSignals) {
+            lines.push(`- ${signal}`);
+        }
+        lines.push('');
+    }
+    // CRDT Libraries section
+    const crdtTools = config.crdtLibraries.filter((t) => t.platforms.includes(platform) || t.platforms.includes('node'));
+    if (crdtTools.length > 0) {
+        lines.push('### CRDT Libraries', '');
+        for (const tool of crdtTools) {
+            lines.push(...formatToolEntry(tool));
+        }
+    }
+    // Storage Engines section
+    const storageTools = config.storageEngines.filter((t) => t.platforms.includes(platform));
+    if (storageTools.length > 0) {
+        lines.push('### Local Storage Engines', '');
+        for (const tool of storageTools) {
+            lines.push(...formatToolEntry(tool));
+        }
+    }
+    // Sync Backends section
+    const syncTools = config.syncBackends.filter((t) => t.platforms.includes(platform));
+    if (syncTools.length > 0) {
+        lines.push('### Sync Backends', '');
+        for (const tool of syncTools) {
+            lines.push(...formatToolEntry(tool));
+        }
+    }
+    // Anti-patterns warning
+    lines.push('### Anti-patterns to Avoid', '');
+    lines.push('- **Polling HTTP** — use WebSocket/SSE instead of `setInterval(() => fetch(...))`');
+    lines.push('- **Full-state sync** — send only diff/operations, not the complete document');
+    lines.push('- **Silent last-write-wins** — expose conflicts to users when data loss is unacceptable');
+    lines.push('');
+    return lines;
+}
+//# sourceMappingURL=local-first-catalog.js.map

package/dist/tools/suggest-tooling/local-first-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-first-catalog.js","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/local-first-catalog.ts"],"names":[],"mappings":"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"}

package/dist/tools/suggest-tooling/observability-catalog.d.ts

@@ -0,0 +1,21 @@
+import type { MonitoringDetection, AlertSpec, ProjectKnowledge } from '../../types/index.js';
+/**
+ * Builds observability tooling recommendation lines based on detected monitoring stack.
+ * For existing projects: shows what is already configured.
+ * For new/incomplete projects: recommends what to add.
+ */
+export declare function buildObservabilityToolingLines(knowledge: ProjectKnowledge, monitoring: MonitoringDetection): string[];
+/**
+ * Generates alert specifications for new features.
+ * Returns standard alerts suitable for a production feature.
+ */
+export declare function generateAlertSpecs(specId?: string): AlertSpec[];
+/**
+ * Builds alert spec output lines for suggest_tooling.
+ */
+export declare function buildAlertSpecLines(specId?: string): string[];
+/**
+ * Returns the observability phase block for PLAN.md.
+ */
+export declare function buildObservabilityPhaseLines(): string[];
+//# sourceMappingURL=observability-catalog.d.ts.map

package/dist/tools/suggest-tooling/observability-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-catalog.d.ts","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/observability-catalog.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AA4C7F;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,gBAAgB,EAC3B,UAAU,EAAE,mBAAmB,GAC9B,MAAM,EAAE,CAmDV;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAK/D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAsB7D;AAID;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,EAAE,CAoBvD"}

package/dist/tools/suggest-tooling/observability-catalog.js

@@ -0,0 +1,228 @@
+// tools/suggest-tooling/observability-catalog.ts — Observability tooling recommendations (SPEC-026a)
+// Generates observability-specific tooling recommendations based on detected stack.
+// === Alert spec templates (base specs without specId) ===
+const ALERT_TEMPLATES = [
+    {
+        name: 'High Error Rate',
+        condition: 'error_rate > 1% for 5 minutes',
+        severity: 'critical',
+        notifyTeam: 'on-call',
+        runbook: 'https://docs.internal/runbooks/high-error-rate',
+    },
+    {
+        name: 'Slow Response Time',
+        condition: 'p99_latency_ms > 2000 for 5 minutes',
+        severity: 'warning',
+        notifyTeam: 'backend-team',
+        runbook: 'https://docs.internal/runbooks/slow-response',
+    },
+    {
+        name: 'Low Success Rate',
+        condition: 'success_rate < 99% for 10 minutes',
+        severity: 'warning',
+        notifyTeam: 'backend-team',
+        runbook: 'https://docs.internal/runbooks/low-success-rate',
+    },
+    {
+        name: 'Service Down',
+        condition: 'up == 0 for 1 minute',
+        severity: 'critical',
+        notifyTeam: 'on-call',
+        runbook: 'https://docs.internal/runbooks/service-down',
+    },
+    {
+        name: 'High Memory Usage',
+        condition: 'memory_usage_percent > 90% for 5 minutes',
+        severity: 'warning',
+        notifyTeam: 'infrastructure',
+        runbook: 'https://docs.internal/runbooks/high-memory',
+    },
+];
+// === Observability tooling recommendation lines ===
+/**
+ * Builds observability tooling recommendation lines based on detected monitoring stack.
+ * For existing projects: shows what is already configured.
+ * For new/incomplete projects: recommends what to add.
+ */
+export function buildObservabilityToolingLines(knowledge, monitoring) {
+    const { detected } = monitoring;
+    const allDetected = [
+        ...detected.metrics,
+        ...detected.tracing,
+        ...detected.logging,
+        ...detected.errorTracking,
+        ...detected.alerting,
+    ];
+    const lines = ['## Observability Stack', ''];
+    if (allDetected.length > 0) {
+        lines.push('**Detected observability tools:**');
+        lines.push('');
+        if (detected.errorTracking.length > 0) {
+            lines.push(`- **Error Tracking:** ${detected.errorTracking.join(', ')}`);
+        }
+        if (detected.metrics.length > 0) {
+            lines.push(`- **Metrics:** ${detected.metrics.join(', ')}`);
+        }
+        if (detected.tracing.length > 0) {
+            lines.push(`- **Tracing:** ${detected.tracing.join(', ')}`);
+        }
+        if (detected.logging.length > 0) {
+            lines.push(`- **Logging:** ${detected.logging.join(', ')}`);
+        }
+        if (detected.alerting.length > 0) {
+            lines.push(`- **Alerting:** ${detected.alerting.join(', ')}`);
+        }
+        lines.push('');
+    }
+    else {
+        lines.push('**No observability tools detected.** Recommendations for your stack:');
+        lines.push('');
+        lines.push(...buildRecommendationLines(knowledge));
+    }
+    // Gaps
+    const gaps = detectObservabilityGaps(detected);
+    if (gaps.length > 0) {
+        lines.push('### Observability Gaps');
+        lines.push('');
+        for (const gap of gaps) {
+            lines.push(`- [${gap.severity.toUpperCase()}] ${gap.description}`);
+        }
+        lines.push('');
+    }
+    return lines;
+}
+/**
+ * Generates alert specifications for new features.
+ * Returns standard alerts suitable for a production feature.
+ */
+export function generateAlertSpecs(specId) {
+    return ALERT_TEMPLATES.map((template) => ({
+        ...template,
+        specId,
+    }));
+}
+/**
+ * Builds alert spec output lines for suggest_tooling.
+ */
+export function buildAlertSpecLines(specId) {
+    const alerts = generateAlertSpecs(specId);
+    const lines = ['## Recommended Alert Specifications', ''];
+    if (specId) {
+        lines.push(`For feature **${specId}**, configure the following alerts:`);
+    }
+    else {
+        lines.push('Standard production alerts to configure:');
+    }
+    lines.push('');
+    for (const alert of alerts) {
+        lines.push(`### ${alert.name}`);
+        lines.push(`- **Condition:** \`${alert.condition}\``);
+        lines.push(`- **Severity:** ${alert.severity}`);
+        lines.push(`- **Notify:** ${alert.notifyTeam}`);
+        lines.push(`- **Runbook:** ${alert.runbook}`);
+        lines.push('');
+    }
+    return lines;
+}
+// === Observability phase for execution plan ===
+/**
+ * Returns the observability phase block for PLAN.md.
+ */
+export function buildObservabilityPhaseLines() {
+    return [
+        '## Phase: Observability (Required for Production Features)',
+        '',
+        '### Steps',
+        '1. **Implement metrics** — add counters for critical operations, histograms for latencies, gauges for states',
+        '2. **Implement structured logs** — include fields: timestamp, trace_id, spec_id, level, message',
+        '3. **Implement traces** — add spans for operations crossing service boundaries',
+        '4. **Configure alerts** — set up conditions, severities, runbooks (see Alert Specs above)',
+        '5. **Verify in staging** — confirm metrics/logs/traces are flowing before production deploy',
+        '',
+        '### DoD for this phase',
+        '- [ ] All critical operations have counters',
+        '- [ ] Latency histograms configured for slow operations',
+        '- [ ] Structured logging with mandatory fields',
+        '- [ ] Distributed traces for cross-service calls',
+        '- [ ] At least 1 critical alert configured',
+        '- [ ] Runbook exists for each critical alert',
+        '',
+    ];
+}
+// === Internal helpers ===
+function detectObservabilityGaps(detected) {
+    const gaps = [];
+    if (detected.errorTracking.length === 0) {
+        gaps.push({
+            severity: 'critical',
+            description: 'No error tracking configured. Add Sentry, Bugsnag, or Rollbar.',
+        });
+    }
+    if (detected.metrics.length === 0) {
+        gaps.push({
+            severity: 'warning',
+            description: 'No metrics configured. Add Prometheus/Grafana or Datadog.',
+        });
+    }
+    if (detected.tracing.length === 0) {
+        gaps.push({
+            severity: 'warning',
+            description: 'No distributed tracing configured. Add OpenTelemetry or Jaeger.',
+        });
+    }
+    if (detected.logging.length === 0) {
+        gaps.push({
+            severity: 'warning',
+            description: 'No structured logging library detected. Add Pino, Winston, or structured stdout.',
+        });
+    }
+    if (detected.alerting.length === 0) {
+        gaps.push({
+            severity: 'warning',
+            description: 'No alerting configured. Set up Prometheus AlertManager or Datadog monitors.',
+        });
+    }
+    return gaps;
+}
+function buildRecommendationLines(knowledge) {
+    const lines = [];
+    const fw = (knowledge.framework ?? '').toLowerCase();
+    const lang = knowledge.language.toLowerCase();
+    // Error tracking — always recommend Sentry first
+    lines.push('#### 1. Error Tracking (Critical)');
+    lines.push('**Recommended:** Sentry');
+    if (fw.includes('next') || fw.includes('react')) {
+        lines.push('**Install:** `npm install @sentry/nextjs` — run `npx @sentry/wizard@latest -i nextjs`');
+    }
+    else if (lang === 'python') {
+        lines.push('**Install:** `pip install sentry-sdk` — call `sentry_sdk.init(dsn="...")` in entry point');
+    }
+    else {
+        lines.push('**Install:** `npm install @sentry/node` — call `Sentry.init({ dsn })` in entry point');
+    }
+    lines.push('');
+    // Metrics
+    lines.push('#### 2. Metrics (Recommended)');
+    if (lang === 'python') {
+        lines.push('**Recommended:** Prometheus + Grafana via `prometheus_client`');
+        lines.push('**Install:** `pip install prometheus-client`');
+    }
+    else {
+        lines.push('**Recommended:** OpenTelemetry (vendor-neutral)');
+        lines.push('**Install:** `npm install @opentelemetry/sdk-node @opentelemetry/auto-instrumentations-node`');
+    }
+    lines.push('');
+    // Logging
+    lines.push('#### 3. Structured Logging (Recommended)');
+    if (lang === 'typescript' || lang === 'javascript') {
+        lines.push('**Recommended:** Pino (fastest structured logger for Node.js)');
+        lines.push('**Install:** `npm install pino` — outputs JSON by default');
+    }
+    else if (lang === 'python') {
+        lines.push('**Recommended:** structlog');
+        lines.push('**Install:** `pip install structlog`');
+    }
+    lines.push('');
+    return lines;
+}
+//# sourceMappingURL=observability-catalog.js.map

package/dist/tools/suggest-tooling/observability-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-catalog.js","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/observability-catalog.ts"],"names":[],"mappings":"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"}

package/dist/tools/suggest-tooling/orchestration-generator.d.ts

@@ -0,0 +1,12 @@
+import type { GenerateOrchestrationScriptInput } from '../../types/index.js';
+/**
+ * Generates a parallel orchestration bash script that:
+ * 1. Validates working tree is clean
+ * 2. Creates one git worktree per spec
+ * 3. Launches `env -u CLAUDECODE claude -p` per spec in parallel (macOS bash 3.2 compatible)
+ * 4. Waits for all processes to complete
+ * 5. Reports pass/fail per spec
+ * 6. Provides cleanup instructions for successful worktrees
+ */
+export declare function generateOrchestrationScript(input: GenerateOrchestrationScriptInput): string;
+//# sourceMappingURL=orchestration-generator.d.ts.map

package/dist/tools/suggest-tooling/orchestration-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration-generator.d.ts","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/orchestration-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AAM7E;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,gCAAgC,GAAG,MAAM,CA8C3F"}

package/dist/tools/suggest-tooling/orchestration-generator.js

@@ -0,0 +1,106 @@
+// tools/suggest-tooling/orchestration-generator.ts — SPEC-022 TD: 3-layer orchestration script generator
+// Generates a parallel automation bash script: validate → worktrees → parallel claude -p → wait → report → cleanup
+const DEFAULT_MAIN_BRANCH = 'main';
+const DEFAULT_BASE_BRANCH = 'develop';
+const WORKTREE_BASE = '.claude/worktrees';
+/**
+ * Generates a parallel orchestration bash script that:
+ * 1. Validates working tree is clean
+ * 2. Creates one git worktree per spec
+ * 3. Launches `env -u CLAUDECODE claude -p` per spec in parallel (macOS bash 3.2 compatible)
+ * 4. Waits for all processes to complete
+ * 5. Reports pass/fail per spec
+ * 6. Provides cleanup instructions for successful worktrees
+ */
+export function generateOrchestrationScript(input) {
+    const { specIds, projectPath, mainBranch, baseBranch } = input;
+    const main = mainBranch ?? DEFAULT_MAIN_BRANCH;
+    const base = baseBranch ?? DEFAULT_BASE_BRANCH;
+    const worktreeSetupLines = buildWorktreeSetup(specIds, base);
+    const launchLines = buildParallelLaunch(specIds, projectPath);
+    const waitLines = buildWaitAndReport(specIds);
+    const cleanupLines = buildCleanupInstructions(specIds);
+    return [
+        '#!/usr/bin/env bash',
+        '# 3-Layer Parallel Automation Script',
+        '# Generated by SpecForge — SPEC-022 orchestration-generator',
+        `# Main branch: ${main} | Base branch: ${base}`,
+        '# Layer 1: Skills (per-agent Claude Code workflows)',
+        '# Layer 2: Sub-agents (scoped delegated tasks)',
+        '# Layer 3: Orchestration (this script — parallel worktrees + claude -p)',
+        '',
+        'set -euo pipefail',
+        '',
+        `PROJECT_PATH="${projectPath}"`,
+        `WORKTREE_BASE="${WORKTREE_BASE}"`,
+        `BASE_BRANCH="${base}"`,
+        '',
+        '# ── Step 1: Validate working tree is clean ──────────────────────────────',
+        'echo "[orchestrate] Checking working tree..."',
+        'if ! git -C "$PROJECT_PATH" diff --quiet || ! git -C "$PROJECT_PATH" diff --cached --quiet; then',
+        '  echo "[ERROR] Working tree has uncommitted changes. Commit or stash before running." >&2',
+        '  exit 1',
+        'fi',
+        'echo "[orchestrate] Working tree is clean."',
+        '',
+        '# ── Step 2: Create worktrees ─────────────────────────────────────────────',
+        ...worktreeSetupLines,
+        '',
+        '# ── Step 3: Launch parallel claude -p instances ──────────────────────────',
+        'declare -A PIDS',
+        ...launchLines,
+        '',
+        '# ── Step 4: Wait and report ──────────────────────────────────────────────',
+        ...waitLines,
+        '',
+        '# ── Step 5: Cleanup instructions ─────────────────────────────────────────',
+        ...cleanupLines,
+    ].join('\n');
+}
+function buildWorktreeSetup(specIds, baseBranch) {
+    const lines = [];
+    for (const specId of specIds) {
+        const slug = specId.toLowerCase().replace(/[^a-z0-9-]/g, '-');
+        const worktreePath = `$WORKTREE_BASE/${slug}`;
+        const branchName = `feat/${specId}`;
+        lines.push(`echo "[orchestrate] Creating worktree for ${specId}..."`, `git -C "$PROJECT_PATH" worktree add "${worktreePath}" -b "${branchName}" "${baseBranch}" 2>/dev/null || \\`, `  git -C "$PROJECT_PATH" worktree add "${worktreePath}" "${branchName}"`);
+    }
+    return lines;
+}
+function buildParallelLaunch(specIds, projectPath) {
+    const lines = [];
+    for (const specId of specIds) {
+        const slug = specId.toLowerCase().replace(/[^a-z0-9-]/g, '-');
+        const worktreePath = `${projectPath}/${WORKTREE_BASE}/${slug}`;
+        const logFile = `/tmp/specforge-${slug}.log`;
+        const prompt = `Implement ${specId} per docs/sdd/specs/${specId}/HU.md. Follow all acceptance criteria. Run pnpm typecheck && pnpm lint && pnpm test after implementing.`;
+        lines.push(`echo "[orchestrate] Launching agent for ${specId}..."`, `env -u CLAUDECODE claude -p "${prompt}" \\`, `  --cwd "${worktreePath}" \\`, `  > "${logFile}" 2>&1 &`, `PIDS[${specId}]=$!`);
+    }
+    return lines;
+}
+function buildWaitAndReport(specIds) {
+    const lines = ['FAILED=0', ''];
+    for (const specId of specIds) {
+        const slug = specId.toLowerCase().replace(/[^a-z0-9-]/g, '-');
+        const logFile = `/tmp/specforge-${slug}.log`;
+        lines.push(`echo "[orchestrate] Waiting for ${specId} (PID \${PIDS[${specId}]})..."`, `if wait "\${PIDS[${specId}]}"; then`, `  echo "[PASS] ${specId} completed successfully"`, `else`, `  echo "[FAIL] ${specId} failed — see ${logFile}" >&2`, `  FAILED=$((FAILED + 1))`, `fi`);
+    }
+    lines.push('', 'echo ""', 'echo "[orchestrate] Results: ' + String(specIds.length) + ' specs, $FAILED failed"', 'if [ "$FAILED" -gt 0 ]; then', '  echo "[ERROR] Some agents failed. Review logs in /tmp/specforge-*.log" >&2', '  exit 1', 'fi');
+    return lines;
+}
+function buildCleanupInstructions(specIds) {
+    const lines = [
+        'echo ""',
+        'echo "[orchestrate] All agents completed successfully."',
+        'echo "[orchestrate] Review each branch and merge when ready:"',
+        'echo ""',
+    ];
+    for (const specId of specIds) {
+        const slug = specId.toLowerCase().replace(/[^a-z0-9-]/g, '-');
+        const worktreePath = `$WORKTREE_BASE/${slug}`;
+        lines.push(`echo "  ${specId}: git -C \\"$PROJECT_PATH\\" worktree remove \\"${worktreePath}\\""`);
+    }
+    lines.push('echo ""', 'echo "[orchestrate] To remove all worktrees after merging:"', `echo "  git -C \\"$PROJECT_PATH\\" worktree prune"`);
+    return lines;
+}
+//# sourceMappingURL=orchestration-generator.js.map

package/dist/tools/suggest-tooling/orchestration-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration-generator.js","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/orchestration-generator.ts"],"names":[],"mappings":"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"}

package/dist/tools/suggest-tooling/otel-catalog.d.ts

@@ -0,0 +1,9 @@
+import type { ProjectKnowledge } from '../../types/index.js';
+/** Reset the in-memory cache (for testing only). */
+export declare function resetOtelCatalogCache(): void;
+/**
+ * Build OTel tooling recommendation lines for projects with OTel detected or needed.
+ * Only emits if `knowledge.otelDetection?.isInstalled` or `needsOtel` is true.
+ */
+export declare function buildOtelToolingLines(knowledge: ProjectKnowledge): Promise<string[]>;
+//# sourceMappingURL=otel-catalog.d.ts.map

package/dist/tools/suggest-tooling/otel-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-catalog.d.ts","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/otel-catalog.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAqB,MAAM,sBAAsB,CAAC;AAIhF,oDAAoD;AACpD,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAwBD;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA+F1F"}