orbital-command 0.3.0 → 1.0.0

package/dist/server/server/init.js

@@ -1,17 +1,13 @@
 /**
- * Shared init logic — used by both the CLI (`orbital init`) and
- * programmatic callers (e.g. tests).
+ * Shared init logic — used by the wizard and
+ * programmatic callers (e.g. tests, API routes).
  */
 import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
-import { GLOBAL_PRIMITIVES_DIR, ensureOrbitalHome, unregisterProject } from './global-config.js';
-import { loadManifest, saveManifest, createManifest, hashFile, buildTemplateInventory, templateFileRecord, userFileRecord, isSelfHosting, getSymlinkTarget, createBackup, refreshFileStatuses, reverseRemapPath, safeBackupFile, safeCopyTemplate, } from './manifest.js';
-import { needsLegacyMigration, migrateFromLegacy } from './migrate-legacy.js';
-import { computeUpdatePlan, loadRenameMap, formatPlan, getFilesToBackup } from './update-planner.js';
-import { syncSettingsHooks, removeAllOrbitalHooks, getTemplateChecksum } from './settings-sync.js';
-import { migrateConfig } from './config-migrator.js';
-import { validate, formatValidationReport } from './validator.js';
+import { GLOBAL_PRIMITIVES_DIR, ensureOrbitalHome } from './global-config.js';
+import { saveManifest, createManifest, hashFile, buildTemplateInventory, templateFileRecord, userFileRecord, isSelfHosting, getSymlinkTarget, } from './manifest.js';
+import { getTemplateChecksum } from './settings-sync.js';
 import { getPackageVersion as _getPackageVersionUtil } from './utils/package-info.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -190,7 +186,8 @@ function generateManifest(config) {
     lines.push(`WORKFLOW_TERMINAL_STATUSES="${terminalStatuses.join(' ')}"`);
     lines.push('');
     lines.push('# ─── Entry point status ───');
-    lines.push(`WORKFLOW_ENTRY_STATUS="${config.entryPoint || lists[0]?.id || 'todo'}"`);
+    const entryPointId = lists.find((l) => l.isEntryPoint)?.id || lists[0]?.id || 'todo';
+    lines.push(`WORKFLOW_ENTRY_STATUS="${entryPointId}"`);
     lines.push('');
     const listMap = new Map(lists.map((l) => [l.id, l]));
     lines.push('# ─── Transition edges (from:to:sessionKey) ───');
@@ -213,6 +210,25 @@ function generateManifest(config) {
     }
     lines.push(')');
     lines.push('');
+    lines.push('# ─── Commit session branch patterns (regex) ───');
+    lines.push(`WORKFLOW_COMMIT_BRANCHES="${config.commitBranchPatterns ?? ''}"`);
+    lines.push('');
+    lines.push('# ─── Backward-compat direction aliases (alias:from:to:sessionKey) ───');
+    lines.push('WORKFLOW_DIRECTION_ALIASES=(');
+    for (const edge of config.edges || []) {
+        if (edge.direction !== 'forward' || !edge.dispatchOnly)
+            continue;
+        const targetList = listMap.get(edge.to);
+        if (!targetList)
+            continue;
+        const group = targetList.group;
+        if (group?.startsWith('deploy')) {
+            const sessionKey = targetList.sessionKey ?? '';
+            lines.push(`  "to-${edge.to}:${edge.from}:${edge.to}:${sessionKey}"`);
+        }
+    }
+    lines.push(')');
+    lines.push('');
     lines.push('# ─── Helper functions ──────────────────────────────');
     lines.push('');
     lines.push('status_to_dir() {');
@@ -534,10 +550,13 @@ export function seedGlobalPrimitives() {
         }
     }
 }
-export { TEMPLATES_DIR, ensureDir };
+export { TEMPLATES_DIR, ensureDir, cleanEmptyDirs, chmodScripts, listTemplateFiles, writeManifest, generateIndexMd, getPackageVersion };
 // Re-export manifest utilities for CLI access via loadSharedModule()
 export { loadManifest, saveManifest, hashFile, buildTemplateInventory, refreshFileStatuses, summarizeManifest } from './manifest.js';
 export { validate, formatValidationReport } from './validator.js';
