ctxr-cli 0.33.0 → 0.34.0

package/dist/core/approval/session-marker.js

@@ -0,0 +1,146 @@
+import { mountingStoreOf } from '../shared-stores.js';
+import { githubRepositoryOf } from '../forge/credentials.js';
+import { worktreeDirNameFor } from '../session.js';
+import { marker, parseMarker } from './decision.js';
+/**
+ * approve-sessions-across-stores (design.md D1, D2; the second critique's
+ * revisions 2 and 3): a session's identity is its home store's forge slug
+ * (`owner/repo`) and the home session's branch. It is derived from the
+ * session's own branch, worktree and repository alone — no identity file.
+ *
+ * A joined session (one started inside a mount with `ctxr session start
+ * --joins`) carries its home in its branch, `<prefix><owner>/<repo>/<home
+ * branch without its prefix>`, and in its worktree directory, where `/` cannot
+ * appear: `<prefix as a directory name><owner>--<repo>--<home branch without
+ * its prefix>`. A GitHub owner never contains `--`, and a generated session
+ * name never does, so the directory name splits back unambiguously. The
+ * directory keeps the identity after `ctxr session submit --branch` renames
+ * the branch.
+ *
+ * The pull request marker, appended by `ctxr session submit`, is what groups a
+ * session's pull requests across stores; branch names never are.
+ */
+export const SESSION_MARKER = 'ctxr-session';
+const SLUG = /^[^/\s]+\/[^/\s]+$/;
+const NO_SPACE = /^\S+$/;
+/** One string per session, for grouping and comparison. Branches cannot contain `:`, so it is unambiguous. */
+export function sessionKey(identity) {
+    return `${identity.home}:${identity.branch}`;
+}
+export function parseSessionKey(key) {
+    const at = key.lastIndexOf(':');
+    if (at <= 0)
+        return null;
+    const home = key.slice(0, at);
+    const branch = key.slice(at + 1);
+    return SLUG.test(home) && branch !== '' && NO_SPACE.test(branch) ? { home, branch } : null;
+}
+export function sessionsEqual(a, b) {
+    return a !== null && b !== null && a.home === b.home && a.branch === b.branch;
+}
+/** The marker `ctxr session submit` appends to a pull request body. */
+export function sessionMarker(identity) {
+    return marker(SESSION_MARKER, { home: identity.home, branch: identity.branch });
+}
+/**
+ * The session a pull request body names, or null — a body with no well-formed
+ * marker ending it is a session of its own (write-lifecycle spec). Like the
+ * decision marker, only a marker that ends the body counts.
+ */
+export function parseSessionMarker(body) {
+    const fields = parseMarker(SESSION_MARKER, body);
+    if (fields === null)
+        return null;
+    const { home, branch } = fields;
+    if (home === undefined || !SLUG.test(home) || branch === undefined || branch === '' || !NO_SPACE.test(branch))
+        return null;
+    return { home, branch };
+}
+/** Any session marker anywhere in `body`, well-formed or not — what `ctxr session submit` refuses in an agent's body. */
+export function findSessionMarker(body) {
+    const found = new RegExp(`<!--\\s*${SESSION_MARKER}\\b[^>]*?-->`).exec(body);
+    return found === null ? null : found[0];
+}
+/**
+ * The forge slug of a remote URL: GitHub's `owner/repo` for a github.com URL,
+ * and otherwise the URL's last two path segments without `.git` — the same
+ * shape for a mirror, a proxy, or a test's bare repository.
+ */
+export function forgeSlugOf(remoteUrl) {
+    const github = githubRepositoryOf(remoteUrl);
+    if (github !== null)
+        return github;
+    const segments = remoteUrl
+        .trim()
+        .replace(/\/+$/, '')
+        .replace(/\.git$/, '')
+        .split(/[/:\\]/)
+        .filter((s) => s !== '');
+    if (segments.length < 2)
+        return null;
+    const slug = `${segments[segments.length - 2]}/${segments[segments.length - 1]}`;
+    return SLUG.test(slug) ? slug : null;
+}
+/** The forge slug of the repository `cwd` is in, from its `origin`; null without one. */
+export async function repositorySlug(git, cwd) {
+    const remote = await git.run(['remote', 'get-url', 'origin'], { cwd, allowFailure: true });
+    return remote.exitCode === 0 ? forgeSlugOf(remote.stdout) : null;
+}
+function withoutPrefix(branch, prefix) {
+    return branch.startsWith(prefix) ? branch.slice(prefix.length) : branch;
+}
+/** write-lifecycle spec: the joined session's branch — this store's prefix, the home slug, the home branch without its prefix. */
+export function joinedBranchName(prefix, home, homePrefix) {
+    return `${prefix}${home.home}/${withoutPrefix(home.branch, homePrefix)}`;
+}
+/** The joined session's worktree directory name, which splits back into its home (see the module comment). */
+export function joinedWorktreeName(prefix, home, homePrefix) {
+    const [owner, repo] = home.home.split('/');
+    return `${worktreeDirNameFor(prefix)}${owner}--${repo}--${worktreeDirNameFor(withoutPrefix(home.branch, homePrefix))}`;
+}
+/**
+ * A session's identity, derived from its worktree and branch alone. The
+ * worktree name decides first, because `ctxr session submit --branch` can
+ * rename the branch to anything, including a name shaped like a joined one,
+ * while the worktree keeps the name it was started with: a joined worktree
+ * name carries its home, and any other session worktree is its own home. Only
+ * a worktree whose name ctxr did not give falls back to the branch.
+ */
+export function sessionIdentityFor(input) {
+    const dirPrefix = worktreeDirNameFor(input.prefix);
+    if (input.worktreeName.startsWith(dirPrefix) && input.worktreeName.length > dirPrefix.length) {
+        const rest = input.worktreeName.slice(dirPrefix.length);
+        const first = rest.indexOf('--');
+        const last = rest.lastIndexOf('--');
+        if (first > 0 && last > first + 2 && last + 2 < rest.length) {
+            return { home: `${rest.slice(0, first)}/${rest.slice(first + 2, last)}`, branch: `${input.homePrefix}${rest.slice(last + 2)}` };
+        }
+        if (input.ownSlug === null)
+            return null;
+        return { home: input.ownSlug, branch: `${input.prefix}${rest}` };
+    }
+    if (input.branch.startsWith(input.prefix)) {
+        const joined = /^([^/]+)\/([^/]+)\/(.+)$/.exec(input.branch.slice(input.prefix.length));
+        if (joined !== null)
+            return { home: `${joined[1]}/${joined[2]}`, branch: `${input.homePrefix}${joined[3]}` };
+    }
+    if (input.ownSlug === null)
+        return null;
+    return { home: input.ownSlug, branch: input.branch };
+}
+/** The identity of the session checked out in `worktreePath`, reading only its repository and, for a mount, the mounting store's configuration. */
+export async function identityOfWorktree(git, config, worktreePath, worktreeName, branch) {
+    const mounting = await mountingStoreOf(worktreePath);
+    return sessionIdentityFor({
+        prefix: config.session.branch_prefix,
+        homePrefix: mounting?.config.session.branch_prefix ?? config.session.branch_prefix,
+        ownSlug: await repositorySlug(git, worktreePath),
+        worktreeName,
+        branch,
+    });
+}
+/** The approval route name of a session homed in a store: its home branch as a worktree directory name. */
+export function sessionRouteName(identity) {
+    return worktreeDirNameFor(identity.branch);
+}
+//# sourceMappingURL=session-marker.js.map

