@ancleto/spec 0.6.2 → 0.6.5

package/skills/ancleto-upgrade/references/templates.md

@@ -1,4 +1,4 @@
-# Templates — Artefactos OpenSpec
+# Templates — Artefactos aspec
 
 Este archivo contiene los templates exactos para los cuatro artefactos que genera
 el skill. Leer este archivo en el Paso 6 y completar cada placeholder `{...}`.

package/skills/{openspec-verify → ancleto-verify}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: openspec-verify
+name: ancleto-verify
 description: Verify an implementation against its change artifacts (completeness, correctness, coherence). Use before archiving a change. Captures architectural findings into persistent memory. No external binaries required.
 license: MIT
 compatibility: No external binaries required. Works with any agent runtime.
@@ -8,11 +8,11 @@ metadata:
   version: '1.0'
 ---
 
-# OpenSpec Verify
+# aspec Verify
 
 Verify that an implementation matches its change artifacts (proposal, design, tasks, delta specs) by reading the files directly. No external binaries are invoked.
 
-**Input**: Optionally specify a change name (e.g., `add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous, list the directories under `openspec/changes/` that contain a `tasks.md` file and ask the user to select. Mark changes with incomplete tasks as "(In Progress)".
+**Input**: Optionally specify a change name (e.g., `add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous, list the directories under `aspec/changes/` that contain a `tasks.md` file and ask the user to select. Mark changes with incomplete tasks as "(In Progress)".
 
 **IMPORTANT**: Do NOT guess or auto-select a change. Always let the user choose.
 
@@ -20,7 +20,7 @@ Verify that an implementation matches its change artifacts (proposal, design, ta
 
 ### 1. Load the change artifacts
 
-Read everything under `openspec/changes/<name>/`:
+Read everything under `aspec/changes/<name>/`:
 
 - `tasks.md` — the checklist (required)
 - `proposal.md`, `design.md` — intent and decisions (if present)
@@ -36,7 +36,7 @@ Read everything under `openspec/changes/<name>/`:
 
 **Spec Coverage:**
 
-- If delta specs exist in `openspec/changes/<name>/specs/`:
+- If delta specs exist in `aspec/changes/<name>/specs/`:
   - Extract all requirements (marked with `### Requirement:`).
   - For each requirement, search the codebase for keywords related to it and assess whether implementation likely exists.
   - If a requirement appears unimplemented, add a CRITICAL issue: "Requirement not found: `<requirement name>`" with the recommendation "Implement requirement: `<description>`".

package/skills/{openspec-workflow → ancleto-workflow}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: openspec-workflow
+name: ancleto-workflow
 description: Router for the spec-driven lifecycle — know which stage you're in and which skill runs next. Use when unsure where a request fits, or to explain the full cycle. No external binaries required.
 license: MIT
 compatibility: No external binaries required. Works with any agent runtime.
@@ -8,7 +8,7 @@ metadata:
   version: '1.0'
 ---
 
-# OpenSpec Workflow
+# aspec Workflow
 
 This skill is the map of the spec-driven lifecycle. It does not execute work itself — it routes: given where the user (or the current change) stands, it names the skill that runs next and hands over the required context.
 
@@ -28,28 +28,28 @@ explore → new/propose/ff → continue* → apply → verify → archive
 
 | User wants to… | Run |
 |---|---|
-| Think through an idea or problem, no commitment yet | `openspec-explore` |
-| Start structured work on something new | `openspec-new` (step by step) or `openspec-propose` (all artifacts at once) |
-| Skip straight to a full draft when the path is clear | `openspec-ff` |
-| Resume a change with missing artifacts | `openspec-continue` (repeat until complete) |
-| Implement tasks from ready artifacts | `openspec-apply` |
-| Check implementation against artifacts before closing | `openspec-verify` |
-| Close one finished change (syncing its specs) | `openspec-archive` |
-| Close several finished changes at once | `openspec-bulk-archive` |
-| Learn the whole cycle hands-on | `openspec-onboard` |
+| Think through an idea or problem, no commitment yet | `ancleto-explore` |
+| Start structured work on something new | `ancleto-new` (step by step) or `ancleto-propose` (all artifacts at once) |
+| Skip straight to a full draft when the path is clear | `ancleto-ff` |
+| Resume a change with missing artifacts | `ancleto-continue` (repeat until complete) |
+| Implement tasks from ready artifacts | `ancleto-apply` |
+| Check implementation against artifacts before closing | `ancleto-verify` |
+| Close one finished change (syncing its specs) | `ancleto-archive` |
+| Close several finished changes at once | `ancleto-bulk-archive` |
+| Learn the whole cycle hands-on | `ancleto-onboard` |
 | Recall what the team learned about a topic | `searchMemory` directly (or the recall contract) |
 
-**By change state** (read `openspec/changes/<name>/`):
+**By change state** (read `aspec/changes/<name>/`):
 
 | State | Run |
 |---|---|
-| Directory missing → nothing to continue | `openspec-new` (or propose/ff) |
-| `proposal.md` missing | `openspec-continue` |
-| `specs/` or `design.md` missing | `openspec-continue` |
-| `tasks.md` missing | `openspec-continue` |
-| All artifacts present, tasks unchecked | `openspec-apply` |
-| All tasks checked | `openspec-verify`, then `openspec-archive` |
-| Several changes complete | `openspec-bulk-archive` |
+| Directory missing → nothing to continue | `ancleto-new` (or propose/ff) |
+| `proposal.md` missing | `ancleto-continue` |
+| `specs/` or `design.md` missing | `ancleto-continue` |
+| `tasks.md` missing | `ancleto-continue` |
+| All artifacts present, tasks unchecked | `ancleto-apply` |
+| All tasks checked | `ancleto-verify`, then `ancleto-archive` |
+| Several changes complete | `ancleto-bulk-archive` |
 
 ## Handoff Contract
 

package/skills/triage-clarifier/SKILL.md

@@ -96,6 +96,6 @@ If option 4 happened and the answer still does not remove the main ambiguity, cl
 ## What not to do
 
 - do not create specs, design, tasks, or proposals
-- do not trigger opsx or any workflow handoff
+- do not trigger cleto or any workflow handoff
 - do not ask more than one clarification question
 - do not replace the orchestrator's final responsibility for classification

package/src/cli/index.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
-import { cp, mkdir, access, writeFile, readFile, readdir } from 'node:fs/promises'
+import { existsSync } from 'node:fs'
+import { cp, mkdir, access, writeFile, readFile, readdir, rename } from 'node:fs/promises'
 import { spawnSync } from 'node:child_process'
 import { createHash } from 'node:crypto'
 import { createInterface } from 'node:readline'
@@ -86,17 +87,21 @@ function globalConfigDir() {
     : join(homedir(), '.config', 'opencode')
 }
 
+function binName(base) {
+  return process.platform === 'win32' ? `${base}.exe` : base
+}
+
 function resolveBin(name, fallbacks = []) {
   const probe = process.platform === 'win32' ? 'where' : 'which'
   const r = spawnSync(probe, [name], { encoding: 'utf8' })
   if (r.status === 0 && r.stdout) {
-    const first = r.stdout.split(/\r?\n/)
-      .map((s) => s.trim())
-      .find((s) => s && !/^informacion:/i.test(s))
-    if (first) return first
+    for (const line of r.stdout.split(/\r?\n/)) {
+      const candidate = line.trim()
+      if (candidate && !/^informacion:/i.test(candidate)) return candidate
+    }
   }
   for (const fb of fallbacks) {
-    if (fb) return fb
+    if (fb && existsSync(fb)) return fb
   }
   return null
 }
@@ -104,16 +109,21 @@ function resolveBin(name, fallbacks = []) {
 function buildDefaultMcp() {
   const mcp = {}
 
-  const engramBin = resolveBin('engram', [join(homedir(), 'go', 'bin', 'engram.exe')])
+  const engramFallbacks = [
+    join(homedir(), 'go', 'bin', binName('engram')),
+    join(homedir(), '.local', 'bin', binName('engram'))
+  ]
+  const engramBin = resolveBin('engram', engramFallbacks)
   if (engramBin) {
     mcp.engram = { type: 'local', enabled: true, command: [engramBin, 'mcp', '--tools=agent'] }
   } else {
     console.warn('ancleto: no se encontro engram (memoria) en PATH; se omitio su MCP')
   }
 
-  const cavemanBin = resolveBin('caveman-mcp', [
-    join(homedir(), '.caveman', 'bin', 'caveman-mcp.exe')
-  ])
+  const cavemanFallbacks = [
+    join(homedir(), '.caveman', 'bin', binName('caveman-mcp'))
+  ]
+  const cavemanBin = resolveBin('caveman-mcp', cavemanFallbacks)
   if (cavemanBin) {
     mcp.caveman = { type: 'local', enabled: true, command: [cavemanBin] }
   } else {
@@ -280,13 +290,13 @@ const AGENT_SKILLS_DIR = {
   roo: '.roo/skills'
 }
 
-const OPENSPEC_SKILLS = ['openspec-new', 'openspec-propose', 'openspec-apply', 'openspec-verify', 'openspec-archive', 'openspec-bulk-archive', 'openspec-continue', 'openspec-explore', 'openspec-ff', 'openspec-onboard', 'openspec-workflow']
+const ANCLETO_SKILLS = ['ancleto-new', 'ancleto-propose', 'ancleto-apply', 'ancleto-verify', 'ancleto-archive', 'ancleto-bulk-archive', 'ancleto-continue', 'ancleto-explore', 'ancleto-ff', 'ancleto-onboard', 'ancleto-workflow']
 
 async function installAgentSkills(projectDir, agent) {
   const dir = AGENT_SKILLS_DIR[agent] || AGENT_SKILLS_DIR.opencode
   const dest = join(projectDir, dir)
   await mkdir(dest, { recursive: true })
-  for (const name of OPENSPEC_SKILLS) {
+  for (const name of ANCLETO_SKILLS) {
     const src = join(ROOT, 'skills', name)
     if (!(await exists(src))) {
       console.warn(`ancleto: skill no encontrada en el paquete: ${name}`)
@@ -300,17 +310,19 @@ async function installAgentSkills(projectDir, agent) {
   return dir.replace(/\\/g, '/')
 }
 
-const DEFAULT_OPENSPEC_CONFIG = `# OpenSpec project configuration
+const CHANGES_ROOT = 'aspec'
+
+const DEFAULT_ASPEC_CONFIG = `# OpenSpec project configuration
 # Generado por @ancleto/spec (G5) — editalo libremente, no se sobrescribe en reinstalaciones.
 schema: spec-driven-development
 `
 
-async function scaffoldOpenSpec(projectDir) {
-  const changesDir = join(projectDir, 'openspec', 'changes')
+async function scaffoldAspec(projectDir) {
+  const changesDir = join(projectDir, CHANGES_ROOT, 'changes')
   await mkdir(changesDir, { recursive: true })
-  const configPath = join(projectDir, 'openspec', 'config.yaml')
+  const configPath = join(projectDir, CHANGES_ROOT, 'config.yaml')
   if (!(await exists(configPath))) {
-    await writeFile(configPath, DEFAULT_OPENSPEC_CONFIG)
+    await writeFile(configPath, DEFAULT_ASPEC_CONFIG)
   }
 }
 
@@ -382,7 +394,7 @@ async function install(args) {
 
   if (project) {
     await copyTemplates(resolve(project))
-    await scaffoldOpenSpec(resolve(project))
+    await scaffoldAspec(resolve(project))
     const existingRc = await readAncletorc(resolve(project))
     const agent = await resolveAgent(args, existingRc?.agent)
     const agentSkillsDir = await installAgentSkills(resolve(project), agent)
@@ -436,6 +448,14 @@ async function upgradeCmd(args) {
     console.error("Error: No se encontro .ancletorc. Ejecuta 'ancleto init' primero.")
     process.exit(1)
   }
+  const legacyChanges = join(projectDir, 'openspec')
+  const changesRoot = join(projectDir, CHANGES_ROOT)
+  if ((await exists(legacyChanges)) && !(await exists(changesRoot))) {
+    await rename(legacyChanges, changesRoot)
+    console.log('ancleto: changes migrados de openspec/ a aspec/')
+  } else if ((await exists(legacyChanges)) && (await exists(changesRoot))) {
+    console.warn('ancleto: existen openspec/ y aspec/ — no se migro nada (revisar manualmente)')
+  }
   const agent = await resolveAgent(args, rc.agent)
   await copyTemplates(projectDir)
   const agentSkillsDir = await installAgentSkills(projectDir, agent)
@@ -450,7 +470,7 @@ async function upgradeCmd(args) {
   })
   console.log(`ancleto: upgrade completo (v${manifest.version}, agente: ${agent})`)
   console.log('  ✔ templates re-aplicados (bloques LOCKED actualizados, EXTENSIBLE intacto)')
-  console.log(`  ✔ skills actualizadas en ${agentSkillsDir} (${OPENSPEC_SKILLS.length} skills)`)
+  console.log(`  ✔ skills actualizadas en ${agentSkillsDir} (${ANCLETO_SKILLS.length} skills)`)
   console.log('  ✔ manifiesto .ancletorc actualizado')
 }
 
@@ -491,7 +511,7 @@ async function initProject(args) {
   }
 
   const manifest = await writeManifest(projectDir, { azure, discovery, agent })
-  await scaffoldOpenSpec(projectDir)
+  await scaffoldAspec(projectDir)
   if (azure.enabled) console.log(AZURE_MCP_NOTICE)
   console.log(`ancleto: .ancletorc actualizado en ${projectDir} (v${manifest.version})${azure.enabled ? ' (Azure habilitado)' : ' (Azure desactivado)'} (Agente: ${agent})${tier ? ` (Tier: ${tier})` : ''}`)
 }

package/templates/AGENTS.md

@@ -50,16 +50,16 @@ conflicto, prevalece el diseño vigente.
 - Si la memoria contradice el estado actual del código o los guardrails de este archivo,
   reportá la discrepancia en lugar de aplicarla a ciegas.
 
-## Flujo Spec-Driven (OpenSpec)
+## Flujo Spec-Driven (aspec)
 
-- **Cambios con scope incierto / arquitectura**: Crear artifacts en `openspec/changes/<name>/`.
+- **Cambios con scope incierto / arquitectura**: Crear artifacts en `aspec/changes/<name>/`.
 - **Cambios menores / fixes**: Implementación directa.
-- **Cierre**: Archivar con `openspec archive` al finalizar.
+- **Cierre**: Archivar con `/cleto-archive` al finalizar.
 
 ## Tools de Soporte
 
 - `ancleto`: Descubrimiento técnico e inicialización.
-- `openspec`: Gestión del ciclo de vida del cambio (proposal, specs, design, tasks, archive).
+- `cleto-*`: Comandos del ciclo de vida del cambio en el IDE (proposal, specs, design, tasks, archive).
 
 <!-- LOCKED: test-block -->
 Contexto gestionado por @ancleto/spec — no editar: se re-aplica en cada actualizacion.

package/templates/PRODUCT.md

@@ -64,7 +64,7 @@ src/
   components/
   features/
   services/
-openspec/
+aspec/
   config.yaml
   changes/
 ```