@pedrocivita/tocket 1.2.0 → 2.1.0

package/README.md

@@ -32,24 +32,55 @@ The CLI just automates the scaffolding.
 ## Quick Start
 
 ```bash
+# Interactive dashboard — guided entry point
+npx @pedrocivita/tocket
+
 # Scaffold a new workspace (creates .context/, TOCKET.md, CLAUDE.md, GEMINI.md)
 npx @pedrocivita/tocket init
 
-# Generate a payload XML for agent handoff
+# Generate a payload XML with smart git integration
 npx @pedrocivita/tocket generate
 
 # Sync session progress into Memory Bank
 npx @pedrocivita/tocket sync
+
+# Update the current focus
+npx @pedrocivita/tocket focus "Refactoring payment module"
+
+# Remove all Tocket files (with confirmation)
+npx @pedrocivita/tocket eject
 ```
 
 ## Commands
 
-| Command           | What it does                                                   |
-| ----------------- | -------------------------------------------------------------- |
-| `tocket init`     | Scaffolds `.context/`, `TOCKET.md`, `CLAUDE.md`, `GEMINI.md`   |
-| `tocket generate` | Interactive payload XML builder — copies to clipboard          |
-| `tocket sync`     | Appends session summary + git log to `.context/progress.md`    |
-| `tocket validate` | Checks if the current directory has a valid Tocket Memory Bank |
+| Command           | What it does                                                         |
+| ----------------- | -------------------------------------------------------------------- |
+| `tocket`          | Interactive dashboard with guided menu                               |
+| `tocket init`     | Scaffolds `.context/`, `TOCKET.md`, `CLAUDE.md`, `GEMINI.md`         |
+| `tocket generate` | Smart payload builder — auto-fills scope from git, multi-task support |
+| `tocket sync`     | Appends session summary + git log to `.context/progress.md`          |
+| `tocket validate` | Checks if the current directory has a valid Tocket Memory Bank       |
+| `tocket focus`    | Update the Current Focus in `.context/activeContext.md`              |
+| `tocket status`   | Quick overview of workspace, focus, branch, and agents               |
+| `tocket config`   | Manage global settings (`~/.tocketrc.json`)                          |
+| `tocket eject`    | Remove all Tocket files from the workspace                           |
+
+## Configuration
+
+Set global defaults so you don't repeat yourself:
+
+```bash
+# Interactive setup
+tocket config
+
+# Or use flags (CI-friendly)
+tocket config --author "Your Name" --priority medium --skills "core,lsp"
+
+# View current config
+tocket config --show
+```
+
+Config is stored at `~/.tocketrc.json` and pre-fills author, priority, and skills in all commands.
 
 ## How Triangulation works
 

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

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

package/dist/commands/config.cmd.js

