@sbains2/lifeos 0.2.2 → 0.3.1

package/bin/lifeos.js

@@ -1,15 +1,52 @@
 #!/usr/bin/env node
+import { resolve } from 'node:path';
 import { run } from '../src/index.js';
 import { runDoctorCommand } from '../src/commands/doctor.js';
 import { runBrainCommand } from '../src/commands/brain.js';
+import { runContext } from '../src/commands/context.js';
+import { runSchedule } from '../src/commands/schedule.js';
 
 // Parse argv: optional subcommand + positional target dir + flags
 // Usage:
 //   lifeos [target-dir] [--minimal]              # wizard (default)
 //   lifeos doctor [target-dir] [--json] [--quiet] [--strict]
 const args = process.argv.slice(2);
-const flags = new Set(args.filter((a) => a.startsWith('--')));
-const positional = args.filter((a) => !a.startsWith('--') && !a.startsWith('-'));
+
+// `schedule` dispatches EARLY, before the global flag/positional parsing:
+// its value flags (--prompt <file>, --every 1d, ...) would otherwise be
+// misread as positional args and corrupt targetDir resolution. It also owns
+// its own --help (so `lifeos schedule --help` prints the schedule help, not
+// the global help). schedule operates on cwd — no positional target-dir arg.
+if (args[0] === 'schedule') {
+  const exitCode = await runSchedule(resolve(process.cwd()), args.slice(1));
+  process.exit(exitCode);
+}
+
+// `context`'s --quadrant takes a value; extract flag + value before the
+// global parser treats the value as a positional target dir.
+let quadrantId = null;
+let filteredArgs = args;
+const qIdx = args.indexOf('--quadrant');
+if (qIdx !== -1) {
+  const qVal = args[qIdx + 1];
+  if (qVal !== undefined && !qVal.startsWith('-')) {
+    quadrantId = qVal;
+    filteredArgs = args.filter((_, i) => i !== qIdx && i !== qIdx + 1);
+  } else {
+    // dangling `--quadrant` (no value, or followed by another flag): drop only
+    // the flag so a trailing --json/--help isn't swallowed as its value.
+    filteredArgs = args.filter((_, i) => i !== qIdx);
+  }
+} else {
+  const qEq = args.find((a) => a.startsWith('--quadrant='));
+  if (qEq) {
+    quadrantId = qEq.split('=')[1];
+    filteredArgs = args.filter((a) => a !== qEq);
+  }
+}
+
+const flags = new Set(filteredArgs.filter((a) => a.startsWith('--')));
+const positional = filteredArgs.filter((a) => !a.startsWith('--') && !a.startsWith('-'));
 
 if (flags.has('--help') || flags.has('-h') || positional[0] === 'help') {
   console.log(`lifeos — scaffold and verify a personal LifeOS
@@ -17,6 +54,8 @@ if (flags.has('--help') || flags.has('-h') || positional[0] === 'help') {
 Usage:
   lifeos [target-dir] [options]                   # run the wizard
   lifeos doctor [target-dir] [options]            # verify scaffold health
+  lifeos context [target-dir] [options]           # print the convening context block
+  lifeos schedule <add|list|remove> [options]     # run agent prompts on a schedule
   lifeos --help                                   # show this
 
 Wizard options:
@@ -37,6 +76,16 @@ Brain options:
   --dry-run     Show what would run without invoking graphify
   --json        Emit machine-readable JSON (for CI / scripting)
 
+Context options:
+  --json            Emit the same data as structured JSON (for runtimes / scripting)
+  --quadrant <id>   Scope output to one quadrant (its council subset; foci stay global)
+
+Schedule subcommands (run \`lifeos schedule --help\` for full details):
+  add <name>    --prompt <file> (--every <n>{d|h} [--at HH:MM] | --cron "<expr>")
+                [--runtime claude-code|codex] [--dry-run]
+  list          Show installed schedules
+  remove <name> Uninstall a schedule (launchd unload on macOS)
+
 Note on brain: lifeos brain shells out to graphify (https://github.com/
 safishamsi/graphify), an OSS knowledge-graph tool. Install once with
 "pip install graphifyy && graphify install". Code parsing is 100% local;
@@ -53,14 +102,21 @@ Examples:
   lifeos doctor                                   # verify current dir
   lifeos doctor ~/my-lifeos                       # verify ~/my-lifeos
   lifeos doctor --json | jq '.summary'            # programmatic check
+  lifeos context ~/my-lifeos                      # convening block to stdout (pipe-friendly)
+  lifeos context --quadrant job-search            # scope to one quadrant's council
+  lifeos schedule add digest --prompt templates/prompts/weekly_digest.md --every 1d
 `);
   process.exit(0);
 }
 
