@pedrocivita/tocket 2.4.0 → 2.6.3

package/dist/utils/triage.js.map

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

package/dist/utils/work.d.ts

@@ -0,0 +1,72 @@
+/** Reference worker: read a decide Choice and stamp a notebook receipt. Never calls Jev. */
+import { type DecideMode, type DecideRecord, type DecideSemantics, type QueueDestination, type ToolGate } from "./decide.js";
+export declare const WORK_APPLIED_SCHEMA = "tocket.work.applied/v0";
+export declare class WorkError extends Error {
+    readonly exitCode: 1 | 2;
+    constructor(message: string, exitCode?: 1 | 2);
+}
+export interface WorkAppliedRecord {
+    schema: typeof WORK_APPLIED_SCHEMA;
+    id: string;
+    decision_id: string;
+    decision_path: string;
+    applied_at: string;
+    choice: string | null;
+    destination: QueueDestination;
+    confidence: number;
+    gated: boolean;
+    tool_gate: ToolGate | null;
+    semantics: DecideSemantics;
+    mode: DecideMode;
+    applied_from_shadow: boolean;
+    forced: boolean;
+}
+export interface RunWorkOptions {
+    cwd: string;
+    fromPath?: string;
+    apply?: boolean;
+    force?: boolean;
+    now?: () => string;
+}
+export interface WorkPlan {
+    record: DecideRecord;
+    decisionPath: string;
+    shadow: boolean;
+    toolGate: ToolGate | null;
+    wouldRefuse: boolean;
+}
+export interface RunWorkResult {
+    plan: WorkPlan;
+    applied: boolean;
+    receipt?: WorkAppliedRecord;
+    receiptPath?: string;
+    progressPath?: string;
+    summary: string;
+}
+/**
+ * Shadow / log-only / dry-run records are advice, not silent apply.
+ * `executes: false` is the decide-record invariant (Tocket never executes)
+ * and is not a refuse signal on its own.
+ */
+export declare function isShadowDecision(record: DecideRecord): boolean;
+export declare function isAppliedReceiptName(name: string): boolean;
+export declare function appliedReceiptPath(decisionPath: string): string;
+export declare function findLatestQueueDecision(cwd: string): string | null;
+export declare function loadDecision(cwd: string, fromPath?: string): {
+    record: DecideRecord;
+    path: string;
+};
+export declare function planWork(options: RunWorkOptions): WorkPlan;
+export declare function formatRefuseApply(plan: WorkPlan): string;
+export declare function formatWorkProgressLine(record: DecideRecord): string;
+export declare function formatWorkPlan(plan: WorkPlan, cwd: string): string;
+export declare function formatWorkApplied(receipt: WorkAppliedRecord, receiptPath: string, cwd: string): string;
+export declare function appendWorkProgress(cwd: string, line: string): string;
+export declare function applyWork(options: RunWorkOptions): {
+    plan: WorkPlan;
+    receipt: WorkAppliedRecord;
+    receiptPath: string;
+    progressPath: string;
+};
+/** Plan by default. `--apply` stamps a receipt. Never calls TypeSafe / Jev. */
+export declare function runWork(options: RunWorkOptions): RunWorkResult;

package/dist/utils/work.js

