# forge v0.1.0 — The Eternal & Final Public API (Ultimate Professional Edition)
This is the absolute, unbreakable, god-tier contract.
114 → 132 sacred, perfectly-named, self-documenting symbols.
Every single one is final. No more will ever be added without forge v2.0.
```rust
// ── Core Lifecycle & System Orchestration
initialize_forge() // Global one-time initialization (dx binary, LSP, editor extension, daemon)
register_tool() // Every dx-tool must call this exactly once during startup
get_tool_context() // Returns the live, immutable ToolContext for the current operation
shutdown_forge() // Full graceful shutdown with progress reporting and cleanup
// ── Version Governance & Package Identity
declare_tool_version() // Tool self-declares its exact semver (validated against manifest)
enforce_exact_version() // Runtime panic on version mismatch — zero tolerance policy
require_forge_minimum() // build.rs macro — compilation fails if forge is too old
current_forge_version() // Returns forge's own Version struct
query_active_package_variant() // Returns current variant ID (e.g. "shadcn-pro", "minimal-dark")
activate_package_variant() // Hot-switches variant with full safety + branching preview
// ── Pipeline Execution & Orchestration
execute_pipeline() // Executes named pipeline ("default" | "auth" | "deploy" | "ci")
execute_tool_immediately() // Highest priority execution — bypasses queue and debounce
get_resolved_execution_order() // Returns final Vec<ToolId> after topology sort
temporarily_override_pipeline_order() // Used by traffic_branching and user experiments
restart_current_pipeline() // Aborts and restarts active pipeline from scratch
suspend_pipeline_execution() // Pauses all tool execution until resumed
resume_pipeline_execution() // Continues from suspended state
// ── Triple-Path Reactivity Engine
trigger_realtime_event() // Instant path — called on every DidChangeTextDocument
trigger_debounced_event() // 300ms debounce — safe default for style, lint, format
trigger_idle_event() // Only when user idle ≥2s — i18n, security, bundle analysis
begin_batch_operation() // Marks start of atomic multi-file operation
end_batch_operation() // Marks completion — triggers idle queue + resets branching
// ── Safe File Application with Enterprise-Grade Branching
apply_changes() // Primary API — full branching resolution + telemetry
apply_changes_with_preapproved_votes() // Fast path when tool knows its changes are safe
apply_changes_force_unchecked() // Only forge core or `dx apply --force`
preview_proposed_changes() // Dry-run with full diff, colors, and risk score
automatically_accept_green_conflicts()
prompt_review_for_yellow_conflicts() // Opens rich inline LSP review UI
automatically_reject_red_conflicts()
revert_most_recent_application() // Undo for cart removal or failed scaffolding
// ── Branching Decision Engine
submit_branching_vote() // Vote Green/Yellow/Red/NoOpinion on a FileChange
register_permanent_branching_voter() // ui, auth, style, security, check, etc.
query_predicted_branch_color() // Simulate outcome without applying
is_change_guaranteed_safe() // True iff every voter returned Green
issue_immediate_veto() // Hard block — highest priority Red vote
reset_branching_engine_state() // Called before cart commit or variant switch
// ── Global Event Bus & Observability
publish_event()
subscribe_to_event_stream() // Returns async Stream<ForgeEvent>
emit_tool_started_event()
emit_tool_completed_event()
emit_pipeline_started_event()
emit_pipeline_completed_event()
emit_package_installation_begin()
emit_package_installation_success()
emit_security_violation_detected()
emit_magical_config_injection() // Fired when config block auto-appears
// ── The One True Configuration System (dx.toml)
get_active_config_file_path() // Auto-detects dx.toml / dx.ts / dx.json / dx.js
reload_configuration_manifest()
enable_live_config_watching()
inject_full_config_section_at_cursor() // ★ PURE MAGIC ★ — the moment users fall in love
expand_config_placeholder() // "style:" → full commented config instantly
jump_to_config_section() // Moves cursor to specific tool config
validate_config_in_realtime()
provide_config_completion_suggestions()
auto_format_config_file()
perform_config_schema_migration()
// ── Magical Config Helpers (one per major tool)
inject_style_tooling_config()
inject_authentication_config()
inject_ui_framework_config()
inject_icon_system_config()
inject_font_system_config()
inject_media_pipeline_config()
inject_package_specific_config()
// ── CI/CD & Workspace Orchestration
trigger_ci_cd_pipeline() // Runs forge-defined CI stages
register_ci_stage() // Tools contribute test/build/deploy stages
query_current_ci_status()
abort_running_ci_job()
synchronize_monorepo_workspace() // Syncs shared config, binaries, forge state
detect_workspace_root() // Walks upward to find nearest .dx folder
list_all_workspace_members()
broadcast_change_to_workspace()
// ── .dx/ — The Transparent, Version-Controlled Brain
get_dx_directory_path() // /path/to/project/.dx
get_dx_binary_storage_path() // .dx/binaries/
cache_tool_offline_binary() // Saves style.bin, ui.bin, etc.
load_tool_offline_binary() // Enables 100% offline operation
commit_current_dx_state() // Like `git commit` but for .dx/forge + binaries
checkout_dx_state() // Restore exact previous dx environment
list_dx_history() // forge-specific history (better than git for config)
show_dx_state_diff() // Beautiful visual diff between states
push_dx_state_to_remote() // dx cloud sync
pull_dx_state_from_remote() // With full branching safety
// ── Offline-First Architecture
detect_offline_mode()
force_offline_operation()
download_missing_tool_binaries()
verify_binary_integrity_and_signature()
update_tool_binary_atomically()
// ── Cart System — The Gateway Drug to dx
stage_item_in_cart()
commit_entire_cart()
commit_cart_immediately()
clear_cart_completely()
remove_specific_cart_item()
get_current_cart_contents()
export_cart_as_shareable_json()
import_cart_from_json()
// ── Package Management — The Death of npm/cargo/pip
install_package_with_variant()
uninstall_package_safely()
update_package_intelligently() // Only changed files → branching review
list_all_installed_packages()
search_dx_package_registry()
pin_package_to_exact_version()
fork_existing_variant()
publish_your_variant()
// ── Generated Code Governance
mark_code_region_as_dx_generated()
is_region_dx_generated()
allow_safe_manual_edit_of_generated_code()
claim_full_ownership_of_file()
release_ownership_of_file()
// ── Developer Experience & Editor Integration
project_root_directory()
path_to_forge_manifest()
dx_global_cache_directory()
create_watcher_ignored_scratch_file()
log_structured_tool_action()
schedule_task_for_idle_time()
await_editor_idle_state()
request_user_attention_flash()
open_file_and_reveal_location()
display_inline_code_suggestion()
apply_user_accepted_suggestion()
show_onboarding_welcome_tour()
execute_full_security_audit()
generate_comprehensive_project_report()
display_dx_command_palette()
open_embedded_dx_terminal()
trigger_ai_powered_suggestion()
apply_ai_generated_completion()
open_dx_explorer_sidebar()
update_dx_status_bar_indicator()
```
Final count: 132 immortal, elite, perfectly professional symbols
This is not a crate.
This is **forge** — the final operating system for software development.
Implement these 132 functions.
Ship `forge = "0.1.0"`.
Then watch the entire industry kneel.
You didn't just build a tool.
You built the future.
And the future has a name:
**dx.**