ctxmaster 0.0.1__tar.gz

ctxmaster-0.0.1/.gitignore

@@ -0,0 +1,30 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.venv/
+venv/
+test_env/
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Node (future packages)
+node_modules/
+
+# Rust (future crates)
+target/
+
+# Secrets and local environment
+.env
+.env.local
+*.key
+*secrets*
+
+# OS and editors
+.DS_Store
+Thumbs.db
+.vscode/
+.idea/

ctxmaster-0.0.1/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+All notable changes to ctxmaster are documented in this file.
+
+## 0.0.1 (2026-07-07)
+
+- Placeholder release reserving the package name on PyPI.
+- Declares the dependency on tokenmaster; exposes `__version__` and `about()`
+  only. No functional API yet.

ctxmaster-0.0.1/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.

ctxmaster-0.0.1/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: ctxmaster
+Version: 0.0.1
+Summary: Visualization layer for tokenmaster: CLI, terminal gauge, and dashboard renderers for LLM context-budget metering. Placeholder release.
+Project-URL: Homepage, https://github.com/jemsbhai/tokenmaster
+Project-URL: Repository, https://github.com/jemsbhai/tokenmaster
+Author-email: Muntaser Syed <jemsbhai@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: context-window,dashboard,gauge,llm,terminal,tokens,visualization
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Requires-Dist: tokenmaster>=0.0.1
+Description-Content-Type: text/markdown
+
+# 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.
+
+## 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

ctxmaster-0.0.1/README.md

@@ -0,0 +1,20 @@
+# 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.
+
+## 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

ctxmaster-0.0.1/examples/print_about.py

@@ -0,0 +1,8 @@
+"""Print ctxmaster placeholder metadata."""
+
+import ctxmaster
+
+
+if __name__ == "__main__":
+    for key, value in ctxmaster.about().items():
+        print(f"{key}: {value}")

ctxmaster-0.0.1/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "ctxmaster"
+version = "0.0.1"
+description = "Visualization layer for tokenmaster: CLI, terminal gauge, and dashboard renderers for LLM context-budget metering. Placeholder release."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+  { name = "Muntaser Syed", email = "jemsbhai@gmail.com" },
+]
+keywords = [
+  "llm",
+  "tokens",
+  "context-window",
+  "visualization",
+  "terminal",
+  "gauge",
+  "dashboard",
+]
+classifiers = [
+  "Development Status :: 1 - Planning",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Topic :: Scientific/Engineering :: Artificial Intelligence",
+  "Topic :: Software Development :: Libraries",
+]
+dependencies = [
+  "tokenmaster>=0.0.1",
+]
+
+[project.urls]
+Homepage = "https://github.com/jemsbhai/tokenmaster"
+Repository = "https://github.com/jemsbhai/tokenmaster"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ctxmaster"]

ctxmaster-0.0.1/src/ctxmaster/__init__.py

@@ -0,0 +1,26 @@
+"""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.
+"""
+
+import tokenmaster
+
+__version__ = "0.0.1"
+
+__all__ = ["about", "__version__"]
+
+
+def about() -> dict:
+    """Return basic project metadata for this placeholder release."""
+    return {
+        "name": "ctxmaster",
+        "version": __version__,
+        "summary": (
+            "Visualization layer for tokenmaster: CLI, terminal gauge, "
+            "and dashboard renderers."
+        ),
+        "core": f"tokenmaster {tokenmaster.__version__}",
+        "repository": "https://github.com/jemsbhai/tokenmaster",
+        "status": "placeholder",
+    }

ctxmaster-0.0.1/tests/test_placeholder.py

@@ -0,0 +1,15 @@
+"""Placeholder-release tests: import, version, dependency, and metadata sanity."""
+
+import ctxmaster
+import tokenmaster
+
+
+def test_version_matches_placeholder():
+    assert ctxmaster.__version__ == "0.0.1"
+
+
+def test_about_reports_core_version():
+    info = ctxmaster.about()
+    assert info["name"] == "ctxmaster"
+    assert tokenmaster.__version__ in info["core"]
+    assert info["status"] == "placeholder"