@pedrocivita/tocket 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pedro Civita
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,38 @@
+# Tocket
+
+**The Context Engineering Framework for Multi-Agent Workspaces**
+
+Tocket structures how AI agents share context, hand off work, and build on each other's output. It turns ad-hoc prompting into a repeatable engineering workflow.
+
+## Core Pillars
+
+- **Triangulation** — Architect + Executor pattern. One agent plans, another implements, with structured handoff payloads between them.
+- **Context as Code** — Memory Bank protocol. Project context lives in version-controlled files (`.context/`), not ephemeral chat history.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `tocket init` | Scaffold an agentic workspace with Memory Bank and triangulation config |
+| `tocket generate` | Build payload XMLs interactively for Architect-Executor handoff |
+| `tocket sync` | Update Memory Bank from git history and session artifacts |
+
+## Installation
+
+```bash
+npx @pedrocivita/tocket
+```
+
+## Development
+
+```bash
+git clone https://github.com/pedrocivita/tocket.git
+cd tocket
+npm install
+npm run build
+node dist/index.js --help
+```
+
+## License
+
+MIT

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

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

package/dist/commands/generate.cmd.js

@@ -0,0 +1,89 @@
+import { input, select, number } from "@inquirer/prompts";
+import clipboard from "clipboardy";
+function inferMode(score) {
+    if (score <= 6)
+        return "solo";
+    if (score <= 10)
+        return "team-small";
+    return "team-full";
+}
+function buildPayloadXml(opts) {
+    const mode = inferMode(opts.complexity);
+    const skillLines = opts.skills
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean)
+        .map((s) => `      <skill>${s}</skill>`)
+        .join("\n");
+    return `<payload version="3.0">
+  <meta>
+    <intent>${opts.intent}</intent>
+    <scope>${opts.scope}</scope>
+    <priority>${opts.priority}</priority>
+    <complexity score="${opts.complexity}" mode="${mode}" />
+    <model>${opts.model}</model>
+  </meta>
+
+  <skills>
+${skillLines || "      <!-- Add skills here -->"}
+  </skills>
+
+  <context>
+    <!-- Provide relevant context for the Architect -->
+  </context>
+
+  <tasks>
+    <!-- The Architect will populate tasks based on the intent -->
+  </tasks>
+
+  <validate>
+    <!-- Define acceptance criteria -->
+  </validate>
+</payload>`;
+}
+export function registerGenerateCommand(program) {
+    program
+        .command("generate")
+        .description("Build payload XMLs interactively for Architect-Executor handoff")
+        .action(async () => {
+        const intent = await input({ message: "Intent (goal in one line):" });
+        const scope = await input({ message: "Scope (files/folders affected):" });
+        const priority = await select({
+            message: "Priority:",
+            choices: [
+                { value: "high", name: "high" },
+                { value: "medium", name: "medium" },
+                { value: "low", name: "low" },
+            ],
+        });
+        const skills = await input({
+            message: "Skills/plugins (comma-separated):",
+        });
+        const model = await select({
+            message: "Architect model:",
+            choices: [
+                {
+                    value: "gemini-3.1-pro-preview-customtools",
+                    name: "gemini-3.1-pro-preview-customtools (default)",
+                },
+                { value: "gemini-2.5-pro", name: "gemini-2.5-pro" },
+            ],
+        });
+        const complexity = await number({
+            message: "Complexity score (0-15):",
+            min: 0,
+            max: 15,
+            required: true,
+        });
+        const xml = buildPayloadXml({
+            intent,
+            scope,
+            priority,
+            skills,
+            model,
+            complexity: complexity ?? 0,
+        });
+        clipboard.writeSync(xml);
+        console.log("\n\x1b[32m✓\x1b[0m Payload XML (v3.0) copied to clipboard! Paste it into your Architect to continue.");
+    });
+}

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

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

package/dist/commands/init.cmd.js

