aienvmp 0.1.30 → 0.1.31

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.1.31
+
+- Added `aienvmp status` as a compact human and AI entrypoint.
+- Summarized clear/review state, next command, counts, top action, and enforcement advice in one output.
+- Kept `context --json` as the richer preflight while making first checks simpler.
+
 ## 0.1.30
 
 - Added shared enforcement advice for AI and CI surfaces.

package/README.md

@@ -16,6 +16,7 @@ Core loop: scan once, link runtime/dependency/security context, give AI a shared
 
 ```bash
 npx aienvmp sync
+npx aienvmp status
 npx aienvmp context
 npx aienvmp plan
 npx aienvmp handoff
@@ -79,6 +80,7 @@ The dashboard shows which strict scopes are CI-ready before you enforce them.
 
 ```bash
 aienvmp sync              # update env map, light SBOM, ledger, dashboard
+aienvmp status            # one compact clear/review decision
 aienvmp context           # AI preflight brief
 aienvmp context --json    # AI decision contract + actions + compact step summary
 aienvmp plan              # read-only AI action plan using the same decision contract

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aienvmp",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "description": "AI-first environment maps and lightweight runtime SBOMs for shared development machines.",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -12,6 +12,7 @@ import { syncWorkspace } from "./commands/sync.js";
 import { snippetWorkspace } from "./commands/snippet.js";
 import { handoffWorkspace } from "./commands/handoff.js";
 import { planWorkspace } from "./commands/plan.js";
+import { statusWorkspace } from "./commands/status.js";
 import { readFileSync } from "node:fs";
 
 const commands = new Map([
@@ -28,7 +29,8 @@ const commands = new Map([
   ["sync", syncWorkspace],
   ["snippet", snippetWorkspace],
   ["handoff", handoffWorkspace],
-  ["plan", planWorkspace]
+  ["plan", planWorkspace],
+  ["status", statusWorkspace]
 ]);
 
 const version = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
@@ -78,11 +80,13 @@ function printUsage() {
 Usage:
   aienvmp sync [--dir .] [--json] [--quiet] [--deep] [--security]
   aienvmp context [--dir .] [--json]
+  aienvmp status [--dir .] [--json]
   aienvmp handoff [--dir .] [--json] [--record --actor agent:id]
   aienvmp plan [--dir .] [--json] [--write]
 
 Common:
   aienvmp sync      update AIENV.md, manifest, ledger, intents, and dashboard
+  aienvmp status    print one simple environment decision
   aienvmp context   print the AI preflight brief
   aienvmp handoff   print the next-agent handoff summary
   aienvmp plan      print a read-only AI environment action plan

package/src/commands/status.js

@@ -0,0 +1,53 @@
+import { diagnose } from "../doctor.js";
+import { readJson } from "../fsutil.js";
+import { loadPolicy, policyWarnings } from "../policy.js";
+import { intentsPath, manifestPath, timelinePath, workspaceDir } from "../paths.js";
+import { openIntents, readJsonl, readTimeline } from "../timeline.js";
+import { recommendedActions } from "../actions.js";
+import { aiDecision } from "../decision.js";
+import { enforcementAdvice } from "../enforcement.js";
+
+export async function statusWorkspace(args) {
+  const dir = workspaceDir(args);
+  const manifest = await readJson(manifestPath(dir));
+  if (!manifest) throw new Error("missing manifest; run `aienvmp sync` first");
+  const policy = await loadPolicy(dir);
+  const timeline = await readTimeline(timelinePath(dir));
+  const intents = openIntents(await readJsonl(intentsPath(dir)));
+  const warnings = [...diagnose(manifest, { timeline, intents }), ...policyWarnings(manifest, policy)];
+  const status = buildStatus(manifest, warnings, intents);
+  if (args.json) {
+    console.log(JSON.stringify(status, null, 2));
+  } else {
+    console.log(`${status.state}: ${status.summary}`);
+    console.log(`next: ${status.nextCommand}`);
+    console.log(`strict: ${status.enforcement.recommendedCommand}`);
+  }
+  return status;
+}
+
+export function buildStatus(manifest = {}, warnings = [], intents = []) {
+  const decision = aiDecision(warnings, intents);
+  const enforcement = enforcementAdvice(warnings);
+  const actions = recommendedActions(manifest, { warnings, intents });
+  const state = decision.reviewRequired ? "review-required" : "clear";
+  const topAction = actions[0] || null;
+  return {
+    schemaVersion: 1,
+    state,
+    summary: state === "clear"
+      ? "Project-local work can continue. Record intent before environment changes."
+      : "Review warnings or open intents before environment changes.",
+    decision,
+    enforcement,
+    counts: {
+      warnings: warnings.length,
+      openIntents: intents.length,
+      runtimes: Object.keys(manifest.runtimes || {}).length,
+      dependencies: Number(manifest.dependencySnapshot?.summary?.packages || 0),
+      vulnerabilities: Number(manifest.security?.summary?.total || 0)
+    },
+    topAction,
+    nextCommand: topAction?.command || decision.nextCommand
+  };
+}