@they-juanreina/compost-cli 0.1.2 → 0.1.4

package/dist/render/human.js

@@ -0,0 +1,62 @@
+import { glyphs } from './glyphs.js';
+/** Human-readable summaries for the tutorial-facing verbs (#173). Commands pass
+ * these to `emit(..., render)`; machine/JSON output is unaffected. Verbs without
+ * a renderer fall back to pretty-printed JSON. */
+function fmtMs(ms) {
+    if (ms === undefined || ms === null)
+        return '?';
+    const s = Math.floor(ms / 1000);
+    return `${Math.floor(s / 60)}:${String(s % 60).padStart(2, '0')}`;
+}
+export function renderStatus(s) {
+    const g = glyphs();
+    const lines = [`compost — ${s.seeds.length} seed(s) under ${s.root}`];
+    for (const seed of s.seeds) {
+        const c = seed.counts;
+        lines.push('');
+        lines.push(`  ${seed.name}${seed.status ? `  [${seed.status}]` : ''}`);
+        lines.push(`    sessions:   ${c.sessions.total} (${c.sessions.transcribed} transcribed, ${c.sessions.queued} queued, ${c.sessions.inbox} in _inbox)`);
+        lines.push(`    highlights: ${c.highlights}   codes: ${c.codes}   themes: ${c.themes}`);
+        lines.push(`    frames: ${c.frames}   insights: ${c.insights}   legacy: ${c.legacy_assets}`);
+        for (const w of seed.warnings)
+            lines.push(`    ${g.warn} ${w}`);
+    }
+    return lines.join('\n');
+}
+export function renderSearch(v) {
+    const g = glyphs();
+    const lines = [
+        `"${v.query}" — ${v.returned} result(s) [${v.retrieval}] of ${v.indexed_chunks} chunks`,
+    ];
+    for (const [i, r] of v.results.entries()) {
+        const t = r.text.replace(/\s+/g, ' ').trim();
+        const clipped = t.length > 160 ? `${t.slice(0, 157)}${g.ellipsis}` : t;
+        lines.push('');
+        lines.push(`  ${i + 1}. [${r.session ?? '?'} ${fmtMs(r.start_ms)}–${fmtMs(r.end_ms)}] score ${r.score}`);
+        lines.push(`     ${clipped}`);
+    }
+    if (v.hint !== undefined) {
+        lines.push('');
+        lines.push(`  ${g.arrow} ${v.hint}`);
+    }
+    return lines.join('\n');
+}
+export function renderDoctor(r) {
+    const g = glyphs();
+    const lines = [`models doctor — ${r.ok ? 'OK' : 'ISSUES'}`, '  providers:'];
+    for (const [name, h] of Object.entries(r.providers)) {
+        lines.push(`    ${h.ok ? g.ok : g.fail} ${name}${h.ok ? ` (${h.model_list.length} models, ${h.latency_ms}ms)` : ` — ${h.error ?? 'down'}`}`);
+    }
+    lines.push('  tasks:');
+    for (const t of r.tasks) {
+        lines.push(`    ${t.status === 'ok' ? g.ok : g.fail} ${t.task} → ${t.route}${t.status === 'ok' ? '' : `  [${t.status}]`}${t.suggestion ? `  ${g.arrow} ${t.suggestion}` : ''}`);
+    }
+    const unused = Object.entries(r.unused_models);
+    if (unused.length > 0) {
+        lines.push('  pulled but unconfigured:');
+        for (const [p, ms] of unused)
+            lines.push(`    ${p}: ${ms.join(', ')}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=human.js.map

package/dist/render/human.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"human.js","sourceRoot":"","sources":["../../src/render/human.ts"],"names":[],"mappings":"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"}

package/dist/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAgCnC,wBAAgB,YAAY,IAAI,OAAO,CA2CtC"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAuCnC,wBAAgB,YAAY,IAAI,OAAO,CAkEtC"}

package/dist/router.js

@@ -1,4 +1,6 @@
 import { Command } from 'commander';
+import { registerAgreement } from './commands/agreement.js';
+import { registerBackup } from './commands/backup.js';
 import { registerBlame } from './commands/blame.js';
 import { registerChat } from './commands/chat.js';
 import { registerCode } from './commands/code.js';
@@ -7,15 +9,21 @@ import { registerCreate } from './commands/create.js';
 import { registerEndorse } from './commands/endorse.js';
 import { registerEvals } from './commands/evals.js';
 import { registerExport } from './commands/export.js';
+import { registerImport } from './commands/import.js';
 import { registerIngest } from './commands/ingest.js';
 import { registerInit } from './commands/init.js';
+import { registerJobs } from './commands/jobs.js';
+import { registerLabel } from './commands/label.js';
 import { registerMigrate } from './commands/migrate.js';
 import { registerModels } from './commands/models.js';
 import { registerQuery } from './commands/query.js';
+import { registerRecode } from './commands/recode.js';
 import { registerReindex } from './commands/reindex.js';
+import { registerRerun } from './commands/rerun.js';
 import { registerRescan } from './commands/rescan.js';
 import { registerSaturate } from './commands/saturate.js';
 import { registerSearch } from './commands/search.js';
+import { registerSecrets } from './commands/secrets.js';
 import { registerServe } from './commands/serve.js';
 import { registerSession } from './commands/session.js';
 import { registerSetup } from './commands/setup.js';
@@ -26,33 +34,53 @@ import { registerTag } from './commands/tag.js';
 import { registerTranscribe } from './commands/transcribe.js';
 import { registerValidate } from './commands/validate.js';
 import { registerWatch } from './commands/watch.js';
-const VERSION = '0.1.2';
+import { currentCliVersion } from './lib/version.js';
 export function buildProgram() {
     const program = new Command();
     program
         .name('compost')
         .description('Local-first, AI-first research analysis harness for coding agents and humans.')
-        .version(VERSION, '-V, --version')
-        .option('--human', 'Pretty-print output for human eyes (JSON is the default — agents parse it directly).')
+        // Single source of truth: read from package.json (drops a file from the
+        // version-bump checklist; no more hardcoded literal to drift).
+        .version(currentCliVersion(), '-V, --version')
+        .option('--human', 'Force human-readable output (auto-on at a TTY; JSON when piped or called by an agent).')
+        .option('--json', 'Force machine-readable JSON output (overrides TTY auto-detection).')
         .showHelpAfterError()
-        .configureHelp({ sortSubcommands: true });
+        .configureHelp({ sortSubcommands: true })
+        .addHelpText('after', `
+Quick start:
+  $ compost init my-study                                   scaffold Seeds/my-study/
+  $ printf %s "$HF_TOKEN" | compost secrets set HUGGINGFACE_TOKEN   store a token (not in shell history)
+  $ compost ingest ./recording.m4a --seed my-study          queue audio for transcription
+  $ compost watch --once --seed my-study                    drain the ingest/transcribe/embed queue
+  $ compost search "trust" --seed my-study                  retrieve grounded passages
+
+Output is human-readable at a TTY and JSON when piped or called by an agent (force with --json / --human).`);
     registerInit(program);
     registerIngest(program);
+    registerImport(program);
     registerTranscribe(program);
+    registerLabel(program);
     registerWatch(program);
+    registerJobs(program);
     registerSnap(program);
     registerStatus(program);
     registerBlame(program);
     registerMigrate(program);
     registerExport(program);
+    registerBackup(program);
     registerReindex(program);
     registerRescan(program);
     registerSaturate(program);
     registerValidate(program);
     registerTag(program);
     registerCode(program);
+    registerRecode(program);
+    registerAgreement(program);
+    registerRerun(program);
     registerSynthesize(program);
     registerSearch(program);
+    registerSecrets(program);
     registerSession(program);
     registerCreate(program);
     registerEndorse(program);

package/dist/router.js.map

@@ -1 +1 @@
-{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"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"}

package/dist/transcriber_client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transcriber_client.d.ts","sourceRoot":"","sources":["../src/transcriber_client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;IACvB,MAAM,EAAE,IAAI,GAAG,sBAAsB,GAAG,sBAAsB,CAAA;CAC/D;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAA;IACX,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAA;CACxC;AAED,qBAAa,uBAAwB,SAAQ,KAAK;aAG9B,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,QAAQ;gBADzD,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,QAAQ;CAK5D;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,gFAAgF;AAChF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;gBAEtB,IAAI,GAAE,wBAA6B;IAMzC,MAAM,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAc1C;;;;;;;;;;;;OAYG;IACG,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,CAAC;CA+B/B"}
+{"version":3,"file":"transcriber_client.d.ts","sourceRoot":"","sources":["../src/transcriber_client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;IACvB,MAAM,EAAE,IAAI,GAAG,sBAAsB,GAAG,sBAAsB,CAAA;CAC/D;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAA;IACX,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAA;CACxC;AAED,qBAAa,uBAAwB,SAAQ,KAAK;aAG9B,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,QAAQ;gBADzD,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,QAAQ;CAK5D;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,gFAAgF;AAChF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;gBAEtB,IAAI,GAAE,wBAA6B;IAMzC,MAAM,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAc1C;;;;;;;;;;;;OAYG;IACG,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,CAAC;CA+B/B"}

package/dist/transcriber_client.js

@@ -1,3 +1,4 @@
+import { errMessage } from './errors.js';
 import { resolveFetch } from './llm/http.js';
 export class TranscriberServiceError extends Error {
     kind;
@@ -59,7 +60,7 @@ export class TranscriberClient {
             });
         }
         catch (err) {
-            throw new TranscriberServiceError(`transcriber service unreachable at ${this.base}: ${err instanceof Error ? err.message : String(err)}`, 'down');
+            throw new TranscriberServiceError(`transcriber service unreachable at ${this.base}: ${errMessage(err)}`, 'down');
         }
         if (res.status === 503)
             throw new TranscriberServiceError('model missing/unavailable', 'model_missing');

package/dist/transcriber_client.js.map

@@ -1 +1 @@
-{"version":3,"file":"transcriber_client.js","sourceRoot":"","sources":["../src/transcriber_client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"transcriber_client.js","sourceRoot":"","sources":["../src/transcriber_client.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@they-juanreina/compost-cli",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Compost CLI engine. Subcommand router, JSON-out, harness loop runner.",
   "type": "module",
   "repository": {
@@ -16,7 +16,14 @@
     "compost": "./bin/compost.js"
   },
   "exports": {
-    ".": "./dist/index.js"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./engine": {
+      "types": "./dist/engine.d.ts",
+      "default": "./dist/engine.js"
+    }
   },
   "files": [
     "bin",
@@ -32,9 +39,9 @@
     "chokidar": "^4.0.0",
     "commander": "^12.1.0",
     "smol-toml": "^1.3.0",
-    "@they-juanreina/compost-evals": "0.1.2",
-    "@they-juanreina/compost-provenance": "0.1.2",
-    "@they-juanreina/compost-retrieval": "0.1.2"
+    "@they-juanreina/compost-retrieval": "0.1.4",
+    "@they-juanreina/compost-provenance": "0.1.4",
+    "@they-juanreina/compost-evals": "0.1.4"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.11",

package/templates/AGENTS.md

@@ -2,7 +2,7 @@
 
 This is the versioned prompt journal for this seed. Compost reads this file when invoking LLM tasks (synthesis, coding, query, chat) and prepends its contents to system prompts. Treat it like a `CLAUDE.md` for your research.
 
-Edit freely. Commit changes to version-control alongside the rest of the seed.
+Edit freely — this is the human-authored file in the otherwise machine-owned `.compost/`. Compost versions it automatically (a timestamped section is appended on each save). `.compost/` is hidden and gitignored by default, so to preserve or move this seed, copy the whole folder (including `.compost/`) — or run `compost backup` to export its provenance.
 
 ## Voice & style
 

package/templates/config.toml

@@ -38,9 +38,14 @@ include_drafts = "marked"
 [evals]
 storage = "sqlite"
 
-# LLM providers. Add API keys via env vars; compost reads `api_key_env`.
+# LLM providers. `api_key_env` is the NAME of an environment variable, never the
+# key itself — compost reads the value from the environment (or, transparently,
+# from the OS keychain / ~/.compost/secrets.env via `compost secrets set`).
+# NEVER paste a raw key here: this file lives in the (shared) seed. See
+# SECURITY.md → "Storing your tokens".
 [providers.ollama]
 base_url = "http://localhost:11434"
+# timeout_ms = 300000  # uncomment for very large local models (slow first load)
 
 [providers.lmstudio]
 base_url = "http://localhost:1234/v1"

package/transcriber/app/diarization.py

@@ -8,6 +8,7 @@ and gating low-confidence sessions — is pure and fully unit-tested.
 
 from __future__ import annotations
 
+import re
 from dataclasses import dataclass
 from functools import lru_cache
 from typing import Any, Protocol
@@ -129,6 +130,23 @@ def _load_pyannote(token_present: bool) -> DiarizationBackend:  # pragma: no cov
     return PyannoteBackend()
 
 
+_PYANNOTE_LABEL_RE = re.compile(r"^SPEAKER_(\d+)$")
+
+
+def normalize_speaker_label(label: str) -> str:
+    """Canonicalize a diarization speaker label to the schema's ``^S[0-9]+$`` form.
+
+    pyannote emits cluster labels like ``SPEAKER_00`` / ``SPEAKER_01``; the
+    transcript schema (schema/transcript.schema.json $defs.speaker.id and
+    $defs.utterance.speaker_id) requires ``S{n}`` — e.g. ``S0``, ``S1``. Leading
+    zeros are dropped (``SPEAKER_00`` → ``S0``). Already-canonical labels
+    (``S1``) and the ``S?`` orphan sentinel pass through unchanged, so this is
+    idempotent and safe to apply at the single write point in ``align()``.
+    """
+    m = _PYANNOTE_LABEL_RE.match(label)
+    return f"S{int(m.group(1))}" if m else label
+
+
 def _overlap_ms(a_start: int, a_end: int, b_start: int, b_end: int) -> int:
     return max(0, min(a_end, b_end) - max(a_start, b_start))
 
@@ -220,11 +238,20 @@ def assign_speaker(utterance: dict[str, Any], turns: list[Turn]) -> tuple[str, f
     return winner[0], min(winner[1] / u_dur, 1.0)
 
 
-def detect_overlaps(turns: list[Turn], min_overlap_ms: int = 200) -> list[dict[str, Any]]:
-    """Find regions where two turns overlap; emit `overlap` cues."""
+def detect_overlaps(
+    turns: list[Turn], min_overlap_ms: int = 200, start_index: int = 1
+) -> list[dict[str, Any]]:
+    """Find regions where two turns overlap; emit `overlap` cues.
+
+    Cue ids use the schema's uniform ``CUE-[0-9]{3,}`` space (the cue ``kind``
+    already distinguishes overlap cues from ASR-tag cues, so a typed ``CUE-OV-``
+    prefix would both duplicate that and violate the id pattern). ``start_index``
+    lets the caller continue numbering past any cues already in cues[] so the
+    overlap and tag-derived cues share one collision-free id sequence.
+    """
     cues: list[dict[str, Any]] = []
     ordered = sorted(turns, key=lambda t: t.start_ms)
-    idx = 1
+    idx = start_index
     for i in range(len(ordered)):
         for j in range(i + 1, len(ordered)):
             a, b = ordered[i], ordered[j]
@@ -237,7 +264,7 @@ def detect_overlaps(turns: list[Turn], min_overlap_ms: int = 200) -> list[dict[s
             if ov_end - ov_start >= min_overlap_ms:
                 cues.append(
                     {
-                        "id": f"CUE-OV-{idx:03d}",
+                        "id": f"CUE-{idx:03d}",
                         "kind": "overlap",
                         "start_ms": ov_start,
                         "end_ms": ov_end,
@@ -267,12 +294,15 @@ def align(transcript: dict[str, Any], turns: list[Turn]) -> dict[str, Any]:
             rescued = _nearest_turn_speaker(utt["start_ms"], utt["end_ms"], turns)
             if rescued is not None:
                 speaker = rescued  # confidence stays 0.0 (fallback marker)
-        utt["speaker_id"] = speaker
+        # Canonicalize pyannote's SPEAKER_NN labels to the schema's S{n} form at
+        # the single write point so speakers[].id (derived from these) and every
+        # utterances[].speaker_id agree with ^S[0-9]+$.
+        utt["speaker_id"] = normalize_speaker_label(speaker)
         utt.setdefault("diarization", {})["confidence"] = round(conf, 3)
         confidences.append(conf)
 
     cues = transcript.setdefault("cues", [])
-    cues.extend(detect_overlaps(turns))
+    cues.extend(detect_overlaps(turns, start_index=len(cues) + 1))
 
     mean_conf = sum(confidences) / len(confidences) if confidences else 0.0
     if mean_conf < DIARIZATION_CONFIDENCE_FLOOR:

package/transcriber/app/legacy_cli.py

@@ -0,0 +1,90 @@
+"""Native (host) legacy-ingest entrypoint (#184).
+
+Mirrors `app.transcribe_cli` for documents: runs the pure ingestors in
+`app.legacy.ingest` in a host Python venv so PDF/DOCX/PPTX/CSV/XLSX/TXT ingest
+works WITHOUT the Docker transcriber (demoted to a fallback). Shares the exact
+write + response shape as the `/legacy-ingest` route so the Node legacy-worker
+treats native and Docker results identically.
+
+Usage:
+    python -m app.legacy_cli --seed-path <seed> --source-path <file> \
+        [--text-col COL] [--speaker-col COL] [--sheet NAME]
+Prints exactly one JSON line; exit 0 on ok/empty, 1 on failure.
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+from pathlib import Path
+
+from .legacy import ingest as ingest_legacy
+
+
+def main(argv: list[str] | None = None) -> int:
+    p = argparse.ArgumentParser(prog="compost-legacy-native")
+    p.add_argument("--seed-path", required=True)
+    p.add_argument("--source-path", required=True)
+    p.add_argument("--text-col", default=None)
+    p.add_argument("--speaker-col", default=None)
+    p.add_argument("--sheet", default=None)
+    args = p.parse_args(argv)
+
+    src = Path(args.source_path)
+    seed = Path(args.seed_path)
+    if not src.exists():
+        print(json.dumps({"status": "failed", "kind": "invalid_input", "error": f"source not found: {src}"}))
+        return 1
+    if not seed.exists():
+        print(json.dumps({"status": "failed", "kind": "invalid_input", "error": f"seed not found: {seed}"}))
+        return 1
+
+    kwargs: dict[str, str] = {}
+    if args.text_col is not None:
+        kwargs["text_col"] = args.text_col
+    if args.speaker_col is not None:
+        kwargs["speaker_col"] = args.speaker_col
+    if args.sheet is not None:
+        kwargs["sheet"] = args.sheet
+
+    try:
+        doc = ingest_legacy(src, **kwargs)
+    except ValueError as e:  # unsupported ext / missing column
+        print(json.dumps({"status": "failed", "kind": "invalid_input", "error": str(e)}))
+        return 1
+    except RuntimeError as e:  # missing optional dep (python-docx, openpyxl, …)
+        print(json.dumps({"status": "failed", "kind": "dep_missing", "error": str(e)}))
+        return 1
+
+    legacy_dir = seed / "legacy"
+    legacy_dir.mkdir(parents=True, exist_ok=True)
+    out_path = legacy_dir / f"{src.stem}.json"
+    out_path.write_text(json.dumps(doc, indent=2, ensure_ascii=False) + "\n", encoding="utf-8")
+
+    utt_count = len(doc.get("utterances", []))
+    prov = doc.get("provenance", {})
+    warnings: list[str] = []
+    skipped = prov.get("xlsx_rows_skipped_empty_text", 0)
+    if skipped > 0:
+        warnings.append(
+            f"{skipped} XLSX row(s) had data in other columns but an empty text cell — "
+            "likely an un-evaluated formula. Open the file in Excel once, or export to CSV."
+        )
+
+    print(
+        json.dumps(
+            {
+                "status": "ok" if utt_count > 0 else "empty",
+                "source_path": str(src),
+                "normalized_path": str(out_path),
+                "utterance_count": utt_count,
+                "text_col_resolved": prov.get("text_col_resolved"),
+                "warnings": warnings,
+            }
+        )
+    )
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/transcriber/app/pipeline.py

@@ -23,7 +23,7 @@ from .cue_parser import parse_transcript_cues
 from .diarization import DiarizationBackend, Diarizer, align
 from .prosody import annotate_prosody
 from .silence_typer import type_all_silences
-from .vad import VAD, VADBackend, silences_to_schema
+from .vad import VAD, VADBackend, silences_to_schema, utterance_energies
 
 SCHEMA_VERSION = "1.0"
 DEFAULT_TRANSCRIBER_VERSION = "compost-transcriber@0.1.0"
@@ -122,9 +122,9 @@ def run_pipeline(
 
     duration_ms = probe_duration_ms(source_path)
 
-    # 1. VAD — speech segments + first-class silences
+    # 1. VAD — speech segments (carry per-segment RMS energy) + first-class silences
     vad = VAD(backend=backends.vad)
-    _, silences = vad.segment(source_path, duration_ms)
+    speech, silences = vad.segment(source_path, duration_ms)
 
     # 2. ASR — utterances with word timings, may contain event tags inline
     asr = Transcriber(config=config.asr, backend=backends.asr)
@@ -145,13 +145,16 @@ def run_pipeline(
         "cues": [],
         "frames": [],
         "glossary_refs": [],
+        # frame_capture / frame_annotation are omitted (not null): the schema
+        # types provenance fields as strings and the convention is "absent when
+        # not applicable". run_pipeline does no frame capture/annotation; those
+        # stages (frames.py / frame_annotation.py) add their own provenance when
+        # they run.
         "provenance": {
             "transcriber": config.transcriber_version,
             "asr_model": config.asr_model_tag,
             "diarizer": config.diarizer_tag,
             "audio_cues": f"{config.vad_tag} + whisper-events",
-            "frame_capture": None,
-            "frame_annotation": None,
         },
     }
 
@@ -169,8 +172,11 @@ def run_pipeline(
     # 7. Silence semantic typing (after_question / thinking / interruption / …)
     type_all_silences(transcript)
 
-    # 8. Prosody hints per utterance (deterministic, cheap)
-    annotate_prosody(transcript)
+    # 8. Prosody hints per utterance (deterministic, cheap). Volume bucketing
+    # needs the per-utterance VAD RMS energy signal mapped from the speech
+    # segments; without it volume would default to "normal" for every utterance.
+    energies = utterance_energies(speech, transcript["utterances"])
+    annotate_prosody(transcript, energies)
 
     return transcript
 

package/transcriber/app/prosody.py

@@ -31,6 +31,11 @@ from typing import Any
 
 PACE_SLOW_WPS = 2.0
 PACE_FAST_WPS = 3.3
+# Volume thresholds applied to the normalized 0..1 energy. These are GLOBAL
+# constants, not per-speaker. The energy signal is session-normalized in
+# vad.utterance_energies(); a soft speaker's loudest moment can still read below
+# a loud speaker's baseline. TODO(#13): per-speaker normalization would make
+# these buckets speaker-relative — see vad.utterance_energies for the plan.
 VOLUME_LOW = 0.33
 VOLUME_HIGH = 0.66
 HESITATION_GAP_MS = 400

package/transcriber/app/transcribe_cli.py

@@ -20,6 +20,7 @@ from __future__ import annotations
 
 import argparse
 import json
+import re
 
 from .asr import ASRConfig
 from .pipeline import PipelineBackends, PipelineConfig, run_pipeline, write_transcript
@@ -29,11 +30,24 @@ _DEFAULT_MODEL = {
     "whisper": "large-v3-turbo",
 }
 
+_SESSION_ID_RE = re.compile(r"^[A-Za-z0-9_-]+$")
+
+
+def _session_id(value: str) -> str:
+    """Validate --session-id is a bare label (mirrors the CLI assertSessionId and
+    the HTTP route's Field pattern). The id is joined into <seed>/sessions/<id>/,
+    so a path separator or `..` would escape the seed when invoked directly."""
+    if not _SESSION_ID_RE.match(value):
+        raise argparse.ArgumentTypeError(
+            f"invalid session id {value!r}: use letters, digits, '-' or '_' only"
+        )
+    return value
+
 
 def main(argv: list[str] | None = None) -> int:
     p = argparse.ArgumentParser(prog="compost-transcribe-native")
     p.add_argument("--seed-path", required=True)
-    p.add_argument("--session-id", required=True)
+    p.add_argument("--session-id", required=True, type=_session_id)
     p.add_argument("--source-path", required=True)
     p.add_argument("--engine", default="parakeet", choices=["parakeet", "whisper"])
     p.add_argument("--model", default=None, help="ASR model id (engine default if omitted)")