agentic-workflow-manager 2.1.0 → 3.0.0

package/dist/tests/release/orchestrator.test.js

@@ -0,0 +1,188 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// cli/tests/release/orchestrator.test.ts
+const orchestrator_1 = require("../../src/release/orchestrator");
+const core_1 = require("../../src/release/core");
+function makeIO(over = {}) {
+    const calls = [];
+    let pkgVersion = '2.1.1';
+    const io = {
+        run(cmd, args) {
+            const full = `${cmd} ${args.join(' ')}`;
+            calls.push(full);
+            if (cmd === 'git' && args[0] === 'rev-parse' && args.includes('--abbrev-ref'))
+                return 'main';
+            if (cmd === 'git' && args[0] === 'status')
+                return '';
+            if (cmd === 'git' && args[0] === 'tag' && args[1] === '--list' && args[2] === 'v*')
+                return over.tags ?? '';
+            if (cmd === 'git' && args[0] === 'tag' && args[1] === '--list')
+                return ''; // gate: tag puntual no existe
+            if (cmd === 'git' && args[0] === 'log')
+                return over.commits ?? `feat: nueva${core_1.US}${core_1.RS}`;
+            if (cmd === 'npm' && args[0] === 'view')
+                return over.npmView ?? '';
+            return '';
+        },
+        readPackageVersion: () => pkgVersion,
+        writePackageVersion: (v) => { pkgVersion = v; calls.push(`WRITE_PKG ${v}`); },
+        readChangelog: () => '',
+        writeChangelog: (c) => calls.push(`WRITE_CHANGELOG ${c.split('\n')[0]}`),
+        writeNpmrc: () => calls.push('WRITE_NPMRC'),
+        removeNpmrc: () => calls.push('REMOVE_NPMRC'),
+        today: () => '2026-06-25',
+        log: () => { },
+        env: { NPM_TOKEN: 'tok' },
+        ...over,
+    };
+    return { io, calls };
+}
+const opts = (o = {}) => ({ dryRun: false, force: null, push: true, branch: 'main', cliDir: '/cli', ...o });
+describe('release — happy path', () => {
+    it('feat → minor: escribe versión, commitea, taggea, publica y pushea en orden', () => {
+        const { io, calls } = makeIO({ commits: `feat: x${core_1.US}${core_1.RS}` });
+        const res = (0, orchestrator_1.release)(opts(), io);
+        expect(res).toEqual({ released: true, version: '2.2.0' });
+        expect(calls).toContain('WRITE_PKG 2.2.0');
+        const joined = calls.join('\n');
+        expect(joined).toMatch(/git commit .*chore\(release\): v2.2.0/);
+        expect(joined).toMatch(/git tag -a v2.2.0/);
+        expect(joined).toMatch(/npm publish/);
+        expect(joined).toMatch(/git push origin main/);
+        expect(joined).toMatch(/git push origin v2.2.0/);
+        // npmrc creado y SIEMPRE removido
+        expect(calls).toContain('WRITE_NPMRC');
+        expect(calls).toContain('REMOVE_NPMRC');
+    });
+    it('sin commits releasables → no publica (exit 0 lógico)', () => {
+        const { io, calls } = makeIO({ commits: `docs: solo docs${core_1.US}${core_1.RS}` });
+        const res = (0, orchestrator_1.release)(opts(), io);
+        expect(res.released).toBe(false);
+        expect(res.reason).toMatch(/nada que publicar|no releasable/i);
+        expect(calls).not.toContain('WRITE_PKG 2.1.2');
+        expect(calls.join('\n')).not.toMatch(/npm publish/);
+    });
+    it('--force patch publica aunque no haya commits releasables', () => {
+        const { io } = makeIO({ commits: `docs: x${core_1.US}${core_1.RS}` });
+        expect((0, orchestrator_1.release)(opts({ force: 'patch' }), io)).toEqual({ released: true, version: '2.1.2' });
+    });
+    it('--dry-run calcula la versión pero NO escribe ni publica', () => {
+        const { io, calls } = makeIO({ commits: `feat: x${core_1.US}${core_1.RS}` });
+        const res = (0, orchestrator_1.release)(opts({ dryRun: true }), io);
+        expect(res).toEqual({ released: false, version: '2.2.0', reason: 'dry-run' });
+        expect(calls.join('\n')).not.toMatch(/npm publish|WRITE_PKG|git commit/);
+    });
+    it('OIDC via ACTIONS_ID_TOKEN_REQUEST_URL: usa --provenance y omite .npmrc', () => {
+        const { io, calls } = makeIO({ commits: `feat: x${core_1.US}${core_1.RS}` });
+        io.env = { ACTIONS_ID_TOKEN_REQUEST_URL: 'https://token.actions.githubusercontent.com/...' };
+        const res = (0, orchestrator_1.release)(opts(), io);
+        expect(res).toEqual({ released: true, version: '2.2.0' });
+        expect(calls.join('\n')).toMatch(/npm publish --provenance/);
+        expect(calls).not.toContain('WRITE_NPMRC');
+        expect(calls).not.toContain('REMOVE_NPMRC');
+    });
+    it('OIDC via NODE_AUTH_TOKEN sin NPM_TOKEN: usa --provenance y omite .npmrc', () => {
+        const { io, calls } = makeIO({ commits: `feat: x${core_1.US}${core_1.RS}` });
+        io.env = { NODE_AUTH_TOKEN: 'oidc-tok' };
+        const res = (0, orchestrator_1.release)(opts(), io);
+        expect(res).toEqual({ released: true, version: '2.2.0' });
+        expect(calls.join('\n')).toMatch(/npm publish --provenance/);
+        expect(calls).not.toContain('WRITE_NPMRC');
+    });
+    it('--no-push omite los push', () => {
+        const { io, calls } = makeIO({ commits: `feat: x${core_1.US}${core_1.RS}` });
+        (0, orchestrator_1.release)(opts({ push: false }), io);
+        expect(calls.join('\n')).not.toMatch(/git push/);
+    });
+});
+describe('release — gates de preflight', () => {
+    it('aborta si la rama no es la esperada', () => {
+        const fake = makeIO().io;
+        const origRun = fake.run;
+        fake.run = (cmd, args, o) => cmd === 'git' && args[0] === 'rev-parse' ? 'feature/x' : origRun(cmd, args, o);
+        expect(() => (0, orchestrator_1.release)(opts(), fake)).toThrow(/rama|branch/i);
+    });
+    it('--force relaja el gate de rama', () => {
+        const fake = makeIO({ commits: `feat: x${core_1.US}${core_1.RS}` }).io;
+        const origRun = fake.run;
+        fake.run = (cmd, args, o) => cmd === 'git' && args[0] === 'rev-parse' ? 'feature/x' : origRun(cmd, args, o);
+        expect(() => (0, orchestrator_1.release)(opts({ force: 'patch' }), fake)).not.toThrow();
+    });
+    it('aborta si el working tree está sucio', () => {
+        const fake = makeIO().io;
+        const origRun = fake.run;
+        fake.run = (cmd, args, o) => cmd === 'git' && args[0] === 'status' ? ' M cli/src/x.ts' : origRun(cmd, args, o);
+        expect(() => (0, orchestrator_1.release)(opts(), fake)).toThrow(/working tree|sin commitear|dirty/i);
+    });
+    it('aborta si no hay credencial de publicación', () => {
+        const fake = makeIO().io;
+        fake.env = {};
+        expect(() => (0, orchestrator_1.release)(opts(), fake)).toThrow(/NPM_TOKEN|NODE_AUTH_TOKEN|OIDC/i);
+    });
+    it('el gate de credencial corre ANTES del early-exit de "nada que publicar"', () => {
+        const fake = makeIO({ commits: `docs: x${core_1.US}${core_1.RS}` }).io; // sin commits releasables
+        fake.env = {};
+        expect(() => (0, orchestrator_1.release)(opts(), fake)).toThrow(/NPM_TOKEN|NODE_AUTH_TOKEN|OIDC/i); // no devuelve {released:false}
+    });
+    it('--dry-run no exige NPM_TOKEN ni working tree limpio', () => {
+        const fake = makeIO({ commits: `feat: x${core_1.US}${core_1.RS}` }).io;
+        fake.env = {};
+        const origRun = fake.run;
+        fake.run = (cmd, args, o) => cmd === 'git' && args[0] === 'status' ? ' M x' : origRun(cmd, args, o);
+        expect((0, orchestrator_1.release)(opts({ dryRun: true }), fake).version).toBe('2.2.0');
+    });
+});
+describe('release — rollback', () => {
+    it('si npm publish falla, hace rollback del commit y del tag', () => {
+        const { io, calls } = makeIO({ commits: `feat: x${core_1.US}${core_1.RS}` });
+        const origRun = io.run;
+        io.run = (cmd, args, o) => {
+            if (cmd === 'npm' && args[0] === 'publish')
+                throw new Error('network error');
+            return origRun(cmd, args, o);
+        };
+        expect(() => (0, orchestrator_1.release)(opts(), io)).toThrow(/network error/i);
+        const joined = calls.join('\n');
+        expect(joined).toMatch(/git tag -d v2.2.0/);
+        expect(joined).toMatch(/git reset --hard HEAD~1/);
+        expect(calls).toContain('REMOVE_NPMRC'); // .npmrc siempre se limpia
+    });
+});
+describe('release — gates de idempotencia', () => {
+    it('aborta si el tag v2.2.0 ya existe en git', () => {
+        const { io } = makeIO({ commits: `feat: x${core_1.US}${core_1.RS}` });
+        const origRun = io.run;
+        io.run = (cmd, args, o) => {
+            if (cmd === 'git' && args[0] === 'tag' && args[1] === '--list' && args[2] === 'v2.2.0')
+                return 'v2.2.0';
+            return origRun(cmd, args, o);
+        };
+        expect(() => (0, orchestrator_1.release)(opts(), io)).toThrow(/ya existe|v2\.2\.0/i);
+    });
+    it('aborta si agentic-workflow-manager@2.2.0 ya está publicado en npm', () => {
+        const { io } = makeIO({ commits: `feat: x${core_1.US}${core_1.RS}` });
+        const origRun = io.run;
+        io.run = (cmd, args, o) => {
+            if (cmd === 'npm' && args[0] === 'view' && args[1] === 'agentic-workflow-manager@2.2.0')
+                return '2.2.0';
+            return origRun(cmd, args, o);
+        };
+        expect(() => (0, orchestrator_1.release)(opts(), io)).toThrow(/ya está publicado|2\.2\.0/i);
+    });
+});
+const index_1 = require("../../src/release/index");
+describe('parseArgs', () => {
+    it('defaults', () => {
+        expect((0, index_1.parseArgs)([])).toMatchObject({ dryRun: false, force: null, push: true, branch: 'main' });
+    });
+    it('--dry-run, --no-push, --force minor, --branch release', () => {
+        expect((0, index_1.parseArgs)(['--dry-run', '--no-push', '--force', 'minor', '--branch', 'release']))
+            .toMatchObject({ dryRun: true, push: false, force: 'minor', branch: 'release' });
+    });
+    it('rechaza --force con nivel inválido', () => {
+        expect(() => (0, index_1.parseArgs)(['--force', 'huge'])).toThrow(/force/i);
+    });
+    it('--branch sin valor lanza error', () => {
+        expect(() => (0, index_1.parseArgs)(['--branch'])).toThrow(/--branch requiere/i);
+    });
+});

