← Inventions Dashboard
Invention Summary
Tiered Precision State Cache (TPSC)
Tiered Precision State Cache (TPSC) -> Success (score=6.58). Promote this line toward an invention brief.
ID: tiered-precision-state-cache-tpsc
Folder: inventions/tiered-precision-state-cache-tpsc
Created: 2026-03-09 07:00:09
Updated: 2026-05-22 22:12:54
Files: 197
Source: student_autonomy
⬇ Download as .zip ~372.9 KB uncompressed
README.md
ARES's plain-English description of what this invention does and how to run it.
# Tiered Precision State Cache (TPSC)

Tiered Precision State Cache (TPSC) -> Success (score=6.58). Promote this line toward an invention brief.

## What This Project Does

This local package turns the invention signal into a runnable planner for 8GB-class inference decisions. It analyzes workload samples, recommends a memory/latency strategy, and demonstrates the plan on realistic mock workloads.

## Why Now

Tiered Precision State Cache (TPSC) -> Success (score=6.58). Promote this line toward an invention brief.

## Techniques

- `cache`

## Validation Context

- Benchmark status: `Validated`
- Innovation score: `0.00`
- Driving question: How should this validated signal be turned into a reusable project?
- Build plan: Package the benchmark insight as a local prototype with a stable demo entrypoint.

## Usage

```bash
python run_demo.py
```

<!-- ARES_AUTO_VERIFIED_SUMMARY:START -->
## Verified Project Notes

- Package import path: `tiered_precision_state_cache_tpsc`
- Entrypoint: `run_demo.py`
- Delivery mode: `prototype`
- Release tier: `prototype`
- Verification status: `FAIL`
- Clean-room release gates: `NOT_RUN`
- Public exports: `InventionPlanner, WorkloadSample, summarize_plan`
- Python files detected: `run_demo.py, tiered_precision_state_cache_tpsc/__init__.py, tiered_precision_state_cache_tpsc/_cache.py, tiered_precision_state_cache_tpsc/analysis.py, tiered_precision_state_cache_tpsc/cache.py, tiered_precision_state_cache_tpsc/cache_adapters.py, tiered_precision_state_cache_tpsc/cache_backend.py, tiered_precision_state_cache_tpsc/cache_config.py`

## Verification Commands

- `PASS` `"/home/corbybender/ares/.venv-linux/bin/python" -m py_compile "run_demo.py"`
- `FAIL` `"/home/corbybender/ares/.venv-linux/bin/python" -m compileall "tiered_precision_state_cache_tpps" "tiered_precision_state_cache_tpsc"`
- `PASS` `"/home/corbybender/ares/.venv-linux/bin/python" run_demo.py`

## Current Limits

