@lssm/example.ai-support-bot 0.0.0-canary-20251217062139 → 0.0.0-canary-20251217072406
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/.turbo/turbo-build$colon$bundle.log +73 -69
- package/.turbo/turbo-build.log +74 -18
- package/CHANGELOG.md +6 -5
- package/dist/docs/ai-support-bot.docblock.js +27 -12
- package/dist/docs/index.js +1 -1
- package/dist/example.js +38 -1
- package/dist/index.js +5 -1
- package/dist/libs/contracts/dist/docs/PUBLISHING.docblock.js +16 -76
- package/dist/libs/contracts/dist/docs/accessibility_wcag_compliance_specs.docblock.js +16 -350
- package/dist/libs/contracts/dist/docs/index.js +29 -1
- package/dist/libs/contracts/dist/docs/presentations.js +71 -1
- package/dist/libs/contracts/dist/docs/registry.js +44 -1
- package/dist/libs/contracts/dist/docs/tech/PHASE_1_QUICKSTART.docblock.js +16 -383
- package/dist/libs/contracts/dist/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js +16 -68
- package/dist/libs/contracts/dist/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.js +16 -140
- package/dist/libs/contracts/dist/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js +16 -86
- package/dist/libs/contracts/dist/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js +16 -1
- package/dist/libs/contracts/dist/docs/tech/auth/better-auth-nextjs.docblock.js +24 -2
- package/dist/libs/contracts/dist/docs/tech/contracts/openapi-export.docblock.js +21 -2
- package/dist/libs/contracts/dist/docs/tech/lifecycle-stage-system.docblock.js +16 -213
- package/dist/libs/contracts/dist/docs/tech/llm/llm-integration.docblock.js +73 -5
- package/dist/libs/contracts/dist/docs/tech/mcp-endpoints.docblock.js +37 -1
- package/dist/libs/contracts/dist/docs/tech/presentation-runtime.docblock.js +16 -1
- package/dist/libs/contracts/dist/docs/tech/schema/README.docblock.js +20 -262
- package/dist/libs/contracts/dist/docs/tech/studio/learning-events.docblock.js +48 -1
- package/dist/libs/contracts/dist/docs/tech/studio/learning-journeys.docblock.js +24 -2
- package/dist/libs/contracts/dist/docs/tech/studio/platform-admin-panel.docblock.js +23 -2
- package/dist/libs/contracts/dist/docs/tech/studio/project-access-teams.docblock.js +25 -16
- package/dist/libs/contracts/dist/docs/tech/studio/project-routing.docblock.js +67 -1
- package/dist/libs/contracts/dist/docs/tech/studio/sandbox-unlogged.docblock.js +22 -2
- package/dist/libs/contracts/dist/docs/tech/studio/team-invitations.docblock.js +40 -36
- package/dist/libs/contracts/dist/docs/tech/studio/workspace-ops.docblock.js +47 -1
- package/dist/libs/contracts/dist/docs/tech/studio/workspaces.docblock.js +23 -2
- package/dist/libs/contracts/dist/docs/tech/telemetry-ingest.docblock.js +36 -3
- package/dist/libs/contracts/dist/docs/tech/templates/runtime.docblock.js +20 -1
- package/dist/libs/contracts/dist/docs/tech/vscode-extension.docblock.js +36 -3
- package/dist/libs/contracts/dist/docs/tech/workflows/overview.docblock.js +20 -1
- package/dist/libs/logger/dist/context.node.js +78 -1
- package/dist/libs/logger/dist/elysia-plugin.js +3 -1
- package/dist/libs/logger/dist/formatters.js +163 -9
- package/dist/libs/logger/dist/index.js +7 -1
- package/dist/libs/logger/dist/logger.node.js +189 -1
- package/dist/libs/logger/dist/timer.js +126 -1
- package/dist/libs/logger/dist/tracer.node.js +115 -1
- package/dist/libs/logger/dist/types.js +13 -1
- package/dist/libs/support-bot/dist/bot/auto-responder.js +77 -12
- package/dist/libs/support-bot/dist/bot/index.js +2 -1
- package/dist/libs/support-bot/dist/bot/tools.js +71 -1
- package/dist/libs/support-bot/dist/rag/ticket-resolver.js +63 -3
- package/dist/libs/support-bot/dist/tickets/classifier.js +198 -1
- package/dist/setup.js +47 -1
- package/package.json +8 -7
- package/tsconfig.tsbuildinfo +1 -1
|
@@ -1,69 +1,73 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
[34mℹ[39m
|
|
4
|
-
[34mℹ[39m
|
|
5
|
-
[34mℹ[39m
|
|
6
|
-
[34mℹ[39m
|
|
7
|
-
[34mℹ[39m
|
|
8
|
-
[34mℹ[39m
|
|
9
|
-
[34mℹ[39m
|
|
10
|
-
[34mℹ[39m [2mdist/[22m[1mdocs/ai-support-bot.docblock.js[22m [2m 1.
|
|
11
|
-
[34mℹ[39m [2mdist/[22m[
|
|
12
|
-
[34mℹ[39m [2mdist/[22m[
|
|
13
|
-
[34mℹ[39m [2mdist/[22m[
|
|
14
|
-
[34mℹ[39m [2mdist/[
|
|
15
|
-
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/
|
|
16
|
-
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/
|
|
17
|
-
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/
|
|
18
|
-
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/
|
|
19
|
-
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/
|
|
20
|
-
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/
|
|
21
|
-
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/
|
|
22
|
-
[34mℹ[39m [2mdist/[22mlibs/
|
|
23
|
-
[34mℹ[39m [2mdist/[22mlibs/
|
|
24
|
-
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/
|
|
25
|
-
[34mℹ[39m [2mdist/[22mlibs/
|
|
26
|
-
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/
|
|
27
|
-
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/
|
|
28
|
-
[34mℹ[39m [2mdist/[22mlibs/
|
|
29
|
-
[34mℹ[39m [2mdist/[22mlibs/
|
|
30
|
-
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/studio/learning-journeys.docblock.js [2m 3.
|
|
31
|
-
[34mℹ[39m [2mdist/[22mlibs/
|
|
32
|
-
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/
|
|
33
|
-
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/
|
|
34
|
-
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/
|
|
35
|
-
[34mℹ[39m [2mdist/[22mlibs/
|
|
36
|
-
[34mℹ[39m [2mdist/[22mlibs/
|
|
37
|
-
[34mℹ[39m [2mdist/[22mlibs/
|
|
38
|
-
[34mℹ[39m [2mdist/[22mlibs/
|
|
39
|
-
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/studio/
|
|
40
|
-
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/
|
|
41
|
-
[34mℹ[39m [2mdist/[22mlibs/
|
|
42
|
-
[34mℹ[39m [2mdist/[22mlibs/
|
|
43
|
-
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/studio/
|
|
44
|
-
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/
|
|
45
|
-
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/
|
|
46
|
-
[34mℹ[39m [2mdist/[22mlibs/
|
|
47
|
-
[34mℹ[39m [2mdist/[22mlibs/logger/dist/
|
|
48
|
-
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/
|
|
49
|
-
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/
|
|
50
|
-
[34mℹ[39m [2mdist/[22mlibs/support-bot/dist/bot/tools.js [2m 1.
|
|
51
|
-
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/
|
|
52
|
-
[34mℹ[39m [2mdist/[22mlibs/
|
|
53
|
-
[34mℹ[39m [2mdist/[22mlibs/
|
|
54
|
-
[34mℹ[39m [2mdist/[22mlibs/logger/dist/index.js [2m 0.
|
|
55
|
-
[34mℹ[39m [2mdist/[22mlibs/
|
|
56
|
-
[34mℹ[39m [2mdist/[22mlibs/logger/dist/elysia-plugin.js [2m 0.07 kB[22m [2m│ gzip: 0.07 kB[22m
|
|
57
|
-
[34mℹ[39m [2mdist/[
|
|
58
|
-
[34mℹ[39m [2mdist/[22m[32m[
|
|
59
|
-
[34mℹ[39m [2mdist/[22m[32m[
|
|
60
|
-
[34mℹ[39m [2mdist/[22m[32m[
|
|
61
|
-
[34mℹ[39m [2mdist/[22m[32m[1mdocs/
|
|
62
|
-
[34mℹ[39m
|
|
63
|
-
[
|
|
64
|
-
[
|
|
65
|
-
|
|
66
|
-
[38;5;
|
|
67
|
-
[38;5;240m
|
|
68
|
-
|
|
69
|
-
[
|
|
1
|
+
$ tsdown
|
|
2
|
+
[34mℹ[39m tsdown [2mv0.17.4[22m powered by rolldown [2mv1.0.0-beta.53[22m
|
|
3
|
+
[34mℹ[39m config file: [4m/home/runner/work/contractspec/contractspec/packages/examples/ai-support-bot/tsdown.config.js[24m
|
|
4
|
+
[34mℹ[39m entry: [34msrc/example.ts, src/index.ts, src/setup.ts, src/docs/ai-support-bot.docblock.ts, src/docs/index.ts[39m
|
|
5
|
+
[34mℹ[39m target: [34mesnext[39m
|
|
6
|
+
[34mℹ[39m tsconfig: [34mtsconfig.json[39m
|
|
7
|
+
[34mℹ[39m Build start
|
|
8
|
+
[34mℹ[39m Cleaning 73 files
|
|
9
|
+
[34mℹ[39m [2mdist/[22m[1msetup.js[22m [2m 1.67 kB[22m [2m│ gzip: 0.76 kB[22m
|
|
10
|
+
[34mℹ[39m [2mdist/[22m[1mdocs/ai-support-bot.docblock.js[22m [2m 1.35 kB[22m [2m│ gzip: 0.65 kB[22m
|
|
11
|
+
[34mℹ[39m [2mdist/[22m[1mexample.js[22m [2m 0.77 kB[22m [2m│ gzip: 0.41 kB[22m
|
|
12
|
+
[34mℹ[39m [2mdist/[22m[1mindex.js[22m [2m 0.19 kB[22m [2m│ gzip: 0.12 kB[22m
|
|
13
|
+
[34mℹ[39m [2mdist/[22m[1mdocs/index.js[22m [2m 0.04 kB[22m [2m│ gzip: 0.06 kB[22m
|
|
14
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/accessibility_wcag_compliance_specs.docblock.js [2m16.91 kB[22m [2m│ gzip: 7.23 kB[22m
|
|
15
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/schema/README.docblock.js [2m11.21 kB[22m [2m│ gzip: 4.33 kB[22m
|
|
16
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/lifecycle-stage-system.docblock.js [2m 9.96 kB[22m [2m│ gzip: 3.83 kB[22m
|
|
17
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/llm/llm-integration.docblock.js [2m 9.53 kB[22m [2m│ gzip: 3.50 kB[22m
|
|
18
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/PHASE_1_QUICKSTART.docblock.js [2m 9.22 kB[22m [2m│ gzip: 2.77 kB[22m
|
|
19
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.js [2m 6.16 kB[22m [2m│ gzip: 2.65 kB[22m
|
|
20
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/templates/runtime.docblock.js [2m 5.85 kB[22m [2m│ gzip: 2.66 kB[22m
|
|
21
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/workflows/overview.docblock.js [2m 5.66 kB[22m [2m│ gzip: 2.34 kB[22m
|
|
22
|
+
[34mℹ[39m [2mdist/[22mlibs/logger/dist/formatters.js [2m 5.42 kB[22m [2m│ gzip: 1.71 kB[22m
|
|
23
|
+
[34mℹ[39m [2mdist/[22mlibs/logger/dist/logger.node.js [2m 5.40 kB[22m [2m│ gzip: 1.66 kB[22m
|
|
24
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js [2m 4.62 kB[22m [2m│ gzip: 2.13 kB[22m
|
|
25
|
+
[34mℹ[39m [2mdist/[22mlibs/support-bot/dist/tickets/classifier.js [2m 4.17 kB[22m [2m│ gzip: 1.57 kB[22m
|
|
26
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/telemetry-ingest.docblock.js [2m 4.16 kB[22m [2m│ gzip: 1.78 kB[22m
|
|
27
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/vscode-extension.docblock.js [2m 3.85 kB[22m [2m│ gzip: 1.47 kB[22m
|
|
28
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/PUBLISHING.docblock.js [2m 3.62 kB[22m [2m│ gzip: 1.65 kB[22m
|
|
29
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/auth/better-auth-nextjs.docblock.js [2m 3.60 kB[22m [2m│ gzip: 1.53 kB[22m
|
|
30
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/studio/learning-journeys.docblock.js [2m 3.33 kB[22m [2m│ gzip: 1.47 kB[22m
|
|
31
|
+
[34mℹ[39m [2mdist/[22mlibs/support-bot/dist/bot/auto-responder.js [2m 3.33 kB[22m [2m│ gzip: 1.36 kB[22m
|
|
32
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/studio/platform-admin-panel.docblock.js [2m 3.30 kB[22m [2m│ gzip: 1.42 kB[22m
|
|
33
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js [2m 3.25 kB[22m [2m│ gzip: 1.59 kB[22m
|
|
34
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js [2m 3.13 kB[22m [2m│ gzip: 1.47 kB[22m
|
|
35
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/presentation-runtime.docblock.js [2m 2.97 kB[22m [2m│ gzip: 1.38 kB[22m
|
|
36
|
+
[34mℹ[39m [2mdist/[22mlibs/logger/dist/tracer.node.js [2m 2.86 kB[22m [2m│ gzip: 1.01 kB[22m
|
|
37
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/studio/project-routing.docblock.js [2m 2.75 kB[22m [2m│ gzip: 1.22 kB[22m
|
|
38
|
+
[34mℹ[39m [2mdist/[22mlibs/logger/dist/timer.js [2m 2.43 kB[22m [2m│ gzip: 0.85 kB[22m
|
|
39
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/studio/team-invitations.docblock.js [2m 2.40 kB[22m [2m│ gzip: 1.13 kB[22m
|
|
40
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/presentations.js [2m 2.18 kB[22m [2m│ gzip: 0.77 kB[22m
|
|
41
|
+
[34mℹ[39m [2mdist/[22mlibs/support-bot/dist/rag/ticket-resolver.js [2m 2.17 kB[22m [2m│ gzip: 0.90 kB[22m
|
|
42
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/studio/workspaces.docblock.js [2m 2.13 kB[22m [2m│ gzip: 1.02 kB[22m
|
|
43
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/studio/learning-events.docblock.js [2m 2.04 kB[22m [2m│ gzip: 0.97 kB[22m
|
|
44
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/contracts/openapi-export.docblock.js [2m 1.96 kB[22m [2m│ gzip: 0.97 kB[22m
|
|
45
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/studio/project-access-teams.docblock.js [2m 1.85 kB[22m [2m│ gzip: 0.87 kB[22m
|
|
46
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/studio/workspace-ops.docblock.js [2m 1.73 kB[22m [2m│ gzip: 0.82 kB[22m
|
|
47
|
+
[34mℹ[39m [2mdist/[22mlibs/logger/dist/context.node.js [2m 1.63 kB[22m [2m│ gzip: 0.62 kB[22m
|
|
48
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/index.js [2m 1.58 kB[22m [2m│ gzip: 0.51 kB[22m
|
|
49
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/mcp-endpoints.docblock.js [2m 1.46 kB[22m [2m│ gzip: 0.77 kB[22m
|
|
50
|
+
[34mℹ[39m [2mdist/[22mlibs/support-bot/dist/bot/tools.js [2m 1.44 kB[22m [2m│ gzip: 0.54 kB[22m
|
|
51
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/registry.js [2m 1.25 kB[22m [2m│ gzip: 0.56 kB[22m
|
|
52
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/studio/sandbox-unlogged.docblock.js [2m 1.14 kB[22m [2m│ gzip: 0.65 kB[22m
|
|
53
|
+
[34mℹ[39m [2mdist/[22mlibs/logger/dist/types.js [2m 0.44 kB[22m [2m│ gzip: 0.23 kB[22m
|
|
54
|
+
[34mℹ[39m [2mdist/[22mlibs/logger/dist/index.js [2m 0.31 kB[22m [2m│ gzip: 0.16 kB[22m
|
|
55
|
+
[34mℹ[39m [2mdist/[22mlibs/support-bot/dist/bot/index.js [2m 0.07 kB[22m [2m│ gzip: 0.08 kB[22m
|
|
56
|
+
[34mℹ[39m [2mdist/[22mlibs/logger/dist/elysia-plugin.js [2m 0.07 kB[22m [2m│ gzip: 0.07 kB[22m
|
|
57
|
+
[34mℹ[39m [2mdist/[22m[32m[1mexample.d.ts[22m[39m [2m 1.01 kB[22m [2m│ gzip: 0.41 kB[22m
|
|
58
|
+
[34mℹ[39m [2mdist/[22m[32m[1mindex.d.ts[22m[39m [2m 0.13 kB[22m [2m│ gzip: 0.09 kB[22m
|
|
59
|
+
[34mℹ[39m [2mdist/[22m[32m[1msetup.d.ts[22m[39m [2m 0.13 kB[22m [2m│ gzip: 0.12 kB[22m
|
|
60
|
+
[34mℹ[39m [2mdist/[22m[32m[1mdocs/ai-support-bot.docblock.d.ts[22m[39m [2m 0.01 kB[22m [2m│ gzip: 0.03 kB[22m
|
|
61
|
+
[34mℹ[39m [2mdist/[22m[32m[1mdocs/index.d.ts[22m[39m [2m 0.01 kB[22m [2m│ gzip: 0.03 kB[22m
|
|
62
|
+
[34mℹ[39m 53 files, total: 167.85 kB
|
|
63
|
+
[33m[UNRESOLVED_IMPORT] Warning:[0m Could not resolve 'node:async_hooks' in ../../libs/logger/dist/context.node.mjs
|
|
64
|
+
[38;5;246m╭[0m[38;5;246m─[0m[38;5;246m[[0m ../../libs/logger/dist/context.node.mjs:1:35 [38;5;246m][0m
|
|
65
|
+
[38;5;246m│[0m
|
|
66
|
+
[38;5;246m1 │[0m [38;5;249mi[0m[38;5;249mm[0m[38;5;249mp[0m[38;5;249mo[0m[38;5;249mr[0m[38;5;249mt[0m[38;5;249m [0m[38;5;249m{[0m[38;5;249m [0m[38;5;249mA[0m[38;5;249ms[0m[38;5;249my[0m[38;5;249mn[0m[38;5;249mc[0m[38;5;249mL[0m[38;5;249mo[0m[38;5;249mc[0m[38;5;249ma[0m[38;5;249ml[0m[38;5;249mS[0m[38;5;249mt[0m[38;5;249mo[0m[38;5;249mr[0m[38;5;249ma[0m[38;5;249mg[0m[38;5;249me[0m[38;5;249m [0m[38;5;249m}[0m[38;5;249m [0m[38;5;249mf[0m[38;5;249mr[0m[38;5;249mo[0m[38;5;249mm[0m[38;5;249m [0m"node:async_hooks"[38;5;249m;[0m
|
|
67
|
+
[38;5;240m │[0m ─────────┬────────
|
|
68
|
+
[38;5;240m │[0m ╰────────── Module not found, treating it as an external dependency
|
|
69
|
+
[38;5;240m │[0m
|
|
70
|
+
[38;5;240m │[0m [38;5;115mHelp[0m: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
|
|
71
|
+
[38;5;246m───╯[0m
|
|
72
|
+
|
|
73
|
+
[32m✔[39m Build complete in [32m36516ms[39m
|
package/.turbo/turbo-build.log
CHANGED
|
@@ -1,18 +1,74 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
[
|
|
4
|
-
[34mℹ[39m
|
|
5
|
-
[34mℹ[39m
|
|
6
|
-
[34mℹ[39m
|
|
7
|
-
[34mℹ[39m
|
|
8
|
-
[34mℹ[39m
|
|
9
|
-
[34mℹ[39m
|
|
10
|
-
[34mℹ[39m
|
|
11
|
-
[34mℹ[39m [2mdist/[22m[
|
|
12
|
-
[34mℹ[39m [2mdist/[22m[
|
|
13
|
-
[34mℹ[39m [2mdist/[22m[
|
|
14
|
-
[34mℹ[39m [2mdist/[
|
|
15
|
-
[34mℹ[39m [2mdist/[
|
|
16
|
-
[34mℹ[39m
|
|
17
|
-
[
|
|
18
|
-
[
|
|
1
|
+
$ bun build:bundle && bun build:types
|
|
2
|
+
$ tsdown
|
|
3
|
+
[34mℹ[39m tsdown [2mv0.17.4[22m powered by rolldown [2mv1.0.0-beta.53[22m
|
|
4
|
+
[34mℹ[39m config file: [4m/home/runner/work/contractspec/contractspec/packages/examples/ai-support-bot/tsdown.config.js[24m
|
|
5
|
+
[34mℹ[39m entry: [34msrc/example.ts, src/index.ts, src/setup.ts, src/docs/ai-support-bot.docblock.ts, src/docs/index.ts[39m
|
|
6
|
+
[34mℹ[39m target: [34mesnext[39m
|
|
7
|
+
[34mℹ[39m tsconfig: [34mtsconfig.json[39m
|
|
8
|
+
[34mℹ[39m Build start
|
|
9
|
+
[34mℹ[39m [2mdist/[22m[1msetup.js[22m [2m 1.67 kB[22m [2m│ gzip: 0.76 kB[22m
|
|
10
|
+
[34mℹ[39m [2mdist/[22m[1mdocs/ai-support-bot.docblock.js[22m [2m 1.35 kB[22m [2m│ gzip: 0.65 kB[22m
|
|
11
|
+
[34mℹ[39m [2mdist/[22m[1mexample.js[22m [2m 0.77 kB[22m [2m│ gzip: 0.41 kB[22m
|
|
12
|
+
[34mℹ[39m [2mdist/[22m[1mindex.js[22m [2m 0.19 kB[22m [2m│ gzip: 0.12 kB[22m
|
|
13
|
+
[34mℹ[39m [2mdist/[22m[1mdocs/index.js[22m [2m 0.04 kB[22m [2m│ gzip: 0.06 kB[22m
|
|
14
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/accessibility_wcag_compliance_specs.docblock.js [2m16.91 kB[22m [2m│ gzip: 7.23 kB[22m
|
|
15
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/schema/README.docblock.js [2m11.21 kB[22m [2m│ gzip: 4.33 kB[22m
|
|
16
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/lifecycle-stage-system.docblock.js [2m 9.96 kB[22m [2m│ gzip: 3.83 kB[22m
|
|
17
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/llm/llm-integration.docblock.js [2m 9.53 kB[22m [2m│ gzip: 3.50 kB[22m
|
|
18
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/PHASE_1_QUICKSTART.docblock.js [2m 9.22 kB[22m [2m│ gzip: 2.77 kB[22m
|
|
19
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.js [2m 6.16 kB[22m [2m│ gzip: 2.65 kB[22m
|
|
20
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/templates/runtime.docblock.js [2m 5.85 kB[22m [2m│ gzip: 2.66 kB[22m
|
|
21
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/workflows/overview.docblock.js [2m 5.66 kB[22m [2m│ gzip: 2.34 kB[22m
|
|
22
|
+
[34mℹ[39m [2mdist/[22mlibs/logger/dist/formatters.js [2m 5.42 kB[22m [2m│ gzip: 1.71 kB[22m
|
|
23
|
+
[34mℹ[39m [2mdist/[22mlibs/logger/dist/logger.node.js [2m 5.40 kB[22m [2m│ gzip: 1.66 kB[22m
|
|
24
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js [2m 4.62 kB[22m [2m│ gzip: 2.13 kB[22m
|
|
25
|
+
[34mℹ[39m [2mdist/[22mlibs/support-bot/dist/tickets/classifier.js [2m 4.17 kB[22m [2m│ gzip: 1.57 kB[22m
|
|
26
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/telemetry-ingest.docblock.js [2m 4.16 kB[22m [2m│ gzip: 1.78 kB[22m
|
|
27
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/vscode-extension.docblock.js [2m 3.85 kB[22m [2m│ gzip: 1.47 kB[22m
|
|
28
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/PUBLISHING.docblock.js [2m 3.62 kB[22m [2m│ gzip: 1.65 kB[22m
|
|
29
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/auth/better-auth-nextjs.docblock.js [2m 3.60 kB[22m [2m│ gzip: 1.53 kB[22m
|
|
30
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/studio/learning-journeys.docblock.js [2m 3.33 kB[22m [2m│ gzip: 1.47 kB[22m
|
|
31
|
+
[34mℹ[39m [2mdist/[22mlibs/support-bot/dist/bot/auto-responder.js [2m 3.33 kB[22m [2m│ gzip: 1.36 kB[22m
|
|
32
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/studio/platform-admin-panel.docblock.js [2m 3.30 kB[22m [2m│ gzip: 1.42 kB[22m
|
|
33
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js [2m 3.25 kB[22m [2m│ gzip: 1.59 kB[22m
|
|
34
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js [2m 3.13 kB[22m [2m│ gzip: 1.47 kB[22m
|
|
35
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/presentation-runtime.docblock.js [2m 2.97 kB[22m [2m│ gzip: 1.38 kB[22m
|
|
36
|
+
[34mℹ[39m [2mdist/[22mlibs/logger/dist/tracer.node.js [2m 2.86 kB[22m [2m│ gzip: 1.01 kB[22m
|
|
37
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/studio/project-routing.docblock.js [2m 2.75 kB[22m [2m│ gzip: 1.22 kB[22m
|
|
38
|
+
[34mℹ[39m [2mdist/[22mlibs/logger/dist/timer.js [2m 2.43 kB[22m [2m│ gzip: 0.85 kB[22m
|
|
39
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/studio/team-invitations.docblock.js [2m 2.40 kB[22m [2m│ gzip: 1.13 kB[22m
|
|
40
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/presentations.js [2m 2.18 kB[22m [2m│ gzip: 0.77 kB[22m
|
|
41
|
+
[34mℹ[39m [2mdist/[22mlibs/support-bot/dist/rag/ticket-resolver.js [2m 2.17 kB[22m [2m│ gzip: 0.90 kB[22m
|
|
42
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/studio/workspaces.docblock.js [2m 2.13 kB[22m [2m│ gzip: 1.02 kB[22m
|
|
43
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/studio/learning-events.docblock.js [2m 2.04 kB[22m [2m│ gzip: 0.97 kB[22m
|
|
44
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/contracts/openapi-export.docblock.js [2m 1.96 kB[22m [2m│ gzip: 0.97 kB[22m
|
|
45
|
+
[33m[UNRESOLVED_IMPORT] Warning:[0m Could not resolve 'node:async_hooks' in ../../libs/logger/dist/context.node.mjs
|
|
46
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/studio/project-access-teams.docblock.js [2m 1.85 kB[22m [2m│ gzip: 0.87 kB[22m
|
|
47
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/studio/workspace-ops.docblock.js [2m 1.73 kB[22m [2m│ gzip: 0.82 kB[22m
|
|
48
|
+
[38;5;246m╭[0m[38;5;246m─[0m[38;5;246m[[0m ../../libs/logger/dist/context.node.mjs:1:35 [38;5;246m][0m
|
|
49
|
+
[34mℹ[39m [2mdist/[22mlibs/logger/dist/context.node.js [2m 1.63 kB[22m [2m│ gzip: 0.62 kB[22m
|
|
50
|
+
[38;5;246m│[0m
|
|
51
|
+
[38;5;246m1 │[0m [38;5;249mi[0m[38;5;249mm[0m[38;5;249mp[0m[38;5;249mo[0m[38;5;249mr[0m[38;5;249mt[0m[38;5;249m [0m[38;5;249m{[0m[38;5;249m [0m[38;5;249mA[0m[38;5;249ms[0m[38;5;249my[0m[38;5;249mn[0m[38;5;249mc[0m[38;5;249mL[0m[38;5;249mo[0m[38;5;249mc[0m[38;5;249ma[0m[38;5;249ml[0m[38;5;249mS[0m[38;5;249mt[0m[38;5;249mo[0m[38;5;249mr[0m[38;5;249ma[0m[38;5;249mg[0m[38;5;249me[0m[38;5;249m [0m[38;5;249m}[0m[38;5;249m [0m[38;5;249mf[0m[38;5;249mr[0m[38;5;249mo[0m[38;5;249mm[0m[38;5;249m [0m"node:async_hooks"[38;5;249m;[0m
|
|
52
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/index.js [2m 1.58 kB[22m [2m│ gzip: 0.51 kB[22m
|
|
53
|
+
[38;5;240m │[0m ─────────┬────────
|
|
54
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/mcp-endpoints.docblock.js [2m 1.46 kB[22m [2m│ gzip: 0.77 kB[22m
|
|
55
|
+
[34mℹ[39m [2mdist/[22mlibs/support-bot/dist/bot/tools.js [2m 1.44 kB[22m [2m│ gzip: 0.54 kB[22m
|
|
56
|
+
[38;5;240m │[0m ╰────────── Module not found, treating it as an external dependency
|
|
57
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/registry.js [2m 1.25 kB[22m [2m│ gzip: 0.56 kB[22m
|
|
58
|
+
[34mℹ[39m [2mdist/[22mlibs/contracts/dist/docs/tech/studio/sandbox-unlogged.docblock.js [2m 1.14 kB[22m [2m│ gzip: 0.65 kB[22m
|
|
59
|
+
[34mℹ[39m [2mdist/[22mlibs/logger/dist/types.js [2m 0.44 kB[22m [2m│ gzip: 0.23 kB[22m
|
|
60
|
+
[34mℹ[39m [2mdist/[22mlibs/logger/dist/index.js [2m 0.31 kB[22m [2m│ gzip: 0.16 kB[22m
|
|
61
|
+
[34mℹ[39m [2mdist/[22mlibs/support-bot/dist/bot/index.js [2m 0.07 kB[22m [2m│ gzip: 0.08 kB[22m
|
|
62
|
+
[34mℹ[39m [2mdist/[22mlibs/logger/dist/elysia-plugin.js [2m 0.07 kB[22m [2m│ gzip: 0.07 kB[22m
|
|
63
|
+
[34mℹ[39m [2mdist/[22m[32m[1mexample.d.ts[22m[39m [2m 1.01 kB[22m [2m│ gzip: 0.41 kB[22m
|
|
64
|
+
[38;5;240m │[0m
|
|
65
|
+
[38;5;240m │[0m [38;5;115mHelp[0m: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
|
|
66
|
+
[34mℹ[39m [2mdist/[22m[32m[1mindex.d.ts[22m[39m [2m 0.13 kB[22m [2m│ gzip: 0.09 kB[22m
|
|
67
|
+
[34mℹ[39m [2mdist/[22m[32m[1msetup.d.ts[22m[39m [2m 0.13 kB[22m [2m│ gzip: 0.12 kB[22m
|
|
68
|
+
[34mℹ[39m [2mdist/[22m[32m[1mdocs/ai-support-bot.docblock.d.ts[22m[39m [2m 0.01 kB[22m [2m│ gzip: 0.03 kB[22m
|
|
69
|
+
[38;5;246m───╯[0m
|
|
70
|
+
|
|
71
|
+
[34mℹ[39m [2mdist/[22m[32m[1mdocs/index.d.ts[22m[39m [2m 0.01 kB[22m [2m│ gzip: 0.03 kB[22m
|
|
72
|
+
[34mℹ[39m 53 files, total: 167.85 kB
|
|
73
|
+
[32m✔[39m Build complete in [32m37550ms[39m
|
|
74
|
+
$ tsc --noEmit
|
package/CHANGELOG.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# @lssm/example.ai-support-bot
|
|
2
2
|
|
|
3
|
-
## 0.0.0-canary-
|
|
3
|
+
## 0.0.0-canary-20251217072406
|
|
4
4
|
|
|
5
5
|
### Minor Changes
|
|
6
6
|
|
|
@@ -9,7 +9,8 @@
|
|
|
9
9
|
### Patch Changes
|
|
10
10
|
|
|
11
11
|
- Updated dependencies [66a5dfd]
|
|
12
|
-
- @lssm/lib.contracts@0.0.0-canary-
|
|
13
|
-
- @lssm/lib.knowledge@0.0.0-canary-
|
|
14
|
-
- @lssm/lib.logger@0.0.0-canary-
|
|
15
|
-
- @lssm/lib.
|
|
12
|
+
- @lssm/lib.contracts@0.0.0-canary-20251217072406
|
|
13
|
+
- @lssm/lib.knowledge@0.0.0-canary-20251217072406
|
|
14
|
+
- @lssm/lib.logger@0.0.0-canary-20251217072406
|
|
15
|
+
- @lssm/lib.schema@0.0.0-canary-20251217072406
|
|
16
|
+
- @lssm/lib.support-bot@0.0.0-canary-20251217072406
|
|
@@ -1,14 +1,29 @@
|
|
|
1
|
-
import{
|
|
2
|
-
|
|
3
|
-
- Use a knowledge port to generate a grounded resolution.
|
|
4
|
-
- Draft a response (email body) from the resolution.
|
|
1
|
+
import { registerDocBlocks } from "../libs/contracts/dist/docs/registry.js";
|
|
2
|
+
import "../libs/contracts/dist/docs/index.js";
|
|
5
3
|
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
4
|
+
//#region src/docs/ai-support-bot.docblock.ts
|
|
5
|
+
registerDocBlocks([{
|
|
6
|
+
id: "docs.examples.ai-support-bot",
|
|
7
|
+
title: "AI Support Bot (example)",
|
|
8
|
+
summary: "Ticket classification + knowledge-grounded resolution + response drafting.",
|
|
9
|
+
kind: "reference",
|
|
10
|
+
visibility: "public",
|
|
11
|
+
route: "/docs/examples/ai-support-bot",
|
|
12
|
+
tags: [
|
|
13
|
+
"support",
|
|
14
|
+
"ai",
|
|
15
|
+
"example"
|
|
16
|
+
],
|
|
17
|
+
body: `## What this example shows\n- Classify a ticket into a support category.\n- Use a knowledge port to generate a grounded resolution.\n- Draft a response (email body) from the resolution.\n\n## Guardrails\n- Avoid logging raw ticket bodies/PII; prefer structured summaries.\n- Keep knowledge and ticket adapters explicit and testable.`
|
|
18
|
+
}, {
|
|
19
|
+
id: "docs.examples.ai-support-bot.usage",
|
|
20
|
+
title: "AI Support Bot — Usage",
|
|
21
|
+
summary: "How to run the example and swap the knowledge adapter.",
|
|
22
|
+
kind: "usage",
|
|
23
|
+
visibility: "public",
|
|
24
|
+
route: "/docs/examples/ai-support-bot/usage",
|
|
25
|
+
tags: ["support", "usage"],
|
|
26
|
+
body: `## Usage\n- Call \`runAiSupportBotExample()\`.\n- Replace the \`knowledge.query\` implementation with a real knowledge service.\n\n## Notes\n- Keep outputs structured.\n- Use policy gates before exposing drafted replies to end-users.`
|
|
27
|
+
}]);
|
|
11
28
|
|
|
12
|
-
|
|
13
|
-
- Keep outputs structured.
|
|
14
|
-
- Use policy gates before exposing drafted replies to end-users.`}]);
|
|
29
|
+
//#endregion
|
package/dist/docs/index.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import"./ai-support-bot.docblock.js";
|
|
1
|
+
import "./ai-support-bot.docblock.js";
|
package/dist/example.js
CHANGED
|
@@ -1 +1,38 @@
|
|
|
1
|
-
|
|
1
|
+
//#region src/example.ts
|
|
2
|
+
const example = {
|
|
3
|
+
id: "ai-support-bot",
|
|
4
|
+
title: "AI Support Bot",
|
|
5
|
+
summary: "Classify and resolve a support ticket (with a drafted response) using the support-bot and knowledge libraries.",
|
|
6
|
+
tags: [
|
|
7
|
+
"support",
|
|
8
|
+
"ai",
|
|
9
|
+
"tickets",
|
|
10
|
+
"knowledge"
|
|
11
|
+
],
|
|
12
|
+
kind: "script",
|
|
13
|
+
visibility: "public",
|
|
14
|
+
docs: {
|
|
15
|
+
rootDocId: "docs.examples.ai-support-bot",
|
|
16
|
+
usageDocId: "docs.examples.ai-support-bot.usage"
|
|
17
|
+
},
|
|
18
|
+
entrypoints: {
|
|
19
|
+
packageName: "@lssm/example.ai-support-bot",
|
|
20
|
+
docs: "./docs"
|
|
21
|
+
},
|
|
22
|
+
surfaces: {
|
|
23
|
+
templates: true,
|
|
24
|
+
sandbox: {
|
|
25
|
+
enabled: true,
|
|
26
|
+
modes: ["markdown"]
|
|
27
|
+
},
|
|
28
|
+
studio: {
|
|
29
|
+
enabled: true,
|
|
30
|
+
installable: true
|
|
31
|
+
},
|
|
32
|
+
mcp: { enabled: true }
|
|
33
|
+
}
|
|
34
|
+
};
|
|
35
|
+
var example_default = example;
|
|
36
|
+
|
|
37
|
+
//#endregion
|
|
38
|
+
export { example_default as default };
|
package/dist/index.js
CHANGED
|
@@ -1 +1,5 @@
|
|
|
1
|
-
import
|
|
1
|
+
import example_default from "./example.js";
|
|
2
|
+
import { runAiSupportBotExample } from "./setup.js";
|
|
3
|
+
import "./docs/index.js";
|
|
4
|
+
|
|
5
|
+
export { example_default as example, runAiSupportBotExample };
|
|
@@ -1,76 +1,16 @@
|
|
|
1
|
-
import{
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
## Prerequisites
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
## Canary Workflow (Automatic)
|
|
19
|
-
|
|
20
|
-
Every commit pushed to \`main\` triggers the \`.github/workflows/publish-canary.yml\` workflow.
|
|
21
|
-
|
|
22
|
-
1. **Trigger**: Push to \`main\`.
|
|
23
|
-
2. **Versioning**: Runs \`changeset version --snapshot canary\` to generate a temporary snapshot version.
|
|
24
|
-
3. **Publish**: Packages are published to npm with the \`canary\` tag using \`changeset publish --tag canary\`.
|
|
25
|
-
|
|
26
|
-
### Consuming Canary Builds
|
|
27
|
-
|
|
28
|
-
To install the latest bleeding-edge version:
|
|
29
|
-
|
|
30
|
-
\`\`\`bash
|
|
31
|
-
npm install @lssm/lib.contracts@canary
|
|
32
|
-
# or
|
|
33
|
-
bun add @lssm/lib.contracts@canary
|
|
34
|
-
\`\`\`
|
|
35
|
-
|
|
36
|
-
## Stable Release Workflow (Manual)
|
|
37
|
-
|
|
38
|
-
Stable releases are managed via the \`release\` branch using the standard [Changesets Action](https://github.com/changesets/action).
|
|
39
|
-
|
|
40
|
-
1. **Develop on \`main\`**: Create features and fixes.
|
|
41
|
-
2. **Add Changesets**: Run \`bun changeset\` to document changes and impact (major/minor/patch).
|
|
42
|
-
3. **Merge to \`release\`**: When ready to ship, open a PR from \`main\` to \`release\` or merge manually.
|
|
43
|
-
4. **"Version Packages" PR**:
|
|
44
|
-
- The GitHub Action detects new changesets and automatically creates a Pull Request titled **"Version Packages"**.
|
|
45
|
-
- This PR contains the version bumps and updated \`CHANGELOG.md\` files.
|
|
46
|
-
5. **Merge & Publish**:
|
|
47
|
-
- Review and merge the "Version Packages" PR.
|
|
48
|
-
- The Action runs again, detects the versions have been bumped, builds the libraries, and publishes them to npm with the \`latest\` tag.
|
|
49
|
-
|
|
50
|
-
### Publishing Steps
|
|
51
|
-
|
|
52
|
-
1. Ensure all changesets are present on \`main\`.
|
|
53
|
-
2. Merge \`main\` into \`release\`:
|
|
54
|
-
\`\`\`bash
|
|
55
|
-
git checkout release
|
|
56
|
-
git pull origin release
|
|
57
|
-
git merge main
|
|
58
|
-
git push origin release
|
|
59
|
-
\`\`\`
|
|
60
|
-
3. Go to GitHub Pull Requests. You will see a **"Version Packages"** PR created by the bot.
|
|
61
|
-
4. Merge that PR.
|
|
62
|
-
5. The release is now live on npm!
|
|
63
|
-
|
|
64
|
-
## Manual Verification (Optional)
|
|
65
|
-
|
|
66
|
-
Before publishing a new version you can run:
|
|
67
|
-
|
|
68
|
-
\`\`\`bash
|
|
69
|
-
bun run build:not-apps
|
|
70
|
-
npx npm-packlist --json packages/libs/contracts
|
|
71
|
-
\`\`\`
|
|
72
|
-
|
|
73
|
-
## Rollback
|
|
74
|
-
|
|
75
|
-
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.
|
|
76
|
-
`}]);
|
|
1
|
+
import { registerDocBlocks } from "./registry.js";
|
|
2
|
+
|
|
3
|
+
//#region ../../libs/contracts/dist/docs/PUBLISHING.docblock.js
|
|
4
|
+
const PUBLISHING_DocBlocks = [{
|
|
5
|
+
id: "docs.PUBLISHING",
|
|
6
|
+
title: "Publishing ContractSpec Libraries",
|
|
7
|
+
summary: "This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).",
|
|
8
|
+
kind: "reference",
|
|
9
|
+
visibility: "public",
|
|
10
|
+
route: "/docs/PUBLISHING",
|
|
11
|
+
tags: ["PUBLISHING"],
|
|
12
|
+
body: "# Publishing ContractSpec Libraries\n\nThis guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).\n\n## Release Tracks\n\n| Track | Branch | npm Tag | Frequency | Versioning | Use Case |\n|-------|--------|---------|-----------|------------|----------|\n| **Stable** | `release` | `latest` | Manual | SemVer (e.g., `1.7.4`) | Production, external users |\n| **Canary** | `main` | `canary` | Every Push | Snapshot (e.g., `1.7.4-canary...`) | Dev, internal testing |\n\n## Prerequisites\n\n- ✅ `NPM_TOKEN` secret is configured in GitHub (owner or automation token with _publish_ scope).\n- ✅ `GITHUB_TOKEN` (built-in) has permissions to create PRs (enabled by default in new repos).\n- ✅ For stable releases: `release` branch exists and is protected.\n\n## Canary Workflow (Automatic)\n\nEvery commit pushed to `main` triggers the `.github/workflows/publish-canary.yml` workflow.\n\n1. **Trigger**: Push to `main`.\n2. **Versioning**: Runs `changeset version --snapshot canary` to generate a temporary snapshot version.\n3. **Publish**: Packages are published to npm with the `canary` tag using `changeset publish --tag canary`.\n\n### Consuming Canary Builds\n\nTo install the latest bleeding-edge version:\n\n```bash\nnpm install @lssm/lib.contracts@canary\n# or\nbun add @lssm/lib.contracts@canary\n```\n\n## Stable Release Workflow (Manual)\n\nStable releases are managed via the `release` branch using the standard [Changesets Action](https://github.com/changesets/action).\n\n1. **Develop on `main`**: Create features and fixes.\n2. **Add Changesets**: Run `bun changeset` to document changes and impact (major/minor/patch).\n3. **Merge to `release`**: When ready to ship, open a PR from `main` to `release` or merge manually.\n4. **\"Version Packages\" PR**:\n - The GitHub Action detects new changesets and automatically creates a Pull Request titled **\"Version Packages\"**.\n - This PR contains the version bumps and updated `CHANGELOG.md` files.\n5. **Merge & Publish**:\n - Review and merge the \"Version Packages\" PR.\n - The Action runs again, detects the versions have been bumped, builds the libraries, and publishes them to npm with the `latest` tag.\n\n### Publishing Steps\n\n1. Ensure all changesets are present on `main`.\n2. Merge `main` into `release`:\n ```bash\n git checkout release\n git pull origin release\n git merge main\n git push origin release\n ```\n3. Go to GitHub Pull Requests. You will see a **\"Version Packages\"** PR created by the bot.\n4. Merge that PR.\n5. The release is now live on npm!\n\n## Manual Verification (Optional)\n\nBefore publishing a new version you can run:\n\n```bash\nbun run build:not-apps\nnpx npm-packlist --json packages/libs/contracts\n```\n\n## Rollback\n\nIf 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.\n"
|
|
13
|
+
}];
|
|
14
|
+
registerDocBlocks(PUBLISHING_DocBlocks);
|
|
15
|
+
|
|
16
|
+
//#endregion
|