aienvmp 0.1.32 → 0.1.34

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.1.34
+
+- Added AI navigation metadata to `.aienvmp/status.json`.
+- Included artifact paths, read order, safe commands, and agent-use rules in the compact status output.
+- Kept the status enhancement read-only and lightweight so `sync` remains the simple default flow.
+
+## 0.1.33
+
+- Made `.aienvmp/status.json` a first-class artifact written by `aienvmp sync`.
+- Added `aienvmp status --write` so AI agents and CI can refresh the compact state file directly.
+- Updated the GitHub Action to use the built-in status writer instead of shell redirection.
+
 ## 0.1.32
 
 - Added GitHub Action support for writing `.aienvmp/status.json` by default.

package/README.md

@@ -45,6 +45,7 @@ npx aienvmp handoff --record --actor agent:codex
 ```text
 AIENV.md
 .aienvmp/manifest.json
+.aienvmp/status.json       # first file for AI: clear/review, next command, strict advice
 .aienvmp/intents.jsonl
 .aienvmp/timeline.jsonl
 .aienvmp/plan.json
@@ -53,6 +54,7 @@ AIENV.md
 ```
 
 Trust states are machine-readable: `observed`, `planned`, `changed`, `review`, `verified`, `stale`.
+`status.json` also lists AI read order, artifact paths, and safe commands.
 
 AI agents can observe, plan, and record. Only a human or CI should mark environment facts as verified.
 
