specforge-mcp 0.1.0

package/dist/engine/multi-agent/conflict-detector.js

@@ -0,0 +1,167 @@
+/** Files currently locked by in-progress agents (agentId → Set<filePath>). */
+const lockedFiles = new Map();
+/**
+ * C12 + C13 + C14: Analyse agent plans for file ownership overlaps.
+ * Returns a AgentConflictReport with per-file conflict details and suggested resolutions.
+ */
+export function detectConflicts(agentPlans) {
+    // Build an inverted index: file → agents that claim it
+    const fileToAgents = buildFileToAgentsIndex(agentPlans);
+    const conflicts = [];
+    for (const [file, agents] of fileToAgents.entries()) {
+        if (agents.length <= 1) {
+            continue;
+        }
+        const resolution = suggestResolution(file, agents);
+        const suggestion = buildSuggestion(file, agents, resolution);
+        conflicts.push({ file, agents: [...agents], resolution, suggestion });
+    }
+    return {
+        hasConflicts: conflicts.length > 0,
+        conflicts,
+    };
+}
+/**
+ * C15: Mark files as locked by an in-progress agent.
+ */
+export function lockFiles(agentId, files) {
+    if (!lockedFiles.has(agentId)) {
+        lockedFiles.set(agentId, new Set());
+    }
+    const agentSet = lockedFiles.get(agentId) ?? new Set();
+    lockedFiles.set(agentId, agentSet);
+    for (const f of files) {
+        agentSet.add(f);
+    }
+}
+/**
+ * C15: Release all file locks held by the given agent (call when agent finishes).
+ */
+export function releaseFileLocks(agentId) {
+    lockedFiles.delete(agentId);
+}
+/**
+ * C15: Return current locked-file state: which agent owns each locked file.
+ */
+export function getLockedFiles() {
+    const result = {};
+    for (const [agentId, files] of lockedFiles.entries()) {
+        for (const file of files) {
+            result[file] = agentId;
+        }
+    }
+    return result;
+}
+/**
+ * C16 + C17: Decompose spec criteria among available agents minimising conflicts.
+ * Assigns criteria subsets and file ownership to each worker.
+ */
+export function decomposeSpec(specCriteria, availableAgents) {
+    if (availableAgents.length === 0 || specCriteria.length === 0) {
+        return [];
+    }
+    const agentCount = availableAgents.length;
+    const chunkSize = Math.ceil(specCriteria.length / agentCount);
+    const assignments = availableAgents.map((agentId, idx) => {
+        const start = idx * chunkSize;
+        const end = Math.min(start + chunkSize, specCriteria.length);
+        const criteria = specCriteria.slice(start, end);
+        return {
+            agentId,
+            criteria,
+            fileOwnership: deriveFileOwnership(criteria, agentId),
+            // Each assignment depends on all previous ones (sequential safety)
+            dependencies: availableAgents.slice(0, idx),
+        };
+    });
+    return assignments.filter((a) => a.criteria.length > 0);
+}
+/**
+ * C18: Validate that all criteria are covered and no ownership conflicts remain.
+ */
+export function validateTriadCompletion(workerResults, expectedCriteria) {
+    const coveredSet = new Set();
+    const fileOwners = new Map();
+    const ownershipConflicts = [];
+    for (const result of workerResults) {
+        for (const criterion of result.coveredCriteria) {
+            coveredSet.add(criterion);
+        }
+        for (const file of result.modifiedFiles) {
+            const existing = fileOwners.get(file);
+            if (existing !== undefined && existing !== result.agentId) {
+                ownershipConflicts.push(file);
+            }
+            else {
+                fileOwners.set(file, result.agentId);
+            }
+        }
+    }
+    const uncoveredCriteria = expectedCriteria.filter((c) => !coveredSet.has(c));
+    const isValid = uncoveredCriteria.length === 0 && ownershipConflicts.length === 0;
+    const summary = buildValidationSummary(isValid, uncoveredCriteria, ownershipConflicts);
+    return { isValid, uncoveredCriteria, ownershipConflicts, summary };
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function buildFileToAgentsIndex(plans) {
+    const index = new Map();
+    for (const plan of plans) {
+        for (const file of plan.ownedFiles) {
+            const existing = index.get(file);
+            if (existing) {
+                existing.push(plan.agentId);
+            }
+            else {
+                index.set(file, [plan.agentId]);
+            }
+        }
+    }
+    return index;
+}
+function suggestResolution(file, _agents) {
+    // Heuristics based on file path
+    if (file.includes('index') || file.endsWith('.json')) {
+        return 'merge';
+    }
+    if (file.includes('test') || file.includes('spec')) {
+        return 'partition';
+    }
+    return 'sequential';
+}
+function buildSuggestion(file, agents, resolution) {
+    const agentList = agents.join(', ');
+    if (resolution === 'sequential') {
+        return `Run agents sequentially: ${agentList} should take turns modifying '${file}'.`;
+    }
+    if (resolution === 'partition') {
+        return `Partition '${file}' by section: assign different regions to ${agentList}.`;
+    }
+    return `Merge strategy: each of ${agentList} should write to separate branches and merge '${file}' at the end.`;
+}
+function deriveFileOwnership(criteria, agentId) {
+    // Produce stable pseudo-paths from criteria so ownership is deterministic
+    return criteria.map((c) => {
+        const slug = c
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, '-')
+            .replace(/^-+|-+$/g, '')
+            .slice(0, 30);
+        return `src/agent-work/${agentId}/${slug}.ts`;
+    });
+}
+function buildValidationSummary(isValid, uncoveredCriteria, ownershipConflicts) {
+    if (isValid) {
+        return 'All criteria covered with no ownership conflicts. Triad complete.';
+    }
+    const parts = ['Triad validation failed.'];
+    if (uncoveredCriteria.length > 0) {
+        parts.push(`Uncovered criteria: ${uncoveredCriteria.join(', ')}.`);
+    }
+    if (ownershipConflicts.length > 0) {
+        parts.push(`Ownership conflicts on: ${ownershipConflicts.join(', ')}.`);
+    }
+    return parts.join(' ');
+}
+//# sourceMappingURL=conflict-detector.js.map

