Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 12 additions & 16 deletions BUILDS.md
Original file line number Diff line number Diff line change
@@ -1,28 +1,24 @@
---
status: "shipped"
current_state: "The active rep-side B2B product/proof is shipped and pinned: it helps a representative maintain facts, unknowns, branches, next checks, and evidence-timed resolution without premature engineering escalation."
next_action: "No pending build. Keep the product independently visible; any live-desk presentation integration must use its stable seam and starts as new scope."
status: "in-progress"
current_state: "The public README now presents a fixture-driven offline support-process experiment with saved results. No support representative has used it."
next_action: "Review the public README and historical patch metadata, then decide whether the repository is ready to share."
things_to_know:
- "Roadmap source: /Users/aditya/Documents/Projects/support/Old_files/archived-docs/SUPPORT_MASTER_PLAN.md (archived)."
- "M4 front door: /Users/aditya/Documents/Projects/support/customer-support-ai-os/FRONT_DOOR.md."
- "M4 Flow 0 trace: /Users/aditya/Documents/Projects/support/customer-support-ai-os/outputs/flow0_H1.json."
- "This is the canonical continuation of the original real-time support experiment."
- "The product boundary remains B2B rep-side case work; B2C, local-model tuning, and a broader UI rebuild stay outside it."
- "Only the superseded early-root-cause premise and archived local-model/comparison branches are historical experiments."
- "Real transcripts are customer data; do not commit them."
what_it_is: "Rep-side support copilot product/proof for evidence-timed case work, backed by a fixed replay and evaluation harness."
- "The saved replay separates facts, unknowns, possible causes, ruled-out causes, next checks, and evidence-timed resolution."
- "Evidence lives in outputs/experiment_summary.md and outputs/support_process_gpt55_benchmark_report.md."
- "Three tracked patch archives contain email-like commit metadata and need owner review before public visibility."
what_it_is: "Offline support-process experiment for evidence-timed case work, backed by fixed replays and an evaluation harness."
read_next:
- "README.md"
- "SKILL.md"
- "Roadmap.MD"
- "prototype/model_eval.py"
- "run.py"
agent_notes:
- "This repo is active as the independently visible B2B rep-side product/proof; the current shipped build has no pending work."
- "Reuse the run.py stdin/stdout JSON patch seam if another repo imports the engine shape."
- "Validate through consumer replay, not schema checks alone."
safe_first_action: "Run python3 validate_fixtures.py, python3 -m unittest test_experiment.py, and python3 run_all.py before trusting changes."
updated_at: "2026-07-30"
- "Keep saved model output separate from deterministic and mock lanes."
- "Do not describe the precomputed simulator as connected helpdesk input."
- "Validate through the stored replay and named report files."
safe_first_action: "Read README.md and the two named saved reports before making a claim."
updated_at: "2026-09-04"
updated_by: "codex"
---

Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
From 9bb1378565c42fc10fe103754afb6e59bb5a1c4c Mon Sep 17 00:00:00 2001
From: gititya <seshadri.aditya@gmail.com>
From: gititya
Date: Tue, 23 Jun 2026 20:54:18 +0530
Subject: [PATCH 1/2] Add local LLM replay evaluation

Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
From be8cb29ca8211043dbd88d71d233493718fba787 Mon Sep 17 00:00:00 2001
From: gititya <seshadri.aditya@gmail.com>
From: gititya
Date: Wed, 24 Jun 2026 15:46:10 +0530
Subject: [PATCH] Add model replay comparison to simulator

Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
From f0c972f5d40295c30089cb6e4f7c92dcac925e93 Mon Sep 17 00:00:00 2001
From: gititya <seshadri.aditya@gmail.com>
From: gititya
Date: Wed, 24 Jun 2026 00:51:35 +0530
Subject: [PATCH 2/2] Add GPT-5.5 support-state benchmark

Expand Down
58 changes: 24 additions & 34 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,16 @@
# support-copilot — realtime B2B support-process copilot (formerly real-time_support_Updated)
# Copilot Lab — support-process experiment

