agenr 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## [1.2.0] - 2026-03-29
+
+The surgeon retirement pass — an autonomous agent that evaluates and retires stale knowledge entries.
+
+### Added
+
+- **Surgeon retirement pass.** A standalone agent loop powered by `@mariozechner/pi-agent-core` that evaluates knowledge entries and retires semantically stale ones. Runs as `agenr surgeon run` with full dry-run and apply modes, budget governance, and completion guards.
+- **7 surgeon tools.** `get_health_stats`, `query_candidates`, `inspect_entry`, `simulate_recall`, `retire_entry`, `update_entry`, and `complete_pass` — each adapted from the v0 surgeon for v1's simpler schema.
+- **Recall simulation without telemetry.** The `simulate_recall` tool wraps the v1 recall pipeline with a no-op telemetry adapter and optional target-entry exclusion, so the surgeon can test retrieval impact without polluting recall metrics.
+- **Surgeon CLI commands.** `agenr surgeon run`, `agenr surgeon status`, `agenr surgeon history`, and `agenr surgeon actions <run-id>` for running, inspecting, and auditing surgeon passes.
+- **Surgeon status shows evaluation coverage.** `agenr surgeon status` now displays recently evaluated vs new candidates, so you can see how much work remains before running.
+- **Surgeon model configuration in setup.** `agenr setup` and `agenr init` now include surgeon model overrides in the advanced task-specific model configuration flow.
+- **Budget and completion governance.** Cost-based budget tracking, context-limit detection, completion guards that reject premature pass completion, and continuation prompts that keep the surgeon working when budget remains.
+- **Run and action persistence.** Surgeon runs and individual actions (retirements, skips, updates) are logged to the database for auditability and recently-evaluated filtering on future runs.
+- **Database backup before apply.** Surgeon creates a timestamped backup of the knowledge database (including WAL/SHM sidecars) before executing mutations in apply mode.
+- **Surgeon configuration.** New `surgeon` section in `config.json` supporting model override, cost caps, daily cost limits, context limits, custom instructions, and per-pass protection thresholds.
+
+### Changed
+
+- **Schema version bumped to 2.** The `surgeon_runs` table is expanded with pass type, status, token/cost tracking, model, dry-run flag, and structured summary fields. A new `surgeon_run_actions` table logs individual surgeon actions with indexed `entry_id` for efficient recently-evaluated queries. Existing databases are migrated automatically via `ALTER TABLE ADD COLUMN`.
+- **Protection threshold raised to importance ≥ 9.** Entries with importance 8 are now eligible for surgeon evaluation since many entries default to importance 8 during ingestion.
+- **Setup prompt updated.** The advanced model override prompt now reads "Customize task-specific models?" to reflect the addition of surgeon alongside extraction and dedup overrides.
+
+### Fixed
+
+- **Tightened npm publish surface.** Root package now uses a strict `"files"` allowlist so only intended artifacts are published.
+
 ## [1.1.0] - 2026-03-28
 
 This release splits the OpenClaw plugin into its own publishable npm package and tightens session-start handoff reliability.

package/dist/{chunk-B5C3FEPR.js → chunk-YU3EWRVT.js}

@@ -432,7 +432,7 @@ function normalizeInteger(value, fallback) {
 }
 
 // src/adapters/db/schema.ts
-var SCHEMA_VERSION = "1";
+var SCHEMA_VERSION = "2";
 var VECTOR_INDEX_NAME = "idx_entries_embedding";
 var BULK_WRITE_STATE_META_KEY = "bulk_write_state";
 var CREATE_ENTRIES_TABLE_SQL = `
@@ -515,12 +515,49 @@ var CREATE_RECALL_EVENTS_TABLE_SQL = `
 var CREATE_SURGEON_RUNS_TABLE_SQL = `
   CREATE TABLE IF NOT EXISTS surgeon_runs (
     id TEXT PRIMARY KEY,
+    pass_type TEXT NOT NULL DEFAULT 'retirement',
+    project TEXT,
     started_at TEXT NOT NULL,
     completed_at TEXT,
+    status TEXT NOT NULL DEFAULT 'running',
+    input_tokens INTEGER DEFAULT 0,
+    output_tokens INTEGER DEFAULT 0,
+    estimated_cost_usd REAL DEFAULT 0,
+    model TEXT,
     actions_taken INTEGER DEFAULT 0,
-    summary TEXT
+    actions_skipped INTEGER DEFAULT 0,
+    entries_retired INTEGER DEFAULT 0,
+    summary TEXT,
+    summary_json TEXT,
+    error TEXT,
+    dry_run INTEGER NOT NULL DEFAULT 1,
+    config_json TEXT
   )
 `;
+var CREATE_SURGEON_RUN_ACTIONS_TABLE_SQL = `
+  CREATE TABLE IF NOT EXISTS surgeon_run_actions (
+    id TEXT PRIMARY KEY,
+    run_id TEXT NOT NULL REFERENCES surgeon_runs(id),
+    action_type TEXT NOT NULL,
+    entry_id TEXT,
+    entry_ids TEXT NOT NULL DEFAULT '[]',
+    reasoning TEXT NOT NULL DEFAULT '',
+    recall_delta TEXT,
+    created_at TEXT NOT NULL
+  )
+`;
+var CREATE_SURGEON_RUN_ACTIONS_RUN_ID_INDEX_SQL = `
+  CREATE INDEX IF NOT EXISTS idx_surgeon_run_actions_run_id
+  ON surgeon_run_actions(run_id)
+`;
+var CREATE_SURGEON_RUN_ACTIONS_ENTRY_ID_INDEX_SQL = `
+  CREATE INDEX IF NOT EXISTS idx_surgeon_run_actions_entry_id
+  ON surgeon_run_actions(entry_id)
+`;
+var CREATE_SURGEON_RUN_ACTIONS_CREATED_AT_INDEX_SQL = `
+  CREATE INDEX IF NOT EXISTS idx_surgeon_run_actions_created_at
+  ON surgeon_run_actions(created_at)
+`;
 var CREATE_META_TABLE_SQL = `
   CREATE TABLE IF NOT EXISTS _meta (
     key TEXT PRIMARY KEY,
@@ -598,6 +635,7 @@ async function initSchema(db) {
   for (const statement of SCHEMA_STATEMENTS) {
     await db.execute(statement);
   }
+  await ensureSurgeonSchema(db);
   await db.execute({
     sql: `
       INSERT INTO _meta (key, value)
