aienvmp 0.1.32 → 0.1.33

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 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
@@ -81,8 +82,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.33",
   "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 = []) {

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");
 }