@cliangdev/flux-plugin 0.3.1-dev.bdbaeae → 0.3.1

package/commands/dashboard.md

@@ -13,7 +13,7 @@ Launch the Flux Dashboard web interface to visualize project status.
 Run the dashboard server:
 
 ```bash
-bunx --force @cliangdev/flux-plugin@latest dashboard
+bunx @cliangdev/flux-plugin dashboard
 ```
 
 This will:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cliangdev/flux-plugin",
-  "version": "0.3.1-dev.bdbaeae",
+  "version": "0.3.1",
   "description": "Claude Code plugin for AI-first workflow orchestration with MCP server",
   "type": "module",
   "main": "./dist/server/index.js",
@@ -59,8 +59,6 @@
   "dependencies": {
     "@linear/sdk": "^70.0.0",
     "@modelcontextprotocol/sdk": "^1.25.2",
-    "@octokit/graphql": "^9.0.3",
-    "@octokit/rest": "^22.0.1",
     "chalk": "^5.4.1",
     "zod": "^4.3.5"
   },

package/src/server/adapters/factory.ts

@@ -1,7 +1,12 @@
+/**
+ * Adapter Factory
+ *
+ * Creates the appropriate adapter based on project configuration.
+ * Supports LocalAdapter and LinearAdapter; future adapters will be added here.
+ */
+
 import { existsSync, readFileSync } from "node:fs";
 import { config } from "../config.js";
-import { GitHubAdapter } from "./github/adapter.js";
-import { loadGithubConfig } from "./github/config.js";
 import { LinearAdapter } from "./linear/adapter.js";
 import { linearConfigExists, loadLinearConfig } from "./linear/config.js";
 import { LocalAdapter } from "./local-adapter.js";
@@ -9,8 +14,12 @@ import type { AdapterConfig, BackendAdapter } from "./types.js";
 
 let cachedAdapter: BackendAdapter | null = null;
 
+/**
+ * Get the adapter configuration from project.json
+ */
 function getAdapterConfig(): AdapterConfig {
   if (!existsSync(config.projectJsonPath)) {
+    // Default to local adapter if project not initialized
     return { type: "local" };
   }
 
@@ -23,6 +32,12 @@ function getAdapterConfig(): AdapterConfig {
   }
 }
 
