specforge-mcp 0.1.0

package/dist/tools/suggest-tooling/css-framework-catalog.js

@@ -0,0 +1,52 @@
+// tools/suggest-tooling/css-framework-catalog.ts — CSS framework detection and recommendations
+// SPEC-017a: CSS framework recommendation for frontend/fullstack web stacks
+/**
+ * Build CSS framework recommendation lines based on detected or missing framework.
+ * Only recommends for frontend/fullstack web stacks.
+ */
+export function buildCSSFrameworkLines(knowledge, detectedFramework) {
+    // Only recommend for frontend/fullstack web stacks
+    const webFrameworks = ['react', 'next', 'vue', 'nuxt', 'svelte', 'sveltekit', 'angular'];
+    const stackLower = knowledge.stack.map((s) => s.toLowerCase());
+    const hasWebFramework = webFrameworks.some((f) => stackLower.some((s) => s.includes(f))) ||
+        webFrameworks.some((f) => (knowledge.framework ?? '').toLowerCase().includes(f));
+    if (!hasWebFramework) {
+        return [];
+    }
+    if (detectedFramework) {
+        return [
+            '## CSS Framework',
+            '',
+            `**Detected:** \`${detectedFramework}\` — CSS framework found in project.`,
+            'No additional recommendation needed.',
+        ];
+    }
+    // Recommend based on stack
+    const fw = (knowledge.framework ?? '').toLowerCase();
+    let recommended = 'Tailwind CSS';
+    let installCmd = 'npm install -D tailwindcss postcss autoprefixer && npx tailwindcss init -p';
+    let reason = 'Tailwind CSS is framework-agnostic, highly customizable, and has excellent DX.';
+    if (fw.includes('next') || fw.includes('react')) {
+        recommended = 'Tailwind CSS or shadcn/ui';
+        installCmd = 'npm install -D tailwindcss && npx shadcn@latest init';
+        reason =
+            'Tailwind + shadcn/ui provides accessible components with full control for React/Next.js.';
+    }
+    else if (fw.includes('vue') || fw.includes('nuxt')) {
+        recommended = 'Tailwind CSS';
+        reason = 'Tailwind CSS integrates seamlessly with Vue/Nuxt via @nuxtjs/tailwindcss module.';
+    }
+    return [
+        '## CSS Framework Recommendation',
+        '',
+        `**No CSS framework detected.** Consider adopting one for consistent styling.`,
+        '',
+        `**Recommended:** ${recommended}`,
+        `**Why:** ${reason}`,
+        '',
+        `**Install:** \`${installCmd}\``,
+        '',
+        '**Alternatives:** Bootstrap 5 (component-rich), Material UI (Google MDC), Chakra UI (accessible).',
+    ];
+}
+//# sourceMappingURL=css-framework-catalog.js.map

package/dist/tools/suggest-tooling/css-framework-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-framework-catalog.js","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/css-framework-catalog.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,4EAA4E;AAI5E;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,SAA2B,EAC3B,iBAAgC;IAEhC,mDAAmD;IACnD,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IACzF,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/D,MAAM,eAAe,GACnB,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnF,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO;YACL,kBAAkB;YAClB,EAAE;YACF,mBAAmB,iBAAiB,sCAAsC;YAC1E,sCAAsC;SACvC,CAAC;IACJ,CAAC;IAED,2BAA2B;IAC3B,MAAM,EAAE,GAAG,CAAC,SAAS,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACrD,IAAI,WAAW,GAAG,cAAc,CAAC;IACjC,IAAI,UAAU,GAAG,4EAA4E,CAAC;IAC9F,IAAI,MAAM,GAAG,gFAAgF,CAAC;IAE9F,IAAI,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAChD,WAAW,GAAG,2BAA2B,CAAC;QAC1C,UAAU,GAAG,sDAAsD,CAAC;QACpE,MAAM;YACJ,0FAA0F,CAAC;IAC/F,CAAC;SAAM,IAAI,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACrD,WAAW,GAAG,cAAc,CAAC;QAC7B,MAAM,GAAG,kFAAkF,CAAC;IAC9F,CAAC;IAED,OAAO;QACL,iCAAiC;QACjC,EAAE;QACF,8EAA8E;QAC9E,EAAE;QACF,oBAAoB,WAAW,EAAE;QACjC,YAAY,MAAM,EAAE;QACpB,EAAE;QACF,kBAAkB,UAAU,IAAI;QAChC,EAAE;QACF,mGAAmG;KACpG,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { ProjectKnowledge } from '../../types/index.js';
+/**
+ * Build Dagger CI tooling recommendation lines.
+ *
+ * When dagger.json is detected → emits existing Dagger usage tips.
+ * When complex CI is detected but no Dagger → recommends Dagger as improvement.
+ */
+export declare function buildDaggerCatalogLines(knowledge: ProjectKnowledge): Promise<string[]>;
+//# sourceMappingURL=dagger-catalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dagger-catalog.d.ts","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/dagger-catalog.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAiD7D;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA8D5F"}

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