package/dist/engine/multi-agent/conflict-detector.js.map

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

package/dist/engine/multi-agent/handoff-generator.d.ts

@@ -0,0 +1,19 @@
+import type { HandoffContext, SessionContext } from '../../types/index.js';
+export type { SessionContext } from '../../types/index.js';
+/**
+ * C8: Produce a structured HandoffContext from the current session state.
+ * Includes completed work, decisions, file ownership, pending tasks, and a summary.
+ */
+export declare function generateHandoff(sessionContext: SessionContext): HandoffContext;
+/**
+ * C11: Validate that a receiving agent can reconstruct enough context from the handoff
+ * without needing to read the full session history.
+ *
+ * Returns a validation result with any missing fields listed.
+ */
+export declare function reconstructContext(handoff: HandoffContext): {
+    isValid: boolean;
+    missingFields: string[];
+    summary: string;
+};
+//# sourceMappingURL=handoff-generator.d.ts.map

package/dist/engine/multi-agent/handoff-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff-generator.d.ts","sourceRoot":"","sources":["../../../src/engine/multi-agent/handoff-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3E,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,cAAc,EAAE,cAAc,GAAG,cAAc,CAY9E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG;IAC3D,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB,CA0BA"}

package/dist/engine/multi-agent/handoff-generator.js

