aienvmp 0.1.23 → 0.1.25

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.1.25
+
+- Added a more explicit AI decision contract to `context --json`.
+- Included project-local work allowance, environment-change review state, warning codes, and required follow-up commands.
+- Clarified that local project work can continue while environment changes remain intent-gated and review-oriented.
+
+## 0.1.24
+
+- Added a dashboard CI Readiness card for `doctor --strict security|policy|coordination|all`.
+- Reused the same non-blocking warning engine so humans can pick CI enforcement scope without changing local operation.
+- Surfaced matched warning codes per strict scope for faster AI and human review.
+
 ## 0.1.23
 
 - Added compact `stepSummary` output to `context --json`.

package/README.md

@@ -66,6 +66,7 @@ npx aienvmp snippet agents
 ## CI Usage
 
 Use the GitHub Action to write the env map, plan, dashboard, and optional strict checks. See [examples/github-action.yml](examples/github-action.yml).
+The dashboard shows which strict scopes are CI-ready before you enforce them.
 
 ```yaml
 - uses: soovwv/aienvmp@main
@@ -79,7 +80,7 @@ Use the GitHub Action to write the env map, plan, dashboard, and optional strict
 ```bash
 aienvmp sync              # update env map, light SBOM, ledger, dashboard
 aienvmp context           # AI preflight brief
-aienvmp context --json    # AI decision context + actions + compact step summary
+aienvmp context --json    # AI decision contract + actions + compact step summary
 aienvmp plan              # read-only AI action plan for drift and remediation
 aienvmp handoff           # next-agent handoff summary + recommended actions
 aienvmp intent            # record a planned env change

package/package.json

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

package/src/commands/context.js

@@ -63,11 +63,19 @@ function inventorySummary(inventory = {}) {
 }
 
 function contextDecision(warnings, intents) {
+  const warningCodes = warnings.map((warning) => warning.code);
   const reviewRequired = warnings.length > 0 || intents.length > 0;
+  const canChangeEnvironmentWithoutReview = !reviewRequired;
+  const mode = reviewRequired ? "review-first" : "project-local-work";
   return {
+    schemaVersion: 1,
+    mode,
     canProceed: !reviewRequired,
+    canContinueProjectLocalWork: true,
+    canChangeEnvironmentWithoutReview,
     safeForProjectLocalWork: warnings.length === 0,
     reviewRequired,
+    warningCodes,
     environmentChangeRequiresIntent: true,
     globalEnvironmentChangesRequireUserApproval: true,
     pendingIntentCount: intents.length,
@@ -80,6 +88,13 @@ function contextDecision(warnings, intents) {
     recommendedNextActions: warnings.length
       ? ["review warnings", "ask the user before environment changes", "record intent before changes"]
       : ["continue with project-local work", "run aienvmp intent before environment changes"],
-    nextCommand: warnings.length ? "review warnings before changing environment" : "continue with project-local work"
+    requiredCommands: {
+      beforeEnvironmentChange: "aienvmp intent --actor agent:id --action planned-change --target <runtime|package-manager|docker>",
+      refreshAfterChange: "aienvmp sync",
+      recordAfterChange: "aienvmp record --actor agent:id --summary what-changed",
+      handoff: "aienvmp handoff --record --actor agent:id",
+      reviewPlan: "aienvmp plan"
+    },
+    nextCommand: reviewRequired ? "aienvmp plan" : "continue project-local work; use aienvmp intent before environment changes"
   };
 }

package/src/commands/dash.js

@@ -8,6 +8,7 @@ import { dashboardPath, intentsPath, manifestPath, planJsonPath, planMdPath, tim
 import { renderDashboard } from "../render.js";
 import { loadPolicy, policyWarnings } from "../policy.js";
 import { recommendedActions } from "../actions.js";
+import { strictResult } from "./doctor.js";
 
 export async function dashWorkspace(args) {
   const dir = workspaceDir(args);
@@ -20,7 +21,14 @@ export async function dashWorkspace(args) {
   const planArtifacts = await detectedPlanArtifacts(dir);
   const planRemediation = await detectedPlanRemediation(dir);
   const planEnvironment = await detectedPlanEnvironment(dir);
-  const html = renderDashboard({ ...manifest, recommendedActions: recommendedActions(manifest, { warnings, intents }), planArtifacts, planRemediation, planEnvironment }, timeline, warnings, intents, policy);
+  const html = renderDashboard({
+    ...manifest,
+    recommendedActions: recommendedActions(manifest, { warnings, intents }),
+    planArtifacts,
+    planRemediation,
+    planEnvironment,
+    ciReadiness: ciReadiness(warnings)
+  }, timeline, warnings, intents, policy);
   const out = dashboardPath(dir);
   await fs.mkdir(path.dirname(out), { recursive: true });
   await fs.writeFile(out, html, "utf8");
@@ -29,6 +37,17 @@ export async function dashWorkspace(args) {
   return { dashboard: out };
 }
 
+function ciReadiness(warnings) {
+  return ["security", "policy", "coordination", "all"].map((scope) => {
+    const result = strictResult(warnings, { strict: scope });
+    return {
+      scope,
+      status: result.fail ? "fail" : "pass",
+      matchedWarningCodes: result.matchedWarningCodes
+    };
+  });
+}
+
 async function detectedPlanArtifacts(dir) {
   const json = planJsonPath(dir);
   const markdown = planMdPath(dir);

package/src/render.js

@@ -92,6 +92,7 @@ export function renderContext(manifest, timeline = [], warnings = [], intents =
     "",
     `Status: ${status}`,
     `Next: ${next}`,
+    "Project-local work: allowed; environment changes require intent and review when warnings or open intents exist.",
     `Trust: ${manifest.trust?.state || "observed"} (verified requires human or CI)`,
     `Workspace: ${manifest.workspace.path}`,
     `Node: ${manifest.runtimes.node || "not detected"}`,
@@ -294,6 +295,9 @@ 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 envSteps=manifest.planEnvironment||[];
 const envStepsHtml=envSteps.length?'<div class="timeline">'+envSteps.map(s=>\`<div class="event"><time>\${esc(s.category)}</time><div><b>\${esc(s.code)}</b> \${esc(s.summary)}</div></div>\`).join('')+'</div>':'<div class="okline">No environment steps in the current plan.</div>';
+const ciReadiness=manifest.ciReadiness||[];
+const ciHasFailure=ciReadiness.some(s=>s.status==='fail');
+const ciReadinessHtml=ciReadiness.length?'<table>'+ciReadiness.map(s=>\`<tr><th>\${esc(s.scope)}</th><td><code>\${esc(s.status)}</code>\${s.matchedWarningCodes?.length?\` \${esc(s.matchedWarningCodes.join(', '))}\`:''}</td></tr>\`).join('')+'</table>':'<div class="okline">Run <code>aienvmp doctor --strict security|policy|coordination|all</code> to choose CI enforcement scope.</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;
@@ -341,6 +345,8 @@ document.getElementById('app').innerHTML=\`
     <div style="height:14px"></div>
     \${card('Environment Steps',envSteps.length?'<span class="pill warn">'+envSteps.length+' items</span>':'<span class="pill off">none</span>',envStepsHtml)}
     <div style="height:14px"></div>
+    \${card('CI Readiness',ciHasFailure?'<span class="pill warn">review</span>':'<span class="pill">ready</span>',ciReadinessHtml)}
+    <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)}