@yattalo/task-system 0.4.0 → 0.5.0

package/dist/generators/mgrep-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mgrep-setup.js","sourceRoot":"","sources":["../../src/generators/mgrep-setup.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,6DAA6D;AAC7D,yDAAyD;AACzD,+DAA+D;AAE/D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACxF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,MAAM,UAAU,kBAAkB,CAAC,GAAqB;IACtD,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAC1C,MAAM,YAAY,GAAyB,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC;IACvE,MAAM,OAAO,GAAsC,EAAE,CAAC;IAEtD,4BAA4B;IAC5B,MAAM,SAAS,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACxB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAE7E,2BAA2B;IAC3B,MAAM,aAAa,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAC;IACxD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,aAAa,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAEhF,wDAAwD;IACxD,IAAI,YAAY,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;QACrC,MAAM,WAAW,GAAG,sBAAsB,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3C,CAAC;YACD,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;YAC9C,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,mCAAmC,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAEnG,iDAAiD;QACjD,MAAM,eAAe,GAAG,4BAA4B,EAAE,CAAC;QACvD,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;QACjE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,iBAAiB,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,oCAAoC,EAAE,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1G,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,eAAe,CAAC,YAAkC;IACzD,MAAM,CAAC,GAAa,EAAE,CAAC;IACvB,CAAC,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IACzE,CAAC,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IAClD,CAAC,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IAC9C,CAAC,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IACxC,CAAC,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IACzE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACX,CAAC,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IACtD,CAAC,CAAC,IAAI,CAAC,gBAAgB,YAAY,CAAC,WAAW,IAAI,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACX,CAAC,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;IAChE,CAAC,CAAC,IAAI,CAAC,iBAAiB,YAAY,CAAC,YAAY,IAAI,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEX,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED,SAAS,mBAAmB,CAAC,YAAkC;IAC7D,MAAM,CAAC,GAAa,EAAE,CAAC;IACvB,CAAC,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IACzE,CAAC,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IACpD,CAAC,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IAC9C,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IACvC,CAAC,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IACzE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACX,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC1B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACnB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjB,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACX,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACzB,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACxB,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACX,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC5B,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACnB,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACpB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChB,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACxB,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACX,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACvB,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC5B,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACzB,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACpB,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACpB,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACX,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAC7B,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAC7B,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACX,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAClC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClB,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEX,qCAAqC;IACrC,MAAM,aAAa,GAAG,YAAY,CAAC,cAAc,IAAI,EAAE,CAAC;IACxD,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QACtC,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE,CAAC;YACpC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClB,CAAC;QACD,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACb,CAAC;IAED,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED,SAAS,sBAAsB;IAC7B,MAAM,CAAC,GAAa,EAAE,CAAC;IACvB,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACtB,CAAC,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IACzE,CAAC,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;IAC9E,CAAC,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IAC9C,CAAC,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IACzE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACX,CAAC,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IACxC,CAAC,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IAClD,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACnB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACX,CAAC,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IACpD,CAAC,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IACtD,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACnB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACX,CAAC,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAC5C,CAAC,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAC1C,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACX,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEjB,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED,SAAS,4BAA4B;IACnC,MAAM,QAAQ,GAAG;QACf,KAAK,EAAE;YACL,YAAY,EAAE;gBACZ;oBACE,KAAK,EAAE;wBACL;4BACE,IAAI,EAAE,SAAS;4BACf,OAAO,EAAE,uDAAuD;4BAChE,aAAa,EAAE,mCAAmC;yBACnD;qBACF;iBACF;aACF;SACF;KACF,CAAC;IAEF,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,yEAAyE;AACzE,SAAS,iBAAiB,CAAC,YAAoB,EAAE,UAAkB;IACjE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAE3C,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;YACjE,MAAM,aAAa,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAA8B,CAAC;YAC1E,MAAM,QAAQ,GAAG,CAAC,WAAW,CAAC,KAAK,IAAI,EAAE,CAA8B,CAAC;YAExE,+CAA+C;YAC/C,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACxD,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;oBACzB,oDAAoD;oBACpD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;oBACzD,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;wBAClC,aAAa,CAAC,KAAK,CAAe,CAAC,IAAI,CAAC,GAAI,OAAqB,CAAC,CAAC;oBACtE,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,aAAa,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC;gBACjC,CAAC;YACH,CAAC;YAED,MAAM,MAAM,GAAG;gBACb,GAAG,QAAQ;gBACX,KAAK,EAAE,aAAa;aACrB,CAAC;YACF,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACxE,CAAC;QAAC,MAAM,CAAC;YACP,aAAa,CAAC,YAAY,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;SAAM,CAAC;QACN,aAAa,CAAC,YAAY,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;AACH,CAAC"}

