@cccarv82/freya 1.0.3 → 1.0.4

package/README.md

@@ -58,6 +58,23 @@ freya init meu-projeto  # cria ./meu-projeto
 freya init --here       # instala no diretório atual
 ```
 
+### Atualizar uma workspace existente (sem perder dados)
+Por padrão, ao rodar `init` em uma pasta existente, o CLI **preserva**:
+- `data/**`
+- `logs/**`
+
+E atualiza/instala normalmente:
+- `.agent/**`
+- `scripts/**`
+- `README.md`, `USER_GUIDE.md`
+- `package.json` (merge de scripts)
+
+Flags (use com cuidado):
+```bash
+freya init --here --force-data   # permite sobrescrever data/
+freya init --here --force-logs   # permite sobrescrever logs/
+```
+
 ## 🚀 Como Usar
 
 1.  Abra a pasta da workspace gerada (ex.: `./freya`) na **sua IDE**.

package/cli/index.js

@@ -9,15 +9,18 @@ function usage() {
 freya - F.R.E.Y.A. CLI
 
 Usage:
-  freya init [dir] [--force] [--here|--in-place]
+  freya init [dir] [--force] [--here|--in-place] [--force-data] [--force-logs]
 
 Defaults:
   - If no [dir] is provided, creates ./freya
+  - Preserves existing data/ and logs/ by default
 
 Examples:
   freya init              # creates ./freya
   freya init my-workspace # creates ./my-workspace
   freya init --here       # installs into current directory
+  freya init --here --force          # update agents/scripts, keep data/logs
+  freya init --here --force-data     # overwrite data/ too (danger)
   npx @cccarv82/freya init
 `;
 }
@@ -49,8 +52,12 @@ async function run(argv) {
     const targetDir = args[1]
       ? path.resolve(process.cwd(), args[1])
       : (inPlace ? process.cwd() : defaultDir);
+
     const force = flags.has('--force');
-    await cmdInit({ targetDir, force });
+    const forceData = flags.has('--force-data');
+    const forceLogs = flags.has('--force-logs');
+
+    await cmdInit({ targetDir, force, forceData, forceLogs });
     return;
   }
 

package/cli/init.js

@@ -36,14 +36,35 @@ function copyFile(src, dest, force) {
   return { copied: true };
 }
 
-function copyDirRecursive(srcDir, destDir, force, summary) {
+function isNonEmptyDir(dir) {
+  try {
+    const entries = fs.readdirSync(dir);
+    // ignore common empty markers
+    const meaningful = entries.filter((e) => e !== '.DS_Store');
+    return meaningful.length > 0;
+  } catch {
+    return false;
+  }
+}
+
+function copyDirRecursive(srcDir, destDir, force, summary, options = {}) {
   const entries = fs.readdirSync(srcDir, { withFileTypes: true });
   for (const ent of entries) {
     const src = path.join(srcDir, ent.name);
     const dest = path.join(destDir, ent.name);
 
+    // Preserve user state by default
     if (ent.isDirectory()) {
-      copyDirRecursive(src, dest, force, summary);
+      if (ent.name === 'data' && isNonEmptyDir(dest) && !options.forceData) {
+        summary.skipped.push('data/**');
+        continue;
+      }
+      if (ent.name === 'logs' && isNonEmptyDir(dest) && !options.forceLogs) {
+        summary.skipped.push('logs/**');
+        continue;
+      }
+
+      copyDirRecursive(src, dest, force, summary, options);
       continue;
     }
 
@@ -97,7 +118,7 @@ function ensurePackageJson(targetDir, force, summary) {
   summary.updated.push('package.json');
 }
 
-async function cmdInit({ targetDir, force }) {
+async function cmdInit({ targetDir, force, forceData = false, forceLogs = false }) {
   const templateDir = path.join(__dirname, '..', 'templates', 'base');
   if (!exists(templateDir)) throw new Error(`Missing template directory: ${templateDir}`);
 
@@ -105,8 +126,8 @@ async function cmdInit({ targetDir, force }) {
 
   const summary = { copied: [], created: [], updated: [], skipped: [] };
 
-  // Copy template files
-  copyDirRecursive(templateDir, targetDir, force, summary);
+  // Copy template files (preserve data/logs by default)
+  copyDirRecursive(templateDir, targetDir, force, summary, { forceData, forceLogs });
 
   // Ensure package.json has scripts
   ensurePackageJson(targetDir, force, summary);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cccarv82/freya",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Personal AI Assistant with local-first persistence",
   "scripts": {
     "health": "node scripts/validate-data.js",