@fureworks/scope 0.1.0

package/dist/sources/issues.d.ts

@@ -0,0 +1,14 @@
+export interface IssueSignal {
+    number: number;
+    title: string;
+    url: string;
+    repo: string;
+    ageDays: number;
+    labels: string[];
+}
+export interface IssueScanResult {
+    available: boolean;
+    issues: IssueSignal[];
+}
+export declare function scanAssignedIssues(): Promise<IssueScanResult>;
+//# sourceMappingURL=issues.d.ts.map

package/dist/sources/issues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issues.d.ts","sourceRoot":"","sources":["../../src/sources/issues.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC,CA+CnE"}

package/dist/sources/issues.js

@@ -0,0 +1,34 @@
+export async function scanAssignedIssues() {
+    try {
+        const { execSync } = await import("node:child_process");
+        try {
+            execSync("which gh", { stdio: "pipe" });
+        }
+        catch {
+            return { available: false, issues: [] };
+        }
+        const result = execSync("gh issue list --assignee @me --state open --json number,title,url,createdAt,labels,repository --limit 20", {
+            encoding: "utf-8",
+            timeout: 10000,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        const parsed = JSON.parse(result);
+        const issues = parsed.map((issue) => {
+            const ageDays = (Date.now() - new Date(issue.createdAt).getTime()) /
+                (1000 * 60 * 60 * 24);
+            return {
+                number: issue.number,
+                title: issue.title,
+                url: issue.url,
+                repo: issue.repository?.nameWithOwner || issue.repository?.name || "unknown",
+                ageDays: Math.round(ageDays * 10) / 10,
+                labels: (issue.labels ?? []).map((label) => label.name || "").filter(Boolean),
+            };
+        });
+        return { available: true, issues };
+    }
+    catch {
+        return { available: true, issues: [] };
+    }
+}
+//# sourceMappingURL=issues.js.map

package/dist/sources/issues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issues.js","sourceRoot":"","sources":["../../src/sources/issues.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAExD,IAAI,CAAC;YACH,QAAQ,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAC1C,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,CACrB,0GAA0G,EAC1G;YACE,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CACF,CAAC;QAEF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAO9B,CAAC;QAEH,MAAM,MAAM,GAAkB,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACjD,MAAM,OAAO,GACX,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;gBAClD,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;YAExB,OAAO;gBACL,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,IAAI,EAAE,KAAK,CAAC,UAAU,EAAE,aAAa,IAAI,KAAK,CAAC,UAAU,EAAE,IAAI,IAAI,SAAS;gBAC5E,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,GAAG,EAAE;gBACtC,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;aAC9E,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACzC,CAAC;AACH,CAAC"}

package/dist/store/config.d.ts

@@ -0,0 +1,22 @@
+export interface ScopeConfig {
+    repos: string[];
+    projects: Record<string, {
+        path: string;
+        repos?: string[];
+        description?: string;
+    }>;
+    calendar: {
+        enabled: boolean;
+        backend: "gws";
+    };
+    daemon: {
+        enabled: boolean;
+        intervalMinutes: number;
+    };
+}
+export declare function getScopeDir(): string;
+export declare function ensureScopeDir(): void;
+export declare function configExists(): boolean;
+export declare function loadConfig(): ScopeConfig;
+export declare function saveConfig(config: ScopeConfig): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/store/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/store/config.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CACd,MAAM,EACN;QACE,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CACF,CAAC;IACF,QAAQ,EAAE;QACR,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,KAAK,CAAC;KAChB,CAAC;IACF,MAAM,EAAE;QACN,OAAO,EAAE,OAAO,CAAC;QACjB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAKD,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,wBAAgB,cAAc,IAAI,IAAI,CAQrC;AAED,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED,wBAAgB,UAAU,IAAI,WAAW,CAyBxC;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CA8BpD"}

package/dist/store/config.js

@@ -0,0 +1,74 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { parse as parseToml } from "toml";
+const SCOPE_DIR = join(homedir(), ".scope");
+const CONFIG_PATH = join(SCOPE_DIR, "config.toml");
+export function getScopeDir() {
+    return SCOPE_DIR;
+}
+export function ensureScopeDir() {
+    if (!existsSync(SCOPE_DIR)) {
+        mkdirSync(SCOPE_DIR, { recursive: true });
+    }
+    const contextsDir = join(SCOPE_DIR, "contexts");
+    if (!existsSync(contextsDir)) {
+        mkdirSync(contextsDir, { recursive: true });
+    }
+}
+export function configExists() {
+    return existsSync(CONFIG_PATH);
+}
+export function loadConfig() {
+    if (!configExists()) {
+        return {
+            repos: [],
+            projects: {},
+            calendar: { enabled: false, backend: "gws" },
+            daemon: { enabled: false, intervalMinutes: 15 },
+        };
+    }
+    const raw = readFileSync(CONFIG_PATH, "utf-8");
+    const parsed = parseToml(raw);
+    return {
+        repos: parsed.repos ?? [],
+        projects: parsed.projects ?? {},
+        calendar: {
+            enabled: parsed.calendar?.enabled ?? false,
+            backend: parsed.calendar?.backend ?? "gws",
+        },
+        daemon: {
+            enabled: parsed.daemon?.enabled ?? false,
+            intervalMinutes: parsed.daemon?.intervalMinutes ?? 15,
+        },
+    };
+}
+export function saveConfig(config) {
+    ensureScopeDir();
+    const lines = [];
+    lines.push("# Scope configuration");
+    lines.push("");
+    lines.push(`repos = [${config.repos.map((r) => `"${r}"`).join(", ")}]`);
+    lines.push("");
+    lines.push("[calendar]");
+    lines.push(`enabled = ${config.calendar.enabled}`);
+    lines.push(`backend = "${config.calendar.backend}"`);
+    lines.push("");
+    lines.push("[daemon]");
+    lines.push(`enabled = ${config.daemon.enabled}`);
+    lines.push(`intervalMinutes = ${config.daemon.intervalMinutes}`);
+    lines.push("");
+    for (const [name, project] of Object.entries(config.projects)) {
+        lines.push(`[projects.${name}]`);
+        lines.push(`path = "${project.path}"`);
+        if (project.repos && project.repos.length > 0) {
+            lines.push(`repos = [${project.repos.map((r) => `"${r}"`).join(", ")}]`);
+        }
+        if (project.description) {
+            lines.push(`description = "${project.description}"`);
+        }
+        lines.push("");
+    }
+    writeFileSync(CONFIG_PATH, lines.join("\n"), "utf-8");
+}
+//# sourceMappingURL=config.js.map

package/dist/store/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/store/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAsB1C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AAEnD,MAAM,UAAU,WAAW;IACzB,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAChD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;QACpB,OAAO;YACL,KAAK,EAAE,EAAE;YACT,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE;YAC5C,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,EAAE,EAAE;SAChD,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAyB,CAAC;IAEtD,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;QAC/B,QAAQ,EAAE;YACR,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,IAAI,KAAK;YAC1C,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,IAAI,KAAK;SAC3C;QACD,MAAM,EAAE;YACN,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,IAAI,KAAK;YACxC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,IAAI,EAAE;SACtD;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAmB;IAC5C,cAAc,EAAE,CAAC;IAEjB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;IACjE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9D,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,GAAG,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;QACvC,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,kBAAkB,OAAO,CAAC,WAAW,GAAG,CAAC,CAAC;QACvD,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@fureworks/scope",
+  "version": "0.1.0",
+  "description": "Personal ops CLI — focus on what matters",
+  "type": "module",
+  "bin": {
+    "scope": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "lint": "eslint src/",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "cli",
+    "productivity",
+    "ops",
+    "focus",
+    "prioritization",
+    "git",
+    "calendar"
+  ],
+  "author": "Fureworks <info@fureworks.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fureworks/scope.git"
+  },
+  "homepage": "https://fureworks.com",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "chalk": "^5.4.0",
+    "commander": "^13.1.0",
+    "simple-git": "^3.27.0",
+    "toml": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  }
+}

