@tomingtoming/kioq 0.8.1 → 0.8.3

package/dist/src/storage/githubStorage.js

@@ -38,6 +38,8 @@ export class GitHubStorage {
     fetchFn;
     execFileAsyncFn;
     setupValidated = false;
+    lastFetchMs = 0;
+    static FETCH_INTERVAL_MS = 10_000;
     constructor(githubConfig, rootPath, deps = {}) {
         this.githubConfig = githubConfig;
         this.rootPath = rootPath;
@@ -48,17 +50,21 @@ export class GitHubStorage {
         this.fetchFn = deps.fetchFn ?? fetch;
         this.execFileAsyncFn = deps.execFileAsyncFn ?? execFileAsync;
     }
-    // --- Reads: delegate to local clone ---
-    stat(relativePath) {
+    // --- Reads: delegate to local clone (with auto-refresh) ---
+    async stat(relativePath) {
+        await this.refreshIfStale();
         return this.local.stat(relativePath);
     }
-    readFile(relativePath) {
+    async readFile(relativePath) {
+        await this.refreshIfStale();
         return this.local.readFile(relativePath);
     }
-    readdir(relativePath) {
+    async readdir(relativePath) {
+        await this.refreshIfStale();
         return this.local.readdir(relativePath);
     }
-    listMarkdownFiles() {
+    async listMarkdownFiles() {
+        await this.refreshIfStale();
         return this.local.listMarkdownFiles();
     }
     // --- Writes: GitHub Git Data API ---
@@ -116,7 +122,7 @@ export class GitHubStorage {
         catch {
             // .git not found — auto-clone below
         }
-        const cloneUrl = `https://github.com/${this.githubConfig.owner}/${this.githubConfig.repo}.git`;
+        const cloneUrl = `https://x-access-token:${this.githubConfig.token}@github.com/${this.githubConfig.owner}/${this.githubConfig.repo}.git`;
         try {
             await fs.mkdir(path.dirname(this.rootPath), { recursive: true });
             await this.execFileAsyncFn("git", ["clone", "--branch", this.branch, "--single-branch", cloneUrl, this.rootPath], { timeout: 120_000 });
@@ -352,6 +358,7 @@ export class GitHubStorage {
                 cwd: this.rootPath,
                 timeout: 30_000,
             });
+            this.lastFetchMs = Date.now();
         }
         catch (error) {
             throw new Error(`${context}: ${this.normalizeExecError(error)}`);
@@ -365,6 +372,25 @@ export class GitHubStorage {
             // best-effort only
         }
     }
+    async refreshIfStale() {
+        const now = Date.now();
+        if (now - this.lastFetchMs < GitHubStorage.FETCH_INTERVAL_MS) {
+            return;
+        }
+        try {
+            const { stdout: localRef } = await this.execFileAsyncFn("git", ["rev-parse", `refs/heads/${this.branch}`], { cwd: this.rootPath, timeout: 5_000 });
+            await this.execFileAsyncFn("git", ["fetch", "--no-tags", "origin", this.branch], { cwd: this.rootPath, timeout: 15_000 });
+            const { stdout: remoteRef } = await this.execFileAsyncFn("git", ["rev-parse", `refs/remotes/origin/${this.branch}`], { cwd: this.rootPath, timeout: 5_000 });
+            this.lastFetchMs = Date.now();
+            if (localRef.trim() !== remoteRef.trim()) {
+                await this.pullLocal("git pull --ff-only failed during auto-refresh");
+            }
+        }
+        catch {
+            // best-effort: if fetch fails, proceed with stale data
+            this.lastFetchMs = Date.now();
+        }
+    }
     isRetryableBatchError(error) {
         return (error instanceof GitHubApiError && error.retryable)
             || this.isTransientNetworkError(error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomingtoming/kioq",
-  "version": "0.8.1",
+  "version": "0.8.3",
   "description": "Japanese-first local markdown MCP server",
   "type": "module",
   "bin": {