dsh-logicprobe 0.5.4 → 0.5.5

package/lib/tool.js

@@ -1,57 +1,57 @@
-import { defineTool } from '@deepseek-ai/dsh-tools';
-import { runVerification } from './engine.js';
-export const LOGICPROBE_VERIFY_TOOL_NAME = 'logicprobe_verify';
-/**
- * Model-visible DSH tool wrapping the bundled TypeScript verification engine.
- * The model passes a LogicModelV1 object; the engine validates it and returns
- * the 14-check report, or an 18-check report when beforeModel is supplied
- * (D1 behavioral preservation, D2 invariant continuity, D3 regression delta,
- * D4 deadlock/liveness regression). This is the dsh-native replacement for
- * hand-filling the Python template shipped in the skill references.
- */
-export const logicProbeVerifyTool = defineTool({
-    name: LOGICPROBE_VERIFY_TOOL_NAME,
-    description: 'Run executable state-machine verification (logicprobe). Takes a LogicModelV1 object with schemaVersion=1, init, states ({id, terminal?}), transitions ({from, event, to, guard?, updates?}), variables?, invariants?, concurrentPairs?, boundaryChecks?, resourcePairs?, idempotentEvents?, narrative?. Guards are structured ({variable, op, value} | {all} | {any} | {not}); invariants support never-states, var-in-range, event-before-state, leads-to, sequence, and atomicity; variables support monotonic inc/dec. The optional narrative block carries natural-language descriptions of states (narrative.states), events (narrative.events), and (state, event) scenarios (narrative.scenarios: [{from, event, scenario}]); when present it must fully cover the model and is echoed in the report. Returns a report with S1-S8 structural checks and A1-A11 adversarial probes including shortest counterexample paths. If beforeModel is provided, also runs D1-D4 before/after regression checks. See skills/logicprobe/references/dsh-model-schema.md.',
-    parameters: {
-        model: {
-            type: 'json',
-            required: true,
-            description: 'LogicModelV1 state machine model to verify.',
-        },
-        maxStates: {
-            type: 'integer',
-            description: 'Maximum runtime states to explore. Default 10000.',
-        },
-        maxPermutationEvents: {
-            type: 'integer',
-            description: 'Maximum event count for A3 order permutation. Default 5.',
-        },
-        beforeModel: {
-            type: 'json',
-            description: 'Optional BEFORE LogicModelV1 state machine model for refactoring/migration regression comparison.',
-        },
-        stateMapping: {
-            type: 'json',
-            description: 'Optional object mapping BEFORE state ids to AFTER state ids. Omit for identity mapping (same state names).',
-        },
-    },
-    output: {
-        schema: {
-            type: 'json',
-            description: 'logicprobe verification report with summary and per-check findings.',
-        },
-        render(_args, value) {
-            return [{ type: 'text', text: JSON.stringify(value, null, 2) }];
-        },
-    },
-    timeoutMs: 10_000,
-    isConcurrencySafe: () => true,
-    async execute(args) {
-        return runVerification(args.model, {
-            maxStates: args.maxStates,
-            maxPermutationEvents: args.maxPermutationEvents,
-            beforeModel: args.beforeModel,
-            stateMapping: args.stateMapping,
-        });
-    },
-});
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import { runVerification } from './engine.js';
+export const LOGICPROBE_VERIFY_TOOL_NAME = 'logicprobe_verify';
+/**
+ * Model-visible DSH tool wrapping the bundled TypeScript verification engine.
+ * The model passes a LogicModelV1 object; the engine validates it and returns
+ * the 14-check report, or an 18-check report when beforeModel is supplied
+ * (D1 behavioral preservation, D2 invariant continuity, D3 regression delta,
+ * D4 deadlock/liveness regression). This is the dsh-native replacement for
+ * hand-filling the Python template shipped in the skill references.
+ */
+export const logicProbeVerifyTool = defineTool({
+    name: LOGICPROBE_VERIFY_TOOL_NAME,
+    description: 'Run executable state-machine verification (logicprobe). Takes a LogicModelV1 object with schemaVersion=1, init, states ({id, terminal?}), transitions ({from, event, to, guard?, updates?}), variables?, invariants?, concurrentPairs?, boundaryChecks?, resourcePairs?, idempotentEvents?, narrative?. Guards are structured ({variable, op, value} | {all} | {any} | {not}); invariants support never-states, var-in-range, event-before-state, leads-to, sequence, and atomicity; variables support monotonic inc/dec. The optional narrative block carries natural-language descriptions of states (narrative.states), events (narrative.events), and (state, event) scenarios (narrative.scenarios: [{from, event, scenario}]); when present it must fully cover the model and is echoed in the report. Returns a report with S1-S8 structural checks and A1-A11 adversarial probes including shortest counterexample paths. If beforeModel is provided, also runs D1-D4 before/after regression checks. See skills/logicprobe/references/dsh-model-schema.md.',
+    parameters: {
+        model: {
+            type: 'json',
+            required: true,
+            description: 'LogicModelV1 state machine model to verify.',
+        },
+        maxStates: {
+            type: 'integer',
+            description: 'Maximum runtime states to explore. Default 10000.',
+        },
+        maxPermutationEvents: {
+            type: 'integer',
+            description: 'Maximum event count for A3 order permutation. Default 5.',
+        },
+        beforeModel: {
+            type: 'json',
+            description: 'Optional BEFORE LogicModelV1 state machine model for refactoring/migration regression comparison.',
+        },
+        stateMapping: {
+            type: 'json',
+            description: 'Optional object mapping BEFORE state ids to AFTER state ids. Omit for identity mapping (same state names).',
+        },
+    },
+    output: {
+        schema: {
+            type: 'json',
+            description: 'logicprobe verification report with summary and per-check findings.',
+        },
+        render(_args, value) {
+            return [{ type: 'text', text: JSON.stringify(value, null, 2) }];
+        },
+    },
+    timeoutMs: 10_000,
+    isConcurrencySafe: () => true,
+    async execute(args) {
+        return runVerification(args.model, {
+            maxStates: args.maxStates,
+            maxPermutationEvents: args.maxPermutationEvents,
+            beforeModel: args.beforeModel,
+            stateMapping: args.stateMapping,
+        });
+    },
+});

