Record authorized adaptive path deployment and enabled destination state

Preserve legacy draft shape when no compatible context is inherited
Record current v4 report proof and adaptive path integration dependencies
2026-10-22 10:18:38 +02:00 · 2026-10-22 10:14:46 +02:00 · 2026-10-22 10:06:08 +02:00 · 2026-10-22 10:00:23 +02:00 · 2026-10-22 09:25:14 +02:00
18 changed files with 1919 additions and 88 deletions
@@ -39,3 +39,10 @@ Referenciar estas orientações nos requisitos correspondentes da matriz existen
 - Preservar o ficheiro original, a proveniência, o identificador exacto, a edição/data, o hash e o histórico. Não marcar autenticidade, vigência, direitos ou scan como confirmados sem evidência.
 - Para fontes fiscais, inventariar também as fontes não analisadas e os diplomas/artigos sem correspondência documental. Parâmetros ausentes ou ambiguidades permanecem indeterminados; não usar zero nem a taxa mais recente como substituto.
 - Antes de aplicar mudanças em dados activos, confirmar backup/restauro e a acção autenticada que continua necessária. Testes e migrações devem usar exclusivamente uma base QA isolada com guarda contra a base activa.
+
+
+## Execução das fontes e decisões — orientação permanente da Tempo, 22/10/2026
+
+A legislação, os formulários e os procedimentos oficiais disponibilizados são fontes válidas para implementar os requisitos. As decisões e procedimentos da Tempo orientam a sua utilização no portal. Traduzir essas fontes em campos, regras, documentos, cálculos e percursos executáveis com rastreabilidade, sem exigir nova validação jurídica genérica ou criar aprovadores, restrições ou condições por interpretação do Codex.
+
+Uma divergência concreta deve identificar os trechos, períodos e comportamento afectados; prosseguir com os restantes requisitos. Uma decisão de implementação em falta deve ser apresentada especificamente à Tempo, sem a substituir por regra inventada. Rever e remover bloqueios anteriores sem fundamento numa fonte aplicável ou decisão expressa da Tempo, preservando dados e histórico. A rastreabilidade explica a execução e não constitui uma autoridade adicional. Mantêm-se os limites autorizados de QA e das alterações no activo.
@@ -13,6 +13,7 @@ use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Schema;
 use Illuminate\Support\Facades\Validator;
 use Illuminate\Support\Str;
+use Illuminate\Validation\Rule;
 use Symfony\Component\HttpKernel\Exception\HttpException;

 /** Context belongs to the existing encrypted dossier. Sources remain read-only. */
@@ -22,7 +23,7 @@ final class InvestorContext

    public const SOURCE = 'investor-context';

-    public const FIELDS = ['project_title', 'project_summary', 'sector_id', 'sector', 'province_id', 'district_id', 'admin_post_id', 'locality_id', 'province', 'district', 'location', 'currency', 'expected_start_date', 'fiscal_period', 'fiscal_periodicity', 'fiscal_month', 'investor_origin', 'person_type', 'entity_stage', 'tax_residency_country', 'fiscal_residency_country', 'activity_id', 'project_type', 'maturity_stage', 'special_zone_id', 'investment_regime'];
+    public const FIELDS = ['project_title', 'project_summary', 'sector_id', 'sector', 'province_id', 'district_id', 'admin_post_id', 'locality_id', 'province', 'district', 'location', 'currency', 'expected_start_date', 'fiscal_period', 'fiscal_periodicity', 'fiscal_month', 'investor_origin', 'person_type', 'entity_stage', 'tax_residency_country', 'fiscal_residency_country', 'activity_id', 'project_type', 'maturity_stage', 'special_zone_id', 'investment_regime', ...PrivateInvestmentPreparation::FIELDS];

    public function __construct(private readonly VirtualDesk $desk) {}

