@a-company/paradigm 3.11.0 → 3.12.0

package/dist/{accept-orchestration-Z35I5AYN.js → accept-orchestration-YKMKMWGA.js}

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import {
   BackgroundOrchestrator
-} from "./chunk-24AAVLME.js";
+} from "./chunk-CQFNTBFJ.js";
 import "./chunk-6QC3YGB6.js";
-import "./chunk-CP6IZGUN.js";
+import "./chunk-JQYGPVLQ.js";
+import "./chunk-5N5LR2KS.js";
 import "./chunk-PMXRGPRQ.js";
 import "./chunk-PBHIFAL4.js";
-import "./chunk-5N5LR2KS.js";
 import "./chunk-6P4IFIK2.js";
 import "./chunk-MRENOFTR.js";
 import "./chunk-IRKUEJVW.js";

package/dist/{chunk-3TWXFFZ3.js → chunk-4PEQHWD7.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   BackgroundOrchestrator
-} from "./chunk-24AAVLME.js";
+} from "./chunk-CQFNTBFJ.js";
 import {
   AGENT_MODEL_RECOMMENDATIONS,
   addActivity,

package/dist/{workspace-VBTW7OYL.js → chunk-C3BK3E23.js}

@@ -2,14 +2,9 @@
 import {
   indexCommand
 } from "./chunk-UI3XXVJ6.js";
-import "./chunk-AK5M6KJB.js";
-import "./chunk-6P4IFIK2.js";
-import "./chunk-MRENOFTR.js";
-import "./chunk-IRKUEJVW.js";
 import {
   log
 } from "./chunk-4NCFWYGG.js";
-import "./chunk-MO4EEYFW.js";
 
 // src/commands/workspace/index.ts
 import * as fs from "fs";
@@ -264,8 +259,10 @@ function getMemberStatus(workspaceDir, member) {
   }
   return result;
 }
+
 export {
   workspaceInitCommand,
+  workspaceStatusCommand,
   workspaceReindexCommand,
-  workspaceStatusCommand
+  detectProjectRole
 };

package/dist/{chunk-24AAVLME.js → chunk-CQFNTBFJ.js}

@@ -5,7 +5,7 @@ import {
 import {
   AgentSpawner,
   extractSymbols
-} from "./chunk-CP6IZGUN.js";
+} from "./chunk-JQYGPVLQ.js";
 import {
   loadAgentsManifest
 } from "./chunk-PMXRGPRQ.js";

package/dist/{chunk-OSYMVGWX.js → chunk-CYGHL7PQ.js}

@@ -2,13 +2,13 @@
 import {
   detectIDE,
   getAdapter
-} from "./chunk-2QNZ6PVD.js";
-import {
-  log
-} from "./chunk-4NCFWYGG.js";
+} from "./chunk-KB4XJWE3.js";
 import {
   parseParadigmConfig
 } from "./chunk-YO6DVTL7.js";
+import {
+  log
+} from "./chunk-4NCFWYGG.js";
 
 // src/commands/doctor.ts
 import * as fs from "fs";

package/dist/{chunk-BC6XKMUA.js → chunk-K34C7NAN.js}

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
-import {
-  indexCommand
-} from "./chunk-UI3XXVJ6.js";
 import {
   detectDiscipline,
   getDisciplineConfig
 } from "./chunk-CHSHON3O.js";
+import {
+  indexCommand
+} from "./chunk-UI3XXVJ6.js";
 import {
   getDefaultPremiseContent
 } from "./chunk-6P4IFIK2.js";
@@ -16,7 +16,7 @@ import {
   detectIDE,
   loadParadigmFiles,
   syncToIDE
-} from "./chunk-2QNZ6PVD.js";
+} from "./chunk-KB4XJWE3.js";
 import {
   log
 } from "./chunk-4NCFWYGG.js";

package/dist/{chunk-2QNZ6PVD.js → chunk-KB4XJWE3.js}

@@ -474,6 +474,41 @@ function generateLlmsTxtSection() {
   lines.push("");
   return lines.join("\n");
 }
