@jaimevalasek/aioson 1.3.0 → 1.4.0

package/src/commands/workflow-next.js

@@ -7,6 +7,7 @@ const { resolveAgentLocale } = require('../locales');
 const { validateProjectContextFile } = require('../context');
 const { exists, ensureDir } = require('../utils');
 const { syncWorkflowRuntime } = require('../execution-gateway');
+const { writeHandoff, buildWorkflowHandoff } = require('../session-handoff');
 
 const STATE_RELATIVE_PATH = '.aioson/context/workflow.state.json';
 const CONFIG_RELATIVE_PATH = '.aioson/context/workflow.config.json';
@@ -439,7 +440,7 @@ async function activateStage(targetDir, state, locale, tool, explicitAgent = nul
   }
 
   const instructionPath = await resolveExistingInstructionPath(targetDir, agent, locale);
-  const prompt = buildAgentPrompt(agent, tool, { instructionPath });
+  const prompt = buildAgentPrompt(agent, tool, { instructionPath, targetDir });
 
   let nextState = state;
   if (explicitAgent && stageName !== normalizeAgentName(state.next)) {
@@ -527,6 +528,12 @@ async function runWorkflowNext({ args, options, logger, t }) {
     completedStage
   });
 
+  // Generate session handoff when a stage completes or workflow finishes
+  if (completedStage || !activation.agent) {
+    const handoffData = buildWorkflowHandoff(state, completedStage, activation.agent);
+    await writeHandoff(targetDir, handoffData);
+  }
+
   const payload = {
     ok: true,
     targetDir,

package/src/commands/workflow-status.js

@@ -0,0 +1,250 @@
+'use strict';
+
+const fs = require('node:fs/promises');
+const path = require('node:path');
+const { exists } = require('../utils');
+const { validateProjectContextFile } = require('../context');
+const { readHandoff } = require('../session-handoff');
+const { runtimeStoreExists, openRuntimeDb, listPipelines } = require('../runtime-store');
+
+const STATE_RELATIVE_PATH = '.aioson/context/workflow.state.json';
+
+const ARTIFACT_MAP = {
+  setup: { file: '.aioson/context/project.context.md', label: 'project.context.md' },
+  product: { file: '.aioson/context/prd.md', label: 'prd.md' },
+  analyst: { file: '.aioson/context/discovery.md', label: 'discovery.md' },
+  architect: { file: '.aioson/context/architecture.md', label: 'architecture.md' },
+  'ux-ui': { file: '.aioson/context/ui-spec.md', label: 'ui-spec.md' }
+};
+
+async function scanSquads(targetDir) {
+  const squadsDir = path.join(targetDir, '.aioson/squads');
+  if (!(await exists(squadsDir))) return [];
+
+  try {
+    const entries = await fs.readdir(squadsDir, { withFileTypes: true });
+    const squads = [];
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      const manifestPath = path.join(squadsDir, entry.name, 'squad.manifest.json');
+      const agentsDir = path.join(squadsDir, entry.name, 'agents');
+      let agentCount = 0;
+      try {
+        const agents = await fs.readdir(agentsDir);
+        agentCount = agents.filter(f => f.endsWith('.md')).length;
+      } catch { /* no agents dir */ }
+
+      let status = 'active';
+      try {
+        const raw = await fs.readFile(manifestPath, 'utf8');
+        const manifest = JSON.parse(raw);
+        status = manifest.status || 'active';
+      } catch { /* no manifest */ }
+
+      squads.push({ slug: entry.name, agentCount, status });
+    }
+    return squads;
+  } catch {
+    return [];
+  }
+}
+
+async function scanGenomes(targetDir) {
+  const genomesDir = path.join(targetDir, '.aioson/genomes');
+  if (!(await exists(genomesDir))) return 0;
+  try {
+    const entries = await fs.readdir(genomesDir);
+    return entries.filter(f => f.endsWith('.md') || f.endsWith('.json')).length;
+  } catch {
+    return 0;
+  }
+}
+
+async function getPipelineCount(targetDir) {
+  const hasDb = await runtimeStoreExists(targetDir);
+  if (!hasDb) return { total: 0, active: 0 };
+  const handle = await openRuntimeDb(targetDir, { mustExist: true });
+  if (!handle) return { total: 0, active: 0 };
+  try {
+    const pipelines = listPipelines(handle.db);
+    const active = pipelines.filter(p => p.status === 'active').length;
+    return { total: pipelines.length, active };
+  } finally {
+    handle.db.close();
+  }
+}
+
+async function runWorkflowStatus({ args, options, logger, t }) {
+  const targetDir = path.resolve(process.cwd(), args[0] || '.');
+
+  // Read workflow state
+  const statePath = path.join(targetDir, STATE_RELATIVE_PATH);
+  let state = null;
+  try {
+    const raw = await fs.readFile(statePath, 'utf8');
+    state = JSON.parse(raw);
+  } catch {
+    // no state file
+  }
+
+  // Read project context
+  const context = await validateProjectContextFile(targetDir);
+  const projectName = (context.data && context.data.project_name) || path.basename(targetDir);
+  const classification = (state && state.classification)
+    || (context.data && context.data.classification)
+    || 'unknown';
+
+  // Read last handoff
+  const handoff = await readHandoff(targetDir);
+
+  // Check artifacts
+  const artifacts = {};
+  for (const [stage, info] of Object.entries(ARTIFACT_MAP)) {
+    const featureSlug = state && state.featureSlug;
+    let filePath = path.join(targetDir, info.file);
+
+    // Feature-scoped artifacts
+    if (featureSlug && stage === 'product') {
+      const featurePath = path.join(targetDir, `.aioson/context/prd-${featureSlug}.md`);
+      if (await exists(featurePath)) {
+        artifacts[stage] = { exists: true, label: `prd-${featureSlug}.md` };
+        continue;
+      }
+    }
+    if (featureSlug && stage === 'analyst') {
+      const reqPath = path.join(targetDir, `.aioson/context/requirements-${featureSlug}.md`);
+      if (await exists(reqPath)) {
+        artifacts[stage] = { exists: true, label: `requirements-${featureSlug}.md` };
+        continue;
+      }
+    }
+
+    artifacts[stage] = { exists: await exists(filePath), label: info.label };
+  }
+
+  // Scan squads, genomes, pipelines
+  const squads = await scanSquads(targetDir);
+  const genomeCount = await scanGenomes(targetDir);
+  const pipelines = await getPipelineCount(targetDir);
+
+  // Build status output
+  const mode = (state && state.mode) || 'project';
+  const featureSlug = (state && state.featureSlug) || null;
+
+  logger.log('');
+  logger.log(`Project: ${projectName} (${classification})`);
+  logger.log(`Mode: ${mode}${featureSlug ? ` — feature: ${featureSlug}` : ''}`);
+  logger.log('');
+
+  // Workflow sequence
+  if (state && state.sequence) {
+    const completed = new Set(state.completed || []);
+    const skipped = new Set(state.skipped || []);
+    const current = state.current || state.next;
+
+    logger.log('Workflow:');
+    for (const stage of state.sequence) {
+      let marker;
+      if (completed.has(stage)) marker = 'done';
+      else if (skipped.has(stage)) marker = 'skip';
+      else if (stage === current) marker = 'now';
+      else marker = '    ';
+
+      const icon = marker === 'done' ? '[v]'
+        : marker === 'skip' ? '[-]'
+        : marker === 'now' ? '[>]'
+        : '[ ]';
+      logger.log(`  ${icon} @${stage}`);
+    }
+
+    if (state.detour && state.detour.active) {
+      logger.log(`  Detour: @${state.detour.agent} (returns to @${state.detour.returnTo})`);
+    }
+    logger.log('');
+  }
+
+  // Artifacts
+  logger.log('Artifacts:');
+  for (const [stage, info] of Object.entries(artifacts)) {
+    const icon = info.exists ? '[v]' : '[ ]';
+    logger.log(`  ${icon} ${info.label}`);
+  }
+  logger.log('');
+
+  // Squads
+  if (squads.length > 0) {
+    logger.log(`Squads (${squads.length}):`);
+    for (const s of squads) {
+      logger.log(`  ${s.slug} — ${s.agentCount} agents [${s.status}]`);
+    }
+    logger.log('');
+  }
+
+  // Genomes
+  if (genomeCount > 0) {
+    logger.log(`Genomes: ${genomeCount}`);
+    logger.log('');
+  }
+
+  // Pipelines
+  if (pipelines.total > 0) {
+    logger.log(`Pipelines: ${pipelines.total} (${pipelines.active} active)`);
+    logger.log('');
+  }
+
+  // Last handoff
+  if (handoff) {
+    logger.log('Last handoff:');
+    if (handoff.last_agent) logger.log(`  Agent: ${handoff.last_agent}`);
+    if (handoff.what_was_done) logger.log(`  Done: ${handoff.what_was_done}`);
+    if (handoff.what_comes_next) logger.log(`  Next: ${handoff.what_comes_next}`);
+    if (handoff.session_ended_at) {
+      const elapsed = timeSince(handoff.session_ended_at);
+      logger.log(`  When: ${elapsed} ago`);
+    }
+    logger.log('');
+  }
+
+  // Suggestion
+  if (state && state.sequence) {
+    const current = state.current || state.next;
+    if (current) {
+      logger.log(`Suggestion: activate @${current}`);
+      logger.log(`  aioson workflow:next . --tool=claude`);
+    } else {
+      logger.log('Workflow is complete.');
+    }
+  } else if (!context.valid) {
+    logger.log('Suggestion: run @setup to initialize the project');
+    logger.log('  aioson workflow:next . --tool=claude');
+  }
+
+  return {
+    ok: true,
+    projectName,
+    classification,
+    mode,
+    featureSlug,
+    state,
+    artifacts,
+    squads,
+    genomeCount,
+    pipelines,
+    handoff
+  };
+}
+
+function timeSince(isoString) {
+  const now = Date.now();
+  const then = new Date(isoString).getTime();
+  const diffMs = now - then;
+  const minutes = Math.floor(diffMs / 60000);
+  if (minutes < 1) return 'just now';
+  if (minutes < 60) return `${minutes}m`;
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24) return `${hours}h`;
+  const days = Math.floor(hours / 24);
+  return `${days}d`;
+}
+
+module.exports = { runWorkflowStatus };

package/src/constants.js

@@ -10,6 +10,9 @@ const MANAGED_FILES = [
   '.gemini/commands/aios-analyst.toml',
   '.gemini/commands/aios-architect.toml',
   '.gemini/commands/aios-ux-ui.toml',
+  '.gemini/commands/aios-product.toml',
+  '.gemini/commands/aios-deyvin.toml',
+  '.gemini/commands/aios-pair.toml',
   '.gemini/commands/aios-pm.toml',
   '.gemini/commands/aios-dev.toml',
   '.gemini/commands/aios-qa.toml',
@@ -21,12 +24,15 @@ const MANAGED_FILES = [
   '.aioson/agents/architect.md',
   '.aioson/agents/ux-ui.md',
   '.aioson/agents/product.md',
+  '.aioson/agents/deyvin.md',
+  '.aioson/agents/pair.md',
   '.aioson/agents/pm.md',
   '.aioson/agents/dev.md',
   '.aioson/agents/qa.md',
   '.aioson/agents/orchestrator.md',
   '.aioson/agents/squad.md',
-  '.aioson/agents/genoma.md',
+  '.aioson/agents/orache.md',
+  '.aioson/agents/genome.md',
   '.aioson/agents/profiler-researcher.md',
   '.aioson/agents/profiler-enricher.md',
   '.aioson/agents/profiler-forge.md',
@@ -36,12 +42,15 @@ const MANAGED_FILES = [
   '.aioson/locales/en/agents/architect.md',
   '.aioson/locales/en/agents/ux-ui.md',
   '.aioson/locales/en/agents/product.md',
+  '.aioson/locales/en/agents/deyvin.md',
+  '.aioson/locales/en/agents/pair.md',
   '.aioson/locales/en/agents/pm.md',
   '.aioson/locales/en/agents/dev.md',
   '.aioson/locales/en/agents/qa.md',
   '.aioson/locales/en/agents/orchestrator.md',
   '.aioson/locales/en/agents/squad.md',
-  '.aioson/locales/en/agents/genoma.md',
+  '.aioson/locales/en/agents/orache.md',
+  '.aioson/locales/en/agents/genome.md',
   '.aioson/locales/en/agents/profiler-researcher.md',
   '.aioson/locales/en/agents/profiler-enricher.md',
   '.aioson/locales/en/agents/profiler-forge.md',
@@ -51,12 +60,15 @@ const MANAGED_FILES = [
   '.aioson/locales/pt-BR/agents/architect.md',
   '.aioson/locales/pt-BR/agents/ux-ui.md',
   '.aioson/locales/pt-BR/agents/product.md',
+  '.aioson/locales/pt-BR/agents/deyvin.md',
+  '.aioson/locales/pt-BR/agents/pair.md',
   '.aioson/locales/pt-BR/agents/pm.md',
   '.aioson/locales/pt-BR/agents/dev.md',
   '.aioson/locales/pt-BR/agents/qa.md',
   '.aioson/locales/pt-BR/agents/orchestrator.md',
   '.aioson/locales/pt-BR/agents/squad.md',
-  '.aioson/locales/pt-BR/agents/genoma.md',
+  '.aioson/locales/pt-BR/agents/orache.md',
+  '.aioson/locales/pt-BR/agents/genome.md',
   '.aioson/locales/pt-BR/agents/profiler-researcher.md',
   '.aioson/locales/pt-BR/agents/profiler-enricher.md',
   '.aioson/locales/pt-BR/agents/profiler-forge.md',
@@ -66,12 +78,15 @@ const MANAGED_FILES = [
   '.aioson/locales/es/agents/architect.md',
   '.aioson/locales/es/agents/ux-ui.md',
   '.aioson/locales/es/agents/product.md',
+  '.aioson/locales/es/agents/deyvin.md',
+  '.aioson/locales/es/agents/pair.md',
   '.aioson/locales/es/agents/pm.md',
   '.aioson/locales/es/agents/dev.md',
   '.aioson/locales/es/agents/qa.md',
   '.aioson/locales/es/agents/orchestrator.md',
   '.aioson/locales/es/agents/squad.md',
-  '.aioson/locales/es/agents/genoma.md',
+  '.aioson/locales/es/agents/orache.md',
+  '.aioson/locales/es/agents/genome.md',
   '.aioson/locales/es/agents/profiler-researcher.md',
   '.aioson/locales/es/agents/profiler-enricher.md',
   '.aioson/locales/es/agents/profiler-forge.md',
@@ -81,12 +96,15 @@ const MANAGED_FILES = [
   '.aioson/locales/fr/agents/architect.md',
   '.aioson/locales/fr/agents/ux-ui.md',
   '.aioson/locales/fr/agents/product.md',
+  '.aioson/locales/fr/agents/deyvin.md',
+  '.aioson/locales/fr/agents/pair.md',
   '.aioson/locales/fr/agents/pm.md',
   '.aioson/locales/fr/agents/dev.md',
   '.aioson/locales/fr/agents/qa.md',
   '.aioson/locales/fr/agents/orchestrator.md',
   '.aioson/locales/fr/agents/squad.md',
-  '.aioson/locales/fr/agents/genoma.md',
+  '.aioson/locales/fr/agents/orache.md',
+  '.aioson/locales/fr/agents/genome.md',
   '.aioson/locales/fr/agents/profiler-researcher.md',
   '.aioson/locales/fr/agents/profiler-enricher.md',
   '.aioson/locales/fr/agents/profiler-forge.md',
@@ -103,11 +121,24 @@ const MANAGED_FILES = [
   '.aioson/skills/static/web3-cardano-patterns.md',
   '.aioson/skills/static/web3-security-checklist.md',
   '.aioson/skills/static/git-conventions.md',
-  '.aioson/skills/static/premium-command-center-ui.md',
-  '.aioson/skills/references/premium-command-center-ui/visual-system-and-component-patterns.md',
-  '.aioson/skills/references/premium-command-center-ui/operational-ux-playbook.md',
-  '.aioson/skills/references/premium-command-center-ui/master-application-prompt.md',
-  '.aioson/skills/references/premium-command-center-ui/quality-validation-checklist.md',
+  '.aioson/skills/design/cognitive-core-ui/SKILL.md',
+  '.aioson/skills/design/cognitive-core-ui/references/design-tokens.md',
+  '.aioson/skills/design/cognitive-core-ui/references/components.md',
+  '.aioson/skills/design/cognitive-core-ui/references/patterns.md',
+  '.aioson/skills/design/cognitive-core-ui/references/motion.md',
+  '.aioson/skills/design/cognitive-core-ui/references/dashboards.md',
+  '.aioson/skills/design/cognitive-core-ui/references/websites.md',
+  '.aioson/skills/design/premium-command-center-ui/SKILL.md',
+  '.aioson/skills/design/premium-command-center-ui/references/visual-system.md',
+  '.aioson/skills/design/premium-command-center-ui/references/patterns.md',
+  '.aioson/skills/design/premium-command-center-ui/references/operations.md',
+  '.aioson/skills/design/premium-command-center-ui/references/validation.md',
+  '.aioson/skills/design/interface-design/SKILL.md',
+  '.aioson/skills/design/interface-design/references/intent-and-domain.md',
+  '.aioson/skills/design/interface-design/references/design-directions.md',
+  '.aioson/skills/design/interface-design/references/tokens-and-depth.md',
+  '.aioson/skills/design/interface-design/references/components-and-states.md',
+  '.aioson/skills/design/interface-design/references/handoff-and-quality.md',
   '.aioson/skills/dynamic/laravel-docs.md',
   '.aioson/skills/dynamic/flux-ui-docs.md',
   '.aioson/skills/dynamic/npm-packages.md',
@@ -131,6 +162,7 @@ const MANAGED_FILES = [
   '.aioson/tasks/squad-export.md',
   '.aioson/tasks/squad-repair.md',
   '.aioson/tasks/squad-pipeline.md',
+  '.aioson/tasks/squad-learning-review.md',
   '.aioson/profiler-reports/.gitkeep',
   '.aioson/advisors/.gitkeep'
 ];
@@ -176,6 +208,7 @@ const CONTEXT_ALLOWED_PROFILES = ['developer', 'beginner', 'team'];
 const AGENT_DEFINITIONS = [
   {
     id: 'setup',
+    displayName: 'Setup',
     command: '@setup',
     path: '.aioson/agents/setup.md',
     dependsOn: [],
@@ -183,6 +216,7 @@ const AGENT_DEFINITIONS = [
   },
   {
     id: 'discovery-design-doc',
+    displayName: 'Discovery/Design Doc',
     command: '@discovery-design-doc',
     path: '.aioson/agents/discovery-design-doc.md',
     dependsOn: ['.aioson/context/project.context.md'],
@@ -190,13 +224,24 @@ const AGENT_DEFINITIONS = [
   },
   {
     id: 'product',
+    displayName: 'Product',
     command: '@product',
     path: '.aioson/agents/product.md',
     dependsOn: ['.aioson/context/project.context.md'],
     output: '.aioson/context/prd.md or .aioson/context/prd-{slug}.md (PRD base)'
   },
+  {
+    id: 'deyvin',
+    displayName: 'Deyvin',
+    command: '@deyvin',
+    path: '.aioson/agents/deyvin.md',
+    aliases: ['pair'],
+    dependsOn: ['.aioson/context/project.context.md'],
+    output: 'small code changes + continuity notes in spec.md + runtime logs/tasks'
+  },
   {
     id: 'analyst',
+    displayName: 'Analyst',
     command: '@analyst',
     path: '.aioson/agents/analyst.md',
     dependsOn: ['.aioson/context/project.context.md'],
@@ -204,6 +249,7 @@ const AGENT_DEFINITIONS = [
   },
   {
     id: 'architect',
+    displayName: 'Architect',
     command: '@architect',
     path: '.aioson/agents/architect.md',
     dependsOn: [
@@ -214,6 +260,7 @@ const AGENT_DEFINITIONS = [
   },
   {
     id: 'ux-ui',
+    displayName: 'UI/UX',
     command: '@ux-ui',
     path: '.aioson/agents/ux-ui.md',
     dependsOn: [
@@ -226,6 +273,7 @@ const AGENT_DEFINITIONS = [
   },
   {
     id: 'pm',
+    displayName: 'PM',
     command: '@pm',
     path: '.aioson/agents/pm.md',
     dependsOn: [
@@ -238,6 +286,7 @@ const AGENT_DEFINITIONS = [
   },
   {
     id: 'dev',
+    displayName: 'Dev',
     command: '@dev',
     path: '.aioson/agents/dev.md',
     dependsOn: [
@@ -249,6 +298,7 @@ const AGENT_DEFINITIONS = [
   },
   {
     id: 'qa',
+    displayName: 'QA',
     command: '@qa',
     path: '.aioson/agents/qa.md',
     dependsOn: ['.aioson/context/discovery.md'],
@@ -256,6 +306,7 @@ const AGENT_DEFINITIONS = [
   },
   {
     id: 'orchestrator',
+    displayName: 'Orchestrator',
     command: '@orchestrator',
     path: '.aioson/agents/orchestrator.md',
     dependsOn: [
@@ -267,21 +318,32 @@ const AGENT_DEFINITIONS = [
   },
   {
     id: 'squad',
+    displayName: 'Squad',
     command: '@squad',
     path: '.aioson/agents/squad.md',
     dependsOn: [],
     output:
-      '.aioson/squads/{slug}/squad.manifest.json + .aioson/squads/{slug}/squad.md + .aioson/squads/{slug}/agents/ + .aioson/squads/{slug}/skills/ + .aioson/squads/{slug}/templates/ + .aioson/squads/{slug}/docs/ + output/{slug}/{session-id}.html + output/{slug}/{content-key}/content.json + output/{slug}/{content-key}/index.html + output/{slug}/latest.html + aios-logs/{slug}/ + media/{slug}/'
+      '.aioson/squads/{slug}/squad.manifest.json + .aioson/squads/{slug}/squad.md + .aioson/squads/{slug}/agents/ + .aioson/squads/{slug}/workers/ + .aioson/squads/{slug}/workflows/ + .aioson/squads/{slug}/checklists/ + .aioson/squads/{slug}/skills/ + .aioson/squads/{slug}/templates/ + .aioson/squads/{slug}/docs/ + output/{slug}/{session-id}.html + output/{slug}/{content-key}/content.json + output/{slug}/{content-key}/index.html + output/{slug}/latest.html + aioson-logs/{slug}/ + media/{slug}/'
+  },
+  {
+    id: 'orache',
+    displayName: 'Orache',
+    command: '@orache',
+    path: '.aioson/agents/orache.md',
+    dependsOn: [],
+    output: 'squad-searches/{squad-slug}/investigation-{date}.md or squad-searches/standalone/{domain-slug}-{date}.md'
   },
   {
-    id: 'genoma',
-    command: '@genoma',
-    path: '.aioson/agents/genoma.md',
+    id: 'genome',
+    displayName: 'Genome',
+    command: '@genome',
+    path: '.aioson/agents/genome.md',
     dependsOn: [],
-    output: '.aioson/genomas/[slug].md + .aioson/genomas/[slug].meta.json + optional binding in .aioson/squads/{slug}/squad.md or .aioson/squads/{slug}/squad.manifest.json'
+    output: '.aioson/genomes/[slug].md + .aioson/genomes/[slug].meta.json + optional binding in .aioson/squads/{slug}/squad.md or .aioson/squads/{slug}/squad.manifest.json'
   },
   {
     id: 'profiler-researcher',
+    displayName: 'Profiler Researcher',
     command: '@profiler-researcher',
     path: '.aioson/agents/profiler-researcher.md',
     dependsOn: [],
@@ -289,6 +351,7 @@ const AGENT_DEFINITIONS = [
   },
   {
     id: 'profiler-enricher',
+    displayName: 'Profiler Enricher',
     command: '@profiler-enricher',
     path: '.aioson/agents/profiler-enricher.md',
     dependsOn: ['.aioson/profiler-reports/{person-slug}/research-report.md'],
@@ -296,10 +359,11 @@ const AGENT_DEFINITIONS = [
   },
   {
     id: 'profiler-forge',
+    displayName: 'Profiler Forge',
     command: '@profiler-forge',
     path: '.aioson/agents/profiler-forge.md',
     dependsOn: ['.aioson/profiler-reports/{person-slug}/enriched-profile.md'],
-    output: '.aioson/genomas/{person-slug}-{domain-slug}.md + .aioson/genomas/{person-slug}-{domain-slug}.meta.json + .aioson/advisors/{person-slug}-advisor.md'
+    output: '.aioson/genomes/{person-slug}-{domain-slug}.md + .aioson/genomes/{person-slug}-{domain-slug}.meta.json + .aioson/advisors/{person-slug}-advisor.md'
   }
 ];