servicemap 0.1.25 → 0.1.26

package/README.md

@@ -71,6 +71,8 @@ servicemap generate --root <project-path>
 servicemap --root <project-path>
 servicemap generate --root <project-path> --allow-emails founder@example.com,ops@example.com
 servicemap generate --root <project-path> --allow-email founder@example.com --allow-email ops@example.com
+servicemap generate --root <project-path> --deploy
+servicemap generate --root <project-path> --deploy-command "npm run deploy"
 servicemap --mode page
 servicemap --mode desktop
 servicemap --dry-run
@@ -85,6 +87,10 @@ servicemap skills install --agent codex
 servicemap update
 ```
 
+When a website page is generated, Servicemap prompts before deployment when it detects a deployment command.
+It prefers an existing `npm run deploy` script, then provider config such as Vercel or Netlify.
+Use `--no-deploy` to skip the prompt.
+
 ## Contents
 
 - `servicemap/`: installable skill folder

package/bin/servicemap.mjs

@@ -168,6 +168,8 @@ function parseArgs() {
     installMethod: null,
     allowedEmails: [],
     open: true,
+    deploy: null,
+    deployCommand: null,
     invokedWithoutArgs: args.length === 0,
     explicitCommand: false,
     generationRequested: false,
@@ -210,6 +212,9 @@ function parseArgs() {
     if (arg === '--yes' || arg === '-y') options.yes = true;
     if (arg === '--dry-run') options.dryRun = true;
     if (arg === '--no-open') options.open = false;
+    if (arg === '--deploy') options.deploy = true;
+    if (arg === '--no-deploy') options.deploy = false;
+    if (arg === '--deploy-command') options.deployCommand = args[++index] ?? null;
     if (arg === '--help' || arg === '-h') options.help = true;
   }
 
@@ -222,8 +227,8 @@ function help() {
 
 Usage:
   servicemap
-  servicemap generate [--root <project>] [--mode auto|page|desktop] [--allow-emails <list>] [--dry-run] [--no-open]
-  servicemap --root <project> [--mode auto|page|desktop] [--allow-emails <list>] [--dry-run] [--no-open]
+  servicemap generate [--root <project>] [--mode auto|page|desktop] [--allow-emails <list>] [--dry-run] [--no-open] [--deploy|--no-deploy]
+  servicemap --root <project> [--mode auto|page|desktop] [--allow-emails <list>] [--dry-run] [--no-open] [--deploy|--no-deploy]
   servicemap install-skill [--survey] [--agent codex|claude|grok|all] [--targets <ids>] [--install-method copy|symlink]
   servicemap skills install [--survey] [--agent codex|claude|grok|all]
   servicemap update
@@ -231,6 +236,8 @@ Usage:
 Examples:
   npx servicemap
   npx servicemap generate --root ../my-app --allow-emails founder@example.com,ops@example.com
+  npx servicemap generate --root ../my-app --deploy
+  npx servicemap generate --root ../my-app --deploy-command "npm run deploy"
   npx servicemap -- --root ../my-app
   npx servicemap install-skill
   npx servicemap install-skill --survey
@@ -257,6 +264,23 @@ function run(command, args, options = {}) {
   });
 }
 
+function runShell(command, options = {}) {
+  const shell = process.platform === 'win32' ? 'cmd' : 'sh';
+  const args = process.platform === 'win32' ? ['/c', command] : ['-lc', command];
+  return run(shell, args, options);
+}
+
+function askYesNo(question) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) return Promise.resolve(false);
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolvePromise) => {
+    rl.question(`${question} [y/N] `, (answer) => {
+      rl.close();
+      resolvePromise(/^y(es)?$/i.test(answer.trim()));
+    });
+  });
+}
+
 function openUrl(url) {
   const command = process.platform === 'darwin'
     ? 'open'
@@ -352,6 +376,47 @@ async function readScan(root) {
   return JSON.parse(await readFile(scanPath, 'utf8'));
 }
 
+async function packageJsonFor(root) {
+  return JSON.parse(await readFile(resolve(root, 'package.json'), 'utf8').catch(() => '{}'));
+}
+
+async function detectDeployCommand(root, options) {
+  if (options.deployCommand) return options.deployCommand;
+  const packageJson = await packageJsonFor(root);
+  if (packageJson.scripts?.deploy) return 'npm run deploy';
+  if (existsSync(resolve(root, 'vercel.json')) || existsSync(resolve(root, '.vercel/project.json'))) {
+    return 'npx vercel --prod';
+  }
+  if (existsSync(resolve(root, 'netlify.toml'))) {
+    return 'npx netlify deploy --prod';
+  }
+  return null;
+}
+
+async function maybeDeploy(root, options) {
+  if (options.deploy === false) return;
+  const command = await detectDeployCommand(root, options);
+  if (!command) {
+    if (options.deploy === true) {
+      console.log('No deploy command was detected. Add a deploy script or pass --deploy-command "<command>".');
+    } else {
+      console.log('Generated /internalservicemap. Deploy manually, or pass --deploy-command next time.');
+    }
+    return;
+  }
+
+  const shouldDeploy = options.deploy === true
+    ? true
+    : await askYesNo(`Deploy /internalservicemap now with "${command}"?`);
+  if (!shouldDeploy) {
+    console.log(`Skipped deployment. To deploy later, run: ${command}`);
+    return;
+  }
+
+  console.log(`Deploying with: ${command}`);
+  await runShell(command, { cwd: root });
+}
+
 function targetsByIds(ids) {
   const byId = new Map(targetCatalog.map((target) => [target.id, target]));
   const targets = [];
@@ -709,6 +774,7 @@ async function main() {
   } else {
     await run(process.execPath, [pageScript, '--root', options.root]);
     if (options.open) await openGeneratedPage(options.root, scan.project?.framework);
+    await maybeDeploy(options.root, options);
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "servicemap",
-  "version": "0.1.25",
+  "version": "0.1.26",
   "description": "Generate an internal service map page or desktop app for a software project.",
   "type": "module",
   "bin": {

package/servicemap/SKILL.md

@@ -24,7 +24,10 @@ If no website can be found, create a desktop app fallback at `servicemap-desktop
 7. If the scan reports `framework: static` or no website route can be safely attached, run `scripts/generate-desktop-app.mjs --root <project-root>` to create `servicemap-desktop`.
 8. Adapt the generated surface to the project's existing design system only when the route is clear and the edits are low-risk.
 9. Run the project's relevant build, lint, and focused tests.
-10. Report the page or desktop app path, service count, validation run, any services marked low or medium confidence, and whether requested email access was enforced.
+10. If a website page was created, tell the user it is only local until deployed and ask whether they want to deploy it now.
+    Do not deploy unless the user explicitly says yes.
+    If they approve, use the project's existing deployment path, preferring `npm run deploy` when present, then provider-specific project configuration such as Vercel or Netlify.
+11. Report the page or desktop app path, service count, validation run, any services marked low or medium confidence, whether requested email access was enforced, and whether deployment was skipped or completed.
 
 ## Safety Rules
 
@@ -32,7 +35,8 @@ Read environment variable names only.
 Never copy, expose, summarize, or commit secret values.
 The scan output may include env var names such as `STRIPE_SECRET_KEY`, but not their values.
 
-Do not add authentication, deployment, analytics, or external writes unless the user explicitly asks.
+Do not add authentication, analytics, or external writes unless the user explicitly asks.
+Deploy only after the generated website page exists and the user has confirmed deployment.
 If the repository already has route protection conventions for internal pages, follow them.
 When email access is requested, enforce it only through the app's existing server-side authentication.
 The built-in generator can enforce email allowlists for Next.js App Router projects using Clerk by checking `currentUser()` against the configured emails.