taketomarket 2.2.0 → 2.3.0

package/bin/ttm-tools.cjs

@@ -11,12 +11,16 @@
  * Commands:
  *   slug <text>              Generate URL-safe slug from text
  *   timestamp [format]       Get timestamp (full|date|filename)
- *   init                     Check .marketing/ initialization status
- *   state <read|update>      Read or update .marketing/STATE.md
+ *   init                     Check .taketomarket/ initialization status
+ *   state <read|update>      Read or update .taketomarket/STATE.md
  *   campaign <sub> [args]    Campaign operations (init, state, update, list)
  *   drift-log <sub> [args]   Drift log operations (append, deprecation)
- *   health                   Validate .marketing/ directory structure
+ *   health                   Validate .taketomarket/ directory structure
  *   commit <msg> [--files]   Stage files and git commit
+ *   scan-codebase            Detect stack, monorepo, feature candidates
+ *   config <read|set>        Read or set .taketomarket/CONFIG.md
+ *   first-run <sub> <skill>  Check or mark first-run inline-education seen state
+ *   svg-render <in> <out>    Render SVG file to PNG via local converter
  */
 
 'use strict';
@@ -27,6 +31,15 @@ const args = process.argv.slice(2);
 const raw = args.includes('--raw');
 const command = args[0];
 
