@christianmaf80/agentic-workflow 1.14.0-beta.7 → 1.17.0-beta.9

package/README.es.md

@@ -11,7 +11,7 @@
 ## ✨ Características Principales
 
 - **Protocolo AHRP (Agentic Handover & Reasoning Protocol)**: Impone un flujo estricto de Triple-Puerta para cada tarea (Activación, Aprobación de Razonamiento y Aceptación de Resultados).
-- **Arquitectura por Referencia**: Mantiene tu proyecto limpio referenciando las reglas y workflows del núcleo desde `node_modules`.
+- **Arquitectura local**: Copia las reglas y workflows del core dentro de `.agent/` para evitar dependencias de acceso continuado a `node_modules`.
 - **Gobernanza de Tolerancia Cero**: Penalizaciones automáticas de rendimiento por violaciones del protocolo.
 - **Independiente y Portátil**: Funciona en cualquier proyecto, siempre que el agente del IDE pueda leer archivos Markdown.
 

package/README.md

@@ -11,7 +11,7 @@
 ## ✨ Key Features
 
 - **AHRP (Agentic Handover & Reasoning Protocol)**: Enforces a strict Triple-Gate flow for every task (Activation, Reasoning Approval, and Results Acceptance).
-- **Architecture by Reference**: Keeps your project clean by referencing core rules and workflows from `node_modules`.
+- **Local Core Snapshot**: Copies core rules and workflows into `.agent/` so runtime no longer depends on `node_modules` access.
 - **Zero-Tolerance Governance**: Automatic performance penalties for protocol violations.
 - **Standalone & Portable**: Works in any project provided the IDE agent can read Markdown files.
 

package/dist/cli/commands/init.js

