stackbite 0.5.55 → 0.5.57

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stackbite",
-  "version": "0.5.55",
+  "version": "0.5.57",
   "description": "Verified native Stackbite CLI bootstrapper",
   "license": "UNLICENSED",
   "engines": {

package/packaging/npm/lib/bootstrap.js

@@ -8,6 +8,7 @@ const { download } = require('./download');
 const { extractArchive } = require('./archive');
 const { cacheDirectory, existingCacheDirectory } = require('./cache');
 const { parseSetup, stageReporter } = require('./setup');
+const timing = require('./startup-timing');
 const packageVersion = require('../../../package.json').version;
 
 // Only a glibc Linux host (or an injected runtime report) may select the Linux release.
@@ -226,10 +227,13 @@ async function main(argv = process.argv.slice(2), options = {}) {
   const platform = options.platform || process.platform;
   const environment = options.environment || process.env;
   const spec = releaseSpec(manifest, platform, options.arch || process.arch, options);
-  const installed = await ensureBinary(spec, { ...options, cache: options.cache || cacheDirectory(environment, platform),
+  // Every launch still verifies the full pinned payload; timing only observes it.
+  const installed = await timing.phase(environment, 'launcher.ensure', () => ensureBinary(spec, { ...options,
+    cache: options.cache || cacheDirectory(environment, platform),
     checkOnly: setup?.checkOnly || false, reportCached: Boolean(setup),
-    progress: options.progress || stageReporter(options.stderr || process.stderr) });
+    progress: options.progress || stageReporter(options.stderr || process.stderr) }));
   if (setup) return { code: 0, signal: null };
+  timing.mark(environment, 'launcher.exec');
   // The bundled runtime owns state discovery and migration for every entrypoint.
   return launchNative(installed.executable, argv, { ...environment,
     STACKBITE_HOME: path.resolve(installed.home) }, options);

package/packaging/npm/lib/startup-timing.js

@@ -0,0 +1,53 @@
+'use strict';
+// Optional bounded launcher phase timing; the same off-by-default JSONL contract as
+// private_pty/startup_timing.py (docs/startup-timing.md). Only fixed phase names,
+// monotonic offsets from Node process start, wall-clock start and ok/raised are
+// written: never arguments, paths, URLs, errors or credentials. Recording failures
+// are ignored and never change verification, refusal or launch.
+const fs = require('node:fs');
+const path = require('node:path');
+const { performance } = require('node:perf_hooks');
+
+const ENVIRONMENT = 'STACKBITE_STARTUP_TIMING_FILE';
+const SCHEMA = 'stackbite-startup-timing-v1';
+const MAX_RECORDS = 128;
+const NAME = /^[a-z][a-z0-9_.-]{0,63}$/;
+let written = 0;
+
+function target(environment) {
+  const value = environment[ENVIRONMENT];
+  return typeof value === 'string' && value && path.isAbsolute(value) ? value : null;
+}
+function record(environment, name, started, outcome, ended = performance.now()) {
+  const file = target(environment);
+  if (file === null || !NAME.test(name) || written >= MAX_RECORDS) return;
+  written++;
+  const line = JSON.stringify({ schema: SCHEMA, pid: process.pid, phase: name,
+    start_ms: Math.round(started * 1000) / 1000, ms: Math.round((ended - started) * 1000) / 1000,
+    wall_ms: Math.round(performance.timeOrigin + started), outcome }) + '\n';
+  const { O_WRONLY, O_CREAT, O_APPEND, O_NOFOLLOW = 0 } = fs.constants;
+  try {
+    const descriptor = fs.openSync(file, O_WRONLY | O_CREAT | O_APPEND | O_NOFOLLOW, 0o600);
+    try { fs.writeSync(descriptor, line); } finally { fs.closeSync(descriptor); }
+  } catch { /* advisory only */ }
+}
+// Times one awaited step; its result or rejection passes through unchanged.
+async function phase(environment, name, step) {
+  const started = performance.now();
+  try {
+    const result = await step();
+    record(environment, name, started, 'ok');
+    return result;
+  } catch (error) {
+    record(environment, name, started, 'raised');
+    throw error;
+  }
+}
+// A zero-length phase: the moment a step (such as the native exec) begins.
+function mark(environment, name) {
+  const now = performance.now();
+  record(environment, name, now, 'ok', now);
+}
+function resetForTest() { written = 0; }
+
+module.exports = { ENVIRONMENT, SCHEMA, MAX_RECORDS, phase, mark, resetForTest };

package/packaging/npm/release.json

@@ -1,26 +1,26 @@
 {
   "schema": 1,
-  "version": "0.5.55",
-  "commit": "94d083b5504c22e9c2068d9eb2ef805029f942cf",
+  "version": "0.5.57",
+  "commit": "8ae067ad59076354f38c1b3744a0d8ea88122503",
   "repository": "Shinick-Han/stackbite",
   "platforms": {
     "win32-x64": {
-      "asset": "stackbite-0.5.55-windows-x64-94d083b5504c.zip",
-      "url": "https://github.com/Shinick-Han/stackbite/releases/download/v0.5.55/stackbite-0.5.55-windows-x64-94d083b5504c.zip",
-      "sha256": "02f048e19c05f7646932ae230e7e614bc4843350e38984f63bea91626217baa8",
-      "size": 88972563,
-      "root": "stackbite-0.5.55-windows-x64-94d083b5504c",
-      "manifestSha256": "38ff0ae513bbbdc2bfab09eb224d9272cabf16cb0e5eb9578791b6b6997451b7",
-      "metadataSha256": "4ed9b96199b7dc45ba9992bb3c59787bfd08d0a30fe3cc80b415a45611f5cf30"
+      "asset": "stackbite-0.5.57-windows-x64-8ae067ad5907.zip",
+      "url": "https://github.com/Shinick-Han/stackbite/releases/download/v0.5.57/stackbite-0.5.57-windows-x64-8ae067ad5907.zip",
+      "sha256": "67196ede037e83a7d6da7a3f5eeebb5b86917e2383c9c66769335907fa42fccc",
+      "size": 88197128,
+      "root": "stackbite-0.5.57-windows-x64-8ae067ad5907",
+      "manifestSha256": "1f71e45fe7b3fb75f358be619db47a7f6a8b41c962eb7ccb7d7c2da0399f91b8",
+      "metadataSha256": "f7e84c68e9bb7c9a8c17955e6d5af0400c0925bcbc75300384df57ef394f7bba"
     },
     "linux-x64": {
-      "asset": "stackbite-0.5.55-linux-x86_64-94d083b5504c.tar.gz",
-      "url": "https://github.com/Shinick-Han/stackbite/releases/download/v0.5.55/stackbite-0.5.55-linux-x86_64-94d083b5504c.tar.gz",
-      "sha256": "74c5c9208834662f3163e3eb37e87d6cfd538792e9647a6b17511179fffc5a14",
-      "size": 72162249,
-      "root": "stackbite-0.5.55-linux-x86_64-94d083b5504c",
-      "manifestSha256": "cec8ea3fc0e932be889f59fcea4e85b73b39a6404fe906b87f80fac90202c6ff",
-      "metadataSha256": "1339459a3b2501df8ee19be8adfab2fd5b7add7115c326204f79bf2d1362a7b4"
+      "asset": "stackbite-0.5.57-linux-x86_64-8ae067ad5907.tar.gz",
+      "url": "https://github.com/Shinick-Han/stackbite/releases/download/v0.5.57/stackbite-0.5.57-linux-x86_64-8ae067ad5907.tar.gz",
+      "sha256": "773ae954bb8bfe06f2d650ead890ade60ea72a2d7a68b9724e97ff5ed413d2e8",
+      "size": 72285655,
+      "root": "stackbite-0.5.57-linux-x86_64-8ae067ad5907",
+      "manifestSha256": "e5c1c3d507faaebb12748fea1ff8c1a1e675962c6f501e390d20e6f2ec93b1cb",
+      "metadataSha256": "09f17f8eee7f37bf9711441d4e44823ffb3ba591b30f91e1b2b3da879860d8f0"
     }
   }
 }