@pi-unipi/core 0.1.7 → 0.1.8

package/constants.ts

@@ -30,6 +30,9 @@ export const MODULES = {
   SETTINGS: "@pi-unipi/settings",
   UTILITY: "@pi-unipi/utility",
   ASK_USER: "@pi-unipi/ask-user",
+  COMPACTOR: "@pi-unipi/compactor",
+  NOTIFY: "@pi-unipi/notify",
+  BTW: "@pi-unipi/btw",
 } as const;
 
 /** Workflow command names */
@@ -48,6 +51,12 @@ export const WORKFLOW_COMMANDS = {
   DOCUMENT: "document",
   SCAN_ISSUES: "scan-issues",
   AUTO: "auto",
+  DEBUG: "debug",
+  FIX: "fix",
+  QUICK_FIX: "quick-fix",
+  RESEARCH: "research",
+  CHORE_CREATE: "chore-create",
+  CHORE_EXECUTE: "chore-execute",
 } as const;
 
 /** Ralph command names */
@@ -77,8 +86,11 @@ export const UNIPI_DIRS = {
   PLANS: ".unipi/docs/plans",
   GENERATED: ".unipi/docs/generated",
   REVIEWS: ".unipi/docs/reviews",
+  DEBUG: ".unipi/docs/debug",
+  FIX: ".unipi/docs/fix",
+  QUICK_WORK: ".unipi/docs/quick-work",
+  CHORE: ".unipi/docs/chore",
   MEMORY: ".unipi/memory",
-  QUICK_WORK: ".unipi/quick-work",
 } as const;
 
 /** Memory tool names */
