ostacky 0.8.1 → 0.8.3

package/assets/plugins/ostacky-plugin.ts

@@ -16,6 +16,7 @@ import { readFileSync, writeFileSync, renameSync, mkdirSync, existsSync, statSyn
 import { join, dirname, basename, resolve, relative } from "node:path"
 import { SENSITIVE_DEFAULT, BASH_SENSITIVE_RE, isSensitive, extractPathsFromBash } from "../../src/security.ts"
 import { isTrivial } from "../../src/tiered.ts"
+import { STATES, TRANSITIONS, DEFAULT_STATE } from "./controller-core.ts"
 
 // ─── Constants ───────────────────────────────────────────────────────────────
 
@@ -25,127 +26,7 @@ const IDLE_THRESHOLD_MS = 45_000
 const PURPLE_TENUE = "\x1b[38;5;183m"
 const PURPLE_RESET = "\x1b[0m"
 
-const STATES = Object.freeze({
-  INTERPRETATION_PENDING: "INTERPRETATION_PENDING",
-  CLARIFICATION_PENDING: "CLARIFICATION_PENDING",
-  DISCOVERY: "DISCOVERY",
-  ROUTE_DECISION_PENDING: "ROUTE_DECISION_PENDING",
-  SPECIFICATION: "SPECIFICATION",
-  EXECUTION_ANALYSIS: "EXECUTION_ANALYSIS",
-  EXECUTION_DECISION_PENDING: "EXECUTION_DECISION_PENDING",
-  EXECUTING_INLINE: "EXECUTING_INLINE",
-  EXECUTING_SUBAGENTS: "EXECUTING_SUBAGENTS",
-  SYNC: "SYNC",
-  DONE: "DONE",
-  BLOCKED: "BLOCKED",
-} as const)
-
-const TRANSITIONS: Record<string, Array<{ via: string; to: string; choice?: string; mode?: string }>> = {
-  INTERPRETATION_PENDING: [
-    { via: "request_clarification", to: "CLARIFICATION_PENDING" },
-    { via: "proceed_to_discovery", to: "DISCOVERY" },
-    { via: "record_discovery", to: "ROUTE_DECISION_PENDING" },
-    { via: "block", to: "BLOCKED" },
-  ],
-  CLARIFICATION_PENDING: [
-    { via: "record_clarification", to: "DISCOVERY" },
-    { via: "block", to: "BLOCKED" },
-    { via: "abandon", to: "BLOCKED" },
-  ],
-  DISCOVERY: [
-    { via: "record_discovery", to: "ROUTE_DECISION_PENDING" },
-    { via: "block", to: "BLOCKED" },
-    { via: "abandon", to: "BLOCKED" },
-  ],
-  ROUTE_DECISION_PENDING: [
-    { via: "consume_route_decision", to: "SPECIFICATION", choice: "SPEC" },
-    { via: "consume_route_decision", to: "EXECUTION_ANALYSIS", choice: "DIRECT" },
-    { via: "block", to: "BLOCKED" },
-    { via: "abandon", to: "BLOCKED" },
-  ],
-  SPECIFICATION: [
-    { via: "spec_complete", to: "EXECUTION_ANALYSIS" },
-    { via: "block", to: "BLOCKED" },
-    { via: "abandon", to: "BLOCKED" },
-  ],
-  EXECUTION_ANALYSIS: [
-    { via: "record_execution_analysis", to: "EXECUTION_DECISION_PENDING" },
-    { via: "block", to: "BLOCKED" },
-    { via: "abandon", to: "BLOCKED" },
-  ],
-  EXECUTION_DECISION_PENDING: [
-    { via: "consume_execution_decision", to: "EXECUTING_INLINE", mode: "INLINE" },
-    { via: "consume_execution_decision", to: "EXECUTING_SUBAGENTS", mode: "SUBAGENT_DRIVEN" },
-    { via: "block", to: "BLOCKED" },
-    { via: "abandon", to: "BLOCKED" },
-  ],
-  EXECUTING_INLINE: [
-    { via: "implementation_complete", to: "SYNC" },
-    { via: "block", to: "BLOCKED" },
-  ],
-  EXECUTING_SUBAGENTS: [
-    { via: "implementation_complete", to: "SYNC" },
-    { via: "block", to: "BLOCKED" },
-  ],
-  BLOCKED: [
-    { via: "replan", to: "INTERPRETATION_PENDING" },
-    { via: "abandon", to: "DONE" },
-  ],
-  SYNC: [
-    { via: "sync_complete", to: "DONE" },
-    { via: "block", to: "BLOCKED" },
-  ],
-  DONE: [],
-}
-
-const DEFAULT_STATE: any = {
-  state: STATES.INTERPRETATION_PENDING,
-  revision: 0,
-  requestId: null,
-  changeId: null,
-  routeDecisionId: null,
-  routeChoice: null,
-  level: null,
-  executionDecisionId: null,
-  executionMode: null,
-  snapshots: { codegraph: null, execution: null },
-  tasks: {},
-  fileFingerprints: {},
-  error: null,
-  lastHandoff: null,
-  expectedTasks: null,
-  expectedTaskCount: null,
-  auditSeq: 0,
-  degraded: false,
-  schemaVersion: 1,
-  stateOversizedCount: 0,
-  codegraphBypassCount: 0,
-  degradedEditsCount: 0,
-  cacheHitCount: 0,
-  cacheMissCount: 0,
-  tokenSavingEstimate: 0,
-  discoveryCacheHitCount: 0,
-  redundantCallCount: 0,
-  cacheMissWithoutPutCount: 0,
-  stateCheckCount: 0,
-  toolCallCount: 0,
-  lastProposal: null,
-  allowedFiles: {},
-  deniedFiles: {},
-  sensitivePatterns: SENSITIVE_DEFAULT,
-  sensitiveAccess: { allowed: 0, denied: 0, blockedAttempts: 0 },
-  staleContentAttempts: 0,
-  completeWithoutValidateCount: 0,
-  toolTimeoutCount: 0,
-  lastToolDurationMs: 0,
-  stateDurationMs: 0,
-  subagentFailedCount: 0,
-  lastValidated: null,
-  pendingFileAccess: {},
-  lastHeartbeat: 0,
-  watchdogEnabled: true,
-  ts: Date.now(),
-}
+// DEFAULT_STATE imported from controller-core.ts
 
 // ─── Helpers ─────────────────────────────────────────────────────────────────
 
@@ -558,13 +439,20 @@ export const OstackyController: Plugin = async (ctx) => {
           const s = readState((input as any).ctx?.directory ?? "")
         } catch {}
       }
