@archpilotlabs/archpilot 0.0.18 → 0.0.19

package/README.md

@@ -8,19 +8,19 @@
   Architecture guardrails for AI-native software development
 </p>
 
-ArchPilot validates your repository against architecture rules and helps engineering teams move faster with AI-assisted development-without sacrificing architectural integrity.
+ArchPilot validates your repository against architecture rules, helping engineering teams move faster with AI-assisted development without sacrificing architectural integrity.
 
 **Your AI writes code. ArchPilot protects architecture.**
 
 <p align="center">
-  Validate • Enforce • Measure architecture continuously
+  Validate | Enforce | Measure architecture continuously
 </p>
 
 ArchPilot makes architecture **visible, enforceable, and measurable** as your system evolves.
 
 ---
 
-## 🧭 Why this exists
+## Why this exists
 
 Most teams rely on documentation or tribal knowledge to maintain architecture.
 
@@ -28,83 +28,85 @@ Over time, boundaries blur, dependencies leak, and architectural decisions drift
 
 ArchPilot turns architecture into something you can **actually validate, enforce, and track continuously**.
 
-AI accelerates code delivery-but architectural drift accelerates too.
+AI accelerates code delivery but architectural drift can accelerate too.
 
 ArchPilot gives teams deterministic architecture guardrails in local development, CI, and governance workflows.
 
 ---
 
-## 🚀 What it does
+## What it does
 
 ArchPilot turns architecture into something you can actually run and verify:
 
-* Validate module boundaries and dependencies
-* Enforce architecture rules and contracts
-* Detect architectural drift over time
-* Generate architecture scores and reports
-* Surface architecture feedback in PRs and CI
+- Validate module boundaries and dependencies
+- Enforce architecture rules and contracts
+- Detect architectural drift over time
+- Generate architecture scores and reports
+- Surface architecture feedback in PRs and CI
 
 No runtime agents. No external services. Fully deterministic and local-first.
 
+ArchPilot works alongside GitHub Copilot, Claude Code, Codex, Cursor, and other AI coding tools by continuously validating architectural boundaries before architectural drift becomes technical debt.
+
 ---
 
-## 🧩 Supported Stacks
+## Supported Stacks
 
 ArchPilot supports **practical deterministic architecture detection** across modern application stacks.
 
 ### Backend
 
-* Node.js / TypeScript
-* NestJS
-* Express.js
-* Java
-* Spring / Spring Boot
-* Kotlin
-* FastAPI
-* Django
-* Flask
-* PHP
-* Laravel
-* Go
-* .NET
-* Ruby on Rails
+- Node.js / TypeScript
+- NestJS
+- Express.js
+- Java
+- Spring / Spring Boot
+- Kotlin
+- FastAPI
+- Django
+- Flask
+- PHP
+- Laravel
+- Go
+- .NET
+- Ruby on Rails
 
 ### Frontend
 
-* React
-* Next.js
-* Angular
-* Vue
+- React
+- Next.js
+- Angular
+- Vue
 
 ### Infrastructure
 
-* Terraform
-* Ansible
+- Terraform
+- Ansible
 
-ArchPilot detects stack shape from practical repository evidence - framework markers, manifests, project layout, and source structure - then applies conservative architecture discovery defaults locally.
+ArchPilot detects application stacks from practical repository evidence - framework markers, manifests, project layout, and source structure - then applies conservative architecture discovery defaults locally.
 
 **No cloud scanning. No remote indexing. Deterministic local validation.**
 
 ---
 
-## ☁️ Local-first. Cloud-powered.
+## Local-first. Cloud-powered.
 
 Start locally in minutes:
 
-* Offline validation
-* Local reports and artifacts
-* PR review markdown
-* CI validation
-* Deterministic architecture checks
+- Offline validation
+- Local reports and artifacts
+- PR review markdown
+- CI validation
+- Deterministic architecture checks
 
 Then connect to **ArchPilot Cloud** to unlock:
 
-* Repository history and trends
-* Findings dashboards
-* Team ownership and governance workflows
-* Shared policies and exceptions
-* Organization-wide architecture visibility
-* Continuous governance across repositories
+- Repository history and trends
+- Findings dashboards
+- Team ownership and governance workflows
+- Shared policies and exceptions
+- Organization-wide architecture visibility
+- Continuous governance across repositories
 
 ```bash
 archpilot cloud status
@@ -114,14 +116,15 @@ archpilot cloud disconnect
 
 Cloud setup only asks for your API token.
 
-ArchPilot uses the canonical production API automatically-no server URL setup required for normal use.
+ArchPilot uses the canonical production API automatically; no server URL setup is required for normal use.
+
 Learn more:
 
 https://archpilot.org/docs
 
 ---
 
-## 📦 Installation
+## Installation
 
 Install globally:
 
@@ -137,7 +140,7 @@ npx @archpilotlabs/archpilot --help
 
 ---
 
-## ⚡ Quick Start
+## Quick Start
 
 ### 1. Initialize architecture
 
@@ -183,24 +186,24 @@ Applies safe, deterministic fixes for missing architecture artifacts.
 archpilot validate --ci
 ```
 
-* Fails only on real architecture violations
-* Keeps setup issues separate from architecture quality
+- Fails only on real architecture violations
+- Keeps setup issues separate from architecture quality
 
 ---
 
-## 🧑‍💻 CLI vs VS Code Extension
+## CLI vs VS Code Extension
 
 ArchPilot works in two ways:
 
-* **CLI (this package)** → validation, CI, automation
-* **VS Code Extension** → visual inspector, guided workflows, and architecture exploration
+- **CLI (this package)** - validation, CI, automation
+- **VS Code Extension** - visual inspector, guided workflows, and architecture exploration
 
 Both use the same validation engine and produce identical results.
 The extension enhances developer experience, but is not required.
 
 ---
 
-## 🧠 Key Concepts
+## Key Concepts
 
 ### Architecture Health Score
 
@@ -212,13 +215,13 @@ Tracks completeness of configuration and onboarding.
 
 ### Findings
 
-* **violation** → real architecture issue
-* **setup-gap** → missing config / skipped checks
-* **guidance** → non-blocking recommendation
+- **violation** - real architecture issue
+- **setup-gap** - missing config / skipped checks
+- **guidance** - non-blocking recommendation
 
 ---
 
