notican 1.0.0

package/.env.example

@@ -0,0 +1,14 @@
+GITHUB_WEBHOOK_SECRET=your_webhook_secret
+GITHUB_TOKEN=ghp_your_token
+GITHUB_OWNER=your-org-or-username
+GITHUB_REPO=your-repo
+NOTION_TOKEN=secret_your_notion_token
+NOTION_PARENT_PAGE_ID=notion_page_id   # Required for setup:notion — the parent page ID from the Notion URL
+NOTION_DATABASE_ADR=notion_database_id
+NOTION_DATABASE_CHANGELOG=notion_database_id
+NOTION_DATABASE_API_REF=notion_database_id
+NOTION_DATABASE_RUNBOOKS=notion_database_id
+NOTION_DATABASE_TASKS=notion_database_id
+ANTHROPIC_API_KEY=sk-ant-your_key
+PORT=4000
+POLL_INTERVAL_SECONDS=60

package/README.md

@@ -0,0 +1,175 @@
+# Notican — Autonomous Engineering Intelligence Hub
+
+> **Notion MCP Challenge Entry** — Bidirectional GitHub ↔ Notion sync powered by Claude AI.
+
+Every PR, commit, and issue automatically becomes living documentation in Notion. Zero manual work.
+
+---
+
+## How It Works
+
+```
+GitHub Events (webhook)
+        ↓
+  Express Server (port 4000)
+        ↓
+  Event Handlers (pr / push / issues)
+        ↓
+  Claude Sonnet 4.6 (diff analysis + doc generation)
+        ↓
+  Notion MCP → 5 auto-maintained databases
+
+Notion Watcher (polls every 60s)
+        ↓
+  Tasks tagged github_sync=true
+        ↓
+  GitHub Issues API → creates issue, marks task synced
+```
+
+## What Gets Generated
+
+| GitHub Event | Notion Output |
+|---|---|
+| PR merged to `main` | Changelog entry + ADR (if architecture change) |
+| Push with API file changes | API Reference update |
+| Push with infra changes (Dockerfile, k8s, Terraform) | Runbook create/update |
+| Issue opened | Task created in Notion Tasks database |
+| Issue closed/reopened | Task status synced |
+| Notion task with `github_sync=true` | GitHub Issue created |
+
+## Notion Workspace
+
+Five databases — created automatically by `npm run setup:notion`:
+
+| Database | Auto-maintained from |
+|---|---|
+| 📐 Architecture Decisions | Significant PRs |
+| 📋 Changelog | Every merge to main |
+| 📡 API Reference | API/route file changes |
+| 📖 Runbooks | Infrastructure changes |
+| ✅ Tasks | GitHub Issues (bidirectional) |
+
+## Setup
+
+### 1. Prerequisites
+
+- Node.js 22+
+- A GitHub repo with webhook access
+- A Notion workspace with an integration token
+- An Anthropic API key
+
+### 2. Install
+
+```bash
+git clone https://github.com/your-org/notican-mcp-challange
+cd notican-mcp-challange
+npm install
+```
+
+### 3. Configure
+
+```bash
+cp .env.example .env
+# Fill in your tokens — see .env.example for all required vars
+```
+
+### 4. Create Notion workspace structure
+
+```bash
+# Add NOTION_TOKEN and NOTION_PARENT_PAGE_ID to .env first
+npm run setup:notion
+# Prints 5 database IDs — paste them back into .env
+```
+
+### 5. Configure GitHub webhook
+
+- Go to your repo → Settings → Webhooks → Add webhook
+- Payload URL: `https://your-domain/webhooks/github` (use `ngrok http 4000` for local dev)
+- Content type: `application/json`
+- Secret: your `GITHUB_WEBHOOK_SECRET`
+- Events: Pull requests, Pushes, Issues
+
+### 6. Start
+
+```bash
+npm run dev    # development with hot reload
+npm start      # production
+```
+
+Server starts on port 4000. Webhook endpoint: `POST /webhooks/github`. Health check: `GET /health`.
+
+## Development
+
+```bash
+npm test                          # run all tests
+npm run test:watch                # watch mode
+npm run test:coverage             # with coverage report
+npm run build                     # TypeScript compile
+npm run lint                      # ESLint
+npx jest src/handlers/pr.test.ts  # single test file
+```
+
+**Coverage thresholds:** 80% minimum on statements, branches, functions, lines (currently ~94%).
+
+See [DEVELOPMENT_RULES.md](DEVELOPMENT_RULES.md) for layer boundaries, TDD approach, and Claude prompt rules.
+
+## Architecture
+
+```
+src/
+  server/       Express webhook server — HMAC verification, routing
+  handlers/     Parse GitHub events, decide what to generate
+  processors/   Claude AI — diff analysis, doc generation
+  notion/       Notion API client — idempotent read/write
+  github/       Octokit — diffs, changed files, issue creation
+  watcher/      Cron polling — Notion tasks → GitHub Issues
+  types/        Shared TypeScript interfaces
+  __fixtures__/ Test fixtures — GitHub event payloads, Notion responses
+scripts/
+  setup-notion.ts  One-time Notion workspace creation
+landing/
+  index.html    Standalone marketing page (open in browser)
+```
+
+**Key design decisions:**
+- Webhook server always returns `200` to GitHub — no retries, no duplicates
+- All Notion writes use `createOrUpdatePage()` keyed by GitHub external ID — fully idempotent
+- Claude receives only relevant diff portions (lock files stripped, 200-line file cap)
+- Notion watcher uses `Promise.allSettled()` — one failing task never stops the batch
+
+## Tech Stack
+
+| Layer | Technology |
+|---|---|
+| Runtime | Node.js 22 + TypeScript |
+| Web server | Express.js |
+| AI | Claude Sonnet 4.6 (`@anthropic-ai/sdk`) |
+| GitHub | Octokit REST + `@octokit/webhooks` |
+| Notion | `@notionhq/client` |
+| Testing | Jest + ts-jest + supertest |
+| CI/CD | GitHub Actions |
+
+## Environment Variables
+
+See [`.env.example`](.env.example) for the full list. Required:
+
+```
+GITHUB_WEBHOOK_SECRET   Webhook HMAC secret
+GITHUB_TOKEN            Personal access token (repo scope)
+GITHUB_OWNER            Org or username
+GITHUB_REPO             Repository name
+NOTION_TOKEN            Notion integration token
+NOTION_DATABASE_*       5 database IDs (output of setup:notion)
+ANTHROPIC_API_KEY       Claude API key
+PORT                    Default: 4000
+```
+
+## Landing Page
+
+Open `landing/index.html` directly in a browser — no server needed.
+
+Dark + neon design, fully responsive (desktop + mobile). Sections: hero with live pipeline diagram, stats, how it works, features, terminal setup, architecture, Notion databases, CTA.
+
+---
+
+Built with [Claude Sonnet 4.6](https://anthropic.com) + [Notion MCP](https://developers.notion.com) · Notion MCP Challenge 2026

package/dist/__fixtures__/index.d.ts

@@ -0,0 +1,11 @@
+import type { PullRequestEvent, PushEvent, IssueEvent, NotionTask } from '../types';
+export declare const prMergedToMain: PullRequestEvent;
+export declare const prOpened: PullRequestEvent;
+export declare const pushToMain: PushEvent;
+export declare const pushWithApiChanges: PushEvent;
+export declare const pushWithInfraChanges: PushEvent;
+export declare const issueOpened: IssueEvent;
+export declare const issueClosed: IssueEvent;
+export declare const notionTaskPendingSync: NotionTask;
+export declare const sampleDiff: string;
+//# sourceMappingURL=index.d.ts.map

package/dist/__fixtures__/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/__fixtures__/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAIpF,eAAO,MAAM,cAAc,EAAE,gBAiC5B,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,gBAStB,CAAC;AAIF,eAAO,MAAM,UAAU,EAAE,SA6BxB,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,SAShC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,SAUlC,CAAC;AAIF,eAAO,MAAM,WAAW,EAAE,UAqBzB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,UAIzB,CAAC;AAIF,eAAO,MAAM,qBAAqB,EAAE,UAOnC,CAAC;AAIF,eAAO,MAAM,UAAU,QAoBf,CAAC"}

package/dist/__fixtures__/index.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sampleDiff = exports.notionTaskPendingSync = exports.issueClosed = exports.issueOpened = exports.pushWithInfraChanges = exports.pushWithApiChanges = exports.pushToMain = exports.prOpened = exports.prMergedToMain = void 0;
+// ── Pull Request Fixtures ────────────────────────────────────────────────────
+exports.prMergedToMain = {
+    action: 'closed',
+    number: 42,
+    pull_request: {
+        id: 1001,
+        number: 42,
+        title: 'feat: add user authentication with JWT',
+        body: 'Implements JWT-based auth. Adds /auth/login and /auth/refresh endpoints.',
+        state: 'closed',
+        merged: true,
+        merge_commit_sha: 'abc123def456',
+        base: { ref: 'main', sha: 'base-sha-123' },
+        head: { ref: 'feat/jwt-auth', sha: 'head-sha-456' },
+        user: { login: 'octocat' },
+        html_url: 'https://github.com/test-owner/test-repo/pull/42',
+        diff_url: 'https://github.com/test-owner/test-repo/pull/42.diff',
+        patch_url: 'https://github.com/test-owner/test-repo/pull/42.patch',
+        additions: 312,
+        deletions: 45,
+        changed_files: 8,
+    },
+    repository: {
+        id: 9001,
+        name: 'test-repo',
+        full_name: 'test-owner/test-repo',
+        html_url: 'https://github.com/test-owner/test-repo',
+        default_branch: 'main',
+    },
+    sender: {
+        login: 'octocat',
+        avatar_url: 'https://github.com/octocat.png',
+        html_url: 'https://github.com/octocat',
+    },
+};
+exports.prOpened = {
+    ...exports.prMergedToMain,
+    action: 'opened',
+    pull_request: {
+        ...exports.prMergedToMain.pull_request,
+        state: 'open',
+        merged: false,
+        merge_commit_sha: null,
+    },
+};
+// ── Push Fixtures ────────────────────────────────────────────────────────────
+exports.pushToMain = {
+    ref: 'refs/heads/main',
+    before: 'before-sha-111',
+    after: 'after-sha-222',
+    commits: [
+        {
+            id: 'after-sha-222',
+            message: 'feat: add authentication endpoints',
+            timestamp: '2026-03-15T10:00:00Z',
+            url: 'https://github.com/test-owner/test-repo/commit/after-sha-222',
+            author: { name: 'Octocat', email: 'octocat@github.com' },
+            added: ['src/routes/auth.ts'],
+            removed: [],
+            modified: ['src/index.ts'],
+        },
+    ],
+    repository: {
+        id: 9001,
+        name: 'test-repo',
+        full_name: 'test-owner/test-repo',
+        html_url: 'https://github.com/test-owner/test-repo',
+        default_branch: 'main',
+    },
+    pusher: { name: 'octocat', email: 'octocat@github.com' },
+    sender: {
+        login: 'octocat',
+        avatar_url: 'https://github.com/octocat.png',
+        html_url: 'https://github.com/octocat',
+    },
+};
+exports.pushWithApiChanges = {
+    ...exports.pushToMain,
+    commits: [
+        {
+            ...exports.pushToMain.commits[0],
+            added: ['src/routes/users.ts'],
+            modified: ['src/routes/auth.ts', 'swagger.yaml'],
+        },
+    ],
+};
+exports.pushWithInfraChanges = {
+    ...exports.pushToMain,
+    commits: [
+        {
+            ...exports.pushToMain.commits[0],
+            message: 'chore: update Dockerfile and k8s deployment',
+            added: ['k8s/deployment.yaml'],
+            modified: ['Dockerfile'],
+        },
+    ],
+};
+// ── Issue Fixtures ───────────────────────────────────────────────────────────
+exports.issueOpened = {
+    action: 'opened',
+    issue: {
+        id: 2001,
+        number: 15,
+        title: 'Bug: login fails with special characters in password',
+        body: 'When the password contains special characters like @#$, login returns 500.',
+        state: 'open',
+        html_url: 'https://github.com/test-owner/test-repo/issues/15',
+        user: { login: 'octocat', avatar_url: '', html_url: '' },
+        labels: [{ name: 'bug', color: 'd73a4a' }],
+        assignees: [],
+    },
+    repository: {
+        id: 9001,
+        name: 'test-repo',
+        full_name: 'test-owner/test-repo',
+        html_url: 'https://github.com/test-owner/test-repo',
+        default_branch: 'main',
+    },
+    sender: { login: 'octocat', avatar_url: '', html_url: '' },
+};
+exports.issueClosed = {
+    ...exports.issueOpened,
+    action: 'closed',
+    issue: { ...exports.issueOpened.issue, state: 'closed' },
+};
+// ── Notion Task Fixtures ─────────────────────────────────────────────────────
+exports.notionTaskPendingSync = {
+    id: 'notion-page-id-abc123',
+    title: 'Implement rate limiting on API endpoints',
+    body: 'We need to add rate limiting to prevent abuse. Use express-rate-limit.',
+    labels: ['enhancement', 'backend'],
+    assignees: ['octocat'],
+    githubSync: true,
+};
+// ── GitHub API Response Fixtures ─────────────────────────────────────────────
+exports.sampleDiff = `
+diff --git a/src/routes/auth.ts b/src/routes/auth.ts
+new file mode 100644
+index 0000000..1234567
+--- /dev/null
++++ b/src/routes/auth.ts
+@@ -0,0 +1,45 @@
++import { Router } from 'express';
++import jwt from 'jsonwebtoken';
++
++const router = Router();
++
++router.post('/login', async (req, res) => {
++  const { email, password } = req.body;
++  // authenticate user
++  const token = jwt.sign({ email }, process.env.JWT_SECRET!, { expiresIn: '1h' });
++  res.json({ token });
++});
++
++export default router;
+`.trim();
+//# sourceMappingURL=index.js.map

package/dist/__fixtures__/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/__fixtures__/index.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,17 @@
+export declare const config: {
+    GITHUB_WEBHOOK_SECRET: string;
+    GITHUB_TOKEN: string;
+    GITHUB_OWNER: string;
+    GITHUB_REPO: string;
+    NOTION_TOKEN: string;
+    NOTION_DATABASE_ADR: string;
+    NOTION_DATABASE_CHANGELOG: string;
+    NOTION_DATABASE_API_REF: string;
+    NOTION_DATABASE_RUNBOOKS: string;
+    NOTION_DATABASE_TASKS: string;
+    ANTHROPIC_API_KEY: string;
+    PORT: number;
+    POLL_INTERVAL_SECONDS: number;
+};
+export type Config = typeof config;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAiCA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;CAAgB,CAAC;AAEpC,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC"}

package/dist/config.js

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.config = void 0;
+const zod_1 = require("zod");
+const dotenv_1 = __importDefault(require("dotenv"));
+dotenv_1.default.config();
+const envSchema = zod_1.z.object({
+    GITHUB_WEBHOOK_SECRET: zod_1.z.string().min(1, 'GITHUB_WEBHOOK_SECRET is required'),
+    GITHUB_TOKEN: zod_1.z.string().min(1, 'GITHUB_TOKEN is required'),
+    GITHUB_OWNER: zod_1.z.string().min(1, 'GITHUB_OWNER is required'),
+    GITHUB_REPO: zod_1.z.string().min(1, 'GITHUB_REPO is required'),
+    NOTION_TOKEN: zod_1.z.string().min(1, 'NOTION_TOKEN is required'),
+    NOTION_DATABASE_ADR: zod_1.z.string().min(1, 'NOTION_DATABASE_ADR is required'),
+    NOTION_DATABASE_CHANGELOG: zod_1.z.string().min(1, 'NOTION_DATABASE_CHANGELOG is required'),
+    NOTION_DATABASE_API_REF: zod_1.z.string().min(1, 'NOTION_DATABASE_API_REF is required'),
+    NOTION_DATABASE_RUNBOOKS: zod_1.z.string().min(1, 'NOTION_DATABASE_RUNBOOKS is required'),
+    NOTION_DATABASE_TASKS: zod_1.z.string().min(1, 'NOTION_DATABASE_TASKS is required'),
+    ANTHROPIC_API_KEY: zod_1.z.string().min(1, 'ANTHROPIC_API_KEY is required'),
+    PORT: zod_1.z.string().default('3000').transform(Number),
+    POLL_INTERVAL_SECONDS: zod_1.z.string().default('60').transform(Number),
+});
+function validateEnv() {
+    const result = envSchema.safeParse(process.env);
+    if (!result.success) {
+        console.error('Invalid environment variables:');
+        result.error.issues.forEach((issue) => {
+            console.error(`  ${issue.path.join('.')}: ${issue.message}`);
+        });
+        process.exit(1);
+    }
+    return result.data;
+}
+exports.config = validateEnv();
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;;;;AAAA,6BAAwB;AACxB,oDAA4B;AAE5B,gBAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,MAAM,SAAS,GAAG,OAAC,CAAC,MAAM,CAAC;IACzB,qBAAqB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mCAAmC,CAAC;IAC7E,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,0BAA0B,CAAC;IAC3D,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,0BAA0B,CAAC;IAC3D,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC;IACzD,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,0BAA0B,CAAC;IAC3D,mBAAmB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,iCAAiC,CAAC;IACzE,yBAAyB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,uCAAuC,CAAC;IACrF,uBAAuB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,qCAAqC,CAAC;IACjF,wBAAwB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,sCAAsC,CAAC;IACnF,qBAAqB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mCAAmC,CAAC;IAC7E,iBAAiB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,+BAA+B,CAAC;IACrE,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC;IAClD,qBAAqB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC;CAClE,CAAC,CAAC;AAEH,SAAS,WAAW;IAClB,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAChD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACpC,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAEY,QAAA,MAAM,GAAG,WAAW,EAAE,CAAC"}

package/dist/github/client.d.ts

@@ -0,0 +1,29 @@
+import type { ChangedFile } from '../types';
+declare const octokit: import("@octokit/core").Octokit & {
+    paginate: import("@octokit/plugin-paginate-rest").PaginateInterface;
+} & import("@octokit/plugin-rest-endpoint-methods/dist-types/generated/method-types").RestEndpointMethods & import("@octokit/plugin-rest-endpoint-methods").Api;
+/**
+ * Fetch the full unified diff for a pull request.
+ */
+export declare function getPRDiff(owner: string, repo: string, prNumber: number): Promise<string>;
+/**
+ * Get the list of files changed in a specific commit or ref range.
+ */
+export declare function getChangedFiles(owner: string, repo: string, ref: string): Promise<ChangedFile[]>;
+/**
+ * Get files changed in a pull request.
+ */
+export declare function getPRChangedFiles(owner: string, repo: string, prNumber: number): Promise<ChangedFile[]>;
+/**
+ * Create a GitHub issue.
+ */
+export declare function createIssue(owner: string, repo: string, title: string, body: string, labels: string[]): Promise<{
+    number: number;
+    url: string;
+}>;
+/**
+ * Update a GitHub issue (e.g., close it or add a comment).
+ */
+export declare function updateIssueState(owner: string, repo: string, issueNumber: number, state: 'open' | 'closed'): Promise<void>;
+export { octokit };
+//# sourceMappingURL=client.d.ts.map

package/dist/github/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/github/client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,QAAA,MAAM,OAAO;;+JAEX,CAAC;AAEH;;GAEG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAc9F;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAoBtG;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAoB7G;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EAAE,GACf,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAkB1C;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GAAG,QAAQ,GACvB,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/github/client.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.octokit = void 0;
+exports.getPRDiff = getPRDiff;
+exports.getChangedFiles = getChangedFiles;
+exports.getPRChangedFiles = getPRChangedFiles;
+exports.createIssue = createIssue;
+exports.updateIssueState = updateIssueState;
+const rest_1 = require("@octokit/rest");
+const config_1 = require("../config");
+const octokit = new rest_1.Octokit({
+    auth: config_1.config.GITHUB_TOKEN,
+});
+exports.octokit = octokit;
+/**
+ * Fetch the full unified diff for a pull request.
+ */
+async function getPRDiff(owner, repo, prNumber) {
+    try {
+        const response = await octokit.rest.pulls.get({
+            owner,
+            repo,
+            pull_number: prNumber,
+            mediaType: { format: 'diff' },
+        });
+        // The diff is returned as a string when mediaType.format is 'diff'
+        return response.data;
+    }
+    catch (err) {
+        const error = err;
+        throw new Error(`Failed to fetch PR diff for #${prNumber}: ${error.message}`);
+    }
+}
+/**
+ * Get the list of files changed in a specific commit or ref range.
+ */
+async function getChangedFiles(owner, repo, ref) {
+    try {
+        const response = await octokit.rest.repos.getCommit({
+            owner,
+            repo,
+            ref,
+        });
+        const files = response.data.files ?? [];
+        return files.map((file) => ({
+            filename: file.filename,
+            status: file.status,
+            additions: file.additions,
+            deletions: file.deletions,
+            patch: file.patch,
+        }));
+    }
+    catch (err) {
+        const error = err;
+        throw new Error(`Failed to get changed files for ref ${ref}: ${error.message}`);
+    }
+}
+/**
+ * Get files changed in a pull request.
+ */
+async function getPRChangedFiles(owner, repo, prNumber) {
+    try {
+        const response = await octokit.rest.pulls.listFiles({
+            owner,
+            repo,
+            pull_number: prNumber,
+            per_page: 100,
+        });
+        return response.data.map((file) => ({
+            filename: file.filename,
+            status: file.status,
+            additions: file.additions,
+            deletions: file.deletions,
+            patch: file.patch,
+        }));
+    }
+    catch (err) {
+        const error = err;
+        throw new Error(`Failed to get PR files for #${prNumber}: ${error.message}`);
+    }
+}
+/**
+ * Create a GitHub issue.
+ */
+async function createIssue(owner, repo, title, body, labels) {
+    try {
+        const response = await octokit.rest.issues.create({
+            owner,
+            repo,
+            title,
+            body,
+            labels,
+        });
+        return {
+            number: response.data.number,
+            url: response.data.html_url,
+        };
+    }
+    catch (err) {
+        const error = err;
+        throw new Error(`Failed to create GitHub issue "${title}": ${error.message}`);
+    }
+}
+/**
+ * Update a GitHub issue (e.g., close it or add a comment).
+ */
+async function updateIssueState(owner, repo, issueNumber, state) {
+    try {
+        await octokit.rest.issues.update({
+            owner,
+            repo,
+            issue_number: issueNumber,
+            state,
+        });
+    }
+    catch (err) {
+        const error = err;
+        throw new Error(`Failed to update issue #${issueNumber} state: ${error.message}`);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/github/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/github/client.ts"],"names":[],"mappings":"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"}

package/dist/handlers/index.d.ts

@@ -0,0 +1,11 @@
+import { handlePullRequestEvent } from './pr';
+import { handlePushEvent } from './push';
+import { handleIssueEvent } from './issue';
+/**
+ * Route a GitHub webhook event to the appropriate handler.
+ * @param eventType - Value of the X-GitHub-Event header
+ * @param payload   - Parsed JSON payload from the webhook body
+ */
+export declare function routeEvent(eventType: string, payload: unknown): Promise<void>;
+export { handlePullRequestEvent, handlePushEvent, handleIssueEvent };
+//# sourceMappingURL=index.d.ts.map

package/dist/handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBnF;AAED,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/handlers/index.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleIssueEvent = exports.handlePushEvent = exports.handlePullRequestEvent = void 0;
+exports.routeEvent = routeEvent;
+const pr_1 = require("./pr");
+Object.defineProperty(exports, "handlePullRequestEvent", { enumerable: true, get: function () { return pr_1.handlePullRequestEvent; } });
+const push_1 = require("./push");
+Object.defineProperty(exports, "handlePushEvent", { enumerable: true, get: function () { return push_1.handlePushEvent; } });
+const issue_1 = require("./issue");
+Object.defineProperty(exports, "handleIssueEvent", { enumerable: true, get: function () { return issue_1.handleIssueEvent; } });
+/**
+ * Route a GitHub webhook event to the appropriate handler.
+ * @param eventType - Value of the X-GitHub-Event header
+ * @param payload   - Parsed JSON payload from the webhook body
+ */
+async function routeEvent(eventType, payload) {
+    console.log(`[Router] Routing event: ${eventType}`);
+    switch (eventType) {
+        case 'pull_request':
+            await (0, pr_1.handlePullRequestEvent)(payload);
+            break;
+        case 'push':
+            await (0, push_1.handlePushEvent)(payload);
+            break;
+        case 'issues':
+            await (0, issue_1.handleIssueEvent)(payload);
+            break;
+        case 'ping':
+            console.log('[Router] GitHub ping received — webhook configured successfully');
+            break;
+        default:
+            console.log(`[Router] Unhandled event type: ${eventType}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":";;;AAUA,gCAuBC;AAhCD,6BAA8C;AAkCrC,uGAlCA,2BAAsB,OAkCA;AAjC/B,iCAAyC;AAiCR,gGAjCxB,sBAAe,OAiCwB;AAhChD,mCAA2C;AAgCO,iGAhCzC,wBAAgB,OAgCyC;AA9BlE;;;;GAIG;AACI,KAAK,UAAU,UAAU,CAAC,SAAiB,EAAE,OAAgB;IAClE,OAAO,CAAC,GAAG,CAAC,2BAA2B,SAAS,EAAE,CAAC,CAAC;IAEpD,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,cAAc;YACjB,MAAM,IAAA,2BAAsB,EAAC,OAA2B,CAAC,CAAC;YAC1D,MAAM;QAER,KAAK,MAAM;YACT,MAAM,IAAA,sBAAe,EAAC,OAAoB,CAAC,CAAC;YAC5C,MAAM;QAER,KAAK,QAAQ;YACX,MAAM,IAAA,wBAAgB,EAAC,OAAqB,CAAC,CAAC;YAC9C,MAAM;QAER,KAAK,MAAM;YACT,OAAO,CAAC,GAAG,CAAC,iEAAiE,CAAC,CAAC;YAC/E,MAAM;QAER;YACE,OAAO,CAAC,GAAG,CAAC,kCAAkC,SAAS,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC"}

package/dist/handlers/issue.d.ts

@@ -0,0 +1,6 @@
+import type { IssueEvent } from '../types';
+/**
+ * Handle GitHub issue events.
+ */
+export declare function handleIssueEvent(payload: IssueEvent): Promise<void>;
+//# sourceMappingURL=issue.d.ts.map