@pedrocivita/tocket 2.5.0 → 2.6.4

package/dist/eval/triage-eval.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+/**
+ * POC C eval: heuristic/Jev triage vs human labels + stability + naive baseline.
+ *
+ *   npm run eval:triage
+ */
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { toRepoRelative } from "../utils/context.js";
+import { parseLastRun } from "../utils/appmaps.js";
+import { heuristicCase, naiveIfElseChoice, selectResults, } from "../utils/triage.js";
+export const AGREEMENT_HYPOTHESIS = 0.8;
+export const STABILITY_KILL = 0.3;
+export const CHANCE_BASELINE = 0.25;
+export function loadExpected(path) {
+    return JSON.parse(readFileSync(path, "utf-8"));
+}
+export function evaluateTriage(lastRunPath, expectedPath) {
+    const expected = loadExpected(expectedPath);
+    const run = parseLastRun(readFileSync(lastRunPath, "utf-8"));
+    const selected = selectResults(run, expected.include_low_confidence);
+    const first = new Map(selected.map((result) => [result.id, heuristicCase(result).choice]));
+    const second = new Map(selected.map((result) => [result.id, heuristicCase(result).choice]));
+    const expectedById = new Map(expected.cases.map((item) => [item.id, item]));
+    const disagreements = [];
+    let agreed = 0;
+    let naiveAgreed = 0;
+    let unstable = 0;
+    for (const item of expected.cases) {
+        const result = selected.find((row) => row.id === item.id);
+        if (!result) {
+            disagreements.push({
+                id: item.id,
+                expected: item.expected,
+                got: "escalate",
+                flavor: `${item.flavor} (missing from selected results)`,
+            });
+            continue;
+        }
+        const got = first.get(item.id);
+        const again = second.get(item.id);
+        if (got !== again)
+            unstable += 1;
+        if (got === item.expected)
+            agreed += 1;
+        else if (got) {
+            disagreements.push({
+                id: item.id,
+                expected: item.expected,
+                got,
+                flavor: item.flavor,
+            });
+        }
+        if (naiveIfElseChoice(result) === item.expected)
+            naiveAgreed += 1;
+    }
+    const total = expected.cases.length;
+    const agreement = total === 0 ? 0 : agreed / total;
+    const naiveAgreement = total === 0 ? 0 : naiveAgreed / total;
+    const unstableRate = total === 0 ? 0 : unstable / total;
+    const reasons = [];
+    let verdict = "PASS";
+    if (unstableRate >= STABILITY_KILL) {
+        verdict = "FAIL";
+        reasons.push(`Stability kill: ${pct(unstableRate)} of cases changed across 2 identical runs (threshold ${pct(STABILITY_KILL)}).`);
+    }
+    if (agreement <= CHANCE_BASELINE || agreement <= naiveAgreement) {
+        verdict = "FAIL";
+        reasons.push(`Kill: agreement ${pct(agreement)} ≤ chance ${pct(CHANCE_BASELINE)} or naive if-else ${pct(naiveAgreement)}.`);
+    }
+    if (agreement < AGREEMENT_HYPOTHESIS && verdict !== "FAIL") {
+        verdict = "FAIL";
+        reasons.push(`Hypothesis miss: agreement ${pct(agreement)} < ${pct(AGREEMENT_HYPOTHESIS)}.`);
+    }
+    if (verdict === "PASS") {
+        reasons.push(`Dry-run heuristic agrees with human labels on ${agreed}/${total} (${pct(agreement)}), beats chance (${pct(CHANCE_BASELINE)}) and naive if-else (${pct(naiveAgreement)}), unstable ${pct(unstableRate)}.`);
+        reasons.push("Live Jev Choice was not scored (no TYPESAFE_API_KEY in this eval). Hypothesis for live Jev remains GRAY.");
+    }
+    return {
+        total,
+        agreed,
+        agreement,
+        naiveAgreed,
+        naiveAgreement,
+        chance: CHANCE_BASELINE,
+        unstable,
+        unstableRate,
+        disagreements,
+        verdict,
+        reasons,
+    };
+}
+export function pct(value) {
+    return `${(value * 100).toFixed(1)}%`;
+}
+export function renderResultsMd(result) {
+    const rows = result.disagreements.length
+        ? result.disagreements
+            .map((item) => `| ${item.id} | ${item.expected} | ${item.got} | ${item.flavor} |`)
+            .join("\n")
+        : "| _none_ | | | |";
+    return `# POC C — suite triage eval
+
+## Verdict
+
+| Surface | Verdict | Why |
+| --- | --- | --- |
+| Dry-run heuristic stub | **${result.verdict}** | ${result.agreed}/${result.total} (${pct(result.agreement)}) vs ≥80%; unstable ${pct(result.unstableRate)} |
+| Live Jev Choice | **GRAY** | TYPESAFE_API_KEY unset; System One was not scored |
+| Hypothesis as stated (Jev ≥80%) | **GRAY** | Needs a live key run on the same fixtures |
+
+Kill not triggered on the stub: agreement is above chance (${pct(result.chance)}) and naive if-else (${pct(result.naiveAgreement)}); instability is below 30%.
+
+Hypothesis: a Jev Choice among {retry, escalate, ignore, rewrite-locator} agrees with a human-labeled judgment ≥80% on a small fixture set.
+
+| Metric | Value |
+| --- | --- |
+| Cases | ${result.total} |
+| Heuristic agreement | ${result.agreed}/${result.total} (${pct(result.agreement)}) |
+| Naive if-else agreement | ${result.naiveAgreed}/${result.total} (${pct(result.naiveAgreement)}) |
+| Chance (4-way) | ${pct(result.chance)} |
+| Unstable (2 identical runs) | ${result.unstable}/${result.total} (${pct(result.unstableRate)}) |
+| Live Jev | not scored (TYPESAFE_API_KEY unset) |
+
+## Reasons
+
+${result.reasons.map((line) => `- ${line}`).join("\n")}
+
+## Sample disagreements
+
+| ID | Expected | Got | Flavor |
+| --- | --- | --- | --- |
+${rows}
+
+## How to reproduce
+
+\`\`\`bash
+npm run eval:triage
+tocket suite triage --from fixtures/triage/last-run.json --include-low-confidence --dry-run
+\`\`\`
+`;
+}
+function repoRoot() {
+    return join(import.meta.dirname, "..", "..");
+}
+function main() {
+    const root = repoRoot();
+    const lastRunPath = join(root, "fixtures", "triage", "last-run.json");
+    const expectedPath = join(root, "fixtures", "triage-expected.json");
+    const result = evaluateTriage(lastRunPath, expectedPath);
+    const md = renderResultsMd(result);
+    const outPath = join(root, "fixtures", "triage", "results.md");
+    mkdirSync(dirname(outPath), { recursive: true });
+    writeFileSync(outPath, md, "utf-8");
+    console.log(`agreement  ${result.agreed}/${result.total} (${pct(result.agreement)})`);
+    console.log(`naive      ${result.naiveAgreed}/${result.total} (${pct(result.naiveAgreement)})`);
+    console.log(`chance     ${pct(result.chance)}`);
+    console.log(`unstable   ${result.unstable}/${result.total} (${pct(result.unstableRate)})`);
+    console.log(`verdict    ${result.verdict}`);
+    if (result.disagreements.length > 0) {
+        console.log("disagreements:");
+        for (const item of result.disagreements) {
+            console.log(`  ${item.id}: expected ${item.expected}, got ${item.got} (${item.flavor})`);
+        }
+    }
+    console.log(`wrote ${toRepoRelative(root, outPath)}`);
+    if (result.verdict === "FAIL") {
+        process.exitCode = 1;
+    }
+}
+const invoked = process.argv[1]?.includes("triage-eval");
+if (invoked) {
+    main();
+}
+//# sourceMappingURL=triage-eval.js.map

