@cliangdev/flux-plugin 0.4.0-dev.17634ed → 0.4.0-dev.236e9f1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cliangdev/flux-plugin",
-  "version": "0.4.0-dev.17634ed",
+  "version": "0.4.0-dev.236e9f1",
   "description": "Claude Code plugin for AI-first workflow orchestration with MCP server",
   "type": "module",
   "main": "./dist/server/index.js",

package/src/server/adapters/github/__tests__/prd-crud.test.ts

@@ -223,7 +223,14 @@ describe("prd status mappers", () => {
     expect(prdStatusToLabel("ARCHIVED")).toBeNull();
   });
 
-  test("labelToPrdStatus detects ARCHIVED from closed state", async () => {
+  test("labelToPrdStatus detects COMPLETED from closed state with completed label", async () => {
+    const { labelToPrdStatus } = await import("../mappers/prd.js");
+    expect(labelToPrdStatus(["flux:prd", "status:completed"], true)).toBe(
+      "COMPLETED",
+    );
+  });
+
+  test("labelToPrdStatus detects ARCHIVED from closed state without completed label", async () => {
     const { labelToPrdStatus } = await import("../mappers/prd.js");
     expect(labelToPrdStatus(["flux:prd", "status:draft"], true)).toBe(
       "ARCHIVED",

package/src/server/adapters/github/adapter.ts

@@ -362,7 +362,7 @@ export class GitHubAdapter implements BackendAdapter {
       updateParams.title = input.title;
     }
 
-    if (newStatus === "ARCHIVED") {
+    if (newStatus === "COMPLETED" || newStatus === "ARCHIVED") {
       updateParams.state = "closed";
     }
 

package/src/server/adapters/github/mappers/prd.ts

@@ -23,7 +23,10 @@ export function labelToPrdStatus(
   labels: string[],
   isClosed: boolean,
 ): PrdStatus {
-  if (isClosed) return "ARCHIVED";
+  if (isClosed) {
+    if (labels.includes(GITHUB_LABELS.STATUS_COMPLETED)) return "COMPLETED";
+    return "ARCHIVED";
+  }
 
   if (labels.includes(GITHUB_LABELS.STATUS_COMPLETED)) return "COMPLETED";
   if (labels.includes(GITHUB_LABELS.STATUS_BREAKDOWN_READY))

package/src/server/index.ts

@@ -12,6 +12,7 @@ import {
   createTaskTool,
   deleteEntityTool,
   getEntityTool,
+  getProjectContextTool,
   getStatsTool,
   getVersionTool,
   initProjectTool,
@@ -48,6 +49,7 @@ const tools: ToolDefinition[] = [
   getEntityTool,
   queryEntitiesTool,
   initProjectTool,
+  getProjectContextTool,
   getStatsTool,
   getVersionTool,
   // Configuration tools

package/src/server/tools/__tests__/get-project-context.test.ts

@@ -0,0 +1,81 @@
+import { afterEach, beforeEach, describe, expect, test } from "bun:test";
+import { mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+
+const TEST_DIR = `/tmp/flux-test-project-context-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+const FLUX_DIR = join(TEST_DIR, ".flux");
+process.env.FLUX_PROJECT_ROOT = TEST_DIR;
+
+import { config } from "../../config.js";
+import { getProjectContextTool } from "../get-project-context.js";
+
+describe("get_project_context", () => {
+  beforeEach(() => {
+    config.clearCache();
+    process.env.FLUX_PROJECT_ROOT = TEST_DIR;
+    mkdirSync(FLUX_DIR, { recursive: true });
+  });
+
+  afterEach(() => {
+    rmSync(TEST_DIR, { recursive: true, force: true });
+  });
+
+  test("returns local adapter when no adapter configured", async () => {
+    writeFileSync(
+      join(FLUX_DIR, "project.json"),
+      JSON.stringify({ name: "test-project", vision: "A test project" }),
+    );
+
+    const result = (await getProjectContextTool.handler({})) as any;
+
+    expect(result.name).toBe("test-project");
+    expect(result.vision).toBe("A test project");
+    expect(result.adapter.type).toBe("local");
+  });
+
+  test("returns github adapter type when configured", async () => {
+    writeFileSync(
+      join(FLUX_DIR, "project.json"),
+      JSON.stringify({
+        name: "gh-project",
+        vision: "GitHub project",
+        refPrefix: "GH",
+        adapter: { type: "github" },
+      }),
+    );
+
+    const result = (await getProjectContextTool.handler({})) as any;
+
+    expect(result.name).toBe("gh-project");
+    expect(result.vision).toBe("GitHub project");
+    expect(result.ref_prefix).toBe("GH");
+    expect(result.adapter.type).toBe("github");
+  });
+
+  test("returns linear adapter type when configured", async () => {
+    writeFileSync(
+      join(FLUX_DIR, "project.json"),
+      JSON.stringify({
+        name: "linear-project",
+        adapter: { type: "linear" },
+      }),
+    );
+
+    const result = (await getProjectContextTool.handler({})) as any;
+
+    expect(result.name).toBe("linear-project");
+    expect(result.adapter.type).toBe("linear");
+  });
+
+  test("has correct tool definition", () => {
+    expect(getProjectContextTool.name).toBe("get_project_context");
+    expect(getProjectContextTool.description).toContain("adapter");
+    expect(getProjectContextTool.inputSchema).toBeDefined();
+    expect(getProjectContextTool.handler).toBeDefined();
+  });
+
+  test("throws when project.json does not exist", async () => {
+    // No project.json written
+    expect(getProjectContextTool.handler({})).rejects.toThrow();
+  });
+});

package/src/server/tools/get-project-context.ts

@@ -0,0 +1,28 @@
+import { readFileSync } from "node:fs";
+import { z } from "zod";
+import { config } from "../config.js";
+import type { ToolDefinition } from "./index.js";
+
+const inputSchema = z.object({});
+
+async function handler(_input: unknown) {
+  const content = readFileSync(config.projectJsonPath, "utf-8");
+  const project = JSON.parse(content);
+
+  return {
+    name: project.name ?? null,
+    vision: project.vision ?? null,
+    ref_prefix: project.refPrefix ?? null,
+    adapter: {
+      type: project.adapter?.type ?? "local",
+    },
+  };
+}
+
+export const getProjectContextTool: ToolDefinition = {
+  name: "get_project_context",
+  description:
+    "Get project context including adapter type, project name, vision, and ref prefix. No parameters required. Returns {name, vision, ref_prefix, adapter: {type: 'local' | 'github' | 'linear'}}. Use this to detect which adapter is configured before performing adapter-specific operations.",
+  inputSchema,
+  handler,
+};

package/src/server/tools/index.ts

@@ -150,6 +150,7 @@ export { deleteEntityTool } from "./delete-entity.js";
 export { addDependencyTool, removeDependencyTool } from "./dependencies.js";
 export { getEntityTool } from "./get-entity.js";
 export { getLinearUrlTool } from "./get-linear-url.js";
+export { getProjectContextTool } from "./get-project-context.js";
 export { getStatsTool } from "./get-stats.js";
 export { getVersionTool } from "./get-version.js";
 export { initProjectTool } from "./init-project.js";