@nexus-cortex/cli 4.70.0 → 4.72.0

package/.cortex/orient

@@ -0,0 +1,69 @@
+#!/bin/sh
+# Generic mechanical orient — the shipped scaffold's boot-minimal turn-1 target
+# (HARNESS_IMPROVEMENT_BACKLOG item 9b). Vendored by prepack to
+# <pkg>/.cortex/orient; the boot-minimal clause points here when the project
+# has no .cortex/orient of its own. Deterministic, read-only except for one
+# mechanical .cortex/CORTEX.md render (never overwrites), always exits 0.
+W="$(pwd)"
+echo "== WORKSPACE MAP: $W =="
+ls -1A "$W" 2>/dev/null | head -40
+PROJECT=""
+CMDS=""
+if [ -f package.json ]; then
+  if command -v node >/dev/null 2>&1; then
+    PROJECT=$(node -e 'try{console.log(require("./package.json").name||"")}catch(e){}' 2>/dev/null)
+    SCRIPTS=$(node -e 'try{Object.keys(require("./package.json").scripts||{}).forEach(k=>console.log(k))}catch(e){}' 2>/dev/null | head -12)
+  else
+    PROJECT=$(sed -n 's/.*"name"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' package.json | head -1)
+    SCRIPTS=$(tr ',' '\n' < package.json | sed -n 's/.*"\([A-Za-z0-9:_-]*\)"[[:space:]]*:[[:space:]]*".*/\1/p' | head -12)
+  fi
+  if [ -n "$SCRIPTS" ]; then
+    echo "-- package.json scripts --"
+    printf '%s\n' "$SCRIPTS" | sed 's/^/  npm run /'
+    CMDS=$(printf '%s\n' "$SCRIPTS" | head -8 | sed 's/^/- `npm run /;s/$/`/')
+  fi
+fi
+[ -f requirements.txt ] && echo "-- python deps: requirements.txt ($(wc -l < requirements.txt | tr -d ' ') lines)"
+[ -f pyproject.toml ] && echo "-- python: pyproject.toml present"
+[ -f Cargo.toml ] && echo "-- rust: Cargo.toml present (cargo build / cargo test)"
+if [ -f Makefile ]; then
+  echo "-- make targets --"
+  sed -n 's/^\([A-Za-z0-9_.-][A-Za-z0-9_.-]*\):.*/  make \1/p' Makefile | head -8
+fi
+if [ -f README.md ]; then
+  echo "-- README head --"
+  head -12 README.md
+fi
+# Capability index — harness-owned steering (item 9b): the skills shipped with
+# the install, reachable through plain bash reads (works under any tool frame).
+SK="${CORTEX_ROOT:-$HOME}/.cortex/skills"
+if [ -d "$SK" ]; then
+  echo "== CAPABILITY GUIDES (load one with: cat <path>/SKILL.md) =="
+  for d in "$SK"/*/; do
+    [ -d "$d" ] || continue
+    n=$(basename "$d")
+    desc=$(sed -n 's/^description:[[:space:]]*//p' "$d/SKILL.md" 2>/dev/null | head -1 | cut -c1-90)
+    case "$desc" in ">"|"|"|"") desc="guide";; esac
+    echo "  $SK/$n — $desc"
+  done | head -14
+fi
+echo "note: when your tool list is limited, additional tools may be discoverable via the SearchTools tool."
+# Mechanical CORTEX.md (item 9c feed): written synchronously so the deferred
+# doctrine corpus delivered at anchor-lift carries project context. Refine
+# later with the init_cortex_context tool; never overwritten here.
+if [ ! -f .cortex/CORTEX.md ]; then
+  mkdir -p .cortex 2>/dev/null
+  {
+    echo "# CORTEX.md (mechanical orient scan — refine with init_cortex_context)"
+    echo
+    echo "## Project"
+    echo "${PROJECT:-$(basename "$W")} — see README for details."
+    echo
+    echo "## Key Commands"
+    if [ -n "$CMDS" ]; then printf '%s\n' "$CMDS"; else echo "- (no package.json scripts; check README/Makefile)"; fi
+    echo
+    echo "## Structure (top level)"
+    ls -1A "$W" 2>/dev/null | head -25 | sed 's/^/- /'
+  } > .cortex/CORTEX.md 2>/dev/null && echo "(wrote mechanical .cortex/CORTEX.md)"
+fi
+exit 0

package/.env.example

@@ -447,6 +447,9 @@ MENTORSHIP_ACTIVE_DISCOVERY=false
 # Prompt-mass composition (BASH_PLUS_SPEC P6): full (default) | minimal (only
 # the core system prompt; guides/CLAUDE.md/memory dropped) | defer (minimal on
 # turn 1, full corpus appended once at the first tool-result boundary).
+# defer COMPOSES with a card's promptPreset (item 9a): a boot-minimal card
+# keeps its narrow replacement prompt on turn 1 and receives the full corpus
+# (incl. project CORTEX.md/AGENTS.md, read lazily at lift) after first action.
 # Effective on providers only where delivery is ON (see flag above).
 #CORTEX_PROMPT_MASS=minimal
 
@@ -460,6 +463,16 @@ MENTORSHIP_ACTIVE_DISCOVERY=false
 # Env override for the model card's anchorProfile (deepseek cards default to
 # bash-edit). Values: lean | bash-only | bash-plus | bash-edit | none.
 #CORTEX_TOOL_ANCHOR=bash-edit
+# ── Vision / image-path bridge (item 7) ──
+# Turns an image stays in the request context before being stubbed out.
+# MEASURED: an image ANYWHERE in a vision-exp request disables cache reads for
+# the whole request — evicting after use restores the ~31x cache discount.
+# 'off' keeps images forever.
+#CORTEX_IMAGE_TTL_TURNS=3
+# ReadImage downscales originals above this size to ~800px (provider parity,
+# lossless to the model, ~100x wire cut). 'off' disables.
+#CORTEX_IMAGE_DOWNSCALE_BYTES=2097152
+
 # Anchor FRAME (4.70.0): true/persist = the anchored tool surface never lifts
 # (stays the only surface all session); false/lifted forces the lift. Unset =
 # the model card's frameProfile, default lifted. Experiment lever.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexus-cortex/cli",
-  "version": "4.70.0",
+  "version": "4.72.0",
   "description": "Nexus Cortex CLI - Terminal interface for multi-provider LLM orchestration",
   "main": "dist/index.js",
   "type": "module",
@@ -19,7 +19,7 @@
     "prepack": "node ../../scripts/copy-pkg-cortex-scaffold.mjs"
   },
   "dependencies": {
-    "@nexus-cortex/core": "4.70.0",
+    "@nexus-cortex/core": "4.72.0",
     "chalk": "^4.1.2",
     "cli-spinners": "^2.9.0",
     "commander": "^11.0.0",
@@ -31,7 +31,7 @@
     "marked-terminal": "^6.0.0",
     "node-fetch": "^3.3.2",
     "undici": "^7.28.0",
-    "nexus-canon": "1.9.5"
+    "nexus-canon": "1.10.0"
   },
   "devDependencies": {
     "@types/diff": "^7.0.2",