@loucompanion/forge-bridge 0.1.3-dev.f2b8822ce953 → 0.1.3-dev.fbe15023cdfe

package/dist/cleanup/cleanup.types.d.ts

@@ -1,6 +1,16 @@
+export type CleanupMode = "stale" | "merged" | "all";
 export interface CleanupRequest {
     readonly repoRoot: string;
+    readonly allowedRepoRoot?: string;
+    readonly mode: CleanupMode;
+    readonly force: boolean;
 }
 export interface CleanupResult {
+    readonly worktreeRoot: string;
     readonly removedWorktrees: number;
+    readonly candidateWorktrees: number;
+    readonly protectedWorktrees: number;
+    readonly skippedUnownedDirectories: number;
+    readonly removedRoot: boolean;
+    readonly dryRun: boolean;
 }

package/dist/cleanup/index.d.ts

@@ -1,2 +1,2 @@
-export { NoopCleanupService } from "./cleanup.service.js";
+export { ManagedWorktreeCleanupService } from "./cleanup.service.js";
 export type { CleanupService } from "./cleanup.base.js";

package/dist/cleanup/index.js

@@ -1 +1 @@
-export { NoopCleanupService } from "./cleanup.service.js";
+export { ManagedWorktreeCleanupService } from "./cleanup.service.js";

package/dist/cleanup/internals.d.ts

@@ -1,3 +1,3 @@
-export { NoopCleanupService } from "./cleanup.service.js";
+export { ManagedWorktreeCleanupService } from "./cleanup.service.js";
 export type { CleanupService } from "./cleanup.base.js";
-export type { CleanupRequest, CleanupResult } from "./cleanup.types.js";
+export type { CleanupMode, CleanupRequest, CleanupResult } from "./cleanup.types.js";

package/dist/cleanup/internals.js

@@ -1 +1 @@
-export { NoopCleanupService } from "./cleanup.service.js";
+export { ManagedWorktreeCleanupService } from "./cleanup.service.js";

package/dist/cli/cli.help.js

