Skip to content

Architecture-quality audit notes from hermescheck #30

@huangrichao2020

Description

@huangrichao2020

Hi maintainers — this is not a security report, just a friendly architecture-quality audit note from hermescheck, a repo scanner for AI agent/runtime systems.

I ran a narrow runtime-oriented pass against gitagent, and three implementation-level themes looked worth sharing:

  1. Plugin loading may be fragile on Windows. In src/plugins.ts, the programmatic plugin path is built with join(pluginDir, manifest.entry) and passed directly into import(...). On POSIX this often works, but on Windows ESM loading usually wants pathToFileURL(entryPath).href, otherwise absolute filesystem paths can fail or behave inconsistently.
  2. One-shot schedules appear to rely on a raw setTimeout(delay) path in src/schedule-runner.ts. For far-future runAt timestamps, Node timer limits can overflow or clamp long delays, which can make "run once later" jobs fire incorrectly. Routing large delays through a clamp/chunk helper would make the once-scheduler more durable.
  3. Continuation looks strong on memory + summary + recent transcript replay in src/context.ts, but I could not find a shared resume contract that also rechecks durable workspace/runtime side effects before continuing. After an interrupted run or reconnect, that can make the agent remember the conversation while still missing whether the underlying work actually landed.

This may be noisy or already planned, so please feel free to close if it is not useful. If helpful, I can rerun with an even tighter runtime-only scope and share a smaller evidence slice.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions