@vibecompass/vibecompass 0.10.3 → 0.10.4

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.10.4 - 2026-06-19
+
+- Add `vibecompass --version`, `vibecompass -v`, and `vibecompass version` CLI support.
+- Make bare `vibecompass init` errors point users to `vibecompass init --guided`.
+- Clarify guided first-session prompts so lane IDs are presented as short kebab-case slugs and reserved yes/no answers explain that pressing Enter accepts the suggested slug.
+- Propagate declared project repo ids into the first lane opened by guided init.
+
 ## 0.10.3 - 2026-06-19
 
 - Let `start-session` create a missing `## Current session` summary block in adopted existing `CLAUDE.md` files instead of failing after guided init.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibecompass/vibecompass",
-  "version": "0.10.3",
+  "version": "0.10.4",
   "description": "Local-first project-memory core for VibeCompass",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -10,6 +10,7 @@ import { syncAgentInstructionFiles } from './generators/agent-files/index.js';
 import { getProjectStatus, renderStatusText, toStatusJson } from './status.js';
 import { refreshWorkflow } from './refresh-workflow.js';
 import { inspectProjectCompatibility, formatCompatibilityWarnings } from './compatibility.js';
+import { PACKAGE_VERSION } from './version.js';
 import {
   applyPullExport,
   pullExportProjectMemory,
@@ -25,6 +26,11 @@ export async function runCli(argv, io = createDefaultIo(), runtime = {}) {
     return 0;
   }
 
+  if (parsed.command === 'version') {
+    io.stdout.write(`${PACKAGE_VERSION}\n`);
+    return 0;
+  }
+
   if (parsed.command === 'init') {
     const initPlan = await resolveInitCliOptions(parsed.options, {
       cwd: runtime.cwd,
@@ -99,6 +105,7 @@ export async function runCli(argv, io = createDefaultIo(), runtime = {}) {
         toolingRootDir: initPlan.initOptions.toolingRootDir,
         sessionId: initPlan.sessionPlan.sessionId,
         workingOn: initPlan.sessionPlan.workingOn,
+        repos: initPlan.sessionPlan.repos,
         ...(runtime.cwd ? { cwd: runtime.cwd } : {}),
       });
       io.stdout.write(`Started session ${sessionResult.sessionDate}-${sessionResult.sessionNumber}\n`);
@@ -425,6 +432,10 @@ export function parseCliArgs(argv) {
     return { command: 'help' };
   }
 
+  if (command === 'version' || command === '--version' || command === '-v') {
+    return { command: 'version' };
+  }
+
   if (command !== 'init') {
     if (command === 'start-session') {
       return parseStartSessionArgs(rest);
@@ -1495,6 +1506,8 @@ function splitAssignment(value, flagName) {
 function usageText() {
   return [
     'Usage:',
+    '  vibecompass --version',
+    '  vibecompass version',
     '  vibecompass init --name <project-name> --mode <local-only|local-primary|hosted-only> --repo <id=remote> [options]',
     '  vibecompass connect-hosted [options]',
     '  vibecompass sync-target [<name>] [options]',

package/src/init.js

@@ -231,7 +231,9 @@ function normalizeInitOptions(options) {
     : cwd;
 
   if (typeof preparedOptions.name !== 'string' || preparedOptions.name.trim() === '') {
-    throw new Error('init requires a non-empty project name.');
+    throw new Error(
+      'init requires a non-empty project name. Run guided setup with `vibecompass init --guided`, or provide `--name <project-name>`.',
+    );
   }
 
   if (typeof preparedOptions.mode !== 'string' || !VALID_MODES.has(preparedOptions.mode)) {

package/src/setup.js

@@ -104,6 +104,7 @@ export async function resolveInitCliOptions(options, environment = {}) {
       ? {
           sessionId: resolved.sessionId,
           workingOn: resolved.sessionWorkingOn,
+          repos: resolved.repos.map((repo) => repo.id),
         }
       : null,
   };
@@ -608,14 +609,15 @@ async function completeGuidedInitOptions(options, environment) {
     }
 
     if (!resolved.sessionWorkingOn) {
-      resolved.sessionWorkingOn = await askInput(prompter, 'What are you working on?');
+      resolved.sessionWorkingOn = await askInput(prompter, 'Work summary for this first session');
     }
 
     if (!resolved.sessionId) {
-      resolved.sessionId = await askInput(prompter, 'Session lane id', {
-        defaultValue: suggestLaneId(resolved.sessionWorkingOn),
+      const defaultSessionId = suggestLaneId(resolved.sessionWorkingOn);
+      resolved.sessionId = await askInput(prompter, 'Session lane id, short kebab-case slug', {
+        defaultValue: defaultSessionId,
         validate(value) {
-          return validateLaneIdForPrompt(value);
+          return validateLaneIdForPrompt(value, defaultSessionId);
         },
       });
     }
@@ -1245,7 +1247,7 @@ function suggestLaneId(value) {
   return slug.length >= 3 ? slug : 'builder-session';
 }
 
-function validateLaneIdForPrompt(value) {
+function validateLaneIdForPrompt(value, defaultValue) {
   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.';
   }
@@ -1268,7 +1270,7 @@ function validateLaneIdForPrompt(value) {
     'wip',
     'yes',
   ].includes(value)) {
-    return `Lane id "${value}" is reserved.`;
+    return `Lane id "${value}" is reserved. Enter a short kebab-case lane id, or press Enter to use "${defaultValue}".`;
   }
 
   return null;