-// Subcommand dispatch
-const subcommand = ['doctor', 'brain', 'migrate'].includes(positional[0]) ? positional[0] : null;
+// Subcommand dispatch (schedule handled earlier — see top of file)
+const subcommand = ['doctor', 'brain', 'migrate', 'context'].includes(positional[0]) ? positional[0] : null;
 const remainingPositional = subcommand ? positional.slice(1) : positional;
-const targetDir = remainingPositional[0] ?? process.cwd();
+// BUGFIX 2026-05-01: always resolve to absolute path. If user passes '.' as
+// the positional arg, downstream `path.join(targetDir, q.path)` collapses to a
+// relative string ('Classes' instead of '/.../lifeos-demo-clean/Classes'),
+// which breaks the validator's parent-writeable check (it walks up to '/').
+const targetDir = resolve(remainingPositional[0] ?? process.cwd());
 
 async function main() {
   if (subcommand === 'doctor') {
@@ -79,6 +135,13 @@ async function main() {
     });
     process.exit(exitCode);
   }
+  if (subcommand === 'context') {
+    const exitCode = await runContext(targetDir, {
+      json: flags.has('--json'),
+      quadrant: quadrantId,
+    });
+    process.exit(exitCode);
+  }
   if (subcommand === 'migrate') {
     console.error(`\nNot yet implemented: \`lifeos migrate\`. See docs/COMMANDS.md for the design.`);
     process.exit(2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sbains2/lifeos",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "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": {
@@ -18,8 +18,7 @@
   ],
   "scripts": {
     "start": "node bin/lifeos.js",
-    "test": "node --test test/*.test.js",
-    "sync-templates": "rm -rf templates && cp -R ../templates ./templates"
+    "test": "node --test test/*.test.js"
   },
   "dependencies": {
     "@inquirer/prompts": "^7.2.0",

package/src/commands/context.js

@@ -0,0 +1,40 @@
+/**
+ * `lifeos context` subcommand orchestrator.
+ *
+ * Thin wrapper around src/context.js — handles flags, output formatting, and
+ * exit codes. The planning/rendering logic (rank foci/quadrants/council by
+ * priority) is pure and lives in context.js.
+ *
+ * Flags:
+ *   --json            Emit the same data as structured JSON (for runtimes / scripting)
+ *   --quadrant <id>   Scope output to one quadrant (its council subset + foci)
+ */
+
+import { planContext, renderContextMarkdown } from '../context.js';
+import { c } from '../utils/colors.js';
+
+export async function runContext(targetDir, flags = {}) {
+  const { json = false, quadrant = null } = flags;
+
+  const plan = planContext(targetDir, { quadrant });
+  if (!plan.ok) {
+    if (json) {
+      console.log(JSON.stringify(plan, null, 2));
+    } else {
+      console.log('');
+      console.log(`  ${c.err('✗')} ${plan.error}`);
+      if (plan.fix) console.log(c.cyan(`     → fix: ${plan.fix}`));
+      console.log('');
+    }
+    return 1;
+  }
+
+  if (json) {
+    console.log(JSON.stringify(plan, null, 2));
+    return 0;
+  }
+
+  // Plain markdown to stdout — no ANSI, so it pipes cleanly into a convening.
+  console.log(renderContextMarkdown(plan));
+  return 0;
+}