Hermes Journal Writer
Journal Writer — reads research-collector data from the swamp catalog and writes org-mode journal entries to ~/org/journal/. Commits and pushes to the org repo so entries become part of your living knowledge store.
Methods
- write_daily_entry — Writes a daily research summary to ~/org/journal/YYYY-MM-DD-dow.org with property drawer, source links, and summaries from HN, Lobste.rs, SRE Weekly, IFIN, and RedMonk.
2026.10.14.1
Added: The manifest now declares license: Apache-2.0 (SPDX). The registry quality rubric scores a declared license separately from the bundled LICENSE.md.
Upgrade note: Metadata only. No code, schema, or behavioral changes.
2026.09.18.1
Upgrade note: Normalized npm:zod dependency version to 4.6.5 across the
repo. No behavioral changes in this extension.
Global Arguments
| Argument | Type | Description |
|---|---|---|
| orgDir? | string | Root directory of the org repo (supports ~ expansion) |
| jrnlSubdir? | string | Subdirectory under orgDir for journal entries |
| swampBin? | string | Path to the swamp binary (must be on PATH or specify full path) |
| repoDir? | string | Path to the swamp repo directory |
| gitUserName? | string | Git commit user name |
| gitUserEmail? | string | Git commit user email |
| sources? | array | Which sources to include in the journal entry. Omit a source name to disable it. |
Resources
2026.09.18.1
Upgrade note: Normalized npm:zod dependency version to 4.6.5 across the
repo. No behavioral changes in this extension.
2026.09.15.1
Changed: Bump zod 4.4.3 → 4.6.5
2026.08.28.1
Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.
Upgrade note: License text only. No API, schema, or runtime behavior changed.
2026.08.26.3
Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry
quality scorer can resolve dependencies and score the extension. An earlier
release used a bare "zod" import-map specifier, which published but scored as
unscored.
Changed: Retained explicit compilerOptions.strict in deno.json. No
behavioral or schema changes.
2026.08.28.1
Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.
Upgrade note: License text only. No API, schema, or runtime behavior changed.
2026.08.26.3
Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry
quality scorer can resolve dependencies and score the extension. An earlier
release used a bare "zod" import-map specifier, which published but scored as
unscored.
Changed: Retained explicit compilerOptions.strict in deno.json. No
behavioral or schema changes.
2026.08.26.3
Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry
quality scorer can resolve dependencies and score the extension. An earlier
release used a bare "zod" import-map specifier, which published but scored as
unscored.
Changed: Retained explicit compilerOptions.strict in deno.json. No
behavioral or schema changes.
2026.08.26.1
Fixed: Added missing description field to upgrade entry for version
2026.08.24.2. The omission caused swamp extension pull to fail with a catalog
validation error ("upgrades.N.description: Invalid input: expected string,
received undefined").
2026.08.24.3
Added: Output metadata attributes for observability.
durationMs: Method execution duration in milliseconds.collectedBy: Extension name that produced the data.fetchedAt: ISO 8601 timestamp when data was fetched (added to resources that previously lacked it).
2026.08.24.2
Added Troubleshooting section documenting the idempotent file-exists guard, skipped-no-data status, git push/commit failure degrade paths, default arg mismatches with README, and source output slicing limits.
2026.08.21.1
Changed: Added .describe() documentation to the previously undocumented journalEntry
resource schema fields (date, file, status, createdAt). No behavioral change — a no-op
upgrades entry was added to keep the model's typeVersion tracking in sync with the version
bump.
2026.08.01.1
Fixed: Broken model-upgrade chain. The prior version bump (to 2026.07.27.1) updated version but left the upgrades array terminating one step short, which blocks swamp extension push ("model upgrade chain errors"). That version never actually published — the registry was still serving 2026.07.20.1. This release closes the chain with a no-op upgrade entry and republishes everything that had accumulated since 2026.07.20.1.
2026.07.27.1
Changed: Reformatted files that had drifted from deno fmt. No code
behavior changes.
Upgrade note: Tooling and formatting only. No model, method, schema, or behavior change — nothing to do on upgrade.
Use named thematic buckets for Signals to Noise analysis.
Filter HTML entities and generic feed artifacts from Signals to Noise.
Add Signals to Noise analysis as the first journal section.
Add Swamp Club to generated org-mode journal entries.
Add System Design to generated org-mode journal entries.
Add Latent.Space to generated org-mode journal entries.
Update existing daily org files instead of skipping them; preserve manual sections.
Include Simon Willison's Weblog in org-mode journal entries.
2026.08.01.1
Fixed: Broken model-upgrade chain. The prior version bump (to 2026.07.27.1) updated version but left the upgrades array terminating one step short, which blocks swamp extension push ("model upgrade chain errors"). That version never actually published — the registry was still serving 2026.07.20.1. This release closes the chain with a no-op upgrade entry and republishes everything that had accumulated since 2026.07.20.1.
2026.07.27.1
Changed: Reformatted files that had drifted from deno fmt. No code
behavior changes.
Upgrade note: Tooling and formatting only. No model, method, schema, or behavior change — nothing to do on upgrade.
Render The AI Daily Brief editions in daily org entries: new aiDailyBrief source (on by default) adds an edition section with date, title, tags, thesis, URL, and written takeaways. Upgrade backfills aiDailyBrief onto existing instances' sources list.
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License2/2earned
- Verified public repository2/2earned