package/dist/tests/ui/picker-reducer.test.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const picker_1 = require("../../src/ui/picker");
+const items = [
+    { value: picker_1.ALL_SENTINEL, label: '✨ Install entire package (2)', description: '' },
+    { value: 'skill:a', label: 'alpha', description: '' },
+    { value: 'skill:b', label: 'beta', description: '' },
+];
+const base = (over = {}) => ({
+    title: 't', items, selected: new Set(), cursor: 0, filter: '', ...over,
+});
+describe('parseKey', () => {
+    it('maps arrow and control sequences', () => {
+        expect((0, picker_1.parseKey)('\x1b[A')).toEqual({ action: 'up' });
+        expect((0, picker_1.parseKey)('\x1b[B')).toEqual({ action: 'down' });
+        expect((0, picker_1.parseKey)('\r')).toEqual({ action: 'confirm' });
+        expect((0, picker_1.parseKey)(' ')).toEqual({ action: 'toggle' });
+        expect((0, picker_1.parseKey)('\t')).toEqual({ action: 'toggleAll' });
+        expect((0, picker_1.parseKey)('\x03')).toEqual({ action: 'cancel' });
+        expect((0, picker_1.parseKey)('\x1b')).toEqual({ action: 'clearOrCancel' });
+        expect((0, picker_1.parseKey)('\x7f')).toEqual({ action: 'backspace' });
+    });
+    it('maps filter characters and ignores the rest', () => {
+        expect((0, picker_1.parseKey)('c')).toEqual({ action: 'char', char: 'c' });
+        expect((0, picker_1.parseKey)('-')).toEqual({ action: 'char', char: '-' });
+        expect((0, picker_1.parseKey)('?')).toEqual({ action: 'none' });
+    });
+});
+describe('pickerReducer', () => {
+    it('moves the cursor and wraps around', () => {
+        expect((0, picker_1.pickerReducer)(base({ cursor: 0 }), { type: 'up' }).cursor).toBe(2);
+        expect((0, picker_1.pickerReducer)(base({ cursor: 2 }), { type: 'down' }).cursor).toBe(0);
+    });
+    it('toggles the current item', () => {
+        const s = (0, picker_1.pickerReducer)(base({ cursor: 1 }), { type: 'toggle' });
+        expect(s.selected.has('skill:a')).toBe(true);
+        const s2 = (0, picker_1.pickerReducer)(s, { type: 'toggle' });
+        expect(s2.selected.has('skill:a')).toBe(false);
+    });
+    it('toggling the ALL sentinel selects every real item plus the sentinel', () => {
+        const s = (0, picker_1.pickerReducer)(base({ cursor: 0 }), { type: 'toggle' });
+        expect(s.selected.has('skill:a')).toBe(true);
+        expect(s.selected.has('skill:b')).toBe(true);
+        expect(s.selected.has(picker_1.ALL_SENTINEL)).toBe(true);
+    });
+    it('Tab toggles all real items without needing the sentinel row', () => {
+        const s = (0, picker_1.pickerReducer)(base(), { type: 'toggleAll' });
+        expect(s.selected.has('skill:a')).toBe(true);
+        expect(s.selected.has('skill:b')).toBe(true);
+        expect(s.selected.has(picker_1.ALL_SENTINEL)).toBe(true);
+    });
+    it('toggleAll via Tab syncs ALL_SENTINEL when all become selected', () => {
+        const s = (0, picker_1.pickerReducer)(base(), { type: 'toggleAll' });
+        expect(s.selected.has('skill:a')).toBe(true);
+        expect(s.selected.has('skill:b')).toBe(true);
+        expect(s.selected.has(picker_1.ALL_SENTINEL)).toBe(true);
+    });
+    it('typing filters and resets the cursor to 0', () => {
+        const s = (0, picker_1.pickerReducer)(base({ cursor: 2 }), { type: 'filterChar', char: 'b' });
+        expect(s.filter).toBe('b');
+        expect(s.cursor).toBe(0);
+    });
+    it('backspace edits the filter', () => {
+        expect((0, picker_1.pickerReducer)(base({ filter: 'be' }), { type: 'backspace' }).filter).toBe('b');
+    });
+    it('does not move the cursor when the filtered list is empty', () => {
+        const s = base({ filter: 'zzz', cursor: 0 });
+        expect((0, picker_1.pickerReducer)(s, { type: 'down' }).cursor).toBe(0);
+    });
+    it('toggling an individual item off removes ALL_SENTINEL from selected', () => {
+        // Start with all items pre-selected (the initialSelected scenario)
+        const all = new Set([picker_1.ALL_SENTINEL, 'skill:a', 'skill:b']);
+        const s = (0, picker_1.pickerReducer)(base({ cursor: 1, selected: all }), { type: 'toggle' });
+        // Unchecked skill:a — sentinel should be gone
+        expect(s.selected.has('skill:a')).toBe(false);
+        expect(s.selected.has(picker_1.ALL_SENTINEL)).toBe(false);
+        expect(s.selected.has('skill:b')).toBe(true);
+    });
+    it('toggling the last missing item on syncs the ALL_SENTINEL', () => {
+        // skill:a is missing, skill:b is selected — select skill:a and sentinel should appear
+        const partial = new Set(['skill:b']);
+        const s = (0, picker_1.pickerReducer)(base({ cursor: 1, selected: partial }), { type: 'toggle' });
+        expect(s.selected.has('skill:a')).toBe(true);
+        expect(s.selected.has(picker_1.ALL_SENTINEL)).toBe(true);
+    });
+    it('toggleAll with active filter only toggles visible items', () => {
+        // filter to 'beta' — only skill:b is visible (ALL_SENTINEL label '✨ Install entire package (2)' does not match)
+        const s = (0, picker_1.pickerReducer)(base({ filter: 'beta' }), { type: 'toggleAll' });
+        expect(s.selected.has('skill:b')).toBe(true);
+        expect(s.selected.has('skill:a')).toBe(false); // not visible, should NOT be selected
+    });
+});

