@leo000001/opencode-quota-sidebar 1.7.0 → 1.8.0

package/README.md

@@ -136,9 +136,35 @@ You can add these command templates in `opencode.json` so you can run `/qday`, `
 }
 ```
 
-## Optional project config
+## Configuration files
 
-Create `quota-sidebar.config.json` under your project root:
+Recommended global config:
+
+- `~/.config/opencode/quota-sidebar.config.json`
+
+Optional project overrides:
+
+- `<worktree>/quota-sidebar.config.json`
+- `<worktree>/.opencode/quota-sidebar.config.json`
+
+Optional explicit override:
+
+- `OPENCODE_QUOTA_CONFIG=/absolute/path/to/config.json`
+
+Optional config-home override:
+
+- `OPENCODE_QUOTA_CONFIG_HOME=/absolute/path/to/config-home`
+
+Resolution order (low -> high):
+
+1. Global config (`~/.config/opencode/...`)
+2. Project root config
+3. `.opencode` project config
+4. `OPENCODE_QUOTA_CONFIG`
+
+Values are layered; later sources override earlier ones.
+
+Example config:
 
 ```json
 {
@@ -215,6 +241,10 @@ Set `OPENCODE_QUOTA_DEBUG=1` to enable debug logging to stderr. This logs:
 - State/chunk file writes refuse to write through symlinked targets (best-effort defense-in-depth).
 - The `OPENCODE_QUOTA_DATA_HOME` env var overrides the OpenCode data directory
   path (for testing); do not set this in production.
+- The `OPENCODE_QUOTA_CONFIG_HOME` env var overrides global config directory
+  lookup (`<config-home>/opencode`).
+- The `OPENCODE_QUOTA_CONFIG` env var points to an explicit config file and
+  applies as the highest-priority override.
 
 ## Contributing
 

package/dist/index.js

@@ -1,7 +1,7 @@
 import path from 'node:path';
 import { renderMarkdownReport, renderSidebarTitle, renderToastMessage, } from './format.js';
 import { createQuotaRuntime } from './quota.js';
-import { authFilePath, dateKeyFromTimestamp, deleteSessionFromDayChunk, evictOldSessions, loadConfig, loadState, normalizeTimestampMs, resolveOpencodeDataDir, saveState, stateFilePath, } from './storage.js';
+import { authFilePath, dateKeyFromTimestamp, deleteSessionFromDayChunk, evictOldSessions, loadConfig, loadState, normalizeTimestampMs, resolveOpencodeConfigDir, resolveOpencodeDataDir, saveState, stateFilePath, } from './storage.js';
 import { debug, swallow } from './helpers.js';
 import { normalizeBaseTitle } from './title.js';
 import { createDescendantsResolver } from './descendants.js';
@@ -14,9 +14,15 @@ import { createUsageService } from './usage_service.js';
 import { createTitleApplicator } from './title_apply.js';
 export async function QuotaSidebarPlugin(input) {
     const quotaRuntime = createQuotaRuntime();
+    const configDir = resolveOpencodeConfigDir();
+    const configOverride = process.env.OPENCODE_QUOTA_CONFIG?.trim();
     const config = await loadConfig([
-        path.join(input.directory, 'quota-sidebar.config.json'),
+        path.join(configDir, 'quota-sidebar.config.json'),
         path.join(input.worktree, 'quota-sidebar.config.json'),
+        path.join(input.directory, 'quota-sidebar.config.json'),
+        path.join(input.worktree, '.opencode', 'quota-sidebar.config.json'),
+        path.join(input.directory, '.opencode', 'quota-sidebar.config.json'),
+        ...(configOverride ? [path.resolve(configOverride)] : []),
     ]);
     const dataDir = resolveOpencodeDataDir();
     const statePath = stateFilePath(dataDir);

package/dist/storage.d.ts

@@ -1,7 +1,7 @@
 import { dateKeyFromTimestamp, normalizeTimestampMs } from './storage_dates.js';
-import { authFilePath, resolveOpencodeDataDir, stateFilePath } from './storage_paths.js';
+import { authFilePath, resolveOpencodeConfigDir, resolveOpencodeDataDir, stateFilePath } from './storage_paths.js';
 import type { CachedSessionUsage, IncrementalCursor, QuotaSidebarConfig, QuotaSidebarState, SessionState } from './types.js';
-export { authFilePath, dateKeyFromTimestamp, normalizeTimestampMs, resolveOpencodeDataDir, stateFilePath, };
+export { authFilePath, dateKeyFromTimestamp, normalizeTimestampMs, resolveOpencodeConfigDir, resolveOpencodeDataDir, stateFilePath, };
 export declare const defaultConfig: QuotaSidebarConfig;
 export declare function defaultState(): QuotaSidebarState;
 export declare function loadConfig(paths: string[]): Promise<QuotaSidebarConfig>;

package/dist/storage.js

@@ -4,8 +4,8 @@ import { asBoolean, asNumber, debug, isRecord, mapConcurrent, swallow, } from '.
 import { discoverChunks, readDayChunk, safeWriteFile, writeDayChunk, } from './storage_chunks.js';
 import { dateKeyFromTimestamp, dateKeysInRange, dateStartFromKey, isDateKey, normalizeTimestampMs, } from './storage_dates.js';
 import { parseQuotaCache } from './storage_parse.js';
-import { authFilePath, chunkRootPathFromStateFile, resolveOpencodeDataDir, stateFilePath, } from './storage_paths.js';
-export { authFilePath, dateKeyFromTimestamp, normalizeTimestampMs, resolveOpencodeDataDir, stateFilePath, };
+import { authFilePath, chunkRootPathFromStateFile, resolveOpencodeConfigDir, resolveOpencodeDataDir, stateFilePath, } from './storage_paths.js';
+export { authFilePath, dateKeyFromTimestamp, normalizeTimestampMs, resolveOpencodeConfigDir, resolveOpencodeDataDir, stateFilePath, };
 // ─── Default config ──────────────────────────────────────────────────────────
 export const defaultConfig = {
     sidebar: {
@@ -44,43 +44,14 @@ export function defaultState() {
 }
 // ─── Config loading ──────────────────────────────────────────────────────────
 export async function loadConfig(paths) {
-    const existing = await Promise.all(paths.map(async (filePath) => {
-        const stat = await fs.stat(filePath).catch(swallow('loadConfig:stat'));
-        if (!stat || !stat.isFile())
-            return undefined;
-        return filePath;
-    }));
-    const selected = existing.find((value) => value);
-    if (!selected)
-        return defaultConfig;
-    const parsed = await fs
-        .readFile(selected, 'utf8')
-        .then((value) => JSON.parse(value))
-        .catch(swallow('loadConfig:read'));
-    if (!isRecord(parsed))
-        return defaultConfig;
-    const sidebar = isRecord(parsed.sidebar) ? parsed.sidebar : {};
-    const quota = isRecord(parsed.quota) ? parsed.quota : {};
-    const toast = isRecord(parsed.toast) ? parsed.toast : {};
-    const providers = isRecord(quota.providers) ? quota.providers : {};
-    return {
-        sidebar: {
-            enabled: asBoolean(sidebar.enabled, defaultConfig.sidebar.enabled),
-            width: Math.max(20, Math.min(60, asNumber(sidebar.width, defaultConfig.sidebar.width))),
-            showCost: asBoolean(sidebar.showCost, defaultConfig.sidebar.showCost),
-            showQuota: asBoolean(sidebar.showQuota, defaultConfig.sidebar.showQuota),
-            wrapQuotaLines: asBoolean(sidebar.wrapQuotaLines, defaultConfig.sidebar.wrapQuotaLines),
-            includeChildren: asBoolean(sidebar.includeChildren, defaultConfig.sidebar.includeChildren),
-            childrenMaxDepth: Math.max(1, Math.min(32, Math.floor(asNumber(sidebar.childrenMaxDepth, defaultConfig.sidebar.childrenMaxDepth)))),
-            childrenMaxSessions: Math.max(0, Math.min(2000, Math.floor(asNumber(sidebar.childrenMaxSessions, defaultConfig.sidebar.childrenMaxSessions)))),
-            childrenConcurrency: Math.max(1, Math.min(10, Math.floor(asNumber(sidebar.childrenConcurrency, defaultConfig.sidebar.childrenConcurrency)))),
-        },
-        quota: {
-            refreshMs: Math.max(30_000, asNumber(quota.refreshMs, defaultConfig.quota.refreshMs)),
-            includeOpenAI: asBoolean(quota.includeOpenAI, defaultConfig.quota.includeOpenAI),
-            includeCopilot: asBoolean(quota.includeCopilot, defaultConfig.quota.includeCopilot),
-            includeAnthropic: asBoolean(quota.includeAnthropic, defaultConfig.quota.includeAnthropic),
-            providers: Object.entries(providers).reduce((acc, [id, value]) => {
+    const mergeLayer = (base, parsed) => {
+        const sidebar = isRecord(parsed.sidebar) ? parsed.sidebar : {};
+        const quota = isRecord(parsed.quota) ? parsed.quota : {};
+        const toast = isRecord(parsed.toast) ? parsed.toast : {};
+        const providers = isRecord(quota.providers) ? quota.providers : {};
+        const mergedProviders = {
+            ...base.quota.providers,
+            ...Object.entries(providers).reduce((acc, [id, value]) => {
                 if (!isRecord(value))
                     return acc;
                 if (typeof value.enabled === 'boolean') {
@@ -88,14 +59,54 @@ export async function loadConfig(paths) {
                 }
                 return acc;
             }, {}),
-            refreshAccessToken: asBoolean(quota.refreshAccessToken, defaultConfig.quota.refreshAccessToken),
-            requestTimeoutMs: Math.max(1000, asNumber(quota.requestTimeoutMs, defaultConfig.quota.requestTimeoutMs)),
-        },
-        toast: {
-            durationMs: Math.max(1000, asNumber(toast.durationMs, defaultConfig.toast.durationMs)),
-        },
-        retentionDays: Math.max(1, asNumber(parsed.retentionDays, defaultConfig.retentionDays)),
+        };
+        return {
+            sidebar: {
+                enabled: asBoolean(sidebar.enabled, base.sidebar.enabled),
+                width: Math.max(20, Math.min(60, asNumber(sidebar.width, base.sidebar.width))),
+                showCost: asBoolean(sidebar.showCost, base.sidebar.showCost),
+                showQuota: asBoolean(sidebar.showQuota, base.sidebar.showQuota),
+                wrapQuotaLines: asBoolean(sidebar.wrapQuotaLines, base.sidebar.wrapQuotaLines),
+                includeChildren: asBoolean(sidebar.includeChildren, base.sidebar.includeChildren),
+                childrenMaxDepth: Math.max(1, Math.min(32, Math.floor(asNumber(sidebar.childrenMaxDepth, base.sidebar.childrenMaxDepth)))),
+                childrenMaxSessions: Math.max(0, Math.min(2000, Math.floor(asNumber(sidebar.childrenMaxSessions, base.sidebar.childrenMaxSessions)))),
+                childrenConcurrency: Math.max(1, Math.min(10, Math.floor(asNumber(sidebar.childrenConcurrency, base.sidebar.childrenConcurrency)))),
+            },
+            quota: {
+                refreshMs: Math.max(30_000, asNumber(quota.refreshMs, base.quota.refreshMs)),
+                includeOpenAI: asBoolean(quota.includeOpenAI, base.quota.includeOpenAI),
+                includeCopilot: asBoolean(quota.includeCopilot, base.quota.includeCopilot),
+                includeAnthropic: asBoolean(quota.includeAnthropic, base.quota.includeAnthropic),
+                providers: mergedProviders,
+                refreshAccessToken: asBoolean(quota.refreshAccessToken, base.quota.refreshAccessToken),
+                requestTimeoutMs: Math.max(1000, asNumber(quota.requestTimeoutMs, base.quota.requestTimeoutMs)),
+            },
+            toast: {
+                durationMs: Math.max(1000, asNumber(toast.durationMs, base.toast.durationMs)),
+            },
+            retentionDays: Math.max(1, asNumber(parsed.retentionDays, base.retentionDays)),
+        };
     };
+    const seen = new Set();
+    let config = defaultConfig;
+    for (const originalPath of paths) {
+        const filePath = path.resolve(originalPath);
+        const key = process.platform === 'win32' ? filePath.toLowerCase() : filePath;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        const stat = await fs.stat(filePath).catch(swallow('loadConfig:stat'));
+        if (!stat || !stat.isFile())
+            continue;
+        const parsed = await fs
+            .readFile(filePath, 'utf8')
+            .then((value) => JSON.parse(value))
+            .catch(swallow('loadConfig:read'));
+        if (!isRecord(parsed))
+            continue;
+        config = mergeLayer(config, parsed);
+    }
+    return config;
 }
 // ─── State loading ───────────────────────────────────────────────────────────
 /** P2: Lazy chunk loading — only load chunks for sessions in sessionDateMap. */

package/dist/storage_paths.d.ts

@@ -9,6 +9,12 @@
  * OPENCODE_QUOTA_DATA_HOME overrides the full data directory path.
  */
 export declare function resolveOpencodeDataDir(): string;
+/**
+ * Resolve OpenCode config directory.
+ *
+ * Uses XDG config conventions with optional plugin-scoped override.
+ */
+export declare function resolveOpencodeConfigDir(): string;
 export declare function stateFilePath(dataDir: string): string;
 export declare function authFilePath(dataDir: string): string;
 export declare function chunkRootPathFromStateFile(statePath: string): string;

package/dist/storage_paths.js

@@ -20,6 +20,20 @@ export function resolveOpencodeDataDir() {
         return path.join(path.resolve(xdg), 'opencode');
     return path.join(os.homedir(), '.local', 'share', 'opencode');
 }
+/**
+ * Resolve OpenCode config directory.
+ *
+ * Uses XDG config conventions with optional plugin-scoped override.
+ */
+export function resolveOpencodeConfigDir() {
+    const override = process.env.OPENCODE_QUOTA_CONFIG_HOME?.trim();
+    if (override)
+        return path.resolve(override);
+    const xdg = process.env.XDG_CONFIG_HOME?.trim();
+    if (xdg)
+        return path.join(path.resolve(xdg), 'opencode');
+    return path.join(os.homedir(), '.config', 'opencode');
+}
 export function stateFilePath(dataDir) {
     return path.join(dataDir, 'quota-sidebar.state.json');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leo000001/opencode-quota-sidebar",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "OpenCode plugin that shows quota and token usage in session titles",
   "type": "module",
   "main": "dist/index.js",