imccyu
ec601ca13d
Machine-produced by `pnpm run rescope-vendor --apply` plus the regeneration it prints: `pnpm install` for the lockfile, `pnpm run gen-third-party-notices`, `verify-translation-pairing --write` for the touched bilingual pairs, `gen-doc-graphs`, and one typert snapshot whose ids embed character offsets. `pnpm run rescope-vendor --check` verifies the result. Renames nine vendored packages (cordis, cosmokit, schemastery and the six @cordisjs plugins) and every reference that resolves them: manifest names and dependency keys, module specifiers including declare-module merges, cordis.yml plugin names, tsconfig paths, every Markdown fence, and `docs/` prose. Directory names, upstream versions, and dependency ranges are unchanged, so vendor/README.md still reads as an upstream snapshot; its manifest table gains an upstream-name column so THIRD_PARTY_NOTICES keeps MIT attribution pointed at each fork's origin. The tutorial tier follows the rename end to end: its yaml fences named plugins the Loader can no longer resolve, its `ts ignore-check` fences disagreed with the compiled fences beside them, and its prose quoted both. The contracts that told readers to keep upstream names — the root convention and the vendoring cookbook's tree comment and manifest invariant — now say to rescope instead. Two rules read `@deepseek-ai/` as "another workspace plugin": the client bundle purity gate now names the vendored libraries a browser bundle inlines, and the files where a bare `cordis` is an agent-preset id keep that product data.
61 lines
2.7 KiB
TypeScript
61 lines
2.7 KiB
TypeScript
/** Package-owned prompt-assembly invariants. @module @deepseek-ai/dsh-system-prompt/invariant */
|
|
|
|
import type { Context } from '@deepseek-ai/cordis'
|
|
import type { InvariantFailure, InvariantInstaller } from '@deepseek-ai/dsh-invariants'
|
|
import type { PromptAssembly } from './index.ts'
|
|
|
|
const PACKAGE_NAME = '@deepseek-ai/dsh-system-prompt'
|
|
const VARIABLE_NAME = /^[a-z][a-z0-9_]*$/
|
|
|
|
/** Cordis companion plugin name. */
|
|
export const name = 'system-prompt-invariant'
|
|
/** Service required before the companion can reserve package ownership. */
|
|
export const inject = ['invariants']
|
|
|
|
/** Validate the authoritative assembly returned by the waterfall. */
|
|
function validateAssembly(assembly: PromptAssembly, fail: InvariantFailure): void {
|
|
const sectionNames = new Set<string>()
|
|
for (const section of assembly.sections) {
|
|
if (section.name.length === 0) fail('assembled section names must be non-empty')
|
|
if (sectionNames.has(section.name)) fail(`assembled section name ${JSON.stringify(section.name)} is duplicated`)
|
|
sectionNames.add(section.name)
|
|
if (typeof section.text !== 'string') fail(`assembled section ${JSON.stringify(section.name)} text must be a string`)
|
|
}
|
|
|
|
const contextNames = new Set<string>()
|
|
for (const context of assembly.contexts) {
|
|
if (context.name.length === 0) fail('assembled context names must be non-empty')
|
|
if (contextNames.has(context.name)) fail(`assembled context name ${JSON.stringify(context.name)} is duplicated`)
|
|
contextNames.add(context.name)
|
|
if (typeof context.text !== 'string') fail(`assembled context ${JSON.stringify(context.name)} text must be a string`)
|
|
}
|
|
|
|
for (const tool of assembly.tools) {
|
|
if (tool.name.length === 0) fail('assembled tool names must be non-empty')
|
|
}
|
|
|
|
for (const [name, value] of Object.entries(assembly.variables)) {
|
|
if (!VARIABLE_NAME.test(name)) fail(`assembled variable name ${JSON.stringify(name)} is invalid`)
|
|
if (value !== undefined && typeof value !== 'string') {
|
|
fail(`assembled variable ${JSON.stringify(name)} must be a string or undefined`)
|
|
}
|
|
}
|
|
}
|
|
|
|
/** Install validation around the authoritative assembly waterfall result. */
|
|
const install: InvariantInstaller = (ctx, fail) => {
|
|
ctx.on('system-prompt/assemble', async (_assembly, _context, next) => {
|
|
const assembled = await next()
|
|
validateAssembly(assembled, fail)
|
|
return assembled
|
|
}, { global: true, prepend: true })
|
|
}
|
|
|
|
/**
|
|
* Register the system-prompt invariant companion.
|
|
* @param ctx - Cordis context carrying the invariant service.
|
|
* @returns the installed registration's disposer after setup succeeds.
|
|
*/
|
|
export const apply = (ctx: Context): Promise<() => void> =>
|
|
Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install))
|