@learnaltitude/cli 0.4.0 → 0.5.0
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.
- package/README.md +47 -45
- package/dist/cli.js +29 -31
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -21,10 +21,14 @@ altitude connect --agent claude-code
|
|
|
21
21
|
altitude connect --agent codex
|
|
22
22
|
```
|
|
23
23
|
|
|
24
|
-
Use one command, not both. Codex
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
24
|
+
Use one command, not both. Codex must meet the current compatibility floor documented on the
|
|
25
|
+
[W2 card](../../docs/BUILD-PLAN.md#w2--codex-adapter-config-only-by-mandate). Adapter-native
|
|
26
|
+
connect declares the detected version; the server refuses a parseable version below its floor
|
|
27
|
+
with server-authored remediation. The raw terminal command stamps the version as `"unknown"`,
|
|
28
|
+
which deliberately remains pairable. Other JSON connection failures likewise print the server's
|
|
29
|
+
message; non-JSON failures retain the HTTP status line. Connecting stores a scoped bearer token
|
|
30
|
+
in the CLI data directory (by default, `~/.altitude/token.json`) with owner-only permissions; it
|
|
31
|
+
does not activate hooks in every directory.
|
|
28
32
|
|
|
29
33
|
A directory declares WHICH journey it works. From the root of the project, pick from your
|
|
30
34
|
journey list:
|
|
@@ -64,70 +68,68 @@ that includes the nearest binding plus the bound journey's cached working-set su
|
|
|
64
68
|
requires a connected device token; the command tells unconnected users to connect and directs
|
|
65
69
|
users without a bindable journey back to Altitude.
|
|
66
70
|
|
|
67
|
-
The envelope also carries `update_available`, a client-local boolean
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
update with the agent rather than through `altitude update`.
|
|
71
|
+
The envelope also carries `update_available`, a client-local boolean that is true when the CLI is
|
|
72
|
+
behind the latest npm version seen by the last background version check. It is read from the local
|
|
73
|
+
update-check cache only — `altitude task` never makes a version request, so a lesson never waits on
|
|
74
|
+
one. Skills update separately through the agent's plugin system.
|
|
72
75
|
|
|
73
|
-
Tutor flows can attach
|
|
74
|
-
|
|
76
|
+
Tutor flows can attach the learner's verbatim answer to its canonical concepts. The tutor does
|
|
77
|
+
not grade the answer; grading and any resulting mastery update are server-side:
|
|
75
78
|
|
|
76
79
|
```sh
|
|
77
80
|
altitude emit quiz-moment --session <id> --question <q> --answer <a> \
|
|
78
|
-
--
|
|
81
|
+
--concepts <id,...>
|
|
79
82
|
```
|
|
80
83
|
|
|
81
84
|
`--concepts` accepts comma-separated IDs or repeated flags. The CLI trims empty entries, removes
|
|
82
85
|
duplicates in first-seen order, and omits `concept_ids` when no non-empty ID is supplied.
|
|
83
86
|
|
|
84
|
-
##
|
|
87
|
+
## Plugin marketplace installs and updates
|
|
85
88
|
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
+
Install the Altitude plugin exclusively through the marketplace built into your coding agent. In
|
|
90
|
+
Claude Code, run:
|
|
91
|
+
|
|
92
|
+
```text
|
|
93
|
+
/plugin marketplace add jasonku09/altitude-skills
|
|
94
|
+
/plugin install altitude@altitude
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
For Codex, run these commands in a terminal:
|
|
89
98
|
|
|
90
99
|
```sh
|
|
91
|
-
|
|
100
|
+
codex plugin marketplace add jasonku09/altitude-skills
|
|
101
|
+
codex plugin add altitude@altitude
|
|
92
102
|
```
|
|
93
103
|
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
104
|
+
On the first Codex launch after installation, accept the one-time
|
|
105
|
+
`Hooks need review -> Trust all and continue` prompt. Skills update with the agent's plugin system.
|
|
106
|
+
To update only the globally installed Altitude CLI, run:
|
|
97
107
|
|
|
98
108
|
```sh
|
|
99
109
|
altitude update
|
|
100
110
|
```
|
|
101
111
|
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
managed file or colliding pre-CLI copy is backed up in the CLI data directory (by default,
|
|
106
|
-
`~/.altitude/skills-backups/`) before the upstream version replaces or removes it. Backups never
|
|
107
|
-
live in an agent skills directory. If no copied install is configured, the skills step is an
|
|
108
|
-
informative no-op because marketplace or plugin-managed skills update through the agent.
|
|
109
|
-
After the skills step completes or is skipped, `altitude update` asks the detected global package
|
|
110
|
-
manager to update `@learnaltitude/cli`; if detection or execution fails, it prints the exact manual
|
|
111
|
-
command instead. A genuine copied-skills sync failure stops before the CLI self-update.
|
|
112
|
+
The command prints a one-line reminder that skills update with the agent, then asks the detected
|
|
113
|
+
global package manager to update `@learnaltitude/cli`. If detection or execution fails, it prints
|
|
114
|
+
the exact manual command instead.
|
|
112
115
|
|
|
113
116
|
## Network disclosure
|
|
114
117
|
|
|
115
118
|
The distributed client uses the user's own agent subscription and no Altitude-held API key.
|
|
116
119
|
Interactive `connect`, `diagnostics`, and `update` commands make anonymous, direct version checks
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
120
|
+
with a single request to `registry.npmjs.org` for the CLI's latest version. Check attempts are
|
|
121
|
+
throttled for 24 hours; the latest usable result remains cached until a later successful check
|
|
122
|
+
replaces it. The request does not pass through the Altitude service and carries no Altitude
|
|
123
|
+
credentials.
|
|
121
124
|
|
|
122
125
|
A bound SessionStart schedules the same anonymous check without awaiting it, and the detached
|
|
123
|
-
flusher daemon keeps doing so in the background.
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
and cannot change a command's exit code or discard a previously usable cache result.
|
|
126
|
+
flusher daemon keeps doing so in the background. The SessionStart process exits roughly 250 ms
|
|
127
|
+
after its command completes, so this scheduling improves spawn-fallback coverage only when the npm
|
|
128
|
+
request settles inside that remaining budget; it does not guarantee fallback coverage. An
|
|
129
|
+
interrupted attempt writes no marker and therefore cannot suppress a later daemon or command
|
|
130
|
+
attempt. Because unbound directories keep hooks dormant, they do not start a flusher or receive
|
|
131
|
+
background refreshes; their cache is refreshed only by `connect`, `diagnostics`, or `update`.
|
|
132
|
+
`altitude task --json` only reads the cache and never makes a request itself. Gates and other hooks
|
|
133
|
+
never perform the version check. Set `ALTITUDE_DISABLE_UPDATE_CHECK=1` to disable every version
|
|
134
|
+
check. All check failures are silent and cannot change a command's exit code or discard a
|
|
135
|
+
previously usable cache result.
|