memhtml 0.2.5 → 0.4.0

package/dist/memhtml.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { $ as STATE_SIDECAR_PATH, A as makeIndexRecorder, B as makeGitPort, C as ModelClientLive, D as EMBED_DIM, E as EmbeddingsLive, F as reinforce, G as STATE_MIGRATIONS_DIR, H as DatabaseService, I as Indexer, J as expandRoot, K as STATE_SCHEMA, L as makeIndexer, M as readWatermark, N as Retrieval, O as EMBED_WATERMARK, P as makeRetrieval, Q as STATE_DB_PATH, R as readIndexState, S as ModelClient, T as Embeddings, U as makeDatabase, V as sanitizeFtsQuery, W as MIGRATIONS_DIR, X as INDEX_DB_PATH, Y as makeStore, _ as unlink, a as parseSidecar, at as commitSubject, b as discriminationGate, c as generateArtifacts, ct as isValidDatetime, d as danglingEdges, dt as REINFORCE_SIGNALS, et as attemptIo, f as publishRows, ft as frameKeyOf, g as meta, h as link, i as makeSleep, it as makeGit, j as persistScanned, k as IndexRecorder, l as accessRows, lt as closesFence, m as hrefFor, n as scanTraceRoot, nt as readFileOrNull, o as renderSidecar, ot as checkMemory, p as applyHeadEdits, q as Store, r as Sleep, rt as Git, s as archivedFormOf, st as setMeta, t as mergeTailExtract, tt as initRepo, u as allPaths, ut as fenceOpeningOf, v as SLEEP_PHASES, w as wrapAsData, x as runDiscrimination, y as isSleepPhase, z as IndexGit } from "./dist-Uj47oBRC.mjs";
-import { B as ModelUnavailable, G as MEMORY_RELS, H as StorageFailure, J as relClassFor, K as TASK_RELS, N as hasConsolidatorCredentials, Q as INBOX_DIR, R as InvalidMemory, gt as TASK_STATUSES, i as makeConsolidator, ot as normalizePath, q as isEdgeRel, tt as TASKS_SUBDIR, vt as WRITABLE_MEMORY_TYPES, yt as isTaskStatus } from "./dist-t84Q_98w.mjs";
+import { $ as STATE_DB_PATH, A as IndexRecorder, B as IndexGit, C as ModelClient, D as EmbeddingsLive, E as Embeddings, F as makeRetrieval, G as MIGRATIONS_DIR, H as sanitizeFtsQuery, I as reinforce, J as Store, K as STATE_MIGRATIONS_DIR, L as Indexer, M as persistScanned, N as readWatermark, O as EMBED_DIM, P as Retrieval, R as makeIndexer, S as runDiscrimination, T as wrapAsData, U as DatabaseService, V as makeGitPort, W as makeDatabase, X as makeStore, Y as expandRoot, Z as INDEX_DB_PATH, _ as meta, a as parseSidecar, at as makeGit, b as isSleepPhase, c as generateArtifacts, ct as setMeta, d as allPaths, dt as fenceOpeningOf, et as STATE_SIDECAR_PATH, f as danglingEdges, ft as REINFORCE_SIGNALS, g as link, h as hrefFor, i as makeSleep, it as Git, j as makeIndexRecorder, k as EMBED_WATERMARK, l as DETECTION_PREFIX, lt as isValidDatetime, m as applyHeadEdits, n as scanTraceRoot, nt as initRepo, o as renderSidecar, ot as commitSubject, p as publishRows, pt as frameKeyOf, q as STATE_SCHEMA, r as Sleep, rt as readFileOrNull, s as archivedFormOf, st as checkMemory, t as mergeTailExtract, tt as attemptIo, u as accessRows, ut as closesFence, v as unlink, w as ModelClientLive, x as discriminationGate, y as SLEEP_PHASES, z as readIndexState } from "./dist-D73gfqLc.mjs";
+import { $ as TASK_RELS, Dt as isTaskStatus, Et as WRITABLE_MEMORY_TYPES, G as InvalidMemory, Q as MEMORY_RELS, R as hasConsolidatorCredentials, Y as StorageFailure, a as makeConsolidator, et as isEdgeRel, lt as TASKS_SUBDIR, mt as normalizePath, ot as INBOX_DIR, q as ModelUnavailable, tt as relClassFor, wt as TASK_STATUSES } from "./dist-BCsav-EP.mjs";
 import { createRequire } from "node:module";
 import { Config, Context, Effect, Layer, Logger } from "effect";
 import { access, mkdir, readFile, writeFile } from "node:fs/promises";
@@ -82,7 +82,7 @@ const CONFIG_VARS = [
 	},
 	{
 		name: "MEMHTML_AWS_REGION",
-		description: "The Bedrock region for embeddings and the sleep cycle's four LLM phases.",
+		description: "The Bedrock region for embeddings and the sleep cycle's model-calling phases.",
 		fallback: "us-east-1"
 	},
 	{
@@ -97,7 +97,7 @@ const CONFIG_VARS = [
 	},
 	{
 		name: "MEMHTML_LLM",
-		description: "`off` makes the four LLM sleep phases report `no model bound` and stay `ok`, so a credential-free run is honest rather than red.",
+		description: "`off` makes every model-calling sleep phase report `no model bound` and stay `ok`, so a credential-free run is honest rather than red. `entity-resolution` still runs its deterministic normalization and character-overlap passes; the others do nothing.",
 		fallback: "on"
 	},
 	{
@@ -1643,6 +1643,32 @@ const setTaskStatus = (params) => Effect.gen(function* () {
 	};
 });
 /**
+* The `GLOB` pattern that matches a detected task's path, and nothing else.
+*
+* **The PATH is the discriminator, and `author` is deliberately not it.** `packages/sleep/src/tasks.ts`
+* records why the path carries the detection key: it survives `rm index.db && rebuild` with no
+* projection, it is collision-free by construction, and it costs no new meta in a CLOSED vocabulary.
+* `files.author` IS a real column and every detected task carries `agent:sleep` in it — but so does
+* every memory `trace-consolidation` and `arc-synthesis` write, and so would a task an operator opened
+* while impersonating the cycle. `author = 'agent:sleep'` is therefore necessary and not sufficient,
+* while the path is both. Adding the author predicate beside this one would look like defense in depth
+* and would actually be a second, weaker copy of the same test — and it would break the moment a
+* detector minted under a different author, which is a change the path would survive.
+*
+* `GLOB` rather than `LIKE`, and the character class is the reason. `LIKE 'areas/inbox/tasks/det-%'`
+* would match `det-nothex…` and `detonate-things.html`; the twelve `[0-9a-f]` positions are the same
+* shape `detectionKeyOf`'s regex asserts, so the two agree about what a detected path IS. Verified
+* against node:sqlite: the pattern matches a real detected path and an archived one, and rejects a
+* human `t-…` task, a non-hex stem, a short digest, and `detonate-`.
+*
+* The leading `*` covers the ARCHIVE. `archivePathFor` prefixes `archive/<year>/`, so a closed detected
+* task's path is `archive/2026/areas/inbox/tasks/det-…`, and `--detected --include-archived` has to
+* reach it or "what did the machine propose and what happened to it" is unanswerable. It also means the
+* pattern is anchored on the FILENAME rather than on the directory, which is correct: the digest prefix
+* is the claim, and `placementFor` owns where a task files.
+*/
+const DETECTED_TASK_GLOB = `*/${DETECTION_PREFIX}${"[0-9a-f]".repeat(12)}-*.html`;
+/**
 * The task working set: a direct indexed scan, deliberately not retrieval.
 *
 * No RRF, no MMR, no embedding. A to-do list is not a ranking problem. An agent asking "what is
@@ -1700,6 +1726,20 @@ const listTasks = (params) => Effect.gen(function* () {
 		conditions.push("f.path > ?");
 		values.push(normalizePath(params.cursor));
 	}
+	/**
+	* A FILTER on the existing shape, not a new payload. Every row `task list` returns still carries
+	* exactly the {@link TaskRow} fields, so `task.list` keeps its meaning and the append-only
+	* discriminator rule in `envelope.ts` is untouched — nothing was added to a shipped shape and no
+	* consumer's parse changes.
+	*
+	* A `detected: boolean` column per row was the alternative and it was declined. It would put the
+	* same fact in two places (the path already says it) and it would make every caller of `task list`
+	* parse a field only one flag's users read.
+	*/
+	if (params.detected === true) {
+		conditions.push("f.path GLOB ?");
+		values.push(DETECTED_TASK_GLOB);
+	}
 	const rows = yield* db.all(`SELECT f.path, f.title, f.task_status, f.due_at, f.workspace, f.archived, f.updated_at,
               (SELECT group_concat(b.src_path, char(10)) FROM (
                  SELECT e.src_path AS src_path FROM edges e
@@ -2506,6 +2546,12 @@ const COMMANDS = [
 				type: "boolean",
 				description: "Include finished tasks. `done` archives, so they are otherwise absent.",
 				default: false
+			},
+			{
+				name: "detected",
+				type: "boolean",
+				description: "Only tasks the sleep cycle detected, never ones opened by hand. The machine's queue: each is a proposal carrying the evidence it was detected from.",
+				default: false
 			}
 		],
 		responseTypes: ["task.list"]
@@ -2593,7 +2639,13 @@ const COMMANDS = [
 	},
 	{
 		name: "sleep run",
-		summary: "The nightly curation cycle: 15 phases, each an isolated commit on a review branch.",
+		/**
+		* The count is DERIVED from `SLEEP_PHASES`, not typed. Both strings used to spell `15` by hand,
+		* and adding a sixteenth phase left `AGENTS.md` and `memhtml manifest` asserting a number the list
+		* beside them contradicted — visible only because the doc drift gate compares generated bytes, and
+		* only for the one of the two that also prints the names.
+		*/
+		summary: `The nightly curation cycle: ${SLEEP_PHASES.length} phases, each an isolated commit on a review branch.`,
 		args: [],
 		flags: [
 			{
@@ -2604,7 +2656,7 @@ const COMMANDS = [
 			{
 				name: "phases",
 				type: "string",
-				description: `Comma-separated subset. All 15 by default: ${SLEEP_PHASES.join(", ")}.`
+				description: `Comma-separated subset. All ${SLEEP_PHASES.length} by default: ${SLEEP_PHASES.join(", ")}.`
 			},
 			{
 				name: "dry-run",
@@ -2884,7 +2936,7 @@ const GUIDE_TOPICS = GUIDE.map((block) => block.topic);
 */
 const buildManifest = () => ({
 	name: "memhtml",
-	version: "0.2.5",
+	version: "0.4.0",
 	summary: "Read, write, and curate the git-backed memory repo.",
 	apiVersion: "1",
 	/**
@@ -3983,7 +4035,7 @@ const runExec = (input) => Effect.gen(function* () {
 		catch: (cause) => StorageFailure.make({ operation: `exec.sandbox-load: ${String(cause)}` })
 	});
 	const { mountReadOnlyRoots } = yield* Effect.tryPromise({
-		try: () => import("./dist-Dj-MYf9q.mjs"),
+		try: () => import("./dist-DuzGralO.mjs"),
 		catch: (cause) => StorageFailure.make({ operation: `exec.mount-load: ${String(cause)}` })
 	});
 	const helperSource = yield* Effect.tryPromise({
@@ -4128,7 +4180,7 @@ const execCommand = (input) => Effect.gen(function* () {
 	* would not cover.
 	*/
 	const { pinCorpusSnapshot } = yield* Effect.tryPromise({
-		try: () => import("./dist-Dj-MYf9q.mjs"),
+		try: () => import("./dist-DuzGralO.mjs"),
 		catch: (cause) => StorageFailure.make({ operation: `exec.mount-load: ${String(cause)}` })
 	});
 	const snapshot = yield* Effect.acquireRelease(Effect.tryPromise({
@@ -4330,7 +4382,7 @@ const indexReport = () => Effect.gen(function* () {
 });
 const count = (db, sql) => db.get(sql).pipe(Effect.map((row) => row?.n ?? 0), Effect.orElseSucceed(() => 0));
 /**
-* A `--phases` value as a validated phase list, or `undefined` for "all fifteen".
+* A `--phases` value as a validated phase list, or `undefined` for "all sixteen".
 *
 * An unknown phase is rejected instead of dropped silently. A run asked for `--phases dedup,compress`
 * with a typo in the first name would otherwise execute only the second. `dedup-merge` is a hard
@@ -4644,7 +4696,8 @@ const dispatch = (parsed, applyOps = []) => {
 				dueBefore: str(parsed, "due-before"),
 				limit: int(parsed, "limit"),
 				cursor: str(parsed, "cursor"),
-				includeArchived: bool(parsed, "include-archived", false)
+				includeArchived: bool(parsed, "include-archived", false),
+				detected: bool(parsed, "detected", false)
 			})];
 		});
 		case "index rebuild": return Effect.gen(function* () {