feat(vibe): add per‑vibe dependenciesUserOverride flag; persist with Libraries chooser; gate prompt module selection on override\n\n- Extend VibeDocument with dependenciesUserOverride:boolean\n- AppSettings: saving Libraries sets override=true and persists via useSession\n- useSession.updateDependencies now normalizes (validate, de‑dupe, canonical order) and saves flag\n- prompts: when override=true use saved deps; otherwise use deterministic DEFAULT_DEPENDENCIES (picker bypass pending clarification)\n- tests: update UI + prompt tests for override gating and keep defaults for non‑override path\n- use ALLOWED_DEPENDENCY_NAMES as single source of truth

Author: CharlieHelps

app/components/ResultPreview/AppSettingsView.tsx

@@ -6,7 +6,8 @@ type AppSettingsViewProps = {
   onUpdateTitle: (next: string, isManual?: boolean) => Promise<void> | void;
   onDownloadHtml: () => void;
   selectedDependencies?: string[];
-  onUpdateDependencies: (deps: string[]) => Promise<void> | void;
+  // When saving a manual selection, we set `userOverride` true
+  onUpdateDependencies: (deps: string[], userOverride: boolean) => Promise<void> | void;
 };
 
 const AppSettingsView: React.FC<AppSettingsViewProps> = ({
@@ -89,7 +90,7 @@ const AppSettingsView: React.FC<AppSettingsViewProps> = ({
     setSaveDepsErr(null);
     try {
       const valid = deps.filter((n) => allowedNames.has(n));
-      await onUpdateDependencies(valid.length ? valid : DEFAULT_DEPENDENCIES);
+      await onUpdateDependencies(valid.length ? valid : DEFAULT_DEPENDENCIES, true);
       setHasUnsavedDeps(false);
       setSaveDepsOk(true);
       setTimeout(() => setSaveDepsOk(false), 2000);

app/hooks/useSession.ts

@@ -8,7 +8,7 @@ import type {
 import { getSessionDatabaseName } from '../utils/databaseManager';
 import { useLazyFireproof } from './useLazyFireproof';
 import { encodeTitle } from '../components/SessionSidebar/utils';
-import { llmsCatalog } from '../llms/catalog';
+import { ALLOWED_DEPENDENCY_NAMES, llmsCatalog } from '../llms/catalog';
 
 export function useSession(routedSessionId?: string) {
   const [generatedSessionId] = useState(
@@ -138,14 +138,22 @@ export function useSession(routedSessionId?: string) {
 
   // Update per‑vibe dependency selection using the vibe document
   const updateDependencies = useCallback(
-    async (deps: string[]) => {
-      const allowed = new Set(llmsCatalog.map((l) => l.name));
-      const validDeps = (Array.isArray(deps) ? deps : [])
-        .filter((n): n is string => typeof n === 'string')
-        .filter((n) => allowed.has(n));
+    async (deps: string[], userOverride: boolean = true) => {
+      const input = Array.isArray(deps)
+        ? deps.filter((n): n is string => typeof n === 'string')
+        : [];
+      // Validate and de‑dupe by allowed names
+      const deduped = Array.from(new Set(input.filter((n) => ALLOWED_DEPENDENCY_NAMES.has(n))));
+      // Canonicalize order by catalog order
+      const order = new Map(llmsCatalog.map((l, i) => [l.name, i] as const));
+      const validDeps = deduped.sort((a, b) => order.get(a)! - order.get(b)!);
 
       const base = vibeRef.current;
-      const updatedDoc = { ...base, dependencies: validDeps } as VibeDocument;
+      const updatedDoc = {
+        ...base,
+        dependencies: validDeps,
+        dependenciesUserOverride: !!userOverride,
+      } as VibeDocument;
       mergeRef.current(updatedDoc);
       await sessionDatabase.put(updatedDoc);
     },

app/prompts.ts

@@ -2,7 +2,12 @@
 import callaiTxt from './llms/callai.txt?raw';
 import fireproofTxt from './llms/fireproof.txt?raw';
 import imageGenTxt from './llms/image-gen.txt?raw';
-import { DEFAULT_DEPENDENCIES, llmsCatalog, type LlmsCatalogEntry } from './llms/catalog';
+import {
+  DEFAULT_DEPENDENCIES,
+  llmsCatalog,
+  type LlmsCatalogEntry,
+  ALLOWED_DEPENDENCY_NAMES,
+} from './llms/catalog';
 
 // Static mapping of LLM text content
 const llmsTextContent: Record<string, string> = {
@@ -62,19 +67,22 @@ export function generateImportStatements(llms: LlmsCatalogEntry[]) {
 export async function makeBaseSystemPrompt(model: string, sessionDoc?: any) {
   // Inputs for module selection
   const userPrompt = sessionDoc?.userPrompt || '';
-  // Deterministic dependency selection
-  let selectedNames: string[] | undefined = undefined;
-  if (Array.isArray(sessionDoc?.dependencies)) {
-    // Validate against catalog
-    const allowed = new Set(llmsCatalog.map((l) => l.name));
+  // Deterministic dependency selection with user override gating
+  const useOverride = !!sessionDoc?.dependenciesUserOverride;
+  let selectedNames: string[] | undefined;
+  if (useOverride && Array.isArray(sessionDoc?.dependencies)) {
     selectedNames = (sessionDoc.dependencies as unknown[])
       .filter((v): v is string => typeof v === 'string')
-      .filter((name) => allowed.has(name));
+      .filter((name) => ALLOWED_DEPENDENCY_NAMES.has(name));
+    // Note: allow empty [] when override is true? Clarified in PR discussion; for now,
+    // we keep defaults for empty only when override is not set.
   }
-  // Apply clear default when not provided or empty
-  if (!selectedNames || selectedNames.length === 0) {
+  // Non-override path: use deterministic defaults (pending clarification on re-enabling picker)
+  if (!useOverride) {
     selectedNames = [...DEFAULT_DEPENDENCIES];
   }
+  // Final safety: ensure array is defined
+  if (!selectedNames) selectedNames = [...DEFAULT_DEPENDENCIES];
   const chosenLlms = llmsCatalog.filter((l) => selectedNames!.includes(l.name));
 
   // 3) Concatenate docs for chosen modules

app/types/chat.ts

@@ -20,6 +20,11 @@ export interface VibeDocument {
    * These control which helper libraries and docs are injected into prompts.
    */
   dependencies?: string[];
+  /**
+   * When true, treat `dependencies` as a user override and bypass any
+   * automatic/catalog-based module selection.
+   */
+  dependenciesUserOverride?: boolean;
 }
 
 // ===== Content Segment Types =====

tests/appSettings-dependencies.test.tsx

@@ -53,7 +53,7 @@ describe('AppSettingsView Libraries (per‑vibe dependency chooser)', () => {
     expect(save).not.toBeDisabled();
 
     await act(async () => fireEvent.click(save));
-    expect(onUpdateDependencies).toHaveBeenCalledWith(['fireproof']);
+    expect(onUpdateDependencies).toHaveBeenCalledWith(['fireproof'], true);
 
     // After save, button should disable again briefly
     expect(save).toBeDisabled();

tests/prompt-builder.test.ts

@@ -123,4 +123,14 @@ describe('prompt builder (real implementation)', () => {
     // User prompt appears verbatim
     expect(prompt).toContain('hello');
   });
+
+  it('makeBaseSystemPrompt: honors explicit dependencies only when override=true', async () => {
+    await preloadLlmsText();
+    const prompt = await makeBaseSystemPrompt('test-model', {
+      dependencies: ['fireproof'],
+      dependenciesUserOverride: true,
+    });
+    expect(prompt).toContain('<useFireproof-docs>');
+    expect(prompt).not.toContain('<callAI-docs>');
+  });
 });

tests/prompts-dependencies.integration.test.ts

@@ -14,7 +14,7 @@ beforeAll(async () => {
 });
 
 describe('makeBaseSystemPrompt dependency selection', () => {
-  it('uses default dependencies when none provided', async () => {
+  it('uses default dependencies when override is false/absent', async () => {
     await preloadLlmsText();
     const prompt = await makeBaseSystemPrompt('anthropic/claude-sonnet-4', {
       _id: 'user_settings',
@@ -27,16 +27,29 @@ describe('makeBaseSystemPrompt dependency selection', () => {
     expect(prompt).toMatch(/import\s+\{\s*callAI\s*\}\s+from\s+"call-ai"/);
   });
 
-  it('honors explicit dependencies from settings', async () => {
+  it('honors explicit dependencies only when override=true', async () => {
     await preloadLlmsText();
     const prompt = await makeBaseSystemPrompt('anthropic/claude-sonnet-4', {
       _id: 'user_settings',
       dependencies: ['fireproof'],
+      dependenciesUserOverride: true,
     });
     expect(prompt).toMatch(/<useFireproof-docs>/);
     expect(prompt).not.toMatch(/<callAI-docs>/);
     // Import statements reflect chosen modules only
     expect(prompt).toMatch(/import\s+\{\s*useFireproof\s*\}\s+from\s+"use-fireproof"/);
     expect(prompt).not.toMatch(/from\s+"call-ai"/);
   });
+
+  it('ignores explicit dependencies when override=false', async () => {
+    await preloadLlmsText();
+    const prompt = await makeBaseSystemPrompt('anthropic/claude-sonnet-4', {
+      _id: 'user_settings',
+      dependencies: ['fireproof'],
+      dependenciesUserOverride: false,
+    });
+    // Default includes both core libs
+    expect(prompt).toMatch(/<useFireproof-docs>/);
+    expect(prompt).toMatch(/<callAI-docs>/);
+  });
 });