@devrouter/cli 0.0.24 → 0.0.25

package/README.md

@@ -63,7 +63,7 @@ vars. Use it when you are not (yet) on a devcontainer. Fully supported.
 
 ## Core commands
 
-- `devrouter init [--repo <path>] [--entries-json <json>] [--json] [--write-agents] [--write-skill] [--with-linear]`
+- `devrouter init [--repo <path>] [--entries-json <json>] [--json] [--write-agents] [--write-skill]`
 - `devrouter -V [--repo <path>]` (installed CLI version, local repo version, next upgrade target)
 - `devrouter upgrade [version] [--repo <path>]`
 - `devrouter setup --yes [--repo <path>] [--json]`
@@ -78,7 +78,7 @@ vars. Use it when you are not (yet) on a devcontainer. Fully supported.
 - `devrouter repo inspect [--repo <path>] [--json]`
 - `devrouter repo devcontainer write [--repo <path>] [--dry-run] [--yes] [--json]`
 - `devrouter repo devcontainer verify [--repo <path>] [--live] [--yes] [--json]`
-- `devrouter repo agents [--repo <path>] [--with-linear]`
+- `devrouter repo agents [--repo <path>]`
 - `devrouter app add ...` (`--kind app|dependency`, default `app`)
 - `devrouter app ls [--repo <path>] [--json]`
 - `devrouter app run <name> [--repo <path>] [--yes] [--workspace <slug>]`
