zerg-status 2.0.0 → 2.1.0

package/dist/commands/pr.d.ts

@@ -0,0 +1,8 @@
+/**
+ * pr command - Set or clear the PR URL for the session.
+ *
+ * Usage:
+ *   zerg-status -s <id> pr "https://github.com/org/repo/pull/123"
+ *   zerg-status -s <id> pr clear
+ */
+export declare function prCommand(sessionId: string, prUrl: string): void;

package/dist/commands/pr.js

@@ -0,0 +1,14 @@
+import { setPr } from '../state.js';
+import { formatStatusOutput } from '../output.js';
+/**
+ * pr command - Set or clear the PR URL for the session.
+ *
+ * Usage:
+ *   zerg-status -s <id> pr "https://github.com/org/repo/pull/123"
+ *   zerg-status -s <id> pr clear
+ */
+export function prCommand(sessionId, prUrl) {
+    const url = prUrl.toLowerCase() === 'clear' ? null : prUrl;
+    const state = setPr(sessionId, url);
+    console.log(formatStatusOutput(state));
+}

package/dist/commands/summary.d.ts

@@ -1 +1,11 @@
-export declare function summaryCommand(sessionId: string, text: string): void;
+/**
+ * summary command - Set a prose description of current work state.
+ *
+ * Shown in expanded/focus view (not on cards - use 'now' for that).
+ * Update when significant progress is made, not on every tool call.
+ *
+ * Usage:
+ *   zerg-status -s <id> summary "I've fixed the major lint errors and integrated
+ *     all components. Now applying type fixes to ensure a clean build."
+ */
+export declare function summaryCommand(sessionId: string, summary: string): void;

package/dist/commands/summary.js

@@ -1,8 +1,16 @@
 import { setSummary } from '../state.js';
-import { validateSummary } from '../validate.js';
 import { formatStatusOutput } from '../output.js';
