@doist/twist-cli 2.36.3 → 2.36.4

package/dist/lib/skills/content.d.ts

@@ -3,6 +3,6 @@ export declare const SKILL_DESCRIPTION = "Twist messaging CLI. View and respond
 export declare const SKILL_AUTHOR = "Doist";
 export declare const SKILL_LICENSE = "MIT";
 export declare const SKILL_VERSION: string;
-export declare const SKILL_CONTENT = "# Twist CLI (tw)\n\nAccess Twist messaging via the `tw` CLI. Use when the user asks about their Twist workspaces, threads, messages, or wants to interact with Twist in any way.\n\n## Setup\n\n```bash\ntw auth login                    # OAuth login (opens browser, read-write)\ntw auth login --read-only        # OAuth login with read-only scope\ntw auth token                    # Save API token manually (prompts securely; scope unknown, assumed write-capable)\ntw auth status                   # Verify authentication + show mode\ntw auth status --json            # JSON output: { id, email, name }\ntw auth logout                   # Remove saved token and auth metadata\ntw workspaces                    # List available workspaces\ntw workspace use <ref>           # Set current workspace\ntw completion install            # Install shell completions\ntw config view                   # Show the current CLI configuration file (token masked)\ntw config set <key> <value>      # Set a user preference (e.g. unarchive-new-threads true)\ntw doctor                        # Diagnose CLI setup and environment issues\ntw update                        # Update CLI to latest version\ntw changelog                     # Show recent changelog entries\n```\n\nStored auth uses the system credential manager when available. If secure storage is unavailable, `tw` warns and falls back to `~/.config/twist-cli/config.json`. `TWIST_API_TOKEN` always takes priority over the stored token, and legacy plaintext config tokens are migrated automatically when secure storage is available.\n\nIn read-only mode (`tw auth login --read-only`), commands that modify Twist data (reply, archive, react, delete, etc.) are blocked by the CLI. Externally provided tokens (`TWIST_API_TOKEN` or `tw auth token`) are treated as unknown scope and assumed write-capable.\n\n## View by URL\n\n```bash\ntw view <url>                    # View any Twist entity by URL\n```\n\nRoutes automatically based on URL structure:\n- Message URL \u2192 `tw msg view`\n- Conversation URL \u2192 `tw conversation view`\n- Thread+comment URL \u2192 `tw thread view` (comment ID extracted from URL)\n- Thread URL \u2192 `tw thread view`\n\nAll target command flags pass through (e.g. `--json`, `--raw`, `--full`).\n\n## Inbox\n\n```bash\ntw inbox                         # Show inbox threads\ntw inbox --unread                # Only unread threads\ntw inbox --archive-filter all      # Show active + done threads\ntw inbox --archive-filter archived # Show only done threads\ntw inbox --channel <filter>      # Filter by channel name (fuzzy)\ntw inbox --since <date>          # Filter by date (ISO format)\ntw inbox --limit <n>             # Max items (default: 50)\n```\n\n## Threads\n\n```bash\ntw thread <thread-ref>           # View thread (shorthand for view)\ntw thread view <thread-ref>      # View thread with comments\ntw thread view <ref> --comment <id> # View a specific comment\ntw thread view <url-with-/c/id>  # Comment ID extracted from URL\ntw thread view <ref> --unread    # Show only unread comments\ntw thread view <ref> --context 3 # Include 3 read comments before unread\ntw thread view <ref> --limit 20  # Limit number of comments\ntw thread view <ref> --since <date> # Comments newer than date\ntw thread view <ref> --raw       # Show raw markdown\ntw thread create <channel-ref> \"Title\" \"content\"    # Create a new thread\ntw thread create <channel-ref> \"Title\" \"content\" --json       # Create and return as JSON\ntw thread create <channel-ref> \"Title\" \"content\" --json --full # Include all thread fields\ntw thread create <channel-ref> \"Title\" \"content\" --notify 123,456  # Notify specific users\ntw thread create <channel-ref> \"Title\" \"content\" --unarchive  # Land thread in author's Inbox (overrides default Twist auto-archive)\ntw thread create <channel-ref> \"Title\" \"content\" --no-unarchive  # Force archive even when userSettings.unarchiveNewThreads=true\ntw thread create <channel-ref> \"Title\" \"content\" --dry-run  # Preview without posting\ntw thread reply <ref> \"content\"  # Post a comment (notifies EVERYONE_IN_THREAD by default)\ntw thread reply <ref> \"content\" --notify EVERYONE  # Notify all workspace members\ntw thread reply <ref> \"content\" --notify 123,id:456   # Notify specific user IDs\ntw thread reply <ref> \"content\" --json  # Post and return comment as JSON\ntw thread reply <ref> \"content\" --json --full  # Include all comment fields\ntw thread reply <ref> \"content\" --close       # Reply and close the thread\ntw thread reply <ref> \"content\" --reopen      # Reply and reopen a closed thread\ntw thread done <ref>             # Archive thread (mark done)\ntw thread done <ref> --json      # Archive and return status as JSON\ntw thread mute <ref>             # Mute thread for 60 minutes (default)\ntw thread mute <ref> --minutes 480  # Mute for custom duration\ntw thread mute <ref> --json      # Mute and return { id, mutedUntil } as JSON\ntw thread mute <ref> --json --full  # Mute and return full thread as JSON\ntw thread unmute <ref>           # Unmute a muted thread\ntw thread unmute <ref> --json    # Unmute and return { id, mutedUntil } as JSON\ntw thread delete <ref>             # Preview thread deletion (requires --yes to execute)\ntw thread delete <ref> --yes       # Permanently delete a thread\ntw thread delete <ref> --yes --json # Delete and return status as JSON\ntw thread rename <ref> \"New title\"  # Rename a thread (change its title)\ntw thread rename <ref> \"New title\" --json  # Rename and return { id, title } as JSON\ntw thread rename <ref> \"New title\" --json --full  # Rename and return full thread as JSON\ntw thread update <ref> \"New body\"   # Update a thread's body (the first post)\necho \"New body\" | tw thread update <ref>  # Update body from stdin\ntw thread update <ref> \"New body\" --dry-run  # Preview without updating\ntw thread update <ref> \"New body\" --json  # Update and return { id, content } as JSON\ntw thread update <ref> \"New body\" --json --full  # Update and return full thread as JSON\n```\n\nDefault `--notify` for reply is EVERYONE_IN_THREAD, which may notify more people than intended. Before posting, confirm with the user whether specific people should be notified instead (via `--notify <user-ids>`). Options: EVERYONE, EVERYONE_IN_THREAD, or comma-separated ID refs.\n\n`--notify` automatically resolves IDs: group IDs are routed to the `groups` API field, user IDs to `recipients`. No special syntax needed.\n\n## Thread Comments\n\n```bash\ntw comment <comment-ref>                       # View a comment (shorthand for view)\ntw comment view <comment-ref>                  # View a single thread comment\ntw comment view <comment-ref> --raw            # Show raw markdown\ntw comment view <comment-ref> --json           # Output as JSON\ntw comment view <comment-ref> --ndjson         # Output as newline-delimited JSON\ntw comment view <comment-ref> --json --full    # Include all fields in JSON output\ntw comment update <comment-ref> \"new content\"  # Update a thread comment\ntw comment update <comment-ref> \"content\" --json  # Update and return updated comment as JSON\ntw comment update <comment-ref> \"content\" --json --full  # Include all comment fields\ntw comment delete <comment-ref>                # Delete a thread comment\ntw comment delete <comment-ref> --json         # Delete and return status as JSON\n```\n\n## Conversations (DMs/Groups)\n\n```bash\ntw conversation unread                    # List unread conversations\ntw conversation <conversation-ref>        # View conversation (shorthand for view)\ntw conversation view <conversation-ref>   # View conversation messages\ntw conversation with <user-ref>           # Find your 1:1 DM with a user\ntw conversation with <user-ref> --snippet # Include the latest message preview\ntw conversation with <user-ref> --include-groups # List any conversations with that user\ntw conversation reply <ref> \"content\"     # Send a message\ntw conversation reply <ref> \"content\" --json  # Send and return message as JSON\ntw conversation reply <ref> \"content\" --json --full  # Include all message fields\ntw conversation done <ref>                # Archive conversation\ntw conversation done <ref> --json         # Archive and return status as JSON\ntw conversation mute <ref>               # Mute conversation for 60 minutes (default)\ntw conversation mute <ref> --minutes 480 # Mute for custom duration\ntw conversation mute <ref> --json        # Mute and return { id, mutedUntil } as JSON\ntw conversation mute <ref> --json --full # Mute and return full conversation as JSON\ntw conversation unmute <ref>             # Unmute a muted conversation\ntw conversation unmute <ref> --json      # Unmute and return { id, mutedUntil } as JSON\n```\n\nAlias: `tw convo` works the same as `tw conversation`.\n\n## Conversation Messages\n\n```bash\ntw msg <message-ref>             # View a message (shorthand for view)\ntw msg view <message-ref>        # View a single conversation message\ntw msg update <ref> \"content\"    # Edit a conversation message\ntw msg update <ref> \"content\" --json  # Edit and return updated message as JSON\ntw msg update <ref> \"content\" --json --full  # Include all message fields\ntw msg delete <ref>              # Delete a conversation message\ntw msg delete <ref> --json       # Delete and return status as JSON\n```\n\nAlias: `tw message` works the same as `tw msg`.\n\n## Search\n\n```bash\ntw mentions                      # Show content mentioning current user\ntw mentions --since 2026-04-01 --all # Fetch every mention since a date\ntw mentions --type threads --json # Limit mentions to threads\ntw search \"query\"                # Search content\ntw search \"query\" --type threads # Filter: threads, messages, or all\ntw search \"query\" --author <ref> # Filter by author\ntw search \"query\" --to <ref>     # Messages sent to user\ntw search \"query\" --title-only   # Search thread titles only\ntw search \"query\" --mention-me   # Results mentioning current user\ntw search \"query\" --conversation <refs> # Limit to conversations (comma-separated refs)\ntw search \"query\" --since <date> # Content from date\ntw search \"query\" --until <date> # Content until date\ntw search \"query\" --channel <refs> # Filter by channel refs (comma-separated)\ntw search \"query\" --limit <n>    # Max results (default: 50)\ntw search \"query\" --cursor <cur> # Pagination cursor\ntw search \"query\" --all          # Fetch all result pages\n```\n\n## Users, Channels & Groups\n\n```bash\ntw user                          # Show current user info\ntw user --json                   # JSON output\ntw user --json --full            # Include all fields in JSON output\ntw users                         # List workspace users\ntw users --search <text>         # Filter by name/email\ntw channels                      # List active joined workspace channels (alias of: tw channel list)\ntw channels --state all          # Include archived joined channels too\ntw channels --scope discoverable # Active public channels you can see but have not joined\ntw channels --scope public --state all --json # All visible public channels, with joined status\ntw channel threads <channel-ref>  # List threads in a channel (fuzzy name, id:, numeric ID, or URL)\ntw channel threads \"general\" --unread       # Only unread threads\ntw channel threads <ref> --archive-filter all  # Include archived threads (active|archived|all)\ntw channel threads <ref> --since 2026-01-01 # Filter by last-updated date (ISO)\ntw channel threads <ref> --limit 20         # Max threads per page (default: 50)\ntw channel threads <ref> --limit 20 --cursor <cursor-from-prev> # Paginate\ntw channel threads <ref> --json  # { results, nextCursor } with isUnread + url\ntw groups                        # List workspace groups\ntw groups --search \"frontend\"    # Filter groups by name (case-insensitive)\ntw groups --json                 # JSON output\ntw groups --json --full          # Include all fields in JSON output\ntw groups view <group-ref>       # Show group with member details\ntw groups view <ref> --json      # JSON output with id, name, workspaceId, members\ntw groups view <ref> --json --full  # Include all fields in JSON output\ntw groups create \"Name\"          # Create a new group\ntw groups create \"Name\" --users alice@doist.com,bob@doist.com  # Create with members\ntw groups create \"Name\" --json   # Output created group as JSON\ntw groups rename <group-ref> \"New name\"  # Rename a group\ntw groups rename <ref> \"Name\" --json     # Output renamed group as JSON\ntw groups delete <group-ref> --yes       # Delete a group (requires --yes)\ntw groups delete <ref> --dry-run         # Preview deletion\ntw groups add-user <group-ref> user1 user2   # Add users to a group\ntw groups add-user <ref> a@d.com,b@d.com     # Comma-separated refs\ntw groups add-user <ref> id:123 --json       # Output result as JSON\ntw groups remove-user <group-ref> user1 user2  # Remove users from a group\ntw groups remove-user <ref> id:123,id:456      # Comma-separated ID refs\n```\n\nIf a channel is not found in `tw channels`, widen with broader listings such as `tw channels --scope public`, then `tw channels --scope public --state all`. Check `tw channels --help` for other available filters.\n\n`tw channel threads` returns every thread in the channel; pagination filters (`--limit`, `--cursor`, `--since`, `--until`, `--unread`) are applied client-side after fetch. `--archive-filter` is applied server-side. Results are sorted newest-first by last activity. In `--json` / `--ndjson`, the response includes a `nextCursor` string (opaque) you can pass via `--cursor` to fetch the next page; NDJSON emits the cursor as a final `{ \"_meta\": true, \"nextCursor\": \"...\" }` line.\n\n## Away Status\n\n```bash\ntw away                          # Show current away status\ntw away set <type> [until]       # Set away (type: vacation, parental, sickleave, other)\ntw away set vacation 2026-03-20  # Away until March 20\ntw away set vacation 2026-03-20 --from 2026-03-15  # Custom start date\ntw away clear                    # Clear away status\n```\n\n## Reactions\n\n```bash\ntw react thread <ref> \uD83D\uDC4D         # Add reaction to thread\ntw react comment <ref> +1        # Add reaction (shortcode)\ntw react message <ref> heart     # Add reaction to DM message\ntw react thread <ref> \uD83D\uDC4D --json  # Output result as JSON\ntw unreact thread <ref> \uD83D\uDC4D       # Remove reaction\ntw unreact thread <ref> \uD83D\uDC4D --json # Output result as JSON\n```\n\nSupported shortcodes: +1, -1, heart, tada, smile, laughing, thinking, fire, check, x, eyes, pray, clap, rocket, wave\n\n## Shell Completions\n\n```bash\ntw completion install            # Install tab completions (prompts for shell)\ntw completion install bash       # Install for specific shell\ntw completion install zsh\ntw completion install fish\ntw completion uninstall          # Remove completions\n```\n\n### Diagnostics\n\n```bash\ntw doctor                        # Run local + network diagnostics\ntw doctor --offline              # Skip Twist and npm network checks\ntw doctor --json                 # JSON output with per-check results\n```\n\n### Configuration\n\n```bash\ntw config view                   # Pretty-printed config, token masked, labels actual token source\ntw config view --json            # Raw JSON, token masked\ntw config view --show-token      # Include the full token\ntw config set unarchive-new-threads true   # Persist: always unarchive new threads so they land in your Inbox\ntw config set unarchive-new-threads false  # Persist: keep Twist's default (thread auto-archived for author)\n```\n\nUser preferences are stored under `userSettings` in the config file. Currently supported keys: `unarchive-new-threads`. The flag on `tw thread create` (`--unarchive` / `--no-unarchive`) overrides this default per-invocation.\n\n### Update\n\n```bash\ntw update                        # Update CLI to latest version\ntw update --check                # Check for updates without installing, show channel\ntw update --channel              # Show current update channel\ntw update switch --stable        # Switch to stable release channel\ntw update switch --pre-release   # Switch to pre-release (next) channel\n```\n\n### Changelog\n```bash\ntw changelog                     # Show last 5 versions\ntw changelog -n 3                # Show last 3 versions\ntw changelog --count 10          # Show last 10 versions\n```\n\n## Global Options\n\n```bash\n--no-spinner       # Disable loading animations\n--progress-jsonl   # Machine-readable progress events (JSONL to stderr)\n--accessible       # Add text labels to color-coded output (also: TW_ACCESSIBLE=1)\n--non-interactive  # Disable interactive prompts (auto-detected when stdin is not a TTY)\n--interactive      # Force interactive mode even when stdin is not a TTY\n```\n\n## Output Formats\n\nAll list/view commands support:\n\n```bash\n--json    # Output as JSON\n--ndjson  # Output as newline-delimited JSON (for streaming)\n--full    # Include all fields (default shows essential fields only)\n```\n\n## Dry Run\n\nMutating commands accept `--dry-run` to preview the operation without making the change. Where a command performs pre-flight validation (e.g. fetching the target thread to check channel access or ownership), those checks still run in dry-run \u2014 only the mutating write is skipped. Commands that have no pre-flight validation parse the reference and print the preview without hitting the API. The preview is structured:\n\n```\n[dry-run] Would <action>:\n  <Key>: <resolved value>\n  ...\nRun without --dry-run to execute.\n```\n\n## Reference System\n\nCommands accept flexible references:\n- **Numeric IDs**: `123` or `id:123`\n- **Twist URLs**: Full `https://twist.com/...` URLs (parsed automatically)\n- **Fuzzy names**: For workspaces/users - `\"My Workspace\"` or partial matches\n\n## Piping Content\n\nCommands that accept content (`thread create`, `thread reply`, `comment update`, `conversation reply`, `msg update`) auto-detect piped stdin:\n\n```bash\ncat notes.md | tw thread reply <ref>\ntw thread create <channel-ref> \"Title\" < body.md\necho \"Quick reply\" | tw conversation reply <ref>\n```\n\nIf no content argument is provided and no stdin is piped, the CLI opens `$EDITOR` for interactive input. In non-TTY environments (e.g. when called by an agent or in a pipeline), the editor is automatically skipped and the command fails fast with an actionable error message. Use `--non-interactive` to force this behavior even in a TTY, or `--interactive` to override auto-detection.\n\n## Common Workflows\n\n**View by URL (auto-routes to the right command):**\n```bash\ntw view https://twist.com/a/1585/ch/100/t/200          # View thread\ntw view https://twist.com/a/1585/ch/100/t/200/c/300     # View comment\ntw view https://twist.com/a/1585/msg/400                 # View conversation\ntw view https://twist.com/a/1585/msg/400/m/500 --json    # View message as JSON\n```\n\n**Check inbox and respond:**\n```bash\ntw inbox --unread --json\ntw thread view <id> --unread\ntw thread reply <id> \"Thanks, I'll look into this.\"\ntw thread done <id>\n```\n\n**Search and review:**\n```bash\ntw mentions --since 2026-04-01 --all --json\ntw search \"deployment\" --type threads --json\ntw thread view <thread-id>\n```\n\n**Check DMs:**\n```bash\ntw conversation unread --json\ntw conversation view <conversation-id>\ntw conversation with \"Alice Example\"\ntw conversation reply <id> \"Got it, thanks!\"\n```\n";
+export declare const SKILL_CONTENT = "# Twist CLI (tw)\n\nAccess Twist messaging via the `tw` CLI. Use when the user asks about their Twist workspaces, threads, messages, or wants to interact with Twist in any way.\n\n## Setup\n\n```bash\ntw auth login                    # OAuth login (opens browser, read-write)\ntw auth login --read-only        # OAuth login with read-only scope\ntw auth login --callback-port <n># Override the local OAuth callback port (default 8766)\ntw auth login --json             # Emit a JSON envelope for scripted / agent use\ntw auth login --ndjson           # Emit an NDJSON envelope for scripted / agent use\ntw auth token                    # Save API token manually (prompts securely; scope unknown, assumed write-capable)\ntw auth status                   # Verify authentication + show mode\ntw auth status --json            # Full status payload as JSON (--ndjson also supported)\ntw auth logout                   # Remove saved token and auth metadata\ntw auth logout --json            # Emits `{\"ok\": true}` (--ndjson is silent)\ntw workspaces                    # List available workspaces\ntw workspace use <ref>           # Set current workspace\ntw completion install            # Install shell completions\ntw config view                   # Show the current CLI configuration file (token masked)\ntw config set <key> <value>      # Set a user preference (e.g. unarchive-new-threads true)\ntw doctor                        # Diagnose CLI setup and environment issues\ntw update                        # Update CLI to latest version\ntw changelog                     # Show recent changelog entries\n```\n\nStored auth uses the system credential manager when available. If secure storage is unavailable, `tw` warns and falls back to `~/.config/twist-cli/config.json`. `TWIST_API_TOKEN` always takes priority over the stored token, and legacy plaintext config tokens are migrated automatically when secure storage is available.\n\nIn read-only mode (`tw auth login --read-only`), commands that modify Twist data (reply, archive, react, delete, etc.) are blocked by the CLI. Externally provided tokens (`TWIST_API_TOKEN` or `tw auth token`) are treated as unknown scope and assumed write-capable.\n\n## View by URL\n\n```bash\ntw view <url>                    # View any Twist entity by URL\n```\n\nRoutes automatically based on URL structure:\n- Message URL \u2192 `tw msg view`\n- Conversation URL \u2192 `tw conversation view`\n- Thread+comment URL \u2192 `tw thread view` (comment ID extracted from URL)\n- Thread URL \u2192 `tw thread view`\n\nAll target command flags pass through (e.g. `--json`, `--raw`, `--full`).\n\n## Inbox\n\n```bash\ntw inbox                         # Show inbox threads\ntw inbox --unread                # Only unread threads\ntw inbox --archive-filter all      # Show active + done threads\ntw inbox --archive-filter archived # Show only done threads\ntw inbox --channel <filter>      # Filter by channel name (fuzzy)\ntw inbox --since <date>          # Filter by date (ISO format)\ntw inbox --limit <n>             # Max items (default: 50)\n```\n\n## Threads\n\n```bash\ntw thread <thread-ref>           # View thread (shorthand for view)\ntw thread view <thread-ref>      # View thread with comments\ntw thread view <ref> --comment <id> # View a specific comment\ntw thread view <url-with-/c/id>  # Comment ID extracted from URL\ntw thread view <ref> --unread    # Show only unread comments\ntw thread view <ref> --context 3 # Include 3 read comments before unread\ntw thread view <ref> --limit 20  # Limit number of comments\ntw thread view <ref> --since <date> # Comments newer than date\ntw thread view <ref> --raw       # Show raw markdown\ntw thread create <channel-ref> \"Title\" \"content\"    # Create a new thread\ntw thread create <channel-ref> \"Title\" \"content\" --json       # Create and return as JSON\ntw thread create <channel-ref> \"Title\" \"content\" --json --full # Include all thread fields\ntw thread create <channel-ref> \"Title\" \"content\" --notify 123,456  # Notify specific users\ntw thread create <channel-ref> \"Title\" \"content\" --unarchive  # Land thread in author's Inbox (overrides default Twist auto-archive)\ntw thread create <channel-ref> \"Title\" \"content\" --no-unarchive  # Force archive even when userSettings.unarchiveNewThreads=true\ntw thread create <channel-ref> \"Title\" \"content\" --dry-run  # Preview without posting\ntw thread reply <ref> \"content\"  # Post a comment (notifies EVERYONE_IN_THREAD by default)\ntw thread reply <ref> \"content\" --notify EVERYONE  # Notify all workspace members\ntw thread reply <ref> \"content\" --notify 123,id:456   # Notify specific user IDs\ntw thread reply <ref> \"content\" --json  # Post and return comment as JSON\ntw thread reply <ref> \"content\" --json --full  # Include all comment fields\ntw thread reply <ref> \"content\" --close       # Reply and close the thread\ntw thread reply <ref> \"content\" --reopen      # Reply and reopen a closed thread\ntw thread done <ref>             # Archive thread (mark done)\ntw thread done <ref> --json      # Archive and return status as JSON\ntw thread mute <ref>             # Mute thread for 60 minutes (default)\ntw thread mute <ref> --minutes 480  # Mute for custom duration\ntw thread mute <ref> --json      # Mute and return { id, mutedUntil } as JSON\ntw thread mute <ref> --json --full  # Mute and return full thread as JSON\ntw thread unmute <ref>           # Unmute a muted thread\ntw thread unmute <ref> --json    # Unmute and return { id, mutedUntil } as JSON\ntw thread delete <ref>             # Preview thread deletion (requires --yes to execute)\ntw thread delete <ref> --yes       # Permanently delete a thread\ntw thread delete <ref> --yes --json # Delete and return status as JSON\ntw thread rename <ref> \"New title\"  # Rename a thread (change its title)\ntw thread rename <ref> \"New title\" --json  # Rename and return { id, title } as JSON\ntw thread rename <ref> \"New title\" --json --full  # Rename and return full thread as JSON\ntw thread update <ref> \"New body\"   # Update a thread's body (the first post)\necho \"New body\" | tw thread update <ref>  # Update body from stdin\ntw thread update <ref> \"New body\" --dry-run  # Preview without updating\ntw thread update <ref> \"New body\" --json  # Update and return { id, content } as JSON\ntw thread update <ref> \"New body\" --json --full  # Update and return full thread as JSON\n```\n\nDefault `--notify` for reply is EVERYONE_IN_THREAD, which may notify more people than intended. Before posting, confirm with the user whether specific people should be notified instead (via `--notify <user-ids>`). Options: EVERYONE, EVERYONE_IN_THREAD, or comma-separated ID refs.\n\n`--notify` automatically resolves IDs: group IDs are routed to the `groups` API field, user IDs to `recipients`. No special syntax needed.\n\n## Thread Comments\n\n```bash\ntw comment <comment-ref>                       # View a comment (shorthand for view)\ntw comment view <comment-ref>                  # View a single thread comment\ntw comment view <comment-ref> --raw            # Show raw markdown\ntw comment view <comment-ref> --json           # Output as JSON\ntw comment view <comment-ref> --ndjson         # Output as newline-delimited JSON\ntw comment view <comment-ref> --json --full    # Include all fields in JSON output\ntw comment update <comment-ref> \"new content\"  # Update a thread comment\ntw comment update <comment-ref> \"content\" --json  # Update and return updated comment as JSON\ntw comment update <comment-ref> \"content\" --json --full  # Include all comment fields\ntw comment delete <comment-ref>                # Delete a thread comment\ntw comment delete <comment-ref> --json         # Delete and return status as JSON\n```\n\n## Conversations (DMs/Groups)\n\n```bash\ntw conversation unread                    # List unread conversations\ntw conversation <conversation-ref>        # View conversation (shorthand for view)\ntw conversation view <conversation-ref>   # View conversation messages\ntw conversation with <user-ref>           # Find your 1:1 DM with a user\ntw conversation with <user-ref> --snippet # Include the latest message preview\ntw conversation with <user-ref> --include-groups # List any conversations with that user\ntw conversation reply <ref> \"content\"     # Send a message\ntw conversation reply <ref> \"content\" --json  # Send and return message as JSON\ntw conversation reply <ref> \"content\" --json --full  # Include all message fields\ntw conversation done <ref>                # Archive conversation\ntw conversation done <ref> --json         # Archive and return status as JSON\ntw conversation mute <ref>               # Mute conversation for 60 minutes (default)\ntw conversation mute <ref> --minutes 480 # Mute for custom duration\ntw conversation mute <ref> --json        # Mute and return { id, mutedUntil } as JSON\ntw conversation mute <ref> --json --full # Mute and return full conversation as JSON\ntw conversation unmute <ref>             # Unmute a muted conversation\ntw conversation unmute <ref> --json      # Unmute and return { id, mutedUntil } as JSON\n```\n\nAlias: `tw convo` works the same as `tw conversation`.\n\n## Conversation Messages\n\n```bash\ntw msg <message-ref>             # View a message (shorthand for view)\ntw msg view <message-ref>        # View a single conversation message\ntw msg update <ref> \"content\"    # Edit a conversation message\ntw msg update <ref> \"content\" --json  # Edit and return updated message as JSON\ntw msg update <ref> \"content\" --json --full  # Include all message fields\ntw msg delete <ref>              # Delete a conversation message\ntw msg delete <ref> --json       # Delete and return status as JSON\n```\n\nAlias: `tw message` works the same as `tw msg`.\n\n## Search\n\n```bash\ntw mentions                      # Show content mentioning current user\ntw mentions --since 2026-04-01 --all # Fetch every mention since a date\ntw mentions --type threads --json # Limit mentions to threads\ntw search \"query\"                # Search content\ntw search \"query\" --type threads # Filter: threads, messages, or all\ntw search \"query\" --author <ref> # Filter by author\ntw search \"query\" --to <ref>     # Messages sent to user\ntw search \"query\" --title-only   # Search thread titles only\ntw search \"query\" --mention-me   # Results mentioning current user\ntw search \"query\" --conversation <refs> # Limit to conversations (comma-separated refs)\ntw search \"query\" --since <date> # Content from date\ntw search \"query\" --until <date> # Content until date\ntw search \"query\" --channel <refs> # Filter by channel refs (comma-separated)\ntw search \"query\" --limit <n>    # Max results (default: 50)\ntw search \"query\" --cursor <cur> # Pagination cursor\ntw search \"query\" --all          # Fetch all result pages\n```\n\n## Users, Channels & Groups\n\n```bash\ntw user                          # Show current user info\ntw user --json                   # JSON output\ntw user --json --full            # Include all fields in JSON output\ntw users                         # List workspace users\ntw users --search <text>         # Filter by name/email\ntw channels                      # List active joined workspace channels (alias of: tw channel list)\ntw channels --state all          # Include archived joined channels too\ntw channels --scope discoverable # Active public channels you can see but have not joined\ntw channels --scope public --state all --json # All visible public channels, with joined status\ntw channel threads <channel-ref>  # List threads in a channel (fuzzy name, id:, numeric ID, or URL)\ntw channel threads \"general\" --unread       # Only unread threads\ntw channel threads <ref> --archive-filter all  # Include archived threads (active|archived|all)\ntw channel threads <ref> --since 2026-01-01 # Filter by last-updated date (ISO)\ntw channel threads <ref> --limit 20         # Max threads per page (default: 50)\ntw channel threads <ref> --limit 20 --cursor <cursor-from-prev> # Paginate\ntw channel threads <ref> --json  # { results, nextCursor } with isUnread + url\ntw groups                        # List workspace groups\ntw groups --search \"frontend\"    # Filter groups by name (case-insensitive)\ntw groups --json                 # JSON output\ntw groups --json --full          # Include all fields in JSON output\ntw groups view <group-ref>       # Show group with member details\ntw groups view <ref> --json      # JSON output with id, name, workspaceId, members\ntw groups view <ref> --json --full  # Include all fields in JSON output\ntw groups create \"Name\"          # Create a new group\ntw groups create \"Name\" --users alice@doist.com,bob@doist.com  # Create with members\ntw groups create \"Name\" --json   # Output created group as JSON\ntw groups rename <group-ref> \"New name\"  # Rename a group\ntw groups rename <ref> \"Name\" --json     # Output renamed group as JSON\ntw groups delete <group-ref> --yes       # Delete a group (requires --yes)\ntw groups delete <ref> --dry-run         # Preview deletion\ntw groups add-user <group-ref> user1 user2   # Add users to a group\ntw groups add-user <ref> a@d.com,b@d.com     # Comma-separated refs\ntw groups add-user <ref> id:123 --json       # Output result as JSON\ntw groups remove-user <group-ref> user1 user2  # Remove users from a group\ntw groups remove-user <ref> id:123,id:456      # Comma-separated ID refs\n```\n\nIf a channel is not found in `tw channels`, widen with broader listings such as `tw channels --scope public`, then `tw channels --scope public --state all`. Check `tw channels --help` for other available filters.\n\n`tw channel threads` returns every thread in the channel; pagination filters (`--limit`, `--cursor`, `--since`, `--until`, `--unread`) are applied client-side after fetch. `--archive-filter` is applied server-side. Results are sorted newest-first by last activity. In `--json` / `--ndjson`, the response includes a `nextCursor` string (opaque) you can pass via `--cursor` to fetch the next page; NDJSON emits the cursor as a final `{ \"_meta\": true, \"nextCursor\": \"...\" }` line.\n\n## Away Status\n\n```bash\ntw away                          # Show current away status\ntw away set <type> [until]       # Set away (type: vacation, parental, sickleave, other)\ntw away set vacation 2026-03-20  # Away until March 20\ntw away set vacation 2026-03-20 --from 2026-03-15  # Custom start date\ntw away clear                    # Clear away status\n```\n\n## Reactions\n\n```bash\ntw react thread <ref> \uD83D\uDC4D         # Add reaction to thread\ntw react comment <ref> +1        # Add reaction (shortcode)\ntw react message <ref> heart     # Add reaction to DM message\ntw react thread <ref> \uD83D\uDC4D --json  # Output result as JSON\ntw unreact thread <ref> \uD83D\uDC4D       # Remove reaction\ntw unreact thread <ref> \uD83D\uDC4D --json # Output result as JSON\n```\n\nSupported shortcodes: +1, -1, heart, tada, smile, laughing, thinking, fire, check, x, eyes, pray, clap, rocket, wave\n\n## Shell Completions\n\n```bash\ntw completion install            # Install tab completions (prompts for shell)\ntw completion install bash       # Install for specific shell\ntw completion install zsh\ntw completion install fish\ntw completion uninstall          # Remove completions\n```\n\n### Diagnostics\n\n```bash\ntw doctor                        # Run local + network diagnostics\ntw doctor --offline              # Skip Twist and npm network checks\ntw doctor --json                 # JSON output with per-check results\n```\n\n### Configuration\n\n```bash\ntw config view                   # Pretty-printed config, token masked, labels actual token source\ntw config view --json            # Raw JSON, token masked\ntw config view --show-token      # Include the full token\ntw config set unarchive-new-threads true   # Persist: always unarchive new threads so they land in your Inbox\ntw config set unarchive-new-threads false  # Persist: keep Twist's default (thread auto-archived for author)\n```\n\nUser preferences are stored under `userSettings` in the config file. Currently supported keys: `unarchive-new-threads`. The flag on `tw thread create` (`--unarchive` / `--no-unarchive`) overrides this default per-invocation.\n\n### Update\n\n```bash\ntw update                        # Update CLI to latest version\ntw update --check                # Check for updates without installing, show channel\ntw update --check --json         # Same, JSON envelope\ntw update --check --ndjson       # Same, newline-delimited JSON envelope\ntw update --channel              # Show current update channel\ntw update switch --stable        # Switch to stable release channel\ntw update switch --pre-release   # Switch to pre-release (next) channel\ntw update switch --pre-release --json    # Same, JSON envelope\ntw update switch --pre-release --ndjson  # Same, newline-delimited JSON envelope\n```\n\n### Changelog\n```bash\ntw changelog                     # Show last 5 versions\ntw changelog -n 3                # Show last 3 versions\ntw changelog --count 10          # Show last 10 versions\n```\n\n## Global Options\n\n```bash\n--no-spinner               # Disable loading animations\n--progress-jsonl           # Machine-readable progress events (JSONL to stderr)\n--progress-jsonl=<path>    # Same, but write events to <path> instead of stderr\n--progress-jsonl <path>    # Same as above (space-separated form also accepted)\n--accessible               # Add text labels to color-coded output (also: TW_ACCESSIBLE=1)\n--non-interactive          # Disable interactive prompts (auto-detected when stdin is not a TTY)\n--interactive              # Force interactive mode even when stdin is not a TTY\n```\n\n## Output Formats\n\nAll list/view commands support:\n\n```bash\n--json    # Output as JSON\n--ndjson  # Output as newline-delimited JSON (for streaming)\n--full    # Include all fields (default shows essential fields only)\n```\n\n## Dry Run\n\nMutating commands accept `--dry-run` to preview the operation without making the change. Where a command performs pre-flight validation (e.g. fetching the target thread to check channel access or ownership), those checks still run in dry-run \u2014 only the mutating write is skipped. Commands that have no pre-flight validation parse the reference and print the preview without hitting the API. The preview is structured:\n\n```\n[dry-run] Would <action>:\n  <Key>: <resolved value>\n  ...\nRun without --dry-run to execute.\n```\n\n## Reference System\n\nCommands accept flexible references:\n- **Numeric IDs**: `123` or `id:123`\n- **Twist URLs**: Full `https://twist.com/...` URLs (parsed automatically)\n- **Fuzzy names**: For workspaces/users - `\"My Workspace\"` or partial matches\n\n## Piping Content\n\nCommands that accept content (`thread create`, `thread reply`, `comment update`, `conversation reply`, `msg update`) auto-detect piped stdin:\n\n```bash\ncat notes.md | tw thread reply <ref>\ntw thread create <channel-ref> \"Title\" < body.md\necho \"Quick reply\" | tw conversation reply <ref>\n```\n\nIf no content argument is provided and no stdin is piped, the CLI opens `$EDITOR` for interactive input. In non-TTY environments (e.g. when called by an agent or in a pipeline), the editor is automatically skipped and the command fails fast with an actionable error message. Use `--non-interactive` to force this behavior even in a TTY, or `--interactive` to override auto-detection.\n\n## Common Workflows\n\n**View by URL (auto-routes to the right command):**\n```bash\ntw view https://twist.com/a/1585/ch/100/t/200          # View thread\ntw view https://twist.com/a/1585/ch/100/t/200/c/300     # View comment\ntw view https://twist.com/a/1585/msg/400                 # View conversation\ntw view https://twist.com/a/1585/msg/400/m/500 --json    # View message as JSON\n```\n\n**Check inbox and respond:**\n```bash\ntw inbox --unread --json\ntw thread view <id> --unread\ntw thread reply <id> \"Thanks, I'll look into this.\"\ntw thread done <id>\n```\n\n**Search and review:**\n```bash\ntw mentions --since 2026-04-01 --all --json\ntw search \"deployment\" --type threads --json\ntw thread view <thread-id>\n```\n\n**Check DMs:**\n```bash\ntw conversation unread --json\ntw conversation view <conversation-id>\ntw conversation with \"Alice Example\"\ntw conversation reply <id> \"Got it, thanks!\"\n```\n";
 export declare const SKILL_FILE_CONTENT: string;
 //# sourceMappingURL=content.d.ts.map

