@klarkxy/dsh-self-improvement 0.1.0

package/lib/contracts.d.ts

@@ -0,0 +1,103 @@
+import { AiFeatureScope, AiServices, AuxiliaryRequest, AuxiliaryResult, EvidenceRef, KnowledgeKind, KnowledgeScope, MemoryMutationOptions, MemoryQuery, MemoryRecord, MemoryService, NewMemoryRecord, ProducerMessageSource, PurposeSpec, RpcResult, UsageReceipt, projectIdFromCwd as projectIdFromCwd$1 } from "@klarkxy/dsh-ai-services/contracts";
+//#region src/contracts.d.ts
+declare const CHAT_EVENTS_SLOT = "dsh-editor.chat.events";
+declare const projectIdFromCwd: typeof projectIdFromCwd$1;
+declare const SELF_IMPROVEMENT_RPC_CHANNEL = "/dsh-self-improvement";
+declare const SELF_IMPROVEMENT_PLUGIN = "@klarkxy/dsh-self-improvement";
+declare const SELF_IMPROVEMENT_SOURCE_KIND: "plugin:@klarkxy/dsh-self-improvement";
+/** Production activate identity. Core owns the scoped pluginName regex. */
+declare const SELF_IMPROVEMENT_ACTIVATE_ID = "@klarkxy/dsh-self-improvement";
+declare const EXTRACT_PURPOSE = "self-improvement.extract";
+declare const LESSON_INJECTION_SECTION = "dsh-self-improvement:lessons";
+declare const LESSON_SCHEMA_TAG = "lesson-schema:1";
+declare const LESSON_SCHEMA_VERSION = 1;
+declare const MAX_INJECTED_LESSONS = 5;
+declare const MAX_INJECTION_TOKENS = 800;
+declare const MAX_PROJECT_ID_CHARS = 32768;
+declare const MAX_RECALL_QUERY_CHARS = 200;
+type SkillStatus = 'preview' | 'accepted' | 'rejected' | 'revoked';
+type SkillExportState = 'none' | 'recorded' | 'revoked';
+interface SkillAuditEntry {
+  at: number;
+  action: string;
+  detail?: string;
+}
+interface SkillSourceRef {
+  id: string;
+  revision: number;
+  status: MemoryRecord['status'];
+  scope: KnowledgeScope;
+  expiresAt?: number;
+}
+interface SkillRecord {
+  id: string;
+  revision: number;
+  status: SkillStatus;
+  lessonIds: string[];
+  sources: SkillSourceRef[];
+  title: string;
+  markdown: string;
+  createdAt: number;
+  updatedAt: number;
+  exportState: SkillExportState;
+  exportedAt?: number;
+  exportRevokedAt?: number;
+  exportFilename?: string;
+  audit: SkillAuditEntry[];
+}
+interface SessionWatermark {
+  sessionId: string;
+  seq: number;
+  projectId?: string;
+  updatedAt: number;
+}
+type LessonTriggerKind = 'human-correction' | 'verified-tool-fix' | 'manual';
+interface LessonTrigger {
+  kind: LessonTriggerKind;
+  evidence: EvidenceRef[];
+  titleHint: string;
+  contentHint: string;
+  toolName?: string;
+}
+interface LessonInjectPayload {
+  source: ProducerMessageSource & {
+    kind: typeof SELF_IMPROVEMENT_SOURCE_KIND;
+    plugin: typeof SELF_IMPROVEMENT_PLUGIN;
+    form: 'snapshot';
+    sections: Array<{
+      name: string;
+      text: string;
+    }>;
+  };
+  content: Array<{
+    type: 'text';
+    text: string;
+  }>;
+}
+interface PreStepEnter {
+  kind: 'enter';
+  messages: unknown[];
+  startsRequestSeries?: true;
+}
+type PreStepDecision = {
+  kind: 'reject';
+} | PreStepEnter;
+interface ReviewSnapshot {
+  memoryAvailable: boolean;
+  memoryMessage?: string;
+  projectId?: string;
+  generation: number;
+  storageFailed: boolean;
+  lessons: MemoryRecord[];
+  skills: SkillRecord[];
+  /** True while an extract for this session (or any session, if none requested) is queued or in flight. */
+  extracting?: boolean;
+}
+declare function evidenceWatermark(refs: readonly EvidenceRef[]): string;
+declare function sessionCwd(session: unknown): string | undefined;
+declare function fail(code: string, message: string): RpcResult<never>;
+declare const MEMORY_UNAVAILABLE_MESSAGE = "记忆服务不可用。请先单独启用「记忆」插件；启用自我改进不会自动打开记忆。";
+declare const MEMORY_UNAVAILABLE_MESSAGE_EN = "Memory is unavailable. Enable the Memory plugin separately; turning on self-improvement does not enable Memory.";
+//#endregion
+export { type AiFeatureScope, type AiServices, type AuxiliaryRequest, type AuxiliaryResult, CHAT_EVENTS_SLOT, EXTRACT_PURPOSE, type EvidenceRef, type KnowledgeKind, type KnowledgeScope, LESSON_INJECTION_SECTION, LESSON_SCHEMA_TAG, LESSON_SCHEMA_VERSION, LessonInjectPayload, LessonTrigger, LessonTriggerKind, MAX_INJECTED_LESSONS, MAX_INJECTION_TOKENS, MAX_PROJECT_ID_CHARS, MAX_RECALL_QUERY_CHARS, MEMORY_UNAVAILABLE_MESSAGE, MEMORY_UNAVAILABLE_MESSAGE_EN, type MemoryMutationOptions, type MemoryQuery, type MemoryRecord, type MemoryService, type NewMemoryRecord, PreStepDecision, PreStepEnter, type ProducerMessageSource, type PurposeSpec, ReviewSnapshot, type RpcResult, SELF_IMPROVEMENT_ACTIVATE_ID, SELF_IMPROVEMENT_PLUGIN, SELF_IMPROVEMENT_RPC_CHANNEL, SELF_IMPROVEMENT_SOURCE_KIND, SessionWatermark, SkillAuditEntry, SkillExportState, SkillRecord, SkillSourceRef, SkillStatus, type UsageReceipt, evidenceWatermark, fail, projectIdFromCwd, sessionCwd };
+//# sourceMappingURL=contracts.d.ts.map

