aienvmp 0.1.0 → 0.1.1

package/.agents/skills/aienvmp/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: aienvmp
+description: Use before changing runtimes, package managers, Docker settings, global packages, or environment policy in an AI coding workspace. Reads aienvmp context, prevents AI-driven version drift, records intent before environment changes, and records what changed afterward.
+---
+
+# aienvmp
+
+Use `aienvmp` as the shared environment source of truth for this workspace.
+
+The goal is to help multiple AI agents avoid silently installing or using different versions of Node, Python, Docker, package managers, or global tools.
+
+## Preflight
+
+Before environment-impacting work, run:
+
+```bash
+npx aienvmp context
+```
+
+If the output says `review-required`, do not change global runtimes, package managers, Docker settings, or global packages without asking the user.
+
+For machine-readable context, use:
+
+```bash
+npx aienvmp context --json
+```
+
+## Before Environment Changes
+
+Record intent before changing shared environment state:
+
+```bash
+npx aienvmp intent --actor agent:codex --action "<planned change>" --target "<tool-or-runtime>"
+```
+
+Use this for changes such as:
+
+- installing or upgrading Node, Python, Docker, package managers, or global CLIs
+- changing `.nvmrc`, `.python-version`, `mise.toml`, `.tool-versions`, or `.aienvmp/policy.yml`
+- switching package managers
+- changing Docker daemon/context assumptions
+
+## After Environment Changes
+
+Refresh the environment map:
+
+```bash
+npx aienvmp scan
+npx aienvmp compile
+```
+
+Record what changed:
+
+```bash
+npx aienvmp record --actor agent:codex --summary "<what changed>" --target "<tool-or-runtime>" --evidence "<command or file>"
+```
+
+Resolve the original intent if complete:
+
+```bash
+npx aienvmp resolve --actor agent:codex --id "<intent-id>"
+```
+
+## Safety Rules
+
+- `aienvmp` warnings are non-blocking by default.
+- Treat policy mismatches as review-required.
+- Do not install, upgrade, downgrade, or remove global software unless the user explicitly asks.
+- Prefer project-local version files and local environments.
+- Do not use warnings as permission to interrupt production or shared workspace operations.
+- Use `npx aienvmp doctor --ci` only in CI or explicit strict-mode automation.
+
+## Normal Coding Work
+
+For ordinary source edits that do not affect runtime versions, package managers, Docker settings, global packages, or environment policy, you do not need to record an intent.

package/README.md

@@ -109,6 +109,14 @@ Generated agent targets:
 - `CLAUDE.md`
 - `GEMINI.md`
 
+Codex can also use the repo-scoped skill:
+
+```text
+.agents/skills/aienvmp/SKILL.md
+```
+
+Invoke it explicitly as `$aienvmp`, or let Codex select it when the task involves runtime, package manager, Docker, global package, or environment policy changes.
+
 ## What AI Agents See
 
 `aienvmp context` returns a compact preflight brief:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aienvmp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "AI-first environment maps and lightweight runtime SBOMs for shared development machines.",
   "type": "module",
   "bin": {
@@ -24,7 +24,8 @@
     "SECURITY.md",
     "ROADMAP.md",
     "action.yml",
-    "examples"
+    "examples",
+    ".agents"
   ],
   "scripts": {
     "test": "node --test",

package/src/cli.js

@@ -8,6 +8,7 @@ import { contextWorkspace } from "./commands/context.js";
 import { recordWorkspace } from "./commands/record.js";
 import { intentWorkspace } from "./commands/intent.js";
 import { resolveWorkspace } from "./commands/resolve.js";
+import { readFileSync } from "node:fs";
 
 const commands = new Map([
   ["init", initWorkspace],
@@ -22,7 +23,7 @@ const commands = new Map([
   ["resolve", resolveWorkspace]
 ]);
 
-const version = "0.1.0";
+const version = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
 
 export async function main(argv) {
   const [command, ...rest] = argv;