@looplia/looplia-cli 0.7.2 → 0.7.3

package/dist/{chunk-OIE7CSW6.js → chunk-MHR5TPHE.js}

@@ -7,7 +7,7 @@ import {
   init_esm_shims
 } from "./chunk-Y55L47HC.js";
 
-// ../../packages/provider/dist/chunk-Q57VKNQX.js
+// ../../packages/provider/dist/chunk-DRG2TRPF.js
 init_esm_shims();
 import { createHash } from "crypto";
 import {
@@ -175,7 +175,7 @@ async function copyPlugins(targetDir, sourcePath) {
   );
   const { initializeRegistry, compileRegistry } = await import("./compiler-4B63UTUP-VE77VSJ2.js");
   await initializeRegistry();
-  const { syncRegistrySources } = await import("./sync-MFM46YAB-SSBMNJ7D.js");
+  const { syncRegistrySources } = await import("./sync-E5PGFGNI-IGGJR7IL.js");
   const syncResults = await syncRegistrySources({ showProgress: true });
   for (const result of syncResults) {
     if (result.status === "failed") {
@@ -293,7 +293,7 @@ async function getPluginPaths() {
   return await getProdPluginPaths();
 }
 
-// ../../packages/provider/dist/chunk-OG5PVVUV.js
+// ../../packages/provider/dist/chunk-3N4TZG2S.js
 init_esm_shims();
 import { execSync } from "child_process";
 import { existsSync as existsSync3 } from "fs";
@@ -22127,7 +22127,7 @@ function query({
   return queryInstance;
 }
 
-// ../../packages/provider/dist/chunk-OG5PVVUV.js
+// ../../packages/provider/dist/chunk-3N4TZG2S.js
 import { appendFileSync as appendFileSync3, mkdirSync as mkdirSync3, writeFileSync } from "fs";
 import { join as join33 } from "path";
 import { cp as cp2, mkdir as mkdir22, readFile as readFile22, rm as rm22, writeFile as writeFile22 } from "fs/promises";

package/dist/{chunk-HMJDIX7C.js → chunk-QQGRKUSM.js}

@@ -15,7 +15,7 @@ import {
   init_esm_shims
 } from "./chunk-Y55L47HC.js";
 
-// ../../packages/provider/dist/chunk-3D6TVN6A.js
+// ../../packages/provider/dist/chunk-O57P5VMU.js
 init_esm_shims();
 import { exec } from "child_process";
 import { cp, mkdir, readdir, readFile, rm, writeFile } from "fs/promises";
@@ -111,6 +111,8 @@ async function copyPluginSkills(plugin, tempDir, pluginDir) {
       const destPath = join(pluginDir, "skills", skillName);
       if (await pathExists(srcPath)) {
         await cp(srcPath, destPath, { recursive: true });
+      } else {
+        console.warn(`Warning: Skill path not found in source: ${skillPath}`);
       }
     }
   } else {
@@ -118,6 +120,8 @@ async function copyPluginSkills(plugin, tempDir, pluginDir) {
     const destPath = join(pluginDir, "skills", plugin.name);
     if (await pathExists(srcPath)) {
       await cp(srcPath, destPath, { recursive: true });
+    } else {
+      console.warn(`Warning: Skill source not found: ${plugin.source}`);
     }
   }
 }
@@ -157,7 +161,11 @@ async function installMarketplaceSource(tempDir, source, pluginsDir) {
   const results = [];
   for (const plugin of manifest.plugins) {
     const pluginDir = join(pluginsDir, plugin.name);
+    const skillsDir = join(pluginDir, "skills");
     try {
+      if (await pathExists(skillsDir)) {
+        await rm(skillsDir, { recursive: true, force: true });
+      }
       await createPluginStructure({ pluginDir, plugin, marketplace });
       await copyPluginSkills(plugin, tempDir, pluginDir);
       results.push({

package/dist/{chunk-QLL3W74D.js → chunk-VUASEQOQ.js}

@@ -6,7 +6,13 @@ import {
 // src/utils/sandbox.ts
 init_esm_shims();
 import { randomBytes } from "crypto";
-import { copyFileSync, mkdirSync, readdirSync } from "fs";
+import {
+  copyFileSync,
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  writeFileSync
+} from "fs";
 import { join, resolve } from "path";
 var SANDBOX_DIRS = {
   INPUTS: "inputs",
@@ -63,6 +69,24 @@ function copyOutputsToDestination(workspace, sandboxId, destDir) {
   }
   return copiedCount;
 }
+function writeWorkflowArtifact(workspace, filename, content) {
+  if (!(workspace && filename && content)) {
+    return null;
+  }
+  try {
+    const workflowsDir = join(workspace, "workflows");
+    mkdirSync(workflowsDir, { recursive: true });
+    const filePath = join(workflowsDir, filename);
+    writeFileSync(filePath, content, "utf-8");
+    if (!existsSync(filePath)) {
+      return null;
+    }
+    return filePath;
+  } catch (error) {
+    console.warn(`Warning: Error writing workflow artifact: ${error}`);
+    return null;
+  }
+}
 
 export {
   SANDBOX_DIRS,
@@ -70,5 +94,6 @@ export {
   generateSlug,
   generateSandboxId,
   createSandboxDirectories,
-  copyOutputsToDestination
+  copyOutputsToDestination,
+  writeWorkflowArtifact
 };

package/dist/{chunk-2ETB5RP7.js → chunk-VYGRYFSY.js}

@@ -107,7 +107,7 @@ import {
   unknownType,
   util,
   voidType
-} from "./chunk-OIE7CSW6.js";
+} from "./chunk-MHR5TPHE.js";
 import {
   pathExists
 } from "./chunk-VRBGWKZ6.js";
@@ -360,7 +360,7 @@ var RUN_PATTERN = /^agents\/([a-z][a-z0-9-]*)$/;
 function isValidRunFormat(run) {
   return RUN_PATTERN.test(run);
 }
-var INPUTLESS_CAPABLE_SKILLS = ["search"];
+var INPUTLESS_CAPABLE_SKILLS = ["browser-research"];
 var ARRAY_PATTERN = /^\[(.*)\]$/;
 var INTEGER_PATTERN = /^\d+$/;
 var NON_SPACE_PATTERN = /\S/;
@@ -904,7 +904,7 @@ async function installThirdPartySkill(skill, showProgress = false) {
     priority: 0,
     addedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
-  const { syncSource: sync } = await import("./sync-MFM46YAB-SSBMNJ7D.js");
+  const { syncSource: sync } = await import("./sync-E5PGFGNI-IGGJR7IL.js");
   const result = await sync(source, {
     showProgress,
     skillPath: skill.skillPath
@@ -1036,7 +1036,7 @@ async function installSkillFromUrl(url, showProgress = false) {
     priority: 0,
     addedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
-  const { syncSource: sync } = await import("./sync-MFM46YAB-SSBMNJ7D.js");
+  const { syncSource: sync } = await import("./sync-E5PGFGNI-IGGJR7IL.js");
   const result = await sync(source, {
     showProgress,
     skillPath

package/dist/{claude-agent-sdk-YGNDVP55.js → claude-agent-sdk-SQ6YU4VE.js}

@@ -31,7 +31,7 @@ import {
   validateConfig,
   writeLoopliaSettings,
   writeUserProfile
-} from "./chunk-OIE7CSW6.js";
+} from "./chunk-MHR5TPHE.js";
 import "./chunk-VRBGWKZ6.js";
 import "./chunk-Y55L47HC.js";
 export {

package/dist/cli.js

@@ -12,8 +12,8 @@ import {
   removeSkill,
   updateSkill,
   validateUserProfile
-} from "./chunk-2ETB5RP7.js";
-import "./chunk-HMJDIX7C.js";
+} from "./chunk-VYGRYFSY.js";
+import "./chunk-QQGRKUSM.js";
 import {
   addSource,
   compileRegistry,
@@ -42,13 +42,14 @@ import {
   removeLoopliaSettings,
   writeLoopliaSettings,
   writeUserProfile
-} from "./chunk-OIE7CSW6.js";
+} from "./chunk-MHR5TPHE.js";
 import "./chunk-VRBGWKZ6.js";
 import {
   copyOutputsToDestination,
   createSandboxDirectories,
-  generateSandboxId
-} from "./chunk-QLL3W74D.js";
+  generateSandboxId,
+  writeWorkflowArtifact
+} from "./chunk-VUASEQOQ.js";
 import {
   __commonJS,
   __dirname,
@@ -32864,10 +32865,10 @@ var ANALYSIS_RESULT_SCHEMA = {
   }
 };
 async function* analyzeDescriptionStreaming(description, workspace, questionCallback) {
-  const { createSandboxDirectories: createSandboxDirectories2, generateSandboxId: generateSandboxId2 } = await import("./sandbox-LD3EU4YO.js");
+  const { createSandboxDirectories: createSandboxDirectories2, generateSandboxId: generateSandboxId2 } = await import("./sandbox-XVMNWAJO.js");
   const sandboxId = generateSandboxId2("build");
   createSandboxDirectories2(workspace, sandboxId);
-  const { executeInteractiveQueryStreaming } = await import("./claude-agent-sdk-YGNDVP55.js");
+  const { executeInteractiveQueryStreaming } = await import("./claude-agent-sdk-SQ6YU4VE.js");
   const prompt = `${buildAnalysisPrompt(description)} --sandbox-id ${sandboxId}`;
   const generator = executeInteractiveQueryStreaming(
     prompt,
@@ -34112,7 +34113,7 @@ function executeMock(args) {
 }
 async function executeBatch(prompt, workspace, executor) {
   console.error("\u23F3 Building workflow...");
-  const { createSandboxDirectories: createSandboxDirectories2, generateSandboxId: generateSandboxId2 } = await import("./sandbox-LD3EU4YO.js");
+  const { createSandboxDirectories: createSandboxDirectories2, generateSandboxId: generateSandboxId2 } = await import("./sandbox-XVMNWAJO.js");
   const sandboxId = generateSandboxId2("build");
   createSandboxDirectories2(workspace, sandboxId);
   const promptWithSandbox = `${prompt} --sandbox-id ${sandboxId}`;
@@ -34130,11 +34131,11 @@ async function executeBatch(prompt, workspace, executor) {
   };
 }
 async function* executeInteractiveStreamingBatch(prompt, workspace, questionCallback) {
-  const { createSandboxDirectories: createSandboxDirectories2, generateSandboxId: generateSandboxId2 } = await import("./sandbox-LD3EU4YO.js");
+  const { createSandboxDirectories: createSandboxDirectories2, generateSandboxId: generateSandboxId2 } = await import("./sandbox-XVMNWAJO.js");
   const sandboxId = generateSandboxId2("build");
   createSandboxDirectories2(workspace, sandboxId);
   const promptWithSandbox = `${prompt} --sandbox-id ${sandboxId}`;
-  const { executeInteractiveQueryStreaming } = await import("./claude-agent-sdk-YGNDVP55.js");
+  const { executeInteractiveQueryStreaming } = await import("./claude-agent-sdk-SQ6YU4VE.js");
   const schema = {
     type: "object",
     properties: {
@@ -34280,24 +34281,52 @@ function executeBuild(prompt, workspace, parsed) {
   }
   return executeBatch(prompt, workspace);
 }
-function renderResult(result) {
-  if (result.status === "success") {
-    console.log("\n\u2705 Workflow created successfully");
-    if (result.workflowPath) {
-      console.log(`Path: ${result.workflowPath}`);
-    }
-    if (result.workflowName) {
-      console.log("\nRun with:");
-      console.log(`  looplia run ${result.workflowName} --file <content.md>`);
-    }
-    if (result.stepsCount) {
-      console.log(`
+function handleArtifactWrite(result, workspace) {
+  if (!result.artifact) {
+    console.warn("\u26A0 No artifact in result - workflow may not be saved");
+    return null;
+  }
+  const { filename, content } = result.artifact;
+  if (!(filename && content)) {
+    console.warn("\u26A0 Invalid artifact (missing filename or content)");
+    return null;
+  }
+  const writtenPath = writeWorkflowArtifact(workspace, filename, content);
+  if (!writtenPath) {
+    console.error("\u2718 Failed to write workflow artifact");
+    return null;
+  }
+  return writtenPath;
+}
+function renderSuccessMessage(result, displayPath) {
+  console.log("\n\u2705 Workflow created successfully");
+  if (displayPath) {
+    console.log(`Path: ${displayPath}`);
+  }
+  if (result.workflowName || result.workflowId) {
+    const name = result.workflowName ?? result.workflowId;
+    console.log("\nRun with:");
+    console.log(`  looplia run ${name} --file <content.md>`);
+  }
+  if (result.stepsCount) {
+    console.log(`
 Steps: ${result.stepsCount}`);
-    }
-  } else {
+  }
+}
+function renderResult(result, workspace) {
+  if (result.status !== "success") {
     console.error(`
 \u274C Build failed: ${result.error ?? "Unknown error"}`);
+    return;
+  }
+  const writtenPath = handleArtifactWrite(result, workspace);
+  const hasValidArtifact = result.artifact?.filename && result.artifact?.content;
+  if (hasValidArtifact && !writtenPath) {
+    console.error("\n\u274C Build failed: Unable to save workflow artifact");
+    return;
   }
+  const displayPath = writtenPath ?? result.workflowPath ?? null;
+  renderSuccessMessage(result, displayPath);
 }
 async function runBuildCommand(args) {
   const parsed = parseArgs(args);
@@ -34316,7 +34345,7 @@ async function runBuildCommand(args) {
     await initializeCommandEnvironment({ mock: parsed.mock });
     const prompt = buildPrompt(parsed);
     const result = await executeBuild(prompt, workspace, parsed);
-    renderResult(result);
+    renderResult(result, workspace);
     if (result.status !== "success") {
       process.exit(1);
     }
@@ -35593,7 +35622,7 @@ async function skillAdd(nameOrUrl, from) {
   }
   if (GITHUB_URL_PATTERN.test(nameOrUrl)) {
     console.log(`Installing skill from URL: ${nameOrUrl}...`);
-    const { installSkillFromUrl } = await import("./dist-3B4KUA76.js");
+    const { installSkillFromUrl } = await import("./dist-PMEIK6PJ.js");
     const result2 = await installSkillFromUrl(nameOrUrl, true);
     switch (result2.status) {
       case "installed":
@@ -35830,7 +35859,7 @@ async function runSkillCommand(args) {
 }
 
 // src/index.ts
-var VERSION = "0.7.2";
+var VERSION = "0.7.3";
 function printHelp5() {
   console.log(`
 looplia - Content intelligence CLI (v${VERSION})

package/dist/{dist-3B4KUA76.js → dist-PMEIK6PJ.js}

@@ -11,11 +11,11 @@ import {
   loadCompiledRegistry,
   removeSkill,
   updateSkill
-} from "./chunk-2ETB5RP7.js";
+} from "./chunk-VYGRYFSY.js";
 import {
   syncRegistrySources,
   syncSource
-} from "./chunk-HMJDIX7C.js";
+} from "./chunk-QQGRKUSM.js";
 import {
   addSource,
   compileRegistry,
@@ -32,7 +32,7 @@ import {
   CORE_SKILLS,
   ensureWorkspace,
   isCoreSkill
-} from "./chunk-OIE7CSW6.js";
+} from "./chunk-MHR5TPHE.js";
 import "./chunk-VRBGWKZ6.js";
 import "./chunk-Y55L47HC.js";
 export {

package/dist/{sandbox-LD3EU4YO.js → sandbox-XVMNWAJO.js}

@@ -5,8 +5,9 @@ import {
   createSandboxDirectories,
   generateRandomSuffix,
   generateSandboxId,
-  generateSlug
-} from "./chunk-QLL3W74D.js";
+  generateSlug,
+  writeWorkflowArtifact
+} from "./chunk-VUASEQOQ.js";
 import "./chunk-Y55L47HC.js";
 export {
   SANDBOX_DIRS,
@@ -14,5 +15,6 @@ export {
   createSandboxDirectories,
   generateRandomSuffix,
   generateSandboxId,
-  generateSlug
+  generateSlug,
+  writeWorkflowArtifact
 };

package/dist/{sync-MFM46YAB-SSBMNJ7D.js → sync-E5PGFGNI-IGGJR7IL.js}

@@ -2,14 +2,14 @@
 import {
   syncRegistrySources,
   syncSource
-} from "./chunk-HMJDIX7C.js";
+} from "./chunk-QQGRKUSM.js";
 import "./chunk-XTUQVJYH.js";
 import "./chunk-VRBGWKZ6.js";
 import {
   init_esm_shims
 } from "./chunk-Y55L47HC.js";
 
-// ../../packages/provider/dist/sync-MFM46YAB.js
+// ../../packages/provider/dist/sync-E5PGFGNI.js
 init_esm_shims();
 export {
   syncRegistrySources,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@looplia/looplia-cli",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "Looplia CLI - AI-powered workflow automation tool",
   "type": "module",
   "license": "Elastic-2.0",

package/plugins/looplia-core/skills/workflow-executor/SKILL.md

@@ -113,17 +113,17 @@ Before executing a step, validate:
 ### Input-less Capable Skills
 
 These skills can operate without an `input` field:
-- `search` - Executes search missions autonomously
+- `browser-research` - Executes research missions autonomously (from looplia-skills)
 
 Example input-less step:
 ```yaml
 - id: find-news
-  skill: search
+  skill: browser-research
   mission: |
     Search Hacker News for today's top 3 AI stories.
     Extract title, URL, points, and brief summary.
   output: ${{ sandbox }}/outputs/news.json
-  # No input field - search operates autonomously
+  # No input field - browser-research operates autonomously
 ```
 
 ---

package/plugins/looplia-core/skills/workflow-schema-composer/SKILL.md

@@ -108,12 +108,12 @@ These skills can operate WITHOUT an input field - they fetch/generate data auton
 **Example input-less first step:**
 ```yaml
 - id: fetch-data
-  skill: search
+  skill: browser-research
   mission: |
     Search the web for recent technology trends.
     Extract titles, URLs, and key details.
   output: ${{ sandbox }}/outputs/data.json
-  # NO input field - search operates autonomously
+  # NO input field - browser-research operates autonomously
 ```
 
 ### Step 5: Suggest Validation
@@ -196,15 +196,21 @@ No input required - this workflow uses autonomous skills to fetch data.
 
 ## Output Format
 
-Return a JSON object:
+Return a JSON object (v0.7.3: used by CLI for artifact persistence):
 
 ```json
 {
   "filename": "video-to-blog.md",
-  "content": "---\nname: video-to-blog\n..."
+  "content": "---\nname: video-to-blog\nversion: 1.0.0\n...\n---\n\n# Video to Blog Workflow\n..."
 }
 ```
 
+**Important**: `content` MUST be the complete, ready-to-write markdown file including:
+- Full YAML frontmatter (between `---` delimiters)
+- Markdown body (usage docs, steps section)
+
+The CLI writes this content directly to `{workspace}/workflows/{filename}`.
+
 ## Schema Reference
 
 See SCHEMA.md in this skill directory for the complete v0.6.2 workflow schema.
@@ -313,17 +319,17 @@ description: Fetch trending news and compile a digest report
 
 # v0.7.0: Explicit skills declaration
 skills:
-  - search
+  - browser-research
   - content-documenter
 
 steps:
   - id: fetch-news
-    skill: search
+    skill: browser-research
     mission: |
       Search the web for today's trending technology news.
       Extract title, URL, source, and brief summary for each story.
     output: ${{ sandbox }}/outputs/news.json
-    # NO input field - search operates autonomously
+    # NO input field - browser-research operates autonomously
     validate:
       required_fields: [query, mode, results]
 
@@ -368,7 +374,7 @@ Given enriched prompt:
 **BAD workflow (ignores preferences):**
 ```yaml
 - id: fetch-news
-  skill: search
+  skill: browser-research
   mission: |
     Search HackerNews for AI news articles.
     Extract titles and summaries.
@@ -382,7 +388,7 @@ Given enriched prompt:
 **GOOD workflow (incorporates preferences):**
 ```yaml
 - id: fetch-news
-  skill: search
+  skill: browser-research
   mission: |
     Search HackerNews for the top 5 AI news articles
     focusing on LLM developments and adoption trends.

package/plugins/looplia-core/skills/search/SKILL.md

@@ -1,174 +0,0 @@
----
-name: search
-description: |
-  This skill should be used when the user needs to search for information, find files,
-  look up content online, or retrieve data without providing input files.
-
-  Trigger phrases include:
-  - "search for", "find", "look up", "research"
-  - "search the web", "search online", "fetch from URL"
-  - "search files", "scan codebase", "find in project", "grep for"
-  - "get news from", "read hacker news", "check what's trending"
-
-  Supports multiple search modes:
-  - local: Search local filesystem using Glob, Grep, Read, Bash
-  - web: Search web content using WebSearch, WebFetch
-  - future: Pluggable providers (jina.ai, firecrawl, exa.ai)
-
-  This is an input-less skill - it executes search missions autonomously.
-model: haiku
-tools:
-  - Glob
-  - Grep
-  - Read
-  - Bash
-  - WebSearch
-  - WebFetch
----
-
-# Search Skill
-
-Execute search missions and compile structured results from various sources.
-
-## Purpose
-
-Provide a unified search interface that can:
-1. Search local files, codebases, and directories
-2. Search web content (via WebSearch/WebFetch or future provider integrations)
-3. Compile results into structured JSON output
-
-This skill operates **without user-provided input files** - it receives a search mission and executes it autonomously.
-
-## Search Modes
-
-### Local Mode
-
-Search the local environment:
-
-| Tool | Use Case |
-|------|----------|
-| `Glob` | Find files by pattern (e.g., `**/*.md`, `src/**/*.ts`) |
-| `Grep` | Search file contents for patterns |
-| `Read` | Read matched files for content extraction |
-| `Bash` | Execute find, ls, or other search commands |
-
-### Web Mode
-
-Search web content:
-
-| Tool | Use Case |
-|------|----------|
-| `WebSearch` | Search the web for topics, news, documentation |
-| `WebFetch` | Fetch and extract content from URLs |
-
-**Future Providers** (planned integration):
-- `jina.ai` - AI-powered web search and extraction
-- `firecrawl` - Web crawling and scraping
-- `exa.ai` - Neural search engine
-
-## Process
-
-### Step 1: Parse Mission
-
-Extract from the mission description:
-- **Search target**: What to search for (keywords, patterns, topics)
-- **Search mode**: local, web, or auto-detect
-- **Scope**: Directories, file types, domains, date range
-- **Compile format**: How to structure results
-
-### Step 2: Execute Search
-
-Based on mode:
-
-**Local:**
-```
-1. Use Glob to find matching files
-2. Use Grep to search content patterns
-3. Use Read to extract relevant sections
-4. Compile matched results
-```
-
-**Web:**
-```
-1. Use WebSearch to find relevant pages
-2. Use WebFetch to extract content
-3. Parse and filter results
-4. Compile into structured format
-```
-
-### Step 3: Compile Results
-
-Structure findings into the output schema with:
-- Source attribution (file path or URL)
-- Relevance scoring
-- Extracted content snippets
-- Metadata (date, author if available)
-
-## Input
-
-The skill receives a **mission description** specifying:
-- What to search for
-- Where to search (mode/scope)
-- What to extract and compile
-
-Example missions:
-```
-Search for all TODO comments in the src/ directory and compile a list with file locations.
-```
-```
-Search Hacker News for the top 5 trending AI stories today and summarize each.
-```
-```
-Find all TypeScript files that import from '@looplia-core/core' and list their exports.
-```
-
-## Output Schema
-
-```json
-{
-  "query": "original search query/mission",
-  "mode": "local | web",
-  "results": [
-    {
-      "source": "path/to/file.ts | https://example.com/page",
-      "type": "file | url",
-      "title": "Optional title or filename",
-      "content": "Extracted content or snippet",
-      "relevance": 0.95,
-      "metadata": {
-        "lineNumber": 42,
-        "matchContext": "surrounding context",
-        "date": "2025-12-24",
-        "author": "optional"
-      }
-    }
-  ],
-  "summary": "Brief summary of findings",
-  "totalMatches": 15,
-  "compiledAt": "2025-12-24T10:30:00Z"
-}
-```
-
-## Usage in Workflows
-
-This skill enables **input-less workflow steps**:
-
-```yaml
-steps:
-  - id: find-news
-    skill: search
-    mission: |
-      Search Hacker News for today's top 3 AI stories.
-      Extract title, URL, points, and brief summary for each.
-    output: outputs/news.json
-```
-
-No `input:` field required - the skill operates autonomously.
-
-## Important Rules
-
-1. **Always attribute sources** - Include file paths or URLs for all results
-2. **Respect scope** - Only search within specified boundaries
-3. **Compile, don't dump** - Structure results, don't return raw search output
-4. **Handle empty results** - Return valid JSON even when no matches found
-5. **Rate limit web searches** - Be mindful of API limits for web providers