@@ -0,0 +1,225 @@
+/** Reference worker: read a decide Choice and stamp a notebook receipt. Never calls Jev. */
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { isAbsolute, resolve } from "node:path";
+import { DECISIONS_DIR, DecideError, QUEUE_DESTINATIONS, isInsideContext, parseDecideRecord, prettyDecideJson, resolveRecordToolGate, toRepoRelative, toolGateRefusesApply, } from "./decide.js";
+export const WORK_APPLIED_SCHEMA = "tocket.work.applied/v0";
+export class WorkError extends Error {
+    exitCode;
+    constructor(message, exitCode = 1) {
+        super(message);
+        this.name = "WorkError";
+        this.exitCode = exitCode;
+    }
+}
+/**
+ * Shadow / log-only / dry-run records are advice, not silent apply.
+ * `executes: false` is the decide-record invariant (Tocket never executes)
+ * and is not a refuse signal on its own.
+ */
+export function isShadowDecision(record) {
+    return (record.semantics === "log-only" ||
+        record.mode === "shadow" ||
+        record.mode === "dry-run" ||
+        record.status === "logged");
+}
+export function isAppliedReceiptName(name) {
+    return name.endsWith(".applied.json");
+}
+export function appliedReceiptPath(decisionPath) {
+    if (isAppliedReceiptName(decisionPath)) {
+        throw new WorkError("Refusing to apply a receipt file. Pass the decision JSON.", 1);
+    }
+    if (!decisionPath.endsWith(".json")) {
+        throw new WorkError("Decision path must be a .json file.", 1);
+    }
+    return decisionPath.replace(/\.json$/, ".applied.json");
+}
+export function findLatestQueueDecision(cwd) {
+    const files = [];
+    for (const destination of QUEUE_DESTINATIONS) {
+        const dir = resolve(cwd, DECISIONS_DIR, destination);
+        if (!existsSync(dir))
+            continue;
+        for (const name of readdirSync(dir)) {
+            if (!name.endsWith(".json") || isAppliedReceiptName(name))
+                continue;
+            const full = resolve(dir, name);
+            if (!isInsideContext(cwd, full))
+                continue;
+            files.push({ path: full, mtimeMs: statSync(full).mtimeMs, name });
+        }
+    }
+    if (files.length === 0)
+        return null;
+    files.sort((a, b) => {
+        if (b.mtimeMs !== a.mtimeMs)
+            return b.mtimeMs - a.mtimeMs;
+        return b.name.localeCompare(a.name);
+    });
+    return files[0].path;
+}
+function resolveDecisionPath(cwd, fromPath) {
+    if (fromPath) {
+        return isAbsolute(fromPath) ? fromPath : resolve(cwd, fromPath);
+    }
+    const latest = findLatestQueueDecision(cwd);
+    if (!latest) {
+        throw new WorkError("No decision found. Pass --from <decision.json> or run tocket decide first.", 1);
+    }
+    return latest;
+}
+export function loadDecision(cwd, fromPath) {
+    const path = resolveDecisionPath(cwd, fromPath);
+    if (!existsSync(path)) {
+        throw new WorkError(`Decision file not found: ${path}`, 1);
+    }
+    let raw;
+    try {
+        raw = readFileSync(path, "utf-8");
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new WorkError(`Cannot read decision file: ${message}`, 1);
+    }
+    try {
+        return { record: parseDecideRecord(raw), path };
+    }
+    catch (err) {
+        if (err instanceof DecideError) {
+            throw new WorkError(err.message, 1);
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        throw new WorkError(`Invalid decision JSON: ${message}`, 1);
+    }
+}
+export function planWork(options) {
+    const { record, path } = loadDecision(options.cwd, options.fromPath);
+    const shadow = isShadowDecision(record);
+    const toolGate = resolveRecordToolGate(record);
+    const gateRefuse = toolGateRefusesApply(toolGate);
+    return {
+        record,
+        decisionPath: path,
+        shadow,
+        toolGate,
+        wouldRefuse: (shadow || gateRefuse) && options.force !== true,
+    };
+}
+export function formatRefuseApply(plan) {
+    const gateRefuse = toolGateRefusesApply(plan.toolGate);
+    if (!gateRefuse && plan.shadow) {
+        return "Refuse apply: shadow/log-only decision. Dry-run is always OK. Pass --force to stamp applied_from_shadow.";
+    }
+    if (plan.toolGate === "block") {
+        const shadow = plan.shadow ? " Shadow/log-only decision." : "";
+        return `Refuse apply: tool_gate=block.${shadow} Dry-run is always OK. Pass --force to override the gate.`;
+    }
+    if (plan.toolGate === "ask") {
+        const shadow = plan.shadow ? " Shadow/log-only decision." : "";
+        return `Refuse apply: tool_gate=ask. Escalate to a human before irreversible tools.${shadow} Dry-run is always OK. Pass --force to override the gate.`;
+    }
+    return "Refuse apply: decision is not applyable. Dry-run is always OK. Pass --force to override.";
+}
+export function formatWorkProgressLine(record) {
+    const choice = record.choice ?? record.narrow ?? record.id;
+    const gate = record.gated ? " gated" : "";
+    const toolGate = record.tool_gate ? ` tool_gate=${record.tool_gate}` : "";
+    return `- worker applied: next=${choice} dest=${record.destination} confidence=${record.confidence.toFixed(2)}${gate}${toolGate}`;
+}
+function formatApplyHint(plan) {
+    if (!plan.wouldRefuse) {
+        return "apply=ok  (pass --apply to write receipt)";
+    }
+    if (plan.toolGate === "block") {
+        return "apply=refuse  (tool_gate=block; pass --apply --force to override)";
+    }
+    if (plan.toolGate === "ask") {
+        return "apply=refuse  (tool_gate=ask; escalate/human; pass --apply --force to override)";
+    }
+    return "apply=refuse  (shadow/log-only; pass --apply --force to stamp applied_from_shadow)";
+}
+export function formatWorkPlan(plan, cwd) {
+    const { record } = plan;
+    const gate = record.gated ? "gated" : "route";
+    const from = toRepoRelative(cwd, plan.decisionPath);
+    const toolGate = plan.toolGate ?? "none";
+    return [
+        `work plan  choice=${record.choice ?? "null"}  dest=${record.destination}  confidence=${record.confidence.toFixed(2)}  ${gate}  tool_gate=${toolGate}  semantics=${record.semantics}  mode=${record.mode}`,
+        `  from=${from}`,
+        `  next=${record.choice ?? record.narrow ?? record.id}`,
+        `  ${formatApplyHint(plan)}`,
+    ].join("\n");
+}
+export function formatWorkApplied(receipt, receiptPath, cwd) {
+    const rel = toRepoRelative(cwd, receiptPath);
+    const shadow = receipt.applied_from_shadow ? "  applied_from_shadow" : "";
+    return `work applied  choice=${receipt.choice ?? "null"}  dest=${receipt.destination}  confidence=${receipt.confidence.toFixed(2)}  ${rel}${shadow}`;
+}
+export function appendWorkProgress(cwd, line) {
+    const contextDir = resolve(cwd, ".context");
+    const progressPath = resolve(contextDir, "progress.md");
+    if (!isInsideContext(cwd, progressPath)) {
+        throw new WorkError("work writes only under .context/", 1);
+    }
+    mkdirSync(contextDir, { recursive: true });
+    if (!existsSync(progressPath)) {
+        writeFileSync(progressPath, `# Progress Log\n\n${line}\n`, "utf-8");
+        return progressPath;
+    }
+    const current = readFileSync(progressPath, "utf-8");
+    const suffix = current.endsWith("\n") ? `${line}\n` : `\n${line}\n`;
+    writeFileSync(progressPath, current + suffix, "utf-8");
+    return progressPath;
+}
+export function applyWork(options) {
+    const plan = planWork(options);
+    if (plan.wouldRefuse) {
+        throw new WorkError(formatRefuseApply(plan), 2);
+    }
+    const receiptPath = appliedReceiptPath(plan.decisionPath);
+    const contextRoot = resolve(options.cwd, ".context");
+    if (plan.decisionPath.startsWith(contextRoot) && !isInsideContext(options.cwd, receiptPath)) {
+        throw new WorkError("work writes only under .context/", 1);
+    }
+    const appliedAt = options.now ? options.now() : new Date().toISOString();
+    const receipt = {
+        schema: WORK_APPLIED_SCHEMA,
+        id: plan.record.id,
+        decision_id: plan.record.id,
+        decision_path: toRepoRelative(options.cwd, plan.decisionPath),
+        applied_at: appliedAt,
+        choice: plan.record.choice,
+        destination: plan.record.destination,
+        confidence: plan.record.confidence,
+        gated: plan.record.gated,
+        tool_gate: plan.toolGate,
+        semantics: plan.record.semantics,
+        mode: plan.record.mode,
+        applied_from_shadow: plan.shadow,
+        forced: options.force === true,
+    };
+    writeFileSync(receiptPath, prettyDecideJson(receipt), "utf-8");
+    const progressPath = appendWorkProgress(options.cwd, formatWorkProgressLine(plan.record));
+    return { plan, receipt, receiptPath, progressPath };
+}
+/** Plan by default. `--apply` stamps a receipt. Never calls TypeSafe / Jev. */
+export function runWork(options) {
+    if (options.apply === true) {
+        const { plan, receipt, receiptPath, progressPath } = applyWork(options);
+        return {
+            plan,
+            applied: true,
+            receipt,
+            receiptPath,
+            progressPath,
+            summary: formatWorkApplied(receipt, receiptPath, options.cwd),
+        };
+    }
+    const plan = planWork(options);
+    return {
+        plan,
+        applied: false,
+        summary: formatWorkPlan(plan, options.cwd),
+    };
+}
+//# sourceMappingURL=work.js.map

package/dist/utils/work.js.map

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

package/dist/utils/xml.d.ts

@@ -0,0 +1,22 @@
+/** Lightweight parser for Tocket payload XML (self-generated, deterministic structure). */
+export interface ParsedTask {
+    id: string;
+    type: string;
+    target: string;
+    action: string;
+    spec: string;
+    done: string;
+}
+export interface ParsedPayload {
+    version: string;
+    meta: {
+        intent: string;
+        scope: string;
+        skills: string;
+        priority: string;
+    };
+    tasks: ParsedTask[];
+    checks: string[];
+}
+/** Parse a Tocket payload XML string into structured data. */
+export declare function parsePayloadXml(xml: string): ParsedPayload;

package/dist/utils/xml.js

@@ -0,0 +1,54 @@
+/** Lightweight parser for Tocket payload XML (self-generated, deterministic structure). */
+/** Strip XML comment placeholders like <!-- ... --> and trim. */
+function clean(value) {
+    if (!value)
+        return "";
+    return value.replace(/<!--[\s\S]*?-->/g, "").trim();
+}
+/** Extract text content of a single XML tag from a block. */
+function extractTag(block, tag) {
+    const re = new RegExp(`<${tag}>([\\s\\S]*?)</${tag}>`);
+    const match = block.match(re);
+    return clean(match?.[1]);
+}
+/** Parse a Tocket payload XML string into structured data. */
+export function parsePayloadXml(xml) {
+    // Version
+    const versionMatch = xml.match(/<payload\s+version="([^"]+)">/);
+    const version = versionMatch?.[1] ?? "";
+    // Meta
+    const metaMatch = xml.match(/<meta>([\s\S]*?)<\/meta>/);
+    const metaBlock = metaMatch?.[1] ?? "";
+    const meta = {
+        intent: extractTag(metaBlock, "intent"),
+        scope: extractTag(metaBlock, "scope"),
+        skills: extractTag(metaBlock, "skills"),
+        priority: extractTag(metaBlock, "priority"),
+    };
+    // Tasks
+    const tasks = [];
+    const taskRegex = /<task\s+id="([^"]*)"(?:\s+type="([^"]*)")?(?:\s+skill="[^"]*")?>([\s\S]*?)<\/task>/g;
+    let taskMatch;
+    while ((taskMatch = taskRegex.exec(xml)) !== null) {
+        const [, id, type, body] = taskMatch;
+        tasks.push({
+            id: id ?? "",
+            type: clean(type),
+            target: extractTag(body, "target"),
+            action: extractTag(body, "action"),
+            spec: extractTag(body, "spec"),
+            done: extractTag(body, "done"),
+        });
+    }
+    // Validation checks
+    const checks = [];
+    const checkRegex = /<check>([\s\S]*?)<\/check>/g;
+    let checkMatch;
+    while ((checkMatch = checkRegex.exec(xml)) !== null) {
+        const value = clean(checkMatch[1]);
+        if (value)
+            checks.push(value);
+    }
+    return { version, meta, tasks, checks };
+}
+//# sourceMappingURL=xml.js.map

