ifuri-validator-agent · Oct 7, 2026 · Oct 7, 2026 · Oct 7, 2026
diff --git a/docs/README.md b/docs/README.md
@@ -210,3 +210,10 @@ pytest
 <!-- code2docs:end -->
 
 - [Aktualizacja zależności wewnętrznych](information/internal-dependencies.md) — lockfile, testy i codzienny audyt.
+
+## Przewodniki operacyjne
+
+- [Logi operacyjne semcod/redup](SERVICE/LOGGING_GUIDE.md)
+- [Dokumentacja operacyjna semcod/redup](SERVICE/DOCUMENTATION_GUIDE.md)
+- [Ponowne wykorzystanie kodu semcod/redup](SERVICE/REUSE_GUIDE.md)
+- [Podręcznik operatora semcod/redup](SERVICE/USER_MANUAL.md)
diff --git a/docs/SERVICE/DOCUMENTATION_GUIDE.md b/docs/SERVICE/DOCUMENTATION_GUIDE.md
@@ -0,0 +1,47 @@
+---
+{
+  "schema": "wellmanifest.docs/document/v2",
+  "id": "documentation-guide",
+  "kind": "service",
+  "version": 1,
+  "title": "Dokumentacja operacyjna semcod/redup",
+  "status": "proposed",
+  "owner": "semcod/redup",
+  "scope": "repository",
+  "updated": "2026-10-07",
+  "source_revision": "17ab187b37df23c66627b733c2b9c6f507138bf7",
+  "priority": "P2",
+  "evidence": [
+    "repo://semcod/redup/pyproject.toml",
+    "repo://semcod/redup/VERSION",
+    "repo://semcod/redup/src/redup/__main__.py",
+    "repo://semcod/redup/src/redup/mcp/server.py"
+  ]
+}
+---
+
+# Dokumentacja operacyjna semcod/redup
+
+<!-- docs:section summary -->
+## Cel i rezultat
+
+Porządkuje cztery przewodniki i zakres ich odbioru w repozytorium właściciela.
+
+<!-- docs:section details -->
+## Zakres i rozwiązanie
+
+Repozytorium `semcod/redup`, obserwowana wersja `0.4.48`, baza `17ab187b37df23c66627b733c2b9c6f507138bf7`. Źródła: [pyproject.toml](../../pyproject.toml), [VERSION](../../VERSION), [src/redup/__main__.py](../../src/redup/__main__.py), [src/redup/mcp/server.py](../../src/redup/mcp/server.py).
+
+Używany pin docs: `0714f71462202788e6b775ed145e9e61a7d5c366`. Indeksem jest [docs/README.md](../README.md). Nowe dokumenty mają profil kompaktowy v2, cztery sekcje i najwyżej 120 linii oraz 600 słów. Aktualizuj temat i wersję istniejącego dokumentu zamiast tworzyć kopię.
+
+[Logi](LOGGING_GUIDE.md), [reuse](REUSE_GUIDE.md), [podręcznik](USER_MANUAL.md).
+
+<!-- docs:section validation -->
+## Weryfikacja
+
+Kontrola przygotowania wybiera właściciela i ścieżkę. Po zapisaniu i dodaniu dokumentu do Git kontrola `--complete` wymaga osobnego receiptu przygotowania, jawnego rezultatu i zaufanej bazy. Wyniki są rejestrowane poza Git.
+
+<!-- docs:section risks -->
+## Ryzyka i następny krok
+
+Walidacja formatu nie potwierdza prawdziwości opisu ani publikacji. Zachowaj dotychczasowy pin; jego zmiana wymaga przyjęcia nowej rewizji, a merge niezależnego Validatora.
diff --git a/docs/SERVICE/LOGGING_GUIDE.md b/docs/SERVICE/LOGGING_GUIDE.md
@@ -0,0 +1,47 @@
+---
+{
+  "schema": "wellmanifest.docs/document/v2",
+  "id": "logging-guide",
+  "kind": "service",
+  "version": 1,
+  "title": "Logi operacyjne semcod/redup",
+  "status": "proposed",
+  "owner": "semcod/redup",
+  "scope": "repository",
+  "updated": "2026-10-07",
+  "source_revision": "17ab187b37df23c66627b733c2b9c6f507138bf7",
+  "priority": "P2",
+  "evidence": [
+    "repo://semcod/redup/pyproject.toml",
+    "repo://semcod/redup/VERSION",
+    "repo://semcod/redup/src/redup/__main__.py",
+    "repo://semcod/redup/src/redup/mcp/server.py"
+  ]
+}
+---
+
+# Logi operacyjne semcod/redup
+
+<!-- docs:section summary -->
+## Cel i rezultat
+
+Wskazuje granicę między zdarzeniem, wynikiem walidacji i dowodem wykonania w tym projekcie.
+
+<!-- docs:section details -->
+## Zakres i rozwiązanie
+
+Repozytorium `semcod/redup`, obserwowana wersja `0.4.48`, baza `17ab187b37df23c66627b733c2b9c6f507138bf7`. Źródła: [pyproject.toml](../../pyproject.toml), [VERSION](../../VERSION), [src/redup/__main__.py](../../src/redup/__main__.py), [src/redup/mcp/server.py](../../src/redup/mcp/server.py).
+
+W indeksie Git wykryto 8 plików w logs/, errors/ lub error/. Sama obecność plików nie dowodzi instrumentacji runtime.
+
+Zdarzenia należy wiązać z procesem, aktorem, korelacją i digestami wejścia oraz dowodu. Kwit planu nie potwierdza wykonania. Nie zapisuj tokenów, haseł ani surowych danych operatora.
+
+<!-- docs:section validation -->
+## Weryfikacja
+
+Sprawdź rzeczywisty emiter i katalog kodów błędów, następnie uruchom przypięty `wellmanifest/logs/standard/logs_check.py validate --root .`. Tej integracji runtime nie wykonywano w ramach dokumentowania.
+
+<!-- docs:section risks -->
+## Ryzyka i następny krok
+
+Adopcja logs wymaga osobnego kontraktu oraz testu emitera. Przed ponowieniem mutacji sprawdź jej wcześniejszy wynik; nie traktuj timeoutu jako dowodu braku efektu.
diff --git a/docs/SERVICE/REUSE_GUIDE.md b/docs/SERVICE/REUSE_GUIDE.md
@@ -0,0 +1,47 @@
+---
+{
+  "schema": "wellmanifest.docs/document/v2",
+  "id": "reuse-guide",
+  "kind": "service",
+  "version": 1,
+  "title": "Ponowne wykorzystanie kodu semcod/redup",
+  "status": "proposed",
+  "owner": "semcod/redup",
+  "scope": "repository",
+  "updated": "2026-10-07",
+  "source_revision": "17ab187b37df23c66627b733c2b9c6f507138bf7",
+  "priority": "P2",
+  "evidence": [
+    "repo://semcod/redup/pyproject.toml",
+    "repo://semcod/redup/VERSION",
+    "repo://semcod/redup/src/redup/__main__.py",
+    "repo://semcod/redup/src/redup/mcp/server.py"
+  ]
+}
+---
+
+# Ponowne wykorzystanie kodu semcod/redup
+
+<!-- docs:section summary -->
+## Cel i rezultat
+
+Określa kolejność odkrywania i oceny istniejących modułów przed nową implementacją.
+
+<!-- docs:section details -->
+## Zakres i rozwiązanie
+
+Repozytorium `semcod/redup`, obserwowana wersja `0.4.48`, baza `17ab187b37df23c66627b733c2b9c6f507138bf7`. Źródła: [pyproject.toml](../../pyproject.toml), [VERSION](../../VERSION), [src/redup/__main__.py](../../src/redup/__main__.py), [src/redup/mcp/server.py](../../src/redup/mcp/server.py).
+
+Obserwowano 0 istniejących artefaktów związanych z reuse. Wykorzystaj narzędzia `semcod/search`, `semcod/redup` oraz istniejące pakiety, zachowując ich kontrakty i licencje.
+
+Sekwencja: DISCOVER → COMPARE → EXTRACT → CONSUME → VERIFY. Szukaj po dokładnym identyfikatorze `semcod/redup`, by uniknąć pomylenia projektów o tej samej nazwie. Nie uruchamiaj automatycznej ekstrakcji na podstawie samego podobieństwa.
+
+<!-- docs:section validation -->
+## Weryfikacja
+
+Najpierw `subactor-search ask "semcod/redup" --json`, potem `redup scan .`. Zweryfikuj rzeczywiste wyniki oraz testy konsumentów. Szkic planu istnieje w zewnętrznym zestawie PLF-012; skanów tego repozytorium nie deklarujemy jako wykonanych.
+
+<!-- docs:section risks -->
+## Ryzyka i następny krok
+
+Wspólny kod może mieć różnych właścicieli, semantykę i uprawnienia. Ekstrakcja wymaga osobnego ticketu i jawnej granicy API; dokumentacja nie przekazuje prawa do modyfikacji innych repozytoriów.
diff --git a/docs/SERVICE/USER_MANUAL.md b/docs/SERVICE/USER_MANUAL.md
@@ -0,0 +1,69 @@
+---
+{
+  "schema": "wellmanifest.docs/document/v2",
+  "id": "user-manual",
+  "kind": "service",
+  "version": 4,
+  "title": "Podręcznik operatora semcod/redup",
+  "status": "proposed",
+  "owner": "semcod/redup",
+  "scope": "repository",
+  "updated": "2026-10-07",
+  "source_revision": "17ab187b37df23c66627b733c2b9c6f507138bf7",
+  "priority": "P2",
+  "evidence": [
+    "repo://semcod/redup/pyproject.toml",
+    "repo://semcod/redup/VERSION",
+    "repo://semcod/redup/src/redup/__main__.py",
+    "repo://semcod/redup/src/redup/mcp/server.py",
+    "repo://semcod/redup/README.md"
+  ]
+}
+---
+
+# Podręcznik operatora semcod/redup
+
+<!-- docs:section summary -->
+## Cel i rezultat
+
+Udostępnia operatorowi źródła konfiguracji i odróżnia udokumentowany interfejs od nieweryfikowanych możliwości.
+
+<!-- docs:section details -->
+## Zakres i rozwiązanie
+
+Repozytorium `semcod/redup`, obserwowana wersja `0.4.48`, baza `17ab187b37df23c66627b733c2b9c6f507138bf7`. Źródła: [pyproject.toml](../../pyproject.toml), [VERSION](../../VERSION), [src/redup/__main__.py](../../src/redup/__main__.py), [src/redup/mcp/server.py](../../src/redup/mcp/server.py).
+
+Model roboczy: [usermanual-observation.json](../standards/usermanual-observation.json). Zawiera 0 odczytów zmiennych środowiska, 0 literalnych tras GET i 0 literalnych tras mutacji z ograniczonej próbki kodu Python.
+
+Przeczytaj README i źródła przed uruchomieniem. Prefiksy routerów, autoryzacja, wymagane wartości konfiguracji i idempotencja potrzebują przeglądu. Nie ustalono DSL, mapy UI ani aktywnego cyfrowego bliźniaka; puste tablice oznaczają brak dowodu w próbce.
+
+## Udokumentowana obsługa
+
+CLI analizy duplikacji ma polecenia scan, compare, diff, check, config i info. README opisuje też serwer MCP uruchamiany jako `redup-mcp`; używa on stdio, a diagnostyka trafia na stderr. Pierwsze wywołanie agentowe: find_duplicates, następnie analiza grup i testy konsumentów przed refaktoryzacją.
+
+Źródło: [README](../../README.md) w podanej bazie. Powyższe instrukcje sprawdzono w źródle; nie wykonano opisanych uruchomień ani zmian usług.
+
+## Deklaracje wejść CLI
+
+- `redup` — python-entrypoint, źródło `pyproject.toml`.
+- `redup-mcp` — python-entrypoint, źródło `pyproject.toml`.
+
+Deklaracje potwierdzono w obiektach Git, bez uruchamiania poleceń. Dostępność programu, argumenty i efekty wymagają osobnej kontroli; nie kopiowano treści skryptów npm ani poświadczeń.
+
+## Pierwszy raport duplikacji
+
+1. Przygotuj katalog badanego projektu i sprawdź `redup scan --help`.
+2. Wykonaj `redup scan ./project --format json --output /tmp/redup-report.json`.
+3. Otwórz raport, wybierz grupę duplikatów i sprawdź testy obu konsumentów przed wspólną refaktoryzacją. Polecenie zapisuje raport we wskazanym pliku; nie refaktoryzuje kodu.
+
+Interfejs i opcje potwierdzają [implementacja CLI](../../src/redup/cli_app/main.py) i [README](../../README.md). To procedura na podstawie źródła; skan projektu operatora nie był uruchamiany w ramach tej dostawy.
+
+<!-- docs:section validation -->
+## Weryfikacja
+
+Model przechodzi schemat wellmanifest.usermanual/v1. Zbadano najwyżej osiem modułów Python; pozostałe języki i działające API nie były testowane. Pełny podręcznik wymaga analizy wszystkich publicznych interfejsów oraz testu driftu CQRS.
+
+<!-- docs:section risks -->
+## Ryzyka i następny krok
+
+To podręcznik roboczy, a nie potwierdzenie gotowości produkcyjnej. Po weryfikacji modelu przygotuj normatywną publikację doc/USER_MANUAL.md i doc/usermanual.json w osobnym przyjętym zakresie. Nie ponawiaj mutacji bez dowodu idempotencji.
diff --git a/docs/standards/usermanual-observation.json b/docs/standards/usermanual-observation.json
@@ -0,0 +1,115 @@
+{
+  "schema": "wellmanifest.usermanual/v1",
+  "id": "semcod/redup",
+  "name": "redup",
+  "version": "0.4.48",
+  "summary": "Adoption draft for semcod/redup, based on immutable committed source. Coverage is bounded and requires operator review.",
+  "env_variables": [],
+  "queries": [],
+  "commands": [],
+  "processes": [],
+  "dsl": {
+    "grammar": "No DSL contract inferred by this bounded observation.",
+    "capitalize_tokens": [],
+    "examples": []
+  },
+  "ui_components": [],
+  "digital_twin": {
+    "twin_urn": "urn:twin:proposal:fleet:514b411f835cbd0e:v1",
+    "role": "Proposed documentation reviewer; no implemented twin or execution authority claimed.",
+    "capabilities": [],
+    "autonomous_routines": []
+  },
+  "status": "draft",
+  "source_revision": "17ab187b37df23c66627b733c2b9c6f507138bf7",
+  "source_evidence": [
+    {
+      "path": "pyproject.toml",
+      "sha256": "31f2922e6d05a9109d5a69bc1a636e0055f38656fc1da655639e7c6618cd0c34"
+    },
+    {
+      "path": "VERSION",
+      "sha256": "adf4ddde62ee2f5f7a3c3aa5476f54c7c0535b8db9b84eeb597e716fa2b65584"
+    },
+    {
+      "path": "src/redup/__main__.py",
+      "sha256": "615ae9c1f7a633ab6083a137cd546a636c4827f13eb662872a9cb7dd14d0d588"
+    },
+    {
+      "path": "src/redup/mcp/server.py",
+      "sha256": "781b83f6e45735056271e9913d02d69bd2d122d80203f4652641d619c45747a1"
+    },
+    {
+      "path": "src/redup/mcp_server.py",
+      "sha256": "c1eada8d3b923af3734f8a5feab7eaeb447bd362ac2389c9fa31891a15564391"
+    },
+    {
+      "path": "src/redup/cli_app/main.py",
+      "sha256": "bda3ca26d14266594e403170bc91fc90fff87207e0720c502889b378e18d9d31"
+    },
+    {
+      "path": "src/redup/cli_app/__init__.py",
+      "sha256": "88f486ed963ddab4e62f0cd6f4210324b1a1545cbb13e9ba11ce3d6e544976dd"
+    },
+    {
+      "path": "src/redup/mcp_server_clean.py",
+      "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
+    },
+    {
+      "path": "src/redup/cli_app/scan_helpers.py",
+      "sha256": "d4211f6e1e18302121d8aff11f4d2226fab7985c21b18f8515787ea34ec23588"
+    },
+    {
+      "path": "src/redup/cli_app/output_writer.py",
+      "sha256": "3b816c80fc7ce551ded9dc025c8dd5c3de09ef74c0f5aa88ab55a70cdbd8485b"
+    }
+  ],
+  "coverage": {
+    "python_files_observed": [
+      "src/redup/__main__.py",
+      "src/redup/mcp/server.py",
+      "src/redup/mcp_server.py",
+      "src/redup/cli_app/main.py",
+      "src/redup/cli_app/__init__.py",
+      "src/redup/mcp_server_clean.py",
+      "src/redup/cli_app/scan_helpers.py",
+      "src/redup/cli_app/output_writer.py"
+    ],
+    "python_files_total": 102,
+    "complete": false,
+    "other_languages_observed": false
+  },
+  "not_applicable_or_unverified": [
+    "No process URI registration or UI component mapping asserted.",
+    "Empty arrays mean not established by this observation, not absence of the feature.",
+    "Documentation schema validity is not endpoint drift verification or deployed adoption."
+  ],
+  "declared_cli_entrypoints": [
+    {
+      "kind": "python-entrypoint",
+      "name": "redup",
+      "declared_target": "redup.cli_app.main:app",
+      "manifest": "pyproject.toml",
+      "manifest_field": "project.scripts.redup",
+      "invocation": "redup",
+      "execution_status": "not-executed",
+      "effects": "unverified"
+    },
+    {
+      "kind": "python-entrypoint",
+      "name": "redup-mcp",
+      "declared_target": "redup.mcp_server:run_server",
+      "manifest": "pyproject.toml",
+      "manifest_field": "project.scripts.redup-mcp",
+      "invocation": "redup-mcp",
+      "execution_status": "not-executed",
+      "effects": "unverified"
+    }
+  ],
+  "entrypoint_observation": {
+    "source": "artifact://fleet-operational-guides-20261007/bundle/semcod--redup--4169dff0/entrypoints.json",
+    "runtime_verified": false,
+    "effects_verified": false,
+    "declarations_count": 2
+  }
+}
diff --git a/project/TICKETS.md b/project/TICKETS.md
@@ -2,3 +2,16 @@
 
 Legacy ticket records remain in project/ticket-003 through ticket-007.
 New identities are reserved exclusively by project/new-ticket.sh.