package/dist/tests/ui/picker-shell.test.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const events_1 = require("events");
+const picker_1 = require("../../src/ui/picker");
+function fakeIO() {
+    const input = new events_1.EventEmitter();
+    input.setRawMode = jest.fn();
+    input.resume = jest.fn();
+    input.pause = jest.fn();
+    input.setEncoding = jest.fn();
+    const writes = [];
+    const output = { write: (s) => { writes.push(s); return true; }, columns: 100, rows: 20 };
+    return { io: { input, output }, writes, send: (s) => input.emit('data', s) };
+}
+const items = [
+    { value: picker_1.ALL_SENTINEL, label: '✨ all', description: '' },
+    { value: 'skill:a', label: 'alpha', description: 'A.' },
+    { value: 'skill:b', label: 'beta', description: 'B.' },
+];
+it('resolves with the toggled selection on Enter', async () => {
+    const { io, send } = fakeIO();
+    const p = (0, picker_1.multiselectPicker)({ title: 't', items }, io);
+    send('\x1b[B'); // down → cursor on alpha
+    send(' '); // toggle alpha
+    send('\r'); // confirm
+    await expect(p).resolves.toEqual(['skill:a']);
+    expect(io.input.setRawMode).toHaveBeenLastCalledWith(false); // restored
+});
+it('resolves null on Ctrl-C and restores raw mode', async () => {
+    const { io, send } = fakeIO();
+    const p = (0, picker_1.multiselectPicker)({ title: 't', items }, io);
+    send('\x03');
+    await expect(p).resolves.toBeNull();
+    expect(io.input.setRawMode).toHaveBeenLastCalledWith(false);
+});
+it('seeds the initial selection', async () => {
+    const { io, send } = fakeIO();
+    const p = (0, picker_1.multiselectPicker)({ title: 't', items, initialSelected: [picker_1.ALL_SENTINEL, 'skill:a', 'skill:b'] }, io);
+    send('\r');
+    const result = await p;
+    expect(new Set(result)).toEqual(new Set([picker_1.ALL_SENTINEL, 'skill:a', 'skill:b']));
+});
+it('Esc with empty filter cancels and returns null', async () => {
+    const { io, send } = fakeIO();
+    const p = (0, picker_1.multiselectPicker)({ title: 't', items }, io);
+    send('\x1b'); // Esc with no active filter → cancel
+    await expect(p).resolves.toBeNull();
+    expect(io.input.setRawMode).toHaveBeenLastCalledWith(false);
+});
+it('Esc with active filter clears it instead of cancelling', async () => {
+    const { io, send } = fakeIO();
+    const p = (0, picker_1.multiselectPicker)({ title: 't', items }, io);
+    send('a'); // type 'a' → filter becomes 'a'
+    send('\x1b'); // Esc → should clear filter, NOT cancel
+    send('\r'); // Enter → confirm (with no selection)
+    await expect(p).resolves.toEqual([]);
+    // setRawMode(false) called on confirm, not on Esc
+    expect(io.input.setRawMode).toHaveBeenLastCalledWith(false);
+});

