dsh-daoing-memory 0.1.17 → 0.1.18

package/lib/client.js

@@ -8632,61 +8632,61 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			document.head.appendChild(tag);
 		}
 		var Workbench_module_css_default = {
-			"tabs": "vPI34G_tabs",
-			"statusChallenged": "vPI34G_statusChallenged",
-			"body": "vPI34G_body",
-			"check": "vPI34G_check",
-			"trust": "vPI34G_trust",
-			"cardSub": "vPI34G_cardSub",
-			"payloadFull": "vPI34G_payloadFull",
-			"tabActive": "vPI34G_tabActive",
-			"badgeConflict": "vPI34G_badgeConflict",
+			"cardDetail": "vPI34G_cardDetail",
+			"btnDanger": "vPI34G_btnDanger",
+			"warnLine": "vPI34G_warnLine",
+			"badgePinned": "vPI34G_badgePinned",
+			"workbenchTabs": "vPI34G_workbenchTabs",
+			"cardMeta": "vPI34G_cardMeta",
 			"actions": "vPI34G_actions",
-			"columns": "vPI34G_columns",
-			"sectionTitle": "vPI34G_sectionTitle",
-			"workbenchTabActive": "vPI34G_workbenchTabActive",
-			"subtitle": "vPI34G_subtitle",
-			"toolbar": "vPI34G_toolbar",
-			"okLine": "vPI34G_okLine",
+			"statusCandidate": "vPI34G_statusCandidate",
+			"title": "vPI34G_title",
+			"titleBlock": "vPI34G_titleBlock",
 			"cardHead": "vPI34G_cardHead",
+			"badge": "vPI34G_badge",
+			"badgeNegative": "vPI34G_badgeNegative",
+			"detailLabel": "vPI34G_detailLabel",
+			"toolbar": "vPI34G_toolbar",
+			"cardSub": "vPI34G_cardSub",
+			"statusOther": "vPI34G_statusOther",
+			"trust": "vPI34G_trust",
+			"header": "vPI34G_header",
 			"concernBg": "vPI34G_concernBg",
-			"badgePinned": "vPI34G_badgePinned",
-			"workbenchTabs": "vPI34G_workbenchTabs",
-			"rules": "vPI34G_rules",
+			"panel": "vPI34G_panel",
+			"workbenchTabActive": "vPI34G_workbenchTabActive",
+			"error": "vPI34G_error",
+			"okLine": "vPI34G_okLine",
+			"page": "vPI34G_page",
+			"payloadFull": "vPI34G_payloadFull",
+			"payloadToggle": "vPI34G_payloadToggle",
+			"badgeConflict": "vPI34G_badgeConflict",
+			"btn": "vPI34G_btn",
+			"badgePositive": "vPI34G_badgePositive",
+			"statusLive": "vPI34G_statusLive",
+			"table": "vPI34G_table",
+			"statusChallenged": "vPI34G_statusChallenged",
+			"historyTitle": "vPI34G_historyTitle",
 			"workbenchTab": "vPI34G_workbenchTab",
+			"tab": "vPI34G_tab",
+			"field": "vPI34G_field",
 			"valueCell": "vPI34G_valueCell",
+			"card": "vPI34G_card",
+			"tabActive": "vPI34G_tabActive",
+			"tabs": "vPI34G_tabs",
+			"column": "vPI34G_column",
+			"sectionTitle": "vPI34G_sectionTitle",
 			"statline": "vPI34G_statline",
+			"check": "vPI34G_check",
 			"cardTitle": "vPI34G_cardTitle",
-			"btn": "vPI34G_btn",
-			"list": "vPI34G_list",
+			"subtitle": "vPI34G_subtitle",
+			"detailRow": "vPI34G_detailRow",
 			"form": "vPI34G_form",
-			"cardMeta": "vPI34G_cardMeta",
-			"page": "vPI34G_page",
-			"cardDetail": "vPI34G_cardDetail",
-			"badge": "vPI34G_badge",
-			"warnLine": "vPI34G_warnLine",
-			"historyTitle": "vPI34G_historyTitle",
-			"tab": "vPI34G_tab",
+			"body": "vPI34G_body",
+			"list": "vPI34G_list",
 			"cellActions": "vPI34G_cellActions",
-			"statusOther": "vPI34G_statusOther",
-			"card": "vPI34G_card",
-			"table": "vPI34G_table",
-			"titleBlock": "vPI34G_titleBlock",
-			"statusLive": "vPI34G_statusLive",
-			"statusCandidate": "vPI34G_statusCandidate",
-			"column": "vPI34G_column",
-			"detailLabel": "vPI34G_detailLabel",
-			"btnDanger": "vPI34G_btnDanger",
 			"empty": "vPI34G_empty",
-			"panel": "vPI34G_panel",
-			"badgePositive": "vPI34G_badgePositive",
-			"detailRow": "vPI34G_detailRow",
-			"header": "vPI34G_header",
-			"field": "vPI34G_field",
-			"error": "vPI34G_error",
-			"title": "vPI34G_title",
-			"payloadToggle": "vPI34G_payloadToggle",
-			"badgeNegative": "vPI34G_badgeNegative"
+			"columns": "vPI34G_columns",
+			"rules": "vPI34G_rules"
 		};
 		//#endregion
 		//#region lib/types/client/ExperiencePage.js
