@phnx-labs/agents-cli 1.22.120 → 1.22.121

package/dist/commands/projects-todo.js

@@ -0,0 +1,132 @@
+import chalk from 'chalk';
+import { setHelpSections } from '../lib/help.js';
+import { listProjectDefs } from '../lib/projects.js';
+import { ADD_PRIORITIES, addQuickTodo, DESCRIPTION_MAX, TITLE_MAX, TITLE_MIN, completeTodo, linearFailure, listQuickTodos, undoTodo, QUICK_TODO_MARKER, TODO_LIST_LIMIT, } from '../lib/quick-todo.js';
+const PRIORITY_WORD = ['', 'urgent', 'high', 'medium', 'low'];
+function todoLine(t) {
+    const facts = [t.project, t.due && `due ${t.due}`, PRIORITY_WORD[t.priority], t.state].filter(Boolean).join(' · ');
+    return `${chalk.bold(t.identifier)}  ${t.title}  ${chalk.gray(facts)}`;
+}
+function issueIdOrExit(raw, json) {
+    const id = raw.trim().toUpperCase();
+    if (!/^[A-Z][A-Z0-9]*-\d+$/.test(id))
+        report({ ok: false, todo: null, message: `Expected a Linear issue identifier like PHNX-123, got "${raw}".` }, json);
+    return id;
+}
+function report(result, json) {
+    if (json)
+        console.log(JSON.stringify(result, null, 2));
+    else if (result.ok)
+        console.log(`${chalk.green(result.message)}${result.todo ? `\n  ${todoLine(result.todo)}` : ''}`);
+    else
+        console.error(chalk.red(result.message));
+    if (!result.ok)
+        process.exit(1);
+}
+export function registerProjectTodoCommands(projects) {
+    const todo = projects
+        .command('todo')
+        .description('Quick to-dos in Linear: add one from a line of text, list yours, mark one done, undo.');
+    const addCmd = todo
+        .command('add <text...>')
+        .description('Create a to-do in Linear from one line: #project, today/tomorrow/mon..sun, ! (high) or !! (urgent).')
+        .option('--project <name>', 'Project: an agents project or a Linear project name')
+        .option('--description <text>', 'Description, shown above the AGI Menu marker')
+        .option('--assignee <name>', 'Assign to a person by name or email (default: you)')
+        .option('--due <date>', 'Due date, YYYY-MM-DD, today or later')
+        .option('--priority <level>', `Priority: ${ADD_PRIORITIES.join(', ')}`)
+        .option('--json', 'Machine-readable result')
+        .action(async (words, opts) => {
+        const { json, ...fields } = opts;
+        report(await addQuickTodo(words.join(' '), { ...fields, defs: listProjectDefs(), now: new Date() }), json);
+    });
+    setHelpSections(addCmd, {
+        examples: `
+      agents projects todo add "Renew npm token #AGI tomorrow !!"
+      agents projects todo add "Draft the Q4 note" --project atlas --due 2026-10-09 --json
+      agents projects todo add "Rotate the share token" --description "Expires Oct 20" --assignee bisma
+      agents projects todo add --json -- "-v flag is ignored by run"    # text starting with "-"
+    `,
+        notes: `
+      Runs linear create: in the active cycle, status Todo, no milestone, no
+      delegate (any agent's queue picks it up), assigned to you unless
+      --assignee names someone, priority none unless set.
+      #name is an agents project (its Linear project) or a Linear project name.
+      A day word or ! / !! counts only at the end of the line (so "Fix the today
+      view" keeps its words); #name counts anywhere. A day word is the next such
+      day, today included. An option beats the same field typed in the line.
+      Refused without creating anything: a title under ${TITLE_MIN} or over ${TITLE_MAX}
+      characters, a due date in the past, a description over ${DESCRIPTION_MAX.toLocaleString('en-US')}
+      characters. The description ends with "${QUICK_TODO_MARKER}", which is how
+      todo list finds it.
+    `,
+    });
+    const listCmd = todo
+        .command('list')
+        .description(`Your open quick to-dos and anything assigned to you due today or overdue (at most ${TODO_LIST_LIMIT}).`)
+        .option('--json', 'Machine-readable result')
+        .action(async (opts) => {
+        let listed;
+        try {
+            listed = await listQuickTodos(new Date());
+        }
+        catch (err) {
+            const error = linearFailure(err);
+            if (opts.json)
+                console.log(JSON.stringify({ todos: [], total: 0, error }, null, 2));
+            else
+                console.error(chalk.red(`Could not read your Linear issues: ${error}`));
+            process.exit(1);
+        }
+        if (opts.json) {
+            console.log(JSON.stringify({ ...listed, error: null }, null, 2));
+            return;
+        }
+        if (listed.todos.length === 0)
+            console.log('Nothing to do: no open quick to-dos, nothing due.');
+        for (const t of listed.todos)
+            console.log(todoLine(t));
+        if (listed.total > listed.todos.length)
+            console.log(chalk.gray(`+${listed.total - listed.todos.length} more in Linear`));
+    });
+    setHelpSections(listCmd, {
+        examples: `
+      agents projects todo list
+      agents projects todo list --json
+    `,
+        notes: `
+      One linear tasks read of your open issues. Due ones come first (earliest due),
+      then the newest quick to-dos. --json: { todos: [{ identifier, url, title,
+      project, due, priority, state, createdAt, quick }], total, error }.
+    `,
+    });
+    todo
+        .command('done <id>')
+        .description('Mark one issue Done in Linear.')
+        .option('--json', 'Machine-readable result')
+        .action(async (raw, opts) => report(await completeTodo(issueIdOrExit(raw, opts.json)), opts.json));
+    const undoCmd = todo
+        .command('undo <id>')
+        .description('Undo the last to-do action: reopen a Done issue, or cancel a quick to-do created moments ago.')
+        .option('--json', 'Machine-readable result')
+        .action(async (raw, opts) => report(await undoTodo(issueIdOrExit(raw, opts.json), new Date()), opts.json));
+    setHelpSections(undoCmd, {
+        examples: `
+      agents projects todo done PHNX-4230
+      agents projects todo undo PHNX-4230     # back to Todo
+    `,
+        notes: `
+      A Done issue goes back to Todo. A quick to-do still open and created in the
+      last 30 seconds is moved to the team's canceled state (linear has no issue
+      archive verb). Anything else is refused rather than silently ignored.
+    `,
+    });
+    setHelpSections(todo, {
+        examples: `
+      agents projects todo add "Renew npm token #AGI tomorrow !!" --json
+      agents projects todo list --json
+      agents projects todo done PHNX-4230 --json
+      agents projects todo undo PHNX-4230 --json
+    `,
+    });
+}