package/dist/generators/mgrep-skill.d.ts

@@ -0,0 +1,6 @@
+import type { GeneratorContext } from "@yattalo/task-system-core";
+export declare function generateMgrepSkill(ctx: GeneratorContext): {
+    file: string;
+    lines: number;
+};
+//# sourceMappingURL=mgrep-skill.d.ts.map

package/dist/generators/mgrep-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mgrep-skill.d.ts","sourceRoot":"","sources":["../../src/generators/mgrep-skill.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAsLzF"}

package/dist/generators/mgrep-skill.js

@@ -0,0 +1,173 @@
+// ============================================================
+// Generator: Layer 6a — Semantic Search Skill (mgrep SKILL.md)
+// Generates .claude/skills/semantic-search/SKILL.md
+// ============================================================
+import { writeFileSync } from "node:fs";
+import { join } from "node:path";
+export function generateMgrepSkill(ctx) {
+    const { config, targetDir, dryRun } = ctx;
+    const searchConfig = config.semanticSearch ?? {};
+    const maxResults = searchConfig.defaultMaxResults ?? 10;
+    const lines = [];
+    lines.push(`---`);
+    lines.push(`name: semantic-search`);
+    lines.push(`description: Semantic code search with mgrep. Natural language queries, feature discovery, cross-file understanding. Use mgrep "query" for intent-based search, -a for AI answers, --web for documentation lookup.`);
+    lines.push(`---`);
+    lines.push(``);
+    lines.push(`# Semantic Search — Claude Code Skill`);
+    lines.push(``);
+    lines.push(`> Generated by @yattalo/task-system for **${config.projectName}**`);
+    lines.push(`> Powered by [mgrep](https://www.mgrep.dev/) — semantic grep for code, docs, images, PDFs`);
+    lines.push(`> DO NOT EDIT MANUALLY — re-run \`npx @yattalo/task-system init\` to regenerate`);
+    lines.push(``);
+    // --- Overview ---
+    lines.push(`## Overview`);
+    lines.push(``);
+    lines.push(`This project uses **mgrep** for semantic code search. Unlike grep/ripgrep which match`);
+    lines.push(`exact patterns, mgrep understands natural language queries and finds code by meaning.`);
+    lines.push(``);
+    lines.push(`**When to use mgrep vs grep:**`);
+    lines.push(`- **mgrep**: Intent-based search, feature discovery, onboarding, cross-file understanding`);
+    lines.push(`- **grep/rg**: Exact matches, symbol tracing, refactoring, regex patterns`);
+    lines.push(``);
+    lines.push(`Best results come from combining both: mgrep to discover, grep to refine.`);
+    lines.push(``);
+    // --- Quick Reference ---
+    lines.push(`## Quick Reference`);
+    lines.push(``);
+    lines.push(`\`\`\`bash`);
+    lines.push(`# Basic semantic search`);
+    lines.push(`mgrep "where is authentication configured?"`);
+    lines.push(``);
+    lines.push(`# Search with more results`);
+    lines.push(`mgrep "error handling patterns" -m 20`);
+    lines.push(``);
+    lines.push(`# Show surrounding context`);
+    lines.push(`mgrep "database connection setup" -c`);
+    lines.push(``);
+    lines.push(`# Get AI-generated answer from results`);
+    lines.push(`mgrep "how does the payment flow work?" -a`);
+    lines.push(``);
+    if (searchConfig.webSearch) {
+        lines.push(`# Web search (enabled by default for this project)`);
+        lines.push(`mgrep "latest React 19 patterns" --web`);
+        lines.push(``);
+    }
+    else {
+        lines.push(`# Include web search results`);
+        lines.push(`mgrep "how to implement SSR with this framework" --web`);
+        lines.push(``);
+    }
+    if (searchConfig.agenticSearch) {
+        lines.push(`# Agentic multi-query refinement (enabled by default)`);
+        lines.push(`mgrep "trace the complete request lifecycle" --agentic`);
+        lines.push(``);
+    }
+    else {
+        lines.push(`# Complex queries with multi-query refinement`);
+        lines.push(`mgrep "trace the complete request lifecycle" --agentic`);
+        lines.push(``);
+    }
+    lines.push(`# Search specific directory`);
+    lines.push(`mgrep "API endpoint definitions" src/`);
+    lines.push(``);
+    lines.push(`# Sync files before searching (ensures index is current)`);
+    lines.push(`mgrep "recent changes to auth" -s`);
+    lines.push(`\`\`\``);
+    lines.push(``);
+    // --- UCA Integration ---
+    lines.push(`## UCA Integration`);
+    lines.push(``);
+    lines.push(`Semantic search is a core pillar of the Unified Context Accelerator (UCA).`);
+    lines.push(`It bridges the gap between **Context** (what agents know) and **Knowledge** (curated information).`);
+    lines.push(``);
+    lines.push(`### Search Patterns for UCA Workflows`);
+    lines.push(``);
+    lines.push(`\`\`\`bash`);
+    lines.push(`# Find related context for a task`);
+    lines.push(`mgrep "authentication middleware implementation" -m ${maxResults}`);
+    lines.push(``);
+    lines.push(`# Discover knowledge before creating context entries`);
+    lines.push(`mgrep "patterns we use for error handling" -a`);
+    lines.push(``);
+    lines.push(`# Cross-reference existing implementations`);
+    lines.push(`mgrep "similar to the user registration flow" -c`);
+    lines.push(``);
+    lines.push(`# Validate assumptions against codebase`);
+    lines.push(`mgrep "is rate limiting implemented anywhere?" -a`);
+    lines.push(`\`\`\``);
+    lines.push(``);
+    // --- Agent-Specific Patterns ---
+    const agentKeys = Object.keys(config.agents);
+    if (agentKeys.length > 0) {
+        lines.push(`### Agent Search Patterns`);
+        lines.push(``);
+        lines.push(`Each agent should use mgrep for codebase understanding before starting tasks:`);
+        lines.push(``);
+        lines.push(`\`\`\`bash`);
+        lines.push(`# Before starting any task — understand the area`);
+        lines.push(`mgrep "how does [feature area] work?" -a`);
+        lines.push(``);
+        lines.push(`# During code review — find related patterns`);
+        lines.push(`mgrep "other places that use this pattern" -m 15`);
+        lines.push(``);
+        lines.push(`# When blocked — search for similar solutions`);
+        lines.push(`mgrep "workaround for [issue description]" --web`);
+        lines.push(`\`\`\``);
+        lines.push(``);
+    }
+    // --- Indexing ---
+    lines.push(`## Indexing`);
+    lines.push(``);
+    lines.push(`The project index is managed by mgrep and synced to a Mixedbread cloud store.`);
+    lines.push(``);
+    lines.push(`\`\`\`bash`);
+    lines.push(`# Start background indexing (watches for file changes)`);
+    lines.push(`mgrep watch`);
+    lines.push(``);
+    lines.push(`# Manual sync before search`);
+    lines.push(`mgrep "query" -s`);
+    lines.push(`\`\`\``);
+    lines.push(``);
+    if ((searchConfig.ignorePatterns ?? []).length > 0) {
+        lines.push(`### Custom Ignore Patterns`);
+        lines.push(``);
+        lines.push(`This project excludes:`);
+        for (const pattern of searchConfig.ignorePatterns) {
+            lines.push(`- \`${pattern}\``);
+        }
+        lines.push(``);
+    }
+    // --- Configuration ---
+    lines.push(`## Configuration`);
+    lines.push(``);
+    lines.push(`| Setting | Value |`);
+    lines.push(`|---------|-------|`);
+    lines.push(`| Max file size | ${((searchConfig.maxFileSize ?? 1048576) / 1024 / 1024).toFixed(1)}MB |`);
+    lines.push(`| Max file count | ${searchConfig.maxFileCount ?? 1000} |`);
+    lines.push(`| Default results | ${maxResults} |`);
+    lines.push(`| Web search | ${searchConfig.webSearch ? "enabled" : "disabled"} |`);
+    lines.push(`| Agentic search | ${searchConfig.agenticSearch ? "enabled" : "disabled"} |`);
+    lines.push(`| Auto-watch | ${searchConfig.autoWatch !== false ? "enabled" : "disabled"} |`);
+    lines.push(``);
+    // --- Best Practices ---
+    lines.push(`## Best Practices`);
+    lines.push(``);
+    lines.push(`1. **Ask in natural language** — "where is the auth middleware?" beats "auth middleware file"`);
+    lines.push(`2. **Use \`-a\` for understanding** — generates synthesized answers from multiple results`);
+    lines.push(`3. **Use \`-c\` for context** — shows surrounding code for faster comprehension`);
+    lines.push(`4. **Combine with grep** — use mgrep to discover, grep to trace exact references`);
+    lines.push(`5. **Keep index fresh** — run \`mgrep watch\` or use \`-s\` flag during active development`);
+    lines.push(`6. **Use \`--agentic\` for complex queries** — multi-query refinement for architectural questions`);
+    lines.push(``);
+    const content = lines.join("\n");
+    if (!dryRun) {
+        const skillPath = join(targetDir, ".claude", "skills", "semantic-search", "SKILL.md");
+        writeFileSync(skillPath, content, "utf-8");
+    }
+    return {
+        file: ".claude/skills/semantic-search/SKILL.md",
+        lines: lines.length,
+    };
+}
+//# sourceMappingURL=mgrep-skill.js.map