@@ -36,7 +36,7 @@ export async function initCommand(options = {}) {
         const reinit = nonInteractive
             ? true
             : await confirm({
-                message: 'Do you want to force a re-initialization by reference? (A backup will be created)',
+                message: 'Do you want to force a re-initialization? (A backup will be created)',
             });
         if (!reinit || typeof reinit === 'symbol') {
             outro('Process finished.');
@@ -53,16 +53,17 @@ export async function initCommand(options = {}) {
     await cleanupLegacyMcpConfig(cwd);
     sCleanup.stop('Local environment cleaned.');
     const s = spinner();
-    s.start('Scaffolding .agent (core referenced from node_modules)...');
+    s.start('Scaffolding .agent (core copied locally)...');
     try {
-        // Resolve absolute path to core package in node_modules
+        // Resolve absolute path to core package for local copy
         const corePath = (await resolveInstalledCorePath(cwd)) ?? await resolveCorePath();
         // Replace existing .agent with a clean scaffold
         await fs.rm(agentDir, { recursive: true, force: true });
         await fs.mkdir(agentDir, { recursive: true });
-        await scaffoldAgentWorkspace(corePath, agentDir, cwd);
+        await scaffoldAgentWorkspace(corePath, agentDir);
+        await writeAgentsEntry(cwd);
         s.stop('Configuration complete.');
-        note(`Core located at: ${corePath}\nLocal .agent scaffold created; core stays in node_modules.`, 'Installed');
+        note(`Core copied from: ${corePath}\nLocal .agent created with full core files.`, 'Installed');
         outro('Agentic System initialized successfully.');
     }
     catch (error) {
@@ -85,191 +86,28 @@ async function cleanupLegacyMcpConfig(cwd) {
         // Ignore if missing or not removable.
     }
 }
-function normalizeRelativePath(p) {
-    const posixPath = p.split(path.sep).join('/');
-    return posixPath.length === 0 ? '.' : posixPath;
+async function scaffoldAgentWorkspace(corePath, agentDir) {
+    const entries = ['rules', 'workflows', 'templates', 'artifacts'];
+    await Promise.all(entries.map(async (entry) => {
+        const srcPath = path.join(corePath, entry);
+        const destPath = path.join(agentDir, entry);
+        await fs.cp(srcPath, destPath, { recursive: true });
+    }));
+    await fs.copyFile(path.join(corePath, 'index.md'), path.join(agentDir, 'index.md'));
+    await fs.mkdir(path.join(agentDir, 'artifacts', 'candidate'), { recursive: true });
 }
-async function scaffoldAgentWorkspace(corePath, agentDir, cwd) {
-    const coreRoot = normalizeRelativePath(path.relative(cwd, corePath));
-    const coreIndex = path.posix.join(coreRoot, 'index.md');
-    const coreRulesIndex = path.posix.join(coreRoot, 'rules/index.md');
-    const coreWorkflowsIndex = path.posix.join(coreRoot, 'workflows/index.md');
-    const coreTemplatesIndex = path.posix.join(coreRoot, 'templates/index.md');
-    const coreArtifactsIndex = path.posix.join(coreRoot, 'artifacts/index.md');
-    const rootIndex = `---
-id: agent.index
-owner: architect-agent
-version: 1.0.0
-severity: PERMANENT
-description: Punto de entrada global del sistema .agent (core referenciado desde node_modules).
----
-
-# INDEX — .agent (Root)
-
-## Objetivo
-Este fichero define los dominios principales del sistema \`.agent\` y referencia el core instalado.
-Las extensiones locales viven en \`.agent/*\` y no duplican ficheros del core.
-
-## Patron de indices y alias
-- Primero cargar el Root Index local.
-- Los dominios principales apuntan al core instalado (node_modules).
-- Los \`local_index\` son para extensiones del proyecto.
-
-## Aliases (YAML)
-\`\`\`yaml
-agent:
-  version: 1.0.0
-  core:
-    root: ${coreRoot}
-    index: ${coreIndex}
-
-  domains:
-    workflows:
-      index: ${coreWorkflowsIndex}
-      local_index: .agent/workflows/index.md
-
-    artifacts:
-      index: ${coreArtifactsIndex}
-      local_index: .agent/artifacts/index.md
-
-    templates:
-      index: ${coreTemplatesIndex}
-      local_index: .agent/templates/index.md
-
-    rules:
-      index: ${coreRulesIndex}
-      local_index: .agent/rules/index.md
-\`\`\`
+async function writeAgentsEntry(cwd) {
+    const agentsPath = path.join(cwd, 'AGENTS.md');
+    const content = `# AGENTS
+
+Este fichero es el punto de entrada para asistentes del IDE.
+Solo define el arranque del sistema mediante el workflow \`init\`.
+
+## Arranque (OBLIGATORIO)
+1. Leer \`.agent/index.md\` (root index local).
+2. Cargar el indice de workflows en \`agent.domains.workflows.index\`.
+3. Cargar \`workflows.init\`.
+4. Ejecutar el workflow \`init\` y seguir sus Gates.
 `;
-    const rulesIndex = `---
-id: rules.local.index
-owner: architect-agent
-version: 1.0.0
-severity: RECOMMENDED
----
-
-# INDEX — Rules (Local)
-
-## Objetivo
-Indice local para reglas personalizadas del proyecto. No duplicar reglas del core.
-
-## Aliases (YAML)
-\`\`\`yaml
-rules:
-  local:
-    constitution:
-      index: .agent/rules/constitution/index.md
-    roles:
-      index: .agent/rules/roles/index.md
-\`\`\`
-`;
-    const rulesConstitutionIndex = `---
-id: rules.constitution.local.index
-owner: architect-agent
-version: 1.0.0
-severity: RECOMMENDED
----
-
-# INDEX — Rules / Constitution (Local)
-
-## Objetivo
-Indice local de constituciones del proyecto. No duplicar reglas del core.
-
-## Aliases (YAML)
-\`\`\`yaml
-constitution: {}
-\`\`\`
-`;
-    const rulesRolesIndex = `---
-id: rules.roles.local.index
-owner: architect-agent
-version: 1.0.0
-severity: RECOMMENDED
----
-
-# INDEX — Rules / Roles (Local)
-
-## Objetivo
-Indice local de roles del proyecto. No duplicar roles del core.
-
-## Aliases (YAML)
-\`\`\`yaml
-roles: {}
-\`\`\`
-`;
-    const workflowsIndex = `---
-id: workflows.local.index
-owner: architect-agent
-version: 1.0.0
-severity: RECOMMENDED
----
-
-# INDEX — Workflows (Local)
-
-## Objetivo
-Indice local de workflows del proyecto. No duplicar workflows del core.
-
-## Aliases (YAML)
-\`\`\`yaml
-workflows: {}
-\`\`\`
-`;
-    const templatesIndex = `---
-id: templates.local.index
-owner: architect-agent
-version: 1.0.0
-severity: RECOMMENDED
----
-
-# INDEX — Templates (Local)
-
-## Objetivo
-Indice local de templates del proyecto. No duplicar templates del core.
-
-## Aliases (YAML)
-\`\`\`yaml
-templates: {}
-\`\`\`
-`;
-    const artifactsIndex = `---
-id: artifacts.local.index
-owner: architect-agent
-version: 1.0.0
-severity: RECOMMENDED
----
-
-# INDEX — Artifacts (Local)
-
-## Objetivo
-Indice local de artifacts generados por el proyecto.
-
-## Aliases (YAML)
-\`\`\`yaml
-artifacts:
-  local:
-    dir: .agent/artifacts
-    candidate: .agent/artifacts/candidate
-\`\`\`
-`;
-    const dirs = [
-        'rules',
-        'rules/constitution',
-        'rules/roles',
-        'workflows',
-        'templates',
-        'artifacts',
-        'artifacts/candidate',
-    ];
-    for (const dir of dirs) {
-        await fs.mkdir(path.join(agentDir, dir), { recursive: true });
-    }
-    await Promise.all([
-        fs.writeFile(path.join(agentDir, 'index.md'), rootIndex),
-        fs.writeFile(path.join(agentDir, 'rules', 'index.md'), rulesIndex),
-        fs.writeFile(path.join(agentDir, 'rules', 'constitution', 'index.md'), rulesConstitutionIndex),
-        fs.writeFile(path.join(agentDir, 'rules', 'roles', 'index.md'), rulesRolesIndex),
-        fs.writeFile(path.join(agentDir, 'workflows', 'index.md'), workflowsIndex),
-        fs.writeFile(path.join(agentDir, 'templates', 'index.md'), templatesIndex),
-        fs.writeFile(path.join(agentDir, 'artifacts', 'index.md'), artifactsIndex),
-    ]);
+    await fs.writeFile(agentsPath, content);
 }

package/dist/core/context/manager.js

@@ -22,11 +22,15 @@ export class ContextManager {
         // Esta es una implementación simplificada que busca en los índices conocidos
         // Para una implementación completa, se requeriría un crawler de YAML
         if (aliasPath.includes('constitution')) {
-            const constitutions = ['GEMINI.location.md', 'project-architecture.md', 'clean-code.md', 'agent-system.md'];
+            const constitutions = [
+                { file: 'GEMINI.location.md', alias: 'constitution.GEMINI_location' },
+                { file: 'clean-code.md', alias: 'constitution.clean_code' },
+                { file: 'agents-behavior.md', alias: 'constitution.agents_behavior' },
+            ];
             for (const c of constitutions) {
-                const p = path.join(this.corePath, 'rules/constitution', c);
+                const p = path.join(this.corePath, 'rules/constitution', c.file);
                 if (await this.exists(p)) {
-                    files.push(await this.readFile(p, `constitution.${c.replace('.md', '')}`));
+                    files.push(await this.readFile(p, c.alias));
                 }
             }
         }
@@ -76,8 +80,8 @@ export class ContextManager {
         if (isBootstrap) {
             bundle += "## SIGUIENTES PASOS (DISCOVERY)\n";
             bundle += "El sistema está inicializado. Puedes profundizar en dominios específicos usando:\n";
-            bundle += "- `tool: hydrate_context({ alias: \"agent.core.rules\" })` para cargar todas las reglas.\n";
-            bundle += "- `tool: hydrate_context({ alias: \"agent.core.workflows\" })` para ver procesos disponibles.\n";
+            bundle += "- `tool: hydrate_context({ alias: \"agent.domains.rules.index\" })` para cargar reglas disponibles.\n";
+            bundle += "- `tool: hydrate_context({ alias: \"agent.domains.workflows.index\" })` para ver workflows disponibles.\n";
         }
         return bundle;
     }

package/dist/workflows/init.md

@@ -47,6 +47,7 @@ El agente **DEBE** adherirse a estas meta-reglas de comportamiento durante TODA
 ## Pasos obligatorios
 1. Activar `architect-agent` como rol arquitecto.
    - Mostrar un mensaje único de estado (ej: "Cargando init...") y **no** listar lecturas de ficheros individuales.
+   - En ese mismo mensaje, presentar al architect-agent y dar contexto al desarrollador: rol, objetivo del init y qué información se le pedirá a continuación.
 
 2. Cargar índices mínimos (OBLIGATORIO):
    - Antes de continuar, revisar `.agent/index.md` para comprender dominios, indices y alias.
@@ -99,8 +100,8 @@ El agente **DEBE** adherirse a estas meta-reglas de comportamiento durante TODA
     - Preguntar por la tarea:
       - "¿Qué tarea quieres iniciar ahora? Dame un título corto y el objetivo."
     - Una vez recibidos título y objetivo:
-      - Si `strategy == "long"` → lanzar `workflow.tasklifecycle-long`
-      - Si `strategy == "short"` → lanzar `workflow.tasklifecycle-short`
+      - Si `strategy == "long"` → lanzar `workflows.tasklifecycle-long`
+      - Si `strategy == "short"` → lanzar `workflows.tasklifecycle-short`
 
 ## Output (REQUIRED)
 - Artefacto creado:

package/dist/workflows/tasklifecycle-long/phase-0-acceptance-criteria.md

@@ -1,5 +1,5 @@
 ---
-id: workflow.tasklifecycle.phase-0-acceptance-criteria
+id: workflow.tasklifecycle-long.phase-0-acceptance-criteria
 description: Convierte el task candidate en una tarea definitiva. El arquitecto define los acceptance criteria mediante 5 preguntas obligatorias basadas en la tarea y su objetivo, y crea el current task necesario para iniciar el ciclo de vida.
 owner: architect-agent
 version: 1.2.1
@@ -12,7 +12,7 @@ blocking: true
 # WORKFLOW: tasklifecycle.phase-0-acceptance-criteria
 
 ## Input (REQUIRED)
-- Task candidate creado por `workflow.tasklifecycle-long`:
+- Task candidate creado por `workflows.tasklifecycle-long`:
   - `artifacts.candidate.task`
 - El `task.md` candidate **DEBE** incluir:
   - descripción de la tarea

package/dist/workflows/tasklifecycle-long/phase-1-research.md

@@ -1,5 +1,5 @@
 ---
-id: workflow.tasklifecycle.phase-1-research
+id: workflow.tasklifecycle-long.phase-1-research
 description: Fase 1 del ciclo de tarea. Investigacion tecnica exhaustiva de necesidades y alternativas. Requiere aprobacion explicita del desarrollador.
 owner: researcher-agent
 version: 1.0.0

package/dist/workflows/tasklifecycle-long/phase-2-analysis.md

@@ -1,5 +1,5 @@
 ---
-id: workflow.tasklifecycle.phase-2-analysis
+id: workflow.tasklifecycle-long.phase-2-analysis
 description: Fase 2 del ciclo de tarea. Analisis profundo basado en la investigacion previa, cubre acceptance criteria y define agentes, responsabilidades e impacto. Requiere aprobacion del desarrollador.
 owner: architect-agent
 version: 1.0.0

package/dist/workflows/tasklifecycle-long/phase-3-planning.md

@@ -1,5 +1,5 @@
 ---
-id: workflow.tasklifecycle.phase-3-planning
+id: workflow.tasklifecycle-long.phase-3-planning
 description: Fase 3 del ciclo de tarea. Define el plan de implementación basado en el análisis previo, asigna responsabilidades por agente, detalla testing, demo, estimaciones y puntos críticos. Requiere aprobación explícita del desarrollador.
 owner: architect-agent
 version: 1.0.0

package/dist/workflows/tasklifecycle-long/phase-4-implementation.md

@@ -1,5 +1,5 @@
 ---
-id: workflow.tasklifecycle.phase-4-implementation
+id: workflow.tasklifecycle-long.phase-4-implementation
 description: Fase 4 del ciclo de tarea. Ejecuta la implementación mediante delegación granular de tareas a agentes con Gate de aprobación del desarrollador por cada tarea. Solo avanza si todas las tareas han sido aprobadas.
 owner: architect-agent
 version: 3.0.0

package/dist/workflows/tasklifecycle-long/phase-5-verification.md

@@ -1,5 +1,5 @@
 ---
-id: workflow.tasklifecycle.phase-5-verification
+id: workflow.tasklifecycle-long.phase-5-verification
 description: Fase 5 del ciclo de tarea. Verifica la implementación con tests (unitarios y E2E si aplica) y reporta métricas y cobertura. NO corrige código; si hay errores, delega una nueva tarea de corrección al agente responsable.
 owner: architect-agent
 version: 1.0.0

package/dist/workflows/tasklifecycle-long/phase-6-results-acceptance.md

@@ -1,5 +1,5 @@
 ---
-id: workflow.tasklifecycle.phase-6-results-acceptance
+id: workflow.tasklifecycle-long.phase-6-results-acceptance
 description: Fase 6 del ciclo de tarea. Presenta el informe final de resultados y requiere aceptación explícita del desarrollador (SI/NO).
 owner: architect-agent
 version: 1.0.0

package/dist/workflows/tasklifecycle-long/phase-7-evaluation.md

@@ -1,5 +1,5 @@
 ---
-id: workflow.tasklifecycle.phase-7-evaluation
+id: workflow.tasklifecycle-long.phase-7-evaluation
 description: Fase 7 del ciclo de tarea. Evalua la participacion de los agentes y la ejecucion de la tarea con puntuaciones objetivas.
 owner: architect-agent
 version: 1.0.0

package/dist/workflows/tasklifecycle-long/phase-8-commit-push.md

@@ -1,5 +1,5 @@
 ---
-id: workflow.tasklifecycle.phase-8-commit-push
+id: workflow.tasklifecycle-long.phase-8-commit-push
 description: Fase 8 del ciclo de tarea. Consolida y publica los cambios en la rama destino mediante commits normalizados (Conventional Commits), genera changelog y requiere aprobación explícita del desarrollador antes del push final.
 owner: architect-agent
 version: 1.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@christianmaf80/agentic-workflow",
-    "version": "1.14.0-beta.7",
+    "version": "1.17.0-beta.9",
     "description": "Portable agentic workflow orchestration system with strict identity and gate discipline",
     "type": "module",
     "main": "dist/index.js",
@@ -40,6 +40,7 @@
     "author": "Christian Marino Alvarez",
     "license": "ISC",
     "dependencies": {
+        "@christianmaf80/agentic-workflow": "^1.14.0-beta.7",
         "@clack/prompts": "^0.7.0",
         "@modelcontextprotocol/sdk": "^1.25.2",
         "commander": "^11.1.0",