package/src/cli/config.ts

@@ -0,0 +1,66 @@
+import chalk from "chalk";
+import { loadConfig, configExists } from "../store/config.js";
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+export async function configCommand(
+  key?: string,
+  value?: string
+): Promise<void> {
+  if (!configExists()) {
+    console.log(
+      chalk.yellow("\n  No config found. Run `scope onboard` to get started.\n")
+    );
+    return;
+  }
+
+  // If no args, show config file contents
+  if (!key) {
+    const configPath = join(homedir(), ".scope", "config.toml");
+    try {
+      const content = readFileSync(configPath, "utf-8");
+      console.log("");
+      console.log(chalk.bold("  ~/.scope/config.toml"));
+      console.log(chalk.dim("  ─────────────────────\n"));
+      console.log(
+        content
+          .split("\n")
+          .map((line) => `  ${line}`)
+          .join("\n")
+      );
+      console.log("");
+    } catch {
+      console.log(chalk.yellow("\n  Could not read config file.\n"));
+    }
+    return;
+  }
+
+  // Subcommands
+  switch (key) {
+    case "git":
+      console.log(chalk.dim("\n  To manage repos, edit ~/.scope/config.toml"));
+      console.log(chalk.dim("  or re-run: scope onboard\n"));
+      break;
+    case "calendar":
+      console.log(
+        chalk.dim("\n  To set up calendar, install gws:")
+      );
+      console.log(
+        chalk.dim("  npm install -g @googleworkspace/cli")
+      );
+      console.log(chalk.dim("  Then re-run: scope onboard\n"));
+      break;
+    case "projects":
+      const config = loadConfig();
+      console.log(chalk.bold("\n  Projects:"));
+      for (const [name, project] of Object.entries(config.projects)) {
+        console.log(`  ${name} → ${project.path}`);
+      }
+      console.log(chalk.dim("\n  Edit: ~/.scope/config.toml\n"));
+      break;
+    default:
+      console.log(chalk.yellow(`\n  Unknown config key: ${key}`));
+      console.log(chalk.dim("  Available: git, calendar, projects\n"));
+  }
+}

