@ancleto/spec 0.4.0 → 0.4.3

package/package.json

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

package/src/cli/index.js

@@ -13,6 +13,7 @@ const __dirname = dirname(fileURLToPath(import.meta.url))
 const ROOT = join(__dirname, '..', '..')
 const ASSETS = ['agents', 'commands', 'skills']
 const TEMPLATES = ['AGENTS.md', 'PRODUCT.md']
+const AZURE_MCP_NOTICE = 'ancleto: MCP azure-devops habilitado — usa las variables de entorno AZURE_DEVOPS_ORG_URL y AZURE_DEVOPS_PAT'
 
 const HELP = `ancleto - orquestador SDD liviano con subagentes optimizados para costo/tokens
 (alias: aspec)
@@ -32,7 +33,9 @@ Uso:
   ancleto memory context [--scope X] [--out file]
                                    Imprime/escribe el bloque <ProjectMemoryRules> (reglas activas)
   ancleto memory doctor [--rebuild] Diagnostica .ancleto/memory.db (integridad, FTS5, unicidad)
-                                   y reconstruye el indice FTS5 con --rebuild
+                                    y reconstruye el indice FTS5 con --rebuild
+  ancleto check                         Verifica integridad de archivos instalados vs manifiesto
+  ancleto doctor                        Diagnostica el entorno (Node, node:sqlite, opencode.json)
   ancleto --help                      Esta ayuda
   ancleto --version                   Version del paquete
 `
@@ -221,13 +224,65 @@ async function copyAssets(dest) {
   }
 }
 
+const DEFAULT_OPENSPEC_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')
+  await mkdir(changesDir, { recursive: true })
+  const configPath = join(projectDir, 'openspec', 'config.yaml')
+  if (!(await exists(configPath))) {
+    await writeFile(configPath, DEFAULT_OPENSPEC_CONFIG)
+  }
+}
+
+function extractLockedBlocks(content) {
+  const blocks = new Map()
+  const re = /<!--\s*LOCKED:\s*([\w-]+)\s*-->([\s\S]*?)<!--\s*\/LOCKED:\s*\1\s*-->/g
+  let m
+  while ((m = re.exec(content)) !== null) {
+    blocks.set(m[1], m[0])
+  }
+  return blocks
+}
+
+function replaceLockedBlock(local, name, sourceBlock) {
+  const re = new RegExp(`<!--\\s*LOCKED:\\s*${escapeRe(name)}\\s*-->[\\s\\S]*?<!--\\s*\\/LOCKED:\\s*${escapeRe(name)}\\s*-->`)
+  if (!re.test(local)) return null
+  return local.replace(re, sourceBlock)
+}
+
+function mergeLocked(source, local, filename) {
+  const blocks = extractLockedBlocks(source)
+  let result = local
+  for (const [name, sourceBlock] of blocks) {
+    const replaced = replaceLockedBlock(result, name, sourceBlock)
+    if (replaced === null) {
+      console.warn(`ancleto: no se pudo actualizar el bloque LOCKED "${name}" en ${filename} (tags ausentes o mal formados)`)
+    } else {
+      result = replaced
+    }
+  }
+  return result
+}
+
 async function copyTemplates(projectDir) {
   const dest = join(projectDir, '.opencode')
   await copyAssets(dest)
   for (const t of TEMPLATES) {
     const target = join(projectDir, t)
-    if (await exists(target)) continue
-    await writeFile(target, await readFile(join(ROOT, 'templates', t)))
+    const source = await readFile(join(ROOT, 'templates', t), 'utf8')
+    if (!(await exists(target))) {
+      await writeFile(target, source)
+      continue
+    }
+    const local = await readFile(target, 'utf8')
+    const merged = mergeLocked(source, local, t)
+    if (merged !== local) {
+      await writeFile(target, merged)
+    }
   }
 }
 