package/dist/tests/ui/picker-view.test.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const picker_view_1 = require("../../src/ui/picker-view");
+const items = [
+    { value: 'skill:architecture-advisor', label: 'architecture-advisor', description: 'Define and review system architecture.' },
+    { value: 'skill:brainstorming', label: 'brainstorming', description: 'Turn ideas into designs.' },
+    { value: 'skill:cicd-proposal-builder', label: 'cicd-proposal-builder', description: 'Specialist in CI/CD pipeline design. Use when defining a pipeline.' },
+];
+const base = (over = {}) => ({
+    title: 'dev — select artifacts',
+    items,
+    selected: new Set(),
+    cursor: 0,
+    filter: '',
+    ...over,
+});
+describe('visibleItems', () => {
+    it('returns all items with an empty filter', () => {
+        expect((0, picker_view_1.visibleItems)(base())).toHaveLength(3);
+    });
+    it('filters by label substring, case-insensitive', () => {
+        expect((0, picker_view_1.visibleItems)(base({ filter: 'CIC' })).map((i) => i.value)).toEqual(['skill:cicd-proposal-builder']);
+    });
+});
+describe('renderPicker', () => {
+    it('shows the title in the header', () => {
+        const lines = (0, picker_view_1.renderPicker)(base(), { columns: 100, rows: 20 });
+        expect(lines[0]).toContain('dev — select artifacts');
+    });
+    it('marks the cursor row and selected rows', () => {
+        const lines = (0, picker_view_1.renderPicker)(base({ cursor: 1, selected: new Set(['skill:brainstorming']) }), { columns: 100, rows: 20 });
+        const body = lines.join('\n');
+        expect(body).toContain('❯'); // cursor marker
+        expect(body).toContain('◼'); // a selected checkbox
+        expect(body).toContain('◻'); // an unselected checkbox
+    });
+    it('uses two panes (a gutter) when wide', () => {
+        const lines = (0, picker_view_1.renderPicker)(base(), { columns: picker_view_1.TWO_PANE_MIN_COLUMNS + 10, rows: 20 });
+        expect(lines.some((l) => l.includes(' │ '))).toBe(true);
+    });
+    it('collapses to one pane (no gutter) when narrow', () => {
+        const lines = (0, picker_view_1.renderPicker)(base(), { columns: 50, rows: 20 });
+        expect(lines.some((l) => l.includes(' │ '))).toBe(false);
+        // the highlighted item's description still appears below the list
+        expect(lines.join('\n')).toContain('Define and review');
+    });
+    it('shows the filter text in the header when filtering', () => {
+        expect((0, picker_view_1.renderPicker)(base({ filter: 'cic' }), { columns: 100, rows: 20 })[0]).toContain('filter: cic');
+    });
+    it('reports no matches when the filter excludes everything', () => {
+        expect((0, picker_view_1.renderPicker)(base({ filter: 'zzz' }), { columns: 100, rows: 20 }).join('\n').toLowerCase()).toContain('no matches');
+    });
+    it('always ends with the key hint footer', () => {
+        const lines = (0, picker_view_1.renderPicker)(base(), { columns: 100, rows: 20 });
+        expect(lines[lines.length - 1]).toContain('confirm');
+    });
+});

