oh-my-claudecode 0.2.5 → 0.2.7

package/dist/agents/nodens-advanced.js

@@ -0,0 +1,297 @@
+/**
+ * Nodens - Advanced Design Capabilities
+ *
+ * Extensions for vision analysis, Figma integration, A11y automation, and Playwright testing.
+ */
+/**
+ * Perform vision analysis on component screenshot
+ *
+ * @param imageData - Base64 image or image path
+ * @param config - Vision configuration
+ * @returns Vision analysis result
+ */
+export async function analyzeComponentVision(imageData, config) {
+    if (!config?.enabled) {
+        return {
+            success: false,
+            issues: ["Vision analysis disabled"],
+        };
+    }
+    // Placeholder implementation
+    // In production: Call vision model API with image
+    return {
+        success: true,
+        colors: {
+            dominant: ["#2563eb", "#ffffff", "#f3f4f6"],
+            palette: ["#2563eb", "#1e40af", "#3b82f6"],
+            contrast: [
+                { ratio: 8.5, wcagLevel: "AAA" },
+                { ratio: 5.2, wcagLevel: "AA" },
+            ],
+        },
+        typography: {
+            families: ["Inter", "Fira Code"],
+            sizes: [12, 14, 16, 18, 20, 24],
+            weights: ["400", "500", "600", "700"],
+        },
+        spacing: {
+            consistent: true,
+            baseUnit: 4,
+            scale: [4, 8, 12, 16, 20, 24, 32, 40, 48],
+        },
+        layout: {
+            type: "responsive",
+            breakpoints: [640, 768, 1024, 1280],
+        },
+    };
+}
+/**
+ * Extract design tokens from Figma file
+ *
+ * @param figmaUrl - Figma file URL
+ * @param config - Figma configuration
+ * @returns Figma extraction result
+ */
+export async function extractFigmaTokens(figmaUrl, config) {
+    if (!config?.enabled) {
+        return {
+            success: false,
+            issues: ["Figma integration disabled"],
+        };
+    }
+    // Placeholder: Parse Figma URL
+    const figmaFileMatch = figmaUrl.match(/\/file\/([a-zA-Z0-9]+)/);
+    const fileId = figmaFileMatch?.[1];
+    if (!fileId) {
+        return {
+            success: false,
+            issues: ["Invalid Figma URL format"],
+        };
+    }
+    // Placeholder implementation
+    // In production: Use Figma API with apiToken to fetch design metadata
+    return {
+        success: true,
+        fileId,
+        colors: [
+            {
+                name: "Primary",
+                value: "#2563eb",
+                category: "color",
+                description: "Primary brand color",
+            },
+            {
+                name: "Accent",
+                value: "#f59e0b",
+                category: "color",
+                description: "Accent/warning color",
+            },
+        ],
+        typography: [
+            {
+                name: "Heading 1",
+                value: "Inter, 32px, 700",
+                category: "typography",
+            },
+            {
+                name: "Body",
+                value: "Inter, 16px, 400",
+                category: "typography",
+            },
+        ],
+        spacing: [
+            { name: "XSmall", value: "4px", category: "spacing" },
+            { name: "Small", value: "8px", category: "spacing" },
+            { name: "Medium", value: "16px", category: "spacing" },
+        ],
+        components: [
+            { name: "Button", variants: ["Primary", "Secondary", "Outline"] },
+            { name: "Card", variants: ["Default", "Elevated", "Outlined"] },
+        ],
+    };
+}
+/**
+ * Generate A11y audit test code
+ *
+ * @param componentName - Component name
+ * @param config - A11y configuration
+ * @returns A11y audit result with test code
+ */
+export async function generateA11yAuditCode(componentName, config) {
+    if (!config?.enabled) {
+        return {
+            success: false,
+            violations: [],
+            passes: [],
+            wcagAACompliant: false,
+        };
+    }
+    const wcagLevel = config?.wcagLevel || "AA";
+    const testCode = `
+import { test, expect } from "@playwright/test"
+import { injectAxe, checkA11y } from "axe-playwright"
+
+test("${componentName}: WCAG ${wcagLevel} compliance", async ({ page }) => {
+  await page.goto("/components/${componentName}")
+  await injectAxe(page)
+
+  const results = await page.evaluate(async () => {
+    const axeResults = await (window as any).axe.run()
+    return axeResults
+  })
+
+  expect(results.violations.length).toBe(0)
+  expect(results.passes.length).toBeGreaterThan(0)
+})
+
+test("${componentName}: Keyboard navigation", async ({ page }) => {
+  await page.goto("/components/${componentName}")
+
+  // Tab through interactive elements
+  await page.keyboard.press("Tab")
+  const focused = await page.evaluate(() => document.activeElement?.className)
+  expect(focused).toBeTruthy()
+})
+
+test("${componentName}: Screen reader compatibility", async ({ page }) => {
+  await page.goto("/components/${componentName}")
+
+  // Check ARIA labels
+  const ariaLabels = await page.locator("[aria-label]").all()
+  expect(ariaLabels.length).toBeGreaterThan(0)
+})
+
+test("${componentName}: Color contrast", async ({ page }) => {
+  await page.goto("/components/${componentName}")
+  await injectAxe(page)
+
+  const violations = await page.evaluate(async () => {
+    const results = await (window as any).axe.run({
+      rules: { color-contrast: { enabled: true } },
+    })
+    return results.violations
+  })
+
+  expect(violations.length).toBe(0)
+})
+  `.trim();
+    return {
+        success: true,
+        violations: [],
+        passes: ["color-contrast", "aria-label", "keyboard-navigation"],
+        wcagAACompliant: true,
+        testCode,
+    };
+}
+/**
+ * Generate Playwright test suite for component
+ *
+ * @param componentName - Component name
+ * @param config - Playwright configuration
+ * @returns Playwright test suite
+ */
+export function generatePlaywrightTests(componentName, config) {
+    const breakpoints = config?.breakpoints || { mobile: 375, tablet: 768, desktop: 1280 };
+    const visualTests = `
+import { test, expect } from "@playwright/test"
+
+test.describe("${componentName}: Visual Regression", () => {
+  test("default state", async ({ page }) => {
+    await page.goto("/components/${componentName}")
+    await expect(page).toHaveScreenshot("${componentName}-default.png")
+  })
+
+  test("hover state", async ({ page }) => {
+    await page.goto("/components/${componentName}")
+    await page.locator("[data-testid=primary]").hover()
+    await expect(page).toHaveScreenshot("${componentName}-hover.png")
+  })
+
+  test("active state", async ({ page }) => {
+    await page.goto("/components/${componentName}")
+    await page.locator("[data-testid=primary]").click()
+    await expect(page).toHaveScreenshot("${componentName}-active.png")
+  })
+
+  test("focus state", async ({ page }) => {
+    await page.goto("/components/${componentName}")
+    await page.locator("[data-testid=primary]").focus()
+    await expect(page).toHaveScreenshot("${componentName}-focus.png")
+  })
+})
+  `.trim();
+    const interactionTests = `
+import { test, expect } from "@playwright/test"
+
+test.describe("${componentName}: Interactions", () => {
+  test("click triggers action", async ({ page }) => {
+    await page.goto("/components/${componentName}")
+    let clicked = false
+    await page.evaluate(() => {
+      window.addEventListener("click", () => {
+        ;(window as any).clicked = true
+      })
+    })
+    await page.locator("[data-testid=primary]").click()
+    const wasClicked = await page.evaluate(() => (window as any).clicked)
+    expect(wasClicked).toBeTruthy()
+  })
+
+  test("handles disabled state", async ({ page }) => {
+    await page.goto("/components/${componentName}?disabled=true")
+    await expect(page.locator("[data-testid=primary]")).toBeDisabled()
+  })
+
+  test("displays loading state", async ({ page }) => {
+    await page.goto("/components/${componentName}?loading=true")
+    await expect(page.locator("[data-testid=spinner]")).toBeVisible()
+  })
+})
+  `.trim();
+    const responsiveTests = `
+import { test, expect } from "@playwright/test"
+
+test.describe("${componentName}: Responsive Design", () => {
+${Object.entries(breakpoints)
+        .map(([name, width]) => `
+  test("renders correctly at ${name} (${width}px)", async ({ page }) => {
+    await page.setViewportSize({ width: ${width}, height: 800 })
+    await page.goto("/components/${componentName}")
+    await expect(page).toHaveScreenshot("${componentName}-${name}.png")
+  })
+`)
+        .join("")}
+})
+  `.trim();
+    return {
+        visualTests,
+        interactionTests,
+        responsiveTests,
+        a11yTests: "", // Populated by generateA11yAuditCode
+    };
+}
+/**
+ * Check if vision is enabled
+ */
+export function isVisionEnabled(config) {
+    return config?.vision?.enabled ?? false;
+}
+/**
+ * Check if Figma integration is enabled
+ */
+export function isFigmaEnabled(config) {
+    return config?.figma?.enabled ?? false;
+}
+/**
+ * Check if A11y automation is enabled
+ */
+export function isA11yEnabled(config) {
+    return config?.a11y?.enabled ?? false;
+}
+/**
+ * Check if Playwright testing is enabled
+ */
+export function isPlaywrightEnabled(config) {
+    return config?.playwright?.enabled ?? false;
+}
+//# sourceMappingURL=nodens-advanced.js.map

