@radkode/neo 1.3.0 → 1.5.0

package/dist/commands/doctor/index.js

@@ -0,0 +1,313 @@
+import { Command } from '@commander-js/extra-typings';
+import { execa } from 'execa';
+import which from 'which';
+import { access, readFile } from 'node:fs/promises';
+import { constants } from 'node:fs';
+import { findUp } from 'find-up';
+import { ui } from '../../utils/ui.js';
+import { emitJson } from '../../utils/output.js';
+import { runAction } from '../../utils/run-action.js';
+import { configManager } from '../../utils/config.js';
+import { secretsManager } from '../../utils/secrets.js';
+const FALLBACK_MIN_NODE = '20.0.0';
+function parseSemver(version) {
+    const cleaned = version.replace(/^[=v]/, '').split(/[-+]/)[0] ?? '';
+    const parts = cleaned.split('.').map((n) => Number.parseInt(n, 10));
+    return [parts[0] || 0, parts[1] || 0, parts[2] || 0];
+}
+function compareSemver(a, b) {
+    const [a1, a2, a3] = parseSemver(a);
+    const [b1, b2, b3] = parseSemver(b);
+    if (a1 !== b1)
+        return a1 < b1 ? -1 : 1;
+    if (a2 !== b2)
+        return a2 < b2 ? -1 : 1;
+    if (a3 !== b3)
+        return a3 < b3 ? -1 : 1;
+    return 0;
+}
+function extractMinNodeVersion(range) {
+    const match = range.match(/(\d+(?:\.\d+){0,2})/);
+    return match?.[1] ?? null;
+}
+async function readRepoEnginesNode(cwd) {
+    const pkgPath = await findUp('package.json', { cwd });
+    if (!pkgPath)
+        return null;
+    try {
+        const raw = await readFile(pkgPath, 'utf-8');
+        const pkg = JSON.parse(raw);
+        return pkg.engines?.node ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+async function checkNodeVersion(cwd) {
+    const current = process.versions.node;
+    const enginesRange = await readRepoEnginesNode(cwd);
+    const minVersion = enginesRange
+        ? (extractMinNodeVersion(enginesRange) ?? FALLBACK_MIN_NODE)
+        : FALLBACK_MIN_NODE;
+    const source = enginesRange ? `engines.node "${enginesRange}"` : `default >=${FALLBACK_MIN_NODE}`;
+    if (compareSemver(current, minVersion) >= 0) {
+        return {
+            name: 'node',
+            status: 'ok',
+            message: `Node ${current} satisfies ${source}`,
+        };
+    }
+    return {
+        name: 'node',
+        status: 'fail',
+        message: `Node ${current} is older than ${minVersion} required by ${source}`,
+        suggestion: `Upgrade Node to >=${minVersion} (e.g., via nvm, fnm, or volta).`,
+    };
+}
+async function binaryExists(name) {
+    try {
+        await which(name);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function checkPackageManagers() {
+    const managers = ['pnpm', 'npm', 'yarn', 'bun'];
+    const found = [];
+    for (const pm of managers) {
+        if (await binaryExists(pm))
+            found.push(pm);
+    }
+    if (found.length === 0) {
+        return {
+            name: 'packageManager',
+            status: 'fail',
+            message: 'No package manager found on PATH (pnpm/npm/yarn/bun).',
+            suggestion: 'Install at least one package manager — pnpm is recommended.',
+        };
+    }
+    return {
+        name: 'packageManager',
+        status: 'ok',
+        message: `Found: ${found.join(', ')}`,
+    };
+}
+async function checkGitIdentity() {
+    if (!(await binaryExists('git'))) {
+        return {
+            name: 'gitIdentity',
+            status: 'fail',
+            message: 'git is not installed.',
+            suggestion: 'Install git from https://git-scm.com/downloads.',
+        };
+    }
+    const read = async (key) => {
+        try {
+            const { stdout } = await execa('git', ['config', '--get', key]);
+            return stdout.trim();
+        }
+        catch {
+            return '';
+        }
+    };
+    const [name, email] = await Promise.all([read('user.name'), read('user.email')]);
+    const missing = [];
+    if (!name)
+        missing.push('user.name');
+    if (!email)
+        missing.push('user.email');
+    if (missing.length > 0) {
+        return {
+            name: 'gitIdentity',
+            status: 'warn',
+            message: `git is missing ${missing.join(', ')}.`,
+            suggestion: `Set with \`git config --global user.name "..."\` and \`git config --global user.email "..."\`.`,
+        };
+    }
+    return {
+        name: 'gitIdentity',
+        status: 'ok',
+        message: `${name} <${email}>`,
+    };
+}
+async function checkGhAuth() {
+    if (!(await binaryExists('gh'))) {
+        return {
+            name: 'gh',
+            status: 'warn',
+            message: 'GitHub CLI (gh) is not installed.',
+            suggestion: 'Install from https://cli.github.com — needed for `neo gh` and PR flows.',
+        };
+    }
+    try {
+        await execa('gh', ['auth', 'status'], { stdio: ['ignore', 'pipe', 'pipe'] });
+        return {
+            name: 'gh',
+            status: 'ok',
+            message: 'gh is installed and authenticated.',
+        };
+    }
+    catch {
+        return {
+            name: 'gh',
+            status: 'warn',
+            message: 'gh is installed but not authenticated.',
+            suggestion: 'Run `gh auth login` to authenticate.',
+        };
+    }
+}
+async function checkNeoConfig() {
+    const configFile = configManager.getConfigFile();
+    try {
+        await access(configFile, constants.F_OK);
+    }
+    catch {
+        return {
+            name: 'neoConfig',
+            status: 'warn',
+            message: `No config file at ${configFile}.`,
+            suggestion: 'Run `neo init` to create one.',
+        };
+    }
+    try {
+        const raw = await readFile(configFile, 'utf-8');
+        JSON.parse(raw);
+        return {
+            name: 'neoConfig',
+            status: 'ok',
+            message: `Config file is valid JSON (${configFile}).`,
+        };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return {
+            name: 'neoConfig',
+            status: 'fail',
+            message: `Config file is unreadable: ${msg}`,
+            suggestion: `Inspect or remove ${configFile} and re-run \`neo init\`.`,
+        };
+    }
+}
+async function checkConfigDirWritable() {
+    const dir = configManager.getConfigDir();
+    try {
+        await access(dir, constants.W_OK);
+        return {
+            name: 'configDirWritable',
+            status: 'ok',
+            message: `${dir} is writable.`,
+        };
+    }
+    catch {
+        try {
+            await access(dir, constants.F_OK);
+            return {
+                name: 'configDirWritable',
+                status: 'fail',
+                message: `${dir} exists but isn't writable by the current user.`,
+                suggestion: `Check permissions on ${dir}.`,
+            };
+        }
+        catch {
+            return {
+                name: 'configDirWritable',
+                status: 'ok',
+                message: `${dir} does not exist yet — will be created by \`neo init\`.`,
+            };
+        }
+    }
+}
+async function checkAnthropicKey() {
+    if (process.env['ANTHROPIC_API_KEY']) {
+        return {
+            name: 'anthropicKey',
+            status: 'ok',
+            message: 'ANTHROPIC_API_KEY is set in the environment.',
+        };
+    }
+    try {
+        const configured = await secretsManager.isConfigured('ai.apiKey');
+        if (configured) {
+            return {
+                name: 'anthropicKey',
+                status: 'ok',
+                message: 'API key found in secrets store.',
+            };
+        }
+    }
+    catch {
+    }
+    return {
+        name: 'anthropicKey',
+        status: 'warn',
+        message: 'No Anthropic API key configured.',
+        suggestion: 'Set $ANTHROPIC_API_KEY or run `neo config set ai.apiKey <key>` — required for `neo git commit --ai`.',
+    };
+}
+export async function executeDoctor(cwd) {
+    const checks = await Promise.all([
+        checkNodeVersion(cwd),
+        checkPackageManagers(),
+        checkGitIdentity(),
+        checkGhAuth(),
+        checkNeoConfig(),
+        checkConfigDirWritable(),
+        checkAnthropicKey(),
+    ]);
+    const ok = checks.every((c) => c.status !== 'fail');
+    return { ok, checks };
+}
+function renderText(result) {
+    ui.newline();
+    for (const check of result.checks) {
+        const line = `${check.name}: ${check.message}`;
+        if (check.status === 'ok')
+            ui.success(line);
+        else if (check.status === 'warn')
+            ui.warn(line);
+        else
+            ui.error(line);
+        if (check.suggestion)
+            ui.muted(`  → ${check.suggestion}`);
+    }
+    ui.newline();
+    const failed = result.checks.filter((c) => c.status === 'fail').length;
+    const warned = result.checks.filter((c) => c.status === 'warn').length;
+    if (failed === 0 && warned === 0) {
+        ui.success('All checks passed.');
+    }
+    else if (failed === 0) {
+        ui.warn(`${warned} warning(s) — nothing broken, but you may want to address them.`);
+    }
+    else {
+        ui.error(`${failed} check(s) failed${warned > 0 ? `, ${warned} warning(s)` : ''}.`);
+    }
+}
+export function createDoctorCommand() {
+    const command = new Command('doctor');
+    command
+        .description('Diagnose the local Neo setup — node version, package managers, git/gh, config, and API keys')
+        .addHelpText('after', `
+Examples:
+  Run all checks (default):
+    $ neo doctor
+
+  Agent-friendly (structured checks + exit code):
+    $ neo doctor --json
+`)
+        .action(runAction(async () => {
+        const result = await executeDoctor(process.cwd());
+        emitJson({
+            ok: result.ok,
+            command: 'doctor',
+            checks: result.checks,
+        }, { text: () => renderText(result) });
+        if (!result.ok) {
+            process.exitCode = 1;
+        }
+    }));
+    return command;
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/doctor/index.js.map

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

package/dist/commands/index.d.ts

@@ -10,4 +10,9 @@ export { createUpdateCommand } from './update/index.js';
 export { createAgentCommand } from './agent/index.js';
 export { createCompletionsCommand } from './completions/index.js';
 export { createSchemaCommand } from './schema/index.js';
+export { createSyncCommand } from './sync/index.js';
+export { createVerifyCommand } from './verify/index.js';
+export { createChangesetCommand } from './changeset/index.js';
+export { createDoctorCommand } from './doctor/index.js';
+export { createAiCommand } from './ai/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAYtD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAWvD;AAED,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAiBtD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgBvD;AAED,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/commands/index.js

@@ -8,6 +8,11 @@ import { createAliasCommand } from './alias/index.js';
 import { createAgentCommand } from './agent/index.js';
 import { createCompletionsCommand } from './completions/index.js';
 import { createSchemaCommand } from './schema/index.js';
+import { createSyncCommand } from './sync/index.js';
+import { createVerifyCommand } from './verify/index.js';
+import { createChangesetCommand } from './changeset/index.js';
+import { createDoctorCommand } from './doctor/index.js';
+import { createAiCommand } from './ai/index.js';
 export function registerCommands(program) {
     program.addCommand(createInitCommand());
     program.addCommand(createConfigCommand());
@@ -19,6 +24,11 @@ export function registerCommands(program) {
     program.addCommand(createAgentCommand());
     program.addCommand(createCompletionsCommand());
     program.addCommand(createSchemaCommand());
+    program.addCommand(createSyncCommand());
+    program.addCommand(createVerifyCommand());
+    program.addCommand(createChangesetCommand());
+    program.addCommand(createDoctorCommand());
+    program.addCommand(createAiCommand());
 }
 export { createInitCommand } from './init/index.js';
 export { createConfigCommand } from './config/index.js';
@@ -30,4 +40,9 @@ export { createUpdateCommand } from './update/index.js';
 export { createAgentCommand } from './agent/index.js';
 export { createCompletionsCommand } from './completions/index.js';
 export { createSchemaCommand } from './schema/index.js';
+export { createSyncCommand } from './sync/index.js';
+export { createVerifyCommand } from './verify/index.js';
+export { createChangesetCommand } from './changeset/index.js';
+export { createDoctorCommand } from './doctor/index.js';
+export { createAiCommand } from './ai/index.js';
 //# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACvC,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,UAAU,CAAC,wBAAwB,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/sync/index.d.ts

@@ -0,0 +1,18 @@
+import { Command } from '@commander-js/extra-typings';
+interface SyncOptions {
+    merge?: boolean;
+    branch?: string;
+    stash?: boolean;
+}
+interface SyncResult {
+    branch: string;
+    base: string;
+    strategy: 'rebase' | 'merge';
+    stashed: boolean;
+    ahead: number;
+    behind: number;
+}
+export declare function executeSync(options: SyncOptions): Promise<SyncResult>;
+export declare function createSyncCommand(): Command;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/sync/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAatD,UAAU,WAAW;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AA6CD,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA4G3E;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAqD3C"}

package/dist/commands/sync/index.js

@@ -0,0 +1,193 @@
+import { Command } from '@commander-js/extra-typings';
+import { execa } from 'execa';
+import { ui } from '../../utils/ui.js';
+import { emitJson } from '../../utils/output.js';
+import { runAction } from '../../utils/run-action.js';
+import { GitErrors, isAuthenticationError, isConflictError, isNetworkError, isNotGitRepository, } from '../../utils/git-errors.js';
+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. Run `git remote set-head origin --auto`, or pass --branch <name>.');
+    }
+}
+async function getCurrentBranch() {
+    const { stdout } = await execa('git', ['branch', '--show-current']);
+    return stdout.trim();
+}
+async function isTreeDirty() {
+    const { stdout } = await execa('git', ['status', '--porcelain']);
+    return stdout.trim().length > 0;
+}
+async function tryPopStash() {
+    try {
+        await execa('git', ['stash', 'pop']);
+        ui.muted('Restored stashed changes.');
+    }
+    catch {
+        ui.warn('Stash pop failed; run `git stash list` to recover.');
+    }
+}
+export async function executeSync(options) {
+    try {
+        await execa('git', ['rev-parse', '--is-inside-work-tree']);
+    }
+    catch (error) {
+        if (isNotGitRepository(error)) {
+            throw GitErrors.notARepository('sync');
+        }
+        throw GitErrors.unknown('sync', error);
+    }
+    const currentBranch = await getCurrentBranch();
+    if (!currentBranch) {
+        throw new Error('Detached HEAD — check out a branch before syncing.');
+    }
+    const targetBranch = options.branch ?? (await detectDefaultBranch());
+    const strategy = options.merge ? 'merge' : 'rebase';
+    const allowStash = options.stash !== false;
+    let stashed = false;
+    if (await isTreeDirty()) {
+        if (!allowStash) {
+            throw new Error('Working tree has uncommitted changes. Commit them first, or drop --no-stash to auto-stash.');
+        }
+        const stashSpinner = ui.spinner('Stashing local changes');
+        stashSpinner.start();
+        try {
+            await execa('git', [
+                'stash',
+                'push',
+                '--include-untracked',
+                '--message',
+                'neo sync: auto-stash',
+            ]);
+            stashed = true;
+            stashSpinner.succeed('Stashed local changes');
+        }
+        catch (error) {
+            stashSpinner.fail('Failed to stash local changes');
+            throw GitErrors.unknown('sync', error);
+        }
+    }
+    const rebaseTarget = `origin/${targetBranch}`;
+    const fetchSpinner = ui.spinner(`Fetching ${rebaseTarget}`);
+    fetchSpinner.start();
+    try {
+        await execa('git', ['fetch', 'origin', targetBranch]);
+        fetchSpinner.succeed(`Fetched ${rebaseTarget}`);
+    }
+    catch (error) {
+        fetchSpinner.fail('Fetch failed');
+        if (stashed)
+            await tryPopStash();
+        if (isAuthenticationError(error))
+            throw GitErrors.authenticationFailed('sync');
+        if (isNetworkError(error))
+            throw GitErrors.networkError('sync');
+        throw GitErrors.unknown('sync', error);
+    }
+    const verb = strategy === 'rebase' ? 'Rebasing' : 'Merging';
+    const applySpinner = ui.spinner(`${verb} onto ${rebaseTarget}`);
+    applySpinner.start();
+    try {
+        if (strategy === 'rebase') {
+            await execa('git', ['rebase', rebaseTarget]);
+        }
+        else {
+            await execa('git', ['merge', '--no-ff', rebaseTarget]);
+        }
+        applySpinner.succeed(`${verb === 'Rebasing' ? 'Rebased' : 'Merged'} onto ${rebaseTarget}`);
+    }
+    catch (error) {
+        applySpinner.fail(`${verb} failed`);
+        if (isConflictError(error)) {
+            if (strategy === 'rebase')
+                throw GitErrors.rebaseConflict('sync');
+            throw GitErrors.mergeConflict('sync');
+        }
+        throw GitErrors.unknown('sync', error);
+    }
+    if (stashed) {
+        const popSpinner = ui.spinner('Restoring stashed changes');
+        popSpinner.start();
+        try {
+            await execa('git', ['stash', 'pop']);
+            popSpinner.succeed('Restored stashed changes');
+        }
+        catch {
+            popSpinner.warn('Stash pop had conflicts — left stash in place. Run `git stash list`.');
+        }
+    }
+    const { stdout } = await execa('git', [
+        'rev-list',
+        '--left-right',
+        '--count',
+        `${rebaseTarget}...HEAD`,
+    ]);
+    const [behindStr, aheadStr] = stdout.trim().split(/\s+/);
+    const behind = Number.parseInt(behindStr ?? '0', 10) || 0;
+    const ahead = Number.parseInt(aheadStr ?? '0', 10) || 0;
+    return {
+        branch: currentBranch,
+        base: targetBranch,
+        strategy,
+        stashed,
+        ahead,
+        behind,
+    };
+}
+export function createSyncCommand() {
+    const command = new Command('sync');
+    command
+        .description('Rebase the current branch onto origin/<default-branch>, auto-stashing if dirty')
+        .option('--merge', 'use merge (--no-ff) instead of rebase')
+        .option('--branch <name>', 'sync against a specific remote branch (default: origin HEAD)')
+        .option('--no-stash', 'do not auto-stash a dirty tree — fail instead')
+        .addHelpText('after', `
+Examples:
+  Rebase current branch onto origin/<default>:
+    $ neo sync
+
+  Merge instead of rebase:
+    $ neo sync --merge
+
+  Sync against a non-default base:
+    $ neo sync --branch develop
+
+  Agent-friendly (structured output):
+    $ neo sync --yes --json
+`)
+        .action(runAction(async (options) => {
+        const result = await executeSync(options);
+        emitJson({
+            ok: true,
+            command: 'sync',
+            branch: result.branch,
+            base: result.base,
+            strategy: result.strategy,
+            stashed: result.stashed,
+            ahead: result.ahead,
+            behind: result.behind,
+        }, {
+            text: () => {
+                ui.success(`Synced ${result.branch} onto origin/${result.base}`);
+                ui.muted(`ahead: ${result.ahead}, behind: ${result.behind}`);
+                if (result.stashed) {
+                    ui.muted('auto-stash restored');
+                }
+            },
+        });
+    }));
+    return command;
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/sync/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAsB/B,KAAK,UAAU,mBAAmB;IAChC,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,cAAc,EAAE,0BAA0B,CAAC,CAAC,CAAC;QACpF,OAAO,MAAM,CAAC,OAAO,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,uBAAuB,IAAI,EAAE,CAAC,CAAC,CAAC;gBACvF,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;QACD,MAAM,IAAI,KAAK,CACb,oGAAoG,CACrG,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gBAAgB;IAC7B,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACpE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC;AAED,KAAK,UAAU,WAAW;IACxB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IACjE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,KAAK,UAAU,WAAW;IACxB,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QACrC,EAAE,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,EAAE,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAoB;IACpD,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QACzC,CAAC;QACD,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,gBAAgB,EAAE,CAAC;IAC/C,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,mBAAmB,EAAE,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAuB,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;IACxE,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC;IAE3C,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,MAAM,WAAW,EAAE,EAAE,CAAC;QACxB,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,4FAA4F,CAC7F,CAAC;QACJ,CAAC;QACD,MAAM,YAAY,GAAG,EAAE,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;QAC1D,YAAY,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,KAAK,EAAE;gBACjB,OAAO;gBACP,MAAM;gBACN,qBAAqB;gBACrB,WAAW;gBACX,sBAAsB;aACvB,CAAC,CAAC;YACH,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;YACnD,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,UAAU,YAAY,EAAE,CAAC;IAC9C,MAAM,YAAY,GAAG,EAAE,CAAC,OAAO,CAAC,YAAY,YAAY,EAAE,CAAC,CAAC;IAC5D,YAAY,CAAC,KAAK,EAAE,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;QACtD,YAAY,CAAC,OAAO,CAAC,WAAW,YAAY,EAAE,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAClC,IAAI,OAAO;YAAE,MAAM,WAAW,EAAE,CAAC;QACjC,IAAI,qBAAqB,CAAC,KAAK,CAAC;YAAE,MAAM,SAAS,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC/E,IAAI,cAAc,CAAC,KAAK,CAAC;YAAE,MAAM,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAChE,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5D,MAAM,YAAY,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,IAAI,SAAS,YAAY,EAAE,CAAC,CAAC;IAChE,YAAY,CAAC,KAAK,EAAE,CAAC;IACrB,IAAI,CAAC;QACH,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC1B,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,SAAS,YAAY,EAAE,CAAC,CAAC;IAC7F,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,YAAY,CAAC,IAAI,CAAC,GAAG,IAAI,SAAS,CAAC,CAAC;QAGpC,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,IAAI,QAAQ,KAAK,QAAQ;gBAAE,MAAM,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YAClE,MAAM,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;QACD,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;QAC3D,UAAU,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YACrC,UAAU,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE;QACpC,UAAU;QACV,cAAc;QACd,SAAS;QACT,GAAG,YAAY,SAAS;KACzB,CAAC,CAAC;IACH,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,IAAI,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,IAAI,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IAExD,OAAO;QACL,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,YAAY;QAClB,QAAQ;QACR,OAAO;QACP,KAAK;QACL,MAAM;KACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpC,OAAO;SACJ,WAAW,CAAC,gFAAgF,CAAC;SAC7F,MAAM,CAAC,SAAS,EAAE,uCAAuC,CAAC;SAC1D,MAAM,CAAC,iBAAiB,EAAE,8DAA8D,CAAC;SACzF,MAAM,CAAC,YAAY,EAAE,+CAA+C,CAAC;SACrE,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;CAaL,CACI;SACA,MAAM,CACL,SAAS,CAAC,KAAK,EAAE,OAAoB,EAAE,EAAE;QACvC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;QAC1C,QAAQ,CACN;YACE,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,MAAM;YACf,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,EACD;YACE,IAAI,EAAE,GAAG,EAAE;gBACT,EAAE,CAAC,OAAO,CAAC,UAAU,MAAM,CAAC,MAAM,gBAAgB,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;gBACjE,EAAE,CAAC,KAAK,CAAC,UAAU,MAAM,CAAC,KAAK,aAAa,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC7D,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,EAAE,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC;SACF,CACF,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IAEJ,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/commands/verify/index.d.ts

@@ -0,0 +1,23 @@
+import { Command } from '@commander-js/extra-typings';
+type PackageManager = 'pnpm' | 'npm' | 'yarn' | 'bun';
+interface VerifyOptions {
+    pm?: string;
+    only?: string;
+    skip?: string;
+}
+interface ScriptResult {
+    script: string;
+    status: 'passed' | 'failed' | 'skipped';
+    durationMs: number;
+    exitCode?: number;
+}
+interface VerifyResult {
+    packageManager: PackageManager;
+    results: ScriptResult[];
+    ok: boolean;
+    totalDurationMs: number;
+}
+export declare function executeVerify(cwd: string, options: VerifyOptions): Promise<VerifyResult>;
+export declare function createVerifyCommand(): Command;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/verify/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/verify/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAQtD,KAAK,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;AAatD,UAAU,aAAa;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,YAAY;IACpB,cAAc,EAAE,cAAc,CAAC;IAC/B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,EAAE,EAAE,OAAO,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC;CACzB;AA8DD,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAqD9F;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CA6D7C"}