@mbluemer_2/gittyup 0.1.2 → 0.1.8

package/README.md

@@ -223,11 +223,12 @@ Both `pnpm dev project list` and `pnpm dev -- project list` are supported.
 Updating `package.json` to a new version and merging that change to `main`
 automatically runs the release workflow.
 
-- CI runs lint, tests, and build
+- CI runs first on the `main` push
+- Release only runs after that CI run succeeds
 - The workflow creates and pushes the matching `vX.Y.Z` tag
 - `pnpm pack` creates an installable tarball
 - GitHub Releases gets the tarball and `SHA256SUMS.txt` attached automatically
-- The same workflow publishes `@mbluemer_2/gittyup` to npm
+- The same workflow publishes `@mbluemer_2/gittyup` to npm using the `NPM_TOKEN` repo secret
 
 You can still create a release manually by pushing a tag like `v0.1.0` yourself.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mbluemer_2/gittyup",
-  "version": "0.1.2",
+  "version": "0.1.8",
   "description": "Filesystem-driven CLI for managing bare git repositories and worktrees",
   "main": "dist/cli.js",
   "files": [

package/dist/aliases.js

@@ -1,32 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalizeArgv = normalizeArgv;
-const COMMAND_ALIASES = {
-    p: ['project'],
-    pl: ['project', 'list'],
-    pd: ['project', 'doctor'],
-    pg: ['project', 'init', 'get'],
-    ps: ['project', 'init', 'set'],
-    px: ['project', 'init', 'clear'],
-    pc: ['project', 'create'],
-    pcl: ['project', 'clone'],
-    pi: ['project', 'import'],
-    pr: ['project', 'rename'],
-    w: ['worktree'],
-    wl: ['worktree', 'list'],
-    wa: ['worktree', 'add'],
-    wr: ['worktree', 'remove'],
-    s: ['status'],
-    st: ['status'],
-    t: ['tmux'],
-    tl: ['tmux', 'launch'],
-    ts: ['tmux', 'switch'],
-};
-function normalizeArgv(argv) {
-    const normalized = argv[2] === '--' ? [argv[0], argv[1], ...argv.slice(3)] : [...argv];
-    const alias = normalized[2] ? COMMAND_ALIASES[normalized[2]] : undefined;
-    if (!alias) {
-        return normalized;
-    }
-    return [normalized[0], normalized[1], ...alias, ...normalized.slice(3)];
-}

package/dist/cli.js

@@ -1,5 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const program_1 = require("./program");
-void (0, program_1.runCli)();

package/dist/config.js

@@ -1,127 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PROJECT_METADATA_FILENAME = exports.MAIN_WORKTREE_ALIAS = exports.BARE_REPO_DIRNAME = exports.DEFAULT_ROOT_DIR = void 0;
-exports.expandHome = expandHome;
-exports.resolveRootDir = resolveRootDir;
-exports.validateProjectName = validateProjectName;
-exports.validateAlias = validateAlias;
-exports.deriveAlias = deriveAlias;
-exports.inferProjectName = inferProjectName;
-exports.validateBranchName = validateBranchName;
-exports.validateRemoteUrl = validateRemoteUrl;
-exports.buildProjectPaths = buildProjectPaths;
-const node_os_1 = __importDefault(require("node:os"));
-const node_path_1 = __importDefault(require("node:path"));
-const errors_1 = require("./errors");
-exports.DEFAULT_ROOT_DIR = node_path_1.default.join(node_os_1.default.homedir(), 'src');
-exports.BARE_REPO_DIRNAME = 'repo.git';
-exports.MAIN_WORKTREE_ALIAS = 'main';
-exports.PROJECT_METADATA_FILENAME = '.gittyup.json';
-function expandHome(value) {
-    if (value === '~') {
-        return node_os_1.default.homedir();
-    }
-    if (value.startsWith('~/')) {
-        return node_path_1.default.join(node_os_1.default.homedir(), value.slice(2));
-    }
-    if (value.startsWith('$HOME/')) {
-        return node_path_1.default.join(node_os_1.default.homedir(), value.slice(6));
-    }
-    return value;
-}
-function resolveRootDir(input) {
-    return node_path_1.default.resolve(expandHome(input ?? process.env.GITTYUP_ROOT ?? exports.DEFAULT_ROOT_DIR));
-}
-function validateProjectName(name) {
-    if (name.trim().length === 0) {
-        throw new errors_1.CliError('Project name cannot be empty.');
-    }
-    if (name !== name.trim()) {
-        throw new errors_1.CliError('Project name cannot start or end with whitespace.');
-    }
-    if (/[/\\]/.test(name)) {
-        throw new errors_1.CliError('Project name must be a single directory name.');
-    }
-    if (name === '.' || name === '..') {
-        throw new errors_1.CliError("Project name must not be '.' or '..'.");
-    }
-    return name;
-}
-function validateAlias(alias) {
-    if (alias.trim().length === 0) {
-        throw new errors_1.CliError('Worktree alias cannot be empty.');
-    }
-    if (alias !== alias.trim()) {
-        throw new errors_1.CliError('Worktree alias cannot start or end with whitespace.');
-    }
-    if (/[/\\]/.test(alias)) {
-        throw new errors_1.CliError('Worktree alias must be a single directory name.');
-    }
-    if (alias === '.' || alias === '..') {
-        throw new errors_1.CliError("Worktree alias must not be '.' or '..'.");
-    }
-    return alias;
-}
-function deriveAlias(branch) {
-    const alias = branch
-        .replace(/[/\\]+/g, '-')
-        .replace(/[^A-Za-z0-9._-]+/g, '-')
-        .replace(/-+/g, '-')
-        .replace(/^-|-$/g, '');
-    return validateAlias(alias || 'worktree');
-}
-function inferProjectName(remote) {
-    const trimmed = remote.trim().replace(/\/$/, '');
-    const scpTail = trimmed.includes(':') && !trimmed.includes('://')
-        ? trimmed.slice(trimmed.lastIndexOf(':') + 1)
-        : trimmed;
-    const tail = scpTail.split('/').pop() ?? scpTail;
-    const name = tail.endsWith('.git') ? tail.slice(0, -4) : tail;
-    return validateProjectName(name);
-}
-// eslint-disable-next-line no-control-regex
-const INVALID_BRANCH_CHARS = /[\x00-\x1f\x7f~^:?*[\\]/;
-const INVALID_BRANCH_START = /^[./]/;
-const INVALID_BRANCH_END = /[./]$/;
-const INVALID_BRANCH_SEQUENCE = /(\.\.)|(\/\/)|(@\{)/;
-function validateBranchName(branch) {
-    const trimmed = branch.trim();
-    if (trimmed.length === 0) {
-        throw new errors_1.CliError('Branch name cannot be empty.');
-    }
-    if (INVALID_BRANCH_CHARS.test(trimmed)) {
-        throw new errors_1.CliError('Branch name contains invalid characters (control chars, ~, ^, :, ?, *, [, \\).');
-    }
-    if (INVALID_BRANCH_START.test(trimmed)) {
-        throw new errors_1.CliError('Branch name cannot start with . or /.');
-    }
-    if (INVALID_BRANCH_END.test(trimmed)) {
-        throw new errors_1.CliError('Branch name cannot end with . or /.');
-    }
-    if (INVALID_BRANCH_SEQUENCE.test(trimmed)) {
-        throw new errors_1.CliError('Branch name cannot contain "..", "//", or "@{".');
-    }
-    return trimmed;
-}
-function validateRemoteUrl(remote) {
-    const trimmed = remote.trim();
-    if (trimmed.length === 0) {
-        throw new errors_1.CliError('Remote URL cannot be empty.');
-    }
-    return trimmed;
-}
-function buildProjectPaths(rootDir, projectName) {
-    const name = validateProjectName(projectName);
-    const rootPath = node_path_1.default.join(rootDir, name);
-    const gitDir = node_path_1.default.join(rootPath, exports.BARE_REPO_DIRNAME);
-    const metadataPath = node_path_1.default.join(rootPath, exports.PROJECT_METADATA_FILENAME);
-    return {
-        name,
-        rootPath,
-        gitDir,
-        metadataPath,
-    };
-}

package/dist/errors.js

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CliError = void 0;
-exports.toErrorMessage = toErrorMessage;
-class CliError extends Error {
-    exitCode;
-    constructor(message, exitCode = 1) {
-        super(message);
-        this.name = 'CliError';
-        this.exitCode = exitCode;
-    }
-}
-exports.CliError = CliError;
-function toErrorMessage(error) {
-    if (error instanceof Error) {
-        return error.message;
-    }
-    return String(error);
-}

package/dist/git.js

@@ -1,293 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.checkGitAvailable = checkGitAvailable;
-exports.runGit = runGit;
-exports.initBareRepo = initBareRepo;
-exports.cloneBareRepo = cloneBareRepo;
-exports.getRepoTopLevel = getRepoTopLevel;
-exports.isBareRepository = isBareRepository;
-exports.bootstrapBareRepo = bootstrapBareRepo;
-exports.repoHasCommits = repoHasCommits;
-exports.getDefaultBranch = getDefaultBranch;
-exports.localBranchExists = localBranchExists;
-exports.parseWorktreeList = parseWorktreeList;
-exports.listWorktrees = listWorktrees;
-exports.listLinkedWorktrees = listLinkedWorktrees;
-exports.addWorktree = addWorktree;
-exports.removeWorktree = removeWorktree;
-exports.repairWorktrees = repairWorktrees;
-exports.getCurrentBranch = getCurrentBranch;
-exports.getHeadShortSha = getHeadShortSha;
-exports.getWorktreeStatus = getWorktreeStatus;
-const promises_1 = require("node:fs/promises");
-const node_os_1 = __importDefault(require("node:os"));
-const node_path_1 = __importDefault(require("node:path"));
-const errors_1 = require("./errors");
-const process_1 = require("./process");
-const MINIMUM_GIT_VERSION = '2.17.0';
-function compareVersions(a, b) {
-    const aParts = a.split('.').map(Number);
-    const bParts = b.split('.').map(Number);
-    for (let i = 0; i < Math.max(aParts.length, bParts.length); i++) {
-        const aVal = aParts[i] ?? 0;
-        const bVal = bParts[i] ?? 0;
-        if (aVal > bVal)
-            return 1;
-        if (aVal < bVal)
-            return -1;
-    }
-    return 0;
-}
-async function checkGitAvailable() {
-    try {
-        const versionOutput = await runGit(['--version']);
-        const match = versionOutput.match(/git version (\d+\.\d+\.\d+)/);
-        if (!match) {
-            throw new errors_1.CliError('Unable to determine git version. Please ensure git is installed.');
-        }
-        const version = match[1];
-        if (compareVersions(version, MINIMUM_GIT_VERSION) < 0) {
-            throw new errors_1.CliError(`Git version ${MINIMUM_GIT_VERSION} or higher is required. Found version ${version}.`);
-        }
-    }
-    catch (error) {
-        if (error instanceof errors_1.CliError) {
-            throw error;
-        }
-        throw new errors_1.CliError('Git is not installed or not available in PATH. Please install git to use gittyup.');
-    }
-}
-async function runGit(args, options = {}) {
-    return (0, process_1.runCommand)('git', args, options);
-}
-async function initBareRepo(gitDir) {
-    await runGit(['init', '--bare', '--initial-branch=main', gitDir]);
-}
-async function cloneBareRepo(remote, gitDir) {
-    await runGit(['clone', '--bare', remote, gitDir]);
-}
-async function getRepoTopLevel(repoPath) {
-    return runGit(['-C', repoPath, 'rev-parse', '--show-toplevel']);
-}
-async function isBareRepository(repoPath) {
-    const output = await runGit([
-        '-C',
-        repoPath,
-        'rev-parse',
-        '--is-bare-repository',
-    ]);
-    return output === 'true';
-}
-async function bootstrapBareRepo(gitDir, branch) {
-    const tempDir = await (0, promises_1.mkdtemp)(node_path_1.default.join(node_os_1.default.tmpdir(), 'gittyup-bootstrap-'));
-    try {
-        await runGit(['init', '--initial-branch', branch, tempDir]);
-        await runGit(['-C', tempDir, 'remote', 'add', 'origin', gitDir]);
-        await runGit([
-            '-C',
-            tempDir,
-            '-c',
-            'user.name=gittyup',
-            '-c',
-            'user.email=gittyup@local',
-            'commit',
-            '--allow-empty',
-            '-m',
-            'Initial commit',
-        ]);
-        await runGit(['-C', tempDir, 'push', 'origin', `${branch}:${branch}`]);
-    }
-    finally {
-        await (0, promises_1.rm)(tempDir, { recursive: true, force: true });
-    }
-}
-async function repoHasCommits(gitDir) {
-    try {
-        await runGit([
-            '--git-dir',
-            gitDir,
-            'rev-parse',
-            '--verify',
-            'HEAD^{commit}',
-        ]);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-async function getDefaultBranch(gitDir) {
-    try {
-        return await runGit([
-            '--git-dir',
-            gitDir,
-            'symbolic-ref',
-            '--quiet',
-            '--short',
-            'HEAD',
-        ]);
-    }
-    catch {
-        return null;
-    }
-}
-async function localBranchExists(gitDir, branch) {
-    try {
-        await runGit([
-            '--git-dir',
-            gitDir,
-            'show-ref',
-            '--verify',
-            '--quiet',
-            `refs/heads/${branch}`,
-        ]);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-function parseWorktreeList(output) {
-    const normalized = output.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
-    const trimmed = normalized.trim();
-    if (!trimmed) {
-        return [];
-    }
-    return trimmed.split(/\n\s*\n/).map((block) => {
-        let worktreePath = '';
-        let head = null;
-        let branch = null;
-        let bare = false;
-        let locked = false;
-        let prunable = false;
-        let detached = false;
-        for (const line of block.split('\n')) {
-            if (line.startsWith('worktree ')) {
-                worktreePath = line.slice('worktree '.length);
-                continue;
-            }
-            if (line.startsWith('HEAD ')) {
-                head = line.slice('HEAD '.length);
-                continue;
-            }
-            if (line.startsWith('branch ')) {
-                branch = line.slice('branch '.length).replace(/^refs\/heads\//, '');
-                continue;
-            }
-            if (line === 'bare') {
-                bare = true;
-                continue;
-            }
-            if (line === 'detached') {
-                detached = true;
-                continue;
-            }
-            if (line.startsWith('locked')) {
-                locked = true;
-                continue;
-            }
-            if (line.startsWith('prunable')) {
-                prunable = true;
-            }
-        }
-        return {
-            path: worktreePath,
-            alias: node_path_1.default.basename(worktreePath),
-            branch,
-            head,
-            bare,
-            locked,
-            prunable,
-            detached,
-        };
-    });
-}
-async function listWorktrees(gitDir) {
-    const output = await runGit([
-        '--git-dir',
-        gitDir,
-        'worktree',
-        'list',
-        '--porcelain',
-    ]);
-    return parseWorktreeList(output);
-}
-async function listLinkedWorktrees(gitDir) {
-    const worktrees = await listWorktrees(gitDir);
-    return worktrees.filter((entry) => !entry.bare);
-}
-async function addWorktree(gitDir, worktreePath, branch, startPoint) {
-    if (!(await repoHasCommits(gitDir))) {
-        throw new errors_1.CliError('Repository has no commits yet. Git cannot create a linked worktree for an empty bare repository.');
-    }
-    const args = ['--git-dir', gitDir, 'worktree', 'add'];
-    if (await localBranchExists(gitDir, branch)) {
-        args.push(worktreePath, branch);
-    }
-    else {
-        const resolvedStartPoint = startPoint ?? (await getDefaultBranch(gitDir));
-        if (!resolvedStartPoint) {
-            throw new errors_1.CliError(`Could not determine a start point for branch '${branch}'.`);
-        }
-        args.push('-b', branch, worktreePath, resolvedStartPoint);
-    }
-    await runGit(args);
-}
-async function removeWorktree(gitDir, worktreePath, force) {
-    const args = ['--git-dir', gitDir, 'worktree', 'remove'];
-    if (force) {
-        args.push('--force');
-    }
-    args.push(worktreePath);
-    await runGit(args);
-}
-async function repairWorktrees(gitDir, worktreePaths) {
-    const args = ['--git-dir', gitDir, 'worktree', 'repair', ...worktreePaths];
-    await runGit(args);
-}
-async function getCurrentBranch(worktreePath) {
-    try {
-        return await runGit([
-            '-C',
-            worktreePath,
-            'symbolic-ref',
-            '--quiet',
-            '--short',
-            'HEAD',
-        ]);
-    }
-    catch {
-        return null;
-    }
-}
-async function getHeadShortSha(worktreePath) {
-    return runGit(['-C', worktreePath, 'rev-parse', '--short', 'HEAD']);
-}
-async function getWorktreeStatus(worktree) {
-    const statusOutput = await runGit([
-        '-C',
-        worktree.path,
-        'status',
-        '--porcelain',
-    ]);
-    const changes = statusOutput
-        ? statusOutput.split('\n').filter(Boolean).length
-        : 0;
-    let branch = worktree.branch;
-    let detached = worktree.detached;
-    if (!branch) {
-        branch = await getCurrentBranch(worktree.path);
-        detached = branch === null;
-    }
-    return {
-        ...worktree,
-        branch,
-        detached,
-        head: worktree.head ?? (await getHeadShortSha(worktree.path)),
-        state: changes === 0 ? 'clean' : 'dirty',
-        changes,
-    };
-}