mewkit 1.12.0 → 1.13.0

package/dist/core/derived-index.d.ts

@@ -1,6 +1,13 @@
+import { DatabaseSync } from "node:sqlite";
 import { type WikiIngestCounts } from "../wiki/infrastructure/wiki-ingest.js";
-export declare const SCHEMA_VERSION = 2;
+export declare const SCHEMA_VERSION = 3;
 export declare function dbPath(claudeDir: string): string;
+/** Apply any pending forward migrations and stamp the schema version. Exported so the live
+ * write adapter (`SqliteWikiIndex.upsertPage`) can self-heal a never-built index DB: the
+ * wiki schema is otherwise created only by `buildIndex` (`mewkit index` / `wiki reindex`),
+ * so a first `approve` on a fresh wiki would hit `no such table: wiki_page`. Idempotent —
+ * a no-op once `user_version` is current. */
+export declare function ensureIndexSchema(db: DatabaseSync): void;
 export interface IndexResult {
     dbPath: string;
     schemaVersion: number;

package/dist/core/derived-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"derived-index.d.ts","sourceRoot":"","sources":["../../src/core/derived-index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAS1F,eAAO,MAAM,cAAc,IAAI,CAAC;AA0BhC,wBAAgB,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhD;AA0ED,MAAM,WAAW,WAAW;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,gBAAgB,CAAC;CACvB;AAmBD;iGACiG;AACjG,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAkBzD;AAED,MAAM,WAAW,WAAW;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7C,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjD,wBAAwB,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClE,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAClE;AAED,yFAAyF;AACzF,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAyBzD"}
+{"version":3,"file":"derived-index.d.ts","sourceRoot":"","sources":["../../src/core/derived-index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAS1F,eAAO,MAAM,cAAc,IAAI,CAAC;AA2BhC,wBAAgB,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhD;AAQD;;;;6CAI6C;AAC7C,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CASxD;AAwDD,MAAM,WAAW,WAAW;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,gBAAgB,CAAC;CACvB;AAmBD;iGACiG;AACjG,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAkBzD;AAED,MAAM,WAAW,WAAW;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7C,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjD,wBAAwB,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClE,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAClE;AAED,yFAAyF;AACzF,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAyBzD"}

package/dist/core/derived-index.js

@@ -2,7 +2,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { DatabaseSync } from "node:sqlite";
 import { parseTraceLog } from "./trace-analysis.js";
-import { WIKI_MIGRATION_SQL } from "../wiki/infrastructure/wiki-schema.js";
+import { WIKI_MIGRATION_SQL, WIKI_V3_MIGRATION_SQL } from "../wiki/infrastructure/wiki-schema.js";
 import { ingestWiki } from "../wiki/infrastructure/wiki-ingest.js";
 // The consolidated DERIVED, disposable SQLite index. Canonical data stays in the append
 // logs (.claude/memory/*) and the wiki tree (tasks/wikis/<slug>/); this DB is a rebuild-able
@@ -10,7 +10,7 @@ import { ingestWiki } from "../wiki/infrastructure/wiki-ingest.js";
 // hook writes to it. All inserts are parameterized (prepared statements); queries are static
 // aggregates with no user-supplied SQL — no injection surface. v2 folds in the wiki tables +
 // FTS5 (was a separate index.db, now unified as wiki-index.db per the consolidation decision).
-export const SCHEMA_VERSION = 2;
+export const SCHEMA_VERSION = 3;
 const DB_REL = path.join("memory", "wiki-index.db");
 /** The pre-consolidation DB, removed once on the first unified build. */
 const LEGACY_DB_REL = path.join("memory", "index.db");
@@ -33,6 +33,7 @@ const MIGRATIONS = [
 		);`,
     },
     { version: 2, sql: WIKI_MIGRATION_SQL },
+    { version: 3, sql: WIKI_V3_MIGRATION_SQL },
 ];
 export function dbPath(claudeDir) {
     return path.join(claudeDir, DB_REL);
@@ -42,8 +43,12 @@ function userVersion(db) {
     const v = row?.["user_version"];
     return typeof v === "number" ? v : 0;
 }
-/** Apply any pending forward migrations and stamp the schema version. */
-function migrate(db) {
+/** Apply any pending forward migrations and stamp the schema version. Exported so the live
+ * write adapter (`SqliteWikiIndex.upsertPage`) can self-heal a never-built index DB: the
+ * wiki schema is otherwise created only by `buildIndex` (`mewkit index` / `wiki reindex`),
+ * so a first `approve` on a fresh wiki would hit `no such table: wiki_page`. Idempotent —
+ * a no-op once `user_version` is current. */
+export function ensureIndexSchema(db) {
     let current = userVersion(db);
     for (const m of MIGRATIONS) {
         if (m.version > current) {
@@ -122,7 +127,7 @@ export function buildIndex(claudeDir) {
     const db = new DatabaseSync(target);
     try {
         db.exec("PRAGMA journal_mode = WAL");
-        migrate(db);
+        ensureIndexSchema(db);
         db.exec("DELETE FROM trace_events");
         db.exec("DELETE FROM cost_entries");
         const traceRows = ingestTrace(db, claudeDir);

package/dist/core/derived-index.js.map

@@ -1 +1 @@
-{"version":3,"file":"derived-index.js","sourceRoot":"","sources":["../../src/core/derived-index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"derived-index.js","sourceRoot":"","sources":["../../src/core/derived-index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,EAAE,UAAU,EAAyB,MAAM,uCAAuC,CAAC;AAE1F,wFAAwF;AACxF,6FAA6F;AAC7F,4FAA4F;AAC5F,6FAA6F;AAC7F,6FAA6F;AAC7F,+FAA+F;AAE/F,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAChC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;AACpD,yEAAyE;AACzE,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AAEtD,wFAAwF;AACxF,MAAM,UAAU,GAAuC;IACtD;QACC,OAAO,EAAE,CAAC;QACV,GAAG,EAAE;;;;;;;;;;;;KAYF;KACH;IACD,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,kBAAkB,EAAE;IACvC,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,qBAAqB,EAAE;CAC1C,CAAC;AAEF,MAAM,UAAU,MAAM,CAAC,SAAiB;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,WAAW,CAAC,EAAgB;IACpC,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,GAAG,EAAE,CAAC;IACpD,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC,cAAc,CAAC,CAAC;IAChC,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACtC,CAAC;AAED;;;;6CAI6C;AAC7C,MAAM,UAAU,iBAAiB,CAAC,EAAgB;IACjD,IAAI,OAAO,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,OAAO,GAAG,OAAO,EAAE,CAAC;YACzB,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACf,EAAE,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,oCAAoC;YACnF,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;QACrB,CAAC;IACF,CAAC;AACF,CAAC;AAED,SAAS,QAAQ,CAAC,CAAU;IAC3B,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC/C,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,QAAQ,CAAC,CAAU;IAC3B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/D,CAAC;AAED,mEAAmE;AACnE,SAAS,WAAW,CAAC,EAAgB,EAAE,SAAiB;IACvD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IAClE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CACtB,iHAAiH,CACjH,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAI,CAAC,gBAAgB,CAAY,CAAC,CAAC,CAAC,IAAI,CAAC;QACpG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/H,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC;AACvB,CAAC;AAED,oGAAoG;AACpG,SAAS,UAAU,CAAC,EAAgB,EAAE,SAAiB;IACtD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;IAChE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACJ,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,CAAC,CAAC;IACV,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CACtB,uGAAuG,CACvG,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAA4B,CAAC;QAC3E,IAAI,CAAC,GAAG,CACP,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,EAC9B,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,EACtB,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EACnB,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EACpB,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EACrB,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EACnB,QAAQ,CAAC,CAAC,CAAC,CACX,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,CAAC;AACnB,CAAC;AAUD;yFACyF;AACzF,SAAS,cAAc,CAAC,SAAiB;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACnD,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,MAAM,MAAM,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC;QAC1B,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACb,OAAO,GAAG,IAAI,CAAC;QAChB,CAAC;IACF,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,2BAA2B,aAAa,oBAAoB,MAAM,EAAE,CAAC,CAAC;IACrF,CAAC;AACF,CAAC;AAED;iGACiG;AACjG,MAAM,UAAU,UAAU,CAAC,SAAiB;IAC3C,cAAc,CAAC,SAAS,CAAC,CAAC;IAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5C,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC;QACJ,EAAE,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QACrC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QACtB,EAAE,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACpC,EAAE,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACpC,MAAM,SAAS,GAAG,WAAW,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,UAAU,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QACzC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACtF,CAAC;YAAS,CAAC;QACV,EAAE,CAAC,KAAK,EAAE,CAAC;IACZ,CAAC;AACF,CAAC;AAUD,yFAAyF;AACzF,MAAM,UAAU,UAAU,CAAC,SAAiB;IAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACnF,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC;QACJ,MAAM,YAAY,GAAG,EAAE;aACrB,OAAO,CAAC,qFAAqF,CAAC;aAC9F,GAAG,EAAoC,CAAC;QAC1C,MAAM,UAAU,GAAG,EAAE;aACnB,OAAO,CAAC,qHAAqH,CAAC;aAC9H,GAAG,EAA0C,CAAC;QAChD,MAAM,wBAAwB,GAAG,EAAE;aACjC,OAAO,CACP,wKAAwK,CACxK;aACA,GAAG,EAA6C,CAAC;QACnD,MAAM,WAAW,GAAG,EAAE;aACpB,OAAO,CACP,yJAAyJ,CACzJ;aACA,GAAG,EAA0D,CAAC;QAChE,OAAO,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE,CAAC,EAAE,YAAY,EAAE,UAAU,EAAE,wBAAwB,EAAE,WAAW,EAAE,CAAC;IAC5G,CAAC;YAAS,CAAC;QACV,EAAE,CAAC,KAAK,EAAE,CAAC;IACZ,CAAC;AACF,CAAC"}

package/dist/wiki/application/ports.d.ts

@@ -65,6 +65,14 @@ export interface WikiSearchHit {
     title: string;
     snippet: string;
     tokenEstimate: number;
+    /** DB slug-relative page path (e.g. "pages/backend-infra.md"). Populated by the
+     * query layer; optional so synthetic hits (tests/mocks) need not supply it. */
+    pagePath?: string;
+    /** Project-root-readable path composed from the slug + pagePath
+     * (e.g. "tasks/wikis/<slug>/pages/backend-infra.md"). The agent-facing file target. */
+    path?: string;
+    /** Full page body — present only when the caller explicitly opts in (context --include-content). */
+    content?: string;
 }
 export interface WikiIndex {
     upsertPage(page: WikiPage): void;

package/dist/wiki/application/ports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../../src/wiki/application/ports.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../../src/wiki/application/ports.ts"],"names":[],"mappings":"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"}

package/dist/wiki/handoff/domain.d.ts

@@ -0,0 +1,107 @@
+import type { SalienceComponents, SalienceScore, VerificationState, WikiOrigin, WikiSlug, WikiWriteDecision } from "../domain/index.js";
+import type { ProposeInput } from "../application/ports.js";
+/** How eagerly a skill hands knowledge off. `required` runs the advisory at the
+ * end of every flow (still gated by salience); `conditional` only when the run
+ * produced a project-specific artifact; `none` never auto-suggests. */
+export type WikiHandoffClass = "required" | "conditional" | "none";
+/** The knowledge family a skill's artifact belongs to. Drives default salience
+ * emphasis. Adding a skill = adding a registry row, never editing a switch. */
+export type WikiHandoffProfile = "lifecycle-run" | "root-cause" | "review-verdict" | "planning-report" | "decision-record" | "security-posture" | "external-spec" | "architecture-analysis" | "workflow-recipe" | "project-convention";
+/** Profile tag as stored — a concrete profile, or "none" for the default entry. */
+export type WikiHandoffProfileTag = WikiHandoffProfile | "none";
+/** Terminal state of a handoff attempt. */
+export type WikiHandoffStatus = "suggested" | "proposed" | "skipped" | "quarantined";
+/** Signals extracted from a skill's terminal artifact. The inputs to a profile's
+ * `defaultSalience` / `shouldSuggest`. Deterministic — every time-dependent value
+ * such as `producedAt` is passed in by the caller; the domain never reads the clock. */
+export interface ArtifactSignal {
+    skillName: string;
+    /** Artifact location (provenance only here; path-gating happens in the service). */
+    artifactPath: string;
+    /** SHA-256 of the artifact content (computed by the service; provenance here). */
+    artifactHash: string;
+    /** Artifact size in bytes — a weak proxy for substance. */
+    contentBytes: number;
+    /** ISO timestamp the artifact was produced. Passed in; never Date.now() here. */
+    producedAt: string;
+    /** The user explicitly asked to capture/keep this knowledge. */
+    explicitUserIntent?: boolean;
+    /** A verified outcome backs the artifact: accepted verdict, green tests, shipped fix. */
+    verifiedOutcome?: boolean;
+    /** Addresses a recurring problem/friction (observed at least twice). */
+    recurringFriction?: boolean;
+    /** Caller-supplied novelty vs the existing wiki (0..2); profile default otherwise. */
+    noveltyDelta?: number;
+    /** Caller-supplied security-risk penalty (<= 0). */
+    securityRiskPenalty?: number;
+    /** Caller-supplied staleness penalty (<= 0). */
+    stalenessPenalty?: number;
+}
+/** A skill's knowledge handoff. Superset of ProposeInput: the extra fields are
+ * provenance the wiki_handoff store records; the rest map onto ProposeInput. */
+export interface WikiHandoffPacket {
+    slug: WikiSlug;
+    skillName: string;
+    skillOwner?: string;
+    handoffClass: WikiHandoffClass;
+    profile: WikiHandoffProfileTag;
+    artifactPath: string;
+    artifactHash: string;
+    title: string;
+    content: string;
+    origin: WikiOrigin;
+    whySave: string;
+    evidence: string;
+    sourceIds: string[];
+    reuseScope: string;
+    verificationState: VerificationState;
+    riskScore: number;
+    noveltyDelta: number;
+    salience: SalienceComponents;
+    createdAt: string;
+    reviewAfter?: string;
+}
+/** The append-only outcome record written to handoffs.jsonl and ingested into
+ * wiki_handoff. It captures the decision (and candidate id, if one was created)
+ * — NEVER raw artifact content. */
+export interface WikiHandoffRecord {
+    id: string;
+    slug: WikiSlug;
+    skillName: string;
+    skillOwner?: string;
+    handoffClass: WikiHandoffClass;
+    profile: WikiHandoffProfileTag;
+    artifactPath: string;
+    artifactHash: string;
+    title: string;
+    whySave: string;
+    evidence: string;
+    reuseScope: string;
+    verificationState: VerificationState;
+    riskScore: number;
+    salience: SalienceScore;
+    decisionKind: WikiWriteDecision["kind"] | "skipped";
+    candidateId?: string;
+    pageId?: string;
+    status: WikiHandoffStatus;
+    createdAt: string;
+    reviewAfter?: string;
+}
+/** One row in the per-skill registry. `defaultSalience` and `shouldSuggest` are
+ * pure functions of an ArtifactSignal — the salience GATE itself stays single-
+ * sourced in the domain (scoreSalience + SALIENCE_THRESHOLDS); a profile only
+ * supplies default component values, never new threshold logic. */
+export interface SkillHandoffProfile {
+    skillName: string;
+    handoffClass: WikiHandoffClass;
+    profile: WikiHandoffProfileTag;
+    defaultReuseScope: string;
+    artifactPatterns: string[];
+    defaultSalience(signal: ArtifactSignal): SalienceComponents;
+    shouldSuggest(signal: ArtifactSignal): boolean;
+}
+/** Map a handoff packet onto the application ProposeInput contract. The provenance-
+ * only fields (skill, profile, artifact hash) are dropped — they live in wiki_handoff,
+ * not in the candidate. The result is assignable to ProposeInput by construction. */
+export declare function toProposeInput(packet: WikiHandoffPacket): ProposeInput;
+//# sourceMappingURL=domain.d.ts.map

package/dist/wiki/handoff/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../../src/wiki/handoff/domain.ts"],"names":[],"mappings":"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"}

package/dist/wiki/handoff/domain.js

@@ -0,0 +1,31 @@
+// Handoff domain. Pure vocabulary + mapper — no IO, no fs, no DB, no network.
+// A knowledge-producing skill describes its terminal artifact as a WikiHandoffPacket;
+// `toProposeInput` maps that packet onto the existing application ProposeInput contract,
+// so the handoff path reuses the single decideWrite/scoreSalience gate rather than
+// re-implementing one. The packet is a SUPERSET of ProposeInput: it adds skill/artifact
+// provenance that the gate does not need but the wiki_handoff store records.
+// Construction helpers (salienceComponents / makeSkillProfile / defineGroup /
+// defaultShouldSuggest / ProfileSpec) live in `profile-factory.ts` so this file stays
+// pure type vocabulary + the mapper.
+// --- Mapper -----------------------------------------------------------------
+/** Map a handoff packet onto the application ProposeInput contract. The provenance-
+ * only fields (skill, profile, artifact hash) are dropped — they live in wiki_handoff,
+ * not in the candidate. The result is assignable to ProposeInput by construction. */
+export function toProposeInput(packet) {
+    return {
+        slug: packet.slug,
+        title: packet.title,
+        content: packet.content,
+        origin: packet.origin,
+        whySave: packet.whySave,
+        evidence: packet.evidence,
+        sourceIds: packet.sourceIds,
+        salience: packet.salience,
+        noveltyDelta: packet.noveltyDelta,
+        reuseScope: packet.reuseScope,
+        verificationState: packet.verificationState,
+        riskScore: packet.riskScore,
+        reviewAfter: packet.reviewAfter,
+    };
+}
+//# sourceMappingURL=domain.js.map

package/dist/wiki/handoff/domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../../../src/wiki/handoff/domain.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,sFAAsF;AACtF,yFAAyF;AACzF,mFAAmF;AACnF,wFAAwF;AACxF,6EAA6E;AA0I7E,8EAA8E;AAC9E,sFAAsF;AACtF,qCAAqC;AAErC,+EAA+E;AAE/E;;qFAEqF;AACrF,MAAM,UAAU,cAAc,CAAC,MAAyB;IACvD,OAAO;QACN,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;QAC3C,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;KAC/B,CAAC;AACH,CAAC"}

package/dist/wiki/handoff/profile-factory.d.ts

@@ -0,0 +1,26 @@
+import type { SalienceComponents } from "../domain/index.js";
+import type { ArtifactSignal, SkillHandoffProfile, WikiHandoffClass, WikiHandoffProfileTag } from "./domain.js";
+/** Build a full SalienceComponents from a partial, zero-filling the rest. */
+export declare function salienceComponents(overrides?: Partial<SalienceComponents>): SalienceComponents;
+/** Declarative spec for a registry row. Family files supply data; `makeSkillProfile`
+ * derives the `defaultSalience`/`shouldSuggest` behavior from the class + base. */
+export interface ProfileSpec {
+    skillName: string;
+    handoffClass: WikiHandoffClass;
+    profile: WikiHandoffProfileTag;
+    defaultReuseScope: string;
+    artifactPatterns: string[];
+    /** Profile-typical salience emphasis before signal nudges. */
+    salienceBase: Partial<SalienceComponents>;
+}
+/** Class-driven suggestion policy. `none` never suggests; `required` suggests for any
+ * substantive artifact; `conditional` suggests only on a project-specific signal. */
+export declare function defaultShouldSuggest(handoffClass: WikiHandoffClass, signal: ArtifactSignal): boolean;
+/** Turn a declarative spec into a registry row. The salience function starts from the
+ * profile base and lets concrete signals raise intent/verified/recurrence and override
+ * novelty + the two penalties. */
+export declare function makeSkillProfile(spec: ProfileSpec): SkillHandoffProfile;
+/** Expand a shared profile spec across many skill names — one registry row each.
+ * Keeps family files declarative: a profile group is a `common` spec plus a name list. */
+export declare function defineGroup(common: Omit<ProfileSpec, "skillName">, skillNames: string[]): SkillHandoffProfile[];
+//# sourceMappingURL=profile-factory.d.ts.map

package/dist/wiki/handoff/profile-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-factory.d.ts","sourceRoot":"","sources":["../../../src/wiki/handoff/profile-factory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEhH,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,SAAS,GAAE,OAAO,CAAC,kBAAkB,CAAM,GAAG,kBAAkB,CAalG;AAED;mFACmF;AACnF,MAAM,WAAW,WAAW;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,8DAA8D;IAC9D,YAAY,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC1C;AAED;qFACqF;AACrF,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,gBAAgB,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAUpG;AAED;;kCAEkC;AAClC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,mBAAmB,CAuBvE;AAED;0FAC0F;AAC1F,wBAAgB,WAAW,CAC1B,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,EACtC,UAAU,EAAE,MAAM,EAAE,GAClB,mBAAmB,EAAE,CAEvB"}

package/dist/wiki/handoff/profile-factory.js

@@ -0,0 +1,65 @@
+// Construction helpers for the handoff profile registry. Separated from domain.ts so the
+// domain file stays pure type vocabulary; this file holds the (still pure, no-IO) logic that
+// turns declarative specs into registry rows and derives salience/suggestion from a signal.
+/** Build a full SalienceComponents from a partial, zero-filling the rest. */
+export function salienceComponents(overrides = {}) {
+    return {
+        explicit_user_intent: 0,
+        verified_outcome: 0,
+        recurrence_or_friction: 0,
+        novelty_vs_existing_wiki: 0,
+        future_reuse_likelihood: 0,
+        source_quality: 0,
+        blast_radius: 0,
+        security_risk_penalty: 0,
+        staleness_penalty: 0,
+        ...overrides,
+    };
+}
+/** Class-driven suggestion policy. `none` never suggests; `required` suggests for any
+ * substantive artifact; `conditional` suggests only on a project-specific signal. */
+export function defaultShouldSuggest(handoffClass, signal) {
+    if (handoffClass === "none")
+        return false;
+    if (signal.contentBytes <= 0)
+        return false;
+    if (handoffClass === "required")
+        return true;
+    return Boolean(signal.verifiedOutcome ||
+        signal.explicitUserIntent ||
+        signal.recurringFriction ||
+        (signal.noveltyDelta ?? 0) > 0);
+}
+/** Turn a declarative spec into a registry row. The salience function starts from the
+ * profile base and lets concrete signals raise intent/verified/recurrence and override
+ * novelty + the two penalties. */
+export function makeSkillProfile(spec) {
+    return {
+        skillName: spec.skillName,
+        handoffClass: spec.handoffClass,
+        profile: spec.profile,
+        defaultReuseScope: spec.defaultReuseScope,
+        artifactPatterns: spec.artifactPatterns,
+        defaultSalience(signal) {
+            const base = salienceComponents(spec.salienceBase);
+            return salienceComponents({
+                ...spec.salienceBase,
+                explicit_user_intent: signal.explicitUserIntent ? 3 : base.explicit_user_intent,
+                verified_outcome: signal.verifiedOutcome ? 3 : base.verified_outcome,
+                recurrence_or_friction: signal.recurringFriction ? 2 : base.recurrence_or_friction,
+                novelty_vs_existing_wiki: signal.noveltyDelta ?? base.novelty_vs_existing_wiki,
+                security_risk_penalty: signal.securityRiskPenalty ?? base.security_risk_penalty,
+                staleness_penalty: signal.stalenessPenalty ?? base.staleness_penalty,
+            });
+        },
+        shouldSuggest(signal) {
+            return defaultShouldSuggest(spec.handoffClass, signal);
+        },
+    };
+}
+/** Expand a shared profile spec across many skill names — one registry row each.
+ * Keeps family files declarative: a profile group is a `common` spec plus a name list. */
+export function defineGroup(common, skillNames) {
+    return skillNames.map((skillName) => makeSkillProfile({ ...common, skillName }));
+}
+//# sourceMappingURL=profile-factory.js.map

package/dist/wiki/handoff/profile-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-factory.js","sourceRoot":"","sources":["../../../src/wiki/handoff/profile-factory.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,6FAA6F;AAC7F,4FAA4F;AAK5F,6EAA6E;AAC7E,MAAM,UAAU,kBAAkB,CAAC,YAAyC,EAAE;IAC7E,OAAO;QACN,oBAAoB,EAAE,CAAC;QACvB,gBAAgB,EAAE,CAAC;QACnB,sBAAsB,EAAE,CAAC;QACzB,wBAAwB,EAAE,CAAC;QAC3B,uBAAuB,EAAE,CAAC;QAC1B,cAAc,EAAE,CAAC;QACjB,YAAY,EAAE,CAAC;QACf,qBAAqB,EAAE,CAAC;QACxB,iBAAiB,EAAE,CAAC;QACpB,GAAG,SAAS;KACZ,CAAC;AACH,CAAC;AAcD;qFACqF;AACrF,MAAM,UAAU,oBAAoB,CAAC,YAA8B,EAAE,MAAsB;IAC1F,IAAI,YAAY,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,MAAM,CAAC,YAAY,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,IAAI,YAAY,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7C,OAAO,OAAO,CACb,MAAM,CAAC,eAAe;QACrB,MAAM,CAAC,kBAAkB;QACzB,MAAM,CAAC,iBAAiB;QACxB,CAAC,MAAM,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,CAAC,CAC/B,CAAC;AACH,CAAC;AAED;;kCAEkC;AAClC,MAAM,UAAU,gBAAgB,CAAC,IAAiB;IACjD,OAAO;QACN,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,eAAe,CAAC,MAAsB;YACrC,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACnD,OAAO,kBAAkB,CAAC;gBACzB,GAAG,IAAI,CAAC,YAAY;gBACpB,oBAAoB,EAAE,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB;gBAC/E,gBAAgB,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB;gBACpE,sBAAsB,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,sBAAsB;gBAClF,wBAAwB,EAAE,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC,wBAAwB;gBAC9E,qBAAqB,EAAE,MAAM,CAAC,mBAAmB,IAAI,IAAI,CAAC,qBAAqB;gBAC/E,iBAAiB,EAAE,MAAM,CAAC,gBAAgB,IAAI,IAAI,CAAC,iBAAiB;aACpE,CAAC,CAAC;QACJ,CAAC;QACD,aAAa,CAAC,MAAsB;YACnC,OAAO,oBAAoB,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACxD,CAAC;KACD,CAAC;AACH,CAAC;AAED;0FAC0F;AAC1F,MAAM,UAAU,WAAW,CAC1B,MAAsC,EACtC,UAAoB;IAEpB,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;AAClF,CAAC"}

package/dist/wiki/handoff/profiles/external.d.ts

@@ -0,0 +1,3 @@
+import type { SkillHandoffProfile } from "../domain.js";
+export declare const externalProfiles: SkillHandoffProfile[];
+//# sourceMappingURL=external.d.ts.map

package/dist/wiki/handoff/profiles/external.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../../../../src/wiki/handoff/profiles/external.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,eAAO,MAAM,gBAAgB,EAAE,mBAAmB,EAwBjD,CAAC"}

package/dist/wiki/handoff/profiles/external.js

@@ -0,0 +1,27 @@
+// External-spec profile family. Knowledge sourced from outside the repo (specs,
+// tickets, fetched docs). Conditional: only worth saving with source provenance
+// and a clean scan — never a single-use lookup.
+import { defineGroup } from "../profile-factory.js";
+export const externalProfiles = [
+    ...defineGroup({
+        handoffClass: "conditional",
+        profile: "external-spec",
+        defaultReuseScope: "external-spec",
+        artifactPatterns: ["tasks/reports/*.md", "tasks/wikis/*/sources.jsonl"],
+        salienceBase: {
+            source_quality: 2,
+            future_reuse_likelihood: 2,
+            novelty_vs_existing_wiki: 1,
+        },
+    }, [
+        "mk:confluence-spec-analyst",
+        "mk:docs-finder",
+        "mk:jira-analyst",
+        "mk:jira-estimator",
+        "mk:jira-evaluator",
+        "mk:pack",
+        "mk:web-to-markdown",
+        "mk:wiki-research",
+    ]),
+];
+//# sourceMappingURL=external.js.map

package/dist/wiki/handoff/profiles/external.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.js","sourceRoot":"","sources":["../../../../src/wiki/handoff/profiles/external.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,gFAAgF;AAChF,gDAAgD;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,MAAM,CAAC,MAAM,gBAAgB,GAA0B;IACtD,GAAG,WAAW,CACb;QACC,YAAY,EAAE,aAAa;QAC3B,OAAO,EAAE,eAAe;QACxB,iBAAiB,EAAE,eAAe;QAClC,gBAAgB,EAAE,CAAC,oBAAoB,EAAE,6BAA6B,CAAC;QACvE,YAAY,EAAE;YACb,cAAc,EAAE,CAAC;YACjB,uBAAuB,EAAE,CAAC;YAC1B,wBAAwB,EAAE,CAAC;SAC3B;KACD,EACD;QACC,4BAA4B;QAC5B,gBAAgB;QAChB,iBAAiB;QACjB,mBAAmB;QACnB,mBAAmB;QACnB,SAAS;QACT,oBAAoB;QACpB,kBAAkB;KAClB,CACD;CACD,CAAC"}

package/dist/wiki/handoff/profiles/framework.d.ts

@@ -0,0 +1,3 @@
+import type { SkillHandoffProfile } from "../domain.js";
+export declare const frameworkProfiles: SkillHandoffProfile[];
+//# sourceMappingURL=framework.d.ts.map

package/dist/wiki/handoff/profiles/framework.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework.d.ts","sourceRoot":"","sources":["../../../../src/wiki/handoff/profiles/framework.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,eAAO,MAAM,iBAAiB,EAAE,mBAAmB,EAyFlD,CAAC"}

package/dist/wiki/handoff/profiles/framework.js

@@ -0,0 +1,83 @@
+// Framework family: architecture analysis, project conventions, and operational
+// workflow recipes. Mostly conditional — generic framework knowledge is NOT worth
+// saving; only repo-specific decisions, conventions, and reusable recipes are.
+import { defineGroup } from "../profile-factory.js";
+export const frameworkProfiles = [
+    // Structured architecture candidates / ADR linkage — always advisory.
+    ...defineGroup({
+        handoffClass: "required",
+        profile: "architecture-analysis",
+        defaultReuseScope: "architecture",
+        artifactPatterns: ["docs/architecture/*.md", "docs/architecture/adr/*.md", "tasks/reports/*.md"],
+        salienceBase: {
+            verified_outcome: 1,
+            future_reuse_likelihood: 2,
+            source_quality: 2,
+            blast_radius: 2,
+        },
+    }, ["mk:improve-codebase-architecture"]),
+    // Design / data decisions — saved only when a project standard is chosen.
+    ...defineGroup({
+        handoffClass: "conditional",
+        profile: "architecture-analysis",
+        defaultReuseScope: "architecture",
+        artifactPatterns: ["docs/architecture/*.md", "docs/design-guidelines.md"],
+        salienceBase: {
+            future_reuse_likelihood: 2,
+            source_quality: 1,
+            blast_radius: 1,
+            novelty_vs_existing_wiki: 1,
+        },
+    }, ["mk:api-design", "mk:database", "mk:frontend-design", "mk:stitch", "mk:tech-graph", "mk:ui-design-system"]),
+    // Repo-specific conventions and reusable strategies.
+    ...defineGroup({
+        handoffClass: "conditional",
+        profile: "project-convention",
+        defaultReuseScope: "convention",
+        artifactPatterns: ["docs/code-standards.md", "docs/project-context.md", "tasks/reports/*.md"],
+        salienceBase: {
+            future_reuse_likelihood: 2,
+            source_quality: 1,
+            novelty_vs_existing_wiki: 1,
+        },
+    }, [
+        "mk:angular",
+        "mk:ask-me",
+        "mk:clean-code",
+        "mk:context-audit",
+        "mk:decision-framework",
+        "mk:docs-init",
+        "mk:document-release",
+        "mk:grill",
+        "mk:intake",
+        "mk:nyquist",
+        "mk:preview",
+        "mk:project-context",
+        "mk:prompt-enhancer",
+        "mk:qa",
+        "mk:qa-manual",
+        "mk:react-patterns",
+        "mk:resolving-merge-conflicts",
+        "mk:scout",
+        "mk:ship",
+        "mk:skill-creator",
+        "mk:typescript",
+        "mk:visual-plan",
+        "mk:vue",
+        "mk:vue-best-practices",
+        "mk:vue-testing-best-practices",
+    ]),
+    // Operational recipes — saved only when they cut future operational friction.
+    ...defineGroup({
+        handoffClass: "conditional",
+        profile: "workflow-recipe",
+        defaultReuseScope: "workflow-recipe",
+        artifactPatterns: ["tasks/reports/*.md"],
+        salienceBase: {
+            recurrence_or_friction: 1,
+            future_reuse_likelihood: 2,
+            source_quality: 1,
+        },
+    }, ["mk:agent-browser", "mk:ghpm", "mk:jira-agile", "mk:jira-bulk", "mk:jira-lifecycle"]),
+];
+//# sourceMappingURL=framework.js.map

package/dist/wiki/handoff/profiles/framework.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework.js","sourceRoot":"","sources":["../../../../src/wiki/handoff/profiles/framework.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,kFAAkF;AAClF,+EAA+E;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,MAAM,CAAC,MAAM,iBAAiB,GAA0B;IACvD,sEAAsE;IACtE,GAAG,WAAW,CACb;QACC,YAAY,EAAE,UAAU;QACxB,OAAO,EAAE,uBAAuB;QAChC,iBAAiB,EAAE,cAAc;QACjC,gBAAgB,EAAE,CAAC,wBAAwB,EAAE,4BAA4B,EAAE,oBAAoB,CAAC;QAChG,YAAY,EAAE;YACb,gBAAgB,EAAE,CAAC;YACnB,uBAAuB,EAAE,CAAC;YAC1B,cAAc,EAAE,CAAC;YACjB,YAAY,EAAE,CAAC;SACf;KACD,EACD,CAAC,kCAAkC,CAAC,CACpC;IACD,0EAA0E;IAC1E,GAAG,WAAW,CACb;QACC,YAAY,EAAE,aAAa;QAC3B,OAAO,EAAE,uBAAuB;QAChC,iBAAiB,EAAE,cAAc;QACjC,gBAAgB,EAAE,CAAC,wBAAwB,EAAE,2BAA2B,CAAC;QACzE,YAAY,EAAE;YACb,uBAAuB,EAAE,CAAC;YAC1B,cAAc,EAAE,CAAC;YACjB,YAAY,EAAE,CAAC;YACf,wBAAwB,EAAE,CAAC;SAC3B;KACD,EACD,CAAC,eAAe,EAAE,aAAa,EAAE,oBAAoB,EAAE,WAAW,EAAE,eAAe,EAAE,qBAAqB,CAAC,CAC3G;IACD,qDAAqD;IACrD,GAAG,WAAW,CACb;QACC,YAAY,EAAE,aAAa;QAC3B,OAAO,EAAE,oBAAoB;QAC7B,iBAAiB,EAAE,YAAY;QAC/B,gBAAgB,EAAE,CAAC,wBAAwB,EAAE,yBAAyB,EAAE,oBAAoB,CAAC;QAC7F,YAAY,EAAE;YACb,uBAAuB,EAAE,CAAC;YAC1B,cAAc,EAAE,CAAC;YACjB,wBAAwB,EAAE,CAAC;SAC3B;KACD,EACD;QACC,YAAY;QACZ,WAAW;QACX,eAAe;QACf,kBAAkB;QAClB,uBAAuB;QACvB,cAAc;QACd,qBAAqB;QACrB,UAAU;QACV,WAAW;QACX,YAAY;QACZ,YAAY;QACZ,oBAAoB;QACpB,oBAAoB;QACpB,OAAO;QACP,cAAc;QACd,mBAAmB;QACnB,8BAA8B;QAC9B,UAAU;QACV,SAAS;QACT,kBAAkB;QAClB,eAAe;QACf,gBAAgB;QAChB,QAAQ;QACR,uBAAuB;QACvB,+BAA+B;KAC/B,CACD;IACD,8EAA8E;IAC9E,GAAG,WAAW,CACb;QACC,YAAY,EAAE,aAAa;QAC3B,OAAO,EAAE,iBAAiB;QAC1B,iBAAiB,EAAE,iBAAiB;QACpC,gBAAgB,EAAE,CAAC,oBAAoB,CAAC;QACxC,YAAY,EAAE;YACb,sBAAsB,EAAE,CAAC;YACzB,uBAAuB,EAAE,CAAC;YAC1B,cAAc,EAAE,CAAC;SACjB;KACD,EACD,CAAC,kBAAkB,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,mBAAmB,CAAC,CACrF;CACD,CAAC"}

package/dist/wiki/handoff/profiles/lifecycle.d.ts

@@ -0,0 +1,3 @@
+import type { SkillHandoffProfile } from "../domain.js";
+export declare const lifecycleProfiles: SkillHandoffProfile[];
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/wiki/handoff/profiles/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/wiki/handoff/profiles/lifecycle.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,eAAO,MAAM,iBAAiB,EAAE,mBAAmB,EA+BlD,CAAC"}

package/dist/wiki/handoff/profiles/lifecycle.js

@@ -0,0 +1,30 @@
+// Lifecycle + root-cause profile family. Skills that orchestrate a full run or
+// diagnose a defect — their terminal report is high-value recall for later agents.
+import { defineGroup } from "../profile-factory.js";
+export const lifecycleProfiles = [
+    ...defineGroup({
+        handoffClass: "required",
+        profile: "lifecycle-run",
+        defaultReuseScope: "lifecycle",
+        artifactPatterns: ["tasks/reports/*.md", "tasks/reviews/*.md", "tasks/autobuild-runs/*"],
+        salienceBase: {
+            verified_outcome: 2,
+            source_quality: 2,
+            future_reuse_likelihood: 2,
+            blast_radius: 1,
+        },
+    }, ["mk:autobuild", "mk:benchmark", "mk:cook", "mk:loop", "mk:trace-analyze", "mk:workflow-orchestrator"]),
+    ...defineGroup({
+        handoffClass: "required",
+        profile: "root-cause",
+        defaultReuseScope: "debugging",
+        artifactPatterns: ["docs/journal/*.md", "tasks/reports/*.md"],
+        salienceBase: {
+            verified_outcome: 2,
+            recurrence_or_friction: 1,
+            future_reuse_likelihood: 2,
+            source_quality: 2,
+        },
+    }, ["mk:build-fix", "mk:fix", "mk:investigate", "mk:problem-solving"]),
+];
+//# sourceMappingURL=lifecycle.js.map

package/dist/wiki/handoff/profiles/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../../../src/wiki/handoff/profiles/lifecycle.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mFAAmF;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,MAAM,CAAC,MAAM,iBAAiB,GAA0B;IACvD,GAAG,WAAW,CACb;QACC,YAAY,EAAE,UAAU;QACxB,OAAO,EAAE,eAAe;QACxB,iBAAiB,EAAE,WAAW;QAC9B,gBAAgB,EAAE,CAAC,oBAAoB,EAAE,oBAAoB,EAAE,wBAAwB,CAAC;QACxF,YAAY,EAAE;YACb,gBAAgB,EAAE,CAAC;YACnB,cAAc,EAAE,CAAC;YACjB,uBAAuB,EAAE,CAAC;YAC1B,YAAY,EAAE,CAAC;SACf;KACD,EACD,CAAC,cAAc,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,kBAAkB,EAAE,0BAA0B,CAAC,CACtG;IACD,GAAG,WAAW,CACb;QACC,YAAY,EAAE,UAAU;QACxB,OAAO,EAAE,YAAY;QACrB,iBAAiB,EAAE,WAAW;QAC9B,gBAAgB,EAAE,CAAC,mBAAmB,EAAE,oBAAoB,CAAC;QAC7D,YAAY,EAAE;YACb,gBAAgB,EAAE,CAAC;YACnB,sBAAsB,EAAE,CAAC;YACzB,uBAAuB,EAAE,CAAC;YAC1B,cAAc,EAAE,CAAC;SACjB;KACD,EACD,CAAC,cAAc,EAAE,QAAQ,EAAE,gBAAgB,EAAE,oBAAoB,CAAC,CAClE;CACD,CAAC"}

package/dist/wiki/handoff/profiles/research.d.ts

@@ -0,0 +1,3 @@
+import type { SkillHandoffProfile } from "../domain.js";
+export declare const researchProfiles: SkillHandoffProfile[];
+//# sourceMappingURL=research.d.ts.map

package/dist/wiki/handoff/profiles/research.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../../../src/wiki/handoff/profiles/research.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,eAAO,MAAM,gBAAgB,EAAE,mBAAmB,EAgCjD,CAAC"}

package/dist/wiki/handoff/profiles/research.js

@@ -0,0 +1,31 @@
+// Planning + decision profile family. Skills that set scope or record a chosen
+// direction — the kind of context whose absence makes a later agent repeat a debate.
+import { defineGroup } from "../profile-factory.js";
+export const researchProfiles = [
+    ...defineGroup({
+        handoffClass: "required",
+        profile: "planning-report",
+        defaultReuseScope: "planning",
+        artifactPatterns: ["tasks/plans/*/plan.md", "tasks/reports/*.md"],
+        salienceBase: {
+            explicit_user_intent: 1,
+            verified_outcome: 1,
+            future_reuse_likelihood: 2,
+            source_quality: 2,
+            blast_radius: 1,
+        },
+    }, ["mk:brainstorming", "mk:plan-ceo-review", "mk:plan-creator", "mk:planning-engine", "mk:sprint-contract", "mk:story-sizer"]),
+    ...defineGroup({
+        handoffClass: "required",
+        profile: "decision-record",
+        defaultReuseScope: "decisions",
+        artifactPatterns: ["docs/architecture/adr/*.md", "tasks/reports/*.md"],
+        salienceBase: {
+            explicit_user_intent: 2,
+            future_reuse_likelihood: 2,
+            source_quality: 2,
+            blast_radius: 1,
+        },
+    }, ["mk:office-hours", "mk:party", "mk:retro"]),
+];
+//# sourceMappingURL=research.js.map

package/dist/wiki/handoff/profiles/research.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research.js","sourceRoot":"","sources":["../../../../src/wiki/handoff/profiles/research.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,qFAAqF;AACrF,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,MAAM,CAAC,MAAM,gBAAgB,GAA0B;IACtD,GAAG,WAAW,CACb;QACC,YAAY,EAAE,UAAU;QACxB,OAAO,EAAE,iBAAiB;QAC1B,iBAAiB,EAAE,UAAU;QAC7B,gBAAgB,EAAE,CAAC,uBAAuB,EAAE,oBAAoB,CAAC;QACjE,YAAY,EAAE;YACb,oBAAoB,EAAE,CAAC;YACvB,gBAAgB,EAAE,CAAC;YACnB,uBAAuB,EAAE,CAAC;YAC1B,cAAc,EAAE,CAAC;YACjB,YAAY,EAAE,CAAC;SACf;KACD,EACD,CAAC,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,gBAAgB,CAAC,CAC3H;IACD,GAAG,WAAW,CACb;QACC,YAAY,EAAE,UAAU;QACxB,OAAO,EAAE,iBAAiB;QAC1B,iBAAiB,EAAE,WAAW;QAC9B,gBAAgB,EAAE,CAAC,4BAA4B,EAAE,oBAAoB,CAAC;QACtE,YAAY,EAAE;YACb,oBAAoB,EAAE,CAAC;YACvB,uBAAuB,EAAE,CAAC;YAC1B,cAAc,EAAE,CAAC;YACjB,YAAY,EAAE,CAAC;SACf;KACD,EACD,CAAC,iBAAiB,EAAE,UAAU,EAAE,UAAU,CAAC,CAC3C;CACD,CAAC"}