aienvmp 0.1.16 → 0.1.17

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 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

@@ -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.17",
   "description": "AI-first environment maps and lightweight runtime SBOMs for shared development machines.",
   "type": "module",
   "bin": {

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>