@senior-skills/cli 1.0.0

package/dist/update-notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-notifications.d.ts","sourceRoot":"","sources":["../src/update-notifications.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,eAAe,EAEpB,KAAK,WAAW,EAChB,KAAK,MAAM,EACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,SAAS,GAAG,aAAa,CAAC,CAAC;IAC1E,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;IACnD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,aAAa,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,EAC9C,QAAQ,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,EAC9D,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAChD,OAAO,CAiBT;AAED,+FAA+F;AAC/F,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,aAAa,EACtB,KAAK,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAE3B,GACA,OAAO,CAAC,OAAO,CAAC,CAqHlB"}

package/dist/update-notifications.js

@@ -0,0 +1,142 @@
+import { AgentSkillsError, ErrorCode, } from '@senior-skills/core';
+export function shouldCheckUpdates(command, options, terminal, env) {
+    const ci = env['CI'];
+    return (['install', 'update', 'list', 'search', 'info', 'agents', 'doctor'].includes(command) &&
+        terminal.stdin &&
+        terminal.stdout &&
+        terminal.stderr &&
+        !(ci !== undefined && !['', '0', 'false'].includes(ci.toLowerCase())) &&
+        env['SENIOR_SKILLS_NO_UPDATE_NOTIFIER'] !== '1' &&
+        env['TERM'] !== 'dumb' &&
+        options.updateCheck !== false &&
+        options.json !== true &&
+        options.quiet !== true &&
+        options.dryRun !== true &&
+        options.offline !== true &&
+        !(options.global === true && options.project === true));
+}
+/** Returns true after replacing the CLI, so the old process stops before running a command. */
+export async function showUpdateNotifications(services, command, options, write = (message) => {
+    process.stderr.write(`${message}\n`);
+}) {
+    let notices;
+    try {
+        notices = await services.check.execute({
+            agents: options.agent,
+            registry: options.registry,
+            scope: options.global
+                ? 'global'
+                : options.project || options.projectRoot !== undefined
+                    ? 'project'
+                    : undefined,
+            projectRoot: options.projectRoot,
+            // These commands already select/install a release. An extra skill update before them
+            // could contradict an explicit install pin or duplicate a requested update.
+            skipSkills: command === 'install' || command === 'update',
+        });
+    }
+    catch (error) {
+        services.logger.debug('Update notifications unavailable', error);
+        return false;
+    }
+    if (notices.tool !== undefined) {
+        const notice = notices.tool;
+        const action = await services.tool.action(notice.version).catch(() => ({
+            label: 'Update this installation with its original package manager, then restart senior-skills.',
+            run: undefined,
+        }));
+        const choices = [
+            ...(action.run === undefined ? [] : ['Update now']),
+            'Remind me later',
+            'Skip this version',
+        ];
+        const title = `Update available for senior-skills! ${notice.current} -> ${notice.version}` +
+            `\n${safeText(action.label)}`;
+        const choice = await services.prompt.choose(title, choices);
+        if (choice === 0 && action.run !== undefined) {
+            write(`Updating senior-skills to ${notice.version}...`);
+            const result = await action.run();
+            if (result.code !== 0) {
+                throw new AgentSkillsError(ErrorCode.IO_ERROR, 'Could not update senior-skills', {
+                    details: [safeText(result.stderr || result.stdout)],
+                    hints: [safeText(action.label)],
+                });
+            }
+            write('senior-skills updated. Run your command again to use the new version.');
+            return true;
+        }
+        if (choice === choices.length - 1)
+            await services.check.dismiss([notice]);
+        else
+            await services.check.remindLater([notice]);
+    }
+    const skills = notices.skills;
+    if (skills.length === 0)
+        return false;
+    const compatible = skills.filter((item) => !item.requiresMajor);
+    const major = skills.filter((item) => item.requiresMajor);
+    for (;;) {
+        const choices = [
+            ...(compatible.length > 0
+                ? [{ id: 'update', label: 'Update now (compatible versions)' }]
+                : []),
+            { id: 'details', label: 'View details' },
+            ...(major.length > 0 ? [{ id: 'major', label: 'Review major updates' }] : []),
+            { id: 'later', label: 'Remind me later' },
+            { id: 'skip', label: 'Skip these versions' },
+        ];
+        const selected = await services.prompt.choose(`Skill updates available\n\n${skills.map(summary).join('\n')}`, choices.map((item) => item.label));
+        const choice = selected === undefined ? 'later' : choices[selected]?.id;
+        if (choice === 'details') {
+            for (const item of skills) {
+                write(`${summary(item)}\n  Registry: ${safeText(item.registry)}\n  Directory: ${safeText(item.target.root)}`);
+            }
+            write('Dependencies are resolved during update. Modified files are protected by the installer.');
+            continue;
+        }
+        if (choice === 'skip') {
+            await services.check.dismiss(skills);
+            break;
+        }
+        if (choice === 'update' || choice === 'major') {
+            let selectedUpdates = compatible;
+            if (choice === 'major') {
+                const approved = await services.prompt.choose(`These updates cross the compatible version range (--major):\n\n${major.map(summary).join('\n')}`, ['Go back', 'Update including these major versions']);
+                if (approved !== 1)
+                    continue;
+                // A major candidate supersedes the compatible candidate for that installation.
+                const majorTargets = new Set(major.map(installationKey));
+                selectedUpdates = [
+                    ...compatible.filter((item) => !majorTargets.has(installationKey(item))),
+                    ...major,
+                ];
+            }
+            write('Updating skills...');
+            const reports = await services.apply.execute(selectedUpdates);
+            for (const report of reports) {
+                for (const result of report.results)
+                    write(`${result.outcome}: ${safeText(result.name)}@${result.version} (${safeText(result.agentId)}, ${result.scope})`);
+                for (const warning of report.warnings)
+                    write(safeText(warning));
+            }
+            break;
+        }
+        await services.check.remindLater(skills);
+        break;
+    }
+    return false;
+}
+function installationKey(item) {
+    return JSON.stringify([item.target.agentId, item.target.root, item.registry, item.name]);
+}
+function summary(item) {
+    return (`  ${safeText(item.name)}  ${item.current} -> ${item.version}  (${safeText(item.target.displayName)}, ${item.target.scope})` +
+        (item.requiresMajor ? ' [requires --major]' : '') +
+        (item.modified ? ' [modified locally]' : ''));
+}
+/** Registry names and custom roots may contain terminal control characters. */
+function safeText(value) {
+    // eslint-disable-next-line no-control-regex
+    return value.replace(/[\u0000-\u001f\u007f-\u009f]/g, ' ');
+}
+//# sourceMappingURL=update-notifications.js.map

package/dist/update-notifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-notifications.js","sourceRoot":"","sources":["../src/update-notifications.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@senior-skills/cli",
+  "version": "1.0.0",
+  "description": "Install, update and publish AI coding-agent skills across Claude Code, Codex and future agents",
+  "keywords": [
+    "senior-skills",
+    "claude-code",
+    "codex",
+    "ai",
+    "skills",
+    "package-manager",
+    "cli"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/robsonkades/senior-skills.git",
+    "directory": "packages/cli"
+  },
+  "type": "module",
+  "bin": {
+    "senior-skills": "bin/senior-skills.mjs"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@senior-skills/adapter-claude": "1.0.0",
+    "@senior-skills/adapter-codex": "1.0.0",
+    "@senior-skills/core": "1.0.0",
+    "@senior-skills/installer": "1.0.0",
+    "@senior-skills/node": "1.0.0",
+    "@senior-skills/registry": "1.0.0",
+    "commander": "^15.0.0",
+    "picocolors": "^1.1.1"
+  }
+}