@pedrocivita/tocket 2.4.0 → 2.6.3

package/README.md

@@ -5,32 +5,82 @@
 
 # Tocket
 
-**The Context Engineering Framework for Multi-Agent Workspaces**
+Tocket is the **project notebook**: folders/files many AI agents read and write together. It is not a chat and does not do the work alone.
 
-AI agents forget everything between sessions. When multiple agents work on the same codebase, they re-read files, duplicate work, and make conflicting decisions. Tocket fixes this with **shared context files that any agent can read** — no vendor lock-in, no special integrations.
+Jev (and similar) only **picks among options** and **saves that choice in the notebook**. Cursor/Claude/GrokBot/CI still do the work.
+
+**Agents work · Tocket remembers · Jev only chooses the next step.**
+
+Tocket é o caderno do projeto: pastas e arquivos que vários agentes leem e escrevem juntos. Não é um chat e não faz o trabalho sozinho. O Jev só escolhe entre opções e grava essa escolha no caderno.
+
+## Harness your context
+
+Tocket is a file-first harness, not a LangChain runtime. The AutoMode *pattern* (judge before irreversible tools) lives in `.context/decisions/` JSON, not in middleware. Jev is the judge, not the writer. Before bash, deploy, or browser, `tocket decide` records `tool_gate: allow|block|ask`; `tocket work --apply` honors that gate. No new runtime deps.
+
+The Context Engineering Framework for Multi-Agent Workspaces. Agents forget everything between sessions. Tocket keeps shared context in files any agent can read: no vendor lock-in, no special integrations.
 
 <p align="center">
   <img src="docs/assets/tocket-dashboard.png" alt="Tocket CLI Dashboard" width="700" />
 </p>
 
+## What's new in 2.6.3
+
+- Windows test/path fixes: skill/template equality ignores CRLF vs LF; CLI `from=` and other `toRepoRelative` display paths use posix `/` on every OS. 2.6.2 never published successfully.
+
+## What's new in 2.6.2
+
+- Tool-risk gate: `tocket decide --choice tool_gate:allow,block,ask` records allow|block|ask. `tocket work --apply` refuses `block`/`ask` (exit 2) unless `--force`. Shadow apply still needs `--force`.
+- Installer docs + auto-config: `AGENTS.md`, fuller README how-it-works, skill rules, `tocket init` writes `AGENTS.md` and the matching agent file (detect or ask once).
+
+## What's new in 2.6.1
+
+- `tocket work`: first-party reference worker. Reads a Choice from `.context/decisions/` and prints a plan (default) or `--apply` a notebook receipt. Never calls Jev. Shadow / log-only apply requires `--force`.
+
+See [CHANGELOG.md](CHANGELOG.md).
+
+## What's new in 2.6.0
+
+- `tocket decide`: cheap typed Choice into `.context/decisions/`
+- Light `tocket doctor`: notebook checks (`.context/`, skill, key yes/no, last decision)
+- Official skill: `npx skills add pedrocivita/tocket --skill tocket`
+
+## What you get
+
+| Piece | Role |
+| --- | --- |
+| `tocket decide` | Writes the next move as JSON under `.context/decisions/`. Does not run workers. |
+| `tocket work` | Reads that Choice and plans (default) or `--apply` a notebook receipt. Honors `tool_gate`. Does not call Jev. |
+| `tocket doctor` | Green/yellow/red checks for the notebook, skill file, and `TYPESAFE_API_KEY` yes/no. |
+| `tocket suite loop` | Copies AppMap + last-run into `.context/appmaps/` and triages. Suite-specific. |
+| Official skill | One-shot install. Phrase: before expensive tools, `tocket decide --dry-run` or read `.context/decisions/`. |
+
+## What Tocket is not
+
+- **Not a chatbot.** Context lives in files, not in a conversation.
+- **Not a computer-use runtime.** It does not drive a browser or click the OS.
+- **Not codegen.** It does not write application code. Workers (Cursor, Claude, GrokBot, CI) do.
+
 ## The idea in 30 seconds
 
 Tocket is a file convention. It adds a `.context/` directory to your repo with markdown files that describe your project's current state, architecture, and progress. Any AI agent that can read files — Claude, Gemini, GPT, Cursor, Copilot — can pick up where the last session left off.
 
 ```
 your-project/
+  AGENTS.md               # Start here (any agent: Cursor, Claude, Gemini, Copilot, …)
   .context/
     activeContext.md      # What's happening right now
     systemPatterns.md     # How the codebase is organized
     techContext.md        # Stack and build tools
     productContext.md     # What the product is and why
     progress.md           # What's done, what's next
+    decisions/            # decide JSON + work receipts
   TOCKET.md               # Protocol rules (agent-agnostic)
-  CLAUDE.md               # Executor instructions (auto-detected per agent)
-  GEMINI.md               # Architect instructions (auto-detected per agent)
+  CLAUDE.md / .cursorrules / …  # Executor file (init detects or asks once)
+  GEMINI.md               # Architect instructions
+  .agents/skills/tocket/SKILL.md
 ```
 