@@ -9328,17 +9328,17 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			document.head.appendChild(tag);
 		}
 		var ReasonDialog_module_css_default = {
-			"overlay": "HH3IWW_overlay",
-			"dialog": "HH3IWW_dialog",
+			"btnConfirm": "HH3IWW_btnConfirm",
+			"title": "HH3IWW_title",
+			"hint": "HH3IWW_hint",
 			"footer": "HH3IWW_footer",
 			"textarea": "HH3IWW_textarea",
 			"buttons": "HH3IWW_buttons",
-			"btnConfirm": "HH3IWW_btnConfirm",
-			"btnCancel": "HH3IWW_btnCancel",
-			"title": "HH3IWW_title",
 			"subtitle": "HH3IWW_subtitle",
+			"dialog": "HH3IWW_dialog",
+			"overlay": "HH3IWW_overlay",
 			"header": "HH3IWW_header",
-			"hint": "HH3IWW_hint"
+			"btnCancel": "HH3IWW_btnCancel"
 		};
 		//#endregion
 		//#region lib/types/client/ReasonDialog.js

package/lib/index.js

@@ -14,7 +14,7 @@ import { Remote, TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
 * @module dsh-daoing-memory/store
 */
 /** Monotone store schema version. v1→v2 is an additive ALTER migration (see open()). */
-const MEMORY_SCHEMA_VERSION = 6;
+const MEMORY_SCHEMA_VERSION = 7;
 /** Half-life (ms) of the recency weighting applied to verification samples. */
 const TRUST_HALF_LIFE_MS = 4320 * 60 * 60 * 1e3;
 /** Hash one ledger block's content, chained to the previous hash. */
@@ -87,6 +87,7 @@ var MemoryStore = class {
         verified_count INTEGER NOT NULL DEFAULT 0,
         reject_count INTEGER NOT NULL DEFAULT 0,
         global_flag INTEGER NOT NULL DEFAULT 0,
+        approved_by TEXT NOT NULL DEFAULT '',
         created_at INTEGER NOT NULL,
         updated_at INTEGER NOT NULL,
         PRIMARY KEY (family_id, revision)
@@ -184,7 +185,7 @@ var MemoryStore = class {
       );
     `);
 		const row = db.prepare("SELECT value FROM memory_meta WHERE key = ?").get("schema_version");
-		if (row === void 0) db.prepare("INSERT INTO memory_meta (key, value) VALUES (?, ?)").run("schema_version", String(6));
+		if (row === void 0) db.prepare("INSERT INTO memory_meta (key, value) VALUES (?, ?)").run("schema_version", String(7));
 		else {
 			let v = Number(row.value);
 			if (v === 1) {
@@ -225,8 +226,12 @@ var MemoryStore = class {
         `);
 				v = 6;
 			}
-			if (v !== 6) throw new Error(`memory store schema version ${row.value} does not match 6; refusing to open`);
-			db.prepare("UPDATE memory_meta SET value = ? WHERE key = ?").run(String(6), "schema_version");
+			if (v === 6 && true) {
+				db.exec("ALTER TABLE experiences ADD COLUMN approved_by TEXT NOT NULL DEFAULT '';");
+				v = 7;
+			}
+			if (v !== 7) throw new Error(`memory store schema version ${row.value} does not match 7; refusing to open`);
+			db.prepare("UPDATE memory_meta SET value = ? WHERE key = ?").run(String(7), "schema_version");
 		}
 		db.exec("CREATE INDEX IF NOT EXISTS idx_exp_context ON experiences (context);");
 		db.exec("CREATE INDEX IF NOT EXISTS idx_concern_parent ON concerns (parent_id);");
@@ -238,8 +243,8 @@ var MemoryStore = class {
         family_id, revision, kind, source, family, gist, situation, path, reasoning, limits,
         status, alpha, beta, last_verified_at, pinned, tokens_saved, tokens_spent,
         parent_revision, failure_reason, evidence, challenge_reason, deleted,
-        context, verified_count, reject_count, global_flag, created_at, updated_at
-      ) VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,0,?,?,?,?,?,?)
+        context, verified_count, reject_count, global_flag, approved_by, created_at, updated_at
+      ) VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,0,?,?,?,?,?,?,?)
       ON CONFLICT (family_id, revision) DO UPDATE SET
         kind = excluded.kind,
         source = excluded.source,
