feat: Add GitHub project integration scripts for devlog management

- Implemented dogfood-github-project.mjs to sync devlog entries with GitHub projects.
- Created get-github-project-id.mjs to retrieve project IDs using GraphQL API.
- Developed github-project-setup-guide.mjs for step-by-step integration setup instructions.
- Introduced github-rest-project-demo.mjs to demonstrate project management using GitHub REST API.
- Added github-rest-project-manager.mjs for enhanced project management with issues, labels, and milestones.
- Implemented sync-all-to-github.mjs to sync multiple devlog entries to GitHub.
- Created test-github-integration.mjs to validate GitHub integration functionality.
- Developed test-github-rest-projects.mjs to test REST API project management capabilities.
- Added test-issue-creation.mjs to verify issue creation via GitHub API.

Author: Marvin Zhang

.github/copilot-instructions.md

@@ -53,9 +53,9 @@ When working with the `@devlog/web` application, use Playwright MCP tools for co
 
 ### 7. Testing Setup
 - Start the web application with the `Web: Dev (Full Stack)` task before testing
-- Use `mcp_playwright_browser_navigate` to access the local development server
-- Default development URL: `http://localhost:5173` (Vite dev server)
-- Always take a snapshot with `mcp_playwright_browser_snapshot` before interacting with elements
+- Use `browser_navigate` to access the local development server
+- Default development URL: `http://localhost:3000` (Vite dev server)
+- Always take a snapshot with `browser_snapshot` before interacting with elements
 
 ### 8. Core Testing Patterns
 - **Navigation Testing**: Verify routes and page transitions work correctly

.gitignore

@@ -140,4 +140,8 @@ build/
 .idea
 
 # Devlog directory - contains local development notes
-.devlog/
+.devlog/
+
+# Devlog configuration with credentials
+devlog.config.json
+devlog-integrations.config.json

GITHUB_SETUP.md

@@ -0,0 +1,69 @@
+# GitHub Integration Setup Guide
+
+## 🔑 Required Token Permissions
+
+Your GitHub Personal Access Token needs these permissions for full devlog integration:
+
+### For Issues Integration:
+- ✅ **repo** (Full control of private repositories)
+  - OR **public_repo** (Access public repositories) if you only work with public repos
+
+### For Projects Integration:
+- ✅ **project** (Full control of projects)
+
+## 🛠️ How to Update Your Token
+
+1. **Go to GitHub Settings**
+   - Visit: https://github.com/settings/tokens
+   - Find your existing token or create a new one
+
+2. **Update Permissions**
+   - Check the **repo** scope (for issues)
+   - Check the **project** scope (for projects)
+   - Save the token
+
+3. **Update devlog.config.json**
+   - Replace the token in your config file
+   - Keep the same owner, repo, projectNumber settings
+
+## 🧪 Test the Integration
+
+Once you've updated the token permissions, test with:
+
+```bash
+# Test basic issue creation
+node scripts/test-issue-creation.mjs
+
+# Test full devlog integration
+node scripts/test-github-integration.mjs
+
+# Get the correct project ID for GraphQL
+node scripts/get-github-project-id.mjs
+```
+
+## 📋 Current Status
+
+- ✅ Repository `tikazyq/devlog` exists and is accessible
+- ✅ Configuration file `devlog.config.json` is properly formatted
+- ❌ Token needs additional permissions (repo + project)
+
+## 🎯 Expected Results
+
+After updating permissions, you should be able to:
+
+1. **Sync devlog entries to GitHub issues**
+   ```javascript
+   await devlog.syncWithGitHub('your-devlog-id')
+   ```
+
+2. **Sync devlog entries to GitHub project**
+   ```javascript
+   await devlog.syncWithGitHubProject('your-devlog-id')
+   ```
+
+3. **Import existing project items**
+   ```javascript
+   await devlog.importGitHubProjectItems()
+   ```
+
+The integration will create GitHub issues with proper titles, descriptions, and labels based on your devlog entries, and link them to your project board.

INTEGRATIONS.md

@@ -4,12 +4,12 @@ This guide helps you configure devlog to sync with enterprise project management
 
 ## Configuration File Setup
 