@@ -0,0 +1,102 @@
+import { input, select, confirm } from "@inquirer/prompts";
+import { getConfig, saveConfig, resetConfig, getConfigPath, } from "../utils/config.js";
+import { success, heading, dim } from "../utils/theme.js";
+export function registerConfigCommand(program) {
+    program
+        .command("config")
+        .description("Manage global Tocket configuration (~/.tocketrc.json)")
+        .option("--author <name>", "Set default author name")
+        .option("--agent <name>", "Set default agent name")
+        .option("--priority <level>", "Set default priority (high|medium|low)")
+        .option("--skills <list>", "Set default skills (comma-separated)")
+        .option("--show", "Display current configuration")
+        .option("--path", "Show config file path")
+        .option("--reset", "Reset configuration to defaults")
+        .action(async (options) => {
+        // --path: print and exit
+        if (options.path) {
+            console.log(getConfigPath());
+            return;
+        }
+        // --show: display current config
+        if (options.show) {
+            const config = await getConfig();
+            console.log(heading("\n  Current Configuration\n"));
+            console.log(JSON.stringify(config, null, 2)
+                .split("\n")
+                .map((l) => "  " + l)
+                .join("\n"));
+            console.log(dim(`\n  Path: ${getConfigPath()}\n`));
+            return;
+        }
+        // --reset: clear config
+        if (options.reset) {
+            const ok = await confirm({
+                message: "Reset all configuration to defaults?",
+                default: false,
+            });
+            if (ok) {
+                await resetConfig();
+                console.log(success("Configuration reset."));
+            }
+            return;
+        }
+        // Non-interactive: handle individual flags
+        const hasFlags = options.author || options.agent || options.priority || options.skills;
+        if (hasFlags) {
+            const config = await getConfig();
+            if (options.author)
+                config.author = options.author;
+            if (options.agent)
+                config.defaultAgent = options.agent;
+            if (options.priority) {
+                if (!config.defaults)
+                    config.defaults = {};
+                config.defaults.priority = options.priority;
+            }
+            if (options.skills) {
+                if (!config.defaults)
+                    config.defaults = {};
+                config.defaults.skills = options.skills;
+            }
+            await saveConfig(config);
+            console.log(success("Configuration updated."));
+            return;
+        }
+        // Interactive TUI mode
+        const current = await getConfig();
+        console.log(heading("\n  Tocket Configuration\n"));
+        const author = await input({
+            message: "Author name:",
+            default: current.author || undefined,
+        });
+        const agent = await input({
+            message: "Default agent name:",
+            default: current.defaultAgent || undefined,
+        });
+        const priority = await select({
+            message: "Default priority:",
+            choices: [
+                { value: "high", name: "high" },
+                { value: "medium", name: "medium" },
+                { value: "low", name: "low" },
+            ],
+            default: current.defaults?.priority ?? "medium",
+        });
+        const skills = await input({
+            message: "Default skills (comma-separated):",
+            default: current.defaults?.skills || undefined,
+        });
+        await saveConfig({
+            ...current,
+            author: author || undefined,
+            defaultAgent: agent || undefined,
+            defaults: {
+                priority: priority,
+                skills: skills || undefined,
+            },
+        });
+        console.log("\n" + success("Configuration saved."));
+        console.log(dim(`  Path: ${getConfigPath()}\n`));
+    });
+}

package/dist/commands/dashboard.d.ts

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

package/dist/commands/dashboard.js

