@openlap/openlap 1.0.0 → 1.0.1

package/README.md

@@ -0,0 +1,78 @@
+# openlap
+
+Product requirements that agents read. Write a lap, agent builds it.
+
+A lap is one goal, issues to implement, and verification criteria. Agents pick the next open lap and work through it. When they commit, criteria auto-check via webhook. No dashboard, no CLI -- just the MCP server.
+
+Live at [openlap.app](https://openlap.app)
+
+## Install
+
+1. Admin installs the GitHub App (once per org): https://github.com/apps/openlap-app/installations/new
+2. Add the MCP server:
+
+```bash
+claude mcp add --transport http lap https://openlap.app/mcp
+```
+
+3. Open Claude Code. First message triggers GitHub login in browser. Done.
+
+For project-scoped briefings (filters context to one repo):
+
+```bash
+claude mcp add --transport http --scope project lap "https://openlap.app/mcp?project=owner/repo"
+```
+
+Project scope overrides global when both exist.
+
+4. Register your repo as a project (once per repo):
+
+```
+create_project owner/repo
+```
+
+## What agents see
+
+**Briefings** -- computed context injected into tool descriptions. Agents see project health, the focused lap's unchecked criteria, staleness signals, and priority collisions without calling any tool. Briefings refresh mid-session after mutations.
+
+**Laps** -- sorted by priority (0=focus, 1=urgent, 2=high, 3=normal). Agents work on the first open lap. Each lap has a goal, body, and structured criteria.
+
+**Criteria** -- verification checks on each lap. Agents prove work by committing with `LAP-NNN #N` in the commit message:
+
+```bash
+git commit -m "LAP-010 #1 #2 add auth middleware"
+```
+
+The GitHub webhook auto-checks the referenced criteria. When all code criteria pass, the lap auto-closes to done. If manual criteria remain (screenshots, design review), the lap moves to review for human verification.
+
+**Focus mode** -- set priority=0 on one lap per project. Its unchecked criteria appear in briefings automatically, so agents know what to verify from `tools/list` alone.
+
+## Develop
+
+Prerequisites: Go 1.23+, a GitHub App.
+
+```bash
+export BASE_URL=http://localhost:7784
+export DB_PATH=./openlap.db
+cd cmd/anylap && go run .
+```
+
+Local MCP (overrides the remote server):
+
+```bash
+claude mcp add --transport http lap http://localhost:7784/mcp
+```
+
+## Deploy
+
+Hetzner. `sky ship --app openlap-1`. Secrets via `sky deploy --app openlap-1`.
+
+## Architecture
+
+```
+Agent -> MCP (openlap.app/mcp) -> SQLite
+```
+
+One Go binary serves REST API + MCP protocol. OAuth 2.1 with PKCE, chaining to GitHub for identity. GitHub App installation = team boundary. SQLite with Litestream S3 backup.
+
+See CLAUDE.md for technical reference.

package/dist/feed.d.ts

@@ -11,7 +11,8 @@ export declare class FeedManager {
     private streams;
     private seenIds;
     private callback;
-    constructor(baseUrl: string, callback: UpdateCallback);
+    private getToken;
+    constructor(baseUrl: string, callback: UpdateCallback, getToken?: () => string | undefined);
     /**
      * Subscribe to a tag's feed if not already subscribed.
      */

package/dist/feed.js

@@ -5,9 +5,11 @@ export class FeedManager {
     streams = new Map();
     seenIds = new Set();
     callback;
-    constructor(baseUrl, callback) {
+    getToken;
+    constructor(baseUrl, callback, getToken) {
         this.baseUrl = baseUrl;
         this.callback = callback;
+        this.getToken = getToken;
     }
     /**
      * Subscribe to a tag's feed if not already subscribed.
@@ -22,7 +24,12 @@ export class FeedManager {
     }
     connect(tag, controller) {
         const url = `${this.baseUrl}/feed/${tag}/sse`;
-        fetch(url, { signal: controller.signal })
+        const headers = {};
+        const token = this.getToken?.();
+        if (token) {
+            headers["Authorization"] = `Bearer ${token}`;
+        }
+        fetch(url, { headers, signal: controller.signal })
             .then((res) => {
             if (!res.ok || !res.body) {
                 throw new Error(`SSE connect failed: ${res.status}`);

package/dist/proxy.js

@@ -3,10 +3,13 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { readFileSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
 import { FileOAuthProvider } from "./auth.js";
 import { detectProject, autoSave } from "./git.js";
 import { FeedManager } from "./feed.js";
-const BASE_URL = process.env.ANYLAP_URL ?? "https://openlap.app";
+const BASE_URL = process.env.OPENLAP_URL ?? "https://openlap.app";
 // Tools that accept a 'project' parameter
 const PROJECT_TOOLS = new Set([
     "list_laps", "get_lap", "create_lap", "save_lap", "update_lap",
@@ -70,6 +73,15 @@ export async function startProxy() {
                 process.stderr.write(`[openlap] notification error: ${err}\n`);
             }
         });
+    }, () => {
+        // Provide auth token for SSE feed connections
+        try {
+            const data = JSON.parse(readFileSync(join(homedir(), ".openlap", "auth.json"), "utf-8"));
+            return data?.tokens?.access_token;
+        }
+        catch {
+            return undefined;
+        }
     });
     // Forward tool listing from remote
     server.setRequestHandler(ListToolsRequestSchema, async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openlap/openlap",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Local MCP proxy for openlap.app -- auto-save, live feeds, project detection, one install",
   "type": "module",
   "main": "dist/index.js",