+// Re-export update and uninstall from their new homes (backward compat for loadSharedModule)
+export { runUpdate } from './update.js';
+export { runUninstall } from './uninstall.js';
 export function runInit(projectRoot, options = {}) {
     const force = options.force ?? false;
     const quiet = options.quiet ?? false;
@@ -806,391 +825,5 @@ export function runInit(projectRoot, options = {}) {
     const totalSkipped = hooksResult.skipped.length + skillsResult.skipped.length + agentsResult.skipped.length;
     log(`\nDone. ${totalCreated} files installed, ${totalSkipped} skipped (use --force to overwrite).`);
 }
-export function runUpdate(projectRoot, options = {}) {
-    const { dryRun = false } = options;
-    const claudeDir = path.join(projectRoot, '.claude');
-    const newVersion = getPackageVersion();
-    console.log(`\nOrbital Command — update${dryRun ? ' (dry run)' : ''}`);
-    console.log(`Project root: ${projectRoot}\n`);
-    // 1. Load or create manifest (auto-migrate legacy installs)
-    let manifest = loadManifest(projectRoot);
-    if (!manifest) {
-        if (needsLegacyMigration(projectRoot)) {
-            console.log('  Migrating from legacy install...');
-            const result = migrateFromLegacy(projectRoot, TEMPLATES_DIR, newVersion);
-            console.log(`  Migrated ${result.synced} synced, ${result.modified} modified, ${result.userOwned} user-owned files`);
-            if (result.importedPins > 0)
-                console.log(`  Imported ${result.importedPins} pinned files from orbital-sync.json`);
-            manifest = loadManifest(projectRoot);
-        }
-        if (!manifest) {
-            console.log('  No manifest found. Run `orbital init` first.');
-            return;
-        }
-    }
-    const oldVersion = manifest.packageVersion;
-    // 1b. Refresh file statuses so outdated vs modified is accurate
-    refreshFileStatuses(manifest, claudeDir);
-    // 2. Compute update plan
-    const renameMap = loadRenameMap(TEMPLATES_DIR, oldVersion, newVersion);
-    const plan = computeUpdatePlan({
-        templatesDir: TEMPLATES_DIR,
-        claudeDir,
-        manifest,
-        newVersion,
-        renameMap,
-    });
-    // 3. Dry-run mode — print plan and exit
-    if (dryRun) {
-        console.log(formatPlan(plan, oldVersion, newVersion));
-        return;
-    }
-    if (plan.isEmpty && oldVersion === newVersion) {
-        console.log('  Everything up to date. No changes needed.');
-    }
-    // 4. Create backup of files that will be modified
-    const filesToBackup = getFilesToBackup(plan);
-    if (filesToBackup.length > 0) {
-        const backupDir = createBackup(claudeDir, filesToBackup);
-        if (backupDir) {
-            console.log(`  Backup   ${filesToBackup.length} files → ${path.relative(claudeDir, backupDir)}/`);
-        }
-    }
-    // 5. Execute plan
-    const templateInventory = buildTemplateInventory(TEMPLATES_DIR);
-    // 5a. Handle renames
-    for (const { from, to } of plan.toRename) {
-        const fromPath = path.join(claudeDir, from);
-        const toPath = path.join(claudeDir, to);
-        const toDir = path.dirname(toPath);
-        if (!fs.existsSync(toDir))
-            fs.mkdirSync(toDir, { recursive: true });
-        if (fs.existsSync(fromPath)) {
-            safeBackupFile(fromPath);
-            const stat = fs.lstatSync(fromPath);
-            if (stat.isSymbolicLink()) {
-                // Recreate symlink at new path pointing to remapped template
-                const target = fs.readlinkSync(fromPath);
-                fs.unlinkSync(fromPath);
-                fs.symlinkSync(target, toPath);
-            }
-            else {
-                fs.renameSync(fromPath, toPath);
-            }
-        }
-        // Transfer manifest record
-        const record = manifest.files[from];
-        if (record) {
-            delete manifest.files[from];
-            const newHash = templateInventory.get(to);
-            manifest.files[to] = { ...record, templateHash: newHash, installedHash: newHash || record.installedHash };
-        }
-        console.log(`  RENAME  ${from} → ${to}`);
-    }
-    // 5b. Add new files
-    for (const filePath of plan.toAdd) {
-        const templateHash = templateInventory.get(filePath);
-        if (!templateHash)
-            continue;
-        const destPath = path.join(claudeDir, filePath);
-        const destDir = path.dirname(destPath);
-        if (!fs.existsSync(destDir))
-            fs.mkdirSync(destDir, { recursive: true });
-        copyTemplateFile(TEMPLATES_DIR, filePath, destPath);
-        manifest.files[filePath] = templateFileRecord(templateHash);
-        console.log(`  ADD     ${filePath}`);
-    }
-    // 5c. Update changed synced/outdated files
-    for (const filePath of plan.toUpdate) {
-        const templateHash = templateInventory.get(filePath);
-        if (!templateHash)
-            continue;
-        const destPath = path.join(claudeDir, filePath);
-        safeBackupFile(destPath);
-        copyTemplateFile(TEMPLATES_DIR, filePath, destPath);
-        manifest.files[filePath] = templateFileRecord(templateHash);
-        console.log(`  UPDATE  ${filePath}`);
-    }
-    // 5d. Remove deleted files
-    for (const filePath of plan.toRemove) {
-        const absPath = path.join(claudeDir, filePath);
-        if (fs.existsSync(absPath)) {
-            safeBackupFile(absPath);
-            fs.unlinkSync(absPath);
-        }
-        delete manifest.files[filePath];
-        console.log(`  REMOVE  ${filePath}`);
-    }
-    // 5e. Update pinned/modified file records (record new template hash without touching file)
-    for (const { file, reason, newTemplateHash } of plan.toSkip) {
-        if (manifest.files[file]) {
-            manifest.files[file].templateHash = newTemplateHash;
-        }
-        if (reason === 'modified') {
-            console.log(`  SKIP    ${file} (user modified)`);
-        }
-        else {
-            console.log(`  SKIP    ${file} (pinned)`);
-        }
-    }
-    // 5f. Clean up empty directories
-    for (const dir of ['hooks', 'skills', 'agents', 'config/workflows']) {
-        const dirPath = path.join(claudeDir, dir);
-        if (fs.existsSync(dirPath))
-            cleanEmptyDirs(dirPath);
-    }
-    // 6. Bidirectional settings hook sync
-    const settingsTarget = path.join(claudeDir, 'settings.local.json');
-    const settingsSrc = path.join(TEMPLATES_DIR, 'settings-hooks.json');
-    const syncResult = syncSettingsHooks(settingsTarget, settingsSrc, manifest.settingsHooksChecksum, renameMap);
-    if (!syncResult.skipped) {
-        console.log(`  Settings +${syncResult.added} -${syncResult.removed} hooks (${syncResult.updated} renamed)`);
-        manifest.settingsHooksChecksum = getTemplateChecksum(settingsSrc);
-    }
-    // 7. Config migrations
-    const configPath = path.join(claudeDir, 'orbital.config.json');
-    const migrationResult = migrateConfig(configPath, manifest.appliedMigrations);
-    if (migrationResult.applied.length > 0) {
-        manifest.appliedMigrations.push(...migrationResult.applied);
-        console.log(`  Config   ${migrationResult.applied.length} migration(s) applied`);
-    }
-    if (migrationResult.defaultsFilled.length > 0) {
-        console.log(`  Config   ${migrationResult.defaultsFilled.length} default(s) filled`);
-    }
-    // 8. Regenerate derived artifacts (always)
-    const workflowManifestOk = writeManifest(claudeDir);
-    console.log(`  ${workflowManifestOk ? 'Updated' : 'Skipped'}  .claude/config/workflow-manifest.sh`);
-    const indexContent = generateIndexMd(projectRoot, claudeDir);
-    fs.writeFileSync(path.join(claudeDir, 'INDEX.md'), indexContent, 'utf8');
-    console.log(`  Updated  .claude/INDEX.md`);
-    // 9. Update agent-triggers.json (template-managed)
-    const triggersSrc = path.join(TEMPLATES_DIR, 'config', 'agent-triggers.json');
-    const triggersDest = path.join(claudeDir, 'config', 'agent-triggers.json');
-    if (fs.existsSync(triggersSrc)) {
-        fs.copyFileSync(triggersSrc, triggersDest);
-        console.log(`  Updated  .claude/config/agent-triggers.json`);
-    }
-    // 10. Update scope template
-    const scopeTemplateSrc = path.join(TEMPLATES_DIR, 'scopes', '_template.md');
-    const scopeTemplateDest = path.join(projectRoot, 'scopes', '_template.md');
-    if (fs.existsSync(scopeTemplateSrc)) {
-        ensureDir(path.join(projectRoot, 'scopes'));
-        fs.copyFileSync(scopeTemplateSrc, scopeTemplateDest);
-    }
-    // 11. Make hook scripts executable
-    chmodScripts(path.join(claudeDir, 'hooks'));
-    // 12. Refresh global primitives
-    seedGlobalPrimitives();
-    // 13. Update manifest metadata
-    manifest.previousPackageVersion = oldVersion;
-    manifest.packageVersion = newVersion;
-    manifest.updatedAt = new Date().toISOString();
-    saveManifest(projectRoot, manifest);
-    // 14. Validate
-    const report = validate(projectRoot, newVersion);
-    if (report.errors > 0) {
-        console.log(`\n  Validation: ${report.errors} errors found`);
-        console.log(formatValidationReport(report));
-    }
-    const totalChanges = plan.toAdd.length + plan.toUpdate.length + plan.toRemove.length + plan.toRename.length;
-    console.log(`\nUpdate complete. ${totalChanges} file changes, ${plan.toSkip.length} skipped.\n`);
-}
-export function runUninstall(projectRoot, options = {}) {
-    const { dryRun = false, keepConfig = false } = options;
-    const claudeDir = path.join(projectRoot, '.claude');
-    console.log(`\nOrbital Command — uninstall${dryRun ? ' (dry run)' : ''}`);
-    console.log(`Project root: ${projectRoot}\n`);
-    const manifest = loadManifest(projectRoot);
-    // Fall back to legacy uninstall if no manifest
-    if (!manifest) {
-        console.log('  No manifest found — falling back to legacy uninstall.');
-        runLegacyUninstall(projectRoot);
-        return;
-    }
-    // Compute what to remove vs preserve
-    const toRemove = [];
-    const toPreserve = [];
-    for (const [filePath, record] of Object.entries(manifest.files)) {
-        if (record.origin === 'user') {
-            toPreserve.push(filePath);
-        }
-        else if (record.status === 'modified' || record.status === 'outdated') {
-            toPreserve.push(filePath);
-        }
-        else {
-            toRemove.push(filePath);
-        }
-    }
-    if (dryRun) {
-        console.log('  Files to REMOVE:');
-        for (const f of toRemove)
-            console.log(`    ${f}`);
-        if (toPreserve.length > 0) {
-            console.log('  Files to PRESERVE:');
-            for (const f of toPreserve)
-                console.log(`    ${f} (${manifest.files[f].origin}/${manifest.files[f].status})`);
-        }
-        console.log(`\n  Would also remove: settings hooks, generated artifacts, config files, gitignore entries`);
-        console.log(`  No changes made. Run without --dry-run to apply.`);
-        return;
-    }
-    // 1. Remove _orbital hooks from settings.local.json
-    const settingsPath = path.join(claudeDir, 'settings.local.json');
-    const removedHooks = removeAllOrbitalHooks(settingsPath);
-    console.log(`  Removed  ${removedHooks} orbital hook registrations`);
-    // 2. Delete template files (synced + pinned, not modified or user-owned)
-    let filesRemoved = 0;
-    for (const filePath of toRemove) {
-        const absPath = path.join(claudeDir, filePath);
-        if (fs.existsSync(absPath)) {
-            fs.unlinkSync(absPath);
-            filesRemoved++;
-        }
-    }
-    console.log(`  Removed  ${filesRemoved} template files`);
-    if (toPreserve.length > 0) {
-        console.log(`  Preserved ${toPreserve.length} user/modified files`);
-    }
-    // 3. Clean up empty directories
-    for (const dir of ['hooks', 'skills', 'agents', 'config/workflows', 'quick', 'anti-patterns']) {
-        const dirPath = path.join(claudeDir, dir);
-        if (fs.existsSync(dirPath))
-            cleanEmptyDirs(dirPath);
-    }
-    // 4. Remove generated artifacts
-    for (const artifact of manifest.generatedArtifacts) {
-        const artifactPath = path.join(claudeDir, artifact);
-        if (fs.existsSync(artifactPath)) {
-            fs.unlinkSync(artifactPath);
-            console.log(`  Removed  .claude/${artifact}`);
-        }
-    }
-    // 5. Remove template-sourced config files
-    const configFiles = [
-        'config/agent-triggers.json',
-        'config/workflow.json',
-        'lessons-learned.md',
-    ];
-    for (const file of configFiles) {
-        const filePath = path.join(claudeDir, file);
-        if (fs.existsSync(filePath)) {
-            fs.unlinkSync(filePath);
-            console.log(`  Removed  .claude/${file}`);
-        }
-    }
-    // Remove config/workflows/ directory entirely
-    const workflowsDir = path.join(claudeDir, 'config', 'workflows');
-    if (fs.existsSync(workflowsDir)) {
-        fs.rmSync(workflowsDir, { recursive: true, force: true });
-        console.log(`  Removed  .claude/config/workflows/`);
-    }
-    // 6. Remove gitignore entries
-    removeGitignoreEntries(projectRoot, manifest.gitignoreEntries);
-    console.log(`  Cleaned  .gitignore`);
-    // 7. Deregister from global registry
-    if (unregisterProject(projectRoot)) {
-        console.log(`  Removed  project from ~/.orbital/config.json`);
-    }
-    // 8. Remove orbital config and manifest (unless --keep-config)
-    if (!keepConfig) {
-        const toClean = ['orbital.config.json', 'orbital-manifest.json', 'orbital-sync.json'];
-        for (const file of toClean) {
-            const filePath = path.join(claudeDir, file);
-            if (fs.existsSync(filePath))
-                fs.unlinkSync(filePath);
-        }
-        // Remove backups directory
-        const backupsDir = path.join(claudeDir, '.orbital-backups');
-        if (fs.existsSync(backupsDir))
-            fs.rmSync(backupsDir, { recursive: true, force: true });
-        console.log(`  Removed  orbital config and manifest`);
-    }
-    else {
-        // Still remove the manifest — it's invalid after uninstall
-        const manifestPath = path.join(claudeDir, 'orbital-manifest.json');
-        if (fs.existsSync(manifestPath))
-            fs.unlinkSync(manifestPath);
-        console.log(`  Kept     orbital.config.json (--keep-config)`);
-    }
-    // Clean up remaining empty directories
-    for (const dir of ['config', 'quick', 'anti-patterns', 'review-verdicts']) {
-        const dirPath = path.join(claudeDir, dir);
-        if (fs.existsSync(dirPath))
-            cleanEmptyDirs(dirPath);
-    }
-    const total = removedHooks + filesRemoved;
-    console.log(`\nUninstall complete. ${total} items removed.`);
-    if (toPreserve.length > 0) {
-        console.log(`Note: ${toPreserve.length} user/modified files were preserved.`);
-    }
-    console.log(`Note: scopes/ and .claude/orbital-events/ were preserved.\n`);
-}
-/** Legacy uninstall for projects without a manifest (backward compat). */
-function runLegacyUninstall(projectRoot) {
-    const claudeDir = path.join(projectRoot, '.claude');
-    // Remove orbital hooks from settings.local.json
-    const settingsPath = path.join(claudeDir, 'settings.local.json');
-    const removedHooks = removeAllOrbitalHooks(settingsPath);
-    console.log(`  Removed  ${removedHooks} orbital hook registrations`);
-    // Delete hooks/skills/agents that match template files
-    for (const dir of ['hooks', 'skills', 'agents']) {
-        const templateFiles = listTemplateFiles(path.join(TEMPLATES_DIR, dir), path.join(claudeDir, dir));
-        let removed = 0;
-        for (const f of templateFiles) {
-            if (fs.existsSync(f)) {
-                fs.unlinkSync(f);
-                removed++;
-            }
-        }
-        const dirPath = path.join(claudeDir, dir);
-        if (fs.existsSync(dirPath))
-            cleanEmptyDirs(dirPath);
-        console.log(`  Removed  ${removed} ${dir} files`);
-    }
-    console.log(`\nLegacy uninstall complete.`);
-    console.log(`Note: scopes/ and .claude/orbital-events/ were preserved.\n`);
-}
-/** Remove Orbital-added entries from .gitignore. */
-function removeGitignoreEntries(projectRoot, entries) {
-    const gitignorePath = path.join(projectRoot, '.gitignore');
-    if (!fs.existsSync(gitignorePath))
-        return;
-    let content = fs.readFileSync(gitignorePath, 'utf-8');
-    const marker = '# Orbital Command';
-    // Try to remove the entire block
-    const markerIdx = content.indexOf(marker);
-    if (markerIdx !== -1) {
-        // Find the block boundaries: from the marker to the next non-empty/non-orbital line
-        const before = content.slice(0, markerIdx).replace(/\n+$/, '');
-        const after = content.slice(markerIdx);
-        const lines = after.split('\n');
-        let endIdx = 0;
-        for (let i = 0; i < lines.length; i++) {
-            const line = lines[i].trim();
-            if (i === 0) {
-                endIdx = i + 1;
-                continue;
-            } // skip the marker line
-            if (line === '' || entries.includes(line)) {
-                endIdx = i + 1;
-                continue;
-            }
-            break;
-        }
-        const remaining = lines.slice(endIdx).join('\n');
-        content = before + (remaining ? '\n' + remaining : '') + '\n';
-        fs.writeFileSync(gitignorePath, content, 'utf-8');
-    }
-}
-/** Copy a single template file to a destination, resolving the template path. */
-function copyTemplateFile(templatesDir, claudeRelPath, destPath) {
-    const templateRelPath = reverseRemapPath(claudeRelPath);
-    const srcPath = path.join(templatesDir, templateRelPath);
-    if (!fs.existsSync(srcPath)) {
-        throw new Error(`Template file not found: ${templateRelPath}`);
-    }
-    const destDir = path.dirname(destPath);
-    if (!fs.existsSync(destDir))
-        fs.mkdirSync(destDir, { recursive: true });
-    safeCopyTemplate(srcPath, destPath);
-}
+// runUpdate and runUninstall have been extracted to update.ts and uninstall.ts
+// and are re-exported above for backward compatibility.

package/dist/server/server/launch.js

@@ -1,5 +1,5 @@
 /**
- * Entry point for `orbital launch` — starts the central multi-project server.
+ * Entry point for the central multi-project server.
  *
  * Reads environment variables set by bin/orbital.js:
  *   ORBITAL_LAUNCH_MODE=central

package/dist/server/server/parsers/event-parser.js

@@ -32,7 +32,10 @@ export function parseEventFile(filePath) {
         };
     }
     catch (err) {
-        log.warn('Failed to parse event file', { file: filePath, error: err.message });
+        const code = err.code;
+        if (code !== 'ENOENT') {
+            log.warn('Failed to parse event file', { file: filePath, error: err.message });
+        }
         return null;
     }
 }

package/dist/server/server/project-context.js

@@ -21,7 +21,6 @@ import { startScopeWatcher } from './watchers/scope-watcher.js';
 import { startEventWatcher } from './watchers/event-watcher.js';
 import { resolveStaleDispatches, resolveActiveDispatchesForScope, resolveDispatchesByPid, resolveDispatchesByDispatchId, linkPidToDispatch, tryAutoRevertAndClear } from './utils/dispatch-utils.js';
 import { syncClaudeSessionsToDB } from './services/claude-session-service.js';
-import { TelemetryService } from './services/telemetry-service.js';
 import { ensureDynamicProfiles } from './utils/terminal-launcher.js';
 import { createLogger } from './utils/logger.js';
 const log = createLogger('project-context');
@@ -60,8 +59,8 @@ export async function createProjectContext(projectId, projectRoot, emitter) {
     const gateService = new GateService(db, emitter);
     const deployService = new DeployService(db, emitter);
     const sprintService = new SprintService(db, emitter, scopeService);
-    const sprintOrchestrator = new SprintOrchestrator(db, emitter, sprintService, scopeService, workflowEngine, config.projectRoot);
-    const batchOrchestrator = new BatchOrchestrator(db, emitter, sprintService, scopeService, workflowEngine, config.projectRoot);
+    const sprintOrchestrator = new SprintOrchestrator(db, emitter, sprintService, scopeService, workflowEngine, config.projectRoot, config);
+    const batchOrchestrator = new BatchOrchestrator(db, emitter, sprintService, scopeService, workflowEngine, config.projectRoot, config);
     const readinessService = new ReadinessService(scopeService, gateService, workflowEngine, config.projectRoot);
     const workflowService = new WorkflowService(config.configDir, workflowEngine, config.scopesDir, getDefaultConfigPath());
     workflowService.setSocketServer(emitter);
@@ -69,7 +68,17 @@ export async function createProjectContext(projectId, projectRoot, emitter) {
     workflowEngine.reload(workflowService.getActive());
     const gitService = new GitService(config.projectRoot, scopeCache);
     const githubService = new GitHubService(config.projectRoot);
-    const telemetryService = new TelemetryService(db, config.telemetry, config.projectName, config.projectRoot);
+    let telemetryService = null;
+    let telemetryRouter = null;
+    const telemetryMod = './services/telemetry-service.js';
+    try {
+        const mod = await import(telemetryMod);
+        telemetryService = new mod.TelemetryService(db, config.telemetry, config.projectName, config.projectRoot);
+        if (telemetryService?.enabled) {
+            telemetryRouter = mod.createTelemetryRoutes({ telemetryService });
+        }
+    }
+    catch { /* telemetry service not installed */ }
     // Wire active-group guard
     scopeService.setActiveGroupCheck((scopeId) => sprintService.getActiveGroupForScope(scopeId));
     // Wire event inference (Fix 8: diagnostic log lines match index.ts)