@@ -0,0 +1,68 @@
+import { select } from "@inquirer/prompts";
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { banner, heading, success, dim, warn } from "../utils/theme.js";
+import { getConfig } from "../utils/config.js";
+function extractFocus(content) {
+    const match = content.match(/## Current Focus\s*\n+(.+)/);
+    if (!match?.[1])
+        return "";
+    const line = match[1].trim();
+    if (line.startsWith("_") || line.includes("No active tasks"))
+        return "";
+    return line.length > 80 ? line.substring(0, 77) + "..." : line;
+}
+export async function showDashboard(program) {
+    const config = await getConfig();
+    const cwd = process.cwd();
+    const hasWorkspace = existsSync(join(cwd, ".context"));
+    if (!config.theme?.disableBanner) {
+        console.log(banner());
+    }
+    console.log(heading("  Dashboard\n"));
+    if (hasWorkspace) {
+        console.log("  " + success("Workspace detected"));
+        try {
+            const ctx = await readFile(join(cwd, ".context", "activeContext.md"), "utf-8");
+            const focus = extractFocus(ctx);
+            if (focus) {
+                console.log("  " + dim(`Focus: ${focus}`));
+            }
+        }
+        catch {
+            // activeContext.md missing or unreadable — ignore
+        }
+    }
+    else {
+        console.log("  " + warn("No workspace in this directory"));
+        console.log("  " + dim("Run init to scaffold a Tocket workspace here.\n"));
+    }
+    console.log();
+    const choices = hasWorkspace
+        ? [
+            { value: "generate", name: "Generate payload" },
+            { value: "sync", name: "Sync progress" },
+            { value: "validate", name: "Validate workspace" },
+            { value: "focus", name: "Update focus" },
+            { value: "status", name: "Workspace status" },
+            { value: "config", name: "Configure settings" },
+            { value: "eject", name: "Eject workspace" },
+            { value: "exit", name: "Exit" },
+        ]
+        : [
+            { value: "init", name: "Initialize workspace" },
+            { value: "config", name: "Configure settings" },
+            { value: "exit", name: "Exit" },
+        ];
+    const action = await select({
+        message: "What would you like to do?",
+        choices,
+    });
+    if (action === "exit") {
+        console.log(dim("\n  Goodbye!\n"));
+        return;
+    }
+    console.log();
+    await program.parseAsync(["node", "tocket", action]);
+}

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

@@ -0,0 +1,6 @@
+import type { Command } from "commander";
+/** Files created by `tocket init` that eject should remove. */
+export declare const EJECT_FILES: readonly ["TOCKET.md", "CLAUDE.md", "GEMINI.md", ".cursorrules"];
+/** Directories created by `tocket init` that eject should remove. */
+export declare const EJECT_DIRS: readonly [".context"];
+export declare function registerEjectCommand(program: Command): void;

package/dist/commands/eject.cmd.js

@@ -0,0 +1,65 @@
+import { confirm } from "@inquirer/prompts";
+import { existsSync } from "node:fs";
+import { rm } from "node:fs/promises";
+import { join } from "node:path";
+import { success, warn, info, dim } from "../utils/theme.js";
+/** Files created by `tocket init` that eject should remove. */
+export const EJECT_FILES = [
+    "TOCKET.md",
+    "CLAUDE.md",
+    "GEMINI.md",
+    ".cursorrules",
+];
+/** Directories created by `tocket init` that eject should remove. */
+export const EJECT_DIRS = [".context"];
+export function registerEjectCommand(program) {
+    program
+        .command("eject")
+        .description("Remove all Tocket files from the current workspace")
+        .option("-f, --force", "Skip confirmation prompt")
+        .action(async (options) => {
+        const cwd = process.cwd();
+        const contextDir = join(cwd, ".context");
+        if (!existsSync(contextDir)) {
+            console.log(warn("No Tocket workspace found in this directory."));
+            return;
+        }
+        if (!options.force) {
+            const ok = await confirm({
+                message: "This will permanently remove .context/, CLAUDE.md, GEMINI.md, TOCKET.md, and .cursorrules. Continue?",
+                default: false,
+            });
+            if (!ok) {
+                console.log(dim("\n  Cancelled.\n"));
+                return;
+            }
+        }
+        let removedCount = 0;
+        for (const dir of EJECT_DIRS) {
+            const fullPath = join(cwd, dir);
+            if (existsSync(fullPath)) {
+                await rm(fullPath, { recursive: true, force: true });
+                console.log(info(`Removed ${dir}/`));
+                removedCount++;
+            }
+        }
+        for (const file of EJECT_FILES) {
+            const fullPath = join(cwd, file);
+            if (existsSync(fullPath)) {
+                await rm(fullPath, { force: true });
+                console.log(info(`Removed ${file}`));
+                removedCount++;
+            }
+        }
+        if (removedCount === 0) {
+            console.log(warn("Nothing to remove."));
+        }
+        else {
+            console.log("\n" +
+                success("Tocket workspace ejected.") +
+                " " +
+                dim("Global config (~/.tocketrc.json) was not touched.") +
+                "\n");
+        }
+    });
+}

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

@@ -0,0 +1,7 @@
+import type { Command } from "commander";
+/**
+ * Replaces the content under ## Current Focus with the new message.
+ * Exported for testing.
+ */
+export declare function replaceFocusSection(content: string, newFocus: string): string;
+export declare function registerFocusCommand(program: Command): void;

package/dist/commands/focus.cmd.js

@@ -0,0 +1,52 @@
+import { input } from "@inquirer/prompts";
+import { existsSync } from "node:fs";
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { success, error as themeError, info } from "../utils/theme.js";
+/**
+ * Replaces the content under ## Current Focus with the new message.
+ * Exported for testing.
+ */
+export function replaceFocusSection(content, newFocus) {
+    const regex = /(## Current Focus[ \t]*\n)[\s\S]*?(?=\n## |\n*$)/;
+    if (!regex.test(content)) {
+        return content.trimEnd() + "\n\n## Current Focus\n\n" + newFocus + "\n";
+    }
+    return content.replace(regex, `$1\n${newFocus}\n`);
+}
+export function registerFocusCommand(program) {
+    program
+        .command("focus")
+        .description("Update the Current Focus in activeContext.md")
+        .argument("[message...]", "Focus message (prompted if omitted)")
+        .action(async (messageParts) => {
+        const cwd = process.cwd();
+        const contextDir = join(cwd, ".context");
+        if (!existsSync(contextDir)) {
+            console.error(themeError("No .context/ directory found. Run 'tocket init' first."));
+            process.exitCode = 1;
+            return;
+        }
+        const filePath = join(contextDir, "activeContext.md");
+        if (!existsSync(filePath)) {
+            console.error(themeError("activeContext.md not found. Run 'tocket init' first."));
+            process.exitCode = 1;
+            return;
+        }
+        let message = messageParts.join(" ").trim();
+        if (!message) {
+            message = await input({ message: "What is the current focus?" });
+            message = message.trim();
+        }
+        if (!message) {
+            console.error(themeError("Focus message cannot be empty."));
+            process.exitCode = 1;
+            return;
+        }
+        const content = await readFile(filePath, "utf-8");
+        const updated = replaceFocusSection(content, message);
+        await writeFile(filePath, updated, "utf-8");
+        console.log(info("Focus updated in .context/activeContext.md"));
+        console.log("  " + success(message));
+    });
+}

package/dist/commands/generate.cmd.js

@@ -1,14 +1,26 @@
-import { input, select } from "@inquirer/prompts";
+import { input, select, confirm } from "@inquirer/prompts";
 import clipboard from "clipboardy";
-function buildPayloadXml(opts) {
-    const skillsAttr = opts.skills.trim()
-        ? `\n    <skills>${opts.skills.trim()}</skills>`
+import { success, heading, dim, banner } from "../utils/theme.js";
+import { getConfig } from "../utils/config.js";
+import { getStagedFiles, getModifiedFiles } from "../utils/git.js";
+function buildPayloadXml(tasks) {
+    const first = tasks[0];
+    const skillsAttr = first.skills.trim()
+        ? `\n    <skills>${first.skills.trim()}</skills>`
         : "";
+    const taskBlocks = tasks
+        .map((t, i) => `    <task id="${i + 1}" type="create | edit | delete">
+      <target><!-- file/path --></target>
+      <action>${t.intent}</action>
+      <spec><!-- Detailed specification --></spec>
+      <done><!-- Definition of done --></done>
+    </task>`)
+        .join("\n");
     return `<payload version="2.0">
   <meta>
-    <intent>${opts.intent}</intent>
-    <scope>${opts.scope}</scope>${skillsAttr}
-    <priority>${opts.priority}</priority>
+    <intent>${first.intent}</intent>
+    <scope>${first.scope}</scope>${skillsAttr}
+    <priority>${first.priority}</priority>
   </meta>
 
   <context>
@@ -16,12 +28,7 @@ function buildPayloadXml(opts) {
   </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>
+${taskBlocks}
   </tasks>
 
   <validate>
@@ -29,26 +36,71 @@ function buildPayloadXml(opts) {
   </validate>
 </payload>`;
 }
+function suggestScope() {
+    const staged = getStagedFiles();
+    const modified = getModifiedFiles();
+    const all = [...new Set([...staged, ...modified])];
+    return all.join(", ");
+}
 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, optional):",
-        });
-        const xml = buildPayloadXml({ intent, scope, priority, skills });
+        .option("--no-preview", "Skip payload preview before copying")
+        .action(async (options) => {
+        const config = await getConfig();
+        if (!config.theme?.disableBanner) {
+            console.log(banner());
+        }
+        const tasks = [];
+        const suggestedScope = suggestScope();
+        const defaultPriority = config.defaults?.priority ?? "medium";
+        const defaultSkills = config.defaults?.skills ?? "";
+        let addMore = true;
+        while (addMore) {
+            const taskNum = tasks.length + 1;
+            if (taskNum > 1) {
+                console.log(heading(`\n  Task ${taskNum}\n`));
+            }
+            const intent = await input({ message: "Intent (goal in one line):" });
+            const scope = await input({
+                message: "Scope (files/folders affected):",
+                default: taskNum === 1 && suggestedScope ? suggestedScope : undefined,
+            });
+            const priority = await select({
+                message: "Priority:",
+                choices: [
+                    { value: "high", name: "high" },
+                    { value: "medium", name: "medium" },
+                    { value: "low", name: "low" },
+                ],
+                default: defaultPriority,
+            });
+            const skills = await input({
+                message: "Skills/plugins (comma-separated, optional):",
+                default: taskNum === 1 && defaultSkills ? defaultSkills : undefined,
+            });
+            tasks.push({ intent, scope, priority, skills });
+            addMore = await confirm({
+                message: "Add another task?",
+                default: false,
+            });
+        }
+        const xml = buildPayloadXml(tasks);
+        // Preview
+        if (options.preview !== false) {
+            console.log(dim("\n--- Payload Preview ---"));
+            const lines = xml.split("\n");
+            const preview = lines.length > 20
+                ? lines.slice(0, 20).join("\n") + dim("\n  ... (" + (lines.length - 20) + " more lines)")
+                : lines.join("\n");
+            console.log(dim(preview));
+            console.log(dim("--- End Preview ---\n"));
+        }
         clipboard.writeSync(xml);
-        console.log("\n\x1b[32m\u2713\x1b[0m Payload XML (v2.0) copied to clipboard! Paste it into your Architect to continue.");
+        console.log(success(`Payload XML (v2.0) copied to clipboard!`) +
+            dim(` ${tasks.length} task(s).`) +
+            "\n" +
+            dim("  Paste it into your Architect to continue.\n"));
     });
 }