-export function summaryCommand(sessionId, text) {
-    const validText = validateSummary(text);
-    const state = setSummary(sessionId, validText);
+/**
+ * summary command - Set a prose description of current work state.
+ *
+ * Shown in expanded/focus view (not on cards - use 'now' for that).
+ * Update when significant progress is made, not on every tool call.
+ *
+ * Usage:
+ *   zerg-status -s <id> summary "I've fixed the major lint errors and integrated
+ *     all components. Now applying type fixes to ensure a clean build."
+ */
+export function summaryCommand(sessionId, summary) {
+    const state = setSummary(sessionId, summary);
     console.log(formatStatusOutput(state));
 }

package/dist/index.d.ts

@@ -5,9 +5,12 @@
  * COMMANDS:
  *   npx zerg-status init "Session Name"            # Initialize session with name
  *   npx zerg-status -s <id> now "Activity"         # Set current activity (while working)
+ *   npx zerg-status -s <id> summary "Prose..."     # Set prose summary of current state
  *   npx zerg-status -s <id> ask "Question?"        # Set blocked state with question
  *   npx zerg-status -s <id> ask "Q?" -- "A: desc" "B: desc"  # With clickable options
  *   npx zerg-status -s <id> done "Result summary"  # Set done state with summary
+ *   npx zerg-status -s <id> pr "https://..."       # Report a PR URL
+ *   npx zerg-status -s <id> pr clear               # Clear the PR URL
  *   npx zerg-status -s <id> tasks set "A" "B" "C"  # Set task list
  *   npx zerg-status -s <id> task doing "A"         # Mark task in progress
  *   npx zerg-status -s <id> task done "A"          # Mark task complete

package/dist/index.js

@@ -5,17 +5,22 @@
  * COMMANDS:
  *   npx zerg-status init "Session Name"            # Initialize session with name
  *   npx zerg-status -s <id> now "Activity"         # Set current activity (while working)
+ *   npx zerg-status -s <id> summary "Prose..."     # Set prose summary of current state
  *   npx zerg-status -s <id> ask "Question?"        # Set blocked state with question
  *   npx zerg-status -s <id> ask "Q?" -- "A: desc" "B: desc"  # With clickable options
  *   npx zerg-status -s <id> done "Result summary"  # Set done state with summary
+ *   npx zerg-status -s <id> pr "https://..."       # Report a PR URL
+ *   npx zerg-status -s <id> pr clear               # Clear the PR URL
  *   npx zerg-status -s <id> tasks set "A" "B" "C"  # Set task list
  *   npx zerg-status -s <id> task doing "A"         # Mark task in progress
  *   npx zerg-status -s <id> task done "A"          # Mark task complete
  */
 import { init } from './commands/init.js';
 import { nowCommand } from './commands/now.js';
+import { summaryCommand } from './commands/summary.js';
 import { askCommand } from './commands/ask.js';
 import { doneCommand } from './commands/done.js';
+import { prCommand } from './commands/pr.js';
 import { taskCommand } from './commands/task.js';
 import { tasksCommand } from './commands/tasks.js';
 import { validateSessionId, ValidationError } from './validate.js';
@@ -64,14 +69,28 @@ COMMANDS:
   init "Session Name"              Initialize session (outputs ZERG_SESSION:<id>:<name>)
 
   -s <id> now "Activity"           Set current activity (max 50 chars, while working)
+  -s <id> summary "Prose..."       Set prose summary of current work state (max 500 chars)
   -s <id> ask "Question?"          Set blocked state with question
   -s <id> ask "Q?" -- "A" "B"      Set blocked with clickable options (2-5 options)
   -s <id> done "Result summary"    Set done state with result summary
+  -s <id> pr "https://..."         Report a PR URL (supersedes Devin's PR tracking)
+  -s <id> pr clear                 Clear the PR URL
 
   -s <id> tasks set "A" "B" "C"    Set task list (shows progress bar)
   -s <id> task doing "Task"        Mark task as in progress
   -s <id> task done "Task"         Mark task as complete
 
+FIELD PURPOSES:
+  now:     What you're doing RIGHT NOW (for scanning session cards)
+           "Fixing type errors in actions.ts"
+
+  summary: Prose paragraph about CURRENT STATE of work (for expanded view)
+           "I've fixed the major lint errors and integrated all components.
+            Now applying type fixes to ensure a clean build."
+
+  done:    Final result summary when finished
+           "Implemented feature X. All 12 tests pass."
+
 OPTIONS FORMAT:
   Options use "Name: Description" format. Description is optional.
   Example: "Redis: Faster, needs separate server"
@@ -85,12 +104,16 @@ EXAMPLES:
   npx zerg-status -s f7a3b2c1 tasks set "Investigate" "Fix" "Test"
   npx zerg-status -s f7a3b2c1 task doing "Investigate"
   npx zerg-status -s f7a3b2c1 now "Analyzing auth module"
+  npx zerg-status -s f7a3b2c1 summary "Found the auth bug in JWT validation. The refresh token logic has a race condition when multiple requests arrive simultaneously."
 
   # When blocked with options
   npx zerg-status -s f7a3b2c1 ask "Which database?" -- \\
     "Redis: Faster, requires separate server" \\
     "PostgreSQL: Simpler, uses existing DB"
 
+  # Report a PR
+  npx zerg-status -s f7a3b2c1 pr "https://github.com/org/repo/pull/123"
+
   # When finished
   npx zerg-status -s f7a3b2c1 done "Fixed auth bug. JWT refresh working, 8 tests added."
 
@@ -127,6 +150,15 @@ function main() {
                 doneCommand(validSessionId, summary);
                 break;
             }
+            case 'pr': {
+                const validSessionId = validateSessionId(sessionId);
+                const prUrl = args.join(' ');
+                if (!prUrl) {
+                    throw new ValidationError('PR URL required. Example: pr "https://github.com/org/repo/pull/123" or pr clear');
+                }
+                prCommand(validSessionId, prUrl);
+                break;
+            }
             case 'now': {
                 const validSessionId = validateSessionId(sessionId);
                 const text = args.join(' ');
@@ -136,6 +168,15 @@ function main() {
                 nowCommand(validSessionId, text);
                 break;
             }
+            case 'summary': {
+                const validSessionId = validateSessionId(sessionId);
+                const text = args.join(' ');
+                if (!text) {
+                    throw new ValidationError('Summary text required. Example: summary "I\'ve fixed the lint errors and am now adding tests."');
+                }
+                summaryCommand(validSessionId, text);
+                break;
+            }
             case 'task': {
                 const validSessionId = validateSessionId(sessionId);
                 const [action, ...rest] = args;

package/dist/state.d.ts

@@ -25,3 +25,8 @@ export declare function setAsk(sessionId: string, question: string, optionString
  * This is the new unified command that sets state=done AND stores the summary.
  */
 export declare function setDone(sessionId: string, summary: string): ZergState;
+/**
+ * Set PR URL for the session.
+ * This supersedes Devin's native PR tracking - agents can report PRs directly.
+ */
+export declare function setPr(sessionId: string, prUrl: string | null): ZergState;

package/dist/state.js

@@ -3,7 +3,7 @@ import path from 'path';
 import os from 'os';
 import crypto from 'crypto';
 import { DEFAULT_STATE } from './types.js';
-import { validateTaskCount, validateTask, validateAsk, validateDone, validateAskOptions } from './validate.js';
+import { validateTaskCount, validateTask, validateAsk, validateDone, validateAskOptions, validatePrUrl, validateSummary } from './validate.js';
 const STATE_DIR = path.join(os.homedir(), '.zerg-status');
 function ensureStateDir() {
     if (!fs.existsSync(STATE_DIR)) {
@@ -72,6 +72,7 @@ export function setNow(sessionId, now) {
     return updateState(sessionId, { now });
 }
 export function setSummary(sessionId, summary) {
+    validateSummary(summary);
     return updateState(sessionId, { summary });
 }
 export function setNotify(sessionId, notify) {
@@ -158,3 +159,21 @@ export function setDone(sessionId, summary) {
     saveState(state);
     return state;
 }
+/**
+ * Set PR URL for the session.
+ * This supersedes Devin's native PR tracking - agents can report PRs directly.
+ */
+export function setPr(sessionId, prUrl) {
+    const state = loadState(sessionId);
+    if (prUrl === null) {
+        // Clear PR
+        delete state.pr;
+    }
+    else {
+        // Validate and set PR URL
+        validatePrUrl(prUrl);
+        state.pr = prUrl;
+    }
+    saveState(state);
+    return state;
+}

package/dist/types.d.ts

@@ -17,11 +17,12 @@ export interface ZergState {
     name?: string;
     state: State;
     now: string;
+    summary?: string;
     ask?: string;
     askOptions?: AskOption[];
     done?: string;
+    pr?: string;
     tasks: Task[];
-    summary?: string;
     question?: string;
     notify?: string;
 }

package/dist/validate.d.ts

@@ -14,6 +14,7 @@ export declare const MIN_OPTIONS = 2;
 export declare const MAX_OPTIONS = 5;
 export declare const MAX_OPTION_NAME_LENGTH = 30;
 export declare const MAX_OPTION_DESC_LENGTH = 50;
+export declare const MAX_PR_URL_LENGTH = 500;
 export declare class ValidationError extends Error {
     constructor(message: string);
 }
@@ -42,3 +43,7 @@ export declare function parseOption(optionStr: string): AskOption;
  * Validates and parses ask options
  */
 export declare function validateAskOptions(optionStrings: string[]): AskOption[];
+/**
+ * Validates a PR URL
+ */
+export declare function validatePrUrl(url: string): string;

package/dist/validate.js

@@ -14,6 +14,8 @@ export const MIN_OPTIONS = 2;
 export const MAX_OPTIONS = 5;
 export const MAX_OPTION_NAME_LENGTH = 30;
 export const MAX_OPTION_DESC_LENGTH = 50;
+// PR validation
+export const MAX_PR_URL_LENGTH = 500;
 export class ValidationError extends Error {
     constructor(message) {
         super(message);
@@ -133,3 +135,16 @@ export function validateAskOptions(optionStrings) {
     }
     return optionStrings.map(parseOption);
 }
+/**
+ * Validates a PR URL
+ */
+export function validatePrUrl(url) {
+    if (url.length > MAX_PR_URL_LENGTH) {
+        throw new ValidationError(`PR URL too long (${url.length} chars). Max ${MAX_PR_URL_LENGTH} chars.`);
+    }
+    // Basic URL validation - must look like a URL
+    if (!url.startsWith('http://') && !url.startsWith('https://')) {
+        throw new ValidationError(`Invalid PR URL. Must start with http:// or https://`);
+    }
+    return url;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zerg-status",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Progress reporting CLI for Zerg dashboard",
   "type": "module",
   "bin": {