@jskit-ai/agent-docs 0.1.217 → 0.1.218

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.
Files changed (10) hide show
  1. package/guide/agent/app-setup/upgrading-jskit.md +18 -0
  2. package/package.json +1 -1
  3. package/patterns/minimal-foundation/example/package.json +1 -1
  4. package/patterns/shell-foundation/example/package.json +1 -1
  5. package/reference/autogen/PATTERN_INDEX.md +4 -4
  6. package/reference/autogen/packages/assistant-core.md +3 -1
  7. package/reference/autogen/tooling/jskit-catalog.md +2 -2
  8. package/skills/jskit/references/pattern-index.md +4 -4
  9. package/skills/jskit/references/patterns/app/minimal-foundation/example/package.json +1 -1
  10. package/skills/jskit/references/patterns/app/shell-foundation/example/package.json +1 -1
package/guide/agent/app-setup/upgrading-jskit.md CHANGED
@@ -119,6 +119,24 @@ composed application manifest and let resolution identify its actual consumers.
119
119
  The installed-graph check does not replace application-owned non-JSKIT version
120
120
  validation or the original root lockfile checks.
121
121
 
122
+ ### Explicit development sources
123
+
124
+ Hosts composing selected source checkouts can pass `sourcePackages`, an explicit
125
+ package-name-to-directory map, to both `checkProject` and `checkInstalledGraph`.
126
+ The former exempts only these replaced names from published declaration and
127
+ root lock/installed-version comparisons. Pass the corresponding **materialized**
128
+ directories to the latter: it validates package identity and required dependencies,
129
+ rejects resolution outside each selected real path, and still rejects duplicate
130
+ singleton runtimes, including identical-version copies. Selected source versions
131
+ and their consumer ranges need not match the published catalog.
132
+
133
+ Always run both stages. Source preflight alone does not prove a usable graph.
134
+ The host still validates external dependency compatibility and prepared exports.
135
+ Unselected packages retain ordinary checks. This programmatic development option
136
+ does not modify manifests or locks, change release pins, or relax CLI/update/CI
137
+ defaults. A missing selected checkout must fail; it is not permission to choose a
138
+ published package instead.
139
+
122
140
  ## Enforce the graph in CI
123
141
 
124
142
  Run this after `npm ci`, and include it in the application's normal verifier:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jskit-ai/agent-docs",
3
- "version": "0.1.217",
3
+ "version": "0.1.218",
4
4
  "description": "Distributed JSKIT agent references, prompts, guides, and generated reference maps.",
5
5
  "type": "module",
6
6
  "files": [
package/patterns/minimal-foundation/example/package.json CHANGED
@@ -48,7 +48,7 @@
48
48
  },
49
49
  "devDependencies": {
50
50
  "@jskit-ai/config-eslint": "0.1.241",
51
- "@jskit-ai/jskit-catalog": "0.1.270",
51
+ "@jskit-ai/jskit-catalog": "0.1.271",
52
52
  "@playwright/test": "1.61.1",
53
53
  "@vitejs/plugin-vue": "^6.0.7",
54
54
  "eslint": "^10.8.0",
package/patterns/shell-foundation/example/package.json CHANGED
@@ -50,7 +50,7 @@
50
50
  },
51
51
  "devDependencies": {
52
52
  "@jskit-ai/config-eslint": "0.1.241",
53
- "@jskit-ai/jskit-catalog": "0.1.270",
53
+ "@jskit-ai/jskit-catalog": "0.1.271",
54
54
  "@playwright/test": "1.61.1",
55
55
  "@vitejs/plugin-vue": "^6.0.7",
56
56
  "eslint": "^10.8.0",
package/reference/autogen/PATTERN_INDEX.md CHANGED
@@ -15,7 +15,7 @@ A concrete Fastify, Vue, and JSKIT application foundation for products that do n
15
15
 
16
16
  - Id: `app/minimal-foundation`
17
17
  - Keywords: `app`, `fastify`, `foundation`, `minimal`, `server`, `vite`, `vue`
18
- - Owner: `@jskit-ai/agent-docs@0.1.217`
18
+ - Owner: `@jskit-ai/agent-docs@0.1.218`
19
19
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/app/minimal-foundation/PATTERN.md)
20
20
  - Examples: [example/](../../skills/jskit/references/patterns/app/minimal-foundation/example/)
