@thelogicatelier/sylva 1.0.4 → 1.0.10

package/dist/prompts.js

@@ -4,6 +4,7 @@ exports.EXTRACT_AGENTS_SECTIONS_SIGNATURE = exports.COMPILE_CONVENTIONS_SIGNATUR
 const ax_1 = require("@ax-llm/ax");
 exports.CODEBASE_ANALYSIS_SIGNATURE = (0, ax_1.f)()
     .input("sourceContext", ax_1.f.string())
+    .input("awarenessContext", ax_1.f.string("Deterministically detected framework/architecture constraints from repo manifest files. Treat this as AUTHORITATIVE — do not contradict it. Use detected stacks and versions; mark unknown/ambiguous when appropriate."))
     .output("projectOverview", ax_1.f.string("Project Overview & Context: Exhaustively describe all primary sub-services, their purpose, and what languages or frameworks power them."))
     .output("agentPersona", ax_1.f.string("Agent Persona / Role"))
     .output("techStack", ax_1.f.string("Tech Stack & Versions: List EVERY distinct language, library, database, and external API dependency used. WARNING: Do NOT guess frameworks based on assumptions or the presence of a package.json. You must explicitly scan the actual code files (e.g. imports in .py, .ts, .js) and dependency manifests (e.g. requirements.txt, go.mod) to determine the EXACT tech stack."))
@@ -25,7 +26,7 @@ exports.CODEBASE_ANALYSIS_SIGNATURE = (0, ax_1.f)()
     .build();
 exports.CODEBASE_ANALYZER_IDENTITY = {
     name: "CodebaseAnalyzer",
-    description: "A hyper-detailed technical architect generating strict developer manifests. You must analyze the structural backbone, data flow, and day-to-day coding conventions of the application using recursive analysis of the source code. NEVER hallucinate frameworks; always verify by scanning actual source imports and dependency files.",
+    description: "A hyper-detailed technical architect generating strict developer manifests. You must analyze the structural backbone, data flow, and day-to-day coding conventions of the application using recursive analysis of the source code. NEVER hallucinate frameworks; always verify by scanning actual source imports and dependency files. CRITICAL: You will receive an awarenessContext field containing ARCHITECTURE CONSTRAINTS derived from deterministic manifest analysis. Treat these constraints as AUTHORITATIVE. Do not contradict them. Do not invent frameworks, languages, entrypoints, or tooling not present in the evidence. If OpenClaw is detected as orchestrator, include an OpenClaw Runtime section and treat other stacks as workloads/subagents. Use detected stack and versions; mark unknown/ambiguous when appropriate.",
 };
 exports.COMPILE_CONVENTIONS_SIGNATURE = (0, ax_1.f)()
     .input("projectOverview", ax_1.f.string("Project Overview & Context."))
@@ -46,11 +47,13 @@ exports.COMPILE_CONVENTIONS_SIGNATURE = (0, ax_1.f)()
     .input("documentationStandards", ax_1.f.string("Documentation Standards."))
     .input("agentWorkflow", ax_1.f.string("Agent Workflow / SOP."))
     .input("fewShotExamples", ax_1.f.string("Few-Shot Examples."))
-    .output("markdownDocument", ax_1.f.string("Comprehensive CODEBASE_CONVENTIONS.md document formatted with clear headings, bullet points, and specific code/file snippets as evidence."))
+    .input("awarenessContext", ax_1.f.string("ARCHITECTURE CONSTRAINTS (AUTHORITATIVE): Deterministically detected frameworks, versions, and architecture from manifest files. Do NOT contradict these constraints in the compiled output. The compiled conventions MUST reflect the detected stacks, version certainty levels, and orchestrator/workload structure exactly as specified. If OpenClaw is the orchestrator, the conventions must describe the OpenClaw runtime and its workloads."))
+    .output("markdownDocument", ax_1.f.string("Comprehensive CODEBASE_CONVENTIONS.md document formatted with clear headings, bullet points, and specific code/file snippets as evidence. The document MUST align with the ARCHITECTURE CONSTRAINTS provided in awarenessContext."))
     .build();
 exports.EXTRACT_AGENTS_SECTIONS_SIGNATURE = (0, ax_1.f)()
     .input("conventionsMarkdown", ax_1.f.string("The extracted architectural, data flow, and granular coding conventions"))
     .input("repositoryName", ax_1.f.string("The name of the repository or project"))
