@blocofy/cli 0.1.7 → 0.1.9

package/bin/blocofy.mjs

@@ -15,12 +15,12 @@ import { createInterface } from "node:readline/promises";
 import { credentialsPath, loadCredentials, saveCredentials } from "../lib/credentials.mjs";
 import { startDevServer } from "../lib/dev-server.mjs";
 import { readLocalTemplates } from "../lib/local-theme.mjs";
-import { githubNote } from "../lib/messages.mjs";
+import { githubNote, statusLine, syncScopeNote } from "../lib/messages.mjs";
 import { fetchDevSession, pullTheme, pushTheme } from "../lib/theme-sync.mjs";
 import { hyperlink, openUrl } from "../lib/term.mjs";
 import { isValidToken, isValidUrl, normalizeUrl } from "../lib/validate.mjs";
 
-const VERSION = "0.1.7";
+const VERSION = "0.1.9";
 const args = process.argv.slice(2);
 
 /** Parse `--key value` and `--flag` (boolean) arguments. */
@@ -58,8 +58,9 @@ Usage
         --port <n>   local port (default 3030)
         --no-sync    local preview only (skip draft sync + remote views)
 
-  blocofy theme pull [dir]
+  blocofy theme pull [dir] [--draft]
       Download the live theme to disk. (dir defaults to cwd)
+        --draft      pull the draft theme (what 'theme dev' syncs into) instead of live
 
   blocofy theme push [dir] [--draft]
       Write the local theme to the site (create/update; no delete).
@@ -148,11 +149,13 @@ function requireCreds() {
 }
 
 async function themePull(rest) {
+  const flags = parseFlags(rest);
   const positional = rest.filter((a) => !a.startsWith("--"));
   const dir = resolve(positional[0] ?? process.cwd());
   const creds = requireCreds();
-  const { count } = await pullTheme({ dir, url: creds.url, token: creds.token });
-  console.log(`Downloaded ${count} theme files → ${dir}`);
+  const draft = Boolean(flags.draft);
+  const { count } = await pullTheme({ dir, url: creds.url, token: creds.token, draft });
+  console.log(`Downloaded ${count} ${draft ? "draft" : "live"} theme files → ${dir}`);
 }
 
 async function themePush(rest) {
@@ -212,12 +215,22 @@ async function themeDev(rest) {
   console.log(`  (l) Local      ${hyperlink(localUrl)}`);
   if (previewUrl) console.log(`  (p) Preview    ${hyperlink(previewUrl)}`);
   if (editorUrl) console.log(`  (e) Editor     ${hyperlink(editorUrl)}`);
+
+  // Kalıcı durum satırı (#119 CLI bulgu #3): yerel hangi taslağa gidiyor + canlı tema.
+  const status = statusLine(session);
+  if (status) console.log(`\n  ${status}`);
+
   const keys = ["l local", previewUrl && "p preview", editorUrl && "e editor", "q quit"]
     .filter(Boolean)
     .join("   ");
   console.log(`\n  Press:  ${keys}`);
   console.log(`  Edit a theme file and save — every open view reloads automatically.\n`);
 
+  // Senkron kapsamı (#119 CLI bulgu #2): hangi dizinler taşınıyor / taşınmıyor —
+  // "config/pages senkronlanıyor sandım" karışıklığını açıkça önler.
+  for (const line of syncScopeNote()) console.log(`  ${line}`);
+  console.log("");
+
   // Düzlem uyarısı: CLI yalnız tema KODUNU taşır; editörde yapılan içerik/ayar
   // bulutta yaşar (githubNote → lib/messages.mjs, oturum durumuna göre uyarlanır).
   const note = githubNote(session);

package/lib/messages.mjs

@@ -3,6 +3,34 @@
  * CLI yalnız tema KODUNU taşır; editörde yapılan içerik/ayar bulutta yaşar.
  */
 
+import { THEME_DIRS } from "./local-theme.mjs";
+
+/**
+ * Senkron kapsamı (#119 CLI bulgu #2) — geliştiriciye AÇIKÇA hangi dizinlerin
+ * platforma taşındığını (tema kodu) ve hangilerinin taşınMADIĞINI (editör/bulut
+ * içeriği) söyler; "config/pages senkronlanıyor sandım" kafa karışıklığını önler.
+ * 2 satırlık dizi döner (saf → test edilebilir).
+ */
+export function syncScopeNote() {
+  const synced = [...THEME_DIRS].sort().map((d) => `${d}/`).join(" ");
+  return [
+    `Synced (theme code):  ${synced}`,
+    `Not synced (cloud):   config/ pages/ — edit these in the admin editor`,
+  ];
+}
+
+/**
+ * Kalıcı durum satırı (#119 CLI bulgu #3) — yerel dosyaların hangi taslak temaya
+ * gittiğini ve canlı temanın hangi instance olduğunu gösterir. Oturum yoksa null
+ * (local-only mod). `liveThemeId` yoksa "(none)".
+ */
+export function statusLine(session) {
+  if (!session) return null;
+  const draft = session.draftInstanceId != null ? `#${session.draftInstanceId}` : "—";
+  const live = session.liveThemeId != null ? `#${session.liveThemeId}` : "(none)";
+  return `Local files → Draft theme ${draft}    ·    Live theme → ${live}`;
+}
+
 /**
  * Dev oturumuna göre "düzlem" uyarısı döndürür (string), oturum yoksa null.
  * - GitHub bağlı → repo@branch + `git pull` ipucu.

package/lib/theme-sync.mjs

@@ -18,10 +18,16 @@ async function errorText(res) {
   }
 }
 
-/** Download the live theme to disk. `{ path: content }` (stripped) → `.liquid` files. */
-export async function pullTheme({ dir, url, token }) {
+/**
+ * Download a theme to disk. `{ path: content }` (stripped) → `.liquid` files.
+ * With `draft`, pulls the "CLI Draft" instance (what `theme dev` syncs into)
+ * instead of the live theme — symmetric with `push --draft`.
+ */
+export async function pullTheme({ dir, url, token, draft = false }) {
   const base = url.replace(/\/+$/, "");
-  const res = await fetch(`${base}/api/dev/theme`, { headers: { authorization: `Bearer ${token}` } });
+  const res = await fetch(`${base}/api/dev/theme${draft ? "?draft=1" : ""}`, {
+    headers: { authorization: `Bearer ${token}` },
+  });
   if (!res.ok) throw new Error(await errorText(res));
   const { files } = await res.json();
   let count = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blocofy/cli",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Develop your Blocofy theme locally against live data with instant preview — login, theme dev, pull, push.",
   "type": "module",
   "license": "MIT",