@ancleto/spec 0.6.6 → 0.6.7

package/README.md

@@ -106,7 +106,7 @@ ancleto init --agent opencode --tier normal
 
 * `normal`: Modelos balanceados sin restricciones agresivas de contexto (default).
 * `minimo`: Enfoque en el modelo pago más económico viable, con alta compresión de contexto y exclusión de tests/docs en el discovery.
-* `gratis`: Bloqueado a modelos gratuitos (ej. `opencode/big-pickle`), empaquetado ultra-agresivo y un límite estricto (budget) de tokens enviado al LLM.
+* `gratis`: Bloqueado a modelos gratuitos, empaquetado ultra-agresivo y un límite estricto (budget) de tokens enviado al LLM. Si tenés acceso a **Muse Spark 1.3 Free** (`opencode/muse-spark-1.3-contributor-free`, no abierto a todos), se usa ese; si no, se usa `opencode/big-pickle`. En modo interactivo el instalador te lo pregunta; la elección queda guardada en `.ancletorc` (`gratisModel`).
 
 La configuración se preserva en `.ancletorc` (raíz del proyecto) y `.ancleto-tier` (junto a la configuración instalada).
 
@@ -211,3 +211,28 @@ ancleto init --with-azure
 ```
 
 Esto escribe `azure.enabled: true` en tu `.ancletorc`. Solo deberás completar la sección de Azure en el archivo `PRODUCT.md` e instalar su extensión (`az extension add --name azure-devops`).
+
+---
+
+## 🤖 Referencia: Agentes y Modelos por Tier
+
+Los 10 agentes instalados y el modelo que usa cada uno según tu tier. Al instalar, el nivel elegido se escribe en la línea `model:` de cada agente (y se re-aplica en cada `update`).
+
+| Agente | `normal` (default) | `minimo` | `gratis` |
+|---|---|---|---|
+| orchestrator | `opencode-go/qwen3.7-plus` | `opencode-go/deepseek-v4.1-flash` | ver nota ↓ |
+| coder | `opencode-go/minimax-m3` | `opencode-go/deepseek-v4.1-flash` | ver nota ↓ |
+| tester | `opencode-go/deepseek-v4.1-flash` | `opencode-go/deepseek-v4.1-flash` | ver nota ↓ |
+| spec-writer | `opencode-go/qwen3.7-plus` | `opencode-go/deepseek-v4.1-flash` | ver nota ↓ |
+| reviewer | `opencode-go/qwen3.6-plus` | `opencode-go/deepseek-v4.1-flash` | ver nota ↓ |
+| technical-discovery | `opencode-go/deepseek-v4.1-flash` | `opencode-go/deepseek-v4.1-flash` | ver nota ↓ |
+| technical-seed-writer | `opencode-go/minimax-m3` | `opencode-go/deepseek-v4.1-flash` | ver nota ↓ |
+| memory-keeper | `opencode-go/deepseek-v4.1-flash` | `opencode-go/deepseek-v4.1-flash` | ver nota ↓ |
+| context-resolver | `opencode-go/deepseek-v4.1-flash` | `opencode-go/deepseek-v4.1-flash` | ver nota ↓ |
+| documenter | `opencode-go/deepseek-v4.1-flash` | `opencode-go/deepseek-v4.1-flash` | ver nota ↓ |
+
+El tier `minimo` usa un único modelo (`deepseek-v4.1-flash`) para los 10 agentes: es el más económico del catálogo para coding (0.15/0.60 por millón de tokens) con 1M de contexto.
+
+**Tier `gratis`:** los 10 agentes usan **Muse Spark 1.3 Free** (`opencode/muse-spark-1.3-contributor-free`) **si está disponible** en tu cuenta (no está abierto a todos). En una instalación interactiva el wizard te lo pregunta; la respuesta se guarda en `.ancletorc` (`gratisModel`) y se reutiliza en los siguientes `install`/`update`. Sin TTY (CI) se detecta con `opencode models` — con timeout — y si no se puede confirmar se usa `opencode/big-pickle`. El instalador siempre informa cuál aplicó (`ancleto: modelo gratis: ...`).
+
+> Variable avanzada: `ANCLETO_MUSE_SPARK=1` fuerza Muse Spark, `ANCLETO_MUSE_SPARK=0` fuerza `big-pickle` (útil para tests o para fijar el comportamiento; tiene prioridad sobre la elección guardada).

package/agents/context-resolver.md

@@ -1,7 +1,7 @@
 ---
 description: Resolves intake grounding context (Work Item / card) before triage, so the orchestrator classifies and delegates with the real card content
 mode: subagent
-model: opencode-go/deepseek-v4-flash
+model: opencode-go/deepseek-v4.1-flash
 temperature: 0.1
 color: '#8b5cf6'
 tools:

package/agents/documenter.md

@@ -1,7 +1,7 @@
 ---
 description: Finalizes and archives completed aspec changes in alignment with the aspec lifecycle
 mode: subagent
-model: opencode-go/deepseek-v4-flash
+model: opencode-go/deepseek-v4.1-flash
 temperature: 0.1
 color: '#10b981'
 tools:

package/agents/memory-keeper.md

@@ -1,7 +1,7 @@
 ---
 description: Owns the repository memory (.ancleto/memory.db) — recalls prior lessons at intake and records rules and decisions at close, so a finding survives the session that produced it
 mode: subagent
-model: opencode-go/deepseek-v4-flash
+model: opencode-go/deepseek-v4.1-flash
 temperature: 0.1
 color: '#f59e0b'
 tools:

package/agents/technical-discovery.md

@@ -1,7 +1,7 @@
 ---
 description: Internal repository-context specialist, invoked only by the orchestrator to avoid repository sweeps
 mode: subagent
-model: opencode-go/deepseek-v4-flash
+model: opencode-go/deepseek-v4.1-flash
 temperature: 0.1
 color: '#0ea5e9'
 tools:

package/agents/tester.md

@@ -1,7 +1,7 @@
 ---
 description: Writes and updates tests, and verifies implementation against approved change inputs
 mode: subagent
-model: opencode-go/deepseek-v4-flash
+model: opencode-go/deepseek-v4.1-flash
 temperature: 0.1
 color: '#3b82f6'
 tools:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ancleto/spec",
-  "version": "0.6.6",
+  "version": "0.6.7",
   "description": "Orquestador SDD liviano con subagentes optimizados para costo/tokens",
   "type": "module",
   "bin": {

package/src/cli/index.js

@@ -12,6 +12,7 @@ import { memoryDoctor } from '../core/memory/doctor.js'
 import { writeDiscoveryMap } from '../core/discovery.js'
 import { readProjectTier, buildRepomixArgs, tierTokenBudget } from '../core/repomix-tier.js'
 import { showBanner, selectOption, stopBanner } from './ui.js'
+import { tierModels, gratisModel, envGratisModel, isKnownGratisModel, MUSE_SPARK_MODEL, GRATIS_FALLBACK_MODEL } from '../core/tier-models.js'
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
 const ROOT = join(__dirname, '..', '..')
@@ -137,26 +138,26 @@ const TIERS = {
   normal: {
     orchestrator: 'opencode-go/qwen3.7-plus',
     coder: 'opencode-go/minimax-m3',
-    tester: 'opencode-go/deepseek-v4-flash',
+    tester: 'opencode-go/deepseek-v4.1-flash',
     'spec-writer': 'opencode-go/qwen3.7-plus',
     reviewer: 'opencode-go/qwen3.6-plus',
-    'technical-discovery': 'opencode-go/deepseek-v4-flash',
+    'technical-discovery': 'opencode-go/deepseek-v4.1-flash',
     'technical-seed-writer': 'opencode-go/minimax-m3',
-    'memory-keeper': 'opencode-go/deepseek-v4-flash',
-    'context-resolver': 'opencode-go/deepseek-v4-flash',
-    documenter: 'opencode-go/deepseek-v4-flash'
+    'memory-keeper': 'opencode-go/deepseek-v4.1-flash',
+    'context-resolver': 'opencode-go/deepseek-v4.1-flash',
+    documenter: 'opencode-go/deepseek-v4.1-flash'
   },
   minimo: {
-    orchestrator: 'opencode-go/deepseek-v4-flash',
-    coder: 'opencode-go/minimax-m2.7',
-    tester: 'opencode-go/deepseek-v4-flash',
-    'spec-writer': 'opencode-go/qwen3.6-plus',
-    reviewer: 'opencode-go/deepseek-v4-flash',
-    'technical-discovery': 'opencode-go/deepseek-v4-flash',
-    'technical-seed-writer': 'opencode-go/minimax-m2.7',
-    'memory-keeper': 'opencode-go/deepseek-v4-flash',
-    'context-resolver': 'opencode-go/deepseek-v4-flash',
-    documenter: 'opencode-go/deepseek-v4-flash'
+    orchestrator: 'opencode-go/deepseek-v4.1-flash',
+    coder: 'opencode-go/deepseek-v4.1-flash',
+    tester: 'opencode-go/deepseek-v4.1-flash',
+    'spec-writer': 'opencode-go/deepseek-v4.1-flash',
+    reviewer: 'opencode-go/deepseek-v4.1-flash',
+    'technical-discovery': 'opencode-go/deepseek-v4.1-flash',
+    'technical-seed-writer': 'opencode-go/deepseek-v4.1-flash',
+    'memory-keeper': 'opencode-go/deepseek-v4.1-flash',
+    'context-resolver': 'opencode-go/deepseek-v4.1-flash',
+    documenter: 'opencode-go/deepseek-v4.1-flash'
   },
   gratis: {
     orchestrator: 'opencode/big-pickle',
@@ -176,8 +177,8 @@ function tierStatePath(targetDir) {
   return join(targetDir, '.ancleto-tier')
 }
 
-async function applyTier(agentsDir, tier) {
-  const map = TIERS[tier]
+async function applyTier(agentsDir, tier, models = null) {
+  const map = models || TIERS[tier]
   for (const [name, model] of Object.entries(map)) {
     const p = join(agentsDir, name + '.md')
     if (!(await exists(p))) continue
@@ -389,9 +390,11 @@ async function install(args) {
 
   let agent = agentFlag || (existingRc?.agent && SUPPORTED_AGENTS.includes(existingRc.agent) ? existingRc.agent : null)
 
+  let bannerShown = false
   const isInteractive = Boolean(process.stdout.isTTY) && ((projectDir && !agent) || !tier)
   if (isInteractive) {
     await showBanner()
+    bannerShown = true
     if (projectDir && !agent) {
       agent = await selectOption('Agente/IDE', SUPPORTED_AGENTS, Math.max(0, SUPPORTED_AGENTS.indexOf(DEFAULT_AGENT)))
     }
@@ -405,12 +408,29 @@ async function install(args) {
   if (projectDir && !agent) agent = DEFAULT_AGENT
   if (!tier) tier = TIERS[storedTier] ? storedTier : 'normal'
 
+  let gratisModelChoice = null
+  if (tier === 'gratis') {
+    const env = envGratisModel()
+    const persisted = isKnownGratisModel(existingRc?.gratisModel) ? existingRc.gratisModel : null
+    if (env || persisted) {
+      gratisModelChoice = env || persisted
+    } else if (process.stdout.isTTY) {
+      if (!bannerShown) await showBanner()
+      const answer = await selectOption('Muse Spark 1.3 Free disponible en tu cuenta?', ['No (usar big-pickle)', 'Si (Muse Spark)'], 0)
+      if (!bannerShown) stopBanner()
+      gratisModelChoice = answer.startsWith('Si') ? MUSE_SPARK_MODEL : GRATIS_FALLBACK_MODEL
+    } else {
+      gratisModelChoice = gratisModel()
+    }
+  }
+
   if (projectDir) {
     await copyTemplates(projectDir)
     await scaffoldAspec(projectDir)
     const agentSkillsDir = await installAgentSkills(projectDir, agent)
     await writeManifest(projectDir, {
       agent,
+      ...(gratisModelChoice ? { gratisModel: gratisModelChoice } : {}),
       installedPaths: {
         templates: ['AGENTS.md', 'PRODUCT.md'],
         agents: ['.opencode/agents'],
@@ -422,7 +442,8 @@ async function install(args) {
     await copyAssets(target)
   }
 
-  await applyTier(join(target, 'agents'), tier)
+  const models = tierModels(tier, TIERS, gratisModelChoice)
+  await applyTier(join(target, 'agents'), tier, models)
   await writeFile(tierStatePath(target), tier + '\n')
 
   let azureMcp = false
@@ -440,6 +461,7 @@ async function install(args) {
     : `${target} (disponible en todos tus proyectos)`
   console.log(`ancleto: instalado en ${loc}`)
   console.log(`ancleto: tier de costo de agents: ${tier}`)
+  if (tier === 'gratis') console.log(`ancleto: modelo gratis: ${models.orchestrator}`)
   if (res.added.length) {
     console.log(`ancleto: MCP configurados: ${res.added.join(', ')} en ${res.file}`)
   }

package/src/core/tier-models.js

@@ -0,0 +1,48 @@
+import { spawnSync } from 'node:child_process'
+
+export const MUSE_SPARK_MODEL = 'opencode/muse-spark-1.3-contributor-free'
+export const GRATIS_FALLBACK_MODEL = 'opencode/big-pickle'
+
+let probed = null
+
+export function envGratisModel() {
+  if (process.env.ANCLETO_MUSE_SPARK === '1') return MUSE_SPARK_MODEL
+  if (process.env.ANCLETO_MUSE_SPARK === '0') return GRATIS_FALLBACK_MODEL
+  return null
+}
+
+export function isKnownGratisModel(model) {
+  return model === MUSE_SPARK_MODEL || model === GRATIS_FALLBACK_MODEL
+}
+
+export function detectMuseSpark() {
+  const env = envGratisModel()
+  if (env) return env === MUSE_SPARK_MODEL
+  if (probed !== null) return probed
+  try {
+    const r = spawnSync('opencode models opencode', {
+      encoding: 'utf8',
+      timeout: 5000,
+      shell: true,
+      stdio: ['ignore', 'pipe', 'pipe']
+    })
+    probed = !r.error && r.status === 0
+      && String(r.stdout || '').split('\n').some((l) => l.trim() === MUSE_SPARK_MODEL)
+  } catch {
+    probed = false
+  }
+  return probed
+}
+
+export function gratisModel(persisted = null) {
+  const env = envGratisModel()
+  if (env) return env
+  if (isKnownGratisModel(persisted)) return persisted
+  return detectMuseSpark() ? MUSE_SPARK_MODEL : GRATIS_FALLBACK_MODEL
+}
+
+export function tierModels(tier, tiers, gratisOverride = null) {
+  if (tier !== 'gratis') return tiers[tier]
+  const model = gratisOverride || gratisModel()
+  return Object.fromEntries(Object.keys(tiers.gratis).map((k) => [k, model]))
+}