@@ -615,6 +653,45 @@ async function initSchema(db) {
   }
   await ensureVectorIndex(db);
 }
+async function ensureSurgeonSchema(db) {
+  const columns = await db.execute("PRAGMA table_info('surgeon_runs')");
+  const existingColumns = new Set(
+    columns.rows.map((row) => {
+      const name = row.name;
+      return typeof name === "string" ? name : "";
+    }).filter((name) => name.length > 0)
+  );
+  const migrations = [
+    {
+      column: "pass_type",
+      sql: "ALTER TABLE surgeon_runs ADD COLUMN pass_type TEXT NOT NULL DEFAULT 'retirement'"
+    },
+    { column: "project", sql: "ALTER TABLE surgeon_runs ADD COLUMN project TEXT" },
+    {
+      column: "status",
+      sql: "ALTER TABLE surgeon_runs ADD COLUMN status TEXT NOT NULL DEFAULT 'completed'"
+    },
+    { column: "input_tokens", sql: "ALTER TABLE surgeon_runs ADD COLUMN input_tokens INTEGER DEFAULT 0" },
+    { column: "output_tokens", sql: "ALTER TABLE surgeon_runs ADD COLUMN output_tokens INTEGER DEFAULT 0" },
+    { column: "estimated_cost_usd", sql: "ALTER TABLE surgeon_runs ADD COLUMN estimated_cost_usd REAL DEFAULT 0" },
+    { column: "model", sql: "ALTER TABLE surgeon_runs ADD COLUMN model TEXT" },
+    { column: "actions_skipped", sql: "ALTER TABLE surgeon_runs ADD COLUMN actions_skipped INTEGER DEFAULT 0" },
+    { column: "entries_retired", sql: "ALTER TABLE surgeon_runs ADD COLUMN entries_retired INTEGER DEFAULT 0" },
+    { column: "summary_json", sql: "ALTER TABLE surgeon_runs ADD COLUMN summary_json TEXT" },
+    { column: "error", sql: "ALTER TABLE surgeon_runs ADD COLUMN error TEXT" },
+    { column: "dry_run", sql: "ALTER TABLE surgeon_runs ADD COLUMN dry_run INTEGER NOT NULL DEFAULT 1" },
+    { column: "config_json", sql: "ALTER TABLE surgeon_runs ADD COLUMN config_json TEXT" }
+  ];
+  for (const migration of migrations) {
+    if (!existingColumns.has(migration.column)) {
+      await db.execute(migration.sql);
+    }
+  }
+  await db.execute(CREATE_SURGEON_RUN_ACTIONS_TABLE_SQL);
+  await db.execute(CREATE_SURGEON_RUN_ACTIONS_RUN_ID_INDEX_SQL);
+  await db.execute(CREATE_SURGEON_RUN_ACTIONS_ENTRY_ID_INDEX_SQL);
+  await db.execute(CREATE_SURGEON_RUN_ACTIONS_CREATED_AT_INDEX_SQL);
+}
 async function rebuildFts(db) {
   await db.execute("INSERT INTO entries_fts(entries_fts) VALUES ('rebuild')");
 }
@@ -893,6 +970,12 @@ var DEFAULT_CONFIG_DIR = path2.join(os.homedir(), ".agenr");
 var DEFAULT_DB_NAME = "knowledge.db";
 var CONFIG_DIR_MODE = 448;
 var CONFIG_FILE_MODE = 384;
+var DEFAULT_SURGEON_COST_CAP = 15;
+var DEFAULT_SURGEON_DAILY_COST_CAP = 75;
+var DEFAULT_SURGEON_CONTEXT_LIMIT = 0;
+var DEFAULT_SURGEON_RETIREMENT_PROTECT_RECALLED_DAYS = 14;
+var DEFAULT_SURGEON_RETIREMENT_PROTECT_MIN_IMPORTANCE = 9;
+var DEFAULT_SURGEON_SKIP_RECENTLY_EVALUATED_DAYS = 7;
 function isAgenrAuthMethod(value) {
   return AUTH_METHOD_SET.has(value);
 }
@@ -1430,7 +1513,23 @@ function wrapVectorError(error) {
 }
 
 export {
+  buildActiveEntryClause,
+  deserializeTags,
+  readRequiredString,
+  readOptionalString,
+  readNumber,
+  readBoolean,
+  mapEntryRow,
+  getEntry,
+  retireEntry,
+  updateEntry,
   createDatabase,
+  DEFAULT_SURGEON_COST_CAP,
+  DEFAULT_SURGEON_DAILY_COST_CAP,
+  DEFAULT_SURGEON_CONTEXT_LIMIT,
+  DEFAULT_SURGEON_RETIREMENT_PROTECT_RECALLED_DAYS,
+  DEFAULT_SURGEON_RETIREMENT_PROTECT_MIN_IMPORTANCE,
+  DEFAULT_SURGEON_SKIP_RECENTLY_EVALUATED_DAYS,
   isAgenrAuthMethod,
   authMethodToProvider,
   getAuthMethodDefinition,