pumuki 6.3.7

package/package.json

@@ -0,0 +1,218 @@
+{
+  "name": "pumuki",
+  "version": "6.3.7",
+  "description": "Enterprise-grade AST Intelligence System with multi-platform support (iOS, Android, Backend, Frontend) and Feature-First + DDD + Clean Architecture enforcement. Includes dynamic violations API for intelligent querying.",
+  "main": "index.js",
+  "bin": {
+    "pumuki": "bin/pumuki.js",
+    "pumuki-ast-hooks": "bin/pumuki-framework.js",
+    "ast-hooks": "bin/pumuki-framework.js",
+    "pumuki-framework": "bin/pumuki-framework.js",
+    "pumuki-pre-commit": "bin/pumuki-pre-commit.js",
+    "pumuki-pre-push": "bin/pumuki-pre-push.js",
+    "pumuki-ci": "bin/pumuki-ci.js",
+    "pumuki-mcp-evidence": "bin/pumuki-mcp-evidence.js"
+  },
+  "scripts": {
+    "install-hooks": "node bin/pumuki.js install",
+    "check-version": "node bin/pumuki.js status",
+    "pumuki:install": "node bin/pumuki.js install",
+    "pumuki:uninstall": "node bin/pumuki.js uninstall --purge-artifacts",
+    "pumuki:remove": "node bin/pumuki.js remove",
+    "pumuki:update": "node bin/pumuki.js update --latest",
+    "pumuki:doctor": "node bin/pumuki.js doctor",
+    "pumuki:status": "node bin/pumuki.js status",
+    "audit": "node bin/ast",
+    "ast": "node bin/ast",
+    "audit-library": "node bin/audit-library.js",
+    "gitflow": "bash bin/gitflow check",
+    "gitflow:status": "bash bin/gitflow status",
+    "gitflow:workflow": "bash bin/gitflow workflow",
+    "gitflow:reset": "bash bin/gitflow reset",
+    "ast:gitflow": "node scripts/hooks-system/bin/gitflow-cycle.js",
+    "ast:release": "node scripts/hooks-system/bin/gitflow-release.js",
+    "violations": "node bin/violations",
+    "violations:list": "node bin/violations list",
+    "violations:show": "node bin/violations show",
+    "violations:summary": "node bin/violations summary",
+    "violations:top": "node bin/violations top",
+    "violations:demo": "bash bin/demo-violations",
+    "test": "npx --yes tsx@4.21.0 --test integrations/config/__tests__/*.test.ts integrations/gate/__tests__/*.test.ts integrations/git/__tests__/*.test.ts integrations/lifecycle/__tests__/*.test.ts scripts/__tests__/*.test.ts && jest --runInBand --testMatch \"**/__tests__/**/*.spec.ts\"",
+    "lint": "npm run typecheck",
+    "build:ts": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
+    "test:heuristics": "npx --yes tsx@4.21.0 --test core/facts/__tests__/extractHeuristicFacts.test.ts",
+    "test:evidence": "npx --yes tsx@4.21.0 --test integrations/evidence/__tests__/buildEvidence.test.ts integrations/evidence/__tests__/humanIntent.test.ts",
+    "test:mcp": "npx --yes tsx@4.21.0 --test integrations/mcp/__tests__/*.test.ts",
+    "test:stage-gates": "npx --yes tsx@4.21.0 --test integrations/config/__tests__/*.test.ts integrations/gate/__tests__/*.test.ts integrations/git/__tests__/*.test.ts integrations/lifecycle/__tests__/*.test.ts scripts/__tests__/*.test.ts",
+    "test:deterministic": "npm run test:evidence && npm run test:mcp && npm run test:heuristics",
+    "ast:refresh": "bash scripts/hooks-system/bin/update-evidence.sh",
+    "ast:audit": "node scripts/hooks-system/infrastructure/ast/ast-intelligence.js",
+    "ast:guard:start": "bash scripts/hooks-system/bin/evidence-guard start",
+    "ast:guard:stop": "bash scripts/hooks-system/bin/evidence-guard stop",
+    "ast:guard:restart": "bash scripts/hooks-system/bin/evidence-guard restart",
+    "ast:guard:status": "bash scripts/hooks-system/bin/evidence-guard status",
+    "ast:guard:logs": "bash scripts/hooks-system/bin/evidence-guard logs",
+    "ast:check-version": "node scripts/hooks-system/bin/check-version.js",
+    "framework:menu": "node bin/pumuki-framework.js",
+    "validation:consumer-ci-artifacts": "npx --yes tsx@4.21.0 scripts/collect-consumer-ci-artifacts.ts",
+    "validation:consumer-ci-auth-check": "npx --yes tsx@4.21.0 scripts/check-consumer-ci-auth.ts",
+    "validation:consumer-workflow-lint": "npx --yes tsx@4.21.0 scripts/lint-consumer-workflows.ts",
+    "validation:consumer-support-bundle": "npx --yes tsx@4.21.0 scripts/build-consumer-startup-failure-support-bundle.ts",
+    "validation:consumer-support-ticket-draft": "npx --yes tsx@4.21.0 scripts/build-consumer-support-ticket-draft.ts",
+    "validation:consumer-startup-unblock-status": "npx --yes tsx@4.21.0 scripts/build-consumer-startup-unblock-status.ts",
+    "validation:consumer-startup-triage": "npx --yes tsx@4.21.0 scripts/build-consumer-startup-triage.ts",
+    "validation:mock-consumer-ab-report": "npx --yes tsx@4.21.0 scripts/build-mock-consumer-ab-report.ts",
+    "validation:adapter-readiness": "npx --yes tsx@4.21.0 scripts/build-adapter-readiness.ts",
+    "validation:adapter-real-session-report": "npx --yes tsx@4.21.0 scripts/build-adapter-real-session-report.ts",
+    "validation:adapter-session-status": "npx --yes tsx@4.21.0 scripts/build-adapter-session-status.ts",
+    "validation:phase5-blockers-readiness": "npx --yes tsx@4.21.0 scripts/build-phase5-blockers-readiness.ts",
+    "validation:phase5-execution-closure-status": "npx --yes tsx@4.21.0 scripts/build-phase5-execution-closure-status.ts",
+    "validation:phase5-execution-closure": "npx --yes tsx@4.21.0 scripts/run-phase5-execution-closure.ts",
+    "validation:phase5-external-handoff": "npx --yes tsx@4.21.0 scripts/build-phase5-external-handoff.ts",
+    "validation:phase5-latest:refresh": "bash scripts/refresh-phase5-latest-escalation.sh",
+    "validation:phase5-latest:sync-docs": "bash scripts/sync-phase5-latest-docs.sh",
+    "validation:phase5-latest:ready-check": "bash scripts/check-phase5-latest-ready-chain.sh",
+    "validation:phase5-post-support:refresh": "bash scripts/run-phase5-post-support-refresh.sh",
+    "validation:phase8:resume-after-billing": "bash scripts/run-phase8-after-billing-reactivation.sh",
+    "validation:phase8:next-step": "bash scripts/run-phase8-next-step.sh",
+    "validation:phase8:doctor": "bash scripts/run-phase8-doctor.sh",
+    "validation:phase8:autopilot": "bash scripts/run-phase8-autopilot.sh",
+    "validation:phase8:status-pack": "bash scripts/run-phase8-status-pack.sh",
+    "validation:phase8:tick": "bash scripts/run-phase8-tick.sh",
+    "validation:phase8:loop-guard": "bash scripts/check-phase8-loop-guard.sh",
+    "validation:phase8:loop-guard-coverage": "bash scripts/check-phase8-loop-guard-coverage.sh",
+    "validation:phase8:mark-followup-state": "bash scripts/mark-phase8-support-followup-state.sh",
+    "validation:phase8:mark-followup-posted-now": "bash scripts/mark-phase8-followup-posted-now.sh",
+    "validation:phase8:mark-followup-replied-now": "bash scripts/mark-phase8-followup-replied-now.sh",
+    "validation:phase8:ready-handoff": "bash scripts/build-phase8-ready-handoff-summary.sh",
+    "validation:phase8:close-ready": "bash scripts/run-phase8-close-ready.sh",
+    "validation:progress-single-active": "bash scripts/check-refactor-progress-single-active.sh",
+    "validation:phase5-escalation:ready-to-submit": "bash scripts/check-phase5-escalation-ready-to-submit.sh",
+    "validation:phase5-escalation:prepare": "bash scripts/prepare-phase5-escalation-submission.sh",
+    "validation:phase5-escalation:close-submission": "bash scripts/close-phase5-escalation-submission.sh",
+    "validation:phase5-escalation:mark-submitted": "bash scripts/mark-phase5-escalation-submitted.sh",
+    "validation:phase5-escalation:payload": "bash scripts/build-phase5-support-portal-payload.sh",
+    "validation:architecture-guardrails": "npx --yes tsx@4.21.0 --test scripts/__tests__/architecture-file-size-guardrails.test.ts",
+    "validation:package-manifest": "node --import tsx scripts/check-package-manifest.ts",
+    "validation:package-smoke": "node --import tsx scripts/package-install-smoke.ts --mode=block",
+    "validation:package-smoke:minimal": "node --import tsx scripts/package-install-smoke.ts --mode=minimal",
+    "validation:lifecycle-smoke": "node --import tsx scripts/package-install-smoke.ts --mode=minimal",
+    "validation:clean-artifacts": "npx --yes tsx@4.21.0 scripts/clean-validation-artifacts.ts",
+    "validation:docs-hygiene": "npx --yes tsx@4.21.0 scripts/check-validation-docs-hygiene.ts",
+    "skills:compile": "npx --yes tsx@4.21.0 scripts/compile-skills-lock.ts",
+    "skills:lock:check": "npx --yes tsx@4.21.0 scripts/compile-skills-lock.ts --check",
+    "mcp:evidence": "node bin/pumuki-mcp-evidence.js",
+    "validate:adapter-hooks-local": "echo 'Migrated to modern TS scripts — use validation:adapter-readiness instead'",
+    "verify:adapter-hooks-runtime": "echo 'Migrated to modern TS scripts — use validation:adapter-readiness instead'"
+  },
+  "keywords": [
+    "ast",
+    "code-quality",
+    "static-analysis",
+    "ios",
+    "android",
+    "backend",
+    "frontend",
+    "clean-architecture",
+    "ddd",
+    "feature-first",
+    "git-hooks",
+    "pre-commit",
+    "typescript",
+    "swift",
+    "kotlin",
+    "react",
+    "nextjs",
+    "nestjs"
+  ],
+  "author": {
+    "name": "Juan Carlos Merlos Albarracín",
+    "email": "freelancemerlos@gmail.com",
+    "organization": "Pumuki Team"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SwiftEnProfundidad/ast-intelligence-hooks.git"
+  },
+  "bugs": {
+    "url": "https://github.com/SwiftEnProfundidad/ast-intelligence-hooks/issues"
+  },
+  "homepage": "https://github.com/SwiftEnProfundidad/ast-intelligence-hooks#readme",
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=9.0.0"
+  },
+  "dependencies": {
+    "@babel/parser": "^7.28.5",
+    "glob": "^10.5.0",
+    "ts-morph": ">=21.0.0",
+    "tsx": "^4.21.0",
+    "zod": "^4.3.6"
+  },
+  "peerDependencies": {
+    "ts-morph": ">=21.0.0"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.29.0",
+    "@babel/generator": "^7.28.5",
+    "@babel/preset-env": "^7.29.0",
+    "@babel/preset-typescript": "^7.28.5",
+    "@babel/traverse": "^7.28.5",
+    "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^8.55.0",
+    "@typescript-eslint/parser": "^8.55.0",
+    "babel-jest": "^30.2.0",
+    "eslint": "^9.12.0",
+    "jest": "^30.2.0",
+    "jscodeshift": "^17.3.0",
+    "recast": "^0.23.11",
+    "typescript": "^5.3.0",
+    "typescript-eslint": "^8.55.0"
+  },
+  "files": [
+    "bin/*.js",
+    "core/utils/*.ts",
+    "core/facts/*.ts",
+    "core/facts/detectors/**/*.ts",
+    "core/gate/*.ts",
+    "core/rules/*.ts",
+    "core/rules/presets/*.ts",
+    "core/rules/presets/heuristics/*.ts",
+    "integrations/config/*.ts",
+    "integrations/evidence/*.ts",
+    "integrations/gate/*.ts",
+    "integrations/git/*.ts",
+    "integrations/lifecycle/*.ts",
+    "integrations/mcp/*.ts",
+    "integrations/platform/*.ts",
+    "scripts/*.ts",
+    "scripts/*.sh",
+    "docs/*.md",
+    "docs/rule-packs/*.md",
+    "docs/validation/*.md",
+    "docs/images/README.md",
+    "assets/*",
+    "index.js",
+    "README.md",
+    "LICENSE",
+    "VERSION",
+    "tsconfig.json",
+    "skills.lock.json",
+    "skills.sources.json"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "exports": {
+    ".": "./index.js",
+    "./package.json": "./package.json",
+    "./integrations/git": "./integrations/git/index.ts",
+    "./integrations/lifecycle": "./integrations/lifecycle/index.ts",
+    "./integrations/mcp": "./integrations/mcp/index.ts",
+    "./core/gate/evaluateGate": "./core/gate/evaluateGate.ts",
+    "./core/gate/evaluateRules": "./core/gate/evaluateRules.ts"
+  }
+}