@@ -130,7 +139,7 @@ export async function createProjectContext(projectId, projectRoot, emitter) {
     });
     // Wire status change callbacks
     scopeService.onStatusChange((scopeId, newStatus) => {
-        if (newStatus === 'dev')
+        if (workflowEngine.isTerminalStatus(newStatus))
             sprintOrchestrator.onScopeReachedDev(scopeId);
         batchOrchestrator.onScopeStatusChanged(scopeId, newStatus);
     });
@@ -157,7 +166,7 @@ export async function createProjectContext(projectId, projectRoot, emitter) {
     if (staleBatchesResolved > 0)
         log.info('Resolved stale batches', { count: staleBatchesResolved });
     // Resolve stale dispatches
-    resolveStaleDispatches(db, emitter, scopeService, workflowEngine);
+    resolveStaleDispatches(db, emitter, scopeService, workflowEngine, config.dispatch.staleTimeoutMinutes);
     // Initial session sync + legacy purge (Fix 7)
     syncClaudeSessionsToDB(db, scopeService, config.projectRoot).then((count) => {
         if (count > 0)
@@ -165,7 +174,7 @@ export async function createProjectContext(projectId, projectRoot, emitter) {
         const purged = db.prepare("DELETE FROM sessions WHERE action IS NULL AND id LIKE 'claude-%'").run();
         if (purged.changes > 0)
             log.info('Purged legacy session rows', { count: purged.changes });
-        if (telemetryService.enabled) {
+        if (telemetryService?.enabled) {
             telemetryService.uploadChangedSessions().catch(() => { });
         }
     }).catch(err => log.error('Session sync failed', { error: err.message }));
@@ -179,13 +188,13 @@ export async function createProjectContext(projectId, projectRoot, emitter) {
         batchOrchestrator.resolveStaleBatches();
     }, 30_000));
     intervals.push(setInterval(() => {
-        resolveStaleDispatches(db, emitter, scopeService, workflowEngine);
+        resolveStaleDispatches(db, emitter, scopeService, workflowEngine, config.dispatch.staleTimeoutMinutes);
     }, 30_000));
     intervals.push(setInterval(async () => {
         const count = await syncClaudeSessionsToDB(db, scopeService, config.projectRoot);
         if (count > 0)
             emitter.emit('session:updated', { type: 'resync', count });
-        if (telemetryService.enabled) {
+        if (telemetryService?.enabled) {
             telemetryService.uploadChangedSessions().catch(() => { });
         }
     }, 5 * 60_000));
@@ -221,6 +230,7 @@ export async function createProjectContext(projectId, projectRoot, emitter) {
         gitService,
         githubService,
         telemetryService,
+        telemetryRouter,
         scopeWatcher,
         eventWatcher,
         intervals,

package/dist/server/server/project-manager.js

@@ -11,7 +11,6 @@ import { createWorkflowRoutes } from './routes/workflow-routes.js';
 import { createConfigRoutes } from './routes/config-routes.js';
 import { createGitRoutes } from './routes/git-routes.js';
 import { createManifestRoutes } from './routes/manifest-routes.js';
-import { createTelemetryRoutes } from './services/telemetry-service.js';
 import { TEMPLATES_DIR } from './init.js';
 import { getPackageVersion } from './utils/package-info.js';
 import { resolveActiveDispatchesForScope } from './utils/dispatch-utils.js';
@@ -227,7 +226,7 @@ export class ProjectManager {
      *  are global (they update the Orbital Command package), not per-project. */
     buildProjectRouter(ctx) {
         const router = Router();
-        const { db, emitter, config, scopeService, eventService, gateService, deployService, sprintService, sprintOrchestrator, batchOrchestrator, readinessService, workflowService, workflowEngine, gitService, githubService, telemetryService } = ctx;
+        const { db, emitter, config, scopeService, eventService, gateService, deployService, sprintService, sprintOrchestrator, batchOrchestrator, readinessService, workflowService, workflowEngine, gitService, githubService } = ctx;
         // Scope status inference function (same logic as index.ts)
         function inferScopeStatus(eventType, scopeId, data) {
             if (scopeId == null)
@@ -262,16 +261,16 @@ export class ProjectManager {
         router.use(createScopeRoutes({
             db, io: emitter, scopeService, readinessService,
             projectRoot: config.projectRoot, projectName: config.projectName,
-            engine: workflowEngine,
+            engine: workflowEngine, config,
         }));
         router.use(createDataRoutes({
             db, io: emitter, eventService, gateService, deployService, gitService,
             engine: workflowEngine, projectRoot: config.projectRoot,
-            inferScopeStatus,
+            inferScopeStatus, config,
         }));
         router.use(createDispatchRoutes({
             db, io: emitter, scopeService,
-            projectRoot: config.projectRoot, engine: workflowEngine,
+            projectRoot: config.projectRoot, engine: workflowEngine, config,
         }));
         router.use(createSprintRoutes({
             sprintService, sprintOrchestrator, batchOrchestrator,
@@ -291,7 +290,8 @@ export class ProjectManager {
             packageVersion: getPackageVersion(),
             io: emitter,
         }));
-        router.use(createTelemetryRoutes({ telemetryService }));
+        if (ctx.telemetryRouter)
+            router.use(ctx.telemetryRouter);
         return router;
     }
 }