@sbains2/lifeos 0.1.3

package/src/validate.js

@@ -0,0 +1,113 @@
+import { existsSync, accessSync, constants } from 'node:fs';
+import { join } from 'node:path';
+import { listCouncilFiles, loadRegistry } from './templates-loader.js';
+
+const SUPPORTED_VERSION = '0.2';
+const PRIORITY_ENUM = new Set(['hot', 'warm', 'lukewarm', 'cold']);
+const HORIZON_ENUM = new Set(['now', 'quarter', 'year', 'arc']);
+
+/**
+ * Run all validation checks against a config object.
+ * Returns { ok: boolean, errors: string[], warnings: string[] }.
+ * Never throws — caller decides what to do with the results.
+ */
+export function validate(config, { targetDir }) {
+  const errors = [];
+  const warnings = [];
+
+  // Check 7 (run first — gates everything else): version match
+  if (config.version !== SUPPORTED_VERSION) {
+    errors.push(
+      `Schema version mismatch: config has ${config.version}, CLI was built for ${SUPPORTED_VERSION}. ` +
+        `Future versions will offer 'lifeos migrate' to upgrade old configs; for now, regenerate.`
+    );
+    return { ok: false, errors, warnings };
+  }
+
+  // Check 5: foci has at least one entry
+  const foci = config.user?.context?.foci;
+  if (!Array.isArray(foci) || foci.length === 0) {
+    errors.push('user.context.foci must have at least one entry — what are you working toward?');
+  } else {
+    foci.forEach((f, i) => {
+      if (!HORIZON_ENUM.has(f.horizon)) {
+        errors.push(`foci[${i}].horizon must be one of: ${[...HORIZON_ENUM].join(', ')} (got '${f.horizon}')`);
+      }
+      if (!PRIORITY_ENUM.has(f.priority)) {
+        errors.push(`foci[${i}].priority must be one of: ${[...PRIORITY_ENUM].join(', ')} (got '${f.priority}')`);
+      }
+    });
+  }
+
+  // Build lookup sets for cross-reference checks
+  const councilIds = new Set((config.council ?? []).map((c) => c.id));
+  const mcpIds = new Set((config.mcp_servers ?? []).map((m) => m.id));
+
+  // Check 1: council_member_ids resolve
+  // Check 2: mcp_server_ids resolve
+  for (const q of config.quadrants ?? []) {
+    if (!PRIORITY_ENUM.has(q.priority)) {
+      errors.push(`quadrant '${q.id}'.priority must be one of: ${[...PRIORITY_ENUM].join(', ')} (got '${q.priority}')`);
+    }
+    for (const cid of q.council_member_ids ?? []) {
+      if (!councilIds.has(cid)) {
+        errors.push(`quadrant '${q.id}' references council member '${cid}' that is not defined in council[]`);
+      }
+    }
+    for (const mid of q.mcp_server_ids ?? []) {
+      if (!mcpIds.has(mid)) {
+        errors.push(`quadrant '${q.id}' references mcp server '${mid}' that is not in mcp_servers[]`);
+      }
+    }
+  }
+
+  // Check 3: mcp_servers entries exist in registry
+  let registryIds;
+  try {
+    registryIds = new Set(loadRegistry().servers.map((s) => s.id));
+    for (const m of config.mcp_servers ?? []) {
+      if (!registryIds.has(m.id)) {
+        warnings.push(
+          `mcp server '${m.id}' is not in the bundled registry — install hints won't be auto-generated. ` +
+            `Add it manually to .lifeos/INSTALL_MCPS.md after install.`
+        );
+      }
+    }
+  } catch (err) {
+    warnings.push(`Could not load MCP registry for validation: ${err.message}`);
+  }
+
+  // Check 4: council system_prompt_paths point to copyable template files
+  const availableCouncilFiles = new Set(listCouncilFiles());
+  for (const c of config.council ?? []) {
+    if (!PRIORITY_ENUM.has(c.priority)) {
+      errors.push(`council '${c.id}'.priority must be one of: ${[...PRIORITY_ENUM].join(', ')} (got '${c.priority}')`);
+    }
+    const filename = c.system_prompt_path?.split('/').pop();
+    if (!filename) {
+      errors.push(`council '${c.id}' has no system_prompt_path`);
+    } else if (!availableCouncilFiles.has(filename)) {
+      errors.push(
+        `council '${c.id}' references '${c.system_prompt_path}' but no template file '${filename}' exists in cli/templates/council/`
+      );
+    }
+  }
+
+  // Check 6: quadrant paths writeable from CWD
+  for (const q of config.quadrants ?? []) {
+    if (!q.active) continue;
+    const fullPath = join(targetDir, q.path);
+    // Try to access the parent directory; we can mkdir if it doesn't exist yet
+    let parent = fullPath;
+    while (parent !== '/' && !existsSync(parent)) {
+      parent = parent.split('/').slice(0, -1).join('/') || '/';
+    }
+    try {
+      accessSync(parent, constants.W_OK);
+    } catch {
+      errors.push(`quadrant '${q.id}'.path '${q.path}' resolves to '${fullPath}' — parent directory '${parent}' is not writeable`);
+    }
+  }
+
+  return { ok: errors.length === 0, errors, warnings };
+}

package/src/wizard/council.js

@@ -0,0 +1,45 @@
+import { confirm } from '@inquirer/prompts';
+import { c } from '../utils/colors.js';
+
+/**
+ * Step 5: take template council, ask "use defaults?". Granular priority adjustment
+ * is post-v0.1 — users edit JSON for that.
+ */
+export async function askCouncil(templateCouncil) {
+  console.log(c.bold('\nStep 5 of 7 — Council'));
+  console.log(c.dim('Your persona suggests this council with these priorities:'));
+  for (const m of templateCouncil) {
+    console.log(`  ${formatPriority(m.priority)}  ${m.name.padEnd(22)} ${c.dim(m.voice ?? '')}`);
+  }
+  console.log('');
+
+  const useDefaults = await confirm({
+    message: 'Use these defaults? (you can edit lifeos.config.json afterward to tune any voice)',
+    default: true,
+  });
+
+  // v0.1: only "use defaults" is supported. Granular adjustment is post-v0.1.
+  if (!useDefaults) {
+    console.log(c.dim('  Granular per-member priority adjustment is post-v0.1 — using defaults; edit lifeos.config.json to tune.'));
+  }
+  return templateCouncil;
+}
+
+// Pad to visible width 8 BEFORE colorizing — chalk's ANSI codes throw off
+// .length-based padEnd calls (chalk.dim's escape is shorter than chalk.yellow's,
+// so "cold" would render with more visible space than "warm" if padded after).
+function formatPriority(p) {
+  const padded = p.padEnd(8);
+  switch (p) {
+    case 'hot':
+      return c.err(padded);
+    case 'warm':
+      return c.warn(padded);
+    case 'lukewarm':
+      return c.cyan(padded);
+    case 'cold':
+      return c.dim(padded);
+    default:
+      return padded;
+  }
+}

package/src/wizard/foci.js

