vouchington-tooling 0.11.2 → 0.12.1

package/README.md

@@ -68,13 +68,15 @@ vouchington post-review
 vouchington stage-review-payload optional|required <source> <destination>
 ```
 
-For persistent `pnpm-install`, v4 metadata tracks structural inputs separately from the
+For persistent `pnpm-install`, v5 metadata tracks structural inputs separately from the
 `--install-scripts` policy. A warm scripts-enabled tree can therefore toggle
 `true → false → true` without forced reconciliation; a tree first installed with scripts disabled
 uses one script-suppressed verification install followed by `pnpm rebuild --pending --recursive`.
 When only newly pending dependency package IDs remain, it instead rebuilds those exact IDs without
 rerunning first-party workspace hooks.
-An isolated native-binary mismatch uses one strict forced install only when structural provenance
+If that generic rebuild leaves only pnpm's root importer marker, one root-only pending rebuild runs
+the root lifecycle hook; every other residual ID remains a hard failure. An isolated native-binary
+mismatch uses one strict forced install only when structural provenance
 matches, workspace links are valid, and pnpm records empty `ignoredBuilds` and `pendingBuilds` ledgers;
 otherwise it retains the script-free then strict reconciliation. Native and workspace-link health
 are verified before its metadata stamp is refreshed.
@@ -215,6 +217,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 +234,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/dist/pnpm-install/install-operations.mjs

@@ -52,7 +52,11 @@ export async function finalizePendingBuilds(options, runCapture, phase) {
         fail(`${phase} completed without a clear pending build ledger`);
     if (options.installScripts && before.kind === 'pending') {
         await install(['rebuild', '--pending', '--recursive'], options, 'pending scripts rebuild');
-        const after = await pendingBuilds();
+        let after = await pendingBuilds();
+        if (after.kind === 'pending' && after.ids.length === 1 && after.ids[0] === '.') {
+            await install(['rebuild', '--pending', '--workspace-root'], options, 'pending workspace root rebuild');
+            after = await pendingBuilds();
+        }
         if (after.kind !== 'clear')
             fail(`${phase} completed without a clear pending build ledger`);
     }

package/dist/pnpm-install/pnpm-install-fake-pnpm.test-helpers.mjs

@@ -40,12 +40,17 @@ elif [ ! -f "$PNPM_NODE_MODULES/.modules.yaml" ]; then
   printf 'pendingBuilds: []\\n' > "$PNPM_NODE_MODULES/.modules.yaml"
 fi
 case " $* " in
+  *' rebuild --pending --workspace-root '*)
+    printf 'pendingBuilds: [%s]\n' "\${PNPM_WORKSPACE_ROOT_REBUILD_PENDING_BUILDS:-}" > "$PNPM_NODE_MODULES/.modules.yaml"
+    ;;
   *' rebuild '*)
     if [ "\${PNPM_REPAIR_NATIVE_ON_REBUILD:-0}" = 1 ]; then
       cp "$PNPM_NATIVE_REPLACEMENT" "$PNPM_NATIVE_ADDON"
     fi
     if [ "\${PNPM_REBUILD_INVALID_LEDGER:-0}" = 1 ]; then
       printf 'pendingBuilds: invalid\n' > "$PNPM_NODE_MODULES/.modules.yaml"
+    elif [ -n "\${PNPM_REBUILD_PENDING_BUILDS:-}" ]; then
+      printf 'pendingBuilds: [%s]\n' "$PNPM_REBUILD_PENDING_BUILDS" > "$PNPM_NODE_MODULES/.modules.yaml"
     else
       printf 'pendingBuilds: []\n' > "$PNPM_NODE_MODULES/.modules.yaml"
     fi

package/package.json

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