reflex-agent 0.2.1

package/dist/lib/reflex/agents/prompts.js

@@ -0,0 +1,228 @@
+import path from "node:path";
+import { loadTemplate } from "../prompts/store.js";
+import { renderTemplate } from "../prompts/render.js";
+const MAX_FILE_LIST = 400;
+const DEFAULT_LANGUAGE = "english";
+export async function analyzePrompt(scope) {
+    const template = await loadTemplate("analyze");
+    const relScope = path.relative(scope.root, scope.scope) || ".";
+    const trimmed = scope.files.slice(0, MAX_FILE_LIST);
+    const overflow = scope.files.length > MAX_FILE_LIST
+        ? `\n…and ${scope.files.length - MAX_FILE_LIST} more files (truncated).`
+        : "";
+    return renderTemplate(template, {
+        language: scope.language ?? DEFAULT_LANGUAGE,
+        root: scope.root,
+        scope: scope.scope,
+        relScope,
+        reflexScope: scope.reflexScope,
+        files: trimmed.map((f) => `  - ${f}`).join("\n"),
+        fileCount: scope.files.length,
+        overflow,
+    });
+}
+export async function chatSystemPrompt(scope) {
+    const template = await loadTemplate("chat");
+    const rendered = renderTemplate(template, {
+        language: scope.language ?? DEFAULT_LANGUAGE,
+        root: scope.root,
+        scope: scope.scope,
+        reflexScope: scope.reflexScope,
+    });
+    // Routing/dispatch instructions are appended at runtime (not via the
+    // user-editable chat.md template) so the protocol contract stays in lock-
+    // step with the manager's parser, regardless of any local prompt edits.
+    return [
+        rendered,
+        dispatchInstructions(),
+        widgetInstructions(),
+        workflowInstructions(),
+        imageGenInstructions(),
+    ].join("\n\n");
+}
+/**
+ * Inline image generation via `<<reflex:image-gen>>`. Reflex calls
+ * Gemini Nano Banana (or Codex `$imagegen`) post-turn, saves the bytes
+ * under the project's `.reflex/assets/images/` and inserts a markdown
+ * `![]()` reference into THIS assistant message.
+ */
+function imageGenInstructions() {
+    return [
+        "## Generating images inline",
+        "",
+        "When the user asks to draw, generate, or illustrate something (\"нарисуй кота\", \"сделай иллюстрацию\", \"сгенерируй превью\"), DON'T describe what you'd draw — emit an image-gen marker and Reflex will render the actual image inside your reply.",
+        "",
+        "```",
+        `<<reflex:image-gen>>{`,
+        `  "prompt": "детальный английский или русский промпт описывающий картинку",`,
+        `  "provider": "gemini",`,
+        `  "aspectRatio": "16:9",`,
+        `  "caption": "короткая подпись (опционально)",`,
+        `  "attachToKb": false`,
+        `}<</reflex:image-gen>>`,
+        "```",
+        "",
+        "- `provider`: `\"gemini\"` (Nano Banana, дефолт, дёшево и быстро) или `\"codex\"` (через `$imagegen` в Codex CLI).",
+        "- `aspectRatio`: `\"1:1\"`, `\"16:9\"`, `\"9:16\"`, `\"4:3\"` и т.п. Опционально.",
+        "- `attachToKb: true` — также сохранить картинку в KB как `kind: \"image\"` для будущей переподборки.",
+        "- Можно эмитить несколько маркеров за один ответ — будет N картинок подряд.",
+        "- Промпт пиши развёрнутый: стиль (фотореализм / акварель / 3D / иллюстрация), композиция, освещение, настроение. Чем конкретнее — тем лучше результат.",
+        "- НЕ описывай словами «вот картинка кота» — просто эмить маркер; Reflex сам вставит изображение в твой ответ.",
+    ].join("\n");
+}
+/**
+ * Workflows are linear "recipes" (steps run sequentially). Designed for
+ * non-programmers — the agent's job is to compose them from typed nodes
+ * (text-template, http-request, web-fetch, ask-agent, kb-write) when
+ * the user asks for "автоматизацию", "регулярную задачу", "робота".
+ */
+function workflowInstructions() {
+    return [
+        "## Workflows — встроенный «n8n для домохозяек»",
+        "",
+        "Когда пользователь хочет автоматизировать что-то регулярное (утренний дайджест, мониторинг страницы, рутина «скачай → обработай → запиши»), эмить маркер `<<reflex:workflow-create>>` — Reflex сохранит workflow на диск и покажет превью со ссылкой на редактор.",
+        "",
+        "```",
+        `<<reflex:workflow-create>>{`,
+        `  "id": "<kebab-case-id>",`,
+        `  "label": "<short title>",`,
+        `  "description": "<one line>",`,
+        `  "trigger": "manual" | "hourly" | "daily" | "weekly",`,
+        `  "steps": [`,
+        `    {"id": "fetch", "kind": "web-fetch", "label": "Скачать HN", "params": {"url": "https://news.ycombinator.com/rss"}},`,
+        `    {"id": "digest", "kind": "ask-agent", "label": "Сжать в дайджест", "params": {"prompt": "Сожми топ-5 заголовков из RSS:\\n{{prev}}"}},`,
+        `    {"id": "save", "kind": "kb-write", "label": "Записать в KB", "params": {"kind": "digest", "title": "HN дайджест", "body": "{{prev}}"}}`,
+        `  ]`,
+        `}<</reflex:workflow-create>>`,
+        "```",
+        "",
+        "### Доступные `kind` шагов",
+        "",
+        "- `text-template` — `{template: string}`. Подстановки: `{{prev}}`, `{{steps.<id>.output}}`, `{{input.<field>}}`, `{{workflow.label}}`.",
+        "- `http-request` — `{url, method?, headers?: string-JSON, body?}`. Output: текст или JSON (по content-type).",
+        "- `web-fetch` — `{url}`. Простой GET, output — текст ответа.",
+        "- `ask-agent` — `{prompt}`. Запускает headless orchestrator и возвращает текст ответа. Используй для суммаризации, перефразирования, классификации.",
+        "- `kb-write` — `{kind, title, body}`. Сохраняет в базу знаний как обычный KB-файл.",
+        "",
+        "### Правила",
+        "",
+        "- Каждый step передаёт output следующему через `{{prev}}` или `{{steps.<id>.output}}`. Это единственная связь между шагами.",
+        "- `id` step'а должен быть стабильный и kebab-case — на него ссылаются templates.",
+        "- Шаги выполняются строго последовательно. Если step упадёт — остальные не запустятся, run отметится failed.",
+        "- Делай workflow КОРОТКИМИ (3-5 шагов). Если задача больше — разбей на несколько workflows или дай агенту через `ask-agent` сделать сложную часть.",
+        "- Trigger `manual` по умолчанию. `hourly`/`daily`/`weekly` пока работают только через ручной запуск, scheduler в работе.",
+        "- После эмита маркера — короткое сообщение пользователю: что собрал, как запустить, где редактировать.",
+    ].join("\n");
+}
+/**
+ * Tells the orchestrator about the widget system: how to materialize a
+ * structured result on the project dashboard via `<<reflex:widget-create>>`
+ * (or `widget-update`) markers, what kinds Reflex understands, and the
+ * data-shape per kind. Kept inline here so the protocol stays in sync
+ * with the manager's parser regardless of template edits.
+ */
+function widgetInstructions() {
+    return [
+        "## Widgets: putting results on the project dashboard",
+        "",
+        "When the user wants you to produce something durable — a news digest, a checklist, a KPI snapshot, a curated link list — DON'T just answer in chat and forget. Materialize it as a **widget** on the project dashboard so the user sees it on every visit.",
+        "",
+        "Emit a marker on its own block:",
+        "",
+        "```",
+        `<<reflex:widget-create>>{`,
+        `  "id": "<kebab-case-id>",`,
+        `  "title": "<short user-visible title>",`,
+        `  "description": "<one-line subtitle, optional>",`,
+        `  "kind": "<one of: markdown, news-list, link-list, kpi, checklist, quote, kb-pinned, progress, image, stat-table, map>",`,
+        `  "data": { ...kind-specific payload... },`,
+        `  "size": { "mode": "md" }`,
+        `}<</reflex:widget-create>>`,
+        "```",
+        "",
+        "Use `widget-update` (same shape, same id) when refreshing an existing widget — e.g. user asked for a weekly news digest, you regenerate the items.",
+        "",
+        "### Auto-refresh and memory",
+        "",
+        "- `refresh`: `\"manual\"` (default) | `\"hourly\"` | `\"daily\"` | `\"weekly\"`. When set to anything other than manual, Reflex's scheduler will periodically re-invoke you on the source topic with a synthetic `[Reflex] Refresh widget <id>` user-message — you respond by emitting a fresh `<<reflex:widget-update>>` with the same id.",
+        "- `memory`: agent-managed inline state (markdown, <2KB). Use for **short** state that should persist across refreshes — e.g. \"already-shown URLs to dedupe\", \"last 4 KPI snapshots\", \"running tally\". On every refresh prompt you'll see the current `memory` value; emit an updated one inside the widget-update payload.",
+        "- `memoryFile`: rel-path (inside `.reflex/`) for **long** memory — a journal-style markdown file you append to via the regular `<<reflex:kb>>` directive. Use for OKR-history-style widgets where the journal itself is worth keeping in the KB tree. Pick a path like `widgets/<widget-id>.memory.md`.",
+        "- Pick ONE of `memory` or `memoryFile` per widget. Inline for compact structured deduping; file for narrative history.",
+        "- When refreshing, prefer **incremental** updates: dedupe against memory, add new items at the top, drop very old ones — the user wants signal, not a snapshot reset.",
+        "",
+        "### Kinds and `data` shapes",
+        "",
+        "- `markdown` — `{body: string}`. Long-form notes, summaries, instructions.",
+        "- `news-list` — `{items: [{title, url?, summary?, source?, date?}]}`. Headlines + 1-2 line summaries.",
+        "- `link-list` — `{items: [{title, url, hint?}]}`. Curated resources, bookmarks.",
+        "- `kpi` — `{items: [{label, value, hint?, delta?: \"up\"|\"down\"|\"flat\"}]}`. Big-number tiles.",
+        "- `checklist` — `{items: [{text, done?: boolean}]}`. Action items / todo.",
+        "- `quote` — `{text, attribution?}`. One memorable quote.",
+        "- `kb-pinned` — `{items: [{rel, title?, snippet?}]}`. Pinned KB rel-paths.",
+        "- `progress` — `{items: [{label, current, target, unit?}]}`. Goal-tracking bars.",
+        "- `image` — `{url, alt?, caption?}`. Single image card.",
+        "- `stat-table` — `{columns?: [string], rows: [[string, ...]]}`. Compact comparison table.",
+        "- `map` — `{points: [{lat, lng, title, description?}], center?, zoom?, route?: {stops: number[], color?, mode?}}`. Карта с точками + опциональный маршрут (полилиния + multi-waypoint deep-links: google/yandex/2gis/apple/osm/waze/organic). `route.stops` — массив индексов в `points` в порядке прохождения (минимум 2). На каждой точке popup с фирменными кнопками сервисов. По умолчанию карта авто-фитит по точкам. ВАЖНО: `lat`/`lng` — числа в десятичных градусах (lat=55.7558, lng=37.6173 — Москва). НЕ строки. Если у тебя адрес — найди координаты через WebSearch/WebFetch (geocoding), не выдумывай. Пользователь может прямо в виджете искать места (Nominatim) и собирать маршрут — кнопка «Маршрут» переводит в режим выбора точек по клику.",
+        "",
+        "### Interactivity",
+        "",
+        "Виджеты на дашборде интерактивны — пользователь может прямо в UI:",
+        "  - **checklist**: тыкать галочки (toggle done), удалять пункты, добавлять новые.",
+        "  - **link-list**: удалять ссылки.",
+        "  - **news-list**: помечать новость прочитанной (`read:true`), убирать карточку.",
+        "  - **kb-pinned**: откреплять файлы.",
+        "  - **progress**: ± кнопки на `current`.",
+        "",
+        "Эти изменения пишутся прямо на диск, минуя тебя. На следующем `widget-update` ты увидишь актуальное состояние. Стратегия:",
+        "  - Если пользователь удалил пункт чек-листа — не добавляй его обратно (это сигнал).",
+        "  - Если пользователь отметил новость прочитанной — внеси её URL в `memory` для дедупа.",
+        "  - Если пользователь обнулил progress — это, видимо, новый цикл; уважай.",
+        "",
+        "### Rules",
+        "",
+        "- Pick the SIMPLEST kind that fits — don't squeeze a news digest into `markdown` if `news-list` exists.",
+        "- `id` is stable: same id across `widget-create` and `widget-update`. Pick a slug from the topic content (e.g. `tech-news-weekly`, `okrs-q2`).",
+        "- `size.mode`: `\"sm\"` (3 в ряд, иконки/KPI) | `\"md\"` (по умолчанию, 2 в ряд) | `\"wide\"` (на всю строку, для длинных таблиц/markdown). Подбирай к контенту, но пользователь может переопределить через UI — твой выбор всего лишь hint.",
+        "- After emitting the marker, briefly tell the user in plain text WHAT виджет ты собрал. ВАЖНО: новый виджет НЕ появляется на дашборде автоматически — он лежит в библиотеке как черновик. Пользователь увидит его прямо в чате (превью) и сможет закрепить кнопкой «Закрепить на дашборде» или через библиотеку. Не утверждай, что виджет уже на дашборде.",
+        "- Reflex automatically shows a live preview of the widget inside this chat turn — no need to re-render in markdown.",
+    ].join("\n");
+}
+/**
+ * Standalone block describing the sub-agent roles and the
+ * `<<reflex:dispatch>>` marker. Kept here (not in the user-editable
+ * template) so the wire protocol stays in sync with the parser in
+ * `lib/server/agents/manager.ts`.
+ */
+function dispatchInstructions() {
+    return [
+        "## Routing: you are an orchestrator, not the worker",
+        "",
+        "For anything non-trivial (deep KB reading, multi-file research, code writes, utility creation, summarization of large texts) — DELEGATE to a specialist sub-agent instead of doing it yourself. Sub-agents run with a focused system prompt and a constrained toolset.",
+        "",
+        "Available roles:",
+        "  - **researcher** — read-only KB / web research. Use for \"найди / собери / процитируй\".",
+        "  - **coder** — writes/edits files (Write/Edit + read tools). Use for \"сделай / поправь / создай файл\".",
+        "  - **summarizer** — no tools; compresses long text from the brief. Use for \"сожми / выдели главное\" из большого куска.",
+        "  - **kb-writer** — designs a structured KB entry (returns JSON for <<reflex:kb>>). Use when something is worth saving but the shape is non-trivial.",
+        "  - **utility-builder** — designs a Reflex utility (manifest + ui.tsx). Use when the user asks to build a new utility.",
+        "",
+        "To dispatch, emit one or more markers in a single turn and STOP:",
+        "",
+        "  <<reflex:dispatch>>{\"id\":\"r1\",\"role\":\"researcher\",\"brief\":\"Прочитай INDEX.md и собери список тем.\"}<</reflex:dispatch>>",
+        "",
+        "Rules:",
+        "  - `brief` must be self-contained — sub-agents do NOT see the chat transcript. Include all rel-paths, expected output shape, constraints.",
+        "  - Multiple dispatches in one turn run **concurrently**. Sequentially-dependent tasks → do them across multiple turns.",
+        "  - After dispatches Reflex re-invokes you with each sub-agent's output quoted. Compose the final user-facing reply from those results.",
+        "  - Do simple things yourself (one short answer, citing one file). Don't dispatch trivia.",
+        "  - Don't re-dispatch the same brief if a sub-agent returned empty — either solve it yourself or ask the user.",
+        "",
+        "Optional harness routing:",
+        "  - Add `\"harness\":\"codex\"` to the dispatch payload to run THAT sub-agent on Codex instead of inheriting yours. Useful when:",
+        "    – task is heavy code synthesis / refactor / type-fixing — Codex shines there.",
+        "    – task is short text classification / extraction — `\"harness\":\"ollama\"` is cheap and fast.",
+        "  - Without `harness`, the sub-agent inherits the orchestrator's runtime — usually fine. Override only when you have a concrete reason.",
+        "  - Example: `<<reflex:dispatch>>{\"role\":\"coder\",\"harness\":\"codex\",\"brief\":\"Перепиши X на TypeScript strict\"}<</reflex:dispatch>>`",
+    ].join("\n");
+}
+//# sourceMappingURL=prompts.js.map

