@fureworks/scope 0.1.0 → 0.2.0

package/src/cli/switch.ts

@@ -1,93 +0,0 @@
-import chalk from "chalk";
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
-import { join } from "node:path";
-import { loadConfig, getScopeDir } from "../store/config.js";
-import { simpleGit } from "simple-git";
-
-interface ProjectContext {
-  name: string;
-  path: string;
-  branch: string;
-  lastSwitchedAt: string;
-  notes: string;
-}
-
-function getContextPath(projectName: string): string {
-  return join(getScopeDir(), "contexts", `${projectName}.json`);
-}
-
-function loadContext(projectName: string): ProjectContext | null {
-  const contextPath = getContextPath(projectName);
-  if (!existsSync(contextPath)) return null;
-  try {
-    return JSON.parse(readFileSync(contextPath, "utf-8"));
-  } catch {
-    return null;
-  }
-}
-
-function saveContext(context: ProjectContext): void {
-  const dir = join(getScopeDir(), "contexts");
-  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
-  writeFileSync(getContextPath(context.name), JSON.stringify(context, null, 2));
-}
-
-export async function switchCommand(project: string): Promise<void> {
-  const config = loadConfig();
-
-  const projectConfig = config.projects[project];
-  if (!projectConfig) {
-    console.log(
-      chalk.yellow(`\n  Project "${project}" not found.\n`)
-    );
-    console.log(chalk.dim("  Available projects:"));
-    for (const name of Object.keys(config.projects)) {
-      console.log(chalk.dim(`    - ${name}`));
-    }
-    console.log(chalk.dim(`\n  Add with: scope config projects\n`));
-    return;
-  }
-
-  // Save current context if we can detect one
-  // (We save the project we're switching FROM)
-
-  // Load target context
-  const existingContext = loadContext(project);
-
-  // Get current git branch for the target project
-  let branch = "unknown";
-  try {
-    const git = simpleGit(projectConfig.path);
-    const branchInfo = await git.branch();
-    branch = branchInfo.current;
-  } catch {
-    // Not a git repo or error
-  }
-
-  // Save/update context
-  const context: ProjectContext = {
-    name: project,
-    path: projectConfig.path,
-    branch,
-    lastSwitchedAt: new Date().toISOString(),
-    notes: existingContext?.notes || "",
-  };
-  saveContext(context);
-
-  console.log("");
-  console.log(chalk.bold(`  Switched to: ${project}`));
-  console.log(chalk.dim(`  ─────────────────────`));
-  console.log(`  📁 ${projectConfig.path}`);
-  console.log(`  🌿 ${branch}`);
-  if (existingContext?.notes) {
-    console.log(`  📝 ${existingContext.notes}`);
-  }
-  if (existingContext?.lastSwitchedAt) {
-    const last = new Date(existingContext.lastSwitchedAt);
-    const ago = Math.round((Date.now() - last.getTime()) / (1000 * 60 * 60));
-    console.log(chalk.dim(`  Last here: ${ago}h ago`));
-  }
-  console.log("");
-  console.log(chalk.dim(`  cd ${projectConfig.path}`));
-  console.log("");
-}

package/src/cli/today.ts

