@dsalazardev/ai-hub-cli 0.2.0 → 0.3.0

package/README.md

@@ -7,6 +7,11 @@ el proyecto ya usa, sin acoplarse a un lenguaje ni a un dominio concreto.
 ## Requisitos
 
 - Node.js >= 22
+- [uv](https://docs.astral.sh/uv/getting-started/installation/) con `uvx` en el PATH: `init` e `install`
+  ejecutan Spec Kit con `uvx --from specify-cli==<versión fijada>`, sin `uv tool install`.
+- `bash` para los scripts `sh` de Spec Kit (por defecto en todas las plataformas). En Windows,
+  Git for Windows (Git Bash) en el PATH; el lanzador `bash` de WSL sin distribución no sirve.
+  Alternativa: `speckit.script: ps` en `manifest.yaml` (requiere PowerShell).
 
 ## Uso rápido
 
@@ -19,8 +24,40 @@ npx @dsalazardev/ai-hub-cli doctor
 ```
 
 `init` detecta el preset según el stack del repositorio y materializa `.ai-hub/`,
-que es obligatoria. `install` proyecta reglas, agentes y skills a los destinos
-declarados en `targets`. `doctor` valida motor, preset, manifiesto y deriva.
+que es obligatoria, e instala Spec Kit en la raíz con las extensiones `bug` y `assess`.
+`install` proyecta reglas, agentes y skills a los destinos declarados en `targets` y
+repite la instalación de Spec Kit. `doctor` valida motor, preset, manifiesto, deriva y
+Spec Kit.
+
+## Spec Kit
+
+Spec Kit ejecuta los 17 comandos de la metodología; AI-Hub define roles, estados y
+etiquetas. El paquete fija la versión de `specify-cli`, la de las extensiones y una
+fecha `--exclude-newer` para las dependencias de `uvx`. Esa fecha se mueve solo en un
+release, nunca automáticamente. `manifest.yaml` puede restringir la versión dentro del rango
+soportado (`speckit.version`), elegir el script (`speckit.script: sh | ps`) y la integración
+por defecto (`speckit.defaultTarget`), pero no ampliar la versión ni cambiar las extensiones.
+
+- Spec Kit se instala en `claude`, `opencode`, `pi` y `cursor` (`cursor-agent`). **Copilot
+  no recibe Spec Kit**: recibe agentes, reglas y la regla `ai-hub-speckit`.
+- Sin `uv`, sin red y sin caché para la versión fijada, o sin `bash` con `script: sh`,
+  `init` sale con código 2 **antes de escribir nada** y dice qué falta.
+- `init --no-speckit` instala sin Spec Kit y deja el arnés **degradado** (`doctor` sale 1).
+  Un `ai-hub install` posterior sin la bandera lo reactiva.
+- `.specify/` y `specs/` se versionan; las copias de los comandos en las carpetas de los
+  asistentes no, y `install` las regenera en un clon nuevo.
+
+### CI
+
+`doctor` no necesita Python, pero un clon nuevo no tiene las copias de los comandos de
+Spec Kit en las carpetas de los asistentes, que están ignoradas. El job instala `uv`,
+regenera con `install` y verifica:
+
+```yaml
+- uses: astral-sh/setup-uv@v6
+- run: npx @dsalazardev/ai-hub-cli install
+- run: npx @dsalazardev/ai-hub-cli doctor
+```
 
 Si la detección es ambigua, el preset se elige explícitamente:
 
@@ -48,14 +85,36 @@ npx @dsalazardev/ai-hub-cli install --targets claude
 | `context` | Regenera `.planning/context-next.md` |
 | `purge` | Retira los destinos generados, con snapshot previo |
 
+## Checks de Spec Kit en `doctor`
+
+`doctor` verifica la instalación de Spec Kit leyendo `.specify/` y calculando hashes; no
+ejecuta Python ni `uvx`. En el checkout del motor todos informan `no aplica`.
+
+| Check | Criterio | Reparación |
+|---|---|---|
+| `speckit:managed` | `speckit.managed` no es `false`; un arnés con `--no-speckit` es **degradado** y `doctor` sale 1 | `ai-hub install` (sin `--no-speckit`) |
+| `speckit:installed` | Existe `.specify/init-options.json` | `ai-hub install` |
+| `speckit:version` | `speckit_version` coincide con la versión fijada (o la que restrinja `speckit.version`) | `ai-hub install` |
+| `speckit:shell` | El shell del script declarado ejecuta `echo ok` (`bash` para `sh`, PowerShell para `ps`) | Instalar Git Bash/bash, o declarar `speckit.script: ps` |
+| `speckit:integrations` | `.specify/integration.json` tiene exactamente las integraciones de los destinos con Spec Kit, sin `copilot`, y la integración por defecto declarada | `ai-hub install`; si aparece `copilot`, `specify integration uninstall copilot` |
+| `speckit:targets` | Informativo: `copilot: sin Spec Kit` (recibe agentes y reglas, no comandos) | — |
+| `speckit:extensions` | `bug` y `assess` instalados en la versión fijada, registrados y presentes en cada destino con Spec Kit | `ai-hub install` |
+| `speckit:integrity` | Cada archivo de `.specify/integrations/*.manifest.json` existe; si su hash difiere solo avisa (el próximo `init` lo sobrescribe) | `ai-hub install`; personalizar con overrides de Spec Kit, no editando plantillas |
+| `speckit:collision` | Ninguna ruta de `sync.lock.json` pertenece a Spec Kit | `ai-hub sync`; no publicar skills con nombre `speckit-*` |
+| `speckit:constitution` | Aviso si `.specify/memory/constitution.md` sigue siendo la plantilla | Ejecutar `/speckit.constitution` (o `/speckit-constitution`) |
+| `speckit:versioning` | En un repositorio git no se ignoran la constitución, `init-options.json` ni `specs/` | Quitar esas rutas de `.gitignore` |
+
 ## Estructura instalada
 
 ```
 .ai-hub/            preset materializado, manifiesto y configuración (obligatoria)
-.planning/          estado, hallazgos y ledger de la sesión
-.claude/ .opencode/ .pi/ .cursor/ .github/   destinos generados según targets
+.specify/           Spec Kit: constitución, plantillas, scripts, assessments y bugs (versionado)
+specs/              features de Spec Kit: spec.md, plan.md, tasks.md (versionado)
+.claude/ .opencode/ .pi/ .cursor/ .github/   destinos generados según targets (ignorados)
 ```
 
+Una instalación no crea `.planning/`: es estado del checkout de desarrollo del motor.
+
 ## Procedencia de activos
 
 Ver `NOTICE.md` para el origen de skills y agentes reutilizados.

package/dist/backup/snapshots.js

@@ -38,6 +38,11 @@ async function walkRelative(root, relative) {
     }
     return files;
 }
+const SPECKIT_CONFIG_FILES = [
+    '.specify/init-options.json',
+    '.specify/integration.json',
+    '.specify/extensions.yml',
+];
 async function managedFiles(root) {
     const files = new Set([
         'sync.lock.json',
@@ -52,6 +57,13 @@ async function managedFiles(root) {
     for (const rel of await walkRelative(root, '.ai-hub')) {
         files.add(rel);
     }
+    // Estado de Spec Kit que un nuevo `specify init` podría tocar: constitución y configuración.
+    for (const rel of await walkRelative(root, '.specify/memory')) {
+        files.add(rel);
+    }
+    for (const rel of SPECKIT_CONFIG_FILES) {
+        files.add(rel);
+    }
     const result = [];
     for (const rel of [...files].sort()) {
         if (await exists(path.join(root, rel))) {

package/dist/catalog.d.ts

@@ -16,11 +16,18 @@ export interface SelectionScope {
 }
 export interface CatalogIndex {
     skills: string[];
+    /** Skills del paquete que declaran `runtime: false`: siguen publicadas pero no son instalables. */
+    retiredSkills: string[];
     agents: string[];
     skillFiles: Record<string, string[]>;
     ruleFiles: Record<string, string[]>;
     walkCount: number;
 }
