@cadiraca/crowntrack-cli 0.1.0

package/dist/index.js

@@ -0,0 +1,402 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import chalk from "chalk";
+import Table from "cli-table3";
+
+// src/api.ts
+var BASE_URL = process.env.CROWNTRACK_URL || "http://localhost:3333";
+async function request(path, options) {
+  const url = `${BASE_URL}${path}`;
+  const res = await fetch(url, {
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options?.headers
+    }
+  });
+  if (!res.ok) {
+    const text = await res.text();
+    throw new Error(`HTTP ${res.status}: ${text}`);
+  }
+  return res.json();
+}
+async function listProjects(filters) {
+  const params = new URLSearchParams();
+  if (filters?.status) params.set("status", filters.status);
+  if (filters?.category) params.set("category", filters.category);
+  if (filters?.priority) params.set("priority", filters.priority);
+  if (filters?.search) params.set("search", filters.search);
+  if (filters?.tag) params.set("tag", filters.tag);
+  const qs = params.toString();
+  return request(`/api/projects${qs ? `?${qs}` : ""}`);
+}
+async function getProject(id) {
+  return request(`/api/projects/${id}`);
+}
+async function createProject(data) {
+  return request("/api/projects", {
+    method: "POST",
+    body: JSON.stringify(data)
+  });
+}
+async function updateProject(id, data) {
+  return request(`/api/projects/${id}`, {
+    method: "PATCH",
+    body: JSON.stringify(data)
+  });
+}
+async function addAction(projectId, title, priority) {
+  return request(`/api/projects/${projectId}/actions`, {
+    method: "POST",
+    body: JSON.stringify({ title, priority })
+  });
+}
+async function completeAction(projectId, actionId) {
+  return request(`/api/projects/${projectId}/actions`, {
+    method: "PATCH",
+    body: JSON.stringify({ id: actionId, done: true })
+  });
+}
+async function addDecision(projectId, decision, context) {
+  return request(`/api/projects/${projectId}/decisions`, {
+    method: "POST",
+    body: JSON.stringify({ decision, context })
+  });
+}
+async function addNote(projectId, content) {
+  return request(`/api/projects/${projectId}/notes`, {
+    method: "POST",
+    body: JSON.stringify({ content })
+  });
+}
+async function getStats() {
+  return request("/api/stats");
+}
+
+// src/index.ts
+var program = new Command();
+var amber = chalk.hex("#f59e0b");
+var dim = chalk.gray;
+program.name("ct").description(amber("\u{1F451} CrownTrack CLI") + " \u2014 Rule your projects from the terminal").version("0.1.0");
+program.command("projects").description("List all projects").option("-s, --status <status>", "Filter by status").option("-c, --category <category>", "Filter by category").option("-p, --priority <priority>", "Filter by priority").option("--search <query>", "Search by name").option("--tag <tag>", "Filter by tag").action(async (opts) => {
+  try {
+    const projects = await listProjects({
+      status: opts.status,
+      category: opts.category,
+      priority: opts.priority,
+      search: opts.search,
+      tag: opts.tag
+    });
+    if (projects.length === 0) {
+      console.log(dim("No projects found."));
+      return;
+    }
+    const table = new Table({
+      head: [
+        dim("ID"),
+        amber("Name"),
+        "Status",
+        "Priority",
+        "Category",
+        "Actions",
+        "Updated"
+      ],
+      style: { head: [], border: ["gray"] }
+    });
+    for (const p of projects) {
+      const open = p.actions.filter((a) => !a.done).length;
+      const total = p.actions.length;
+      table.push([
+        dim(p.id.slice(0, 8)),
+        p.name,
+        statusColor(p.status),
+        priorityColor(p.priority),
+        p.category || "-",
+        `${total - open}/${total}`,
+        timeAgo(p.updatedAt)
+      ]);
+    }
+    console.log(table.toString());
+    console.log(dim(`
+${projects.length} project(s)`));
+  } catch (e) {
+    handleError(e);
+  }
+});
+program.command("project <id>").description("Show project details").action(async (id) => {
+  try {
+    const p = await resolveProject(id);
+    console.log();
+    console.log(amber("\u{1F451} " + p.name));
+    if (p.description) console.log(dim(p.description));
+    console.log();
+    console.log(
+      `  Status:   ${statusColor(p.status)}  |  Priority: ${priorityColor(p.priority)}  |  Category: ${p.category || "-"}`
+    );
+    if (p.tags) console.log(`  Tags:     ${p.tags.split(",").map((t) => chalk.cyan(`#${t.trim()}`)).join(" ")}`);
+    console.log(`  Created:  ${dim(new Date(p.createdAt).toLocaleDateString())}`);
+    console.log(`  Updated:  ${dim(timeAgo(p.updatedAt))}`);
+    console.log(`  ID:       ${dim(p.id)}`);
+    if (p.actions.length > 0) {
+      console.log(`
+${amber("\u2705 Actions")} (${p.actions.filter((a) => !a.done).length} open / ${p.actions.length} total)`);
+      for (const a of p.actions) {
+        const check = a.done ? chalk.green("\u2713") : chalk.gray("\u25CB");
+        const text = a.done ? dim(a.title) : a.title;
+        console.log(`  ${check} ${text} ${dim(`[${a.id.slice(0, 8)}]`)}`);
+      }
+    }
+    if (p.decisions.length > 0) {
+      console.log(`
+${amber("\u{1F4CB} Decisions")} (${p.decisions.length})`);
+      for (const d of p.decisions) {
+        console.log(`  \u2022 ${d.decision}`);
+        if (d.context) console.log(`    ${dim(d.context)}`);
+        console.log(`    ${dim(new Date(d.date).toLocaleDateString())}`);
+      }
+    }
+    if (p.notes.length > 0) {
+      console.log(`
+${amber("\u{1F4DD} Notes")} (${p.notes.length})`);
+      for (const n of p.notes) {
+        const preview = n.content.length > 100 ? n.content.slice(0, 100) + "..." : n.content;
+        console.log(`  \u2022 ${preview}`);
+        console.log(`    ${dim(new Date(n.createdAt).toLocaleDateString())}`);
+      }
+    }
+    if (p.links.length > 0) {
+      console.log(`
+${amber("\u{1F517} Links")} (${p.links.length})`);
+      for (const l of p.links) {
+        console.log(`  \u2022 ${l.label}: ${chalk.cyan(l.url)}`);
+      }
+    }
+    console.log();
+  } catch (e) {
+    handleError(e);
+  }
+});
+var add = program.command("add").description("Add items");
+add.command("project <name>").description("Create a new project").option("-s, --status <status>", "Status (Idea/Planning/Building/Deployed/Paused)", "Idea").option("-p, --priority <priority>", "Priority (High/Medium/Low)", "Medium").option("-c, --category <category>", "Category (Personal/Professional/Learning/Infrastructure)", "Personal").option("-d, --description <desc>", "Description").option("-t, --tags <tags>", "Tags (comma-separated)").action(async (name, opts) => {
+  try {
+    const project = await createProject({
+      name,
+      description: opts.description,
+      status: opts.status,
+      priority: opts.priority,
+      category: opts.category,
+      tags: opts.tags
+    });
+    console.log(chalk.green("\u2713") + ` Created project: ${amber(project.name)} ${dim(`[${project.id}]`)}`);
+  } catch (e) {
+    handleError(e);
+  }
+});
+add.command("action <project-id> <title>").description("Add an action to a project").option("-p, --priority <priority>", "Priority", "Medium").action(async (projectId, title, opts) => {
+  try {
+    const p = await resolveProject(projectId);
+    const action = await addAction(p.id, title, opts.priority);
+    console.log(chalk.green("\u2713") + ` Added action to ${amber(p.name)}: ${action.title} ${dim(`[${action.id}]`)}`);
+  } catch (e) {
+    handleError(e);
+  }
+});
+add.command("decision <project-id> <decision>").description("Log a decision for a project").option("--context <context>", "Why was this decided?").action(async (projectId, decision, opts) => {
+  try {
+    const p = await resolveProject(projectId);
+    const d = await addDecision(p.id, decision, opts.context);
+    console.log(chalk.green("\u2713") + ` Logged decision for ${amber(p.name)}: ${d.decision} ${dim(`[${d.id}]`)}`);
+  } catch (e) {
+    handleError(e);
+  }
+});
+add.command("note <project-id> <content>").description("Add a note to a project").action(async (projectId, content) => {
+  try {
+    const p = await resolveProject(projectId);
+    const n = await addNote(p.id, content);
+    console.log(chalk.green("\u2713") + ` Added note to ${amber(p.name)} ${dim(`[${n.id}]`)}`);
+  } catch (e) {
+    handleError(e);
+  }
+});
+var complete = program.command("complete").description("Mark items as done");
+complete.command("action <action-id>").description("Mark an action as complete").action(async (actionId) => {
+  try {
+    const projects = await listProjects();
+    let found = false;
+    for (const p of projects) {
+      const action = p.actions.find(
+        (a) => a.id === actionId || a.id.startsWith(actionId)
+      );
+      if (action) {
+        const result = await completeAction(p.id, action.id);
+        console.log(chalk.green("\u2713") + ` Completed: ${dim(result.title)} in ${amber(p.name)}`);
+        found = true;
+        break;
+      }
+    }
+    if (!found) {
+      console.log(chalk.red("\u2715") + ` Action not found: ${actionId}`);
+      process.exit(1);
+    }
+  } catch (e) {
+    handleError(e);
+  }
+});
+var update = program.command("update").description("Update items");
+update.command("project <id>").description("Update project fields").option("-s, --status <status>", "Status").option("-p, --priority <priority>", "Priority").option("-c, --category <category>", "Category").option("-n, --name <name>", "Name").option("-d, --description <desc>", "Description").option("-t, --tags <tags>", "Tags").action(async (id, opts) => {
+  try {
+    const p = await resolveProject(id);
+    const data = {};
+    if (opts.status) data.status = opts.status;
+    if (opts.priority) data.priority = opts.priority;
+    if (opts.category) data.category = opts.category;
+    if (opts.name) data.name = opts.name;
+    if (opts.description) data.description = opts.description;
+    if (opts.tags) data.tags = opts.tags;
+    if (Object.keys(data).length === 0) {
+      console.log(dim("Nothing to update. Use --status, --priority, --category, etc."));
+      return;
+    }
+    const updated = await updateProject(p.id, data);
+    console.log(chalk.green("\u2713") + ` Updated ${amber(updated.name)}`);
+    for (const [k, v] of Object.entries(data)) {
+      console.log(`  ${dim(k)}: ${v}`);
+    }
+  } catch (e) {
+    handleError(e);
+  }
+});
+program.command("stats").description("Show KPI summary").action(async () => {
+  try {
+    const s = await getStats();
+    console.log();
+    console.log(amber("\u{1F451} CrownTrack Stats"));
+    console.log();
+    const projTable = new Table({
+      style: { head: [], border: ["gray"] }
+    });
+    projTable.push(
+      [amber("Total Projects"), String(s.totalProjects)],
+      [amber("Open Actions"), String(s.openActions)],
+      [chalk.green("Completed Actions"), String(s.completedActions)],
+      [s.overdueActions > 0 ? chalk.red("Overdue Actions") : dim("Overdue Actions"), String(s.overdueActions)],
+      [amber("Decisions (Week)"), String(s.decisionsThisWeek)],
+      [amber("Decisions (Month)"), String(s.decisionsThisMonth)]
+    );
+    console.log(projTable.toString());
+    console.log(`
+${amber("Projects by Status:")}`);
+    const statusTable = new Table({
+      head: [dim("Status"), dim("Count"), dim("Bar")],
+      style: { head: [], border: ["gray"] }
+    });
+    const maxCount = Math.max(...Object.values(s.byStatus), 1);
+    const statusEmoji = {
+      Idea: "\u{1F4A1}",
+      Planning: "\u{1F4D0}",
+      Building: "\u{1F528}",
+      Deployed: "\u{1F680}",
+      Paused: "\u23F8\uFE0F"
+    };
+    for (const status of ["Building", "Planning", "Idea", "Deployed", "Paused"]) {
+      const count = s.byStatus[status] || 0;
+      const bar = amber("\u2588".repeat(Math.ceil(count / maxCount * 20)));
+      statusTable.push([
+        `${statusEmoji[status] || ""} ${status}`,
+        String(count),
+        bar
+      ]);
+    }
+    console.log(statusTable.toString());
+    if (Object.keys(s.byCategory).length > 0) {
+      console.log(`
+${amber("Projects by Category:")}`);
+      const catTable = new Table({
+        head: [dim("Category"), dim("Count")],
+        style: { head: [], border: ["gray"] }
+      });
+      for (const [cat, count] of Object.entries(s.byCategory)) {
+        catTable.push([cat, String(count)]);
+      }
+      console.log(catTable.toString());
+    }
+    if (s.staleProjects.length > 0) {
+      console.log(`
+${chalk.red("\u26A0\uFE0F  Stale Projects")} (no updates > 7 days):`);
+      for (const sp of s.staleProjects) {
+        console.log(`  \u2022 ${sp.name} \u2014 ${chalk.red(`${sp.daysSinceUpdate} days`)} since last update`);
+      }
+    } else {
+      console.log(`
+${chalk.green("\u2713")} All active projects updated recently`);
+    }
+    console.log();
+  } catch (e) {
+    handleError(e);
+  }
+});
+async function resolveProject(idOrPrefix) {
+  try {
+    return await getProject(idOrPrefix);
+  } catch {
+    const projects = await listProjects();
+    const matches = projects.filter(
+      (p) => p.id.startsWith(idOrPrefix) || p.name.toLowerCase().includes(idOrPrefix.toLowerCase())
+    );
+    if (matches.length === 1) return matches[0];
+    if (matches.length === 0) {
+      console.log(chalk.red("\u2715") + ` No project found for: ${idOrPrefix}`);
+      process.exit(1);
+    }
+    console.log(chalk.yellow("?") + ` Multiple matches for "${idOrPrefix}":`);
+    for (const m of matches) {
+      console.log(`  ${dim(m.id.slice(0, 8))} ${m.name}`);
+    }
+    process.exit(1);
+  }
+}
+function statusColor(status) {
+  const colors = {
+    Idea: chalk.magenta,
+    Planning: chalk.blue,
+    Building: amber,
+    Deployed: chalk.green,
+    Paused: chalk.gray
+  };
+  return (colors[status] || chalk.white)(status);
+}
+function priorityColor(priority) {
+  const colors = {
+    High: chalk.red,
+    Medium: amber,
+    Low: chalk.green
+  };
+  return (colors[priority] || chalk.white)(priority);
+}
+function timeAgo(dateStr) {
+  const now = Date.now();
+  const then = new Date(dateStr).getTime();
+  const diff = now - then;
+  const mins = Math.floor(diff / 6e4);
+  if (mins < 1) return "just now";
+  if (mins < 60) return `${mins}m ago`;
+  const hours = Math.floor(mins / 60);
+  if (hours < 24) return `${hours}h ago`;
+  const days = Math.floor(hours / 24);
+  if (days < 7) return `${days}d ago`;
+  return `${Math.floor(days / 7)}w ago`;
+}
+function handleError(e) {
+  const msg = e instanceof Error ? e.message : String(e);
+  if (msg.includes("ECONNREFUSED") || msg.includes("fetch failed")) {
+    console.log(chalk.red("\u2715") + " Cannot connect to CrownTrack at " + dim(process.env.CROWNTRACK_URL || "http://localhost:3333"));
+    console.log(dim("  Is the server running? Try: pnpm dev"));
+  } else {
+    console.log(chalk.red("\u2715") + ` Error: ${msg}`);
+  }
+  process.exit(1);
+}
+program.parse();

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@cadiraca/crowntrack-cli",
+  "version": "0.1.0",
+  "description": "👑 CrownTrack CLI — Rule your projects from the terminal",
+  "author": "Carlos Diego Ramírez <cadiraca>",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "crowntrack": "./dist/index.js",
+    "ct": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "project-tracker",
+    "cli",
+    "crowntrack",
+    "productivity"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cadiraca/crowntrack",
+    "directory": "cli"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --target node20 --clean",
+    "prepublishOnly": "npm run build",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "cli-table3": "^0.6.5",
+    "commander": "^13.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.4.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.8.0"
+  }
+}