@sdods/cli 0.19.0 → 0.21.0

package/dist/install-method.js

@@ -0,0 +1,62 @@
+import { existsSync, realpathSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, resolve, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const INSTALLER_GIT_HINT = 'Re-run the install script, which updates its checkout in place: curl -fsSL https://sdods.com/install.sh | sh -s -- --source git';
+/** Directory of the @sdods/cli package this code is running from (src/ and dist/ sit one below it). */
+export function runningPackageDir() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const dir = resolve(here, '..');
+    try {
+        return realpathSync(dir);
+    }
+    catch {
+        return dir;
+    }
+}
+/** Forward slashes, so one set of markers works on macOS, Linux and Windows paths. */
+function norm(p) {
+    return p.split(sep).join('/').replace(/\\/g, '/');
+}
+function within(child, parent) {
+    const c = norm(child).replace(/\/+$/, '');
+    const p = norm(parent).replace(/\/+$/, '');
+    return c === p || c.startsWith(`${p}/`);
+}
+/**
+ * Classify an installed package directory. Specific markers are checked before generic ones: a
+ * Homebrew keg and an npx cache both contain `node_modules/@sdods/cli` too.
+ */
+export function detectInstallMethod(packageDir, o) {
+    const p = norm(packageDir);
+    const home = o.sdodsHome ?? process.env.SDODS_HOME ?? join(homedir(), '.sdods');
+    const isGit = o.isGitCheckout ?? ((dir) => existsSync(join(dir, '.git')));
+    const make = (method, upgrade, hint) => ({
+        method,
+        packageDir,
+        upgrade,
+        hint,
+    });
+    if (within(packageDir, join(o.rootDir, 'node_modules')))
+        return make('project', null, 'Upgraded with the project package step below.');
+    if (/\/_npx\//.test(p))
+        return make('npx', null, 'npx fetches @sdods/cli on each run; use `npx -y @sdods/cli@latest`.');
+    if (/\/Cellar\/sdods\//i.test(p) || /\/(?:homebrew|linuxbrew)\/.*\/libexec\//i.test(p))
+        return make('homebrew', ['brew', 'upgrade', 'sdods'], 'brew upgrade sdods');
+    if (/\/\.bun\/install\/global\//.test(p))
+        return make('bun', ['bun', 'add', '-g', '@sdods/cli@latest'], 'bun add -g @sdods/cli@latest');
+    if (/\/pnpm\/global\//i.test(p) || /\/\.pnpm\/@sdods\+cli@/.test(p))
+        return make('pnpm', ['pnpm', 'add', '-g', '@sdods/cli@latest'], 'pnpm add -g @sdods/cli@latest');
+    if (/\/node_modules\/@sdods\/cli$/.test(p.replace(/\/+$/, '')))
+        return make('npm', ['npm', 'install', '-g', '@sdods/cli@latest'], 'npm install -g @sdods/cli@latest');
+    // packages/cli inside a clone of the monorepo
+    const checkout = resolve(packageDir, '..', '..');
+    if (/\/packages\/cli$/.test(p.replace(/\/+$/, ''))) {
+        if (within(checkout, join(home, 'app')))
+            return make('installer-git', null, INSTALLER_GIT_HINT);
+        if (isGit(checkout))
+            return make('checkout', null, `Development checkout: git -C ${checkout} pull, then install.`);
+    }
+    return make('npm', ['npm', 'install', '-g', '@sdods/cli@latest'], 'npm install -g @sdods/cli@latest');
+}
+//# sourceMappingURL=install-method.js.map

package/dist/skills-catalog.d.ts

@@ -27,6 +27,13 @@ export declare const SKILL_TARGETS: {
 };
 export type SkillTarget = keyof typeof SKILL_TARGETS;
 export declare const DEFAULT_SKILL_TARGETS: SkillTarget[];
+/** The directory a target resolves to, under a project root or (with `global`) the home directory. */
+export declare function skillTargetDir(base: string, target: SkillTarget, global?: boolean): string;
+/**
+ * Targets that already hold at least one bundled SDODS skill. `sdods upgrade` refreshes exactly
+ * these, so it updates what someone installed without spreading skills into new folders.
+ */
+export declare function installedSkillTargets(base: string, global?: boolean, source?: string): SkillTarget[];
 export interface InstallSkillsOptions {
     rootDir: string;
     targets?: SkillTarget[];

package/dist/skills-catalog.js

@@ -49,6 +49,18 @@ export const SKILL_TARGETS = {
 export const DEFAULT_SKILL_TARGETS = ['claude', 'agents'];
 /** GitHub Copilot's user-level directory is `~/.copilot/skills`, not `~/.github/skills`. */
 const GLOBAL_OVERRIDES = { copilot: '.copilot/skills' };
+/** The directory a target resolves to, under a project root or (with `global`) the home directory. */
+export function skillTargetDir(base, target, global = false) {
+    return join(base, (global && GLOBAL_OVERRIDES[target]) || SKILL_TARGETS[target]);
+}
+/**
+ * Targets that already hold at least one bundled SDODS skill. `sdods upgrade` refreshes exactly
+ * these, so it updates what someone installed without spreading skills into new folders.
+ */
+export function installedSkillTargets(base, global = false, source) {
+    const names = listBundledSkills(source).map((s) => s.name);
+    return Object.keys(SKILL_TARGETS).filter((t) => names.some((n) => existsSync(join(skillTargetDir(base, t, global), n, 'SKILL.md'))));
+}
 export function installSkills(o) {
     const available = listBundledSkills(o.source);
     const wanted = o.skills?.length ? o.skills : available.map((s) => s.name);
@@ -58,9 +70,9 @@ export function installSkills(o) {
     const base = o.global ? (o.home ?? homedir()) : o.rootDir;
     const results = [];
     for (const target of o.targets?.length ? o.targets : DEFAULT_SKILL_TARGETS) {
-        const rel = (o.global && GLOBAL_OVERRIDES[target]) || SKILL_TARGETS[target];
+        const dir = skillTargetDir(base, target, o.global);
         for (const skill of available.filter((s) => wanted.includes(s.name))) {
-            const path = join(base, rel, skill.name);
+            const path = join(dir, skill.name);
             const exists = existsSync(join(path, 'SKILL.md'));
             if (exists && !o.force) {
                 results.push({ skill: skill.name, target, path, status: 'skipped' });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdods/cli",
-  "version": "0.19.0",
+  "version": "0.21.0",
   "description": "SDODS command line: run, record, analyze, agents, MCP server, scheduler and the web server.",
   "license": "Apache-2.0",
   "funding": "https://sdods.com/sponsor/",
@@ -26,8 +26,8 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@sdods/contracts": "0.19.0",
-    "@sdods/core": "0.19.0",
+    "@sdods/contracts": "0.21.0",
+    "@sdods/core": "0.21.0",
     "commander": "^15.0.0",
     "execa": "^10.2.1",
     "picocolors": "^1.1.1",
@@ -36,12 +36,12 @@
     "zod": "^4.6.7",
     "@playwright/test": "^1.64.0",
     "playwright-core": "^1.64.0",
-    "@sdods/integrations": "0.19.0",
-    "@sdods/mcp": "0.19.0",
-    "@sdods/agents": "0.19.0",
-    "@sdods/db": "0.19.0",
+    "@sdods/integrations": "0.21.0",
+    "@sdods/mcp": "0.21.0",
+    "@sdods/agents": "0.21.0",
+    "@sdods/db": "0.21.0",
     "csv-parse": "^7.0.3",
-    "@sdods/server": "0.19.0"
+    "@sdods/server": "0.21.0"
   },
   "homepage": "https://sdods.com",
   "bugs": {

package/skills/sdods-start-ui/SKILL.md

@@ -101,7 +101,7 @@ Read the rows in order and take the first that matches:
 |---|---|---|
 | `package.json` says `sdods-monorepo` — **even if `sdods` is on PATH** | a **source checkout** | `bun run web:build`, then `bun run sdods serve --open` |
 | `sdods` on PATH, anywhere else | a **global install** (installer, npm, Homebrew) | `sdods serve --open` |
-| neither, Docker is running | the **container** | `docker run --rm -p 8080:8080 -v sdods-data:/data ghcr.io/yarlisaisolutions/sdods-server` |
+| neither, Docker is running | the **container** | `docker run --rm -p 8080:8080 -v sdods-data:/data sdods/sdods-server` |
 | you want no terminal at all | the **desktop app** | install from <https://sdods.com/download>, launch it |
 
 > **Inside a checkout, always use `bun run sdods`, never the global `sdods`.** The two drift, and
@@ -155,19 +155,14 @@ The CLI is identical on every OS; only the shell and the paths differ.
 | Windows (PowerShell) | `sdods serve --open` |
 | Windows (cmd) | `sdods serve --open` — the installer writes both `sdods.cmd` and `sdods.ps1` |
 | WSL | use the Linux command inside WSL, not the PowerShell one |
-| Docker (any host) | `docker run --rm -p 8080:8080 -v sdods-data:/data ghcr.io/yarlisaisolutions/sdods-server` |
+| Docker (any host) | `docker run --rm -p 8080:8080 -v sdods-data:/data sdods/sdods-server` |
 
 Defaults: **`http://127.0.0.1:4444`** for the CLI, **`http://localhost:8080`** for Docker (the
 image binds `0.0.0.0:8080`). `--open` launches the browser (`open` / `start` / `xdg-open` by
 platform). `--host 0.0.0.0` exposes it on the LAN — only do that deliberately.
 
-The image is published for `linux/amd64` and `linux/arm64`, so the same command runs natively on
-Apple silicon and arm64 servers. Tags up to `0.9.0` carry amd64 only, and Docker refuses that pull
-on arm64 rather than emulating; for those, add the platform flag:
-
-```bash
-docker run --rm --platform linux/amd64 -p 8080:8080 -v sdods-data:/data ghcr.io/yarlisaisolutions/sdods-server:0.9.0
-```
+The image is published on Docker Hub for `linux/amd64` and `linux/arm64` (tags from `0.20.0`), so
+the same command runs natively on Apple silicon and arm64 servers.
 
 If the run must come from a source checkout, `bun run web:build` is not optional — see
 Troubleshooting.