+function generateWorkspaceSection(files) {
+  if (!files.workspace) return "";
+  const ws = files.workspace;
+  const siblings = ws.members.filter((m) => m.name !== ws.currentMember);
+  if (siblings.length === 0) return "";
+  const lines = [];
+  lines.push(`## Workspace: ${ws.name}`);
+  lines.push("");
+  lines.push("This project is part of a multi-project workspace.");
+  lines.push("");
+  lines.push("| Member | Role | Path |");
+  lines.push("|--------|------|------|");
+  for (const m of ws.members) {
+    const tag = m.name === ws.currentMember ? " **(this project)**" : "";
+    lines.push(`| ${m.name}${tag} | ${m.role || "-"} | \`${m.path}\` |`);
+  }
+  lines.push("");
+  lines.push("### Cross-Project Tools");
+  lines.push("");
+  lines.push("Use `includeWorkspace: true` when:");
+  lines.push("- Modifying symbols consumed by sibling projects");
+  lines.push("- Adding API endpoints or gates that siblings depend on");
+  lines.push("- Investigating cross-project impact of changes");
+  lines.push("");
+  lines.push("| Tool | Workspace Parameter |");
+  lines.push("|------|-------------------|");
+  lines.push("| `paradigm_search` | `includeWorkspace: true` \u2014 search sibling indices |");
+  lines.push("| `paradigm_ripple` | `includeWorkspace: true` \u2014 cross-project impact |");
+  lines.push("| `paradigm_gates_for_route` | Automatic \u2014 learns from sibling portal.yaml |");
+  lines.push("| `paradigm_workspace_reindex` | Rebuild all member indices |");
+  lines.push("");
+  lines.push("Cross-project symbols are prefixed: " + siblings.map((s) => `\`${s.name}/#symbol\``).join(", "));
+  lines.push("");
+  return lines.join("\n");
+}
 function generateFooter() {
   const lines = [];
   lines.push("---");
@@ -1971,6 +2006,10 @@ var ClaudeAdapter = class {
     sections.push('paradigm_orchestrate_inline({ task: "...", mode: "plan" })');
     sections.push("```");
     sections.push("");
+    const workspaceSection = generateWorkspaceSection(files);
+    if (workspaceSection) {
+      sections.push(workspaceSection);
+    }
     sections.push("## Flow-First Development");
     sections.push("");
     sections.push("**Define flows BEFORE implementing features that span multiple steps.**");
@@ -2231,6 +2270,7 @@ var AgentsAdapter = class {
 var agentsAdapter = new AgentsAdapter();
 
 // src/core/ide-adapters/index.ts
+import * as yaml2 from "js-yaml";
 var adapters = /* @__PURE__ */ new Map([
   ["cursor", cursorAdapter],
   ["copilot", copilotAdapter],
@@ -2328,11 +2368,33 @@ function loadParadigmFiles(rootDir) {
       }
     }
   }
+  let workspace = void 0;
+  const rawConfig = yaml2.load(fs6.readFileSync(configPath, "utf8"));
+  const wsField = rawConfig.workspace;
+  if (typeof wsField === "string") {
+    const wsPath = path6.resolve(rootDir, wsField);
+    if (fs6.existsSync(wsPath)) {
+      try {
+        const wsConfig = yaml2.load(fs6.readFileSync(wsPath, "utf8"));
+        const wsDir = path6.dirname(wsPath);
+        const currentName = wsConfig.members?.find(
+          (m) => path6.resolve(wsDir, m.path) === rootDir
+        )?.name || path6.basename(rootDir);
+        workspace = {
+          name: wsConfig.name,
+          currentMember: currentName,
+          members: wsConfig.members || []
+        };
+      } catch {
+      }
+    }
+  }
   return {
     config,
     specs,
     docs,
-    projectName: path6.basename(rootDir)
+    projectName: path6.basename(rootDir),
+    workspace
   };
 }
 function syncToIDE(rootDir, ideName, files, force = false) {

package/dist/{chunk-QHJGB5TV.js → chunk-RP6TZYGE.js}

@@ -8,7 +8,7 @@ import {
   syncToIDE,
   writeMcpConfig,
   writeNestedContexts
-} from "./chunk-2QNZ6PVD.js";
+} from "./chunk-KB4XJWE3.js";
 import {
   log
 } from "./chunk-4NCFWYGG.js";

package/dist/{diff-PZAYCIAE.js → diff-4FV7T35U.js}

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import {
   BackgroundOrchestrator
-} from "./chunk-24AAVLME.js";
+} from "./chunk-CQFNTBFJ.js";
 import "./chunk-6QC3YGB6.js";
-import "./chunk-CP6IZGUN.js";
+import "./chunk-JQYGPVLQ.js";
+import "./chunk-5N5LR2KS.js";
 import "./chunk-PMXRGPRQ.js";
 import "./chunk-PBHIFAL4.js";
-import "./chunk-5N5LR2KS.js";
 import "./chunk-6P4IFIK2.js";
 import "./chunk-MRENOFTR.js";
 import "./chunk-IRKUEJVW.js";

package/dist/{doctor-3YQ55536.js → doctor-2KM5HOK6.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   doctorCommand
-} from "./chunk-OSYMVGWX.js";
-import "./chunk-2QNZ6PVD.js";
-import "./chunk-4NCFWYGG.js";
+} from "./chunk-CYGHL7PQ.js";
+import "./chunk-KB4XJWE3.js";
 import "./chunk-YO6DVTL7.js";
+import "./chunk-4NCFWYGG.js";
 import "./chunk-MO4EEYFW.js";
 export {
   doctorCommand

package/dist/index.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import {
   initCommand
-} from "./chunk-BC6XKMUA.js";
-import "./chunk-UI3XXVJ6.js";
+} from "./chunk-K34C7NAN.js";
 import "./chunk-CHSHON3O.js";
