@thelogicatelier/sylva 1.0.12 → 1.0.13

package/dist/awareness/braveSearch.js

@@ -83,21 +83,24 @@ async function braveSearch(query, options) {
         });
         if (!response.ok) {
             const statusText = response.statusText || "Unknown error";
+            const errorMsg = `HTTP ${response.status} (${statusText})`;
             if (response.status === 401 || response.status === 403) {
                 console.warn(`❌ Brave Search API authentication failed (HTTP ${response.status}: ${statusText}).\n` +
                     `   Your BRAVE_API_KEY may be invalid or expired.\n` +
                     `   Get a valid key at: https://brave.com/search/api/\n` +
                     `   Framework detection still works — only web doc references are affected.`);
+                throw new Error(`Authentication failed ${errorMsg}. Valid API key required.`);
             }
             else if (response.status === 429) {
                 console.warn(`⚠️  Brave Search API rate limit exceeded (HTTP 429).\n` +
                     `   Query: "${query}"\n` +
                     `   Wait a moment and retry, or check your Brave API plan limits.`);
+                throw new Error(`Rate limit exceeded ${errorMsg}.`);
             }
             else {
                 console.warn(`⚠️  Brave Search API returned HTTP ${response.status} (${statusText}) for query: "${query}"`);
+                throw new Error(`Brave Search API error: ${errorMsg}`);
             }
-            return [];
         }
         const data = (await response.json());
         const webResults = data.web?.results || [];
@@ -120,10 +123,10 @@ async function braveSearch(query, options) {
             console.warn(`⚠️  Brave Search network error for query "${query}": ${errMsg}\n` +
                 `   Check your internet connection. Framework detection is unaffected.`);
         }
-        else {
+        else if (!errMsg.includes("HTTP")) {
             console.warn(`⚠️  Brave Search failed for query "${query}": ${errMsg}`);
         }
-        return [];
+        throw error;
     }
 }
 /**

package/dist/awareness/detector.d.ts

@@ -3,6 +3,7 @@
  * Deterministic — no LLM involvement.
  */
 import { Signal, StackInfo, ArchitectureModel, VersionInfo } from "./types";
+/** Confidence scoring rules */
 /**
  * Detect stacks from signals.
  * Groups signals by frameworkId and scores confidence.

package/dist/awareness/detector.js

@@ -8,37 +8,8 @@ exports.detectStacks = detectStacks;
 exports.detectArchitecture = detectArchitecture;
 exports.formatVersionForDisplay = formatVersionForDisplay;
 const versionResolver_1 = require("./versionResolver");
+const constants_1 = require("../constants");
 /** Confidence scoring rules */
-const CONFIDENCE_SCORES = {
-    orchestrator: 95,
-    angular: 85,
-    react: 80,
-    nextjs: 85,
-    vue: 80,
-    nuxt: 85,
-    svelte: 80,
-    sveltekit: 85,
-    express: 75,
-    nestjs: 85,
-    fastify: 75,
-    django: 85,
-    flask: 75,
-    fastapi: 80,
-    "spring-boot": 90,
-    spring: 80,
-    "java-maven": 70,
-    "java-gradle": 70,
-    dotnet: 80,
-    "aspnet-core": 85,
-    go: 80,
-    rust: 80,
-    "actix-web": 85,
-    axum: 85,
-    nodejs: 60,
-    python: 60,
-    typescript: 65,
-    docker: 50,
-};
 /**
  * Detect stacks from signals.
  * Groups signals by frameworkId and scores confidence.
@@ -55,7 +26,8 @@ function detectStacks(signals) {
             signal.kind === "cron" ||
             signal.kind === "hook" ||
             signal.kind === "skill" ||
-            signal.kind === "plugin")
+            signal.kind === "plugin" ||
+            signal.kind === "integration")
             continue;
         if (!grouped.has(signal.frameworkId)) {
             grouped.set(signal.frameworkId, []);
@@ -65,7 +37,7 @@ function detectStacks(signals) {
     const stacks = [];
     for (const [frameworkId, frameworkSignals] of grouped) {
         const frameworkName = frameworkSignals[0].frameworkName;
-        const confidence = CONFIDENCE_SCORES[frameworkId] || 50;
+        const confidence = constants_1.CONFIDENCE_SCORES[frameworkId] || 50;
         const version = (0, versionResolver_1.resolveVersion)(frameworkSignals);
         // Determine rootPath — use the shallowest signal's scope
         const rootPaths = frameworkSignals.map((s) => s.scope.pathRoot).filter(Boolean);

package/dist/awareness/index.js

@@ -46,6 +46,7 @@ const manifestParsers_1 = require("./manifestParsers");
 const versionResolver_1 = require("./versionResolver");
 const detector_1 = require("./detector");
 const webGrounding_1 = require("./webGrounding");
+const sourceScanner_1 = require("./sourceScanner");
 /**
  * The ARCHITECTURE CONSTRAINTS block injected into LLM context.
  * This is authoritative and must not be overridden by the model.
@@ -82,6 +83,15 @@ function buildConstraintsBlock(stacks, resolvedVersions, hasOrchestrator, signal
     if (hasOrchestrator) {
         appendOpenClawConstraints(lines, signals);
     }
+    // External Integrations (source code scanner)
+    const integrations = signals.filter((s) => s.kind === "integration");
+    if (integrations.length > 0) {
+        lines.push("", "EXTERNAL INTEGRATIONS (Discovered in Source Code):");
+        for (const sig of integrations) {
+            lines.push(`  - ${sig.frameworkName}`);
+            lines.push(`    Evidence: ${sig.evidence.reason} [${sig.evidence.file}]`);
+        }
+    }
     lines.push("=== END ARCHITECTURE CONSTRAINTS ===");
     return lines.join("\n");
 }
@@ -311,8 +321,16 @@ async function runAwareness(repoPath, repoName) {
     }
     // Step 2: Parse all manifests into signals
     console.log("  → Parsing manifests...");
-    const signals = (0, manifestParsers_1.parseAllManifests)(manifests);
-    console.log(`  → Generated ${signals.length} signal(s)`);
+    const manifestSignals = (0, manifestParsers_1.parseAllManifests)(manifests);
+    console.log(`  → Generated ${manifestSignals.length} signal(s) from manifests`);
+    // Step 2.5: Scan source code for external integrations
+    console.log("  → Scanning source code for external integrations...");
+    const integrationSignals = (0, sourceScanner_1.scanSourceFiles)(repoPath);
+    if (integrationSignals.length > 0) {
+        console.log(`  → Discovered ${integrationSignals.length} integration(s) in source code`);
+    }
+    // Merge all signals
+    const signals = [...manifestSignals, ...integrationSignals];
     // Step 3: Resolve versions
     console.log("  → Resolving versions...");
     const resolvedVersions = (0, versionResolver_1.resolveAllVersions)(signals);

package/dist/awareness/manifestParsers/goParsers.js

@@ -40,16 +40,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseGoMod = parseGoMod;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-/** Known Go frameworks/libraries */
-const GO_FRAMEWORKS = [
-    { module: "github.com/gin-gonic/gin", frameworkId: "gin", frameworkName: "Gin" },
-    { module: "github.com/labstack/echo", frameworkId: "echo", frameworkName: "Echo" },
-    { module: "github.com/gofiber/fiber", frameworkId: "fiber", frameworkName: "Fiber" },
-    { module: "github.com/gorilla/mux", frameworkId: "gorilla-mux", frameworkName: "Gorilla Mux" },
-    { module: "gorm.io/gorm", frameworkId: "gorm", frameworkName: "GORM" },
-    { module: "github.com/stretchr/testify", frameworkId: "testify", frameworkName: "Testify" },
-    { module: "google.golang.org/grpc", frameworkId: "grpc-go", frameworkName: "gRPC-Go" },
-];
+const constants_1 = require("../../constants");
 /**
  * Parse go.mod
  */
