atris 3.57.4 → 3.58.6

package/commands/learn.js

@@ -12,6 +12,17 @@ const {
   getStats,
   exportMarkdown,
 } = require('../lib/learnings');
+const applyGate = require('../lib/apply-gate');
+const {
+  fileTeachExperiment,
+  extractTeachNumbers,
+  extractTeachMechanisms,
+  isThinTeachLesson,
+  printLearnerCheckGate,
+  proveSavedLearnerBaseline,
+} = require('./youtube');
+
+const KEEP_RULE = 'keep only if measure.py moves 0→1. scores 1 only when the fixture contains the check tokens.';
 
 function showRecent(limit = 20) {
   const learnings = loadLearnings()
@@ -36,7 +47,7 @@ function showRecent(limit = 20) {
 
   console.log('');
   console.log('┌─────────────────────────────────────────────────────────────┐');
-  console.log(`│ Learnings — ${learnings.length} active${' '.repeat(Math.max(0, 44 - String(learnings.length).length))}│`);
+  console.log(`│ Learnings: ${learnings.length} active${' '.repeat(Math.max(0, 44 - String(learnings.length).length))}│`);
   console.log('└─────────────────────────────────────────────────────────────┘');
   console.log('');
 
@@ -46,7 +57,7 @@ function showRecent(limit = 20) {
       const conf = e._effectiveConfidence;
       const bar = conf >= 7 ? '●' : conf >= 4 ? '◐' : '○';
       const date = (e.ts || '').split('T')[0];
-      console.log(`  ${bar} [${conf}/10] ${e.key} — ${e.insight}`);
+      console.log(`  ${bar} [${conf}/10] ${e.key}: ${e.insight}`);
       if (e.files && e.files.length > 0) {
         console.log(`         files: ${e.files.join(', ')}`);
       }
@@ -68,12 +79,12 @@ function showSearch(query) {
   }
 
   console.log('');
-  console.log(`  Search: "${query}" — ${results.length} ${results.length === 1 ? 'result' : 'results'}`);
+  console.log(`  Search: "${query}", ${results.length} ${results.length === 1 ? 'result' : 'results'}`);
   console.log('');
   for (const e of results) {
     const conf = e._effectiveConfidence;
     const bar = conf >= 7 ? '●' : conf >= 4 ? '◐' : '○';
-    console.log(`  ${bar} [${conf}/10] ${e.type}/${e.key} — ${e.insight}`);
+    console.log(`  ${bar} [${conf}/10] ${e.type}/${e.key}: ${e.insight}`);
   }
   console.log('');
 }
@@ -114,7 +125,7 @@ function showExport() {
   const md = exportMarkdown();
   console.log('');
   console.log(md);
-  console.log('  — Copy the above into CLAUDE.md or save to a file.');
+  console.log('  Copy the above into CLAUDE.md or save to a file.');
   console.log('');
 }
 
@@ -130,15 +141,15 @@ function showPrune() {
 
   console.log('');
   if (stale.length > 0) {
-    console.log(`  STALE (${stale.length} — referenced files deleted):`);
+    console.log(`  STALE (${stale.length}, referenced files deleted):`);
     for (const { entry, missingFiles } of stale) {
-      console.log(`  ⚠ ${entry.key} — missing: ${missingFiles.join(', ')}`);
+      console.log(`  ⚠ ${entry.key}, missing: ${missingFiles.join(', ')}`);
     }
     console.log('');
   }
 
   if (contradictions.length > 0) {
-    console.log(`  CONFLICTS (${contradictions.length} — same key, different insight):`);
+    console.log(`  CONFLICTS (${contradictions.length}, same key, different insight):`);
     for (const { a, b } of contradictions) {
       console.log(`  ⚠ ${a.key}: "${a.insight}" vs "${b.insight}"`);
     }
@@ -149,7 +160,52 @@ function showPrune() {
   console.log('');
 }
 
-function interactiveAdd() {
+function commitAddedLearning({ type, key, insight, confidence, source, files } = {}, deps = {}) {
+  const print = typeof deps.output === 'function' ? deps.output : (line = '') => console.log(line);
+  const cwd = deps.cwd || process.cwd();
+  const entry = addLearning({ type, key, insight, confidence, source, files });
+  print('');
+  print(`  ✓ Saved: [${entry.confidence}/10] ${entry.type}/${entry.key}`);
+  print(`    "${entry.insight}"`);
+  print('');
+  const baseline = mintRichLearn({
+    cwd,
+    key: entry.key,
+    insight: entry.insight,
+    now: deps.now,
+    output: print,
+  });
+  return { entry, baseline };
+}
+
+function reviewLearningType(insight) {
+  return /^(don't|never|avoid|watch out|careful)/i.test(String(insight || '')) ? 'pitfall' : 'pattern';
+}
+
+function reviewLearningKey(insight) {
+  return String(insight || '').toLowerCase().replace(/[^a-z0-9\s]/g, '').split(/\s+/).slice(0, 4).join('-');
+}
+
+function commitReviewLearning(insight, deps = {}) {
+  const print = typeof deps.output === 'function' ? deps.output : (line = '') => console.log(line);
+  const cwd = deps.cwd || process.cwd();
+  const text = String(insight || '').trim();
+  if (!text) return { entry: null, baseline: 0 };
+  const type = reviewLearningType(text);
+  const key = reviewLearningKey(text);
+  const entry = addLearning({ type, key, insight: text, confidence: 7, source: 'review', files: [] });
+  print(`✓ Saved to learnings: [7/10] ${entry.type}/${entry.key}`);
+  const baseline = mintRichLearn({
+    cwd,
+    key: entry.key,
+    insight: entry.insight,
+    now: deps.now,
+    output: print,
+  });
+  return { entry, baseline };
+}
+
+function interactiveAdd(deps = {}) {
   const rl = readline.createInterface({
     input: process.stdin,
     output: process.stdout,
@@ -209,16 +265,16 @@ function interactiveAdd() {
       // Quality gate
       const worth = (await ask('\n  Would this save time in a future session? (y/n): ')).trim().toLowerCase();
       if (worth !== 'y' && worth !== 'yes') {
-        console.log('  Skipped — only save learnings that compound.');
+        console.log('  Skipped, only save learnings that compound.');
         rl.close();
         return;
       }
 
-      const entry = addLearning({ type, key, insight, confidence, source, files });
-      console.log('');
-      console.log(`  ✓ Saved: [${entry.confidence}/10] ${entry.type}/${entry.key}`);
-      console.log(`    "${entry.insight}"`);
-      console.log('');
+      commitAddedLearning({ type, key, insight, confidence, source, files }, {
+        cwd: deps.cwd || process.cwd(),
+        now: deps.now,
+        output: deps.output,
+      });
       rl.close();
     } catch (err) {
       console.log(`  ✗ Error: ${err.message}`);
@@ -239,24 +295,104 @@ function printLearnLogSchema(stream = console.error) {
   for (const line of learnLogSchemaLines()) stream(`  ${line}`);
 }
 
+function learnExperimentSlug(key) {
+  return `learn-${applyGate.applySlug(key)}`;
+}
+
+function learnExperimentRel(key) {
+  return `atris/experiments/${learnExperimentSlug(key)}`;
+}
+
+function learnApplyRel(key) {
+  return applyGate.applySidecarRel('learn', applyGate.applySlug(key));
+}
+
+function learnLessonFromText(text) {
+  const body = String(text || '');
+  return {
+    numbers: extractTeachNumbers(body),
+    mechanisms: extractTeachMechanisms(body),
+  };
+}
+
+function saveRichLearn({ cwd, key, insight } = {}) {
+  const lesson = learnLessonFromText(insight);
+  if (isThinTeachLesson(lesson)) {
+    return { thin: true, packRel: null, lesson };
+  }
+  if (cwd) fs.mkdirSync(path.join(cwd, 'atris', 'wiki'), { recursive: true });
+  const packRel = fileTeachExperiment({
+    cwd,
+    lesson,
+    slug: key ? learnExperimentSlug(key) : null,
+    applyRel: key ? learnApplyRel(key) : null,
+  });
+  return { thin: false, packRel, lesson };
+}
+
+function ensureLearnApply({ cwd, key, packRel, now, output } = {}) {
+  const pack = packRel || (key ? learnExperimentRel(key) : null);
+  const slug = pack ? path.basename(pack) : null;
+  return applyGate.ensureApply({
+    cwd,
+    source: key ? `learn:${key}` : 'learn',
+    rel: key ? learnApplyRel(key) : null,
+    now,
+    output,
+    incompleteMessage: slug
+      ? `next: atris experiments keep ${slug}`
+      : applyGate.ephemeralApplyMessage('learning'),
+    required: false,
+    change: pack ? `apply ${pack}` : undefined,
+    receipt: pack ? KEEP_RULE : undefined,
+    journalLine: pack ? `- [claimable] apply: ${pack}. ${KEEP_RULE}` : undefined,
+  });
+}
+
+function mintRichLearn({ cwd, key, insight, now, output } = {}) {
+  const print = typeof output === 'function' ? output : (line = '') => console.log(line);
+  const saved = saveRichLearn({ cwd, key, insight });
+  if (saved.thin) {
+    printLearnerCheckGate(print, saved.lesson, { includeCheck: true });
+    return 0;
+  }
+  ensureLearnApply({
+    cwd,
+    key,
+    packRel: saved.packRel,
+    now,
+    output: print,
+  });
+  return proveSavedLearnerBaseline({
+    cwd,
+    applyRel: key ? learnApplyRel(key) : null,
+    lesson: saved.lesson,
+    output: print,
+  });
+}
+
 /**
  * Non-interactive log: `atris learn log '{"type":"pattern","key":"...","insight":"...","confidence":8,"source":"observed"}'`
- * For agents and scripts — no prompts, no quality gate.
+ * For agents and scripts, no prompts, no quality gate.
  * Aliases: title→key, detail→insight.
  */
-function logDirect(jsonStr) {
+function logDirect(jsonStr, deps = {}) {
+  const error = typeof deps.error === 'function' ? deps.error : (line = '') => console.error(line);
+  const print = typeof deps.output === 'function' ? deps.output : (line = '') => console.log(line);
+  const exit = typeof deps.exit === 'function' ? deps.exit : (code) => process.exit(code);
+  const cwd = deps.cwd || process.cwd();
   if (!jsonStr) {
-    console.error('  ✗ Usage: atris learn log \'<json>\'');
-    printLearnLogSchema();
-    process.exit(1);
+    error('  ✗ Usage: atris learn log \'<json>\'');
+    printLearnLogSchema(error);
+    return exit(1);
   }
   let data;
   try {
     data = JSON.parse(jsonStr);
   } catch (err) {
-    console.error(`  ✗ Invalid JSON: ${err.message}`);
-    printLearnLogSchema();
-    process.exit(1);
+    error(`  ✗ Invalid JSON: ${err.message}`);
+    printLearnLogSchema(error);
+    return exit(1);
   }
   try {
     const entry = addLearning({
@@ -267,11 +403,20 @@ function logDirect(jsonStr) {
       source: data.source || 'observed',
       files: data.files || [],
     });
-    console.log(`  ✓ [${entry.confidence}/10] ${entry.type}/${entry.key}`);
+    print(`  ✓ [${entry.confidence}/10] ${entry.type}/${entry.key}`);
+    const baseline = mintRichLearn({
+      cwd,
+      key: entry.key,
+      insight: entry.insight,
+      now: deps.now,
+      output: print,
+    });
+    if (baseline !== 0) return exit(baseline);
+    return 0;
   } catch (err) {
-    console.error(`  ✗ ${err.message}`);
-    printLearnLogSchema();
-    process.exit(1);
+    error(`  ✗ ${err.message}`);
+    printLearnLogSchema(error);
+    return exit(1);
   }
 }
 
@@ -279,12 +424,14 @@ function logDirect(jsonStr) {
  * Harvest learnings from journal Notes sections.
  * Scans recent journals for lines that look like insights.
  */
-function harvestFromJournals() {
-  const atrisDir = path.join(process.cwd(), 'atris');
+function harvestFromJournals(deps = {}) {
+  const print = typeof deps.output === 'function' ? deps.output : (line = '') => console.log(line);
+  const cwd = deps.cwd || process.cwd();
+  const atrisDir = path.join(cwd, 'atris');
   const logsDir = path.join(atrisDir, 'logs');
 
   if (!fs.existsSync(logsDir)) {
-    console.log('  No journals found.');
+    print('  No journals found.');
     return;
   }
 
@@ -309,7 +456,7 @@ function harvestFromJournals() {
       const lines = notesMatch[1].trim().split('\n').filter(l => l.startsWith('- '));
       for (const line of lines) {
         // Strip bullet and optional timestamp prefix
-        const insight = line.replace(/^- (\d{2}:\d{2} — )?/, '').trim();
+        const insight = line.replace(/^- (\d{2}:\d{2} \u2014 )?/, '').trim();
         if (insight.length > 10) {
           candidates.push({ insight, source: path.basename(logPath) });
         }
@@ -318,10 +465,10 @@ function harvestFromJournals() {
   }
 
   if (candidates.length === 0) {
-    console.log('');
-    console.log('  No harvestable notes found in recent journals.');
-    console.log('  Add notes during "atris review" or write to ## Notes in your journal.');
-    console.log('');
+    print('');
+    print('  No harvestable notes found in recent journals.');
+    print('  Add notes during "atris review" or write to ## Notes in your journal.');
+    print('');
     return;
   }
 
@@ -331,31 +478,38 @@ function harvestFromJournals() {
   const fresh = candidates.filter(c => !existingInsights.has(c.insight.toLowerCase()));
 
   if (fresh.length === 0) {
-    console.log('');
-    console.log(`  Scanned ${candidates.length} journal notes — all already captured.`);
-    console.log('');
+    print('');
+    print(`  Scanned ${candidates.length} journal notes, all already captured.`);
+    print('');
     return;
   }
 
-  console.log('');
-  console.log(`  Found ${fresh.length} new ${fresh.length === 1 ? 'note' : 'notes'} to harvest:`);
-  console.log('');
+  print('');
+  print(`  Found ${fresh.length} new ${fresh.length === 1 ? 'note' : 'notes'} to harvest:`);
+  print('');
   for (let i = 0; i < fresh.length; i++) {
     const c = fresh[i];
     const isPitfall = /^(don't|never|avoid|watch out|careful)/i.test(c.insight);
     const type = isPitfall ? 'pitfall' : 'pattern';
     const key = c.insight.toLowerCase().replace(/[^a-z0-9\s]/g, '').split(/\s+/).slice(0, 4).join('-');
-    console.log(`  ${i + 1}. [${type}] ${c.insight}`);
-    console.log(`     from: ${c.source}`);
+    print(`  ${i + 1}. [${type}] ${c.insight}`);
+    print(`     from: ${c.source}`);
 
     try {
-      addLearning({ type, key, insight: c.insight, confidence: 6, source: 'review', files: [] });
-      console.log(`     ✓ saved [6/10]`);
+      const entry = addLearning({ type, key, insight: c.insight, confidence: 6, source: 'review', files: [] });
+      print(`     ✓ saved [6/10]`);
+      mintRichLearn({
+        cwd,
+        key: entry.key,
+        insight: entry.insight,
+        now: deps.now,
+        output: print,
+      });
     } catch (err) {
-      console.log(`     ✗ ${err.message}`);
+      print(`     ✗ ${err.message}`);
     }
   }
-  console.log('');
+  print('');
 }
 
 /**
@@ -375,10 +529,10 @@ function showLearnHelp() {
   console.log('');
   console.log('  Commands:');
   console.log('    (none)     Show recent learnings');
-  console.log('    add        Add a learning interactively');
-  console.log('    log <json> Add programmatically (for agents)');
+  console.log('    add        Add a learning interactively. A rich insight mints one apply plus a failing measure.py. A thin insight prints check: fill this.');
+  console.log('    log <json> Add programmatically (for agents). A rich insight (number or named mechanism) mints one apply plus a failing measure.py. A thin insight prints check: fill this.');
   console.log('    search <q> Search learnings by keyword');
-  console.log('    harvest    Extract learnings from journal Notes');
+  console.log('    harvest    Extract learnings from journal Notes. A rich insight mints one apply plus a failing measure.py. A thin insight prints check: fill this.');
   console.log('    prune      Check for stale/contradictory entries');
   console.log('    stats      Show learning statistics');
   console.log('    export     Export as markdown');
@@ -437,5 +591,17 @@ function learnAtris(subcommand, ...args) {
 }
 
 learnAtris.getLearningCount = getLearningCount;
+learnAtris.learnExperimentSlug = learnExperimentSlug;
+learnAtris.learnExperimentRel = learnExperimentRel;
+learnAtris.learnApplyRel = learnApplyRel;
+learnAtris.learnLessonFromText = learnLessonFromText;
+learnAtris.saveRichLearn = saveRichLearn;
+learnAtris.ensureLearnApply = ensureLearnApply;
+learnAtris.mintRichLearn = mintRichLearn;
+learnAtris.commitAddedLearning = commitAddedLearning;
+learnAtris.commitReviewLearning = commitReviewLearning;
+learnAtris.reviewLearningKey = reviewLearningKey;
+learnAtris.harvestFromJournals = harvestFromJournals;
+learnAtris.logDirect = logDirect;
 
 module.exports = learnAtris;

package/commands/lesson.js

@@ -26,7 +26,7 @@ function tagLessonResolvedInMd(cwd, slug) {
     if (!m || m[1] !== slug) continue;
     if (/\[resolved\]/i.test(lines[i])) continue; // already tagged
     lines[i] = lines[i].replace(
-      /(\*\*\[\d{4}-\d{2}-\d{2}\]\s+[\w-]+\*\*\s*[—-]\s*(?:pass|fail)?\s*[—-]?\s*)/,
+      /(\*\*\[\d{4}-\d{2}-\d{2}\]\s+[\w-]+\*\*\s*[\u2014-]\s*(?:pass|fail)?\s*[\u2014-]?\s*)/,
       '$1[resolved] '
     );
     changed = true;
@@ -46,7 +46,7 @@ function tagLessonResolvedInMd(cwd, slug) {
  * and trustworthy.
  *
  * Only detector-backed `fail` lessons self-retire. Prose-only lessons (no
- * detector) and `observed` process rules are never auto-resolved — they have
+ * detector) and `observed` process rules are never auto-resolved, they have
  * no falsifiable pass state.
  *
  * @param {string} cwd

package/commands/log.js

@@ -119,7 +119,7 @@ function logAtris() {
   }
 
   console.log(`┌─────────────────────────────────────────────────────────┐`);
-  console.log(`│ Daily Log — ${dateFormatted}              [type "exit" to quit] │`);
+  console.log(`│ Daily Log, ${dateFormatted}              [type "exit" to quit] │`);
   console.log(`└─────────────────────────────────────────────────────────┘`);
   console.log('');
 

package/commands/loops.js

@@ -308,7 +308,7 @@ function auditLoops(cwd = process.cwd()) {
     console.log('No atris/loops directory found.');
     console.log('Run: atris loops init');
     console.log('');
-    console.log('SELF-IMPROVING: NOT YET — 1 open');
+    console.log('SELF-IMPROVING: NOT YET, 1 open');
     return 1;
   }
 
@@ -320,7 +320,7 @@ function auditLoops(cwd = process.cwd()) {
     console.log('No loop files found in atris/loops.');
     console.log('Run: atris loops init');
     console.log('');
-    console.log('SELF-IMPROVING: NOT YET — 1 open');
+    console.log('SELF-IMPROVING: NOT YET, 1 open');
     return 1;
   }
 
@@ -352,7 +352,7 @@ function auditLoops(cwd = process.cwd()) {
     console.log('SELF-IMPROVING: YES');
     return 0;
   }
-  console.log(`SELF-IMPROVING: NOT YET — ${open} open`);
+  console.log(`SELF-IMPROVING: NOT YET, ${open} open`);
   return 1;
 }
 
@@ -382,7 +382,7 @@ function showLoopsHelp() {
 }
 
 function loopsCommand(subcommand, ...args) {
-  // `loops <sub> --help` is a help request, not a run — tick/start/stop/init
+  // `loops <sub> --help` is a help request, not a run, tick/start/stop/init
   // mutate loop state, so never execute a subcommand just to show usage.
   if (subcommand === '--help' || subcommand === '-h' || subcommand === 'help'
       || args.includes('--help') || args.includes('-h')) {