-## 🔍 Core Commands
+## Core Commands
 
 ```bash
 archpilot init
@@ -247,37 +250,38 @@ archpilot governance upload
 
 ---
 
-## ⚙️ Core Capabilities
+## Core Capabilities
 
-* Architecture-as-code (`.archpilot/`)
-* Dependency validation and module contracts
-* ADR (Architecture Decision Record) support
-* Drift detection and history tracking
-* PR review and CI integration
-* Architecture scoring and reporting
+- Architecture-as-code (`.archpilot/`)
+- Smart Init architecture discovery
+- Dependency validation and module contracts
+- ADR (Architecture Decision Record) support
+- Drift detection and history tracking
+- PR review and CI integration
+- Architecture scoring and reporting
 
 ---
 
-## 🎯 Philosophy
+## Philosophy
 
 ArchPilot is built on four principles:
 
-* Architecture should be explicit
-* Rules should be executable
-* Validation should be deterministic
-* Feedback should be continuous
+- Architecture should be explicit
+- Rules should be executable
+- Validation should be deterministic
+- Feedback should be continuous
 
 ---
 
-## 📄 License
+## License
 
 Proprietary. See LICENSE file for details.
 
 ---
 
-## 🌐 Learn More
+## Learn More
 
-* Website: https://archpilot.org
-* Documentation: https://archpilot.org/docs
+- Website: https://archpilot.org
+- Documentation: https://archpilot.org/docs
 
 ---

package/dist/archpilot-cli.js

@@ -8635,7 +8635,7 @@ ${lanes.join("\n")}
             watchDirectory,
             preferNonRecursiveWatch: !fsSupportsRecursiveFsWatch,
             resolvePath: (path71) => _path.resolve(path71),
-            fileExists: fileExists5,
+            fileExists: fileExists6,
             directoryExists: directoryExists2,
             getAccessibleFileSystemEntries,
             createDirectory(directoryName) {
@@ -8797,7 +8797,7 @@ ${lanes.join("\n")}
             if (platform === "win32" || platform === "win64") {
               return false;
             }
-            return !fileExists5(swapCase(__filename));
+            return !fileExists6(swapCase(__filename));
           }
           function swapCase(s) {
             return s.replace(/\w/g, (ch) => {
@@ -8930,7 +8930,7 @@ ${lanes.join("\n")}
                 return false;
             }
           }
-          function fileExists5(path71) {
+          function fileExists6(path71) {
             return fileSystemEntryExists(
               path71,
               0
@@ -134756,7 +134756,7 @@ ${lanes.join("\n")}
         const getCanonicalFileName = createGetCanonicalFileName(useCaseSensitiveFileNames2);
         return {
           useCaseSensitiveFileNames: useCaseSensitiveFileNames2,
-          fileExists: fileExists5,
+          fileExists: fileExists6,
           readFile: (path71, encoding) => host.readFile(path71, encoding),
           directoryExists: host.directoryExists && directoryExists2,
           getDirectories,
@@ -134842,7 +134842,7 @@ ${lanes.join("\n")}
           }
           return host.writeFile(fileName, data, writeByteOrderMark);
         }
-        function fileExists5(fileName) {
+        function fileExists6(fileName) {
           const path71 = toPath3(fileName);
           const result = getCachedFileSystemEntriesForBaseDir(path71);
           return result && hasEntry(result.sortedAndCanonicalizedFiles, getCanonicalFileName(getBaseNameOfFileName(fileName))) || host.fileExists(fileName);
@@ -135261,10 +135261,10 @@ ${lanes.join("\n")}
       function closeFileWatcherOf(objWithWatcher) {
         objWithWatcher.watcher.close();
       }
-      function findConfigFile(searchPath, fileExists5, configName = "tsconfig.json") {
+      function findConfigFile(searchPath, fileExists6, configName = "tsconfig.json") {
         return forEachAncestorDirectory(searchPath, (ancestor) => {
           const fileName = combinePaths(ancestor, configName);
-          return fileExists5(fileName) ? fileName : void 0;
+          return fileExists6(fileName) ? fileName : void 0;
         });
       }
       function resolveTripleslashReference(moduleName, containingFile) {
@@ -135871,14 +135871,14 @@ ${lanes.join("\n")}
         }
         return { file, pos, end, packageId };
       }
-      function isProgramUptoDate(program, rootFileNames, newOptions, getSourceVersion, fileExists5, hasInvalidatedResolutions, hasInvalidatedLibResolutions, hasChangedAutomaticTypeDirectiveNames, getParsedCommandLine, projectReferences) {
+      function isProgramUptoDate(program, rootFileNames, newOptions, getSourceVersion, fileExists6, hasInvalidatedResolutions, hasInvalidatedLibResolutions, hasChangedAutomaticTypeDirectiveNames, getParsedCommandLine, projectReferences) {
         if (!program || (hasChangedAutomaticTypeDirectiveNames == null ? void 0 : hasChangedAutomaticTypeDirectiveNames())) return false;
         if (!arrayIsEqualTo(program.getRootFileNames(), rootFileNames)) return false;
         let seenResolvedRefs;
         if (!arrayIsEqualTo(program.getProjectReferences(), projectReferences, projectReferenceUptoDate)) return false;
         if (program.getSourceFiles().some(sourceFileNotUptoDate)) return false;
         const missingPaths = program.getMissingFilePaths();
-        if (missingPaths && forEachEntry(missingPaths, fileExists5)) return false;
+        if (missingPaths && forEachEntry(missingPaths, fileExists6)) return false;
         const currentOptions = program.getCompilerOptions();
         if (!compareDataObjects(currentOptions, newOptions)) return false;
         if (program.resolvedLibReferences && forEachEntry(program.resolvedLibReferences, (_value, libFileName) => hasInvalidatedLibResolutions(libFileName))) return false;
@@ -136206,7 +136206,7 @@ ${lanes.join("\n")}
         let mapSourceFileToResolvedRef;
         let mapOutputFileToResolvedRef;
         const useSourceOfProjectReferenceRedirect = !!((_d = host.useSourceOfProjectReferenceRedirect) == null ? void 0 : _d.call(host)) && !options.disableSourceOfProjectReferenceRedirect;
-        const { onProgramCreateComplete, fileExists: fileExists5, directoryExists: directoryExists2 } = updateHostForUseSourceOfProjectReferenceRedirect({
+        const { onProgramCreateComplete, fileExists: fileExists6, directoryExists: directoryExists2 } = updateHostForUseSourceOfProjectReferenceRedirect({
           compilerHost: host,
           getSymlinkCache,
           useSourceOfProjectReferenceRedirect,
@@ -136440,7 +136440,7 @@ ${lanes.join("\n")}
           getImpliedNodeFormatForEmit: getImpliedNodeFormatForEmit2,
           shouldTransformImportCall,
           emitBuildInfo,
-          fileExists: fileExists5,
+          fileExists: fileExists6,
           readFile,
           directoryExists: directoryExists2,
           getSymlinkCache,
@@ -138939,8 +138939,8 @@ ${lanes.join("\n")}
         const originalDirectoryExists = host.compilerHost.directoryExists;
         const originalGetDirectories = host.compilerHost.getDirectories;
         const originalRealpath = host.compilerHost.realpath;
-        if (!host.useSourceOfProjectReferenceRedirect) return { onProgramCreateComplete: noop, fileExists: fileExists5 };
-        host.compilerHost.fileExists = fileExists5;
+        if (!host.useSourceOfProjectReferenceRedirect) return { onProgramCreateComplete: noop, fileExists: fileExists6 };
+        host.compilerHost.fileExists = fileExists6;
         let directoryExists2;
         if (originalDirectoryExists) {
           directoryExists2 = host.compilerHost.directoryExists = (path71) => {
@@ -138979,13 +138979,13 @@ ${lanes.join("\n")}
             return ((_a = host.getSymlinkCache().getSymlinkedFiles()) == null ? void 0 : _a.get(host.toPath(s))) || originalRealpath.call(host.compilerHost, s);
           };
         }
-        return { onProgramCreateComplete, fileExists: fileExists5, directoryExists: directoryExists2 };
+        return { onProgramCreateComplete, fileExists: fileExists6, directoryExists: directoryExists2 };
         function onProgramCreateComplete() {
           host.compilerHost.fileExists = originalFileExists;
           host.compilerHost.directoryExists = originalDirectoryExists;
           host.compilerHost.getDirectories = originalGetDirectories;
         }
-        function fileExists5(file) {
+        function fileExists6(file) {
           if (originalFileExists.call(host.compilerHost, file)) return true;
           if (!host.getResolvedProjectReferences()) return false;
           if (!isDeclarationFileName(file)) return false;
@@ -143337,7 +143337,7 @@ ${lanes.join("\n")}
         compilerHost.getSourceFile = (fileName, ...args) => getVersionedSourceFileByPath(fileName, toPath3(fileName), ...args);
         compilerHost.getSourceFileByPath = getVersionedSourceFileByPath;
         compilerHost.getNewLine = () => newLine;
-        compilerHost.fileExists = fileExists5;
+        compilerHost.fileExists = fileExists6;
         compilerHost.onReleaseOldSourceFile = onReleaseOldSourceFile;
         compilerHost.onReleaseParsedCommandLine = onReleaseParsedCommandLine;
         compilerHost.toPath = toPath3;
@@ -143541,7 +143541,7 @@ ${lanes.join("\n")}
         function isFilePresenceUnknownOnHost(hostSourceFile) {
           return typeof hostSourceFile.version === "boolean";
         }
-        function fileExists5(fileName) {
+        function fileExists6(fileName) {
           const path71 = toPath3(fileName);
           if (isFileMissingOnHost(sourceFilesCache.get(path71))) {
             return false;
@@ -150510,15 +150510,15 @@ ${lanes.join("\n")}
         }
         return true;
       }
-      function getMappedLocation(location, sourceMapper, fileExists5) {
+      function getMappedLocation(location, sourceMapper, fileExists6) {
         const mapsTo = sourceMapper.tryGetSourcePosition(location);
-        return mapsTo && (!fileExists5 || fileExists5(normalizePath26(mapsTo.fileName)) ? mapsTo : void 0);
+        return mapsTo && (!fileExists6 || fileExists6(normalizePath26(mapsTo.fileName)) ? mapsTo : void 0);
       }
-      function getMappedDocumentSpan(documentSpan, sourceMapper, fileExists5) {
+      function getMappedDocumentSpan(documentSpan, sourceMapper, fileExists6) {
         const { fileName, textSpan } = documentSpan;
-        const newPosition = getMappedLocation({ fileName, pos: textSpan.start }, sourceMapper, fileExists5);
+        const newPosition = getMappedLocation({ fileName, pos: textSpan.start }, sourceMapper, fileExists6);
         if (!newPosition) return void 0;
-        const newEndPosition = getMappedLocation({ fileName, pos: textSpan.start + textSpan.length }, sourceMapper, fileExists5);
+        const newEndPosition = getMappedLocation({ fileName, pos: textSpan.start + textSpan.length }, sourceMapper, fileExists6);
         const newLength = newEndPosition ? newEndPosition.pos - newPosition.pos : textSpan.length;
         return {
           fileName: newPosition.fileName,
@@ -150528,20 +150528,20 @@ ${lanes.join("\n")}
           },
           originalFileName: documentSpan.fileName,
           originalTextSpan: documentSpan.textSpan,
-          contextSpan: getMappedContextSpan(documentSpan, sourceMapper, fileExists5),
+          contextSpan: getMappedContextSpan(documentSpan, sourceMapper, fileExists6),
           originalContextSpan: documentSpan.contextSpan
         };
       }
-      function getMappedContextSpan(documentSpan, sourceMapper, fileExists5) {
+      function getMappedContextSpan(documentSpan, sourceMapper, fileExists6) {
         const contextSpanStart = documentSpan.contextSpan && getMappedLocation(
           { fileName: documentSpan.fileName, pos: documentSpan.contextSpan.start },
           sourceMapper,
-          fileExists5
+          fileExists6
         );
         const contextSpanEnd = documentSpan.contextSpan && getMappedLocation(
           { fileName: documentSpan.fileName, pos: documentSpan.contextSpan.start + documentSpan.contextSpan.length },
           sourceMapper,
-          fileExists5
+          fileExists6
         );
         return contextSpanStart && contextSpanEnd ? { start: contextSpanStart.pos, length: contextSpanEnd.pos - contextSpanStart.pos } : void 0;
       }
@@ -199025,9 +199025,9 @@ ${options.prefix}` : "\n" : options.prefix
             this.markContainingProjectsAsDirty();
           }
         }
