mister-wolf 2.16.2 → 2.17.0

package/dist/app/use-cases/create-face-version.d.ts

@@ -0,0 +1,79 @@
+import { MemoryStore } from '../../ports/memory-store.port.js';
+import { EventLog } from '../../ports/event-log.port.js';
+import { Clock } from '../../ports/clock.port.js';
+import { IdGenerator } from '../../ports/id-generator.port.js';
+import { SearchIndex } from '../../ports/search-index.port.js';
+import { MemoryLock } from '../../ports/memory-lock.port.js';
+import { RelationLog } from '../../ports/relation-log.port.js';
+import { MemoryTypeDeclaration } from '../../domain/memory-types.js';
+import { MemoryObject } from '../../domain/schemas/memory-object-schema.js';
+/** Волна 2.17 REQ-03/REQ-04 (design §«Механика версий», §Guard): единая
+ * версионирующая механика лиц — guard, номер версии, supersede head, журнал;
+ * всё под внешним MemoryLock (прецедент tool-librarian.ts:167: вложенные
+ * addMemoryObject/supersedeMemoryObject идут с lock: undefined).
+ * REQ-06 (design §«Запись мутации Стюарда»): мутация Стюарда (initiator
+ * 'steward') атомарно создаёт G17-запись + relation 'mutates' → версия.
+ * T-05: 'migrate'/'seed' — служебные пути (вход migrateFaces/посева base-set,
+ * design §Guard «посев идёт внутренним путём с initiator: 'seed'»): guard
+ * полномочий не применяется, содержание задаёт вызывающий. */
+export type FaceCommand = 'new' | 'restore' | 'breakglass' | 'migrate' | 'seed';
+export type FaceInitiator = 'steward' | 'owner' | 'breakglass' | 'migration' | 'seed';
+/** Поля типа face поверх MemoryObject (декларация — memory-types.ts, T-01). */
+export interface FaceFields {
+    owner_skill: string;
+    /** '1','2',… — номер назначает эта команда под lock. */
+    version: string;
+    /** id версии-основы; отсутствует у первой версии (optional, не null). */
+    based_on?: string;
+    reason: string;
+    initiator: FaceInitiator;
+}
+export type FaceObject = MemoryObject & FaceFields;
+export interface CreateFaceVersionDeps {
+    store: MemoryStore;
+    log: EventLog;
+    clock: Clock;
+    idGen: IdGenerator;
+    index?: SearchIndex;
+    lock?: MemoryLock;
+    relations?: RelationLog;
+    declarations?: readonly MemoryTypeDeclaration[];
+    /** Атрибуция только из env (WOLF_ACTOR / WOLF_SESSION), по умолчанию process.env.
+     * Параметра-актёра у API нет: подмена инициатора (--created-by-подобная)
+     * исключена структурно (design §Guard, F-04). */
+    env?: NodeJS.ProcessEnv;
+}
+export interface CreateFaceVersionInput {
+    command: FaceCommand;
+    ownerSkill: string;
+    /** REQ-04 AC2: причина обязательна — без неё операция падает. */
+    reason: string;
+    /** Тело лица; для new обязательно, restore/breakglass берут из версии-основы. */
+    body?: string;
+    title?: string;
+    tags?: string[];
+    /** Основа: id записи или номер версии ('v2'/'2'). Обязателен для restore/breakglass. */
+    from?: string;
+    /** REQ-06 (G17): обязательны для command='new' (мутация Стюарда); для
+     * restore/breakglass шаблон не применяется (ADR-2: только мутации Стюарда). */
+    minimalChange?: string;
+    boundaries?: string;
+    exampleHelps?: string;
+    exampleKeep?: string;
+    verification?: string;
+    rollback?: string;
+    /** T-09 (design §«Механика версий», строка 88): id предложения, породившего
+     * версию — записывает relation ('proposes', proposal, faceNew). Связь только
+     * фиксируется: применение предложения остаётся решением Стюарда (REQ-09). */
+    fromProposal?: string;
+}
+export interface CreateFaceVersionResult {
+    face: FaceObject;
+    /** Прежняя активная версия, superseded этой операцией; null у первой версии. */
+    supersededId: string | null;
+    /** G17-запись мутации (REQ-06): id note(history); null, если мутация не
+     * Стюардом (restore/breakglass). */
+    mutationRecordId: string | null;
+}
+export declare function createFaceVersion(deps: CreateFaceVersionDeps, input: CreateFaceVersionInput): Promise<CreateFaceVersionResult>;
+//# sourceMappingURL=create-face-version.d.ts.map