package/scripts/adapter-readiness-cli-lib.ts

@@ -0,0 +1,64 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+export type AdapterReadinessCliOptions = {
+  adapterReportFile: string;
+  outFile: string;
+};
+
+export const DEFAULT_ADAPTER_READINESS_REPORT_FILE =
+  '.audit-reports/adapter/adapter-real-session-report.md';
+export const DEFAULT_ADAPTER_READINESS_OUT_FILE =
+  '.audit-reports/adapter/adapter-readiness.md';
+
+export const parseAdapterReadinessArgs = (
+  args: ReadonlyArray<string>
+): AdapterReadinessCliOptions => {
+  const options: AdapterReadinessCliOptions = {
+    adapterReportFile: DEFAULT_ADAPTER_READINESS_REPORT_FILE,
+    outFile: DEFAULT_ADAPTER_READINESS_OUT_FILE,
+  };
+
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+
+    if (arg === '--adapter-report') {
+      const value = args[index + 1];
+      if (!value) {
+        throw new Error('Missing value for --adapter-report');
+      }
+      options.adapterReportFile = value;
+      index += 1;
+      continue;
+    }
+
+    if (arg === '--out') {
+      const value = args[index + 1];
+      if (!value) {
+        throw new Error('Missing value for --out');
+      }
+      options.outFile = value;
+      index += 1;
+      continue;
+    }
+
+    throw new Error(`Unknown argument: ${arg}`);
+  }
+
+  return options;
+};
+
+export const readAdapterReadinessInput = (
+  cwd: string,
+  pathLike: string
+): { exists: boolean; content?: string } => {
+  const absolute = resolve(cwd, pathLike);
+  if (!existsSync(absolute)) {
+    return { exists: false };
+  }
+
+  return {
+    exists: true,
+    content: readFileSync(absolute, 'utf8'),
+  };
+};

