@pi-unipi/core 0.1.15 → 0.1.16

package/README.md

@@ -1,17 +1,8 @@
 # @pi-unipi/core
 
-Shared utilities, event types, and constants for the [Unipi](https://github.com/Neuron-Mr-White/unipi) extension suite.
+Shared infrastructure for every Unipi package. Provides constants, event types, and utility functions so packages can discover each other without tight coupling.
 
-## Install
-
-```bash
-pi install npm:@pi-unipi/core
-```
-
-Or as part of the full suite:
-```bash
-pi install npm:unipi
-```
+Other packages import from `@pi-unipi/core` to emit events, read module names, and use common file operations. Without it, each package would need its own event definitions and utilities.
 
 ## Usage
 
@@ -33,6 +24,7 @@ const safeName = sanitize("my/feature: branch");
 ## Exports
 
 ### Constants
+
 - `UNIPI_PREFIX` — Command prefix (`unipi:`)
 - `MODULES` — All module names
 - `WORKFLOW_COMMANDS` — Workflow command names
@@ -43,6 +35,7 @@ const safeName = sanitize("my/feature: branch");
 - `RALPH_COMPLETE_MARKER` — Loop completion marker
 
 ### Events
+
 - `UNIPI_EVENTS` — Event names
 - `UnipiModuleEvent` — Module ready/gone payload
 - `UnipiWorkflowEvent` — Workflow start/end payload
@@ -51,6 +44,7 @@ const safeName = sanitize("my/feature: branch");
 - `UnipiStatusRequestEvent` / `UnipiStatusResponseEvent` — Status payloads
 
 ### Utilities
+
 - `sanitize(name)` — Sanitize string for filenames
 - `ensureDir(path)` — Create parent directories
 - `tryDelete(path)` — Safe file deletion
@@ -69,6 +63,21 @@ const safeName = sanitize("my/feature: branch");
 - `isModuleAvailable(cwd, name)` — Check if npm module exists
 - `emitEvent(pi, name, payload)` — Safe event emission
 
+## How Packages Use Core
+
+Every Unipi package depends on `@pi-unipi/core`. On load, each package:
+
+1. Imports `MODULES` to register its own name
+2. Imports `UNIPI_EVENTS` to subscribe to lifecycle events
+3. Calls `emitEvent(pi, UNIPI_EVENTS.MODULE_READY, ...)` to announce itself
+4. Uses utility functions for file I/O and path resolution
+
+This creates a loose coupling — packages discover each other through events, not direct imports.
+
+## Configuration
+
+Core has no configuration. It's a pure utility layer.
+
 ## License
 
 MIT

package/constants.ts

@@ -319,6 +319,7 @@ export const INPUT_SHORTCUTS_COMMANDS = {
 export const FOOTER_COMMANDS = {
   FOOTER: "footer",
   FOOTER_SETTINGS: "footer-settings",
+  FOOTER_HELP: "footer-help",
 } as const;
 
 /** Compactor defaults */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/core",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "description": "Shared utilities, event types, and constants for Unipi extension suite",
   "type": "module",
   "license": "MIT",

package/utils.ts

@@ -141,6 +141,36 @@ export function getPackageVersion(packageDir: string): string {
   return pkg?.version ?? "0.0.0";
 }
 
+/**
+ * Walk up from `startDir` to find a package.json with the given `name`.
+ * Returns the directory containing that package.json, or null if not found.
+ * Stops after `maxSteps` levels (default 10).
+ */
+export function findPackageRoot(startDir: string, packageName: string, maxSteps = 10): string | null {
+  let dir = path.resolve(startDir);
+  for (let i = 0; i < maxSteps; i++) {
+    const pkgPath = path.join(dir, "package.json");
+    const pkg = readJson<{ name?: string }>(pkgPath);
+    if (pkg?.name === packageName) {
+      return dir;
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir) break; // filesystem root
+    dir = parent;
+  }
+  return null;
+}
+
+/**
+ * Get the installed version of a named package by walking up from startDir.
+ * Returns "0.0.0" if the package cannot be found.
+ */
+export function getInstalledPackageVersion(startDir: string, packageName: string): string {
+  const root = findPackageRoot(startDir, packageName);
+  if (!root) return "0.0.0";
+  return getPackageVersion(root);
+}
+
 /**
  * Check if a module is available in node_modules.
  */