egregore-artifacts 0.1.0

package/lib/templates/activity.js

@@ -0,0 +1,285 @@
+// Activity report data → React element tree
+import React from 'react';
+import {
+  ArtifactHeader, SectionCard, ArtifactFooter,
+} from '../components.js';
+import { colors, fonts } from '../tokens.js';
+
+const h = React.createElement;
+
+// ── Helpers ─────────────────────────────────────────────────────
+
+function MetricRow({ metrics }) {
+  return h('div', {
+    style: {
+      display: 'grid',
+      gridTemplateColumns: `repeat(${Math.min(metrics.length, 4)}, 1fr)`,
+      gap: '12px',
+      marginBottom: '1.5rem',
+    },
+  },
+    ...metrics.map((m, i) =>
+      h('div', {
+        key: i,
+        style: {
+          background: 'white',
+          border: `1px solid ${colors.border}`,
+          borderRadius: '12px',
+          padding: '1.25rem',
+          textAlign: 'center',
+        },
+      },
+        h('div', {
+          style: { fontSize: '28px', fontFamily: fonts.serif, fontWeight: 400, color: colors.black, lineHeight: 1.2 },
+        }, m.value),
+        h('div', {
+          style: { fontSize: '12px', fontFamily: fonts.mono, color: colors.muted, marginTop: '4px', textTransform: 'uppercase', letterSpacing: '0.04em' },
+        }, m.label),
+      )
+    ),
+  );
+}
+
+function TrendsCard({ trends }) {
+  if (!trends || !trends.cadence) return null;
+  const weeks = trends.cadence.slice(0, 4);
+  const thisWeek = weeks[0]?.sessions || 0;
+  const lastWeek = weeks[1]?.sessions || 0;
+  const ratio = trends.recentCaptureRatio;
+
+  const lines = [];
+  if (lastWeek > 0) {
+    const change = thisWeek > lastWeek ? 'up' : thisWeek < lastWeek ? 'down' : 'flat';
+    const verb = change === 'up' ? 'doubled' : change === 'down' ? 'dropped' : 'held steady';
+    lines.push(`Session cadence ${verb} this week (${thisWeek} vs ${lastWeek} last week).`);
+  } else {
+    lines.push(`${thisWeek} sessions this week.`);
+  }
+  if (ratio != null) {
+    const pct = Math.round(ratio * 100);
+    lines.push(`Capture ratio at ${pct}% — ${pct < 50 ? 'most sessions lack artifacts.' : 'good artifact coverage.'}`);
+  }
+
+  return h('div', {
+    style: {
+      background: 'rgba(212, 135, 90, 0.06)',
+      border: `1px solid rgba(212, 135, 90, 0.15)`,
+      borderRadius: '12px',
+      padding: '1.25rem 1.5rem',
+      marginBottom: '1.5rem',
+      fontSize: '15px',
+      lineHeight: 1.6,
+      color: colors.dark,
+    },
+  },
+    ...lines.map((line, i) => h('p', { key: i, style: { margin: '0 0 0.25rem' } }, line)),
+  );
+}
+
+function SessionRow({ date, topic, by, handedTo, muted }) {
+  return h('div', {
+    style: {
+      display: 'flex',
+      alignItems: 'baseline',
+      gap: '12px',
+      padding: '6px 0',
+      borderBottom: '1px solid rgba(224, 216, 204, 0.5)',
+      fontSize: '14px',
+    },
+  },
+    h('span', {
+      style: { fontFamily: fonts.mono, fontSize: '12px', color: colors.muted, minWidth: '72px', flexShrink: 0 },
+    }, date),
+    by && h('span', {
+      style: { fontFamily: fonts.mono, fontSize: '11px', color: colors.blueMuted, background: 'rgba(123, 157, 183, 0.1)', padding: '1px 6px', borderRadius: '3px', flexShrink: 0 },
+    }, by),
+    h('span', { style: { color: muted ? colors.muted : colors.black, flex: 1, fontStyle: muted ? 'italic' : 'normal' } }, topic),
+    handedTo && h('span', { style: { fontFamily: fonts.mono, fontSize: '11px', color: colors.terracotta } }, `→ ${handedTo}`),
+  );
+}
+
+function HandoffItem({ handoff, index }) {
+  const statusDot = handoff.status === 'pending'
+    ? h('span', { style: { color: colors.terracotta, fontWeight: 700 } }, '●')
+    : h('span', { style: { color: colors.muted } }, '○');
+
+  return h('div', {
+    style: { padding: '8px 0', borderBottom: '1px solid rgba(224, 216, 204, 0.5)', fontSize: '14px' },
+  },
+    h('div', { style: { display: 'flex', gap: '8px', alignItems: 'baseline' } },
+      h('span', { style: { fontFamily: fonts.mono, fontSize: '12px', color: colors.muted } }, `[${index + 1}]`),
+      statusDot,
+      h('span', { style: { fontFamily: fonts.mono, fontSize: '12px', color: colors.blueMuted } }, handoff.from),
+      h('span', null, '→ you:'),
+      h('span', { style: { fontWeight: 500 } }, handoff.topic),
+      h('span', { style: { fontFamily: fonts.mono, fontSize: '11px', color: colors.muted } }, `(${handoff.date})`),
+    ),
+    handoff.summary && h('p', {
+      style: { margin: '4px 0 0 28px', fontSize: '13px', color: colors.muted, lineHeight: 1.4 },
+    }, handoff.summary),
+  );
+}
+
+function QuestRow({ quest }) {
+  return h('div', {
+    style: {
+      display: 'flex',
+      alignItems: 'center',
+      gap: '16px',
+      padding: '8px 0',
+      borderBottom: '1px solid rgba(224, 216, 204, 0.5)',
+      fontSize: '14px',
+    },
+  },
+    h('span', { style: { fontWeight: 500, flex: 1, minWidth: 0 } }, quest.name),
+    h('span', { style: { fontFamily: fonts.mono, fontSize: '12px', color: colors.muted, textAlign: 'right', whiteSpace: 'nowrap' } },
+      `${quest.artifacts} artifacts`),
+    quest.daysSince > 0 && h('span', { style: { fontFamily: fonts.mono, fontSize: '11px', color: colors.muted, whiteSpace: 'nowrap' } },
+      `· ${quest.daysSince}d ago`),
+  );
+}
+
+// ── Template ────────────────────────────────────────────────────
+
+export function activityTemplate(data) {
+  const sections = [];
+
+  // Header
+  sections.push(
+    h(ArtifactHeader, {
+      key: 'header',
+      title: data.title,
+      type: 'activity',
+      date: data.date,
+      author: data.me,
+      status: 'active',
+      priority: 0,
+      projects: [],
+    })
+  );
+
+  // Trends summary
+  if (data.trends) {
+    sections.push(h(TrendsCard, { key: 'trends', trends: data.trends }));
+  }
+
+  // Metrics row
+  const activeQuests = data.quests.length;
+  const openPrs = data.prs.filter(p => p.state === 'open' || p.state === 'OPEN').length;
+  const metrics = [
+    { label: 'My Sessions', value: String(data.mySessions.length) },
+    { label: 'Team Sessions', value: String(data.teamSessions.length) },
+    { label: 'Active Quests', value: String(activeQuests) },
+  ];
+  if (openPrs > 0) metrics.push({ label: 'Open PRs', value: String(openPrs) });
+  if (data.todos.activeTodoCount) metrics.push({ label: 'Active Todos', value: String(data.todos.activeTodoCount) });
+  sections.push(h(MetricRow, { key: 'metrics', metrics: metrics.slice(0, 4) }));
+
+  // Handoffs to me
+  if (data.handoffsToMe && data.handoffsToMe.length > 0) {
+    sections.push(
+      h(SectionCard, { key: 'handoffs', label: `Handoffs & Asks (${data.handoffsToMe.length})` },
+        h('div', null,
+          ...data.handoffsToMe.map((ho, i) => h(HandoffItem, { key: i, handoff: ho, index: i })),
+        ),
+      )
+    );
+  }
+
+  // Pending questions
+  if (data.pendingQuestions && data.pendingQuestions.length > 0) {
+    sections.push(
+      h(SectionCard, { key: 'questions', label: `Pending Questions (${data.pendingQuestions.length})` },
+        h('div', null,
+          ...data.pendingQuestions.map((q, i) =>
+            h('div', {
+              key: i,
+              style: { display: 'flex', gap: '10px', padding: '6px 0', borderBottom: '1px solid rgba(224, 216, 204, 0.5)', fontSize: '14px' },
+            },
+              h('span', { style: { fontFamily: fonts.mono, fontSize: '12px', color: colors.blueMuted, flexShrink: 0 } }, q.from),
+              h('span', { style: { flex: 1 } }, q.topic),
+              h('span', { style: { fontFamily: fonts.mono, fontSize: '11px', color: colors.muted } }, q.date),
+            )
+          ),
+        ),
+      )
+    );
+  }
+
+  // My sessions (grouped)
+  if (data.mySessions.length > 0) {
+    sections.push(
+      h(SectionCard, { key: 'my-sessions', label: `Your Sessions` },
+        h('div', null,
+          ...data.mySessions.map((s, i) =>
+            h(SessionRow, {
+              key: i,
+              date: s.date,
+              topic: s.topic,
+              handedTo: s.handedTo,
+              muted: s.topic.startsWith('('),
+            })
+          ),
+        ),
+      )
+    );
+  }
+
+  // Team sessions
+  if (data.teamSessions.length > 0) {
+    sections.push(
+      h(SectionCard, { key: 'team-sessions', label: `Team` },
+        h('div', null,
+          ...data.teamSessions.map((s, i) =>
+            h(SessionRow, { key: i, date: s.date, topic: s.topic, by: s.by })
+          ),
+        ),
+      )
+    );
+  }
+
+  // Quests
+  if (data.quests && data.quests.length > 0) {
+    sections.push(
+      h(SectionCard, { key: 'quests', label: `Quests (${data.quests.length} active)` },
+        h('div', null,
+          ...data.quests.map((q, i) => h(QuestRow, { key: i, quest: q })),
+        ),
+      )
+    );
+  }
+
+  // Knowledge gap / orphans
+  const gapItems = [];
+  if (data.orphans?.unlinkedArtifacts) gapItems.push(`${data.orphans.unlinkedArtifacts} artifacts unlinked to quests`);
+  if (data.knowledgeGap?.gapCount) gapItems.push(`${data.knowledgeGap.gapCount} sessions without captured insights`);
+
+  if (gapItems.length > 0) {
+    sections.push(
+      h('div', {
+        key: 'gaps',
+        style: {
+          fontFamily: fonts.mono,
+          fontSize: '12px',
+          color: colors.muted,
+          padding: '1rem 0',
+          borderTop: `1px solid ${colors.border}`,
+          marginTop: '1rem',
+        },
+      },
+        ...gapItems.map((item, i) => h('div', { key: i, style: { marginBottom: '4px' } }, item)),
+      )
+    );
+  }
+
+  // Footer
+  sections.push(
+    h(ArtifactFooter, {
+      key: 'footer',
+      generatedAt: new Date().toISOString(),
+      source: 'bin/activity-data.sh',
+    })
+  );
+
+  return h('div', null, ...sections);
+}

