sipecom-soporte 0.5.4__tar.gz

sipecom_soporte-0.5.4/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SIPECOM / kevin21sipecom
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sipecom_soporte-0.5.4/PKG-INFO

@@ -0,0 +1,116 @@
+Metadata-Version: 2.3
+Name: sipecom-soporte
+Version: 0.5.4
+Summary: SIPECOM-SOPORTE: CLI global y dashboard local (127.0.0.1:2121).
+Author: kevin21sipecom
+Author-email: kevin21sipecom <kfernandez@sipecom.com>
+License: MIT License
+         
+         Copyright (c) 2026 SIPECOM / kevin21sipecom
+         
+         Permission is hereby granted, free of charge, to any person obtaining a copy
+         of this software and associated documentation files (the "Software"), to deal
+         in the Software without restriction, including without limitation the rights
+         to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+         copies of the Software, and to permit persons to whom the Software is
+         furnished to do so, subject to the following conditions:
+         
+         The above copyright notice and this permission notice shall be included in all
+         copies or substantial portions of the Software.
+         
+         THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+         IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+         FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+         AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+         SOFTWARE.
+Requires-Dist: pyfiglet>=1.0
+Requires-Dist: streamlit>=1.36
+Requires-Dist: pyyaml>=6.0
+Requires-Python: >=3.11
+Project-URL: Homepage, https://github.com/kevin21sipecom/soporte-sipecom
+Project-URL: Documentation, https://github.com/kevin21sipecom/soporte-sipecom/blob/main/docs/README.md
+Description-Content-Type: text/markdown
+
+# SIPECOM-SOPORTE
+
+CLI global y consola local para consultar proyectos (CodeGraph + Repomix) con **grok**, **antigravity** o **codex**.
+
+La UI es **localhost** (`127.0.0.1:2121`). Sin túnel.
+
+**Plataforma:** de momento solo **Windows**. No está validado en Linux ni macOS.
+
+![Consola SIPECOM-SOPORTE](docs/consola-ui.png)
+
+## Instalar uv
+
+Windows (PowerShell):
+
+```text
+powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+Cierra y abre la terminal, luego `uv --version`.
+
+## Instalar en toda la PC
+
+No hace falta `cd` al repo. Desde PyPI:
+
+```text
+uv tool install sipecom-soporte
+uv tool update-shell
+sipecom-soporte
+sipecom-soporte dashboard
+```
+
+Desde git (misma versión, sin PyPI):
+
+```text
+uv tool install git+https://github.com/kevin21sipecom/soporte-sipecom.git
+```
+
+Actualizar:
+
+```text
+uv tool upgrade sipecom-soporte
+```
+
+Desarrollo local (opcional): `git clone` + `uv sync` + `uv run sipecom-soporte`.
+
+## Onboarding
+
+`sipecom-soporte` (sin argumentos) comprueba:
+
+1. **node** y **npm** (Repomix y Archify los necesitan)
+2. **CodeGraph**, **Repomix**, **Archify**
+3. Agentes: grok / antigravity (`agy`) / codex
+
+Si falta CodeGraph, Repomix o Archify, pregunta s/n y los instala en el mismo onboarding. Cuando todo está OK:
+
+```text
+sipecom-soporte dashboard
+```
+
+Las CLIs las elige el **dashboard**. No hace falta `select --use`.
+
+## Dashboard
+
+- Motor = detector de CLIs de esta PC.
+- Modelos = listado vivo de esa CLI.
+- Proyecto: CodeGraph + pack Repomix (el pack no se vuelca al prompt).
+- Imágenes: viven en **esta conversación**; puedes subir otra y se recuerdan las anteriores. «Nueva conversación» limpia el hilo.
+
+## Comandos
+
+| Comando | Descripción |
+| --- | --- |
+| `sipecom-soporte` | Onboarding |
+| `sipecom-soporte doctor` | Mismas 4 familias, formato corto |
+| `sipecom-soporte models` | Modelos de cada CLI |
+| `sipecom-soporte dashboard` | Consola en localhost:2121 |
+| `sipecom-soporte ui` | Alias de dashboard |
+
+## Documentación
+
+[docs/README.md](docs/README.md)

sipecom_soporte-0.5.4/README.md

@@ -0,0 +1,81 @@
+# SIPECOM-SOPORTE
+
+CLI global y consola local para consultar proyectos (CodeGraph + Repomix) con **grok**, **antigravity** o **codex**.
+
+La UI es **localhost** (`127.0.0.1:2121`). Sin túnel.
+
+**Plataforma:** de momento solo **Windows**. No está validado en Linux ni macOS.
+
+![Consola SIPECOM-SOPORTE](docs/consola-ui.png)
+
+## Instalar uv
+
+Windows (PowerShell):
+
+```text
+powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+Cierra y abre la terminal, luego `uv --version`.
+
+## Instalar en toda la PC
+
+No hace falta `cd` al repo. Desde PyPI:
+
+```text
+uv tool install sipecom-soporte
+uv tool update-shell
+sipecom-soporte
+sipecom-soporte dashboard
+```
+
+Desde git (misma versión, sin PyPI):
+
+```text
+uv tool install git+https://github.com/kevin21sipecom/soporte-sipecom.git
+```
+
+Actualizar:
+
+```text
+uv tool upgrade sipecom-soporte
+```
+
+Desarrollo local (opcional): `git clone` + `uv sync` + `uv run sipecom-soporte`.
+
+## Onboarding
+
+`sipecom-soporte` (sin argumentos) comprueba:
+
+1. **node** y **npm** (Repomix y Archify los necesitan)
+2. **CodeGraph**, **Repomix**, **Archify**
+3. Agentes: grok / antigravity (`agy`) / codex
+
+Si falta CodeGraph, Repomix o Archify, pregunta s/n y los instala en el mismo onboarding. Cuando todo está OK:
+
+```text
+sipecom-soporte dashboard
+```
+
+Las CLIs las elige el **dashboard**. No hace falta `select --use`.
+
+## Dashboard
+
+- Motor = detector de CLIs de esta PC.
+- Modelos = listado vivo de esa CLI.
+- Proyecto: CodeGraph + pack Repomix (el pack no se vuelca al prompt).
+- Imágenes: viven en **esta conversación**; puedes subir otra y se recuerdan las anteriores. «Nueva conversación» limpia el hilo.
+
+## Comandos
+
+| Comando | Descripción |
+| --- | --- |
+| `sipecom-soporte` | Onboarding |
+| `sipecom-soporte doctor` | Mismas 4 familias, formato corto |
+| `sipecom-soporte models` | Modelos de cada CLI |
+| `sipecom-soporte dashboard` | Consola en localhost:2121 |
+| `sipecom-soporte ui` | Alias de dashboard |
+
+## Documentación
+
+[docs/README.md](docs/README.md)

