pm-github 2026.10.28 → 2026.10.30

package/dist/discussion-schema.d.ts

@@ -0,0 +1,110 @@
+/** Shared bounded contracts for explicit selections, lossless evidence and receipts. */
+import { z } from "zod";
+/** One strict request schema also validates JSON/TOON-decoded round trips. Offsets count UTF-16 code units. */
+export declare const discussionRequestSchema: z.ZodObject<{
+    repo: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    issue: z.ZodNumber;
+    item: z.ZodString;
+    selections: z.ZodArray<z.ZodObject<{
+        comment: z.ZodNumber;
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+        quote: z.ZodString;
+        marked: z.ZodLiteral<true>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+/** SDK callers supply exactly the same selection document as CLI users. */
+export type DiscussionCaptureInput = z.input<typeof discussionRequestSchema>;
+/** Project the public comment wire envelope through the same author and numeric domains as evidence. */
+export declare const discussionSourceSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    body: z.ZodString;
+    issue_url: z.ZodString;
+    html_url: z.ZodString;
+    updated_at: z.ZodString;
+    user: z.ZodObject<{
+        id: z.ZodNumber;
+        login: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** Exact quoted bytes are JSON data, never a template, command or instruction. */
+export declare const discussionEvidenceSchema: z.ZodObject<{
+    type: z.ZodLiteral<"github.discussion-decision.v1">;
+    repo: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    issue: z.ZodNumber;
+    comment: z.ZodNumber;
+    url: z.ZodString;
+    revision: z.ZodString;
+    author: z.ZodObject<{
+        id: z.ZodNumber;
+        login: z.ZodString;
+    }, z.core.$strict>;
+    updatedAt: z.ZodString;
+    span: z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+        quote: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+/** Evidence can be handed to a citation workflow without inventing another citation store. */
+export type DiscussionDecisionEvidence = z.infer<typeof discussionEvidenceSchema>;
+/** Every producer uses this validator before returning a successful finite, bounded receipt. */
+export declare const discussionReportSchema: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    mode: z.ZodEnum<{
+        apply: "apply";
+        plan: "plan";
+    }>;
+    approval: z.ZodString;
+    item: z.ZodString;
+    status: z.ZodString;
+    selected: z.ZodNumber;
+    created: z.ZodNumber;
+    unchanged: z.ZodNumber;
+    skipped: z.ZodNumber;
+    refused: z.ZodNumber;
+    rows: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        state: z.ZodEnum<{
+            create: "create";
+            created: "created";
+            refused: "refused";
+            skipped: "skipped";
+            unchanged: "unchanged";
+        }>;
+        reason: z.ZodEnum<{
+            already_captured: "already_captured";
+            captured: "captured";
+            duplicate_selection: "duplicate_selection";
+            foreign_or_edited: "foreign_or_edited";
+            invalid_selection: "invalid_selection";
+            native_refused: "native_refused";
+            selected_marked_span: "selected_marked_span";
+            source_changed: "source_changed";
+            source_unavailable: "source_unavailable";
+            write_failed: "write_failed";
+        }>;
+        remedy: z.ZodString;
+        evidence: z.ZodNullable<z.ZodObject<{
+            type: z.ZodLiteral<"github.discussion-decision.v1">;
+            repo: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+            issue: z.ZodNumber;
+            comment: z.ZodNumber;
+            url: z.ZodString;
+            revision: z.ZodString;
+            author: z.ZodObject<{
+                id: z.ZodNumber;
+                login: z.ZodString;
+            }, z.core.$strict>;
+            updatedAt: z.ZodString;
+            span: z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+                quote: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+/** Compact agent receipt includes complete selected quotes, with no unrelated discussion prose. */
+export type DiscussionCaptureReport = z.infer<typeof discussionReportSchema>;
+//# sourceMappingURL=discussion-schema.d.ts.map

package/dist/discussion-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discussion-schema.d.ts","sourceRoot":"","sources":["../discussion-schema.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,+GAA+G;AAC/G,eAAO,MAAM,uBAAuB;;;;;;;;;;;kBAGlC,CAAC;AACH,2EAA2E;AAC3E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE7E,wGAAwG;AACxG,eAAO,MAAM,sBAAsB;;;;;;;;;;iBAGjC,CAAC;AAEH,kFAAkF;AAClF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;kBAKnC,CAAC;AACH,8FAA8F;AAC9F,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAElF,gGAAgG;AAChG,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAUjC,CAAC;AACH,mGAAmG;AACnG,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/discussion-schema.js

@@ -0,0 +1,41 @@
+/** Shared bounded contracts for explicit selections, lossless evidence and receipts. */
+import { z } from "zod";
+const integer = z.number().int().min(0).max(Number.MAX_SAFE_INTEGER);
+const positive = integer.min(1);
+const digest = z.string().regex(/^[a-f0-9]{64}$/);
+const nativeName = z.string().min(1).max(512).regex(/^[^\r\n\u0000/\\]+$/);
+const nativeStatus = z.string().min(1).max(512).regex(/^[^\r\n\u0000]+$/);
+const authorFields = { id: positive, login: z.string().min(1).max(200).regex(/^[A-Za-z0-9_.-]+(?:\[bot\])?$/) };
+const repo = z.string().regex(/^[A-Za-z0-9][A-Za-z0-9-]{0,38}\/(?!\.{1,2}$)[A-Za-z0-9_.-]{1,100}$/).transform(value => value.toLowerCase());
+const selection = z.strictObject({ comment: positive, start: integer.max(65536), end: positive.max(65536), quote: z.string().min(1).max(4096), marked: z.literal(true) });
+/** One strict request schema also validates JSON/TOON-decoded round trips. Offsets count UTF-16 code units. */
+export const discussionRequestSchema = z.strictObject({
+    repo,
+    issue: positive, item: nativeName, selections: z.array(selection).max(10),
+});
+/** Project the public comment wire envelope through the same author and numeric domains as evidence. */
+export const discussionSourceSchema = z.object({
+    id: positive, body: z.string().max(65536), issue_url: z.string().max(512), html_url: z.string().max(512),
+    updated_at: z.string().datetime({ offset: true }), user: z.object(authorFields),
+});
+/** Exact quoted bytes are JSON data, never a template, command or instruction. */
+export const discussionEvidenceSchema = z.strictObject({
+    type: z.literal("github.discussion-decision.v1"), repo, issue: positive,
+    comment: positive, url: z.string().url().max(512), revision: digest,
+    author: z.strictObject(authorFields), updatedAt: z.string().datetime({ offset: true }),
+    span: z.strictObject({ start: integer.max(65536), end: positive.max(65536), quote: z.string().min(1).max(4096) }).refine(value => value.end > value.start && value.end - value.start === value.quote.length),
+});
+/** Every producer uses this validator before returning a successful finite, bounded receipt. */
+export const discussionReportSchema = z.strictObject({
+    ok: z.literal(true), mode: z.enum(["plan", "apply"]), approval: digest, item: nativeName, status: nativeStatus,
+    selected: integer.max(10), created: integer.max(10), unchanged: integer.max(10), skipped: integer.max(10), refused: integer.max(10),
+    rows: z.array(z.strictObject({
+        id: nativeName, state: z.enum(["create", "created", "unchanged", "skipped", "refused"]),
+        reason: z.enum(["selected_marked_span", "already_captured", "foreign_or_edited", "duplicate_selection", "source_unavailable", "source_changed", "invalid_selection", "captured", "write_failed", "native_refused"]),
+        remedy: z.string().max(300), evidence: discussionEvidenceSchema.nullable(),
+    })).max(10),
+}).superRefine((value, ctx) => {
+    if (value.rows.length !== value.selected || ["created", "unchanged", "skipped", "refused"].some(state => value[state] !== value.rows.filter(row => row.state === state).length))
+        ctx.addIssue({ code: "custom", message: "Receipt counters must equal row states" });
+});
+//# sourceMappingURL=discussion-schema.js.map

package/dist/discussion-schema.js.map

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

package/dist/discussions.d.ts

@@ -0,0 +1,26 @@
+import type { ExtensionCommandSdk } from "@unbrained/pm-cli/sdk/authoring";
+import { type DiscussionCaptureInput, type DiscussionCaptureReport } from "./discussion-schema.ts";
+/** Stable refusals do not echo source text, provider responses or local paths. */
+export type DiscussionRefusalCode = "invalid_selection" | "host_required" | "source_unavailable" | "source_changed" | "target_unavailable" | "stale_plan" | "invalid_output";
+/** Selected comment reader allows real HTTP adapters without SDK mocks. */
+export type DiscussionCommentReader = (repo: string, issue: number, comment: number) => Promise<unknown>;
+/** Apply requires the exact preview digest; omitted approval is a read-only plan. */
+export interface DiscussionCaptureOptions {
+    approval?: string;
+    maxOutputBytes?: number;
+    readComment?: DiscussionCommentReader;
+}
+/** Typed expected failure with one bounded, actionable recovery instruction. */
+export declare function refuseDiscussion(code: DiscussionRefusalCode, remedy: string): never;
+/** Fetch only the selected issue and comment; PR review threads are owned by pm-review. */
+export declare function readGithubDiscussionComment(repo: string, issue: number, comment: number): Promise<unknown>;
+/** Bound and validate every successful producer result before a write or response. */
+export declare function validateDiscussionCaptureReport(value: unknown, maxOutputBytes?: number): DiscussionCaptureReport;
+/**
+ * Preview and apply share source preparation, ownership checks and native create options.
+ * Independent creates need no frozen journal or compensation. Retry always reads current
+ * sources, parent history and each Decision. A workspace transaction would not exclude
+ * ordinary SDK writers: the final read-to-create window remains explicitly optimistic.
+ */
+export declare function captureGithubDiscussion(pmPath: string, value: DiscussionCaptureInput, sdk: ExtensionCommandSdk | undefined, options?: DiscussionCaptureOptions): Promise<DiscussionCaptureReport>;
+//# sourceMappingURL=discussions.d.ts.map

package/dist/discussions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discussions.d.ts","sourceRoot":"","sources":["../discussions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAG3E,OAAO,EAAqG,KAAK,sBAAsB,EAAE,KAAK,uBAAuB,EAAmC,MAAM,wBAAwB,CAAC;AAGvO,kFAAkF;AAClF,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,GAAG,eAAe,GAAG,oBAAoB,GAAG,gBAAgB,GAAG,oBAAoB,GAAG,YAAY,GAAG,gBAAgB,CAAC;AAC7K,2EAA2E;AAC3E,MAAM,MAAM,uBAAuB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AACzG,qFAAqF;AACrF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,uBAAuB,CAAC;CAGvC;AACD,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAEnF;AAID,2FAA2F;AAC3F,wBAAsB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAWhH;AAmED,sFAAsF;AACtF,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,SAAQ,GAAG,uBAAuB,CAM/G;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,EAAE,GAAG,EAAE,mBAAmB,GAAG,SAAS,EAAE,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAmF3M"}

package/dist/discussions.js

@@ -0,0 +1,215 @@
+/** Explicit GitHub issue-comment decisions, persisted only through the host-injected SDK. */
+import { createHash } from "node:crypto";
+import { createPmCliExpectedError, getHistoryPath, readHistorySnapshot, normalizeItemId, previewItemMutations, locateItem, readLocatedItem } from "@unbrained/pm-cli/sdk";
+import { readGithubWorkspace } from "./workspace.js";
+import { fetchJSON, githubApiBase, resolveGitHubToken } from "./index.js";
+import { discussionRequestSchema, discussionSourceSchema, discussionEvidenceSchema, discussionReportSchema } from "./discussion-schema.js";
+import { z } from "zod";
+/** Typed expected failure with one bounded, actionable recovery instruction. */
+export function refuseDiscussion(code, remedy) {
+    throw createPmCliExpectedError(`GitHub discussion capture: ${code}. ${remedy}`, { exitCode: 2, context: { code, required: remedy } });
+}
+/** Hash exact source bytes and SDK history, never a handwritten native normalizer. */
+function hash(value) { return createHash("sha256").update(JSON.stringify(value)).digest("hex"); }
+/** Fetch only the selected issue and comment; PR review threads are owned by pm-review. */
+export async function readGithubDiscussionComment(repo, issue, comment) {
+    try {
+        const token = resolveGitHubToken();
+        const issueResult = await fetchJSON(`${githubApiBase()}/repos/${repo}/issues/${issue}`, token);
+        if (issueResult.status !== 200 || Buffer.byteLength(issueResult.body) > 262144)
+            throw new Error("incomplete issue");
+        const issueRow = z.object({ number: z.number(), pull_request: z.unknown().optional() }).parse(JSON.parse(issueResult.body));
+        if (issueRow.pull_request !== undefined || issueRow.number !== issue)
+            throw new Error("not an issue");
+        const result = await fetchJSON(`${githubApiBase()}/repos/${repo}/issues/comments/${comment}`, token);
+        if (result.status !== 200 || Buffer.byteLength(result.body) > 524288)
+            throw new Error("incomplete comment");
+        return JSON.parse(result.body);
+    }
+    catch {
+        refuseDiscussion("source_unavailable", "Restore read access to the selected GitHub issue and comment; PR review comments use pm-review.");
+    }
+}
+/** Validate remote attribution, exact issue membership and the explicitly marked span. */
+async function evidence(input, selected, reader) {
+    let raw;
+    try {
+        raw = await reader(input.repo, input.issue, selected.comment);
+    }
+    catch {
+        refuseDiscussion("source_unavailable", "Restore read access to this selected issue comment and preview again.");
+    }
+    const parsed = discussionSourceSchema.safeParse(raw);
+    if (!parsed.success)
+        refuseDiscussion("source_unavailable", "Fetch a complete bounded comment with author, body and update timestamp; preview again.");
+    const source = parsed.data;
+    const url = `https://github.com/${input.repo}/issues/${input.issue}#issuecomment-${selected.comment}`;
+    if (source.id !== selected.comment || source.issue_url.toLowerCase() !== `https://api.github.com/repos/${input.repo}/issues/${input.issue}` || source.html_url.toLowerCase() !== url) {
+        refuseDiscussion("invalid_selection", "Select a comment belonging to the exact repository and issue; cross-issue and PR passages are refused.");
+    }
+    if (selected.end <= selected.start || source.body.slice(selected.start, selected.end) !== selected.quote || selected.end > source.body.length) {
+        refuseDiscussion("source_changed", "Read the current comment and select exact UTF-16 start/end offsets and quote bytes again.");
+    }
+    return discussionEvidenceSchema.parse({ type: "github.discussion-decision.v1", repo: input.repo, issue: input.issue,
+        comment: source.id, url, revision: hash([source.id, source.body, source.issue_url, source.html_url, source.updated_at, source.user.id, source.user.login]), author: source.user, updatedAt: source.updated_at,
+        span: { start: selected.start, end: selected.end, quote: selected.quote } });
+}
+/** SDK history length plus exact stream digest prevents content-only ABA approvals. */
+async function revision(pmRoot, id) {
+    const snapshot = await readHistorySnapshot(getHistoryPath(pmRoot, id), id);
+    if (!snapshot.entries.length)
+        refuseDiscussion("target_unavailable", "Restore readable native item history before capturing a related Decision.");
+    return `${snapshot.entries.length}:${hash(snapshot.raw)}`;
+}
+/** Native document reads avoid command-level usage recording during a read-only plan. */
+async function nativeItem(workspace, id) {
+    const located = await locateItem(workspace.pmRoot, id, workspace.settings.id_prefix, workspace.settings.item_format, workspace.types.type_to_folder);
+    return located ? (await readLocatedItem(located, { schema: workspace.settings.schema })).document : undefined;
+}
+/** Read the current deterministic target. Foreign or edited records are preserved individually. */
+async function target(workspace, id, marker, body) {
+    try {
+        const document = await nativeItem(workspace, id);
+        const snapshot = await readHistorySnapshot(getHistoryPath(workspace.pmRoot, id), id);
+        if (!document)
+            return snapshot.raw === null
+                ? { state: "create", revision: null, reason: "selected_marked_span" }
+                : { state: "skipped", revision: `${snapshot.entries.length}:${hash(snapshot.raw)}`, reason: "foreign_or_edited" };
+        const message = snapshot.entries[0]?.message;
+        const owned = snapshot.entries.length === 1 && typeof message === "string" && (message === marker || message.startsWith(`${marker} | `)) && document.body === body && document.metadata.type === "Decision";
+        return { state: owned ? "unchanged" : "skipped", revision: owned ? null : await revision(workspace.pmRoot, id), reason: owned ? "already_captured" : "foreign_or_edited" };
+    }
+    catch {
+        return { state: "skipped", revision: "unreadable", reason: "foreign_or_edited" };
+    }
+}
+/** One native producer is shared by semantic preview and the actual SDK create. */
+function nativeCreate(id, parent, source, marker, status) {
+    return { id, type: "Decision", title: `GitHub issue #${source.issue} decision`, status,
+        description: `Selected GitHub issue-comment evidence: ${source.url}`, body: JSON.stringify(source),
+        parent, clearDeps: true, unset: ["sprint", "release", "goal", "objective"],
+        tags: "github-discussion-decision", message: marker,
+        doc: [`path: ${source.url}\nscope: project\nnote: Source revision ${source.revision}`] };
+}
+/** Reconcile final reads and ambiguous create failures through the same current-state verdict. */
+function reconciledTarget(current) {
+    return current.state === "create"
+        ? { state: "refused", reason: "write_failed", remedy: "Check native tracker health and retry the reviewed capture; successful earlier rows are retained." }
+        : { state: current.state, reason: current.reason, remedy: current.state === "skipped" ? "Preserve the existing record; review its native history." : "" };
+}
+/** Bound and validate every successful producer result before a write or response. */
+export function validateDiscussionCaptureReport(value, maxOutputBytes = 65536) {
+    const parsed = discussionReportSchema.safeParse(value);
+    if (!Number.isSafeInteger(maxOutputBytes) || maxOutputBytes < 1024 || maxOutputBytes > 131072 || !parsed.success || Buffer.byteLength(JSON.stringify(parsed.data)) > maxOutputBytes) {
+        refuseDiscussion("invalid_output", "Use at most ten spans of 4096 code units and a maxOutputBytes integer from 1024 through 131072; split oversized captures.");
+    }
+    return parsed.data;
+}
+/**
+ * Preview and apply share source preparation, ownership checks and native create options.
+ * Independent creates need no frozen journal or compensation. Retry always reads current
+ * sources, parent history and each Decision. A workspace transaction would not exclude
+ * ordinary SDK writers: the final read-to-create window remains explicitly optimistic.
+ */
+export async function captureGithubDiscussion(pmPath, value, sdk, options = {}) {
+    const parsed = discussionRequestSchema.safeParse(value);
+    if (!parsed.success || options.approval !== undefined && (typeof options.approval !== "string" || !/^[a-f0-9]{64}$/.test(options.approval)))
+        refuseDiscussion("invalid_selection", "Supply repo, positive issue, existing item and at most ten dense explicitly marked selections with exact offsets and quotes; approve only a full preview digest.");
+    const input = parsed.data;
+    if (options.maxOutputBytes !== undefined && (!Number.isSafeInteger(options.maxOutputBytes) || options.maxOutputBytes < 1024 || options.maxOutputBytes > 131072))
+        refuseDiscussion("invalid_output", "Set maxOutputBytes to an integer from 1024 through 131072.");
+    if (!sdk)
+        refuseDiscussion("host_required", "Run with a supported pm extension host or inject its tracker-bound ExtensionCommandSdk.");
+    const workspace = await readGithubWorkspace(pmPath);
+    const { pmRoot, settings, statuses } = workspace;
+    let parent;
+    let parentRevision;
+    try {
+        const document = await nativeItem(workspace, input.item);
+        if (!document)
+            throw new Error("missing context item");
+        parent = document.metadata.id;
+        parentRevision = await revision(pmRoot, parent);
+    }
+    catch {
+        refuseDiscussion("target_unavailable", "Select an existing readable native item with complete history in this tracker.");
+    }
+    await options.onBoundary?.("parent_read", -1);
+    const reader = options.readComment ?? readGithubDiscussionComment;
+    const rows = [];
+    const prepared = [];
+    const seen = new Set();
+    for (const [index, selected] of input.selections.entries()) {
+        try {
+            const source = await evidence(input, selected, reader);
+            await options.onBoundary?.("source_read", index);
+            const key = hash({ parent, source });
+            const id = normalizeItemId(`discussion-${key.slice(0, 32)}`, settings.id_prefix);
+            const body = JSON.stringify(source);
+            const marker = `github discussion capture v1 ${hash({ key, parentRevision })}`;
+            const current = await target(workspace, id, marker, body);
+            await options.onBoundary?.("target_read", index);
+            const duplicate = seen.has(id);
+            seen.add(id);
+            if (!duplicate && current.state === "create") {
+                try {
+                    await previewItemMutations({ pmRoot, author: "pm-github", transactionId: `discussion-preview-${hash({ id, parentRevision, source, settings })}`,
+                        mutations: [{ op: "create", id, options: nativeCreate(id, parent, source, marker, statuses.open_status) }] });
+                }
+                catch {
+                    rows.push({ id, state: "refused", reason: "native_refused", remedy: "Native SDK semantic preview refused this Decision. Check configured create requirements and tracker health; preview again.", evidence: source });
+                    continue;
+                }
+            }
+            rows.push({ id, state: duplicate ? "skipped" : current.state, reason: duplicate ? "duplicate_selection" : current.reason, remedy: current.state === "skipped" ? "Preserve the existing record; review its native history." : "", evidence: source });
+            prepared.push({ index, selected, source, id, body, marker, current, duplicate });
+        }
+        catch (error) {
+            const code = error.code;
+            if (code !== "source_unavailable" && code !== "source_changed" && code !== "invalid_selection")
+                throw error;
+            rows.push({ id: `selection-${index + 1}`, state: "refused", reason: code, remedy: "Refresh this comment and review its exact marked selection; other records remain independent.", evidence: null });
+        }
+    }
+    const schemaRevision = hash({ settings, statuses: statuses.definitions });
+    const approval = hash({ pmRoot, parent, parentRevision, schemaRevision,
+        rows: rows.map(row => ({ id: row.id, evidence: row.evidence, refusal: row.state === "refused" ? row.reason : null })),
+        targets: prepared.map(row => row.current.revision) });
+    if (options.approval !== undefined && options.approval !== approval)
+        refuseDiscussion("stale_plan", "Source, target history or schema changed. Preview again and review the new approval digest; no frozen plan is replayed.");
+    /** Derive counters from rows for every producer, including partial failure and retry receipts. */
+    const report = () => validateDiscussionCaptureReport({ ok: true, mode: options.approval === undefined ? "plan" : "apply", approval, item: parent, status: statuses.open_status,
+        selected: rows.length, created: rows.filter(row => row.state === "created").length, unchanged: rows.filter(row => row.state === "unchanged").length,
+        skipped: rows.filter(row => row.state === "skipped").length, refused: rows.filter(row => row.state === "refused").length, rows }, options.maxOutputBytes);
+    const preview = report();
+    if (Buffer.byteLength(JSON.stringify(preview)) + rows.length * 512 > (options.maxOutputBytes ?? 65536))
+        refuseDiscussion("invalid_output", "Increase maxOutputBytes or select fewer spans; reserve space for per-record retry and refusal receipts.");
+    if (options.approval !== undefined)
+        for (const row of prepared) {
+            if (row.duplicate || row.current.state !== "create")
+                continue;
+            await options.onBoundary?.("before_write", row.index);
+            const fresh = await evidence(input, row.selected, reader);
+            const currentParent = await revision(pmRoot, parent);
+            const currentWorkspace = await readGithubWorkspace(pmPath);
+            if (hash(fresh) !== hash(row.source) || currentParent !== parentRevision || hash({ settings: currentWorkspace.settings, statuses: currentWorkspace.statuses.definitions }) !== schemaRevision) {
+                refuseDiscussion("stale_plan", "A selected source, parent history or schema changed before a write. Preserve successful earlier captures and preview again.");
+            }
+            const current = await target(workspace, row.id, row.marker, row.body);
+            if (current.state !== "create") {
+                Object.assign(rows[row.index], reconciledTarget(current));
+                continue;
+            }
+            try {
+                await sdk.client.create(nativeCreate(row.id, parent, row.source, row.marker, statuses.open_status));
+                Object.assign(rows[row.index], { state: "created", reason: "captured" });
+            }
+            catch {
+                const peer = await target(workspace, row.id, row.marker, row.body);
+                Object.assign(rows[row.index], reconciledTarget(peer));
+            }
+            await options.onBoundary?.("after_write", row.index);
+        }
+    return report();
+}
+//# sourceMappingURL=discussions.js.map

package/dist/discussions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discussions.js","sourceRoot":"","sources":["../discussions.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,wBAAwB,EAAE,cAAc,EAAE,mBAAmB,EAAE,eAAe,EAAE,oBAAoB,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE1K,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,sBAAsB,EAA8F,MAAM,wBAAwB,CAAC;AACvO,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,gFAAgF;AAChF,MAAM,UAAU,gBAAgB,CAAC,IAA2B,EAAE,MAAc;IAC1E,MAAM,wBAAwB,CAAC,8BAA8B,IAAI,KAAK,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;AACxI,CAAC;AACD,sFAAsF;AACtF,SAAS,IAAI,CAAC,KAAc,IAAY,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAElH,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,IAAY,EAAE,KAAa,EAAE,OAAe;IAC5F,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;QACnC,MAAM,WAAW,GAAG,MAAM,SAAS,CAAC,GAAG,aAAa,EAAE,UAAU,IAAI,WAAW,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;QAC/F,IAAI,WAAW,CAAC,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACpH,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5H,IAAI,QAAQ,CAAC,YAAY,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;QACtG,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,GAAG,aAAa,EAAE,UAAU,IAAI,oBAAoB,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;QACrG,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC5G,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAY,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QAAC,gBAAgB,CAAC,oBAAoB,EAAE,iGAAiG,CAAC,CAAC;IAAC,CAAC;AACxJ,CAAC;AAED,0FAA0F;AAC1F,KAAK,UAAU,QAAQ,CAAC,KAA6B,EAAE,QAAsD,EAAE,MAA+B;IAC5I,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QAAC,GAAG,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAAC,CAAC;IACtE,MAAM,CAAC;QAAC,gBAAgB,CAAC,oBAAoB,EAAE,uEAAuE,CAAC,CAAC;IAAC,CAAC;IAC1H,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,gBAAgB,CAAC,oBAAoB,EAAE,yFAAyF,CAAC,CAAC;IACvJ,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC;IAC3B,MAAM,GAAG,GAAG,sBAAsB,KAAK,CAAC,IAAI,WAAW,KAAK,CAAC,KAAK,iBAAiB,QAAQ,CAAC,OAAO,EAAE,CAAC;IACtG,IAAI,MAAM,CAAC,EAAE,KAAK,QAAQ,CAAC,OAAO,IAAI,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,gCAAgC,KAAK,CAAC,IAAI,WAAW,KAAK,CAAC,KAAK,EAAE,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,GAAG,EAAE,CAAC;QACrL,gBAAgB,CAAC,mBAAmB,EAAE,wGAAwG,CAAC,CAAC;IAClJ,CAAC;IACD,IAAI,QAAQ,CAAC,GAAG,IAAI,QAAQ,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAC9I,gBAAgB,CAAC,gBAAgB,EAAE,2FAA2F,CAAC,CAAC;IAClI,CAAC;IACD,OAAO,wBAAwB,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,+BAA+B,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK;QACjH,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,UAAU;QAC7M,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACjF,CAAC;AAED,uFAAuF;AACvF,KAAK,UAAU,QAAQ,CAAC,MAAc,EAAE,EAAU;IAChD,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3E,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM;QAAE,gBAAgB,CAAC,oBAAoB,EAAE,2EAA2E,CAAC,CAAC;IAClJ,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED,yFAAyF;AACzF,KAAK,UAAU,UAAU,CAAC,SAA0D,EAAE,EAAU;IAC9F,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,EAAE,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACrJ,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,eAAe,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AAChH,CAAC;AAED,mGAAmG;AACnG,KAAK,UAAU,MAAM,CAAC,SAA0D,EAAE,EAAU,EAAE,MAAc,EAAE,IAAY;IACxH,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,cAAc,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACrF,IAAI,CAAC,QAAQ;YAAE,OAAO,QAAQ,CAAC,GAAG,KAAK,IAAI;gBACzC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAiB,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,sBAA+B,EAAE;gBACvF,CAAC,CAAC,EAAE,KAAK,EAAE,SAAkB,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,mBAA4B,EAAE,CAAC;QACtI,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;QAC7C,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,KAAK,MAAM,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,MAAM,KAAK,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,UAAU,CAAC;QAC5M,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,WAAoB,CAAC,CAAC,CAAC,SAAkB,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,kBAA2B,CAAC,CAAC,CAAC,mBAA4B,EAAE,CAAC;IACjN,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,SAAkB,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,mBAA4B,EAAE,CAAC;IACrG,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,SAAS,YAAY,CAAC,EAAU,EAAE,MAAc,EAAE,MAAkC,EAAE,MAAc,EAAE,MAAc;IAClH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,MAAM,CAAC,KAAK,WAAW,EAAE,MAAM;QACpF,WAAW,EAAE,2CAA2C,MAAM,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;QAClG,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC;QAC1E,IAAI,EAAE,4BAA4B,EAAE,OAAO,EAAE,MAAM;QACnD,GAAG,EAAE,CAAC,SAAS,MAAM,CAAC,GAAG,2CAA2C,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC;AAC7F,CAAC;AAED,kGAAkG;AAClG,SAAS,gBAAgB,CAAC,OAA2C;IACnE,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ;QAC/B,CAAC,CAAC,EAAE,KAAK,EAAE,SAAkB,EAAE,MAAM,EAAE,cAAuB,EAAE,MAAM,EAAE,mGAAmG,EAAE;QAC7K,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,0DAA0D,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAC9J,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,+BAA+B,CAAC,KAAc,EAAE,cAAc,GAAG,KAAK;IACpF,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC,IAAI,cAAc,GAAG,IAAI,IAAI,cAAc,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,cAAc,EAAE,CAAC;QACpL,gBAAgB,CAAC,gBAAgB,EAAE,2HAA2H,CAAC,CAAC;IAClK,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,MAAc,EAAE,KAA6B,EAAE,GAAoC,EAAE,OAAO,GAA6B,EAAE;IACvK,MAAM,MAAM,GAAG,uBAAuB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAAE,gBAAgB,CAAC,mBAAmB,EAAE,kKAAkK,CAAC,CAAC;IACvV,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;IAC1B,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,IAAI,OAAO,CAAC,cAAc,GAAG,MAAM,CAAC;QAAE,gBAAgB,CAAC,gBAAgB,EAAE,4DAA4D,CAAC,CAAC;IAClQ,IAAI,CAAC,GAAG;QAAE,gBAAgB,CAAC,eAAe,EAAE,yFAAyF,CAAC,CAAC;IACvI,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;IACjD,IAAI,MAAc,CAAC;IACnB,IAAI,cAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACvD,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,cAAc,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QAAC,gBAAgB,CAAC,oBAAoB,EAAE,gFAAgF,CAAC,CAAC;IAAC,CAAC;IACrI,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,IAAI,2BAA2B,CAAC;IAClE,MAAM,IAAI,GAAoC,EAAE,CAAC;IACjD,MAAM,QAAQ,GAAG,EAAE,CAAC;IACpB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;QAC3D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YACvD,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;YACjD,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACrC,MAAM,EAAE,GAAG,eAAe,CAAC,cAAc,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;YACjF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,gCAAgC,IAAI,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;YAC/E,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;YAC1D,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;YACjD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7C,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC7C,IAAI,CAAC;oBAAC,MAAM,oBAAoB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,sBAAsB,IAAI,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE;wBACnJ,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBAAC,CAAC;gBAClH,MAAM,CAAC;oBACL,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,4HAA4H,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;oBACtN,SAAS;gBACX,CAAC;YACH,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,0DAA0D,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YACrP,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QACnF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAC;YAChD,IAAI,IAAI,KAAK,oBAAoB,IAAI,IAAI,KAAK,gBAAgB,IAAI,IAAI,KAAK,mBAAmB;gBAAE,MAAM,KAAK,CAAC;YAC5G,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,aAAa,KAAK,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,+FAA+F,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACvM,CAAC;IACH,CAAC;IACD,MAAM,cAAc,GAAG,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc;QACpE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACrH,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACxD,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAAE,gBAAgB,CAAC,YAAY,EAAE,yHAAyH,CAAC,CAAC;IAC/N,kGAAkG;IAClG,MAAM,MAAM,GAAG,GAA4B,EAAE,CAAC,+BAA+B,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,WAAW;QACrM,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,WAAW,CAAC,CAAC,MAAM;QACnJ,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5J,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC;IACzB,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,cAAc,IAAI,KAAK,CAAC;QAAE,gBAAgB,CAAC,gBAAgB,EAAE,yGAAyG,CAAC,CAAC;IACtP,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;QAAE,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC/D,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,QAAQ;gBAAE,SAAS;YAC9D,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC,cAAc,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;YACtD,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC1D,MAAM,aAAa,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACrD,MAAM,gBAAgB,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;YAC3D,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,aAAa,KAAK,cAAc,IAAI,IAAI,CAAC,EAAE,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,cAAc,EAAE,CAAC;gBAC9L,gBAAgB,CAAC,YAAY,EAAE,6HAA6H,CAAC,CAAC;YAChK,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YACtE,IAAI,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC/B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAE,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC3D,SAAS;YACX,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;gBACpG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;YAC5E,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;gBACnE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAE,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;YAC1D,CAAC;YACD,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC,aAAa,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QACvD,CAAC;IACD,OAAO,MAAM,EAAE,CAAC;AAClB,CAAC"}

package/dist/gate.d.ts

@@ -98,6 +98,8 @@ export interface TrackerGateInput {
         readonly itemId: string;
         readonly fields: Readonly<Record<string, unknown>>;
     }[];
+    /** Scan the same rendered plan without collecting a Git diff (read-only previews). */
+    readonly planOnly?: boolean;
 }
 /**
  * Resolve the pm data dir from the `pmRoot` a command handler receives.

package/dist/gate.d.ts.map

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

package/dist/gate.js

@@ -104,8 +104,9 @@ const PERSONAL_DATA_RULES = [
         // followed directly by a path) names the git service account, not a
         // person, so the pattern skips exactly that shape; a bare `git@host`
         // contact address, even before a colon and a space, is still matched.
+        // The ssh:// form permits only the git service account with a URL path.
         // The lookbehind keeps a match from starting inside a local part.
-        pattern: /(?<![A-Za-z0-9._%+-])(?!git@[A-Za-z0-9.-]+\.[A-Za-z]{2,}:[A-Za-z0-9_~./-])[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/g,
+        pattern: /(?<![A-Za-z0-9._%+-])(?!(?<=ssh:\/\/)git@[A-Za-z0-9.-]+\.[A-Za-z]{2,}(?=\/|:\d+\/))(?!git@[A-Za-z0-9.-]+\.[A-Za-z]{2,}:[A-Za-z0-9_~./-])[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/g,
         // GitHub, GitLab and most mail systems use a "noreply" domain or local part
         // for automated identities; anything else in imported issue text is a real
         // person's address and fails closed.
@@ -327,7 +328,7 @@ function quotedSourcePositions(line) {
 /**
  * Recognize a bare-root token inside an immediately invoked JavaScript regex.
  *
- * Require an expression boundary and a closing test/exec call without crossing
+ * Require an expression boundary and a closed regex expression without crossing
  * quotes, escapes, newlines or another slash. Actual slash-separated paths
  * remain findings, including paths inside regex source. Walk the lead-in once
  * backwards instead of rescanning a whole prefix for every candidate. Quoted
@@ -345,8 +346,8 @@ function isBareRootRegex(line, matched, index, quoted) {
     let before = index - 1;
     while (before >= 0 && /[ \t]/.test(line[before]))
         before--;
-    return (before < 0 || "=(,:".includes(line[before])) &&
-        /^[ \t][^/"'`\\\r\n]*\/[dgimsuvy]*\.(?:test|exec)[ \t]*\(/.test(line.slice(index + matched.length));
+    return (before < 0 || "=([,:".includes(line[before])) &&
+        /^[ \t][^/"'`\\\r\n]*\/[dgimsuvy]*(?:\.(?:test|exec)[ \t]*\(|[ \t]*(?:[,;)]|$))/.test(line.slice(index + matched.length));
 }
 /**
  * Scan one added line with every content rule.
@@ -395,16 +396,22 @@ export function scanLineForRuleHits(line, trackerLine = false) {
             offsets.push(index);
         }
     }
-    const quoted = quotedSourcePositions(decoded);
+    let quoted;
     // Rule normalization can collapse backslash pairs in raw source. Keep its
     // original quote state too, so that an escaped quote cannot become a closer.
-    const originalQuoted = serialized ? [] : quotedSourcePositions(line);
+    let originalQuoted;
     const hits = [];
     for (const rule of [...CREDENTIAL_RULES, ...PERSONAL_DATA_RULES, ...HOST_PATH_RULES]) {
         rule.pattern.lastIndex = 0;
         for (let match = rule.pattern.exec(decoded); match; match = rule.pattern.exec(decoded)) {
-            if (rule.rule === "absolute-host-path" && isBareRootRegex(decoded, match[0], match.index, quoted[match.index] || originalQuoted[offsets[match.index]] === true))
-                continue;
+            if (rule.rule === "absolute-host-path") {
+                // Only this rule needs quote state. Inputs without host-path candidates
+                // avoid two full scans, and unchanged decoded text shares the same map.
+                quoted ??= quotedSourcePositions(decoded);
+                originalQuoted ??= serialized ? [] : decoded === line ? quoted : quotedSourcePositions(line);
+                if (isBareRootRegex(decoded, match[0], match.index, quoted[match.index] || originalQuoted[offsets[match.index]] === true))
+                    continue;
+            }
             if (!rule.confirm || rule.confirm(match[0])) {
                 const matched = rule.rule === "home-username" ? match[0].slice(match[0].indexOf("~")) : match[0];
                 const start = match.index + match[0].length - matched.length;
@@ -922,7 +929,11 @@ export function runTrackerGate(input) {
     let source;
     let files;
     try {
-        if (input.diffFile) {
+        if (input.planOnly) {
+            source = "diff";
+            files = [];
+        }
+        else if (input.diffFile) {
             source = "diff";
             const diffText = readFileSync(path.resolve(input.diffFile));
             files = parseUnifiedDiff(diffText);