@karmaniverous/jeeves
    Preparing search index...

    Changelog

    All notable changes to this project will be documented in this file.

    • [V0-5] fix(plugin): run npm install in extension directory (#103)

    The plugin installer copies dist/, package.json, and openclaw.plugin.json but never ran npm install, leaving extensions without node_modules. Added execSync npm install --omit=dev after file copy step.

    Co-Authored-By: Claude Opus 4.6 noreply@anthropic.com

    • [V0-5] fix(api): accept explicit configPath in createConfigApplyHandler (#104)

    Components using custom --config paths couldn't use config apply because the handler derived a path that didn't exist. Added optional configPath parameter that takes precedence over registered and derived paths.

    Co-Authored-By: Claude Opus 4.6 noreply@anthropic.com

    • Add copilot review instructions
    • [V0-5] fix: reject Windows drive-letter paths on non-Windows platforms (closes #100)

    Co-Authored-By: Claude Opus 4.6 noreply@anthropic.com

    • [V0-5] feat: hoist substituteEnvVars to core (closes #90)

    Co-Authored-By: Claude Opus 4.6 noreply@anthropic.com

    • [V0-5] feat: hoist Slack file download fallback to platform content (closes #93)

    Co-Authored-By: Claude Opus 4.6 noreply@anthropic.com

    • [V0-5] chore: update dependencies
    • [V0-5] fix: validate drive-letter paths before resolve() in initFromOptions (closes #100)
    • [V0-5] test: add substituteEnvVars immutability test
    • [V0-5] chore: update lefthook, fix lint from typescript-eslint 8.60
    • Npm audit fix
    • Migrate changelog to git-cliff (closes #95)
    • Release v0.5.11
    • Bundle generic platform skills in seedContent (#94)
    • Add npm publish safety net (.npmignore + gitignore *.local)
    • Add npm-pack-check CI workflow
    • Move changelog generation to after:bump hook
    • Update major deps (eslint-plugin-simple-import-sort 13, release-it 20, typescript 6)
    • Release v0.5.10

    • [059] [85,86,87,76,79,72] feat: ComponentWriter lifecycle fix, staleness removal, Handlebars migration, content updates, docs

    • Fix ComponentWriter reschedule race by adding explicit stopped flag (#85)

    • Remove flawed memory staleness heuristics (staleDays, extractMostRecentDate) (#86)

    • Migrate content templating from bespoke comment-conditionals to Handlebars (#87)

    • Add handlebars runtime dependency for template rendering

    • Tighten Slack threading rule to prohibit bot-initiated threads (#87)

    • Add Post-Upgrade Maintenance guidance to Platform section (#76)

    • Add Source Code Preference with devRepos config mapping (#79)

    • Add devRepos to workspace core config schema and JSON Schema

    • Update platform-overview.md with HEARTBEAT flows and dual-layer locking (#72)

    • Remove staleness references from documentation and README

    Co-Authored-By: Claude Opus 4.6 noreply@anthropic.com

    • [059] chore: bump version to 0.5.9, update deps, fix lint warnings from updated eslint rules

    • Bump version to 0.5.9

    • Update safe minor/patch dependencies

    • Remove unnecessary type assertions flagged by updated typescript-eslint

    Co-Authored-By: Claude Opus 4.6 noreply@anthropic.com

    • [059] fix: revert version bump (release is owner-controlled)
    • [059] refactor: hoist workspace config load to ComponentWriter cycle (DRY)
    • [059] test: add restart lifecycle and devRepos schema coverage
    • [059] fix: race condition in start() during finishing cycle, remove redundant nullish coalescing
    • Npm audit fix
    • Release v0.5.9
    • [83] fix: resolve config apply path from registered override (#83) and downgrade transient fetch errors to concise warnings (#77)

    Add registerComponentConfigPath/getComponentConfigPath to init state so components can register their actual --config path after startup. configApplyHandler now reads from the registered path when available, falling back to the derived configRoot path.

    Add isTransientError classifier (ECONNRESET, ETIMEDOUT, AbortError, etc.) and use it in createAsyncContentCache default error handler to emit single-line warnings for recoverable network failures while preserving full stack traces for unexpected errors.

    Co-Authored-By: Claude Opus 4.6 noreply@anthropic.com

    • [83] fix: traverse full error cause chain for transient classification
    • Release v0.5.8
    • Condense managed content and rewrite HEARTBEAT alerts
    • Use dynamic budget in HEARTBEAT alert text
    • Release v0.5.7
    • Serialize managed content writer cycle
    • Preserve file lock safety for managed writes
    • Prevent component writer cycle reentry
    • Npm audit fix
    • Release v0.5.6
    • [73] fix: preserve dist/ subdirectory in plugin install layout

    copyDistFiles was copying dist contents flat into the extension root, but package.json (main: dist/index.js) and openclaw.plugin.json (skills: ["dist/skills/..."]) both expect a dist/ subdirectory.

    Change copyDistFiles target from extensionsDir to join(extensionsDir, 'dist') so the installed layout matches the manifest paths.

    Closes #73

    • Release v0.5.5
    • [73] fix: replace distDir param with importMetaUrl in createPluginCli

    createPluginCli now derives the package root internally via packageDirectorySync and appends /dist, instead of trusting callers to compute distDir. This fixes:

    1. Server plugin skill path mismatch (distDir pointed to dist/, flattening the copy and breaking the skill path declared in openclaw.plugin.json)
    2. Three plugins overcopying the entire package root into extensions (README, LICENSE, content/, etc.)

    Also extracts getPackageRoot() as a new exported helper and refactors getPackageVersion() to use it.

    BREAKING CHANGE: CreatePluginCliOptions.distDir replaced by importMetaUrl. All plugin consumers must update their cli.ts.

    Closes #73

    • [73] fix: validate dist directory exists before copying

    Add explicit existence check for distDir before calling copyDistFiles. Provides a clear error message if the plugin hasn't been built, instead of a cryptic ENOENT from readdirSync.

    Addresses review feedback from gemini-code-assist.

    • Npm audit fix
    • Release v0.5.4

    • [0-5] feat: v0.5.2 patch release

    • #66: atomicWrite EPERM retry + ComponentWriter startup jitter

    • #67: remove hourglass instruction from managed AGENTS section

    • #68: plugin installer provenance records (plugins.installs)

    • #69: workspace file size monitoring in HEARTBEAT cycle

    • #70: remove OpenClaw default duplication from managed sections

    • [0-5] fix: complete v0.5.2 spec implementation

    • document workspace file size monitoring in skill content

    • respect declined HEARTBEAT headings for workspace file alerts

    • add unit tests for workspace file health checks

    • [0-5] refactor: SOLID/DRY pass across codebase

    DRY: extract getErrorMessage() utility — replaced 13 duplicate err instanceof Error ? err.message : String(err) patterns DRY: extract escapeForRegex() — replaced 3 duplicate regex escape patterns SRP: extract handleCommandError() in createServiceCli — replaced 5 duplicate error-handling blocks in service management commands

    • [0-5] test: add missing test coverage for utils and workspace health

    • add utils.test.ts: getErrorMessage with Error, subclass, string, number, null, undefined, object

    • validates no trivial tests exist in touched code

    • [0-5] docs: sync docs with v0.5.2 implementation

    • README.md: fix staleDays default (90 → 30, matches WORKSPACE_CONFIG_DEFAULTS)

    • README.md: fix resolveConfigValue signature (positional params, not options object)

    • README.md: add installRecord param and plugins.installs to patchConfig description

    • README.md: clarify loadWorkspaceConfig return behaviour (no warning on missing file)

    • content/skill.md: correct workspace file monitoring threshold — not configurable via jeeves.config.json (heartbeatCycle calls checkWorkspaceFileHealth without passing wsConfig values, so the 80% threshold is a fixed default)

    Co-Authored-By: Claude Sonnet 4.6 noreply@anthropic.com

    • [0-5] fix: address Gemini review feedback on PR #71

    • fix: parseHeartbeat regex now recognizes workspace file headings (AGENTS.md, SOUL.md, etc.) so users can decline alerts

    • fix: atomicWrite temp filenames include target basename + UUID to prevent collision in concurrent writes

    • fix: CRLF-safe orphaned marker cleanup regex in updateManagedSection

    • refactor: patchConfig uses function overloads to enforce installRecord on 'add' mode at the type level

    • test: add heartbeat parser test for workspace file heading recognition

    • Release v0.5.3
    • Integrate memory hygiene into HEARTBEAT cycle (Phase 9)
    • Add .js extension to test import (Gemini review)
    • Fix
    • Update skill with HEARTBEAT memory integration
    • Release v0.5.1
    • Node 22 runtime floor
    • Keep managed blocks stationary and move cleanup warning inside block
    • Escalate cleanup via gateway session spawn
    • Shared workspace config loader and jeeves config command
    • Memory hygiene + deployed jeeves skill (Phase 7)
    • Address Gemini review — cross-contamination and orphaned markers
    • Address Gemini review — remove redundant check, deduplicate escalation
    • Address Gemini review — env guard, absolute paths, warn on bad config, dynamic output
    • Address Gemini review — zero-budget guard, remove redundant replace
    • Use semver.major() for Node version check
    • Extract heartbeat cycle and cleanup scan from ComponentWriter
    • Sync README and guides with v0.5.0 features
    • Remove Phase 5 files accidentally included in Phase 4 PR
    • Release v0.5.0
    • Plugin installer fix + utility hoist + getPackageVersion (#57)
    • Fill test gaps for Phase 1 validation
    • Release v0.4.7
    • [53] fix: call init() before descriptor.run() in start command
    • Release v0.4.6
    • [51] fix: replace spawn recursion with descriptor.run in start command
    • [51] chore: remove temp scripts
    • [51] chore: remove remaining temp scripts
    • Release v0.4.5
    • Clean up temp files on failed atomic write + guard invalid semver in tests
    • Update dependencies
    • Release v0.4.4
    • Config CLI tree and config apply wire format
    • Release v0.4.3
    • Add customMerge hook to createConfigApplyHandler
    • Defensive nullish coalescing in customMerge test mock
    • Release v0.4.2
    • Phase 1 - descriptor schema, status handler, plugin CLI
    • Phase 2 - service manager, config apply handler, writer migration
    • Phase 3 - service CLI factory, plugin toolset factory
    • Phase 4 - unified CLI with dynamic subcommand discovery
    • Increase timeout for discoverComponents tests
    • Address Gemini review comments
    • Remove dead JeevesComponent types and extract shared test helper
    • Add CLI integration tests for createServiceCli
    • Remove temp commit script
    • Release v0.4.1
    • V0.4.0 infrastructure (C2-C6, C8)
    • C3 getBindAddress + C7 getServiceState
    • C9 heading-based HEARTBEAT section writer
    • C10 HEARTBEAT health orchestration
    • C11 CLI writes initial HEARTBEAT + C12 AGENTS content update
    • Proactive session-start bootstrap via AGENTS directive
    • Proactive update alerts in HEARTBEAT
    • Resolve commander ESM import failure in published CLI build (#41) (#41)
    • Export all new v0.4.0 public API from src/index.ts
    • Address Gemini review comments
    • Npm audit fix
    • SOLID/DRY cleanup
    • Orchestrator unit tests (10 cases)
    • Fill coverage gaps
    • Pass all quality gates (lint, knip, typecheck)
    • Release v0.4.0
    • Remove double shebang from CLI entry point
    • Strengthen managed section content for 0.3.1
    • Move ALL_MARKERS to constants/markers.ts as single source of truth
    • Add TSDoc to inline type properties in PluginApi and ToolResult
    • Release v0.3.1

    • [V0-3] feat: implement v0.3.0 dev plan — remove probing, SDK cleanup, content updates

    • Fix DEFAULT_CORE_VERSION to use CORE_VERSION from constants (#32)

    • Remove probing from writer cycle: delete probe.ts, buildServiceRows.ts (#34)

    • Remove health table and unhealthy services block from tools-platform.md

    • Replace Handlebars with simple string replacement, uninstall handlebars

    • Remove probeTimeoutMs from ComponentWriter, createComponentWriter, seedContent

    • Remove serviceVersion from ComponentVersionEntry and WriteComponentVersionOptions

    • Rewrite status command to use readComponentVersions + direct fetch

    • Remove PluginApiLike type alias (v0.3.0 removal)

    • Add resolveOptionalPluginSetting to plugin/resolve.ts with tests

    • Add "Do Not Execute Untested Code" hard gate to soul-section.md

    • Strengthen "Check PR State Before Pushing" rule in agents-section.md

    • Add Spec Hygiene rules to spec.md template

    • Clean up all barrel file exports for deleted items

    Co-Authored-By: Claude Opus 4.6 noreply@anthropic.com

    • [V0-3] fix: remove dead code, replace Handlebars markers with HTML comments

    • [V0-3] chore: remove temp script

    • [V0-3] refactor: SOLID/DRY cleanup — extract fetchWithTimeout, remove deprecated re-export

    • Extract duplicated fetch+AbortController+timeout pattern from statusCommand.ts and uninstallCommand.ts into shared fetchWithTimeout() in plugin/http.ts

    • Remove deprecated component/resolveWorkspacePath.ts re-export (scheduled for v0.3.0)

    • Move resolveWorkspacePath export to plugin barrel in src/index.ts (canonical location)

    • Fix skipped comment numbering (3-6) in refreshPlatformContent.ts

    Co-Authored-By: Claude Opus 4.6 noreply@anthropic.com

    • [V0-3] test: close coverage gaps — fetchWithTimeout, statusCommand, template branches

    Add direct tests for fetchWithTimeout (timeout/abort, signal pass-through, cleanup). Add full statusCommand.test.ts covering healthy, HTTP error, down, no-components, non-JSON body, and mixed-health exit-code paths. Add renderPlatformTemplate IF/ELSE branch assertions to refreshPlatformContent tests. Fix registry test timeout.

    Co-Authored-By: Claude Opus 4.6 noreply@anthropic.com

    • [V0-3] test: remove trivial tests — type-assignability checks, tautological assertions

    • Delete src/plugin/types.test.ts (all 3 tests were pure type-assignability checks)

    • Remove trivial expect(writer).toBeDefined() from createComponentWriter test

    • Remove redundant typeof === 'string' assertion duplicating TS type narrowing

    Co-Authored-By: Claude Opus 4.6 noreply@anthropic.com

    • Release v0.3.0

    • [V0-2] feat: Phase 1 — Plugin SDK types and utilities

    • plugin/types.ts: PluginApi, ToolResult, PluginApiLike (compat alias)

    • plugin/results.ts: ok, fail, connectionFail helpers

    • plugin/http.ts: fetchJson, postJson helpers

    • plugin/resolve.ts: resolveWorkspacePath, resolvePluginSetting

    • plugin/openclawConfig.ts: resolveOpenClawHome, resolveConfigPath, patchConfig

    • Updated component/resolveWorkspacePath.ts to use PluginApi

    • All modules tested with co-located test files

    • [V0-2] feat: Phase 2 — Managed content removal, semver fix, component versions

    • managed/removeManagedSection.ts: remove sections or entire managed blocks

    • Fix semver comparison: use semver.gt() for update arrows

    • component/componentVersions.ts: shared version state file

    • ComponentWriter writes version entries each cycle

    • All modules tested with co-located test files

    • [V0-2] feat: Phase 3 — Config query handler with JSONPath support

    • api/configQuery.ts: createConfigQueryHandler with JSONPath filtering

    • Added jsonpath-plus dependency

    • All modules tested with co-located test files

    • Updated index.ts exports for all new modules

    • [V0-2] fix: patch tools.alsoAllow, read component versions in platform refresh, consolidate resolveWorkspacePath

    Fix 1: patchConfig now patches tools.alsoAllow instead of tools.allow. Removed plugins.allow patching (not in OpenClaw spec). patchAllowList creates the array when it doesn't exist on add mode.

    Fix 2+3: refreshPlatformContent now writes the calling component's version entry (with serviceVersion from probe) to the shared state file, then reads ALL component versions to populate every service row. Removed separate writeComponentVersion call from ComponentWriter.

    Fix 4: component/resolveWorkspacePath.ts now re-exports from plugin/resolve.ts instead of duplicating the implementation. Test simplified to verify re-export identity.

    • [V0-2] refactor: extract shared fileOps (atomicWrite, withFileLock, constants) from managed section files

    DRY fixes:

    • Extract STALE_LOCK_MS, DEFAULT_CORE_VERSION constants to shared fileOps.ts
    • Extract atomicWrite (temp file + rename) pattern to shared utility
    • Extract withFileLock (lock acquire + try/finally release) pattern
    • Refactor updateManagedSection and removeManagedSection to use shared utilities
    • Refactor componentVersions.writeComponentVersion to use atomicWrite
    • [V0-2] refactor: extract buildServiceRows from refreshPlatformContent

    SRP/DRY fixes:

    • Extract ServiceRow type and buildServiceRows() to dedicated module
    • Extract newerVersion() helper to eliminate duplicated semver check pattern
    • Extract checkCoreUpdate() helper from inline logic
    • Reduce refreshPlatformContent.ts from 305 to 255 lines (under 300 LOC limit)
    • [V0-2] refactor: extract ManagedMarkers interface from inline types
    • [V0-2] test: add 400 error path test for invalid JSONPath in configQuery
    • [V0-2] docs: update README and guides for v0.2.0 Plugin SDK
    • [V0-2] chore: remove stray _push.cjs helper script
    • Npm audit fix
    • Release v0.2.0
    • Inline CORE_VERSION at build time, add H1 titles to SOUL/AGENTS, merge Service Health into Platform table
    • Release v0.1.6
    • Check config workspace before resolvePath (resolvePath returns cwd, not workspace)
    • Release v0.1.5
    • Add resolveWorkspacePath to core (fixes writer writing to system32 when gateway cwd is C:\Windows\system32)
    • Release v0.1.4
    • Inline content files at build time via rollup md plugin (fixes empty managed sections when bundled into consumers)
    • Release v0.1.3
    • Use package-directory for content file resolution (fixes empty managed sections)
    • Release v0.1.2
    • Add async content cache helper for sync generateToolsContent
    • Resolve package.json from dist/ via directory walk (fixes MODULE_NOT_FOUND when consumed as dependency)
    • Use package-directory instead of hand-rolled package.json resolution
    • Release v0.1.1
    • Author content files for Tasks 11-15
    • Core library foundation (Tasks 1-6a, 7-9)
    • Tasks 10, 16-22 — refreshPlatformContent, CLI commands, integration tests
    • Read CORE_VERSION from package.json instead of hardcoding
    • Add DO NOT EDIT to markers, H1 title in section mode, fix tests to use constants
    • Initial commit
    • Revise Genesis section and attribution wording

    Updated the Genesis section and improved the attribution line.

    Reformat poem for clarity and add line breaks.

    • Update README with clearer installation and identity info

    Rephrase installation instructions and improve clarity about Jeeves' identity and functionality.

    • Refactor OpenClaw description for clarity
    • Update documentation links in README.md
    • Updated settings
    • White background instead of transparent
    • Update project title in README with emoji
    • Change header order in README.md
    • Remove historical context from README

    Removed historical context about the 1930s ports from the README.

    • Extract shared CLI defaults to cliDefaults.ts (DRY)
    • Extract sortSectionsByOrder, use CLEANUP_FLAG constant (DRY)
    • Author README, TypeDoc guides, fix all TSDoc warnings
    • Rewrite README - Jeeves bootstraps an identity, not just plumbing
    • First-person SOUL, move operational gates to AGENTS, README storytelling + pronouns + links
    • README rewrite - tell the story, don't sell it
    • Clarify OpenClaw vs Jeeves responsibilities
    • Dynamic files, component onboarding narrative, restore haiku + footer
    • Add PlantUML diagrams, front matter titles, team narrative, remove template diagrams
    • Em-dash discipline - add AGENTS rule, fix misuse across all docs + content
    • Remove trivial constant-assertion tests (ports, sections)
    • Add top-level permissions to docs workflow (fix startup_failure)
    • Release v0.1.0

    Settings

    Member Visibility

    On This Page

    Changelog