@vibecompass/vibecompass 0.1.0 → 0.2.1

package/src/setup.js

@@ -40,6 +40,10 @@ export async function resolveInitCliOptions(options, environment = {}) {
     throw new Error('init requires --session-working-on when --start-session is used without guided setup.');
   }
 
+  if (resolved.startSession && !resolved.sessionId) {
+    throw new Error('init requires --session-id when --start-session is used.');
+  }
+
   return {
     initOptions: {
       rootDir: resolved.rootDir,
@@ -62,6 +66,7 @@ export async function resolveInitCliOptions(options, environment = {}) {
     guidedSummary,
     sessionPlan: resolved.startSession
       ? {
+          sessionId: resolved.sessionId,
           workingOn: resolved.sessionWorkingOn,
         }
       : null,
@@ -278,6 +283,15 @@ async function completeGuidedInitOptions(options, environment) {
     if (!resolved.sessionWorkingOn) {
       resolved.sessionWorkingOn = await askInput(prompter, 'What are you working on?');
     }
+
+    if (!resolved.sessionId) {
+      resolved.sessionId = await askInput(prompter, 'Session lane id', {
+        defaultValue: suggestLaneId(resolved.sessionWorkingOn),
+        validate(value) {
+          return validateLaneIdForPrompt(value);
+        },
+      });
+    }
   }
 
   if (resolved.closeSessionGitPublish === undefined && (resolved.bootstrap.workflow || resolved.startSession)) {
@@ -669,6 +683,46 @@ function suggestRepoId(value) {
   return slug || 'repo';
 }
 
+function suggestLaneId(value) {
+  const slug = String(value ?? '')
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '')
+    .slice(0, 63)
+    .replace(/-+$/g, '');
+
+  return slug.length >= 3 ? slug : 'builder-session';
+}
+
+function validateLaneIdForPrompt(value) {
+  if (!/^[a-z0-9][a-z0-9-]{1,62}[a-z0-9]$/.test(value)) {
+    return 'Lane id must be 3-64 lowercase letters, numbers, or hyphens, and must start and end with a letter or number.';
+  }
+
+  if ([
+    'active',
+    'current',
+    'default',
+    'false',
+    'handoff',
+    'index',
+    'new',
+    'no',
+    'null',
+    'off',
+    'on',
+    'sessions',
+    'state',
+    'true',
+    'wip',
+    'yes',
+  ].includes(value)) {
+    return `Lane id "${value}" is reserved.`;
+  }
+
+  return null;
+}
+
 function getRepoDirectoryHints(repo) {
   const hints = new Set();
 

package/src/workflow.js

@@ -77,7 +77,7 @@ export function buildWorkflowMetadata(existingMetadata, overrides = {}) {
 export function buildCloseSessionGuidance(workflowSettings) {
   const guidance = [];
 
-  guidance.push('Reviewer handback stays in sessions/wip.md and sessions/handoff.md before close-session runs.');
+  guidance.push('Reviewer handback stays in the selected sessions/active/<lane-id>/wip.md and handoff.md before close-session runs.');
 
   if (workflowSettings.closeSession.refreshArchitectureDocs) {
     guidance.push('Refresh any relevant architecture docs before finalizing the session.');