package/dist/core/approval/session-marker.js.map

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

package/dist/core/approval/store-forges.d.ts

@@ -0,0 +1,15 @@
+import type { RunEnv } from '../env.js';
+import { type ForgeClient } from '../forge/github.js';
+import type { ForgeFor } from './session-group.js';
+/**
+ * approve-sessions-across-stores (proposal Impact): every store a session
+ * touches is read and written with the same recording identity — the same
+ * credential source, addressed at the mount's own repository through its
+ * clone's `origin`. `CONTEXTURE_GITHUB_REPOSITORY` names the home store's
+ * repository only, so it is not passed on to a mount.
+ *
+ * When a command was handed a forge client (a test's), mounts get a plain
+ * `gh` client in their own clone, so they are still addressed by their origin.
+ */
+export declare function storeForges(env: Pick<RunEnv, 'env' | 'git' | 'now'>, injected?: ForgeClient): ForgeFor;
+//# sourceMappingURL=store-forges.d.ts.map

package/dist/core/approval/store-forges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-forges.d.ts","sourceRoot":"","sources":["../../../src/core/approval/store-forges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,QAAQ,CAmBtG"}

package/dist/core/approval/store-forges.js

@@ -0,0 +1,33 @@
+import { APP_REPOSITORY_VAR, credentialsFor, ghCredentials } from '../forge/credentials.js';
+import { createGhForgeClient } from '../forge/github.js';
+/**
+ * approve-sessions-across-stores (proposal Impact): every store a session
+ * touches is read and written with the same recording identity — the same
+ * credential source, addressed at the mount's own repository through its
+ * clone's `origin`. `CONTEXTURE_GITHUB_REPOSITORY` names the home store's
+ * repository only, so it is not passed on to a mount.
+ *
+ * When a command was handed a forge client (a test's), mounts get a plain
+ * `gh` client in their own clone, so they are still addressed by their origin.
+ */
+export function storeForges(env, injected) {
+    const cache = new Map();
+    return (root, mount) => {
+        let client = cache.get(root);
+        if (client === undefined) {
+            client = (async () => {
+                if (injected !== undefined) {
+                    const credentials = ghCredentials(env.env);
+                    return { forge: createGhForgeClient(root, credentials), credentials };
+                }
+                const scoped = mount ? { ...env, env: { ...env.env, [APP_REPOSITORY_VAR]: undefined } } : env;
+                const credentials = await credentialsFor(scoped, root);
+                return { forge: createGhForgeClient(root, credentials), credentials };
+            })();
+            cache.set(root, client);
+            client.catch(() => cache.delete(root));
+        }
+        return client;
+    };
+}
+//# sourceMappingURL=store-forges.js.map

