vouchington-tooling 0.11.2 → 0.12.0

package/README.md

@@ -215,6 +215,7 @@ import {
 import { runRetrospectiveTranscript } from 'vouchington-tooling/retrospective-transcript'
 import { appendJournal, probeBlackboard } from 'vouchington-tooling/agent-blackboard'
 import { buildSessionFrictionReport, recordFriction } from 'vouchington-tooling/session-friction'
+import { GITHUB_BODY_MAX_CHARACTERS, validateGitHubBodyLength } from 'vouchington-tooling'
 import { createPullRequest, getDiffAgainstBase, runGh, runGit } from 'vouchington-tooling/gh-cli'
 import {
   shellScriptViolations,
@@ -231,6 +232,10 @@ throws on a `run:` value that is a YAML alias or a multiline PLAIN scalar, shape
 scan safely. Both functions scan already-in-scope source text — deciding which files count as a
 shell script or a workflow/action YAML file is left to the caller.
 
+`validateGitHubBodyLength` measures an issue or pull-request body against GitHub's 65,536 Unicode
+code-point limit without altering it. Its result includes the UTF-8 byte count for diagnostics; that
+byte count is not a validation limit.
+
 `agent-harness-config` merges classifier-auto and sandbox keys into Claude, Codex, Grok, and Cursor
 config files. See [docs/agent-harness-config.md](./docs/agent-harness-config.md). `--global` updates
 home-directory configs; `--repo` updates a checkout. It does not copy allowlists, hooks, or plugins.

package/dist/gh-cli/body-length.d.mts

@@ -0,0 +1,15 @@
+/** GitHub's maximum issue or pull-request body length, counted in Unicode code points. */
+export declare const GITHUB_BODY_MAX_CHARACTERS = 65536;
+/** The measured GitHub body length and whether it fits within GitHub's character limit. */
+export interface GitHubBodyLengthValidation {
+    readonly ok: boolean;
+    readonly characterCount: number;
+    readonly utf8ByteCount: number;
+    readonly maxCharacterCount: number;
+}
+/**
+ * Measures a GitHub issue or pull-request body without altering its content.
+ *
+ * GitHub's limit is evaluated in Unicode code points. UTF-8 bytes are returned only for diagnostics.
+ */
+export declare function validateGitHubBodyLength(body: string): GitHubBodyLengthValidation;

package/dist/gh-cli/body-length.mjs

@@ -0,0 +1,16 @@
+/** GitHub's maximum issue or pull-request body length, counted in Unicode code points. */
+export const GITHUB_BODY_MAX_CHARACTERS = 65_536;
+/**
+ * Measures a GitHub issue or pull-request body without altering its content.
+ *
+ * GitHub's limit is evaluated in Unicode code points. UTF-8 bytes are returned only for diagnostics.
+ */
+export function validateGitHubBodyLength(body) {
+    const characterCount = Array.from(body).length;
+    return {
+        ok: characterCount <= GITHUB_BODY_MAX_CHARACTERS,
+        characterCount,
+        utf8ByteCount: Buffer.byteLength(body, 'utf8'),
+        maxCharacterCount: GITHUB_BODY_MAX_CHARACTERS,
+    };
+}

package/dist/gh-cli/index.d.mts

@@ -1,5 +1,7 @@
 export { createCommandRunner, runGh, runGit } from './exec.mts';
 export type { ExecFileText, RunTextCommand } from './exec.mts';
 export { getDiffAgainstBase } from './diff.mts';
+export { GITHUB_BODY_MAX_CHARACTERS, validateGitHubBodyLength } from './body-length.mts';
+export type { GitHubBodyLengthValidation } from './body-length.mts';
 export { assertHeadPushed, buildGhPrCreateArgs, createPullRequest, DetachedHeadError, HeadNotPushedError, HeadOutOfDateError, resolveHeadBranch, } from './pr-create.mts';
 export type { AssertHeadPushedOptions, BuildGhPrCreateArgsOptions, CreatePullRequestExecutors, CreatePullRequestOptions, } from './pr-create.mts';

package/dist/gh-cli/index.mjs

@@ -1,3 +1,4 @@
 export { createCommandRunner, runGh, runGit } from './exec.mjs';
 export { getDiffAgainstBase } from './diff.mjs';
+export { GITHUB_BODY_MAX_CHARACTERS, validateGitHubBodyLength } from './body-length.mjs';
 export { assertHeadPushed, buildGhPrCreateArgs, createPullRequest, DetachedHeadError, HeadNotPushedError, HeadOutOfDateError, resolveHeadBranch, } from './pr-create.mjs';

package/dist/index.d.mts

@@ -89,5 +89,7 @@ export type { DiagnosticReportLimitOptions, DiagnosticReportSummary, } from './v
 export { createCommandRunner, runGh, runGit } from './gh-cli/index.mts';
 export type { ExecFileText, RunTextCommand } from './gh-cli/index.mts';
 export { getDiffAgainstBase } from './gh-cli/index.mts';
+export { GITHUB_BODY_MAX_CHARACTERS, validateGitHubBodyLength } from './gh-cli/index.mts';
+export type { GitHubBodyLengthValidation } from './gh-cli/index.mts';
 export { assertHeadPushed, buildGhPrCreateArgs, createPullRequest, DetachedHeadError, HeadNotPushedError, HeadOutOfDateError, resolveHeadBranch, } from './gh-cli/index.mts';
 export type { AssertHeadPushedOptions, BuildGhPrCreateArgsOptions, CreatePullRequestExecutors, CreatePullRequestOptions, } from './gh-cli/index.mts';

package/dist/index.mjs

@@ -50,4 +50,5 @@ export { validateResolvedPinDelta } from './swift-resolved-pin-delta/index.mjs';
 export { DEFAULT_MAX_DIAGNOSTIC_REPORTS, DEFAULT_MAX_FORMATTED_DIAGNOSTIC_REPORTS, formatDiagnosticReportSummaries, HARD_MAX_DIAGNOSTIC_REPORTS, readDiagnosticReportSummaries, summarizeDiagnosticReport, } from './vitest-diagnostics/index.mjs';
 export { createCommandRunner, runGh, runGit } from './gh-cli/index.mjs';
 export { getDiffAgainstBase } from './gh-cli/index.mjs';
+export { GITHUB_BODY_MAX_CHARACTERS, validateGitHubBodyLength } from './gh-cli/index.mjs';
 export { assertHeadPushed, buildGhPrCreateArgs, createPullRequest, DetachedHeadError, HeadNotPushedError, HeadOutOfDateError, resolveHeadBranch, } from './gh-cli/index.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vouchington-tooling",
-  "version": "0.11.2",
+  "version": "0.12.0",
   "description": "Vouchington CLI and extractable tooling libraries.",
   "homepage": "https://github.com/vouchington/vouchington-tooling/tree/main/packages/vouchington-tooling#readme",
   "bugs": {