package/dist/lib/reflex/agents/prompts.js.map

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

package/dist/lib/reflex/commands/chat.js

@@ -0,0 +1,41 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { loadConfig } from "../config.js";
+import { getBackend } from "../agents/index.js";
+import { REFLEX_DIR, mirrorInReflex, reflexRoot } from "../paths.js";
+export async function runChat(targetInput) {
+    const target = path.resolve(targetInput);
+    await assertDir(target);
+    const root = await findReflexRoot(target);
+    if (!root) {
+        throw new Error(`No ${REFLEX_DIR}/ found at or above ${target}. Run \`reflex init <dir>\` first.`);
+    }
+    const cfg = await loadConfig(root);
+    const relScope = path.relative(root, target);
+    const reflexScope = relScope
+        ? mirrorInReflex(root, relScope)
+        : reflexRoot(root);
+    const backend = getBackend(cfg);
+    await backend.chat({ root, scope: target, reflexScope });
+}
+async function assertDir(p) {
+    const stat = await fs.stat(p).catch(() => null);
+    if (!stat || !stat.isDirectory()) {
+        throw new Error(`Not a directory: ${p}`);
+    }
+}
+/** Walk upward from `start` looking for a directory containing `.reflex/`. */
+async function findReflexRoot(start) {
+    let cur = start;
+    while (true) {
+        const candidate = path.join(cur, REFLEX_DIR);
+        const stat = await fs.stat(candidate).catch(() => null);
+        if (stat && stat.isDirectory())
+            return cur;
+        const parent = path.dirname(cur);
+        if (parent === cur)
+            return null;
+        cur = parent;
+    }
+}
+//# sourceMappingURL=chat.js.map

