closeout 0.0.1

package/README.md

@@ -0,0 +1,22 @@
+# closeout
+
+**Not yet released, and not yet on the roadmap.** This version reserves the name. The layer,
+its incumbents and the measurements behind it are documented in
+[`.sdlc/research/candidate-layers.md`](https://github.com/ofri-peretz/burgee/blob/main/.sdlc/research/candidate-layers.md).
+An intent and a working release follow if and when the roadmap takes it up.
+
+To **close out** is to settle and finish — an account, a position, a shift. Everything outstanding is resolved and nothing is left open.
+
+That is what a process should do on the way out, and mostly does not: handlers run once, resources released, the terminal returned to how it was found, and a deadline so a hung handler cannot hold the door.
+
+## What it will be
+
+- **Exactly once, on every path.** Normal exit, every signal, uncaught exception, unhandled rejection. Registering twice does not run twice.
+- **Terminal restore.** Cursor, raw mode and alternate screen returned to how they were found, so a cancelled program never leaves a terminal it broke.
+- **A bounded deadline.** Cleanup that hangs is cleanup that failed. Handlers get a budget, and exceeding it is reported rather than waited on — a hung handler is exactly what strands an agent with no human on deck.
+- **Drop-in paths** for `signal-exit`, `exit-hook` and `restore-cursor`, graded by their own suites.
+- **Zero external dependencies.**
+
+## Licence
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * closeout — name reserved, not yet on the roadmap. The layer and the measurements
+ * behind it are documented in .sdlc/research/candidate-layers.md in the burgee
+ * repository. Until an intent is opened this entry exports only its own name, so
+ * that importing it costs nothing and promises nothing.
+ */
+export declare const name: "closeout";

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * closeout — name reserved, not yet on the roadmap. The layer and the measurements
+ * behind it are documented in .sdlc/research/candidate-layers.md in the burgee
+ * repository. Until an intent is opened this entry exports only its own name, so
+ * that importing it costs nothing and promises nothing.
+ */
+export const name = 'closeout';
+//# sourceMappingURL=index.js.map

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "closeout",
+  "version": "0.0.1",
+  "description": "Close everything out. Exit handlers that run exactly once on every path, terminal restore, and a bounded deadline so shutdown cannot hang. Drop-in paths for signal-exit, exit-hook and restore-cursor. Zero dependencies.",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=24"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.map",
+    "!dist/**/*.test.*"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "lint": "eslint src"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ofri-peretz/burgee.git",
+    "directory": "packages/closeout"
+  },
+  "homepage": "https://github.com/ofri-peretz/burgee/tree/main/packages/closeout#readme",
+  "bugs": {
+    "url": "https://github.com/ofri-peretz/burgee/issues"
+  },
+  "keywords": [
+    "cli",
+    "terminal",
+    "exit",
+    "signal",
+    "signal-exit",
+    "exit-hook",
+    "cleanup",
+    "shutdown",
+    "restore-cursor",
+    "teardown"
+  ],
+  "devDependencies": {
+    "vitest": "^4.0.0"
+  }
+}