@@ -0,0 +1,116 @@
+// tools/suggest-tooling/dagger-catalog.ts — SPEC-026a TD-P15-01
+// Builds Dagger CI tooling recommendation lines for suggest_tooling.
+// Dagger (dagger.io) — portable CI pipelines via Go/Python/TypeScript SDK.
+import { access } from 'node:fs/promises';
+import { glob } from 'glob';
+/**
+ * Returns true when dagger.json is present at the project root.
+ */
+async function hasDaggerJson(projectPath) {
+    try {
+        await access(`${projectPath}/dagger.json`);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Returns true when the project has a complex CI setup:
+ * multiple GitHub Actions workflow files OR a Makefile with CI targets.
+ */
+async function hasComplexCi(projectPath) {
+    try {
+        const workflowFiles = await glob('**/.github/workflows/*.yml', {
+            cwd: projectPath,
+            absolute: false,
+        });
+        if (workflowFiles.length >= 2) {
+            return true;
+        }
+        // Check for Makefile with CI-related targets
+        const makefiles = await glob('**/Makefile', { cwd: projectPath, absolute: false });
+        if (makefiles.length === 0) {
+            return false;
+        }
+        const { readFile } = await import('node:fs/promises');
+        for (const makefile of makefiles) {
+            const content = await readFile(`${projectPath}/${makefile}`, 'utf-8');
+            const ciTargetPattern = /^(ci|build|test|lint|deploy|release)\s*:/m;
+            if (ciTargetPattern.test(content)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Build Dagger CI tooling recommendation lines.
+ *
+ * When dagger.json is detected → emits existing Dagger usage tips.
+ * When complex CI is detected but no Dagger → recommends Dagger as improvement.
+ */
+export async function buildDaggerCatalogLines(knowledge) {
+    const projectPath = knowledge.projectPath;
+    const daggerDetected = await hasDaggerJson(projectPath);
+    const complexCi = daggerDetected ? false : await hasComplexCi(projectPath);
+    if (!daggerDetected && !complexCi) {
+        return [];
+    }
+    if (daggerDetected) {
+        return [
+            '## Dagger CI (detected: dagger.json)',
+            '',
+            '**Dagger** — Portable CI pipelines as code (Go/Python/TypeScript SDK)',
+            '- Detected: `dagger.json` found at project root',
+            '- Docs: https://docs.dagger.io',
+            '',
+            '### Dagger Best Practices',
+            '',
+            '- **Caching**: use `dag.CacheVolume()` for package manager caches (npm, pip, cargo, go)',
+            '  - Example: `cache := dag.CacheVolume("node-modules")`',
+            '- **SDK consistency**: pick one SDK (Go/Python/TypeScript) across all pipeline modules',
+            '- **Local parity**: run `dagger call build` locally to validate before pushing — identical to CI',
+            '- **Secrets**: use `dag.SetSecret()` — never pass secrets as plain env vars in pipeline code',
+            '- **Multi-platform**: `dagger call build --platform linux/amd64,linux/arm64` for cross-arch builds',
+            '',
+            '### Dagger Modules (2026)',
+            '',
+            '- Search community modules: https://daggerverse.dev',
+            '- Popular: `golang`, `python`, `node`, `docker`, `helm`, `terraform` modules',
+            '- Install module: `dagger install github.com/dagger/dagger/modules/go@latest`',
+            '',
+        ];
+    }
+    // complexCi detected — recommend Dagger as improvement
+    return [
+        '## Dagger CI (recommended)',
+        '',
+        '> Complex CI setup detected (multiple workflows or Makefile CI targets).',
+        '> Dagger makes CI pipelines portable, testable locally, and language-agnostic.',
+        '',
+        '**Dagger** — Portable pipelines as code (dagger.io)',
+        '- Install CLI: `curl -L https://dl.dagger.io/dagger/install.sh | sh`',
+        '- Docs: https://docs.dagger.io/quickstart',
+        '',
+        '### Why Dagger over plain YAML',
+        '',
+        '| Feature | YAML CI | Dagger |',
+        '|---------|---------|--------|',
+        '| Local debug | Slow (push + wait) | `dagger call test` in seconds |',
+        '| Type safety | None | Full (Go/Python/TypeScript SDK) |',
+        '| Reuse | Copy-paste | Versioned modules from daggerverse.dev |',
+        '| CI portability | Vendor lock-in | GitHub Actions, GitLab, Jenkins, local |',
+        '',
+        '### SDK Options',
+        '',
+        '- **Go SDK**: `dagger init --sdk go` — best for Go projects or multi-language monorepos',
+        '- **Python SDK**: `dagger init --sdk python` — familiar for Python/ML teams',
+        '- **TypeScript SDK**: `dagger init --sdk typescript` — natural for Node.js/web projects',
+        '',
+    ];
+}
+//# sourceMappingURL=dagger-catalog.js.map

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

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

package/dist/tools/suggest-tooling/dep-audit-catalog.d.ts

@@ -0,0 +1,22 @@
+import type { DepAuditReport, DepAuditEntry } from '../../types/index.js';
+/**
+ * Run a full dependency audit for a project and return Markdown lines.
+ */
+export declare function buildDepAuditLines(projectPath: string): Promise<string[]>;
+/**
+ * Run a full dependency audit and return both the report and Markdown lines.
+ * Used internally to allow single-dep lookup after scanning.
+ */
+export declare function buildDepAuditReport(projectPath: string): Promise<{
+    report: DepAuditReport;
+    lines: string[];
+}>;
+/**
+ * Find a specific dep entry across all severity buckets.
+ */
+export declare function findEntryByName(report: DepAuditReport, packageName: string): DepAuditEntry | undefined;
+/**
+ * Build acceptance-criteria lines for a single package pre-check (C5).
+ */
+export declare function buildSingleDepAuditLines(report: DepAuditReport, packageName: string): string[];
+//# sourceMappingURL=dep-audit-catalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dep-audit-catalog.d.ts","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/dep-audit-catalog.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1E;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAI/E;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IACtE,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC,CAID;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,MAAM,GAClB,aAAa,GAAG,SAAS,CAG3B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAa9F"}

package/dist/tools/suggest-tooling/dep-audit-catalog.js

@@ -0,0 +1,45 @@
+// dep-audit-catalog.ts — Build dep-audit tooling lines for suggest_tooling (SPEC-025)
+// Integrates with the dep-auditor engine to produce Markdown output.
+import { auditDeps, formatDepAuditMarkdown, formatDepAuditAcceptanceCriteria, } from '../../engine/dep-auditor/index.js';
+/**
+ * Run a full dependency audit for a project and return Markdown lines.
+ */
+export async function buildDepAuditLines(projectPath) {
+    const report = await auditDeps(projectPath);
+    const markdown = formatDepAuditMarkdown(report);
+    return markdown.split('\n');
+}
+/**
+ * Run a full dependency audit and return both the report and Markdown lines.
+ * Used internally to allow single-dep lookup after scanning.
+ */
+export async function buildDepAuditReport(projectPath) {
+    const report = await auditDeps(projectPath);
+    const markdown = formatDepAuditMarkdown(report);
+    return { report, lines: markdown.split('\n') };
+}
+/**
+ * Find a specific dep entry across all severity buckets.
+ */
+export function findEntryByName(report, packageName) {
+    const allEntries = [...report.critical, ...report.warnings, ...report.clean];
+    return allEntries.find((e) => e.name === packageName);
+}
+/**
+ * Build acceptance-criteria lines for a single package pre-check (C5).
+ */
+export function buildSingleDepAuditLines(report, packageName) {
+    const entry = findEntryByName(report, packageName);
+    if (!entry) {
+        return [
+            `## Pre-check: \`${packageName}\``,
+            '',
+            `_Package \`${packageName}\` was not found in project dependencies._`,
+            '',
+            '**Note:** This package is not listed in your manifest file.',
+            'Add it first, then re-run the audit, or check the package name.',
+        ];
+    }
+    return formatDepAuditAcceptanceCriteria(entry).split('\n');
+}
+//# sourceMappingURL=dep-audit-catalog.js.map

package/dist/tools/suggest-tooling/dep-audit-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dep-audit-catalog.js","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/dep-audit-catalog.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,qEAAqE;AACrE,OAAO,EACL,SAAS,EACT,sBAAsB,EACtB,gCAAgC,GACjC,MAAM,mCAAmC,CAAC;AAG3C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,WAAmB;IAC1D,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAChD,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,WAAmB;IAI3D,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAChD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAsB,EACtB,WAAmB;IAEnB,MAAM,UAAU,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7E,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAsB,EAAE,WAAmB;IAClF,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,mBAAmB,WAAW,IAAI;YAClC,EAAE;YACF,cAAc,WAAW,4CAA4C;YACrE,EAAE;YACF,6DAA6D;YAC7D,iEAAiE;SAClE,CAAC;IACJ,CAAC;IACD,OAAO,gCAAgC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC7D,CAAC"}

package/dist/tools/suggest-tooling/dora-output.d.ts

@@ -0,0 +1,6 @@
+import { calculateDoraMetrics } from '../../engine/dora-metrics.js';
+export declare function fetchDoraMetrics(projectPath: string): Promise<{
+    doraMetrics: Awaited<ReturnType<typeof calculateDoraMetrics>> | null;
+}>;
+export declare function buildDoraOutputLines(doraMetrics: Awaited<ReturnType<typeof calculateDoraMetrics>>): string[];
+//# sourceMappingURL=dora-output.d.ts.map

package/dist/tools/suggest-tooling/dora-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dora-output.d.ts","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/dora-output.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oBAAoB,EAIrB,MAAM,8BAA8B,CAAC;AAEtC,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,GAAG,IAAI,CAAA;CAAE,CAAC,CAInF;AAED,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,GAC5D,MAAM,EAAE,CA4BV"}

package/dist/tools/suggest-tooling/dora-output.js

@@ -0,0 +1,35 @@
+// tools/suggest-tooling/dora-output.ts — DORA metrics output formatting
+import { calculateDoraMetrics, hasEnoughHistory, generateRecommendations, classifyMetric, } from '../../engine/dora-metrics.js';
+export async function fetchDoraMetrics(projectPath) {
+    const hasDoraHistory = await hasEnoughHistory(projectPath, 90);
+    const doraMetrics = hasDoraHistory ? await calculateDoraMetrics(projectPath, 30) : null;
+    return { doraMetrics };
+}
+export function buildDoraOutputLines(doraMetrics) {
+    const doraRecs = generateRecommendations(doraMetrics);
+    const lines = [
+        '',
+        '### DORA Metrics (Engineering Performance)',
+        '',
+        '> Note: Calculated from local git history — not equivalent to CI/CD-integrated tools.',
+        '',
+        '| Metric | Value | Tier |',
+        '|--------|-------|------|',
+        `| Deployment Frequency | ${doraMetrics.deploymentFrequency.toFixed(2)}/week | ${classifyMetric('deploymentFrequency', doraMetrics.deploymentFrequency).toUpperCase()} |`,
+        `| Lead Time | ${doraMetrics.leadTimeHours.toFixed(1)}h | ${classifyMetric('leadTimeHours', doraMetrics.leadTimeHours).toUpperCase()} |`,
+        `| Change Failure Rate | ${doraMetrics.changeFailureRate.toFixed(1)}% | ${classifyMetric('changeFailureRate', doraMetrics.changeFailureRate).toUpperCase()} |`,
+        `| MTTR | ${doraMetrics.mttrHours.toFixed(1)}h | ${classifyMetric('mttrHours', doraMetrics.mttrHours).toUpperCase()} |`,
+        '',
+        `**Overall tier:** ${doraMetrics.tier.toUpperCase()}`,
+        '',
+    ];
+    if (doraRecs.length > 0) {
+        lines.push('**Recommendations:**');
+        for (const rec of doraRecs) {
+            lines.push(`- ${rec}`);
+        }
+        lines.push('');
+    }
+    return lines;
+}
+//# sourceMappingURL=dora-output.js.map

package/dist/tools/suggest-tooling/dora-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dora-output.js","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/dora-output.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,GACf,MAAM,8BAA8B,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,WAAmB;IAEnB,MAAM,cAAc,GAAG,MAAM,gBAAgB,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,cAAc,CAAC,CAAC,CAAC,MAAM,oBAAoB,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxF,OAAO,EAAE,WAAW,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,WAA6D;IAE7D,MAAM,QAAQ,GAAG,uBAAuB,CAAC,WAAW,CAAC,CAAC;IACtD,MAAM,KAAK,GAAa;QACtB,EAAE;QACF,4CAA4C;QAC5C,EAAE;QACF,uFAAuF;QACvF,EAAE;QACF,2BAA2B;QAC3B,2BAA2B;QAC3B,4BAA4B,WAAW,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,cAAc,CAAC,qBAAqB,EAAE,WAAW,CAAC,mBAAmB,CAAC,CAAC,WAAW,EAAE,IAAI;QACzK,iBAAiB,WAAW,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,cAAc,CAAC,eAAe,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,IAAI;QACxI,2BAA2B,WAAW,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,cAAc,CAAC,mBAAmB,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAC,WAAW,EAAE,IAAI;QAC9J,YAAY,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,cAAc,CAAC,WAAW,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,IAAI;QACvH,EAAE;QACF,qBAAqB,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE;QACrD,EAAE;KACH,CAAC;IAEF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACnC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;QACzB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { ProjectKnowledge } from '../../types/index.js';
+export declare function buildAgentToolingLines(knowledge: ProjectKnowledge): string[];
+export declare function buildDesktopToolingLines(knowledge: ProjectKnowledge): string[];
+//# sourceMappingURL=framework-catalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"framework-catalog.d.ts","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/framework-catalog.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAI7D,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAuD5E;AAID,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAgG9E"}

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

@@ -0,0 +1,137 @@
+// tools/suggest-tooling/framework-catalog.ts — Desktop and AI agent tooling line builders
+// Extracted from suggest-tooling.ts to stay within the 400-line file budget.
+// === SPEC-016a: AI agent tooling ===
+export function buildAgentToolingLines(knowledge) {
+    const stack = knowledge.stack.map((s) => s.toLowerCase());
+    const agentSignals = [
+        '@anthropic-ai/sdk',
+        '@mastra/core',
+        'langgraph',
+        'crewai',
+        'autogen',
+        'langchain',
+        '@ai-sdk/anthropic',
+        'vercel ai sdk',
+    ];
+    const isAgent = agentSignals.some((sig) => stack.some((s) => s.includes(sig)));
+    if (!isAgent) {
+        return [];
+    }
+    return [
+        '## AI Agent Tooling',
+        '',
+        '### Vector Databases (for RAG and memory)',
+        '- **Pinecone** — Managed vector DB, production-ready, serverless (`npm install @pinecone-database/pinecone`)',
+        '- **Chroma** — Open-source, local dev friendly (`pip install chromadb`)',
+        '- **Weaviate** — Open-source, GraphQL API, multi-modal (`npm install weaviate-client`)',
+        '- **Qdrant** — Rust-based, high performance (`npm install @qdrant/js-client-rest`)',
+        '',
+        '### Memory Solutions',
+        '- **mem0** — AI memory layer, supports user/session/agent memory (`npm install mem0ai`)',
+        '- **LangChain Memory** — Conversation buffer, summary, entity memory (`pip install langchain`)',
+        '',
+        '### Agent Orchestration Frameworks',
+        '- **LangGraph** — Graph-based stateful agent workflows (`pip install langgraph`)',
+        '- **CrewAI** — Role-based multi-agent teams (`pip install crewai`)',
+        '- **Mastra** — TypeScript-first agent framework (`npm install @mastra/core`)',
+        '- **AutoGen** — Multi-agent conversation framework (`pip install autogen-agentchat`)',
+        '',
+        '### Evaluation Frameworks',
+        '- **RAGAS** — RAG evaluation: faithfulness, answer relevancy, context precision',
+        '  - `pip install ragas` — integrate with LangChain or LlamaIndex',
+        '- **TruLens** — LLM app evaluation and monitoring (`pip install trulens-eval`)',
+        '- **DeepEval** — Unit testing for LLM outputs (`pip install deepeval`)',
+        '- **Promptfoo** — LLM evaluation and red-teaming (`npm install -g promptfoo`)',
+        '',
+        '### Monitoring and Observability',
+        '- **LangSmith** — LangChain tracing and evaluation (cloud, `LANGCHAIN_TRACING_V2=true`)',
+        '- **Langfuse** — Open-source LLM observability (`npm install langfuse`)',
+        '- **Helicone** — LLM proxy with logging (`npm install helicone`)',
+        '',
+        '### Security',
+        '- **LLM Guard** — Input/output sanitization for LLMs (`pip install llm-guard`)',
+        '- **Prompt injection detection** — Build regex-based filters for common injection patterns',
+        '- **Rate limiting** — Implement per-user token budgets to prevent cost abuse',
+        '',
+    ];
+}
+// === SPEC-014b: Desktop distribution tooling ===
+export function buildDesktopToolingLines(knowledge) {
+    const framework = knowledge.framework?.toLowerCase() ?? '';
+    const stack = knowledge.stack.map((s) => s.toLowerCase());
+    const isDesktop = knowledge.projectCategory === 'desktop';
+    if (!isDesktop) {
+        return [];
+    }
+    const lines = ['## Desktop Distribution Tooling', ''];
+    const isElectron = framework === 'electron' || stack.some((s) => s.includes('electron'));
+    const isTauri = framework === 'tauri' || stack.some((s) => s.includes('tauri'));
+    const isDotNet = framework === 'dotnet' || stack.some((s) => s.includes('dotnet') || s.includes('.net'));
+    const isLinuxNative = stack.some((s) => s.includes('gtk') || s.includes('qt') || s.includes('gnome'));
+    if (isElectron) {
+        lines.push('### Electron Distribution');
+        lines.push('');
+        lines.push('- **electron-builder** — Recommended packager. Targets:');
+        lines.push('  - Windows: `nsis` (full installer), `squirrel` (auto-update friendly)');
+        lines.push('  - macOS: `dmg` (drag-to-install), `pkg` (mass deployment)');
+        lines.push('  - Linux: `AppImage` (universal), `deb` (Debian/Ubuntu), `snap` (Ubuntu Store)');
+        lines.push('- **electron-forge** — Alternative packager with plugin ecosystem');
+        lines.push('- **Code Signing Requirements:**');
+        lines.push('  - Windows: Authenticode EV certificate (eliminates SmartScreen warning)');
+        lines.push('  - macOS: Developer ID Application certificate + notarization (mandatory for Gatekeeper)');
+        lines.push('  - Linux: SHA256 checksums (no OS-enforced signing)');
+        lines.push('- **electron-updater** — Auto-update via GitHub Releases, S3, or custom server');
+        lines.push('');
+    }
+    if (isTauri) {
+        lines.push('### Tauri Distribution');
+        lines.push('');
+        lines.push('- **Tauri bundler** (built-in) — Native OS installers per platform:');
+        lines.push('  - Windows: `msi` (MSI) or `nsis` (NSIS installer)');
+        lines.push('  - macOS: `dmg` with mandatory notarization for outside Mac App Store distribution');
+        lines.push('  - Linux: `AppImage`, `deb`, `rpm`');
+        lines.push('- **macOS Notarization**: required for Gatekeeper (`xcrun notarytool submit`)');
+        lines.push('- **Tauri Updater**: configure in `tauri.conf.json` → `tauri.updater`');
+        lines.push('  - Provide signed `update.json` endpoint with version + download URLs + signature');
+        lines.push('  - Supports differential/patch updates via `tauri-update`');
+        lines.push('');
+    }
+    if (isDotNet && !isElectron && !isTauri) {
+        lines.push('### .NET Desktop Distribution');
+        lines.push('');
+        lines.push('- **ClickOnce** — Intranet/enterprise deployment (self-updating, no admin required)');
+        lines.push('  - Best for: internal tools, .NET Framework WPF/WinForms apps');
+        lines.push('  - Requires: code signing cert, IIS/file share hosting');
+        lines.push('- **MSIX** — Microsoft Store + enterprise sideloading');
+        lines.push('  - Best for: Store distribution or MDM/Intune enterprise deployment');
+        lines.push('  - Requires: Partner Center account (Store) or EV cert (sideload)');
+        lines.push('- **WiX Toolset** — Custom MSI installer (most flexible, steeper learning curve)');
+        lines.push('  - Best for: complex install requirements (registry, services, custom actions)');
+        lines.push('- **.NET Framework vs .NET 6+:**');
+        lines.push('  - .NET Framework: Windows-only, ClickOnce supported out-of-box');
+        lines.push('  - .NET 6+: cross-platform (win-x64, osx-x64, linux-x64), self-contained publish');
+        lines.push('');
+    }
+    if (isLinuxNative) {
+        lines.push('### Linux Native Distribution');
+        lines.push('');
+        lines.push('- **Flatpak** — Recommended for Flathub (broadest distro coverage)');
+        lines.push('  - Sandboxed (limited filesystem/portal access via `xdg-portal`)');
+        lines.push('  - Manifest: `org.example.App.yml` + `org.freedesktop.Platform` runtime');
+        lines.push('  - Submit to Flathub: `https://github.com/flathub/flathub`');
+        lines.push('- **Snap** — Ubuntu Snap Store (Canonical ecosystem)');
+        lines.push('  - Config: `snapcraft.yaml` with confinement: strict/classic');
+        lines.push('  - Classic confinement = full filesystem access (like deb, review required)');
+        lines.push('- **deb** — Debian/Ubuntu direct packaging (no sandbox, full OS access)');
+        lines.push('  - Use `dpkg-deb` or `fpm` for building');
+        lines.push('  - Host on PPA (Ubuntu) or custom apt repository');
+        lines.push('- **rpm** — Fedora/RHEL/openSUSE packaging (no sandbox, full OS access)');
+        lines.push('  - Use `rpmbuild` or `fpm` for building');
+        lines.push('  - Host on COPR (Fedora) or custom RPM repository');
+        lines.push('- **Sandbox vs no-sandbox**: Flatpak apps must request permissions via portals;');
+        lines.push('  deb/rpm apps have unrestricted access but require user trust.');
+        lines.push('');
+    }
+    return lines;
+}
+//# sourceMappingURL=framework-catalog.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"framework-catalog.js","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/framework-catalog.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,6EAA6E;AAI7E,sCAAsC;AAEtC,MAAM,UAAU,sBAAsB,CAAC,SAA2B;IAChE,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAG;QACnB,mBAAmB;QACnB,cAAc;QACd,WAAW;QACX,QAAQ;QACR,SAAS;QACT,WAAW;QACX,mBAAmB;QACnB,eAAe;KAChB,CAAC;IACF,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAE/E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO;QACL,qBAAqB;QACrB,EAAE;QACF,2CAA2C;QAC3C,8GAA8G;QAC9G,yEAAyE;QACzE,wFAAwF;QACxF,oFAAoF;QACpF,EAAE;QACF,sBAAsB;QACtB,yFAAyF;QACzF,gGAAgG;QAChG,EAAE;QACF,oCAAoC;QACpC,kFAAkF;QAClF,oEAAoE;QACpE,8EAA8E;QAC9E,sFAAsF;QACtF,EAAE;QACF,2BAA2B;QAC3B,iFAAiF;QACjF,kEAAkE;QAClE,gFAAgF;QAChF,wEAAwE;QACxE,+EAA+E;QAC/E,EAAE;QACF,kCAAkC;QAClC,yFAAyF;QACzF,yEAAyE;QACzE,kEAAkE;QAClE,EAAE;QACF,cAAc;QACd,gFAAgF;QAChF,4FAA4F;QAC5F,8EAA8E;QAC9E,EAAE;KACH,CAAC;AACJ,CAAC;AAED,kDAAkD;AAElD,MAAM,UAAU,wBAAwB,CAAC,SAA2B;IAClE,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC3D,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAG,SAAS,CAAC,eAAe,KAAK,SAAS,CAAC;IAE1D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAa,CAAC,iCAAiC,EAAE,EAAE,CAAC,CAAC;IAEhE,MAAM,UAAU,GAAG,SAAS,KAAK,UAAU,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IACzF,MAAM,OAAO,GAAG,SAAS,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAChF,MAAM,QAAQ,GACZ,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1F,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAC9B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CACpE,CAAC;IAEF,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;QACtE,KAAK,CAAC,IAAI,CAAC,yEAAyE,CAAC,CAAC;QACtF,KAAK,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;QAC1E,KAAK,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAC;QAC9F,KAAK,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC;QAChF,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;QACxF,KAAK,CAAC,IAAI,CACR,2FAA2F,CAC5F,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;QACnE,KAAK,CAAC,IAAI,CAAC,gFAAgF,CAAC,CAAC;QAC7F,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;QAClF,KAAK,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;QAClE,KAAK,CAAC,IAAI,CACR,qFAAqF,CACtF,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;QAC5F,KAAK,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAC;QACpF,KAAK,CAAC,IAAI,CACR,oFAAoF,CACrF,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QACzE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,QAAQ,IAAI,CAAC,UAAU,IAAI,CAAC,OAAO,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CACR,qFAAqF,CACtF,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;QAC7E,KAAK,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;QACtE,KAAK,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;QACpE,KAAK,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAC;QACnF,KAAK,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;QACjF,KAAK,CAAC,IAAI,CAAC,kFAAkF,CAAC,CAAC;QAC/F,KAAK,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAC;QAC9F,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;QAC/E,KAAK,CAAC,IAAI,CAAC,mFAAmF,CAAC,CAAC;QAChG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;QACjF,KAAK,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC;QAChF,KAAK,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;QACvF,KAAK,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;QAC1E,KAAK,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;QACnE,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,8EAA8E,CAAC,CAAC;QAC3F,KAAK,CAAC,IAAI,CAAC,yEAAyE,CAAC,CAAC;QACtF,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;QAChE,KAAK,CAAC,IAAI,CAAC,yEAAyE,CAAC,CAAC;QACtF,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;QACjE,KAAK,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAC;QAC9F,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;QAC9E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/tools/suggest-tooling/frontend-perf-catalog.d.ts

@@ -0,0 +1,7 @@
+import type { ProjectKnowledge, FrontendPerfDetectionResult } from '../../types/index.js';
+/**
+ * SPEC-057: Build frontend performance and architecture tooling recommendation lines.
+ * Returns markdown lines for suggest_tooling output.
+ */
+export declare function buildFrontendPerfToolingLines(knowledge: ProjectKnowledge, detection?: FrontendPerfDetectionResult | null): string[];
+//# sourceMappingURL=frontend-perf-catalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontend-perf-catalog.d.ts","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/frontend-perf-catalog.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAkI1F;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,gBAAgB,EAC3B,SAAS,CAAC,EAAE,2BAA2B,GAAG,IAAI,GAC7C,MAAM,EAAE,CA6BV"}

package/dist/tools/suggest-tooling/frontend-perf-catalog.js

@@ -0,0 +1,132 @@
+// tools/suggest-tooling/frontend-perf-catalog.ts — SPEC-057
+// Generates tooling recommendations for frontend performance, MFE management,
+// design systems, and E2E testing.
+// Criteria: S3 (Lighthouse CI), S7 (Bit.dev/Nx Cloud), S11 (Storybook/Ladle),
+//           S13 (Playwright/Cypress), S15 (Chromatic)
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function isJsTsProject(knowledge) {
+    const lang = knowledge.language.toLowerCase();
+    return lang === 'typescript' || lang === 'javascript';
+}
+function hasMfeDetected(knowledge) {
+    const mfe = knowledge.mfeDetection;
+    if (!mfe) {
+        return false;
+    }
+    return mfe.moduleFederation !== undefined || mfe.singleSpa === true || mfe.nxMfe === true;
+}
+function hasModuleFederation(knowledge) {
+    return knowledge.mfeDetection?.moduleFederation !== undefined;
+}
+// ---------------------------------------------------------------------------
+// S3: Lighthouse CI recommendation
+// ---------------------------------------------------------------------------
+function buildLighthouseCiLines(detection) {
+    if (detection.hasPerformanceBudget) {
+        return [];
+    }
+    return [
+        '- **Lighthouse CI** — Automated performance budget enforcement in CI',
+        '  - Install: `npm install -D @lhci/cli`',
+        '  - Config: create `.lighthouserc.json` with performance budgets (LCP < 2.5s, CLS < 0.1)',
+        '  - Docs: https://github.com/GoogleChrome/lighthouse-ci',
+        '',
+    ];
+}
+// ---------------------------------------------------------------------------
+// S7: Bit.dev / Nx Cloud for MFE
+// ---------------------------------------------------------------------------
+function buildMfeToolingLines(knowledge) {
+    if (!hasMfeDetected(knowledge)) {
+        return [];
+    }
+    const lines = [];
+    if (hasModuleFederation(knowledge)) {
+        lines.push('- **Nx Cloud** — Distributed build cache and task execution for Module Federation monorepos', '  - Install: `npx nx connect`', '  - Benefits: shared build cache across MFE teams, affected-only CI runs', '  - Docs: https://nx.dev/ci/intro/nx-cloud', '');
+    }
+    lines.push('- **Bit.dev** — Component-driven development and versioning for micro-frontends', '  - Install: `npx @teambit/bvm install`', '  - Benefits: independent component versioning, cross-MFE dependency tracking', '  - Docs: https://bit.dev/docs', '');
+    return lines;
+}
+// ---------------------------------------------------------------------------
+// S11: Storybook / Ladle recommendation
+// ---------------------------------------------------------------------------
+function buildDesignSystemToolingLines(detection) {
+    // Only recommend if no Storybook/Ladle already present
+    if (detection.hasStorybook || detection.hasDesignSystem) {
+        return [];
+    }
+    return [
+        '- **Storybook 8** — Component development environment and design system documentation',
+        '  - Install: `npx storybook@latest init`',
+        '  - Benefits: isolated component development, visual testing, auto-generated docs',
+        '  - Alternative: **Ladle** for lightweight Vite-only setup (`npm install -D @ladle/react`)',
+        '  - Docs: https://storybook.js.org',
+        '',
+    ];
+}
+// ---------------------------------------------------------------------------
+// S13: Playwright / Cypress recommendation
+// ---------------------------------------------------------------------------
+function buildE2eToolingLines(detection) {
+    if (detection.hasE2eFramework) {
+        return [];
+    }
+    return [
+        '- **Playwright** — Modern E2E testing with multi-browser support',
+        '  - Install: `npm init playwright@latest`',
+        '  - Benefits: auto-wait, trace viewer, component testing, multi-browser parallel execution',
+        '  - Alternative: **Cypress** for teams preferring a GUI-first approach (`npm install -D cypress`)',
+        '  - Docs: https://playwright.dev',
+        '',
+    ];
+}
+// ---------------------------------------------------------------------------
+// S15: Chromatic recommendation
+// ---------------------------------------------------------------------------
+function buildChromaticLines(detection) {
+    if (!detection.hasStorybook) {
+        return [];
+    }
+    return [
+        '- **Chromatic** — Visual regression testing and review platform for Storybook',
+        '  - Install: `npm install -D chromatic`',
+        '  - Benefits: automated screenshot comparison per PR, Storybook publishing, UI review workflow',
+        '  - Docs: https://www.chromatic.com/docs',
+        '',
+    ];
+}
+// ---------------------------------------------------------------------------
+// Main export
+// ---------------------------------------------------------------------------
+/**
+ * SPEC-057: Build frontend performance and architecture tooling recommendation lines.
+ * Returns markdown lines for suggest_tooling output.
+ */
+export function buildFrontendPerfToolingLines(knowledge, detection) {
+    if (!isJsTsProject(knowledge)) {
+        return [];
+    }
+    if (!detection) {
+        return [];
+    }
+    const lines = [];
+    const sections = [
+        buildLighthouseCiLines(detection),
+        buildMfeToolingLines(knowledge),
+        buildDesignSystemToolingLines(detection),
+        buildE2eToolingLines(detection),
+        buildChromaticLines(detection),
+    ];
+    const nonEmpty = sections.filter((s) => s.length > 0);
+    if (nonEmpty.length === 0) {
+        return [];
+    }
+    lines.push('## Frontend Architecture Tooling', '');
+    for (const section of nonEmpty) {
+        lines.push(...section);
+    }
+    return lines;
+}
+//# sourceMappingURL=frontend-perf-catalog.js.map