flowcat 1.5.0 → 1.6.1

package/dist/index.mjs

@@ -32260,11 +32260,142 @@ var resolvePackageVersion = async () => {
   }
 };
 
+// outputSchemas.ts
+var outputSchemas = {
+  add: `{
+  task: Task,
+  alias: string
+}`,
+  list: `{
+  selection: "all" | TaskStatus | "today" | "yesterday" | "this_week" | "last_week",
+  tasks: Array<{
+    task: Task,
+    status: TaskStatus,
+    alias: string | null
+  }>
+}`,
+  show: `{
+  task: Task,
+  alias: string | null
+}`,
+  search: `{
+  query: string,
+  tasks: Array<{
+    task: Task,
+    status: TaskStatus,
+    alias: string | null
+  }>
+}`,
+  edit: `{
+  task: Task
+}`,
+  log: `{
+  task: Task
+}`,
+  start: `{
+  task: Task,
+  nextStatus: "active"
+}`,
+  pause: `{
+  task: Task,
+  nextStatus: "paused"
+}`,
+  complete: `{
+  task: Task,
+  nextStatus: "completed"
+}`,
+  cancel: `{
+  task: Task,
+  nextStatus: "cancelled"
+}`,
+  today: `{
+  status: "assigned" | "already_assigned",
+  task: Task,
+  date: string,      // YYYY-MM-DD
+  order?: number     // position in day list (only if status is "assigned")
+}`,
+  "today move": `{
+  status: "moved" | "no_change" | "not_assigned",
+  task: Task,
+  date: string,      // YYYY-MM-DD
+  position?: number  // new position (only if status is "moved" or "no_change")
+}`,
+  untoday: `{
+  status: "unassigned" | "already_unassigned",
+  task: Task,
+  date: string       // YYYY-MM-DD
+}`,
+  "attach-pr": `{
+  status: "attached" | "updated",
+  task: Task
+}`,
+  refresh: `{
+  status: "no_pr" | "refreshed" | "no_change" | "merged" | "closed",
+  task: Task
+}`,
+  init: `{
+  workspace: {
+    workspaceRoot: string,
+    kind: "repo" | "global"
+  }
+}`,
+  where: `{
+  workspace: {
+    root: string,
+    kind: "repo" | "global"
+  }
+}`,
+  "alias reconcile": `{
+  status: "reconciled"
+}`
+};
+var taskTypeDefinition = `
+Task = {
+  id: string,           // T<ULID> or R<ULID>
+  ref: string,          // T-XXXXXX or R-XXXXXX (stable reference)
+  type: "regular" | "review",
+  title: string,
+  status: TaskStatus,
+  created_at: string,   // ISO 8601
+  updated_at: string,   // ISO 8601
+  metadata: {
+    url?: string,
+    pr?: {
+      url: string,
+      owner: string,
+      repo: string,
+      number: number,
+      fetched?: {
+        title: string,
+        state: "open" | "closed" | "merged",
+        merged: boolean,
+        author: string,
+        updated_at: string,
+        fetched_at: string
+      }
+    }
+  },
+  logs: Array<{
+    ts: string,         // ISO 8601
+    msg: string,
+    status?: TaskStatus
+  }>,
+  day_assignments: Array<{
+    date: string,       // YYYY-MM-DD
+    action: "assign" | "unassign",
+    ts: string,         // ISO 8601
+    order?: number
+  }>
+}
+
+TaskStatus = "backlog" | "active" | "paused" | "completed" | "cancelled"
+`;
+
 // index.ts
 var program2 = new Command;
 var helpers = createCliHelpers(program2);
 var packageVersion = await resolvePackageVersion();
-program2.name("flowcat").description("Terminal task manager").option("--store <path>", "explicit workspace path").option("--global", "use global workspace").option("--repo", "use repo workspace").option("--json", "print JSON output").option("--help-all", "display full manual with all commands");
+program2.name("flowcat").description("Terminal task manager").option("--store <path>", "explicit workspace path").option("--global", "use global workspace").option("--repo", "use repo workspace").option("--json", "print JSON output").option("--help-all", "show full help; use <command> --help-all for JSON output schema").configureHelp({ showGlobalOptions: true });
 if (packageVersion) {
   program2.version(packageVersion);
 }
@@ -32304,8 +32435,49 @@ ${"─".repeat(60)}
   return sections.join(`
 `);
 };
+var generateCommandHelpAll = (cmd, cmdPath) => {
+  const sections = [];
+  sections.push(cmd.helpInformation());
+  const schema = outputSchemas[cmdPath];
+  if (schema) {
+    sections.push(`
+JSON Output (--json):`);
+    sections.push(schema.split(`
+`).map((line) => `  ${line}`).join(`
+`));
+    sections.push(`
+Type Definitions:`);
+    sections.push(taskTypeDefinition.trim().split(`
+`).map((line) => `  ${line}`).join(`
+`));
+  }
+  return sections.join(`
+`);
+};
+var findCommand = (program3, args) => {
+  let current = program3;
+  const pathParts = [];
+  for (const arg of args) {
+    if (arg.startsWith("-"))
+      continue;
+    const sub = current.commands.find((c) => c.name() === arg || c.aliases().includes(arg));
+    if (!sub)
+      break;
+    current = sub;
+    pathParts.push(sub.name());
+  }
+  if (pathParts.length === 0)
+    return null;
+  return { cmd: current, path: pathParts.join(" ") };
+};
 if (process.argv.includes("--help-all")) {
-  process.stdout.write(generateFullHelp(program2));
+  const argsBeforeFlag = process.argv.slice(2, process.argv.indexOf("--help-all"));
+  const found = findCommand(program2, argsBeforeFlag);
+  if (found) {
+    process.stdout.write(generateCommandHelpAll(found.cmd, found.path));
+  } else {
+    process.stdout.write(generateFullHelp(program2));
+  }
   process.exit(0);
 }
 if (process.argv.length <= 2) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flowcat",
-  "version": "1.5.0",
+  "version": "1.6.1",
   "type": "module",
   "repository": {
     "type": "git",
@@ -9,7 +9,7 @@
   },
   "bin": {
     "flowcat": "dist/index.mjs",
-    "fc": "dist/fc.mjs"
+    "fcat": "dist/fcat.mjs"
   },
   "files": [
     "dist",