package/dist/eval/triage-eval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triage-eval.js","sourceRoot":"","sources":["../../src/eval/triage-eval.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -14,11 +14,16 @@ import { registerDoctorCommand } from "./commands/doctor.cmd.js";
 import { registerLintCommand } from "./commands/lint.cmd.js";
 import { registerDiffCommand } from "./commands/diff.cmd.js";
 import { registerHandoffCommand } from "./commands/handoff.cmd.js";
+import { registerAgentsMdCommand } from "./commands/agents-md.cmd.js";
+import { registerScaffoldCommand } from "./commands/scaffold.cmd.js";
+import { registerSuiteCommand } from "./commands/suite.cmd.js";
+import { registerDecideCommand } from "./commands/decide.cmd.js";
+import { registerWorkCommand } from "./commands/work.cmd.js";
 const pkg = JSON.parse(readFileSync(join(import.meta.dirname, "..", "package.json"), "utf-8"));
 const program = new Command();
 program
     .name("tocket")
-    .description("The Context Engineering Framework for Multi-Agent Workspaces")
+    .description("Shared project notebook (.context/). decide writes the next move; workers execute.")
     .version(pkg.version);
 registerInitCommand(program);
 registerGenerateCommand(program);
@@ -32,6 +37,11 @@ registerDoctorCommand(program);
 registerLintCommand(program);
 registerDiffCommand(program);
 registerHandoffCommand(program);
