@jaimevalasek/aioson 1.3.0

package/src/constants.js

@@ -0,0 +1,314 @@
+'use strict';
+
+const MANAGED_FILES = [
+  'CLAUDE.md',
+  'AGENTS.md',
+  'OPENCODE.md',
+  '.gemini/GEMINI.md',
+  '.gemini/commands/aios-setup.toml',
+  '.gemini/commands/aios-discovery-design-doc.toml',
+  '.gemini/commands/aios-analyst.toml',
+  '.gemini/commands/aios-architect.toml',
+  '.gemini/commands/aios-ux-ui.toml',
+  '.gemini/commands/aios-pm.toml',
+  '.gemini/commands/aios-dev.toml',
+  '.gemini/commands/aios-qa.toml',
+  '.gemini/commands/aios-orchestrator.toml',
+  '.aioson/config.md',
+  '.aioson/agents/setup.md',
+  '.aioson/agents/discovery-design-doc.md',
+  '.aioson/agents/analyst.md',
+  '.aioson/agents/architect.md',
+  '.aioson/agents/ux-ui.md',
+  '.aioson/agents/product.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/profiler-researcher.md',
+  '.aioson/agents/profiler-enricher.md',
+  '.aioson/agents/profiler-forge.md',
+  '.aioson/locales/en/agents/setup.md',
+  '.aioson/locales/en/agents/discovery-design-doc.md',
+  '.aioson/locales/en/agents/analyst.md',
+  '.aioson/locales/en/agents/architect.md',
+  '.aioson/locales/en/agents/ux-ui.md',
+  '.aioson/locales/en/agents/product.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/profiler-researcher.md',
+  '.aioson/locales/en/agents/profiler-enricher.md',
+  '.aioson/locales/en/agents/profiler-forge.md',
+  '.aioson/locales/pt-BR/agents/setup.md',
+  '.aioson/locales/pt-BR/agents/discovery-design-doc.md',
+  '.aioson/locales/pt-BR/agents/analyst.md',
+  '.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/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/profiler-researcher.md',
+  '.aioson/locales/pt-BR/agents/profiler-enricher.md',
+  '.aioson/locales/pt-BR/agents/profiler-forge.md',
+  '.aioson/locales/es/agents/setup.md',
+  '.aioson/locales/es/agents/discovery-design-doc.md',
+  '.aioson/locales/es/agents/analyst.md',
+  '.aioson/locales/es/agents/architect.md',
+  '.aioson/locales/es/agents/ux-ui.md',
+  '.aioson/locales/es/agents/product.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/profiler-researcher.md',
+  '.aioson/locales/es/agents/profiler-enricher.md',
+  '.aioson/locales/es/agents/profiler-forge.md',
+  '.aioson/locales/fr/agents/setup.md',
+  '.aioson/locales/fr/agents/discovery-design-doc.md',
+  '.aioson/locales/fr/agents/analyst.md',
+  '.aioson/locales/fr/agents/architect.md',
+  '.aioson/locales/fr/agents/ux-ui.md',
+  '.aioson/locales/fr/agents/product.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/profiler-researcher.md',
+  '.aioson/locales/fr/agents/profiler-enricher.md',
+  '.aioson/locales/fr/agents/profiler-forge.md',
+  '.aioson/skills/static/laravel-conventions.md',
+  '.aioson/skills/static/tall-stack-patterns.md',
+  '.aioson/skills/static/jetstream-setup.md',
+  '.aioson/skills/static/rails-conventions.md',
+  '.aioson/skills/static/node-express-patterns.md',
+  '.aioson/skills/static/node-typescript-patterns.md',
+  '.aioson/skills/static/nextjs-patterns.md',
+  '.aioson/skills/static/ui-ux-modern.md',
+  '.aioson/skills/static/web3-ethereum-patterns.md',
+  '.aioson/skills/static/web3-solana-patterns.md',
+  '.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/dynamic/laravel-docs.md',
+  '.aioson/skills/dynamic/flux-ui-docs.md',
+  '.aioson/skills/dynamic/npm-packages.md',
+  '.aioson/skills/dynamic/ethereum-docs.md',
+  '.aioson/skills/dynamic/solana-docs.md',
+  '.aioson/skills/dynamic/cardano-docs.md',
+  '.aioson/mcp/servers.md',
+  '.aioson/schemas/genome.schema.json',
+  '.aioson/schemas/genome-meta.schema.json',
+  '.aioson/schemas/squad-manifest.schema.json',
+  '.aioson/schemas/squad-blueprint.schema.json',
+  '.aioson/schemas/readiness.schema.json',
+  '.aioson/schemas/content-blueprint.schema.json',
+  '.aioson/schemas/genome.schema.json',
+  '.aioson/schemas/genome-meta.schema.json',
+  '.aioson/tasks/squad-design.md',
+  '.aioson/tasks/squad-create.md',
+  '.aioson/tasks/squad-validate.md',
+  '.aioson/tasks/squad-analyze.md',
+  '.aioson/tasks/squad-extend.md',
+  '.aioson/tasks/squad-export.md',
+  '.aioson/tasks/squad-repair.md',
+  '.aioson/tasks/squad-pipeline.md',
+  '.aioson/profiler-reports/.gitkeep',
+  '.aioson/advisors/.gitkeep'
+];
+
+const REQUIRED_FILES = [
+  'CLAUDE.md',
+  'AGENTS.md',
+  'OPENCODE.md',
+  '.gemini/GEMINI.md',
+  '.gemini/commands/aios-setup.toml',
+  '.gemini/commands/aios-discovery-design-doc.toml',
+  '.gemini/commands/aios-analyst.toml',
+  '.gemini/commands/aios-architect.toml',
+  '.gemini/commands/aios-ux-ui.toml',
+  '.gemini/commands/aios-pm.toml',
+  '.gemini/commands/aios-dev.toml',
+  '.gemini/commands/aios-qa.toml',
+  '.gemini/commands/aios-orchestrator.toml',
+  '.aioson/config.md',
+  '.aioson/agents/setup.md',
+  '.aioson/agents/discovery-design-doc.md',
+  '.aioson/agents/analyst.md',
+  '.aioson/agents/ux-ui.md',
+  '.aioson/agents/dev.md',
+  '.aioson/context/.gitkeep'
+];
+
+const CONTEXT_REQUIRED_FIELDS = [
+  'project_name',
+  'project_type',
+  'profile',
+  'framework',
+  'framework_installed',
+  'classification',
+  'conversation_language',
+  'aioson_version'
+];
+
+const CONTEXT_ALLOWED_CLASSIFICATIONS = ['MICRO', 'SMALL', 'MEDIUM'];
+const CONTEXT_ALLOWED_PROJECT_TYPES = ['web_app', 'api', 'site', 'script', 'dapp'];
+const CONTEXT_ALLOWED_PROFILES = ['developer', 'beginner', 'team'];
+
+const AGENT_DEFINITIONS = [
+  {
+    id: 'setup',
+    command: '@setup',
+    path: '.aioson/agents/setup.md',
+    dependsOn: [],
+    output: '.aioson/context/project.context.md'
+  },
+  {
+    id: 'discovery-design-doc',
+    command: '@discovery-design-doc',
+    path: '.aioson/agents/discovery-design-doc.md',
+    dependsOn: ['.aioson/context/project.context.md'],
+    output: '.aioson/context/design-doc.md + .aioson/context/readiness.md'
+  },
+  {
+    id: '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: 'analyst',
+    command: '@analyst',
+    path: '.aioson/agents/analyst.md',
+    dependsOn: ['.aioson/context/project.context.md'],
+    output: '.aioson/context/discovery.md'
+  },
+  {
+    id: 'architect',
+    command: '@architect',
+    path: '.aioson/agents/architect.md',
+    dependsOn: [
+      '.aioson/context/project.context.md',
+      '.aioson/context/discovery.md'
+    ],
+    output: '.aioson/context/architecture.md'
+  },
+  {
+    id: 'ux-ui',
+    command: '@ux-ui',
+    path: '.aioson/agents/ux-ui.md',
+    dependsOn: [
+      '.aioson/context/project.context.md',
+      '.aioson/context/prd.md or .aioson/context/prd-{slug}.md',
+      '.aioson/context/discovery.md',
+      '.aioson/context/architecture.md'
+    ],
+    output: '.aioson/context/ui-spec.md + Visual identity enrichment in prd.md or prd-{slug}.md'
+  },
+  {
+    id: 'pm',
+    command: '@pm',
+    path: '.aioson/agents/pm.md',
+    dependsOn: [
+      '.aioson/context/project.context.md',
+      '.aioson/context/prd.md or .aioson/context/prd-{slug}.md',
+      '.aioson/context/discovery.md',
+      '.aioson/context/architecture.md'
+    ],
+    output: '.aioson/context/prd.md or prd-{slug}.md (enriched with delivery plan and acceptance criteria)'
+  },
+  {
+    id: 'dev',
+    command: '@dev',
+    path: '.aioson/agents/dev.md',
+    dependsOn: [
+      '.aioson/context/project.context.md',
+      '.aioson/context/discovery.md',
+      '.aioson/context/architecture.md'
+    ],
+    output: 'code changes'
+  },
+  {
+    id: 'qa',
+    command: '@qa',
+    path: '.aioson/agents/qa.md',
+    dependsOn: ['.aioson/context/discovery.md'],
+    output: 'QA report'
+  },
+  {
+    id: 'orchestrator',
+    command: '@orchestrator',
+    path: '.aioson/agents/orchestrator.md',
+    dependsOn: [
+      '.aioson/context/discovery.md',
+      '.aioson/context/architecture.md',
+      '.aioson/context/prd.md'
+    ],
+    output: '.aioson/context/parallel/*.status.md'
+  },
+  {
+    id: '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}/'
+  },
+  {
+    id: 'genoma',
+    command: '@genoma',
+    path: '.aioson/agents/genoma.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'
+  },
+  {
+    id: 'profiler-researcher',
+    command: '@profiler-researcher',
+    path: '.aioson/agents/profiler-researcher.md',
+    dependsOn: [],
+    output: '.aioson/profiler-reports/{person-slug}/research-report.md'
+  },
+  {
+    id: 'profiler-enricher',
+    command: '@profiler-enricher',
+    path: '.aioson/agents/profiler-enricher.md',
+    dependsOn: ['.aioson/profiler-reports/{person-slug}/research-report.md'],
+    output: '.aioson/profiler-reports/{person-slug}/enriched-profile.md'
+  },
+  {
+    id: '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'
+  }
+];
+
+module.exports = {
+  MANAGED_FILES,
+  REQUIRED_FILES,
+  CONTEXT_REQUIRED_FIELDS,
+  CONTEXT_ALLOWED_CLASSIFICATIONS,
+  CONTEXT_ALLOWED_PROJECT_TYPES,
+  CONTEXT_ALLOWED_PROFILES,
+  AGENT_DEFINITIONS
+};

