@vibecompass/vibecompass 0.6.0 → 0.8.0

package/package.json

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

package/src/cli.js

@@ -2,7 +2,7 @@
 
 import { realpathSync } from 'node:fs';
 import { pathToFileURL } from 'node:url';
-import { connectHostedProjectMemory, initializeProjectMemory } from './init.js';
+import { connectHostedProjectMemory, initializeProjectMemory, setDefaultSyncTarget } from './init.js';
 import { preflightDocsReview } from './docs-review.js';
 import { resolveConnectHostedCliOptions, resolveInitCliOptions } from './setup.js';
 import { closeProjectSession, listProjectSessions, startProjectSession, switchProjectSession } from './session.js';
@@ -140,6 +140,10 @@ export async function runCli(argv, io = createDefaultIo(), runtime = {}) {
     });
     io.stdout.write(`Connected hosted VibeCompass for ${result.mode}\n`);
     io.stdout.write(`Updated ${result.projectFilePath}\n`);
+    if (result.syncTarget) {
+      io.stdout.write(`Sync target: ${result.syncTarget.name} (default: ${result.syncTarget.defaultTarget})\n`);
+      io.stdout.write(`Select per command with --sync-target ${result.syncTarget.name}, or switch the default with: vibecompass sync-target ${result.syncTarget.name}\n`);
+    }
     io.stdout.write(`Next step: set ${result.syncEnvVar} locally before your first hosted command.\n`);
     if (result.mode === 'local-primary') {
       io.stdout.write('Then run: vibecompass push\n');
@@ -150,6 +154,28 @@ export async function runCli(argv, io = createDefaultIo(), runtime = {}) {
     return 0;
   }
 
+  if (parsed.command === 'sync-target') {
+    const result = await setDefaultSyncTarget({
+      ...parsed.options,
+      ...(runtime.cwd ? { cwd: runtime.cwd } : {}),
+    });
+    if (parsed.options.targetName) {
+      io.stdout.write(
+        result.changed
+          ? `Default sync target set to ${result.defaultTarget}\n`
+          : `Default sync target already ${result.defaultTarget}\n`,
+      );
+      io.stdout.write(`Updated ${result.projectFilePath}\n`);
+    } else {
+      io.stdout.write(`Default sync target: ${result.defaultTarget ?? '(none)'}\n`);
+    }
+    for (const [name, target] of Object.entries(result.targets)) {
+      const marker = name === result.defaultTarget ? '*' : ' ';
+      io.stdout.write(`${marker} ${name}: ${target.api_url} (project ${target.project_id}, env ${target.credential_env_var})\n`);
+    }
+    return 0;
+  }
+
   if (parsed.command === 'status') {
     const result = await getProjectStatus({
       ...parsed.options,
@@ -260,11 +286,32 @@ export async function runCli(argv, io = createDefaultIo(), runtime = {}) {
     if (result.localReview) {
       io.stdout.write(`Local review output: ${result.localReview.output_path}\n`);
     }
+    if (result.rebuild) {
+      io.stdout.write(`Rebuild scope: ${result.rebuild.scope_path}\n`);
+      io.stdout.write(`Stale policy: ${result.rebuild.stale_policy}\n`);
+      io.stdout.write(`Architecture docs: ${result.rebuild.architecture_doc_count}\n`);
+      for (const entry of result.rebuild.architecture_docs) {
+        io.stdout.write(`- ${entry.path} (${entry.action}${entry.archive_path ? ` -> ${entry.archive_path}` : ''})\n`);
+      }
+    }
     if (result.applied) {
       io.stdout.write(`Applied architecture docs: ${result.applied.architecture_docs.length}\n`);
       for (const entry of result.applied.architecture_docs) {
         io.stdout.write(`- ${entry.path} (${entry.status})\n`);
       }
+      if (result.applied.coverage) {
+        io.stdout.write(`Applied coverage plan: ${result.applied.coverage.area_count} areas`);
+        if (typeof result.applied.coverage.coverage_score === 'number') {
+          io.stdout.write(` (${Math.round(result.applied.coverage.coverage_score * 100)}% accepted)`);
+        }
+        io.stdout.write('\n');
+      }
+      if (Array.isArray(result.applied.decision_candidates) && result.applied.decision_candidates.length > 0) {
+        io.stdout.write(`Applied decision recommendations: ${result.applied.decision_candidates.length}\n`);
+        for (const entry of result.applied.decision_candidates) {
+          io.stdout.write(`- D-${String(entry.decision_id).padStart(3, '0')}: ${entry.title} (${entry.target_path})\n`);
+        }
+      }
     }
     if (result.appliedDecisionArtifact) {
       io.stdout.write(`Applied decision artifact: ${result.appliedDecisionArtifact.artifact_id}\n`);
@@ -272,7 +319,9 @@ export async function runCli(argv, io = createDefaultIo(), runtime = {}) {
       io.stdout.write(`Target: ${result.appliedDecisionArtifact.target_path}\n`);
     }
     writeWarnings(io, result.warnings);
-    io.stdout.write(`Recorded ${result.statePath}\n`);
+    if (result.recorded !== false) {
+      io.stdout.write(`Recorded ${result.statePath}\n`);
+    }
     io.stdout.write(`${result.message}\n`);
     if (result.reviewPrompt) {
       io.stdout.write('Architecture review prompt:\n');
@@ -378,6 +427,10 @@ export function parseCliArgs(argv) {
       return parseConnectHostedArgs(rest);
     }
 
+    if (command === 'sync-target') {
+      return parseSyncTargetArgs(rest);
+    }
+
     if (command === 'status') {
       return parseStatusArgs(rest);
     }
@@ -679,6 +732,9 @@ function parseConnectHostedArgs(argv) {
       case '--root':
         parsed.rootDir = value;
         break;
+      case '--target':
+        parsed.targetName = value;
+        break;
       case '--sync-api-url':
         parsed.syncApiUrl = value;
         break;
@@ -703,6 +759,7 @@ function parseConnectHostedArgs(argv) {
     command: 'connect-hosted',
     options: {
       rootDir: parsed.rootDir,
+      ...(parsed.targetName ? { targetName: parsed.targetName } : {}),
       ...(syncValues.length > 0
         ? {
             sync: {
@@ -1042,6 +1099,21 @@ function parseDocsReviewArgs(argv) {
       continue;
     }
 
+    if (token === '--rebuild') {
+      parsed.rebuild = true;
+      continue;
+    }
+
+    if (token === '--dry-run') {
+      parsed.dryRun = true;
+      continue;
+    }
+
+    if (token === '--apply') {
+      parsed.apply = true;
+      continue;
+    }
+
     if (token === '--apply-decision-artifact') {
       parsed.applyDecisionArtifact = true;
       continue;
@@ -1081,9 +1153,18 @@ function parseDocsReviewArgs(argv) {
       case '--output':
         parsed.outputPath = value;
         break;
+      case '--path':
+        parsed.scopePath = value;
+        break;
+      case '--stale-policy':
+        parsed.stalePolicy = value;
+        break;
       case '--artifact':
         parsed.artifactId = value;
         break;
+      case '--sync-target':
+        parsed.syncTarget = value;
+        break;
       case '--max-tokens':
         parsed.maxTokens = value;
         break;
@@ -1101,7 +1182,72 @@ function parseDocsReviewArgs(argv) {
 function parsePushArgs(argv) {
   return {
     command: 'push',
-    options: parseRootOnlyArgs(argv, 'push'),
+    options: parseRootAndSyncTargetArgs(argv, 'push'),
+  };
+}
+
+function parseRootAndSyncTargetArgs(argv, commandName) {
+  const parsed = {};
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index];
+    if (!token.startsWith('--')) {
+      throw new Error(`Unexpected argument "${token}".`);
+    }
+
+    const value = argv[index + 1];
+    if (value === undefined) {
+      throw new Error(`Flag "${token}" requires a value.`);
+    }
+    index += 1;
+
+    switch (token) {
+      case '--root':
+        parsed.rootDir = value;
+        break;
+      case '--sync-target':
+        parsed.syncTarget = value;
+        break;
+      default:
+        throw new Error(`Unknown flag "${token}" for ${commandName}.`);
+    }
+  }
+
+  return parsed;
+}
+
+function parseSyncTargetArgs(argv) {
+  const parsed = {};
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index];
+
+    if (!token.startsWith('--')) {
+      if (parsed.targetName !== undefined) {
+        throw new Error(`Unexpected argument "${token}".`);
+      }
+      parsed.targetName = token;
+      continue;
+    }
+
+    const value = argv[index + 1];
+    if (value === undefined) {
+      throw new Error(`Flag "${token}" requires a value.`);
+    }
+    index += 1;
+
+    switch (token) {
+      case '--root':
+        parsed.rootDir = value;
+        break;
+      default:
+        throw new Error(`Unknown flag "${token}" for sync-target.`);
+    }
+  }
+
+  return {
+    command: 'sync-target',
+    options: parsed,
   };
 }
 
@@ -1129,6 +1275,9 @@ function parsePullPreviewArgs(argv) {
       case '--root':
         parsed.rootDir = value;
         break;
+      case '--sync-target':
+        parsed.syncTarget = value;
+        break;
       default:
         throw new Error(`Unknown flag "${token}".`);
     }
@@ -1162,6 +1311,9 @@ function parsePullExportArgs(argv) {
       case '--root':
         parsed.rootDir = value;
         break;
+      case '--sync-target':
+        parsed.syncTarget = value;
+        break;
       case '--preview-token':
         parsed.previewToken = value;
         break;
@@ -1320,6 +1472,7 @@ function usageText() {
     'Usage:',
     '  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]',
     '  vibecompass status [options]',
     '  vibecompass refresh-workflow [--dry-run|--apply] [options]',
     '  vibecompass start-session --id <lane-id> --working-on <text> [options]',
@@ -1361,10 +1514,17 @@ function usageText() {
     '',
     'Connect-hosted options:',
     '  --root <path>                        Project-memory root. Defaults to .compass',
+    '  --target <name>                      Add or update a named sync target (e.g. dev, prod)',
+    '                                        First named target becomes the default; flat sync fields mirror the default target',
     '  --sync-api-url <url>                 Hosted sync api_url',
     '  --sync-project-id <id>               Hosted sync project_id',
     '  --sync-credential-env-var <name>     Hosted sync env var reference',
-    '                                        Replaces any existing project.yaml sync binding',
+    '                                        Without --target, replaces any existing flat project.yaml sync binding',
+    '',
+    'Sync-target options:',
+    '  vibecompass sync-target              List named sync targets and the current default',
+    '  vibecompass sync-target <name>       Switch the default sync target (re-mirrors flat sync fields)',
+    '  --root <path>                        Project-memory root. Defaults to .compass',
     '',
     'Status options:',
     '  --root <path>                        Project-memory root. Defaults to .compass',
@@ -1419,6 +1579,7 @@ function usageText() {
     '',
     'Sync transport options:',
     '  push --root <path>                   Push canonical local project memory to hosted',
+    '  --sync-target <name>                 Use a named sync target for this command (push, pull-preview, pull-export, docs-review)',
     '  pull-preview --root <path>           Preview hosted proposals and remote state',
     '  pull-preview --no-pending-proposals  Exclude pending proposals from preview',
     '  pull-export --proposal <id>          Export a selected proposal; repeatable',
@@ -1437,6 +1598,11 @@ function usageText() {
     '  --run-local-anthropic                Compatibility alias for --run-local --provider anthropic',
     '  --apply-output                       Apply accepted architecture doc blocks from review output',
     '  --output <path>                      Review output path for --apply-output; defaults to state/docs-review-output.md',
+    '  --rebuild                            Preview or prepare an explicit architecture-doc rebuild',
+    '  --dry-run                            Preview docs-review rebuild changes; default with --rebuild',
+    '  --apply                              Apply docs-review rebuild preparation; only valid with --rebuild',
+    '  --path <architecture/path>           Scope --rebuild to an architecture directory',
+    '  --stale-policy <keep|archive>        Rebuild stale-doc handling; defaults to keep',
     '  --apply-decision-artifact            Append an accepted hosted decision artifact locally',
     '  --artifact <id>                      Artifact ID for --apply-decision-artifact',
     '  --refresh-index                      Also regenerate decisions/INDEX.md after applying a decision artifact',