@@ -264,8 +269,9 @@ var MemoryStore = class {
         verified_count = excluded.verified_count,
         reject_count = excluded.reject_count,
         global_flag = excluded.global_flag,
+        approved_by = excluded.approved_by,
         updated_at = excluded.updated_at
-    `).run(s.id, s.revision, s.kind, s.source, s.family, s.gist, JSON.stringify(s.situation), JSON.stringify(s.path), s.reasoning, JSON.stringify(s.limits), s.status, s.alpha, s.beta, s.lastVerifiedAt ?? null, s.pinned ? 1 : 0, s.tokensSaved, s.tokensSpent, s.parentRevision ?? null, s.failureReason ?? null, s.evidence === void 0 ? null : JSON.stringify(s.evidence), s.challengeReason ?? null, s.context ?? "", s.verifiedCount ?? 0, s.rejectCount ?? 0, s.globalFlag === true ? 1 : 0, s.createdAt, s.updatedAt);
+    `).run(s.id, s.revision, s.kind, s.source, s.family, s.gist, JSON.stringify(s.situation), JSON.stringify(s.path), s.reasoning, JSON.stringify(s.limits), s.status, s.alpha, s.beta, s.lastVerifiedAt ?? null, s.pinned ? 1 : 0, s.tokensSaved, s.tokensSpent, s.parentRevision ?? null, s.failureReason ?? null, s.evidence === void 0 ? null : JSON.stringify(s.evidence), s.challengeReason ?? null, s.context ?? "", s.verifiedCount ?? 0, s.rejectCount ?? 0, s.globalFlag === true ? 1 : 0, s.approvedBy ?? "", s.createdAt, s.updatedAt);
 	}
 	/** Read one experience revision. */
 	getExperience(familyId, revision) {
@@ -820,6 +826,7 @@ var MemoryStore = class {
 		if (row.failure_reason !== null) snapshot.failureReason = row.failure_reason;
 		if (row.evidence !== null) snapshot.evidence = JSON.parse(row.evidence);
 		if (row.challenge_reason !== null) snapshot.challengeReason = row.challenge_reason;
+		if (row.approved_by === "human" || row.approved_by === "agent") snapshot.approvedBy = row.approved_by;
 		return snapshot;
 	}
 	rowToReport(row) {
@@ -1407,7 +1414,8 @@ var MemoryCore = class MemoryCore {
 			if (next.status === "candidate" && next.parentRevision !== void 0) {
 				const adopted = {
 					...next,
-					status: "live"
+					status: "live",
+					approvedBy: "agent"
 				};
 				delete adopted.challengeReason;
 				next = adopted;
@@ -1423,7 +1431,8 @@ var MemoryCore = class MemoryCore {
 			} else if (next.status === "candidate") {
 				next = {
 					...next,
-					status: "live"
+					status: "live",
+					approvedBy: "agent"
 				};
 				this.ledger("promote", "experience", next.id, actor, {
 					revision: next.revision,
@@ -1433,7 +1442,8 @@ var MemoryCore = class MemoryCore {
 			} else if (next.status === "archived") {
 				next = {
 					...next,
-					status: "live"
+					status: "live",
+					approvedBy: "agent"
 				};
 				this.ledger("restore", "experience", next.id, actor, { revision: next.revision });
 				base.promoted = true;
@@ -2292,6 +2302,7 @@ var MemoryCore = class MemoryCore {
 			verifiedCount: 0,
 			rejectCount: 0,
 			globalFlag: false,
+			approvedBy: "human",
 			createdAt: now,
 			updatedAt: now
 		};
@@ -2312,6 +2323,7 @@ var MemoryCore = class MemoryCore {
 		const next = {
 			...current,
 			status: "live",
+			approvedBy: "human",
 			lastVerifiedAt: Date.now(),
 			updatedAt: Date.now()
 		};
@@ -2334,6 +2346,38 @@ var MemoryCore = class MemoryCore {
 		this.ledger("release-cold", "experience", next.id, actor, { revision: next.revision }, request.reason);
 		return next;
 	}
+	/** Human-approved self-growth: merge new evidence into a live, human-approved
+	*  experience as an incremental new revision (revision+1, parent superseded).
+	*  Only approvedBy='human' + status='live' may evolve; agent/system-approved
+	*  and non-live (challenged/cold/archived) are rejected. */
+	evolve(request, actor) {
+		const current = this.store.getActiveRevision(request.id);
+		if (current === void 0) throw new Error(`memory: experience not found: ${request.id}`);
+		if (current.approvedBy !== "human") throw new Error(`memory: only human-approved experiences evolve (approvedBy=${String(current.approvedBy)})`);
+		if (current.status !== "live") throw new Error(`memory: only live experiences evolve (status=${current.status})`);
+		const situation = request.situation === void 0 ? current.situation : [...new Set([...current.situation, ...request.situation])];
+		const limits = request.limits === void 0 ? current.limits : [...new Set([...current.limits, ...request.limits])];
+		const now = Date.now();
+		const next = {
+			...current,
+			revision: current.revision + 1,
+			status: "live",
+			parentRevision: current.revision,
+			gist: request.gist ?? current.gist,
+			situation,
+			path: request.path ?? current.path,
+			reasoning: request.reasoning ?? current.reasoning,
+			limits,
+			updatedAt: now
+		};
+		this.store.upsertExperience(next);
+		this.supersedeParent(next, actor);
+		this.ledger("evolve", "experience", next.id, actor, {
+			revision: next.revision,
+			by: current.revision
+		}, request.reason);
+		return next;
+	}
 	/** Human acknowledgement of a pending diary entry: reviewed, no fact extracted. */
 	humanAckDiary(request, actor) {
 		const entry = this.store.getDiary(request.diaryId);
@@ -3629,6 +3673,7 @@ let MemoryService = (() => {
 	let _humanEditExperience_decorators;
 	let _humanAddExperience_decorators;
 	let _humanPromote_decorators;
+	let _evolve_decorators;
 	let _humanReleaseCold_decorators;
 	let _humanRollback_decorators;
 	let _humanAddFact_decorators;
@@ -3683,6 +3728,7 @@ let MemoryService = (() => {
 			_humanEditExperience_decorators = [Remote("humanEditExperience")];
 			_humanAddExperience_decorators = [Remote("humanAddExperience")];
 			_humanPromote_decorators = [Remote("humanPromote")];
+			_evolve_decorators = [Remote("evolve")];
 			_humanReleaseCold_decorators = [Remote("humanReleaseCold")];
 			_humanRollback_decorators = [Remote("humanRollback")];
 			_humanAddFact_decorators = [Remote("humanAddFact")];
@@ -4094,6 +4140,17 @@ let MemoryService = (() => {
 				},
 				metadata: _metadata
 			}, null, _instanceExtraInitializers);
+			__esDecorate(this, null, _evolve_decorators, {
+				kind: "method",
+				name: "evolve",
+				static: false,
+				private: false,
+				access: {
+					has: (obj) => "evolve" in obj,
+					get: (obj) => obj.evolve
+				},
+				metadata: _metadata
+			}, null, _instanceExtraInitializers);
 			__esDecorate(this, null, _humanReleaseCold_decorators, {
 				kind: "method",
 				name: "humanReleaseCold",
@@ -4528,6 +4585,9 @@ ${deletionList}
 		humanPromote(agent, id, reason) {
 			return this.core.humanPromote(id, reason, "human");
 		}
+		evolve(agent, request) {
+			return this.core.evolve(request, "human");
+		}
 		/** Human re-release of a cold-palace revision back to candidate (006 §3.2). */
 		humanReleaseCold(agent, request) {
 			return this.core.humanReleaseCold(request, "human");

package/lib/types/core.d.ts

@@ -20,7 +20,7 @@
  *
  * @module dsh-daoing-memory/core
  */
-import type { ConcernTree, ConsolidateRequest, ConsolidateResult, DiaryAppendRequest, DiaryAppendResult, DiaryEntry, ExperienceListFilter, ExperienceSnapshot, ExtractionRecord, ExtractFactsRequest, ExtractFactsResult, FactEntry, HumanAddExperienceRequest, HumanAddFactRequest, HumanAckDiaryRequest, HumanArchiveExperienceRequest, HumanConfirmFactRequest, HumanDeleteConcernRequest, HumanDeleteExperienceRequest, HumanDeleteFactRequest, HumanEditExperienceRequest, HumanEditFactRequest, HumanPinRequest, HumanSetConcernStatusRequest, HumanReleaseColdRequest, IngestRequest, IngestResult, LedgerIntegrityResult, LedgerQueryRequest, MemoryExport, MemoryStats, RecallExperiencesRequest, RecallExperiencesResult, RefineExperienceRequest, RefineExperienceResult, ReportUseRequest, ReportUseResult, ReviseExperienceRequest, RollbackExperienceRequest, VerifyShadowRequest, VerifyShadowResult, SkillArtifact, SkillForm, SkillStatus, ReviewSkillRequest, PublishSkillRequest } from './types.ts';
+import type { ConcernTree, ConsolidateRequest, ConsolidateResult, DiaryAppendRequest, DiaryAppendResult, DiaryEntry, ExperienceListFilter, ExperienceSnapshot, ExtractionRecord, ExtractFactsRequest, ExtractFactsResult, FactEntry, EvolveExperienceRequest, HumanAddExperienceRequest, HumanAddFactRequest, HumanAckDiaryRequest, HumanArchiveExperienceRequest, HumanConfirmFactRequest, HumanDeleteConcernRequest, HumanDeleteExperienceRequest, HumanDeleteFactRequest, HumanEditExperienceRequest, HumanEditFactRequest, HumanPinRequest, HumanSetConcernStatusRequest, HumanReleaseColdRequest, IngestRequest, IngestResult, LedgerIntegrityResult, LedgerQueryRequest, MemoryExport, MemoryStats, RecallExperiencesRequest, RecallExperiencesResult, RefineExperienceRequest, RefineExperienceResult, ReportUseRequest, ReportUseResult, ReviseExperienceRequest, RollbackExperienceRequest, VerifyShadowRequest, VerifyShadowResult, SkillArtifact, SkillForm, SkillStatus, ReviewSkillRequest, PublishSkillRequest } from './types.ts';
 import { MemoryStore } from './store.ts';
 /** Tunable mechanism parameters, all overridable from the plugin config. */
 export interface MemoryCoreConfig {
@@ -234,6 +234,11 @@ export declare class MemoryCore {
     humanPromote(id: string, reason: string, actor: MemoryActor): ExperienceSnapshot;
     /** Human re-release (006 §3.2): move a cold-palace revision back to candidate. */
     humanReleaseCold(request: HumanReleaseColdRequest, actor: MemoryActor): ExperienceSnapshot;
+    /** Human-approved self-growth: merge new evidence into a live, human-approved
+     *  experience as an incremental new revision (revision+1, parent superseded).
+     *  Only approvedBy='human' + status='live' may evolve; agent/system-approved
+     *  and non-live (challenged/cold/archived) are rejected. */
+    evolve(request: EvolveExperienceRequest, actor: MemoryActor): ExperienceSnapshot;
     /** Human acknowledgement of a pending diary entry: reviewed, no fact extracted. */
     humanAckDiary(request: HumanAckDiaryRequest, actor: MemoryActor): DiaryEntry;
     /** Human lifecycle change of a top-level concern (007 §2.4, audited). */

package/lib/types/core.js

@@ -428,7 +428,7 @@ export class MemoryCore {
         if (request.outcome === 'success' && attribution === 'experience') {
             if (next.status === 'candidate' && next.parentRevision !== undefined) {
                 // Revised draft passed its one successful use: adopt it.
-                const adopted = { ...next, status: 'live' };
+                const adopted = { ...next, status: 'live', approvedBy: 'agent' };
                 delete adopted.challengeReason;
                 next = adopted;
                 this.store.upsertExperience(next);
@@ -439,13 +439,13 @@ export class MemoryCore {
                 base.promoted = true;
             }
             else if (next.status === 'candidate') {
-                next = { ...next, status: 'live' };
+                next = { ...next, status: 'live', approvedBy: 'agent' };
                 this.ledger('promote', 'experience', next.id, actor, { revision: next.revision, via: 'use' });
                 base.promoted = true;
             }
             else if (next.status === 'archived') {
                 // Found via deep recall and used successfully once: back to live.
-                next = { ...next, status: 'live' };
+                next = { ...next, status: 'live', approvedBy: 'agent' };
                 this.ledger('restore', 'experience', next.id, actor, { revision: next.revision });
                 base.promoted = true;
             }
@@ -1282,6 +1282,7 @@ export class MemoryCore {
             verifiedCount: 0,
             rejectCount: 0,
             globalFlag: false,
+            approvedBy: 'human',
             createdAt: now,
             updatedAt: now,
         };
@@ -1303,7 +1304,7 @@ export class MemoryCore {
         if (current.status !== 'candidate') {
             throw new Error(`memory: only candidates accept human promotion (status=${current.status})`);
         }
-        const next = { ...current, status: 'live', lastVerifiedAt: Date.now(), updatedAt: Date.now() };
+        const next = { ...current, status: 'live', approvedBy: 'human', lastVerifiedAt: Date.now(), updatedAt: Date.now() };
         this.store.upsertExperience(next);
         if (next.parentRevision !== undefined)
             this.supersedeParent(next, actor);
@@ -1323,6 +1324,40 @@ export class MemoryCore {
         this.ledger('release-cold', 'experience', next.id, actor, { revision: next.revision }, request.reason);
         return next;
     }
+    /** Human-approved self-growth: merge new evidence into a live, human-approved
+     *  experience as an incremental new revision (revision+1, parent superseded).
+     *  Only approvedBy='human' + status='live' may evolve; agent/system-approved
+     *  and non-live (challenged/cold/archived) are rejected. */
+    evolve(request, actor) {
+        const current = this.store.getActiveRevision(request.id);
+        if (current === undefined)
+            throw new Error(`memory: experience not found: ${request.id}`);
+        if (current.approvedBy !== 'human') {
+            throw new Error(`memory: only human-approved experiences evolve (approvedBy=${String(current.approvedBy)})`);
+        }
+        if (current.status !== 'live') {
+            throw new Error(`memory: only live experiences evolve (status=${current.status})`);
+        }
+        const situation = request.situation === undefined ? current.situation : [...new Set([...current.situation, ...request.situation])];
+        const limits = request.limits === undefined ? current.limits : [...new Set([...current.limits, ...request.limits])];
+        const now = Date.now();
+        const next = {
+            ...current,
+            revision: current.revision + 1,
+            status: 'live',
+            parentRevision: current.revision,
+            gist: request.gist ?? current.gist,
+            situation,
+            path: request.path ?? current.path,
+            reasoning: request.reasoning ?? current.reasoning,
+            limits,
+            updatedAt: now,
+        };
+        this.store.upsertExperience(next);
+        this.supersedeParent(next, actor);
+        this.ledger('evolve', 'experience', next.id, actor, { revision: next.revision, by: current.revision }, request.reason);
+        return next;
+    }
     /** Human acknowledgement of a pending diary entry: reviewed, no fact extracted. */
     humanAckDiary(request, actor) {
         const entry = this.store.getDiary(request.diaryId);

package/lib/types/service.d.ts

@@ -9,7 +9,7 @@ import type { Context } from '@deepseek-ai/cordis';
 import type { Agent } from '@deepseek-ai/dsh-agent';
 import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
 import type { MemoryCore } from './core.ts';
-import type { ConcernTree, ConsolidateRequest, ConsolidateResult, DiaryAppendRequest, DiaryAppendResult, DiaryEntry, ExperienceListFilter, ExperienceSnapshot, ExtractionRecord, ExtractFactsRequest, ExtractFactsResult, FactEntry, GenerateSkillDraftRequest, HumanAddExperienceRequest, HumanAddFactRequest, HumanAckDiaryRequest, HumanConfirmFactRequest, HumanArchiveExperienceRequest, HumanDeleteConcernRequest, HumanDeleteExperienceRequest, HumanDeleteFactRequest, HumanEditExperienceRequest, HumanEditFactRequest, HumanPinRequest, HumanReleaseColdRequest, HumanSetConcernStatusRequest, IngestRequest, IngestResult, LedgerBlock, LedgerIntegrityResult, LedgerQueryRequest, MemoryExport, MemoryStats, MemoryWorkbenchInfo, PublishSkillRequest, RecallExperiencesRequest, RecallExperiencesResult, RefineExperienceRequest, RefineExperienceResult, ReportUseRequest, ReportUseResult, ReviewSkillRequest, ReviseExperienceRequest, RollbackExperienceRequest, SkillArtifact, VerifyShadowRequest, VerifyShadowResult } from './types.ts';
+import type { ConcernTree, ConsolidateRequest, ConsolidateResult, DiaryAppendRequest, DiaryAppendResult, DiaryEntry, ExperienceListFilter, ExperienceSnapshot, ExtractionRecord, ExtractFactsRequest, ExtractFactsResult, FactEntry, GenerateSkillDraftRequest, EvolveExperienceRequest, HumanAddExperienceRequest, HumanAddFactRequest, HumanAckDiaryRequest, HumanConfirmFactRequest, HumanArchiveExperienceRequest, HumanDeleteConcernRequest, HumanDeleteExperienceRequest, HumanDeleteFactRequest, HumanEditExperienceRequest, HumanEditFactRequest, HumanPinRequest, HumanReleaseColdRequest, HumanSetConcernStatusRequest, IngestRequest, IngestResult, LedgerBlock, LedgerIntegrityResult, LedgerQueryRequest, MemoryExport, MemoryStats, MemoryWorkbenchInfo, PublishSkillRequest, RecallExperiencesRequest, RecallExperiencesResult, RefineExperienceRequest, RefineExperienceResult, ReportUseRequest, ReportUseResult, ReviewSkillRequest, ReviseExperienceRequest, RollbackExperienceRequest, SkillArtifact, VerifyShadowRequest, VerifyShadowResult } from './types.ts';
 /**
  * Remote face of the memory library. All methods delegate to the core; the
  * core carries the 生·用·修·记 mechanism semantics.
@@ -142,6 +142,7 @@ export declare class MemoryService extends TypertRemoteService {
     humanAddExperience(agent: Agent, request: HumanAddExperienceRequest): ExperienceSnapshot;
     /** Human authority (V2): promote a candidate straight to live. */
     humanPromote(agent: Agent, id: string, reason: string): ExperienceSnapshot;
+    evolve(agent: Agent, request: EvolveExperienceRequest): ExperienceSnapshot;
     /** Human re-release of a cold-palace revision back to candidate (006 §3.2). */
     humanReleaseCold(agent: Agent, request: HumanReleaseColdRequest): ExperienceSnapshot;
     /** Human rollback. */

package/lib/types/service.js

@@ -92,6 +92,7 @@ let MemoryService = (() => {
     let _humanEditExperience_decorators;
     let _humanAddExperience_decorators;
     let _humanPromote_decorators;
+    let _evolve_decorators;
     let _humanReleaseCold_decorators;
     let _humanRollback_decorators;
     let _humanAddFact_decorators;
@@ -146,6 +147,7 @@ let MemoryService = (() => {
             _humanEditExperience_decorators = [Remote('humanEditExperience')];
             _humanAddExperience_decorators = [Remote('humanAddExperience')];
             _humanPromote_decorators = [Remote('humanPromote')];
+            _evolve_decorators = [Remote('evolve')];
             _humanReleaseCold_decorators = [Remote('humanReleaseCold')];
             _humanRollback_decorators = [Remote('humanRollback')];
             _humanAddFact_decorators = [Remote('humanAddFact')];
@@ -197,6 +199,7 @@ let MemoryService = (() => {
             __esDecorate(this, null, _humanEditExperience_decorators, { kind: "method", name: "humanEditExperience", static: false, private: false, access: { has: obj => "humanEditExperience" in obj, get: obj => obj.humanEditExperience }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _humanAddExperience_decorators, { kind: "method", name: "humanAddExperience", static: false, private: false, access: { has: obj => "humanAddExperience" in obj, get: obj => obj.humanAddExperience }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _humanPromote_decorators, { kind: "method", name: "humanPromote", static: false, private: false, access: { has: obj => "humanPromote" in obj, get: obj => obj.humanPromote }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _evolve_decorators, { kind: "method", name: "evolve", static: false, private: false, access: { has: obj => "evolve" in obj, get: obj => obj.evolve }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _humanReleaseCold_decorators, { kind: "method", name: "humanReleaseCold", static: false, private: false, access: { has: obj => "humanReleaseCold" in obj, get: obj => obj.humanReleaseCold }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _humanRollback_decorators, { kind: "method", name: "humanRollback", static: false, private: false, access: { has: obj => "humanRollback" in obj, get: obj => obj.humanRollback }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _humanAddFact_decorators, { kind: "method", name: "humanAddFact", static: false, private: false, access: { has: obj => "humanAddFact" in obj, get: obj => obj.humanAddFact }, metadata: _metadata }, null, _instanceExtraInitializers);
@@ -511,6 +514,13 @@ ${deletionList}
             void agent;
             return this.core.humanPromote(id, reason, 'human');
         }
+        /// Human-approved self-growth: merge new evidence into a live, human-approved
+        /// experience. Semantic merge decision is made upstream (LLM); this is the
+        /// audited write that produces an incremental new revision.
+        evolve(agent, request) {
+            void agent;
+            return this.core.evolve(request, 'human');
+        }
         /** Human re-release of a cold-palace revision back to candidate (006 §3.2). */
         humanReleaseCold(agent, request) {
             void agent;

package/lib/types/store.d.ts

@@ -8,7 +8,7 @@
 import type { DatabaseSync } from 'node:sqlite';
 import type { ConcernEntry, ConcernStatus, ConcernTree, DiaryEntry, EvidenceRef, ExperienceSnapshot, ExperienceStatus, ExtractionRecord, FactEntry, LedgerBlock, SkillArtifact, SkillStatus } from './types.ts';
 /** Monotone store schema version. v1→v2 is an additive ALTER migration (see open()). */
-export declare const MEMORY_SCHEMA_VERSION = 6;
+export declare const MEMORY_SCHEMA_VERSION = 7;
 /** Half-life (ms) of the recency weighting applied to verification samples. */
 export declare const TRUST_HALF_LIFE_MS: number;
 /** One concerns-table row (007 §2). */

package/lib/types/store.js

@@ -7,7 +7,7 @@
  */
 import { createHash } from 'node:crypto';
 /** Monotone store schema version. v1→v2 is an additive ALTER migration (see open()). */
-export const MEMORY_SCHEMA_VERSION = 6;
+export const MEMORY_SCHEMA_VERSION = 7;
 /** Half-life (ms) of the recency weighting applied to verification samples. */
 export const TRUST_HALF_LIFE_MS = 180 * 24 * 60 * 60 * 1000;
 /** Hash one ledger block's content, chained to the previous hash. */
@@ -74,6 +74,7 @@ export class MemoryStore {
         verified_count INTEGER NOT NULL DEFAULT 0,
         reject_count INTEGER NOT NULL DEFAULT 0,
         global_flag INTEGER NOT NULL DEFAULT 0,
+        approved_by TEXT NOT NULL DEFAULT '',
         created_at INTEGER NOT NULL,
         updated_at INTEGER NOT NULL,
         PRIMARY KEY (family_id, revision)
@@ -225,6 +226,12 @@ export class MemoryStore {
         `);
                 v = 6;
             }
+            if (v === 6 && MEMORY_SCHEMA_VERSION >= 7) {
+                // v6 → v7 (experience self-growth): mark who approved a live experience to
+                // human so only human-approved experiences may evolve.
+                db.exec("ALTER TABLE experiences ADD COLUMN approved_by TEXT NOT NULL DEFAULT '';");
+                v = 7;
+            }
             if (v !== MEMORY_SCHEMA_VERSION) {
                 throw new Error(`memory store schema version ${row.value} does not match ${MEMORY_SCHEMA_VERSION}; refusing to open`);
             }
@@ -243,8 +250,8 @@ export class MemoryStore {
         family_id, revision, kind, source, family, gist, situation, path, reasoning, limits,
         status, alpha, beta, last_verified_at, pinned, tokens_saved, tokens_spent,
         parent_revision, failure_reason, evidence, challenge_reason, deleted,
-        context, verified_count, reject_count, global_flag, created_at, updated_at
-      ) VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,0,?,?,?,?,?,?)
+        context, verified_count, reject_count, global_flag, approved_by, created_at, updated_at
+      ) VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,0,?,?,?,?,?,?,?)
       ON CONFLICT (family_id, revision) DO UPDATE SET
         kind = excluded.kind,
         source = excluded.source,
@@ -269,8 +276,9 @@ export class MemoryStore {
         verified_count = excluded.verified_count,
         reject_count = excluded.reject_count,
         global_flag = excluded.global_flag,
+        approved_by = excluded.approved_by,
         updated_at = excluded.updated_at
-    `).run(s.id, s.revision, s.kind, s.source, s.family, s.gist, JSON.stringify(s.situation), JSON.stringify(s.path), s.reasoning, JSON.stringify(s.limits), s.status, s.alpha, s.beta, s.lastVerifiedAt ?? null, s.pinned ? 1 : 0, s.tokensSaved, s.tokensSpent, s.parentRevision ?? null, s.failureReason ?? null, s.evidence === undefined ? null : JSON.stringify(s.evidence), s.challengeReason ?? null, s.context ?? '', s.verifiedCount ?? 0, s.rejectCount ?? 0, s.globalFlag === true ? 1 : 0, s.createdAt, s.updatedAt);
+    `).run(s.id, s.revision, s.kind, s.source, s.family, s.gist, JSON.stringify(s.situation), JSON.stringify(s.path), s.reasoning, JSON.stringify(s.limits), s.status, s.alpha, s.beta, s.lastVerifiedAt ?? null, s.pinned ? 1 : 0, s.tokensSaved, s.tokensSpent, s.parentRevision ?? null, s.failureReason ?? null, s.evidence === undefined ? null : JSON.stringify(s.evidence), s.challengeReason ?? null, s.context ?? '', s.verifiedCount ?? 0, s.rejectCount ?? 0, s.globalFlag === true ? 1 : 0, s.approvedBy ?? '', s.createdAt, s.updatedAt);
     }
     /** Read one experience revision. */
     getExperience(familyId, revision) {
@@ -850,6 +858,8 @@ export class MemoryStore {
             snapshot.evidence = JSON.parse(row.evidence);
         if (row.challenge_reason !== null)
             snapshot.challengeReason = row.challenge_reason;
+        if (row.approved_by === 'human' || row.approved_by === 'agent')
+            snapshot.approvedBy = row.approved_by;
         return snapshot;
     }
     rowToReport(row) {

package/lib/types/types.d.ts

@@ -93,6 +93,8 @@ export interface ExperienceSnapshot {
     rejectCount: number;
     /** Cross-context transferable (global) flag; default local-only (006 §2.4). */
     globalFlag: boolean;
+    /** Who approved this live revision: 'human' only may self-grow (evolve). */
+    approvedBy?: 'human' | 'agent';
     /** Epoch ms. */
     createdAt: number;
     /** Epoch ms. */
@@ -647,6 +649,24 @@ export interface HumanAddExperienceRequest {
     /** Required reason (audited). */
     reason: string;
 }
+/** Human-approved experience self-growth: merge new evidence into a live,
+ *  human-approved experience as an incremental new revision. */
+export interface EvolveExperienceRequest {
+    /** Experience family id (must be approvedBy='human' and live). */
+    id: string;
+    /** What new evidence is merged and why. */
+    reason: string;
+    /** Replacement/merged gist (kept when omitted). */
+    gist?: string;
+    /** Extra situations to absorb (combined when omitted). */
+    situation?: string[];
+    /** Replacement path (kept when omitted). */
+    path?: ExperienceStep[];
+    /** Replacement reasoning (kept when omitted). */
+    reasoning?: string;
+    /** Extra limits to absorb (combined when omitted). */
+    limits?: string[];
+}
 /** Human fact operations. */
 export interface HumanAddFactRequest {
     /** Profile slot. */

package/package.json

@@ -1,116 +1,116 @@
-{
-  "name": "dsh-daoing-memory",
-  "description": "Self-evolving memory for DeepSeek Harness (DSH): earned experiences, diary/fact semantic memory, concern tracking, and an append-only audit ledger.",
-  "version": "0.1.17",
-  "type": "module",
-  "license": "MIT",
-  "author": "daoing",
-  "homepage": "https://github.com/daoing/dsh-daoing-memory",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/daoing/dsh-daoing-memory.git"
-  },
-  "keywords": [
-    "dsh",
-    "deepseek-harness",
-    "dsh-plugin",
-    "memory",
-    "agent-memory",
-    "self-evolving",
-    "cordis"
-  ],
-  "main": "lib/index.js",
-  "types": "lib/types/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./lib/types/index.d.ts",
-      "default": "./lib/index.js"
-    },
-    "./types": {
-      "types": "./lib/types/types.d.ts",
-      "default": "./lib/types/types.js"
-    },
-    "./core": {
-      "types": "./lib/types/core.d.ts",
-      "default": "./lib/types/core.js"
-    },
-    "./store": {
-      "types": "./lib/types/store.d.ts",
-      "default": "./lib/types/store.js"
-    },
-    "./service": {
-      "types": "./lib/types/service.d.ts",
-      "default": "./lib/types/service.js"
-    },
-    "./tools": {
-      "types": "./lib/types/tools.d.ts",
-      "default": "./lib/tools.js"
-    },
-    "./invariant": {
-      "types": "./lib/types/invariant.d.ts",
-      "default": "./lib/invariant.js"
-    },
-    "./client": {
-      "types": "./lib/types/client/index.d.ts",
-      "default": "./lib/client.js"
-    },
-    "./typert": {
-      "types": "./lib/typert.host.d.ts",
-      "default": "./lib/typert.host.js"
-    },
-    "./remote": {
-      "types": "./lib/typert.remote-client.d.ts",
-      "default": "./lib/typert.remote-client.js"
-    },
-    "./package.json": "./package.json"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "inject": [
-        "@deepseek-ai/dsh-client-runtime",
-        "@deepseek-ai/dsh-api-remotes",
-        "@deepseek-ai/dsh-client-ui-sidebar",
-        "@deepseek-ai/dsh-client-ui-primitives"
-      ],
-      "platform": "web"
-    }
-  },
-  "files": [
-    "lib/index.js",
-    "lib/invariant.js",
-    "lib/tools.js",
-    "lib/client.js",
-    "lib/client.js.map",
-    "lib/typert.host.js",
-    "lib/typert.host.d.ts",
-    "lib/typert.remote-client.js",
-    "lib/typert.remote-client.d.ts",
-    "lib/types/**/*.js",
-    "lib/types/**/*.d.ts",
-    "skill",
-    "cordis.patch.yml",
-    "README.md",
-    "LICENSE"
-  ],
-  "dependencies": {
-    "clsx": "^2.0.0",
-    "zod": "^4.4.3"
-  },
-  "peerDependencies": {
-    "@deepseek-ai/cordis": "*",
-    "@deepseek-ai/dsh-agent": "*",
-    "@deepseek-ai/dsh-api-remotes": "*",
-    "@deepseek-ai/dsh-client-runtime": "*",
-    "@deepseek-ai/dsh-client-ui-layout": "*",
-    "@deepseek-ai/dsh-client-ui-primitives": "*",
-    "@deepseek-ai/dsh-client-ui-sidebar": "*",
-    "@deepseek-ai/dsh-client-ui-slots": "*",
-    "@deepseek-ai/dsh-invariants": "*",
-    "@deepseek-ai/dsh-tools": "*",
-    "@deepseek-ai/dsh-typert-protocol": "*",
-    "react": ">=18"
-  }
-}
+{
+  "name": "dsh-daoing-memory",
+  "description": "Self-evolving memory for DeepSeek Harness (DSH): earned experiences, diary/fact semantic memory, concern tracking, and an append-only audit ledger.",
+  "version": "0.1.18",
+  "type": "module",
+  "license": "MIT",
+  "author": "daoing",
+  "homepage": "https://github.com/daoing/dsh-daoing-memory",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/daoing/dsh-daoing-memory.git"
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "dsh-plugin",
+    "memory",
+    "agent-memory",
+    "self-evolving",
+    "cordis"
+  ],
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./types": {
+      "types": "./lib/types/types.d.ts",
+      "default": "./lib/types/types.js"
+    },
+    "./core": {
+      "types": "./lib/types/core.d.ts",
+      "default": "./lib/types/core.js"
+    },
+    "./store": {
+      "types": "./lib/types/store.d.ts",
+      "default": "./lib/types/store.js"
+    },
+    "./service": {
+      "types": "./lib/types/service.d.ts",
+      "default": "./lib/types/service.js"
+    },
+    "./tools": {
+      "types": "./lib/types/tools.d.ts",
+      "default": "./lib/tools.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./typert": {
+      "types": "./lib/typert.host.d.ts",
+      "default": "./lib/typert.host.js"
+    },
+    "./remote": {
+      "types": "./lib/typert.remote-client.d.ts",
+      "default": "./lib/typert.remote-client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-ui-sidebar",
+        "@deepseek-ai/dsh-client-ui-primitives"
+      ],
+      "platform": "web"
+    }
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/tools.js",
+    "lib/client.js",
+    "lib/client.js.map",
+    "lib/typert.host.js",
+    "lib/typert.host.d.ts",
+    "lib/typert.remote-client.js",
+    "lib/typert.remote-client.d.ts",
+    "lib/types/**/*.js",
+    "lib/types/**/*.d.ts",
+    "skill",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "clsx": "^2.0.0",
+    "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "*",
+    "@deepseek-ai/dsh-agent": "*",
+    "@deepseek-ai/dsh-api-remotes": "*",
+    "@deepseek-ai/dsh-client-runtime": "*",
+    "@deepseek-ai/dsh-client-ui-layout": "*",
+    "@deepseek-ai/dsh-client-ui-primitives": "*",
+    "@deepseek-ai/dsh-client-ui-sidebar": "*",
+    "@deepseek-ai/dsh-client-ui-slots": "*",
+    "@deepseek-ai/dsh-invariants": "*",
+    "@deepseek-ai/dsh-tools": "*",
+    "@deepseek-ai/dsh-typert-protocol": "*",
+    "react": ">=18"
+  }
+}