-All files are plain markdown, committed to git, and readable by any tool.
+All files are plain markdown, committed to git, and readable by any tool. `npx @pedrocivita/tocket init` writes them so the preferred agent is wired without copy-paste.
 
 ## You don't need the CLI
 
@@ -42,23 +92,33 @@ The protocol is just files. You can adopt it manually:
 
 The CLI automates the scaffolding, provides smart defaults, and adds quality-of-life tooling around the protocol.
 
-## Quick Start
+## Quick Start (5 minutes)
 
 ```bash
-# Scaffold a new workspace
+# 1. Self-configuring notebook (detects or asks once for Cursor / Claude / …)
 npx @pedrocivita/tocket init
+#    npx @pedrocivita/tocket init --executor Cursor --architect Gemini --force
+#    or: npx @pedrocivita/tocket init --minimal
+
+# 2. Conventions check (notebook, AGENTS.md, skill, key yes/no)
+tocket doctor
 
-# Or just the essentials (3 files)
-npx @pedrocivita/tocket init --minimal
+# 3. Next move (no API key: stub). Jev is the judge, not the writer.
+tocket decide --dry-run --state '{"goal":"docs"}' --choice next:research,write,review
 
-# Configure your agents (optional — defaults to Claude Code + Gemini)
-npx @pedrocivita/tocket config --architect "Gemini" --executor "Claude Code"
+# 4. Agents read the choice (do not re-ask Jev if this file exists)
+#    .context/decisions/<research|write|review>/*.json
 
-# Or open the interactive dashboard
-npx @pedrocivita/tocket
+# 5. Staging: dry-run plan, then apply a notebook receipt
+tocket work --from .context/decisions/review/<file>.json
+tocket work --from .context/decisions/review/<file>.json --apply
 ```
 
-That's it. Your repo now has a Memory Bank. Every AI session starts by reading `.context/activeContext.md`.
+Optional one-shot skill: `npx skills add pedrocivita/tocket --skill tocket`.
+
+Optional live Jev: `export TYPESAFE_API_KEY=…` (never print the value). Without it, decide stays on the stub.
+
+Workers execute the chosen move. Tocket only writes the notebook. Every AI session starts at `AGENTS.md`, then `.context/activeContext.md`.
 
 ### Safe testing — use a branch
 
@@ -85,14 +145,23 @@ See the [Developer Guide](docs/DEVELOPERS_GUIDE.md) for detailed safe-testing wo
 | --- | --- |
 | `tocket` | Interactive dashboard with guided menu |
 | `tocket init` | Scaffold `.context/`, `TOCKET.md`, and agent configs (auto-detects stack + agents) |
-| `tocket generate` | Build structured payload XML (auto-fills scope from git) |
+| `tocket generate` | Build structured payload XML (auto-fills scope from git, saves to `.tocket/`) |
+| `tocket diff` | Compare payload targets against actual git changes (verify executor compliance) |
 | `tocket sync` | Append session summary + git log to `.context/progress.md` |
+| `tocket handoff` | Generate clipboard-ready context summary for a new agent conversation |
 | `tocket validate` | Check if the workspace has a valid Memory Bank |
 | `tocket focus` | Update the Current Focus in `activeContext.md` |
 | `tocket status` | Quick overview: workspace health, branch, focus, agents |
-| `tocket doctor` | Deep workspace diagnostics (content health, git tracking, staleness) |
+| `tocket doctor` | Light notebook checks (`.context/`, decisions, key yes/no, last decision) plus diagnostics |
 | `tocket lint` | Audit `.context/` content quality and suggest improvements |
 | `tocket config` | Manage global settings: agent roles, author, priority (`~/.tocketrc.json`) |
+| `tocket suite status` | Print last AppMap run from `.context/appmaps/last-run.json` (exit 1 if failed, 2 if missing) |
+| `tocket suite sync --from <path.json>` | Validate and copy a last-run.json into `.context/appmaps/`, regenerate `last-run.md` |
+| `tocket suite init` | Scaffold empty `.context/appmaps/` index templates |
+| `tocket suite triage` | Triage failed goals (Jev Choice, or heuristic stub without `TYPESAFE_API_KEY`) |
+| `tocket suite loop` | Copy mapper AppMap + optional last-run into `.context/appmaps/` and triage |
+| `tocket decide` | State + Choice handoff into `.context/decisions/` (Codila-style queues; does not run workers) |
+| `tocket work` | Read a decision and print a plan (default) or `--apply` a notebook receipt. Never calls Jev. |
 | `tocket eject` | Remove all Tocket files (with confirmation) |
 
 ### CI-friendly flags
