@jossuealcala/madre 0.3.2 → 0.4.0

package/src/setup.mjs

@@ -103,7 +103,7 @@ export function renderReport({ agents, probes, projectRoot, config = {}, palette
   const verdict = online.length
     ? `${online.length} OF ${agents.length} AGENTS ONLINE${local ? ' · @MADRE LOCAL' : ''}. ROOM CAN OPEN.`
     : local ? 'NO CLI ONLINE · @MADRE (LOCAL) IS. THE ROOM CAN OPEN WITH MEMORY ALONE; CONNECT A CLI TO WORK ON FILES.'
-      : `NO AGENT ONLINE. CONFIGURE ONE TO OPEN THE ROOM.`;
+      : `NO AGENT ONLINE. THE ROOM OPENS ANYWAY AND WALKS YOU THROUGH CONNECTING ONE.`;
   lines.push('');
   lines.push(`  ${p.phosphor('MOTHER')}${p.dim(' ›')} ${p.bold(verdict)}`);
   return lines.join('\n');

package/src/updates.mjs

@@ -38,6 +38,19 @@ export function updateCommand(install, name, version = 'latest') {
   }
 }
 
+// One shell line that installs the version and starts the same room on the same port.
+// The room's own process runs it detached after closing its listener, then exits.
+const shq = (value) => `'${String(value).replace(/'/g, `'\\''`)}'`;
+export function applyCommand({ install, name, version, port, projectRoot }) {
+  const start = `start --no-open --port ${Number(port) || 4317} --project ${shq(projectRoot)}`;
+  switch (install) {
+    case 'npx': return `exec npx -y ${name}@${version} ${start}`;
+    case 'project': return `npm install ${name}@${version} --no-fund --no-audit && exec npx --no ${name.split('/').pop()} ${start}`;
+    case 'global': return `npm install -g ${name}@${version} --no-fund --no-audit && exec ${name.split('/').pop()} ${start}`;
+    default: return null;   // source: the human pulls
+  }
+}
+
 export function releaseUrl(repository, version) {
   const url = String(repository?.url ?? repository ?? '').replace(/^git\+/, '').replace(/\.git$/, '');
   return url ? `${url}/releases/tag/v${version}` : null;
@@ -48,14 +61,16 @@ async function readCache(file) {
 }
 
 // The check. `enabled: false` answers from the cache only and never touches the network.
-export async function checkForUpdate({ name, current, cacheFile, fetchImpl = globalThis.fetch, now = Date.now(), ttlMs = UPDATE_TTL_MS, enabled = true, force = false, timeoutMs = 4000 } = {}) {
+// `cacheOnly` answers from what is already on disk and never touches the network: it is what a
+// screen asks for, so opening MODULES never waits on a registry.
+export async function checkForUpdate({ name, current, cacheFile, fetchImpl = globalThis.fetch, now = Date.now(), ttlMs = UPDATE_TTL_MS, enabled = true, force = false, cacheOnly = false, timeoutMs = 4000 } = {}) {
   const cached = cacheFile ? await readCache(cacheFile) : null;
   const fresh = cached && cached.name === name && Number.isFinite(cached.checkedAt) && now - cached.checkedAt < ttlMs;
   let latest = cached?.name === name ? cached.latest ?? null : null;
   let checkedAt = cached?.name === name ? cached.checkedAt ?? null : null;
   let source = latest ? 'cache' : 'none';
   let error = null;
-  if (enabled && (force || !fresh)) {
+  if (enabled && !cacheOnly && (force || !fresh)) {
     try {
       const response = await fetchImpl(`${REGISTRY}/${encodeURIComponent(name).replace('%40', '@')}/latest`, { headers: { accept: 'application/json' }, signal: AbortSignal.timeout(timeoutMs) });
       if (!response.ok) throw new Error(`registry HTTP ${response.status}`);

package/src/usage-sentinel.mjs

@@ -1,3 +1,5 @@
+import { t } from './i18n.mjs';
+
 const severity = { normal: 0, warning: 1, critical: 2, exhausted: 3 };
 
 export function classifyUsagePercent(value) {
@@ -40,17 +42,19 @@ export class UsageSentinel {
     }
     if (level === 'normal' || severity[level] <= severity[previous]) return null;
 
+    // Said in the room's language: this is MADRE's own voice, not a CLI's output. What is
+    // already in the ledger keeps the words it was written with.
     const destination = alternatives.length
-      ? ` Continue with ${alternatives.map((item) => `@${item}`).join(' or ')}.`
-      : ' Prepare a handoff before the current agent becomes unavailable.';
+      ? t(' Continue with {who}.', { who: alternatives.map((item) => `@${item}`).join(t(' or ')) })
+      : t(' Prepare a handoff before the current agent becomes unavailable.');
     const label = source === 'room-soft-budget'
-      ? 'local room token budget (MADRE\'s own soft limit, not the provider\'s quota; cache reads count a tenth)'
+      ? t("local room token budget (MADRE's own soft limit, not the provider's quota; cache reads count a tenth)")
       : source === 'test-simulation'
-        ? 'simulated provider usage window'
-        : 'provider usage window';
+        ? t('simulated provider usage window')
+        : t('provider usage window');
     const usage = byProjection
-      ? `has used ${Math.round(percent)}% of its ${label} and another turn like the last one would reach ${Math.round(projected)}%.`
-      : `has used ${Math.round(percent)}% of its ${label}.`;
+      ? t('has used {pct}% of its {label} and another turn like the last one would reach {projected}%.', { pct: Math.round(percent), label, projected: Math.round(projected) })
+      : t('has used {pct}% of its {label}.', { pct: Math.round(percent), label });
     return {
       agent,
       usedPercent: percent,
@@ -59,7 +63,8 @@ export class UsageSentinel {
       source,
       resetAt,
       alternatives,
-      message: `MADRE ${level}: @${agent} ${usage}${destination}`,
+      // The level is a word on a screen, so it is said in the room's language too.
+      message: `MADRE ${t(level)}: @${agent} ${usage}${destination}`,
     };
   }
 }

package/src/verdict.mjs

@@ -0,0 +1,74 @@
+// One sentence about where a room stands, and one thing to do about it.
+//
+// Everything needed to say it was already being measured: six readings of what the archive is
+// made of, three tests of whether it works, the memories nothing has ever reached for, and the
+// questions the room cannot answer. What was missing was somebody deciding which of those matters
+// today. Nine numbers on a screen is not a verdict — it is homework.
+//
+// The order is the order a person should act in, and it is not negotiable by score: something the
+// room believes that is false outranks something the room has not learned yet, and both outrank
+// anything about size. Whatever is chosen, it is one thing, and it says where to go and do it.
+
+// Where to go and do it. These name places on the screen, so they are said in the room's
+// language and read at call time, not when this file is imported.
+import { t } from './i18n.mjs';
+
+export const WHERE = { nostromo: 'NOSTROMO', ask: 'NOSTROMO · ASK', room: 'THE ROOM', tests: 'THE THREE TESTS' };
+const where = (key) => t(WHERE[key]);
+
+export function verdictFor({ maturity = null, exams = {}, cold = null, asks = 0 } = {}) {
+  const consistency = exams.consistency ?? null;
+  const coverage = exams.coverage ?? null;
+  const match = exams.match ?? null;
+  const stage = maturity?.stage ?? null;
+  const weakest = maturity?.signals?.find((signal) => signal.id === maturity.weakest) ?? null;
+
+  // 1 · Something false, first. An archive that contradicts itself teaches the contradiction.
+  if (consistency?.ran && consistency.open > 0) {
+    return {
+      headline: stage?.label ?? null,
+      says: consistency.says,
+      next: { text: t('Settle the {n} contradictions EYECAT is holding. Until they are settled, everything built on this archive inherits them.', { n: consistency.open }), where: where('nostromo') },
+    };
+  }
+
+  // 2 · Then what it cannot answer. The room already wrote the questions; pointing at them is
+  // more use than repeating the number.
+  if (coverage?.ran && !coverage.passed) {
+    return {
+      headline: stage?.label ?? null,
+      says: coverage.says,
+      next: asks
+        ? { text: t('Answer the {n} questions the room wrote for itself. They are the holes this test is finding.', { n: asks }), where: where('ask') }
+        : { text: t('Keep working in the room. The archive fills where the work happens, and this test measures exactly that.'), where: where('room') },
+    };
+  }
+
+  // 3 · Then whatever the readings say is thinnest. That advice is already written where the
+  // reading is taken, so it is quoted rather than invented here.
+  if (weakest && weakest.value < 0.6) {
+    return { headline: stage?.label ?? null, says: `${weakest.label.toLowerCase()}: ${weakest.detail}.`, next: { text: weakest.next, where: where('room') } };
+  }
+
+  // 4 · And when nothing is wrong, the only honest thing left is the test nobody has run.
+  if (!match?.ran) {
+    return {
+      headline: stage?.label ?? null,
+      says: coverage?.ran ? coverage.says : t('Nothing contradicts anything and the archive answers what this room asks.'),
+      next: { text: t('Run the third test: it puts real questions from this room back to the local model and says whether it lands where the agents landed.'), where: where('tests') },
+    };
+  }
+
+  const dead = cold?.count ?? 0;
+  return {
+    headline: stage?.label ?? null,
+    says: match.passed
+      ? `${match.says} ${t('This room is ready to be worked in with the local model.')}`
+      : match.says,
+    next: match.passed
+      ? (dead
+        ? { text: t('Nothing is wrong. {n} memories have had every chance and were never the answer: look at them and decide.', { n: dead }), where: where('nostromo') }
+        : { text: t('Nothing to fix. Keep using the room; the archive grows where the work is.'), where: where('room') })
+      : { text: t('The local model does not land where the agents land yet. Keep the archive growing and run this test again in a week.'), where: where('tests') },
+  };
+}

package/src/ashcode.mjs

@@ -1,64 +0,0 @@
-// AshCode / ORDER 937 is a deliberately conservative, local text transform.
-// It is lossy, not encryption or a model tokenizer. Keep the original in the
-// event log so the human can inspect what was actually abbreviated.
-
-const SPANISH = /\b(?:el|la|los|las|un|una|unos|unas|para|proyecto|página|pagina|imagen|crear|genera|dentro)\b/gi;
-const ENGLISH = /\b(?:the|a|an|for|project|page|image|create|generate|inside|please)\b/gi;
-const PROTECTED = /"[^"\n]*"|'[^'\n]*'|@[\p{L}\p{N}_-]+|![\p{L}\p{N}_./:-]+/gu;
-const RISKY = /```|`|https?:\/\/|\n|[{}<>]|\b(?:no|nunca|sin|excepto|not|never|without|except)\b|\d|(?:^|\s)(?:\.{1,2}\/|\/|[\w.-]+\/)[\w./-]+/iu;
-
-export function ashLanguage(input) {
-  const text = String(input ?? '');
-  const es = (text.match(SPANISH) ?? []).length + (/[áéíóúñ¿¡]/i.test(text) ? 2 : 0);
-  const en = (text.match(ENGLISH) ?? []).length;
-  if (es === en || Math.max(es, en) < 2) return null;
-  return es > en ? 'es' : 'en';
-}
-
-export function compressAshCode(input) {
-  const original = String(input ?? '').trim();
-  const unchanged = (reason) => ({ text: original, original, applied: false, reason, originalChars: original.length, encodedChars: original.length, language: null });
-  if (!original) return unchanged('empty');
-  if (RISKY.test(original) || /(?:^|\s)\/[A-Za-z_.]/.test(original)) return unchanged('protected-structure');
-  const language = ashLanguage(original);
-  if (!language) return unchanged('language-uncertain');
-
-  const protectedSpans = [];
-  let text = original.replace(PROTECTED, (span) => {
-    const index = protectedSpans.push(span) - 1;
-    return `\uE000${index}\uE001`;
-  });
-
-  if (language === 'es') {
-    text = text
-      .replace(/\b(?:yo\s+)?(?:quiero|necesito|quisiera)\s+que\s+/gi, '')
-      .replace(/\bme gustaría que\s+/gi, '')
-      .replace(/\bpor favor\b[,.]?\s*/gi, '')
-      .replace(/\bdentro del?\b/gi, 'en')
-      .replace(/\b(?:el|la|los|las|un|una|unos|unas)\s+/g, '')
-      .replace(/\bhome de (?:la )?(?:página|pagina) principal\b/gi, 'home');
-  } else {
-    text = text
-      .replace(/\bI (?:would like|want|need) you to\s+/gi, '')
-      .replace(/\b(?:could|can) you\s+/gi, '')
-      .replace(/\bplease\b[,.]?\s*/gi, '')
-      .replace(/\binside of\b/gi, 'in')
-      .replace(/\b(?:the|a|an)\s+/g, '')
-      .replace(/\bhome page of (?:the )?main (?:web)?site\b/gi, 'home page');
-  }
-
-  text = text
-    .replace(/\b([\p{L}]+)(?:\s+\1)+\b/giu, '$1')
-    .replace(/\s+([,.;:!?])/g, '$1')
-    .replace(/\s{2,}/g, ' ')
-    .trim()
-    .replace(/[.。]$/, '');
-  text = text.replace(/\uE000(\d+)\uE001/g, (_, index) => protectedSpans[Number(index)]);
-  const encoded = `ASH937/${language}: ${text}`;
-  // A shorter character string is not proof of fewer model tokens. Refuse
-  // marginal rewrites because the prefix itself may erase any gain.
-  if (encoded.length > original.length - 8) return unchanged('no-safe-gain');
-  return { text: encoded, original, applied: true, reason: null, originalChars: original.length, encodedChars: encoded.length, language };
-}
-
-export const ASHCODE_BETA_WARNING = 'AshCode beta: abbreviation can change meaning or cause errors. Review the original before relying on a result; character reduction is not verified token savings.';

package/src/modules/ashcode.mjs

@@ -1,28 +0,0 @@
-// AshCode: opt-in abbreviation of prompts and replies. Beta, so the switch asks
-// for confirmation and the room says so every time it turns on.
-
-import { defineModule } from './sdk.mjs';
-
-const WARNING = 'Beta: abbreviation may alter meaning or introduce errors. Review the original. Character reduction is not verified token savings.';
-
-export default defineModule({
-  id: 'ashcode',
-  configKey: 'ashCode',
-  name: 'AshCode',
-  vendor: 'MADRE · ORDER 937',
-  version: '0.1.0-beta',
-  summary: 'Opt-in Spanish/English prompt and reply abbreviation. Keeps the original visible; may change meaning. Shorter characters do not guarantee fewer provider tokens.',
-  creates: ['nothing in the project', 'an ashCode switch in ~/.pulse/config.json', 'original and abbreviated text in the room event log when applied'],
-  card: 'ashcode',
-  confirm: 'AshCode is beta and can change meaning. Send { "confirm": true } to enable it.',
-  toggledEvent: { beta: true },
-  toggledBody: () => ({ beta: true, warning: 'AshCode beta may alter meaning; review the original. Character reduction is not verified token savings.' }),
-  async status(ctx) {
-    return {
-      status: { installed: Boolean(ctx.settings.enabled), detail: ctx.settings.enabled ? 'on · beta · ORDER 937 available' : 'off · beta' },
-      install: { display: ctx.settings.enabled ? 'disable AshCode' : 'enable AshCode (config.json)', platforms: [] },
-      warning: WARNING,
-    };
-  },
-  async onToggle(ctx, enabled) { ctx.room.setAshCode(enabled); return null; },
-});