diff --git a/.github/workflows/deploy-pages.yml b/.github/workflows/deploy-pages.yml index fec0bfc25..a76d8fb21 100644 --- a/.github/workflows/deploy-pages.yml +++ b/.github/workflows/deploy-pages.yml @@ -28,7 +28,7 @@ jobs: - name: Check out Journal-Utilities uses: actions/checkout@v4 with: - repository: ActiveInferenceInstitute/Journal-Utilities + repository: ActiveInferenceInstitute/Journal_Utilities path: utilities - name: Install uv diff --git a/.github/workflows/journal-integrity.yml b/.github/workflows/journal-integrity.yml index ff9882772..d808e0a5d 100644 --- a/.github/workflows/journal-integrity.yml +++ b/.github/workflows/journal-integrity.yml @@ -18,7 +18,7 @@ jobs: - name: Check out Journal-Utilities uses: actions/checkout@v6 with: - repository: ActiveInferenceInstitute/Journal-Utilities + repository: ActiveInferenceInstitute/Journal_Utilities path: .journal-utilities fetch-depth: 1 diff --git a/AGENTS.md b/AGENTS.md index 1b7d52c77..66bb8ac50 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -15,7 +15,7 @@ curated materials from the Active Inference Institute video library. Read ## Rules for agents - This repo is **generated** by - [Journal-Utilities](https://github.com/ActiveInferenceInstitute/Journal-Utilities) + [Journal-Utilities](https://github.com/ActiveInferenceInstitute/Journal_Utilities) (`scripts/refactor_journal.py`, `scripts/download_channel.py`). Prefer changing the generator over hand-editing derived files (`metadata.json`, `transcript.txt`, `INDEX.*`); hand edits are overwritten on the next run. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 8001fdac9..aef05191f 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -10,7 +10,7 @@ before contributing. ## What lives here vs. in Journal-Utilities This repo holds the *content*. The *code* that generates and validates it lives in the -separate [Journal-Utilities](https://github.com/ActiveInferenceInstitute/Journal-Utilities) +separate [Journal-Utilities](https://github.com/ActiveInferenceInstitute/Journal_Utilities) repository. - **Hand-editable here:** `docs/` (schema, organization, pipeline), root and structural diff --git a/README.md b/README.md index 82a70d9ec..304764c48 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ video library. [![Journal integrity](https://github.com/ActiveInferenceInstitute/ActiveInferenceJournal/actions/workflows/journal-integrity.yml/badge.svg)](https://github.com/ActiveInferenceInstitute/ActiveInferenceJournal/actions/workflows/journal-integrity.yml) Learn more: https://activeinference.institute/learning/ · -Tooling: https://github.com/ActiveInferenceInstitute/Journal-Utilities +Tooling: https://github.com/ActiveInferenceInstitute/Journal_Utilities ## Layout @@ -51,7 +51,7 @@ is represented (uncategorized videos live under `Other/`). Transcripts and metadata are pulled completely and idempotently from the Institute YouTube channel by -[Journal-Utilities](https://github.com/ActiveInferenceInstitute/Journal-Utilities). +[Journal-Utilities](https://github.com/ActiveInferenceInstitute/Journal_Utilities). Most transcripts are WhisperX-diarized: `transcript.json` holds the immutable raw segments (`SPEAKER_NN`), human speaker identifications are recorded in `metadata.json` `parts[].speakers`, and `transcript.txt` is regenerated from the diff --git a/SECURITY.md b/SECURITY.md index ad0ef68c9..d9cf2d1f0 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -19,7 +19,7 @@ but the repository has a hard rule about credentials — see the security note i ## Reporting This repository is generated and validated by the -[Journal-Utilities](https://github.com/ActiveInferenceInstitute/Journal-Utilities) +[Journal-Utilities](https://github.com/ActiveInferenceInstitute/Journal_Utilities) pipeline. If you discover a credential, a leaked internal path, or any other security issue: diff --git a/data/AGENTS.md b/data/AGENTS.md index 874f73ae5..a18206cd9 100644 --- a/data/AGENTS.md +++ b/data/AGENTS.md @@ -1,6 +1,6 @@ # Agent guide — data/ All journal content lives here, namespaced `data///`. Generated by -[Journal-Utilities](https://github.com/ActiveInferenceInstitute/Journal-Utilities) — prefer +[Journal-Utilities](https://github.com/ActiveInferenceInstitute/Journal_Utilities) — prefer changing the generator over hand-editing. Schema: [`../docs/SCHEMA.md`](../docs/SCHEMA.md). Layout: [`../docs/ORGANIZATION.md`](../docs/ORGANIZATION.md). Entry point: [`../INDEX.json`](../INDEX.json). diff --git a/data/video/activeinferenceinstitute/AGENTS.md b/data/video/activeinferenceinstitute/AGENTS.md index 25d7a1a23..fd0d5ed1a 100644 --- a/data/video/activeinferenceinstitute/AGENTS.md +++ b/data/video/activeinferenceinstitute/AGENTS.md @@ -4,6 +4,6 @@ One **series** folder per stream type (`GuestStream`, `Roundtable`, `Courses`, and `Other` for uncategorized). Each **item** folder is one event with `metadata.json` (parts = video ids), `transcript.txt/.json`, `captions/`, `translations/`, `assets/`, `README.md`. Generated by -[Journal-Utilities](https://github.com/ActiveInferenceInstitute/Journal-Utilities); +[Journal-Utilities](https://github.com/ActiveInferenceInstitute/Journal_Utilities); `metadata.json` is the per-item source of truth. Schema: [`../../../docs/SCHEMA.md`](../../../docs/SCHEMA.md). diff --git a/docs/AGENTS.md b/docs/AGENTS.md index 2f21a94d9..4e54d7625 100644 --- a/docs/AGENTS.md +++ b/docs/AGENTS.md @@ -6,7 +6,7 @@ Technical documentation for ActiveInferenceJournal. Start at [`README.md`](READM - This folder is **hand-written technical docs**, not generated. Edit prose freely; keep it accurate to the actual layout and the - [Journal-Utilities](https://github.com/ActiveInferenceInstitute/Journal-Utilities) + [Journal-Utilities](https://github.com/ActiveInferenceInstitute/Journal_Utilities) generators. - The **schema of record** is [`SCHEMA.md`](SCHEMA.md). If the per-item structure changes, update it here and mirror it in Journal-Utilities `docs/JOURNAL_SCHEMA.md`. diff --git a/docs/PIPELINE.md b/docs/PIPELINE.md index 810159b3b..e79237b7d 100644 --- a/docs/PIPELINE.md +++ b/docs/PIPELINE.md @@ -1,7 +1,7 @@ # Pipeline & provenance This repository is **generated and maintained** by the -[Journal-Utilities](https://github.com/ActiveInferenceInstitute/Journal-Utilities) engine. +[Journal-Utilities](https://github.com/ActiveInferenceInstitute/Journal_Utilities) engine. The journal holds the *content*; Journal-Utilities holds the *code* that produces it. ## End to end diff --git a/docs/README.md b/docs/README.md index 6cb2de701..8599e5064 100644 --- a/docs/README.md +++ b/docs/README.md @@ -10,7 +10,7 @@ materials from the Active Inference Institute video library. | --- | --- | | [`SCHEMA.md`](SCHEMA.md) | Canonical per-item schema (`metadata.json`, `transcript.*`, `captions/`, `translations/`, `assets/`) and the `INDEX.json` contract. | | [`ORGANIZATION.md`](ORGANIZATION.md) | The top-level namespace (`data/video//`, `data///`), how series and items are organized, and how to add other channels / non-video sources. | -| [`PIPELINE.md`](PIPELINE.md) | How content is produced and kept complete + idempotent — the collaboration with the [Journal-Utilities](https://github.com/ActiveInferenceInstitute/Journal-Utilities) engine. | +| [`PIPELINE.md`](PIPELINE.md) | How content is produced and kept complete + idempotent — the collaboration with the [Journal-Utilities](https://github.com/ActiveInferenceInstitute/Journal_Utilities) engine. | | [`AGENTS.md`](AGENTS.md) | Conventions for AI agents and programs operating on this repo. | ## Quick orientation @@ -23,7 +23,7 @@ materials from the Active Inference Institute video library. [`../CITATION.cff`](../CITATION.cff) (Zenodo citation), [`../TO-DO.md`](../TO-DO.md) (scoped improvement list). - **Tooling (separate repo):** - [Journal-Utilities](https://github.com/ActiveInferenceInstitute/Journal-Utilities) + [Journal-Utilities](https://github.com/ActiveInferenceInstitute/Journal_Utilities) produces this layout; its `scripts/refactor_journal.py` and `scripts/download_channel.py` are the canonical generators. Its `scripts/validate_journal.py` is the read-only integrity gate. See Journal-Utilities `docs/JOURNAL_SCHEMA.md` and