@bpinternal/overwatch 0.1.0

package/dist/types.js

@@ -0,0 +1,17 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/types.ts"],
+  "sourcesContent": ["import type { Agent } from \"./agents\";\nimport type { Actuator, CommentActuator } from \"./actuators\";\nimport type { Sensor } from \"./sensors\";\nimport type { Picker } from \"./pickers\";\nimport type { GitSource, PrComment } from \"./github\";\n\nexport type SignalPriority = \"low\" | \"medium\" | \"high\";\n\n/**\n * An anomaly detected by the sensor.\n *\n * Identity note: after a fix, line numbers shift, so a signal is considered \"the same\"\n * across sensor runs when its `location.file` and `message` match \u2014 `location.line` is\n * informational only. Keep `message` stable for a given anomaly (don't embed line numbers\n * or timestamps in it).\n */\nexport interface Signal<TData = unknown> {\n  /**\n   * Where the anomaly lives. Optional \u2014 some anomalies are repo-wide or not tied to a\n   * single place. When present, `file` anchors the signal's identity (see note above).\n   */\n  location?: { file: string; line?: number };\n  message: string;\n  /** Optional; treated as unset (rather than a default) wherever no priority is given. */\n  priority?: SignalPriority;\n  /**\n   * Anything the sensor wants to carry through to the picker and actuator untouched.\n   * `TData` is inferred from the sensor, so an actuator paired with it sees this exact\n   * type on `signal.data` (see {@link ControlLoopOptions}).\n   */\n  data?: TData;\n}\n\n/**\n * Constructor argument of ControlLoop: identity and static settings, behavior alongside them.\n *\n * `TData` is inferred from the `sensor` and flows to the `picker` and `actuator`, so the\n * `data` a sensor attaches to its signals reaches the actuator with the same static type.\n */\nexport interface ControlLoopOptions<TData = unknown> {\n  /**\n   * Human-readable name of the loop. Its slug (e.g. \"My Loop\" -> \"my-loop\") is applied\n   * as a label on every PR the loop opens, and is what `config.maxOpenPrCount` counts\n   * against.\n   */\n  label: string;\n  config: ControlLoopConfig;\n  sensor: Sensor<TData>;\n  /** Defaults to `pickers.count(1)`. */\n  picker?: Picker<TData>;\n  actuator: Actuator<TData>;\n  /** Customizes the instructions built from PR comments in `applyPrComments`. */\n  commentActuator?: CommentActuator;\n}\n\nexport interface ControlLoopConfig {\n  /** Skip the run entirely if this many PRs with the loop's label are already open. */\n  maxOpenPrCount?: number;\n  /**\n   * Prefix of the branches the loop pushes, e.g. \"bots/cleanup\" ->\n   * \"bots/cleanup/<label-slug>-<run-id>\". Default \"control-loop\".\n   */\n  branchPrefix?: string;\n  git: GitSource;\n  agent: Agent;\n  /** Shell commands the loop runs inside the sandbox, all from the repo root. */\n  hooks?: {\n    /**\n     * Run right after cloning, before the sensor and agent (e.g. \"bun install\" to set\n     * up dependencies). The run aborts if it exits non-zero.\n     */\n    setup?: string;\n    /**\n     * Run after the agent finishes and before committing \u2014 typically the repo's\n     * auto-fix formatter (e.g. \"bun run fix:format\"). It normalizes everything the\n     * loop commits (agent edits and lib-generated files alike) so the PR passes repo\n     * formatting checks. The run aborts if it exits non-zero.\n     */\n    preCommit?: string;\n  };\n  /** Environment variables set on the sandbox at creation. */\n  env?: Record<string, string>;\n  /** Max agent attempts per signal before the run is declared failed. Default 3. */\n  maxFixAttempts?: number;\n  sandbox?: {\n    /**\n     * Daytona snapshot to create the sandbox from. Pre-bake your toolchain and the\n     * agent's CLI into it to skip per-run installs. Defaults to Daytona's typescript\n     * sandbox, with the agent CLI installed at run start.\n     */\n    snapshot?: string;\n  };\n}\n\nexport type ControlLoopRunResult<TData = unknown> =\n  | { status: \"skipped\"; reason: string }\n  | { status: \"clean\" }\n  | { status: \"fix-failed\"; unresolved: Signal<TData>[] }\n  | { status: \"pr-opened\"; prUrl: string; fixed: Signal<TData>[] };\n\nexport type ApplyCommentsResult =\n  /** Every comment predates the PR's head commit \u2014 nothing new to address. */\n  | { status: \"no-new-comments\" }\n  /** The agent ran but left the working tree untouched, so nothing was pushed. */\n  | { status: \"no-changes\"; comments: PrComment[] }\n  | { status: \"comments-applied\"; branch: string; comments: PrComment[] };\n"],
+  "mappings": ";;;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@bpinternal/overwatch",
+  "version": "0.1.0",
+  "description": "Headless library for building control loops: scheduled bots that scan a repo for a class of anomaly, fix a few instances with a coding agent, and open a PR — no server, UI, or persistent process.",
+  "keywords": [
+    "control-loop",
+    "coding-agent",
+    "automation",
+    "codemod",
+    "github",
+    "pull-request",
+    "ci",
+    "daytona",
+    "claude",
+    "codex"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/botpress/overwatch#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/botpress/overwatch.git"
+  },
+  "bugs": {
+    "url": "https://github.com/botpress/overwatch/issues"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "packageManager": "pnpm@10.29.3",
+  "engines": {
+    "node": ">=18",
+    "pnpm": ">=9"
+  },
+  "scripts": {
+    "build": "pnpm run build:types && pnpm run bundle",
+    "build:types": "tsc -p ./tsconfig.build.json",
+    "bundle": "ts-node -T build.ts",
+    "check:type": "tsc --noEmit",
+    "test": "vitest --run",
+    "prepublishOnly": "pnpm run check:type && pnpm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^22.9.0",
+    "esbuild": "^0.25.10",
+    "glob": "^9.3.4",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.4"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "@daytona/sdk": "^0.195.0",
+    "commander": "^15.0.0",
+    "octokit": "^5.0.5"
+  }
+}