Tianyi Cui
3fc35c91ff
git mv per the regrouping RFC: the five human-collaboration seams and tui join packages/interaction/, app-boot becomes packages/boot/, and jsonrpc joins the renamed scaffold/ (formerly sdk/) as its server half beside client/protocol/create-sdk/helper/scripts/telemetry, whose folders drop the legacy sdk- prefix. Three new group README triplets replace the ui/ and sdk/ ones; tsconfig references/paths/globs, knip keys, vitest globs, gate scripts, catalogs, docs, and the lockfile follow. Adds the four settled FIXME rename markers (dsh-sdk-server, dsh-sdk-telemetry, dsh-sdk-helper, dsh-sdk-scripts). The scaffold folders diverge from their npm names until those renames land, so tsconfig.base.json maps the three affected names explicitly beside the group wildcard. Also repairs two pre-existing stale-path classes the strengthened sweep surfaced: docs/web-styling.md's retired web-ui host package and type-model spec fixture-literal joins. app-boot's three Loader-composition specs time out at the default 5s under full-suite parallel load on this filesystem (pre-existing; pass isolated with --testTimeout=30000); interaction/scaffold/boot suites otherwise green (687 passed).
66 lines
2.8 KiB
TypeScript
66 lines
2.8 KiB
TypeScript
/**
|
|
* Package-owned invariant companion for `@deepseek-ai/dsh-commands`:
|
|
* command lifecycle events pair by commandId within one session log.
|
|
* @module @deepseek-ai/dsh-commands/invariant
|
|
*/
|
|
|
|
import type { Context } from 'cordis'
|
|
import type { Session, SessionEvent } from '@deepseek-ai/dsh-session'
|
|
import type { InvariantFailure, InvariantInstaller } from '@deepseek-ai/dsh-invariants'
|
|
|
|
const PACKAGE_NAME = '@deepseek-ai/dsh-commands'
|
|
|
|
/** Cordis companion plugin name. */
|
|
export const name = 'commands-invariant'
|
|
/** Service required before the companion can reserve package ownership. */
|
|
export const inject = ['invariants']
|
|
|
|
/* jscpd:ignore-start -- package companions share replay and dispatch plumbing */
|
|
/** Install pairing validation over loaded logs and newly appended lifecycle events. */
|
|
const install: InvariantInstaller = Object.assign((ctx: Context, fail: InvariantFailure) => {
|
|
// Install-scoped so a dispose/re-register cycle re-sweeps from a clean slate.
|
|
const runIds = new WeakMap<Session, Set<string>>()
|
|
const validateEvent = (session: Session, event: SessionEvent): void => {
|
|
if (event.type === 'command/run') {
|
|
const ids = runIds.get(session) ?? new Set<string>()
|
|
if (ids.has(event.data.commandId)) {
|
|
fail(`command/run repeats commandId ${JSON.stringify(event.data.commandId)}`)
|
|
}
|
|
ids.add(event.data.commandId)
|
|
runIds.set(session, ids)
|
|
return
|
|
}
|
|
if (event.type !== 'command/done') return
|
|
if (runIds.get(session)?.has(event.data.commandId) !== true) {
|
|
fail(`command/done ${JSON.stringify(event.data.commandId)} pairs no prior command/run in this log`)
|
|
}
|
|
const source = event.data.sourceEventSeq
|
|
const sourceEvent = source === undefined ? undefined : session.events[source]
|
|
if (source !== undefined
|
|
&& (event.data.kind !== 'success'
|
|
|| !Number.isSafeInteger(source) || source < 0 || source >= event.seq
|
|
|| sourceEvent?.seq !== source
|
|
|| sourceEvent.type === 'command/run'
|
|
|| sourceEvent.type === 'command/done')) {
|
|
fail(`command/done ${JSON.stringify(event.data.commandId)} has invalid sourceEventSeq ${String(source)}`)
|
|
}
|
|
}
|
|
for (const session of ctx.sessions.list()) {
|
|
for (const event of session.events) validateEvent(session, event)
|
|
}
|
|
ctx.on('internal/dispatch', (_mode, eventName, args) => {
|
|
if (eventName !== 'session/event') return
|
|
const [session, event] = args as [Session, SessionEvent]
|
|
validateEvent(session, event)
|
|
}, { global: true })
|
|
}, { inject: ['sessions'] })
|
|
/* jscpd:ignore-end */
|
|
|
|
/**
|
|
* Register this package's 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))
|