@fureworks/scope 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fureworks
+
+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,92 @@
+# Scope
+
+**Personal ops CLI — focus on what matters.**
+
+Scope reads your existing workflow (git repos, calendar, PRs) and tells you what actually needs your attention. It doesn't add to your workflow — it gives you clarity.
+
+## Why
+
+AI tools made you more capable. Which means more gets piled on. The bottleneck moved from *execution* to *prioritization and context switching*.
+
+Scope sits above your tools and helps you focus.
+
+## Install
+
+```bash
+npm install -g @fureworks/scope
+```
+
+## Quick Start
+
+```bash
+scope onboard     # Guided setup (1 minute)
+scope today       # What matters right now
+```
+
+## Commands
+
+```
+scope onboard              Guided first-time setup
+scope today                What needs your attention right now
+scope status               Overview of all watched projects
+scope switch <project>     Switch to a project context
+scope context              Show current project context
+scope review               End-of-day summary
+scope config               View/edit configuration
+```
+
+## How It Works
+
+Scope reads signals from your existing tools:
+
+- **Git** — uncommitted changes, stale branches, open PRs
+- **Google Calendar** — today's meetings, free blocks (via [gws](https://github.com/googleworkspace/cli))
+- **GitHub** — PR reviews waiting on you, failing CI
+
+It scores each item by urgency, staleness, and blocking potential, then shows you what matters:
+
+```
+$ scope today
+
+  NOW
+  ───
+  🔴 Meeting: Team standup in 45 min
+  🔴 PR #8 on api-service — waiting on your review (3 days)
+
+  TODAY
+  ────
+  🟡 fureworks/scope — 3 uncommitted files, last touched 2h ago
+  🟡 PR #12 on fureworks.com — open 3 days, no review
+
+  💡 2h free block after standup (14:00–16:00)
+     Good for: fureworks/scope (has pending work)
+
+  4 other items can wait → scope status
+```
+
+## Design Principles
+
+- **CLI-first, local-first** — your data stays on your machine
+- **Reads, doesn't create** — no new inputs required from you
+- **Opinionated output** — tells you what matters, not just lists stuff
+- **Degrades gracefully** — missing integrations skip quietly, never crash
+- **Open source** — MIT licensed
+
+## Prerequisites
+
+- Node.js 18+
+- Git
+- [GitHub CLI](https://cli.github.com/) (`gh`) — for PR data
+- [Google Workspace CLI](https://github.com/googleworkspace/cli) (`gws`) — for calendar (optional)
+
+## Status
+
+🚧 **v0.1 in development** — early but usable.
+
+## License
+
+MIT — see [LICENSE](./LICENSE)
+
+---
+
+*A [Fureworks](https://fureworks.com) project — works born from human touch.*

package/dist/cli/config.d.ts

@@ -0,0 +1,2 @@
+export declare function configCommand(key?: string, value?: string): Promise<void>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"AAMA,wBAAsB,aAAa,CACjC,GAAG,CAAC,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAwDf"}

package/dist/cli/config.js

@@ -0,0 +1,54 @@
+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, value) {
+    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"));
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/cli/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"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"}

package/dist/cli/context.d.ts

@@ -0,0 +1,6 @@
+interface ContextOptions {
+    edit?: boolean;
+}
+export declare function contextCommand(options: ContextOptions): Promise<void>;
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/cli/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/cli/context.ts"],"names":[],"mappings":"AAKA,UAAU,cAAc;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAmG3E"}

package/dist/cli/context.js

@@ -0,0 +1,76 @@
+import chalk from "chalk";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { getScopeDir } from "../store/config.js";
+export async function contextCommand(options) {
+    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 = 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;
+    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("");
+}
+//# sourceMappingURL=context.js.map

package/dist/cli/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/cli/context.ts"],"names":[],"mappings":"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"}

package/dist/cli/daemon.d.ts

@@ -0,0 +1,2 @@
+export declare function daemonCommand(action: string): Promise<void>;
+//# sourceMappingURL=daemon.d.ts.map

package/dist/cli/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../src/cli/daemon.ts"],"names":[],"mappings":"AAoGA,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBjE"}

package/dist/cli/daemon.js

@@ -0,0 +1,190 @@
+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;
+function isProcessRunning(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function readPid() {
+    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() {
+    if (existsSync(PID_PATH)) {
+        unlinkSync(PID_PATH);
+    }
+}
+function loadNotifiedState() {
+    if (!existsSync(NOTIFIED_PATH))
+        return {};
+    try {
+        return JSON.parse(readFileSync(NOTIFIED_PATH, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+function saveNotifiedState(state) {
+    writeFileSync(NOTIFIED_PATH, JSON.stringify(state, null, 2), "utf-8");
+}
+async function runSignalCheck() {
+    if (!configExists())
+        return;
+    const config = loadConfig();
+    const gitSignals = await scanAllRepos(config.repos);
+    let calendarEvents = 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) {
+    if (!configExists())
+        return;
+    const config = loadConfig();
+    config.daemon.enabled = enabled;
+    saveConfig(config);
+}
+export async function daemonCommand(action) {
+    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() {
+    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() {
+    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() {
+    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() {
+    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));
+    }
+}
+//# sourceMappingURL=daemon.js.map

package/dist/cli/daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../../src/cli/daemon.ts"],"names":[],"mappings":"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"}

package/dist/cli/onboard.d.ts

@@ -0,0 +1,2 @@
+export declare function onboardCommand(): Promise<void>;
+//# sourceMappingURL=onboard.d.ts.map

package/dist/cli/onboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboard.d.ts","sourceRoot":"","sources":["../../src/cli/onboard.ts"],"names":[],"mappings":"AAkIA,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CA4MpD"}