@lssm/example.learning-patterns 0.0.0-canary-20251217080011 → 1.41.0

package/.turbo/turbo-build.log

@@ -1,52 +1,50 @@
-
-$ bun build:bundle && bun build:types
-$ tsdown
-ℹ tsdown v0.17.4 powered by rolldown v1.0.0-beta.53
-ℹ config file: /Users/tboutron/Documents/clients/lssm/monorepo-lssm/packages/contractspec/packages/examples/learning-patterns/tsdown.config.js (unrun)
-ℹ entry: src/events.ts, src/example.ts, src/index.ts, src/docs/index.ts, src/docs/learning-patterns.docblock.ts, src/tracks/ambient-coach.ts, src/tracks/drills.ts, src/tracks/index.ts, src/tracks/quests.ts
-ℹ target: esnext
-ℹ tsconfig: tsconfig.json
-ℹ Build start
-ℹ Cleaning 53 files
-ℹ dist/docs/learning-patterns.docblock.js                                        0.98 kB │ gzip: 0.51 kB
-ℹ dist/tracks/drills.js                                                          0.85 kB │ gzip: 0.49 kB
-ℹ dist/tracks/quests.js                                                          0.74 kB │ gzip: 0.39 kB
-ℹ dist/tracks/ambient-coach.js                                                   0.71 kB │ gzip: 0.39 kB
-ℹ dist/index.js                                                                  0.50 kB │ gzip: 0.22 kB
-ℹ dist/example.js                                                                0.49 kB │ gzip: 0.31 kB
-ℹ dist/events.js                                                                 0.42 kB │ gzip: 0.25 kB
-ℹ dist/tracks/index.js                                                           0.32 kB │ gzip: 0.15 kB
-ℹ dist/docs/index.js                                                             0.04 kB │ gzip: 0.06 kB
-ℹ dist/libs/contracts/src/docs/accessibility_wcag_compliance_specs.docblock.js  16.53 kB │ gzip: 7.16 kB
-ℹ dist/libs/contracts/src/docs/tech/schema/README.docblock.js                   10.99 kB │ gzip: 4.29 kB
-ℹ dist/libs/contracts/src/docs/tech/lifecycle-stage-system.docblock.js           9.67 kB │ gzip: 3.78 kB
-ℹ dist/libs/contracts/src/docs/tech/llm/llm-integration.docblock.js              9.12 kB │ gzip: 3.42 kB
-ℹ dist/libs/contracts/src/docs/tech/PHASE_1_QUICKSTART.docblock.js               8.76 kB │ gzip: 2.68 kB
-ℹ dist/libs/contracts/src/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.js           5.93 kB │ gzip: 2.61 kB
-ℹ dist/libs/contracts/src/docs/tech/templates/runtime.docblock.js                5.63 kB │ gzip: 2.58 kB
-ℹ dist/libs/contracts/src/docs/tech/workflows/overview.docblock.js               5.44 kB │ gzip: 2.26 kB
-ℹ dist/libs/contracts/src/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js    4.37 kB │ gzip: 2.06 kB
-ℹ dist/libs/contracts/src/docs/tech/telemetry-ingest.docblock.js                 3.90 kB │ gzip: 1.70 kB
-ℹ dist/libs/contracts/src/docs/tech/vscode-extension.docblock.js                 3.60 kB │ gzip: 1.39 kB
-ℹ dist/libs/contracts/src/docs/PUBLISHING.docblock.js                            3.43 kB │ gzip: 1.59 kB
-ℹ dist/libs/contracts/src/docs/tech/auth/better-auth-nextjs.docblock.js          3.35 kB │ gzip: 1.45 kB
-ℹ dist/libs/contracts/src/docs/tech/studio/learning-journeys.docblock.js         3.08 kB │ gzip: 1.39 kB
-ℹ dist/libs/contracts/src/docs/tech/studio/platform-admin-panel.docblock.js      3.04 kB │ gzip: 1.33 kB
-ℹ dist/libs/contracts/src/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js     3.00 kB │ gzip: 1.53 kB
-ℹ dist/libs/contracts/src/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js   2.83 kB │ gzip: 1.41 kB
-ℹ dist/libs/contracts/src/docs/tech/presentation-runtime.docblock.js             2.75 kB │ gzip: 1.30 kB
-ℹ dist/libs/contracts/src/docs/tech/studio/project-routing.docblock.js           2.50 kB │ gzip: 1.12 kB
-ℹ dist/libs/contracts/src/docs/tech/studio/team-invitations.docblock.js          2.14 kB │ gzip: 1.04 kB
-ℹ dist/libs/contracts/src/docs/tech/studio/workspaces.docblock.js                1.90 kB │ gzip: 0.94 kB
-ℹ dist/libs/contracts/src/docs/tech/studio/learning-events.docblock.js           1.79 kB │ gzip: 0.88 kB
-ℹ dist/libs/contracts/src/docs/tech/contracts/openapi-export.docblock.js         1.72 kB │ gzip: 0.90 kB
-ℹ dist/libs/contracts/src/docs/tech/studio/project-access-teams.docblock.js      1.58 kB │ gzip: 0.78 kB
-ℹ dist/libs/contracts/src/docs/index.js                                          1.54 kB │ gzip: 0.52 kB
-ℹ dist/libs/contracts/src/docs/tech/studio/workspace-ops.docblock.js             1.49 kB │ gzip: 0.73 kB
-ℹ dist/libs/contracts/src/docs/tech/mcp-endpoints.docblock.js                    1.24 kB │ gzip: 0.68 kB
-ℹ dist/libs/contracts/src/docs/presentations.js                                  1.23 kB │ gzip: 0.59 kB
-ℹ dist/libs/contracts/src/docs/tech/studio/sandbox-unlogged.docblock.js          0.90 kB │ gzip: 0.56 kB
-ℹ dist/libs/contracts/src/docs/registry.js                                       0.74 kB │ gzip: 0.42 kB
-ℹ 39 files, total: 129.28 kB
-✔ Build complete in 153ms
-$ tsc --noEmit
+$ bun build:bundle && bun build:types
+$ tsdown
+ℹ tsdown v0.17.4 powered by rolldown v1.0.0-beta.53
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/learning-patterns/tsdown.config.js 
+ℹ entry: src/events.ts, src/example.ts, src/index.ts, src/docs/index.ts, src/docs/learning-patterns.docblock.ts, src/tracks/ambient-coach.ts, src/tracks/drills.ts, src/tracks/index.ts, src/tracks/quests.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ dist/docs/learning-patterns.docblock.js                                        0.98 kB │ gzip: 0.51 kB
+ℹ dist/tracks/drills.js                                                          0.85 kB │ gzip: 0.49 kB
+ℹ dist/tracks/quests.js                                                          0.74 kB │ gzip: 0.39 kB
+ℹ dist/tracks/ambient-coach.js                                                   0.71 kB │ gzip: 0.39 kB
+ℹ dist/index.js                                                                  0.50 kB │ gzip: 0.22 kB
+ℹ dist/example.js                                                                0.49 kB │ gzip: 0.31 kB
+ℹ dist/events.js                                                                 0.42 kB │ gzip: 0.25 kB
+ℹ dist/tracks/index.js                                                           0.32 kB │ gzip: 0.15 kB
+ℹ dist/docs/index.js                                                             0.04 kB │ gzip: 0.06 kB
+ℹ dist/libs/contracts/src/docs/accessibility_wcag_compliance_specs.docblock.js  16.53 kB │ gzip: 7.16 kB
+ℹ dist/libs/contracts/src/docs/tech/schema/README.docblock.js                   10.99 kB │ gzip: 4.29 kB
+ℹ dist/libs/contracts/src/docs/tech/lifecycle-stage-system.docblock.js           9.67 kB │ gzip: 3.78 kB
+ℹ dist/libs/contracts/src/docs/tech/llm/llm-integration.docblock.js              9.12 kB │ gzip: 3.42 kB
+ℹ dist/libs/contracts/src/docs/tech/PHASE_1_QUICKSTART.docblock.js               8.76 kB │ gzip: 2.68 kB
+ℹ dist/libs/contracts/src/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.js           5.93 kB │ gzip: 2.61 kB
+ℹ dist/libs/contracts/src/docs/tech/templates/runtime.docblock.js                5.63 kB │ gzip: 2.58 kB
+ℹ dist/libs/contracts/src/docs/tech/workflows/overview.docblock.js               5.44 kB │ gzip: 2.26 kB
+ℹ dist/libs/contracts/src/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js    4.37 kB │ gzip: 2.06 kB
+ℹ dist/libs/contracts/src/docs/tech/telemetry-ingest.docblock.js                 3.90 kB │ gzip: 1.70 kB
+ℹ dist/libs/contracts/src/docs/tech/vscode-extension.docblock.js                 3.60 kB │ gzip: 1.39 kB
+ℹ dist/libs/contracts/src/docs/PUBLISHING.docblock.js                            3.43 kB │ gzip: 1.59 kB
+ℹ dist/libs/contracts/src/docs/tech/auth/better-auth-nextjs.docblock.js          3.35 kB │ gzip: 1.45 kB
+ℹ dist/libs/contracts/src/docs/tech/studio/learning-journeys.docblock.js         3.08 kB │ gzip: 1.39 kB
+ℹ dist/libs/contracts/src/docs/tech/studio/platform-admin-panel.docblock.js      3.04 kB │ gzip: 1.33 kB
+ℹ dist/libs/contracts/src/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js     3.00 kB │ gzip: 1.53 kB
+ℹ dist/libs/contracts/src/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js   2.83 kB │ gzip: 1.41 kB
+ℹ dist/libs/contracts/src/docs/tech/presentation-runtime.docblock.js             2.75 kB │ gzip: 1.30 kB
+ℹ dist/libs/contracts/src/docs/tech/studio/project-routing.docblock.js           2.50 kB │ gzip: 1.12 kB
+ℹ dist/libs/contracts/src/docs/tech/studio/team-invitations.docblock.js          2.14 kB │ gzip: 1.04 kB
+ℹ dist/libs/contracts/src/docs/tech/studio/workspaces.docblock.js                1.90 kB │ gzip: 0.94 kB
+ℹ dist/libs/contracts/src/docs/tech/studio/learning-events.docblock.js           1.79 kB │ gzip: 0.88 kB
+ℹ dist/libs/contracts/src/docs/tech/contracts/openapi-export.docblock.js         1.72 kB │ gzip: 0.90 kB
+ℹ dist/libs/contracts/src/docs/tech/studio/project-access-teams.docblock.js      1.58 kB │ gzip: 0.78 kB
+ℹ dist/libs/contracts/src/docs/index.js                                          1.54 kB │ gzip: 0.52 kB
+ℹ dist/libs/contracts/src/docs/tech/studio/workspace-ops.docblock.js             1.49 kB │ gzip: 0.73 kB
+ℹ dist/libs/contracts/src/docs/tech/mcp-endpoints.docblock.js                    1.24 kB │ gzip: 0.68 kB
+ℹ dist/libs/contracts/src/docs/presentations.js                                  1.23 kB │ gzip: 0.59 kB
+ℹ dist/libs/contracts/src/docs/tech/studio/sandbox-unlogged.docblock.js          0.90 kB │ gzip: 0.56 kB
+ℹ dist/libs/contracts/src/docs/registry.js                                       0.74 kB │ gzip: 0.42 kB
+ℹ 39 files, total: 129.28 kB
+✔ Build complete in 99ms
+$ tsc --noEmit