package/scripts/adapter-readiness-contract.ts

@@ -0,0 +1,46 @@
+export type ParsedAdapterReport = {
+  validationResult?: 'PASS' | 'FAIL';
+  nodeCommandNotFound: boolean;
+};
+
+export type AdapterReadinessEntry = {
+  name: 'adapter';
+  status: 'PASS' | 'FAIL' | 'MISSING';
+  notes: ReadonlyArray<string>;
+};
+
+export type AdapterReadinessSummary = {
+  verdict: 'READY' | 'BLOCKED' | 'PENDING';
+  adapters: ReadonlyArray<AdapterReadinessEntry>;
+  blockers: ReadonlyArray<string>;
+  missingInputs: ReadonlyArray<string>;
+};
+
+export type SummarizeAdapterReadinessParams = {
+  hasAdapterReport: boolean;
+  adapter?: ParsedAdapterReport;
+};
+
+export type BuildAdapterReadinessMarkdownParams = {
+  generatedAt: string;
+  adapterReportPath: string;
+  hasAdapterReport: boolean;
+  summary: AdapterReadinessSummary;
+};
+
+export const dedupeAdapterReadinessValues = (
+  values: ReadonlyArray<string>
+): string[] => {
+  const seen = new Set<string>();
+  const result: string[] = [];
+
+  for (const value of values) {
+    if (seen.has(value)) {
+      continue;
+    }
+    seen.add(value);
+    result.push(value);
+  }
+
+  return result;
+};