-      // Heartbeat + color purple tenue: Ostacky vs modelo (fácil)
+      // Heartbeat + color purple tenue: Ostacky vs modelo (fácil) — single-writer: plugin memo, no persist cada tool (D10)
+      let lastHeartbeatMem = 0
       try {
         const dir = ctx.directory
         const s = readState(dir)
         if (s) {
-          s.lastHeartbeat = Date.now()
-          try { persistState(dir, s) } catch {}
+          const now = Date.now()
+          lastHeartbeatMem = now
+          // Single-writer: solo persiste si OSTACKY_PLUGIN_PERSIST=1 o idle>30s o state cambió
+          const shouldPersist = process.env.OSTACKY_PLUGIN_PERSIST === "1" || (now - (s.lastHeartbeat || 0) > 30000)
+          if (shouldPersist) {
+            s.lastHeartbeat = now
+            try { persistState(dir, s) } catch {}
+          }
           if (["EXECUTING_INLINE", "EXECUTING_SUBAGENTS", "SYNC"].includes(s.state) && output && typeof output.title === "string" && output.title && !output.title.includes("🟣")) {
             output.title = `🟣 ${PURPLE_TENUE}[OSTACKY]${PURPLE_RESET} ${output.title}`
           }

package/assets/skills/brainstorming/SKILL.md

@@ -38,12 +38,14 @@ Do NOT invoke any implementation skill, write any code, or scaffold any project
 
 1. **Check discovery-cache first** — `src/discovery-cache.ts` `getDiscoverySnapshot(query)` + `getEngramDedup(query, requestId)`. Si hit válido (TTL+gitDiffHash), **reusar** sin llamar tools. Solo si miss → `engram_mem_search` + `codegraph_codegraph_explore` y **SHALL `putDiscoverySnapshot`** antes de avanzar. No re-llamar si área difiere <30% del snapshot.
 2. **Ask clarifying questions** — one at a time, understand purpose/constraints/success criteria
-4. **Propose 2-3 approaches (hardening-v2 — SHALL)** — con tabla trade-offs (coste|riesgo|complejidad) + evidencia CodeGraph+Engram (+Context7 si librería) sin alucinar, YAGNI, y recomendación con razón; cada approach cita symbols existentes y mem_search hits verificables
+4. **Propose 2-3 approaches (hardening-v2 — SHALL)** — con tabla trade-offs (coste|riesgo|complejidad) + evidencia CodeGraph+Engram sin alucinar, YAGNI, y recomendación con razón; cada approach cita symbols existentes y mem_search hits verificables
 5. **Present design** — in sections scaled to complexity, get user approval after each section. **Gate post-brainstorming (hardening-v2):** tras presentar diseño, preguntar "¿Procedo con este diseño o querés ajustar algo?" y esperar confirmación explícita antes de `record_discovery`, `openspec-propose` o implementación directa
-6. **Write design doc (output path condicional — router exclusivo):**
-   - Si trigger + `level 1+` no-downgradeable (`estLines>30` o `fileCount>2` o API pública) y change activo → escribir `openspec/changes/<id>/design.md` sección `## Alternatives Considered` con 2-3 approaches (tabla coste|riesgo|complejidad + evidencia CodeGraph+Engram), no `docs/`. No invocar `openspec-propose` separado — este es el diseño.
-   - Si trigger + `0/0+1` o `1+` downgradeable (`estLines<30`&&`fileCount==1`&&sin API) → solo `docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md` + gate único `¿Procedo?` → DIRECT sin change. SHALL sugerir downgrade: `"Esto parece 0+1 (~X líneas, 1 archivo). ¿Lo tratamos sin spec?"` y esperar.
+6. **Write design doc (output path condicional — router exclusivo) — SHALL read fresco + edit no write + sync proactiva:**
+   - Antes de `write` SHALL `read` fresco de `openspec/changes/<id>/{proposal,design,tasks}` o `docs/superpowers/specs/*.md` si existen; si existen SHALL `edit` (no `write`); `write` solo si no existía. `getDiscoverySnapshot` no aplica a specs/docs. Para `open-explore` sin archivo SHALL `mem_save topic_key:brainstorm/<hash>` por iteración.
+   - Si trigger + `level 1+` no-downgradeable (`estLines>30` o `fileCount>2` o API pública) y change activo → escribir `openspec/changes/<id>/design.md` sección `## Alternatives Considered` con 2-3 approaches (tabla coste|riesgo|complejidad + evidencia CodeGraph+Engram), no `docs/`. No invocar `openspec-propose` separado — este es el diseño. Si ya existe, SHALL `edit` no `write`.
+   - Si trigger + `0/0+1` o `1+` downgradeable (`estLines<30`&&`fileCount==1`&&sin API) → solo `docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md` + gate único `¿Procedo?` → DIRECT sin change. SHALL sugerir downgrade: `"Esto parece 0+1 (~X líneas, 1 archivo). ¿Lo tratamos sin spec?"` y esperar. Si `docsSpec` ya existe SHALL `read` + `edit`.
    - Gate post-brainstorming es **único**; no hay segundo `¿Procedo con spec?`. `get_audit` `WARN:duplicate_design_generated` si ambos artefactos mismo `requestId`.
+   - **Sync proactiva SHALL:** al final de cada turno con decisiones nuevas no reflejadas en disco SHALL listar cálido `Noté que lo que acordamos (X por Z) aún no está en <archivo>: 1) ...` (max 3) y proponer en UNA sola pregunta `¿Querés que agregue [X, Y] a <archivo> e implemente <mejor propuesta> —la recomiendo por <tradeoff>—?` (respetando Regla 5). Para brainstorming SHALL indicar `¿Querés que implementemos lo último que charlamos (B, recomendada por <tradeoff>) o preferís que vaya con A?`
 7. **Spec self-review** — check for placeholders, contradictions, ambiguity, scope
 8. **User reviews spec** — ask user to review before proceeding
 9. **Save to Engram** — `engram_mem_save` with the design decision and tradeoffs

package/assets/skills/graceful-degradation/SKILL.md

@@ -20,7 +20,6 @@ When critical tools are unavailable, this skill provides a systematic approach t
 | CodeGraph | MCP server | Engram → Read + Glob | No structural analysis, manual exploration |
 | Engram | MCP server | Continue without memory | No persistence across sessions |
 | Controller | MCP server | Inline validation + manual state | No state machine, no edit validation |
-| Context7 | MCP server (remote) | Skip documentation | No external API docs |
 
 ## Detection
 
@@ -108,12 +107,6 @@ Incluso en degraded, el guard de credenciales sigue activo (hard gate incluso en
 - No state persistence across crashes
 - No pending state enforcement (check_pending_state unavailable)
 
-### Without Context7
-
-**Impact:** Minimal — only affects external API documentation lookups.
-
-**Workflow:** Proceed normally. Use existing knowledge.
-
 ## Communication Protocol
 
 ### Status Report Format
@@ -141,7 +134,6 @@ Herramientas disponibles:
 ✅ Controller — ping OK
 ❌ CodeGraph — timeout 10s
 ✅ Engram — disponible
-✅ Context7 — disponible
 
 ¿Continuar con lectura manual de archivos?
 ```
@@ -154,7 +146,6 @@ Herramientas disponibles:
 ❌ Controller — no responde
 ❌ CodeGraph — no instalado
 ❌ Engram — timeout 5s
-✅ Context7 — disponible (pero sin docs relevantes)
 
 Modo básico: sin validación de edits, sin memoria persistente, sin análisis estructural.
 ¿Continuar o cancelar?