@tryinget/pi-agent-vent 0.2.2 → 0.3.1

package/docs/engineering.local.md

@@ -19,7 +19,7 @@ Primary lane:
 Retrieval command:
 
 ```bash
-uv tool -n run --from ~/ai-society/core/engineering-core engineering-core show pi-ts --prefer-repo
+uv tool -n run --from git+https://github.com/tryingET/core_engineering-core.git@27ff32a529b6da6b27051e97fdb1d95a0a9be4ae engineering-core show pi-ts --prefer-repo
 ```
 
 ## Selected disciplines

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tryinget/pi-agent-vent",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "Local pi tool for agents to record recurring frustrations, bugs, and workflow friction without creating incidents or external telemetry",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",
@@ -39,9 +39,9 @@
     "quality:ci": "bash ./scripts/quality-gate.sh ci",
     "check": "npm run quality:ci",
     "test": "npm run quality:ci",
-    "docs:list": "bash ./scripts/docs-list.sh",
-    "docs:list:workspace": "bash ./scripts/docs-list.sh --workspace --discover",
-    "docs:list:json": "bash ./scripts/docs-list.sh --json",
+    "docs:list": "node ~/ai-society/core/agent-scripts/scripts/docs-list.mjs",
+    "docs:list:workspace": "node ~/ai-society/core/agent-scripts/scripts/docs-list.mjs --workspace --discover",
+    "docs:list:json": "node ~/ai-society/core/agent-scripts/scripts/docs-list.mjs --json",
     "release:check": "bash ./scripts/release-check.sh",
     "release:check:quick": "SKIP_PI_SMOKE=1 bash ./scripts/release-check.sh",
     "loop-doctor": "bash -lc 'node --version; npm --version; npm pkg get name version >/dev/null; git status --short -- . || true; exit 0'",
@@ -87,18 +87,17 @@
   },
   "devDependencies": {
     "@biomejs/biome": "2.3.14",
-    "@earendil-works/pi-ai": "0.83.0",
-    "@earendil-works/pi-coding-agent": "0.83.0"
+    "@earendil-works/pi-agent-core": "1.1.0",
+    "@earendil-works/pi-ai": "1.1.0",
+    "@earendil-works/pi-coding-agent": "1.1.0",
+    "typebox": "1.3.7"
   },
   "overrides": {
-    "fast-xml-parser": "5.3.6"
+    "fast-xml-parser": "5.7.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "*",
     "@earendil-works/pi-coding-agent": "*",
     "typebox": "*"
-  },
-  "dependencies": {
-    "typebox": "1.3.7"
   }
 }

package/policy/engineering-lane.json

@@ -4,11 +4,11 @@
     "tool": "engineering-core",
     "lane": "pi-ts",
     "repository": "https://github.com/tryingET/core_engineering-core",
-    "ref": "workspace-local-unpinned",
-    "command": "uv tool -n run --from ~/ai-society/core/engineering-core engineering-core show pi-ts",
-    "catalog_command": "uv tool -n run --from ~/ai-society/core/engineering-core engineering-core catalog --pretty",
-    "list_disciplines_command": "uv tool -n run --from ~/ai-society/core/engineering-core engineering-core list-disciplines",
-    "list_templates_command": "uv tool -n run --from ~/ai-society/core/engineering-core engineering-core list-templates",
+    "ref": "v0.12.2",
+    "command": "uv tool -n run --from git+https://github.com/tryingET/core_engineering-core.git@27ff32a529b6da6b27051e97fdb1d95a0a9be4ae engineering-core show pi-ts",
+    "catalog_command": "uv tool -n run --from git+https://github.com/tryingET/core_engineering-core.git@27ff32a529b6da6b27051e97fdb1d95a0a9be4ae engineering-core catalog --pretty",
+    "list_disciplines_command": "uv tool -n run --from git+https://github.com/tryingET/core_engineering-core.git@27ff32a529b6da6b27051e97fdb1d95a0a9be4ae engineering-core list-disciplines",
+    "list_templates_command": "uv tool -n run --from git+https://github.com/tryingET/core_engineering-core.git@27ff32a529b6da6b27051e97fdb1d95a0a9be4ae engineering-core list-templates",
     "disciplines": [
       "validation",
       "testing",
@@ -29,6 +29,12 @@
         "loop-impact-wide": "npm run loop-impact-wide",
         "loop-landing-check": "npm run loop-landing-check"
       }
+    },
+    "release_pin": {
+      "kind": "git-commit",
+      "ref": "v0.12.2",
+      "resolved_commit": "27ff32a529b6da6b27051e97fdb1d95a0a9be4ae",
+      "source": "git+https://github.com/tryingET/core_engineering-core.git@27ff32a529b6da6b27051e97fdb1d95a0a9be4ae"
     }
   }
 }

