ctxr-cli 0.33.0 → 0.35.0

package/templates/skills/mcp/_preamble.md

@@ -0,0 +1,44 @@
+## Before this skill: the store's tools stand in for a checkout
+
+You are working through this store's server, not in a checkout of it. Nothing runs a shell here, so no
+`git`, `gh` or `ctxr` command runs as written. The skill below was written for an agent with a checkout:
+follow it as written, and take each step it names through the tool these tables give.
+
+### Commands
+
+__COMMAND_TABLE__
+
+A command marked none has no counterpart here: skip that step and say nothing about it. Each other tool takes its command's options as fields, each named for its option without the leading
+dashes, and the session the command names as `session`: the session worktree's directory name, which
+`session_start` returns and `session_list` lists. `session_start` takes the session's name as `label`.
+
+Every other `ctxr` step runs through the `ctxr` tool when the command only reads, and through `ctxr_write`
+when it writes. Pass the words after `ctxr` as `args`, one word per entry: a step that says to run
+`ctxr lint` is the `ctxr` tool with `args` set to `["lint"]`. Name a session as `session` to run the command
+in that session's working tree; `ctxr_write` always needs one. When a command reads a file you prepared,
+pass the file's text as `input` and write `@input` in `args` where its path goes.
+
+### Git steps
+
+__GIT_STEP_TABLE__
+
+Commits, pushes and pull requests happen only in `session_submit`. A step marked none is the server's own
+work: it keeps the store's clone current, and `session_start` branches from the freshly fetched default
+branch. Skip that step and say nothing about it.
+
+### Paths
+
+`session_start` returns the session's root, a path such as `__WORKTREES_PATH__<directory>/`. Every path the
+skill names is relative to the store; inside a session it goes under that root, so the note `work/a.md` in
+that session is `__WORKTREES_PATH__<directory>/work/a.md` for `Read`, `Edit`, `Write`, `Move`, `Delete`,
+`Grep` and `Glob`. A path without a session root reads the store as it was last approved, and a write to one
+is refused. A change rests uncommitted in its session until `session_submit`.
+
+### Sessions across conversations
+
+The server keeps a session between conversations, but it cannot tell two conversations apart. At the
+start of a conversation, call `session_list` and mention each open session: what it holds uncommitted,
+and any requested changes on its pull request. Work in the session the person names, or start one.
+
+Where the skill hands off to a skill this environment does not carry, such as landing or upgrading, or
+asks you to work inside a store mounted under `shared/`, that step is not yours here: a person lands an approved change from the store's approval page.

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

@@ -1,30 +0,0 @@
-import { type PullState, type Session, type WriteDeps } from './sessions.js';
-/**
- * serve-the-store-over-mcp design.md D12–D13: where a member's draft lives.
- * One session per member, labelled `mcp-draft-<local part>-<8 hex of the
- * email>` — readable in the approval index, and distinct for two members
- * whose local parts slugify alike. `Read` uses it to show a member their own
- * pending change; `Edit` and `Write` use it to find the session to extend.
- */
-export declare const DRAFT_LABEL_PREFIX = "mcp-draft-";
-export declare function draftLabel(email: string): string;
-export interface Draft {
-    session: Session;
-    state: PullState;
-}
-/** The member's draft on disk and what the forge says about it; null when there is none. */
-export declare function findDraft(deps: WriteDeps, email: string): Promise<Draft | null>;
-/**
- * The member's draft session on disk, without asking the forge — for `Read`, which must answer from local state
- * alone so a forge outage or rate limit never stops a read. `land` removes a merged draft's worktree; one whose pull
- * request closed unmerged is removed by the member's next `Edit` or `Write`.
- */
-export declare function findLocalDraft(deps: WriteDeps, email: string): Promise<Draft | null>;
-/**
- * A file as the member's draft has committed it, when the draft's committed
- * tip changes or adds it; null otherwise. Read from the branch with
- * `git show`, never the working tree, so an edit in progress is never seen
- * half-applied (design.md D12).
- */
-export declare function draftVersion(deps: WriteDeps, draft: Draft, storeRelative: string): Promise<string | null>;
-//# sourceMappingURL=drafts.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"drafts.d.ts","sourceRoot":"","sources":["../../../src/core/mcp/drafts.ts"],"names":[],"mappings":"AAEA,OAAO,EAA8C,KAAK,SAAS,EAAE,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAEzH;;;;;;GAMG;AAEH,eAAO,MAAM,kBAAkB,eAAe,CAAC;AAE/C,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,4FAA4F;AAC5F,wBAAsB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAKrF;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAI1F;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQ/G"}

package/dist/core/mcp/drafts.js

@@ -1,52 +0,0 @@
-import { createHash } from 'node:crypto';
-import { slugifySegment } from '../slug.js';
-import { pullStateFor, repoPathOf, sessionsLabelled } from './sessions.js';
-/**
- * serve-the-store-over-mcp design.md D12–D13: where a member's draft lives.
- * One session per member, labelled `mcp-draft-<local part>-<8 hex of the
- * email>` — readable in the approval index, and distinct for two members
- * whose local parts slugify alike. `Read` uses it to show a member their own
- * pending change; `Edit` and `Write` use it to find the session to extend.
- */
-export const DRAFT_LABEL_PREFIX = 'mcp-draft-';
-export function draftLabel(email) {
-    const local = slugifySegment(email.split('@')[0] ?? 'member').slice(0, 20).replace(/-+$/, '') || 'member';
-    const digest = createHash('sha256').update(email.toLowerCase()).digest('hex').slice(0, 8);
-    return `${DRAFT_LABEL_PREFIX}${local}-${digest}`;
-}
-/** The member's draft on disk and what the forge says about it; null when there is none. */
-export async function findDraft(deps, email) {
-    const label = draftLabel(email);
-    const session = (await sessionsLabelled(deps, label)).find((s) => s.label === label);
-    if (session === undefined)
-        return null;
-    return { session, state: await pullStateFor(deps, session.branch) };
-}
-/**
- * The member's draft session on disk, without asking the forge — for `Read`, which must answer from local state
- * alone so a forge outage or rate limit never stops a read. `land` removes a merged draft's worktree; one whose pull
- * request closed unmerged is removed by the member's next `Edit` or `Write`.
- */
-export async function findLocalDraft(deps, email) {
-    const label = draftLabel(email);
-    const session = (await sessionsLabelled(deps, label)).find((s) => s.label === label);
-    return session === undefined ? null : { session, state: { kind: 'none' } };
-}
-/**
- * A file as the member's draft has committed it, when the draft's committed
- * tip changes or adds it; null otherwise. Read from the branch with
- * `git show`, never the working tree, so an edit in progress is never seen
- * half-applied (design.md D12).
- */
-export async function draftVersion(deps, draft, storeRelative) {
-    if (draft.state.kind === 'merged' || draft.state.kind === 'closed-unmerged')
-        return null;
-    const repoPath = await repoPathOf(deps, storeRelative);
-    const base = `refs/remotes/origin/${deps.config.git.default_branch}`;
-    const changed = await deps.git.run(['diff', '--name-only', '--no-renames', `${base}...${draft.session.branch}`, '--', repoPath], { cwd: deps.canonicalRoot, allowFailure: true });
-    if (changed.exitCode !== 0 || changed.stdout.trim() === '')
-        return null;
-    const shown = await deps.git.run(['show', `${draft.session.branch}:${repoPath}`], { cwd: deps.canonicalRoot, allowFailure: true });
-    return shown.exitCode === 0 ? shown.stdout : null;
-}
-//# sourceMappingURL=drafts.js.map

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

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