@@ -187,14 +187,6 @@ Optional repo artifact writes are explicit:
 devrouter init --repo /absolute/path/to/repo --write-agents --write-skill
 ```
 
-Optional: also bootstrap Linear workflow skill/templates and AGENTS section:
-
-```bash
-devrouter init --repo /absolute/path/to/repo --with-linear --write-agents --write-skill
-```
-
-When `--with-linear` is combined with AGENTS writes, devrouter captures minimal Linear mapping (workspace, team, project). In non-interactive mode it writes placeholders and prints a warning so values can be filled in later.
-
 ## Health diagnostics
 
 Run check-only diagnostics for global router state, machine prerequisites, route state, and repo configuration:
@@ -378,39 +370,6 @@ See details:
 
 `devrouter repo agents` writes a devrouter section into the repo's `AGENTS.md` and installs a skill file at `.agents/skills/devrouter/SKILL.md`. The skill content is embedded in the CLI bundle so it stays in sync across repos.
 
-If you also want Linear workflow assets and repository mapping metadata, run:
-
-```bash
-devrouter repo agents --with-linear
-```
-
-This additionally installs:
-
-- `.agents/skills/linear-workflow/SKILL.md`
-- `.agents/skills/linear-workflow/references/LINEAR_ISSUE_TEMPLATE.md`
-- `.agents/skills/linear-workflow/references/MILESTONE_PLAN_TEMPLATE.md`
-- `.agents/skills/linear-workflow/references/PROGRESS_UPDATE_TEMPLATE.md`
-
-and appends an idempotent `linear-workflow` section to `AGENTS.md`.
-
-With `--with-linear`, AGENTS also stores a managed config block:
-
-- `<!-- devrouter-linear-workflow-config:start -->`
-- `<!-- devrouter-linear-workflow-config:end -->`
-
-The block captures:
-
-- `workspace.name`
-- `team.name` (optional `team.key`)
-- `project.name` (optional `project.id`)
-
-Required Linear execution hygiene:
-
-1. Set issue status at session start and update it at each phase transition.
-2. Post progress comments at meaningful checkpoints during implementation.
-3. Before ending a session, post a final comment with completed work, remaining work, risks, and next step.
-4. Re-check status and comment freshness toward/at session end before stopping.
-
 ## Known limitations (v1)
 
 - Host-runtime dependencies are not auto-started; only Docker dependencies are auto-started.

package/dist/devrouter.js

@@ -563,25 +563,25 @@ function listHostRouteState() {
     return [];
   }
 }
-function upsertHostRoute(input3) {
+function upsertHostRoute(input2) {
   return withStateLock(() => {
     const routes = listHostRouteState();
-    const id = buildHostRouteId(input3.repoPath, input3.name);
+    const id = buildHostRouteId(input2.repoPath, input2.name);
     const existing = routes.find((route) => route.id === id);
     const now = (/* @__PURE__ */ new Date()).toISOString();
     const next = {
       id,
-      name: input3.name,
-      host: input3.host,
-      protocol: input3.protocol ?? "http",
-      tcpProtocol: input3.tcpProtocol,
-      repoPath: input3.repoPath,
-      port: input3.port,
-      mode: input3.mode,
-      upstreamHost: input3.upstreamHost,
-      pid: input3.pid,
-      command: input3.command,
-      workspace: input3.workspace,
+      name: input2.name,
+      host: input2.host,
+      protocol: input2.protocol ?? "http",
+      tcpProtocol: input2.tcpProtocol,
+      repoPath: input2.repoPath,
+      port: input2.port,
+      mode: input2.mode,
+      upstreamHost: input2.upstreamHost,
+      pid: input2.pid,
+      command: input2.command,
+      workspace: input2.workspace,
       createdAt: existing?.createdAt ?? now,
       updatedAt: now
     };
@@ -723,6 +723,17 @@ var init_workspace = __esm({
 });
 
 // src/core/repo-config.ts
+function compareSemver(a, b) {
+  const parse = (v) => {
+    const match = v.trim().match(/^v?(\d+)\.(\d+)\.(\d+)$/);
+    return match ? { major: Number(match[1]), minor: Number(match[2]), patch: Number(match[3]) } : { major: 0, minor: 0, patch: 0 };
+  };
+  const left = parse(a);
+  const right = parse(b);
+  if (left.major !== right.major) return left.major - right.major;
+  if (left.minor !== right.minor) return left.minor - right.minor;
+  return left.patch - right.patch;
+}
 function assertUpstreamSpec(upstream, label) {
   if (upstream.includes(WORKSPACE_PLACEHOLDER)) {
     if (!UPSTREAM_TEMPLATE_RE.test(upstream.trim())) {
@@ -1143,7 +1154,22 @@ function loadRepoConfig(repoPath) {
   }
   const raw = import_node_fs4.default.readFileSync(configPath, "utf-8");
   const parsed = import_yaml2.default.parse(raw);
-  return parseConfig(parsed ?? {}, configPath);
+  const config = parseConfig(parsed ?? {}, configPath);
+  const requiredVersion = config.devrouter?.version;
+  if (requiredVersion && !hasWarnedVersionMismatch) {
+    const cliVersion = true ? "0.0.25" : "0.0.0-dev";
+    if (cliVersion !== "0.0.0-dev" && compareSemver(requiredVersion, cliVersion) > 0) {
+      hasWarnedVersionMismatch = true;
+      process.stderr.write(
+        `
+\u26A0\uFE0F  Warning: The repository configuration requires devrouter version ${requiredVersion}, but you are running version ${cliVersion}.
+   Please upgrade your CLI to avoid unexpected behavior: npm install -g @devrouter/cli
+
+`
+      );
+    }
+  }
+  return config;
 }
 function initRepoConfig(repoPath, options = {}) {
   const resolvedRepoPath = resolveRepoPath(repoPath);
@@ -1462,7 +1488,7 @@ function resolveAppDependencies(config, app) {
   }
   return results;
 }
-var import_node_fs4, import_node_path4, import_yaml2, CONFIG_FILE_NAME, DEFAULT_TCP_PROTOCOL, VALID_HOSTNAME_RE, DEVROUTER_VERSION_RE, VALID_ENV_NAME_RE, VALID_ENV_VAR_RE, UPSTREAM_TEMPLATE_RE, MAX_COMMAND_LENGTH, DEFAULT_HOST_STRATEGY;
+var import_node_fs4, import_node_path4, import_yaml2, hasWarnedVersionMismatch, CONFIG_FILE_NAME, DEFAULT_TCP_PROTOCOL, VALID_HOSTNAME_RE, DEVROUTER_VERSION_RE, VALID_ENV_NAME_RE, VALID_ENV_VAR_RE, UPSTREAM_TEMPLATE_RE, MAX_COMMAND_LENGTH, DEFAULT_HOST_STRATEGY;
 var init_repo_config = __esm({
   "src/core/repo-config.ts"() {
     "use strict";
@@ -1472,6 +1498,7 @@ var init_repo_config = __esm({
     init_host_routes();
     init_workspace();
     init_capabilities();
+    hasWarnedVersionMismatch = false;
     CONFIG_FILE_NAME = ".devrouter.yml";
     DEFAULT_TCP_PROTOCOL = "postgres";
     VALID_HOSTNAME_RE = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*\.localhost$/;
@@ -1489,13 +1516,13 @@ var init_repo_config = __esm({
 });
 
 // src/core/ai-prompt.ts
-function normalizeEntriesJson(input3) {
-  if (!input3) {
+function normalizeEntriesJson(input2) {
+  if (!input2) {
     return "<JSON_ARRAY_OF_APP_ENTRIES>";
   }
   let parsed;
   try {
-    parsed = JSON.parse(input3);
+    parsed = JSON.parse(input2);
   } catch {
     throw new Error("--entries-json must be valid JSON.");
   }
@@ -1523,7 +1550,6 @@ function buildOnboardingPrompt(options = {}) {
   const repoPath = resolveRepoPath(options.repo);
   const entriesJson = normalizeEntriesJson(options.entriesJson);
   const projectName = repoPath.split(/[\\/]/).filter(Boolean).pop() ?? "repo";
-  const withLinear = Boolean(options.withLinear);
   return [
     "You are adapting an existing repository to devrouter using the unified .devrouter.yml model.",
     "",
@@ -1698,24 +1724,6 @@ function buildOnboardingPrompt(options = {}) {
     "   - devrouter ls exposes expected endpoints",
     "   - HTTP routes reachable",
     "   - TCP Postgres route configured with TLS requirement noted",
-    ...withLinear ? [
-      "",
-      "Linear milestone workflow (enabled via --with-linear):",
-      "- Before creating/updating Linear issues, confirm repository mapping basics with the user:",
-      "  - Which Linear workspace does this repository belong to?",
-      "  - Which Linear team owns this repository? (optional team key)",
-      "  - Which Linear project should this work use? (optional project id)",
-      "- When `--with-linear` is used together with AGENTS write flows, persist answers into the managed AGENTS block between:",
-      "  - `<!-- devrouter-linear-workflow-config:start -->`",
-      "  - `<!-- devrouter-linear-workflow-config:end -->`",
-      "- If placeholders are present in that block, ask these questions again and update the mapping.",
-      "- While implementing Linear-tracked work, set issue status at session start and at each phase transition.",
-      "- Post progress comments at meaningful checkpoints during implementation (not only at the end).",
-      "- Before ending a session, post a final recap comment with completed work, remaining work, risks, and next step, then re-check status/comment freshness.",
-      "- Optional bootstrap commands for repo artifacts: `devrouter init --repo <REPO_PATH> --with-linear --write-agents --write-skill` or `devrouter repo agents --repo <REPO_PATH> --with-linear`.",
-      "- If the repository uses devrouter, keep `.devrouter.yml` metadata `devrouter.version` updated and run `devrouter -V` to verify installed/local versions plus the next target.",
-      "- Resolve adaptation prompts with `devrouter upgrade` (list targets) and `devrouter upgrade <version>` (target prompt), sourced from `upgrade-prompts/<version>.md` in the devrouter release."
-    ] : [],
     "",
     renderCommandIntentSection()
   ].join("\n");
@@ -1728,7 +1736,7 @@ var init_ai_prompt = __esm({
     init_repo_config();
     COMMAND_INTENTS = [
       {
-        command: "devrouter init [--with-linear]",
+        command: "devrouter init",
         purpose: "Print the AI onboarding prompt template for a repository (non-mutating by default)."
       },
       {
@@ -1802,8 +1810,8 @@ var init_ai_prompt = __esm({
         purpose: "Remove one app entry from `.devrouter.yml` and free its route. `--keep-config` frees only the live route/hostname (e.g. to release one claimed by another repo) and leaves the config file untouched."
       },
       {
-        command: "devrouter repo agents [--with-linear]",
-        purpose: "Write/update devrouter section in the repo's AGENTS.md and optionally add Linear workflow assets."
+        command: "devrouter repo agents",
+        purpose: "Write/update devrouter section in the repo's AGENTS.md and install the devrouter skill."
       },
       {
         command: "devrouter workspace up <branch> [--path <dir>] [--no-devpod] [--open]",
@@ -1841,85 +1849,6 @@ function buildDevrouterSection() {
     "- `devrouter ls`"
   ].join("\n");
 }
-function buildLinearWorkflowSection() {
-  return [
-    LINEAR_WORKFLOW_SENTINEL,
-    "## linear-workflow",
-    "",
-    "This repository can optionally use a Linear-centered workflow with a minimal workspace/team/project mapping.",
-    "Use the managed AGENTS metadata block as source of truth before creating/updating Linear issues.",
-    "",
-    "Skill and templates:",
-    `- \`${LINEAR_SKILL_REL_PATH}\``,
-    `- \`${LINEAR_ISSUE_TEMPLATE_REL_PATH}\``,
-    `- \`${LINEAR_MILESTONE_TEMPLATE_REL_PATH}\``,
-    `- \`${LINEAR_PROGRESS_TEMPLATE_REL_PATH}\``,
-    "",
-    "Managed metadata block:",
-    `- \`${LINEAR_WORKFLOW_CONFIG_START}\``,
-    `- \`${LINEAR_WORKFLOW_CONFIG_END}\``,
-    "",
-    "Required Linear execution hygiene:",
-    "- Set issue status at session start and update it at each phase transition.",
-    "- Post progress comments at meaningful checkpoints during implementation.",
-    "- Before ending a session, post a final comment with completed work, remaining work, risks, and next step.",
-    "- Re-check status and comment freshness toward/at session end before stopping.",
-    "",
-    "Bootstrap commands:",
-    "- `devrouter init --with-linear --write-agents --write-skill`",
-    "- `devrouter repo agents --with-linear`"
-  ].join("\n");
-}
-function yamlQuote(value) {
-  return JSON.stringify(value);
-}
-function renderLinearWorkflowConfig(metadata) {
-  const lines = [
-    "linear:",
-    "  workspace:",
-    `    name: ${yamlQuote(metadata.workspace.name)}`,
-    "  team:",
-    `    name: ${yamlQuote(metadata.team.name)}`
-  ];
-  if (metadata.team.key) {
-    lines.push(`    key: ${yamlQuote(metadata.team.key)}`);
-  }
-  lines.push("  project:");
-  lines.push(`    name: ${yamlQuote(metadata.project.name)}`);
-  if (metadata.project.id) {
-    lines.push(`    id: ${yamlQuote(metadata.project.id)}`);
-  }
-  lines.push(`  updated_at: ${yamlQuote(metadata.updatedAt)}`);
-  lines.push(`  capture_mode: ${yamlQuote(metadata.captureMode)}`);
-  return lines.join("\n");
-}
-function renderLinearWorkflowConfigBlock(metadata) {
-  return [
-    LINEAR_WORKFLOW_CONFIG_START,
-    "```yaml",
-    renderLinearWorkflowConfig(metadata),
-    "```",
-    LINEAR_WORKFLOW_CONFIG_END
-  ].join("\n");
-}
-function escapeRegExp(input3) {
-  return input3.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function upsertLinearWorkflowConfigBlock(content, metadata) {
-  const block = renderLinearWorkflowConfigBlock(metadata);
-  const pattern = new RegExp(
-    `${escapeRegExp(LINEAR_WORKFLOW_CONFIG_START)}[\\s\\S]*?${escapeRegExp(LINEAR_WORKFLOW_CONFIG_END)}\\n?`,
-    "m"
-  );
-  if (pattern.test(content)) {
-    return content.replace(pattern, `${block}
-`);
-  }
-  return `${content.trimEnd()}
-
-${block}
-`;
-}
 function writeRepoFile(repoPath, relPath, content) {
   const absolutePath = (0, import_node_path5.join)(repoPath, relPath);
   (0, import_node_fs5.mkdirSync)((0, import_node_path5.dirname)(absolutePath), { recursive: true });
@@ -1947,29 +1876,6 @@ function ensureAgentsMdSection(repoPath) {
   );
   return { path: filePath, written: true };
 }
-function ensureLinearWorkflowAgentsSection(repoPath, metadata) {
-  const filePath = (0, import_node_path5.join)(repoPath, AGENTS_MD);
-  if ((0, import_node_fs5.existsSync)(filePath)) {
-    let content = (0, import_node_fs5.readFileSync)(filePath, "utf-8");
-    let changed = false;
-    if (!content.includes(LINEAR_WORKFLOW_SENTINEL)) {
-      content = content.trimEnd() + "\n\n" + buildLinearWorkflowSection() + "\n";
-      changed = true;
-    }
-    const withConfig2 = upsertLinearWorkflowConfigBlock(content, metadata);
-    if (withConfig2 !== content) {
-      changed = true;
-    }
-    if (changed) {
-      (0, import_node_fs5.writeFileSync)(filePath, withConfig2, "utf-8");
-    }
-    return { path: filePath, written: changed };
-  }
-  const initialContent = "# AGENTS.md\n\n" + buildLinearWorkflowSection() + "\n";
-  const withConfig = upsertLinearWorkflowConfigBlock(initialContent, metadata);
-  (0, import_node_fs5.writeFileSync)(filePath, withConfig, "utf-8");
-  return { path: filePath, written: true };
-}
 function ensureSkillFile(repoPath) {
   const filePath = writeRepoFile(
     repoPath,
@@ -1978,47 +1884,15 @@ function ensureSkillFile(repoPath) {
   );
   return { path: filePath, written: true };
 }
-function ensureLinearWorkflowSkillFiles(repoPath) {
-  const paths = [
-    writeRepoFile(
-      repoPath,
-      LINEAR_SKILL_REL_PATH,
-      LINEAR_WORKFLOW_SKILL_CONTENT
-    ),
-    writeRepoFile(
-      repoPath,
-      LINEAR_ISSUE_TEMPLATE_REL_PATH,
-      LINEAR_ISSUE_TEMPLATE_CONTENT
-    ),
-    writeRepoFile(
-      repoPath,
-      LINEAR_MILESTONE_TEMPLATE_REL_PATH,
-      LINEAR_MILESTONE_TEMPLATE_CONTENT
-    ),
-    writeRepoFile(
-      repoPath,
-      LINEAR_PROGRESS_TEMPLATE_REL_PATH,
-      LINEAR_PROGRESS_TEMPLATE_CONTENT
-    )
-  ];
-  return { paths, written: true };
-}
-var import_node_fs5, import_node_path5, DEVROUTER_SENTINEL, LINEAR_WORKFLOW_SENTINEL, LINEAR_WORKFLOW_CONFIG_START, LINEAR_WORKFLOW_CONFIG_END, AGENTS_MD, DEVROUTER_SKILL_REL_PATH, LINEAR_SKILL_REL_PATH, LINEAR_ISSUE_TEMPLATE_REL_PATH, LINEAR_MILESTONE_TEMPLATE_REL_PATH, LINEAR_PROGRESS_TEMPLATE_REL_PATH, DEVROUTER_SKILL_CONTENT, LINEAR_WORKFLOW_SKILL_CONTENT, LINEAR_ISSUE_TEMPLATE_CONTENT, LINEAR_MILESTONE_TEMPLATE_CONTENT, LINEAR_PROGRESS_TEMPLATE_CONTENT;
+var import_node_fs5, import_node_path5, DEVROUTER_SENTINEL, AGENTS_MD, DEVROUTER_SKILL_REL_PATH, DEVROUTER_SKILL_CONTENT;
 var init_agents_md = __esm({
   "src/core/agents-md.ts"() {
     "use strict";
     import_node_fs5 = require("fs");
     import_node_path5 = require("path");
     DEVROUTER_SENTINEL = "<!-- devrouter -->";
-    LINEAR_WORKFLOW_SENTINEL = "<!-- devrouter-linear-workflow -->";
-    LINEAR_WORKFLOW_CONFIG_START = "<!-- devrouter-linear-workflow-config:start -->";
-    LINEAR_WORKFLOW_CONFIG_END = "<!-- devrouter-linear-workflow-config:end -->";
     AGENTS_MD = "AGENTS.md";
     DEVROUTER_SKILL_REL_PATH = ".agents/skills/devrouter/SKILL.md";
-    LINEAR_SKILL_REL_PATH = ".agents/skills/linear-workflow/SKILL.md";
-    LINEAR_ISSUE_TEMPLATE_REL_PATH = ".agents/skills/linear-workflow/references/LINEAR_ISSUE_TEMPLATE.md";
-    LINEAR_MILESTONE_TEMPLATE_REL_PATH = ".agents/skills/linear-workflow/references/MILESTONE_PLAN_TEMPLATE.md";
-    LINEAR_PROGRESS_TEMPLATE_REL_PATH = ".agents/skills/linear-workflow/references/PROGRESS_UPDATE_TEMPLATE.md";
     DEVROUTER_SKILL_CONTENT = `---
 name: devrouter
 description: Work with devrouter for local dev routing (HTTP + TCP/Postgres + dependency-only Docker services)
@@ -2198,20 +2072,9 @@ Run several worktrees of one repo in parallel without host/route collisions. A *
 - After upgrading the CLI in a dependent repo, refresh discoverability artifacts with \`devrouter repo agents\` (or \`devrouter init --write-agents --write-skill\`).
 - Re-run validation after upgrade: \`devrouter doctor --repo .\`, \`devrouter app ls --repo .\`, one representative \`devrouter app exec\` flow, and \`devrouter ls\`.
 
-## Optional Linear workflow bootstrap
-
-- To add Linear task-management workflow assets to a repo, run:
-  - \`devrouter init --with-linear --write-agents --write-skill\`, or
-  - \`devrouter repo agents --with-linear\`
-- This writes \`.agents/skills/linear-workflow/SKILL.md\` and reference templates, plus an idempotent AGENTS section.
-- On AGENTS write flows, devrouter asks for minimal Linear mapping (workspace/team/project) and stores it in a managed AGENTS block:
-  - \`<!-- devrouter-linear-workflow-config:start -->\`
-  - \`<!-- devrouter-linear-workflow-config:end -->\`
-- In non-interactive mode, placeholder values are written and should be replaced in the next interactive session.
-
 ## Commands
 
-- \`devrouter init [--write-agents] [--write-skill] [--with-linear]\`: print AI onboarding prompt (non-mutating by default)
+- \`devrouter init [--write-agents] [--write-skill]\`: print AI onboarding prompt (non-mutating by default)
 - \`devrouter -V [--repo .]\`: show installed CLI version, local repo version, and next upgrade target
 - \`devrouter upgrade [version] [--repo .]\`: list upgrade targets or print target Agent Adaptation Prompt
 - \`devrouter setup --yes [--repo .] [--json]\`: first-run machine setup plus structured diagnostics
@@ -2228,7 +2091,7 @@ Run several worktrees of one repo in parallel without host/route collisions. A *
 - \`devrouter repo devcontainer write --yes\`: write managed Node/pnpm/Postgres devcontainer/devrouter scaffold files when no custom-file conflicts exist
 - \`devrouter repo devcontainer verify --json\`: emit read-only onboarding evidence for PRs
 - \`devrouter repo devcontainer verify --live --yes --json\`: register proxy routes and probe HTTP routes after the devcontainer is running
-- \`devrouter repo agents [--with-linear]\`: write devrouter section in AGENTS.md + install this skill (and optional Linear workflow assets)
+- \`devrouter repo agents\`: write devrouter section in AGENTS.md + install this skill
 - \`devrouter app add\`: add/update app entry in \`.devrouter.yml\`
 - \`devrouter app ls\`: list app entries
 - \`devrouter app run <name> [--env <env>] [--workspace <slug>]\`: run app with dependency lifecycle (--env overrides SM defaultEnv; --workspace overrides the per-workspace token)
@@ -2272,214 +2135,6 @@ For existing host/docker runtime apps:
 - \`devrouter app exec --shell\` is explicit and requires exactly one command string after \`--\`.
 - Secret-manager overlap caveat: if Infisical/Doppler defines DB vars too, probe effective env (\`printenv DB_URL DB_HOST DB_PORT\`) before migrate/seed.
 `;
-    LINEAR_WORKFLOW_SKILL_CONTENT = `---
-name: linear-workflow
-description: Use a minimal Linear workspace/team/project mapping for cross-session continuity
-user-invocable: false
----
-
-# linear-workflow
-
-Use this skill when a repository enables Linear workflow via devrouter.
-
-## First step: read AGENTS mapping
-
-Check \`AGENTS.md\` for the managed Linear block:
-
-- \`<!-- devrouter-linear-workflow-config:start -->\`
-- \`<!-- devrouter-linear-workflow-config:end -->\`
-
-Use that block as source of truth for:
-
-- workspace name
-- team name (and optional key)
-- project name (and optional id)
-
-## If mapping is missing or placeholder
-
-Ask the user these guided questions and update the AGENTS managed block:
-
-1. Which Linear workspace does this repository belong to?
-2. Which Linear team owns this repository? (optional team key)
-3. Which Linear project should milestones/issues be created in? (optional project id)
-
-If non-interactive context prevents asking, keep placeholders and request values in the next interactive session.
-
-## Usage rule
-
-- Do not hardcode workspace/team/project assumptions.
-- Always resolve them from AGENTS metadata first.
-
-## Required execution hygiene
-
-When working on Linear-tracked issues, this is required:
-
-1. Set issue status at session start and update it at each phase transition.
-2. Post progress comments at meaningful checkpoints during implementation.
-3. Before ending a session, post a final comment with completed work, remaining work, risks, and next step.
-4. Re-check status and comment freshness toward/at session end before stopping.
-
-## Devrouter-specific note
-
-If the repository uses devrouter, use \`devrouter upgrade\` to resolve the required Agent Adaptation Prompt for the target version before major changes (prompt files are versioned under \`upgrade-prompts/<version>.md\`).
-`;
-    LINEAR_ISSUE_TEMPLATE_CONTENT = `# Linear Issue Template
-
-## Problem
-
-## Goal / Expected Outcome
-
-## Scope
-- In scope:
-- Out of scope:
-
-## Technical Approach
-
-## Acceptance Criteria
-
-## Validation Plan
-
-## Dependencies / Blockers
-
-## Rollout Risks
-`;
-    LINEAR_MILESTONE_TEMPLATE_CONTENT = `# Milestone Plan Template
-
-## Milestone Goal
-
-## Tracker Issue
-- Identifier:
-- Owner:
-
-## Child Issues
-- [ ] Issue 1:
-- [ ] Issue 2:
-- [ ] Issue 3:
-
-## Sequencing
-1.
-2.
-3.
-
-## Risks and Mitigations
-
-## Definition of Done
-`;
-    LINEAR_PROGRESS_TEMPLATE_CONTENT = `# Progress Update Template
-
-## Summary
-
-## Completed
-- <item>
-
-## In Progress
-- <item>
-
-## Next
-- <item>
-
-## Risks / Blockers
-- <item>
-`;
-  }
-});
-
-// src/core/linear-onboarding.ts
-function isoTimestamp(now) {
-  return (now ?? /* @__PURE__ */ new Date()).toISOString();
-}
-function requiredPlaceholder(path16) {
-  return `<REQUIRED: ${path16}>`;
-}
-function normalizeOptionalValue(value) {
-  const trimmed = value.trim();
-  return trimmed.length > 0 ? trimmed : void 0;
-}
-async function askRequired(askQuestion, question, fieldName) {
-  while (true) {
-    const answer = (await askQuestion(question)).trim();
-    if (answer.length > 0) {
-      return answer;
-    }
-    import_node_process.stdout.write(`${fieldName} is required. Please enter a value.
-`);
-  }
-}
-function buildPlaceholderLinearWorkflowMetadata(now) {
-  return {
-    workspace: {
-      name: requiredPlaceholder("workspace.name")
-    },
-    team: {
-      name: requiredPlaceholder("team.name")
-    },
-    project: {
-      name: requiredPlaceholder("project.name")
-    },
-    updatedAt: isoTimestamp(now),
-    captureMode: "placeholder"
-  };
-}
-async function collectLinearWorkflowMetadata(options = {}) {
-  const interactive = options.isInteractive ?? Boolean(import_node_process.stdin.isTTY && import_node_process.stdout.isTTY);
-  if (!interactive) {
-    return buildPlaceholderLinearWorkflowMetadata(options.now);
-  }
-  if (options.askQuestion) {
-    const workspaceName = await askRequired(options.askQuestion, "Linear workspace name: ", "workspace.name");
-    const teamName = await askRequired(options.askQuestion, "Linear team name: ", "team.name");
-    const teamKey = normalizeOptionalValue(await options.askQuestion("Linear team key (optional): "));
-    const projectName = await askRequired(options.askQuestion, "Linear project name: ", "project.name");
-    const projectId = normalizeOptionalValue(await options.askQuestion("Linear project id (optional): "));
-    return {
-      workspace: {
-        name: workspaceName
-      },
-      team: {
-        name: teamName,
-        ...teamKey ? { key: teamKey } : {}
-      },
-      project: {
-        name: projectName,
-        ...projectId ? { id: projectId } : {}
-      },
-      updatedAt: isoTimestamp(options.now),
-      captureMode: "interactive"
-    };
-  }
-  const rl = (0, import_promises.createInterface)({ input: import_node_process.stdin, output: import_node_process.stdout });
-  try {
-    const ask = (question) => rl.question(question);
-    const workspaceName = await askRequired(ask, "Linear workspace name: ", "workspace.name");
-    const teamName = await askRequired(ask, "Linear team name: ", "team.name");
-    const teamKey = normalizeOptionalValue(await ask("Linear team key (optional): "));
-    const projectName = await askRequired(ask, "Linear project name: ", "project.name");
-    const projectId = normalizeOptionalValue(await ask("Linear project id (optional): "));
-    return {
-      workspace: {
-        name: workspaceName
-      },
-      team: {
-        name: teamName,
-        ...teamKey ? { key: teamKey } : {}
-      },
-      project: {
-        name: projectName,
-        ...projectId ? { id: projectId } : {}
-      },
-      updatedAt: isoTimestamp(options.now),
-      captureMode: "interactive"
-    };
-  } finally {
-    rl.close();
-  }
-}
-var import_node_process, import_promises;
-var init_linear_onboarding = __esm({
-  "src/core/linear-onboarding.ts"() {
-    "use strict";
-    import_node_process = require("process");
-    import_promises = require("readline/promises");
   }
 });
 
@@ -2766,14 +2421,13 @@ var init_exports = {};
 __export(init_exports, {
   runInitCommand: () => runInitCommand
 });
-async function runInitCommand(options, deps = {}) {
+async function runInitCommand(options) {
   if (options.json && (options.writeAgents || options.writeSkill)) {
     throw new Error("--json cannot be combined with --write-agents or --write-skill.");
   }
   const prompt = buildOnboardingPrompt({
     repo: options.repo,
-    entriesJson: options.entriesJson,
-    withLinear: Boolean(options.withLinear)
+    entriesJson: options.entriesJson
   });
   if (options.json) {
     printJSON({
@@ -2793,13 +2447,6 @@ async function runInitCommand(options, deps = {}) {
     process.stdout.write(`
 Wrote skill to ${skill.path}
 `);
-    if (options.withLinear) {
-      const linearSkills = ensureLinearWorkflowSkillFiles(repoPath);
-      for (const filePath of linearSkills.paths) {
-        process.stdout.write(`Wrote Linear workflow artifact to ${filePath}
-`);
-      }
-    }
   }
   if (options.writeAgents) {
     const result = ensureAgentsMdSection(repoPath);
@@ -2810,22 +2457,6 @@ Wrote skill to ${skill.path}
       process.stdout.write(`devrouter section already present: ${result.path}
 `);
     }
-    if (options.withLinear) {
-      const linearMetadata = await (deps.collectLinearMetadata ?? collectLinearWorkflowMetadata)();
-      if (linearMetadata.captureMode === "placeholder") {
-        process.stdout.write(
-          "Warning: non-interactive mode detected; wrote placeholder Linear mapping values. Re-run in a TTY to capture workspace/team/project.\n"
-        );
-      }
-      const linearAgents = ensureLinearWorkflowAgentsSection(repoPath, linearMetadata);
-      if (linearAgents.written) {
-        process.stdout.write(`Wrote Linear workflow section to ${linearAgents.path}
-`);
-      } else {
-        process.stdout.write(`Linear workflow section already present: ${linearAgents.path}
-`);
-      }
-    }
   }
 }
 var init_init = __esm({
@@ -2833,7 +2464,6 @@ var init_init = __esm({
     "use strict";
     init_ai_prompt();
     init_agents_md();
-    init_linear_onboarding();
     init_output();
     init_repo_config();
   }
@@ -3753,8 +3383,8 @@ var init_route_state = __esm({
 function outputFromResult(result) {
   const stdout = typeof result.stdout === "string" ? result.stdout.trim() : "";
   const stderr = typeof result.stderr === "string" ? result.stderr.trim() : "";
-  const output3 = [stdout, stderr].filter(Boolean).join("\n").trim();
-  return output3.length > 0 ? output3 : void 0;
+  const output2 = [stdout, stderr].filter(Boolean).join("\n").trim();
+  return output2.length > 0 ? output2 : void 0;
 }
 function runTool(command, args = []) {
   const result = (0, import_node_child_process5.spawnSync)(command, args, {
@@ -3766,14 +3396,14 @@ function runTool(command, args = []) {
       error: result.error.message
     };
   }
-  const output3 = outputFromResult(result);
+  const output2 = outputFromResult(result);
   if (result.status === 0) {
-    return { ok: true, output: output3 };
+    return { ok: true, output: output2 };
   }
   return {
     ok: false,
-    output: output3,
-    error: output3 ?? `${command} ${args.join(" ")} exited with status ${result.status ?? "unknown"}`
+    output: output2,
+    error: output2 ?? `${command} ${args.join(" ")} exited with status ${result.status ?? "unknown"}`
   };
 }
 function firstLine(value) {
@@ -4434,6 +4064,22 @@ async function buildDoctorReport(options = {}) {
       const config = runtimeConfig.config;
       loadedConfig = config;
       loadedWorkspace = runtimeConfig.workspace;
+      const cliVersion = true ? "0.0.25" : "0.0.0-dev";
+      const configVersion = config.devrouter?.version;
+      if (configVersion && cliVersion !== "0.0.0-dev" && compareSemver(configVersion, cliVersion) > 0) {
+        addCheck(checks, {
+          id: "repo.cli-outdated",
+          level: "error",
+          summary: `Installed CLI (${cliVersion}) is older than required repo version (${configVersion}).`,
+          suggestion: "Upgrade CLI: npm install -g @devrouter/cli"
+        });
+      } else {
+        addCheck(checks, {
+          id: "repo.cli-outdated",
+          level: "ok",
+          summary: "Installed CLI version is compatible with repo configuration."
+        });
+      }
       const appNames = new Set(config.apps.map((app) => app.name));
       const missingDependencies = config.apps.flatMap(
         (app) => app.dependencies.filter((dependency) => !appNames.has(dependency.app)).map((dependency) => `${app.name}->${dependency.app}`)
@@ -5583,44 +5229,17 @@ var repo_agents_exports = {};
 __export(repo_agents_exports, {
   runRepoAgentsCommand: () => runRepoAgentsCommand
 });
-async function runRepoAgentsCommand(options, deps = {}) {
+async function runRepoAgentsCommand(options) {
   const repoPath = resolveRepoPath(options.repo);
-  let linearMetadata = null;
   const skill = ensureSkillFile(repoPath);
   process.stdout.write(`Wrote skill to ${skill.path}
 `);
-  if (options.withLinear) {
-    linearMetadata = await (deps.collectLinearMetadata ?? collectLinearWorkflowMetadata)();
-    if (linearMetadata.captureMode === "placeholder") {
-      process.stdout.write(
-        "Warning: non-interactive mode detected; wrote placeholder Linear mapping values. Re-run in a TTY to capture workspace/team/project.\n"
-      );
-    }
-    const linearSkills = ensureLinearWorkflowSkillFiles(repoPath);
-    for (const filePath of linearSkills.paths) {
-      process.stdout.write(`Wrote Linear workflow artifact to ${filePath}
-`);
-    }
-  }
   const result = ensureAgentsMdSection(repoPath);
   if (!result.written) {
     process.stdout.write(`devrouter section already present: ${result.path}
 `);
   } else {
     process.stdout.write(`Wrote devrouter section to ${result.path}
-`);
-  }
-  if (options.withLinear) {
-    if (!linearMetadata) {
-      throw new Error("Linear metadata was not collected.");
-    }
-    const linearAgents = ensureLinearWorkflowAgentsSection(repoPath, linearMetadata);
-    if (!linearAgents.written) {
-      process.stdout.write(`Linear workflow section already present: ${linearAgents.path}
-`);
-      return;
-    }
-    process.stdout.write(`Wrote Linear workflow section to ${linearAgents.path}
 `);
   }
 }
@@ -5629,7 +5248,6 @@ var init_repo_agents = __esm({
     "use strict";
     init_repo_config();
     init_agents_md();
-    init_linear_onboarding();
   }
 });
 
@@ -7264,7 +6882,7 @@ async function shouldStartDependencies(appName, dependencies, yes) {
       ).join(", ")}). Re-run with --yes in non-interactive mode.`
     );
   }
-  const rl = (0, import_promises2.createInterface)({ input: import_node_process2.stdin, output: import_node_process2.stdout });
+  const rl = (0, import_promises.createInterface)({ input: import_node_process.stdin, output: import_node_process.stdout });
   try {
     const answer = await rl.question(
       `Start dependencies for '${appName}' (${dependencyNames2(dependencies).join(", ")})? [y/N] `
@@ -7553,14 +7171,14 @@ async function execWithAppEnv(options) {
     deps.stopDeps();
   }
 }
-var import_node_net, import_promises2, import_node_child_process11, import_node_process2, POLL_INTERVAL_MS, DEFAULT_PORT_TIMEOUT_MS, PROCESS_TERMINATION_GRACE_MS;
+var import_node_net, import_promises, import_node_child_process11, import_node_process, POLL_INTERVAL_MS, DEFAULT_PORT_TIMEOUT_MS, PROCESS_TERMINATION_GRACE_MS;
 var init_app_run = __esm({
   "src/core/app-run.ts"() {
     "use strict";
     import_node_net = __toESM(require("net"));
-    import_promises2 = require("readline/promises");
+    import_promises = require("readline/promises");
     import_node_child_process11 = require("child_process");
-    import_node_process2 = require("process");
+    import_node_process = require("process");
     init_docker_run();
     init_repo_config();
     init_host_routes();
@@ -7949,7 +7567,7 @@ var init_version = __esm({
 
 // src/cli.ts
 var import_commander = require("commander");
-var CLI_VERSION = true ? "0.0.24" : "0.0.0-dev";
+var CLI_VERSION = true ? "0.0.25" : "0.0.0-dev";
 var VERSION_FLAGS = /* @__PURE__ */ new Set(["-V", "--version"]);
 function withErrorHandling(action2) {
   return async (...args) => {
@@ -7965,7 +7583,7 @@ function withErrorHandling(action2) {
 }
 var program = new import_commander.Command();
 program.name("devrouter").description("Local dev router CLI for stable .localhost routing across repositories").showSuggestionAfterError(true).showHelpAfterError();
-program.command("init").description("Print an AI onboarding prompt template for adapting a repository to devrouter").option("--repo <path>", "Repository path to embed in the prompt (defaults to current directory)").option("--entries-json <json>", "Optional JSON array of app entries to embed in the prompt").option("--json", "Output prompt and command intents as JSON").option("--write-agents", "Write/update devrouter section in AGENTS.md").option("--write-skill", "Write .agents/skills/devrouter/SKILL.md").option("--with-linear", "Include optional Linear workflow guidance/artifacts when writing").action(withErrorHandling(async (options) => {
+program.command("init").description("Print an AI onboarding prompt template for adapting a repository to devrouter").option("--repo <path>", "Repository path to embed in the prompt (defaults to current directory)").option("--entries-json <json>", "Optional JSON array of app entries to embed in the prompt").option("--json", "Output prompt and command intents as JSON").option("--write-agents", "Write/update devrouter section in AGENTS.md").option("--write-skill", "Write .agents/skills/devrouter/SKILL.md").action(withErrorHandling(async (options) => {
   const { runInitCommand: runInitCommand2 } = await Promise.resolve().then(() => (init_init(), init_exports));
   await runInitCommand2(options);
 }));
@@ -8015,7 +7633,7 @@ repoCommand.command("inspect").description("Inspect repository stack facts for a
   const { runRepoInspectCommand: runRepoInspectCommand2 } = await Promise.resolve().then(() => (init_repo_inspect2(), repo_inspect_exports));
   await runRepoInspectCommand2(options);
 }));
-repoCommand.command("agents").description("Write/update devrouter section in the repo's AGENTS.md").option("--repo <path>", "Repository path (defaults to current directory)").option("--with-linear", "Also install optional Linear workflow skill/assets and AGENTS section").action(withErrorHandling(async (options) => {
+repoCommand.command("agents").description("Write/update devrouter section in the repo's AGENTS.md").option("--repo <path>", "Repository path (defaults to current directory)").action(withErrorHandling(async (options) => {
   const { runRepoAgentsCommand: runRepoAgentsCommand2 } = await Promise.resolve().then(() => (init_repo_agents(), repo_agents_exports));
   await runRepoAgentsCommand2(options);
 }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devrouter/cli",
-  "version": "0.0.24",
+  "version": "0.0.25",
   "description": "Local dev routing CLI with shared Traefik reverse proxy",
   "author": "Roland Schlaefli",
   "homepage": "https://github.com/rschlaefli/devrouter#readme",
@@ -45,7 +45,7 @@
     "test:watch": "vitest",
     "routing:smoke": "./scripts/smoke-routing.sh",
     "devcontainer:smoke": "./scripts/smoke-devcontainer.sh",
-    "bench:startup": "zsh -lc 'set -euo pipefail; echo \"=== dev --help (x5) ===\"; for i in {1..5}; do /usr/bin/time -p node dist/dev.js --help >/dev/null; done; echo \"=== dev app add --help (x5) ===\"; for i in {1..5}; do /usr/bin/time -p node dist/dev.js app add --help >/dev/null; done; echo \"=== dev status --json (x3, best effort) ===\"; for i in {1..3}; do /usr/bin/time -p node dist/dev.js status --json >/dev/null || true; done'",
+    "bench:startup": "zsh -lc 'set -euo pipefail; echo \"=== dev --help (x5) ===\"; for i in {1..5}; do /usr/bin/time -p node dist/devrouter.js --help >/dev/null; done; echo \"=== dev app add --help (x5) ===\"; for i in {1..5}; do /usr/bin/time -p node dist/devrouter.js app add --help >/dev/null; done; echo \"=== dev status --json (x3, best effort) ===\"; for i in {1..3}; do /usr/bin/time -p node dist/devrouter.js status --json >/dev/null || true; done'",
     "typecheck": "tsc --noEmit",
     "bootstrap": "pnpm install && pnpm install:local",
     "install:local": "pnpm build && ./scripts/install-local.sh",

package/upgrade-prompts/0.0.24.md

@@ -0,0 +1,10 @@
+You are upgrading a repository that uses devrouter to version 0.0.24.
+
+Changes in this release:
+- Automatically inject `DEVCONTAINER_COMPOSE_OVERLAY` environment variable to workspace execution contexts when active.
+
+Task:
+1) Bump `.devrouter.yml` `devrouter.version` to `0.0.24`.
+
+Validation:
+- `devrouter -V --repo <repo>` shows `0.0.24` as the local repo version.

package/upgrade-prompts/0.0.25.md

@@ -0,0 +1,20 @@
+You are upgrading a repository that uses devrouter to version 0.0.25.
+
+Changes in this release:
+- Removed all Linear workflow integrations, templates, and flags (`--with-linear`).
+- Added real-time outdated CLI detection. When a repository config `.devrouter.yml` requires a version newer than the installed CLI version, devrouter prints a stderr warning on config load.
+- Added a diagnostic check `repo.cli-outdated` in `devrouter doctor` to flag when the installed CLI is older than the required version.
+- Cleaned up leftover `dev` / `dist/dev.js` CLI commands references in validation scripts and workspace examples.
+
+Task:
+1) Bump `.devrouter.yml` `devrouter.version` to `0.0.25`.
+2) Refresh discoverability artifacts with `devrouter repo agents --repo <repo>`.
+
+Validation:
+- `devrouter -V --repo <repo>` shows `0.0.25` as the local repo version.
+- `devrouter doctor --repo <repo>` runs successfully and reports no `repo.cli-outdated` errors if the installed CLI version is compatible.
+
+Report:
+- `.devrouter.yml` `devrouter.version` before and after
+- setup, doctor, and devcontainer verification results
+- unresolved risks or manual follow-ups