Skip to content

sno-ai/sno-station-skills / skills/R-recursive-self-improvement/rem-reflect/skill

rem-reflect

Verified

Self Learning from this machine's Claude Code, Codex, Hermes, OpenClaw and Cursor sessions. Decide skill changes and lessons with accept/reject/tbd; recall lessons at session start.

FileKindSize
SKILL.mdskill md14.1 KB
references/labeler.mdmarkdown1.2 KB
references/labeler.schema.jsonconfig1.7 KB
references/local-settings.jsonconfig126 B
references/local-writer.schema.jsonconfig2.3 KB
references/proposal.schema.jsonconfig3.2 KB
references/render.jsonconfig245 B
references/signals.jsonconfig71 B
references/text.jsonconfig4.0 KB
scripts/adopt.test.tsscript13.0 KB
scripts/adopt.tsscript14.3 KB
scripts/agent-sessions.tsscript9.1 KB
scripts/allowance-fallback.test.tsscript16.0 KB
scripts/allowance-request-isolation.test.tsscript7.1 KB
scripts/backend.tsscript9.1 KB
scripts/calls.tsscript8.6 KB
scripts/catalogue-cloud.test.tsscript1.5 KB
scripts/catalogue.tsscript3.2 KB
scripts/chunk.tsscript2.1 KB
scripts/cloud-apply.test.tsscript25.2 KB
scripts/cloud-batch.test.tsscript11.2 KB
scripts/cloud-day.test.tsscript6.8 KB
scripts/cloud-verdict.test.tsscript12.1 KB
scripts/cloud-wait.test.tsscript1.3 KB
scripts/cloud.tsscript24.4 KB
scripts/config.tsscript8.1 KB
scripts/cursor.test.tsscript16.1 KB
scripts/cursor.tsscript6.7 KB
scripts/evidence.tsscript1.5 KB
scripts/first-message.test.tsscript10.3 KB
scripts/harvest.test.tsscript16.5 KB
scripts/harvest.tsscript22.6 KB
scripts/hermes-openclaw.test.tsscript25.6 KB
scripts/identity.test.tsscript3.3 KB
scripts/identity.tsscript3.5 KB
scripts/installed-roots.test.tsscript11.0 KB
scripts/journey-adopt-lesson.test.tsscript4.1 KB
scripts/journey-ops.test.tsscript8.0 KB
scripts/labeler.test.tsscript3.6 KB
scripts/labeler.tsscript9.5 KB
scripts/ledger.tsscript2.1 KB
scripts/lessons.tsscript4.7 KB
scripts/local-filter.test.tsscript3.9 KB
scripts/local-first-output.test.tsscript23.5 KB
scripts/local-settings.tsscript1.4 KB
scripts/local-writer.tsscript12.7 KB
scripts/login-in-place.test.tsscript5.8 KB
scripts/model-json.tsscript4.1 KB
scripts/no-network.test.tsscript5.0 KB
scripts/observe.tsscript1.4 KB
scripts/page-journey.test.tsscript6.7 KB
scripts/pages.test.tsscript4.1 KB
scripts/pages.tsscript4.8 KB
scripts/proposer-loop.test.tsscript1.5 KB
scripts/proposer-validate.test.tsscript9.1 KB
scripts/proposer.tsscript8.7 KB
scripts/recall-hook.test.tsscript20.9 KB
scripts/recall.test.tsscript31.4 KB
scripts/recall.tsscript18.2 KB
scripts/reflect.test.tsscript9.3 KB
scripts/reflect.tsscript14.3 KB
scripts/rem-reflectexecutablescript823 B
scripts/rem-reflect.tsscript17.8 KB
scripts/render-chunk.test.tsscript7.2 KB
scripts/render.tsscript9.7 KB
scripts/report.tsscript8.2 KB
scripts/run-status.test.tsscript19.1 KB
scripts/sampling.test.tsscript2.1 KB
scripts/sampling.tsscript915 B
scripts/selftest-guard.test.tsscript4.2 KB
scripts/selftest/bin/claudeexecutablescript94 B
scripts/selftest/bin/codexexecutablescript93 B
scripts/selftest/bin/shim-core.cjsscript4.6 KB
scripts/selftest/bin/snoexecutablescript5.7 KB
scripts/selftest/fixtures/hermes-session-export.jsonlother1.5 KB
scripts/selftest/fixtures/openclaw-events.jsonlother3.7 KB
scripts/selftest/fixtures/verdict-traces.jsonconfig16.6 KB
scripts/selftest/journey-e2e.shexecutablescript1.4 KB
scripts/selftest/journey.mjsscript9.5 KB
scripts/selftest/observe-journey.mjsscript12.5 KB
scripts/selftest/run-selftest.shexecutablescript7.0 KB
scripts/selftest/spawn-python.mjsexecutablescript765 B
scripts/session.test.tsscript5.2 KB
scripts/session.tsscript251 B
scripts/signal-local.test.tsscript7.0 KB
scripts/skill-impact.test.tsscript6.2 KB
scripts/station-settings.test.tsscript13.6 KB
scripts/store-memory.test.tsscript3.4 KB
scripts/store.tsscript7.7 KB
scripts/test-helpers.tsscript15.3 KB
scripts/text.tsscript760 B
scripts/trigger.test.tsscript3.6 KB
scripts/trigger.tsscript2.5 KB
scripts/verdicts.test.tsscript8.1 KB
scripts/verdicts.tsscript8.0 KB

