@jaimevalasek/aioson 1.9.0 → 1.9.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaimevalasek/aioson",
-  "version": "1.9.0",
+  "version": "1.9.2",
   "description": "AI operating framework for hyper-personalized software.",
   "keywords": [
     "ai",

package/src/cli.js

@@ -583,6 +583,8 @@ const JSON_SUPPORTED_COMMANDS = new Set([
   'pulse-update',
   'state:save',
   'state-save',
+  'dev:state:write',
+  'dev-state-write',
   'feature:close',
   'feature-close',
   'feature:archive',
@@ -1315,7 +1317,12 @@ async function main() {
       result = await runDetectTestRunner({ args, options, logger: commandLogger });
     } else if (command === 'pulse:update' || command === 'pulse-update') {
       result = await runPulseUpdate({ args, options, logger: commandLogger });
-    } else if (command === 'state:save' || command === 'state-save') {
+    } else if (
+      command === 'state:save' ||
+      command === 'state-save' ||
+      command === 'dev:state:write' ||
+      command === 'dev-state-write'
+    ) {
       result = await runStateSave({ args, options, logger: commandLogger });
     } else if (command === 'feature:close' || command === 'feature-close') {
       result = await runFeatureClose({ args, options, logger: commandLogger });

package/src/commands/setup-context.js

@@ -35,7 +35,7 @@ const {
   inferProjectTypeFromFramework,
   inferWeb3NetworkFromFramework,
   buildDeveloperProfile,
-  recommendBeginnerProfile,
+  recommendCreatorProfile,
   buildTeamProfile
 } = require('../onboarding');
 
@@ -286,7 +286,7 @@ function buildDeveloperProfileFromOptions(options, defaults, t) {
 }
 
 function buildBeginnerProfileFromOptions(options, t) {
-  const profile = recommendBeginnerProfile({
+  const profile = recommendCreatorProfile({
     projectSummary: resolveOption(options, 'project-summary', ''),
     expectedUsers: resolveOption(options, 'expected-users', ''),
     mobileRequirement: resolveOption(options, 'mobile-requirement', ''),
@@ -408,7 +408,7 @@ async function askBeginnerProfile(rl, data, logger, t) {
   const mobileRequirement = await ask(rl, t('setup_context.q_beginner_mobile'), '2');
   const hostingPreference = await ask(rl, t('setup_context.q_beginner_hosting'), '1');
 
-  const recommendation = recommendBeginnerProfile({
+  const recommendation = recommendCreatorProfile({
     projectSummary,
     expectedUsers,
     mobileRequirement,
@@ -443,7 +443,7 @@ async function askBeginnerProfile(rl, data, logger, t) {
 
   return {
     ...custom,
-    profile: 'beginner',
+    profile: 'creator',
     notes: uniqueStrings([
       ...localizeProfileNotes(recommendation, t).notes,
       t('setup_context.note_beginner_declined')
@@ -560,7 +560,7 @@ async function runSetupContext({ args, options, logger, t }) {
       let profileData = null;
       if (data.profile === 'developer') {
         profileData = await askDeveloperProfile(rl, data, t);
-      } else if (data.profile === 'beginner') {
+      } else if (data.profile === 'creator') {
         profileData = await askBeginnerProfile(rl, data, logger, t);
       } else {
         profileData = await askTeamProfile(rl, data, t);
@@ -601,7 +601,7 @@ async function runSetupContext({ args, options, logger, t }) {
     let profileData = null;
     if (profile === 'developer') {
       profileData = buildDeveloperProfileFromOptions(options, data, t);
-    } else if (profile === 'beginner') {
+    } else if (profile === 'creator') {
       profileData = buildBeginnerProfileFromOptions(options, t);
     } else {
       profileData = localizeProfileNotes(buildTeamProfileFromOptions(options, data), t);

package/src/commands/state-save.js

@@ -1,25 +1,73 @@
 'use strict';
 
 /**
- * aioson state:save — create/update dev-state.md for @dev session resumption.
+ * aioson state:save (alias: dev:state:write) — create/update dev-state.md
+ * for @dev session resumption.
  *
- * Replaces the manual dev-state.md update block. Stores active feature,
- * phase, next step, spec version, and context package.
+ * Stores active feature, phase, next step, spec version, and context package.
+ * Invoked by upstream agents (@analyst, @product, @sheldon, @architect) at
+ * session end so the next @dev activation auto-resumes on `next_step` instead
+ * of cold-starting.
  *
  * Usage:
- *   aioson state:save . --feature=checkout --phase=3 --next="Implement notification listeners" \
- *     --spec-version=3 --status=in_progress
- *   aioson state:save . --feature=checkout --next="Continue payment webhook" --status=in_progress
+ *   aioson dev:state:write . --feature=checkout --phase=3 \
+ *     --next="Implement notification listeners" --context=spec,requirements,impl-plan
+ *   aioson state:save . --feature=checkout --next="Continue payment webhook"
+ *
+ * --context (optional): comma-separated canonical type tokens. Each token
+ * resolves to a feature-scoped path. Max 4 entries total (including the
+ * always-included project.context.md anchor). Unknown tokens or missing
+ * files emit a warning and are skipped — never fail the command.
+ *
+ * Canonical context tokens:
+ *   prd          → prd-{slug}.md
+ *   requirements → requirements-{slug}.md
+ *   spec         → spec-{slug}.md
+ *   architecture → architecture.md
+ *   impl-plan    → implementation-plan-{slug}.md
+ *   sheldon      → sheldon-enrichment-{slug}.md
+ *   design-doc   → design-doc-{slug}.md (falls back to design-doc.md)
+ *   dossier      → features/{slug}/dossier.md
+ *
+ * When --context is omitted, auto-detect kicks in (legacy behavior): include
+ * project.context.md + spec-{slug}.md + plan if present.
  */
 
 const fs = require('node:fs/promises');
 const path = require('node:path');
 const { contextDir, readFileSafe, parseFrontmatter, scanArtifacts } = require('../preflight-engine');
 
+const MAX_CONTEXT = 4;
+
+const CONTEXT_TYPE_MAP = {
+  prd:           { rel: (slug) => `prd-${slug}.md` },
+  requirements:  { rel: (slug) => `requirements-${slug}.md` },
+  spec:          { rel: (slug) => `spec-${slug}.md` },
+  architecture:  { rel: () => 'architecture.md' },
+  'impl-plan':   { rel: (slug) => `implementation-plan-${slug}.md` },
+  sheldon:       { rel: (slug) => `sheldon-enrichment-${slug}.md` },
+  'design-doc':  { rel: (slug) => `design-doc-${slug}.md`, fallback: () => 'design-doc.md' },
+  dossier:       { rel: (slug) => `features/${slug}/dossier.md` }
+};
+
 function nowDate() {
   return new Date().toISOString().slice(0, 10);
 }
 
+function parseContextFlag(value) {
+  if (value === undefined || value === null || value === '') return null;
+  return String(value).split(',').map((s) => s.trim()).filter(Boolean);
+}
+
+async function fileExistsRel(targetDir, rel) {
+  try {
+    await fs.access(path.join(contextDir(targetDir), rel));
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 async function runStateSave({ args, options = {}, logger }) {
   const targetDir = path.resolve(process.cwd(), args[0] || '.');
   const slug = options.feature ? String(options.feature) : null;
@@ -28,6 +76,7 @@ async function runStateSave({ args, options = {}, logger }) {
   const specVersion = options['spec-version'] ? String(options['spec-version']) : null;
   const status = options.status ? String(options.status) : 'in_progress';
   const plan = options.plan ? String(options.plan) : null;
+  const contextTokens = parseContextFlag(options.context);
 
   if (!slug) {
     if (options.json) return { ok: false, reason: 'missing_feature' };
@@ -41,13 +90,49 @@ async function runStateSave({ args, options = {}, logger }) {
     return { ok: false };
   }
 
-  // Build context package based on what exists
+  // Build context package
   const artifacts = await scanArtifacts(targetDir, slug);
   const contextPackage = [];
-  if (artifacts.project_context.exists) contextPackage.push('project.context.md');
-  if (artifacts.spec.exists) contextPackage.push(`spec-${slug}.md`);
-  if (plan) contextPackage.push(plan);
-  else if (artifacts.implementation_plan.exists) contextPackage.push(`implementation-plan-${slug}.md`);
+  const warnings = [];
+
+  if (contextTokens) {
+    // Explicit mode: agent declares the canonical types to include.
+    // Always anchor with project.context.md (counts toward the 4-entry cap).
+    if (artifacts.project_context.exists) contextPackage.push('project.context.md');
+
+    for (const rawToken of contextTokens) {
+      const token = rawToken.toLowerCase();
+      if (contextPackage.length >= MAX_CONTEXT) {
+        warnings.push(`context cap reached (${MAX_CONTEXT}); skipped "${token}" and remaining`);
+        break;
+      }
+      const def = CONTEXT_TYPE_MAP[token];
+      if (!def) {
+        warnings.push(`unknown context type "${token}" (valid: ${Object.keys(CONTEXT_TYPE_MAP).join(', ')})`);
+        continue;
+      }
+      const relPath = def.rel(slug);
+      if (await fileExistsRel(targetDir, relPath)) {
+        if (!contextPackage.includes(relPath)) contextPackage.push(relPath);
+      } else if (def.fallback) {
+        const fb = def.fallback();
+        if (await fileExistsRel(targetDir, fb)) {
+          if (!contextPackage.includes(fb)) contextPackage.push(fb);
+        } else {
+          warnings.push(`"${token}" file missing (${relPath}); skipped`);
+        }
+      } else {
+        warnings.push(`"${token}" file missing (${relPath}); skipped`);
+      }
+    }
+  } else {
+    // Auto-detect (legacy behavior): keep backward compatibility for callers
+    // that haven't migrated to --context yet.
+    if (artifacts.project_context.exists) contextPackage.push('project.context.md');
+    if (artifacts.spec.exists) contextPackage.push(`spec-${slug}.md`);
+    if (plan) contextPackage.push(plan);
+    else if (artifacts.implementation_plan.exists) contextPackage.push(`implementation-plan-${slug}.md`);
+  }
 
   const today = nowDate();
   const statePath = path.join(contextDir(targetDir), 'dev-state.md');
@@ -104,7 +189,8 @@ async function runStateSave({ args, options = {}, logger }) {
     active_phase: phase,
     next_step: next,
     last_spec_version: specVersion,
-    context_package: contextPackage
+    context_package: contextPackage,
+    warnings
   };
 
   if (options.json) return result;
@@ -115,8 +201,20 @@ async function runStateSave({ args, options = {}, logger }) {
   logger.log(`  next_step: "${next}"`);
   if (specVersion) logger.log(`  last_spec_version: ${specVersion}`);
   logger.log(`  context_package: [${contextPackage.join(', ')}]`);
+  for (const w of warnings) logger.log(`  warn: ${w}`);
+  if (warnings.length === 0 && contextTokens) {
+    // Visible confirmation banner — agent kernels can rely on this to know
+    // they fulfilled the dev-state.md producer contract for @dev cold-resume.
+    const preview = next.length > 80 ? `${next.slice(0, 77)}...` : next;
+    logger.log(`  ✓ @dev will auto-resume on cold start: next_step="${preview}"`);
+  }
 
   return result;
 }
 
-module.exports = { runStateSave };
+module.exports = {
+  runStateSave,
+  CONTEXT_TYPE_MAP,
+  MAX_CONTEXT,
+  parseContextFlag
+};

package/src/commands/update.js

@@ -10,12 +10,14 @@ async function runUpdate({ args, options, logger, t }) {
   const targetDir = path.resolve(process.cwd(), args[0] || '.');
   const dryRun = Boolean(options['dry-run']);
   const all = Boolean(options.all);
+  const selective = Boolean(options.selective);
   const requestedLanguage = options.lang || options.language;
 
   const detection = await detectFramework(targetDir);
   const result = await updateInstallation(targetDir, {
     dryRun,
     all,
+    selective,
     frameworkDetection: detection.framework
   });
 
@@ -40,6 +42,10 @@ async function runUpdate({ args, options, logger, t }) {
   logger.log(t('update.done_at', { targetDir }));
   logger.log(t('update.files_updated', { count: result.copied.length }));
   logger.log(t('update.backups_created', { count: result.backedUp.length }));
+  if (result.migrations && result.migrations.profileRename && result.migrations.profileRename.changed) {
+    logger.log('');
+    logger.log(t('update.profile_renamed'));
+  }
   if (!dryRun) {
     logger.log('');
     logger.log(t('update.reconfigure_hint'));

package/src/constants.js

@@ -60,6 +60,7 @@ const MANAGED_FILES = [
   '.aioson/docs/deyvin/pair-execution.md',
   '.aioson/docs/deyvin/runtime-handoffs.md',
   '.aioson/docs/deyvin/debugging-escalation.md',
+  '.aioson/docs/handoff-persistence.md',
   '.aioson/docs/sheldon/research-loop.md',
   '.aioson/docs/sheldon/web-intelligence.md',
   '.aioson/docs/sheldon/quality-lens.md',
@@ -67,6 +68,9 @@ const MANAGED_FILES = [
   '.aioson/docs/sheldon/harness-contract.md',
   '.aioson/docs/dev/stack-conventions.md',
   '.aioson/docs/dev/execution-discipline.md',
+  '.aioson/skills/process/decision-presentation/SKILL.md',
+  '.aioson/skills/process/decision-presentation/references/jargon-map.en.yaml',
+  '.aioson/skills/process/decision-presentation/references/jargon-map.pt-BR.yaml',
   '.aioson/skills/static/laravel-conventions.md',
   '.aioson/skills/static/tall-stack-patterns.md',
   '.aioson/skills/static/jetstream-setup.md',
@@ -180,7 +184,7 @@ const CONTEXT_REQUIRED_FIELDS = [
 
 const CONTEXT_ALLOWED_CLASSIFICATIONS = ['MICRO', 'SMALL', 'MEDIUM'];
 const CONTEXT_ALLOWED_PROJECT_TYPES = ['web_app', 'api', 'site', 'script', 'dapp', 'desktop_app'];
-const CONTEXT_ALLOWED_PROFILES = ['developer', 'beginner', 'team'];
+const CONTEXT_ALLOWED_PROFILES = ['developer', 'creator', 'team'];
 
 const AGENT_DEFINITIONS = [
   {

package/src/doctor.js

@@ -18,6 +18,7 @@ const {
   assessLearningOrphans,
   assessDistillationLag
 } = require('./learning-loop-doctor');
+const { assessJargonLeak } = require('./jargon-leak-doctor');
 const { openRuntimeDb } = require('./runtime-store');
 
 const BOOTSTRAP_REQUIRED = ['what-is.md', 'how-it-works.md', 'what-it-does.md', 'current-state.md'];
@@ -436,6 +437,57 @@ async function runDoctor(targetDir) {
     }
   }
 
+  // 8. lay-user-agent-mode — jargon_leak_detection (Phase 3)
+  //    Independent of classification (the skip rule is profile-based, not
+  //    size-based). Opens its own DB handle so it works for MICRO projects.
+  let jargonDb = null;
+  try {
+    try {
+      const handle = await openRuntimeDb(targetDir);
+      jargonDb = handle.db;
+    } catch {
+      jargonDb = null; // greenfield (EC-LUM-05)
+    }
+    const jargonAssessment = await assessJargonLeak({ db: jargonDb, targetDir });
+    if (jargonAssessment.skipped) {
+      checks.push({
+        id: 'jargon_leak_detection',
+        severity: 'warning',
+        key: 'doctor.jargon_leak_detection.skipped_dev',
+        params: { profile: jargonAssessment.profile },
+        ok: true
+      });
+    } else {
+      const params = {
+        count: jargonAssessment.count,
+        events: jargonAssessment.eventsScanned || 0,
+        profile: jargonAssessment.profile
+      };
+      checks.push({
+        id: 'jargon_leak_detection',
+        severity: 'warning',
+        key: jargonAssessment.ok
+          ? 'doctor.jargon_leak_detection.ok'
+          : 'doctor.jargon_leak_detection.fail',
+        params,
+        ok: jargonAssessment.ok,
+        hintKey: jargonAssessment.ok ? undefined : 'doctor.jargon_leak_detection.hint',
+        hintParams: jargonAssessment.ok
+          ? undefined
+          : {
+              samples: jargonAssessment.samples
+                .slice(0, 5)
+                .map((s) => `${s.agent}/${(s.terms || []).join('+')}`)
+                .join(', ') || '(none)'
+            }
+      });
+    }
+  } finally {
+    if (jargonDb) {
+      try { jargonDb.close(); } catch { /* swallow */ }
+    }
+  }
+
   // 5. permissions_in_sync
   const permsAssessment = await assessPermissionsSync(targetDir);
   const permsOk = !permsAssessment.protocolMissing

package/src/gateway-pointer-merge.js

@@ -0,0 +1,103 @@
+'use strict';
+
+// Gateway pointer merge — keeps the AIOSON instructions inside CLAUDE.md,
+// AGENTS.md, OPENCODE.md, and .gemini/GEMINI.md without clobbering any
+// project-authored content above the managed block. When the destination
+// file already exists, the prior copy path skipped it entirely, leaving
+// existing projects without the framework instructions. This module wraps
+// the template body in <!-- AIOSON:BEGIN --> ... <!-- AIOSON:END --> markers
+// and either appends or replaces that block in place.
+
+const fs = require('node:fs/promises');
+const path = require('node:path');
+const { exists, copyFileWithDir, toRelativeSafe } = require('./utils');
+
+const MARKER_BEGIN = '<!-- AIOSON:BEGIN -->';
+const MARKER_END = '<!-- AIOSON:END -->';
+const BLOCK_NOTICE = '> Managed by AIOSON — edits inside this block will be overwritten on `aioson update`. Put project-specific rules above or below this block.';
+
+const GATEWAY_POINTER_FILES = new Set([
+  'CLAUDE.md',
+  'AGENTS.md',
+  'OPENCODE.md',
+  '.gemini/GEMINI.md'
+]);
+
+function isGatewayPointerPath(rel) {
+  return GATEWAY_POINTER_FILES.has(rel);
+}
+
+function buildBlock(templateContent) {
+  const body = templateContent.endsWith('\n') ? templateContent : `${templateContent}\n`;
+  return `${MARKER_BEGIN}\n${BLOCK_NOTICE}\n\n${body}${MARKER_END}\n`;
+}
+
+function findBlockRange(content) {
+  const start = content.indexOf(MARKER_BEGIN);
+  if (start === -1) return null;
+  const endIdx = content.indexOf(MARKER_END, start + MARKER_BEGIN.length);
+  if (endIdx === -1) return null;
+  let end = endIdx + MARKER_END.length;
+  if (content[end] === '\n') end += 1;
+  return { start, end };
+}
+
+async function mergeGatewayPointer({ templatePath, targetPath, backupRoot, targetDir, dryRun = false }) {
+  const templateContent = await fs.readFile(templatePath, 'utf8');
+  const block = buildBlock(templateContent);
+
+  if (!(await exists(targetPath))) {
+    if (!dryRun) await fs.writeFile(targetPath, block, 'utf8');
+    return { action: 'created' };
+  }
+
+  const existing = await fs.readFile(targetPath, 'utf8');
+  const range = findBlockRange(existing);
+
+  let next;
+  let action;
+  if (range) {
+    const before = existing.slice(0, range.start);
+    const after = existing.slice(range.end);
+    const cleanBefore = before.length === 0 || before.endsWith('\n') ? before : `${before}\n`;
+    next = `${cleanBefore}${block}${after}`;
+    action = 'block_updated';
+  } else {
+    const separator = existing.length === 0 ? '' : existing.endsWith('\n\n') ? '' : existing.endsWith('\n') ? '\n' : '\n\n';
+    next = `${existing}${separator}${block}`;
+    action = 'block_appended';
+  }
+
+  if (next === existing) return { action: 'unchanged' };
+
+  let backupPath = null;
+  let backupError = null;
+  if (backupRoot && targetDir) {
+    const rel = toRelativeSafe(targetDir, targetPath);
+    const dest = path.join(backupRoot, rel);
+    if (!dryRun) {
+      try {
+        await copyFileWithDir(targetPath, dest);
+        backupPath = dest;
+      } catch (err) {
+        backupError = err && err.message ? err.message : String(err);
+      }
+    } else {
+      backupPath = dest;
+    }
+  }
+
+  if (!dryRun) await fs.writeFile(targetPath, next, 'utf8');
+  return { action, backupPath, backupError };
+}
+
+module.exports = {
+  MARKER_BEGIN,
+  MARKER_END,
+  BLOCK_NOTICE,
+  GATEWAY_POINTER_FILES,
+  isGatewayPointerPath,
+  buildBlock,
+  findBlockRange,
+  mergeGatewayPointer
+};

package/src/i18n/messages/en.js

@@ -343,6 +343,7 @@ module.exports = {
     done_at: 'Update completed at: {targetDir}',
     files_updated: 'Files updated: {count}',
     backups_created: 'Backups created: {count}',
+    profile_renamed: 'i Profile `beginner` renamed to `creator` in project.context.md to better describe the user. Behavior unchanged. Edit the file to switch to `developer` if desired.',
     reconfigure_hint: 'New options may be available. Run: aioson install --reconfigure'
   },
   info: {
@@ -381,7 +382,7 @@ module.exports = {
     context_project_type_value: '`project_type` must be one of {expected}',
     context_project_type_value_hint: 'Use web_app, api, site, script, dapp, or desktop_app exactly.',
     context_profile_value: '`profile` must be one of {expected}',
-    context_profile_value_hint: 'Use developer, beginner, or team exactly.',
+    context_profile_value_hint: 'Use developer, creator, or team exactly.',
     context_interaction_language_format: '`interaction_language` is not a valid BCP-47 tag',
     context_interaction_language_format_hint: 'Use values like en, en-US, pt-BR.',
     context_conversation_language_format: '`conversation_language` is not a valid BCP-47 tag',
@@ -452,6 +453,12 @@ module.exports = {
       distillation_lag: 'Distillation lag: {closed} closed features but only {distillations} have an auto_distillation event (threshold {threshold})',
       distillation_lag_hint: 'Features missing distillation (first 5): {missing_slugs}. Check Phase 5 hook health.',
       distillation_lag_skipped_micro: 'Distillation lag check skipped: project classification is MICRO (BR-ALL-11)'
+    },
+    jargon_leak_detection: {
+      ok: 'No jargon leaks in user-facing agent events ({events} events scanned, profile={profile})',
+      fail: 'Jargon leaks: {count} occurrences across {events} events from MVP agents (profile={profile})',
+      hint: 'Affected events (first 5): {samples}. Translate the term via jargon-map.{en,pt-BR}.yaml or update the dictionary if the term is intentional.',
+      skipped_dev: 'Jargon leak check skipped: project profile is `{profile}` (jargon permitted in this mode)'
     }
   },
   i18n_add: {
@@ -533,7 +540,7 @@ module.exports = {
     detected: 'Detected framework: {framework} (installed={installed})',
     q_project_name: 'Project name',
     q_project_type: 'Project type (web_app|api|site|script|dapp|desktop_app)',
-    q_profile: 'Profile: [1] developer [2] beginner [3] team',
+    q_profile: 'Profile: [1] developer [2] creator [3] team',
     q_use_detected_framework: 'Use detected framework? (true/false)',
     q_framework: 'Framework',
     q_framework_installed: 'Framework installed? (true/false)',

package/src/i18n/messages/es.js

@@ -217,6 +217,7 @@ module.exports = {
     done_at: 'Actualizacion completada en: {targetDir}',
     files_updated: 'Archivos actualizados: {count}',
     backups_created: 'Backups creados: {count}',
+    profile_renamed: 'i Perfil `beginner` renombrado a `creator` en project.context.md para describir mejor al usuario. Comportamiento sin cambios. Edita el archivo para cambiar a `developer` si lo prefieres.',
     reconfigure_hint: 'Nuevas opciones pueden estar disponibles. Ejecuta: aioson install --reconfigure'
   },
   info: {
@@ -259,7 +260,7 @@ module.exports = {
     context_project_type_value: '`project_type` debe ser uno de {expected}',
     context_project_type_value_hint: 'Usa web_app, api, site, script, dapp o desktop_app exactamente.',
     context_profile_value: '`profile` debe ser uno de {expected}',
-    context_profile_value_hint: 'Usa developer, beginner o team exactamente.',
+    context_profile_value_hint: 'Usa developer, creator o team exactamente.',
     context_interaction_language_format:
       '`interaction_language` no es una etiqueta BCP-47 valida',
     context_interaction_language_format_hint: 'Usa valores como en, en-US, pt-BR.',
@@ -330,6 +331,12 @@ module.exports = {
       distillation_lag: 'Retraso de distillation: {closed} features cerradas pero solo {distillations} tienen evento auto_distillation (umbral {threshold})',
       distillation_lag_hint: 'Features sin distillation (primeras 5): {missing_slugs}. Verifique el hook de la Phase 5.',
       distillation_lag_skipped_micro: 'Verificación de distillation_lag omitida: clasificación del proyecto es MICRO (BR-ALL-11)'
+    },
+    jargon_leak_detection: {
+      ok: 'Sin fugas de jerga en eventos de agentes user-facing ({events} eventos analizados, profile={profile})',
+      fail: 'Fugas de jerga: {count} ocurrencias en {events} eventos de agentes del MVP (profile={profile})',
+      hint: 'Eventos afectados (primeros 5): {samples}. Traduce el término vía jargon-map.{en,pt-BR}.yaml o actualiza el diccionario si el término es intencional.',
+      skipped_dev: 'Verificación de jargon_leak_detection omitida: profile del proyecto es `{profile}` (jerga permitida en este modo)'
     }
   },
   i18n_add: {
@@ -411,7 +418,7 @@ module.exports = {
     detected: 'Framework detectado: {framework} (installed={installed})',
     q_project_name: 'Nombre del proyecto',
     q_project_type: 'Tipo de proyecto (web_app|api|site|script|dapp|desktop_app)',
-    q_profile: 'Perfil: [1] developer [2] beginner [3] team',
+    q_profile: 'Perfil: [1] developer [2] creator [3] team',
     q_use_detected_framework: 'Usar framework detectado? (true/false)',
     q_framework: 'Framework',
     q_framework_installed: 'Framework instalado? (true/false)',

package/src/i18n/messages/fr.js

@@ -216,6 +216,7 @@ module.exports = {
     done_at: 'Mise a jour terminee dans : {targetDir}',
     files_updated: 'Fichiers mis a jour : {count}',
     backups_created: 'Sauvegardes creees : {count}',
+    profile_renamed: 'i Profil `beginner` renomme en `creator` dans project.context.md pour mieux decrire l utilisateur. Comportement inchange. Modifiez le fichier pour passer a `developer` si vous le souhaitez.',
     reconfigure_hint: 'De nouvelles options peuvent etre disponibles. Lancez : aioson install --reconfigure'
   },
   info: {
@@ -258,7 +259,7 @@ module.exports = {
     context_project_type_value: '`project_type` doit etre une des valeurs {expected}',
     context_project_type_value_hint: 'Utilisez web_app, api, site, script, dapp ou desktop_app exactement.',
     context_profile_value: '`profile` doit etre une des valeurs {expected}',
-    context_profile_value_hint: 'Utilisez developer, beginner ou team exactement.',
+    context_profile_value_hint: 'Utilisez developer, creator ou team exactement.',
     context_interaction_language_format:
       '`interaction_language` n est pas une balise BCP-47 valide',
     context_interaction_language_format_hint: 'Utilisez des valeurs comme en, en-US, pt-BR.',
@@ -329,6 +330,12 @@ module.exports = {
       distillation_lag: 'Retard distillation : {closed} features fermées mais seulement {distillations} ont un évènement auto_distillation (seuil {threshold})',
       distillation_lag_hint: 'Features sans distillation (5 premières) : {missing_slugs}. Vérifiez le hook de la Phase 5.',
       distillation_lag_skipped_micro: 'Vérification distillation_lag ignorée : classification du projet est MICRO (BR-ALL-11)'
+    },
+    jargon_leak_detection: {
+      ok: 'Aucune fuite de jargon dans les évènements des agents user-facing ({events} évènements analysés, profile={profile})',
+      fail: 'Fuites de jargon : {count} occurrences dans {events} évènements des agents du MVP (profile={profile})',
+      hint: 'Évènements affectés (5 premiers) : {samples}. Traduisez le terme via jargon-map.{en,pt-BR}.yaml ou mettez à jour le dictionnaire si le terme est intentionnel.',
+      skipped_dev: 'Vérification jargon_leak_detection ignorée : profile du projet est `{profile}` (jargon autorisé dans ce mode)'
     }
   },
   i18n_add: {
@@ -410,7 +417,7 @@ module.exports = {
     detected: 'Framework detecte : {framework} (installed={installed})',
     q_project_name: 'Nom du projet',
     q_project_type: 'Type de projet (web_app|api|site|script|dapp|desktop_app)',
-    q_profile: 'Profil : [1] developer [2] beginner [3] team',
+    q_profile: 'Profil : [1] developer [2] creator [3] team',
     q_use_detected_framework: 'Utiliser le framework detecte ? (true/false)',
     q_framework: 'Framework',
     q_framework_installed: 'Framework installe ? (true/false)',

package/src/i18n/messages/pt-BR.js

@@ -310,6 +310,7 @@ module.exports = {
     done_at: 'Atualizacao concluida em: {targetDir}',
     files_updated: 'Arquivos atualizados: {count}',
     backups_created: 'Backups criados: {count}',
+    profile_renamed: 'i Perfil `beginner` renomeado para `creator` em project.context.md para descrever melhor o usuario. Comportamento inalterado. Edite o arquivo para mudar para `developer` se preferir.',
     reconfigure_hint: 'Novas opcoes podem estar disponiveis. Execute: aioson install --reconfigure'
   },
   info: {
@@ -352,7 +353,7 @@ module.exports = {
     context_project_type_value: '`project_type` deve ser um de {expected}',
     context_project_type_value_hint: 'Use web_app, api, site, script, dapp ou desktop_app exatamente.',
     context_profile_value: '`profile` deve ser um de {expected}',
-    context_profile_value_hint: 'Use developer, beginner ou team exatamente.',
+    context_profile_value_hint: 'Use developer, creator ou team exatamente.',
     context_interaction_language_format:
       '`interaction_language` nao e uma tag BCP-47 valida',
     context_interaction_language_format_hint: 'Use valores como en, en-US, pt-BR.',
@@ -424,6 +425,12 @@ module.exports = {
       distillation_lag: 'Lag de distillation: {closed} features fechadas mas apenas {distillations} têm evento auto_distillation (limite {threshold})',
       distillation_lag_hint: 'Features sem distillation (primeiras 5): {missing_slugs}. Verifique o hook da Phase 5.',
       distillation_lag_skipped_micro: 'Check de distillation_lag ignorado: classificação do projeto é MICRO (BR-ALL-11)'
+    },
+    jargon_leak_detection: {
+      ok: 'Sem vazamento de jargão nos eventos dos agentes user-facing ({events} eventos analisados, profile={profile})',
+      fail: 'Vazamento de jargão: {count} ocorrências em {events} eventos dos agentes do MVP (profile={profile})',
+      hint: 'Eventos afetados (primeiros 5): {samples}. Traduza o termo via jargon-map.{en,pt-BR}.yaml ou atualize o dicionário se o termo for intencional.',
+      skipped_dev: 'Check de jargon_leak_detection ignorado: profile do projeto é `{profile}` (jargão permitido nesse modo)'
     }
   },
   i18n_add: {
@@ -505,7 +512,7 @@ module.exports = {
     detected: 'Framework detectado: {framework} (installed={installed})',
     q_project_name: 'Nome do projeto',
     q_project_type: 'Tipo do projeto (web_app|api|site|script|dapp|desktop_app)',
-    q_profile: 'Perfil: [1] developer [2] beginner [3] team',
+    q_profile: 'Perfil: [1] developer [2] creator [3] team',
     q_use_detected_framework: 'Usar framework detectado? (true/false)',
     q_framework: 'Framework',
     q_framework_installed: 'Framework instalado? (true/false)',