-Create a configuration file named `devlog-integrations.config.json` in one of these locations:
+Create a configuration file named `devlog.config.json` in one of these locations:
 - Your project root directory
-- `~/.devlog-integrations.config.json` (global config)
+- `~/.devlog.config.json` (global config)
 - `.devlog/integrations.config.json` (workspace-specific)
 
-Copy the template from `devlog-integrations.config.template.json` and fill in your credentials.
+Copy the template from `devlog.config.template.json` and fill in your credentials.
 
 ## Platform-Specific Setup
 

README.md

@@ -152,7 +152,7 @@ Devlog supports synchronization with popular enterprise project management platf
 
 1. Copy the integration config template:
    ```bash
-   cp devlog-integrations.config.template.json devlog-integrations.config.json
+   cp devlog.config.template.json devlog.config.json
    ```
 
 2. Fill in your platform credentials (see [INTEGRATIONS.md](./INTEGRATIONS.md) for detailed setup)

devlog.config.example.json

@@ -14,7 +14,9 @@
     "github": {
       "owner": "your-github-username",
       "repo": "your-repository",
-      "token": "your-github-token"
+      "token": "your-github-token",
+      "projectNumber": 2,
+      "projectId": "your-project-id"
     },
     "slack": {
       "botToken": "xoxb-your-slack-bot-token",

devlog-integrations.config.template.json devlog.config.template.jsondevlog-integrations.config.template.json renamed to devlog.config.template.json

@@ -15,9 +15,11 @@ import * as path from "path";
 // Load integrations config if available
 function loadIntegrationsConfig(): EnterpriseIntegration | undefined {
   const configPaths = [
-    "devlog-integrations.config.json",
+    "devlog.config.json",
+    "devlog-integrations.config.json", // backward compatibility
     ".devlog/integrations.config.json",
-    path.join(process.env.HOME || "~", ".devlog-integrations.config.json")
+    path.join(process.env.HOME || "~", ".devlog.config.json"),
+    path.join(process.env.HOME || "~", ".devlog-integrations.config.json") // backward compatibility
   ];
 
   for (const configPath of configPaths) {
@@ -475,59 +477,30 @@ const tools: Tool[] = [
     },
   },
   {
-    name: "find_or_create_devlog",
-    description: "Find an existing devlog entry by title or create a new one if it doesn't exist",
+    name: "sync_with_github_project",
+    description: "Sync a devlog entry with GitHub Project (create or update project item)",
     inputSchema: {
       type: "object",
       properties: {
         id: {
           type: "string",
-          description: "Unique identifier for the devlog entry",
-        },
-        title: {
-          type: "string",
-          description: "Title of the task/feature/bugfix",
-        },
-        type: {
-          type: "string",
-          enum: ["feature", "bugfix", "task", "refactor", "docs"],
-          description: "Type of work being done",
-        },
-        description: {
-          type: "string",
-          description: "Detailed description of the work",
-        },
-        priority: {
-          type: "string",
-          enum: ["low", "medium", "high", "critical"],
-          description: "Priority level",
-          default: "medium",
-        },
-        businessContext: {
-          type: "string",
-          description: "Business context - why this work matters and what problem it solves",
-        },
-        technicalContext: {
-          type: "string",
-          description: "Technical context - architecture decisions, constraints, assumptions",
-        },
-        acceptanceCriteria: {
-          type: "array",
-          items: { type: "string" },
-          description: "Acceptance criteria or definition of done",
-        },
-        initialInsights: {
-          type: "array",
-          items: { type: "string" },
-          description: "Initial insights or knowledge about this work",
+          description: "ID of the devlog entry to sync",
         },
-        relatedPatterns: {
-          type: "array",
-          items: { type: "string" },
-          description: "Related patterns or examples from other projects",
+      },
+      required: ["id"],
+    },
+  },
+  {
+    name: "import_github_project_items",
+    description: "Import existing GitHub project items as devlog entries",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectNumber: {
+          type: "number",
+          description: "GitHub project number (optional, uses configured project if not provided)",
         },
       },
-      required: ["title", "type", "description"],
     },
   },
 ];
@@ -619,6 +592,15 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         }
         return await devlogAdapter.syncAllIntegrations(args.id as string);
 