@@ -0,0 +1,71 @@
+import { input, select, confirm } from '@inquirer/prompts';
+import { c } from '../utils/colors.js';
+
+const HORIZON_CHOICES = [
+  { name: 'Quarter (next ~3 months)', value: 'quarter' },
+  { name: 'Year (next 1-2 years)', value: 'year' },
+  { name: 'Now (this week)', value: 'now' },
+  { name: 'Arc (multi-year)', value: 'arc' },
+];
+
+const PRIORITY_CHOICES = [
+  { name: 'hot — your single most important thing', value: 'hot' },
+  { name: 'warm — actively pursuing', value: 'warm' },
+  { name: 'lukewarm — on the radar', value: 'lukewarm' },
+];
+
+export async function askFoci(options = {}) {
+  const { minimal = false } = options;
+  console.log(c.bold('\nStep 3 of 7 — Foci'));
+  console.log(c.dim('What are you working toward? You need at least one focus; add more if your life has multiple horizons.'));
+  const foci = [];
+
+  // First focus — required (always asked, even in minimal mode)
+  const description1 = await input({
+    message: "What's the single most important outcome you're working toward in the next 3 months?",
+  });
+  const priority1 = minimal
+    ? 'hot'
+    : await select({ message: 'Priority?', choices: PRIORITY_CHOICES, default: 'hot' });
+  foci.push({ id: 'primary-quarter', horizon: 'quarter', description: description1, priority: priority1 });
+
+  if (minimal) {
+    console.log(c.dim('  (--minimal: skipping longer-arc focus; you can add later in lifeos.config.json)'));
+    return foci;
+  }
+
+  // Second focus — optional, default yes (year-horizon arc)
+  // (BUGFIX 2026-04-30: previously combined "Add a longer-arc focus?" with the
+  // description prompt in a single confirm message. Users would start typing a
+  // description into the y/n prompt and lose those keystrokes. Now split into a
+  // clean confirm followed by a clearly-an-input prompt.)
+  const wantArc = await confirm({
+    message: 'Add a longer-arc focus (next 1-2 years)?',
+    default: true,
+  });
+  if (wantArc) {
+    const description2 = await input({
+      message: "What's the bigger arc this quarter is a step toward?",
+    });
+    const priority2 = await select({
+      message: 'Priority?',
+      choices: PRIORITY_CHOICES,
+      default: 'warm',
+    });
+    foci.push({ id: 'longer-arc', horizon: 'year', description: description2, priority: priority2 });
+  }
+
+  // Third+ — optional loop
+  let i = 3;
+  while (true) {
+    const more = await confirm({ message: 'Add another focus?', default: false });
+    if (!more) break;
+    const description = await input({ message: 'Describe it:' });
+    const horizon = await select({ message: 'Horizon?', choices: HORIZON_CHOICES, default: 'quarter' });
+    const priority = await select({ message: 'Priority?', choices: PRIORITY_CHOICES, default: 'warm' });
+    foci.push({ id: `focus-${i}`, horizon, description, priority });
+    i++;
+  }
+
+  return foci;
+}

package/src/wizard/generate.js

@@ -0,0 +1,59 @@
+import { confirm } from '@inquirer/prompts';
+import { validate } from '../validate.js';
+import { scaffold, printScaffoldReport } from '../scaffold.js';
+import { c } from '../utils/colors.js';
+
+/**
+ * Step 7: validate the assembled config, refuse to write if invalid, otherwise scaffold.
+ * In --minimal mode, skips the "About to scaffold... proceed?" confirmation.
+ */
+export async function validateAndGenerate(config, options) {
+  const { targetDir, minimal = false } = options;
+  console.log(c.bold('\nStep 7 of 7 — Validate + generate'));
+  console.log(c.dim('Validating...'));
+
+  const result = validate(config, { targetDir });
+
+  if (result.warnings.length) {
+    console.log('');
+    for (const w of result.warnings) {
+      console.log(`  ${c.warn('!')} ${w}`);
+    }
+  }
+
+  if (!result.ok) {
+    console.log('');
+    console.log(c.err('Validation failed. Refusing to write.'));
+    for (const e of result.errors) {
+      console.log(`  ${c.cross} ${e}`);
+    }
+    console.log('');
+    console.log(c.dim('No files written. Fix the issues and re-run.'));
+    return { ok: false };
+  }
+
+  console.log(`  ${c.check} All council_member_ids resolve`);
+  console.log(`  ${c.check} All mcp_server_ids resolve`);
+  console.log(`  ${c.check} All council system_prompt_paths copyable from templates/`);
+  console.log(`  ${c.check} All quadrant paths writeable`);
+  console.log(`  ${c.check} foci has at least one entry`);
+  console.log(`  ${c.check} Schema version matches`);
+  console.log('');
+
+  if (!minimal) {
+    const proceed = await confirm({
+      message: `About to scaffold into ${targetDir}. Proceed?`,
+      default: true,
+    });
+    if (!proceed) {
+      console.log(c.dim('Cancelled. No files written.'));
+      return { ok: false };
+    }
+  }
+
+  console.log('');
+  console.log(c.bold('Writing:'));
+  const created = scaffold(config, { targetDir });
+  printScaffoldReport(created);
+  return { ok: true, created };
+}

