arqzero 2.1.0-beta.12 → 2.1.0-beta.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arqzero",
-  "version": "2.1.0-beta.12",
+  "version": "2.1.0-beta.17",
   "description": "ArqZero — terminal-native AI engineering agent. Bring your own LLM key.",
   "type": "module",
   "bin": {
@@ -11,9 +11,10 @@
     "codex": "node scripts/obfuscate-codex.mjs",
     "build": "npm run codex && tsup",
     "typecheck": "tsc --noEmit",
-    "test": "node --test --experimental-strip-types src/**/*.test.ts",
+    "test": "tsx --test src/**/*.test.ts",
     "lint": "tsc --noEmit",
-    "prepublishOnly": "npm run build && npm test"
+    "prepublishOnly": "npm run build && npm test",
+    "postinstall": "node scripts/postinstall.mjs"
   },
   "keywords": [
     "ai",
@@ -38,6 +39,7 @@
   ],
   "files": [
     "dist/arqzero.mjs",
+    "scripts/postinstall.mjs",
     "LICENSE",
     "README.md",
     "CHANGELOG.md"

package/scripts/postinstall.mjs

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+// Runs after `npm i -g arqzero` (or local install). Prints a one-screen
+// brand welcome with the next command users should type.
+//
+// Three rules for postinstall scripts that don't get angry comments on GitHub:
+//   1. Never block — exit fast even on errors
+//   2. Never print on CI (npm sets npm_config_loglevel=error / CI=true)
+//   3. Honor NO_COLOR
+//
+// If any of those are present we silently exit. Otherwise, ~12 lines of
+// welcome with the install path the user actually needs.
+
+const isCi = !!(
+  process.env.CI ||
+  process.env.NPM_CONFIG_LOGLEVEL === 'error' ||
+  process.env.npm_config_loglevel === 'error'
+);
+if (isCi) process.exit(0);
+
+const NO_COLOR = !!process.env.NO_COLOR;
+const wrap = (code, s) => (NO_COLOR ? s : `${code}${s}\x1b[0m`);
+const teal     = (s) => wrap('\x1b[38;2;0;212;170m', s);
+const tealBold = (s) => wrap('\x1b[1;38;2;0;212;170m', s);
+const muted    = (s) => wrap('\x1b[90m', s);
+const bold     = (s) => wrap('\x1b[1m', s);
+
+// Skip when installed as a dependency (not a global / direct user install).
+// npm sets npm_config_global=true for `-g` installs; absence usually means
+// we're being pulled in as a transitive dep. Don't spam those users.
+const isGlobal = process.env.npm_config_global === 'true' || process.env.FORCE_POSTINSTALL === 'true';
+if (!isGlobal) process.exit(0);
+
+console.log('');
+console.log(`  ${tealBold('◆ ArqZero')}  ${muted('— terminal-native AI engineering agent')}`);
+console.log(`  ${muted('──────────────────────────────────────────────────────────────────────')}`);
+console.log('');
+console.log(`  ${bold('Welcome to ArqZero! Let\'s get you set up for your coding session:')}`);
+console.log('');
+console.log(`  ${tealBold('1. CHOOSE YOUR INFERENCE TIER')}`);
+console.log('');
+console.log(`     ${bold('Option A: Managed Inference (Zero setup — recommended)')}`);
+console.log(`     Sign in securely via browser and start coding immediately:`);
+console.log(`       $ ${teal('arqzero login')}`);
+console.log(`       $ ${teal('arqzero')}`);
+console.log('');
+console.log(`     ${bold('Option B: Bring Your Own Keys (BYOK)')}`);
+console.log(`     Support for Anthropic, OpenAI, Fireworks, OpenRouter, Ollama, and more:`);
+console.log(`       $ ${teal('arqzero')}  ${muted('# pick a provider and enter your API key on launch')}`);
+console.log('');
+console.log(`  ${tealBold('2. STRUCTURE YOUR PROJECT FOR AGENTS')}`);
+console.log(`     Inside any project directory, initialize an agent instruction file:`);
+console.log(`       $ ${teal('arqzero setup')}  ${muted('# creates a markdown template (ARQZERO.md) for custom rules')}`);
+console.log('');
+console.log(`  ${tealBold('3. TOUR THE INTERACTIVE TUI COMMANDS')}`);
+console.log(`     In an active session, type ${bold('/')} to use slash commands:`);
+console.log(`       ${teal('●')} ${bold('/help')}      ${muted('— Show all available commands')}`);
+console.log(`       ${teal('●')} ${bold('/model')}     ${muted('— Switch LLMs on the fly')}`);
+console.log(`       ${teal('●')} ${bold('/provider')}  ${muted('— Manage providers or API keys')}`);
+console.log(`       ${teal('●')} ${bold('/session')}   ${muted('— List, resume, or delete past sessions')}`);
+console.log(`       ${teal('●')} ${bold('/rename')}    ${muted('— Give the current session a memorable name')}`);
+console.log(`       ${teal('●')} ${bold('/export')}    ${muted('— Save the entire session to a markdown file')}`);
+console.log(`       ${teal('●')} ${bold('/check')}     ${muted('— Perform environment diagnostics and health checks')}`);
+console.log('');
+console.log(`  ${muted('──────────────────────────────────────────────────────────────────────')}`);
+console.log(`  ${muted('Docs:')}     ${teal('https://arqzero.dev/docs')}`);
+console.log(`  ${muted('GitHub:')}   ${teal('https://github.com/LuciferDono/ArqZero')}`);
+console.log('');