@@ -139,11 +151,25 @@ export const RALPH_STATUS_ICONS = {
 /** Utility command names */
 export const UTILITY_COMMANDS = {
   CONTINUE: "continue",
+  RELOAD: "reload",
+  STATUS: "status",
+  CLEANUP: "cleanup",
+  ENV: "env",
+  DOCTOR: "doctor",
 } as const;
 
 /** Utility tool names */
 export const UTILITY_TOOLS = {
   CONTINUE: "continue_task",
+  BATCH: "ctx_batch",
+  ENV: "ctx_env",
+} as const;
+
+/** Utility directory paths */
+export const UTILITY_DIRS = {
+  CACHE: "~/.unipi/cache",
+  ANALYTICS: "~/.unipi/analytics",
+  TEMP: "/tmp/unipi",
 } as const;
 
 /** Ask-user tool names */
@@ -174,3 +200,69 @@ export const MCP_DEFAULTS = {
   MAX_SERVERS: 20,
   TOOL_NAME_SEPARATOR: "__",
 } as const;
+
+/** Compactor tool names */
+export const COMPACTOR_TOOLS = {
+  COMPACT: "compact",
+  VCC_RECALL: "vcc_recall",
+  CTX_EXECUTE: "ctx_execute",
+  CTX_EXECUTE_FILE: "ctx_execute_file",
+  CTX_BATCH_EXECUTE: "ctx_batch_execute",
+  CTX_INDEX: "ctx_index",
+  CTX_SEARCH: "ctx_search",
+  CTX_FETCH_AND_INDEX: "ctx_fetch_and_index",
+  CTX_STATS: "ctx_stats",
+  CTX_DOCTOR: "ctx_doctor",
+} as const;
+
+/** Compactor command names */
+export const COMPACTOR_COMMANDS = {
+  COMPACT: "compact",
+  COMPACT_RECALL: "compact-recall",
+  COMPACT_STATS: "compact-stats",
+  COMPACT_DOCTOR: "compact-doctor",
+  COMPACT_SETTINGS: "compact-settings",
+  COMPACT_PRESET: "compact-preset",
+  COMPACT_INDEX: "compact-index",
+  COMPACT_SEARCH: "compact-search",
+  COMPACT_PURGE: "compact-purge",
+} as const;
+
+/** Compactor directory paths */
+export const COMPACTOR_DIRS = {
+  CONFIG: "~/.unipi/config/compactor",
+  DB: "~/.unipi/db/compactor",
+} as const;
+
+/** Notify command names */
+export const NOTIFY_COMMANDS = {
+  SETTINGS: "notify-settings",
+  SET_GOTIFY: "notify-set-gotify",
+  SET_TG: "notify-set-tg",
+  TEST: "notify-test",
+} as const;
+
+/** Notify tool names */
+export const NOTIFY_TOOLS = {
+  NOTIFY_USER: "notify_user",
+} as const;
+
+/** Notify directory paths */
+export const NOTIFY_DIRS = {
+  CONFIG: "~/.unipi/config/notify",
+} as const;
+
+/** Compactor defaults */
+export const COMPACTOR_DEFAULTS = {
+  MAX_EVENTS_PER_SESSION: 1000,
+  DEDUP_WINDOW: 5,
+  MAX_RESUME_BYTES: 2048,
+  BRIEF_MAX_LINES: 120,
+  COMPACT_BRIEF_LINES: 60,
+  MINIMAL_BRIEF_LINES: 20,
+  OUTPUT_CAP_MB: 100,
+  DEFAULT_TIMEOUT_MS: 30000,
+  SESSION_TTL_DAYS: 7,
+  CACHE_TTL_HOURS: 24,
+  FTS5_CHUNK_SIZE: 4096,
+} as const;

package/events.ts

@@ -55,6 +55,26 @@ export const UNIPI_EVENTS = {
   MCP_TOOLS_UNREGISTERED: "unipi:mcp:tools:unregistered",
   /** MCP catalog synced */
   MCP_CATALOG_SYNCED: "unipi:mcp:catalog:synced",
+
+  /** Compactor: compaction completed */
+  COMPACTOR_COMPACTED: "unipi:compactor:compacted",
+  /** Compactor: stats updated */
+  COMPACTOR_STATS_UPDATED: "unipi:compactor:stats:updated",
+  /** Utility module cleanup started */
+  UTILITY_CLEANUP_START: "unipi:utility:cleanup:start",
+  /** Utility module cleanup completed */
+  UTILITY_CLEANUP_DONE: "unipi:utility:cleanup:done",
+  /** Utility diagnostics started */
+  UTILITY_DIAGNOSTICS_START: "unipi:utility:diagnostics:start",
+  /** Utility diagnostics completed */
+  UTILITY_DIAGNOSTICS_DONE: "unipi:utility:diagnostics:done",
+  /** Utility cache invalidated */
+  UTILITY_CACHE_INVALIDATED: "unipi:utility:cache:invalidated",
+  /** Utility lifecycle state changed */
+  UTILITY_LIFECYCLE_STATE: "unipi:utility:lifecycle:state",
+
+  /** Notification sent */
+  NOTIFICATION_SENT: "unipi:notify:sent",
 } as const;
 
 /** Payload for MODULE_READY / MODULE_GONE */
@@ -211,6 +231,82 @@ export interface UnipiMcpCatalogSyncedEvent {
   source: string;
 }
 
+/** Payload for COMPACTOR compaction completed */
+export interface UnipiCompactionEvent {
+  /** Session ID */
+  sessionId: string;
+  /** Messages summarized */
+  summarized: number;
+  /** Messages kept */
+  kept: number;
+  /** Estimated tokens saved */
+  tokensSaved: number;
+  /** Compression ratio string, e.g. "56:1" */
+  compressionRatio: string;
+}
+
+/** Payload for COMPACTOR stats update */
+export interface UnipiCompactorStatsEvent {
+  /** Session events count */
+  sessionEvents: number;
+  /** Compactions count */
+  compactions: number;
+  /** Tokens saved total */
+  tokensSaved: number;
+  /** Indexed documents count */
+  indexedDocs: number;
+  /** Sandbox executions count */
+  sandboxRuns: number;
+  /** Search queries count */
+  searchQueries: number;
+}
+
+/** Payload for UTILITY_CLEANUP_START / UTILITY_CLEANUP_DONE */
+export interface UnipiUtilityCleanupEvent {
+  /** Whether this is a dry run */
+  dryRun: boolean;
+  /** Categories being cleaned */
+  categories: string[];
+  /** Results (present on DONE) */
+  results?: Array<{
+    category: string;
+    removed: number;
+    bytesFreed: number;
+  }>;
+}
+
+/** Payload for UTILITY_DIAGNOSTICS_START / UTILITY_DIAGNOSTICS_DONE */
+export interface UnipiUtilityDiagnosticsEvent {
+  /** Overall health status */
+  overall: "healthy" | "warning" | "error" | "unknown";
+  /** Number of checks run */
+  checkCount: number;
+  /** Report (present on DONE) */
+  report?: unknown;
+}
+
+/** Payload for UTILITY_LIFECYCLE_STATE */
+export interface UnipiUtilityLifecycleEvent {
+  /** New lifecycle state */
+  state: "running" | "shutting_down" | "orphaned" | "error";
+  /** Previous state */
+  previousState?: string;
+  /** Reason for state change */
+  reason?: string;
+}
+
+/** Payload for NOTIFICATION_SENT */
+export interface UnipiNotificationSentEvent {
+  /** Event type that triggered notification */
+  eventType: string;
+  /** Platforms sent to */
+  platforms: string[];
+  /** Whether all platforms succeeded */
+  success: boolean;
+  /** ISO timestamp */
+  timestamp: string;
+}
+
 /** Union of all unipi event payloads */
 export type UnipiEventPayload =
   | UnipiModuleEvent
@@ -227,4 +323,10 @@ export type UnipiEventPayload =
   | UnipiInfoDataEvent
   | UnipiMcpServerEvent
   | UnipiMcpToolsEvent
-  | UnipiMcpCatalogSyncedEvent;
+  | UnipiMcpCatalogSyncedEvent
+  | UnipiCompactionEvent
+  | UnipiCompactorStatsEvent
+  | UnipiUtilityCleanupEvent
+  | UnipiUtilityDiagnosticsEvent
+  | UnipiUtilityLifecycleEvent
+  | UnipiNotificationSentEvent;

package/package.json

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

package/sandbox.ts

@@ -40,6 +40,12 @@ const COMMAND_SANDBOX: Record<string, SandboxLevel> = {
   [WORKFLOW_COMMANDS.DOCUMENT]: "write_unipi",
   [WORKFLOW_COMMANDS.SCAN_ISSUES]: "read_only",
   [WORKFLOW_COMMANDS.AUTO]: "full",
+  [WORKFLOW_COMMANDS.DEBUG]: "read_only",
+  [WORKFLOW_COMMANDS.FIX]: "full",
+  [WORKFLOW_COMMANDS.QUICK_FIX]: "full",
+  [WORKFLOW_COMMANDS.RESEARCH]: "read_only",
+  [WORKFLOW_COMMANDS.CHORE_CREATE]: "write_unipi",
+  [WORKFLOW_COMMANDS.CHORE_EXECUTE]: "full",
 };
 
 /**