@wwjd/pi-graphify 0.3.0 → 0.4.0

package/src/commands/test-helpers.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared test helpers for command tests.
+ */
+
+import { createMockBackend } from "../backends/mock.js";
+import { GraphifyCoordinator } from "../coordinator.js";
+
+export function createTestCoordinator(backend = createMockBackend()): GraphifyCoordinator {
+  return new GraphifyCoordinator({ cwd: process.cwd(), backend });
+}
+
+export function getCoordinator(
+  coordinator: GraphifyCoordinator | null,
+): () => GraphifyCoordinator | null {
+  return () => coordinator;
+}

package/src/commands/types.ts

@@ -0,0 +1,76 @@
+/**
+ * Shared types for Graphify slash commands.
+ *
+ * Command executors receive a narrow subset of ExtensionCommandContext so they
+ * are easy to test with mock contexts.
+ */
+
+import type { ExtensionCommandContext, ExtensionUIContext } from "@earendil-works/pi-coding-agent";
+import type { GraphifyCapabilities } from "../backends/types.js";
+import type { CoordinatorProvider } from "../coordinator.js";
+
+export type ExtensionMode = "tui" | "rpc" | "json" | "print";
+
+/** UI surface needed by command executors and the unified menu. */
+export interface CommandUIContext
+  extends Pick<ExtensionUIContext, "notify" | "input" | "select" | "custom"> {}
+
+/** Context passed to every command executor. */
+export interface CommandContext {
+  cwd: string;
+  ui: CommandUIContext;
+  hasUI: boolean;
+  mode: ExtensionMode;
+  isProjectTrusted(): boolean;
+}
+
+/** Function signature for a command executor. */
+export type CommandExecutor = (
+  ctx: CommandContext,
+  getCoordinator: CoordinatorProvider,
+  args: string,
+) => Promise<void>;
+
+/** How a command collects arguments from the unified menu. */
+export type CommandArgMode = "none" | "input" | "flags";
+
+/** Static metadata and runtime executor for one slash command. */
+export interface CommandDefinition {
+  /** Slash command name, e.g. "graphify-build". */
+  name: string;
+
+  /** Menu label, e.g. "Build graph". */
+  label: string;
+
+  /** Description shown in the menu and in Pi's command list. */
+  description: string;
+
+  /** Required Graphify capability. */
+  feature: keyof GraphifyCapabilities;
+
+  /** Usage string shown when arguments are invalid. */
+  usage: string;
+
+  /** How the menu collects arguments. */
+  argMode: CommandArgMode;
+
+  /** Title for ctx.ui.input when argMode is "input" or "flags". */
+  prompt?: string;
+
+  /** Placeholder for ctx.ui.input. */
+  placeholder?: string;
+
+  /** Execute the command with the given raw argument string. */
+  execute: CommandExecutor;
+}
+
+/** Narrow an ExtensionCommandContext to the CommandContext shape. */
+export function toCommandContext(ctx: ExtensionCommandContext): CommandContext {
+  return {
+    cwd: ctx.cwd,
+    ui: ctx.ui,
+    hasUI: ctx.hasUI,
+    mode: ctx.mode as ExtensionMode,
+    isProjectTrusted: ctx.isProjectTrusted,
+  };
+}

package/src/commands/version.ts

@@ -0,0 +1,40 @@
+/**
+ * /graphify-version — show the installed Graphify CLI version.
+ */
+
+import type { GraphifyCapabilities } from "../backends/types.js";
+import { formatErrorForCommand, formatResultForCommand } from "./format.js";
+import { requireCoordinatorWithCapability } from "./helpers.js";
+import type { CommandDefinition, CommandExecutor } from "./types.js";
+
+const FEATURE: keyof GraphifyCapabilities = "version";
+
+const executeVersion: CommandExecutor = async (ctx, getCoordinator) => {
+  if (!ctx.hasUI) return;
+
+  const coordinator = requireCoordinatorWithCapability(
+    ctx,
+    getCoordinator,
+    FEATURE,
+    "The installed Graphify version does not support version reporting.",
+  );
+  if (!coordinator) return;
+
+  try {
+    const result = await coordinator.getVersion();
+    ctx.ui.notify(formatResultForCommand(result), "info");
+  } catch (error) {
+    const { message, severity } = formatErrorForCommand(error);
+    ctx.ui.notify(message, severity);
+  }
+};
+
+export const versionCommand: CommandDefinition = {
+  name: "graphify-version",
+  label: "Graphify version",
+  description: "Show the installed Graphify CLI version",
+  feature: FEATURE,
+  usage: "",
+  argMode: "none",
+  execute: executeVersion,
+};

package/src/coordinator.ts

@@ -181,6 +181,8 @@ export class GraphifyCoordinator {
   }
 }
 
+export type CoordinatorProvider = () => GraphifyCoordinator | null;
+
 /** Convenience factory. */
 export async function createGraphifyCoordinator(
   cwd: string,

package/src/tools/index.ts

@@ -1,6 +1,6 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type { GraphifyCapabilities } from "../backends/types.js";
-import type { GraphifyCoordinator } from "../coordinator.js";
+import type { CoordinatorProvider, GraphifyCoordinator } from "../coordinator.js";
 import { registerAffectedTool } from "./affected.js";
 import { registerBuildTool } from "./build.js";
 import { registerExplainTool } from "./explain.js";
@@ -9,7 +9,7 @@ import { registerQueryTool } from "./query.js";
 import { registerStatusTool } from "./status.js";
 import { registerVersionTool } from "./version.js";
 
-export type CoordinatorProvider = () => GraphifyCoordinator | null;
+export type { CoordinatorProvider } from "../coordinator.js";
 
 export interface RegisterToolsOptions {
   /** Tracks tool names that have already been registered to prevent duplicates. */