package/dist/lib/reflex/commands/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../../../lib/reflex/commands/chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,WAAmB;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACzC,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;IACxB,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,MAAM,UAAU,uBAAuB,MAAM,oCAAoC,CAClF,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,QAAQ;QAC1B,CAAC,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC;QAChC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAErB,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,CAAS;IAChC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,KAAK,UAAU,cAAc,CAAC,KAAa;IACzC,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACxD,IAAI,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE;YAAE,OAAO,GAAG,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QAChC,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/lib/reflex/commands/init.js

@@ -0,0 +1,38 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { loadConfig, writeConfig } from "../config.js";
+import { getBackend } from "../agents/index.js";
+import { ensureReflexIgnoreTemplate, snapshotScope } from "../kb.js";
+import { reflexRoot } from "../paths.js";
+export async function runInit(dirInput, options = {}) {
+    const root = path.resolve(dirInput);
+    await assertDir(root);
+    await fs.mkdir(reflexRoot(root), { recursive: true });
+    const cfg = await loadConfig(root);
+    await writeConfig(root, cfg); // persist normalized config
+    await ensureReflexIgnoreTemplate(root);
+    if (options.scaffoldOnly) {
+        process.stdout.write(`Reflex scaffolded at ${reflexRoot(root)} (scaffold-only).\n`);
+        return;
+    }
+    const effectiveCfg = options.harness
+        ? { ...cfg, agentBackend: options.harness }
+        : cfg;
+    const snapshot = await snapshotScope({ root, scope: root });
+    const scopeWithOverrides = {
+        ...snapshot,
+        ...(options.model ? { model: options.model } : {}),
+        ...(options.language ? { language: options.language } : {}),
+    };
+    process.stdout.write(`Running ${effectiveCfg.agentBackend}${options.model ? ` (${options.model})` : ""}${options.language ? ` [lang=${options.language}]` : ""} over ${root} (${snapshot.files.length} files visible)…\n`);
+    const backend = getBackend(effectiveCfg);
+    await backend.analyzeScope(scopeWithOverrides);
+    process.stdout.write(`Done. KB written under ${reflexRoot(root)}\n`);
+}
+async function assertDir(p) {
+    const stat = await fs.stat(p).catch(() => null);
+    if (!stat || !stat.isDirectory()) {
+        throw new Error(`Not a directory: ${p}`);
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/lib/reflex/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../../lib/reflex/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,WAAW,EAAe,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,0BAA0B,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAazC,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,QAAgB,EAChB,UAAuB,EAAE;IAEzB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IAEtB,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,4BAA4B;IAC1D,MAAM,0BAA0B,CAAC,IAAI,CAAC,CAAC;IAEvC,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,wBAAwB,UAAU,CAAC,IAAI,CAAC,qBAAqB,CAC9D,CAAC;QACF,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAW,OAAO,CAAC,OAAO;QAC1C,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,YAAY,EAAE,OAAO,CAAC,OAAO,EAAE;QAC3C,CAAC,CAAC,GAAG,CAAC;IACR,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,MAAM,kBAAkB,GAAG;QACzB,GAAG,QAAQ;QACX,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5D,CAAC;IACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,WAAW,YAAY,CAAC,YAAY,GAClC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAC1C,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,SAAS,IAAI,KAAK,QAAQ,CAAC,KAAK,CAAC,MAAM,oBAAoB,CACpH,CAAC;IAEF,MAAM,OAAO,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IACzC,MAAM,OAAO,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC;IAE/C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACvE,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,CAAS;IAChC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC"}

package/dist/lib/reflex/commands/start.js

@@ -0,0 +1,64 @@
+import { promises as fs } from "node:fs";
+import { createServer } from "node:http";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawn } from "node:child_process";
+export async function runStart(opts) {
+    const pkgRoot = await findPackageRoot();
+    await assertBuilt(pkgRoot);
+    // Lazy-import to avoid pulling Next into CLI-only commands.
+    const nextMod = (await import("next"));
+    const app = nextMod.default({ dev: false, dir: pkgRoot });
+    await app.prepare();
+    const handler = app.getRequestHandler();
+    await new Promise((resolve, reject) => {
+        const server = createServer((req, res) => {
+            void handler(req, res);
+        });
+        server.once("error", reject);
+        server.listen(opts.port, opts.host, () => {
+            const url = `http://${displayHost(opts.host)}:${opts.port}`;
+            process.stdout.write(`Reflex running at ${url}\n`);
+            if (opts.open)
+                openBrowser(url);
+        });
+        const shutdown = (signal) => {
+            process.stdout.write(`\n[reflex] ${signal} received, stopping…\n`);
+            server.close(() => resolve());
+            setTimeout(() => process.exit(0), 2000).unref();
+        };
+        process.on("SIGINT", shutdown);
+        process.on("SIGTERM", shutdown);
+    });
+}
+async function findPackageRoot() {
+    // dist/lib/reflex/commands/start.js → repo root is 4 levels up.
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    return path.resolve(here, "..", "..", "..", "..");
+}
+async function assertBuilt(pkgRoot) {
+    const required = path.join(pkgRoot, ".next", "BUILD_ID");
+    try {
+        await fs.access(required);
+    }
+    catch {
+        throw new Error(`Reflex web bundle not found at ${pkgRoot}/.next. If running from source, run \`pnpm run build\` first.`);
+    }
+}
+function displayHost(host) {
+    if (host === "0.0.0.0" || host === "::")
+        return "localhost";
+    return host;
+}
+function openBrowser(url) {
+    const platform = process.platform;
+    const cmd = platform === "darwin" ? "open" : platform === "win32" ? "cmd" : "xdg-open";
+    const args = platform === "win32" ? ["/c", "start", "", url] : [url];
+    try {
+        spawn(cmd, args, { stdio: "ignore", detached: true }).unref();
+    }
+    catch {
+        // Browser launch is best-effort.
+    }
+}
+//# sourceMappingURL=start.js.map

package/dist/lib/reflex/commands/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../../lib/reflex/commands/start.ts"],"names":[],"mappings":"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"}

package/dist/lib/reflex/commands/watch.js

@@ -0,0 +1,137 @@
+import chokidar from "chokidar";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { loadConfig } from "../config.js";
+import { buildFlatIgnore } from "../ignore.js";
+import { getBackend } from "../agents/index.js";
+import { snapshotScope } from "../kb.js";
+import { MIN_DEBOUNCE_MS, REFLEX_DIR, reflexRoot } from "../paths.js";
+/**
+ * Start a background watcher on `dirInput`. The agent is re-run on the root
+ * scope whenever there are pending changes AND it has been at least
+ * `watchDebounceMs` since the last run. Floor: 30 min (HARD_DEBOUNCE_FLOOR_MS).
+ *
+ * Returns a handle so callers (tests, programmatic use) can stop the watcher;
+ * the CLI just lets it run until SIGINT.
+ */
+export async function runWatch(dirInput) {
+    const root = path.resolve(dirInput);
+    await assertDir(root);
+    const cfg = await loadConfig(root);
+    const debounceMs = Math.max(cfg.watchDebounceMs, MIN_DEBOUNCE_MS);
+    const flatIgnore = await buildFlatIgnore(root);
+    const reflexAbs = reflexRoot(root);
+    const watcher = chokidar.watch(root, {
+        ignoreInitial: true,
+        persistent: true,
+        // Coalesce rapid writes to the same file (atomic-save patterns, double
+        // FSEvents on macOS) into a single change event.
+        awaitWriteFinish: { stabilityThreshold: 200, pollInterval: 50 },
+        ignored: (p) => {
+            if (p === root)
+                return false;
+            // Always exclude .reflex/ to avoid feedback loops.
+            if (p === reflexAbs || p.startsWith(reflexAbs + path.sep))
+                return true;
+            return flatIgnore(p);
+        },
+    });
+    // Coalesce rapid bursts (writes across different files arriving back-to-back)
+    // into a single trigger. The "burst window" is the quiet period after the
+    // last event below which we don't consider the burst settled.
+    const BURST_MS = 300;
+    let lastRunAt = 0;
+    let lastEventAt = 0;
+    let pendingSince = null;
+    let scheduled = null;
+    let running = false;
+    let stopped = false;
+    const schedule = () => {
+        if (stopped || scheduled)
+            return;
+        const now = Date.now();
+        const debounceWait = Math.max(0, lastRunAt + debounceMs - now);
+        const burstWait = Math.max(0, lastEventAt + BURST_MS - now);
+        const delay = Math.max(debounceWait, burstWait);
+        scheduled = setTimeout(() => {
+            scheduled = null;
+            void tick();
+        }, delay);
+    };
+    const tick = async () => {
+        if (stopped || running)
+            return;
+        if (pendingSince === null)
+            return;
+        const now = Date.now();
+        if (now - lastRunAt < debounceMs ||
+            now - lastEventAt < BURST_MS) {
+            // Either debounce or burst window not yet satisfied — re-arm.
+            schedule();
+            return;
+        }
+        running = true;
+        const triggeredAt = pendingSince;
+        pendingSince = null;
+        try {
+            const snapshot = await snapshotScope({ root, scope: root });
+            process.stdout.write(`[reflex] change detected at ${new Date(triggeredAt).toISOString()} — refreshing KB (${snapshot.files.length} files)…\n`);
+            const backend = getBackend(cfg);
+            await backend.analyzeScope(snapshot);
+            lastRunAt = Date.now();
+            process.stdout.write(`[reflex] KB refresh complete.\n`);
+        }
+        catch (err) {
+            process.stderr.write(`[reflex] agent run failed: ${describeErr(err)}\n`);
+            // Restore pending so we retry after the next debounce window.
+            pendingSince ??= triggeredAt;
+        }
+        finally {
+            running = false;
+            if (pendingSince !== null)
+                schedule();
+        }
+    };
+    const onChange = (changedPath) => {
+        if (stopped)
+            return;
+        if (changedPath.startsWith(reflexAbs))
+            return;
+        lastEventAt = Date.now();
+        pendingSince ??= lastEventAt;
+        schedule();
+    };
+    watcher.on("add", onChange);
+    watcher.on("change", onChange);
+    watcher.on("unlink", onChange);
+    watcher.on("addDir", onChange);
+    watcher.on("unlinkDir", onChange);
+    watcher.on("error", (err) => process.stderr.write(`[reflex] watcher error: ${describeErr(err)}\n`));
+    process.stdout.write(`[reflex] watching ${root} (debounce: ${formatDuration(debounceMs)}, backend: ${cfg.agentBackend})\n`);
+    process.stdout.write(`[reflex] .reflex/ ignored to prevent feedback loops; using flat ${REFLEX_DIR}/.reflexignore view.\n`);
+    return {
+        async stop() {
+            stopped = true;
+            if (scheduled)
+                clearTimeout(scheduled);
+            await watcher.close();
+        },
+    };
+}
+async function assertDir(p) {
+    const stat = await fs.stat(p).catch(() => null);
+    if (!stat || !stat.isDirectory()) {
+        throw new Error(`Not a directory: ${p}`);
+    }
+}
+function describeErr(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function formatDuration(ms) {
+    if (ms >= 60000)
+        return `${Math.round(ms / 60000)} min`;
+    if (ms >= 1000)
+        return `${Math.round(ms / 1000)} s`;
+    return `${ms} ms`;
+}
+//# sourceMappingURL=watch.js.map

package/dist/lib/reflex/commands/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../../../lib/reflex/commands/watch.ts"],"names":[],"mappings":"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"}

package/dist/lib/reflex/config.js

@@ -0,0 +1,42 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+import { configPath, DEFAULT_DEBOUNCE_MS, MIN_DEBOUNCE_MS, reflexRoot, } from "./paths.js";
+export const ConfigSchema = z.object({
+    watchDebounceMs: z
+        .number()
+        .int()
+        .min(MIN_DEBOUNCE_MS, {
+        message: `watchDebounceMs must be ≥ ${MIN_DEBOUNCE_MS} ms`,
+    })
+        .default(DEFAULT_DEBOUNCE_MS),
+    agentBackend: z.enum(["codex", "claude-code"]).default("claude-code"),
+    ignoreFile: z.string().default(".reflexignore"),
+});
+export const DEFAULT_CONFIG = ConfigSchema.parse({});
+export async function loadConfig(root) {
+    const p = configPath(root);
+    try {
+        const raw = await fs.readFile(p, "utf8");
+        return ConfigSchema.parse(JSON.parse(raw));
+    }
+    catch (err) {
+        if (isNotFound(err))
+            return DEFAULT_CONFIG;
+        throw err;
+    }
+}
+export async function writeConfig(root, cfg) {
+    await fs.mkdir(reflexRoot(root), { recursive: true });
+    await fs.writeFile(configPath(root), JSON.stringify(cfg, null, 2) + "\n", "utf8");
+}
+function isNotFound(err) {
+    return (typeof err === "object" &&
+        err !== null &&
+        "code" in err &&
+        err.code === "ENOENT");
+}
+export function describeConfigPath(root) {
+    return path.relative(process.cwd(), configPath(root)) || configPath(root);
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/reflex/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../lib/reflex/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,eAAe,EACf,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,eAAe,EAAE;QACpB,OAAO,EAAE,6BAA6B,eAAe,KAAK;KAC3D,CAAC;SACD,OAAO,CAAC,mBAAmB,CAAC;IAC/B,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;IACrE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC;CAChD,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,cAAc,GAAW,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAE7D,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACzC,OAAO,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAI,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,cAAc,CAAC;QAC3C,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,GAAW;IACzD,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,MAAM,EAAE,CAAC,SAAS,CAChB,UAAU,CAAC,IAAI,CAAC,EAChB,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EACnC,MAAM,CACP,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,GAAY;IAC9B,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,MAAM,IAAI,GAAG;QACZ,GAAwB,CAAC,IAAI,KAAK,QAAQ,CAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;AAC5E,CAAC"}