@mknightzzz/stw 0.1.0

package/dist/worktree-cleanup.js

@@ -0,0 +1,325 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync, readdirSync, rmSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { readJson, fileExists, runDir, taskDir } from './storage.js';
+import { readTaskStatus } from './status.js';
+import { acquireLock, readLock, releaseLock } from './lock.js';
+const DELETABLE_ARTIFACTS = [
+    'response_raw.txt',
+    'response.json',
+    'diff.patch',
+    'worker_prompt.md',
+    'review.json',
+    'diagnostic.json',
+    'trim-log.json',
+];
+function getTaskGraph(stwRoot, runId) {
+    const graphPath = join(runDir(stwRoot, runId), 'task_graph.json');
+    if (!fileExists(graphPath)) {
+        return null;
+    }
+    return readJson(graphPath);
+}
+function getEligibleTaskIds(stwRoot, runId) {
+    return getTaskGraph(stwRoot, runId)?.tasks.map((task) => task.id) ?? [];
+}
+function parseTaskIdFromBranch(branch) {
+    const match = branch.match(/-(T\d+)$/);
+    return match?.[1] ?? null;
+}
+function getPreservedWorktreePaths(status) {
+    if (!status)
+        return [];
+    const paths = new Set();
+    if (status.preserved_worktree_path) {
+        paths.add(status.preserved_worktree_path);
+    }
+    for (const value of status.preserved_worktree_paths ?? []) {
+        if (value)
+            paths.add(value);
+    }
+    return [...paths];
+}
+function getRunTaskIds(stwRoot, runId) {
+    return new Set(getEligibleTaskIds(stwRoot, runId));
+}
+function worktreeBelongsToRun(worktree, runId, taskIds) {
+    if (!worktree.branch.includes(runId)) {
+        return false;
+    }
+    const taskId = parseTaskIdFromBranch(worktree.branch);
+    return taskId !== null && taskIds.has(taskId);
+}
+function branchBelongsToRun(branch, runId, taskIds) {
+    if (!branch.includes(runId)) {
+        return false;
+    }
+    const taskId = parseTaskIdFromBranch(branch);
+    return taskId !== null && taskIds.has(taskId);
+}
+export function listOrphanedWorktrees(repoRoot, runId) {
+    const opts = { cwd: repoRoot, encoding: 'utf-8', stdio: 'pipe' };
+    const output = execFileSync('git', ['worktree', 'list'], opts);
+    return output
+        .trim()
+        .split('\n')
+        .filter((line) => line.includes('stw-worktree-') || line.includes('stw-T'))
+        .map((line) => {
+        const parts = line.trim().split(/\s+/);
+        return {
+            path: parts[0],
+            commit: parts[1],
+            branch: (parts[2] ?? '').replace(/[[\]]/g, ''),
+        };
+    })
+        .filter((worktree) => {
+        if (!runId)
+            return true;
+        return worktree.branch.includes(runId);
+    });
+}
+export function cleanupRunWorktrees(repoRoot, runId, opts) {
+    const preservedPaths = new Set(opts?.preservedPaths ?? []);
+    const taskIds = new Set(opts?.taskIds ?? []);
+    const worktrees = listOrphanedWorktrees(repoRoot, runId)
+        .filter((worktree) => (taskIds.size === 0 ? true : worktreeBelongsToRun(worktree, runId, taskIds)))
+        .filter((worktree) => !preservedPaths.has(worktree.path));
+    if (opts?.dryRun)
+        return worktrees;
+    const execOpts = { cwd: repoRoot, encoding: 'utf-8', stdio: 'pipe' };
+    for (const wt of worktrees) {
+        try {
+            execFileSync('git', ['worktree', 'remove', '--force', wt.path], execOpts);
+        }
+        catch {
+            // worktree may already be gone
+        }
+    }
+    return worktrees;
+}
+export function checkRunEligibility(stwRoot, runId, options) {
+    const manifestPath = join(runDir(stwRoot, runId), 'manifest.json');
+    if (!fileExists(manifestPath)) {
+        return { eligible: false, reason: `No manifest found for run ${runId}` };
+    }
+    const manifest = readJson(manifestPath);
+    const terminalStates = ['complete', 'failed', 'stopped'];
+    if (!terminalStates.includes(manifest.status)) {
+        return { eligible: false, reason: `Run status is '${manifest.status}', not terminal` };
+    }
+    const graph = getTaskGraph(stwRoot, runId);
+    if (graph) {
+        for (const task of graph.tasks) {
+            const status = readTaskStatus(stwRoot, runId, task.id);
+            if (!status) {
+                const statePath = join(taskDir(stwRoot, runId, task.id), 'state.json');
+                if (fileExists(statePath)) {
+                    const state = readJson(statePath);
+                    if (state.state === 'working' || state.state === 'queued') {
+                        return { eligible: false, reason: `Task ${task.id} is still ${state.state}` };
+                    }
+                }
+                continue;
+            }
+            if (status.status === 'blocked') {
+                return { eligible: false, reason: `Task ${task.id} is blocked` };
+            }
+        }
+    }
+    const lock = readLock(stwRoot);
+    if (lock && !lock.isStale && lock.data.run_id === runId) {
+        return { eligible: false, reason: `Run has an active lock (PID ${lock.data.pid})` };
+    }
+    if (!options.gitlabAvailable) {
+        return options.force
+            ? { eligible: true }
+            : { eligible: false, reason: 'GitLab unavailable — use --force to skip MR verification' };
+    }
+    const mrState = checkMRState(stwRoot, runId);
+    if (mrState && mrState !== 'merged' && mrState !== 'closed') {
+        return { eligible: false, reason: `MR is still '${mrState}'` };
+    }
+    return { eligible: true };
+}
+function checkMRState(stwRoot, runId) {
+    const manifestPath = join(runDir(stwRoot, runId), 'manifest.json');
+    const manifest = readJson(manifestPath);
+    if (!manifest.pr_number)
+        return null;
+    try {
+        const output = execFileSync('glab', ['mr', 'view', String(manifest.pr_number), '--output', 'json'], {
+            encoding: 'utf-8',
+            stdio: 'pipe',
+        });
+        const mr = JSON.parse(output);
+        return mr.state ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export function isGitlabAvailable() {
+    try {
+        execFileSync('glab', ['auth', 'status'], { encoding: 'utf-8', stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function listTaskBranches(repoRoot, runId, taskIds) {
+    const execOpts = { cwd: repoRoot, encoding: 'utf-8', stdio: 'pipe' };
+    let output;
+    try {
+        output = execFileSync('git', ['branch', '--list'], execOpts);
+    }
+    catch {
+        return [];
+    }
+    const eligibleTaskIds = new Set(taskIds ?? []);
+    return output
+        .trim()
+        .split('\n')
+        .map((line) => line.trim().replace(/^[*+]\s*/, ''))
+        .filter((branch) => branch !== '')
+        .filter((branch) => branch.includes(`-${runId}-`) || branch.startsWith(`stw/${runId}-`) || branch.startsWith(`ai/${runId}-`))
+        .filter((branch) => {
+        if (eligibleTaskIds.size === 0) {
+            return parseTaskIdFromBranch(branch) !== null;
+        }
+        return branchBelongsToRun(branch, runId, eligibleTaskIds);
+    });
+}
+export function deleteTaskBranches(repoRoot, runId, opts) {
+    const branches = listTaskBranches(repoRoot, runId, opts?.taskIds);
+    if (opts?.dryRun)
+        return branches;
+    const execOpts = { cwd: repoRoot, encoding: 'utf-8', stdio: 'pipe' };
+    for (const branch of branches) {
+        try {
+            execFileSync('git', ['branch', '-D', branch], execOpts);
+        }
+        catch {
+            // branch may already be gone
+        }
+    }
+    return branches;
+}
+export function cleanupRunArtifacts(stwRoot, runId, opts) {
+    const deleted = [];
+    const runPath = runDir(stwRoot, runId);
+    const runLevelLogs = join(runPath, 'logs.ndjson');
+    if (existsSync(runLevelLogs)) {
+        deleted.push('logs.ndjson');
+        if (!opts?.dryRun)
+            unlinkSync(runLevelLogs);
+    }
+    const tasksPath = join(runPath, 'tasks');
+    if (!existsSync(tasksPath))
+        return deleted;
+    for (const taskId of getEligibleTaskIds(stwRoot, runId)) {
+        const taskPath = join(tasksPath, taskId);
+        for (const artifact of DELETABLE_ARTIFACTS) {
+            const artifactPath = join(taskPath, artifact);
+            if (existsSync(artifactPath)) {
+                deleted.push(`tasks/${taskId}/${artifact}`);
+                if (!opts?.dryRun)
+                    unlinkSync(artifactPath);
+            }
+        }
+        const checkpointsDir = join(taskPath, 'checkpoints');
+        if (existsSync(checkpointsDir)) {
+            deleted.push(`tasks/${taskId}/checkpoints/`);
+            if (!opts?.dryRun)
+                rmSync(checkpointsDir, { recursive: true });
+        }
+    }
+    return deleted;
+}
+export function cleanupRun(stwRoot, repoRoot, runId, opts) {
+    const eligibility = checkRunEligibility(stwRoot, runId, {
+        gitlabAvailable: opts.gitlabAvailable,
+        force: opts.force,
+    });
+    if (!eligibility.eligible) {
+        return {
+            runId,
+            worktreesPruned: 0,
+            branchesDeleted: [],
+            artifactsDeleted: [],
+            skipped: true,
+            skipReason: eligibility.reason,
+        };
+    }
+    if (!opts.dryRun) {
+        const lockResult = acquireLock(stwRoot, runId);
+        if (!lockResult.acquired) {
+            return {
+                runId,
+                worktreesPruned: 0,
+                branchesDeleted: [],
+                artifactsDeleted: [],
+                skipped: true,
+                skipReason: `Could not acquire lock (held by PID ${lockResult.existingLock?.data.pid})`,
+            };
+        }
+    }
+    try {
+        const taskIds = [...getRunTaskIds(stwRoot, runId)];
+        const preservedPaths = new Set();
+        for (const taskId of taskIds) {
+            const status = readTaskStatus(stwRoot, runId, taskId);
+            for (const path of getPreservedWorktreePaths(status)) {
+                preservedPaths.add(path);
+            }
+        }
+        const worktrees = cleanupRunWorktrees(repoRoot, runId, {
+            dryRun: opts.dryRun,
+            preservedPaths: [...preservedPaths],
+            taskIds,
+        });
+        const branches = deleteTaskBranches(repoRoot, runId, { dryRun: opts.dryRun, taskIds });
+        const artifacts = opts.artifacts ? cleanupRunArtifacts(stwRoot, runId, { dryRun: opts.dryRun }) : [];
+        return {
+            runId,
+            worktreesPruned: worktrees.length,
+            branchesDeleted: branches,
+            artifactsDeleted: artifacts,
+            skipped: false,
+        };
+    }
+    finally {
+        if (!opts.dryRun) {
+            releaseLock(stwRoot);
+        }
+    }
+}
+export function listEligibleRuns(stwRoot) {
+    const runsPath = join(stwRoot, 'runs');
+    if (!existsSync(runsPath))
+        return [];
+    return readdirSync(runsPath).filter((runId) => {
+        const manifestPath = join(runsPath, runId, 'manifest.json');
+        if (!fileExists(manifestPath))
+            return false;
+        const manifest = readJson(manifestPath);
+        return ['complete', 'failed', 'stopped'].includes(manifest.status);
+    });
+}
+export function listStaleRuns(stwRoot, maxAgeDays = 7) {
+    const runsPath = join(stwRoot, 'runs');
+    if (!existsSync(runsPath))
+        return [];
+    const cutoffMs = Date.now() - maxAgeDays * 24 * 60 * 60 * 1000;
+    return readdirSync(runsPath).filter((runId) => {
+        const manifestPath = join(runsPath, runId, 'manifest.json');
+        if (!fileExists(manifestPath))
+            return false;
+        const manifest = readJson(manifestPath);
+        if (!manifest.created_at)
+            return false;
+        const createdAt = new Date(manifest.created_at).getTime();
+        return createdAt < cutoffMs;
+    });
+}
+//# sourceMappingURL=worktree-cleanup.js.map

package/dist/worktree-cleanup.js.map

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

package/dist/worktree.d.ts

@@ -0,0 +1,22 @@
+import type { SeedFileEntry } from './types.js';
+export interface CreateWorktreeResult {
+    worktreePath: string;
+    taskBranch: string;
+}
+export interface CreateWorktreeOptions {
+    repoRoot: string;
+    runBranch: string;
+    taskId: string;
+    worktreeBase?: string;
+    preserveExisting?: boolean;
+    emptyWorktree?: boolean;
+    seedDir?: string;
+}
+export declare function listSeedFiles(seedDir: string, maxFiles?: number): {
+    files: SeedFileEntry[];
+    totalCount: number;
+};
+export declare function validateSeedDir(seedDir: string): void;
+export declare function createWorktree(options: CreateWorktreeOptions): CreateWorktreeResult;
+export declare function cleanupWorktree(worktreePath: string, repoRoot?: string): void;
+export declare function isWorktreeDirty(worktreePath: string): boolean;

package/dist/worktree.js

@@ -0,0 +1,213 @@
+import { execFileSync } from 'node:child_process';
+import { join, relative, extname, basename } from 'node:path';
+import { readdirSync, statSync, copyFileSync, mkdirSync, existsSync, lstatSync } from 'node:fs';
+const MAX_SEED_DIR_BYTES = 50 * 1024 * 1024; // 50MB
+const TEXT_EXTENSIONS = new Set([
+    '.ts',
+    '.js',
+    '.json',
+    '.md',
+    '.txt',
+    '.csv',
+    '.yml',
+    '.yaml',
+    '.toml',
+    '.xml',
+    '.html',
+    '.css',
+    '.py',
+    '.go',
+    '.rs',
+    '.java',
+    '.sh',
+    '.sql',
+    '.env',
+    '.cfg',
+    '.ini',
+    '.jsx',
+    '.tsx',
+    '.vue',
+    '.svelte',
+    '.rb',
+    '.php',
+    '.c',
+    '.h',
+    '.cpp',
+    '.hpp',
+    '.swift',
+    '.kt',
+    '.r',
+    '.ipynb',
+    '.lock',
+    '.gitignore',
+    '.editorconfig',
+    '.prettierrc',
+    '.eslintrc',
+    '.dockerfile',
+    '.makefile',
+]);
+function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+function isTextFile(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    const name = basename(filePath).toLowerCase();
+    // Files with no extension but known names
+    if (!ext && ['makefile', 'dockerfile', 'license', 'readme', 'changelog'].includes(name))
+        return true;
+    return TEXT_EXTENSIONS.has(ext);
+}
+export function listSeedFiles(seedDir, maxFiles = 50) {
+    const all = [];
+    function walk(dir) {
+        const items = readdirSync(dir, { withFileTypes: true });
+        for (const item of items) {
+            if (item.name === '.git')
+                continue;
+            const fullPath = join(dir, item.name);
+            if (item.isDirectory()) {
+                walk(fullPath);
+            }
+            else if (item.isFile()) {
+                const stat = statSync(fullPath);
+                all.push({
+                    relativePath: relative(seedDir, fullPath),
+                    absolutePath: fullPath,
+                    sizeBytes: stat.size,
+                    sizeHuman: formatSize(stat.size),
+                    isBinary: !isTextFile(fullPath),
+                });
+            }
+        }
+    }
+    walk(seedDir);
+    return { files: all.slice(0, maxFiles), totalCount: all.length };
+}
+export function validateSeedDir(seedDir) {
+    if (!existsSync(seedDir)) {
+        throw new Error(`Seed directory does not exist: ${seedDir}`);
+    }
+    const stat = lstatSync(seedDir);
+    if (!stat.isDirectory()) {
+        throw new Error(`--from path must be a directory, not a file: ${seedDir}`);
+    }
+    const totalBytes = computeDirSize(seedDir);
+    if (totalBytes > MAX_SEED_DIR_BYTES) {
+        throw new Error(`Seed directory exceeds 50MB limit (${formatSize(totalBytes)}). Reduce the directory size or remove large files.`);
+    }
+}
+function computeDirSize(dir) {
+    let total = 0;
+    const items = readdirSync(dir, { withFileTypes: true });
+    for (const item of items) {
+        if (item.name === '.git')
+            continue;
+        const fullPath = join(dir, item.name);
+        if (item.isDirectory()) {
+            total += computeDirSize(fullPath);
+        }
+        else if (item.isFile()) {
+            total += statSync(fullPath).size;
+        }
+    }
+    return total;
+}
+export function createWorktree(options) {
+    const { repoRoot, runBranch, taskId, worktreeBase = '/tmp', preserveExisting = false, emptyWorktree = false, seedDir, } = options;
+    const taskBranch = `${runBranch}-${taskId}`;
+    const worktreePath = join(worktreeBase, `stw-worktree-${taskId}`);
+    if (preserveExisting) {
+        const opts = {
+            cwd: worktreePath,
+            encoding: 'utf-8',
+            stdio: 'pipe',
+        };
+        try {
+            const branch = execFileSync('git', ['branch', '--show-current'], opts).trim();
+            if (branch === taskBranch) {
+                return { worktreePath, taskBranch };
+            }
+        }
+        catch {
+            // Fall through to normal worktree creation.
+        }
+    }
+    const runOpts = {
+        cwd: repoRoot,
+        encoding: 'utf-8',
+        stdio: 'pipe',
+    };
+    execFileSync('git', ['worktree', 'prune'], runOpts);
+    try {
+        execFileSync('git', ['worktree', 'remove', worktreePath, '--force'], runOpts);
+    }
+    catch {
+        // Worktree doesn't exist or is already gone.
+    }
+    try {
+        execFileSync('git', ['branch', '-D', taskBranch], runOpts);
+    }
+    catch {
+        // Branch doesn't exist - expected on first run.
+    }
+    execFileSync('git', ['worktree', 'add', worktreePath, '-b', taskBranch, runBranch], runOpts);
+    if (emptyWorktree) {
+        const worktreeOpts = {
+            cwd: worktreePath,
+            encoding: 'utf-8',
+            stdio: 'pipe',
+        };
+        execFileSync('git', ['rm', '-rf', '.', '--ignore-unmatch'], worktreeOpts);
+        execFileSync('git', ['commit', '--allow-empty', '-m', 'Empty worktree for greenfield scaffolding'], worktreeOpts);
+    }
+    if (seedDir) {
+        validateSeedDir(seedDir);
+        seedWorktree(worktreePath, seedDir);
+    }
+    return { worktreePath, taskBranch };
+}
+function seedWorktree(worktreePath, seedDir) {
+    const { files } = listSeedFiles(seedDir, Infinity);
+    const worktreeOpts = {
+        cwd: worktreePath,
+        encoding: 'utf-8',
+        stdio: 'pipe',
+    };
+    for (const file of files) {
+        const destPath = join(worktreePath, file.relativePath);
+        const destDir = join(destPath, '..');
+        if (!existsSync(destDir)) {
+            mkdirSync(destDir, { recursive: true });
+        }
+        copyFileSync(file.absolutePath, destPath);
+    }
+    execFileSync('git', ['add', '-A'], worktreeOpts);
+    execFileSync('git', ['commit', '--allow-empty', '-m', `Seed from ${seedDir}`], worktreeOpts);
+}
+export function cleanupWorktree(worktreePath, repoRoot) {
+    const opts = {
+        cwd: repoRoot,
+        encoding: 'utf-8',
+        stdio: 'pipe',
+    };
+    execFileSync('git', ['worktree', 'remove', worktreePath, '--force'], opts);
+}
+export function isWorktreeDirty(worktreePath) {
+    const opts = {
+        cwd: worktreePath,
+        encoding: 'utf-8',
+        stdio: 'pipe',
+    };
+    try {
+        const output = execFileSync('git', ['status', '--porcelain'], opts);
+        return output.trim().length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=worktree.js.map

package/dist/worktree.js.map

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

package/examples/spec.md

@@ -0,0 +1,58 @@
+# Spec: Add rate limiting to API endpoints
+
+## Objective
+
+Add configurable rate limiting to all public API endpoints to prevent abuse
+and ensure fair usage across clients.
+
+## Context
+
+The API currently has no rate limiting. Under load testing, a single client
+can monopolize server resources. The team agreed to add in-memory rate
+limiting as a first step before moving to Redis-backed limits later.
+
+## Requirements
+
+### T1: Rate limiter middleware
+
+Create a rate limiting middleware in `src/middleware/rate-limit.ts`.
+
+- Accept `requestsPerMinute` and `burstSize` as constructor parameters
+- Use a sliding window algorithm (not fixed window)
+- Return HTTP 429 with a `Retry-After` header when the limit is exceeded
+- Track limits per client IP (`req.ip`)
+
+### T2: Apply middleware to routes
+
+Wire the rate limiter into `src/routes/api.ts` for all `/api/v1/*` endpoints.
+
+- Default: 60 requests/minute, burst of 10
+- Make limits configurable via `RATE_LIMIT_RPM` and `RATE_LIMIT_BURST` env vars
+- Add a `/api/v1/health` endpoint that is exempt from rate limiting
+
+### T3: Unit tests for rate limiter
+
+Add tests in `tests/rate-limit.test.ts`:
+
+- Allows requests under the limit
+- Blocks requests over the limit with 429
+- Resets the window after the configured interval
+- Respects burst allowance
+
+## Constraints
+
+- No external dependencies — use an in-memory store (Map with timestamps)
+- Must not break existing tests (`npm test` must pass)
+- Keep middleware stateless across server restarts (no persistence needed)
+
+## Acceptance Criteria
+
+- `npm test` passes with new and existing tests
+- `npx tsc --noEmit` passes
+- Rate limiter returns 429 with correct `Retry-After` header
+- Middleware is applied to all `/api/v1/*` routes except health check
+
+## Risk Assessment
+
+- **Low risk**: This is additive — no existing behavior changes
+- T1 and T3 can run in parallel; T2 depends on T1