@plumbus/core 0.3.3 → 0.4.1

package/README.md

@@ -2,7 +2,7 @@
 
 **AI-native, contract-driven TypeScript application framework.**
 
-Define your application through five composable primitives — Entities, Capabilities, Flows, Events, and Prompts — and get deny-by-default security, advisory governance, audit trails, and managed AI integration out of the box.
+Define your application through six composable primitives — Capabilities, Entities, Events, Flows, Prompts, and Translations — and get deny-by-default security, advisory governance, audit trails, and managed AI integration out of the box. Two opt-in companion packages extend the surface: `@plumbus/chat` for conversational runtimes and `@plumbus/mcp` for serving capabilities to AI agents.
 
 ## Install
 
@@ -23,7 +23,7 @@ cd my-app
 plumbus dev
 ```
 
-## The Five Primitives
+## The Six Primitives
 
 ### Capabilities — atomic business operations
 

package/bin/plumbus.js

@@ -1,9 +1,23 @@
 #!/usr/bin/env node
 import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { ErrorHints } from "../dist/errors/hints.js";
 
-// Auto-load .env file if present (Node 20.6+ built-in)
-if (existsSync(".env")) {
+const PROJECT_MARKERS = [
+    "config/app.config.ts",
+    "plumbus.config.ts",
+    "plumbus.config.json",
+];
+
+function isPlumbusProjectRoot(cwd) {
+    return PROJECT_MARKERS.some((marker) => existsSync(join(cwd, marker)));
+}
+
+// Auto-load .env only inside a recognized Plumbus project (H1)
+if (existsSync(".env") && isPlumbusProjectRoot(process.cwd())) {
     process.loadEnvFile(".env");
+} else if (existsSync(".env") && !isPlumbusProjectRoot(process.cwd())) {
+    console.warn(`[plumbus] ${ErrorHints.envNotLoaded}`);
 }
 
 import { createCli } from "../dist/cli/cli.js";