aienvmp 0.1.24 → 0.1.25

package/CHANGELOG.md

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

package/README.md

@@ -80,7 +80,7 @@ The dashboard shows which strict scopes are CI-ready before you enforce them.
 ```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.24",
+  "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/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"}`,