Skip to content

Releases: DarkCodePE/quipu

v1.0.0-alpha.2

30 Apr 12:56
@github-actions github-actions
v1.0.0-alpha.2
c4231ee

Choose a tag to compare

View all tags
v1.0.0-alpha.2 Pre-release
Pre-release

origin: llm-generated
source: docs/arquetipo/sprint6/architecture-design.md §10.2 + research-findings.md §9
version: 1.0.0-alpha.1
date_drafted: 2026-04-18
release_target: 2026-07-13 (Alpha)

Release notes — @okuanb/quipu v1.0.0-alpha.1

Quipu — opinionated starter + CLI for Claude Code projects. Your project, encoded in connected threads of knowledge.

Primer tag público del arquetipo Claude Code + RuFlo, destilado de 6 repos expertos (Karpathy · Superpowers · ECC · CCP · HowTo · RuFlo) vía swarm de 15 agentes elite con pipeline AST+GNN 384-dim HNSW sobre RuVector. Ruta α/β/GA documentada en ROLLOUT-PLAN.md.

El nombre

Quipu (kee-poo): cuerda incaica con nudos que codifica información. Los incas registraban estado en nudos (nodos) conectados por hilos (aristas). Este arquetipo hace lo mismo con embeddings + GNN edges + memoria persistente — un quipu digital para desarrollo con agentes.

Highlights

  • 10 agents kernel + 15 opt-in con principle of least-privilege validado.
  • 35 skills (7 kernel autoload + 28 opt-in).
  • 15 hooks default + 6 opt-in con pipeline bloqueante PreToolUse/PostToolUse.
  • 3 tiers de memoria: L1 (in-session), L2 (AgentDB SQLite + HNSW local), L3 (Postgres + pgvector compartido, 4466 embeddings).
  • ReasoningBank + GNN sobre 674 214 edges (5 tipos).
  • 5 capas de seguridad: pre-commit, hooks, aidefence, RBAC tools, audit/forensics.
  • 8 eventos F-10 observability + dashboard HTML.
  • Learning path: 10 lecciones (14h) + quiz 30 preguntas con buckets de score.
  • Daemon agent-query-warm: cold-start 1800ms → warm <30ms p95 (socket /tmp/agent-query-$USER.sock).
  • Release CI gemelo: un git push --follow-tags publica npm + gh release con rollback automático.
  • Hardening audit gate: P1/P2 = 0 antes de GA (ADR-S6-D6).

Breaking changes (alpha → beta/GA)

  • Ninguno esperado; alpha es la primera versión pública.
  • Política de breaking para futuras versiones: semver estricto + deprecation 1 minor antes de remove.

Migration path

  • Instalación nueva: 
    npx @okuanb/quipu@alpha init my-app   # scaffold + wizard
cd my-app && claude                   # abre Claude Code en el proyecto
  • Instalación desde source (contribución / preview): 
    git clone https://github.com/okuanb/quipu && cd quipu
bash scripts/init-arquetipo.sh --target <dir> --stack backend
  • Upgrade desde pre-alpha interno: L2/L3 son aditivos; correr scripts/migrate.sh --direction up una vez.

Links a reviews previos (sprint chain)

  • docs/arquetipo/sprint1/review-signoff.md — CLAUDE.md + skills kernel.
  • docs/arquetipo/sprint2/review-signoff.md — agents + L2 AgentDB.
  • docs/arquetipo/sprint3/review-signoff.md — hooks pipeline + L3.
  • docs/arquetipo/sprint4/review-signoff.md — security 5 capas + aidefence.
  • docs/arquetipo/sprint5/review-signoff.md — GNN + 674k edges + F-10.

Docs de cierre

  • docs/arquetipo/deliverables/POSTMORTEM.md — 3 wins + 3 losses + 5 cambios v2.
  • docs/arquetipo/deliverables/TROUBLESHOOTING.md — 17 foot-guns por capa.
  • docs/arquetipo/deliverables/ROLLOUT-PLAN.md — α/β/GA con criterios pass/fail.
  • docs/arquetipo/deliverables/learning/README.md — ruta 10 lecciones.
  • docs/arquetipo/deliverables/backlog.json — 9 items, 0 P1/P2 open.

Known issues

  • DEUDA-OBS-CLI (P1 crónica aceptada): ruflo memory retrieve/store cuelga >20s intermitente. Workaround canónico: scripts/agent-query.sh. Documentado en TROUBLESHOOTING.md #01. Fix upstream en v2 (cliente Rust/native).
  • Timezone en eventos F-10: convención UTC establecida (TROUBLESHOOTING.md #18); verificar que integraciones externas lo respeten.

Artefactos técnicos

  • 195 tests (9 suites).
  • 4 workflows CI: arquetipo-smoke.yml, signing-smoke.yml, release.yml, reference-check.yml.
  • 13+ scripts scripts/*.sh + 3 nuevos S6 (daemon, fix-zero-vec, hardening-audit).
  • 5 reference docs autogenerados en deliverables/reference/.

Contribuyentes

Swarm elite × 6 sprints:

  • Architects: architect-sprint{0..6}
  • Researchers: researcher-sprint{1..6}
  • Coders: coder-sprint{1..6}
  • Testers: tester-sprint{1..6}
  • Reviewers + security: reviewer-sprint{1..6}, security-reviewer
  • Coord: hierarchical-coordinator

Siguiente

  • Alpha window: 2026-07-13 → 2026-07-27 (14 días, 3+ pilotos internos).
  • Feedback: docs/arquetipo/sprint6/alpha-feedback.md + issue tracker label alpha.
  • Beta target: 2026-07-28 → 2026-08-10 (14 días, +5 externos OSS).
  • GA target: 2026-08-11 (con ARQUETIPO_GA_ENABLED ramp 1% → 10% → 100%).

Licencia

MIT. Ver LICENSE.

Loading