package/src/context-parse-reason.js

@@ -0,0 +1,22 @@
+'use strict';
+
+function localizeContextParseReason(reason, t) {
+  const normalized = String(reason || '')
+    .trim()
+    .toLowerCase();
+  if (!normalized) return t('context_validate.parse_reason_unknown');
+  if (normalized === 'missing_frontmatter') {
+    return t('context_validate.parse_reason_missing_frontmatter');
+  }
+  if (normalized === 'unclosed_frontmatter') {
+    return t('context_validate.parse_reason_unclosed_frontmatter');
+  }
+  if (normalized === 'invalid_frontmatter_line') {
+    return t('context_validate.parse_reason_invalid_frontmatter_line');
+  }
+  return normalized;
+}
+
+module.exports = {
+  localizeContextParseReason
+};

package/src/context-writer.js

@@ -0,0 +1,150 @@
+'use strict';
+
+const fs = require('node:fs/promises');
+const path = require('node:path');
+const { ensureDir } = require('./utils');
+
+function toPositiveInt(value, fallback = 0) {
+  const num = Number(value);
+  if (!Number.isFinite(num)) return fallback;
+  return Math.max(0, Math.floor(num));
+}
+
+function scoreUserTypes(userTypesCount) {
+  const n = toPositiveInt(userTypesCount, 1);
+  if (n <= 1) return 0;
+  if (n === 2) return 1;
+  return 2;
+}
+
+function scoreIntegrations(integrationsCount) {
+  const n = toPositiveInt(integrationsCount, 0);
+  if (n === 0) return 0;
+  if (n <= 2) return 1;
+  return 2;
+}
+
+function scoreRulesComplexity(rulesComplexity) {
+  const value = String(rulesComplexity || 'none').trim().toLowerCase();
+  if (value === 'none') return 0;
+  if (value === 'some') return 1;
+  if (value === 'complex') return 2;
+  return 0;
+}
+
+function classificationFromScore(score) {
+  if (score <= 1) return 'MICRO';
+  if (score <= 3) return 'SMALL';
+  return 'MEDIUM';
+}
+
+function calculateClassification(input) {
+  const score =
+    scoreUserTypes(input.userTypesCount) +
+    scoreIntegrations(input.integrationsCount) +
+    scoreRulesComplexity(input.rulesComplexity);
+
+  return {
+    score,
+    classification: classificationFromScore(score)
+  };
+}
+
+function normalizeBoolean(value, fallback = false) {
+  if (typeof value === 'boolean') return value;
+  if (value === undefined || value === null) return fallback;
+  const text = String(value).trim().toLowerCase();
+  if (['true', 'yes', 'y', '1'].includes(text)) return true;
+  if (['false', 'no', 'n', '0'].includes(text)) return false;
+  return fallback;
+}
+
+function renderProjectContext(data) {
+  const language = data.conversationLanguage || 'en';
+  const codeCommentLanguage = data.codeCommentLanguage || language;
+  const generatedAt = data.generatedAt || new Date().toISOString();
+  const web3Enabled = Boolean(data.web3Enabled);
+  const web3Networks = data.web3Networks || '';
+  const contractFramework = data.contractFramework || '';
+  const walletProvider = data.walletProvider || '';
+  const indexer = data.indexer || '';
+  const rpcProvider = data.rpcProvider || '';
+  const notes = Array.isArray(data.notes) ? data.notes.filter(Boolean) : [];
+
+  return `---
+project_name: "${data.projectName}"
+project_type: "${data.projectType}"
+profile: "${data.profile}"
+framework: "${data.framework}"
+framework_installed: ${data.frameworkInstalled ? 'true' : 'false'}
+classification: "${data.classification}"
+conversation_language: "${language}"
+web3_enabled: ${web3Enabled ? 'true' : 'false'}
+web3_networks: "${web3Networks}"
+contract_framework: "${contractFramework}"
+wallet_provider: "${walletProvider}"
+indexer: "${indexer}"
+rpc_provider: "${rpcProvider}"
+aioson_version: "${data.aiosonVersion}"
+generated_at: "${generatedAt}"
+---
+
+# Project Context
+
+## Stack
+- Backend: ${data.backend || ''}
+- Frontend: ${data.frontend || ''}
+- Database: ${data.database || ''}
+- Auth: ${data.auth || ''}
+- UI/UX: ${data.uiux || ''}
+
+## Services
+- Queues: ${data.queues || ''}
+- Storage: ${data.storage || ''}
+- WebSockets: ${data.websockets || ''}
+- Email: ${data.email || ''}
+- Payments: ${data.payments || ''}
+- Cache: ${data.cache || ''}
+- Search: ${data.search || ''}
+
+## Web3
+- Enabled: ${web3Enabled ? 'yes' : 'no'}
+- Networks: ${web3Networks || '[not applicable]'}
+- Contract framework: ${contractFramework || '[not applicable]'}
+- Wallet provider: ${walletProvider || '[not applicable]'}
+- Indexer: ${indexer || '[not applicable]'}
+- RPC provider: ${rpcProvider || '[not applicable]'}
+
+## Installation commands
+${data.installCommands || (data.frameworkInstalled ? '[already installed]' : '[add commands here]')}
+
+## Notes
+${notes.length > 0 ? notes.map((note) => `- ${note}`).join('\n') : '- [none]'}
+
+## Conventions
+- Language: ${language}
+- Code comments language: ${codeCommentLanguage}
+- DB naming: snake_case
+- JS/TS naming: camelCase
+`;
+}
+
+async function writeProjectContext(targetDir, content) {
+  const contextDir = path.join(targetDir, '.aioson/context');
+  await ensureDir(contextDir);
+  const filePath = path.join(contextDir, 'project.context.md');
+  await fs.writeFile(filePath, content, 'utf8');
+  return filePath;
+}
+
+module.exports = {
+  toPositiveInt,
+  scoreUserTypes,
+  scoreIntegrations,
+  scoreRulesComplexity,
+  calculateClassification,
+  classificationFromScore,
+  normalizeBoolean,
+  renderProjectContext,
+  writeProjectContext
+};