@halyard/cli 0.1.1 → 0.2.0

package/dist/lib/output.js.map

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

package/dist/lib/preflight.d.ts

@@ -0,0 +1,35 @@
+import type { RepoBinding } from './repo-binding.js';
+export interface TargetOrg {
+    /**
+     * Bucket key for org-scoped sync state: the orgId for OAuth chains, or
+     * `api-key:<keyId>` for sk_ keys (whose org the API does not expose;
+     * server-side ingest dedupe keeps re-uploads harmless either way).
+     */
+    stateKey: string;
+    /** Org slug when resolvable (OAuth); null for sk_ API keys. */
+    slug: string | null;
+    /** Human-readable destination, e.g. `Halyard Studio (halyard-studio)`. */
+    label: string;
+}
+/**
+ * Resolve which organization uploads will land in.
+ * sk_ API keys authenticate against /api/v1/api-keys/me (the OAuth-only
+ * /api/v1/me 401s for them); OAuth chains use /api/v1/me.
+ */
+export declare function resolveTargetOrg(apiUrl: string): Promise<TargetOrg>;
+/**
+ * Upload preflight shared by `sync` and `push`: resolve the target org, print
+ * where uploads are going, and hard-fail (throw) when the repo binding and the
+ * credentials disagree about the org. Runs before any upload, including
+ * --dry-run.
+ */
+export declare function runPreflight(options: {
+    apiUrl: string;
+    binding: RepoBinding | null;
+    /** What is being uploaded: repo root, `all sessions`, or a file path. */
+    scopeLabel: string;
+    verb?: string;
+    /** Where the `Syncing … → org` line goes (stderr for --json callers). Default: stdout. */
+    print?: (line: string) => void;
+}): Promise<TargetOrg>;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/lib/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/lib/preflight.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB,+DAA+D;IAC/D,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAA;CACd;AAWD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CA0BzE;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;IAC3B,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0FAA0F;IAC1F,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC/B,GAAG,OAAO,CAAC,SAAS,CAAC,CAsBrB"}

package/dist/lib/preflight.js

@@ -0,0 +1,54 @@
+import { apiFetch } from './http.js';
+import { getCredentials } from './auth.js';
+/**
+ * Resolve which organization uploads will land in.
+ * sk_ API keys authenticate against /api/v1/api-keys/me (the OAuth-only
+ * /api/v1/me 401s for them); OAuth chains use /api/v1/me.
+ */
+export async function resolveTargetOrg(apiUrl) {
+    const creds = getCredentials();
+    if (!creds) {
+        throw new Error('Not authenticated. Run `halyard login` or set the HALYARD_TOKEN environment variable.');
+    }
+    if (creds.accessToken.startsWith('sk_halyard_')) {
+        const key = await apiFetch(apiUrl, '/api/v1/api-keys/me');
+        return {
+            stateKey: `api-key:${key.id}`,
+            slug: null,
+            label: `organization bound to API key ${key.id}`,
+        };
+    }
+    const me = await apiFetch(apiUrl, '/api/v1/me');
+    if (!me.organization) {
+        throw new Error('Your account has no active organization. Run `halyard orgs list`.');
+    }
+    return {
+        stateKey: me.organization.id,
+        slug: me.organization.slug,
+        label: `${me.organization.name} (${me.organization.slug})`,
+    };
+}
+/**
+ * Upload preflight shared by `sync` and `push`: resolve the target org, print
+ * where uploads are going, and hard-fail (throw) when the repo binding and the
+ * credentials disagree about the org. Runs before any upload, including
+ * --dry-run.
+ */
+export async function runPreflight(options) {
+    const { apiUrl, binding, scopeLabel, verb = 'Syncing', print = console.log } = options;
+    const target = await resolveTargetOrg(apiUrl);
+    print(`${verb} ${scopeLabel} → ${target.label}`);
+    if (binding) {
+        if (target.slug === null) {
+            console.error(`Warning: this repo is bound to "${binding.org}" but an API key's organization ` +
+                `cannot be verified from the CLI - uploads go to the org the key belongs to.`);
+        }
+        else if (target.slug !== binding.org) {
+            throw new Error(`Organization mismatch: your credentials are for "${target.slug}" but this repo is ` +
+                `bound to "${binding.org}" (${binding.rootDir}/.halyard.json).\n` +
+                `Run \`halyard login\` inside this repo to store credentials for "${binding.org}".`);
+        }
+    }
+    return target;
+}
+//# sourceMappingURL=preflight.js.map

