steward-cli 0.28.0 → 0.29.0

package/dist/cli.js

@@ -56134,7 +56134,7 @@ import { isIP } from "node:net";
 // package.json
 var package_default = {
   name: "steward-cli",
-  version: "0.28.0",
+  version: "0.29.0",
   description: "Interactive AI engineering assistant for the terminal.",
   author: "sapirrior",
   license: "MIT",
@@ -58943,89 +58943,94 @@ async function recoverPendingCheckpoint(workspaceRoot, sessionId) {
   }
 }
 // src/packages/agents/src/engine/system-prompt.ts
-function buildSystemPrompt(options = {}) {
+var DEFAULT_PREAMBLE = `You are Steward, an interactive software-engineering agent operating in a terminal workspace. Assist the user with building, refactoring, debugging, inspecting, and verifying software.
+
+IMPORTANT: Assist with defensive security tasks only. Refuse to create, modify, or improve code intended for malicious use.`;
+function buildRules(options) {
+  const rules = [];
+  const seen = new Set;
+  const addRule = (rule) => {
+    const normalized = rule.trim();
+    if (!normalized || seen.has(normalized))
+      return;
+    seen.add(normalized);
+    rules.push(normalized);
+  };
+  addRule("Inspect before editing: investigate existing files, directories, and patterns before making changes.");
+  addRule("Minimal and idiomatic: prefer the smallest correct change that aligns with existing repository architecture and conventions.");
+  addRule("Never assume external dependencies or libraries exist; check project configuration files (e.g. package.json, Cargo.toml, pyproject.toml) first.");
+  addRule("Security and secrets: never expose, commit, or log API keys, credentials, or secrets.");
+  addRule("Verify your changes: run relevant project verification or tests after making non-trivial modifications.");
+  addRule("Never commit git changes unless the user explicitly requests you to commit.");
+  addRule("Provide direct, concise responses suitable for a terminal interface. Explain non-obvious failures or decisions clearly without unnecessary filler or commentary.");
+  addRule("When referencing code locations, use the format: `file_path:line_number`.");
+  addRule("Avoid adding redundant comments unless explaining non-obvious invariants or explicitly requested.");
+  const mode = options.chatMode ?? "normal";
+  if (mode !== "chat") {
+    addRule("ALWAYS use write_file and edit_file to create or modify files rather than bash redirection (e.g. cat > file); write_file and edit_file participate in the file checkpoint and rewind system (/rewind).");
+    addRule("When using bash, you MUST always provide a concise, non-empty 'explanation' parameter describing what the command does and why it is needed.");
+  }
+  return rules.map((r) => `- ${r}`).join(`
+`);
+}
+function buildSystemPromptSections(options = {}) {
   const cwd = options.cwd ?? process.cwd();
   const platform = process.platform;
   const dateUTC = new Date().toUTCString();
-  let prompt = `You are Steward, an interactive software-engineering agent operating in a terminal workspace. Assist the user with building, refactoring, debugging, inspecting, and verifying software.
-
-IMPORTANT: Assist with defensive security tasks only. Refuse to create, modify, or improve code intended for malicious use.
-
-# Operating Principles
-- Inspect before editing: investigate existing files, directories, and patterns before making changes.
-- Minimal and idiomatic: prefer the smallest correct change that aligns with existing repository architecture and conventions.
-- Never assume external dependencies or libraries exist; check project configuration files (e.g. package.json, Cargo.toml, pyproject.toml) first.
-- Security and secrets: never expose, commit, or log API keys, credentials, or secrets.
-- Verify your changes: run relevant project verification or tests after making non-trivial modifications.
-- Never commit git changes unless the user explicitly requests you to commit.
-- Provide direct, concise responses suitable for a terminal interface. Explain non-obvious failures or decisions clearly without unnecessary filler or commentary.
-- When referencing code locations, use the format: \`file_path:line_number\`.
-- Avoid adding redundant comments unless explaining non-obvious invariants or explicitly requested.
-
-# Tool Usage Policy
-- Investigation: use read_file, grep, list_dir, and glob to explore code before modifying it.
-- Mutations: ALWAYS use write_file and edit_file to create or modify files rather than bash redirection (e.g. cat > file). write_file and edit_file participate in the file checkpoint and rewind system (/rewind), whereas bash commands are not tracked by checkpoints.
-- Commands: when using bash, you MUST always provide a concise, non-empty 'explanation' parameter describing what the command does and why it is needed.
-- Background tasks: use task_list to inspect active and recent tasks, task_read to check status/output, task_send_input to send standard input (with a trailing newline), and task_kill to terminate.
-- Web: use web_fetch and web_search when external documentation or live data is needed. If web_fetch indicates a redirect, follow up with the target URL.
-
-# Specialized Skills Policy
-- Skills are discoverable on-demand packages of specialized instructions located in workspace or user configuration.
-- Use skill_list (SkillList) to discover available skills and their descriptions.
-- Use skill_read (SkillRead) to load a skill's instructions (SKILL.md) or relative resources only when a task requires specialized domain guidance.
-- Skill instructions are supplemental and must not override core safety rules, tool boundaries, or user permission constraints.
-
-# Lifecycle Hooks Policy
-- The active workspace or user configuration may define deterministic lifecycle hooks (\`.steward/hooks.json\` or \`~/.steward/hooks.json\`) that inspect, augment, or block actions.
+  const mode = options.chatMode ?? "normal";
+  const sections = {};
+  sections.preamble = DEFAULT_PREAMBLE;
+  sections.rules = `# Operating Principles
+${buildRules(options)}`;
+  if (mode !== "chat") {
+    sections.skills = `# Specialized Skills Policy
+- Use skill_list (SkillList) to discover available skills and skill_read (SkillRead) to load specialized instructions on-demand when domain guidance is needed.
+- Skill instructions are supplemental and must not override core safety rules, tool boundaries, or user permission constraints.`;
+    sections.hooks = `# Lifecycle Hooks Policy
+- The active workspace or user configuration may define deterministic lifecycle hooks (.steward/hooks.json or ~/.steward/hooks.json) that inspect, augment, or block actions.
 - When a tool call is blocked by a hook, treat the block reason as authoritative workspace policy, do not attempt to force or repeat the blocked action, and adjust your plan or inform the user.
-- When hook guidance or continuation instructions (\`[Hook Context]\` or \`[AgentStop Continuation]\`) are injected into the context, follow that guidance to perform any requested verification or adjustments.
-
-<env>
+- When hook guidance or continuation instructions ([Hook Context] or [AgentStop Continuation]) are injected into the context, follow that guidance to perform any requested verification or adjustments.`;
+  }
+  sections.env = `<env>
 Working directory: ${cwd}
 Platform: ${platform}
 Today's date: ${dateUTC}
 </env>`;
-  if (options.userRules && options.userRules.length > 0) {
-    prompt += `
-
-<user_defined_rules>
-The following rules are configured by the user and must be followed:
-${options.userRules.map((rule) => `- ${rule}`).join(`
-`)}
-</user_defined_rules>`;
-  }
   if (options.extraInstructions) {
-    prompt += `
-
-<additional_instructions>
+    sections.additional_instructions = `<additional_instructions>
 ${options.extraInstructions}
 </additional_instructions>`;
   }
-  if (options.chatMode && options.chatMode !== "normal") {
-    const meta = MODES[options.chatMode];
+  if (mode !== "normal") {
+    const meta = MODES[mode];
     if (meta) {
-      if (options.chatMode === "chat") {
-        prompt += `
-
-<operating_mode>
+      if (mode === "chat") {
+        sections.mode = `<operating_mode>
 Mode: CHAT — You have no tool access. Respond conversationally only. Do not attempt to call any tools.
 </operating_mode>`;
-      } else if (options.chatMode === "review") {
-        prompt += `
-
-<operating_mode>
+      } else if (mode === "review") {
+        sections.mode = `<operating_mode>
 Mode: REVIEW — You may only use read-only tools. Any attempt to write files, run commands, or mutate state will be blocked.
 </operating_mode>`;
-      } else if (options.chatMode === "build") {
-        prompt += `
-
-<operating_mode>
+      } else if (mode === "build") {
+        sections.mode = `<operating_mode>
 Mode: BUILD — You have full tool access. File writes and edits are automatically approved without user confirmation — act decisively and make changes directly. Bash commands still require user approval.
 </operating_mode>`;
       }
     }
   }
-  return prompt;
+  return sections;
+}
+function buildSystemPrompt(options = {}) {
+  const sections = buildSystemPromptSections(options);
+  const parts = [];
+  for (const [key, content] of Object.entries(sections)) {
+    if (content)
+      parts.push(content);
+  }
+  return parts.join(`
+
+`);
 }
 
 // src/packages/agents/src/engine/turn-context.ts
