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
2 changes: 1 addition & 1 deletion .github/workflows/deploy-pages.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/journal-integrity.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion SECURITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:

Expand Down
2 changes: 1 addition & 1 deletion data/AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Agent guide — data/

All journal content lives here, namespaced `data/<type>/<source>/`. 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).
2 changes: 1 addition & 1 deletion data/video/activeinferenceinstitute/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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).
2 changes: 1 addition & 1 deletion docs/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`.
Expand Down
2 changes: 1 addition & 1 deletion docs/PIPELINE.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
4 changes: 2 additions & 2 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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/<source>/`, `data/<type>/<source>/`), 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
Expand All @@ -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
Expand Down
Loading