package/scripts/adapter-readiness-lib.ts

@@ -0,0 +1,10 @@
+export type {
+  AdapterReadinessEntry,
+  AdapterReadinessSummary,
+  BuildAdapterReadinessMarkdownParams,
+  ParsedAdapterReport,
+  SummarizeAdapterReadinessParams,
+} from './adapter-readiness-contract';
+export { parseAdapterReport } from './adapter-readiness-parser-lib';
+export { summarizeAdapterReadiness } from './adapter-readiness-summary-lib';
+export { buildAdapterReadinessMarkdown } from './adapter-readiness-markdown-lib';

package/scripts/adapter-readiness-markdown-lib.ts

@@ -0,0 +1,41 @@
+import type { BuildAdapterReadinessMarkdownParams } from './adapter-readiness-contract';
+import { appendAdapterReadinessNextActionsSection } from './adapter-readiness-markdown-next-actions-lib';
+import {
+  appendAdapterReadinessBlockersSection,
+  appendAdapterReadinessHeaderSection,
+  appendAdapterReadinessInputsSection,
+  appendAdapterReadinessMissingInputsSection,
+  appendAdapterReadinessStatusSection,
+} from './adapter-readiness-markdown-sections-lib';
+
+export const buildAdapterReadinessMarkdown = (
+  params: BuildAdapterReadinessMarkdownParams
+): string => {
+  const lines: string[] = [];
+  appendAdapterReadinessHeaderSection({
+    lines,
+    source: params,
+  });
+  appendAdapterReadinessInputsSection({
+    lines,
+    source: params,
+  });
+  appendAdapterReadinessStatusSection({
+    lines,
+    source: params,
+  });
+  appendAdapterReadinessMissingInputsSection({
+    lines,
+    source: params,
+  });
+  appendAdapterReadinessBlockersSection({
+    lines,
+    source: params,
+  });
+  appendAdapterReadinessNextActionsSection({
+    lines,
+    source: params,
+  });
+
+  return `${lines.join('\n')}\n`;
+};

