Additional Forge Tools

The Forge Core SDK (@fractary/forge) is available now at v1.0.0. The following enhancements and integrations are planned:

ESM Support (v1.1.0)

Full ES Module support alongside CommonJS.

// ESM imports coming in v1.1.0
import { ResolverManager } from '@fractary/forge';

Current: CommonJS only Planned: Dual CJS/ESM builds

Additional Resolvers

GitLab Resolver

Full GitLab API integration for asset resolution.

manager.registerResolver(new GitLabResolver({
  token: process.env.GITLAB_TOKEN,
  defaultGroup: 'my-org'
}));

Bitbucket Resolver

Support for Bitbucket Cloud and Server.

Registry Resolver

Connect to custom asset registries (npm-style).

Enhanced Merge Engine

Smart file merging for overlaying bundles:

Conflict detection and resolution
Merge strategies (overwrite, merge, skip)
Interactive merge prompts
Dry-run mode

CLI Integration

The Forge CLI (forge-cli) will be refactored to use the SDK:

# Current CLI commands
forge install bundle-name
forge scaffold starter-name
forge bundle create
forge catalog search

Testing & Documentation

Unit Tests (v1.0.1)

Comprehensive test coverage for all resolvers and core functionality.

Full Documentation

Complete API reference
Resolver development guide
Migration guides
Architecture deep-dives

Advanced Features

Caching Improvements

Persistent cache across sessions
Cache invalidation strategies
Cache warming for common assets

Validation Engine

Schema validation for manifests
Dependency resolution
Version compatibility checks

Observability

Event emitters for progress tracking
Detailed logging levels
Performance metrics

Public npm Registry

Currently published to GitHub Package Registry (restricted). Future releases may be published to public npm registry.

Using the SDK Now

The v1.0.0 SDK is production-ready for:

import {
  ResolverManager,
  GitHubResolver,
  CatalogResolver,
  LocalResolver,
  ConfigManager,
  CacheManager
} from '@fractary/forge';

// Full resolver functionality available
const manager = new ResolverManager();
manager.registerResolver(new GitHubResolver({...}));
const asset = await manager.resolveAsset('org/repo@v1.0.0');

Roadmap

v1.0.1 (Q4 2025): Unit tests + bug fixes
v1.1.0 (Q1 2026): ESM support + GitLab resolver
v1.2.0 (Q2 2026): Enhanced merge engine
v2.0.0 (Q3 2026): Public npm + breaking changes

Stay Updated

⭐ Star the repo: github.com/fractary/forge
👀 Watch for releases
💬 Join discussions: GitHub Discussions
📦 View package: GitHub Packages

Contributing

Interested in contributing? Check out: