@dzhechkov/harness-core 0.3.140 → 0.3.142

package/src/index.ts

@@ -96,7 +96,7 @@ export type {
 export { runSetup, generateHooksConfig, generateAgentdbWriter, writerVersionOf, AGENTDB_WRITER_VERSION } from './setup.js';
 export { statuslineData, readFeatureAdrState, writeFeatureAdrState, featureAdrStatePath } from './statusline.js';
 export type { StatuslineData, FeatureAdrState, WriteFeatureAdrStateInput } from './statusline.js';
-export { indexPatternsToAgentdb, resolveAgentdbPath, searchAgentdbPatterns, listAgentdbDzIds, resolveAgentdbEmbedder, cosineSimilarity, importVectorsToAgentdb, reindexAgentdbRows, bumpAgentdbUses, clearAgentdbQuarantine } from './agentdb-index.js';
+export { indexPatternsToAgentdb, resolveAgentdbPath, searchAgentdbPatterns, listAgentdbDzIds, resolveAgentdbEmbedder, cosineSimilarity, importVectorsToAgentdb, reindexAgentdbRows, bumpAgentdbUses, clearAgentdbQuarantine, deleteAgentdbByDzIds, readAgentdbRowsByTaskType, DZ_OWNED_TASK_TYPES } from './agentdb-index.js';
 export type { AgentdbSearchHit, AgentdbSearchResult, AgentdbImportRow } from './agentdb-index.js';
 export { DEFAULT_EMBED_MODEL, LEGACY_EMBED_MODEL, DEFAULT_EMBED_DIM, KNOWN_EMBED_DIMS, resolveEmbedModel, readEmbedManifest, writeEmbedManifest, embedManifestPath, legacyEmbedManifest } from './embedding-config.js';
 export type { EmbedModelConfig, EmbedModelSource, EmbedManifest } from './embedding-config.js';
@@ -330,3 +330,8 @@ export * from './compounding.js';
 // Run-process scorecard (feature dz-score, Reading C) — scores the DISCIPLINE of a feature-adr run
 // from its artifacts. Descriptive-only, permanently: it never gates.
 export * from './score.js';
+
+// Smart Backlog (feature smart-backlog) — goal-directed idea pipeline: capture → semantic dedup
+// against the EXISTING Brain vector engine (ADR-001, no 2nd store) → GoalMap alignment (ADR-003) →
+// weighted roulette (ADR-004) → idea2prd enrich hand-off → stub-first Jira adapter seam (ADR-006).
+export * from './backlog.js';

package/src/registry.ts

@@ -191,6 +191,8 @@ function categoryFromPack(pack: string): string {
   // digitizer outputs like `skills-12factor` (The Twelve-Factor App). Future digitized public packs
   // (e.g. AOSA) should be added here or carry a `book`/digitized marker.
   if (pack.includes('book') || pack.includes('12factor')) return 'knowledge';
+  // Course/tutorial manufacturing (skills-tutorial-factory: package → Head-First edu-site course).
+  if (pack.includes('tutorial')) return 'learning';
   return 'other';
 }
 

package/src/vector-tier.ts

@@ -65,7 +65,13 @@ import {
   cosineSimilarity,
   importVectorsToAgentdb,
   reindexAgentdbRows,
+  readAgentdbRowsByTaskType,
+  DZ_OWNED_TASK_TYPES,
 } from './agentdb-index.js';
+// smart-backlog (ADR-001/005 lifecycle): `dz vector reindex` must re-embed dz-backlog rows too, or
+// they rot in a stale embedding space after a model bump. One-directional import — backlog.ts imports
+// agentdb-index/compounding only, never vector-tier, so there is no cycle.
+import { BACKLOG_TASK_TYPE } from './backlog.js';
 import { currentEmbedManifest, guardEmbedSpace, DEFAULT_EMBED_DIM, resolveEmbedModel, type EmbedModelConfig } from './embedding-config.js';
 import { applyLearningSignals, applyLearningSignalsWithDelta, resolveLearningBackend, type LearningSignalBackend } from './learning-backend.js';
 
@@ -278,6 +284,15 @@ export interface ReindexVectorReport {
    * silent, since a mixed store looks healthy right up until someone widens a query.
    */
   readonly staleTaskTypes?: readonly string[];
+  /**
+   * smart-backlog honest-skip status. Set ONLY on the non-agentdb-engine path: backlog code never touches
+   * the shared manifest, so under a non-agentdb engine NOTHING is reindexed — `backlog:'skipped'` +
+   * `generic:'skipped'` + a non-empty `error` say so (overall success is never claimed). Unset on the full
+   * agentdb reindex path (which owns and re-embeds dz-backlog together with the other types) — behavior for
+   * every other caller is unchanged.
+   */
+  readonly backlog?: 'skipped';
+  readonly generic?: 'skipped';
 }
 
 export type TeachGuardResult =
@@ -963,10 +978,31 @@ export async function vectorTierStatus(
 }
 
 export async function reindexVectorStore(projectRoot: string, opts: VectorServiceOptions = {}): Promise<ReindexVectorReport> {
+  // ARCHITECTURAL INVARIANT (smart-backlog): backlog code never PARTIALLY advances the SHARED agentdb
+  // model manifest — no path re-stamps it to a new model while leaving a sibling task type un-re-embedded.
+  // The FIRST backlog write legitimately establishes the manifest when the store is new (correct); a model
+  // ADVANCE happens ONLY here, in a full reindex that re-embeds EVERY owned task type together atomically
+  // (taskTypes = DZ_OWNED_TASK_TYPES, which owns dz-backlog — HIGH-3). The old backlog-only re-stamp path
+  // spawned an endless class of edge cases (missing/corrupt/rollback/scan-error); it is REMOVED.
   const resolved = pickEngine(projectRoot, opts);
-  if (resolved.engine === undefined) return { reembedded: 0, error: resolved.reason ?? 'no vector engine available' };
-  if (resolved.engine.kind !== 'agentdb') {
-    return { reembedded: 0, error: 'dz vector reindex currently rewrites the agentdb learned-pattern mirror; switch memory.vector.engine to agentdb/auto' };
+  if (resolved.engine === undefined || resolved.engine.kind !== 'agentdb') {
+    // Non-agentdb (or absent) engine: the generic learned-pattern reindex can't run here, and backlog must
+    // not advance the shared manifest partially. Touch NOTHING — honest skip with a UNIFORM shape (LOW-I:
+    // always report backlog/generic skipped). Backlog's same-model writes already bind vectors to the
+    // current model (HIGH-2); a model bump needs a FULL reindex under the agentdb engine.
+    // A non-agentdb vector engine is CONFIGURED (rvf resolved, or requested-but-not-installed) ⇒ the
+    // manifest-untouched message pointing to the full agentdb reindex. Only a genuinely absent engine
+    // (no config, nothing resolvable) falls back to the bare reason.
+    const nonAgentdbConfigured = resolved.engine !== undefined || readVectorEngineMode(projectRoot) === 'rvf';
+    return {
+      reembedded: 0,
+      backlog: 'skipped',
+      generic: 'skipped',
+      error: nonAgentdbConfigured
+        ? 'a non-agentdb vector engine (e.g. RVF) is configured; no reindex was performed and the shared model manifest was NOT touched. ' +
+          'Run a full reindex under memory.vector.engine=agentdb/auto to re-embed every task type (dz-teach/dz-learning/dz-backlog) together.'
+        : resolved.reason ?? 'no vector engine available',
+    };
   }
   let records: MemoryRecord[];
   try {
@@ -984,7 +1020,14 @@ export async function reindexVectorStore(projectRoot: string, opts: VectorServic
       ...(r.tags !== undefined ? { tags: r.tags } : {}),
       ...(r.metadata !== undefined ? { metadata: r.metadata } : {}),
     }));
-  return reindexAgentdbRows(projectRoot, rows);
+  // HIGH-G: ownership is by STORE-PRESENCE. Read the dz-backlog rows that ACTUALLY EXIST IN THE STORE and
+  // re-embed THOSE (their stored text) — never reconstruct them from ideas.jsonl, or an empty/unreadable
+  // sidecar would advance the manifest while the store's real dz-backlog rows rot in the old model space.
+  // Symmetric with dz-teach/dz-learning (re-embedded from their store of truth). Only widen the owned set
+  // when the store actually holds dz-backlog rows — a store with none reindexes byte-identically to before.
+  const backlogStoreRows = readAgentdbRowsByTaskType(projectRoot, BACKLOG_TASK_TYPE).rows;
+  if (backlogStoreRows.length === 0) return reindexAgentdbRows(projectRoot, rows);
+  return reindexAgentdbRows(projectRoot, [...rows, ...backlogStoreRows], { taskTypes: DZ_OWNED_TASK_TYPES });
 }
 
 /* ------------------------------------------------------------------ */