+    .input("awarenessContext", ax_1.f.string("Deterministically detected framework/architecture constraints. AUTHORITATIVE — do not contradict. If OpenClaw orchestrator is present, include OpenClaw Runtime section. Show version certainty for each framework. Include Framework References when web refs are available."))
     .output("projectOverview", ax_1.f.string("Comprehensive description of the project: what it does, its tech stack, its primary languages, and its overall purpose and functionality."))
     .output("techStack", ax_1.f.string("Explicit and exhaustive list of supported languages, frameworks, UI libraries, backend runtimes, and tools used in the repository. Annotate what each technology is used for (e.g., 'X Framework for UI', 'Y Language for REST Services')."))
     .output("architecture", ax_1.f.string("Deep mapping of where things live: directory layout, key modules, entry points, and their responsibilities. You MUST generate an ASCII diagram showing the architecture, module relationships, and sub-services. Break down complex monorepos explicitly (e.g., separating frontend code vs backend code)."))

package/dist/utils.js

@@ -60,7 +60,7 @@ function loadSourceTree(rootDir) {
             stat = fs.statSync(fullPath);
         }
         catch {
-            console.log(`Failed to parse file: ${fullPath}, skipping.`);
+            console.warn(`⚠️  Cannot read ${fullPath} (permission denied or broken symlink) — skipping.`);
             continue;
         }
         if (stat.isDirectory()) {
@@ -82,11 +82,13 @@ function loadSourceTree(rootDir) {
                     tree[entry] = content;
                 }
                 else {
-                    console.warn(`File ${fullPath} skipped due to being too large (${content.length} chars)`);
+                    console.warn(`⚠️  Skipping ${entry}: file is too large (${(content.length / 1000).toFixed(0)}K chars, limit is 500K).\n` +
+                        `   Consider adding this file to .gitignore if it's generated.`);
                 }
             }
             catch (error) {
-                console.warn(`File ${fullPath} skipped due to read/encoding issues: ${error.message}`);
+                console.warn(`⚠️  Skipping ${entry}: could not read file — ${error.message}\n` +
+                    `   This may be a binary file or use an unsupported encoding.`);
             }
         }
     }
@@ -112,9 +114,12 @@ function cloneRepo(repoUrl, destDir) {
         (0, child_process_1.execSync)(`git clone --depth 1 ${repoUrl} ${destDir}`, { stdio: "pipe" });
     }
     catch (error) {
-        console.error(`Failed to clone repository: ${error.message}`);
+        console.error(`❌ Failed to clone repository: ${error.message}\n` +
+            `   URL: ${repoUrl}\n` +
+            `   Destination: ${destDir}\n` +
+            `   Ensure the URL is correct, the repo is public or you have access, and git is installed.`);
         if (error.stderr)
-            console.error(error.stderr.toString());
+            console.error(`   Git stderr: ${error.stderr.toString().trim()}`);
         throw new Error("Git clone failed", { cause: error });
     }
 }
@@ -136,7 +141,8 @@ function saveAgentsToDisk(repoName, agentsContent, baseDir = "projects") {
         console.log(`✅ Successfully saved AGENTS.md to: ${filePath}`);
     }
     catch (error) {
-        console.error(`Failed to save AGENTS.md to ${filePath}: ${error.message}`);
+        console.error(`❌ Failed to save AGENTS.md to ${filePath}: ${error.message}\n` +
+            `   Check that the output directory exists and you have write permissions.`);
     }
 }
 const AGENTS_SECTION_HEADINGS = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thelogicatelier/sylva",
-  "version": "1.0.4",
+  "version": "1.0.10",
   "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": {
@@ -63,4 +63,4 @@
     "prettier": "^3.8.1",
     "typescript-eslint": "^8.56.1"
   }
-}
+}