sylo-fieldbrain 0.1.0

package/scripts/services/search_service.py

@@ -0,0 +1,250 @@
+"""Hybrid search: keyword tsvector + optional pgvector cosine via simplified RRF."""
+
+from __future__ import annotations
+
+import logging
+from dataclasses import dataclass
+from typing import Any
+
+from sqlalchemy import text
+from sqlalchemy.orm import Session
+
+from _db_lib import check_pgvector, ollama_base_url
+from models import GlobalSettings
+from services.embedding_service import generate_single_embedding
+from services.global_brain_support import get_global_brain_shell_project_id
+
+logger = logging.getLogger(__name__)
+
+KEYWORD_WEIGHT = 0.7
+SEMANTIC_WEIGHT = 0.3
+RRF_K = 60
+SNIPPET_CHARS = 300
+SOURCE_DOCUMENT = "document"
+SOURCE_BRAIN = "brain"
+
+
+@dataclass
+class SearchHit:
+    id: int
+    project_id: int
+    source_type: str
+    source_id: str | None
+    label: str
+    path: str
+    content: str
+    chunk_index: int = 0
+
+
+def _get_embedding_model(session: Session) -> str | None:
+    settings = session.query(GlobalSettings).filter(GlobalSettings.id == 1).first()
+    if settings and settings.embedding_model and settings.embedding_model.strip():
+        return settings.embedding_model.strip()
+    return "nomic-embed-text"
+
+
+def _keyword_search(
+    session: Session,
+    project_ids: list[int],
+    q: str,
+    limit: int,
+    *,
+    source_type: str | None = None,
+) -> list[SearchHit]:
+    filter_sql = ""
+    params: dict[str, Any] = {"pids": project_ids, "q": q.strip(), "lim": limit}
+    if source_type and source_type.strip():
+        filter_sql = " AND source_type = :stype"
+        params["stype"] = source_type.strip()
+
+    rows = session.execute(
+        text(
+            f"""
+            SELECT id, project_id, source_type, source_id, label, path, content, chunk_index
+            FROM search_index
+            WHERE project_id = ANY(:pids)
+              AND search_vector @@ plainto_tsquery('english', :q)
+              {filter_sql}
+            ORDER BY ts_rank_cd(
+                '{{0.1, 0.2, 0.4, 1.0}}'::float4[],
+                search_vector,
+                plainto_tsquery('english', :q)
+            ) DESC
+            LIMIT :lim
+            """
+        ),
+        params,
+    ).fetchall()
+
+    return [
+        SearchHit(
+            id=row[0],
+            project_id=int(row[1]),
+            source_type=row[2],
+            source_id=row[3],
+            label=row[4] or "",
+            path=row[5] or "",
+            content=row[6] or "",
+            chunk_index=int(row[7] or 0),
+        )
+        for row in rows
+    ]
+
+
+def _semantic_search(
+    session: Session,
+    project_ids: list[int],
+    embedding: list[float],
+    limit: int,
+    *,
+    source_type: str | None = None,
+) -> list[SearchHit]:
+    emb_str = "[" + ",".join(str(v) for v in embedding) + "]"
+    filter_sql = ""
+    params: dict[str, Any] = {"pids": project_ids, "emb": emb_str, "lim": limit}
+    if source_type and source_type.strip():
+        filter_sql = " AND source_type = :stype"
+        params["stype"] = source_type.strip()
+
+    try:
+        rows = session.execute(
+            text(
+                f"""
+                SELECT id, project_id, source_type, source_id, label, path, content, chunk_index
+                FROM search_index
+                WHERE project_id = ANY(:pids)
+                  AND embedding IS NOT NULL
+                  {filter_sql}
+                ORDER BY embedding <=> CAST(:emb AS vector)
+                LIMIT :lim
+                """
+            ),
+            params,
+        ).fetchall()
+    except Exception as exc:
+        err = str(exc).lower()
+        if "embedding" in err and "does not exist" in err:
+            logger.warning("Semantic search skipped: no embedding column (%s)", exc)
+        else:
+            logger.warning("Semantic search failed: %s", exc)
+        session.rollback()
+        return []
+
+    return [
+        SearchHit(
+            id=row[0],
+            project_id=int(row[1]),
+            source_type=row[2],
+            source_id=row[3],
+            label=row[4] or "",
+            path=row[5] or "",
+            content=row[6] or "",
+            chunk_index=int(row[7] or 0),
+        )
+        for row in rows
+    ]
+
+
+def _snippet(content: str, max_chars: int = SNIPPET_CHARS) -> str:
+    c = (content or "").strip()
+    if len(c) <= max_chars:
+        return c
+    return c[:max_chars].strip()
+
+
+def _fuse_rrf(
+    keyword_hits: list[SearchHit],
+    semantic_hits: list[SearchHit],
+) -> list[tuple[SearchHit, float]]:
+    kw_rank = {h.id: i for i, h in enumerate(keyword_hits)}
+    sem_rank = {h.id: i for i, h in enumerate(semantic_hits)}
+    all_ids = set(kw_rank) | set(sem_rank)
+
+    hit_by_id: dict[int, SearchHit] = {}
+    for h in keyword_hits:
+        hit_by_id[h.id] = h
+    for h in semantic_hits:
+        hit_by_id.setdefault(h.id, h)
+
+    max_possible = KEYWORD_WEIGHT / (RRF_K + 1) + SEMANTIC_WEIGHT / (RRF_K + 1)
+    scored: list[tuple[SearchHit, float]] = []
+    for doc_id in all_ids:
+        rrf = 0.0
+        if doc_id in kw_rank:
+            rrf += KEYWORD_WEIGHT / (RRF_K + kw_rank[doc_id] + 1)
+        if doc_id in sem_rank:
+            rrf += SEMANTIC_WEIGHT / (RRF_K + sem_rank[doc_id] + 1)
+        normalized = min(rrf / max_possible, 1.0) if max_possible > 0 else 0.0
+        scored.append((hit_by_id[doc_id], normalized))
+
+    scored.sort(key=lambda x: x[1], reverse=True)
+    return scored
+
+
+def _hit_to_dict(hit: SearchHit, score: float, *, global_pid: int | None = None) -> dict[str, Any]:
+    is_global = global_pid is not None and hit.project_id == global_pid
+    return {
+        "id": hit.id,
+        "project_id": None if is_global else hit.project_id,
+        "scope": "global" if is_global else "project",
+        "type": hit.source_type,
+        "source_id": hit.source_id,
+        "label": hit.label,
+        "path": hit.path,
+        "snippet": _snippet(hit.content),
+        "chunk_index": hit.chunk_index,
+        "score": round(score, 4),
+    }
+
+
+def hybrid_search(
+    session: Session,
+    project_id: int | None,
+    query: str,
+    *,
+    limit: int = 25,
+    source_type: str | None = None,
+    use_semantic: bool | None = None,
+) -> list[dict[str, Any]]:
+    """Hybrid search with asymmetric scope visibility.
+
+    project_id given: that project's rows PLUS curated global rows (brain + library).
+    project_id None: global rows only — project-local knowledge stays invisible
+    shop-wide until promoted.
+    Keyword-only when pgvector/Ollama unavailable.
+    """
+    q = (query or "").strip()
+    if not q:
+        return []
+
+    global_pid = get_global_brain_shell_project_id(session)
+    if project_id is None:
+        project_ids = [global_pid]
+    else:
+        project_ids = [int(project_id)]
+        if global_pid not in project_ids:
+            project_ids.append(global_pid)
+
+    cap = max(1, min(int(limit), 50))
+    fetch_lim = max(cap, 50)
+
+    keyword_hits = _keyword_search(session, project_ids, q, fetch_lim, source_type=source_type)
+
+    semantic_hits: list[SearchHit] = []
+    pg_ok, _ = check_pgvector()
+    if use_semantic is not False and pg_ok:
+        emb_model = _get_embedding_model(session)
+        query_emb = generate_single_embedding(q, ollama_base_url(), emb_model)
+        if query_emb:
+            semantic_hits = _semantic_search(
+                session, project_ids, query_emb, fetch_lim, source_type=source_type
+            )
+
+    if not semantic_hits:
+        return [
+            _hit_to_dict(h, 1.0 - (i * 0.01), global_pid=global_pid)
+            for i, h in enumerate(keyword_hits[:cap])
+        ]
+
+    fused = _fuse_rrf(keyword_hits, semantic_hits)
+    return [_hit_to_dict(hit, score, global_pid=global_pid) for hit, score in fused[:cap]]

