aienvmp 0.1.16 → 0.1.18

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.1.18
+
+- Added a dashboard remediation steps card backed by `.aienvmp/plan.json`.
+- Kept dashboard remediation details bounded to package, severity, fix version, and advisory references.
+- Improved human visibility for AI-generated read-only security plans.
+
+## 0.1.17
+
+- Added bounded security remediation steps to `aienvmp plan`.
+- Included package fix versions and advisory references in plan JSON and markdown output.
+- Kept remediation output read-only and review-oriented.
+
 ## 0.1.16
 
 - Added scoped strict checks with `doctor --strict security|policy|coordination|all`.

package/README.md

@@ -38,7 +38,7 @@ AIENV.md
 .aienvmp/timeline.jsonl
 .aienvmp/plan.json
 .aienvmp/plan.md
-.aienvmp/dashboard.html
+.aienvmp/dashboard.html     # includes plan and remediation cards
 ```
 
 Trust states are machine-readable: `observed`, `planned`, `changed`, `review`, `verified`, `stale`.
@@ -59,7 +59,7 @@ npx aienvmp snippet agents
 aienvmp sync              # update env map, light SBOM, ledger, dashboard
 aienvmp context           # AI preflight brief
 aienvmp context --json    # machine-readable AI decision context + recommended actions
-aienvmp plan              # read-only AI action plan, no automatic fixes
+aienvmp plan              # read-only AI action plan with remediation steps
 aienvmp handoff           # next-agent handoff summary + recommended actions
 aienvmp intent            # record a planned env change
 aienvmp record            # record what changed

package/package.json

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

package/src/commands/dash.js

@@ -18,7 +18,8 @@ export async function dashWorkspace(args) {
   const policy = await loadPolicy(dir);
   const warnings = [...diagnose(manifest, { timeline, intents }), ...policyWarnings(manifest, policy)];
   const planArtifacts = await detectedPlanArtifacts(dir);
-  const html = renderDashboard({ ...manifest, recommendedActions: recommendedActions(manifest, { warnings, intents }), planArtifacts }, timeline, warnings, intents, policy);
+  const planRemediation = await detectedPlanRemediation(dir);
+  const html = renderDashboard({ ...manifest, recommendedActions: recommendedActions(manifest, { warnings, intents }), planArtifacts, planRemediation }, timeline, warnings, intents, policy);
   const out = dashboardPath(dir);
   await fs.mkdir(path.dirname(out), { recursive: true });
   await fs.writeFile(out, html, "utf8");
@@ -36,6 +37,17 @@ async function detectedPlanArtifacts(dir) {
   };
 }
 
+async function detectedPlanRemediation(dir) {
+  const plan = await readJson(planJsonPath(dir), {});
+  return (plan.remediationSteps || []).slice(0, 5).map((item) => ({
+    package: item.package || "unknown",
+    severity: item.severity || "unknown",
+    fixVersions: Array.isArray(item.fixVersions) ? item.fixVersions.slice(0, 3) : [],
+    fixAvailable: item.fixAvailable === true,
+    advisories: Array.isArray(item.advisories) ? item.advisories.map((advisory) => advisory.id || advisory.title).filter(Boolean).slice(0, 2) : []
+  }));
+}
+
 function openFile(file) {
   if (process.platform === "win32") {
     execFile("cmd", ["/c", "start", "", file], { windowsHide: true });

package/src/commands/plan.js

@@ -56,6 +56,7 @@ export function buildPlan(manifest, warnings = [], intents = [], policy = {}) {
       summary: manifest.security?.summary || { total: 0, critical: 0, high: 0, moderate: 0, low: 0, info: 0 },
       topPackages: manifest.security?.topPackages || []
     },
+    remediationSteps: remediationSteps(manifest.security),
     notes: [
       "This plan is read-only.",
       "Ask the user before global runtime, package manager, Docker, or global package changes.",
@@ -64,6 +65,35 @@ export function buildPlan(manifest, warnings = [], intents = [], policy = {}) {
   };
 }
 
+function remediationSteps(security = {}) {
+  if (!security.enabled) return [];
+  return (security.topPackages || []).slice(0, 8).map((pkg) => {
+    const fixVersions = Array.isArray(pkg.fixVersions) ? pkg.fixVersions.slice(0, 5) : [];
+    const advisories = Array.isArray(pkg.advisories)
+      ? pkg.advisories.map((item) => ({
+        id: item.id || "",
+        title: item.title || "",
+        url: item.url || "",
+        severity: item.severity || pkg.severity || "unknown"
+      })).slice(0, 5)
+      : [];
+    return {
+      package: pkg.name,
+      scanner: pkg.scanner || "unknown",
+      severity: pkg.severity || "unknown",
+      fixAvailable: pkg.fixAvailable === true,
+      fixVersions,
+      advisories,
+      steps: [
+        "Review the package changelog and advisory details.",
+        fixVersions.length ? `Prefer an upgrade path to ${fixVersions.join(", ")} if compatible.` : "Identify a compatible patched version before changing dependencies.",
+        "Run project tests after dependency changes.",
+        "Record the environment or dependency change with aienvmp record."
+      ]
+    };
+  });
+}
+
 function reviewGates(warnings, intents, security = {}) {
   const gates = [];
   if (warnings.length) gates.push("Review warnings before changing the environment.");

package/src/render.js

@@ -182,6 +182,9 @@ export function renderPlan(plan) {
     "Review gates:",
     ...plan.reviewGates.map((item) => `- ${item}`),
     "",
+    "Remediation steps:",
+    ...(plan.remediationSteps?.length ? plan.remediationSteps.slice(0, 5).flatMap(remediationLines) : ["- none"]),
+    "",
     "Warnings:",
     ...(plan.warnings.length ? plan.warnings.map((warning) => `- [${warning.code}] ${warning.message}`) : ["- none"]),
     ""
@@ -189,6 +192,15 @@ export function renderPlan(plan) {
   return lines.join("\n");
 }
 
+function remediationLines(item) {
+  const fix = item.fixVersions?.length ? `fix ${item.fixVersions.join(", ")}` : item.fixAvailable ? "fix available" : "review required";
+  const advisories = (item.advisories || []).map((advisory) => advisory.id || advisory.title).filter(Boolean).slice(0, 2);
+  return [
+    `- ${item.package}: ${item.severity}; ${fix}${advisories.length ? `; advisories ${advisories.join(", ")}` : ""}`,
+    ...item.steps.slice(0, 4).map((step) => `  - ${step}`)
+  ];
+}
+
 export function renderDashboard(manifest, timeline = [], warnings = [], intents = [], policy = {}) {
   const data = JSON.stringify({ manifest, timeline, warnings, intents, policy });
   return `<!doctype html>
