specforge-mcp 0.1.0

package/dist/engine/detectors/advanced-framework-detector/modern-detector.js

@@ -0,0 +1,48 @@
+// engine/detectors/advanced-framework-detector/modern-detector.ts
+// Detects modern frontend frameworks: Astro, Fresh, HTMX, Qwik, SolidStart, etc.
+import { join } from 'node:path';
+import { fileExists, readFileContent } from './helpers.js';
+async function detectIslandsAndHTMX(projectPath, deps) {
+    if (deps.has('astro') ||
+        (await fileExists(join(projectPath, 'astro.config.mjs'))) ||
+        (await fileExists(join(projectPath, 'astro.config.ts')))) {
+        return { framework: 'astro', architecture: 'islands' };
+    }
+    if (deps.has('fresh') || (await fileExists(join(projectPath, 'fresh.config.ts')))) {
+        return { framework: 'fresh', architecture: 'islands' };
+    }
+    if (deps.has('htmx.org') || deps.has('htmx')) {
+        return { framework: 'htmx', architecture: 'htmx' };
+    }
+    const indexHtml = await readFileContent(join(projectPath, 'index.html'));
+    if (indexHtml.includes('htmx.org') || indexHtml.includes('htmx.min.js')) {
+        return { framework: 'htmx', architecture: 'htmx' };
+    }
+    return { framework: null, architecture: null };
+}
+function detectDepsModernFramework(_projectPath, deps, pkg) {
+    if (deps.has('@builder.io/qwik') || deps.has('@builder.io/qwik-city')) {
+        return { framework: 'qwik', architecture: 'resumability' };
+    }
+    if (deps.has('solid-js') && deps.has('@solidjs/start')) {
+        return { framework: 'solid-start', architecture: 'ssr' };
+    }
+    if (deps.has('@tanstack/router') && deps.has('@tanstack/start')) {
+        return { framework: 'tanstack-start', architecture: 'ssr' };
+    }
+    if (deps.has('react-router')) {
+        const version = pkg.dependencies?.['react-router'] ?? pkg.devDependencies?.['react-router'];
+        if (version?.startsWith('7') || version?.startsWith('^7')) {
+            return { framework: 'remix-v7', architecture: 'ssr' };
+        }
+    }
+    return { framework: null, architecture: null };
+}
+export async function detectModernFramework(projectPath, deps, pkg) {
+    const islandsResult = await detectIslandsAndHTMX(projectPath, deps);
+    if (islandsResult.framework !== null) {
+        return islandsResult;
+    }
+    return detectDepsModernFramework(projectPath, deps, pkg);
+}
+//# sourceMappingURL=modern-detector.js.map

package/dist/engine/detectors/advanced-framework-detector/modern-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modern-detector.js","sourceRoot":"","sources":["../../../../src/engine/detectors/advanced-framework-detector/modern-detector.ts"],"names":[],"mappings":"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"}

package/dist/engine/detectors/advanced-framework-detector.d.ts

@@ -0,0 +1,2 @@
+export { detectAdvancedFrameworks, buildAdvancedFrameworkHints, } from './advanced-framework-detector/index.js';
+//# sourceMappingURL=advanced-framework-detector.d.ts.map

package/dist/engine/detectors/advanced-framework-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced-framework-detector.d.ts","sourceRoot":"","sources":["../../../src/engine/detectors/advanced-framework-detector.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,wCAAwC,CAAC"}

package/dist/engine/detectors/advanced-framework-detector.js

@@ -0,0 +1,4 @@
+// engine/detectors/advanced-framework-detector.ts — SPEC-017b
+// Barrel re-export. Implementation lives in ./advanced-framework-detector/
+export { detectAdvancedFrameworks, buildAdvancedFrameworkHints, } from './advanced-framework-detector/index.js';
+//# sourceMappingURL=advanced-framework-detector.js.map

package/dist/engine/detectors/advanced-framework-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced-framework-detector.js","sourceRoot":"","sources":["../../../src/engine/detectors/advanced-framework-detector.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,2EAA2E;AAE3E,OAAO,EACL,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,wCAAwC,CAAC"}