package/scripts/status.py

@@ -0,0 +1,39 @@
+#!/usr/bin/env python3
+"""Package status for fieldbrain_status tool."""
+
+from __future__ import annotations
+
+import argparse
+from pathlib import Path
+
+from _db_lib import connection_summary, package_root
+from _json_out import emit
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser()
+    args = parser.parse_args()
+    _ = args
+
+    root = package_root()
+    summary = connection_summary()
+
+    emit(
+        {
+            "ok": True,
+            "package_root": str(root),
+            "shared_dir": str(root / "shared"),
+            "scripts_dir": str(root / "scripts"),
+            "operator_chat": (
+                "FieldBrain package is enabled (LogicScout diagnostics included). "
+                "Run fieldbrain_db_check to verify Postgres + pgvector + schema. "
+                "Shared data lives in Postgres; Sylo private chats stay in SQLite. "
+                "PLC L5X parse uses sylo-logicforge — LogicScout tools explore/index only."
+            ),
+            **summary,
+        }
+    )
+
+
+if __name__ == "__main__":
+    main()

package/shared/README.md

@@ -0,0 +1,7 @@
+# LogicScout shared data
+
+**Canonical storage:** Postgres (schema v3+). Brain markdown and document file bytes live in the database so every Sylo install sees the same data.
+
+Optional local cache under `shared/storage/` is not authoritative.
+
+Config: `%USERPROFILE%\.sylo\fieldbrain\database_config.json` (synced from Sylo FieldBrain Settings).

