agentic-workflow-manager 2.0.0

package/dist/tests/utils/grouping.test.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const grouping_1 = require("../../src/utils/grouping");
+const bundle = (over) => ({
+    description: '', version: '1.0.0', scope: 'project', visibility: 'public',
+    dependsOn: [], skills: [], workflows: [], agents: [], ...over,
+});
+const processes = [
+    bundle({ name: 'core-dev', description: 'Core development skills',
+        skills: [{ name: 'brainstorming', onSignal: false }, { name: 'shared-skill', onSignal: false }],
+        workflows: [], agents: [] }),
+    bundle({ name: 'docs', description: 'Documentation skills',
+        skills: [{ name: 'docs-assistant', onSignal: false }, { name: 'shared-skill', onSignal: false }],
+        workflows: [], agents: [] }),
+];
+const formatLabel = (c) => c.baseName;
+describe('buildGroupedOptions', () => {
+    it('shows a skill that belongs to two processes in both process groups', () => {
+        const artifacts = [
+            { name: 'shared-skill', type: 'skill' }
+        ];
+        const options = (0, grouping_1.buildGroupedOptions)(artifacts, processes, formatLabel);
+        const groupLabels = options
+            .filter(o => o.value._group)
+            .map(o => o.value.processName);
+        expect(groupLabels).toContain('core-dev');
+        expect(groupLabels).toContain('docs');
+    });
+    it('shows a skill only in standalone when it belongs to no process', () => {
+        const artifacts = [
+            { name: 'orphan-skill', type: 'skill' }
+        ];
+        const options = (0, grouping_1.buildGroupedOptions)(artifacts, processes, formatLabel);
+        const groupLabels = options
+            .filter(o => o.value._group)
+            .map(o => o.value.processName);
+        const standaloneLabels = options
+            .filter(o => o.value._child)
+            .map(o => o.label);
+        expect(groupLabels).toHaveLength(0);
+        expect(standaloneLabels.some(l => l.includes('orphan-skill'))).toBe(true);
+    });
+});

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

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+describe('registry-view override markers', () => {
+    let tmpHome;
+    const origHome = process.env.HOME;
+    const origAwmHome = process.env.AWM_HOME;
+    beforeEach(() => {
+        tmpHome = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'awm-view-'));
+        process.env.HOME = tmpHome;
+        process.env.AWM_HOME = path_1.default.join(tmpHome, '.awm');
+        jest.resetModules();
+    });
+    afterEach(() => {
+        process.env.HOME = origHome;
+        if (origAwmHome === undefined)
+            delete process.env.AWM_HOME;
+        else
+            process.env.AWM_HOME = origAwmHome;
+        fs_1.default.rmSync(tmpHome, { recursive: true, force: true });
+    });
+    it('packageDetailLines marks an overridden skill with its registry name', () => {
+        const { REGISTRIES_DIR } = require('../../src/core/registries');
+        const { buildPackageView, packageDetailLines } = require('../../src/utils/registry-view');
+        const teamSkillPath = path_1.default.join(REGISTRIES_DIR, 'team-acme', 'skills', 'brainstorming');
+        const view = buildPackageView([{ name: 'brainstorming', path: teamSkillPath, description: 'd', overrode: '/old/path' }], [], [], []);
+        const lines = packageDetailLines(view[0]).join('\n');
+        expect(lines).toContain('brainstorming');
+        expect(lines).toContain('← team-acme (override)');
+    });
+    it('non-overridden artifacts carry no marker', () => {
+        const { buildPackageView, packageDetailLines } = require('../../src/utils/registry-view');
+        const view = buildPackageView([{ name: 'plain', path: '/any/skills/plain', description: 'd' }], [], [], []);
+        expect(packageDetailLines(view[0]).join('\n')).not.toContain('override');
+    });
+});

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

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const registry_view_1 = require("../../src/utils/registry-view");
+const skill = (name, description = '') => ({ name, path: `/s/${name}`, description });
+const wf = (name, description = '') => ({ name, path: `/w/${name}.md`, description });
+const agent = (name, description = '') => ({ name, path: `/a/${name}.md`, description });
+const bundle = (over) => ({
+    description: '', version: '1.0.0', scope: 'project', visibility: 'public',
+    dependsOn: [], skills: [], workflows: [], agents: [], ...over,
+});
+const processes = [
+    bundle({ name: 'core-dev', description: 'Dev lifecycle', scope: 'baseline',
+        skills: [{ name: 'brainstorming', onSignal: false }, { name: 'shared', onSignal: false }],
+        workflows: ['exec'], agents: ['plan'] }),
+    bundle({ name: 'docs', description: 'Docs as code',
+        skills: [{ name: 'shared', onSignal: false }] }),
+];
+describe('buildPackageView', () => {
+    it('groups artifacts under their package with correct counts and install names', () => {
+        const view = (0, registry_view_1.buildPackageView)([skill('brainstorming', 'explore'), skill('shared')], [wf('exec')], [agent('plan')], processes);
+        const core = view.find((p) => p.name === 'core-dev');
+        expect(core.description).toBe('Dev lifecycle');
+        expect(core.counts).toEqual({ skills: 2, workflows: 1, agents: 1 });
+        expect(core.artifacts.find((a) => a.type === 'skill' && a.name === 'brainstorming').installName).toBe('brainstorming');
+        expect(core.artifacts.find((a) => a.type === 'workflow').installName).toBe('exec.md');
+        expect(core.artifacts.find((a) => a.type === 'agent').installName).toBe('plan.md');
+        expect(core.artifacts.find((a) => a.name === 'brainstorming').description).toBe('explore');
+    });
+    it('places an artifact that belongs to two packages in both', () => {
+        const view = (0, registry_view_1.buildPackageView)([skill('shared')], [], [], processes);
+        const names = view.map((p) => p.name);
+        expect(names).toContain('core-dev');
+        expect(names).toContain('docs');
+    });
+    it('collects orphan artifacts into a standalone package', () => {
+        const view = (0, registry_view_1.buildPackageView)([skill('orphan')], [], [], processes);
+        const standalone = view.find((p) => p.name === registry_view_1.STANDALONE_NAME);
+        expect(standalone.isStandalone).toBe(true);
+        expect(standalone.artifacts.map((a) => a.name)).toEqual(['orphan']);
+    });
+    it('omits empty packages and omits standalone when there are no orphans', () => {
+        const view = (0, registry_view_1.buildPackageView)([skill('brainstorming')], [], [], processes);
+        expect(view.map((p) => p.name)).toEqual(['core-dev']);
+    });
+});
+describe('artifactCountLabel', () => {
+    it('labels a skills-only package', () => {
+        expect((0, registry_view_1.artifactCountLabel)({ skills: 30, workflows: 0, agents: 0 })).toBe('30 skills');
+    });
+    it('singularizes one skill', () => {
+        expect((0, registry_view_1.artifactCountLabel)({ skills: 1, workflows: 0, agents: 0 })).toBe('1 skill');
+    });
+    it('appends workflow and agent counts when present', () => {
+        expect((0, registry_view_1.artifactCountLabel)({ skills: 2, workflows: 1, agents: 1 })).toBe('2 skills · 1 workflow · 1 agent');
+    });
+});
+describe('packageSummaryLines', () => {
+    it('renders one aligned line per package plus a header count', () => {
+        const view = (0, registry_view_1.buildPackageView)([skill('brainstorming'), skill('shared')], [], [], processes);
+        const lines = (0, registry_view_1.packageSummaryLines)(view);
+        expect(lines[0]).toContain('2 packages');
+        expect(lines.some((l) => l.includes('core-dev') && l.includes('Dev lifecycle'))).toBe(true);
+        expect(lines.some((l) => l.includes('docs'))).toBe(true);
+    });
+});
+describe('packageDetailLines', () => {
+    it('lists each artifact and its description', () => {
+        const view = (0, registry_view_1.buildPackageView)([skill('brainstorming', 'explore intent')], [], [], processes);
+        const core = view.find((p) => p.name === 'core-dev');
+        const lines = (0, registry_view_1.packageDetailLines)(core).join('\n');
+        expect(lines).toContain('core-dev');
+        expect(lines).toContain('brainstorming');
+        expect(lines).toContain('explore intent');
+    });
+});
+describe('findPackage', () => {
+    const view = (0, registry_view_1.buildPackageView)([skill('brainstorming')], [], [], processes);
+    it('matches by exact name (case-insensitive)', () => {
+        expect((0, registry_view_1.findPackage)(view, 'Core-Dev').match.name).toBe('core-dev');
+    });
+    it('suggests the closest package on a miss', () => {
+        const res = (0, registry_view_1.findPackage)(view, 'cor');
+        expect(res.match).toBeUndefined();
+        expect(res.suggestion).toBe('core-dev');
+    });
+    it('falls back to prefix suggestion when no substring match exists', () => {
+        const res = (0, registry_view_1.findPackage)(view, 'xyz');
+        expect(res.match).toBeUndefined();
+        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');
+    it('returns all artifacts when the sentinel is selected', () => {
+        const out = (0, registry_view_1.resolveLevel2Selection)(core, [registry_view_1.ALL_SENTINEL]);
+        expect(out.map((a) => a.name).sort()).toEqual(['brainstorming', 'shared']);
+    });
+    it('returns only the cherry-picked artifacts otherwise', () => {
+        const out = (0, registry_view_1.resolveLevel2Selection)(core, ['skill:brainstorming']);
+        expect(out.map((a) => a.name)).toEqual(['brainstorming']);
+    });
+    it('returns empty array when no values are selected', () => {
+        expect((0, registry_view_1.resolveLevel2Selection)(core, [])).toEqual([]);
+    });
+});
+describe('visibility', () => {
+    it('marks a private bundle on its PackageView', () => {
+        const priv = [
+            bundle({ name: 'secret', description: 'private', visibility: 'private',
+                skills: [{ name: 'a', onSignal: false }] }),
+        ];
+        const view = (0, registry_view_1.buildPackageView)([skill('a')], [], [], priv);
+        expect(view.find((p) => p.name === 'secret').visibility).toBe('private');
+    });
+    it('defaults visibility to public', () => {
+        const view = (0, registry_view_1.buildPackageView)([skill('brainstorming')], [], [], processes);
+        expect(view.find((p) => p.name === 'core-dev').visibility).toBe('public');
+    });
+});

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "agentic-workflow-manager",
+  "version": "2.0.0",
+  "main": "dist/src/index.js",
+  "bin": {
+    "awm": "./dist/src/index.js"
+  },
+  "files": ["dist"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Kodria/agentic-workflow.git",
+    "directory": "cli"
+  },
+  "directories": {
+    "doc": "docs"
+  },
+  "scripts": {
+    "build": "tsc && chmod +x dist/src/index.js",
+    "test": "jest --runInBand",
+    "start": "ts-node src/index.ts",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "agentic",
+    "workflow",
+    "cli",
+    "skills",
+    "ai"
+  ],
+  "author": "Kodria",
+  "license": "ISC",
+  "description": "CLI to manage Agentic Workflows - install skills, workflows, and processes for AI agents",
+  "dependencies": {
+    "@clack/prompts": "^1.0.1",
+    "commander": "^14.0.3",
+    "picocolors": "^1.1.1",
+    "simple-git": "^3.32.2"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.3.0",
+    "dependency-cruiser": "^17.4.3",
+    "eslint": "^10.4.1",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.9.3"
+  }
+}