ctxr-cli 0.33.0 → 0.35.0

package/dist/core/mcp/paths.js

@@ -0,0 +1,111 @@
+import path from 'node:path';
+import { DEFAULT_LOG_PATH } from '../../config/defaults.js';
+import { isUnderAnyPrefix, isUnderPrefix } from '../fs/prefix.js';
+import { admitsNotePath } from '../notes/list.js';
+import { CONFIG_FILE_NAME } from '../root.js';
+import { ToolRefusal } from './jsonrpc.js';
+/**
+ * serve-the-session-lifecycle-to-chat-apps D5: what the file tools and the
+ * command runners may read and change, as predicates over a store-relative,
+ * `/`-separated path. Kept free of any session or snapshot, so the file tools
+ * over the served commit, the same tools inside a session, and `ctxr_write`'s
+ * before- and after-run checks all ask the same question.
+ */
+/** The store's entry document, readable though it is not a note. */
+export const ENTRY_DOCUMENT = 'AGENTS.md';
+/**
+ * D5, revision 7: the one protected-path predicate. Inside a session a member
+ * may change what a local session may change except these: the configuration
+ * (it grants MCP scopes), anything whose first segment begins with `.git` —
+ * the hooks directory among them, because a commit in a session worktree runs
+ * that worktree's hooks on the server — derived and cache paths, the
+ * worktrees path, and the managed skills path, which `ctxr update` owns.
+ * Null when the path may be changed.
+ */
+export function protectedReason(rel, config) {
+    if (rel === CONFIG_FILE_NAME)
+        return 'configuration';
+    if ((rel.split('/')[0] ?? '').startsWith('.git'))
+        return 'git';
+    if (isUnderAnyPrefix(rel, config.derived.paths))
+        return 'derived';
+    if (isUnderPrefix(rel, config.session.worktrees_path))
+        return 'worktrees';
+    if (isUnderPrefix(rel, config.harness.skills_path))
+        return 'skills';
+    return null;
+}
+const PROTECTED_WORDS = {
+    configuration: 'the store configuration',
+    git: "git's own files and the hooks directory, which a commit on the server would run",
+    derived: 'a derived or cache path',
+    worktrees: 'the session worktrees path',
+    skills: 'the managed skills path',
+};
+export function protectedRefusal(rel, reason) {
+    return new ToolRefusal('mcp.path_protected', `"${rel}" is ${PROTECTED_WORDS[reason]}, which cannot be changed from here; change it in a local session.`, { path: rel, reason });
+}
+/** D5: the paths the owned skills read that are not notes: templates, house conventions, the mission, the log and the skills. */
+export function widenedReadablePrefixes(config) {
+    return [
+        config.templates.path,
+        config.harness.guidance_path,
+        config.harness.skills_path,
+        config.organize.log_path ?? DEFAULT_LOG_PATH,
+        ...(config.organize.mission_path !== undefined ? [config.organize.mission_path] : []),
+    ];
+}
+/** Never read or returned, whatever else applies: configuration, `.git`, derived paths and the worktrees path. */
+export function neverReadablePrefixes(config) {
+    return [CONFIG_FILE_NAME, '.git', ...config.derived.paths, config.session.worktrees_path];
+}
+/**
+ * D5: hidden from the file tools. `retrieval.exclude_paths` stays hidden — it
+ * is the operator's declared intent — except the capture tier, which `Read`
+ * marks, and the widened readable set, which the skills need.
+ */
+export function hiddenPrefixes(config) {
+    const captureRoot = config.ingest.capture_root.replace(/\/+$/, '');
+    return [...config.retrieval.exclude_paths.filter((p) => p.replace(/\/+$/, '') !== captureRoot), ...neverReadablePrefixes(config)];
+}
+/** Whether `rel` is a path the file tools may name at all (a file or a directory to search). */
+export function nameablePath(rel, config) {
+    if (rel === '')
+        return true;
+    if (isUnderAnyPrefix(rel, neverReadablePrefixes(config)))
+        return false;
+    if (isUnderAnyPrefix(rel, widenedReadablePrefixes(config)))
+        return true;
+    return !isUnderAnyPrefix(rel, hiddenPrefixes(config));
+}
+/** What `Read` answers for, as one predicate: a note, a markdown capture, the entry document, or the widened set. Grep and Glob return nothing else. */
+export function readablePath(rel, config) {
+    if (!nameablePath(rel, config) || rel === '')
+        return false;
+    if (isUnderAnyPrefix(rel, widenedReadablePrefixes(config)))
+        return true;
+    if (admitsNotePath(rel, config) || rel === ENTRY_DOCUMENT)
+        return true;
+    return rel.endsWith('.md') && isUnderAnyPrefix(rel, [config.ingest.capture_root]);
+}
+/**
+ * The exclusions ripgrep is given: the hidden prefixes that contain nothing in
+ * the widened set. A hidden prefix that does contain some (the default
+ * `.contexture/` holds the templates) is searched and filtered by
+ * `readablePath` afterwards, because a later positive glob would turn
+ * ripgrep's exclusions into an allowlist.
+ */
+export function searchExclusions(config) {
+    const widened = widenedReadablePrefixes(config).map((p) => p.replace(/\/+$/, ''));
+    return hiddenPrefixes(config).filter((hidden) => !widened.some((w) => isUnderPrefix(w, hidden)) || isUnderAnyPrefix(hidden, neverReadablePrefixes(config)));
+}
+/** A caller's path as a normalized store-relative one (a leading `/` names the store root); refused when it leaves the store. `''` is the root. */
+export function normalizeStorePath(input) {
+    const cleaned = input.trim().replace(/\\/g, '/');
+    const normalized = path.posix.normalize(`/${cleaned}`).replace(/^\/+/, '').replace(/\/+$/, '');
+    if (normalized === '..' || normalized.startsWith('../') || cleaned.split('/').includes('..')) {
+        throw new ToolRefusal('mcp.path_outside_store', `"${input}" is outside the store.`);
+    }
+    return normalized;
+}
+//# sourceMappingURL=paths.js.map

