agentic-workflow-manager 9.2.0 → 9.2.1

package/dist/src/commands/update.js

@@ -21,6 +21,7 @@ exports.runUpdateCore = runUpdateCore;
 // instead (which already imports clack at the top and is never `require()`d
 // by tests).
 const picocolors_1 = __importDefault(require("picocolors"));
+const versioning_1 = require("../core/versioning");
 const paths_1 = require("../core/paths");
 const config_1 = require("../utils/config");
 const agent_targets_1 = require("../core/agent-targets");
@@ -89,8 +90,29 @@ async function runUpdateCore(options = {}, deps = {}) {
     for (const r of registryResults) {
         if (r.action === 'error')
             console.warn(picocolors_1.default.yellow(`  ⚠  registry ${r.name}: ${r.error}`));
-        else
-            console.log(picocolors_1.default.green(`  ✓ Registry ${r.name} ${r.action === 'pulled' ? 'updated' : 're-cloned'} @ ${r.version}`));
+        else if (r.disposition === 'regressed') {
+            const latest = r.availableVersion && r.availableVersion !== r.version
+                ? ` Latest available: ${r.availableVersion}.`
+                : '';
+            console.warn(picocolors_1.default.yellow(`  ⚠ Registry ${r.name} regressed ${r.previousVersion ?? '(previous version)'} → ${r.version} `
+                + `because it is pinned to v${(0, versioning_1.normalizePin)(r.pin ?? '')}.${latest} Run \`awm unpin ${r.name}\` to move forward.`));
+        }
+        else if (r.pin && r.availableVersion !== r.version) {
+            console.log(picocolors_1.default.yellow(`  ✓ Registry ${r.name} resolved @ ${r.version} (pinned to v${(0, versioning_1.normalizePin)(r.pin)}; `
+                + `latest available: ${r.availableVersion ?? 'unknown'}). Run \`awm unpin ${r.name}\` to move forward.`));
+        }
+        else if (r.disposition === 'unchanged') {
+            console.log(picocolors_1.default.dim(`  ✓ Registry ${r.name} already at ${r.version}`));
+        }
+        else if (r.disposition === 'advanced') {
+            console.log(picocolors_1.default.green(`  ✓ Registry ${r.name} updated @ ${r.version}`));
+        }
+        else if (r.disposition === 'installed') {
+            console.log(picocolors_1.default.green(`  ✓ Registry ${r.name} installed @ ${r.version}`));
+        }
+        else {
+            console.log(picocolors_1.default.green(`  ✓ Registry ${r.name} resolved @ ${r.version}`));
+        }
     }
     const registries = {
         configured: registryResults.length,

package/dist/src/core/registries.js

@@ -251,9 +251,11 @@ async function syncRegistries() {
                 await (0, simple_git_1.default)(reg.contentRoot).reset(['--hard']);
             }
             const git = (0, simple_git_1.default)(reg.contentRoot);
+            const previousVersion = freshClone ? null : await (0, versioning_1.currentVersion)(reg.contentRoot);
+            const versionOpts = (0, versioning_1.machineVersionOpts)(reg.name);
             let resolved;
             try {
-                resolved = await (0, versioning_1.resolveTargetRef)(reg.contentRoot, (0, versioning_1.machineVersionOpts)(reg.name));
+                resolved = await (0, versioning_1.resolveTargetRef)(reg.contentRoot, versionOpts);
                 await git.checkout(resolved.ref);
                 if (resolved.kind !== 'tag')
                     await git.pull('origin', resolved.ref);
@@ -266,10 +268,24 @@ async function syncRegistries() {
                     fs_1.default.rmSync(reg.contentRoot, { recursive: true, force: true });
                 throw e;
             }
+            const version = resolved.kind === 'tag' ? `v${resolved.version}` : 'HEAD';
+            let disposition;
+            if (freshClone)
+                disposition = 'installed';
+            else if (resolved.kind !== 'tag' || previousVersion === null)
+                disposition = 'resolved';
+            else {
+                const direction = (0, versioning_1.compareSemver)(resolved.version, previousVersion);
+                disposition = direction > 0 ? 'advanced' : direction < 0 ? 'regressed' : 'unchanged';
+            }
             results.push({
                 name: reg.name,
                 action: freshClone ? 'recloned' : 'pulled',
-                version: resolved.kind === 'tag' ? `v${resolved.version}` : 'HEAD',
+                version,
+                disposition,
+                ...(versionOpts.pin ? { pin: (0, versioning_1.normalizePin)(versionOpts.pin) } : {}),
+                ...(previousVersion ? { previousVersion: `v${previousVersion}` } : {}),
+                ...(resolved.kind === 'tag' ? { availableVersion: `v${resolved.latestVersion}` } : {}),
             });
         }
         catch (e) {

package/dist/src/core/versioning.js

@@ -69,7 +69,7 @@ async function resolveTargetRef(repoDir, opts) {
                 : 'the registry has no version tags';
             throw new Error(`Pinned version ${want} not found in ${repoDir} — ${available}`);
         }
-        return { kind: 'tag', ref: want, version: normalizePin(opts.pin) };
+        return { kind: 'tag', ref: want, version: normalizePin(opts.pin), latestVersion: tags[tags.length - 1].slice(1) };
     }
     const branch = await defaultBranch(git);
     if (opts.channel === 'dev')
@@ -77,7 +77,7 @@ async function resolveTargetRef(repoDir, opts) {
     if (tags.length === 0)
         return { kind: 'head-fallback', ref: branch };
     const latest = tags[tags.length - 1];
-    return { kind: 'tag', ref: latest, version: latest.slice(1) };
+    return { kind: 'tag', ref: latest, version: latest.slice(1), latestVersion: latest.slice(1) };
 }
 /** Versión checkouteada actual ("X.Y.Z") si HEAD coincide exactamente con un tag semver; null si sigue un branch. */
 async function currentVersion(repoDir) {

package/dist/tests/commands/update.test.js

@@ -125,6 +125,37 @@ describe('awm update — honest outcome', () => {
         expect(result.registries).toEqual({ configured: 2, synced: 2, failed: [] });
         expect(updateOutro(result)).toBe('✅ 2 registries, skills and hooks updated.');
     });
+    it('una regresión causada por pin se advierte y explica cómo volver a avanzar', async () => {
+        const { runUpdateCore } = require('../../src/commands/update');
+        await runUpdateCore({}, deps({
+            syncRegistries: async () => [{
+                    name: 'baseline',
+                    action: 'pulled',
+                    version: 'v1.0.0',
+                    disposition: 'regressed',
+                    pin: '1.0.0',
+                    availableVersion: 'v1.1.0',
+                }],
+        }));
+        const output = [...logSpy.mock.calls, ...warnSpy.mock.calls].flat().join('\n');
+        expect(output).toMatch(/regress/i);
+        expect(output).toMatch(/v1\.0\.0/);
+        expect(output).toMatch(/v1\.1\.0/);
+        expect(output).toMatch(/awm unpin baseline/);
+        expect(output).not.toMatch(/Registry baseline updated/i);
+    });
+    it('un pin que ya coincide con el último release no recomienda unpin', async () => {
+        const { runUpdateCore } = require('../../src/commands/update');
+        await runUpdateCore({}, deps({
+            syncRegistries: async () => [{
+                    name: 'baseline', action: 'pulled', version: 'v1.1.0', disposition: 'unchanged',
+                    pin: 'v1.1.0', availableVersion: 'v1.1.0',
+                }],
+        }));
+        const output = [...logSpy.mock.calls, ...warnSpy.mock.calls].flat().join('\n');
+        expect(output).toMatch(/already at v1\.1\.0/i);
+        expect(output).not.toMatch(/awm unpin baseline/);
+    });
     it('un registry que falló y NO dejó contenido en disco falla cerrado', async () => {
         const { runUpdateCore } = require('../../src/commands/update');
         const result = await runUpdateCore({}, deps({

package/dist/tests/core/registries-sync.test.js

@@ -79,7 +79,7 @@ describe('syncRegistries (git fixtures locales)', () => {
         const source = makeSourceRepo(tmpWork, 'alpha');
         m.writeRegistriesConfig([{ name: 'personal', remote: source }]);
         const results = await m.syncRegistries();
-        expect(results).toEqual([{ name: 'personal', action: 'recloned', version: 'HEAD' }]);
+        expect(results).toEqual([{ name: 'personal', action: 'recloned', version: 'HEAD', disposition: 'installed' }]);
         expect(fs_1.default.existsSync(path_1.default.join(tmpHome, '.awm/registries/personal/skills/alpha/SKILL.md'))).toBe(true);
     });
     it('pulls an existing clone and reports non-fatal errors per registry', async () => {
@@ -95,7 +95,7 @@ describe('syncRegistries (git fixtures locales)', () => {
         GIT(source, 'add -A');
         GIT(source, 'commit -qm v2');
         const results = await m.syncRegistries();
-        expect(results[0]).toEqual({ name: 'personal', action: 'pulled', version: 'HEAD' });
+        expect(results[0]).toEqual({ name: 'personal', action: 'pulled', version: 'HEAD', disposition: 'resolved' });
         expect(results[1].name).toBe('broken');
         expect(results[1].action).toBe('error');
         const synced = fs_1.default.readFileSync(path_1.default.join(tmpHome, '.awm/registries/personal/skills/alpha/SKILL.md'), 'utf-8');
@@ -127,7 +127,7 @@ describe('syncRegistries (git fixtures locales)', () => {
         GIT(source, 'commit -qm unreleased');
         m.writeRegistriesConfig([{ name: 'personal', remote: source }]);
         const results = await m.syncRegistries();
-        expect(results).toEqual([{ name: 'personal', action: 'recloned', version: 'v1.0.0' }]);
+        expect(results).toEqual([{ name: 'personal', action: 'recloned', version: 'v1.0.0', disposition: 'installed', availableVersion: 'v1.0.0' }]);
         const synced = fs_1.default.readFileSync(path_1.default.join(tmpHome, '.awm/registries/personal/skills/alpha/SKILL.md'), 'utf-8');
         expect(synced).toContain('test skill'); // contenido del tag, no del HEAD
     });
@@ -157,7 +157,9 @@ describe('syncRegistries (git fixtures locales)', () => {
         fs_1.default.mkdirSync(awmDir, { recursive: true });
         fs_1.default.writeFileSync(path_1.default.join(awmDir, 'preferences.json'), JSON.stringify({ defaultAgent: 'claude-code', installMethod: 'symlink', defaultScope: 'local', pins: { personal: '1.0.0' } }));
         const results = await m.syncRegistries();
-        expect(results).toEqual([{ name: 'personal', action: 'recloned', version: 'v1.0.0' }]);
+        expect(results).toEqual([{
+                name: 'personal', action: 'recloned', version: 'v1.0.0', disposition: 'installed', pin: '1.0.0', availableVersion: 'v1.1.0',
+            }]);
     });
     it('baseline sembrado se sincroniza por el mismo loop que cualquier registry', async () => {
         const m = require('../../src/core/registries');
@@ -167,7 +169,7 @@ describe('syncRegistries (git fixtures locales)', () => {
         m.seedBaselineRegistry();
         delete process.env.AWM_BASE_REMOTE;
         const results = await m.syncRegistries();
-        expect(results).toEqual([{ name: 'baseline', action: 'recloned', version: 'v1.0.0' }]);
+        expect(results).toEqual([{ name: 'baseline', action: 'recloned', version: 'v1.0.0', disposition: 'installed', availableVersion: 'v1.0.0' }]);
         expect(fs_1.default.existsSync(path_1.default.join(tmpHome, '.awm/registries/baseline/skills/alpha/SKILL.md'))).toBe(true);
     });
     it('verifyMinCliVersions reporta registries que exigen CLI más nuevo', async () => {
@@ -193,7 +195,7 @@ describe('syncRegistries (git fixtures locales)', () => {
         m.writeRegistriesConfig([{ name: 'personal', remote: source }]);
         // primera sync: queda en v1.0.0
         const r1 = await m.syncRegistries();
-        expect(r1).toEqual([{ name: 'personal', action: 'recloned', version: 'v1.0.0' }]);
+        expect(r1).toEqual([{ name: 'personal', action: 'recloned', version: 'v1.0.0', disposition: 'installed', availableVersion: 'v1.0.0' }]);
         // nueva release en el remote
         fs_1.default.writeFileSync(path_1.default.join(source, 'skills', 'alpha', 'SKILL.md'), '---\nname: alpha\ndescription: v2\n---\n');
         GIT(source, 'add -A');
@@ -201,9 +203,15 @@ describe('syncRegistries (git fixtures locales)', () => {
         GIT(source, 'tag v1.1.0');
         // segunda sync: avanza al nuevo tag
         const r2 = await m.syncRegistries();
-        expect(r2).toEqual([{ name: 'personal', action: 'pulled', version: 'v1.1.0' }]);
+        expect(r2).toEqual([{
+                name: 'personal', action: 'pulled', version: 'v1.1.0', disposition: 'advanced', previousVersion: 'v1.0.0', availableVersion: 'v1.1.0',
+            }]);
         const content = fs_1.default.readFileSync(path_1.default.join(tmpHome, '.awm/registries/personal/skills/alpha/SKILL.md'), 'utf-8');
         expect(content).toContain('v2');
+        const r3 = await m.syncRegistries();
+        expect(r3).toEqual([{
+                name: 'personal', action: 'pulled', version: 'v1.1.0', disposition: 'unchanged', previousVersion: 'v1.1.0', availableVersion: 'v1.1.0',
+            }]);
     });
     it('rollback tag→tag: clone en v1.1.0 retrocede a v1.0.0 al establecer pin', async () => {
         const m = require('../../src/core/registries');
@@ -216,13 +224,21 @@ describe('syncRegistries (git fixtures locales)', () => {
         m.writeRegistriesConfig([{ name: 'personal', remote: source }]);
         // primera sync sin pin: queda en v1.1.0
         const r1 = await m.syncRegistries();
-        expect(r1).toEqual([{ name: 'personal', action: 'recloned', version: 'v1.1.0' }]);
+        expect(r1).toEqual([{ name: 'personal', action: 'recloned', version: 'v1.1.0', disposition: 'installed', availableVersion: 'v1.1.0' }]);
         // establece pin a la versión anterior
         const awmDir = path_1.default.join(tmpHome, '.awm');
         fs_1.default.writeFileSync(path_1.default.join(awmDir, 'preferences.json'), JSON.stringify({ defaultAgent: 'claude-code', installMethod: 'symlink', defaultScope: 'local', pins: { personal: '1.0.0' } }));
         // segunda sync con pin: retrocede a v1.0.0
         const r2 = await m.syncRegistries();
-        expect(r2).toEqual([{ name: 'personal', action: 'pulled', version: 'v1.0.0' }]);
+        expect(r2).toEqual([{
+                name: 'personal',
+                action: 'pulled',
+                version: 'v1.0.0',
+                disposition: 'regressed',
+                pin: '1.0.0',
+                previousVersion: 'v1.1.0',
+                availableVersion: 'v1.1.0',
+            }]);
         const content = fs_1.default.readFileSync(path_1.default.join(tmpHome, '.awm/registries/personal/skills/alpha/SKILL.md'), 'utf-8');
         expect(content).toContain('test skill'); // contenido original del tag v1.0.0
     });
@@ -236,14 +252,16 @@ describe('syncRegistries (git fixtures locales)', () => {
         fs_1.default.writeFileSync(path_1.default.join(awmDir, 'preferences.json'), JSON.stringify({ defaultAgent: 'claude-code', installMethod: 'symlink', defaultScope: 'local', channel: 'dev' }));
         // primera sync en canal dev: queda en HEAD (no en el tag)
         const r1 = await m.syncRegistries();
-        expect(r1).toEqual([{ name: 'personal', action: 'recloned', version: 'HEAD' }]);
+        expect(r1).toEqual([{ name: 'personal', action: 'recloned', version: 'HEAD', disposition: 'installed' }]);
         // nuevo commit en el remote (post-tag, no release)
         fs_1.default.writeFileSync(path_1.default.join(source, 'skills', 'alpha', 'SKILL.md'), '---\nname: alpha\ndescription: head-2\n---\n');
         GIT(source, 'add -A');
         GIT(source, 'commit -qm head-2');
         // segunda sync: recibe el nuevo commit
         const r2 = await m.syncRegistries();
-        expect(r2).toEqual([{ name: 'personal', action: 'pulled', version: 'HEAD' }]);
+        expect(r2).toEqual([{
+                name: 'personal', action: 'pulled', version: 'HEAD', disposition: 'resolved', previousVersion: 'v1.0.0',
+            }]);
         const content = fs_1.default.readFileSync(path_1.default.join(tmpHome, '.awm/registries/personal/skills/alpha/SKILL.md'), 'utf-8');
         expect(content).toContain('head-2');
     });

package/dist/tests/core/versioning.test.js

@@ -62,16 +62,16 @@ describe('versioning core', () => {
             const clone = cloneOf(source, tmpWork, 'clone');
             const { resolveTargetRef } = require('../../src/core/versioning');
             const r = await resolveTargetRef(clone, { channel: 'stable' });
-            expect(r).toEqual({ kind: 'tag', ref: 'v1.10.0', version: '1.10.0' });
+            expect(r).toEqual({ kind: 'tag', ref: 'v1.10.0', version: '1.10.0', latestVersion: '1.10.0' });
         });
         it('pin exacto gana, con y sin prefijo v', async () => {
             const source = makeTaggedRepo(tmpWork, 'src', ['1.0.0', '1.1.0']);
             const clone = cloneOf(source, tmpWork, 'clone');
             const { resolveTargetRef } = require('../../src/core/versioning');
             expect(await resolveTargetRef(clone, { pin: '1.0.0', channel: 'stable' }))
-                .toEqual({ kind: 'tag', ref: 'v1.0.0', version: '1.0.0' });
+                .toEqual({ kind: 'tag', ref: 'v1.0.0', version: '1.0.0', latestVersion: '1.1.0' });
             expect(await resolveTargetRef(clone, { pin: 'v1.0.0', channel: 'stable' }))
-                .toEqual({ kind: 'tag', ref: 'v1.0.0', version: '1.0.0' });
+                .toEqual({ kind: 'tag', ref: 'v1.0.0', version: '1.0.0', latestVersion: '1.1.0' });
         });
         it('pin inexistente → error que lista las versiones disponibles', async () => {
             const source = makeTaggedRepo(tmpWork, 'src', ['1.0.0']);
@@ -102,7 +102,7 @@ describe('versioning core', () => {
             const clone = cloneOf(source, tmpWork, 'clone');
             const { resolveTargetRef } = require('../../src/core/versioning');
             const r = await resolveTargetRef(clone, { channel: 'stable' });
-            expect(r).toEqual({ kind: 'tag', ref: 'v1.0.0', version: '1.0.0' });
+            expect(r).toEqual({ kind: 'tag', ref: 'v1.0.0', version: '1.0.0', latestVersion: '1.0.0' });
         });
         it('hace fetch: ve tags creados en el remote después del clone', async () => {
             const source = makeTaggedRepo(tmpWork, 'src', ['1.0.0']);
@@ -114,7 +114,7 @@ describe('versioning core', () => {
             GIT(source, 'tag v1.1.0');
             const { resolveTargetRef } = require('../../src/core/versioning');
             const r = await resolveTargetRef(clone, { channel: 'stable' });
-            expect(r).toEqual({ kind: 'tag', ref: 'v1.1.0', version: '1.1.0' });
+            expect(r).toEqual({ kind: 'tag', ref: 'v1.1.0', version: '1.1.0', latestVersion: '1.1.0' });
         });
     });
     describe('currentVersion', () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-workflow-manager",
-  "version": "9.2.0",
+  "version": "9.2.1",
   "main": "dist/src/index.js",
   "bin": {
     "awm": "./dist/src/index.js"