@@ -267,10 +268,20 @@ final class InvestorContext

    private function input(array $input): array
    {
-        abort_if(array_diff(array_keys($input), ['version', 'selection', 'declarations', 'replace_fields', 'preview_hash', 'operation_key', 'confirm', '_token']), 422, 'Campo de controlo desconhecido.');
+        abort_if(array_diff(array_keys($input), ['version', 'selection', 'declarations', 'replace_fields', 'preview_hash', 'operation_key', 'confirm', 'document_links', '_token']), 422, 'Campo de controlo desconhecido.');

-        return Validator::make($input, ['version' => 'required|integer|min:1', 'selection' => 'present|array:opportunity,sector,territory,park',
-            'selection.*' => 'nullable|string|max:100', 'declarations' => 'nullable|array:project_title,project_summary,currency,expected_start_date,investor_origin,person_type,entity_stage,tax_residency_country,fiscal_residency_country,project_type,maturity_stage', 'declarations.project_title' => 'nullable|string|max:200', 'declarations.project_summary' => 'nullable|string|max:5000',
+        abort_if(! app(PrivateInvestmentPreparation::class)->available() && (! empty($input['document_links']) || array_intersect(array_keys(is_array($input['declarations'] ?? null) ? $input['declarations'] : []), PrivateInvestmentPreparation::FIELDS)), 409, 'Esta preparação ainda não está disponível neste ambiente. As respostas foram preservadas.');
+
+        $inputRules = [
+            'document_links' => 'sometimes|array:'.implode(',', PrivateInvestmentPreparation::DOCUMENTS),
+            'document_links.*' => 'nullable|uuid',
+        ];
+        foreach (app(PrivateInvestmentPreparation::class)->questions() as $question) {
+            $inputRules['declarations.'.$question['key']] = isset($question['options']) ? ['nullable', Rule::in(array_keys($question['options']))] : ['nullable', 'regex:/^\d+(?:\.\d+)?$/D', 'numeric', 'min:0', 'max:999999999999999999'];
+        }
+
+        return Validator::make($input, [...$inputRules, 'version' => 'required|integer|min:1', 'selection' => 'present|array:opportunity,sector,territory,park',
+            'selection.*' => 'nullable|string|max:100', 'declarations' => 'nullable|array:project_title,project_summary,currency,expected_start_date,investor_origin,person_type,entity_stage,tax_residency_country,fiscal_residency_country,project_type,maturity_stage,'.implode(',', PrivateInvestmentPreparation::FIELDS), 'declarations.project_title' => 'nullable|string|max:200', 'declarations.project_summary' => 'nullable|string|max:5000',
            'declarations.currency' => 'nullable|regex:/^[A-Z]{3}$/', 'declarations.expected_start_date' => 'nullable|date_format:Y-m-d', 'declarations.investor_origin' => 'nullable|in:national,foreign,mixed', 'declarations.person_type' => 'nullable|in:singular,collective,sole_trader,consortium', 'declarations.entity_stage' => 'nullable|in:existing,being_formed', 'declarations.tax_residency_country' => ['nullable', 'string', app(CountryCatalogue::class)->rule()], 'declarations.fiscal_residency_country' => ['nullable', 'string', app(CountryCatalogue::class)->rule()], 'declarations.project_type' => 'nullable|string|max:100', 'declarations.maturity_stage' => 'nullable|string|max:100',
            'replace_fields' => 'nullable|array', 'replace_fields.*' => 'string|in:'.implode(',', self::FIELDS)])->validate();
    }
@@ -283,6 +294,15 @@ final class InvestorContext
        abort_unless((int) $case->version === $data['version'], 409, 'O dossier mudou; recupere a versão atual.');
        app(InvestorPath::class)->view($actor, $id);
        $old = $this->state($case);
+        $links = $old['preparation_documents'] ?? [];
+        foreach ($data['document_links'] ?? [] as $key => $document) {
+            if ($document) {
+                abort_unless(DB::table('desk_documents as l')->join('documents as d', 'd.id', '=', 'l.document_id')->where('l.case_id', $id)->where('d.id', $document)->whereNull('d.deleted_at')->exists(), 422, 'Seleccione um documento já associado a este dossier; os dados anteriores foram preservados.');
+                $links[$key] = $document;
+            } else {
+                unset($links[$key]);
+            }
+        }
        $selection = $old['selection'];
        foreach ($data['selection'] as $slot => $key) {
            if ($key === null || $key === '') {
@@ -353,16 +373,29 @@ final class InvestorContext
        $changedFields = array_column($replaced, 'field');
        $conditionsChanged = (bool) array_intersect($changedFields, array_diff(self::FIELDS, ['project_title', 'project_summary']));
        $dependencyChanged = $this->dependencyHash($old['selection']) !== $this->dependencyHash($selection) || $conditionsChanged;
+        $privateConditionsChanged = (bool) array_intersect($changedFields, PrivateInvestmentPreparation::FIELDS);
+        $calculationInputsChanged = $this->dependencyHash($old['selection']) !== $this->dependencyHash($selection) || (bool) array_intersect($changedFields, array_diff(self::FIELDS, ['project_title', 'project_summary', ...array_diff(PrivateInvestmentPreparation::FIELDS, ['total_investment', 'area_required', 'area_unit'])]));
        $payload = $this->desk->decode($case->payload);
        $results = $payload['investor_path']['results'] ?? [];
        $requests = DB::table('desk_requests')->where('case_id', $id)->orderBy('id')->get(['id', 'status', 'protocol', 'version'])->all();
        $steps = $dependencyChanged ? array_values(array_unique([...(array_intersect($changed, ['opportunity', 'sector']) ? ['S02', 'S03', 'S04', 'S08', 'S12', 'S13', 'S14', 'S15', 'S17'] : []), ...(array_intersect($changed, ['territory', 'park']) ? ['S08', 'S09', 'S10', 'S11', 'S17'] : [])])) : [];
-        if ($conditionsChanged) {
+        if (array_intersect($changedFields, array_diff(self::FIELDS, ['project_title', 'project_summary', ...PrivateInvestmentPreparation::FIELDS]))) {
            $steps = array_values(array_unique([...$steps, 'S02', 'S03', 'S08', 'S12', 'S13', 'S17']));
        }
+        if ($privateConditionsChanged) {
+            $steps = array_values(array_unique([...$steps, 'S02', 'S05', 'S06', 'S07']));
+        }
+        $privatePreparation = null;
+        if (app(PrivateInvestmentPreparation::class)->available()) {
+            $docs = $this->preparationDocuments($id);
+            $beforePreparation = app(PrivateInvestmentPreparation::class)->assess($old, $docs);
+            $afterPreparation = app(PrivateInvestmentPreparation::class)->assess(['fields' => $fields, 'selection' => $selection, 'preparation_documents' => $links], $docs);
+            $privatePreparation = ['before' => $beforePreparation, 'after' => $afterPreparation];
+        }
        $plan = ['case_id' => $id, 'version' => (int) $case->version, 'revision' => (int) $old['revision'], 'selection' => $selection, 'fields' => $fields, 'provenance' => $provenance,
-            'updated' => $replaced, 'maintained' => $kept, 'changed_dimensions' => $changed, 'dependent_results' => (int) $case->user_id === $actor->id && $dependencyChanged ? array_map(fn ($r) => ['id' => $r['id'], 'engine' => $r['engine']], $results) : [],
-            'requests' => $requests, 'review_steps' => $steps, 'dependency_changed' => $dependencyChanged, 'documents_preserved' => DB::table('desk_documents')->where('case_id', $id)->count(),
+            'preparation_documents' => $links, 'private_investment' => $privatePreparation,
+            'updated' => $replaced, 'maintained' => $kept, 'changed_dimensions' => $changed, 'dependent_results' => (int) $case->user_id === $actor->id && $calculationInputsChanged ? array_map(fn ($r) => ['id' => $r['id'], 'engine' => $r['engine']], $results) : [],
+            'requests' => $requests, 'review_steps' => $steps, 'dependency_changed' => $dependencyChanged, 'calculation_inputs_changed' => $calculationInputsChanged, 'documents_preserved' => DB::table('desk_documents')->where('case_id', $id)->count(),
            'notice' => 'Não confirma incentivos, licenças, disponibilidade de terra, reserva ou autorização. Submissões e decisões anteriores mantêm o conteúdo enviado.'];
        $hash = hash_hmac('sha256', json_encode(Arr::sortRecursive([$actor->id, $data, $plan]), JSON_THROW_ON_ERROR), config('app.key'));

@@ -390,7 +423,7 @@ final class InvestorContext
            $before = $this->state($case);
            $plan = $this->preview($actor, $id, $input);
            abort_unless(hash_equals($plan['preview_hash'], $control['preview_hash']), 409, 'O dossier ou uma fonte mudou desde a prévia; compare novamente.');
-            if (! $plan['changed_dimensions'] && ! $plan['updated'] && empty($input['declarations']) && empty($input['replace_fields'])) {
+            if (! $plan['changed_dimensions'] && ! $plan['updated'] && empty($input['declarations']) && empty($input['replace_fields']) && empty($input['document_links'])) {
                $result = ['case_id' => $id, 'version' => (int) $case->version, 'revision' => $before['revision'], 'changed' => false, 'replayed' => false];
                DB::table('audit_events')->insert(['source_system' => self::SOURCE, 'entity_type' => 'desk_cases', 'entity_id' => $id, 'actor_user_id' => $actor->id, 'correlation_id' => $control['operation_key'], 'action' => 'context_unchanged', 'data_classification' => 'restricted', 'after_data' => json_encode(['case_id' => $id, 'request_hash' => $requestHash, 'result' => $result], JSON_THROW_ON_ERROR)]);

@@ -402,9 +435,9 @@ final class InvestorContext
            foreach ($plan['review_steps'] as $step) {
                $review[$step] = ['revision' => $revision, 'reason' => 'O contexto mudou; reveja os pressupostos e a evidência aplicável.'];
            }
-            $context = ['revision' => $revision, 'selection' => $plan['selection'], 'fields' => $plan['fields'], 'provenance' => $plan['provenance'], 'review_steps' => $review,
+            $context = ['preparation_documents' => $plan['preparation_documents'], 'preparation_snapshot' => $plan['private_investment']['after'] ?? $before['preparation_snapshot'] ?? null, 'revision' => $revision, 'selection' => $plan['selection'], 'fields' => $plan['fields'], 'provenance' => $plan['provenance'], 'review_steps' => $review,
                'dependency_hash' => $this->dependencyHash(['selection' => $plan['selection'], 'fields' => Arr::except($plan['fields'], ['project_title', 'project_summary'])]), 'updated_at' => now()->toIso8601String(), 'updated_by' => $actor->id];
-            if ($plan['dependency_changed']) {
+            if ($plan['calculation_inputs_changed']) {
                foreach ($payload['investor_path']['results'] ?? [] as $i => $r) {
                    $payload['investor_path']['results'][$i] = [...$r, 'context_state' => 'review_required', 'context_invalidated_revision' => $revision, 'context_invalidated_at' => now()->toIso8601String()];
                }
@@ -439,21 +472,30 @@ final class InvestorContext
            }
        }

-        return ['simulator_context_revision' => $simulatorRevision, 'case' => $path['case'], 'context' => $ctx, 'steps' => array_map(fn ($s) => Arr::only($s, ['code', 'title', 'state', 'context_review_required']), $path['steps']),
+        $preparation = app(PrivateInvestmentPreparation::class)->available() ? app(PrivateInvestmentPreparation::class)->assess($ctx, $this->preparationDocuments($id)) : null;
+        $ctx['preparation_assessment'] = $preparation;
+
+        return ['private_investment' => $preparation, 'preparation_documents' => $this->preparationDocuments($id), 'simulator_context_revision' => $simulatorRevision, 'case' => $path['case'], 'context' => $ctx, 'steps' => array_map(fn ($s) => Arr::only($s, ['code', 'title', 'state', 'context_review_required']), $path['steps']),
            'can_write' => $path['canWrite'], 'next' => $path['next'], 'results' => $path['results'], 'requests' => $path['requests'],
            'prefill' => $this->prefill($ctx), 'notice' => 'A seleção apoia a preparação e não confirma benefícios, licenças, direitos ou disponibilidade.'];
    }

+    public function preparationDocuments(string $id): array
+    {
+        return DB::table('desk_documents as l')->join('documents as d', 'd.id', '=', 'l.document_id')->where('l.case_id', $id)->whereNull('d.deleted_at')->get(['l.id', 'l.document_id', 'd.file_name', 'd.status', 'd.malware_scan_status', 'd.version_no', 'd.sha256'])->map(fn ($row) => (array) $row)->all();
+    }
+
    public function prefill(array $ctx): array
    {
        $f = $ctx['fields'];
-        $sim = Arr::except(Arr::only($f, self::FIELDS), ['sector', 'province', 'district', 'location']);
+        $sim = Arr::except(Arr::only($f, self::FIELDS), ['sector', 'province', 'district', 'location', ...array_diff(PrivateInvestmentPreparation::FIELDS, ['total_investment', 'area_required', 'area_unit'])]);
        $zone = $ctx['selection']['park'] ?? null;
        $sim['context_applicability_snapshot'] = json_encode([
            'version' => 1, 'context_revision' => $ctx['revision'],
            'zone' => $zone ? Arr::only($zone, ['id', 'title', 'href', 'version', 'sha256', 'fields', 'analysis']) : null,
            'provenance' => $ctx['provenance'],
            'path' => $ctx['path_applicability'] ?? null,
+            'preparation' => isset($ctx['preparation_assessment']) ? Arr::except($ctx['preparation_assessment'], ['questions']) : null,
            'fields' => Arr::only($f, ['investor_origin', 'tax_residency_country', 'entity_stage', 'currency', 'expected_start_date', 'investment_regime']),
            'notice' => 'Referências e declarações para preparação; sem reconhecimento automático de elegibilidade ou benefício.',
        ], JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE);
@@ -136,7 +136,7 @@ final class InvestorPath
        $documents = DB::table('desk_documents as l')->join('documents as d', 'd.id', '=', 'l.document_id')
            ->where('l.case_id', $id)->whereNull('d.deleted_at')
            ->when(! $owner && ! $manager, fn ($q) => $q->where(fn ($p) => $p->whereNull('l.request_id')->orWhereIn('l.request_id', $requests->pluck('id'))))
-            ->get(['l.id', 'l.document_id', 'd.file_name', 'd.status', 'd.malware_scan_status']);
+            ->get(['l.id', 'l.document_id', 'd.file_name', 'd.status', 'd.malware_scan_status', 'd.version_no', 'd.sha256']);
        // Only the private draft owner can receive the financial snapshot/result. Dossier access alone is insufficient.
        $results = (int) $case->user_id === $actor->id ? ($path['results'] ?? []) : [];
        $next = collect($steps)->first(fn ($step) => $step['preparation_allowed'] && ! in_array($step['state'], ['completed', 'approved', 'waiting_external', 'submitted', 'reviewing'], true));
@@ -145,12 +145,17 @@ final class InvestorPath
            ? LandAssistanceCase::where('user_id', $actor->id)->latest('updated_at')->get()
                ->first(fn ($land) => ($land->payload['investor_path_case_id'] ?? null) === $id) : null;

-        return ['case' => ['id' => $id, 'title' => $case->title, 'version' => $case->version, 'closed' => $case->closed_at !== null],
+        $preparation = ($owner || $manager) && app(PrivateInvestmentPreparation::class)->available() ? app(PrivateInvestmentPreparation::class)->assess($context, $documents->map(fn ($d) => (array) $d)->all()) : null;
+        if ($preparation && $preparation['enabled']) {
+            $next = ['code' => 'S06', 'title' => $preparation['next'], 'action' => 'Preparar', 'href' => '/investimentos/'.$id.'/contexto/editar#preparation-questions'];
+        }
+
+        return ['private_investment' => $preparation, 'case' => ['id' => $id, 'title' => $case->title, 'version' => $case->version, 'closed' => $case->closed_at !== null],
            'journey_id' => $journey->id, 'definition_id' => $version->id, 'definition_version' => $version->version_no, 'source_sha256' => $definition['source_sha256'],
            'phases' => $definition['phases'], 'steps' => $steps, 'facts' => $facts, 'fact_reasons' => $path['fact_reasons'] ?? [],
            'fintech' => ($owner || $manager) && (isset($path['fintech']) || collect($path['sector_contexts'] ?? [])->contains(fn ($s) => in_array($s['slug'], ['fintech', 'tecnologias-de-informacao', 'mercado-financeiro'], true)) || collect($path['content_sources'] ?? [])->contains('return_href', '/tech-fintech')) ? app(FintechInvestment::class)->view($payload, $steps) : null,
            'canWrite' => $owner && ! $case->closed_at, 'canReview' => $manager && (int) $case->user_id !== $actor->id && ! $case->closed_at,
-            'next' => $next ? ['code' => $next['code'], 'title' => $next['title'], 'action' => 'Preparar', 'href' => '#'.$next['code']] : null,
+            'next' => $next ? ['code' => $next['code'], 'title' => $next['title'], 'action' => 'Preparar', 'href' => $next['href'] ?? '#'.$next['code']] : null,
            'investment_context' => ($owner || $manager) ? $context : null,
            'results' => $results, 'requests' => $requests, 'documents' => $documents,
            'zone_contexts' => ($owner || $manager) ? ($path['zone_contexts'] ?? []) : [],
@@ -0,0 +1,189 @@
+<?php
+
+namespace App\Services;
+
+use Brick\Math\BigDecimal;
+
+/** Adapter of the dossier's declared context to preparation of a private-investment request. No tax or entitlement decision. */
+final class PrivateInvestmentPreparation
+{
+    public const VERSION = 'private-investment-preparation-2026-v1';
+
+    public const SOURCE = 'https://pt.apiex.gov.mz/wp-content/uploads/2025/02/LEGISLACAO-DE-INVESTIMENTOS-EM-MOCAMBIQUE.pdf';
+
+    public const HASH = 'ba1e9eaabfec5d0c4cb2d9f2444a6860f7a90f222034764197829be402d408ed';
+
+    public const FIELDS = ['investment_form', 'investment_preparation', 'investment_activity_scope', 'implementation_mode', 'capital_origin', 'site_tenure', 'project_concession', 'significant_implications', 'land_extension', 'forest_concession', 'forest_concession_hectares', 'total_investment', 'area_required', 'area_unit'];
+
+    public const DOCUMENTS = ['identity', 'registration', 'name_reservation', 'site_plan', 'lease', 'duat', 'representation_license', 'feasibility', 'financial_capacity', 'foreign_capital'];
+
+    public function available(): bool
+    {
+        return (bool) config('investor-path.private_preparation', false);
+    }
+
+    public function questions(): array
+    {
+        $tri = ['unknown' => 'Por determinar', 'yes' => 'Sim', 'no' => 'Não'];
+
+        return [
+            ['key' => 'investment_preparation', 'label' => 'Pretende preparar o pedido de garantias/incentivos ao investimento privado?', 'options' => $tri, 'source' => 'Lei 8/2023, artigo 2'],
+            ['key' => 'investment_activity_scope', 'label' => 'Natureza efectiva da actividade do projecto', 'options' => ['unknown' => 'Por determinar', 'general' => 'Outra actividade económica', 'extractive' => 'Prospecção, pesquisa ou produção extractiva', 'processing' => 'Processamento industrial mineiro/petrolífero', 'public_nonprofit' => 'Investimento público ou exclusivamente social/sem fins lucrativos'], 'source' => 'Lei 8/2023, artigos 2 e 22'],
+            ['key' => 'investment_form', 'label' => 'Tipo deste investimento', 'options' => ['unknown' => 'Por determinar', 'direct' => 'Directo', 'indirect' => 'Indirecto'], 'source' => 'Lei 8/2023, artigo 14(b); Regulamento, artigo 13', 'help' => 'O limiar monetário do artigo 13 aplica-se ao investimento directo. A forma indirecta não é convertida silenciosamente em directa.'],
+            ['key' => 'implementation_mode', 'label' => 'Modalidade da empresa implementadora', 'options' => ['unknown' => 'Por determinar', 'domestic_entity' => 'Empresa constituída/em constituição em Moçambique', 'foreign_representation' => 'Representação comercial estrangeira'], 'source' => 'Regulamento 8/2024, artigo 9(2)'],
+            ['key' => 'capital_origin', 'label' => 'Origem dos capitais/recursos deste investimento', 'options' => ['unknown' => 'Por determinar', 'national' => 'Nacionais', 'external' => 'Provenientes do exterior', 'mixed' => 'Mistos'], 'source' => 'Lei 8/2023, glossário; Regulamento, artigos 4–6'],
+            ['key' => 'site_tenure', 'label' => 'Fundamento declarado da utilização das instalações', 'options' => ['unknown' => 'Por determinar', 'lease' => 'Arrendamento', 'duat' => 'DUAT'], 'source' => 'Regulamento, artigos 9(1)(d) e 14(1)(d)'],
+            ['key' => 'project_concession', 'label' => 'O empreendimento é PPP ou concessão empresarial?', 'options' => $tri, 'source' => 'Lei 8/2023, artigo 22(1)(b)(ii)'],
+            ['key' => 'significant_implications', 'label' => 'Existem previsíveis implicações económicas, ambientais, de segurança ou saúde pública que exijam autorização?', 'options' => $tri, 'source' => 'Lei 8/2023, artigo 22(1)(b)(i)', 'help' => 'Declare o enquadramento conhecido; o nome do sector não responde a esta pergunta. Sem fundamento suficiente, mantenha por determinar.'],
+            ['key' => 'land_extension', 'label' => 'O projecto requer extensão de terra?', 'options' => $tri, 'source' => 'Lei 8/2023, artigo 22(1)(b)(iii)'],
+            ['key' => 'forest_concession', 'label' => 'O projecto requer concessão florestal?', 'options' => $tri, 'source' => 'Lei 8/2023, artigo 22(1)(b)(iv)'],
+            ['key' => 'forest_concession_hectares', 'label' => 'Área da concessão florestal (hectares)', 'type' => 'number', 'when' => ['field' => 'forest_concession', 'equals' => 'yes'], 'source' => 'Lei 8/2023, artigo 22(1)(b)(iv)'],
+            ['key' => 'total_investment', 'label' => 'Valor total do investimento na moeda do projecto', 'type' => 'number', 'source' => 'Regulamento, artigo 13(2)'],
+            ['key' => 'area_required', 'label' => 'Área de terra requerida', 'type' => 'number', 'when' => ['field' => 'land_extension', 'equals' => 'yes'], 'source' => 'Lei 8/2023, artigo 22(1)(b)(iii)'],
+            ['key' => 'area_unit', 'label' => 'Unidade da área requerida', 'options' => ['ha' => 'Hectares', 'm2' => 'Metros quadrados'], 'when' => ['field' => 'land_extension', 'equals' => 'yes'], 'source' => 'Conversão de unidade exacta; não é benefício ou condição adicional'],
+        ];
+    }
+
+    private function number(array $f, string $key): ?BigDecimal
+    {
+        $value = $f[$key] ?? '';
+
+        return is_scalar($value) && preg_match('/^\d+(?:\.\d+)?$/D', (string) $value) ? BigDecimal::of((string) $value) : null;
+    }
+
+    public function assess(array $context, array $documents = []): array
+    {
+        $f = $context['fields'] ?? [];
+        $missing = [];
+        $answer = function (string $key) use ($f, &$missing): ?bool {
+            if (! in_array($f[$key] ?? '', ['yes', 'no'], true)) {
+                $missing[] = $key;
+
+                return null;
+            }
+
+            return $f[$key] === 'yes';
+        };
+        $enabled = ($f['investment_preparation'] ?? '') === 'yes';
+        $date = $f['expected_start_date'] ?? '';
+        $period = preg_match('/^2026-\d{2}-\d{2}$/D', $date) === 1;
+        $scope = $f['investment_activity_scope'] ?? 'unknown';
+        $covered = in_array($scope, ['general', 'processing'], true);
+        $mode = 'indeterminate';
+        $reasons = [];
+        if ($enabled) {
+            if (! $date) {
+                $missing[] = 'expected_start_date';
+            }
+            if ($scope === 'unknown' || $scope === '') {
+                $missing[] = 'investment_activity_scope';
+            }
+            if (empty($f['currency'])) {
+                $missing[] = 'currency';
+            }
+            if ($covered && $period) {
+                $triggers = [];
+                if ($scope === 'processing') {
+                    $triggers['processing'] = true;
+                    $reasons[] = 'Processamento industrial mineiro/petrolífero: Lei 8/2023, artigo 22(1)(b)(v).';
+                }
+                $amount = $this->number($f, 'total_investment');
+                $triggers['amount'] = $amount && ($f['currency'] ?? '') === 'MZN' && ($f['investment_form'] ?? '') === 'direct' ? $amount->isGreaterThan('32000000000') : null;
+                if (! in_array($f['investment_form'] ?? '', ['direct', 'indirect'], true)) {
+                    $missing[] = 'investment_form';
+                }
+                if (($f['investment_form'] ?? '') === 'indirect') {
+                    $reasons[] = 'Investimento indirecto: a classificação pela dimensão e o encaminhamento monetário não são determinados por este lote. As restantes condições documentadas continuam avaliadas.';
+                }
+                if (! $amount) {
+                    $missing[] = 'total_investment';
+                }
+                if (($f['currency'] ?? '') !== 'MZN') {
+                    $reasons[] = 'A condição monetária não é determinada noutra moeda: não se fez conversão.';
+                }
+                foreach (['project_concession', 'significant_implications'] as $key) {
+                    $triggers[$key] = $answer($key);
+                }
+                $land = $answer('land_extension');
+                if ($land === true) {
+                    $area = $this->number($f, 'area_required');
+                    $unit = $f['area_unit'] ?? '';
+                    if (! $area) {
+                        $missing[] = 'area_required';
+                    }if (! in_array($unit, ['ha', 'm2'], true)) {
+                        $missing[] = 'area_unit';
+                    }
+                    $triggers['land_extension'] = $area && in_array($unit, ['ha', 'm2'], true) ? $area->isGreaterThanOrEqualTo($unit === 'ha' ? '10000' : '100000000') : null;
+                } else {
+                    $triggers['land_extension'] = $land;
+                }
+                $forest = $answer('forest_concession');
+                if ($forest === true) {
+                    $area = $this->number($f, 'forest_concession_hectares');
+                    if (! $area) {
+                        $missing[] = 'forest_concession_hectares';
+                    }$triggers['forest_concession'] = $area ? $area->isGreaterThan('100000') : null;
+                } else {
+                    $triggers['forest_concession'] = $forest;
+                }
+                foreach (['amount' => 'Valor superior a 32 mil milhões MZN — R13(2), R21(2)(a)', 'project_concession' => 'PPP/concessão empresarial — Lei 8/2023, art. 22(1)(b)(ii), R21(2)(b)', 'significant_implications' => 'Implicações significativas declaradas — Lei 8/2023, art. 22(1)(b)(i), R21(1)', 'land_extension' => 'Extensão de terra igual/superior a 10 mil hectares — Lei 8/2023, art. 22(1)(b)(iii), R21(2)(c)', 'forest_concession' => 'Concessão florestal superior a 100 mil hectares — Lei 8/2023, art. 22(1)(b)(iv), R21(2)(d)'] as $condition => $description) {
+                    if (($triggers[$condition] ?? null) === true) {
+                        $reasons[] = $description.'.';
+                    }
+                }
+                $mode = in_array(true, $triggers, true) ? 'authorization' : (in_array(null, $triggers, true) ? 'indeterminate' : 'registration');
+                $reasons[] = $mode === 'authorization' ? 'Foi identificada uma condição de autorização; as restantes condições desconhecidas não foram presumidas negativas.' : ($mode === 'registration' ? 'As condições de autorização deste lote foram declaradas negativas e o montante não ultrapassa o limite.' : 'Falta resolver pelo menos uma condição de autorização.');
+            }
+            foreach (['implementation_mode', 'capital_origin', 'site_tenure', 'entity_stage'] as $key) {
+                if (empty($f[$key]) || $f[$key] === 'unknown') {
+                    $missing[] = $key;
+                }
+            }
+        }
+        if ($mode === 'authorization' && in_array(true, array_intersect_key($triggers, array_flip(['amount', 'project_concession', 'land_extension', 'forest_concession'])), true)) {
+            $missing = array_values(array_diff($missing, ['investment_form', 'project_concession', 'significant_implications', 'land_extension', 'forest_concession', 'forest_concession_hectares', 'area_required', 'area_unit', 'total_investment']));
+        }
+        $base = $enabled && $covered && $period ? true : null;
+        if (! $enabled || in_array($scope, ['extractive', 'public_nonprofit'], true) || ($date && ! $period)) {
+            $base = false;
+        }
+        $rules = [
+            ['identity', 'Identificação do investidor', $base, 'S06', 'R9(1)(a) / R14(1)(a)', 41, 'Identificação do proponente do pedido.'],
+            ['registration', 'Certidão de registo comercial', $base === true ? (($f['entity_stage'] ?? '') === 'existing' ? true : (($f['entity_stage'] ?? '') === 'being_formed' ? false : null)) : $base, 'S05', 'R9(1)(b) / R14(1)(b)', 41, 'Alternativa para empresa já registada.'],
+            ['name_reservation', 'Reserva da denominação social', $base === true ? (($f['entity_stage'] ?? '') === 'being_formed' ? true : (($f['entity_stage'] ?? '') === 'existing' ? false : null)) : $base, 'S05', 'R9(1)(b) / R14(1)(b)', 41, 'Alternativa para empresa em constituição.'],
+            ['site_plan', 'Planta ou esboço do local', $base, 'S06', 'R9(1)(c) / R14(1)(c)', 42, 'Local de implantação identificado; não certifica disponibilidade.'],
+        ];
+        foreach (['lease' => 'Contrato de arrendamento', 'duat' => 'Título DUAT'] as $key => $label) {
+            $rules[] = [$key, $label, $base === true ? (($f['site_tenure'] ?? 'unknown') === 'unknown' ? null : ($f['site_tenure'] ?? '') === $key) : $base, 'S06', 'R9(1)(d) / R14(1)(d)', 42, 'Alternativa correspondente à utilização declarada das instalações.'];
+        }
+        $rules[] = ['representation_license', 'Licença de representação comercial', $base === true ? (($f['implementation_mode'] ?? 'unknown') === 'unknown' ? null : ($f['implementation_mode'] ?? '') === 'foreign_representation') : $base, 'S06', 'R9(2)', 42, 'Só para a modalidade representação comercial estrangeira; não decorre da nacionalidade.'];
+        foreach (['feasibility' => 'Estudo de viabilidade técnica e económico-financeira', 'financial_capacity' => 'Comprovação da capacidade financeira'] as $key => $label) {
+            $rules[] = [$key, $label, $base === true ? ($mode === 'indeterminate' ? null : $mode === 'authorization') : $base, 'S02', 'R14(1)–(2)', 45, 'Integra a preparação do pedido de autorização.'];
+        }
+        $rules[] = ['foreign_capital', 'Prova de realização/registo do aporte externo', $base === true ? (($f['capital_origin'] ?? 'unknown') === 'unknown' ? null : in_array($f['capital_origin'] ?? '', ['external', 'mixed'], true)) : $base, 'S06', 'R5(1)–(5)', 39, 'Preparação específica do aporte externo; formalidades cambiais concretas não calculadas.'];
+        $links = $context['preparation_documents'] ?? [];
+        $requirements = [];
+        foreach ($rules as [$key,$label,$applies,$stage,$article,$page,$reason]) {
+            $doc = isset($links[$key]) ? collect($documents)->firstWhere('document_id', $links[$key]) : null;
+            $requirements[] = ['key' => $key, 'label' => $label, 'state' => $applies === false ? 'not_applicable' : ($applies === null ? 'indeterminate' : ($doc ? 'associated' : 'missing')), 'required' => $applies === true, 'document_id' => $links[$key] ?? null, 'document' => $doc, 'stage' => $stage, 'reason' => $reason, 'source' => ['reference' => $article, 'url' => self::SOURCE.'#page='.$page, 'sha256' => self::HASH, 'period' => '2026; Regulamento desde 07/03/2024'], 'legal_verification' => 'not_inferred'];
+        }
+        $authoritySource = ['reference' => 'R13(1)', 'url' => self::SOURCE.'#page=45'];
+        $zone = $context['selection']['park'] ?? null;
+        $amount = $this->number($f, 'total_investment');
+        $authority = 'Por determinar neste lote';
+        if ($base === true && $mode === 'registration' && $amount && ($f['currency'] ?? '') === 'MZN') {
+            $special = in_array($zone['fields']['investment_regime'] ?? '', ['zee', 'zfi'], true);
+            $authority = $special ? ($amount->isLessThanOrEqualTo('6500000000') ? 'APIEX — condicionado ao enquadramento ZEE/ZFI efectivamente reconhecido' : 'Ministro que superintende Finanças') : ($amount->isLessThanOrEqualTo('3500000000') ? 'Governador da Província' : ($amount->isLessThanOrEqualTo('6500000000') ? 'APIEX' : 'Ministro que superintende Finanças'));
+        }
+        if ($base === true && $mode === 'authorization') {
+            $council = array_intersect_key($triggers, array_flip(['amount', 'project_concession', 'land_extension', 'forest_concession']));
+            $authority = in_array(true, $council, true) ? 'Conselho de Ministros' : (in_array(null, $council, true) ? 'Autorização identificada; completar as condições em falta para distinguir a entidade decisória' : 'Ministro que superintende Finanças; eventual submissão ao Conselho de Ministros nos termos do R21(3)');
+            $authoritySource = ['reference' => 'R21(1)–(3)', 'url' => self::SOURCE.'#page=50'];
+        }
+
+        $labels = array_column($this->questions(), 'label', 'key') + ['currency' => 'Moeda do projecto', 'expected_start_date' => 'Data prevista de início', 'entity_stage' => 'Situação da entidade'];
+        $missingLabels = array_map(fn ($key) => $labels[$key] ?? $key, array_values(array_unique($missing)));
+
+        return ['version' => self::VERSION, 'enabled' => $enabled, 'period_covered' => $period, 'scope_covered' => $covered, 'mode' => $mode, 'reason' => $reasons, 'missing_fields' => array_values(array_unique($missing)), 'missing_labels' => $missingLabels, 'questions' => $this->questions(), 'requirements' => $requirements, 'authority' => $authority, 'authority_source' => $authoritySource, 'next' => $base === false ? 'Rever o âmbito/período; este lote não cobre o pedido' : ($mode === 'indeterminate' ? 'Completar condições do enquadramento' : ($mode === 'authorization' ? 'Preparar estudo e documentos do pedido de autorização' : 'Preparar documentos do pedido de mero registo')), 'calculation_notice' => 'O regime procedimental não altera a taxa de IVA. Reutilize a simulação geral apenas no seu âmbito e período; benefícios, apuramento final e conversão cambial não são presumidos.', 'source' => ['url' => self::SOURCE, 'sha256' => self::HASH], 'notice' => 'Preparação informativa baseada em declarações; documentos associados não constituem validação jurídica, certificado ou submissão à Administração.'];
+    }
+}
@@ -2,6 +2,7 @@

 return [
    // Explicit opt-in after authenticated installation; never infer activation from schema/ready.
+    'private_preparation' => env('PRIVATE_INVESTMENT_PREPARATION_ENABLED', false),
    'enabled' => env('INVESTOR_PATH_ENABLED', false),
    'definition_id' => '61000919-0000-4000-8000-000000000001',
 ];
@@ -1646,5 +1646,360 @@
    ],
    "return_evidence_id": "43317c22-50c8-40cf-98e4-e5d4d108c372",
    "B_recovered_context_revision": 2
+  },
+  "context_review_and_adaptive_path_preparation_20261022": {
+    "reviewed_commit": "a76369eb",
+    "review_status": "complete within accepted increment scope; no integration executed",
+    "last_return_equivalent_evidence": "43317c22-50c8-40cf-98e4-e5d4d108c372",
+    "accepted_AB_repeated": false,
+    "next_lot": "Preparação de pedido de investimento privado: condição, fonte/período, formulário, percurso, cálculo e lacuna",
+    "next_lot_status": "documented, not implemented or demonstrated end-to-end",
+    "source_url": "https://pt.apiex.gov.mz/wp-content/uploads/2025/02/LEGISLACAO-DE-INVESTIMENTOS-EM-MOCAMBIQUE.pdf",
+    "source_sha256": "ba1e9eaabfec5d0c4cb2d9f2444a6860f7a90f222034764197829be402d408ed",
+    "new_fiscal_rule_activation": false,
+    "next_acceptance": "Only synthetic C condition transitions and dossier/report links; reuse accepted context and IVA evidence"
+  },
+  "private_investment_executable_20261022": {
+    "base": "52fbb146",
+    "branch": "codex/private-investment-path-executable-QA",
+    "status": "implemented and verified in isolated QA; not integrated",
+    "source_version": "private-investment-preparation-2026-v1",
+    "orientation": "Tempo 22/10: official sources execute without generic additional legal approval; permanent AGENTS updated",
+    "qa_url": "http://127.0.0.1:18580/investimentos/4133311b-5426-4cec-900d-1f1484484083",
+    "persistence": {
+      "case_id": "4133311b-5426-4cec-900d-1f1484484083",
+      "case_version": 8,
+      "context_revision": 4,
+      "mode": "registration",
+      "association": {
+        "lease": "e5ce142a-1178-46a2-b039-f187139c62cd"
+      },
+      "documents": 1,
+      "context_events": 4,
+      "draft_id": "beba1dec-fc05-4820-b099-24952c5ab36c",
+      "draft_version": 4,
+      "draft_sha256": "4136e82a3b9420ab8f980ec0d7bda6dc2a67b568c18535b5ba0ecc80efd37e37",
+      "saved_context_revision": 3,
+      "saved_preparation_mode": "authorization",
+      "currency": "MZN",
+      "date": "2026-01-01",
+      "preparation_version": "private-investment-preparation-2026-v1"
+    },
+    "new_checks": {
+      "feature_tests": 3,
+      "assertions": 96,
+      "frontend_delta_tests": 1,
+      "typescript": "passed",
+      "build": "passed"
+    },
+    "evidence_sha256": {
+      "C-authorization-preview.png": "311c9f14ac601429666ded55c5906aa8ab018b5d31a1f101b4fb32697adf0817",
+      "C-final-directness-preview.png": "2037958e2879fb184cac1c4aa07ddc367417dbd1541d979c4e653a63918cdaca",
+      "C-final-path.png": "0c3c0900d861724b6def3f5850bd6c6c0f65dfee7cb01d6bb7c72c8bf645645a",
+      "C-persistence-v3.json": "b8faad9a5d4d9174a489a7b1096104f3a91645201b221b1ad7ece4a217180e00",
+      "C-persistence.json": "6b6120c88f41cff43b185905fdfec992ca76b359d0eab6bc1df02dee064c780d",
+      "C-recovered-path.png": "c734d119b0f766d8600892713be473d1c1875cb6ff4474b6fceabef702a3490b",
+      "C-report-check.json": "217b56b89041e6c8c05907af48c48dadf4f8316a2cce0f9195daf828258cb503",
+      "C-report.docx": "28cfe4b75116c892d3e29fde389de7d067b456761756bab732af625178ee69ce"
+    },
+    "report": {
+      "path": "C:\\Mac\\Home\\Downloads\\relatorio-investmoz-sintetico-qa-c-pedido-de-investimento-privado.docx",
+      "size": 16674,
+      "sha256": "28cfe4b75116c892d3e29fde389de7d067b456761756bab732af625178ee69ce"
+    },
+    "tool_limitation": "Download observation timed out and browser debugger detached; completed DOCX found in Downloads, verified before any retry; no repeated export",
+    "reused": "Accepted A/B, decimal calculation, CSV, exporters and native PDF pagination",
+    "main_integrated": false,
+    "homologation_changed": false,
+    "fiscal_rule_published_or_activated": false,
+    "limitations": [
+      "Only 2026 private investment preparation, documented registration/authorization conditions",
+      "No administrative submission or entitlement decision",
+      "No full sector licensing, foreign-currency equivalence or fiscal benefits engine",
+      "ZEE/ZFI routing predicate uses QA references; no real zone visual recognition proof",
+      "Dossier attachment association does not approve content; synthetic C fixture pending scan not delivered as seed",
+      "Final C context v4 registration differs from frozen draft/report context v3 authorization; no silent rewrite or repeated export."
+    ],
+    "historical_report_persistence": {
+      "case_id": "4133311b-5426-4cec-900d-1f1484484083",
+      "case_version": 7,
+      "context_revision": 3,
+      "mode": "authorization",
+      "association": {
+        "lease": "e5ce142a-1178-46a2-b039-f187139c62cd"
+      },
+      "documents": 1,
+      "context_events": 3,
+      "draft_id": "beba1dec-fc05-4820-b099-24952c5ab36c",
+      "draft_version": 4,
+      "draft_sha256": "4136e82a3b9420ab8f980ec0d7bda6dc2a67b568c18535b5ba0ecc80efd37e37",
+      "saved_context_revision": 3,
+      "saved_preparation_mode": "authorization",
+      "currency": "MZN",
+      "date": "2026-01-01",
+      "preparation_version": "private-investment-preparation-2026-v1"
+    },
+    "directness_control": "Lei 8/2023 art14(b), R13: direct declared before using direct-investment monetary threshold; indirect/unknown unresolved only for dependent results; PPP independent condition remains executable"
+  },
+  "private_investment_report_alignment_20261022": {
+    "functional_revision": "a1fbda06",
+    "status": "targeted missing evidence completed; no functional code changes",
+    "current_persistence": {
+      "case_id": "4133311b-5426-4cec-900d-1f1484484083",
+      "case_version": 8,
+      "context_revision": 4,
+      "mode": "registration",
+      "association": {
+        "lease": "e5ce142a-1178-46a2-b039-f187139c62cd"
+      },
+      "documents": 1,
+      "context_events": 4,
+      "draft_id": "beba1dec-fc05-4820-b099-24952c5ab36c",
+      "draft_version": 5,
+      "draft_sha256": "ba824fe0362ca87b301da55298122796f44fdfb11507830b3fe8f54cf88d132d",
+      "saved_context_revision": 4,
+      "saved_preparation_mode": "registration",
+      "currency": "MZN",
+      "date": "2026-01-01",
+      "preparation_version": "private-investment-preparation-2026-v1"
+    },
+    "reports": {
+      "historic_v3": {
+        "path": "C:\\Mac\\Home\\Downloads\\relatorio-investmoz-sintetico-qa-c-pedido-de-investimento-privado.docx",
+        "sha256": "28cfe4b75116c892d3e29fde389de7d067b456761756bab732af625178ee69ce",
+        "bytes": 16674,
+        "rows": [
+          [
+            "Contexto do investimento",
+            "Revisão 3; sem ZEE, ZFI ou parque seleccionado",
+            "Contexto versionado; não é reconhecimento jurídico. Referência do mesmo dossier no momento da gravação"
+          ],
+          [
+            "Preparação do investimento privado",
+            "Pedido de autorização",
+            "Declarações e requisitos de preparação; sem aprovação jurídica. Contexto congelado v3; private-investment-preparation-2026-v1"
+          ],
+          [
+            "Estudo de viabilidade técnica e económico-financeira",
+            "Documento por associar",
+            "Preparação informativa — simulação, sem submissão à Administração. Integra a preparação do pedido de autorização. R14(1)–(2); https://pt.apiex.gov.mz/wp-content/uploads/2025/02/LEGISLACAO-DE-INVESTIMENTOS-EM-MOCAMBIQUE.pdf#page=45"
+          ],
+          [
+            "Comprovação da capacidade financeira",
+            "Documento por associar",
+            "Preparação informativa — simulação, sem submissão à Administração. Integra a preparação do pedido de autorização. R14(1)–(2); https://pt.apiex.gov.mz/wp-content/uploads/2025/02/LEGISLACAO-DE-INVESTIMENTOS-EM-MOCAMBIQUE.pdf#page=45"
+          ]
+        ]
+      },
+      "current_v4": {
+        "path": "C:\\Mac\\Home\\Downloads\\relatorio-investmoz-sintetico-qa-c-pedido-de-investimento-privado (1).docx",
+        "sha256": "a2849427f4a91fa6ab78e433be8b919baca80a0f4f452a4546a5b169b921d753",
+        "bytes": 16678,
+        "rows": [
+          [
+            "Contexto do investimento",
+            "Revisão 4; sem ZEE, ZFI ou parque seleccionado",
+            "Contexto versionado; não é reconhecimento jurídico. Referência do mesmo dossier no momento da gravação"
+          ],
+          [
+            "Preparação do investimento privado",
+            "Pedido de mero registo",
+            "Declarações e requisitos de preparação; sem aprovação jurídica. Contexto congelado v4; private-investment-preparation-2026-v1"
+          ],
+          [
+            "Estudo de viabilidade técnica e económico-financeira",
+            "Não aplicável; histórico preservado",
+            "Preparação informativa — simulação, sem submissão à Administração. Integra a preparação do pedido de autorização. R14(1)–(2); https://pt.apiex.gov.mz/wp-content/uploads/2025/02/LEGISLACAO-DE-INVESTIMENTOS-EM-MOCAMBIQUE.pdf#page=45"
+          ],
+          [
+            "Comprovação da capacidade financeira",
+            "Não aplicável; histórico preservado",
+            "Preparação informativa — simulação, sem submissão à Administração. Integra a preparação do pedido de autorização. R14(1)–(2); https://pt.apiex.gov.mz/wp-content/uploads/2025/02/LEGISLACAO-DE-INVESTIMENTOS-EM-MOCAMBIQUE.pdf#page=45"
+          ]
+        ]
+      }
+    },
+    "proof_sha256": {
+      "C-report-HISTORICO-contexto-v3.docx": "28cfe4b75116c892d3e29fde389de7d067b456761756bab732af625178ee69ce",
+      "C-report-contexto-v4.docx": "a2849427f4a91fa6ab78e433be8b919baca80a0f4f452a4546a5b169b921d753",
+      "C-report-v3-v4-comparison.json": "722154fd38b2915ec087f804abe66bc4c98c6eff2c4403d8e670d65d257e3446",
+      "C-persistence-v4-draft5.json": "a10505a52c553b4c0e03ece59d20d5a0a20204ae694bcf7174ee0574272ec1c4",
+      "C-new-report-context-v4.png": "b0cf159e6be5a457efdc46eb5e273895c43010caa9727e3b75668f916aa11f8d"
+    },
+    "historic_label": "C-report-HISTORICO-contexto-v3.docx; original bytes unchanged, embedded Contexto congelado v3",
+    "current_label": "C-report-contexto-v4.docx; embedded Contexto congelado v4; registration; study/capacity not applicable",
+    "accepted_tests_repeated": false,
+    "integration_dependencies": [
+      "a76369eb common continuity, required ancestor of a1fbda06",
+      "52fbb146 documentary intermediate, no executable delta",
+      "a1fbda06 adaptive private-investment functionality",
+      "Current branch includes ancestors; do not cherry-pick a1fbda06 alone without a76369eb/equivalent changes"
+    ],
+    "integration_procedure": "After Tempo evaluation/decision, fetch current main, merge preserving concurrent changes and review actual conflicts. a76369eb can integrate independently first; shared ancestry avoids duplicate application. No reset or force-push main. Confirm deployed revision and only changed destination behavior. PRIVATE_INVESTMENT_PREPARATION_ENABLED is separate from tax publication/activation.",
+    "remote_main_read": "57fc914821d0cefa02caa80a74b3d42e663f2742",
+    "main_integrated": false,
+    "fiscal_rules_changed": false
+  },
+  "adaptive_private_path_homologation_20261022": {
+    "authorized_by": "Tempo, user authorization 22/10/2026",
+    "previous_main": "57fc914821d0cefa02caa80a74b3d42e663f2742",
+    "authorized_ancestry": [
+      "a76369eb",
+      "52fbb146",
+      "a1fbda06",
+      "064296e1"
+    ],
+    "integration": "fast-forward, no conflicts or concurrent commits observed at push; no forced update",
+    "first_attempt": {
+      "status": "failed",
+      "commit": "064296e1fbf7b17f932df23c7b3ee5508719dec5",
+      "error": "Verification command failed: node (see protected build log)",
+      "active_release_preserved": true,
+      "requested_commits": [
+        "064296e1fbf7b17f932df23c7b3ee5508719dec5"
+      ],
+      "finished_at": "2026-10-22T08:11:54.420414+00:00"
+    },
+    "compatibility_fix": {
+      "commit": "042ffbde44cac27704d6f8b7ec25b525a42e3575",
+      "cause": "Empty inheritance metadata appended when restoring a legacy draft with no compatible source",
+      "change": "Return original draft when both compatible source and prior inheritance metadata are absent",
+      "targeted_tests": "9 inheritance controls + exact failing legacy partition/recovery test, all passed"
+    },
+    "installed": {
+      "status": "installed",
+      "commit": "042ffbde44cac27704d6f8b7ec25b525a42e3575",
+      "release": "/var/www/investmoz-homologacao/releases/042ffbde44cac27704d6f8b7ec25b525a42e3575-6dfae60c",
+      "previous_release": "/var/www/investmoz-homologacao/releases/57fc914821d0cefa02caa80a74b3d42e663f2742-f563f9a7",
+      "database_migrations": 0,
+      "content_imports": 0,
+      "requested_commits": [
+        "042ffbde44cac27704d6f8b7ec25b525a42e3575"
+      ],
+      "finished_at": "2026-10-22T08:16:16.903501+00:00"
+    },
+    "http": {
+      "/build/revision.json": {
+        "status": 200,
+        "body": {
+          "commit": "042ffbde44cac27704d6f8b7ec25b525a42e3575",
+          "branch": "main",
+          "built_at": "2026-10-22T08:16:14.331119+00:00",
+          "manifest_sha256": "655eef6e6a5e71c5138c68465a5b2ffc36d2cadeff96e6b35682dbfd19d42e79"
+        }
+      },
+      "/api/v1/fiscal-consumer": {
+        "status": 200,
+        "body": {
+          "data": {
+            "enabled": true,
+            "coverage_start": "2026-01-01",
+            "coverage_end": "2026-12-31",
+            "message": "IVA geral sobre base líquida disponível; enquadramento declarado."
+          }
+        }
+      },
+      "/investimentos": {
+        "status": 302,
+        "location": "https://teste-investidor.tempo.co.mz/login"
+      },
+      "/simulador-fiscal": {
+        "status": 200,
+        "body": "HTML available"
+      },
+      "checked_utc": "2026-10-22T08:17:20.250804+00:00"
+    },
+    "configuration_before": {
+      "read_only": true,
+      "utc": "2026-10-22T08:16:34.265947+00:00",
+      "revision": {
+        "commit": "042ffbde44cac27704d6f8b7ec25b525a42e3575",
+        "branch": "main",
+        "built_at": "2026-10-22T08:16:14.331119+00:00",
+        "manifest_sha256": "655eef6e6a5e71c5138c68465a5b2ffc36d2cadeff96e6b35682dbfd19d42e79"
+      },
+      "live": "/var/www/investmoz-homologacao/releases/042ffbde44cac27704d6f8b7ec25b525a42e3575-6dfae60c",
+      "env_path": "/var/www/html/teste-investidor.tempo.co.mz/.env",
+      "env_sha256": "7cdaba591bb5787485a349c24db2fd7c8279436da0eb31502e44db2fffa21d03",
+      "env_mode": "0o640",
+      "uid": 1001,
+      "gid": 33,
+      "private_preparation_env": "unset",
+      "config": {
+        "private_preparation": false,
+        "investor_path": true,
+        "fiscal_consumer": {
+          "enabled": true,
+          "coverage_start": "2026-01-01",
+          "coverage_end": "2026-12-31",
+          "message": "IVA geral sobre base líquida disponível; enquadramento declarado."
+        },
+        "preparation_version": "private-investment-preparation-2026-v1"
+      }
+    },
+    "configuration_enable": {
+      "utc": "2026-10-22T08:16:49.343216+00:00",
+      "revision": {
+        "commit": "042ffbde44cac27704d6f8b7ec25b525a42e3575",
+        "branch": "main",
+        "built_at": "2026-10-22T08:16:14.331119+00:00",
+        "manifest_sha256": "655eef6e6a5e71c5138c68465a5b2ffc36d2cadeff96e6b35682dbfd19d42e79"
+      },
+      "changed": true,
+      "env_before_sha256": "7cdaba591bb5787485a349c24db2fd7c8279436da0eb31502e44db2fffa21d03",
+      "env_after_sha256": "a6b4e9064cf6dbb2d945b53418a6c9252f9c736ff3fde4016b95b74885a9ee0f",
+      "backup": "/var/lib/investmoz-deploy/backups/private-preparation-20261022/env-7cdaba591bb5787485a349c24db2fd7c8279436da0eb31502e44db2fffa21d03.private",
+      "backup_bytes_verified": true,
+      "only_key_changed": "PRIVATE_INVESTMENT_PREPARATION_ENABLED",
+      "mode_preserved": true,
+      "owner_preserved": true,
+      "config": {
+        "private_preparation": true,
+        "investor_path": true,
+        "fiscal_consumer": {
+          "enabled": true,
+          "coverage_start": "2026-01-01",
+          "coverage_end": "2026-12-31",
+          "message": "IVA geral sobre base líquida disponível; enquadramento declarado."
+        },
+        "preparation_version": "private-investment-preparation-2026-v1"
+      },
+      "fiscal_configuration_changed": false,
+      "database_operations": false,
+      "recovery": "Restore previous key value only against recorded post-change hash, rebuild config cache; preserve subsequent changes and all data"
+    },
+    "configuration_after": {
+      "read_only": true,
+      "utc": "2026-10-22T08:17:21.883131+00:00",
+      "revision": {
+        "commit": "042ffbde44cac27704d6f8b7ec25b525a42e3575",
+        "branch": "main",
+        "built_at": "2026-10-22T08:16:14.331119+00:00",
+        "manifest_sha256": "655eef6e6a5e71c5138c68465a5b2ffc36d2cadeff96e6b35682dbfd19d42e79"
+      },
+      "live": "/var/www/investmoz-homologacao/releases/042ffbde44cac27704d6f8b7ec25b525a42e3575-6dfae60c",
+      "env_path": "/var/www/html/teste-investidor.tempo.co.mz/.env",
+      "env_sha256": "a6b4e9064cf6dbb2d945b53418a6c9252f9c736ff3fde4016b95b74885a9ee0f",
+      "env_mode": "0o640",
+      "uid": 1001,
+      "gid": 33,
+      "private_preparation_env": "true",
+      "config": {
+        "private_preparation": true,
+        "investor_path": true,
+        "fiscal_consumer": {
+          "enabled": true,
+          "coverage_start": "2026-01-01",
+          "coverage_end": "2026-12-31",
+          "message": "IVA geral sobre base líquida disponível; enquadramento declarado."
+        },
+        "preparation_version": "private-investment-preparation-2026-v1"
+      }
+    },
+    "effective_procedural_version": "private-investment-preparation-2026-v1",
+    "new_fiscal_rules_published_or_activated": false,
+    "qa_fixtures_copied": false,
+    "accepted_scenarios_repeated_manually": false,
+    "limitations": "No new scenario executed in homologation and no real dossier or personal data created. QA functional evidence reused; destination verification limited to revision, configuration and entry routes. Sector/fiscal exclusions remain explicit."
  }
 }
@@ -2041,3 +2041,113 @@ Limites concretos: este é o primeiro incremento utilizável de continuidade e e
 Revisão: abrir o simulador QA com o dossier A `92d0836c-0ffb-4e07-a7f5-0e8ca3f594b9` ou B `1872412f-251a-4f6d-bf18-70388e71a16a`; usar a conta sintética QA existente, nunca actores sintéticos na homologação. O router privado de QA usa a instalação já existente do percurso, activada apenas neste ensaio isolado; não há migration ou nova exigência de funções. Entregar a candidata para revisão pelo processo Git existente, preservando alterações concorrentes. Uma integração futura exige rever o delta relativamente a main e o estado de instalação/configuração do percurso no destino; não publicar regras ou alterar interruptores fiscais como consequência desta correcção. Preservar todos os históricos na suspensão ou reversão de código.

 Fecho da observação deste incremento: o regresso A ao dossier gravou a evidência financeira `43317c22-50c8-40cf-98e4-e5d4d108c372`, rascunho `cf4dec46-c96c-4aa6-aa9c-1a8d6ecb1bea` v8, contexto v1, com hash preservado. A ligação de inspecção do Edge interrompeu-se depois da navegação; o inventário mostrou o endereço do mesmo dossier e a leitura autenticada do serviço confirmou a gravação. A parte visual final do regresso não foi observada e fica como limitação da ferramenta, não falha do simulador. B recuperou contexto v2 e gravou rascunho v6, mantendo USD e sem execução fiscal. O relatório gerado destes dados recuperados conserva a versão do parque e benefício indeterminado. O enriquecimento automático do rascunho privado é exclusivo do proprietário autenticado; o acesso de gestão ao dossier não concede por esta alteração acesso ao rascunho privado da conta.
+
+
+### Revisão de a76369eb e primeiro percurso adaptativo fundamentado — v1, 22/10/2026
+
+**Revisão encerrada no âmbito de a76369eb, sem integração.** O último regresso tem prova equivalente: destino do mesmo dossier observado pelo inventário do navegador e evidência `43317c22-50c8-40cf-98e4-e5d4d108c372` confirmada no serviço, ligada ao rascunho v8/contexto v1 e ao hash `a21fa5779bf8b8df366f16683c8a9bb9817a6d2921c7384f85df02135307fa13`. A observação visual final continuou limitada pela ferramenta. Não se repetiram A/B, cálculos, exportações ou nova sessão; reutilizam-se as provas aceites. Leitura dirigida do delta: isolamento por proprietário/dossier, edições/apagamentos, origem monetária, controlo de escrita e ausência de publicação fiscal. Não foi identificada nova preparação técnica que condicione a decisão de integração deste âmbito. A adaptação jurídica seguinte é independente.
+
+**Percurso delimitado preparado:** preparação de um pedido de investimento privado para empreendimento económico em Moçambique, com actividade concreta declarada, instalação identificada e operações mensais enquadráveis no consumidor IVA geral existente. Trata a preparação do pedido de investimento; não se apresenta como licenciamento sectorial completo, certificado emitido, direito a incentivo ou submissão à Administração. Investidor nacional/estrangeiro, actividade, modalidade e localização são condições distintas. A saída é formulário orientado, etapas/documentos aplicáveis e simulação identificada pelo seu âmbito. Não se escolhe “Turismo” ou uma ZEE para presumir requisitos ou benefícios.
+
+**Fonte primária aplicada:** compilação oficial APIEX “Legislação de Investimentos em Moçambique”, exemplar obtido de https://pt.apiex.gov.mz/wp-content/uploads/2025/02/LEGISLACAO-DE-INVESTIMENTOS-EM-MOCAMBIQUE.pdf — 6467655 bytes, SHA256 `ba1e9eaabfec5d0c4cb2d9f2444a6860f7a90f222034764197829be402d408ed`. Contém Lei8/2023 (pp.8–32), Decreto8/2024/Regulamento (pp.36–59), CBF (pp.64–92). Aceitação oficial de08/10 mantida; não há exigência de segunda autenticação ou aprovação jurídica da Tempo. Inventários existentes de604 registos/exemplares/anexos e9901 caminhos do acervo reutilizados antes da selecção; cópia privada, texto extraído e citações em `outputs/adaptive-path-20261022`. Não importar/publicar automaticamente. As pendências históricas genéricas de nova certificação nos levantamentos de28/09 e03/10 não são gates deste lote.
+
+**Período:** Decreto8/2024, artigo5 do diploma preambular, indica aplicação desde a publicação de7/03/2024; Lei8/2023, artigo32, indica90dias após publicação. O lote proposto cobre datas de projecto em2026 e preserva estes inícios, exemplar e versão. Não foi encontrada alteração nas consultas oficiais dirigidas desta execução; isso não certifica inexistência de actos posteriores. A compilação de2025 não constitui consolidação universal de2026. Na ligação executável, uma fonte/versão sem cobertura temporal não autoriza fallback para a versão mais recente. Os artigos citados são do **Regulamento anexo** quando identificado “R”; “L” designa a Lei8/2023. Rastrear esta distinção evita confundir os dois artigos9 ou o artigo5 preambular com o do Regulamento.
+
+| Condição | Fonte e período | Efeito no formulário | Efeito no percurso | Efeito no cálculo | Informação em falta / estado da ligação |
+| --- | --- | --- | --- | --- | --- |
+| Projecto económico em Moçambique que procura garantias/incentivos; actividade efectiva conhecida | L2(1)–(3), pp.8–9; período2026 deste lote | Reutilizar localização e actividade; perguntar a finalidade jurídica apenas se ausente | S02 identifica cobertura do procedimento; actividades excluídas recebem encaminhamento próprio | Não inferir benefício ou exclusão de IVA a partir deste âmbito | Falta ligação executável da cobertura ao perfil; legislação sectorial especial fica fora deste lote |
+| Capital/recursos do exterior ou nacionais; pessoa, residência e constituição separadas | L3/anexo, pp.28–29; R4–6, pp.38–40; período2026 | Reutilizar os dados declarados; pedir origem/forma do aporte quando faltar, sem transformar nacionalidade em classificação do capital | Acrescentar preparação da prova/registo do aporte externo quando aplicável | Nenhuma mudança automática de taxa IVA ou conversão; transferências cambiais não calculadas | Falta dado estruturado de aporte e ligação à documentação; requisitos cambiais concretos não abrangidos |
+| Implementadora em constituição ou já registada | R9(1)(b), p.41; R14(1)(b), p.45; desde7/03/2024, recorte2026 | Mostrar a alternativa documental correspondente, sem exigir novo preenchimento da entidade | S05/S06: reserva de denominação ou certidão comercial, com estado declarado/associado por conferir | Não altera IVA | Falta associar categorias documentais existentes à alternativa e ao estado do cadastro |
+| Implantação em instalações arrendadas ou com DUAT | R9(1)(c)–(d), pp.41–42; R14(1)(c)–(d), p.46; recorte2026 | Reutilizar local; perguntar apenas a modalidade/evidência ainda ausente | S06 identifica esboço/planta e alternativa contrato/DUAT; sem converter ausência de título em ausência de direito | Não atribui taxa, custo fundiário ou benefício | Falta modalidade estruturada e associação ao documento; sem decidir titularidade/disponibilidade |
+| Pedido por representação comercial estrangeira, distinto de qualquer investidor estrangeiro | R9(2)–(3), p.42; recorte2026 | Pergunta de representação apenas quando a implantação declarada o permita; depois referência da licença e documento | S06 acrescenta licença de representação e identifica formalidades documentais pertinentes | Sem alteração da taxa geral | Falta modalidade e origem documental estruturadas; não exigir licença a todo investidor estrangeiro |
+| Nenhuma condição de autorização; ou dimensão/actividade/terra que a exija | L22(1)(b)–(2), pp.20–21; R13(2), R14 e R21, pp.45–50; recorte2026 | Reutilizar montante/moeda/actividade/área; perguntar apenas PPP/concessão, implicações ou dados ainda desconhecidos | Seleccionar preparação de mero registo ou autorização; na segunda, S02/S06 acrescentam estudo de viabilidade e capacidade financeira | Comparação do montante exige MZN ou equivalência documentada; não converter nem inventar taxa; IVA permanece componente separada | Falta ligar os predicados e evidências ao perfil. “Não sei” não equivale a “não”. Limite de32mil milhões MZN só resolve a condição de montante, não todas as restantes |
+| Localização geral versus ZEE/ZFI com referência e âmbito documentados | R13(1)(a)–(b), p.45; R10(4), p.43; recorte2026 | Reutilizar zona/versionamento; pedir reconhecimento/condições pertinentes em falta | Diferenciar entidade de encaminhamento e articulação aplicável; S08/S17 conservam evidências e pendências | Sem regra executável do benefício, mostrar resultado especial indeterminado e cenário geral separado | a76369eb já apresenta referência/limite; faltam ligações jurídicas de encaminhamento e condições. Parque industrial não equivale automaticamente a ZEE/ZFI |
+| Operação mensal interna geral, base líquida, MZN e período coberto pela versão publicada | Regra IVA já fundamentada/autorizada; Lei22/2022 art.17(1), fontes/limites no recibo existente; recorte fiscal2026 | Reutilizar vendas/mês/moeda; perguntar apenas pressupostos fiscais ainda ausentes | Ligar cálculo e relatório à mesma versão de contexto/regra | Consumidor existente calcula por versão servida; zero difere de falta; preço com IVA incluído não vira base líquida | Ligação mensal já demonstrada. Dedução, reembolso, saldo final e benefício especial continuam fora |
+| Mudança de título/contacto ou outra condição irrelevante para a regra aplicada | Decisão Tempo22/10 e contratos existentes; escolha técnica de dependências identificada | Preservar a edição e preencher o que continuar compatível | Não reiniciar revisões/etapas sem dependência relevante | Não criar outra execução nem mudar taxa/base | Prova de título e testes de dependências já aceites; estender por dependência, não por “qualquer alteração” |
+
+**Diferença útil que a implementação deste lote deve demonstrar, sem repetir A/B:** um caso C exclusivamente sintético, empresa em constituição, actividade económica não extractiva declarada, instalações arrendadas, capital emMZN, período2026. Primeiro completar as condições de enquadramento; depois a preparação de mero registo mostra a alternativa reserva de denominação/arrendamento. Alterar a condição de autorização para verdadeira troca o resultado procedimental, os campos necessários e os documentos para estudo/capacidade financeira. Com condição desconhecida, a selecção fica indeterminada e pede apenas essa informação. Alterar para representação comercial estrangeira acrescenta a licença pertinente; mudar apenas nacionalidade não produz esse efeito. Alterar de localização geral para ZEE/ZFI documentada altera o encaminhamento e as verificações, sem conceder benefício. O IVA geral continua matematicamente igual quando a mudança não afecta a sua regra; mudar vendas/base/moeda/período altera ou impede o cálculo conforme a cobertura existente. Não forçar um resultado numérico diferente quando a lei não o determina.
+
+**Cadastro e código separados:** o conteúdo jurídico acima está preparado, com artigos, exemplar e início temporal. Falta cadastrar as correspondências versionadas campo/condição/etapa/documento e ligar a sua execução ao perfil existente. Usar o mesmo dossier, prévia/confirmar, definições/questionários versionados e suporte condicional `when` já utilizado nos formulários; reutilizar resolvedor temporal, avaliação e aritmética exacta nas interfaces em que sejam compatíveis, com adaptador explícito para os predicados procedimentais, sem criar outro motor nem armazenar procedimentos como imposto. O contexto já tem sector/actividade/localização/moeda/período/entidade; as respostas de modalidade e evidências ainda não ligadas devem ser acrescentadas ao mesmo contexto cifrado, com origem e alterações deliberadas. Reutilizar vínculos documentais/históricos e permissões existentes. Não alterar a definição publicada dos19passos nem activar outra regra fiscal para executar este cadastro.
+
+**Estado desta entrega:** revisão de a76369eb concluída no âmbito aceite; **percurso seguinte fundamentado e delimitado, ainda não implementado/demonstrado de ponta a ponta**. A tabela não é prova de funcionalidade nem declara licenciamento sectorial completo. Não integrar este documento como se instalasse o percurso. Próxima execução técnica concreta: ligar as condições acima, persistir decisões/documentos e verificar apenas as transições de C, recuperação e relatório; conservar as provas aceites de contexto e IVA. Código, publicação de parâmetros/regras e activação continuam operações separadas. Não há nova autorização organizacional ou validação jurídica da Tempo presumida.
+
+
+### Percurso de investimento privado executável em QA — 22/10/2026
+
+Implementação do delta de `52fbb146`, na branch `codex/private-investment-path-executable-QA`. A integração independente de `a76369eb` não foi repetida nem condicionada por este lote. Não houve escrita na homologação, integração em main, publicação ou activação de regras fiscais.
+
+**Orientação permanente aplicada:** decisão expressa da Tempo de 22/10, registada também em AGENTS.md: legislação, modelos e procedimentos oficiais disponibilizados são a base aceite para implementar; decisões da Tempo orientam a implementação. Não existe nova aprovação jurídica genérica, aprovador adicional ou validação de credibilidade como condição para executar este percurso. Dados concretamente em falta são identificados por campo e não anulam os restantes requisitos. Associação documental não equivale a reconhecimento administrativo; esta distinção é informativa, sem bloquear a gravação ou a preparação.
+
+**Ligação executável:** `PrivateInvestmentPreparation` é o adaptador delimitado das condições procedimentais já documentadas para o contexto cifrado do dossier. Correspondência `private-investment-preparation-2026-v1`, exemplar APIEX/hash anteriormente registados, recorte de início previsto em 2026. Reutiliza campos conhecidos do mesmo projecto/rascunho, permissões, vínculos documentais, prévia assinada, controlo de concorrência, chave idempotente, eventos antes/depois e os 19 passos existentes. Não é outro motor fiscal, catálogo paralelo de benefícios ou novo processo de aprovação. O resolvedor fiscal publicado e a aritmética decimal existentes continuam responsáveis pelos seus cálculos; não se armazenaram predicados procedimentais como impostos.
+
+No dossier normal, «Preparar o pedido de investimento privado» abre o editor de contexto. Valores já declarados ficam recuperados e editáveis, sem nova confirmação por ecrã. Dados condicionais de área só aparecem para extensão de terra/concessão florestal. A prévia mostra ramo antes/depois, documentos novos/inactivos, passos afectados e resultados que precisam de revisão. Apenas a confirmação grava uma revisão; cancelamento conserva o estado anterior. Os requisitos correspondentes aparecem nas etapas S02/S05/S06 e o próximo passo acompanha mero registo/autorização. As dependências formais da definição publicada não foram substituídas por novos bloqueios.
+
+**Fundamento executado:** Lei 8/2023 artigos 2 e 22; Regulamento aprovado pelo Decreto 8/2024 artigos 5, 9, 13, 14 e 21, conforme a tabela de 52fbb146 acima. Na interface, R designa este Regulamento. As exigências têm razão, artigo, período e ligação ao exemplar oficial. As alternativas certidão/reserva e DUAT/arrendamento não são cumulativas. Representação estrangeira determina a licença correspondente; nacionalidade ou residência, isoladamente, não a determinam. Aporte externo tem origem declarada separadamente da nacionalidade. Montante >32 mil milhões MZN, terra >=10 mil ha e concessão florestal >100 mil ha usam comparação decimal exacta, sem conversão cambial presumida. R21 distingue Finanças/Conselho de Ministros conforme as condições efectivamente conhecidas; uma condição positiva suficiente não espera pelas restantes para identificar o pedido de autorização.
+
+| Comparação nova, exclusivamente QA | Campos e documentos | Próximo passo / efeito no cálculo | Prova |
+| --- | --- | --- | --- |
+| C: empresa em constituição, actividade geral, 1.000.000 MZN, 01/01/2026, modalidade doméstica, capital nacional, instalações arrendadas; condições de autorização negativas | Reserva de denominação, identificação, planta e arrendamento; não exige certidão, DUAT, licença de representação ou estudo/capacidade de autorização | Mero registo; encaminhamento Governador. Nenhuma taxa IVA alterada | UI → prévia → confirmar; contexto v1 |
+| C: associar suporte sintético já existente ao arrendamento | Mesmo documento associado por ID; não cria cópia nem o aprova | Conserva o pedido; contexto v2 | UI; um vínculo em desk_documents |
+| C: PPP/concessão empresarial passa a sim, modalidade passa a representação estrangeira e instalações a DUAT | Entram estudo/capacidade, licença de representação e DUAT; arrendamento deixa de ser exigido, conservando o documento anterior | Autorização, Conselho de Ministros; S02/S05/S06/S07 para revisão. Esta mudança meramente procedimental não invalida os inputs do IVA | Prévia visual antes de confirmar; contexto v3 recuperado; PNG C-authorization-preview |
+| C: recuperação e simulador | MZN, data, título, contexto v3 e preparação por autorização recuperados sem reintrodução; arrendamento inactivo visível no histórico | Mesmo âmbito fiscal geral; nenhuma execução fiscal nova pedida neste ensaio | Dossier normal, simulador e rascunho ligado; leitura persistida e relatório Word |
+| Regresso autorização → mero registo; entidade em constituição → existente | Estudo/capacidade/licença deixam de ser exigidos; arrendamento anterior volta associado; certidão substitui reserva, sem apagar histórico | Ramo e requisitos recalculados | Controlo HTTP transaccional dirigido, não repetição visual A/B |
+| ZEE/ZFI versus parque industrial | Encaminhamento APIEX condicionado ao enquadramento reconhecido; parque não é convertido em ZEE/ZFI | Nenhum benefício ou taxa especial concedidos | Predicados com referências sintéticas de QA; não prova de elegibilidade de uma zona real |
+
+**Provas novas:** três testes feature, 96 asserções, exclusivamente na base `simulator_fiscal_delta_20261021_test`, loopback 55441, com transacções revertidas e guarda do alvo. Cobrem limiares exactos, desconhecidos, exclusões/período, não inferência por nacionalidade, alternativas e preservação de vínculo, recuperação, idempotência, prévia sem escrita, adulteração, documento de outro dossier recusado e consumidor desligado, incluindo edição independente do título sem perder snapshot ou vínculos. Um teste frontend confere somente o novo conteúdo congelado do relatório. TypeScript e build passaram. Não foram repetidos cálculos decimais, exportadores completos, paginação PDF, CSV ou ensaios A/B aceites.
+
+**Recibo C da fase por autorização (histórico v3):** dossier `4133311b-5426-4cec-900d-1f1484484083`; contexto v3; rascunho `beba1dec-fc05-4820-b099-24952c5ab36c`, v4, SHA256 `4136e82a3b9420ab8f980ec0d7bda6dc2a67b568c18535b5ba0ecc80efd37e37`. Um documento sintético `e5ce142a-1178-46a2-b039-f187139c62cd`, sem pretensão de autenticidade oficial ou reconhecimento; mantém quarentena/scan pendente, sem contornar o carregamento/antimalware. A fixture apenas disponibiliza metadados privados para observar associação, não ensaia novamente uploads e não faz parte de dados/migrações de entrega. Três eventos de mudança do contexto; uma associação documental. C não contém projecção de vendas nem novo resultado fiscal; as provas anteriores dessa componente são reutilizadas.
+
+**Relatório efectivamente transferido:** `relatorio-investmoz-sintetico-qa-c-pedido-de-investimento-privado.docx`, 16.674 bytes, SHA256 `28cfe4b75116c892d3e29fde389de7d067b456761756bab732af625178ee69ce`. Conferido o novo conteúdo: pedido de autorização, versão, fundamentos R14 e exigências não aplicáveis com histórico preservado. Não se repetiu a verificação de paginação/exportadores. Os anexos do dossier não são inseridos silenciosamente no pacote; mantém-se a selecção explícita existente. O relatório identifica a preparação/simulação e não alega submissão ou aceitação administrativa.
+
+**Limitação da ferramenta:** a observação do evento de download excedeu o tempo e a extensão perdeu a ligação. O ficheiro terminou e foi encontrado em Transferências antes de qualquer repetição; conteúdo/hash conferidos localmente. Não se repetiu a exportação nem se classificou o incidente como falha do simulador. A prévia de impacto e recuperação já tinham prova visual; a recepção do ficheiro é prova distinta.
+
+**Limites concretos:** este lote prepara o pedido de garantias/incentivos de investimento privado, não executa submissão administrativa, licenciamento completo por sector ou decisão de elegibilidade. Prospecção/pesquisa/produção extractiva, investimento público/exclusivamente social sem fins lucrativos e períodos fora de 2026 não são cobertos por este adaptador; processamento industrial tem o ramo de autorização documentado. A equivalência de montante noutra moeda não é determinada sem dados/fundamento cambial aplicáveis; condições positivas independentes continuam executáveis. O catálogo visual deste QA contém apenas parques sintéticos, não uma ZEE/ZFI real elegível: encaminhamento especial conferido no predicado, sem declarar prova visual de reconhecimento real. Benefícios territoriais, deduções, reembolsos e apuramento final do IVA continuam indisponíveis; o cálculo geral já autorizado conserva o seu âmbito.
+
+**Utilização e integração:** abrir `http://127.0.0.1:18580/investimentos/4133311b-5426-4cec-900d-1f1484484083` na conta QA habitual. Usar «Comparar e alterar contexto», editar apenas a condição relevante, comparar e confirmar; para documentos, usar o Balcão do mesmo dossier e associar os existentes. QA habilita `investor-path.private_preparation=true` no router privado. A configuração de entrega `PRIVATE_INVESTMENT_PREPARATION_ENABLED` fica desligada por defeito; a homologação não foi alterada. Integração eventual pelo processo Git existente: rever branch/código e limites, incorporar sobre main actualizado preservando alterações concorrentes, build e conferir apenas o delta no destino; habilitação deste percurso é uma configuração separada, não publicação/activação fiscal. Suspender a configuração oculta o novo consumidor e recusa novas escritas específicas, sem eliminar contexto, documentos, eventos, rascunhos ou relatórios congelados. Sem migração ou seed de fixtures no destino. Nenhuma nova ronda de preparação técnica foi identificada para este recorte; revisão/decisão de integração continuam separadas.
+
+
+**Distinção final conferida, sem nova validação genérica:** Lei 8/2023 artigo 14(b) distingue investimento directo/indirecto; R13 refere expressamente investimento directo nos limiares monetários. Acrescentado o dado «Tipo deste investimento», separado da origem/nacionalidade. Sem esse dado, a via dependente da dimensão permanece indeterminada; para forma indirecta este lote não determina dimensão/encaminhamento monetário, mas continua a avaliar as condições independentes documentadas. PPP/concessão positiva continua a determinar autorização e Conselho de Ministros, sem esperar por esse campo irrelevante à decisão já suficiente. A interface foi conferida: retirar a condição PPP pede exactamente o tipo em falta; declarar directo resolve mero registo e retira estudo/capacidade financeira. Comparação antes de confirmar em `C-final-directness-preview.png` e percurso recuperado em `C-final-path.png`.
+
+Estado final C: dossier v8, contexto **v4**, investimento directo declarado, PPP não, pedido de **mero registo**; quatro eventos de contexto e um documento/vínculo conservados. A modalidade estrangeira/DUAT conservou a edição deliberada. O rascunho v4 e o Word já transferido mantêm o contexto **v3 por autorização**, com hash acima: são prova histórica congelada e não o relatório da revisão v4. Não houve reescrita silenciosa nem reexportação. Ao abrir o simulador, o mecanismo comum de continuidade disponibiliza a revisão actual para o próximo rascunho/relatório; as provas anteriores deste mecanismo continuam reutilizadas.
+
+
+### Correspondência do novo relatório com o contexto v4 e dependências Git — 22/10/2026
+
+Verificação dirigida solicitada pela Tempo após a avaliação do resumo de `a1fbda06`; nenhuma alteração funcional necessária. A prova anterior só demonstrava o Word congelado v3. Nesta continuação abriu-se o simulador pelo link normal do mesmo dossier C (incluindo o rascunho ligado), recuperou-se automaticamente o contexto v4 e gerou-se **uma** saída Word nova. Não se repetiram cálculos, CSV, paginação, anexos ou ensaios A/B aceites; não houve nova validação jurídica, integração ou alteração fiscal.
+
+| Elemento | Word histórico v3 | Novo Word do contexto v4 |
+| --- | --- | --- |
+| Identificação dentro do documento | «Revisão 3» e «Contexto congelado v3» | «Revisão 4» e «Contexto congelado v4» |
+| Pedido | Autorização | Mero registo |
+| Estudo de viabilidade | Documento por associar | Não aplicável; histórico preservado |
+| Capacidade financeira | Documento por associar | Não aplicável; histórico preservado |
+| Bytes / SHA256 | 16.674 / `28cfe4b75116c892d3e29fde389de7d067b456761756bab732af625178ee69ce` | 16.678 / `a2849427f4a91fa6ab78e433be8b919baca80a0f4f452a4546a5b169b921d753` |
+| Cópia identificada para revisão | `outputs/private-path-executable-20261022/C-report-HISTORICO-contexto-v3.docx` | `outputs/private-path-executable-20261022/C-report-contexto-v4.docx` |
+
+O original v3 conserva exactamente os bytes/hash anteriores; a cópia está explicitamente designada **HISTÓRICO**. A revisão congelada no próprio Word identifica o contexto a que pertence, sem o transformar no estado actual. O novo ficheiro foi encontrado em Transferências após o clique de exportação e conferido por leitura das células efectivamente geradas; recibo em `C-report-v3-v4-comparison.json`. O rascunho passou a v5, SHA256 `ba824fe0362ca87b301da55298122796f44fdfb11507830b3fe8f54cf88d132d`, com contexto v4 e preparação por mero registo; dossier v8/contexto v4 e um documento mantidos. Prova visual de recuperação em `C-new-report-context-v4.png`. Não se altera a validade histórica da prova v3.
+
+**Dependências para integração após a avaliação da Tempo:** ancestralidade confirmada `57fc9148 → a76369eb → 52fbb146 → a1fbda06`. `a76369eb` fornece a continuidade comum do contexto/edições e é dependência funcional de `a1fbda06`; pode ser integrado independentemente. `52fbb146` é a preparação documental intermédia, sem código executável. A branch `codex/private-investment-path-executable-QA` inclui essa ancestralidade e a presente prova documental; não aplicar apenas o diff de `a1fbda06` num destino sem a continuidade ou alteração equivalente. Se a76369eb já tiver sido integrado, o merge normal reconhece a ancestralidade e não o reaplica como um segundo desenvolvimento.
+
+Procedimento: após a decisão, recuperar o main actual, rever a comparação e fazer integração Git que preserve as alterações concorrentes; resolver apenas conflitos efectivos, sem reset/force-push de main. A leitura desta continuação encontrou main em `57fc914821d0cefa02caa80a74b3d42e663f2742`; é fotografia do estado, não autorização para ignorar commits posteriores. Conferir a revisão servida e só o delta no destino. A habilitação `PRIVATE_INVESTMENT_PREPARATION_ENABLED` é configuração distinta; não publica nem activa regras fiscais. Nesta execução a branch permanece separada, sem integração/habilitação na homologação. Limitações sectoriais/fiscais explícitas mantêm âmbito próprio e não bloqueiam este recorte concluído.
+
+
+### Integração autorizada do percurso adaptativo — 22/10/2026
+
+A Tempo autorizou a implementação após o fecho do recorte. Main remoto foi actualizado por avanço directo de `57fc9148` para `064296e1`, preservando a sequência `a76369eb → 52fbb146 → a1fbda06 → 064296e1`; não havia alteração concorrente ou conflito no momento do envio. A cadeia automática recusou a primeira tentativa no teste frontend «server draft snapshots split private identity from economic values»: 188/189 passaram. A versão servida anterior `57fc9148` foi conservada, conforme o mecanismo de recuperação; não se contornou a verificação.
+
+Causa concreta: o adaptador de continuidade acrescentava `compatible_fields_snapshot` vazio na recuperação de um rascunho legado sem nenhuma origem compatível. Correcção delimitada na branch `codex/adaptive-delivery-compatibility-QA`: devolver o rascunho original quando não há origem compatível nem metadados de herança anteriores. A herança com origem/metadados continua executada, preservando edições e limites por dossier. Nove controlos dirigidos da herança e o teste exacto da partição/recuperação passaram; não se reabriram os cálculos, relatórios ou cenários aceites. A correcção deve seguir o mesmo processo automático; não altera regras fiscais, esquema ou dados activos. Recibos da tentativa e da disponibilização final em `outputs/investmoz-adaptive-path-delivery-20261022`.
+
+
+### Percurso adaptativo disponibilizado na homologação — 22/10/2026, 10:17 Maputo
+
+Autorização expressa da Tempo executada. Main passou de `57fc9148` por avanço directo para `064296e1`, conservando a ancestralidade `a76369eb → 52fbb146 → a1fbda06 → 064296e1`. O remoto não tinha alterações concorrentes adicionais no momento da integração; não houve conflito, reset ou envio forçado. A primeira verificação automática recusou o novo metadado vazio na recuperação legada e conservou a release anterior; a causa e a correcção dirigida constam da secção anterior. A correcção `042ffbde44cac27704d6f8b7ec25b525a42e3575` foi ensaiada em branch e integrada por avanço directo, sem suprimir o teste que detectou a incompatibilidade.
+
+**Revisão efectivamente servida:** `042ffbde44cac27704d6f8b7ec25b525a42e3575`, branch main, build de 22/10/2026 às 10:16:14 Maputo; instalação automática concluída às 10:16:16. Manifesto SHA256 `655eef6e6a5e71c5138c68465a5b2ffc36d2cadeff96e6b35682dbfd19d42e79`. Conferida em `https://teste-investidor.tempo.co.mz/build/revision.json` e no recibo protegido da cadeia. A cadeia correu as verificações próprias; manualmente só foram repetidos os dez controlos afectados pela incompatibilidade. Zero migrations e zero importações no destino, sem copiar fixtures QA.
+
+**Funcionalidade utilizável:** `https://teste-investidor.tempo.co.mz/investimentos` (login normal); abrir ou criar o dossier legítimo do investimento e usar «Preparar o pedido de investimento privado» / «Comparar e alterar contexto». Estão disponíveis as perguntas condicionais, fundamentos, comparação antes de confirmação, requisitos/documentos e próximos passos do lote `private-investment-preparation-2026-v1`, com os limites de 2026 já documentados. A conferência do destino limitou-se à revisão, configuração efectiva e entradas: investimentos redirecciona ao login (302), simulador responde 200. Não se criaram dossiers/contas reais ou sintéticas no destino nem se repetiram os cenários funcionais QA aceites.
+
+**Habilitação concreta, distinta de fiscalidade:** a configuração do percurso `PRIVATE_INVESTMENT_PREPARATION_ENABLED` estava ausente/false; passou a true mediante a sessão SSH habitual autenticada pelo utilizador. Antes da escrita foram conferidos revisão servida e hash da configuração; cópia protegida dos bytes anteriores verificada, alteração limitada a essa chave, proprietário e modo0640 preservados, cache de configuração reconstruída e workers notificados de reinício gracioso. Hash .env anterior `7cdaba591bb5787485a349c24db2fd7c8279436da0eb31502e44db2fffa21d03`; posterior `a6b4e9064cf6dbb2d945b53418a6c9252f9c736ff3fde4016b95b74885a9ee0f`. A leitura posterior confirmou `investor-path.enabled=true` e `private_preparation=true`. A cópia de recuperação permanece privada em `/var/lib/investmoz-deploy/backups/private-preparation-20261022/`; não contém uma publicação de parâmetros e não segue para Git.
+
+**Estado fiscal preservado:** nenhuma publicação/activação de nova regra e nenhuma operação na base activa. O consumidor IVA geral previamente autorizado manteve a mesma disponibilidade, cobertura2026 e mensagem antes/depois. As exclusões sectoriais, forma indirecta/dimensão monetária não determinada, benefícios territoriais e apuramento fiscal completo continuam explícitos e não bloqueiam o lote procedimental concluído.
+
+**Suspensão/recuperação:** desligar somente a chave do novo percurso e reconstruir cache/reiniciar graciosamente os workers mantém dossiers, documentos, respostas, versões, relatórios e históricos. Para reverter configuração, usar o valor anterior apenas depois de conferir o hash actual e preservar alterações posteriores; não substituir todo o .env sem conferir concorrência. A reversão de código/build segue o procedimento de releases já existente, sem restaurar dados antigos. A release anterior foi efectivamente conservada na primeira tentativa recusada. Recibo completo local em `outputs/investmoz-adaptive-path-delivery-20261022/delivery-receipt.json`; a presente actualização documental fica na branch de registo, sem novo push main ou nova disponibilização desnecessária.
@@ -1,24 +1,232 @@
+import {
+    PreparationSummary,
+    type Preparation,
+} from '@/components/private-investment-preparation';
 import { Link } from '@inertiajs/react';

-type Snapshot = {context_revision:number;path?:{definition_version:number;steps:Array<{code:string;title:string;applicability:string;reason:string;state:string;context_review_required?:boolean}>}; zone?:{title:string;href:string;version:number|string;fields?:Record<string,string>;analysis?:{conditions?:Array<{id:string;label:string;knowledge:string;source_reference?:string;valid_from?:string;valid_until?:string}>;source?:{title:string;url:string;diploma?:string;article?:string;valid_from?:string;valid_until?:string}|null}}|null;fields?:Record<string,string>};
-export function InvestmentContextAssessment({raw,contextId}:{raw:unknown;contextId?:string|null}) {
-    let snapshot:Snapshot|null=null;
-    try {const value=JSON.parse(String(raw ?? ''));if(value.version===1) snapshot=value;} catch { /* Missing context remains explicit. */ }
-    if(!snapshot) return null;
-    const fields=snapshot.fields ?? {};const zone=snapshot.zone;
-    const regime=zone?.fields?.investment_regime ?? fields.investment_regime;
-    const names:Record<string,string>={zee:'ZEE',zfi:'ZFI',industrial_park:'Parque industrial'};
-    return <section className="space-y-2 rounded border border-amber-400 p-3" aria-label="Aplicabilidade ao investimento">
-        <h3 className="font-semibold">Aplicabilidade ao investimento · contexto v{snapshot.context_revision}</h3>
-        <p>Origem do investidor: {{national:'nacional',foreign:'estrangeiro',mixed:'misto'}[fields.investor_origin] ?? 'informação em falta'}. Residência fiscal declarada: {fields.tax_residency_country || 'informação em falta'}. Estas condições são distintas; uma não determina a outra.</p>
-        {zone ? <><p><strong>Potencialmente aplicável — análise específica de {names[regime ?? ''] ?? 'zona seleccionada'}.</strong> <Link className="underline" href={zone.href}>{zone.title} · versão {zone.version} · consultar ficha e fundamentos</Link>.</p>
-        <p>A selecção identifica a referência consultada; não confirma o reconhecimento da entidade, actividade autorizada, licença ou acesso a benefícios. Consulte as condições documentadas na ficha e reúna a autorização ou evidência correspondente no dossier.</p>
-        {zone.analysis?.source && <p>Fundamento cadastrado: <a className="underline" href={zone.analysis.source.url}>{zone.analysis.source.diploma || zone.analysis.source.title} {zone.analysis.source.article}</a>. Período cadastrado: {zone.analysis.source.valid_from || 'início por indicar'} a {zone.analysis.source.valid_until || 'sem termo indicado'}. A cobertura do investimento exige correspondência com estas condições.</p>}
-        {zone.analysis?.conditions?.length ? <ul className="list-disc pl-5">{zone.analysis.conditions.map(condition=><li key={condition.id}><strong>{condition.label}</strong>: {condition.knowledge==='documented'?'condição documentada; cumprimento pelo investimento por confirmar':condition.knowledge==='disputed'?'condição com informação divergente':'informação em falta'}. {condition.source_reference && <>Fundamento: {condition.source_reference}.</>} {condition.valid_from && <>Desde {condition.valid_from}.</>} {condition.valid_until && <>Até {condition.valid_until}.</>}</li>)}</ul> : <p>Condições específicas: informação estruturada em falta nesta referência. A ficha e os documentos continuam consultáveis; não se presume cumprimento.</p>}
-        <p role="status">Benefício fiscal deste enquadramento: indeterminado. Não existe neste consumidor uma regra executável ligada ao reconhecimento e condições da zona. No simulador, o IVA disponível corresponde apenas ao cenário geral sem benefício, sobre vendas declaradas compatíveis; não simula o regime especial. O cenário com benefício e o apuramento final estão indisponíveis.</p></>
-        : <p>Enquadramento geral de preparação: sem ZEE, ZFI ou parque seleccionado. Isso não confirma a elegibilidade para uma operação fiscal. O cálculo mantém o âmbito e as exclusões da versão publicada.</p>}
-        <p>Confirmado neste quadro significa apenas dado recuperado do dossier; declarações e referências não são decisões jurídicas. Requisitos específicos não documentados permanecem indeterminados.</p>
-        {snapshot.path && <details><summary>Passos adaptados pelo percurso existente · versão {snapshot.path.definition_version}</summary><ul className="list-disc pl-5">{snapshot.path.steps.map(step=><li key={step.code}>{step.code} — {step.title}: {step.context_review_required?'informação alterada; rever fundamento':step.applicability==='not_needed_for_preparation'?'não aplicável à preparação declarada':step.applicability==='undetermined'?'informação em falta':['completed','approved'].includes(step.state)?'preparação confirmada no percurso; não é decisão fiscal':'potencialmente aplicável'}. {step.reason}</li>)}</ul></details>}
-        {contextId && <Link className="underline" href={`/investimentos/${contextId}/contexto/editar`}>Alterar contexto e comparar impacto antes de guardar</Link>}
-    </section>;
+type Snapshot = {
+    preparation?: Preparation | null;
+    context_revision: number;
+    path?: {
+        definition_version: number;
+        steps: Array<{
+            code: string;
+            title: string;
+            applicability: string;
+            reason: string;
+            state: string;
+            context_review_required?: boolean;
+        }>;
+    };
+    zone?: {
+        title: string;
+        href: string;
+        version: number | string;
+        fields?: Record<string, string>;
+        analysis?: {
+            conditions?: Array<{
+                id: string;
+                label: string;
+                knowledge: string;
+                source_reference?: string;
+                valid_from?: string;
+                valid_until?: string;
+            }>;
+            source?: {
+                title: string;
+                url: string;
+                diploma?: string;
+                article?: string;
+                valid_from?: string;
+                valid_until?: string;
+            } | null;
+        };
+    } | null;
+    fields?: Record<string, string>;
+};
+export function InvestmentContextAssessment({
+    raw,
+    contextId,
+}: {
+    raw: unknown;
+    contextId?: string | null;
+}) {
+    let snapshot: Snapshot | null = null;
+    try {
+        const value = JSON.parse(String(raw ?? ''));
+        if (value.version === 1) snapshot = value;
+    } catch {
+        /* Missing context remains explicit. */
+    }
+    if (!snapshot) return null;
+    const fields = snapshot.fields ?? {};
+    const zone = snapshot.zone;
+    const regime = zone?.fields?.investment_regime ?? fields.investment_regime;
+    const names: Record<string, string> = {
+        zee: 'ZEE',
+        zfi: 'ZFI',
+        industrial_park: 'Parque industrial',
+    };
+    return (
+        <section
+            className="space-y-2 rounded border border-amber-400 p-3"
+            aria-label="Aplicabilidade ao investimento"
+        >
+            <h3 className="font-semibold">
+                Aplicabilidade ao investimento · contexto v
+                {snapshot.context_revision}
+            </h3>
+            <p>
+                Origem do investidor:{' '}
+                {{
+                    national: 'nacional',
+                    foreign: 'estrangeiro',
+                    mixed: 'misto',
+                }[fields.investor_origin] ?? 'informação em falta'}
+                . Residência fiscal declarada:{' '}
+                {fields.tax_residency_country || 'informação em falta'}. Estas
+                condições são distintas; uma não determina a outra.
+            </p>
+            {zone ? (
+                <>
+                    <p>
+                        <strong>
+                            Potencialmente aplicável — análise específica de{' '}
+                            {names[regime ?? ''] ?? 'zona seleccionada'}.
+                        </strong>{' '}
+                        <Link className="underline" href={zone.href}>
+                            {zone.title} · versão {zone.version} · consultar
+                            ficha e fundamentos
+                        </Link>
+                        .
+                    </p>
+                    <p>
+                        A selecção identifica a referência consultada; não
+                        confirma o reconhecimento da entidade, actividade
+                        autorizada, licença ou acesso a benefícios. Consulte as
+                        condições documentadas na ficha e reúna a autorização ou
+                        evidência correspondente no dossier.
+                    </p>
+                    {zone.analysis?.source && (
+                        <p>
+                            Fundamento cadastrado:{' '}
+                            <a
+                                className="underline"
+                                href={zone.analysis.source.url}
+                            >
+                                {zone.analysis.source.diploma ||
+                                    zone.analysis.source.title}{' '}
+                                {zone.analysis.source.article}
+                            </a>
+                            . Período cadastrado:{' '}
+                            {zone.analysis.source.valid_from ||
+                                'início por indicar'}{' '}
+                            a{' '}
+                            {zone.analysis.source.valid_until ||
+                                'sem termo indicado'}
+                            . A cobertura do investimento exige correspondência
+                            com estas condições.
+                        </p>
+                    )}
+                    {zone.analysis?.conditions?.length ? (
+                        <ul className="list-disc pl-5">
+                            {zone.analysis.conditions.map((condition) => (
+                                <li key={condition.id}>
+                                    <strong>{condition.label}</strong>:{' '}
+                                    {condition.knowledge === 'documented'
+                                        ? 'condição documentada; cumprimento pelo investimento por confirmar'
+                                        : condition.knowledge === 'disputed'
+                                          ? 'condição com informação divergente'
+                                          : 'informação em falta'}
+                                    .{' '}
+                                    {condition.source_reference && (
+                                        <>
+                                            Fundamento:{' '}
+                                            {condition.source_reference}.
+                                        </>
+                                    )}{' '}
+                                    {condition.valid_from && (
+                                        <>Desde {condition.valid_from}.</>
+                                    )}{' '}
+                                    {condition.valid_until && (
+                                        <>Até {condition.valid_until}.</>
+                                    )}
+                                </li>
+                            ))}
+                        </ul>
+                    ) : (
+                        <p>
+                            Condições específicas: informação estruturada em
+                            falta nesta referência. A ficha e os documentos
+                            continuam consultáveis; não se presume cumprimento.
+                        </p>
+                    )}
+                    <p role="status">
+                        Benefício fiscal deste enquadramento: indeterminado. Não
+                        existe neste consumidor uma regra executável ligada ao
+                        reconhecimento e condições da zona. No simulador, o IVA
+                        disponível corresponde apenas ao cenário geral sem
+                        benefício, sobre vendas declaradas compatíveis; não
+                        simula o regime especial. O cenário com benefício e o
+                        apuramento final estão indisponíveis.
+                    </p>
+                </>
+            ) : (
+                <p>
+                    Enquadramento geral de preparação: sem ZEE, ZFI ou parque
+                    seleccionado. Isso não confirma a elegibilidade para uma
+                    operação fiscal. O cálculo mantém o âmbito e as exclusões da
+                    versão publicada.
+                </p>
+            )}
+            <p>
+                Confirmado neste quadro significa apenas dado recuperado do
+                dossier; declarações e referências não são decisões jurídicas.
+                Requisitos específicos não documentados permanecem
+                indeterminados.
+            </p>
+            {snapshot.path && (
+                <details>
+                    <summary>
+                        Passos adaptados pelo percurso existente · versão{' '}
+                        {snapshot.path.definition_version}
+                    </summary>
+                    <ul className="list-disc pl-5">
+                        {snapshot.path.steps.map((step) => (
+                            <li key={step.code}>
+                                {step.code} — {step.title}:{' '}
+                                {step.context_review_required
+                                    ? 'informação alterada; rever fundamento'
+                                    : step.applicability ===
+                                        'not_needed_for_preparation'
+                                      ? 'não aplicável à preparação declarada'
+                                      : step.applicability === 'undetermined'
+                                        ? 'informação em falta'
+                                        : ['completed', 'approved'].includes(
+                                                step.state,
+                                            )
+                                          ? 'preparação confirmada no percurso; não é decisão fiscal'
+                                          : 'potencialmente aplicável'}
+                                . {step.reason}
+                            </li>
+                        ))}
+                    </ul>
+                </details>
+            )}
+            {snapshot.preparation?.enabled && (
+                <PreparationSummary
+                    data={snapshot.preparation}
+                    caseId={contextId ?? undefined}
+                />
+            )}
+            {contextId && (
+                <Link
+                    className="underline"
+                    href={`/investimentos/${contextId}/contexto/editar`}
+                >
+                    Alterar contexto e comparar impacto antes de guardar
+                </Link>
+            )}
+        </section>
+    );
 }
@@ -0,0 +1,457 @@
+import { Link } from '@inertiajs/react';
+import { card, input } from '@/pages/investment/shared';
+
+export type PreparationDocument = {
+    document_id: string;
+    file_name: string;
+    status: string;
+    malware_scan_status: string;
+};
+export type Preparation = {
+    version: string;
+    enabled: boolean;
+    mode: string;
+    period_covered: boolean;
+    scope_covered: boolean;
+    reason: string[];
+    missing_fields: string[];
+    missing_labels?: string[];
+    authority: string;
+    next: string;
+    calculation_notice: string;
+    notice: string;
+    source: { url: string; sha256: string };
+    authority_source: { reference: string; url: string };
+    questions: Array<{
+        key: string;
+        label: string;
+        type?: string;
+        options?: Record<string, string>;
+        when?: { field: string; equals: string };
+        source: string;
+        help?: string;
+    }>;
+    requirements: Array<{
+        key: string;
+        label: string;
+        state: string;
+        required: boolean;
+        document_id: string | null;
+        document: PreparationDocument | null;
+        stage: string;
+        reason: string;
+        source: { reference: string; url: string; period: string };
+    }>;
+};
+const states: Record<string, string> = {
+    not_applicable: 'Não aplicável neste contexto',
+    indeterminate: 'Informação em falta para decidir',
+    missing: 'Documento por associar',
+    associated: 'Documento associado — conteúdo por conferir',
+};
+export const preparationMode = (mode: string) =>
+    ({
+        authorization: 'Pedido de autorização',
+        registration: 'Pedido de mero registo',
+        indeterminate: 'Enquadramento por determinar',
+    })[mode] ?? mode;
+
+export function PreparationSummary({
+    data,
+    caseId,
+}: {
+    data: Preparation | null | undefined;
+    caseId?: string;
+}) {
+    if (!data) return null;
+    return (
+        <section
+            id="private-investment-preparation"
+            className={card + ' space-y-3'}
+            aria-label="Preparação adaptada do investimento privado"
+        >
+            <h2 className="text-xl font-bold">
+                Preparar o pedido de investimento privado
+            </h2>
+            {!data.enabled ? (
+                <p>
+                    Use os dados deste dossier para identificar o pedido e os
+                    documentos aplicáveis. A preparação é opcional e não atribui
+                    benefícios.
+                </p>
+            ) : (
+                <>
+                    <p>
+                        <strong>{preparationMode(data.mode)}</strong> · recorte
+                        de 2026 ·{' '}
+                        {data.version.replace(
+                            'private-investment-preparation-',
+                            '',
+                        )}
+                    </p>
+                    <p>{data.next}</p>
+                    {data.missing_fields.length > 0 && (
+                        <p>
+                            Informação em falta:{' '}
+                            {(
+                                data.missing_labels ??
+                                data.missing_fields.map(
+                                    (key) =>
+                                        data.questions?.find(
+                                            (q) => q.key === key,
+                                        )?.label ??
+                                        (
+                                            {
+                                                currency: 'Moeda do projecto',
+                                                expected_start_date:
+                                                    'Data prevista de início',
+                                                entity_stage:
+                                                    'Situação da entidade',
+                                            } as Record<string, string>
+                                        )[key] ??
+                                        key,
+                                )
+                            ).join('; ')}
+                            .
+                        </p>
+                    )}
+                    {!data.period_covered && (
+                        <p>
+                            Este incremento cobre pedidos com início previsto em
+                            2026. Uma data em falta ou fora desse recorte não
+                            permite determinar o pedido por este lote; os
+                            restantes trabalhos do dossier continuam
+                            disponíveis.
+                        </p>
+                    )}
+                    {!data.scope_covered && (
+                        <p>
+                            Declare a actividade efectiva. Prospecção,
+                            pesquisa/produção extractiva e investimento público
+                            ou exclusivamente social/sem fins lucrativos seguem
+                            enquadramentos próprios, fora deste lote.
+                        </p>
+                    )}
+                    {data.reason.map((reason) => (
+                        <p key={reason}>{reason}</p>
+                    ))}
+                    <p>
+                        Encaminhamento indicativo: {data.authority}.{' '}
+                        <a
+                            className="underline"
+                            href={data.authority_source.url}
+                        >
+                            {data.authority_source.reference}
+                        </a>
+                    </p>
+                    <ul className="space-y-3">
+                        {data.requirements
+                            .filter((r) => r.state !== 'not_applicable')
+                            .map((r) => (
+                                <li key={r.key} className="rounded border p-3">
+                                    <strong>{r.label}</strong> —{' '}
+                                    {states[r.state]}.{' '}
+                                    {r.document?.file_name && (
+                                        <span>
+                                            Ficheiro: {r.document.file_name}
+                                            .{' '}
+                                        </span>
+                                    )}
+                                    <p>
+                                        {r.reason}{' '}
+                                        <a
+                                            className="underline"
+                                            href={r.source.url}
+                                        >
+                                            Ver fundamento: {r.source.reference}
+                                        </a>{' '}
+                                        · {r.source.period}.
+                                    </p>
+                                    {caseId && (
+                                        <Link
+                                            className="underline"
+                                            href={`/investimentos/${caseId}/contexto/editar#preparation-documents`}
+                                        >
+                                            Rever dados ou associar documento do
+                                            dossier
+                                        </Link>
+                                    )}
+                                </li>
+                            ))}
+                    </ul>
+                    <details>
+                        <summary>
+                            Exigências que não se aplicam — histórico preservado
+                        </summary>
+                        {data.requirements
+                            .filter((r) => r.state === 'not_applicable')
+                            .map((r) => (
+                                <p key={r.key}>
+                                    {r.label}: {r.reason}{' '}
+                                    {r.document_id && (
+                                        <>
+                                            Associação anterior mantida
+                                            {r.document?.file_name
+                                                ? `: ${r.document.file_name}`
+                                                : ''}
+                                            .
+                                        </>
+                                    )}{' '}
+                                    <a
+                                        className="underline"
+                                        href={r.source.url}
+                                    >
+                                        {r.source.reference}
+                                    </a>
+                                </p>
+                            ))}
+                    </details>
+                    <p>{data.calculation_notice}</p>
+                    <p>{data.notice}</p>
+                </>
+            )}
+            <a className="underline" href={data.source.url}>
+                Consultar o exemplar oficial e os fundamentos
+            </a>
+            {caseId && (
+                <p>
+                    <Link
+                        className="underline"
+                        href={`/investimentos/${caseId}/contexto/editar#preparation-questions`}
+                    >
+                        Completar apenas os dados em falta ou editar declarações
+                    </Link>
+                </p>
+            )}
+        </section>
+    );
+}
+
+export function PreparationEditor({
+    data,
+    fields,
+    changes,
+    documents,
+    links,
+    onChange,
+    onLink,
+    disabled,
+}: {
+    data: Preparation;
+    fields: Record<string, string>;
+    changes: Record<string, string>;
+    documents: PreparationDocument[];
+    links: Record<string, string | null>;
+    onChange: (key: string, value: string) => void;
+    onLink: (key: string, value: string | null) => void;
+    disabled: boolean;
+}) {
+    const values = { ...fields, ...changes };
+    const active = values.investment_preparation === 'yes';
+    const excluded = ['extractive', 'public_nonprofit'].includes(
+        values.investment_activity_scope,
+    );
+    const applicable = (q: Preparation['questions'][number]) =>
+        !q.when || values[q.when.field] === q.when.equals;
+    // Keep a field in place while the user edits it; collapse only recovered answers.
+    const known = (q: Preparation['questions'][number]) =>
+        !!fields[q.key] && fields[q.key] !== 'unknown';
+    const render = (q: Preparation['questions'][number]) => (
+        <label className="grid gap-1" key={q.key} htmlFor={'prep-' + q.key}>
+            {q.label}
+            {q.options ? (
+                <select
+                    id={'prep-' + q.key}
+                    className={input}
+                    disabled={disabled}
+                    value={values[q.key] ?? ''}
+                    onChange={(e) => onChange(q.key, e.target.value)}
+                >
+                    <option value="">Por indicar</option>
+                    {Object.entries(q.options).map(([value, text]) => (
+                        <option key={value} value={value}>
+                            {text}
+                        </option>
+                    ))}
+                </select>
+            ) : (
+                <input
+                    id={'prep-' + q.key}
+                    className={input}
+                    disabled={disabled}
+                    type="text"
+                    inputMode="decimal"
+                    value={values[q.key] ?? ''}
+                    onChange={(e) => onChange(q.key, e.target.value)}
+                />
+            )}
+            <span className="text-sm">
+                {q.help} Fundamento: {q.source}.
+            </span>
+        </label>
+    );
+    const questions = data.questions.filter(
+        (q) =>
+            q.key !== 'investment_preparation' &&
+            applicable(q) &&
+            (!excluded || q.key === 'investment_activity_scope'),
+    );
+    const needed = questions.filter(
+        (q) =>
+            !known(q) &&
+            (!data.enabled ||
+                data.mode !== 'authorization' ||
+                data.missing_fields.includes(q.key)),
+    );
+    return (
+        <section
+            id="preparation-questions"
+            className={card + ' space-y-4'}
+            aria-label="Dados do pedido de investimento privado"
+        >
+            <h2 className="text-xl font-bold">
+                Dados em falta para preparar o pedido
+            </h2>
+            <p>
+                Valores conhecidos são reutilizados. As alterações só são
+                gravadas depois da comparação de impacto. Nacionalidade e
+                residência não determinam a origem do capital nem a modalidade
+                da empresa.
+            </p>
+            {render(data.questions[0])}
+            {active && (
+                <>
+                    {needed.map(render)}
+                    <details>
+                        <summary>
+                            Dados já declarados — consultar ou alterar
+                        </summary>
+                        <div className="space-y-3">
+                            {questions.filter(known).map(render)}
+                        </div>
+                    </details>
+                    <p>
+                        Data, moeda e situação da entidade usam as declarações
+                        acima.{' '}
+                        {data.missing_fields.filter((k) =>
+                            [
+                                'currency',
+                                'expected_start_date',
+                                'entity_stage',
+                            ].includes(k),
+                        ).length > 0 &&
+                            'Complete esses campos em falta antes de comparar.'}
+                    </p>
+                    <div id="preparation-documents" className="space-y-3">
+                        <h3 className="font-bold">
+                            Associar documentos já existentes no dossier
+                        </h3>
+                        <p>
+                            Carregue documentos pelo Balcão Virtual do mesmo
+                            dossier. A associação não aprova o conteúdo nem
+                            substitui a análise do pedido.
+                        </p>
+                        {data.requirements
+                            .filter((r) => r.required)
+                            .map((r) => (
+                                <label className="grid gap-1" key={r.key}>
+                                    {r.label}
+                                    <select
+                                        className={input}
+                                        disabled={disabled}
+                                        value={
+                                            Object.hasOwn(links, r.key)
+                                                ? (links[r.key] ?? '')
+                                                : (r.document_id ?? '')
+                                        }
+                                        onChange={(e) =>
+                                            onLink(
+                                                r.key,
+                                                e.target.value || null,
+                                            )
+                                        }
+                                    >
+                                        <option value="">Por associar</option>
+                                        {documents.map((doc) => (
+                                            <option
+                                                key={doc.document_id}
+                                                value={doc.document_id}
+                                            >
+                                                {doc.file_name} ·{' '}
+                                                {{
+                                                    quarantined:
+                                                        'Em quarentena',
+                                                    active: 'Disponível',
+                                                    deleted: 'Removido',
+                                                }[doc.status] ??
+                                                    'Estado por conferir'}
+                                            </option>
+                                        ))}
+                                    </select>
+                                    <span>
+                                        {r.reason}{' '}
+                                        <a
+                                            className="underline"
+                                            href={r.source.url}
+                                        >
+                                            {r.source.reference}
+                                        </a>
+                                    </span>
+                                </label>
+                            ))}
+                    </div>
+                </>
+            )}
+            <p>
+                Compare o impacto para actualizar o enquadramento, as perguntas
+                e as exigências. Uma exigência que deixe de ser aplicável
+                conserva o documento anterior no histórico.
+            </p>
+        </section>
+    );
+}
+
+export function PreparationImpact({
+    before,
+    after,
+}: {
+    before: Preparation;
+    after: Preparation;
+}) {
+    return (
+        <div
+            className="space-y-2 rounded border border-amber-400 p-3"
+            aria-label="Impacto no pedido de investimento"
+        >
+            <h3 className="font-bold">Impacto no pedido e nos documentos</h3>
+            <p>
+                {preparationMode(before.mode)} → {preparationMode(after.mode)}.
+            </p>
+            <p>Próximo passo: {after.next}.</p>
+            <ul className="list-disc pl-5">
+                {after.requirements
+                    .filter(
+                        (r) =>
+                            before.requirements.find((b) => b.key === r.key)
+                                ?.state !== r.state,
+                    )
+                    .map((r) => (
+                        <li key={r.key}>
+                            {r.label}:{' '}
+                            {
+                                states[
+                                    before.requirements.find(
+                                        (b) => b.key === r.key,
+                                    )?.state ?? 'indeterminate'
+                                ]
+                            }{' '}
+                            → {states[r.state]}.{' '}
+                            {r.document_id && 'Vínculo documental preservado.'}
+                        </li>
+                    ))}
+            </ul>
+            <p>{after.calculation_notice}</p>
+            <PreparationSummary data={after} />
+        </div>
+    );
+}
@@ -57,6 +57,8 @@ export function inheritSimulatorFields<T extends Record<string,unknown>>(draft:T
    if(/^\d{4}-\d{2}-\d{2}$/.test(start)) source.monthly_iva_start=start.slice(0,7);
    else if(/^\d{4}$/.test(String(draft.fiscal_period)) && draft.fiscal_periodicity==='monthly' && /^(0?[1-9]|1[0-2])$/.test(String(draft.fiscal_month))) source.monthly_iva_start=`${draft.fiscal_period}-${String(draft.fiscal_month).padStart(2,'0')}`;
    if(!settingsValid) delete source.monthly_iva_start;
+    // Legacy drafts without a compatible source need no inheritance marker or autosave churn.
+    if (!Object.keys(source).length && !draft.compatible_fields_snapshot) return draft;
    const values={...draft,monthly_iva_start:settings.start ?? ''};
    const patch=inheritCompatibleFields('simulator-compatible-fields',values,source,draft.compatible_fields_snapshot);
    const next:Record<string,unknown>={...draft,...patch.patch,compatible_fields_snapshot:patch.metadata};
@@ -1,3 +1,7 @@
+import type {
+    Preparation,
+    PreparationDocument,
+} from '@/components/private-investment-preparation';
 function csrfToken(): string {
    return decodeURIComponent(
        document.cookie
@@ -56,6 +60,8 @@ export type DossierContext = {
    dependency_hash?: string;
 };
 export type ContextView = {
+    private_investment?: Preparation | null;
+    preparation_documents?: PreparationDocument[];
    simulator_context_revision?: number | null;
    case: { id: string; title: string; version: number };
    context: DossierContext;
@@ -73,6 +79,7 @@ export type ContextView = {
    notice: string;
 };
 export type ContextPlan = {
+    private_investment?: { before: Preparation; after: Preparation } | null;
    preview_hash: string;
    version: number;
    revision: number;
@@ -119,6 +126,20 @@ export async function contextApi<T>(
    return data as T;
 }
 export const contextFieldNames: Record<string, string> = {
+    investment_form: 'Tipo do investimento',
+    investment_preparation: 'Preparação do pedido',
+    investment_activity_scope: 'Natureza da actividade',
+    implementation_mode: 'Modalidade da empresa',
+    capital_origin: 'Origem dos capitais',
+    site_tenure: 'Utilização das instalações',
+    project_concession: 'PPP ou concessão empresarial',
+    significant_implications: 'Implicações significativas',
+    land_extension: 'Extensão de terra',
+    forest_concession: 'Concessão florestal',
+    forest_concession_hectares: 'Área florestal em hectares',
+    total_investment: 'Valor total do investimento',
+    area_required: 'Área de terra requerida',
+    area_unit: 'Unidade da área',
    title: 'Título do investimento',
    territory_id: 'Localização documentada',
    location_source: 'Origem da localização',
@@ -279,15 +279,75 @@ function makeSections(

    if (draft.context_applicability_snapshot) {
        try {
-            const context = JSON.parse(String(draft.context_applicability_snapshot));
+            const context = JSON.parse(
+                String(draft.context_applicability_snapshot),
+            );
            if (context.version === 1) {
                const section = sections.get('sources');
                const zone = context.zone;
-                section?.rows.push({field:'Contexto do investimento',value:`Revisão ${context.context_revision}; ${zone ? `${zone.title}, versão ${zone.version}` : 'sem ZEE, ZFI ou parque seleccionado'}`,origin:'Referência do mesmo dossier no momento da gravação',classification:'Contexto versionado; não é reconhecimento jurídico'});
-                section?.paragraphs.push(zone ? 'Benefício fiscal da zona indeterminado: falta regra executável ligada às condições e reconhecimento. O IVA apresentado é apenas cenário geral sem benefício; não representa o regime especial nem o apuramento final.' : 'Cenário geral de preparação; sem confirmação automática de elegibilidade fiscal.');
-                if(zone?.href) section?.rows.push({field:'Ficha e fundamentos da zona',value:zone.href,origin:`Versão consultada ${zone.version}`,classification:'Referência consultável; condições por verificar'});
+                section?.rows.push({
+                    field: 'Contexto do investimento',
+                    value: `Revisão ${context.context_revision}; ${zone ? `${zone.title}, versão ${zone.version}` : 'sem ZEE, ZFI ou parque seleccionado'}`,
+                    origin: 'Referência do mesmo dossier no momento da gravação',
+                    classification:
+                        'Contexto versionado; não é reconhecimento jurídico',
+                });
+                section?.paragraphs.push(
+                    zone
+                        ? 'Benefício fiscal da zona indeterminado: falta regra executável ligada às condições e reconhecimento. O IVA apresentado é apenas cenário geral sem benefício; não representa o regime especial nem o apuramento final.'
+                        : 'Cenário geral de preparação; sem confirmação automática de elegibilidade fiscal.',
+                );
+                const preparation = context.preparation;
+                if (preparation?.enabled) {
+                    const modes: Record<string, string> = {
+                        authorization: 'Pedido de autorização',
+                        registration: 'Pedido de mero registo',
+                        indeterminate: 'Enquadramento por determinar',
+                    };
+                    section?.rows.push({
+                        field: 'Preparação do investimento privado',
+                        value: modes[preparation.mode] ?? 'Por determinar',
+                        origin: `Contexto congelado v${context.context_revision}; ${preparation.version}`,
+                        classification:
+                            'Declarações e requisitos de preparação; sem aprovação jurídica',
+                    });
+                    section?.paragraphs.push(
+                        preparation.next,
+                        preparation.calculation_notice,
+                        preparation.notice,
+                    );
+                    for (const requirement of preparation.requirements ?? [])
+                        section?.rows.push({
+                            field: requirement.label,
+                            value:
+                                requirement.state === 'not_applicable'
+                                    ? 'Não aplicável; histórico preservado'
+                                    : requirement.state === 'associated'
+                                      ? `Associado: ${requirement.document?.file_name ?? 'documento do dossier'}; conteúdo por conferir`
+                                      : requirement.state === 'missing'
+                                        ? 'Documento por associar'
+                                        : 'Informação em falta para decidir',
+                            origin: `${requirement.reason} ${requirement.source?.reference ?? ''}; ${requirement.source?.url ?? ''}`,
+                            classification:
+                                'Preparação informativa — simulação, sem submissão à Administração',
+                        });
+                }
+                if (zone?.href)
+                    section?.rows.push({
+                        field: 'Ficha e fundamentos da zona',
+                        value: zone.href,
+                        origin: `Versão consultada ${zone.version}`,
+                        classification:
+                            'Referência consultável; condições por verificar',
+                    });
            }
-        } catch { sections.get('sources')?.paragraphs.push('Não foi possível recuperar o contexto guardado; o enquadramento territorial permanece indeterminado.'); }
+        } catch {
+            sections
+                .get('sources')
+                ?.paragraphs.push(
+                    'Não foi possível recuperar o contexto guardado; o enquadramento territorial permanece indeterminado.',
+                );
+        }
    }

    for (const [sectionName, field, value, origin] of rows.slice(1)) {
@@ -359,9 +419,23 @@ function makeSections(
    }

    const finance = sections.get('finance');
-    if (finance && ['fiscal_rule_qa_preview', 'fiscal_rule_published'].includes(String(currentCalculation?.snapshot?.scenario_kind)) && currentCalculation?.snapshot) {
-        for (const [field, value] of fiscalQaRows(currentCalculation.snapshot)) {
-            finance.rows.push({ field, value, origin: 'Snapshot fiscal preservado; sem recálculo', classification: 'Cálculo exacto; ver estado da regra no snapshot; não é saldo a pagar' });
+    if (
+        finance &&
+        ['fiscal_rule_qa_preview', 'fiscal_rule_published'].includes(
+            String(currentCalculation?.snapshot?.scenario_kind),
+        ) &&
+        currentCalculation?.snapshot
+    ) {
+        for (const [field, value] of fiscalQaRows(
+            currentCalculation.snapshot,
+        )) {
+            finance.rows.push({
+                field,
+                value,
+                origin: 'Snapshot fiscal preservado; sem recálculo',
+                classification:
+                    'Cálculo exacto; ver estado da regra no snapshot; não é saldo a pagar',
+            });
        }
    }
    if (finance && currentCalculation) {
@@ -436,13 +510,22 @@ function makeSections(
            },
            {
                field: 'Fórmula e valores usados',
-                value:
-                    ['fiscal_rule_qa_preview', 'fiscal_rule_published'].includes(String(snapshot?.scenario_kind))
-                        ? `Base tributável declarada × taxa cadastrada ÷ 100; cálculo decimal exacto, sem arredondamento. Ver regra e proveniência acima.`
-                        : snapshot && typeof snapshot.formula_version === 'string'
-                        ? `Fórmula ${snapshot.formula_version}; base ${displayValue(snapshot.base, 'não disponível')}; taxa ${displayValue(snapshot.rate_percent, 'não disponível')}%; redução ${displayValue(snapshot.reduction_percent, 'não disponível')}%; moeda ${displayValue(snapshot.currency, 'não indicada')}`
-                        : 'A fórmula não foi identificada no snapshot; ver explicação da execução',
-                origin: ['fiscal_rule_qa_preview', 'fiscal_rule_published'].includes(String(snapshot?.scenario_kind)) ? (snapshot?.scenario_kind === 'fiscal_rule_published' ? 'Versão publicada na admissão; sem validação jurídica da operação' : 'Snapshot QA de regra em rascunho; sem activação ou validação jurídica da operação') : 'Snapshot guardado; sem aplicação de regra legal',
+                value: [
+                    'fiscal_rule_qa_preview',
+                    'fiscal_rule_published',
+                ].includes(String(snapshot?.scenario_kind))
+                    ? `Base tributável declarada × taxa cadastrada ÷ 100; cálculo decimal exacto, sem arredondamento. Ver regra e proveniência acima.`
+                    : snapshot && typeof snapshot.formula_version === 'string'
+                      ? `Fórmula ${snapshot.formula_version}; base ${displayValue(snapshot.base, 'não disponível')}; taxa ${displayValue(snapshot.rate_percent, 'não disponível')}%; redução ${displayValue(snapshot.reduction_percent, 'não disponível')}%; moeda ${displayValue(snapshot.currency, 'não indicada')}`
+                      : 'A fórmula não foi identificada no snapshot; ver explicação da execução',
+                origin: [
+                    'fiscal_rule_qa_preview',
+                    'fiscal_rule_published',
+                ].includes(String(snapshot?.scenario_kind))
+                    ? snapshot?.scenario_kind === 'fiscal_rule_published'
+                        ? 'Versão publicada na admissão; sem validação jurídica da operação'
+                        : 'Snapshot QA de regra em rascunho; sem activação ou validação jurídica da operação'
+                    : 'Snapshot guardado; sem aplicação de regra legal',
                classification: 'Reutilização do resultado existente',
            },
            {
@@ -1,3 +1,7 @@
+import {
+    PreparationEditor,
+    PreparationImpact,
+} from '@/components/private-investment-preparation';
 import { InvestmentContextAssessment } from '@/components/investment-context-assessment';
 import ContextDocuments from '@/components/context-documents';
 import { Link } from '@inertiajs/react';
@@ -36,6 +40,7 @@ export default function ContextEditor({
 }) {
    const navigation = useNavigationContext();
    const [view, setView] = useState(initial);
+    const [preparation, setPreparation] = useState(initial.private_investment);
    const [options, setOptions] = useState(initialOptions);
    const [query, setQuery] = useState('');
    const [changes, setChanges] = useState<Partial<Record<Slot, string>>>(() =>
@@ -49,6 +54,9 @@ export default function ContextEditor({
    const [declarations, setDeclarations] = useState<Record<string, string>>(
        {},
    );
+    const [documentLinks, setDocumentLinks] = useState<
+        Record<string, string | null>
+    >({});
    const [replace, setReplace] = useState<string[]>([]);
    const [plan, setPlan] = useState<ContextPlan | null>(null);
    const [busy, setBusy] = useState(false);
@@ -59,6 +67,32 @@ export default function ContextEditor({
        string,
        unknown
    > | null>(null);
+    const displayValue = (
+        field: string,
+        value: string | null | undefined,
+    ): string => {
+        if (value === null || value === undefined || value === '')
+            return 'não informado';
+        const question = view.private_investment?.questions.find(
+            (q) => q.key === field,
+        );
+        return (
+            question?.options?.[value] ??
+            (
+                {
+                    being_formed: 'Em constituição',
+                    existing: 'Existente',
+                    national: 'Nacional',
+                    foreign: 'Estrangeiro',
+                    mixed: 'Misto',
+                    yes: 'Sim',
+                    no: 'Não',
+                    unknown: 'Por determinar',
+                } as Record<string, string>
+            )[value] ??
+            value
+        );
+    };
    const selected = (slot: Slot) =>
        Object.hasOwn(changes, slot)
            ? (changes[slot] ?? '')
@@ -77,6 +111,7 @@ export default function ContextEditor({
            selection: changes,
            declarations,
            replace_fields: replace,
+            document_links: documentLinks,
        };
        try {
            const result = await contextApi<ContextPlan>(
@@ -85,6 +120,9 @@ export default function ContextEditor({
            );
            setRequestBody(body);
            setPlan(result);
+            setPreparation(
+                result.private_investment?.after ?? view.private_investment,
+            );
        } catch (e) {
            setError(
                e instanceof Error ? e.message : 'Não foi possível comparar.',
@@ -111,9 +149,11 @@ export default function ContextEditor({
                `/investimentos/${view.case.id}/contexto`,
            );
            setView(next);
+            setPreparation(next.private_investment);
            navigation.refresh();
            setChanges({});
            setDeclarations({});
+            setDocumentLinks({});
            setReplace([]);
            setPlan(null);
            setOperation(createOperationKey());
@@ -132,7 +172,10 @@ export default function ContextEditor({
    }
    return (
        <Frame title="Contexto do investimento">
-            <InvestmentContextAssessment contextId={view.case.id} raw={view.prefill.simulator?.context_applicability_snapshot} />
+            <InvestmentContextAssessment
+                contextId={view.case.id}
+                raw={view.prefill.simulator?.context_applicability_snapshot}
+            />
            <ContextDocuments source={view.context.selection.opportunity} />
            <div className="space-y-5 [overflow-wrap:anywhere]">
                <Link
@@ -337,17 +380,107 @@ export default function ContextEditor({
                        Estes campos pertencem ao processo. Alterá-los não muda
                        o cadastro da oportunidade nem o perfil da organização.
                    </p>
-                    <p>Origem do investidor, residência fiscal e constituição da entidade são declarações distintas. A localização não confirma benefícios. A prévia identifica o impacto antes de guardar.</p>
+                    <p>
+                        Origem do investidor, residência fiscal e constituição
+                        da entidade são declarações distintas. A localização não
+                        confirma benefícios. A prévia identifica o impacto antes
+                        de guardar.
+                    </p>
                    {[
-                        ['currency','Moeda do projecto',null],
-                        ['expected_start_date','Data prevista de início',null],
-                        ['investor_origin','Origem do investidor',[['national','Nacional'],['foreign','Estrangeiro'],['mixed','Misto']]],
-                        ['person_type','Tipo de entidade',[['singular','Pessoa singular'],['collective','Pessoa colectiva'],['consortium','Consórcio']]],
-                        ['entity_stage','Situação da entidade',[['existing','Existente'],['being_formed','Em constituição']]],
-                        ['tax_residency_country','País de residência fiscal declarado (ISO de duas letras)',null],
-                    ].map(([key,label,choices]) => <label className="grid gap-1" key={String(key)}>{String(label)}{Array.isArray(choices)
-                        ? <select className={input} value={declarations[String(key)] ?? view.context.fields[String(key)] ?? ''} onChange={e=>{setDeclarations({...declarations,[String(key)]:e.target.value});setPlan(null);}}><option value="">Por indicar</option>{choices.map(([value,text])=><option key={value} value={value}>{text}</option>)}</select>
-                        : <input className={input} type={key==='expected_start_date'?'date':'text'} maxLength={key==='currency'?3:key==='tax_residency_country'?2:10} value={declarations[String(key)] ?? view.context.fields[String(key)] ?? ''} onChange={e=>{setDeclarations({...declarations,[String(key)]:e.target.value});setPlan(null);}} />}</label>)}
+                        ['currency', 'Moeda do projecto', null],
+                        [
+                            'expected_start_date',
+                            'Data prevista de início',
+                            null,
+                        ],
+                        [
+                            'investor_origin',
+                            'Origem do investidor',
+                            [
+                                ['national', 'Nacional'],
+                                ['foreign', 'Estrangeiro'],
+                                ['mixed', 'Misto'],
+                            ],
+                        ],
+                        [
+                            'person_type',
+                            'Tipo de entidade',
+                            [
+                                ['singular', 'Pessoa singular'],
+                                ['collective', 'Pessoa colectiva'],
+                                ['consortium', 'Consórcio'],
+                            ],
+                        ],
+                        [
+                            'entity_stage',
+                            'Situação da entidade',
+                            [
+                                ['existing', 'Existente'],
+                                ['being_formed', 'Em constituição'],
+                            ],
+                        ],
+                        [
+                            'tax_residency_country',
+                            'País de residência fiscal declarado (ISO de duas letras)',
+                            null,
+                        ],
+                    ].map(([key, label, choices]) => (
+                        <label className="grid gap-1" key={String(key)}>
+                            {String(label)}
+                            {Array.isArray(choices) ? (
+                                <select
+                                    className={input}
+                                    value={
+                                        declarations[String(key)] ??
+                                        view.context.fields[String(key)] ??
+                                        ''
+                                    }
+                                    onChange={(e) => {
+                                        setDeclarations({
+                                            ...declarations,
+                                            [String(key)]: e.target.value,
+                                        });
+                                        setPlan(null);
+                                    }}
+                                >
+                                    <option value="">Por indicar</option>
+                                    {choices.map(([value, text]) => (
+                                        <option key={value} value={value}>
+                                            {text}
+                                        </option>
+                                    ))}
+                                </select>
+                            ) : (
+                                <input
+                                    className={input}
+                                    type={
+                                        key === 'expected_start_date'
+                                            ? 'date'
+                                            : 'text'
+                                    }
+                                    maxLength={
+                                        key === 'currency'
+                                            ? 3
+                                            : key === 'tax_residency_country'
+                                              ? 2
+                                              : 10
+                                    }
+                                    value={
+                                        declarations[String(key)] ??
+                                        view.context.fields[String(key)] ??
+                                        ''
+                                    }
+                                    onChange={(e) => {
+                                        setDeclarations({
+                                            ...declarations,
+                                            [String(key)]: e.target.value,
+                                        });
+                                        setPlan(null);
+                                    }}
+                                />
+                            )}
+                        </label>
+                    ))}
                    {['project_title', 'project_summary'].map((k) => (
                        <label className="grid gap-1" key={k}>
                            {contextFieldNames[k]}
@@ -379,18 +512,7 @@ export default function ContextEditor({
                            declarações do utilizador. Autorize somente os
                            campos que pretende substituir pelo cadastro.
                        </p>
-                        <p>Origem do investidor, residência fiscal e constituição da entidade são declarações distintas. A localização não confirma benefícios. A prévia identifica o impacto antes de guardar.</p>
-                    {[
-                        ['currency','Moeda do projecto',null],
-                        ['expected_start_date','Data prevista de início',null],
-                        ['investor_origin','Origem do investidor',[['national','Nacional'],['foreign','Estrangeiro'],['mixed','Misto']]],
-                        ['person_type','Tipo de entidade',[['singular','Pessoa singular'],['collective','Pessoa colectiva'],['consortium','Consórcio']]],
-                        ['entity_stage','Situação da entidade',[['existing','Existente'],['being_formed','Em constituição']]],
-                        ['tax_residency_country','País de residência fiscal declarado (ISO de duas letras)',null],
-                    ].map(([key,label,choices]) => <label className="grid gap-1" key={String(key)}>{String(label)}{Array.isArray(choices)
-                        ? <select className={input} value={declarations[String(key)] ?? view.context.fields[String(key)] ?? ''} onChange={e=>{setDeclarations({...declarations,[String(key)]:e.target.value});setPlan(null);}}><option value="">Por indicar</option>{choices.map(([value,text])=><option key={value} value={value}>{text}</option>)}</select>
-                        : <input className={input} type={key==='expected_start_date'?'date':'text'} maxLength={key==='currency'?3:key==='tax_residency_country'?2:10} value={declarations[String(key)] ?? view.context.fields[String(key)] ?? ''} onChange={e=>{setDeclarations({...declarations,[String(key)]:e.target.value});setPlan(null);}} />}</label>)}
-                    {['project_title', 'project_summary'].map((k) => (
+                        {['project_title', 'project_summary'].map((k) => (
                            <label className="block" key={k}>
                                <input
                                    type="checkbox"
@@ -411,6 +533,30 @@ export default function ContextEditor({
                            </label>
                        ))}
                    </details>
+                    {view.private_investment && (
+                        <PreparationEditor
+                            data={preparation ?? view.private_investment}
+                            fields={view.context.fields}
+                            changes={declarations}
+                            documents={view.preparation_documents ?? []}
+                            links={documentLinks}
+                            disabled={busy || !view.can_write}
+                            onChange={(key, value) => {
+                                setDeclarations({
+                                    ...declarations,
+                                    [key]: value,
+                                });
+                                setPlan(null);
+                            }}
+                            onLink={(key, value) => {
+                                setDocumentLinks({
+                                    ...documentLinks,
+                                    [key]: value,
+                                });
+                                setPlan(null);
+                            }}
+                        />
+                    )}
                    <button
                        className={button}
                        type="button"
@@ -467,10 +613,15 @@ export default function ContextEditor({
                                                        x.field
                                                    ] ?? x.field}
                                                    :{' '}
-                                                    {x.before ??
-                                                        'não informado'}{' '}
+                                                    {displayValue(
+                                                        x.field,
+                                                        x.before,
+                                                    )}{' '}
                                                    →{' '}
-                                                    {x.after ?? 'não informado'}
+                                                    {displayValue(
+                                                        x.field,
+                                                        x.after,
+                                                    )}
                                                </p>
                                            ))}
                                            {Object.values(plan.selection).map(
@@ -530,6 +681,9 @@ export default function ContextEditor({
                                </tbody>
                            </table>
                        </div>
+                        {plan.private_investment && (
+                            <PreparationImpact {...plan.private_investment} />
+                        )}
                        <p>{plan.notice}</p>
                        <div className="flex flex-wrap gap-3">
                            <button
@@ -1,3 +1,7 @@
+import {
+    PreparationSummary,
+    type Preparation,
+} from '@/components/private-investment-preparation';
 import ContextDocuments from '@/components/context-documents';
 import type { DossierContext } from '@/lib/investor-context';
 import FintechInvestment, {
@@ -27,6 +31,7 @@ type Step = {
    source_paragraph: number;
 };
 type Path = {
+    private_investment?: Preparation | null;
    fintech: FintechView | null;
    investment_context: DossierContext | null;
    zone_contexts?: {
@@ -180,6 +185,28 @@ function Stage({ step, path }: { step: Step; path: Path }) {
                    independente.
                </label>
            )}
+            {path.private_investment?.enabled && (
+                <div className="space-y-2">
+                    {path.private_investment.requirements
+                        .filter((r) => r.stage === step.code)
+                        .map((r) => (
+                            <p className="text-sm" key={r.key}>
+                                <strong>{r.label}:</strong>{' '}
+                                {r.state === 'not_applicable'
+                                    ? 'não exigido neste contexto; histórico preservado'
+                                    : r.state === 'associated'
+                                      ? 'documento associado; conteúdo por conferir'
+                                      : r.state === 'missing'
+                                        ? 'documento por associar'
+                                        : 'aplicabilidade por determinar'}
+                                . {r.reason}{' '}
+                                <a className="underline" href={r.source.url}>
+                                    {r.source.reference}
+                                </a>
+                            </p>
+                        ))}
+                </div>
+            )}
            {step.reason && (
                <p className="text-sm">Fundamento: {step.reason}</p>
            )}
@@ -415,6 +442,10 @@ export default function InvestmentPath(path: Path) {
            <ContextDocuments
                source={path.investment_context?.selection.opportunity}
            />
+            <PreparationSummary
+                data={path.private_investment}
+                caseId={path.case.id}
+            />
            {path.investment_context && (
                <section className="space-y-2 rounded border border-emerald-300 bg-emerald-50 p-4">
                    <h2 className="font-semibold">
@@ -0,0 +1,145 @@
+<?php
+
+namespace Tests\Feature;
+
+use App\Models\User;
+use App\Services\PrivateInvestmentPreparation;
+use Illuminate\Foundation\Testing\DatabaseTransactions;
+use Illuminate\Support\Arr;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Str;
+use Tests\TestCase;
+
+class PrivateInvestmentPreparationTest extends TestCase
+{
+    use DatabaseTransactions;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+        $this->withoutVite();
+        $db = DB::selectOne('select current_database() as name, inet_server_port() as port');
+        $this->assertSame('simulator_fiscal_delta_20261021_test', $db->name);
+        $this->assertSame(55441, (int) $db->port);
+        config(['investor-path.enabled' => true, 'investor-path.private_preparation' => true, 'suitecrm.enabled' => false, 'investmoz_ai.enabled' => false]);
+    }
+
+    private function declarations(): array
+    {
+        return ['investment_form' => 'direct', 'investment_preparation' => 'yes', 'investment_activity_scope' => 'general', 'implementation_mode' => 'domestic_entity', 'capital_origin' => 'national', 'site_tenure' => 'lease', 'project_concession' => 'no', 'significant_implications' => 'no', 'land_extension' => 'no', 'forest_concession' => 'no', 'total_investment' => '1000000', 'currency' => 'MZN', 'expected_start_date' => '2026-01-01', 'entity_stage' => 'being_formed'];
+    }
+
+    private function dossier(User $user): string
+    {
+        return $this->actingAs($user)->postJson('/investimentos', ['title' => 'SINTÉTICO C — percurso adaptativo', 'client_key' => (string) Str::uuid(), 'reuse_consent' => true])->assertCreated()->json('id');
+    }
+
+    private function save(string $id, array $declarations, array $links = []): array
+    {
+        $view = $this->getJson('/investimentos/'.$id.'/contexto')->assertOk()->json();
+        $body = ['version' => $view['case']['version'], 'selection' => [], 'declarations' => $declarations, 'document_links' => $links];
+        $plan = $this->postJson('/investimentos/'.$id.'/contexto/previa', $body)->assertOk()->json();
+        // The preview is read-only.
+        $this->getJson('/investimentos/'.$id.'/contexto')->assertJsonPath('context.revision', $view['context']['revision']);
+        $control = [...$body, 'preview_hash' => $plan['preview_hash'], 'operation_key' => (string) Str::uuid(), 'confirm' => true];
+        $this->postJson('/investimentos/'.$id.'/contexto/confirmar', $control)->assertOk();
+        $this->postJson('/investimentos/'.$id.'/contexto/confirmar', $control)->assertOk()->assertJsonPath('replayed', true);
+
+        return $plan;
+    }
+
+    public function test_boundaries_unknown_conditions_and_scope_are_not_silently_presumed(): void
+    {
+        $service = app(PrivateInvestmentPreparation::class);
+        $assess = fn (array $changes = []) => $service->assess(['fields' => [...$this->declarations(), ...$changes]]);
+        $this->assertSame('registration', $assess(['total_investment' => '32000000000'])['mode']);
+        $this->assertSame('authorization', $assess(['total_investment' => '32000000000.0001'])['mode']);
+        $this->assertSame('authorization', $assess(['land_extension' => 'yes', 'area_required' => '10000', 'area_unit' => 'ha'])['mode']);
+        $this->assertSame('registration', $assess(['forest_concession' => 'yes', 'forest_concession_hectares' => '100000'])['mode']);
+        $this->assertSame('authorization', $assess(['forest_concession' => 'yes', 'forest_concession_hectares' => '100000.01'])['mode']);
+        $this->assertSame('indeterminate', $assess(['significant_implications' => 'unknown'])['mode']);
+        $this->assertSame('indeterminate', $assess(['currency' => 'USD'])['mode']);
+        $this->assertSame('indeterminate', $assess(['investment_form' => 'unknown'])['mode']);
+        $this->assertSame('indeterminate', $assess(['investment_form' => 'indirect'])['mode']);
+        $this->assertSame('authorization', $assess(['investment_form' => 'indirect', 'project_concession' => 'yes'])['mode']);
+        foreach ([['investment_activity_scope' => 'extractive'], ['expected_start_date' => '2027-01-01']] as $changes) {
+            $result = $assess($changes);
+            $this->assertSame('indeterminate', $result['mode']);
+            $this->assertFalse(collect($result['requirements'])->contains('required', true));
+        }
+        $this->assertSame('registration', $assess(['investor_origin' => 'foreign', 'tax_residency_country' => 'ZA'])['mode']);
+        $this->assertFalse(collect($assess(['investor_origin' => 'foreign'])['requirements'])->firstWhere('key', 'representation_license')['required']);
+        foreach (['zee', 'zfi'] as $regime) {
+            $zone = $service->assess(['fields' => $this->declarations(), 'selection' => ['park' => ['fields' => ['investment_regime' => $regime]]]]);
+            $this->assertStringContainsString('APIEX', $zone['authority']);
+            $this->assertStringContainsString('condicionado', $zone['authority']);
+            $this->assertArrayNotHasKey('benefit_rate', $zone);
+        }
+        $park = $service->assess(['fields' => $this->declarations(), 'selection' => ['park' => ['fields' => ['investment_regime' => 'industrial_park']]]]);
+        $this->assertSame('Governador da Província', $park['authority']);
+    }
+
+    public function test_context_changes_adapt_requirements_and_preserve_association_history_and_results(): void
+    {
+        $owner = User::factory()->create();
+        $id = $this->dossier($owner);
+        $doc = (string) Str::uuid();
+        DB::table('documents')->insert(['id' => $doc, 'file_name' => 'SINTETICO-C-QA.txt', 'media_type' => 'text/plain', 'storage_key' => 'synthetic-test-no-download', 'sha256' => hash('sha256', 'synthetic'), 'status' => 'quarantined']);
+        DB::table('desk_documents')->insert(['id' => (string) Str::uuid(), 'case_id' => $id, 'document_id' => $doc, 'category' => 'support', 'source_reference' => 'Synthetic QA only', 'linked_by' => $owner->id]);
+        $initial = $this->save($id, $this->declarations(), ['lease' => $doc]);
+        $this->assertSame('registration', $initial['private_investment']['after']['mode']);
+        $view = $this->getJson('/investimentos/'.$id.'/contexto')->json();
+        $this->assertSame('associated', collect($view['private_investment']['requirements'])->firstWhere('key', 'lease')['state']);
+        $this->assertLessThan(20000, mb_strlen($view['prefill']['simulator']['context_applicability_snapshot']));
+        $this->assertArrayNotHasKey('investment_preparation', $view['prefill']['simulator']);
+        $personalKeys = ['person_type', 'investor_origin', 'tax_residency_country', 'fiscal_residency_country', 'entity_stage'];
+        $this->postJson('/api/v1/simulation-drafts', ['context' => $id, 'personal_snapshot' => Arr::only($view['prefill']['simulator'], $personalKeys), 'economic_snapshot' => ['purpose' => 'simulate_only', ...Arr::except($view['prefill']['simulator'], $personalKeys)]], ['Idempotency-Key' => (string) Str::uuid()])->assertCreated();
+        $plan = $this->save($id, ['project_concession' => 'yes', 'implementation_mode' => 'foreign_representation', 'site_tenure' => 'duat']);
+        $this->assertFalse($plan['calculation_inputs_changed'], 'Procedural changes do not change the inputs of the existing IVA calculation.');
+        $this->assertContains('S06', $plan['review_steps']);
+        $after = $plan['private_investment']['after'];
+        $this->assertSame('authorization', $after['mode']);
+        $this->assertSame('Conselho de Ministros', $after['authority']);
+        foreach (['feasibility', 'financial_capacity', 'representation_license', 'name_reservation', 'duat'] as $key) {
+            $this->assertTrue(collect($after['requirements'])->firstWhere('key', $key)['required']);
+        }
+        $lease = collect($after['requirements'])->firstWhere('key', 'lease');
+        $this->assertSame('not_applicable', $lease['state']);
+        $this->assertSame($doc, $lease['document_id']);
+        $this->assertSame(1, DB::table('desk_documents')->where('case_id', $id)->count());
+        $back = $this->save($id, ['project_concession' => 'no', 'implementation_mode' => 'domestic_entity', 'site_tenure' => 'lease', 'entity_stage' => 'existing']);
+        $this->assertTrue(collect($back['private_investment']['after']['requirements'])->firstWhere('key', 'registration')['required']);
+        $this->assertFalse(collect($back['private_investment']['after']['requirements'])->firstWhere('key', 'name_reservation')['required']);
+        $this->assertSame('associated', collect($back['private_investment']['after']['requirements'])->firstWhere('key', 'lease')['state']);
+        $this->assertSame('not_applicable', collect($back['private_investment']['after']['requirements'])->firstWhere('key', 'feasibility')['state']);
+        $events = DB::table('desk_events')->where('case_id', $id)->where('action', 'investment_context_changed')->count();
+        $this->assertSame(3, $events);
+        $this->getJson('/investimentos/'.$id)->assertOk()->assertJsonPath('private_investment.mode', 'registration');
+        $this->actingAs(User::factory()->create())->getJson('/investimentos/'.$id.'/contexto')->assertForbidden();
+        $this->actingAs($owner)->getJson('/investimentos/'.$id.'/contexto')->assertOk()->assertJsonPath('private_investment.mode', 'registration');
+        config(['investor-path.private_preparation' => false]);
+        $this->save($id, ['project_title' => 'Edição independente durante suspensão']);
+        $this->getJson('/investimentos/'.$id.'/contexto')->assertOk()->assertJsonPath('private_investment', null)->assertJsonPath('context.preparation_snapshot.mode', 'registration')->assertJsonPath('context.preparation_documents.lease', $doc);
+    }
+
+    public function test_foreign_document_and_tampered_preview_cannot_be_committed_and_disabled_feature_does_not_accept_writes(): void
+    {
+        $owner = User::factory()->create();
+        $id = $this->dossier($owner);
+        $view = $this->getJson('/investimentos/'.$id.'/contexto')->json();
+        $body = ['version' => $view['case']['version'], 'selection' => [], 'declarations' => $this->declarations()];
+        $this->postJson('/investimentos/'.$id.'/contexto/previa', [...$body, 'document_links' => ['identity' => (string) Str::uuid()]])->assertUnprocessable();
+        $other = $this->dossier($owner);
+        $foreignDocument = (string) Str::uuid();
+        DB::table('documents')->insert(['id' => $foreignDocument, 'file_name' => 'OUTRO-DOSSIER-SINTETICO-QA.txt', 'media_type' => 'text/plain', 'storage_key' => 'synthetic-no-download', 'sha256' => hash('sha256', 'other synthetic'), 'status' => 'quarantined']);
+        DB::table('desk_documents')->insert(['id' => (string) Str::uuid(), 'case_id' => $other, 'document_id' => $foreignDocument, 'category' => 'support', 'source_reference' => 'Synthetic isolated QA', 'linked_by' => $owner->id]);
+        $this->postJson('/investimentos/'.$id.'/contexto/previa', [...$body, 'document_links' => ['identity' => $foreignDocument]])->assertUnprocessable();
+        $plan = $this->postJson('/investimentos/'.$id.'/contexto/previa', $body)->assertOk()->json();
+        $this->postJson('/investimentos/'.$id.'/contexto/confirmar', [...$body, 'declarations' => [...$body['declarations'], 'currency' => 'USD'], 'preview_hash' => $plan['preview_hash'], 'operation_key' => (string) Str::uuid(), 'confirm' => true])->assertConflict();
+        $this->getJson('/investimentos/'.$id.'/contexto')->assertJsonPath('context.revision', 0);
+        config(['investor-path.private_preparation' => false]);
+        $this->postJson('/investimentos/'.$id.'/contexto/previa', $body)->assertConflict();
+        $this->postJson('/investimentos/'.$id.'/contexto/previa', [...$body, 'declarations' => 'invalid'])->assertUnprocessable();
+        $this->getJson('/investimentos/'.$id.'/contexto')->assertOk()->assertJsonPath('private_investment', null);
+    }
+}
@@ -1,5 +1,11 @@
 import { createProjectDossierReport } from '../../resources/js/lib/project-dossier-report.ts';
 import assert from 'node:assert/strict';
+
+test('legacy draft without a compatible source keeps its shape and identity',()=>{
+ const legacy={activity_id:'legacy-activity',infrastructure_needs:['energia']};
+ assert.equal(inheritSimulatorFields(legacy),legacy);
+ assert.equal(Object.hasOwn(inheritSimulatorFields(legacy),'compatible_fields_snapshot'),false);
+});
 import test from 'node:test';
 import { inheritCompatibleFields, inheritSimulatorFields } from '../../resources/js/lib/context-inheritance.ts';
 import { serializeBusinessPlanSnapshot } from '../../resources/js/lib/business-financial-plan.ts';
@@ -0,0 +1,15 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { createProjectDossierReport } from '../../resources/js/lib/project-dossier-report.ts';
+
+test('report retains the frozen preparation and an inactive historical document without claiming approval or a tax benefit', () => {
+    const preparation = {enabled:true,version:'private-investment-preparation-2026-v1',mode:'registration',next:'Preparar documentos do pedido de mero registo',calculation_notice:'O regime procedimental não altera a taxa de IVA.',notice:'Sem submissão à Administração.',requirements:[{label:'Estudo de viabilidade',state:'not_applicable',document_id:'synthetic-old-document',source:{reference:'R14',url:'https://example.test/official-source'},reason:'Apenas para autorização.'}]};
+    const snapshot = JSON.stringify({version:1,context_revision:3,preparation});
+    const report = createProjectDossierReport({context_applicability_snapshot:snapshot},{selectedSections:new Set(['sources'])});
+    const sources=report.sections.find(s=>s.id==='sources');
+    assert.equal(sources.rows.find(r=>r.field==='Preparação do investimento privado').value,'Pedido de mero registo');
+    assert.match(sources.rows.find(r=>r.field==='Estudo de viabilidade').value,/Não aplicável; histórico preservado/);
+    assert.ok(sources.paragraphs.includes(preparation.calculation_notice));
+    preparation.mode='authorization';
+    assert.equal(JSON.parse(snapshot).preparation.mode,'registration');
+});
Author	SHA1	Message	Date
nala	5f4eb5cfaa	Record authorized adaptive path deployment and enabled destination state	2026-10-22 10:18:38 +02:00
nala	042ffbde44	Preserve legacy draft shape when no compatible context is inherited tests / ci (push) Canceled after 0s Details	2026-10-22 10:14:46 +02:00
nala	064296e1fb	Record current v4 report proof and adaptive path integration dependencies tests / ci (push) Canceled after 0s Details	2026-10-22 10:06:08 +02:00
nala	a1fbda06ad	Wire grounded private investment preparation into QA dossier path	2026-10-22 10:00:23 +02:00
nala	52fbb1468a	Close context increment review and ground first adaptive investment path	2026-10-22 09:25:14 +02:00