feat(invariants): implement package runtime checks

This commit is contained in:
Tianyi Cui
2026-07-20 00:38:37 +08:00
parent 36e99e737b
commit 941b0411d8
125 changed files with 2317 additions and 1161 deletions

View File

@@ -1,14 +1,8 @@
/**
* Generated invariant ownership companion for `@deepseek-ai/dsh-hook-protocol`.
* Replace this file with package-owned checks while preserving its registration.
*
* @generated scripts/gen-package-invariants.ts
* @module @deepseek-ai/dsh-hook-protocol/invariant
*/
/** Package-owned runtime contracts for @deepseek-ai/dsh-hook-protocol. @module @deepseek-ai/dsh-hook-protocol/invariant */
/* jscpd:ignore-start */
import type { Context } from 'cordis'
import type { InvariantInstaller } from '@deepseek-ai/dsh-invariants'
import { assertInvariant, type InvariantInstaller } from '@deepseek-ai/dsh-invariants'
const PACKAGE_NAME = '@deepseek-ai/dsh-hook-protocol'
@@ -17,8 +11,24 @@ export const name = 'hook-protocol-invariant'
/** Services required before the companion can register. */
export const inject = ['invariants']
/** Reserve this package's invariant ownership until it adds relational checks. */
const install: InvariantInstaller = () => {}
/** Assert blocking-exit decoding and restrictive merge precedence. */
const install: InvariantInstaller = (ctx, fail) => {
ctx.effect(async () => {
const { parseHookOutput } = await import('./codec.ts')
const { mergeHookOutputs } = await import('./merge.ts')
const blocked = parseHookOutput(2, '', ' denied ')
assertInvariant(fail, blocked.decision === 'block' && blocked.reason === 'denied',
'exit 2 must decode as a block whose reason is trimmed stderr')
const merged = mergeHookOutputs([
{ exitCode: 0, stderr: '', stdout: '', decision: 'allow', reason: 'permitted' },
{ exitCode: 0, stderr: '', stdout: '', decision: 'deny', reason: 'forbidden' },
])
assertInvariant(fail, merged.decision === 'deny' && merged.reason === 'forbidden',
'deny must override allow and retain only the winning decision reason')
return () => {}
}, 'hook-protocol: validate decode and merge algebra')
}
/**
* Register this package's invariant companion.