@vibecompass/vibecompass 0.10.2 → 0.10.4

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # 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.
+- Use the local calendar date, not UTC, when naming the starter `project-memory-initialized` session note during init.
+
 ## 0.10.2 - 2026-06-19
 
 - Add a package-owned docs-review source inventory scanner that writes `state/docs-review-source-inventory.json`, includes scanned subsystem inventory in the review prompt, and records `scanned_unaccounted` / `source_unavailable` reconciliation warnings without changing the primary coverage score basis.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibecompass/vibecompass",
-  "version": "0.10.2",
+  "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/scaffold.js

@@ -627,10 +627,18 @@ function describeReviewerHandback(workflow) {
 function sessionDateFromGeneratedAt(value) {
   const date = value ? new Date(value) : new Date();
   if (Number.isNaN(date.getTime())) {
-    return new Date().toISOString().slice(0, 10);
+    return formatLocalDate(new Date());
   }
 
-  return date.toISOString().slice(0, 10);
+  return formatLocalDate(date);
+}
+
+function formatLocalDate(date) {
+  return [
+    date.getFullYear(),
+    String(date.getMonth() + 1).padStart(2, '0'),
+    String(date.getDate()).padStart(2, '0'),
+  ].join('-');
 }
 
 function quoteYamlString(value) {

package/src/session.js

@@ -4,6 +4,7 @@ import { scanProjectMemory } from './project-memory.js';
 import { parseSimpleYaml } from './simple-yaml.js';
 import { buildCloseSessionGuidance, resolveWorkflowSettings } from './workflow.js';
 import { syncAgentInstructionFiles } from './generators/agent-files/index.js';
+import { START_MARKER } from './generators/agent-files/markers.js';
 
 const CURRENT_SESSION_REQUIRED_FIELDS = ['Date:', 'Working on:', 'Last thing completed:', 'Blockers:', 'Next session should:'];
 const WIP_HEADER_PATTERN = /^# WIP — (\d{4}-\d{2}-\d{2}) \(session (\d+)\)$/m;
@@ -51,13 +52,13 @@ export async function startProjectSession(options) {
   const highestDecisionId = await readHighestDecisionId(normalized.rootDir);
 
   const nextSessionNumber = await getNextSessionNumber(normalized.sessionsDir, sessionDate);
-  const currentSession = parseCurrentSessionBlock(claude.content);
+  const currentSession = parseCurrentSessionBlock(claude.content, { optional: true });
   const updatedClaude = replaceCurrentSessionBlock(claude.content, {
     date: `${sessionDate} (session ${nextSessionNumber}, lane ${sessionId})`,
     workingOn: `${workingOn} [${sessionId}]`,
     lastThingCompleted:
       normalizeOptionalString(options?.lastThingCompleted) ??
-      currentSession.lastThingCompleted ??
+      currentSession?.lastThingCompleted ??
       'Project memory bootstrap completed.',
     blockers: normalizeOptionalString(options?.blockers) ?? 'No blocker yet.',
     nextSessionShould:
@@ -170,11 +171,11 @@ export async function closeProjectSession(options) {
 
   const wipContent = await readFile(lanePaths.wipFilePath, 'utf8');
   const activeSession = parseActiveSession(wipContent, lanePaths.wipFilePath);
-  const currentSession = parseCurrentSessionBlock(claude.content);
+  const currentSession = parseCurrentSessionBlock(claude.content, { optional: true });
   const workedOn =
     normalizeOptionalString(options?.workedOn) ??
     extractSectionBody(wipContent, 'Working on') ??
-    currentSession.workingOn;
+    currentSession?.workingOn;
 
   if (!workedOn) {
     throw new Error('session close could not determine what the session worked on. Pass workedOn explicitly.');
@@ -414,7 +415,7 @@ async function readWorkflowSettings(projectFilePath) {
 async function readClaudeFile(claudePath) {
   if (!(await fileExists(claudePath))) {
     throw new Error(
-      `No CLAUDE.md was found at ${claudePath}. Re-run "vibecompass init --with-claude" or create a compatible Current session block first.`,
+      `No CLAUDE.md was found at ${claudePath}. Re-run "vibecompass init --with-claude" or create the file before using session commands.`,
     );
   }
 
@@ -424,9 +425,13 @@ async function readClaudeFile(claudePath) {
   };
 }
 
-function parseCurrentSessionBlock(content) {
+function parseCurrentSessionBlock(content, options = {}) {
   const sessionFence = findCurrentSessionFence(content);
   if (!sessionFence) {
+    if (options.optional) {
+      return null;
+    }
+
     throw new Error('CLAUDE.md is missing a recognizable "## Current session" fenced block.');
   }
 
@@ -453,19 +458,46 @@ function parseCurrentSessionBlock(content) {
 
 function replaceCurrentSessionBlock(content, fields) {
   const sessionFence = findCurrentSessionFence(content);
+  const blockBody = renderCurrentSessionBlockBody(fields);
+
   if (!sessionFence) {
-    throw new Error('CLAUDE.md is missing a recognizable "## Current session" fenced block.');
+    return insertCurrentSessionBlock(content, blockBody);
   }
 
-  const blockBody = [
+  return `${content.slice(0, sessionFence.bodyStart)}${blockBody}${content.slice(sessionFence.bodyEnd)}`;
+}
+
+function renderCurrentSessionBlockBody(fields) {
+  return [
     `Date: ${fields.date}`,
     `Working on: ${fields.workingOn}`,
     `Last thing completed: ${fields.lastThingCompleted}`,
     `Blockers: ${fields.blockers}`,
     `Next session should: ${fields.nextSessionShould}`,
   ].join('\n');
+}
 
-  return `${content.slice(0, sessionFence.bodyStart)}${blockBody}${content.slice(sessionFence.bodyEnd)}`;
+function insertCurrentSessionBlock(content, blockBody) {
+  const currentSessionBlock = [
+    '## Current session',
+    '',
+    '**Update this block at the start and end of every session.**',
+    '',
+    '```',
+    blockBody,
+    '```',
+    '',
+  ].join('\n');
+  const markerIndex = content.indexOf(START_MARKER);
+  const normalizedContent = content.endsWith('\n') ? content : `${content}\n`;
+
+  if (markerIndex >= 0) {
+    const beforeMarker = content.slice(0, markerIndex).trimEnd();
+    const fromMarker = content.slice(markerIndex);
+    return `${beforeMarker}\n\n${currentSessionBlock}${fromMarker}`;
+  }
+
+  return `${normalizedContent}\n${currentSessionBlock}`;
 }
 
 function buildCurrentSessionFieldsForLane(lane, overrides = {}) {

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;