package/lib/types/engine.d.ts

@@ -1,189 +1,189 @@
-export declare const ENGINE_SCHEMA_VERSION = 1;
-export type VarValue = number | boolean;
-export type GuardOp = '==' | '!=' | '<' | '<=' | '>' | '>=';
-export interface LeafGuard {
-    variable: string;
-    op: GuardOp;
-    value: VarValue;
-}
-export interface AllGuard {
-    all: GuardNode[];
-}
-export interface AnyGuard {
-    any: GuardNode[];
-}
-export interface NotGuard {
-    not: GuardNode;
-}
-export type GuardNode = LeafGuard | AllGuard | AnyGuard | NotGuard;
-export interface StateSpec {
-    id: string;
-    terminal?: boolean;
-}
-export interface UpdateSpec {
-    variable: string;
-    op: 'set' | 'inc' | 'dec';
-    value?: number;
-}
-export interface TransitionSpec {
-    from: string;
-    event: string;
-    to: string;
-    /** Absent guard is the else/default branch for the same (from, event) group. */
-    guard?: GuardNode;
-    updates?: UpdateSpec[];
-}
-export interface TransitionScenarioSpec {
-    from: string;
-    event: string;
-    /** Natural language: what this (state, event) combination represents in the real scenario. */
-    scenario: string;
-}
-export interface ModelNarrative {
-    /** Natural-language meaning of each state id. */
-    states?: Record<string, string>;
-    /** Natural-language meaning of each event id. */
-    events?: Record<string, string>;
-    /** Natural-language scenario for each distinct (from, event) combination. */
-    scenarios?: TransitionScenarioSpec[];
-}
-export interface VariableSpec {
-    name: string;
-    kind: 'integer' | 'boolean';
-    init: number | boolean;
-    min?: number;
-    max?: number;
-    monotonic?: 'inc' | 'dec';
-}
-export type InvariantSpec = {
-    id: string;
-    description: string;
-    kind: 'never-states';
-    states: string[];
-} | {
-    id: string;
-    description: string;
-    kind: 'var-in-range';
-    variable: string;
-    min?: number;
-    max?: number;
-} | {
-    id: string;
-    description: string;
-    kind: 'event-before-state';
-    event: string;
-    state: string;
-} | {
-    id: string;
-    description: string;
-    kind: 'leads-to';
-    from: string;
-    to: string;
-} | {
-    id: string;
-    description: string;
-    kind: 'sequence';
-    events: string[];
-} | {
-    id: string;
-    description: string;
-    kind: 'atomicity';
-    events: string[];
-    commit: string;
-    rollback?: string;
-};
-export interface ResourcePairSpec {
-    resource: string;
-    acquireEvent: string;
-    releaseEvent: string;
-    failEvent?: string;
-}
-export interface BoundaryCheckSpec {
-    variable: string;
-    values: number[];
-}
-export interface LogicModelV1 {
-    schemaVersion: 1;
-    init: string;
-    states: StateSpec[];
-    transitions: TransitionSpec[];
-    variables?: VariableSpec[];
-    invariants?: InvariantSpec[];
-    concurrentPairs?: [string, string][];
-    boundaryChecks?: BoundaryCheckSpec[];
-    resourcePairs?: ResourcePairSpec[];
-    idempotentEvents?: string[];
-    /** Natural-language descriptions of states, events, and (state, event) scenarios. */
-    narrative?: ModelNarrative;
-}
-export interface VerificationOptions {
-    maxStates?: number;
-    maxPermutationEvents?: number;
-    beforeModel?: unknown;
-    stateMapping?: Record<string, string>;
-}
-export interface PathStep {
-    from: string;
-    event: string;
-    to: string;
-}
-export interface Finding {
-    code: string;
-    severity: 'error' | 'warning';
-    message: string;
-    path?: PathStep[];
-    evidence?: Record<string, unknown>;
-}
-export interface CheckResult {
-    id: string;
-    name: string;
-    status: 'pass' | 'fail' | 'skip';
-    detail: string;
-    findings: Finding[];
-}
-export interface VerificationReport {
-    ok: boolean;
-    schemaVersion: 1;
-    modelHash: string;
-    /** Echo of the model's natural-language narrative, when present. */
-    narrative?: ModelNarrative;
-    summary: {
-        states: number;
-        transitions: number;
-        errors: number;
-        warnings: number;
-        checksRun: number;
-        truncated?: boolean;
-    };
-    checks: CheckResult[];
-    comparison?: ComparisonSummary;
-}
-export interface ComparisonSummary {
-    beforeModelHash: string;
-    afterModelHash: string;
-    stateMapping: Record<string, string>;
-    beforeStates: number;
-    beforeTransitions: number;
-    afterStates: number;
-    afterTransitions: number;
-    addedStates: string[];
-    removedStates: string[];
-    addedEvents: string[];
-    removedEvents: string[];
-    addedTransitions: TransitionSpec[];
-    removedTransitions: TransitionSpec[];
-}
-export interface RuntimeState {
-    state: string;
-    vars: Record<string, VarValue>;
-}
-export declare function modelHash(model: LogicModelV1): string;
-export declare function validateModel(input: unknown): {
-    ok: true;
-    model: LogicModelV1;
-} | {
-    ok: false;
-    errors: string[];
-};
-export declare function guardVariables(guard: GuardNode | undefined): string[];
-export declare function runVerification(input: unknown, options?: VerificationOptions): VerificationReport;
+export declare const ENGINE_SCHEMA_VERSION = 1;
+export type VarValue = number | boolean;
+export type GuardOp = '==' | '!=' | '<' | '<=' | '>' | '>=';
+export interface LeafGuard {
+    variable: string;
+    op: GuardOp;
+    value: VarValue;
+}
+export interface AllGuard {
+    all: GuardNode[];
+}
+export interface AnyGuard {
+    any: GuardNode[];
+}
+export interface NotGuard {
+    not: GuardNode;
+}
+export type GuardNode = LeafGuard | AllGuard | AnyGuard | NotGuard;
+export interface StateSpec {
+    id: string;
+    terminal?: boolean;
+}
+export interface UpdateSpec {
+    variable: string;
+    op: 'set' | 'inc' | 'dec';
+    value?: number;
+}
+export interface TransitionSpec {
+    from: string;
+    event: string;
+    to: string;
+    /** Absent guard is the else/default branch for the same (from, event) group. */
+    guard?: GuardNode;
+    updates?: UpdateSpec[];
+}
+export interface TransitionScenarioSpec {
+    from: string;
+    event: string;
+    /** Natural language: what this (state, event) combination represents in the real scenario. */
+    scenario: string;
+}
+export interface ModelNarrative {
+    /** Natural-language meaning of each state id. */
+    states?: Record<string, string>;
+    /** Natural-language meaning of each event id. */
+    events?: Record<string, string>;
+    /** Natural-language scenario for each distinct (from, event) combination. */
+    scenarios?: TransitionScenarioSpec[];
+}
+export interface VariableSpec {
+    name: string;
+    kind: 'integer' | 'boolean';
+    init: number | boolean;
+    min?: number;
+    max?: number;
+    monotonic?: 'inc' | 'dec';
+}
+export type InvariantSpec = {
+    id: string;
+    description: string;
+    kind: 'never-states';
+    states: string[];
+} | {
+    id: string;
+    description: string;
+    kind: 'var-in-range';
+    variable: string;
+    min?: number;
+    max?: number;
+} | {
+    id: string;
+    description: string;
+    kind: 'event-before-state';
+    event: string;
+    state: string;
+} | {
+    id: string;
+    description: string;
+    kind: 'leads-to';
+    from: string;
+    to: string;
+} | {
+    id: string;
+    description: string;
+    kind: 'sequence';
+    events: string[];
+} | {
+    id: string;
+    description: string;
+    kind: 'atomicity';
+    events: string[];
+    commit: string;
+    rollback?: string;
+};
+export interface ResourcePairSpec {
+    resource: string;
+    acquireEvent: string;
+    releaseEvent: string;
+    failEvent?: string;
+}
+export interface BoundaryCheckSpec {
+    variable: string;
+    values: number[];
+}
+export interface LogicModelV1 {
+    schemaVersion: 1;
+    init: string;
+    states: StateSpec[];
+    transitions: TransitionSpec[];
+    variables?: VariableSpec[];
+    invariants?: InvariantSpec[];
+    concurrentPairs?: [string, string][];
+    boundaryChecks?: BoundaryCheckSpec[];
+    resourcePairs?: ResourcePairSpec[];
+    idempotentEvents?: string[];
+    /** Natural-language descriptions of states, events, and (state, event) scenarios. */
+    narrative?: ModelNarrative;
+}
+export interface VerificationOptions {
+    maxStates?: number;
+    maxPermutationEvents?: number;
+    beforeModel?: unknown;
+    stateMapping?: Record<string, string>;
+}
+export interface PathStep {
+    from: string;
+    event: string;
+    to: string;
+}
+export interface Finding {
+    code: string;
+    severity: 'error' | 'warning';
+    message: string;
+    path?: PathStep[];
+    evidence?: Record<string, unknown>;
+}
+export interface CheckResult {
+    id: string;
+    name: string;
+    status: 'pass' | 'fail' | 'skip';
+    detail: string;
+    findings: Finding[];
+}
+export interface VerificationReport {
+    ok: boolean;
+    schemaVersion: 1;
+    modelHash: string;
+    /** Echo of the model's natural-language narrative, when present. */
+    narrative?: ModelNarrative;
+    summary: {
+        states: number;
+        transitions: number;
+        errors: number;
+        warnings: number;
+        checksRun: number;
+        truncated?: boolean;
+    };
+    checks: CheckResult[];
+    comparison?: ComparisonSummary;
+}
+export interface ComparisonSummary {
+    beforeModelHash: string;
+    afterModelHash: string;
+    stateMapping: Record<string, string>;
+    beforeStates: number;
+    beforeTransitions: number;
+    afterStates: number;
+    afterTransitions: number;
+    addedStates: string[];
+    removedStates: string[];
+    addedEvents: string[];
+    removedEvents: string[];
+    addedTransitions: TransitionSpec[];
+    removedTransitions: TransitionSpec[];
+}
+export interface RuntimeState {
+    state: string;
+    vars: Record<string, VarValue>;
+}
+export declare function modelHash(model: LogicModelV1): string;
+export declare function validateModel(input: unknown): {
+    ok: true;
+    model: LogicModelV1;
+} | {
+    ok: false;
+    errors: string[];
+};
+export declare function guardVariables(guard: GuardNode | undefined): string[];
+export declare function runVerification(input: unknown, options?: VerificationOptions): VerificationReport;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-logicprobe",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "description": "Design document & plan claim verification — enumerate claims, verify against codebase facts, then escalate to state-machine verification (S1-S8/A1-A11) and data-model verification (DS/DA/DD) for behavioral claims. Supports before/after regression, idempotency/monotonic/sequence/leads-to/atomicity constraints, and concurrency risk mining. Ships a native DeepSeek Harness (dsh) bundle that injects the claim-verification gate into the first model step.",
   "type": "module",
   "main": "lib/index.js",
@@ -29,13 +29,14 @@
       "patch": "./cordis.patch.yml"
     },
     "compatibility": {
-      "dsh": "^0.1.0-rc.7 || ^0.1.1-rc.1 || ^0.1.2-alpha.2",
+      "dsh": "^0.1.0-rc.7 || ^0.1.1-rc.1 || ^0.1.2-alpha.2 || ^0.1.2-alpha.3",
       "dshReleases": {
         "0.1.0-rc.7": "compatible",
         "0.1.0-rc.8": "compatible",
         "0.1.1-rc.1": "compatible",
         "0.1.1-rc.2": "compatible",
-        "0.1.2-alpha.2": "compatible"
+        "0.1.2-alpha.2": "compatible",
+        "0.1.2-alpha.3": "compatible"
       },
       "profiles": [
         "headless"