@halyard/cli 0.1.2 → 0.2.0

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"}

package/dist/lib/setup-hooks.js

@@ -0,0 +1,276 @@
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { isDeepStrictEqual } from 'node:util';
+import { asObject, formatError, readJsonFile, writeJsonFile } from './config-files.js';
+/**
+ * `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 const HOOK_LAUNCHER_PATH = '.halyard/hook.sh';
+export function launcherScript() {
+    return `#!/bin/sh
+# Generated by \`halyard setup\`. Forwards agent lifecycle hooks to \`halyard hook\`
+# when the Halyard CLI is available, and exits 0 otherwise so the agent is
+# never blocked. Re-run \`halyard setup\` to regenerate.
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+if [ -f "$ROOT/apps/cli/dist/cli.js" ] && grep -q '"name": "@halyard/cli"' "$ROOT/apps/cli/package.json" 2>/dev/null; then
+  exec node "$ROOT/apps/cli/dist/cli.js" hook --root "$ROOT" "$@"
+fi
+BIN="$ROOT/node_modules/.bin/halyard"
+[ -x "$BIN" ] || BIN="$(command -v halyard 2>/dev/null || true)"
+[ -n "$BIN" ] || exit 0
+# Older CLI releases have no \`hook\` command (and answer \`--help\` for any word).
+"$BIN" --help 2>/dev/null | grep -q '^  hook' || exit 0
+exec "$BIN" hook --root "$ROOT" "$@"
+`;
+}
+function hookArgs(client, event) {
+    return `--client ${client} --event ${event}`;
+}
+export function claudeHookSpec() {
+    const command = (event) => `"$CLAUDE_PROJECT_DIR"/${HOOK_LAUNCHER_PATH} ${hookArgs('claude', event)}`;
+    return {
+        start: {
+            type: 'command',
+            command: command('start'),
+            timeout: 10,
+            statusMessage: 'Sweeping unsynced agent sessions...',
+        },
+        end: {
+            type: 'command',
+            command: command('end'),
+            timeout: 60,
+            statusMessage: 'Uploading agent session to Halyard...',
+        },
+    };
+}
+/** Codex caps SessionEnd at 3 seconds, so the end hook detaches. */
+export function codexHookSpec() {
+    const prefix = 'cd "${CODEX_CWD:-$PWD}" && ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)" && "$ROOT"/';
+    return {
+        start: {
+            type: 'command',
+            command: `${prefix}${HOOK_LAUNCHER_PATH} ${hookArgs('codex', 'start')}`,
+            timeout: 10,
+        },
+        end: {
+            type: 'command',
+            command: `${prefix}${HOOK_LAUNCHER_PATH} ${hookArgs('codex', 'end')} --detach`,
+            timeout: 3,
+        },
+    };
+}
+/** Gemini timeouts are milliseconds and entries carry a name. */
+export function geminiHookSpec() {
+    const command = (event) => `"$GEMINI_PROJECT_DIR"/${HOOK_LAUNCHER_PATH} ${hookArgs('gemini', event)}`;
+    return {
+        start: {
+            type: 'command',
+            name: 'halyard-session-sweep',
+            command: command('start'),
+            timeout: 10_000,
+        },
+        end: {
+            type: 'command',
+            name: 'halyard-session-upload',
+            command: command('end'),
+            timeout: 60_000,
+        },
+    };
+}
+function isLauncherEntry(entry) {
+    const command = entry['command'] ?? entry['bash'];
+    return typeof command === 'string' && command.includes(HOOK_LAUNCHER_PATH);
+}
+/** Claude-shaped: event → [{ matcher?, hooks: [entry, ...] }]. */
+function upsertGrouped(groupsValue, hook) {
+    const groups = Array.isArray(groupsValue) ? groupsValue.map(asObject) : [];
+    let placed = false;
+    const next = groups.map((group) => {
+        const entries = Array.isArray(group['hooks']) ? group['hooks'].map(asObject) : [];
+        const index = entries.findIndex(isLauncherEntry);
+        if (index === -1)
+            return group;
+        placed = true;
+        entries[index] = hook;
+        return { ...group, hooks: entries };
+    });
+    if (!placed)
+        next.push({ hooks: [hook] });
+    return next;
+}
+/** Cursor-shaped: event → [entry, ...]. */
+function upsertFlat(listValue, entry) {
+    const list = Array.isArray(listValue) ? listValue.map(asObject) : [];
+    const index = list.findIndex(isLauncherEntry);
+    if (index === -1)
+        list.push(entry);
+    else
+        list[index] = entry;
+    return list;
+}
+/** Merge start/end hooks into a Claude-shaped settings object (Claude, Codex, Gemini). */
+export function mergeLifecycleHooks(input, spec, events = { start: 'SessionStart', end: 'SessionEnd' }) {
+    const settings = asObject(input);
+    const hooks = asObject(settings['hooks']);
+    hooks[events.start] = upsertGrouped(hooks[events.start], spec.start);
+    hooks[events.end] = upsertGrouped(hooks[events.end], spec.end);
+    return { ...settings, hooks };
+}
+export function mergeCursorHooks(input) {
+    const config = asObject(input);
+    const hooks = asObject(config['hooks']);
+    const entry = (event) => ({
+        command: `./${HOOK_LAUNCHER_PATH} ${hookArgs('cursor', event)}`,
+        timeout: event === 'end' ? 60 : 10,
+    });
+    hooks['sessionStart'] = upsertFlat(hooks['sessionStart'], entry('start'));
+    hooks['sessionEnd'] = upsertFlat(hooks['sessionEnd'], entry('end'));
+    const version = typeof config['version'] === 'number' ? config['version'] : 1;
+    return { ...config, version, hooks };
+}
+export function copilotHooksFile() {
+    const entry = (event) => ({
+        type: 'command',
+        bash: `./${HOOK_LAUNCHER_PATH} ${hookArgs('copilot', event)}`,
+        timeoutSec: event === 'end' ? 60 : 10,
+    });
+    return `${JSON.stringify({ version: 1, hooks: { sessionStart: [entry('start')], sessionEnd: [entry('end')] } }, null, 2)}\n`;
+}
+export function grokHooksFile() {
+    const entry = (event) => ({
+        hooks: [
+            {
+                type: 'command',
+                command: `"\${GROK_WORKSPACE_ROOT:-.}"/${HOOK_LAUNCHER_PATH} ${hookArgs('grok', event)}`,
+                timeout: event === 'end' ? 60 : 10,
+            },
+        ],
+    });
+    return `${JSON.stringify({ hooks: { SessionStart: [entry('start')], SessionEnd: [entry('end')] } }, null, 2)}\n`;
+}
+export function opencodePluginFile() {
+    return `// Generated by \`halyard setup\`. OpenCode has no shell-command hooks — extensibility
+// is TypeScript plugins on its event bus — so this bridges its session lifecycle
+// to the same uploader every other client uses: ${HOOK_LAUNCHER_PATH} -> \`halyard hook\`.
+//
+//   * startup      -> sweeps sessions that never uploaded
+//   * session.idle -> end-of-session upload, debounced: OpenCode has no
+//                     session-end event, and the ingest endpoint keeps the FIRST
+//                     upload it sees for a session id, so we wait for the
+//                     session to go quiet before sending it.
+
+const QUIET_MS = 10 * 60 * 1000
+
+interface OpencodeEvent {
+  type: string
+  properties?: { sessionID?: string; info?: { id?: string } }
+}
+
+interface PluginContext {
+  directory: string
+  $: (
+    strings: TemplateStringsArray,
+    ...values: unknown[]
+  ) => {
+    quiet(): { nothrow(): Promise<unknown> }
+  }
+}
+
+export const HalyardSessionUpload = async ({ $, directory }: PluginContext) => {
+  const launcher = \`\${directory}/${HOOK_LAUNCHER_PATH}\`
+  const timers = new Map<string, ReturnType<typeof setTimeout>>()
+
+  const run = async (event: 'start' | 'end') => {
+    const result = $\`\${launcher} --client opencode --event \${event} --detach\`
+    await result.quiet().nothrow()
+  }
+
+  await run('start')
+
+  return {
+    event: async ({ event }: { event: OpencodeEvent }) => {
+      const sessionId = event.properties?.sessionID ?? event.properties?.info?.id ?? 'default'
+      if (event.type === 'session.idle') {
+        const pending = timers.get(sessionId)
+        if (pending) clearTimeout(pending)
+        timers.set(
+          sessionId,
+          setTimeout(() => {
+            timers.delete(sessionId)
+            void run('end')
+          }, QUIET_MS),
+        )
+        return
+      }
+      // Any further activity on the session restarts the quiet period.
+      if (event.type === 'message.updated' || event.type === 'session.updated') {
+        const pending = timers.get(sessionId)
+        if (pending) {
+          clearTimeout(pending)
+          timers.delete(sessionId)
+        }
+      }
+    },
+  }
+}
+`;
+}
+function scaffoldResult(target, status, location, detail) {
+    return { target, status, location, detail };
+}
+/** Write a file we own outright (created or replaced when its content differs). */
+function writeOwnedFile(target, filePath, content, dryRun, executable = false) {
+    const current = existsSync(filePath) ? readFileSync(filePath, 'utf8') : null;
+    if (current === content) {
+        return scaffoldResult(target, 'unchanged', filePath, 'Halyard session-upload hook is already in place.');
+    }
+    if (!dryRun) {
+        mkdirSync(dirname(filePath), { recursive: true });
+        writeFileSync(filePath, content);
+        if (executable)
+            chmodSync(filePath, 0o755);
+    }
+    const verb = current === null ? 'create' : 'update';
+    return scaffoldResult(target, 'updated', filePath, dryRun
+        ? `Would ${verb} the Halyard session-upload hook.`
+        : `${verb === 'create' ? 'Created' : 'Updated'} the Halyard session-upload hook.`);
+}
+/** Merge our entries into a JSON config other tools also write to. */
+function mergeJsonFile(target, filePath, merge, dryRun) {
+    const current = readJsonFile(filePath);
+    if (current instanceof Error)
+        return scaffoldResult(target, 'error', filePath, current.message);
+    let next;
+    try {
+        next = merge(current);
+    }
+    catch (error) {
+        return scaffoldResult(target, 'error', filePath, formatError(error));
+    }
+    if (isDeepStrictEqual(current, next)) {
+        return scaffoldResult(target, 'unchanged', filePath, 'Halyard session-upload hooks are already present.');
+    }
+    if (!dryRun)
+        writeJsonFile(filePath, next);
+    return scaffoldResult(target, 'updated', filePath, dryRun
+        ? 'Would add the Halyard session-upload hooks.'
+        : 'Added the Halyard session-upload hooks.');
+}
+/** Everything except Claude's settings.json, which `runSetup` owns (it also enables the plugin there). */
+export function scaffoldHooks(cwd, options = {}) {
+    const dryRun = options.dryRun ?? false;
+    return [
+        writeOwnedFile('launcher', join(cwd, HOOK_LAUNCHER_PATH), launcherScript(), dryRun, true),
+        mergeJsonFile('codex', join(cwd, '.codex', 'hooks.json'), (c) => mergeLifecycleHooks(c, codexHookSpec()), dryRun),
+        mergeJsonFile('cursor', join(cwd, '.cursor', 'hooks.json'), (c) => mergeCursorHooks(c), dryRun),
+        mergeJsonFile('gemini', join(cwd, '.gemini', 'settings.json'), (c) => mergeLifecycleHooks(c, geminiHookSpec()), dryRun),
+        writeOwnedFile('copilot', join(cwd, '.github', 'hooks', 'halyard-session-upload.json'), copilotHooksFile(), dryRun),
+        writeOwnedFile('opencode', join(cwd, '.opencode', 'plugins', 'halyard-session-upload.ts'), opencodePluginFile(), dryRun),
+        writeOwnedFile('grok', join(cwd, '.grok', 'hooks', 'halyard-session-upload.json'), grokHooksFile(), dryRun),
+    ];
+}
+//# sourceMappingURL=setup-hooks.js.map