@@ -0,0 +1,68 @@
+/**
+ * C8: Produce a structured HandoffContext from the current session state.
+ * Includes completed work, decisions, file ownership, pending tasks, and a summary.
+ */
+export function generateHandoff(sessionContext) {
+    const sessionSummary = buildSessionSummary(sessionContext);
+    return {
+        fromAgent: sessionContext.fromAgent,
+        toAgent: sessionContext.toAgent,
+        completedWork: [...sessionContext.completedWork],
+        decisions: sessionContext.decisions.map((d) => ({ ...d })),
+        fileOwnershipMap: { ...sessionContext.fileOwnershipMap },
+        pendingWork: sessionContext.pendingWork.map((p) => ({ ...p })),
+        sessionSummary,
+    };
+}
+/**
+ * C11: Validate that a receiving agent can reconstruct enough context from the handoff
+ * without needing to read the full session history.
+ *
+ * Returns a validation result with any missing fields listed.
+ */
+export function reconstructContext(handoff) {
+    const missingFields = [];
+    if (handoff.fromAgent.trim() === '') {
+        missingFields.push('fromAgent');
+    }
+    if (handoff.toAgent.trim() === '') {
+        missingFields.push('toAgent');
+    }
+    if (handoff.completedWork.length === 0) {
+        missingFields.push('completedWork');
+    }
+    if (handoff.sessionSummary.trim() === '') {
+        missingFields.push('sessionSummary');
+    }
+    if (Object.keys(handoff.fileOwnershipMap).length === 0 && handoff.pendingWork.length === 0) {
+        // Must have at least one of: file ownership or pending work to be actionable
+        missingFields.push('fileOwnershipMap or pendingWork');
+    }
+    const isValid = missingFields.length === 0;
+    const summary = isValid
+        ? `Handoff from ${handoff.fromAgent} to ${handoff.toAgent} is complete and actionable.`
+        : `Handoff is incomplete. Missing: ${missingFields.join(', ')}.`;
+    return { isValid, missingFields, summary };
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function buildSessionSummary(ctx) {
+    const parts = [];
+    parts.push(`Agent ${ctx.fromAgent} completed ${ctx.completedWork.length} task(s).`);
+    if (ctx.decisions.length > 0) {
+        parts.push(`${ctx.decisions.length} architectural decision(s) made.`);
+    }
+    const fileCount = Object.keys(ctx.fileOwnershipMap).length;
+    if (fileCount > 0) {
+        parts.push(`${fileCount} file(s) modified.`);
+    }
+    if (ctx.pendingWork.length > 0) {
+        parts.push(`${ctx.pendingWork.length} task(s) remain for ${ctx.toAgent}.`);
+    }
+    else {
+        parts.push(`No pending work for ${ctx.toAgent}.`);
+    }
+    return parts.join(' ');
+}
+//# sourceMappingURL=handoff-generator.js.map

package/dist/engine/multi-agent/handoff-generator.js.map

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

package/dist/engine/multi-agent/index.d.ts

@@ -0,0 +1,6 @@
+export { registerCapability, getCapability, getCapableAgents, listCapabilities, unregisterCapability, clearRegistry, } from './capability-registry.js';
+export { routeTask } from './task-router.js';
+export { generateHandoff, reconstructContext } from './handoff-generator.js';
+export type { SessionContext } from './handoff-generator.js';
+export { detectConflicts, lockFiles, releaseFileLocks, getLockedFiles, decomposeSpec, validateTriadCompletion, } from './conflict-detector.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/multi-agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/multi-agent/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,GACd,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,EACL,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,uBAAuB,GACxB,MAAM,wBAAwB,CAAC"}

package/dist/engine/multi-agent/index.js

@@ -0,0 +1,6 @@
+// multi-agent/index.ts — Barrel re-export for SPEC-055 multi-agent engine modules
+export { registerCapability, getCapability, getCapableAgents, listCapabilities, unregisterCapability, clearRegistry, } from './capability-registry.js';
+export { routeTask } from './task-router.js';
+export { generateHandoff, reconstructContext } from './handoff-generator.js';
+export { detectConflicts, lockFiles, releaseFileLocks, getLockedFiles, decomposeSpec, validateTriadCompletion, } from './conflict-detector.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/multi-agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/multi-agent/index.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,GACd,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAG7E,OAAO,EACL,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,uBAAuB,GACxB,MAAM,wBAAwB,CAAC"}

package/dist/engine/multi-agent/task-router.d.ts

@@ -0,0 +1,8 @@
+import type { AgentCapability, TaskRoute } from '../../types/index.js';
+/**
+ * C4 + C6 + C7: Route a task description to the best available agent.
+ * Returns a TaskRoute with assigned agent, model tier, and confidence score.
+ * If the task requires multiple agents (C5), decomposition is included.
+ */
+export declare function routeTask(taskDescription: string, availableAgents: AgentCapability[]): TaskRoute;
+//# sourceMappingURL=task-router.d.ts.map

package/dist/engine/multi-agent/task-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-router.d.ts","sourceRoot":"","sources":["../../../src/engine/multi-agent/task-router.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,SAAS,EAIV,MAAM,sBAAsB,CAAC;AAS9B;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,eAAe,EAAE,GAAG,SAAS,CAoBhG"}

package/dist/engine/multi-agent/task-router.js

@@ -0,0 +1,167 @@
+// multi-agent/task-router.ts — Dynamic task routing based on keywords (SPEC-055)
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+function loadCatalog() {
+    // Load from JSON config — no external deps, bundled with project
+    return require('../../config/agent-capabilities-catalog.json');
+}
+/**
+ * C4 + C6 + C7: Route a task description to the best available agent.
+ * Returns a TaskRoute with assigned agent, model tier, and confidence score.
+ * If the task requires multiple agents (C5), decomposition is included.
+ */
+export function routeTask(taskDescription, availableAgents) {
+    const catalog = loadCatalog();
+    const taskId = generateTaskId(taskDescription);
+    const lower = taskDescription.toLowerCase();
+    // C5: Detect compound tasks that need decomposition
+    if (requiresDecomposition(lower, catalog)) {
+        return buildDecomposedRoute(taskId, lower, availableAgents, catalog);
+    }
+    const model = inferModel(lower, catalog);
+    const role = inferRole(lower, catalog);
+    const { agent, confidence } = findBestAgent(role, model, availableAgents);
+    return {
+        taskId,
+        assignedAgent: agent,
+        model,
+        confidence,
+    };
+}
+// ---------------------------------------------------------------------------
+// Decomposition
+// ---------------------------------------------------------------------------
+/**
+ * C5: A task requires decomposition when it contains paired verb categories
+ * from different roles (e.g. "implement" + "test", "build" + "review").
+ */
+function requiresDecomposition(lower, catalog) {
+    const matchedRoles = new Set();
+    for (const [roleName, roleDef] of Object.entries(catalog.standardRoles)) {
+        for (const keyword of roleDef.keywords) {
+            if (lower.includes(keyword)) {
+                matchedRoles.add(roleName);
+                break;
+            }
+        }
+    }
+    // Decompose only when at least two distinct roles are detected
+    return matchedRoles.size >= 2;
+}
+function buildDecomposedRoute(taskId, lower, availableAgents, catalog) {
+    const subtasks = detectSubtasks(lower, catalog);
+    const decomposition = subtasks.map((sub, idx) => {
+        const { agent, confidence } = findBestAgent(sub.role, sub.model, availableAgents);
+        return {
+            taskId: `${taskId}-sub${idx + 1}`,
+            assignedAgent: agent,
+            model: sub.model,
+            confidence,
+        };
+    });
+    // Parent route uses the first sub-task's agent and the highest model tier needed
+    const primarySub = decomposition[0];
+    const primaryAgent = primarySub?.assignedAgent ?? 'unassigned';
+    const primaryModel = highestModel(decomposition.map((d) => d.model));
+    const avgConfidence = decomposition.length > 0
+        ? decomposition.reduce((sum, d) => sum + d.confidence, 0) / decomposition.length
+        : 0;
+    return {
+        taskId,
+        assignedAgent: primaryAgent,
+        model: primaryModel,
+        confidence: round2(avgConfidence),
+        decomposition,
+    };
+}
+function detectSubtasks(lower, catalog) {
+    const result = [];
+    for (const [roleName, roleDef] of Object.entries(catalog.standardRoles)) {
+        for (const keyword of roleDef.keywords) {
+            if (lower.includes(keyword)) {
+                result.push({ role: roleName, model: roleDef.model });
+                break;
+            }
+        }
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Model + role inference (C7)
+// ---------------------------------------------------------------------------
+function inferModel(lower, catalog) {
+    for (const [, roleDef] of Object.entries(catalog.standardRoles)) {
+        for (const keyword of roleDef.keywords) {
+            if (lower.includes(keyword)) {
+                return roleDef.model;
+            }
+        }
+    }
+    // Default: sonnet for unrecognized tasks
+    return 'sonnet';
+}
+function inferRole(lower, catalog) {
+    for (const [roleName, roleDef] of Object.entries(catalog.standardRoles)) {
+        for (const keyword of roleDef.keywords) {
+            if (lower.includes(keyword)) {
+                return roleName;
+            }
+        }
+    }
+    return 'implementer';
+}
+// ---------------------------------------------------------------------------
+// Agent selection
+// ---------------------------------------------------------------------------
+function findBestAgent(role, model, agents) {
+    if (agents.length === 0) {
+        return { agent: 'unassigned', confidence: 0 };
+    }
+    // Prefer agents whose role matches exactly and model tier matches
+    const exact = agents.find((a) => a.role === role && a.preferredModel === model);
+    if (exact !== undefined) {
+        return { agent: exact.agentId, confidence: 0.95 };
+    }
+    // Fall back to role match only
+    const roleMatch = agents.find((a) => a.role === role);
+    if (roleMatch !== undefined) {
+        return { agent: roleMatch.agentId, confidence: 0.75 };
+    }
+    // Fall back to model tier match
+    const modelMatch = agents.find((a) => a.preferredModel === model);
+    if (modelMatch !== undefined) {
+        return { agent: modelMatch.agentId, confidence: 0.5 };
+    }
+    // Last resort: first available agent (agents.length > 0 is guaranteed above)
+    const first = agents[0];
+    /* v8 ignore next 3 */
+    if (first === undefined) {
+        return { agent: 'unassigned', confidence: 0 };
+    }
+    return { agent: first.agentId, confidence: 0.25 };
+}
+// ---------------------------------------------------------------------------
+// Utilities
+// ---------------------------------------------------------------------------
+const MODEL_ORDER = ['haiku', 'sonnet', 'opus'];
+function highestModel(models) {
+    let best = 'haiku';
+    for (const m of models) {
+        if (MODEL_ORDER.indexOf(m) > MODEL_ORDER.indexOf(best)) {
+            best = m;
+        }
+    }
+    return best;
+}
+function generateTaskId(description) {
+    const slug = description
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 40);
+    return `task-${slug}-${Date.now().toString(36)}`;
+}
+function round2(value) {
+    return Math.round(value * 100) / 100;
+}
+//# sourceMappingURL=task-router.js.map

package/dist/engine/multi-agent/task-router.js.map

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

package/dist/engine/multi-app-detector/app-type.d.ts

@@ -0,0 +1,9 @@
+import type { ProjectApp } from '../../types/index.js';
+/**
+ * Infer the app type from its framework and directory name.
+ */
+export declare function inferAppType(framework: string | null, appPath: string): ProjectApp['type'];
+export declare function isFrontendFramework(fw: string): boolean;
+export declare function isBackendFramework(fw: string): boolean;
+export declare function isMobileFramework(fw: string): boolean;
+//# sourceMappingURL=app-type.d.ts.map

package/dist/engine/multi-app-detector/app-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-type.d.ts","sourceRoot":"","sources":["../../../src/engine/multi-app-detector/app-type.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAWvD;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAsB1F;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAevD;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAoBtD;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/dist/engine/multi-app-detector/app-type.js

@@ -0,0 +1,74 @@
+// SpecForge — Multi-app detector: app type inference helpers
+import { basename } from 'node:path';
+const DIR_TYPE_MAP = [
+    { keywords: ['web', 'frontend', 'client'], type: 'frontend' },
+    { keywords: ['api', 'backend', 'server'], type: 'backend' },
+    { keywords: ['mobile', 'app'], type: 'mobile' },
+    { keywords: ['shared', 'common', 'lib'], type: 'shared' },
+    { keywords: ['docs', 'documentation'], type: 'docs' },
+    { keywords: ['worker', 'jobs'], type: 'worker' },
+];
+/**
+ * Infer the app type from its framework and directory name.
+ */
+export function inferAppType(framework, appPath) {
+    const dirName = basename(appPath).toLowerCase();
+    for (const { keywords, type } of DIR_TYPE_MAP) {
+        if (keywords.some((kw) => dirName.includes(kw))) {
+            return type;
+        }
+    }
+    if (framework) {
+        if (isFrontendFramework(framework)) {
+            return 'frontend';
+        }
+        if (isBackendFramework(framework)) {
+            return 'backend';
+        }
+        if (isMobileFramework(framework)) {
+            return 'mobile';
+        }
+    }
+    return 'backend'; // Default fallback
+}
+export function isFrontendFramework(fw) {
+    return [
+        'react',
+        'vue',
+        'angular',
+        'svelte',
+        'next.js',
+        'nuxt',
+        'astro',
+        'remix',
+        'solidjs',
+        'qwik',
+        'gatsby',
+        'eleventy',
+    ].includes(fw);
+}
+export function isBackendFramework(fw) {
+    return [
+        'express',
+        'fastapi',
+        'django',
+        'flask',
+        'gin',
+        'laravel',
+        'spring',
+        'rails',
+        'nestjs',
+        'hono',
+        'elysia',
+        'actix-web',
+        'axum',
+        'phoenix',
+        'ktor',
+        'symfony',
+        'vapor',
+    ].includes(fw);
+}
+export function isMobileFramework(fw) {
+    return ['react-native', 'expo', 'flutter', 'swiftui', 'jetpack-compose'].includes(fw);
+}
+//# sourceMappingURL=app-type.js.map

package/dist/engine/multi-app-detector/app-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-type.js","sourceRoot":"","sources":["../../../src/engine/multi-app-detector/app-type.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrC,MAAM,YAAY,GAAuD;IACvE,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE;IAC7D,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE;IAC3D,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC/C,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE;IACzD,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,eAAe,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE;IACrD,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE;CACjD,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,SAAwB,EAAE,OAAe;IACpE,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAEhD,KAAK,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,YAAY,EAAE,CAAC;QAC9C,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAChD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,IAAI,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC,CAAC,mBAAmB;AACvC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,EAAU;IAC5C,OAAO;QACL,OAAO;QACP,KAAK;QACL,SAAS;QACT,QAAQ;QACR,SAAS;QACT,MAAM;QACN,OAAO;QACP,OAAO;QACP,SAAS;QACT,MAAM;QACN,QAAQ;QACR,UAAU;KACX,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EAAU;IAC3C,OAAO;QACL,SAAS;QACT,SAAS;QACT,QAAQ;QACR,OAAO;QACP,KAAK;QACL,SAAS;QACT,QAAQ;QACR,OAAO;QACP,QAAQ;QACR,MAAM;QACN,QAAQ;QACR,WAAW;QACX,MAAM;QACN,SAAS;QACT,MAAM;QACN,SAAS;QACT,OAAO;KACR,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC1C,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACxF,CAAC"}

package/dist/engine/multi-app-detector/core.d.ts

@@ -0,0 +1,46 @@
+import type { ProjectApp, ApiContract, StackSignatures, ArchPatternsFile, HypermediaDetectionResult, OtelDetectionResult, SupplyChainReport, LlmDetectionResult, LocalFirstDetectionResult, DetectedLibraries } from '../../types/index.js';
+import { detectLanguageVersion } from '../language-detector.js';
+/**
+ * Check if the project is a monorepo by looking for workspace config files.
+ */
+export declare function isMonorepoProject(projectPath: string): Promise<boolean>;
+/**
+ * Detect multiple apps within a project (monorepo or multi-app structure).
+ */
+export declare function detectApps(projectPath: string, signatures: StackSignatures, archConfig?: ArchPatternsFile): Promise<ProjectApp[]>;
+/**
+ * Detect API contracts between apps (OpenAPI, GraphQL, tRPC, gRPC).
+ */
+export declare function detectApiContracts(projectPath: string): Promise<ApiContract[]>;
+export { detectLanguageVersion };
+/**
+ * SPEC-044: Detect OpenTelemetry for a project.
+ * Returns OtelDetectionResult to be stored in knowledge.otelDetection.
+ */
+export declare function detectOtelForProject(projectPath: string): Promise<OtelDetectionResult>;
+/**
+ * SPEC-046: Run supply chain security checks for a project.
+ * Returns SupplyChainReport to be stored in knowledge.supplyChain.
+ */
+export declare function detectSupplyChainForProject(projectPath: string, isGovernmentOrEnterprise?: boolean): Promise<SupplyChainReport>;
+/**
+ * SPEC-043: Detect hypermedia framework and template engine for a project.
+ * Returns enriched HypermediaDetectionResult with templateEngine from the template detector.
+ */
+export declare function detectHypermediaForProject(projectPath: string): Promise<HypermediaDetectionResult>;
+/**
+ * SPEC-045: Detect LLM integration for a project.
+ * Returns LlmDetectionResult to be stored in knowledge.llmDetection.
+ */
+export declare function detectLlmForProject(projectPath: string): Promise<LlmDetectionResult>;
+/**
+ * SPEC-047: Detect local-first architecture signals for a project.
+ * Returns LocalFirstDetectionResult to be stored in knowledge.localFirst.
+ */
+export declare function detectLocalFirstForProject(projectPath: string): Promise<LocalFirstDetectionResult>;
+/**
+ * SPEC-004 tech-debt: Detect key libraries for Python and Node.js ecosystems.
+ * Returns DetectedLibraries to be stored in knowledge.detectedLibraries.
+ */
+export declare function detectLibrariesForProject(projectPath: string): Promise<DetectedLibraries>;
+//# sourceMappingURL=core.d.ts.map

package/dist/engine/multi-app-detector/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/engine/multi-app-detector/core.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,UAAU,EAEV,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,yBAAyB,EACzB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAkB,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAiBhF;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAsC7E;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,eAAe,EAC3B,UAAU,CAAC,EAAE,gBAAgB,GAC5B,OAAO,CAAC,UAAU,EAAE,CAAC,CAkCvB;AAwDD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA2BpF;AAED,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAE5F;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,MAAM,EACnB,wBAAwB,CAAC,EAAE,OAAO,GACjC,OAAO,CAAC,iBAAiB,CAAC,CAE5B;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,yBAAyB,CAAC,CAqBpC;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAE1F;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,yBAAyB,CAAC,CAGpC;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAE/F"}