package/dist/engine/detectors/advanced-framework-hints.d.ts

@@ -0,0 +1,6 @@
+import type { AdvancedFrameworkDetection, AdvancedFrameworkHints } from '../../types/index.js';
+/**
+ * Generate contract hints and criteria suggestions from advanced detection results.
+ */
+export declare function buildAdvancedFrameworkHints(detection: AdvancedFrameworkDetection): AdvancedFrameworkHints;
+//# sourceMappingURL=advanced-framework-hints.d.ts.map

package/dist/engine/detectors/advanced-framework-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced-framework-hints.d.ts","sourceRoot":"","sources":["../../../src/engine/detectors/advanced-framework-hints.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,0BAA0B,EAC1B,sBAAsB,EAKvB,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,0BAA0B,GACpC,sBAAsB,CAyBxB"}

package/dist/engine/detectors/advanced-framework-hints.js

@@ -0,0 +1,152 @@
+// engine/detectors/advanced-framework-hints.ts — SPEC-017b
+// Contract hints generation from advanced framework detection results.
+/**
+ * Generate contract hints and criteria suggestions from advanced detection results.
+ */
+export function buildAdvancedFrameworkHints(detection) {
+    const hints = {};
+    const hintsWithArch = applyArchitectureHints(hints, detection);
+    Object.assign(hints, hintsWithArch);
+    if (detection.legacyFrameworks.length > 0) {
+        hints.legacyRisks = buildLegacyRisks(detection.legacyFrameworks);
+        hints.migrationCriteria =
+            'Include a criterion for coexistence plan or incremental migration strategy.';
+    }
+    if (detection.stateManagement.length > 0) {
+        hints.stateStrategyNotes = buildStateManagementNotes(detection.stateManagement);
+    }
+    if (detection.enterpriseDesignSystem) {
+        hints.designSystemTokens = buildDesignSystemTokenHints(detection.enterpriseDesignSystem);
+    }
+    if (detection.cssInJS) {
+        hints.cssPatterns = buildCSSInJSPatternHints(detection.cssInJS);
+    }
+    return hints;
+}
+function applyArchitectureHints(hints, detection) {
+    const result = { ...hints };
+    if (detection.architecture === 'islands') {
+        result.architectureParadigm =
+            'Islands Architecture: distinguish server-rendered (static HTML) from interactive islands';
+        result.hydrationNotes =
+            'Specify which islands require hydration and why. Prefer server-rendered for static content.';
+        return result;
+    }
+    if (detection.architecture === 'htmx') {
+        result.architectureParadigm =
+            'HTMX: server-centric partial HTML exchange (hx-get, hx-post, hx-swap, hx-target)';
+        result.hydrationNotes = 'No SPA client state. Server returns HTML fragments, not JSON.';
+        return result;
+    }
+    if (detection.architecture === 'resumability') {
+        result.architectureParadigm = 'Resumability (QwikCity): lazy execution by default';
+        result.hydrationNotes =
+            'Define which code runs on server vs client. Lazy load all event handlers.';
+        return result;
+    }
+    if (detection.modernFramework === 'remix-v7') {
+        result.architectureParadigm = 'Remix v7 / React Router v7: loader/action server-first paradigm';
+        result.hydrationNotes = 'Specify what logic goes in loader vs action vs component.';
+        return result;
+    }
+    if (detection.modernFramework === 'tanstack-start') {
+        result.architectureParadigm =
+            'TanStack Start: type-safe routing with Route.useParams() and Route.useLoaderData()';
+        result.hydrationNotes = 'Use server functions and loader patterns for data fetching.';
+        return result;
+    }
+    if (detection.modernFramework === 'solid-start') {
+        result.architectureParadigm = 'SolidStart: fine-grained reactivity with Signals';
+        result.hydrationNotes =
+            'Use createSignal, createMemo, createEffect — distinguish reactive primitives from component state.';
+    }
+    return result;
+}
+function buildLegacyRisks(frameworks) {
+    const riskMap = {
+        jquery: 'jQuery: risk of event namespace collision and conflicts with jQuery plugins',
+        backbone: 'Backbone.js: define plan for Views, Models, Collections coexistence',
+        knockout: 'Knockout.js: ensure compatibility with existing ko.applyBindings',
+        ember: 'Ember Octane: follow Glimmer components, tracked properties, modifiers',
+        extjs: 'Ext JS: vendor lock-in risk + licensing cost — document explicitly',
+        'angularjs-1': 'AngularJS 1.x: EOL since 2021 — security risk, migration plan required',
+    };
+    return frameworks.map((fw) => riskMap[fw]);
+}
+function buildStateManagementNotes(libs) {
+    const notesMap = {
+        'tanstack-query': 'TanStack Query: server state only (useQuery, useMutation). Define query key strategy and staleTime/gcTime.',
+        zustand: 'Zustand: define store slice (actions, selectors, persisted state).',
+        jotai: 'Jotai: define atoms (local vs global, derived atoms with atom()).',
+        xstate: 'XState: define state machine (states, transitions, guards, actions, actors).',
+        signals: 'Signals: use correct API per framework (Angular/Preact/Solid/Vue).',
+        nanostores: 'Nanostores: define cross-island vs local atoms/maps/computed.',
+    };
+    return libs.map((lib) => notesMap[lib]).join(' | ');
+}
+function buildDesignSystemTokenHints(ds) {
+    const tokenHints = {
+        carbon: [
+            'Use Carbon tokens: color $carbon--blue-60, spacing $spacing-05, type $productive-heading-03',
+            'Specify Carbon theme: White, G10, G90, or G100',
+        ],
+        polaris: [
+            'Use Polaris ActionList patterns and components',
+            'Verify Polaris a11y compliance and Embedded App guidelines',
+        ],
+        'fluent-ui': [
+            'Use Fluent tokens: colorNeutralBackground1, spacingHorizontalM',
+            'Distinguish Fluent v8 (classic React) vs v9 (Web Components-based)',
+        ],
+        'radix-ui': [
+            'Follow Radix composition: Root > Trigger > Content > Item pattern',
+            'Radix provides built-in a11y — do NOT reimplement ARIA',
+        ],
+        'arco-design': [
+            'Use Arco Design tokens and ConfigProvider for global theme',
+            'Follow Arco component naming conventions',
+        ],
+        'ark-ui': [
+            'Ark UI is headless: Root, Control, Label, Input pattern',
+            'Project is responsible for styling layer — Ark handles behavior and a11y',
+        ],
+        'naive-ui': ['Use Naive UI theme tokens and n-config-provider for theming'],
+        vuetify: ['Use Vuetify Material Design tokens and v-* props'],
+        quasar: ['Use Quasar utility classes and q-* components'],
+    };
+    return tokenHints[ds];
+}
+function buildCSSInJSPatternHints(approach) {
+    const patterns = {
+        'vanilla-extract': [
+            'Type-safe CSS in *.css.ts files using styleVariants() and recipe()',
+            'Use createGlobalTheme() for design token contracts',
+            'Zero-runtime — compiled to static CSS at build time',
+        ],
+        'panda-css': [
+            'Use css(), cva() and tokens from panda.config.ts',
+            'Define in which CSS layer: base, component, or recipe',
+            'Static extraction at build time — no runtime overhead',
+        ],
+        stylex: [
+            'Use stylex.create() for local styles, stylex.props() to apply',
+            'Shared tokens via stylex.defineVars() — specify local vs shared',
+            'Zero-runtime — compile-time CSS extraction',
+        ],
+        unocss: [
+            'Use active preset (preset-uno, preset-wind, preset-mini)',
+            'Check if attributify mode is enabled',
+            'preset-wind: same utility classes as Tailwind CSS',
+        ],
+        'open-props': [
+            'Use CSS custom properties: --blue-5, --size-3, --font-size-3',
+            'Always use Open Props vars instead of hardcoded values',
+        ],
+        'css-layers': [
+            'Define in which @layer new code belongs: base, components, or utilities',
+            'Risk: unexpected specificity if styles placed in wrong layer',
+        ],
+    };
+    return patterns[approach];
+}
+//# sourceMappingURL=advanced-framework-hints.js.map

