@webmaster-droid/cli 0.1.0-alpha.1 → 0.1.0

package/dist/index.js

@@ -2,19 +2,26 @@
 
 // src/index.ts
 import { promises as fs } from "fs";
-import path from "path";
+import path2 from "path";
 import process from "process";
 import { spawn } from "child_process";
 import { fileURLToPath } from "url";
 import { Command } from "commander";
 import { glob } from "glob";
-import { parse } from "@babel/parser";
-import traverse from "@babel/traverse";
-import generate from "@babel/generator";
-import * as t from "@babel/types";
+import { parse as parse2 } from "@babel/parser";
+import traverse2 from "@babel/traverse";
+import * as t2 from "@babel/types";
 import { createTwoFilesPatch } from "diff";
 import { createJiti } from "jiti";
-var program = new Command();
+
+// src/codemod.ts
+import path from "path";
+import { parse } from "@babel/parser";
+import traverseImport from "@babel/traverse";
+import generateImport from "@babel/generator";
+import * as t from "@babel/types";
+var traverse = traverseImport.default ?? traverseImport;
+var generate = generateImport.default ?? generateImport;
 function normalizeText(text) {
   return text.replace(/\s+/g, " ").trim();
 }
@@ -22,22 +29,98 @@ function defaultPathFor(file, line, kind) {
   const stem = file.replace(/\\/g, "/").replace(/^\//, "").replace(/\.[tj]sx?$/, "").replace(/[^a-zA-Z0-9/]+/g, "-").replace(/\//g, ".");
   return `pages.todo.${stem}.${kind}.${line}`;
 }
+function transformEditableTextCodemod(source, filePath, cwd) {
+  const ast = parse(source, {
+    sourceType: "module",
+    plugins: ["typescript", "jsx"]
+  });
+  let touched = false;
+  let needsEditableTextImport = false;
+  traverse(ast, {
+    JSXElement(pathNode) {
+      const children = pathNode.node.children;
+      const nonWhitespace = children.filter(
+        (child) => !(t.isJSXText(child) && normalizeText(child.value) === "")
+      );
+      if (nonWhitespace.length !== 1 || !t.isJSXText(nonWhitespace[0])) {
+        return;
+      }
+      const text = normalizeText(nonWhitespace[0].value);
+      if (!text || text.length < 3) {
+        return;
+      }
+      const loc = nonWhitespace[0].loc?.start.line ?? 0;
+      const rel = path.relative(cwd, filePath);
+      const pathHint = defaultPathFor(rel, loc, "text");
+      const editableEl = t.jsxElement(
+        t.jsxOpeningElement(
+          t.jsxIdentifier("EditableText"),
+          [
+            t.jsxAttribute(t.jsxIdentifier("path"), t.stringLiteral(pathHint)),
+            t.jsxAttribute(t.jsxIdentifier("fallback"), t.stringLiteral(text))
+          ],
+          true
+        ),
+        null,
+        [],
+        true
+      );
+      pathNode.node.children = [t.jsxExpressionContainer(editableEl)];
+      touched = true;
+      needsEditableTextImport = true;
+    }
+  });
+  if (!touched) {
+    return {
+      changed: false,
+      next: source
+    };
+  }
+  if (needsEditableTextImport) {
+    const body = ast.program.body;
+    const hasImport = body.some(
+      (node) => t.isImportDeclaration(node) && node.source.value === "@webmaster-droid/web" && node.specifiers.some(
+        (specifier) => t.isImportSpecifier(specifier) && t.isIdentifier(specifier.imported) && specifier.imported.name === "EditableText"
+      )
+    );
+    if (!hasImport) {
+      body.unshift(
+        t.importDeclaration(
+          [
+            t.importSpecifier(
+              t.identifier("EditableText"),
+              t.identifier("EditableText")
+            )
+          ],
+          t.stringLiteral("@webmaster-droid/web")
+        )
+      );
+    }
+  }
+  const next = generate(ast, { retainLines: true }, source).code;
+  return {
+    changed: next !== source,
+    next
+  };
+}
+
+// src/index.ts
+var program = new Command();
 async function ensureDir(filePath) {
-  await fs.mkdir(path.dirname(filePath), { recursive: true });
+  await fs.mkdir(path2.dirname(filePath), { recursive: true });
 }
 async function readJson(filePath) {
   const raw = await fs.readFile(filePath, "utf8");
   return JSON.parse(raw);
 }
 program.name("webmaster-droid").description("Webmaster Droid CLI").version("0.1.0-alpha.0");
-program.command("init").description("Initialize webmaster-droid config in current project").option("--framework <framework>", "framework", "next").option("--backend <backend>", "backend", "aws").option("--out <dir>", "output dir", ".").action(async (opts) => {
-  const outDir = path.resolve(process.cwd(), opts.out);
-  const configPath = path.join(outDir, "webmaster-droid.config.ts");
+program.command("init").description("Initialize optional webmaster-droid config in current project").option("--framework <framework>", "framework", "next").option("--backend <backend>", "backend", "aws").option("--out <dir>", "output dir", ".").action(async (opts) => {
+  const outDir = path2.resolve(process.cwd(), opts.out);
+  const configPath = path2.join(outDir, "webmaster-droid.config.ts");
   await ensureDir(configPath);
   const config = `export default {
   framework: "${opts.framework}",
   backend: "${opts.backend}",
-  schema: "./cms/schema.webmaster.ts",
   apiBaseUrlEnv: "NEXT_PUBLIC_AGENT_API_BASE_URL"
 };
 `;
@@ -48,7 +131,7 @@ program.command("init").description("Initialize webmaster-droid config in curren
     await fs.writeFile(configPath, config, "utf8");
     console.log(`Created: ${configPath}`);
   }
-  const envExample = path.join(outDir, ".env.webmaster-droid.example");
+  const envExample = path2.join(outDir, ".env.webmaster-droid.example");
   try {
     await fs.access(envExample);
   } catch {
@@ -69,9 +152,9 @@ program.command("init").description("Initialize webmaster-droid config in curren
     console.log(`Created: ${envExample}`);
   }
 });
-var schema = program.command("schema").description("Schema helpers");
+var schema = program.command("schema").description("Optional schema helpers");
 schema.command("init").description("Create starter schema file").option("--out <file>", "schema output", "cms/schema.webmaster.ts").action(async (opts) => {
-  const outFile = path.resolve(process.cwd(), opts.out);
+  const outFile = path2.resolve(process.cwd(), opts.out);
   await ensureDir(outFile);
   const template = `export default {
   name: "webmaster-droid-schema",
@@ -89,8 +172,8 @@ schema.command("init").description("Create starter schema file").option("--out <
   }
 });
 schema.command("build").description("Compile schema file to runtime manifest JSON").requiredOption("--input <file>", "input schema file (.ts, .js, .json)").option("--output <file>", "output manifest", "cms/schema.manifest.json").action(async (opts) => {
-  const input = path.resolve(process.cwd(), opts.input);
-  const output = path.resolve(process.cwd(), opts.output);
+  const input = path2.resolve(process.cwd(), opts.input);
+  const output = path2.resolve(process.cwd(), opts.output);
   let manifest;
   if (input.endsWith(".json")) {
     manifest = await readJson(input);
@@ -111,7 +194,7 @@ schema.command("build").description("Compile schema file to runtime manifest JSO
   console.log(`Wrote manifest: ${output}`);
 });
 program.command("scan").description("Scan source files for static content candidates").argument("<srcDir>", "source directory").option("--out <file>", "report output", ".webmaster-droid/scan-report.json").action(async (srcDir, opts) => {
-  const root = path.resolve(process.cwd(), srcDir);
+  const root = path2.resolve(process.cwd(), srcDir);
   const files = await glob("**/*.{ts,tsx,js,jsx}", {
     cwd: root,
     absolute: true,
@@ -120,11 +203,11 @@ program.command("scan").description("Scan source files for static content candid
   const findings = [];
   for (const file of files) {
     const code = await fs.readFile(file, "utf8");
-    const ast = parse(code, {
+    const ast = parse2(code, {
       sourceType: "module",
       plugins: ["typescript", "jsx"]
     });
-    traverse(ast, {
+    traverse2(ast, {
       JSXText(pathNode) {
         const text = normalizeText(pathNode.node.value);
         if (!text || text.length < 3) {
@@ -132,25 +215,25 @@ program.command("scan").description("Scan source files for static content candid
         }
         findings.push({
           type: "jsx-text",
-          file: path.relative(process.cwd(), file),
+          file: path2.relative(process.cwd(), file),
           line: pathNode.node.loc?.start.line,
           column: pathNode.node.loc?.start.column,
           text
         });
       },
       JSXAttribute(pathNode) {
-        const name = t.isJSXIdentifier(pathNode.node.name) ? pathNode.node.name.name : "";
+        const name = t2.isJSXIdentifier(pathNode.node.name) ? pathNode.node.name.name : "";
         if (!["src", "href", "alt", "title"].includes(name)) {
           return;
         }
         const valueNode = pathNode.node.value;
-        if (!valueNode || !t.isStringLiteral(valueNode)) {
+        if (!valueNode || !t2.isStringLiteral(valueNode)) {
           return;
         }
         findings.push({
           type: "jsx-attr",
           attr: name,
-          file: path.relative(process.cwd(), file),
+          file: path2.relative(process.cwd(), file),
           line: valueNode.loc?.start.line,
           column: valueNode.loc?.start.column,
           text: valueNode.value
@@ -158,7 +241,7 @@ program.command("scan").description("Scan source files for static content candid
       }
     });
   }
-  const output = path.resolve(process.cwd(), opts.out);
+  const output = path2.resolve(process.cwd(), opts.out);
   await ensureDir(output);
   await fs.writeFile(
     output,
@@ -178,7 +261,7 @@ program.command("scan").description("Scan source files for static content candid
   console.log(`Scan complete. Findings: ${findings.length}. Report: ${output}`);
 });
 program.command("codemod").description("Apply deterministic JSX codemods to Editable components").argument("<srcDir>", "source directory").option("--apply", "write file changes", false).option("--out <file>", "report output", ".webmaster-droid/codemod-report.json").action(async (srcDir, opts) => {
-  const root = path.resolve(process.cwd(), srcDir);
+  const root = path2.resolve(process.cwd(), srcDir);
   const files = await glob("**/*.{tsx,jsx}", {
     cwd: root,
     absolute: true,
@@ -187,71 +270,12 @@ program.command("codemod").description("Apply deterministic JSX codemods to Edit
   const changed = [];
   for (const file of files) {
     const source = await fs.readFile(file, "utf8");
-    const ast = parse(source, {
-      sourceType: "module",
-      plugins: ["typescript", "jsx"]
-    });
-    let touched = false;
-    let needsEditableTextImport = false;
-    traverse(ast, {
-      JSXElement(pathNode) {
-        const children = pathNode.node.children;
-        const nonWhitespace = children.filter(
-          (child) => !(t.isJSXText(child) && normalizeText(child.value) === "")
-        );
-        if (nonWhitespace.length !== 1 || !t.isJSXText(nonWhitespace[0])) {
-          return;
-        }
-        const text = normalizeText(nonWhitespace[0].value);
-        if (!text || text.length < 3) {
-          return;
-        }
-        const loc = nonWhitespace[0].loc?.start.line ?? 0;
-        const rel = path.relative(process.cwd(), file);
-        const pathHint = defaultPathFor(rel, loc, "text");
-        const editableEl = t.jsxElement(
-          t.jsxOpeningElement(t.jsxIdentifier("EditableText"), [
-            t.jsxAttribute(t.jsxIdentifier("path"), t.stringLiteral(pathHint)),
-            t.jsxAttribute(t.jsxIdentifier("fallback"), t.stringLiteral(text))
-          ], true),
-          null,
-          [],
-          true
-        );
-        pathNode.node.children = [t.jsxExpressionContainer(editableEl)];
-        touched = true;
-        needsEditableTextImport = true;
-      }
-    });
-    if (!touched) {
-      continue;
-    }
-    if (needsEditableTextImport) {
-      const body = ast.program.body;
-      const hasImport = body.some(
-        (node) => t.isImportDeclaration(node) && node.source.value === "@webmaster-droid/web" && node.specifiers.some(
-          (specifier) => t.isImportSpecifier(specifier) && t.isIdentifier(specifier.imported) && specifier.imported.name === "EditableText"
-        )
-      );
-      if (!hasImport) {
-        body.unshift(
-          t.importDeclaration(
-            [
-              t.importSpecifier(
-                t.identifier("EditableText"),
-                t.identifier("EditableText")
-              )
-            ],
-            t.stringLiteral("@webmaster-droid/web")
-          )
-        );
-      }
-    }
-    const next = generate(ast, { retainLines: true }, source).code;
-    if (next === source) {
+    const transformed = transformEditableTextCodemod(source, file, process.cwd());
+    if (!transformed.changed) {
       continue;
     }
-    const relFile = path.relative(process.cwd(), file);
+    const next = transformed.next;
+    const relFile = path2.relative(process.cwd(), file);
     changed.push({
       file: relFile,
       patch: createTwoFilesPatch(relFile, relFile, source, next)
@@ -260,7 +284,7 @@ program.command("codemod").description("Apply deterministic JSX codemods to Edit
       await fs.writeFile(file, next, "utf8");
     }
   }
-  const output = path.resolve(process.cwd(), opts.out);
+  const output = path2.resolve(process.cwd(), opts.out);
   await ensureDir(output);
   await fs.writeFile(
     output,
@@ -286,7 +310,7 @@ program.command("doctor").description("Validate local environment for webmaster-
     issues.push(`Node.js 20+ required, found ${process.versions.node}`);
   }
   try {
-    await fs.access(path.resolve(process.cwd(), "package.json"));
+    await fs.access(path2.resolve(process.cwd(), "package.json"));
   } catch {
     issues.push("package.json missing in current working directory");
   }
@@ -316,7 +340,7 @@ program.command("dev").description("Start project dev command (pass-through)").o
 var deploy = program.command("deploy").description("Deployment helpers");
 var aws = deploy.command("aws").description("Deploy AWS lambda bundle");
 aws.requiredOption("--entry <file>", "entry TypeScript file").requiredOption("--region <region>", "AWS region").requiredOption("--functions <names>", "comma-separated Lambda function names").option("--tmp-dir <dir>", "temp folder", "/tmp/webmaster-droid-deploy").action(async (opts) => {
-  const entry = path.resolve(process.cwd(), opts.entry);
+  const entry = path2.resolve(process.cwd(), opts.entry);
   const tmpDir = opts.tmpDir;
   const functions = String(opts.functions).split(",").map((item) => item.trim()).filter(Boolean);
   const run = (cmd) => new Promise((resolve, reject) => {
@@ -339,15 +363,15 @@ aws.requiredOption("--entry <file>", "entry TypeScript file").requiredOption("--
 });
 var skill = program.command("skill").description("Skill helpers");
 skill.command("install").description("Install bundled conversion skill into CODEX_HOME").option("--codex-home <dir>", "CODEX_HOME path override").option("--force", "overwrite existing", false).action(async (opts) => {
-  const cliDir = path.dirname(fileURLToPath(import.meta.url));
-  const repoRoot = path.resolve(cliDir, "../../..");
-  const sourceSkill = path.join(repoRoot, "skills", "webmaster-droid-convert");
+  const cliDir = path2.dirname(fileURLToPath(import.meta.url));
+  const repoRoot = path2.resolve(cliDir, "../../..");
+  const sourceSkill = path2.join(repoRoot, "skills", "webmaster-droid-convert");
   const codexHome = opts.codexHome || process.env.CODEX_HOME;
   if (!codexHome) {
     throw new Error("CODEX_HOME is not set. Provide --codex-home.");
   }
-  const destination = path.join(codexHome, "skills", "webmaster-droid-convert");
-  await ensureDir(path.join(destination, "SKILL.md"));
+  const destination = path2.join(codexHome, "skills", "webmaster-droid-convert");
+  await ensureDir(path2.join(destination, "SKILL.md"));
   try {
     await fs.access(destination);
     if (!opts.force) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webmaster-droid/cli",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0",
   "type": "module",
   "bin": {
     "webmaster-droid": "dist/index.js"
@@ -31,7 +31,8 @@
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm --dts --clean",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "test": "node ../../scripts/run-workspace-tests.mjs"
   },
   "description": "CLI for project bootstrap, schema, scan/codemod, deploy, and skill install.",
   "license": "MIT",