package/src/wizard/mcps.js

@@ -0,0 +1,57 @@
+import { checkbox } from '@inquirer/prompts';
+import { loadRegistry } from '../templates-loader.js';
+import { c } from '../utils/colors.js';
+
+/**
+ * Step 6: confirm which of the persona's default MCP servers to wire.
+ * Pre-checks the persona's defaults; users uncheck what they don't use.
+ */
+export async function askMcps(templateMcps) {
+  console.log(c.bold('\nStep 6 of 7 — Apps & MCPs'));
+  let registry = { servers: [] };
+  try {
+    registry = loadRegistry();
+  } catch {
+    /* registry not loadable; proceed with template-only metadata */
+  }
+  const byId = new Map(registry.servers.map((s) => [s.id, s]));
+
+  const choices = templateMcps.map((m) => {
+    const meta = byId.get(m.id);
+    const desc = meta ? meta.description : '(not in registry)';
+    return {
+      // `name` is the long row shown during selection (with description)
+      name: `${m.id.padEnd(20)} ${c.dim(desc)}`,
+      // `short` is shown in Inquirer's "after-answer" echo — keep it tight
+      short: m.id,
+      value: m.id,
+      checked: true,
+    };
+  });
+
+  const selectedIds = await checkbox({
+    message: "Which apps do you actually use? (uncheck the ones you don't)",
+    choices,
+  });
+
+  const selectedSet = new Set(selectedIds);
+  const wired = templateMcps.filter((m) => selectedSet.has(m.id));
+
+  // Print our own clean summary directly after Inquirer's echo —
+  // even with `short` set, the answer line can still wrap awkwardly on
+  // small terminals. This summary is one server per line, easy to scan.
+  console.log('');
+  console.log(c.bold(`Wired MCP servers (${wired.length}):`));
+  for (const m of wired) {
+    console.log(`  ${c.check} ${m.id}`);
+  }
+
+  console.log('');
+  console.log(c.bold('Trust defaults applied:'));
+  console.log(`  ${c.dot} ${c.dim('Gmail (if wired) is DRAFT-ONLY by default — no auto-send.')}`);
+  console.log(`  ${c.dot} ${c.dim('All auth tokens stay in your shell env vars — never copied into the config.')}`);
+  console.log(`  ${c.dot} ${c.dim('Install hints will be written to .lifeos/INSTALL_MCPS.md.')}`);
+  console.log('');
+
+  return wired;
+}

package/src/wizard/persona.js

@@ -0,0 +1,17 @@
+import { select } from '@inquirer/prompts';
+import { c } from '../utils/colors.js';
+
+const PERSONA_CHOICES = [
+  { name: 'Grad student', value: 'grad-student', description: 'Coursework + research + job search + leadership roles' },
+  { name: 'Early-career IC (engineer / analyst / PM, years 0-4)', value: 'early-career-ic', description: 'Day job + career growth + side projects' },
+  { name: 'Solo researcher / indie writer / consultant', value: 'solo-researcher', description: 'Active research + publishing + clients' },
+];
+
+export async function askPersona() {
+  console.log(c.bold('\nStep 1 of 7 — Persona'));
+  const persona = await select({
+    message: 'Which best describes your current life?',
+    choices: PERSONA_CHOICES,
+  });
+  return persona;
+}

package/src/wizard/profile.js