package/dist/tests/ui/text.test.js

@@ -0,0 +1,55 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const text_1 = require("../../src/ui/text");
+const picocolors_1 = __importDefault(require("picocolors"));
+describe('stripAnsi', () => {
+    it('removes color escape sequences', () => {
+        expect((0, text_1.stripAnsi)(picocolors_1.default.green('hi'))).toBe('hi');
+    });
+});
+describe('displayWidth', () => {
+    it('counts plain ASCII one cell each', () => {
+        expect((0, text_1.displayWidth)('hello')).toBe(5);
+    });
+    it('ignores color codes', () => {
+        expect((0, text_1.displayWidth)(picocolors_1.default.red('abc'))).toBe(3);
+    });
+    it('counts an emoji as two cells and ignores the VS16 selector', () => {
+        expect((0, text_1.displayWidth)('📦')).toBe(2);
+        expect((0, text_1.displayWidth)('✍️')).toBe(2);
+    });
+    it('counts CJK ideographs as 2 cells', () => {
+        expect((0, text_1.displayWidth)('你好')).toBe(4);
+    });
+    it('counts Hangul syllables as 2 cells', () => {
+        expect((0, text_1.displayWidth)('안녕')).toBe(4);
+    });
+    it('counts fullwidth Latin as 2 cells', () => {
+        // U+FF21 = Ａ (fullwidth A)
+        expect((0, text_1.displayWidth)('ＡＢ')).toBe(4);
+    });
+});
+describe('truncate', () => {
+    it('returns the string unchanged when it fits', () => {
+        expect((0, text_1.truncate)('abc', 5)).toBe('abc');
+    });
+    it('truncates and appends an ellipsis, never exceeding width', () => {
+        const out = (0, text_1.truncate)('abcdefgh', 5);
+        expect(out).toBe('abcd…');
+        expect((0, text_1.displayWidth)(out)).toBeLessThanOrEqual(5);
+    });
+    it('returns empty for non-positive width', () => {
+        expect((0, text_1.truncate)('abc', 0)).toBe('');
+    });
+});
+describe('wrap', () => {
+    it('breaks text at word boundaries within width', () => {
+        expect((0, text_1.wrap)('the quick brown fox', 9)).toEqual(['the quick', 'brown fox']);
+    });
+    it('returns a single empty line for empty input', () => {
+        expect((0, text_1.wrap)('', 10)).toEqual(['']);
+    });
+});