package/scripts/release-check.sh

@@ -9,6 +9,8 @@ set -euo pipefail
 ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 REPO_ROOT="$(cd "$ROOT_DIR/../.." && pwd)"
 cd "$ROOT_DIR"
+RELEASE_SANDBOX_ROOT="$(git -C "$ROOT_DIR" rev-parse --show-toplevel)"
+source "$RELEASE_SANDBOX_ROOT/scripts/release-sandbox.sh"
 
 # Scratch-root resolution, from first principles:
 # the invariant is "release-check scratch lands on a managed, disposable root",
@@ -43,46 +45,11 @@ REPOSITORY_URL="$(node -p "(() => { const pkg = JSON.parse(require('node:fs').re
 
 HOST_VERSION="$(node -p "JSON.parse(require('node:fs').readFileSync('package.json', 'utf8')).devDependencies['@earendil-works/pi-coding-agent'] || ''")"
 
-# One release-only policy membrane. Every dependency-resolving command, including
-# Pi's nested npm invocation, must enter through here with disposable cache/prefix.
-RELEASE_MIN_AGE=0
-with_release_npm_policy() {
-  local cache="$1"
-  local prefix="$2"
-  shift 2
-  case "$cache" in
-    "$TMP_ROOT"/pi-agent-vent-*-npm-cache-*) ;;
-    *)
-      echo "Release command refused non-isolated npm cache: $cache" >&2
-      return 1
-      ;;
-  esac
-  if [[ "$prefix" != "-" ]]; then
-    case "$prefix" in
-      "$TMP_ROOT"/pi-agent-vent-*-npm-prefix-*) ;;
-      *)
-        echo "Release command refused non-isolated npm prefix: $prefix" >&2
-        return 1
-        ;;
-    esac
-    (
-      export NPM_CONFIG_PREFIX="$prefix" NPM_CONFIG_CACHE="$cache"
-      export NPM_CONFIG_MIN_RELEASE_AGE="$RELEASE_MIN_AGE"
-      "$@"
-    )
-  else
-    (
-      export NPM_CONFIG_CACHE="$cache" NPM_CONFIG_MIN_RELEASE_AGE="$RELEASE_MIN_AGE"
-      "$@"
-    )
-  fi
-}
-
 release_npm_install() {
-  local cache="$1"
-  local prefix="$2"
+  local _cache="$1"
+  local _prefix="$2"
   shift 2
-  with_release_npm_policy "$cache" "$prefix" npm install \
+  release_sandbox_npm install \
     --include=optional --ignore-scripts --no-audit --fund=false "$@"
 }
 
@@ -128,7 +95,7 @@ if [[ "$NAME" != "${NAME,,}" ]]; then
 fi
 
 echo "== npm pack --dry-run --json"
-PACK_JSON="$(npm --cache "$CONTROL_NPM_CACHE" pack --dry-run --json)"
+PACK_JSON="$(release_sandbox_npm pack --dry-run --json)"
 echo "$PACK_JSON"
 if [[ -f "$REPO_ROOT/scripts/npm-pack-json.mjs" ]]; then
   PACK_JSON="$(printf '%s' "$PACK_JSON" | node "$REPO_ROOT/scripts/npm-pack-json.mjs")"
@@ -138,7 +105,7 @@ PACK_JSON="$PACK_JSON" node ./scripts/release-artifact-check.mjs
 
 echo "== npm publish --dry-run"
 set +e
-PUBLISH_DRY_RUN_OUTPUT="$(npm --cache "$CONTROL_NPM_CACHE" publish --dry-run 2>&1)"
+PUBLISH_DRY_RUN_OUTPUT="$(release_sandbox_npm publish --dry-run 2>&1)"
 PUBLISH_DRY_RUN_EXIT=$?
 set -e
 echo "$PUBLISH_DRY_RUN_OUTPUT"
@@ -152,7 +119,7 @@ if [[ "$PUBLISH_DRY_RUN_EXIT" -ne 0 ]]; then
 fi
 
 echo "== npm pack"
-TARBALL="$(npm --cache "$CONTROL_NPM_CACHE" pack --silent | tail -n 1)"
+TARBALL="$(release_sandbox_npm pack --silent | tail -n 1)"
 TARBALL_PATH="$ROOT_DIR/$TARBALL"
 echo "Tarball: $TARBALL_PATH"
 
@@ -165,13 +132,13 @@ tar -xzf "$TARBALL_PATH" -C "$TARBALL_CHECK_DIR"
   # This isolated artifact probe intentionally selects the exact host contract above.
   # Ordinary installs retain the workstation's npm release-age policy.
   release_npm_install "$TARBALL_NPM_CACHE" -
