Skip to main content

Hermes Journal Writer

@webframp/hermes-journal-writerv2026.10.14.1· Apache-2.0(was none)· 17d agoBEHAVIORS
01README

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.
02Release Notes

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.

03Behaviors1
@webframp/hermes-journal-writerv2026.10.14.1hermes-journal-writer/hermes_jrnl_writer.ts

Global Arguments

ArgumentTypeDescription
orgDir?stringRoot directory of the org repo (supports ~ expansion)
jrnlSubdir?stringSubdirectory under orgDir for journal entries
swampBin?stringPath to the swamp binary (must be on PATH or specify full path)
repoDir?stringPath to the swamp repo directory
gitUserName?stringGit commit user name
gitUserEmail?stringGit commit user email
sources?arrayWhich sources to include in the journal entry. Omit a source name to disable it.
fn write_daily_entry()
Write a daily research journal entry to the org repo with commit/push.

Resources

journalEntry(infinite)— Record of a journal entry
04Previous Versions19
2026.09.18.1

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

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

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

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

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

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

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

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.

2026.08.15.1
2026.08.12.8

Use named thematic buckets for Signals to Noise analysis.

2026.08.12.7

Filter HTML entities and generic feed artifacts from Signals to Noise.

2026.08.12.6

Add Signals to Noise analysis as the first journal section.

2026.08.12.5

Add Swamp Club to generated org-mode journal entries.

2026.08.12.4

Add System Design to generated org-mode journal entries.

2026.08.12.3

Add Latent.Space to generated org-mode journal entries.

2026.08.12.2

Update existing daily org files instead of skipping them; preserve manual sections.

2026.08.12.1

Include Simon Willison's Weblog in org-mode journal entries.

2026.08.01.1

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.

2026.07.20.1

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.

05Stats
A
100 / 100
Downloads
40
Archive size
17.0 KB
  • 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
06Platforms
07Labels