@forgeportal/cli 1.3.0

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @forgeportal/cli@1.3.0 build /home/runner/work/forgeportal/forgeportal/packages/cli
+> tsc
+

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bendaamerahmed
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/__tests__/sync.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sync.test.d.ts.map

package/dist/__tests__/sync.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/sync.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/sync.test.js

@@ -0,0 +1,185 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { describe, it, expect, vi } from 'vitest';
+import { syncCommand } from '../commands/sync.js';
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function makeTmpRepo(opts) {
+    const root = fs.mkdtempSync(path.join(os.tmpdir(), 'forge-sync-test-'));
+    // forgeportal.yaml
+    const pluginList = opts.configPlugins?.map((p) => `    - "${p}"`).join('\n') ?? '';
+    fs.writeFileSync(path.join(root, 'forgeportal.yaml'), `
+pluginPackages:
+  packages:
+${pluginList}
+`.trimStart());
+    // apps/api/package.json
+    const apiDir = path.join(root, 'apps', 'api');
+    fs.mkdirSync(apiDir, { recursive: true });
+    fs.writeFileSync(path.join(apiDir, 'package.json'), JSON.stringify({
+        name: '@forgeportal/api',
+        dependencies: opts.apiDeps ?? {},
+    }, null, 2));
+    // apps/ui/package.json
+    const uiDir = path.join(root, 'apps', 'ui');
+    fs.mkdirSync(uiDir, { recursive: true });
+    fs.writeFileSync(path.join(uiDir, 'package.json'), JSON.stringify({
+        name: '@forgeportal/ui',
+        dependencies: opts.uiDeps ?? {},
+    }, null, 2));
+    // workspace plugins (simulate packages/ directory)
+    for (const plugin of opts.workspacePlugins ?? []) {
+        const pluginDir = path.join(root, 'packages', plugin.name.replace('@forgeportal/', ''));
+        fs.mkdirSync(pluginDir, { recursive: true });
+        fs.writeFileSync(path.join(pluginDir, 'package.json'), JSON.stringify({
+            name: plugin.name,
+            version: plugin.version ?? '1.0.0',
+        }, null, 2));
+        fs.writeFileSync(path.join(pluginDir, 'forgeportal-plugin.json'), JSON.stringify({
+            version: plugin.version ?? '1.0.0',
+            forgeportal: { type: plugin.type },
+        }, null, 2));
+    }
+    return root;
+}
+function readDeps(root, app) {
+    const pkgPath = path.join(root, 'apps', app, 'package.json');
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+    return pkg.dependencies ?? {};
+}
+// ─── Mock execSync so pnpm install doesn't run in tests ──────────────────────
+vi.mock('node:child_process', async (importOriginal) => {
+    const original = await importOriginal();
+    return {
+        ...original,
+        execSync: vi.fn((cmd, _opts) => {
+            if (String(cmd).startsWith('pnpm install'))
+                return '';
+            // Pass npm view to the original (we mock it per-test when needed)
+            throw new Error(`Unexpected execSync: ${cmd}`);
+        }),
+    };
+});
+// ─── Tests ────────────────────────────────────────────────────────────────────
+describe('forge sync — workspace plugin', () => {
+    it('adds a fullstack plugin to both api and ui', async () => {
+        const root = makeTmpRepo({
+            configPlugins: ['@forgeportal/plugin-kubernetes'],
+            workspacePlugins: [{ name: '@forgeportal/plugin-kubernetes', type: 'fullstack' }],
+        });
+        const result = await syncCommand({ root, ci: true });
+        expect(result.changed).toBe(true);
+        expect(result.apiAdded).toContain('@forgeportal/plugin-kubernetes');
+        expect(result.uiAdded).toContain('@forgeportal/plugin-kubernetes');
+        expect(readDeps(root, 'api')['@forgeportal/plugin-kubernetes']).toBe('workspace:*');
+        expect(readDeps(root, 'ui')['@forgeportal/plugin-kubernetes']).toBe('workspace:*');
+    });
+    it('adds a backend-only plugin only to api', async () => {
+        const root = makeTmpRepo({
+            configPlugins: ['@forgeportal/plugin-backend-only'],
+            workspacePlugins: [{ name: '@forgeportal/plugin-backend-only', type: 'backend' }],
+        });
+        await syncCommand({ root, ci: true });
+        expect(readDeps(root, 'api')['@forgeportal/plugin-backend-only']).toBe('workspace:*');
+        expect(readDeps(root, 'ui')['@forgeportal/plugin-backend-only']).toBeUndefined();
+    });
+    it('adds a ui-only plugin only to ui', async () => {
+        const root = makeTmpRepo({
+            configPlugins: ['@forgeportal/plugin-ui-only'],
+            workspacePlugins: [{ name: '@forgeportal/plugin-ui-only', type: 'ui' }],
+        });
+        await syncCommand({ root, ci: true });
+        expect(readDeps(root, 'api')['@forgeportal/plugin-ui-only']).toBeUndefined();
+        expect(readDeps(root, 'ui')['@forgeportal/plugin-ui-only']).toBe('workspace:*');
+    });
+    it('removes a plugin no longer in forgeportal.yaml', async () => {
+        const root = makeTmpRepo({
+            configPlugins: [],
+            apiDeps: { '@forgeportal/plugin-old': '^1.0.0' },
+            uiDeps: { '@forgeportal/plugin-old': '^1.0.0' },
+        });
+        // forgeportal.yaml has no plugins now
+        fs.writeFileSync(path.join(root, 'forgeportal.yaml'), 'pluginPackages:\n  packages: []\n');
+        await syncCommand({ root, ci: true });
+        expect(readDeps(root, 'api')['@forgeportal/plugin-old']).toBeUndefined();
+        expect(readDeps(root, 'ui')['@forgeportal/plugin-old']).toBeUndefined();
+    });
+    it('does not touch non-plugin deps when removing', async () => {
+        const root = makeTmpRepo({
+            configPlugins: [],
+            apiDeps: {
+                'express': '^4.18.0',
+                '@forgeportal/plugin-old': '^1.0.0',
+                '@forgeportal/core': '^1.0.0',
+            },
+        });
+        fs.writeFileSync(path.join(root, 'forgeportal.yaml'), 'pluginPackages:\n  packages: []\n');
+        await syncCommand({ root, ci: true });
+        const deps = readDeps(root, 'api');
+        expect(deps['express']).toBe('^4.18.0');
+        expect(deps['@forgeportal/core']).toBe('^1.0.0');
+        expect(deps['@forgeportal/plugin-old']).toBeUndefined();
+    });
+    it('returns changed:false when already in sync', async () => {
+        const root = makeTmpRepo({
+            configPlugins: ['@forgeportal/plugin-kubernetes'],
+            apiDeps: { '@forgeportal/plugin-kubernetes': 'workspace:*' },
+            uiDeps: { '@forgeportal/plugin-kubernetes': 'workspace:*' },
+            workspacePlugins: [{ name: '@forgeportal/plugin-kubernetes', type: 'fullstack' }],
+        });
+        const result = await syncCommand({ root, ci: true });
+        expect(result.changed).toBe(false);
+    });
+});
+describe('forge sync --dry-run', () => {
+    it('does not modify package.json files', async () => {
+        const root = makeTmpRepo({
+            configPlugins: ['@forgeportal/plugin-kubernetes'],
+            workspacePlugins: [{ name: '@forgeportal/plugin-kubernetes', type: 'fullstack' }],
+        });
+        const before = JSON.stringify(readDeps(root, 'api'));
+        await syncCommand({ root, dryRun: true });
+        expect(JSON.stringify(readDeps(root, 'api'))).toBe(before);
+    });
+    it('reports changed:true without writing', async () => {
+        const root = makeTmpRepo({
+            configPlugins: ['@forgeportal/plugin-kubernetes'],
+            workspacePlugins: [{ name: '@forgeportal/plugin-kubernetes', type: 'fullstack' }],
+        });
+        const result = await syncCommand({ root, dryRun: true });
+        expect(result.changed).toBe(true);
+        expect(readDeps(root, 'api')['@forgeportal/plugin-kubernetes']).toBeUndefined();
+    });
+});
+describe('forge sync --check', () => {
+    it('exits 1 when out of sync', async () => {
+        const root = makeTmpRepo({
+            configPlugins: ['@forgeportal/plugin-kubernetes'],
+            workspacePlugins: [{ name: '@forgeportal/plugin-kubernetes', type: 'fullstack' }],
+        });
+        const exitSpy = vi.spyOn(process, 'exit').mockImplementation((_code) => {
+            throw new Error(`process.exit(${_code})`);
+        });
+        await expect(syncCommand({ root, check: true })).rejects.toThrow('process.exit(1)');
+        expect(exitSpy).toHaveBeenCalledWith(1);
+        exitSpy.mockRestore();
+    });
+    it('exits 0 when in sync', async () => {
+        const root = makeTmpRepo({
+            configPlugins: ['@forgeportal/plugin-kubernetes'],
+            apiDeps: { '@forgeportal/plugin-kubernetes': 'workspace:*' },
+            uiDeps: { '@forgeportal/plugin-kubernetes': 'workspace:*' },
+            workspacePlugins: [{ name: '@forgeportal/plugin-kubernetes', type: 'fullstack' }],
+        });
+        const result = await syncCommand({ root, check: true });
+        expect(result.changed).toBe(false);
+    });
+});
+describe('forge sync — no forgeportal.yaml', () => {
+    it('returns empty result gracefully when no yaml exists', async () => {
+        const root = fs.mkdtempSync(path.join(os.tmpdir(), 'forge-sync-noconfig-'));
+        const result = await syncCommand({ root, ci: true });
+        expect(result.changed).toBe(false);
+    });
+});
+//# sourceMappingURL=sync.test.js.map

