dsh-skill-hub 0.1.0 → 0.2.0

package/lib/types/skillfs.d.ts

@@ -11,7 +11,7 @@
  * userInvocable defaults true), legacy keys rejected, and the returned
  * content is the body after the frontmatter block, trimmed.
  */
-import type { DiagnosticEntry, WritableRoot } from './protocol.ts';
+import type { DiagnosticEntry, TrashEntry, WritableRoot } from './protocol.ts';
 /** Root ids this module may write to. */
 export declare const WRITABLE_ROOTS: readonly WritableRoot[];
 /** Resolve the absolute directory of one writable root. */
@@ -32,13 +32,26 @@ export declare function createSkill(root: WritableRoot, name: string, descriptio
 export declare function disableSkill(path: string): Promise<string>;
 /** Re-enable a previously disabled file (reverse of disableSkill). */
 export declare function enableSkill(disabledPath: string): Promise<string>;
+/**
+ * Move a skill (directory bundle or flat .md file) into the root's trash.
+ * The skill stays recoverable: the source is renamed into
+ * <root>/.trash/<name>-<timestamp>. A directory bundle is addressed by its
+ * SKILL.md path and moved as a whole directory.
+ * @returns the trashed path plus the original path that was moved.
+ */
+export declare function trashSkill(sourcePath: string): Promise<{
+    path: string;
+    source: string;
+}>;
+/** Restore a trashed skill (directory or flat file) to its original location. */
+export declare function restoreSkill(entry: TrashEntry, home?: string): Promise<string>;
+/** Permanently delete one trashed skill (directory or flat file). */
+export declare function clearTrash(entry: TrashEntry, home?: string): Promise<string>;
 /** One parsed frontmatter outcome (official provider semantics). */
 export interface FrontmatterValue {
     name: string;
     description: string;
     whenToUse?: string;
-    /** Optional group names the skill declares (frontmatter `sets`). */
-    sets?: string[];
     invocation: {
         modelInvocable: boolean;
         userInvocable: boolean;
@@ -46,13 +59,6 @@ export interface FrontmatterValue {
     /** Instruction body after the frontmatter block, trimmed. */
     content: string;
 }
-/**
- * Normalize an optional frontmatter `sets` value into a clean string list.
- * Accepts a single string or a string array; trims, drops empties, and
- * ignores non-string entries. Returns undefined when absent or empty, so a
- * skill without sets stays uncategorized.
- */
-export declare function normalizeSets(raw: unknown): string[] | undefined;
 /** Parse a SKILL.md the way the official filesystem provider does. */
 export declare function parseFrontmatter(text: string): {
     value: FrontmatterValue;
@@ -70,11 +76,10 @@ export interface SkillEntry {
 /**
  * Scan one skills root for discovery files: directory bundles (SKILL.md)
  * and flat <name>.md files. Hub-disabled files (.disabled) are excluded;
- * the .system subdirectory is excluded when skipSystem is set (mirrors the
- * official provider's user-dsh behavior).
+ * dot-prefixed entries (including .trash and .system) are always skipped.
  */
-export declare function scanRoot(base: string, skipSystem: boolean): Promise<SkillEntry[]>;
-/** Scan one writable root (user-dsh skips .system, mirroring the official provider). */
+export declare function scanRoot(base: string): Promise<SkillEntry[]>;
+/** Scan one writable root. */
 export declare function listSkillEntries(root: WritableRoot, home?: string): Promise<SkillEntry[]>;
 /**
  * Walk up from cwd (max 32 levels) for a project marker (.dsh or .git);

package/lib/types/stats.d.ts

@@ -26,11 +26,24 @@ export interface SessionQueryLike {
         events: SessionEvent[];
     }>;
 }
-/** Count skill invocations in one session's event log, keyed by skill name. */
-export declare function countSkillInvocations(events: readonly SessionEvent[]): Map<string, number>;
-/** Scan every session and total per-skill invocation counts. */
+/** Per-skill invocation stats in one session's event log. */
+export interface InvocationStat {
+    count: number;
+    /** Unix epoch ms of the most recent invocation in this batch. */
+    lastUsed: number;
+}
+/** Collect per-skill invocation counts and last-used times from one session. */
+export declare function countSkillInvocations(events: readonly SessionEvent[]): Map<string, InvocationStat>;
+/** Scan every session and total per-skill counts, keeping the latest lastUsed. */
 export declare function readSkillStats(query: SessionQueryLike): Promise<SkillStat[]>;
 /** A memoized stats reader (the panel polls, but logs change slowly). */
 export type SkillStatsReader = () => Promise<SkillStat[]>;
-/** Wrap a query in a TTL cache so a 5s panel poll does not rescan every log. */
+/**
+ * Wrap a query in a stale-while-revalidate cache: responses never wait for a
+ * full session-log scan. While the TTL is fresh the cached totals are
+ * returned; after expiry the stale totals are returned immediately and a
+ * single background rescan refreshes them — the panel's next poll picks the
+ * fresh numbers. A full scan decompresses every session log and can take
+ * seconds, so it must never sit on the request path.
+ */
 export declare function createSkillStatsReader(query: SessionQueryLike, ttlMs?: number): SkillStatsReader;

package/lib/types/store.d.ts

@@ -1,25 +1,55 @@
 /**
- * Hub sidecar store: remembers which skills the hub toggled off. Disabling
- * renames the skill's SKILL.md (or flat .md) out of the filesystem provider's
- * discovery shapes, so the provider catalog alone cannot see disabled skills;
- * this store keeps name/path/root so the GUI can list them and re-enable.
+ * Hub sidecar store: remembers which skills the hub toggled off and the
+ * user's organization/tracking records. Disabling renames the skill's
+ * SKILL.md (or flat .md) out of the filesystem provider's discovery shapes,
+ * so the provider catalog alone cannot see disabled skills; this store keeps
+ * name/path/root so the GUI can list them and re-enable. It also persists
+ * user tag groups, upstream source records (repo + commit snapshot for
+ * update checks), the market source list, and the trash (skills removed
+ * after upstream deletion).
  *
  * State file: $DSH_HOME/dsh-skill-hub.json — a small JSON document written
  * atomically (tmp file + rename).
  */
-import type { DisabledSkill, HubConfig } from './protocol.ts';
+import type { DisabledSkill, HubConfig, MarketSourceRecord, RepoRoot, SkillTag, SourceRecord, TrashEntry } from './protocol.ts';
+/** 默认场景名（系统预置的兜底场景，新技能自动归入）。 */
+export declare const DEFAULT_SCENE_NAME = "\u901A\u7528";
 /** Resolve the DSH home directory (the filesystem provider's user-dsh root base). */
 export declare function dshHome(): string;
 /** Resolve the sidecar state path (injectable in tests). */
 export declare function statePath(home?: string): string;
+/** Current sidecar schema version. Bump on breaking shape changes and add a migration below. */
+export declare const STORE_VERSION = 3;
+/**
+ * Business-rule failure the routes layer can map onto a 4xx status instead
+ * of a blanket 500: user input is invalid (validation → 400), the target
+ * does not exist (not-found → 404), or the operation conflicts with an
+ * invariant (conflict → 409).
+ */
+export declare class StoreError extends Error {
+    readonly kind: 'validation' | 'not-found' | 'conflict';
+    constructor(kind: StoreError['kind'], message: string);
+}
 /** Sidecar state owner. */
 export declare class SkillHubStore {
     private readonly file;
     private entries;
     private config;
+    private tagsById;
+    private sourcesByRepo;
+    private marketSources;
+    private trashByName;
     private loaded;
+    /** Serializes persist runs: concurrent mutators must not let an earlier
+     *  snapshot overwrite a later one (rename is atomic, ordering is not). */
+    private writeChain;
     constructor(file?: string);
     private ensureLoaded;
+    /**
+     * 保证存在默认场景：没有任何 default 标记的 tag 时创建「通用」。
+     * 新技能创建后自动归入它；用户可改名，但默认场景不可删除。
+     */
+    private ensureDefaultTag;
     listDisabled(): Promise<DisabledSkill[]>;
     getDisabled(name: string): Promise<DisabledSkill | undefined>;
     addDisabled(entry: DisabledSkill): Promise<void>;
@@ -28,9 +58,85 @@ export declare class SkillHubStore {
     getConfig(): Promise<Partial<HubConfig>>;
     /**
      * Persist a runtime-config patch, merged over the saved values. A field
-     * whose patch value is `undefined` is removed from the saved layer, so the
+     * whose patch value is undefined is removed from the saved layer, so the
      * setting re-inherits its default (the web card's "reset" path).
      */
     setConfig(config: Partial<HubConfig>): Promise<void>;
+    /** All user-defined tag groups, in creation order. */
+    listTags(): Promise<SkillTag[]>;
+    /** One tag by id (undefined when absent). */
+    getTag(id: string): Promise<SkillTag | undefined>;
+    /**
+     * Create (no id) or rename (with id) a tag. Returns the saved tag.
+     * Creating assigns a fresh UUID; renaming keeps members.
+     */
+    saveTag(input: {
+        id?: string;
+        name: string;
+    }): Promise<SkillTag>;
+    /** Delete a tag by id (no-op when absent). The default scene cannot be deleted. */
+    deleteTag(id: string): Promise<void>;
+    /** The default scene (「通用」), guaranteed to exist after ensureLoaded. */
+    getDefaultTag(): Promise<SkillTag | undefined>;
+    /** Append one skill name to a tag (deduplicated; no-op when already a member). */
+    addSkillToTag(id: string, name: string): Promise<SkillTag | undefined>;
+    /**
+     * Replace a tag's member list wholesale (idempotent). Deduplicates and
+     * drops blank names; unknown skill names are kept (they may arrive later),
+     * the routes layer filters against the live catalog before persisting.
+     */
+    setTagMembers(id: string, skillNames: readonly string[]): Promise<SkillTag | undefined>;
+    /** Remove one skill from every tag group (used when the skill is deleted). */
+    removeSkillFromTags(name: string): Promise<void>;
+    /** All source records, sorted by repo. */
+    listSources(): Promise<SourceRecord[]>;
+    /** One source record by repo (undefined when absent). */
+    getSource(repo: string): Promise<SourceRecord | undefined>;
+    /** The source record that tracks a skill name (undefined when untracked). */
+    getSourceForSkill(name: string): Promise<SourceRecord | undefined>;
+    /** Remove a source record entirely (no-op when absent). */
+    deleteSource(repo: string): Promise<void>;
+    /**
+     * Upsert one skill into a source record. When the repo has no record yet a
+     * new one is created (root + commit snapshot from the caller).
+     */
+    addSourceSkill(repo: string, root: RepoRoot, commitSha: string, ref: string | undefined, skillName: string): Promise<void>;
+    /** Replace a source's skill list (used after sync/confirm-delete). */
+    setSourceSkills(repo: string, skills: readonly string[]): Promise<SourceRecord | undefined>;
+    /** Remove one skill from every source record (used when the skill is deleted). */
+    removeSkillFromSources(name: string): Promise<void>;
+    /** Update a source's commit snapshot. */
+    setSourceCommit(repo: string, commitSha: string): Promise<void>;
+    /** Update a source's pinned ref (release tag / branch) when the market syncs. */
+    setSourceRef(repo: string, ref: string): Promise<void>;
+    /**
+     * Merge per-path manifest entries into a source (incremental imports).
+     * When `dir` is given, every baseline path under that skill directory is
+     * dropped first, so files the upstream removed never linger in the
+     * baseline and skew later update diffs.
+     */
+    mergeSourceManifest(repo: string, manifest: Record<string, number>, dir?: string): Promise<void>;
+    /** skillName → collection name for every recorded origin (derived from sources). */
+    listOrigins(): Promise<Record<string, string>>;
+    /** The user's market sources, in addition order. */
+    listMarketSources(): Promise<MarketSourceRecord[]>;
+    /** One market source by repo (undefined when absent). */
+    getMarketSource(repo: string): Promise<MarketSourceRecord | undefined>;
+    /** Add a repo (deduplicated), optionally with a pinned ref. Returns the fresh list. */
+    addMarketSource(repo: string, ref?: string): Promise<MarketSourceRecord[]>;
+    /** Remove a repo (no-op when absent). Returns the fresh list. */
+    removeMarketSource(repo: string): Promise<MarketSourceRecord[]>;
+    /** Pin a market source to an explicit ref (branch/tag). Returns the record. */
+    setMarketSourceRef(repo: string, ref: string): Promise<MarketSourceRecord | undefined>;
+    /** Record the commit a market source's pinned ref resolved to (update baseline). */
+    setMarketSourceCommit(repo: string, commitSha: string): Promise<void>;
+    /** All trashed skills, newest first. */
+    listTrash(): Promise<TrashEntry[]>;
+    /** One trash entry by skill name (undefined when absent). */
+    getTrash(name: string): Promise<TrashEntry | undefined>;
+    /** Record a trashed skill. */
+    addTrash(entry: TrashEntry): Promise<void>;
+    /** Remove a trash record (after restore). */
+    removeTrash(name: string): Promise<void>;
     private persist;
 }

package/lib/types/update.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Self-update check for dsh-skill-hub, mirroring cc-switch's behavior:
+ * query GitHub's latest release and compare it to the installed version.
+ *
+ * This stays dependency-free: Node's global fetch is used and the version
+ * comparison is a small semver-subset parser (the plugin only publishes
+ * plain x.y.z tags, optionally prefixed with `v`).
+ */
+import type { UpdateCheckResponse } from './protocol.ts';
+/** Repository checked for releases. Keep in sync with package.json. */
+export declare const UPDATE_REPO = "cheshireez/dsh-skill-hub";
+export declare const CURRENT_VERSION: string;
+/** Normalize a release tag (`v1.2.3` → `1.2.3`) and parse it numerically. */
+export declare function parseVersion(tag: string): [number, number, number] | null;
+/** Compare two dotted version strings: negative when a < b, 0 equal, positive when a > b. */
+export declare function compareVersions(a: string, b: string): number;
+/** True when latest is strictly newer than current. */
+export declare function isUpdateAvailable(currentVersion: string, latestVersion: string): boolean;
+/** Best-effort GitHub latest-release lookup. Always resolves with ok:true. */
+export declare function checkLatestRelease(repo?: string, fetchImpl?: typeof fetch): Promise<UpdateCheckResponse>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-skill-hub",
-  "version": "0.1.0",
-  "description": "In-GUI skill hub for DeepSeek Harness (dsh): browse the full local skill catalog from the official ctx.skills registry (every root + third-party providers), toggle skills on/off, inspect bodies, surface frontmatter diagnostics, and scaffold new skills — the full manager beyond the read-only dsh-skill-manager browser.",
+  "version": "0.2.0",
+  "description": "In-GUI skill hub for DeepSeek Harness (dsh): browse the full local skill catalog from the official ctx.skills registry (every root + third-party providers), toggle skills on/off, inspect bodies, surface frontmatter diagnostics, and scaffold new skills — plus a codex-style skill market (built-in catalog, upstream update checks, one-click update-all) with tracked source sync. The full manager beyond the read-only dsh-skill-manager browser.",
   "type": "module",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"
@@ -46,6 +46,7 @@
     "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
@@ -62,6 +63,7 @@
     "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
@@ -122,4 +124,4 @@
     "url": "https://github.com/cheshireez/dsh-skill-hub/issues"
   },
   "homepage": "https://github.com/cheshireez/dsh-skill-hub"
-}
+}

package/src/client/SkillHubSettingsCard.tsx

@@ -9,13 +9,19 @@
 
 import type { ReactElement } from 'react'
 import type { SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client'
-import { BooleanField, PluginSettingsCard, SwitchField } from './settings-card.tsx'
-import { booleanField, CardForm, type CardShell, type FieldState, type FormScope } from './settings-form.ts'
+import { ColorField, PluginSettingsCard, SwitchField } from './settings-card.tsx'
+import { booleanField, CardForm, colorField, type CardShell, type FieldState, type FormScope } from './settings-form.ts'
+import { DEFAULT_DOT_MODEL_COLOR, DEFAULT_DOT_USER_COLOR } from './api-config-scope.ts'
 
 /** The card's projected state. */
 export interface SkillHubSettingsState extends CardShell {
   enabled: FieldState
   announceToAgent: FieldState
+  dotModelColor: FieldState
+  dotUserColor: FieldState
+  showUseCount: FieldState
+  showUseTime: FieldState
+  showGroupSummary: FieldState
 }
 
 /** Props the slot renderer receives (locale copy + injected form actions). */
@@ -35,7 +41,7 @@ export class SkillHubSettingsCardController {
 
   /** @param scope - the hub config scope the card edits (ApiConfigScope). */
   constructor(scope: FormScope) {
-    this.form = new CardForm(scope, [booleanField('enabled'), booleanField('announceToAgent')])
+    this.form = new CardForm(scope, [booleanField('enabled'), booleanField('announceToAgent'), colorField('dotModelColor'), colorField('dotUserColor'), booleanField('showUseCount'), booleanField('showUseTime'), booleanField('showGroupSummary')])
     this.store = this.form.bind(() => this.projection())
   }
 
@@ -44,6 +50,11 @@ export class SkillHubSettingsCardController {
       ...this.form.shell(),
       enabled: this.form.field('enabled'),
       announceToAgent: this.form.field('announceToAgent'),
+      dotModelColor: this.form.field('dotModelColor'),
+      dotUserColor: this.form.field('dotUserColor'),
+      showUseCount: this.form.field('showUseCount'),
+      showUseTime: this.form.field('showUseTime'),
+      showGroupSummary: this.form.field('showGroupSummary'),
     }
   }
 
@@ -90,18 +101,60 @@ export function SkillHubSettingsCard(props: SkillHubSettingsCardProps): ReactEle
         onEdit={(text) => { props.edit('enabled', text) }}
         onReset={() => { props.resetField('enabled') }}
       />
-      <BooleanField
-        id='settings-skill-hub-announce'
+      <SwitchField
         label={t('settings.announceToAgent')}
         hint={t('settings.announceToAgentHint')}
-        inheritLabel={t('settings.inherit')}
-        onLabel={t('settings.on')}
-        offLabel={t('settings.off')}
         {...fieldProps}
         {...state.announceToAgent}
         onEdit={(text) => { props.edit('announceToAgent', text) }}
         onReset={() => { props.resetField('announceToAgent') }}
       />
+      <ColorField
+        id='skill-hub-dot-model-color'
+        label={t('settings.dotModelColor')}
+        hint={t('settings.dotModelColorHint')}
+        inheritLabel={t('settings.inherit')}
+        defaultColor={DEFAULT_DOT_MODEL_COLOR}
+        {...fieldProps}
+        {...state.dotModelColor}
+        onEdit={(text) => { props.edit('dotModelColor', text) }}
+        onReset={() => { props.resetField('dotModelColor') }}
+      />
+      <ColorField
+        id='skill-hub-dot-user-color'
+        label={t('settings.dotUserColor')}
+        hint={t('settings.dotUserColorHint')}
+        inheritLabel={t('settings.inherit')}
+        defaultColor={DEFAULT_DOT_USER_COLOR}
+        {...fieldProps}
+        {...state.dotUserColor}
+        onEdit={(text) => { props.edit('dotUserColor', text) }}
+        onReset={() => { props.resetField('dotUserColor') }}
+      />
+      <SwitchField
+        label={t('settings.showUseCount')}
+        hint={t('settings.showUseCountHint')}
+        {...fieldProps}
+        {...state.showUseCount}
+        onEdit={(text) => { props.edit('showUseCount', text) }}
+        onReset={() => { props.resetField('showUseCount') }}
+      />
+      <SwitchField
+        label={t('settings.showUseTime')}
+        hint={t('settings.showUseTimeHint')}
+        {...fieldProps}
+        {...state.showUseTime}
+        onEdit={(text) => { props.edit('showUseTime', text) }}
+        onReset={() => { props.resetField('showUseTime') }}
+      />
+      <SwitchField
+        label={t('settings.showGroupSummary')}
+        hint={t('settings.showGroupSummaryHint')}
+        {...fieldProps}
+        {...state.showGroupSummary}
+        onEdit={(text) => { props.edit('showGroupSummary', text) }}
+        onReset={() => { props.resetField('showGroupSummary') }}
+      />
     </PluginSettingsCard>
   )
 }

package/src/client/api-config-scope.test.ts

@@ -0,0 +1,79 @@
+import { describe, expect, it } from 'vitest'
+import type { ConfigRequest, ConfigResponse, HubConfig } from '../protocol.ts'
+import type { SkillHubApi } from './api.ts'
+import { ApiConfigScope } from './api-config-scope.ts'
+
+function deferredReady(scope: ApiConfigScope): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, 0))
+}
+
+describe('ApiConfigScope', () => {
+  it('persists the panel display toggles (showUseCount etc.)', async () => {
+    const saved: Partial<HubConfig> = {}
+    const writes: ConfigRequest[] = []
+    const api = {
+      config: async (): Promise<ConfigResponse> => ({
+        ok: true,
+        config: {
+          enabled: true,
+          announceToAgent: true,
+          showUseCount: true,
+          showUseTime: true,
+          showGroupSummary: true,
+        },
+        saved,
+      }),
+      saveConfig: async (patch: ConfigRequest): Promise<ConfigResponse> => {
+        writes.push(patch)
+        for (const [key, value] of Object.entries(patch)) {
+          if (value === null) delete saved[key as keyof HubConfig]
+          else saved[key as keyof HubConfig] = value as never
+        }
+        return {
+          ok: true,
+          config: {
+            enabled: true,
+            announceToAgent: true,
+            showUseCount: saved.showUseCount !== false,
+            showUseTime: saved.showUseTime !== false,
+            showGroupSummary: saved.showGroupSummary !== false,
+          },
+          saved,
+        }
+      },
+    } as unknown as SkillHubApi
+
+    const scope = new ApiConfigScope(api)
+    await deferredReady(scope)
+
+    await scope.set('showUseCount', false)
+    expect(writes).toContainEqual({ showUseCount: false })
+    expect(scope.getSnapshot().value).toMatchObject({ showUseCount: false })
+    expect(scope.getSnapshot().user).toMatchObject({ showUseCount: false })
+
+    await scope.unset('showUseCount')
+    expect(writes).toContainEqual({ showUseCount: null })
+    expect(scope.getSnapshot().user).not.toHaveProperty('showUseCount')
+    expect(scope.getSnapshot().value).toMatchObject({ showUseCount: true })
+  })
+
+  it('ignores unknown fields', async () => {
+    const writes: ConfigRequest[] = []
+    const api = {
+      config: async (): Promise<ConfigResponse> => ({
+        ok: true,
+        config: { enabled: true, announceToAgent: true },
+        saved: {},
+      }),
+      saveConfig: async (patch: ConfigRequest): Promise<ConfigResponse> => {
+        writes.push(patch)
+        return { ok: true, config: { enabled: true, announceToAgent: true }, saved: {} }
+      },
+    } as unknown as SkillHubApi
+
+    const scope = new ApiConfigScope(api)
+    await deferredReady(scope)
+    await scope.set('not-a-field', true)
+    expect(writes).toHaveLength(0)
+  })
+})