package/dist/commands/init.cmd.js

@@ -1,6 +1,8 @@
-import { input } from "@inquirer/prompts";
+import { input, confirm } from "@inquirer/prompts";
 import { mkdir, readFile, writeFile, access } from "node:fs/promises";
 import { join } from "node:path";
+import { banner, heading, info, success, dim } from "../utils/theme.js";
+import { getConfig } from "../utils/config.js";
 import { claudeMd, geminiMd, tocketMd, activeContextMd, systemPatternsMd, productContextMd, techContextMd, progressMd, cursorrulesMd, } from "../templates/memory-bank.js";
 async function fileExists(path) {
     try {
@@ -116,22 +118,28 @@ export function registerInitCommand(program) {
     program
         .command("init")
         .description("Scaffold an agentic workspace with Memory Bank and triangulation config")
-        .action(async () => {
+        .option("-f, --force", "Overwrite existing files without prompting")
+        .action(async (options) => {
+        const force = options.force ?? false;
         const cwd = process.cwd();
+        const globalConfig = await getConfig();
+        if (!globalConfig.theme?.disableBanner) {
+            console.log(banner());
+        }
         const { stack, detectedName, detectedDescription } = await detectStack(cwd);
         const hasDetection = Boolean(stack.language);
         if (hasDetection) {
-            console.log("\n  Auto-detected stack from package.json:");
+            console.log(heading("  Auto-detected stack:\n"));
             if (stack.language)
-                console.log(`    Language:  ${stack.language}`);
+                console.log(info(`Language:  ${stack.language}`));
             if (stack.runtime)
-                console.log(`    Runtime:   ${stack.runtime}`);
+                console.log(info(`Runtime:   ${stack.runtime}`));
             if (stack.build)
-                console.log(`    Build:     ${stack.build}`);
+                console.log(info(`Build:     ${stack.build}`));
             if (stack.framework)
-                console.log(`    Framework: ${stack.framework}`);
+                console.log(info(`Framework: ${stack.framework}`));
             if (stack.extras.length)
-                console.log(`    Extras:    ${stack.extras.join(", ")}`);
+                console.log(info(`Extras:    ${stack.extras.join(", ")}`));
             console.log();
         }
         const projectName = await input({
@@ -163,9 +171,22 @@ export function registerInitCommand(program) {
         ];
         for (const [filePath, content] of files) {
             const fullPath = join(cwd, filePath);
+            const exists = await fileExists(fullPath);
+            if (exists && !force) {
+                const overwrite = await confirm({
+                    message: `${filePath} already exists. Overwrite?`,
+                    default: false,
+                });
+                if (!overwrite) {
+                    console.log("  " + dim(`skipped ${filePath}`));
+                    continue;
+                }
+            }
             await writeFile(fullPath, content, "utf-8");
-            console.log(`  created ${filePath}`);
+            console.log("  " + success(`${exists ? "updated" : "created"} ${filePath}`));
         }
-        console.log(`\nAgentic workspace initialized for ${projectName}!${hasDetection ? " Stack pre-populated from package.json." : ""} Ready to launch.`);
+        console.log("\n" + success(`Workspace initialized for ${projectName}!`) +
+            (hasDetection ? dim(" Stack pre-populated from package.json.") : "") +
+            "\n" + dim("  Next: run tocket generate to create your first payload.\n"));
     });
 }

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

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