@sbains2/lifeos 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LifeOS contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,122 @@
+# @sbains2/lifeos
+
+Scaffold a personal LifeOS — life-quadrant folders, a council of AI agent voices, and curated MCP wiring.
+
+> ⚠️ **BETA — early seed release.** v0.1.2. See [../BETA.md](../BETA.md) for what's stable vs not.
+
+## Usage
+
+```bash
+# Full wizard (~2-4 minutes for thoughtful first install)
+npx @sbains2/lifeos [target-dir]
+
+# Speed-optimized: skips longer-arc focus + role/affiliations + all
+# quadrant/council/MCP confirmations. Uses template defaults everywhere.
+# Target: <60 seconds.
+npx @sbains2/lifeos [target-dir] --minimal
+
+# Show help
+npx @sbains2/lifeos --help
+```
+
+If `target-dir` is omitted, the CLI scaffolds into the current working directory.
+
+## What it does
+
+7-step wizard:
+
+1. **Persona** — pick grad-student / early-career-ic / solo-researcher
+2. **Profile** — name, role, affiliations
+3. **Foci** — what you're working toward (now / quarter / year / arc) with priority enum
+4. **Quadrants** — auto-detects keywords (e.g. "president" → flips Leadership Role on); confirm or customize
+5. **Council** — 10 voices with priority defaults from your persona
+6. **Apps & MCPs** — checkbox of suggested servers, trust defaults applied
+7. **Validate + generate** — refuses to write invalid configs; scaffolds folders + council files + INSTALL_MCPS.md + lifeos.config.json
+
+## Trust defaults
+
+- **Local-first.** No network calls.
+- **Draft-only outreach.** Gmail and similar MCPs ship with `send_permission: false`.
+- **Tokens by env-var name only.** Auth tokens stay in your shell environment — never copied into config files, never logged.
+- **Validation before write.** Refuses to write a config that fails any cross-reference check. No partial writes.
+
+See [../docs/TRUST.md](../docs/TRUST.md) for the full commitments.
+
+## Now what? (post-install workflow)
+
+After the wizard prints `Done in Xm Ys.`, here's the path from "scaffold exists" to "council convenes on real artifacts":
+
+### 1. Wire your MCP servers (10-30 min the first time)
+
+Open `.lifeos/INSTALL_MCPS.md` in the scaffolded directory. For each MCP listed:
+
+- Read the install hint (most point to a Smithery search or specific GitHub repo)
+- Install the MCP via the recommended method (usually `npx` or `uvx` — no Docker for v0.1 picks)
+- Set the auth env var in your shell (`export GITHUB_PERSONAL_ACCESS_TOKEN=...`, etc. — see each MCP's docs)
+- Verify the MCP shows up in your Claude Code config (`~/.claude/settings.json` or your IDE's MCP settings)
+
+### 2. Open the folder in Claude Code
+
+```bash
+cd <your-scaffolded-dir>
+claude
+```
+
+(Or open in your IDE if you use the Claude Code IDE integration.)
+
+Claude Code will pick up `lifeos.config.json` and the `.claude/agents/council/` files automatically — they're conventional locations.
+
+### 3. Try a council convening on a real artifact
+
+The fastest way to feel the difference between LifeOS and "ChatGPT, please review my X" is to convene multiple council voices on a single artifact. Examples that work today:
+
+- **Resume / job-search:** *"Read my resume PDF in JobSearch/. Convene Career Coach, Writing Critic, Network Builder, and Devil's Advocate. Give me their reads as one synthesized session report. Write the result to JobSearch/council-sessions/[date]-resume-review.md."*
+- **Class deliverable:** *"Look at my draft for [class] in Classes/. Convene Academic Advisor + Writing Critic. What's the methodological weakness most likely to undermine the argument?"*
+- **Code change:** *"Read my recent commits in SideProjects/[repo]. Convene Tech Lead + Devil's Advocate. Surface the load-bearing assumption and the test that would falsify it cheaply."*
+- **Week ahead:** *"Look at my Google Calendar via the calendar MCP and my open quadrant folders. Convene Time Manager + Performance Coach. What's at risk this week and what would the highest-leverage block of focused time look like?"*
+
+The council members are in `.claude/agents/council/` — read them to see what each voice is for.
+
+### 4. Edit `lifeos.config.json` to tune
+
+The wizard accepts defaults at v0.1; granular per-member adjustment in the wizard is planned for v0.2. For now, just open the file and adjust:
+
+- **Council priorities:** change `priority: "warm"` to `"hot"` for voices you want emphasized in synthesis sections, `"cold"` to disable
+- **Quadrant priorities:** elevate `"hot"` for what's in the limelight this quarter
+- **Foci:** add or remove entries; tune horizons and priorities
+- **MCPs:** add `config_overrides` to tune per-server behavior (e.g., `send_permission: true` to enable Gmail send if you're sure)
+
+Re-running `npx @sbains2/lifeos` against the same dir will prompt before overwriting your config.
+
+### 5. Add your own quadrant or council member
+
+Adding a quadrant: edit `quadrants[]` in your config, set `active: true`, set a `priority`, list `council_member_ids` and `mcp_server_ids` to wire, then `mkdir <path>` to create the folder.
+
+Adding a council member: drop a markdown file in `.claude/agents/council/<name>.md` with the system prompt, then add an entry to `council[]` in your config with `id`, `name`, `system_prompt_path`, and `priority`.
+
+The CLI's validation will refuse the config if any reference is broken — re-run `npx @sbains2/lifeos --help` to see flags, or just re-edit and re-validate manually with `node cli/test/smoke-scaffold.mjs` (during local dev).
+
+## Local development
+
+```bash
+git clone <repo>
+cd lifeos/cli
+npm install
+node --test test/*.test.js   # unit tests (validate + quadrants)
+node test/smoke-scaffold.mjs # end-to-end scaffold pipeline test
+npm start ~/lifeos-trial     # run the wizard against a fresh dir
+```
+
+The bundled templates at `cli/templates/` are the canonical copy. The `npm run sync-templates` script (legacy from when templates were duplicated at the repo root) is a no-op in this repo.
+
+## Status
+
+v0.1.2 — second runnable iteration after first cold-start trial. See [../CHANGELOG.md](../CHANGELOG.md) for what shipped when.
+
+What's NOT yet implemented (see [../BETA.md](../BETA.md)):
+- `lifeos doctor` / `brain` / `migrate` commands
+- Granular per-quadrant / per-council priority adjustment in the wizard
+- `~/.lifeos/wizard-history.json` reuse for second-machine installs
+- Custom-persona path
+- Telemetry plumbing
+- `npm publish` (install via `git clone` for now)

package/bin/lifeos.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+import { run } from '../src/index.js';
+
+// Parse argv: positional target dir + flags
+// Usage: lifeos [target-dir] [--minimal]
+const args = process.argv.slice(2);
+const flags = new Set(args.filter((a) => a.startsWith('--')));
+const positional = args.filter((a) => !a.startsWith('--'));
+
+if (flags.has('--help') || flags.has('-h')) {
+  console.log(`lifeos — scaffold a personal LifeOS
+
+Usage:
+  lifeos [target-dir] [options]
+
+Options:
+  --minimal     Skip optional substantive prompts (longer-arc focus,
+                quadrant/council/MCP confirmations). Uses template
+                defaults everywhere. Target install time: < 60 seconds.
+  --help, -h    Show this help
+
+Arguments:
+  target-dir    Directory to scaffold into (default: current working dir)
+
+Examples:
+  lifeos                       # scaffold into current dir, full wizard
+  lifeos ~/my-lifeos           # scaffold into ~/my-lifeos
+  lifeos ~/my-lifeos --minimal # speed-optimized install
+`);
+  process.exit(0);
+}
+
+const targetDir = positional[0] ?? process.cwd();
+const options = {
+  minimal: flags.has('--minimal'),
+};
+
+run(targetDir, options).catch((err) => {
+  // Inquirer throws ExitPromptError when user hits Ctrl+C — handle gracefully
+  if (err?.name === 'ExitPromptError') {
+    console.log('\nCancelled.');
+    process.exit(0);
+  }
+  console.error('\nFailed:', err.stack ?? err.message ?? err);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@sbains2/lifeos",
+  "version": "0.1.3",
+  "description": "Scaffold a personal LifeOS — life-quadrant folders, a council of AI agent voices, and curated MCP wiring. Generates a working lifeos.config.json + .claude/agents/council/ in 2-4 minutes (or <60s with --minimal). BETA — early seed release.",
+  "type": "module",
+  "bin": {
+    "lifeos": "bin/lifeos.js"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "files": [
+    "bin",
+    "src",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "start": "node bin/lifeos.js",
+    "test": "node --test test/*.test.js",
+    "sync-templates": "rm -rf templates && cp -R ../templates ./templates"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.2.0",
+    "chalk": "^5.3.0"
+  },
+  "keywords": [
+    "lifeos",
+    "agent",
+    "agents",
+    "council",
+    "mcp",
+    "model-context-protocol",
+    "claude-code",
+    "scaffold",
+    "cli",
+    "wizard"
+  ],
+  "author": "sbains2",
+  "license": "MIT",
+  "homepage": "https://github.com/sbains2/lifeos#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sbains2/lifeos.git",
+    "directory": "cli"
+  },
+  "bugs": {
+    "url": "https://github.com/sbains2/lifeos/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/cleanup.js

@@ -0,0 +1,28 @@
+/**
+ * After Step 6 (Apps & MCPs) the user may have unchecked an MCP server that
+ * a quadrant's `mcp_server_ids[]` still references. Validation will then fail
+ * at Step 7 with no path to fix without restarting the wizard.
+ *
+ * This module cleans up dangling references: filter each quadrant's
+ * `mcp_server_ids[]` to only include MCPs that are actually wired.
+ *
+ * Pure function — exported for testability.
+ *
+ * Returns { cleaned, removed }:
+ *   cleaned: the quadrants array with dangling refs removed
+ *   removed: [{ quadrantId, dropped: [mcpId, ...] }] — what was filtered, for surfacing to the user
+ */
+export function cleanupQuadrantMcpRefs(quadrants, wiredMcps) {
+  const wiredIds = new Set((wiredMcps ?? []).map((m) => m.id));
+  const removed = [];
+  const cleaned = (quadrants ?? []).map((q) => {
+    const orig = q.mcp_server_ids ?? [];
+    const filtered = orig.filter((id) => wiredIds.has(id));
+    if (filtered.length !== orig.length) {
+      const dropped = orig.filter((id) => !wiredIds.has(id));
+      removed.push({ quadrantId: q.id, dropped });
+    }
+    return { ...q, mcp_server_ids: filtered };
+  });
+  return { cleaned, removed };
+}

package/src/index.js

@@ -0,0 +1,131 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { confirm } from '@inquirer/prompts';
+import { loadPersonaTemplate } from './templates-loader.js';
+import { askPersona } from './wizard/persona.js';
+import { askProfile } from './wizard/profile.js';
+import { askFoci } from './wizard/foci.js';
+import { askQuadrants, detectQuadrantSignals } from './wizard/quadrants.js';
+import { askCouncil } from './wizard/council.js';
+import { askMcps } from './wizard/mcps.js';
+import { validateAndGenerate } from './wizard/generate.js';
+import { cleanupQuadrantMcpRefs } from './cleanup.js';
+import { startTimer, elapsed } from './utils/timer.js';
+import { c } from './utils/colors.js';
+
+export async function run(targetDir, options = {}) {
+  const { minimal = false } = options;
+
+  console.log('');
+  console.log(c.bold('lifeos') + c.dim(' v0.1.3 — scaffold a personal LifeOS'));
+  console.log(c.dim(`Target directory: ${targetDir}`));
+  if (minimal) {
+    console.log(c.dim('Mode: --minimal (speed-optimized; using template defaults for quadrants, council, MCPs)'));
+  }
+
+  // Refuse to overwrite an existing config without explicit confirmation
+  const existingConfig = join(targetDir, 'lifeos.config.json');
+  if (existsSync(existingConfig)) {
+    console.log('');
+    console.log(c.warn(`A lifeos.config.json already exists at ${existingConfig}.`));
+    const overwrite = await confirm({
+      message: 'Overwrite it? (you should probably back it up first)',
+      default: false,
+    });
+    if (!overwrite) {
+      console.log(c.dim('Cancelled. No files written.'));
+      return;
+    }
+  }
+
+  const start = startTimer();
+
+  // Step 1
+  const personaId = await askPersona();
+  const template = loadPersonaTemplate(personaId);
+
+  // Step 2
+  const profile = await askProfile({ minimal });
+
+  // Step 3
+  const foci = await askFoci({ minimal });
+
+  // Step 4 — full wizard auto-detects leadership/infra from profile.
+  // In --minimal mode we still apply the auto-detection (it's free) but skip
+  // the user confirmation on the resulting list.
+  let quadrants;
+  if (minimal) {
+    const matches = detectQuadrantSignals(profile);
+    quadrants = template.quadrants.map((q) => {
+      if (matches[q.id] && !q.active) {
+        return { ...q, active: true, priority: q.priority === 'cold' ? 'lukewarm' : q.priority };
+      }
+      return q;
+    });
+  } else {
+    quadrants = await askQuadrants(template.quadrants, profile);
+  }
+
+  // Step 5 — council
+  const council = minimal ? template.council : await askCouncil(template.council);
+
+  // Step 6 — MCPs
+  const mcps = minimal ? template.mcp_servers : await askMcps(template.mcp_servers);
+
+  // Auto-cleanup: if the user unchecked any MCP at Step 6 that a quadrant
+  // still references, remove the dangling reference so validation passes.
+  // (Reported as a bug 2026-05-01 — friend tester unchecked zotero and the
+  // research quadrant still referenced it, blocking the entire install.)
+  const { cleaned: cleanedQuadrants, removed: cleanupReport } = cleanupQuadrantMcpRefs(quadrants, mcps);
+  if (cleanupReport.length > 0) {
+    console.log('');
+    console.log(c.dim('Auto-cleaned quadrant MCP refs after your Step 6 selections:'));
+    for (const r of cleanupReport) {
+      console.log(c.dim(`  ${c.dot} ${r.quadrantId}: removed [${r.dropped.join(', ')}] (not wired)`));
+    }
+  }
+
+  // Assemble final config
+  const config = {
+    $schema: template.$schema,
+    version: template.version,
+    user: {
+      name: profile.name,
+      persona: personaId,
+      context: {
+        role: profile.context.role,
+        affiliations: profile.context.affiliations,
+        foci,
+      },
+    },
+    quadrants: cleanedQuadrants,
+    council,
+    mcp_servers: mcps,
+    agent_runtime: template.agent_runtime,
+    brain: {
+      ...template.brain,
+      graphify: {
+        ...template.brain.graphify,
+        // Reduce graphify paths to active quadrants only
+        paths: cleanedQuadrants.filter((q) => q.active).map((q) => q.path),
+      },
+    },
+    writing_style_path: template.writing_style_path,
+  };
+
+  // Step 7 — validate + scaffold
+  const result = await validateAndGenerate(config, { targetDir, minimal });
+
+  console.log('');
+  if (result.ok) {
+    console.log(c.bold(c.ok('Done')) + ` in ${elapsed(start)}.`);
+    console.log('');
+    console.log(c.bold('Next:'));
+    console.log(`  ${c.arrow} Wire your MCP servers (see .lifeos/INSTALL_MCPS.md)`);
+    console.log(`  ${c.arrow} Open this folder in Claude Code and try convening the council on a real artifact`);
+    console.log(`  ${c.arrow} Edit lifeos.config.json to tune council priorities, add quadrants, or change foci`);
+    console.log('');
+  } else {
+    console.log(c.dim(`Aborted after ${elapsed(start)}.`));
+  }
+}

package/src/scaffold.js

@@ -0,0 +1,147 @@
+import { mkdirSync, writeFileSync, copyFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { templatesDir, loadRegistry } from './templates-loader.js';
+import { c } from './utils/colors.js';
+
+/**
+ * Generate the full LifeOS scaffold for a validated config.
+ * Returns a list of created paths so the caller can summarize.
+ */
+export function scaffold(config, { targetDir }) {
+  const created = [];
+
+  // Active quadrant folders + placeholder READMEs
+  for (const q of config.quadrants) {
+    if (!q.active) continue;
+    const dir = join(targetDir, q.path);
+    mkdirSync(dir, { recursive: true });
+    const readme = join(dir, 'README.md');
+    if (!existsSync(readme)) {
+      writeFileSync(readme, quadrantReadme(q), 'utf8');
+      created.push(`${q.path}/README.md`);
+    } else {
+      created.push(`${q.path}/  (folder existed; README preserved)`);
+    }
+  }
+
+  // .claude/agents/council/ + copy referenced council prompt files
+  const councilDir = join(targetDir, '.claude', 'agents', 'council');
+  mkdirSync(councilDir, { recursive: true });
+  const seenCouncil = new Set();
+  for (const member of config.council) {
+    const filename = member.system_prompt_path.split('/').pop();
+    if (seenCouncil.has(filename)) continue;
+    seenCouncil.add(filename);
+    const src = join(templatesDir(), 'council', filename);
+    const dest = join(councilDir, filename);
+    if (existsSync(dest)) {
+      created.push(`.claude/agents/council/${filename}  (preserved — user customization not overwritten)`);
+    } else {
+      copyFileSync(src, dest);
+      created.push(`.claude/agents/council/${filename}`);
+    }
+  }
+
+  // .lifeos/ scaffold
+  const lifeosDir = join(targetDir, '.lifeos');
+  mkdirSync(join(lifeosDir, 'memory'), { recursive: true });
+  mkdirSync(join(lifeosDir, 'brain'), { recursive: true });
+  created.push('.lifeos/memory/');
+  created.push('.lifeos/brain/');
+
+  // INSTALL_MCPS.md
+  const installPath = join(lifeosDir, 'INSTALL_MCPS.md');
+  writeFileSync(installPath, installMcpsDoc(config), 'utf8');
+  created.push('.lifeos/INSTALL_MCPS.md');
+
+  // Finally: lifeos.config.json (last so we don't leave a config pointing at unbuilt scaffolding)
+  const configPath = join(targetDir, 'lifeos.config.json');
+  writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
+  created.push('lifeos.config.json');
+
+  return created;
+}
+
+function quadrantReadme(q) {
+  return `# ${q.name}
+
+${q.description ?? ''}
+
+This folder is the home of your **${q.id}** quadrant. The LifeOS council members assigned to it will read files here as context when convened.
+
+## Council members assigned
+
+${(q.council_member_ids ?? []).map((id) => `- \`${id}\``).join('\n') || '_none_'}
+
+## MCP servers wired
+
+${(q.mcp_server_ids ?? []).map((id) => `- \`${id}\``).join('\n') || '_none_'}
+
+## Priority
+
+\`${q.priority}\` — change in \`lifeos.config.json\` to adjust how much airtime this quadrant gets in cross-quadrant convenings.
+`;
+}
+
+function installMcpsDoc(config) {
+  let registry;
+  try {
+    registry = loadRegistry();
+  } catch {
+    registry = { servers: [] };
+  }
+  const byId = new Map(registry.servers.map((s) => [s.id, s]));
+
+  const lines = [
+    '# Installing your MCP servers',
+    '',
+    'This file was generated by `npx @sbains2/lifeos`. Each MCP server below was wired into your `lifeos.config.json` based on the apps you said you use. Follow the install hint for each, then set the auth env var in your shell so Claude Code (or your chosen agent runtime) can use it.',
+    '',
+    '## Trust defaults applied',
+    '',
+    '- Auth tokens stay in your shell environment. They are never copied into your config file or logged by LifeOS.',
+    '- Outreach-capable MCPs (Gmail, LinkedIn) ship draft-only — they cannot send messages on your behalf without an explicit config override.',
+    '- All operations are local. LifeOS itself does not phone home.',
+    '',
+    '---',
+    '',
+  ];
+
+  for (const m of config.mcp_servers) {
+    const meta = byId.get(m.id) ?? null;
+    lines.push(`## \`${m.id}\``);
+    lines.push('');
+    if (meta) {
+      lines.push(`**${meta.name}** — ${meta.description}`);
+      lines.push('');
+      lines.push(`- Auth: ${meta.auth?.method ?? 'unknown'}${meta.auth?.env_var ? ` (env var: \`${meta.auth.env_var}\`)` : ''}`);
+      lines.push(`- Install hint: ${meta.install_hint ?? '_none_'}`);
+      if (meta.useful_for_personas?.length) {
+        lines.push(`- Useful for: ${meta.useful_for_personas.join(', ')}`);
+      }
+    } else {
+      lines.push(`_Not in the bundled registry. Add install steps manually._`);
+    }
+    if (m.config_overrides) {
+      lines.push('');
+      lines.push('Config overrides applied in `lifeos.config.json`:');
+      lines.push('```json');
+      lines.push(JSON.stringify(m.config_overrides, null, 2));
+      lines.push('```');
+    }
+    lines.push('');
+    lines.push('---');
+    lines.push('');
+  }
+
+  return lines.join('\n');
+}
+
+/**
+ * Print a one-line summary per created path.
+ */
+export function printScaffoldReport(created) {
+  for (const p of created) {
+    console.log(`  ${c.check} ${p}`);
+  }
+}

package/src/templates-loader.js

@@ -0,0 +1,34 @@
+import { readFileSync, readdirSync, existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const TEMPLATES_DIR = join(__dirname, '..', 'templates');
+
+export const PERSONA_IDS = ['grad-student', 'early-career-ic', 'solo-researcher'];
+
+export function loadPersonaTemplate(personaId) {
+  const path = join(TEMPLATES_DIR, 'personas', `${personaId}.json`);
+  if (!existsSync(path)) {
+    throw new Error(`Unknown persona: ${personaId}. Available: ${PERSONA_IDS.join(', ')}`);
+  }
+  return JSON.parse(readFileSync(path, 'utf8'));
+}
+
+export function loadRegistry() {
+  const path = join(TEMPLATES_DIR, 'mcps', 'registry.json');
+  return JSON.parse(readFileSync(path, 'utf8'));
+}
+
+export function listCouncilFiles() {
+  const dir = join(TEMPLATES_DIR, 'council');
+  return readdirSync(dir).filter((f) => f.endsWith('.md'));
+}
+
+export function readCouncilFile(filename) {
+  return readFileSync(join(TEMPLATES_DIR, 'council', filename), 'utf8');
+}
+
+export function templatesDir() {
+  return TEMPLATES_DIR;
+}

package/src/utils/colors.js

@@ -0,0 +1,14 @@
+import chalk from 'chalk';
+
+export const c = {
+  ok: (s) => chalk.green(s),
+  warn: (s) => chalk.yellow(s),
+  err: (s) => chalk.red(s),
+  dim: (s) => chalk.dim(s),
+  bold: (s) => chalk.bold(s),
+  cyan: (s) => chalk.cyan(s),
+  check: chalk.green('✓'),
+  cross: chalk.red('✗'),
+  dot: chalk.dim('·'),
+  arrow: chalk.cyan('→'),
+};

package/src/utils/timer.js

@@ -0,0 +1,12 @@
+export function startTimer() {
+  return Date.now();
+}
+
+export function elapsed(startMs) {
+  const ms = Date.now() - startMs;
+  const totalSec = Math.round(ms / 1000);
+  const min = Math.floor(totalSec / 60);
+  const sec = totalSec % 60;
+  if (min === 0) return `${sec}s`;
+  return `${min}m ${sec}s`;
+}