sipecom_soporte-0.5.4/pyproject.toml

@@ -0,0 +1,36 @@
+[project]
+name = "sipecom-soporte"
+version = "0.5.4"
+description = "SIPECOM-SOPORTE: CLI global y dashboard local (127.0.0.1:2121)."
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "pyfiglet>=1.0",
+    "streamlit>=1.36",
+    "pyyaml>=6.0",
+]
+
+[[project.authors]]
+name = "kevin21sipecom"
+email = "kfernandez@sipecom.com"
+
+[project.license]
+file = "LICENSE"
+
+[project.scripts]
+sipecom-soporte = "soporte_sipecom.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/kevin21sipecom/soporte-sipecom"
+Documentation = "https://github.com/kevin21sipecom/soporte-sipecom/blob/main/docs/README.md"
+
+[tool.uv.build-backend]
+module-name = "soporte_sipecom"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+
+[build-system]
+requires = ["uv_build>=0.12.9,<0.13.0"]
+build-backend = "uv_build"

sipecom_soporte-0.5.4/pyproject.toml.orig

@@ -0,0 +1,33 @@
+[project]
+name = "sipecom-soporte"
+version = "0.5.4"
+description = "SIPECOM-SOPORTE: CLI global y dashboard local (127.0.0.1:2121)."
+readme = "README.md"
+authors = [
+    { name = "kevin21sipecom", email = "kfernandez@sipecom.com" }
+]
+requires-python = ">=3.11"
+license = { file = "LICENSE" }
+dependencies = [
+    "pyfiglet>=1.0",
+    "streamlit>=1.36",
+    "pyyaml>=6.0",
+]
+
+[project.scripts]
+sipecom-soporte = "soporte_sipecom.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/kevin21sipecom/soporte-sipecom"
+Documentation = "https://github.com/kevin21sipecom/soporte-sipecom/blob/main/docs/README.md"
+
+[tool.uv.build-backend]
+module-name = "soporte_sipecom"
+
+[build-system]
+requires = ["uv_build>=0.12.9,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

sipecom_soporte-0.5.4/src/soporte_sipecom/__init__.py

@@ -0,0 +1,5 @@
+"""SIPECOM-SOPORTE."""
+
+from soporte_sipecom.cli import main
+
+__all__ = ["main"]

sipecom_soporte-0.5.4/src/soporte_sipecom/banner.py

@@ -0,0 +1,20 @@
+"""Banner típico de CLI."""
+from __future__ import annotations
+
+import pyfiglet
+
+TITLE = "SIPECOM"
+SUB = "SOPORTE"
+PORT = 2121
+
+
+def banner(port: int = PORT) -> str:
+    top = pyfiglet.figlet_format(TITLE, font="slant", width=80).rstrip()
+    bottom = pyfiglet.figlet_format(SUB, font="slant", width=80).rstrip()
+    line = "-" * 64
+    return (
+        f"{top}\n{bottom}\n"
+        f"{line}\n"
+        f"  SIPECOM-SOPORTE  ·  puerto {port}  ·  uv run soporte\n"
+        f"{line}"
+    )

sipecom_soporte-0.5.4/src/soporte_sipecom/cli.py

@@ -0,0 +1,229 @@
+"""CLI principal SIPECOM-SOPORTE."""
+from __future__ import annotations
+
+import argparse
+import json
+import subprocess
+import sys
+from pathlib import Path
+
+from soporte_sipecom.banner import banner
+from soporte_sipecom.config import DEFAULT_PORT, config_path, load, save
+from soporte_sipecom.constants import VALID_AGENTS
+from soporte_sipecom.detect import doctor, probe_agent
+from soporte_sipecom.models import list_models
+from soporte_sipecom.onboard import detected_agents, print_onboard
+
+
+def _print_doctor(probes, *, as_json: bool) -> int:
+    if as_json:
+        print(json.dumps([p.as_dict() for p in probes], indent=2, ensure_ascii=False))
+        return 0 if all(p.ok for p in probes) else 1
+    width = max(len(p.name) for p in probes)
+    print()
+    for probe in probes:
+        mark = "OK " if probe.ok else "NO "
+        loc = probe.path or "—"
+        ver = probe.version or ""
+        print(f"  {mark}  {probe.name:<{width}}  {ver:<18} {loc}")
+        if probe.detail and not probe.ok:
+            print(f"        {probe.detail}")
+        if probe.name == "agentes":
+            for member in probe.extra.get("members") or []:
+                mm = "ok" if member.get("ok") else "no"
+                print(
+                    f"        [{mm}] {member.get('name')}: "
+                    f"{member.get('version') or ''} {member.get('path') or '—'}"
+                )
+                if member.get("detail") and not member.get("ok"):
+                    print(f"              {member['detail']}")
+    print()
+    ok = all(p.ok for p in probes)
+    print("4/4 listas" if ok else "faltan herramientas (4 familias: codegraph, repomix, archify, agentes)")
+    return 0 if ok else 1
+
+
+def _usable_agents() -> list[dict]:
+    out = []
+    for name in VALID_AGENTS:
+        probe = probe_agent(name)
+        if probe.found:
+            out.append(probe.as_dict())
+    return out
+
+
+def cmd_select(chosen: list[str] | None) -> int:
+    found = _usable_agents()
+    ok_names = [a["name"] for a in found if a.get("ok")]
+    if not found:
+        print("No hay agentes CLI detectados (grok, antigravity, codex).")
+        return 1
+    print("Agentes detectados:")
+    for i, item in enumerate(found, 1):
+        flag = "OK" if item.get("ok") else "NO"
+        print(f"  {i}. [{flag}] {item['name']:8}  {item.get('version') or ''}  {item.get('path') or ''}")
+    selected: list[str]
+    if chosen:
+        selected = []
+        for name in chosen:
+            name = name.strip().lower()
+            if name == "agy":
+                name = "antigravity"
+            if name not in VALID_AGENTS:
+                print(f"CLI no válida: {name}. Usa: grok, antigravity, codex")
+                return 1
+            if name not in {a["name"] for a in found}:
+                print(f"no detectado: {name}")
+                return 1
+            selected.append(name)
+    elif sys.stdin.isatty() and sys.stdout.isatty():
+        raw = input("\nNúmeros o nombres (ej. 1,2 o grok,codex). Vacío = todos los OK: ").strip()
+        if not raw:
+            selected = ok_names
+        else:
+            selected = []
+            tokens = [t.strip().lower() for t in raw.replace(";", ",").split(",") if t.strip()]
+            for tok in tokens:
+                if tok.isdigit():
+                    idx = int(tok) - 1
+                    if idx < 0 or idx >= len(found):
+                        print(f"índice inválido: {tok}")
+                        return 1
+                    selected.append(found[idx]["name"])
+                else:
+                    if tok == "agy":
+                        tok = "antigravity"
+                    if tok not in VALID_AGENTS:
+                        print(f"CLI no válida: {tok}. Usa: grok, antigravity, codex")
+                        return 1
+                    if tok not in {a["name"] for a in found}:
+                        print(f"no detectado: {tok}")
+                        return 1
+                    selected.append(tok)
+    else:
+        selected = ok_names
+        print(f"(sin TTY) usando todos los OK: {', '.join(selected) or '—'}")
+    cfg = load()
+    cfg["agents"] = selected
+    cfg["port"] = cfg.get("port") or DEFAULT_PORT
+    path = save(cfg)
+    print(f"guardado: {path}")
+    print(f"agentes: {', '.join(selected) or '—'}")
+    print(f"puerto:  {cfg['port']}")
+    return 0
+
+
+def launch_dashboard(port: int) -> int:
+    cfg = load()
+    found = detected_agents()
+    if found:
+        cfg["agents"] = found
+        save(cfg)
+    app = Path(__file__).resolve().parent / "ui" / "app.py"
+    cmd = [
+        sys.executable,
+        "-m",
+        "streamlit",
+        "run",
+        str(app),
+        "--server.address",
+        "127.0.0.1",
+        "--server.port",
+        str(port),
+        "--server.headless",
+        "true",
+        "--browser.gatherUsageStats",
+        "false",
+    ]
+    print(banner(port))
+    print(f"Dashboard (solo localhost) → http://127.0.0.1:{port}")
+    return subprocess.call(cmd)
+
+
+def main(argv: list[str] | None = None) -> int:
+    raw = list(argv) if argv is not None else sys.argv[1:]
+    raw = ["dashboard" if a == "dasboard" else a for a in raw]
+    parser = argparse.ArgumentParser(
+        prog="sipecom-soporte",
+        description="SIPECOM-SOPORTE — CLI de soporte y dashboard Streamlit (puerto 2121).",
+    )
+    parser.add_argument("--port", type=int, default=None, help="puerto (default 2121)")
+    sub = parser.add_subparsers(dest="cmd")
+
+    doc = sub.add_parser("doctor", help="Validar codegraph, repomix, archify y agentes")
+    doc.add_argument("--json", action="store_true")
+
+    sel = sub.add_parser("select", help="Opcional. El dashboard elige las CLIs.")
+    sel.add_argument(
+        "--use",
+        default="",
+        help="lista: grok,antigravity,codex (si se omite, pregunta o usa los OK)",
+    )
+
+    models_p = sub.add_parser("models", help="Listar modelos de grok, antigravity y codex")
+    models_p.add_argument("--refresh", action="store_true")
+    models_p.add_argument("--json", action="store_true")
+
+    sub.add_parser("onboard", help="Comprobar node/npm, CodeGraph, Repomix, Archify y agentes")
+    sub.add_parser("config", help="Mostrar config (puerto + agentes)")
+    sub.add_parser("dashboard", help="Abrir la consola Streamlit (esta UI)")
+    sub.add_parser("ui", help="Alias de dashboard")
+
+    args = parser.parse_args(raw)
+    port = args.port if args.port else load().get("port") or DEFAULT_PORT
+
+    if args.cmd is None or args.cmd == "onboard":
+        print(banner(port))
+        code = print_onboard()
+        print(f"\nDashboard:  sipecom-soporte dashboard")
+        print(f"Puerto: {port}  (solo localhost)")
+        return code
+
+    if args.cmd == "doctor":
+        print(banner(port))
+        return _print_doctor(doctor(), as_json=args.json)
+
+    if args.cmd == "select":
+        print(banner(port))
+        chosen = [x for x in args.use.split(",") if x.strip()] if args.use else None
+        return cmd_select(chosen)
+
+    if args.cmd == "models":
+        print(banner(port))
+        payload = {}
+        for name in VALID_AGENTS:
+            infos = list_models(name, refresh=args.refresh)
+            payload[name] = [m.as_dict() for m in infos]
+            if not args.json:
+                print(f"\n{name}")
+                if not infos:
+                    print("  (sin modelos; CLI ausente o listado vacío)")
+                    continue
+                for item in infos:
+                    mark = "*" if item.default else "-"
+                    extra = f"  [{', '.join(item.efforts)}]" if item.efforts else ""
+                    label = f"  {item.label}" if item.label and item.label != item.id else ""
+                    print(f"  {mark} {item.id}{label}{extra}")
+        if args.json:
+            print(json.dumps(payload, indent=2, ensure_ascii=False))
+        return 0
+
+    if args.cmd == "config":
+        print(banner(port))
+        cfg = load()
+        if args.port:
+            cfg["port"] = args.port
+            save(cfg)
+        print(json.dumps(cfg, indent=2, ensure_ascii=False))
+        print(f"archivo: {config_path()}")
+        return 0
+
+    if args.cmd in {"dashboard", "ui"}:
+        return launch_dashboard(port)
+
+    parser.print_help()
+    return 2
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

sipecom_soporte-0.5.4/src/soporte_sipecom/config.py

@@ -0,0 +1,38 @@
+"""Config local: agentes elegidos y puerto 2121."""
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+DEFAULT_PORT = 2121
+
+
+def config_path() -> Path:
+    return Path.home() / ".soporte-sipecom.json"
+
+
+def load() -> dict:
+    path = config_path()
+    if not path.is_file():
+        return {"port": DEFAULT_PORT, "agents": []}
+    try:
+        data = json.loads(path.read_text(encoding="utf-8"))
+    except (OSError, json.JSONDecodeError):
+        return {"port": DEFAULT_PORT, "agents": []}
+    data.setdefault("port", DEFAULT_PORT)
+    data.setdefault("agents", [])
+    data.setdefault("last_agent", "")
+    data.setdefault("archify_home", "")
+    return data
+
+
+def save(data: dict) -> Path:
+    path = config_path()
+    payload = {
+        "port": int(data.get("port") or DEFAULT_PORT),
+        "agents": list(data.get("agents") or []),
+        "last_agent": data.get("last_agent") or "",
+        "archify_home": data.get("archify_home") or "",
+    }
+    path.write_text(json.dumps(payload, indent=2) + "\n", encoding="utf-8")
+    return path

sipecom_soporte-0.5.4/src/soporte_sipecom/constants.py

@@ -0,0 +1,6 @@
+"""Constantes de agentes. Sin I/O ni imports pesados (Streamlit recarga módulos)."""
+
+VALID_AGENTS = ("grok", "antigravity", "codex")
+AGENT_ALIASES = {
+    "antigravity": ("antigravity", "agy"),
+}

sipecom_soporte-0.5.4/src/soporte_sipecom/conversations.py

@@ -0,0 +1,83 @@
+"""Hilos de chat persistentes (estilo lista Hermes)."""
+from __future__ import annotations
+
+import json
+import time
+from pathlib import Path
+
+
+def chats_root() -> Path:
+    path = Path.home() / ".soporte-sipecom" / "chats"
+    path.mkdir(parents=True, exist_ok=True)
+    return path
+
+
+def index_path() -> Path:
+    return chats_root() / "index.json"
+
+
+def load_index() -> list[dict]:
+    path = index_path()
+    if not path.is_file():
+        return []
+    try:
+        data = json.loads(path.read_text(encoding="utf-8"))
+    except (OSError, json.JSONDecodeError):
+        return []
+    items = data if isinstance(data, list) else []
+    seen: set[str] = set()
+    unique: list[dict] = []
+    for item in items:
+        if not isinstance(item, dict):
+            continue
+        cid = str(item.get("id") or "")
+        if not cid or cid in seen:
+            continue
+        seen.add(cid)
+        unique.append(item)
+    return unique
+
+
+def save_index(items: list[dict]) -> None:
+    index_path().write_text(json.dumps(items, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
+
+
+def thread_dir(cid: str) -> Path:
+    path = chats_root() / cid
+    path.mkdir(parents=True, exist_ok=True)
+    return path
+
+
+def title_from_messages(messages: list[dict]) -> str:
+    for item in messages:
+        if item.get("role") == "user" and (item.get("content") or "").strip():
+            return " ".join(item["content"].split())[:72]
+    return "Nueva conversación"
+
+
+def load_thread(cid: str) -> tuple[list[dict], list[str]]:
+    path = thread_dir(cid) / "thread.json"
+    if not path.is_file():
+        return [], []
+    try:
+        data = json.loads(path.read_text(encoding="utf-8"))
+    except (OSError, json.JSONDecodeError):
+        return [], []
+    return list(data.get("messages") or []), list(data.get("images") or [])
+
+
+def save_thread(cid: str, messages: list[dict], images: list[str], project: str = "") -> None:
+    path = thread_dir(cid) / "thread.json"
+    payload = {"messages": messages, "images": images, "project": project}
+    path.write_text(json.dumps(payload, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
+    title = title_from_messages(messages)
+    items = [x for x in load_index() if x.get("id") != cid]
+    items.insert(
+        0,
+        {"id": cid, "title": title, "project": project, "updated": time.time()},
+    )
+    save_index(items[:40])
+
+
+def new_id() -> str:
+    return str(int(time.time() * 1000))