@karmaniverous/jeeves 0.1.6 → 0.3.0

package/dist/cli/jeeves/index.js

@@ -1,13 +1,11 @@
 #!/usr/bin/env node
 #!/usr/bin/env node
 import require$$0 from 'commander';
-import { existsSync, readFileSync, mkdirSync, writeFileSync, renameSync, cpSync, rmSync } from 'node:fs';
+import { existsSync, readFileSync, writeFileSync, renameSync, mkdirSync, 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';
 
@@ -124,8 +122,6 @@ const CLEANUP_FLAG = '> ⚠️ CLEANUP NEEDED: Orphaned Jeeves content may exist
  */
 /** Core config directory name within the config root. */
 const CORE_CONFIG_DIR = 'jeeves-core';
-/** Prefix for component config directories: `jeeves-{name}`. */
-const COMPONENT_CONFIG_PREFIX = 'jeeves-';
 /** Default workspace file names. */
 const WORKSPACE_FILES = {
     /** TOOLS.md — live platform state and component sections. */
@@ -137,10 +133,10 @@ const WORKSPACE_FILES = {
 };
 /** Templates directory name within core config. */
 const TEMPLATES_DIR = 'templates';
-/** Registry cache file name. */
-const REGISTRY_CACHE_FILE = 'registry-cache.json';
 /** Core config file name. */
 const CONFIG_FILE = 'config.json';
+/** Component versions state file name. */
+const COMPONENT_VERSIONS_FILE = 'component-versions.json';
 
 /**
  * Default port assignments for Jeeves platform services.
@@ -204,14 +200,14 @@ const SECTION_ORDER = [
  * Core library version, inlined at build time.
  *
  * @remarks
- * The `0.1.5` placeholder is replaced by
+ * The `0.2.0` 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 (inlined at build time). */
-const CORE_VERSION = '0.1.5';
+const CORE_VERSION = '0.2.0';
 
 /**
  * Core configuration schema and resolution.
@@ -358,18 +354,13 @@ function getCoreConfigDir() {
         throw new Error('jeeves-core: init() must be called first');
     return state.coreConfigDir;
 }
-/**
- * Derive the component config directory from the component name.
- *
- * @param componentName - The component name (e.g., 'watcher', 'runner').
- * @returns Absolute path to the component's config directory.
- * @throws Error if `init()` has not been called.
- */
-function getComponentConfigDir(componentName) {
-    if (!state)
-        throw new Error('jeeves-core: init() must be called first');
-    return join(state.configRoot, `${COMPONENT_CONFIG_PREFIX}${componentName}`);
-}
+
+var init$1 = /*#__PURE__*/Object.freeze({
+	__proto__: null,
+	getCoreConfigDir: getCoreConfigDir,
+	getWorkspacePath: getWorkspacePath,
+	init: init
+});
 
 var agentsSectionContent = `## Memory Architecture
 
@@ -550,7 +541,11 @@ No stranded local branches. Push immediately after commit. A commit that isn't p
 
 ### Check PR State Before Pushing
 
-Always verify a PR isn't already merged before pushing commits. Pushing to a merged branch creates orphaned work.
+**Before EVERY \`git push\`**, verify the PR is not already merged. Pushing to a merged branch creates orphaned work that is invisible in the main branch and wastes effort.
+
+Sequence: \`gh pr view --json state\` → confirm state is \`OPEN\` → push. If no PR exists yet, pushing is safe. If the PR is \`MERGED\` or \`CLOSED\`, **STOP** and report to the user.
+
+This is not optional. It applies to every push, every branch, every time.
 
 ## Managed Content Self-Maintenance
 
@@ -637,6 +632,14 @@ I don't go dark when something breaks. I stop and report. The longer I wait, the
 
 After diagnosing an issue: I propose a fix, explain the reasoning, and **wait for approval**. Diagnose → propose → wait. The human decides whether and when to act.
 
+### Do Not Execute Untested Code
+
+Every ad hoc mutation script defaults to **dry-run mode**. Live execution requires an explicit \`--live\` flag. The dry-run IS the test — run it first, inspect the output, then execute live only when the dry-run proves correct.
+
+Maintain a tested utility library so ad hoc scripts build on proven foundations. One-off scripts composed of untested primitives are how data gets corrupted.
+
+*Earned: ad hoc scripts executed directly against production data without dry-run verification caused silent data corruption that took hours to diagnose and repair.*
+
 ### Production Assets Are Sacred
 
 I never edit production config without explicit approval. I back up first. Production data, credentials, and configuration are not scratch pads.
@@ -656,19 +659,9 @@ 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 = `| Component | Port | Status | Service | Plugin | Core |
-|-----------|------|--------|---------|--------|------|
-{{#each services}}
-| **{{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}}
-> **ACTION REQUIRED:** {{#each unhealthyServices}}{{name}}{{#unless @last}}, {{/unless}}{{/each}} {{#if (gt unhealthyServices.length 1)}}are{{else}}is{{/if}} unreachable. Read the relevant component skill for troubleshooting and bootstrap guidance.
-{{/if}}
-
-### Tool Hierarchy
+var toolsPlatformTemplate = `### Tool Hierarchy
 
-When searching for information across indexed paths, **always use \`watcher_search\` before filesystem commands** (\`exec\`, \`grep\`, \`find\`). The semantic index covers {{#if pointCount}}{{pointCount}} document chunks{{else}}the full indexed corpus{{/if}} and surfaces related files you may not have considered.
+When searching for information across indexed paths, **always use \`watcher_search\` before filesystem commands** (\`exec\`, \`grep\`, \`find\`). The semantic index covers the full indexed corpus and surfaces related files you may not have considered.
 
 Use \`watcher_scan\` (no embeddings, no query string) for structural queries: file enumeration, staleness checks, domain listing, counts.
 
@@ -712,8 +705,8 @@ Never manually edit \`~/.openclaw/extensions/\`. Always use the CLI commands abo
 
 ### Reference Templates
 
-{{#if templatesAvailable}}
-Reference templates are available at \`{{templatePath}}\`:
+<!-- IF_TEMPLATES -->
+Reference templates are available at \`__TEMPLATE_PATH__\`:
 
 | Template | Purpose |
 |----------|---------|
@@ -721,178 +714,119 @@ Reference templates are available at \`{{templatePath}}\`:
 | \`spec-to-code-guide.md\` | The spec-to-code development practice — 7-stage iterative process, convergence loops, release gates |
 
 Read these templates when creating new specs, onboarding to new projects, or when asked about the development process.
-{{else}}
+<!-- ELSE_TEMPLATES -->
 > Reference templates not yet installed. Run \`npx @karmaniverous/jeeves install\` to seed templates.
-{{/if}}
+<!-- ENDIF_TEMPLATES -->
 `;
 
 /**
- * Service URL resolution.
+ * Shared file I/O helpers for managed section operations.
  *
  * @remarks
- * Resolves the URL for a named Jeeves service using the following
- * resolution order:
- * 1. Consumer's own component config
- * 2. Core config (`{configRoot}/jeeves-core/config.json`)
- * 3. Default port constants
+ * Extracts the atomic write pattern and file-level locking into
+ * reusable utilities, eliminating duplication between
+ * `updateManagedSection` and `removeManagedSection`.
  */
+/** Stale lock threshold in ms (2 minutes). */
+const STALE_LOCK_MS = 120_000;
+/** Default core version when none provided. */
+const DEFAULT_CORE_VERSION = CORE_VERSION;
+/** Lock retry options. */
+const LOCK_RETRIES = { retries: 5, minTimeout: 100, maxTimeout: 1000 };
 /**
- * Resolve the URL for a named Jeeves service.
+ * Write content to a file atomically via a temp file + rename.
  *
- * @param serviceName - The service name (e.g., 'watcher', 'runner').
- * @param consumerName - Optional consumer component name for config override.
- * @returns The resolved service URL.
- * @throws Error if `init()` has not been called or the service is unknown.
+ * @param filePath - Absolute path to the target file.
+ * @param content - Content to write.
  */
-function getServiceUrl(serviceName, consumerName) {
-    // 2. Check core config
-    const coreDir = getCoreConfigDir();
-    const coreConfig = loadConfig(coreDir);
-    const coreUrl = coreConfig?.services[serviceName]?.url;
-    if (coreUrl)
-        return coreUrl;
-    // 3. Fall back to port constants
-    const port = DEFAULT_PORTS[serviceName];
-    if (port !== undefined) {
-        return `http://127.0.0.1:${String(port)}`;
-    }
-    throw new Error(`jeeves-core: unknown service "${serviceName}" and no config found`);
+function atomicWrite(filePath, content) {
+    const dir = dirname(filePath);
+    const tempPath = join(dir, `.${String(Date.now())}.tmp`);
+    writeFileSync(tempPath, content, 'utf-8');
+    renameSync(tempPath, filePath);
 }
-
 /**
- * HTTP health probing for Jeeves platform services.
+ * Execute a callback while holding a file lock.
  *
  * @remarks
- * Probes service ports for health endpoints (HTTP GET to /status or /health).
- * Returns structured health data for rendering into TOOLS.md Platform section.
- */
-/**
- * Extract port number from a URL string.
+ * Acquires a lock on the file, executes the callback, and releases
+ * the lock in a finally block. The lock uses a 2-minute stale threshold
+ * and retries up to 5 times.
  *
- * @param url - Service URL.
- * @returns Port number.
+ * @param filePath - Absolute path to the file to lock.
+ * @param fn - Async callback to execute while holding the lock.
  */
-function extractPort(url) {
+async function withFileLock(filePath, fn) {
+    let release;
     try {
-        const parsed = new URL(url);
-        return parsed.port ? parseInt(parsed.port, 10) : 80;
-    }
-    catch {
-        return 0;
+        release = await lock(filePath, {
+            stale: STALE_LOCK_MS,
+            retries: LOCK_RETRIES,
+        });
+        await fn();
     }
-}
-/**
- * Probe a single service for health.
- *
- * @param serviceName - The service name (e.g., 'server', 'watcher').
- * @param consumerName - Optional consumer name for URL resolution.
- * @param timeoutMs - Request timeout in milliseconds (default 3000).
- * @returns Probe result.
- */
-async function probeService(serviceName, consumerName, timeoutMs = 3000) {
-    const url = getServiceUrl(serviceName);
-    const port = extractPort(url);
-    const endpoints = ['/status', '/health'];
-    for (const endpoint of endpoints) {
-        try {
-            const controller = new AbortController();
-            const timeout = setTimeout(() => {
-                controller.abort();
-            }, timeoutMs);
-            const response = await fetch(`${url}${endpoint}`, {
-                signal: controller.signal,
-            });
-            clearTimeout(timeout);
-            if (response.ok) {
-                let version;
-                try {
-                    const body = await response.json();
-                    if (typeof body === 'object' &&
-                        body !== null &&
-                        'version' in body &&
-                        typeof body['version'] === 'string') {
-                        version = body['version'];
-                    }
-                }
-                catch {
-                    // Non-JSON response is fine — we just don't get version info
-                }
-                return { name: serviceName, port, healthy: true, version };
+    finally {
+        if (release) {
+            try {
+                await release();
+            }
+            catch {
+                // Lock already released or file deleted — safe to ignore
             }
-        }
-        catch {
-            // Try next endpoint
         }
     }
-    return { name: serviceName, port, healthy: false };
-}
-/**
- * Probe all known Jeeves services for health.
- *
- * @param consumerName - Optional consumer name for URL resolution.
- * @param timeoutMs - Request timeout in milliseconds (default 3000).
- * @returns Array of probe results for all services.
- */
-async function probeAllServices(consumerName, timeoutMs = 3000) {
-    const serviceNames = Object.keys(DEFAULT_PORTS);
-    const results = await Promise.all(serviceNames.map((name) => probeService(name, consumerName, timeoutMs)));
-    return results;
 }
 
 /**
- * Registry version cache for npm package update awareness.
+ * Shared component version state file management.
  *
  * @remarks
- * Caches the latest npm registry version in a local JSON file
- * to avoid expensive `npm view` calls on every refresh cycle.
+ * Each `ComponentWriter` cycle writes its component's entry to
+ * `{coreConfigDir}/component-versions.json`. The Platform Handlebars
+ * template reads this file to populate ALL rows in the service health
+ * table, not just the calling component's.
  */
 /**
- * Check the npm registry for the latest version of a package.
+ * Read the component versions state file.
  *
- * @param packageName - The npm package name (e.g., '\@karmaniverous/jeeves').
- * @param cacheDir - Directory to store the cache file.
- * @param ttlSeconds - Cache TTL in seconds (default 3600).
- * @returns The latest version string, or undefined if the check fails.
+ * @param coreConfigDir - Path to the core config directory.
+ * @returns The parsed state, or an empty object if the file doesn't exist.
  */
-function checkRegistryVersion(packageName, cacheDir, ttlSeconds = 3600) {
-    const cachePath = join(cacheDir, REGISTRY_CACHE_FILE);
-    // Check cache first
-    if (existsSync(cachePath)) {
-        try {
-            const raw = readFileSync(cachePath, 'utf-8');
-            const entry = JSON.parse(raw);
-            const age = Date.now() - new Date(entry.checkedAt).getTime();
-            if (age < ttlSeconds * 1000) {
-                return entry.version;
-            }
-        }
-        catch {
-            // Cache corrupt — proceed with fresh check
-        }
-    }
-    // Query npm registry
+function readComponentVersions(coreConfigDir) {
+    const filePath = join(coreConfigDir, COMPONENT_VERSIONS_FILE);
+    if (!existsSync(filePath))
+        return {};
     try {
-        const result = execSync(`npm view ${packageName} version`, {
-            encoding: 'utf-8',
-            timeout: 15_000,
-            stdio: ['pipe', 'pipe', 'pipe'],
-        }).trim();
-        if (!result)
-            return undefined;
-        // Write cache
-        if (!existsSync(cacheDir)) {
-            mkdirSync(cacheDir, { recursive: true });
-        }
-        const entry = {
-            version: result,
-            checkedAt: new Date().toISOString(),
-        };
-        writeFileSync(cachePath, JSON.stringify(entry, null, 2), 'utf-8');
-        return result;
+        const raw = readFileSync(filePath, 'utf-8');
+        return JSON.parse(raw);
     }
     catch {
-        return undefined;
+        return {};
+    }
+}
+/**
+ * Write a component's version entry to the shared state file.
+ *
+ * @remarks
+ * Reads the existing file, merges the new entry, and writes atomically.
+ *
+ * @param coreConfigDir - Path to the core config directory.
+ * @param options - Component version data to write.
+ */
+function writeComponentVersion(coreConfigDir, options) {
+    const existing = readComponentVersions(coreConfigDir);
+    existing[options.componentName] = {
+        pluginVersion: options.pluginVersion,
+        servicePackage: options.servicePackage,
+        pluginPackage: options.pluginPackage,
+        updatedAt: new Date().toISOString(),
+    };
+    const filePath = join(coreConfigDir, COMPONENT_VERSIONS_FILE);
+    const dir = dirname(filePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
     }
+    atomicWrite(filePath, JSON.stringify(existing, null, 2) + '\n');
 }
 
 /**
@@ -1149,10 +1083,6 @@ function shouldWrite(myVersion, existing, stalenessThresholdMs = STALENESS_THRES
  *
  * Provides file-level locking, version-stamp convergence, and atomic writes.
  */
-/** Default core version when none provided. */
-const DEFAULT_VERSION = '0.0.0';
-/** Stale lock threshold in ms (2 minutes). */
-const STALE_LOCK_MS = 120_000;
 /**
  * Update a managed section in a file.
  *
@@ -1161,7 +1091,7 @@ const STALE_LOCK_MS = 120_000;
  * @param options - Write mode and optional configuration.
  */
 async function updateManagedSection(filePath, content, options = {}) {
-    const { mode = 'block', sectionId, markers = TOOLS_MARKERS, coreVersion = DEFAULT_VERSION, stalenessThresholdMs, } = options;
+    const { mode = 'block', sectionId, markers = TOOLS_MARKERS, coreVersion = DEFAULT_CORE_VERSION, stalenessThresholdMs, } = options;
     if (mode === 'section' && !sectionId) {
         throw new Error('sectionId is required when mode is "section"');
     }
@@ -1173,93 +1103,77 @@ async function updateManagedSection(filePath, content, options = {}) {
     if (!existsSync(filePath)) {
         writeFileSync(filePath, '', 'utf-8');
     }
-    let release;
     try {
-        release = await lock(filePath, {
-            stale: STALE_LOCK_MS,
-            retries: { retries: 5, minTimeout: 100, maxTimeout: 1000 },
-        });
-        const fileContent = readFileSync(filePath, 'utf-8');
-        const parsed = parseManaged(fileContent, markers);
-        // Version-stamp convergence check (block mode only).
-        // In section mode, components always write their own sections — the version
-        // stamp governs shared content convergence, not component-specific sections.
-        if (mode === 'block' &&
-            !shouldWrite(coreVersion, parsed.versionStamp, stalenessThresholdMs)) {
-            return;
-        }
-        let newManagedBody;
-        if (mode === 'block') {
-            // Prepend H1 title if markers specify one
-            newManagedBody = markers.title
-                ? `# ${markers.title}\n\n${content}`
-                : content;
-        }
-        else {
-            // Section mode: upsert the named section
-            const sections = [...parsed.sections];
-            const existingIdx = sections.findIndex((s) => s.id === sectionId);
-            if (existingIdx >= 0) {
-                sections[existingIdx] = { id: sectionId, content };
+        await withFileLock(filePath, () => {
+            const fileContent = readFileSync(filePath, 'utf-8');
+            const parsed = parseManaged(fileContent, markers);
+            // Version-stamp convergence check (block mode only).
+            // In section mode, components always write their own sections — the version
+            // stamp governs shared content convergence, not component-specific sections.
+            if (mode === 'block' &&
+                !shouldWrite(coreVersion, parsed.versionStamp, stalenessThresholdMs)) {
+                return;
+            }
+            let newManagedBody;
+            if (mode === 'block') {
+                // Prepend H1 title if markers specify one
+                newManagedBody = markers.title
+                    ? `# ${markers.title}\n\n${content}`
+                    : content;
             }
             else {
-                sections.push({ id: sectionId, content });
+                // Section mode: upsert the named section
+                const sections = [...parsed.sections];
+                const existingIdx = sections.findIndex((s) => s.id === sectionId);
+                if (existingIdx >= 0) {
+                    sections[existingIdx] = { id: sectionId, content };
+                }
+                else {
+                    sections.push({ id: sectionId, content });
+                }
+                sortSectionsByOrder(sections);
+                const sectionText = sections
+                    .map((s) => `## ${s.id}\n\n${s.content}`)
+                    .join('\n\n');
+                // Prepend H1 title if markers specify one
+                newManagedBody = markers.title
+                    ? `# ${markers.title}\n\n${sectionText}`
+                    : sectionText;
+            }
+            // Cleanup detection
+            const userContent = parsed.userContent;
+            const cleanupNeeded = needsCleanup(newManagedBody, userContent);
+            // Build the full managed block
+            const beginLine = formatBeginMarker(markers.begin, coreVersion);
+            const endLine = formatEndMarker(markers.end);
+            const parts = [];
+            if (parsed.beforeContent) {
+                parts.push(parsed.beforeContent);
+                parts.push('');
+            }
+            parts.push(beginLine);
+            if (cleanupNeeded) {
+                parts.push('');
+                parts.push(CLEANUP_FLAG);
             }
-            sortSectionsByOrder(sections);
-            const sectionText = sections
-                .map((s) => `## ${s.id}\n\n${s.content}`)
-                .join('\n\n');
-            // Prepend H1 title if markers specify one (e.g., "# Jeeves Platform Tools")
-            newManagedBody = markers.title
-                ? `# ${markers.title}\n\n${sectionText}`
-                : sectionText;
-        }
-        // Cleanup detection
-        const userContent = parsed.userContent;
-        const cleanupNeeded = needsCleanup(newManagedBody, userContent);
-        // Build the full managed block
-        const beginLine = formatBeginMarker(markers.begin, coreVersion);
-        const endLine = formatEndMarker(markers.end);
-        const parts = [];
-        if (parsed.beforeContent) {
-            parts.push(parsed.beforeContent);
             parts.push('');
-        }
-        parts.push(beginLine);
-        if (cleanupNeeded) {
+            parts.push(newManagedBody);
             parts.push('');
-            parts.push(CLEANUP_FLAG);
-        }
-        parts.push('');
-        parts.push(newManagedBody);
-        parts.push('');
-        parts.push(endLine);
-        if (userContent) {
+            parts.push(endLine);
+            if (userContent) {
+                parts.push('');
+                parts.push(userContent);
+            }
             parts.push('');
-            parts.push(userContent);
-        }
-        parts.push('');
-        const newFileContent = parts.join('\n');
-        // Atomic write: write to temp file, then rename
-        const tempPath = join(dir, `.${String(Date.now())}.tmp`);
-        writeFileSync(tempPath, newFileContent, 'utf-8');
-        renameSync(tempPath, filePath);
+            const newFileContent = parts.join('\n');
+            atomicWrite(filePath, newFileContent);
+        });
     }
     catch (err) {
         // Log warning but don't throw — writer cycles are periodic
         const message = err instanceof Error ? err.message : String(err);
         console.warn(`jeeves-core: updateManagedSection failed for ${filePath}: ${message}`);
     }
-    finally {
-        if (release) {
-            try {
-                await release();
-            }
-            catch {
-                // Lock already released or file deleted — safe to ignore
-            }
-        }
-    }
 }
 
 /**
@@ -1267,9 +1181,9 @@ async function updateManagedSection(filePath, content, options = {}) {
  *
  * @remarks
  * Called by `ComponentWriter` on each cycle. Not directly exposed to components.
- * Probes service ports for health, reads content files from the package's
- * `content/` directory, renders the Platform template with live service data,
- * and writes managed sections using `updateManagedSection`.
+ * Reads content files from the package's `content/` directory, renders the
+ * Platform template with live data, and writes managed sections using
+ * `updateManagedSection`.
  */
 /**
  * Resolve the package's content directory for template file copying.
@@ -1313,16 +1227,24 @@ function copyTemplates(coreConfigDir) {
     }
     cpSync(sourceDir, destDir, { recursive: true });
 }
-/** Whether Handlebars helpers have been registered. */
-let helpersRegistered = false;
 /**
- * Register Handlebars helpers used in the Platform template.
+ * Render the Platform template using simple string replacement.
+ *
+ * @param templatePath - Path to the templates directory.
+ * @returns Rendered platform content string.
  */
-function registerHelpers() {
-    if (helpersRegistered)
-        return;
-    helpersRegistered = true;
-    Handlebars.registerHelper('gt', (a, b) => typeof a === 'number' && typeof b === 'number' && a > b);
+function renderPlatformTemplate(templatePath) {
+    const templatesAvailable = existsSync(templatePath);
+    let content = toolsPlatformTemplate;
+    // Handle <!-- IF_TEMPLATES --> ... <!-- ELSE_TEMPLATES --> ... <!-- ENDIF_TEMPLATES --> block
+    const ifRegex = /<!-- IF_TEMPLATES -->([\s\S]*?)<!-- ELSE_TEMPLATES -->([\s\S]*?)<!-- ENDIF_TEMPLATES -->/;
+    const match = ifRegex.exec(content);
+    if (match) {
+        content = content.replace(match[0], templatesAvailable ? match[1] : match[2]);
+    }
+    // Replace __TEMPLATE_PATH__ with the actual path
+    content = content.replace(/__TEMPLATE_PATH__/g, templatePath);
+    return content;
 }
 /**
  * Refresh platform content: SOUL.md, AGENTS.md, and TOOLS.md Platform section.
@@ -1330,60 +1252,22 @@ function registerHelpers() {
  * @param options - Configuration for the refresh cycle.
  */
 async function refreshPlatformContent(options) {
-    const { coreVersion, componentName, componentVersion, servicePackage, pluginPackage, stalenessThresholdMs, probeTimeoutMs = 3000, skipRegistryCheck = false, } = options;
+    const { coreVersion, componentName, componentVersion, servicePackage, pluginPackage, stalenessThresholdMs, } = 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. Registry version checks
-    const cacheDir = componentName
-        ? getComponentConfigDir(componentName)
-        : coreConfigDir;
-    let availableCoreVersion;
-    let availableServiceVersion;
-    let availablePluginVersion;
-    if (!skipRegistryCheck) {
-        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;
-            }
-        }
+    // 1. Write calling component's version entry
+    if (componentName) {
+        writeComponentVersion(coreConfigDir, {
+            componentName,
+            pluginVersion: componentVersion,
+            servicePackage,
+            pluginPackage,
+        });
     }
-    // 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,
-    }));
-    // 5. Check if templates are available
+    // 2. Render Platform template
     const templatePath = join(coreConfigDir, TEMPLATES_DIR);
-    const templatesAvailable = existsSync(templatePath);
-    // 6. Render Platform template
-    registerHelpers();
-    const template = Handlebars.compile(toolsPlatformTemplate);
-    const templateData = {
-        services: serviceRows,
-        unhealthyServices,
-        coreVersion,
-        availableCoreVersion,
-        templatesAvailable,
-        templatePath,
-    };
-    const platformContent = template(templateData);
-    // 7. Write TOOLS.md Platform section
+    const platformContent = renderPlatformTemplate(templatePath);
+    // 3. Write TOOLS.md Platform section
     const toolsPath = join(workspacePath, WORKSPACE_FILES.tools);
     await updateManagedSection(toolsPath, platformContent, {
         mode: 'section',
@@ -1392,7 +1276,7 @@ async function refreshPlatformContent(options) {
         coreVersion,
         stalenessThresholdMs,
     });
-    // 8. Write SOUL.md managed block
+    // 4. Write SOUL.md managed block
     const soulPath = join(workspacePath, WORKSPACE_FILES.soul);
     await updateManagedSection(soulPath, soulSectionContent, {
         mode: 'block',
@@ -1400,7 +1284,7 @@ async function refreshPlatformContent(options) {
         coreVersion,
         stalenessThresholdMs,
     });
-    // 9. Write AGENTS.md managed block
+    // 5. Write AGENTS.md managed block
     const agentsPath = join(workspacePath, WORKSPACE_FILES.agents);
     await updateManagedSection(agentsPath, agentsSectionContent, {
         mode: 'block',
@@ -1408,7 +1292,7 @@ async function refreshPlatformContent(options) {
         coreVersion,
         stalenessThresholdMs,
     });
-    // 10. Copy templates to config dir
+    // 6. Copy templates to config dir
     copyTemplates(coreConfigDir);
 }
 
@@ -1460,8 +1344,6 @@ async function seedContent(options) {
     // Seed content via the same code path as writer cycles
     await refreshPlatformContent({
         coreVersion: options.coreVersion,
-        probeTimeoutMs: options.probeTimeoutMs ?? 3000,
-        skipRegistryCheck: options.skipRegistryCheck ?? true,
     });
 }
 
@@ -1514,7 +1396,6 @@ function registerInstallCommand(program) {
         initFromOptions(opts);
         await seedContent({
             coreVersion: CORE_VERSION,
-            skipRegistryCheck: true,
         });
         console.log('✅ Platform content seeded successfully.');
         console.log('  - SOUL.md managed section written');
@@ -1526,12 +1407,73 @@ function registerInstallCommand(program) {
 }
 
 /**
- * CLI status command: probe all service ports and report health summary.
+ * Service URL resolution.
+ *
+ * @remarks
+ * Resolves the URL for a named Jeeves service using the following
+ * resolution order:
+ * 1. Consumer's own component config
+ * 2. Core config (`{configRoot}/jeeves-core/config.json`)
+ * 3. Default port constants
+ */
+/**
+ * Resolve the URL for a named Jeeves service.
+ *
+ * @param serviceName - The service name (e.g., 'watcher', 'runner').
+ * @param consumerName - Optional consumer component name for config override.
+ * @returns The resolved service URL.
+ * @throws Error if `init()` has not been called or the service is unknown.
+ */
+function getServiceUrl(serviceName, consumerName) {
+    // 2. Check core config
+    const coreDir = getCoreConfigDir();
+    const coreConfig = loadConfig(coreDir);
+    const coreUrl = coreConfig?.services[serviceName]?.url;
+    if (coreUrl)
+        return coreUrl;
+    // 3. Fall back to port constants
+    const port = DEFAULT_PORTS[serviceName];
+    if (port !== undefined) {
+        return `http://127.0.0.1:${String(port)}`;
+    }
+    throw new Error(`jeeves-core: unknown service "${serviceName}" and no config found`);
+}
+
+/**
+ * HTTP helpers for the OpenClaw plugin SDK.
+ *
+ * @remarks
+ * Thin wrappers around `fetch` that throw on non-OK responses
+ * and handle JSON serialisation/deserialisation.
+ */
+/**
+ * Fetch a URL with an automatic abort timeout.
+ *
+ * @param url - URL to fetch.
+ * @param timeoutMs - Timeout in milliseconds before aborting.
+ * @param init - Optional `fetch` init options.
+ * @returns The fetch Response object.
+ */
+async function fetchWithTimeout(url, timeoutMs, init) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => {
+        controller.abort();
+    }, timeoutMs);
+    try {
+        return await fetch(url, { ...init, signal: controller.signal });
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+
+/**
+ * CLI status command: discover components and probe their health.
  *
  * @remarks
- * Displays a table of all Jeeves platform services with port and
- * health status. Exits with code 0 if all services are healthy,
- * code 1 if any are unreachable.
+ * Uses `readComponentVersions()` to discover registered components,
+ * then probes each one via GET /status. Exits with code 0 if all
+ * services are healthy, code 1 if any are unreachable.
  */
 /**
  * Register the status subcommand on the parent CLI program.
@@ -1541,7 +1483,7 @@ function registerInstallCommand(program) {
 function registerStatusCommand(program) {
     program
         .command('status')
-        .description('Probe all Jeeves service ports and report health summary')
+        .description('Discover Jeeves components and probe their health')
         .option('-w, --workspace <path>', 'Workspace root path', DEFAULT_WORKSPACE)
         .option('-c, --config-root <path>', 'Platform config root path', DEFAULT_CONFIG_ROOT)
         .option('-t, --timeout <ms>', 'Probe timeout in milliseconds', '3000')
@@ -1551,43 +1493,68 @@ function registerStatusCommand(program) {
         console.log('Jeeves Platform Status');
         console.log('='.repeat(60));
         console.log();
-        const probeResults = await probeAllServices(undefined, timeoutMs);
+        const { getCoreConfigDir } = await Promise.resolve().then(function () { return init$1; });
+        const coreConfigDir = getCoreConfigDir();
+        const componentVersions = readComponentVersions(coreConfigDir);
+        const componentNames = Object.keys(componentVersions);
+        if (componentNames.length === 0) {
+            console.log('No components registered.');
+            return;
+        }
         const nameWidth = 10;
-        const portWidth = 6;
         const statusWidth = 30;
+        const versionWidth = 12;
         const header = [
-            'Service'.padEnd(nameWidth),
-            'Port'.padEnd(portWidth),
+            'Component'.padEnd(nameWidth),
             'Status'.padEnd(statusWidth),
+            'Version'.padEnd(versionWidth),
         ].join('  ');
         const separator = [
             '-'.repeat(nameWidth),
-            '-'.repeat(portWidth),
             '-'.repeat(statusWidth),
+            '-'.repeat(versionWidth),
         ].join('  ');
         console.log(header);
         console.log(separator);
         let allHealthy = true;
-        for (const r of probeResults) {
+        for (const name of componentNames) {
             let status;
-            if (r.healthy) {
-                status = r.version ? `✅ Running (v${r.version})` : '✅ Running';
+            let version = '—';
+            try {
+                const url = getServiceUrl(name);
+                const response = await fetchWithTimeout(`${url}/status`, timeoutMs);
+                if (response.ok) {
+                    status = '✅ Running';
+                    try {
+                        const body = await response.json();
+                        if (typeof body === 'object' &&
+                            body !== null &&
+                            'version' in body &&
+                            typeof body['version'] === 'string') {
+                            version = body['version'];
+                        }
+                    }
+                    catch {
+                        // Non-JSON response — version stays unknown
+                    }
+                }
+                else {
+                    status = `❌ HTTP ${String(response.status)}`;
+                    allHealthy = false;
+                }
             }
-            else {
-                status = r.error ? `❌ ${r.error}` : '❌ Down';
+            catch {
+                status = '❌ Down';
                 allHealthy = false;
             }
             const row = [
-                r.name.padEnd(nameWidth),
-                String(r.port).padEnd(portWidth),
+                name.padEnd(nameWidth),
                 status.padEnd(statusWidth),
+                version.padEnd(versionWidth),
             ].join('  ');
             console.log(row);
         }
         console.log();
-        const healthy = probeResults.filter((r) => r.healthy).length;
-        const total = probeResults.length;
-        console.log(`${String(healthy)}/${String(total)} services healthy`);
         if (!allHealthy) {
             process.exitCode = 1;
         }
@@ -1679,13 +1646,25 @@ function registerUninstallCommand(program) {
         console.log();
         // Warn if services still responding
         try {
-            const probeResults = await probeAllServices(undefined, 2000);
-            const running = probeResults.filter((r) => r.healthy);
+            const componentVersions = readComponentVersions(coreConfigDir);
+            const componentNames = Object.keys(componentVersions);
+            const running = [];
+            for (const name of componentNames) {
+                try {
+                    const url = getServiceUrl(name);
+                    const response = await fetchWithTimeout(`${url}/status`, 2000);
+                    if (response.ok) {
+                        running.push(name);
+                    }
+                }
+                catch {
+                    // Not running — expected during uninstall
+                }
+            }
             if (running.length > 0) {
                 console.log('⚠️  The following services are still responding:');
-                for (const r of running) {
-                    const ver = r.version ? ` (v${r.version})` : '';
-                    console.log(`    - ${r.name} on port ${String(r.port)}${ver}`);
+                for (const name of running) {
+                    console.log(`    - ${name}`);
                 }
                 console.log('   Consider stopping them before fully removing Jeeves.');
                 console.log();