package/dist/generators/mgrep-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mgrep-skill.js","sourceRoot":"","sources":["../../src/generators/mgrep-skill.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,oDAAoD;AACpD,+DAA+D;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,MAAM,UAAU,kBAAkB,CAAC,GAAqB;IACtD,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAC1C,MAAM,YAAY,GAAG,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC;IACjD,MAAM,UAAU,GAAG,YAAY,CAAC,iBAAiB,IAAI,EAAE,CAAC;IAExD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,oNAAoN,CAAC,CAAC;IACjO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,6CAA6C,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC;IAChF,KAAK,CAAC,IAAI,CAAC,2FAA2F,CAAC,CAAC;IACxG,KAAK,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAC;IAC9F,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,mBAAmB;IACnB,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,uFAAuF,CAAC,CAAC;IACpG,KAAK,CAAC,IAAI,CAAC,uFAAuF,CAAC,CAAC;IACpG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAC7C,KAAK,CAAC,IAAI,CAAC,2FAA2F,CAAC,CAAC;IACxG,KAAK,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;IACxF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;IACxF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,0BAA0B;IAC1B,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAC1D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,IAAI,YAAY,CAAC,SAAS,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;QACjE,KAAK,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;QACrE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,YAAY,CAAC,aAAa,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;QACpE,KAAK,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;QACrE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;QACrE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC1C,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;IACvE,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,0BAA0B;IAC1B,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAC;IACzF,KAAK,CAAC,IAAI,CAAC,oGAAoG,CAAC,CAAC;IACjH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,uDAAuD,UAAU,EAAE,CAAC,CAAC;IAChF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;IACnE,KAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IAC5D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IAC/D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,kCAAkC;IAClC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;QAC5F,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,mBAAmB;IACnB,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;IAC5F,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;IACrE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC1C,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC/B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,CAAC,YAAY,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACrC,KAAK,MAAM,OAAO,IAAI,YAAY,CAAC,cAAe,EAAE,CAAC;YACnD,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,IAAI,CAAC,CAAC;QACjC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,wBAAwB;IACxB,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,YAAY,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACxG,KAAK,CAAC,IAAI,CAAC,sBAAsB,YAAY,CAAC,YAAY,IAAI,IAAI,IAAI,CAAC,CAAC;IACxE,KAAK,CAAC,IAAI,CAAC,uBAAuB,UAAU,IAAI,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,kBAAkB,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC;IAClF,KAAK,CAAC,IAAI,CAAC,sBAAsB,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC;IAC1F,KAAK,CAAC,IAAI,CAAC,kBAAkB,YAAY,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC;IAC5F,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,yBAAyB;IACzB,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,+FAA+F,CAAC,CAAC;IAC5G,KAAK,CAAC,IAAI,CAAC,2FAA2F,CAAC,CAAC;IACxG,KAAK,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAC;IAC9F,KAAK,CAAC,IAAI,CAAC,kFAAkF,CAAC,CAAC;IAC/F,KAAK,CAAC,IAAI,CAAC,4FAA4F,CAAC,CAAC;IACzG,KAAK,CAAC,IAAI,CAAC,mGAAmG,CAAC,CAAC;IAChH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEjC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,IAAI,CACpB,SAAS,EACT,SAAS,EACT,QAAQ,EACR,iBAAiB,EACjB,UAAU,CACX,CAAC;QACF,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO;QACL,IAAI,EAAE,yCAAyC;QAC/C,KAAK,EAAE,KAAK,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC"}