@@ -117,7 +108,7 @@ function parseGoMod(manifest) {
             continue;
         const modulePath = match[1];
         const version = match[2];
-        const framework = GO_FRAMEWORKS.find((f) => modulePath.startsWith(f.module));
+        const framework = constants_1.GO_FRAMEWORKS.find((f) => modulePath.startsWith(f.module));
         if (framework) {
             signals.push({
                 kind: "framework",

package/dist/awareness/manifestParsers/javaParsers.js

@@ -41,25 +41,7 @@ exports.parsePomXml = parsePomXml;
 exports.parseBuildGradle = parseBuildGradle;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-/** Known Java frameworks */
-const JAVA_FRAMEWORKS = [
-    {
-        groupArtifact: "org.springframework.boot",
-        frameworkId: "spring-boot",
-        frameworkName: "Spring Boot",
-    },
-    {
-        groupArtifact: "org.springframework",
-        frameworkId: "spring",
-        frameworkName: "Spring Framework",
-    },
-    { groupArtifact: "io.quarkus", frameworkId: "quarkus", frameworkName: "Quarkus" },
-    { groupArtifact: "io.micronaut", frameworkId: "micronaut", frameworkName: "Micronaut" },
-    { groupArtifact: "org.hibernate", frameworkId: "hibernate", frameworkName: "Hibernate" },
-    { groupArtifact: "junit", frameworkId: "junit", frameworkName: "JUnit" },
-    { groupArtifact: "org.junit", frameworkId: "junit5", frameworkName: "JUnit 5" },
-    { groupArtifact: "org.apache.kafka", frameworkId: "kafka", frameworkName: "Apache Kafka" },
-];
+const constants_1 = require("../../constants");
 /**
  * Parse pom.xml (Maven)
  */
@@ -108,7 +90,7 @@ function parsePomXml(manifest) {
     if (parentMatch) {
         const parentGroup = parentMatch[1];
         const parentVersion = parentMatch[2];
-        const framework = JAVA_FRAMEWORKS.find((f) => parentGroup.includes(f.groupArtifact));
+        const framework = constants_1.JAVA_FRAMEWORKS.find((f) => parentGroup.includes(f.groupArtifact));
         if (framework) {
             const resolvedVersion = parentVersion.startsWith("${")
                 ? properties[parentVersion.slice(2, -1)]
@@ -141,7 +123,7 @@ function parsePomXml(manifest) {
         const groupId = depMatch[1];
         const artifactId = depMatch[2];
         const version = depMatch[3];
-        const framework = JAVA_FRAMEWORKS.find((f) => groupId.includes(f.groupArtifact));
+        const framework = constants_1.JAVA_FRAMEWORKS.find((f) => groupId.includes(f.groupArtifact));
         if (framework) {
             let versionInfo;
             if (version) {
@@ -223,7 +205,7 @@ function parseBuildGradle(manifest) {
     while ((m = depRegex.exec(content)) !== null) {
         const groupId = m[1];
         const version = m[3];
-        const framework = JAVA_FRAMEWORKS.find((f) => groupId.includes(f.groupArtifact));
+        const framework = constants_1.JAVA_FRAMEWORKS.find((f) => groupId.includes(f.groupArtifact));
         if (framework) {
             signals.push({
                 kind: "framework",

package/dist/awareness/manifestParsers/packageJsonParser.js

@@ -41,29 +41,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.parsePackageJson = parsePackageJson;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-/** Framework detection rules: dep name patterns → framework info */
-const FRAMEWORK_DETECTION_RULES = [
-    { depPattern: "@angular/core", frameworkId: "angular", frameworkName: "Angular" },
-    { depPattern: "react", frameworkId: "react", frameworkName: "React" },
-    { depPattern: "react-dom", frameworkId: "react-dom", frameworkName: "React DOM" },
-    { depPattern: "next", frameworkId: "nextjs", frameworkName: "Next.js" },
-    { depPattern: "vue", frameworkId: "vue", frameworkName: "Vue.js" },
-    { depPattern: "nuxt", frameworkId: "nuxt", frameworkName: "Nuxt" },
-    { depPattern: "@sveltejs/kit", frameworkId: "sveltekit", frameworkName: "SvelteKit" },
-    { depPattern: "svelte", frameworkId: "svelte", frameworkName: "Svelte" },
-    { depPattern: "express", frameworkId: "express", frameworkName: "Express" },
-    { depPattern: "@nestjs/core", frameworkId: "nestjs", frameworkName: "NestJS" },
-    { depPattern: "fastify", frameworkId: "fastify", frameworkName: "Fastify" },
-    { depPattern: "koa", frameworkId: "koa", frameworkName: "Koa" },
-    { depPattern: "typescript", frameworkId: "typescript", frameworkName: "TypeScript" },
-    { depPattern: "@ax-llm/ax", frameworkId: "ax-llm", frameworkName: "Ax-LLM" },
-    { depPattern: "electron", frameworkId: "electron", frameworkName: "Electron" },
-    { depPattern: "react-native", frameworkId: "react-native", frameworkName: "React Native" },
-    { depPattern: "tailwindcss", frameworkId: "tailwindcss", frameworkName: "Tailwind CSS" },
-    { depPattern: "vite", frameworkId: "vite", frameworkName: "Vite" },
-    { depPattern: "webpack", frameworkId: "webpack", frameworkName: "Webpack" },
-    { depPattern: "esbuild", frameworkId: "esbuild", frameworkName: "esbuild" },
-];
+const constants_1 = require("../../constants");
 /**
  * Determine version certainty from a semver-like string.
  */
@@ -126,7 +104,7 @@ function parsePackageJson(manifest) {
         scope: { pathRoot: rootPath },
     });
     // Detect frameworks from dependencies
-    for (const rule of FRAMEWORK_DETECTION_RULES) {
+    for (const rule of constants_1.NPM_FRAMEWORKS) {
         const depName = typeof rule.depPattern === "string" ? rule.depPattern : undefined;
         let matchedDep;
         let matchedVersion;

package/dist/awareness/manifestParsers/pythonParsers.js

@@ -43,23 +43,7 @@ exports.parsePipfile = parsePipfile;
 exports.parseSetupCfg = parseSetupCfg;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-/** Known Python frameworks and their detection patterns */
-const PYTHON_FRAMEWORKS = [
-    { pkg: "django", frameworkId: "django", frameworkName: "Django" },
-    { pkg: "flask", frameworkId: "flask", frameworkName: "Flask" },
-    { pkg: "fastapi", frameworkId: "fastapi", frameworkName: "FastAPI" },
-    { pkg: "uvicorn", frameworkId: "uvicorn", frameworkName: "Uvicorn" },
-    { pkg: "starlette", frameworkId: "starlette", frameworkName: "Starlette" },
-    { pkg: "celery", frameworkId: "celery", frameworkName: "Celery" },
-    { pkg: "sqlalchemy", frameworkId: "sqlalchemy", frameworkName: "SQLAlchemy" },
-    { pkg: "pandas", frameworkId: "pandas", frameworkName: "Pandas" },
-    { pkg: "numpy", frameworkId: "numpy", frameworkName: "NumPy" },
-    { pkg: "tensorflow", frameworkId: "tensorflow", frameworkName: "TensorFlow" },
-    { pkg: "torch", frameworkId: "pytorch", frameworkName: "PyTorch" },
-    { pkg: "scikit-learn", frameworkId: "scikit-learn", frameworkName: "scikit-learn" },
-    { pkg: "pytest", frameworkId: "pytest", frameworkName: "pytest" },
-    { pkg: "gunicorn", frameworkId: "gunicorn", frameworkName: "Gunicorn" },
-];
+const constants_1 = require("../../constants");
 function parsePythonVersion(versionSpec, sourceFile, pkgName) {
     if (!versionSpec || versionSpec.trim() === "") {
         return { certainty: "unknown", sourceFile, notes: `No version for ${pkgName}` };
@@ -110,7 +94,7 @@ function parseRequirementsTxt(manifest) {
             continue;
         const pkgName = match[1].toLowerCase();
         const versionSpec = match[2] || "";
-        const framework = PYTHON_FRAMEWORKS.find((f) => f.pkg === pkgName);
+        const framework = constants_1.PYTHON_FRAMEWORKS.find((f) => f.pkg === pkgName);
         if (framework) {
             const versionInfo = parsePythonVersion(versionSpec, manifest.relativePath, pkgName);
             signals.push({
@@ -179,7 +163,7 @@ function parsePyprojectToml(manifest) {
             if (simpleMatch) {
                 const pkgName = simpleMatch[1].toLowerCase();
                 const versionSpec = simpleMatch[2];
-                const framework = PYTHON_FRAMEWORKS.find((f) => f.pkg === pkgName);
+                const framework = constants_1.PYTHON_FRAMEWORKS.find((f) => f.pkg === pkgName);
                 if (framework) {
                     const isPinned = /^\d+\.\d+/.test(versionSpec) && !/[><=~^]/.test(versionSpec);
                     const versionInfo = isPinned
@@ -266,7 +250,7 @@ function parsePipfile(manifest) {
             const match = line.trim().match(/^([a-zA-Z0-9_.-]+)\s*=\s*"([^"]*)"/);
             if (match) {
                 const pkgName = match[1].toLowerCase();
-                const framework = PYTHON_FRAMEWORKS.find((f) => f.pkg === pkgName);
+                const framework = constants_1.PYTHON_FRAMEWORKS.find((f) => f.pkg === pkgName);
                 if (framework) {
                     const versionSpec = match[2];
                     const isExact = versionSpec === "*" ? false : /^\d+\.\d+/.test(versionSpec);
@@ -321,7 +305,7 @@ function parseSetupCfg(manifest) {
             const match = trimmed.match(/^([a-zA-Z0-9_.-]+)\s*([><=~!]+.*)?$/);
             if (match) {
                 const pkgName = match[1].toLowerCase();
-                const framework = PYTHON_FRAMEWORKS.find((f) => f.pkg === pkgName);
+                const framework = constants_1.PYTHON_FRAMEWORKS.find((f) => f.pkg === pkgName);
                 if (framework) {
                     const versionInfo = parsePythonVersion(match[2] || "", manifest.relativePath, pkgName);
                     signals.push({

package/dist/awareness/manifestParsers/rustParsers.js

@@ -40,17 +40,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseCargoToml = parseCargoToml;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-/** Known Rust frameworks/libraries */
-const RUST_FRAMEWORKS = [
-    { crate: "actix-web", frameworkId: "actix-web", frameworkName: "Actix Web" },
-    { crate: "rocket", frameworkId: "rocket", frameworkName: "Rocket" },
-    { crate: "axum", frameworkId: "axum", frameworkName: "Axum" },
-    { crate: "tokio", frameworkId: "tokio", frameworkName: "Tokio" },
-    { crate: "serde", frameworkId: "serde", frameworkName: "Serde" },
-    { crate: "diesel", frameworkId: "diesel", frameworkName: "Diesel" },
-    { crate: "sqlx", frameworkId: "sqlx", frameworkName: "SQLx" },
-    { crate: "warp", frameworkId: "warp", frameworkName: "Warp" },
-];
+const constants_1 = require("../../constants");
 /**
  * Parse Cargo.toml
  */
@@ -117,7 +107,7 @@ function parseCargoToml(manifest) {
             }
             if (!crateName)
                 continue;
-            const framework = RUST_FRAMEWORKS.find((f) => f.crate === crateName);
+            const framework = constants_1.RUST_FRAMEWORKS.find((f) => f.crate === crateName);
             if (framework) {
                 let versionInfo;
                 if (versionStr) {

package/dist/awareness/manifestScanner.js

@@ -41,81 +41,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.scanManifests = scanManifests;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const constants_1 = require("../constants");
 /** Directories to skip during scanning */
-const SCAN_IGNORE_DIRS = new Set([
-    ".git",
-    "node_modules",
-    "__pycache__",
-    "venv",
-    ".venv",
-    "env",
-    ".env",
-    "dist",
-    "build",
-    "target",
-    "vendor",
-    "bin",
-    "obj",
-    "out",
-    "coverage",
-    "logs",
-    "tmp",
-    "temp",
-    ".idea",
-    ".vscode",
-    ".next",
-    ".nuxt",
-    ".svelte-kit",
-    ".angular",
-    ".DS_Store",
-]);
+const IGNORE_DIRS_SET = new Set(constants_1.SCAN_IGNORE_DIRS);
 /** Exact filenames to match as manifests */
-const MANIFEST_EXACT_NAMES = new Set([
-    "package.json",
-    "package-lock.json",
-    "yarn.lock",
-    "pnpm-lock.yaml",
-    "openclaw.json",
-    ".openclaw.json",
-    "angular.json",
-    "workspace.json",
-    "project.json",
-    "pyproject.toml",
-    "requirements.txt",
-    "poetry.lock",
-    "Pipfile",
-    "Pipfile.lock",
-    "setup.cfg",
-    "setup.py",
-    "pom.xml",
-    "build.gradle",
-    "build.gradle.kts",
-    "settings.gradle",
-    "settings.gradle.kts",
-    "gradle.properties",
-    "go.mod",
-    "go.sum",
-    "Cargo.toml",
-    "Cargo.lock",
-    "global.json",
-    "packages.lock.json",
-    "Dockerfile",
-    "docker-compose.yml",
-    "docker-compose.yaml",
-    "Makefile",
-    ".gitlab-ci.yml",
-]);
-/** File extension patterns for manifests (e.g. *.csproj) */
-const MANIFEST_EXTENSION_PATTERNS = [".csproj", ".fsproj", ".vbproj"];
-/** Maximum file size in characters to read */
-const MAX_FILE_SIZE = 500_000;
+const MANIFEST_EXACT_NAMES = new Set(constants_1.MANIFEST_EXACT_NAMES);
 /**
  * Check if a filename matches a known manifest pattern.
  */
 function isManifestFile(filename) {
     if (MANIFEST_EXACT_NAMES.has(filename))
         return true;
-    for (const ext of MANIFEST_EXTENSION_PATTERNS) {
+    for (const ext of constants_1.MANIFEST_EXTENSION_PATTERNS) {
         if (filename.endsWith(ext))
             return true;
     }
@@ -142,7 +79,7 @@ function scanManifests(repoPath) {
         }
         for (const entry of entries) {
             // Skip ignored directories and hidden dirs (except specific manifest patterns)
-            if (SCAN_IGNORE_DIRS.has(entry))
+            if (IGNORE_DIRS_SET.has(entry))
                 continue;
             const fullPath = path.join(dir, entry);
             let stat;
@@ -160,7 +97,11 @@ function scanManifests(repoPath) {
                 walk(fullPath, depth + 1);
             }
             else if (stat.isFile()) {
-                if (isManifestFile(entry) && stat.size <= MAX_FILE_SIZE) {
+                if (isManifestFile(entry)) {
+                    if (stat.size > constants_1.MAX_MANIFEST_FILE_SIZE) {
+                        // File is too large, skip it
+                        continue;
+                    }
                     results.push({
                         absolutePath: fullPath,
                         relativePath: path.relative(absoluteRoot, fullPath),

package/dist/awareness/sourceScanner.d.ts

@@ -0,0 +1,5 @@
+import { Signal } from "./types";
+/**
+ * Scan source codebase for integrations.
+ */
+export declare function scanSourceFiles(rootPath: string): Signal[];

package/dist/awareness/sourceScanner.js

@@ -0,0 +1,179 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanSourceFiles = scanSourceFiles;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const ignore_1 = __importDefault(require("ignore"));
+const constants_1 = require("../constants");
+const MAX_SCAN_FILES = 200;
+const MAX_LINES_PER_FILE = 500;
+/**
+ * Loads .gitignore rules from the root if available
+ */
+function loadGitIgnore(rootPath) {
+    const ig = (0, ignore_1.default)();
+    // Add hardcoded global ignores
+    for (const item of constants_1.SCAN_IGNORE_DIRS)
+        ig.add(`**/${item}/**`);
+    for (const item of constants_1.ALWAYS_IGNORE_FILES)
+        ig.add(`**/${item}`);
+    ig.add("**/*.env*"); // Cover all .env permutations globally
+    try {
+        const gitignorePath = path.join(rootPath, ".gitignore");
+        if (fs.existsSync(gitignorePath)) {
+            const content = fs.readFileSync(gitignorePath, "utf-8");
+            ig.add(content);
+        }
+    }
+    catch {
+        // Ignore errors reading .gitignore
+    }
+    return ig;
+}
+/**
+ * Collect source files sequentially via BFS
+ */
+function collectSourceFiles(dir, ig, rootPath, files = []) {
+    if (files.length >= MAX_SCAN_FILES)
+        return files;
+    try {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (files.length >= MAX_SCAN_FILES)
+                break;
+            const fullPath = path.join(dir, entry.name);
+            // Ensure posix path for gitignore matching
+            const relPath = path.relative(rootPath, fullPath).split(path.sep).join(path.posix.sep);
+            // Skip ignored files/directories
+            // Note: ignore().ignores() requires directory paths to end with '/' to match properly sometimes,
+            // but relPath works fine for most rules.
+            if (ig.ignores(relPath))
+                continue;
+            if (entry.isDirectory()) {
+                if (!ig.ignores(relPath + "/")) {
+                    collectSourceFiles(fullPath, ig, rootPath, files);
+                }
+            }
+            else if (entry.isFile()) {
+                const ext = path.extname(entry.name).toLowerCase();
+                if (constants_1.SOURCE_EXTENSIONS.includes(ext)) {
+                    files.push(fullPath);
+                }
+            }
+        }
+    }
+    catch {
+        // access errors skipped
+    }
+    return files;
+}
+/**
+ * Heuristic: check if this phrase occurs in the text
+ */
+function matchPatterns(content, patterns = []) {
+    for (const pat of patterns) {
+        if (content.includes(pat))
+            return pat;
+    }
+    return null;
+}
+/**
+ * Scan source codebase for integrations.
+ */
+function scanSourceFiles(rootPath) {
+    const ig = loadGitIgnore(rootPath);
+    const targetFiles = collectSourceFiles(rootPath, ig, rootPath);
+    const signals = [];
+    const detectedIntegrationIds = new Set();
+    for (const file of targetFiles) {
+        try {
+            // Read file and limit to N lines to keep it fast
+            const contentRaw = fs.readFileSync(file, "utf-8");
+            let content = contentRaw;
+            const lines = contentRaw.split("\n");
+            if (lines.length > MAX_LINES_PER_FILE) {
+                content = lines.slice(0, MAX_LINES_PER_FILE).join("\n");
+            }
+            // Check all integrations against this chunk
+            for (const integration of constants_1.INTEGRATIONS) {
+                if (detectedIntegrationIds.has(integration.id))
+                    continue; // Found it already somewhere
+                let reason = "";
+                let matchedPattern = "";
+                matchedPattern = matchPatterns(content, integration.urlPatterns) || "";
+                if (matchedPattern) {
+                    reason = `Found API URL pattern "${matchedPattern}"`;
+                }
+                else {
+                    matchedPattern = matchPatterns(content, integration.importPatterns) || "";
+                    if (matchedPattern) {
+                        reason = `Found SDK import pattern "${matchedPattern}"`;
+                    }
+                    else {
+                        matchedPattern = matchPatterns(content, integration.envPatterns) || "";
+                        if (matchedPattern) {
+                            reason = `Found env var reference "${matchedPattern}"`;
+                        }
+                    }
+                }
+                if (reason) {
+                    detectedIntegrationIds.add(integration.id);
+                    signals.push({
+                        kind: "integration",
+                        frameworkId: integration.id,
+                        frameworkName: integration.name,
+                        version: { certainty: "unknown", value: undefined },
+                        evidence: {
+                            file: path.relative(rootPath, file),
+                            reason: `Source code scanner detected ${integration.name}: ${reason}`,
+                        },
+                        scope: { pathRoot: rootPath },
+                    });
+                }
+            }
+            // If we found everything, stop scanning
+            if (detectedIntegrationIds.size === constants_1.INTEGRATIONS.length)
+                break;
+        }
+        catch {
+            // Ignore unreadable files
+        }
+    }
+    return signals;
+}

package/dist/awareness/types.d.ts

@@ -13,7 +13,7 @@ export interface VersionInfo {
     notes?: string;
 }
 /** Signal kinds emitted by manifest parsers */
-export type SignalKind = "framework" | "version" | "orchestrator" | "entrypoint" | "tooling" | "agent" | "subagent" | "heartbeat" | "cron" | "hook" | "skill" | "plugin";
+export type SignalKind = "framework" | "version" | "orchestrator" | "entrypoint" | "tooling" | "agent" | "subagent" | "heartbeat" | "cron" | "hook" | "skill" | "plugin" | "integration";
 /** Evidence for a detected signal */
 export interface SignalEvidence {
     file: string;

package/dist/constants.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Shared programmatic constants and integration registries for Sylva.
+ */
 export interface ModelMetadata {
     provider: string;
     tier: "primary" | "mini";
@@ -16,3 +19,44 @@ export declare const IGNORED_DIRS: Set<string>;
  * source tree so the AI reads them FIRST, preventing framework hallucination.
  */
 export declare const DEPENDENCY_MANIFESTS: Set<string>;
+export interface IntegrationDef {
+    id: string;
+    name: string;
+    urlPatterns?: string[];
+    importPatterns?: string[];
+    envPatterns?: string[];
+}
+export declare const INTEGRATIONS: IntegrationDef[];
+export declare const SOURCE_EXTENSIONS: string[];
+export declare const SCAN_IGNORE_DIRS: string[];
+export declare const ALWAYS_IGNORE_FILES: string[];
+export declare const MANIFEST_EXACT_NAMES: string[];
+export declare const MANIFEST_EXTENSION_PATTERNS: string[];
+export declare const MAX_MANIFEST_FILE_SIZE = 500000;
+/** Confidence scoring rules mapped by framework ID */
+export declare const CONFIDENCE_SCORES: Record<string, number>;
+export declare const NPM_FRAMEWORKS: {
+    depPattern: string | RegExp;
+    frameworkId: string;
+    frameworkName: string;
+}[];
+export declare const PYTHON_FRAMEWORKS: {
+    pkg: string;
+    frameworkId: string;
+    frameworkName: string;
+}[];
+export declare const JAVA_FRAMEWORKS: {
+    groupArtifact: string;
+    frameworkId: string;
+    frameworkName: string;
+}[];
+export declare const GO_FRAMEWORKS: {
+    module: string;
+    frameworkId: string;
+    frameworkName: string;
+}[];
+export declare const RUST_FRAMEWORKS: {
+    crate: string;
+    frameworkId: string;
+    frameworkName: string;
+}[];

package/dist/constants.js

@@ -1,6 +1,9 @@
 "use strict";
+/**
+ * Shared programmatic constants and integration registries for Sylva.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEPENDENCY_MANIFESTS = exports.IGNORED_DIRS = exports.ALLOWED_EXTENSIONS = exports.API_KEY_ENV_VARS = exports.DEFAULT_MINI_MODELS = exports.DEFAULT_MODELS = exports.MODEL_CATALOG = exports.PROVIDER_OPENAI = exports.PROVIDER_ANTHROPIC = exports.PROVIDER_GEMINI = void 0;
+exports.RUST_FRAMEWORKS = exports.GO_FRAMEWORKS = exports.JAVA_FRAMEWORKS = exports.PYTHON_FRAMEWORKS = exports.NPM_FRAMEWORKS = exports.CONFIDENCE_SCORES = exports.MAX_MANIFEST_FILE_SIZE = exports.MANIFEST_EXTENSION_PATTERNS = exports.MANIFEST_EXACT_NAMES = exports.ALWAYS_IGNORE_FILES = exports.SCAN_IGNORE_DIRS = exports.SOURCE_EXTENSIONS = exports.INTEGRATIONS = exports.DEPENDENCY_MANIFESTS = exports.IGNORED_DIRS = exports.ALLOWED_EXTENSIONS = exports.API_KEY_ENV_VARS = exports.DEFAULT_MINI_MODELS = exports.DEFAULT_MODELS = exports.MODEL_CATALOG = exports.PROVIDER_OPENAI = exports.PROVIDER_ANTHROPIC = exports.PROVIDER_GEMINI = void 0;
 exports.PROVIDER_GEMINI = "gemini";
 exports.PROVIDER_ANTHROPIC = "anthropic";
 exports.PROVIDER_OPENAI = "openai";
@@ -131,3 +134,327 @@ exports.DEPENDENCY_MANIFESTS = new Set([
     "Cargo.lock",
     "go.mod",
 ]);
+exports.INTEGRATIONS = [
+    // E-commerce & Headless
+    {
+        id: "wix",
+        name: "Wix Headless",
+        urlPatterns: ["wixapis.com", "wixstatic.com"],
+        envPatterns: ["WIX_API_KEY", "WIX_SITE_ID", "WIX_CLIENT_ID"],
+    },
+    {
+        id: "stripe",
+        name: "Stripe",
+        importPatterns: ["stripe", "@stripe/stripe-js"],
+        urlPatterns: ["api.stripe.com"],
+        envPatterns: ["STRIPE_SECRET_KEY", "STRIPE_PUBLISHABLE_KEY"],
+    },
+    // Cloud Providers
+    {
+        id: "aws",
+        name: "AWS",
+        importPatterns: ["boto3", "aws-sdk", "@aws-sdk"],
+        envPatterns: ["AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY", "AWS_REGION", "AWS_DEFAULT_REGION"],
+    },
+    {
+        id: "azure",
+        name: "Microsoft Azure",
+        importPatterns: ["azure", "@azure"],
+        urlPatterns: ["windows.net", "azure.com"],
+        envPatterns: ["AZURE_CLIENT_ID", "AZURE_TENANT_ID"],
+    },
+    {
+        id: "gcp",
+        name: "Google Cloud",
+        importPatterns: ["google-cloud", "@google-cloud"],
+        urlPatterns: ["googleapis.com"],
+        envPatterns: ["GOOGLE_APPLICATION_CREDENTIALS"],
+    },
+    // Hosting & Edge
+    {
+        id: "vercel",
+        name: "Vercel",
+        importPatterns: ["@vercel"],
+        envPatterns: ["VERCEL_URL", "VERCEL_PROJECT_ID"],
+    },
+    {
+        id: "netlify",
+        name: "Netlify",
+        importPatterns: ["@netlify"],
+        envPatterns: ["NETLIFY", "URL"],
+    },
+    {
+        id: "cloudflare",
+        name: "Cloudflare",
+        importPatterns: ["cloudflare", "@cloudflare"],
+        envPatterns: ["CLOUDFLARE_API_TOKEN", "CLOUDFLARE_ACCOUNT_ID"],
+    },
+    // Firebase
+    {
+        id: "firebase",
+        name: "Firebase",
+        importPatterns: ["firebase", "firebase-admin"],
+        urlPatterns: ["firebaseio.com", "firebasestorage.googleapis.com"],
+        envPatterns: ["FIREBASE_API_KEY", "FIREBASE_PROJECT_ID"],
+    },
+    // Social & Graph
+    {
+        id: "instagram-api",
+        name: "Instagram Graph API",
+        urlPatterns: ["graph.instagram.com", "graph.facebook.com"],
+        envPatterns: ["INSTAGRAM_ACCESS_TOKEN", "INSTAGRAM_ACCOUNT_ID"],
+    },
+    // AI & LLMs
+    {
+        id: "openai",
+        name: "OpenAI",
+        importPatterns: ["openai"],
+        urlPatterns: ["api.openai.com"],
+        envPatterns: ["OPENAI_API_KEY"],
+    },
+    {
+        id: "anthropic",
+        name: "Anthropic",
+        importPatterns: ["@anthropic-ai", "anthropic"],
+        urlPatterns: ["api.anthropic.com"],
+        envPatterns: ["ANTHROPIC_API_KEY"],
+    },
+    // Comms
+    {
+        id: "twilio",
+        name: "Twilio",
+        importPatterns: ["twilio"],
+        urlPatterns: ["api.twilio.com"],
+        envPatterns: ["TWILIO_ACCOUNT_SID", "TWILIO_AUTH_TOKEN"],
+    },
+    {
+        id: "sendgrid",
+        name: "SendGrid",
+        importPatterns: ["sendgrid", "@sendgrid"],
+        envPatterns: ["SENDGRID_API_KEY"],
+    },
+    // Databases & BaaS
+    {
+        id: "mongodb",
+        name: "MongoDB",
+        importPatterns: ["mongoose", "pymongo", "mongodb"],
+        urlPatterns: ["mongodb.net", "mongodb+srv"],
+        envPatterns: ["MONGO_URI", "MONGODB_URI"],
+    },
+    {
+        id: "redis",
+        name: "Redis",
+        importPatterns: ["redis", "ioredis"],
+        urlPatterns: ["redis://", "rediss://"],
+        envPatterns: ["REDIS_URL"],
+    },
+    {
+        id: "supabase",
+        name: "Supabase",
+        importPatterns: ["supabase", "@supabase/supabase-js"],
+        urlPatterns: ["supabase.co"],
+        envPatterns: ["SUPABASE_URL", "SUPABASE_ANON_KEY"],
+    },
+];
+// Reusable array of generic source file extensions to scan
+exports.SOURCE_EXTENSIONS = [
+    ".py",
+    ".ts",
+    ".js",
+    ".go",
+    ".rs",
+    ".java",
+    ".rb",
+    ".php",
+    ".tsx",
+    ".jsx",
+    ".cs",
+    ".cpp",
+    ".c",
+    ".swift",
+    ".kt",
+];
+// Shared directories to skip matching globally (used by manifest and source scanners)
+exports.SCAN_IGNORE_DIRS = [
+    ".git",
+    "node_modules",
+    "__pycache__",
+    "venv",
+    ".venv",
+    "env",
+    ".env",
+    "dist",
+    "build",
+    "target",
+    "vendor",
+    "bin",
+    "obj",
+    "out",
+    ".output",
+    "coverage",
+    "logs",
+    "tmp",
+    "temp",
+    ".idea",
+    ".vscode",
+    ".next",
+    ".nuxt",
+    ".svelte-kit",
+    ".angular",
+    ".DS_Store",
+    "public",
+];
+// NEVER extract .env files
+exports.ALWAYS_IGNORE_FILES = [
+    ".env",
+    ".env.local",
+    ".env.development",
+    ".env.production",
+    ".env.test",
+];
+// Exact filenames to match as manifests
+exports.MANIFEST_EXACT_NAMES = [
+    "package.json",
+    "package-lock.json",
+    "yarn.lock",
+    "pnpm-lock.yaml",
+    "openclaw.json",
+    ".openclaw.json",
+    "angular.json",
+    "workspace.json",
+    "project.json",
+    "pyproject.toml",
+    "requirements.txt",
+    "poetry.lock",
+    "Pipfile",
+    "Pipfile.lock",
+    "setup.cfg",
+    "setup.py",
+    "pom.xml",
+    "build.gradle",
+    "build.gradle.kts",
+    "settings.gradle",
+    "settings.gradle.kts",
+    "gradle.properties",
+    "go.mod",
+    "go.sum",
+    "Cargo.toml",
+    "Cargo.lock",
+    "global.json",
+    "packages.lock.json",
+    "Dockerfile",
+    "docker-compose.yml",
+    "docker-compose.yaml",
+    "Makefile",
+    ".gitlab-ci.yml",
+];
+// File extension patterns for manifests (e.g. *.csproj)
+exports.MANIFEST_EXTENSION_PATTERNS = [".csproj", ".fsproj", ".vbproj"];
+// Maximum file size in characters to read for manifests
+exports.MAX_MANIFEST_FILE_SIZE = 500_000;
+/** Confidence scoring rules mapped by framework ID */
+exports.CONFIDENCE_SCORES = {
+    orchestrator: 95,
+    angular: 85,
+    react: 80,
+    nextjs: 85,
+    vue: 80,
+    nuxt: 85,
+    svelte: 80,
+    sveltekit: 85,
+    express: 75,
+    nestjs: 85,
+    fastify: 75,
+    django: 85,
+    flask: 75,
+    fastapi: 80,
+    "spring-boot": 90,
+    spring: 80,
+    "java-maven": 70,
+    "java-gradle": 70,
+    dotnet: 80,
+    "aspnet-core": 85,
+    go: 80,
+    rust: 80,
+    "actix-web": 85,
+    axum: 85,
+    nodejs: 60,
+    python: 60,
+    typescript: 65,
+    docker: 50,
+};
+exports.NPM_FRAMEWORKS = [
+    { depPattern: "@angular/core", frameworkId: "angular", frameworkName: "Angular" },
+    { depPattern: "react", frameworkId: "react", frameworkName: "React" },
+    { depPattern: "react-dom", frameworkId: "react-dom", frameworkName: "React DOM" },
+    { depPattern: "next", frameworkId: "nextjs", frameworkName: "Next.js" },
+    { depPattern: "vue", frameworkId: "vue", frameworkName: "Vue.js" },
+    { depPattern: "nuxt", frameworkId: "nuxt", frameworkName: "Nuxt" },
+    { depPattern: "@sveltejs/kit", frameworkId: "sveltekit", frameworkName: "SvelteKit" },
+    { depPattern: "svelte", frameworkId: "svelte", frameworkName: "Svelte" },
+    { depPattern: "express", frameworkId: "express", frameworkName: "Express" },
+    { depPattern: "@nestjs/core", frameworkId: "nestjs", frameworkName: "NestJS" },
+    { depPattern: "fastify", frameworkId: "fastify", frameworkName: "Fastify" },
+    { depPattern: "koa", frameworkId: "koa", frameworkName: "Koa" },
+    { depPattern: "typescript", frameworkId: "typescript", frameworkName: "TypeScript" },
+    { depPattern: "@ax-llm/ax", frameworkId: "ax-llm", frameworkName: "Ax-LLM" },
+    { depPattern: "electron", frameworkId: "electron", frameworkName: "Electron" },
+    { depPattern: "react-native", frameworkId: "react-native", frameworkName: "React Native" },
+    { depPattern: "tailwindcss", frameworkId: "tailwindcss", frameworkName: "Tailwind CSS" },
+    { depPattern: "vite", frameworkId: "vite", frameworkName: "Vite" },
+    { depPattern: "webpack", frameworkId: "webpack", frameworkName: "Webpack" },
+    { depPattern: "esbuild", frameworkId: "esbuild", frameworkName: "esbuild" },
+];
+exports.PYTHON_FRAMEWORKS = [
+    { pkg: "django", frameworkId: "django", frameworkName: "Django" },
+    { pkg: "flask", frameworkId: "flask", frameworkName: "Flask" },
+    { pkg: "fastapi", frameworkId: "fastapi", frameworkName: "FastAPI" },
+    { pkg: "uvicorn", frameworkId: "uvicorn", frameworkName: "Uvicorn" },
+    { pkg: "starlette", frameworkId: "starlette", frameworkName: "Starlette" },
+    { pkg: "celery", frameworkId: "celery", frameworkName: "Celery" },
+    { pkg: "sqlalchemy", frameworkId: "sqlalchemy", frameworkName: "SQLAlchemy" },
+    { pkg: "pandas", frameworkId: "pandas", frameworkName: "Pandas" },
+    { pkg: "numpy", frameworkId: "numpy", frameworkName: "NumPy" },
+    { pkg: "tensorflow", frameworkId: "tensorflow", frameworkName: "TensorFlow" },
+    { pkg: "torch", frameworkId: "pytorch", frameworkName: "PyTorch" },
+    { pkg: "scikit-learn", frameworkId: "scikit-learn", frameworkName: "scikit-learn" },
+    { pkg: "pytest", frameworkId: "pytest", frameworkName: "pytest" },
+    { pkg: "gunicorn", frameworkId: "gunicorn", frameworkName: "Gunicorn" },
+];
+exports.JAVA_FRAMEWORKS = [
+    {
+        groupArtifact: "org.springframework.boot",
+        frameworkId: "spring-boot",
+        frameworkName: "Spring Boot",
+    },
+    {
+        groupArtifact: "org.springframework",
+        frameworkId: "spring",
+        frameworkName: "Spring Framework",
+    },
+    { groupArtifact: "io.quarkus", frameworkId: "quarkus", frameworkName: "Quarkus" },
+    { groupArtifact: "io.micronaut", frameworkId: "micronaut", frameworkName: "Micronaut" },
+    { groupArtifact: "org.hibernate", frameworkId: "hibernate", frameworkName: "Hibernate" },
+    { groupArtifact: "junit", frameworkId: "junit", frameworkName: "JUnit" },
+    { groupArtifact: "org.junit", frameworkId: "junit5", frameworkName: "JUnit 5" },
+    { groupArtifact: "org.apache.kafka", frameworkId: "kafka", frameworkName: "Apache Kafka" },
+];
+exports.GO_FRAMEWORKS = [
+    { module: "github.com/gin-gonic/gin", frameworkId: "gin", frameworkName: "Gin" },
+    { module: "github.com/labstack/echo", frameworkId: "echo", frameworkName: "Echo" },
+    { module: "github.com/gofiber/fiber", frameworkId: "fiber", frameworkName: "Fiber" },
+    { module: "github.com/gorilla/mux", frameworkId: "gorilla-mux", frameworkName: "Gorilla Mux" },
+    { module: "gorm.io/gorm", frameworkId: "gorm", frameworkName: "GORM" },
+    { module: "github.com/stretchr/testify", frameworkId: "testify", frameworkName: "Testify" },
+    { module: "google.golang.org/grpc", frameworkId: "grpc-go", frameworkName: "gRPC-Go" },
+];
+exports.RUST_FRAMEWORKS = [
+    { crate: "actix-web", frameworkId: "actix-web", frameworkName: "Actix Web" },
+    { crate: "rocket", frameworkId: "rocket", frameworkName: "Rocket" },
+    { crate: "axum", frameworkId: "axum", frameworkName: "Axum" },
+    { crate: "tokio", frameworkId: "tokio", frameworkName: "Tokio" },
+    { crate: "serde", frameworkId: "serde", frameworkName: "Serde" },
+    { crate: "diesel", frameworkId: "diesel", frameworkName: "Diesel" },
+    { crate: "sqlx", frameworkId: "sqlx", frameworkName: "SQLx" },
+    { crate: "warp", frameworkId: "warp", frameworkName: "Warp" },
+];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thelogicatelier/sylva",
-  "version": "1.0.12",
+  "version": "1.0.13",
   "description": "Auto-generate AGENTS.md for your repository using Ax-LLM. Analyze the structural backbone, data flow, and day-to-day coding conventions natively.",
   "main": "dist/index.js",
   "bin": {
@@ -50,6 +50,7 @@
     "@ax-llm/ax": "^19.0.2",
     "commander": "^14.0.3",
     "dotenv": "^17.3.1",
+    "ignore": "^7.0.5",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"
@@ -63,4 +64,4 @@
     "prettier": "^3.8.1",
     "typescript-eslint": "^8.56.1"
   }
-}
+}