@vibecompass/vibecompass 0.7.0 → 0.9.0

package/src/init.js

@@ -6,6 +6,13 @@ import { scaffoldInitFiles } from './scaffold.js';
 import { applyPlacementDefaults } from './setup.js';
 import { buildWorkflowMetadata } from './workflow.js';
 import { parseSimpleYaml } from './simple-yaml.js';
+import {
+  assertValidSyncTargetName,
+  buildSyncSectionWithTargets,
+  mirrorTargetCursorToFlat,
+  readSyncTargets,
+  reconcileCursorsAfterConnect,
+} from './sync-binding.js';
 import { PACKAGE_VERSION } from './version.js';
 
 const VALID_MODES = new Set(['local-only', 'local-primary', 'hosted-only']);
@@ -68,15 +75,146 @@ export async function connectHostedProjectMemory(options) {
     throw new Error('connect-hosted requires project.yaml mode to be local-primary or hosted-only.');
   }
 
+  const targetName = typeof options?.targetName === 'string' && options.targetName.trim() !== ''
+    ? assertValidSyncTargetName(options.targetName.trim())
+    : null;
+  const existingTargets = readSyncTargets(projectConfig);
+
+  if (!targetName && existingTargets) {
+    throw new Error(
+      `This project uses named sync targets (${Object.keys(existingTargets.targets).join(', ')}). Pass --target <name> to add or update one, or use "vibecompass sync-target <name>" to switch the default.`,
+    );
+  }
+
+  const previousFlatSync = projectConfig.sync && typeof projectConfig.sync === 'object'
+    ? projectConfig.sync
+    : null;
   const sync = normalizeSyncOptions(options?.sync, projectConfig.mode);
-  projectConfig.sync = sync;
+
+  let syncTarget = null;
+  if (targetName) {
+    const targets = { ...(existingTargets?.targets ?? {}) };
+    targets[targetName] = {
+      api_url: sync.api_url,
+      project_id: sync.project_id,
+      credential_env_var: sync.credential_env_var,
+    };
+    const defaultTarget = existingTargets?.defaultTarget ?? targetName;
+    projectConfig.sync = buildSyncSectionWithTargets(targets, defaultTarget);
+    syncTarget = { name: targetName, defaultTarget };
+  } else {
+    projectConfig.sync = sync;
+  }
+
   await writeFile(projectFilePath, serializeProjectConfig(projectConfig), 'utf8');
 
+  // D-237: reconcile manifest cursor state with the (re)bound target —
+  // first-conversion cursor migration, dropping a rebound target's stale
+  // cursor, and re-mirroring/clearing the flat cursor when the default
+  // target's binding changed (so ≤0.7.0 CLIs can't pair the new flat binding
+  // with a previous environment's cursor).
+  if (targetName) {
+    await updateManifestSyncState(rootDir, (manifestSync) =>
+      reconcileCursorsAfterConnect(
+        manifestSync,
+        targetName,
+        { apiUrl: sync.api_url, projectId: sync.project_id },
+        {
+          isDefault: syncTarget.defaultTarget === targetName,
+          isFirstConversion: !existingTargets,
+          flatBindingMatches: Boolean(
+            previousFlatSync &&
+              previousFlatSync.api_url === sync.api_url &&
+              previousFlatSync.project_id === sync.project_id,
+          ),
+        },
+      ),
+    );
+  }
+
   return {
     rootDir,
     projectFilePath,
     mode: projectConfig.mode,
     syncEnvVar: sync.credential_env_var,
+    syncTarget,
+  };
+}
+
+async function updateManifestSyncState(rootDir, updater) {
+  let manifest;
+  try {
+    manifest = JSON.parse(
+      await readFile(path.join(rootDir, 'state', 'manifest.json'), 'utf8'),
+    );
+  } catch {
+    return; // no manifest yet — nothing to migrate
+  }
+
+  const nextSync = updater(
+    manifest?.sync && typeof manifest.sync === 'object' ? manifest.sync : {},
+  );
+  if (!nextSync) {
+    return;
+  }
+
+  await writeStateManifest(rootDir, { sync: nextSync });
+}
+
+export async function setDefaultSyncTarget(options) {
+  const cwd = options?.cwd ? path.resolve(options.cwd) : process.cwd();
+  const rootDir = path.resolve(cwd, options?.rootDir ?? '.compass');
+  const projectFilePath = path.join(rootDir, 'project.yaml');
+  const projectConfig = parseSimpleYaml(await readFile(projectFilePath, 'utf8'), {
+    sourceName: projectFilePath,
+  });
+
+  const named = readSyncTargets(projectConfig);
+  if (!named) {
+    throw new Error(
+      'No named sync targets are defined in project.yaml. Run "vibecompass connect-hosted --target <name>" to add one.',
+    );
+  }
+
+  const targetName = typeof options?.targetName === 'string' && options.targetName.trim() !== ''
+    ? options.targetName.trim()
+    : null;
+
+  if (!targetName) {
+    return {
+      rootDir,
+      projectFilePath,
+      changed: false,
+      defaultTarget: named.defaultTarget,
+      targets: named.targets,
+    };
+  }
+
+  if (!named.targets[targetName]) {
+    throw new Error(
+      `Unknown sync target "${targetName}". Available targets: ${Object.keys(named.targets).join(', ')}.`,
+    );
+  }
+
+  projectConfig.sync = buildSyncSectionWithTargets(named.targets, targetName);
+  await writeFile(projectFilePath, serializeProjectConfig(projectConfig), 'utf8');
+
+  // D-237: the flat manifest cursor mirrors the default target so ≤0.7.0 CLIs
+  // stay correct; re-mirror it from the new default (clearing it when the new
+  // default has no identity-matching cursor yet).
+  await updateManifestSyncState(rootDir, (manifestSync) =>
+    mirrorTargetCursorToFlat(manifestSync, targetName, {
+      apiUrl: named.targets[targetName].api_url,
+      projectId: named.targets[targetName].project_id,
+    }),
+  );
+
+  return {
+    rootDir,
+    projectFilePath,
+    changed: named.defaultTarget !== targetName,
+    defaultTarget: targetName,
+    targets: named.targets,
   };
 }
 
