@orkastery/cli 0.2.0 → 0.3.0

package/dist/orkmind.js

@@ -16,7 +16,7 @@
  *     declarada no manifesto (`memory.database_url_env`). Variavel nao declarada ou vazia
  *     nao vira "usa a base padrao": vira degradacao. E o precedente do incidente
  *     memory-orkmind, em que a memoria de um produto foi parar na base de outro.
- *  3. GOVERNANCA. O `ork` grava com `source: agent` e NUNCA cria entrada `mandatory` nem
+ *  3. GOVERNANCA. `human` exige decision com proveniencia confirmada de human_gate; nunca `mandatory` nem
  *     `rule`/`instruction` com prioridade `critical`. Regra critica so nasce de humano
  *     autenticado. Aqui isso e checado antes de qualquer chamada, nao depois.
  */
@@ -54,19 +54,30 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DriverEmMemoria = exports.DriverCliOrkMind = exports.ESQUEMA_ORKMIND = exports.DIMENSOES = exports.COLECOES_DE_GOVERNANCA = exports.COLECOES_DO_ORK = void 0;
+exports.DriverEmMemoria = exports.DriverCliOrkMind = exports.LIMITE_CONSULTA_MAXIMO = exports.LIMITE_CONSULTA_PADRAO = exports.ESQUEMA_ORKMIND = exports.DIMENSOES = exports.COLECOES_DE_GOVERNANCA = exports.COLECOES_DO_ORK = void 0;
 exports.enderecoDeMemoria = enderecoDeMemoria;
 exports.lerEndereco = lerEndereco;
 exports.violacoesDeGovernanca = violacoesDeGovernanca;
 exports.casaTags = casaTags;
+exports.criarEscopoDeLeitura = criarEscopoDeLeitura;
+exports.validarConsultaDelimitada = validarConsultaDelimitada;
+exports.tagsDoEscopo = tagsDoEscopo;
+exports.pertenceAoEscopo = pertenceAoEscopo;
+exports.concluirConsultaDelimitada = concluirConsultaDelimitada;
 exports.entradaDoJson = entradaDoJson;
+exports.camposNativos = camposNativos;
+exports.agenteProspectivoValido = agenteProspectivoValido;
+exports.prospectivaCompativel = prospectivaCompativel;
 exports.configDoManifesto = configDoManifesto;
 exports.resolverRegime = resolverRegime;
 exports.filtrarPorTags = filtrarPorTags;
 exports.relativoDaRaiz = relativoDaRaiz;
 const path = __importStar(require("node:path"));
+const fs = __importStar(require("node:fs"));
 const node_child_process_1 = require("node:child_process");