+/**
+ * Create an adapter instance based on configuration.
+ *
+ * @param adapterConfig - Optional override for adapter configuration
+ * @returns The appropriate BackendAdapter implementation
+ */
 export function createAdapter(adapterConfig?: AdapterConfig): BackendAdapter {
   const cfg = adapterConfig ?? getAdapterConfig();
 
@@ -45,10 +60,6 @@ export function createAdapter(adapterConfig?: AdapterConfig): BackendAdapter {
     case "notion":
       // TODO: Implement NotionAdapter
       throw new Error("Notion adapter not yet implemented");
-    case "github": {
-      const githubConfig = loadGithubConfig();
-      return new GitHubAdapter(githubConfig);
-    }
     default: {
       const _exhaustive: never = cfg.type;
       throw new Error(`Unknown adapter type: ${cfg.type}`);
@@ -56,6 +67,13 @@ export function createAdapter(adapterConfig?: AdapterConfig): BackendAdapter {
   }
 }
 
+/**
+ * Get or create a cached adapter instance.
+ * Uses singleton pattern to avoid creating multiple adapter instances.
+ *
+ * @param forceNew - If true, creates a new adapter even if one is cached
+ * @returns The cached or newly created adapter
+ */
 export function getAdapter(forceNew = false): BackendAdapter {
   if (forceNew || !cachedAdapter) {
     cachedAdapter = createAdapter();
@@ -63,6 +81,10 @@ export function getAdapter(forceNew = false): BackendAdapter {
   return cachedAdapter;
 }
 
+/**
+ * Clear the cached adapter instance.
+ * Useful for testing or when project configuration changes.
+ */
 export function clearAdapterCache(): void {
   cachedAdapter = null;
 }

package/src/server/adapters/types.ts

@@ -288,6 +288,6 @@ export interface CascadeResult {
  * Adapter configuration stored in project.json
  */
 export interface AdapterConfig {
-  type: "local" | "specflux" | "linear" | "notion" | "github";
+  type: "local" | "specflux" | "linear" | "notion";
   config?: Record<string, unknown>;
 }

package/src/server/index.ts

@@ -5,7 +5,6 @@ import { fluxProjectExists, initDb } from "./db/index.js";
 import {
   addCriteriaTool,
   addDependencyTool,
-  configureGithubTool,
   configureLinearTool,
   createEpicTool,
   createPrdTool,
@@ -51,7 +50,6 @@ const tools: ToolDefinition[] = [
   getStatsTool,
   getVersionTool,
   // Configuration tools
-  configureGithubTool,
   configureLinearTool,
   // Display tools
   renderStatusTool,

package/src/server/tools/__tests__/mcp-interface.test.ts

@@ -84,12 +84,6 @@ describe("MCP Interface", () => {
       expect(toolOption?.params?.vision).toBeDefined();
       expect(toolOption?.params?.adapter).toBeDefined();
     });
-
-    test("adapter param includes github option", () => {
-      const error = createProjectNotInitializedError("/cwd", "/root");
-      const toolOption = error.setup.options.find((o) => o.method === "tool");
-      expect(toolOption?.params?.adapter).toContain("github");
-    });
   });
 
   describe("registerTools", () => {

package/src/server/tools/index.ts

@@ -64,7 +64,7 @@ export function createProjectNotInitializedError(
           params: {
             name: "Project name (required)",
             vision: "Brief project description (required)",
-            adapter: "local | linear | github (default: local)",
+            adapter: "local | linear (default: local)",
           },
         },
       ],
@@ -140,7 +140,6 @@ export function registerTools(server: Server, tools: ToolDefinition[]) {
   });
 }
 
-export { configureGithubTool } from "./configure-github.js";
 export { configureLinearTool } from "./configure-linear.js";
 export { createEpicTool } from "./create-epic.js";
 export { createPrdTool } from "./create-prd.js";

package/src/server/tools/init-project.ts

@@ -48,13 +48,7 @@ function setupClaudeSettings(projectRoot: string): void {
   }
 }
 
-const adapterTypes = [
-  "local",
-  "specflux",
-  "linear",
-  "notion",
-  "github",
-] as const;
+const adapterTypes = ["local", "specflux", "linear", "notion"] as const;
 
 const inputSchema = z.object({
   name: z.string().min(1, "Project name is required"),
@@ -86,37 +80,29 @@ async function handler(input: unknown) {
   writeFileSync(config.projectJsonPath, JSON.stringify(projectJson, null, 2));
   config.clearCache();
 
-  if (parsed.adapter === "local") {
-    initDb();
-    const projectId = generateId("proj");
-    const db = getDb();
-    insert(db, "projects", {
-      id: projectId,
-      name: parsed.name,
-      ref_prefix: refPrefix,
-    });
-  }
+  initDb();
 
-  setupClaudeSettings(config.projectRoot);
+  const projectId = generateId("proj");
+  const db = getDb();
+  insert(db, "projects", {
+    id: projectId,
+    name: parsed.name,
+    ref_prefix: refPrefix,
+  });
 
-  const nextStep =
-    parsed.adapter === "github"
-      ? "Run configure_github to connect your GitHub tracking repository."
-      : parsed.adapter === "linear"
-        ? "Run configure_linear to connect your Linear workspace."
-        : "Run /flux:prd to start planning.";
+  setupClaudeSettings(config.projectRoot);
 
   return {
     success: true,
     project: projectJson,
-    message: `Flux project initialized. ${nextStep}`,
+    message: `Flux project initialized. Run /flux:prd to start planning.`,
   };
 }
 
 export const initProjectTool: ToolDefinition = {
   name: "init_project",
   description:
-    "Initialize a new Flux project. Required: name, vision. Optional: adapter (local|linear|github, default 'local'). Creates .flux/ directory with project.json. For local adapter, also initializes SQLite database. For github or linear, run configure_github or configure_linear next. Returns {success, project, message}. Fails if .flux/ already exists.",
+    "Initialize a new Flux project. Required: name, vision. Optional: adapter (local|specflux|linear|notion, default 'local'). Creates .flux/ directory with project.json and SQLite database. Returns {success, project, message}. Fails if .flux/ already exists.",
   inputSchema,
   handler,
 };