@@ -119,13 +257,42 @@ function normalizeInitOptions(options) {
     }
     seenRepoIds.add(repo.id);
 
-    if (typeof repo.remote !== 'string' || repo.remote.trim() === '') {
-      throw new Error(`repo "${repo.id}" requires a non-empty remote.`);
+    const source = typeof repo.source === 'string' && repo.source.trim() !== ''
+      ? repo.source.trim()
+      : null;
+    const pathValue = typeof repo.path === 'string' && repo.path.trim() !== ''
+      ? repo.path.trim()
+      : null;
+    const remote = typeof repo.remote === 'string' ? repo.remote.trim() : '';
+
+    if (source && !['git', 'local'].includes(source)) {
+      throw new Error(`repo "${repo.id}" source must be git or local.`);
+    }
+
+    if (source === 'local' || (!source && !remote && pathValue)) {
+      if (!['local-only', 'local-primary'].includes(preparedOptions.mode)) {
+        throw new Error(`repo "${repo.id}" local sources are supported only in local-only or local-primary mode.`);
+      }
+
+      if (!pathValue) {
+        throw new Error(`repo "${repo.id}" source local requires a non-empty path.`);
+      }
+
+      return {
+        id: repo.id,
+        source: 'local',
+        path: pathValue,
+      };
+    }
+
+    if (!remote) {
+      throw new Error(`repo "${repo.id}" requires a non-empty remote, or use a local repo source with source: local and path.`);
     }
 
     return {
       id: repo.id,
-      remote: repo.remote,
+      ...(source === 'git' ? { source: 'git' } : {}),
+      remote,
       ...(repo.defaultBranch ? { default_branch: repo.defaultBranch } : {}),
     };
   });

package/src/project-memory.js

@@ -34,7 +34,7 @@ const KNOWN_PROJECT_FIELDS = new Set([
   'sync',
   'metadata',
 ]);
