ai-foreman 1.0.0

package/dist/util/asyncQueue.js

@@ -0,0 +1,40 @@
+/**
+ * A minimal async iterable backed by a push queue. Producers call `push`;
+ * consumers iterate with `for await`. Iteration ends after `close()`.
+ */
+export class AsyncQueue {
+    items = [];
+    waiters = [];
+    closed = false;
+    push(item) {
+        if (this.closed)
+            return;
+        const waiter = this.waiters.shift();
+        if (waiter)
+            waiter({ value: item, done: false });
+        else
+            this.items.push(item);
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        let waiter;
+        while ((waiter = this.waiters.shift())) {
+            waiter({ value: undefined, done: true });
+        }
+    }
+    [Symbol.asyncIterator]() {
+        return {
+            next: () => {
+                if (this.items.length > 0) {
+                    return Promise.resolve({ value: this.items.shift(), done: false });
+                }
+                if (this.closed) {
+                    return Promise.resolve({ value: undefined, done: true });
+                }
+                return new Promise((resolve) => this.waiters.push(resolve));
+            },
+        };
+    }
+}

package/foreman.yaml

@@ -0,0 +1,98 @@
+# Foreman configuration. Any field omitted here falls back to the built-in
+# defaults in src/config.ts. This file is read from the *project* directory
+# passed to `foreman start`, so each project can tune its own policy.
+
+permissions:
+  # Bash commands are auto-approved only when EVERY segment (split on && || ; |)
+  # starts with one of these prefixes.
+  allowBash:
+    - npm test
+    - npm run
+    - npm install
+    - npm ci
+    - npx tsc
+    - "node "
+    - "pnpm "
+    - "yarn "
+    - git status
+    - git diff
+    - git add
+    - git commit
+    - git log
+    - git branch
+    - git checkout
+    - git restore
+    - git stash
+    - ls
+    - "cat "
+    - "mkdir "
+    - foreman tickets
+    - pytest
+    - "python "
+    - "python3 "
+    - "make "
+    - "cargo "
+    - go test
+    - go build
+
+  # If a command contains any of these substrings it always escalates,
+  # regardless of the allow list.
+  escalateBash:
+    - rm -rf
+    - rm -r
+    - sudo
+    - git push
+    - git reset --hard
+    - git clean
+    - curl
+    - wget
+    - ssh
+    - scp
+    - docker
+    - kubectl
+    - chmod 777
+    - "> /dev"
+    - ":(){"
+    - mkfs
+    - "dd if="
+
+  # Non-Bash tools auto-approved (file writes are still confined to the worktree).
+  allowTools:
+    - Read
+    - Glob
+    - Grep
+    - Edit
+    - Write
+    - MultiEdit
+    - NotebookEdit
+    - TodoWrite
+
+  # Tools that always escalate (e.g. network access).
+  escalateTools:
+    - WebFetch
+    - WebSearch
+
+notifications:
+  # When enabled, a desktop notification fires whenever the builder emits
+  # STEP_STATUS: needs_input — useful if you've walked away and need a nudge
+  # to come back to the terminal to answer.
+  #
+  # Platform support:
+  #   macOS   — built-in (osascript)
+  #   Linux   — requires notify-send (libnotify)
+  #   WSL     — Windows toast via powershell.exe (no install required)
+  #
+  # Default: false. Set to true to enable.
+  enabled: false
+
+qa:
+  # After every STEP_STATUS: done (and plan_complete), foreman runs a free QA
+  # pass: the builder triple-checks accuracy, test existence, test execution,
+  # ticket satisfaction, and confidence. If QA reports issues, foreman drives
+  # a fix → re-QA cycle until the builder emits qa_pass (capped at 3 cycles).
+  # QA turns do NOT count against --steps.
+  #
+  # The CLI flag --no-qa overrides this per-run.
+  #
+  # Default: true.
+  enabled: true

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "ai-foreman",
+  "version": "1.0.0",
+  "description": "An orchestrator that keeps Codex CLI / Claude Code builders moving through their step list unattended. Part of Rafi.",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ttante/foreman.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ttante/foreman/issues"
+  },
+  "homepage": "https://github.com/ttante/foreman#readme",
+  "bin": {
+    "ai-foreman": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "foreman.yaml",
+    "LICENSE"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "codex",
+    "agent",
+    "orchestrator",
+    "automation",
+    "llm",
+    "cli"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.3.148",
+    "@clack/prompts": "^1.4.0",
+    "ajv": "^8.20.0",
+    "ajv-formats": "^3.0.1",
+    "better-sqlite3": "^12.10.0",
+    "commander": "^12.1.0",
+    "luxon": "^3.7.2",
+    "yaml": "^2.5.1",
+    "special-agents": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/luxon": "^3.7.1",
+    "@types/node": "^20.14.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsx src/index.ts",
+    "test": "tsx --test test/*.test.ts",
+    "typecheck": "tsc --noEmit"
+  }
+}