+/**
+ * Índice de las skills instalables de un directorio de catálogo. Las skills con
+ * `runtime: false` siguen en el paquete pero no se listan, materializan ni proyectan.
+ */
+export declare function buildCatalogIndexFrom(skillsDir: string): Promise<Pick<CatalogIndex, 'skills' | 'skillFiles' | 'retiredSkills'>>;
 /**
  * Índice memoizado por proceso. En tests, `AI_HUB_CATALOG_INDEX_FILE` apunta al
  * índice que construye `globalSetup`, de modo que todos los workers comparten un
@@ -31,7 +38,7 @@ export declare function catalogIndex(): Promise<CatalogIndex>;
 export declare function rebuildCatalogIndex(): Promise<CatalogIndex>;
 export declare function catalogWalkCount(): number;
 export declare function resetCatalogIndex(): void;
-/** Skills de catálogo: todas las del paquete menos las 17 del motor. */
+/** Skills instalables del catálogo; los 17 comandos los provee Spec Kit, no el catálogo. */
 export declare function listCatalogSkills(engine: EngineManifest): Promise<string[]>;
 /** Agentes de catálogo publicados en el paquete. */
 export declare function listCatalogAgents(): Promise<string[]>;

package/dist/catalog.js

@@ -4,6 +4,7 @@ import { fileURLToPath } from 'node:url';
 import { ENGINE_SKILLS_DIR } from './engine/engine.js';
 import { PACKAGE_VERSION } from './package-info.js';
 import { sha256 } from './sync/lock.js';