@@ -0,0 +1,27 @@
+import { input } from "@inquirer/prompts";
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { claudeMd, geminiMd, activeContextMd, systemPatternsMd, } from "../templates/memory-bank.js";
+export function registerInitCommand(program) {
+    program
+        .command("init")
+        .description("Scaffold an agentic workspace with Memory Bank and triangulation config")
+        .action(async () => {
+        const projectName = await input({ message: "Project Name:" });
+        const description = await input({ message: "Short Description:" });
+        const contextDir = join(process.cwd(), ".context");
+        await mkdir(contextDir, { recursive: true });
+        const files = [
+            ["CLAUDE.md", claudeMd(projectName, description)],
+            ["GEMINI.md", geminiMd(projectName, description)],
+            [join(".context", "activeContext.md"), activeContextMd(projectName)],
+            [join(".context", "systemPatterns.md"), systemPatternsMd(projectName)],
+        ];
+        for (const [filePath, content] of files) {
+            const fullPath = join(process.cwd(), filePath);
+            await writeFile(fullPath, content, "utf-8");
+            console.log(`  created ${filePath}`);
+        }
+        console.log(`\nAgentic workspace initialized for ${projectName}! Ready to launch.`);
+    });
+}

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

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

package/dist/commands/sync.cmd.js

@@ -0,0 +1,51 @@
+import { input } from "@inquirer/prompts";
+import { existsSync } from "node:fs";
+import { appendFile, writeFile } from "node:fs/promises";
+import { execSync } from "node:child_process";
+import { join } from "node:path";
+function getRecentCommits() {
+    try {
+        return execSync("git log --oneline -5", { encoding: "utf-8" }).trim();
+    }
+    catch {
+        return "_No commits found or not a git repository._";
+    }
+}
+export function registerSyncCommand(program) {
+    program
+        .command("sync")
+        .description("Update Memory Bank from git history and session artifacts")
+        .action(async () => {
+        const progressPath = join(process.cwd(), ".context", "progress.md");
+        const contextDir = join(process.cwd(), ".context");
+        if (!existsSync(contextDir)) {
+            console.error("\x1b[31mMemory Bank not found. Run 'tocket init' first.\x1b[0m");
+            process.exitCode = 1;
+            return;
+        }
+        const summary = await input({
+            message: "What did you accomplish in this session?",
+        });
+        const commits = getRecentCommits();
+        const date = new Date().toISOString().split("T")[0];
+        const block = `## Session: ${date}
+
+**Summary**: ${summary}
+
+**Recent Commits**:
+\`\`\`
+${commits}
+\`\`\`
+
+---
+
+`;
+        if (!existsSync(progressPath)) {
+            await writeFile(progressPath, `# Progress Log\n\n<!-- Appended by tocket sync -->\n\n${block}`, "utf-8");
+        }
+        else {
+            await appendFile(progressPath, block, "utf-8");
+        }
+        console.log("\n\x1b[32m✓\x1b[0m Memory Bank synchronized successfully!");
+    });
+}

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { registerInitCommand } from "./commands/init.cmd.js";
+import { registerGenerateCommand } from "./commands/generate.cmd.js";
+import { registerSyncCommand } from "./commands/sync.cmd.js";
+const program = new Command();
+program
+    .name("tocket")
+    .description("The Context Engineering Framework for Multi-Agent Workspaces")
+    .version("1.0.0");
+registerInitCommand(program);
+registerGenerateCommand(program);
+registerSyncCommand(program);
+program.parse();

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

@@ -0,0 +1,4 @@
+export declare const claudeMd: (projectName: string, description: string) => string;
+export declare const geminiMd: (projectName: string, description: string) => string;
+export declare const activeContextMd: (projectName: string) => string;
+export declare const systemPatternsMd: (projectName: string) => string;

package/dist/templates/memory-bank.js