package/dist/app/use-cases/create-face-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-face-version.d.ts","sourceRoot":"","sources":["../../../src/app/use-cases/create-face-version.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAS5E;;;;;;;;8DAQ8D;AAC9D,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC;AAChF,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,YAAY,GAAG,WAAW,GAAG,MAAM,CAAC;AAEtF,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,aAAa,CAAC;CAC1B;AAED,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,UAAU,CAAC;AAEnD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,WAAW,CAAC;IACnB,GAAG,EAAE,QAAQ,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,YAAY,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAChD;;qDAEiD;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,WAAW,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,wFAAwF;IACxF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;mFAC+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;iFAE6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,UAAU,CAAC;IACjB,gFAAgF;IAChF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;wCACoC;IACpC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAgFD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,qBAAqB,EAC3B,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CAmLlC"}

package/dist/app/use-cases/create-face-version.js

@@ -0,0 +1,224 @@
+import { resolveCreatedBy, resolveSessionId } from '../../domain/actor.js';
+import { UserFacingError } from '../../domain/errors.js';
+import { addMemoryObject } from './add-memory-object.js';
+import { supersedeMemoryObject } from './supersede-memory-object.js';
+import { createMutationRecord, missingG17Field } from './create-mutation-record.js';
+import { recordRelation } from './record-relation.js';
+const INITIATOR_BY_COMMAND = {
+    new: 'steward',
+    restore: 'owner',
+    breakglass: 'breakglass',
+    migrate: 'migration',
+    seed: 'seed',
+};
+function asFace(obj) {
+    return obj;
+}
+async function facesOfOwner(store, ownerSkill) {
+    return (await store.list({ type: 'face' })).filter((o) => asFace(o).owner_skill === ownerSkill).map(asFace);
+}
+/** Активная (head) версия владельца; null — владельца ещё нет. Дубликаты активных
+ * ловит doctor (NFR-02); здесь детерминированно берётся старшая версия. */
+async function activeFace(store, ownerSkill) {
+    const active = (await facesOfOwner(store, ownerSkill)).filter((f) => f.status === 'active');
+    if (active.length === 0)
+        return null;
+    return active.sort((a, b) => Number(b.version) - Number(a.version))[0];
+}
+/** Резолв ссылки на основу: mem_-id напрямую, иначе номер версии ('v2'/'2'). */
+async function resolveBase(store, ownerSkill, ref) {
+    if (ref.startsWith('mem_')) {
+        const obj = await store.get(ref);
+        if (!obj || obj.type !== 'face' || asFace(obj).owner_skill !== ownerSkill) {
+            throw new UserFacingError(`Face version not found for ${ownerSkill}: ${ref}`);
+        }
+        return asFace(obj);
+    }
+    const n = ref.replace(/^v/, '');
+    const found = (await facesOfOwner(store, ownerSkill)).filter((f) => f.version === n);
+    if (found.length === 0)
+        throw new UserFacingError(`Face version not found for ${ownerSkill}: ${ref}`);
+    return found.sort((a, b) => Number(b.version) - Number(a.version))[0];
+}
+/** Guard (design §Guard): new — строго agent:steward; restore/breakglass — user:*;
+ * breakglass дополнительно отказывает из агент-сессии (WOLF_SESSION=opc-*).
+ * migrate/seed — служебные пути (T-05): без проверки полномочий — вход
+ * внутренний (migrateFaces / посев base-set), содержание переносится дословно.
+ * null — доступ разрешён. */
+function guardFailure(command, actor, sessionId) {
+    if (command === 'migrate' || command === 'seed')
+        return null;
+    if (command === 'new') {
+        if (actor !== 'agent:steward') {
+            return `Face mutation is steward-only: actor "${actor}" is not agent:steward (attribution is env-only, WOLF_ACTOR)`;
+        }
+        return null;
+    }
+    if (!actor.startsWith('user:')) {
+        return `face ${command} is owner-only: actor "${actor}" is not user:* (attribution is env-only, WOLF_ACTOR)`;
+    }
+    if (command === 'breakglass' && sessionId !== null && sessionId.startsWith('opc-')) {
+        return 'breakglass is not available from an agent session (WOLF_SESSION=opc-*)';
+    }
+    return null;
+}
+async function appendDenied(deps, ownerSkill, actor, command) {
+    const now = deps.clock.now();
+    const event = {
+        id: deps.idGen.generateEventId(now),
+        type: 'memory.face.denied',
+        timestamp: now.toISOString(),
+        actor,
+        payload: { owner_skill: ownerSkill, actor, command },
+    };
+    await deps.log.append(event);
+}
+export async function createFaceVersion(deps, input) {
+    const env = deps.env ?? process.env;
+    const actor = resolveCreatedBy(undefined, env);
+    const sessionId = resolveSessionId(env);
+    if (!input.ownerSkill || input.ownerSkill.trim() === '') {
+        throw new UserFacingError('Face version requires owner_skill');
+    }
+    if (!input.reason || input.reason.trim() === '') {
+        throw new UserFacingError('Face version requires a reason (REQ-04)');
+    }
+    if ((input.command === 'restore' || input.command === 'breakglass') && !input.from) {
+        throw new UserFacingError(`face ${input.command} requires the base version (--from <id|vN>)`);
+    }
+    const restoreLikeCommand = input.command === 'restore' || input.command === 'breakglass';
+    if (!restoreLikeCommand && (input.body === undefined || input.body.trim() === '')) {
+        throw new UserFacingError(`face ${input.command} requires a body`);
+    }
+    const run = async () => {
+        const deny = guardFailure(input.command, actor, sessionId);
+        if (deny !== null) {
+            await appendDenied(deps, input.ownerSkill, actor, input.command);
+            throw new UserFacingError(deny);
+        }
+        // REQ-06 AC2: шаблон G17 неопционален для мутации Стюарда — проверка ДО
+        // любых записей: без обязательных полей операция целиком не выполняется.
+        const g17 = {
+            reason: input.reason,
+            minimalChange: input.minimalChange,
+            boundaries: input.boundaries,
+            exampleHelps: input.exampleHelps,
+            exampleKeep: input.exampleKeep,
+            verification: input.verification,
+            rollback: input.rollback,
+        };
+        if (input.command === 'new') {
+            const missing = missingG17Field(g17);
+            if (missing !== null) {
+                throw new UserFacingError(`Face mutation requires G17 field "${missing}" (REQ-06: the template is not optional)`);
+            }
+        }
+        // T-09: валидация предложения ДО любых записей — битая ссылка не оставляет
+        // половину операции (та же атомарность, что у G17-проверки выше)
+        if (input.fromProposal !== undefined) {
+            const proposal = await deps.store.get(input.fromProposal);
+            if (!proposal) {
+                throw new UserFacingError(`Proposal not found: ${input.fromProposal}`);
+            }
+            if (proposal.facet !== 'proposal') {
+                throw new UserFacingError(`Memory object ${input.fromProposal} is not a proposal (facet=proposal required)`);
+            }
+        }
+        // Номер версии и head — строго под lock: параллельные вызовы сериализуются.
+        const cur = await activeFace(deps.store, input.ownerSkill);
+        const base = input.from ? await resolveBase(deps.store, input.ownerSkill, input.from) : cur;
+        const nextVersion = (await facesOfOwner(deps.store, input.ownerSkill)).reduce((m, f) => Math.max(m, Number(f.version) || 0), 0) + 1;
+        const restoreLike = input.command === 'restore' || input.command === 'breakglass';
+        const source = restoreLike ? base : null;
+        const title = restoreLike ? source.title : (input.title ?? `Face: ${input.ownerSkill}`);
+        const body = restoreLike ? source.body : input.body;
+        const tags = restoreLike ? source.tags : (input.tags ?? []);
+        const extra = {
+            owner_skill: input.ownerSkill,
+            version: String(nextVersion),
+            reason: input.reason,
+            initiator: INITIATOR_BY_COMMAND[input.command],
+        };
+        if (base)
+            extra.based_on = base.id;
+        // lock не передаём: мы уже внутри deps.lock.withLock (FsMemoryLock не реентерабелен)
+        const { object } = await addMemoryObject({
+            store: deps.store,
+            log: deps.log,
+            clock: deps.clock,
+            idGen: deps.idGen,
+            index: deps.index,
+            declarations: deps.declarations,
+        }, { type: 'face', title, body, tags, createdBy: actor, extra, internalFacePath: true });
+        const face = asFace(object);
+        let supersededId = null;
+        if (cur && cur.id !== face.id) {
+            await supersedeMemoryObject({ store: deps.store, log: deps.log, clock: deps.clock, idGen: deps.idGen, index: deps.index }, cur.id, face.id);
+            supersededId = cur.id;
+        }
+        // REQ-06 (design §«Механика версий»): initiator 'steward' → атомарно
+        // G17-запись note(history) + relation 'mutates' → версия; та же
+        // lock-транзакция (внутренние вызовы без lock).
+        let mutationRecordId = null;
+        if (INITIATOR_BY_COMMAND[input.command] === 'steward') {
+            const note = await createMutationRecord({
+                store: deps.store,
+                log: deps.log,
+                clock: deps.clock,
+                idGen: deps.idGen,
+                index: deps.index,
+                relations: deps.relations,
+            }, {
+                ownerSkill: input.ownerSkill,
+                version: face.version,
+                faceId: face.id,
+                createdBy: actor,
+                reason: g17.reason,
+                minimalChange: g17.minimalChange,
+                boundaries: g17.boundaries,
+                exampleHelps: g17.exampleHelps,
+                exampleKeep: g17.exampleKeep,
+                verification: g17.verification,
+                rollback: g17.rollback,
+            });
+            mutationRecordId = note.id;
+        }
+        // T-09 (design §«Механика версий», строка 88): --from-proposal → relation
+        // ('proposes', proposal, faceNew); только связь, не применение (REQ-09)
+        if (input.fromProposal !== undefined) {
+            await recordRelation({ relations: deps.relations, idGen: deps.idGen }, deps.clock.now(), input.fromProposal, 'proposes', face.id, 'system');
+        }
+        // Design §События журнала: versioned — на КАЖДУЮ версию (включая breakglass,
+        // REQ-07 «результат = новая версия»); breakglass дополнительно журналируется
+        // own-событием в составе самой операции (REQ-07 AC2). Порядок: versioned, затем breakglass.
+        const now = deps.clock.now();
+        const versionPayload = {
+            owner_skill: input.ownerSkill,
+            from: supersededId,
+            new: face.id,
+            initiator: INITIATOR_BY_COMMAND[input.command],
+            reason: input.reason,
+        };
+        const versioned = {
+            id: deps.idGen.generateEventId(now),
+            type: 'memory.face.versioned',
+            timestamp: now.toISOString(),
+            actor,
+            payload: versionPayload,
+        };
+        await deps.log.append(versioned);
+        if (input.command === 'breakglass') {
+            const breakglass = {
+                id: deps.idGen.generateEventId(now),
+                type: 'memory.face.breakglass',
+                timestamp: now.toISOString(),
+                actor,
+                payload: versionPayload,
+            };
+            await deps.log.append(breakglass);
+        }
+        return { face, supersededId, mutationRecordId };
+    };
+    return deps.lock ? deps.lock.withLock(run) : run();
+}
+//# sourceMappingURL=create-face-version.js.map