@@ -109,10 +178,133 @@ tocket sync --summary "Fixed auth bug and added tests"
 # Generate to stdout or file instead of clipboard
 tocket generate --to stdout
 tocket generate --to payload.xml
+
+# Verify executor followed the payload
+tocket diff
+tocket diff --json
+
+# Handoff context to a new session
+tocket handoff --to stdout
+
+# AppMap last-run (file-first; does not execute maps)
+tocket suite status
+tocket suite sync --from path/to/last-run.json
+tocket suite init
+tocket suite triage --from path/to/last-run.json --dry-run
+tocket suite loop --app tempestivita --map out/tempestivita.appmap.json --last-run last-run.json --dry-run
+
+# Generic decision (Choice + optional Noul/Score). File handoff only.
+tocket decide --state '{"goal":"docs"}' --choice next:research,write,review --dry-run
+tocket decide --from path/to/state.json --noul needs_human_review --score relevance --shadow
+tocket decide --from path/to/state.json --choice next:research,write,review --fork action --confidence-threshold 0.85
+
+# Tool-risk gate (Jev judges; workers execute; Tocket does not run tools)
+tocket decide --from path/to/state.json --choice tool_gate:allow,block,ask --shadow
+tocket work --from path/to/decision.json
+tocket work --from path/to/decision.json --apply
+
+# Reference worker (no Jev). Default is plan/dry-run.
+tocket work --from path/to/decision.json
+tocket work --apply
+tocket work --from path/to/decision.json --apply
+tocket work --from path/to/shadow.json --apply --force
+```
+
+### Tempestivita loop (Oficina)
+
+Three steps. Mapper is a sibling tool ([pedrocivita/appmap-mapper](https://github.com/pedrocivita/appmap-mapper)); Tocket does not vendor it.
+
+```bash
+# 1. Mapper — emit out/tempestivita.appmap.json (and optional smoke)
+cd ../appmap-mapper
+npx tsx src/cli.ts all --url https://tempestivita.civita.dev --smoke
+
+# 2. Close the Memory Bank (map + last-run + triage stay under .context/)
+cd ../tocket
+tocket suite loop --app tempestivita \
+  --mapper-out ../appmap-mapper/out \
+  --last-run path/to/last-run.json \
+  --dry-run
+
+# 3. Read what loop wrote
+tocket suite status
 ```
 
+`--mapper-out` discovers `*.appmap.json` (prefers `<app>.appmap.json`). `--dry-run` uses the heuristic stub when `TYPESAFE_API_KEY` is missing. `--no-triage` copies files only.
+
+### `tocket decide` (Codila-style file handoff)
+
+`tocket decide` is Tocket's file-handoff cousin of [Codila's `chief.py` queues](https://x.com/0xCodila/status/2100984487802708306) (DataChaz 10-step summary). LLMs create, agents act, Jev decides the next move. The CLI writes a JSON that agents or other CLIs consume later.
+
+```
+State → Questions (batched) → Action (this file) → Verify (the consumer)
+```
+
+- Payload includes `choice`, `confidence`, `destination`, `state`, `fork`, and `executes: false`.
+- Primitives: Choice + Noul now; `--score name` or `--score name:min,max` is optional. All flags batch into one System One request.
+- Research/write route only when confidence >= 0.85 (override with `--confidence-threshold`). Below that, `destination` is `review` and `gated` is true.
+- `--fork agent|model|tool|action|human` (default `action`). `--fork human` always reviews. `--fork model` is the existing cheap model-router hook (no extra UX in this release).
+- `--choice tool_gate:allow,block,ask` (or `action_gate`) records a tool-risk gate. `tocket work --apply` refuses `block` and `ask` unless `--force`.
+- `--dry-run` or no `TYPESAFE_API_KEY`: deterministic stub. With a key: live Jev. `--shadow`: live call, `semantics: log-only`.
+- `tocket suite triage` is suite-specific (last-run failures). Suite loop still calls triage, not decide.
+
+#### Boundaries (do / do not)
+
+1. **Jev decides the next move.** LLMs create. Agents act. This command is the decision node.
+2. **Primitives are Choice, Score, Noul.** Start with Choice + Noul. Score is optional. Do not send prose generation to Jev.
+3. **Swap the decision node.** Do not rebuild the agent graph around Jev.
+4. **Shared state + parallel questions + risk threshold + file queue.** Writes stay under `.context/decisions/<research|write|review>/`.
+5. **Batch questions in one request.** Repeat `--choice` / `--noul` / `--score`; they share one System One call.
+6. **Bounded forks only:** agent, model, tool, action, or human escalate. Not an open-ended graph.
+7. **Whole-loop benchmark is out of scope** for this command (do that later, separately).
+8. **Rank wide / read narrow.** Choice may list many options; the handoff stores the single `narrow` route (not every option).
+9. **Reuse the loop:** State → Questions → Action (file) → Verify (consumer). `tocket work` is the reference consumer.
+10. **Keep Jev out of math, writing, and irreversible execution.** This CLI writes a file. It does not compute, draft, publish, or apply.
+
+`executes` is always `false`. Workers (or humans) read the JSON. Tocket does not run them.
+
+### `tocket work` (reference worker)
+
+`tocket decide` writes. `tocket work` is the first-party consumer: it reads a Choice and acts on the notebook only. It does not call Jev, open a browser, or edit application code.
+
+Default is a dry-run plan (choice, destination, confidence, gated, tool_gate). `--apply` writes `<id>.applied.json` next to the decision and a `worker applied: next=…` line into `.context/progress.md`. Shadow / `semantics: log-only` decisions refuse `--apply` with exit 2 unless `--force` (receipt then has `applied_from_shadow: true`). A `tool_gate` of `block` or `ask` also refuses `--apply` (exit 2; `ask` tells you to escalate to a human) unless `--force`. Missing or invalid JSON exits 1.
+
+A later `--backend laya` (local Apple Silicon) is not implemented. Today: stub, or live Jev with `TYPESAFE_API_KEY`.
+
+What lands in `.context/appmaps/`:
+
+| File | Source |
+| --- | --- |
+| `tempestivita.appmap.json` | Mapper (or `--map`) copy |
+| `last-run.json` / `last-run.md` | `--last-run` via the same v0 schema as `suite sync` |
+| `tempestivita.triage.json` | Failed + low-confidence goals (unless `--no-triage`) |
+
+Thin wrapper: `scripts/tempestivita-loop.sh` (sets `--app tempestivita` and `--mapper-out`).
+
 ## How it works
 
+Installers (`npm i` / `npx`) get ready context in the package. Any agent that can read files is productive after `init` + `doctor` + the skill phrase.
+
+```
+init (detect agent, write AGENTS.md + instruction files)
+  → doctor (notebook green/yellow/red; TYPESAFE_API_KEY yes/no)
+  → decide (Jev or stub writes .context/decisions/)
+  → work          dry-run plan (never calls Jev)
+  → work --apply  notebook receipt if tool_gate allows
+```
+
+| Piece | Role |
+| --- | --- |
+| `.context/` | Shared notebook. Read before acting. Update after work. |
+| `AGENTS.md` | Single source agents read first. Decide vs work, never re-ask Jev, honor `tool_gate`. |
+| `tocket decide` | Judge. Writes allow/block/ask or the next move. Does not run tools. |
+| `tocket work` | Staging: plan by default, `--apply` stamps a receipt. Honors `tool_gate`. |
+| `tool_gate` | `allow` proceeds. `block` stops. `ask` escalates to a human. `--force` overrides. |
+| `--fork model` | Cheap model-router hook (bounded forks: agent, model, tool, action, human). |
+| Shadow-first | `--dry-run` / `--shadow` is log-only. Shadow apply still needs `--force`. |
+| `tocket doctor` | Checks `.context/`, `AGENTS.md`, skill, last decision, key yes/no. |
+| Skill | `npx skills add pedrocivita/tocket --skill tocket`. Same rules as `AGENTS.md`. |
+
 ### Memory Bank
 
 The `.context/` directory is the project's shared memory. Agents read it before acting and update it after completing work. Context lives in files, not in chat history.
@@ -124,6 +316,9 @@ The `.context/` directory is the project's shared memory. Agents read it before
 | `techContext.md` | Stack, build tools, critical rules | When stack changes |
 | `productContext.md` | What the product is and why | Rarely |
 | `progress.md` | Milestones and completed work | Per milestone |
+| `appmaps/` | Optional AppMap index + map copy + last-run + triage | `tocket suite loop` / `sync` |
+| `decisions/` | Choice/Noul handoff queues (`research/`, `write/`, `review/`) plus `*.applied.json` receipts | `tocket decide` / `tocket work` |
+| `AGENTS.md` (repo root) | Agent-first rules: decide vs work, `tool_gate`, do not re-ask Jev | `tocket init` / `tocket agents-md` |
 
 ### Triangulation
 
@@ -139,10 +334,25 @@ Architect (any planning AI)         Executor (any coding AI)
      |                                   |  4. Reads .context/ + payload
      |                                   |  5. Implements tasks
      |                                   |  6. Updates .context/
-     |<-------- status report -----------|
+     |<-------- tocket diff report ------|
 ```
 