package/dist/core/approval/store-forges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-forges.js","sourceRoot":"","sources":["../../../src/core/approval/store-forges.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,aAAa,EAAyB,MAAM,yBAAyB,CAAC;AACnH,OAAO,EAAE,mBAAmB,EAAoB,MAAM,oBAAoB,CAAC;AAG3E;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,GAAwC,EAAE,QAAsB;IAC1F,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0E,CAAC;IAChG,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACrB,IAAI,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,GAAG,CAAC,KAAK,IAAI,EAAE;gBACnB,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;oBAC3B,MAAM,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBAC3C,OAAO,EAAE,KAAK,EAAE,mBAAmB,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC;gBACxE,CAAC;gBACD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,EAAE,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;gBAC9F,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACvD,OAAO,EAAE,KAAK,EAAE,mBAAmB,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC;YACxE,CAAC,CAAC,EAAE,CAAC;YACL,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACxB,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/browse/approve.d.ts

@@ -1,6 +1,7 @@
 import type { IncomingMessage } from 'node:http';
 import type { ChangeApprovalConfig } from '../../config/schema.js';
 import type { IdentityVerifier } from '../approval/identity.js';
+import { type ForgeFor } from '../approval/session-group.js';
 import type { ForgeCredentials } from '../forge/credentials.js';
 import type { ForgeClient } from '../forge/github.js';
 import type { GitRunner } from '../git/exec.js';
@@ -24,6 +25,13 @@ export interface ApprovalServer {
     verifier: IdentityVerifier;
     git: GitRunner;
     now(): Date;
+    /**
+     * approve-sessions-across-stores D8: the forge client and credential for a mounted store's clone, with the same
+     * recording identity. Omitted, mounts are read with `gh`'s own credential in their clone.
+     */
+    forgeFor?: ForgeFor;
+    /** The process environment, for an authenticated fetch of a mounted part's head and for a mount's forge calls. */
+    env?: Readonly<Record<string, string | undefined>>;
 }
 /** What a route needs from the browsing surface once the requester is known: the shell, and note links. */
 export interface PageKit {

package/dist/core/browse/approve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"approve.d.ts","sourceRoot":"","sources":["../../../src/core/browse/approve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAInE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,oBAAoB,CAAC;AAEnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAA8B,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAO5E;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,cAAc,CAAC;AAOhD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,oGAAoG;IACpG,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,qHAAqH;IACrH,WAAW,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,GAAG,EAAE,SAAS,CAAC;IACf,GAAG,IAAI,IAAI,CAAC;CACb;AAED,2GAA2G;AAC3G,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzD,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACzC,WAAW,EAAE,YAAY,CAAC;CAC3B;AAED,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,mGAAmG;IACnG,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAQD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAgRD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,cAAc,GAAG,IAAI,EAC7B,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAC/B,WAAW,GAAE,MAAM,GAAG,IAAW,GAChC,OAAO,CAAC,KAAK,CAAC,CAkBhB"}
+{"version":3,"file":"approve.d.ts","sourceRoot":"","sources":["../../../src/core/browse/approve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAInE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,EAQL,KAAK,QAAQ,EAOd,MAAM,8BAA8B,CAAC;AAOtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,oBAAoB,CAAC;AAEnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAA8B,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAO5E;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,cAAc,CAAC;AAOhD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,oGAAoG;IACpG,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,qHAAqH;IACrH,WAAW,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,GAAG,EAAE,SAAS,CAAC;IACf,GAAG,IAAI,IAAI,CAAC;IACZ;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,kHAAkH;IAClH,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;CACpD;AAED,2GAA2G;AAC3G,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzD,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACzC,WAAW,EAAE,YAAY,CAAC;CAC3B;AAED,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,mGAAmG;IACnG,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAQD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAqmBD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,cAAc,GAAG,IAAI,EAC7B,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAC/B,WAAW,GAAE,MAAM,GAAG,IAAW,GAChC,OAAO,CAAC,KAAK,CAAC,CAkBhB"}