@samaksh/git-worker 0.1.0 → 0.2.1

package/demo/index.ts

@@ -1,526 +0,0 @@
-#!/usr/bin/env tsx
-/**
- * git-worker demo / functional verification script
- *
- * Sets up a realistic local Git repository with 4 branches, each containing
- * a .env file with different values, then runs the full git-worker pipeline
- * against it in non-interactive (--ci --auto-approve) mode so you can verify
- * every stage end-to-end without clicking through prompts.
- *
- * Usage:
- *   npx tsx demo/index.ts            # full interactive run
- *   npx tsx demo/index.ts --ci       # non-interactive (CI) run
- *   npx tsx demo/index.ts --clean    # remove demo repo only
- */
-
-import { execSync, spawnSync } from "child_process";
-import { existsSync, mkdirSync, rmSync, writeFileSync, readFileSync } from "fs";
-import { join, resolve } from "path";
-import { tmpdir, homedir } from "os";
-import { createHash } from "crypto";
-import chalk from "chalk";
-
-// ── Config ─────────────────────────────────────────────────────────────────
-
-const DEMO_DIR = join(tmpdir(), "git-worker-demo");
-const BARE_REPO = join(DEMO_DIR, "remote.git");   // acts as the "remote"
-const WORK_REPO = join(DEMO_DIR, "workspace");    // working clone for branch setup
-
-// ── Arg parsing ────────────────────────────────────────────────────────────
-
-const args = process.argv.slice(2);
-const isCI = args.includes("--ci");
-const cleanOnly = args.includes("--clean");
-
-// ── Helpers ────────────────────────────────────────────────────────────────
-
-function section(title: string) {
-  console.log("");
-  console.log(chalk.bold.cyan("  ══════════════════════════════════════════════"));
-  console.log(chalk.bold.cyan(`  ${title}`));
-  console.log(chalk.bold.cyan("  ══════════════════════════════════════════════"));
-}
-
-function git(args: string[], cwd: string): string {
-  const result = spawnSync("git", args, { cwd, encoding: "utf-8" });
-  if (result.status !== 0) {
-    throw new Error(`git ${args.join(" ")} failed:\n${result.stderr}`);
-  }
-  return result.stdout.trim();
-}
-
-function step(msg: string) {
-  console.log(chalk.gray(`  → ${msg}`));
-}
-
-function ok(msg: string) {
-  console.log(chalk.green(`  ✓ ${msg}`));
-}
-
-// ── Branches + .env content ────────────────────────────────────────────────
-
-/**
- * The demo repo models a microservices monorepo with four UAT branches.
- * Each branch has a .env file with:
- *   - SERVICE_NAME  (varies per branch — will become a dynamic placeholder)
- *   - DB_PORT       (varies — will become a dynamic placeholder)
- *   - DB_NAME       (same on all — will become a static value)
- *   - LOG_LEVEL     (missing on uat/orders — triggers per-branch prompt in interactive mode)
- *   - CUSTOM_FLAG   (unmanaged key — must be preserved)
- */
-const BRANCHES: Array<{
-  name: string;
-  env: string;
-  note: string;
-}> = [
-  {
-    name: "uat/payments",
-    env: `# UAT payments service
-DB_NAME=uat_db
-DB_PORT=54321
-SERVICE_NAME=payments
-LOG_LEVEL=info
-CUSTOM_FLAG=payments-only-feature
-`,
-    note: "All keys present",
-  },
-  {
-    name: "uat/orders",
-    env: `# UAT orders service
-DB_NAME=uat_db
-DB_PORT=54322
-SERVICE_NAME=orders
-# LOG_LEVEL is intentionally missing here — will trigger a prompt in interactive mode
-CUSTOM_FLAG=orders-flag
-`,
-    note: "LOG_LEVEL missing (will prompt or fail in CI)",
-  },
-  {
-    name: "uat/inventory",
-    env: `# UAT inventory service
-DB_NAME=uat_db
-DB_PORT=54323
-SERVICE_NAME=inventory
-LOG_LEVEL=warn
-CUSTOM_FLAG=inventory-flag
-export LEGACY_VAR=keep-export-prefix
-`,
-    note: "Has 'export' prefix on one key — must be preserved",
-  },
-  {
-    name: "uat/notifications",
-    env: `# UAT notifications service
-DB_NAME=legacy_db
-DB_PORT=54324
-SERVICE_NAME=notifications
-LOG_LEVEL=debug
-CUSTOM_FLAG=notif-flag
-`,
-    note: "DB_NAME is wrong ('legacy_db') — static template will correct it",
-  },
-];
-
-/**
- * The template we'll use.
- * - DB_NAME=uat_db       → static: enforced on all branches
- * - DB_PORT={DB_PORT}    → dynamic: read per branch
- * - SERVICE_NAME={SERVICE_NAME} → dynamic
- * - LOG_LEVEL={LOG_LEVEL} → dynamic (missing on uat/orders — prompts in interactive)
- * CUSTOM_FLAG is not declared → preserved untouched on each branch
- */
-const TEMPLATE = `# Git Worker Demo Template
-# Static values are enforced on every branch
-DB_NAME=uat_db
-
-# Dynamic values are read from each branch
-DB_PORT={DB_PORT}
-SERVICE_NAME={SERVICE_NAME}
-LOG_LEVEL={LOG_LEVEL}
-`;
-
-// ── Setup ──────────────────────────────────────────────────────────────────
-
-function setupDemoRepo() {
-  section("Setting up demo repository");
-
-  if (existsSync(DEMO_DIR)) {
-    step("Removing existing demo directory…");
-    rmSync(DEMO_DIR, { recursive: true, force: true });
-  }
-  mkdirSync(DEMO_DIR, { recursive: true });
-
-  // 1. Create bare repo (the "remote")
-  step("Creating bare repo (remote)…");
-  git(["init", "--bare", "remote.git"], DEMO_DIR);
-  ok(`Bare repo: ${BARE_REPO}`);
-
-  // 2. Clone into workspace
-  step("Cloning into workspace…");
-  git(["clone", BARE_REPO, "workspace"], DEMO_DIR);
-  ok(`Workspace: ${WORK_REPO}`);
-
-  // Configure git identity for commits
-  git(["config", "user.email", "demo@git-worker.local"], WORK_REPO);
-  git(["config", "user.name", "Git Worker Demo"], WORK_REPO);
-
-  // 3. Create initial commit on main
-  step("Creating initial commit on main…");
-  writeFileSync(join(WORK_REPO, "README.md"), "# Demo Repo\nManaged by git-worker demo.\n");
-  git(["add", "."], WORK_REPO);
-  git(["commit", "-m", "chore: initial commit"], WORK_REPO);
-  git(["push", "-u", "origin", "main"], WORK_REPO);
-
-  // 4. Create branches with .env files
-  for (const branch of BRANCHES) {
-    step(`Creating branch ${chalk.cyan(branch.name)} — ${branch.note}`);
-    git(["checkout", "-b", branch.name], WORK_REPO);
-    writeFileSync(join(WORK_REPO, ".env"), branch.env);
-    git(["add", ".env"], WORK_REPO);
-    git(["commit", "-m", `chore: add .env for ${branch.name}`], WORK_REPO);
-    git(["push", "-u", "origin", branch.name], WORK_REPO);
-    git(["checkout", "main"], WORK_REPO);
-    ok(`  ${branch.name}`);
-  }
-
-  // 5. Save the template as the saved state so git-worker loads it automatically
-  //    (skipping the editor step in CI mode)
-  const stateDir = join(DEMO_DIR, "state");
-  mkdirSync(stateDir, { recursive: true });
-
-  console.log("");
-  section("Demo Repository Contents");
-
-  console.log("");
-  console.log(chalk.bold("  Branches created:"));
-  for (const branch of BRANCHES) {
-    console.log(chalk.gray(`    ${branch.name.padEnd(22)} ${branch.note}`));
-  }
-
-  console.log("");
-  console.log(chalk.bold("  Template that will be applied:"));
-  console.log(chalk.gray("  ┌" + "─".repeat(58) + "┐"));
-  for (const line of TEMPLATE.split("\n")) {
-    console.log(chalk.gray(`  │ ${line.padEnd(57)}│`));
-  }
-  console.log(chalk.gray("  └" + "─".repeat(58) + "┘"));
-
-  console.log("");
-  console.log(chalk.bold("  Expected outcome per branch:"));
-  console.log(chalk.gray("    uat/payments     — DB_NAME corrected if wrong, LOG_LEVEL preserved"));
-  console.log(chalk.gray("    uat/orders       — LOG_LEVEL missing → prompt (or skip in CI)"));
-  console.log(chalk.gray("    uat/inventory    — 'export' prefix on LEGACY_VAR preserved"));
-  console.log(chalk.gray("    uat/notifications— DB_NAME: legacy_db → uat_db (static enforcement)"));
-
-  return WORK_REPO;
-}
-
-// ── Run git-worker ─────────────────────────────────────────────────────────
-
-function runGitWorker(workRepoPath: string) {
-  section("Running git-worker");
-
-  // Discover the remote URL that git-worker will use to identify the project
-  // (the bare repo path is what workspace/manager.ts will resolve from WORK_REPO's origin)
-  const remoteUrl = BARE_REPO;
-
-  // Save the template into the workspace state dir so the tool loads it
-  // (avoids the editor opening in the demo)
-  const workerStateRoot = join(homedir(), ".git-worker");
-
-  const projectId = createHash("sha256").update(remoteUrl).digest("hex").slice(0, 16);
-  const stateDir = join(workerStateRoot, "projects", projectId, "state");
-  mkdirSync(stateDir, { recursive: true });
-
-  const stateFile = join(stateDir, ".env.state.json");
-  writeFileSync(
-    stateFile,
-    JSON.stringify(
-      {
-        schemaVersion: 1,
-        targetPath: ".env",
-        template: TEMPLATE,
-        updatedAt: new Date().toISOString(),
-      },
-      null,
-      2
-    )
-  );
-  ok(`Pre-loaded template into state: ${stateFile}`);
-
-  const cliPath = resolve("dist/cli/index.js");
-  if (!existsSync(cliPath)) {
-    console.log(chalk.yellow("  ⚠ dist/ not found — building first…"));
-    execSync("node_modules/.bin/tsc", { stdio: "inherit" });
-  }
-
-  const pushPolicy = isCI ? "always" : "never";
-
-  const flags = [
-    "--repo", WORK_REPO,
-    "--branch", "/^uat\\//",
-    "--file", ".env",
-    "--push", pushPolicy,
-  ];
-
-  if (isCI) {
-    // In CI mode: non-interactive, auto-approve, LOG_LEVEL missing branch will be skipped
-    flags.push("--ci", "--auto-approve");
-    console.log("");
-    console.log(chalk.bold("  Mode: CI (non-interactive, auto-approve, push: always)"));
-    console.log(chalk.gray("  Note: uat/orders will fail because LOG_LEVEL is missing (expected in CI)"));
-  } else {
-    // Interactive mode: git-worker will prompt for LOG_LEVEL on uat/orders
-    console.log("");
-    console.log(chalk.bold("  Mode: Interactive"));
-    console.log(chalk.yellow("  ℹ  The editor will NOT open (template is pre-loaded)"));
-    console.log(chalk.yellow("  ℹ  You will be prompted to enter LOG_LEVEL for uat/orders"));
-    console.log(chalk.yellow("  ℹ  Review each branch diff and approve/reject individually"));
-  }
-
-  console.log("");
-  console.log(chalk.bold("  Command:"));
-  console.log(chalk.gray(`    node ${cliPath} ${flags.join(" ")}`));
-  console.log("");
-  console.log(chalk.cyan("─".repeat(66)));
-  console.log("");
-
-  // Run git-worker
-  const result = spawnSync("node", [cliPath, ...flags], {
-    stdio: "inherit",
-    env: { ...process.env },
-  });
-
-  console.log("");
-  console.log(chalk.cyan("─".repeat(66)));
-
-  if (result.status === 0) {
-    section("Verification");
-    verifyResults(BARE_REPO);
-  } else {
-    console.log(chalk.red(`\n  git-worker exited with code ${result.status}`));
-    // Still run verification to see partial results
-    section("Partial Verification");
-    verifyResults(BARE_REPO);
-  }
-}
-
-// ── Verify results ─────────────────────────────────────────────────────────
-
-function verifyResults(remoteUrl: string) {
-  console.log("");
-  console.log(chalk.bold("  Checking .env on each branch after git-worker run:"));
-  console.log("");
-
-  const verifyRepo = join(DEMO_DIR, "verify-clone");
-  if (!existsSync(verifyRepo)) {
-    git(["clone", remoteUrl, "verify-clone"], DEMO_DIR);
-    git(["config", "user.email", "verify@git-worker.local"], verifyRepo);
-    git(["config", "user.name", "Verify"], verifyRepo);
-  } else {
-    git(["fetch", "--all"], verifyRepo);
-  }
-
-  for (const branch of BRANCHES) {
-    try {
-      const content = git(["show", `origin/${branch.name}:.env`], verifyRepo);
-      const lines = content.split("\n").filter((l) => !l.startsWith("#") && l.trim());
-      const map = new Map<string, string>();
-      for (const line of lines) {
-        const eq = line.indexOf("=");
-        if (eq !== -1) {
-          const key = line.slice(0, eq).replace(/^export\s+/, "").trim();
-          const val = line.slice(eq + 1).trim();
-          map.set(key, val);
-        }
-      }
-
-      const checks: Array<{ key: string; expected: string; actual: string | undefined; ok: boolean }> = [];
-
-      // DB_NAME must be uat_db (static enforcement)
-      checks.push({
-        key: "DB_NAME",
-        expected: "uat_db",
-        actual: map.get("DB_NAME"),
-        ok: map.get("DB_NAME") === "uat_db",
-      });
-
-      // CUSTOM_FLAG must still exist (unmanaged key preservation)
-      checks.push({
-        key: "CUSTOM_FLAG",
-        expected: "(present)",
-        actual: map.has("CUSTOM_FLAG") ? "(present)" : "(missing)",
-        ok: map.has("CUSTOM_FLAG"),
-      });
-
-      // SERVICE_NAME must still be set (dynamic)
-      checks.push({
-        key: "SERVICE_NAME",
-        expected: "(present)",
-        actual: map.has("SERVICE_NAME") ? "(present)" : "(missing)",
-        ok: map.has("SERVICE_NAME"),
-      });
-
-      const branchOk = checks.every((c) => c.ok);
-      const icon = branchOk ? chalk.green("✓") : chalk.red("✗");
-      console.log(`  ${icon} ${chalk.bold(branch.name.padEnd(24))}`);
-      for (const c of checks) {
-        const cIcon = c.ok ? chalk.green("  ✓") : chalk.red("  ✗");
-        const val = c.ok
-          ? chalk.gray(`${c.key}=${c.actual}`)
-          : chalk.red(`${c.key}: expected ${c.expected}, got ${c.actual ?? "(missing)"}`);
-        console.log(`    ${cIcon} ${val}`);
-      }
-    } catch {
-      console.log(chalk.yellow(`  ⚠ ${branch.name} — could not read (may not have been committed)`));
-    }
-  }
-
-  console.log("");
-  console.log(chalk.bold("  Demo workspace:"));
-  console.log(chalk.gray(`    Remote: ${BARE_REPO}`));
-  console.log(chalk.gray(`    Clone:  ${WORK_REPO}`));
-  console.log(chalk.gray(`    Verify: ${verifyRepo}`));
-  console.log("");
-}
-
-const DOCKERFILE_TEMPLATE = `# Source-of-Truth Dockerfile Template
-FROM node:20-alpine AS base
-ENV SERVICE_NAME=\${SERVICE_NAME}
-ENV BRANCH_NAME=\${BRANCH_NAME}
-ENV BRANCH_SLUG=\${BRANCH_SLUG}
-EXPOSE \${PORT:-8080}
-`;
-
-function runDockerfileDemo(remoteUrl: string) {
-  section("Phase 2: Dockerfile Synchronization (Source of Truth Engine)");
-
-  const workerStateRoot = join(homedir(), ".git-worker");
-  const projectId = createHash("sha256").update(remoteUrl).digest("hex").slice(0, 16);
-  const stateDir = join(workerStateRoot, "projects", projectId, "state");
-  mkdirSync(stateDir, { recursive: true });
-
-  const stateFile = join(stateDir, "Dockerfile.state.json");
-  writeFileSync(
-    stateFile,
-    JSON.stringify(
-      {
-        schemaVersion: 1,
-        targetPath: "Dockerfile",
-        template: DOCKERFILE_TEMPLATE,
-        updatedAt: new Date().toISOString(),
-      },
-      null,
-      2
-    )
-  );
-  ok(`Pre-loaded Dockerfile template into state: ${stateFile}`);
-
-  const cliPath = resolve("dist/cli/index.js");
-  const pushPolicy = isCI ? "always" : "never";
-  const flags = [
-    "--repo", WORK_REPO,
-    "--branch", "/^uat\\//",
-    "--file", "Dockerfile",
-    "--push", pushPolicy,
-  ];
-
-  if (isCI) {
-    flags.push("--ci", "--auto-approve");
-  }
-
-  console.log("");
-  console.log(chalk.bold("  Command:"));
-  console.log(chalk.gray(`    node ${cliPath} ${flags.join(" ")}`));
-  console.log("");
-  console.log(chalk.cyan("─".repeat(66)));
-  console.log("");
-
-  const result = spawnSync("node", [cliPath, ...flags], {
-    stdio: "inherit",
-    env: { ...process.env },
-  });
-
-  console.log("");
-  console.log(chalk.cyan("─".repeat(66)));
-
-  if (result.status === 0) {
-    section("Dockerfile Verification");
-    verifyDockerfileResults(BARE_REPO);
-  } else {
-    console.log(chalk.red(`\n  git-worker exited with code ${result.status}`));
-    section("Partial Dockerfile Verification");
-    verifyDockerfileResults(BARE_REPO);
-  }
-}
-
-function verifyDockerfileResults(remoteUrl: string) {
-  console.log("");
-  console.log(chalk.bold("  Checking Dockerfile on each branch after git-worker run:"));
-  console.log("");
-
-  const verifyRepo = join(DEMO_DIR, "verify-clone");
-  git(["fetch", "--all"], verifyRepo);
-
-  for (const branch of BRANCHES) {
-    try {
-      const content = git(["show", `origin/${branch.name}:Dockerfile`], verifyRepo);
-      const hasService = content.includes(`ENV SERVICE_NAME=`);
-      const hasBranch = content.includes(`ENV BRANCH_NAME=${branch.name}`);
-      const hasPort = content.includes(`EXPOSE 8080`);
-
-      const checks = [
-        { label: "SERVICE_NAME resolved from .env", ok: hasService },
-        { label: `BRANCH_NAME built-in (${branch.name})`, ok: hasBranch },
-        { label: "PORT fallback used (8080)", ok: hasPort },
-      ];
-
-      const allOk = checks.every((c) => c.ok);
-      const icon = allOk ? chalk.green("✓") : chalk.red("✗");
-      console.log(`  ${icon} ${chalk.bold(branch.name.padEnd(24))}`);
-      for (const c of checks) {
-        const cIcon = c.ok ? chalk.green("  ✓") : chalk.red("  ✗");
-        console.log(`    ${cIcon} ${c.label}`);
-      }
-    } catch {
-      console.log(chalk.yellow(`  ⚠ ${branch.name} — could not read Dockerfile`));
-    }
-  }
-
-  // Verify persistence: check that state file was saved
-  const workerStateRoot = join(homedir(), ".git-worker");
-  const projectId = createHash("sha256").update(remoteUrl).digest("hex").slice(0, 16);
-  const stateFile = join(workerStateRoot, "projects", projectId, "state", "Dockerfile.state.json");
-  if (existsSync(stateFile)) {
-    console.log("");
-    ok(`State persistence verified: ${stateFile} updated with latest applied template`);
-  }
-}
-
-// ── Entry point ────────────────────────────────────────────────────────────
-
-async function main() {
-  console.log("");
-  console.log(chalk.bold.cyan("  ◆ git-worker  —  Demo & Functional Verification"));
-  console.log(chalk.gray("  Exercises every stage of the pipeline with a real local Git repo"));
-  console.log("");
-
-  if (cleanOnly) {
-    if (existsSync(DEMO_DIR)) {
-      rmSync(DEMO_DIR, { recursive: true, force: true });
-      console.log(chalk.green(`  ✓ Removed ${DEMO_DIR}`));
-    } else {
-      console.log(chalk.gray(`  Nothing to clean at ${DEMO_DIR}`));
-    }
-    return;
-  }
-
-  const _workRepo = setupDemoRepo();
-  runGitWorker(BARE_REPO);
-  runDockerfileDemo(BARE_REPO);
-}
-
-main().catch((e) => {
-  console.error(chalk.red(`\nDemo error: ${e.message}`));
-  if (process.env.DEBUG) console.error(e.stack);
-  process.exit(1);
-});

package/src/app.ts

@@ -1,69 +0,0 @@
-import { CliInput, RunContext, AppDeps, AppServices, Result, ok } from "./core/types.js";
-import { loadConfig } from "./config/load.js";
-import { pipeline } from "./core/pipeline.js";
-
-// Services
-import { createGitReader } from "./services/git/reader.js";
-import { createGitOps } from "./services/git/ops.js";
-import { createWorkspaceManager } from "./services/workspace/manager.js";
-import { createTemplateService } from "./services/template/transform.js";
-import { createStateService } from "./services/state/index.js";
-import { createEditorService } from "./services/editor/index.js";
-import { createReviewService } from "./services/review/index.js";
-
-// Stages
-import { resolveProjectStage } from "./stages/resolve-project.js";
-import { syncRepositoryStage } from "./stages/sync.js";
-import { selectTargetsStage } from "./stages/select.js";
-import { checkEligibilityStage } from "./stages/eligibility.js";
-import { loadTemplateStage } from "./stages/load-template.js";
-import { editTemplateStage } from "./stages/edit-template.js";
-import { planChangesStage } from "./stages/plan.js";
-import { reviewChangesStage } from "./stages/review.js";
-import { applyChangesStage } from "./stages/apply.js";
-import { pushChangesStage } from "./stages/push.js";
-import { reportResultsStage } from "./stages/report.js";
-
-function createServices(): AppServices {
-  return {
-    git: createGitReader(),
-    gitOps: createGitOps(),
-    workspace: createWorkspaceManager(),
-    template: createTemplateService(),
-    state: createStateService(),
-    editor: createEditorService(),
-    review: createReviewService(),
-  };
-}
-
-export async function run(input: CliInput): Promise<Result<RunContext>> {
-  const config = loadConfig(input);
-  const services = createServices();
-
-  const deps: AppDeps = { config, services };
-
-  const context: RunContext = {
-    runId: `${Date.now()}`,
-    input,
-  };
-
-  const runPipeline = pipeline<RunContext, AppDeps>(
-    resolveProjectStage,
-    syncRepositoryStage,
-    selectTargetsStage,
-    checkEligibilityStage,
-    loadTemplateStage,
-    editTemplateStage,
-    planChangesStage,
-    reviewChangesStage,
-    applyChangesStage,
-    pushChangesStage,
-    reportResultsStage,
-  );
-
-  const result = await runPipeline(context, deps);
-  if (result.ok && result.value.project) {
-    services.workspace.releaseLock(result.value.project);
-  }
-  return result;
-}