-The Architect doesn't write code. The Executor doesn't make architecture decisions. The payload XML is the contract between them. For simple tasks, a single agent can fill both roles.
+The Architect doesn't write code. The Executor doesn't make architecture decisions. The payload XML is the contract between them. After execution, `tocket diff` verifies compliance — did the Executor touch the right files? Are done criteria met? For simple tasks, a single agent can fill both roles.
+
+### Closing the loop
+
+```bash
+# After the Executor finishes work:
+tocket diff                    # compare payload targets vs actual git changes
+tocket diff --json             # machine-readable output
+tocket diff --since HEAD~3     # diff against a specific ref
+
+# Starting a new session (next day, new chat):
+tocket handoff                 # copies context summary to clipboard
+tocket handoff --to stdout     # print instead
+tocket handoff --commits 10    # include more history
+tocket handoff --since 1d      # files modified in last day
+```
 
 ## Who is this for?
 
@@ -204,6 +414,7 @@ Don't see your agent? It still works — unknown agents get generic files, and y
 | [Getting Started](docs/GETTING_STARTED.md) | Set up your first Tocket workspace in 5 minutes |
 | [Developer Guide](docs/DEVELOPERS_GUIDE.md) | How to run the Tocket protocol safely in any project |
 | [Tocket Rules](docs/TOCKET_RULES.md) | Complete reference for all protocol rules |
