cnhkmcp 2.3.2__py3-none-any.whl → 2.3.3__py3-none-any.whl

cnhkmcp/untracked/APP/trailSomeAlphas/skills/brain-feature-implementation/scripts/ace.log

@@ -13,3 +13,4 @@ Incorrect email or password
 2026-01-31 17:23:26,330 - ace - ERROR - 
 Incorrect email or password
 
+2026-01-31 23:49:39,982 - ace - WARNING - No fields found: region=GLB, delay=1, universe=TOPDIV3000, type=VECTOR, dataset.id=fundamental28

cnhkmcp/untracked/skills/brain-inspectTemplate-create-Setting/.gitignore

@@ -0,0 +1,14 @@
+# Local secrets
+config.json
+
+# Snapshots / outputs
+sim_options_snapshot.json
+processed_templates/
+
+# Python
+__pycache__/
+*.pyc
+.pytest_cache/
+
+# Logs
+*.log

cnhkmcp/untracked/skills/brain-inspectTemplate-create-Setting/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: brain-inspecttemplate-create-setting
+description: >-
+  Reads a BRAIN template/idea JSON (template/idea/expression_list) like
+  fundamental28_GLB_1_idea_<timestamp>.json, fetches valid simulation setting options
+  via ace_lib.get_instrument_type_region_delay, resolves region/delay/universe/neutralization,
+  and builds an Alpha list JSON (one Alpha per expression) using ace_lib.generate_alpha.
+  Use when user asks to inspect template files, attach settings, create alpha list, or validate settings.
+user-invocable: true
+---
+
+# brain-inspectTemplate-create-Setting
+
+This skill is designed for *stable, repeatable runs*.
+
+## Deterministic vs AI responsibilities
+
+Deterministic (scripts):
+- **Entry Point**: `scripts/process_template.py` handles the initial flow (Part 1).
+- **Part 1 Output**: `settings_candidates.json` containing valid platform options for the detected Region/Delay.
+- **Part 2 Output**: `alpha_list.json` (generated iteratively by AI).
+
+AI reasoning (Critical Step):
+- **Input**: The AI must read `idea_context.json` (to understand intent) AND `settings_candidates.json` (to see valid options).
+- **Loop**: The AI can decide on **multiple** setting combinations if the idea is ambiguous or worth testing broadly.
+  - e.g., Run 1: `Universe=TOP3000`, `Neutralization=INDUSTRY`
+  - e.g., Run 2: `Universe=TOPDIV3000`, `Neutralization=MARKET`
+- **Action**: For EACH chosen setting, call `scripts/build_alpha_list.py` passing the settings as a JSON string.
+  - The script will **APPEND** to `alpha_list.json`, allowing comprehensive test coverage.
+
+## Config / credentials check (startup)
+
+To connect to BRAIN API (only needed for fetching sim options), provide credentials via one of:
+1) Environment variables: `BRAIN_USERNAME` (or `BRAIN_EMAIL`) and `BRAIN_PASSWORD`
+2) `config.json` next to this file (see `config.example.json`)
+3) `~/secrets/platform-brain.json` (keys: `email`/`password`)
+
+Never commit real credentials. Keep `config.json` local.
+
+## Run steps
+
+**Important**: Always navigate to the skill directory first, as scripts rely on relative paths.
+
+### One-click Processing (Recommended)
+1. **Navigate to skill folder**:
+   `cd "path/to/brain-inspectTemplate-create-Setting"`
+
+2. **Run wrapper script**:
+   Use the wrapper script to generate all artifacts in a dedicated folder (e.g., `processed_templates/<filename>/`).
+
+   `C:/Python313/python.exe scripts/process_template.py --file <absolute_path_to_input_json>`
+
+   *Example*:
+   `C:/Python313/python.exe scripts/process_template.py --file "C:/Users/user/Downloads/fundamental28_GLB_1_idea_...json"`
+
+This will:
+1. Parse the idea file.
+2. Fetch simulation options (if `sim_options_snapshot.json` missing in root).
+3. Resolve settings.
+4. Generate the Alpha list.
+
+### Manual Steps (Debug)
+
+From this folder:
+
+1) Parse idea JSON
+- `C:/Python313/python.exe scripts/parse_idea_file.py --input fundamental28_GLB_1_idea_1769874845978315000.json --out idea_context.json`
+
+2) Fetch sim options snapshot (requires credentials)
+- `C:/Python313/python.exe scripts/fetch_sim_options.py --out sim_options_snapshot.json`
+
+3) Resolve settings
+- `C:/Python313/python.exe scripts/resolve_settings.py --idea idea_context.json --options sim_options_snapshot.json --out resolved_settings.json`
+
+4) Build alpha list
+- `C:/Python313/python.exe scripts/build_alpha_list.py --idea idea_context.json --settings resolved_settings.json --out alpha_list.json`