zam-core 0.3.6 → 0.3.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -21,7 +21,7 @@ All knowledge management is done through the `zam` CLI:
21
21
  zam init
22
22
 
23
23
  # Token management
24
- zam token register --slug <slug> --concept "<one sentence>" --domain <d> --bloom <1-5> [--source-link <link>]
24
+ zam token register --slug <slug> --concept "<one sentence>" --domain <d> --bloom <1-5> [--question "<concept-free recall question>"] [--source-link <link>]
25
25
  zam token find --query "<keywords>"
26
26
  zam token list [--domain <d>]
27
27
  zam token prereq --token <child> --requires <parent>
@@ -143,8 +143,13 @@ zam token find --query "<keywords>"
143
143
  Only register genuinely new concepts. Reuse existing slugs where the concept matches.
144
144
 
145
145
  **Register tokens and prerequisites:**
146
+
147
+ As the frontier model, YOU author both the concept and the recall question. The
148
+ local LLM is reserved for review time, where it rephrases the question live so
149
+ the learner never memorizes a fixed input->output pair. Pass a clear,
150
+ concept-free `--question` so the offline fallback stays high quality:
146
151
  ```bash
147
- zam token register --slug <slug> --concept "<one sentence>" --domain <d> --bloom <1-5>
152
+ zam token register --slug <slug> --concept "<one sentence>" --domain <d> --bloom <1-5> --question "<concept-free recall question>" [--source-link <link>]
148
153
  zam token prereq --token <child> --requires <parent>
149
154
  ```
150
155
 
@@ -24,7 +24,7 @@ All knowledge management is done through the `zam` CLI:
24
24
  zam init
25
25
 
26
26
  # Token management
27
- zam token register --slug <slug> --concept "<one sentence>" --domain <d> --bloom <1-5> [--source-link <link>]
27
+ zam token register --slug <slug> --concept "<one sentence>" --domain <d> --bloom <1-5> [--question "<concept-free recall question>"] [--source-link <link>]
28
28
  zam token find --query "<keywords>"
29
29
  zam token list [--domain <d>]
30
30
  zam token prereq --token <child> --requires <parent>
@@ -146,8 +146,14 @@ zam token find --query "<keywords>"
146
146
  Only register genuinely new concepts. Reuse existing slugs where the concept matches.
147
147
 
148
148
  **Register tokens and prerequisites:**
149
+
150
+ As the frontier model, author both the concept and the recall question. The
151
+ local LLM is reserved for review time, where it can rephrase the question
152
+ without making token registration slow or model-dependent. Pass a clear,
153
+ concept-free `--question`; add `--source-link` when the concept is grounded in
154
+ a file or reference:
149
155
  ```bash
150
- zam token register --slug <slug> --concept "<one sentence>" --domain <d> --bloom <1-5>
156
+ zam token register --slug <slug> --concept "<one sentence>" --domain <d> --bloom <1-5> --question "<concept-free recall question>" [--source-link <link>]
151
157
  zam token prereq --token <child> --requires <parent>
152
158
  ```
153
159
 
@@ -21,7 +21,7 @@ All knowledge management is done through the `zam` CLI:
21
21
  zam init
22
22
 
23
23
  # Token management
24
- zam token register --slug <slug> --concept "<one sentence>" --domain <d> --bloom <1-5> [--source-link <link>]
24
+ zam token register --slug <slug> --concept "<one sentence>" --domain <d> --bloom <1-5> [--question "<concept-free recall question>"] [--source-link <link>]
25
25
  zam token find --query "<keywords>"
26
26
  zam token list [--domain <d>]
27
27
  zam token prereq --token <child> --requires <parent>
@@ -143,8 +143,13 @@ zam token find --query "<keywords>"
143
143
  Only register genuinely new concepts. Reuse existing slugs where the concept matches.
144
144
 
145
145
  **Register tokens and prerequisites:**
146
+
147
+ As the frontier model, YOU author both the concept and the recall question. The
148
+ local LLM is reserved for review time, where it rephrases the question live so
149
+ the learner never memorizes a fixed input->output pair. Pass a clear,
150
+ concept-free `--question` so the offline fallback stays high quality:
146
151
  ```bash
147
- zam token register --slug <slug> --concept "<one sentence>" --domain <d> --bloom <1-5>
152
+ zam token register --slug <slug> --concept "<one sentence>" --domain <d> --bloom <1-5> --question "<concept-free recall question>" [--source-link <link>]
148
153
  zam token prereq --token <child> --requires <parent>
149
154
  ```
150
155