@mrclrchtr/supi-debug 1.2.0 → 1.3.1

package/node_modules/@mrclrchtr/supi-core/README.md

@@ -12,7 +12,12 @@ pnpm add @mrclrchtr/supi-core
 
 ## Package role
 
-`@mrclrchtr/supi-core` is a library package. It does **not** register a pi extension and is not meant to be installed as a standalone pi package.
+`@mrclrchtr/supi-core` now has two explicit surfaces:
+
+- `@mrclrchtr/supi-core/api` — shared library helpers for other SuPi packages
+- `@mrclrchtr/supi-core/extension` — a minimal pi extension that registers `/supi-settings`
+
+`pi.extensions` still points at the real file path `./src/extension.ts` inside the package. The `/api` and `/extension` paths are consumer-facing package exports, not manifest aliases.
 
 ## What it provides
 
@@ -59,7 +64,7 @@ Main helpers:
 ## Example
 
 ```ts
-import { loadSupiConfig, registerConfigSettings, wrapExtensionContext } from "@mrclrchtr/supi-core";
+import { loadSupiConfig, registerConfigSettings, wrapExtensionContext } from "@mrclrchtr/supi-core/api";
 
 const config = loadSupiConfig("my-extension", process.cwd(), {
   enabled: true,
@@ -87,4 +92,5 @@ const message = wrapExtensionContext("my-extension", "hello", {
 
 ## Source
 
-- Main exports: `src/index.ts`
+- Library surface: `src/api.ts`
+- Extension surface: `src/extension.ts`

package/node_modules/@mrclrchtr/supi-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
   "license": "MIT",
   "repository": {
@@ -30,5 +30,15 @@
       "optional": true
     }
   },
-  "main": "src/index.ts"
+  "main": "src/api.ts",
+  "exports": {
+    "./api": "./src/api.ts",
+    "./extension": "./src/extension.ts",
+    "./package.json": "./package.json"
+  },
+  "pi": {
+    "extensions": [
+      "./src/extension.ts"
+    ]
+  }
 }

package/node_modules/@mrclrchtr/supi-core/src/api.ts

@@ -0,0 +1,83 @@
+// supi-core — shared infrastructure for SuPi extensions.
+// Provides XML context tag wrapping, unified config system, context-message utilities,
+// and settings registry for supi-wide TUI settings.
+
+export type { SupiConfigLocation, SupiConfigOptions } from "./config.ts";
+export {
+  loadSupiConfig,
+  loadSupiConfigForScope,
+  removeSupiConfigKey,
+  writeSupiConfig,
+} from "./config.ts";
+export type { ConfigSettingsHelpers, ConfigSettingsOptions } from "./config-settings.ts";
+export { registerConfigSettings } from "./config-settings.ts";
+export type { ContextMessageLike } from "./context-messages.ts";
+export {
+  findLastUserMessageIndex,
+  getContextToken,
+  getPromptContent,
+  pruneAndReorderContextMessages,
+  restorePromptContent,
+} from "./context-messages.ts";
+export type { ContextProvider } from "./context-provider-registry.ts";
+export {
+  clearRegisteredContextProviders,
+  getRegisteredContextProviders,
+  registerContextProvider,
+} from "./context-provider-registry.ts";
+export { wrapExtensionContext } from "./context-tag.ts";
+export type {
+  DebugAgentAccess,
+  DebugEvent,
+  DebugEventInput,
+  DebugEventQuery,
+  DebugEventQueryResult,
+  DebugEventView,
+  DebugLevel,
+  DebugNotifyLevel,
+  DebugRegistryConfig,
+  DebugSummary,
+} from "./debug-registry.ts";
+export {
+  clearDebugEvents,
+  configureDebugRegistry,
+  DEBUG_REGISTRY_DEFAULTS,
+  getDebugEvents,
+  getDebugRegistryConfig,
+  getDebugSummary,
+  recordDebugEvent,
+  redactDebugData,
+  resetDebugRegistry,
+} from "./debug-registry.ts";
+export type { KnownRootEntry } from "./project-roots.ts";
+export {
+  buildKnownRootsMap,
+  byPathDepth,
+  dedupeTopmostRoots,
+  findProjectRoot,
+  isWithin,
+  isWithinOrEqual,
+  mergeKnownRoots,
+  resolveKnownRoot,
+  segmentCount,
+  sortRootsBySpecificity,
+  walkProject,
+} from "./project-roots.ts";
+export { getActiveBranchEntries } from "./session-utils.ts";
+export { registerSettingsCommand } from "./settings-command.ts";
+export type { SettingsScope, SettingsSection } from "./settings-registry.ts";
+export {
+  clearRegisteredSettings,
+  getRegisteredSettings,
+  registerSettings,
+} from "./settings-registry.ts";
+export { createInputSubmenu, openSettingsOverlay } from "./settings-ui.ts";
+export type { TitleTarget } from "./terminal.ts";
+export {
+  DONE_SYMBOL,
+  formatTitle,
+  signalBell,
+  signalDone,
+  signalWaiting,
+  WAITING_SYMBOL,
+} from "./terminal.ts";

package/node_modules/@mrclrchtr/supi-core/src/extension.ts

@@ -0,0 +1 @@
+export { registerSettingsCommand as default } from "./settings-command.ts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-debug",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "SuPi Debug extension — shared debug event inspection for SuPi extensions",
   "license": "MIT",
   "repository": {
@@ -20,7 +20,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@mrclrchtr/supi-core": "1.2.0"
+    "@mrclrchtr/supi-core": "1.3.1"
   },
   "bundledDependencies": [
     "@mrclrchtr/supi-core"
@@ -43,8 +43,14 @@
   },
   "pi": {
     "extensions": [
-      "./src/debug.ts"
+      "./src/extension.ts",
+      "node_modules/@mrclrchtr/supi-core/src/extension.ts"
     ]
   },
-  "main": "src/index.ts"
+  "main": "src/api.ts",
+  "exports": {
+    "./api": "./src/api.ts",
+    "./extension": "./src/extension.ts",
+    "./package.json": "./package.json"
+  }
 }

package/src/api.ts

@@ -0,0 +1 @@
+export { default } from "./debug.ts";

package/src/debug.ts

@@ -13,11 +13,11 @@ import {
   loadSupiConfig,
   registerConfigSettings,
   registerContextProvider,
-} from "@mrclrchtr/supi-core";
+} from "@mrclrchtr/supi-core/api";
 import { Type } from "typebox";
-import { maybeLogLoadStatus } from "../status-log.ts";
 import { formatDataLines } from "./format.ts";
 import { registerDebugMessageRenderer } from "./renderer.ts";
+import { maybeLogLoadStatus } from "./status-log.ts";
 
 const DEBUG_SECTION = "debug";
 const DEBUG_REPORT_TYPE = "supi-debug-report";

package/src/extension.ts

@@ -0,0 +1 @@
+export { default } from "./debug.ts";

package/src/renderer.ts

@@ -1,6 +1,6 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Text } from "@earendil-works/pi-tui";
-import type { DebugEventView } from "@mrclrchtr/supi-core";
+import type { DebugEventView } from "@mrclrchtr/supi-core/api";
 import { formatDataLines } from "./format.ts";
 
 const DEBUG_REPORT_TYPE = "supi-debug-report";

package/src/status-log.ts

@@ -0,0 +1,70 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+const STATUS_LOG_PREFIX = "SUPI_STATUS ";
+const STATUS_LOG_ENV = "SUPI_LOG_STATUS";
+const EXPECTED_SUPI_TOOLS = ["ask_user", "lsp", "tree_sitter", "code_intel", "supi_debug"];
+const EXPECTED_SUPI_COMMANDS = [
+  "supi-settings",
+  "supi-debug",
+  "supi-context",
+  "supi-cache",
+  "lsp-status",
+  "supi-review",
+];
+
+function byName(a: string, b: string): number {
+  return a.localeCompare(b);
+}
+
+function statusLogEnabled(): boolean {
+  const value = process.env[STATUS_LOG_ENV];
+  if (!value) return false;
+  return ["1", "true", "yes", "on"].includes(value.trim().toLowerCase());
+}
+
+/**
+ * Emit a stderr-only SuPi load status marker for external log inspection.
+ *
+ * This deliberately does not call `pi.sendMessage()`: custom messages are part
+ * of pi's session history and are converted into LLM-visible user messages.
+ * `appendEntry()` is pi's native non-LLM context persistence surface, while
+ * stderr is captured by Harbor's `2>&1 | tee pi.txt` command for `--no-session`
+ * runs where session entries are not inspectable.
+ */
+export function maybeLogLoadStatus(pi: ExtensionAPI, cwd: string): void {
+  if (!statusLogEnabled()) return;
+
+  const allTools = typeof pi.getAllTools === "function" ? pi.getAllTools() : [];
+  const activeTools = typeof pi.getActiveTools === "function" ? pi.getActiveTools() : [];
+  const commands = typeof pi.getCommands === "function" ? pi.getCommands() : [];
+  const registeredToolNames = allTools.map((tool) => tool.name).sort(byName);
+  const activeToolNames = [...activeTools].sort(byName);
+  const commandNames = commands.map((command) => command.name).sort(byName);
+
+  const status = {
+    type: "supi_status",
+    version: 1,
+    phase: "session_start",
+    cwd,
+    expectedTools: Object.fromEntries(
+      EXPECTED_SUPI_TOOLS.map((tool) => [
+        tool,
+        {
+          registered: registeredToolNames.includes(tool),
+          active: activeToolNames.includes(tool),
+        },
+      ]),
+    ),
+    expectedCommands: Object.fromEntries(
+      EXPECTED_SUPI_COMMANDS.map((command) => [command, commandNames.includes(command)]),
+    ),
+    tools: {
+      registered: registeredToolNames,
+      active: activeToolNames,
+    },
+    commands: commandNames,
+  };
+
+  pi.appendEntry("supi-status", status);
+  process.stderr.write(`${STATUS_LOG_PREFIX}${JSON.stringify(status)}\n`);
+}