+registerAgentsMdCommand(program);
+registerScaffoldCommand(program);
+registerSuiteCommand(program);
+registerDecideCommand(program);
+registerWorkCommand(program);
 // No-args: show interactive dashboard (TTY) or help (non-TTY)
 const args = process.argv.slice(2);
 if (args.length === 0 && process.stdin.isTTY) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAChD,CAAC;AAEzB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,8DAA8D,CAAC;KAC3E,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAExB,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACjC,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACjC,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAEhC,8DAA8D;AAC9D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IAC7C,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;IAClE,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/mcp/index.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { startServer } from "./server.js";
+startServer().catch((error) => {
+    console.error("Failed to start MCP server:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC5B,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Start the MCP server
+ */
+export declare function startServer(): Promise<void>;

package/dist/mcp/server.js

@@ -0,0 +1,360 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { ListToolsRequestSchema, CallToolRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { existsSync, readFileSync, writeFileSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * Context file names that can be read/written
+ */
+const CONTEXT_FILES = [
+    "activeContext.md",
+    "systemPatterns.md",
+    "techContext.md",
+    "productContext.md",
+    "progress.md",
+];
+/**
+ * Validate and normalize context file name
+ */
+function isValidContextFile(file) {
+    return CONTEXT_FILES.includes(file);
+}
+/**
+ * Get absolute path to context directory
+ */
+function getContextDir() {
+    const cwd = process.cwd();
+    return join(cwd, ".context");
+}
+/**
+ * Get absolute path to a context file
+ */
+function getContextFilePath(file) {
+    return join(getContextDir(), file);
+}
+/**
+ * Check if a file exists in the context directory
+ */
+function contextFileExists(file) {
+    return existsSync(getContextFilePath(file));
+}
+/**
+ * Get list of all available context files in the workspace
+ */
+function getAvailableContextFiles() {
+    const contextDir = getContextDir();
+    if (!existsSync(contextDir)) {
+        return [];
+    }
+    return readdirSync(contextDir)
+        .filter((f) => f.endsWith(".md"))
+        .sort();
+}
+/**
+ * Get list of all Tocket-managed files in the workspace
+ */
+function getTocketManagedFiles() {
+    const cwd = process.cwd();
+    const files = [];
+    // Add .context files
+    const contextDir = getContextDir();
+    if (existsSync(contextDir)) {
+        const contextFiles = readdirSync(contextDir);
+        contextFiles.forEach((f) => {
+            files.push(`.context/${f}`);
+        });
+    }
+    // Add TOCKET.md
+    if (existsSync(join(cwd, "TOCKET.md"))) {
+        files.push("TOCKET.md");
+    }
+    // Add agent config files
+    const agentFiles = ["CLAUDE.md", "GEMINI.md", "ARCHITECT.md"];
+    agentFiles.forEach((f) => {
+        if (existsSync(join(cwd, f))) {
+            files.push(f);
+        }
+    });
+    return files.sort();
+}
+/**
+ * Compute workspace status
+ */
+function getWorkspaceStatus() {
+    const cwd = process.cwd();
+    const contextDir = getContextDir();
+    const hasWorkspace = existsSync(contextDir);
+    let currentFocus = "";
+    let stalenessHours = null;
+    if (hasWorkspace && contextFileExists("activeContext.md")) {
+        try {
+            const content = readFileSync(getContextFilePath("activeContext.md"), "utf-8");
+            // Extract current focus from "## Current Focus" section
+            const focusMatch = content.match(/## Current Focus\s*\n+(.+)/);
+            if (focusMatch?.[1]) {
+                const line = focusMatch[1].trim();
+                if (!line.startsWith("_") && !line.includes("No active tasks")) {
+                    currentFocus = line.length > 100 ? line.substring(0, 97) + "..." : line;
+                }
+            }
+            // Compute staleness in hours
+            const stats = statSync(getContextFilePath("activeContext.md"));
+            stalenessHours = Math.floor((Date.now() - stats.mtimeMs) / (1000 * 60 * 60));
+        }
+        catch (e) {
+            // Ignore errors reading activeContext
+        }
+    }
+    // Try to extract project name from package.json
+    let projectName = "unknown";
+    try {
+        const pkgPath = join(cwd, "package.json");
+        if (existsSync(pkgPath)) {
+            const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+            projectName = pkg.name || "unknown";
+        }
+    }
+    catch (e) {
+        // Ignore errors
+    }
+    return {
+        projectName,
+        currentFocus,
+        hasWorkspace,
+        stalenessHours,
+        contextFiles: getAvailableContextFiles(),
+    };
+}
+/**
+ * Start the MCP server
+ */
+export async function startServer() {
+    const server = new Server({
+        name: "tocket-context-server",
+        version: "1.0.0",
+    });
+    /**
+     * List available tools
+     */
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        const tools = [
+            {
+                name: "tocket_read_context",
+                description: "Read the contents of a .context/ file (activeContext, systemPatterns, techContext, productContext, or progress)",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        file: {
+                            type: "string",
+                            enum: CONTEXT_FILES,
+                            description: "The context file to read",
+                        },
+                    },
+                    required: ["file"],
+                },
+            },
+            {
+                name: "tocket_update_context",
+                description: "Update the contents of a .context/ file",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        file: {
+                            type: "string",
+                            enum: CONTEXT_FILES,
+                            description: "The context file to update",
+                        },
+                        content: {
+                            type: "string",
+                            description: "The new content to write to the file",
+                        },
+                    },
+                    required: ["file", "content"],
+                },
+            },
+            {
+                name: "tocket_get_status",
+                description: "Get a summary of the current Tocket workspace (project name, focus, staleness, file list)",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                },
+            },
+            {
+                name: "tocket_read_protocol",
+                description: "Read the full Tocket protocol specification (TOCKET.md)",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                },
+            },
+            {
+                name: "tocket_list_files",
+                description: "List all Tocket-managed files (.context files, TOCKET.md, agent config files)",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                },
+            },
+        ];
+        return { tools };
+    });
+    /**
+     * Handle tool calls
+     */
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const typedArgs = (args ?? {});
+        try {
+            switch (name) {
+                case "tocket_read_context": {
+                    const file = typedArgs.file;
+                    if (!isValidContextFile(file)) {
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: `Invalid context file: ${file}. Valid files are: ${CONTEXT_FILES.join(", ")}`,
+                                },
+                            ],
+                            isError: true,
+                        };
+                    }
+                    if (!contextFileExists(file)) {
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: `Context file not found: ${file}`,
+                                },
+                            ],
+                            isError: true,
+                        };
+                    }
+                    const content = readFileSync(getContextFilePath(file), "utf-8");
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: content,
+                            },
+                        ],
+                    };
+                }
+                case "tocket_update_context": {
+                    const file = typedArgs.file;
+                    const content = typedArgs.content;
+                    if (!isValidContextFile(file)) {
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: `Invalid context file: ${file}. Valid files are: ${CONTEXT_FILES.join(", ")}`,
+                                },
+                            ],
+                            isError: true,
+                        };
+                    }
+                    if (!content || typeof content !== "string") {
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: "Content must be a non-empty string",
+                                },
+                            ],
+                            isError: true,
+                        };
+                    }
+                    const filePath = getContextFilePath(file);
+                    writeFileSync(filePath, content, "utf-8");
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Successfully updated ${file} (${content.length} bytes)`,
+                            },
+                        ],
+                    };
+                }
+                case "tocket_get_status": {
+                    const status = getWorkspaceStatus();
+                    const statusText = `Project: ${status.projectName}
+Has Workspace: ${status.hasWorkspace}
+Current Focus: ${status.currentFocus || "(none)"}
+Staleness: ${status.stalenessHours !== null ? `${status.stalenessHours} hours ago` : "N/A"}
+Context Files: ${status.contextFiles.length > 0 ? status.contextFiles.join(", ") : "none"}`;
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: statusText,
+                            },
+                        ],
+                    };
+                }
+                case "tocket_read_protocol": {
+                    const cwd = process.cwd();
+                    const protocolPath = join(cwd, "TOCKET.md");
+                    if (!existsSync(protocolPath)) {
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: "TOCKET.md protocol file not found in the current directory",
+                                },
+                            ],
+                            isError: true,
+                        };
+                    }
+                    const content = readFileSync(protocolPath, "utf-8");
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: content,
+                            },
+                        ],
+                    };
+                }
+                case "tocket_list_files": {
+                    const files = getTocketManagedFiles();
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: files.length > 0 ? files.join("\n") : "(no Tocket files found)",
+                            },
+                        ],
+                    };
+                }
+                default:
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Unknown tool: ${name}`,
+                            },
+                        ],
+                        isError: true,
+                    };
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${errorMessage}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // Start the server on stdio
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}

