@neturely/okffs 0.2.1

package/dist/tools/plan.d.ts

@@ -0,0 +1,79 @@
+import { z } from "zod";
+export declare const name = "plan";
+export declare const description = "Plan a piece of work and create all the resulting GitHub issues (with branches, and draft PRs when OKFFS_AUTO_PR=true) in one shot. Given a free-text description of the work, break it down yourself into a structured list of issues \u2014 each with a title, description, inferred labels, and any relationships between them \u2014 and pass that breakdown as the tasks array. Infer labels from GitHub's defaults: bug, documentation, duplicate, enhancement, good first issue, help wanted, invalid, question, wontfix. Express dependencies via per-task relationships, referencing other tasks by their 1-based position in the list. Two-step confirmation: call once to preview the plan, then re-call with confirmed: true to create everything.";
+export declare const inputSchema: z.ZodObject<{
+    description: z.ZodString;
+    tasks: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        description: z.ZodString;
+        assignees: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        milestone: z.ZodOptional<z.ZodNumber>;
+        relationships: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<["blocked_by", "blocking", "parent"]>;
+            target: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            type: "blocking" | "parent" | "blocked_by";
+            target: number;
+        }, {
+            type: "blocking" | "parent" | "blocked_by";
+            target: number;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        description: string;
+        assignees?: string[] | undefined;
+        labels?: string[] | undefined;
+        milestone?: number | undefined;
+        relationships?: {
+            type: "blocking" | "parent" | "blocked_by";
+            target: number;
+        }[] | undefined;
+    }, {
+        title: string;
+        description: string;
+        assignees?: string[] | undefined;
+        labels?: string[] | undefined;
+        milestone?: number | undefined;
+        relationships?: {
+            type: "blocking" | "parent" | "blocked_by";
+            target: number;
+        }[] | undefined;
+    }>, "many">;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    tasks: {
+        title: string;
+        description: string;
+        assignees?: string[] | undefined;
+        labels?: string[] | undefined;
+        milestone?: number | undefined;
+        relationships?: {
+            type: "blocking" | "parent" | "blocked_by";
+            target: number;
+        }[] | undefined;
+    }[];
+    confirmed?: boolean | undefined;
+}, {
+    description: string;
+    tasks: {
+        title: string;
+        description: string;
+        assignees?: string[] | undefined;
+        labels?: string[] | undefined;
+        milestone?: number | undefined;
+        relationships?: {
+            type: "blocking" | "parent" | "blocked_by";
+            target: number;
+        }[] | undefined;
+    }[];
+    confirmed?: boolean | undefined;
+}>;
+export declare function handler(input: z.infer<typeof inputSchema>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=plan.d.ts.map

package/dist/tools/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/tools/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,IAAI,SAAS,CAAC;AAE3B,eAAO,MAAM,WAAW,muBACgsB,CAAC;AA2BztB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAStB,CAAC;AAQH,wBAAsB,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC;;;;;GAwJ/D"}

package/dist/tools/plan.js

@@ -0,0 +1,159 @@
+import { z } from "zod";
+import { createIssue, updateIssueBody, getDefaultBranch, getRef, createBranch, buildBranchName, createDraftPullRequest, } from "../github.js";
+import { config } from "../config.js";
+import { git, currentBranch } from "../git.js";
+export const name = "plan";
+export const description = "Plan a piece of work and create all the resulting GitHub issues (with branches, and draft PRs when OKFFS_AUTO_PR=true) in one shot. Given a free-text description of the work, break it down yourself into a structured list of issues — each with a title, description, inferred labels, and any relationships between them — and pass that breakdown as the tasks array. Infer labels from GitHub's defaults: bug, documentation, duplicate, enhancement, good first issue, help wanted, invalid, question, wontfix. Express dependencies via per-task relationships, referencing other tasks by their 1-based position in the list. Two-step confirmation: call once to preview the plan, then re-call with confirmed: true to create everything.";
+const relationshipSchema = z.object({
+    type: z
+        .enum(["blocked_by", "blocking", "parent"])
+        .describe("blocked_by: this task is blocked by the target. blocking: this task is blocking the target. parent: the target is the parent of this task."),
+    target: z
+        .number()
+        .int()
+        .positive()
+        .describe("1-based index of the related task within this same tasks list"),
+});
+const taskSchema = z.object({
+    title: z.string().describe("Issue title"),
+    description: z.string().describe("Issue body / description"),
+    assignees: z.array(z.string()).optional().describe("GitHub usernames to assign"),
+    labels: z.array(z.string()).optional().describe("Labels to apply to this issue"),
+    milestone: z.number().int().optional().describe("Milestone number to assign"),
+    relationships: z
+        .array(relationshipSchema)
+        .optional()
+        .describe("Relationships to other tasks in this list, referenced by 1-based index"),
+});
+export const inputSchema = z.object({
+    description: z
+        .string()
+        .describe("Free-text description of the work to plan and break down into issues"),
+    tasks: z
+        .array(taskSchema)
+        .min(1)
+        .describe("The issue breakdown you generated from the description"),
+    confirmed: z.boolean().optional().describe("Must be true to proceed with creation"),
+});
+const RELATIONSHIP_LABELS = {
+    blocked_by: "Blocked by",
+    blocking: "Blocking",
+    parent: "Parent:",
+};
+export async function handler(input) {
+    if (!input.confirmed) {
+        const preview = input.tasks
+            .map((t, i) => {
+            const labels = t.labels?.length ? ` [${t.labels.join(", ")}]` : "";
+            const rels = t.relationships?.length
+                ? "\n" +
+                    t.relationships
+                        .map((r) => `     ↳ ${RELATIONSHIP_LABELS[r.type]} task ${r.target}`)
+                        .join("\n")
+                : "";
+            return `${i + 1}. ${t.title}${labels}${rels}`;
+        })
+            .join("\n");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Plan for: ${input.description}\n\n` +
+                        `About to create ${input.tasks.length} issue(s):\n\n${preview}\n\n` +
+                        `Re-call plan with confirmed: true to create them.`,
+                },
+            ],
+        };
+    }
+    const defaultBranch = await getDefaultBranch();
+    const ref = await getRef(defaultBranch);
+    // First pass: create every issue and its branch so we have real issue numbers
+    // before wiring up relationships (which reference tasks by list index).
+    const created = [];
+    for (const task of input.tasks) {
+        const resolvedAssignees = task.assignees ?? config.defaultAssignees;
+        const resolvedLabels = [...new Set([...(task.labels ?? []), ...config.defaultLabels])];
+        const issue = await createIssue(task.title, task.description, resolvedAssignees, resolvedLabels, task.milestone);
+        const branchName = buildBranchName(issue.number, task.title);
+        await createBranch(branchName, ref.object.sha);
+        const body = `${task.description}\n\n**Branch:** \`${branchName}\``;
+        await updateIssueBody(issue.number, body);
+        created.push({
+            number: issue.number,
+            html_url: issue.html_url,
+            branchName,
+            body,
+            relationships: task.relationships ?? [],
+        });
+    }
+    // Second pass: resolve relationship targets (1-based task indices) to issue
+    // numbers and append a Relationships section to the relevant issue bodies.
+    for (let i = 0; i < created.length; i++) {
+        const entry = created[i];
+        const lines = entry.relationships
+            .filter((r) => r.target >= 1 && r.target <= created.length && r.target !== i + 1)
+            .map((r) => `- ${RELATIONSHIP_LABELS[r.type]} #${created[r.target - 1].number}`);
+        if (lines.length === 0)
+            continue;
+        const newBody = `${entry.body}\n\n## Relationships\n${lines.join("\n")}`;
+        await updateIssueBody(entry.number, newBody);
+    }
+    // Optionally open a draft PR per branch. Mirrors create_issue: push an empty
+    // init commit so the branch diverges from base, then open the draft PR.
+    const draftPRs = {};
+    if (config.autoPR) {
+        const previousBranch = currentBranch();
+        try {
+            git(["fetch", "origin"]);
+            for (const entry of created) {
+                try {
+                    git(["checkout", entry.branchName]);
+                    git(["commit", "--allow-empty", "-m", `chore: init branch for #${entry.number}`]);
+                    git(["push", "origin", entry.branchName]);
+                }
+                catch (err) {
+                    console.warn(`[okffs] Failed to push init commit for #${entry.number}:`, err instanceof Error ? err.message : err);
+                }
+            }
+        }
+        finally {
+            if (previousBranch && !created.some((e) => e.branchName === previousBranch)) {
+                try {
+                    git(["checkout", previousBranch]);
+                }
+                catch (err) {
+                    console.warn("[okffs] Failed to restore branch:", err instanceof Error ? err.message : err);
+                }
+            }
+        }
+        for (const entry of created) {
+            try {
+                const pr = await createDraftPullRequest(`WIP: #${entry.number} - ${input.tasks[created.indexOf(entry)].title}`, `Closes #${entry.number}`, entry.branchName, defaultBranch);
+                draftPRs[entry.number] = pr.html_url;
+            }
+            catch (err) {
+                console.warn(`[okffs] Failed to create draft PR for #${entry.number}:`, err instanceof Error ? err.message : err);
+            }
+        }
+    }
+    const results = created.map((entry) => {
+        const lines = [
+            `#${entry.number} — ${input.tasks[created.indexOf(entry)].title}`,
+            `  Branch: \`${entry.branchName}\``,
+            `  ${entry.html_url}`,
+        ];
+        if (draftPRs[entry.number]) {
+            lines.push(`  Draft PR: ${draftPRs[entry.number]}`);
+        }
+        return lines.join("\n");
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Created ${results.length} issue(s) from the plan:\n\n${results.join("\n\n")}`,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=plan.js.map

package/dist/tools/plan.js.map

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

package/dist/tools/prepare_release.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+export declare const name = "prepare_release";
+export declare const description = "Prepare a release: bump the version in package.json and package-lock.json, roll the CHANGELOG ([Unreleased] \u2192 a dated version section with a fresh empty [Unreleased] and updated compare links), commit on a release branch, and open a PR. It does NOT tag or publish \u2014 tagging vX.Y.Z (which triggers the CI npm publish) stays a manual step after merge. Provide an explicit `version` or a `bump` level; if neither is given, a level is inferred from the [Unreleased] entries (### Added \u2192 minor, otherwise patch) and surfaced for confirmation. Two-step: call once to preview, re-call with confirmed: true to apply.";
+export declare const inputSchema: z.ZodObject<{
+    version: z.ZodOptional<z.ZodString>;
+    bump: z.ZodOptional<z.ZodEnum<["patch", "minor", "major"]>>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    confirmed?: boolean | undefined;
+    version?: string | undefined;
+    bump?: "patch" | "minor" | "major" | undefined;
+}, {
+    confirmed?: boolean | undefined;
+    version?: string | undefined;
+    bump?: "patch" | "minor" | "major" | undefined;
+}>;
+export declare function handler(input: z.infer<typeof inputSchema>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=prepare_release.d.ts.map

package/dist/tools/prepare_release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare_release.d.ts","sourceRoot":"","sources":["../../src/tools/prepare_release.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,IAAI,oBAAoB,CAAC;AAEtC,eAAO,MAAM,WAAW,onBAC4kB,CAAC;AAErmB,eAAO,MAAM,WAAW;;;;;;;;;;;;EAItB,CAAC;AA4BH,wBAAsB,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC;;;;;GAkJ/D"}

package/dist/tools/prepare_release.js

@@ -0,0 +1,172 @@
+import { z } from "zod";
+import fs from "fs";
+import path from "path";
+import { createPullRequest, getDefaultBranch } from "../github.js";
+import { getUnreleasedSection, rollChangelogForRelease } from "../docs.js";
+import { git, currentBranch } from "../git.js";
+export const name = "prepare_release";
+export const description = "Prepare a release: bump the version in package.json and package-lock.json, roll the CHANGELOG ([Unreleased] → a dated version section with a fresh empty [Unreleased] and updated compare links), commit on a release branch, and open a PR. It does NOT tag or publish — tagging vX.Y.Z (which triggers the CI npm publish) stays a manual step after merge. Provide an explicit `version` or a `bump` level; if neither is given, a level is inferred from the [Unreleased] entries (### Added → minor, otherwise patch) and surfaced for confirmation. Two-step: call once to preview, re-call with confirmed: true to apply.";
+export const inputSchema = z.object({
+    version: z.string().optional().describe("Explicit target version, e.g. 0.1.7 (takes precedence over bump)"),
+    bump: z.enum(["patch", "minor", "major"]).optional().describe("Semver bump level if version is not given"),
+    confirmed: z.boolean().optional().describe("Must be true to apply (otherwise previews)"),
+});
+function bumpVersion(v, type) {
+    const m = v.match(/^(\d+)\.(\d+)\.(\d+)$/);
+    if (!m)
+        throw new Error(`Cannot parse current version "${v}".`);
+    const [maj, min, pat] = [Number(m[1]), Number(m[2]), Number(m[3])];
+    if (type === "major")
+        return `${maj + 1}.0.0`;
+    if (type === "minor")
+        return `${maj}.${min + 1}.0`;
+    return `${maj}.${min}.${pat + 1}`;
+}
+// Replace the first `count` occurrences of an exact substring. Throws if fewer
+// than `count` occurrences exist — a partial version bump must never proceed.
+function replaceExactly(content, search, replace, count, label) {
+    const found = content.split(search).length - 1;
+    if (found < count) {
+        throw new Error(`Expected at least ${count} occurrence(s) of \`${search}\` in ${label} but found ${found}. Aborting to avoid an inconsistent version bump.`);
+    }
+    let out = content;
+    let from = 0;
+    for (let i = 0; i < count; i++) {
+        const at = out.indexOf(search, from);
+        out = out.slice(0, at) + replace + out.slice(at + search.length);
+        from = at + replace.length;
+    }
+    return out;
+}
+export async function handler(input) {
+    const base = process.cwd();
+    const pkg = JSON.parse(fs.readFileSync(path.join(base, "package.json"), "utf8"));
+    const currentVersion = pkg.version;
+    const changelog = fs.readFileSync(path.join(base, "CHANGELOG.md"), "utf8");
+    const unreleased = getUnreleasedSection(changelog);
+    if (unreleased === null) {
+        return { content: [{ type: "text", text: "CHANGELOG.md has no ## [Unreleased] section — nothing to release." }] };
+    }
+    if (!/^[-*] /m.test(unreleased)) {
+        return { content: [{ type: "text", text: "The ## [Unreleased] section has no entries — nothing to release." }] };
+    }
+    // Resolve the target version.
+    let targetVersion;
+    let how;
+    if (input.version) {
+        if (!/^\d+\.\d+\.\d+$/.test(input.version)) {
+            return { content: [{ type: "text", text: `Invalid version "${input.version}" — expected X.Y.Z.` }] };
+        }
+        targetVersion = input.version;
+        how = "explicit version";
+    }
+    else {
+        const level = input.bump ?? (/###\s+Added/.test(unreleased) ? "minor" : "patch");
+        targetVersion = bumpVersion(currentVersion, level);
+        how = input.bump ? `${level} bump` : `inferred ${level} bump (### Added present → minor, else patch)`;
+    }
+    const branch = `release/${targetVersion}`;
+    if (!input.confirmed) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `Release preview\n` +
+                        `  current: ${currentVersion}\n` +
+                        `  target:  ${targetVersion}  (${how})\n` +
+                        `  branch:  ${branch}\n\n` +
+                        `Will: bump package.json + package-lock.json, roll the CHANGELOG into "## [${targetVersion}]", ` +
+                        `commit on ${branch}, and open a PR. It will NOT tag or publish.\n\n` +
+                        `[Unreleased] entries to be released:\n${unreleased}\n\n` +
+                        `Re-call prepare_release with confirmed: true to apply.`,
+                }],
+        };
+    }
+    const baseBranch = await getDefaultBranch();
+    const previousBranch = currentBranch();
+    let prepared = false;
+    try {
+        git(["fetch", "origin"]);
+        git(["checkout", "-B", branch, `origin/${baseBranch}`]);
+        // Re-read on the base branch so edits apply to the correct content.
+        const pkgPath = path.join(base, "package.json");
+        const lockPath = path.join(base, "package-lock.json");
+        const clPath = path.join(base, "CHANGELOG.md");
+        const pkgRaw = fs.readFileSync(pkgPath, "utf8");
+        const lockRaw = fs.readFileSync(lockPath, "utf8");
+        const clRaw = fs.readFileSync(clPath, "utf8");
+        const fromVersion = JSON.parse(pkgRaw).version;
+        // The preview computed targetVersion from the working tree's version. If the
+        // base branch is actually at a different version and no explicit version was
+        // given, the inferred target would be wrong — abort rather than bump blindly.
+        if (!input.version && fromVersion !== currentVersion) {
+            throw new Error(`Base branch ${baseBranch} is at version ${fromVersion}, but the preview was based on ${currentVersion}. ` +
+                `Re-run with an explicit \`version\` to proceed.`);
+        }
+        const date = new Date().toISOString().slice(0, 10);
+        // Compute all new contents up front (with validation) so a failure can't
+        // leave a partial bump written to disk. Targeted version-field edits avoid
+        // reformatting; package-lock has two self-version fields (root + packages[""]).
+        const newPkg = replaceExactly(pkgRaw, `"version": "${fromVersion}"`, `"version": "${targetVersion}"`, 1, "package.json");
+        const newLock = replaceExactly(lockRaw, `"version": "${fromVersion}"`, `"version": "${targetVersion}"`, 2, "package-lock.json");
+        const newCl = rollChangelogForRelease(clRaw, targetVersion, fromVersion, date);
+        fs.writeFileSync(pkgPath, newPkg);
+        fs.writeFileSync(lockPath, newLock);
+        fs.writeFileSync(clPath, newCl);
+        git(["add", "package.json", "package-lock.json", "CHANGELOG.md"]);
+        git(["commit", "-m", `release: ${targetVersion}`]);
+        git(["push", "-u", "origin", branch]);
+        prepared = true;
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: `Release prep failed: ${err instanceof Error ? err.message : String(err)}` }],
+        };
+    }
+    finally {
+        if (previousBranch && previousBranch !== branch) {
+            try {
+                git(["checkout", previousBranch]);
+            }
+            catch (err) {
+                console.warn(`[okffs] Failed to restore branch ${previousBranch}:`, err instanceof Error ? err.message : err);
+            }
+        }
+    }
+    if (!prepared) {
+        return { content: [{ type: "text", text: "Release prep did not complete." }] };
+    }
+    const prBody = [
+        `## Release ${targetVersion}`,
+        ``,
+        `- Bumped \`package.json\` and \`package-lock.json\` to ${targetVersion}.`,
+        `- Rolled the CHANGELOG \`[Unreleased]\` section into \`## [${targetVersion}]\` and refreshed the compare links.`,
+        ``,
+        `After merging, tag \`v${targetVersion}\` and push it — CI (\`publish.yml\`) publishes to npm on the tag. This PR does not tag or publish.`,
+    ].join("\n");
+    let pr;
+    try {
+        pr = await createPullRequest(`Release ${targetVersion}`, prBody, branch, baseBranch);
+    }
+    catch (err) {
+        // The release branch is already pushed; only PR creation failed.
+        return {
+            content: [{
+                    type: "text",
+                    text: `Release branch \`${branch}\` was prepared and pushed (version ${targetVersion}, CHANGELOG rolled), ` +
+                        `but opening the PR failed: ${err instanceof Error ? err.message : String(err)}\n\n` +
+                        `Open a PR from \`${branch}\` into \`${baseBranch}\` manually (e.g. \`gh pr create --base ${baseBranch} --head ${branch}\`). ` +
+                        `After it merges, tag \`v${targetVersion}\` and push it to trigger the CI publish.`,
+                }],
+        };
+    }
+    return {
+        content: [{
+                type: "text",
+                text: `Prepared release ${targetVersion} (from ${currentVersion}).\n` +
+                    `Branch: ${branch}\nPR: ${pr.html_url}\n\n` +
+                    `Next: review & merge the PR, then tag \`v${targetVersion}\` and push it — CI publishes to npm. ` +
+                    `prepare_release does not tag or publish.`,
+            }],
+    };
+}
+//# sourceMappingURL=prepare_release.js.map