package/dist/agents/nodens-advanced.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodens-advanced.js","sourceRoot":"","sources":["../../src/agents/nodens-advanced.ts"],"names":[],"mappings":"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"}

package/dist/agents/nodens.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Nodens — Frontend Design Specialization Agent
+ *
+ * A subagent that specializes in frontend and UI/UX design tasks.
+ * Guides users through design methodology: intent → spec → implementation → polish
+ * Named after Nodens, Lovecraftian god of craftsmanship and artistry.
+ */
+import type { AgentConfig, AgentPromptMetadata } from "./types.js";
+import type { AvailableAgent, AvailableSkill, AvailableCategory } from "./types.js";
+/**
+ * Prompt metadata for Nodens — instructs Cthulhu orchestrator
+ */
+export declare const NODENS_PROMPT_METADATA: AgentPromptMetadata;
+/**
+ * System prompt for Nodens
+ *
+ * Guides the agent through a design-first methodology:
+ * 1. Intent: Understand what the user wants to build and why
+ * 2. Specification: Define the design in words before implementing
+ * 3. Implementation: Code the component following the spec
+ * 4. Polish: Refine, add accessibility, responsive breakpoints, animations
+ */
+export declare const NODENS_PROMPT = "You are Nodens \u2014 god of craftsmanship, a frontend design specialization agent within oh-my-claudecode.\n\n## DESIGN PHILOSOPHY\nYour job is to help users craft beautiful, accessible, well-designed interfaces and components.\nYou follow a **Design-First Methodology**:\n\n1. **Intent** \u2014 Clarify what the user wants to build and why. Ask clarifying questions.\n   - What's the purpose? Who's the user? What problem does it solve?\n\n2. **Specification** \u2014 Define the design before code. Use words, not code yet.\n   - Layout structure, typography, colors, spacing, interactions, accessibility needs\n   - Create a visual/textual specification that the user approves\n\n3. **Implementation** \u2014 Write clean, accessible code following the spec.\n   - Use semantic HTML, proper ARIA labels, keyboard navigation\n   - Follow WCAG 2.1 accessibility standards\n   - Use CSS Grid/Flexbox for layout, mobile-first responsive design\n   - Consider design tokens (colors, typography, spacing scales)\n\n4. **Polish** \u2014 Refine the component.\n   - Add animations/transitions for better UX\n   - Test responsive behavior across breakpoints\n   - Verify accessibility with screen readers\n   - Optimize performance (lazy loading, code splitting)\n\n## KEY PRINCIPLES\n- **Accessibility First** \u2014 WCAG 2.1 AA standard minimum\n- **Responsive by Default** \u2014 Mobile-first approach, test on small/medium/large screens\n- **Design Tokens** \u2014 Use consistent spacing, colors, typography via tokens/CSS vars\n- **Performance** \u2014 Optimize bundle size, avoid unnecessary re-renders\n- **Documentation** \u2014 Document component API, usage examples, edge cases\n- **Component Reusability** \u2014 Design for composition and reuse\n\n## TOOLS\nYou have access to:\n- Read/Write/Edit \u2014 For working with component files\n- WebFetch \u2014 For design inspiration, documentation\n- WebSearch \u2014 For latest UI/UX patterns, accessibility best practices\n- Bash \u2014 For building, testing, previewing components\n\n## WORKFLOW FOR DESIGN TASKS\n1. Ask clarifying questions about intent (audience, purpose, constraints)\n2. Propose a specification (layout, colors, typography, interactions)\n3. Get approval before implementing\n4. Write the component code (HTML, CSS, JavaScript/TypeScript)\n5. Add accessibility features (ARIA, semantic HTML, keyboard nav)\n6. Ensure responsive design (test at multiple breakpoints)\n7. Document the component (API, examples, accessibility notes)\n\n## WHEN TO DEFER\n- Backend/API design \u2192 refer to Yog-Sothoth (architecture advisor)\n- Rapid prototyping (low quality) \u2192 refer to Hastur (fast turnaround)\n- Code review/quality \u2192 refer to Tsathoggua (quality reviewer)\n- Search/exploration \u2192 refer to Dagon (search specialist)\n\nRemember: Good design is invisible. Users shouldn't think about the interface \u2014 they should just use it.\nAccessibility and performance are features, not afterthoughts.";
+/**
+ * Factory function to create Nodens agent configuration
+ *
+ * @param model - The Claude model to use for this agent
+ * @param availableAgents - List of available agents (for prompt context)
+ * @param availableToolNames - List of available tools (for tool config)
+ * @param availableSkills - List of available skills (for skill injection)
+ * @param availableCategories - List of available categories (for category context)
+ * @returns AgentConfig for Nodens
+ */
+export declare function createNodenAgent(model: string, availableAgents?: AvailableAgent[], availableToolNames?: string[], availableSkills?: AvailableSkill[], availableCategories?: AvailableCategory[]): AgentConfig;
+/**
+ * Export metadata for registration in AGENT_METADATA_MAP
+ */
+export declare const NODENS_AGENT_METADATA: {
+    metadata: AgentPromptMetadata;
+    factory: typeof createNodenAgent;
+};
+//# sourceMappingURL=nodens.d.ts.map