package/dist/app/use-cases/create-face-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-face-version.js","sourceRoot":"","sources":["../../../src/app/use-cases/create-face-version.ts"],"names":[],"mappings":"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"}

package/dist/app/use-cases/create-mutation-record.d.ts

@@ -0,0 +1,55 @@
+import { MemoryStore } from '../../ports/memory-store.port.js';
+import { EventLog } from '../../ports/event-log.port.js';
+import { Clock } from '../../ports/clock.port.js';
+import { IdGenerator } from '../../ports/id-generator.port.js';
+import { SearchIndex } from '../../ports/search-index.port.js';
+import { RelationLog } from '../../ports/relation-log.port.js';
+import { MemoryObject } from '../../domain/schemas/memory-object-schema.js';
+/** Волна 2.17 REQ-06 (design ADR-2, §«Запись мутации Стюарда»): G17-запись
+ * note(history), атомарно создаваемая вместе с версией лица при мутации
+ * Стюардом; relation ('mutates', запись, face-версия). Прецедент спец-полей
+ * note — scaffold-agent.ts:152: addMemoryObject не пускает G17-поля в extra
+ * (guard полей note), поэтому запись сеем напрямую через store.save — она
+ * создаётся только версионирующим путём, не свободным add. Вызывается из-под
+ * внешнего MemoryLock (createFaceVersion) — lock здесь не пере-берётся. */
+/** Поля шаблона G17 (имена на записи — snake_case дословно из design). */
+export interface MutationG17Input {
+    reason: string;
+    minimalChange: string;
+    boundaries: string;
+    exampleHelps: string;
+    exampleKeep: string;
+    verification: string;
+    rollback: string;
+}
+/** REQ-06 AC2: шаблон неопционален — имя первого пустого/отсутствующего поля
+ * (null — всё на месте). Общая проверка для createFaceVersion и записи. */
+export declare function missingG17Field(input: Partial<MutationG17Input>): string | null;
+/** boundaries (REQ-06 AC3) фиксирует, что НЕ меняется — суть/рамка агента. */
+export type MutationRecord = MemoryObject & {
+    facet: 'history';
+    reason: string;
+    minimal_change: string;
+    boundaries: string;
+    example_helps: string;
+    example_keep: string;
+    verification: string;
+    rollback: string;
+};
+export interface CreateMutationRecordDeps {
+    store: MemoryStore;
+    log: EventLog;
+    clock: Clock;
+    idGen: IdGenerator;
+    index?: SearchIndex;
+    relations?: RelationLog;
+}
+export interface CreateMutationRecordInput extends MutationG17Input {
+    ownerSkill: string;
+    /** Номер создаваемой версии (title: 'mutation: <owner_skill> v<ver>'). */
+    version: string;
+    faceId: string;
+    createdBy: string;
+}
+export declare function createMutationRecord(deps: CreateMutationRecordDeps, input: CreateMutationRecordInput): Promise<MutationRecord>;
+//# sourceMappingURL=create-mutation-record.d.ts.map