@@ -0,0 +1,27 @@
+import { input } from '@inquirer/prompts';
+import { c } from '../utils/colors.js';
+
+export async function askProfile(options = {}) {
+  const { minimal = false } = options;
+  console.log(c.bold('\nStep 2 of 7 — Profile'));
+  const name = await input({ message: 'Your name?' });
+
+  if (minimal) {
+    console.log(c.dim('  (--minimal: skipping role + affiliations; you can add later in lifeos.config.json)'));
+    return { name, context: { role: '', affiliations: [] } };
+  }
+
+  const role = await input({
+    message: 'Your current role / title?',
+    default: '',
+  });
+  const affiliationsRaw = await input({
+    message: 'Affiliations (schools, employers, communities — comma-separated)?',
+    default: '',
+  });
+  const affiliations = affiliationsRaw
+    .split(',')
+    .map((s) => s.trim())
+    .filter(Boolean);
+  return { name, context: { role, affiliations } };
+}

package/src/wizard/quadrants.js

@@ -0,0 +1,124 @@
+import { confirm, checkbox } from '@inquirer/prompts';
+import { c } from '../utils/colors.js';
+
+/**
+ * Map of off-by-default quadrant id → keywords whose presence in a user's
+ * `role` or `affiliations` strongly implies that quadrant applies. Used by
+ * Step 4 to auto-flip matching quadrants on so users don't have to re-route
+ * through the granular checkbox.
+ *
+ * Keep substrings narrow enough to avoid false positives (e.g. don't include
+ * a bare "lead" — too many unrelated matches like "leading edge").
+ */
+export const KEYWORD_TO_QUADRANT = {
+  leadership: [
+    'president', 'vice president', 'vp ',
+    'captain', 'officer', 'chair', 'chief',
+    'head of', 'coordinator', 'treasurer', 'secretary',
+    'club lead', 'team lead', 'leadership', 'organizer',
+  ],
+  infra: [
+    'infra', 'devops', 'sre', 'platform engineer',
+    'tooling', 'automation', 'automations', 'maintainer',
+  ],
+};
+
+/**
+ * Returns { quadrantId: matchedKeyword, ... } for any keywords found in the
+ * user's role or affiliations. Pure function — exported for testability.
+ */
+export function detectQuadrantSignals(profile) {
+  const text = `${profile?.context?.role ?? ''} ${(profile?.context?.affiliations ?? []).join(' ')}`.toLowerCase();
+  const matches = {};
+  for (const [quadrantId, keywords] of Object.entries(KEYWORD_TO_QUADRANT)) {
+    const hit = keywords.find((k) => text.includes(k));
+    if (hit) matches[quadrantId] = hit;
+  }
+  return matches;
+}
+
+/**
+ * Step 4: take template quadrants, auto-flip any matched by user's profile,
+ * ask "use defaults?", optionally edit via checkbox.
+ */
+export async function askQuadrants(templateQuadrants, profile) {
+  console.log(c.bold('\nStep 4 of 7 — Quadrants'));
+
+  // Auto-detect quadrants the user implicitly mentioned in their profile
+  const matches = detectQuadrantSignals(profile);
+
+  // Adjust template: flip matched + previously-off quadrants on, bump cold → lukewarm.
+  // Don't touch quadrants that were already active.
+  const adjusted = templateQuadrants.map((q) => {
+    if (matches[q.id] && !q.active) {
+      return { ...q, active: true, priority: q.priority === 'cold' ? 'lukewarm' : q.priority };
+    }
+    return q;
+  });
+
+  // Surface what was auto-detected so the user sees why a quadrant flipped on
+  const newlyActive = Object.keys(matches).filter((id) => {
+    const wasActive = templateQuadrants.find((q) => q.id === id)?.active;
+    return !wasActive && adjusted.find((q) => q.id === id)?.active;
+  });
+  if (newlyActive.length > 0) {
+    console.log('');
+    console.log(c.dim('Auto-detected from your profile:'));
+    for (const id of newlyActive) {
+      const q = adjusted.find((qq) => qq.id === id);
+      console.log(`  ${c.cyan('•')} matched ${c.bold(`"${matches[id]}"`)} → suggesting "${q.name}" turned on (uncheck below if not relevant)`);
+    }
+  }
+
+  console.log('');
+  console.log(c.dim('Your persona suggests these life quadrants:'));
+  for (const q of adjusted) {
+    const status = q.active ? c.ok('[active]') : c.dim('[ off  ]');
+    console.log(`  ${status} ${q.name.padEnd(36)} ${c.dim(q.path.padEnd(24))} priority: ${formatPriority(q.priority)}`);
+  }
+  console.log('');
+
+  const useDefaults = await confirm({
+    message: 'Use these defaults? (you can edit lifeos.config.json afterward)',
+    default: true,
+  });
+
+  if (useDefaults) {
+    return adjusted;
+  }
+
+  // Granular: pick which to activate
+  const activeIds = await checkbox({
+    message: 'Which quadrants should be active?',
+    choices: adjusted.map((q) => ({
+      name: `${q.name}  ${c.dim(q.path)}`,
+      value: q.id,
+      checked: q.active,
+    })),
+  });
+  const activeSet = new Set(activeIds);
+  return adjusted.map((q) => ({
+    ...q,
+    active: activeSet.has(q.id),
+    // If user just turned it on but template had it cold-by-default, bump to warm
+    priority: !q.active && activeSet.has(q.id) && q.priority === 'cold' ? 'warm' : q.priority,
+  }));
+}
+
+// Pad to visible width 8 BEFORE colorizing — chalk's ANSI escape codes throw
+// off .length-based padEnd alignment otherwise. Same fix as council.js.
+function formatPriority(p) {
+  const padded = p.padEnd(8);
+  switch (p) {
+    case 'hot':
+      return c.err(padded);
+    case 'warm':
+      return c.warn(padded);
+    case 'lukewarm':
+      return c.cyan(padded);
+    case 'cold':
+      return c.dim(padded);
+    default:
+      return padded;
+  }
+}

