servicemap 0.1.24 → 0.1.25

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:
 
@@ -73,6 +82,7 @@ servicemap install-skill --agent grok
 servicemap install-skill --agent all
 servicemap install-skill --targets universal,claude,grok
 servicemap skills install --agent codex
+servicemap update
 ```
 
 ## Contents

package/bin/servicemap.mjs

@@ -226,6 +226,7 @@ Usage:
   servicemap --root <project> [--mode auto|page|desktop] [--allow-emails <list>] [--dry-run] [--no-open]
   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
@@ -236,6 +237,7 @@ Examples:
   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
 `);
 }
@@ -593,6 +595,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 +674,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)) {

package/package.json

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

package/servicemap/SKILL.md

@@ -13,16 +13,18 @@ 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. 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.
 
 ## Safety Rules