aienvmp 0.1.62 → 0.1.64

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.1.64
+
+- Added a dashboard `AI control strip` above the existing audit area.
+- Made readiness, collaboration, and SBOM risk the first three dashboard decisions.
+- Added compact status, next command, and review guidance to each top control card.
+- Added responsive control-strip layout for narrow screens.
+- Kept the detailed dashboard cards below the first-read control strip.
+- Documented the dashboard 3-card first-read surface in the README.
+- Added dashboard regression coverage for the control strip, top cards, and SBOM-risk binding.
+
+## 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

@@ -52,6 +52,7 @@ AIENV.md                 # Markdown env map for AI agents
 - `status.json.nextAgent` tells the next AI what to read and whether to review first.
 - `aiReadiness` gives a one-field ready/review signal for AI continuation.
 - `collaboration` gives the shortest multi-agent env-change status, targets, and next command.
+- `dashboard.html` starts with a 3-card AI control strip: readiness, collaboration, SBOM risk.
 - `dependencyReadSet` lists manifests and lockfiles before package or security changes.
 - `sbomRisk` gives AI a compact light-SBOM risk level, signals, and next command.
 - `sbom.json.aiDependencyReview` connects SBOM risk, scanner confidence, and safe dependency-change steps.
@@ -82,7 +83,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.64",
   "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;
+}

package/src/render.js

@@ -381,6 +381,13 @@ h1,h2,h3,p{margin:0}h1{font-size:clamp(28px,4vw,46px);line-height:1.02;margin-to
 .sub{color:var(--muted);margin-top:12px;max-width:680px;line-height:1.55}
 .stamp{min-width:220px;border:1px solid var(--line2);background:#091310;border-radius:8px;padding:14px}
 .stamp b{display:block;color:var(--green);font-size:24px;margin-bottom:3px}.stamp span{display:block;color:var(--muted);font-size:12px;overflow-wrap:anywhere}
+.control{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:12px;margin:14px 0}
+.control-card{border:1px solid var(--line);background:rgba(13,24,21,.94);border-radius:8px;padding:16px;min-width:0}
+.control-card.review{border-color:rgba(244,191,95,.42);background:linear-gradient(135deg,rgba(81,53,17,.82),rgba(9,19,16,.95))}
+.control-card.ready{border-color:rgba(71,229,141,.32);background:linear-gradient(135deg,rgba(19,61,42,.76),rgba(9,19,16,.95))}
+.control-label{color:var(--muted);font-size:12px;font-weight:800;text-transform:uppercase;letter-spacing:.08em}
+.control-value{margin-top:8px;font-size:24px;font-weight:850;color:var(--text);overflow-wrap:anywhere}
+.control-next{margin-top:8px;color:var(--muted);font-size:12px;line-height:1.4;overflow-wrap:anywhere}
 .audit{display:grid;grid-template-columns:1.2fr repeat(3,minmax(0,.8fr));gap:12px;margin:14px 0}
 .audit-item{border:1px solid var(--line);background:rgba(13,24,21,.92);border-radius:8px;padding:14px;min-width:0}
 .audit-item.primary{background:linear-gradient(135deg,rgba(19,61,42,.88),rgba(9,19,16,.95))}
@@ -404,6 +411,7 @@ code{color:var(--code);background:#0a2017;border:1px solid #17462f;padding:2px 6
 .timeline{display:grid;gap:10px}.event{display:grid;grid-template-columns:108px 1fr;gap:12px;border-top:1px solid var(--line2);padding-top:10px}.event time{color:var(--muted);font-size:12px}.event b{color:var(--green)}
 .path{font-family:ui-monospace,SFMono-Regular,Consolas,monospace;color:var(--muted);font-size:12px;overflow-wrap:anywhere}
 @media (max-width:860px){header,.layout{grid-template-columns:1fr}.metrics{grid-template-columns:repeat(2,1fr)}.grid{grid-template-columns:1fr}.agents{grid-template-columns:1fr}}
+@media (max-width:860px){.control{grid-template-columns:1fr}}
 @media (max-width:860px){.audit{grid-template-columns:1fr 1fr}}
 @media (max-width:520px){.shell{padding:14px}.metrics{grid-template-columns:1fr}.event{grid-template-columns:1fr}h1{font-size:32px}}
 @media (max-width:520px){.audit{grid-template-columns:1fr}}
@@ -496,11 +504,20 @@ const recentChanges=timeline.slice(-8).length;
 const trustState=manifest.trust?.state||'observed';
 const nextAction=reviewRequired?'Review before environment changes':'Proceed with project-local work';
 const auditItem=(key,value,hint,klass='')=>\`<div class="audit-item \${klass}"><div class="audit-k">\${key}</div><div class="audit-v">\${value}</div><div class="audit-hint">\${hint}</div></div>\`;
+const controlCard=(label,value,next,klass='')=>\`<div class="control-card \${klass}"><div class="control-label">\${label}</div><div class="control-value">\${esc(value)}</div><div class="control-next">\${esc(next)}</div></div>\`;
 const driftLabel=warnings.length?'detected':'none';
 const nextAgent=manifest.preflight?.nextAgent||{};
 const aiReadiness=manifest.preflight?.aiReadiness||{};
 const aiReadinessSignals=(aiReadiness.signals||[]).slice(0,3);
 const aiReadinessHint=(aiReadiness.next||'Run aienvmp context --json for details.')+(aiReadinessSignals.length?' Signals: '+aiReadinessSignals.join('; '):'');
+const aiReadyValue=aiReadiness.level||'unknown';
+const aiReadyClass=aiReadyValue==='ready'?'ready':'review';
+const collaborationValue=collaboration.status||'unknown';
+const collaborationClass=collaborationValue==='clear'?'ready':'review';
+const sbomRiskValue=riskSummary.level||'unknown';
+const sbomRiskClass=['urgent','high','medium'].includes(sbomRiskValue)?'review':'ready';
+const sbomRiskScore=riskSummary.score!==undefined?' ('+riskSummary.score+')':'';
+const sbomRiskNext=riskSummary.next||aiDependencyReview.beforeDependencyChange?.[0]||'Run aienvmp sbom --json for dependency context.';
 const coordination=manifest.preflight?.coordination||{};
 const conflictTargets=coordination.conflictTargets||[];
 const handoffFiles=nextAgent.dependencyFiles?.length?nextAgent.dependencyFiles:(dependencyReadSet[0]?[dependencyReadSet[0].manifest,...(dependencyReadSet[0].lockfiles||[])].filter(Boolean):[]);
@@ -515,6 +532,11 @@ document.getElementById('app').innerHTML=\`
   </div>
   <div class="stamp"><b>\${warnings.length?'review':'clear'}</b><span>\${esc(manifest.workspace.name)}</span><span>\${esc(manifest.generatedAt)}</span></div>
 </header>
+<section class="control" aria-label="AI control strip">
+  \${controlCard('AI readiness',aiReadyValue,aiReadiness.next||'Run aienvmp context --json for details.',aiReadyClass)}
+  \${controlCard('Collaboration',collaborationValue,collaboration.nextCommand||'aienvmp status --json',collaborationClass)}
+  \${controlCard('SBOM risk',sbomRiskValue+sbomRiskScore,sbomRiskNext,sbomRiskClass)}
+</section>
 <section class="audit" aria-label="Audit summary">
   \${auditItem('AI decision',reviewRequired?'review required':'can proceed',nextAction,reviewRequired?'review':'primary')}
   \${auditItem('AI readiness',aiReadiness.level||'unknown',aiReadinessHint,aiReadiness.level==='ready'?'primary':'review')}