package/dist/lib/skills/content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../src/lib/skills/content.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU,cAAc,CAAA;AAErC,eAAO,MAAM,iBAAiB,2TAC8R,CAAA;AAE5T,eAAO,MAAM,YAAY,UAAU,CAAA;AAEnC,eAAO,MAAM,aAAa,QAAQ,CAAA;AAElC,eAAO,MAAM,aAAa,QAAsB,CAAA;AAEhD,eAAO,MAAM,aAAa,wvmBAuXzB,CAAA;AAED,eAAO,MAAM,kBAAkB,QASd,CAAA"}
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../src/lib/skills/content.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU,cAAc,CAAA;AAErC,eAAO,MAAM,iBAAiB,2TAC8R,CAAA;AAE5T,eAAO,MAAM,YAAY,UAAU,CAAA;AAEnC,eAAO,MAAM,aAAa,QAAQ,CAAA;AAElC,eAAO,MAAM,aAAa,QAAsB,CAAA;AAEhD,eAAO,MAAM,aAAa,4joBAiYzB,CAAA;AAED,eAAO,MAAM,kBAAkB,QASd,CAAA"}

package/dist/lib/skills/content.js

@@ -13,10 +13,14 @@ Access Twist messaging via the \`tw\` CLI. Use when the user asks about their Tw
 \`\`\`bash
 tw auth login                    # OAuth login (opens browser, read-write)
 tw auth login --read-only        # OAuth login with read-only scope
+tw auth login --callback-port <n># Override the local OAuth callback port (default 8766)
+tw auth login --json             # Emit a JSON envelope for scripted / agent use
+tw auth login --ndjson           # Emit an NDJSON envelope for scripted / agent use
 tw auth token                    # Save API token manually (prompts securely; scope unknown, assumed write-capable)
 tw auth status                   # Verify authentication + show mode
-tw auth status --json            # JSON output: { id, email, name }
+tw auth status --json            # Full status payload as JSON (--ndjson also supported)
 tw auth logout                   # Remove saved token and auth metadata
+tw auth logout --json            # Emits \`{"ok": true}\` (--ndjson is silent)
 tw workspaces                    # List available workspaces
 tw workspace use <ref>           # Set current workspace
 tw completion install            # Install shell completions
@@ -285,9 +289,13 @@ User preferences are stored under \`userSettings\` in the config file. Currently
 \`\`\`bash
 tw update                        # Update CLI to latest version
 tw update --check                # Check for updates without installing, show channel
+tw update --check --json         # Same, JSON envelope
+tw update --check --ndjson       # Same, newline-delimited JSON envelope
 tw update --channel              # Show current update channel
 tw update switch --stable        # Switch to stable release channel
 tw update switch --pre-release   # Switch to pre-release (next) channel
+tw update switch --pre-release --json    # Same, JSON envelope
+tw update switch --pre-release --ndjson  # Same, newline-delimited JSON envelope
 \`\`\`
 
 ### Changelog
@@ -300,11 +308,13 @@ tw changelog --count 10          # Show last 10 versions
 ## Global Options
 
 \`\`\`bash
---no-spinner       # Disable loading animations
---progress-jsonl   # Machine-readable progress events (JSONL to stderr)
---accessible       # Add text labels to color-coded output (also: TW_ACCESSIBLE=1)
---non-interactive  # Disable interactive prompts (auto-detected when stdin is not a TTY)
---interactive      # Force interactive mode even when stdin is not a TTY
+--no-spinner               # Disable loading animations
+--progress-jsonl           # Machine-readable progress events (JSONL to stderr)
+--progress-jsonl=<path>    # Same, but write events to <path> instead of stderr
+--progress-jsonl <path>    # Same as above (space-separated form also accepted)
+--accessible               # Add text labels to color-coded output (also: TW_ACCESSIBLE=1)
+--non-interactive          # Disable interactive prompts (auto-detected when stdin is not a TTY)
+--interactive              # Force interactive mode even when stdin is not a TTY
 \`\`\`
 
 ## Output Formats

package/dist/lib/skills/content.js.map

@@ -1 +1 @@
-{"version":3,"file":"content.js","sourceRoot":"","sources":["../../../src/lib/skills/content.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,uBAAuB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAErE,MAAM,CAAC,MAAM,UAAU,GAAG,WAAW,CAAA;AAErC,MAAM,CAAC,MAAM,iBAAiB,GAC1B,wTAAwT,CAAA;AAE5T,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAA;AAEnC,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAA;AAElC,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,CAAA;AAEhD,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuX5B,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG;QAC1B,UAAU;eACH,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC;WACrC,aAAa;;YAEZ,YAAY;aACX,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC;;;EAGxC,aAAa,EAAE,CAAA"}
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../../src/lib/skills/content.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,uBAAuB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAErE,MAAM,CAAC,MAAM,UAAU,GAAG,WAAW,CAAA;AAErC,MAAM,CAAC,MAAM,iBAAiB,GAC1B,wTAAwT,CAAA;AAE5T,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAA;AAEnC,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAA;AAElC,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,CAAA;AAEhD,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiY5B,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG;QAC1B,UAAU;eACH,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC;WACrC,aAAa;;YAEZ,YAAY;aACX,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC;;;EAGxC,aAAa,EAAE,CAAA"}

package/dist/lib/spinner.d.ts

@@ -1,24 +1,3 @@
-interface SpinnerOptions {
-    text: string;
-    color?: 'green' | 'yellow' | 'blue' | 'red' | 'gray' | 'cyan' | 'magenta';
-    noSpinner?: boolean;
-}
-export declare function startEarlySpinner(): void;
-export declare function stopEarlySpinner(): void;
-/** For tests only — reset singleton state without stopping */
-export declare function resetEarlySpinner(): void;
-declare class LoadingSpinner {
-    private spinnerInstance;
-    private adopted;
-    start(options: SpinnerOptions): this;
-    succeed(text?: string): void;
-    fail(text?: string): void;
-    stop(): void;
-}
-/**
- * High-level wrapper function for running async operations with a loading spinner.
- * Automatically handles success/failure states and cleanup.
- */
-export declare function withSpinner<T>(options: SpinnerOptions, asyncOperation: () => Promise<T>): Promise<T>;
-export { LoadingSpinner, type SpinnerOptions };
+export type { SpinnerOptions } from '@doist/cli-core';
+export declare const LoadingSpinner: new () => import("@doist/cli-core").LoadingSpinner, withSpinner: <T>(options: import("@doist/cli-core").SpinnerOptions, op: () => Promise<T>) => Promise<T>, startEarlySpinner: (text?: string) => void, stopEarlySpinner: () => void;
 //# sourceMappingURL=spinner.d.ts.map

package/dist/lib/spinner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/lib/spinner.ts"],"names":[],"mappings":"AAIA,UAAU,cAAc;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IACzE,SAAS,CAAC,EAAE,OAAO,CAAA;CACtB;AAOD,wBAAgB,iBAAiB,IAAI,IAAI,CAcxC;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CASvC;AAED,8DAA8D;AAC9D,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAID,cAAM,cAAc;IAChB,OAAO,CAAC,eAAe,CAA+C;IACtE,OAAO,CAAC,OAAO,CAAQ;IAEvB,KAAK,CAAC,OAAO,EAAE,cAAc;IAuB7B,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM;IAcrB,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM;IASlB,IAAI;CAaP;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAC/B,OAAO,EAAE,cAAc,EACvB,cAAc,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACjC,OAAO,CAAC,CAAC,CAAC,CAWZ;AAED,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,CAAA"}
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/lib/spinner.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AASrD,eAAO,MAAQ,cAAc,sDAAE,WAAW,8FAAE,iBAAiB,2BAAE,gBAAgB,YAAY,CAAA"}

package/dist/lib/spinner.js

@@ -1,111 +1,10 @@
-import chalk from 'chalk';
-import yoctoSpinner from 'yocto-spinner';
+import { createSpinner } from '@doist/cli-core';
 import { shouldDisableSpinner } from './global-args.js';
-// ── Early spinner (shown before command module is loaded) ──────────────
-let earlySpinnerInstance = null;
-let originalStdoutWrite = null;
-export function startEarlySpinner() {
-    if (!process.stdout.isTTY || shouldDisableSpinner()) {
-        return;
-    }
-    earlySpinnerInstance = yoctoSpinner({ text: chalk.blue('Loading...') });
-    earlySpinnerInstance.start();
-    // Intercept stdout.write so the spinner auto-stops before any command output
-    originalStdoutWrite = process.stdout.write.bind(process.stdout);
-    process.stdout.write = ((...args) => {
-        stopEarlySpinner();
-        return process.stdout.write(...args);
-    });
-}
-export function stopEarlySpinner() {
-    if (originalStdoutWrite) {
-        process.stdout.write = originalStdoutWrite;
-        originalStdoutWrite = null;
-    }
-    if (earlySpinnerInstance) {
-        earlySpinnerInstance.stop();
-        earlySpinnerInstance = null;
-    }
-}
-/** For tests only — reset singleton state without stopping */
-export function resetEarlySpinner() {
-    earlySpinnerInstance = null;
-    originalStdoutWrite = null;
-}
-// ── LoadingSpinner (used by API calls) ─────────────────────────────────
-class LoadingSpinner {
-    spinnerInstance = null;
-    adopted = false;
-    start(options) {
-        // Don't show spinner in non-interactive environments, when disabled via options, or when JSON output is expected
-        if (!process.stdout.isTTY || options.noSpinner || shouldDisableSpinner()) {
-            return this;
-        }
-        // If an early spinner is running, adopt it instead of creating a new one
-        if (earlySpinnerInstance) {
-            this.spinnerInstance = earlySpinnerInstance;
-            this.spinnerInstance.text = chalk[options.color || 'blue'](options.text);
-            earlySpinnerInstance = null;
-            this.adopted = true;
-            return this;
-        }
-        const colorFn = chalk[options.color || 'blue'];
-        this.spinnerInstance = yoctoSpinner({
-            text: colorFn(options.text),
-        });
-        this.spinnerInstance.start();
-        return this;
-    }
-    succeed(text) {
-        if (this.spinnerInstance) {
-            if (this.adopted) {
-                // Release back so subsequent API calls can re-adopt
-                earlySpinnerInstance = this.spinnerInstance;
-                this.spinnerInstance = null;
-                this.adopted = false;
-                return;
-            }
-            this.spinnerInstance.success(text ? chalk.green(`✓ ${text}`) : undefined);
-            this.spinnerInstance = null;
-        }
-    }
-    fail(text) {
-        if (this.spinnerInstance) {
-            // Errors always stop the spinner for real
-            this.spinnerInstance.error(text ? chalk.red(`✗ ${text}`) : undefined);
-            this.spinnerInstance = null;
-            this.adopted = false;
-        }
-    }
-    stop() {
-        if (this.spinnerInstance) {
-            if (this.adopted) {
-                // Release back so subsequent API calls can re-adopt
-                earlySpinnerInstance = this.spinnerInstance;
-                this.spinnerInstance = null;
-                this.adopted = false;
-                return;
-            }
-            this.spinnerInstance.stop();
-            this.spinnerInstance = null;
-        }
-    }
-}
 /**
- * High-level wrapper function for running async operations with a loading spinner.
- * Automatically handles success/failure states and cleanup.
+ * Twist spinner kit. The CLI-specific bit is `shouldDisableSpinner` —
+ * everything else (early-spinner singleton, adoption, withSpinner, the
+ * LoadingSpinner class) lives in cli-core.
  */
-export async function withSpinner(options, asyncOperation) {
-    const loadingSpinner = new LoadingSpinner().start(options);
-    try {
-        const result = await asyncOperation();
-        loadingSpinner.stop(); // Don't show success message by default - let the command handle its own output
-        return result;
-    }
-    catch (error) {
-        loadingSpinner.fail();
-        throw error;
-    }
-}
-export { LoadingSpinner };
+const spinner = createSpinner({ isDisabled: shouldDisableSpinner });
+export const { LoadingSpinner, withSpinner, startEarlySpinner, stopEarlySpinner } = spinner;
 //# sourceMappingURL=spinner.js.map

package/dist/lib/spinner.js.map

@@ -1 +1 @@
-{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/lib/spinner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/lib/spinner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAIvD;;;;GAIG;AACH,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,UAAU,EAAE,oBAAoB,EAAE,CAAC,CAAA;AAEnE,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAA"}

package/dist/lib/update.d.ts

@@ -1,17 +1,13 @@
 import { type UpdateChannel } from './config.js';
-export declare const PACKAGE_NAME = "@doist/twist-cli";
-interface ParsedVersion {
-    major: number;
-    minor: number;
-    patch: number;
-    prerelease: string | undefined;
-}
-export declare function getInstallTag(channel: UpdateChannel): string;
-export declare function normalizeUpdateChannel(channel: unknown): UpdateChannel;
-export declare function parseVersion(version: string): ParsedVersion;
-export declare function compareVersions(a: string, b: string): number;
-export declare function isNewer(current: string, candidate: string): boolean;
+export { compareVersions, getInstallTag, isNewer, parseVersion } from '@doist/cli-core/commands';
 export declare function fetchLatestVersion(channel: UpdateChannel): Promise<string>;
+/**
+ * Tolerant channel read for `tw doctor`. Returns the persisted value when
+ * valid, otherwise `'stable'`. cli-core's strict `getConfiguredUpdateChannel`
+ * throws `INVALID_UPDATE_CHANNEL` — right behaviour for the user-facing
+ * `tw update` command (handled by cli-core internally), wrong behaviour for
+ * diagnostics which should surface the problem as a doctor warning rather
+ * than crash.
+ */
 export declare function getConfiguredUpdateChannel(): Promise<UpdateChannel>;
-export {};
 //# sourceMappingURL=update.d.ts.map

package/dist/lib/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/lib/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3D,eAAO,MAAM,YAAY,qBAAqB,CAAA;AAO9C,UAAU,aAAa;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;CACjC;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAE5D;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAItE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAI3D;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAgB5D;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAQhF;AAED,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,aAAa,CAAC,CAGzE"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/lib/update.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,KAAK,aAAa,EAAmB,MAAM,aAAa,CAAA;AAE5E,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAEhG,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAEhF;AAED;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,aAAa,CAAC,CAMzE"}

package/dist/lib/update.js

@@ -1,49 +1,23 @@
-import { getConfig } from './config.js';
-export const PACKAGE_NAME = '@doist/twist-cli';
-const VALID_UPDATE_CHANNELS = new Set(['stable', 'pre-release']);
-export function getInstallTag(channel) {
-    return channel === 'pre-release' ? 'next' : 'latest';
-}
-export function normalizeUpdateChannel(channel) {
-    return typeof channel === 'string' && VALID_UPDATE_CHANNELS.has(channel)
-        ? channel
-        : 'stable';
-}
-export function parseVersion(version) {
-    const [core, ...rest] = version.replace(/^v/, '').split('-');
-    const [major, minor, patch] = core.split('.').map(Number);
-    return { major, minor, patch, prerelease: rest.length > 0 ? rest.join('-') : undefined };
-}
-export function compareVersions(a, b) {
-    const left = parseVersion(a);
-    const right = parseVersion(b);
-    for (const key of ['major', 'minor', 'patch']) {
-        if (left[key] !== right[key])
-            return left[key] > right[key] ? 1 : -1;
-    }
-    if (!left.prerelease && right.prerelease)
-        return 1;
-    if (left.prerelease && !right.prerelease)
-        return -1;
-    if (left.prerelease && right.prerelease) {
-        return left.prerelease.localeCompare(right.prerelease, undefined, { numeric: true });
-    }
-    return 0;
-}
-export function isNewer(current, candidate) {
-    return compareVersions(candidate, current) > 0;
-}
+import { fetchLatestVersion as fetchLatestVersionCore } from '@doist/cli-core/commands';
+import packageJson from '../../package.json' with { type: 'json' };
+import { getConfig, UPDATE_CHANNELS } from './config.js';
+export { compareVersions, getInstallTag, isNewer, parseVersion } from '@doist/cli-core/commands';
 export async function fetchLatestVersion(channel) {
-    const url = `https://registry.npmjs.org/${PACKAGE_NAME}/${getInstallTag(channel)}`;
-    const response = await fetch(url);
-    if (!response.ok) {
-        throw new Error(`Registry returned ${response.status}`);
-    }
-    const data = (await response.json());
-    return data.version;
+    return fetchLatestVersionCore({ packageName: packageJson.name, channel });
 }
