nexarch 0.8.2 → 0.8.9

package/dist/commands/init-agent.js

@@ -1,12 +1,12 @@
 import { arch, homedir, hostname, platform, release, type as osType, userInfo } from "os";
-import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "fs";
+import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "fs";
 import { join } from "path";
 import process from "process";
 import { requireCredentials } from "../lib/credentials.js";
 import { fetchAgentRegistryOrThrow } from "../lib/agent-registry.js";
 import { callMcpTool, mcpInitialize, mcpListTools } from "../lib/mcp.js";
 import { buildVersionAttributes } from "../lib/version-normalization.js";
-const CLI_VERSION = "0.5.12";
+const CLI_VERSION = "0.8.4";
 const AGENT_ENTITY_TYPE = "agent";
 const TECH_COMPONENT_ENTITY_TYPE = "technology_component";
 function parseFlag(args, flag) {
@@ -62,17 +62,80 @@ function detectLikelyApplicationInCwd() {
         "build.gradle",
         "build.gradle.kts",
     ];
-    const evidence = files.filter((file) => existsSync(join(cwd, file)));
+    const skipDirs = new Set([
+        ".git",
+        "node_modules",
+        "dist",
+        "build",
+        ".next",
+        ".turbo",
+        "coverage",
+        "tmp",
+        ".cache",
+        "target",
+        "vendor",
+        ".venv",
+        "venv",
+        "__pycache__",
+    ]);
+    const evidence = new Set();
+    const checkDir = (baseDir, relativePrefix = "") => {
+        for (const file of files) {
+            if (existsSync(join(baseDir, file))) {
+                evidence.add(`${relativePrefix}${file}`);
+            }
+        }
+        try {
+            const entries = readdirSync(baseDir);
+            if (entries.some((name) => name.toLowerCase().endsWith(".csproj"))) {
+                evidence.add(`${relativePrefix}*.csproj`);
+            }
+        }
+        catch {
+            // non-fatal; ignore
+        }
+    };
+    // Level 0: current directory
+    checkDir(cwd);
+    // Levels 1-2: monorepo children
     try {
-        const entries = readdirSync(cwd);
-        if (entries.some((name) => name.toLowerCase().endsWith(".csproj"))) {
-            evidence.push("*.csproj");
+        for (const l1 of readdirSync(cwd)) {
+            if (l1.startsWith(".") || skipDirs.has(l1))
+                continue;
+            const l1Path = join(cwd, l1);
+            try {
+                if (!statSync(l1Path).isDirectory())
+                    continue;
+            }
+            catch {
+                continue;
+            }
+            checkDir(l1Path, `${l1}/`);
+            try {
+                for (const l2 of readdirSync(l1Path)) {
+                    if (l2.startsWith(".") || skipDirs.has(l2))
+                        continue;
+                    const l2Path = join(l1Path, l2);
+                    try {
+                        if (!statSync(l2Path).isDirectory())
+                            continue;
+                    }
+                    catch {
+                        continue;
+                    }
+                    checkDir(l2Path, `${l1}/${l2}/`);
+                }
+            }
+            catch {
+                // ignore
+            }
         }
     }
     catch {
-        // non-fatal; ignore
+        // ignore
     }
-    return { detected: evidence.length > 0, evidence };
+    const evidenceList = Array.from(evidence);
+    return { detected: evidenceList.length > 0, evidence: evidenceList };
 }
 function getSanitizedHostname(redactHostname) {
     const raw = hostname() || "unknown-host";

package/dist/commands/init-project.js

@@ -489,24 +489,19 @@ function resolveWorkspaceDirs(rootDir, workspaces) {
     }
     return dirs;
 }
-// Collect all package.json paths: root + workspace packages + 2-level fallback
+// Collect all package.json paths: root + workspace packages + fallback scans.
 function findPackageJsonPaths(rootDir) {
     const paths = [];
+    const seen = new Set();
     const rootPkgPath = join(rootDir, "package.json");
-    if (!existsSync(rootPkgPath))
-        return paths;
-    paths.push(rootPkgPath);
-    const rootPkg = readRootPackage(rootPkgPath);
-    if (rootPkg.workspaces) {
-        // Workspace monorepo: resolve workspace dirs and find their package.json files
-        for (const wsDir of resolveWorkspaceDirs(rootDir, rootPkg.workspaces)) {
-            const pkgPath = join(wsDir, "package.json");
-            if (existsSync(pkgPath))
-                paths.push(pkgPath);
-        }
-    }
-    else {
-        // Non-workspace: scan up to 2 levels deep
+    const pushPath = (pkgPath) => {
+        const norm = pkgPath.replace(/\\/g, "/");
+        if (seen.has(norm))
+            return;
+        seen.add(norm);
+        paths.push(pkgPath);
+    };
+    const scanTwoLevels = () => {
         try {
             for (const l1 of readdirSync(rootDir)) {
                 if (SKIP_DIRS.has(l1) || l1.startsWith("."))
@@ -517,7 +512,7 @@ function findPackageJsonPaths(rootDir) {
                         continue;
                     const l1Pkg = join(l1Path, "package.json");
                     if (existsSync(l1Pkg)) {
-                        paths.push(l1Pkg);
+                        pushPath(l1Pkg);
                         continue;
                     }
                     for (const l2 of readdirSync(l1Path)) {
@@ -529,7 +524,7 @@ function findPackageJsonPaths(rootDir) {
                                 continue;
                             const l2Pkg = join(l2Path, "package.json");
                             if (existsSync(l2Pkg))
-                                paths.push(l2Pkg);
+                                pushPath(l2Pkg);
                         }
                         catch { }
                     }
@@ -538,7 +533,23 @@ function findPackageJsonPaths(rootDir) {
             }
         }
         catch { }
+    };
+    if (existsSync(rootPkgPath)) {
+        pushPath(rootPkgPath);
+        const rootPkg = readRootPackage(rootPkgPath);
+        if (rootPkg.workspaces) {
+            for (const wsDir of resolveWorkspaceDirs(rootDir, rootPkg.workspaces)) {
+                const pkgPath = join(wsDir, "package.json");
+                if (existsSync(pkgPath))
+                    pushPath(pkgPath);
+            }
+        }
+        // Keep fallback in case workspace globs are incomplete.
+        scanTwoLevels();
+        return paths;
     }
+    // No root package.json: still detect monorepos/components by scanning children.
+    scanTwoLevels();
     return paths;
 }
 // ─── Ecosystem scanners ───────────────────────────────────────────────────────
@@ -880,7 +891,13 @@ export async function initProject(args) {
     for (const sp of subPackages) {
         const nameSlug = slugify(sp.name);
         const needsPrefix = !sp.name.includes("/") && !nameSlug.startsWith(projectSlug);
-        sp.externalKey = `${sp.entityType}:${needsPrefix ? `${projectSlug}-${nameSlug}` : nameSlug}`;
+        let keySlug = needsPrefix ? `${projectSlug}-${nameSlug}` : nameSlug;
+        // Avoid key collision with the top-level project (e.g. sub-package named "nexarch").
+        if (`${sp.entityType}:${keySlug}` === projectExternalKey) {
+            const relSlug = slugify(sp.relativePath.replace(/\//g, "-"));
+            keySlug = relSlug ? `${projectSlug}-${relSlug}` : `${projectSlug}-${nameSlug}-sub`;
+        }
+        sp.externalKey = `${sp.entityType}:${keySlug}`;
     }
     if (!asJson) {
         console.log(`  Project : ${displayName} (${entityTypeOverride})`);
@@ -1238,7 +1255,55 @@ ${subPackages.map((sp) => {
             return `    • ${sp.name} (--from "${sp.externalKey}"):\n${lines.join("\n")}`;
         }).join("\n\n")}
 `;
-        const finalStep = subPackages.length > 0 ? "STEP 4" : "STEP 3";
+        const adrStepNumber = subPackages.length > 0 ? "STEP 4" : "STEP 3";
+        const finalStep = subPackages.length > 0 ? "STEP 5" : "STEP 4";
+        const adrSection = `
+${adrStepNumber} — Ask the enrichment agent to extract ADRs and register decision records.
+
+  Do NOT rely on init-project to parse ADR files. The enrichment agent should read ADR markdown and
+  explicitly register decision records with relationships.
+
+  Agent task:
+    • Find ADR files (e.g. docs/adr, adrs, decisions, ADR-*.md)
+    • For each ADR, create/update a decision record entity
+    • Link it using: decision_record --decides--> application/sub-app
+
+  REQUIRED fields to pass per decision:
+    • key:      decision_record:<project>-<adr-slug>
+    • subtype:  decision_architecture
+    • name:     ADR title
+    • description: MUST be rich text (Markdown), not plain key/value text.
+      Use this exact Markdown structure so the web portal renders cleanly:
+
+      ## ADR Metadata
+      - **ADR-ID:** <id/filename slug>
+      - **Status:** <proposed|accepted|superseded|deprecated|...>
+      - **Date:** <YYYY-MM-DD or source value>
+      - **Deciders:** <comma-separated names/roles>
+      - **Source Path:** <repo-relative path>
+
+      ## Context
+      <1-2 lines>
+
+      ## Decision
+      <1-3 lines>
+
+      ## Consequences
+      <1-3 lines>
+
+  Command pattern:
+    npx nexarch update-entity \\
+      --key "decision_record:<project>-<adr-slug>" \\
+      --entity-type "decision_record" \\
+      --subtype "decision_architecture" \\
+      --name "<ADR title>" \\
+      --description "## ADR Metadata\n- **ADR-ID:** <id>\n- **Status:** <status>\n- **Date:** <date>\n- **Deciders:** <deciders>\n- **Source Path:** <path>\n\n## Context\n<context>\n\n## Decision\n<decision>\n\n## Consequences\n<consequences>"
+
+    npx nexarch add-relationship \\
+      --from "decision_record:<project>-<adr-slug>" \\
+      --to "<application-or-sub-app-key>" \\
+      --type "decides"
+`;
         const gapCheckSection = `
 ${finalStep} — Identify architecturally significant components not auto-detected.
 
@@ -1307,7 +1372,7 @@ STEP 2 — Enrich the project entity. Run this command with the description you'
     --entity-type "${entityTypeOverride}"${entityTypeOverride === "application" ? " \\\n    --subtype \"app_custom_built\" \\\n    --icon \"<curated icon>\"" : ""} \\
     --name "<proper product name from README>" \\
     --description "<2–4 sentence summary of what it does and why>"
-${subPkgSection}${gapCheckSection}`;
+${subPkgSection}${adrSection}${gapCheckSection}`;
     }
     const enrichmentTask = {
         instructions: buildEnrichmentInstructions(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexarch",
-  "version": "0.8.2",
+  "version": "0.8.9",
   "description": "Your architecture workspace for AI delivery.",
   "keywords": [
     "nexarch",