scaffoldrite 2.0.7 → 2.1.0

package/dist/library/validateFS.js

@@ -10,6 +10,7 @@ const index_1 = require("../utils/index");
 const index_2 = require("../data/index");
 function validateFS(root, dir, options = {}) {
     const { ignoreList = [], allowExtra = false, allowExtraPaths = [], currentPath = "", } = options;
+    const effectiveIgnoreList = [...ignoreList, ".scaffoldrite"];
     if (!fs_1.default.existsSync(dir)) {
         throw new Error(`${index_2.icons.error} ${index_2.theme.error('Folder does not exist:')} ${index_2.theme.highlight(dir)}\n` +
             `${index_2.theme.muted('Expected folder according to')} ${index_2.theme.secondary('structure.sr')} ${index_2.theme.muted('at:')} ${index_2.theme.primary(currentPath || "root")}`);
@@ -17,7 +18,7 @@ function validateFS(root, dir, options = {}) {
     const actualItems = fs_1.default.readdirSync(dir);
     // Check missing items in filesystem
     for (const child of root.children) {
-        if ((0, index_1.isIgnored)(child.name, ignoreList))
+        if ((0, index_1.isIgnored)(child.name, effectiveIgnoreList))
             continue;
         const expectedPath = path_1.default.join(dir, child.name);
         const expectedSrPath = path_1.default.join(currentPath, child.name);
@@ -27,8 +28,12 @@ function validateFS(root, dir, options = {}) {
                 return (expectedSrPath === normalized ||
                     expectedSrPath.endsWith(normalized));
             });
-            if (allowExtra || allowedExplicitly)
+            if (allowExtra || allowedExplicitly) {
+                // Print info about allowed missing item
+                console.log(`${index_2.icons.info} ${index_2.theme.info('Allowed missing:')} ${index_2.theme.muted(expectedSrPath)} ` +
+                    `${index_2.theme.muted(allowedExplicitly ? '(explicitly allowed)' : '(via --allow-extra)')}`);
                 continue;
+            }
             throw new Error(`${index_2.icons.error} ${index_2.theme.error('Missing in filesystem:')} ${index_2.theme.highlight(expectedPath)}\n` +
                 `${index_2.theme.muted('Expected according to')} ${index_2.theme.secondary('structure.sr')} ${index_2.theme.muted('at:')} ${index_2.theme.primary(expectedSrPath)}\n` +
                 `${index_2.theme.info('Fix:')} Run ${index_2.theme.primary('scaffoldrite generate')} to recreate missing files. This does not restore file contents.`);
@@ -56,26 +61,30 @@ function validateFS(root, dir, options = {}) {
     }
     // Check extra items in filesystem not in .sr
     for (const item of actualItems) {
-        if ((0, index_1.isIgnored)(item, ignoreList))
+        if ((0, index_1.isIgnored)(item, effectiveIgnoreList))
             continue;
         const existsInSr = root.children.some((c) => c.name === item);
         if (!existsInSr) {
             const extraPath = path_1.default.join(dir, item);
+            const extraRel = path_1.default.relative(process.cwd(), extraPath);
+            const extraBasename = path_1.default.basename(extraPath);
             const allowedExplicitly = allowExtraPaths.some((p) => {
                 const normalized = path_1.default.normalize(p);
-                const extraRel = path_1.default.relative(dir, extraPath);
-                const extraBasename = path_1.default.basename(extraPath);
                 return (extraBasename === normalized ||
                     extraRel === normalized ||
                     extraRel.endsWith(normalized));
             });
-            if (allowExtra || allowedExplicitly)
+            if (allowExtra || allowedExplicitly) {
+                // Print info about allowed extra item
+                console.log(`${index_2.icons.info} ${index_2.theme.info('Allowed extra:')} ${index_2.theme.highlight(extraRel)} ` +
+                    `${index_2.theme.muted(allowedExplicitly ? '(explicitly allowed)' : '(via --allow-extra)')}`);
                 continue;
+            }
             throw new Error(`${index_2.icons.error} ${index_2.theme.error('Extra file/folder found in filesystem:')} ${index_2.theme.highlight(extraPath)}\n` +
                 `${index_2.theme.muted('Not defined in')} ${index_2.theme.secondary('structure.sr')} ${index_2.theme.muted('at:')} ${index_2.theme.primary(currentPath || "root")}\n` +
                 `${index_2.theme.info('Options:')}\n` +
                 `  • ${index_2.theme.primary('--allow-extra')} to allow all extra files\n` +
-                `  • ${index_2.theme.primary('--allow-extra ' + path_1.default.relative(process.cwd(), extraPath))} to allow this specific file\n` +
+                `  • ${index_2.theme.primary('--allow-extra ' + extraRel)} to allow this specific file\n` +
                 `  • Delete or move the file to resolve`);
         }
     }

package/dist/utils/index.js

@@ -150,10 +150,10 @@ function loadAST() {
     return (0, parser_1.parseStructure)(content);
 }
 function printTree(node, prefix = "", isLast = true) {
-    const connector = isLast ? "└── " : "├── ";
-    const nextPrefix = prefix + (isLast ? "    " : "│   ");
     node.children.forEach((child, index) => {
         const last = index === node.children.length - 1;
+        const connector = last ? "└── " : "├── ";
+        const nextPrefix = prefix + (last ? "    " : "│   ");
         if (child.type === "folder") {
             console.log(`${prefix}${connector}${data_1.theme.secondary(child.name)}`);
             printTree(child, nextPrefix, last);
@@ -164,10 +164,10 @@ function printTree(node, prefix = "", isLast = true) {
     });
 }
 function printTreeWithIcons(node, prefix = "", isLast = true) {
-    const connector = isLast ? "└── " : "├── ";
-    const nextPrefix = prefix + (isLast ? "    " : "│   ");
     node.children.forEach((child, index) => {
         const last = index === node.children.length - 1;
+        const connector = last ? "└── " : "├── ";
+        const nextPrefix = prefix + (last ? "    " : "│   ");
         if (child.type === "folder") {
             console.log(`${prefix}${connector}${data_1.icons.folder} ${data_1.theme.secondary(child.name)}`);
             printTreeWithIcons(child, nextPrefix, last);
@@ -233,14 +233,15 @@ exports.ALLOWED_FLAGS = {
         "--verbose",
         "--summary",
         "--ignore-tooling",
-        "--copy"
+        "--copy",
     ],
     create: ["--force", "--if-not-exists", "--yes", "--dry-run", "--verbose", "--summary"],
     delete: ["--yes", "--dry-run", "--verbose", "--summary"],
     rename: ["--yes", "--dry-run", "--verbose", "--summary"],
     list: ["--structure", "--sr", "--fs", "--diff", "--with-icon"],
+    find: ["--structure", "--sr", "--fs"], // ✅ updated
     version: [],
-    "check-packages": ["--validate"]
+    "check-packages": ["--validate"],
 };
 function printUsage(cmd) {
     if (cmd && exports.ALLOWED_FLAGS[cmd]) {
@@ -254,8 +255,9 @@ function printUsage(cmd) {
             create: "<path> <file|folder> [--force | --if-not-exists] [--yes | -y] [--dry-run] [--verbose | --summary]",
             delete: "<path> [--yes | -y] [--dry-run] [--verbose | --summary]",
             rename: "<path> <newName> [--yes | -y] [--dry-run] [--verbose | --summary]",
+            find: "<query> [--structure | --sr | --fs]",
             version: "",
-            "check-packages": "[--validate]"
+            "check-packages": "[--validate]",
         };
         const args = argsMap[cmd] ? ` ${argsMap[cmd]}` : "";
         console.log(data_1.theme.primary.bold(`Usage for '${cmd}':`) +
@@ -272,8 +274,9 @@ Usage:
   scaffoldrite update [--from-fs [dir]] [--yes | -y]
   scaffoldrite merge [--from-fs [dir]] [--yes | -y]
   scaffoldrite validate [--allow-extra] [--allow-extra <path1> <path2> ...]
-  scaffoldrite generate [dir] [--yes | -y] [--dry-run] [--verbose | --summary]  [--ignore-tooling]
+  scaffoldrite generate [dir] [--yes | -y] [--dry-run] [--verbose | --summary] [--ignore-tooling]
   scaffoldrite list [[--structure | --sr] | --fs | --diff] [--with-icon]
+  scaffoldrite find <query> [--structure | --sr | --fs]
   scaffoldrite create <path> <file|folder> [--force | --if-not-exists] [--yes | -y] [--dry-run] [--verbose | --summary]
   scaffoldrite delete <path> [--yes | -y] [--dry-run] [--verbose | --summary]
   scaffoldrite rename <path> <newName> [--yes | -y] [--dry-run] [--verbose | --summary]
@@ -346,6 +349,11 @@ function runRequirements(ctx) {
             if (fromFs && !arg3)
                 fail("init");
         },
+        // ✅ New requirement for find
+        find() {
+            if (!arg3)
+                fail("find"); // arg3 is the search query
+        },
     };
     requirements[command]?.();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scaffoldrite",
-  "version": "2.0.7",
+  "version": "2.1.0",
   "description": "A project structure validator and generator CLI tool.",
   "author": "Isaac Anasonye",
   "license": "MIT",
@@ -38,7 +38,7 @@
     "validate": "npm run type-check && npm run build",
     "test": "jest",
     "prepublishOnly": "npm run build && node dist/cli.js --help npm pack --dry-run",
-    "release:test": "npm run build && node -e \"const { execSync } = require('child_process'); const name=require('./package.json').name; const version=require('./package.json').version; const file=`${name}-${version}.tgz`; execSync('npm pack', { stdio: 'inherit' }); execSync(`npm install -g ${file}`, { stdio: 'inherit' }); execSync('sr --help', { stdio: 'inherit' }); execSync('npm uninstall -g scaffoldrite', { stdio: 'inherit' });\""
+    "release:test": "npm run build && node -e \"const { execSync } = require('child_process'); const name=require('./package.json').name; const version=require('./package.json').version; const file=`${name}-${version}.tgz`; execSync('npm pack', { stdio: 'inherit' }); execSync(`npm install -g ${file}`, { stdio: 'inherit' }); execSync('sr --help', { stdio: 'inherit' }); execSync('npm uninstall -g ${name}-${version}', { stdio: 'inherit' });\""
   },
   "devDependencies": {
     "@types/cli-progress": "^3.11.6",