-const KNOWN_REPO_FIELDS = new Set(['id', 'remote', 'default_branch']);
+const KNOWN_REPO_FIELDS = new Set(['id', 'source', 'remote', 'path', 'default_branch']);
 const KNOWN_SYNC_FIELDS = new Set([
   'provider',
   'api_url',
@@ -278,8 +278,25 @@ function validateProjectData(data, relativePath) {
         repoIds.push(repo.id);
       }
 
-      if (typeof repo.remote !== 'string' || repo.remote.trim() === '') {
-        errors.push(createError(relativePath, 'project-invalid-repo-remote', `${prefix}.remote must be a non-empty string.`));
+      const source = typeof repo.source === 'string' && repo.source.trim() !== ''
+        ? repo.source.trim()
+        : null;
+      const remote = typeof repo.remote === 'string' ? repo.remote.trim() : '';
+      const sourcePath = typeof repo.path === 'string' ? repo.path.trim() : '';
+
+      if (source && !['git', 'local'].includes(source)) {
+        errors.push(createError(relativePath, 'project-invalid-repo-source', `${prefix}.source must be git or local.`));
+      }
+
+      if (source === 'local' || (!source && !remote && sourcePath)) {
+        if (!['local-only', 'local-primary'].includes(data.mode)) {
+          errors.push(createError(relativePath, 'project-invalid-repo-source', `${prefix}.source local is supported only when mode is local-only or local-primary.`));
+        }
+        if (!sourcePath) {
+          errors.push(createError(relativePath, 'project-invalid-repo-path', `${prefix}.path must be a non-empty string for local sources.`));
+        }
+      } else if (!remote) {
+        errors.push(createError(relativePath, 'project-invalid-repo-remote', `${prefix}.remote must be a non-empty string for Git-backed sources.`));
       }
     }
   }
@@ -336,10 +353,12 @@ function validateProjectData(data, relativePath) {
       repo_ids: repoIds,
       repos: Array.isArray(data.repos)
         ? data.repos
-            .filter((repo) => isPlainObject(repo) && typeof repo.id === 'string' && typeof repo.remote === 'string')
+            .filter((repo) => isPlainObject(repo) && typeof repo.id === 'string')
             .map((repo) => ({
               id: repo.id,
-              remote: repo.remote,
+              source: typeof repo.source === 'string' ? repo.source : (typeof repo.remote === 'string' ? 'git' : 'local'),
+              remote: typeof repo.remote === 'string' ? repo.remote : null,
+              path: typeof repo.path === 'string' ? repo.path : null,
               default_branch: typeof repo.default_branch === 'string' ? repo.default_branch : null,
             }))
         : [],

package/src/read-model.js

@@ -105,7 +105,9 @@ function buildProjectSummary(scanResult, currentManifest, freshness, existingMan
   const extracted = scanResult.project.extracted ?? {};
   const repos = (extracted.repos ?? []).map((repo) => ({
     id: repo.id,
+    source: repo.source,
     remote: repo.remote,
+    path: repo.path,
     default_branch: repo.default_branch,
   }));
 
@@ -451,10 +453,12 @@ function buildRepoAliasMap(repos) {
     aliases.set(repo.id, repo.id);
     aliases.set(repo.id.toLowerCase(), repo.id);
 
-    const remoteName = repo.remote
-      .replace(/\.git$/, '')
-      .split('/')
-      .pop();
+    const remoteName = typeof repo.remote === 'string'
+      ? repo.remote
+          .replace(/\.git$/, '')
+          .split('/')
+          .pop()
+      : null;
 
     if (remoteName) {
       aliases.set(remoteName, repo.id);

package/src/scaffold.js

@@ -206,7 +206,7 @@ function generateContextMarkdown(options) {
   const workflow = resolveWorkflowSettings(options.projectConfig);
   const promptCommands = renderPromptCommandLines({ rootRelativePath }).join('\n');
   const repos = options.projectConfig.repos
-    .map((repo) => `- \`${repo.id}\` → ${repo.remote}`)
+    .map((repo) => `- \`${repo.id}\` → ${formatRepoDescriptor(repo)}`)
     .join('\n');
 
   return `# Project Context — ${projectName}
@@ -348,7 +348,7 @@ automatically by package commands.
 function generateStarterArchitectureDoc(projectConfig) {
   const repos = projectConfig.repos.map((repo) => repo.id);
   const repoLines = projectConfig.repos
-    .map((repo) => `- \`${repo.id}\` — ${repo.remote}${repo.default_branch ? ` (${repo.default_branch})` : ''}`)
+    .map((repo) => `- \`${repo.id}\` — ${formatRepoDescriptor(repo)}${repo.default_branch ? ` (${repo.default_branch})` : ''}`)
     .join('\n');
   const repoEvidence = projectConfig.repos
     .map((repo) => `- \`${repo.id}:/\` — declared repository root`)
@@ -379,7 +379,7 @@ ${repoLines}
 ## Coverage
 Confirmed:
 - Project identity and mode from \`project.yaml\`
-- Declared repository IDs and remotes from \`project.yaml\`
+- Declared repository IDs and source descriptors from \`project.yaml\`
 - Project-memory root layout created by \`vibecompass init\`
 
 Not yet documented:
@@ -425,7 +425,7 @@ Do not copy this example as-is. Allocate real decision IDs from the current cano
 function generateStarterSessionNote(options) {
   const sessionDate = sessionDateFromGeneratedAt(options.generatedAt);
   const projectConfig = options.projectConfig;
-  const repoLines = projectConfig.repos.map((repo) => `- \`${repo.id}\` — ${repo.remote}`).join('\n');
+  const repoLines = projectConfig.repos.map((repo) => `- \`${repo.id}\` — ${formatRepoDescriptor(repo)}`).join('\n');
 
   return `# Session — ${sessionDate}-1 — Project Memory Initialized
 
@@ -458,6 +458,14 @@ ${repoLines}
 `;
 }
 
+function formatRepoDescriptor(repo) {
+  if (repo.source === 'local') {
+    return `local folder ${repo.path}`;
+  }
+
+  return repo.remote;
+}
+
 function generateArchitectureGuide(projectConfig) {
   return `# Architecture
 

package/src/setup.js

@@ -139,6 +139,7 @@ export async function resolveConnectHostedCliOptions(options, environment = {})
 
   return {
     rootDir: resolved.rootDir ? toRelativeIfInsideCwd(resolved.rootDir, cwd) : undefined,
+    ...(resolved.targetName ? { targetName: resolved.targetName } : {}),
     sync: resolved.sync,
   };
 }
@@ -881,12 +882,13 @@ async function promptForRepos(prompter, cwd) {
 
   for (let index = 0; index < repoCount; index += 1) {
     const ordinal = index + 1;
-    const repo = {
-      id: await askInput(prompter, `Repo ${ordinal} id`, {
-        defaultValue: repoCount === 1 ? repoIdDefault : `repo-${ordinal}`,
-      }),
-      remote: await askInput(prompter, `Repo ${ordinal} remote`),
-    };
+    const repoId = await askInput(prompter, `Repo ${ordinal} id`, {
+      defaultValue: repoCount === 1 ? repoIdDefault : `repo-${ordinal}`,
+    });
+    const remote = await askOptionalInput(prompter, `Repo ${ordinal} remote (blank for local folder)`);
+    const repo = remote
+      ? { id: repoId, remote }
+      : { id: repoId, source: 'local', path: '.' };
 
     const defaultBranch = await askOptionalInput(prompter, `Repo ${ordinal} default branch`);
     if (defaultBranch) {

package/src/status.js

@@ -143,7 +143,9 @@ async function readProjectSummary(projectFilePath) {
             .filter((repo) => repo && typeof repo === 'object')
             .map((repo) => ({
               id: typeof repo.id === 'string' ? repo.id : null,
+              source: typeof repo.source === 'string' ? repo.source : (typeof repo.remote === 'string' ? 'git' : 'local'),
               remote: typeof repo.remote === 'string' ? repo.remote : null,
+              path: typeof repo.path === 'string' ? repo.path : null,
               defaultBranch: typeof repo.default_branch === 'string' ? repo.default_branch : null,
             }))
             .filter((repo) => repo.id)
@@ -155,6 +157,20 @@ async function readProjectSummary(projectFilePath) {
             projectId: typeof config.sync.project_id === 'string' ? config.sync.project_id : null,
             credentialSource: typeof config.sync.credential_source === 'string' ? config.sync.credential_source : null,
             credentialEnvVar: typeof config.sync.credential_env_var === 'string' ? config.sync.credential_env_var : null,
+            defaultTarget:
+              typeof config.sync.default_target === 'string' ? config.sync.default_target : null,
+            targets:
+              config.sync.targets && typeof config.sync.targets === 'object'
+                ? Object.entries(config.sync.targets)
+                    .filter(([, target]) => target && typeof target === 'object')
+                    .map(([name, target]) => ({
+                      name,
+                      apiUrl: typeof target.api_url === 'string' ? target.api_url : null,
+                      projectId: typeof target.project_id === 'string' ? target.project_id : null,
+                      credentialEnvVar:
+                        typeof target.credential_env_var === 'string' ? target.credential_env_var : null,
+                    }))
+                : [],
           }
         : null,
     };