zerg-status 1.0.0 → 1.1.0

package/dist/commands/init.d.ts

@@ -1 +1 @@
-export declare function init(): void;
+export declare function init(name?: string): void;

package/dist/commands/init.js

@@ -1,6 +1,8 @@
 import { createSession } from '../state.js';
 import { formatSessionOutput } from '../output.js';
-export function init() {
-    const sessionId = createSession();
-    console.log(formatSessionOutput(sessionId));
+import { validateName } from '../validate.js';
+export function init(name) {
+    const validatedName = name ? validateName(name) : undefined;
+    const { sessionId, name: sessionName } = createSession(validatedName);
+    console.log(formatSessionOutput(sessionId, sessionName));
 }

package/dist/index.d.ts

@@ -3,6 +3,7 @@
  * zerg-status - Progress reporting CLI for Zerg dashboard
  *
  * Usage:
+ *   npx zerg-status init "Session Name"            # Initialize session with name
  *   npx zerg-status init                           # Initialize session, outputs ZERG_SESSION:<id>
  *   npx zerg-status -s <id> state work             # Set state to work/ask/done
  *   npx zerg-status -s <id> state ask "Question?"  # Set state to ask with a question

package/dist/index.js

@@ -3,6 +3,7 @@
  * zerg-status - Progress reporting CLI for Zerg dashboard
  *
  * Usage:
+ *   npx zerg-status init "Session Name"            # Initialize session with name
  *   npx zerg-status init                           # Initialize session, outputs ZERG_SESSION:<id>
  *   npx zerg-status -s <id> state work             # Set state to work/ask/done
  *   npx zerg-status -s <id> state ask "Question?"  # Set state to ask with a question
@@ -49,6 +50,7 @@ function printHelp() {
 zerg-status - Progress reporting CLI for Zerg dashboard
 
 COMMANDS:
+  init "Session Name"            Initialize new session with name (outputs ZERG_SESSION:<id>:<name>)
   init                           Initialize new session (outputs ZERG_SESSION:<id>)
 
   -s <id> state <work|ask|done>  Set session state
@@ -67,8 +69,8 @@ COMMANDS:
   -s <id> tasks set "A" "B" "C"  Replace all tasks (max 20 tasks)
 
 EXAMPLES:
-  npx zerg-status init
-  # ZERG_SESSION:f7a3b2c1
+  npx zerg-status init "Fix auth bug"
+  # ZERG_SESSION:f7a3b2c1:Fix auth bug
 
   npx zerg-status -s f7a3b2c1 state work
   npx zerg-status -s f7a3b2c1 now "Writing unit tests"
@@ -78,7 +80,7 @@ EXAMPLES:
   npx zerg-status -s f7a3b2c1 state done
 
 OUTPUT:
-  init outputs:    ZERG_SESSION:<session_id>
+  init outputs:    ZERG_SESSION:<session_id>[:<name>]
   all others:      ZERG_STATUS:<full_json_state>
 `);
 }
@@ -86,9 +88,11 @@ function main() {
     try {
         const { sessionId, command, args } = parseArgs(process.argv);
         switch (command) {
-            case 'init':
-                init();
+            case 'init': {
+                const name = args.join(' ') || undefined;
+                init(name);
                 break;
+            }
             case 'state': {
                 const validSessionId = validateSessionId(sessionId);
                 const [stateValue, ...rest] = args;

package/dist/output.d.ts

@@ -1,3 +1,3 @@
 import type { ZergState } from './types.js';
-export declare function formatSessionOutput(sessionId: string): string;
+export declare function formatSessionOutput(sessionId: string, name?: string): string;
 export declare function formatStatusOutput(state: ZergState): string;

package/dist/output.js

@@ -1,4 +1,7 @@
-export function formatSessionOutput(sessionId) {
+export function formatSessionOutput(sessionId, name) {
+    if (name) {
+        return `ZERG_SESSION:${sessionId}:${name}`;
+    }
     return `ZERG_SESSION:${sessionId}`;
 }
 export function formatStatusOutput(state) {

package/dist/state.d.ts

@@ -1,6 +1,9 @@
 import type { ZergState, State, TaskStatus } from './types.js';
 export declare function generateSessionId(): string;
-export declare function createSession(): string;
+export declare function createSession(name?: string): {
+    sessionId: string;
+    name?: string;
+};
 export declare function loadState(sessionId: string): ZergState;
 export declare function saveState(state: ZergState): void;
 export declare function updateState(sessionId: string, updates: Partial<ZergState>): ZergState;

package/dist/state.js

@@ -16,15 +16,16 @@ function getStatePath(sessionId) {
 export function generateSessionId() {
     return crypto.randomBytes(4).toString('hex');
 }
-export function createSession() {
+export function createSession(name) {
     ensureStateDir();
     const sessionId = generateSessionId();
     const state = {
         session: sessionId,
+        name,
         ...DEFAULT_STATE,
     };
     fs.writeFileSync(getStatePath(sessionId), JSON.stringify(state, null, 2));
-    return sessionId;
+    return { sessionId, name };
 }
 export function loadState(sessionId) {
     ensureStateDir();

package/dist/types.d.ts

@@ -6,6 +6,7 @@ export interface Task {
 }
 export interface ZergState {
     session: string;
+    name?: string;
     state: State;
     now: string;
     summary: string;

package/dist/validate.d.ts

@@ -5,6 +5,8 @@ export declare const MAX_NOW_LENGTH = 50;
 export declare const MAX_SUMMARY_LENGTH = 500;
 export declare const MAX_TASK_LENGTH = 200;
 export declare const MAX_TASKS = 20;
+export declare const MAX_NAME_LENGTH = 60;
+export declare const MAX_NAME_WORDS = 6;
 export declare class ValidationError extends Error {
     constructor(message: string);
 }
@@ -15,3 +17,4 @@ export declare function validateSummary(summary: string): string;
 export declare function validateTask(task: string): string;
 export declare function validateTaskCount(count: number): void;
 export declare function validateSessionId(sessionId: string | undefined): string;
+export declare function validateName(name: string): string;

package/dist/validate.js

@@ -4,6 +4,8 @@ export const MAX_NOW_LENGTH = 50;
 export const MAX_SUMMARY_LENGTH = 500;
 export const MAX_TASK_LENGTH = 200;
 export const MAX_TASKS = 20;
+export const MAX_NAME_LENGTH = 60;
+export const MAX_NAME_WORDS = 6;
 export class ValidationError extends Error {
     constructor(message) {
         super(message);
@@ -51,3 +53,13 @@ export function validateSessionId(sessionId) {
     }
     return sessionId;
 }
+export function validateName(name) {
+    if (name.length > MAX_NAME_LENGTH) {
+        throw new ValidationError(`Name too long (${name.length} chars). Max ${MAX_NAME_LENGTH} chars.`);
+    }
+    const wordCount = name.trim().split(/\s+/).length;
+    if (wordCount > MAX_NAME_WORDS) {
+        throw new ValidationError(`Name has too many words (${wordCount}). Max ${MAX_NAME_WORDS} words.`);
+    }
+    return name;
+}

package/package.json

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