ghostrail 0.0.0

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;GAIG;AACH,SAAS,WAAW;IAClB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3D,MAAM,GAAG,GAAG,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;QACxD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA0B,CAAC;QACrD,OAAO,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,6CAA6C;AAC7C,MAAM,CAAC,MAAM,OAAO,GAAW,WAAW,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "ghostrail",
+  "version": "0.0.0",
+  "description": "Open source software factory for coding agents. Config-driven loops, pluggable isolation backends, human merge gate.",
+  "keywords": [
+    "ai-agents",
+    "coding-agent",
+    "agent-orchestration",
+    "software-factory",
+    "claude-code",
+    "self-hosted"
+  ],
+  "license": "Apache-2.0",
+  "author": "Timothy Jordan <timothy@timothyjordan.com>",
+  "homepage": "https://ghostrail.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/timothyjordan/ghostrail.git"
+  },
+  "bugs": {
+    "url": "https://github.com/timothyjordan/ghostrail/issues"
+  },
+  "type": "module",
+  "bin": {
+    "ghostrail": "dist/bin.js"
+  },
+  "files": ["dist", "templates", "LICENSE", "NOTICE", "README.md"],
+  "engines": {
+    "node": ">=22"
+  },
+  "packageManager": "pnpm@9.15.9",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "format": "biome format --write .",
+    "test": "vitest run",
+    "test:unit": "vitest run",
+    "test:watch": "vitest"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "1.9.4",
+    "@types/node": "^22.10.2",
+    "fast-check": "^4.9.0",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "dependencies": {
+    "smol-toml": "^1.7.1"
+  }
+}

package/templates/content-loop/README.md

@@ -0,0 +1,23 @@
+# content-loop
+
+A content factory: the agent writes a draft file, there is no code gate, and the
+PR opens as a draft for you to review. This is the `tjwrite`/`research` shape.
+
+## Setup
+1. `ghostrail init content-loop` in your writing repo (or copy this folder in).
+2. Edit `ghostrail.toml`: set `source.project`, the `eligible` filter, and the
+   `artifacts` list to the shared references you want staged into each run.
+3. Put those references in your global store as Markdown, e.g.
+   `~/.config/ghostrail/artifacts/voice-and-style-profile.md`. List them with
+   `ghostrail artifacts`.
+4. Export `LINEAR_API_KEY` and authenticate `gh`.
+
+## Run
+```bash
+ghostrail run          # draft eligible pieces and open draft PRs
+ghostrail board        # watch runs at http://127.0.0.1:4369/
+```
+
+The shared artifacts are staged into each run at `.ghostrail/artifacts/` so the
+same voice and formats apply across every factory instance, without copying them
+into each repo.

package/templates/content-loop/ghostrail.toml

@@ -0,0 +1,36 @@
+# content-loop: the tjwrite/research shape. The agent writes a draft file, there
+# is no code gate, and the PR opens as a draft. Shared writing artifacts (voice,
+# formats) come from your global store.
+
+# Shared artifacts staged into each run's workspace from the global store
+# (~/.config/ghostrail/artifacts/<name>.md). See `ghostrail artifacts`.
+# (A root-level key must come before any [table] header.)
+artifacts = ["voice-and-style-profile", "content-strategy-playbook"]
+
+[factory]
+name = "content"
+base_branch = "main"
+
+[source]
+kind = "linear"
+project = "TJ"                 # your Linear team key
+eligible = { state = "Todo", label = "draft", unassigned = true }
+
+[agent]
+kind = "claude-code"
+prompt = "prompts/draft.md"
+
+[backend]
+kind = "local-worktree"
+
+# No [gate]: a content factory has no code oracle. A human reviews the draft.
+
+[guardrails]
+max_items_per_run = 3
+budget_usd_per_item = 3
+timeout = "30m"
+
+[output]
+open_pr = true
+draft = true                   # content PRs open as drafts
+auto_merge = false

package/templates/content-loop/prompts/draft.md