@@ -235,7 +290,7 @@ async function install(args) {
   const pi = args.indexOf('--project')
   const project = pi >= 0 ? args[pi + 1] : null
   const withMcp = !args.includes('--no-mcp')
-  const mcpMap = withMcp ? buildDefaultMcp() : {}
+  let mcpMap = withMcp ? buildDefaultMcp() : {}
 
   const ti = args.indexOf('--tier')
   let tier = ti >= 0 ? args[ti + 1] : null
@@ -256,6 +311,7 @@ async function install(args) {
 
   if (project) {
     await copyTemplates(resolve(project))
+    await scaffoldOpenSpec(resolve(project))
     await writeManifest(resolve(project), {
       installedPaths: {
         templates: ['AGENTS.md', 'PRODUCT.md'],
@@ -277,6 +333,15 @@ async function install(args) {
   await applyTier(join(target, 'agents'), tier)
   await writeFile(tierStatePath(target), tier + '\n')
 
+  let azureMcp = false
+  if (project && withMcp) {
+    const rc = await readAncletorc(resolve(project))
+    if (rc?.azure?.enabled) {
+      mcpMap['azure-devops'] = { type: 'local', enabled: true, command: ['npx', '-y', '@davstack/mcp-azure-devops'] }
+      azureMcp = true
+    }
+  }
+
   const res = await mergeMcp(target, mcpMap)
   const loc = project
     ? `${resolve(project)} (.opencode/ + templates en la raiz)`
@@ -286,6 +351,7 @@ async function install(args) {
   if (res.added.length) {
     console.log(`ancleto: MCP configurados: ${res.added.join(', ')} en ${res.file}`)
   }
+  if (azureMcp) console.log(AZURE_MCP_NOTICE)
 }
 
 async function initProject(args) {
@@ -296,6 +362,8 @@ async function initProject(args) {
   if (withAzure) azure.enabled = true
   const discovery = existing?.discovery ?? { outputDir: 'docs/technical-discovery', exclude: [] }
   const manifest = await writeManifest(projectDir, { azure, discovery })
+  await scaffoldOpenSpec(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)'}`)
 }
 
@@ -556,6 +624,99 @@ async function memoryCmd(args) {
   process.exit(1)
 }
 
+async function checkCommand() {
+  const cwd = process.cwd()
+  const rc = await readAncletorc(cwd)
+  if (!rc || !rc.installedPaths) {
+    console.error('ancleto: no hay .ancletorc con installedPaths (corre ancleto init y ancleto install --project)')
+    process.exit(1)
+  }
+  const ip = rc.installedPaths
+  let missing = 0
+  let orphans = 0
+
+  for (const t of ip.templates || []) {
+    if (await exists(join(cwd, t))) {
+      console.log(`  ✔ ${t}`)
+    } else {
+      console.log(`  ✖ ${t} (faltante)`)
+      missing++
+    }
+  }
+
+  for (const cat of ['agents', 'commands', 'skills']) {
+    for (const dirRel of ip[cat] || []) {
+      const destDir = join(cwd, dirRel)
+      if (!(await exists(destDir))) {
+        console.log(`  ✖ ${dirRel} (directorio faltante)`)
+        missing++
+        continue
+      }
+      const expected = (await readdir(join(ROOT, cat))).sort()
+      const actual = (await readdir(destDir)).sort()
+      const missingFiles = expected.filter((f) => !actual.includes(f))
+      const orphanFiles = actual.filter((f) => !expected.includes(f))
+      for (const f of missingFiles) {
+        console.log(`  ✖ ${dirRel}/${f} (faltante)`)
+        missing++
+      }
+      for (const f of orphanFiles) {
+        console.log(`  ⚠ ${dirRel}/${f} (huerfano)`)
+        orphans++
+      }
+      if (missingFiles.length === 0 && orphanFiles.length === 0) {
+        console.log(`  ✔ ${dirRel} (${actual.length} archivos)`)
+      }
+    }
+  }
+
+  console.log(`ancleto: check -> ${missing} faltantes, ${orphans} huerfanos`)
+  process.exit(missing > 0 ? 1 : 0)
+}
+
+async function doctorCommand() {
+  let fatal = false
+
+  const nodeVersion = process.versions.node
+  const nodeMajor = Number(nodeVersion.split('.')[0])
+  if (nodeMajor >= 24) {
+    console.log(`  ✔ Node.js ${nodeVersion} (>=24)`)
+  } else {
+    console.log(`  ✖ Node.js ${nodeVersion} (requiere >=24 para node:sqlite)`)
+    fatal = true
+  }
+
+  try {
+    await import('node:sqlite')
+    console.log('  ✔ node:sqlite importable')
+  } catch (err) {
+    console.log(`  ✖ node:sqlite no importable: ${err.message}`)
+    fatal = true
+  }
+
+  const configDir = globalConfigDir()
+  let cfgFile = null
+  for (const c of ['opencode.json', 'opencode.jsonc']) {
+    const p = join(configDir, c)
+    if (await exists(p)) {
+      cfgFile = p
+      break
+    }
+  }
+  if (!cfgFile) {
+    console.log('  ⚠ opencode.json no encontrado (config MCP)')
+  } else {
+    try {
+      JSON.parse((await readFile(cfgFile, 'utf8')).replace(/^\uFEFF/, ''))
+      console.log(`  ✔ ${basename(cfgFile)} valido`)
+    } catch {
+      console.log(`  ✖ ${basename(cfgFile)} JSON invalido`)
+    }
+  }
+
+  process.exit(fatal ? 1 : 0)
+}
+
 const [cmd, ...rest] = process.argv.slice(2)
 
 switch (cmd) {
@@ -572,6 +733,12 @@ switch (cmd) {
   case 'memory':
     await memoryCmd(rest)
     break
+  case 'check':
+    await checkCommand()
+    break
+  case 'doctor':
+    await doctorCommand()
+    break
   case '--version':
   case '-v':
     console.log(`ancleto ${await packageVersion()}`)

package/templates/AGENTS.md

@@ -60,3 +60,7 @@ conflicto, prevalece el diseño vigente.
 
 - `ancleto`: Descubrimiento técnico e inicialización.
 - `openspec`: Gestión del ciclo de vida del cambio (proposal, specs, design, tasks, archive).
+
+<!-- LOCKED: test-block -->
+Contexto gestionado por @ancleto/spec — no editar: se re-aplica en cada actualizacion.
+<!-- /LOCKED: test-block -->

package/templates/PRODUCT.md

@@ -91,3 +91,7 @@ openspec/
 - `npm test` → Run tests
 - `npm run build` → Production build
 - `npm run lint` → Linter
+
+<!-- LOCKED: test-block -->
+Contexto gestionado por @ancleto/spec — no editar: se re-aplica en cada actualizacion.
+<!-- /LOCKED: test-block -->