seomd-cli 1.2.0 → 1.3.0

package/README.md

@@ -91,12 +91,14 @@ seomd status --json
 Copy `.env.example` from your platform provider docs, or create one with the vars you need:
 
 Required for live audits:
+
 ```bash
 SEOMD_API_URL=
 SEOMD_API_KEY=your_key_here
 ```
 
 Optional:
+
 ```bash
 SEOMD_PAYMENT_TOKEN= # x402 pay-per-scan token
 SEOMD_DOMAIN= # override domain header
@@ -108,9 +110,10 @@ SEOMD_DOMAIN= # override domain header
 
 ### `seomd init`
 
-Scaffolds `SEO.md`, `SEO.REVERSE.md`, and the `.seomd/` intelligence directory.
+Scaffolds `SEO.md`, `SEO.REVERSE.md`, and the `.seo/` intelligence directory.
 
 **Usage:**
+
 ```bash
 seomd init                              # interactive 5-question flow
 seomd init -y --type local              # skip prompts, use defaults
@@ -119,6 +122,7 @@ seomd init --type saas --brand "MyApp" --domain myapp.com --primary-keyword "bil
 ```
 
 **Options:**
+
 | Flag | Description |
 |------|-------------|
 | `-y, --yes` | skip prompts, use defaults |
@@ -130,6 +134,7 @@ seomd init --type saas --brand "MyApp" --domain myapp.com --primary-keyword "bil
 | `--output <dir>` | scaffold into a new (empty) directory instead of cwd |
 
 **Behavior:**
+
 - Interactive flow by default (5 questions)
 - Non-interactive when `-y` is set **OR** any config flag (`--brand`, `--domain`, `--primary-keyword`, `--competitors`) is provided
 - `--type` alone pre-selects site type in the interactive flow
@@ -151,7 +156,7 @@ Runs an AI search audit via your connected platform and writes results back into
 
 - `SEO.md` (`_analysis` blocks)
 - `SEO.REVERSE.md` (generated reverse view)
-- `.seomd/pages/*.md` (per-page playbooks when available)
+- `.seo/pages/*.md` (per-page playbooks when available)
 
 ### `seomd sync`
 
@@ -223,9 +228,11 @@ To enable live intelligence writebacks (using automated platforms like [Foxcite]
 
 1. Obtain a developer API key from your platform provider.
 2. Export the key as an environment variable:
+
    ```bash
    export SEOMD_API_KEY="your_api_key_here"
    ```
+
 3. Run `seomd sync` or `seomd analyze`.
 
 _Note: Never commit your API keys or `.env` files containing keys to version control._

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "seomd-cli",
-    "version": "1.2.0",
+    "version": "1.3.0",
     "description": "The official CLI for the SEO.md open standard — AEO infrastructure for technical founders",
     "homepage": "https://seomd.dev",
     "repository": {
@@ -35,7 +35,6 @@
         "yaml": "^2.3.4"
     },
     "devDependencies": {
-        "@eslint/js": "^10.0.1",
         "eslint": "^8.50.0",
         "eslint-plugin-n": "^18.1.0",
         "jest": "^29.7.0"

package/src/commands/analyze.js

@@ -11,16 +11,16 @@ dotenv.config();
 function matchRoute(pattern, url) {
     const cleanPattern = pattern.replace(/\/$/, '');
     const cleanUrl = url.replace(/\/$/, '');
-    
+
     if (cleanPattern.toLowerCase() === cleanUrl.toLowerCase()) {
         return true;
     }
-    
+
     // Replace "/[param]" with optional group "(?:/([^/]+))?"
     const regexPattern = cleanPattern
         .replace(/\/\[[^\]]+\]/g, '(?:\\/([^/]+))?')
         .replace(/\//g, '\\/');
-        
+
     const regex = new RegExp('^' + regexPattern + '\\/?$', 'i');
     return regex.test(url);
 }
@@ -147,7 +147,7 @@ export async function analyzeCommand(options) {
         const brandName = data.identity?.brand || 'My Brand';
         await writeReverseMd(cwd, results, domain, brandName);
 
-        // Writeback to .seomd/pages/*.md
+        // Writeback to .seo/pages/*.md
         await writePageAnalysis(cwd, results);
 
         spinner.succeed(chalk.green('Analysis completed successfully!'));
@@ -168,7 +168,7 @@ export async function analyzeCommand(options) {
         console.log('');
         console.log(chalk.green('✔ SEO.md updated.'));
         console.log(chalk.green('✔ SEO.REVERSE.md updated.'));
-        console.log(chalk.green('✔ .seomd/pages/ playbooks generated.'));
+        console.log(chalk.green('✔ .seo/pages/ playbooks generated.'));
         console.log('');
 
     } catch (err) {

package/src/commands/init.js

@@ -60,10 +60,10 @@ export async function initCommand(options) {
             primary_keyword: options.primaryKeyword || '',
             competitors: options.competitors
                 ? options.competitors
-                      .split(',')
-                      .map((c) => c.trim())
-                      .filter(Boolean)
-                      .slice(0, 3)
+                    .split(',')
+                    .map((c) => c.trim())
+                    .filter(Boolean)
+                    .slice(0, 3)
                 : [],
         };
     } else {
@@ -140,11 +140,11 @@ export async function initCommand(options) {
         await fs.writeFile(path.join(workingDir, 'SEO.REVERSE.md'), reverseContent, 'utf8');
         spinner.succeed(chalk.green('SEO.REVERSE.md initialized'));
 
-        // 3. Create .seomd/ directory structure
+        // 3. Create .seo/ directory structure
         await createSeomdDir(workingDir, answers);
-        spinner.succeed(chalk.green('.seomd/ directory created'));
+        spinner.succeed(chalk.green('.seo/ directory created'));
 
-        // 4. Add .seomd/ to .gitignore if it exists
+        // 4. Add .seo/ to .gitignore if it exists
         await updateGitignore(workingDir);
 
         console.log('');
@@ -153,7 +153,7 @@ export async function initCommand(options) {
         console.log(chalk.dim('Files created:'));
         console.log('  ' + chalk.cyan('SEO.md') + chalk.dim('             — your living SEO config'));
         console.log('  ' + chalk.cyan('SEO.REVERSE.md') + chalk.dim('     — reverse engineer output (platform generated)'));
-        console.log('  ' + chalk.cyan('.seomd/') + chalk.dim('            — intelligence directory'));
+        console.log('  ' + chalk.cyan('.seo/') + chalk.dim('            — intelligence directory'));
         console.log('');
         console.log(chalk.dim('Next steps:'));
         console.log('  ' + chalk.white('npx seomd analyze') + chalk.dim('  — run your first citation analysis'));
@@ -171,11 +171,11 @@ export async function initCommand(options) {
 
 async function updateGitignore(cwd) {
     const gitignorePath = path.join(cwd, '.gitignore');
-    const entry = '\n# seomd intelligence directory\n.seomd/reports/\n';
+    const entry = '\n# seomd intelligence directory\n.seo/reports/\n';
 
     if (await fs.pathExists(gitignorePath)) {
         const content = await fs.readFile(gitignorePath, 'utf8');
-        if (!content.includes('.seomd')) {
+        if (!content.includes('.seo')) {
             await fs.appendFile(gitignorePath, entry);
         }
     }

package/src/commands/sync.js

@@ -90,7 +90,7 @@ export async function syncCommand(options) {
         const brandName = data.identity?.brand || 'My Brand';
         await writeReverseMd(cwd, results, domain, brandName);
 
-        // Writeback to .seomd/pages/*.md
+        // Writeback to .seo/pages/*.md
         await writePageAnalysis(cwd, results);
 
         spinner.succeed(chalk.green('Sync completed successfully!'));
@@ -111,7 +111,7 @@ export async function syncCommand(options) {
         console.log('');
         console.log(chalk.green('✔ SEO.md updated.'));
         console.log(chalk.green('✔ SEO.REVERSE.md updated.'));
-        console.log(chalk.green('✔ .seomd/pages/ playbooks synchronized.'));
+        console.log(chalk.green('✔ .seo/pages/ playbooks synchronized.'));
         console.log('');
 
     } catch (err) {

package/src/generators/directory.js

@@ -5,14 +5,14 @@ import { REQUIRED_PAGES } from '../utils/constants.js';
 export async function createSeomdDir(cwd, answers) {
     const { site_type, brand, domain } = answers;
     const pages = REQUIRED_PAGES[site_type] || REQUIRED_PAGES.saas;
-    const seomdDir = path.join(cwd, '.seomd');
+    const seomdDir = path.join(cwd, '.seo');
 
     // Create directory structure
     await fs.ensureDir(path.join(seomdDir, 'pages'));
     await fs.ensureDir(path.join(seomdDir, 'reports'));
     await fs.ensureDir(path.join(seomdDir, 'competitors'));
 
-    // Create README inside .seomd/
+    // Create README inside .seo/
     await fs.writeFile(
         path.join(seomdDir, 'README.md'),
         generateSeomdReadme(brand, domain),
@@ -38,19 +38,19 @@ export async function createSeomdDir(cwd, answers) {
 }
 
 function generateSeomdReadme(brand, domain) {
-    return `# .seomd/
+    return `# .seo/
 
 AI search optimization workspace for **${brand}** (${domain})
 Generated by SEO.md CLI — https://seomd.dev
 
 ## What is this?
 
-\`.seomd/\` stores platform-generated intelligence from citation audits, competitor analysis, and reverse-engineered playbooks. It lives alongside your source code so SEO strategy is version-controlled and reviewable in PRs.
+\`.seo/\` stores platform-generated intelligence from citation audits, competitor analysis, and reverse-engineered playbooks. It lives alongside your source code so SEO strategy is version-controlled and reviewable in PRs.
 
 ## Directory Structure
 
 \`\`\`
-.seomd/
+.seo/
 ├── pages/          # per-page reverse-engineer analysis
 │   ├── homepage.md
 │   ├── services.md
@@ -65,11 +65,11 @@ Generated by SEO.md CLI — https://seomd.dev
 
 | Path | Git | Why |
 |------|-----|-----|
-| \`.seomd/pages/\` | tracked | actionable playbooks belong in code review |
-| \`.seomd/competitors/\` | tracked | competitor intel is project state |
-| \`.seomd/reports/\` | ignored | dated snapshots are noise in git history |
+| \`.seo/pages/\` | tracked | actionable playbooks belong in code review |
+| \`.seo/competitors/\` | tracked | competitor intel is project state |
+| \`.seo/reports/\` | ignored | dated snapshots are noise in git history |
 
-\`.seomd/reports/\` is added to \`.gitignore\` automatically by \`seomd init\`.
+\`.seo/reports/\` is added to \`.gitignore\` automatically by \`seomd init\`.
 
 ## When to run what
 
@@ -108,9 +108,9 @@ Each \`pages/<id>.md\` contains:
 |-----------|-------|----------|
 | \`SEO.md\` | you | yes |
 | \`SEO.REVERSE.md\` | platform | no |
-| \`.seomd/pages/*.md\` | platform | no |
-| \`.seomd/competitors/*.md\` | platform | no |
-| \`.seomd/reports/*.md\` | platform | no |
+| \`.seo/pages/*.md\` | platform | no |
+| \`.seo/competitors/*.md\` | platform | no |
+| \`.seo/reports/*.md\` | platform | no |
 
 Platform-generated files are overwritten on each \`analyze\` or \`sync\`.
 

package/src/utils/writeback.js

@@ -110,13 +110,13 @@ export async function writeReverseMd(cwd, response, defaultDomain = 'example.com
 }
 
 /**
- * Writes individual page playbooks into .seomd/pages/{id}.md files.
+ * Writes individual page playbooks into .seo/pages/{id}.md files.
  * 
  * @param {string} cwd - Current working directory
  * @param {any} response - The API response from analyze/sync
  */
 export async function writePageAnalysis(cwd, response) {
-    const seomdDir = path.join(cwd, '.seomd');
+    const seomdDir = path.join(cwd, '.seo');
     const pagesDir = path.join(seomdDir, 'pages');
 
     await fs.ensureDir(pagesDir);