@@ -0,0 +1,29 @@
+# Draft a piece
+
+You are a writing agent working in an isolated checkout. Write the piece
+described below as a Markdown file. You may only read and write files. Do not use
+git: the factory owns commits, branches, and PRs.
+
+## The brief
+- ID: {{id}}
+- Title: {{title}}
+- Link: {{url}}
+
+## Shared references
+Read any files under `.ghostrail/artifacts/` (voice and style, formats,
+strategy). Follow them closely: they define how this work should read.
+
+## What to do
+1. Write the draft as a new Markdown file under `drafts/`, named for the piece.
+2. Match the voice, structure, and formats in the shared references.
+3. Do not publish or post anything; produce a draft only.
+
+## Reporting your result (required, do this last)
+Write `.ghostrail/result.json` with exactly one of:
+
+- `{"status":"done","summary":"<one-paragraph summary of the draft>"}`
+- `{"status":"blocked","questions":"<what you need decided>"}`
+- `{"status":"failed","error":"<why>"}`
+- `{"status":"noop"}`
+
+The factory opens a draft pull request for a human to review.

package/templates/fix-bugs-local/README.md

@@ -0,0 +1,23 @@
+# fix-bugs-local
+
+A code factory that runs on your own hardware with zero infrastructure. It drains
+eligible tracker issues, fixes each in an isolated git worktree, gates the result
+against your CI, and opens a pull request. It never merges.
+
+## Setup
+1. `ghostrail init fix-bugs-local` in your repo (or copy this folder in).
+2. Edit `ghostrail.toml`: set `source.project` to your Linear team key and the
+   `eligible` filter, and set `gate.commands` to your CI steps.
+3. Export `LINEAR_API_KEY` (a Linear personal API key) and make sure `gh` is
+   authenticated for your repo.
+
+## Run
+```bash
+ghostrail run          # one tick: claim eligible issues, fix, gate, open PRs
+ghostrail respond      # fold new human PR comments back into their branches
+ghostrail board        # watch runs at http://127.0.0.1:4369/
+```
+
+An issue is eligible when it is `Todo`, unassigned, and labeled `factory`
+(configurable). The agent only ever writes files; ghostrail does all git, tracker,
+and PR work, and stops at a PR you merge.

package/templates/fix-bugs-local/ghostrail.toml

@@ -0,0 +1,37 @@
+# fix-bugs-local: a code factory on your own hardware, zero infrastructure.
+# Point it at a repo and a tracker label; it fixes bugs and opens PRs you merge.
+
+[factory]
+name = "fix-bugs"
+base_branch = "main"
+
+[source]
+kind = "linear"                # linear | github-issues (Phase 2)
+project = "TJ"                 # your Linear team key
+eligible = { state = "Todo", label = "factory", unassigned = true }
+
+[agent]
+kind = "claude-code"
+prompt = "prompts/fix-bug.md"
+# default allowed_tools = ["Read", "Edit", "Write", "Bash", "Grep", "Glob"]
+
+[backend]
+kind = "local-worktree"        # zero infrastructure; git worktree in place
+
+[gate]                         # the oracle: mirror your CI
+commands = [
+  "pnpm install --frozen-lockfile",
+  "pnpm lint",
+  "pnpm typecheck",
+  "pnpm test:unit",
+  "pnpm build",
+]
+
+[guardrails]
+max_items_per_run = 3
+budget_usd_per_item = 3
+timeout = "30m"
+
+[output]
+open_pr = true
+auto_merge = false             # a human owns every merge

package/templates/fix-bugs-local/prompts/fix-bug.md

@@ -0,0 +1,27 @@
+# Fix a bug
+
+You are a coding agent working in an isolated checkout of a repository. Fix the
+issue described below. You may only read and write files and run shell commands
+in this workspace. Do not use git: the factory owns commits, branches, and PRs.
+
+## The issue
+- ID: {{id}}
+- Title: {{title}}
+- Link: {{url}}
+
+## What to do
+1. Reproduce and locate the bug.
+2. Make the smallest correct fix.
+3. Add or update unit tests that cover it.
+4. Keep the change focused; do not refactor unrelated code.
+
+## Reporting your result (required, do this last)
+Write a JSON file at `.ghostrail/result.json` with exactly one of these shapes:
+
+- Success: `{"status":"done","summary":"<what you changed, one paragraph>"}`
+- Needs a human decision: `{"status":"blocked","questions":"<the decision you need>"}`
+- Could not fix it: `{"status":"failed","error":"<why>"}`
+- No change needed: `{"status":"noop"}`
+
+The factory reads this file to decide what to do, then runs your CI gate and, if
+it passes, opens a pull request for a human to review and merge.