ctxmaster 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Muntaser Syed
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,22 @@
+# ctxmaster
+
+Visualization layer for tokenmaster, the core context-budget metering and
+decision engine for LLM applications. ctxmaster will provide the user-facing
+surfaces: a CLI, a live terminal gauge (context used, effective budget
+remaining, projected turns to exhaustion, compaction and handoff advice), and
+dashboard renderers. It consumes the serializable state and event schema that
+tokenmaster emits; anyone can build an alternative visualizer against the
+same contract.
+
+This npm package is published in parallel with the Python package of the same
+name on PyPI, with a Rust crate to follow.
+
+## Status
+
+0.0.1 is a placeholder release reserving the name while the core API is
+designed. Do not build against it yet. Development happens at
+https://github.com/jemsbhai/tokenmaster
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,26 @@
+'use strict';
+
+/**
+ * ctxmaster: visualization layer for tokenmaster.
+ *
+ * Placeholder release (0.0.1) reserving the package name while the core API
+ * is designed. Do not build against this version.
+ */
+
+const tokenmaster = require('tokenmaster');
+
+const version = '0.0.1';
+
+function about() {
+  return {
+    name: 'ctxmaster',
+    version,
+    summary:
+      'Visualization layer for tokenmaster: CLI, terminal gauge, and dashboard renderers.',
+    core: `tokenmaster ${tokenmaster.version}`,
+    repository: 'https://github.com/jemsbhai/tokenmaster',
+    status: 'placeholder',
+  };
+}
+
+module.exports = { version, about };

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "ctxmaster",
+  "version": "0.0.1",
+  "description": "Visualization layer for tokenmaster: CLI, terminal gauge, and dashboard renderers for LLM context-budget metering. Placeholder release.",
+  "main": "index.js",
+  "files": [
+    "index.js"
+  ],
+  "scripts": {
+    "test": "node --test"
+  },
+  "keywords": [
+    "llm",
+    "tokens",
+    "context-window",
+    "visualization",
+    "terminal",
+    "gauge",
+    "dashboard"
+  ],
+  "author": "Muntaser Syed <jemsbhai@gmail.com>",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "tokenmaster": "^0.0.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jemsbhai/tokenmaster.git",
+    "directory": "js/ctxmaster"
+  },
+  "bugs": {
+    "url": "https://github.com/jemsbhai/tokenmaster/issues"
+  },
+  "homepage": "https://github.com/jemsbhai/tokenmaster#readme"
+}