llm-wb 0.1.0-beta.0

package/scripts/00.chat/main-refresh/verify-conflict-audit/script.sh

@@ -0,0 +1,154 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# agentic-artifact:
+#   schema: agentic-artifact/v2
+#   id: chat.script.main-refresh.verify-conflict-audit
+#   version: 1
+#   status: active
+#   layer: 00.chat
+#   domain: main-refresh
+#   disciplines:
+#   - agentic
+#   kind: script
+#   purpose: Verify main-refresh conflict paths are recorded in the chat session log.
+#   portability:
+#     class: required
+#     targets:
+#     - llm-workbench
+#   used_by:
+#   - id: chat.workflows.chat-refresh-from-main
+#     path: .agentic/00.chat/workflows/chat-refresh-from-main.md
+#   - id: chat.standards.main-refresh-conflict-types
+#     path: .agentic/00.chat/standards/main-refresh-conflict-types.md
+#   effects:
+#   - read-only
+
+# shellcheck source=../../session-log/paths/lib.sh
+source "scripts/00.chat/session-log/paths/lib.sh"
+
+usage() {
+  cat <<'EOF'
+Usage:
+  script.sh [--session-log <path>] [--path <conflict-path>]... [--paths-file <file>]
+
+Verifies that each conflict path has a matching `- Path: `<path>`` entry under
+the chat session log's `## Main Refresh Conflicts` section.
+
+If no paths are supplied, unresolved conflict paths are read from the Git index.
+For resolved preflight conflicts, pass the captured paths explicitly.
+EOF
+}
+
+SESSION_LOG=""
+PATHS_FILE=""
+PATHS=()
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --session-log)
+      SESSION_LOG="${2:-}"
+      shift 2
+      ;;
+    --path)
+      PATHS+=("${2:-}")
+      shift 2
+      ;;
+    --paths-file)
+      PATHS_FILE="${2:-}"
+      shift 2
+      ;;
+    --help|-h)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "ERROR: unknown argument: $1" >&2
+      usage >&2
+      exit 2
+      ;;
+  esac
+done
+
+if ! git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+  echo "ERROR: not inside a Git worktree." >&2
+  exit 1
+fi
+
+if [ -n "$PATHS_FILE" ]; then
+  if [ ! -f "$PATHS_FILE" ]; then
+    echo "ERROR: missing paths file: $PATHS_FILE" >&2
+    exit 1
+  fi
+
+  while IFS= read -r path; do
+    [ -z "$path" ] && continue
+    PATHS+=("$path")
+  done < "$PATHS_FILE"
+fi
+
+if [ "${#PATHS[@]}" -eq 0 ]; then
+  while IFS= read -r path; do
+    [ -z "$path" ] && continue
+    PATHS+=("$path")
+  done < <(git diff --name-only --diff-filter=U)
+fi
+
+if [ -z "$SESSION_LOG" ]; then
+  BRANCH="$(git branch --show-current)"
+  if ! SESSION_ID="$(chat_session_id_from_branch "$BRANCH" 2>/dev/null)"; then
+    if [ -n "${AGENTIC_SESSION_LOG:-}" ]; then
+      SESSION_LOG="$AGENTIC_SESSION_LOG"
+    else
+      echo "ERROR: could not infer chat session from branch. Use --session-log." >&2
+      exit 1
+    fi
+  else
+    SESSION_LOG="$(chat_log_file_for_session "$SESSION_ID")"
+  fi
+fi
+
+if [ ! -f "$SESSION_LOG" ]; then
+  echo "ERROR: missing session log: $SESSION_LOG" >&2
+  exit 1
+fi
+
+if [ "${#PATHS[@]}" -eq 0 ]; then
+  echo "No conflict paths supplied or unresolved in the Git index."
+  echo "For resolved preflight conflicts, rerun with --path or --paths-file."
+  exit 0
+fi
+
+AUDIT_PATHS="$(
+  awk '
+    $0 == "## Main Refresh Conflicts" { in_section = 1; next }
+    in_section && /^## / { in_section = 0 }
+    in_section && /^- Path: `/ {
+      line = $0
+      sub(/^- Path: `/, "", line)
+      sub(/`$/, "", line)
+      print line
+    }
+  ' "$SESSION_LOG"
+)"
+
+FAILED=0
+
+for path in "${PATHS[@]}"; do
+  if [ -z "$path" ]; then
+    continue
+  fi
+
+  if printf '%s\n' "$AUDIT_PATHS" | grep -Fxq "$path"; then
+    echo "OK: conflict path recorded: $path"
+  else
+    echo "ERROR: conflict path missing from session audit: $path" >&2
+    FAILED=1
+  fi
+done
+
+if [ "$FAILED" -ne 0 ]; then
+  exit 1
+fi
+
+echo "Main refresh conflict audit verified."

package/scripts/00.chat/main-refresh/verify-conflict-audit/smoke-test.sh

@@ -0,0 +1,99 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# agentic-artifact:
+#   schema: agentic-artifact/v2
+#   id: chat.script.main-refresh.verify-conflict-audit.smoke-test
+#   version: 1
+#   status: active
+#   layer: 00.chat
+#   domain: main-refresh
+#   disciplines:
+#   - agentic
+#   kind: script
+#   purpose: Smoke test main-refresh conflict audit verification.
+#   portability:
+#     class: required
+#     targets:
+#     - llm-workbench
+#   used_by:
+#   - id: chat.script.main-refresh.verify-conflict-audit
+#     path: scripts/00.chat/main-refresh/verify-conflict-audit/script.sh
+#   effects:
+#   - writes-files
+
+fail() {
+  echo "FAIL: $*" >&2
+  exit 1
+}
+
+SOURCE_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../../.." && pwd -P)"
+TMP_ROOT="$(mktemp -d "${TMPDIR:-/tmp}/verify-main-refresh-conflict-audit-smoke.XXXXXX")"
+
+cleanup() {
+  rm -rf "$TMP_ROOT"
+}
+
+trap cleanup EXIT
+
+REPO="$TMP_ROOT/repo"
+mkdir -p "$REPO"
+git -C "$REPO" init -q
+git -C "$REPO" config user.email test@example.com
+git -C "$REPO" config user.name "Test User"
+
+mkdir -p \
+  "$REPO/scripts/00.chat/main-refresh/verify-conflict-audit" \
+  "$REPO/scripts/00.chat/session-log/paths" \
+  "$REPO/commitLogs/2026/jun/20/test-session"
+
+cp "$SOURCE_ROOT/scripts/00.chat/main-refresh/verify-conflict-audit/script.sh" "$REPO/scripts/00.chat/main-refresh/verify-conflict-audit/script.sh"
+cp "$SOURCE_ROOT/scripts/00.chat/session-log/paths/lib.sh" "$REPO/scripts/00.chat/session-log/paths/lib.sh"
+
+SESSION_LOG="$REPO/commitLogs/2026/jun/20/test-session/README.md"
+CONFLICT_PATH="docs/example-conflict.md"
+cat > "$SESSION_LOG" <<'EOF'
+# Chat Session: test
+
+## Main Refresh Conflicts
+
+- Path: `docs/example-conflict.md`
+  Type: `ownership-migration-conflict`
+  Mode: deterministic
+  Reason: test
+  Action: test
+  Preflight branch: `agentic/preflight/chat-test/20000101000000`
+  Preflight worktree: `/tmp/preflight`
+  Files changed by resolution: docs/example-conflict.md
+  Checks: test
+EOF
+
+git -C "$REPO" add scripts commitLogs
+git -C "$REPO" commit -q -m base
+
+(
+  cd "$REPO"
+  bash scripts/00.chat/main-refresh/verify-conflict-audit/script.sh \
+    --session-log commitLogs/2026/jun/20/test-session/README.md \
+    --path "$CONFLICT_PATH"
+) >/dev/null
+
+set +e
+(
+  cd "$REPO"
+  bash scripts/00.chat/main-refresh/verify-conflict-audit/script.sh \
+    --session-log commitLogs/2026/jun/20/test-session/README.md \
+    --path missing/path.md
+) > "$TMP_ROOT/missing.out" 2> "$TMP_ROOT/missing.err"
+MISSING_STATUS="$?"
+set -e
+
+if [ "$MISSING_STATUS" -eq 0 ]; then
+  fail "missing conflict audit path passed"
+fi
+
+if ! grep -q "conflict path missing from session audit" "$TMP_ROOT/missing.err"; then
+  fail "missing path failure was not explained"
+fi
+
+echo "main refresh conflict audit verifier smoke test passed."

package/scripts/00.chat/metrics/README.md

@@ -0,0 +1,35 @@
+<!-- agentic-artifact:
+  schema: agentic-artifact/v2
+  id: chat.script.metrics.readme
+  version: 1
+  status: active
+  layer: 00.chat
+  domain: metrics
+  disciplines:
+  - agentic
+  kind: script-domain-readme
+  purpose: Explain chat metric helper scripts.
+  portability:
+    class: required
+    targets:
+    - llm-workbench
+  used_by:
+  - id: chat.script.metrics.estimate-chat-cost.readme
+    path: scripts/00.chat/metrics/estimate-chat-cost/README.md
+  - id: chat.script.session-log.record-chat-commit.readme
+    path: scripts/00.chat/session-log/record-chat-commit/README.md
+-->
+# Metrics Scripts
+
+Metrics scripts provide derived chat metadata such as estimated token cost.
+They support session logs and reports; they are not billing systems.
+
+Estimates should be transparent about their assumptions. When exact model
+pricing or token splits are unavailable, scripts should record the basis and
+avoid pretending to be precise.
+
+Default chat pricing data lives with the chat metrics scripts at
+`scripts/00.chat/metrics/data/chat-pricing.json`. Treat it as a bundled
+best-effort profile store, not live provider pricing. The bundled default is
+provider-neutral and records cost as unavailable until `CHAT_COST_PROFILE` or
+`CHAT_COST_PRICING_FILE` selects a concrete pricing profile.

package/scripts/00.chat/metrics/data/chat-pricing.json

@@ -0,0 +1,107 @@
+{
+  "schema_version": 1,
+  "default_profile": "portable-unpriced",
+  "currency": "USD",
+  "unit": "1M tokens",
+  "source": {
+    "name": "Bundled chat pricing profile store",
+    "url": "local chat pricing snapshot",
+    "retrieved_at_utc": "2026-06-19T00:00:00Z",
+    "note": "Best-effort local profiles for chat session cost estimates. Override with CHAT_COST_PRICING_FILE for organization-specific or current provider pricing."
+  },
+  "profiles": {
+    "portable-unpriced": {
+      "provider": "unknown",
+      "model": "unknown",
+      "category": "chat",
+      "tier": "unknown",
+      "context": "unknown",
+      "estimate_rate_usd_per_1m_tokens": null,
+      "assumption": "No provider pricing profile selected. Set CHAT_COST_PROFILE or CHAT_COST_PRICING_FILE for cost estimates."
+    },
+    "openai-chat-latest-standard-conservative-output": {
+      "provider": "openai",
+      "model": "chat-latest",
+      "category": "chat",
+      "tier": "standard",
+      "context": "standard",
+      "input_usd_per_1m_tokens": 5,
+      "cached_input_usd_per_1m_tokens": 0.5,
+      "output_usd_per_1m_tokens": 30,
+      "estimate_rate_usd_per_1m_tokens": 30,
+      "assumption": "all estimated chat tokens are costed at the output-token rate because the transcript-byte metric does not split input, cached input, and output tokens"
+    },
+    "gpt-5.5-standard-short-conservative-output": {
+      "provider": "openai",
+      "model": "gpt-5.5",
+      "category": "flagship",
+      "tier": "standard",
+      "context": "short",
+      "input_usd_per_1m_tokens": 5,
+      "cached_input_usd_per_1m_tokens": 0.5,
+      "output_usd_per_1m_tokens": 30,
+      "estimate_rate_usd_per_1m_tokens": 30,
+      "assumption": "all estimated chat tokens are costed at the output-token rate because the transcript-byte metric does not split input, cached input, and output tokens"
+    },
+    "gpt-5.5-standard-long-conservative-output": {
+      "provider": "openai",
+      "model": "gpt-5.5",
+      "category": "flagship",
+      "tier": "standard",
+      "context": "long",
+      "input_usd_per_1m_tokens": 10,
+      "cached_input_usd_per_1m_tokens": 1,
+      "output_usd_per_1m_tokens": 45,
+      "estimate_rate_usd_per_1m_tokens": 45,
+      "assumption": "all estimated chat tokens are costed at the output-token rate because the transcript-byte metric does not split input, cached input, and output tokens"
+    },
+    "gpt-5.4-standard-short-conservative-output": {
+      "provider": "openai",
+      "model": "gpt-5.4",
+      "category": "flagship",
+      "tier": "standard",
+      "context": "short",
+      "input_usd_per_1m_tokens": 2.5,
+      "cached_input_usd_per_1m_tokens": 0.25,
+      "output_usd_per_1m_tokens": 15,
+      "estimate_rate_usd_per_1m_tokens": 15,
+      "assumption": "all estimated chat tokens are costed at the output-token rate because the transcript-byte metric does not split input, cached input, and output tokens"
+    },
+    "gpt-5.4-standard-long-conservative-output": {
+      "provider": "openai",
+      "model": "gpt-5.4",
+      "category": "flagship",
+      "tier": "standard",
+      "context": "long",
+      "input_usd_per_1m_tokens": 5,
+      "cached_input_usd_per_1m_tokens": 0.5,
+      "output_usd_per_1m_tokens": 22.5,
+      "estimate_rate_usd_per_1m_tokens": 22.5,
+      "assumption": "all estimated chat tokens are costed at the output-token rate because the transcript-byte metric does not split input, cached input, and output tokens"
+    },
+    "gpt-5.4-mini-standard-conservative-output": {
+      "provider": "openai",
+      "model": "gpt-5.4-mini",
+      "category": "flagship",
+      "tier": "standard",
+      "context": "standard",
+      "input_usd_per_1m_tokens": 0.75,
+      "cached_input_usd_per_1m_tokens": 0.075,
+      "output_usd_per_1m_tokens": 4.5,
+      "estimate_rate_usd_per_1m_tokens": 4.5,
+      "assumption": "all estimated chat tokens are costed at the output-token rate because the transcript-byte metric does not split input, cached input, and output tokens"
+    },
+    "gpt-5.4-nano-standard-conservative-output": {
+      "provider": "openai",
+      "model": "gpt-5.4-nano",
+      "category": "flagship",
+      "tier": "standard",
+      "context": "standard",
+      "input_usd_per_1m_tokens": 0.2,
+      "cached_input_usd_per_1m_tokens": 0.02,
+      "output_usd_per_1m_tokens": 1.25,
+      "estimate_rate_usd_per_1m_tokens": 1.25,
+      "assumption": "all estimated chat tokens are costed at the output-token rate because the transcript-byte metric does not split input, cached input, and output tokens"
+    }
+  }
+}

package/scripts/00.chat/metrics/data/chat-pricing.schema.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Chat pricing profile store",
+  "type": "object",
+  "required": ["schema_version", "default_profile", "currency", "unit", "profiles"],
+  "properties": {
+    "schema_version": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "default_profile": {
+      "type": "string",
+      "minLength": 1
+    },
+    "currency": {
+      "type": "string",
+      "minLength": 1
+    },
+    "unit": {
+      "type": "string",
+      "minLength": 1
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "profiles": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": {
+        "type": "object",
+        "required": ["model", "tier", "context", "estimate_rate_usd_per_1m_tokens", "assumption"],
+        "properties": {
+          "provider": {
+            "type": "string"
+          },
+          "model": {
+            "type": "string",
+            "minLength": 1
+          },
+          "tier": {
+            "type": "string",
+            "minLength": 1
+          },
+          "context": {
+            "type": "string",
+            "minLength": 1
+          },
+          "estimate_rate_usd_per_1m_tokens": {
+            "type": ["number", "null"],
+            "minimum": 0
+          },
+          "assumption": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "additionalProperties": true
+      }
+    }
+  },
+  "additionalProperties": true
+}

package/scripts/00.chat/metrics/estimate-chat-cost/README.md

@@ -0,0 +1,40 @@
+<!-- agentic-artifact:
+  schema: agentic-artifact/v2
+  id: chat.script.metrics.estimate-chat-cost.readme
+  version: 1
+  status: active
+  layer: 00.chat
+  domain: metrics
+  disciplines:
+  - agentic
+  kind: capability-readme
+  purpose: Explain chat cost estimate metadata generation.
+  portability:
+    class: required
+    targets:
+    - llm-workbench
+  used_by:
+  - id: chat.script.metrics.estimate-chat-cost.script-js
+    path: scripts/00.chat/metrics/estimate-chat-cost/script.js
+  - id: chat.script.session-log.record-chat-commit
+    path: scripts/00.chat/session-log/record-chat-commit/script.sh
+-->
+# Estimate Chat Cost
+
+`script.js` converts an estimated token count into session-log cost metadata.
+
+The estimate is intentionally conservative and records its basis. Transcript
+byte-derived token estimates do not split input, cached input, and output
+tokens, so the output tells readers what assumption was used rather than
+presenting the number as exact billing.
+
+This capability does not call external pricing APIs. It reads local pricing
+profile data when available and otherwise emits unavailable metadata with a
+reason.
+
+By default it reads `scripts/00.chat/metrics/data/chat-pricing.json`, a
+chat-owned local profile store bundled for standalone installs. Set
+`CHAT_COST_PRICING_FILE` to point at an organization-maintained pricing file and
+`CHAT_COST_PROFILE` to select a profile when local pricing needs to differ from
+the bundled snapshot. The bundled default profile is provider-neutral and marks
+cost unavailable until a concrete pricing profile is selected.

package/scripts/00.chat/metrics/estimate-chat-cost/script.js

@@ -0,0 +1,130 @@
+#!/usr/bin/env node
+// agentic-artifact:
+//   schema: agentic-artifact/v2
+//   id: chat.script.metrics.estimate-chat-cost
+//   version: 1
+//   status: active
+//   layer: 00.chat
+//   domain: metrics
+//   disciplines:
+//     - agentic
+//   kind: script
+//   purpose: Estimate chat cost metadata from an estimated token count.
+//   portability:
+//     class: required
+//     targets:
+//       - llm-workbench
+//   effects:
+//     - read-only
+//   used_by:
+//     - id: chat.script.session-log.record-chat-commit
+//       path: scripts/00.chat/session-log/record-chat-commit/script.sh
+//     - id: chat.script.session-log.record-chat-commit.smoke-test
+//       path: scripts/00.chat/session-log/record-chat-commit/smoke-test.sh
+
+const fs = require('fs');
+const path = require('path');
+
+function usage() {
+  console.error(`Usage:
+  estimate-chat-cost.js <estimated-token-count> [pricing-profile]
+
+Prints estimated_chat_cost and estimated_chat_cost_basis metadata lines.
+`);
+}
+
+function unavailable(costReason, basisReason = costReason) {
+  console.log(`estimated_chat_cost: unavailable; ${costReason}`);
+  console.log(`estimated_chat_cost_basis: unavailable; ${basisReason}`);
+}
+
+function formatUsd(value) {
+  if (value > 0 && value < 1) {
+    return value.toFixed(4);
+  }
+  return value.toFixed(2);
+}
+
+function findRepoRoot(start) {
+  let current = start;
+  while (current !== path.dirname(current)) {
+    if (fs.existsSync(path.join(current, '.git'))) {
+      return current;
+    }
+    current = path.dirname(current);
+  }
+  return start;
+}
+
+const tokenValue = process.argv[2];
+const requestedProfile = process.argv[3] || process.env.CHAT_COST_PROFILE || '';
+
+if (!tokenValue || tokenValue === '-h' || tokenValue === '--help') {
+  usage();
+  process.exit(tokenValue ? 0 : 2);
+}
+
+if (!/^\d+$/.test(tokenValue)) {
+  console.error('ERROR: estimated-token-count must be a non-negative integer.');
+  process.exit(1);
+}
+
+const tokenCount = Number(tokenValue);
+const repoRoot = findRepoRoot(process.cwd());
+const pricingPath = process.env.CHAT_COST_PRICING_FILE ||
+  path.join(repoRoot, 'scripts/00.chat/metrics/data/chat-pricing.json');
+
+if (!fs.existsSync(pricingPath)) {
+  unavailable('pricing snapshot not found');
+  process.exit(0);
+}
+
+let pricing;
+try {
+  pricing = JSON.parse(fs.readFileSync(pricingPath, 'utf8'));
+} catch (error) {
+  console.error(`ERROR: failed to parse pricing snapshot: ${pricingPath}`);
+  console.error(error.message);
+  process.exit(1);
+}
+
+const profileName = requestedProfile || pricing.default_profile;
+const profile = pricing.profiles && pricing.profiles[profileName];
+
+if (!profile) {
+  unavailable(`pricing profile not found: ${profileName || 'none'}`);
+  process.exit(0);
+}
+
+if (profile.estimate_rate_usd_per_1m_tokens === null ||
+    profile.estimate_rate_usd_per_1m_tokens === undefined) {
+  unavailable('no pricing profile selected', 'set CHAT_COST_PROFILE or CHAT_COST_PRICING_FILE');
+  process.exit(0);
+}
+
+const rate = Number(profile.estimate_rate_usd_per_1m_tokens);
+if (!Number.isFinite(rate) || rate < 0) {
+  console.error(`ERROR: invalid estimate_rate_usd_per_1m_tokens for profile: ${profileName}`);
+  process.exit(1);
+}
+
+const currency = pricing.currency || 'USD';
+const cost = (tokenCount / 1000000) * rate;
+const source = pricing.source && pricing.source.url ? pricing.source.url : 'unknown';
+const retrieved = pricing.source && pricing.source.retrieved_at_utc
+  ? pricing.source.retrieved_at_utc
+  : 'unknown';
+
+const basis = [
+  `profile=${profileName}`,
+  `model=${profile.model}`,
+  `tier=${profile.tier}`,
+  `context=${profile.context}`,
+  `rate=${currency} ${rate}/1M tokens`,
+  `assumption=${profile.assumption}`,
+  `pricing_snapshot=${retrieved}`,
+  `source=${source}`,
+].join('; ');
+
+console.log(`estimated_chat_cost: ${currency} ${formatUsd(cost)} estimated from estimated_chat_tokens`);
+console.log(`estimated_chat_cost_basis: ${basis}`);

package/scripts/00.chat/migration/README.md

@@ -0,0 +1,30 @@
+<!-- agentic-artifact:
+  schema: agentic-artifact/v2
+  id: chat.script.migration.readme
+  version: 1
+  status: active
+  layer: 00.chat
+  domain: migration
+  disciplines:
+  - agentic
+  kind: script-domain-readme
+  purpose: Explain migration audit scripts for the chat layer.
+  portability:
+    class: required
+    targets:
+    - llm-workbench
+  used_by:
+  - id: chat.migration-plan
+    path: .agentic/00.chat/migration-plan.md
+  - id: chat.script.migration.audit-chat-layer-migration.readme
+    path: scripts/00.chat/migration/audit-chat-layer-migration/README.md
+-->
+# Migration Scripts
+
+Migration scripts check whether the chat lifecycle layer still depends on old
+locations. They are guardrails for moving behavior into canonical
+`.agentic/00.chat` and `scripts/00.chat` surfaces.
+
+Use this domain when changing ownership, moving compatibility paths, or
+preparing the harness for a standalone workbench repo.
+

package/scripts/00.chat/migration/audit-chat-layer-migration/README.md

@@ -0,0 +1,33 @@
+<!-- agentic-artifact:
+  schema: agentic-artifact/v2
+  id: chat.script.migration.audit-chat-layer-migration.readme
+  version: 1
+  status: active
+  layer: 00.chat
+  domain: migration
+  disciplines:
+  - agentic
+  kind: capability-readme
+  purpose: Explain the chat layer migration audit.
+  portability:
+    class: required
+    targets:
+    - llm-workbench
+  used_by:
+  - id: chat.migration-plan
+    path: .agentic/00.chat/migration-plan.md
+  - id: chat.script.migration.audit-chat-layer-migration
+    path: scripts/00.chat/migration/audit-chat-layer-migration/script.sh
+-->
+# Audit Chat Layer Migration
+
+`script.sh` checks that the canonical chat-layer files exist, retired
+compatibility paths stay absent, and retired compatibility references do not
+return to active process files.
+
+The audit distinguishes current canonical requirements from historical or
+policy references. It does not treat old session logs as migration blockers.
+
+Use this after moving workflows, checklists, standards, or scripts so the next
+agent can see whether the chat layer still relies on retired compatibility
+paths.