From 1379cd70e464a3c21c19e83b1ddd77826a857922 Mon Sep 17 00:00:00 2001
From: Roger Chappel <miscanalysis@gmail.com>
Date: Mon, 6 Jul 2026 16:07:05 +1000
Subject: [PATCH] docs: use packaged fixture CLI examples

---
 README.md        |  6 +++---
 test/cli.test.js | 17 +++++++++++++++++
 2 files changed, 20 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index a316784..5ab3f93 100644
--- a/README.md
+++ b/README.md
@@ -90,12 +90,12 @@ Everything currently ships from one package with a few focused entry surfaces:
 
 ```sh
 bargekit fixtures --json
-bargekit tune --fixture tests/fixtures/long_utterance.json --json
-bargekit smoke --fixture tests/fixtures/interruption_timing.json --json
+bargekit tune --profile wired_headset --json
+bargekit smoke --name interruption_timing --json
 bargekit demo
 ```
 
-The CLI uses synthetic/local fixture data only; it does not open a microphone.
+The CLI uses built-in synthetic data or explicit local fixture files only; it does not open a microphone.
 
 ## Demo
 
diff --git a/test/cli.test.js b/test/cli.test.js
index 543ac6f..1ac363f 100644
--- a/test/cli.test.js
+++ b/test/cli.test.js
@@ -33,6 +33,15 @@ test('cli smokes a checked-in fixture file', () => {
   assert.equal(payload.passed, true);
 });
 
+test('cli smokes a built-in fixture by name for installed users', () => {
+  const result = runCli(['smoke', '--name', 'interruption_timing', '--json']);
+  assert.equal(result.status, 0, result.stderr);
+  const payload = JSON.parse(result.stdout);
+  assert.equal(payload.fixture, 'interruption_timing');
+  assert.equal(payload.speechStarted, true);
+  assert.equal(payload.passed, true);
+});
+
 test('cli tune can analyze a fixture file', () => {
   const result = runCli(['tune', '--fixture', 'tests/fixtures/long_utterance.json', '--json']);
   assert.equal(result.status, 0, result.stderr);
@@ -40,3 +49,11 @@ test('cli tune can analyze a fixture file', () => {
   assert.equal(report[0].fixture, 'long_utterance');
   assert.ok(report[0].speechFrames > 0);
 });
+
+test('cli tune can use bundled fixtures without file paths', () => {
+  const result = runCli(['tune', '--profile', 'wired_headset', '--json']);
+  assert.equal(result.status, 0, result.stderr);
+  const report = JSON.parse(result.stdout);
+  assert.ok(report.some((item) => item.fixture === 'interruption_timing'));
+  assert.ok(report.every((item) => Number.isFinite(item.peakLevel)));
+});