agentic-project-kit 1.0.2__tar.gz → 1.0.3__tar.gz

{agentic_project_kit-1.0.2 → agentic_project_kit-1.0.3}/.agentic/dpa/acceptance/current_handoff_operational_state.json

@@ -1,9 +1,9 @@
 {
-  "accepted_at": "2026-08-20T17:12:48.430547+00:00",
+  "accepted_at": "2026-08-23T18:18:15.354305+00:00",
   "accepted_gate_result": "pass",
   "accepted_gate_set_id": "dpa-current-handoff-minimal-gate-set-v1",
   "accepted_lifecycle_outcome": "accepted",
-  "branch": "docs/post-pr2113-handoff-refresh",
+  "branch": "docs/post-pr2125-handoff-refresh",
   "claims": {
     "generated_outputs_manually_patched": false,
     "kit_conformance_claimed": false,
@@ -17,17 +17,17 @@
   },
   "schema_version": 1,
   "source": {
-    "fingerprint": "4da0c79f150af077ca9a1a0deaa83fe7b37c4e48f68549ae18a33af8e2778153",
+    "fingerprint": "4999a6a8a547b1c59adc9ec6b0bb0aa54b4303c67b6aca79e7db0b9957d9250d",
     "path": ".agentic/operational_handoff_state.yaml"
   },
   "status": "accepted",
   "target": {
-    "complete_target_fingerprint": "de76a3ad26e82b0c6073182fe8d5f06e8c18986dcc8ac4b764c004b28fa595ac",
+    "complete_target_fingerprint": "b12f0f59739275a9ce05452b2ac640e452dbe3060b4535f0c1047aa8f2222b9e",
     "path": "docs/handoff/CURRENT_HANDOFF.md",
-    "payload_fingerprint": "de76a3ad26e82b0c6073182fe8d5f06e8c18986dcc8ac4b764c004b28fa595ac",
-    "pre_write_fingerprint": "1fcb9a1ba437f85ce7311e741d5739959690131bbe49fd39165ae3372650eb8f"
+    "payload_fingerprint": "b12f0f59739275a9ce05452b2ac640e452dbe3060b4535f0c1047aa8f2222b9e",
+    "pre_write_fingerprint": "fbdce863722f6032253d37786f54383e2e2692968b0a1c7c909494851dc4b9fd"
   },
   "target_scope": "CURRENT_HANDOFF_OPERATIONAL_STATE_BLOCK",
-  "validation_ref": "8cd7a5cfee2d7176797fd6335492d0c890de9999",
+  "validation_ref": "41e6e9ae6d3b8b1fdb8b0d7f00bfaf33fb59a1e5",
   "writer_id": "WRT-CH-001"
 }

{agentic_project_kit-1.0.2 → agentic_project_kit-1.0.3}/.agentic/handoff_state.yaml

@@ -10,8 +10,8 @@ repo:
   default_branch: main
 safe_state:
   branch: main