+function ensureMigratedOrExit() {
+  const { requireMigratedState } = require('./lib/legacy-folder.cjs');
+  const result = requireMigratedState(process.cwd());
+  if (!result.ok) {
+    process.stderr.write('Error: ' + result.message + '\n');
+    process.exit(2);
+  }
+}
+
 switch (command) {
   case 'slug': {
     const { cmdSlug } = require('./lib/slug.cjs');
@@ -45,6 +58,7 @@ switch (command) {
     break;
   }
   case 'state': {
+    ensureMigratedOrExit();
     const stateArgs = args.slice(1).filter(a => a !== '--raw');
     const subCmd = stateArgs[0];
     const { cmdStateRead, cmdStateUpdate } = require('./lib/state.cjs');
@@ -63,6 +77,7 @@ switch (command) {
     break;
   }
   case 'campaign': {
+    ensureMigratedOrExit();
     const { cmdCampaignInit, cmdCampaignState, cmdCampaignUpdate, cmdCampaignList, cmdCampaignArchive, cmdRepurposeManifest } = require('./lib/campaign.cjs');
     const campaignArgs = args.slice(1).filter(a => a !== '--raw');
     const subCmd = campaignArgs[0];
@@ -97,6 +112,7 @@ switch (command) {
     break;
   }
   case 'deviation': {
+    ensureMigratedOrExit();
     const devArgs = args.slice(1).filter(a => a !== '--raw');
     const devCmd = devArgs[0];
     if (devCmd === 'append') {
@@ -116,6 +132,7 @@ switch (command) {
     break;
   }
   case 'drift-log': {
+    ensureMigratedOrExit();
     const dlArgs = args.slice(1).filter(a => a !== '--raw');
     const dlCmd = dlArgs[0];
     if (dlCmd === 'append') {
@@ -145,13 +162,128 @@ switch (command) {
     break;
   }
   case 'health': {
+    ensureMigratedOrExit();
     const { cmdHealth } = require('./lib/health.cjs');
     const full = args.includes('--full');
     cmdHealth(raw, full);
     break;
   }
+  case 'legacy-folder': {
+    const sub = args[1];
+    const { legacyFolderCheck, migrateLegacyFolder } = require('./lib/legacy-folder.cjs');
+    if (sub === 'check') {
+      const result = legacyFolderCheck(process.cwd());
+      if (raw) {
+        console.log(JSON.stringify(result));
+      } else {
+        console.log(`Legacy folder state: ${result.state}`);
+      }
+      process.exit(result.state === 'conflict' ? 1 : 0);
+    } else if (sub === 'migrate') {
+      const result = migrateLegacyFolder(process.cwd());
+      if (raw) {
+        console.log(JSON.stringify(result));
+      } else {
+        console.log(result.ok ? `Migrated ${result.from} -> ${result.to}` : `Error: ${result.error}`);
+      }
+      process.exit(result.ok ? 0 : 1);
+    } else {
+      error('legacy-folder subcommand required: check, migrate');
+    }
+    break;
+  }
+  case 'scan-codebase': {
+    const { scanCodebase } = require('./lib/codebase-scan.cjs');
+    const result = scanCodebase(process.cwd());
+    console.log(
+      raw
+        ? JSON.stringify(result)
+        : `Stack: ${result.stack.join(', ')}\nMonorepo: ${result.monorepo}\nFeature candidates: ${result.featureCandidates.join(', ')}`
+    );
+    break;
+  }
+  case 'config': {
+    const { readConfig, setConfig } = require('./lib/config.cjs');
+    const cfgArgs = args.slice(1).filter(a => a !== '--raw');
+    const sub = cfgArgs[0];
+    if (sub === 'read') {
+      const cfg = readConfig(process.cwd());
+      console.log(raw ? JSON.stringify(cfg) : JSON.stringify(cfg, null, 2));
+    } else if (sub === 'set') {
+      const key = cfgArgs[1];
+      let val = cfgArgs[2];
+      if (val === 'true') val = true;
+      else if (val === 'false') val = false;
+      setConfig(process.cwd(), key, val);
+      console.log(raw ? '{"ok":true}' : `Set ${key} = ${val}`);
+    } else {
+      error('config subcommand required: read, set');
+    }
+    break;
+  }
+  case 'first-run': {
+    const sub = args[1];
+    const skillName = args[2];
+    if (!sub || !skillName) {
+      error('Usage: ttm-tools.cjs first-run check|mark <skill>');
+    }
+    const { isFirstRunSeen, markFirstRunSeen } = require('./lib/config.cjs');
+    if (sub === 'check') {
+      const seen = isFirstRunSeen(process.cwd(), skillName);
+      console.log(raw ? JSON.stringify({ seen }) : (seen ? 'seen' : 'first'));
+    } else if (sub === 'mark') {
+      markFirstRunSeen(process.cwd(), skillName);
+      console.log(raw ? '{"ok":true}' : `Marked ${skillName} as seen.`);
+    } else {
+      error('first-run subcommand required: check, mark');
+    }
+    break;
+  }
+  case 'svg-render': {
+    const { renderSvgToPng } = require('./lib/svg-render.cjs');
+    const svgArgs = args.slice(1).filter(a => a !== '--raw');
+    const result = renderSvgToPng(svgArgs[0], svgArgs[1]);
+    console.log(
+      raw
+        ? JSON.stringify(result)
+        : (result.ok ? `Rendered via ${result.renderer}` : `Error: ${result.error}`)
+    );
+    process.exit(result.ok ? 0 : 1);
+    break;
+  }
+  case 'site-location': {
+    const { suggestSitePath } = require('./lib/site-location.cjs');
+    const result = suggestSitePath(process.cwd());
+    console.log(raw ? JSON.stringify(result) : `Default: ${result.default}\nMonorepo: ${result.monorepo}`);
+    break;
+  }
+  case 'deploy': {
+    const { detectDeployPath } = require('./lib/deploy.cjs');
+    const deployArgs = args.slice(1).filter(a => a !== '--raw');
+    const sub = deployArgs[0];
+    if (sub === 'detect') {
+      const result = detectDeployPath(process.cwd());
+      console.log(raw ? JSON.stringify(result) : `Preferred: ${result.preferred || 'none'}\nAvailable: ${result.available.join(', ') || 'none'}`);
+    } else {
+      error(`deploy subcommand required: detect${sub ? ` (got: ${sub})` : ''}`);
+    }
+    break;
+  }
+  case 'playwright-check': {
+    const { checkPlaywrightMcp } = require('./lib/playwright-check.cjs');
+    const result = checkPlaywrightMcp();
+    console.log(raw ? JSON.stringify(result) : `${result.detected ? '✓' : '✗'} ${result.setupHint}`);
+    process.exit(result.detected ? 0 : 1);
+    break;
+  }
+  case 'install-detect': {
+    const { detectInstallMethod } = require('./lib/install-detect.cjs');
+    const result = detectInstallMethod();
+    console.log(raw ? JSON.stringify(result) : `Method: ${result.method}\nRoot: ${result.root}`);
+    break;
+  }
   default:
     error(
-      `Unknown command: ${command || '(none)'}. Available: slug, timestamp, init, state, campaign, commit, deviation, drift-log, health`
+      `Unknown command: ${command || '(none)'}. Available: slug, timestamp, init, state, campaign, commit, deviation, drift-log, health, legacy-folder, scan-codebase, config, first-run, svg-render, site-location, deploy, playwright-check, install-detect`
     );
 }

package/gates/base-gates.md

@@ -7,7 +7,7 @@
 ## Gate 1: Positioning Drift (GATE-01) -- Tier 1
 
 **Checks:** Asset content alignment with approved positioning
-**Against:** `.marketing/POSITIONING.md`
+**Against:** `.taketomarket/POSITIONING.md`
 
 ### Evaluation Criteria
 
@@ -31,7 +31,7 @@
 ## Gate 2: Claim Accuracy (GATE-02) -- Tier 1
 
 **Checks:** Factual and numeric claims against approved proof points
-**Against:** `.marketing/BRAND.md` proof points section
+**Against:** `.taketomarket/BRAND.md` proof points section
 
 ### Evaluation Criteria
 
@@ -55,7 +55,7 @@
 ## Gate 3: Voice Drift (GATE-03) -- Tier 2
 
 **Checks:** Tone, vocabulary, and register against brand voice definition
-**Against:** `.marketing/BRAND.md` voice archetype and banned words list
+**Against:** `.taketomarket/BRAND.md` voice archetype and banned words list
 
 ### Evaluation Criteria
 
@@ -79,7 +79,7 @@
 ## Gate 4: Outcome Alignment (GATE-04) -- Tier 1
 
 **Checks:** Whether the asset is designed to drive the campaign's stated outcome metric
-**Against:** `.marketing/CAMPAIGNS/<slug>/BRIEF.md` outcome metric
+**Against:** `.taketomarket/CAMPAIGNS/<slug>/BRIEF.md` outcome metric
 
 ### Evaluation Criteria
 
@@ -98,7 +98,7 @@
 ## Gate 5: Funnel Integrity (GATE-05) -- Tier 2
 
 **Checks:** CTA presence, destination, and conversion path logic
-**Against:** `.marketing/CAMPAIGNS/<slug>/BRIEF.md` funnel/CTA section
+**Against:** `.taketomarket/CAMPAIGNS/<slug>/BRIEF.md` funnel/CTA section
 
 ### Evaluation Criteria
 
@@ -125,7 +125,7 @@
 ## Gate 6: UTM Hygiene (GATE-06) -- Tier 2
 
 **Checks:** UTM parameter presence and naming convention compliance
-**Against:** `.marketing/CHANNELS.md` UTM schema
+**Against:** `.taketomarket/CHANNELS.md` UTM schema
 
 ### Evaluation Criteria
 
@@ -178,7 +178,7 @@
 ## Gate 8: Competitor Collision (GATE-08) -- Tier 2
 
 **Checks:** Unintended competitor promotion or positioning echo
-**Against:** `.marketing/COMPETITORS.md`
+**Against:** `.taketomarket/COMPETITORS.md`
 
 ### Evaluation Criteria
 
@@ -202,7 +202,7 @@
 ## Gate 9: ICP Fit (GATE-09) -- Tier 2
 
 **Checks:** Whether content speaks to the target ICP in their language
-**Against:** `.marketing/ICP.md`
+**Against:** `.taketomarket/ICP.md`
 
 ### Evaluation Criteria
 

package/gates/gate-evaluation.md

@@ -54,7 +54,7 @@ If a check is N/A (e.g., UTM hygiene for an asset without links), record:
 
 ### Evaluating GATE-01: Positioning Drift
 
-**Load:** `.marketing/POSITIONING.md` (Tier 2 full)
+**Load:** `.taketomarket/POSITIONING.md` (Tier 2 full)
 **Asset content:** Full asset text
 
 **Evaluate:**
@@ -69,7 +69,7 @@ If a check is N/A (e.g., UTM hygiene for an asset without links), record:
 
 ### Evaluating GATE-02: Claim Accuracy
 
-**Load:** `.marketing/BRAND.md` (Tier 2 full -- proof points section)
+**Load:** `.taketomarket/BRAND.md` (Tier 2 full -- proof points section)
 **Asset content:** Full asset text
 
 **Evaluate:**
@@ -84,7 +84,7 @@ If a check is N/A (e.g., UTM hygiene for an asset without links), record:
 
 ### Evaluating GATE-03: Voice Drift
 
-**Load:** `.marketing/BRAND.md` (Tier 2 full -- voice archetype and banned words sections)
+**Load:** `.taketomarket/BRAND.md` (Tier 2 full -- voice archetype and banned words sections)
 **Asset content:** Full asset text
 
 **Evaluate:**
@@ -99,7 +99,7 @@ If a check is N/A (e.g., UTM hygiene for an asset without links), record:
 
 ### Evaluating GATE-04: Outcome Alignment
 
-**Load:** `.marketing/CAMPAIGNS/<slug>/BRIEF.md` (outcome metric section)
+**Load:** `.taketomarket/CAMPAIGNS/<slug>/BRIEF.md` (outcome metric section)
 **Asset content:** Full asset text
 
 **Evaluate:**
@@ -113,7 +113,7 @@ If a check is N/A (e.g., UTM hygiene for an asset without links), record:
 
 ### Evaluating GATE-05: Funnel Integrity
 
-**Load:** `.marketing/CAMPAIGNS/<slug>/BRIEF.md` (funnel/CTA section)
+**Load:** `.taketomarket/CAMPAIGNS/<slug>/BRIEF.md` (funnel/CTA section)
 **Asset content:** Full asset text
 
 **Evaluate:**
@@ -128,7 +128,7 @@ If a check is N/A (e.g., UTM hygiene for an asset without links), record:
 
 ### Evaluating GATE-06: UTM Hygiene
 
-**Load:** `.marketing/CHANNELS.md` (UTM schema section)
+**Load:** `.taketomarket/CHANNELS.md` (UTM schema section)
 **Asset content:** Full asset text
 
 **Evaluate:**
@@ -158,7 +158,7 @@ If a check is N/A (e.g., UTM hygiene for an asset without links), record:
 
 ### Evaluating GATE-08: Competitor Collision
 
-**Load:** `.marketing/COMPETITORS.md` (Tier 2 full)
+**Load:** `.taketomarket/COMPETITORS.md` (Tier 2 full)
 **Asset content:** Full asset text
 
 **Evaluate:**
@@ -173,7 +173,7 @@ If a check is N/A (e.g., UTM hygiene for an asset without links), record:
 
 ### Evaluating GATE-09: ICP Fit
 
-**Load:** `.marketing/ICP.md` (Tier 2 full)
+**Load:** `.taketomarket/ICP.md` (Tier 2 full)
 **Asset content:** Full asset text
 
 **Evaluate:**

package/install.js

@@ -159,7 +159,7 @@ async function promptRuntimeSelection(args, homeDir = os.homedir()) {
   if (choices === null) {
     rl.close();
     console.error('Invalid input after 2 attempts. Exiting.');
-    console.log('Something went wrong? File an issue: https://github.com/ranjanrishikesh/takeToMarket/issues');
+    console.log('Something went wrong? File an issue: https://github.com/ranjanrishikesh/taketomarket/issues');
     process.exit(1);
   }
 
@@ -282,6 +282,36 @@ function copyDirSync(src, dest) {
 const PACKAGE_BASE_DIRS = ['workflows', 'templates', 'references', 'playbooks', 'gates', 'bin', 'agents'];
 const PACKAGE_BASE_FILES = ['settings.json', 'package.json'];
 
+/**
+ * Classify how this installer was invoked so /ttm-update can pick the right upgrade path later.
+ * Returns 'clone' if the source tree is a git checkout, 'npm' if it lives inside node_modules
+ * or the npm cache, 'plugin' if it's the Claude Code plugin cache, else 'unknown'.
+ * @param {string} packageRoot
+ * @returns {'clone'|'npm'|'plugin'|'unknown'}
+ */
+function classifyInstallMethod(packageRoot) {
+  if (dirExists(path.join(packageRoot, '.git'))) return 'clone';
+  if (packageRoot.includes(path.sep + 'node_modules' + path.sep)) return 'npm';
+  if (packageRoot.includes(path.sep + '.npm' + path.sep)) return 'npm';
+  if (packageRoot.includes(path.sep + 'claude-plugins-official' + path.sep)) return 'plugin';
+  return 'unknown';
+}
+
+/**
+ * Write the install-method sentinel so /ttm-update can read it without re-deriving from copied files.
+ * @param {string} destDir - ~/.taketomarket/
+ * @param {string} packageRoot
+ */
+function writeInstallSentinel(destDir, packageRoot) {
+  const sentinel = {
+    method: classifyInstallMethod(packageRoot),
+    source: packageRoot,
+    version: VERSION,
+    installed_at: new Date().toISOString(),
+  };
+  fs.writeFileSync(path.join(destDir, '.install-method'), JSON.stringify(sentinel, null, 2) + '\n');
+}
+
 /**
  * Copy non-skill package files to ~/.taketomarket/ (shared across all runtimes).
  * @param {string} packageRoot - Source npm package root
@@ -304,6 +334,8 @@ function copyPackageBase(packageRoot, homeDir = os.homedir()) {
       fs.copyFileSync(src, path.join(dest, file));
     }
   }
+
+  writeInstallSentinel(dest, packageRoot);
 }
 
 /**
@@ -706,7 +738,7 @@ Options:
       console.log(`  ${f.target.label}: ${f.reason}`);
     }
     console.log('');
-    console.log('Something went wrong? File an issue: https://github.com/ranjanrishikesh/takeToMarket/issues');
+    console.log('Something went wrong? File an issue: https://github.com/ranjanrishikesh/taketomarket/issues');
   }
 
   process.exit(failures.length === results.length ? 1 : 0);
@@ -727,7 +759,7 @@ function printResults(results) {
 if (require.main === module) {
   main().catch(err => {
     console.error(`Fatal: ${err.message}`);
-    console.log('Something went wrong? File an issue: https://github.com/ranjanrishikesh/takeToMarket/issues');
+    console.log('Something went wrong? File an issue: https://github.com/ranjanrishikesh/taketomarket/issues');
     process.exit(1);
   });
 }
@@ -755,5 +787,7 @@ module.exports = {
   printInstallSummary,
   copyPackageBase,
   installSkillsForRuntime,
+  classifyInstallMethod,
+  writeInstallSentinel,
   PACKAGE_ROOT,
 };

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "taketomarket",
-  "version": "2.2.0",
-  "description": "Marketing operating system for Claude Code. Spec-driven campaigns with positioning-as-invariant enforcement, quality gate walls, and compound learnings.",
+  "version": "2.3.0",
+  "description": "Marketing OS for developerneurs and solopreneurs. Built for engineers shipping products with zero marketing experience required. Spec-driven campaigns with positioning-as-invariant enforcement and quality gate walls.",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/ranjanrishikesh/takeToMarket.git"
+    "url": "git+https://github.com/ranjanrishikesh/taketomarket.git"
   },
-  "homepage": "https://github.com/ranjanrishikesh/takeToMarket#readme",
+  "homepage": "https://github.com/ranjanrishikesh/taketomarket#readme",
   "bugs": {
-    "url": "https://github.com/ranjanrishikesh/takeToMarket/issues"
+    "url": "https://github.com/ranjanrishikesh/taketomarket/issues"
   },
   "author": "Rishikesh Ranjan <59333266+ranjanrishikesh@users.noreply.github.com>",
   "bin": {
@@ -45,7 +45,11 @@
     "content-marketing",
     "marketing-automation",
     "ai-agents",
-    "spec-driven"
+    "spec-driven",
+    "developerneurs",
+    "solopreneurs",
+    "engineers",
+    "indie-hackers"
   ],
   "engines": {
     "node": ">=18"