+import "./chunk-UI3XXVJ6.js";
 import "./chunk-AK5M6KJB.js";
 import {
   aggregateFromDirectory,
@@ -16,11 +16,11 @@ import {
 import {
   findGateFiles
 } from "./chunk-IRKUEJVW.js";
-import "./chunk-2QNZ6PVD.js";
+import "./chunk-KB4XJWE3.js";
+import "./chunk-YO6DVTL7.js";
 import {
   log
 } from "./chunk-4NCFWYGG.js";
-import "./chunk-YO6DVTL7.js";
 import "./chunk-MO4EEYFW.js";
 
 // src/index.ts
@@ -109,8 +109,8 @@ ${chalk2.magenta("\u2569  ")}${chalk2.cyan("\u2534 \u2534\u2534\u2514\u2500\u253
 `;
 program.name("paradigm").description("Unified developer tools ecosystem").version(VERSION).addHelpText("before", banner);
 program.command("init").description("Initialize Paradigm in the current project").option("-f, --force", "Overwrite existing files").option("--name <name>", "Project name").option("--ide <ide>", "Target IDE: cursor, copilot, windsurf, claude").option("--migrate", "Output migration prompt for existing IDE files").option("--quick", "Non-interactive mode with smart defaults").option("--dry-run", "Show what would be created without creating").action(initCommand);
-program.command("shift").description("Full project setup in one command (init + team init + scan + sync all IDEs + doctor)").option("-f, --force", "Reinitialize even if already setup").option("-q, --quick", "Skip slow operations (scan)").option("--verify", "Run health checks after setup").option("--ide <ide>", "Target specific IDE instead of all").option("--configure-models", "Force model configuration prompts for team agents").action(async (options) => {
-  const { shiftCommand } = await import("./shift-6I6N6RNK.js");
+program.command("shift").description("Full project setup in one command (init + team init + scan + sync all IDEs + doctor)").option("-f, --force", "Reinitialize even if already setup").option("-q, --quick", "Skip slow operations (scan)").option("--verify", "Run health checks after setup").option("--ide <ide>", "Target specific IDE instead of all").option("--configure-models", "Force model configuration prompts for team agents").option("--workspace <name>", "Create or join a multi-project workspace with this name (creates ../.paradigm-workspace)").option("--workspace-path <path>", "Custom workspace file location (default: ../.paradigm-workspace)").action(async (options) => {
+  const { shiftCommand } = await import("./shift-G2ZCIR5Q.js");
   await shiftCommand(options);
 });
 program.command("setup [path]").description("Interactive setup wizard for Paradigm").option("-y, --yes", "Accept all defaults (non-interactive)").option("-f, --force", "Overwrite existing .paradigm config").action(async (path2, options) => {
@@ -162,11 +162,11 @@ premiseCmd.command("snapshot <name>").description("Create a timeline snapshot").
   await premiseSnapshotCommand(name, options.description);
 });
 program.command("sync [ide]").description("Generate IDE instruction files from .paradigm/ config").option("--all", "Sync all supported IDEs").option("-f, --force", "Overwrite existing files").option("--mcp", "Generate MCP configuration (default: true)").option("--no-mcp", "Skip MCP configuration generation").option("--nested", "Generate nested CLAUDE.md files for directories with .purpose").action(async (ide, options) => {
-  const { syncCommand } = await import("./sync-5VJPZQNX.js");
+  const { syncCommand } = await import("./sync-4CNRHUWX.js");
   await syncCommand(ide, options);
 });
 program.command("sync-llms").description("Generate llms.txt \u2014 LLM-readable project summary").option("-o, --output <path>", "Output path (default: ./llms.txt)").action(async (options) => {
-  const { syncLlmsCommand } = await import("./sync-llms-7QDA3ZWC.js");
+  const { syncLlmsCommand } = await import("./sync-llms-MCWB37HN.js");
   await syncLlmsCommand(options);
 });
 program.command("cursorrules [path]").description("[DEPRECATED] Use `paradigm sync cursor` instead").option("-a, --append", "Append to existing .cursorrules").option("-f, --force", "Overwrite existing .cursorrules").option("-p, --preview", "Preview output without writing").option("--init", "Create default .paradigm config if missing").option("--with-scan", "Include probe protocol section").action(async (path2, options) => {
@@ -184,7 +184,7 @@ probeCmd.command("index [path]").description("Generate probe index (alias for `p
   await indexCommand(path2, options);
 });
 program.command("upgrade [path]").description("Upgrade project with new Paradigm features").option("--features <features...>", "Features to upgrade (probe, logger)").option("--all", "Apply all available upgrades").option("--from-horizon", "Migrate from Horizon to Paradigm").option("--dry-run", "Show what would be upgraded without making changes").option("-f, --force", "Force re-upgrade even if already configured").action(async (path2, options) => {
-  const { upgradeCommand } = await import("./upgrade-RBSE4M6I.js");
+  const { upgradeCommand } = await import("./upgrade-HGF4MBGV.js");
   await upgradeCommand(path2, options);
 });
 program.command("lint [path]").description("Validate .purpose files for schema errors").option("-f, --fix", "Auto-fix issues where possible").option("-s, --strict", "Fail on warnings (not just errors)").option("-q, --quiet", "Suppress output except errors").option("--json", "Output as JSON").option("--auto-populate", "Scan for undocumented source dirs and suggest .purpose entries (use with --fix to write)").action(async (path2, options) => {
@@ -216,7 +216,7 @@ flowCmd.action(() => {
 });
 var teamCmd = program.command("team").description("Multi-agent orchestration commands");
 teamCmd.command("init [path]").description("Initialize team configuration with default agents").option("-f, --force", "Overwrite existing configuration").option("--configure-models", "Force model configuration prompts").option("--no-configure-models", "Skip model configuration").option("--json", "Output as JSON").action(async (path2, options) => {
-  const { teamInitCommand } = await import("./team-AFOKQ7YQ.js");
+  const { teamInitCommand } = await import("./team-XUZBPIFZ.js");
   await teamInitCommand(path2, {
     ...options,
     configureModels: options.configureModels,
@@ -224,47 +224,47 @@ teamCmd.command("init [path]").description("Initialize team configuration with d
   });
 });
 teamCmd.command("status [path]").description("Show current team status").option("--running", "Show only running orchestrations").option("--id <id>", "Show specific orchestration").option("--json", "Output as JSON").action(async (path2, options) => {
-  const { teamStatusCommand } = await import("./team-AFOKQ7YQ.js");
+  const { teamStatusCommand } = await import("./team-XUZBPIFZ.js");
   await teamStatusCommand(path2, options);
 });
 teamCmd.command("handoff [path]").description("Hand off current task to another agent").requiredOption("-t, --to <agent>", "Target agent name").option("-s, --summary <text>", "Summary of what was done").option("--json", "Output as JSON").action(async (path2, options) => {
-  const { teamHandoffCommand } = await import("./team-AFOKQ7YQ.js");
+  const { teamHandoffCommand } = await import("./team-XUZBPIFZ.js");
   await teamHandoffCommand(path2, options);
 });
 teamCmd.command("accept [handoff-id] [path]").description("Accept a pending handoff").option("-n, --note <text>", "Acceptance note").option("--json", "Output as JSON").action(async (handoffId, path2, options) => {
-  const { teamAcceptCommand } = await import("./team-AFOKQ7YQ.js");
+  const { teamAcceptCommand } = await import("./team-XUZBPIFZ.js");
   await teamAcceptCommand(handoffId, path2, options);
 });
 teamCmd.command("check [path]").description("Check for conflicts and team health issues").option("--json", "Output as JSON").action(async (path2, options) => {
-  const { teamCheckCommand } = await import("./team-AFOKQ7YQ.js");
+  const { teamCheckCommand } = await import("./team-XUZBPIFZ.js");
   await teamCheckCommand(path2, options);
 });
 teamCmd.command("history [path]").description("Show full activity log").option("-l, --limit <number>", "Number of entries to show", "50").option("--json", "Output as JSON").action(async (path2, options) => {
-  const { teamHistoryCommand } = await import("./team-AFOKQ7YQ.js");
+  const { teamHistoryCommand } = await import("./team-XUZBPIFZ.js");
   await teamHistoryCommand(path2, { ...options, limit: parseInt(options.limit) });
 });
 teamCmd.command("reset [path]").description("Reset team state for fresh start").option("-f, --force", "Force reset even with pending work").option("--json", "Output as JSON").action(async (path2, options) => {
-  const { teamResetCommand } = await import("./team-AFOKQ7YQ.js");
+  const { teamResetCommand } = await import("./team-XUZBPIFZ.js");
   await teamResetCommand(path2, options);
 });
 teamCmd.command("spawn <agent> [path]").description("Spawn an AI agent to work on a task").requiredOption("-t, --task <task>", "Task for the agent to perform").option("-m, --model <model>", "Model to use: opus, sonnet, haiku").option("-p, --provider <provider>", "Provider: auto, claude, claude-code, claude-cli, manual").option("--budget <budget>", 'Budget limits (e.g., "tokens=100000,cost=2")').option("--timeout <ms>", "Timeout in milliseconds").option("--checkpoint", "Pause for approval before writes/deletes").option("-q, --quiet", "Suppress output").option("--json", "Output as JSON").action(async (agent, path2, options) => {
-  const { teamSpawnCommand } = await import("./spawn-WGFJ5RQZ.js");
+  const { teamSpawnCommand } = await import("./spawn-7SDONTJN.js");
   await teamSpawnCommand(agent, path2, options);
 });
 teamCmd.command("orchestrate <task> [path]").description("Orchestrate a multi-agent task").option("--solo", "Run in solo mode (single Claude)").option("--faceted", "Run in faceted mode (multi-agent, default)").option("--compare", "Run both modes and compare results").option("--background", "Run in background mode (returns immediately)").option("--notify <methods>", "Notification methods: bell,desktop,file,webhook (default: bell)").option("-m, --model <model>", "Orchestrator model: opus, sonnet, haiku").option("-p, --provider <provider>", "Provider: auto, claude, claude-code, claude-cli, manual").option("--budget <budget>", 'Budget limits (e.g., "tokens=500000,cost=5")').option("--checkpoint", "Pause for approval between agents").option("--live", "Stream agent output live").option("--pm", "Enable PM governance (compliance checks before/after)").option("-q, --quiet", "Suppress output").option("--json", "Output as JSON").action(async (task, path2, options) => {
-  const { teamOrchestrateCommand } = await import("./orchestrate-BGRFBGBH.js");
+  const { teamOrchestrateCommand } = await import("./orchestrate-IV54FMHD.js");
   await teamOrchestrateCommand(task, path2, options);
 });
 teamCmd.command("diff <orchestration-id> [path]").description("Show diff of changes from a completed orchestration").option("--full", "Show full file contents").option("--json", "Output as JSON").action(async (orchestrationId, path2, options) => {
-  const { teamDiffCommand } = await import("./diff-PZAYCIAE.js");
+  const { teamDiffCommand } = await import("./diff-4FV7T35U.js");
   await teamDiffCommand(orchestrationId, path2, options);
 });
 teamCmd.command("accept-orch <orchestration-id> [path]").description("Accept orchestration changes").option("-n, --note <text>", "Acceptance note").option("--json", "Output as JSON").action(async (orchestrationId, path2, options) => {
-  const { teamAcceptOrchestrationCommand } = await import("./accept-orchestration-Z35I5AYN.js");
+  const { teamAcceptOrchestrationCommand } = await import("./accept-orchestration-YKMKMWGA.js");
   await teamAcceptOrchestrationCommand(orchestrationId, path2, options);
 });
 teamCmd.command("reject-orch <orchestration-id> [path]").description("Reject orchestration changes").option("-r, --reason <text>", "Rejection reason").option("--cleanup", "Delete created files").option("--json", "Output as JSON").action(async (orchestrationId, path2, options) => {
-  const { teamRejectOrchestrationCommand } = await import("./accept-orchestration-Z35I5AYN.js");
+  const { teamRejectOrchestrationCommand } = await import("./accept-orchestration-YKMKMWGA.js");
   await teamRejectOrchestrationCommand(orchestrationId, path2, options);
 });
 teamCmd.command("cost [path]").description("Show cost summary for orchestrations").option("--from <date>", "From date (ISO format)").option("--to <date>", "To date (ISO format)").option("--days <n>", "Last N days").option("-d, --detailed", "Show detailed breakdown").option("--json", "Output as JSON").action(async (path2, options) => {
@@ -280,7 +280,7 @@ teamCmd.command("providers [path]").description("Show available agent providers
   await teamProvidersCommand(path2, options);
 });
 teamCmd.command("models [path]").description("Configure or view agent model assignments").option("--refresh", "Refresh model cache from environment").option("--json", "Output as JSON").action(async (path2, options) => {
-  const { teamModelsCommand } = await import("./team-AFOKQ7YQ.js");
+  const { teamModelsCommand } = await import("./team-XUZBPIFZ.js");
   await teamModelsCommand(path2, options);
 });
 var agentsCmd = teamCmd.command("agents").description("Agent management commands");
@@ -295,7 +295,7 @@ agentsCmd.action(() => {
   console.log("\nRun `paradigm team agents suggest --help` for options.\n");
 });
 teamCmd.action(async () => {
-  const { teamStatusCommand } = await import("./team-AFOKQ7YQ.js");
+  const { teamStatusCommand } = await import("./team-XUZBPIFZ.js");
   await teamStatusCommand(void 0, {});
 });
 var pluginCmd = program.command("plugin").description("Plugin management commands");
@@ -309,23 +309,23 @@ pluginCmd.action(async () => {
 });
 var workspaceCmd = program.command("workspace").description("Multi-project workspace commands");
 workspaceCmd.command("init").description("Create a .paradigm-workspace file from sibling projects").option("-n, --name <name>", "Workspace name (default: directory name)").option("-f, --force", "Overwrite existing workspace file").action(async (options) => {
-  const { workspaceInitCommand } = await import("./workspace-VBTW7OYL.js");
+  const { workspaceInitCommand } = await import("./workspace-7CWY4IWV.js");
   await workspaceInitCommand(options);
 });
 workspaceCmd.command("status").description("Show workspace member status and symbol counts").option("--json", "Output as JSON").action(async (options) => {
-  const { workspaceStatusCommand } = await import("./workspace-VBTW7OYL.js");
+  const { workspaceStatusCommand } = await import("./workspace-7CWY4IWV.js");
   await workspaceStatusCommand(options);
 });
 workspaceCmd.command("reindex").description("Rebuild scan-index.json for all workspace members").option("-q, --quiet", "Suppress progress output").action(async (options) => {
-  const { workspaceReindexCommand } = await import("./workspace-VBTW7OYL.js");
+  const { workspaceReindexCommand } = await import("./workspace-7CWY4IWV.js");
   await workspaceReindexCommand(options);
 });
 workspaceCmd.action(async () => {
-  const { workspaceStatusCommand } = await import("./workspace-VBTW7OYL.js");
+  const { workspaceStatusCommand } = await import("./workspace-7CWY4IWV.js");
   await workspaceStatusCommand({});
 });
 program.command("doctor").description("Health check - validate Paradigm setup").action(async () => {
-  const { doctorCommand } = await import("./doctor-3YQ55536.js");
+  const { doctorCommand } = await import("./doctor-2KM5HOK6.js");
   await doctorCommand();
 });
 var driftCmd = program.command("drift").description("Aspect anchor drift detection");
@@ -342,11 +342,11 @@ globalCmd.action(() => {
   globalCmd.outputHelp();
 });
 program.command("watch").description("Watch for changes and auto-sync IDE files").action(async () => {
-  const { watchCommand } = await import("./watch-PAEH6MOG.js");
+  const { watchCommand } = await import("./watch-CL2PPS2K.js");
   await watchCommand();
 });
 program.command("summary").description("Generate .paradigm/project.md with project stats").action(async () => {
-  const { summaryCommand } = await import("./summary-E2PU4UN2.js");
+  const { summaryCommand } = await import("./summary-F46FRO3Y.js");
   await summaryCommand();
 });
 program.command("constellation [path]").alias("const").description("Generate .paradigm/constellation.json - symbol relationship graph for AI agents").option("-f, --format <format>", "Output format: json or yaml", "json").option("-o, --output <path>", "Custom output path").option("-q, --quiet", "Suppress output").action(async (path2, options) => {

package/dist/{orchestrate-BGRFBGBH.js → orchestrate-IV54FMHD.js}

@@ -2,14 +2,14 @@
 import {
   BackgroundOrchestrator,
   Orchestrator
-} from "./chunk-24AAVLME.js";
+} from "./chunk-CQFNTBFJ.js";
 import "./chunk-6QC3YGB6.js";
-import "./chunk-CP6IZGUN.js";
+import "./chunk-JQYGPVLQ.js";
+import "./chunk-5N5LR2KS.js";
 import {
   loadAgentsManifest
 } from "./chunk-PMXRGPRQ.js";
 import "./chunk-PBHIFAL4.js";
-import "./chunk-5N5LR2KS.js";
 import "./chunk-6P4IFIK2.js";
 import "./chunk-MRENOFTR.js";
 import "./chunk-IRKUEJVW.js";

package/dist/{shift-6I6N6RNK.js → shift-G2ZCIR5Q.js}

@@ -1,43 +1,46 @@
 #!/usr/bin/env node
 import {
   teamInitCommand
-} from "./chunk-3TWXFFZ3.js";
-import "./chunk-24AAVLME.js";
+} from "./chunk-4PEQHWD7.js";
+import "./chunk-CQFNTBFJ.js";
 import "./chunk-6QC3YGB6.js";
-import "./chunk-CP6IZGUN.js";
+import "./chunk-JQYGPVLQ.js";
+import "./chunk-5N5LR2KS.js";
 import {
   agentsConfigured
 } from "./chunk-PMXRGPRQ.js";
 import "./chunk-PBHIFAL4.js";
-import "./chunk-5N5LR2KS.js";
 import {
   hooksInstallCommand
 } from "./chunk-DS5QY37M.js";
 import {
-  initCommand
-} from "./chunk-BC6XKMUA.js";
+  detectProjectRole
+} from "./chunk-C3BK3E23.js";
 import {
-  indexCommand
-} from "./chunk-UI3XXVJ6.js";
+  initCommand
+} from "./chunk-K34C7NAN.js";
 import {
   detectDiscipline
 } from "./chunk-CHSHON3O.js";
+import {
+  indexCommand
+} from "./chunk-UI3XXVJ6.js";
 import "./chunk-AK5M6KJB.js";
 import "./chunk-6P4IFIK2.js";
 import "./chunk-MRENOFTR.js";
 import "./chunk-IRKUEJVW.js";
 import {
   syncCommand
-} from "./chunk-QHJGB5TV.js";
+} from "./chunk-RP6TZYGE.js";
 import "./chunk-MW5DMGBB.js";
 import {
   doctorCommand
-} from "./chunk-OSYMVGWX.js";
-import "./chunk-2QNZ6PVD.js";
+} from "./chunk-CYGHL7PQ.js";
+import "./chunk-KB4XJWE3.js";
+import "./chunk-YO6DVTL7.js";
 import {
   log
 } from "./chunk-4NCFWYGG.js";
-import "./chunk-YO6DVTL7.js";
 import "./chunk-5JGJACDU.js";
 import "./chunk-MO4EEYFW.js";
 
@@ -112,7 +115,80 @@ discipline: ${detected}`
   }
   {
     const configPath = path.join(paradigmDir, "config.yaml");
-    if (fs.existsSync(configPath)) {
+    if (options.workspace && fs.existsSync(configPath)) {
+      const wsFilePath = options.workspacePath ? path.resolve(cwd, options.workspacePath) : path.join(path.dirname(cwd), ".paradigm-workspace");
+      if (fs.existsSync(wsFilePath)) {
+        try {
+          const wsConfig = yaml.load(fs.readFileSync(wsFilePath, "utf8"));
+          const currentName = path.basename(cwd);
+          const wsDir = path.dirname(wsFilePath);
+          const relPath = "./" + path.relative(wsDir, cwd);
+          const alreadyMember = wsConfig.members.some(
+            (m) => path.resolve(wsDir, m.path) === cwd
+          );
+          if (!alreadyMember) {
+            const role = detectProjectRole(currentName, cwd);
+            wsConfig.members.push({
+              name: currentName,
+              path: relPath,
+              ...role && { role }
+            });
+            fs.writeFileSync(
+              wsFilePath,
+              yaml.dump(wsConfig, { indent: 2, lineWidth: 120, noRefs: true, sortKeys: false, quotingType: '"' }),
+              "utf8"
+            );
+            console.log(chalk.green(`  \u2713 Joined workspace: ${chalk.cyan(wsConfig.name)} (added as member)`));
+          } else {
+            console.log(chalk.green(`  \u2713 Already a member of workspace: ${chalk.cyan(wsConfig.name)}`));
+          }
+        } catch (e) {
+          console.log(chalk.yellow(`  \u26A0 Failed to join workspace: ${e.message}`));
+        }
+      } else {
+        try {
+          const currentName = path.basename(cwd);
+          const wsDir = path.dirname(wsFilePath);
+          const relPath = "./" + path.relative(wsDir, cwd);
+          const role = detectProjectRole(currentName, cwd);
+          const wsConfig = {
+            version: "1.0",
+            name: options.workspace,
+            members: [{ name: currentName, path: relPath, ...role && { role } }]
+          };
+          fs.mkdirSync(path.dirname(wsFilePath), { recursive: true });
+          fs.writeFileSync(
+            wsFilePath,
+            yaml.dump(wsConfig, { indent: 2, lineWidth: 120, noRefs: true, sortKeys: false, quotingType: '"' }),
+            "utf8"
+          );
+          console.log(chalk.green(`  \u2713 Created workspace: ${chalk.cyan(options.workspace)} at ${chalk.gray(path.relative(cwd, wsFilePath))}`));
+        } catch (e) {
+          console.log(chalk.yellow(`  \u26A0 Failed to create workspace: ${e.message}`));
+        }
+      }
+      try {
+        const configContent = fs.readFileSync(configPath, "utf8");
+        const config = yaml.load(configContent);
+        const relWsPath = path.relative(cwd, wsFilePath);
+        if (config.workspace !== relWsPath) {
+          if (config.workspace) {
+            const updated = configContent.replace(
+              /^workspace:\s*.*$/m,
+              `workspace: "${relWsPath}"`
+            );
+            fs.writeFileSync(configPath, updated, "utf8");
+          } else {
+            const updated = configContent.trimEnd() + `
+workspace: "${relWsPath}"
+`;
+            fs.writeFileSync(configPath, updated, "utf8");
+          }
+          console.log(chalk.green(`  \u2713 Linked workspace in config.yaml`));
+        }
+      } catch {
+      }
+    } else if (fs.existsSync(configPath)) {
       try {
         const configContent = fs.readFileSync(configPath, "utf8");
         const config = yaml.load(configContent);
@@ -167,6 +243,25 @@ workspace: "${relPath}"
   } else {
     spinner.succeed(chalk.gray("Step 3/6: Skipped scan (--quick mode)"));
   }
+  {
+    const configPath = path.join(paradigmDir, "config.yaml");
+    if (fs.existsSync(configPath)) {
+      try {
+        const configForWs = yaml.load(fs.readFileSync(configPath, "utf8"));
+        if (configForWs.workspace) {
+          spinner.start("Step 3b/6: Reindexing workspace members...");
+          try {
+            const { workspaceReindexCommand } = await import("./workspace-7CWY4IWV.js");
+            await workspaceReindexCommand({ quiet: true });
+            spinner.succeed(chalk.green("Workspace members reindexed"));
+          } catch (e) {
+            spinner.warn(chalk.yellow(`Workspace reindex: ${e.message}`));
+          }
+        }
+      } catch {
+      }
+    }
+  }
   const lorePath = path.join(cwd, ".paradigm", "lore");
   if (!fs.existsSync(lorePath)) {
     fs.mkdirSync(lorePath, { recursive: true });
@@ -232,6 +327,18 @@ workspace: "${relPath}"
     { path: ".claude/hooks/", desc: "Claude Code enforcement hooks", isDir: true, optional: true },
     { path: ".cursor/hooks/", desc: "Cursor enforcement hooks", isDir: true, optional: true }
   ];
+  const configPathForSummary = path.join(paradigmDir, "config.yaml");
+  if (fs.existsSync(configPathForSummary)) {
+    try {
+      const cfg = yaml.load(fs.readFileSync(configPathForSummary, "utf8"));
+      if (typeof cfg.workspace === "string") {
+        const wsAbsPath = path.resolve(cwd, cfg.workspace);
+        const wsRelPath = path.relative(cwd, wsAbsPath);
+        files.push({ path: wsRelPath, desc: "Multi-project workspace", optional: true });
+      }
+    } catch {
+    }
+  }
   for (const file of files) {
     const fullPath = path.join(cwd, file.path);
     if (fs.existsSync(fullPath)) {
@@ -251,10 +358,14 @@ workspace: "${relPath}"
   console.log("");
   console.log(chalk.white("  Next steps:"));
   console.log(chalk.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
-  console.log(chalk.white("  1. ") + chalk.gray("Edit ") + chalk.cyan(".purpose") + chalk.gray(" to define your features"));
-  console.log(chalk.white("  2. ") + chalk.gray("Create ") + chalk.cyan("portal.yaml") + chalk.gray(" if you have authorization"));
-  console.log(chalk.white("  3. ") + chalk.gray("Add ") + chalk.cyan(".purpose") + chalk.gray(" files to feature directories"));
-  console.log(chalk.white("  4. ") + chalk.gray("Run ") + chalk.cyan("paradigm shift --verify") + chalk.gray(" to check health"));
+  let nextStep = 1;
+  if (options.workspace) {
+    console.log(chalk.white(`  ${nextStep++}. `) + chalk.gray("Run ") + chalk.cyan(`paradigm shift --workspace "${options.workspace}"`) + chalk.gray(" in sibling projects"));
+  }
+  console.log(chalk.white(`  ${nextStep++}. `) + chalk.gray("Edit ") + chalk.cyan(".purpose") + chalk.gray(" to define your features"));
+  console.log(chalk.white(`  ${nextStep++}. `) + chalk.gray("Create ") + chalk.cyan("portal.yaml") + chalk.gray(" if you have authorization"));
+  console.log(chalk.white(`  ${nextStep++}. `) + chalk.gray("Add ") + chalk.cyan(".purpose") + chalk.gray(" files to feature directories"));
+  console.log(chalk.white(`  ${nextStep++}. `) + chalk.gray("Run ") + chalk.cyan("paradigm shift --verify") + chalk.gray(" to check health"));
   console.log("");
   tracker.success("Paradigm shift complete", { project: projectName });
 }

package/dist/{spawn-WGFJ5RQZ.js → spawn-7SDONTJN.js}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   AgentSpawner
-} from "./chunk-CP6IZGUN.js";
+} from "./chunk-JQYGPVLQ.js";
+import {
+  getBestProvider
+} from "./chunk-5N5LR2KS.js";
 import {
   loadAgentsManifest
 } from "./chunk-PMXRGPRQ.js";
 import "./chunk-PBHIFAL4.js";
-import {
-  getBestProvider
-} from "./chunk-5N5LR2KS.js";
 import {
   formatTokens
 } from "./chunk-5JGJACDU.js";

package/dist/{summary-E2PU4UN2.js → summary-F46FRO3Y.js}

@@ -7,7 +7,7 @@ import "./chunk-IRKUEJVW.js";
 import {
   detectIDE,
   getAdapter
-} from "./chunk-2QNZ6PVD.js";
+} from "./chunk-KB4XJWE3.js";
 import "./chunk-YO6DVTL7.js";
 import "./chunk-MO4EEYFW.js";
 

package/dist/{sync-5VJPZQNX.js → sync-4CNRHUWX.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   syncCommand
-} from "./chunk-QHJGB5TV.js";
-import "./chunk-2QNZ6PVD.js";
-import "./chunk-4NCFWYGG.js";
+} from "./chunk-RP6TZYGE.js";
+import "./chunk-KB4XJWE3.js";
 import "./chunk-YO6DVTL7.js";
+import "./chunk-4NCFWYGG.js";
 import "./chunk-MO4EEYFW.js";
 export {
   syncCommand

package/dist/{sync-llms-7QDA3ZWC.js → sync-llms-MCWB37HN.js}

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   loadParadigmFiles
-} from "./chunk-2QNZ6PVD.js";
+} from "./chunk-KB4XJWE3.js";
+import "./chunk-YO6DVTL7.js";
 import {
   log
 } from "./chunk-4NCFWYGG.js";
-import "./chunk-YO6DVTL7.js";
 import "./chunk-MO4EEYFW.js";
 
 // src/commands/sync-llms.ts

package/dist/{team-AFOKQ7YQ.js → team-XUZBPIFZ.js}

@@ -8,13 +8,13 @@ import {
   teamModelsCommand,
   teamResetCommand,
   teamStatusCommand
-} from "./chunk-3TWXFFZ3.js";
-import "./chunk-24AAVLME.js";
+} from "./chunk-4PEQHWD7.js";
+import "./chunk-CQFNTBFJ.js";
 import "./chunk-6QC3YGB6.js";
-import "./chunk-CP6IZGUN.js";
+import "./chunk-JQYGPVLQ.js";
+import "./chunk-5N5LR2KS.js";
 import "./chunk-PMXRGPRQ.js";
 import "./chunk-PBHIFAL4.js";
-import "./chunk-5N5LR2KS.js";
 import "./chunk-6P4IFIK2.js";
 import "./chunk-MRENOFTR.js";
 import "./chunk-IRKUEJVW.js";

package/dist/{upgrade-RBSE4M6I.js → upgrade-HGF4MBGV.js}

@@ -3,7 +3,7 @@ import {
   detectIDE,
   loadParadigmFiles,
   syncToIDE
-} from "./chunk-2QNZ6PVD.js";
+} from "./chunk-KB4XJWE3.js";
 import {
   parseParadigmConfig,
   serializeParadigmConfig

package/dist/{watch-PAEH6MOG.js → watch-CL2PPS2K.js}

@@ -3,7 +3,7 @@ import {
   detectIDE,
   loadParadigmFiles,
   syncToIDE
-} from "./chunk-2QNZ6PVD.js";
+} from "./chunk-KB4XJWE3.js";
 import "./chunk-YO6DVTL7.js";
 import "./chunk-MO4EEYFW.js";
 

package/dist/workspace-7CWY4IWV.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import {
+  detectProjectRole,
+  workspaceInitCommand,
+  workspaceReindexCommand,
+  workspaceStatusCommand
+} from "./chunk-C3BK3E23.js";
+import "./chunk-UI3XXVJ6.js";
+import "./chunk-AK5M6KJB.js";
+import "./chunk-6P4IFIK2.js";
+import "./chunk-MRENOFTR.js";
+import "./chunk-IRKUEJVW.js";
+import "./chunk-4NCFWYGG.js";
+import "./chunk-MO4EEYFW.js";
+export {
+  detectProjectRole,
+  workspaceInitCommand,
+  workspaceReindexCommand,
+  workspaceStatusCommand
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a-company/paradigm",
-  "version": "3.11.0",
+  "version": "3.12.0",
   "description": "Unified CLI for Paradigm developer tools",
   "type": "module",
   "main": "./dist/index.js",

package/dist/{chunk-CP6IZGUN.js → chunk-JQYGPVLQ.js}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
+import {
+  getProvider,
+  initializeProviders
+} from "./chunk-5N5LR2KS.js";
 import {
   loadAgentsManifest
 } from "./chunk-PMXRGPRQ.js";
 import {
   AuditLogger
 } from "./chunk-PBHIFAL4.js";
-import {
-  getProvider,
-  initializeProviders
-} from "./chunk-5N5LR2KS.js";
 import {
   calculateCost,
   formatCost,