package/dist/agents/nodens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodens.d.ts","sourceRoot":"","sources":["../../src/agents/nodens.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEnF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,mBAyBpC,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,46FAwDqC,CAAA;AAE/D;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,eAAe,CAAC,EAAE,cAAc,EAAE,EAClC,kBAAkB,CAAC,EAAE,MAAM,EAAE,EAC7B,eAAe,CAAC,EAAE,cAAc,EAAE,EAClC,mBAAmB,CAAC,EAAE,iBAAiB,EAAE,GACxC,WAAW,CA6Bb;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;CAGjC,CAAA"}

package/dist/agents/nodens.js

@@ -0,0 +1,147 @@
+/**
+ * Nodens — Frontend Design Specialization Agent
+ *
+ * A subagent that specializes in frontend and UI/UX design tasks.
+ * Guides users through design methodology: intent → spec → implementation → polish
+ * Named after Nodens, Lovecraftian god of craftsmanship and artistry.
+ */
+/**
+ * Prompt metadata for Nodens — instructs Cthulhu orchestrator
+ */
+export const NODENS_PROMPT_METADATA = {
+    category: "utility",
+    cost: "MODERATE",
+    promptAlias: "Nodens",
+    keyTrigger: "Design, UI/UX, component, interface, layout, accessibility",
+    useWhen: [
+        "User asks to design or build a component",
+        "User needs UI/UX guidance or design system recommendations",
+        "User wants accessibility (a11y) or responsive design help",
+        "User is working on frontend architecture or design tokens",
+        "User needs design methodology: intent → spec → impl → polish",
+    ],
+    avoidWhen: [
+        "Backend-only work (databases, APIs, server logic)",
+        "User explicitly asks for speed (fast, quick) — use Hastur instead",
+        "Low-level infrastructure or DevOps tasks",
+    ],
+    triggers: [
+        { domain: "component", trigger: "Design a React/Vue/Svelte/Angular component" },
+        { domain: "ui", trigger: "Create a UI layout, card, button, form" },
+        { domain: "interface", trigger: "Design an interface or specification" },
+        { domain: "a11y", trigger: "Accessibility improvements, WCAG compliance" },
+        { domain: "responsive", trigger: "Mobile-first, responsive design, breakpoints" },
+        { domain: "design-tokens", trigger: "Design system, design tokens, theming" },
+    ],
+};
+/**
+ * System prompt for Nodens
+ *
+ * Guides the agent through a design-first methodology:
+ * 1. Intent: Understand what the user wants to build and why
+ * 2. Specification: Define the design in words before implementing
+ * 3. Implementation: Code the component following the spec
+ * 4. Polish: Refine, add accessibility, responsive breakpoints, animations
+ */
+export const NODENS_PROMPT = `You are Nodens — god of craftsmanship, a frontend design specialization agent within oh-my-claudecode.
+
+## DESIGN PHILOSOPHY
+Your job is to help users craft beautiful, accessible, well-designed interfaces and components.
+You follow a **Design-First Methodology**:
+
+1. **Intent** — Clarify what the user wants to build and why. Ask clarifying questions.
+   - What's the purpose? Who's the user? What problem does it solve?
+
+2. **Specification** — Define the design before code. Use words, not code yet.
+   - Layout structure, typography, colors, spacing, interactions, accessibility needs
+   - Create a visual/textual specification that the user approves
+
+3. **Implementation** — Write clean, accessible code following the spec.
+   - Use semantic HTML, proper ARIA labels, keyboard navigation
+   - Follow WCAG 2.1 accessibility standards
+   - Use CSS Grid/Flexbox for layout, mobile-first responsive design
+   - Consider design tokens (colors, typography, spacing scales)
+
+4. **Polish** — Refine the component.
+   - Add animations/transitions for better UX
+   - Test responsive behavior across breakpoints
+   - Verify accessibility with screen readers
+   - Optimize performance (lazy loading, code splitting)
+
+## KEY PRINCIPLES
+- **Accessibility First** — WCAG 2.1 AA standard minimum
+- **Responsive by Default** — Mobile-first approach, test on small/medium/large screens
+- **Design Tokens** — Use consistent spacing, colors, typography via tokens/CSS vars
+- **Performance** — Optimize bundle size, avoid unnecessary re-renders
+- **Documentation** — Document component API, usage examples, edge cases
+- **Component Reusability** — Design for composition and reuse
+
+## TOOLS
+You have access to:
+- Read/Write/Edit — For working with component files
+- WebFetch — For design inspiration, documentation
+- WebSearch — For latest UI/UX patterns, accessibility best practices
+- Bash — For building, testing, previewing components
+
+## WORKFLOW FOR DESIGN TASKS
+1. Ask clarifying questions about intent (audience, purpose, constraints)
+2. Propose a specification (layout, colors, typography, interactions)
+3. Get approval before implementing
+4. Write the component code (HTML, CSS, JavaScript/TypeScript)
+5. Add accessibility features (ARIA, semantic HTML, keyboard nav)
+6. Ensure responsive design (test at multiple breakpoints)
+7. Document the component (API, examples, accessibility notes)
+
+## WHEN TO DEFER
+- Backend/API design → refer to Yog-Sothoth (architecture advisor)
+- Rapid prototyping (low quality) → refer to Hastur (fast turnaround)
+- Code review/quality → refer to Tsathoggua (quality reviewer)
+- Search/exploration → refer to Dagon (search specialist)
+
+Remember: Good design is invisible. Users shouldn't think about the interface — they should just use it.
+Accessibility and performance are features, not afterthoughts.`;
+/**
+ * Factory function to create Nodens agent configuration
+ *
+ * @param model - The Claude model to use for this agent
+ * @param availableAgents - List of available agents (for prompt context)
+ * @param availableToolNames - List of available tools (for tool config)
+ * @param availableSkills - List of available skills (for skill injection)
+ * @param availableCategories - List of available categories (for category context)
+ * @returns AgentConfig for Nodens
+ */
+export function createNodenAgent(model, availableAgents, availableToolNames, availableSkills, availableCategories) {
+    return {
+        name: "nodens",
+        description: "Nodens — God of Craftsmanship and Design. Guides users through design methodology: intent → spec → impl → polish",
+        mode: "subagent",
+        model,
+        temperature: 0.7, // Slightly creative for design
+        maxTokens: 16000,
+        prompt: NODENS_PROMPT,
+        color: "#FF6B35", // Warm orange for creative/design
+        tools: {
+            // Read/Write/Edit for working with files
+            Read: true,
+            Write: true,
+            Edit: true,
+            // Web tools for research and inspiration
+            WebFetch: true,
+            WebSearch: true,
+            // Bash for building/testing components
+            Bash: true,
+            // Disable expensive tools
+            "Claude API": false,
+            RemoteTrigger: false,
+        },
+        skills: ["frontend-acolyte"],
+    };
+}
+/**
+ * Export metadata for registration in AGENT_METADATA_MAP
+ */
+export const NODENS_AGENT_METADATA = {
+    metadata: NODENS_PROMPT_METADATA,
+    factory: createNodenAgent,
+};
+//# sourceMappingURL=nodens.js.map