package/dist/utils/xml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.js","sourceRoot":"","sources":["../../src/utils/xml.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAuB3F,iEAAiE;AACjE,SAAS,KAAK,CAAC,KAAyB;IACtC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,KAAK,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACtD,CAAC;AAED,6DAA6D;AAC7D,SAAS,UAAU,CAAC,KAAa,EAAE,GAAW;IAC5C,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,IAAI,GAAG,kBAAkB,GAAG,GAAG,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3B,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,UAAU;IACV,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAExC,OAAO;IACP,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEvC,MAAM,IAAI,GAAG;QACX,MAAM,EAAE,UAAU,CAAC,SAAS,EAAE,QAAQ,CAAC;QACvC,KAAK,EAAE,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC;QACrC,MAAM,EAAE,UAAU,CAAC,SAAS,EAAE,QAAQ,CAAC;QACvC,QAAQ,EAAE,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC;KAC5C,CAAC;IAEF,QAAQ;IACR,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,MAAM,SAAS,GAAG,qFAAqF,CAAC;IACxG,IAAI,SAAiC,CAAC;IACtC,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAClD,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,SAAS,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,EAAE,IAAI,EAAE;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC;YACjB,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC;YAClC,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC;YAClC,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC;YAC9B,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC;SAC/B,CAAC,CAAC;IACL,CAAC;IAED,oBAAoB;IACpB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,UAAU,GAAG,6BAA6B,CAAC;IACjD,IAAI,UAAkC,CAAC;IACvC,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,KAAK;YAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC1C,CAAC"}