package/dist/app/use-cases/create-mutation-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-mutation-record.d.ts","sourceRoot":"","sources":["../../../src/app/use-cases/create-mutation-record.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAK5E;;;;;;2EAM2E;AAE3E,0EAA0E;AAC1E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAYD;2EAC2E;AAC3E,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,MAAM,GAAG,IAAI,CAM/E;AAED,8EAA8E;AAC9E,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG;IAC1C,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,WAAW,CAAC;IACnB,GAAG,EAAE,QAAQ,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,SAAS,CAAC,EAAE,WAAW,CAAC;CACzB;AAED,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,wBAAwB,EAC9B,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,cAAc,CAAC,CAiEzB"}

package/dist/app/use-cases/create-mutation-record.js

@@ -0,0 +1,78 @@
+import { governanceDefaults } from '../../domain/governance.js';
+import { UserFacingError } from '../../domain/errors.js';
+import { recordRelation } from './record-relation.js';
+const G17_FIELDS = [
+    { key: 'reason', name: 'reason' },
+    { key: 'minimalChange', name: 'minimal_change' },
+    { key: 'boundaries', name: 'boundaries' },
+    { key: 'exampleHelps', name: 'example_helps' },
+    { key: 'exampleKeep', name: 'example_keep' },
+    { key: 'verification', name: 'verification' },
+    { key: 'rollback', name: 'rollback' },
+];
+/** REQ-06 AC2: шаблон неопционален — имя первого пустого/отсутствующего поля
+ * (null — всё на месте). Общая проверка для createFaceVersion и записи. */
+export function missingG17Field(input) {
+    for (const { key, name } of G17_FIELDS) {
+        const v = input[key];
+        if (typeof v !== 'string' || v.trim() === '')
+            return name;
+    }
+    return null;
+}
+export async function createMutationRecord(deps, input) {
+    const missing = missingG17Field(input);
+    if (missing !== null) {
+        throw new UserFacingError(`Face mutation record requires G17 field "${missing}" (REQ-06: the template is not optional)`);
+    }
+    const now = deps.clock.now();
+    const defaults = governanceDefaults(input.createdBy);
+    const title = `mutation: ${input.ownerSkill} v${input.version}`;
+    const note = {
+        id: deps.idGen.generateMemoryId(now, title),
+        type: 'note',
+        facet: 'history',
+        title,
+        body: '',
+        status: 'active',
+        review_state: input.createdBy.startsWith('agent:') ? 'proposed' : 'accepted',
+        confidence: 'medium',
+        importance: 0.5,
+        created_at: now.toISOString(),
+        updated_at: now.toISOString(),
+        created_by: input.createdBy,
+        schema_version: 1,
+        source: { kind: 'manual' },
+        related: { files: [], docs: [], decisions: [] },
+        tags: [],
+        superseded_by: null,
+        memory_class: defaults.memory_class,
+        truth_role: defaults.truth_role,
+        lifetime: defaults.lifetime,
+        reason: input.reason,
+        minimal_change: input.minimalChange,
+        boundaries: input.boundaries,
+        example_helps: input.exampleHelps,
+        example_keep: input.exampleKeep,
+        verification: input.verification,
+        rollback: input.rollback,
+    };
+    await deps.store.save(note);
+    await deps.log.append({
+        id: deps.idGen.generateEventId(now),
+        type: 'memory.added',
+        timestamp: now.toISOString(),
+        actor: input.createdBy,
+        payload: { memory_id: note.id, type: 'note' },
+    });
+    if (deps.index) {
+        await deps.index.indexObject(note);
+    }
+    // Та же lock-транзакция, что и версия: lock не передаём (FsMemoryLock не
+    // реентерабелен, внешний withLock держит createFaceVersion).
+    if (deps.relations) {
+        await recordRelation({ relations: deps.relations, idGen: deps.idGen }, now, note.id, 'mutates', input.faceId, 'system');
+    }
+    return note;
+}
+//# sourceMappingURL=create-mutation-record.js.map