package/src/cli/context.ts

@@ -0,0 +1,109 @@
+import chalk from "chalk";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { getScopeDir } from "../store/config.js";
+
+interface ContextOptions {
+  edit?: boolean;
+}
+
+export async function contextCommand(options: ContextOptions): Promise<void> {
+  const contextsDir = join(getScopeDir(), "contexts");
+
+  if (!existsSync(contextsDir)) {
+    console.log(
+      chalk.yellow("\n  No project contexts yet. Run `scope switch <project>` first.\n")
+    );
+    return;
+  }
+
+  // Find the most recently switched context
+  const files = readdirSync(contextsDir).filter((f) => f.endsWith(".json"));
+
+  if (files.length === 0) {
+    console.log(
+      chalk.yellow("\n  No project contexts yet. Run `scope switch <project>` first.\n")
+    );
+    return;
+  }
+
+  let latest: { name: string; data: Record<string, unknown>; time: number } | null = null;
+
+  for (const file of files) {
+    try {
+      const data = JSON.parse(
+        readFileSync(join(contextsDir, file), "utf-8")
+      );
+      const time = new Date(data.lastSwitchedAt || 0).getTime();
+      if (!latest || time > latest.time) {
+        latest = { name: data.name, data, time };
+      }
+    } catch {
+      // Skip corrupt files
+    }
+  }
+
+  if (!latest) {
+    console.log(
+      chalk.yellow("\n  No valid contexts found.\n")
+    );
+    return;
+  }
+
+  const ctx = latest.data as {
+    name: string;
+    path: string;
+    branch: string;
+    lastSwitchedAt: string;
+    notes: string;
+  };
+
+  if (options.edit) {
+    const editor = process.env.EDITOR || "vi";
+    const { execSync } = await import("node:child_process");
+    const notesPath = join(contextsDir, `${ctx.name}.md`);
+
+    // Create notes file if it doesn't exist
+    if (!existsSync(notesPath)) {
+      const { writeFileSync } = await import("node:fs");
+      writeFileSync(notesPath, `# ${ctx.name}\n\n`, "utf-8");
+    }
+
+    execSync(`${editor} ${notesPath}`, { stdio: "inherit" });
+    return;
+  }
+
+  console.log("");
+  console.log(chalk.bold(`  Current: ${ctx.name}`));
+  console.log(chalk.dim(`  ─────────────────────`));
+  console.log(`  📁 ${ctx.path}`);
+  console.log(`  🌿 ${ctx.branch}`);
+
+  if (ctx.lastSwitchedAt) {
+    const ago = Math.round(
+      (Date.now() - new Date(ctx.lastSwitchedAt).getTime()) / (1000 * 60 * 60)
+    );
+    if (ago < 1) {
+      console.log(chalk.dim(`  Switched: just now`));
+    } else {
+      console.log(chalk.dim(`  Switched: ${ago}h ago`));
+    }
+  }
+
+  if (ctx.notes) {
+    console.log(`\n  📝 ${ctx.notes}`);
+  }
+
+  // Show other projects
+  if (files.length > 1) {
+    console.log(chalk.dim(`\n  Other projects:`));
+    for (const file of files) {
+      const name = file.replace(".json", "");
+      if (name !== ctx.name) {
+        console.log(chalk.dim(`    scope switch ${name}`));
+      }
+    }
+  }
+
+  console.log("");
+}