-  commit: 8cd7a5cf
-  commit_subject: Prepare v1.0.2 safety release (#2113)
+  commit: 41e6e9ae
+  commit_subject: Record onboarding O0 baseline (#2125)
   semantics: last_substantive_work_state
   working_tree_expected_clean: true
   administrative_refresh_prs:
@@ -433,7 +433,7 @@ handoff_maintenance:
   no_redundant_rules: true
   no_contradictory_rules: true
   remove_obsolete_rules_when_system_changes: true
-  latest_successor_prompt: docs/reports/terminal/post-pr2113-successor-chat-handoff.md
+  latest_successor_prompt: docs/reports/terminal/post-pr2125-successor-chat-handoff.md
   first_instruction: 'Review PR #1436 and the refreshed successor handoff package
     for the release command authority planning slice. After merge, start from fresh
     main and use centralized historical record docs/planning/PROJECT_DIRECTION.yaml#release-command-authority-slice
@@ -444,6 +444,6 @@ next_step:
     main and use centralized historical record docs/planning/PROJECT_DIRECTION.yaml#release-command-authority-slice
     before DOI, legacy-doc, absolute-path, or GUI work.'
 evidence:
-  latest_successor_prompt: docs/reports/terminal/post-pr2113-successor-chat-handoff.md
+  latest_successor_prompt: docs/reports/terminal/post-pr2125-successor-chat-handoff.md
 # preservation-anchor: use d for log-backed PASS and f for log-backed FAIL
 # preservation-anchor: nested shell/Python quote layers

{agentic_project_kit-1.0.2 → agentic_project_kit-1.0.3}/.agentic/operational_handoff_state.yaml

@@ -1,12 +1,12 @@
 schema_version: 1
 current_head:
-  full: 8cd7a5cfee2d7176797fd6335492d0c890de9999
-  short: 8cd7a5cf
-  subject: Prepare v1.0.2 safety release (#2113)
+  full: 41e6e9ae6d3b8b1fdb8b0d7f00bfaf33fb59a1e5
+  short: 41e6e9ae
+  subject: Record onboarding O0 baseline (#2125)
 last_substantive_work_state:
-  full: 8cd7a5cfee2d7176797fd6335492d0c890de9999
-  short: 8cd7a5cf
-  subject: Prepare v1.0.2 safety release (#2113)
+  full: 41e6e9ae6d3b8b1fdb8b0d7f00bfaf33fb59a1e5
+  short: 41e6e9ae
+  subject: Record onboarding O0 baseline (#2125)
 administrative_context:
   - "PR #1257 hardened admin-refresh-pr and pr-complete recovery."
   - "PR #1255 added generated operational handoff block replacement."

{agentic_project_kit-1.0.2 → agentic_project_kit-1.0.3}/AGENTS.md

@@ -12,7 +12,7 @@ rule_source_boundary: pointer_not_duplicate_rule_book
 # Agent Instructions
 
 <!-- command-manifest-entrypoint:start -->
-MANDATORY FIRST READ: docs/reference/agentic-kit-commands.json (manifest_sha: 072c9526b5cd). Every reply containing commands MUST start with: COMMAND_MANIFEST_ACK 072c9526b5cd. Consult `agentic-kit command-for` before proposing commands and choose the most specific available Kit workflow command.
+MANDATORY FIRST READ: docs/reference/agentic-kit-commands.json (manifest_sha: a6c875ef652f). Every reply containing commands MUST start with: COMMAND_MANIFEST_ACK a6c875ef652f. Consult `agentic-kit command-for` before proposing commands and choose the most specific available Kit workflow command.
 <!-- command-manifest-entrypoint:end -->
 
 > Outer-doc currency note: Operational chat handoff now uses the deterministic Successor Handoff Package. Treat `docs/reports/handoff-packages/latest/successor_context.yaml`, `source_manifest.json`, `validation_report.json`, `execution_contract.json`, and `successor_prompt.md` as the canonical generated handoff package. The markdown prompts are projections, not independent sources of truth.

{agentic_project_kit-1.0.2 → agentic_project_kit-1.0.3}/CHANGELOG.md

@@ -1,11 +1,20 @@
+## v1.0.3 - 2026-08-23
+
+- Zenodo DOI verification pending for v1.0.3.
+- Close out v1.0.2 DOI metadata
+- Harden PR lifecycle settle cleanup
+- Preserve release evidence, handoff continuity, and bounded PR lifecycle cleanup governance.
+
 ## v1.0.2 - 2026-08-20
 
-- Zenodo DOI verification pending for v1.0.2.
 - Harden local Docker usage with bounded container smoke evidence and explicit scope boundaries.
 - Harden first-contact validation and PR closeout with regression coverage for clean installs, Git prerequisites, and the four-step handoff lifecycle.
 - Harden workspace remove and site fallback checks with guarded mutation planning and deterministic projection drift tests.
 - Add decomplexification audit roadmap while preserving governance gates and compatibility-safe facade planning.
 
+Post-release verification complete: GitHub Release exists, Zenodo concept DOI `10.5281/zenodo.20101359`, verified v1.0.2 DOI `10.5281/zenodo.22032882`.
+
+Zenodo v1.0.2 DOI: 10.5281/zenodo.22032882
 ## v1.0.1 - 2026-08-14
 
 - Zenodo DOI verification pending for v1.0.1.

{agentic_project_kit-1.0.2 → agentic_project_kit-1.0.3}/CITATION.cff

@@ -9,6 +9,7 @@ repository-code: "https://github.com/vfi64/agentic-project-kit"
 url: "https://github.com/vfi64/agentic-project-kit"
 doi: "10.5281/zenodo.20101359"
 # Verified v0.3.29 version DOI: 10.5281/zenodo.20303218
+# Verified v1.0.2 version DOI: 10.5281/zenodo.22032882
 # Verified v1.0.0 version DOI: 10.5281/zenodo.21925421
 # Verified v0.5.0 version DOI: 10.5281/zenodo.21850952
 # Verified v0.4.13 version DOI: 10.5281/zenodo.21631484
@@ -60,9 +61,9 @@ license: MIT
 # Verified v0.4.4 version DOI: 10.5281/zenodo.20431326
 # Verified v0.4.5 version DOI: 10.5281/zenodo.20467371
 # Verified v0.4.6 version DOI: 10.5281/zenodo.20593293
-version: 1.0.2
+version: 1.0.3
 # Verified v0.3.30 version DOI: 10.5281/zenodo.20308526
 # Verified v0.3.31 version DOI: 10.5281/zenodo.20313834
 # Verified v0.3.32 version DOI: 10.5281/zenodo.20314341
-date-released: "2026-08-20"
+date-released: "2026-08-23"
 # Verified v0.3.23 version DOI: 10.5281/zenodo.20261956

{agentic_project_kit-1.0.2 → agentic_project_kit-1.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agentic-project-kit
-Version: 1.0.2
+Version: 1.0.3
 Summary: Govern AI-assisted repository work with explicit contracts, gates, evidence, and handoffs.
 Project-URL: Repository, https://github.com/vfi64/agentic-project-kit
 Author: Volker Fickert
@@ -21,7 +21,7 @@ Description-Content-Type: text/markdown
 > Handoff architecture: the deterministic Successor Handoff Package writes `successor_context.yaml`, `source_manifest.json`, `validation_report.json`, `execution_contract.json`, and `successor_prompt.md` under `docs/reports/handoff-packages/latest/` for this repo or `.agentic/state/handoff/packages/latest/` in external workspace mode. New chats verify the package and execution contract, not chat memory.
 
 
-Current version: 1.0.2
+Current version: 1.0.3
 [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.20101359.svg)](https://doi.org/10.5281/zenodo.20101359)
 
 `agentic-project-kit` is a local Python package and CLI for governing AI-assisted repository work with explicit contracts, gates, evidence, handoffs, policy selection, task tracking, GitHub automation, and release validation.
@@ -744,9 +744,9 @@ These repository settings are maintainer-owned and are not changed by the packag
 
 ## Current status
 
-Prepared release: `v1.0.2`; GitHub Release, tag publication, and Zenodo version DOI verification are pending.
-Version `1.0.2` is the current release line prepared as a safety baseline after the pre-GUI transfer-wrapper, output-discipline, GUI wrapper-gating, PR diagnostics, and release-plan guard hardening work.
-Current verified release: `v1.0.0` with Zenodo version DOI `10.5281/zenodo.21925421`.
+Prepared release: `v1.0.3`; GitHub Release, tag publication, and Zenodo version DOI verification are pending.
+Version `1.0.3` is the current release line prepared as a safety baseline after the pre-GUI transfer-wrapper, output-discipline, GUI wrapper-gating, PR diagnostics, and release-plan guard hardening work.
+Current verified release: `v1.0.2` with Zenodo version DOI `10.5281/zenodo.22032882`.
 Earlier verified version-specific DOI notes are maintained in `docs/releases/VERIFIED_RELEASES.md`; historical release records remain in this section and the verified release archive.
 
 Archived GUI/cockpit release notes: v0.3.22 verified DOI `10.5281/zenodo.20256637`; v0.3.19 verified DOI `10.5281/zenodo.20246121`.

{agentic_project_kit-1.0.2 → agentic_project_kit-1.0.3}/README.md

@@ -3,7 +3,7 @@
 > Handoff architecture: the deterministic Successor Handoff Package writes `successor_context.yaml`, `source_manifest.json`, `validation_report.json`, `execution_contract.json`, and `successor_prompt.md` under `docs/reports/handoff-packages/latest/` for this repo or `.agentic/state/handoff/packages/latest/` in external workspace mode. New chats verify the package and execution contract, not chat memory.
 
 
-Current version: 1.0.2
+Current version: 1.0.3
 [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.20101359.svg)](https://doi.org/10.5281/zenodo.20101359)
 
 `agentic-project-kit` is a local Python package and CLI for governing AI-assisted repository work with explicit contracts, gates, evidence, handoffs, policy selection, task tracking, GitHub automation, and release validation.
@@ -726,9 +726,9 @@ These repository settings are maintainer-owned and are not changed by the packag
 
 ## Current status
 
-Prepared release: `v1.0.2`; GitHub Release, tag publication, and Zenodo version DOI verification are pending.
-Version `1.0.2` is the current release line prepared as a safety baseline after the pre-GUI transfer-wrapper, output-discipline, GUI wrapper-gating, PR diagnostics, and release-plan guard hardening work.
-Current verified release: `v1.0.0` with Zenodo version DOI `10.5281/zenodo.21925421`.
+Prepared release: `v1.0.3`; GitHub Release, tag publication, and Zenodo version DOI verification are pending.
+Version `1.0.3` is the current release line prepared as a safety baseline after the pre-GUI transfer-wrapper, output-discipline, GUI wrapper-gating, PR diagnostics, and release-plan guard hardening work.
+Current verified release: `v1.0.2` with Zenodo version DOI `10.5281/zenodo.22032882`.
 Earlier verified version-specific DOI notes are maintained in `docs/releases/VERIFIED_RELEASES.md`; historical release records remain in this section and the verified release archive.
 
 Archived GUI/cockpit release notes: v0.3.22 verified DOI `10.5281/zenodo.20256637`; v0.3.19 verified DOI `10.5281/zenodo.20246121`.

{agentic_project_kit-1.0.2 → agentic_project_kit-1.0.3}/docs/DOCUMENTATION_REGISTRY.yaml

@@ -649,6 +649,14 @@ documents:
     class: evidence/log
     owner: maintainers
     notes: Machine-readable appendix for the 2026-08-15 Decomplexification Audit, including per-command classifications and reduction tracks.
+  - path: docs/reports/HERMES_EXECUTOR_H0_INVENTORY_20260823.md
+    class: evidence/log
+    owner: maintainers
+    notes: Read-only H0 inventory evidence for Planner-Kit-Executor integration with Hermes as the first executor adapter.
+  - path: docs/reports/ONBOARDING_O0_BASELINE_20260823.md
+    class: evidence/log
+    owner: maintainers
+    notes: Read-only O0 baseline evidence for measured first-chat onboarding friction and orientation-anchor planning.
   - path: docs/architecture/evidence/path-literal-audit-2026-07-04.md
     class: evidence/log
     owner: maintainers

{agentic_project_kit-1.0.2 → agentic_project_kit-1.0.3}/docs/STATUS.md

@@ -2,15 +2,15 @@
 
 ## Current State
 
-Current version: 1.0.2
-Current verified release: 1.0.0.
-Current release tag: v1.0.0.
+Current version: 1.0.3
+Current verified release: 1.0.2.
+Current release tag: v1.0.2.
 Zenodo concept DOI: `10.5281/zenodo.20101359`.
-Verified Zenodo version DOI: `10.5281/zenodo.21925421`.
-Current verified main: `8cd7a5cf` (`Prepare v1.0.2 safety release (#2113)`).
-Latest substantive work: PR #2113 (`Prepare v1.0.2 safety release (#2113)`).
+Verified Zenodo version DOI: `10.5281/zenodo.22032882`.
+Current verified main: `41e6e9ae` (`Record onboarding O0 baseline (#2125)`).
+Latest substantive work: PR #2125 (`Record onboarding O0 baseline (#2125)`).
 Current governed slice: continue from fresh main with the next planned governed slice after post-merge handoff checks pass; do not repeat already verified release publication steps.
-Post-merge handoff status: PASS/NOOP after PR #2113 administrative refresh.
+Post-merge handoff status: PASS/NOOP after PR #2125 administrative refresh.
 Next safe step: continue from fresh main with the next planned governed slice.
 
 ## Historical State Snapshots
@@ -416,6 +416,6 @@ DPA-700 evidence, exact refs and Maintainer-authorized scope.
 ## Operational documentation refresh state after PR #2013
 
 Current administrative handoff refresh state is `e3509718` (`Refresh handoff state after PR2013 (#2014)`). The post-PR2013 administrative refresh is committed and merged; the next substantive slice must be created from fresh main.
-## Operational documentation refresh state after PR #2113
+## Operational documentation refresh state after PR #2125
 
-Current administrative handoff refresh state is `8cd7a5cf` (`Prepare v1.0.2 safety release (#2113)`). Continue next only after this post-PR2113 refresh is committed and merged; the next substantive slice must be created from fresh main.
+Current administrative handoff refresh state is `41e6e9ae` (`Record onboarding O0 baseline (#2125)`). Continue next only after this post-PR2125 refresh is committed and merged; the next substantive slice must be created from fresh main.

{agentic_project_kit-1.0.2 → agentic_project_kit-1.0.3}/docs/architecture/evidence/dpa/assessment/dp1-assessment-readiness-20260728.json

@@ -3,7 +3,7 @@
   "kind": "dpa_dp1_assessment_readiness",
   "status": "DP2_AUTHORIZED",
   "status_date": "2026-07-29",
-  "command_manifest_ack": "COMMAND_MANIFEST_ACK 072c9526b5cd",
+  "command_manifest_ack": "COMMAND_MANIFEST_ACK a6c875ef652f",
   "kit_baseline_ref": "be37f052d67cc2646d56c103cef962823a01cee5",
   "dpa_lab_source_ref": "0cf944cc153e65a272c773286791f8891efdd1bc",
   "dpa_lab_merge_ref": "6f927efd625b4239f9ab0e710b48e7d9534fdfec",

{agentic_project_kit-1.0.2 → agentic_project_kit-1.0.3}/docs/governance/CHAT_BOOTSTRAP_AND_DRIFT_CONTRACT.md

@@ -184,12 +184,9 @@ After a successful merge, the required closeout is:
 
 Before branch switches, PR completion, or merge-safe operations, known volatile transfer outputs must not be allowed to block the lifecycle.
 
-At minimum, clean these local-only volatile paths when they are dirty and not the target of the current slice:
+Canonical wrappers that mutate branch, PR, merge, or post-merge state must restore known volatile transfer paths as a precondition or postcondition when doing so is safe. Use the dedicated wrapper for diagnostics or fallback cleanup:
 
-    git restore -- .agentic/transfer/outbox/last_result.txt
-    git restore -- docs/reports/terminal/transfer_handoff_reports/latest-transfer-handoff-report.json
-    git restore -- docs/reports/terminal/transfer_handoff_reports/latest-transfer-handoff-report.log
+    ./.venv/bin/agentic-kit transfer restore-known-volatile --json
 
-This cleanup is a workaround for volatile report files. It must not be used to discard substantive source, governance, planning, or handoff changes.
+This cleanup is limited to the known volatile transfer whitelist. It must not be used to discard substantive source, governance, planning, or handoff changes.
 <!-- agentic-kit:command-reference-lifecycle-discipline:end -->
-

{agentic_project_kit-1.0.2 → agentic_project_kit-1.0.3}/docs/governance/CHAT_COMMUNICATION_CONTRACT.md

@@ -203,11 +203,9 @@ After a successful merge, the required closeout is:
 
 Before branch switches, PR completion, or merge-safe operations, known volatile transfer outputs must not be allowed to block the lifecycle.
 
-At minimum, clean these local-only volatile paths when they are dirty and not the target of the current slice:
+Canonical wrappers that mutate branch, PR, merge, or post-merge state must restore known volatile transfer paths as a precondition or postcondition when doing so is safe. Use the dedicated wrapper for diagnostics or fallback cleanup:
 
-    git restore -- .agentic/transfer/outbox/last_result.txt
-    git restore -- docs/reports/terminal/transfer_handoff_reports/latest-transfer-handoff-report.json
-    git restore -- docs/reports/terminal/transfer_handoff_reports/latest-transfer-handoff-report.log
+    ./.venv/bin/agentic-kit transfer restore-known-volatile --json
 
-This cleanup is a workaround for volatile report files. It must not be used to discard substantive source, governance, planning, or handoff changes.
+This cleanup is limited to the known volatile transfer whitelist. It must not be used to discard substantive source, governance, planning, or handoff changes.
 <!-- agentic-kit:command-reference-lifecycle-discipline:end -->

{agentic_project_kit-1.0.2 → agentic_project_kit-1.0.3}/docs/governance/DOC_REGISTRY_SCOPE_DECISION.md

@@ -24,7 +24,7 @@ Decision outcome: active registry scope is declared in `docs/DOC_REGISTRY_SCOPE.
 | docs/planning/ | 2 | 2 | 0 |  |
 | docs/reference/ | 7 | 7 | 0 |  |
 | docs/releases/ | 1 | 1 | 0 |  |
-| docs/reports/ | 96 | 6 | 90 |  |
+| docs/reports/ | 98 | 8 | 90 |  |
 | docs/workflow/ | 11 | 11 | 0 |  |
 
 Notes:

{agentic_project_kit-1.0.2 → agentic_project_kit-1.0.3}/docs/governance/PORTABLE_CHAT_EXECUTION_CONTRACT.md

@@ -140,12 +140,9 @@ After a successful merge, the required closeout is:
 
 Before branch switches, PR completion, or merge-safe operations, known volatile transfer outputs must not be allowed to block the lifecycle.
 
-At minimum, clean these local-only volatile paths when they are dirty and not the target of the current slice:
+Canonical wrappers that mutate branch, PR, merge, or post-merge state must restore known volatile transfer paths as a precondition or postcondition when doing so is safe. Use the dedicated wrapper for diagnostics or fallback cleanup:
 
-    git restore -- .agentic/transfer/outbox/last_result.txt
-    git restore -- docs/reports/terminal/transfer_handoff_reports/latest-transfer-handoff-report.json
-    git restore -- docs/reports/terminal/transfer_handoff_reports/latest-transfer-handoff-report.log
+    ./.venv/bin/agentic-kit transfer restore-known-volatile --json
 
-This cleanup is a workaround for volatile report files. It must not be used to discard substantive source, governance, planning, or handoff changes.
+This cleanup is limited to the known volatile transfer whitelist. It must not be used to discard substantive source, governance, planning, or handoff changes.
 <!-- agentic-kit:command-reference-lifecycle-discipline:end -->
-

{agentic_project_kit-1.0.2 → agentic_project_kit-1.0.3}/docs/handoff/CLOSEOUT_BEFORE_CHAT_SWITCH_PROMPT.md

@@ -39,7 +39,7 @@ The command must generate the package files, update the three canonical chat-swi
 Do not start product work in this closeout. If validation fails, repair the handoff projection first.
 
 Command manifest entrypoint:
-- MANDATORY FIRST READ: docs/reference/agentic-kit-commands.json (manifest_sha: 072c9526b5cd). Every reply containing commands MUST start with: COMMAND_MANIFEST_ACK 072c9526b5cd. Consult `agentic-kit command-for` before proposing commands and choose the most specific available Kit workflow command.
+- MANDATORY FIRST READ: docs/reference/agentic-kit-commands.json (manifest_sha: a6c875ef652f). Every reply containing commands MUST start with: COMMAND_MANIFEST_ACK a6c875ef652f. Consult `agentic-kit command-for` before proposing commands and choose the most specific available Kit workflow command.
 - Before proposing ANY command run/consult `agentic-kit command-for` and choose the most specific available Kit workflow command.
 - raw git/gh commands with a mapped wrapper are rejected by instruction lint.
 
@@ -49,5 +49,5 @@ Command reference contract:
 - `must_not_reconstruct_commands_from_memory: true`.
 - Treat `source_hashes` as freshness evidence.
 source_hashes:
-- docs/reference/AGENTIC_KIT_COMMANDS.md: 8d62c0cade803e7ded40d71beeb85d83b0a1d7d3a360baec4cf6580454b7ae18
-- docs/reference/agentic-kit-commands.json: 22064c2979254ad22231ed7f0a58f3069ec80ddb675a99e42643203b1feb3015
+- docs/reference/AGENTIC_KIT_COMMANDS.md: 0a3db8afbe6641cfaee1a538af090762236c438615964bec5438601c00e883f9
+- docs/reference/agentic-kit-commands.json: 0a6582ccfd04be23fe1beb49bffae18e7b50dacf8aa3e596e5eed2ced14f2943

{agentic_project_kit-1.0.2 → agentic_project_kit-1.0.3}/docs/handoff/CURRENT_HANDOFF.md

@@ -1,8 +1,8 @@
 <!-- agentic:generated operational-handoff-state begin -->
 ## Current Operational Handoff State
 
-Current verified main/admin HEAD is `8cd7a5cfee2d7176797fd6335492d0c890de9999` (`8cd7a5cf`), after `Prepare v1.0.2 safety release (#2113)`.
-Last substantive work state is `8cd7a5cfee2d7176797fd6335492d0c890de9999` (`8cd7a5cf`), after `Prepare v1.0.2 safety release (#2113)`.
+Current verified main/admin HEAD is `41e6e9ae6d3b8b1fdb8b0d7f00bfaf33fb59a1e5` (`41e6e9ae`), after `Record onboarding O0 baseline (#2125)`.
+Last substantive work state is `41e6e9ae6d3b8b1fdb8b0d7f00bfaf33fb59a1e5` (`41e6e9ae`), after `Record onboarding O0 baseline (#2125)`.
 
 PR #1257 hardened admin-refresh-pr and pr-complete recovery.
 PR #1255 added generated operational handoff block replacement.
@@ -213,7 +213,7 @@ Status-date: 2026-05-27
 Project: agentic-project-kit
 Branch: codex/refresh-post-pr835-next-step-state
 Base branch: main
-Current version: 1.0.2
+Current version: 1.0.3
 
 ## Purpose
 
@@ -227,10 +227,10 @@ This file is the concise, curated current handoff pointer. Long-term history bel
 - This refresh records the AGF/DPA Package-G adoption-evaluation tracker only. It
   does not claim DPA import, AGF adoption or production runtime mutation.
 
-- Current verified release: 1.0.0.
-- Current release tag: v1.0.0.
+- Current verified release: 1.0.2.
+- Current release tag: v1.0.2.
 - Zenodo concept DOI: `10.5281/zenodo.20101359`.
-- Verified Zenodo version DOI: `10.5281/zenodo.21925421`.
+- Verified Zenodo version DOI: `10.5281/zenodo.22032882`.
 - Main contains PR #1387 at `e07ccd4`.
 - PR #1387 refreshed handoff state after the v0.4.8 release PR #1386.
 - Generated handoff safe-state now anchors to PR #1387 via `docs/reports/terminal/post-pr1386-successor-chat-handoff.md`.

{agentic_project_kit-1.0.2 → agentic_project_kit-1.0.3}/docs/handoff/NEXT_CHAT_BOOTSTRAP.md

@@ -6,9 +6,9 @@ Do not start from chat memory. Read the Successor Handoff Package first.
 ## Current verified repository state
 
 - Repo: `vfi64/agentic-project-kit`
-- HEAD: `8cd7a5cfee2d7176797fd6335492d0c890de9999` (`8cd7a5cf`)
-- Handoff freshness marker: `8cd7a5cf`
-- Branch at generation: `docs/post-pr2113-handoff-refresh`
+- HEAD: `41e6e9ae6d3b8b1fdb8b0d7f00bfaf33fb59a1e5` (`41e6e9ae`)
+- Handoff freshness marker: `41e6e9ae`
+- Branch at generation: `docs/post-pr2125-handoff-refresh`
 - Worktree clean at generation: `False`
 
 ## Successor handoff package
@@ -72,7 +72,8 @@ Wenn der Bootstrap grün ist:
 Source: `docs/planning/PROJECT_DIRECTION.yaml` or external workspace state.
 
 - `p5c-physical-migration` (blocked): Plan physical migration after legacy profile deprecation for P5
-- `public-installation-and-update-readiness` (next): Close public installation, PyPI publication, update, and Docker readiness gaps for v1.0.2
+- `planner-kit-executor-hermes-integration` (next): Add governed Planner-Kit-Executor integration with Hermes as the first executor adapter for post-1.0
+- `measured-agent-onboarding` (next): Add measured first-chat onboarding without creating a second planner for post-1.0
 - `v2-0-legacy-profile-removal` (planned): Remove the implicit legacy profile in 2.0.0 for unphased
 - `pre-gui-hardening-line` (next): Finish wrapper, evidence, rule-refresh, and closeout hardening before GUI expansion for pre-GUI
 - `workflow-kernel-and-transfer-hardening` (planned): Harden next-turn, transfer, branch, PR, evidence, and remote state-machine workflows for pre-GUI
@@ -103,7 +104,7 @@ Source: `docs/planning/PROJECT_DIRECTION.yaml` or external workspace state.
 ### RESULT: PASS ###
 
 Command manifest entrypoint:
-- MANDATORY FIRST READ: docs/reference/agentic-kit-commands.json (manifest_sha: 072c9526b5cd). Every reply containing commands MUST start with: COMMAND_MANIFEST_ACK 072c9526b5cd. Consult `agentic-kit command-for` before proposing commands and choose the most specific available Kit workflow command.
+- MANDATORY FIRST READ: docs/reference/agentic-kit-commands.json (manifest_sha: a6c875ef652f). Every reply containing commands MUST start with: COMMAND_MANIFEST_ACK a6c875ef652f. Consult `agentic-kit command-for` before proposing commands and choose the most specific available Kit workflow command.
 - Before proposing ANY command run/consult `agentic-kit command-for` and choose the most specific available Kit workflow command.
 - raw git/gh commands with a mapped wrapper are rejected by instruction lint.
 
@@ -113,5 +114,5 @@ Command reference contract:
 - `must_not_reconstruct_commands_from_memory: true`.
 - Treat `source_hashes` as freshness evidence.
 source_hashes:
-- docs/reference/AGENTIC_KIT_COMMANDS.md: 8d62c0cade803e7ded40d71beeb85d83b0a1d7d3a360baec4cf6580454b7ae18
-- docs/reference/agentic-kit-commands.json: 22064c2979254ad22231ed7f0a58f3069ec80ddb675a99e42643203b1feb3015
+- docs/reference/AGENTIC_KIT_COMMANDS.md: 0a3db8afbe6641cfaee1a538af090762236c438615964bec5438601c00e883f9
+- docs/reference/agentic-kit-commands.json: 0a6582ccfd04be23fe1beb49bffae18e7b50dacf8aa3e596e5eed2ced14f2943

{agentic_project_kit-1.0.2 → agentic_project_kit-1.0.3}/docs/handoff/START_NEW_CHAT_PROMPT.md

@@ -75,7 +75,7 @@ Wenn der Bootstrap grün ist:
 - Neue Produktarbeit nur aus frischem, sauberem `main` beginnen.
 
 Command manifest entrypoint:
-- MANDATORY FIRST READ: docs/reference/agentic-kit-commands.json (manifest_sha: 072c9526b5cd). Every reply containing commands MUST start with: COMMAND_MANIFEST_ACK 072c9526b5cd. Consult `agentic-kit command-for` before proposing commands and choose the most specific available Kit workflow command.
+- MANDATORY FIRST READ: docs/reference/agentic-kit-commands.json (manifest_sha: a6c875ef652f). Every reply containing commands MUST start with: COMMAND_MANIFEST_ACK a6c875ef652f. Consult `agentic-kit command-for` before proposing commands and choose the most specific available Kit workflow command.
 - Before proposing ANY command run/consult `agentic-kit command-for` and choose the most specific available Kit workflow command.
 - raw git/gh commands with a mapped wrapper are rejected by instruction lint.
 
@@ -85,8 +85,8 @@ Command reference contract:
 - `must_not_reconstruct_commands_from_memory: true`.
 - Treat `source_hashes` as freshness evidence.
 source_hashes:
-- docs/reference/AGENTIC_KIT_COMMANDS.md: 8d62c0cade803e7ded40d71beeb85d83b0a1d7d3a360baec4cf6580454b7ae18
-- docs/reference/agentic-kit-commands.json: 22064c2979254ad22231ed7f0a58f3069ec80ddb675a99e42643203b1feb3015
-## Operational documentation refresh state after PR #2113
+- docs/reference/AGENTIC_KIT_COMMANDS.md: 0a3db8afbe6641cfaee1a538af090762236c438615964bec5438601c00e883f9
+- docs/reference/agentic-kit-commands.json: 0a6582ccfd04be23fe1beb49bffae18e7b50dacf8aa3e596e5eed2ced14f2943
+## Operational documentation refresh state after PR #2125
 
-Current administrative handoff refresh state is `8cd7a5cf` (`Prepare v1.0.2 safety release (#2113)`). Continue next only after this post-PR2113 refresh is committed and merged; the next substantive slice must be created from fresh main.
+Current administrative handoff refresh state is `41e6e9ae` (`Record onboarding O0 baseline (#2125)`). Continue next only after this post-PR2125 refresh is committed and merged; the next substantive slice must be created from fresh main.

{agentic_project_kit-1.0.2 → agentic_project_kit-1.0.3}/docs/planning/PROJECT_DIRECTION.yaml

@@ -397,7 +397,8 @@ roadmap:
   - docs/planning/PROJECT_DIRECTION.yaml
 - id: public-installation-and-update-readiness
   phase: post-1.0
-  status: next
+  status: done
+  completed_by_pr: 2115
   title: Close public installation, PyPI publication, update, and Docker readiness gaps
   target_release: v1.0.2
   depends_on:
@@ -427,6 +428,7 @@ roadmap:
   - docs/reports/V1_0_1_DOCKER_PYPI_FIRST_CONTACT_20260820.md
   - docs/reports/FIRST_CONTACT_POST_FIX_CHECKOUT_VALIDATION_20260820.md
   - docs/reports/release/release-prepare-1.0.2.json
+  - docs/reports/release/post-release-doi-closeout-1.0.2.json
   - README.md
   - site/templates/quickstart.html
   - site/templates/index.html
@@ -444,6 +446,97 @@ roadmap:
   - .github/workflows/release.yml
   - Dockerfile
   - .agentic/config.yaml
+- id: planner-kit-executor-hermes-integration
+  phase: post-1.0
+  status: next
+  title: Add governed Planner-Kit-Executor integration with Hermes as the first executor adapter
+  depends_on:
+  - public-installation-and-update-readiness
+  - workflow-kernel-and-transfer-hardening
+  acceptance:
+  - Kit remains the sole command, rule, documentation, state, release, and handoff
+    authority; Planner and Executor integration must not create a parallel workflow
+    taxonomy.
+  - Hermes is introduced only as the first executor/browser adapter behind existing
+    agentic-kit command and capability boundaries.
+  - The first slices are read-only H0/H1 work that inventories command/contract surfaces,
+    record gaps, and define the smallest proof-of-concept contract before any runtime
+    mutation path is added.
+  - Any later executor action is represented as a bounded agentic-kit command or
+    cockpit/action-registry surface with tests, evidence, failure states, and
+    post-merge handoff.
+  - Browser/executor credentials, GUI sessions, and external side effects stay outside
+    durable planning authority unless explicitly represented as capability boundaries.
+  implementation_slices:
+  - id: H0
+    goal: Read-only inventory of current Kit command, state, handoff, GUI/action,
+      and release authority boundaries relevant to Planner-Kit-Executor integration.
+    evidence:
+    - docs/reports/HERMES_EXECUTOR_H0_INVENTORY_20260823.md
+  - id: H1
+    goal: Gap analysis and proof-of-concept contract for a Hermes-backed executor
+      adapter, with no direct command taxonomy fork.
+  - id: H2
+    goal: Minimal read-only executor adapter surface if H1 shows a bounded fit.
+  - id: H3-plus
+    goal: Incremental mutation-capable slices only after capability, evidence, rollback,
+      and gate semantics are explicit.
+  evidence:
+  - docs/planning/PROJECT_DIRECTION.yaml
+  - docs/architecture/ARCHITECTURE_CONTRACT.md
+  - docs/reference/agentic-kit-commands.json
+  - docs/reports/HERMES_EXECUTOR_H0_INVENTORY_20260823.md
+  source_files:
+  - docs/planning/PROJECT_DIRECTION.yaml
+  - docs/architecture/ARCHITECTURE_CONTRACT.md
+  - docs/reference/agentic-kit-commands.json
+- id: measured-agent-onboarding
+  phase: post-1.0
+  status: next
+  title: Add measured first-chat onboarding without creating a second planner
+  depends_on:
+  - public-installation-and-update-readiness
+  - command-manifest-hardening
+  acceptance:
+  - O0 records a baseline first-contact/onboarding measurement before adding new
+    user-facing guidance.
+  - O1 may add `docs/ONBOARDING.md` and a README anchor only with documentation
+    coverage and gate updates in the same slice.
+  - O2 binds onboarding guidance to the command manifest and existing workspace
+    detection messaging rather than duplicating command help or planning rules.
+  - O3 adds a small glossary only where it reduces first-chat ambiguity without
+    becoming a competing rulebook.
+  - O4 makes the onboarding measurement repeatable so later guidance changes can
+    be compared instead of guessed.
+  - O5 aligns generated site/quickstart projections after the canonical docs and
+    gates are green.
+  implementation_slices:
+  - id: O0
+    goal: Read-only baseline measurement of first-chat onboarding friction and missing
+      orientation anchors.
+    evidence:
+    - docs/reports/ONBOARDING_O0_BASELINE_20260823.md
+  - id: O1
+    goal: Minimal onboarding document and README anchor, covered by docs gates.
+  - id: O2
+    goal: Drift binding against the command manifest and workspace-detection message
+      sources.
+  - id: O3
+    goal: Minimal glossary for terms that repeatedly block new users or agents.
+  - id: O4
+    goal: Repeatable onboarding measurement command or report contract.
+  - id: O5
+    goal: Site and quickstart projection alignment from the canonical onboarding
+      source.
+  evidence:
+  - docs/planning/PROJECT_DIRECTION.yaml
+  - docs/DOCUMENTATION_COVERAGE.yaml
+  - docs/reference/agentic-kit-commands.json
+  - docs/reports/ONBOARDING_O0_BASELINE_20260823.md
+  source_files:
+  - docs/planning/PROJECT_DIRECTION.yaml
+  - docs/DOCUMENTATION_COVERAGE.yaml
+  - docs/reference/agentic-kit-commands.json
 - id: dpa-repo-adoption-assessment
   phase: unphased
   status: done

{agentic_project_kit-1.0.2 → agentic_project_kit-1.0.3}/docs/reference/AGENTIC_KIT_COMMANDS.md

@@ -1,6 +1,6 @@
 # Agentic-kit command reference
 
-GENERATED FROM agentic-kit-commands.json — do not edit; manifest_sha: 072c9526b5cd
+GENERATED FROM agentic-kit-commands.json — do not edit; manifest_sha: a6c875ef652f
 
 > Successor handoff contract note: the machine-readable successor execution contract is written to `docs/reports/handoff-packages/latest/execution_contract.json`. This generated command reference points to the contract instead of duplicating local-command rules.
 
@@ -1335,7 +1335,7 @@ Run the pre-GUI readiness gate.
 | Parameter | Type | Options | Required | Default | Help |
 |---|---:|---|---:|---|---|
 | `root` | `TyperOption` | --root | `False` | `PosixPath('.')` |  |
-| `version` | `TyperOption` | --version | `False` | `1.0.2` |  |
+| `version` | `TyperOption` | --version | `False` | `1.0.3` |  |
 | `json_output` | `TyperOption` | --json | `False` | `False` |  |
 
 ### `agentic-kit handoff check`
@@ -1819,7 +1819,7 @@ Plan release publishing without live tag/release side effects.
 
 | Parameter | Type | Options | Required | Default | Help |
 |---|---:|---|---:|---|---|
-| `version` | `TyperOption` | --version | `False` | `1.0.2` |  |
+| `version` | `TyperOption` | --version | `False` | `1.0.3` |  |
 | `dry_run` | `TyperOption` | --dry-run, --no-dry-run | `False` | `True` |  |
 | `execute` | `TyperOption` | --execute | `False` | `False` |  |
 | `allow_execute` | `TyperOption` | --allow-execute | `False` | `False` |  |
@@ -2102,7 +2102,7 @@ Run the audit suite required by standard project gates.
 | Parameter | Type | Options | Required | Default | Help |
 |---|---:|---|---:|---|---|
 | `root` | `TyperOption` | --root | `False` | `PosixPath('.')` |  |
-| `version` | `TyperOption` | --version | `False` | `1.0.2` |  |
+| `version` | `TyperOption` | --version | `False` | `1.0.3` |  |
 | `json_output` | `TyperOption` | --json | `False` | `False` |  |
 
 ### `agentic-kit state freshness-check`

{agentic_project_kit-1.0.2 → agentic_project_kit-1.0.3}/docs/reference/agentic-kit-commands.json

@@ -6390,7 +6390,7 @@
           "secondary_opts": []
         },
         {
-          "default": "1.0.2",
+          "default": "1.0.3",
           "help": "",
           "is_flag": false,
           "metavar": null,
@@ -8746,7 +8746,7 @@
       "name": "release-publish",
       "params": [
         {
-          "default": "1.0.2",
+          "default": "1.0.3",
           "help": "",
           "is_flag": false,
           "metavar": null,
@@ -10159,7 +10159,7 @@
           "secondary_opts": []
         },
         {
-          "default": "1.0.2",
+          "default": "1.0.3",
           "help": "",
           "is_flag": false,
           "metavar": null,
@@ -17626,7 +17626,7 @@
   "kind": "agentic_kit_command_reference",
   "meta": {
     "generated_md": "docs/reference/AGENTIC_KIT_COMMANDS.md",
-    "manifest_sha": "072c9526b5cd",
+    "manifest_sha": "a6c875ef652f",
     "schema_version": 1
   },
   "schema_version": 2,