@pome-sh/cli 0.1.0

package/node_modules/@pome-sh/twin-github/dist/src/twin.d.ts

@@ -0,0 +1,15 @@
+import { type TwinDefinition } from "@pome-sh/sdk";
+import { type RecorderStore } from "@pome-sh/sdk/server";
+import type { Hono } from "hono";
+import { GitHubDomain } from "./domain.js";
+import { type ParsedGitHubStateSeed } from "./seed.js";
+import type { GitHubCloneDatabase, GitHubStateSeed } from "./types.js";
+export declare const githubTwinDefinition: TwinDefinition<GitHubCloneDatabase, ParsedGitHubStateSeed, GitHubDomain>;
+export type GitHubCloneAppOptions = {
+    db?: GitHubCloneDatabase;
+    seed?: GitHubStateSeed;
+    recorder?: RecorderStore;
+    runId?: string;
+};
+/** Assemble the GitHub twin app on the engine (in-process; no port bind). */
+export declare function createGitHubCloneApp(options?: GitHubCloneAppOptions): Hono;

package/node_modules/@pome-sh/twin-github/dist/src/twin.js

@@ -0,0 +1,193 @@
+// SPDX-License-Identifier: Apache-2.0
+//
+// The GitHub twin as a thin `@pome-sh/sdk` plugin (F-682). This manifest is
+// pure declaration: domain factory, seed parser, tools, routes, and the
+// wire-frozen GitHub shapes (FDRS-711 / F-712) — error envelopes, auth pins,
+// healthz extras, the 501 unsupported envelope, the /_pome/access-control
+// catalog route, the FDRS-402 tool_call_id tape pin. All mechanism (HTTP
+// mount, auth, recorder + redaction, MCP dispatch, /_pome/*, admin gate,
+// db driver) lives in the engine.
+import { ZodError } from "zod";
+import { defineTwin } from "@pome-sh/sdk";
+import { UnknownToolError, createApp, twinBuildInfo, } from "@pome-sh/sdk/server";
+import { summarizeGitHubAccessControlCatalog } from "@pome-sh/shared-types";
+import { githubAccessControlPayload } from "./access-control.js";
+import { openGitHubCloneDatabase } from "./db.js";
+import { GitHubDomain } from "./domain.js";
+import { TwinError, githubError } from "./errors.js";
+import { registerGitHubRoutes } from "./routes.js";
+import { defaultSeedState, parseSeed } from "./seed.js";
+import { executeTool, isMutatingTool, listTools, toolDefinitions } from "./tools.js";
+import { unsupportedEnvelope } from "./unsupported-envelope.js";
+// The manifest seed "schema" is parseSeed itself, duck-typed to zod's
+// parse/safeParse surface. The frozen /admin/seed wire behavior is exactly
+// parseSeed's error split — schema violation → ZodError → 422 "Validation
+// Failed"; empty body (the engine's readJson maps it to null) → SyntaxError
+// → 400 "Problems parsing JSON" — which a plain zod schema cannot reproduce.
+const seedParser = {
+    parse(input) {
+        if (input === null || input === undefined)
+            throw new SyntaxError("Problems parsing JSON");
+        return parseSeed(input);
+    },
+    safeParse(input) {
+        try {
+            return { success: true, data: seedParser.parse(input) };
+        }
+        catch (error) {
+            return { success: false, error };
+        }
+    },
+};
+function actorFromSession(session) {
+    return typeof session?.login === "string" ? session.login : undefined;
+}
+// The engine's `/mcp/call` parses with its own zod instance, so a bare
+// `instanceof ZodError` can miss; fall back to the duck check on `name`.
+function zodIssues(err) {
+    if (err instanceof ZodError)
+        return err.issues;
+    if (err instanceof Error && err.name === "ZodError" && Array.isArray(err.issues)) {
+        return err.issues;
+    }
+    return undefined;
+}
+/**
+ * Wire-frozen GitHub error projection: `{message, documentation_url,
+ * status, errors?}` (githubError). Statuses: TwinError carries its own;
+ * validation (Zod or unknown tool) → 422 "Validation Failed"; JSON parse →
+ * 400; anything else → 500 so platform retries / alerting kick in.
+ */
+function githubErrorEnvelope(err) {
+    if (err instanceof UnknownToolError) {
+        // Frozen legacy-dispatch behavior: an unknown tool is a 422 validation
+        // failure on the `tool` field (pre-port executeTool → validationFailed).
+        return {
+            status: 422,
+            body: githubError("Validation Failed", 422, [
+                { resource: "Request", field: "tool", code: "invalid", value: err.tool },
+            ]),
+        };
+    }
+    if (err instanceof TwinError) {
+        return { status: err.status, body: githubError(err.message, err.status, err.errors) };
+    }
+    const issues = zodIssues(err);
+    if (issues) {
+        return {
+            status: 422,
+            body: githubError("Validation Failed", 422, issues.map((issue) => ({
+                resource: "Request",
+                field: issue.path.join("."),
+                code: issue.code,
+            }))),
+        };
+    }
+    if (err instanceof SyntaxError) {
+        return { status: 400, body: githubError("Problems parsing JSON", 400) };
+    }
+    return {
+        status: 500,
+        body: githubError(err instanceof Error ? err.message : "Internal Server Error", 500),
+    };
+}
+// listTools() carries the frozen tool-list wire shape: the twin-zod
+// serialization emitted on both list surfaces since before the port.
+const toolListing = new Map(listTools().map((tool) => [tool.name, tool]));
+export const githubTwinDefinition = defineTwin({
+    id: "github",
+    version: process.env.POME_TWIN_VERSION ?? "0.1.0",
+    implementation: "github_clone",
+    packageName: "@pome-sh/twin-github",
+    fidelity: { default: "semantic" },
+    seed: seedParser,
+    domain: ({ db, seed }) => {
+        const domain = new GitHubDomain(db ?? openGitHubCloneDatabase());
+        if (seed !== undefined)
+            domain.seed(seed);
+        return domain;
+    },
+    routes: registerGitHubRoutes,
+    state: ({ domain }) => domain.exportState(),
+    admin: {
+        reset: ({ domain, reportDelta }) => {
+            domain.seed(defaultSeedState(), reportDelta);
+            return { ok: true, message: "GitHub twin state reset to default seed." };
+        },
+        seed: ({ domain, seed, reportDelta }) => {
+            domain.seed(seed, reportDelta);
+            return { ok: true, repositories: seed.repositories.length };
+        },
+        // The admin-gate 403 body is the gate's default GitHub envelope
+        // ({message: "Forbidden"}); no per-twin override needed.
+    },
+    tools: toolDefinitions.map((def) => ({
+        name: def.name,
+        description: def.description,
+        schema: def.schema,
+        mutation: isMutatingTool(def.name),
+        inputSchema: toolListing.get(def.name)?.input_schema,
+        handler: (domain, args, ctx) => executeTool(domain, def.name, args, ctx.reportDelta, {
+            actor: actorFromSession(ctx.session),
+        }),
+    })),
+    // Frozen healthz shape: {ok, twin, implementation, fidelity, tools,
+    // access_control, runtime} — no version field (github never carried it).
+    healthz: () => ({
+        fidelity: "semantic",
+        access_control: summarizeGitHubAccessControlCatalog(),
+    }),
+    // Frozen per-session health shape: implementation + fidelity + runtime,
+    // no version (pre-port /_pome/health).
+    pomeHealth: () => ({
+        implementation: "github_clone",
+        fidelity: "semantic",
+        runtime: twinBuildInfo("@pome-sh/twin-github"),
+    }),
+    // Frozen extra session route (CONTRACT.md per-twin table).
+    pomeRoutes: {
+        "access-control": () => githubAccessControlPayload(),
+    },
+    // FDRS-402 adapter-rich tape pin: x-pome-correlation-id persists as
+    // tool_call_id on every recorded event (github's frozen tape shape).
+    stampToolCallId: true,
+    // Frozen JSON-RPC unknown-tool result text (the legacy /mcp/call surface
+    // keeps the 422 validation envelope from errorEnvelope above).
+    mcpUnknownTool: (name) => ({ message: `Unknown tool: ${name}` }),
+    unsupported: () => unsupportedEnvelope,
+    errorEnvelope: githubErrorEnvelope,
+    auth: {
+        // F-712 pins (wire-frozen): Bearer-header only (no extra token
+        // resolvers), raw bearer rejected (allowRawBearer=false), sid mismatch
+        // → 401 {message:"Forbidden"}, and every credential failure — expired
+        // JWT included — renders 401 {message:"Bad credentials"}. The pre-port
+        // explicit "Token expired" branch was dead code: hono/jwt's verify
+        // throws JwtTokenExpired before the branch was ever reached, so the
+        // wire always said "Bad credentials" (pre-ruled: deleting it is zero
+        // wire diff).
+        providerToken: { provider: "github", prefixes: ["ghp_pome_", "github_pat_pome_"] },
+        allowRawBearer: false,
+        unauthorized: () => ({
+            status: 401,
+            body: { message: "Bad credentials", documentation_url: "" },
+        }),
+        sidMismatch: () => ({
+            status: 401,
+            body: { message: "Forbidden", documentation_url: "" },
+        }),
+        sessionExtras: (claims) => typeof claims.login === "string" && claims.login.length > 0 ? { login: claims.login } : {},
+    },
+});
+/** Assemble the GitHub twin app on the engine (in-process; no port bind). */
+export function createGitHubCloneApp(options = {}) {
+    return createApp(githubTwinDefinition, {
+        db: options.db ?? openGitHubCloneDatabase(),
+        recorder: options.recorder,
+        runId: options.runId ?? "local",
+        // Pre-port factory semantics: an explicit `db` carries its own state
+        // (the boot path seeds before binding); otherwise seed the supplied or
+        // default world.
+        seed: options.db ? undefined : (options.seed ?? defaultSeedState()),
+    });
+}
+//# sourceMappingURL=twin.js.map

