@heyanon-arp/cli 0.0.5 → 0.0.7

package/scripts/postinstall.mjs

@@ -0,0 +1,54 @@
+/**
+ * Post-install onboarding banner for the `heyarp` CLI.
+ *
+ * The whole message is "the guides ship inside the CLI — read them first":
+ * `heyarp guide` is the canonical onboarding surface (a human walkthrough plus
+ * an LLM-system-prompt block for agent operators), so a fresh install points
+ * straight at it instead of an external docs site.
+ *
+ * Onboarding must NEVER get in the way, so this is deliberately defensive:
+ *   - only for an interactive GLOBAL install (`npm i -g @heyanon-arp/cli`)
+ *   - silent in CI, in non-TTY / piped contexts, and with HEYARP_NO_BANNER set
+ *   - honours NO_COLOR
+ *   - fully wrapped so a banner failure can never fail the install
+ */
+try {
+	const isGlobalInstall = process.env.npm_config_global === 'true' || process.env.npm_config_global === '1';
+	const inCI = Boolean(process.env.CI);
+	const interactive = Boolean(process.stdout && process.stdout.isTTY);
+	const muted = Boolean(process.env.HEYARP_NO_BANNER);
+
+	if (!isGlobalInstall || inCI || !interactive || muted) {
+		process.exit(0);
+	}
+
+	const useColor = !process.env.NO_COLOR;
+	const paint = (code, text) => (useColor ? `\x1b[${code}m${text}\x1b[0m` : text);
+	const bold = (t) => paint('1', t);
+	const cyan = (t) => paint('36', t);
+	const dim = (t) => paint('2', t);
+
+	const lines = [
+		'',
+		bold('  🤝 heyarp installed — the Agent Relationship Protocol CLI'),
+		'',
+		'  New here? The guides ship inside the CLI — read them first, no docs site needed:',
+		'',
+		`    ${cyan('heyarp guide')}                 ${dim('role-based walkthrough (worker / buyer)')}`,
+		`    ${cyan('heyarp guide --setup')}         ${dim('one-time setup: keys, server, multi-agent isolation')}`,
+		`    ${cyan('heyarp guide --troubleshoot')}  ${dim('common errors → fixes')}`,
+		'',
+		`  ${bold('Driving heyarp from an AI agent?')} Pipe the guide into its system prompt:`,
+		'',
+		`    ${cyan('heyarp guide --role worker --format prompt')}`,
+		'',
+		`  ${dim('Then:')} ${cyan('heyarp register')} ${dim('→ handshake → delegation → work → receipt → settlement.')}`,
+		`  ${dim('Quiet this banner any time with HEYARP_NO_BANNER=1.')}`,
+		'',
+	];
+	process.stdout.write(`${lines.join('\n')}\n`);
+} catch {
+	// Onboarding is best-effort. Never break an install over a banner.
+}
+
+process.exit(0);