package/dist/tests/ui/tty.test.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tty_1 = require("../../src/ui/tty");
+describe('isInteractive', () => {
+    const outTTY = process.stdout.isTTY;
+    const inTTY = process.stdin.isTTY;
+    afterEach(() => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: outTTY, configurable: true });
+        Object.defineProperty(process.stdin, 'isTTY', { value: inTTY, configurable: true });
+    });
+    it('is true only when both stdin and stdout are TTYs', () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true });
+        Object.defineProperty(process.stdin, 'isTTY', { value: true, configurable: true });
+        expect((0, tty_1.isInteractive)()).toBe(true);
+    });
+    it('is false when stdout is not a TTY (piped output)', () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: false, configurable: true });
+        Object.defineProperty(process.stdin, 'isTTY', { value: true, configurable: true });
+        expect((0, tty_1.isInteractive)()).toBe(false);
+    });
+});
+describe('terminalSize', () => {
+    const cols = process.stdout.columns;
+    const rows = process.stdout.rows;
+    afterEach(() => {
+        Object.defineProperty(process.stdout, 'columns', { value: cols, configurable: true });
+        Object.defineProperty(process.stdout, 'rows', { value: rows, configurable: true });
+    });
+    it('reports the stdout dimensions', () => {
+        Object.defineProperty(process.stdout, 'columns', { value: 120, configurable: true });
+        Object.defineProperty(process.stdout, 'rows', { value: 40, configurable: true });
+        expect((0, tty_1.terminalSize)()).toEqual({ columns: 120, rows: 40 });
+    });
+    it('falls back to 80x24 when dimensions are undefined', () => {
+        Object.defineProperty(process.stdout, 'columns', { value: undefined, configurable: true });
+        Object.defineProperty(process.stdout, 'rows', { value: undefined, configurable: true });
+        expect((0, tty_1.terminalSize)()).toEqual({ columns: 80, rows: 24 });
+    });
+});