package/dist/commands/projects.d.ts

@@ -1,81 +1,19 @@
-/**
- * `agents projects` — named, multi-repo projects and the progress
- * rollup. Definitions live in `~/.agents/projects/<name>.yaml` (see
- * `lib/projects.ts`); this registers the command tree over them.
- *
- * The headline is `status`: instead of the vague per-agent activity line, it
- * rolls every session up by project (matched on cwd) into one card — agents by
- * lifecycle state, plan completion, open PRs, and tickets in flight.
- */
 import type { Command } from 'commander';
 import { type ProjectDef, type ProjectRepo } from '../lib/projects.js';
 import { type LinearMilestone } from '../lib/linear-project-counts.js';
-/**
- * A path-shaped `agents projects view` argument — `.`, `..`, a `~`-prefixed
- * value, or anything containing a path separator — means "auto-detect the
- * project for this DIRECTORY", not "a project named literally this". A bare
- * token (no separators) stays a project name, exactly as before.
- */
 export declare function looksLikePath(token: string): boolean;
-/** Machine-readable shape of `agents projects view <path> --json`. */
 interface ViewDetection {
-    /** Detected project name, or null when no definition contains the path. */
     name: string | null;
-    /** The detected project's Linear binding; fields are null when unbound. */
     linear: {
         name: string | null;
         projectId: string | null;
     };
-    /** The detected project's repo/monorepo root (home-relative), or null. */
     root: string | null;
 }
-/**
- * Best-effort cwd->project detection for `agents projects view <path>`. Delegates
- * to the shared {@link projectNameForCwd} (def-root containment, longest wins),
- * then reads the matched definition's Linear binding and root so ONE call yields
- * the name AND the Linear projectId. Fail-open: an all-null shape when nothing
- * contains the path — never throws, so a scripted caller stays unscoped rather
- * than crashing. This subsumes the removed `agents projects for-cwd`.
- */
 export declare function detectProjectForPath(cwd: string, defs: ProjectDef[]): ViewDetection;