package/dist/tools/prepare_release.js.map

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

package/dist/tools/reply_to_review_comment.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+export declare const name = "reply_to_review_comment";
+export declare const description = "Reply to an inline PR review comment thread. Pass the pull request number, the comment id (from list_pr_review_comments), and the reply body. Use after addressing a review comment to record what was changed (e.g. reference the fix commit).";
+export declare const inputSchema: z.ZodObject<{
+    pr_number: z.ZodNumber;
+    comment_id: z.ZodNumber;
+    body: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    body: string;
+    pr_number: number;
+    comment_id: number;
+}, {
+    body: string;
+    pr_number: number;
+    comment_id: number;
+}>;
+export declare function handler(input: z.infer<typeof inputSchema>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=reply_to_review_comment.d.ts.map

package/dist/tools/reply_to_review_comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reply_to_review_comment.d.ts","sourceRoot":"","sources":["../../src/tools/reply_to_review_comment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,IAAI,4BAA4B,CAAC;AAE9C,eAAO,MAAM,WAAW,oPAC2N,CAAC;AAEpP,eAAO,MAAM,WAAW;;;;;;;;;;;;EAQtB,CAAC;AAEH,wBAAsB,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC;;;;;GAU/D"}

package/dist/tools/reply_to_review_comment.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import { replyToReviewComment } from "../github.js";
+export const name = "reply_to_review_comment";
+export const description = "Reply to an inline PR review comment thread. Pass the pull request number, the comment id (from list_pr_review_comments), and the reply body. Use after addressing a review comment to record what was changed (e.g. reference the fix commit).";
+export const inputSchema = z.object({
+    pr_number: z.number().int().positive().describe("The pull request number"),
+    comment_id: z
+        .number()
+        .int()
+        .positive()
+        .describe("The review comment id to reply to (from list_pr_review_comments)"),
+    body: z.string().describe("Reply body"),
+});
+export async function handler(input) {
+    const reply = await replyToReviewComment(input.pr_number, input.comment_id, input.body);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Replied to comment #${input.comment_id} on PR #${input.pr_number}: ${reply.html_url}`,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=reply_to_review_comment.js.map

package/dist/tools/reply_to_review_comment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reply_to_review_comment.js","sourceRoot":"","sources":["../../src/tools/reply_to_review_comment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,CAAC,MAAM,IAAI,GAAG,yBAAyB,CAAC;AAE9C,MAAM,CAAC,MAAM,WAAW,GACtB,iPAAiP,CAAC;AAEpP,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAC1E,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,CAAC,kEAAkE,CAAC;IAC/E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;CACxC,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAAkC;IAC9D,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACxF,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,uBAAuB,KAAK,CAAC,UAAU,WAAW,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,QAAQ,EAAE;aAC7F;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/resolve_review_thread.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod";
+export declare const name = "resolve_review_thread";
+export declare const description = "Mark an inline PR review thread as resolved. Pass the thread_id from list_pr_review_comments. Gated by OKFFS_RESOLVE_THREADS: when that env var is not 'true', this tool declines and leaves the thread open for the user to read and resolve manually.";
+export declare const inputSchema: z.ZodObject<{
+    thread_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    thread_id: string;
+}, {
+    thread_id: string;
+}>;
+export declare function handler(input: z.infer<typeof inputSchema>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=resolve_review_thread.d.ts.map

package/dist/tools/resolve_review_thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve_review_thread.d.ts","sourceRoot":"","sources":["../../src/tools/resolve_review_thread.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,IAAI,0BAA0B,CAAC;AAE5C,eAAO,MAAM,WAAW,4PACmO,CAAC;AAE5P,eAAO,MAAM,WAAW;;;;;;EAItB,CAAC;AAEH,wBAAsB,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC;;;;;GAiB/D"}

package/dist/tools/resolve_review_thread.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { resolveReviewThread } from "../github.js";
+import { config } from "../config.js";
+export const name = "resolve_review_thread";
+export const description = "Mark an inline PR review thread as resolved. Pass the thread_id from list_pr_review_comments. Gated by OKFFS_RESOLVE_THREADS: when that env var is not 'true', this tool declines and leaves the thread open for the user to read and resolve manually.";
+export const inputSchema = z.object({
+    thread_id: z
+        .string()
+        .describe("The review thread id to resolve (from list_pr_review_comments)"),
+});
+export async function handler(input) {
+    if (!config.resolveThreads) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Not resolving — OKFFS_RESOLVE_THREADS is not enabled. The thread is left open for you to read and resolve on GitHub. Set OKFFS_RESOLVE_THREADS=true to allow okffs to resolve threads automatically.",
+                },
+            ],
+        };
+    }
+    await resolveReviewThread(input.thread_id);
+    return {
+        content: [{ type: "text", text: `Resolved review thread ${input.thread_id}.` }],
+    };
+}
+//# sourceMappingURL=resolve_review_thread.js.map

