egutierrez
625569485f
Adds `fn doctor` read-only diagnostic command with subcommands artefacts, services, sync, uses-functions, unused, and --json flag for agents. Each subcommand wraps a registry function in functions/infra/. New functions: - artefact_doctor, services_status, pc_locations_drift, audit_uses_functions, find_unused_functions (Go diagnostics) - backup_sqlite_db, rotate_backups, wait_for_http, wait_for_port, port_kill, tail_journal, pre_commit_hook_install (bash utilities) - notify_telegram (Go HTTP) - backup_all pipeline (tag launcher) Plus prior session leftovers (scan_secrets_in_dirty, append_diary_entry, git utilities, http_session_cookie_middleware, compile/full-git pipelines). Fixes pc_locations_drift filepath.Join bug with absolute dir_path. Documents fn doctor in CLAUDE.md, .claude/rules/fn_doctor.md (rule 23), docs/architecture.md, CHANGELOG.md (2026-05-07), and diary entry. First fn doctor uses-functions run found drift in 7/12 apps (deuda para sincronizar app.md con imports reales). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2.6 KiB
2.6 KiB
Rules Index
Reglas operativas del proyecto. Cada archivo es una regla independiente.
| # | Archivo | Regla |
|---|---|---|
| 01 | db_locations.md | Ubicacion de registry.db y operations.db |
| 02 | ids_naming.md | Formato de IDs y convenciones de nombres |
| 03 | purity.md | Reglas de pureza funcional |
| 04 | types_in_signatures.md | Tipos nativos en firmas, registry types en .md |
| 05 | stubs.md | Stubs impuros para dependencias externas |
| 06 | assertions.md | Kinds de assertions son texto libre |
| 07 | proposals.md | Quien crea proposals y cuando |
| 08 | function_tags.md | Tags con significado especial: launcher, service |
| 09 | go_packages.md | Nombre de paquete Go = nombre del directorio |
| 10 | apps_vs_functions.md | Codigo reutilizable en functions/, no reutilizable en apps/ |
| 11 | sources.md | Extraccion de funciones desde repos externos |
| 12 | notebook_collaboration.md | Colaboración en notebooks Jupyter via funciones del registry |
| 13 | frontend_theming.md | Componentes propios y sistema de temas en frontends |
| 14 | deploy.md | Deploy de apps a VPS remotos via SSH + systemd + rsync |
| 15 | projects.md | Projects: agrupar apps, analysis y vaults bajo un tema |
| 16 | kiss.md | KISS en proyectos y apps: cuestionar herramientas externas, sin abstracciones especulativas |
| 17 | apps_tbd.md | Trunk-based development obligatorio en apps generadas con fn (registry exento) |
| 18 | uses_functions.md | Convencion de uses_functions para C++: el .md del consumidor declara las dependencias |
| 19 | cpp_apps.md | Estandarizacion de apps C++: estructura, CMake, app.md, sub-repo, runtime — apunta a cpp/PATTERNS.md y cpp/DESIGN_SYSTEM.md como autoritativas |
| 20 | artefactos.md | Termino paraguas para apps, analysis, vaults, projects y playgrounds (todo lo que no es codigo reutilizable) |
| 21 | playgrounds.md | Prototipos rapidos dentro de un artefacto padre — heredan entorno, no se indexan, no tienen repo propio |
| 22 | registry_first.md | Antes de escribir codigo en un artefacto: buscar en el registry, reutilizar si existe, delegar a fn-constructor si falta |
| 23 | fn_doctor.md | fn doctor: diagnostico read-only de artefactos, services, sync drift, uses_functions, unused — wrappers de funciones del registry |