package/lib/contracts.js

@@ -0,0 +1,42 @@
+import { CHAT_EVENTS_SLOT as CHAT_EVENTS_SLOT$1, projectIdFromCwd as projectIdFromCwd$1 } from "@klarkxy/dsh-ai-services/contracts";
+//#region src/contracts.ts
+/** Own records plus reexported frozen AI/Memory interfaces. */
+const CHAT_EVENTS_SLOT = CHAT_EVENTS_SLOT$1;
+const projectIdFromCwd = projectIdFromCwd$1;
+const SELF_IMPROVEMENT_RPC_CHANNEL = "/dsh-self-improvement";
+const SELF_IMPROVEMENT_PLUGIN = "@klarkxy/dsh-self-improvement";
+const SELF_IMPROVEMENT_SOURCE_KIND = "plugin:@klarkxy/dsh-self-improvement";
+/** Production activate identity. Core owns the scoped pluginName regex. */
+const SELF_IMPROVEMENT_ACTIVATE_ID = SELF_IMPROVEMENT_PLUGIN;
+const EXTRACT_PURPOSE = "self-improvement.extract";
+const LESSON_INJECTION_SECTION = "dsh-self-improvement:lessons";
+const LESSON_SCHEMA_TAG = "lesson-schema:1";
+const LESSON_SCHEMA_VERSION = 1;
+const MAX_INJECTED_LESSONS = 5;
+const MAX_INJECTION_TOKENS = 800;
+const MAX_PROJECT_ID_CHARS = 32768;
+const MAX_RECALL_QUERY_CHARS = 200;
+function evidenceWatermark(refs) {
+	return [...refs].map((ref) => `${ref.sessionId}:${ref.seq}:${ref.kind}`).sort().join("|");
+}
+function sessionCwd(session) {
+	if (!session || typeof session !== "object") return void 0;
+	const row = session;
+	const cwd = row.meta?.cwd ?? row.header?.cwd;
+	return typeof cwd === "string" ? cwd : void 0;
+}
+function fail(code, message) {
+	return {
+		ok: false,
+		error: {
+			code,
+			message
+		}
+	};
+}
+const MEMORY_UNAVAILABLE_MESSAGE = "记忆服务不可用。请先单独启用「记忆」插件；启用自我改进不会自动打开记忆。";
+const MEMORY_UNAVAILABLE_MESSAGE_EN = "Memory is unavailable. Enable the Memory plugin separately; turning on self-improvement does not enable Memory.";
+//#endregion
+export { CHAT_EVENTS_SLOT, EXTRACT_PURPOSE, LESSON_INJECTION_SECTION, LESSON_SCHEMA_TAG, LESSON_SCHEMA_VERSION, MAX_INJECTED_LESSONS, MAX_INJECTION_TOKENS, MAX_PROJECT_ID_CHARS, MAX_RECALL_QUERY_CHARS, MEMORY_UNAVAILABLE_MESSAGE, MEMORY_UNAVAILABLE_MESSAGE_EN, SELF_IMPROVEMENT_ACTIVATE_ID, SELF_IMPROVEMENT_PLUGIN, SELF_IMPROVEMENT_RPC_CHANNEL, SELF_IMPROVEMENT_SOURCE_KIND, evidenceWatermark, fail, projectIdFromCwd, sessionCwd };
+
+//# sourceMappingURL=contracts.js.map