package/dist/app/use-cases/create-mutation-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-mutation-record.js","sourceRoot":"","sources":["../../../src/app/use-cases/create-mutation-record.ts"],"names":[],"mappings":"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"}

package/dist/app/use-cases/deliver-proposal.d.ts

@@ -0,0 +1,26 @@
+import { MemoryStore } from '../../ports/memory-store.port.js';
+import { EventLog } from '../../ports/event-log.port.js';
+import { Clock } from '../../ports/clock.port.js';
+import { IdGenerator } from '../../ports/id-generator.port.js';
+import { SearchIndex } from '../../ports/search-index.port.js';
+import { MemoryLock } from '../../ports/memory-lock.port.js';
+import type { ProposalObject } from './save-proposal.js';
+/** Волна 2.17 T-09 (REQ-09, design §«Сигнал-фасет proposal»): доставка
+ * предложения — явный отдельный шаг `wolf propose deliver <id>`. Только
+ * заполняет delivered_at и журналирует memory.proposal.delivered {id,
+ * addressee}: императивный текст НЕ применяется, лицо/память адресата не
+ * меняются, полномочия автора не меняются — предложение остаётся сигналом
+ * до решения Стюарда/владельца. Сохранение ≠ доставка ≠ обработка (AC4):
+ * повторная доставка — отказ. */
+export interface DeliverProposalDeps {
+    store: MemoryStore;
+    log: EventLog;
+    clock: Clock;
+    idGen: IdGenerator;
+    index?: SearchIndex;
+    lock?: MemoryLock;
+    /** Атрибуция доставляющего — только env (WOLF_ACTOR). */
+    env?: NodeJS.ProcessEnv;
+}
+export declare function deliverProposal(deps: DeliverProposalDeps, id: string): Promise<ProposalObject>;
+//# sourceMappingURL=deliver-proposal.d.ts.map