- Verification failure: Listing 'tiered_precision_state_cache_tpps'... Listing 'tiered_precision_state_cache_tpsc'... Compiling 'tiered_precision_state_cache_tpsc/cache.py'... *** Sorry: IndentationError: unexpected unindent
- Orchestration hardening failed: AIIQ orchestration dependencies are not available (missing module: fastapi). Install this package with `pip install -e .[orchestration]`.
<!-- ARES_AUTO_VERIFIED_SUMMARY:END -->
Files
PathBytes
.tpsc_demo_cache/0ae1e31db43707e53a7a12c9c03e5c3a.cache 19
.tpsc_demo_cache/3dc54e03cbf450e7fae0761a232a8014.cache 19
.tpsc_demo_cache/4728a77acfb4709e83edb35cbf250951.cache 19
.tpsc_demo_cache/5dbb7b7c42691e19d1996309bddaed64.cache 19
.tpsc_demo_cache/6470f48aae40756b0c9d7128a1e734de.cache 19
.tpsc_demo_cache/b1d25b3f03c27d3cf01d83d00ef91c86.cache 21
.tpsc_demo_cache/d0ebc91df9f22f7aa46ec4c706d3d23e.cache 21
.tpsc_demo_cache/df1c096f35d27af5aa51efefe1825b03.cache 19
__pycache__/run_demo.cpython-314.pyc 931
demo_cache_tpsc/exp_A/reduced.json 629
demo_tpsc_cache/experiment_alpha_high.cache 45024
demo_tpsc_cache/index.json 73
DESIGN_BRIEF.md 873
dist/tiered_precision_state_cache_tpsc-0.1.0.tar.gz 2725
invention.json 5020
pyproject.toml 264
README.md 2371
run_demo.py 358
tiered_precision_state_cache_tpps/__pycache__/make_manager.cpython-314.pyc 1595
tiered_precision_state_cache_tpps/make_manager.py 511
tiered_precision_state_cache_tpsc.egg-info/dependency_links.txt 1
tiered_precision_state_cache_tpsc.egg-info/PKG-INFO 179
tiered_precision_state_cache_tpsc.egg-info/SOURCES.txt 382
tiered_precision_state_cache_tpsc.egg-info/top_level.txt 34
tiered_precision_state_cache_tpsc/__init__.py 135
tiered_precision_state_cache_tpsc/__pycache__/__init__.cpython-311.pyc 354
tiered_precision_state_cache_tpsc/__pycache__/__init__.cpython-314.pyc 335
tiered_precision_state_cache_tpsc/__pycache__/_cache.cpython-314.pyc 16881
tiered_precision_state_cache_tpsc/__pycache__/analysis.cpython-314.pyc 1421
tiered_precision_state_cache_tpsc/__pycache__/cache.cpython-314.pyc 1072
tiered_precision_state_cache_tpsc/__pycache__/cache_adapters.cpython-314.pyc 448
tiered_precision_state_cache_tpsc/__pycache__/cache_backend.cpython-314.pyc 1476
tiered_precision_state_cache_tpsc/__pycache__/cache_config.cpython-314.pyc 657
tiered_precision_state_cache_tpsc/__pycache__/cache_core.cpython-314.pyc 8057
tiered_precision_state_cache_tpsc/__pycache__/cache_engine.cpython-314.pyc 5873
tiered_precision_state_cache_tpsc/__pycache__/cache_manager.cpython-314.pyc 366
tiered_precision_state_cache_tpsc/__pycache__/cache_module.cpython-314.pyc 2743
tiered_precision_state_cache_tpsc/__pycache__/cache_operations.cpython-314.pyc 501
tiered_precision_state_cache_tpsc/__pycache__/cache_policy.cpython-314.pyc 557
tiered_precision_state_cache_tpsc/__pycache__/cache_system.cpython-314.pyc 1241
tiered_precision_state_cache_tpsc/__pycache__/caching.cpython-314.pyc 2493
tiered_precision_state_cache_tpsc/__pycache__/caching_system.cpython-314.pyc 1634
tiered_precision_state_cache_tpsc/__pycache__/codec.cpython-314.pyc 3207
tiered_precision_state_cache_tpsc/__pycache__/common.cpython-314.pyc 823
tiered_precision_state_cache_tpsc/__pycache__/compression.cpython-314.pyc 2763
tiered_precision_state_cache_tpsc/__pycache__/config.cpython-314.pyc 1557
tiered_precision_state_cache_tpsc/__pycache__/constants.cpython-314.pyc 361
tiered_precision_state_cache_tpsc/__pycache__/core.cpython-311.pyc 4400
tiered_precision_state_cache_tpsc/__pycache__/core.cpython-314.pyc 4513
tiered_precision_state_cache_tpsc/__pycache__/decimate.cpython-314.pyc 953
tiered_precision_state_cache_tpsc/__pycache__/decorators.cpython-314.pyc 1444
tiered_precision_state_cache_tpsc/__pycache__/demo.cpython-311.pyc 1309
tiered_precision_state_cache_tpsc/__pycache__/demo.cpython-314.pyc 1169
tiered_precision_state_cache_tpsc/__pycache__/encoders.cpython-314.pyc 4215
tiered_precision_state_cache_tpsc/__pycache__/encoding.cpython-314.pyc 4707
tiered_precision_state_cache_tpsc/__pycache__/engine.cpython-314.pyc 3850
tiered_precision_state_cache_tpsc/__pycache__/entry.cpython-314.pyc 1520
tiered_precision_state_cache_tpsc/__pycache__/enums.cpython-314.pyc 801
tiered_precision_state_cache_tpsc/__pycache__/evaluation_module.cpython-314.pyc 961
tiered_precision_state_cache_tpsc/__pycache__/example_util.cpython-314.pyc 1100
tiered_precision_state_cache_tpsc/__pycache__/exceptions.cpython-314.pyc 504
tiered_precision_state_cache_tpsc/__pycache__/manager.cpython-314.pyc 4521
tiered_precision_state_cache_tpsc/__pycache__/metrics.cpython-314.pyc 1028
tiered_precision_state_cache_tpsc/__pycache__/models.cpython-314.pyc 2483
tiered_precision_state_cache_tpsc/__pycache__/optimizer.cpython-314.pyc 3247
tiered_precision_state_cache_tpsc/__pycache__/precision.cpython-314.pyc 1849
tiered_precision_state_cache_tpsc/__pycache__/precision_manager.cpython-314.pyc 8294
tiered_precision_state_cache_tpsc/__pycache__/precision_ops.cpython-314.pyc 1849
tiered_precision_state_cache_tpsc/__pycache__/precision_tier.cpython-314.pyc 5510
tiered_precision_state_cache_tpsc/__pycache__/precision_utils.cpython-314.pyc 1032
tiered_precision_state_cache_tpsc/__pycache__/processor.cpython-314.pyc 1880
tiered_precision_state_cache_tpsc/__pycache__/quantization.cpython-314.pyc 3271
tiered_precision_state_cache_tpsc/__pycache__/quantize.cpython-314.pyc 1895
tiered_precision_state_cache_tpsc/__pycache__/quantizer.cpython-314.pyc 1679
tiered_precision_state_cache_tpsc/__pycache__/simple_state_cache.cpython-314.pyc 2564
tiered_precision_state_cache_tpsc/__pycache__/state.cpython-314.pyc 1688
tiered_precision_state_cache_tpsc/__pycache__/state_cache.cpython-314.pyc 4648
tiered_precision_state_cache_tpsc/__pycache__/state_cache_manager.cpython-314.pyc 1724
tiered_precision_state_cache_tpsc/__pycache__/state_caching.cpython-314.pyc 2651
tiered_precision_state_cache_tpsc/__pycache__/state_engine.cpython-314.pyc 9375
tiered_precision_state_cache_tpsc/__pycache__/state_handling.cpython-314.pyc 552
tiered_precision_state_cache_tpsc/__pycache__/state_manager.cpython-314.pyc 2237
tiered_precision_state_cache_tpsc/__pycache__/state_model.cpython-314.pyc 2662
tiered_precision_state_cache_tpsc/__pycache__/state_repo.cpython-314.pyc 1717
tiered_precision_state_cache_tpsc/__pycache__/state_storage.cpython-314.pyc 422
tiered_precision_state_cache_tpsc/__pycache__/stats.cpython-314.pyc 769
tiered_precision_state_cache_tpsc/__pycache__/storage.cpython-314.pyc 4700
tiered_precision_state_cache_tpsc/__pycache__/store.cpython-314.pyc 441
tiered_precision_state_cache_tpsc/__pycache__/strategies.cpython-314.pyc 2312
tiered_precision_state_cache_tpsc/__pycache__/strategy.cpython-314.pyc 3126
tiered_precision_state_cache_tpsc/__pycache__/tensor.cpython-314.pyc 3213
tiered_precision_state_cache_tpsc/__pycache__/tier_definitions.cpython-314.pyc 325
tiered_precision_state_cache_tpsc/__pycache__/tier_layer_priority.cpython-314.pyc 497
tiered_precision_state_cache_tpsc/__pycache__/tiered_cache.cpython-314.pyc 1879
tiered_precision_state_cache_tpsc/__pycache__/tiered_caches.cpython-314.pyc 149
tiered_precision_state_cache_tpsc/__pycache__/tiered_manager.cpython-314.pyc 696
tiered_precision_state_cache_tpsc/__pycache__/tiered_memory.cpython-314.pyc 2198
tiered_precision_state_cache_tpsc/__pycache__/tiered_operations.cpython-314.pyc 1001
tiered_precision_state_cache_tpsc/__pycache__/tiered_precedence_example.cpython-314.pyc 519
tiered_precision_state_cache_tpsc/__pycache__/tiering_algorithm.cpython-314.pyc 599
tiered_precision_state_cache_tpsc/__pycache__/tiers.cpython-314.pyc 4516
tiered_precision_state_cache_tpsc/__pycache__/tp_cache.cpython-314.pyc 3070
tiered_precision_state_cache_tpsc/__pycache__/tp_cache_example.cpython-314.pyc 2118
tiered_precision_state_cache_tpsc/__pycache__/tpsc.cpython-314.pyc 1318
tiered_precision_state_cache_tpsc/__pycache__/tpsc_core.cpython-314.pyc 9882
tiered_precision_state_cache_tpsc/__pycache__/tpsc_module.cpython-314.pyc 2716
tiered_precision_state_cache_tpsc/__pycache__/tspc_cache.cpython-314.pyc 1731
tiered_precision_state_cache_tpsc/__pycache__/types.cpython-314.pyc 383
tiered_precision_state_cache_tpsc/__pycache__/utils.cpython-314.pyc 349
tiered_precision_state_cache_tpsc/__pycache__/vector.cpython-314.pyc 2416
tiered_precision_state_cache_tpsc/_cache.py 9742
tiered_precision_state_cache_tpsc/analysis.py 1182
tiered_precision_state_cache_tpsc/cache.py 952
tiered_precision_state_cache_tpsc/cache_adapters.py 172
tiered_precision_state_cache_tpsc/cache_backend.py 656
tiered_precision_state_cache_tpsc/cache_config.py 131
tiered_precision_state_cache_tpsc/cache_controller.py 776
tiered_precision_state_cache_tpsc/cache_core.py 4523
tiered_precision_state_cache_tpsc/cache_engine.py 3280
tiered_precision_state_cache_tpsc/cache_manager.py 1915
tiered_precision_state_cache_tpsc/cache_module.py 873
tiered_precision_state_cache_tpsc/cache_operations.py 207
tiered_precision_state_cache_tpsc/cache_policy.py 120
tiered_precision_state_cache_tpsc/cache_system.py 331
tiered_precision_state_cache_tpsc/cache_tier.py 598
tiered_precision_state_cache_tpsc/caching.py 1044
tiered_precision_state_cache_tpsc/caching_mechanisms.py 275
tiered_precision_state_cache_tpsc/caching_system.py 621
tiered_precision_state_cache_tpsc/codec.py 2656
tiered_precision_state_cache_tpsc/common.py 435
tiered_precision_state_cache_tpsc/compression.py 1478
tiered_precision_state_cache_tpsc/config.py 641
tiered_precision_state_cache_tpsc/constants.py 116
tiered_precision_state_cache_tpsc/core.py 2228
tiered_precision_state_cache_tpsc/data_manager.py 435
tiered_precision_state_cache_tpsc/decimate.py 224
tiered_precision_state_cache_tpsc/decorators.py 919
tiered_precision_state_cache_tpsc/demo.py 627
tiered_precision_state_cache_tpsc/encoders.py 2694
tiered_precision_state_cache_tpsc/encoding.py 1731
tiered_precision_state_cache_tpsc/engine.py 2672
tiered_precision_state_cache_tpsc/entry.py 422
tiered_precision_state_cache_tpsc/enums.py 370
tiered_precision_state_cache_tpsc/evaluation_module.py 246
tiered_precision_state_cache_tpsc/example_util.py 437
tiered_precision_state_cache_tpsc/exceptions.py 78
tiered_precision_state_cache_tpsc/manager.py 2490
tiered_precision_state_cache_tpsc/metrics.py 594
tiered_precision_state_cache_tpsc/models.py 1110
tiered_precision_state_cache_tpsc/optimizer.py 2909
tiered_precision_state_cache_tpsc/precision.py 1403
tiered_precision_state_cache_tpsc/precision_manager.py 5216
tiered_precision_state_cache_tpsc/precision_ops.py 933
tiered_precision_state_cache_tpsc/precision_state_cache.py 1386
tiered_precision_state_cache_tpsc/precision_tier.py 2905
tiered_precision_state_cache_tpsc/precision_utils.py 440
tiered_precision_state_cache_tpsc/processor.py 1484
tiered_precision_state_cache_tpsc/quantization.py 2124
tiered_precision_state_cache_tpsc/quantize.py 1917
tiered_precision_state_cache_tpsc/quantizer.py 908
tiered_precision_state_cache_tpsc/simple_state_cache.py 812
tiered_precision_state_cache_tpsc/state.py 723
tiered_precision_state_cache_tpsc/state_cache.py 2813
tiered_precision_state_cache_tpsc/state_cache_manager.py 590
tiered_precision_state_cache_tpsc/state_caching.py 1066
tiered_precision_state_cache_tpsc/state_engine.py 5358
tiered_precision_state_cache_tpsc/state_handling.py 223
tiered_precision_state_cache_tpsc/state_manager.py 783
tiered_precision_state_cache_tpsc/state_model.py 1925
tiered_precision_state_cache_tpsc/state_repo.py 406
tiered_precision_state_cache_tpsc/state_storage.py 82
tiered_precision_state_cache_tpsc/stats.py 88
tiered_precision_state_cache_tpsc/storage.py 1883
tiered_precision_state_cache_tpsc/store.py 27
tiered_precision_state_cache_tpsc/strategies.py 1545
tiered_precision_state_cache_tpsc/strategy.py 2116
tiered_precision_state_cache_tpsc/tensor.py 1556
tiered_precision_state_cache_tpsc/tier_definitions.py 120
tiered_precision_state_cache_tpsc/tier_layer_priority.py 118
tiered_precision_state_cache_tpsc/tiered_cache.py 529
tiered_precision_state_cache_tpsc/tiered_caches.py 133
tiered_precision_state_cache_tpsc/tiered_manager.py 114
tiered_precision_state_cache_tpsc/tiered_memory.py 932
tiered_precision_state_cache_tpsc/tiered_operations.py 395
tiered_precision_state_cache_tpsc/tiered_precedence_example.py 381
tiered_precision_state_cache_tpsc/tiering_algorithm.py 172
tiered_precision_state_cache_tpsc/tiers.py 3404
tiered_precision_state_cache_tpsc/tp_cache.py 1171
tiered_precision_state_cache_tpsc/tp_cache_example.py 666
tiered_precision_state_cache_tpsc/tpsc.py 536
tiered_precision_state_cache_tpsc/tpsc_core.py 7165
tiered_precision_state_cache_tpsc/tpsc_impl.py 1400
tiered_precision_state_cache_tpsc/tpsc_module.py 1159
tiered_precision_state_cache_tpsc/tspc_cache.py 578
tiered_precision_state_cache_tpsc/types.py 191
tiered_precision_state_cache_tpsc/utils.py 229
tiered_precision_state_cache_tpsc/vector.py 1589
Manifest
Structured metadata ARES recorded when it created this project.
{
  "id": "tiered-precision-state-cache-tpsc",
  "title": "Tiered Precision State Cache (TPSC)",
  "summary": "Tiered Precision State Cache (TPSC) -> Success (score=6.58). Promote this line toward an invention brief.",
  "source": "student_autonomy",
  "kind": "invention",
  "path": "inventions/tiered-precision-state-cache-tpsc",
  "created_at": "2026-03-09 07:00:09",
  "updated_at": "2026-05-22 22:12:54",
  "project_status": "verification_failed",
  "project_entrypoint": "run_demo.py",
  "smoke_test_status": "passed",
  "smoke_test_output": "{ \"recommended\": \"chat-short\", \"average_score\": 2.647, \"plans\": [ { \"workload\": \"chat-short\", \"compression\": \"cache-aware\", \"precision\": \"fp16\", \"state_policy\": \"baseline\", \"expected_score\": 3.35 }, { \"workload\": \"analysis-medium\", \"compression\": \"cache-aware\", \"precision\": \"fp16\", \"state_policy\": \"baseline\", \"expected_score\": 2.55 }, { \"workload\": \"context-long\", \"compression\": \"cache-aware\", \"precision\": \"fp16\", \"state_policy\": \"baseline\", \"expected_score\": 2.04 } ] } INVENTION_SMOKE_TEST: PAS",
  "generated_files": 6,
  "project_generated_at": "2026-05-22 22:12:52",
  "source_hypothesis_id": "hyp-tiered-precision-state-cache-tpsc",
  "source_exp_path": "experiments\\exp_self.20260314194213.017_20260314_194240",
  "delivery_mode": "prototype",
  "release_tier": "prototype",
  "release_verification_status": "not_run",
  "verification_status": "failed",
  "verification_results": [
    {
      "command": "\"/home/corbybender/ares/.venv-linux/bin/python\" -m py_compile \"run_demo.py\"",
      "passed": true,
      "returncode": 0,
      "timed_out": false,
      "stdout_excerpt": "",
      "stderr_excerpt": ""
    },
    {
      "command": "\"/home/corbybender/ares/.venv-linux/bin/python\" -m compileall \"tiered_precision_state_cache_tpps\" \"tiered_precision_state_cache_tpsc\"",
      "passed": false,
      "returncode": 1,
      "timed_out": false,
      "stdout_excerpt": "Listing 'tiered_precision_state_cache_tpps'...\nListing 'tiered_precision_state_cache_tpsc'...\nCompiling 'tiered_precision_state_cache_tpsc/cache.py'...\n*** Sorry: IndentationError: unexpected unindent (cache.py, line 17)\nCompiling 'tiered_precision_state_cache_tpsc/cache_controller.py'...\n***   File \"tiered_precision_state_cache_tpsc/cache_controller.py\", line 12\n    return '\n           ^\nSyntaxError: unterminated string literal (detected at line 12)\n\nCompiling 'tiered_precision_state_cache_tpsc/cache_manager.py'...\n***   File \"tiered_precision_state_cache_tpsc/cache_manager.py\", line 48\n    \"\"\"Fetch the exact data point if exists or predict based on low-prec state.\"\"\n    ^\nSyntaxError: unterminated triple-quoted string literal (detected at line 53)\n\nCompiling 'tiered_precision_state_cache_tpsc/cache_tier.py'...\n*** Sorry: IndentationError: expected an indented block after class definition on line 3 (cache_tier.py, line 4)\nCompiling 'tiered_precision_state_cache_tpsc/caching_mechanisms.py'...\n*** Sorry: IndentationError: expected an indented block after function definition on line 3 (caching_mechanisms.py, line 5)\nCompiling 'tiered_precision_state_cache_tpsc/data_manager.py'...\n***   File \"tiered_precision_state_cache_tpsc/data_manager.py\", line 8\n    return {'value': 54, 'precision': 'high'}) # Demonstrative only.\n                                             ^\nSyntaxError: unmatched ')'\n\nCompiling 'tiered_precision_state_cache_tpsc/precision_state_cache.py'...\n***   File \"tiered_precision_state_cache_tpsc/precision_state_cache.py\", line 29\n    dump = '\n           ^\nSyntaxE",
      "stderr_excerpt": ""
    },
    {
      "command": "\"/home/corbybender/ares/.venv-linux/bin/python\" run_demo.py",
      "passed": true,
      "returncode": 0,
      "timed_out": false,
      "stdout_excerpt": "{\n  \"recommended\": \"chat-short\",\n  \"average_score\": 2.647,\n  \"plans\": [\n    {\n      \"workload\": \"chat-short\",\n      \"compression\": \"cache-aware\",\n      \"precision\": \"fp16\",\n      \"state_policy\": \"baseline\",\n      \"expected_score\": 3.35\n    },\n    {\n      \"workload\": \"analysis-medium\",\n      \"compression\": \"cache-aware\",\n      \"precision\": \"fp16\",\n      \"state_policy\": \"baseline\",\n      \"expected_score\": 2.55\n    },\n    {\n      \"workload\": \"context-long\",\n      \"compression\": \"cache-aware\",\n      \"precision\": \"fp16\",\n      \"state_policy\": \"baseline\",\n      \"expected_score\": 2.04\n    }\n  ]\n}\nINVENTION_SMOKE_TEST: PASS",
      "stderr_excerpt": ""
    }
  ],
  "verification_failure": {
    "command": "\"/home/corbybender/ares/.venv-linux/bin/python\" -m compileall \"tiered_precision_state_cache_tpps\" \"tiered_precision_state_cache_tpsc\"",
    "reason": ""
  }
}