21
21
  - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`
@@ -26,7 +26,7 @@ A concrete JSKIT web application foundation with responsive shell navigation, se
26
26
 
27
27
  - Id: `app/shell-foundation`
28
28
  - Keywords: `app`, `foundation`, `material`, `navigation`, `placements`, `shell`, `vite`, `vue`
29
- - Owner: `@jskit-ai/agent-docs@0.1.217`
29
+ - Owner: `@jskit-ai/agent-docs@0.1.218`
30
30
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/app/shell-foundation/PATTERN.md)
31
31
  - Examples: [example/](../../skills/jskit/references/patterns/app/shell-foundation/example/)
32
32
  - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -37,7 +37,7 @@ Configure an assistant runtime for one application surface and expose its chat a
37
37
 
38
38
  - Id: `assistant/assistant-surface`
39
39
  - Keywords: `ai`, `assistant`, `chat`, `config`, `environment`, `page`, `placement`, `settings`, `surface`
40
- - Owner: `@jskit-ai/assistant-runtime@0.1.216`
40
+ - Owner: `@jskit-ai/assistant-runtime@0.1.217`
41
41
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/assistant/assistant-surface/PATTERN.md)
42
42
  - Examples: [example/](../../skills/jskit/references/patterns/assistant/assistant-surface/example/)
43
43
  - Requires: `@jskit-ai/assistant-runtime`, `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`, `@jskit-ai/shell-web`
@@ -323,7 +323,7 @@ Define a server feature through explicit capabilities and first-class actions, a
323
323
 
324
324
  - Id: `server/feature-package`
325
325
  - Keywords: `actions`, `feature`, `json-rest`, `knex`, `orchestration`, `package`, `provider`, `repository`, `routes`, `server`
326
- - Owner: `@jskit-ai/agent-docs@0.1.217`
326
+ - Owner: `@jskit-ai/agent-docs@0.1.218`
327
327
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/server/feature-package/PATTERN.md)
328
328
  - Examples: [example/](../../skills/jskit/references/patterns/server/feature-package/example/)
329
329
  - Requires: `@jskit-ai/kernel`
package/reference/autogen/packages/assistant-core.md CHANGED
@@ -306,7 +306,7 @@ Exports
306
306
  - `deleteClaudeConversationHistory({ configRoot, workdir, conversationId })`
307
307
  - `retireClaudeConversationHistory({ configRoot, binding, beforeDelete, requireIdle, signal })`
308
308
  - `claudeHistoryPath({ configRoot, workdir, conversationId })`
309
- - `claudeMessageBlocks(frame, { includeNested = false } = {})`
309
+ - `claudeMessageBlocks(frame, { includeNested = false, commentary = false } = {})`
310
310
  - `readClaudeHistory(options)`
311
311
  - `requireClaudeSessionId(id)`
312
312
  - `archivedClaudeProjectDirectory(workdir)`
@@ -1036,6 +1036,7 @@ Local functions
1036
1036
  ### `src/server/conversation/providers/scoped.js`
1037
1037
  Exports
1038
1038
  - `runScopedConversationTurn({ operations, scope = {}, input = {}, context: options = {}, executionProfile: profileSnapshot } = {})`
1039
+ - `projectStoredPersistentConversation(options)`
1039
1040
  - `readPersistentConversation(options)`
1040
1041
  - `startPersistentConversationTurn(options)`
1041
1042
  - `inspectPersistentConversationAdmission(options)`
@@ -1048,6 +1049,7 @@ Local functions
1048
1049
  - `qualifyTranscript(turns, record, response, receipts)`
1049
1050
  - `publishTranscript({ sessionId, store, receipts, publish }, context, record, turns, response = {})`
1050
1051
  - `streamMessage({ sessionId, store, projection, publish }, context, record, event)`
1052
+ - `projectPersistentConversation(options, context, record, response, turns)`
1051
1053
 
1052
1054
  ### `src/server/conversation/runtime.js`
1053
1055
  Exports
package/reference/autogen/tooling/jskit-catalog.md CHANGED
@@ -63,8 +63,8 @@ Exports
63
63
  - `CHECK_SCRIPT`
64
64
  - `DEPENDENCY_FIELDS`
65
65
  - `UPDATE_SCRIPT`
66
- - `checkProject({ projectRoot = process.cwd(), catalog, additionalManifests = [], checkInstalled = false } = {})`
67
- - `checkInstalledGraph({ catalog, manifestPaths = [] } = {})`
66
+ - `checkProject({ projectRoot = process.cwd(), catalog, additionalManifests = [], checkInstalled = false, sourcePackages = {} } = {})`
67
+ - `checkInstalledGraph({ catalog, manifestPaths = [], sourcePackages = {} } = {})`
68
68
  - `resolveInstalledPackage(consumerDirectory, packageId)`
69
69
  - `collectLockInstallations(packageLock = {})`
70
70
  - `discoverProjectManifests(projectRoot, additionalManifests = [])`
package/skills/jskit/references/pattern-index.md CHANGED
@@ -15,7 +15,7 @@ A concrete Fastify, Vue, and JSKIT application foundation for products that do n
15
15
 
16
16
  - Id: `app/minimal-foundation`
17
17
  - Keywords: `app`, `fastify`, `foundation`, `minimal`, `server`, `vite`, `vue`
18
- - Owner: `@jskit-ai/agent-docs@0.1.217`
18
+ - Owner: `@jskit-ai/agent-docs@0.1.218`
19
19
  - Read: [PATTERN.md](patterns/app/minimal-foundation/PATTERN.md)
20
20
  - Examples: [example/](patterns/app/minimal-foundation/example/)
21
21
  - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`