@@ -81,8 +83,8 @@ The dashboard shows which strict scopes are CI-ready before you enforce them.
 ## Commands
 
 ```bash
-aienvmp sync              # update env map, light SBOM, ledger, dashboard
-aienvmp status            # one compact clear/review decision
+aienvmp sync              # update env map, light SBOM, status, ledger, dashboard
+aienvmp status --write    # refresh .aienvmp/status.json only
 aienvmp context           # AI preflight brief
 aienvmp context --json    # AI decision contract + actions + compact step summary
 aienvmp plan              # read-only AI action plan using the same decision contract

package/action.yml

@@ -38,8 +38,7 @@ runs:
       shell: bash
       run: |
         if [ "${{ inputs.write-status }}" = "true" ]; then
-          mkdir -p "${{ inputs.directory }}/.aienvmp"
-          node "$GITHUB_ACTION_PATH/bin/aienvmp.js" status --dir "${{ inputs.directory }}" --json > "${{ inputs.directory }}/.aienvmp/status.json"
+          node "$GITHUB_ACTION_PATH/bin/aienvmp.js" status --dir "${{ inputs.directory }}" --write --quiet
         fi
 
     - name: Doctor

package/package.json

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

package/src/cli.js

@@ -80,13 +80,13 @@ function printUsage() {
 Usage:
   aienvmp sync [--dir .] [--json] [--quiet] [--deep] [--security]
   aienvmp context [--dir .] [--json]
-  aienvmp status [--dir .] [--json]
+  aienvmp status [--dir .] [--json] [--write] [--quiet]
   aienvmp handoff [--dir .] [--json] [--record --actor agent:id]
   aienvmp plan [--dir .] [--json] [--write]
 
 Common:
-  aienvmp sync      update AIENV.md, manifest, ledger, intents, and dashboard
-  aienvmp status    print one simple environment decision
+  aienvmp sync      update AIENV.md, manifest, status, ledger, intents, and dashboard
+  aienvmp status    print one simple environment decision; --write saves .aienvmp/status.json
   aienvmp context   print the AI preflight brief
   aienvmp handoff   print the next-agent handoff summary
   aienvmp plan      print a read-only AI environment action plan

package/src/commands/status.js

@@ -1,7 +1,9 @@
+import fs from "node:fs/promises";
+import path from "node:path";
 import { diagnose } from "../doctor.js";
 import { readJson } from "../fsutil.js";
 import { loadPolicy, policyWarnings } from "../policy.js";
-import { intentsPath, manifestPath, timelinePath, workspaceDir } from "../paths.js";
+import { intentsPath, manifestPath, statusJsonPath, timelinePath, workspaceDir } from "../paths.js";
 import { openIntents, readJsonl, readTimeline } from "../timeline.js";
 import { recommendedActions } from "../actions.js";
 import { aiDecision } from "../decision.js";
@@ -16,14 +18,24 @@ export async function statusWorkspace(args) {
   const intents = openIntents(await readJsonl(intentsPath(dir)));
   const warnings = [...diagnose(manifest, { timeline, intents }), ...policyWarnings(manifest, policy)];
   const status = buildStatus(manifest, warnings, intents);
+  const artifact = args.write ? await writeStatusArtifact(dir, status) : "";
+  const output = artifact ? { ...status, artifact } : status;
   if (args.json) {
-    console.log(JSON.stringify(status, null, 2));
-  } else {
-    console.log(`${status.state}: ${status.summary}`);
-    console.log(`next: ${status.nextCommand}`);
-    console.log(`strict: ${status.enforcement.recommendedCommand}`);
+    console.log(JSON.stringify(output, null, 2));
+  } else if (!args.quiet) {
+    console.log(`${output.state}: ${output.summary}`);
+    console.log(`next: ${output.nextCommand}`);
+    console.log(`strict: ${output.enforcement.recommendedCommand}`);
+    if (artifact) console.log(`status: ${artifact}`);
   }
-  return status;
+  return output;
+}
+
+export async function writeStatusArtifact(dir, status) {
+  const out = statusJsonPath(dir);
+  await fs.mkdir(path.dirname(out), { recursive: true });
+  await fs.writeFile(out, JSON.stringify(status, null, 2), "utf8");
+  return out;
 }
 
 export function buildStatus(manifest = {}, warnings = [], intents = []) {
@@ -47,7 +59,43 @@ export function buildStatus(manifest = {}, warnings = [], intents = []) {
       dependencies: Number(manifest.dependencySnapshot?.summary?.packages || 0),
       vulnerabilities: Number(manifest.security?.summary?.total || 0)
     },
+    agentUse: {
+      purpose: "First AI-readable environment preflight for this workspace.",
+      rule: "Read status first, use context for details, record intent before environment changes.",
+      projectLocalWork: decision.canContinueProjectLocalWork ? "allowed" : "review-first",
+      environmentChanges: decision.canChangeEnvironmentWithoutReview ? "allowed" : "intent-and-review-first"
+    },
+    artifacts: statusArtifacts(),
+    readOrder: [
+      ".aienvmp/status.json",
+      "AIENV.md",
+      ".aienvmp/manifest.json",
+      ".aienvmp/plan.json",
+      ".aienvmp/timeline.jsonl",
+      ".aienvmp/intents.jsonl"
+    ],
+    commands: {
+      refresh: "aienvmp sync",
+      status: "aienvmp status --write",
+      context: "aienvmp context --json",
+      plan: "aienvmp plan --write",
+      handoff: "aienvmp handoff --record --actor agent:id",
+      recordIntent: "aienvmp intent --actor agent:id --action planned-change"
+    },
     topAction,
     nextCommand: topAction?.command || decision.nextCommand
   };
 }
+
+function statusArtifacts() {
+  return {
+    status: ".aienvmp/status.json",
+    envMap: "AIENV.md",
+    manifest: ".aienvmp/manifest.json",
+    dashboard: ".aienvmp/dashboard.html",
+    planJson: ".aienvmp/plan.json",
+    planMarkdown: ".aienvmp/plan.md",
+    intents: ".aienvmp/intents.jsonl",
+    timeline: ".aienvmp/timeline.jsonl"
+  };
+}

package/src/commands/sync.js

@@ -2,6 +2,7 @@ import { initWorkspace } from "./init.js";
 import { scanWorkspace } from "./scan.js";
 import { compileWorkspace } from "./compile.js";
 import { dashWorkspace } from "./dash.js";
+import { statusWorkspace } from "./status.js";
 
 export async function syncWorkspace(args) {
   const quiet = args.quiet || args.json;
@@ -11,6 +12,7 @@ export async function syncWorkspace(args) {
   const scanned = await scanWorkspace(next);
   const compiled = await compileWorkspace(next);
   const dashboard = await dashWorkspace(next);
+  const status = await statusWorkspace({ ...next, json: false, write: true, quiet: true });
 
   const result = {
     status: "ok",
@@ -18,6 +20,7 @@ export async function syncWorkspace(args) {
       aiEnv: compiled.aiEnv,
       manifest: scanned.manifest,
       timeline: scanned.timeline,
+      status: status.artifact,
       dashboard: dashboard.dashboard
     },
     changes: scanned.changes,
@@ -27,7 +30,7 @@ export async function syncWorkspace(args) {
   if (args.json) {
     console.log(JSON.stringify(result, null, 2));
   } else if (!quiet) {
-    console.log("sync complete: AIENV.md, manifest, ledger, intents, and dashboard are up to date");
+    console.log("sync complete: AIENV.md, manifest, status, ledger, intents, and dashboard are up to date");
   }
 
   return result;

package/src/paths.js

@@ -12,6 +12,10 @@ export function manifestPath(dir) {
   return path.join(stateDir(dir), "manifest.json");
 }
 
+export function statusJsonPath(dir) {
+  return path.join(stateDir(dir), "status.json");
+}
+
 export function previousManifestPath(dir) {
   return path.join(stateDir(dir), "manifest.previous.json");
 }