+import { splitFrontmatter } from './frontmatter.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 /** Directorio de agentes dentro del paquete (core/agents). */
 export const ENGINE_AGENTS_DIR = path.join(__dirname, '..', 'agents');
@@ -38,16 +39,43 @@ async function walk(dir) {
     }
     return files.sort();
 }
-async function buildCatalogIndex() {
-    walkCount += 1;
-    const entries = await fs.readdir(ENGINE_SKILLS_DIR, { withFileTypes: true }).catch(() => []);
+/** `true` si el frontmatter de la skill declara `runtime: false` (no instalable). */
+async function isRuntimeSkill(skillDir) {
+    const text = await fs.readFile(path.join(skillDir, 'SKILL.md'), 'utf8').catch(() => null);
+    if (text === null) {
+        return true;
+    }
+    try {
+        return splitFrontmatter(text, skillDir).data.runtime !== false;
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * Índice de las skills instalables de un directorio de catálogo. Las skills con
+ * `runtime: false` siguen en el paquete pero no se listan, materializan ni proyectan.
+ */
+export async function buildCatalogIndexFrom(skillsDir) {
+    const entries = await fs.readdir(skillsDir, { withFileTypes: true }).catch(() => []);
     const skillFiles = {};
-    for (const entry of entries) {
+    const retiredSkills = [];
+    for (const entry of entries.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0))) {
         if (!entry.isDirectory()) {
             continue;
         }
-        skillFiles[entry.name] = await walk(path.join(ENGINE_SKILLS_DIR, entry.name));
+        const dir = path.join(skillsDir, entry.name);
+        if (!(await isRuntimeSkill(dir))) {
+            retiredSkills.push(entry.name);
+            continue;
+        }
+        skillFiles[entry.name] = await walk(dir);
     }
+    return { skills: Object.keys(skillFiles).sort(), skillFiles, retiredSkills: retiredSkills.sort() };
+}
+async function buildCatalogIndex() {
+    walkCount += 1;
+    const { skillFiles, retiredSkills } = await buildCatalogIndexFrom(ENGINE_SKILLS_DIR);
     const ruleFiles = {};
     for (const id of RUBRIC_RULE_IDS) {
         const file = path.join(ENGINE_RULES_DIR, `${id}.md`);
@@ -60,6 +88,7 @@ async function buildCatalogIndex() {
             .filter((file) => file.endsWith('.md'))
             .map((file) => path.basename(file, '.md'))
             .sort(),
+        retiredSkills,
         skillFiles,
         ruleFiles,
         walkCount,
@@ -78,6 +107,7 @@ async function readIndexFile(file) {
         }
         return {
             skills: parsed.skills,
+            retiredSkills: Array.isArray(parsed.retiredSkills) ? parsed.retiredSkills : [],
             agents: parsed.agents,
             skillFiles: parsed.skillFiles,
             ruleFiles: parsed.ruleFiles,
@@ -121,11 +151,10 @@ export function resetCatalogIndex() {
     indexPromise = null;
     walkCount = 0;
 }
-/** Skills de catálogo: todas las del paquete menos las 17 del motor. */
+/** Skills instalables del catálogo; los 17 comandos los provee Spec Kit, no el catálogo. */
 export async function listCatalogSkills(engine) {
-    const index = await catalogIndex();
-    const engineSkills = new Set(engine.commands.map((command) => command.skill));
-    return index.skills.filter((skill) => !engineSkills.has(skill));
+    void engine;
+    return (await catalogIndex()).skills;
 }
 /** Agentes de catálogo publicados en el paquete. */
 export async function listCatalogAgents() {

package/dist/cli/args.js

@@ -13,6 +13,7 @@ const BOOLEAN_FLAGS = new Set([
     'prune',
     'auto',
     'migrate',
+    'no-speckit',
 ]);
 export function parseArgs(argv) {
     const positionals = [];

package/dist/cli/doctor.js

@@ -4,13 +4,14 @@ import { spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { readAiHubRc } from '../paths.js';
 import { auditSelection } from '../catalog.js';
-import { ENGINE_COUNTS, ENGINE_LANES, ENGINE_SKILLS_DIR } from '../engine/engine.js';
-import { scanCoupling, scanLegacyArtifacts } from '../engine/gates.js';
+import { ENGINE_COUNTS, ENGINE_LANES } from '../engine/engine.js';
+import { scanCoupling, scanLegacyArtifacts, scanReservedNamespace, scanRetiredStates } from '../engine/gates.js';
 import { checkInventory, loadManifestContext, } from '../manifest/manifest.js';
 import { checkLock, runSync } from '../sync/sync.js';
 import { CONTEXT_RELATIVE, contextHash } from './context.js';
 import { TARGETS, TOOL_IDS, isToolId } from '../sync/targets.js';
 import { sourceCheckout } from './source.js';
+import { speckitDoctorChecks, speckitNotApplicable } from '../speckit/doctor.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const COUPLING_FILE = path.join(__dirname, '..', '..', 'engine', 'coupling.json');
 async function couplingRules() {
@@ -103,19 +104,13 @@ export async function diagnose(ctx) {
         add('policy:optOuts', true, manifest.policy.optOuts.length === 0
             ? 'ninguno'
             : `opt-outs activos: ${manifest.policy.optOuts.join(', ')}`);
-        const missingEngineSkills = [];
-        for (const command of engine.commands) {
-            if (!(await exists(path.join(ENGINE_SKILLS_DIR, command.skill, 'SKILL.md')))) {
-                missingEngineSkills.push(`${command.id} -> ${command.skill}`);
-            }
-        }
         const audit = await auditSelection(ctx.root, manifest, preset, engine);
         const missingProjectSkills = audit.missing
             .filter((item) => item.startsWith('skill:'))
             .map((item) => item.slice('skill:'.length));
-        add('skills', missingEngineSkills.length === 0 && missingProjectSkills.length === 0, missingEngineSkills.length === 0 && missingProjectSkills.length === 0
-            ? `17 nativas + ${manifest.skills.publish.length} de proyecto (${audit.modes.skills})`
-            : [...missingEngineSkills, ...missingProjectSkills.map((id) => `${id} -> ${manifest.skills.source}`)].join(', '));
+        add('skills', missingProjectSkills.length === 0, missingProjectSkills.length === 0
+            ? `${manifest.skills.publish.length} skills de proyecto + ${engine.commands.length} comandos Spec Kit (${audit.modes.skills})`
+            : missingProjectSkills.map((id) => `${id} -> ${manifest.skills.source}`).join(', '));
         const missingAgents = audit.missing
             .filter((item) => item.startsWith('agent:'))
             .map((item) => item.slice('agent:'.length));
@@ -144,6 +139,12 @@ export async function diagnose(ctx) {
             const present = (await exists(direct)) || (await exists(project));
             add('mcp', present, present ? `MCP configurado (${manifest.mcp.source})` : `MCP: falta ${manifest.mcp.source}`);
         }
+        const speckitChecks = source.isSource
+            ? speckitNotApplicable()
+            : await speckitDoctorChecks(ctx.root, manifest, engine, ctx.exec);
+        for (const check of speckitChecks) {
+            add(check.id, check.ok, check.detail);
+        }
         if (source.isSource) {
             const required = ['dist', 'schema', 'manifest.json', 'engine', 'presets', 'rules', 'agents', 'skills'];
             const missing = required.filter((entry) => !source.files.includes(entry));
@@ -166,6 +167,10 @@ export async function diagnose(ctx) {
             }
             add('hooks', missingHooks.length === 0, missingHooks.length === 0 ? 'superficies presentes' : missingHooks.join(', '));
         }
+        const reserved = await scanReservedNamespace();
+        add('catalog:reserved-namespace', reserved.length === 0, reserved.length === 0
+            ? 'ningún activo del catálogo usa el espacio speckit-*/speckit.* de Spec Kit'
+            : reserved.slice(0, 5).join('; ') + (reserved.length > 5 ? ` (+${reserved.length - 5})` : ''));
         const legacy = await scanLegacyArtifacts(ctx.root);
         add('engine:no-legacy-prefix', legacy.length === 0, legacy.length === 0
             ? source.isSource
@@ -253,6 +258,10 @@ export async function diagnose(ctx) {
     }
     const coupling = await couplingRules();
     if (source.isSource) {
+        const retired = await scanRetiredStates(undefined, ctx.root);
+        add('engine:retired-states', retired.length === 0, retired.length === 0
+            ? 'sin vocabulario de estados retirado (ROOT_CAUSE, FIXED, READY…)'
+            : retired.slice(0, 5).join('; ') + (retired.length > 5 ? ` (+${retired.length - 5})` : ''));
         const findings = await scanCoupling(ctx.root, coupling.terms);
         add('engine:no-coupling', findings.length === 0, findings.length === 0
             ? 'sin términos de dominio en el motor'

package/dist/cli/maintenance.js

@@ -5,9 +5,9 @@ import { createBackup, listBackups, purgeGenerated, restoreBackup } from '../bac
 import { readAiHubRc } from '../paths.js';
 import { loadManifestContext, writeInventory } from '../manifest/manifest.js';
 import { findPresetAsset } from '../presets/resolve.js';
-import { ENGINE_AGENTS, materializeAgent, materializeSkill, readScaffold, SCAFFOLD_RELATIVE, } from '../presets/materialize.js';
+import { ENGINE_AGENTS, materializeAgent, materializeSkill, removeOwned, SCAFFOLD_RELATIVE, } from '../presets/materialize.js';
 import { ENGINE_SKILLS_DIR } from '../engine/engine.js';
-import { catalogSeal, hasFullDimension } from '../catalog.js';
+import { catalogIndex, catalogSeal, hasFullDimension } from '../catalog.js';
 import { readLock } from '../sync/lock.js';
 import { runSync } from '../sync/sync.js';
 import { cliVersion, cmdInstall, writeManifest } from './onboarding.js';
@@ -15,6 +15,10 @@ import { splitItem } from './items.js';
 async function exists(file) {
     return fs.access(file).then(() => true, () => false);
 }
+/** Nombres del espacio de Spec Kit: sus comandos no se añaden ni se desinstalan desde ai-hub. */
+function isSpeckitCommandName(id) {
+    return id.startsWith('speckit-') || id.startsWith('speckit.');
+}
 function markCustom(manifest, dimension) {
     manifest[dimension].selection = 'custom';
     if (hasFullDimension(manifest)) {
@@ -45,7 +49,7 @@ export async function cmdList(args, ctx) {
             rules: manifest.rules.selection ?? 'preset',
         },
         commands: engine.commands.map((command) => ({ id: command.id, lane: command.lane, role: command.role })),
-        nativeSkills: engine.commands.map((command) => command.skill),
+        speckitCommands: engine.commands.map((command) => command.speckit),
         skills: manifest.skills.publish,
         agents: manifest.agents.publish,
         rules: manifest.rules.publish,
@@ -59,7 +63,7 @@ export async function cmdList(args, ctx) {
     ctx.io.out(`targets: ${manifest.targets.join(', ')}`);
     ctx.io.out(`selection: skills=${data.selection.skills} agents=${data.selection.agents} rules=${data.selection.rules}`);
     ctx.io.out(`commands (${data.commands.length}): ${data.commands.map((command) => command.id).join(', ')}`);
-    ctx.io.out(`skills: 17 nativas + ${data.skills.length} de proyecto (${mode})`);
+    ctx.io.out(`skills: ${data.skills.length} de proyecto (${mode}) + ${data.speckitCommands.length} comandos Spec Kit`);
     ctx.io.out(`agents (${data.agents.length}): ${data.agents.join(', ')}`);
     ctx.io.out(`rules: ${data.rules.length + 1} universales (${data.rules.length} materializadas + preflight)`);
     return 0;
@@ -84,11 +88,14 @@ export async function cmdAdd(args, ctx) {
     }
     const { manifest, preset } = context;
     const id = parsed.id;
-    const engineSkill = context.engine.commands.some((command) => command.skill === id);
-    const catalogSkill = await exists(path.join(ENGINE_SKILLS_DIR, id, 'SKILL.md'));
+    if (isSpeckitCommandName(id)) {
+        ctx.io.err(`"${id}" lo provee Spec Kit; ai-hub no añade ni desinstala sus comandos`);
+        return 1;
+    }
+    const catalogSkill = (await catalogIndex()).skills.includes(id);
     const catalogAgent = await exists(path.join(ENGINE_AGENTS, `${id}.md`));
     const kind = parsed.kind ??
-        (preset.skills.includes(id) || engineSkill || catalogSkill
+        (preset.skills.includes(id) || catalogSkill
             ? 'skill'
             : catalogAgent || preset.agents.includes(id)
                 ? 'agent'
@@ -98,13 +105,14 @@ export async function cmdAdd(args, ctx) {
         return 1;
     }
     if (kind === 'skill') {
-        if (engineSkill) {
-            ctx.io.out(`"${id}" ya forma parte de las 17 skills del motor`);
-            return 0;
-        }
         const fromPreset = preset.skills.includes(id)
             ? await findPresetAsset(preset.chain, `skills/${id}`)
             : null;
+        if (fromPreset === null && !catalogSkill) {
+            // Una skill con `runtime: false` sigue en el paquete pero no es instalable.
+            ctx.io.err(`la skill "${id}" no pertenece al catálogo instalable (no existe o declara runtime: false)`);
+            return 1;
+        }
         const source = fromPreset ?? path.join(ENGINE_SKILLS_DIR, id);
         if (!(await exists(path.join(source, 'SKILL.md')))) {
             ctx.io.err(`no existe la skill "${id}" en ${preset.id} ni en el catálogo del motor`);
@@ -164,8 +172,8 @@ export async function cmdUninstall(args, ctx) {
                 : manifest.rules.publish.includes(id) || id === 'skill-quality'
                     ? 'rule'
                     : 'agent');
-    if (kind === 'skill' && context.engine.commands.some((command) => command.skill === id)) {
-        ctx.io.err(`"${id}" es una skill del motor y no se puede desinstalar`);
+    if (isSpeckitCommandName(id)) {
+        ctx.io.err(`"${id}" lo provee Spec Kit; ai-hub no añade ni desinstala sus comandos`);
         return 1;
     }
     if (kind === 'rule' && (id === 'core' || id === 'preflight')) {
@@ -203,32 +211,6 @@ export async function cmdUninstall(args, ctx) {
     ctx.io.out(`uninstall: ${kind} "${id}" · ${sync.removed.length} archivos eliminados`);
     return 0;
 }
-async function removeOwned(root, relative, directory) {
-    const absolute = path.join(root, relative);
-    if (!(await exists(absolute))) {
-        return;
-    }
-    const record = await readScaffold(root);
-    const relativePosix = relative.split(path.sep).join('/');
-    if (directory) {
-        const files = record.files;
-        const prefix = `${relativePosix}/`;
-        const owned = Object.entries(files).filter(([name]) => name.startsWith(prefix));
-        if (owned.length === 0) {
-            const marker = await fs.readFile(path.join(absolute, 'SKILL.md'), 'utf8').catch(() => '');
-            if (!marker.includes('GENERADO por ai-hub')) {
-                return;
-            }
-        }
-        await fs.rm(absolute, { recursive: true, force: true });
-        return;
-    }
-    const text = await fs.readFile(absolute, 'utf8').catch(() => null);
-    const owned = record.files[relativePosix] !== undefined;
-    if (text === null || owned || text.includes('GENERADO por ai-hub')) {
-        await fs.rm(absolute, { force: true });
-    }
-}
 export async function cmdBackups(args, ctx) {
     const snapshots = await listBackups(ctx.root);
     if (args.flags.json) {

package/dist/cli/memory.js

@@ -79,6 +79,10 @@ export async function cmdMemory(args, ctx) {
         ctx.io.out(`cambio activo: ${summary.activeChange ?? 'ninguno'}`);
         ctx.io.out(`fase: ${summary.phase}`);
         ctx.io.out(`tareas: ${summary.tasks.done}/${summary.tasks.total}`);
+        if (summary.feature !== null) {
+            ctx.io.out(`feature Spec Kit: ${summary.feature.dir} · ${summary.feature.pending} pendientes` +
+                (summary.feature.source === 'local' ? ' (puntero local .specify/feature.json, no versionado)' : ''));
+        }
         ctx.io.out(last === null
             ? 'ledger: sin eventos'
             : `último evento: ${last.event} ${last.timestamps.at} ${last.sessionId} (${last.branch ?? '-'})`);

package/dist/cli/onboarding.d.ts

@@ -22,13 +22,26 @@ export interface Plan extends AssetPlan {
     preset: string;
     targets: string[];
     skillCount: number;
+    speckitCommands: number;
     agentCount: number;
     ruleCount: number;
     mcp: boolean;
     migrate: boolean;
     write: string[];
+    speckit: SpeckitPlan;
     hash: string;
 }
+/** Intención de Spec Kit dentro del hash del plan; el entorno (uv, shell) queda fuera. */
+export interface SpeckitPlan {
+    managed: boolean;
+    package: string;
+    version: string;
+    excludeNewer: string;
+    script: string;
+    defaultIntegration: string | null;
+    integrations: string[];
+    extensions: Record<string, string>;
+}
 export declare function writeManifest(root: string, manifest: ProjectManifest): Promise<void>;
 export declare function cmdInit(args: ParsedArgs, ctx: CliContext): Promise<number>;
 export declare function cmdInstall(args: ParsedArgs, ctx: CliContext): Promise<number>;