package/src/client/api-config-scope.ts

@@ -17,11 +17,32 @@ import type { HubConfig } from '../protocol.ts'
 import type { SkillHubApi } from './api.ts'
 import type { FormScope } from './settings-form.ts'
 
+/** Model-invocable dot color default. Single source for the TS side; the
+ *  panel's CSS mirrors it via --hub-model (panel.module.css). */
+export const DEFAULT_DOT_MODEL_COLOR = '#2f81f7'
+/** User-invocable dot color default. Single source for the TS side; the
+ *  panel's CSS mirrors it via --hub-user (panel.module.css). */
+export const DEFAULT_DOT_USER_COLOR = '#3fb950'
+
 /** Built-in defaults every field inherits until the user overrides it. */
-const DEFAULTS: HubConfig = { enabled: true, announceToAgent: true }
+const DEFAULTS: HubConfig = {
+  enabled: true,
+  announceToAgent: true,
+  showUseCount: true,
+  showUseTime: true,
+  showGroupSummary: true,
+}
+
+/** Boolean config fields (color fields are strings). */
+const BOOLEAN_FIELDS = new Set<keyof HubConfig>([
+  'enabled', 'announceToAgent', 'showUseCount', 'showUseTime', 'showGroupSummary',
+])
 
 /** Config fields the card edits (used to guard set/unset field names). */
