@overscore/cli 0.8.0 → 0.9.0

package/dist/index.js

@@ -287,6 +287,8 @@ async function deploy() {
             // Non-fatal
         }
     }
+    // Pull latest platform rules so the local project stays up to date
+    await syncPlatformRules(process.cwd(), baseUrl, apiKey);
 }
 async function queryList() {
     const { dashboardSlug } = loadEnv();
@@ -543,6 +545,26 @@ VITE_OVERSCORE_API_URL=https://overscore.dev/api
     catch {
         // Non-fatal — the version from the source zip is fine
     }
+    // Pull dashboard context from Hub (may be newer than the source zip)
+    try {
+        const dashCtxRes = await fetch(`${baseUrl}/api/dashboards/${dashboardSlug}/context`, {
+            headers: { Authorization: `Bearer ${apiKey}` },
+        });
+        if (dashCtxRes.ok) {
+            const dashCtxData = (await dashCtxRes.json());
+            if (dashCtxData.context_md) {
+                const rulesDir = path.join(targetDir, ".claude", "rules");
+                fs.mkdirSync(rulesDir, { recursive: true });
+                fs.writeFileSync(path.join(rulesDir, "dashboard-context.md"), dashCtxData.context_md);
+                console.log("  Updated dashboard context from Hub.");
+            }
+        }
+    }
+    catch {
+        // Non-fatal
+    }
+    // Pull latest platform rules
+    await syncPlatformRules(targetDir, baseUrl, apiKey);
     console.log(`
   Pulled v${version}${commitMsg ? ` — "${commitMsg}"` : ""}
 
@@ -711,6 +733,84 @@ async function analysisApiRequest(cfg, method, urlPath, body) {
     }
     return data;
 }
+/**
+ * Fetch hub-managed rule files (company-context, sql-style) for a project
+ * and write them into the target analysis folder, overwriting whatever's
+ * there. Best-effort and non-fatal — if the hub is unreachable, the existing
+ * files (template defaults or bundle contents) stay in place.
+ *
+ * Called from both `analysis new` (after the template walker) and `analysis
+ * pull` (after the bundle extraction) so hub overrides always reflect the
+ * latest state regardless of how the analysis was created.
+ */
+async function syncHubManagedRules(targetDir, baseUrl, projectSlug, apiKey) {
+    const authHeader = { Authorization: `Bearer ${apiKey}` };
+    const rulesDir = path.join(targetDir, ".claude", "rules");
+    fs.mkdirSync(rulesDir, { recursive: true });
+    // Company context — null means "no company context set yet"; leave any
+    // existing file alone in that case.
+    try {
+        const ctxRes = await fetch(`${baseUrl}/api/projects/${projectSlug}/context`, { headers: authHeader });
+        if (ctxRes.ok) {
+            const ctxData = (await ctxRes.json());
+            if (ctxData.context_md) {
+                fs.writeFileSync(path.join(rulesDir, "company-context.md"), ctxData.context_md);
+            }
+        }
+    }
+    catch {
+        // Non-fatal
+    }
+    // SQL style override — null means "use the CLI default"; leave the
+    // template/bundle file alone in that case.
+    try {
+        const sqlRes = await fetch(`${baseUrl}/api/projects/${projectSlug}/sql-style`, { headers: authHeader });
+        if (sqlRes.ok) {
+            const sqlData = (await sqlRes.json());
+            if (sqlData.sql_style_md) {
+                fs.writeFileSync(path.join(rulesDir, "sql-style.md"), sqlData.sql_style_md);
+            }
+        }
+    }
+    catch {
+        // Non-fatal
+    }
+}
+/**
+ * Fetch the latest platform-owned Claude Code rules from the Hub and write
+ * them into the project's .claude/ directory. This keeps rules like
+ * data-fetching.md, query-performance.md, and skills up to date even in
+ * projects that were scaffolded months ago.
+ *
+ * Called from `deploy` (before uploading) and `pull` (after extracting).
+ * User-owned files (company-context.md, dashboard-context.md) are NOT
+ * touched — those sync via separate mechanisms.
+ */
+async function syncPlatformRules(targetDir, baseUrl, apiKey) {
+    try {
+        const res = await fetch(`${baseUrl}/api/platform-rules`, {
+            headers: { Authorization: `Bearer ${apiKey}` },
+        });
+        if (!res.ok)
+            return;
+        const data = (await res.json());
+        if (!data.files)
+            return;
+        let count = 0;
+        for (const [relPath, content] of Object.entries(data.files)) {
+            const fullPath = path.join(targetDir, ".claude", relPath);
+            fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+            fs.writeFileSync(fullPath, content);
+            count++;
+        }
+        if (count > 0) {
+            console.log(`  Platform rules synced (${count} files).`);
+        }
+    }
+    catch {
+        // Non-fatal — existing rules stay in place
+    }
+}
 /**
  * Recursively copies a template directory to a target directory, substituting
  * `{{KEY}}` placeholders in text files. Mirrors directory structure.
@@ -793,38 +893,10 @@ async function analysisNew(title) {
         PROJECT_SLUG: data.project_slug,
         DATE: today,
     });
-    // Pull project's company-context.md and any project-level rule overrides
-    // (best-effort, non-fatal — the template defaults are still in place if
-    // the network is down or the hub is unreachable).
+    // Pull hub-managed rules (company context + sql style override). Best-effort
+    // and non-fatal — template defaults stay in place if the hub is unreachable.
     const baseUrl = cfg.apiUrl.replace(/\/api$/, "");
-    const authHeader = { Authorization: `Bearer ${cfg.apiKey}` };
-    // Company context
-    try {
-        const ctxRes = await fetch(`${baseUrl}/api/projects/${data.project_slug}/context`, { headers: authHeader });
-        if (ctxRes.ok) {
-            const ctxData = (await ctxRes.json());
-            if (ctxData.context_md) {
-                fs.writeFileSync(path.join(targetDir, ".claude", "rules", "company-context.md"), ctxData.context_md);
-            }
-        }
-    }
-    catch {
-        // Non-fatal
-    }
-    // SQL style override — if the project has a custom version, replace the
-    // template default. If null/missing, the template default stays in place.
-    try {
-        const sqlRes = await fetch(`${baseUrl}/api/projects/${data.project_slug}/sql-style`, { headers: authHeader });
-        if (sqlRes.ok) {
-            const sqlData = (await sqlRes.json());
-            if (sqlData.sql_style_md) {
-                fs.writeFileSync(path.join(targetDir, ".claude", "rules", "sql-style.md"), sqlData.sql_style_md);
-            }
-        }
-    }
-    catch {
-        // Non-fatal
-    }
+    await syncHubManagedRules(targetDir, baseUrl, data.project_slug, cfg.apiKey);
     console.log(`  Analysis created: ${data.title}
   Slug:    ${data.slug}
   Project: ${data.project_slug}
@@ -965,6 +1037,11 @@ async function analysisPull(slug) {
             // Non-fatal
         }
     }
+    // Refresh hub-managed rule files after restoring from the bundle. The
+    // bundle contains whatever was set at publish time; this overwrites them
+    // with the latest hub state so company context and SQL style stay in
+    // sync across pulls. Best-effort and non-fatal.
+    await syncHubManagedRules(targetDir, baseUrl, projectSlug, cfg.apiKey);
     console.log(`
   Pulled "${analysisTitle}"
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@overscore/cli",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "CLI for deploying Overscore dashboards and publishing analyses",
   "bin": {
     "overscore": "dist/index.js"