package/templates/README.md

@@ -0,0 +1,86 @@
+# LifeOS templates — v0.2
+
+This directory contains the v0.2 building blocks the CLI scaffold (`npx @sbains2/lifeos`, designed in `_docs/cli-design.md`, not yet implemented) will assemble during onboarding. Until the CLI exists, the templates can be wired up by hand following the manual install below.
+
+## Trust defaults
+
+LifeOS is designed to be safe-by-default. The single most-cited objection from early user interviews was *privacy and reputation* — users want autonomous agents but are scared of automated outreach blowing up their reputation, or sensitive data leaking to third parties. The defaults below address both. Each can be opted out of explicitly; none are silent.
+
+| Default | What it means | How to override |
+|---|---|---|
+| **Local-first storage** | Your `lifeos.config.json`, council prompts, brain output, and memory all live on your machine. LifeOS itself makes no network calls except optionally fetching the MCP registry from the LifeOS GitHub on first install (cached locally thereafter). | If you opt into the future hosted tier, the per-user data residency commitment is documented separately. |
+| **Draft-only outreach** | The Gmail MCP ships with `config_overrides.send_permission: false`. Council members and automations can *draft* messages but cannot send them — drafts land in your inbox or in a `pending_outreach.md` file for your review. | Set `send_permission: true` on the Gmail MCP in your config. The wizard will warn before doing this. |
+| **Env vars referenced by name only** | Auth tokens (`GITHUB_PERSONAL_ACCESS_TOKEN`, `GMAIL_OAUTH_TOKEN`, etc.) are referenced in the config by *name*, never by value. Token values stay in your shell environment or a secrets manager — they're never copied into the config file, never logged, never sent in telemetry. | n/a — this is non-negotiable in the schema. |
+| **Telemetry is opt-in and anonymous** | If the future CLI ships telemetry, it's opt-in only at install time, anonymous, and limited to install count + wizard completion time. No content, no identifiers, no MCP usage. | Decline the prompt at install time, or never enable in your config. |
+| **Council convenings run against local files** | The brain index (graphify), council prompts, and quadrant content all live in your repo. Convenings read from local; nothing is uploaded. | The hosted tier (post-v1) will offer optional cloud-side convening with explicit per-user encryption — opt-in only. |
+
+**Plain-English summary for the README and the Loom:**
+> Your data stays on your machine. Outreach is drafted, never sent. You hit send. LifeOS makes no claims to your tokens or your inbox.
+
+If you find a default that doesn't match these commitments, file an issue — that's a bug, not a feature.
+
+---
+
+## What's new in v0.2
+
+- `user.context.foci[]` replaces `current_focus: string` — short-term and long-term focus are now first-class
+- `priority: hot | warm | lukewarm | cold` enum on quadrants, council members, and foci replaces boolean `active`
+- Persona templates ship with **rich defaults** — all common patterns present, optional ones at `cold` or `active: false`. Users trim down rather than imagining what to add.
+- Persona template council rosters now include all 10 council members with appropriate priorities (was 6-7 in v0.1)
+- Optional **Leadership** quadrant added to grad-student template (covers TA coordinator, club officer, RA, etc.)
+- Optional **Tooling & Automations** quadrant added to grad-student and early-career-ic templates
+- `performance_coach` now in all three persona councils (was IC-only in v0.1)
+- `mcp_servers[]` carry id + `config_overrides` only; registry is the source of truth for runtime/auth/install metadata
+- Templates are **generic** — no specific user's data leaks into the templates themselves
+
+## Layout
+
+```
+templates/
+  SCHEMA.md              # The lifeos.config.json v0.2 schema spec
+  README.md              # This file
+  personas/
+    grad-student.json    # Persona-specific config templates — copy one to ./lifeos.config.json
+    early-career-ic.json
+    solo-researcher.json
+  council/
+    *.md                 # System prompts for council members. Persona configs reference these by path.
+  mcps/
+    registry.json        # Curated catalog of MCP servers. The CLI uses this to map app stack → suggested MCPs.
+```
+
+## Manual install (until CLI exists)
+
+1. Pick a persona from `templates/personas/` and copy it to `./lifeos.config.json` at your repo root.
+2. Edit `user.name`, `user.context.role`, `user.context.affiliations` to match you.
+3. Edit `user.context.foci[]` — replace placeholder descriptions with your actual quarter and year focus. Set priority for each.
+4. Walk `quadrants[]` — for each one:
+   - Decide if it applies. Toggle `active: true | false`.
+   - Set `priority: hot | warm | lukewarm | cold` for the active ones.
+   - Adjust the `path:` to match your folder layout.
+5. Walk `council[]` — adjust each member's `priority` based on your current life. `cold` means disabled.
+6. Trim `mcp_servers[]` to what you actually use. For each one, follow the install hint in `templates/mcps/registry.json` and set the appropriate env var / OAuth token.
+7. Copy `templates/council/*.md` into `./.claude/agents/council/` so the `system_prompt_path` references resolve.
+8. Create the folders for each `active: true` quadrant (`mkdir -p ./Classes ./Research ./JobSearch ...`).
+9. Optionally create `./writing_style.md` to anchor written-output council members; or remove `writing_style_path` from your config if you skip it.
+
+Total time for a careful install: ~10 minutes. The CLI's job is to compress this to <2 minutes (see `_docs/cli-design.md`).
+
+## What's NOT in v0.2 yet
+
+- The `npx @sbains2/lifeos` CLI itself (designed in `_docs/cli-design.md`, not implemented)
+- Runtime executor for `auto_actions` (declared in schema; no executor)
+- Runtime context-tool that consumes `priority` at convening time (specified in SCHEMA.md, not implemented)
+- Graphify daemon mode (only `refresh: "manual"` works)
+- `lifeos doctor` / `lifeos brain` / `lifeos migrate` commands
+- A JSON-Schema file for machine validation (SCHEMA.md is human-readable only)
+- `entities[]` top-level for off-repo things — deferred to v0.3
+- Composable `secondary_personas[]` for hybrid users — deferred
+
+## Versioning
+
+Files are at `version: "0.2"`. Expect breaking changes through v0.x. v1.0 is the first stability commitment.
+
+## Contributing
+
+Don't yet — this is single-author scaffolding. Templates will open for community contribution once v0.3+ stabilizes the schema and the CLI ships.