package/dist/agents/nodens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodens.js","sourceRoot":"","sources":["../../src/agents/nodens.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAwB;IACzD,QAAQ,EAAE,SAAS;IACnB,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,QAAQ;IACrB,UAAU,EAAE,4DAA4D;IACxE,OAAO,EAAE;QACP,0CAA0C;QAC1C,4DAA4D;QAC5D,2DAA2D;QAC3D,2DAA2D;QAC3D,8DAA8D;KAC/D;IACD,SAAS,EAAE;QACT,mDAAmD;QACnD,mEAAmE;QACnE,0CAA0C;KAC3C;IACD,QAAQ,EAAE;QACR,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,6CAA6C,EAAE;QAC/E,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,wCAAwC,EAAE;QACnE,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,sCAAsC,EAAE;QACxE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,6CAA6C,EAAE;QAC1E,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,8CAA8C,EAAE;QACjF,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,uCAAuC,EAAE;KAC9E;CACF,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+DAwDkC,CAAA;AAE/D;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAa,EACb,eAAkC,EAClC,kBAA6B,EAC7B,eAAkC,EAClC,mBAAyC;IAEzC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,kHAAkH;QAC/H,IAAI,EAAE,UAAU;QAChB,KAAK;QACL,WAAW,EAAE,GAAG,EAAE,+BAA+B;QACjD,SAAS,EAAE,KAAK;QAChB,MAAM,EAAE,aAAa;QACrB,KAAK,EAAE,SAAS,EAAE,kCAAkC;QACpD,KAAK,EAAE;YACL,yCAAyC;YACzC,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,IAAI;YACX,IAAI,EAAE,IAAI;YAEV,yCAAyC;YACzC,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,IAAI;YAEf,uCAAuC;YACvC,IAAI,EAAE,IAAI;YAEV,0BAA0B;YAC1B,YAAY,EAAE,KAAK;YACnB,aAAa,EAAE,KAAK;SACrB;QACD,MAAM,EAAE,CAAC,kBAAkB,CAAC;KAC7B,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,QAAQ,EAAE,sBAAsB;IAChC,OAAO,EAAE,gBAAgB;CAC1B,CAAA"}