+| [AGENTS.md](AGENTS.md) | What agents read first (decide vs work, tool_gate) |
 | [Protocol Spec](TOCKET.md) | The agent-agnostic protocol specification |
 | [Walkthrough](examples/walkthrough.md) | End-to-end payload exchange example |
 

package/dist/commands/agents-md.cmd.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerAgentsMdCommand(program: Command): void;

package/dist/commands/agents-md.cmd.js

@@ -0,0 +1,166 @@
+import { existsSync, readFileSync, watch } from "node:fs";
+import { writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { success, error as themeError, heading, info, dim } from "../utils/theme.js";
+import { agentsProtocolSection } from "../templates/memory-bank.js";
+function readContextFiles(cwd) {
+    const contextDir = join(cwd, ".context");
+    const activeContext = existsSync(join(contextDir, "activeContext.md"))
+        ? readFileSync(join(contextDir, "activeContext.md"), "utf-8")
+        : "";
+    const systemPatterns = existsSync(join(contextDir, "systemPatterns.md"))
+        ? readFileSync(join(contextDir, "systemPatterns.md"), "utf-8")
+        : "";
+    const techContext = existsSync(join(contextDir, "techContext.md"))
+        ? readFileSync(join(contextDir, "techContext.md"), "utf-8")
+        : "";
+    const productContext = existsSync(join(contextDir, "productContext.md"))
+        ? readFileSync(join(contextDir, "productContext.md"), "utf-8")
+        : "";
+    return { activeContext, systemPatterns, techContext, productContext };
+}
+function extractSection(content, sectionName) {
+    const lines = content.split("\n");
+    const startIndex = lines.findIndex(line => line.includes(`## ${sectionName}`));
+    if (startIndex === -1)
+        return "";
+    let endIndex = lines.length;
+    for (let i = startIndex + 1; i < lines.length; i++) {
+        if (lines[i].startsWith("## ")) {
+            endIndex = i;
+            break;
+        }
+    }
+    return lines.slice(startIndex + 1, endIndex).join("\n").trim();
+}
+function generateAgentsMdContent(projectName, description, contextFiles, executorName = "Claude Code", architectName = "Gemini") {
+    const currentFocus = extractSection(contextFiles.activeContext, "Current Focus");
+    const techStack = extractSection(contextFiles.techContext, "Stack");
+    const conventions = extractSection(contextFiles.systemPatterns, "Conventions");
+    const keyDecisions = extractSection(contextFiles.systemPatterns, "Key Decisions");
+    const architectureSection = extractSection(contextFiles.systemPatterns, "Architecture Patterns");
+    const content = `# AGENTS.md — ${projectName}
+
+> Written by \`tocket init\` / \`tocket agents-md\`. Refresh project facts here. Keep the decide/work rules.
+
+## About this project
+
+${description || "_No description provided._"}
+
+## Instructions for AI agents
+
+1. Read this file first, then \`.context/activeContext.md\`
+2. Read \`.context/systemPatterns.md\` for architecture decisions and conventions
+3. Update \`.context/activeContext.md\` after completing significant work
+4. Follow the full protocol in \`TOCKET.md\`
+
+${agentsProtocolSection()}
+## Current Focus
+
+${currentFocus || "_Generated from .context/activeContext.md. Run \`tocket agents-md\` to update._"}
+
+## Tech Stack
+
+${techStack || "_Generated from .context/techContext.md. Run \`tocket agents-md\` to update._"}
+
+## Architecture & Conventions
+
+${architectureSection ? `### Architecture Patterns\n\n${architectureSection}\n` : ""}
+${conventions ? `### Conventions\n\n${conventions}\n` : ""}
+${keyDecisions ? `### Key Decisions\n\n${keyDecisions}` : ""}
+
+## Key Rules
+
+- Write all code, comments, and commits in \`en-US\`
+- Do not improvise architecture — follow documented decisions
+- Context belongs in \`.context/\`, not in code comments or chat
+- Triangulation: ${architectName} (Architect) + ${executorName} (Executor)
+`;
+    return content;
+}
+async function generateAndWrite(cwd, agentsMdPath, verbose = true) {
+    const contextDir = join(cwd, ".context");
+    const contextFiles = readContextFiles(cwd);
+    let projectName = "Project";
+    let description = "";
+    const productContextFile = join(contextDir, "productContext.md");
+    if (existsSync(productContextFile)) {
+        const productContent = readFileSync(productContextFile, "utf-8");
+        const nameMatch = productContent.match(/## What is (.+)\?/);
+        if (nameMatch)
+            projectName = nameMatch[1];
+        const descMatch = productContent.match(/## What is .+\?\n\n(.+?)(?:\n\n##|$)/s);
+        if (descMatch)
+            description = descMatch[1].trim();
+    }
+    const activeContextFile = join(contextDir, "activeContext.md");
+    if (existsSync(activeContextFile)) {
+        const activeContent = readFileSync(activeContextFile, "utf-8");
+        const nameMatch = activeContent.match(/# Active Context - (.+)/);
+        if (nameMatch)
+            projectName = nameMatch[1];
+    }
+    const systemPatternsFile = join(contextDir, "systemPatterns.md");
+    let executorName = "Claude Code";
+    let architectName = "Gemini";
+    if (existsSync(systemPatternsFile)) {
+        const systemContent = readFileSync(systemPatternsFile, "utf-8");
+        const triangMatch = systemContent.match(/- Triangulation: (.+?) \(Architect\) \+ (.+?) \(Executor\)/);
+        if (triangMatch) {
+            architectName = triangMatch[1];
+            executorName = triangMatch[2];
+        }
+    }
+    const generatedContent = generateAgentsMdContent(projectName, description, contextFiles, executorName, architectName);
+    await writeFile(agentsMdPath, generatedContent, "utf-8");
+    if (verbose) {
+        console.log(heading("\n  AGENTS.md generated\n"));
+        console.log(info(`Location: ${agentsMdPath}`));
+        console.log(info(`Size: ${generatedContent.length} bytes`));
+        console.log(success(`AGENTS.md is ready for cross-tool compatibility!\n`));
+    }
+}
+export function registerAgentsMdCommand(program) {
+    program
+        .command("agents-md")
+        .description("Generate or regenerate AGENTS.md from .context/")
+        .option("--watch", "Watch for changes in .context/ and regenerate")
+        .action(async (options) => {
+        const cwd = process.cwd();
+        const contextDir = join(cwd, ".context");
+        const agentsMdPath = join(cwd, "AGENTS.md");
+        if (!existsSync(contextDir)) {
+            console.error(themeError("Memory Bank not found. Run 'tocket init' first."));
+            process.exitCode = 1;
+            return;
+        }
+        try {
+            // Initial generation
+            await generateAndWrite(cwd, agentsMdPath, !options.watch);
+            if (options.watch) {
+                console.log(info("Watching .context/ for changes... (Ctrl+C to stop)"));
+                const watcher = watch(contextDir, { recursive: false }, (eventType, filename) => {
+                    if (filename?.endsWith(".md")) {
+                        console.log(dim(`  detected change in ${filename}`));
+                        generateAndWrite(cwd, agentsMdPath, false).catch((err) => {
+                            console.error(themeError(`Failed to regenerate: ${err instanceof Error ? err.message : String(err)}`));
+                        });
+                    }
+                });
+                // Graceful shutdown on SIGINT
+                process.on("SIGINT", () => {
+                    watcher.close();
+                    process.exit(0);
+                });
+                // Keep process alive
+                await new Promise(() => { });
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(themeError(`Failed to generate AGENTS.md: ${message}`));
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=agents-md.cmd.js.map

package/dist/commands/agents-md.cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-md.cmd.js","sourceRoot":"","sources":["../../src/commands/agents-md.cmd.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,KAAK,IAAI,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AASpE,SAAS,gBAAgB,CAAC,GAAW;IACnC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACzC,MAAM,aAAa,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;QACpE,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7D,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC;QACtE,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9D,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;QAChE,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3D,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC;QACtE,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9D,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;AACxE,CAAC;AAED,SAAS,cAAc,CAAC,OAAe,EAAE,WAAmB;IAC1D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,WAAW,EAAE,CAAC,CAAC,CAAC;IAE/E,IAAI,UAAU,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjC,IAAI,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,UAAU,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnD,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,QAAQ,GAAG,CAAC,CAAC;YACb,MAAM;QACR,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACjE,CAAC;AAED,SAAS,uBAAuB,CAC9B,WAAmB,EACnB,WAAmB,EACnB,YAA0B,EAC1B,YAAY,GAAG,aAAa,EAC5B,aAAa,GAAG,QAAQ;IAExB,MAAM,YAAY,GAAG,cAAc,CAAC,YAAY,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;IACjF,MAAM,SAAS,GAAG,cAAc,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACpE,MAAM,WAAW,GAAG,cAAc,CAAC,YAAY,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;IAC/E,MAAM,YAAY,GAAG,cAAc,CAAC,YAAY,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;IAElF,MAAM,mBAAmB,GAAG,cAAc,CAAC,YAAY,CAAC,cAAc,EAAE,uBAAuB,CAAC,CAAC;IAEjG,MAAM,OAAO,GAAG,iBAAiB,WAAW;;;;;;EAM5C,WAAW,IAAI,4BAA4B;;;;;;;;;EAS3C,qBAAqB,EAAE;;;EAGvB,YAAY,IAAI,iFAAiF;;;;EAIjG,SAAS,IAAI,+EAA+E;;;;EAI5F,mBAAmB,CAAC,CAAC,CAAC,gCAAgC,mBAAmB,IAAI,CAAC,CAAC,CAAC,EAAE;EAClF,WAAW,CAAC,CAAC,CAAC,sBAAsB,WAAW,IAAI,CAAC,CAAC,CAAC,EAAE;EACxD,YAAY,CAAC,CAAC,CAAC,wBAAwB,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE;;;;;;;mBAOzC,aAAa,kBAAkB,YAAY;CAC7D,CAAC;IAEA,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,GAAW,EAAE,YAAoB,EAAE,UAAmB,IAAI;IACxF,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACzC,MAAM,YAAY,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAE3C,IAAI,WAAW,GAAG,SAAS,CAAC;IAC5B,IAAI,WAAW,GAAG,EAAE,CAAC;IAErB,MAAM,kBAAkB,GAAG,IAAI,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC;IACjE,IAAI,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACnC,MAAM,cAAc,GAAG,YAAY,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;QACjE,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAC5D,IAAI,SAAS;YAAE,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAE1C,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAChF,IAAI,SAAS;YAAE,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,CAAC;IAED,MAAM,iBAAiB,GAAG,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;IAC/D,IAAI,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAClC,MAAM,aAAa,GAAG,YAAY,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;QAC/D,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACjE,IAAI,SAAS;YAAE,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,kBAAkB,GAAG,IAAI,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC;IACjE,IAAI,YAAY,GAAG,aAAa,CAAC;IACjC,IAAI,aAAa,GAAG,QAAQ,CAAC;IAC7B,IAAI,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACnC,MAAM,aAAa,GAAG,YAAY,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;QAChE,MAAM,WAAW,GAAG,aAAa,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;QACtG,IAAI,WAAW,EAAE,CAAC;YAChB,aAAa,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAC/B,YAAY,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,MAAM,gBAAgB,GAAG,uBAAuB,CAC9C,WAAW,EACX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,CACd,CAAC;IAEF,MAAM,SAAS,CAAC,YAAY,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAEzD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,YAAY,EAAE,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,gBAAgB,CAAC,MAAM,QAAQ,CAAC,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,oDAAoD,CAAC,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,iDAAiD,CAAC;SAC9D,MAAM,CAAC,SAAS,EAAE,+CAA+C,CAAC;SAClE,MAAM,CAAC,KAAK,EAAE,OAA4B,EAAE,EAAE;QAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACzC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAE5C,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,iDAAiD,CAAC,CAAC,CAAC;YAC7E,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,qBAAqB;YACrB,MAAM,gBAAgB,CAAC,GAAG,EAAE,YAAY,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAE1D,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBAClB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC,CAAC;gBAExE,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;oBAC9E,IAAI,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;wBAC9B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,wBAAwB,QAAQ,EAAE,CAAC,CAAC,CAAC;wBACrD,gBAAgB,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;4BACvD,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,yBAAyB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;wBACzG,CAAC,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC,CAAC,CAAC;gBAEH,8BAA8B;gBAC9B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;oBACxB,OAAO,CAAC,KAAK,EAAE,CAAC;oBAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,CAAC,CAAC,CAAC;gBAEH,qBAAqB;gBACrB,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,iCAAiC,OAAO,EAAE,CAAC,CAAC,CAAC;YACtE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/dashboard.js

@@ -34,7 +34,9 @@ export async function showDashboard(program) {
     const choices = hasWorkspace
         ? [
             { value: "generate", name: "Generate payload" },
+            { value: "diff", name: "Diff payload vs changes" },
             { value: "sync", name: "Sync progress" },
+            { value: "handoff", name: "Handoff summary" },
             { value: "validate", name: "Validate workspace" },
             { value: "focus", name: "Update focus" },
             { value: "status", name: "Workspace status" },

package/dist/commands/dashboard.js.map

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

package/dist/commands/decide.cmd.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerDecideCommand(program: Command): void;

package/dist/commands/decide.cmd.js

@@ -0,0 +1,70 @@
+import { isAbsolute, resolve } from "node:path";
+import { DecideError, formatDecideSummary, parseConfidenceThreshold, runDecide, toRepoRelative, } from "../utils/decide.js";
+import { error as themeError, success } from "../utils/theme.js";
+import { TOCKET_AGENT_PHRASE, TOCKET_SKILLS_ADD } from "../templates/memory-bank.js";
+function collect(value, previous) {
+    return previous.concat(value);
+}
+function resolveFromPath(cwd, from) {
+    return isAbsolute(from) ? from : resolve(cwd, from);
+}
+export function registerDecideCommand(program) {
+    program
+        .command("decide")
+        .description("Cheap typed Choice into .context/decisions/; workers execute, Tocket does not")
+        .addHelpText("after", `
+Tocket is the shared project notebook (.context/). decide writes the next move.
+Workers (Cursor, Claude, GrokBot, CI) execute. Tocket does not.
+
+5-minute setup:
+  1. npx @pedrocivita/tocket init
+  2. ${TOCKET_SKILLS_ADD}
+  3. tocket doctor
+  4. tocket decide --dry-run --state '{"goal":"docs"}' --choice next:research,write,review
+  Phrase: ${TOCKET_AGENT_PHRASE}
+  Optional TYPESAFE_API_KEY for live Jev; otherwise the stub
+
+Tool-risk gate (file-first; Jev judges, workers execute):
+  tocket decide --from state.json --choice tool_gate:allow,block,ask --shadow
+  tocket work --from <decision>
+  tocket work --from <decision> --apply
+
+A future --backend laya (local Apple Silicon) is not implemented yet.
+`)
+        .option("--state <json|text>", "Inline state (JSON object/array or plain text)")
+        .option("--from <path.json>", "Load state from a JSON (or text) file")
+        .option("--choice <spec>", "Choice question as name:opt1,opt2,... (repeatable; batched in one request)", collect, [])
+        .option("--noul <name>", "Noul question name (repeatable; batched)", collect, [])
+        .option("--score <spec>", "Optional Score name or name:min,max (repeatable; batched)", collect, [])
+        .option("--fork <kind>", "Bounded fork: agent, model, tool, action, or human (default action)")
+        .option("--dry-run", "Force the deterministic stub and mark mode=dry-run (log-only)")
+        .option("--shadow", "Call Jev if TYPESAFE_API_KEY is set, but mark log-only (do not claim execution)")
+        .option("--confidence-threshold <n>", "Route research/write only at or above this confidence (default 0.85)")
+        .option("--id <id>", "Decision id used in the output filename")
+        .action(async (options) => {
+        const cwd = process.cwd();
+        try {
+            const { record, outPath } = await runDecide({
+                cwd,
+                state: options.state,
+                fromPath: options.from ? resolveFromPath(cwd, options.from) : undefined,
+                choices: options.choice,
+                nouls: options.noul,
+                scores: options.score,
+                fork: options.fork,
+                dryRun: options.dryRun === true,
+                shadow: options.shadow === true,
+                confidenceThreshold: parseConfidenceThreshold(options.confidenceThreshold),
+                id: options.id,
+            });
+            const rel = toRepoRelative(cwd, outPath);
+            console.log(success(formatDecideSummary(record, rel)));
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(themeError(message));
+            process.exitCode = err instanceof DecideError ? 2 : 1;
+        }
+    });
+}
+//# sourceMappingURL=decide.cmd.js.map

package/dist/commands/decide.cmd.js.map

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

package/dist/commands/diff.cmd.d.ts

@@ -0,0 +1,15 @@
+import type { Command } from "commander";
+import type { ParsedPayload } from "../utils/xml.js";
+export interface DiffReport {
+    payload: ParsedPayload;
+    expectedFiles: string[];
+    actualFiles: string[];
+    matchedFiles: string[];
+    missingFiles: string[];
+    extraFiles: string[];
+    doneCriteria: string[];
+    checks: string[];
+}
+export declare function buildDiffReport(payload: ParsedPayload, actualFiles: string[]): DiffReport;
+export declare function formatDiffReport(report: DiffReport): string;
+export declare function registerDiffCommand(program: Command): void;