scripts/page-journey.test.ts

View on GitHub
import { test } from 'node:test';
import assert from 'node:assert/strict';
import { chmodSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
import { join } from 'node:path';
import { run } from './rem-reflect.ts';
import { readPages } from './pages.ts';
import { commands } from './config.ts';
import type { Config } from './config.ts';
import {
  hashListing, tmp, fixtureCheckout, fixtureConfig, makeStore, FixtureBackend, writeStationSettings,
  writeClaudeSession, claudeUser, claudeAssistant, writeCodexSession, codexMeta, codexUser, codexAssistant,
} from './test-helpers.ts';

const NOW = new Date('2026-09-08T00:00:00Z');
const MT = new Date('2026-09-07T00:00:00Z').getTime();
function cfg(): Config { return fixtureConfig({ claude_root: tmp('c'), codex_root: tmp('x') }); }
function bothHalves(config: Config, cwd = '/n'): void {
  writeClaudeSession(config.claude_root, 'proj', 'cc', [claudeUser(cwd, 'cc', 'do it'), claudeAssistant(cwd, 'cc', [{ type: 'text', text: 'ok' }])], MT);
  writeCodexSession(config.codex_root, 'cx', [codexMeta('cx', cwd), codexUser('do it'), codexAssistant('ok')], MT);
}
function cloudPageReply(t: import('node:test').TestContext): void {
  const bin = tmp('cloud-page-cli');
  const cli = join(bin, 'sno');
  writeFileSync(cli, [
    '#!/usr/bin/env node',
    "const fs = require('node:fs');",
    "const args = process.argv.slice(2).join(' ');",
    "if (args === 'station consent --json') { console.log(JSON.stringify({ consent: 'full' })); process.exit(0); }",
    "if (args !== 'rem judge --json') process.exit(2);",
    "const batch = JSON.parse(fs.readFileSync(0, 'utf8'));",
    'const halves = batch.halves.map(half => ({',
    '  harness: half.harness, attention: [], lessons: [], proposals: [], read_judgments: [],',
    "  log_entry: 'Grounded page returned',",
    '  pages: half.sessions.map(session => {',
    "    const line = session.chunks[0].text.split('\\n').find(text => /^\\d+: /.test(text));",
    "    if (!line) throw new Error('uploaded chunk has no numbered line');",
    "    const lineNumber = Number(line.split(':')[0]);",
    "    const pageId = '20260908-' + session.trace_id.replace(/[^a-zA-Z0-9_-]/g, '-');",
    "    return { judgment_id: 'judgment-' + pageId, page: { page_id: pageId, summary: 'Grounded ' + session.trace_id, class: 'EXECUTION_LAPSE',",
    "      root_cause: { subject: 'session', relation: 'shows', fact: line, valid_at: '2026-09-08', evidence_pages: [], evidence_traces: [session.trace_id] },",
    "      fix: 'Read the cited line', scenario: { task_type: 'repair', trigger: 'observed trace', tools: [] },",
    "      skills_used: [], skill_target: null, knowledge_used: [], outcome: session.local_outcome, agent_id: half.harness,",
    "      project_id: session.project_id, user_id: session.user_id, evidence: [],",
    '      citations: [{ trace_id: session.trace_id, line_start: lineNumber, line_end: lineNumber, quote: line }],',
    "      counter_examples: 'not searched', superseded: false, body: 'Evidence: ' + line, count: 1,",
    '      task_ids: [session.session_id], last_seen: new Date(session.source_mtime_ms).toISOString(), skills_observed: session.skills_loaded } };',
    '  }),',
    '}));',
    'console.log(JSON.stringify({schema_version:1,run_id:batch.run_id,history_acknowledged:true,history_links:[],halves}));',
  ].join('\n') + '\n');
  chmodSync(cli, 0o755);
  const originalPath = process.env.PATH;
  process.env.PATH = `${bin}:${originalPath ?? ''}`;
  t.after(() => { if (originalPath === undefined) delete process.env.PATH; else process.env.PATH = originalPath; });
  // Only the enhanced mode writes the cloud's pages into the local store.
  const originalProfile = process.env.SNO_PROFILE_DIR;
  process.env.SNO_PROFILE_DIR = writeStationSettings('rem-enhanced');
  t.after(() => { if (originalProfile === undefined) delete process.env.SNO_PROFILE_DIR; else process.env.SNO_PROFILE_DIR = originalProfile; });
}
function reportOf(store: string): string {
  const runId = readdirSync(join(store, 'staging')).filter(n => /^\d/.test(n)).sort().pop()!;
  return readFileSync(join(store, 'staging', runId, 'REPORT.md'), 'utf8');
}
// Every file with the given name anywhere under root (used to prove a name never appears).
function filesNamed(root: string, name: string): string[] {
  const out: string[] = [];
  const walk = (dir: string): void => {
    for (const entry of readdirSync(dir, { withFileTypes: true })) {
      const path = join(dir, entry.name);
      if (entry.isDirectory()) walk(path);
      else if (entry.name === name) out.push(path);
    }
  };
  walk(root);
  return out;
}

test('a cloud-authored page carries a cited root cause and is listed in the ordinary report', t => {
  cloudPageReply(t);
  const config = cfg();
  const store = makeStore(config);
  bothHalves(config);
  const r = run(store, NOW, 'u', new FixtureBackend());
  assert.equal(r.code, 0, r.lines.join('\n'));
  const created = readPages(store);
  assert.ok(created.length >= 1, 'a page was written');
  const rc = created[0].root_cause;
  for (const field of ['subject', 'relation', 'fact', 'valid_at', 'evidence_pages', 'evidence_traces'] as const) {
    assert.ok(field in rc && rc[field] !== undefined, `root_cause carries ${field}`);
  }
  const report = reportOf(store);
  assert.match(report, /Pages written: 2/, 'the report counts both cloud pages');
  assert.ok(report.includes(`${created[0].page_id}: ${created[0].summary}`), 'the report names the saved page');
  assert.equal(created[0].citations[0].trace_id, 'cc.v1', 'the stored page cites the uploaded trace');
});

test('a cloud-page day keeps the local page store without a separate fact-status ledger', t => {
  cloudPageReply(t);
  const config = cfg();
  const store = makeStore(config);
  bothHalves(config);
  const r = run(store, NOW, 'u', new FixtureBackend());
  assert.equal(r.code, 0, r.lines.join('\n'));
  assert.deepEqual(filesNamed(store, 'facts.jsonl'), [], 'no facts.jsonl exists anywhere in the store');
  assert.ok(!commands.includes('fact'), 'there is no command that changes a fact status');
});

test('a cloud-page run leaves the source checkout and root CLAUDE.md byte-identical', t => {
  cloudPageReply(t);
  const config = cfg();
  const store = makeStore(config);
  const project = fixtureCheckout();
  bothHalves(config, project);
  writeFileSync(join(project, 'CLAUDE.md'), '# fixture repo rules\n');
  const before = hashListing(project);
  const r = run(store, NOW, 'u', new FixtureBackend());
  assert.equal(r.code, 0, r.lines.join('\n'));
  assert.ok(readPages(store).length >= 1, 'the cloud reply was applied before comparing the checkout');
  assert.equal(hashListing(project), before, 'the project directory (including CLAUDE.md) is untouched by a page-creating run');
});
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall