dsh-harbor-evolution 0.9.2 → 0.9.4

package/lib/trial-selection.js

@@ -3,6 +3,30 @@ import { localObjectDigest } from './interaction-objects.js'
 
 export const MAX_SELECTED_TRIALS = 1000
 
+/** Validate persisted membership without renewing it or rerunning its original query. */
+export function frozenTrialSelection(entry, ref, owner) {
+  const denied = () => { throw new Error('HARBOR_SELECTION_DENIED: Selection does not belong to this Session and Job.') }
+  if (!entry || entry.sessionId !== String(owner.sessionId) || entry.projectRoot !== owner.projectRoot || entry.workspace !== owner.workspace || entry.job !== ref.job || JSON.stringify(entry.ref) !== JSON.stringify(ref)) denied()
+  if (!['explicit', 'query-snapshot'].includes(entry.mode) || !/^sha256:[a-f0-9]{64}$/.test(entry.filterDigest ?? '') || !Array.isArray(entry.members) || !entry.members.length || entry.members.length > MAX_SELECTED_TRIALS || entry.members.length !== ref.selectionCount) denied()
+  const members = entry.members.map(member => {
+    if (typeof member.id !== 'string' || member.id.length > 240 || !/^(?:@?[\p{L}\p{N}][\p{L}\p{N}._:@+-]*|@[A-Za-z0-9._-]+\/[A-Za-z0-9._-]+)$/u.test(member.id) || !/^sha256:[a-f0-9]{64}$/.test(member.revision ?? '')) denied()
+    return { id: member.id, revision: member.revision }
+  })
+  if (new Set(members.map(member => member.id)).size !== members.length || localObjectDigest({ mode: entry.mode, filterDigest: entry.filterDigest, members }) !== ref.sourceDigest) denied()
+  return { ...entry, members }
+}
+
+/** Resolve the exact frozen members against current evidence; changes stay explicit. */
+export function resolveFrozenTrialSelection(entry, ref, owner, currentTrials) {
+  const frozen = frozenTrialSelection(entry, ref, owner)
+  const byId = new Map(currentTrials.map(trial => [trial.id, trial]))
+  for (const member of frozen.members) {
+    const current = byId.get(member.id)
+    if (!current || localObjectDigest(current) !== member.revision) throw new Error('HARBOR_CONTEXT_STALE_SELECTION: Selected Trials changed. Reselect before continuing.')
+  }
+  return { ref: { ...frozen.ref }, value: { mode: frozen.mode, filterDigest: frozen.filterDigest, count: frozen.members.length, members: frozen.members, trials: frozen.members.map(member => byId.get(member.id)) } }
+}
+
 /** Server-owned, frozen IDs/revisions; a query can never silently expand later. */
 export class TrialSelectionRegistry {
   constructor({ now = Date.now, ttlMs = 15 * 60_000, maxEntries = 256 } = {}) {
@@ -36,11 +60,6 @@ export class TrialSelectionRegistry {
   }
   resolve(ref, owner, currentTrials) {
     const entry = this.owned(ref, owner)
-    const byId = new Map(currentTrials.map(trial => [trial.id, trial]))
-    for (const member of entry.members) {
-      const current = byId.get(member.id)
-      if (!current || localObjectDigest(current) !== member.revision) throw new Error('HARBOR_CONTEXT_STALE_SELECTION: Selected Trials changed. Reselect before continuing.')
-    }
-    return { ref: { ...entry.ref }, value: { mode: entry.mode, filterDigest: entry.filterDigest, count: entry.members.length, members: entry.members, trials: entry.members.map(member => byId.get(member.id)) } }
+    return resolveFrozenTrialSelection(entry, ref, owner, currentTrials)
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-harbor-evolution",
-  "version": "0.9.2",
+  "version": "0.9.4",
   "description": "DeepSeek Harness plugin and Skill for Harbor Candidate and Historical Session evaluation workflows.",
   "type": "module",
   "main": "index.js",

package/schemas/historical-generation-batch.schema.json

@@ -14,6 +14,7 @@
       "type": "object",
       "additionalProperties": false,
       "required": ["cwd_digest"],
+      "description": "Output workspace identity; source projects are recorded per Generation Record.",
       "properties": { "cwd_digest": { "$ref": "#/$defs/digest" } }
     },
     "selection": {
@@ -21,12 +22,31 @@
       "additionalProperties": false,
       "required": ["scope", "order", "requested_limit", "selected_count", "current_session_excluded"],
       "properties": {
-        "scope": { "const": "exact-cwd" },
+        "scope": { "enum": ["exact-cwd", "dsh-history"] },
         "order": { "const": "last-activity-desc" },
         "requested_limit": { "type": "integer", "minimum": 1, "maximum": 10 },
         "selected_count": { "type": "integer", "minimum": 1, "maximum": 10 },
         "current_session_excluded": { "const": true },
-        "created_after": { "type": "string", "format": "date-time" }
+        "created_after": { "type": "string", "format": "date-time" },
+        "scan": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Discovery window metadata. Activity ordering only applies to records read within this window, not unscanned history.",
+          "required": ["scope", "listed_count", "candidate_count", "read_count", "unscanned_count", "partial", "window_order", "selection_order"],
+          "properties": {
+            "scope": { "enum": ["exact-cwd", "dsh-history"] },
+            "listed_count": { "type": "integer", "minimum": 0 },
+            "candidate_count": { "type": "integer", "minimum": 0 },
+            "read_count": { "type": "integer", "minimum": 0 },
+            "unscanned_count": { "type": "integer", "minimum": 0 },
+            "partial": { "type": "boolean" },
+            "window_order": { "enum": ["all-candidates", "created-at-desc"] },
+            "selection_order": { "const": "last-activity-desc" }
+          },
+          "if": { "properties": { "scope": { "const": "exact-cwd" } } },
+          "then": { "properties": { "window_order": { "const": "all-candidates" } } },
+          "else": { "properties": { "window_order": { "const": "created-at-desc" } } }
+        }
       }
     },
     "source": {
@@ -62,6 +82,7 @@
           "source_ref": { "$ref": "#/$defs/digest" },
           "captured_through_seq": { "type": "integer", "minimum": 0 },
           "source_digest": { "$ref": "#/$defs/digest" },
+          "source_project_digest": { "$ref": "#/$defs/digest", "description": "Digest of the source Session project, when known; never inferred from the output workspace." },
           "observation_digest": { "$ref": "#/$defs/digest" },
           "last_activity_at": { "type": "string", "format": "date-time" },
           "generator": { "type": "object" },