package/dist/engine/detectors/advanced-framework-hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced-framework-hints.js","sourceRoot":"","sources":["../../../src/engine/detectors/advanced-framework-hints.ts"],"names":[],"mappings":"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"}

package/dist/engine/detectors/agent-framework-detector.d.ts

@@ -0,0 +1,24 @@
+import type { AgentFramework, MultiAgentTopology, AgentProjectType, AgentProjectKnowledge } from '../../types/index.js';
+/**
+ * Detect agent framework from package manifests.
+ * Criteria 13: detects Claude SDK, OpenAI Assistants, LangGraph, CrewAI, AutoGen,
+ * Vercel AI SDK, Mastra, Semantic Kernel.
+ */
+export declare function detectAgentFramework(projectPath: string): Promise<AgentFramework | null>;
+export declare function detectLlmModel(projectPath: string): Promise<string | null>;
+export declare function detectMemoryPersistence(projectPath: string): Promise<string | null>;
+export declare function detectAgentTools(projectPath: string): Promise<string[]>;
+/**
+ * Criteria 14: Detects agent-with-tools vs LLM pipeline vs RAG system vs multi-agent router.
+ */
+export declare function detectAgentProjectType(projectPath: string, framework: AgentFramework | null): Promise<AgentProjectType | null>;
+/**
+ * Criteria 15: Detects hub-and-spoke, swarm, or sequential-pipeline topology.
+ */
+export declare function detectMultiAgentTopology(projectPath: string, framework: AgentFramework | null): Promise<MultiAgentTopology | null>;
+/**
+ * Full agent project knowledge detection.
+ * Called from analyzer.ts after standard project analysis.
+ */
+export declare function detectAgentProjectKnowledge(projectPath: string): Promise<AgentProjectKnowledge>;
+//# sourceMappingURL=agent-framework-detector.d.ts.map

