@karmaniverous/jeeves 0.4.7 → 0.5.1

package/dist/cli/plugin/index.js

@@ -112,7 +112,13 @@ const WORKSPACE_FILES = {
     agents: 'AGENTS.md',
     /** HEARTBEAT.md — platform status and health alerts. */
     heartbeat: 'HEARTBEAT.md',
+    /** MEMORY.md — curated long-term memory. */
+    memory: 'MEMORY.md',
 };
+/** Skill directory name within workspace. */
+const SKILLS_DIR = 'skills';
+/** Jeeves skill directory name. */
+const JEEVES_SKILL_DIR = 'jeeves';
 /** Component versions state file name. */
 const COMPONENT_VERSIONS_FILE = 'component-versions.json';
 
@@ -120,14 +126,14 @@ const COMPONENT_VERSIONS_FILE = 'component-versions.json';
  * Core library version, inlined at build time.
  *
  * @remarks
- * The `0.4.6` placeholder is replaced by
+ * The `0.5.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.4.6';
+const CORE_VERSION = '0.5.0';
 
 /**
  * Shared file I/O helpers for managed section operations.
@@ -396,7 +402,7 @@ function parseHeartbeat(fileContent) {
     const userContent = fileContent.slice(0, headingIndex).trim();
     const sectionContent = fileContent.slice(headingIndex + HEARTBEAT_HEADING.length);
     const entries = [];
-    const h2Re = /^## (jeeves-\S+?)(?:: declined)?$/gm;
+    const h2Re = /^## (jeeves-\S+?|MEMORY\.md)(?:: declined)?$/gm;
     let match;
     const h2Positions = [];
     while ((match = h2Re.exec(sectionContent)) !== null) {
@@ -708,6 +714,135 @@ function buildWithSections(beforeContent, userContent, sections, markers, coreVe
     return parts.join('\n');
 }
 
+var skillContent = `---
+name: jeeves
+description: Jeeves platform architecture, data flow, component interaction, scripts repo, and coordination knowledge. Use when making architectural decisions, coordinating across components, checking platform health, managing service lifecycle, or working with the scripts repo.
+---
+
+# Jeeves Platform Skill
+
+## Platform Architecture
+
+Jeeves is a four-component platform coordinated by a shared library (\`@karmaniverous/jeeves\`):
+
+| Component | Role | Port |
+|-----------|------|------|
+| **jeeves-runner** | Execute: scheduled jobs, SQLite state, HTTP API | 1937 |
+| **jeeves-watcher** | Index: file→Qdrant semantic indexing, inference rules | 1936 |
+| **jeeves-server** | Present: web UI, file browser, doc render, export | 1934 |
+| **jeeves-meta** | Distill: LLM synthesis, .meta/ directories, scheduling | 1938 |
+
+Core (\`@karmaniverous/jeeves\`) is a **library + CLI**, not a service. No port.
+
+## Data Flow
+
+\`\`\`
+Files → Watcher (index) → Qdrant → Meta (synthesize) → .meta/ → Watcher (re-index)
+                                                                      ↓
+Runner (schedule) → Scripts → Services ← Server (present) ← Browser
+\`\`\`
+
+## Component Interaction
+
+- **Watcher** indexes files into Qdrant with inference rules and enrichments.
+- **Meta** reads from Qdrant, synthesizes \`.meta/\` directories, which watcher re-indexes.
+- **Runner** executes scheduled scripts that may call any service's HTTP API.
+- **Server** presents files, renders documents, and provides the event gateway.
+- **Core** provides shared content management (TOOLS.md, SOUL.md, AGENTS.md), service discovery, config resolution, and the component SDK.
+
+## Service Discovery
+
+Services find each other via config resolution:
+1. Component's own config file (\`{configRoot}/jeeves-{name}/config.json\`)
+2. Core config file (\`{configRoot}/jeeves-core/config.json\`)
+3. Default port constants
+
+## Scripts Repo
+
+Location: \`{configRoot}/jeeves-core/scripts/\`
+Template: \`@karmaniverous/jeeves-scripts-template\`
+
+Scripts use utilities from \`@karmaniverous/jeeves\` (general) and \`@karmaniverous/jeeves-runner\` (runner-specific). Any script that could be useful outside runner scheduling belongs in core.
+
+## Managed Content System
+
+Core maintains managed sections in workspace files using comment markers:
+- **TOOLS.md** — Component sections (section mode) + Platform section
+- **SOUL.md** — Professional discipline and behavioral foundations (block mode)
+- **AGENTS.md** — Operational protocols and memory architecture (block mode)
+- **HEARTBEAT.md** — Platform health status (heading-based)
+
+Managed blocks are stationary after initial insertion. Cleanup detection uses Jaccard similarity on 3-word shingles. Cleanup escalation spawns a gateway session when orphaned content is detected.
+
+## Workspace Configuration
+
+\`jeeves.config.json\` at workspace root provides shared defaults:
+- Precedence: CLI flags → env vars → file → defaults
+- Namespaced: \`core.*\` (workspace, configRoot, gatewayUrl) and \`memory.*\` (budget, warningThreshold, staleDays)
+- Inspect with \`jeeves config [jsonpath]\`
+
+## HEARTBEAT Protocol
+
+The HEARTBEAT system uses a state machine per component:
+\`not_installed → deps_missing → config_missing → service_not_installed → service_stopped → healthy\`
+
+Dependency-aware: hard deps block alerts, soft deps add informational notes. Declined components are tracked via heading suffix.
+
+## Plugin Lifecycle
+
+\`\`\`bash
+# Core install (seed workspace content)
+npx @karmaniverous/jeeves install
+
+# Component plugin install
+npx @karmaniverous/jeeves-{component}-openclaw install
+
+# Component plugin uninstall
+npx @karmaniverous/jeeves-{component}-openclaw uninstall
+
+# Core uninstall (remove managed sections)
+npx @karmaniverous/jeeves uninstall
+\`\`\`
+
+## Memory Hygiene
+
+MEMORY.md has a character budget (default 20,000). Core tracks:
+- Character count and usage percentage
+- Warning at 80% of budget
+- Stale section candidates (H2 sections whose most recent ISO date exceeds the staleness threshold)
+- Evergreen sections (no dates) are never flagged
+
+Review is human/agent-mediated — core does not auto-delete.
+
+### HEARTBEAT Integration
+
+Memory hygiene is checked on every \`ComponentWriter\` cycle alongside component health. When budget or staleness thresholds are breached, a \`## MEMORY.md\` alert appears in HEARTBEAT.md under \`# Jeeves Platform Status\`. The alert includes character count, budget usage percentage, and any stale section names. When memory is healthy, the heading is absent — no alert content, no LLM cost on heartbeat polls.
+
+The \`## MEMORY.md\` heading follows the same declined/active lifecycle as component headings (\`## jeeves-{name}\`). Users can decline memory alerts by changing the heading to \`## MEMORY.md: declined\`.
+`;
+
+/**
+ * Skill seeding: write the `jeeves` workspace skill unconditionally.
+ *
+ * @remarks
+ * The skill file is entirely generated — no user-authored content (Decision 48).
+ * Every installer (core CLI and component plugins) writes it unconditionally.
+ * Content is inlined at build time via `rollup-plugin-md.ts`.
+ */
+/**
+ * Seed the jeeves workspace skill file.
+ *
+ * @param workspacePath - Workspace root directory.
+ */
+function seedSkill(workspacePath) {
+    const skillDir = join(workspacePath, SKILLS_DIR, JEEVES_SKILL_DIR);
+    if (!existsSync(skillDir)) {
+        mkdirSync(skillDir, { recursive: true });
+    }
+    const skillPath = join(skillDir, 'SKILL.md');
+    writeFileSync(skillPath, skillContent, 'utf-8');
+}
+
 /**
  * OpenClaw configuration helpers for plugin CLI installers.
  *
@@ -947,7 +1082,7 @@ function createPluginCli(options) {
         for (const msg of messages) {
             console.log(`  ✓ ${msg}`);
         }
-        // 4. Write initial HEARTBEAT entry
+        // 4. Write initial HEARTBEAT entry and seed jeeves skill
         try {
             const cfgRoot = opts.configRoot;
             const agents = config.agents;
@@ -977,10 +1112,17 @@ function createPluginCli(options) {
                 catch {
                     console.log('  ⚠ Could not write HEARTBEAT entry');
                 }
+                try {
+                    seedSkill(ws);
+                    console.log('  ✓ Jeeves skill seeded');
+                }
+                catch {
+                    console.log('  ⚠ Could not seed Jeeves skill');
+                }
             }
         }
         catch {
-            // HEARTBEAT is best-effort during install
+            // HEARTBEAT + skill seeding are best-effort during install
         }
         // 5. Write component version
         try {

package/dist/cli/service/index.js

@@ -697,17 +697,73 @@ function createServiceManager(descriptor) {
 }
 
 /**
- * Shared CLI defaults and option registration for Jeeves CLI commands.
+ * Workspace-level shared configuration: `jeeves.config.json`.
  *
  * @remarks
- * All three CLI commands (install, uninstall, status) share the same
- * `--workspace` and `--config-root` options with the same defaults.
- * This module centralizes them to eliminate duplication.
+ * Lives at the OpenClaw workspace root alongside TOOLS.md and SOUL.md.
+ * Provides namespaced shared defaults consumed by the root Jeeves CLI.
+ * Resolution precedence: CLI flags → env vars → jeeves.config.json → defaults.
+ *
+ * This does not replace component-owned config schemas (Decision 41).
+ */
+/** Core shared config section. */
+const workspaceCoreConfigSchema = z
+    .object({
+    /** Workspace root path. */
+    workspace: z.string().optional().describe('Workspace root path'),
+    /** Platform config root path. */
+    configRoot: z.string().optional().describe('Platform config root path'),
+    /** OpenClaw gateway URL. */
+    gatewayUrl: z.string().optional().describe('OpenClaw gateway URL'),
+})
+    .partial();
+/** Memory shared config section. */
+const workspaceMemoryConfigSchema = z
+    .object({
+    /** MEMORY.md character budget. */
+    budget: z.number().int().positive().optional().describe('Memory budget'),
+    /** Warning threshold as a fraction of budget. */
+    warningThreshold: z
+        .number()
+        .min(0)
+        .max(1)
+        .optional()
+        .describe('Memory warning threshold'),
+    /** Staleness threshold in days. */
+    staleDays: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe('Memory staleness threshold in days'),
+})
+    .partial();
+/** Workspace config Zod schema. */
+z.object({
+    /** JSON Schema pointer for IDE autocomplete. */
+    $schema: z.string().optional().describe('JSON Schema pointer'),
+    /** Core shared defaults. */
+    core: workspaceCoreConfigSchema.optional(),
+    /** Memory hygiene shared defaults. */
+    memory: workspaceMemoryConfigSchema.optional(),
+});
+/** Built-in workspace config defaults. */
+const WORKSPACE_CONFIG_DEFAULTS = {
+    core: {
+        workspace: '.',
+        configRoot: './config'}};
+
+/**
+ * Shared CLI defaults and resolution for Jeeves CLI commands.
+ *
+ * @remarks
+ * All root CLI commands share workspace/config-root resolution. Values follow
+ * the shared precedence model: flags → env → jeeves.config.json → defaults.
  */
-/** Default workspace path (current directory). */
-const DEFAULT_WORKSPACE = '.';
+/** Default workspace path. */
+const DEFAULT_WORKSPACE = WORKSPACE_CONFIG_DEFAULTS.core.workspace;
 /** Default config root path. */
-const DEFAULT_CONFIG_ROOT = './config';
+const DEFAULT_CONFIG_ROOT = WORKSPACE_CONFIG_DEFAULTS.core.configRoot;
 
 /**
  * Factory for the standard Jeeves service CLI.

package/dist/index.d.ts

@@ -264,6 +264,139 @@ type StatusHandler = () => Promise<StatusHandlerResult>;
  */
 declare function createStatusHandler(options: CreateStatusHandlerOptions): StatusHandler;
 
+/**
+ * Runtime Node.js version floor check.
+ *
+ * @module
+ */
+/**
+ * Check that the running Node.js version meets the minimum requirement.
+ * Prints an error and exits with code 1 if the check fails.
+ */
+declare function checkNodeVersion(): void;
+
+/**
+ * Workspace-level shared configuration: `jeeves.config.json`.
+ *
+ * @remarks
+ * Lives at the OpenClaw workspace root alongside TOOLS.md and SOUL.md.
+ * Provides namespaced shared defaults consumed by the root Jeeves CLI.
+ * Resolution precedence: CLI flags → env vars → jeeves.config.json → defaults.
+ *
+ * This does not replace component-owned config schemas (Decision 41).
+ */
+
+/** Workspace config file name. */
+declare const WORKSPACE_CONFIG_FILE = "jeeves.config.json";
+/** Workspace config Zod schema. */
+declare const workspaceConfigSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    core: z.ZodOptional<z.ZodObject<{
+        workspace: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        configRoot: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        gatewayUrl: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>>;
+    memory: z.ZodOptional<z.ZodObject<{
+        budget: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        warningThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        staleDays: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Workspace config type. */
+type WorkspaceConfig = z.infer<typeof workspaceConfigSchema>;
+/** Built-in workspace config defaults. */
+declare const WORKSPACE_CONFIG_DEFAULTS: {
+    readonly core: {
+        readonly workspace: ".";
+        readonly configRoot: "./config";
+        readonly gatewayUrl: "http://127.0.0.1:3000";
+    };
+    readonly memory: {
+        readonly budget: 20000;
+        readonly warningThreshold: 0.8;
+        readonly staleDays: 30;
+    };
+};
+/** Provenance source for a resolved config value. */
+type ConfigProvenance = 'flag' | 'env' | 'file' | 'default';
+/** A resolved config value with provenance. */
+interface ResolvedValue<T> {
+    /** The resolved value. */
+    value: T;
+    /** Where the value came from. */
+    provenance: ConfigProvenance;
+}
+/**
+ * Load workspace config from `jeeves.config.json` at a given path.
+ *
+ * @param workspacePath - Workspace root directory.
+ * @returns Parsed config or undefined if missing or invalid.
+ */
+declare function loadWorkspaceConfig(workspacePath: string): WorkspaceConfig | undefined;
+/**
+ * Resolve a config value with four-tier precedence.
+ *
+ * @param flagValue - CLI flag value (highest priority).
+ * @param envValue - Environment variable value.
+ * @param fileValue - Value from jeeves.config.json.
+ * @param defaultValue - Built-in default (lowest priority).
+ * @returns The resolved value with provenance annotation.
+ */
+declare function resolveConfigValue<T>(flagValue: T | undefined, envValue: T | undefined, fileValue: T | undefined, defaultValue: T): ResolvedValue<T>;
+/**
+ * Generate a JSON Schema for the workspace config.
+ *
+ * @returns A JSON Schema object.
+ */
+declare function generateWorkspaceJsonSchema(): Record<string, unknown>;
+
+/**
+ * Shared CLI defaults and resolution for Jeeves CLI commands.
+ *
+ * @remarks
+ * All root CLI commands share workspace/config-root resolution. Values follow
+ * the shared precedence model: flags → env → jeeves.config.json → defaults.
+ */
+
+/** Standard workspace options parsed from CLI. */
+interface WorkspaceOptions {
+    /** Workspace root path. */
+    workspace?: string;
+    /** Platform config root path. */
+    configRoot?: string;
+}
+/** Resolved shared CLI config with provenance. */
+interface ResolvedCliConfig {
+    /** Core shared config. */
+    core: {
+        workspace: ResolvedValue<string>;
+        configRoot: ResolvedValue<string>;
+        gatewayUrl: ResolvedValue<string>;
+    };
+    /** Memory shared config. */
+    memory: {
+        budget: ResolvedValue<number>;
+        warningThreshold: ResolvedValue<number>;
+        staleDays: ResolvedValue<number>;
+    };
+}
+
+/**
+ * `jeeves config [jsonpath]` — inspect effective shared CLI configuration.
+ *
+ * @remarks
+ * Shows effective values and provenance using the shared precedence model.
+ * Optional JSONPath filters the resolved config tree.
+ */
+
+/**
+ * Build the effective shared CLI config tree.
+ *
+ * @param opts - Parsed CLI workspace/config-root options.
+ * @returns Effective config tree with provenance on each leaf.
+ */
+declare function buildEffectiveConfig(opts: WorkspaceOptions): ResolvedCliConfig;
+
 /**
  * Factory for the standard `-openclaw` plugin installer CLI.
  *
@@ -405,12 +538,24 @@ declare function removeComponentVersion(coreConfigDir: string, componentName: st
  * at the component's prime-interval, calling `generateToolsContent()`
  * and `refreshPlatformContent()` on each cycle.
  */
+/** Options for ComponentWriter construction. */
+interface ComponentWriterOptions {
+    /**
+     * Gateway URL for cleanup escalation (e.g., 'http://localhost:3000').
+     * When provided, the writer will attempt to spawn a cleanup session
+     * via the gateway when orphaned content is detected.
+     * When omitted, cleanup escalation is silently skipped.
+     */
+    gatewayUrl?: string;
+}
 declare class ComponentWriter {
     private timer;
     private readonly component;
     private readonly configDir;
+    private readonly gatewayUrl;
+    private readonly pendingCleanups;
     /** @internal */
-    constructor(component: JeevesComponentDescriptor);
+    constructor(component: JeevesComponentDescriptor, options?: ComponentWriterOptions);
     /** The component's config directory path. */
     get componentConfigDir(): string;
     /** Whether the writer timer is currently running. */
@@ -428,9 +573,10 @@ declare class ComponentWriter {
      * Execute a single write cycle.
      *
      * @remarks
-     * Calls `generateToolsContent()` and writes the component's
-     * TOOLS.md section via `updateManagedSection()`. Also calls
-     * `refreshPlatformContent()` for shared content maintenance.
+     * 1. Write the component's TOOLS.md section.
+     * 2. Refresh shared platform content (SOUL.md, AGENTS.md, Platform section).
+     * 3. Scan for cleanup flags and escalate if a gateway URL is configured.
+     * 4. Run HEARTBEAT health orchestration.
      */
     cycle(): Promise<void>;
 }
@@ -509,10 +655,11 @@ declare function createAsyncContentCache(options: AsyncContentCacheOptions): ()
  * This replaces the v0.4.0 `createComponentWriter(JeevesComponent)`.
  *
  * @param descriptor - The component descriptor to validate and wrap.
+ * @param options - Optional writer configuration (e.g., gatewayUrl for cleanup escalation).
  * @returns A new `ComponentWriter` instance.
  * @throws ZodError if the descriptor is invalid.
  */
-declare function createComponentWriter(descriptor: JeevesComponentDescriptor): ComponentWriter;
+declare function createComponentWriter(descriptor: JeevesComponentDescriptor, options?: ComponentWriterOptions): ComponentWriter;
 
 /**
  * Heading-based HEARTBEAT section writer.
@@ -666,8 +813,8 @@ declare const AGENTS_MARKERS: ManagedMarkers;
 declare const VERSION_STAMP_PATTERN: RegExp;
 /** Staleness threshold for version-stamp convergence in milliseconds. */
 declare const STALENESS_THRESHOLD_MS: number;
-/** Warning text prepended inside managed block when cleanup is needed. */
-declare const CLEANUP_FLAG = "> \u26A0\uFE0F CLEANUP NEEDED: Orphaned Jeeves content may exist below this managed section. Review everything after the END marker and remove any content that duplicates what appears above.";
+/** Warning text injected inside managed block when cleanup is needed. */
+declare const CLEANUP_FLAG = "> \u26A0\uFE0F CLEANUP NEEDED: Orphaned Jeeves content detected outside this managed block. Review the file and remove any content outside the BEGIN/END markers that duplicates what appears inside them.";
 
 /**
  * Directory and file path conventions for the Jeeves platform.
@@ -686,7 +833,13 @@ declare const WORKSPACE_FILES: {
     readonly agents: "AGENTS.md";
     /** HEARTBEAT.md — platform status and health alerts. */
     readonly heartbeat: "HEARTBEAT.md";
+    /** MEMORY.md — curated long-term memory. */
+    readonly memory: "MEMORY.md";
 };
+/** Skill directory name within workspace. */
+declare const SKILLS_DIR = "skills";
+/** Jeeves skill directory name. */
+declare const JEEVES_SKILL_DIR = "jeeves";
 /** Templates directory name within core config. */
 declare const TEMPLATES_DIR = "templates";
 /** Registry cache file name. */
@@ -1148,6 +1301,82 @@ declare function formatEndMarker(markerText: string): string;
  */
 declare function shouldWrite(myVersion: string, existing: VersionStamp | undefined, stalenessThresholdMs?: number): boolean;
 
+/**
+ * Memory budget accounting and staleness detection for MEMORY.md.
+ *
+ * @remarks
+ * Scans MEMORY.md for ISO date patterns in H2/H3 headings and bullet items.
+ * Reports character count against a configured budget, warning threshold state,
+ * and stale section candidates. Does not auto-delete: review remains
+ * human- or agent-mediated (Decision 42).
+ */
+/** Result of memory hygiene analysis. */
+interface MemoryHygieneResult {
+    /** Whether MEMORY.md exists. */
+    exists: boolean;
+    /** Total character count. */
+    charCount: number;
+    /** Configured budget in characters. */
+    budget: number;
+    /** Usage as a fraction of budget (0–1+). */
+    usage: number;
+    /** Whether usage exceeds the warning threshold. */
+    warning: boolean;
+    /** Whether usage exceeds the budget. */
+    overBudget: boolean;
+    /** Number of H2 sections flagged as stale candidates. */
+    staleCandidates: number;
+    /** Names of stale sections. */
+    staleSectionNames: string[];
+}
+/** Options for memory hygiene analysis. */
+interface MemoryHygieneOptions {
+    /** Workspace root path. */
+    workspacePath: string;
+    /** Character budget. */
+    budget: number;
+    /** Warning threshold as a fraction of budget (0–1). */
+    warningThreshold: number;
+    /** Staleness threshold in days. */
+    staleDays: number;
+}
+/**
+ * Extract the most recent ISO date from a string.
+ *
+ * @param text - Text to scan for dates.
+ * @returns The most recent date found, or undefined.
+ */
+declare function extractMostRecentDate(text: string): Date | undefined;
+/**
+ * Analyze MEMORY.md for budget and staleness.
+ *
+ * @param options - Analysis configuration.
+ * @returns Memory hygiene result.
+ */
+declare function analyzeMemory(options: MemoryHygieneOptions): MemoryHygieneResult;
+
+/**
+ * HEARTBEAT integration for memory hygiene.
+ *
+ * @remarks
+ * Calls `analyzeMemory()` and converts the result into a `HeartbeatEntry`
+ * suitable for inclusion in the HEARTBEAT.md platform status section.
+ * Returns `undefined` when MEMORY.md is healthy (no alert needed).
+ *
+ * Uses the `## MEMORY.md` heading (Decision 50) to distinguish memory
+ * alerts from component alerts (`## jeeves-{name}`).
+ */
+
+/** The HEARTBEAT heading name for memory alerts. */
+declare const MEMORY_HEARTBEAT_NAME = "MEMORY.md";
+/**
+ * Check memory health and return a HEARTBEAT entry if unhealthy.
+ *
+ * @param options - Memory hygiene options (workspacePath, budget, etc.).
+ * @returns A `HeartbeatEntry` when memory needs attention, `undefined` when healthy.
+ */
+declare function checkMemoryHealth(options: MemoryHygieneOptions): HeartbeatEntry | undefined;
+
 /**
  * Internal function to maintain SOUL.md, AGENTS.md, and TOOLS.md Platform section.
  *
@@ -1205,6 +1434,21 @@ interface SeedContentOptions {
  */
 declare function seedContent(options: SeedContentOptions): Promise<void>;
 
+/**
+ * Skill seeding: write the `jeeves` workspace skill unconditionally.
+ *
+ * @remarks
+ * The skill file is entirely generated — no user-authored content (Decision 48).
+ * Every installer (core CLI and component plugins) writes it unconditionally.
+ * Content is inlined at build time via `rollup-plugin-md.ts`.
+ */
+/**
+ * Seed the jeeves workspace skill file.
+ *
+ * @param workspacePath - Workspace root directory.
+ */
+declare function seedSkill(workspacePath: string): void;
+
 /**
  * Factory for the standard plugin tool set.
  *
@@ -1594,5 +1838,5 @@ interface ServiceManager {
  */
 declare function createServiceManager(descriptor: JeevesComponentDescriptor): ServiceManager;
 
-export { AGENTS_MARKERS, CLEANUP_FLAG, COMPONENT_CONFIG_PREFIX, COMPONENT_VERSIONS_FILE, CONFIG_FILE, CORE_CONFIG_DIR, CORE_VERSION, ComponentWriter, DEFAULT_BIND_ADDRESS, DEFAULT_CORE_VERSION, DEFAULT_PORTS, HEARTBEAT_HEADING, META_PORT, PLATFORM_COMPONENTS, REGISTRY_CACHE_FILE, RUNNER_PORT, SECTION_IDS, SECTION_ORDER, SERVER_PORT, SOUL_MARKERS, STALENESS_THRESHOLD_MS, STALE_LOCK_MS, TEMPLATES_DIR, TOOLS_MARKERS, VERSION_STAMP_PATTERN, WATCHER_PORT, WORKSPACE_FILES, appendJsonl, atomicWrite, buildHeartbeatSection, checkRegistryVersion, connectionFail, coreConfigSchema, createAsyncContentCache, createComponentWriter, createConfigApplyHandler, createConfigQueryHandler, createGoogleAuth, createPluginCli, createPluginToolset, createServiceCli, createServiceManager, createStatusHandler, ensureDir, fail, fetchJson, fetchWithTimeout, formatBeginMarker, formatEndMarker, generateJsonSchema, getArg, getBindAddress, getChannelWorkspace, getComponentConfigDir, getConfigRoot, getCoreConfigDir, getCoreConfigFile, getEffectiveServiceName, getPackageVersion, getServiceState, getServiceUrl, getWorkspacePath, init, isPrime, jaccard, jeevesComponentDescriptorSchema, loadEnvFile, needsCleanup, nowIso, ok, orchestrateHeartbeat, parseArgs, parseHeartbeat, parseManaged, patchConfig, postJson, readComponentVersions, readJson, readJsonl, refreshPlatformContent, removeComponentVersion, removeManagedSection, resetInit, resolveConfigPath, resolveOpenClawHome, resolveOptionalPluginSetting, resolvePluginSetting, resolveWorkspacePath, run, runScript, runWithRetry, saveCache, seedContent, shingles, shouldWrite, sleepAsync, sleepMs, updateManagedSection, uuid, withFileLock, writeComponentVersion, writeHeartbeatSection, writeJsonAtomic, writeJsonl };
-export type { AccountConfig, AsyncContentCacheOptions, ComponentDependencies, ComponentState, ComponentVersionEntry, ComponentVersionsState, ConfigApplyHandler, ConfigApplyRequest, ConfigApplyResult, ConfigQueryHandler, ConfigQueryResponse, CoreConfig, CreatePluginCliOptions, CreateStatusHandlerOptions, GoogleAuthOptions, HeartbeatEntry, InitOptions, JeevesComponentDescriptor, ManagedMarkers, ManagedSection, OrchestrateHeartbeatOptions, ParseManagedResult, ParsedHeartbeat, PlatformComponent, PluginApi, RefreshPlatformContentOptions, RemoveManagedSectionOptions, RetryOptions, RunOptions, SectionId, SeedContentOptions, ServiceAccountFileConfig, ServiceManager, ServiceManagerOptions, ServiceState, SlackWorkspaceOptions, StatusHandler, StatusHandlerResult, StatusResponse, ToolDescriptor, ToolRegistrationOptions, ToolResult, UpdateManagedSectionOptions, VersionStamp, WriteComponentVersionOptions };
+export { AGENTS_MARKERS, CLEANUP_FLAG, COMPONENT_CONFIG_PREFIX, COMPONENT_VERSIONS_FILE, CONFIG_FILE, CORE_CONFIG_DIR, CORE_VERSION, ComponentWriter, DEFAULT_BIND_ADDRESS, DEFAULT_CORE_VERSION, DEFAULT_PORTS, HEARTBEAT_HEADING, JEEVES_SKILL_DIR, MEMORY_HEARTBEAT_NAME, META_PORT, PLATFORM_COMPONENTS, REGISTRY_CACHE_FILE, RUNNER_PORT, SECTION_IDS, SECTION_ORDER, SERVER_PORT, SKILLS_DIR, SOUL_MARKERS, STALENESS_THRESHOLD_MS, STALE_LOCK_MS, TEMPLATES_DIR, TOOLS_MARKERS, VERSION_STAMP_PATTERN, WATCHER_PORT, WORKSPACE_CONFIG_DEFAULTS, WORKSPACE_CONFIG_FILE, WORKSPACE_FILES, analyzeMemory, appendJsonl, atomicWrite, buildEffectiveConfig, buildHeartbeatSection, checkMemoryHealth, checkNodeVersion, checkRegistryVersion, connectionFail, coreConfigSchema, createAsyncContentCache, createComponentWriter, createConfigApplyHandler, createConfigQueryHandler, createGoogleAuth, createPluginCli, createPluginToolset, createServiceCli, createServiceManager, createStatusHandler, ensureDir, extractMostRecentDate, fail, fetchJson, fetchWithTimeout, formatBeginMarker, formatEndMarker, generateJsonSchema, generateWorkspaceJsonSchema, getArg, getBindAddress, getChannelWorkspace, getComponentConfigDir, getConfigRoot, getCoreConfigDir, getCoreConfigFile, getEffectiveServiceName, getPackageVersion, getServiceState, getServiceUrl, getWorkspacePath, init, isPrime, jaccard, jeevesComponentDescriptorSchema, loadEnvFile, loadWorkspaceConfig, needsCleanup, nowIso, ok, orchestrateHeartbeat, parseArgs, parseHeartbeat, parseManaged, patchConfig, postJson, readComponentVersions, readJson, readJsonl, refreshPlatformContent, removeComponentVersion, removeManagedSection, resetInit, resolveConfigPath, resolveConfigValue, resolveOpenClawHome, resolveOptionalPluginSetting, resolvePluginSetting, resolveWorkspacePath, run, runScript, runWithRetry, saveCache, seedContent, seedSkill, shingles, shouldWrite, sleepAsync, sleepMs, updateManagedSection, uuid, withFileLock, workspaceConfigSchema, writeComponentVersion, writeHeartbeatSection, writeJsonAtomic, writeJsonl };
+export type { AccountConfig, AsyncContentCacheOptions, ComponentDependencies, ComponentState, ComponentVersionEntry, ComponentVersionsState, ComponentWriterOptions, ConfigApplyHandler, ConfigApplyRequest, ConfigApplyResult, ConfigProvenance, ConfigQueryHandler, ConfigQueryResponse, CoreConfig, CreatePluginCliOptions, CreateStatusHandlerOptions, GoogleAuthOptions, HeartbeatEntry, InitOptions, JeevesComponentDescriptor, ManagedMarkers, ManagedSection, MemoryHygieneOptions, MemoryHygieneResult, OrchestrateHeartbeatOptions, ParseManagedResult, ParsedHeartbeat, PlatformComponent, PluginApi, RefreshPlatformContentOptions, RemoveManagedSectionOptions, ResolvedValue, RetryOptions, RunOptions, SectionId, SeedContentOptions, ServiceAccountFileConfig, ServiceManager, ServiceManagerOptions, ServiceState, SlackWorkspaceOptions, StatusHandler, StatusHandlerResult, StatusResponse, ToolDescriptor, ToolRegistrationOptions, ToolResult, UpdateManagedSectionOptions, VersionStamp, WorkspaceConfig, WriteComponentVersionOptions };