package/dist/core/mcp/paths.js.map

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

package/dist/core/mcp/sessions.d.ts

@@ -1,13 +1,22 @@
 import type { StoreConfig } from '../../config/schema.js';
 import { type ForgeCredentials } from '../forge/credentials.js';
-import type { ForgeClient, PullRequest } from '../forge/github.js';
+import type { ForgeClient } from '../forge/github.js';
 import type { GitRunner } from '../git/exec.js';
+import type { CommitOptions } from '../session/commit.js';
+import { type StartedSession } from '../session/start.js';
 /**
  * serve-the-store-over-mcp design.md D9, D13: the write side the MCP surface
- * shares between `capture` and the member drafts. Everything it writes is an
- * ordinary session — a worktree under the configured worktrees path, on a
- * branch under the session prefix, with a pull request — so the approval page
- * lists it and `ctxr land` lands it with no MCP-specific path anywhere.
+ * shares between its tools. Everything it writes is an ordinary session — a
+ * worktree under the configured worktrees path, on a branch under the session
+ * prefix, with a pull request — so the approval page lists it and `ctxr land`
+ * lands it with no MCP-specific path anywhere.
+ *
+ * serve-the-session-lifecycle-to-chat-apps D3: starting, submitting,
+ * rebasing and discarding are `src/core/session/`'s, the same calls
+ * `ctxr session <verb>` makes. What stays here is what the MCP layer adds:
+ * the server's forge credential on every remote step, the member as commit
+ * author, and the surface's wording of a refusal. The per-member draft's
+ * helpers are gone with the draft.
  */
 export interface WriteDeps {
     git: GitRunner;
@@ -25,60 +34,26 @@ export interface WriteDeps {
     /** The store root's path inside its repository, when the caller has already resolved it; asked of git otherwise. */
     repoPrefix?: string;
 }
-export interface Session {
-    /** The worktree directory's name: the key the approval page addresses it by. */
-    name: string;
-    path: string;
-    branch: string;
-    label: string | null;
-}
-export type PullState = {
-    kind: 'open';
-    pull: PullRequest;
-} | {
-    kind: 'merged';
-} | {
-    kind: 'closed-unmerged';
-} | {
-    kind: 'none';
-};
 export declare class WriteRefusal extends Error {
     readonly code: string;
     readonly details?: Record<string, unknown> | undefined;
     constructor(code: string, message: string, details?: Record<string, unknown> | undefined);
 }
-/** One write at a time across `capture`, `Edit` and `Write` (design.md D9, D13). */
+/** One write at a time across every tool that changes a worktree, the ownership record or the forge (design.md D9, D13). */
 export declare class Mutex {
     private tail;
     run<T>(fn: () => Promise<T>): Promise<T>;
 }
-export declare function approvalUrl(deps: WriteDeps, session: Session): string;
-/** The session worktrees on disk whose label starts with `labelPrefix`, with their branches. */
-export declare function sessionsLabelled(deps: WriteDeps, labelPrefix: string): Promise<Session[]>;
-/** What the forge says about the pull requests for `branch`: the open one, else merged, else closed, else none. */
-export declare function pullStateFor(deps: WriteDeps, branch: string): Promise<PullState>;
-/** A session whose pull request was closed without merging is removed: worktree and local branch (D9, D13). */
-export declare function removeSession(deps: WriteDeps, session: Session): Promise<void>;
-/** A new session from the freshly fetched default branch, exactly as `ctxr session start` names and places one. */
-export declare function startSession(deps: WriteDeps, label: string): Promise<Session>;
-/** The store-relative path's location inside the repository, for `git show <branch>:<path>`. */
-export declare function repoPathOf(deps: WriteDeps, storeRelative: string): Promise<string>;
-/**
- * Stages `paths` and commits them authored by the member, with the store's
- * hooks running as for any commit. On a refusal the worktree is restored to
- * its tip — a draft never keeps a change its pull request does not carry —
- * and the hook's output is the refusal (design.md D13).
- */
-export declare function commitAs(deps: WriteDeps, session: Session, email: string, paths: readonly string[], subject: string, trailer: string): Promise<string>;
-export declare function restore(deps: WriteDeps, session: Session): Promise<void>;
+/** The approval page for a session, at the server's own address. */
+export declare function approvalUrl(deps: WriteDeps, sessionName: string): string;
 /**
- * Publishes whatever the session holds that the forge does not: its branch,
- * pushed when the remote lacks the local tip, and a pull request, found by
- * head before one is opened. Idempotent, so a retry after any partial
- * failure converges on exactly one pull request (design.md D9, D13).
+ * A new session from the freshly fetched default branch, through the core
+ * `ctxr session start` calls. A closed pull request's branch stays on the
+ * remote, so a generated name the remote already carries is stepped past.
  */
-export declare function publish(deps: WriteDeps, session: Session, pull: {
-    title: string;
-    body: string;
-}): Promise<PullRequest>;
+export declare function startSession(deps: WriteDeps, label: string | undefined): Promise<StartedSession>;
+/** D3: the member as the commit's author, with a trailer naming them; the recording login commits when the host has no identity. */
+export declare function memberCommit(deps: WriteDeps, email: string, trailer: string): Omit<CommitOptions, 'message'>;
+/** A WriteRefusal or a core refusal, as a refusal the client model can read rather than a protocol error. */
+export declare function asToolRefusal(err: unknown): unknown;
 //# sourceMappingURL=sessions.d.ts.map

package/dist/core/mcp/sessions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../../src/core/mcp/sessions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../../src/core/mcp/sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAoC,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG5F;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,SAAS,CAAC;IACf,8GAA8G;IAC9G,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,KAAK,EAAE,WAAW,CAAC;IACnB,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAClD,GAAG,IAAI,IAAI,CAAC;IACZ,+GAA+G;IAC/G,cAAc,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,oHAAoH;IACpH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,YAAa,SAAQ,KAAK;IAEnC,QAAQ,CAAC,IAAI,EAAE,MAAM;IAErB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAH5C,YACW,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACN,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA,EAI3C;CACF;AAED,4HAA4H;AAC5H,qBAAa,KAAK;IAChB,OAAO,CAAC,IAAI,CAAuC;IAEnD,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAIvC;CACF;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAExE;AASD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC,CAYtG;AAED,oIAAoI;AACpI,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,CAE5G;AAED,6GAA6G;AAC7G,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAInD"}

package/dist/core/mcp/sessions.js

@@ -1,7 +1,8 @@
-import path from 'node:path';
+import { ContextureError } from '../errors.js';
 import { runRemoteGit } from '../forge/credentials.js';
-import { addWorktree, removeWorktree } from '../git/worktree.js';
-import { generateSessionBranchName, listSessionWorktreeDirs, sessionLabelFromDirName, sessionLabelSlug, worktreePathFor } from '../session.js';
+import { fetchDefaultBranch } from '../session/status.js';
+import { startSession as startCoreSession } from '../session/start.js';
+import { ToolRefusal } from './jsonrpc.js';
 export class WriteRefusal extends Error {
     code;
     details;
@@ -12,7 +13,7 @@ export class WriteRefusal extends Error {
         this.name = 'WriteRefusal';
     }
 }
-/** One write at a time across `capture`, `Edit` and `Write` (design.md D9, D13). */
+/** One write at a time across every tool that changes a worktree, the ownership record or the forge (design.md D9, D13). */
 export class Mutex {
     tail = Promise.resolve();
     run(fn) {
@@ -21,64 +22,9 @@ export class Mutex {
         return next;
     }
 }
-function firstLines(text, count = 6) {
-    return text.trim().split('\n').slice(0, count).join('\n');
-}
-export function approvalUrl(deps, session) {
-    return `${deps.baseUrl.replace(/\/+$/, '')}/approve/${encodeURIComponent(session.name)}`;
-}
-/** The session worktrees on disk whose label starts with `labelPrefix`, with their branches. */
-export async function sessionsLabelled(deps, labelPrefix) {
-    const root = path.join(deps.canonicalRoot, deps.config.session.worktrees_path);
-    const sessions = [];
-    for (const name of await listSessionWorktreeDirs(deps.canonicalRoot, deps.config)) {
-        const label = sessionLabelFromDirName(deps.config, name);
-        if (label === null || !label.startsWith(labelPrefix))
-            continue;
-        const dir = path.join(root, name);
-        const branch = (await deps.git.run(['symbolic-ref', '--short', 'HEAD'], { cwd: dir, allowFailure: true })).stdout.trim();
-        if (branch === '')
-            continue;
-        sessions.push({ name, path: dir, branch, label });
-    }
-    return sessions.sort((a, b) => (a.name < b.name ? -1 : 1));
-}
-/** What the forge says about the pull requests for `branch`: the open one, else merged, else closed, else none. */
-export async function pullStateFor(deps, branch) {
-    const pulls = await deps.forge.pullsForHead(branch);
-    const open = pulls.find((p) => p.state === 'open');
-    if (open !== undefined)
-        return { kind: 'open', pull: open };
-    if (pulls.some((p) => p.merged))
-        return { kind: 'merged' };
-    if (pulls.length > 0)
-        return { kind: 'closed-unmerged' };
-    return { kind: 'none' };
-}
-/** A session whose pull request was closed without merging is removed: worktree and local branch (D9, D13). */
-export async function removeSession(deps, session) {
-    await removeWorktree(deps.git, deps.canonicalRoot, session.path);
-    await deps.git.run(['branch', '-D', session.branch], { cwd: deps.canonicalRoot, allowFailure: true });
-}
-/** A new session from the freshly fetched default branch, exactly as `ctxr session start` names and places one. */
-export async function startSession(deps, label) {
-    const slug = sessionLabelSlug(label);
-    const defaultBranch = deps.config.git.default_branch;
-    await runRemoteGit(deps.git, deps.credentials, deps.env, ['fetch', '--quiet', 'origin', `+refs/heads/${defaultBranch}:refs/remotes/origin/${defaultBranch}`], {
-        cwd: deps.canonicalRoot,
-        allowFailure: true,
-    });
-    const hasRemote = (await deps.git.run(['rev-parse', '--verify', '--quiet', `refs/remotes/origin/${defaultBranch}`], { cwd: deps.canonicalRoot, allowFailure: true })).exitCode === 0;
-    // Names carry a timestamp to the second, and a closed pull request's branch stays on the remote: step past any taken name.
-    let branch = generateSessionBranchName(deps.config, deps.now(), slug);
-    for (let step = 1; step <= 60 && (await branchTaken(deps, branch)); step += 1) {
-        branch = generateSessionBranchName(deps.config, new Date(deps.now().getTime() + step * 1000), slug);
-    }
-    const dir = worktreePathFor({ root: deps.canonicalRoot, config: deps.config }, branch);
-    const added = await addWorktree(deps.git, deps.canonicalRoot, dir, branch, hasRemote ? `origin/${defaultBranch}` : defaultBranch, { allowFailure: true });
-    if (added.exitCode !== 0)
-        throw new WriteRefusal('mcp.session_not_started', `A session could not be started: ${firstLines(added.stderr)}`);
-    return { name: path.basename(dir), path: dir, branch, label: slug };
+/** The approval page for a session, at the server's own address. */
+export function approvalUrl(deps, sessionName) {
+    return `${deps.baseUrl.replace(/\/+$/, '')}/approve/${encodeURIComponent(sessionName)}`;
 }
 async function branchTaken(deps, branch) {
     const local = await deps.git.run(['rev-parse', '--verify', '--quiet', `refs/heads/${branch}`], { cwd: deps.canonicalRoot, allowFailure: true });
@@ -87,68 +33,30 @@ async function branchTaken(deps, branch) {
     const remote = await runRemoteGit(deps.git, deps.credentials, deps.env, ['ls-remote', '--exit-code', 'origin', `refs/heads/${branch}`], { cwd: deps.canonicalRoot, allowFailure: true });
     return remote.exitCode === 0;
 }
-/** The store-relative path's location inside the repository, for `git show <branch>:<path>`. */
-export async function repoPathOf(deps, storeRelative) {
-    const prefix = deps.repoPrefix ?? (await deps.git.run(['rev-parse', '--show-prefix'], { cwd: deps.canonicalRoot, allowFailure: true })).stdout.trim();
-    return `${prefix}${storeRelative}`;
-}
-/** The committer: the host's git identity when it has one, else the recording login's noreply address, as `ctxr land` falls back. */
-async function committerEnv(deps, cwd) {
-    const email = (await deps.git.run(['config', '--get', 'user.email'], { cwd, allowFailure: true })).stdout.trim();
-    if (email !== '' || deps.env.GIT_COMMITTER_EMAIL || deps.env.EMAIL)
-        return {};
-    const address = `${deps.recordingLogin.replace(/\[bot\]$/, '')}@users.noreply.github.com`;
-    return { GIT_COMMITTER_NAME: deps.recordingLogin, GIT_COMMITTER_EMAIL: address };
-}
 /**
- * Stages `paths` and commits them authored by the member, with the store's
- * hooks running as for any commit. On a refusal the worktree is restored to
- * its tip — a draft never keeps a change its pull request does not carry —
- * and the hook's output is the refusal (design.md D13).
+ * A new session from the freshly fetched default branch, through the core
+ * `ctxr session start` calls. A closed pull request's branch stays on the
+ * remote, so a generated name the remote already carries is stepped past.
  */
-export async function commitAs(deps, session, email, paths, subject, trailer) {
-    const run = (args, env) => deps.git.run(args, { cwd: session.path, allowFailure: true, ...(env ? { env } : {}) });
-    const added = await run(['add', '--', ...paths]);
-    if (added.exitCode !== 0) {
-        await restore(deps, session);
-        throw new WriteRefusal('mcp.commit_refused', `The change could not be staged: ${firstLines(added.stderr)}`);
-    }
-    const name = email.split('@')[0] ?? email;
-    const env = { ...deps.env, ...(await committerEnv(deps, session.path)), GIT_AUTHOR_NAME: name, GIT_AUTHOR_EMAIL: email };
-    const committed = await run(['commit', '--quiet', '-m', subject, '-m', `${trailer}: ${email}`], env);
-    if (committed.exitCode !== 0) {
-        await restore(deps, session);
-        throw new WriteRefusal('mcp.commit_refused', `The store refused the change: ${firstLines(`${committed.stdout}\n${committed.stderr}`, 12)}`);
-    }
-    return (await run(['rev-parse', 'HEAD'])).stdout.trim();
-}
-export async function restore(deps, session) {
-    await deps.git.run(['reset', '--quiet', '--hard', 'HEAD'], { cwd: session.path, allowFailure: true });
-    await deps.git.run(['clean', '-fdq'], { cwd: session.path, allowFailure: true });
-}
-/**
- * Publishes whatever the session holds that the forge does not: its branch,
- * pushed when the remote lacks the local tip, and a pull request, found by
- * head before one is opened. Idempotent, so a retry after any partial
- * failure converges on exactly one pull request (design.md D9, D13).
- */
-export async function publish(deps, session, pull) {
-    const tip = (await deps.git.run(['rev-parse', 'HEAD'], { cwd: session.path })).stdout.trim();
-    const remote = await runRemoteGit(deps.git, deps.credentials, deps.env, ['ls-remote', 'origin', `refs/heads/${session.branch}`], { cwd: session.path, allowFailure: true });
-    if (remote.exitCode !== 0 || remote.stdout.split(/\s/)[0] !== tip) {
-        const pushed = await runRemoteGit(deps.git, deps.credentials, deps.env, ['push', '--quiet', 'origin', `HEAD:refs/heads/${session.branch}`], { cwd: session.path, allowFailure: true });
-        if (pushed.exitCode !== 0) {
-            throw new WriteRefusal('mcp.push_failed', `The change is saved in its session but could not be pushed yet (${firstLines(pushed.stderr, 2)}). Retry the same call to publish it.`, { session: session.name });
-        }
-    }
-    const state = await pullStateFor(deps, session.branch);
-    if (state.kind === 'open')
-        return state.pull;
-    try {
-        return await deps.forge.createPull({ head: session.branch, base: deps.config.git.default_branch, title: pull.title, body: pull.body });
-    }
-    catch (err) {
-        throw new WriteRefusal('mcp.pull_request_failed', `The change is pushed but its pull request could not be opened yet (${err instanceof Error ? firstLines(err.message, 2) : String(err)}). Retry the same call to open it.`, { session: session.name });
-    }
+export async function startSession(deps, label) {
+    return startCoreSession({
+        git: deps.git,
+        config: deps.config,
+        fetch: (cwd) => fetchDefaultBranch({ git: deps.git, config: deps.config, env: deps.env, credentials: deps.credentials }, cwd),
+        now: deps.now,
+        branchTaken: (branch) => branchTaken(deps, branch),
+    }, deps.canonicalRoot, label);
+}
+/** D3: the member as the commit's author, with a trailer naming them; the recording login commits when the host has no identity. */
+export function memberCommit(deps, email, trailer) {
+    return { author: { name: email.split('@')[0] ?? email, email }, trailer: { key: trailer, value: email }, fallbackCommitter: deps.recordingLogin };
+}
+/** A WriteRefusal or a core refusal, as a refusal the client model can read rather than a protocol error. */
+export function asToolRefusal(err) {
+    if (err instanceof WriteRefusal)
+        return new ToolRefusal(err.code, err.message, err.details);
+    if (err instanceof ContextureError)
+        return new ToolRefusal(err.finding.code, err.finding.message, err.finding.details);
+    return err;
 }
 //# sourceMappingURL=sessions.js.map

package/dist/core/mcp/sessions.js.map

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

package/dist/core/mcp/tool-map.d.ts

@@ -0,0 +1,94 @@
+/**
+ * serve-the-session-lifecycle-to-chat-apps D9 and revisions 2, 3 and 6: the
+ * one place a `ctxr` command is mapped to the MCP tool that runs it. The tool
+ * registry (`tools/index.ts`) registers exactly the tools listed here, in
+ * this order; the rendered skills' preamble, the drift check over the MCP
+ * render and the tool/command alignment check all read this module, so no
+ * tool name is ever derived from a command name by rule.
+ *
+ * Every tool is one of four kinds:
+ * - `file`: Claude Code's own file tools, plus `Move` and `Delete`, which stand
+ *   in for the `git mv` and `git rm` a local agent runs;
+ * - `command`: one `ctxr` command, named for its path, taking its options as
+ *   fields (plus `session`, the one field the MCP layer adds);
+ * - `runner`: `ctxr` and `ctxr_write`, through which every allowlisted command
+ *   without a tool of its own runs (D4);
+ * - `exception`: a tool with no command, each with its reason.
+ */
+export type ToolKind = 'file' | 'command' | 'runner' | 'exception';
+export interface ToolEntry {
+    name: string;
+    kind: ToolKind;
+    /** `command` only: the command path, space-separated, as `ctxr <path>` takes it. */
+    command?: string;
+    /** `runner` and `exception`: why the tool is not a command of its own. */
+    reason?: string;
+}
+/** The one field the MCP layer adds to a command's options: a local command finds its session from its working directory, a stateless server cannot. */
+export declare const SESSION_FIELD = "session";
+/** The fields of the two runners (D4, D9). */
+export declare const RUNNER_FIELDS: readonly ['args', "session", 'input'];
+/** The literal argument `ctxr_write` replaces with the path of a file holding the call's `input` (D4). */
+export declare const INPUT_ARGUMENT = "@input";
+/** D4: read-only commands `ctxr` runs, as command paths matched before any option. */
+export declare const CTXR_READ_COMMANDS: readonly ['lint', 'doctor', 'catalog show', 'catalog check', 'graph query', 'graph diff', 'context gather', 'source check', 'source hash', 'rollup stale', 'rollup gather', 'publish check', 'publish urls', 'publish gather', 'shared-stores status'];
+/** D4: writing commands `ctxr_write` runs inside a member's own session. `session capture` is one of them (revision 2). */
+export declare const CTXR_WRITE_COMMANDS: readonly ['ingest', 'archive', 'entry append', 'rollup write', 'source stamp', 'source add-alt', 'session capture', 'catalog build', 'graph build', 'update'];
+/**
+ * Commands a shipped skill names that have no counterpart over MCP, so the
+ * preamble marks them `none` and the agent skips the step. `shared-stores
+ * sync` refreshes the canonical clone's mounts; the server keeps no mounts,
+ * and a chat session cannot change into one (mount-shared-stores).
+ */
+export declare const UNAVAILABLE_COMMANDS: readonly ['shared-stores sync'];
+/** D3: the session commands with a typed tool of their own. */
+export declare const SESSION_COMMAND_TOOLS: {
+    readonly 'session start': 'session_start';
+    readonly 'session list': 'session_list';
+    readonly 'session status': 'session_status';
+    readonly 'session submit': 'session_submit';
+    readonly 'session rebase': 'session_rebase';
+    readonly 'session discard': 'session_discard';
+};
+/**
+ * D6: the git and gh steps the shipped skills name, and the tool each one is in
+ * this environment; null marks the server's own work, which the agent skips (the
+ * lifecycle skill's canonical-clone refresh). A step not listed here has no
+ * counterpart over MCP, and the drift check over the MCP render refuses it. The
+ * preamble's tables are rendered from this and `SESSION_COMMAND_TOOLS`.
+ */
+export declare const GIT_STEP_TOOLS: Readonly<Record<string, string | null>>;
+/** The registry, in `tools/list` order. */
+export declare const TOOL_REGISTRY: readonly ToolEntry[];
+export declare const TOOL_NAMES: readonly string[];
+/** The command path at the front of `argv` that `allowlist` holds, longest first; null when none does. Matched before any option. */
+export declare function matchCommand(argv: readonly string[], allowlist: readonly string[]): string | null;
+export type CommandRoute = {
+    via: 'tool';
+    tool: string;
+} | {
+    via: 'ctxr';
+} | {
+    via: 'ctxr_write';
+};
+/** How a `ctxr <command path>` step runs over MCP; null when the surface does not run it. */
+export declare function routeForCommand(commandPath: string): CommandRoute | null;
+/** The file tools: Claude Code's own, plus the two that stand in for `git mv` and `git rm` (D9). */
+export declare const FILE_TOOLS: readonly ['Read', 'Grep', 'Glob', 'Edit', 'Write', 'Move', 'Delete'];
+/** The named exceptions (D9): tools with no command, each with its reason in the registry. */
+export declare const NAMED_EXCEPTIONS: readonly ['find', 'gather', 'capture'];
+/** The command runners (D4, D9). */
+export declare const RUNNERS: readonly ['ctxr', 'ctxr_write'];
+/** One CLI command as the alignment check sees it: its path and the snake_case names of its options and arguments. */
+export interface CommandShape {
+    path: string;
+    params: readonly string[];
+}
+/**
+ * D9: what is wrong with a registry against the CLI's commands, one line per
+ * problem, each naming the tool. Empty when every tool is a file tool, a
+ * runner, a named exception, or a command-named tool whose fields other than
+ * `session` are options or arguments that command registers.
+ */
+export declare function alignmentProblems(registry: readonly ToolEntry[], toolFields: Readonly<Record<string, readonly string[]>>, commands: readonly CommandShape[]): string[];
+//# sourceMappingURL=tool-map.d.ts.map

package/dist/core/mcp/tool-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-map.d.ts","sourceRoot":"","sources":["../../../src/core/mcp/tool-map.ts"],"names":[],"mappings":"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"}