package/dist/generators/uca-functions.d.ts

@@ -0,0 +1,8 @@
+import type { GeneratorContext } from "@yattalo/task-system-core";
+interface GeneratorResult {
+    file: string;
+    lines: number;
+}
+export declare function generateUcaFunctions(ctx: GeneratorContext): GeneratorResult[];
+export {};
+//# sourceMappingURL=uca-functions.d.ts.map

package/dist/generators/uca-functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uca-functions.d.ts","sourceRoot":"","sources":["../../src/generators/uca-functions.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAKlE,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAuBD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,gBAAgB,GAAG,eAAe,EAAE,CAkC7E"}

package/dist/generators/uca-functions.js

@@ -0,0 +1,57 @@
+// ============================================================
+// Generator: UCA Backend Functions
+// Copies UCA function templates to convex/taskSystem/
+// ============================================================
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const UCA_TEMPLATE_FILES = [
+    "ucaTasks",
+    "contextEntries",
+    "driftEvents",
+    "agents",
+    "memory",
+    "skills",
+    "hooks",
+    "heartbeats",
+    "sessionBridge",
+    "cronManager",
+    "cronUtils",
+];
+function resolveTemplateDir() {
+    // In compiled form: dist/generators/uca-functions.js
+    // Templates live at: packages/cli/templates/uca/
+    // So from dist/generators/ we go ../../templates/uca/
+    return join(__dirname, "..", "..", "templates", "uca");
+}
+export function generateUcaFunctions(ctx) {
+    const { targetDir, dryRun } = ctx;
+    const templateDir = resolveTemplateDir();
+    const outDir = join(targetDir, "convex", "taskSystem");
+    const results = [];
+    for (const name of UCA_TEMPLATE_FILES) {
+        const templatePath = join(templateDir, `${name}.ts`);
+        const outPath = join(outDir, `${name}.ts`);
+        if (!existsSync(templatePath)) {
+            console.warn(`  Warning: UCA template not found: ${templatePath}`);
+            continue;
+        }
+        // Skip if file already exists (don't overwrite user customizations)
+        if (existsSync(outPath)) {
+            continue;
+        }
+        const content = readFileSync(templatePath, "utf-8");
+        const lineCount = content.split("\n").length;
+        if (!dryRun) {
+            writeFileSync(outPath, content, "utf-8");
+        }
+        results.push({
+            file: `convex/taskSystem/${name}.ts`,
+            lines: lineCount,
+        });
+    }
+    return results;
+}
+//# sourceMappingURL=uca-functions.js.map

