loopctl-mcp-server 2.42.0 → 2.44.0

package/index.js

@@ -402,6 +402,41 @@ async function createProject({ name, slug, repo_url, description, tech_stack, mi
   return toContent(result);
 }
 
+async function createKbScope({ name, slug, repo_url, description, tech_stack }) {
+  const body = { name, slug };
+  if (repo_url) body.repo_url = repo_url;
+  if (description) body.description = description;
+  if (tech_stack) body.tech_stack = tech_stack;
+  // Uses the AGENT key (not ORCH): a KB scope is agent-createable on the KB tier — that is
+  // the whole point. The server forces kind: :kb; a body-supplied kind is ignored.
+  const result = await apiCall("POST", "/api/v1/kb-scopes", body, process.env.LOOPCTL_AGENT_KEY);
+  return toContent(result);
+}
+
+async function archiveKbScope({ project_id }) {
+  // Reversible soft-delete of an agent-owned :kb scope on the AGENT key; frees its
+  // max_projects slot. The server rejects a :work project (422). Reverse with restore_kb_scope.
+  const result = await apiCall(
+    "DELETE",
+    `/api/v1/kb-scopes/${project_id}`,
+    null,
+    process.env.LOOPCTL_AGENT_KEY,
+  );
+  return toContent(result);
+}
+
+async function restoreKbScope({ project_id }) {
+  // Re-activate an archived :kb scope on the AGENT key (re-consumes a max_projects slot;
+  // 422 if at the cap). The server rejects a :work project (422).
+  const result = await apiCall(
+    "POST",
+    `/api/v1/kb-scopes/${project_id}/restore`,
+    {},
+    process.env.LOOPCTL_AGENT_KEY,
+  );
+  return toContent(result);
+}
+
 async function deleteProject({ project_id }) {
   const result = await apiCall(
     "DELETE",
@@ -2100,6 +2135,49 @@ const TOOLS = [
       required: ["name", "slug"],
     },
   },
+  {
+    name: "create_kb_scope",
+    description:
+      "Create a knowledge-only project scope (kind: kb) for the current tenant. Unlike create_project (work project, orchestrator+ / human-anchored), this is available to an agent-rooted (KB-tier) tenant with an agent key: a kb scope carries NO chain-of-custody / work-breakdown surface (it cannot host epics/stories/dispatch/ui-tests), it exists only to partition knowledge articles by repo so captured/created articles can be project-scoped. Then resolve_project by its repo_url/slug and pass the returned id as project_id on article/knowledge writes. Counts toward the tenant's max_projects budget.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: { type: "string", description: "Scope name (often the repo name)." },
+        slug: { type: "string", description: "URL-safe slug (often the repo basename)." },
+        repo_url: {
+          type: "string",
+          description: "Repo URL, so resolve_project can map a repo to this scope.",
+        },
+        description: { type: "string", description: "Scope description." },
+        tech_stack: { type: "string", description: "Tech stack summary." },
+      },
+      required: ["name", "slug"],
+    },
+  },
+  {
+    name: "archive_kb_scope",
+    description:
+      "Archive (reversible soft-delete) a knowledge-only project scope (kind: kb) you own, on the agent key. Frees the scope's slot in the tenant's max_projects budget so you can reclaim KB-scope capacity — the reverse of create_kb_scope. Its articles remain readable/writable; restore_kb_scope re-activates it. Rejects a kind: work project (422) — archiving a work project stays human-anchored. Idempotent on an already-archived scope.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string", description: "UUID of the :kb scope to archive." },
+      },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "restore_kb_scope",
+    description:
+      "Restore (re-activate) an archived knowledge-only project scope (kind: kb) you own, on the agent key — the reverse of archive_kb_scope. Re-activating consumes an active max_projects slot, so it is rejected (422) when the tenant is at its cap. Rejects a kind: work project (422).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: { type: "string", description: "UUID of the archived :kb scope to restore." },
+      },
+      required: ["project_id"],
+    },
+  },
   {
     name: "delete_project",
     description:
@@ -4860,6 +4938,15 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     case "create_project":
       return await createProject(args);
 
+    case "create_kb_scope":
+      return await createKbScope(args);
+
+    case "archive_kb_scope":
+      return await archiveKbScope(args);
+
+    case "restore_kb_scope":
+      return await restoreKbScope(args);
+
     case "delete_project":
       return await deleteProject(args);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loopctl-mcp-server",
-  "version": "2.42.0",
+  "version": "2.44.0",
   "description": "MCP server for loopctl — structural trust for AI development loops",
   "type": "module",
   "main": "index.js",