vouchington-tooling 0.12.4 → 0.13.1

package/README.md

@@ -152,6 +152,10 @@ import {
   checkHarnessConfig,
   dumpHarnessPolicy,
 } from 'vouchington-tooling/agent-harness-config'
+import {
+  inspectHarnessEnvironment,
+  selectHarnessSession,
+} from 'vouchington-tooling/agent-harness-identity'
 import {
   readVitestReportAttempts,
   writeVitestBlobManifest,
@@ -246,6 +250,10 @@ classifier stays available in plan mode; its defined sandbox profile still requi
 `unrestricted` disables the sandbox. Repo checks surface user-level trust or mode prerequisites
 instead of claiming that repo files alone activate them.
 
+`agent-harness-identity` inspects the four harness environment signals without choosing a winner.
+Callers supply their own precedence to `selectHarnessSession`, keeping product-specific identity
+policy out of this package.
+
 `checkWorkspaceGatesPolicy` rejects tracked test assertions that hard-code the exact version of a
 dependency declared by a non-fixture package manifest. Assert dependency membership or placement,
 or derive a configuration or documentation package spec from that manifest instead.

package/dist/agent-harness-config/types.d.mts

@@ -1,5 +1,7 @@
-export declare const HARNESS_IDS: readonly ['claude', 'codex', 'grok', 'cursor'];
-export type HarnessId = (typeof HARNESS_IDS)[number];
+import { HARNESS_IDS } from '../agent-harness-identity/index.mts';
+import type { HarnessId } from '../agent-harness-identity/index.mts';
+export { HARNESS_IDS };
+export type { HarnessId };
 export type ApplyTarget = {
     readonly kind: 'global';
 } | {

package/dist/agent-harness-config/types.mjs

@@ -1 +1,2 @@
-export const HARNESS_IDS = ['claude', 'codex', 'grok', 'cursor'];
+import { HARNESS_IDS } from '../agent-harness-identity/index.mjs';
+export { HARNESS_IDS };

package/dist/agent-harness-identity/index.d.mts

@@ -0,0 +1,26 @@
+export declare const HARNESS_IDS: readonly ['claude', 'codex', 'grok', 'cursor'];
+export type HarnessId = (typeof HARNESS_IDS)[number];
+export interface HarnessEnvironment {
+    readonly claude: {
+        readonly compatMode: boolean;
+        readonly sessionId?: string;
+    };
+    readonly codex: {
+        readonly sessionId?: string;
+    };
+    readonly cursor: {
+        readonly agentMarker: boolean;
+        readonly sessionId?: string;
+    };
+    readonly grok: {
+        readonly agentMarker: boolean;
+        readonly hookEvent: boolean;
+        readonly sessionId?: string;
+    };
+}
+export interface HarnessSessionIdentity {
+    readonly harness: HarnessId;
+    readonly sessionId: string;
+}
+export declare function inspectHarnessEnvironment(env?: NodeJS.ProcessEnv): HarnessEnvironment;
+export declare function selectHarnessSession(environment: HarnessEnvironment, precedence: readonly HarnessId[]): HarnessSessionIdentity | undefined;

package/dist/agent-harness-identity/index.mjs

@@ -0,0 +1,30 @@
+export const HARNESS_IDS = ['claude', 'codex', 'grok', 'cursor'];
+function session(value) {
+    return value ? { sessionId: value } : {};
+}
+export function inspectHarnessEnvironment(env = process.env) {
+    return {
+        claude: {
+            compatMode: env.CLAUDECODE === '1',
+            ...session(env.CLAUDE_CODE_SESSION_ID),
+        },
+        codex: session(env.CODEX_THREAD_ID),
+        cursor: {
+            agentMarker: Boolean(env.CURSOR_AGENT),
+            ...session(env.CURSOR_SESSION_ID),
+        },
+        grok: {
+            agentMarker: Boolean(env.GROK_AGENT),
+            hookEvent: Boolean(env.GROK_HOOK_EVENT),
+            ...session(env.GROK_SESSION_ID),
+        },
+    };
+}
+export function selectHarnessSession(environment, precedence) {
+    for (const harness of precedence) {
+        const sessionId = environment[harness].sessionId;
+        if (sessionId)
+            return { harness, sessionId };
+    }
+    return undefined;
+}

package/dist/index.d.mts

@@ -1,5 +1,7 @@
 export { linkSkill, readSkillManifest } from './skill-discovery/index.mts';
 export type { LinkSkillOptions, LinkSkillResult, SkillManifest, SkillManifestEntry, } from './skill-discovery/index.mts';
+export { HARNESS_IDS, inspectHarnessEnvironment, selectHarnessSession, } from './agent-harness-identity/index.mts';
+export type { HarnessEnvironment, HarnessSessionIdentity } from './agent-harness-identity/index.mts';
 export { codexChildren, codexIdentity, computeTranscriptFacts, formatTranscriptFacts, formatUnavailable, resolveTranscriptFile, runRetrospectiveTranscript, } from './retrospective-transcript/index.mts';
 export type { ResolveOptions, TokenTotals, TranscriptFacts, } from './retrospective-transcript/index.mts';
 export { runRetrospectiveFacts } from './retrospective-facts/index.mts';
@@ -13,7 +15,7 @@ export type { EphemeralListenerOptions, RunnerPortPolicy } from './runner-port-p
 export { extractAlterTableAddColumnLocations, extractCreateIndexMetadata, extractCreateTableMetadata, extractDefaultFunction, extractDropIndexMetadata, extractFuncCallArgColumnNames, extractMigrationConstraintMetadata, initSqlAst, lineOfUtf8ByteOffset, MissingSqlAstParserError, parseSql, } from './sql-ast/index.mts';
 export type { ForeignKey, SqlCreateIndexMetadata, SqlCreateTableColumn, SqlCreateTableMetadata, SqlDropIndexMetadata, SqlIndexParam, SqlMigrationConstraintMetadata, } from './sql-ast/index.mts';
 export { dollarQuoteEnd, lineOf, maskSqlQuotedText, readDollarQuoteDelimiter, readStringLiteral, splitSqlStatements, sqlFragments, stripSqlComments, } from './sql-scanner/index.mts';
-export { applyHarnessConfig, checkHarnessConfig, dumpHarnessPolicy, planHarnessConfig, DEFAULT_EXTRA_WRITABLE_ROOTS, HARNESS_IDS, } from './agent-harness-config/index.mts';
+export { applyHarnessConfig, checkHarnessConfig, dumpHarnessPolicy, planHarnessConfig, DEFAULT_EXTRA_WRITABLE_ROOTS, } from './agent-harness-config/index.mts';
 export type { ApplyTarget, FilePlan, FileResult, HarnessApplyResult, HarnessCheckResult, HarnessConfigOptions, HarnessId, HarnessPlan, HarnessPolicyDump, JsonPatch, KeyDrift, TomlPatch, TomlValue, } from './agent-harness-config/index.mts';
 export { auditCiJobRuntime, parseWorkflowNameMatch } from './gha-runtime-audit/index.mts';
 export type { GhApiExecutor, RuntimeAuditOptions, RuntimeAuditResult, RuntimeAuditWorkflowFilter, RuntimeJobResult, RuntimeSample, } from './gha-runtime-audit/index.mts';

package/dist/index.mjs

@@ -1,5 +1,6 @@
 /* eslint-disable max-lines -- package entry point enumerates the supported public API. */
 export { linkSkill, readSkillManifest } from './skill-discovery/index.mjs';
+export { HARNESS_IDS, inspectHarnessEnvironment, selectHarnessSession, } from './agent-harness-identity/index.mjs';
 export { codexChildren, codexIdentity, computeTranscriptFacts, formatTranscriptFacts, formatUnavailable, resolveTranscriptFile, runRetrospectiveTranscript, } from './retrospective-transcript/index.mjs';
 export { runRetrospectiveFacts } from './retrospective-facts/index.mjs';
 export { appendJournal, assertSessionId, cleanupSnapshotPartitions, partitionSnapshot, probeBlackboard, readJournal, resolveBlackboardConnection, } from './agent-blackboard/index.mjs';
@@ -7,7 +8,7 @@ export { buildSessionFrictionReport, classifyFrictionObservation, FRICTION_LOG_M
 export { EphemeralListenerAttemptsExhaustedError, isRunnerReservedPort, listenOnRunnerUnreservedEphemeralPort, loadRunnerPortPolicy, runnerPortPolicy, validateRunnerPortPolicy, } from './runner-port-policy/index.mjs';
 export { extractAlterTableAddColumnLocations, extractCreateIndexMetadata, extractCreateTableMetadata, extractDefaultFunction, extractDropIndexMetadata, extractFuncCallArgColumnNames, extractMigrationConstraintMetadata, initSqlAst, lineOfUtf8ByteOffset, MissingSqlAstParserError, parseSql, } from './sql-ast/index.mjs';
 export { dollarQuoteEnd, lineOf, maskSqlQuotedText, readDollarQuoteDelimiter, readStringLiteral, splitSqlStatements, sqlFragments, stripSqlComments, } from './sql-scanner/index.mjs';
-export { applyHarnessConfig, checkHarnessConfig, dumpHarnessPolicy, planHarnessConfig, DEFAULT_EXTRA_WRITABLE_ROOTS, HARNESS_IDS, } from './agent-harness-config/index.mjs';
+export { applyHarnessConfig, checkHarnessConfig, dumpHarnessPolicy, planHarnessConfig, DEFAULT_EXTRA_WRITABLE_ROOTS, } from './agent-harness-config/index.mjs';
 export { auditCiJobRuntime, parseWorkflowNameMatch } from './gha-runtime-audit/index.mjs';
 export { checkGhaWorkspacePolicy } from './gha-workspace-policy/index.mjs';
 export { requireUpToDate } from './require-up-to-date/index.mjs';

package/dist/retrospective-transcript/index.mjs

@@ -2,6 +2,7 @@ import { existsSync, globSync } from 'node:fs';
 import { readFile } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { basename, dirname, join } from 'node:path';
+import { inspectHarnessEnvironment, selectHarnessSession, } from '../agent-harness-identity/index.mjs';
 import { codexChildren, codexIdentity, computeCodex } from './codex.mjs';
 import { segmentCodex } from './codex-segment.mjs';
 import { computeClaude } from './claude.mjs';
@@ -28,9 +29,8 @@ export function resolveTranscriptFile(options) {
     }
     const env = options.env ?? process.env;
     const sessionId = options.sessionId ??
-        ['CODEX_THREAD_ID', 'CLAUDE_CODE_SESSION_ID', 'CURSOR_SESSION_ID', 'GROK_SESSION_ID']
-            .map((key) => env[key])
-            .find(Boolean);
+        selectHarnessSession(inspectHarnessEnvironment(env), ['codex', 'claude', 'cursor', 'grok'])
+            ?.sessionId;
     if (!sessionId)
         return {
             error: 'no session id (pass --session-id or set CODEX_THREAD_ID, CLAUDE_CODE_SESSION_ID, CURSOR_SESSION_ID, or GROK_SESSION_ID)',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vouchington-tooling",
-  "version": "0.12.4",
+  "version": "0.13.1",
   "description": "Vouchington CLI and extractable tooling libraries.",
   "homepage": "https://github.com/vouchington/vouchington-tooling/tree/main/packages/vouchington-tooling#readme",
   "bugs": {
@@ -33,6 +33,11 @@
       "import": "./dist/index.mjs",
       "default": "./dist/index.mjs"
     },
+    "./agent-harness-identity": {
+      "types": "./dist/agent-harness-identity/index.d.mts",
+      "import": "./dist/agent-harness-identity/index.mjs",
+      "default": "./dist/agent-harness-identity/index.mjs"
+    },
     "./skill-discovery": {
       "types": "./dist/skill-discovery/index.d.mts",
       "import": "./dist/skill-discovery/index.mjs",

package/scripts/gha/install-playwright-chromium-arm64.sh

@@ -25,16 +25,47 @@ browser_revision() {
   node -e "const fs=require('node:fs'); const file=process.argv[1]; const name=process.argv[2]; const browser=JSON.parse(fs.readFileSync(file,'utf8')).browsers.find(b => b.name === name); if (!browser) { process.stderr.write('unknown browser '+name); process.exit(1) } process.stdout.write(String(browser.revision))" "$browsers_json" "$1"
 }
 
+browser_executable() {
+  local name="$1" dir="$2" exe
+  case "$name" in
+    chromium) exe="$dir/chrome-linux-arm64/chrome" ;;
+    chromium-headless-shell) exe="$dir/chrome-headless-shell-linux-arm64/chrome-headless-shell" ;;
+    *)
+      echo "::error::browser_executable: unknown browser name '$name'" >&2
+      return 2
+      ;;
+  esac
+  if [ -x "$exe" ]; then
+    printf '%s\n' "$exe"
+    return
+  fi
+
+  # Playwright releases before 1.63 used these archive layouts.
+  case "$name" in
+    chromium) exe="$dir/chrome-linux/chrome" ;;
+    chromium-headless-shell) exe="$dir/chrome-linux/headless_shell" ;;
+  esac
+  if [ -x "$exe" ]; then
+    printf '%s\n' "$exe"
+    return
+  fi
+  return 1
+}
+
 install_browser() {
   local name="$1" archive="$2"
   local rev
   rev=$(browser_revision "$name")
   local dir="${browsers_path}/${name//-/_}-${rev}"
   local marker="${dir}/INSTALLATION_COMPLETE"
+  local exe
 
   if [ -f "$marker" ]; then
-    echo "Already installed: ${name}-${rev} (cache hit)"
-    return
+    if exe=$(browser_executable "$name" "$dir"); then
+      echo "Already installed: ${name}-${rev} (cache hit)"
+      return
+    fi
+    echo "Reinstalling ${name}-${rev}: cache marker exists but executable is missing"
   fi
 
   echo "Installing ${name} v${rev} via curl + system unzip"
@@ -47,17 +78,8 @@ install_browser() {
   unzip -q "$tmp" -d "$dir"
   rm -f "$tmp"
 
-  local exe
-  case "$name" in
-    chromium) exe="$dir/chrome-linux/chrome" ;;
-    chromium-headless-shell) exe="$dir/chrome-linux/headless_shell" ;;
-    *)
-      echo "::error::install_browser: unknown browser name '$name'"
-      exit 1
-      ;;
-  esac
-  if [ ! -x "$exe" ]; then
-    echo "::error::Expected ${name} binary missing or not executable after extract: $exe"
+  if ! exe=$(browser_executable "$name" "$dir"); then
+    echo "::error::Expected ${name} binary missing or not executable after extract: $dir"
     exit 1
   fi