@a-company/paradigm 3.46.0 → 5.4.0

package/dist/{chunk-KB4XJWE3.js → chunk-6N3JTACN.js}

@@ -10,11 +10,10 @@ import * as path6 from "path";
 // src/core/ide-adapters/cursor.ts
 import * as fs from "fs";
 import * as path from "path";
-import * as os2 from "os";
+import * as os from "os";
 import * as yaml from "js-yaml";
 
 // src/core/ide-adapters/base.ts
-import * as os from "os";
 function generateHeader(projectName, ideName) {
   const lines = [];
   lines.push(`# ${projectName} - Paradigm Context`);
@@ -218,43 +217,6 @@ function generateNavigationSection(_config) {
   lines.push("");
   return lines.join("\n");
 }
-function generateTerminalGuidance() {
-  const platform3 = os.platform();
-  const isWindows = platform3 === "win32";
-  const lines = [];
-  lines.push("## Terminal Syntax");
-  lines.push("");
-  if (isWindows) {
-    lines.push("This project runs on **Windows**. Use appropriate syntax:");
-    lines.push("");
-    lines.push("| Operation | Windows Syntax |");
-    lines.push("|-----------|----------------|");
-    lines.push("| Chain commands | `cmd1 ; cmd2` or `cmd1 && cmd2` (PowerShell) |");
-    lines.push("| Path separator | `\\` (backslash) |");
-    lines.push("| Environment vars | `$env:VAR` (PowerShell) or `%VAR%` (CMD) |");
-    lines.push("| Null device | `$null` (PowerShell) or `NUL` (CMD) |");
-    lines.push("| List files | `dir` or `Get-ChildItem` |");
-    lines.push("| Remove files | `del` or `Remove-Item` |");
-    lines.push("");
-    lines.push("**IMPORTANT:** Do NOT use Unix-style commands like `rm`, `cat`, `grep` directly.");
-  } else {
-    const osName = platform3 === "darwin" ? "macOS" : "Linux";
-    lines.push(`This project runs on **${osName}**. Use appropriate syntax:`);
-    lines.push("");
-    lines.push("| Operation | Unix Syntax |");
-    lines.push("|-----------|-------------|");
-    lines.push("| Chain commands | `cmd1 && cmd2` (stop on error) or `cmd1 ; cmd2` (always continue) |");
-    lines.push("| Path separator | `/` (forward slash) |");
-    lines.push("| Environment vars | `$VAR` or `${VAR}` |");
-    lines.push("| Null device | `/dev/null` |");
-    lines.push("| List files | `ls` |");
-    lines.push("| Remove files | `rm` |");
-    lines.push("");
-    lines.push("**IMPORTANT:** Do NOT use Windows-style commands like `dir`, `del`, or `%VAR%`.");
-  }
-  lines.push("");
-  return lines.join("\n");
-}
 function generateCommitConvention() {
   const lines = [];
   lines.push("## Commit Messages");
@@ -362,7 +324,7 @@ function generateHandoffProtocol() {
   lines.push("| Usage | Recommendation | Action |");
   lines.push("|-------|----------------|--------|");
   lines.push("| <50% | continue | Keep working |");
-  lines.push("| 50-70% | consider-handoff | Plan a stopping point |");
+  lines.push("| 50-70% | consider-handoff | Plan handoff; prepare summary when ready |");
   lines.push("| 70-85% | handoff-recommended | Prepare handoff soon |");
   lines.push("| >85% | handoff-urgent | Handoff after current task |");
   lines.push("");
@@ -474,41 +436,6 @@ 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("---");
@@ -943,7 +870,7 @@ This returns a recommendation: \`continue\`, \`consider-handoff\`, \`handoff-rec
 | Usage | Recommendation | Action |
 |-------|----------------|--------|
 | <50% | continue | Keep working |
-| 50-70% | consider-handoff | Plan stopping point |
+| 50-70% | consider-handoff | Plan handoff; prepare summary when ready |
 | 70-85% | handoff-recommended | Prepare handoff soon |
 | >85% | handoff-urgent | Handoff after current task |
 
@@ -1106,8 +1033,8 @@ If you find yourself doing any of these, STOP:
         }
       }
     }
-    const platform3 = os2.platform();
-    const isWindows = platform3 === "win32";
+    const platform2 = os.platform();
+    const isWindows = platform2 === "win32";
     const terminalGuidance = isWindows ? `## Terminal Syntax (Windows)
 
 This project runs on **Windows**. Use appropriate syntax:
@@ -1121,9 +1048,9 @@ This project runs on **Windows**. Use appropriate syntax:
 | List files | \`dir\` or \`Get-ChildItem\` |
 | Remove files | \`del\` or \`Remove-Item\` |
 
-**IMPORTANT:** Do NOT use Unix-style commands like \`rm\`, \`cat\`, \`grep\` directly.` : `## Terminal Syntax (${platform3 === "darwin" ? "macOS" : "Linux"})
+**IMPORTANT:** Do NOT use Unix-style commands like \`rm\`, \`cat\`, \`grep\` directly.` : `## Terminal Syntax (${platform2 === "darwin" ? "macOS" : "Linux"})
 
-This project runs on **${platform3 === "darwin" ? "macOS" : "Linux"}**. Use appropriate syntax:
+This project runs on **${platform2 === "darwin" ? "macOS" : "Linux"}**. Use appropriate syntax:
 
 | Operation | Unix Syntax |
 |-----------|-------------|
@@ -1736,19 +1663,6 @@ var ClaudeAdapter = class {
     sections.push(".paradigm/lore/        \u2192 Project timeline and history");
     sections.push("```");
     sections.push("");
-    sections.push(generateTerminalGuidance());
-    sections.push("## Agent Onboarding");
-    sections.push("");
-    sections.push("**First Session:**");
-    sections.push("1. Call `paradigm_status` for project overview");
-    sections.push("2. Read `.paradigm/config.yaml` for conventions");
-    sections.push("3. Check if `portal.yaml` exists (for auth gates)");
-    sections.push("");
-    sections.push("**Before Each Task:**");
-    sections.push("1. `paradigm_wisdom_context` for symbols you'll modify");
-    sections.push("2. `paradigm_ripple` to check impact");
-    sections.push("3. `paradigm_history_fragility` for stability warnings");
-    sections.push("");
     sections.push("## Symbol System");
     sections.push("");
     sections.push("Use these prefixes in documentation and commits:");
@@ -1763,197 +1677,86 @@ var ClaudeAdapter = class {
       }
     }
     sections.push("");
-    sections.push("## First Actions for New Sessions");
-    sections.push("");
-    sections.push("**Resuming a session:** Call `paradigm_session_recover` for previous session context.");
-    sections.push("");
-    sections.push("1. **Orient:** Call `paradigm_status` to see project overview and available symbols");
-    sections.push("2. **Verify:** Check `.paradigm/config.yaml` for discipline and conventions");
-    sections.push('3. **Locate:** Use `paradigm_navigate` with "context" intent for your task');
-    sections.push("4. **Review:** Read the nearest `.purpose` file before making changes");
-    sections.push("5. **Check:** Call `paradigm_gates_for_route` before adding API endpoints");
-    sections.push("");
-    sections.push("## Before Implementing (Every Task)");
-    sections.push("");
-    sections.push("1. **Is this task complex?** (3+ files, security + implementation, multiple features)");
-    sections.push('   \u2192 Call `paradigm_orchestrate_inline` with mode="plan" BEFORE writing code');
-    sections.push("2. **Does it affect existing symbols?** \u2192 Call `paradigm_ripple`");
-    sections.push("3. **Does it add API endpoints?** \u2192 Call `paradigm_gates_for_route`");
-    sections.push("");
-    sections.push("## Portal Protocol (Authorization)");
-    sections.push("");
-    sections.push("**Portal.yaml is REQUIRED when the project has protected routes.**");
-    sections.push("");
-    sections.push("### When to Create portal.yaml");
-    sections.push("");
-    sections.push("Create `portal.yaml` in project root when:");
-    sections.push("- Adding any endpoint that requires authentication");
-    sections.push("- Adding role-based access (admin, member, owner)");
-    sections.push("- Adding resource ownership checks (user can only edit their own data)");
-    sections.push("");
-    sections.push("### Portal.yaml Structure");
-    sections.push("");
-    sections.push("```yaml");
-    sections.push('version: "1.0"');
-    sections.push("gates:");
-    sections.push("  ^authenticated:");
-    sections.push("    description: User must be logged in");
-    sections.push("    check: req.user != null");
-    sections.push("  ^project-admin:");
-    sections.push("    description: User must be admin of the project");
-    sections.push("    check: project.admins.includes(req.user.id)");
-    sections.push("  ^comment-author:");
-    sections.push("    description: User must be the comment author");
-    sections.push("    check: comment.authorId === req.user.id");
-    sections.push("");
-    sections.push("routes:");
-    sections.push('  "GET /api/projects/:id": [^authenticated, ^project-member]');
-    sections.push('  "PUT /api/projects/:id": [^authenticated, ^project-admin]');
-    sections.push('  "DELETE /api/comments/:id": [^authenticated, ^comment-author]');
-    sections.push("```");
-    sections.push("");
-    sections.push("### When Adding New Endpoints");
-    sections.push("");
-    sections.push("**ALWAYS update portal.yaml when adding routes:**");
-    sections.push("");
-    sections.push("1. Call `paradigm_gates_for_route` to get suggestions");
-    sections.push("2. Add the route to portal.yaml with required gates");
-    sections.push("3. Implement the gate checks in your middleware/code");
-    sections.push("4. Test that unauthorized access returns 403");
-    sections.push("");
-    sections.push("### Common Gate Patterns");
-    sections.push("");
-    sections.push("| Pattern | Gate Name | Description |");
-    sections.push("|---------|-----------|-------------|");
-    sections.push("| Any logged-in user | `^authenticated` | Basic auth check |");
-    sections.push("| Resource membership | `^{resource}-member` | User is member of resource |");
-    sections.push("| Resource admin | `^{resource}-admin` | User is admin of resource |");
-    sections.push("| Resource owner | `^{resource}-owner` | User owns the resource |");
-    sections.push("| Author only | `^{resource}-author` | User created the resource |");
-    sections.push("");
-    sections.push("## Context Discovery");
-    sections.push("");
-    sections.push("**Before making changes:**");
-    sections.push("");
-    sections.push("1. Check `.paradigm/config.yaml` for project configuration");
-    sections.push("2. Read the `.purpose` file in the directory you're modifying");
-    sections.push("3. Check `portal.yaml` for existing auth gates");
-    sections.push("4. Check `.paradigm/docs/patterns.md` for coding patterns");
-    sections.push("");
-    sections.push("## Lore (Project Timeline)");
-    sections.push("");
-    sections.push("Lore records what happened, why, and what was learned \u2014 forming a queryable project history.");
-    sections.push("");
-    sections.push("### MCP Tools");
-    sections.push("");
-    sections.push("| Tool | Purpose |");
-    sections.push("|------|---------|");
-    sections.push("| `paradigm_lore_search` | Search and filter lore entries by author, symbol, date, type |");
-    sections.push("| `paradigm_lore_record` | Record a new lore entry (session, decision, milestone, etc.) |");
-    sections.push("| `paradigm_lore_timeline` | Get project timeline summary with entry count and authors |");
-    sections.push("");
-    sections.push("### CLI Commands");
-    sections.push("");
-    sections.push("| Command | Description |");
-    sections.push("|---------|-------------|");
-    sections.push("| `paradigm lore` | List recent lore entries |");
-    sections.push("| `paradigm lore record` | Interactively record a new entry |");
-    sections.push("| `paradigm lore show <id>` | Show full details of an entry |");
-    sections.push("| `paradigm lore review <id>` | Add human review to an entry |");
-    sections.push("| `paradigm lore timeline` | Show project timeline summary |");
-    sections.push("");
-    sections.push("### When to Record Lore");
-    sections.push("");
-    sections.push("- After completing a feature or significant session");
-    sections.push("- When making architectural decisions");
-    sections.push("- After resolving incidents or bugs");
-    sections.push("- At project milestones");
-    sections.push("");
-    sections.push(generateNavigationSection(config));
-    sections.push("## Context Monitoring Protocol");
-    sections.push("");
-    sections.push("**Periodically check context usage** by calling `paradigm_context_check` (every 10-15 tool calls or when user asks).");
-    sections.push("");
-    sections.push('**When recommendation is NOT "continue":**');
-    sections.push('1. Inform user: "Context usage is at ~X%. Recommend handoff soon."');
-    sections.push("2. Offer to prepare handoff summary");
-    sections.push("3. If urgent (>85%), prioritize completing current task then handoff");
-    sections.push("");
-    sections.push("**To handoff:**");
-    sections.push("1. Call `paradigm_handoff_prepare` with summary and next steps");
-    sections.push('2. User runs: `paradigm team handoff --to <agent> --summary "..."`');
-    sections.push("3. New session accepts with: `paradigm team accept <id>`");
-    sections.push("");
-    sections.push(generateCheckpointProtocol());
-    sections.push("## MCP Workflow Protocol");
+    const conventionsSection = generateConventions(config);
+    if (conventionsSection) {
+      sections.push(conventionsSection);
+    }
+    sections.push(generateCommitConvention());
+    sections.push("## Agent Onboarding");
     sections.push("");
-    sections.push("**Query before modifying** - Use MCP tools for token-efficient, fresh data:");
+    sections.push("**First session:** Call `paradigm_status` \u2192 read `.paradigm/config.yaml` \u2192 check `portal.yaml`");
     sections.push("");
-    sections.push("| Before doing this... | Call this tool |");
-    sections.push("|---------------------|----------------|");
-    sections.push("| Modifying a symbol | `paradigm_ripple` with the symbol |");
-    sections.push("| Understanding code | `paradigm_navigate` with explore intent |");
-    sections.push("| Checking dependencies | `paradigm_related` for connections |");
-    sections.push("| Getting oriented | `paradigm_status` for project overview |");
-    sections.push("| **Adding API endpoint** | `paradigm_gates_for_route` for auth gates |");
-    sections.push("| **Validating changes** | `paradigm_flows_affected` for flow impact |");
-    sections.push("| **Getting test data** | `paradigm_test_fixtures` for fixtures |");
-    sections.push('| **Building a feature (3+ files)** | `paradigm_orchestrate_inline` mode="plan" |');
-    sections.push('| **Task involves security + code** | `paradigm_orchestrate_inline` mode="plan" |');
-    sections.push("| **Recording work done** | `paradigm_lore_record` to capture session history |");
-    sections.push("| **Checking project history** | `paradigm_lore_timeline` for timeline overview |");
-    sections.push("| **Finishing work session** | `paradigm_reindex` to rebuild static index |");
+    sections.push("**Before each task:** `paradigm_ripple` for impact, `paradigm_gates_for_route` for new endpoints");
     sections.push("");
-    sections.push("**Benefits**: ~100 tokens per query vs ~2000 for reading files. Always fresh data from live index.");
+    sections.push("**Resuming:** Call `paradigm_session_recover`");
     sections.push("");
-    sections.push("**Authorization workflow:**");
-    sections.push("1. Adding endpoint? \u2192 Call `paradigm_gates_for_route`");
-    sections.push("2. Get suggested gates \u2192 Add them to `portal.yaml`");
-    sections.push("3. Implement gate checks \u2192 Test 403 responses");
+    sections.push("## Before Implementing");
     sections.push("");
-    sections.push("## Token Budget Reference");
+    sections.push("0. Call `paradigm_protocol_search` \u2014 if a protocol matches, follow it");
+    sections.push('1. Complex task (3+ files)? \u2192 `paradigm_orchestrate_inline` mode="plan"');
+    sections.push("2. Affects symbols? \u2192 `paradigm_ripple`");
+    sections.push("3. Adds endpoints? \u2192 `paradigm_gates_for_route`");
     sections.push("");
-    sections.push("| Operation | Typical Tokens | Use When |");
-    sections.push("|-----------|---------------|----------|");
-    sections.push("| `paradigm_status` | ~100 | Starting a session |");
-    sections.push("| `paradigm_search` | ~150 | Looking for symbols |");
-    sections.push("| `paradigm_navigate` | ~200 | Finding code locations |");
-    sections.push("| `paradigm_ripple` | ~300 | Before modifying symbols |");
-    sections.push("| `paradigm_gates_for_route` | ~150 | Adding API endpoints |");
-    sections.push("| File read (small) | ~500 | Need exact code |");
-    sections.push("| File read (large) | ~2000+ | Avoid if possible |");
-    sections.push("| Full .purpose + config | ~1500 | Initial orientation |");
+    sections.push("## Automatic Enforcement (Hooks)");
     sections.push("");
-    sections.push("**Tip**: Prefer MCP queries over file reads. Check `paradigm_session_stats` for actual usage.");
+    sections.push("The stop hook **BLOCKS** if source files were modified without .purpose updates.");
     sections.push("");
-    sections.push("### When to Use MCP vs File Reads");
+    sections.push("| Hook | Behavior |");
+    sections.push("|------|----------|");
+    sections.push("| **Stop** | Blocks on: missing .purpose, missing portal.yaml gates, aspect drift, stale purposes |");
+    sections.push("| **Pre-commit** | Auto-rebuilds index \u2014 never blocks |");
+    sections.push("| **Post-write** | Advisory reminder for .purpose coverage |");
     sections.push("");
-    sections.push("| Need | Use MCP | Use File Read |");
-    sections.push("|------|---------|---------------|");
-    sections.push("| Find symbol | `paradigm_navigate` | Never |");
-    sections.push("| Check impact | `paradigm_ripple` | Never |");
-    sections.push("| Read implementation | MCP first | Then specific file |");
-    sections.push("| Write code | N/A | Existing patterns |");
-    sections.push("| Check team wisdom | `paradigm_wisdom_context` | Never |");
+    sections.push("**If blocked:** Update .purpose files \u2192 update portal.yaml if needed \u2192 `paradigm_reindex` \u2192 finish");
     sections.push("");
-    sections.push("**Rule**: MCP for discovery, files for implementation.");
+    sections.push("## Maintaining Paradigm Files");
     sections.push("");
-    sections.push("## MCP Resources (On-Demand Content)");
+    sections.push("**You MUST update Paradigm files when making code changes:**");
     sections.push("");
-    sections.push("Reference content is served via MCP resources instead of being stored locally:");
+    sections.push("- Add feature \u2192 create `.purpose` in directory");
+    sections.push("- Add protected route \u2192 update `portal.yaml` with gates");
+    sections.push("- Add signal/event \u2192 add to `.purpose`");
+    sections.push("- Add multi-step flow \u2192 document as `$flow`");
+    sections.push("- Rename/delete symbol \u2192 update all references");
+    sections.push("- Record lore via `paradigm_lore_record` for sessions modifying 3+ files");
+    sections.push("- Use Paradigm logger (`log.component()`, `log.gate()`, etc.) \u2014 never raw console.log");
     sections.push("");
-    sections.push("| Resource | URI | Content |");
-    sections.push("|----------|-----|---------|");
-    sections.push("| Prompts | `paradigm://prompts` | Task templates (add-feature, refactor, etc.) |");
-    sections.push("| Commands | `paradigm://docs/commands` | CLI command reference |");
-    sections.push("| Queries | `paradigm://docs/queries` | jq query examples |");
-    sections.push("| Disciplines | `paradigm://specs/disciplines` | Symbol mappings by domain |");
-    sections.push("| Scan | `paradigm://specs/scan` | Visual discovery protocol |");
+    sections.push("**Auth requires portal.yaml** if your code has JWT, role checks, ownership checks, or protected endpoints.");
     sections.push("");
-    sections.push("**Usage**: Read resources with `paradigm://prompts/{name}` (e.g., `paradigm://prompts/add-feature`).");
+    sections.push("## On-Demand Guidance");
     sections.push("");
-    sections.push("**Session Tracking**: Call `paradigm_session_stats` to see token usage and cost breakdown.");
+    sections.push("Detailed guidance is available via MCP resources \u2014 load only what you need:");
     sections.push("");
+    sections.push("| Topic | Resource |");
+    sections.push("|-------|----------|");
+    sections.push("| Logging rules & directory mapping | `paradigm://guidance/logging` |");
+    sections.push("| Portal protocol & gate patterns | `paradigm://guidance/portal` |");
+    sections.push("| MCP workflow & token budgets | `paradigm://guidance/mcp-workflow` |");
+    sections.push("| Flow-first development | `paradigm://guidance/flows` |");
+    sections.push("| Multi-agent orchestration | `paradigm://guidance/orchestration` |");
+    sections.push("| Workspaces (multi-project) | `paradigm://guidance/workspaces` |");
+    sections.push("| University (knowledge base) | `paradigm://guidance/university` |");
+    sections.push("| Confidence calibration | `paradigm://guidance/calibration` |");
+    sections.push("| Session checkpoints | `paradigm://guidance/checkpoints` |");
+    sections.push("| Navigation & task recipes | `paradigm://guidance/navigation` |");
+    sections.push("| Component types & hierarchy | `paradigm://guidance/component-types` |");
+    sections.push("| Troubleshooting | `paradigm://guidance/troubleshooting` |");
+    sections.push("");
+    if (files.agents?.length) {
+      const highPriority = files.agents.flatMap(
+        (a) => (a.context?.contributions || []).filter((c) => c.priority === "high" && c.content).map((c) => ({ agent: a.id, section: c.section, content: c.content }))
+      );
+      if (highPriority.length > 0) {
+        sections.push("## Agent Contributions");
+        sections.push("");
+        for (const contrib of highPriority) {
+          sections.push(`### ${contrib.section} (${contrib.agent})`);
+          sections.push("");
+          sections.push(contrib.content);
+          sections.push("");
+        }
+      }
+    }
     if (config["purpose-required"]?.length) {
       sections.push("## Directory Structure");
       sections.push("");
@@ -1963,176 +1766,9 @@ var ClaudeAdapter = class {
       }
       sections.push("");
     }
-    const loggingSection = generateLoggingRules(config);
-    if (loggingSection) {
-      sections.push(loggingSection);
-    }
-    const conventionsSection = generateConventions(config);
-    if (conventionsSection) {
-      sections.push(conventionsSection);
-    }
-    const updateSection = generateUpdateRules(config);
-    if (updateSection) {
-      sections.push(updateSection);
-    }
-    sections.push("## Multi-Agent Orchestration");
-    sections.push("");
-    sections.push("Paradigm supports multi-agent orchestration via `paradigm team` commands:");
-    sections.push("");
-    sections.push("### Commands");
-    sections.push("");
-    sections.push("| Command | Description |");
-    sections.push("|---------|-------------|");
-    sections.push('| `paradigm team spawn <agent> --task "..."` | Spawn a single agent |');
-    sections.push('| `paradigm team orchestrate "task"` | AI orchestrator coordinates agents |');
-    sections.push('| `paradigm team orchestrate "task" --solo` | Single Claude mode (no splitting) |');
-    sections.push('| `paradigm team orchestrate "task" --compare` | A/B test solo vs faceted |');
-    sections.push('| `paradigm team agents suggest "task"` | Suggest agents based on task triggers |');
-    sections.push("| `paradigm team providers` | Show available providers |");
-    sections.push("| `paradigm team providers --set X` | Set preferred provider |");
-    sections.push("| `paradigm team models` | View/configure agent model assignments |");
-    sections.push("| `paradigm team models --refresh` | Re-discover models from environment |");
-    sections.push("");
-    sections.push("### Agent Suggestions");
-    sections.push("");
-    sections.push("Before orchestrating, you can preview which agents will be involved:");
-    sections.push("");
-    sections.push("```bash");
-    sections.push('paradigm team agents suggest "Add user authentication with JWT"');
-    sections.push("```");
-    sections.push("");
-    sections.push("Or via MCP (returns `suggestedAgents` in plan mode):");
-    sections.push("```");
-    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.**");
-    sections.push("");
-    sections.push("### When to Define Flows");
-    sections.push("");
-    sections.push("Create a flow ($symbol) when your feature:");
-    sections.push("- Has multiple authorization gates");
-    sections.push("- Spans multiple components or services");
-    sections.push("- Emits events that trigger other actions");
-    sections.push('- Needs clear documentation of the "happy path"');
-    sections.push("");
-    sections.push("### Flow Definition");
-    sections.push("");
-    sections.push("Define flows in `.paradigm/flows.yaml`:");
-    sections.push("");
-    sections.push("```yaml");
-    sections.push('version: "1.0"');
-    sections.push("flows:");
-    sections.push("  $task-creation:");
-    sections.push("    name: Task Creation Flow");
-    sections.push('    trigger: "POST /api/tasks"');
-    sections.push("    steps:");
-    sections.push("      - type: gate");
-    sections.push("        symbol: ^authenticated");
-    sections.push("      - type: gate");
-    sections.push("        symbol: ^project-member");
-    sections.push("      - type: action");
-    sections.push('        symbol: "#create-task"');
-    sections.push("      - type: signal");
-    sections.push('        symbol: "!task-created"');
-    sections.push('    successSignal: "!task-created"');
-    sections.push("```");
-    sections.push("");
-    sections.push("### Flow-First Protocol");
-    sections.push("");
-    sections.push("1. **Define the flow first** - What gates, actions, and signals?");
-    sections.push("2. **Validate** - Call `paradigm_flow_validate` to check completeness");
-    sections.push("3. **Implement** - Each step becomes a clear implementation target");
-    sections.push("");
-    sections.push("## Flow Validation");
-    sections.push("");
-    sections.push("**Validate flows before and after implementing:**");
-    sections.push("");
-    sections.push("```");
-    sections.push("# Validate specific flow");
-    sections.push('paradigm_flow_validate({ flowId: "$task-creation" })');
-    sections.push("");
-    sections.push("# Validate all flows");
-    sections.push("paradigm_flow_validate({})");
-    sections.push("");
-    sections.push("# Deep check (verify implementation exists)");
-    sections.push("paradigm_flow_validate({ checkImplementation: true })");
-    sections.push("```");
-    sections.push("");
-    sections.push("**After modifying symbols, check affected flows:**");
-    sections.push("");
-    sections.push("```");
-    sections.push("# Check what flows are affected by #tasks");
-    sections.push('paradigm_flows_affected({ symbol: "#tasks" })');
-    sections.push("```");
-    sections.push("");
-    sections.push(generateCommitConvention());
-    sections.push("## Automatic Enforcement (Claude Code Hooks)");
-    sections.push("");
-    sections.push("This project uses Claude Code hooks for paradigm compliance. These are installed");
-    sections.push("automatically via `paradigm shift` or `paradigm hooks install`.");
-    sections.push("");
-    sections.push("| Hook | Type | Behavior |");
-    sections.push("|------|------|----------|");
-    sections.push("| **Stop hook** | Stop | **BLOCKS** you from finishing if source files were modified without .purpose updates |");
-    sections.push("| **Pre-commit hook** | PreToolUse (Bash) | Auto-rebuilds index before `git commit` \u2014 never blocks |");
-    sections.push("| **Post-write hook** | PostToolUse (Edit/Write) | Advisory reminder when editing files without .purpose coverage |");
-    sections.push("");
-    sections.push("**If the Stop hook blocks you:**");
-    sections.push("1. Update the nearest `.purpose` file for each modified code area");
-    sections.push("2. Update `portal.yaml` if you added routes or gates");
-    sections.push("3. Call `paradigm_reindex` to rebuild the static index");
-    sections.push("4. Then finish your session");
-    sections.push("");
-    sections.push("## Troubleshooting");
-    sections.push("");
-    sections.push("| Issue | Solution |");
-    sections.push("|-------|----------|");
-    sections.push('| "Symbol not found" | Run `paradigm scan` to rebuild index |');
-    sections.push('| "Navigator not found" | Run `paradigm scan` to generate navigator.yaml |');
-    sections.push("| Empty search results | Check that .purpose files define symbols |");
-    sections.push("| High context usage | Call `paradigm_handoff_prepare` |");
-    sections.push("| Gate suggestions missing | Check that portal.yaml exists and defines gates |");
-    sections.push('| "Flow index not found" | Run `paradigm scan` and add flows to .purpose files |');
-    sections.push('| "Fixtures not found" | Create `.paradigm/fixtures.yaml` with test data |');
-    sections.push("");
-    sections.push("## Maintaining Paradigm Files");
-    sections.push("");
-    sections.push("**You MUST update Paradigm files when making code changes. The Stop hook will block you if you don't:**");
-    sections.push("");
-    sections.push("| Change Type | Action Required |");
-    sections.push("|-------------|-----------------|");
-    sections.push("| Add feature | Create `.purpose` in feature directory |");
-    sections.push("| Add ANY protected route | Create/update `portal.yaml` with gates |");
-    sections.push("| Add ownership check | Add `^{resource}-owner` gate to `portal.yaml` |");
-    sections.push("| Add role-based access | Add `^{role}` gate to `portal.yaml` |");
-    sections.push("| Add signal/event | Add to emitting feature's `.purpose` |");
-    sections.push("| Add multi-step flow | Document as `$flow` in `.purpose` |");
-    sections.push("| Rename/delete symbol | Update all `.purpose` references |");
-    sections.push("| Learn antipattern | Add to `.paradigm/wisdom/antipatterns.yaml` |");
-    sections.push("| Complete feature/session | Record lore entry via `paradigm_lore_record` |");
-    sections.push("");
-    sections.push("**CRITICAL: Authorization requires portal.yaml**");
-    sections.push("");
-    sections.push("If your code has ANY of these, `portal.yaml` MUST exist:");
-    sections.push("- JWT/session authentication");
-    sections.push("- Role checks (admin, member, etc.)");
-    sections.push("- Ownership checks (user can only edit own resources)");
-    sections.push("- Protected API endpoints");
-    sections.push("");
-    sections.push("**Validation**: Run `paradigm doctor` to check for inconsistencies.");
-    sections.push("");
-    sections.push("See `.paradigm/docs/ai-maintenance-protocol.md` for detailed guidance.");
-    sections.push("");
     sections.push("---");
     sections.push("");
-    sections.push("*See `.cursorrules` for IDE-specific instructions, `.paradigm/specs/` for detailed specifications.*");
+    sections.push("*See `.paradigm/specs/` for specifications. Run `paradigm sync` to regenerate.*");
     return sections.filter((s) => s !== void 0).join("\n");
   }
   /**
@@ -2368,6 +2004,30 @@ function loadParadigmFiles(rootDir) {
       }
     }
   }
+  let agents = void 0;
+  const agentsDir = path6.join(rootDir, ".paradigm", "agents");
+  if (fs6.existsSync(agentsDir)) {
+    try {
+      const agentFiles = fs6.readdirSync(agentsDir).filter((f) => f.endsWith(".agent"));
+      const loaded = [];
+      for (const file of agentFiles) {
+        try {
+          const content = fs6.readFileSync(path6.join(agentsDir, file), "utf8");
+          const profile = yaml2.load(content);
+          if (profile?.id) {
+            loaded.push({
+              id: profile.id,
+              role: profile.role,
+              context: profile.context
+            });
+          }
+        } catch {
+        }
+      }
+      if (loaded.length > 0) agents = loaded;
+    } catch {
+    }
+  }
   let workspace = void 0;
   const rawConfig = yaml2.load(fs6.readFileSync(configPath, "utf8"));
   const wsField = rawConfig.workspace;
@@ -2394,7 +2054,8 @@ function loadParadigmFiles(rootDir) {
     specs,
     docs,
     projectName: path6.basename(rootDir),
-    workspace
+    workspace,
+    agents
   };
 }
 function syncToIDE(rootDir, ideName, files, force = false) {