package/dist/lib/preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../src/lib/preflight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAyB1C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAc;IACnD,MAAM,KAAK,GAAG,cAAc,EAAE,CAAA;IAC9B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,uFAAuF,CACxF,CAAA;IACH,CAAC;IAED,IAAI,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAChD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAmB,MAAM,EAAE,qBAAqB,CAAC,CAAA;QAC3E,OAAO;YACL,QAAQ,EAAE,WAAW,GAAG,CAAC,EAAE,EAAE;YAC7B,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,iCAAiC,GAAG,CAAC,EAAE,EAAE;SACjD,CAAA;IACH,CAAC;IAED,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAgB,MAAM,EAAE,YAAY,CAAC,CAAA;IAC9D,IAAI,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAA;IACtF,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE;QAC5B,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI;QAC1B,KAAK,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,KAAK,EAAE,CAAC,YAAY,CAAC,IAAI,GAAG;KAC3D,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAQlC;IACC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,GAAG,SAAS,EAAE,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,CAAA;IAEtF,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAA;IAC7C,KAAK,CAAC,GAAG,IAAI,IAAI,UAAU,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,CAAA;IAEhD,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACzB,OAAO,CAAC,KAAK,CACX,mCAAmC,OAAO,CAAC,GAAG,kCAAkC;gBAC9E,6EAA6E,CAChF,CAAA;QACH,CAAC;aAAM,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CACb,oDAAoD,MAAM,CAAC,IAAI,qBAAqB;gBAClF,aAAa,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,OAAO,oBAAoB;gBACjE,oEAAoE,OAAO,CAAC,GAAG,IAAI,CACtF,CAAA;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/lib/repo-binding.d.ts

@@ -0,0 +1,43 @@
+export declare const REPO_BINDING_FILENAME = ".halyard.json";
+export interface RepoBinding {
+    /** Organization slug this repo is bound to. */
+    org: string;
+    /** Directory containing the binding file (main repo root for worktrees). */
+    rootDir: string;
+}
+/** Reset the per-process binding cache (tests). */
+export declare function clearRepoBindingCache(): void;
+/**
+ * Find the `.halyard.json` repo binding for a directory.
+ *
+ * Walks up from `startDir` looking for the binding file. If none is found and
+ * the directory is inside a git repo, falls back to the MAIN repo root (parent
+ * of `git rev-parse --git-common-dir`) so detached worktrees (~/.codex/worktrees
+ * and friends) inherit the binding committed at the main checkout.
+ */
+export declare function findRepoBinding(startDir?: string): RepoBinding | null;
+export interface WriteBindingResult {
+    status: 'created' | 'updated' | 'unchanged';
+    filePath: string;
+    org: string;
+}
+/**
+ * Write a `.halyard.json` binding at the git toplevel of `cwd`.
+ * Throws when not inside a git repo, or when an existing binding names a
+ * different org and `force` is not set. Extra fields in an existing file are
+ * preserved on rebind.
+ */
+export declare function writeRepoBinding(options: {
+    org: string;
+    cwd?: string;
+    force?: boolean;
+    dryRun?: boolean;
+}): WriteBindingResult;
+/** Resolve the git toplevel of a directory, or null when not in a repo. */
+export declare function gitToplevel(dir: string): string | null;
+/**
+ * Resolve the MAIN repo root for a directory via `git rev-parse --git-common-dir`.
+ * Returns null when git is unavailable or the directory is not inside a repo.
+ */
+export declare function gitMainRepoRoot(dir: string): string | null;
+//# sourceMappingURL=repo-binding.d.ts.map