package/dist/app/use-cases/deliver-proposal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliver-proposal.d.ts","sourceRoot":"","sources":["../../../src/app/use-cases/deliver-proposal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAI7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;;;;;iCAMiC;AAEjC,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,WAAW,CAAC;IACnB,GAAG,EAAE,QAAQ,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAiCpG"}

package/dist/app/use-cases/deliver-proposal.js

@@ -0,0 +1,35 @@
+import { resolveCreatedBy } from '../../domain/actor.js';
+import { UserFacingError } from '../../domain/errors.js';
+export async function deliverProposal(deps, id) {
+    const actor = resolveCreatedBy(undefined, deps.env ?? process.env);
+    const run = async () => {
+        const obj = (await deps.store.get(id));
+        if (!obj)
+            throw new UserFacingError(`Memory object not found: ${id}`);
+        if (obj.facet !== 'proposal') {
+            throw new UserFacingError(`Memory object ${id} is not a proposal (facet: ${obj.facet ?? '—'})`);
+        }
+        if (obj.delivered_at !== undefined) {
+            throw new UserFacingError(`Proposal ${id} was already delivered at ${obj.delivered_at} (saving ≠ delivery ≠ processing; delivery is a one-time step)`);
+        }
+        const now = deps.clock.now();
+        // delivered_at вне схемы сохранения (type-schema-builder) — пишется только
+        // здесь; passthrough-схема объекта пропускает ключ через frontmatter
+        const updated = await deps.store.update(id, {
+            delivered_at: now.toISOString(),
+        });
+        await deps.log.append({
+            id: deps.idGen.generateEventId(now),
+            type: 'memory.proposal.delivered',
+            timestamp: now.toISOString(),
+            actor,
+            payload: { id, addressee: obj.addressee },
+        });
+        if (deps.index) {
+            await deps.index.indexObject(updated);
+        }
+        return updated;
+    };
+    return deps.lock ? deps.lock.withLock(run) : run();
+}
+//# sourceMappingURL=deliver-proposal.js.map

