@mknightzzz/stw 0.1.0

package/dist/commands/helpers.js

@@ -0,0 +1,231 @@
+import { resolve, isAbsolute, relative, dirname, join } from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { execFileSync } from 'node:child_process';
+import { validateSpec } from '../spec-validator.js';
+import { createRun } from '../run.js';
+import { loadConfig } from '../config.js';
+import { validateTaskGraph } from '../task-graph.js';
+import { generateAssignments } from '../assignments.js';
+import { renderInboxes } from '../inbox-renderer.js';
+import { ensureDir, fileExists, readJson, writeAtomic, writeJson, runDir } from '../storage.js';
+export function getStwRoot() {
+    return resolve('.stw');
+}
+export function delay(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+export const LOG_LEVELS = ['debug', 'info', 'warn', 'error'];
+export function getDefaultAgents() {
+    return [
+        { agent_id: 'agent-strong-1', tool: 'claude-code', model: 'opus-4.6', tier: 'strong' },
+        { agent_id: 'agent-medium-1', tool: 'opencode', model: 'gpt-5.4', tier: 'medium' },
+        { agent_id: 'agent-cheap-1', tool: 'opencode', model: 'minimax-2.5', tier: 'cheap' },
+    ];
+}
+export function setupRunArtifacts(options) {
+    const graphPath = join(runDir(options.stwRoot, options.runId), 'task_graph.json');
+    if (!existsSync(graphPath)) {
+        return {
+            graph: null,
+            assignmentsWritten: false,
+            inboxesWritten: 0,
+            warnings: [],
+        };
+    }
+    const graph = readJson(graphPath);
+    const graphValidation = validateTaskGraph(graph);
+    if (!graphValidation.valid) {
+        throw new Error(`Task graph validation failed: ${graphValidation.errors.join('; ')}`);
+    }
+    const config = loadConfig(join(options.stwRoot, 'config.yml'));
+    const agents = options.agents ?? getDefaultAgents();
+    const assignmentResult = generateAssignments(graph, agents, config);
+    writeJson(join(runDir(options.stwRoot, options.runId), 'assignments.json'), assignmentResult.assignments);
+    const inboxes = renderInboxes(assignmentResult.assignments, graph);
+    const inboxDir = join(runDir(options.stwRoot, options.runId), 'inboxes');
+    ensureDir(inboxDir);
+    for (const [agentId, content] of Object.entries(inboxes)) {
+        writeAtomic(join(inboxDir, `${agentId}.md`), content);
+    }
+    return {
+        graph,
+        assignmentsWritten: true,
+        inboxesWritten: Object.keys(inboxes).length,
+        warnings: [...graphValidation.warnings, ...assignmentResult.warnings],
+    };
+}
+export function ingestRunFromContext(options) {
+    const config = loadConfig(join(options.stwRoot, 'config.yml'));
+    const specResolution = resolveSpecPathFromContext({
+        repoRoot: options.repoRoot,
+        noteBody: options.noteBody,
+        notePath: options.notePath,
+        fallbackSpecPath: options.fallbackSpecPath,
+    });
+    if (!specResolution.ok) {
+        return {
+            ok: false,
+            message: specResolution.message,
+            details: specResolution.details,
+        };
+    }
+    let markdown;
+    try {
+        markdown = readFileSync(specResolution.absolutePath, 'utf-8');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            ok: false,
+            message: `Failed to read spec: ${specResolution.displayPath}`,
+            details: [message],
+        };
+    }
+    const validation = validateSpec(markdown);
+    if (!validation.valid) {
+        return {
+            ok: false,
+            message: `Spec validation failed for ${specResolution.displayPath}`,
+            details: validation.errors,
+        };
+    }
+    const specStartedAt = new Date().toISOString();
+    const manifest = createRun({
+        stwRoot: options.stwRoot,
+        specPath: specResolution.repoRelativePath,
+        repoRoot: options.repoRoot,
+        baseBranch: options.baseBranch ?? config.gitlab?.base_branch ?? 'main',
+        branchPrefix: config.gitlab?.branch_prefix ?? 'ai/',
+        greenfield: options.greenfield,
+        seedDir: options.seedDir,
+    });
+    // Record spec timing in manifest
+    const manifestPath = join(runDir(options.stwRoot, manifest.run_id), 'manifest.json');
+    if (fileExists(manifestPath)) {
+        const savedManifest = readJson(manifestPath);
+        savedManifest.spec_started_at = specStartedAt;
+        savedManifest.spec_completed_at = new Date().toISOString();
+        writeJson(manifestPath, savedManifest);
+    }
+    let setupSummary = 'No task graph found yet; run created only.';
+    const details = [`Spec: ${specResolution.repoRelativePath}`, `Branch: ${manifest.branch}`];
+    if (validation.warnings.length > 0) {
+        details.push(...validation.warnings.map((warning) => `Spec warning: ${warning}`));
+    }
+    try {
+        const setupResult = setupRunArtifacts({
+            stwRoot: options.stwRoot,
+            runId: manifest.run_id,
+            repoRoot: options.repoRoot,
+        });
+        if (setupResult.graph) {
+            setupSummary = `Assignments written; inboxes generated: ${setupResult.inboxesWritten}.`;
+            for (const warning of setupResult.warnings) {
+                details.push(`Setup warning: ${warning}`);
+            }
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        setupSummary = `Run created, but setup bootstrap was incomplete: ${message}`;
+    }
+    details.push(setupSummary);
+    return {
+        ok: true,
+        manifest,
+        message: `Run created: ${manifest.run_id}`,
+        details,
+    };
+}
+function resolveSpecPathFromContext(options) {
+    const candidates = collectSpecCandidates(options.noteBody, options.fallbackSpecPath);
+    if (options.notePath) {
+        const noteDir = dirname(options.notePath);
+        for (const candidate of candidates) {
+            const maybeAbsolute = isAbsolute(candidate) ? candidate : resolve(noteDir, candidate);
+            if (existsSync(maybeAbsolute)) {
+                const repoRelativePath = relative(options.repoRoot, maybeAbsolute).replaceAll('\\', '/');
+                return {
+                    ok: true,
+                    absolutePath: maybeAbsolute,
+                    repoRelativePath,
+                    displayPath: repoRelativePath,
+                };
+            }
+        }
+    }
+    for (const candidate of candidates) {
+        const maybeAbsolute = isAbsolute(candidate) ? candidate : resolve(options.repoRoot, candidate);
+        if (existsSync(maybeAbsolute)) {
+            const repoRelativePath = relative(options.repoRoot, maybeAbsolute).replaceAll('\\', '/');
+            return {
+                ok: true,
+                absolutePath: maybeAbsolute,
+                repoRelativePath,
+                displayPath: repoRelativePath,
+            };
+        }
+    }
+    if (candidates.length === 0) {
+        return {
+            ok: false,
+            message: 'No spec path found in /ingest command or note context.',
+            details: ['Provide `/ingest path/to/spec.md` or include a repo-relative spec path in the note.'],
+        };
+    }
+    return {
+        ok: false,
+        message: `Spec path not found: ${candidates[0]}`,
+        details: candidates.slice(1).map((candidate) => `Also tried: ${candidate}`),
+    };
+}
+function collectSpecCandidates(noteBody, fallbackSpecPath) {
+    const values = [];
+    if (fallbackSpecPath?.trim()) {
+        values.push(fallbackSpecPath.trim());
+    }
+    if (noteBody) {
+        const commandMatch = noteBody.match(/(?:^|\s)\/ingest\s+([^\s]+)/i);
+        if (commandMatch?.[1]) {
+            values.push(commandMatch[1].trim());
+        }
+        const markdownMatches = noteBody.matchAll(/`([^`]+\.md)`/g);
+        for (const match of markdownMatches) {
+            values.push(match[1].trim());
+        }
+        const pathMatches = noteBody.matchAll(/(?:^|\s)([A-Za-z0-9_./-]+\.md)(?=$|\s)/g);
+        for (const match of pathMatches) {
+            values.push(match[1].trim());
+        }
+    }
+    const unique = new Set();
+    const normalized = [];
+    for (const value of values) {
+        if (!value || unique.has(value))
+            continue;
+        unique.add(value);
+        normalized.push(value);
+    }
+    return normalized;
+}
+export function findCurrentGitBranch(repoRoot) {
+    try {
+        return execFileSync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], {
+            cwd: repoRoot,
+            encoding: 'utf-8',
+            stdio: 'pipe',
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+export function getRepoRootFromCwd() {
+    return resolve('.');
+}
+export function getFixturesConfigPath() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    return resolve(here, '../../fixtures/config.yml');
+}
+//# sourceMappingURL=helpers.js.map

package/dist/commands/helpers.js.map

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

package/dist/commands/idea.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerIdeaCommand(program: Command): void;

package/dist/commands/idea.js

@@ -0,0 +1,89 @@
+import { join, resolve } from 'node:path';
+import { generateSpec, slugify, KNOWN_STACK_PRESETS, ClarityGateError } from '../idea.js';
+import { loadConfig } from '../config.js';
+import { writeAtomic } from '../storage.js';
+import { validateSeedDir } from '../worktree.js';
+export function registerIdeaCommand(program) {
+    program
+        .command('idea')
+        .description('Generate a spec from a rough idea using a strong-tier model')
+        .argument('<description>', 'The rough idea in natural language')
+        .option('--template <name>', 'Template override (bugfix, feature, refactor, cleanup, greenfield)')
+        .option('--greenfield', 'Generate a spec for a brand-new project (no existing codebase)')
+        .option('--stack <preset>', `Stack preset (${KNOWN_STACK_PRESETS.join(', ')}). Implies --greenfield.`)
+        .option('--from <dir>', 'Seed greenfield worktree from a local directory. Implies --greenfield.')
+        .option('--no-clarity-check', 'Skip the idea clarity check (for power users)')
+        .option('--output <path>', 'Output path for generated spec')
+        .action(async (description, opts) => {
+        if (opts.stack && !KNOWN_STACK_PRESETS.includes(opts.stack)) {
+            console.error(`Unknown stack preset "${opts.stack}". Available: ${KNOWN_STACK_PRESETS.join(', ')}`);
+            process.exit(1);
+        }
+        const seedDir = opts.from ? resolve(opts.from) : undefined;
+        if (seedDir) {
+            try {
+                validateSeedDir(seedDir);
+            }
+            catch (err) {
+                console.error(err instanceof Error ? err.message : String(err));
+                process.exit(1);
+            }
+        }
+        const isGreenfield = opts.greenfield || !!opts.stack || !!seedDir;
+        const stwRoot = join(process.cwd(), '.stw');
+        const config = loadConfig(join(stwRoot, 'config.yml'));
+        const outputPath = opts.output ?? join('specs', `${slugify(description)}.md`);
+        console.log(`Generating spec from idea: "${description}"`);
+        if (isGreenfield) {
+            console.log(`Mode: greenfield (no existing codebase)`);
+        }
+        else if (opts.template) {
+            console.log(`Using template: ${opts.template}`);
+        }
+        if (opts.stack) {
+            console.log(`Stack: ${opts.stack}`);
+        }
+        if (seedDir) {
+            console.log(`Seed directory: ${seedDir}`);
+        }
+        let result;
+        try {
+            result = await generateSpec({
+                idea: description,
+                repoRoot: process.cwd(),
+                config,
+                templateOverride: opts.template,
+                isGreenfield,
+                stack: opts.stack,
+                seedDir,
+                skipClarityCheck: opts.clarityCheck === false,
+            });
+        }
+        catch (err) {
+            if (err instanceof ClarityGateError) {
+                console.error(`\nIdea rejected — not specific enough to generate a spec.\n`);
+                console.error(`Feedback: ${err.feedback}`);
+                if (err.suggestedIdea) {
+                    console.error(`\nYou can use this as a starting point:\n  "${err.suggestedIdea}"`);
+                }
+                process.exit(1);
+            }
+            throw err;
+        }
+        writeAtomic(outputPath, result.spec);
+        console.log(`\nSpec generated successfully!`);
+        console.log(`  Template: ${result.templateUsed}`);
+        console.log(`  Output:   ${outputPath}`);
+        if (result.model) {
+            console.log(`  Model:    ${result.model}`);
+        }
+        if (result.usage) {
+            console.log(`  Tokens:   ${result.usage.input_tokens} in / ${result.usage.output_tokens} out`);
+        }
+        if (result.latency_ms) {
+            console.log(`  Latency:  ${(result.latency_ms / 1000).toFixed(1)}s`);
+        }
+        console.log(`\nReview the spec, then run: stw ingest ${outputPath}`);
+    });
+}
+//# sourceMappingURL=idea.js.map

package/dist/commands/idea.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerInitCommand(program: Command): void;

package/dist/commands/init.js

@@ -0,0 +1,94 @@
+import { existsSync } from 'node:fs';
+import { resolve, join } from 'node:path';
+import * as yaml from 'js-yaml';
+import { detectRepo, generateConfig, detectBackends } from '../init.js';
+import { writeAtomic, ensureDir } from '../storage.js';
+import { runDoctor } from '../doctor.js';
+export function registerInitCommand(program) {
+    program
+        .command('init')
+        .description('Initialize a repository for STW orchestration')
+        .option('--force', 'Overwrite existing config')
+        .option('--provider <provider>', 'Provider name (default: openrouter)')
+        .option('--backend <backend>', 'Agentic backend (default: opencode)')
+        .option('--max-run-usd <amount>', 'Max budget per run in USD', parseFloat)
+        .option('--preset <preset>', 'Model preset: glm5 (budget), minimax (balanced), anthropic (premium), mixed (multi-provider) (default: minimax)')
+        .action((opts) => {
+        const repoRoot = resolve('.');
+        if (!existsSync(join(repoRoot, '.git'))) {
+            console.error('Error: Not a git repository. Run "git init" first.');
+            process.exit(1);
+        }
+        const configPath = join(repoRoot, '.stw', 'config.yml');
+        if (existsSync(configPath) && !opts.force) {
+            console.error('Error: .stw/config.yml already exists. Use --force to overwrite.');
+            process.exit(1);
+        }
+        const backends = detectBackends();
+        const availableBackends = [];
+        if (backends.opencode)
+            availableBackends.push('opencode');
+        if (backends.claude)
+            availableBackends.push('claude');
+        console.log(`Detected backends: ${availableBackends.length > 0 ? availableBackends.join(', ') : 'none'}`);
+        let backend = opts.backend;
+        if (!backend && backends.claude) {
+            backend = 'claude-code';
+            console.log('Defaulting to claude-code backend (claude detected)');
+        }
+        const profile = detectRepo(repoRoot);
+        console.log(`Detected repo type: ${profile.type}`);
+        if (profile.detectedFiles.length > 0) {
+            console.log(`  Files: ${profile.detectedFiles.join(', ')}`);
+        }
+        if (profile.testCommand) {
+            console.log(`  Test command: ${profile.testCommand}`);
+        }
+        if (profile.lintCommand) {
+            console.log(`  Lint command: ${profile.lintCommand}`);
+        }
+        const preset = opts.preset;
+        const config = generateConfig(repoRoot, {
+            provider: opts.provider,
+            backend,
+            maxRunUsd: opts.maxRunUsd,
+            preset,
+        });
+        ensureDir(join(repoRoot, '.stw'));
+        const yamlContent = yaml.dump(config, { lineWidth: 120, noRefs: true });
+        writeAtomic(configPath, yamlContent);
+        console.log(`\nConfig written to: ${configPath}`);
+        // Post-init: run doctor to show readiness
+        console.log('\nRunning readiness checks...\n');
+        const doctorChecks = runDoctor({ repoRoot, stwRoot: join(repoRoot, '.stw') });
+        const failed = doctorChecks.filter((c) => !c.passed);
+        const passed = doctorChecks.filter((c) => c.passed);
+        for (const check of passed) {
+            console.log(`  ✓ ${check.message}`);
+        }
+        for (const check of failed) {
+            console.log(`  ✗ ${check.message}`);
+        }
+        if (failed.length === 0) {
+            console.log("\nAll checks passed! You're ready to go.");
+        }
+        else {
+            console.log(`\n${failed.length} issue(s) to fix before running stw.`);
+        }
+        // Show next steps based on what's missing
+        const apiKeyMissing = failed.some((c) => c.name.startsWith('api-key-'));
+        const steps = [];
+        if (apiKeyMissing) {
+            const envVar = Object.values(config.providers)[0]?.api_key_env ?? 'OPENROUTER_API_KEY';
+            steps.push(`Set your API key: export ${envVar}=your-key`);
+        }
+        steps.push('Verify readiness: stw doctor');
+        steps.push('Run from an idea: stw go "add a health check endpoint"');
+        steps.push('Or write a spec first: stw idea "add rate limiting" → edit → stw go "rate limiting" --spec specs/add-rate-limiting.md');
+        console.log('\nNext steps:');
+        for (let i = 0; i < steps.length; i++) {
+            console.log(`  ${i + 1}. ${steps[i]}`);
+        }
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAmB,MAAM,YAAY,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,+CAA+C,CAAC;SAC5D,MAAM,CAAC,SAAS,EAAE,2BAA2B,CAAC;SAC9C,MAAM,CAAC,uBAAuB,EAAE,qCAAqC,CAAC;SACtE,MAAM,CAAC,qBAAqB,EAAE,qCAAqC,CAAC;SACpE,MAAM,CAAC,wBAAwB,EAAE,2BAA2B,EAAE,UAAU,CAAC;SACzE,MAAM,CACL,mBAAmB,EACnB,iHAAiH,CAClH;SACA,MAAM,CAAC,CAAC,IAAmG,EAAE,EAAE;QAC9G,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAE9B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YACxC,OAAO,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;QACxD,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAC1C,OAAO,CAAC,KAAK,CAAC,kEAAkE,CAAC,CAAC;YAClF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;QAClC,MAAM,iBAAiB,GAAa,EAAE,CAAC;QACvC,IAAI,QAAQ,CAAC,QAAQ;YAAE,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1D,IAAI,QAAQ,CAAC,MAAM;YAAE,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,sBAAsB,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAE1G,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC3B,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YAChC,OAAO,GAAG,aAAa,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,uBAAuB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACnD,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,mBAAmB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,mBAAmB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAgC,CAAC;QACrD,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,EAAE;YACtC,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO;YACP,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM;SACP,CAAC,CAAC;QAEH,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;QAClC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACxE,WAAW,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,wBAAwB,UAAU,EAAE,CAAC,CAAC;QAElD,0CAA0C;QAC1C,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;QAC/C,MAAM,YAAY,GAAG,SAAS,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAC9E,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAEpD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,MAAM,sCAAsC,CAAC,CAAC;QACxE,CAAC;QAED,0CAA0C;QAC1C,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;QACxE,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,IAAI,oBAAoB,CAAC;YACvF,KAAK,CAAC,IAAI,CAAC,4BAA4B,MAAM,WAAW,CAAC,CAAC;QAC5D,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;QACrE,KAAK,CAAC,IAAI,CACR,uHAAuH,CACxH,CAAC;QAEF,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/integration.d.ts

@@ -0,0 +1,7 @@
+import type { Command } from 'commander';
+export declare function pollRunComments(options: {
+    runId: string;
+    stwRoot: string;
+    watch?: boolean;
+}): Promise<void>;
+export declare function registerIntegrationCommands(program: Command): void;

package/dist/commands/integration.js

@@ -0,0 +1,139 @@
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { loadConfig } from '../config.js';
+import { readTaskStatus } from '../status.js';
+import { readJson, writeJson, fileExists, runDir } from '../storage.js';
+import { loadCosts } from '../cost.js';
+import { pollAndDispatch } from '../poller.js';
+import { syncRunToGitlab } from '../run-sync.js';
+import { getStwRoot, delay } from './helpers.js';
+function buildTaskStates(stwRoot, runId) {
+    const graphPath = join(runDir(stwRoot, runId), 'task_graph.json');
+    if (!fileExists(graphPath)) {
+        return undefined;
+    }
+    const graph = readJson(graphPath);
+    const taskStates = {};
+    for (const task of graph.tasks) {
+        const status = readTaskStatus(stwRoot, runId, task.id);
+        taskStates[task.id] = status?.status ?? task.state;
+    }
+    return taskStates;
+}
+export async function pollRunComments(options) {
+    const manifestPath = join(runDir(options.stwRoot, options.runId), 'manifest.json');
+    if (!fileExists(manifestPath)) {
+        console.error(`Run not found: ${options.runId}`);
+        process.exit(1);
+    }
+    const config = loadConfig(join(options.stwRoot, 'config.yml'));
+    const allowedUsers = config.gitlab?.allowed_command_users ?? [];
+    const pollIntervalMs = Math.max(1, config.defaults.poll_interval_seconds) * 1000;
+    const commandsFilePath = join(runDir(options.stwRoot, options.runId), 'commands.ndjson');
+    const stopSentinelPath = join(runDir(options.stwRoot, options.runId), 'STOP_POLL');
+    while (true) {
+        const currentManifest = readJson(manifestPath);
+        if (!currentManifest.pr_number) {
+            console.error(`Run ${options.runId} has no merge request`);
+            process.exit(1);
+        }
+        const pollResult = await pollAndDispatch({
+            repoRoot: resolve('.'),
+            mrIid: currentManifest.pr_number,
+            since: currentManifest.created_at,
+            allowedUsers,
+            afterCommentId: currentManifest.last_polled_comment_id,
+            stwRoot: options.stwRoot,
+            runId: options.runId,
+            dispatchContext: {
+                commandsFilePath,
+                allowedUsers,
+                runId: options.runId,
+                stwRoot: options.stwRoot,
+                runState: currentManifest.status,
+                taskStates: buildTaskStates(options.stwRoot, options.runId),
+            },
+        });
+        for (const entry of pollResult.commands) {
+            console.log(`#${entry.noteId} ${entry.author}: /${entry.command.type}`);
+        }
+        for (const entry of pollResult.unauthorized) {
+            console.log(`#${entry.noteId} ${entry.author}: unauthorized /${entry.command.type}`);
+        }
+        if (pollResult.lastAppliedCommentId != null) {
+            const updatedManifest = readJson(manifestPath);
+            updatedManifest.last_polled_comment_id = pollResult.lastAppliedCommentId;
+            writeJson(manifestPath, updatedManifest);
+        }
+        if (!options.watch) {
+            break;
+        }
+        if (existsSync(stopSentinelPath)) {
+            break;
+        }
+        await delay(pollIntervalMs);
+    }
+}
+export function registerIntegrationCommands(program) {
+    program
+        .command('sync-gitlab <run-id>')
+        .description('Push run branch and sync MR state to GitLab')
+        .action(async (runId) => {
+        const stwRoot = getStwRoot();
+        const manifestPath = join(runDir(stwRoot, runId), 'manifest.json');
+        const manifest = readJson(manifestPath);
+        const graph = readJson(join(runDir(stwRoot, runId), 'task_graph.json'));
+        const config = loadConfig(join(stwRoot, 'config.yml'));
+        const costs = loadCosts(stwRoot, runId);
+        try {
+            syncRunToGitlab({ stwRoot, runId, config, manifest, manifestPath, graph, costs });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(`sync-gitlab failed: ${message}`);
+            process.exit(1);
+        }
+    });
+    program
+        .command('merge <run-id>')
+        .description('Push a run branch and create its GitLab merge request')
+        .action(async (runId) => {
+        const stwRoot = getStwRoot();
+        const { executeMergeForRun } = await import('../merge.js');
+        try {
+            const result = await executeMergeForRun({
+                stwRoot,
+                runId,
+                repoRoot: resolve('.'),
+            });
+            for (const line of result.messages) {
+                if (line.level === 'error') {
+                    console.error(line.text);
+                }
+                else {
+                    console.log(line.text);
+                }
+            }
+            if (!result.ok) {
+                process.exit(1);
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(`merge failed: ${message}`);
+            process.exit(1);
+        }
+    });
+    program
+        .command('poll <run-id>')
+        .description('Poll MR comments for slash commands')
+        .option('--watch', 'Continuously poll for new comments')
+        .action(async (runId, opts) => {
+        await pollRunComments({
+            runId,
+            stwRoot: getStwRoot(),
+            watch: opts.watch,
+        });
+    });
+}
+//# sourceMappingURL=integration.js.map

package/dist/commands/integration.js.map

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

package/dist/commands/maintenance.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerMaintenanceCommands(program: Command): void;