package/src/cli/daemon.ts

@@ -0,0 +1,217 @@
+import chalk from "chalk";
+import { existsSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { spawn } from "node:child_process";
+import { join } from "node:path";
+import { configExists, ensureScopeDir, getScopeDir, loadConfig, saveConfig } from "../store/config.js";
+import { scanAllRepos } from "../sources/git.js";
+import { getCalendarToday } from "../sources/calendar.js";
+import { scanAssignedIssues } from "../sources/issues.js";
+import { prioritize } from "../engine/prioritize.js";
+import { notify } from "../notifications/index.js";
+
+const PID_PATH = join(getScopeDir(), "daemon.pid");
+const NOTIFIED_PATH = join(getScopeDir(), "notified.json");
+const DEBOUNCE_MS = 60 * 60 * 1000;
+
+type NotifiedState = Record<string, string>;
+
+function isProcessRunning(pid: number): boolean {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function readPid(): number | null {
+  if (!existsSync(PID_PATH)) return null;
+  const raw = readFileSync(PID_PATH, "utf-8").trim();
+  const pid = Number.parseInt(raw, 10);
+  return Number.isFinite(pid) ? pid : null;
+}
+
+function removePidFile(): void {
+  if (existsSync(PID_PATH)) {
+    unlinkSync(PID_PATH);
+  }
+}
+
+function loadNotifiedState(): NotifiedState {
+  if (!existsSync(NOTIFIED_PATH)) return {};
+  try {
+    return JSON.parse(readFileSync(NOTIFIED_PATH, "utf-8")) as NotifiedState;
+  } catch {
+    return {};
+  }
+}
+
+function saveNotifiedState(state: NotifiedState): void {
+  writeFileSync(NOTIFIED_PATH, JSON.stringify(state, null, 2), "utf-8");
+}
+
+async function runSignalCheck(): Promise<void> {
+  if (!configExists()) return;
+
+  const config = loadConfig();
+  const gitSignals = await scanAllRepos(config.repos);
+
+  let calendarEvents: Awaited<ReturnType<typeof getCalendarToday>> = null;
+  if (config.calendar.enabled) {
+    calendarEvents = await getCalendarToday();
+  }
+
+  const issueScan = await scanAssignedIssues();
+  const events = calendarEvents?.events ?? [];
+  const freeBlocks = calendarEvents?.freeBlocks ?? [];
+  const result = prioritize(gitSignals, events, freeBlocks, issueScan.issues);
+
+  const candidates = [...result.now, ...result.today].filter((item) => item.score >= 8);
+  if (candidates.length === 0) return;
+
+  ensureScopeDir();
+  const state = loadNotifiedState();
+  const nowMs = Date.now();
+  let changed = false;
+
+  for (const item of candidates) {
+    const id = `${item.source}:${item.label}`;
+    const lastNotified = state[id] ? new Date(state[id]).getTime() : 0;
+    if (lastNotified && nowMs - lastNotified < DEBOUNCE_MS) {
+      continue;
+    }
+
+    notify("Scope: Action Needed", `${item.emoji} ${item.label} — ${item.detail}`);
+    state[id] = new Date(nowMs).toISOString();
+    changed = true;
+  }
+
+  if (changed) {
+    saveNotifiedState(state);
+  }
+}
+
+function markDaemonEnabled(enabled: boolean): void {
+  if (!configExists()) return;
+  const config = loadConfig();
+  config.daemon.enabled = enabled;
+  saveConfig(config);
+}
+
+export async function daemonCommand(action: string): Promise<void> {
+  switch (action) {
+    case "start":
+      await startDaemon();
+      return;
+    case "stop":
+      stopDaemon();
+      return;
+    case "status":
+      showDaemonStatus();
+      return;
+    case "run":
+      await runDaemonLoop();
+      return;
+    default:
+      console.log(chalk.yellow(`\n  Unknown daemon action: ${action}`));
+      console.log(chalk.dim("  Use: scope daemon start|stop|status\n"));
+  }
+}
+
+async function startDaemon(): Promise<void> {
+  if (!configExists()) {
+    console.log(chalk.yellow("\n  Scope isn't set up yet. Run `scope onboard` first.\n"));
+    return;
+  }
+
+  ensureScopeDir();
+
+  const existingPid = readPid();
+  if (existingPid && isProcessRunning(existingPid)) {
+    console.log(chalk.green(`\n  Daemon already running (PID ${existingPid}).\n`));
+    return;
+  }
+  removePidFile();
+
+  const child = spawn(process.execPath, [process.argv[1], "daemon", "run"], {
+    detached: true,
+    stdio: "ignore",
+  });
+  child.unref();
+
+  writeFileSync(PID_PATH, String(child.pid), "utf-8");
+  markDaemonEnabled(true);
+
+  console.log(chalk.green(`\n  Daemon started (PID ${child.pid}).\n`));
+}
+
+function stopDaemon(): void {
+  const pid = readPid();
+  if (!pid) {
+    console.log(chalk.dim("\n  Daemon is not running.\n"));
+    markDaemonEnabled(false);
+    return;
+  }
+
+  if (!isProcessRunning(pid)) {
+    removePidFile();
+    console.log(chalk.dim("\n  Daemon was not running (stale PID removed).\n"));
+    markDaemonEnabled(false);
+    return;
+  }
+
+  try {
+    process.kill(pid);
+    removePidFile();
+    markDaemonEnabled(false);
+    console.log(chalk.green(`\n  Daemon stopped (PID ${pid}).\n`));
+  } catch {
+    console.log(chalk.yellow(`\n  Could not stop daemon PID ${pid}.\n`));
+  }
+}
+
+function showDaemonStatus(): void {
+  const config = loadConfig();
+  const pid = readPid();
+
+  if (pid && isProcessRunning(pid)) {
+    console.log(chalk.green(`\n  Daemon running (PID ${pid}).`));
+    console.log(chalk.dim(`  Interval: ${config.daemon.intervalMinutes} minutes\n`));
+    return;
+  }
+
+  if (pid) {
+    removePidFile();
+  }
+
+  console.log(chalk.dim("\n  Daemon is not running."));
+  console.log(chalk.dim(`  Interval: ${config.daemon.intervalMinutes} minutes\n`));
+}
+
+async function runDaemonLoop(): Promise<void> {
+  ensureScopeDir();
+  writeFileSync(PID_PATH, String(process.pid), "utf-8");
+
+  const cleanup = () => {
+    const pid = readPid();
+    if (pid === process.pid) {
+      removePidFile();
+    }
+    process.exit(0);
+  };
+
+  process.on("SIGTERM", cleanup);
+  process.on("SIGINT", cleanup);
+
+  while (true) {
+    try {
+      await runSignalCheck();
+    } catch {
+      // Keep daemon alive even if checks fail.
+    }
+
+    const config = configExists() ? loadConfig() : null;
+    const intervalMinutes = Math.max(1, config?.daemon.intervalMinutes ?? 15);
+    await new Promise((resolve) => setTimeout(resolve, intervalMinutes * 60 * 1000));
+  }
+}