create-egregore 0.17.4 → 0.18.0

package/runtime/codex/bin/codex-skill-render.mjs

@@ -0,0 +1,315 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+
+const WIDTH = 72;
+
+function usage() {
+  console.error(`usage:
+  node bin/codex-skill-render.mjs classify-graph [--mode connected|local] [--attempt initial|retry] [file|-]
+  node bin/codex-skill-render.mjs activity-card [file|-]
+  node bin/codex-skill-render.mjs dashboard-card [file|-]
+  node bin/codex-skill-render.mjs handoff-card [file|-]`);
+  process.exit(2);
+}
+
+function readInput(file) {
+  if (!file || file === '-') {
+    return fs.readFileSync(0, 'utf8');
+  }
+  return fs.readFileSync(file, 'utf8');
+}
+
+function readJson(file) {
+  const raw = readInput(file).trim() || '{}';
+  try {
+    return JSON.parse(raw);
+  } catch (error) {
+    console.error(`invalid JSON${file ? ` in ${file}` : ''}: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+function parseFlags(args) {
+  const flags = {};
+  const rest = [];
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+    if (arg === '--mode' || arg === '--attempt') {
+      flags[arg.slice(2)] = args[i + 1];
+      i += 1;
+    } else {
+      rest.push(arg);
+    }
+  }
+  return { flags, rest };
+}
+
+function asArray(value) {
+  return Array.isArray(value) ? value : [];
+}
+
+function firstArray(data, paths) {
+  for (const p of paths) {
+    const value = p.split('.').reduce((acc, key) => (acc && acc[key] !== undefined ? acc[key] : undefined), data);
+    if (Array.isArray(value)) return value;
+  }
+  return [];
+}
+
+function valueOf(item, keys, fallback = '') {
+  for (const key of keys) {
+    if (item && item[key] !== undefined && item[key] !== null && String(item[key]).trim() !== '') {
+      return String(item[key]);
+    }
+  }
+  return fallback;
+}
+
+function truncate(value, max) {
+  const text = String(value || '').replace(/\s+/g, ' ').trim();
+  if (text.length <= max) return text;
+  return `${text.slice(0, Math.max(0, max - 3))}...`;
+}
+
+function padLine(left, right = '') {
+  const l = truncate(left, WIDTH - 4);
+  const r = truncate(right, WIDTH - 4);
+  const space = Math.max(1, WIDTH - 4 - l.length - r.length);
+  return `│ ${l}${' '.repeat(space)}${r} │`;
+}
+
+function topRule() {
+  return `┌${'─'.repeat(WIDTH - 2)}┐`;
+}
+
+function rule() {
+  return `├${'─'.repeat(WIDTH - 2)}┤`;
+}
+
+function bottomRule() {
+  return `└${'─'.repeat(WIDTH - 2)}┘`;
+}
+
+function graphFields(data) {
+  return {
+    status: data.graph_status || data.graphStatus || data.graph?.status || '',
+    reason: data.graph_reason || data.graphReason || data.graph?.reason || '',
+  };
+}
+
+function classifyGraph(data, options = {}) {
+  const mode = options.mode || data.mode || 'connected';
+  const attempt = options.attempt || 'initial';
+  const { status, reason } = graphFields(data);
+
+  if (mode === 'local') {
+    return {
+      status: 'local',
+      retry: false,
+      reason: reason || 'local_mode',
+      message: 'Local mode uses memory files as the source of truth.',
+    };
+  }
+
+  if (status === 'connected') {
+    return {
+      status: 'connected',
+      retry: false,
+      reason: '',
+      message: 'Graph connected.',
+    };
+  }
+
+  if (reason === 'unreachable' && attempt !== 'retry') {
+    return {
+      status: 'retry',
+      retry: true,
+      reason,
+      message: 'Connected-mode graph was unreachable; retry with network escalation.',
+    };
+  }
+
+  const finalReason = reason || status || 'offline';
+  return {
+    status: 'offline',
+    retry: false,
+    reason: finalReason,
+    message: `Graph offline (${finalReason}). Render filesystem fallback.`,
+  };
+}
+
+function renderActivity(data) {
+  const graph = classifyGraph(data, { mode: data.mode || 'connected', attempt: 'retry' });
+  const org = data.org || data.organization || 'Egregore';
+  const date = data.date || '';
+  const me = data.me?.github || data.me?.name || data.github_username || '';
+  const handoffs = firstArray(data, ['handoffs', 'pending_handoffs', 'me.handoffs', 'addressed_handoffs']);
+  const questions = firstArray(data, ['questions', 'pending_questions', 'me.questions']);
+  const prs = asArray(data.prs);
+  const mine = firstArray(data, ['local_sessions.my_sessions', 'my_sessions', 'sessions']);
+  const team = firstArray(data, ['local_sessions.team_sessions', 'team_sessions', 'team.sessions']);
+
+  const lines = [topRule(), padLine('ACTIVITY', [org, me, date].filter(Boolean).join(' · ')), rule()];
+  if (graph.status !== 'connected') {
+    lines.push(padLine(`graph: ${graph.status}`, graph.reason));
+    lines.push(rule());
+  }
+
+  lines.push(padLine('FOR YOU'));
+  if (questions.length === 0 && handoffs.length === 0) {
+    lines.push(padLine('nothing pending'));
+  } else {
+    questions.slice(0, 4).forEach((q) => {
+      lines.push(padLine(`? ${valueOf(q, ['from', 'author', 'asker'], 'someone')}: ${valueOf(q, ['topic', 'title', 'question'], 'question')}`));
+    });
+    handoffs.slice(0, 4).forEach((h) => {
+      lines.push(padLine(`> ${valueOf(h, ['author', 'from'], 'someone')}: ${valueOf(h, ['topic', 'title'], 'handoff')}`));
+    });
+  }
+
+  lines.push(rule());
+  lines.push(padLine('RECENT WORK'));
+  if (mine.length === 0) {
+    lines.push(padLine('no recent local sessions found'));
+  } else {
+    mine.slice(0, 5).forEach((s) => {
+      lines.push(padLine(`${valueOf(s, ['date', 'when'], '')} ${valueOf(s, ['topic', 'title', 'branch'], 'session')}`, valueOf(s, ['type', 'status', 'duration'], '')));
+    });
+  }
+
+  if (team.length > 0 || prs.length > 0) {
+    lines.push(rule());
+    lines.push(padLine('AROUND'));
+    team.slice(0, 3).forEach((s) => {
+      lines.push(padLine(`${valueOf(s, ['author', 'name'], 'teammate')}: ${valueOf(s, ['topic', 'title', 'branch'], 'session')}`));
+    });
+    prs.slice(0, 3).forEach((pr) => {
+      lines.push(padLine(`#${valueOf(pr, ['number'], '')} ${valueOf(pr, ['title'], 'pull request')}`, valueOf(pr.author || {}, ['login', 'name'], '')));
+    });
+  }
+
+  lines.push(rule());
+  lines.push(padLine('Focus choices: handoffs, questions, recent work, dashboard, done'));
+  lines.push(bottomRule());
+  return lines.join('\n');
+}
+
+function humanTopic(session) {
+  const topic = valueOf(session, ['topic', 'title'], '');
+  if (topic) return topic;
+  const branch = valueOf(session, ['branch'], '');
+  if (branch && !['develop', 'main', 'master'].includes(branch)) {
+    return branch.replace(/^dev\/[^/]+\//, '').replace(/[-_]+/g, ' ');
+  }
+  return valueOf(session, ['id', 'date'], 'session');
+}
+
+function renderDashboard(data) {
+  const graph = classifyGraph(data, { mode: data.mode || 'connected', attempt: 'retry' });
+  const org = data.org || 'Egregore';
+  const date = data.date || '';
+  const me = data.me?.github || data.me?.name || data.github_username || '';
+  const current = data.current_session || {};
+  const sessions = firstArray(data, ['sessions', 'local_sessions.sessions']);
+  const todos = firstArray(data, ['todos', 'open_todos']);
+  const quests = firstArray(data, ['quests', 'active_quests']);
+  const handoffs = firstArray(data, ['handoffs', 'pending_handoffs']);
+  const threads = firstArray(data, ['open_threads', 'threads']);
+  const stats = data.stats || {};
+
+  const lines = [topRule(), padLine('DASHBOARD', [org, me, date].filter(Boolean).join(' · ')), rule()];
+  if (graph.status !== 'connected') {
+    lines.push(padLine(`graph: ${graph.status}`, graph.reason));
+    lines.push(rule());
+  }
+
+  lines.push(padLine(`* ${humanTopic(current) || '(starting...)'}`, 'active'));
+
+  if (threads.length > 0) {
+    lines.push(rule());
+    lines.push(padLine('PICK UP WHERE YOU LEFT OFF'));
+    threads.slice(0, 5).forEach((thread) => {
+      lines.push(padLine(`- ${valueOf(thread, ['text', 'thread', 'title', 'topic'], 'open thread')}`));
+    });
+  }
+
+  if (todos.length > 0) {
+    lines.push(rule());
+    lines.push(padLine(`OPEN TODOS (${todos.length})`));
+    todos.slice(0, 3).forEach((todo, index) => {
+      lines.push(padLine(`[${index + 1}] ${valueOf(todo, ['text', 'title'], 'todo')}`, valueOf(todo, ['status'], '')));
+    });
+  }
+
+  if (handoffs.length > 0) {
+    lines.push(rule());
+    lines.push(padLine(`HANDOFFS (${handoffs.length} pending)`));
+    handoffs.slice(0, 3).forEach((handoff) => {
+      lines.push(padLine(`${valueOf(handoff, ['author', 'from'], 'someone')}: ${valueOf(handoff, ['topic', 'title'], 'handoff')}`, valueOf(handoff, ['when', 'date'], '')));
+    });
+  }
+
+  lines.push(rule());
+  lines.push(padLine(`SESSIONS (${data.range_label || 'recent'})`));
+  if (sessions.length === 0) {
+    lines.push(padLine('No activity recorded yet'));
+  } else {
+    sessions.slice(0, 5).forEach((session) => {
+      lines.push(padLine(`${valueOf(session, ['date', 'when'], '')} ${humanTopic(session)}`, valueOf(session, ['status', 'type'], '')));
+    });
+  }
+
+  if (quests.length > 0) {
+    lines.push(rule());
+    lines.push(padLine(`QUESTS (${quests.length} active)`));
+    quests.slice(0, 3).forEach((quest) => {
+      lines.push(padLine(valueOf(quest, ['id', 'quest', 'slug', 'title'], 'quest'), valueOf(quest, ['status', 'summary'], '')));
+    });
+  }
+
+  lines.push(rule());
+  const total = stats.totalSessions ?? data.local_sessions?.session_count ?? sessions.length;
+  const wrapped = stats.wrappedSessions ?? sessions.filter((s) => valueOf(s, ['status', 'type'], '').includes('wrap')).length;
+  lines.push(padLine(`${total} sessions · ${wrapped}/${total} wrapped · ${stats.openTodos ?? todos.length} open todos`));
+  lines.push(padLine("What's next?"));
+  lines.push(bottomRule());
+  return lines.join('\n');
+}
+
+function renderHandoff(data) {
+  const file = data.file ? `memory/${data.file}` : '';
+  const statuses = [
+    data.graphStatus ? `graph=${data.graphStatus}` : '',
+    data.memoryStatus ? `memory=${data.memoryStatus}` : '',
+    data.notifyStatus ? `notify=${data.notifyStatus}` : '',
+  ].filter(Boolean).join(' · ');
+
+  const lines = [topRule(), padLine('HANDOFF', data.author || ''), rule()];
+  lines.push(padLine(`Topic: ${data.topic || '(untitled)'}`));
+  if (data.recipient) lines.push(padLine(`To: ${data.recipient}`));
+  if (file) lines.push(padLine(`Path: ${file}`));
+  if (data.artifactUrl) lines.push(padLine(`Link: ${data.artifactUrl}`));
+  if (statuses) lines.push(padLine(statuses));
+  lines.push(bottomRule());
+  return lines.join('\n');
+}
+
+const [command, ...rawArgs] = process.argv.slice(2);
+if (!command) usage();
+
+if (command === 'classify-graph') {
+  const { flags, rest } = parseFlags(rawArgs);
+  const data = readJson(rest[0]);
+  console.log(JSON.stringify(classifyGraph(data, flags)));
+} else if (command === 'activity-card') {
+  const data = readJson(rawArgs[0]);
+  console.log(renderActivity(data));
+} else if (command === 'dashboard-card') {
+  const data = readJson(rawArgs[0]);
+  console.log(renderDashboard(data));
+} else if (command === 'handoff-card') {
+  const data = readJson(rawArgs[0]);
+  console.log(renderHandoff(data));
+} else {
+  usage();
+}

package/runtime/codex/bin/codex-sync-skills.sh

@@ -0,0 +1,223 @@
+#!/bin/bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+CLAUDE_DIR="$SCRIPT_DIR/.claude/skills"
+CODEX_DIR="$SCRIPT_DIR/.codex/skills"
+CHECK=0
+
+NATIVE_SKILLS=(
+  activity
+  handoff
+  wrap
+  announce
+  harvest
+  the-spiral
+  dashboard
+  deep-reflect
+  quest
+  invite
+  ask
+  save
+)
+
+STRUCTURED_UX_SKILLS=(
+  activity
+  dashboard
+  handoff
+  wrap
+  todo
+  quest
+  project
+  issue
+  test
+  qa
+  checkup
+  infra
+  graph-maintain
+  telemetry-admin
+  waitlist
+  hosting
+  review-pr
+  triage
+  eval
+  eval-multiagent
+  summon
+  reflect
+  deep-reflect
+  archive
+  meeting
+  ingest-user-interview
+  harvest
+  tutorial
+  onboarding
+  emissary
+  launch-site
+  view
+  visual-explain
+  tui-design
+)
+
+GENERATED_MARKER='generated-by: bin/codex-sync-skills.sh'
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --check) CHECK=1; shift ;;
+    --help|-h)
+      echo "usage: bin/codex-sync-skills.sh [--check]"
+      exit 0
+      ;;
+    *) echo "unknown option: $1" >&2; exit 2 ;;
+  esac
+done
+
+is_native() {
+  local name="$1"
+  local native
+  for native in "${NATIVE_SKILLS[@]}"; do
+    [ "$name" = "$native" ] && return 0
+  done
+  return 1
+}
+
+is_structured_ux() {
+  local name="$1"
+  local structured
+  for structured in "${STRUCTURED_UX_SKILLS[@]}"; do
+    [ "$name" = "$structured" ] && return 0
+  done
+  return 1
+}
+
+skill_description() {
+  local file="$1"
+  awk '
+    NR == 1 && $0 == "---" { in_fm = 1; next }
+    in_fm && $0 == "---" { exit }
+    in_fm && /^description:/ {
+      sub(/^description:[[:space:]]*/, "")
+      gsub(/^"|"$/, "")
+      print
+      exit
+    }
+  ' "$file"
+}
+
+yaml_single_quote() {
+  local value="$1"
+  printf "'%s'" "$(printf '%s' "$value" | sed "s/'/''/g")"
+}
+
+render_adapter() {
+  local name="$1"
+  local source="$2"
+  local description="$3"
+  local structured="$4"
+  [ -n "$description" ] || description="Fallback Codex adapter for the Egregore ${name} workflow."
+  local description_yaml
+  description_yaml="$(yaml_single_quote "$description")"
+  cat <<EOF
+---
+name: ${name}
+description: ${description_yaml}
+---
+
+<!-- ${GENERATED_MARKER} -->
+
+# Egregore ${name} Adapter
+
+This is fallback coverage for a long-tail Egregore workflow that has not been
+ported to a hand-written Codex-native skill yet.
+
+Use the project shell and filesystem directly. Do not invoke Claude Code
+commands. Translate interactive choices to structured Codex question tooling
+when it is available; otherwise render compact numbered choices with an
+\`Other:\` option and wait for the user.
+
+EOF
+  if [ "$structured" = "1" ]; then
+    cat <<EOF
+## Structured UX parity
+
+This workflow has a Claude skill with user-visible structured output. After
+reading \`${source}\`, reproduce the same visible UX in Codex:
+
+- Preserve TUI boxes, markdown tables, rich cards, browser artifact rendering,
+  exact confirmation blocks, and "no preamble" rules from the source skill.
+- Use the source skill's frame width, section order, labels, status footer,
+  and examples as the contract for the final response.
+- Never replace a required box/table/card/artifact view with a prose summary
+  unless the user explicitly asks for a summary.
+- When the source says to output a TUI box directly, paste that box as the
+  visible response, preferably in a \`text\` fenced block.
+- Never show raw JSON, raw command output, or unformatted script output when
+  the source skill requires formatted status or rendered output.
+
+EOF
+  fi
+  cat <<EOF
+1. Read \`${source}\` for the workflow details.
+2. Run the referenced \`bin/\` scripts directly from Codex.
+3. Treat graph, publish, and notify steps as best-effort unless that workflow
+   explicitly says they are required.
+4. Keep local-mode behavior filesystem-first and avoid graph or notification
+   calls when \`egregore.json\` declares \`"mode": "local"\`.
+5. Never call the deprecated \`egregore-handoff\` CLI for Egregore project
+   handoffs.
+EOF
+}
+
+[ -d "$CLAUDE_DIR" ] || { echo "missing Claude skills directory: $CLAUDE_DIR" >&2; exit 1; }
+mkdir -p "$CODEX_DIR"
+
+changed=0
+native_present=0
+adapter_present=0
+
+for native in "${NATIVE_SKILLS[@]}"; do
+  if [ -f "$CODEX_DIR/$native/SKILL.md" ]; then
+    native_present=$((native_present + 1))
+  else
+    echo "missing native Codex skill: $native" >&2
+    changed=1
+  fi
+done
+
+while IFS= read -r source_file; do
+  name="$(basename "$(dirname "$source_file")")"
+  is_native "$name" && continue
+
+  target_dir="$CODEX_DIR/$name"
+  target_file="$target_dir/SKILL.md"
+  if [ -f "$target_file" ] && ! grep -q "$GENERATED_MARKER" "$target_file" 2>/dev/null; then
+    continue
+  fi
+
+  description="$(skill_description "$source_file")"
+  rel_source=".claude/skills/$name/SKILL.md"
+  structured=0
+  is_structured_ux "$name" && structured=1
+  tmp="$(mktemp -t codex-skill-adapter-XXXXXX)"
+  render_adapter "$name" "$rel_source" "$description" "$structured" > "$tmp"
+
+  if [ ! -f "$target_file" ] || ! cmp -s "$tmp" "$target_file"; then
+    changed=1
+    if [ "$CHECK" = "1" ]; then
+      echo "adapter out of date: $name"
+    else
+      mkdir -p "$target_dir"
+      cp "$tmp" "$target_file"
+      echo "generated adapter: $name"
+    fi
+  fi
+  rm -f "$tmp"
+done < <(find "$CLAUDE_DIR" -mindepth 2 -maxdepth 2 -name SKILL.md | sort)
+
+adapter_present="$({ grep -rl "$GENERATED_MARKER" "$CODEX_DIR"/*/SKILL.md 2>/dev/null || true; } | wc -l | tr -d ' ')"
+
+if [ "$CHECK" = "1" ] && [ "$changed" -ne 0 ]; then
+  echo "codex skills out of sync (native: $native_present/${#NATIVE_SKILLS[@]}, adapters: $adapter_present)" >&2
+  exit 1
+fi
+
+echo "codex skills synced (native: $native_present/${#NATIVE_SKILLS[@]}, adapters: $adapter_present)"