@lmzhen/dsh-evolution-policy 0.1.0-rc.1

package/README.md

@@ -0,0 +1,24 @@
+# @deepseek-ai/dsh-evolution-policy
+
+Immutable evolution policy service
+
+## Model Experience
+
+### Indirect model surface
+
+#### What the model sees
+
+`@deepseek-ai/dsh-evolution-policy` registers no direct prompt or tool schema itself. Model-visible effects are owned by the packages that consume this service.
+
+#### Token effect
+
+Zero direct token effect from this package; consumers add any model-visible tokens.
+
+#### KV Cache effect
+
+Independent of request-prefix construction. This package does not alter the assembled prompt or tool list.
+
+## Known Limitations and Deferred Work
+
+
+- No known durable consumer gaps at this time. Runtime contracts are covered by package and boundary tests.

package/lib/index.js

@@ -0,0 +1,96 @@
+import { Service } from "@deepseek-ai/cordis";
+import { join, resolve, sep } from "node:path";
+import { homedir } from "node:os";
+import z from "@deepseek-ai/schemastery";
+//#region lib/types/index.js
+/**
+* Immutable evolution policy service.
+* The policy is the control plane. Model plans may not change it.
+* @module @lmzhen/dsh-evolution-policy
+*/
+const Config = z.object({
+	reviewMemoryInterval: z.number().default(10),
+	reviewSkillInterval: z.number().default(10),
+	substantiveMinToolCalls: z.number().default(3),
+	substantiveMinUserChars: z.number().default(200),
+	substantiveMinAgentChars: z.number().default(500),
+	reviewMode: z.string().default("subagent"),
+	memoryReviewModel: z.string().default("deepseek-v4-flash"),
+	skillReviewModel: z.string().default("deepseek-v4-pro"),
+	curatorModel: z.string().default("deepseek-v4-pro"),
+	memoryChars: z.number().default(2200),
+	userChars: z.number().default(1375),
+	skillContentChars: z.number().default(1e5),
+	maxOpsPerPlan: z.number().default(32),
+	curatorIntervalHours: z.number().default(168),
+	staleAfterDays: z.number().default(30),
+	archiveAfterDays: z.number().default(90),
+	protectedSkillNames: z.array(z.string()).default([]),
+	protectedPaths: z.array(z.string()).default([])
+});
+var EvolutionPolicy = class extends Service {
+	static Config = Config;
+	snapshot;
+	constructor(ctx, config = {}) {
+		super(ctx, "evolutionPolicy");
+		ctx.inject(["tools"], (toolCtx) => {
+			const tools = toolCtx.get("tools");
+			toolCtx.effect(() => tools.guard((exec) => this.guardReason(exec.name, exec.arguments)), "evolution-policy.tools-guard");
+		});
+		const homePolicyPath = resolve(join(process.env.DSH_HOME ?? join(homedir(), ".dsh"), "evolution", "policy.json"));
+		this.snapshot = Object.freeze({
+			version: 1,
+			reviewMemoryInterval: config.reviewMemoryInterval ?? 10,
+			reviewSkillInterval: config.reviewSkillInterval ?? 10,
+			substantiveMinToolCalls: config.substantiveMinToolCalls ?? 3,
+			substantiveMinUserChars: config.substantiveMinUserChars ?? 200,
+			substantiveMinAgentChars: config.substantiveMinAgentChars ?? 500,
+			reviewMode: config.reviewMode === "inject" ? "inject" : "subagent",
+			memoryReviewModel: config.memoryReviewModel ?? "deepseek-v4-flash",
+			skillReviewModel: config.skillReviewModel ?? "deepseek-v4-pro",
+			curatorModel: config.curatorModel ?? "deepseek-v4-pro",
+			memoryChars: config.memoryChars ?? 2200,
+			userChars: config.userChars ?? 1375,
+			skillContentChars: config.skillContentChars ?? 1e5,
+			maxOpsPerPlan: config.maxOpsPerPlan ?? 32,
+			curatorIntervalHours: config.curatorIntervalHours ?? 168,
+			staleAfterDays: config.staleAfterDays ?? 30,
+			archiveAfterDays: config.archiveAfterDays ?? 90,
+			protectedSkillNames: Object.freeze([...new Set(["plan", ...config.protectedSkillNames ?? []])]),
+			protectedPaths: Object.freeze([...config.protectedPaths ?? [], homePolicyPath])
+		});
+	}
+	get() {
+		return this.snapshot;
+	}
+	isProtectedPath(path) {
+		if (typeof path !== "string") return false;
+		const normalized = resolve(path);
+		return this.snapshot.protectedPaths.some((prefix) => {
+			const resolved = resolve(prefix);
+			return normalized === resolved || normalized.startsWith(resolved + sep);
+		});
+	}
+	guardReason(toolName, args) {
+		if (toolName === "write" || toolName === "edit" || toolName === "patch" || toolName === "str_replace_editor") {
+			const record = asRecord(args);
+			const target = record.path ?? record.file_path ?? record.filePath;
+			if (this.isProtectedPath(target)) return `evolution-policy: refusing to modify protected policy path ${String(target)}`;
+		}
+		if (toolName === "memory" || toolName === "skill_manage") {
+			const record = asRecord(args);
+			for (const forbidden of [
+				"policy",
+				"threshold",
+				"prompt_hash",
+				"model_route",
+				"evolution_config"
+			]) if (forbidden in record) return `evolution-policy: tool call may not mutate ${forbidden}`;
+		}
+	}
+};
+function asRecord(value) {
+	return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+//#endregion
+export { Config, EvolutionPolicy, EvolutionPolicy as default };

package/lib/invariant.js

@@ -0,0 +1,8 @@
+//#region lib/types/invariant.js
+const PACKAGE_NAME = "@deepseek-ai/dsh-evolution-policy";
+const name = "evolution-policy-invariant";
+const inject = ["invariants"];
+const install = () => {};
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

package/lib/types/index.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Immutable evolution policy service.
+ * The policy is the control plane. Model plans may not change it.
+ * @module @deepseek-ai/dsh-evolution-policy
+ */
+import { Context, Service } from '@deepseek-ai/cordis';
+import type Schema from '@deepseek-ai/schemastery';
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        evolutionPolicy: EvolutionPolicy;
+    }
+}
+export interface PolicySnapshot {
+    version: 1;
+    reviewMemoryInterval: number;
+    reviewSkillInterval: number;
+    substantiveMinToolCalls: number;
+    substantiveMinUserChars: number;
+    substantiveMinAgentChars: number;
+    reviewMode: 'subagent' | 'inject';
+    memoryReviewModel: string;
+    skillReviewModel: string;
+    curatorModel: string;
+    memoryChars: number;
+    userChars: number;
+    skillContentChars: number;
+    maxOpsPerPlan: number;
+    curatorIntervalHours: number;
+    staleAfterDays: number;
+    archiveAfterDays: number;
+    protectedSkillNames: readonly string[];
+    protectedPaths: readonly string[];
+}
+export interface Config {
+    reviewMemoryInterval?: number;
+    reviewSkillInterval?: number;
+    substantiveMinToolCalls?: number;
+    substantiveMinUserChars?: number;
+    substantiveMinAgentChars?: number;
+    reviewMode?: string;
+    memoryReviewModel?: string;
+    skillReviewModel?: string;
+    curatorModel?: string;
+    memoryChars?: number;
+    userChars?: number;
+    skillContentChars?: number;
+    maxOpsPerPlan?: number;
+    curatorIntervalHours?: number;
+    staleAfterDays?: number;
+    archiveAfterDays?: number;
+    protectedSkillNames?: string[];
+    protectedPaths?: string[];
+}
+export declare const Config: Schema<Config>;
+export declare class EvolutionPolicy extends Service {
+    static Config: Schema<Config>;
+    readonly snapshot: PolicySnapshot;
+    constructor(ctx: Context, config?: Config);
+    get(): PolicySnapshot;
+    isProtectedPath(path: unknown): boolean;
+    guardReason(toolName: string, args: unknown): string | undefined;
+}
+export default EvolutionPolicy;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,5 @@
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "evolution-policy-invariant";
+export declare const inject: string[];
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@lmzhen/dsh-evolution-policy",
+  "description": "Immutable evolution policy service (community build)",
+  "version": "0.1.0-rc.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lmzhen/dsh-evolution.git",
+    "directory": "packages/dsh-evolution-policy"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/types/**/*.d.ts",
+    "lib/types/invariant.d.ts"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.1"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
+    "@deepseek-ai/cordis": "^4.0.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6"
+  }
+}