@overscore/cli 0.13.16 → 0.13.18

package/dist/index.js

@@ -1155,6 +1155,7 @@ async function listDashboards() {
     }
     const data = (await res.json());
     console.log(`\n  ${data.project} (${data.project_slug})\n`);
+    console.log("  Showing one project — run 'overscore projects' to list them all.\n");
     if (data.dashboards.length === 0) {
         console.log("  No dashboards yet.\n");
         return;
@@ -1173,6 +1174,65 @@ async function listDashboards() {
         console.log();
     }
 }
+// Account-level project list. Uses the CLI DEVICE token (ocli_) rather than a
+// project-scoped API key, so it can enumerate EVERY project on the account —
+// including empty ones a project key could never see.
+async function listProjects() {
+    const configPath = path.join(process.env.HOME || "", ".overscore", "config");
+    const readToken = () => {
+        const cfg = fs.existsSync(configPath)
+            ? parseEnv(fs.readFileSync(configPath, "utf-8"))
+            : {};
+        return cfg.OVERSCORE_DEVICE_TOKEN;
+    };
+    let deviceToken = readToken();
+    if (!deviceToken) {
+        console.log("\n  No session found. Launching browser login...\n");
+        await authLogin();
+        deviceToken = readToken();
+        if (!deviceToken) {
+            console.error("\n  Could not authenticate.\n");
+            process.exit(1);
+        }
+    }
+    for (let attempt = 0; attempt < 2; attempt++) {
+        const res = await fetch(`${HUB_URL}/api/projects`, {
+            headers: { Authorization: `Bearer ${deviceToken}` },
+        });
+        if (res.ok) {
+            const { projects } = (await res.json());
+            printProjects(projects);
+            return;
+        }
+        // Device token expired — re-auth once, then retry.
+        if (res.status === 401 && attempt === 0) {
+            console.log("\n  Session expired. Launching browser login...\n");
+            await authLogin();
+            deviceToken = readToken();
+            if (!deviceToken)
+                break;
+            continue;
+        }
+        const body = (await res.json().catch(() => ({})));
+        console.error(`\n  Error: ${body.error || `HTTP ${res.status}`}\n`);
+        process.exit(1);
+    }
+    console.error("\n  Could not authenticate.\n");
+    process.exit(1);
+}
+function printProjects(projects) {
+    if (!projects.length) {
+        console.log("\n  No projects yet.\n\n    Create one:  npx create-overscore --dashboard <name> --project <slug>\n");
+        return;
+    }
+    console.log(`\n  Your projects (${projects.length})\n`);
+    for (const p of projects) {
+        const count = p.dashboard_count === 1 ? "1 dashboard" : `${p.dashboard_count} dashboards`;
+        console.log(`  ${p.name}`);
+        console.log(`    slug: ${p.slug}  ·  ${count}  ·  ${p.role}`);
+        console.log();
+    }
+}
 function collectFiles(dir, prefix) {
     const files = [];
     for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
@@ -1581,6 +1641,123 @@ function syncClaudeMdImports(targetDir) {
     fs.writeFileSync(claudeMdPath, updated);
     return true;
 }
+/** Recursively copy a directory (files + subdirs), overwriting at the destination. */
+function copyDirRecursive(src, dest) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+        const s = path.join(src, entry.name);
+        const d = path.join(dest, entry.name);
+        if (entry.isDirectory())
+            copyDirRecursive(s, d);
+        else if (entry.isFile())
+            fs.copyFileSync(s, d);
+    }
+}
+/**
+ * Derive a cross-tool AGENTS.md from an existing .claude/CLAUDE.md. Codex,
+ * Cursor, Copilot, and Gemini read AGENTS.md but do NOT resolve Claude Code's
+ * `@import` lines, so the leading @import block becomes prose "read when
+ * relevant" pointers, a reference-guides list of .claude/rules/*.md is added,
+ * and the rest of the CLAUDE.md body is kept verbatim. Returns null if the
+ * CLAUDE.md doesn't look like an Overscore artifact.
+ */
+function deriveAgentsMdFromClaudeMd(targetDir, content) {
+    const lines = content.split("\n");
+    const headingIdx = lines.findIndex((l) => /^#\s+Overscore\s+(Dashboard|Analysis)/i.test(l));
+    if (headingIdx === -1)
+        return null;
+    // The @import lines follow the heading (blank lines allowed between); the
+    // first other non-blank line begins the body.
+    const importTargets = [];
+    let bodyStart = headingIdx + 1;
+    for (let i = headingIdx + 1; i < lines.length; i++) {
+        const t = lines[i].trim();
+        if (t === "") {
+            bodyStart = i + 1;
+            continue;
+        }
+        if (t.startsWith("@")) {
+            importTargets.push(t.slice(1));
+            bodyStart = i + 1;
+            continue;
+        }
+        bodyStart = i;
+        break;
+    }
+    const body = lines.slice(bodyStart).join("\n").replace(/^\n+/, "");
+    const memBullets = importTargets.length
+        ? importTargets.map((p) => `- **${p}** — load when relevant to your task.`).join("\n")
+        : "- (this project has no shared context files yet)";
+    // Reference guides: every .claude/rules/*.md except the per-artifact memory
+    // file (already listed above as a memory pointer).
+    const memBasenames = new Set(importTargets.map((p) => path.basename(p)));
+    const rulesDir = path.join(targetDir, ".claude", "rules");
+    let refBlock = "";
+    if (fs.existsSync(rulesDir)) {
+        const ruleFiles = fs
+            .readdirSync(rulesDir)
+            .filter((f) => f.endsWith(".md") &&
+            !memBasenames.has(f) &&
+            f !== "this-dashboard.md" &&
+            f !== "this-analysis.md")
+            .sort();
+        if (ruleFiles.length > 0) {
+            refBlock =
+                "\n## Reference guides — read the relevant one when the task calls for it\n\n" +
+                    "This project's authoring rules live in these files. Read the relevant one on demand; you don't need to read them all every session.\n\n" +
+                    ruleFiles.map((f) => `- **.claude/rules/${f}**`).join("\n") +
+                    "\n";
+        }
+    }
+    return `${lines[headingIdx]}
+
+## Project instructions and memory
+
+This project keeps its context in Markdown files. You don't need to read all of them every session; load the ones relevant to your task:
+
+${memBullets}
+${refBlock}
+${body}`;
+}
+/**
+ * Ensure the cross-tool layout (Codex / Cursor / Copilot / Gemini) exists
+ * alongside Claude Code's .claude/:
+ *   - .agents/skills/ — the cross-tool Agent Skills location, mirrored from
+ *     .claude/skills so it stays current as the Hub OTA updates skills.
+ *   - AGENTS.md — a root instruction file derived from .claude/CLAUDE.md,
+ *     created only if one doesn't already exist (never clobbers user edits).
+ * This is what retrofits an existing (Claude-only) project for Codex on the
+ * next deploy / pull / `platform update`. Returns paths newly created, for
+ * reporting. Best-effort: never throws.
+ */
+function ensureCodexLayout(targetDir) {
+    const created = [];
+    try {
+        const claudeSkills = path.join(targetDir, ".claude", "skills");
+        if (fs.existsSync(claudeSkills)) {
+            const agentsSkills = path.join(targetDir, ".agents", "skills");
+            const existed = fs.existsSync(agentsSkills);
+            // Re-mirror every sync so new/updated skills propagate; only report the
+            // first-time creation to keep steady-state syncs quiet.
+            copyDirRecursive(claudeSkills, agentsSkills);
+            if (!existed)
+                created.push(".agents/skills/");
+        }
+        const agentsMdPath = path.join(targetDir, "AGENTS.md");
+        const claudeMdPath = path.join(targetDir, ".claude", "CLAUDE.md");
+        if (!fs.existsSync(agentsMdPath) && fs.existsSync(claudeMdPath)) {
+            const agents = deriveAgentsMdFromClaudeMd(targetDir, fs.readFileSync(claudeMdPath, "utf-8"));
+            if (agents) {
+                fs.writeFileSync(agentsMdPath, agents);
+                created.push("AGENTS.md");
+            }
+        }
+    }
+    catch {
+        // Non-fatal — cross-tool layout is best-effort.
+    }
+    return created;
+}
 function platformMetaPath(targetDir) {
     return path.join(targetDir, ".claude", ".platform-meta.json");
 }
@@ -1696,8 +1873,14 @@ async function syncPlatformRules(targetDir, baseUrl, apiKey) {
         }
         writePlatformMeta(targetDir, meta);
         const claudeUpdated = syncClaudeMdImports(targetDir);
-        if (written.length > 0 || claudeUpdated) {
-            console.log(`  Platform rules synced (${written.length} file${written.length === 1 ? "" : "s"}${claudeUpdated ? " + CLAUDE.md updated" : ""}).`);
+        const codexCreated = ensureCodexLayout(targetDir);
+        if (written.length > 0 || claudeUpdated || codexCreated.length > 0) {
+            const extras = [];
+            if (claudeUpdated)
+                extras.push("CLAUDE.md updated");
+            if (codexCreated.length > 0)
+                extras.push(codexCreated.join(" + ") + " added for Codex");
+            console.log(`  Platform rules synced (${written.length} file${written.length === 1 ? "" : "s"}${extras.length ? " + " + extras.join(" + ") : ""}).`);
         }
         if (preserved.length > 0) {
             console.log(`  Preserved ${preserved.length} locally-modified file${preserved.length === 1 ? "" : "s"} (Hub updates skipped):`);
@@ -1784,11 +1967,23 @@ async function platformUpdate(checkOnly = false, force = false) {
         }
         if (claudeWouldChange)
             updated.push(".claude/CLAUDE.md (@imports would be added)");
+        // Cross-tool (Codex/Cursor/Copilot/Gemini) layout a real run would create.
+        if (!fs.existsSync(path.join(process.cwd(), "AGENTS.md")) &&
+            fs.existsSync(path.join(process.cwd(), ".claude", "CLAUDE.md"))) {
+            updated.push("AGENTS.md (would be created for Codex/cross-tool)");
+        }
+        if (fs.existsSync(path.join(process.cwd(), ".claude", "skills")) &&
+            !fs.existsSync(path.join(process.cwd(), ".agents", "skills"))) {
+            updated.push(".agents/skills/ (would be created for Codex/cross-tool)");
+        }
     }
     else {
         const claudeUpdated = syncClaudeMdImports(process.cwd());
         if (claudeUpdated)
             updated.push(".claude/CLAUDE.md (@imports updated)");
+        for (const p of ensureCodexLayout(process.cwd())) {
+            updated.push(`${p} (created for Codex/cross-tool)`);
+        }
     }
     if (updated.length === 0 && preserved.length === 0) {
         console.log("  Already up to date — no changes.\n");
@@ -2917,6 +3112,9 @@ else if (command === "versions") {
 else if (command === "list") {
     listDashboards();
 }
+else if (command === "projects") {
+    listProjects();
+}
 else if (command === "install-skills") {
     installSkills();
 }
@@ -3081,6 +3279,7 @@ else {
     auth logout            Remove saved credentials
     dev                    Start the dev server (injects auth automatically)
     list                   List all dashboards in the project
+    projects               List every project on your account
     deploy                 Build and deploy the dashboard
     pull <slug>            Pull source code from the hub
     versions               List deploy history
@@ -3093,6 +3292,7 @@ else {
     npx @overscore/cli auth login
     npx @overscore/cli dev
     npx @overscore/cli list
+    npx @overscore/cli projects
     npx @overscore/cli deploy --message "description"
     npx @overscore/cli pull <slug>
     npx @overscore/cli pull <slug> --version 3

package/package.json

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