@@ -26,7 +26,7 @@ A concrete JSKIT web application foundation with responsive shell navigation, se
26
26
 
27
27
  - Id: `app/shell-foundation`
28
28
  - Keywords: `app`, `foundation`, `material`, `navigation`, `placements`, `shell`, `vite`, `vue`
29
- - Owner: `@jskit-ai/agent-docs@0.1.217`
29
+ - Owner: `@jskit-ai/agent-docs@0.1.218`
30
30
  - Read: [PATTERN.md](patterns/app/shell-foundation/PATTERN.md)
31
31
  - Examples: [example/](patterns/app/shell-foundation/example/)
32
32
  - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -37,7 +37,7 @@ Configure an assistant runtime for one application surface and expose its chat a
37
37
 
38
38
  - Id: `assistant/assistant-surface`
39
39
  - Keywords: `ai`, `assistant`, `chat`, `config`, `environment`, `page`, `placement`, `settings`, `surface`
40
- - Owner: `@jskit-ai/assistant-runtime@0.1.216`
40
+ - Owner: `@jskit-ai/assistant-runtime@0.1.217`
41
41
  - Read: [PATTERN.md](patterns/assistant/assistant-surface/PATTERN.md)
42
42
  - Examples: [example/](patterns/assistant/assistant-surface/example/)
43
43
  - Requires: `@jskit-ai/assistant-runtime`, `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`, `@jskit-ai/shell-web`
@@ -323,7 +323,7 @@ Define a server feature through explicit capabilities and first-class actions, a
323
323
 
324
324
  - Id: `server/feature-package`
325
325
  - Keywords: `actions`, `feature`, `json-rest`, `knex`, `orchestration`, `package`, `provider`, `repository`, `routes`, `server`
326
- - Owner: `@jskit-ai/agent-docs@0.1.217`
326
+ - Owner: `@jskit-ai/agent-docs@0.1.218`
327
327
  - Read: [PATTERN.md](patterns/server/feature-package/PATTERN.md)
328
328
  - Examples: [example/](patterns/server/feature-package/example/)
329
329
  - Requires: `@jskit-ai/kernel`
package/skills/jskit/references/patterns/app/minimal-foundation/example/package.json CHANGED
@@ -48,7 +48,7 @@
48
48
  },
49
49
  "devDependencies": {
50
50
  "@jskit-ai/config-eslint": "0.1.241",
51
- "@jskit-ai/jskit-catalog": "0.1.270",
51
+ "@jskit-ai/jskit-catalog": "0.1.271",
52
52
  "@playwright/test": "1.61.1",
53
53
  "@vitejs/plugin-vue": "^6.0.7",
54
54
  "eslint": "^10.8.0",
package/skills/jskit/references/patterns/app/shell-foundation/example/package.json CHANGED
@@ -50,7 +50,7 @@
50
50
  },
51
51
  "devDependencies": {
52
52
  "@jskit-ai/config-eslint": "0.1.241",
53
- "@jskit-ai/jskit-catalog": "0.1.270",
53
+ "@jskit-ai/jskit-catalog": "0.1.271",
54
54
  "@playwright/test": "1.61.1",
55
55
  "@vitejs/plugin-vue": "^6.0.7",
56
56
  "eslint": "^10.8.0",