package/dist/engine/detectors/agent-framework-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-framework-detector.d.ts","sourceRoot":"","sources":["../../../src/engine/detectors/agent-framework-detector.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAwC9B;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA6D9F;AAID,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoBhF;AAID,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA0BzF;AAID,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsB7E;AAID;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,cAAc,GAAG,IAAI,GAC/B,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA8ClC;AAID;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,cAAc,GAAG,IAAI,GAC/B,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAgDpC;AAID;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,qBAAqB,CAAC,CAmBhC"}

package/dist/engine/detectors/agent-framework-detector.js

@@ -0,0 +1,260 @@
+// SpecForge — Agent Framework Detector
+// SPEC-016a: Detects AI agent frameworks, project types, and multi-agent topology.
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+// === Package detection helpers ===
+async function loadPackageJson(projectPath) {
+    try {
+        const content = await readFile(join(projectPath, 'package.json'), 'utf-8');
+        return JSON.parse(content);
+    }
+    catch /* v8 ignore next 2 */ {
+        return {};
+    }
+}
+function allDeps(pkg) {
+    return [...Object.keys(pkg.dependencies ?? {}), ...Object.keys(pkg.devDependencies ?? {})];
+}
+async function readPyRequirements(projectPath) {
+    for (const file of ['requirements.txt', 'pyproject.toml', 'setup.py']) {
+        try {
+            const content = await readFile(join(projectPath, file), 'utf-8');
+            return content.toLowerCase().split('\n');
+        }
+        catch {
+            // ignore
+        }
+    }
+    return [];
+}
+// === Framework detection ===
+/**
+ * Detect agent framework from package manifests.
+ * Criteria 13: detects Claude SDK, OpenAI Assistants, LangGraph, CrewAI, AutoGen,
+ * Vercel AI SDK, Mastra, Semantic Kernel.
+ */
+export async function detectAgentFramework(projectPath) {
+    const [pkg, pyLines] = await Promise.all([
+        loadPackageJson(projectPath),
+        readPyRequirements(projectPath),
+    ]);
+    const deps = allDeps(pkg);
+    // Claude SDK
+    if (deps.some((d) => d === '@anthropic-ai/sdk' || d === '@anthropic-ai/claude-code')) {
+        return 'claude-sdk';
+    }
+    // OpenAI Assistants (openai package with threads/runs usage)
+    if (deps.includes('openai')) {
+        try {
+            const indexContent = await readFile(join(projectPath, 'index.ts'), 'utf-8')
+                .catch(async () => readFile(join(projectPath, 'index.js'), 'utf-8'))
+                .catch(() => '');
+            if (indexContent.includes('threads') || indexContent.includes('.runs.')) {
+                return 'openai-assistants';
+            }
+        }
+        catch {
+            // not an assistant project
+        }
+    }
+    // LangGraph
+    if (deps.includes('langgraph') || pyLines.some((l) => l.includes('langgraph'))) {
+        return 'langgraph';
+    }
+    // CrewAI
+    if (pyLines.some((l) => l.includes('crewai'))) {
+        return 'crewai';
+    }
+    // AutoGen
+    if (pyLines.some((l) => l.includes('autogen') || l.includes('pyautogen'))) {
+        return 'autogen';
+    }
+    // Vercel AI SDK
+    if (deps.includes('ai') && deps.some((d) => d.startsWith('@ai-sdk/'))) {
+        return 'vercel-ai';
+    }
+    // Mastra
+    if (deps.includes('@mastra/core') || deps.some((d) => d.startsWith('@mastra/'))) {
+        return 'mastra';
+    }
+    // Semantic Kernel
+    if (pyLines.some((l) => l.includes('semantic-kernel')) ||
+        deps.some((d) => d.includes('semantic-kernel'))) {
+        return 'semantic-kernel';
+    }
+    return null;
+}
+// === LLM model detection ===
+export async function detectLlmModel(projectPath) {
+    for (const file of ['index.ts', 'index.js', 'agent.ts', 'agent.py', 'main.py']) {
+        try {
+            const content = await readFile(join(projectPath, file), 'utf-8');
+            const modelMatch = /model:\s*["']([^"']+)["']/.exec(content) ??
+                /model=["']([^"']+)["']/.exec(content) ??
+                /claude-[\w.-]+/.exec(content) ??
+                /gpt-[\w.-]+/.exec(content);
+            if (modelMatch?.[1]) {
+                return modelMatch[1];
+            }
+            if (modelMatch?.[0]) {
+                return modelMatch[0];
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    return null;
+}
+// === Memory persistence detection ===
+export async function detectMemoryPersistence(projectPath) {
+    const [pkg, pyLines] = await Promise.all([
+        loadPackageJson(projectPath),
+        readPyRequirements(projectPath),
+    ]);
+    const deps = allDeps(pkg);
+    if (deps.includes('mem0ai') || deps.includes('@mem0ai/mem0')) {
+        return 'mem0';
+    }
+    if (deps.some((d) => d.includes('pinecone')) || pyLines.some((l) => l.includes('pinecone'))) {
+        return 'pinecone';
+    }
+    if (deps.some((d) => d.includes('chroma') || d.includes('chromadb')) ||
+        pyLines.some((l) => l.includes('chromadb'))) {
+        return 'chromadb';
+    }
+    if (deps.some((d) => d.includes('weaviate')) || pyLines.some((l) => l.includes('weaviate'))) {
+        return 'weaviate';
+    }
+    if (deps.some((d) => d.includes('qdrant')) || pyLines.some((l) => l.includes('qdrant'))) {
+        return 'qdrant';
+    }
+    return null;
+}
+// === Tool detection ===
+export async function detectAgentTools(projectPath) {
+    const tools = [];
+    const pkg = await loadPackageJson(projectPath);
+    const deps = allDeps(pkg);
+    const toolMappings = [
+        [['@modelcontextprotocol/sdk'], 'mcp'],
+        [['langchain', 'langchain-core'], 'langchain-tools'],
+        [['tavily'], 'tavily-search'],
+        [['@anthropic-ai/sdk'], 'computer-use'],
+        [['axios', 'node-fetch', 'undici'], 'http-client'],
+        [['@playwright/test', 'puppeteer'], 'browser-automation'],
+        [['zod'], 'schema-validation'],
+    ];
+    for (const [packages, toolName] of toolMappings) {
+        if (packages.some((p) => deps.includes(p))) {
+            tools.push(toolName);
+        }
+    }
+    return tools;
+}
+// === Project type detection ===
+/**
+ * Criteria 14: Detects agent-with-tools vs LLM pipeline vs RAG system vs multi-agent router.
+ */
+export async function detectAgentProjectType(projectPath, framework) {
+    if (!framework) {
+        return null;
+    }
+    const [pkg, pyLines] = await Promise.all([
+        loadPackageJson(projectPath),
+        readPyRequirements(projectPath),
+    ]);
+    const deps = allDeps(pkg);
+    // RAG system: has vector store + embeddings
+    const hasVectorStore = deps.some((d) => ['pinecone', 'chromadb', 'weaviate', 'qdrant', '@supabase/supabase-js'].some((v) => d.includes(v))) ||
+        /* v8 ignore next 1 */ // Python vector-store path not reached in JS-only test projects
+        pyLines.some((l) => ['chromadb', 'pinecone', 'weaviate', 'qdrant'].some((v) => l.includes(v)));
+    const hasEmbeddings = deps.some((d) => ['openai', '@anthropic-ai/sdk', '@ai-sdk/openai'].includes(d)) ||
+        /* v8 ignore next 1 */ // Python embeddings path not reached in JS-only test projects
+        pyLines.some((l) => l.includes('embedding'));
+    if (hasVectorStore && hasEmbeddings) {
+        return 'rag-system';
+    }
+    // Multi-agent router: langgraph, crewai, autogen typically orchestrate multiple agents
+    if (framework === 'langgraph' || framework === 'crewai' || framework === 'autogen') {
+        return 'multi-agent-router';
+    }
+    // LLM pipeline: basic SDK usage without tools
+    const hasTools = deps.some((d) => d.includes('@modelcontextprotocol') || d.includes('langchain')) ||
+        /* v8 ignore next 1 */ // Python tools path not reached in JS-only test projects
+        pyLines.some((l) => l.includes('tool') || l.includes('function_call'));
+    if (!hasTools) {
+        return 'llm-pipeline';
+    }
+    // Default: agent with tools
+    return 'agent-with-tools';
+}
+// === Topology detection ===
+/**
+ * Criteria 15: Detects hub-and-spoke, swarm, or sequential-pipeline topology.
+ */
+export async function detectMultiAgentTopology(projectPath, framework) {
+    if (!framework) {
+        return null;
+    }
+    for (const file of ['index.ts', 'index.js', 'main.py', 'workflow.py', 'crew.py', 'graph.py']) {
+        try {
+            const content = await readFile(join(projectPath, file), 'utf-8').catch(() => '');
+            if (!content) {
+                continue;
+            }
+            const lower = content.toLowerCase();
+            if (lower.includes('swarm') || lower.includes('peer') || lower.includes('handoff')) {
+                return 'swarm';
+            }
+            if (lower.includes('pipeline') ||
+                lower.includes('sequential') ||
+                lower.includes('chain') ||
+                lower.includes('add_edge')) {
+                return 'sequential-pipeline';
+            }
+            if (lower.includes('coordinator') ||
+                lower.includes('router') ||
+                lower.includes('orchestrator') ||
+                lower.includes('dispatcher')) {
+                return 'hub-and-spoke';
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    if (framework === 'langgraph') {
+        return 'sequential-pipeline';
+    }
+    /* v8 ignore start */ // crewai topology path not covered by agent-framework-detector tests
+    if (framework === 'crewai') {
+        return 'hub-and-spoke';
+    }
+    return null;
+    /* v8 ignore stop */
+}
+// === Main public API ===
+/**
+ * Full agent project knowledge detection.
+ * Called from analyzer.ts after standard project analysis.
+ */
+export async function detectAgentProjectKnowledge(projectPath) {
+    const framework = await detectAgentFramework(projectPath);
+    const [llmModel, memoryPersistence, detectedTools, projectType, topology] = await Promise.all([
+        detectLlmModel(projectPath),
+        detectMemoryPersistence(projectPath),
+        detectAgentTools(projectPath),
+        detectAgentProjectType(projectPath, framework),
+        detectMultiAgentTopology(projectPath, framework),
+    ]);
+    return {
+        framework,
+        llmModel,
+        memoryPersistence,
+        detectedTools,
+        projectType,
+        topology,
+    };
+}
+//# sourceMappingURL=agent-framework-detector.js.map

package/dist/engine/detectors/agent-framework-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-framework-detector.js","sourceRoot":"","sources":["../../../src/engine/detectors/agent-framework-detector.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,mFAAmF;AAEnF,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC,oCAAoC;AAEpC,KAAK,UAAU,eAAe,CAAC,WAAmB;IAIhD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC;QAC3E,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAGxB,CAAC;IACJ,CAAC;IAAC,MAAM,sBAAsB,CAAC,CAAC;QAC9B,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,GAGhB;IACC,OAAO,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,CAAC;AAC7F,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,WAAmB;IACnD,KAAK,MAAM,IAAI,IAAI,CAAC,kBAAkB,EAAE,gBAAgB,EAAE,UAAU,CAAC,EAAE,CAAC;QACtE,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YACjE,OAAO,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,8BAA8B;AAE9B;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,WAAmB;IAC5D,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACvC,eAAe,CAAC,WAAW,CAAC;QAC5B,kBAAkB,CAAC,WAAW,CAAC;KAChC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAE1B,aAAa;IACb,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,mBAAmB,IAAI,CAAC,KAAK,2BAA2B,CAAC,EAAE,CAAC;QACrF,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,6DAA6D;IAC7D,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC;iBACxE,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;iBACnE,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACnB,IAAI,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACxE,OAAO,mBAAmB,CAAC;YAC7B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,2BAA2B;QAC7B,CAAC;IACH,CAAC;IAED,YAAY;IACZ,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QAC/E,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,SAAS;IACT,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAC9C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,UAAU;IACV,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QAC1E,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,gBAAgB;IAChB,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACtE,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,SAAS;IACT,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QAChF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,kBAAkB;IAClB,IACE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,EAC/C,CAAC;QACD,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8BAA8B;AAE9B,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,WAAmB;IACtD,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,CAAC;QAC/E,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YACjE,MAAM,UAAU,GACd,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC;gBACzC,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC;gBACtC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC;gBAC9B,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9B,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpB,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;YACvB,CAAC;YACD,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpB,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uCAAuC;AAEvC,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,WAAmB;IAC/D,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACvC,eAAe,CAAC,WAAW,CAAC;QAC5B,kBAAkB,CAAC,WAAW,CAAC;KAChC,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAE1B,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QAC7D,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QAC5F,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IACE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,EAC3C,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QAC5F,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACxF,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yBAAyB;AAEzB,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,WAAmB;IACxD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAE1B,MAAM,YAAY,GAAyB;QACzC,CAAC,CAAC,2BAA2B,CAAC,EAAE,KAAK,CAAC;QACtC,CAAC,CAAC,WAAW,EAAE,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;QACpD,CAAC,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;QAC7B,CAAC,CAAC,mBAAmB,CAAC,EAAE,cAAc,CAAC;QACvC,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,aAAa,CAAC;QAClD,CAAC,CAAC,kBAAkB,EAAE,WAAW,CAAC,EAAE,oBAAoB,CAAC;QACzD,CAAC,CAAC,KAAK,CAAC,EAAE,mBAAmB,CAAC;KAC/B,CAAC;IAEF,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,YAAY,EAAE,CAAC;QAChD,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,iCAAiC;AAEjC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,WAAmB,EACnB,SAAgC;IAEhC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACvC,eAAe,CAAC,WAAW,CAAC;QAC5B,kBAAkB,CAAC,WAAW,CAAC;KAChC,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAE1B,4CAA4C;IAC5C,MAAM,cAAc,GAClB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACd,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,uBAAuB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACjF,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CACd,CACF;QACD,sBAAsB,CAAC,gEAAgE;QACvF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjG,MAAM,aAAa,GACjB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,mBAAmB,EAAE,gBAAgB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC/E,sBAAsB,CAAC,8DAA8D;QACrF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;IAE/C,IAAI,cAAc,IAAI,aAAa,EAAE,CAAC;QACpC,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,uFAAuF;IACvF,IAAI,SAAS,KAAK,WAAW,IAAI,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QACnF,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,8CAA8C;IAC9C,MAAM,QAAQ,GACZ,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAChF,sBAAsB,CAAC,yDAAyD;QAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC;IAEzE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,4BAA4B;IAC5B,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,6BAA6B;AAE7B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,WAAmB,EACnB,SAAgC;IAEhC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,CAAC;QAC7F,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACjF,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,SAAS;YACX,CAAC;YACD,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YAEpC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACnF,OAAO,OAAO,CAAC;YACjB,CAAC;YAED,IACE,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAC1B,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAC5B,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACvB,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,EAC1B,CAAC;gBACD,OAAO,qBAAqB,CAAC;YAC/B,CAAC;YAED,IACE,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC;gBAC7B,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBACxB,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAC9B,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,EAC5B,CAAC;gBACD,OAAO,eAAe,CAAC;YACzB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IAED,IAAI,SAAS,KAAK,WAAW,EAAE,CAAC;QAC9B,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IACD,qBAAqB,CAAC,qEAAqE;IAC3F,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC3B,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,OAAO,IAAI,CAAC;IACZ,oBAAoB;AACtB,CAAC;AAED,0BAA0B;AAE1B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,WAAmB;IAEnB,MAAM,SAAS,GAAG,MAAM,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAE1D,MAAM,CAAC,QAAQ,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC5F,cAAc,CAAC,WAAW,CAAC;QAC3B,uBAAuB,CAAC,WAAW,CAAC;QACpC,gBAAgB,CAAC,WAAW,CAAC;QAC7B,sBAAsB,CAAC,WAAW,EAAE,SAAS,CAAC;QAC9C,wBAAwB,CAAC,WAAW,EAAE,SAAS,CAAC;KACjD,CAAC,CAAC;IAEH,OAAO;QACL,SAAS;QACT,QAAQ;QACR,iBAAiB;QACjB,aAAa;QACb,WAAW;QACX,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/engine/detectors/agile-detector.d.ts

@@ -0,0 +1,12 @@
+import type { AgileDetection } from '../../types/index.js';
+declare const SCRUM_SIGNALS: RegExp[];
+declare const SAFE_SIGNALS: RegExp[];
+declare const SHAPE_UP_SIGNALS: RegExp[];
+declare const KANBAN_SIGNALS: RegExp[];
+/**
+ * Detects agile methodology from repository signals.
+ * Checks branch names, issue templates, milestone names, and commit messages.
+ */
+export declare function detectAgile(projectPath: string): Promise<AgileDetection>;
+export { SCRUM_SIGNALS, SAFE_SIGNALS, SHAPE_UP_SIGNALS, KANBAN_SIGNALS };
+//# sourceMappingURL=agile-detector.d.ts.map

package/dist/engine/detectors/agile-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agile-detector.d.ts","sourceRoot":"","sources":["../../../src/engine/detectors/agile-detector.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3D,QAAA,MAAM,aAAa,UAA4E,CAAC;AAGhG,QAAA,MAAM,YAAY,UAKjB,CAAC;AAGF,QAAA,MAAM,gBAAgB,UAOrB,CAAC;AAGF,QAAA,MAAM,cAAc,UAMnB,CAAC;AAIF;;;GAGG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA8B9E;AAwHD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,CAAC"}