package/dist/templates/memory-bank.d.ts

@@ -18,3 +18,14 @@ export declare const techContextMd: (projectName: string, stack?: StackInfo) =>
 export declare const progressMd: (projectName: string) => string;
 export declare const cursorrulesMd: (projectName: string, description: string, architectFile?: string) => string;
 export declare const tocketMd: (projectName: string, executorFile?: string, architectFile?: string) => string;
+/** Shared decide/work/gate rules for AGENTS.md (init template and `tocket agents-md`). */
+export declare function agentsProtocolSection(): string;
+export declare const agentsMd: (projectName: string, description: string, executorName?: string, architectName?: string) => string;
+/** Official portable skill for Cursor / Claude / Codex. Written by `tocket init`. */
+export declare const TOCKET_SKILL_REL = ".agents/skills/tocket/SKILL.md";
+/** Catalog path so `npx skills add pedrocivita/tocket --skill tocket` can discover it. */
+export declare const TOCKET_SKILL_CATALOG_REL = "skills/tocket/SKILL.md";
+export declare const TOCKET_SKILLS_ADD = "npx skills add pedrocivita/tocket --skill tocket";
+export declare const TOCKET_AGENT_PHRASE = "Before expensive tools: tocket decide --dry-run, or read .context/decisions/.";
+export declare function tocketConventionsHint(): string;
+export declare const tocketSkillMd: () => string;