@ginkoai/cli 2.0.2 → 2.0.3

package/dist/lib/user-sprint.js

@@ -0,0 +1,147 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2026-01-14
+ * @tags: [sprint, user, session, assignment]
+ * @related: [sprint-loader.ts, start-reflection.ts, ginko-root.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: [fs-extra, path]
+ */
+/**
+ * Per-User Sprint Management
+ *
+ * Manages user-specific sprint assignments stored in:
+ * .ginko/sessions/{user}/current-sprint.json
+ *
+ * Enables multiple users to work on different sprints simultaneously
+ * while maintaining a global CURRENT-SPRINT.md for team coordination.
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { getUserEmail } from '../utils/helpers.js';
+import { getUserSessionPath, requireGinkoRoot } from '../utils/ginko-root.js';
+const CURRENT_SPRINT_FILE = 'current-sprint.json';
+/**
+ * Get the path to user's current-sprint.json
+ */
+async function getUserSprintFilePath() {
+    const userEmail = await getUserEmail();
+    const sessionPath = await getUserSessionPath(userEmail);
+    return path.join(sessionPath, CURRENT_SPRINT_FILE);
+}
+/**
+ * Get user's current sprint assignment
+ * Returns null if no sprint is assigned
+ */
+export async function getUserCurrentSprint() {
+    try {
+        const filePath = await getUserSprintFilePath();
+        if (!await fs.pathExists(filePath)) {
+            return null;
+        }
+        const data = await fs.readJSON(filePath);
+        // Validate required fields
+        if (!data.sprintId || !data.sprintFile) {
+            return null;
+        }
+        return data;
+    }
+    catch (error) {
+        // File doesn't exist or is invalid
+        return null;
+    }
+}
+/**
+ * Set user's current sprint assignment
+ */
+export async function setUserCurrentSprint(assignment) {
+    const filePath = await getUserSprintFilePath();
+    // Ensure session directory exists
+    await fs.ensureDir(path.dirname(filePath));
+    await fs.writeJSON(filePath, assignment, { spaces: 2 });
+}
+/**
+ * Clear user's current sprint assignment
+ * Used when sprint is complete and no next sprint is available
+ */
+export async function clearUserCurrentSprint() {
+    const filePath = await getUserSprintFilePath();
+    if (await fs.pathExists(filePath)) {
+        await fs.remove(filePath);
+    }
+}
+/**
+ * Extract sprint ID from sprint filename
+ * Handles patterns like:
+ * - SPRINT-2026-01-e011-s01-feature-name.md → e011_s01
+ * - e011-s01-something.md → e011_s01
+ * - epic011-sprint2.md → e011_s02
+ */
+export function extractSprintIdFromFilename(filename) {
+    const basename = path.basename(filename, '.md');
+    // Pattern 1: e{NNN}-s{NN} or e{NNN}_s{NN}
+    const modernPattern = /e(\d{3})[-_]s(\d{2})/i;
+    const modernMatch = basename.match(modernPattern);
+    if (modernMatch) {
+        const epicNum = modernMatch[1];
+        const sprintNum = modernMatch[2];
+        return {
+            sprintId: `e${epicNum}_s${sprintNum}`,
+            epicId: `e${epicNum}`
+        };
+    }
+    // Pattern 2: epic{NNN}-sprint{N} (legacy)
+    const legacyPattern = /epic(\d+)-sprint(\d+)/i;
+    const legacyMatch = basename.match(legacyPattern);
+    if (legacyMatch) {
+        const epicNum = legacyMatch[1].padStart(3, '0');
+        const sprintNum = legacyMatch[2].padStart(2, '0');
+        return {
+            sprintId: `e${epicNum}_s${sprintNum}`,
+            epicId: `e${epicNum}`
+        };
+    }
+    return null;
+}
+/**
+ * Create sprint assignment from a sprint file path
+ */
+export async function createAssignmentFromFile(sprintFilePath, sprintName, assignedBy = 'auto') {
+    const projectRoot = await requireGinkoRoot();
+    const relativePath = path.relative(projectRoot, sprintFilePath);
+    const ids = extractSprintIdFromFilename(sprintFilePath);
+    if (!ids) {
+        // Can't extract sprint ID from filename
+        return null;
+    }
+    return {
+        sprintId: ids.sprintId,
+        epicId: ids.epicId,
+        sprintFile: relativePath,
+        sprintName,
+        assignedAt: new Date().toISOString(),
+        assignedBy
+    };
+}
+/**
+ * Check if user's assigned sprint file still exists and is valid
+ */
+export async function validateUserSprint(assignment) {
+    try {
+        const projectRoot = await requireGinkoRoot();
+        const fullPath = path.join(projectRoot, assignment.sprintFile);
+        return await fs.pathExists(fullPath);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get sprint file path from user assignment
+ */
+export async function getSprintFileFromAssignment(assignment) {
+    const projectRoot = await requireGinkoRoot();
+    return path.join(projectRoot, assignment.sprintFile);
+}
+//# sourceMappingURL=user-sprint.js.map

package/dist/lib/user-sprint.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ginkoai/cli",
-  "version": "2.0.2",
+  "version": "2.0.3",
   "description": "Git-native session management and cloud context for AI-mediated development. AI Collaboration for Vibe Tribes.",
   "main": "dist/index.js",
   "bin": {