package/dist/docs/index.js

@@ -1 +1 @@
-import "./learning-patterns.docblock.js";
+import"./learning-patterns.docblock.js";

package/dist/docs/learning-patterns.docblock.js

@@ -1,31 +1,12 @@
-import { registerDocBlocks } from "../libs/contracts/dist/docs/registry.js";
-import "../libs/contracts/dist/docs/index.js";
+import{registerDocBlocks as e}from"../libs/contracts/src/docs/registry.js";import"../libs/contracts/src/docs/index.js";e([{id:`docs.examples.learning-patterns.goal`,title:`Learning Patterns — Goal`,summary:`Domain-agnostic drills, ambient coaching, and quests built on Learning Journey.`,kind:`goal`,visibility:`public`,route:`/docs/examples/learning-patterns/goal`,tags:[`learning`,`drills`,`quests`,`coaching`],body:`## Why it matters
+- Demonstrates multiple learning archetypes without vertical coupling.
+- Progress is event-driven (no client-side hacks).
+- SRS logic is deterministic and testable.`},{id:`docs.examples.learning-patterns.reference`,title:`Learning Patterns — Reference`,summary:`Track specs and event names exported by the learning patterns example.`,kind:`reference`,visibility:`public`,route:`/docs/examples/learning-patterns`,tags:[`learning`,`reference`],body:`## Tracks
+- Drills + SRS
+- Ambient Coach
+- Quests
 
-//#region src/docs/learning-patterns.docblock.ts
-registerDocBlocks([{
-	id: "docs.examples.learning-patterns.goal",
-	title: "Learning Patterns — Goal",
-	summary: "Domain-agnostic drills, ambient coaching, and quests built on Learning Journey.",
-	kind: "goal",
-	visibility: "public",
-	route: "/docs/examples/learning-patterns/goal",
-	tags: [
-		"learning",
-		"drills",
-		"quests",
-		"coaching"
-	],
-	body: `## Why it matters
-- Demonstrates multiple learning archetypes without vertical coupling.\n- Progress is event-driven (no client-side hacks).\n- SRS logic is deterministic and testable.`
-}, {
-	id: "docs.examples.learning-patterns.reference",
-	title: "Learning Patterns — Reference",
-	summary: "Track specs and event names exported by the learning patterns example.",
-	kind: "reference",
-	visibility: "public",
-	route: "/docs/examples/learning-patterns",
-	tags: ["learning", "reference"],
-	body: `## Tracks\n- Drills + SRS\n- Ambient Coach\n- Quests\n\n## Events\n- drill.*\n- coach.*\n- quest.*`
-}]);
-
-//#endregion
+## Events
+- drill.*
+- coach.*
+- quest.*`}]);

package/dist/events.js

@@ -1,15 +1 @@
-//#region src/events.ts
-const LEARNING_EVENTS = {
-	DRILL_CARD_ANSWERED: "drill.card.answered",
-	DRILL_SESSION_COMPLETED: "drill.session.completed",
-	DRILL_CARD_MASTERED: "drill.card.mastered",
-	COACH_TIP_TRIGGERED: "coach.tip.triggered",
-	COACH_TIP_SHOWN: "coach.tip.shown",
-	COACH_TIP_ACKNOWLEDGED: "coach.tip.acknowledged",
-	COACH_TIP_ACTION_TAKEN: "coach.tip.actionTaken",
-	QUEST_STARTED: "quest.started",
-	QUEST_STEP_COMPLETED: "quest.step.completed"
-};
-
-//#endregion
-export { LEARNING_EVENTS };
+const e={DRILL_CARD_ANSWERED:`drill.card.answered`,DRILL_SESSION_COMPLETED:`drill.session.completed`,DRILL_CARD_MASTERED:`drill.card.mastered`,COACH_TIP_TRIGGERED:`coach.tip.triggered`,COACH_TIP_SHOWN:`coach.tip.shown`,COACH_TIP_ACKNOWLEDGED:`coach.tip.acknowledged`,COACH_TIP_ACTION_TAKEN:`coach.tip.actionTaken`,QUEST_STARTED:`quest.started`,QUEST_STEP_COMPLETED:`quest.step.completed`};export{e as LEARNING_EVENTS};

package/dist/example.js

@@ -1,34 +1 @@
-//#region src/example.ts
-const example = {
-	id: "learning-patterns",
-	title: "Learning Patterns",
-	summary: "Domain-agnostic learning archetypes implemented as Learning Journey tracks.",
-	tags: [
-		"learning",
-		"journey",
-		"patterns"
-	],
-	kind: "library",
-	visibility: "public",
-	docs: { rootDocId: "docs.examples.learning-patterns" },
-	entrypoints: {
-		packageName: "@lssm/example.learning-patterns",
-		docs: "./docs"
-	},
-	surfaces: {
-		templates: true,
-		sandbox: {
-			enabled: true,
-			modes: ["markdown", "specs"]
-		},
-		studio: {
-			enabled: true,
-			installable: true
-		},
-		mcp: { enabled: true }
-	}
-};
-var example_default = example;
-
-//#endregion
-export { example_default as default };
+var e={id:`learning-patterns`,title:`Learning Patterns`,summary:`Domain-agnostic learning archetypes implemented as Learning Journey tracks.`,tags:[`learning`,`journey`,`patterns`],kind:`library`,visibility:`public`,docs:{rootDocId:`docs.examples.learning-patterns`},entrypoints:{packageName:`@lssm/example.learning-patterns`,docs:`./docs`},surfaces:{templates:!0,sandbox:{enabled:!0,modes:[`markdown`,`specs`]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}};export{e as default};

package/dist/index.js

@@ -1,9 +1 @@
-import { LEARNING_EVENTS } from "./events.js";
-import example_default from "./example.js";
-import { drillTracks, drillsTrack } from "./tracks/drills.js";
-import { ambientCoachTrack, ambientCoachTracks } from "./tracks/ambient-coach.js";
-import { questTrack, questTracks } from "./tracks/quests.js";
-import "./tracks/index.js";
-import "./docs/index.js";
-
-export { LEARNING_EVENTS, ambientCoachTrack, ambientCoachTracks, drillTracks, drillsTrack, example_default as example, questTrack, questTracks };
+import{LEARNING_EVENTS as e}from"./events.js";import t from"./example.js";import{drillTracks as n,drillsTrack as r}from"./tracks/drills.js";import{ambientCoachTrack as i,ambientCoachTracks as a}from"./tracks/ambient-coach.js";import{questTrack as o,questTracks as s}from"./tracks/quests.js";import"./tracks/index.js";import"./docs/index.js";export{e as LEARNING_EVENTS,i as ambientCoachTrack,a as ambientCoachTracks,n as drillTracks,r as drillsTrack,t as example,o as questTrack,s as questTracks};

package/dist/libs/contracts/src/docs/PUBLISHING.docblock.js

@@ -0,0 +1,76 @@
+import{registerDocBlocks as e}from"./registry.js";e([{id:`docs.PUBLISHING`,title:`Publishing ContractSpec Libraries`,summary:`This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).`,kind:`reference`,visibility:`public`,route:`/docs/PUBLISHING`,tags:[`PUBLISHING`],body:`# Publishing ContractSpec Libraries
+
+This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).
+
+## Release Tracks
+
+| Track | Branch | npm Tag | Frequency | Versioning | Use Case |
+|-------|--------|---------|-----------|------------|----------|
+| **Stable** | \`release\` | \`latest\` | Manual | SemVer (e.g., \`1.7.4\`) | Production, external users |
+| **Canary** | \`main\` | \`canary\` | Every Push | Snapshot (e.g., \`1.7.4-canary...\`) | Dev, internal testing |
+
+## Prerequisites
+
+- ✅ \`NPM_TOKEN\` secret is configured in GitHub (owner or automation token with _publish_ scope).
+- ✅ \`GITHUB_TOKEN\` (built-in) has permissions to create PRs (enabled by default in new repos).
+- ✅ For stable releases: \`release\` branch exists and is protected.
+
+## Canary Workflow (Automatic)
+
+Every commit pushed to \`main\` triggers the \`.github/workflows/publish-canary.yml\` workflow.
+
+1. **Trigger**: Push to \`main\`.
+2. **Versioning**: Runs \`changeset version --snapshot canary\` to generate a temporary snapshot version.
+3. **Publish**: Packages are published to npm with the \`canary\` tag using \`changeset publish --tag canary\`.
+
+### Consuming Canary Builds
+
+To install the latest bleeding-edge version:
+
+\`\`\`bash
+npm install @lssm/lib.contracts@canary
+# or
+bun add @lssm/lib.contracts@canary
+\`\`\`
+
+## Stable Release Workflow (Manual)
+
+Stable releases are managed via the \`release\` branch using the standard [Changesets Action](https://github.com/changesets/action).
+
+1. **Develop on \`main\`**: Create features and fixes.
+2. **Add Changesets**: Run \`bun changeset\` to document changes and impact (major/minor/patch).
+3. **Merge to \`release\`**: When ready to ship, open a PR from \`main\` to \`release\` or merge manually.
+4. **"Version Packages" PR**:
+   - The GitHub Action detects new changesets and automatically creates a Pull Request titled **"Version Packages"**.
+   - This PR contains the version bumps and updated \`CHANGELOG.md\` files.
+5. **Merge & Publish**:
+   - Review and merge the "Version Packages" PR.
+   - The Action runs again, detects the versions have been bumped, builds the libraries, and publishes them to npm with the \`latest\` tag.
+
+### Publishing Steps
+
+1. Ensure all changesets are present on \`main\`.
+2. Merge \`main\` into \`release\`:
+   \`\`\`bash
+   git checkout release
+   git pull origin release
+   git merge main
+   git push origin release
+   \`\`\`
+3. Go to GitHub Pull Requests. You will see a **"Version Packages"** PR created by the bot.
+4. Merge that PR.
+5. The release is now live on npm!
+
+## Manual Verification (Optional)
+
+Before publishing a new version you can run:
+
+\`\`\`bash
+bun run build:not-apps
+npx npm-packlist --json packages/libs/contracts
+\`\`\`
+
+## Rollback
+
+If a publish fails mid-way, re-run the workflow once the issue is fixed. Already published packages are skipped automatically. Use \`npm deprecate <package>@<version>\` if we need to warn consumers about a broken release.
+`}]);