aienvmp 0.1.30 → 0.1.32

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 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.
+- Summarized clear/review state, next command, counts, top action, and enforcement advice in one output.
+- Kept `context --json` as the richer preflight while making first checks simpler.
+
 ## 0.1.30
 
 - Added shared enforcement advice for AI and CI surfaces.

package/README.md

@@ -16,6 +16,7 @@ Core loop: scan once, link runtime/dependency/security context, give AI a shared
 
 ```bash
 npx aienvmp sync
+npx aienvmp status
 npx aienvmp context
 npx aienvmp plan
 npx aienvmp handoff
@@ -66,11 +67,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,6 +82,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 status            # one compact clear/review decision
 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,14 @@ 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
+          mkdir -p "${{ inputs.directory }}/.aienvmp"
+          node "$GITHUB_ACTION_PATH/bin/aienvmp.js" status --dir "${{ inputs.directory }}" --json > "${{ inputs.directory }}/.aienvmp/status.json"
+        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.30",
+  "version": "0.1.32",
   "description": "AI-first environment maps and lightweight runtime SBOMs for shared development machines.",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -12,6 +12,7 @@ import { syncWorkspace } from "./commands/sync.js";
 import { snippetWorkspace } from "./commands/snippet.js";
 import { handoffWorkspace } from "./commands/handoff.js";
 import { planWorkspace } from "./commands/plan.js";
+import { statusWorkspace } from "./commands/status.js";
 import { readFileSync } from "node:fs";
 
 const commands = new Map([
@@ -28,7 +29,8 @@ const commands = new Map([
   ["sync", syncWorkspace],
   ["snippet", snippetWorkspace],
   ["handoff", handoffWorkspace],
-  ["plan", planWorkspace]
+  ["plan", planWorkspace],
+  ["status", statusWorkspace]
 ]);
 
 const version = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
@@ -78,11 +80,13 @@ function printUsage() {
 Usage:
   aienvmp sync [--dir .] [--json] [--quiet] [--deep] [--security]
   aienvmp context [--dir .] [--json]
+  aienvmp status [--dir .] [--json]
   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 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

@@ -0,0 +1,53 @@
+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 { openIntents, readJsonl, readTimeline } from "../timeline.js";
+import { recommendedActions } from "../actions.js";
+import { aiDecision } from "../decision.js";
+import { enforcementAdvice } from "../enforcement.js";
+
+export async function statusWorkspace(args) {
+  const dir = workspaceDir(args);
+  const manifest = await readJson(manifestPath(dir));
+  if (!manifest) throw new Error("missing manifest; run `aienvmp sync` first");
+  const policy = await loadPolicy(dir);
+  const timeline = await readTimeline(timelinePath(dir));
+  const intents = openIntents(await readJsonl(intentsPath(dir)));
+  const warnings = [...diagnose(manifest, { timeline, intents }), ...policyWarnings(manifest, policy)];
+  const status = buildStatus(manifest, warnings, intents);
+  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}`);
+  }
+  return status;
+}
+
+export function buildStatus(manifest = {}, warnings = [], intents = []) {
+  const decision = aiDecision(warnings, intents);
+  const enforcement = enforcementAdvice(warnings);
+  const actions = recommendedActions(manifest, { warnings, intents });
+  const state = decision.reviewRequired ? "review-required" : "clear";
+  const topAction = actions[0] || null;
+  return {
+    schemaVersion: 1,
+    state,
+    summary: state === "clear"
+      ? "Project-local work can continue. Record intent before environment changes."
+      : "Review warnings or open intents before environment changes.",
+    decision,
+    enforcement,
+    counts: {
+      warnings: warnings.length,
+      openIntents: intents.length,
+      runtimes: Object.keys(manifest.runtimes || {}).length,
+      dependencies: Number(manifest.dependencySnapshot?.summary?.packages || 0),
+      vulnerabilities: Number(manifest.security?.summary?.total || 0)
+    },
+    topAction,
+    nextCommand: topAction?.command || decision.nextCommand
+  };
+}