vibe64 0.1.39 → 0.1.41

package/docs/training-content.md

@@ -36,11 +36,13 @@ entry declares `code`, `descriptor`, `status` (`draft` or `published`) and
 `required`. A released topic cannot contain required draft lessons. Draft content
 is validated but remains unavailable for teaching until published and installed.
 
-Lessons use lesson format v2 (see **Lesson format v2: steps** below). Format 1
-is retired: `vibe64-training validate` and `publish-manifest` refuse a v1 lesson
-("Lesson X uses retired lesson format 1. Author it in format 2 with steps."), so
-no new course release can contain one. Installed v1 lessons, and `bundle`, which
-the installer uses, still read and verify them so earlier results stay valid.
+Lessons use lesson format v3: format v2 (see **Lesson format v2: steps**
+below) plus a required `stage` (see **Lesson format v3: stage and facts**).
+Formats 1 and 2 are retired: `vibe64-training validate` and `publish-manifest`
+refuse them ("Lesson X uses retired lesson format N. Author it in format 3 with
+steps and its stage."), so no new course release can contain one, and a lesson
+in a retired format cannot be started. Installed older lessons, and `bundle`,
+which the installer uses, still read and verify them.
 The topic manifest itself stays schema version 1.
 
 For reading existing content, a v1 lesson descriptor declares schema version 1, `code`, `title`, `document`,
@@ -76,13 +78,33 @@ lesson but no current reader consumes them (they labelled the retired Learning
 watch's hints); they never grade, and a lesson without an exercise cannot
 declare them.
 
+### Lesson format v3: stage and facts
+
+A v3 `lesson.json` declares `schemaVersion: 3` and everything v2 has, plus
+`stage`: `"project"` for a lesson taught in its practice project (it needs its
+`exercise`), or `"studio"` for one taught on the screens outside any project
+(its Lesson sheet lies over the page while the Lesson toggle is on). Learn mode opens a lesson where its
+stage says.
+
+A step may check a fact: `"check": { "kind": "fact", "fact": "ai-ready" }`,
+with a final `check fact` beat when the step has beats. The installation reads
+the fact for the learner when they press **Check now**; built in, `ai-ready`
+holds once their AI is set up for Colleague. A topic may declare names its
+lessons use that only some installations provide, in optional `places`,
+`activities` and `facts` lists in `topic.json`. A step whose places, activities
+and facts are all available here, and whose places this person may open, is
+shown; the others are left out of the lesson, and completion counts only the
+required steps shown. A lesson with a required step left out is left out of
+Courses here (and cannot start), as is a topic left without lessons. A course
+may name its `orientation`, one of its published lessons.
+
 ### Lesson format v2: steps
 
 A v2 `lesson.json` declares `schemaVersion: 2` and keeps `code`, `title`,
 `prerequisites`, `estimatedMinutes`, `visuals`, `exercise`, `checks` and
 `appRoutes` exactly as above. It has no `document` and no `assessments`:
 an optional `notes` file (background reading) and 1–32 ordered `steps` replace
-them. The fixture `tests/fixtures/training/steps-v2/` is a complete, validating
+them. The fixture `tests/fixtures/training/steps-v3/` is a complete, validating
 topic with every step kind; the copyable template is `docs/templates/learn-topic/`.
 
 ```json
@@ -178,7 +200,7 @@ One beat per line: `<show|do|check> <target>[ <path>]: <text>`.
   step's `check.rubric` from `lesson.json`, its single source.
 - Places: `preview`, `dashboard`, `database-erd`, `database-data`, `files`,
   `changes`, `git-log`, `session-info`, `architecture`, `learning` (the **L**
-  button), `lesson` (the Lesson tab), `chat` (the coding chat), `colleague`,
+  button), `lesson` (the **Lesson** toggle), `chat` (the coding chat), `colleague`,
   `courses`, `lesson-bar` (the bar itself), `save` and `reload-preview`.
   `dashboard` and `lesson-bar` can only be shown.
 - 1–8 beats. Only `lesson`, `lesson-bar`, `courses`, `learning`,
@@ -192,8 +214,8 @@ step's check kind, a second or non-final check, a block that is not closed or
 does not end the body, and beats together with a `guide`. Back and Next in the
 bar move by beat into the neighbouring steps; after the last beat the bar shows
 the step's own verdict control (Done, Mark as done, Check my work, or Answer in
-Step for a choice) and Next step. **Step** (≡) on the bar opens the whole step
-text under it in one click, so a beat never needs to repeat the body. Steps never advance by themselves.
+Lesson for a choice) and Next step. **Lesson** on the bar shows the whole step
+text in the Lesson pane in one click, so a beat never needs to repeat the body. Steps never advance by themselves.
 
 **Check verdicts are final.** Verdicts come from the step's declared check: an
 automatic check, the choice comparator, a review check (the learner's own AI
@@ -229,8 +251,8 @@ heading is green and nothing else broke":
   40,000 characters). Work the coding agent did at the learner's request
   counts unless the rubric says the learner must do it themselves.
 - **Check my work** runs only from the learner's own browser, on the
-  learner's own AI account: the Helper route of their workflow in **AI
-  Accounts → Model routing** (workload `lesson_review`, input at most 160,000
+  learner's own AI account: their **Explain & check** model in **AI
+  Accounts → Models** (workload `lesson_review`, input at most 160,000
   characters, 180 seconds). Vibe64 never pays for or resells it.
 - The reviewer returns Passed or Not yet, a comment (at most 600
   characters), a hint for Not yet (at most 300) and up to six rubric points.
@@ -258,7 +280,7 @@ cannot be any v2 lesson descriptor of the topic (for example, an exercise
 
 A code question is an `auto` step whose `check` names a code check and whose
 `files` name the exercise files the learner edits (the fixture
-`tests/fixtures/training/steps-v2/` contains one):
+`tests/fixtures/training/steps-v3/` contains one):
 
 ```json
 "exercise": { "kind": "bundled", "source": "app", "reuse": "attempt" },
@@ -367,9 +389,9 @@ is rejected. A released course requires released topics with no required drafts.
 A preview course is for the workspace owner to review: `lesson.start` admits its
 published lessons only when the actor is the workspace owner (on local Vibe64,
 the OS user), and refuses everyone else with `VIBE64_TRAINING_COURSE_PREVIEW`.
-`courses.list` reports `canTryPreviews`, and Courses shows the owner **Try
-preview**. The started attempt is an ordinary saved lesson. Releasing the course
-offers **Start** to everyone; draft lessons and disabled courses stay refused.
+`courses.list` reports `canTryPreviews`, and Courses shows the owner the usual
+start buttons beside the **Preview course** chip. The started attempt is an
+ordinary saved lesson. Releasing the course offers **Start lesson** to everyone; draft lessons and disabled courses stay refused.
 
 Run `vibe64 training publish-manifest <course.json> <committed-topic-directory...>`
 with one canonical repository root for each selected topic. Each topic's package

package/node_modules/@jskit-ai/assistant-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/assistant-core",
-  "version": "0.1.238",
+  "version": "0.1.240",
   "type": "module",
   "exports": {
     "./client": "./src/client/index.js",

package/node_modules/@jskit-ai/assistant-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/assistant-runtime",
-  "version": "0.1.232",
+  "version": "0.1.234",
   "type": "module",
   "exports": {
     "./client": "./src/client/index.js",

package/node_modules/@jskit-ai/assistant-voice/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/assistant-voice",
-  "version": "0.1.39",
+  "version": "0.1.41",
   "type": "module",
   "exports": {
     "./client": "./src/client/index.js",

package/node_modules/@jskit-ai/connector-google-calendar/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/connector-google-calendar",
-  "version": "0.1.61",
+  "version": "0.1.62",
   "type": "module",
   "exports": {
     "./shared": "./src/shared/definition.js",

package/node_modules/@jskit-ai/connectors-catalog/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/connectors-catalog",
-  "version": "0.1.62",
+  "version": "0.1.64",
   "type": "module",
   "exports": {
     "./shared/ai": "./src/shared/ai.js",

package/node_modules/@jskit-ai/connectors-catalog/patterns/oauth-connection/PATTERN.md

@@ -181,6 +181,31 @@ comma-separated permissions. Oura handles reduced callback scopes and rotated
 refresh tokens. Some providers do not return a refresh token; expired access
 then needs consent again. Provider PKCE enforcement needs provider evidence.
 
+## Shared connection from an Env refresh token
+
+When the application's host already holds a long-lived grant for the shared
+account (the owner connected it once with the same OAuth client), skip consent
+in the app: add `refreshTokenRef` to a `shared` oauth2 integration whose
+registration uses the authorization-code flow.
+
+```json
+"authentication": {
+  "method": "oauth2",
+  "registrationRef": "google",
+  "refreshTokenRef": "env:GOOGLE_REFRESH_TOKEN"
+}
+```
+
+The Env value is a seed. On first use, and whenever the value or the OAuth
+client changes, the runtime replaces the shared connection with one built from
+that refresh token. From then on it refreshes and stores rotated tokens in the
+application's own store as usual. `status()` reports `source: "env"` (show it as
+"Connected from Env"). `beginAuthorization()` and `disconnect()` refuse with
+`connector_env_managed`: "This connection comes from an Env value; unlink or
+replace that value instead." A revoked token fails with "The refresh token in
+Env no longer works; replace that Env value." The refresh token must come from
+the same client as `registrationRef`; non-JSKIT apps read the variable directly.
+
 ## Twitch composition
 
 Use `twitchProvider` from `@jskit-ai/connectors-catalog/server/twitch` in the

package/node_modules/@jskit-ai/connectors-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/connectors-core",
-  "version": "0.1.61",
+  "version": "0.1.62",
   "type": "module",
   "exports": {
     "./shared/configuration": "./src/shared/configuration.js",

package/node_modules/@jskit-ai/http-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/http-runtime",
-  "version": "0.1.242",
+  "version": "0.1.243",
   "type": "module",
   "exports": {
     "./client": "./src/client/index.js",

package/node_modules/@jskit-ai/kernel/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/kernel",
-  "version": "0.1.244",
+  "version": "0.1.245",
   "type": "module",
   "exports": {
     "./_testable": "./_testable/index.js",

package/node_modules/@jskit-ai/realtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/realtime",
-  "version": "0.1.242",
+  "version": "0.1.244",
   "type": "module",
   "exports": {
     "./server/RealtimeProvider": "./src/server/RealtimeProvider.js",

package/node_modules/@jskit-ai/resource-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/resource-core",
-  "version": "0.1.186",
+  "version": "0.1.187",
   "type": "module",
   "exports": {
     "./shared/resource": "./src/shared/resource.js"

package/node_modules/@jskit-ai/resource-crud-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/resource-crud-core",
-  "version": "0.1.186",
+  "version": "0.1.187",
   "type": "module",
   "exports": {
     "./shared/crudFieldContract": "./src/shared/crudFieldContract.js",

package/node_modules/@jskit-ai/uploads-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/uploads-runtime",
-  "version": "0.1.219",
+  "version": "0.1.220",
   "type": "module",
   "exports": {
     "./client": "./src/client/index.js",

package/node_modules/@local/vibe64-accounts/package.json

@@ -19,6 +19,7 @@
     "./server/completedDiscussionPlanUpgrade": "./src/server/completedDiscussionPlanUpgrade.js",
     "./server/providerCredentialsUpgrade": "./src/server/providerCredentialsUpgrade.js",
     "./server/freeModelRetirementUpgrade": "./src/server/freeModelRetirementUpgrade.js",
-    "./server/assistantPlanUpgrade": "./src/server/assistantPlanUpgrade.js"
+    "./server/assistantPlanUpgrade": "./src/server/assistantPlanUpgrade.js",
+    "./server/teamSetupRoutingUpgrade": "./src/server/teamSetupRoutingUpgrade.js"
   }
 }

package/node_modules/@local/vibe64-core/package.json

@@ -46,9 +46,12 @@
     "./server/envUserValues": "./src/server/envUserValues.js",
     "./shared": "./src/shared/index.js",
     "./server/assistantRoutingStore": "./src/server/assistantRoutingStore.js",
+    "./server/workspaceTeam": "./src/server/workspaceTeam.js",
+    "./server/teamAiGate": "./src/server/teamAiGate.js",
     "./shared/curatedCodexProviders": "./src/shared/curatedCodexProviders.js",
     "./server/codexProviderConnections": "./src/server/codexProviderConnections.js",
     "./server/stateUpgrades/routingV2Format": "./src/server/stateUpgrades/routingV2Format.js",
-    "./server/stateUpgrades/routingV3Format": "./src/server/stateUpgrades/routingV3Format.js"
+    "./server/stateUpgrades/routingV3Format": "./src/server/stateUpgrades/routingV3Format.js",
+    "./server/stateUpgrades/routingV4Format": "./src/server/stateUpgrades/routingV4Format.js"
   }
 }