alys-akusa 0.1.20 → 0.1.23

package/README.md

@@ -12,6 +12,8 @@ Or run without installing:
 ```bash
 npx alys-akusa prepare ./company-docs
 npx alys-akusa audit ./knowledge-base
+npx alys-akusa media-debug ./call-recordings
+npx alys-akusa media-transcribe-plan ./call-recordings --gcs-input gs://bucket/in --gcs-output gs://bucket/out
 npx alys-akusa simulate-rag ./knowledge-base
 npx alys-akusa improve ./knowledge-base
 npx alys-akusa benchmark ./knowledge-base
@@ -20,8 +22,11 @@ npx alys-akusa finetune-ready ./support-tickets
 ```
 
 Alys turns messy local knowledge into OpenAI fine-tuning JSONL, Anthropic instruction
-records, RAG chunks, QA datasets, eval datasets, embeddings-ready corpora, manifests,
-source lists, and AI readiness reports.
+records, RAG chunks, QA datasets, eval datasets, embeddings-ready corpora, media
+manifests, SHA-256 fingerprints, timestamped and redacted segment rows, dataset
+cards, redaction reviews, and debug reports for transcript-backed audio/video assets,
+Google Speech-to-Text V2 transcription plans, GCS upload manifests, BatchRecognize
+request JSON, VTT/SRT import maps, source lists, and AI readiness reports.
 
 ## What It Does
 
@@ -51,9 +56,13 @@ answer support, grounding, hallucination risk, and regressions.
 
 ## Local Development
 
+Do not publish to npm for normal testing. Use the repo CLI directly first:
+
 ```bash
 pnpm install
 pnpm alys -- audit ./knowledge-base --yes
+pnpm alys -- media-debug ./call-recordings --yes
+pnpm alys -- media-transcribe-plan ./call-recordings --google-project my-gcp-project --gcs-input gs://bucket/alys-media-input --gcs-output gs://bucket/alys-media-output --yes
 pnpm alys -- simulate-rag ./knowledge-base --queries 12 --top-k 5 --yes
 pnpm alys -- improve ./knowledge-base --yes
 pnpm alys -- benchmark ./knowledge-base --queries 16 --top-k 5 --yes
@@ -61,3 +70,28 @@ pnpm alys -- prepare ./docs --profile all --yes
 pnpm alys -- ingest ./knowledge-base --profile rag,embeddings,eval --yes
 pnpm alys -- finetune-ready ./tickets --profile openai,anthropic,qa --yes
 ```
+
+Recommended pre-publish loop:
+
+```bash
+pnpm cli:test
+pnpm cli:smoke:local
+pnpm cli:pack
+```
+
+`pnpm cli:smoke:local` does not call the hosted generation API. It audits the repo
+docs folder and writes disposable artifacts to `./.alys-test`.
+
+Use the API smoke only when you explicitly want to test the live hosted generation
+path with a tiny run:
+
+```bash
+pnpm cli:smoke:api
+```
+
+Only after those pass should you publish:
+
+```bash
+cd apps/cli
+npm publish --access public
+```