-  npm run check
+  release_sandbox_npm run check
 )
 
 ARTIFACT_NPM_PREFIX="$(release_tmp_dir artifact-npm-prefix)"
 ARTIFACT_NPM_CACHE="$(release_tmp_dir artifact-npm-cache)"
 ARTIFACT_TOOL_VENT_DIR="$(release_tmp_dir artifact-tool-store)"
-ARTIFACT_PACKAGE_ROOT="$(npm --prefix "$ARTIFACT_NPM_PREFIX" root -g)/$NAME"
+ARTIFACT_PACKAGE_ROOT="$(release_sandbox_npm --prefix "$ARTIFACT_NPM_PREFIX" root -g)/$NAME"
 
 case "$ARTIFACT_PACKAGE_ROOT" in
   "$ARTIFACT_NPM_PREFIX"/*) ;;
@@ -199,41 +166,16 @@ else
     echo "pi CLI not found in PATH." >&2
     exit 1
   fi
-  INSTALLED_PI_VERSION="$(pi --version)"
-  node ./scripts/release-smoke-check.mjs assert-exact-host-contract \
-    --package-json package.json \
-    --host-version "$INSTALLED_PI_VERSION"
-  if [[ ! -f "$HOME/.pi/agent/auth.json" ]]; then
-    echo "Missing $HOME/.pi/agent/auth.json (needed for isolated pi smoke tests)." >&2
-    echo "Tip: set SKIP_PI_SMOKE=1 for artifact-only checks." >&2
-    exit 1
-  fi
-
   TEST_AGENT_DIR="$(release_tmp_dir pi-agent-dir)"
   TEST_NPM_PREFIX="$(release_tmp_dir pi-npm-prefix)"
   TEST_NPM_CACHE="$(release_tmp_dir pi-npm-cache)"
+  release_sandbox_prepare_runtime "$TEST_AGENT_DIR" "$TEST_NPM_PREFIX" "$TEST_NPM_CACHE"
 
-  cp "$HOME/.pi/agent/auth.json" "$TEST_AGENT_DIR/auth.json"
-
-  # Allow override via environment variables for different provider configurations
-  PI_TEST_DEFAULT_PROVIDER="${PI_TEST_DEFAULT_PROVIDER:-openai}"
-  PI_TEST_DEFAULT_MODEL="${PI_TEST_DEFAULT_MODEL:-gpt-4o}"
-  PI_TEST_ENABLED_MODELS="${PI_TEST_ENABLED_MODELS:-[\"openai/gpt-4*\"]}"
-
-  cat > "$TEST_AGENT_DIR/settings.json" <<JSON
-{
-  "defaultProvider": "${PI_TEST_DEFAULT_PROVIDER}",
-  "defaultModel": "${PI_TEST_DEFAULT_MODEL}",
-  "enabledModels": ${PI_TEST_ENABLED_MODELS},
-  "npmCommand": ["npm", "--prefix", "${TEST_NPM_PREFIX}", "--cache", "${TEST_NPM_CACHE}"],
-  "extensions": []
-}
-JSON
-
-  echo "== pi install tarball (isolated PI_CODING_AGENT_DIR and npm prefix)"
+  echo "== pi install tarball (credential-isolated Pi and npm roots)"
   PACKAGE_SPEC="npm:$TARBALL_PATH"
-  PI_CODING_AGENT_DIR="$TEST_AGENT_DIR" \
-    with_release_npm_policy "$TEST_NPM_CACHE" "$TEST_NPM_PREFIX" pi install "$PACKAGE_SPEC"
+  release_sandbox_exec "$TEST_AGENT_DIR" "$TEST_NPM_PREFIX" "$TEST_NPM_CACHE" \
+    pi install "$PACKAGE_SPEC"
+  release_sandbox_link_available_peers "$TEST_AGENT_DIR" "$ROOT_DIR"
 
   echo "== verify tarball package recorded in settings"
   TEST_AGENT_DIR="$TEST_AGENT_DIR" PACKAGE_SPEC="$PACKAGE_SPEC" node <<'NODE'
@@ -258,15 +200,15 @@ NODE
   if [[ -x "./scripts/release-smoke.sh" ]]; then
     echo "== extension-specific smoke checks (scripts/release-smoke.sh)"
     PI_INSTALLED_PACKAGE_ROOT="$TEST_AGENT_DIR/npm/node_modules/$NAME"
-    NPM_CONFIG_PREFIX="$TEST_NPM_PREFIX" NPM_CONFIG_CACHE="$TEST_NPM_CACHE" \
-      PI_CODING_AGENT_DIR="$TEST_AGENT_DIR" PACKAGE_SPEC="$PACKAGE_SPEC" \
-      INSTALLED_PACKAGE_ROOT="$PI_INSTALLED_PACKAGE_ROOT" bash ./scripts/release-smoke.sh
+    release_sandbox_exec "$TEST_AGENT_DIR" "$TEST_NPM_PREFIX" "$TEST_NPM_CACHE" \
+      env PACKAGE_SPEC="$PACKAGE_SPEC" INSTALLED_PACKAGE_ROOT="$PI_INSTALLED_PACKAGE_ROOT" \
+      bash ./scripts/release-smoke.sh
   fi
 fi
 
 echo "== npm view ${NAME} version (pre-publish may be 404)"
 set +e
-npm --cache "$CONTROL_NPM_CACHE" view "$NAME" version --json --registry https://registry.npmjs.org/
+release_sandbox_npm view "$NAME" version --json --registry https://registry.npmjs.org/
 VIEW_EXIT=$?
 set -e
 echo "npm view exit: $VIEW_EXIT"

package/scripts/release-smoke.sh

@@ -6,6 +6,8 @@
 # ---
 set -euo pipefail
 
+: "${TMPDIR:?TMPDIR is required for managed release-smoke scratch}"
+
 ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 cd "$ROOT_DIR"
 
@@ -42,7 +44,7 @@ cleanup() {
 }
 trap cleanup EXIT
 
-SMOKE_DIR="$(mktemp -d /tmp/pi-agent-vent-release-smoke-XXXXXX)"
+SMOKE_DIR="$(mktemp -d "$TMPDIR/pi-agent-vent-release-smoke.XXXXXX")"
 SMOKE_LOCAL_PATH_VENT_DIR="$SMOKE_DIR/agent-vent-local-path-store"
 SMOKE_TOOL_VENT_DIR="$SMOKE_DIR/agent-vent-tool-store"
 SMOKE_LOCAL_PATH_OUTPUT="$SMOKE_DIR/agent-vent-local-path.out"
@@ -50,8 +52,10 @@ PACKAGE_NAME="$(node -p "JSON.parse(require('node:fs').readFileSync('package.jso
 PACKAGE_VERSION="$(node -p "JSON.parse(require('node:fs').readFileSync('package.json', 'utf8')).version")"
 INSTALLED_EXTENSION_PATH="$INSTALLED_PACKAGE_ROOT/extensions/agent-vent.ts"
 
-case "$(realpath -m "$INSTALLED_PACKAGE_ROOT")" in
-  "$(realpath "$PI_CODING_AGENT_DIR")"/*) ;;
+INSTALLED_PACKAGE_ROOT="$(node -e 'console.log(require("node:fs").realpathSync(process.argv[1]))' "$INSTALLED_PACKAGE_ROOT")"
+PI_CODING_AGENT_DIR_REAL="$(node -e 'console.log(require("node:fs").realpathSync(process.argv[1]))' "$PI_CODING_AGENT_DIR")"
+case "$INSTALLED_PACKAGE_ROOT" in
+  "$PI_CODING_AGENT_DIR_REAL"/*) ;;
   *)
     echo "Installed package root escaped isolated Pi agent directory: $INSTALLED_PACKAGE_ROOT" >&2
     exit 1

package/scripts/validate-structure.mjs

@@ -113,9 +113,10 @@ function validatePackageJson() {
     "quality:ci": "bash ./scripts/quality-gate.sh ci",
     check: "npm run quality:ci",
     test: "npm run quality:ci",
-    "docs:list": "bash ./scripts/docs-list.sh",
-    "docs:list:workspace": "bash ./scripts/docs-list.sh --workspace --discover",
-    "docs:list:json": "bash ./scripts/docs-list.sh --json",
+    "docs:list": "node ~/ai-society/core/agent-scripts/scripts/docs-list.mjs",
+    "docs:list:workspace":
+      "node ~/ai-society/core/agent-scripts/scripts/docs-list.mjs --workspace --discover",
+    "docs:list:json": "node ~/ai-society/core/agent-scripts/scripts/docs-list.mjs --json",
     "release:check": "bash ./scripts/release-check.sh",
     "release:check:quick": "SKIP_PI_SMOKE=1 bash ./scripts/release-check.sh",
   };

package/scripts/validate-structure.sh

@@ -32,7 +32,6 @@ required_files=(
   "policy/engineering-lane.json"
   "policy/security-policy.json"
   ".pi/prompts/commit.md"
-  "scripts/docs-list.sh"
   "scripts/release-artifact-check.mjs"
   "scripts/release-check.sh"
   "scripts/validate-structure.sh"
@@ -62,7 +61,6 @@ required_dirs=(
 )
 
 required_executables=(
-  "scripts/docs-list.sh"
   "scripts/release-check.sh"
   "scripts/validate-structure.sh"
   "scripts/validate-structure.mjs"