+/**
+ * Tolerant channel read for `tw doctor`. Returns the persisted value when
+ * valid, otherwise `'stable'`. cli-core's strict `getConfiguredUpdateChannel`
+ * throws `INVALID_UPDATE_CHANNEL` — right behaviour for the user-facing
+ * `tw update` command (handled by cli-core internally), wrong behaviour for
+ * diagnostics which should surface the problem as a doctor warning rather
+ * than crash.
+ */
 export async function getConfiguredUpdateChannel() {
     const config = await getConfig();
-    return normalizeUpdateChannel(config.updateChannel);
+    const channel = config.updateChannel;
+    return typeof channel === 'string' && UPDATE_CHANNELS.has(channel)
+        ? channel
+        : 'stable';
 }
 //# sourceMappingURL=update.js.map

package/dist/lib/update.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/lib/update.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/lib/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACvF,OAAO,WAAW,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAClE,OAAO,EAAE,SAAS,EAAsB,eAAe,EAAE,MAAM,aAAa,CAAA;AAE5E,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAEhG,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAsB;IAC3D,OAAO,sBAAsB,CAAC,EAAE,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;AAC7E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B;IAC5C,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAA;IAChC,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAA;IACpC,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,eAAe,CAAC,GAAG,CAAC,OAAwB,CAAC;QAC/E,CAAC,CAAE,OAAyB;QAC5B,CAAC,CAAC,QAAQ,CAAA;AAClB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@doist/twist-cli",
-    "version": "2.36.3",
+    "version": "2.36.4",
     "description": "TypeScript CLI for Twist",
     "type": "module",
     "main": "dist/index.js",
