codetrellis 0.0.0-stage → 0.3.0

package/src/backend/mcp/helpers.js

@@ -0,0 +1,43 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var helpers_exports = {};
+__export(helpers_exports, {
+  authorFromExtra: () => authorFromExtra,
+  resultWithMeta: () => resultWithMeta
+});
+module.exports = __toCommonJS(helpers_exports);
+function resultWithMeta(data, subscribers) {
+  return {
+    content: [{
+      type: "text",
+      text: JSON.stringify({ ...data, _meta: { broadcast: true, subscribers } }, null, 2)
+    }]
+  };
+}
+function authorFromExtra(deps, extra) {
+  const sessionId = extra?.sessionInfo?.sessionId ?? extra?.requestInfo?.headers?.["mcp-session-id"] ?? deps.sessionId ?? null;
+  const sessions = deps.sessionService.getActiveSessions();
+  const session = sessionId ? sessions.find((s) => s.sessionId === sessionId) : null;
+  const author = session?.agentType ?? "agent";
+  return { author, authorType: "mcp" };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  authorFromExtra,
+  resultWithMeta
+});

package/src/backend/mcp/prompt-builders.js

@@ -0,0 +1,104 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var prompt_builders_exports = {};
+__export(prompt_builders_exports, {
+  buildItemPrompt: () => buildItemPrompt,
+  buildPlanPrompt: () => buildPlanPrompt
+});
+module.exports = __toCommonJS(prompt_builders_exports);
+function buildPlanPrompt(plan, items, refs) {
+  const lines = [`# ${plan.title}`];
+  if (plan.description) lines.push("", plan.description);
+  lines.push("");
+  if (plan.baseRef || plan.targetBranch) {
+    lines.push("## Git Context");
+    if (plan.baseRef) lines.push(`- Base: \`${plan.baseRef}\``);
+    if (plan.targetBranch) lines.push(`- Target branch: \`${plan.targetBranch}\``);
+    if (plan.autoCreateBranch) lines.push(`- Auto-create branch: yes`);
+    lines.push("");
+  }
+  const actions = items.filter((i) => i.kind === "action" && (i.status === "pending" || i.status === "assigned")).sort((a, b) => a.sortOrder - b.sortOrder);
+  if (actions.length > 0) {
+    lines.push("## Tasks", "");
+    for (const action of actions) {
+      lines.push(`### ${action.title}`);
+      if (action.body) lines.push("", action.body);
+      if (action.scopePath) lines.push("", `Scope: \`${action.scopePath}\``);
+      appendFileSpecs(lines, action.fileSpecs);
+      appendSymbolSpecs(lines, action.symbolSpecs);
+      appendConstraints(lines, action.constraints);
+      lines.push("");
+    }
+  }
+  if (refs && refs.length > 0) {
+    lines.push("## External References", "");
+    for (const ref of refs) lines.push(`- [${ref.title}](${ref.url})${ref.kind !== "url" ? ` (${ref.kind.replace(/_/g, " ")})` : ""}`);
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function buildItemPrompt(item, plan) {
+  const lines = [`# Task: ${item.title}`];
+  if (item.body) lines.push("", item.body);
+  lines.push("");
+  if (item.scopePath) lines.push(`**Scope:** \`${item.scopePath}\``);
+  appendFileSpecs(lines, item.fileSpecs);
+  appendSymbolSpecs(lines, item.symbolSpecs);
+  appendConstraints(lines, item.constraints);
+  if (plan.baseRef || plan.targetBranch) {
+    lines.push("", "## Git Context");
+    if (plan.baseRef) lines.push(`- Base: \`${plan.baseRef}\``);
+    if (plan.targetBranch) lines.push(`- Branch: \`${plan.targetBranch}\``);
+  }
+  return lines.join("\n");
+}
+function appendFileSpecs(lines, fileSpecs) {
+  if (!fileSpecs?.length) return;
+  lines.push("", "**Files:**");
+  for (const fs of fileSpecs) {
+    const editsStr = (fs.edits ?? []).filter((e) => e.instruction).map((e) => e.symbol ? `  - ${e.symbol}: ${e.instruction}` : `  - ${e.instruction}`).join("\n");
+    lines.push(`- \`${fs.path}\` (${fs.action})${fs.description ? ` \u2014 ${fs.description}` : ""}`);
+    if (editsStr) lines.push(editsStr);
+  }
+}
+function appendSymbolSpecs(lines, symbolSpecs) {
+  if (!symbolSpecs?.length) return;
+  lines.push("", "**Symbols:**");
+  for (const ss of symbolSpecs) {
+    lines.push(`- ${ss.action} \`${ss.name}\`${ss.filePath ? ` in \`${ss.filePath}\`` : ""}${ss.description ? ` \u2014 ${ss.description}` : ""}`);
+  }
+}
+function appendConstraints(lines, constraints) {
+  if (!constraints) return;
+  const c = constraints;
+  lines.push("", "**Guardrails:**");
+  if (c.excludePaths?.length) lines.push(`- Do NOT modify: ${c.excludePaths.map((p) => `\`${p}\``).join(", ")}`);
+  if (c.lockInterfaces) lines.push("- Do NOT change function/method signatures");
+  if (c.requireTests) lines.push("- Must include tests for all changes");
+  if (c.requireLint) lines.push("- Must pass lint/format before completing");
+  if (c.maxFilesTouched) lines.push(`- Max ${c.maxFilesTouched} files may be touched`);
+  if (c.maxLinesChanged) lines.push(`- Max ${c.maxLinesChanged} lines changed`);
+  if (c.customRules?.length) {
+    for (const rule of c.customRules) lines.push(`- ${rule}`);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildItemPrompt,
+  buildPlanPrompt
+});

package/src/backend/mcp/resources.js

@@ -0,0 +1,197 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var resources_exports = {};
+__export(resources_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(resources_exports);
+function register(server, deps) {
+  server.registerResource(
+    "codetrellis://skill",
+    "codetrellis://skill",
+    {
+      description: "How to use CodeTrellis \u2014 tailored summary of plans, spec docs, systems, and active sessions in this project.",
+      mimeType: "text/markdown"
+    },
+    async () => ({
+      contents: [{
+        uri: "codetrellis://skill",
+        mimeType: "text/markdown",
+        text: deps.buildSkillGuide("summary")
+      }]
+    })
+  );
+  server.registerResource(
+    "codetrellis://skill/quickstart",
+    "codetrellis://skill/quickstart",
+    {
+      description: "CodeTrellis quickstart for AI coding agents \u2014 basic flow: read the active plan, claim a task, do the work, mark it done.",
+      mimeType: "text/markdown"
+    },
+    async () => ({
+      contents: [{
+        uri: "codetrellis://skill/quickstart",
+        mimeType: "text/markdown",
+        text: deps.buildSkillGuide("quickstart")
+      }]
+    })
+  );
+  server.registerResource(
+    "codetrellis://skill/power-user",
+    "codetrellis://skill/power-user",
+    {
+      description: "CodeTrellis power-user guide for AI coding agents \u2014 spec docs, drift verification, multi-agent coordination, granular task fields.",
+      mimeType: "text/markdown"
+    },
+    async () => ({
+      contents: [{
+        uri: "codetrellis://skill/power-user",
+        mimeType: "text/markdown",
+        text: deps.buildSkillGuide("power-user")
+      }]
+    })
+  );
+  server.registerResource(
+    "codetrellis://skill/ui-nav",
+    "codetrellis://skill/ui-nav",
+    {
+      description: "CodeTrellis UI navigator skill \u2014 focused guide for a sub-agent that drives the UI while the primary agent works. Covers views, graph control, item navigation, and common sequences.",
+      mimeType: "text/markdown"
+    },
+    async () => ({
+      contents: [{
+        uri: "codetrellis://skill/ui-nav",
+        mimeType: "text/markdown",
+        text: deps.buildSkillGuide("ui-nav")
+      }]
+    })
+  );
+  server.registerResource(
+    "codetrellis://skill/diagnostics",
+    "codetrellis://skill/diagnostics",
+    {
+      description: "CodeTrellis diagnostics skill \u2014 logs, settings, baseline, drift detection, architecture conformity. Focused reference for investigating issues and checking system state.",
+      mimeType: "text/markdown"
+    },
+    async () => ({
+      contents: [{
+        uri: "codetrellis://skill/diagnostics",
+        mimeType: "text/markdown",
+        text: deps.buildSkillGuide("diagnostics")
+      }]
+    })
+  );
+  server.registerResource(
+    "codetrellis://skill/multi-agent",
+    "codetrellis://skill/multi-agent",
+    {
+      description: "CodeTrellis multi-agent skill \u2014 terminals, claiming, handoff patterns, session registration, approval gates. Focused reference for orchestrating multiple AI agents.",
+      mimeType: "text/markdown"
+    },
+    async () => ({
+      contents: [{
+        uri: "codetrellis://skill/multi-agent",
+        mimeType: "text/markdown",
+        text: deps.buildSkillGuide("multi-agent")
+      }]
+    })
+  );
+  server.registerResource(
+    "codetrellis://skill/parallel",
+    "codetrellis://skill/parallel",
+    {
+      description: "CodeTrellis parallel-work skill (Phase 32) \u2014 the contract for working alongside agents in other worktrees: get_awareness, declare_intent, check_footprint, acknowledge_signal, and what a notice means.",
+      mimeType: "text/markdown"
+    },
+    async () => ({
+      contents: [{
+        uri: "codetrellis://skill/parallel",
+        mimeType: "text/markdown",
+        text: deps.buildSkillGuide("parallel")
+      }]
+    })
+  );
+  server.registerResource(
+    "project://graph",
+    "project://graph",
+    {
+      description: "Current dependency graph as JSON \u2014 all file-to-file import edges",
+      mimeType: "application/json"
+    },
+    async () => {
+      const edges = deps.getDependencyEdges();
+      const stats = deps.getDbStats();
+      return {
+        contents: [{
+          uri: "project://graph",
+          mimeType: "application/json",
+          text: JSON.stringify({ stats, edges }, null, 2)
+        }]
+      };
+    }
+  );
+  server.registerResource(
+    "codetrellis://plans",
+    "codetrellis://plans",
+    {
+      description: "List of all plans in CodeTrellis",
+      mimeType: "application/json"
+    },
+    async () => ({
+      contents: [{
+        uri: "codetrellis://plans",
+        mimeType: "application/json",
+        text: JSON.stringify(deps.planService.listPlans(), null, 2)
+      }]
+    })
+  );
+  server.registerResource(
+    "codetrellis://sessions",
+    "codetrellis://sessions",
+    {
+      description: "Active agent sessions connected to CodeTrellis",
+      mimeType: "application/json"
+    },
+    async () => ({
+      contents: [{
+        uri: "codetrellis://sessions",
+        mimeType: "application/json",
+        text: JSON.stringify(deps.sessionService.getActiveSessions(), null, 2)
+      }]
+    })
+  );
+  server.registerResource(
+    "project://stats",
+    "project://stats",
+    {
+      description: "Database statistics \u2014 file count, symbol count, import count",
+      mimeType: "application/json"
+    },
+    async () => ({
+      contents: [{
+        uri: "project://stats",
+        mimeType: "application/json",
+        text: JSON.stringify(deps.getDbStats(), null, 2)
+      }]
+    })
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});