package/lib/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","names":["FROZEN_CHAT_EVENTS_SLOT","sharedProjectIdFromCwd"],"sources":["../src/contracts.ts"],"sourcesContent":["/** Own records plus reexported frozen AI/Memory interfaces. */\nimport {\n  CHAT_EVENTS_SLOT as FROZEN_CHAT_EVENTS_SLOT,\n  projectIdFromCwd as sharedProjectIdFromCwd,\n} from '@klarkxy/dsh-ai-services/contracts'\nimport type {\n  AiFeatureScope,\n  AiServices,\n  AuxiliaryRequest,\n  AuxiliaryResult,\n  EvidenceRef,\n  KnowledgeKind,\n  KnowledgeScope,\n  MemoryMutationOptions,\n  MemoryQuery,\n  MemoryRecord,\n  MemoryService,\n  NewMemoryRecord,\n  PurposeSpec,\n  ProducerMessageSource,\n  RpcResult,\n  UsageReceipt,\n} from '@klarkxy/dsh-ai-services/contracts'\n\nexport type {\n  AiFeatureScope,\n  AiServices,\n  AuxiliaryRequest,\n  AuxiliaryResult,\n  EvidenceRef,\n  KnowledgeKind,\n  KnowledgeScope,\n  MemoryMutationOptions,\n  MemoryQuery,\n  MemoryRecord,\n  MemoryService,\n  NewMemoryRecord,\n  PurposeSpec,\n  ProducerMessageSource,\n  RpcResult,\n  UsageReceipt,\n}\n\nexport const CHAT_EVENTS_SLOT = FROZEN_CHAT_EVENTS_SLOT\nexport const projectIdFromCwd = sharedProjectIdFromCwd\nexport const SELF_IMPROVEMENT_RPC_CHANNEL = '/dsh-self-improvement'\nexport const SELF_IMPROVEMENT_PLUGIN = '@klarkxy/dsh-self-improvement'\nexport const SELF_IMPROVEMENT_SOURCE_KIND = 'plugin:@klarkxy/dsh-self-improvement' as const\n/** Production activate identity. Core owns the scoped pluginName regex. */\nexport const SELF_IMPROVEMENT_ACTIVATE_ID = SELF_IMPROVEMENT_PLUGIN\nexport const EXTRACT_PURPOSE = 'self-improvement.extract'\nexport const LESSON_INJECTION_SECTION = 'dsh-self-improvement:lessons'\nexport const LESSON_SCHEMA_TAG = 'lesson-schema:1'\nexport const LESSON_SCHEMA_VERSION = 1\nexport const MAX_INJECTED_LESSONS = 5\nexport const MAX_INJECTION_TOKENS = 800\nexport const MAX_PROJECT_ID_CHARS = 32_768\nexport const MAX_RECALL_QUERY_CHARS = 200\n\nexport type SkillStatus = 'preview' | 'accepted' | 'rejected' | 'revoked'\nexport type SkillExportState = 'none' | 'recorded' | 'revoked'\nexport interface SkillAuditEntry { at: number; action: string; detail?: string }\nexport interface SkillSourceRef {\n  id: string\n  revision: number\n  status: MemoryRecord['status']\n  scope: KnowledgeScope\n  expiresAt?: number\n}\nexport interface SkillRecord {\n  id: string\n  revision: number\n  status: SkillStatus\n  lessonIds: string[]\n  sources: SkillSourceRef[]\n  title: string\n  markdown: string\n  createdAt: number\n  updatedAt: number\n  exportState: SkillExportState\n  exportedAt?: number\n  exportRevokedAt?: number\n  exportFilename?: string\n  audit: SkillAuditEntry[]\n}\nexport interface SessionWatermark {\n  sessionId: string\n  seq: number\n  projectId?: string\n  updatedAt: number\n}\n\nexport type LessonTriggerKind = 'human-correction' | 'verified-tool-fix' | 'manual'\nexport interface LessonTrigger {\n  kind: LessonTriggerKind\n  evidence: EvidenceRef[]\n  titleHint: string\n  contentHint: string\n  toolName?: string\n}\n\nexport interface LessonInjectPayload {\n  source: ProducerMessageSource & {\n    kind: typeof SELF_IMPROVEMENT_SOURCE_KIND\n    plugin: typeof SELF_IMPROVEMENT_PLUGIN\n    form: 'snapshot'\n    sections: Array<{ name: string; text: string }>\n  }\n  content: Array<{ type: 'text'; text: string }>\n}\n\nexport interface PreStepEnter { kind: 'enter'; messages: unknown[]; startsRequestSeries?: true }\nexport type PreStepDecision = { kind: 'reject' } | PreStepEnter\n\nexport interface ReviewSnapshot {\n  memoryAvailable: boolean\n  memoryMessage?: string\n  projectId?: string\n  generation: number\n  storageFailed: boolean\n  lessons: MemoryRecord[]\n  skills: SkillRecord[]\n  /** True while an extract for this session (or any session, if none requested) is queued or in flight. */\n  extracting?: boolean\n}\n\nexport function evidenceWatermark(refs: readonly EvidenceRef[]): string {\n  return [...refs].map(ref => `${ref.sessionId}:${ref.seq}:${ref.kind}`).sort().join('|')\n}\n\nexport function sessionCwd(session: unknown): string | undefined {\n  if (!session || typeof session !== 'object') return undefined\n  const row = session as { meta?: { cwd?: unknown }; header?: { cwd?: unknown } }\n  const cwd = row.meta?.cwd ?? row.header?.cwd\n  return typeof cwd === 'string' ? cwd : undefined\n}\n\nexport function fail(code: string, message: string): RpcResult<never> {\n  return { ok: false, error: { code, message } }\n}\n\nexport const MEMORY_UNAVAILABLE_MESSAGE = '记忆服务不可用。请先单独启用「记忆」插件；启用自我改进不会自动打开记忆。'\nexport const MEMORY_UNAVAILABLE_MESSAGE_EN = 'Memory is unavailable. Enable the Memory plugin separately; turning on self-improvement does not enable Memory.'\n"],"mappings":";;;AA2CA,MAAa,mBAAmBA;AAChC,MAAa,mBAAmBC;AAChC,MAAa,+BAA+B;AAC5C,MAAa,0BAA0B;AACvC,MAAa,+BAA+B;;AAE5C,MAAa,+BAA+B;AAC5C,MAAa,kBAAkB;AAC/B,MAAa,2BAA2B;AACxC,MAAa,oBAAoB;AACjC,MAAa,wBAAwB;AACrC,MAAa,uBAAuB;AACpC,MAAa,uBAAuB;AACpC,MAAa,uBAAuB;AACpC,MAAa,yBAAyB;AAqEtC,SAAgB,kBAAkB,MAAsC;CACtE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,KAAI,QAAO,GAAG,IAAI,UAAU,GAAG,IAAI,IAAI,GAAG,IAAI,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG;AACxF;AAEA,SAAgB,WAAW,SAAsC;CAC/D,IAAI,CAAC,WAAW,OAAO,YAAY,UAAU,OAAO,KAAA;CACpD,MAAM,MAAM;CACZ,MAAM,MAAM,IAAI,MAAM,OAAO,IAAI,QAAQ;CACzC,OAAO,OAAO,QAAQ,WAAW,MAAM,KAAA;AACzC;AAEA,SAAgB,KAAK,MAAc,SAAmC;CACpE,OAAO;EAAE,IAAI;EAAO,OAAO;GAAE;GAAM;EAAQ;CAAE;AAC/C;AAEA,MAAa,6BAA6B;AAC1C,MAAa,gCAAgC"}