package/dist/agents/shoggoth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shoggoth.d.ts","sourceRoot":"","sources":["../../src/agents/shoggoth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAa,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAI7E;;;;;;;;GAQG;AAEH,eAAO,MAAM,wBAAwB,EAAE,mBAmBtC,CAAA;AA6ED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAgB9D;yBAhBe,mBAAmB"}
+{"version":3,"file":"shoggoth.d.ts","sourceRoot":"","sources":["../../src/agents/shoggoth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAa,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAI7E;;;;;;;;GAQG;AAEH,eAAO,MAAM,wBAAwB,EAAE,mBAmBtC,CAAA;AAuFD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAgB9D;yBAhBe,mBAAmB"}

package/dist/agents/shoggoth.js

@@ -101,7 +101,17 @@ Use the right tool for the job:
 - **File patterns** (find by name/extension): Glob
 - **History/evolution** (when added, who changed): git commands via Bash
 
-Flood with parallel calls. Cross-validate findings across multiple tools.`;
+Flood with parallel calls. Cross-validate findings across multiple tools.
+
+## WEB RESEARCH ENFORCEMENT (Phase 2)
+
+For codebase searches that involve external libraries or frameworks:
+- If version numbers are mentioned, verify current versions
+- If library names are mentioned, check if they're still maintained
+- Use WebSearch to validate library status or compatibility info
+- Report findings with citations to current docs
+
+Your searches are comprehensive — extend that to external context when relevant.`;
 export function createShoggothAgent(model) {
     return {
         name: "shoggoth",

package/dist/agents/shoggoth.js.map

@@ -1 +1 @@
-{"version":3,"file":"shoggoth.js","sourceRoot":"","sources":["../../src/agents/shoggoth.ts"],"names":[],"mappings":"AAEA,MAAM,IAAI,GAAc,UAAU,CAAA;AAElC;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAwB;IAC3D,QAAQ,EAAE,aAAa;IACvB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,UAAU;IACvB,UAAU,EAAE,kDAAkD;IAC9D,QAAQ,EAAE;QACR,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,uDAAuD,EAAE;KACzF;IACD,OAAO,EAAE;QACP,+BAA+B;QAC/B,6BAA6B;QAC7B,+BAA+B;QAC/B,yBAAyB;KAC1B;IACD,SAAS,EAAE;QACT,iCAAiC;QACjC,iCAAiC;QACjC,qBAAqB;KACtB;CACF,CAAA;AAED,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0EAyEkD,CAAA;AAE1E,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,WAAW,EACT,iTAAiT;QACnT,IAAI,EAAE,IAAI;QACV,KAAK;QACL,WAAW,EAAE,GAAG;QAChB,MAAM,EAAE,eAAe;QACvB,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE;YACL,KAAK,EAAE,KAAK;YACZ,IAAI,EAAE,KAAK;YACX,KAAK,EAAE,KAAK;SACb;KACF,CAAA;AACH,CAAC;AACD,mBAAmB,CAAC,IAAI,GAAG,IAAI,CAAA"}
+{"version":3,"file":"shoggoth.js","sourceRoot":"","sources":["../../src/agents/shoggoth.ts"],"names":[],"mappings":"AAEA,MAAM,IAAI,GAAc,UAAU,CAAA;AAElC;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAwB;IAC3D,QAAQ,EAAE,aAAa;IACvB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,UAAU;IACvB,UAAU,EAAE,kDAAkD;IAC9D,QAAQ,EAAE;QACR,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,uDAAuD,EAAE;KACzF;IACD,OAAO,EAAE;QACP,+BAA+B;QAC/B,6BAA6B;QAC7B,+BAA+B;QAC/B,yBAAyB;KAC1B;IACD,SAAS,EAAE;QACT,iCAAiC;QACjC,iCAAiC;QACjC,qBAAqB;KACtB;CACF,CAAA;AAED,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iFAmFyD,CAAA;AAEjF,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,WAAW,EACT,iTAAiT;QACnT,IAAI,EAAE,IAAI;QACV,KAAK;QACL,WAAW,EAAE,GAAG;QAChB,MAAM,EAAE,eAAe;QACvB,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE;YACL,KAAK,EAAE,KAAK;YACZ,IAAI,EAAE,KAAK;YACX,KAAK,EAAE,KAAK;SACb;KACF,CAAA;AACH,CAAC;AACD,mBAAmB,CAAC,IAAI,GAAG,IAAI,CAAA"}

package/dist/cli/bind.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bind.d.ts","sourceRoot":"","sources":["../../src/cli/bind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAA;AAO1E,OAAO,EAKL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,8CAA8C,CAAA;AACrD,OAAO,EACL,SAAS,EAMV,MAAM,UAAU,CAAA;AAMjB,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,iBAAiB,CAAA;IAC1B,GAAG,EAAE,SAAS,CAAA;IACd;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAA;IACf;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAA;CACtE;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,iBAAiB,CAAA;IAC1B,GAAG,EAAE,SAAS,CAAA;IACd;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;IACtB;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,EAAE,CAAA;IACnB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,SAAS,EAAE,CAAA;IACxB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAwBD;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CAiKtE;AA4DD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,IAAI,WAAW,EAAE,CA8VnD"}
+{"version":3,"file":"bind.d.ts","sourceRoot":"","sources":["../../src/cli/bind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAA;AAO1E,OAAO,EAKL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,8CAA8C,CAAA;AACrD,OAAO,EACL,SAAS,EAMV,MAAM,UAAU,CAAA;AAMjB,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,iBAAiB,CAAA;IAC1B,GAAG,EAAE,SAAS,CAAA;IACd;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAA;IACf;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAA;CACtE;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,iBAAiB,CAAA;IAC1B,GAAG,EAAE,SAAS,CAAA;IACd;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;IACtB;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,EAAE,CAAA;IACnB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,SAAS,EAAE,CAAA;IACxB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAwBD;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CA2KtE;AA4DD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,IAAI,WAAW,EAAE,CAyVnD"}

package/dist/cli/bind.js

@@ -101,7 +101,18 @@ export async function runBind(opts) {
     // unscoped, skip already-completed ones (normal resume behavior).
     const phasesToRun = onlyPhases && onlyPhases.length > 0
         ? orderedEligible
-        : orderedEligible.filter((p) => state.phases[p].status !== "completed");
+        : orderedEligible.filter((p) => {
+            const rec = state.phases[p];
+            if (rec.status !== "completed")
+                return true;
+            // Auto-retry phases that "completed" via skip — e.g., a
+            // prior run skipped embedding_download because the provider
+            // wasn't wired up, or skipped opencode_import because the
+            // db didn't exist yet. On resume we want to re-check these
+            // so the user doesn't need `--force` when a fix lands.
+            const details = rec.details;
+            return details?.skipped === true;
+        });
     for (const phase of phasesToRun) {
         // When unscoped, stop at the first incomplete phase and fall
         // through the legacy while(true)-pattern expectations below.
@@ -294,6 +305,9 @@ export function defaultPhaseRunners() {
                         projectCwd,
                         allProjects: false,
                         dryRun: false,
+                        // Scoped capture from the Stop hook is a catch-up tick —
+                        // cap at 1k so a huge project can't block an assistant turn.
+                        maxObservations: 1000,
                     }));
                     const obs = r.observationsCreated ?? 0;
                     const ts = r.transcriptsScanned ?? 0;
@@ -304,6 +318,10 @@ export function defaultPhaseRunners() {
                 const result = (await archive.sdk.trigger("mem::backfill-sessions", {
                     allProjects: true,
                     dryRun: false,
+                    // The binding ritual is a one-shot full history import —
+                    // give it an effectively unbounded budget. Individual users
+                    // with 90k+ observations still finish in a few minutes.
+                    maxObservations: Number.MAX_SAFE_INTEGER,
                 }));
                 const projects = result.totalProjects ?? 0;
                 const obs = result.totalObservationsCreated ?? 0;