Active rep-side product/proof: a text-first B2B support-process copilot with a fixed evaluation lab.
**I stopped scoring whether the AI guessed the cause and started scoring whether it said the cause before the evidence existed. A right answer said too early is a failure.**

This is a shipped, separate product/proof inside the wider Support system. It helps a human support
representative maintain facts, unknowns, live branches, and ruled-out paths; choose the next check;
resolve when evidence permits; and avoid unnecessary or premature engineering escalation. Its
fixed harness proves those behaviors. It does not own customer voice, Screen-Aware guidance, or the
deterministic B2C decision seat.
Experiment: can an AI keep an honest investigation state as evidence arrives? This repo uses fixture-driven replay with an offline simulator. No support representative has used it, and the simulator does not accept live helpdesk input.

The prepared B2B replay in `prototype/live_simulator.py` has three steps: an initial report, a customer clarification, then product evidence that supports a cause. The state keeps facts, unknowns, possible and ruled-out causes, and the next check separate while the scripted case unfolds.

The first version asked the wrong question: can an AI predict the specific root cause from the opening turns of a support conversation? It failed for the right reason. Early support turns usually contain symptoms, not mechanism.

This repo reframes the problem: can an AI work the case properly as evidence arrives? The proof is the trace, not the pitch. The harness scores facts, unknowns, active branches, ruled-out paths, next checks, handoff, and the exact moment a final cause becomes justified.

This repo is now a working offline prototype with an evaluation harness underneath. The prototype shows a support copilot working one case turn by turn, while the harness proves whether the copilot keeps facts, unknowns, possible causes, ruled-out paths, next checks, and final outcomes in the right order.
This repo is an offline experiment with an evaluation harness. Its precomputed HTML replays scripted cases turn by turn; the harness checks whether each stored state keeps facts, unknowns, possible causes, ruled-out paths, next checks, and final outcomes in the expected order.

To try the product surface:

Expand All @@ -26,23 +24,25 @@ Then open:
outputs/support_live_simulator.html
```

The simulator includes the three original curated demos plus both level3 closeout cases.
The simulator includes three prepared demos plus two level-3 closeout cases. It is a replay, not a connected support tool.

To run the evaluation harness:

```bash
python3 run_all.py
```

Current proof:
Saved results:

```text
deterministic 12 cases 318/318 100% premature final causes: 0
process_mock 12 cases 318/318 100% premature final causes: 0
predictive_mock 12 cases 275/318 86% premature final causes: 29
real_model opt-in; GPT-5.5 benchmark artifacts are committed separately
deterministic reference 12 fixture cases 318/318 checks (100%) premature final causes: 0
process mock 12 fixture cases 318/318 checks (100%) premature final causes: 0
predictive mock 12 fixture cases 275/318 checks (86%) premature final causes: 29
saved GPT-5.5 run 10 fixture cases 72–96% per case final outcomes correct: 10/10
```

The first three rows are local fixture lanes from `outputs/experiment_summary.md`. The GPT-5.5 row is a saved model run in `outputs/support_process_gpt55_benchmark_report.md`, not a live result.

The predictive mock still reaches the right final cause by the end. It fails because it says the answer too early.

## The one idea
Expand All @@ -67,7 +67,7 @@ That last point is the whole correction.

This is an updated extension of [`gititya/real-time_support`](https://github.com/gititya/real-time_support).

The original repo was valuable because it killed the first premise cleanly. Its Phase 1 result showed that specific root-cause prediction from the first six turns collapsed: early specific accuracy was 14% overall and 7% on clean calls, while full-transcript accuracy was 92-97%. That means the model and judge were not broken. The early transcript simply did not contain the mechanism yet.
The original repo was valuable because it killed the first premise cleanly. On 51 synthetic calls, specific root-cause accuracy from the first six turns was 14%; on the 29 clean calls it was 7%. Full-transcript accuracy was 92% on all 51 calls and 97% on the 29 clean calls. The model and judge could find the cause once the transcript contained the mechanism.

The mistake was treating LTS/process thinking as early final-answer prediction.

Expand Down Expand Up @@ -119,34 +119,24 @@ predictive_mock = behaves like the old failed idea and guesses final cause early
real_model = optional provider-backed run over the same fixtures
```