+
+<!-- AUTO:TICKET_INDEX:START -->
+| Ticket ID | Spec | Preprompt | Human input | Agent plans | Agent logs | Changelog |
+| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
+| **ticket-003** | [`README.md`](./ticket-003/README.md) | - | - | - | - | - |
+| **ticket-004** | [`README.md`](./ticket-004/README.md) | - | - | - | - | - |
+| **ticket-005** | [`README.md`](./ticket-005/README.md) | - | - | - | - | - |
+| **ticket-006** | [`README.md`](./ticket-006/README.md) | - | - | - | - | - |
+| **ticket-007** | [`README.md`](./ticket-007/README.md) | - | - | - | - | - |
+| **ticket-008** | [`README.md`](./ticket-008/README.md) | - | - | - | - | - |
+| **ticket-009** | [`README.md`](./ticket-009/README.md) | - | - | - | - | - |
+| **ticket-010** | [`README.md`](./ticket-010/README.md) | - | - | - | - | - |
+<!-- AUTO:TICKET_INDEX:END -->
diff --git a/project/ticket-012/README.md b/project/ticket-012/README.md
@@ -0,0 +1,33 @@
+# ticket-012: Operational guides
+
+- **Owner**: agent:codex
+- **Status**: IN_PROGRESS
+- **Workflow state**: VALIDATION
+
+## Goal and scope
+
+SESSION_EXECUTION_AUTHORIZATION: user requested logs/docs/reuse/usermanual
+for every repository under the registered Git workspace. This ticket owns only the
+documentation paths in intent.json; fleet tracking is PLF-012.
+Four compact guides and a bounded machine-readable manual describe semcod/redup.
+Runtime instrumentation, live API checks and publication are separate.
+
+## Acceptance criteria
+
+- [x] AC-01: Each guide passes explicit docs completion with a preparation receipt.
+- [x] AC-02: Machine-readable model passes the usermanual schema.
+- [x] AC-03: Scope and managed governance gates pass; retain any exact blocker.
+
+## Evidence and next action
+
+Base: 17ab187b37df23c66627b733c2b9c6f507138bf7. Own allocation lease: .subactor/leases/ticket-012--operational-guides.json (primary checkout).
+Revision 1, fence 1.
+Evidence: artifact://fleet-operational-guides-20261007.
+Next: capture and verify the adopted continuity record for the local documentation commit.
+Publication remains a separate protected delivery effect.
+The guides have passed explicit completion and were committed locally.
+No pushed, merged or deployed result is asserted here.
+
+## Continued publication scope
+
+The user explicitly requested continuation, tests and merging. SESSION_EXECUTION_AUTHORIZATION covers protected publication of this ticket through OneDev and the independent Validator, after exact-head checks. Add the source-bound first-use procedure to the operator guide. Runtime deployment and normative full manual adoption remain separate. Prior allocator-only lease and local HEAD are preserved in external handoff evidence; protected controller ownership is freshly acquired without takeover.