package/dist/tools/resolve_review_thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve_review_thread.js","sourceRoot":"","sources":["../../src/tools/resolve_review_thread.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,CAAC,MAAM,IAAI,GAAG,uBAAuB,CAAC;AAE5C,MAAM,CAAC,MAAM,WAAW,GACtB,yPAAyP,CAAC;AAE5P,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CAAC,gEAAgE,CAAC;CAC9E,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAAkC;IAC9D,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAC3B,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EACF,sMAAsM;iBACzM;aACF;SACF,CAAC;IACJ,CAAC;IAED,MAAM,mBAAmB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC3C,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,0BAA0B,KAAK,CAAC,SAAS,GAAG,EAAE,CAAC;KACzF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@neturely/okffs",
+  "version": "0.2.1",
+  "description": "MCP server that connects Claude Code to GitHub — create and manage issues and branches without leaving your editor.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "okffs": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "postbuild": "node -e \"const fs=require('fs');const f='dist/index.js';const c=fs.readFileSync(f,'utf8');if(!c.startsWith('#!/usr/bin/env node'))fs.writeFileSync(f,'#!/usr/bin/env node\\n'+c);\" && chmod +x dist/index.js",
+    "dev": "node --env-file=.env --import tsx/esm src/index.ts",
+    "start": "node --env-file=.env dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "github",
+    "issues",
+    "branches",
+    "claude",
+    "claude-code",
+    "model-context-protocol",
+    "developer-tools"
+  ],
+  "author": "neturely",
+  "license": "MIT",
+  "homepage": "https://github.com/neturely/okffs#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/neturely/okffs.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "dotenv": "^17.4.2",
+    "zod": "^3.23.8",
+    "zod-to-json-schema": "^3.23.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.4.0"
+  }
+}