package/node_modules/@pome-sh/twin-github/dist/src/twin.js.map

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

package/node_modules/@pome-sh/twin-github/dist/src/types.d.ts

@@ -0,0 +1,244 @@
+import type { TwinDatabase } from "@pome-sh/sdk";
+export type { RecorderEvent } from "@pome-sh/shared-types";
+export type GitHubCloneDatabase = TwinDatabase;
+export type GitHubStateSeed = {
+    users?: SeedUser[];
+    repositories: SeedRepository[];
+};
+export type SeedUser = {
+    login: string;
+    type?: "User" | "Organization";
+    name?: string;
+};
+export type SeedRepository = {
+    owner: string;
+    name: string;
+    description?: string;
+    private?: boolean;
+    default_branch?: string;
+    collaborators?: string[];
+    labels?: Array<{
+        name: string;
+        color?: string;
+        description?: string;
+    }>;
+    files?: Array<{
+        path: string;
+        content: string;
+        branch?: string;
+    }>;
+    issues?: Array<{
+        number?: number;
+        title: string;
+        body?: string;
+        state?: "open" | "closed";
+        labels?: string[];
+        assignees?: string[];
+    }>;
+    pull_requests?: Array<{
+        number?: number;
+        title: string;
+        body?: string;
+        head: string;
+        base?: string;
+        state?: "open" | "closed";
+        author?: string;
+        reviews?: Array<{
+            author: string;
+            state?: "APPROVED" | "CHANGES_REQUESTED" | "COMMENTED";
+            body?: string;
+        }>;
+        statuses?: Array<{
+            context?: string;
+            state?: "error" | "failure" | "pending" | "success";
+            description?: string;
+        }>;
+    }>;
+};
+export type RepoRow = {
+    id: number;
+    owner: string;
+    name: string;
+    full_name: string;
+    description: string;
+    private: 0 | 1;
+    default_branch: string;
+    fork: 0 | 1;
+    parent_full_name: string | null;
+    entity_counter: number;
+    created_at: string;
+    updated_at: string;
+};
+export type BranchRow = {
+    id: number;
+    repo_id: number;
+    name: string;
+    head_sha: string | null;
+    created_at: string;
+    updated_at: string;
+};
+export type CommitRow = {
+    sha: string;
+    repo_id: number;
+    message: string;
+    author_login: string;
+    committer_login: string;
+    parent_sha: string | null;
+    tree_sha: string;
+    created_at: string;
+};
+export type FileRow = {
+    repo_id: number;
+    branch: string;
+    path: string;
+    content: string;
+    sha: string;
+    size: number;
+    updated_at: string;
+};
+export type LabelRow = {
+    repo_id: number;
+    name: string;
+    color: string;
+    description: string;
+};
+export type IssueRow = {
+    repo_id: number;
+    number: number;
+    title: string;
+    body: string;
+    state: "open" | "closed";
+    user_login: string;
+    assignee_login: string | null;
+    created_at: string;
+    updated_at: string;
+    closed_at: string | null;
+};
+export type IssueCommentRow = {
+    id: number;
+    repo_id: number;
+    issue_number: number;
+    body: string;
+    user_login: string;
+    created_at: string;
+    updated_at: string;
+};
+export type PullRequestRow = {
+    repo_id: number;
+    number: number;
+    title: string;
+    body: string;
+    state: "open" | "closed";
+    user_login: string;
+    head_repo_id: number;
+    head_ref: string;
+    head_sha: string | null;
+    base_repo_id: number;
+    base_ref: string;
+    base_sha: string | null;
+    merged: 0 | 1;
+    merge_commit_sha: string | null;
+    created_at: string;
+    updated_at: string;
+    closed_at: string | null;
+    merged_at: string | null;
+};
+export type PullRequestReviewRow = {
+    id: number;
+    repo_id: number;
+    pull_number: number;
+    user_login: string;
+    state: "APPROVED" | "CHANGES_REQUESTED" | "COMMENTED";
+    body: string;
+    commit_sha: string | null;
+    submitted_at: string;
+};
+export type PullRequestFileRow = {
+    repo_id: number;
+    pull_number: number;
+    filename: string;
+    status: "added" | "modified" | "removed" | "renamed";
+    additions: number;
+    deletions: number;
+    changes: number;
+    blob_url: string;
+    raw_url: string;
+    contents_url: string;
+    patch: string;
+};
+export type CommitStatusRow = {
+    id: number;
+    repo_id: number;
+    sha: string;
+    state: "error" | "failure" | "pending" | "success";
+    context: string;
+    description: string;
+    target_url: string;
+    created_at: string;
+    updated_at: string;
+};
+export type MilestoneRow = {
+    repo_id: number;
+    number: number;
+    title: string;
+    state: "open" | "closed";
+    description: string;
+    due_on: string | null;
+    creator_login: string;
+    created_at: string;
+    updated_at: string;
+    closed_at: string | null;
+};
+export type TagRow = {
+    repo_id: number;
+    name: string;
+    commit_sha: string;
+    created_at: string;
+};
+export type ReleaseRow = {
+    id: number;
+    repo_id: number;
+    tag_name: string;
+    target_commitish: string;
+    name: string | null;
+    body: string;
+    draft: 0 | 1;
+    prerelease: 0 | 1;
+    author_login: string;
+    created_at: string;
+    published_at: string | null;
+};
+export type CheckRunRow = {
+    id: number;
+    repo_id: number;
+    head_sha: string;
+    name: string;
+    status: "queued" | "in_progress" | "completed";
+    conclusion: "success" | "failure" | "neutral" | "cancelled" | "timed_out" | "action_required" | "skipped" | "stale" | null;
+    details_url: string;
+    external_id: string;
+    output_title: string | null;
+    output_summary: string | null;
+    started_at: string;
+    completed_at: string | null;
+};
+export type PullRequestReviewCommentRow = {
+    id: number;
+    repo_id: number;
+    pull_number: number;
+    path: string;
+    body: string;
+    user_login: string;
+    created_at: string;
+    updated_at: string;
+    line: number | null;
+    side: "LEFT" | "RIGHT" | null;
+    commit_sha: string | null;
+    in_reply_to_id: number | null;
+};
+export type CollaboratorRow = {
+    repo_id: number;
+    login: string;
+    permission: string;
+    invitation_state: "pending" | "accepted";
+};