package/package.json

@@ -1,50 +1,53 @@
-{
-  "name": "@pedrocivita/tocket",
-  "version": "2.4.0",
-  "description": "The Context Engineering Framework for Multi-Agent Workspaces",
-  "type": "module",
-  "main": "dist/index.js",
-  "bin": {
-    "tocket": "dist/index.js"
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "start": "node dist/index.js",
-    "prepublishOnly": "npm run build",
-    "test": "npm run build && node --test dist/tests/*.test.js",
-    "test:coverage": "npm run build && c8 node --test dist/tests/*.test.js"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/pedrocivita/tocket.git"
-  },
-  "keywords": [
-    "context-engineering",
-    "multi-agent",
-    "cli"
-  ],
-  "author": "Pedro Civita",
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/pedrocivita/tocket/issues"
-  },
-  "homepage": "https://tocket.ai",
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org/",
-    "access": "public"
-  },
-  "dependencies": {
-    "@inquirer/prompts": "^8.3.0",
-    "chalk": "^5.6.2",
-    "clipboardy": "^5.3.0",
-    "commander": "^14.0.3"
-  },
-  "devDependencies": {
-    "@types/node": "^25.3.0",
-    "c8": "^11.0.0",
-    "typescript": "^5.9.3"
-  }
-}
+{
+  "name": "@pedrocivita/tocket",
+  "version": "2.6.3",
+  "description": "Project notebook for multi-agent workspaces. Agents work. Tocket remembers. Jev only chooses the next step.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "tocket": "dist/index.js",
+    "tocket-mcp": "dist/mcp/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build",
+    "test": "npm run build && node --test dist/tests/*.test.js",
+    "test:coverage": "npm run build && c8 node --test dist/tests/*.test.js",
+    "eval:triage": "npm run build && node dist/eval/triage-eval.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pedrocivita/tocket.git"
+  },
+  "keywords": [
+    "context-engineering",
+    "multi-agent",
+    "cli"
+  ],
+  "author": "Pedro Civita",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/pedrocivita/tocket/issues"
+  },
+  "homepage": "https://tocket.ai",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.3.0",
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "chalk": "^5.6.2",
+    "clipboardy": "^5.3.0",
+    "commander": "^14.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "c8": "^11.0.0",
+    "typescript": "^5.9.3"
+  }
+}