package/scripts/adapter-readiness-markdown-next-actions-lib.ts

@@ -0,0 +1,33 @@
+import type { BuildAdapterReadinessMarkdownParams } from './adapter-readiness-contract';
+
+const hasAdapterRuntimeBlocker = (source: BuildAdapterReadinessMarkdownParams): boolean =>
+  source.summary.blockers.some(
+    (item) =>
+      item.includes('Adapter adapter validation') || item.includes('node: command not found')
+  );
+
+export const appendAdapterReadinessNextActionsSection = (params: {
+  lines: string[];
+  source: BuildAdapterReadinessMarkdownParams;
+}): void => {
+  params.lines.push('## Next Actions');
+  params.lines.push('');
+  if (params.source.summary.verdict === 'READY') {
+    params.lines.push('- Adapter diagnostics are healthy.');
+    params.lines.push('- Keep this report attached to rollout validation evidence.');
+    params.lines.push('');
+    return;
+  }
+
+  if (!params.source.hasAdapterReport) {
+    params.lines.push(
+      '- Generate Adapter report: `npm run validation:adapter-real-session-report -- --status-report .audit-reports/adapter/adapter-session-status.md --out .audit-reports/adapter/adapter-real-session-report.md`'
+    );
+  }
+  if (hasAdapterRuntimeBlocker(params.source)) {
+    params.lines.push(
+      '- Execute `docs/validation/adapter-hook-runtime-validation.md`, then regenerate adapter readiness report.'
+    );
+  }
+  params.lines.push('');
+};

package/scripts/adapter-readiness-markdown-sections-lib.ts

