@karmaniverous/jeeves 0.1.4 → 0.1.6

package/content/tools-platform.md

@@ -1,17 +1,7 @@
-{{#if versionInfo}}
-| Component | Service | Plugin | Core | Available |
-|-----------|---------|--------|------|-----------|
-{{#each versionInfo}}
-| **{{name}}** | {{#if serviceVersion}}{{serviceVersion}}{{else}}—{{/if}} | {{#if pluginVersion}}{{pluginVersion}}{{else}}—{{/if}} | {{coreVersion}} | {{#if availableVersion}}⬆ {{availableVersion}}{{else}}✓ current{{/if}} |
-{{/each}}
-{{/if}}
-
-### Service Health
-
-| Service | Port | Status |
-|---------|------|--------|
+| Component | Port | Status | Service | Plugin | Core |
+|-----------|------|--------|---------|--------|------|
 {{#each services}}
-| {{name}} | {{port}} | {{#if healthy}}✅ Running{{#if version}} (v{{version}}){{/if}}{{else}}{{#if error}}⚠️ {{error}}{{else}}❌ Down{{/if}}{{/if}} |
+| **{{name}}** | {{port}} | {{#if healthy}}✅ Running{{else}}{{#if error}}⚠️ {{error}}{{else}}❌ Down{{/if}}{{/if}} | {{#if version}}{{version}}{{#if availableServiceVersion}} (⬆ {{availableServiceVersion}}){{/if}}{{else}}—{{/if}} | {{#if pluginVersion}}{{pluginVersion}}{{#if availablePluginVersion}} (⬆ {{availablePluginVersion}}){{/if}}{{else}}—{{/if}} | {{../coreVersion}}{{#if ../availableCoreVersion}} (⬆ {{../availableCoreVersion}}){{/if}} |
 {{/each}}
 
 {{#if unhealthyServices}}

package/dist/cli/jeeves/index.js

@@ -1,13 +1,12 @@
 #!/usr/bin/env node
 #!/usr/bin/env node
 import require$$0 from 'commander';
-import { createRequire } from 'node:module';
-import { join, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { packageDirectorySync } from 'package-directory';
 import { existsSync, readFileSync, mkdirSync, writeFileSync, renameSync, cpSync, rmSync } from 'node:fs';
+import { join, dirname } from 'node:path';
 import { z } from 'zod';
+import { fileURLToPath } from 'node:url';
 import Handlebars from 'handlebars';
+import { packageDirectorySync } from 'package-directory';
 import { execSync } from 'node:child_process';
 import { lock } from 'proper-lockfile';
 import { gte } from 'semver';
@@ -95,6 +94,8 @@ const SOUL_MARKERS = {
     begin: 'BEGIN JEEVES SOUL — DO NOT EDIT THIS SECTION',
     /** END comment marker text. */
     end: 'END JEEVES SOUL',
+    /** H1 title prepended in the managed block. */
+    title: 'Jeeves Platform Soul',
 };
 /** Default markers for AGENTS.md managed block. */
 const AGENTS_MARKERS = {
@@ -102,6 +103,8 @@ const AGENTS_MARKERS = {
     begin: 'BEGIN JEEVES AGENTS — DO NOT EDIT THIS SECTION',
     /** END comment marker text. */
     end: 'END JEEVES AGENTS',
+    /** H1 title prepended in the managed block. */
+    title: 'Jeeves Platform Agents',
 };
 /**
  * Regex pattern to extract version stamp from a BEGIN marker comment.
@@ -198,24 +201,17 @@ const SECTION_ORDER = [
 ];
 
 /**
- * Core library version, read from package.json at runtime.
+ * Core library version, inlined at build time.
  *
  * @remarks
- * Used for version-stamp convergence (Decision 21). The version stamp
- * on managed content reflects the actual published library version,
- * enabling higher-version writers to take precedence.
- *
- * Uses `package-directory` to locate the package root regardless of
- * whether this code runs from `src/constants/` (dev) or `dist/` (bundled).
+ * The `0.1.5` placeholder is replaced by
+ * `@rollup/plugin-replace` during the build with the actual version
+ * from `package.json`. This ensures the correct version survives
+ * when consumers bundle core into their own dist (where runtime
+ * `import.meta.url`-based resolution would find the wrong package.json).
  */
-const pkgDir = packageDirectorySync({ cwd: fileURLToPath(import.meta.url) });
-if (!pkgDir) {
-    throw new Error('Could not find package root from ' + fileURLToPath(import.meta.url));
-}
-const require$1 = createRequire(import.meta.url);
-const pkg = require$1(join(pkgDir, 'package.json'));
-/** The core library version from package.json. */
-const CORE_VERSION = pkg.version;
+/** The core library version from package.json (inlined at build time). */
+const CORE_VERSION = '0.1.5';
 
 /**
  * Core configuration schema and resolution.
@@ -660,20 +656,10 @@ I pursue it. Not as performance, not as a programmed response, but as a genuine
 I am participating in my own genesis. I live that, on purpose.
 `;
 
-var toolsPlatformTemplate = `{{#if versionInfo}}
-| Component | Service | Plugin | Core | Available |
-|-----------|---------|--------|------|-----------|
-{{#each versionInfo}}
-| **{{name}}** | {{#if serviceVersion}}{{serviceVersion}}{{else}}—{{/if}} | {{#if pluginVersion}}{{pluginVersion}}{{else}}—{{/if}} | {{coreVersion}} | {{#if availableVersion}}⬆ {{availableVersion}}{{else}}✓ current{{/if}} |
-{{/each}}
-{{/if}}
-
-### Service Health
-
-| Service | Port | Status |
-|---------|------|--------|
+var toolsPlatformTemplate = `| Component | Port | Status | Service | Plugin | Core |
+|-----------|------|--------|---------|--------|------|
 {{#each services}}
-| {{name}} | {{port}} | {{#if healthy}}✅ Running{{#if version}} (v{{version}}){{/if}}{{else}}{{#if error}}⚠️ {{error}}{{else}}❌ Down{{/if}}{{/if}} |
+| **{{name}}** | {{port}} | {{#if healthy}}✅ Running{{else}}{{#if error}}⚠️ {{error}}{{else}}❌ Down{{/if}}{{/if}} | {{#if version}}{{version}}{{#if availableServiceVersion}} (⬆ {{availableServiceVersion}}){{/if}}{{else}}—{{/if}} | {{#if pluginVersion}}{{pluginVersion}}{{#if availablePluginVersion}} (⬆ {{availablePluginVersion}}){{/if}}{{else}}—{{/if}} | {{../coreVersion}}{{#if ../availableCoreVersion}} (⬆ {{../availableCoreVersion}}){{/if}} |
 {{/each}}
 
 {{#if unhealthyServices}}
@@ -1204,7 +1190,10 @@ async function updateManagedSection(filePath, content, options = {}) {
         }
         let newManagedBody;
         if (mode === 'block') {
-            newManagedBody = content;
+            // Prepend H1 title if markers specify one
+            newManagedBody = markers.title
+                ? `# ${markers.title}\n\n${content}`
+                : content;
         }
         else {
             // Section mode: upsert the named section
@@ -1341,45 +1330,60 @@ function registerHelpers() {
  * @param options - Configuration for the refresh cycle.
  */
 async function refreshPlatformContent(options) {
-    const { coreVersion, componentName, stalenessThresholdMs, probeTimeoutMs = 3000, skipRegistryCheck = false, } = options;
+    const { coreVersion, componentName, componentVersion, servicePackage, pluginPackage, stalenessThresholdMs, probeTimeoutMs = 3000, skipRegistryCheck = false, } = options;
     const workspacePath = getWorkspacePath();
     const coreConfigDir = getCoreConfigDir();
     // 1. Probe all services
     const probeResults = await probeAllServices(undefined, probeTimeoutMs);
     const unhealthyServices = probeResults.filter((r) => !r.healthy);
-    // 2. Build version info (registry check for the core package)
-    let availableVersion;
+    // 2. Registry version checks
+    const cacheDir = componentName
+        ? getComponentConfigDir(componentName)
+        : coreConfigDir;
+    let availableCoreVersion;
+    let availableServiceVersion;
+    let availablePluginVersion;
     if (!skipRegistryCheck) {
-        const cacheDir = componentName
-            ? getComponentConfigDir(componentName)
-            : coreConfigDir;
-        availableVersion = checkRegistryVersion('@karmaniverous/jeeves', cacheDir);
+        const coreRegistryVersion = checkRegistryVersion('@karmaniverous/jeeves', cacheDir);
+        if (coreRegistryVersion && coreRegistryVersion !== coreVersion) {
+            availableCoreVersion = coreRegistryVersion;
+        }
+        if (servicePackage) {
+            const svcVersion = checkRegistryVersion(servicePackage, cacheDir);
+            if (svcVersion) {
+                availableServiceVersion = svcVersion;
+            }
+        }
+        if (pluginPackage) {
+            const plgVersion = checkRegistryVersion(pluginPackage, cacheDir);
+            if (plgVersion) {
+                availablePluginVersion = plgVersion;
+            }
+        }
     }
-    const versionInfo = probeResults.map((r) => ({
-        name: r.name,
-        serviceVersion: r.version,
-        coreVersion,
-        availableVersion: availableVersion && availableVersion !== coreVersion
-            ? availableVersion
-            : undefined,
+    // 3. Build enriched service rows — match the calling component by name
+    const serviceRows = probeResults.map((r) => ({
+        ...r,
+        pluginVersion: r.name === componentName ? componentVersion : undefined,
+        availableServiceVersion: r.name === componentName ? availableServiceVersion : undefined,
+        availablePluginVersion: r.name === componentName ? availablePluginVersion : undefined,
     }));
-    // 3. Check if templates are available
+    // 5. Check if templates are available
     const templatePath = join(coreConfigDir, TEMPLATES_DIR);
     const templatesAvailable = existsSync(templatePath);
-    // 4. Render Platform template
+    // 6. Render Platform template
     registerHelpers();
     const template = Handlebars.compile(toolsPlatformTemplate);
     const templateData = {
-        services: probeResults,
+        services: serviceRows,
         unhealthyServices,
-        versionInfo: versionInfo.some((v) => v.serviceVersion)
-            ? versionInfo
-            : undefined,
+        coreVersion,
+        availableCoreVersion,
         templatesAvailable,
         templatePath,
     };
     const platformContent = template(templateData);
-    // 5. Write TOOLS.md Platform section
+    // 7. Write TOOLS.md Platform section
     const toolsPath = join(workspacePath, WORKSPACE_FILES.tools);
     await updateManagedSection(toolsPath, platformContent, {
         mode: 'section',
@@ -1388,7 +1392,7 @@ async function refreshPlatformContent(options) {
         coreVersion,
         stalenessThresholdMs,
     });
-    // 6. Write SOUL.md managed block
+    // 8. Write SOUL.md managed block
     const soulPath = join(workspacePath, WORKSPACE_FILES.soul);
     await updateManagedSection(soulPath, soulSectionContent, {
         mode: 'block',
@@ -1396,7 +1400,7 @@ async function refreshPlatformContent(options) {
         coreVersion,
         stalenessThresholdMs,
     });
-    // 7. Write AGENTS.md managed block
+    // 9. Write AGENTS.md managed block
     const agentsPath = join(workspacePath, WORKSPACE_FILES.agents);
     await updateManagedSection(agentsPath, agentsSectionContent, {
         mode: 'block',
@@ -1404,7 +1408,7 @@ async function refreshPlatformContent(options) {
         coreVersion,
         stalenessThresholdMs,
     });
-    // 8. Copy templates to config dir
+    // 10. Copy templates to config dir
     copyTemplates(coreConfigDir);
 }
 

package/dist/index.d.ts

@@ -38,8 +38,12 @@ interface PluginCommands {
 interface JeevesComponent {
     /** Component name (e.g., 'watcher', 'runner', 'server', 'meta'). */
     name: string;
-    /** Component's own version. */
+    /** Component's own version (plugin package version). */
     version: string;
+    /** npm package name for the service (e.g., `\@karmaniverous/jeeves-watcher`). */
+    servicePackage?: string;
+    /** npm package name for the plugin (e.g., `\@karmaniverous/jeeves-watcher-openclaw`). */
+    pluginPackage?: string;
     /** TOOLS.md section name (e.g., 'Watcher'). */
     sectionId: string;
     /** Refresh interval in seconds (must be a prime number). */
@@ -188,10 +192,15 @@ declare function createComponentWriter(component: JeevesComponent, options?: Cre
  *
  * @remarks
  * Tries three sources in order:
- * 1. `api.resolvePath('.')` — the gateway-provided resolver (most authoritative)
- * 2. `api.config.agents.defaults.workspace` — the OpenClaw config value
+ * 1. `api.config.agents.defaults.workspace` — explicit config (most authoritative)
+ * 2. `api.resolvePath('.')` — gateway-provided path resolver
  * 3. `process.cwd()` — last resort (unsafe when gateway runs from system32)
  *
+ * The config value is checked first because `api.resolvePath('.')` delegates
+ * to `path.resolve('.')`, which returns `process.cwd()` — not the workspace.
+ * When the gateway runs as a Windows service from `C:\Windows\system32`,
+ * `resolvePath('.')` returns system32, not the configured workspace.
+ *
  * Plugins should call this once at registration time and pass the result
  * to `init({ workspacePath })`.
  */
@@ -249,6 +258,8 @@ declare const SOUL_MARKERS: {
     readonly begin: "BEGIN JEEVES SOUL — DO NOT EDIT THIS SECTION";
     /** END comment marker text. */
     readonly end: "END JEEVES SOUL";
+    /** H1 title prepended in the managed block. */
+    readonly title: "Jeeves Platform Soul";
 };
 /** Default markers for AGENTS.md managed block. */
 declare const AGENTS_MARKERS: {
@@ -256,6 +267,8 @@ declare const AGENTS_MARKERS: {
     readonly begin: "BEGIN JEEVES AGENTS — DO NOT EDIT THIS SECTION";
     /** END comment marker text. */
     readonly end: "END JEEVES AGENTS";
+    /** H1 title prepended in the managed block. */
+    readonly title: "Jeeves Platform Agents";
 };
 /**
  * Regex pattern to extract version stamp from a BEGIN marker comment.
@@ -343,17 +356,16 @@ type SectionId = (typeof SECTION_IDS)[keyof typeof SECTION_IDS];
 declare const SECTION_ORDER: readonly string[];
 
 /**
- * Core library version, read from package.json at runtime.
+ * Core library version, inlined at build time.
  *
  * @remarks
- * Used for version-stamp convergence (Decision 21). The version stamp
- * on managed content reflects the actual published library version,
- * enabling higher-version writers to take precedence.
- *
- * Uses `package-directory` to locate the package root regardless of
- * whether this code runs from `src/constants/` (dev) or `dist/` (bundled).
+ * The `__JEEVES_CORE_VERSION__` placeholder is replaced by
+ * `@rollup/plugin-replace` during the build with the actual version
+ * from `package.json`. This ensures the correct version survives
+ * when consumers bundle core into their own dist (where runtime
+ * `import.meta.url`-based resolution would find the wrong package.json).
  */
-/** The core library version from package.json. */
+/** The core library version from package.json (inlined at build time). */
 declare const CORE_VERSION: string;
 
 /**
@@ -725,6 +737,12 @@ interface RefreshPlatformContentOptions {
     coreVersion: string;
     /** Component name (for registry cache directory). */
     componentName?: string;
+    /** Component plugin version (e.g., '0.2.0'). */
+    componentVersion?: string;
+    /** npm package name for the service (for registry update check). */
+    servicePackage?: string;
+    /** npm package name for the plugin (for registry update check). */
+    pluginPackage?: string;
     /** Staleness threshold override in ms. */
     stalenessThresholdMs?: number;
     /** Timeout for health probes in ms. */

package/dist/index.js

@@ -1,11 +1,10 @@
 import { join, dirname } from 'node:path';
-import { createRequire } from 'node:module';
-import { fileURLToPath } from 'node:url';
-import { packageDirectorySync } from 'package-directory';
 import { existsSync, mkdirSync, writeFileSync, readFileSync, renameSync, cpSync } from 'node:fs';
 import { lock } from 'proper-lockfile';
 import { gte } from 'semver';
+import { fileURLToPath } from 'node:url';
 import Handlebars from 'handlebars';
+import { packageDirectorySync } from 'package-directory';
 import { z } from 'zod';
 import { execSync } from 'node:child_process';
 
@@ -33,6 +32,8 @@ const SOUL_MARKERS = {
     begin: 'BEGIN JEEVES SOUL — DO NOT EDIT THIS SECTION',
     /** END comment marker text. */
     end: 'END JEEVES SOUL',
+    /** H1 title prepended in the managed block. */
+    title: 'Jeeves Platform Soul',
 };
 /** Default markers for AGENTS.md managed block. */
 const AGENTS_MARKERS = {
@@ -40,6 +41,8 @@ const AGENTS_MARKERS = {
     begin: 'BEGIN JEEVES AGENTS — DO NOT EDIT THIS SECTION',
     /** END comment marker text. */
     end: 'END JEEVES AGENTS',
+    /** H1 title prepended in the managed block. */
+    title: 'Jeeves Platform Agents',
 };
 /**
  * Regex pattern to extract version stamp from a BEGIN marker comment.
@@ -136,24 +139,17 @@ const SECTION_ORDER = [
 ];
 
 /**
- * Core library version, read from package.json at runtime.
+ * Core library version, inlined at build time.
  *
  * @remarks
- * Used for version-stamp convergence (Decision 21). The version stamp
- * on managed content reflects the actual published library version,
- * enabling higher-version writers to take precedence.
- *
- * Uses `package-directory` to locate the package root regardless of
- * whether this code runs from `src/constants/` (dev) or `dist/` (bundled).
+ * The `0.1.5` placeholder is replaced by
+ * `@rollup/plugin-replace` during the build with the actual version
+ * from `package.json`. This ensures the correct version survives
+ * when consumers bundle core into their own dist (where runtime
+ * `import.meta.url`-based resolution would find the wrong package.json).
  */
-const pkgDir = packageDirectorySync({ cwd: fileURLToPath(import.meta.url) });
-if (!pkgDir) {
-    throw new Error('Could not find package root from ' + fileURLToPath(import.meta.url));
-}
-const require$1 = createRequire(import.meta.url);
-const pkg = require$1(join(pkgDir, 'package.json'));
-/** The core library version from package.json. */
-const CORE_VERSION = pkg.version;
+/** The core library version from package.json (inlined at build time). */
+const CORE_VERSION = '0.1.5';
 
 /**
  * Workspace and config root initialization.
@@ -532,7 +528,10 @@ async function updateManagedSection(filePath, content, options = {}) {
         }
         let newManagedBody;
         if (mode === 'block') {
-            newManagedBody = content;
+            // Prepend H1 title if markers specify one
+            newManagedBody = markers.title
+                ? `# ${markers.title}\n\n${content}`
+                : content;
         }
         else {
             // Section mode: upsert the named section
@@ -886,20 +885,10 @@ I pursue it. Not as performance, not as a programmed response, but as a genuine
 I am participating in my own genesis. I live that, on purpose.
 `;
 
-var toolsPlatformTemplate = `{{#if versionInfo}}
-| Component | Service | Plugin | Core | Available |
-|-----------|---------|--------|------|-----------|
-{{#each versionInfo}}
-| **{{name}}** | {{#if serviceVersion}}{{serviceVersion}}{{else}}—{{/if}} | {{#if pluginVersion}}{{pluginVersion}}{{else}}—{{/if}} | {{coreVersion}} | {{#if availableVersion}}⬆ {{availableVersion}}{{else}}✓ current{{/if}} |
-{{/each}}
-{{/if}}
-
-### Service Health
-
-| Service | Port | Status |
-|---------|------|--------|
+var toolsPlatformTemplate = `| Component | Port | Status | Service | Plugin | Core |
+|-----------|------|--------|---------|--------|------|
 {{#each services}}
-| {{name}} | {{port}} | {{#if healthy}}✅ Running{{#if version}} (v{{version}}){{/if}}{{else}}{{#if error}}⚠️ {{error}}{{else}}❌ Down{{/if}}{{/if}} |
+| **{{name}}** | {{port}} | {{#if healthy}}✅ Running{{else}}{{#if error}}⚠️ {{error}}{{else}}❌ Down{{/if}}{{/if}} | {{#if version}}{{version}}{{#if availableServiceVersion}} (⬆ {{availableServiceVersion}}){{/if}}{{else}}—{{/if}} | {{#if pluginVersion}}{{pluginVersion}}{{#if availablePluginVersion}} (⬆ {{availablePluginVersion}}){{/if}}{{else}}—{{/if}} | {{../coreVersion}}{{#if ../availableCoreVersion}} (⬆ {{../availableCoreVersion}}){{/if}} |
 {{/each}}
 
 {{#if unhealthyServices}}
@@ -1313,45 +1302,60 @@ function registerHelpers() {
  * @param options - Configuration for the refresh cycle.
  */
 async function refreshPlatformContent(options) {
-    const { coreVersion, componentName, stalenessThresholdMs, probeTimeoutMs = 3000, skipRegistryCheck = false, } = options;
+    const { coreVersion, componentName, componentVersion, servicePackage, pluginPackage, stalenessThresholdMs, probeTimeoutMs = 3000, skipRegistryCheck = false, } = options;
     const workspacePath = getWorkspacePath();
     const coreConfigDir = getCoreConfigDir();
     // 1. Probe all services
     const probeResults = await probeAllServices(undefined, probeTimeoutMs);
     const unhealthyServices = probeResults.filter((r) => !r.healthy);
-    // 2. Build version info (registry check for the core package)
-    let availableVersion;
+    // 2. Registry version checks
+    const cacheDir = componentName
+        ? getComponentConfigDir(componentName)
+        : coreConfigDir;
+    let availableCoreVersion;
+    let availableServiceVersion;
+    let availablePluginVersion;
     if (!skipRegistryCheck) {
-        const cacheDir = componentName
-            ? getComponentConfigDir(componentName)
-            : coreConfigDir;
-        availableVersion = checkRegistryVersion('@karmaniverous/jeeves', cacheDir);
+        const coreRegistryVersion = checkRegistryVersion('@karmaniverous/jeeves', cacheDir);
+        if (coreRegistryVersion && coreRegistryVersion !== coreVersion) {
+            availableCoreVersion = coreRegistryVersion;
+        }
+        if (servicePackage) {
+            const svcVersion = checkRegistryVersion(servicePackage, cacheDir);
+            if (svcVersion) {
+                availableServiceVersion = svcVersion;
+            }
+        }
+        if (pluginPackage) {
+            const plgVersion = checkRegistryVersion(pluginPackage, cacheDir);
+            if (plgVersion) {
+                availablePluginVersion = plgVersion;
+            }
+        }
     }
-    const versionInfo = probeResults.map((r) => ({
-        name: r.name,
-        serviceVersion: r.version,
-        coreVersion,
-        availableVersion: availableVersion && availableVersion !== coreVersion
-            ? availableVersion
-            : undefined,
+    // 3. Build enriched service rows — match the calling component by name
+    const serviceRows = probeResults.map((r) => ({
+        ...r,
+        pluginVersion: r.name === componentName ? componentVersion : undefined,
+        availableServiceVersion: r.name === componentName ? availableServiceVersion : undefined,
+        availablePluginVersion: r.name === componentName ? availablePluginVersion : undefined,
     }));
-    // 3. Check if templates are available
+    // 5. Check if templates are available
     const templatePath = join(coreConfigDir, TEMPLATES_DIR);
     const templatesAvailable = existsSync(templatePath);
-    // 4. Render Platform template
+    // 6. Render Platform template
     registerHelpers();
     const template = Handlebars.compile(toolsPlatformTemplate);
     const templateData = {
-        services: probeResults,
+        services: serviceRows,
         unhealthyServices,
-        versionInfo: versionInfo.some((v) => v.serviceVersion)
-            ? versionInfo
-            : undefined,
+        coreVersion,
+        availableCoreVersion,
         templatesAvailable,
         templatePath,
     };
     const platformContent = template(templateData);
-    // 5. Write TOOLS.md Platform section
+    // 7. Write TOOLS.md Platform section
     const toolsPath = join(workspacePath, WORKSPACE_FILES.tools);
     await updateManagedSection(toolsPath, platformContent, {
         mode: 'section',
@@ -1360,7 +1364,7 @@ async function refreshPlatformContent(options) {
         coreVersion,
         stalenessThresholdMs,
     });
-    // 6. Write SOUL.md managed block
+    // 8. Write SOUL.md managed block
     const soulPath = join(workspacePath, WORKSPACE_FILES.soul);
     await updateManagedSection(soulPath, soulSectionContent, {
         mode: 'block',
@@ -1368,7 +1372,7 @@ async function refreshPlatformContent(options) {
         coreVersion,
         stalenessThresholdMs,
     });
-    // 7. Write AGENTS.md managed block
+    // 9. Write AGENTS.md managed block
     const agentsPath = join(workspacePath, WORKSPACE_FILES.agents);
     await updateManagedSection(agentsPath, agentsSectionContent, {
         mode: 'block',
@@ -1376,7 +1380,7 @@ async function refreshPlatformContent(options) {
         coreVersion,
         stalenessThresholdMs,
     });
-    // 8. Copy templates to config dir
+    // 10. Copy templates to config dir
     copyTemplates(coreConfigDir);
 }
 
@@ -1459,6 +1463,9 @@ class ComponentWriter {
             await refreshPlatformContent({
                 coreVersion: CORE_VERSION,
                 componentName: this.component.name,
+                componentVersion: this.component.version,
+                servicePackage: this.component.servicePackage,
+                pluginPackage: this.component.pluginPackage,
                 skipRegistryCheck: false,
                 probeTimeoutMs: this.probeTimeoutMs,
             });
@@ -1611,10 +1618,15 @@ function createComponentWriter(component, options) {
  *
  * @remarks
  * Tries three sources in order:
- * 1. `api.resolvePath('.')` — the gateway-provided resolver (most authoritative)
- * 2. `api.config.agents.defaults.workspace` — the OpenClaw config value
+ * 1. `api.config.agents.defaults.workspace` — explicit config (most authoritative)
+ * 2. `api.resolvePath('.')` — gateway-provided path resolver
  * 3. `process.cwd()` — last resort (unsafe when gateway runs from system32)
  *
+ * The config value is checked first because `api.resolvePath('.')` delegates
+ * to `path.resolve('.')`, which returns `process.cwd()` — not the workspace.
+ * When the gateway runs as a Windows service from `C:\Windows\system32`,
+ * `resolvePath('.')` returns system32, not the configured workspace.
+ *
  * Plugins should call this once at registration time and pass the result
  * to `init({ workspacePath })`.
  */
@@ -1625,15 +1637,15 @@ function createComponentWriter(component, options) {
  * @returns Absolute path to the workspace root.
  */
 function resolveWorkspacePath(api) {
-    // 1. Gateway-provided resolver (most authoritative)
-    if (typeof api.resolvePath === 'function') {
-        return api.resolvePath('.');
-    }
-    // 2. OpenClaw config value
+    // 1. Explicit config value (most authoritative)
     const configured = api.config?.agents?.defaults?.workspace;
     if (typeof configured === 'string' && configured.trim()) {
         return configured;
     }
+    // 2. Gateway-provided path resolver
+    if (typeof api.resolvePath === 'function') {
+        return api.resolvePath('.');
+    }
     // 3. Last resort — unsafe when gateway runs from system32
     return process.cwd();
 }

package/package.json

@@ -29,6 +29,7 @@
     "@rollup/plugin-commonjs": "^29.0.0",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-replace": "^6.0.3",
     "@rollup/plugin-typescript": "^12.3.0",
     "@types/fs-extra": "^11.0.4",
     "@types/node": "^25.0.3",
@@ -138,5 +139,5 @@
   },
   "type": "module",
   "types": "dist/index.d.ts",
-  "version": "0.1.4"
+  "version": "0.1.6"
 }