@ancleto/spec 0.4.6 → 0.5.2

package/package.json

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

package/src/cli/index.js

@@ -8,6 +8,8 @@ import { fileURLToPath } from 'node:url'
 import { homedir, tmpdir } from 'node:os'
 import { createMemoryEngine, defaultMemoryDbPath } from '../core/memory/engine.js'
 import { memoryDoctor } from '../core/memory/doctor.js'
+import { writeDiscoveryMap } from '../core/discovery.js'
+import { readProjectTier, buildRepomixArgs, tierTokenBudget } from '../core/repomix-tier.js'
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
 const ROOT = join(__dirname, '..', '..')
@@ -26,6 +28,7 @@ Uso:
   ancleto install --tier <nivel>     normal | minimo | gratis (pregunta en la 1ra config)
   ancleto install --agent <nombre>    opencode | vscode | antigravity | cursor | roo (pregunta si no esta guardado)
   ancleto update [--project <dir>]    Alias de install (re-instala sobre lo existente)
+  ancleto upgrade [--agent <nombre>]  Re-aplica templates (LOCKED) y skills sobre el proyecto actual
   ancleto init [--with-azure] [--agent <nombre>]
                                     Crea .ancletorc en el repositorio actual
                                     (Azure desactivado por defecto, agente: opencode)
@@ -417,6 +420,31 @@ async function install(args) {
   if (azureMcp) console.log(AZURE_MCP_NOTICE)
 }
 
+async function upgradeCmd(args) {
+  const projectDir = process.cwd()
+  const rc = await readAncletorc(projectDir)
+  if (!rc) {
+    console.error("Error: No se encontro .ancletorc. Ejecuta 'ancleto init' primero.")
+    process.exit(1)
+  }
+  const agent = await resolveAgent(args, rc.agent)
+  await copyTemplates(projectDir)
+  const agentSkillsDir = await installAgentSkills(projectDir, agent)
+  const manifest = await writeManifest(projectDir, {
+    agent,
+    installedPaths: {
+      templates: ['AGENTS.md', 'PRODUCT.md'],
+      agents: ['.opencode/agents'],
+      commands: ['.opencode/commands'],
+      skills: [agentSkillsDir]
+    }
+  })
+  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('  ✔ manifiesto .ancletorc actualizado')
+}
+
 async function initProject(args) {
   const withAzure = args.includes('--with-azure')
   const projectDir = process.cwd()
@@ -571,16 +599,11 @@ async function checkDiscovery() {
 
 async function runRepomix(flags, tmpFile) {
   const local = await resolveBin('repomix')
+  const tier = readProjectTier(process.cwd())
+  const { exclude } = await loadDiscoveryConfig()
   const args = []
   if (!local) args.push('-y', 'repomix@1.18.0')
-  args.push('--output', tmpFile)
-  const inc = flagValue(flags, '--include')
-  if (inc) args.push('--include', inc)
-  const extraIgnore = flagValue(flags, '--ignore')
-  const { exclude } = await loadDiscoveryConfig()
-  const ignore = [...exclude, ...(extraIgnore ? extraIgnore.split(',') : [])].filter(Boolean)
-  if (ignore.length) args.push('--ignore', ignore.join(','))
-  if (flags.includes('--compress')) args.push('--compress')
+  args.push('--output', tmpFile, ...buildRepomixArgs(flags, tier, exclude))
   const cmd = local || 'npx'
   const r = spawnSync(cmd, args, { encoding: 'utf8', cwd: process.cwd(), shell: true })
   if (r.error) {
@@ -602,8 +625,9 @@ async function packDiscovery(flags) {
   let content = ''
   try { content = await readFile(tmpFile, 'utf8') } catch {}
   const tokens = Math.round(content.length / 4)
-  const budget = flagValue(flags, '--token-budget')
-  if (budget && tokens > Number(budget)) {
+  const explicit = flagValue(flags, '--token-budget')
+  const budget = explicit ? Number(explicit) : tierTokenBudget(readProjectTier(process.cwd()))
+  if (budget && tokens > budget) {
     console.error(`ancleto: el pack supera el token-budget (${tokens} > ${budget})`)
     process.exit(1)
   }
@@ -623,6 +647,7 @@ async function packDiscovery(flags) {
 }
 
 async function discovery(flags) {
+  try { writeDiscoveryMap(process.cwd()) } catch {}
   if (flags.includes('--check')) {
     await checkDiscovery()
     return
@@ -788,6 +813,9 @@ switch (cmd) {
   case 'update':
     await install(rest)
     break
+  case 'upgrade':
+    await upgradeCmd(rest)
+    break
   case 'init':
     await initProject(rest)
     break

package/src/core/discovery.js

@@ -0,0 +1,62 @@
+import { readdirSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+export const DISCOVERY_MAP_FILE = '.discovery-map.json'
+export const TOPOLOGY_IGNORED_DIRS = ['node_modules', '.git', '.ancleto', 'dist', 'build', 'coverage']
+
+function countFilesRecursive(dir, ignored) {
+  let n = 0
+  let entries
+  try {
+    entries = readdirSync(dir, { withFileTypes: true })
+  } catch {
+    return 0
+  }
+  for (const e of entries) {
+    const p = join(dir, e.name)
+    if (e.isDirectory()) {
+      if (ignored.has(e.name)) continue
+      n += countFilesRecursive(p, ignored)
+    } else if (e.isFile()) {
+      n += 1
+    }
+  }
+  return n
+}
+
+export function buildTopologyMap(rootDir) {
+  const ignored = new Set(TOPOLOGY_IGNORED_DIRS)
+  const tree_summary = {}
+  const root_files = []
+  let total = 0
+  let entries
+  try {
+    entries = readdirSync(rootDir, { withFileTypes: true })
+  } catch {
+    entries = []
+  }
+  for (const e of entries) {
+    if (ignored.has(e.name)) continue
+    if (e.isDirectory()) {
+      const n = countFilesRecursive(join(rootDir, e.name), ignored)
+      tree_summary[e.name] = n
+      total += n
+    } else if (e.isFile()) {
+      root_files.push(e.name)
+      total += 1
+    }
+  }
+  root_files.sort()
+  return {
+    last_updated: new Date().toISOString(),
+    total_files: total,
+    tree_summary,
+    root_files
+  }
+}
+
+export function writeDiscoveryMap(rootDir) {
+  const map = buildTopologyMap(rootDir)
+  writeFileSync(join(rootDir, DISCOVERY_MAP_FILE), JSON.stringify(map, null, 2) + '\n')
+  return map
+}

package/src/core/repomix-tier.js

@@ -0,0 +1,38 @@
+import { readFileSync, existsSync } from 'node:fs'
+import { join } from 'node:path'
+
+export const TIER_PACK_CONFIG = {
+  normal: { extraIgnore: [], compress: false, tokenBudget: null },
+  minimo: { extraIgnore: ['test/**', 'docs/**', '**/*.md'], compress: true, tokenBudget: null },
+  gratis: { extraIgnore: ['test/**', 'docs/**', '**/*.md'], compress: true, tokenBudget: 50000 }
+}
+
+export function readProjectTier(cwd) {
+  for (const p of [join(cwd, '.ancleto-tier'), join(cwd, '.opencode', '.ancleto-tier')]) {
+    if (!existsSync(p)) continue
+    const v = readFileSync(p, 'utf8').trim()
+    if (v) return TIER_PACK_CONFIG[v] ? v : 'gratis'
+  }
+  return 'gratis'
+}
+
+export function tierTokenBudget(tier) {
+  return (TIER_PACK_CONFIG[tier] || TIER_PACK_CONFIG.gratis).tokenBudget
+}
+
+export function buildRepomixArgs(flags, tier, exclude = []) {
+  const cfg = TIER_PACK_CONFIG[tier] || TIER_PACK_CONFIG.gratis
+  const args = []
+  const inc = flagValue(flags, '--include')
+  if (inc) args.push('--include', inc)
+  const extraIgnore = flagValue(flags, '--ignore')
+  const ignore = [...exclude, ...cfg.extraIgnore, ...(extraIgnore ? extraIgnore.split(',') : [])].filter(Boolean)
+  if (ignore.length) args.push('--ignore', ignore.join(','))
+  if (cfg.compress || flags.includes('--compress')) args.push('--compress')
+  return args
+}
+
+function flagValue(args, flag) {
+  const i = args.indexOf(flag)
+  return i >= 0 && args[i + 1] ? args[i + 1] : null
+}