-/**
- * One compact trailing note for peers that didn't answer the `--fleet`
- * fan-out — unreachable, running an agents-cli too old to carry `projects
- * probe`, or too slow to finish inside the 12s SSH budget. Mirrors
- * `formatUnreachableNote` (activity) with the probe-specific reasons; empty
- * string when everything answered.
- */
 export declare function formatFleetSkippedNote(skipped: string[]): string;
-/**
- * One compact trailing note for peers that DID answer a fan-out but whose
- * payload failed verification — a wrong machine id, a fingerprint that doesn't
- * match the targets we sent, or a malformed row. Deliberately separate from
- * {@link formatFleetSkippedNote}: silence means a peer never ran, while this
- * means it ran and we cannot trust what it reports, which is the worse state.
- * Empty string when every answer verified.
- */
 export declare function formatFleetUnverifiedNote(unverified: string[]): string;
-/**
- * Best-effort `owner/repo` from a repo's origin remote.
- *
- * `stderr: 'ignore'` is load-bearing, not tidiness. A checkout with no origin
- * makes git print `error: No such remote 'origin'` on ITS stderr, which is the
- * terminal's — the catch below never sees it. Absence of a remote is an
- * expected answer here (`undefined`), not something to report.
- */
 export declare function originSlug(cwd: string): string | undefined;
-/**
- * Turn a `--dir` / `--add-dir` value into a `repos[]` row.
- *
- * The slug comes from the DIRECTORY'S OWN origin remote, never from its path:
- * a checkout at `~/src/github.com/muqsitnawaz/agents-cli` whose origin is
- * `phnx-labs/agents-cli` must record the remote it actually pushes to. Pass
- * `slugOverride` for a directory with no origin (a vendored tree, a fresh
- * `git init`).
- *
- * The stored `path` is left for `writeProjectDef` to normalize home-relative,
- * so the same definition re-roots on every machine.
- */
 export declare function projectRepoFromDir(dir: string, slugOverride?: string): {
     ok: true;
     repo: ProjectRepo;
@@ -83,41 +21,18 @@ export declare function projectRepoFromDir(dir: string, slugOverride?: string):
     ok: false;
     error: string;
 };
-/** One `projects list` row, pre-render. */
 export interface ProjectListRow {
     name: string;
     path: string;
     repo: string;
 }
-/**
- * Column widths for `projects list`, sized to the rows actually being printed.
- * Fixed padding was the bug: home-relative roots run past 50 characters, so a
- * hardcoded 32 pushed the repo column off its gridline on every long path.
- * Paths longer than {@link LIST_PATH_MAX} truncate rather than widen the table.
- */
 export declare function computeProjectListWidths(rows: ProjectListRow[]): {
     name: number;
     path: number;
     repo: number;
 };
-/**
- * A milestone's target date as a person would say it — "due tomorrow",
- * "overdue by 3 days", "due Aug 21" — never a raw `2026-08-21` or a duration in
- * hours. Linear stores a calendar date with no timezone, so both sides are
- * compared at LOCAL midnight; parsing `YYYY-MM-DD` with `new Date(str)` would
- * read it as UTC and shift the answer by a day for anyone west of Greenwich.
- */
 export declare function formatMilestoneDue(targetDate: string, nowMs: number): string | undefined;
-/**
- * The milestone block. `status` prints one line — the next checkpoint — because
- * a roll-up across projects has to stay scannable. `view` prints every declared
- * milestone, because "how many are there and when are they due" is the shape of
- * the plan and the reason to open one project.
- *
- * Pure (chalk only) so the layout is testable without a Linear account.
- */
 export declare function formatMilestoneLines(milestones: LinearMilestone[], next: LinearMilestone | undefined, nowMs: number, limit: number): string[];
-/** The `next` card line: what this project is due to hit, and how far along it is. */
 export declare function formatNextMilestone(ms: LinearMilestone, nowMs: number): string;
 export declare function registerProjectsCommands(program: Command): void;
 export {};