package/dist/__tests__/sync.test.js.map

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

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+/**
+ * forge — ForgePortal CLI
+ *
+ * Usage:
+ *   forge sync                 # sync plugin deps + pnpm install
+ *   forge sync --dry-run       # show diff, no writes
+ *   forge sync --ci            # write only, no pnpm install (Dockerfile use)
+ *   forge sync --check         # exit 1 if out of sync (CI gate)
+ */
+import { syncCommand } from './commands/sync.js';
+const args = process.argv.slice(2);
+const command = args[0];
+if (!command || command === '--help' || command === '-h') {
+    console.log(`
+forge — ForgePortal CLI
+
+Commands:
+  sync              Sync plugin dependencies from forgeportal.yaml → package.json files
+  sync --dry-run    Show changes without writing any files
+  sync --check      Exit 1 if package.json files are out of sync (CI gate)
+  sync --ci         Write files without running pnpm install (for Dockerfile)
+`);
+    process.exit(0);
+}
+if (command === 'sync') {
+    const dryRun = args.includes('--dry-run');
+    const ci = args.includes('--ci');
+    const check = args.includes('--check');
+    const configFlag = args.indexOf('--config');
+    const configPath = configFlag !== -1 ? args[configFlag + 1] : undefined;
+    syncCommand({ dryRun, ci, check, configPath }).catch((err) => {
+        console.error('forge sync failed:', err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    });
+}
+else {
+    console.error(`Unknown command: "${command}". Run "forge --help" for usage.`);
+    process.exit(1);
+}
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,IAAI,GAAM,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACtC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AAExB,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC;;;;;;;;CAQb,CAAC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;IACvB,MAAM,MAAM,GAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,EAAE,GAAW,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,KAAK,GAAQ,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAExE,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACpE,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACtF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,KAAK,CAAC,qBAAqB,OAAO,kCAAkC,CAAC,CAAC;IAC9E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/commands/sync.d.ts

@@ -0,0 +1,27 @@
+export interface SyncOptions {
+    dryRun?: boolean;
+    ci?: boolean;
+    check?: boolean;
+    configPath?: string;
+    /** Override the monorepo root (useful for tests). Defaults to process.cwd(). */
+    root?: string;
+}
+export interface SyncResult {
+    apiAdded: string[];
+    apiRemoved: string[];
+    uiAdded: string[];
+    uiRemoved: string[];
+    changed: boolean;
+}
+/**
+ * `forge sync` — synchronises plugin dependencies from forgeportal.yaml
+ * into apps/api/package.json and apps/ui/package.json.
+ *
+ * Modes:
+ *   default    write + pnpm install
+ *   --dry-run  print diff, no writes
+ *   --check    exit 1 if out of sync (CI gate)
+ *   --ci       write files, skip pnpm install (Dockerfile use)
+ */
+export declare function syncCommand(opts?: SyncOptions): Promise<SyncResult>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/commands/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAK,OAAO,CAAC;IACpB,EAAE,CAAC,EAAS,OAAO,CAAC;IACpB,KAAK,CAAC,EAAM,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,IAAI,CAAC,EAAO,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAI,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAK,MAAM,EAAE,CAAC;IACrB,SAAS,EAAG,MAAM,EAAE,CAAC;IACrB,OAAO,EAAK,OAAO,CAAC;CACrB;AAmBD;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CA2G7E"}

package/dist/commands/sync.js

@@ -0,0 +1,229 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { execSync } from 'node:child_process';
+import { createRequire } from 'node:module';
+import yaml from 'js-yaml';
+// ─── Main command ─────────────────────────────────────────────────────────────
+/**
+ * `forge sync` — synchronises plugin dependencies from forgeportal.yaml
+ * into apps/api/package.json and apps/ui/package.json.
+ *
+ * Modes:
+ *   default    write + pnpm install
+ *   --dry-run  print diff, no writes
+ *   --check    exit 1 if out of sync (CI gate)
+ *   --ci       write files, skip pnpm install (Dockerfile use)
+ */
+export async function syncCommand(opts = {}) {
+    const root = opts.root ?? process.cwd();
+    const cfgPath = opts.configPath ?? path.join(root, 'forgeportal.yaml');
+    // ── 1. Read forgeportal.yaml ──────────────────────────────────────────────
+    if (!fs.existsSync(cfgPath)) {
+        if (opts.ci) {
+            console.log('[forge sync] No forgeportal.yaml found — nothing to sync.');
+            return emptyResult();
+        }
+        console.warn(`[forge sync] Warning: ${cfgPath} not found. Nothing to sync.`);
+        return emptyResult();
+    }
+    const config = yaml.load(fs.readFileSync(cfgPath, 'utf8'));
+    const packages = config.pluginPackages?.packages ?? [];
+    // ── 2. Resolve manifests ──────────────────────────────────────────────────
+    if (packages.length === 0) {
+        console.log('[forge sync] No plugins configured — will remove any installed forge plugins.');
+    }
+    const resolved = [];
+    for (const pkg of packages) {
+        try {
+            const info = await resolveManifest(pkg, root);
+            resolved.push(info);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (opts.ci) {
+                console.error(`[forge sync] ERROR: Cannot resolve manifest for "${pkg}": ${msg}`);
+                process.exit(1);
+            }
+            console.warn(`[forge sync] Warning: Cannot resolve manifest for "${pkg}": ${msg}. Skipping.`);
+        }
+    }
+    // ── 3. Build desired dep maps ─────────────────────────────────────────────
+    const apiDeps = {};
+    const uiDeps = {};
+    for (const { packageName, version, pluginType } of resolved) {
+        const versionSpec = version.startsWith('workspace:') ? version : `^${version}`;
+        if (pluginType === 'backend' || pluginType === 'fullstack')
+            apiDeps[packageName] = versionSpec;
+        if (pluginType === 'ui' || pluginType === 'fullstack')
+            uiDeps[packageName] = versionSpec;
+    }
+    // ── 4. Apply to package.json files ────────────────────────────────────────
+    const apiPkgPath = path.join(root, 'apps', 'api', 'package.json');
+    const uiPkgPath = path.join(root, 'apps', 'ui', 'package.json');
+    const apiDiff = computeDiff(apiPkgPath, apiDeps);
+    const uiDiff = computeDiff(uiPkgPath, uiDeps);
+    const changed = apiDiff.changed || uiDiff.changed;
+    // ── 5. Handle modes ───────────────────────────────────────────────────────
+    if (opts.check) {
+        if (changed) {
+            console.error('✗  package.json files are out of sync with forgeportal.yaml.\n' +
+                '   Run "pnpm forge:sync" to fix.\n');
+            printDiff(apiPkgPath, apiDiff);
+            printDiff(uiPkgPath, uiDiff);
+            process.exit(1);
+        }
+        console.log('✓  package.json files are in sync with forgeportal.yaml.');
+        return toResult(apiDiff, uiDiff);
+    }
+    if (opts.dryRun) {
+        console.log('[forge sync --dry-run] Changes that would be applied:\n');
+        printDiff(apiPkgPath, apiDiff);
+        printDiff(uiPkgPath, uiDiff);
+        if (!changed)
+            console.log('  (no changes needed)');
+        return toResult(apiDiff, uiDiff);
+    }
+    if (!changed) {
+        console.log('✓  package.json files already in sync — nothing to do.');
+        return emptyResult();
+    }
+    // Write files
+    applyDiff(apiPkgPath, apiDiff);
+    applyDiff(uiPkgPath, uiDiff);
+    const totalAdded = apiDiff.toAdd.length + uiDiff.toAdd.length;
+    const totalRemoved = apiDiff.toRemove.length + uiDiff.toRemove.length;
+    console.log(`✓  Synced: +${totalAdded} dep(s) added, -${totalRemoved} dep(s) removed across api/ui.`);
+    // ── 6. pnpm install (skip in --ci) ────────────────────────────────────────
+    if (!opts.ci) {
+        console.log('   Running pnpm install…');
+        execSync('pnpm install', { stdio: 'inherit', cwd: root });
+        console.log('✓  pnpm install complete.');
+    }
+    return toResult(apiDiff, uiDiff);
+}
+// ─── Manifest resolution ──────────────────────────────────────────────────────
+/**
+ * Resolves a plugin manifest from the workspace, node_modules, or the npm registry.
+ * Workspace packages always take priority and receive the "workspace:*" version specifier.
+ */
+async function resolveManifest(packageName, root) {
+    // ── 1. Workspace scan: packages directory ─────────────────────────────────
+    const pkgsDir = path.join(root, 'packages');
+    if (fs.existsSync(pkgsDir)) {
+        for (const dir of fs.readdirSync(pkgsDir)) {
+            const pkgJsonPath = path.join(pkgsDir, dir, 'package.json');
+            const manifestPath = path.join(pkgsDir, dir, 'forgeportal-plugin.json');
+            if (!fs.existsSync(pkgJsonPath) || !fs.existsSync(manifestPath))
+                continue;
+            const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf8'));
+            if (pkg.name !== packageName)
+                continue;
+            const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+            return {
+                packageName,
+                version: 'workspace:*',
+                pluginType: manifest.forgeportal.type,
+            };
+        }
+    }
+    // ── 2. node_modules via require.resolve (external installed package) ───────
+    try {
+        const req = createRequire(path.join(root, '_placeholder_.js'));
+        const pkgDir = path.dirname(req.resolve(`${packageName}/package.json`));
+        const manifest = JSON.parse(fs.readFileSync(path.join(pkgDir, 'forgeportal-plugin.json'), 'utf8'));
+        // If the resolved package lives under any "packages/" directory (workspace
+        // symlink or monorepo root), always use "workspace:*" so pnpm is happy.
+        const normalizedPkgDir = pkgDir.replace(/\\/g, '/');
+        const isWorkspaceLink = [root, process.cwd()].some((base) => normalizedPkgDir.startsWith(path.join(base, 'packages').replace(/\\/g, '/')));
+        return {
+            packageName,
+            version: isWorkspaceLink ? 'workspace:*' : manifest.version,
+            pluginType: manifest.forgeportal.type,
+        };
+    }
+    catch {
+        // not installed in node_modules — try npm registry
+    }
+    // ── 3. Fall back to npm registry ──────────────────────────────────────────
+    try {
+        const raw = execSync(`npm view ${packageName} version --json 2>/dev/null`, { encoding: 'utf8', timeout: 15_000 }).trim();
+        const version = JSON.parse(raw);
+        // Fetch forgeportal field to determine type
+        const meta = execSync(`npm view ${packageName} forgeportal --json 2>/dev/null`, { encoding: 'utf8', timeout: 15_000 }).trim();
+        const forgeportal = JSON.parse(meta);
+        const pluginType = (forgeportal?.type ?? 'backend');
+        return { packageName, version, pluginType };
+    }
+    catch {
+        throw new Error(`Plugin "${packageName}" not found in workspace packages, node_modules, or npm registry.`);
+    }
+}
+/**
+ * Computes the diff between current deps in package.json and desired deps.
+ * Also removes plugin deps that are no longer configured.
+ */
+function computeDiff(pkgPath, desiredDeps) {
+    if (!fs.existsSync(pkgPath)) {
+        return { changed: false, toAdd: [], toRemove: [] };
+    }
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+    const current = pkg.dependencies ?? {};
+    const toRemove = Object.keys(current).filter((dep) => isPluginPackage(dep) && !(dep in desiredDeps));
+    const toAdd = Object.entries(desiredDeps).filter(([dep, ver]) => current[dep] !== ver);
+    return {
+        changed: toRemove.length > 0 || toAdd.length > 0,
+        toAdd,
+        toRemove,
+    };
+}
+function applyDiff(pkgPath, diff) {
+    if (!diff.changed || !fs.existsSync(pkgPath))
+        return;
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+    const current = pkg.dependencies ?? {};
+    for (const dep of diff.toRemove)
+        delete current[dep];
+    for (const [dep, ver] of diff.toAdd)
+        current[dep] = ver;
+    pkg.dependencies = sortKeys(current);
+    fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n', 'utf8');
+    const label = path.relative(process.cwd(), pkgPath);
+    console.log(`  ✓ ${label}: +${diff.toAdd.length} -${diff.toRemove.length}`);
+}
+function printDiff(pkgPath, diff) {
+    if (!diff.changed)
+        return;
+    const label = path.relative(process.cwd(), pkgPath);
+    console.log(`  ${label}:`);
+    for (const [dep, ver] of diff.toAdd)
+        console.log(`    + ${dep}@${ver}`);
+    for (const dep of diff.toRemove)
+        console.log(`    - ${dep}`);
+}
+function sortKeys(obj) {
+    return Object.fromEntries(Object.entries(obj).sort(([a], [b]) => a.localeCompare(b)));
+}
+/**
+ * Returns true if the package is a user-installable ForgePortal plugin
+ * managed by `forge sync`. Excludes framework packages like @forgeportal/plugin-sdk.
+ */
+function isPluginPackage(name) {
+    // plugin-sdk is a framework/SDK package — never remove it automatically.
+    if (name === '@forgeportal/plugin-sdk')
+        return false;
+    return name.startsWith('@forgeportal/plugin-') || /^forge-plugin-/.test(name) || /^@[^/]+\/forge-plugin-/.test(name);
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function emptyResult() {
+    return { apiAdded: [], apiRemoved: [], uiAdded: [], uiRemoved: [], changed: false };
+}
+function toResult(apiDiff, uiDiff) {
+    return {
+        apiAdded: apiDiff.toAdd.map(([d]) => d),
+        apiRemoved: apiDiff.toRemove,
+        uiAdded: uiDiff.toAdd.map(([d]) => d),
+        uiRemoved: uiDiff.toRemove,
+        changed: apiDiff.changed || uiDiff.changed,
+    };
+}
+//# sourceMappingURL=sync.js.map

package/dist/commands/sync.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { syncCommand } from './commands/sync.js';
+export type { SyncOptions, SyncResult } from './commands/sync.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { syncCommand } from './commands/sync.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@forgeportal/cli",
+  "version": "1.3.0",
+  "type": "module",
+  "bin": {
+    "forge": "./dist/bin.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "js-yaml": "^4.1.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "*",
+    "vitest": "*"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "lint": "eslint src/",
+    "clean": "rm -rf dist"
+  }
+}

package/src/__tests__/sync.test.ts

@@ -0,0 +1,226 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { describe, it, expect, vi } from 'vitest';
+import { syncCommand } from '../commands/sync.js';
+
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+
+function makeTmpRepo(opts: {
+  configPlugins?: string[];
+  apiDeps?: Record<string, string>;
+  uiDeps?:  Record<string, string>;
+  workspacePlugins?: Array<{ name: string; type: 'ui' | 'backend' | 'fullstack'; version?: string }>;
+}): string {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'forge-sync-test-'));
+
+  // forgeportal.yaml
+  const pluginList = opts.configPlugins?.map((p) => `    - "${p}"`).join('\n') ?? '';
+  fs.writeFileSync(path.join(root, 'forgeportal.yaml'), `
+pluginPackages:
+  packages:
+${pluginList}
+`.trimStart());
+
+  // apps/api/package.json
+  const apiDir = path.join(root, 'apps', 'api');
+  fs.mkdirSync(apiDir, { recursive: true });
+  fs.writeFileSync(path.join(apiDir, 'package.json'), JSON.stringify({
+    name: '@forgeportal/api',
+    dependencies: opts.apiDeps ?? {},
+  }, null, 2));
+
+  // apps/ui/package.json
+  const uiDir = path.join(root, 'apps', 'ui');
+  fs.mkdirSync(uiDir, { recursive: true });
+  fs.writeFileSync(path.join(uiDir, 'package.json'), JSON.stringify({
+    name: '@forgeportal/ui',
+    dependencies: opts.uiDeps ?? {},
+  }, null, 2));
+
+  // workspace plugins (simulate packages/ directory)
+  for (const plugin of opts.workspacePlugins ?? []) {
+    const pluginDir = path.join(root, 'packages', plugin.name.replace('@forgeportal/', ''));
+    fs.mkdirSync(pluginDir, { recursive: true });
+    fs.writeFileSync(path.join(pluginDir, 'package.json'), JSON.stringify({
+      name: plugin.name,
+      version: plugin.version ?? '1.0.0',
+    }, null, 2));
+    fs.writeFileSync(path.join(pluginDir, 'forgeportal-plugin.json'), JSON.stringify({
+      version: plugin.version ?? '1.0.0',
+      forgeportal: { type: plugin.type },
+    }, null, 2));
+  }
+
+  return root;
+}
+
+function readDeps(root: string, app: 'api' | 'ui'): Record<string, string> {
+  const pkgPath = path.join(root, 'apps', app, 'package.json');
+  const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8')) as { dependencies?: Record<string, string> };
+  return pkg.dependencies ?? {};
+}
+
+// ─── Mock execSync so pnpm install doesn't run in tests ──────────────────────
+
+vi.mock('node:child_process', async (importOriginal) => {
+  const original = await importOriginal<typeof import('node:child_process')>();
+  return {
+    ...original,
+    execSync: vi.fn((cmd: string, _opts?: unknown) => {
+      if (String(cmd).startsWith('pnpm install')) return '';
+      // Pass npm view to the original (we mock it per-test when needed)
+      throw new Error(`Unexpected execSync: ${cmd}`);
+    }),
+  };
+});
+
+// ─── Tests ────────────────────────────────────────────────────────────────────
+
+describe('forge sync — workspace plugin', () => {
+  it('adds a fullstack plugin to both api and ui', async () => {
+    const root = makeTmpRepo({
+      configPlugins:     ['@forgeportal/plugin-kubernetes'],
+      workspacePlugins:  [{ name: '@forgeportal/plugin-kubernetes', type: 'fullstack' }],
+    });
+
+    const result = await syncCommand({ root, ci: true });
+
+    expect(result.changed).toBe(true);
+    expect(result.apiAdded).toContain('@forgeportal/plugin-kubernetes');
+    expect(result.uiAdded).toContain('@forgeportal/plugin-kubernetes');
+    expect(readDeps(root, 'api')['@forgeportal/plugin-kubernetes']).toBe('workspace:*');
+    expect(readDeps(root, 'ui')['@forgeportal/plugin-kubernetes']).toBe('workspace:*');
+  });
+
+  it('adds a backend-only plugin only to api', async () => {
+    const root = makeTmpRepo({
+      configPlugins:    ['@forgeportal/plugin-backend-only'],
+      workspacePlugins: [{ name: '@forgeportal/plugin-backend-only', type: 'backend' }],
+    });
+
+    await syncCommand({ root, ci: true });
+
+    expect(readDeps(root, 'api')['@forgeportal/plugin-backend-only']).toBe('workspace:*');
+    expect(readDeps(root, 'ui')['@forgeportal/plugin-backend-only']).toBeUndefined();
+  });
+
+  it('adds a ui-only plugin only to ui', async () => {
+    const root = makeTmpRepo({
+      configPlugins:    ['@forgeportal/plugin-ui-only'],
+      workspacePlugins: [{ name: '@forgeportal/plugin-ui-only', type: 'ui' }],
+    });
+
+    await syncCommand({ root, ci: true });
+
+    expect(readDeps(root, 'api')['@forgeportal/plugin-ui-only']).toBeUndefined();
+    expect(readDeps(root, 'ui')['@forgeportal/plugin-ui-only']).toBe('workspace:*');
+  });
+
+  it('removes a plugin no longer in forgeportal.yaml', async () => {
+    const root = makeTmpRepo({
+      configPlugins: [],
+      apiDeps: { '@forgeportal/plugin-old': '^1.0.0' },
+      uiDeps:  { '@forgeportal/plugin-old': '^1.0.0' },
+    });
+    // forgeportal.yaml has no plugins now
+    fs.writeFileSync(path.join(root, 'forgeportal.yaml'), 'pluginPackages:\n  packages: []\n');
+
+    await syncCommand({ root, ci: true });
+
+    expect(readDeps(root, 'api')['@forgeportal/plugin-old']).toBeUndefined();
+    expect(readDeps(root, 'ui')['@forgeportal/plugin-old']).toBeUndefined();
+  });
+
+  it('does not touch non-plugin deps when removing', async () => {
+    const root = makeTmpRepo({
+      configPlugins: [],
+      apiDeps: {
+        'express':                      '^4.18.0',
+        '@forgeportal/plugin-old':      '^1.0.0',
+        '@forgeportal/core':            '^1.0.0',
+      },
+    });
+    fs.writeFileSync(path.join(root, 'forgeportal.yaml'), 'pluginPackages:\n  packages: []\n');
+
+    await syncCommand({ root, ci: true });
+
+    const deps = readDeps(root, 'api');
+    expect(deps['express']).toBe('^4.18.0');
+    expect(deps['@forgeportal/core']).toBe('^1.0.0');
+    expect(deps['@forgeportal/plugin-old']).toBeUndefined();
+  });
+
+  it('returns changed:false when already in sync', async () => {
+    const root = makeTmpRepo({
+      configPlugins:    ['@forgeportal/plugin-kubernetes'],
+      apiDeps:          { '@forgeportal/plugin-kubernetes': 'workspace:*' },
+      uiDeps:           { '@forgeportal/plugin-kubernetes': 'workspace:*' },
+      workspacePlugins: [{ name: '@forgeportal/plugin-kubernetes', type: 'fullstack' }],
+    });
+
+    const result = await syncCommand({ root, ci: true });
+    expect(result.changed).toBe(false);
+  });
+});
+
+describe('forge sync --dry-run', () => {
+  it('does not modify package.json files', async () => {
+    const root = makeTmpRepo({
+      configPlugins:    ['@forgeportal/plugin-kubernetes'],
+      workspacePlugins: [{ name: '@forgeportal/plugin-kubernetes', type: 'fullstack' }],
+    });
+
+    const before = JSON.stringify(readDeps(root, 'api'));
+    await syncCommand({ root, dryRun: true });
+    expect(JSON.stringify(readDeps(root, 'api'))).toBe(before);
+  });
+
+  it('reports changed:true without writing', async () => {
+    const root = makeTmpRepo({
+      configPlugins:    ['@forgeportal/plugin-kubernetes'],
+      workspacePlugins: [{ name: '@forgeportal/plugin-kubernetes', type: 'fullstack' }],
+    });
+
+    const result = await syncCommand({ root, dryRun: true });
+    expect(result.changed).toBe(true);
+    expect(readDeps(root, 'api')['@forgeportal/plugin-kubernetes']).toBeUndefined();
+  });
+});
+
+describe('forge sync --check', () => {
+  it('exits 1 when out of sync', async () => {
+    const root = makeTmpRepo({
+      configPlugins:    ['@forgeportal/plugin-kubernetes'],
+      workspacePlugins: [{ name: '@forgeportal/plugin-kubernetes', type: 'fullstack' }],
+    });
+
+    const exitSpy = vi.spyOn(process, 'exit').mockImplementation((_code?: number | string | null) => {
+      throw new Error(`process.exit(${_code})`);
+    });
+
+    await expect(syncCommand({ root, check: true })).rejects.toThrow('process.exit(1)');
+    expect(exitSpy).toHaveBeenCalledWith(1);
+    exitSpy.mockRestore();
+  });
+
+  it('exits 0 when in sync', async () => {
+    const root = makeTmpRepo({
+      configPlugins:    ['@forgeportal/plugin-kubernetes'],
+      apiDeps:          { '@forgeportal/plugin-kubernetes': 'workspace:*' },
+      uiDeps:           { '@forgeportal/plugin-kubernetes': 'workspace:*' },
+      workspacePlugins: [{ name: '@forgeportal/plugin-kubernetes', type: 'fullstack' }],
+    });
+
+    const result = await syncCommand({ root, check: true });
+    expect(result.changed).toBe(false);
+  });
+});
+
+describe('forge sync — no forgeportal.yaml', () => {
+  it('returns empty result gracefully when no yaml exists', async () => {
+    const root = fs.mkdtempSync(path.join(os.tmpdir(), 'forge-sync-noconfig-'));
+    const result = await syncCommand({ root, ci: true });
+    expect(result.changed).toBe(false);
+  });
+});