package/dist/lib/setup-hooks.js.map

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

package/dist/lib/setup.d.ts

@@ -1,8 +1,9 @@
+import { type HookScaffoldTarget } from './setup-hooks.js';
 export declare const HALYARD_MCP_URL = "https://mcp.usehalyard.ai";
 export declare const HALYARD_CLAUDE_MARKETPLACE_NAME = "halyard-labs";
 export declare const HALYARD_CLAUDE_MARKETPLACE_REPO = "halyard-labs/claude-plugin-marketplace";
 export declare const HALYARD_CLAUDE_PLUGIN_ID = "halyard@halyard-labs";
-export type SetupTarget = 'claude' | 'codex' | 'cursor';
+export type SetupTarget = 'claude' | 'codex' | 'cursor' | HookScaffoldTarget;
 export type SetupStatus = 'updated' | 'unchanged' | 'skipped' | 'error';
 export interface SetupResult {
     target: SetupTarget;
@@ -19,6 +20,8 @@ export interface SetupOptions {
     dryRun?: boolean;
     homeDir?: string;
     runner?: CommandRunner;
+    /** Write the session-upload hooks (launcher + per-client config). Default true. */
+    hooks?: boolean;
 }
 interface ClaudeSettings extends Record<string, unknown> {
     enabledPlugins?: Record<string, unknown>;

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

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/lib/setup.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,eAAe,8BAA8B,CAAA;AAC1D,eAAO,MAAM,+BAA+B,iBAAiB,CAAA;AAC7D,eAAO,MAAM,+BAA+B,2CAA2C,CAAA;AACvF,eAAO,MAAM,wBAAwB,yBAAyB,CAAA;AAE9D,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAA;AACvD,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAA;AAEvE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,WAAW,CAAA;IACnB,KAAK,EAAE,SAAS,GAAG,MAAM,CAAA;IACzB,MAAM,EAAE,WAAW,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB;AAED,UAAU,cAAe,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjD;AAED,UAAU,YAAa,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC;AAED,UAAU,WAAY,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACtC;AAED,wBAAgB,kBAAkB,IAAI,aAAa,CAMlD;AAED,wBAAgB,QAAQ,CAAC,OAAO,GAAE,YAAiB,GAAG,WAAW,EAAE,CAYlE;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;;;;EAMzD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAkBlE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAc9D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAe5D"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/lib/setup.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAA;AAEzB,eAAO,MAAM,eAAe,8BAA8B,CAAA;AAC1D,eAAO,MAAM,+BAA+B,iBAAiB,CAAA;AAC7D,eAAO,MAAM,+BAA+B,2CAA2C,CAAA;AACvF,eAAO,MAAM,wBAAwB,yBAAyB,CAAA;AAE9D,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,kBAAkB,CAAA;AAC5E,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAA;AAEvE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,WAAW,CAAA;IACnB,KAAK,EAAE,SAAS,GAAG,MAAM,CAAA;IACzB,MAAM,EAAE,WAAW,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,mFAAmF;IACnF,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,UAAU,cAAe,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjD;AAED,UAAU,YAAa,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC;AAED,UAAU,WAAY,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACtC;AAED,wBAAgB,kBAAkB,IAAI,aAAa,CAMlD;AAED,wBAAgB,QAAQ,CAAC,OAAO,GAAE,YAAiB,GAAG,WAAW,EAAE,CAmBlE;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;;;;EAMzD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAkBlE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAc9D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAe5D"}

package/dist/lib/setup.js

@@ -4,6 +4,8 @@ import { homedir } from 'node:os';
 import { dirname, join, relative, resolve } from 'node:path';
 import { isDeepStrictEqual } from 'node:util';
 import { parse as parseToml, stringify as stringifyToml } from 'smol-toml';
+import { asObject, formatError, readJsonFile, writeJsonFile } from './config-files.js';
+import { claudeHookSpec, mergeLifecycleHooks, scaffoldHooks, } from './setup-hooks.js';
 export const HALYARD_MCP_URL = 'https://mcp.usehalyard.ai';
 export const HALYARD_CLAUDE_MARKETPLACE_NAME = 'halyard-labs';
 export const HALYARD_CLAUDE_MARKETPLACE_REPO = 'halyard-labs/claude-plugin-marketplace';
@@ -20,12 +22,19 @@ export function runSetup(options = {}) {
     const dryRun = options.dryRun ?? false;
     const homeDir = options.homeDir ?? homedir();
     const runner = options.runner ?? createSystemRunner();
+    const hooks = options.hooks ?? true;
     const paths = getSetupPaths(cwd, homeDir);
-    return [
-        setupClaudeProject(paths.claudeProject, dryRun),
+    const results = [
+        setupClaudeProject(paths.claudeProject, dryRun, hooks),
         setupCursorProject(paths.cursorProject, dryRun),
         setupCodexUser(paths.codexUser, dryRun, runner),
     ];
+    if (hooks) {
+        for (const entry of scaffoldHooks(cwd, { dryRun })) {
+            results.push({ ...entry, scope: 'project' });
+        }
+    }
+    return results;
 }
 export function getSetupPaths(cwd, homeDir) {
     return {
@@ -78,21 +87,24 @@ export function mergeCodexConfig(input) {
         mcp_servers: mcpServers,
     };
 }
-function setupClaudeProject(filePath, dryRun) {
+function setupClaudeProject(filePath, dryRun, hooks) {
     const current = readJsonFile(filePath);
     if (current instanceof Error) {
         return result('claude', 'project', 'error', filePath, current.message);
     }
-    const next = mergeClaudeSettings(current);
+    let next = mergeClaudeSettings(current);
+    if (hooks)
+        next = mergeLifecycleHooks(next, claudeHookSpec());
+    const what = hooks
+        ? 'the Halyard marketplace, the project plugin and the session-upload hooks'
+        : 'the Halyard marketplace and the project plugin';
     if (isDeepStrictEqual(current, next)) {
-        return result('claude', 'project', 'unchanged', filePath, 'Halyard plugin and marketplace are already scaffolded.');
+        return result('claude', 'project', 'unchanged', filePath, `Already scaffolded: ${what}.`);
     }
     if (!dryRun) {
         writeJsonFile(filePath, next);
     }
-    return result('claude', 'project', 'updated', filePath, dryRun
-        ? 'Would add the Halyard marketplace and enable the project plugin.'
-        : 'Added the Halyard marketplace and enabled the project plugin.');
+    return result('claude', 'project', 'updated', filePath, dryRun ? `Would add ${what}.` : `Added ${what}.`);
 }
 function setupCursorProject(filePath, dryRun) {
     const current = readJsonFile(filePath);
@@ -130,20 +142,6 @@ function setupCodexUser(filePath, dryRun, runner) {
         ? 'Would add the Halyard MCP server to Codex user config.'
         : 'Added the Halyard MCP server to Codex user config.');
 }
-function readJsonFile(filePath) {
-    if (!existsSync(filePath))
-        return {};
-    try {
-        return JSON.parse(readFileSync(filePath, 'utf8'));
-    }
-    catch (error) {
-        return new Error(`Could not parse JSON at ${filePath}: ${formatError(error)}`);
-    }
-}
-function writeJsonFile(filePath, value) {
-    mkdirSync(dirname(filePath), { recursive: true });
-    writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\n`);
-}
 function readTomlFile(filePath) {
     if (!existsSync(filePath))
         return {};
@@ -158,15 +156,6 @@ function writeTomlFile(filePath, value) {
     mkdirSync(dirname(filePath), { recursive: true });
     writeFileSync(filePath, `${stringifyToml(asObject(value))}\n`);
 }
-function asObject(value) {
-    if (value && typeof value === 'object' && !Array.isArray(value)) {
-        return { ...value };
-    }
-    return {};
-}
-function formatError(error) {
-    return error instanceof Error ? error.message : String(error);
-}
 function result(target, scope, status, filePath, detail) {
     return {
         target,