servicemap 0.1.24 → 0.1.26

package/README.md

@@ -41,6 +41,15 @@ npx servicemap skills install --agent claude
 ```
 
 Agents with known local skill folders get the real `servicemap` skill installed.
+Symlink installs use a stable local clone at `~/.servicemap/source`, so updates can be pulled without reinstalling every agent folder.
+
+To update that local skill source:
+
+```bash
+npx servicemap update
+```
+
+Running `npx servicemap` again also refreshes the stable source before installing.
 
 After a global install, the command is:
 
@@ -62,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
@@ -73,8 +84,13 @@ servicemap install-skill --agent grok
 servicemap install-skill --agent all
 servicemap install-skill --targets universal,claude,grok
 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,20 +227,24 @@ 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
 
 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
   npx servicemap install-skill --agent all
   npx servicemap install-skill --targets codex,claude,cursor
   npx servicemap skills install --agent claude
+  npx servicemap update
   servicemap --mode desktop
 `);
 }
@@ -255,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'
@@ -350,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 = [];
@@ -593,6 +660,11 @@ async function prepareStableSource(options) {
   return resolve(sourceRoot, 'servicemap');
 }
 
+async function updateStableSource(options) {
+  const source = await prepareStableSource(options);
+  console.log(`Servicemap source is current at ${dirname(source)}`);
+}
+
 async function installIntoRoot(root, source, method, options) {
   const destination = join(root, 'servicemap');
   if (options.dryRun) {
@@ -667,8 +739,13 @@ async function main() {
     return;
   }
 
+  if (options.command === 'update') {
+    await updateStableSource(options);
+    return;
+  }
+
   if (options.command !== 'generate') {
-    throw new Error(`Unknown command "${options.command}". Use generate, install-skill, or skills install.`);
+    throw new Error(`Unknown command "${options.command}". Use generate, install-skill, update, or skills install.`);
   }
 
   if (!['auto', 'page', 'desktop'].includes(options.mode)) {
@@ -697,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.24",
+  "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

@@ -13,16 +13,21 @@ If no website can be found, create a desktop app fallback at `servicemap-desktop
 
 ## Workflow
 
-1. Inspect the project layout and current web framework.
-2. If the user gives a list of emails that may access the generated web page, pass them to the scan command with `--allow-email <email>` for each address or `--allow-emails <comma-separated-list>`.
-3. Run `scripts/scan-project.mjs --root <project-root>` to create `.servicemap/internal-servicemap.json`.
+1. If this skill is installed from the stable source clone at `~/.servicemap/source`, run `git -C ~/.servicemap/source pull --ff-only` before using the scripts.
+   If the update fails because the network is unavailable, continue with the installed local copy and report that the auto-update did not complete.
+2. Inspect the project layout and current web framework.
+3. If the user gives a list of emails that may access the generated web page, pass them to the scan command with `--allow-email <email>` for each address or `--allow-emails <comma-separated-list>`.
+4. Run `scripts/scan-project.mjs --root <project-root>` to create `.servicemap/internal-servicemap.json`.
    Include the access flags from the previous step when relevant.
-4. Review the scan output for obvious false positives or missing high-confidence services.
-5. If the scan detects a web framework or routeable website, run `scripts/generate-page.mjs --root <project-root>` to create the framework-specific `/internalservicemap` route.
-6. 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`.
-7. Adapt the generated surface to the project's existing design system only when the route is clear and the edits are low-risk.
-8. Run the project's relevant build, lint, and focused tests.
-9. 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.
+5. Review the scan output for obvious false positives or missing high-confidence services.
+6. If the scan detects a web framework or routeable website, run `scripts/generate-page.mjs --root <project-root>` to create the framework-specific `/internalservicemap` route.
+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. 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
 
@@ -30,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.