package/skills/fieldbrain/SKILL.md

@@ -0,0 +1,197 @@
+---
+name: fieldbrain
+description: FieldBrain — shared shop knowledge (projects, document/brain libraries, hybrid search). Field notes and fault history live in brains. Requires sylo-fieldbrain.
+metadata:
+  sylo:
+    category: domain
+    icon: brain
+routes:
+  - id: fieldbrain
+    title: FieldBrain
+    icon: brain
+    nav_section: domain
+    entry: routes/fieldbrain/index.html
+    fallback: routes/fieldbrain/fallback.md
+route_protocol_version: 0
+---
+
+# FieldBrain
+
+Shared shop knowledge inside Sylo: projects, document library, brain markdown, hybrid search. Field notes, faults, and fixes are **brain entries** (no separate log system). Works for PLC shops, manufacturing, or any domain where the team needs durable field notes in Postgres.
+
+**Dashboard:** React + TypeScript route (`ui/` → Vite build), same pattern as Health and Think Tank.
+
+**Tracker:** `features_tracker/active/2026-07-04_14-56-00_sylo_fieldbrain_package_migration.md`
+
+## Prerequisites
+
+1. **sylo-fieldbrain** optional package enabled (Capability manager).
+2. **PostgreSQL** reachable (local server or LAN address in settings / `~/.sylo/fieldbrain/database_config.json`).
+3. **pgvector** on that Postgres server (semantic search; guided setup if missing).
+4. **Ollama** for embeddings (default `http://127.0.0.1:11434`).
+
+## First run
+
+1. `fieldbrain_status` — confirm package + config paths.
+2. `fieldbrain_db_migrate` — only if auto-migrate on startup did not run (offline DB, etc.).
+3. `fieldbrain_db_check` — verify connection, pgvector, schema version on every install.
+
+## Document library — catalog flow (primary)
+
+**Do not** run Marker/OCR or `fieldbrain_document_ingest` for normal library work. Search indexes a **catalog summary**, not every page of every PDF.
+
+### Flow
+
+1. **Attach** — `fieldbrain_document_attach` or `fieldbrain_document_catalog` with `file_path` registers bytes in Postgres (global shop library or project-local).
+2. **Read** — use the matching Sylo skill on the same path (operator attachment or cached copy under `~/.sylo/fieldbrain/storage/documents/`).
+3. **Catalog** — `fieldbrain_document_catalog` with your summary, category, tags, optional outline (TOC / sheet tabs / email thread subjects).
+4. **Search** — `fieldbrain_search` finds the doc by summary; open the source file with the reader when you need detail.
+
+### Supported file types (library)
+
+| Extension | Read with | Typical category |
+|-----------|-----------|------------------|
+| `.pdf` | **sylo-pdf-reader** (`search_schematic_pdf`, region tools) | manual, datasheet, schematic |
+| `.xlsx`, `.xlsm`, `.ods` | **sylo-spreadsheet** (`read_spreadsheet`) | spreadsheet, requirements |
+| `.csv` | Pi **`read`** | spreadsheet, requirements |
+| `.txt`, `.md` | Pi **`read`** | howto, guide, email (exported), markdown |
+| `.docx` | **sylo-docx** (`read_docx`; `extract_docx_images` for embedded pictures; `render_docx` to create) | manual, requirements |
+| `.jpg`, `.jpeg`, `.png`, `.webp`, `.gif`, `.bmp` | Vision on attachment — describe panels, labels, wiring | image |
+
+Email chains: save as `.txt` / `.md` / `.eml` export, attach, read, catalog. Raw `.msg` not supported yet.
+
+### Catalog tool fields
+
+- **`description`** (required) — what it is, equipment, when to open it, key fault codes or part numbers if relevant.
+- **`category`** — `manual`, `datasheet`, `requirements`, `email`, `howto`, `guide`, `schematic`, `spreadsheet`, `image`, `markdown`, `reference`, `other`.
+- **`tags`** — comma-separated or JSON array (vendor, product line, machine name).
+- **`outline_json`** — optional TOC or section list: `[{"level":1,"title":"Safety","page":12}]` (`page` is 0-based for PDFs).
+- **`manufacturer`**, **`model`**, **`version`** — when known.
+
+### Images (library + brains)
+
+- Store photos/diagrams in the **global library** (`scope=global`) with `category=image` and a vision-written `description`.
+- In **brain** markdown, reference the file path or note `document #id` in prose; embed `![caption](path)` when the image lives on disk the operator can open.
+- Do not duplicate heavy binaries inside brain bodies; attach once, catalog once, link in brains.
+
+## Tools
+
+| Tool | When |
+|------|------|
+| `fieldbrain_status` | Start — paths and config |
+| `fieldbrain_db_bootstrap` | One-time: create role + database (superuser), pgvector, migrate |
+| `fieldbrain_db_migrate` | Apply Alembic migrations |
+| `fieldbrain_db_check` | After migrate; repeat when connection fails |
+| `fieldbrain_project_list` | List shared projects |
+| `fieldbrain_project_create` | Create a new project (+ brain scaffold) |
+| `fieldbrain_log_*` | **Legacy — do not use.** Field notes are brain entries now (see below). Read old rows with `fieldbrain_log_search` only if asked about pre-migration history. |
+| `fieldbrain_document_list` | List global library or project documents |
+| `fieldbrain_document_attach` | Register file bytes only (no search index) |
+| `fieldbrain_document_catalog` | **Primary** — summary + tags + outline → search index |
+| `fieldbrain_document_promote` | Promote project-local doc to global library (confirm with operator) |
+| `fieldbrain_document_ingest` | Legacy full PDF/text chunk ingest (avoid for new docs) |
+| `fieldbrain_brain_read` | Read brain markdown |
+| `fieldbrain_brain_write` | Write or append brain markdown |
+| `fieldbrain_brain_delete` | Soft-delete a brain doc |
+| `fieldbrain_brain_restore` | Restore a soft-deleted brain doc |
+| `fieldbrain_brain_revisions` | List brain doc revisions |
+| `fieldbrain_search` | Hybrid keyword + semantic search |
+
+## Field notes are brain entries (no separate log system)
+
+Multiple people run their own Sylo against this shared database (controls engineers, electricians). Detail level varies; **you are the normalization layer**. Whether the operator gives a full writeup or one sentence, produce a consistently structured entry.
+
+### Troubleshooting flow (search first)
+
+1. **Problem reported → search before troubleshooting.** `fieldbrain_search` with the machine's `project_id` (global knowledge is included automatically). Someone may have already fixed this.
+2. **Hit found:** surface it — file path, what fixed it last time.
+3. **No hit:** troubleshoot with the operator (LogicForge for PLC logic if enabled; docs, observations).
+4. **Resolved → write the after-action report** to the project brain. Offer this proactively when the operator says it's fixed; don't wait to be asked.
+
+### After-action report (AAR)
+
+New incident: `issues/YYYY-MM-DD_<slug>.md` via `fieldbrain_brain_write`. Header first, then whatever detail the operator gave:
+
+```markdown
+# <one-line symptom>
+- date: 2026-07-04
+- logged_by: <name — ask once if unknown>
+- equipment: <machine/asset, if known>
+- fault_code: <code(s), or "none — sequence stall / no fault">
+- status: resolved | open
+
+## What happened
+## What fixed it
+```
+
+Rules:
+
+- **Fault code is optional.** Many incidents are "machine not doing what it's supposed to" with no fault, or only a generic sequence alarm. Never invent a code; write the symptom instead.
+- **Terse input is fine.** "Fault X, machine stops, sensor came loose" becomes a short but complete AAR. Do not pad or ask more than one clarifying question.
+- **Same issue again:** append to the existing file (`mode=append`) instead of creating a duplicate — search `issues/` first.
+- **Quick capture, no resolution yet:** `inbox/<slug>.md`; distill later.
+- **Recurring pattern:** distill into `gotchas/` (project) or global brain if reusable across machines.
+- **Procedures:** `runbooks/`.
+
+One file per incident keeps concurrent writers from colliding. Brain docs are versioned and soft-deleted like logs were, and `fieldbrain_search` indexes them; the consistent header keeps fault codes and equipment findable regardless of who logged it.
+
+## Scopes and search visibility (asymmetric)
+
+Documents and brains have two scopes: **project** and **global**. Search visibility is one-way:
+
+- **`fieldbrain_search` with `project_id`** — searches that project **plus** the global library/brain in one call. Do not run a second global search.
+- **`fieldbrain_search` without `project_id`** — global only. Project-local knowledge stays invisible shop-wide until promoted. This is deliberate: one machine's fix can be wrong on another machine.
+- Each hit carries `scope: global | project`. When citing a project hit outside its project, say so.
+
+### What goes where
+
+| Content | Scope |
+|---------|-------|
+| Machine/commissioning issues, machine-specific gotchas, production faults | **Project brain** (that machine's project or sub-project) |
+| How-tos, general process steps, anything reusable across machines | **Global brain** |
+| Docs for one job only | Project library |
+| Manuals, datasheets, vendor docs useful shop-wide | Global library (or promote later) |
+
+### Promotion
+
+- **Documents:** `fieldbrain_document_promote` re-scopes a project-local doc to global (index rows move, embeddings kept, project link stays). Confirm with the operator first.
+- **Brains:** no mechanical promote. Project brain notes are context-specific; to make one global, **rewrite it generically** and `fieldbrain_brain_write` to `scope=global`. Ask the operator before doing this.
+
+## Project context before any write
+
+There is **no** default or “active” project in Sylo. The dashboard lists projects and shows `#id`; it does not pick one for chat.
+
+Before **any write** to FieldBrain (brain entry, project-scoped document attach/catalog, project-scoped search target):
+
+1. Run **`fieldbrain_project_list --with-stats`** if you do not already know the ids.
+2. If the operator named a job (`12345`) or sub-project (`12345-001`), match it to a row and use that **`project_id`**.
+3. If unclear which level (job vs sub-project) or which id, **ask once** before writing: “Log this under project **12345** (#12) or sub-project **12345-001** (#15)?”
+4. Do **not** guess, do **not** create a project silently, do **not** assume the last project mentioned in an old turn.
+
+Global library docs (`scope=global`) do not need a project. Everything with `project_id` or `scope=project` does.
+
+## Data split
+
+| Data | Storage |
+|------|---------|
+| Chats, health, operator prefs | Sylo SQLite (private) |
+| Projects, docs, brains | Postgres (shared; content in DB, soft delete + revisions) |
+
+## UI
+
+Dashboard source: `packages/sylo-fieldbrain/ui/` (TypeScript + React, Vite). Built artifacts land in `skills/fieldbrain/routes/fieldbrain/` via `npm run build:ui -w sylo-fieldbrain` (included in `start-sylo.cmd`).
+
+Open **FieldBrain** (Dashboards) for **Projects** (create/list with `#id` and stats), documents, brains, and **Settings** (Postgres + Ollama).
+
+## Projects
+
+Two levels, both are separate rows in Postgres:
+
+| Level | Example | Use for |
+|-------|---------|---------|
+| **Project** | `12345` | Job-wide notes, shared docs, program-level context |
+| **Sub-project** | `12345-001` | Machine / line / unit-specific brains and docs |
+
+Create in the **Projects** tab: project number `12345`, optional sub-project `001`. Or chat: `fieldbrain_project_create` with name `12345` or `12345-001`. Duplicate names rejected. List before creating. Use the `#id` shown in chat; confirm with the operator before logging.
+
+**PLC logic** (L5X export, parse, ladder edits) lives in the **logicforge** skill (`sylo-logicforge` package), not FieldBrain.

package/skills/fieldbrain/SKILL.md.bak

@@ -0,0 +1,83 @@
+---
+name: logicscout
+description: LogicScout — shared PLC project knowledge, document/brain libraries, maintenance logs, AI diagnostics. Requires sylo-logicscout (+ sylo-logicforge for L5X/.acd tooling).
+metadata:
+  sylo:
+    category: plc
+    icon: search
+routes:
+  - id: logicscout
+    title: LogicScout
+    icon: search
+    nav_section: domain
+    entry: routes/logicscout/index.html
+    fallback: routes/logicscout/fallback.md
+route_protocol_version: 0
+---
+
+# LogicScout
+
+Shared shop knowledge and PLC diagnostics inside Sylo. **Postgres** holds projects, document library, brain libraries, and maintenance logs. **SQLite** (Sylo host) keeps private chats.
+
+**Tracker:** `features_tracker/active/2026-07-04_14-56-00_sylo_logicscout_package_migration.md`
+
+## Prerequisites
+
+1. **sylo-logicscout** optional package enabled (Capability manager).
+2. **PostgreSQL** reachable (local server or LAN address in settings / `~/.sylo/logicscout/database_config.json`).
+3. **pgvector** on that Postgres server (semantic search; guided setup if missing).
+4. **Ollama** for embeddings and diagnostics (default `http://127.0.0.1:11434`).
+5. **sylo-logicforge** for `.acd` → L5X and parse — do not duplicate those tools here.
+
+## First run
+
+1. `logicscout_status` — confirm package + config paths.
+2. `logicscout_db_migrate` — once on the shared database (usually the server machine).
+3. `logicscout_db_check` — verify connection, pgvector, schema version on every install.
+
+## Tools
+
+| Tool | When |
+|------|------|
+| `logicscout_status` | Start — paths and config |
+| `logicscout_db_migrate` | First-time DB setup or after package upgrade |
+| `logicscout_db_check` | After migrate; repeat when connection fails |
+| `logicscout_project_list` | List shared PLC projects |
+| `logicscout_project_create` | Create a new project (+ brain folder scaffold) |
+| `logicscout_log_create` | Record a maintenance log entry |
+| `logicscout_log_update` | Update a log entry (previous version saved to revisions) |
+| `logicscout_log_delete` | Soft-delete a log entry (restorable) |
+| `logicscout_log_restore` | Restore a soft-deleted log entry |
+| `logicscout_log_revisions` | List prior versions of a log entry |
+| `logicscout_log_search` | Find past maintenance entries by fault, tag, or text |
+| `logicscout_document_list` | List global library or project-attached documents |
+| `logicscout_document_attach` | Attach existing doc or register a new file (bytes stored in Postgres) |
+| `logicscout_document_ingest` | Ingest PDF/text: extract, chunk, index, embed (pymupdf + Ollama) |
+| `logicscout_brain_read` | Read markdown from project or global brain (Postgres canonical) |
+| `logicscout_brain_write` | Write or append brain markdown (revisions on replace) |
+| `logicscout_brain_delete` | Soft-delete a brain doc (restorable) |
+| `logicscout_brain_restore` | Restore a soft-deleted brain doc |
+| `logicscout_brain_revisions` | List prior versions of a brain doc |
+| `logicscout_search` | Hybrid search (keyword + pgvector when available) |
+| `logicscout_l5x_explore` | Parse an L5X via LogicForge; program/routine summary + rung snippets |
+| `logicscout_find_logic` | Diagnostic search over indexed L5X (optional brain/doc hits) |
+
+## Diagnostics
+
+1. **L5X on disk:** `logicscout_l5x_explore` with `l5x_path` (and optional `filter` for program/routine/tag substring). Uses **LogicForge** `parse_l5x.py` — never duplicate the parser here.
+2. **Indexed project knowledge:** `logicscout_find_logic` with `project_id` + symptom/query. Searches `search_index` for rung, routine, program, tag hits; pass `include_docs: true` for brain/document context.
+3. **Pair with LogicForge** for `.acd` export and full parse pipelines (`logicforge_*` tools).
+4. **Maintenance context:** `logicscout_log_search` before/after diagnostics to surface past faults on the same equipment.
+
+## Data split
+
+| Data | Storage |
+|------|---------|
+| Chats, health, operator prefs | Sylo SQLite (private) |
+| Projects, docs, brains, maintenance logs | Postgres (shared; schema v3: content in DB, soft delete + revisions) |
+
+## L5X / diagnostics
+
+Use **logicforge** tools for `.acd` export and L5X parse. LogicScout diagnostics: `logicscout_l5x_explore` (raw L5X) and `logicscout_find_logic` (indexed project). See **Diagnostics** above.
+
+Reference implementation (frozen): `C:\Users\YetiTrix\Documents\GitHub\LogicScout`

package/skills/fieldbrain/routes/fieldbrain/assets/index-B56utPpP.css

@@ -0,0 +1 @@
+:root{--color-surface: #1a1d24;--color-surface-2: #22262f;--color-text: #e8eaed;--color-text-muted: #9aa0a6;--color-border: #3c4043;--color-accent: #6b9fff;font-family:system-ui,sans-serif;color:var(--color-text);background:var(--color-surface)}*{box-sizing:border-box}body{margin:0;min-height:100vh}code{font-size:.9em}.fieldbrain-app{max-width:960px;margin:0 auto;padding:20px 16px 40px}.fieldbrain-title{margin:0 0 4px;font-size:1.35rem}.fieldbrain-sub{margin:0 0 16px;color:var(--color-text-muted);font-size:.85rem;line-height:1.45}.fieldbrain-tabs{display:flex;flex-wrap:wrap;gap:8px;margin-bottom:16px}.fieldbrain-tab{border:1px solid var(--color-border);background:var(--color-surface-2);color:var(--color-text);border-radius:6px;padding:6px 12px;font-size:.85rem;cursor:pointer}.fieldbrain-tab.active{border-color:color-mix(in srgb,var(--color-accent) 50%,var(--color-border));background:color-mix(in srgb,var(--color-accent) 12%,var(--color-surface-2));color:var(--color-accent);font-weight:600}.fieldbrain-panel{margin-top:.5rem}.fieldbrain-muted{color:var(--color-text-muted);font-size:.85rem;line-height:1.45}.fieldbrain-foot{margin-top:1rem;color:var(--color-text-muted);font-size:.85rem}.fieldbrain-list{display:flex;flex-direction:column;gap:8px}.fieldbrain-row{border:1px solid var(--color-border);border-radius:6px;padding:.6rem .75rem;background:var(--color-surface-2)}.fieldbrain-row h4{margin:0 0 .35rem;font-size:.95rem}.fieldbrain-row p{margin:0}.fieldbrain-project-group{margin-bottom:1.25rem}.fieldbrain-group-title{margin:0 0 .5rem;font-size:.9rem;color:var(--color-text-muted);font-weight:600;text-transform:uppercase;letter-spacing:.04em}.fieldbrain-project-head{display:flex;flex-wrap:wrap;align-items:center;justify-content:space-between;gap:8px;margin-bottom:.35rem}.fieldbrain-project-head h4{margin:0}.fieldbrain-project-row.is-active{border-color:color-mix(in srgb,var(--color-accent) 45%,var(--color-border));background:color-mix(in srgb,var(--color-accent) 6%,var(--color-surface-2))}.fieldbrain-stat-row{display:flex;flex-wrap:wrap;gap:6px;margin-bottom:.35rem}.fieldbrain-stat{display:inline-block;padding:.15rem .45rem;border-radius:4px;border:1px solid var(--color-border);background:var(--color-surface);font-size:.75rem;color:var(--color-text-muted)}.fieldbrain-project-row.is-sub{margin-left:1rem;border-left:3px solid color-mix(in srgb,var(--color-accent) 35%,var(--color-border))}.fieldbrain-form label{display:block;margin:.65rem 0;font-size:.85rem}.fieldbrain-input{display:block;width:100%;max-width:28rem;margin-top:.25rem;padding:.4rem .55rem;border:1px solid var(--color-border);border-radius:6px;background:var(--color-surface);color:var(--color-text);font:inherit}.fieldbrain-actions{display:flex;flex-wrap:wrap;gap:8px;margin-top:.75rem}.fieldbrain-btn{border:1px solid var(--color-border);background:var(--color-surface-2);color:var(--color-text);border-radius:6px;padding:.45rem .85rem;font-size:.85rem;cursor:pointer}.fieldbrain-btn:hover:not(:disabled){border-color:var(--color-accent)}.fieldbrain-btn:disabled{opacity:.6;cursor:not-allowed}.fieldbrain-btn-primary{border-color:color-mix(in srgb,var(--color-accent) 50%,var(--color-border));background:color-mix(in srgb,var(--color-accent) 18%,var(--color-surface-2));color:var(--color-accent);font-weight:600}.fieldbrain-card{border:1px solid var(--color-border);border-radius:8px;background:var(--color-surface-2);padding:14px 16px;margin-bottom:12px}.fieldbrain-card-title{margin:0 0 8px;font-size:1rem}.fieldbrain-pre{margin-top:.75rem;padding:.75rem;border:1px solid var(--color-border);border-radius:6px;background:var(--color-surface-2);font-size:.8rem;white-space:pre-wrap;overflow-x:auto}.fieldbrain-status-banner{margin-bottom:1rem;padding:.65rem .85rem;border:1px solid var(--color-border);border-radius:8px;background:color-mix(in srgb,var(--color-accent) 8%,var(--color-surface-2))}.fieldbrain-status-banner p{margin:0;font-size:.9rem}.fieldbrain-link{display:inline;padding:0;border:none;background:none;color:var(--color-accent);font:inherit;text-decoration:underline;cursor:pointer}.fieldbrain-link:hover{color:color-mix(in srgb,var(--color-accent) 80%,white)}.fieldbrain-expand-trigger{display:flex;align-items:center;gap:.55rem;width:100%;margin-bottom:1rem;padding:.65rem .85rem;border-style:dashed;text-align:left;font-weight:600}.fieldbrain-expand-trigger:hover:not(:disabled){border-color:var(--color-accent);background:color-mix(in srgb,var(--color-accent) 8%,var(--color-surface-2))}.fieldbrain-expand-icon{display:inline-flex;align-items:center;justify-content:center;width:1.35rem;height:1.35rem;border-radius:4px;background:color-mix(in srgb,var(--color-accent) 18%,var(--color-surface-2));color:var(--color-accent);font-size:1rem;line-height:1;font-weight:700}.fieldbrain-create-panel{margin-bottom:1rem}.fieldbrain-create-header{display:flex;align-items:center;justify-content:space-between;gap:.75rem;margin-bottom:.35rem}.fieldbrain-create-header .fieldbrain-card-title{margin:0}.fieldbrain-toolbar{display:flex;flex-wrap:wrap;align-items:flex-end;gap:12px;margin-bottom:.75rem}.fieldbrain-search-label{flex:1 1 14rem;margin:0;font-size:.85rem}.fieldbrain-search-input{max-width:none}.fieldbrain-toolbar-hint{margin:0;flex:1 1 auto}.fieldbrain-table-wrap{overflow-x:auto;border:1px solid var(--color-border);border-radius:8px;background:var(--color-surface-2)}.fieldbrain-table{width:100%;border-collapse:collapse;font-size:.85rem}.fieldbrain-table th,.fieldbrain-table td{padding:.5rem .65rem;border-bottom:1px solid var(--color-border);text-align:left;vertical-align:middle}.fieldbrain-table th{color:var(--color-text-muted);font-weight:600;background:color-mix(in srgb,var(--color-surface) 60%,var(--color-surface-2))}.fieldbrain-table tbody tr:last-child td{border-bottom:none}.fieldbrain-table tbody tr.is-sub-row td.fieldbrain-table-name{padding-left:1.25rem}.fieldbrain-table-empty{color:var(--color-text-muted);text-align:center;padding:1rem}.fieldbrain-table-name{font-weight:500}.fieldbrain-stat-link{border:none;background:none;color:var(--color-accent);font:inherit;font-weight:600;text-decoration:underline;cursor:pointer;padding:0}.fieldbrain-stat-link:hover{color:color-mix(in srgb,var(--color-accent) 80%,white)}.fieldbrain-filter-banner{display:flex;flex-wrap:wrap;align-items:center;justify-content:space-between;gap:8px;margin-bottom:.75rem;padding:.55rem .75rem;border:1px solid var(--color-border);border-radius:8px;background:color-mix(in srgb,var(--color-accent) 8%,var(--color-surface-2));font-size:.9rem}