@@ -1,114 +0,0 @@
-import chalk from "chalk";
-import { loadConfig, configExists } 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";
-
-interface TodayOptions {
-  calendar?: boolean;
-  json?: boolean;
-}
-
-export async function todayCommand(options: TodayOptions): Promise<void> {
-  if (!configExists()) {
-    console.log(
-      chalk.yellow(
-        "  Scope isn't set up yet. Run `scope onboard` to get started.\n"
-      )
-    );
-    process.exit(1);
-  }
-
-  const config = loadConfig();
-
-  if (config.repos.length === 0) {
-    console.log(
-      chalk.yellow("  No repos configured. Run `scope config git` to add some.\n")
-    );
-    process.exit(1);
-  }
-
-  // Scan git repos
-  const gitSignals = await scanAllRepos(config.repos);
-
-  // Get calendar events
-  let calendarEvents: Awaited<ReturnType<typeof getCalendarToday>> = null;
-  if (options.calendar !== false && config.calendar.enabled) {
-    calendarEvents = await getCalendarToday();
-    if (!calendarEvents) {
-      console.log(
-        chalk.dim(
-          "  ⚠ Calendar not available. Try: gws auth login\n"
-        )
-      );
-    }
-  }
-
-  const events = calendarEvents?.events ?? [];
-  const freeBlocks = calendarEvents?.freeBlocks ?? [];
-  const issueScan = await scanAssignedIssues();
-  if (!issueScan.available) {
-    console.log(
-      chalk.dim("  ⚠ GitHub issues not available. Install/auth gh to enable issue signals.\n")
-    );
-  }
-
-  // Prioritize
-  const result = prioritize(gitSignals, events, freeBlocks, issueScan.issues);
-
-  // Output
-  if (options.json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  console.log("");
-
-  if (result.now.length === 0 && result.today.length === 0) {
-    console.log(chalk.green("  ✓ Nothing urgent. You're clear.\n"));
-    if (result.laterCount > 0) {
-      console.log(
-        chalk.dim(`  ${result.laterCount} low-priority items → scope status\n`)
-      );
-    }
-    return;
-  }
-
-  // NOW section
-  if (result.now.length > 0) {
-    console.log(chalk.bold("  NOW"));
-    console.log(chalk.dim("  ───"));
-    for (const item of result.now) {
-      console.log(`  ${item.emoji} ${chalk.bold(item.label)}`);
-      console.log(`     ${chalk.dim(item.detail)}`);
-    }
-    console.log("");
-  }
-
-  // TODAY section
-  if (result.today.length > 0) {
-    console.log(chalk.bold("  TODAY"));
-    console.log(chalk.dim("  ────"));
-    for (const item of result.today) {
-      console.log(`  ${item.emoji} ${chalk.bold(item.label)}`);
-      console.log(`     ${chalk.dim(item.detail)}`);
-    }
-    console.log("");
-  }
-
-  // Suggestions
-  if (result.suggestions.length > 0) {
-    for (const suggestion of result.suggestions) {
-      console.log(`  💡 ${suggestion}`);
-    }
-    console.log("");
-  }
-
-  // Later count
-  if (result.laterCount > 0) {
-    console.log(
-      chalk.dim(`  ${result.laterCount} other items can wait → scope status\n`)
-    );
-  }
-}

package/src/engine/prioritize.ts

@@ -1,257 +0,0 @@
-import { GitSignal, PRInfo } from "../sources/git.js";
-import { CalendarEvent, FreeBlock } from "../sources/calendar.js";
-import { IssueSignal } from "../sources/issues.js";
-
-export type Priority = "now" | "today" | "later";
-
-export interface ScoredItem {
-  priority: Priority;
-  score: number;
-  emoji: string;
-  label: string;
-  detail: string;
-  source: "git" | "calendar" | "pr" | "issue";
-}
-
-export interface PrioritizedOutput {
-  now: ScoredItem[];
-  today: ScoredItem[];
-  laterCount: number;
-  freeBlocks: FreeBlock[];
-  suggestions: string[];
-}
-
-function scorePR(pr: PRInfo, repoName: string): ScoredItem {
-  let score = 0;
-  const details: string[] = [];
-
-  // Staleness
-  if (pr.ageDays > 14) {
-    score += 9; // 2+ weeks = critical
-    details.push(`open ${Math.round(pr.ageDays)} days`);
-  } else if (pr.ageDays > 5) {
-    score += 7;
-    details.push(`open ${Math.round(pr.ageDays)} days`);
-  } else if (pr.ageDays > 2) {
-    score += 4;
-    details.push(`open ${Math.round(pr.ageDays)} days`);
-  }
-
-  // Blocking potential
-  if (pr.reviewRequested) {
-    score += 8;
-    details.push("review requested");
-  }
-  if (pr.ciStatus === "fail") {
-    score += 5;
-    details.push("CI failing");
-  }
-  if (pr.hasConflicts) {
-    score += 4;
-    details.push("has conflicts");
-  }
-
-  const priority: Priority = score >= 8 ? "now" : score >= 4 ? "today" : "later";
-
-  return {
-    priority,
-    score,
-    emoji: priority === "now" ? "🔴" : "🟡",
-    label: `PR #${pr.number} on ${repoName}`,
-    detail: `${pr.title} — ${details.join(", ")}`,
-    source: "pr",
-  };
-}
-
-function scoreRepoWork(signal: GitSignal): ScoredItem | null {
-  if (signal.uncommittedFiles === 0) return null;
-
-  let score = 0;
-  const details: string[] = [];
-
-  details.push(
-    `${signal.uncommittedFiles} uncommitted file${signal.uncommittedFiles > 1 ? "s" : ""}`
-  );
-
-  // Staleness of uncommitted work
-  const days = Math.round(signal.lastCommitAge / 24);
-  if (signal.lastCommitAge > 72) {
-    score += 9; // 3+ days uncommitted = NOW
-    details.push(`last commit ${days}d ago`);
-  } else if (signal.lastCommitAge > 24) {
-    score += 6;
-    details.push(`last commit ${days}d ago`);
-  } else if (signal.lastCommitAge > 4) {
-    score += 3;
-    details.push(`last touched ${Math.round(signal.lastCommitAge)}h ago`);
-  } else {
-    score += 1;
-  }
-
-  if (score < 2) return null; // Don't surface fresh uncommitted work
-
-  const priority: Priority = score >= 8 ? "now" : score >= 4 ? "today" : "later";
-
-  return {
-    priority,
-    score,
-    emoji: priority === "now" ? "🔴" : "🟡",
-    label: `${signal.repo}`,
-    detail: details.join(", "),
-    source: "git",
-  };
-}
-
-function scoreCalendarEvent(event: CalendarEvent): ScoredItem | null {
-  // Only surface upcoming events (not past ones)
-  if (event.minutesUntilStart < -15) return null;
-
-  let score = 0;
-
-  if (event.minutesUntilStart <= 60 && event.minutesUntilStart > 0) {
-    score += 10;
-  } else if (event.minutesUntilStart <= 0 && event.minutesUntilStart > -15) {
-    score += 10; // Happening now
-  } else {
-    score += 5;
-  }
-
-  const priority: Priority = score >= 8 ? "now" : "today";
-
-  let timeLabel: string;
-  if (event.minutesUntilStart <= 0) {
-    timeLabel = "happening now";
-  } else if (event.minutesUntilStart < 60) {
-    timeLabel = `in ${event.minutesUntilStart} min`;
-  } else {
-    const hours = Math.floor(event.minutesUntilStart / 60);
-    const mins = event.minutesUntilStart % 60;
-    timeLabel = `at ${event.startTime.toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" })}`;
-    if (hours > 0) timeLabel += ` (${hours}h${mins > 0 ? `${mins}m` : ""} from now)`;
-  }
-
-  return {
-    priority,
-    score,
-    emoji: "🔴",
-    label: `Meeting: ${event.title}`,
-    detail: timeLabel,
-    source: "calendar",
-  };
-}
-
-function scoreIssue(issue: IssueSignal): ScoredItem | null {
-  let score = 0;
-  const details: string[] = [];
-
-  if (issue.ageDays > 14) {
-    score += 9;
-    details.push(`open ${Math.round(issue.ageDays)} days`);
-  } else if (issue.ageDays > 7) {
-    score += 7;
-    details.push(`open ${Math.round(issue.ageDays)} days`);
-  }
-
-  const hasPriorityLabel = issue.labels.some((label) =>
-    ["urgent", "critical", "bug"].includes(label.toLowerCase())
-  );
-  if (hasPriorityLabel) {
-    score += 3;
-    details.push("priority label");
-  }
-
-  if (score === 0) return null;
-
-  const priority: Priority = score >= 8 ? "now" : score >= 4 ? "today" : "later";
-  const labels = issue.labels.length > 0 ? ` [${issue.labels.join(", ")}]` : "";
-
-  return {
-    priority,
-    score,
-    emoji: "📋",
-    label: `Issue #${issue.number} on ${issue.repo}`,
-    detail: `${issue.title}${labels}${details.length > 0 ? ` — ${details.join(", ")}` : ""}`,
-    source: "issue",
-  };
-}
-
-export function prioritize(
-  gitSignals: GitSignal[],
-  calendarEvents: CalendarEvent[],
-  freeBlocks: FreeBlock[],
-  issues: IssueSignal[]
-): PrioritizedOutput {
-  const allItems: ScoredItem[] = [];
-
-  // Score calendar events
-  for (const event of calendarEvents) {
-    const scored = scoreCalendarEvent(event);
-    if (scored) allItems.push(scored);
-  }
-
-  // Score git repos
-  for (const signal of gitSignals) {
-    // Score uncommitted work
-    const repoItem = scoreRepoWork(signal);
-    if (repoItem) allItems.push(repoItem);
-
-    // Score PRs
-    for (const pr of signal.openPRs) {
-      allItems.push(scorePR(pr, signal.repo));
-    }
-  }
-
-  // Score issues
-  for (const issue of issues) {
-    const scored = scoreIssue(issue);
-    if (scored) allItems.push(scored);
-  }
-
-  // Sort by score descending
-  allItems.sort((a, b) => b.score - a.score);
-
-  // Cap output: max 3 NOW items, max 5 TODAY items. Rest goes to later.
-  const allNow = allItems.filter((i) => i.priority === "now");
-  const allToday = allItems.filter((i) => i.priority === "today");
-  const allLater = allItems.filter((i) => i.priority === "later");
-
-  const now = allNow.slice(0, 3);
-  const todayOverflow = allNow.slice(3);
-  const today = [...todayOverflow, ...allToday].slice(0, 5);
-  const laterCount =
-    allLater.length +
-    Math.max(0, todayOverflow.length + allToday.length - 5);
-
-  // Generate suggestions
-  const suggestions: string[] = [];
-  if (freeBlocks.length > 0) {
-    const biggestBlock = freeBlocks.reduce((a, b) =>
-      a.durationMinutes > b.durationMinutes ? a : b
-    );
-    const blockStart = biggestBlock.start.toLocaleTimeString([], {
-      hour: "2-digit",
-      minute: "2-digit",
-    });
-    const blockEnd = biggestBlock.end.toLocaleTimeString([], {
-      hour: "2-digit",
-      minute: "2-digit",
-    });
-    const hours = Math.floor(biggestBlock.durationMinutes / 60);
-    const mins = biggestBlock.durationMinutes % 60;
-    const durationStr = hours > 0 ? `${hours}h${mins > 0 ? `${mins}m` : ""}` : `${mins}m`;
-
-    // Find a good item to suggest for this block
-    const deepWorkItem = today.find((i) => i.source === "git");
-    if (deepWorkItem) {
-      suggestions.push(
-        `${durationStr} free block (${blockStart}–${blockEnd}). Good for: ${deepWorkItem.label}`
-      );
-    } else {
-      suggestions.push(
-        `${durationStr} free block available (${blockStart}–${blockEnd})`
-      );
-    }
-  }
-
-  return { now, today, laterCount, freeBlocks, suggestions };
-}

package/src/index.ts

@@ -1,58 +0,0 @@
-#!/usr/bin/env node
-
-import { Command } from "commander";
-import { todayCommand } from "./cli/today.js";
-import { switchCommand } from "./cli/switch.js";
-import { contextCommand } from "./cli/context.js";
-import { statusCommand } from "./cli/status.js";
-import { onboardCommand } from "./cli/onboard.js";
-import { configCommand } from "./cli/config.js";
-import { daemonCommand } from "./cli/daemon.js";
-
-const program = new Command();
-
-program
-  .name("scope")
-  .description("Personal ops CLI — focus on what matters.")
-  .version("0.1.0");
-
-program
-  .command("today")
-  .description("What needs your attention right now")
-  .option("--no-calendar", "Skip calendar data")
-  .option("--json", "Output as JSON")
-  .action(todayCommand);
-
-program
-  .command("onboard")
-  .description("Guided first-time setup")
-  .action(onboardCommand);
-
-program
-  .command("switch <project>")
-  .description("Switch to a project context")
-  .action(switchCommand);
-
-program
-  .command("context")
-  .description("Show current project context")
-  .option("--edit", "Open scratchpad in $EDITOR")
-  .action(contextCommand);
-
-program
-  .command("status")
-  .description("Overview of all watched projects")
-  .option("--json", "Output as JSON")
-  .action(statusCommand);
-
-program
-  .command("config [key] [value]")
-  .description("View or edit configuration")
-  .action(configCommand);
-
-program
-  .command("daemon <action>")
-  .description("Manage background signal checks (start|stop|status)")
-  .action(daemonCommand);
-
-program.parse();

package/src/notifications/index.ts

@@ -1,42 +0,0 @@
-import { appendFileSync } from "node:fs";
-import { spawnSync } from "node:child_process";
-import { join } from "node:path";
-import { ensureScopeDir, getScopeDir } from "../store/config.js";
-
-function commandExists(command: string): boolean {
-  const check = spawnSync("which", [command], { stdio: "pipe" });
-  return check.status === 0;
-}
-
-function fallbackNotify(title: string, body: string): void {
-  ensureScopeDir();
-  const logPath = join(getScopeDir(), "notifications.log");
-  appendFileSync(logPath, `[${new Date().toISOString()}] ${title}: ${body}\n`, "utf-8");
-}
-
-export function notify(title: string, body: string): void {
-  try {
-    if (process.platform === "linux") {
-      if (commandExists("notify-send")) {
-        const result = spawnSync("notify-send", [title, body], { stdio: "pipe" });
-        if (result.status === 0) return;
-      }
-      fallbackNotify(title, body);
-      return;
-    }
-
-    if (process.platform === "darwin") {
-      const escapedTitle = title.replace(/"/g, '\\"');
-      const escapedBody = body.replace(/"/g, '\\"');
-      const script = `display notification "${escapedBody}" with title "${escapedTitle}"`;
-      const result = spawnSync("osascript", ["-e", script], { stdio: "pipe" });
-      if (result.status === 0) return;
-      fallbackNotify(title, body);
-      return;
-    }
-
-    fallbackNotify(title, body);
-  } catch {
-    fallbackNotify(title, body);
-  }
-}