repotector
Advanced tools
+1
-1
| { | ||
| "name": "repotector", | ||
| "version": "1.5.1", | ||
| "version": "1.6.0", | ||
| "description": "Repotector ⬡ — the repo guardian AI agents handshake with before touching code: REPOTECTOR/2 handshake + visitor register, city-map (built-vs-missing), grandfathered gates that never fail you on day one, resilient depart, and a DNA-aware MCP server.", | ||
@@ -5,0 +5,0 @@ "type": "module", |
+34
-4
| # Repotector ⬡ | ||
| **The repo guardian AI agents handshake with before they touch your code.** | ||
| **The repo that remembers.** | ||
| An arriving agent knocks at the front door, is handed the map, and signs the | ||
| register on the way out — so the next agent continues in two minutes instead of | ||
| wandering for an hour, and a refactor doesn't quietly break what already works. | ||
| Every AI agent that visits your repo starts from zero: it re-derives the map, | ||
| re-discovers the conventions, re-breaks the thing the last agent just fixed. | ||
| Repotector gives the repo itself a memory. An arriving agent knocks at the | ||
| front door, handshakes, and is handed the map, the standing decisions, and the | ||
| last visitor's briefing; on the way out it signs the register. The next agent | ||
| continues in two minutes instead of wandering for an hour — and a refactor | ||
| doesn't quietly break what already works. | ||
@@ -155,2 +159,28 @@ Portable and self-contained: pure Node ESM, two dependencies | ||
| ## Docker | ||
| The image on GHCR wraps the CLI and the MCP server; the guarded repo is | ||
| mounted, never baked in: | ||
| ```bash | ||
| docker run --rm -v "$PWD:/repo" ghcr.io/dir-ai/repotector init | ||
| docker run --rm -v "$PWD:/repo" ghcr.io/dir-ai/repotector gates | ||
| docker run -i --rm -v "$PWD:/repo" ghcr.io/dir-ai/repotector mcp # stdio MCP | ||
| ``` | ||
| Multi-arch (amd64/arm64), built and smoke-tested by CI on every release tag | ||
| (see [Dockerfile](./Dockerfile)). | ||
| ## GitHub Action | ||
| Guard a repo in CI with one step — grandfathered semantics apply, so the job | ||
| fails only on regressions, never on day-one debt: | ||
| ```yaml | ||
| - uses: dir-ai/repotector@main | ||
| with: | ||
| command: gates # default; any CLI command works | ||
| version: latest # pin an exact npm version for reproducible CI | ||
| ``` | ||
| ## Honesty | ||
@@ -157,0 +187,0 @@ |
+2
-2
@@ -5,3 +5,3 @@ { | ||
| "description": "The repo guardian AI agents handshake with before they touch your code.", | ||
| "version": "1.5.1", | ||
| "version": "1.6.0", | ||
| "packages": [ | ||
@@ -11,3 +11,3 @@ { | ||
| "identifier": "repotector", | ||
| "version": "1.5.1", | ||
| "version": "1.6.0", | ||
| "runtimeHint": "npx", | ||
@@ -14,0 +14,0 @@ "transport": { |
159793
0.62%204
17.24%