@pi-unipi/core 0.1.8 → 0.1.11

package/constants.ts

@@ -33,6 +33,8 @@ export const MODULES = {
   COMPACTOR: "@pi-unipi/compactor",
   NOTIFY: "@pi-unipi/notify",
   BTW: "@pi-unipi/btw",
+  MILESTONE: "@pi-unipi/milestone",
+  KANBOARD: "@pi-unipi/kanboard",
 } as const;
 
 /** Workflow command names */
@@ -156,6 +158,10 @@ export const UTILITY_COMMANDS = {
   CLEANUP: "cleanup",
   ENV: "env",
   DOCTOR: "doctor",
+  BADGE_NAME: "badge-name",
+  BADGE_GEN: "badge-gen",
+  BADGE_TOGGLE: "badge-toggle",
+  BADGE_SETTINGS: "badge-settings",
 } as const;
 
 /** Utility tool names */
@@ -163,8 +169,12 @@ export const UTILITY_TOOLS = {
   CONTINUE: "continue_task",
   BATCH: "ctx_batch",
   ENV: "ctx_env",
+  SET_SESSION_NAME: "set_session_name",
 } as const;
 
+/** Badge config path */
+export const BADGE_CONFIG_FILE = ".unipi/config/badge.json" as const;
+
 /** Utility directory paths */
 export const UTILITY_DIRS = {
   CACHE: "~/.unipi/cache",
@@ -234,6 +244,24 @@ export const COMPACTOR_DIRS = {
   DB: "~/.unipi/db/compactor",
 } as const;
 
+/** Kanboard command names */
+export const KANBOARD_COMMANDS = {
+  KANBOARD: "kanboard",
+  KANBOARD_DOCTOR: "kanboard-doctor",
+} as const;
+
+/** Kanboard directory paths */
+export const KANBOARD_DIRS = {
+  UI_STATIC: "ui/static",
+  PID_FILE: ".unipi/kanboard.pid",
+} as const;
+
+/** Kanboard defaults */
+export const KANBOARD_DEFAULTS = {
+  PORT: 8165,
+  MAX_PORT: 8175,
+} as const;
+
 /** Notify command names */
 export const NOTIFY_COMMANDS = {
   SETTINGS: "notify-settings",
@@ -252,6 +280,17 @@ export const NOTIFY_DIRS = {
   CONFIG: "~/.unipi/config/notify",
 } as const;
 
+/** Milestone command names */
+export const MILESTONE_COMMANDS = {
+  ONBOARD: "milestone-onboard",
+  UPDATE: "milestone-update",
+} as const;
+
+/** Milestone directory paths */
+export const MILESTONE_DIRS = {
+  MILESTONES: ".unipi/docs/MILESTONES.md",
+} as const;
+
 /** Compactor defaults */
 export const COMPACTOR_DEFAULTS = {
   MAX_EVENTS_PER_SESSION: 1000,

package/events.ts

@@ -75,6 +75,9 @@ export const UNIPI_EVENTS = {
 
   /** Notification sent */
   NOTIFICATION_SENT: "unipi:notify:sent",
+
+  /** Badge generation requested (from kanboard or other module) */
+  BADGE_GENERATE_REQUEST: "unipi:badge:generate:request",
 } as const;
 
 /** Payload for MODULE_READY / MODULE_GONE */
@@ -295,6 +298,14 @@ export interface UnipiUtilityLifecycleEvent {
   reason?: string;
 }
 
+/** Payload for BADGE_GENERATE_REQUEST */
+export interface UnipiBadgeGenerateRequestEvent {
+  /** Source of the request (e.g., "kanboard", "input-hook") */
+  source: string;
+  /** First user message for context (optional) */
+  conversationSummary?: string;
+}
+
 /** Payload for NOTIFICATION_SENT */
 export interface UnipiNotificationSentEvent {
   /** Event type that triggered notification */
@@ -329,4 +340,5 @@ export type UnipiEventPayload =
   | UnipiUtilityCleanupEvent
   | UnipiUtilityDiagnosticsEvent
   | UnipiUtilityLifecycleEvent
-  | UnipiNotificationSentEvent;
+  | UnipiNotificationSentEvent
+  | UnipiBadgeGenerateRequestEvent;

package/index.ts

@@ -8,3 +8,4 @@ export * from "./constants.js";
 export * from "./events.js";
 export * from "./sandbox.js";
 export * from "./utils.js";
+export * from "./model-cache.js";

package/model-cache.ts

@@ -0,0 +1,70 @@
+/**
+ * @pi-unipi/core — Model Cache
+ *
+ * File-based model list cache at ~/.unipi/config/models-cache.json.
+ * Allows TUI components and other packages to list available models
+ * without needing ctx.modelRegistry at runtime.
+ */
+
+import * as fs from "node:fs";
+import * as path from "node:path";
+
+/** Path to the model cache directory */
+const CACHE_DIR = path.join(
+  process.env.HOME ?? process.env.USERPROFILE ?? "~",
+  ".unipi/config",
+);
+
+/** Path to the model cache file */
+const CACHE_FILE = path.join(CACHE_DIR, "models-cache.json");
+
+/** A single cached model entry */
+export interface CachedModel {
+  /** Model provider (e.g. "openai", "anthropic") */
+  provider: string;
+  /** Model ID (e.g. "gpt-4o", "claude-sonnet-4-6") */
+  id: string;
+  /** Optional display name */
+  name?: string;
+}
+
+/** The full model cache structure */
+export interface ModelCache {
+  /** ISO timestamp of last cache write */
+  updatedAt: string;
+  /** List of cached models */
+  models: CachedModel[];
+}
+
+/**
+ * Read cached model list from disk.
+ * Returns empty array if no cache file exists or it's malformed.
+ */
+export function readModelCache(): CachedModel[] {
+  try {
+    if (!fs.existsSync(CACHE_FILE)) return [];
+    const parsed = JSON.parse(fs.readFileSync(CACHE_FILE, "utf-8"));
+    return Array.isArray(parsed.models) ? parsed.models : [];
+  } catch {
+    return [];
+  }
+}
+
+/**
+ * Write model list to cache file.
+ * Creates directory if needed. Best effort — silently ignores errors.
+ */
+export function writeModelCache(models: CachedModel[]): void {
+  try {
+    if (!fs.existsSync(CACHE_DIR)) {
+      fs.mkdirSync(CACHE_DIR, { recursive: true });
+    }
+    const cache: ModelCache = {
+      updatedAt: new Date().toISOString(),
+      models,
+    };
+    fs.writeFileSync(CACHE_FILE, JSON.stringify(cache, null, 2) + "\n", "utf-8");
+  } catch {
+    // Best effort — cache is optional
+  }
+}

package/package.json

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