@flydocs/cli 0.6.0-alpha.33 → 0.6.0-alpha.35

package/dist/cli.js

@@ -15,7 +15,7 @@ var CLI_VERSION, CLI_NAME, PACKAGE_NAME, POSTHOG_API_KEY;
 var init_constants = __esm({
   "src/lib/constants.ts"() {
     "use strict";
-    CLI_VERSION = "0.6.0-alpha.33";
+    CLI_VERSION = "0.6.0-alpha.35";
     CLI_NAME = "flydocs";
     PACKAGE_NAME = "@flydocs/cli";
     POSTHOG_API_KEY = "phc_v1MSJTQDFkMS90CBh3mxIz3v8bYCCnKU6v1ir6bz0Xn";
@@ -1328,6 +1328,11 @@ async function scanDeprecated(targetDir) {
       found.push(item);
     }
   }
+  for (const file of DEPRECATED_CONTEXT_FILES) {
+    if (await pathExists(join10(targetDir, file))) {
+      found.push(file);
+    }
+  }
   for (const skill of DEPRECATED_SKILLS) {
     const p = join10(targetDir, ".claude", "skills", skill);
     if (await pathExists(p)) {
@@ -1413,6 +1418,17 @@ async function checkLegacyFolder(targetDir) {
   }
   return null;
 }
+async function autoCleanup(targetDir, paths) {
+  let cleaned = 0;
+  for (const p of paths) {
+    await rm3(join10(targetDir, p), { recursive: true, force: true });
+    cleaned++;
+  }
+  if (cleaned > 0) {
+    printStatus(`Cleaned ${cleaned} deprecated file(s)`);
+  }
+  return cleaned;
+}
 async function promptCleanup(targetDir, paths) {
   if (paths.length === 0) {
     printStatus("No deprecated files found");
@@ -1436,7 +1452,7 @@ async function promptCleanup(targetDir, paths) {
     printStatus(`Deleted: ${p}`);
   }
 }
-var DEPRECATED_DIRS, DEPRECATED_FILES, DEPRECATED_SKILLS, DEPRECATED_RULES_DIR, DEPRECATED_FLYDOCS_DIRS, DEPRECATED_HOOKS, DEPRECATED_CURSOR_RULES, DEPRECATED_CURSOR_RULE_DIRS, DEPRECATED_COMMANDS;
+var DEPRECATED_DIRS, DEPRECATED_FILES, DEPRECATED_CONTEXT_FILES, DEPRECATED_SKILLS, DEPRECATED_RULES_DIR, DEPRECATED_FLYDOCS_DIRS, DEPRECATED_HOOKS, DEPRECATED_CURSOR_RULES, DEPRECATED_CURSOR_RULE_DIRS, DEPRECATED_COMMANDS;
 var init_deprecated = __esm({
   "src/lib/deprecated.ts"() {
     "use strict";
@@ -1444,6 +1460,11 @@ var init_deprecated = __esm({
     init_ui();
     DEPRECATED_DIRS = [".docflow", "docflow"];
     DEPRECATED_FILES = ["AGENTS.md.bak", ".cursor/mcp.json"];
+    DEPRECATED_CONTEXT_FILES = [
+      "flydocs/context/overview.md",
+      "flydocs/context/stack.md",
+      "flydocs/context/standards.md"
+    ];
     DEPRECATED_SKILLS = [
       "linear-workflow",
       "session-workflow",
@@ -3027,11 +3048,11 @@ async function fetchTemplates(apiKey, sinceVersion, workspaceId) {
   }
   return await response.json();
 }
-async function fetchArtifacts(apiKey, sinceVersion) {
+async function fetchArtifacts(apiKey, sinceVersion, workspaceId) {
   const baseUrl = resolveRelayUrl();
   const response = await fetch(`${baseUrl}/artifacts?since=${sinceVersion}`, {
     method: "GET",
-    headers: headers(apiKey),
+    headers: headers(apiKey, workspaceId),
     signal: AbortSignal.timeout(3e4)
   });
   if (!response.ok) {
@@ -3044,23 +3065,6 @@ async function fetchArtifacts(apiKey, sinceVersion) {
   }
   return await response.json();
 }
-async function fetchAgentConfigs(apiKey, workspaceId) {
-  const baseUrl = resolveRelayUrl();
-  const response = await fetch(`${baseUrl}/artifacts/agent-configs`, {
-    method: "GET",
-    headers: headers(apiKey, workspaceId),
-    signal: AbortSignal.timeout(15e3)
-  });
-  if (!response.ok) {
-    const body = await response.text().catch(() => "");
-    throw new RelayError(
-      `agent-configs fetch failed (${response.status})`,
-      response.status,
-      body
-    );
-  }
-  return await response.json();
-}
 async function triggerScan(apiKey, repoName, options) {
   const baseUrl = resolveRelayUrl();
   const body = {
@@ -3191,7 +3195,7 @@ function isPathSkipped(artifactPath, skipPaths) {
   );
 }
 async function syncArtifacts(targetDir, apiKey, workspaceId, currentVersion, skipPaths = []) {
-  const response = await fetchArtifacts(apiKey, currentVersion);
+  const response = await fetchArtifacts(apiKey, currentVersion, workspaceId);
   if (response.artifacts.length === 0) {
     return { written: 0, skipped: 0, version: currentVersion };
   }
@@ -3213,23 +3217,6 @@ async function syncArtifacts(targetDir, apiKey, workspaceId, currentVersion, ski
   }
   return { written, skipped, version: response.version };
 }
-async function syncAgentConfigs(targetDir, apiKey, workspaceId, skipPaths = []) {
-  const response = await fetchAgentConfigs(apiKey, workspaceId);
-  let written = 0;
-  for (const file of response.files) {
-    if (skipPaths.length > 0 && isPathSkipped(file.path, skipPaths)) {
-      continue;
-    }
-    const filePath = join19(targetDir, file.path);
-    await mkdir9(dirname3(filePath), { recursive: true });
-    await writeFile11(filePath, file.content, "utf-8");
-    written++;
-  }
-  if (written > 0) {
-    printStatus(`Wrote ${written} agent config(s) (CLAUDE.md, AGENTS.md)`);
-  }
-  return written;
-}
 async function writeArtifact(targetDir, artifact) {
   const filePath = join19(targetDir, artifact.path);
   await mkdir9(dirname3(filePath), { recursive: true });
@@ -3271,25 +3258,6 @@ async function syncAllArtifacts(targetDir, apiKey, workspaceId, currentArtifactV
       printWarning("Artifact sync failed. Will retry on next sync.");
     }
   }
-  try {
-    const configCount = await syncAgentConfigs(
-      targetDir,
-      apiKey,
-      workspaceId,
-      skipPaths
-    );
-    if (configCount > 0) {
-      changes.push(`Wrote ${configCount} agent config(s)`);
-    }
-  } catch (err) {
-    if (err instanceof RelayError) {
-      printWarning(
-        `Could not fetch agent configs (${err.status}). Will retry on next sync.`
-      );
-    } else {
-      printWarning("Agent config sync failed. Will retry on next sync.");
-    }
-  }
   return { artifactVersion, changes };
 }
 var init_artifacts = __esm({
@@ -3938,7 +3906,14 @@ __export(init_exports, {
   default: () => init_default
 });
 import { defineCommand as defineCommand4 } from "citty";
-import { text as text2, confirm as confirm3, select as select2, isCancel as isCancel4, cancel as cancel3 } from "@clack/prompts";
+import {
+  text as text2,
+  confirm as confirm3,
+  select as select2,
+  multiselect as multiselect2,
+  isCancel as isCancel4,
+  cancel as cancel3
+} from "@clack/prompts";
 import pc9 from "picocolors";
 import { join as join24 } from "path";
 import { mkdir as mkdir12, writeFile as writeFile16 } from "fs/promises";
@@ -4309,19 +4284,61 @@ async function isParentDirectory(dir) {
 }
 async function runMultiRepoInit(parentDir, keyArg) {
   const repos = await detectSiblingRepos(parentDir);
-  const repoNames = Object.keys(repos).sort();
-  printInfo(`Detected ${repoNames.length} repos:`);
-  for (const name of repoNames) {
-    console.log(`    ${pc9.cyan(name)}`);
-  }
+  const allRepoNames = Object.keys(repos).sort();
+  printInfo(`Detected ${allRepoNames.length} repos:`);
   console.log();
-  const shouldContinue = await confirm3({
-    message: `Initialize all ${repoNames.length} repos?`
+  const existingInstalls = [];
+  for (const name of allRepoNames) {
+    const repoDir = join24(parentDir, name);
+    const hasSkills = await pathExists(join24(repoDir, ".claude", "skills"));
+    const hasConfig = await pathExists(
+      join24(repoDir, ".flydocs", "config.json")
+    );
+    if (hasSkills && hasConfig) {
+      existingInstalls.push(name);
+    }
+  }
+  if (existingInstalls.length > 0) {
+    printWarning(
+      `${existingInstalls.length} repo(s) have existing single-repo FlyDocs installs:`
+    );
+    for (const name of existingInstalls) {
+      console.log(`    ${pc9.yellow(name)}`);
+    }
+    console.log();
+    console.log(`  Multi-repo init will migrate these to workspace mode:`);
+    console.log(
+      `  ${pc9.dim("- IDE configs (skills, hooks, commands) move to workspace root")}`
+    );
+    console.log(
+      `  ${pc9.dim("- Per-repo context (project.md, service.json) preserved")}`
+    );
+    console.log(
+      `  ${pc9.dim("- Existing IDE configs archived to flydocs/knowledge/archived/")}`
+    );
+    console.log();
+  }
+  const selectedRepos = await multiselect2({
+    message: "Which repos would you like to initialize?",
+    options: allRepoNames.map((name) => ({
+      value: name,
+      label: name,
+      hint: existingInstalls.includes(name) ? "has existing install" : void 0
+    })),
+    initialValues: allRepoNames,
+    required: true
   });
-  if (isCancel4(shouldContinue) || !shouldContinue) {
+  if (isCancel4(selectedRepos)) {
     cancel3("Init cancelled.");
     process.exit(0);
   }
+  const repoNames = selectedRepos;
+  if (repoNames.length === 0) {
+    cancel3("No repos selected.");
+    process.exit(0);
+  }
+  printInfo(`Initializing ${repoNames.length} of ${allRepoNames.length} repos`);
+  console.log();
   const firstRepoDir = join24(parentDir, repoNames[0]);
   const { apiKey, workspaceId } = await resolveAndValidateKey(
     keyArg,
@@ -4380,9 +4397,13 @@ async function runMultiRepoInit(parentDir, keyArg) {
     if (existing) {
       allSkipped.push(".flydocs-workspace.json (already exists)");
     } else {
+      const selectedRepoEntries = {};
+      for (const name of repoNames) {
+        if (repos[name]) selectedRepoEntries[name] = repos[name];
+      }
       const workspaceFile = buildWorkspaceFile(
         firstResponse.workspaceId,
-        repos
+        selectedRepoEntries
       );
       await writeWorkspaceFile(parentDir, workspaceFile);
       allActions.push(`.flydocs-workspace.json (${repoNames.length} repos)`);
@@ -4799,7 +4820,10 @@ async function runSync(targetDir) {
   }
   let serverResponse;
   try {
-    serverResponse = await fetchConfigV2(apiKey, { workspaceId });
+    serverResponse = await fetchConfigV2(apiKey, {
+      workspaceId,
+      includeContext: true
+    });
   } catch (err) {
     if (err instanceof RelayError) {
       printWarning(`Server unavailable (${err.status}), using cached config.`);
@@ -4910,6 +4934,33 @@ async function runSync(targetDir) {
       changes.push(`Deleted ${conflicts.deleted} non-core skill(s)`);
     }
   }
+  const deprecated = await scanDeprecated(targetDir);
+  if (deprecated.length > 0) {
+    const cleaned = await autoCleanup(targetDir, deprecated);
+    changes.push(`Removed ${cleaned} deprecated file(s)`);
+  }
+  if (serverResponse.context?.projectMd) {
+    const { writeFile: fsWriteFile } = await import("fs/promises");
+    const contextDir = join26(targetDir, "flydocs", "context");
+    await mkdir14(contextDir, { recursive: true });
+    await fsWriteFile(
+      join26(contextDir, "project.md"),
+      serverResponse.context.projectMd,
+      "utf-8"
+    );
+    changes.push("Updated flydocs/context/project.md from server");
+  }
+  if (serverResponse.context?.serviceJson) {
+    const { writeFile: fsWriteFile } = await import("fs/promises");
+    const contextDir = join26(targetDir, "flydocs", "context");
+    await mkdir14(contextDir, { recursive: true });
+    await fsWriteFile(
+      join26(contextDir, "service.json"),
+      JSON.stringify(serverResponse.context.serviceJson, null, 2) + "\n",
+      "utf-8"
+    );
+    changes.push("Updated flydocs/context/service.json from server");
+  }
   await migrateGitignore(targetDir);
   return changes;
 }
@@ -4938,10 +4989,11 @@ var init_sync = __esm({
     init_workspace();
     init_relay_client();
     init_skill_conflicts();
+    init_deprecated();
     sync_default = defineCommand5({
       meta: {
         name: "sync",
-        description: "Pull latest config and templates from server"
+        description: "Sync files from server (alias for update)"
       },
       args: {
         path: {
@@ -4952,6 +5004,7 @@ var init_sync = __esm({
       async run({ args }) {
         const targetDir = args.path ?? process.cwd();
         console.log();
+        printInfo("Note: flydocs sync is now an alias for flydocs update");
         const changes = await runSync(targetDir);
         if (changes.length === 0) {
           printStatus("Already up to date.");
@@ -5001,7 +5054,7 @@ var init_update = __esm({
     update_default = defineCommand6({
       meta: {
         name: "update",
-        description: "Update an existing FlyDocs installation"
+        description: "Update CLI and sync all managed files from server"
       },
       args: {
         path: {
@@ -5157,10 +5210,6 @@ var init_update = __esm({
                   printStatus(change);
                 }
               }
-              console.log();
-              console.log(
-                `  ${pc11.dim("Tip: use")} ${pc11.cyan("flydocs sync")} ${pc11.dim("for file-only refresh (no CLI update).")}`
-              );
               await capture("update_completed", {
                 current_version: currentVersion,
                 version,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flydocs/cli",
-  "version": "0.6.0-alpha.33",
+  "version": "0.6.0-alpha.35",
   "type": "module",
   "description": "FlyDocs AI CLI — install, setup, and manage FlyDocs projects",
   "bin": {

package/template/.flydocs/config.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.6.0-alpha.33",
+  "version": "0.6.0-alpha.35",
   "sourceRepo": "github.com/plastrlab/flydocs-core",
   "tier": "local",
   "setupComplete": false,

package/template/.flydocs/version

@@ -1 +1 @@
-0.6.0-alpha.33
+0.6.0-alpha.35

package/template/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.6.0-alpha.33",
+  "version": "0.6.0-alpha.35",
   "description": "FlyDocs Core - Manifest of all managed files",
   "repository": "github.com/plastrlab/flydocs-core",