@@ -0,0 +1,78 @@
+import type { BuildAdapterReadinessMarkdownParams } from './adapter-readiness-contract';
+
+const appendListSection = (params: {
+  lines: string[];
+  title: string;
+  values: ReadonlyArray<string>;
+}): void => {
+  params.lines.push(params.title);
+  params.lines.push('');
+  if (params.values.length === 0) {
+    params.lines.push('- none');
+  } else {
+    for (const value of params.values) {
+      params.lines.push(`- ${value}`);
+    }
+  }
+  params.lines.push('');
+};
+
+export const appendAdapterReadinessHeaderSection = (params: {
+  lines: string[];
+  source: BuildAdapterReadinessMarkdownParams;
+}): void => {
+  params.lines.push('# Adapter Readiness');
+  params.lines.push('');
+  params.lines.push(`- generated_at: ${params.source.generatedAt}`);
+  params.lines.push(`- verdict: ${params.source.summary.verdict}`);
+  params.lines.push('');
+};
+
+export const appendAdapterReadinessInputsSection = (params: {
+  lines: string[];
+  source: BuildAdapterReadinessMarkdownParams;
+}): void => {
+  params.lines.push('## Inputs');
+  params.lines.push('');
+  params.lines.push(
+    `- adapter_report: \`${params.source.adapterReportPath}\` (${params.source.hasAdapterReport ? 'found' : 'missing'})`
+  );
+  params.lines.push('');
+};
+
+export const appendAdapterReadinessStatusSection = (params: {
+  lines: string[];
+  source: BuildAdapterReadinessMarkdownParams;
+}): void => {
+  params.lines.push('## Adapter Status');
+  params.lines.push('');
+  for (const adapter of params.source.summary.adapters) {
+    params.lines.push(`- ${adapter.name}: ${adapter.status}`);
+    for (const note of adapter.notes) {
+      params.lines.push(`  - ${note}`);
+    }
+  }
+  params.lines.push('');
+};
+
+export const appendAdapterReadinessMissingInputsSection = (params: {
+  lines: string[];
+  source: BuildAdapterReadinessMarkdownParams;
+}): void => {
+  appendListSection({
+    lines: params.lines,
+    title: '## Missing Inputs',
+    values: params.source.summary.missingInputs,
+  });
+};
+
+export const appendAdapterReadinessBlockersSection = (params: {
+  lines: string[];
+  source: BuildAdapterReadinessMarkdownParams;
+}): void => {
+  appendListSection({
+    lines: params.lines,
+    title: '## Blockers',
+    values: params.source.summary.blockers,
+  });
+};

package/scripts/adapter-readiness-parser-lib.ts

@@ -0,0 +1,30 @@
+import type { ParsedAdapterReport } from './adapter-readiness-contract';
+
+export const parseAdapterReport = (markdown: string): ParsedAdapterReport => {
+  const validationRaw = markdown
+    .match(/- Validation result:\s*([^\n]+)/)?.[1]
+    ?.trim()
+    .toUpperCase();
+
+  const validationResult =
+    validationRaw === 'PASS' || validationRaw === 'FAIL'
+      ? (validationRaw as 'PASS' | 'FAIL')
+      : undefined;
+
+  const runtimeNodeRaw = markdown
+    .match(/- Any `bash: node: command not found`:\s*([^\n]+)/)?.[1]
+    ?.trim()
+    .toUpperCase();
+
+  const nodeCommandNotFound =
+    runtimeNodeRaw === 'YES'
+      ? true
+      : runtimeNodeRaw === 'NO'
+        ? false
+        : /node:\s*command not found/i.test(markdown);
+
+  return {
+    validationResult,
+    nodeCommandNotFound,
+  };
+};

package/scripts/adapter-readiness-summary-lib.ts