Current result:

```
deterministic 318/318 100% premature final causes: 0
process_mock 318/318 100% premature final causes: 0
predictive_mock 275/318 86% premature final causes: 29
gpt-5.5 b2b-five 110/114 96.5% premature final causes: 0
gpt-5.5 level3 83/102 81% premature final causes: 0
```

The predictive mock still gets the final cause right by the end. It fails because it says the answer too early.
The predictive mock still gets the final cause right by the end. It fails because it says the answer too early. The saved model results above remain fixture results; they do not show that a support representative benefited.

## What this proves
## What this experiment shows

1. **Builds with AI and builds AI systems.** The repo includes a real-model adapter, committed GPT-5.5 benchmark artifacts, gold-trace scoring, and a premature-answer penalty that catches the old failure mode.
2. **Understands modern support workflows.** Good support work is not just a final answer. The trace keeps next-best-check, evidence timing, open unknowns, ruled-out paths, and handoff as first-class outcomes.
3. **Built B2B, with a reusable engine.** The accepted fixtures are SaaS/B2B support cases, but the engine is the incremental Live Support State plus evidence-timed final-cause gating. A B2C proof should swap the domain fixtures, not fork the reasoning discipline into this repo.
1. The evaluator distinguishes a process mock that waits for evidence from a predictive mock that names causes too early.
2. The saved GPT-5.5 run scored between 72% and 96% on each of ten fixture cases, with all ten stored final outcomes correct.
3. The experiment does not show whether this state would help a support representative on a real case.

## What this is not

1. NOT a customer-facing support bot.
2. NOT a voice agent.
3. NOT a real integration with Zendesk, Intercom, Salesforce, Stripe, or product databases.
4. NOT battle-tested production automation.
4. NOT tested with a support representative or customer.
5. NOT a claim that support AI agents do not already exist.
6. NOT a root-cause prediction benchmark.

It is a working offline prototype for one narrow product question: can a support copilot help an agent work the case correctly as evidence arrives?
It is an offline fixture experiment for one narrow question: can an AI keep the case state honest as evidence arrives?

## What's in here

Expand All @@ -156,7 +146,7 @@ It is a working offline prototype for one narrow product question: can a support
4. `validate_fixtures.py` - schema checks for the support fixtures.
5. `test_experiment.py` - regression tests that prove process passes and predictive fails.
6. `fixtures/` - support-process cases with expected turn-by-turn state.
7. `prototype/live_simulator.py` - static 3-case live replay simulator for judging the support-agent experience.
7. `prototype/live_simulator.py` - precomputed replay data and HTML generator for reviewing the proposed support experience.
8. `outputs/` - generated simulator, reports, dashboards, snapshots, model-ready prompt records, and real-model error analysis.
9. `../Old_files/archived-docs/AUDITABLE_SUPPORT_AI.md` (archived) - the product idea behind the prototype.

Expand Down Expand Up @@ -278,7 +268,7 @@ For the level3 closeout cases:
SSL_CERT_FILE=/etc/ssl/cert.pem python3 run.py --mode real-model --provider openai --model gpt-5.5 --reasoning-effort low --max-output-tokens 4000 --timeout 180 --case-set level3-closeout --run-name gpt55_level3_closeout
```

Saved result: `83/102` checks, final outcomes correct on both level3 cases, and `0` premature final-cause turns. The misses are mostly next-check wording/process-label strictness, not early diagnosis.
Saved result: `83/102` checks (81% across two cases), final outcomes correct on both level-3 cases, and zero premature final-cause turns. The misses are mostly next-check wording and process-label strictness, not early diagnosis.

The saved GPT-5.5 five-case evidence is under:

Expand Down