@@ -266,6 +278,10 @@ const actions=manifest.recommendedActions||[];
 const actionsHtml=actions.length?'<div class="timeline">'+actions.slice(0,6).map(a=>\`<div class="event"><time>\${esc(a.priority)}</time><div><b>\${esc(a.category)}</b> \${esc(a.summary)}\${a.command?\`<div class="path">\${esc(a.command)}</div>\`:''}</div></div>\`).join('')+'</div>':'<div class="okline">No recommended actions. Continue project-local work.</div>';
 const plan=manifest.planArtifacts||{};
 const planHtml=plan.markdown||plan.json?\`<table><tr><th>Markdown</th><td>\${plan.markdown?'<a href="plan.md">plan.md</a>':'not written'}</td></tr><tr><th>JSON</th><td>\${plan.json?'<a href="plan.json">plan.json</a>':'not written'}</td></tr></table>\`:'<div class="okline">No plan artifacts yet. Run <code>aienvmp plan --write</code>.</div>';
+const remediation=manifest.planRemediation||[];
+const remediationFix=r=>r.fixVersions?.length?\`fix \${r.fixVersions.join(', ')}\`:(r.fixAvailable?'fix available':'review required');
+const remediationRefs=r=>r.advisories?.length?\` - \${r.advisories.join(', ')}\`:'';
+const remediationHtml=remediation.length?'<div class="timeline">'+remediation.map(r=>\`<div class="event"><time>\${esc(r.severity)}</time><div><b>\${esc(r.package)}</b> \${esc(remediationFix(r))}\${esc(remediationRefs(r))}</div></div>\`).join('')+'</div>':'<div class="okline">No remediation steps in the current plan.</div>';
 const card=(title,badge,body)=>\`<section class="card"><div class="card-head"><h2>\${title}</h2>\${badge||''}</div>\${body}</section>\`;
 const reviewRequired=warnings.length>0||intents.length>0;
 const recentChanges=timeline.slice(-8).length;
@@ -309,6 +325,8 @@ document.getElementById('app').innerHTML=\`
     <div style="height:14px"></div>
     \${card('AI Plan Artifacts',plan.markdown||plan.json?'<span class="pill">written</span>':'<span class="pill off">not written</span>',planHtml)}
     <div style="height:14px"></div>
+    \${card('Remediation Steps',remediation.length?'<span class="pill warn">'+remediation.length+' items</span>':'<span class="pill off">none</span>',remediationHtml)}
+    <div style="height:14px"></div>
     \${card('Environment Health',warnings.length?'<span class="pill warn">attention</span>':'<span class="pill">clear</span>',warnHtml)}
     <div style="height:14px"></div>
     \${card('Version Policy','<span class="pill">'+entries(policy).length+' rules</span>',policyHtml)}