package/node_modules/@pome-sh/twin-github/dist/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/node_modules/@pome-sh/twin-github/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/node_modules/@pome-sh/twin-github/dist/src/unsupported-envelope.d.ts

@@ -0,0 +1,10 @@
+export declare const unsupportedEnvelope: {
+    readonly status: 501;
+    readonly body: {
+        readonly message: "This endpoint is not supported by this GitHub twin clone.";
+        readonly _twin: {
+            readonly fidelity: "unsupported";
+            readonly supported_surfaces: readonly ["GitHub-shaped REST", "POST /s/:sid/mcp", "GET /s/:sid/mcp/tools", "POST /s/:sid/mcp/tools/:name", "POST /s/:sid/mcp/call"];
+        };
+    };
+};

package/node_modules/@pome-sh/twin-github/dist/src/unsupported-envelope.js

@@ -0,0 +1,27 @@
+// SPDX-License-Identifier: Apache-2.0
+//
+// Canonical loud-501 "unsupported route" envelope for the GitHub twin.
+//
+// Twin-only metadata (`fidelity`, `supported_surfaces`) lives under the `_twin`
+// namespace, matching twin-slack / twin-stripe (FDRS-431 clean cutover). Kept in
+// this dependency-light module — no sqlite, no http, no hono — so the cross-twin
+// this dependency-light module — no sqlite, no http, no hono — so mirror
+// lint scripts can import the real wire shape without booting the app. `app.ts` builds its catch-all body from
+// here, so the lint can never drift from what ships.
+export const unsupportedEnvelope = {
+    status: 501,
+    body: {
+        message: "This endpoint is not supported by this GitHub twin clone.",
+        _twin: {
+            fidelity: "unsupported",
+            supported_surfaces: [
+                "GitHub-shaped REST",
+                "POST /s/:sid/mcp",
+                "GET /s/:sid/mcp/tools",
+                "POST /s/:sid/mcp/tools/:name",
+                "POST /s/:sid/mcp/call",
+            ],
+        },
+    },
+};
+//# sourceMappingURL=unsupported-envelope.js.map