package/dist/app/use-cases/deliver-proposal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliver-proposal.js","sourceRoot":"","sources":["../../../src/app/use-cases/deliver-proposal.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAsBzD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAyB,EAAE,EAAU;IACzE,MAAM,KAAK,GAAG,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;IACnE,MAAM,GAAG,GAAG,KAAK,IAA6B,EAAE;QAC9C,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAA0B,CAAC;QAChE,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,eAAe,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAC;QACtE,IAAI,GAAG,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAM,IAAI,eAAe,CAAC,iBAAiB,EAAE,8BAA8B,GAAG,CAAC,KAAK,IAAI,GAAG,GAAG,CAAC,CAAC;QAClG,CAAC;QACD,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,IAAI,eAAe,CACvB,YAAY,EAAE,6BAA6B,GAAG,CAAC,YAAY,gEAAgE,CAC5H,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAC7B,2EAA2E;QAC3E,qEAAqE;QACrE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE;YAC1C,YAAY,EAAE,GAAG,CAAC,WAAW,EAAE;SACP,CAAC,CAAC;QAC5B,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;YACpB,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC;YACnC,IAAI,EAAE,2BAA2B;YACjC,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE;YAC5B,KAAK;YACL,OAAO,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE;SAC1C,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,OAAyB,CAAC;IACnC,CAAC,CAAC;IACF,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AACrD,CAAC"}