+      case "sync_with_github_project":
+        if (!args || typeof args !== 'object' || !('id' in args)) {
+          throw new Error("Missing required parameter: id");
+        }
+        return await devlogAdapter.syncWithGitHubProject(args.id as string);
+
+      case "import_github_project_items":
+        return await devlogAdapter.importGitHubProjectItems(args);
+
       case "find_or_create_devlog":
         if (!args || typeof args !== 'object') {
           throw new Error("Missing or invalid arguments");

packages/mcp-server/src/index.ts

@@ -378,6 +378,60 @@ export class MCPDevlogAdapter {
     }
   }
 
+  async syncWithGitHubProject(id: string): Promise<CallToolResult> {
+    try {
+      const entry = await this.devlogManager.syncWithGitHubProject(id);
+      const githubProjectRef = entry.externalReferences?.find(ref => 
+        ref.system === "github" && ref.url?.includes('projects')
+      );
+      
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Successfully synced devlog ${entry.id} with GitHub Project.\n\nProject Item: ${githubProjectRef?.id}\nURL: ${githubProjectRef?.url}\nStatus: ${githubProjectRef?.status}\nLast Sync: ${githubProjectRef?.lastSync}`,
+          },
+        ],
+      };
+    } catch (error) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Failed to sync with GitHub Project: ${error}`,
+          },
+        ],
+        isError: true,
+      };
+    }
+  }
+
+  async importGitHubProjectItems(args?: any): Promise<CallToolResult> {
+    try {
+      const projectNumber = args?.projectNumber;
+      const importedEntries = await this.devlogManager.importGitHubProjectItems(projectNumber);
+      
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Successfully imported ${importedEntries.length} GitHub project items as devlog entries.\n\nImported entries:\n${importedEntries.map(entry => `- ${entry.id}: ${entry.title}`).join('\n')}`,
+          },
+        ],
+      };
+    } catch (error) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Failed to import GitHub project items: ${error}`,
+          },
+        ],
+        isError: true,
+      };
+    }
+  }
+
   async syncAllIntegrations(id: string): Promise<CallToolResult> {
     try {
       const entry = await this.devlogManager.syncAllIntegrations(id);

packages/mcp-server/src/mcp-adapter.ts

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+
+/**
+ * Check GitHub Repository Access
+ */
+
+import fs from 'fs';
+
+async function checkGitHubRepo() {
+  console.log('🔍 Checking GitHub Repository Access');
+  console.log('=====================================\n');
+
+  try {
+    const config = JSON.parse(fs.readFileSync('devlog.config.json', 'utf-8'));
+    const github = config.integrations.github;
+    
+    console.log(`📦 Repository: ${github.owner}/${github.repo}`);
+    console.log(`🔑 Token: ${github.token.substring(0, 20)}...`);
+    
+    // Check if repo exists and is accessible
+    const response = await fetch(`https://api.github.com/repos/${github.owner}/${github.repo}`, {
+      headers: {
+        'Authorization': `token ${github.token}`,
+        'Accept': 'application/vnd.github.v3+json'
+      }
+    });
+    
+    if (response.ok) {
+      const repo = await response.json();
+      console.log(`✅ Repository found: ${repo.full_name}`);
+      console.log(`📝 Description: ${repo.description || 'No description'}`);
+      console.log(`🔒 Private: ${repo.private}`);
+      
+      // Check token permissions
+      const permissionsResponse = await fetch(`https://api.github.com/repos/${github.owner}/${github.repo}`, {
+        headers: {
+          'Authorization': `token ${github.token}`,
+          'Accept': 'application/vnd.github.v3+json'
+        }
+      });
+      
+      if (permissionsResponse.headers.get('x-oauth-scopes')) {
+        console.log(`🔐 Token scopes: ${permissionsResponse.headers.get('x-oauth-scopes')}`);
+      }
+      
+    } else if (response.status === 404) {
+      console.log(`❌ Repository ${github.owner}/${github.repo} not found or not accessible`);
+      console.log('💡 This might be a private repository or the repository name is incorrect');
+    } else {
+      console.log(`❌ Error accessing repository: ${response.status} ${response.statusText}`);
+    }
+    
+  } catch (error) {
+    console.error('❌ Error:', error.message);
+  }
+}
+
+checkGitHubRepo();