@xynogen/pix-welcome 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,31 @@
+# pix-welcome
+
+Pi extension — welcome banner with startup health checks.
+
+## What it does
+
+Renders a coloured ASCII π logo above the editor on session start and runs startup health checks in parallel while the banner is visible. Checks include: Pi version, auth status (at least one provider configured), and gitignore hygiene (auto-adds `.ai` and `.pi-lens` to `.gitignore` in git repos). Each check updates the banner live as results arrive, showing ✓/✗ and a brief status. The banner auto-dismisses on the first user turn. No configuration required.
+
+## Install
+
+```bash
+pi install npm:@xynogen/pix-welcome
+```
+
+> Also included in [`@xynogen/pix-core`](https://github.com/xynogen/pix-mono/tree/main/packages/pix-core):
+>
+> ```bash
+> pi install npm:@xynogen/pix-core
+> ```
+
+## Full distro
+
+To install the complete pix suite (all packages + Pi itself):
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/xynogen/pix-mono/main/scripts/install.sh | sh
+```
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@xynogen/pix-welcome",
-	"version": "0.1.0",
+	"version": "0.1.2",
 	"description": "Pi extension — welcome banner with startup health checks",
 	"type": "module",
 	"main": "src/index.ts",

package/src/extension.ts

@@ -1,6 +1,7 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { once } from "./once.ts";
 import registerWelcome from "./welcome.ts";
 
 export default function (pi: ExtensionAPI): void {
-	registerWelcome(pi);
+	once("pix-welcome", () => registerWelcome(pi));
 }

package/src/once.ts

@@ -0,0 +1,16 @@
+/**
+ * Idempotency guard for extension activation.
+ *
+ * pix-core (the meta-package) invokes this package's factory in addition to a
+ * possible direct install. Pi's loader uses jiti with `moduleCache: false`, so
+ * each load pass re-evaluates modules — a plain module-level flag would not be
+ * shared. The dedupe key therefore lives on `globalThis`, which persists for
+ * the lifetime of the process across all load passes.
+ */
+export function once(key: string, fn: () => void): void {
+	const g = globalThis as { __pixLoaded?: Set<string> };
+	const loaded = (g.__pixLoaded ??= new Set<string>());
+	if (loaded.has(key)) return;
+	loaded.add(key);
+	fn();
+}