package/dist/generators/uca-functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uca-functions.js","sourceRoot":"","sources":["../../src/generators/uca-functions.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,mCAAmC;AACnC,sDAAsD;AACtD,+DAA+D;AAE/D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAOtC,MAAM,kBAAkB,GAAG;IACzB,UAAU;IACV,gBAAgB;IAChB,aAAa;IACb,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,YAAY;IACZ,eAAe;IACf,aAAa;IACb,WAAW;CACH,CAAC;AAEX,SAAS,kBAAkB;IACzB,qDAAqD;IACrD,iDAAiD;IACjD,sDAAsD;IACtD,OAAO,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,GAAqB;IACxD,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAClC,MAAM,WAAW,GAAG,kBAAkB,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;IACvD,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,KAAK,MAAM,IAAI,IAAI,kBAAkB,EAAE,CAAC;QACtC,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;QAE3C,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,sCAAsC,YAAY,EAAE,CAAC,CAAC;YACnE,SAAS;QACX,CAAC;QAED,oEAAoE;QACpE,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACpD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QAE7C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,qBAAqB,IAAI,KAAK;YACpC,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/generators/uca-reexports.d.ts

@@ -0,0 +1,8 @@
+import type { GeneratorContext } from "@yattalo/task-system-core";
+interface GeneratorResult {
+    file: string;
+    lines: number;
+}
+export declare function generateUcaReexports(ctx: GeneratorContext): GeneratorResult[];
+export {};
+//# sourceMappingURL=uca-reexports.d.ts.map

package/dist/generators/uca-reexports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uca-reexports.d.ts","sourceRoot":"","sources":["../../src/generators/uca-reexports.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAuFD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,gBAAgB,GAAG,eAAe,EAAE,CA2B7E"}

package/dist/generators/uca-reexports.js