package/node_modules/@pome-sh/twin-github/dist/src/unsupported-envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsupported-envelope.js","sourceRoot":"","sources":["../../src/unsupported-envelope.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,uEAAuE;AACvE,EAAE;AACF,gFAAgF;AAChF,iFAAiF;AACjF,iFAAiF;AACjF,yEAAyE;AACzE,+GAA+G;AAC/G,qDAAqD;AAErD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,MAAM,EAAE,GAAG;IACX,IAAI,EAAE;QACJ,OAAO,EAAE,2DAA2D;QACpE,KAAK,EAAE;YACL,QAAQ,EAAE,aAAsB;YAChC,kBAAkB,EAAE;gBAClB,oBAAoB;gBACpB,kBAAkB;gBAClB,uBAAuB;gBACvB,8BAA8B;gBAC9B,uBAAuB;aACxB;SACF;KACF;CACO,CAAC"}

package/node_modules/@pome-sh/twin-github/dist/src/upstream-types.d.ts

@@ -0,0 +1,30 @@
+import type { components } from "@octokit/openapi-types";
+export type PullRequest = components["schemas"]["pull-request"];
+export type Repository = components["schemas"]["repository"];
+export type SimpleUser = components["schemas"]["simple-user"];
+export type Issue = components["schemas"]["issue"];
+export type IssueComment = components["schemas"]["issue-comment"];
+export type Label = components["schemas"]["label"];
+export type Milestone = components["schemas"]["milestone"];
+export type PullRequestReview = components["schemas"]["pull-request-review"];
+export type DiffEntry = components["schemas"]["diff-entry"];
+export type ReviewComment = components["schemas"]["review-comment"];
+export type CommitComparison = components["schemas"]["commit-comparison"];
+export type Commit = components["schemas"]["commit"];
+export type ShortBranch = components["schemas"]["short-branch"];
+export type ContentFile = components["schemas"]["content-file"];
+export type ContentDirectoryEntry = components["schemas"]["content-directory"];
+export type Tag = components["schemas"]["tag"];
+export type CommitWithFiles = Commit;
+export type Status = components["schemas"]["status"];
+export type CombinedStatus = components["schemas"]["combined-commit-status"];
+export type CheckRun = components["schemas"]["check-run"];
+export type Release = components["schemas"]["release"];
+export type AuthenticatedUser = components["schemas"]["private-user"];
+export type PullRequestSimple = PullRequest;
+export type DeepPartial<T> = T extends (infer U)[] ? Array<DeepPartial<U>> : T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T;
+export type AssertNoUncovered<Upstream, Emitted, Allow extends PropertyKey> = Exclude<keyof Upstream, keyof Emitted | Allow> extends never ? true : {
+    __UNCOVERED_UPSTREAM_FIELDS__: Exclude<keyof Upstream, keyof Emitted | Allow>;
+};