@@ -50,24 +50,24 @@
         "CHANGELOG.md"
     ],
     "dependencies": {
+        "@doist/cli-core": "0.10.0",
         "@doist/twist-sdk": "2.5.1",
         "@pnpm/tabtab": "0.5.4",
         "chalk": "5.6.2",
         "commander": "14.0.3",
         "marked": "18.0.3",
         "marked-terminal-renderer": "2.2.0",
-        "open": "11.0.0",
-        "yocto-spinner": "1.2.0"
+        "open": "11.0.0"
     },
     "devDependencies": {
         "@semantic-release/changelog": "6.0.3",
         "@semantic-release/exec": "7.1.0",
         "@semantic-release/git": "10.0.1",
-        "@types/node": "25.6.0",
+        "@types/node": "25.6.2",
         "conventional-changelog-conventionalcommits": "9.3.1",
         "lefthook": "2.1.6",
-        "oxfmt": "0.47.0",
-        "oxlint": "1.62.0",
+        "oxfmt": "0.48.0",
+        "oxlint": "1.63.0",
         "semantic-release": "25.0.3",
         "typescript": "6.0.3",
         "vitest": "4.1.5"

package/dist/commands/update/action.d.ts

@@ -1,12 +0,0 @@
-export declare function detectPackageManager(): string;
-export declare function runInstall(pm: string, tag: string): Promise<{
-    exitCode: number;
-    stderr: string;
-}>;
-interface UpdateOptions {
-    check?: boolean;
-    channel?: boolean;
-}
-export declare function updateAction(options: UpdateOptions): Promise<void>;
-export {};
-//# sourceMappingURL=action.d.ts.map

package/dist/commands/update/action.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../src/commands/update/action.ts"],"names":[],"mappings":"AAaA,wBAAgB,oBAAoB,IAAI,MAAM,CAM7C;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAejG;AAED,UAAU,aAAa;IACnB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAsGxE"}

package/dist/commands/update/action.js

@@ -1,104 +0,0 @@
-import { spawn } from 'node:child_process';
-import chalk from 'chalk';
-import pkg from '../../../package.json' with { type: 'json' };
-import { CliError } from '../../lib/errors.js';
-import { withSpinner } from '../../lib/spinner.js';
-import { fetchLatestVersion, getConfiguredUpdateChannel, getInstallTag, isNewer, PACKAGE_NAME, } from '../../lib/update.js';
-export function detectPackageManager() {
-    const execPath = process.env.npm_execpath ?? '';
-    if (execPath.includes('pnpm')) {
-        return 'pnpm';
-    }
-    return 'npm';
-}
-export function runInstall(pm, tag) {
-    const command = pm === 'pnpm' ? 'add' : 'install';
-    return new Promise((resolve, reject) => {
-        const child = spawn(pm, [command, '-g', `${PACKAGE_NAME}@${tag}`], {
-            stdio: 'pipe',
-        });
-        let stderr = '';
-        child.stderr?.on('data', (data) => {
-            stderr += data.toString();
-        });
-        child.on('error', reject);
-        child.on('close', (code) => resolve({ exitCode: code ?? 1, stderr }));
-    });
-}
-export async function updateAction(options) {
-    if (options.check && options.channel) {
-        throw new CliError('CONFLICTING_OPTIONS', 'Specify either --check or --channel, not both.');
-    }
-    if (options.channel) {
-        const ch = await getConfiguredUpdateChannel();
-        if (ch === 'pre-release') {
-            console.log(`Update channel: ${chalk.magenta('pre-release')}`);
-        }
-        else {
-            console.log(`Update channel: ${chalk.green('stable')}`);
-        }
-        return;
-    }
-    const currentVersion = pkg.version;
-    const channel = await getConfiguredUpdateChannel();
-    const tag = getInstallTag(channel);
-    const label = channel === 'pre-release' ? ` ${chalk.magenta('(pre-release)')}` : '';
-    let latestVersion;
-    try {
-        latestVersion = await withSpinner({ text: `Checking for updates${label}...` }, () => fetchLatestVersion(channel));
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        throw new CliError('API_ERROR', `Failed to check for updates: ${message}`);
-    }
-    const updateAvailable = isNewer(currentVersion, latestVersion);
-    if (options.check) {
-        const channelLine = channel === 'pre-release'
-            ? `  Channel: ${chalk.magenta('pre-release')}`
-            : `  Channel: ${chalk.green('stable')}`;
-        if (currentVersion === latestVersion) {
-            console.log(chalk.green('✓'), `Already up to date (v${currentVersion})`);
-        }
-        else if (updateAvailable) {
-            console.log(`Update available: ${chalk.dim(`v${currentVersion}`)} → ${chalk.green(`v${latestVersion}`)}${label}`);
-        }
-        else {
-            console.log(`Downgrade available: ${chalk.dim(`v${currentVersion}`)} → ${chalk.yellow(`v${latestVersion}`)}${label}`);
-        }
-        console.log(channelLine);
-        return;
-    }
-    if (currentVersion === latestVersion) {
-        console.log(chalk.green('✓'), `Already up to date (v${currentVersion})`);
-        return;
-    }
-    if (updateAvailable) {
-        console.log(`Update available${label}: ${chalk.dim(`v${currentVersion}`)} → ${chalk.green(`v${latestVersion}`)}`);
-    }
-    else {
-        console.log(`Downgrade available${label}: ${chalk.dim(`v${currentVersion}`)} → ${chalk.yellow(`v${latestVersion}`)}`);
-    }
-    const pm = detectPackageManager();
-    let result;
-    try {
-        result = await withSpinner({ text: `Updating to v${latestVersion}${label}...`, color: 'blue' }, () => runInstall(pm, tag));
-    }
-    catch (error) {
-        if (error instanceof Error && 'code' in error && error.code === 'EACCES') {
-            throw new CliError('INTERNAL_ERROR', 'Permission denied.', [
-                `Try running with sudo: sudo ${pm} ${pm === 'pnpm' ? 'add' : 'install'} -g ${PACKAGE_NAME}@${tag}`,
-            ]);
-        }
-        const message = error instanceof Error ? error.message : 'Unknown error';
-        throw new CliError('INTERNAL_ERROR', `Update failed: ${message}`);
-    }
-    if (result.exitCode !== 0) {
-        const detail = result.stderr ? `\n${result.stderr.trim()}` : '';
-        throw new CliError('INTERNAL_ERROR', `Update failed: ${pm} exited with code ${result.exitCode}${detail}`);
-    }
-    console.log(chalk.green('✓'), `Updated to v${latestVersion}`);
-    if (channel !== 'pre-release') {
-        console.log(chalk.dim('  Run'), chalk.cyan('tw changelog'), chalk.dim('to see what changed'));
-    }
-}
-//# sourceMappingURL=action.js.map

package/dist/commands/update/action.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"action.js","sourceRoot":"","sources":["../../../src/commands/update/action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,GAAG,MAAM,uBAAuB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,EACH,kBAAkB,EAClB,0BAA0B,EAC1B,aAAa,EACb,OAAO,EACP,YAAY,GACf,MAAM,qBAAqB,CAAA;AAE5B,MAAM,UAAU,oBAAoB;IAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAA;IAC/C,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAA;IACjB,CAAC;IACD,OAAO,KAAK,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAU,EAAE,GAAW;IAC9C,MAAM,OAAO,GAAG,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;IACjD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACnC,MAAM,KAAK,GAAG,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,YAAY,IAAI,GAAG,EAAE,CAAC,EAAE;YAC/D,KAAK,EAAE,MAAM;SAChB,CAAC,CAAA;QAEF,IAAI,MAAM,GAAG,EAAE,CAAA;QACf,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YACtC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAA;QAC7B,CAAC,CAAC,CAAA;QAEF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QACzB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;IACzE,CAAC,CAAC,CAAA;AACN,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAsB;IACrD,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACnC,MAAM,IAAI,QAAQ,CAAC,qBAAqB,EAAE,gDAAgD,CAAC,CAAA;IAC/F,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,EAAE,GAAG,MAAM,0BAA0B,EAAE,CAAA;QAC7C,IAAI,EAAE,KAAK,aAAa,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,CAAA;QAClE,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;QAC3D,CAAC;QACD,OAAM;IACV,CAAC;IAED,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,CAAA;IAClC,MAAM,OAAO,GAAG,MAAM,0BAA0B,EAAE,CAAA;IAClD,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;IAClC,MAAM,KAAK,GAAG,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAEnF,IAAI,aAAqB,CAAA;IACzB,IAAI,CAAC;QACD,aAAa,GAAG,MAAM,WAAW,CAAC,EAAE,IAAI,EAAE,uBAAuB,KAAK,KAAK,EAAE,EAAE,GAAG,EAAE,CAChF,kBAAkB,CAAC,OAAO,CAAC,CAC9B,CAAA;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAA;QACxE,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,gCAAgC,OAAO,EAAE,CAAC,CAAA;IAC9E,CAAC;IAED,MAAM,eAAe,GAAG,OAAO,CAAC,cAAc,EAAE,aAAa,CAAC,CAAA;IAE9D,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,WAAW,GACb,OAAO,KAAK,aAAa;YACrB,CAAC,CAAC,cAAc,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE;YAC9C,CAAC,CAAC,cAAc,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAA;QAE/C,IAAI,cAAc,KAAK,aAAa,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,wBAAwB,cAAc,GAAG,CAAC,CAAA;QAC5E,CAAC;aAAM,IAAI,eAAe,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CACP,qBAAqB,KAAK,CAAC,GAAG,CAAC,IAAI,cAAc,EAAE,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,aAAa,EAAE,CAAC,GAAG,KAAK,EAAE,CACvG,CAAA;QACL,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,GAAG,CACP,wBAAwB,KAAK,CAAC,GAAG,CAAC,IAAI,cAAc,EAAE,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC,GAAG,KAAK,EAAE,CAC3G,CAAA;QACL,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;QACxB,OAAM;IACV,CAAC;IAED,IAAI,cAAc,KAAK,aAAa,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,wBAAwB,cAAc,GAAG,CAAC,CAAA;QACxE,OAAM;IACV,CAAC;IAED,IAAI,eAAe,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CACP,mBAAmB,KAAK,KAAK,KAAK,CAAC,GAAG,CAAC,IAAI,cAAc,EAAE,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,aAAa,EAAE,CAAC,EAAE,CACvG,CAAA;IACL,CAAC;SAAM,CAAC;QACJ,OAAO,CAAC,GAAG,CACP,sBAAsB,KAAK,KAAK,KAAK,CAAC,GAAG,CAAC,IAAI,cAAc,EAAE,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC,EAAE,CAC3G,CAAA;IACL,CAAC;IAED,MAAM,EAAE,GAAG,oBAAoB,EAAE,CAAA;IAEjC,IAAI,MAA4C,CAAA;IAChD,IAAI,CAAC;QACD,MAAM,GAAG,MAAM,WAAW,CACtB,EAAE,IAAI,EAAE,gBAAgB,aAAa,GAAG,KAAK,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EACnE,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,GAAG,CAAC,CAC5B,CAAA;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvE,MAAM,IAAI,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,EAAE;gBACvD,+BAA+B,EAAE,IAAI,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,OAAO,YAAY,IAAI,GAAG,EAAE;aACrG,CAAC,CAAA;QACN,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAA;QACxE,MAAM,IAAI,QAAQ,CAAC,gBAAgB,EAAE,kBAAkB,OAAO,EAAE,CAAC,CAAA;IACrE,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAC/D,MAAM,IAAI,QAAQ,CACd,gBAAgB,EAChB,kBAAkB,EAAE,qBAAqB,MAAM,CAAC,QAAQ,GAAG,MAAM,EAAE,CACtE,CAAA;IACL,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,eAAe,aAAa,EAAE,CAAC,CAAA;IAC7D,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CACP,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAClB,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,EAC1B,KAAK,CAAC,GAAG,CAAC,qBAAqB,CAAC,CACnC,CAAA;IACL,CAAC;AACL,CAAC"}