@@ -0,0 +1,112 @@
+// ============================================================
+// Generator: UCA Re-export Wrappers
+// Creates top-level convex/ files that re-export from taskSystem/
+// This makes the API surface match the pre-built SPA dashboard
+// (e.g., api.tasks.list instead of api.taskSystem.tasks.list)
+// ============================================================
+import { existsSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+// Map of top-level file -> exports from taskSystem module
+const REEXPORT_MAP = {
+    tasks: {
+        source: "./taskSystem/ucaTasks",
+        exports: [
+            "list", "stats", "getByTaskId", "create", "upsert",
+            "updateStatus", "markDoneWithCommit", "captureCommitFromGitHook",
+            "addCommit", "addBlocker", "resolveBlocker", "updateNotes",
+        ],
+    },
+    contextEntries: {
+        source: "./taskSystem/contextEntries",
+        exports: ["list", "stats", "create", "promote", "addValidation", "updateSummary"],
+    },
+    driftEvents: {
+        source: "./taskSystem/driftEvents",
+        exports: ["list", "stats", "create", "resolve", "dismiss", "acknowledge"],
+    },
+    agents: {
+        source: "./taskSystem/agents",
+        exports: ["list", "stats", "register", "updateStatus"],
+    },
+    memory: {
+        source: "./taskSystem/memory",
+        exports: [
+            "listMemory", "memoryStats", "addMemory", "searchMemory",
+            "consolidateHotMemory", "syncMemoryToContext",
+        ],
+    },
+    skills: {
+        source: "./taskSystem/skills",
+        exports: [
+            "listSkills", "upsertSkill", "removeSkill", "listAgentSkills",
+            "assignSkillToAgent", "toggleAgentSkill", "buildPromptForTask",
+        ],
+    },
+    hooks: {
+        source: "./taskSystem/hooks",
+        exports: [
+            "listEvents", "listWebhooks", "registerWebhook",
+            "setWebhookEnabled", "emitEvent", "ingestWebhook",
+        ],
+    },
+    heartbeats: {
+        source: "./taskSystem/heartbeats",
+        exports: [
+            "beat", "getAgentHeartbeat", "listHeartbeats",
+            "statusSummary", "internalSweepStaleHeartbeats",
+        ],
+    },
+    sessionBridge: {
+        source: "./taskSystem/sessionBridge",
+        exports: [
+            "sendMessage", "inbox", "markDelivered",
+            "acknowledgeMessage", "handoffTask", "internalExpireMessages",
+        ],
+    },
+    cronManager: {
+        source: "./taskSystem/cronManager",
+        exports: [
+            "listSchedules", "createSchedule", "updateSchedule",
+            "deleteSchedule", "enqueue", "completeQueueItem",
+            "internalDispatchDueSchedules",
+        ],
+    },
+};
+function generateReexportContent(name, config) {
+    const lines = [
+        `// ============================================================`,
+        `// Re-export: ${name} — generated by @yattalo/task-system`,
+        `// Maps api.${name}.* to convex/taskSystem/${name}.*`,
+        `// DO NOT EDIT — re-run 'npx @yattalo/task-system init' to update`,
+        `// ============================================================`,
+        ``,
+        `export {`,
+        ...config.exports.map((e, i, arr) => `  ${e}${i < arr.length - 1 ? "," : ""}`),
+        `} from "${config.source}";`,
+        ``,
+    ];
+    return lines.join("\n");
+}
+export function generateUcaReexports(ctx) {
+    const { targetDir, dryRun } = ctx;
+    const convexDir = join(targetDir, "convex");
+    const results = [];
+    for (const [name, config] of Object.entries(REEXPORT_MAP)) {
+        const outPath = join(convexDir, `${name}.ts`);
+        // Skip if file already exists (don't overwrite user code)
+        if (existsSync(outPath)) {
+            continue;
+        }
+        const content = generateReexportContent(name, config);
+        const lineCount = content.split("\n").length;
+        if (!dryRun) {
+            writeFileSync(outPath, content, "utf-8");
+        }
+        results.push({
+            file: `convex/${name}.ts`,
+            lines: lineCount,
+        });
+    }
+    return results;
+}
+//# sourceMappingURL=uca-reexports.js.map

package/dist/generators/uca-reexports.js.map

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

package/dist/generators/uca-schema.d.ts

@@ -0,0 +1,8 @@
+import type { GeneratorContext } from "@yattalo/task-system-core";
+interface GeneratorResult {
+    file: string;
+    lines: number;
+}
+export declare function generateUcaSchema(ctx: GeneratorContext): GeneratorResult;
+export {};
+//# sourceMappingURL=uca-schema.d.ts.map

package/dist/generators/uca-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uca-schema.d.ts","sourceRoot":"","sources":["../../src/generators/uca-schema.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB,GAAG,eAAe,CAqoBxE"}