package/node_modules/@pome-sh/twin-github/dist/src/upstream-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=upstream-types.js.map

package/node_modules/@pome-sh/twin-github/dist/src/upstream-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upstream-types.js","sourceRoot":"","sources":["../../src/upstream-types.ts"],"names":[],"mappings":""}

package/node_modules/@pome-sh/twin-github/dist/src/util.d.ts

@@ -0,0 +1,12 @@
+export declare function nowIso(): string;
+export declare function stableNumericId(input: string): number;
+export declare function makeSha(...parts: unknown[]): string;
+export declare function fileSha(content: string): string;
+export declare function treeSha(paths: string[]): string;
+export declare function encodeContent(content: string): string;
+export declare function decodeMaybeBase64(content: string, encoding?: string): string;
+export declare function paginate<T>(items: T[], page?: number, perPage?: number): T[];
+export declare function linesChanged(before: string | undefined, after: string): {
+    additions: number;
+    deletions: number;
+};

package/node_modules/@pome-sh/twin-github/dist/src/util.js

@@ -0,0 +1,63 @@
+// SPDX-License-Identifier: Apache-2.0
+//
+// GitHub-domain helpers only (F-682): timestamps, sha fabrication, content
+// encoding, pagination, diff-stat counting. Request-id stamping moved to
+// the engine's recorder with the port.
+import { createHash, randomUUID } from "node:crypto";
+export function nowIso() {
+    return new Date().toISOString();
+}
+export function stableNumericId(input) {
+    let hash = 0;
+    for (const char of input) {
+        hash = (hash * 31 + char.charCodeAt(0)) >>> 0;
+    }
+    return hash;
+}
+export function makeSha(...parts) {
+    return createHash("sha1")
+        .update(JSON.stringify(parts))
+        .update(randomUUID())
+        .digest("hex");
+}
+export function fileSha(content) {
+    return createHash("sha1").update(`blob ${Buffer.byteLength(content)}\0${content}`).digest("hex");
+}
+export function treeSha(paths) {
+    return createHash("sha1").update(paths.sort().join("\n")).digest("hex");
+}
+export function encodeContent(content) {
+    return Buffer.from(content, "utf8").toString("base64");
+}
+export function decodeMaybeBase64(content, encoding) {
+    if (encoding === "base64") {
+        return Buffer.from(content, "base64").toString("utf8");
+    }
+    return content;
+}
+export function paginate(items, page = 1, perPage = 30) {
+    const safePage = Math.max(1, page);
+    const safePerPage = Math.min(100, Math.max(1, perPage));
+    const start = (safePage - 1) * safePerPage;
+    return items.slice(start, start + safePerPage);
+}
+export function linesChanged(before, after) {
+    if (before === undefined) {
+        return { additions: after.split("\n").filter(Boolean).length || 1, deletions: 0 };
+    }
+    const oldLines = before.split("\n");
+    const newLines = after.split("\n");
+    let additions = 0;
+    let deletions = 0;
+    const max = Math.max(oldLines.length, newLines.length);
+    for (let index = 0; index < max; index += 1) {
+        if (oldLines[index] === newLines[index])
+            continue;
+        if (newLines[index] !== undefined)
+            additions += 1;
+        if (oldLines[index] !== undefined)
+            deletions += 1;
+    }
+    return { additions, deletions };
+}
+//# sourceMappingURL=util.js.map

package/node_modules/@pome-sh/twin-github/dist/src/util.js.map

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