sprint-artifact 0.2.0

package/LICENSE

@@ -0,0 +1 @@
+MIT License

package/README.md

@@ -0,0 +1,161 @@
+# Sprint Artifact
+
+Sprint Artifact management tool with Google Drive integration.
+
+Manage your sprint artifacts (BRD, PRD, tasks, backlogs) directly from CLI or AI assistants (Cursor, Claude, Codex, OpenCode).
+
+## Features
+
+- **CLI** - Full command-line interface for sprint management
+- **MCP Server** - Integration with AI coding assistants
+- **SDK** - Programmatic access for custom workflows
+- **Google Drive Sync** - Bi-directional sync with Google Drive
+- **OAuth2 Login** - Simple Google account login for team members
+
+## Quick Start
+
+### Install
+
+```bash
+npm install -g sprint-artifact
+```
+
+### Setup Google Cloud
+
+1. Buka [Google Cloud Console](https://console.cloud.google.com)
+2. Buat/select project
+3. Enable **Google Drive API** (APIs & Services > Library)
+4. Buat **OAuth consent screen** (APIs & Services > OAuth consent screen)
+   - User Type: **Internal** (Workspace) atau **External**
+   - App name: `sprint-artifact`
+5. Buat **OAuth 2.0 Client ID** (APIs & Services > Credentials)
+   - Application type: **Desktop app**
+   - Download JSON
+
+### Login
+
+```bash
+# Taruh credentials.json di folder project atau ~/.sprint-artifact/
+cp ~/Downloads/credentials.json ./credentials.json
+
+# Login dengan Google account
+sprint-artifact login
+```
+
+Browser terbuka > pilih akun Google > selesai.
+
+### Initialize Project
+
+```bash
+# Buat folder di Google Drive, copy folder ID dari URL
+sprint-artifact init --folder-id <GOOGLE_DRIVE_FOLDER_ID>
+```
+
+## CLI Commands
+
+```bash
+# Login dengan Google account
+sprint-artifact login [--credentials <path>]
+
+# Initialize project
+sprint-artifact init --folder-id <FOLDER_ID>
+
+# Buat backlog item
+sprint-artifact backlog create --title "Feature" --desc "Description" --priority high
+
+# Sync dengan Google Drive
+sprint-artifact sync
+
+# Lihat status
+sprint-artifact status
+
+# Pilih task yang sedang dikerjakan
+sprint-artifact select <TASK_ID>
+
+# Pindahkan backlog ke sprint
+sprint-artifact sprint move --backlog-id <ID> --sprint-id <ID>
+```
+
+## MCP Server
+
+Tambahkan ke konfigurasi MCP (Cursor, Claude, dll):
+
+```json
+{
+  "mcpServers": {
+    "sprint-artifact": {
+      "command": "sprint-artifact",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+### Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `backlog_create` | Buat backlog item baru |
+| `sync_documents` | Sync dokumen dengan Google Drive |
+| `move_to_sprint` | Pindahkan backlog ke sprint |
+| `status` | Lihat status project |
+| `select_task` | Pilih task yang sedang dikerjakan |
+
+## SDK Usage
+
+```typescript
+import { SprintArtifact } from 'sprint-artifact';
+
+const artifact = new SprintArtifact(process.cwd());
+
+// Login (hanya perlu sekali)
+await artifact.init('GOOGLE_DRIVE_FOLDER_ID');
+
+// Buat backlog
+await artifact.createBacklog('Feature A', 'Description', 'high');
+
+// Sync dengan Google Drive
+const result = await artifact.sync();
+console.log(`Added: ${result.added}, Updated: ${result.updated}`);
+```
+
+## Configuration
+
+### `.sprint-artifact/config.json`
+
+```json
+{
+  "version": 1,
+  "googleDrive": {
+    "folderId": "your-folder-id"
+  },
+  "selectedTask": "task-id",
+  "manifest": {
+    "lastSync": "2024-01-01T00:00:00Z",
+    "files": []
+  }
+}
+```
+
+### `.sprint-artifact/auth.json`
+
+Auto-generated saat login. Jangan commit ke repository.
+
+## Project Structure
+
+```
+.sprint-artifact/
+├── config.json    # Project config (folder ID, manifest)
+└── auth.json      # OAuth2 tokens (auto-generated)
+```
+
+## Security
+
+- `auth.json` dan `credentials.json` di-**gitignore** secara default
+- Setiap user login dengan akun Google masing-masing
+- Token tersimpan lokal di tiap komputer
+- Untuk team, share `credentials.json` via internal docs (bukan public repo)
+
+## License
+
+MIT

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { SprintArtifact } from '../sdk/index.js';
+import { resolve } from 'node:path';
+import { login } from '../utils/oauth2.js';
+import { saveAuth } from '../utils/config.js';
+const program = new Command();
+program
+    .name('sprint-artifact')
+    .description('Sprint Artifact management tool with Google Drive integration')
+    .version('0.1.0');
+program
+    .command('login')
+    .description('Login with Google account (auto-detect credentials)')
+    .option('--credentials <path>', 'Path to OAuth2 credentials JSON file')
+    .action(async (options) => {
+    try {
+        const projectRoot = resolve(process.cwd());
+        const credentials = await login({
+            credentialsPath: options.credentials,
+        });
+        await saveAuth(projectRoot, {
+            type: 'oauth2',
+            credentials,
+        });
+        console.log('✓ Login successful');
+        console.log('  Auth saved to .sprint-artifact/auth.json');
+    }
+    catch (error) {
+        console.error('✗ Login failed:', error);
+        process.exit(1);
+    }
+});
+program
+    .command('init')
+    .description('Initialize a new Sprint Artifact project')
+    .requiredOption('--folder-id <id>', 'Google Drive folder ID')
+    .option('--auth <path>', 'Path to auth JSON file')
+    .action(async (options) => {
+    try {
+        const projectRoot = resolve(process.cwd());
+        const artifact = new SprintArtifact(projectRoot);
+        await artifact.init(options.folderId);
+        console.log('✓ Sprint Artifact project initialized');
+        console.log(`  Folder ID: ${options.folderId}`);
+        console.log('  Config: .sprint-artifact/config.json');
+        if (options.auth) {
+            console.log(`  Auth: ${options.auth}`);
+        }
+    }
+    catch (error) {
+        console.error('✗ Failed to initialize:', error);
+        process.exit(1);
+    }
+});
+const backlogCmd = program
+    .command('backlog')
+    .description('Manage backlog items');
+backlogCmd
+    .command('create')
+    .description('Create a new backlog item')
+    .requiredOption('--title <title>', 'Backlog item title')
+    .option('--description <desc>', 'Backlog item description', '')
+    .option('--priority <priority>', 'Priority (high, medium, low)', 'medium')
+    .action(async (options) => {
+    try {
+        const projectRoot = resolve(process.cwd());
+        const artifact = new SprintArtifact(projectRoot);
+        const item = await artifact.createBacklog(options.title, options.description, options.priority);
+        console.log('✓ Backlog item created');
+        console.log(`  ID: ${item.id}`);
+        console.log(`  Title: ${item.title}`);
+    }
+    catch (error) {
+        console.error('✗ Failed to create backlog item:', error);
+        process.exit(1);
+    }
+});
+program
+    .command('sync')
+    .description('Sync documents with Google Drive')
+    .action(async () => {
+    try {
+        const projectRoot = resolve(process.cwd());
+        const artifact = new SprintArtifact(projectRoot);
+        const result = await artifact.sync();
+        console.log('✓ Sync completed');
+        console.log(`  Added: ${result.added}`);
+        console.log(`  Updated: ${result.updated}`);
+        console.log(`  Deleted: ${result.deleted}`);
+    }
+    catch (error) {
+        console.error('✗ Sync failed:', error);
+        process.exit(1);
+    }
+});
+program
+    .command('status')
+    .description('Show project status')
+    .action(async () => {
+    try {
+        const projectRoot = resolve(process.cwd());
+        const artifact = new SprintArtifact(projectRoot);
+        const status = await artifact.status();
+        console.log('Sprint Artifact Status');
+        console.log('─'.repeat(40));
+        console.log(`Initialized: ${status.initialized ? 'Yes' : 'No'}`);
+        if (status.initialized) {
+            console.log(`Folder ID: ${status.folderId}`);
+            console.log(`Selected Task: ${status.selectedTask || 'None'}`);
+            console.log(`Last Sync: ${status.lastSync || 'Never'}`);
+            console.log(`Files: ${status.fileCount}`);
+        }
+    }
+    catch (error) {
+        console.error('✗ Failed to get status:', error);
+        process.exit(1);
+    }
+});
+program
+    .command('select')
+    .description('Select a task to work on')
+    .argument('<task-id>', 'Task ID to select')
+    .action(async (taskId) => {
+    try {
+        const projectRoot = resolve(process.cwd());
+        const artifact = new SprintArtifact(projectRoot);
+        await artifact.selectTask(taskId);
+        console.log(`✓ Selected task: ${taskId}`);
+    }
+    catch (error) {
+        console.error('✗ Failed to select task:', error);
+        process.exit(1);
+    }
+});
+const sprintCmd = program
+    .command('sprint')
+    .description('Manage sprints');
+sprintCmd
+    .command('move')
+    .description('Move a backlog item to a sprint')
+    .requiredOption('--backlog-id <id>', 'Backlog item ID')
+    .requiredOption('--sprint-id <id>', 'Sprint ID')
+    .action(async (options) => {
+    try {
+        const projectRoot = resolve(process.cwd());
+        const artifact = new SprintArtifact(projectRoot);
+        await artifact.moveToSprint(options.backlogId, options.sprintId);
+        console.log(`✓ Moved backlog item ${options.backlogId} to sprint ${options.sprintId}`);
+    }
+    catch (error) {
+        console.error('✗ Failed to move item:', error);
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,iBAAiB,CAAC;KACvB,WAAW,CAAC,+DAA+D,CAAC;KAC5E,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,qDAAqD,CAAC;KAClE,MAAM,CAAC,sBAAsB,EAAE,sCAAsC,CAAC;KACtE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3C,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC;YAC9B,eAAe,EAAE,OAAO,CAAC,WAAW;SACrC,CAAC,CAAC;QAEH,MAAM,QAAQ,CAAC,WAAW,EAAE;YAC1B,IAAI,EAAE,QAAQ;YACd,WAAW;SACZ,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAC5D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,0CAA0C,CAAC;KACvD,cAAc,CAAC,kBAAkB,EAAE,wBAAwB,CAAC;KAC5D,MAAM,CAAC,eAAe,EAAE,wBAAwB,CAAC;KACjD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC;QACjD,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,gBAAgB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;QACtD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,MAAM,UAAU,GAAG,OAAO;KACvB,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,sBAAsB,CAAC,CAAC;AAEvC,UAAU;KACP,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,2BAA2B,CAAC;KACxC,cAAc,CAAC,iBAAiB,EAAE,oBAAoB,CAAC;KACvD,MAAM,CAAC,sBAAsB,EAAE,0BAA0B,EAAE,EAAE,CAAC;KAC9D,MAAM,CAAC,uBAAuB,EAAE,8BAA8B,EAAE,QAAQ,CAAC;KACzE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,aAAa,CACvC,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,QAAQ,CACjB,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;QACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,kCAAkC,CAAC;KAC/C,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,qBAAqB,CAAC;KAClC,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACjE,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,YAAY,IAAI,MAAM,EAAE,CAAC,CAAC;YAC/D,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,QAAQ,IAAI,OAAO,EAAE,CAAC,CAAC;YACxD,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,0BAA0B,CAAC;KACvC,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;KAC1C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;IACvB,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC;QACjD,MAAM,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,MAAM,SAAS,GAAG,OAAO;KACtB,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,gBAAgB,CAAC,CAAC;AAEjC,SAAS;KACN,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,iCAAiC,CAAC;KAC9C,cAAc,CAAC,mBAAmB,EAAE,iBAAiB,CAAC;KACtD,cAAc,CAAC,kBAAkB,EAAE,WAAW,CAAC;KAC/C,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC;QACjD,MAAM,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjE,OAAO,CAAC,GAAG,CAAC,wBAAwB,OAAO,CAAC,SAAS,cAAc,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACzF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":""}

package/dist/mcp/index.js

@@ -0,0 +1,180 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { SprintArtifact } from '../sdk/index.js';
+import { resolve } from 'node:path';
+import { z } from 'zod';
+const server = new Server({
+    name: 'sprint-artifact',
+    version: '0.1.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+const projectRoot = resolve(process.cwd());
+const artifact = new SprintArtifact(projectRoot);
+const BacklogCreateSchema = z.object({
+    title: z.string(),
+    description: z.string().optional().default(''),
+    priority: z.enum(['high', 'medium', 'low']).optional().default('medium'),
+});
+const SyncSchema = z.object({});
+const MoveToSprintSchema = z.object({
+    backlogId: z.string(),
+    sprintId: z.string(),
+});
+const StatusSchema = z.object({});
+const SelectTaskSchema = z.object({
+    taskId: z.string(),
+});
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: 'backlog_create',
+                description: 'Create a new backlog item in Google Drive',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        title: { type: 'string', description: 'Backlog item title' },
+                        description: { type: 'string', description: 'Backlog item description' },
+                        priority: {
+                            type: 'string',
+                            enum: ['high', 'medium', 'low'],
+                            description: 'Priority level',
+                        },
+                    },
+                    required: ['title'],
+                },
+            },
+            {
+                name: 'sync_documents',
+                description: 'Sync documents between local and Google Drive',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                },
+            },
+            {
+                name: 'move_to_sprint',
+                description: 'Move a backlog item to a sprint',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        backlogId: { type: 'string', description: 'Backlog item ID' },
+                        sprintId: { type: 'string', description: 'Sprint ID' },
+                    },
+                    required: ['backlogId', 'sprintId'],
+                },
+            },
+            {
+                name: 'status',
+                description: 'Get current project status',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                },
+            },
+            {
+                name: 'select_task',
+                description: 'Select a task to work on',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        taskId: { type: 'string', description: 'Task ID to select' },
+                    },
+                    required: ['taskId'],
+                },
+            },
+        ],
+    };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case 'backlog_create': {
+                const { title, description, priority } = BacklogCreateSchema.parse(args);
+                const item = await artifact.createBacklog(title, description, priority);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(item, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'sync_documents': {
+                SyncSchema.parse(args);
+                const result = await artifact.sync();
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'move_to_sprint': {
+                const { backlogId, sprintId } = MoveToSprintSchema.parse(args);
+                await artifact.moveToSprint(backlogId, sprintId);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Moved backlog item ${backlogId} to sprint ${sprintId}`,
+                        },
+                    ],
+                };
+            }
+            case 'status': {
+                StatusSchema.parse(args);
+                const status = await artifact.status();
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(status, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'select_task': {
+                const { taskId } = SelectTaskSchema.parse(args);
+                await artifact.selectTask(taskId);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Selected task: ${taskId}`,
+                        },
+                    ],
+                };
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('Sprint Artifact MCP server running on stdio');
+}
+main().catch(console.error);
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,iBAAiB;IACvB,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAC;AAEF,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AAC3C,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC;AAEjD,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9C,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;CACzE,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEhC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAElC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC;AAEH,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;IAC1D,OAAO;QACL,KAAK,EAAE;YACL;gBACE,IAAI,EAAE,gBAAgB;gBACtB,WAAW,EAAE,2CAA2C;gBACxD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;wBAC5D,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;wBACxE,QAAQ,EAAE;4BACR,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC;4BAC/B,WAAW,EAAE,gBAAgB;yBAC9B;qBACF;oBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;iBACpB;aACF;YACD;gBACE,IAAI,EAAE,gBAAgB;gBACtB,WAAW,EAAE,+CAA+C;gBAC5D,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,EAAE;iBACf;aACF;YACD;gBACE,IAAI,EAAE,gBAAgB;gBACtB,WAAW,EAAE,iCAAiC;gBAC9C,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE;wBAC7D,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE;qBACvD;oBACD,QAAQ,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC;iBACpC;aACF;YACD;gBACE,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4BAA4B;gBACzC,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,EAAE;iBACf;aACF;YACD;gBACE,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE,0BAA0B;gBACvC,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;qBAC7D;oBACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;iBACrB;aACF;SACF;KACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,IAAI,CAAC;QACH,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,gBAAgB,CAAC,CAAC,CAAC;gBACtB,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACzE,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;gBACxE,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;yBACpC;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,KAAK,gBAAgB,CAAC,CAAC,CAAC;gBACtB,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACvB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACrC,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;yBACtC;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,KAAK,gBAAgB,CAAC,CAAC,CAAC;gBACtB,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC/D,MAAM,QAAQ,CAAC,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;gBACjD,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,sBAAsB,SAAS,cAAc,QAAQ,EAAE;yBAC9D;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACzB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACvC,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;yBACtC;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,MAAM,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAChD,MAAM,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;gBAClC,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,kBAAkB,MAAM,EAAE;yBACjC;qBACF;iBACF,CAAC;YACJ,CAAC;YAED;gBACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;iBACzE;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;AAC/D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/sdk/google-drive.d.ts

@@ -0,0 +1,15 @@
+import type { AuthConfig, ManifestFile } from '../types/index.js';
+export declare class GoogleDriveClient {
+    private drive;
+    constructor(auth: AuthConfig);
+    private createAuthClient;
+    createFolder(name: string, parentId?: string): Promise<string>;
+    createFile(name: string, content: string, parentId?: string, mimeType?: string): Promise<string>;
+    getFile(fileId: string): Promise<string>;
+    updateFile(fileId: string, content: string, mimeType?: string): Promise<void>;
+    listFiles(folderId: string): Promise<ManifestFile[]>;
+    getFileMetadata(fileId: string): Promise<ManifestFile>;
+    deleteFile(fileId: string): Promise<void>;
+    findFolder(name: string, parentId?: string): Promise<string | null>;
+}
+//# sourceMappingURL=google-drive.d.ts.map

package/dist/sdk/google-drive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-drive.d.ts","sourceRoot":"","sources":["../../src/sdk/google-drive.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAqB,MAAM,mBAAmB,CAAC;AAErF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAAiB;gBAElB,IAAI,EAAE,UAAU;IAK5B,OAAO,CAAC,gBAAgB;IAuBlB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAe9D,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,SAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBzG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQxC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAUtF,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAgBpD,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAgBtD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAa1E"}

package/dist/sdk/google-drive.js

@@ -0,0 +1,114 @@
+import { google } from 'googleapis';
+export class GoogleDriveClient {
+    drive;
+    constructor(auth) {
+        const authClient = this.createAuthClient(auth);
+        this.drive = google.drive({ version: 'v3', auth: authClient });
+    }
+    createAuthClient(auth) {
+        if (auth.type === 'service_account') {
+            return new google.auth.GoogleAuth({
+                credentials: auth.credentials,
+                scopes: ['https://www.googleapis.com/auth/drive'],
+            });
+        }
+        else {
+            const creds = auth.credentials;
+            const oauth2Client = new google.auth.OAuth2(creds.client_id, creds.client_secret, creds.redirect_uris[0]);
+            if (creds.refresh_token) {
+                oauth2Client.setCredentials({
+                    refresh_token: creds.refresh_token,
+                    access_token: creds.access_token,
+                });
+            }
+            return oauth2Client;
+        }
+    }
+    async createFolder(name, parentId) {
+        const fileMetadata = {
+            name,
+            mimeType: 'application/vnd.google-apps.folder',
+            ...(parentId && { parents: [parentId] }),
+        };
+        const response = await this.drive.files.create({
+            requestBody: fileMetadata,
+            fields: 'id',
+        });
+        return response.data.id;
+    }
+    async createFile(name, content, parentId, mimeType = 'text/markdown') {
+        const fileMetadata = {
+            name,
+            ...(parentId && { parents: [parentId] }),
+        };
+        const media = {
+            mimeType,
+            body: content,
+        };
+        const response = await this.drive.files.create({
+            requestBody: fileMetadata,
+            media,
+            fields: 'id',
+        });
+        return response.data.id;
+    }
+    async getFile(fileId) {
+        const response = await this.drive.files.get({
+            fileId,
+            alt: 'media',
+        });
+        return response.data;
+    }
+    async updateFile(fileId, content, mimeType = 'text/markdown') {
+        await this.drive.files.update({
+            fileId,
+            media: {
+                mimeType,
+                body: content,
+            },
+        });
+    }
+    async listFiles(folderId) {
+        const response = await this.drive.files.list({
+            q: `'${folderId}' in parents and trashed = false`,
+            fields: 'files(id, name, mimeType, modifiedTime, md5Checksum)',
+            pageSize: 1000,
+        });
+        return (response.data.files || []).map((file) => ({
+            id: file.id,
+            name: file.name,
+            mimeType: file.mimeType,
+            modifiedTime: file.modifiedTime,
+            md5Checksum: file.md5Checksum || undefined,
+        }));
+    }
+    async getFileMetadata(fileId) {
+        const response = await this.drive.files.get({
+            fileId,
+            fields: 'id, name, mimeType, modifiedTime, md5Checksum',
+        });
+        const file = response.data;
+        return {
+            id: file.id,
+            name: file.name,
+            mimeType: file.mimeType,
+            modifiedTime: file.modifiedTime,
+            md5Checksum: file.md5Checksum || undefined,
+        };
+    }
+    async deleteFile(fileId) {
+        await this.drive.files.delete({ fileId });
+    }
+    async findFolder(name, parentId) {
+        const query = parentId
+            ? `name = '${name}' and '${parentId}' in parents and mimeType = 'application/vnd.google-apps.folder' and trashed = false`
+            : `name = '${name}' and mimeType = 'application/vnd.google-apps.folder' and trashed = false`;
+        const response = await this.drive.files.list({
+            q: query,
+            fields: 'files(id)',
+            pageSize: 1,
+        });
+        return response.data.files?.[0]?.id || null;
+    }
+}
+//# sourceMappingURL=google-drive.js.map