package/lib/index.d.ts

@@ -0,0 +1,118 @@
+import { AiServices, CHAT_EVENTS_SLOT, MemoryRecord, MemoryService, PreStepDecision, ReviewSnapshot, RpcResult, SELF_IMPROVEMENT_RPC_CHANNEL, SessionWatermark, SkillRecord } from "./contracts.js";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/detect.d.ts
+interface SessionEventLike {
+  type: string;
+  seq: number;
+  data: unknown;
+}
+//#endregion
+//#region src/engine.d.ts
+interface KvTableLike<V> {
+  get(key: string): V | undefined;
+  entries(): IterableIterator<[string, V]>;
+  put(key: string, value: V): Promise<void>;
+}
+interface SessionLike {
+  id?: unknown;
+  header?: {
+    cwd?: string;
+  };
+  meta?: {
+    cwd?: string;
+  };
+  snapshotEvents(): readonly SessionEventLike[];
+}
+interface EngineOptions {
+  memory: () => MemoryService | undefined;
+  ai: () => Pick<AiServices, 'activate'> | undefined;
+  sessionOf: (sessionId: string) => SessionLike | undefined;
+  skills: KvTableLike<SkillRecord>;
+  watermarks: KvTableLike<SessionWatermark>;
+  now?: () => number;
+}
+declare class SelfImprovementEngine {
+  private readonly options;
+  private generation;
+  private active;
+  private lifetime;
+  private storageFailed;
+  private chain;
+  private readonly extractJobs;
+  private aiScope;
+  private seenProjects;
+  private readonly now;
+  constructor(options: EngineOptions);
+  getGeneration(): number;
+  isActive(): boolean;
+  dispose(): void;
+  private memoryOrError;
+  private asMemory;
+  private requireActive;
+  private persist;
+  private currentSignal;
+  private rememberProject;
+  private knownProjectIds;
+  private sameMemory;
+  private beginWork;
+  private isWork;
+  /** Linearize disable/replace against captured generation + Memory. Never start a new write after this fails. */
+  private revalidate;
+  private failed;
+  private mutationGuards;
+  private isGuardRejection;
+  /** Invoke a Memory/Skill write only while still current. Queued Memory work receives captured generation/identity + lifetime abort. An already-started write is not rolled back; the RPC still fails if we are no longer current after it. */
+  private mutateWhileCurrent;
+  private rejectionOrThrow;
+  listAllLessons(projectId?: string, expectedMemory?: MemoryService): Promise<MemoryRecord[]>;
+  currentRequestText(session: SessionLike, decision?: PreStepDecision): string;
+  recordsForInjection(projectId: string | undefined, requestText: string, expectedMemory?: MemoryService): Promise<MemoryRecord[]>;
+  applyPreStep(session: SessionLike, decision: PreStepDecision, signal: AbortSignal): Promise<PreStepDecision>;
+  private writeWatermark;
+  private ensureAi;
+  private draftTrigger;
+  private noteExtractStart;
+  private noteExtractEnd;
+  private isExtracting;
+  private enqueue;
+  /** Queue auto and manual extract on the existing chain. Counts rise synchronously at request entry. */
+  private enqueueExtract;
+  extractFromSession(session: SessionLike, signal: AbortSignal, mode?: 'auto' | 'manual'): Promise<RpcResult<{
+    created: MemoryRecord[];
+    skipped: number;
+  }>>;
+  considerSession(session: SessionLike, signal: AbortSignal): Promise<void>;
+  private runExtractFromSession;
+  private requireLesson;
+  acceptLesson(id: string, expectedRevision: number, scope: 'project' | 'global', currentProjectId?: string): Promise<RpcResult<MemoryRecord>>;
+  setLessonStatus(id: string, expectedRevision: number, status: 'rejected' | 'revoked', extraProjectId?: string): Promise<RpcResult<MemoryRecord>>;
+  private skills;
+  private liveSkillLessons;
+  previewSkill(lessonIds: string[]): Promise<RpcResult<SkillRecord>>;
+  private skillOrError;
+  private requireCurrentSkillSources;
+  patchSkill(id: string, expectedRevision: number, patch: (current: SkillRecord) => SkillRecord): Promise<RpcResult<SkillRecord>>;
+  acceptSkill(id: string, expectedRevision: number): Promise<RpcResult<SkillRecord>>;
+  prepareSkillExport(id: string, expectedRevision: number): Promise<RpcResult<{
+    filename: string;
+    markdown: string;
+    skill: SkillRecord;
+  }>>;
+  recordSkillExport(id: string, expectedRevision: number, filename: string): Promise<RpcResult<SkillRecord>>;
+  snapshot(sessionId?: string): Promise<RpcResult<ReviewSnapshot>>;
+  call(endpoint: string, payload: unknown, signal: AbortSignal): Promise<RpcResult>;
+}
+//#endregion
+//#region src/index.d.ts
+declare const name = "@klarkxy/dsh-self-improvement";
+declare const inject: readonly ["storageDomain", "connection", "webServer"];
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    selfImprovement: SelfImprovementEngine;
+  }
+}
+declare function listen(ctx: Context, name: string, handler: (...args: never[]) => unknown): (() => void) | undefined;
+declare function apply(ctx: Context): Promise<void>;
+//#endregion
+export { CHAT_EVENTS_SLOT, SELF_IMPROVEMENT_RPC_CHANNEL, SelfImprovementEngine, apply, inject, listen, name };
+//# sourceMappingURL=index.d.ts.map