@tomflow/proflow-dev-tunnel 0.1.5 → 0.1.7

package/dist/deployment/descriptor.d.ts

@@ -3,16 +3,18 @@ export declare const descriptor: {
     readonly contractVersion: "1.0.0";
     readonly moduleRef: "dev-tunnel";
     readonly packageName: "@tomflow/proflow-dev-tunnel";
-    readonly moduleVersion: "0.1.5";
+    readonly moduleVersion: "0.1.7";
     readonly kind: "external-resource";
     readonly templateVersion: "1.0.0";
     readonly platformCompatibility: ">=1.0.0 <2.0.0";
-    readonly installClass: "core";
     readonly identity: {
         readonly domain: "deployment-governance";
         readonly summary: "Governs the Microsoft Dev Tunnel public HTTPS ingress resource and its managed local host process.";
     };
-    readonly provides: readonly [];
+    readonly provides: readonly [{
+        readonly contractRef: "public-ingress";
+        readonly version: "1.0.0";
+    }];
     readonly requires: readonly [];
     readonly requirements: readonly [{
         readonly kind: "executable";
@@ -21,44 +23,7 @@ export declare const descriptor: {
         readonly kind: "human";
         readonly action: "Complete Microsoft Dev Tunnel login when required";
     }];
-    readonly configSlots: readonly [{
-        readonly key: "publicBaseUrl";
-        readonly type: "url";
-        readonly required: true;
-        readonly description: "Public HTTPS URL supplied by the dev-tunnel resource";
-    }, {
-        readonly key: "tunnelId";
-        readonly type: "string";
-        readonly required: false;
-        readonly description: "Persistent Microsoft Dev Tunnel identifier used when this adapter owns lifecycle start/stop";
-    }, {
-        readonly key: "verificationEvidenceFile";
-        readonly type: "path";
-        readonly required: false;
-        readonly description: "JSON evidence for real file-relay and 429/5xx verification behind the configured public ingress";
-    }];
-    readonly lifecycle: {
-        readonly supported: readonly ["describe", "preflight", "status", "verify", "doctor", "start", "stop", "restart", "uninstall"];
-    };
-    readonly verification: {
-        readonly checks: readonly [{
-            readonly id: "tunnel-status";
-            readonly description: "dev-tunnel process reports a real running or stopped state";
-            readonly lifecycle: "status";
-        }, {
-            readonly id: "tunnel-public-ingress";
-            readonly description: "public HTTPS ingress passes the frozen TLS/port/size/latency contract";
-            readonly lifecycle: "verify";
-        }, {
-            readonly id: "tunnel-file-relay";
-            readonly description: "file relay behind the public ingress is reachable";
-            readonly lifecycle: "verify";
-        }, {
-            readonly id: "tunnel-diagnostics";
-            readonly description: "dev-tunnel configuration has actionable diagnostics";
-            readonly lifecycle: "doctor";
-        }];
-    };
+    readonly configSlots: readonly [];
     readonly effects: readonly [{
         readonly kind: "process";
         readonly description: "Manage the dev-tunnel public ingress process";
@@ -72,9 +37,8 @@ export declare const descriptor: {
         readonly description: "Exposes the local platform via a public HTTPS tunnel";
         readonly retention: "preserve";
     }];
-    readonly documentation: readonly [{
-        readonly id: "overview";
-        readonly path: "./README.md";
-        readonly description: "Dev Tunnel module overview";
-    }];
+    readonly documentation: {
+        readonly docs: "DOCS.md";
+        readonly setup: "SETUP.md";
+    };
 };

package/dist/deployment/descriptor.js

@@ -3,81 +3,32 @@ export const descriptor = {
     contractVersion: "1.0.0",
     moduleRef: "dev-tunnel",
     packageName: "@tomflow/proflow-dev-tunnel",
-    moduleVersion: "0.1.5",
+    moduleVersion: "0.1.7",
     kind: "external-resource",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",
-    installClass: "core",
     identity: {
         domain: "deployment-governance",
         summary: "Governs the Microsoft Dev Tunnel public HTTPS ingress resource and its managed local host process.",
     },
-    provides: [],
-    requires: [],
-    requirements: [
-        { kind: "executable", command: "devtunnel" },
+    provides: [
         {
-            kind: "human",
-            action: "Complete Microsoft Dev Tunnel login when required",
+            contractRef: "public-ingress",
+            version: "1.0.0",
         },
     ],
-    configSlots: [
-        {
-            key: "publicBaseUrl",
-            type: "url",
-            required: true,
-            description: "Public HTTPS URL supplied by the dev-tunnel resource",
-        },
+    requires: [],
+    requirements: [
         {
-            key: "tunnelId",
-            type: "string",
-            required: false,
-            description: "Persistent Microsoft Dev Tunnel identifier used when this adapter owns lifecycle start/stop",
+            kind: "executable",
+            command: "devtunnel",
         },
         {
-            key: "verificationEvidenceFile",
-            type: "path",
-            required: false,
-            description: "JSON evidence for real file-relay and 429/5xx verification behind the configured public ingress",
+            kind: "human",
+            action: "Complete Microsoft Dev Tunnel login when required",
         },
     ],
-    lifecycle: {
-        supported: [
-            "describe",
-            "preflight",
-            "status",
-            "verify",
-            "doctor",
-            "start",
-            "stop",
-            "restart",
-            "uninstall",
-        ],
-    },
-    verification: {
-        checks: [
-            {
-                id: "tunnel-status",
-                description: "dev-tunnel process reports a real running or stopped state",
-                lifecycle: "status",
-            },
-            {
-                id: "tunnel-public-ingress",
-                description: "public HTTPS ingress passes the frozen TLS/port/size/latency contract",
-                lifecycle: "verify",
-            },
-            {
-                id: "tunnel-file-relay",
-                description: "file relay behind the public ingress is reachable",
-                lifecycle: "verify",
-            },
-            {
-                id: "tunnel-diagnostics",
-                description: "dev-tunnel configuration has actionable diagnostics",
-                lifecycle: "doctor",
-            },
-        ],
-    },
+    configSlots: [],
     effects: [
         {
             kind: "process",
@@ -95,11 +46,8 @@ export const descriptor = {
             retention: "preserve",
         },
     ],
-    documentation: [
-        {
-            id: "overview",
-            path: "./README.md",
-            description: "Dev Tunnel module overview",
-        },
-    ],
+    documentation: {
+        docs: "DOCS.md",
+        setup: "SETUP.md",
+    },
 };

package/dist/src/index.d.ts

@@ -1,2 +1,2 @@
-export { behaviorAdapter, createBehaviorAdapter, } from "../deployment/adapter.ts";
+export { behaviorAdapter } from "../deployment/adapter.ts";
 export { descriptor } from "../deployment/descriptor.ts";

package/dist/src/index.js

@@ -1,2 +1,2 @@
-export { behaviorAdapter, createBehaviorAdapter, } from "../deployment/adapter.js";
+export { behaviorAdapter } from "../deployment/adapter.js";
 export { descriptor } from "../deployment/descriptor.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-dev-tunnel",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -15,13 +15,14 @@
     "proflow.module.json",
     "conformance.json",
     "README.md",
-    "self-install.mjs"
+    "DOCS.md",
+    "SETUP.md"
   ],
   "dependencies": {
-    "@tomflow/proflow-module-contract": "^0.1.1"
+    "@tomflow/proflow-module-contract": "^0.1.4"
   },
   "devDependencies": {
-    "@tomflow/proflow-deployment-conformance": "^0.1.2"
+    "@tomflow/proflow-deployment-conformance": "^0.1.4"
   },
   "description": "Governs the Microsoft Dev Tunnel public HTTPS ingress resource and its managed local host process.",
   "keywords": [
@@ -31,16 +32,9 @@
   ],
   "proflow": {
     "module": true,
-    "installClass": "core",
-    "installRequires": [
-      "@tomflow/proflow-module-contract"
-    ],
     "descriptor": "./dist/deployment/descriptor.js",
     "manifest": "./proflow.module.json"
   },
-  "bin": {
-    "proflow-dev-tunnel": "./self-install.mjs"
-  },
   "scripts": {
     "test": "node --test tests/**/*.test.ts",
     "typecheck": "tsc --noEmit"

package/proflow.module.json

@@ -3,16 +3,20 @@
 	"contractVersion": "1.0.0",
 	"moduleRef": "dev-tunnel",
 	"packageName": "@tomflow/proflow-dev-tunnel",
-	"moduleVersion": "0.1.5",
+	"moduleVersion": "0.1.7",
 	"kind": "external-resource",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",
-	"installClass": "core",
 	"identity": {
 		"domain": "deployment-governance",
 		"summary": "Governs the Microsoft Dev Tunnel public HTTPS ingress resource and its managed local host process."
 	},
-	"provides": [],
+	"provides": [
+		{
+			"contractRef": "public-ingress",
+			"version": "1.0.0"
+		}
+	],
 	"requires": [],
 	"requirements": [
 		{
@@ -24,63 +28,7 @@
 			"action": "Complete Microsoft Dev Tunnel login when required"
 		}
 	],
-	"configSlots": [
-		{
-			"key": "publicBaseUrl",
-			"type": "url",
-			"required": true,
-			"description": "Public HTTPS URL supplied by the dev-tunnel resource"
-		},
-		{
-			"key": "tunnelId",
-			"type": "string",
-			"required": false,
-			"description": "Persistent Microsoft Dev Tunnel identifier used when this adapter owns lifecycle start/stop"
-		},
-		{
-			"key": "verificationEvidenceFile",
-			"type": "path",
-			"required": false,
-			"description": "JSON evidence for real file-relay and 429/5xx verification behind the configured public ingress"
-		}
-	],
-	"lifecycle": {
-		"supported": [
-			"describe",
-			"preflight",
-			"status",
-			"verify",
-			"doctor",
-			"start",
-			"stop",
-			"restart",
-			"uninstall"
-		]
-	},
-	"verification": {
-		"checks": [
-			{
-				"id": "tunnel-status",
-				"description": "dev-tunnel process reports a real running or stopped state",
-				"lifecycle": "status"
-			},
-			{
-				"id": "tunnel-public-ingress",
-				"description": "public HTTPS ingress passes the frozen TLS/port/size/latency contract",
-				"lifecycle": "verify"
-			},
-			{
-				"id": "tunnel-file-relay",
-				"description": "file relay behind the public ingress is reachable",
-				"lifecycle": "verify"
-			},
-			{
-				"id": "tunnel-diagnostics",
-				"description": "dev-tunnel configuration has actionable diagnostics",
-				"lifecycle": "doctor"
-			}
-		]
-	},
+	"configSlots": [],
 	"effects": [
 		{
 			"kind": "process",
@@ -98,11 +46,8 @@
 			"retention": "preserve"
 		}
 	],
-	"documentation": [
-		{
-			"id": "overview",
-			"path": "./README.md",
-			"description": "Dev Tunnel module overview"
-		}
-	]
+	"documentation": {
+		"docs": "DOCS.md",
+		"setup": "SETUP.md"
+	}
 }

package/CHANGELOG.md

@@ -1,31 +0,0 @@
-# @tomflow/proflow-dev-tunnel
-
-## 0.1.5
-
-### Patch Changes
-
-- Make managed dev-tunnel stop idempotent when no owned tunnel process remains, while preserving UNKNOWN for genuinely ambiguous stop failures.
-
-## 0.1.4
-
-### Patch Changes
-
-- Detach the managed dev-tunnel host from the short-lived Platform CLI process and persist an ownership-checked process record so later status/stop/restart invocations can manage the same tunnel without turning `platform start` into a daemon.
-
-## 0.1.3
-
-### Patch Changes
-
-- Bind production dev-tunnel verification to an explicit evidence file for the frozen file-relay and 429/5xx proofs, while retaining live HTTPS/TLS/latency/size checks.
-
-## 0.1.2
-
-### Patch Changes
-
-- Real-1 final remediation and black-box release closure
-
-## 0.1.1
-
-### Patch Changes
-
-- Close the Real-1 global Platform control-plane contract across every published ProFlow package. Platform CLI now owns one durable global Workspace binding with canonical identity, cross-process operation locking, cwd/`--workspace` install targeting, cross-directory instance commands, whole-instance uninstall/rebind, and deterministic npm/yarn/pnpm Workspace package-manager selection. Every package-owned install entry, including newly generated Module Template packages, delegates to the Shell-global `platform` command and fails closed when that global CLI is unavailable; Deployment Conformance and the formal test plans mechanically enforce the same rule across all 24 packages.

package/dist/deployment/verification.d.ts

@@ -1,19 +0,0 @@
-export declare const verification: {
-    readonly checks: readonly [{
-        readonly id: "tunnel-status";
-        readonly description: "dev-tunnel process reports a real running or stopped state";
-        readonly lifecycle: "status";
-    }, {
-        readonly id: "tunnel-public-ingress";
-        readonly description: "public HTTPS ingress passes the frozen TLS/port/size/latency contract";
-        readonly lifecycle: "verify";
-    }, {
-        readonly id: "tunnel-file-relay";
-        readonly description: "file relay behind the public ingress is reachable";
-        readonly lifecycle: "verify";
-    }, {
-        readonly id: "tunnel-diagnostics";
-        readonly description: "dev-tunnel configuration has actionable diagnostics";
-        readonly lifecycle: "doctor";
-    }];
-};

package/dist/deployment/verification.js

@@ -1,2 +0,0 @@
-import { descriptor } from "./descriptor.js";
-export const verification = descriptor.verification;

package/self-install.mjs

@@ -1,29 +0,0 @@
-#!/usr/bin/env node
-import { spawnSync } from "node:child_process";
-
-const [command, ...rest] = process.argv.slice(2);
-const usage = "Usage: npx @tomflow/proflow-dev-tunnel install\n";
-if (command === "--help" || command === "-h") {
-	process.stdout.write(usage);
-	process.exit(0);
-}
-if (command !== "install" || rest.length > 0) {
-	process.stderr.write(usage);
-	process.exit(2);
-}
-const executable = process.platform === "win32" ? "platform.cmd" : "platform";
-const result = spawnSync(
-	executable,
-	["install", "@tomflow/proflow-dev-tunnel", "--workspace", process.cwd()],
-	{ cwd: process.cwd(), env: process.env, stdio: "inherit" },
-);
-if (result.error) {
-	if (result.error.code === "ENOENT") {
-		process.stderr.write(
-			"GLOBAL_PLATFORM_CLI_REQUIRED: install @tomflow/proflow-platform-cli globally before package-owned install\n",
-		);
-		process.exit(127);
-	}
-	throw result.error;
-}
-process.exit(result.status ?? 1);