package/dist/tests/utils/registry-view.test.js

@@ -89,42 +89,6 @@ describe('findPackage', () => {
         expect(res.suggestion).toBe('core-dev');
     });
 });
-describe('buildLevel1Options', () => {
-    it('produces one option per package keyed by package name', () => {
-        const view = (0, registry_view_1.buildPackageView)([skill('brainstorming'), skill('shared')], [], [], processes);
-        const opts = (0, registry_view_1.buildLevel1Options)(view);
-        expect(opts.map((o) => o.value).sort()).toEqual(['core-dev', 'docs']);
-        expect(opts.find((o) => o.value === 'core-dev').label).toContain('core-dev');
-        expect(opts.find((o) => o.value === 'core-dev').label).toContain('Dev lifecycle');
-    });
-    it('uses artifact-count label for standalone packages', () => {
-        const view = (0, registry_view_1.buildPackageView)([skill('orphan')], [], [], []);
-        const opts = (0, registry_view_1.buildLevel1Options)(view);
-        expect(opts[0].value).toBe(registry_view_1.STANDALONE_NAME);
-        expect(opts[0].label).toContain('1 artifact');
-    });
-});
-describe('buildLevel2Options', () => {
-    it('puts an "install entire package" sentinel first, then one option per artifact', () => {
-        const view = (0, registry_view_1.buildPackageView)([skill('brainstorming', 'explore')], [wf('exec')], [agent('plan')], processes);
-        const core = view.find((p) => p.name === 'core-dev');
-        const opts = (0, registry_view_1.buildLevel2Options)(core);
-        expect(opts[0].value).toBe(registry_view_1.ALL_SENTINEL);
-        expect(opts[0].label).toContain('Install entire package');
-        const values = opts.slice(1).map((o) => o.value);
-        expect(values).toContain('skill:brainstorming');
-        expect(values).toContain('workflow:exec');
-        expect(values).toContain('agent:plan');
-        expect(opts.find((o) => o.value === 'skill:brainstorming').label).toContain('explore');
-    });
-    it('uses plain title for artifact with no description', () => {
-        const view = (0, registry_view_1.buildPackageView)([skill('brainstorming', 'explore')], [wf('exec')], [agent('plan')], processes);
-        const core = view.find((p) => p.name === 'core-dev');
-        const opts = (0, registry_view_1.buildLevel2Options)(core);
-        const wfOpt = opts.find((o) => o.value === 'workflow:exec');
-        expect(wfOpt.label).toBe('⚡ exec');
-    });
-});
 describe('resolveLevel2Selection', () => {
     const view = (0, registry_view_1.buildPackageView)([skill('brainstorming'), skill('shared')], [], [], processes);
     const core = view.find((p) => p.name === 'core-dev');
@@ -154,3 +118,42 @@ describe('visibility', () => {
         expect(view.find((p) => p.name === 'core-dev').visibility).toBe('public');
     });
 });