package/dist/lib/repo-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-binding.d.ts","sourceRoot":"","sources":["../../src/lib/repo-binding.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qBAAqB,kBAAkB,CAAA;AAEpD,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAA;IACX,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAA;CAChB;AAID,mDAAmD;AACnD,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,GAAE,MAAsB,GAAG,WAAW,GAAG,IAAI,CAOpF;AA0CD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAA;IAC3C,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,GAAG,kBAAkB,CAmDrB;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYtD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgB1D"}

package/dist/lib/repo-binding.js

@@ -0,0 +1,158 @@
+import { spawnSync } from 'node:child_process';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { basename, dirname, join, resolve } from 'node:path';
+export const REPO_BINDING_FILENAME = '.halyard.json';
+const bindingCache = new Map();
+/** Reset the per-process binding cache (tests). */
+export function clearRepoBindingCache() {
+    bindingCache.clear();
+}
+/**
+ * Find the `.halyard.json` repo binding for a directory.
+ *
+ * Walks up from `startDir` looking for the binding file. If none is found and
+ * the directory is inside a git repo, falls back to the MAIN repo root (parent
+ * of `git rev-parse --git-common-dir`) so detached worktrees (~/.codex/worktrees
+ * and friends) inherit the binding committed at the main checkout.
+ */
+export function findRepoBinding(startDir = process.cwd()) {
+    const start = resolve(startDir);
+    const cached = bindingCache.get(start);
+    if (cached !== undefined)
+        return cached;
+    const binding = locateBinding(start);
+    bindingCache.set(start, binding);
+    return binding;
+}
+function locateBinding(start) {
+    let dir = start;
+    for (;;) {
+        const binding = readBindingFile(dir);
+        if (binding)
+            return binding;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    // Detached worktree fallback: the binding file lives in the main checkout,
+    // which is not an ancestor of the worktree directory.
+    const mainRoot = gitMainRepoRoot(start);
+    if (mainRoot && mainRoot !== start) {
+        return readBindingFile(mainRoot);
+    }
+    return null;
+}
+/**
+ * Parse a `.halyard.json` in `dir`. Unknown extra fields are tolerated;
+ * invalid JSON or a missing `org` field is treated as not found (with a
+ * one-line warning so a broken binding is not silently ignored).
+ */
+function readBindingFile(dir) {
+    const filePath = join(dir, REPO_BINDING_FILENAME);
+    if (!existsSync(filePath))
+        return null;
+    try {
+        const parsed = JSON.parse(readFileSync(filePath, 'utf-8'));
+        if (typeof parsed.org === 'string' && parsed.org.trim().length > 0) {
+            return { org: parsed.org.trim(), rootDir: dir };
+        }
+        console.error(`Warning: ${filePath} has no "org" field - ignoring repo binding.`);
+    }
+    catch {
+        console.error(`Warning: ${filePath} is not valid JSON - ignoring repo binding.`);
+    }
+    return null;
+}
+/**
+ * Write a `.halyard.json` binding at the git toplevel of `cwd`.
+ * Throws when not inside a git repo, or when an existing binding names a
+ * different org and `force` is not set. Extra fields in an existing file are
+ * preserved on rebind.
+ */
+export function writeRepoBinding(options) {
+    const { org, cwd = process.cwd(), force = false, dryRun = false } = options;
+    const toplevel = gitToplevel(cwd);
+    if (!toplevel) {
+        throw new Error('Not inside a git repository. Run `halyard setup --org` from a repo, or create .halyard.json manually.');
+    }
+    const filePath = join(toplevel, REPO_BINDING_FILENAME);
+    let extraFields = {};
+    let status = 'created';
+    if (existsSync(filePath)) {
+        let existing = null;
+        try {
+            const parsed = JSON.parse(readFileSync(filePath, 'utf-8'));
+            if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                existing = parsed;
+            }
+        }
+        catch {
+            // fall through - unparseable counts as a conflicting file
+        }
+        const existingOrg = typeof existing?.['org'] === 'string' ? existing['org'] : null;
+        if (existingOrg === org) {
+            return { status: 'unchanged', filePath, org };
+        }
+        if (!force) {
+            throw new Error(existingOrg
+                ? `${filePath} already binds this repo to "${existingOrg}". Pass --force to rebind to "${org}".`
+                : `${filePath} exists but has no valid "org" field. Pass --force to overwrite.`);
+        }
+        if (existing) {
+            const { org: _org, ...rest } = existing;
+            extraFields = rest;
+        }
+        status = 'updated';
+    }
+    if (!dryRun) {
+        const hasExtras = Object.keys(extraFields).length > 0;
+        const content = hasExtras
+            ? `${JSON.stringify({ org, ...extraFields }, null, 2)}\n`
+            : `{ "org": ${JSON.stringify(org)} }\n`;
+        writeFileSync(filePath, content);
+    }
+    clearRepoBindingCache();
+    return { status, filePath, org };
+}
+/** Resolve the git toplevel of a directory, or null when not in a repo. */
+export function gitToplevel(dir) {
+    try {
+        const res = spawnSync('git', ['-C', dir, 'rev-parse', '--show-toplevel'], {
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        if (res.error || res.status !== 0)
+            return null;
+        const out = res.stdout.trim();
+        return out.length > 0 ? resolve(out) : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve the MAIN repo root for a directory via `git rev-parse --git-common-dir`.
+ * Returns null when git is unavailable or the directory is not inside a repo.
+ */
+export function gitMainRepoRoot(dir) {
+    try {
+        const res = spawnSync('git', ['-C', dir, 'rev-parse', '--git-common-dir'], {
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        if (res.error || res.status !== 0)
+            return null;
+        const out = res.stdout.trim();
+        if (!out)
+            return null;
+        // Relative when run from the toplevel (".git"), absolute from subdirs and
+        // worktrees - resolve against the queried dir to normalize.
+        const commonDir = resolve(dir, out);
+        return basename(commonDir) === '.git' ? dirname(commonDir) : commonDir;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=repo-binding.js.map

package/dist/lib/repo-binding.js.map

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

package/dist/lib/repo-identity.d.ts

@@ -0,0 +1,29 @@
+export interface RepoIdentity {
+    /** Absolute MAIN repo root (parent of the git common dir; worktrees collapse here). */
+    rootDir: string;
+    /** Normalized remote.origin.url, or null when the repo has no origin. */
+    remote: string | null;
+}
+/** Reset the per-process identity cache (tests). */
+export declare function clearRepoIdentityCache(): void;
+/**
+ * Resolve the repo identity for a directory: main-repo root via
+ * `git rev-parse --git-common-dir` plus the normalized origin remote.
+ * Nonexistent dirs and git failures resolve to null (unresolved).
+ * Results are cached per dir for the life of the process.
+ */
+export declare function resolveRepoIdentity(dir: string): RepoIdentity | null;
+/**
+ * Normalize a git remote URL so transport variants compare equal:
+ * `git@github.com:ajust-au/agent.git` === `https://github.com/ajust-au/agent`.
+ * Lowercases the host, strips protocol/credentials/port, and trims a
+ * trailing `.git` / slashes. Returns null when unparseable.
+ */
+export declare function normalizeRemoteUrl(url: string): string | null;
+/**
+ * Do two identities point at the same repository?
+ * Common-dir (main root) equality wins; otherwise fall back to remote
+ * equality, but only when both remotes are defined.
+ */
+export declare function sameRepo(a: RepoIdentity | null, b: RepoIdentity | null): boolean;
+//# sourceMappingURL=repo-identity.d.ts.map

package/dist/lib/repo-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-identity.d.ts","sourceRoot":"","sources":["../../src/lib/repo-identity.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,uFAAuF;IACvF,OAAO,EAAE,MAAM,CAAA;IACf,yEAAyE;IACzE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAID,oDAAoD;AACpD,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAOpE;AAyCD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8B7D;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI,EAAE,CAAC,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAKhF"}

package/dist/lib/repo-identity.js

@@ -0,0 +1,113 @@
+import { spawnSync } from 'node:child_process';
+import { existsSync, realpathSync } from 'node:fs';
+import { basename, dirname, resolve } from 'node:path';
+const identityCache = new Map();
+/** Reset the per-process identity cache (tests). */
+export function clearRepoIdentityCache() {
+    identityCache.clear();
+}
+/**
+ * Resolve the repo identity for a directory: main-repo root via
+ * `git rev-parse --git-common-dir` plus the normalized origin remote.
+ * Nonexistent dirs and git failures resolve to null (unresolved).
+ * Results are cached per dir for the life of the process.
+ */
+export function resolveRepoIdentity(dir) {
+    const key = resolve(dir);
+    const cached = identityCache.get(key);
+    if (cached !== undefined)
+        return cached;
+    const identity = computeIdentity(key);
+    identityCache.set(key, identity);
+    return identity;
+}
+function computeIdentity(dir) {
+    if (!existsSync(dir))
+        return null;
+    const commonDirOut = git(dir, ['rev-parse', '--git-common-dir']);
+    if (!commonDirOut)
+        return null;
+    const commonDir = resolve(dir, commonDirOut);
+    // Canonicalize so a session recorded under a symlinked path (macOS
+    // /var → /private/var, ~/repos symlinks) still matches the binding root,
+    // which git reports fully resolved.
+    const rootDir = canonical(basename(commonDir) === '.git' ? dirname(commonDir) : commonDir);
+    const remoteOut = git(dir, ['config', '--get', 'remote.origin.url']);
+    const remote = remoteOut ? normalizeRemoteUrl(remoteOut) : null;
+    return { rootDir, remote };
+}
+function canonical(path) {
+    try {
+        return realpathSync(path);
+    }
+    catch {
+        return path;
+    }
+}
+function git(dir, args) {
+    try {
+        const res = spawnSync('git', ['-C', dir, ...args], {
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        if (res.error || res.status !== 0)
+            return null;
+        const out = res.stdout.trim();
+        return out.length > 0 ? out : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Normalize a git remote URL so transport variants compare equal:
+ * `git@github.com:ajust-au/agent.git` === `https://github.com/ajust-au/agent`.
+ * Lowercases the host, strips protocol/credentials/port, and trims a
+ * trailing `.git` / slashes. Returns null when unparseable.
+ */
+export function normalizeRemoteUrl(url) {
+    const trimmed = url.trim();
+    if (!trimmed)
+        return null;
+    let host;
+    let path;
+    // Protocol form: https://host/path, ssh://git@host:port/path, git://host/path
+    const protoMatch = /^[a-z][a-z0-9+.-]*:\/\/(?:[^@/]+@)?([^/:]+)(?::\d+)?\/(.*)$/i.exec(trimmed);
+    // SCP-like form: git@host:path
+    const scpMatch = /^(?:[^@/]+@)?([^/:]+):(.*)$/.exec(trimmed);
+    if (protoMatch) {
+        host = protoMatch[1];
+        path = protoMatch[2];
+    }
+    else if (scpMatch) {
+        host = scpMatch[1];
+        path = scpMatch[2];
+    }
+    else {
+        return null;
+    }
+    if (!host || path === undefined)
+        return null;
+    const cleanPath = path
+        .replace(/\.git$/i, '')
+        .replace(/\/+$/, '')
+        .replace(/^\/+/, '');
+    if (!cleanPath)
+        return null;
+    return `${host.toLowerCase()}/${cleanPath}`;
+}
+/**
+ * Do two identities point at the same repository?
+ * Common-dir (main root) equality wins; otherwise fall back to remote
+ * equality, but only when both remotes are defined.
+ */
+export function sameRepo(a, b) {
+    if (!a || !b)
+        return false;
+    if (a.rootDir === b.rootDir)
+        return true;
+    if (a.remote !== null && b.remote !== null)
+        return a.remote === b.remote;
+    return false;
+}
+//# sourceMappingURL=repo-identity.js.map

package/dist/lib/repo-identity.js.map

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

package/dist/lib/setup-hooks.d.ts

@@ -0,0 +1,41 @@
+/**
+ * `halyard setup` scaffolding for session upload: a tiny launcher plus one
+ * lifecycle-hook config per client, all pointing at `halyard hook`.
+ *
+ * Merges are idempotent and keyed on the launcher path, so re-running setup
+ * (or after a template change) updates our entries and leaves everything else alone.
+ */
+export declare const HOOK_LAUNCHER_PATH = ".halyard/hook.sh";
+export type HookScaffoldTarget = 'launcher' | 'codex' | 'cursor' | 'gemini' | 'copilot' | 'opencode' | 'grok';
+export type HookScaffoldStatus = 'updated' | 'unchanged' | 'error';
+export interface HookScaffoldResult {
+    target: HookScaffoldTarget;
+    status: HookScaffoldStatus;
+    location: string;
+    detail: string;
+}
+export interface HookScaffoldOptions {
+    dryRun?: boolean;
+}
+export interface LifecycleHookSpec {
+    start: Record<string, unknown>;
+    end: Record<string, unknown>;
+}
+export declare function launcherScript(): string;
+export declare function claudeHookSpec(): LifecycleHookSpec;
+/** Codex caps SessionEnd at 3 seconds, so the end hook detaches. */
+export declare function codexHookSpec(): LifecycleHookSpec;
+/** Gemini timeouts are milliseconds and entries carry a name. */
+export declare function geminiHookSpec(): LifecycleHookSpec;
+/** Merge start/end hooks into a Claude-shaped settings object (Claude, Codex, Gemini). */
+export declare function mergeLifecycleHooks(input: unknown, spec: LifecycleHookSpec, events?: {
+    start: string;
+    end: string;
+}): Record<string, unknown>;
+export declare function mergeCursorHooks(input: unknown): Record<string, unknown>;
+export declare function copilotHooksFile(): string;
+export declare function grokHooksFile(): string;
+export declare function opencodePluginFile(): string;
+/** Everything except Claude's settings.json, which `runSetup` owns (it also enables the plugin there). */
+export declare function scaffoldHooks(cwd: string, options?: HookScaffoldOptions): HookScaffoldResult[];
+//# sourceMappingURL=setup-hooks.d.ts.map

package/dist/lib/setup-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-hooks.d.ts","sourceRoot":"","sources":["../../src/lib/setup-hooks.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AAEH,eAAO,MAAM,kBAAkB,qBAAqB,CAAA;AAEpD,MAAM,MAAM,kBAAkB,GAC1B,UAAU,GACV,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,UAAU,GACV,MAAM,CAAA;AACV,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAA;AAElE,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,kBAAkB,CAAA;IAC1B,MAAM,EAAE,kBAAkB,CAAA;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC7B;AAED,wBAAgB,cAAc,IAAI,MAAM,CAgBvC;AAMD,wBAAgB,cAAc,IAAI,iBAAiB,CAiBlD;AAED,oEAAoE;AACpE,wBAAgB,aAAa,IAAI,iBAAiB,CAejD;AAED,iEAAiE;AACjE,wBAAgB,cAAc,IAAI,iBAAiB,CAiBlD;AAgCD,0FAA0F;AAC1F,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,iBAAiB,EACvB,MAAM,GAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAiD,GACpF,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWxE;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAOzC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAWtC;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAkE3C;AA8ED,0GAA0G;AAC1G,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,mBAAwB,GAChC,kBAAkB,EAAE,CAoCtB"}