@tryarcanist/cli 0.1.200 → 0.1.202

package/README.md

@@ -15,6 +15,7 @@ Requires Node.js 22 or newer.
 ```bash
 arcanist auth login                 # paste a token from Settings > CLI Tokens
 arcanist sessions create https://github.com/your-org/your-repo "fix the login bug"
+arcanist sessions create https://github.com/your-org/your-repo "fix ARC-1635" --linear-issue https://linear.app/team/issue/ARC-1635/fix-login
 ```
 
 ```bash
@@ -208,6 +209,9 @@ Use `--start-branch <branch>` to resume an existing branch with its history inst
 
 Use `--continue-pr <url>` to continue an open same-repo pull request. The control plane checks out the PR head branch before the prompt runs. `--continue-mode update-pr` updates the referenced PR; `--continue-mode new-pr` starts from that PR head but leaves publish free to open a fresh PR. `auto` is the default and currently resolves to same-PR update for supported open same-repo PRs.
 
+Use `--linear-issue <id|url>` to attach a Linear issue reference to the created session.
+The CLI echoes the request value as `linearIssue` in JSON output; pickup writeback occurs after the first prompt is durably enqueued.
+
 Repeatable `--uploaded-file <path>` flags attach local UTF-8 text files to the prompt. Uploaded file names come from the local basename; directory components are not sent.
 
 `--cold` is a deprecated no-op retained for backward compatibility. Sessions always start from a fresh sandbox (the warm sandbox pool was removed), so the flag has no effect.
@@ -419,12 +423,15 @@ Creates a scheduled automation for a GitHub repo. Create/delete require a write-
 ```bash
 arcanist automations create your-org/your-repo "summarize new regressions" --cron "*/15 * * * *"
 arcanist automations create your-org/your-repo "audit N+1s" --cron "0 13 * * 5" --model gpt-5.5
