@overscore/cli 0.11.7 → 0.11.11

package/dist/index.js

@@ -1171,6 +1171,9 @@ async function syncHubManagedRules(targetDir, baseUrl, projectSlug, apiKey) {
     catch {
         // Non-fatal
     }
+    // Platform rules (skills, capabilities) — same sync that dashboard pull/deploy gets.
+    await syncPlatformRules(targetDir, baseUrl, apiKey);
+    syncClaudeMdImports(targetDir);
 }
 /**
  * Sync the project knowledge base from the Hub into .claude/knowledge/.
@@ -1259,15 +1262,49 @@ async function uploadKnowledgeBase(targetDir, baseUrl, projectSlug, apiKey) {
         // Non-fatal
     }
 }
+const DASHBOARD_IMPORTS = [
+    "@.claude/rules/this-dashboard.md",
+    "@.claude/knowledge/INDEX.md",
+    "@.claude/platform-capabilities.md",
+];
+const ANALYSIS_IMPORTS = [
+    "@this-analysis.md",
+    "@.claude/knowledge/INDEX.md",
+    "@.claude/platform-capabilities.md",
+];
+/**
+ * Ensures the project's CLAUDE.md has the standard @import lines at the top.
+ * Detects dashboard vs analysis by reading the CLAUDE.md heading. Injects only
+ * what's missing — never overwrites existing content. Returns true if modified.
+ */
+function syncClaudeMdImports(targetDir) {
+    const claudeMdPath = path.join(targetDir, ".claude", "CLAUDE.md");
+    if (!fs.existsSync(claudeMdPath))
+        return false;
+    const content = fs.readFileSync(claudeMdPath, "utf-8");
+    const firstHeading = content.match(/^#\s+Overscore\s+(Dashboard|Analysis)/im);
+    if (!firstHeading)
+        return false;
+    const isAnalysis = firstHeading[1].toLowerCase() === "analysis";
+    const requiredImports = isAnalysis ? ANALYSIS_IMPORTS : DASHBOARD_IMPORTS;
+    const missing = requiredImports.filter((imp) => !content.includes(imp));
+    if (missing.length === 0)
+        return false;
+    // Inject missing imports right after the first # heading line
+    const lines = content.split("\n");
+    const headingIdx = lines.findIndex((l) => l.startsWith("# "));
+    if (headingIdx === -1)
+        return false;
+    lines.splice(headingIdx + 1, 0, "", ...missing);
+    const updated = lines.join("\n").replace(/\n{3,}/g, "\n\n");
+    fs.writeFileSync(claudeMdPath, updated);
+    return true;
+}
 /**
  * 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, this-dashboard.md, knowledge/)
- * are NOT touched — those sync via separate mechanisms.
+ * them into the project's .claude/ directory. Called from `deploy` (before
+ * uploading), `pull` (after extracting), and `syncHubManagedRules` (analysis
+ * paths). User-owned files (knowledge/, this-dashboard.md) are NOT touched.
  */
 async function syncPlatformRules(targetDir, baseUrl, apiKey) {
     try {
@@ -1286,14 +1323,85 @@ async function syncPlatformRules(targetDir, baseUrl, apiKey) {
             fs.writeFileSync(fullPath, content);
             count++;
         }
-        if (count > 0) {
-            console.log(`  Platform rules synced (${count} files).`);
+        const claudeUpdated = syncClaudeMdImports(targetDir);
+        const total = count + (claudeUpdated ? 1 : 0);
+        if (total > 0) {
+            console.log(`  Platform rules synced (${count} files${claudeUpdated ? " + CLAUDE.md updated" : ""}).`);
         }
     }
     catch {
         // Non-fatal — existing rules stay in place
     }
 }
+/**
+ * Explicit on-demand platform rules sync. Reports what changed so Claude
+ * can tell the user what's new. Called by `npx @overscore/cli platform update`.
+ */
+async function platformUpdate() {
+    const { apiUrl, apiKey } = await loadEnv();
+    const baseUrl = apiUrl.replace(/\/api$/, "");
+    console.log("\n  Syncing platform rules from Hub...\n");
+    const capPath = path.resolve(process.cwd(), ".claude", "platform-capabilities.md");
+    const prevContent = fs.existsSync(capPath) ? fs.readFileSync(capPath, "utf-8") : null;
+    const prevVersion = prevContent?.match(/^version:\s*(.+)$/m)?.[1]?.trim() ?? null;
+    const res = await fetch(`${baseUrl}/api/projects/platform-rules`, {
+        headers: { Authorization: `Bearer ${apiKey}` },
+    });
+    if (!res.ok) {
+        console.error(`\n  Error: Could not reach Hub (HTTP ${res.status})\n`);
+        process.exit(1);
+    }
+    const data = (await res.json());
+    if (!data.files) {
+        console.error("\n  Error: No files in platform-rules response.\n");
+        process.exit(1);
+    }
+    const updated = [];
+    for (const [relPath, content] of Object.entries(data.files)) {
+        const fullPath = path.join(process.cwd(), ".claude", relPath);
+        const existing = fs.existsSync(fullPath) ? fs.readFileSync(fullPath, "utf-8") : null;
+        fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+        fs.writeFileSync(fullPath, content);
+        if (existing !== content)
+            updated.push(relPath);
+    }
+    const claudeUpdated = syncClaudeMdImports(process.cwd());
+    if (claudeUpdated)
+        updated.push(".claude/CLAUDE.md (@imports updated)");
+    if (updated.length === 0) {
+        console.log("  Already up to date — no changes.\n");
+        return;
+    }
+    console.log(`  Updated ${updated.length} file${updated.length === 1 ? "" : "s"}:\n`);
+    for (const f of updated)
+        console.log(`    ${f}`);
+    if (updated.includes("platform-capabilities.md")) {
+        const newContent = data.files["platform-capabilities.md"];
+        const newVersion = newContent.match(/^version:\s*(.+)$/m)?.[1]?.trim() ?? "unknown";
+        if (prevVersion && prevVersion !== newVersion) {
+            console.log(`\n  Capabilities updated: ${prevVersion} → ${newVersion}`);
+            const changelog = extractChangelogSince(newContent, prevVersion);
+            if (changelog)
+                console.log(`\n  What's new:\n\n${changelog}`);
+        }
+        else if (!prevVersion) {
+            console.log(`\n  Platform capabilities synced (v${newVersion}).`);
+            console.log(`  Re-read .claude/platform-capabilities.md in your Claude session to see available commands.`);
+        }
+    }
+    console.log();
+}
+function extractChangelogSince(content, sinceVersion) {
+    const match = content.match(/## Changelog\n([\s\S]*?)(?=\n## |\s*$)/);
+    if (!match)
+        return null;
+    const blocks = match[1].split(/(?=### )/);
+    const newer = blocks.filter((b) => {
+        const v = b.match(/### (\d{4}-\d{2}-\d{2})/)?.[1];
+        return v && v > sinceVersion;
+    });
+    return newer.length ? newer.join("").trim() : null;
+}
 /**
  * Recursively copies a template directory to a target directory, substituting
  * `{{KEY}}` placeholders in text files. Mirrors directory structure.
@@ -1616,6 +1724,9 @@ async function analysisPublish() {
     console.log(`\n    URL: ${data.url}\n`);
     // Upload knowledge base so insights from this analysis persist
     await uploadKnowledgeBase(process.cwd(), baseUrl, meta.project_slug, cfg.apiKey);
+    // Sync platform rules so skills and capabilities stay current
+    await syncPlatformRules(process.cwd(), baseUrl, cfg.apiKey);
+    syncClaudeMdImports(process.cwd());
 }
 /**
  * Ensure analysis.json has a valid id by fetching from the Hub.
@@ -2281,6 +2392,22 @@ else if (command === "analysis") {
 `);
     }
 }
+else if (command === "platform") {
+    if (subcommand === "update") {
+        platformUpdate();
+    }
+    else {
+        console.log(`
+  overscore platform — Manage platform rules and capabilities
+
+  Commands:
+    update    Sync latest platform rules, skills, and capabilities from Hub
+
+  Example:
+    npx @overscore/cli platform update
+`);
+    }
+}
 else if (command === "query") {
     if (subcommand === "list") {
         queryList();
@@ -2339,6 +2466,7 @@ else {
     pull <slug>            Pull source code from the hub
     versions               List deploy history
     query <subcommand>     Manage dashboard queries
+    platform <subcommand>  Sync platform rules and capabilities
     analysis <subcommand>  Manage analyses (frozen investigations)
     install-skills         Install the Overscore skill library into ~/.claude/skills/
 
@@ -2350,6 +2478,7 @@ else {
     npx @overscore/cli pull <slug>
     npx @overscore/cli pull <slug> --version 3
     npx @overscore/cli versions
+    npx @overscore/cli platform update
     npx @overscore/cli query list
     npx @overscore/cli query add <name> "<sql>"
     npx @overscore/cli query update <name> "<sql>"

package/package.json

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

package/templates/analysis/.claude/CLAUDE.md

@@ -2,6 +2,7 @@
 
 @this-analysis.md
 @.claude/knowledge/INDEX.md
+@.claude/platform-capabilities.md
 
 This is an **Overscore Analysis** — a one-off, frozen investigation that produces a single self-contained `report.html` you can share in Slack and reopen later to refresh.