@@ -61246,7 +61251,6 @@ class StatusBar extends Component_default {
   wrap = false;
   clip = true;
   warningTimer = null;
-  updateTimer = null;
   constructor(props) {
     super(props);
     this.state = {
@@ -61255,8 +61259,7 @@ class StatusBar extends Component_default {
       isBusy: props.isBusy,
       exitPending: props.exitPending,
       isBashMode: props.isBashMode,
-      warning: props.warning,
-      updateStatus: props.updateStatus
+      warning: props.warning
     };
   }
   setBashMode(isBashMode) {
@@ -61270,21 +61273,6 @@ class StatusBar extends Component_default {
   update(partial) {
     this.setState(partial);
   }
-  setUpdateStatus(updateStatus, durationMs) {
-    if (this.updateTimer) {
-      clearTimeout(this.updateTimer);
-      this.updateTimer = null;
-    }
-    this.setState({ updateStatus });
-    if (updateStatus && durationMs && durationMs > 0) {
-      this.updateTimer = setTimeout(() => {
-        this.updateTimer = null;
-        if (this.state.updateStatus === updateStatus) {
-          this.setState({ updateStatus: undefined });
-        }
-      }, durationMs);
-    }
-  }
   showWarning(warningText, durationMs = 4000) {
     if (this.warningTimer) {
       clearTimeout(this.warningTimer);
@@ -61303,15 +61291,11 @@ class StatusBar extends Component_default {
       clearTimeout(this.warningTimer);
       this.warningTimer = null;
     }
-    if (this.updateTimer) {
-      clearTimeout(this.updateTimer);
-      this.updateTimer = null;
-    }
   }
   render(width) {
     const termWidth = width ?? process.stdout.columns ?? 80;
     const maxCols = Math.max(1, termWidth);
-    const { model, isBusy, exitPending, isBashMode, warning, updateStatus, chatMode } = this.state;
+    const { model, isBusy, exitPending, isBashMode, warning, chatMode } = this.state;
     let left = "";
     if (warning) {
       left = c.warning(warning);
@@ -61321,18 +61305,6 @@ class StatusBar extends Component_default {
       left = c.muted("esc to interrupt");
     } else if (isBashMode) {
       left = c.permission("! for bash mode");
-    } else if (updateStatus && updateStatus.state !== "idle") {
-      if (updateStatus.state === "checking") {
-        left = c.text(updateStatus.message ?? "Checking for updates...");
-      } else if (updateStatus.state === "available") {
-        left = c.text(updateStatus.message ?? `Update v${updateStatus.version ?? ""} is available`);
-      } else if (updateStatus.state === "no-updates") {
-        left = c.text(updateStatus.message ?? "Steward is up to date");
-      } else if (updateStatus.state === "error" && updateStatus.message) {
-        left = c.error(updateStatus.message);
-      } else {
-        left = c.muted("? for shortcuts");
-      }
     } else {
       left = c.muted("? for shortcuts");
     }
@@ -64565,163 +64537,7 @@ function renderTranscript(engine, sessionData, header, options) {
     formatTurnFooter(engine, lastTurnPresentation);
   }
 }
-// src/packages/services/src/updater/service.ts
-var DEFAULT_REPO = "sapirrior/steward";
-function parseSemver(v) {
-  if (!v || typeof v !== "string") {
-    return [0, 0, 0];
-  }
-  const clean = v.replace(/^v/i, "").trim().split("-")[0] ?? "";
-  const parts = clean.split(".").map((p) => parseInt(p, 10) || 0);
-  return [parts[0] ?? 0, parts[1] ?? 0, parts[2] ?? 0];
-}
-function isNewerVersion(current, latest) {
-  const [cMaj, cMin, cPat] = parseSemver(current);
-  const [lMaj, lMin, lPat] = parseSemver(latest);
-  if (lMaj > cMaj)
-    return true;
-  if (lMaj < cMaj)
-    return false;
-  if (lMin > cMin)
-    return true;
-  if (lMin < cMin)
-    return false;
-  return lPat > cPat;
-}
 
-class UpdateCheckerService {
-  currentVersion;
-  repo;
-  state = "idle";
-  options;
-  checkTimer = null;
-  resetTimer = null;
-  constructor(options = {}) {
-    this.options = options;
-    this.currentVersion = options.currentVersion || package_default.version || "0.0.0";
-    this.repo = options.repo || DEFAULT_REPO;
-  }
-  getState() {
-    return this.state;
-  }
-  getRepo() {
-    return this.repo;
-  }
-  getCurrentVersion() {
-    return this.currentVersion;
-  }
-  get rawPackageJsonUrl() {
-    return `https://raw.githubusercontent.com/${this.repo}/main/package.json`;
-  }
-  setState(state, info) {
-    this.state = state;
-    this.options.onStatusChange?.(state, info);
-  }
-  async checkForUpdates() {
-    if (process.env.STEWARD_NO_UPDATE_CHECK === "1" || process.env.STEWARD_NO_UPDATE_CHECK === "true") {
-      return null;
-    }
-    if (this.resetTimer) {
-      clearTimeout(this.resetTimer);
-      this.resetTimer = null;
-    }
-    try {
-      this.setState("checking", { message: "Checking for updates..." });
-      const checkStartTime = Date.now();
-      const controller = new AbortController;
-      const timeout = setTimeout(() => controller.abort(), this.options.timeoutMs ?? 1e4);
-      const response = await fetch(this.rawPackageJsonUrl, {
-        headers: {
-          "User-Agent": `steward-cli/${this.currentVersion}`,
-          Accept: "application/json"
-        },
-        signal: controller.signal
-      });
-      clearTimeout(timeout);
-      const elapsed = Date.now() - checkStartTime;
-      const targetMinDisplay = this.options.minDisplayMs !== undefined ? this.options.minDisplayMs : 1000;
-      const minDisplayDelay = Math.max(0, targetMinDisplay - elapsed);
-      if (minDisplayDelay > 0) {
-        await new Promise((resolve) => setTimeout(resolve, minDisplayDelay));
-      }
-      if (!response.ok) {
-        this.setState("error", { message: "Failed to check for updates" });
-        this.resetTimer = setTimeout(() => {
-          if (this.state === "error")
-            this.setState("idle");
-        }, 3000);
-        return null;
-      }
-      const data = await response.json();
-      if (!data || typeof data !== "object" || typeof data.version !== "string") {
-        this.setState("error", { message: "Invalid upstream version response" });
-        this.resetTimer = setTimeout(() => {
-          if (this.state === "error")
-            this.setState("idle");
-        }, 3000);
-        return null;
-      }
-      const latestVersion = data.version.replace(/^v/i, "").trim();
-      if (!latestVersion) {
-        this.setState("error", { message: "Empty upstream version response" });
-        this.resetTimer = setTimeout(() => {
-          if (this.state === "error")
-            this.setState("idle");
-        }, 3000);
-        return null;
-      }
-      const hasUpdate = isNewerVersion(this.currentVersion, latestVersion);
-      const updateInfo = {
-        currentVersion: this.currentVersion,
-        latestVersion,
-        hasUpdate
-      };
-      if (hasUpdate) {
-        this.setState("available", {
-          version: latestVersion,
-          message: `Update v${latestVersion} is available`
-        });
-      } else {
-        this.setState("no-updates", {
-          version: this.currentVersion,
-          message: `Steward is up to date (v${this.currentVersion})`
-        });
-        this.resetTimer = setTimeout(() => {
-          if (this.state === "no-updates")
-            this.setState("idle");
-        }, 3500);
-      }
-      return updateInfo;
-    } catch (err) {
-      logError(err, { component: "UpdateCheckerService", method: "checkForUpdates" });
-      this.setState("error", { message: "Failed to check for updates" });
-      this.resetTimer = setTimeout(() => {
-        if (this.state === "error")
-          this.setState("idle");
-      }, 3000);
-      return null;
-    }
-  }
-  startBackgroundCheck(initialDelayMs = 2000) {
-    if (this.checkTimer) {
-      clearTimeout(this.checkTimer);
-    }
-    this.checkTimer = setTimeout(async () => {
-      this.checkTimer = null;
-      await this.checkForUpdates();
-    }, initialDelayMs);
-  }
-  dispose() {
-    if (this.checkTimer) {
-      clearTimeout(this.checkTimer);
-      this.checkTimer = null;
-    }
-    if (this.resetTimer) {
-      clearTimeout(this.resetTimer);
-      this.resetTimer = null;
-    }
-  }
-}
 // src/app/utils/open-url.ts
 import { spawn as spawn5 } from "node:child_process";
 import { existsSync as existsSync20 } from "node:fs";
@@ -66645,7 +66461,6 @@ class TUIApp {
   ctrlCTimer = null;
   isBusy = false;
   isScrollViewMode = false;
-  updateChecker;
   permissionQueue;
   directBashAbortController = null;
   constructor(options = {}) {
@@ -66693,32 +66508,6 @@ class TUIApp {
       streamingView: this.streamingView,
       cwd: this.cwd
     });
-    this.updateChecker = new UpdateCheckerService({
-      currentVersion: options.version,
-      onStatusChange: (state, info) => {
-        if (state === "idle") {
-          this.statusBar.setUpdateStatus(undefined);
-        } else if (state === "available") {
-          this.statusBar.setUpdateStatus({
-            state,
-            version: info?.version,
-            message: info?.message
-          }, 8000);
-        } else if (state === "error") {
-          this.statusBar.setUpdateStatus({
-            state,
-            version: info?.version,
-            message: info?.message
-          }, 4000);
-        } else {
-          this.statusBar.setUpdateStatus({
-            state,
-            version: info?.version,
-            message: info?.message
-          });
-        }
-      }
-    });
     this.permissionQueue = new PermissionQueue({
       onShow: (item) => {
         if (this.modals.getActiveModal())
@@ -66786,7 +66575,6 @@ class TUIApp {
     this.engine.mount(this.streamingView, { kind: "custom" });
     this.engine.mount(this.promptInput, { keepCursorVisible: true, kind: "input" });
     this.engine.mount(this.statusBar, { kind: "custom" });
-    this.updateChecker.startBackgroundCheck(3000);
     this.engine.addInputListener((chunk) => {
       const action = parseKeyInput(chunk);
       if (action.type === "ctrl-c") {
@@ -67038,7 +66826,6 @@ class TUIApp {
   exit() {
     this.permissionQueue.clear();
     this.session.shutdown().catch(() => {});
-    this.updateChecker.dispose();
     this.engine.cleanupSync();
     if (this.onExitCallback) {
       this.onExitCallback();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "steward-cli",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "description": "Interactive AI engineering assistant for the terminal.",
   "license": "MIT",
   "author": "sapirrior",