@sweny-ai/core 0.1.200 → 0.1.201

package/dist/cli/config.js

@@ -1,10 +1,11 @@
 import { execSync } from "node:child_process";
 import { hasCodexLogin } from "../agent-env.js";
+import { registerDeprecatedFlags } from "./deprecated-flags.js";
 import { parseAcpAgent, unsupportedAgentError } from "../harness/agents.js";
 export function registerTriageCommand(program) {
     // NOTE: File-eligible options omit Commander defaults so parseCliInputs() can
     // distinguish "user passed flag" from "not passed" and fall through to .sweny.yml.
-    return program
+    const cmd = program
         .command("triage")
         .description("Run the SWEny triage workflow")
         .option("--agent <provider>", "Coding agent: claude (default), codex, pi (experimental), or acp:<command> for any ACP agent (experimental)")
@@ -55,6 +56,7 @@ export function registerTriageCommand(program) {
         .option("--workspace-tools <tools>", "Comma-separated workspace tool integrations to enable (slack, notion, pagerduty, monday)")
         .option("--offline", "Skip URL Sources and fail fast if any are referenced", false)
         .option("--file-root [dir]", "Sandbox file: Sources to this directory tree (defaults to the working directory when the flag is given without a value)");
+    return registerDeprecatedFlags(cmd);
 }
 export function parseCliInputs(options, fileConfig = {}) {
     const env = process.env;
@@ -615,7 +617,7 @@ function parseObservabilityCredentials(provider, options, fileConfig = {}) {
     }
 }
 export function registerImplementCommand(program) {
-    return program
+    const cmd = program
         .command("implement <issueId>")
         .description("Implement a fix for a specific issue and open a PR")
         .option("--agent <provider>", "Coding agent: claude (default), codex, pi (experimental), or acp:<command> for any ACP agent (experimental)")
@@ -634,6 +636,7 @@ export function registerImplementCommand(program) {
         .option("--verbose", "Print each tool call's input and output inline (human-readable, truncated). Use --stream for full untruncated NDJSON.", false)
         .option("--offline", "Skip URL Sources and fail fast if any are referenced", false)
         .option("--file-root [dir]", "Sandbox file: Sources to this directory tree (defaults to the working directory when the flag is given without a value)");
+    return registerDeprecatedFlags(cmd);
 }
 /**
  * Parse a JSON string into MCP server configs.

package/dist/cli/deprecated-flags.d.ts

@@ -0,0 +1,35 @@
+import { type Command } from "commander";
+/**
+ * CLI flags that sweny parsed but never read, removed in #528 and restored
+ * here as deprecated no-ops so existing callers (the swenyai/triage action
+ * passes most of them) keep working through a deprecation period.
+ *
+ * Each one is accepted, hidden from `--help`, changes nothing, and prints one
+ * stderr warning per run. This table is the only place the list lives;
+ * `registerDeprecatedFlags` is the only place it is wired in, once per command.
+ *
+ * Env vars and `.sweny.yml` keys for the same settings are not parsed at all
+ * and are never rejected, so they need no handling.
+ *
+ * Remove an entry (and its command wiring) in a minor release after the
+ * deprecation period; the docs-cloud-positioning test keeps these out of
+ * `--help` and out of the supported-option docs tables.
+ */
+export interface DeprecatedFlag {
+    /** Commander flag spec, e.g. "--cache-dir <path>". */
+    flag: string;
+    /** Commands that accepted this flag before it was removed. */
+    commands: readonly string[];
+    /** Why it has no effect (kept for maintainers; not printed). */
+    note: string;
+}
+export declare const DEPRECATED_FLAGS: readonly DeprecatedFlag[];
+/** `--cache-dir <path>` -> `--cache-dir`. */
+export declare function deprecatedFlagName(spec: string): string;
+export declare function deprecationWarning(flags: readonly string[]): string;
+/**
+ * Accept every deprecated flag that `cmd` used to have. Hidden from help, no
+ * effect, and exactly one stderr warning per run naming the flags that were
+ * passed.
+ */
+export declare function registerDeprecatedFlags(cmd: Command): Command;

package/dist/cli/deprecated-flags.js

@@ -0,0 +1,44 @@
+import { Option } from "commander";
+const TRIAGE_AND_IMPLEMENT = ["triage", "implement"];
+const TRIAGE_ONLY = ["triage"];
+export const DEPRECATED_FLAGS = [
+    { flag: "--cache-dir <path>", commands: TRIAGE_ONLY, note: "no step cache exists" },
+    { flag: "--cache-ttl <seconds>", commands: TRIAGE_ONLY, note: "no step cache exists" },
+    { flag: "--no-cache", commands: TRIAGE_ONLY, note: "no step cache exists" },
+    { flag: "--output-dir <path>", commands: TRIAGE_AND_IMPLEMENT, note: "file providers do not read it" },
+    { flag: "--service-map-path <path>", commands: TRIAGE_ONLY, note: "service maps are not read" },
+    { flag: "--gitlab-base-url <url>", commands: TRIAGE_ONLY, note: "the GitLab provider reads GITLAB_URL" },
+    { flag: "--linear-team-id <id>", commands: TRIAGE_AND_IMPLEMENT, note: "the agent gets team ids from the node" },
+    { flag: "--linear-bug-label-id <id>", commands: TRIAGE_ONLY, note: "never read" },
+    { flag: "--linear-triage-label-id <id>", commands: TRIAGE_ONLY, note: "never read" },
+    { flag: "--linear-state-backlog <name>", commands: TRIAGE_ONLY, note: "never read" },
+    { flag: "--linear-state-in-progress <name>", commands: TRIAGE_AND_IMPLEMENT, note: "never read" },
+    { flag: "--linear-state-peer-review <name>", commands: TRIAGE_AND_IMPLEMENT, note: "never read" },
+];
+/** `--cache-dir <path>` -> `--cache-dir`. */
+export function deprecatedFlagName(spec) {
+    return spec.split(/[ ,]/)[0];
+}
+export function deprecationWarning(flags) {
+    const list = flags.join(", ");
+    const subject = flags.length === 1 ? `${list} is deprecated` : `${list} are deprecated`;
+    return `warning: ${subject}, has no effect and will be removed in a future minor version.\n`;
+}
+/**
+ * Accept every deprecated flag that `cmd` used to have. Hidden from help, no
+ * effect, and exactly one stderr warning per run naming the flags that were
+ * passed.
+ */
+export function registerDeprecatedFlags(cmd) {
+    const options = DEPRECATED_FLAGS.filter((d) => d.commands.includes(cmd.name())).map((d) => new Option(d.flag).hideHelp());
+    for (const option of options)
+        cmd.addOption(option);
+    cmd.hook("preAction", (_thisCommand, actionCommand) => {
+        const used = options
+            .filter((o) => actionCommand.getOptionValueSource(o.attributeName()) === "cli")
+            .map((o) => o.long);
+        if (used.length > 0)
+            process.stderr.write(deprecationWarning(used));
+    });
+    return cmd;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sweny-ai/core",
-  "version": "0.1.200",
+  "version": "0.1.201",
   "type": "module",
   "bin": {
     "sweny": "./dist/cli/main.js"