+describe('packageSummaryLines width-awareness', () => {
+    it('truncates the description column when a width is given', () => {
+        const view = (0, registry_view_1.buildPackageView)([skill('brainstorming', 'x'.repeat(200))], [], [], [
+            bundle({ name: 'core-dev', description: 'x'.repeat(200), skills: [{ name: 'brainstorming', onSignal: false }] }),
+        ]);
+        const lines = (0, registry_view_1.packageSummaryLines)(view, 60);
+        for (const l of lines)
+            expect(l.length).toBeLessThanOrEqual(60);
+        expect(lines.some((l) => l.includes('…'))).toBe(true);
+    });
+    it('does not truncate when no width is given (piped output)', () => {
+        const view = (0, registry_view_1.buildPackageView)([skill('brainstorming', 'y'.repeat(200))], [], [], [
+            bundle({ name: 'core-dev', description: 'z'.repeat(200), skills: [{ name: 'brainstorming', onSignal: false }] }),
+        ]);
+        const lines = (0, registry_view_1.packageSummaryLines)(view); // no width
+        expect(lines.some((l) => l.includes('z'.repeat(200)))).toBe(true);
+    });
+});
+describe('artifactPickerItems', () => {
+    it('prepends an "install entire package" sentinel item, then one per artifact', () => {
+        const view = (0, registry_view_1.buildPackageView)([skill('a', 'desc a'), skill('b', 'desc b')], [], [], [
+            bundle({ name: 'p', description: 'pkg', skills: [{ name: 'a', onSignal: false }, { name: 'b', onSignal: false }] }),
+        ]);
+        const items = (0, registry_view_1.artifactPickerItems)(view.find((p) => p.name === 'p'));
+        expect(items[0].value).toBe(registry_view_1.ALL_SENTINEL);
+        expect(items.slice(1).map((i) => i.label)).toEqual(['a', 'b']);
+        expect(items.find((i) => i.label === 'a').description).toBe('desc a');
+    });
+});
+describe('packagePickerItems', () => {
+    it('builds one item per package with a count+description summary', () => {
+        const view = (0, registry_view_1.buildPackageView)([skill('a')], [], [], [
+            bundle({ name: 'p', description: 'pkg desc', skills: [{ name: 'a', onSignal: false }] }),
+        ]);
+        const items = (0, registry_view_1.packagePickerItems)(view);
+        expect(items[0].value).toBe('p');
+        expect(items[0].description).toContain('pkg desc');
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-workflow-manager",
-  "version": "2.1.0",
+  "version": "3.0.0",
   "main": "dist/src/index.js",
   "bin": {
     "awm": "./dist/src/index.js"
@@ -20,6 +20,8 @@
     "build": "tsc && chmod +x dist/src/index.js",
     "test": "jest --runInBand",
     "start": "ts-node src/index.ts",
+    "prerelease": "npm run build",
+    "release": "node dist/src/release/index.js",
     "prepack": "npm run build",
     "prepublishOnly": "npm run build"
   },