@pi-unipi/core 0.1.14 → 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

@@ -36,6 +36,8 @@ export const MODULES = {
   MILESTONE: "@pi-unipi/milestone",
   KANBOARD: "@pi-unipi/kanboard",
   FOOTER: "@pi-unipi/footer",
+  UPDATER: "@pi-unipi/updater",
+  INPUT_SHORTCUTS: "@pi-unipi/input-shortcuts",
 } as const;
 
 /** Workflow command names */
@@ -295,10 +297,29 @@ export const MILESTONE_DIRS = {
   MILESTONES: ".unipi/docs/MILESTONES.md",
 } as const;
 
+/** Updater command names */
+export const UPDATER_COMMANDS = {
+  README: "readme",
+  CHANGELOG: "changelog",
+  UPDATER_SETTINGS: "updater-settings",
+} as const;
+
+/** Updater directory paths */
+export const UPDATER_DIRS = {
+  CONFIG: "~/.unipi/config/updater",
+  CACHE: "~/.unipi/cache/updater",
+} as const;
+
+/** Input-shortcuts command names */
+export const INPUT_SHORTCUTS_COMMANDS = {
+  STASH_SETTINGS: "stash-settings",
+} as const;
+
 /** Footer command names */
 export const FOOTER_COMMANDS = {
   FOOTER: "footer",
   FOOTER_SETTINGS: "footer-settings",
+  FOOTER_HELP: "footer-help",
 } as const;
 
 /** Compactor defaults */

package/events.ts

@@ -81,6 +81,15 @@ export const UNIPI_EVENTS = {
 
   /** Agent asked user a question (ask_user tool invoked) */
   ASK_USER_PROMPT: "unipi:ask-user:prompt",
+
+  /** Update check performed */
+  UPDATE_CHECK: "unipi:update:check",
+  /** Update available */
+  UPDATE_AVAILABLE: "unipi:update:available",
+  /** Update applied */
+  UPDATE_APPLIED: "unipi:update:applied",
+  /** Update error */
+  UPDATE_ERROR: "unipi:update:error",
 } as const;
 
 /** Payload for MODULE_READY / MODULE_GONE */
@@ -323,6 +332,42 @@ export interface UnipiAskUserPromptEvent {
   allowFreeform?: boolean;
 }
 
+/** Payload for UPDATE_CHECK */
+export interface UnipiUpdateCheckEvent {
+  /** Current installed version */
+  currentVersion: string;
+  /** Latest version found on npm */
+  latestVersion: string;
+  /** Whether an update is available */
+  updateAvailable: boolean;
+  /** Error if check failed */
+  error?: string;
+}
+
+/** Payload for UPDATE_AVAILABLE */
+export interface UnipiUpdateAvailableEvent {
+  /** Current installed version */
+  currentVersion: string;
+  /** Latest version available */
+  latestVersion: string;
+}
+
+/** Payload for UPDATE_APPLIED */
+export interface UnipiUpdateAppliedEvent {
+  /** Previous version */
+  previousVersion: string;
+  /** New version after update */
+  newVersion: string;
+}
+
+/** Payload for UPDATE_ERROR */
+export interface UnipiUpdateErrorEvent {
+  /** Error message */
+  error: string;
+  /** Whether the error was from check or install */
+  phase: "check" | "install";
+}
+
 /** Payload for NOTIFICATION_SENT */
 export interface UnipiNotificationSentEvent {
   /** Event type that triggered notification */
@@ -359,4 +404,8 @@ export type UnipiEventPayload =
   | UnipiUtilityLifecycleEvent
   | UnipiNotificationSentEvent
   | UnipiBadgeGenerateRequestEvent
-  | UnipiAskUserPromptEvent;
+  | UnipiAskUserPromptEvent
+  | UnipiUpdateCheckEvent
+  | UnipiUpdateAvailableEvent
+  | UnipiUpdateAppliedEvent
+  | UnipiUpdateErrorEvent;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/core",
-  "version": "0.1.14",
+  "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.
  */