package/dist/app/use-cases/migrate-faces.d.ts

@@ -0,0 +1,47 @@
+import { MemoryStore } from '../../ports/memory-store.port.js';
+import { EventLog } from '../../ports/event-log.port.js';
+import { Clock } from '../../ports/clock.port.js';
+import { IdGenerator } from '../../ports/id-generator.port.js';
+import { SearchIndex } from '../../ports/search-index.port.js';
+import { MemoryLock } from '../../ports/memory-lock.port.js';
+import { MemoryTypeDeclaration } from '../../domain/memory-types.js';
+/** Волна 2.17 T-05 (design §«Миграция legacy-playbook → face», REQ-02):
+ * идемпотентная физическая миграция legacy-записей лица в контракт face.
+ * Кандидат — запись, читаемая как note + facet howto + непустой owner_skill
+ * (включая legacy-тип playbook: alias-резолв P211 отдаёт его как note+howto);
+ * howto без owner_skill не мигрируется (AC4 — не всякий howto есть лицо).
+ *
+ * Поэтапность (§Отказов): каждый owner_skill — независимая итерация; падение
+ * на N-м не откатывает N-1 (supersede каждой записи уже завершён), ошибка
+ * попадает в report.failed, обход продолжается. Внешний lock НЕ держим —
+ * каждую версию создаёт createFaceVersion под собственным lock (FsMemoryLock
+ * не реентерабелен, прецедент tool-librarian.ts:167). */
+export interface MigrateFacesDeps {
+    store: MemoryStore;
+    log: EventLog;
+    clock: Clock;
+    idGen: IdGenerator;
+    index?: SearchIndex;
+    lock?: MemoryLock;
+    declarations?: readonly MemoryTypeDeclaration[];
+    env?: NodeJS.ProcessEnv;
+}
+export interface MigrateOutcome {
+    ownerSkill: string;
+    action: 'migrated' | 'skipped';
+    faceId?: string;
+    headId?: string;
+    reason: string;
+}
+export interface MigrateFacesReport {
+    outcomes: MigrateOutcome[];
+    /** REQ-02 AC4: howto-записи без owner_skill — не кандидаты (skip с отчётом). */
+    skippedHowtoIds: string[];
+    /** §Отказов: ошибки по владельцам; уже мигрированные N-1 остаются на месте. */
+    failed: {
+        ownerSkill: string;
+        error: string;
+    }[];
+}
+export declare function migrateFaces(deps: MigrateFacesDeps): Promise<MigrateFacesReport>;
+//# sourceMappingURL=migrate-faces.d.ts.map

package/dist/app/use-cases/migrate-faces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-faces.d.ts","sourceRoot":"","sources":["../../../src/app/use-cases/migrate-faces.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAKrE;;;;;;;;;;yDAUyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,WAAW,CAAC;IACnB,GAAG,EAAE,QAAQ,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,YAAY,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,gFAAgF;IAChF,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,+EAA+E;IAC/E,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACjD;AAQD,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAwDtF"}