@lumoai/cli 1.0.0

package/dist/cli/src/index.js

@@ -0,0 +1,492 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const commander_1 = require("commander");
+const auth_login_1 = require("./commands/auth-login");
+const auth_logout_1 = require("./commands/auth-logout");
+const whoami_1 = require("./commands/whoami");
+const hook_1 = require("./commands/hook");
+const session_attach_1 = require("./commands/session-attach");
+const session_detach_1 = require("./commands/session-detach");
+const session_status_1 = require("./commands/session-status");
+const task_context_1 = require("./commands/task-context");
+const task_create_1 = require("./commands/task-create");
+const task_update_1 = require("./commands/task-update");
+const task_list_1 = require("./commands/task-list");
+const task_show_1 = require("./commands/task-show");
+const task_comment_1 = require("./commands/task-comment");
+const project_list_1 = require("./commands/project-list");
+const milestone_list_1 = require("./commands/milestone-list");
+const milestone_create_1 = require("./commands/milestone-create");
+const milestone_show_1 = require("./commands/milestone-show");
+const milestone_update_1 = require("./commands/milestone-update");
+const milestone_delete_1 = require("./commands/milestone-delete");
+const sprint_create_1 = require("./commands/sprint-create");
+const sprint_list_1 = require("./commands/sprint-list");
+const sprint_show_1 = require("./commands/sprint-show");
+const sprint_update_1 = require("./commands/sprint-update");
+const sprint_delete_1 = require("./commands/sprint-delete");
+const sprint_start_1 = require("./commands/sprint-start");
+const sprint_close_1 = require("./commands/sprint-close");
+const sprint_summary_1 = require("./commands/sprint-summary");
+const sprint_add_1 = require("./commands/sprint-add");
+const sprint_remove_1 = require("./commands/sprint-remove");
+const doc_create_1 = require("./commands/doc-create");
+const doc_update_1 = require("./commands/doc-update");
+const doc_show_1 = require("./commands/doc-show");
+const doc_list_1 = require("./commands/doc-list");
+const doc_delete_1 = require("./commands/doc-delete");
+const doc_bind_1 = require("./commands/doc-bind");
+const doc_unbind_1 = require("./commands/doc-unbind");
+const doc_share_1 = require("./commands/doc-share");
+const doc_unshare_1 = require("./commands/doc-unshare");
+const doc_share_list_1 = require("./commands/doc-share-list");
+const doc_move_1 = require("./commands/doc-move");
+// Resolve package.json relative to __dirname so this works regardless of how
+// deep the compiled output ends up (flat dist/ or nested dist/cli/src/).
+const pkg = require(path.resolve(__dirname, '../../..', 'package.json'));
+(() => {
+    const dir = process.env.LUMO_CONFIG_DIR || path.join(os.homedir(), '.lumo');
+    try {
+        fs.rmSync(path.join(dir, 'current-task.json'), { force: true });
+    }
+    catch { }
+    try {
+        fs.rmSync(path.join(dir, 'sessions'), { recursive: true, force: true });
+    }
+    catch { }
+})();
+const collect = (val, acc) => [...acc, val];
+function wrap(fn) {
+    return async (...args) => {
+        try {
+            const code = await fn(...args);
+            if (typeof code === 'number' && code !== 0)
+                process.exit(code);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`Error: ${msg}`);
+            process.exit(1);
+        }
+    };
+}
+const program = new commander_1.Command()
+    .name('lumo')
+    .description('Lumo CLI — manage tasks and sessions from the terminal')
+    .version(pkg.version);
+const auth = program.command('auth').description('Manage Lumo authentication');
+auth
+    .command('login')
+    .description('Log in to Lumo by pasting an API key')
+    .action(wrap(auth_login_1.authLogin));
+auth
+    .command('logout')
+    .description('Log out and remove local credentials')
+    .action(wrap(auth_logout_1.authLogout));
+program
+    .command('whoami')
+    .description('Show the currently logged-in identity')
+    .action(wrap(whoami_1.whoami));
+const session = program
+    .command('session')
+    .description('Manage per-terminal coding-session context');
+session
+    .command('attach <identifier>')
+    .description('Attach the currently-running Claude Code session (CLAUDE_CODE_SESSION_ID) to a task. Sets Session.taskId server-side and re-tags untagged hook events.')
+    .action(wrap(identifier => (0, session_attach_1.sessionAttach)(identifier)));
+session
+    .command('status')
+    .description('Show the task currently bound to this Claude Code session (or "no task" if none).')
+    .action(wrap(() => (0, session_status_1.sessionStatus)()));
+session
+    .command('detach')
+    .description('Clear the task binding on the current Claude Code session. Past hook events keep their taskId; only future events become untagged.')
+    .action(wrap(() => (0, session_detach_1.sessionDetach)()));
+const task = program
+    .command('task')
+    .description('Inspect tasks from the terminal');
+task
+    .command('context <identifier>')
+    .description('Print a task + prior session summaries as markdown, for pasting into a coding agent on startup.')
+    .action(wrap(identifier => (0, task_context_1.taskContext)(identifier)));
+task
+    .command('list')
+    .description('List tasks assigned to you. Filter with --status, --project, --milestone, --limit.')
+    .option('-s, --status <value>', 'Filter by status: todo | in_progress | in_review | done')
+    .option('-p, --project <ref>', 'Filter by project name (case-insensitive)')
+    .option('-n, --limit <count>', 'Show only the first N tasks')
+    .option('-m, --milestone <ref>', 'Filter by milestone name or UUID (scopes to my tasks under that milestone)')
+    .action(wrap(options => (0, task_list_1.taskList)(options)));
+task
+    .command('show <identifier>')
+    .description('Show a single task: title, status, priority, assignee, project, URL, description.')
+    .action(wrap(identifier => (0, task_show_1.taskShow)(identifier)));
+task
+    .command('comment <identifier> <body>')
+    .description('Add a comment to a task. Body is plain text — quote it to pass spaces or newlines.')
+    .action(wrap((identifier, body) => (0, task_comment_1.taskComment)(identifier, body)));
+task
+    .command('create <title>')
+    .description('Create a task. --project required when workspace has >1 project; defaults: priority=low, assignee=me.')
+    .option('-d, --description <text>', 'Task description')
+    .option('-p, --priority <level>', 'Priority: low | medium | high | urgent (default: low)')
+    .option('-a, --assignee <ref>', 'Assignee email, name, or "me" (default: me)')
+    .option('--project <ref>', 'Project name or slug')
+    .option('--milestone <ref>', 'Milestone name (case-insensitive)')
+    .option('--tag <name>', 'Attach tag by name (repeatable)', collect, [])
+    .option('--tag-id <cuid>', 'Attach tag by id (repeatable)', collect, [])
+    .option('--sprint <ref>', 'Sprint number or UUID to add the task to after creation')
+    .action(wrap((title, options) => (0, task_create_1.taskCreate)(title, options)));
+const projectCmd = program
+    .command('project')
+    .description('Inspect projects from the terminal');
+projectCmd
+    .command('list')
+    .description('List projects in the current workspace. Slug column matches `task create --project <ref>`.')
+    .action(wrap(() => (0, project_list_1.projectList)()));
+const milestoneCmd = program
+    .command('milestone')
+    .description('Inspect milestones from the terminal');
+milestoneCmd
+    .command('list')
+    .description('List milestones for a project. --project required when workspace has >1 project.')
+    .option('--project <ref>', 'Project name or slug')
+    .action(wrap(options => (0, milestone_list_1.milestoneList)(options)));
+milestoneCmd
+    .command('create <name>')
+    .description('Create a milestone. --project required when workspace has >1 project.')
+    .option('--project <ref>', 'Project name or slug')
+    .option('-d, --description <text>', 'Milestone description')
+    .option('--start <date>', 'Start date (YYYY-MM-DD)')
+    .option('--target <date>', 'Target date (YYYY-MM-DD)')
+    .action(wrap((name, options) => (0, milestone_create_1.milestoneCreate)(name, options)));
+milestoneCmd
+    .command('show <identifier>')
+    .description('Show a milestone: status, dates, description, task counts, and tasks under it. Identifier accepts UUID or name.')
+    .option('--project <ref>', 'Project name or slug (when identifier is a name)')
+    .action(wrap((identifier, options) => (0, milestone_show_1.milestoneShow)(identifier, options)));
+milestoneCmd
+    .command('update <identifier>')
+    .description('Update a milestone. Provide at least one of --name, --description, --status, --start, --target. Use "" to clear nullable fields.')
+    .option('--project <ref>', 'Project name or slug (when identifier is a name)')
+    .option('-n, --name <text>', 'New name')
+    .option('-d, --description <text>', 'New description (empty string to clear)')
+    .option('-s, --status <value>', 'New status: planned | active | completed | cancelled')
+    .option('--start <date>', 'Start date YYYY-MM-DD (empty string to clear)')
+    .option('--target <date>', 'Target date YYYY-MM-DD (empty string to clear)')
+    .action(wrap((identifier, options) => (0, milestone_update_1.milestoneUpdate)(identifier, options)));
+milestoneCmd
+    .command('delete <identifier>')
+    .description('Delete a milestone. Tasks under it keep their data (milestoneId is cleared). Requires --yes.')
+    .option('--project <ref>', 'Project name or slug (when identifier is a name)')
+    .option('--yes', 'Required: confirm deletion without TTY prompt')
+    .action(wrap((identifier, options) => (0, milestone_delete_1.milestoneDelete)(identifier, options)));
+const sprintCmd = program
+    .command('sprint')
+    .description('Inspect sprints from the terminal');
+sprintCmd
+    .command('list')
+    .description('List sprints for a team. --team required when workspace has >1 team. Sorted newest first.')
+    .option('--team <ref>', 'Team name or UUID')
+    .option('-s, --status <value>', 'Filter by status: draft | active | closed (case-insensitive)')
+    .option('-n, --limit <count>', 'Show only the first N sprints')
+    .action(wrap(options => (0, sprint_list_1.sprintList)(options)));
+sprintCmd
+    .command('show <identifier>')
+    .description('Show a sprint: status, dates, progress, and tasks. Identifier accepts a sprint number or UUID.')
+    .option('--team <ref>', 'Team name or UUID (when workspace has >1 team)')
+    .action(wrap((identifier, options) => (0, sprint_show_1.sprintShow)(identifier, options)));
+sprintCmd
+    .command('create')
+    .description('Create a draft sprint. --team required when workspace has >1 team. --start and --end (YYYY-MM-DD) required.')
+    .option('--team <ref>', 'Team name or UUID')
+    .option('-n, --name <text>', 'Sprint name (server fills default when omitted)')
+    .option('--start <date>', 'Start date (YYYY-MM-DD)')
+    .option('--end <date>', 'End date (YYYY-MM-DD)')
+    .action(wrap(options => (0, sprint_create_1.sprintCreate)(options)));
+sprintCmd
+    .command('update <identifier>')
+    .description('Update a sprint. Provide at least one of --name, --start, --end. Identifier accepts a sprint number or UUID. Empty strings are rejected — these fields cannot be cleared.')
+    .option('--team <ref>', 'Team name or UUID (when workspace has >1 team)')
+    .option('-n, --name <text>', 'New sprint name')
+    .option('--start <date>', 'New start date (YYYY-MM-DD)')
+    .option('--end <date>', 'New end date (YYYY-MM-DD)')
+    .action(wrap((identifier, options) => (0, sprint_update_1.sprintUpdate)(identifier, options)));
+sprintCmd
+    .command('delete <identifier>')
+    .description('Delete a DRAFT sprint. Requires --yes. Server rejects ACTIVE/CLOSED sprints.')
+    .option('--team <ref>', 'Team name or UUID (informational)')
+    .option('--yes', 'Confirm deletion')
+    .action(wrap((identifier, options) => (0, sprint_delete_1.sprintDelete)(identifier, options)));
+sprintCmd
+    .command('start <identifier>')
+    .description('Transition a DRAFT sprint to ACTIVE.')
+    .option('--team <ref>', 'Team name or UUID (informational)')
+    .action(wrap((identifier, options) => (0, sprint_start_1.sprintStart)(identifier, options)));
+sprintCmd
+    .command('close <identifier>')
+    .description('Close an ACTIVE sprint. With no unfinished tasks, closes immediately. Pass --move-all --yes to move unfinished tasks to the next sprint, or --backlog-all --yes to return them to the backlog.')
+    .option('--team <ref>', 'Team name or UUID (informational)')
+    .option('--move-all', 'Move all unfinished tasks to the next sprint')
+    .option('--backlog-all', 'Return all unfinished tasks to the backlog')
+    .option('--yes', 'Required when --move-all or --backlog-all is set')
+    .action(wrap((identifier, options) => (0, sprint_close_1.sprintClose)(identifier, options)));
+sprintCmd
+    .command('summary <identifier>')
+    .description('Show the AI-generated summary for a sprint. Identifier accepts a sprint number or UUID. Prints "(no summary generated yet)" when none exists. Use --retry to queue regeneration before fetching.')
+    .option('--team <ref>', 'Team name or UUID (when workspace has >1 team)')
+    .option('--retry', 'Trigger summary regeneration before fetching')
+    .action(wrap((identifier, options) => (0, sprint_summary_1.sprintSummary)(identifier, options)));
+sprintCmd
+    .command('add <identifier> <task>')
+    .description('Add a task to a sprint. <task> accepts LUM-N or UUID.')
+    .option('--team <ref>', 'Team name or UUID (informational)')
+    .action(wrap((identifier, task, options) => (0, sprint_add_1.sprintAdd)(identifier, task, options)));
+sprintCmd
+    .command('remove <identifier> <task>')
+    .description('Remove a task from a sprint. <task> accepts LUM-N or UUID.')
+    .option('--team <ref>', 'Team name or UUID (informational)')
+    .action(wrap((identifier, task, options) => (0, sprint_remove_1.sprintRemove)(identifier, task, options)));
+const doc = program.command('doc').description('Manage Lumo documents');
+doc
+    .command('create [title]')
+    .description('Create a new document. Body comes from --content, --file, or piped stdin (pick one). --scope defaults to personal. Use --task LUM-N to bind the new doc to a task, --parent to file it under another doc.')
+    .option('--content <text>', 'Inline markdown content')
+    .option('--file <path>', 'Read markdown content from file')
+    .option('--scope <scope>', 'personal | workspace (default: personal)')
+    .option('--project <ref>', 'Project name or slug to file under')
+    .option('--task <LUM-N>', 'Bind to this task after creation')
+    .option('--parent <doc>', 'File under this parent doc (cuid or title)')
+    .option('--tag <name>', 'Attach tag by name (repeatable)', collect, [])
+    .option('--tag-id <cuid>', 'Attach tag by id (repeatable)', collect, [])
+    .action(wrap((title, opts) => (0, doc_create_1.docCreate)(title, opts)));
+doc
+    .command('update <doc>')
+    .description('Update an existing document. <doc> accepts a cuid or a case-insensitive title (ambiguous titles fail with candidates). Replacement body comes from --content, --file, or piped stdin (pick one). --tag/--tag-id (bulk replace) cannot be combined with --add-tag/--add-tag-id/--remove-tag/--remove-tag-id.')
+    .option('--title <text>', 'New title')
+    .option('--content <text>', 'Replace content (inline)')
+    .option('--file <path>', 'Replace content from file')
+    .option('--scope <scope>', 'personal | workspace')
+    .option('--project <ref>', 'Project name/slug; pass "" to clear')
+    .option('--tag <name>', 'Set tags by name (bulk replace, repeatable)', collect, [])
+    .option('--tag-id <cuid>', 'Set tags by id (bulk replace, repeatable)', collect, [])
+    .option('--add-tag <name>', 'Add tag by name (repeatable)', collect, [])
+    .option('--add-tag-id <cuid>', 'Add tag by id (repeatable)', collect, [])
+    .option('--remove-tag <name>', 'Remove tag by name (repeatable). Unknown names are find-or-create, so prefer --remove-tag-id to avoid orphan rows.', collect, [])
+    .option('--remove-tag-id <cuid>', 'Remove tag by id (repeatable). Unknown ids are a no-op.', collect, [])
+    .action(wrap((reference, opts) => (0, doc_update_1.docUpdate)(reference, opts)));
+doc
+    .command('show <doc>')
+    .description('Show document header and body (doc = title or cuid)')
+    .action(wrap(reference => (0, doc_show_1.docShow)(reference)));
+doc
+    .command('list')
+    .description('List documents visible to the current user')
+    .option('--scope <scope>', 'personal | workspace | all (default: all)')
+    .option('--project <ref>', 'Filter by project name/slug')
+    .option('--task <LUM-N>', 'Only docs bound to this task')
+    .option('--limit <n>', 'Cap output to first N rows')
+    .option('--tree', 'Render as an indented tree')
+    .action(wrap(opts => (0, doc_list_1.docList)(opts)));
+doc
+    .command('move <doc>')
+    .description('Move a doc under a different parent or to top level. Exactly one of --parent or --root is required. The moved doc lands at the end of its new sibling list; reordering among siblings is web-UI only.')
+    .option('--parent <doc>', 'New parent doc (cuid or title)')
+    .option('--root', 'Move to top level (no parent)')
+    .action(wrap((reference, opts) => (0, doc_move_1.docMove)(reference, opts)));
+doc
+    .command('delete <doc>')
+    .description('Delete a document (requires --yes)')
+    .option('--yes', 'Confirm deletion')
+    .action(wrap((reference, opts) => (0, doc_delete_1.docDelete)(reference, opts)));
+doc
+    .command('bind <doc> <task>')
+    .description('Bind a document to a task by adding an EXPLICIT mention row. Idempotent. If a CONTENT-derived mention already exists for the same pair, it is upgraded to EXPLICIT so `doc unbind` can later remove it.')
+    .action(wrap((docRef, task) => (0, doc_bind_1.docBind)(docRef, task)));
+doc
+    .command('unbind <doc> <task>')
+    .description('Unbind a document from a task. Removes EXPLICIT mentions only — purely CONTENT-derived mentions (from @LUM-N in the body) cannot be removed via CLI and fail with 409; edit the doc body in the web UI instead.')
+    .action(wrap((docRef, task) => (0, doc_unbind_1.docUnbind)(docRef, task)));
+doc
+    .command('share <doc> <member>')
+    .description('Share a document with a workspace member. PRIVATE docs are auto-promoted to SHARED. <member> accepts "me", an email, or a display name.')
+    .option('--role <role>', 'viewer | editor | manager (default: viewer)')
+    .action(wrap((docRef, member, opts) => (0, doc_share_1.docShare)(docRef, member, opts)));
+doc
+    .command('unshare <doc> <member>')
+    .description('Remove a member from a document\'s share list. Idempotent — prints "Not shared with …" if no row exists.')
+    .action(wrap((docRef, member) => (0, doc_unshare_1.docUnshare)(docRef, member)));
+doc
+    .command('share-list <doc>')
+    .description('List the members a document is shared with, as fixed-width rows: <displayName>  <ROLE>.')
+    .action(wrap(docRef => (0, doc_share_list_1.docShareList)(docRef)));
+task
+    .command('update <identifier>')
+    .description('Update a task. Provide at least one of --title, --description, --status, --priority, --assignee, --milestone, --sprint, or tag flags. Use "" to clear description, assignee, milestone, or sprint binding. --tag/--tag-id (bulk replace) cannot be combined with --add-tag/--add-tag-id/--remove-tag/--remove-tag-id.')
+    .option('-t, --title <text>', 'New title')
+    .option('-d, --description <text>', 'New description (empty string to clear)')
+    .option('-s, --status <value>', 'New status: todo | in_progress | in_review | done')
+    .option('-p, --priority <level>', 'New priority: low | medium | high | urgent')
+    .option('-a, --assignee <ref>', 'New assignee: email, name, or "me" (empty string to clear)')
+    .option('--milestone <ref>', 'Milestone name (case-insensitive); empty string to unbind')
+    .option('--sprint <ref>', 'Sprint number or UUID to bind the task to; empty string to unbind from current sprint')
+    .option('--tag <name>', 'Set tags by name (bulk replace, repeatable)', collect, [])
+    .option('--tag-id <cuid>', 'Set tags by id (bulk replace, repeatable)', collect, [])
+    .option('--add-tag <name>', 'Add tag by name (repeatable)', collect, [])
+    .option('--add-tag-id <cuid>', 'Add tag by id (repeatable)', collect, [])
+    .option('--remove-tag <name>', 'Remove tag by name (repeatable). Unknown names are find-or-create, so prefer --remove-tag-id to avoid orphan rows.', collect, [])
+    .option('--remove-tag-id <cuid>', 'Remove tag by id (repeatable). Unknown ids are a no-op.', collect, [])
+    .action(wrap((identifier, options) => (0, task_update_1.taskUpdate)(identifier, options)));
+// Claude Code invokes `lumo hook <type>` per tool call, so these handlers
+// must never crash the caller. Two invariants keep us safe:
+//   1. `hookCommand` is stderr-silent and never throws (it catches internally
+//      and routes failures to ~/.lumo/hook.log). That makes `wrap()` a
+//      defensive no-op here — its process.exit(1) branch is unreachable.
+//   2. `./commands/hook` and its transitive imports (`hook-runner`,
+//      `hook-log`, `config`, `api`) must remain side-effect-free at module
+//      scope, so a broken hook never fails at import time either.
+const hook = program
+    .command('hook')
+    .description('Claude Code hook ingestion (invoked by settings.json, not humans)');
+hook
+    .command('pre-tool-use')
+    .description('Forward a PreToolUse hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('pre-tool-use')));
+hook
+    .command('post-tool-use')
+    .description('Forward a PostToolUse hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('post-tool-use')));
+hook
+    .command('post-tool-use-failure')
+    .description('Forward a PostToolUseFailure hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('post-tool-use-failure')));
+hook
+    .command('user-prompt-submit')
+    .description('Forward a UserPromptSubmit hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('user-prompt-submit')));
+hook
+    .command('stop')
+    .description('Forward a Stop hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('stop')));
+hook
+    .command('stop-failure')
+    .description('Forward a StopFailure hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('stop-failure')));
+hook
+    .command('permission-request')
+    .description('Forward a PermissionRequest hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('permission-request')));
+hook
+    .command('permission-denied')
+    .description('Forward a PermissionDenied hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('permission-denied')));
+hook
+    .command('session-start')
+    .description('Forward a SessionStart hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('session-start')));
+hook
+    .command('session-end')
+    .description('Forward a SessionEnd hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('session-end')));
+hook
+    .command('subagent-start')
+    .description('Forward a SubagentStart hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('subagent-start')));
+hook
+    .command('subagent-stop')
+    .description('Forward a SubagentStop hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('subagent-stop')));
+hook
+    .command('worktree-create')
+    .description('Forward a WorktreeCreate hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('worktree-create')));
+hook
+    .command('worktree-remove')
+    .description('Forward a WorktreeRemove hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('worktree-remove')));
+hook
+    .command('file-changed')
+    .description('Forward a FileChanged hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('file-changed')));
+hook
+    .command('config-change')
+    .description('Forward a ConfigChange hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('config-change')));
+hook
+    .command('task-created')
+    .description('Forward a TaskCreated hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('task-created')));
+hook
+    .command('task-completed')
+    .description('Forward a TaskCompleted hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('task-completed')));
+hook
+    .command('post-tool-batch')
+    .description('Forward a PostToolBatch hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('post-tool-batch')));
+hook
+    .command('user-prompt-expansion')
+    .description('Forward a UserPromptExpansion hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('user-prompt-expansion')));
+hook
+    .command('notification')
+    .description('Forward a Notification hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('notification')));
+hook
+    .command('elicitation')
+    .description('Forward an Elicitation hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('elicitation')));
+hook
+    .command('elicitation-result')
+    .description('Forward an ElicitationResult hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('elicitation-result')));
+hook
+    .command('cwd-changed')
+    .description('Forward a CwdChanged hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('cwd-changed')));
+hook
+    .command('instructions-loaded')
+    .description('Forward an InstructionsLoaded hook event to Lumo (reads JSON from stdin)')
+    .action(wrap(() => (0, hook_1.hookCommand)('instructions-loaded')));
+program.parseAsync(process.argv).catch(err => {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(`Error: ${msg}`);
+    process.exit(1);
+});

package/dist/cli/src/lib/api.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveApiUrl = resolveApiUrl;
+exports.trimTrailingSlash = trimTrailingSlash;
+exports.verifyToken = verifyToken;
+const DEFAULT_API_URL = 'https://www.uselumo.ai';
+function resolveApiUrl() {
+    const url = process.env.LUMO_API_URL?.trim();
+    return url && url.length > 0 ? url : DEFAULT_API_URL;
+}
+function trimTrailingSlash(url) {
+    return url.replace(/\/+$/, '');
+}
+async function verifyToken(apiUrl, token) {
+    let res;
+    try {
+        res = await fetch(`${trimTrailingSlash(apiUrl)}/api/auth/verify`, {
+            method: 'GET',
+            headers: { Authorization: `Bearer ${token}` },
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Could not reach Lumo API at ${apiUrl} (${msg})`);
+    }
+    if (res.status === 401) {
+        throw new Error('Invalid or revoked API key');
+    }
+    if (!res.ok) {
+        throw new Error(`Verify failed: HTTP ${res.status}`);
+    }
+    return (await res.json());
+}

package/dist/cli/src/lib/browser.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openBrowser = openBrowser;
+const child_process_1 = require("child_process");
+/**
+ * Open a URL in the default browser (best-effort, non-blocking).
+ * Silent on failure — the user can always copy the URL manually.
+ */
+function openBrowser(url) {
+    const platform = process.platform;
+    let cmd;
+    let args;
+    if (platform === 'darwin') {
+        cmd = 'open';
+        args = [url];
+    }
+    else if (platform === 'win32') {
+        cmd = 'cmd';
+        args = ['/c', 'start', '""', url];
+    }
+    else {
+        cmd = 'xdg-open';
+        args = [url];
+    }
+    try {
+        const child = (0, child_process_1.spawn)(cmd, args, { stdio: 'ignore', detached: true });
+        child.on('error', () => { });
+        child.unref();
+    }
+    catch {
+        // Silent
+    }
+}

package/dist/cli/src/lib/config.js

@@ -0,0 +1,92 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.credentialsPath = credentialsPath;
+exports.readCredentials = readCredentials;
+exports.writeCredentials = writeCredentials;
+exports.deleteCredentials = deleteCredentials;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+function configDir() {
+    return path.join(os.homedir(), '.lumo');
+}
+function credentialsPath() {
+    return path.join(configDir(), 'credentials.json');
+}
+function readCredentials() {
+    const p = credentialsPath();
+    if (!fs.existsSync(p))
+        return null;
+    try {
+        const data = JSON.parse(fs.readFileSync(p, 'utf8'));
+        if (typeof data?.token !== 'string' || typeof data?.apiUrl !== 'string') {
+            return null;
+        }
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+function writeCredentials(creds) {
+    const dir = configDir();
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { mode: 0o700, recursive: true });
+    }
+    else {
+        try {
+            fs.chmodSync(dir, 0o700);
+        }
+        catch {
+            // Best-effort perms tightening; continue if filesystem doesn't support chmod
+        }
+    }
+    const p = credentialsPath();
+    fs.writeFileSync(p, JSON.stringify(creds, null, 2), { mode: 0o600 });
+    try {
+        fs.chmodSync(p, 0o600);
+    }
+    catch {
+        // Best-effort perms tightening
+    }
+}
+function deleteCredentials() {
+    const p = credentialsPath();
+    if (!fs.existsSync(p))
+        return false;
+    fs.unlinkSync(p);
+    return true;
+}