gsd-pi 2.33.1 → 2.34.0-dev.6769913

package/dist/resources/extensions/gsd/detection.ts

@@ -1,470 +0,0 @@
-/**
- * GSD Detection — Project state and ecosystem detection.
- *
- * Pure functions, zero UI dependencies, zero side effects.
- * Used by init-wizard.ts and guided-flow.ts to determine what onboarding
- * flow to show when entering a project directory.
- */
-
-import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
-import { join } from "node:path";
-import { homedir } from "node:os";
-import { gsdRoot } from "./paths.js";
-
-// ─── Types ──────────────────────────────────────────────────────────────────────
-
-export interface ProjectDetection {
-  /** What kind of GSD state exists in this directory */
-  state: "none" | "v1-planning" | "v2-gsd" | "v2-gsd-empty";
-
-  /** Is this the first time GSD has been used on this machine? */
-  isFirstEverLaunch: boolean;
-
-  /** Does ~/.gsd/ exist with preferences? */
-  hasGlobalSetup: boolean;
-
-  /** v1 details (only when state === 'v1-planning') */
-  v1?: V1Detection;
-
-  /** v2 details (only when state === 'v2-gsd' or 'v2-gsd-empty') */
-  v2?: V2Detection;
-
-  /** Detected project ecosystem signals */
-  projectSignals: ProjectSignals;
-}
-
-export interface V1Detection {
-  path: string;
-  hasPhasesDir: boolean;
-  hasRoadmap: boolean;
-  phaseCount: number;
-}
-
-export interface V2Detection {
-  milestoneCount: number;
-  hasPreferences: boolean;
-  hasContext: boolean;
-}
-
-export interface ProjectSignals {
-  /** Detected project/package files */
-  detectedFiles: string[];
-  /** Is this already a git repo? */
-  isGitRepo: boolean;
-  /** Is this a monorepo? */
-  isMonorepo: boolean;
-  /** Primary language hint */
-  primaryLanguage?: string;
-  /** Has existing CI configuration? */
-  hasCI: boolean;
-  /** Has existing test setup? */
-  hasTests: boolean;
-  /** Detected package manager */
-  packageManager?: string;
-  /** Auto-detected verification commands */
-  verificationCommands: string[];
-}
-
-// ─── Project File Markers ───────────────────────────────────────────────────────
-
-const PROJECT_FILES = [
-  "package.json",
-  "Cargo.toml",
-  "go.mod",
-  "pyproject.toml",
-  "setup.py",
-  "Gemfile",
-  "pom.xml",
-  "build.gradle",
-  "build.gradle.kts",
-  "CMakeLists.txt",
-  "Makefile",
-  "composer.json",
-  "pubspec.yaml",
-  "Package.swift",
-  "mix.exs",
-  "deno.json",
-  "deno.jsonc",
-] as const;
-
-const LANGUAGE_MAP: Record<string, string> = {
-  "package.json": "javascript/typescript",
-  "Cargo.toml": "rust",
-  "go.mod": "go",
-  "pyproject.toml": "python",
-  "setup.py": "python",
-  "Gemfile": "ruby",
-  "pom.xml": "java",
-  "build.gradle": "java/kotlin",
-  "build.gradle.kts": "kotlin",
-  "CMakeLists.txt": "c/c++",
-  "composer.json": "php",
-  "pubspec.yaml": "dart/flutter",
-  "Package.swift": "swift",
-  "mix.exs": "elixir",
-  "deno.json": "typescript/deno",
-  "deno.jsonc": "typescript/deno",
-};
-
-const MONOREPO_MARKERS = [
-  "lerna.json",
-  "nx.json",
-  "turbo.json",
-  "pnpm-workspace.yaml",
-] as const;
-
-const CI_MARKERS = [
-  ".github/workflows",
-  ".gitlab-ci.yml",
-  "Jenkinsfile",
-  ".circleci",
-  ".travis.yml",
-  "azure-pipelines.yml",
-  "bitbucket-pipelines.yml",
-] as const;
-
-const TEST_MARKERS = [
-  "__tests__",
-  "tests",
-  "test",
-  "spec",
-  "jest.config.js",
-  "jest.config.ts",
-  "vitest.config.ts",
-  "vitest.config.js",
-  ".mocharc.yml",
-  "pytest.ini",
-  "conftest.py",
-  "phpunit.xml",
-] as const;
-
-// ─── Core Detection ─────────────────────────────────────────────────────────────
-
-/**
- * Detect the full project state for a given directory.
- * This is the main entry point — calls all sub-detectors.
- */
-export function detectProjectState(basePath: string): ProjectDetection {
-  const v1 = detectV1Planning(basePath);
-  const v2 = detectV2Gsd(basePath);
-  const projectSignals = detectProjectSignals(basePath);
-  const globalSetup = hasGlobalSetup();
-  const firstEver = isFirstEverLaunch();
-
-  let state: ProjectDetection["state"];
-  if (v2 && v2.milestoneCount > 0) {
-    state = "v2-gsd";
-  } else if (v2 && v2.milestoneCount === 0) {
-    state = "v2-gsd-empty";
-  } else if (v1) {
-    state = "v1-planning";
-  } else {
-    state = "none";
-  }
-
-  return {
-    state,
-    isFirstEverLaunch: firstEver,
-    hasGlobalSetup: globalSetup,
-    v1: v1 ?? undefined,
-    v2: v2 ?? undefined,
-    projectSignals,
-  };
-}
-
-// ─── V1 Planning Detection ──────────────────────────────────────────────────────
-
-/**
- * Detect a v1 .planning/ directory with GSD v1 markers.
- * Returns null if no .planning/ directory found.
- */
-export function detectV1Planning(basePath: string): V1Detection | null {
-  const planningPath = join(basePath, ".planning");
-
-  if (!existsSync(planningPath)) return null;
-
-  try {
-    const stat = statSync(planningPath);
-    if (!stat.isDirectory()) return null;
-  } catch {
-    return null;
-  }
-
-  const hasRoadmap = existsSync(join(planningPath, "ROADMAP.md"));
-  const phasesPath = join(planningPath, "phases");
-  const hasPhasesDir = existsSync(phasesPath);
-
-  let phaseCount = 0;
-  if (hasPhasesDir) {
-    try {
-      const entries = readdirSync(phasesPath, { withFileTypes: true });
-      phaseCount = entries.filter(e => e.isDirectory()).length;
-    } catch {
-      // unreadable — report 0
-    }
-  }
-
-  return {
-    path: planningPath,
-    hasPhasesDir,
-    hasRoadmap,
-    phaseCount,
-  };
-}
-
-// ─── V2 GSD Detection ──────────────────────────────────────────────────────────
-
-function detectV2Gsd(basePath: string): V2Detection | null {
-  const gsdPath = gsdRoot(basePath);
-
-  if (!existsSync(gsdPath)) return null;
-
-  const hasPreferences =
-    existsSync(join(gsdPath, "preferences.md")) ||
-    existsSync(join(gsdPath, "PREFERENCES.md"));
-
-  const hasContext = existsSync(join(gsdPath, "CONTEXT.md"));
-
-  let milestoneCount = 0;
-  const milestonesPath = join(gsdPath, "milestones");
-  if (existsSync(milestonesPath)) {
-    try {
-      const entries = readdirSync(milestonesPath, { withFileTypes: true });
-      milestoneCount = entries.filter(e => e.isDirectory()).length;
-    } catch {
-      // unreadable — report 0
-    }
-  }
-
-  return { milestoneCount, hasPreferences, hasContext };
-}
-
-// ─── Project Signals Detection ──────────────────────────────────────────────────
-
-/**
- * Quick filesystem scan for project ecosystem markers.
- * Reads only file existence + minimal content (package.json for monorepo/scripts).
- */
-export function detectProjectSignals(basePath: string): ProjectSignals {
-  const detectedFiles: string[] = [];
-  let primaryLanguage: string | undefined;
-
-  // Detect project files
-  for (const file of PROJECT_FILES) {
-    if (existsSync(join(basePath, file))) {
-      detectedFiles.push(file);
-      if (!primaryLanguage) {
-        primaryLanguage = LANGUAGE_MAP[file];
-      }
-    }
-  }
-
-  // Git repo detection
-  const isGitRepo = existsSync(join(basePath, ".git"));
-
-  // Monorepo detection
-  let isMonorepo = false;
-  for (const marker of MONOREPO_MARKERS) {
-    if (existsSync(join(basePath, marker))) {
-      isMonorepo = true;
-      break;
-    }
-  }
-  // Also check package.json workspaces
-  if (!isMonorepo && detectedFiles.includes("package.json")) {
-    isMonorepo = packageJsonHasWorkspaces(basePath);
-  }
-
-  // CI detection
-  let hasCI = false;
-  for (const marker of CI_MARKERS) {
-    if (existsSync(join(basePath, marker))) {
-      hasCI = true;
-      break;
-    }
-  }
-
-  // Test detection
-  let hasTests = false;
-  for (const marker of TEST_MARKERS) {
-    if (existsSync(join(basePath, marker))) {
-      hasTests = true;
-      break;
-    }
-  }
-
-  // Package manager detection
-  const packageManager = detectPackageManager(basePath);
-
-  // Verification commands
-  const verificationCommands = detectVerificationCommands(basePath, detectedFiles, packageManager);
-
-  return {
-    detectedFiles,
-    isGitRepo,
-    isMonorepo,
-    primaryLanguage,
-    hasCI,
-    hasTests,
-    packageManager,
-    verificationCommands,
-  };
-}
-
-// ─── Package Manager Detection ──────────────────────────────────────────────────
-
-function detectPackageManager(basePath: string): string | undefined {
-  if (existsSync(join(basePath, "pnpm-lock.yaml"))) return "pnpm";
-  if (existsSync(join(basePath, "yarn.lock"))) return "yarn";
-  if (existsSync(join(basePath, "bun.lockb")) || existsSync(join(basePath, "bun.lock"))) return "bun";
-  if (existsSync(join(basePath, "package-lock.json"))) return "npm";
-  if (existsSync(join(basePath, "package.json"))) return "npm";
-  return undefined;
-}
-
-// ─── Verification Command Detection ─────────────────────────────────────────────
-
-/**
- * Auto-detect verification commands from project files.
- * Returns commands in priority order (test first, then build, then lint).
- */
-function detectVerificationCommands(
-  basePath: string,
-  detectedFiles: string[],
-  packageManager?: string,
-): string[] {
-  const commands: string[] = [];
-  const pm = packageManager ?? "npm";
-  const run = pm === "npm" ? "npm run" : pm === "yarn" ? "yarn" : pm === "bun" ? "bun run" : `${pm} run`;
-
-  if (detectedFiles.includes("package.json")) {
-    const scripts = readPackageJsonScripts(basePath);
-    if (scripts) {
-      // Test commands (highest priority)
-      if (scripts.test && scripts.test !== "echo \"Error: no test specified\" && exit 1") {
-        commands.push(pm === "npm" ? "npm test" : `${pm} test`);
-      }
-      // Build commands
-      if (scripts.build) {
-        commands.push(`${run} build`);
-      }
-      // Lint commands
-      if (scripts.lint) {
-        commands.push(`${run} lint`);
-      }
-      // Typecheck commands
-      if (scripts.typecheck) {
-        commands.push(`${run} typecheck`);
-      } else if (scripts.tsc) {
-        commands.push(`${run} tsc`);
-      }
-    }
-  }
-
-  if (detectedFiles.includes("Cargo.toml")) {
-    commands.push("cargo test");
-    commands.push("cargo clippy");
-  }
-
-  if (detectedFiles.includes("go.mod")) {
-    commands.push("go test ./...");
-    commands.push("go vet ./...");
-  }
-
-  if (detectedFiles.includes("pyproject.toml") || detectedFiles.includes("setup.py")) {
-    commands.push("pytest");
-  }
-
-  if (detectedFiles.includes("Gemfile")) {
-    // Check for rspec vs minitest
-    if (existsSync(join(basePath, "spec"))) {
-      commands.push("bundle exec rspec");
-    } else {
-      commands.push("bundle exec rake test");
-    }
-  }
-
-  if (detectedFiles.includes("Makefile")) {
-    const makeTargets = readMakefileTargets(basePath);
-    if (makeTargets.includes("test")) {
-      commands.push("make test");
-    }
-  }
-
-  return commands;
-}
-
-// ─── Global Setup Detection ─────────────────────────────────────────────────────
-
-/**
- * Check if global GSD setup exists (has ~/.gsd/ with preferences).
- */
-export function hasGlobalSetup(): boolean {
-  const gsdHome = join(homedir(), ".gsd");
-  return (
-    existsSync(join(gsdHome, "preferences.md")) ||
-    existsSync(join(gsdHome, "PREFERENCES.md"))
-  );
-}
-
-/**
- * Check if this is the very first time GSD has been used on this machine.
- * Returns true if ~/.gsd/ doesn't exist or has no preferences or auth.
- */
-export function isFirstEverLaunch(): boolean {
-  const gsdHome = join(homedir(), ".gsd");
-  if (!existsSync(gsdHome)) return true;
-
-  // If we have preferences, not first launch
-  if (
-    existsSync(join(gsdHome, "preferences.md")) ||
-    existsSync(join(gsdHome, "PREFERENCES.md"))
-  ) {
-    return false;
-  }
-
-  // If we have auth.json, not first launch (onboarding.ts already ran)
-  if (existsSync(join(gsdHome, "agent", "auth.json"))) return false;
-
-  // Check legacy path too
-  const legacyPath = join(homedir(), ".pi", "agent", "gsd-preferences.md");
-  if (existsSync(legacyPath)) return false;
-
-  return true;
-}
-
-// ─── Helpers ────────────────────────────────────────────────────────────────────
-
-function packageJsonHasWorkspaces(basePath: string): boolean {
-  try {
-    const raw = readFileSync(join(basePath, "package.json"), "utf-8");
-    const pkg = JSON.parse(raw);
-    return Array.isArray(pkg.workspaces) || (pkg.workspaces && typeof pkg.workspaces === "object");
-  } catch {
-    return false;
-  }
-}
-
-function readPackageJsonScripts(basePath: string): Record<string, string> | null {
-  try {
-    const raw = readFileSync(join(basePath, "package.json"), "utf-8");
-    const pkg = JSON.parse(raw);
-    return pkg.scripts && typeof pkg.scripts === "object" ? pkg.scripts : null;
-  } catch {
-    return null;
-  }
-}
-
-function readMakefileTargets(basePath: string): string[] {
-  try {
-    const raw = readFileSync(join(basePath, "Makefile"), "utf-8");
-    const targets: string[] = [];
-    for (const line of raw.split("\n")) {
-      const match = line.match(/^([a-zA-Z_][a-zA-Z0-9_-]*):/);
-      if (match) targets.push(match[1]);
-    }
-    return targets;
-  } catch {
-    return [];
-  }
-}

package/dist/resources/extensions/gsd/diff-context.ts

@@ -1,214 +0,0 @@
-/**
- * Diff-aware context module — prioritizes recently-changed files when building
- * context for the AI agent. Uses git diff/status to discover changes, then
- * provides ranking utilities for context-window budget allocation.
- *
- * Standalone module: only imports node:child_process and node:path.
- */
-
-import { execFileSync, execFile } from "node:child_process";
-import { resolve } from "node:path";
-import { GSDError, GSD_PARSE_ERROR } from "./errors.js";
-
-// ─── Types ──────────────────────────────────────────────────────────────────
-
-export interface ChangedFileInfo {
-  path: string;
-  changeType: "modified" | "added" | "deleted" | "staged";
-  linesChanged?: number;
-}
-
-export interface RecentFilesOptions {
-  /** Maximum number of files to return (default 20) */
-  maxFiles?: number;
-  /** Only consider commits within this many days (default 7) */
-  sinceDays?: number;
-}
-
-// ─── Helpers ────────────────────────────────────────────────────────────────
-
-const EXEC_OPTS = {
-  encoding: "utf-8" as const,
-  timeout: 5000,
-  stdio: ["pipe", "pipe", "pipe"] as ["pipe", "pipe", "pipe"],
-};
-
-/** Synchronous git — used where sequential control flow is required (fallback paths). */
-function gitSync(args: string[], cwd: string): string {
-  return execFileSync("git", args, { ...EXEC_OPTS, cwd }).trim();
-}
-
-/** Async git — returns stdout on success, empty string on any error. */
-function gitAsync(args: string[], cwd: string): Promise<string> {
-  return new Promise((resolve) => {
-    execFile(
-      "git",
-      args,
-      { encoding: "utf-8", timeout: 5000, cwd },
-      (err, stdout) => resolve(err ? "" : stdout.trim()),
-    );
-  });
-}
-
-function splitLines(output: string): string[] {
-  return output
-    .split("\n")
-    .map((l) => l.trim())
-    .filter(Boolean);
-}
-
-// ─── Public API ─────────────────────────────────────────────────────────────
-
-/**
- * Returns recently-changed file paths, deduplicated and sorted by recency
- * (most recent first). Combines committed diffs, staged changes, and
- * unstaged/untracked files from `git status`.
- *
- * The three git queries (log, diff --cached, status) run concurrently.
- */
-export async function getRecentlyChangedFiles(
-  cwd: string,
-  options?: RecentFilesOptions,
-): Promise<string[]> {
-  const maxFiles = options?.maxFiles ?? 20;
-  const sinceDays = options?.sinceDays ?? 7;
-  const dir = resolve(cwd);
-
-  try {
-    const days = Math.max(1, Math.floor(Number(sinceDays)));
-    if (!Number.isFinite(days)) throw new GSDError(GSD_PARSE_ERROR, "invalid sinceDays");
-
-    // Run all three queries concurrently — they read independent git state
-    const [logRaw, stagedRaw, statusRaw] = await Promise.all([
-      // 1. Committed changes since N days ago (fallback to HEAD~10 on error)
-      gitAsync(["log", "--diff-filter=ACMR", "--name-only", "--pretty=format:", `--since=${days} days ago`], dir)
-        .then((out) => out || gitAsync(["diff", "--name-only", "HEAD~10"], dir)),
-      // 2. Staged changes
-      gitAsync(["diff", "--cached", "--name-only"], dir),
-      // 3. Unstaged / untracked
-      gitAsync(["status", "--porcelain"], dir),
-    ]);
-
-    const committedFiles = splitLines(logRaw);
-    const stagedFiles = splitLines(stagedRaw);
-    const statusFiles = splitLines(statusRaw).map((line) => line.slice(3)); // strip XY + space
-
-    // Deduplicate, preserving insertion order (most-recent-first: status → staged → committed)
-    const seen = new Set<string>();
-    const result: string[] = [];
-    for (const file of [...statusFiles, ...stagedFiles, ...committedFiles]) {
-      if (!seen.has(file)) {
-        seen.add(file);
-        result.push(file);
-      }
-    }
-
-    return result.slice(0, maxFiles);
-  } catch {
-    // Non-git directory or git unavailable — graceful fallback
-    return [];
-  }
-}
-
-/**
- * Returns richer change metadata: change type and approximate line counts.
- *
- * The three git queries (diff --cached --numstat, diff --numstat, status --porcelain)
- * run concurrently — they read independent git state.
- */
-export async function getChangedFilesWithContext(
-  cwd: string,
-): Promise<ChangedFileInfo[]> {
-  const dir = resolve(cwd);
-
-  try {
-    // Run all three queries concurrently
-    const [cachedNumstat, unstagedNumstat, statusRaw] = await Promise.all([
-      gitAsync(["diff", "--cached", "--numstat"], dir),
-      gitAsync(["diff", "--numstat"], dir),
-      gitAsync(["status", "--porcelain"], dir),
-    ]);
-
-    const result: ChangedFileInfo[] = [];
-    const seen = new Set<string>();
-
-    const add = (info: ChangedFileInfo) => {
-      if (!seen.has(info.path)) {
-        seen.add(info.path);
-        result.push(info);
-      }
-    };
-
-    // 1. Staged files with numstat
-    for (const line of splitLines(cachedNumstat)) {
-      const [added, deleted, filePath] = line.split("\t");
-      if (!filePath) continue;
-      const lines =
-        added === "-" || deleted === "-"
-          ? undefined
-          : Number(added) + Number(deleted);
-      add({ path: filePath, changeType: "staged", linesChanged: lines });
-    }
-
-    // 2. Unstaged modifications with numstat
-    for (const line of splitLines(unstagedNumstat)) {
-      const [added, deleted, filePath] = line.split("\t");
-      if (!filePath) continue;
-      const lines =
-        added === "-" || deleted === "-"
-          ? undefined
-          : Number(added) + Number(deleted);
-      add({ path: filePath, changeType: "modified", linesChanged: lines });
-    }
-
-    // 3. Untracked / deleted from porcelain status
-    for (const line of splitLines(statusRaw)) {
-      const code = line.slice(0, 2);
-      const filePath = line.slice(3);
-      if (seen.has(filePath)) continue;
-
-      if (code.includes("?")) {
-        add({ path: filePath, changeType: "added" });
-      } else if (code.includes("D")) {
-        add({ path: filePath, changeType: "deleted" });
-      } else if (code.includes("A")) {
-        add({ path: filePath, changeType: "added" });
-      } else {
-        add({ path: filePath, changeType: "modified" });
-      }
-    }
-
-    return result;
-  } catch {
-    return [];
-  }
-}
-
-/**
- * Ranks a file list so that recently-changed files appear first.
- * Files present in `changedFiles` are placed at the front (in their
- * original changedFiles order), followed by unchanged files in their
- * original order.
- */
-export function rankFilesByRelevance(
-  files: string[],
-  changedFiles: string[],
-): string[] {
-  const changedSet = new Set(changedFiles);
-  const changed: string[] = [];
-  const rest: string[] = [];
-
-  for (const f of files) {
-    if (changedSet.has(f)) {
-      changed.push(f);
-    } else {
-      rest.push(f);
-    }
-  }
-
-  // Maintain changedFiles priority order within the changed group
-  const changedOrder = new Map(changedFiles.map((f, i) => [f, i]));
-  changed.sort((a, b) => (changedOrder.get(a) ?? 0) - (changedOrder.get(b) ?? 0));
-
-  return [...changed, ...rest];
-}