chore: initialize EverOS 1.0.0

md-first memory extraction framework for AI agents.

Markdown is the single source of truth; SQLite holds state and LanceDB
provides the rebuildable vector + BM25 + scalar index. The codebase follows
a single-direction DDD layering (entrypoints -> service -> memory -> infra,
with component / core / config cross-cutting) enforced by import-linter.

Engineering surface:
- Coding conventions in .claude/rules/ (path-scoped) and workflows in
  .claude/skills/ (/commit, /new-branch, /pr).
- GitHub Actions CI runs make lint + test + integration; pre-commit mirrors
  the gates locally (ruff, hygiene hooks, gitlint commit-msg).
- Commit messages follow Conventional Commits, enforced by gitlint.
- make lint also enforces datetime two-zone discipline and OpenAPI drift.

use-cases/claude-code-plugin/hooks/scripts/utils/formatter.js

@@ -0,0 +1,152 @@
+/**
+ * Terminal output formatting utilities
+ */
+
+import { formatRelativeTime } from './mock-store.js';
+
+// Memory type emoji mapping
+const TYPE_ICONS = {
+  decision: { emoji: '\u{1F3AF}', ascii: '[DECISION]' },      // Target
+  bug_fix: { emoji: '\u{1F41B}', ascii: '[BUG]' },            // Bug
+  implementation: { emoji: '\u{1F527}', ascii: '[IMPL]' },    // Wrench
+  learning: { emoji: '\u{1F4A1}', ascii: '[LEARN]' },         // Lightbulb
+  preference: { emoji: '\u{2699}\u{FE0F}', ascii: '[PREF]' }  // Gear
+};
+
+/**
+ * Detect if terminal likely supports Unicode
+ * @returns {boolean}
+ */
+export function supportsUnicode() {
+  const term = process.env.TERM || '';
+  const lang = process.env.LANG || '';
+  const lcAll = process.env.LC_ALL || '';
+
+  // Check for UTF-8 in locale settings
+  if (lang.includes('UTF-8') || lcAll.includes('UTF-8')) {
+    return true;
+  }
+
+  // Check for modern terminal types
+  if (term.includes('xterm') || term.includes('256color') || term.includes('kitty') || term.includes('alacritty')) {
+    return true;
+  }
+
+  // Default to Unicode on macOS
+  if (process.platform === 'darwin') {
+    return true;
+  }
+
+  return false;
+}
+
+/**
+ * Get icon for memory type
+ * @param {string} type - Memory type
+ * @param {boolean} useUnicode - Whether to use Unicode
+ * @returns {string}
+ */
+export function getTypeIcon(type, useUnicode = true) {
+  const icons = TYPE_ICONS[type] || TYPE_ICONS.implementation;
+  return useUnicode ? icons.emoji : icons.ascii;
+}
+
+/**
+ * Format the "Searching memories..." spinner
+ * @returns {string}
+ */
+export function formatSpinner() {
+  const useUnicode = supportsUnicode();
+  const icon = useUnicode ? '\u23F3' : '[...]';  // Hourglass
+  return `${icon} Searching memories...\n`;
+}
+
+/**
+ * @typedef {Object} FilteredMemory
+ * @property {string} text - Original memory text
+ * @property {string} timestamp - ISO timestamp
+ * @property {string} type - Memory type
+ */
+
+/**
+ * Format the memory summary box with original memories and timestamps
+ * @param {Object} result - SDK filter result
+ * @param {FilteredMemory[]} result.selected - Selected memories
+ * @param {string} result.synthesis - SDK synthesis
+ * @param {number} rawCount - Number of raw candidates
+ * @param {number} filteredCount - Number after filtering
+ * @returns {string}
+ */
+export function formatSummaryBox(result, rawCount, filteredCount) {
+  const useUnicode = supportsUnicode();
+  const divider = useUnicode ? '\u2500'.repeat(50) : '-'.repeat(50);
+
+  let output = '\n';
+  output += useUnicode ? '\u{1F4AD} Memory Retrieved\n' : '=== Memory Retrieved ===\n';
+  output += divider + '\n';
+
+  // Individual memories with original text and timestamp
+  for (let i = 0; i < result.selected.length; i++) {
+    const memory = result.selected[i];
+    const icon = getTypeIcon(memory.type, useUnicode);
+    const relativeTime = formatRelativeTime(memory.timestamp);
+
+    output += `${icon} (${relativeTime}) ${memory.text.slice(0, 80)}...\n`;
+  }
+
+  output += divider + '\n';
+  output += `${filteredCount} memories recalled\n`;
+
+  return output;
+}
+
+/**
+ * Format "No relevant memories" message
+ * @returns {string}
+ */
+export function formatNoMemories() {
+  const useUnicode = supportsUnicode();
+  const icon = useUnicode ? '\u{1F4AD}' : '===';
+
+  return `\n${icon} Memory Retrieved: No relevant memories found\n`;
+}
+
+/**
+ * Format error message
+ * @param {string} message - Error message
+ * @returns {string}
+ */
+export function formatError(message) {
+  const useUnicode = supportsUnicode();
+  const icon = useUnicode ? '\u26A0\u{FE0F}' : '[!]';
+
+  return `\n${icon} Memory Retrieved: ${message}\n   Continuing without memory context\n`;
+}
+
+/**
+ * Format fallback summary (when SDK fails)
+ * @param {FilteredMemory[]} memories - Memory objects with text, timestamp, type
+ * @param {number} rawCount - Total raw candidates
+ * @returns {string}
+ */
+export function formatFallbackSummary(memories, rawCount) {
+  const useUnicode = supportsUnicode();
+  const divider = useUnicode ? '\u2500'.repeat(50) : '-'.repeat(50);
+
+  let output = '\n';
+  output += useUnicode ? '\u{1F4AD} Memory Retrieved (Fallback)\n' : '=== Memory Retrieved (Fallback) ===\n';
+  output += divider + '\n';
+
+  for (let i = 0; i < memories.length; i++) {
+    const memory = memories[i];
+    const icon = getTypeIcon(memory.type, useUnicode);
+    const relativeTime = formatRelativeTime(memory.timestamp);
+
+    output += `${icon} (${relativeTime}) ${memory.text.slice(0, 80)}...\n`;
+  }
+
+  output += divider + '\n';
+  output += `Showing top ${memories.length} matches (SDK unavailable)\n`;
+
+  return output;
+}