@@ -0,0 +1,62 @@
+import {
+  dedupeAdapterReadinessValues,
+  type AdapterReadinessEntry,
+  type AdapterReadinessSummary,
+  type SummarizeAdapterReadinessParams,
+} from './adapter-readiness-contract';
+
+export const summarizeAdapterReadiness = (
+  params: SummarizeAdapterReadinessParams
+): AdapterReadinessSummary => {
+  const blockers: string[] = [];
+  const missingInputs: string[] = [];
+  const adapters: AdapterReadinessEntry[] = [];
+
+  if (!params.hasAdapterReport) {
+    missingInputs.push('Missing Adapter adapter report');
+    adapters.push({
+      name: 'adapter',
+      status: 'MISSING',
+      notes: ['No Adapter diagnostics report was provided.'],
+    });
+  } else {
+    const notes: string[] = [];
+    let status: AdapterReadinessEntry['status'] = 'PASS';
+
+    if (params.adapter?.validationResult !== 'PASS') {
+      status = 'FAIL';
+      notes.push(
+        `Adapter validation result is ${params.adapter?.validationResult ?? 'unknown'}`
+      );
+      blockers.push(
+        `Adapter adapter validation is ${params.adapter?.validationResult ?? 'unknown'}`
+      );
+    }
+
+    if (params.adapter?.nodeCommandNotFound) {
+      status = 'FAIL';
+      notes.push('Adapter runtime reports node command resolution failures.');
+      blockers.push('Adapter adapter runtime reports `node: command not found`.');
+    }
+
+    if (notes.length === 0) {
+      notes.push('Adapter adapter diagnostics are healthy.');
+    }
+
+    adapters.push({
+      name: 'adapter',
+      status,
+      notes,
+    });
+  }
+
+  const verdict: AdapterReadinessSummary['verdict'] =
+    blockers.length > 0 ? 'BLOCKED' : missingInputs.length > 0 ? 'PENDING' : 'READY';
+
+  return {
+    verdict,
+    adapters,
+    blockers: dedupeAdapterReadinessValues(blockers),
+    missingInputs: dedupeAdapterReadinessValues(missingInputs),
+  };
+};

package/scripts/adapter-real-session-analysis-evaluation-lib.ts

@@ -0,0 +1,49 @@
+import type { AdapterRealSessionReportParams } from './adapter-real-session-contract';
+import type { AdapterRealSessionSignals } from './adapter-real-session-analysis-signals-lib';
+import {
+  type PassFailUnknown,
+  deriveAdapterRealSessionInstallStatus,
+  deriveAdapterRealSessionValidationPass,
+  deriveAdapterRealSessionVerifyStatus,
+} from './adapter-real-session-analysis-status-lib';
+import { buildAdapterRealSessionEvaluationMessages } from './adapter-real-session-analysis-messages-lib';
+
+export type AdapterRealSessionEvaluation = {
+  verifyStatus: PassFailUnknown;
+  installStatus: 'PASS' | 'FAIL';
+  validationPass: boolean;
+  summary: string;
+  rootCause: string;
+  correctiveAction: string;
+};
+
+export const evaluateAdapterRealSessionSignals = (params: {
+  report: AdapterRealSessionReportParams;
+  signals: AdapterRealSessionSignals;
+}): AdapterRealSessionEvaluation => {
+  const verifyStatus = deriveAdapterRealSessionVerifyStatus(
+    params.report.parsedStatus.verifyExitCode
+  );
+  const installStatus = deriveAdapterRealSessionInstallStatus({
+    report: params.report,
+  });
+  const validationPass = deriveAdapterRealSessionValidationPass({
+    verifyStatus,
+    report: params.report,
+    signals: params.signals,
+  });
+  const messages = buildAdapterRealSessionEvaluationMessages({
+    validationPass,
+    signals: params.signals,
+    report: params.report,
+  });
+
+  return {
+    verifyStatus,
+    installStatus,
+    validationPass,
+    summary: messages.summary,
+    rootCause: messages.rootCause,
+    correctiveAction: messages.correctiveAction,
+  };
+};

package/scripts/adapter-real-session-analysis-lib.ts

@@ -0,0 +1,8 @@
+export {
+  collectAdapterRealSessionSignals,
+  type AdapterRealSessionSignals,
+} from './adapter-real-session-analysis-signals-lib';
+export {
+  evaluateAdapterRealSessionSignals,
+  type AdapterRealSessionEvaluation,
+} from './adapter-real-session-analysis-evaluation-lib';