package/lib/templates/handoff.js

@@ -0,0 +1,225 @@
+// Handoff data → React element tree
+import React from 'react';
+import {
+  ArtifactHeader, SectionCard, ThreadList, BulletList,
+  TextBlock, ArtifactFooter,
+} from '../components.js';
+import { renderMarkdownLite } from '../markdown.js';
+import { colors, fonts } from '../tokens.js';
+
+const h = React.createElement;
+
+export function handoffTemplate(handoff) {
+  const sections = [];
+
+  // Header
+  sections.push(
+    h(ArtifactHeader, {
+      key: 'header',
+      title: handoff.title,
+      type: 'handoff',
+      date: handoff.date,
+      author: handoff.author,
+      status: 'active',
+      priority: 0,
+      projects: handoff.project ? [handoff.project] : [],
+    })
+  );
+
+  // Addressed to
+  if (handoff.to && handoff.to.length > 0) {
+    sections.push(
+      h('div', {
+        key: 'to',
+        style: {
+          display: 'flex',
+          alignItems: 'center',
+          gap: '8px',
+          marginBottom: '1.5rem',
+          fontFamily: fonts.mono,
+          fontSize: '13px',
+          color: colors.muted,
+        },
+      },
+        h('span', null, 'To:'),
+        ...handoff.to.map((name, i) =>
+          h('span', {
+            key: i,
+            style: {
+              padding: '2px 10px',
+              background: 'rgba(123, 157, 183, 0.1)',
+              borderRadius: '50px',
+              color: colors.blueMuted,
+              fontSize: '12px',
+              fontWeight: 500,
+            },
+          }, name)
+        ),
+      )
+    );
+  }
+
+  // Source / Branch
+  if (handoff.source || handoff.branch) {
+    sections.push(
+      h('div', {
+        key: 'source-meta',
+        style: {
+          display: 'flex',
+          flexWrap: 'wrap',
+          gap: '16px',
+          marginBottom: '2rem',
+          fontFamily: fonts.mono,
+          fontSize: '12px',
+          color: colors.muted,
+        },
+      },
+        handoff.source && h('span', null, `Source: ${handoff.source}`),
+        handoff.branch && h('span', {
+          style: {
+            padding: '2px 8px',
+            background: 'rgba(59, 45, 33, 0.06)',
+            borderRadius: '4px',
+            fontFamily: fonts.mono,
+          },
+        }, handoff.branch),
+      )
+    );
+  }
+
+  // Summary / Briefing
+  if (handoff.summary) {
+    sections.push(
+      h(SectionCard, { key: 'summary', label: 'Summary' },
+        h(TextBlock, { text: handoff.summary, variant: 'lead' })
+      )
+    );
+  }
+
+  // Current State
+  if (handoff.currentState) {
+    sections.push(
+      h(SectionCard, { key: 'state', label: 'Current State' },
+        h(TextBlock, { text: handoff.currentState })
+      )
+    );
+  }
+
+  // Decisions
+  if (handoff.decisions && handoff.decisions.length > 0) {
+    sections.push(
+      h(SectionCard, { key: 'decisions', label: 'Decisions' },
+        h(BulletList, { items: handoff.decisions })
+      )
+    );
+  }
+
+  // Open Threads
+  if (handoff.openThreads && handoff.openThreads.length > 0) {
+    const doneCount = handoff.openThreads.filter(t => t.done).length;
+    const label = `Open Threads (${doneCount}/${handoff.openThreads.length})`;
+    sections.push(
+      h(SectionCard, { key: 'threads', label },
+        h(ThreadList, { threads: handoff.openThreads })
+      )
+    );
+  }
+
+  // Next Steps
+  if (handoff.nextSteps && handoff.nextSteps.length > 0) {
+    sections.push(
+      h(SectionCard, { key: 'next', label: 'Next Steps' },
+        h('ol', {
+          style: {
+            listStyle: 'none',
+            padding: 0,
+            counterReset: 'step',
+          },
+        },
+          ...handoff.nextSteps.map((step, i) =>
+            h('li', {
+              key: i,
+              style: {
+                display: 'flex',
+                gap: '12px',
+                padding: '8px 0',
+                borderBottom: i < handoff.nextSteps.length - 1 ? '1px solid rgba(224, 216, 204, 0.5)' : 'none',
+                fontSize: '15px',
+                lineHeight: 1.5,
+              },
+            },
+              h('span', {
+                style: {
+                  flexShrink: 0,
+                  width: '24px',
+                  height: '24px',
+                  borderRadius: '50%',
+                  background: colors.terracotta,
+                  color: colors.cream,
+                  display: 'flex',
+                  alignItems: 'center',
+                  justifyContent: 'center',
+                  fontSize: '12px',
+                  fontFamily: fonts.mono,
+                  fontWeight: 600,
+                },
+              }, String(i + 1)),
+              h('span', null, step),
+            )
+          ),
+        )
+      )
+    );
+  }
+
+  // Entry Points
+  if (handoff.entryPoints && handoff.entryPoints.length > 0) {
+    sections.push(
+      h(SectionCard, { key: 'entry', label: 'Entry Points' },
+        h(BulletList, { items: handoff.entryPoints })
+      )
+    );
+  }
+
+  // Extra sections (non-standard)
+  for (const extra of handoff.extraSections || []) {
+    sections.push(
+      h(SectionCard, { key: `extra-${extra.heading}`, label: extra.heading },
+        h(TextBlock, { text: extra.body })
+      )
+    );
+  }
+
+  // Attachments (referenced files inlined)
+  for (const attachment of handoff.attachments || []) {
+    // Strip the frontmatter/title from the attachment — render the body
+    let body = attachment.content
+      .replace(/^#\s+.+\n/, '')          // remove # title line
+      .replace(/^\*\*\w+\*\*:.+\n/gm, '') // remove **Key**: value metadata lines
+      .trim();
+
+    // Truncate very large attachments (keep first 60 lines for performance)
+    const lines = body.split('\n');
+    const truncated = lines.length > 60;
+    if (truncated) {
+      body = lines.slice(0, 60).join('\n') + `\n\n*... ${lines.length - 60} more lines — see full file at \`${attachment.path}\`*`;
+    }
+
+    sections.push(
+      h(SectionCard, { key: `att-${attachment.path}`, label: `${attachment.title}` },
+        renderMarkdownLite(body)
+      )
+    );
+  }
+
+  // Footer
+  sections.push(
+    h(ArtifactFooter, {
+      key: 'footer',
+      generatedAt: new Date().toISOString(),
+      source: null,
+    })
+  );
+
+  return h('div', null, ...sections);
+}

package/lib/templates/quest.js

@@ -0,0 +1,112 @@
+// Quest data → React element tree
+import React from 'react';
+import {
+  ArtifactHeader, SectionCard, ThreadList, ArtifactList,
+  ContributorRow, BulletList, TextBlock, SectionDivider, ArtifactFooter,
+} from '../components.js';
+
+const h = React.createElement;
+
+export function questTemplate(quest) {
+  const sections = [];
+
+  // Header
+  sections.push(
+    h(ArtifactHeader, {
+      key: 'header',
+      title: quest.title,
+      type: 'quest',
+      date: quest.started,
+      author: quest.started_by,
+      status: quest.status,
+      priority: quest.priority,
+      projects: quest.projects,
+    })
+  );
+
+  // The Question
+  if (quest.question) {
+    sections.push(
+      h(SectionCard, { key: 'question', label: 'The Question' },
+        h(TextBlock, { text: quest.question, variant: 'lead' })
+      )
+    );
+  }
+
+  // Context / Why This Matters
+  if (quest.context) {
+    sections.push(
+      h(SectionCard, { key: 'context', label: 'Context' },
+        h(TextBlock, { text: quest.context })
+      )
+    );
+  }
+
+  // Vision
+  if (quest.vision && quest.vision.length > 0) {
+    sections.push(
+      h(SectionCard, { key: 'vision', label: 'Vision' },
+        h(BulletList, { items: quest.vision })
+      )
+    );
+  }
+
+  // Threads
+  if (quest.threads && quest.threads.length > 0) {
+    const doneCount = quest.threads.filter(t => t.done).length;
+    const label = `Threads (${doneCount}/${quest.threads.length})`;
+    sections.push(
+      h(SectionCard, { key: 'threads', label },
+        h(ThreadList, { threads: quest.threads })
+      )
+    );
+  }
+
+  // Artifacts
+  if (quest.artifacts && quest.artifacts.length > 0) {
+    sections.push(
+      h(SectionCard, { key: 'artifacts', label: `Artifacts (${quest.artifacts.length})` },
+        h(ArtifactList, { artifacts: quest.artifacts })
+      )
+    );
+  }
+
+  // Technical Notes
+  if (quest.technicalNotes && quest.technicalNotes.length > 0) {
+    sections.push(
+      h(SectionCard, { key: 'tech', label: 'Technical Notes' },
+        h(BulletList, { items: quest.technicalNotes })
+      )
+    );
+  }
+
+  // Entry Points
+  if (quest.entryPoints && quest.entryPoints.length > 0) {
+    sections.push(
+      h(SectionCard, { key: 'entry', label: 'Entry Points' },
+        h(BulletList, { items: quest.entryPoints })
+      )
+    );
+  }
+
+  // Contributors
+  if (quest.contributors && quest.contributors.length > 0) {
+    sections.push(
+      h('div', { key: 'contributors', className: 'eg-section' },
+        h('div', { className: 'eg-card-title', style: { marginBottom: '0.75rem' } }, 'Contributors'),
+        h(ContributorRow, { contributors: quest.contributors })
+      )
+    );
+  }
+
+  // Footer
+  sections.push(
+    h(ArtifactFooter, {
+      key: 'footer',
+      generatedAt: new Date().toISOString(),
+      source: quest.slug ? `memory/quests/${quest.slug}.md` : null,
+    })
+  );
+
+  return h('div', null, ...sections);
+}

package/lib/tokens.js

@@ -0,0 +1,61 @@
+// Egregore design tokens — extracted from egregore-site/app/globals.css
+// Canonical JS source. CSS source: packages/design-system/tokens.css
+
+export const colors = {
+  cream: '#F5F2ED',
+  black: '#16100B',
+  terracotta: '#D4875A',
+  blueMuted: '#7B9DB7',
+  dark: '#2A2A2A',
+  border: '#E0D8CC',
+  terminalBg: '#1D1611',
+  muted: '#8a8578',
+  warmGray: '#d4cfc5',
+
+  // Functional aliases
+  bg: '#F5F2ED',
+  text: '#16100B',
+  accent: '#D4875A',
+  secondary: '#7B9DB7',
+
+  // Terminal syntax
+  terminalHighlight: '#E7794B',
+  terminalSuccess: '#6BBF6B',
+  terminalFlag: '#85C0FC',
+  terminalText: 'rgba(255, 255, 255, 0.85)',
+};
+
+export const fonts = {
+  serif: "'LT Superior Serif', Georgia, 'Times New Roman', serif",
+  sans: "'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif",
+  mono: "'IBM Plex Mono', 'SF Mono', 'Fira Code', monospace",
+};
+
+export const typography = {
+  hero:    { fontSize: '60px', fontFamily: fonts.serif, fontWeight: 400, lineHeight: '54px', letterSpacing: '-0.03em' },
+  section: { fontSize: '36px', fontFamily: fonts.serif, fontWeight: 400, lineHeight: 1.2 },
+  card:    { fontSize: '24px', fontFamily: fonts.serif, fontWeight: 400, lineHeight: 1.3, letterSpacing: '-0.02em' },
+  body:    { fontSize: '16px', fontFamily: fonts.sans, fontWeight: 400, lineHeight: 1.65 },
+  bodyLg:  { fontSize: '18px', fontFamily: fonts.sans, fontWeight: 400, lineHeight: 1.6 },
+  meta:    { fontSize: '13px', fontFamily: fonts.mono, fontWeight: 400, lineHeight: 1.5 },
+  small:   { fontSize: '12px', fontFamily: fonts.mono, fontWeight: 400, lineHeight: 1.5 },
+};
+
+export const spacing = {
+  xs: '0.25rem',
+  sm: '0.5rem',
+  md: '1rem',
+  lg: '1.5rem',
+  xl: '2rem',
+  '2xl': '3rem',
+  '3xl': '4rem',
+};
+
+export const radius = {
+  sm: '4px',
+  md: '8px',
+  lg: '12px',
+  xl: '20px',
+};
+
+export const easing = 'cubic-bezier(0.19, 1, 0.22, 1)';