@radkode/neo 1.5.0 → 1.7.0

package/dist/commands/work/ship/index.js

@@ -0,0 +1,361 @@
+import { Command } from '@commander-js/extra-typings';
+import { execa } from 'execa';
+import { access, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { ui } from '../../../utils/ui.js';
+import { emitJson } from '../../../utils/output.js';
+import { runAction } from '../../../utils/run-action.js';
+import { getRuntimeContext } from '../../../utils/runtime-context.js';
+import { NonInteractiveError } from '../../../utils/prompt.js';
+import { GitErrors, isNotGitRepository, isAuthenticationError, isNetworkError, } from '../../../utils/git-errors.js';
+import { executeVerify } from '../../verify/index.js';
+import { executeChangeset } from '../../changeset/index.js';
+import { executeAiPr } from '../../ai/pr/index.js';
+import { isAICommitAvailable } from '../../../services/ai/index.js';
+async function pathExists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function detectDefaultBranch() {
+    try {
+        const { stdout } = await execa('git', ['symbolic-ref', 'refs/remotes/origin/HEAD']);
+        return stdout.replace('refs/remotes/origin/', '').trim();
+    }
+    catch {
+        for (const name of ['main', 'master']) {
+            try {
+                await execa('git', ['show-ref', '--verify', '--quiet', `refs/remotes/origin/${name}`]);
+                return name;
+            }
+            catch {
+                continue;
+            }
+        }
+        throw new Error('Could not detect default branch. Pass --base <name>, or run `git remote set-head origin --auto`.');
+    }
+}
+async function getCurrentBranch() {
+    const { stdout } = await execa('git', ['branch', '--show-current']);
+    return stdout.trim();
+}
+async function hasUncommittedChanges() {
+    const { stdout } = await execa('git', ['status', '--porcelain']);
+    return stdout.trim().length > 0;
+}
+async function countCommitsAhead(base) {
+    try {
+        const { stdout } = await execa('git', ['rev-list', '--count', `origin/${base}..HEAD`]);
+        return parseInt(stdout.trim(), 10) || 0;
+    }
+    catch {
+        return 0;
+    }
+}
+async function hasUpstream(branch) {
+    try {
+        await execa('git', ['rev-parse', '--abbrev-ref', `${branch}@{upstream}`], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function existingPrUrl() {
+    try {
+        const { stdout } = await execa('gh', ['pr', 'view', '--json', 'url', '-q', '.url'], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        const url = stdout.trim();
+        return url.length > 0 ? url : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function ghInstalled() {
+    try {
+        await execa('gh', ['--version'], { stdio: ['ignore', 'pipe', 'pipe'] });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function hasPendingChangeset(cwd) {
+    const dir = join(cwd, '.changeset');
+    if (!(await pathExists(dir)))
+        return null;
+    try {
+        const entries = await readdir(dir);
+        const match = entries.find((name) => name.endsWith('.md') && name.toLowerCase() !== 'readme.md');
+        return match ? join(dir, match) : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function getProjectRoot() {
+    const { stdout } = await execa('git', ['rev-parse', '--show-toplevel']);
+    return stdout.trim();
+}
+function inferPrTitle(branch, commits) {
+    const firstCommit = commits[0]?.trim();
+    if (firstCommit && firstCommit.length > 0)
+        return firstCommit;
+    const lastSegment = branch.split('/').pop() ?? branch;
+    return lastSegment.replace(/[-_]+/g, ' ');
+}
+async function getCommitSubjects(base) {
+    const { stdout } = await execa('git', [
+        'log',
+        `origin/${base}..HEAD`,
+        '--pretty=format:%s',
+        '--reverse',
+    ]);
+    return stdout.split('\n').filter((line) => line.trim().length > 0);
+}
+function inferPrBody(commits) {
+    const lines = ['## Summary'];
+    if (commits.length <= 3) {
+        for (const c of commits)
+            lines.push(`- ${c}`);
+    }
+    else {
+        for (const c of commits.slice(0, 3))
+            lines.push(`- ${c}`);
+        lines.push(`- ... and ${commits.length - 3} more commit(s)`);
+    }
+    lines.push('', '## Test plan', '- [ ] Verify locally');
+    return lines.join('\n');
+}
+export async function executeWorkShip(options) {
+    try {
+        await execa('git', ['rev-parse', '--is-inside-work-tree']);
+    }
+    catch (error) {
+        if (isNotGitRepository(error))
+            throw GitErrors.notARepository('work ship');
+        throw GitErrors.unknown('work ship', error);
+    }
+    const ctx = getRuntimeContext();
+    const cwd = await getProjectRoot();
+    const branch = await getCurrentBranch();
+    if (!branch) {
+        throw new Error('Detached HEAD — check out a branch before running `neo work ship`.');
+    }
+    const base = options.base ?? (await detectDefaultBranch());
+    if (branch === base) {
+        throw new Error(`Already on base branch "${base}" — start a feature branch with \`neo work start <name>\`.`);
+    }
+    if (await hasUncommittedChanges()) {
+        throw new Error('You have uncommitted changes. Commit them first (`neo git commit --ai`), then re-run.');
+    }
+    const fetchSpinner = ui.spinner(`Fetching origin/${base}`);
+    fetchSpinner.start();
+    try {
+        await execa('git', ['fetch', 'origin', base]);
+        fetchSpinner.succeed(`Fetched origin/${base}`);
+    }
+    catch (error) {
+        fetchSpinner.fail(`Fetch failed for origin/${base}`);
+        if (isAuthenticationError(error))
+            throw GitErrors.authenticationFailed('work ship');
+        if (isNetworkError(error))
+            throw GitErrors.networkError('work ship');
+        throw GitErrors.unknown('work ship', error);
+    }
+    const commitsAhead = await countCommitsAhead(base);
+    if (commitsAhead === 0) {
+        throw new Error(`Nothing to ship — ${branch} has no commits ahead of origin/${base}. Commit your changes first.`);
+    }
+    let verified = false;
+    let verifyDurationMs;
+    if (options.verify !== false) {
+        const vr = await executeVerify(cwd, {});
+        verifyDurationMs = vr.totalDurationMs;
+        if (!vr.ok) {
+            throw new Error('Verify failed — fix the failing scripts before shipping.');
+        }
+        verified = true;
+    }
+    let changesetPath;
+    let changesetExisting = false;
+    if (options.changeset !== false) {
+        const existing = await hasPendingChangeset(cwd);
+        if (existing) {
+            changesetPath = existing;
+            changesetExisting = true;
+            ui.muted(`Using existing changeset: ${existing}`);
+        }
+        else {
+            const cs = await executeChangeset(cwd, {
+                ...(options.bump !== undefined ? { bump: options.bump } : {}),
+                ...(options.summary !== undefined ? { summary: options.summary } : {}),
+                ...(options.package !== undefined ? { package: options.package } : {}),
+            });
+            changesetPath = cs.path;
+            await execa('git', ['add', cs.path]);
+            try {
+                await execa('git', ['commit', '--amend', '--no-edit', '-n']);
+            }
+            catch {
+                await execa('git', ['commit', '-n', '-m', 'chore: add changeset']);
+            }
+        }
+    }
+    let pushed = false;
+    const pushSpinner = ui.spinner(`Pushing ${branch} to origin`);
+    pushSpinner.start();
+    try {
+        const pushArgs = (await hasUpstream(branch))
+            ? ['push', '--force-with-lease', 'origin', branch]
+            : ['push', '-u', 'origin', branch];
+        await execa('git', pushArgs);
+        pushSpinner.succeed(`Pushed ${branch}`);
+        pushed = true;
+    }
+    catch (error) {
+        pushSpinner.fail('Push failed');
+        if (isAuthenticationError(error))
+            throw GitErrors.authenticationFailed('work ship');
+        if (isNetworkError(error))
+            throw GitErrors.networkError('work ship');
+        throw GitErrors.unknown('work ship', error);
+    }
+    let prUrl;
+    let prCreated = false;
+    if (!(await ghInstalled())) {
+        ui.warn('gh CLI not found — skipping PR creation. Install from https://cli.github.com.');
+    }
+    else {
+        const existing = await existingPrUrl();
+        if (existing) {
+            prUrl = existing;
+            ui.muted(`PR already exists: ${existing}`);
+        }
+        else {
+            const wantAiPr = options.aiPr !== false && (await isAICommitAvailable());
+            if (wantAiPr) {
+                if (ctx.nonInteractive && !ctx.yes) {
+                    throw new NonInteractiveError('PR creation needs confirmation (neo work ship)', '--yes (or --no-ai-pr to skip AI generation)');
+                }
+                const pr = await executeAiPr({
+                    base,
+                    create: true,
+                    ...(options.draft ? { draft: true } : {}),
+                });
+                prUrl = pr.prUrl;
+                prCreated = pr.created;
+            }
+            else {
+                const commitSubjects = await getCommitSubjects(base);
+                const title = inferPrTitle(branch, commitSubjects);
+                const body = inferPrBody(commitSubjects);
+                const createSpinner = ui.spinner('Creating PR (inferred title + body)');
+                createSpinner.start();
+                try {
+                    const args = ['pr', 'create', '--base', base, '--title', title, '--body', body];
+                    if (options.draft)
+                        args.push('--draft');
+                    const { stdout } = await execa('gh', args);
+                    const url = stdout.trim().split('\n').pop() ?? '';
+                    createSpinner.succeed(`Created PR: ${url}`);
+                    prUrl = url;
+                    prCreated = true;
+                }
+                catch (error) {
+                    createSpinner.fail('Failed to create PR');
+                    const stderr = error.stderr ?? '';
+                    if (stderr)
+                        ui.muted(stderr.trim().split('\n').slice(-10).join('\n'));
+                    throw new Error('gh pr create failed. Fix the issue and re-run, or open the PR manually.');
+                }
+            }
+        }
+    }
+    const result = {
+        branch,
+        base,
+        verified,
+        pushed,
+        prCreated,
+        changesetExisting,
+        commits: commitsAhead,
+    };
+    if (verifyDurationMs !== undefined)
+        result.verifyDurationMs = verifyDurationMs;
+    if (prUrl !== undefined)
+        result.prUrl = prUrl;
+    if (changesetPath !== undefined)
+        result.changesetPath = changesetPath;
+    return result;
+}
+export function createWorkShipCommand() {
+    const command = new Command('ship');
+    command
+        .description('Ship the current branch: verify → ensure changeset → push → open PR')
+        .option('--base <branch>', 'base branch (default: origin HEAD)')
+        .option('--no-verify', 'skip the verify step')
+        .option('--no-changeset', 'skip changeset creation')
+        .option('--no-ai-pr', 'do not use AI for PR description (inferred title + minimal body)')
+        .option('--draft', 'open the PR as a draft')
+        .option('--bump <level>', 'changeset bump level (major|minor|patch|empty)')
+        .option('--summary <text>', 'changeset summary')
+        .option('--package <names>', 'comma-separated package names (monorepos)')
+        .addHelpText('after', `
+Examples:
+  Ship the current branch interactively:
+    $ neo work ship
+
+  Skip verify (iterating fast):
+    $ neo work ship --no-verify
+
+  Agent-friendly (non-AI PR, minor bump changeset):
+    $ neo work ship --yes --no-ai-pr --bump minor --summary "Add foo" --json
+
+  Draft PR:
+    $ neo work ship --draft
+`)
+        .action(runAction(async (options) => {
+        const result = await executeWorkShip(options);
+        emitJson({
+            ok: true,
+            command: 'work ship',
+            branch: result.branch,
+            base: result.base,
+            verified: result.verified,
+            verifyDurationMs: result.verifyDurationMs,
+            pushed: result.pushed,
+            commits: result.commits,
+            prUrl: result.prUrl,
+            prCreated: result.prCreated,
+            changesetPath: result.changesetPath,
+            changesetExisting: result.changesetExisting,
+        }, {
+            text: () => {
+                ui.newline();
+                if (result.prUrl) {
+                    ui.success(result.prCreated
+                        ? `Shipped ${result.branch} → PR opened: ${result.prUrl}`
+                        : `Shipped ${result.branch} → existing PR: ${result.prUrl}`);
+                }
+                else {
+                    ui.success(`Shipped ${result.branch} (no PR created — gh unavailable)`);
+                }
+                if (result.changesetPath) {
+                    const tag = result.changesetExisting ? 'kept' : 'added';
+                    ui.muted(`Changeset ${tag}: ${result.changesetPath}`);
+                }
+            },
+        });
+    }));
+    return command;
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/work/ship/index.js.map

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

package/dist/commands/work/start/index.d.ts

@@ -0,0 +1,17 @@
+import { Command } from '@commander-js/extra-typings';
+interface WorkStartOptions {
+    prefix?: string | false;
+    from?: string;
+    worktree?: boolean;
+}
+interface WorkStartResult {
+    branch: string;
+    base: string;
+    worktreePath?: string;
+    previousBranch: string;
+    contextRecorded: boolean;
+}
+export declare function executeWorkStart(rawName: string, options: WorkStartOptions): Promise<WorkStartResult>;
+export declare function createWorkStartCommand(): Command;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/work/start/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/work/start/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAgBtD,UAAU,gBAAgB;IAMxB,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,eAAe;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;CAC1B;AA4HD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAoF1B;AAED,wBAAgB,sBAAsB,IAAI,OAAO,CAgEhD"}

package/dist/commands/work/start/index.js

@@ -0,0 +1,250 @@
+import { Command } from '@commander-js/extra-typings';
+import { execa } from 'execa';
+import { access } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { ui } from '../../../utils/ui.js';
+import { emitJson } from '../../../utils/output.js';
+import { runAction } from '../../../utils/run-action.js';
+import { GitErrors, isNotGitRepository, isAuthenticationError, isNetworkError, } from '../../../utils/git-errors.js';
+import { getProjectRoot, isAgentInitialized, getAgentDbPath } from '../../../utils/agent.js';
+import { ContextDB } from '../../../storage/db.js';
+async function pathExists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function detectDefaultBranch() {
+    try {
+        const { stdout } = await execa('git', ['symbolic-ref', 'refs/remotes/origin/HEAD']);
+        return stdout.replace('refs/remotes/origin/', '').trim();
+    }
+    catch {
+        for (const name of ['main', 'master']) {
+            try {
+                await execa('git', ['show-ref', '--verify', '--quiet', `refs/remotes/origin/${name}`]);
+                return name;
+            }
+            catch {
+                continue;
+            }
+        }
+        throw new Error('Could not detect default branch. Pass --from <ref>, or run `git remote set-head origin --auto`.');
+    }
+}
+async function getCurrentBranch() {
+    const { stdout } = await execa('git', ['branch', '--show-current']);
+    return stdout.trim();
+}
+async function readGitUserName() {
+    try {
+        const { stdout } = await execa('git', ['config', '--get', 'user.name']);
+        const trimmed = stdout.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function userNameToPrefix(userName) {
+    const firstToken = userName.trim().split(/\s+/)[0] ?? '';
+    const normalized = firstToken.toLowerCase().replace(/[^a-z0-9-]/g, '');
+    return normalized.length > 0 ? normalized : null;
+}
+async function resolveBranchName(raw, options) {
+    const trimmed = raw.trim();
+    if (trimmed.length === 0) {
+        throw new Error('Branch name is required.');
+    }
+    if (options.prefix === false)
+        return trimmed;
+    if (trimmed.includes('/'))
+        return trimmed;
+    if (typeof options.prefix === 'string' && options.prefix.length > 0) {
+        const clean = options.prefix.replace(/\/+$/, '');
+        return `${clean}/${trimmed}`;
+    }
+    const userName = await readGitUserName();
+    const derived = userName ? userNameToPrefix(userName) : null;
+    if (!derived) {
+        throw new Error('Could not derive a branch prefix from git user.name. Pass --prefix <name> or --no-prefix.');
+    }
+    return `${derived}/${trimmed}`;
+}
+async function branchExistsLocally(branch) {
+    try {
+        await execa('git', ['show-ref', '--verify', '--quiet', `refs/heads/${branch}`]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function recordWorkItemInAgentDb(payload) {
+    if (!(await isAgentInitialized()))
+        return false;
+    const dbPath = await getAgentDbPath();
+    if (!dbPath)
+        return false;
+    let db = null;
+    try {
+        db = await ContextDB.create(dbPath);
+        db.addContext({
+            content: JSON.stringify({
+                kind: 'work-item',
+                branch: payload.branch,
+                base: payload.base,
+                worktreePath: payload.worktreePath ?? null,
+                createdAt: new Date().toISOString(),
+            }),
+            tags: ['work-item', 'active', `branch:${payload.branch}`],
+            priority: 'medium',
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        db?.close();
+    }
+}
+export async function executeWorkStart(rawName, options) {
+    try {
+        await execa('git', ['rev-parse', '--is-inside-work-tree']);
+    }
+    catch (error) {
+        if (isNotGitRepository(error))
+            throw GitErrors.notARepository('work start');
+        throw GitErrors.unknown('work start', error);
+    }
+    const previousBranch = await getCurrentBranch();
+    const branch = await resolveBranchName(rawName, options);
+    if (await branchExistsLocally(branch)) {
+        throw new Error(`Branch "${branch}" already exists locally. Run \`git checkout ${branch}\` to switch to it.`);
+    }
+    const base = options.from ?? `origin/${await detectDefaultBranch()}`;
+    if (base.startsWith('origin/')) {
+        const remoteBranch = base.replace(/^origin\//, '');
+        const fetchSpinner = ui.spinner(`Fetching ${base}`);
+        fetchSpinner.start();
+        try {
+            await execa('git', ['fetch', 'origin', remoteBranch]);
+            fetchSpinner.succeed(`Fetched ${base}`);
+        }
+        catch (error) {
+            fetchSpinner.fail(`Fetch failed for ${base}`);
+            if (isAuthenticationError(error))
+                throw GitErrors.authenticationFailed('work start');
+            if (isNetworkError(error))
+                throw GitErrors.networkError('work start');
+            throw GitErrors.unknown('work start', error);
+        }
+    }
+    let worktreePath;
+    if (options.worktree) {
+        const projectRoot = (await getProjectRoot()) ?? (await execa('git', ['rev-parse', '--show-toplevel'])).stdout.trim();
+        const lastSegment = branch.split('/').pop() ?? branch;
+        const wtAbs = resolve(projectRoot, '.worktrees', lastSegment);
+        if (await pathExists(wtAbs)) {
+            throw new Error(`Worktree path already exists: ${wtAbs}`);
+        }
+        const wtSpinner = ui.spinner(`Creating worktree at .worktrees/${lastSegment}`);
+        wtSpinner.start();
+        try {
+            await execa('git', ['worktree', 'add', '-b', branch, wtAbs, base]);
+            wtSpinner.succeed(`Created worktree at .worktrees/${lastSegment}`);
+            worktreePath = wtAbs;
+        }
+        catch (error) {
+            wtSpinner.fail('Worktree creation failed');
+            throw GitErrors.unknown('work start', error);
+        }
+    }
+    else {
+        const coSpinner = ui.spinner(`Creating branch ${branch} from ${base}`);
+        coSpinner.start();
+        try {
+            await execa('git', ['checkout', '-b', branch, base]);
+            coSpinner.succeed(`Created branch ${branch} from ${base}`);
+        }
+        catch (error) {
+            coSpinner.fail('Branch creation failed');
+            throw GitErrors.unknown('work start', error);
+        }
+    }
+    const contextRecorded = await recordWorkItemInAgentDb({
+        branch,
+        base,
+        ...(worktreePath !== undefined ? { worktreePath } : {}),
+    });
+    const result = {
+        branch,
+        base,
+        previousBranch,
+        contextRecorded,
+    };
+    if (worktreePath !== undefined)
+        result.worktreePath = worktreePath;
+    return result;
+}
+export function createWorkStartCommand() {
+    const command = new Command('start');
+    command
+        .description('Start a new piece of work: create a prefixed branch (and optionally a worktree)')
+        .argument('<name>', 'branch name (e.g. fix-login-redirect or CLRK-123-fix-login)')
+        .option('--prefix <name>', 'branch prefix (default: lowercased first token of git user.name)')
+        .option('--no-prefix', 'skip automatic prefixing')
+        .option('--from <ref>', 'base ref (default: origin/<default-branch>)')
+        .option('--worktree', 'create under .worktrees/<name>/ instead of checking out in place')
+        .addHelpText('after', `
+Examples:
+  New branch off origin/main with auto prefix:
+    $ neo work start fix-login-redirect
+    # → creates jacek/fix-login-redirect (for user jacek)
+
+  Start in a worktree (keeps your current branch intact):
+    $ neo work start fix-login-redirect --worktree
+
+  Override the prefix:
+    $ neo work start 123-auth-bug --prefix team
+
+  From a specific ref:
+    $ neo work start experiment --from origin/develop
+
+  Agent-friendly:
+    $ neo work start fix-foo --yes --json
+`)
+        .action(runAction(async (name, options) => {
+        const result = await executeWorkStart(name, options);
+        emitJson({
+            ok: true,
+            command: 'work start',
+            branch: result.branch,
+            base: result.base,
+            worktreePath: result.worktreePath,
+            previousBranch: result.previousBranch,
+            contextRecorded: result.contextRecorded,
+        }, {
+            text: () => {
+                if (result.worktreePath) {
+                    ui.newline();
+                    ui.success(`Worktree ready: ${result.worktreePath}`);
+                    ui.muted(`  cd ${result.worktreePath}`);
+                }
+                else {
+                    ui.newline();
+                    ui.success(`On branch ${result.branch} (from ${result.base})`);
+                }
+                if (result.contextRecorded) {
+                    ui.muted('Recorded work item in .neo/agent/contexts.json');
+                }
+            },
+        });
+    }));
+    return command;
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/work/start/index.js.map

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