aienvmp 0.1.62 → 0.1.63

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.1.63
+
+- Compressed plain `aienvmp status` output into a 5-line AI/human decision view.
+- Added `aienvmp status --verbose` for detailed command hints without cluttering the default path.
+- Added a reusable `renderStatusText` helper for stable status text formatting.
+- Kept JSON/status artifacts unchanged so AI consumers retain the full preflight contract.
+- Updated CLI help to explain the compact default and verbose detail mode.
+- Updated README command guidance for default, artifact, and verbose status usage.
+- Added regression tests for compact default output, verbose output, and exact status text shape.
+
 ## 0.1.62
 
 - Added a compact `collaboration` block to the shared preflight/status contract for multi-agent environment coordination.

package/README.md

@@ -82,7 +82,9 @@ Snippets point each AI to `status`, `summary.md`, `context --json`, intent, and
 
 ```bash
 aienvmp sync                    # update env map, status, summary, SBOM, dashboard
-aienvmp status --write          # refresh compact AI status
+aienvmp status                  # 5-line env decision
+aienvmp status --write          # refresh compact AI status artifact
+aienvmp status --verbose        # show command details
 aienvmp summary --write         # refresh compact Markdown summary
 aienvmp context --json          # AI decision contract
 aienvmp sbom --json             # standalone light SBOM

package/package.json

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

package/src/cli.js

@@ -112,7 +112,7 @@ function printUsage() {
 Usage:
   aienvmp sync [--dir .] [--json] [--quiet] [--deep] [--security]
   aienvmp context [--dir .] [--json]
-  aienvmp status [--dir .] [--json] [--write] [--quiet]
+  aienvmp status [--dir .] [--json] [--write] [--quiet] [--verbose]
   aienvmp handoff [--dir .] [--json] [--record --actor agent:id]
   aienvmp checkpoint [--dir .] --actor agent:id --summary "what changed" [--target dependency] [--json]
   aienvmp plan [--dir .] [--json] [--write]
@@ -122,7 +122,7 @@ Usage:
 
 Common:
   aienvmp sync      update AIENV.md, manifest, status, summary, SBOM, ledger, intents, and dashboard
-  aienvmp status    print one simple environment decision; --write saves .aienvmp/status.json
+  aienvmp status    print a 5-line AI/human environment decision; --verbose shows command details
   aienvmp context   print the AI preflight brief
   aienvmp handoff   print the next-agent handoff summary
   aienvmp checkpoint record, sync, status, and handoff after an env change

package/src/commands/status.js

@@ -21,16 +21,7 @@ export async function statusWorkspace(args) {
   if (args.json) {
     console.log(JSON.stringify(output, null, 2));
   } else if (!args.quiet) {
-    console.log(`${output.state}: ${output.summary}`);
-    console.log(`ai-readiness: ${output.aiReadiness?.level || "unknown"} - ${output.aiReadiness?.next || "Run aienvmp context --json for details."}`);
-    console.log(`collaboration: ${output.collaboration?.status || "unknown"} - ${output.collaboration?.nextCommand || "aienvmp status --json"}`);
-    console.log(`next: ${output.nextCommand}`);
-    console.log(`ai: ${output.quickstart.readFirst} -> ${output.quickstart.detailCommand}`);
-    console.log(`intent: ${output.intentTargets[0]?.command || output.commands.recordIntent}`);
-    console.log(`checkpoint: ${output.commands.checkpoint}`);
-    console.log(`handoff: ${output.nextAgent.handoffCommand}`);
-    console.log(`strict: ${output.enforcement.recommendedCommand}`);
-    if (artifact) console.log(`status: ${artifact}`);
+    console.log(renderStatusText(output, { verbose: args.verbose === true, artifact }));
   }
   return output;
 }
@@ -45,3 +36,37 @@ export async function writeStatusArtifact(dir, status) {
 export function buildStatus(manifest = {}, warnings = [], intents = [], timeline = []) {
   return buildPreflight(manifest, warnings, intents, timeline);
 }
+
+export function renderStatusText(output = {}, options = {}) {
+  const counts = output.counts || {};
+  const readiness = output.aiReadiness?.level || "unknown";
+  const collaboration = output.collaboration?.status || "unknown";
+  const sbomRisk = output.sbomRisk?.level || "unknown";
+  const sbomScore = valueOrZero(output.sbomRisk?.score);
+  const detail = output.quickstart?.detailCommand || "aienvmp context --json";
+  const summary = output.artifacts?.summary || ".aienvmp/summary.md";
+  const lines = [
+    `${output.state || "unknown"}: ${output.summary || "Run aienvmp context --json for details."}`,
+    `ready: ${readiness} | collaboration: ${collaboration}`,
+    `sbom: ${sbomRisk} (${sbomScore}) | warnings: ${valueOrZero(counts.warnings)} | intents: ${valueOrZero(counts.openIntents)}`,
+    `next: ${output.nextCommand || "aienvmp status --json"}`,
+    `details: ${detail} | summary: ${summary}`
+  ];
+
+  if (options.verbose) {
+    lines.push(
+      `ai: ${output.quickstart?.readFirst || "aienvmp status --write"} -> ${detail}`,
+      `intent: ${output.intentTargets?.[0]?.command || output.commands?.recordIntent || "aienvmp intent --actor agent:id --action planned-change"}`,
+      `checkpoint: ${output.commands?.checkpoint || "aienvmp checkpoint --actor agent:id --summary what-changed --target environment"}`,
+      `handoff: ${output.nextAgent?.handoffCommand || "aienvmp handoff --record --actor agent:id"}`,
+      `strict: ${output.enforcement?.recommendedCommand || "aienvmp doctor --strict all"}`
+    );
+  }
+
+  if (options.artifact || output.artifact) lines.push(`status: ${options.artifact || output.artifact}`);
+  return lines.join("\n");
+}
+
+function valueOrZero(value) {
+  return Number.isFinite(Number(value)) ? Number(value) : 0;
+}