-const FIELDS = new Set<keyof HubConfig>(['enabled', 'announceToAgent'])
+const FIELDS = new Set<keyof HubConfig>([
+  'enabled', 'announceToAgent', 'dotModelColor', 'dotUserColor',
+  'showUseCount', 'showUseTime', 'showGroupSummary',
+])
 
 /** FormScope-compatible reactive config handle (see module doc). */
 export class ApiConfigScope implements FormScope {
@@ -67,7 +88,10 @@ export class ApiConfigScope implements FormScope {
   /** Write one field through the config route and adopt the persisted state. */
   async set(field: string, value: unknown): Promise<void> {
     if (!FIELDS.has(field as keyof HubConfig)) return
-    await this.apply({ [field]: Boolean(value) } as Partial<HubConfig>)
+    const patch = BOOLEAN_FIELDS.has(field as keyof HubConfig)
+      ? { [field]: Boolean(value) }
+      : { [field]: typeof value === 'string' ? value : undefined }
+    await this.apply(patch as Partial<HubConfig>)
   }
 
   /** Clear one field's override so it re-inherits the default. */
@@ -79,7 +103,7 @@ export class ApiConfigScope implements FormScope {
   /** Persist a patch, then re-seed from the route's fresh response. */
   private async apply(patch: Partial<HubConfig>): Promise<void> {
     // null on the wire clears a saved override (see ConfigRequest).
-    const request: Record<string, boolean | null> = {}
+    const request: Record<string, boolean | string | null> = {}
     for (const [key, value] of Object.entries(patch)) {
       request[key] = value === undefined ? null : value
     }