aienvmp 0.1.31 → 0.1.33

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # 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.
+- Added a `write-status` action input so CI can keep compact AI status artifacts optional.
+- Updated the GitHub Action example artifact list to include the status output.
+
 ## 0.1.31
 
 - Added `aienvmp status` as a compact human and AI entrypoint.

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
@@ -67,11 +68,13 @@ 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).
+CI also writes `.aienvmp/status.json` for a compact AI-readable result.
 The dashboard shows which strict scopes are CI-ready before you enforce them.
 
 ```yaml
 - uses: soovwv/aienvmp@main
   with:
+    write-status: "true"
     write-plan: "true"
     strict: "off" # security, policy, coordination, all, or off
 ```
@@ -79,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

@@ -15,6 +15,10 @@ inputs:
     description: Write read-only AI plan artifacts
     required: false
     default: "true"
+  write-status:
+    description: Write compact AI status artifact
+    required: false
+    default: "true"
 
 runs:
   using: composite
@@ -30,6 +34,13 @@ runs:
           node "$GITHUB_ACTION_PATH/bin/aienvmp.js" plan --dir "${{ inputs.directory }}" --write --json
         fi
 
+    - name: Write AI status
+      shell: bash
+      run: |
+        if [ "${{ inputs.write-status }}" = "true" ]; then
+          node "$GITHUB_ACTION_PATH/bin/aienvmp.js" status --dir "${{ inputs.directory }}" --write --quiet
+        fi
+
     - name: Doctor
       shell: bash
       run: |

package/examples/github-action.yml

@@ -23,6 +23,7 @@ jobs:
           path: |
             AIENV.md
             .aienvmp/manifest.json
+            .aienvmp/status.json
             .aienvmp/plan.json
             .aienvmp/plan.md
             .aienvmp/dashboard.html

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aienvmp",
-  "version": "0.1.31",
+  "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");
 }