-/** As colecoes do OrkMind que o `ork` grava (visao unificada, tabela da secao 6). */
+const node_crypto_1 = require("node:crypto");
+const node_util_1 = require("node:util");
+/** As colecoes do OrkMind que o `ork` grava (guia: docs/guias/memoria-e-handoff.md). */
 exports.COLECOES_DO_ORK = [
     'decision',
     'handoff',
@@ -112,6 +123,22 @@ function lerEndereco(endereco) {
  */
 function violacoesDeGovernanca(entrada) {
     const problemas = [];
+    if ('scope' in entrada && entrada.scope !== 'project')
+        problemas.push('scope fora do contrato project');
+    if (['orkastery_identity', 'orkastery_identity_version', 'orkastery_prospective'].some(k => k in entrada.metadata))
+        problemas.push('metadata de identidade reservada');
+    if (entrada.mandatory)
+        problemas.push('mandatory proibido');
+    if (entrada.source && !['agent', 'human'].includes(entrada.source))
+        problemas.push('source proibido');
+    if (entrada.source === 'human') {
+        const p = entrada.metadata.proveniencia;
+        if (entrada.collection !== 'decision' || entrada.priority === 'critical' ||
+            !p || p.tipo !== 'human_gate' || p.source !== 'human' || p.confirmado !== true ||
+            !['autor', 'evento', 'evidencia', 'sha256'].every(k => typeof p[k] === 'string' && p[k])) {
+            problemas.push('source human exige decision nao critica e proveniencia de human_gate confirmado');
+        }
+    }
     if (!exports.COLECOES_DO_ORK.includes(entrada.collection)) {
         problemas.push(`colecao "${entrada.collection}" fora do escopo do ork (${exports.COLECOES_DO_ORK.join(', ')})`);
     }
@@ -153,6 +180,67 @@ function casaTags(entrada, consulta) {
     }
     return todasCasaram || (entrada.mandatory && algumaCasou);
 }
+exports.LIMITE_CONSULTA_PADRAO = 100;
+exports.LIMITE_CONSULTA_MAXIMO = 1000;
+function objetoDeConsulta(x) {
+    return !!x && typeof x === 'object' && !Array.isArray(x);
+}
+function textoDeConsulta(x, max) {
+    return typeof x === 'string' && x.length > 0 && x.length <= max && !/[\x00-\x1f\x7f]/.test(x);
+}
+/** Delimitacao de leitura, nao credencial. O chamador operacional deriva tenant do manifesto. */
+function criarEscopoDeLeitura(manifesto, thread) {
+    const tenant = manifesto.memory.tenant || manifesto.project.name;
+    return validarConsultaDelimitada({ collection: 'handoff', escopo: { tenant, thread },
+        tags: {}, limite: exports.LIMITE_CONSULTA_PADRAO }).escopo;
+}
+/** Copia validada impede mutacao do escopo/tags entre validar e transportar. */
+function validarConsultaDelimitada(bruto) {
+    const falhar = () => { throw Error('memory.query.invalid'); };
+    if (!objetoDeConsulta(bruto) || Object.keys(bruto).some(k => !['collection', 'escopo', 'tags', 'limite'].includes(k)))
+        return falhar();
+    const { collection, escopo, tags, limite } = bruto;
+    if (!exports.COLECOES_DO_ORK.includes(collection) || !objetoDeConsulta(escopo) ||
+        Object.keys(escopo).some(k => !['tenant', 'thread'].includes(k)) ||
+        !textoDeConsulta(escopo.tenant, 128) || !textoDeConsulta(escopo.thread, 128) ||
+        !/^[a-z0-9][a-z0-9_-]*$/.test(escopo.thread) || !Number.isInteger(limite) ||
+        Number(limite) < 1 || Number(limite) > exports.LIMITE_CONSULTA_MAXIMO || !objetoDeConsulta(tags))
+        return falhar();
+    const copia = {};
+    for (const [k, values] of Object.entries(tags)) {
+        if (!exports.DIMENSOES.includes(k) || !Array.isArray(values) || values.length > 32 ||
+            !values.every(v => textoDeConsulta(v, 256)))
+            return falhar();
+        if ((k === 'project' && values.some(v => v !== escopo.tenant)) ||
+            (k === 'situation' && values.some(v => v.startsWith('thread:') && v !== 'thread:' + escopo.thread))) {
+            throw Error('memory.query.scope-conflict');
+        }
+        copia[k] = [...values];
+        Object.freeze(copia[k]);
+    }
+    return Object.freeze({ collection: collection,
+        escopo: Object.freeze({ tenant: escopo.tenant, thread: escopo.thread }),
+        tags: Object.freeze(copia), limite: Number(limite) });
+}
+/** Apenas as duas fronteiras obrigatorias: filtros extras perderiam mandatory valida. */
+function tagsDoEscopo(escopo) {
+    return { project: [escopo.tenant], situation: ['thread:' + escopo.thread] };
+}
+function pertenceAoEscopo(e, q) {
+    return e.collection === q.collection && Object.entries(tagsDoEscopo(q.escopo))
+        .every(([k, values]) => values.every(v => e.tags[k]?.includes(v)));
+}
+/** Saturacao antes de filtros locais, inclusive procura por id: ausencia precisa ser provada. */
+function concluirConsultaDelimitada(dados, q) {
+    if (!Array.isArray(dados))
+        throw Error('memory.query.response-invalid');
+    if (dados.length >= q.limite)
+        throw Error('memory.query.window-saturated');
+    if (dados.some(e => !pertenceAoEscopo(e, q)))
+        throw Error('memory.query.scope-violation');
+    return filtrarPorTags(dados, { collection: q.collection, tags: { ...q.tags,
+            project: [q.escopo.tenant] } });
+}
 /** Normaliza uma entrada como o OrkMind a devolve (`orkmind export`). */
 function entradaDoJson(bruto) {
     if (!bruto || typeof bruto !== 'object')
@@ -183,6 +271,10 @@ function entradaDoJson(bruto) {
         metadata: o.metadata && typeof o.metadata === 'object' && !Array.isArray(o.metadata)
             ? o.metadata
             : {},
+        parent_id: typeof o.parent_id === 'string' ? o.parent_id : null,
+        author_id: typeof o.author_id === 'string' ? o.author_id : null,
+        visibility: typeof o.visibility === 'string' ? o.visibility : undefined,
+        protected: typeof o.protected === 'boolean' ? o.protected : undefined,
         criadaEm: typeof o.created_at === 'string' ? o.created_at : '',
     };
 }
@@ -201,101 +293,248 @@ class DriverCliOrkMind {
         this.config = config;
         this.nome = `cli:${config.cli}`;
     }
-    rodar(args) {
-        const r = (0, node_child_process_1.spawnSync)(this.config.cli, args, {
-            encoding: 'utf8',
-            timeout: this.config.timeoutMs,
-            // A base do tenant e a UNICA que entra aqui. Sem `ORKMIND_DATABASE_URL` herdada do
-            // ambiente do builder: isso e como memoria de um produto vaza para a base de outro.
-            env: { ...process.env, ORKMIND_DATABASE_URL: this.config.dsn },
+    python() {
+        const cli = this.config.cli;
+        const candidatos = cli.includes(path.sep) ? [path.resolve(cli)] :
+            (process.env.PATH ?? '').split(path.delimiter).map(p => path.join(p, cli));
+        const executavel = candidatos.find(p => {
+            try {
+                fs.accessSync(p, fs.constants.X_OK);
+                return fs.statSync(p).isFile();
+            }
+            catch {
+                return false;
+            }
         });
-        return {
-            ok: r.status === 0,
-            stdout: (r.stdout ?? '').toString(),
-            stderr: (r.stderr ?? '').toString() || (r.error ? r.error.message : ''),
-        };
+        if (!executavel)
+            throw new Error('cli.ausente: executavel OrkMind nao encontrado');
+        const linha = fs.readFileSync(executavel, 'utf8').split('\n')[0];
+        const match = /^#!(\S+)(?:\s+(\S+))?\s*$/.exec(linha);
+        if (!match)
+            throw new Error('memory.transport.interpreter: shebang nao suportado');
+        return match[2] ? [match[1], match[2]] : [match[1]];
+    }
+    contemSegredo(valor) {
+        const segredo = this.config.dsn;
+        const proibidos = [segredo];
+        try {
+            const senha = new URL(segredo).password;
+            if (senha.length >= 12)
+                proibidos.push(senha, decodeURIComponent(senha));
+        }
+        catch { /* DSN opaca */ }
+        const examinar = (x) => typeof x === 'string'
+            ? proibidos.some(p => p && x.includes(p))
+            : !!x && typeof x === 'object' && Object.entries(x).some(([k, v]) => examinar(k) || examinar(v));
+        return examinar(valor);
+    }
+    rodar(pedido) {
+        if (!this.config.dsn.trim())
+            throw new Error('dsn.env-ausente');
+        if (this.contemSegredo(pedido))
+            throw new Error('memory.transport.secret: conteudo recusado');
+        const [python, ...prefixo] = this.python();
+        const ponte = [path.join(__dirname, '../assets/orkmind_bridge.py'),
+            path.join(__dirname, '../../assets/orkmind_bridge.py')].find(p => fs.existsSync(p));
+        if (!ponte)
+            throw new Error('memory.transport.bridge: ponte ausente no pacote');
+        const env = { ORKMIND_DATABASE_URL: this.config.dsn, PYTHONDONTWRITEBYTECODE: '1' };
+        for (const nome of ['PATH', 'HOME', 'LANG', 'LC_ALL', 'SYSTEMROOT']) {
+            if (process.env[nome])
+                env[nome] = process.env[nome];
+        }
+        const r = (0, node_child_process_1.spawnSync)(python, [...prefixo, ponte], {
+            encoding: 'utf8', input: JSON.stringify(pedido), timeout: this.config.timeoutMs,
+            maxBuffer: 32 * 1024 * 1024, env,
+        });
+        // Nunca reutilizar stdout, stderr, error.message ou causa de uma falha do filho.
+        if (r.error) {
+            const code = r.error.code;
+            throw new Error(code === 'ETIMEDOUT' ? 'memory.transport.timeout' :
+                code === 'ENOENT' ? 'cli.ausente: interpretador nao encontrado' : 'memory.transport.spawn');
+        }
+        if (r.status !== 0) {
+            let code = '';
+            try {
+                code = JSON.parse(r.stdout)?.error;
+            }
+            catch { /* nenhum detalhe do filho */ }
+            throw new Error(['memory.schema.absent', 'memory.legacy.provenance-collision', 'memory.prospective.marker-invalid', 'memory.native.schema-mismatch', 'memory.query.invalid', 'memory.query.window-saturated', 'memory.query.scope-violation'].includes(code) ? code : 'memory.transport.failed');
+        }
+        let json;
+        try {
+            json = JSON.parse(r.stdout);
+        }
+        catch {
+            throw new Error('memory.transport.json');
+        }
+        if (this.contemSegredo(json))
+            throw new Error('memory.transport.secret: resposta recusada');
+        return json;
     }
     disponivel() {
         if (this.saude)
             return this.saude;
-        if (this.config.dsn.trim() === '') {
-            this.saude = { ok: false, detalhe: `${this.config.variavel} vazia no ambiente` };
-            return this.saude;
+        try {
+            this.contagens();
+            this.saude = { ok: true, detalhe: 'ponte OrkMind respondeu; embeddings desativados' };
+        }
+        catch (e) {
+            this.saude = { ok: false, detalhe: e.message };
         }
-        const r = this.rodar(['stats']);
-        this.saude = r.ok
-            ? { ok: true, detalhe: r.stdout.split('\n')[0]?.trim() || 'OrkMind respondeu' }
-            : { ok: false, detalhe: (r.stderr || r.stdout).trim().split('\n').slice(-1)[0] ?? 'sem detalhe' };
         return this.saude;
     }
-    adicionar(entrada) {
-        const args = [
-            'add',
-            '--collection',
-            entrada.collection,
-            '--content',
-            entrada.content,
-            '--tags',
-            JSON.stringify(entrada.tags),
-            '--priority',
-            entrada.priority,
-            '--scope',
-            'project',
-            // `source: agent` sempre: e assim que o OrkMind sabe que isto nao veio de humano.
-            '--source',
-            'agent',
-            // `--dedupe` torna a gravacao idempotente por content_hash: reprocessar um MASTER ou
-            // reexportar um handoff nao duplica memoria.
-            '--dedupe',
-            '--json',
-        ];
-        const r = this.rodar(args);
-        if (!r.ok) {
-            return {
-                ok: false,
-                id: null,
-                duplicada: false,
-                collection: entrada.collection,
-                detalhe: (r.stderr || r.stdout).trim().split('\n').slice(-1)[0] ?? 'falha sem detalhe',
-            };
+    contagens() {
+        const r = this.rodar({ op: 'stats' });
+        if (!r || Array.isArray(r) || typeof r !== 'object' ||
+            !Object.values(r).every(v => Number.isInteger(v) && Number(v) >= 0)) {
+            throw new Error('memory.transport.stats');
         }
-        const linha = r.stdout.trim().split('\n').filter((l) => l.trim() !== '').slice(-1)[0] ?? '';
+        return r;
+    }
+    adicionar(entrada) {
         try {
-            const json = JSON.parse(linha);
-            return {
-                ok: true,
-                id: json.entry_id ?? null,
-                duplicada: json.status === 'duplicate',
-                collection: entrada.collection,
-                detalhe: json.status ?? 'created',
-            };
+            if (violacoesDeGovernanca(entrada).length)
+                throw new Error('memory.governance');
+            const r = this.rodar({ op: 'add', entrada });
+            if (!r || r.ok !== true || typeof r.id !== 'string' || !r.id || r.collection !== entrada.collection) {
+                throw new Error('memory.transport.receipt');
+            }
+            return r;
         }
-        catch {
-            return {
-                ok: false,
-                id: null,
-                duplicada: false,
-                collection: entrada.collection,
-                detalhe: `saida do OrkMind nao e JSON: ${linha.slice(0, 120)}`,
-            };
+        catch (e) {
+            return { ok: false, id: null, duplicada: false, collection: entrada.collection, detalhe: e.message };
         }
     }
     exportar(colecao) {
-        const r = this.rodar(['export', '--collection', colecao, '--output', '-']);
-        if (!r.ok)
-            return [];
+        const dados = this.rodar({ op: 'export', collection: colecao });
+        if (!Array.isArray(dados))
+            throw new Error('memory.transport.export');
+        return dados.map(d => {
+            const e = entradaDoJson(d);
+            if (!e || e.collection !== colecao)
+                throw new Error('memory.transport.entry');
+            return e;
+        });
+    }
+    consultar(consulta) {
+        const q = validarConsultaDelimitada(consulta);
+        const dados = this.rodar({ op: 'query', collection: q.collection,
+            tags: tagsDoEscopo(q.escopo), limit: q.limite });
+        if (!Array.isArray(dados))
+            throw Error('memory.query.response-invalid');
+        // A janela inteira precede normalizacao e filtros; nao provar ausencia numa pagina cheia.
+        if (dados.length >= q.limite)
+            throw Error('memory.query.window-saturated');
+        const entradas = dados.map(d => {
+            const e = entradaDoJson(d);
+            if (!e)
+                throw Error('memory.query.response-invalid');
+            return e;
+        });
+        return concluirConsultaDelimitada(entradas, q);
+    }
+    /** Readback de manutencao. O recall continua usando export governado. */
+    recuperar(colecao, id) {
+        const dado = this.rodar({ op: 'get', collection: colecao, id });
+        if (dado === null)
+            return null;
+        const e = entradaDoJson(dado);
+        if (!e || e.id !== id || e.collection !== colecao)
+            throw new Error('memory.transport.readback');
+        return e;
+    }
+    submeterHandoff(pedido) {
         try {
-            const dados = JSON.parse(r.stdout);
-            if (!Array.isArray(dados))
-                return [];
-            return dados.map(entradaDoJson).filter((e) => e !== null);
+            const r = this.rodar({ op: 'handoff', pedido });
+            if (!r || r.ok !== true || !r.id || !r.package_id || !r.package_entry_id ||
+                !r.session_entry_id || r.readback !== true)
+                throw new Error('memory.g3.rejected');
+            return r;
         }
-        catch {
-            return [];
+        catch (e) {
+            return { ok: false, id: null, duplicada: false, collection: 'handoff', detalhe: e.message };
         }
     }
 }
 exports.DriverCliOrkMind = DriverCliOrkMind;
+function tagsFixasDaDecisao(tags) {
+    const fases = new Set(['GOAL', 'PLAN', 'GO', 'CHECK', 'SHIP', 'MASTER']);
+    return Object.fromEntries(Object.entries(tags).filter(([k]) => k !== 'agent').map(([k, values]) => [k, [...new Set(values.filter(v => !(k === 'skill' && fases.has(v)) &&
+                !(k === 'situation' && v.startsWith('fase:') && fases.has(v.slice(5)))))].sort()]).filter(([, values]) => values.length));
+}
+/** Mesma serializacao JSON canonica e fingerprint da ponte Python. */
+function jsonDeIdentidade(value) {
+    if (Array.isArray(value))
+        return '[' + value.map(jsonDeIdentidade).join(',') + ']';
+    if (value && typeof value === 'object')
+        return '{' + Object.entries(value).filter(([, v]) => v !== undefined)
+            .sort(([a], [b]) => {
+            const aa = Array.from(a, c => c.codePointAt(0)), bb = Array.from(b, c => c.codePointAt(0));
+            for (let i = 0; i < Math.min(aa.length, bb.length); i++)
+                if (aa[i] !== bb[i])
+                    return aa[i] - bb[i];
+            return aa.length - bb.length;
+        })
+            .map(([k, v]) => JSON.stringify(k) + ':' + jsonDeIdentidade(v)).join(',') + '}';
+    return JSON.stringify(value);
+}
+const fingerprint = (value) => (0, node_crypto_1.createHash)('sha256').update(jsonDeIdentidade(value)).digest('hex');
+/** Domicilio unico de campos; a ponte verifica o contrato contra a biblioteca instalada antes de usa-la. */
+function camposNativos() {
+    try {
+        const arquivo = [path.join(__dirname, '../assets/orkmind-native-schema.json'),
+            path.join(__dirname, '../../assets/orkmind-native-schema.json')].find(p => fs.existsSync(p));
+        if (!arquivo)
+            throw Error('missing native schema');
+        const esquema = JSON.parse(fs.readFileSync(arquivo, 'utf8'));
+        if (esquema.schema !== 'ork.native-entry-fields/v1' || !Array.isArray(esquema.fields) ||
+            esquema.fields.some((k) => typeof k !== 'string') ||
+            new Set(esquema.fields).size !== esquema.fields.length)
+            throw Error('invalid native schema');
+        return Object.freeze(esquema.fields);
+    }
+    catch {
+        throw Error('memory.native.schema-mismatch');
+    }
+}
+function agenteProspectivoValido(value) {
+    return typeof value === 'string' && /^[a-z0-9.-]+:[a-z0-9.-]+$/.test(value) && !/human/i.test(value);
+}
+/** Fingerprint de integridade do recibo, nunca autenticacao da autoria historica. */
+function prospectivaCompativel(old, entrada, metadata) {
+    const campos = camposNativos();
+    try {
+        const p = old.metadata.orkastery_prospective;
+        if (!p || p.schema !== 'ork.prospective-origin/v1' || p.historicalOrigin !== 'unknown' || p.source !== 'agent' ||
+            !/^[a-f0-9]{64}$/.test(p.receiptSha256) || !/^[a-f0-9]{40}$/.test(p.revision) ||
+            !agenteProspectivoValido(p.agent) || p.entryId !== old.id ||
+            (0, node_crypto_1.createHash)('sha256').update(p.originalJson).digest('hex') !== p.originalSha256)
+            return false;
+        const original = JSON.parse(p.originalJson);
+        if (Object.keys(original).length !== campos.length || campos.some(k => !(k in original)))
+            return false;
+        const tags = Object.fromEntries([...new Set([...Object.keys(original.tags), ...Object.keys(entrada.tags)])].map(k => [k, [...new Set([...(original.tags[k] ?? []), ...(entrada.tags[k] ?? [])])].sort()]));
+        return old.collection === 'rule' && old.source === 'agent' && old.priority === 'high' && old.mandatory === false &&
+            old.protected === false && old.visibility === 'private' && original.visibility === 'private' &&
+            original.id === old.id && original.content === old.content && original.source === 'agent' &&
+            original.priority === 'high' && original.mandatory === false && original.protected === false &&
+            (old.author_id ?? null) === original.author_id && old.scope === original.scope && old.scope === ('scope' in entrada ? entrada.scope : 'project') &&
+            (0, node_util_1.isDeepStrictEqual)(old.tags, tags) && (0, node_util_1.isDeepStrictEqual)(old.metadata, { ...metadata, orkastery_prospective: p });
+    }
+    catch {
+        return false;
+    }
+}
+const semIdentidade = (metadata) => Object.fromEntries(Object.entries(metadata)
+    .filter(([k]) => !['orkastery_identity', 'orkastery_identity_version'].includes(k)));
+function identidadeLegadaComprovada(entry) {
+    if ('orkastery_identity_version' in entry.metadata)
+        return false;
+    const base = { collection: entry.collection, content: entry.content, tags: entry.tags,
+        priority: entry.priority, metadata: semIdentidade(entry.metadata) };
+    return [false, true].some(source => [false, true].some(mandatory => fingerprint({ ...base, ...(source ? { source: entry.source } : {}), ...(mandatory ? { mandatory: false } : {}) }) === entry.metadata.orkastery_identity));
+}
 /**
  * Driver em memoria, usado pelos testes e por `--dry-run`.
  *
@@ -319,6 +558,8 @@ class DriverEmMemoria {
             : { ok: false, detalhe: 'driver em memoria desligado' };
     }
     adicionar(entrada) {
+        if (violacoesDeGovernanca(entrada).length)
+            return { ok: false, id: null, duplicada: false, collection: entrada.collection, detalhe: 'memory.governance' };
         if (!this.ligado) {
             return {
                 ok: false,
@@ -328,15 +569,36 @@ class DriverEmMemoria {
                 detalhe: 'driver em memoria desligado',
             };
         }
-        const igual = this.entradas.find((e) => e.collection === entrada.collection && e.content === entrada.content);
-        if (igual) {
-            return {
-                ok: true,
-                id: igual.id,
-                duplicada: true,
-                collection: entrada.collection,
-                detalhe: 'duplicate',
-            };
+        const evolutiva = entrada.collection === 'decision' && (entrada.source ?? 'agent') === 'agent';
+        const falha = { ok: false, id: null, duplicada: false, collection: entrada.collection, detalhe: 'memory.transport.failed' };
+        if (evolutiva && (entrada.tags.project?.length !== 1 || !entrada.tags.project[0]))
+            return falha;
+        const identidade = fingerprint(evolutiva ? { collection: entrada.collection, content: entrada.content,
+            priority: entrada.priority, metadata: entrada.metadata, source: 'agent', tags: tagsFixasDaDecisao(entrada.tags) } : entrada);
+        const metadata = { ...entrada.metadata, orkastery_identity: identidade,
+            ...(evolutiva ? { orkastery_identity_version: 2 } : {}) };
+        const old = this.entradas.find(e => e.collection === entrada.collection && e.content === entrada.content);
+        if (old) {
+            if ('orkastery_prospective' in old.metadata) {
+                if (!prospectivaCompativel(old, entrada, metadata))
+                    return { ...falha, detalhe: 'memory.prospective.marker-invalid' };
+                return { ok: true, id: old.id, duplicada: true, collection: old.collection, detalhe: 'duplicate; historical-origin-unknown' };
+            }
+            if (!old.metadata.orkastery_identity)
+                return { ...falha, detalhe: 'memory.legacy.provenance-collision' };
+            if (old.source !== (entrada.source ?? 'agent') || old.priority !== entrada.priority || old.mandatory || old.scope !== 'project')
+                return falha;
+            if (evolutiva) {
+                const reconhecida = (old.metadata.orkastery_identity_version === 2 && old.metadata.orkastery_identity === identidade) || identidadeLegadaComprovada(old);
+                if (!reconhecida || !(0, node_util_1.isDeepStrictEqual)(semIdentidade(old.metadata), entrada.metadata) ||
+                    !(0, node_util_1.isDeepStrictEqual)(tagsFixasDaDecisao(old.tags), tagsFixasDaDecisao(entrada.tags)))
+                    return falha;
+                old.tags = Object.fromEntries([...new Set([...Object.keys(old.tags), ...Object.keys(entrada.tags)])].map(k => [k, [...new Set([...(old.tags[k] ?? []), ...(entrada.tags[k] ?? [])])].sort()]));
+                old.metadata = metadata;
+            }
+            else if (!(0, node_util_1.isDeepStrictEqual)(old.metadata, metadata) || !(0, node_util_1.isDeepStrictEqual)(old.tags, entrada.tags))
+                return falha;
+            return { ok: true, id: old.id, duplicada: true, collection: entrada.collection, detalhe: 'duplicate' };
         }
         this.contador += 1;
         const nova = {
@@ -347,8 +609,8 @@ class DriverEmMemoria {
             priority: entrada.priority,
             mandatory: false,
             scope: 'project',
-            source: 'agent',
-            metadata: entrada.metadata,
+            source: entrada.source ?? 'agent',
+            metadata,
             criadaEm: new Date().toISOString(),
         };
         this.entradas.push(nova);
@@ -362,9 +624,46 @@ class DriverEmMemoria {
     }
     exportar(colecao) {
         if (!this.ligado)
-            return [];
+            throw new Error('memory.transport.unavailable');
         return this.entradas.filter((e) => e.collection === colecao);
     }
+    consultar(consulta) {
+        const q = validarConsultaDelimitada(consulta);
+        if (!this.ligado)
+            throw new Error('memory.transport.unavailable');
+        // Duplo de selecao na origem; nao chama o export amplo nem implementa ACL.
+        const pagina = this.entradas.filter(e => pertenceAoEscopo(e, q)).slice(0, q.limite);
+        return concluirConsultaDelimitada(pagina, q);
+    }
+    recuperar(colecao, id) {
+        return this.exportar(colecao).find(e => e.id === id) ?? null;
+    }
+    contagens() {
+        return this.entradas.reduce((r, e) => { r[e.collection] = (r[e.collection] ?? 0) + 1; return r; }, {});
+    }
+    /** Duplo de transporte para o CI. Nao constitui prova de validacao G3. */
+    submeterHandoff(p) {
+        const existente = this.entradas.find(e => e.collection === 'handoff' && e.metadata.orkastery_identity === p.identidade);
+        if (existente)
+            return { ok: true, id: existente.id, duplicada: true, collection: 'handoff',
+                detalhe: 'duplo G3', session_entry_id: existente.parent_id, package_entry_id: String(existente.metadata.package_entry_id),
+                package_id: String(existente.metadata.package_id), readback: true };
+        const inserir = (collection, content, metadata, parent_id) => {
+            const e = { id: `mem-${++this.contador}`, collection, content, metadata, parent_id,
+                tags: p.tags, source: 'agent', priority: 'high', mandatory: false, scope: 'project', criadaEm: new Date().toISOString() };
+            this.entradas.push(e);
+            return e;
+        };
+        const sessao = this.entradas.find(e => e.collection === 'session' && e.metadata.session_id === p.sessionId) ??
+            inserir('session', `Sessao ${p.sessionId}`, { session_id: p.sessionId });
+        const packageId = `package-${this.contador + 1}`;
+        const meta = { ...p.metadata, orkastery_identity: p.identidade, package_id: packageId, session_id: p.sessionId,
+            origin: p.origem, destination: p.destino };
+        const pacote = inserir('semantic_log', JSON.stringify(p.payload), meta, sessao.id);
+        const handoff = inserir('handoff', String(p.payload.progresso), { ...meta, package_entry_id: pacote.id }, sessao.id);
+        return { ok: true, id: handoff.id, duplicada: false, collection: 'handoff', detalhe: 'duplo de transporte G3',
+            session_entry_id: sessao.id, package_entry_id: pacote.id, package_id: packageId, readback: true };
+    }
     /** So para os testes: injeta uma entrada que o `ork` nunca gravaria (humano, mandatory). */
     semear(entrada) {
         this.entradas.push(entrada);