@@ -0,0 +1,141 @@
+export const claudeMd = (projectName, description) => `# CLAUDE.md - ${projectName}
+
+<!-- LLM_CONTEXT: Executor instructions for Claude Code -->
+<!-- Generated by Tocket CLI -->
+
+## Role
+
+You are the **Executor** for **${projectName}**.
+${description ? `\n> ${description}\n` : ""}
+Your job is to **implement**, not to plan. Read the Memory Bank before every session, follow the Architect's decisions, and write code.
+
+---
+
+## Rules
+
+1. **Always read \`.context/\` first** — Start every session by reading activeContext.md and systemPatterns.md.
+2. **Follow the Architect's plan** — Implementation decisions come from GEMINI.md or mission briefs. Do not redesign.
+3. **Ask before deviating** — If the plan is unclear or blocked, ask the user. Do not improvise architecture.
+4. **Write code in English** — Variables, functions, comments, commits — all in \`en-US\`.
+5. **Update Memory Bank on completion** — After finishing a task, update activeContext.md with what changed.
+
+---
+
+## Memory Bank
+
+| File | Purpose |
+|------|---------|
+| \`.context/activeContext.md\` | Current focus, recent changes, open decisions |
+| \`.context/systemPatterns.md\` | Architecture patterns, tech stack, conventions |
+| \`GEMINI.md\` | Architect instructions (read-only for you) |
+
+---
+
+## Workflow
+
+\`\`\`
+1. Read .context/  →  2. Receive task  →  3. Implement  →  4. Update .context/
+\`\`\`
+`;
+export const geminiMd = (projectName, description) => `# GEMINI.md - ${projectName}
+
+<!-- LLM_CONTEXT: Architect instructions for Gemini -->
+<!-- Generated by Tocket CLI -->
+
+## Role
+
+You are the **Architect** (Planner) for **${projectName}**.
+${description ? `\n> ${description}\n` : ""}
+Your job is to **analyze, plan, and decide**. You do not write code directly — you produce structured mission briefs that the Executor (Claude Code) implements.
+
+---
+
+## Rules
+
+1. **Read \`.context/\` first** — Understand current state before planning.
+2. **Produce mission briefs** — Use \`<mission-brief>\` XML format for handoff to the Executor.
+3. **Never write code inline** — Provide specs, not implementations. The Executor handles code.
+4. **Update systemPatterns.md** — When you make architectural decisions, record them.
+5. **Think in constraints** — Define what the system should and should not do.
+
+---
+
+## Memory Bank
+
+| File | Purpose |
+|------|---------|
+| \`.context/activeContext.md\` | Current focus, recent changes, open decisions |
+| \`.context/systemPatterns.md\` | Architecture patterns, tech stack, conventions |
+| \`CLAUDE.md\` | Executor instructions (read-only for you) |
+
+---
+
+## Mission Brief Format
+
+\`\`\`xml
+<mission-brief version="1.0">
+  <meta>
+    <goal>What needs to happen</goal>
+    <scope>Which files/modules are affected</scope>
+    <priority>high | medium | low</priority>
+  </meta>
+  <context>
+    <summary>Background and reasoning</summary>
+    <architect-decisions>Key decisions made</architect-decisions>
+  </context>
+  <tasks>
+    <task id="1" type="create|edit|delete">
+      <target>file/path</target>
+      <action>What to do</action>
+      <spec>Detailed specification</spec>
+      <done>Definition of done</done>
+    </task>
+  </tasks>
+  <validate>
+    <check>Verification step</check>
+  </validate>
+</mission-brief>
+\`\`\`
+`;
+export const activeContextMd = (projectName) => `# Active Context - ${projectName}
+
+<!-- Updated by both Architect and Executor after each session -->
+
+## Current Focus
+
+_No active tasks yet. Run \`tocket generate\` to create your first mission brief._
+
+## Recent Changes
+
+| Date | Change | Agent |
+|------|--------|-------|
+| ${new Date().toISOString().split("T")[0]} | Initialized agentic workspace | Tocket CLI |
+
+## Open Decisions
+
+_None yet._
+`;
+export const systemPatternsMd = (projectName) => `# System Patterns - ${projectName}
+
+<!-- Architectural decisions and conventions. Updated by the Architect. -->
+
+## Tech Stack
+
+_To be defined by the Architect._
+
+## Architecture Patterns
+
+_To be defined._
+
+## Conventions
+
+- Code language: \`en-US\`
+- Commit language: \`en-US\`
+- Triangulation: Gemini (Architect) + Claude (Executor)
+
+## Key Decisions
+
+| Decision | Rationale | Date |
+|----------|-----------|------|
+| Adopted Tocket triangulation | Structured multi-agent workflow | ${new Date().toISOString().split("T")[0]} |
+`;

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@pedrocivita/tocket",
+  "version": "1.0.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": "echo \"Error: no test specified\" && exit 1"
+  },
+  "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://github.com/pedrocivita/tocket#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.3.0",
+    "clipboardy": "^5.3.0",
+    "commander": "^14.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "typescript": "^5.9.3"
+  }
+}