+arcanist automations create your-org/your-repo "/audit-prod-docs https://docs.tryarcanist.com/" --cron "0 8 * * *" --slack-team-id T0123ABC --slack-channel-id C0456DEF
 printf "summarize new regressions" | arcanist automations create your-org/your-repo --prompt-stdin --cron "*/15 * * * *" --json
 arcanist automations create https://github.com/your-org/your-repo - --cron "0 14 * * 1-5" --name "Weekday summary"
 ```
 
 Use `--model <model>` to pin the model for sessions started by the automation. Backend is derived from the model; non-codex backends such as Claude or opencode are limited to Arcanist team businesses. When `--model` is omitted the codex backend default is used.
 
+Use `--slack-team-id <team-id>` together with `--slack-channel-id <channel-id>` to deliver each completed automation digest into a Slack channel. Both flags are required together; the target workspace must already be connected to Arcanist and the bot must already be in the channel.
+
 JSON mode prints the created rule. Human-readable mode prints the rule ID, repo, normalized cron, and next fire time.
 
 ### `arcanist automations list`

package/dist/index.js

@@ -1171,6 +1171,10 @@ var AUTOMATION_ERROR_HINTS = {
   repo_not_available: "Check that the token owner has GitHub access and Arcanist is installed for that repo.",
   duplicate_rule: "An enabled automation already exists for this repo, cron, and prompt.",
   invalid_skill: "Use a leading slash skill that exists in the selected repo, for example: /audit-prod-docs",
+  invalid_slack_target: "Pass both --slack-team-id and --slack-channel-id to enable Slack delivery.",
+  slack_workspace_not_connected: "Connect that Slack workspace to Arcanist before creating the automation.",
+  slack_channel_unavailable: "Check the Slack channel ID and confirm the bot can see the channel.",
+  slack_bot_not_in_channel: "Invite the Arcanist bot to the channel, then retry.",
   rule_cap_reached: "Delete or disable an existing automation before creating another one. The cap is 20 enabled rules.",
   installation_unresolved: "Reconnect or reinstall the GitHub integration for that repository, then retry.",
   model_not_available: "That model's backend (Claude/opencode) is limited to Arcanist team businesses; use the codex default or a codex model.",
@@ -1181,6 +1185,15 @@ var MAX_ALL_PAGES = 1e3;
 async function createAutomationCommand(repoUrl, promptArg, options, command) {
   const repo = parseAutomationRepo(repoUrl);
   const prompt = await resolvePromptInput(promptArg, options);
+  const slackTeamId = options.slackTeamId?.trim();
+  const slackChannelId = options.slackChannelId?.trim();
+  const slackDeliveryRequested = options.slackTeamId !== void 0 || options.slackChannelId !== void 0;
+  if (slackDeliveryRequested && (!slackTeamId || !slackChannelId)) {
+    throw new CliError(
+      "user",
+      "Slack delivery requires both --slack-team-id and --slack-channel-id with non-empty values."
+    );
+  }
   const runtime = getRuntimeOptions(command, options);
   const config = requireConfig(runtime);
   let normalizedModel;
@@ -1200,6 +1213,10 @@ async function createAutomationCommand(repoUrl, promptArg, options, command) {
   };
   if (options.name !== void 0) body.name = options.name;
   if (options.model !== void 0) body.modelId = normalizedModel;
+  if (slackDeliveryRequested) {
+    body.slackTeamId = slackTeamId;
+    body.slackChannelId = slackChannelId;
+  }
   const payload = await automationApiFetch(config, "/api/automation/schedules", {
     method: "POST",
     body: JSON.stringify(body)
@@ -1314,6 +1331,9 @@ function printAutomationRule(rule) {
   console.log(`Repo: ${rule.repoOwner}/${rule.repoName}`);
   console.log(`Cron: ${rule.normalizedCron}`);
   if (rule.modelId) console.log(`Model: ${rule.modelId}`);
+  if (rule.slackTeamId && rule.slackChannelId) {
+    console.log(`Slack delivery: ${rule.slackTeamId}/${rule.slackChannelId}`);
+  }
   console.log(`Next fire: ${formatTime(rule.nextFireAt)}`);
 }
 function formatTime(value) {
@@ -3436,6 +3456,11 @@ async function createCommand(repoUrl, promptArg, options, command) {
   if (promptPreview) body.prompt = promptPreview;
   if (baseBranch) body.baseBranch = baseBranch;
   if (startBranch) body.startBranch = startBranch;
+  const linearIssue = options.linearIssue?.trim();
+  if (options.linearIssue !== void 0 && !linearIssue) {
+    throw new CliError("user", "--linear-issue must not be empty.");
+  }
+  if (linearIssue) body.linearIssue = linearIssue;
   if (continuePr) body.continuePrUrl = continuePr;
   if (continueMode) body.continueMode = continueMode;
   if (options.cold) body.cold = true;
@@ -3507,6 +3532,7 @@ async function createCommand(repoUrl, promptArg, options, command) {
     if (options.autoVerify) output.autoVerify = true;
     if (baseBranch) output.baseBranch = baseBranch;
     if (startBranch) output.startBranch = startBranch;
+    if (linearIssue) output.linearIssue = linearIssue;
     if (continuePr) output.continuePrUrl = continuePr;
     if (continueMode) output.continueMode = continueMode;
     if (options.onboarding) output.onboarding = true;
@@ -5497,7 +5523,7 @@ function addCreateOptions(cmd) {
   return cmd.argument("<repo-url>", "Repository URL").argument("[prompt]", "Prompt to send, or '-' to read stdin").option("--model <model>", "Model to use").option("--backend <backend>", "Agent runtime backend: codex (default), claude_code, or opencode").option("--reasoning-effort <effort>", "Reasoning effort to use for models that support it").option("--auto-verify", "Opt this session into automatic QA verification after PR creation").option("--base-branch <branch>", "Base branch to create the session against (defaults to the repo default branch)").option(
     "--start-branch <branch>",
     "Resume an existing branch with its history instead of forking a new one off base"
-  ).option("--continue-pr <url>", "Continue from an existing same-repo pull request").option("--continue-mode <mode>", "Continuation mode: auto (default), update-pr, or new-pr").option("--prompt-stdin", "Read prompt from stdin").option(
+  ).option("--linear-issue <id|url>", "Associate the session with a Linear issue for pickup writeback").option("--continue-pr <url>", "Continue from an existing same-repo pull request").option("--continue-mode <mode>", "Continuation mode: auto (default), update-pr, or new-pr").option("--prompt-stdin", "Read prompt from stdin").option(
     "--uploaded-file <path>",
     "Attach a local text file to the prompt as uploadedFiles; repeat for multiple files",
     collectUploadedFileOption
@@ -5739,12 +5765,16 @@ var automations = program.command("automations").description("Automation command
 automations.command("create").description("Create a scheduled automation").argument("<repo-url>", "Repository URL").argument("[prompt]", "Prompt to run, or '-' to read stdin").requiredOption("--cron <expr>", "Cron expression").option("--name <name>", "Automation display name").option(
   "--model <model>",
   "Model to pin for this automation's sessions (e.g. gpt-5.5, claude-opus-4-8). Defaults to the codex backend default."
-).option("--prompt-stdin", "Read prompt from stdin").addHelpText(
+).option(
+  "--slack-team-id <team-id>",
+  "Slack workspace/team ID for final digest delivery (requires --slack-channel-id)"
+).option("--slack-channel-id <channel-id>", "Slack channel ID for final digest delivery (requires --slack-team-id)").option("--prompt-stdin", "Read prompt from stdin").addHelpText(
   "after",
   `
 Examples:
   arcanist automations create tryarcanist/arcanist "summarize regressions" --cron "*/15 * * * *"
   arcanist automations create tryarcanist/arcanist "audit N+1s" --cron "0 13 * * 5" --model gpt-5.5
+  arcanist automations create tryarcanist/arcanist "/audit-prod-docs https://docs.tryarcanist.com/" --cron "0 8 * * *" --slack-team-id T0123ABC --slack-channel-id C0456DEF
   printf "summarize regressions" | arcanist automations create tryarcanist/arcanist --prompt-stdin --cron "*/15 * * * *" --json
 `
 ).action((repoUrl, prompt, options, command) => createAutomationCommand(repoUrl, prompt, options, command));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tryarcanist/cli",
-  "version": "0.1.200",
+  "version": "0.1.202",
   "description": "CLI for Arcanist — create and manage coding agent sessions",
   "type": "module",
   "bin": {