@@ -16,9 +16,11 @@ export function helpText() {
         "  connect *        Start the runner bridge and wait for Forge dispatches",
         "  pair *           Pair this machine with Forge and save runner credentials",
         "  status *         Show config, runner identity, repos, provider CLIs, and updates",
+        "  server *         Show or change the saved Forge server URL",
         "  add-repo *       Map a Forge repo label/name to a local checkout path",
         "  remove-repo *    Remove a saved repo mapping",
         "  cleanup *        Prune managed bridge worktrees",
+        "  sandbox *        Initialize, diagnose, smoke-test, or reap Docker sandboxes",
         "  version *        Print the installed bridge package version",
         "  help *           Display help for command",
         "  run-once *       Internal: run one dispatch packet from JSON",
@@ -29,6 +31,7 @@ export function helpText() {
         "  forge-bridge pair 1234-5678 --server https://srv1493013.tail66073d.ts.net:8443 --repo-root \"%USERPROFILE%\\ForgeRepos\"",
         "  forge-bridge connect",
         "  forge-bridge status --check-updates",
+        "  forge-bridge server set http://localhost:5208",
         "  forge-bridge add-repo Forge D:\\Programming\\repos\\Forge",
         "  forge-bridge cleanup --stale",
         "",
@@ -99,6 +102,23 @@ export function commandHelpText(command) {
                 "  forge-bridge status --check-updates",
                 "",
             ].join("\n");
+        case "server":
+            return [
+                "Forge Bridge — server",
+                "Show or change the saved Forge server URL.",
+                "",
+                "Usage:",
+                "  forge-bridge server show",
+                "  forge-bridge server set <url>",
+                "",
+                "The saved runner credentials are retained. Pair again when switching to a different Forge deployment.",
+                "FORGE_URL overrides the saved server when that environment variable is set.",
+                "",
+                "Examples:",
+                "  forge-bridge server set http://localhost:5208",
+                "  forge-bridge server set https://srv1493013.tail66073d.ts.net:8443",
+                "",
+            ].join("\n");
         case "add-repo":
             return [
                 "Forge Bridge — add-repo",
@@ -133,6 +153,32 @@ export function commandHelpText(command) {
                 "  forge-bridge cleanup --all --force",
                 "",
             ].join("\n");
+        case "sandbox":
+            return [
+                "Forge Bridge — sandbox",
+                "Configure local Docker sandbox placement or inspect a repository-owned sandbox contract.",
+                "",
+                "Usage:",
+                "  forge-bridge sandbox on [--allow-open-public]",
+                "  forge-bridge sandbox off",
+                "  forge-bridge sandbox status",
+                "  forge-bridge sandbox init [--repo <path>]",
+                "  forge-bridge sandbox doctor [--repo <path>] [--require-pinned-base]",
+                "  forge-bridge sandbox smoke [--repo <path>] [--report <path>] [--require-pinned-base] [--probe-loopback-port]",
+                "  forge-bridge sandbox reap",
+                "",
+                "`sandbox on` keeps unrestricted public networking denied unless the explicit",
+                "developer-only --allow-open-public option is supplied. The local policy is",
+                "saved in bridge.json and takes effect after the connected bridge restarts.",
+                "Environment variables remain higher-priority operator overrides.",
+                "",
+                "The smoke command builds the repository Dockerfile, runs a disposable hardened",
+                "container, verifies exact-label teardown, and writes a redacted JSON report.",
+                "The optional port probe publishes 127.0.0.1::8080 only for the disposable fixture",
+                "and verifies Docker-assigned host-port discovery; normal sandboxes publish no ports.",
+                "Stop the connected bridge first so the Docker ownership lock can be acquired.",
+                "",
+            ].join("\n");
         case "run-once":
             return [
                 "Forge Bridge — run-once",
@@ -148,7 +194,7 @@ export function commandHelpText(command) {
                 "Internal MCP server used by provider CLIs to report Forge phase artifacts.",
                 "",
                 "Usage:",
-                "  forge-bridge mcp --worktree <path> --work-item-id <id> --phase <phase>",
+                "  forge-bridge mcp --worktree <path> --work-item-id <id> --phase <phase>  # includes ci-repair",
                 "",
             ].join("\n");
         case "version":

package/dist/cli/cli.service.d.ts

@@ -1,12 +1,15 @@
 import type { BridgeService } from "../bridge/bridge.base.js";
 import type { BridgeServiceConfig } from "../bridge/bridge.types.js";
+import type { CleanupMode } from "../cleanup/cleanup.types.js";
+import type { CleanupService } from "../cleanup/cleanup.base.js";
 import type { SessionService } from "../session/session.base.js";
 import type { CliIo, CliService } from "./cli.base.js";
 export declare class ForgeBridgeCliService implements CliService {
     private readonly sessions;
     private readonly bridgeFactory;
     private readonly pairRunner;
-    constructor(sessions?: SessionService, bridgeFactory?: (config: BridgeServiceConfig) => BridgeService, pairRunner?: PairRunnerClient);
+    private readonly cleanupFactory;
+    constructor(sessions?: SessionService, bridgeFactory?: (config: BridgeServiceConfig) => BridgeService, pairRunner?: PairRunnerClient, cleanupFactory?: CleanupServiceFactory);
     run(argv: readonly string[], io?: CliIo): Promise<number>;
 }
 export declare function parseArgs(argv: readonly string[]): {
@@ -34,6 +37,14 @@ export declare function parseArgs(argv: readonly string[]): {
     readonly ok: true;
     readonly command: "remove-repo";
     readonly label: string;
+} | {
+    readonly ok: true;
+    readonly command: "server-show";
+    readonly config: BridgeServiceConfig;
+} | {
+    readonly ok: true;
+    readonly command: "server-set";
+    readonly serverUrl: string;
 } | {
     readonly ok: true;
     readonly command: "status";
@@ -45,6 +56,35 @@ export declare function parseArgs(argv: readonly string[]): {
     readonly config: BridgeServiceConfig;
     readonly mode: CleanupMode;
     readonly force: boolean;
+} | {
+    readonly ok: true;
+    readonly command: "sandbox-init";
+    readonly repoPath: string;
+} | {
+    readonly ok: true;
+    readonly command: "sandbox-doctor";
+    readonly repoPath: string;
+    readonly requirePinnedBase: boolean;
+} | {
+    readonly ok: true;
+    readonly command: "sandbox-smoke";
+    readonly repoPath: string;
+    readonly reportPath?: string;
+    readonly requirePinnedBase: boolean;
+    readonly probeLoopbackPort: boolean;
+} | {
+    readonly ok: true;
+    readonly command: "sandbox-reap";
+} | {
+    readonly ok: true;
+    readonly command: "sandbox-on";
+    readonly allowOpenPublic: boolean;
+} | {
+    readonly ok: true;
+    readonly command: "sandbox-off";
+} | {
+    readonly ok: true;
+    readonly command: "sandbox-status";
 } | {
     readonly ok: false;
     readonly error: string;
@@ -66,5 +106,5 @@ interface PairRunnerClaim {
 type PairRunnerClient = (args: PairArgs) => Promise<PairRunnerClaim>;
 export declare function parseCodexModelCatalog(raw: string): string[];
 export declare function parseCursorModelList(raw: string): string[];
-type CleanupMode = "stale" | "merged" | "all";
+type CleanupServiceFactory = (stateRoot: string) => CleanupService;
 export {};