package/src/bin.ts

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+/**
+ * forge — ForgePortal CLI
+ *
+ * Usage:
+ *   forge sync                 # sync plugin deps + pnpm install
+ *   forge sync --dry-run       # show diff, no writes
+ *   forge sync --ci            # write only, no pnpm install (Dockerfile use)
+ *   forge sync --check         # exit 1 if out of sync (CI gate)
+ */
+import { syncCommand } from './commands/sync.js';
+
+const args    = process.argv.slice(2);
+const command = args[0];
+
+if (!command || command === '--help' || command === '-h') {
+  console.log(`
+forge — ForgePortal CLI
+
+Commands:
+  sync              Sync plugin dependencies from forgeportal.yaml → package.json files
+  sync --dry-run    Show changes without writing any files
+  sync --check      Exit 1 if package.json files are out of sync (CI gate)
+  sync --ci         Write files without running pnpm install (for Dockerfile)
+`);
+  process.exit(0);
+}
+
+if (command === 'sync') {
+  const dryRun     = args.includes('--dry-run');
+  const ci         = args.includes('--ci');
+  const check      = args.includes('--check');
+  const configFlag = args.indexOf('--config');
+  const configPath = configFlag !== -1 ? args[configFlag + 1] : undefined;
+
+  syncCommand({ dryRun, ci, check, configPath }).catch((err: unknown) => {
+    console.error('forge sync failed:', err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  });
+} else {
+  console.error(`Unknown command: "${command}". Run "forge --help" for usage.`);
+  process.exit(1);
+}

package/src/commands/sync.ts

@@ -0,0 +1,323 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { execSync } from 'node:child_process';
+import { createRequire } from 'node:module';
+import yaml from 'js-yaml';
+
+// ─── Types ────────────────────────────────────────────────────────────────────
+
+export interface SyncOptions {
+  dryRun?:    boolean;
+  ci?:        boolean;
+  check?:     boolean;
+  configPath?: string;
+  /** Override the monorepo root (useful for tests). Defaults to process.cwd(). */
+  root?:      string;
+}
+
+export interface SyncResult {
+  apiAdded:   string[];
+  apiRemoved: string[];
+  uiAdded:    string[];
+  uiRemoved:  string[];
+  changed:    boolean;
+}
+
+interface ForgePortalConfig {
+  pluginPackages?: { packages?: string[] };
+}
+
+interface PackageJson {
+  dependencies?: Record<string, string>;
+  [key: string]: unknown;
+}
+
+interface PluginInfo {
+  packageName: string;
+  version:     string;
+  pluginType:  'ui' | 'backend' | 'fullstack';
+}
+
+// ─── Main command ─────────────────────────────────────────────────────────────
+
+/**
+ * `forge sync` — synchronises plugin dependencies from forgeportal.yaml
+ * into apps/api/package.json and apps/ui/package.json.
+ *
+ * Modes:
+ *   default    write + pnpm install
+ *   --dry-run  print diff, no writes
+ *   --check    exit 1 if out of sync (CI gate)
+ *   --ci       write files, skip pnpm install (Dockerfile use)
+ */
+export async function syncCommand(opts: SyncOptions = {}): Promise<SyncResult> {
+  const root      = opts.root ?? process.cwd();
+  const cfgPath   = opts.configPath ?? path.join(root, 'forgeportal.yaml');
+
+  // ── 1. Read forgeportal.yaml ──────────────────────────────────────────────
+
+  if (!fs.existsSync(cfgPath)) {
+    if (opts.ci) {
+      console.log('[forge sync] No forgeportal.yaml found — nothing to sync.');
+      return emptyResult();
+    }
+    console.warn(`[forge sync] Warning: ${cfgPath} not found. Nothing to sync.`);
+    return emptyResult();
+  }
+
+  const config   = yaml.load(fs.readFileSync(cfgPath, 'utf8')) as ForgePortalConfig;
+  const packages = config.pluginPackages?.packages ?? [];
+
+  // ── 2. Resolve manifests ──────────────────────────────────────────────────
+
+  if (packages.length === 0) {
+    console.log('[forge sync] No plugins configured — will remove any installed forge plugins.');
+  }
+
+  const resolved: PluginInfo[] = [];
+  for (const pkg of packages) {
+    try {
+      const info = await resolveManifest(pkg, root);
+      resolved.push(info);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      if (opts.ci) {
+        console.error(`[forge sync] ERROR: Cannot resolve manifest for "${pkg}": ${msg}`);
+        process.exit(1);
+      }
+      console.warn(`[forge sync] Warning: Cannot resolve manifest for "${pkg}": ${msg}. Skipping.`);
+    }
+  }
+
+  // ── 3. Build desired dep maps ─────────────────────────────────────────────
+
+  const apiDeps: Record<string, string> = {};
+  const uiDeps:  Record<string, string> = {};
+
+  for (const { packageName, version, pluginType } of resolved) {
+    const versionSpec = version.startsWith('workspace:') ? version : `^${version}`;
+    if (pluginType === 'backend'  || pluginType === 'fullstack') apiDeps[packageName] = versionSpec;
+    if (pluginType === 'ui'       || pluginType === 'fullstack') uiDeps[packageName]  = versionSpec;
+  }
+
+  // ── 4. Apply to package.json files ────────────────────────────────────────
+
+  const apiPkgPath = path.join(root, 'apps', 'api', 'package.json');
+  const uiPkgPath  = path.join(root, 'apps', 'ui',  'package.json');
+
+  const apiDiff = computeDiff(apiPkgPath, apiDeps);
+  const uiDiff  = computeDiff(uiPkgPath,  uiDeps);
+  const changed = apiDiff.changed || uiDiff.changed;
+
+  // ── 5. Handle modes ───────────────────────────────────────────────────────
+
+  if (opts.check) {
+    if (changed) {
+      console.error(
+        '✗  package.json files are out of sync with forgeportal.yaml.\n' +
+        '   Run "pnpm forge:sync" to fix.\n',
+      );
+      printDiff(apiPkgPath, apiDiff);
+      printDiff(uiPkgPath,  uiDiff);
+      process.exit(1);
+    }
+    console.log('✓  package.json files are in sync with forgeportal.yaml.');
+    return toResult(apiDiff, uiDiff);
+  }
+
+  if (opts.dryRun) {
+    console.log('[forge sync --dry-run] Changes that would be applied:\n');
+    printDiff(apiPkgPath, apiDiff);
+    printDiff(uiPkgPath,  uiDiff);
+    if (!changed) console.log('  (no changes needed)');
+    return toResult(apiDiff, uiDiff);
+  }
+
+  if (!changed) {
+    console.log('✓  package.json files already in sync — nothing to do.');
+    return emptyResult();
+  }
+
+  // Write files
+  applyDiff(apiPkgPath, apiDiff);
+  applyDiff(uiPkgPath,  uiDiff);
+
+  const totalAdded   = apiDiff.toAdd.length   + uiDiff.toAdd.length;
+  const totalRemoved = apiDiff.toRemove.length + uiDiff.toRemove.length;
+  console.log(
+    `✓  Synced: +${totalAdded} dep(s) added, -${totalRemoved} dep(s) removed across api/ui.`,
+  );
+
+  // ── 6. pnpm install (skip in --ci) ────────────────────────────────────────
+
+  if (!opts.ci) {
+    console.log('   Running pnpm install…');
+    execSync('pnpm install', { stdio: 'inherit', cwd: root });
+    console.log('✓  pnpm install complete.');
+  }
+
+  return toResult(apiDiff, uiDiff);
+}
+
+// ─── Manifest resolution ──────────────────────────────────────────────────────
+
+/**
+ * Resolves a plugin manifest from the workspace, node_modules, or the npm registry.
+ * Workspace packages always take priority and receive the "workspace:*" version specifier.
+ */
+async function resolveManifest(packageName: string, root: string): Promise<PluginInfo> {
+  // ── 1. Workspace scan: packages directory ─────────────────────────────────
+  const pkgsDir = path.join(root, 'packages');
+  if (fs.existsSync(pkgsDir)) {
+    for (const dir of fs.readdirSync(pkgsDir)) {
+      const pkgJsonPath  = path.join(pkgsDir, dir, 'package.json');
+      const manifestPath = path.join(pkgsDir, dir, 'forgeportal-plugin.json');
+      if (!fs.existsSync(pkgJsonPath) || !fs.existsSync(manifestPath)) continue;
+      const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf8')) as { name?: string };
+      if (pkg.name !== packageName) continue;
+      const manifest = JSON.parse(
+        fs.readFileSync(manifestPath, 'utf8'),
+      ) as { version: string; forgeportal: { type: string } };
+      return {
+        packageName,
+        version:    'workspace:*',
+        pluginType: manifest.forgeportal.type as PluginInfo['pluginType'],
+      };
+    }
+  }
+
+  // ── 2. node_modules via require.resolve (external installed package) ───────
+  try {
+    const req    = createRequire(path.join(root, '_placeholder_.js'));
+    const pkgDir = path.dirname(req.resolve(`${packageName}/package.json`));
+    const manifest = JSON.parse(
+      fs.readFileSync(path.join(pkgDir, 'forgeportal-plugin.json'), 'utf8'),
+    ) as { version: string; forgeportal: { type: string } };
+
+    // If the resolved package lives under any "packages/" directory (workspace
+    // symlink or monorepo root), always use "workspace:*" so pnpm is happy.
+    const normalizedPkgDir = pkgDir.replace(/\\/g, '/');
+    const isWorkspaceLink  = [root, process.cwd()].some((base) =>
+      normalizedPkgDir.startsWith(path.join(base, 'packages').replace(/\\/g, '/')),
+    );
+
+    return {
+      packageName,
+      version:    isWorkspaceLink ? 'workspace:*' : manifest.version,
+      pluginType: manifest.forgeportal.type as PluginInfo['pluginType'],
+    };
+  } catch {
+    // not installed in node_modules — try npm registry
+  }
+
+  // ── 3. Fall back to npm registry ──────────────────────────────────────────
+  try {
+    const raw  = execSync(
+      `npm view ${packageName} version --json 2>/dev/null`,
+      { encoding: 'utf8', timeout: 15_000 },
+    ).trim();
+    const version = JSON.parse(raw) as string;
+
+    // Fetch forgeportal field to determine type
+    const meta = execSync(
+      `npm view ${packageName} forgeportal --json 2>/dev/null`,
+      { encoding: 'utf8', timeout: 15_000 },
+    ).trim();
+    const forgeportal = JSON.parse(meta) as { type?: string } | null;
+    const pluginType  = (forgeportal?.type ?? 'backend') as PluginInfo['pluginType'];
+
+    return { packageName, version, pluginType };
+  } catch {
+    throw new Error(
+      `Plugin "${packageName}" not found in workspace packages, node_modules, or npm registry.`,
+    );
+  }
+}
+
+// ─── Diff helpers ─────────────────────────────────────────────────────────────
+
+interface Diff {
+  changed:  boolean;
+  toAdd:    Array<[string, string]>; // [name, version]
+  toRemove: string[];
+}
+
+/**
+ * Computes the diff between current deps in package.json and desired deps.
+ * Also removes plugin deps that are no longer configured.
+ */
+function computeDiff(pkgPath: string, desiredDeps: Record<string, string>): Diff {
+  if (!fs.existsSync(pkgPath)) {
+    return { changed: false, toAdd: [], toRemove: [] };
+  }
+
+  const pkg     = JSON.parse(fs.readFileSync(pkgPath, 'utf8')) as PackageJson;
+  const current = pkg.dependencies ?? {};
+
+  const toRemove = Object.keys(current).filter(
+    (dep) => isPluginPackage(dep) && !(dep in desiredDeps),
+  );
+  const toAdd = Object.entries(desiredDeps).filter(
+    ([dep, ver]) => current[dep] !== ver,
+  );
+
+  return {
+    changed:  toRemove.length > 0 || toAdd.length > 0,
+    toAdd,
+    toRemove,
+  };
+}
+
+function applyDiff(pkgPath: string, diff: Diff): void {
+  if (!diff.changed || !fs.existsSync(pkgPath)) return;
+
+  const pkg     = JSON.parse(fs.readFileSync(pkgPath, 'utf8')) as PackageJson;
+  const current = pkg.dependencies ?? {};
+
+  for (const dep of diff.toRemove) delete current[dep];
+  for (const [dep, ver] of diff.toAdd) current[dep] = ver;
+
+  pkg.dependencies = sortKeys(current);
+  fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n', 'utf8');
+
+  const label = path.relative(process.cwd(), pkgPath);
+  console.log(`  ✓ ${label}: +${diff.toAdd.length} -${diff.toRemove.length}`);
+}
+
+function printDiff(pkgPath: string, diff: Diff): void {
+  if (!diff.changed) return;
+  const label = path.relative(process.cwd(), pkgPath);
+  console.log(`  ${label}:`);
+  for (const [dep, ver] of diff.toAdd)    console.log(`    + ${dep}@${ver}`);
+  for (const dep of diff.toRemove)         console.log(`    - ${dep}`);
+}
+
+function sortKeys(obj: Record<string, string>): Record<string, string> {
+  return Object.fromEntries(Object.entries(obj).sort(([a], [b]) => a.localeCompare(b)));
+}
+
+/**
+ * Returns true if the package is a user-installable ForgePortal plugin
+ * managed by `forge sync`. Excludes framework packages like @forgeportal/plugin-sdk.
+ */
+function isPluginPackage(name: string): boolean {
+  // plugin-sdk is a framework/SDK package — never remove it automatically.
+  if (name === '@forgeportal/plugin-sdk') return false;
+  return name.startsWith('@forgeportal/plugin-') || /^forge-plugin-/.test(name) || /^@[^/]+\/forge-plugin-/.test(name);
+}
+
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+
+function emptyResult(): SyncResult {
+  return { apiAdded: [], apiRemoved: [], uiAdded: [], uiRemoved: [], changed: false };
+}
+
+function toResult(apiDiff: Diff, uiDiff: Diff): SyncResult {
+  return {
+    apiAdded:   apiDiff.toAdd.map(([d]) => d),
+    apiRemoved: apiDiff.toRemove,
+    uiAdded:    uiDiff.toAdd.map(([d]) => d),
+    uiRemoved:  uiDiff.toRemove,
+    changed:    apiDiff.changed || uiDiff.changed,
+  };
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export { syncCommand } from './commands/sync.js';
+export type { SyncOptions, SyncResult } from './commands/sync.js';

package/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir":         "dist",
+    "rootDir":        "src",
+    "declaration":    true,
+    "declarationMap": true
+  },
+  "include": ["src"]
+}