-        close(fileExists5 = true) {
+        close(fileExists6 = true) {
           this.textStorage.isOpen = false;
-          if (fileExists5 && this.textStorage.scheduleReloadIfNeeded()) {
+          if (fileExists6 && this.textStorage.scheduleReloadIfNeeded()) {
             this.markContainingProjectsAsDirty();
           }
         }
@@ -200131,11 +200131,11 @@ ${options.prefix}` : "\n" : options.prefix
           this.rootFilesMap.set(path71, { fileName });
           this.markAsDirty();
         }
-        removeFile(info, fileExists5, detachFromProject) {
+        removeFile(info, fileExists6, detachFromProject) {
           if (this.isRoot(info)) {
             this.removeRoot(info);
           }
-          if (fileExists5) {
+          if (fileExists6) {
             this.resolutionCache.removeResolutionsOfFile(info.path);
           } else {
             this.resolutionCache.invalidateResolutionOfFile(info.path);
@@ -203005,8 +203005,8 @@ ${options.prefix}` : "\n" : options.prefix
          */
         closeOpenFile(info, skipAssignOrphanScriptInfosToInferredProject) {
           var _a;
-          const fileExists5 = info.isDynamic ? false : this.host.fileExists(info.fileName);
-          info.close(fileExists5);
+          const fileExists6 = info.isDynamic ? false : this.host.fileExists(info.fileName);
+          info.close(fileExists6);
           this.stopWatchingConfigFilesForScriptInfo(info);
           const canonicalFileName = this.toCanonicalFileName(info.fileName);
           if (this.openFilesWithNonRootedDiskPath.get(canonicalFileName) === info) {
@@ -203032,7 +203032,7 @@ ${options.prefix}` : "\n" : options.prefix
               }
               p.removeFile(
                 info,
-                fileExists5,
+                fileExists6,
                 /*detachFromProject*/
                 true
               );
@@ -203048,7 +203048,7 @@ ${options.prefix}` : "\n" : options.prefix
           if (!skipAssignOrphanScriptInfosToInferredProject && ensureProjectsForOpenFiles) {
             this.assignOrphanScriptInfosToInferredProject();
           }
-          if (fileExists5) {
+          if (fileExists6) {
             this.watchClosedScriptInfo(info);
           } else {
             this.handleDeletedFile(
@@ -232861,18 +232861,18 @@ async function previewArch003(context) {
   const directoryPath = path36.join(context.workspaceRoot, "docs", "architecture");
   const filePath = path36.join(directoryPath, "overview.md");
   const directoryExists2 = await pathExists13(directoryPath);
-  const fileExists5 = await pathExists13(filePath);
+  const fileExists6 = await pathExists13(filePath);
   const filesCreated = [];
   if (!directoryExists2) {
     filesCreated.push(relative10(directoryPath, context.workspaceRoot));
   }
-  if (!fileExists5) {
+  if (!fileExists6) {
     filesCreated.push(relative10(filePath, context.workspaceRoot));
   }
   return {
     filesCreated,
     filesModified: [],
-    diffPreview: fileExists5 ? "(no changes)" : `${directoryExists2 ? "" : `+ create directory ${relative10(directoryPath, context.workspaceRoot)}
+    diffPreview: fileExists6 ? "(no changes)" : `${directoryExists2 ? "" : `+ create directory ${relative10(directoryPath, context.workspaceRoot)}
 `}+ ${architectureOverviewStarterTemplate.trimEnd().replace(/\n/g, "\n+ ")}`,
     description: "Create a starter architecture overview document if missing."
   };
@@ -239759,10 +239759,10 @@ function detectProjectKinds(workspaceRoot, options) {
     addSignal("backend", 3, "Found requirements.txt", true);
   }
   if (hasFile("pyproject.toml")) {
-    addSignal("backend", 3, "Found pyproject.toml", true);
+    addSignal("library", 2, "Found pyproject.toml");
   }
   if (hasFile("setup.py")) {
-    addSignal("backend", 3, "Found setup.py", true);
+    addSignal("library", 3, "Found setup.py", true);
   }
   if (hasFile("composer.json")) {
     addSignal("backend", 3, "Found composer.json", true);
@@ -239771,7 +239771,10 @@ function detectProjectKinds(workspaceRoot, options) {
     addSignal("backend", 5, "Found Laravel app-root backend evidence", true);
   }
   if (hasFile("go.mod")) {
-    addSignal("backend", 3, "Found go.mod", true);
+    addSignal("library", 2, "Found go.mod");
+  }
+  if (hasDirectoryPath("cmd") || hasDirectoryNamed("cmd")) {
+    addSignal("backend", 2, "Found Go cmd/ entrypoint directory");
   }
   if (hasFile("openapi.yaml") || hasFile("openapi.yml")) {
     addSignal("backend", 2, "Found openapi.yaml/openapi.yml", true);
@@ -239782,6 +239785,9 @@ function detectProjectKinds(workspaceRoot, options) {
   if (hasDirectoryPath("src/main/java")) {
     addSignal("backend", 3, "Found src/main/java", true);
   }
+  if (scan.filePaths.some((entry) => /(^|\/)(repositories?|repository)\.py$/u.test(entry))) {
+    addSignal("backend", 2, "Found Python repository-layer files");
+  }
   for (const dependency of ["express", "fastify", "@nestjs/core", "koa", "hapi"]) {
     if (packageHasDependency(dependency)) {
       addSignal("backend", 2, `Found package.json with ${dependency} dependency`);
@@ -239825,6 +239831,12 @@ function detectProjectKinds(workspaceRoot, options) {
   if (hasFile("src/index.ts") || hasFile("src/index.js")) {
     addSignal("library", 2, "Found src/index.ts or src/index.js");
   }
+  if (hasDirectoryPath("src/modules") && !hasFile("requirements.txt")) {
+    addSignal("library", 1, "Found reusable module folders under src/modules");
+  }
+  if (scan.filePaths.some((entry) => entry.startsWith("src/") && entry.endsWith("/__init__.py"))) {
+    addSignal("library", 2, "Found Python package __init__.py files");
+  }
   if (packageSummaries.some((summary) => summary.hasExports)) {
     addSignal("library", 3, "Found package.json exports field", true);
   }
@@ -240306,6 +240318,13 @@ var textDependencyDatabaseHints = [
   { database: "snowflake", pattern: /\b(snowflake-connector|snowflake-sqlalchemy|snowflake-jdbc|Snowflake\.Data|snowflake-sdk)\b/iu, label: "Snowflake dependency" },
   { database: "bigquery", pattern: /\b(bigquery|google-cloud-bigquery|Google\.Cloud\.BigQuery)\b/iu, label: "BigQuery dependency" }
 ];
+var ormToolingPatterns = [
+  /\b(typeorm|sequelize|drizzle-orm|@mikro-orm\/core|prisma|@prisma\/client)\b/iu,
+  /\b(hibernate-core|org\.hibernate|spring-boot-starter-data-jpa|JpaRepository|CrudRepository|jakarta\.persistence|javax\.persistence)\b/u,
+  /\b(Microsoft\.EntityFrameworkCore|DbContext|DbSet<)\b/u,
+  /\b(SQLAlchemy|sqlalchemy|alembic|Alembic)\b/u,
+  /\b(doctrine\/orm|illuminate\/database)\b/iu
+];
 function normalizeConnectionName(value) {
   const normalized = value.trim().toLowerCase().replace(/['"]/gu, "");
   for (const entry of databaseAliases) {
@@ -240529,6 +240548,35 @@ function detectDatabaseHints(workspaceRoot, files, directories, packageJsonSumma
       }
     }
   }
+  const hasRelationalOrmEvidence = ["typeorm", "sequelize", "@sequelize/core", "knex", "drizzle-orm", "@mikro-orm/core", "mikro-orm", "prisma", "@prisma/client"].some((dependency) => dependencyExists(packageJsonSummaries, dependency)) || ["doctrine/orm", "illuminate/database"].some((dependency) => composerDependencyExists(composerJsonSummaries, dependency)) || configCandidateFiles.some((relativePath) => {
+    const content = safeReadText(path59.join(workspaceRoot, ...relativePath.split("/")), 5e4);
+    return content ? ormToolingPatterns.some((pattern) => pattern.test(content)) : false;
+  });
+  for (const relativePath of configCandidateFiles.slice(0, 120)) {
+    const content = safeReadText(path59.join(workspaceRoot, ...relativePath.split("/")), 5e4);
+    if (!content) {
+      continue;
+    }
+    if (/\bNpgsql\.EntityFrameworkCore\.PostgreSQL\b/u.test(content)) {
+      addDb("postgresql", 4, `Found Entity Framework PostgreSQL provider in ${relativePath}`);
+    }
+    if (/\bMicrosoft\.EntityFrameworkCore\.SqlServer\b/u.test(content)) {
+      addDb("sqlserver", 4, `Found Entity Framework SQL Server provider in ${relativePath}`);
+    }
+    if (/\b(Pomelo\.EntityFrameworkCore\.MySql|MySql\.EntityFrameworkCore)\b/u.test(content)) {
+      addDb("mysql", 4, `Found Entity Framework MySQL provider in ${relativePath}`);
+    }
+    if (/\bSqlite\b/u.test(content) && /\bMicrosoft\.EntityFrameworkCore\b/u.test(content)) {
+      addDb("sqlite", 3, `Found Entity Framework SQLite provider in ${relativePath}`);
+    }
+  }
+  if (hasRelationalOrmEvidence) {
+    const primaryScores = Object.entries(scores).filter(([database2, score]) => primaryDatabaseKinds.has(database2) && score > 0);
+    const onlyPrimaryScore = primaryScores.length === 1 ? primaryScores[0] : void 0;
+    if (onlyPrimaryScore) {
+      addDb(onlyPrimaryScore[0], 1, `Found ORM/data-mapper evidence supporting ${onlyPrimaryScore[0]} database selection`);
+    }
+  }
   if (directoryExists(directories, "db") || directoryExists(directories, "migrations")) {
     addEvidence3(evidence, "Found db/ or migrations/ directory");
   }
@@ -240771,16 +240819,67 @@ function parsePackageJsonSummaries3(workspaceRoot, files) {
       summaries.push({
         path: packageJsonPath,
         dependencies,
-        scripts
+        scripts,
+        ...typeof parsed.packageManager === "string" ? { packageManager: parsed.packageManager } : {}
       });
     } catch {
     }
   }
   return summaries;
 }
+function parseComposerJsonSummaries2(workspaceRoot, files) {
+  const composerJsonPaths = files.filter((entry) => entry === "composer.json" || entry.endsWith("/composer.json"));
+  const summaries = [];
+  for (const composerJsonPath of composerJsonPaths) {
+    const absolutePath = path60.join(workspaceRoot, ...composerJsonPath.split("/"));
+    const contents = safeReadText2(absolutePath);
+    if (!contents) {
+      continue;
+    }
+    try {
+      const parsed = JSON.parse(contents);
+      const dependencies = /* @__PURE__ */ new Set();
+      for (const fieldName of ["require", "require-dev"]) {
+        const value = parsed[fieldName];
+        if (!value || typeof value !== "object" || Array.isArray(value)) {
+          continue;
+        }
+        for (const name of Object.keys(value)) {
+          dependencies.add(name.toLowerCase());
+        }
+      }
+      summaries.push({ path: composerJsonPath, dependencies });
+    } catch {
+    }
+  }
+  return summaries;
+}
+function dependencyExists2(packageJsonSummaries, name) {
+  return packageJsonSummaries.some((summary) => summary.dependencies.has(name));
+}
+function composerDependencyExists2(composerJsonSummaries, name) {
+  const normalized = name.toLowerCase();
+  return composerJsonSummaries.some((summary) => summary.dependencies.has(normalized));
+}
+function fileExists4(files, name) {
+  return files.some((entry) => entry === name || entry.endsWith(`/${name}`));
+}
+function anyFileExists(files, names) {
+  return names.some((name) => fileExists4(files, name));
+}
+function anyPackageManager(packageJsonSummaries, pattern) {
+  return packageJsonSummaries.some((summary) => summary.packageManager ? pattern.test(summary.packageManager) : false);
+}
+function configTextMatches(workspaceRoot, files, filePattern, textPattern) {
+  return files.filter((entry) => filePattern.test(entry)).slice(0, 80).some((entry) => {
+    const content = safeReadText2(path60.join(workspaceRoot, ...entry.split("/")), 6e4);
+    return content ? textPattern.test(content) : false;
+  });
+}
 function detectToolingHints(workspaceRoot, options) {
   const scan = scanWorkspace4(workspaceRoot, 7, options?.ignoreMatcher);
   const packageJsonSummaries = parsePackageJsonSummaries3(workspaceRoot, scan.files);
+  const composerJsonSummaries = parseComposerJsonSummaries2(workspaceRoot, scan.files);
   const toolingHints = [];
   const databaseHints = [];
   const evidence = [];
@@ -240801,6 +240900,15 @@ function detectToolingHints(workspaceRoot, options) {
   if (scan.files.includes("pnpm-workspace.yaml")) {
     addToolingHint("pnpm-workspaces", "Found pnpm-workspace.yaml", 2);
   }
+  if (anyFileExists(scan.files, ["bun.lock", "bun.lockb"]) || anyPackageManager(packageJsonSummaries, /^bun@/iu)) {
+    addToolingHint("bun", "Found Bun lockfile or packageManager hint", 3);
+  }
+  if (anyFileExists(scan.files, ["deno.json", "deno.jsonc", "deno.lock"])) {
+    addToolingHint("deno", "Found Deno config or lockfile", 3);
+  }
+  if (scan.files.some((entry) => /(^|\/)vite\.config\.(?:js|mjs|cjs|ts|mts|cts)$/iu.test(entry)) || dependencyExists2(packageJsonSummaries, "vite")) {
+    addToolingHint("vite", "Found Vite config or dependency", 2);
+  }
   const prismaSchemaPath = scan.files.find((entry) => entry === "prisma/schema.prisma" || entry.endsWith("/prisma/schema.prisma"));
   const hasPrismaDependency = packageJsonSummaries.some((summary) => summary.dependencies.has("prisma"));
   const hasPrismaClientDependency = packageJsonSummaries.some((summary) => summary.dependencies.has("@prisma/client"));
@@ -240828,6 +240936,63 @@ function detectToolingHints(workspaceRoot, options) {
   if (hasPrismaScriptUsage) {
     addToolingHint("prisma", "Found package.json scripts using prisma migrate/generate", 1);
   }
+  const ormPackageHints = [
+    { hint: "drizzle-orm", dependencies: ["drizzle-orm"], note: "Found package.json with drizzle-orm dependency" },
+    { hint: "typeorm", dependencies: ["typeorm"], note: "Found package.json with typeorm dependency" },
+    { hint: "sequelize", dependencies: ["sequelize", "@sequelize/core"], note: "Found package.json with Sequelize dependency" },
+    { hint: "mikro-orm", dependencies: ["@mikro-orm/core", "mikro-orm"], note: "Found package.json with MikroORM dependency" }
+  ];
+  for (const ormHint of ormPackageHints) {
+    if (ormHint.dependencies.some((dependency) => dependencyExists2(packageJsonSummaries, dependency))) {
+      addToolingHint(ormHint.hint, ormHint.note, 2);
+    }
+  }
+  if (configTextMatches(
+    workspaceRoot,
+    scan.files,
+    /(^|\/)(pom\.xml|build\.gradle(\.kts)?|[^/]+\.java|[^/]+\.kt)$/iu,
+    /\b(org\.hibernate|hibernate-core|jakarta\.persistence|javax\.persistence|@Entity\b|@PersistenceContext\b)/u
+  )) {
+    addToolingHint("hibernate", "Found Hibernate/JPA dependency or entity evidence", 2);
+  }
+  if (configTextMatches(
+    workspaceRoot,
+    scan.files,
+    /(^|\/)(pom\.xml|build\.gradle(\.kts)?|[^/]+\.java|[^/]+\.kt)$/iu,
+    /\b(spring-boot-starter-data-jpa|spring-data-jpa|JpaRepository|CrudRepository|PagingAndSortingRepository)\b/u
+  )) {
+    addToolingHint("spring-data-jpa", "Found Spring Data JPA dependency or repository evidence", 2);
+  }
+  if (configTextMatches(
+    workspaceRoot,
+    scan.files,
+    /(^|\/)([^/]+\.csproj|packages\.config|[^/]+\.cs)$/iu,
+    /\b(Microsoft\.EntityFrameworkCore|DbContext|DbSet<)/u
+  )) {
+    addToolingHint("entity-framework-core", "Found Entity Framework Core dependency or DbContext evidence", 2);
+  }
+  if (configTextMatches(
+    workspaceRoot,
+    scan.files,
+    /(^|\/)(requirements.*\.txt|pyproject\.toml|setup\.py|Pipfile|poetry\.lock|[^/]+\.py)$/iu,
+    /\b(SQLAlchemy|sqlalchemy)\b/u
+  )) {
+    addToolingHint("sqlalchemy", "Found SQLAlchemy dependency or import evidence", 2);
+  }
+  if (configTextMatches(
+    workspaceRoot,
+    scan.files,
+    /(^|\/)(requirements.*\.txt|pyproject\.toml|setup\.py|Pipfile|poetry\.lock|alembic\.ini|[^/]+\.py)$/iu,
+    /\b(alembic|Alembic)\b/u
+  ) || fileExists4(scan.files, "alembic.ini")) {
+    addToolingHint("alembic", "Found Alembic dependency or migration config", 2);
+  }
+  if (composerDependencyExists2(composerJsonSummaries, "doctrine/orm")) {
+    addToolingHint("doctrine-orm", "Found composer.json with doctrine/orm dependency", 2);
+  }
+  if (composerDependencyExists2(composerJsonSummaries, "illuminate/database")) {
+    addToolingHint("eloquent", "Found composer.json with illuminate/database dependency", 2);
+  }
   const envFilePath = scan.files.find((entry) => entry === ".env" || entry.endsWith("/.env"));
   if (hasPrismaEvidence && envFilePath) {
     const envText = safeReadText2(path60.join(workspaceRoot, ...envFilePath.split("/")), 2e4);
@@ -240973,7 +241138,7 @@ function scanRoot(rootAbsolutePath, options) {
     directories: unique(directories).sort((left, right) => left.localeCompare(right))
   };
 }
-function fileExists4(files, fileName) {
+function fileExists5(files, fileName) {
   return files.some((entry) => entry === fileName || entry.endsWith(`/${fileName}`));
 }
 function hasDirectory(directories, directoryName) {
@@ -241076,11 +241241,11 @@ function inspectRoot(workspaceRoot, root, ignoreMatcher) {
   const scan = scanRoot(rootAbsolutePath, { rootRelativePath: root, ignoreMatcher });
   const packageJson = readPackageJsonSummary(rootAbsolutePath);
   const evidence = [];
-  const hasApiBoundary = hasDirectory(scan.directories, "controllers") || hasDirectory(scan.directories, "routes") || hasDirectory(scan.directories, "router") || hasDirectory(scan.directories, "src/app/api") || scan.files.some((entry) => /(^|\/)(.*controller.*|.*route.*|.*router.*)\.(ts|tsx|js|jsx|py|java|kt)$/iu.test(entry)) || fileExists4(scan.files, "openapi.yaml") || fileExists4(scan.files, "openapi.yml") || fileExists4(scan.files, "swagger.yaml") || fileExists4(scan.files, "swagger.yml") || hasAnyDependency2(packageJson, ["express", "fastify", "@nestjs/core", "koa", "hapi", "fastapi", "@apollo/server"]);
+  const hasApiBoundary = hasDirectory(scan.directories, "controllers") || hasDirectory(scan.directories, "routes") || hasDirectory(scan.directories, "router") || hasDirectory(scan.directories, "src/app/api") || scan.files.some((entry) => /(^|\/)(.*controller.*|.*route.*|.*router.*)\.(ts|tsx|js|jsx|py|java|kt)$/iu.test(entry)) || fileExists5(scan.files, "openapi.yaml") || fileExists5(scan.files, "openapi.yml") || fileExists5(scan.files, "swagger.yaml") || fileExists5(scan.files, "swagger.yml") || hasAnyDependency2(packageJson, ["express", "fastify", "@nestjs/core", "koa", "hapi", "fastapi", "@apollo/server"]);
   if (hasApiBoundary) {
     addEvidence5(evidence, "Detected controllers/routes or backend API framework signals");
   }
-  const hasDatabaseAccess = hasDirectory(scan.directories, "db") || hasDirectory(scan.directories, "migrations") || fileExists4(scan.files, "prisma/schema.prisma") || fileExists4(scan.files, "ormconfig.ts") || fileExists4(scan.files, "ormconfig.js") || fileExists4(scan.files, "ormconfig.json") || fileExists4(scan.files, "knexfile.ts") || fileExists4(scan.files, "knexfile.js") || fileExists4(scan.files, "application.yml") || fileExists4(scan.files, "application.yaml") || fileExists4(scan.files, "application.properties") || hasAnyDependency2(packageJson, [
+  const hasDatabaseAccess = hasDirectory(scan.directories, "db") || hasDirectory(scan.directories, "migrations") || fileExists5(scan.files, "prisma/schema.prisma") || fileExists5(scan.files, "ormconfig.ts") || fileExists5(scan.files, "ormconfig.js") || fileExists5(scan.files, "ormconfig.json") || fileExists5(scan.files, "knexfile.ts") || fileExists5(scan.files, "knexfile.js") || fileExists5(scan.files, "application.yml") || fileExists5(scan.files, "application.yaml") || fileExists5(scan.files, "application.properties") || hasAnyDependency2(packageJson, [
     "@prisma/client",
     "prisma",
     "typeorm",
@@ -241103,7 +241268,7 @@ function inspectRoot(workspaceRoot, root, ignoreMatcher) {
   if (hasServiceEnvConfig) {
     addEvidence5(evidence, "Detected service-specific environment configuration");
   }
-  const hasOpenApiSpec = fileExists4(scan.files, "openapi.yaml") || fileExists4(scan.files, "openapi.yml") || fileExists4(scan.files, "openapi.json") || fileExists4(scan.files, "contracts/openapi.yaml") || fileExists4(scan.files, "contracts/openapi.yml") || fileExists4(scan.files, "swagger.yaml") || fileExists4(scan.files, "swagger.yml") || fileExists4(scan.files, "swagger.json");
+  const hasOpenApiSpec = fileExists5(scan.files, "openapi.yaml") || fileExists5(scan.files, "openapi.yml") || fileExists5(scan.files, "openapi.json") || fileExists5(scan.files, "contracts/openapi.yaml") || fileExists5(scan.files, "contracts/openapi.yml") || fileExists5(scan.files, "swagger.yaml") || fileExists5(scan.files, "swagger.yml") || fileExists5(scan.files, "swagger.json");
   if (hasOpenApiSpec) {
     addEvidence5(evidence, "Detected service-specific OpenAPI contract");
   }
@@ -241111,8 +241276,8 @@ function inspectRoot(workspaceRoot, root, ignoreMatcher) {
   if (hasModulesRoot) {
     addEvidence5(evidence, "Detected modules root");
   }
-  const hasFrontendSignals = fileExists4(scan.files, "next.config.js") || fileExists4(scan.files, "next.config.ts") || fileExists4(scan.files, "angular.json") || fileExists4(scan.files, "vite.config.ts") || fileExists4(scan.files, "vite.config.js") || hasDirectory(scan.directories, "pages") || hasDirectory(scan.directories, "public") || hasAnyDependency2(packageJson, ["next", "react", "vue", "@angular/core"]);
-  const hasBackendSignals = hasApiBoundary || hasDatabaseAccess || fileExists4(scan.files, "pom.xml") || fileExists4(scan.files, "requirements.txt") || fileExists4(scan.files, "go.mod") || hasDirectory(scan.directories, "src/main/java");
+  const hasFrontendSignals = fileExists5(scan.files, "next.config.js") || fileExists5(scan.files, "next.config.ts") || fileExists5(scan.files, "angular.json") || fileExists5(scan.files, "vite.config.ts") || fileExists5(scan.files, "vite.config.js") || hasDirectory(scan.directories, "pages") || hasDirectory(scan.directories, "public") || hasAnyDependency2(packageJson, ["next", "react", "vue", "@angular/core"]);
+  const hasBackendSignals = hasApiBoundary || hasDatabaseAccess || fileExists5(scan.files, "pom.xml") || fileExists5(scan.files, "requirements.txt") || fileExists5(scan.files, "go.mod") || hasDirectory(scan.directories, "src/main/java");
   let classification = "unknown";
   if ((root.startsWith("packages/") || root.startsWith("libs/")) && !hasApiBoundary) {
     classification = "shared_package";
@@ -241562,6 +241727,9 @@ function addEvidence7(evidence, value) {
 function uniqueSorted5(values) {
   return [...new Set(values)].sort((left, right) => left.localeCompare(right));
 }
+function uniqueLimited(values, limit = 5) {
+  return uniqueSorted5(values.filter((value) => value.trim().length > 0)).slice(0, limit);
+}
 function uniqueInOrder2(values) {
   const seen = /* @__PURE__ */ new Set();
   const result = [];
@@ -241865,6 +242033,51 @@ function hasAttributableBackendRoot(detection) {
 function isGenericLibraryStack(stack) {
   return stack === "node_typescript" || stack === "node_javascript" || stack === "python" || stack === "go" || stack === "kotlin" || stack === "terraform" || stack === "ansible";
 }
+function hasProjectKindEvidence(detection, patterns) {
+  const evidence = detection.projectKinds?.evidence ?? [];
+  return evidence.some((entry) => patterns.some((pattern) => pattern.test(entry)));
+}
+function resolveSingleProjectGenericKinds(detection, selectedAdapterId, selectedHints, evidence) {
+  if (detection.topology.topology !== "single_project" || !selectedAdapterId || getStackAdapterById(selectedAdapterId).category !== "generic-language" || !(selectedHints.includes("backend") && selectedHints.includes("library"))) {
+    return void 0;
+  }
+  const hasFrameworkBackendCandidate = (detection.stacks.candidates ?? []).some((candidate) => {
+    const adapter = getStackAdapterById(candidate.adapterId);
+    return adapter.category === "framework" && adapter.id !== selectedAdapterId;
+  });
+  if (hasFrameworkBackendCandidate) {
+    return void 0;
+  }
+  const hasServiceBackendEvidence = hasProjectKindEvidence(detection, [
+    /requirements\.txt/u,
+    /composer\.json/u,
+    /pom\.xml/u,
+    /build\.gradle/u,
+    /openapi/u,
+    /db\/ or migrations/u,
+    /repository-layer/u
+  ]);
+  const hasCliEntrypointEvidence = hasProjectKindEvidence(detection, [
+    /cmd\/ entrypoint/u,
+    /CLI-style entrypoint/u
+  ]);
+  const hasLibraryEvidence = hasProjectKindEvidence(detection, [
+    /exports field/u,
+    /main\/module\/types fields/u,
+    /src\/index/u,
+    /pyproject\.toml/u,
+    /setup\.py/u,
+    /go\.mod/u,
+    /Python package __init__\.py/u,
+    /reusable module folders/u
+  ]);
+  const selected = hasLibraryEvidence && !hasServiceBackendEvidence ? "library" : "backend";
+  addEvidence7(evidence, `Reduced single-project generic ${selectedAdapterId} project kind to ${selected}`);
+  if (selected === "library" && hasCliEntrypointEvidence) {
+    addEvidence7(evidence, "Treated CLI entrypoint as package tooling rather than backend service evidence");
+  }
+  return [selected];
+}
 function normalizeDetectedBackendStack(value) {
   if (value === "springboot") {
     return "spring";
@@ -241941,7 +242154,15 @@ function resolveNormalizedProjectKinds(detection, evidence) {
     evidence: []
   }) ?? [] : []);
   let normalizedKinds = [];
-  if (detection.topology.topology === "single_project" && selectedHints.length > 0 && selectedAdapter.category === "framework") {
+  const genericSingleProjectKinds = resolveSingleProjectGenericKinds(
+    detection,
+    selectedAdapterId,
+    selectedHints,
+    evidence
+  );
+  if (genericSingleProjectKinds) {
+    normalizedKinds = genericSingleProjectKinds;
+  } else if (detection.topology.topology === "single_project" && selectedHints.length > 0 && selectedAdapter.category === "framework") {
     normalizedKinds = uniqueSortedKinds(selectedHints);
     addEvidence7(evidence, `Normalized project kinds from selected adapter '${selectedAdapter.id}' hints`);
   } else if (detection.topology.topology === "monorepo" && selectedHints.length > 0) {
@@ -242237,6 +242458,40 @@ function resolveConfidence2(proposal, detection) {
   }
   return "low";
 }
+function resolveProposalReasons(input2) {
+  const reasons = {};
+  const selectedStackIds = uniqueSorted5(
+    Object.values(input2.stackSelections).filter((stack) => Boolean(stack))
+  );
+  const selectedStackReasons = selectedStackIds.flatMap((stackId) => input2.detection.stacks.candidates?.find((candidate) => candidate.adapterId === stackId)?.evidence ?? []);
+  if (selectedStackReasons.length > 0) {
+    reasons.framework = uniqueLimited(selectedStackReasons);
+  }
+  if (input2.apiStyle && input2.apiStyle !== "unknown") {
+    reasons.api = input2.apiStyle === "none" ? uniqueLimited(input2.detection.apiDbHints?.api.evidence ?? ["No API artifacts detected for current project profile"], 4) : uniqueLimited(input2.detection.apiDbHints?.api.evidence ?? [], 4);
+  }
+  if (input2.database && input2.database !== "unknown") {
+    const databaseEvidence = [
+      ...input2.detection.apiDbHints?.database.evidence ?? [],
+      ...(input2.detection.toolingHints?.evidence ?? []).filter((entry) => /prisma|datasource|database|orm|jpa|entity framework|sqlalchemy|alembic/iu.test(entry))
+    ];
+    reasons.database = input2.database === "none" ? uniqueLimited(databaseEvidence.length > 0 ? databaseEvidence : ["No database artifacts detected for current project profile"], 4) : uniqueLimited(databaseEvidence, 4);
+  }
+  if ((input2.detection.toolingHints?.toolingHints.length ?? 0) > 0) {
+    reasons.tooling = uniqueLimited(input2.detection.toolingHints?.evidence ?? [], 5);
+  }
+  if (input2.architectureStyleEvidence.length > 0) {
+    reasons.architectureStyle = uniqueLimited(input2.architectureStyleEvidence, 5);
+  }
+  if (input2.modulesRoot || (input2.moduleRoots?.length ?? 0) > 0) {
+    reasons.modulesRoot = uniqueLimited([
+      ...input2.modulesRoot ? [`Detected modules root at ${input2.modulesRoot}`] : [],
+      ...(input2.moduleRoots ?? []).length > 0 ? [`Detected module roots: ${(input2.moduleRoots ?? []).join(", ")}`] : [],
+      ...input2.detection.modules?.evidence ?? []
+    ], 4);
+  }
+  return Object.keys(reasons).length > 0 ? reasons : void 0;
+}
 function buildArchitectureProposal(detection) {
   const evidence = [];
   addEvidence7(evidence, `Detected ${detection.topology.topology} topology`);
@@ -242287,6 +242542,15 @@ function buildArchitectureProposal(detection) {
   if ((detection.toolingHints?.toolingHints.length ?? 0) > 0) {
     addEvidence7(evidence, `Detected tooling hints: ${(detection.toolingHints?.toolingHints ?? []).join(", ")}`);
   }
+  const proposalReasons = resolveProposalReasons({
+    detection,
+    stackSelections,
+    architectureStyleEvidence: architectureStyleDecision.architectureStyleEvidence,
+    modulesRoot,
+    moduleRoots,
+    apiStyle,
+    database
+  });
   const proposalCore = {
     ...projectKinds.length > 0 ? { projectKinds } : {},
     ...architectureStyle ? { architectureStyle } : {},
@@ -242306,7 +242570,8 @@ function buildArchitectureProposal(detection) {
     ...modules.length > 0 ? { modules: uniqueSorted5(modules) } : {},
     ...moduleCandidates.length > 0 ? { moduleCandidates } : {},
     ...moduleCandidateGroups ? { moduleCandidateGroups } : {},
-    ...(detection.detectedComponents?.length ?? 0) > 0 ? { detectedComponents: detection.detectedComponents } : {}
+    ...(detection.detectedComponents?.length ?? 0) > 0 ? { detectedComponents: detection.detectedComponents } : {},
+    ...proposalReasons ? { proposalReasons } : {}
   };
   const confidence = resolveConfidence2(proposalCore, detection);
   if (architectureStyle) {
@@ -245377,8 +245642,6 @@ function normalizeCanonicalStackId(value) {
     "dotnet",
     "ruby_rails",
     "kotlin",
-    "kotlin_spring",
-    "rust",
     "react",
     "angular",
     "vue",
@@ -245510,54 +245773,72 @@ function formatModuleRootsSummary(proposal, inputs) {
 function renderSmartInitDetectionSummary(detection, inputs) {
   const proposal = detection.proposal ?? buildArchitectureProposal(detection);
   const formatStack = (stack) => canonicalStackLabels[stack] ?? stack.replace(/_/gu, " ");
+  const formatToken = (value) => value.replace(/_/gu, " ");
+  const formatList = (values, formatter = formatToken) => {
+    const unique2 = [...new Set((values ?? []).filter((value) => typeof value === "string" && value.length > 0))];
+    return unique2.length > 0 ? unique2.map(formatter).join(", ") : "(none)";
+  };
+  const selectedStacks = [
+    inputs.stacks.backendStack,
+    inputs.stacks.frontendStack,
+    inputs.stacks.libraryStack
+  ].filter((stack) => typeof stack === "string" && stack.length > 0);
+  const selectedStackIds = new Set(selectedStacks);
   const backendStacks = [...new Set(detection.stacks.backendStacks ?? [])];
+  const frontendStacks = [...new Set(detection.stacks.frontendStacks ?? [])];
   const libraryStacks = [
     ...new Set(
       (proposal.detectedComponents ?? detection.detectedComponents ?? []).filter((component) => component.kind === "library" || component.kind === "data").map((component) => component.stack).filter((stack) => typeof stack === "string" && stack.length > 0)
     )
   ];
+  const candidateStacks = [
+    ...backendStacks,
+    ...frontendStacks,
+    ...libraryStacks,
+    ...detection.stacks.stacks ?? []
+  ].filter(
+    (stack, index, values) => typeof stack === "string" && stack.length > 0 && !selectedStackIds.has(stack) && values.indexOf(stack) === index
+  );
+  const toolingHints = proposal.toolingHints ?? detection.toolingHints?.toolingHints ?? [];
+  const databaseHints = proposal.databaseHints ?? detection.apiDbHints?.database?.databaseHints ?? [];
+  const apiHint = proposal.apiStyle ?? inputs.apiStyle;
+  const selectedModules = inputs.modules ?? proposal.modules ?? [];
+  const architectureCandidates = (proposal.moduleCandidates ?? []).filter((candidate) => candidate.classification === "architecture-module").map((candidate) => candidate.name);
+  const ignoredCandidates = (proposal.moduleCandidates ?? []).filter((candidate) => candidate.classification === "technical-layer" || candidate.classification === "shared-infrastructure").map((candidate) => `${candidate.name} (${formatToken(candidate.classification)})`);
   const lines = [];
-  lines.push("ArchPilot Init - Smart Init Detection Summary");
+  lines.push("Detected Architecture Signals");
   lines.push("");
-  lines.push(`Repository topology: ${detection.topology.topology}`);
-  lines.push(`Project kinds: ${(proposal.projectKinds ?? detection.projectKinds?.kinds ?? []).join(", ") || "(none)"}`);
-  lines.push(`Detected stacks: ${detection.stacks.selectedAdapterId ?? "(none)"}`);
-  lines.push(
-    inputs.stacks.backendStack ? `Selected backend stack: ${formatStack(inputs.stacks.backendStack)}${backendStacks.length > 1 ? ` (detected: ${backendStacks.map(formatStack).join(", ")})` : ""}` : backendStacks.length > 1 ? `Backend stacks: ${backendStacks.map(formatStack).join(", ")}` : `Backend stack: ${proposal.stackSelections?.backend ? formatStack(proposal.stackSelections.backend) : "(pending)"}`
-  );
-  if ((proposal.projectKinds ?? []).includes("library")) {
-    lines.push(
-      libraryStacks.length > 1 ? `Library stacks: ${libraryStacks.map(formatStack).join(", ")}` : `Library stack: ${proposal.stackSelections?.library ? formatStack(proposal.stackSelections.library) : "(pending)"}`
-    );
-  }
-  lines.push(`Module roots: ${formatModuleRootsSummary(proposal, inputs)}`);
-  if (Array.isArray(proposal.moduleCandidates) && proposal.moduleCandidates.length > 0) {
-    const groups = proposal.moduleCandidateGroups ?? {
-      "architecture-module": proposal.moduleCandidates.filter((candidate) => candidate.classification === "architecture-module"),
-      "technical-layer": proposal.moduleCandidates.filter((candidate) => candidate.classification === "technical-layer"),
-      "shared-infrastructure": proposal.moduleCandidates.filter((candidate) => candidate.classification === "shared-infrastructure"),
-      uncertain: proposal.moduleCandidates.filter((candidate) => candidate.classification === "uncertain")
-    };
-    const labels = {
-      "architecture-module": "Architecture Modules",
-      "technical-layer": "Technical Layers",
-      "shared-infrastructure": "Shared Infrastructure",
-      uncertain: "Uncertain Candidates"
-    };
-    for (const key of ["architecture-module", "technical-layer", "shared-infrastructure", "uncertain"]) {
-      const candidates = groups[key] ?? [];
-      if (candidates.length > 0) {
-        lines.push(`${labels[key]}: ${candidates.map((candidate) => candidate.name).join(", ")}`);
-      }
-    }
-    lines.push(`Selected architecture modules: ${inputs.modules?.join(", ") || "(none)"}`);
+  lines.push(`Primary stack: ${formatList(selectedStacks, formatStack)}`);
+  lines.push(`Additional stack signals: ${formatList(candidateStacks, formatStack)}`);
+  lines.push(`Project kind: ${formatList(proposal.projectKinds ?? detection.projectKinds?.kinds, formatToken)}`);
+  lines.push(`Repository topology: ${formatToken(detection.topology.topology)}`);
+  lines.push(`Modules root: ${formatModuleRootsSummary(proposal, inputs)}`);
+  if (selectedModules.length > 0) {
+    lines.push(`Selected architecture modules: ${formatList(selectedModules)}`);
+  } else if (architectureCandidates.length > 0) {
+    lines.push(`Architecture module candidates: ${formatList(architectureCandidates)}`);
+  } else {
+    lines.push("Architecture modules: none confidently detected");
+  }
+  if (ignoredCandidates.length > 0) {
+    lines.push(`Ignored technical/shared folders: ${formatList(ignoredCandidates)}`);
+  }
+  lines.push(`API hints: ${apiHint && apiHint !== "unknown" ? formatToken(apiHint) : "(none)"}`);
+  lines.push(`Database hints: ${formatList(databaseHints, formatToken)}`);
+  lines.push(`Tooling/data hints: ${formatList(toolingHints, formatToken)}`);
+  lines.push(`Detection confidence: ${proposal.confidence}`);
+  const proposalReasons = proposal.proposalReasons ?? {};
+  const reasonEntries = [
+    ...proposalReasons.framework?.length ? [`Framework: ${formatList(proposalReasons.framework.slice(0, 2))}`] : [],
+    ...proposalReasons.api?.length ? [`API: ${formatList(proposalReasons.api.slice(0, 2))}`] : [],
+    ...proposalReasons.database?.length ? [`Database: ${formatList(proposalReasons.database.slice(0, 2))}`] : []
+  ];
+  if (reasonEntries.length > 0) {
+    lines.push(`Reasons: ${reasonEntries.join(" | ")}`);
   }
-  lines.push(`API style: ${proposal.apiStyle ?? inputs.apiStyle}`);
-  lines.push(`Database: ${proposal.database ?? inputs.database}`);
-  lines.push(`Components: ${Array.isArray(proposal.components) && proposal.components.length > 0 ? proposal.components.map((component) => `${component.id ?? "(unnamed)"}:${component.path ?? "(root)"}`).join(", ") : "(none)"}`);
-  lines.push(`Resources: ${Array.isArray(proposal.resources) && proposal.resources.length > 0 ? proposal.resources.map((resource) => `${resource.id ?? "(unnamed)"}:${resource.type ?? "resource"}:${resource.provider ?? "unknown"}`).join(", ") : "(none)"}`);
+  lines.push(`Evidence: ${formatList((proposal.evidence ?? []).slice(0, 5))}`);
   lines.push("");
-  lines.push("Detected values are preselected. You can edit them before anything is written.");
+  lines.push("Detected values are preselected. Tooling/data hints are supporting signals, not primary stack adapters. You can edit everything before anything is written.");
   return lines.join("\n");
 }
 function renderArchitectureInputsSummary(inputs) {
@@ -245693,7 +245974,7 @@ async function editModulesAndApi(rl, inputs) {
     return authStyle;
   }
   inputs.authStyle = authStyle;
-  const database = await askInitValue(rl, "Legacy database field (none, postgresql, mysql)", inputs.database, isValidDatabaseChoice);
+  const database = await askInitValue(rl, "Primary database (none, postgresql, mysql)", inputs.database, isValidDatabaseChoice);
   if (database === "back" || database === "cancel") {
     return database;
   }
@@ -249444,7 +249725,7 @@ async function runArchpilotCli() {
     if (workspaceRoot !== invocationDirectory) {
       process.chdir(workspaceRoot);
     }
-  } else {
+  } else if (command !== "init") {
     const discoveredWorkspaceRoot = findArchpilotWorkspaceRoot(invocationDirectory);
     if (discoveredWorkspaceRoot && discoveredWorkspaceRoot !== invocationDirectory) {
       process.chdir(discoveredWorkspaceRoot);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@archpilotlabs/archpilot",
-  "version": "0.0.18",
-  "description": "Executable architecture governance CLI",
+  "version": "0.0.19",
+  "description": "Executable architecture governance CLI for Smart Init, validation, drift detection, and CI.",
   "homepage": "https://archpilot.org",
   "bugs": {
     "url": "https://archpilot.org/contact"
@@ -22,7 +22,8 @@
     "dependency-validation",
     "adr",
     "ci",
-    "developer-tools"
+    "developer-tools",
+    "smart-init"
   ],
   "scripts": {
     "build": "npm run compile",