Icod.Terminal 1.11.1 — TermInfo persistent-raster integration contract

CHANGELOG.md

@@ -2,6 +2,28 @@
 
 Notable changes to `Icod.Terminal` are recorded here for consumers who need a concise release history. Detailed design evidence remains in the versioned roadmaps, tranche records, and public-API baseline documents.
 
+## 1.11.1
+
+### TermInfo persistent-raster integration contract
+
+- Adds a dedicated three-TFM integration-contract test project which references `Icod.TermInfo.Inspection 1.11.0` without adding Inspection or Source to the production `Icod.Terminal` dependency graph.
+- Defines and tests the consumer-owned translation from conclusive live Terminal capability status to protocol-neutral TermInfo `Verified` lifecycle evidence. `Unknown`, `Advertised`, unrelated capabilities, and endpoint unavailability are not promoted.
+- Proves static persistent-raster lifecycle planning can transition from `Indeterminate` through Terminal-owned live verification and caller-owned evidence to a deterministic successful replan.
+- Proves verified persistent non-support produces an `Impossible` lifecycle plan without attempting persistent resource creation.
+- Proves exact static Icod lifecycle declarations can produce a successful TermInfo plan without planning I/O while Terminal independently retains authority over live endpoint usability and execution.
+- Adds `Icod.Terminal.TermInfoPersistentRaster.Sample`, executable architecture documentation for static inspection -> semantic planning -> optional live verification -> caller-owned evidence -> replan -> opaque Terminal resource/placement execution.
+
+### Compatibility and qualification
+
+- Adds no production public API and intentionally retains the final 1.11 public API fingerprint `9336a1f6def1c4b02e86db813bae27f45b95af33f47a2cf10dccd4d1d44324f2`.
+- Preserves production dependencies at `Icod.TermInfo 1.11.0` and `Icod.Timing 1.0.0`; `Icod.TermInfo.Inspection 1.11.0` remains test/sample-only and `Icod.TermInfo.Source` is not introduced.
+- Makes no intentional change to the persistent-raster wire protocol, acknowledgement, ownership, generation invalidation, cleanup, routing, or bounded-resource semantics released in 1.11.0.
+- Retains `net8.0`, `net9.0`, and `net10.0`, Windows/Linux/macOS Staging validation, current package/downstream gates, and the stable `1.0.0` compatibility floor.
+- T1111-A through T1111-D completed full pull-request qualification on exact head `651af888875a0d2acababe46a4e1313532ec7ba6` in workflow `#1628 / 34704455179`.
+- Deliberately defers a table-driven `TerminalTermInfoSemanticEvidence` cleanup, static lifecycle-evidence ingestion, and any adapter package to later independent design work.
+
+See `docs/releases/1.11.1.md` and `Icod.Terminal-1.11.1-Development-Roadmap.md` for the complete patch-release integration contract.
+
 ## 1.11.0
 
 ### Persistent raster resources and placements

Directory.Build.props

@@ -1,7 +1,7 @@
 <Project>
 	<PropertyGroup>
 		<!-- Repository-wide release version authority. -->
-		<VersionPrefix>1.11.0</VersionPrefix>
+		<VersionPrefix>1.11.1</VersionPrefix>
 		<VersionSuffix></VersionSuffix>
 		<Version Condition="'$(VersionSuffix)' == ''">$(VersionPrefix)</Version>
 		<Version Condition="'$(VersionSuffix)' != ''">$(VersionPrefix)-$(VersionSuffix)</Version>

Icod.Terminal-1.11.1-Development-Roadmap.md

@@ -0,0 +1,325 @@
+# Icod.Terminal 1.11.1 Development Roadmap
+
+**Release:** `1.11.1`  
+**Theme:** TermInfo 1.11 ↔ Terminal 1.11 persistent-raster integration contract  
+**Status:** T1111-A through T1111-E accepted; final status-only PR head qualification pending  
+**Development version:** stable `1.11.1` release candidate  
+**Stable compatibility floor:** `1.0.0`  
+**Prior release:** `1.11.0`  
+**TermInfo Runtime dependency:** `Icod.TermInfo 1.11.0`
+
+## Why this patch release exists
+
+`Icod.Terminal 1.11.0` completed the live persistent-raster ownership/runtime layer: capability verification, acknowledged terminal-resident resource upload, placement creation/update, lifecycle invalidation, deterministic cleanup, and opaque public resource/placement handles.
+
+`Icod.TermInfo 1.11.0` independently completed the protocol-neutral planning layer: persistent-raster lifecycle evidence, provenance, classification, semantic planning, description/database-set composition, and version-3 machine-readable profile/plan documents through `Icod.TermInfo.Inspection`.
+
+Both releases intentionally preserve a loose architectural boundary:
+
+```text
+Icod.TermInfo.Inspection
+    static/advisory evidence
+    classification
+    uncertainty / contradiction
+    semantic planning
+
+consumer-owned integration
+    optional live verification
+    evidence strengthening
+    reclassification / replanning
+
+Icod.Terminal
+    live endpoint ownership
+    bounded protocol verification
+    persistent resource identity
+    placement identity
+    generation invalidation
+    terminal-side execution / cleanup
+```
+
+Version `1.11.1` exists to prove that boundary end-to-end through an executable sample and deterministic contract tests without making Inspection or Source production dependencies of `Icod.Terminal`.
+
+The implementation plan is:
+
+[`docs/superpowers/plans/2026-09-12-1.11.1-terminfo-persistent-raster-integration.md`](docs/superpowers/plans/2026-09-12-1.11.1-terminfo-persistent-raster-integration.md)
+
+The runtime ownership authority remains:
+
+[`docs/Persistent-Raster-Ownership.md`](docs/Persistent-Raster-Ownership.md)
+
+The TermInfo semantic authority is:
+
+```text
+https://github.com/uniblab/Icod.TermInfo/blob/main/docs/1.11.0-PERSISTENT-RASTER-LIFECYCLE-GUIDE.md
+```
+
+The release-closure record is:
+
+[`docs/T1111-E-1.11.1-Release-Closure.md`](docs/T1111-E-1.11.1-Release-Closure.md)
+
+## Release objectives
+
+Version 1.11.1 must:
+
+1. demonstrate TermInfo 1.11 static persistent-raster lifecycle inspection and planning over the exact `TerminalDescription` selected by a live `TerminalSession`;
+2. preserve `Icod.TermInfo.Inspection` as an optional consumer/sample/test dependency rather than a production `Icod.Terminal` dependency;
+3. prove an initially indeterminate TermInfo plan can be strengthened by Terminal-owned live verification and caller-owned `Verified` lifecycle evidence;
+4. prove the strengthened profile can be reclassified/replanned deterministically before runtime execution;
+5. prove verified non-support becomes an impossible semantic plan without attempting persistent-raster execution;
+6. demonstrate the successful plan executing through the existing opaque `TerminalRasterResource` / `TerminalRasterPlacement` API only;
+7. keep all Kitty/private protocol identities and command details out of the integration contract;
+8. preserve the exact 1.11.0 public API and stable 1.0 compatibility floor;
+9. preserve the production package graph: Runtime `Icod.TermInfo 1.11.0` plus `Icod.Timing 1.0.0`, with no new Inspection/Source production dependency;
+10. qualify the complete integration contract on Windows, Linux, macOS and `net8.0`, `net9.0`, `net10.0`.
+
+All ten objectives are satisfied by the accepted T1111-E release candidate described below.
+
+## Frozen integration direction
+
+The intended consumer flow is:
+
+```text
+TerminalSession.Terminal
+    -> PersistentRasterLifecycleInspector.Inspect(...)
+    -> PersistentRasterLifecyclePlanner.Plan(...)
+
+if plan == Indeterminate
+    -> TerminalSession.VerifyCapabilityAsync(PersistentRasterGraphics)
+    -> consumer maps Terminal live result to Verified lifecycle evidence
+    -> PersistentRasterLifecycleClassifier.Classify(...)
+    -> PersistentRasterLifecyclePlanner.Plan(...)
+
+if plan == Success
+    -> TerminalSession.CreateRasterResourceAsync(...)
+    -> TerminalRasterResource.CreatePlacementAsync(...)
+    -> TerminalRasterPlacement.UpdateAsync(...)
+    -> dispose placement/resource
+
+if plan == Impossible
+    -> do not attempt persistent-raster execution
+```
+
+The TermInfo request used by the core integration contract covers:
+
+```text
+persistent resource upload
+acknowledged upload
+one placement
+placement update
+placement deletion
+resource deletion
+```
+
+The sample may explain ordinary raster separately, but persistent and ephemeral intent must not be mixed into one TermInfo lifecycle request.
+
+## Consumer-owned verified evidence mapping
+
+Terminal's public `PersistentRasterGraphics` capability is deliberately coarser than TermInfo's lifecycle profile. For this integration contract, a consumer-owned bridge may interpret a **Terminal live verification result** as follows:
+
+```text
+RasterGraphics == Verified
+    -> RasterDisplay positive Verified evidence
+
+PersistentRasterGraphics == Verified
+    -> PersistentUpload positive Verified evidence
+    -> AcknowledgedUpload positive Verified evidence
+    -> PlacementCreation positive Verified evidence
+    -> MultiplePlacements positive Verified evidence
+    -> PlacementUpdate positive Verified evidence
+    -> PlacementDeletion positive Verified evidence
+    -> ResourceDeletion positive Verified evidence
+
+PersistentRasterGraphics == Unsupported
+    -> the seven persistent lifecycle subjects above receive negative Verified evidence
+```
+
+This mapping is sample/test integration policy, not a new TermInfo or Terminal production API contract.
+
+`Unknown`, `Advertised`, or endpoint unavailability must not be promoted to caller-owned `Verified` support/non-support.
+
+## Tranche roadmap
+
+```text
+T1111-A  integration dependency boundary and dedicated contract-test project   accepted
+T1111-B  consumer-owned live-evidence mapping contract                         accepted
+T1111-C  static-plan → live-verification → replan contract tests                accepted
+T1111-D  protocol-neutral executable integration sample                         accepted
+T1111-E  package/downstream qualification and 1.11.1 release closure            accepted
+```
+
+## Accepted A–D integration checkpoint
+
+T1111-A through T1111-D are accepted on exact head:
+
+```text
+651af888875a0d2acababe46a4e1313532ec7ba6
+```
+
+by pull-request workflow:
+
+```text
+#1628 / 34704455179
+```
+
+That exact head passed:
+
+- Runtime Windows;
+- Runtime Linux;
+- Runtime macOS;
+- package candidate/public API freeze;
+- Package Foundation;
+- Package Presentation;
+- Package Semantic and hardening;
+- Package Stable 1.x release line;
+- validated package artifact.
+
+The accepted checkpoint includes the dedicated integration-contract tests and solution-built executable sample on `net8.0`, `net9.0`, and `net10.0`.
+
+## T1111-A — integration dependency boundary
+
+Completed. The dedicated `Icod.Terminal.TermInfoIntegration.Tests` project references `Icod.Terminal` plus `Icod.TermInfo.Inspection 1.11.0` without adding Inspection or Source to `Icod.Terminal.csproj`.
+
+Acceptance proves:
+
+- the production package graph is unchanged;
+- the integration project builds/tests on all three TFMs;
+- the project is part of normal solution/CI verification;
+- package verification continues to reject unexpected production dependencies.
+
+## T1111-B — consumer-owned live-evidence mapping
+
+Completed. The integration-only bridge maps only conclusive live Terminal status into TermInfo `PersistentRasterLifecycleEvidenceKind.Verified` assertions.
+
+Acceptance covers:
+
+- positive persistent verification;
+- verified persistent non-support;
+- ordinary raster verification;
+- no promotion of `Unknown` or `Advertised` status to `Verified` evidence;
+- endpoint unavailability remaining distinct from terminal non-support;
+- deterministic provenance labels and ordinals;
+- no protocol/backend/private-id leakage.
+
+## T1111-C — plan/verify/replan contract
+
+Completed with deterministic integration tests proving:
+
+1. an ordinary terminal description with no lifecycle declarations produces an `Indeterminate` persistent request;
+2. Terminal-owned live verification strengthens knowledge through caller-owned evidence;
+3. reclassification/replanning becomes `Success` when live support is verified;
+4. verified non-support replans to `Impossible`;
+5. a description carrying the exact Icod extended Boolean lifecycle declarations can produce a successful static plan without planning I/O;
+6. planning itself never performs terminal I/O or allocates Terminal runtime identities.
+
+## T1111-D — executable integration sample
+
+Completed under:
+
+```text
+samples/Icod.Terminal.TermInfoPersistentRaster.Sample/
+```
+
+The sample is executable architecture documentation for:
+
+```text
+selected TerminalDescription
+    -> TermInfo Inspection profile
+    -> TermInfo lifecycle request / plan
+    -> optional Terminal live verification
+    -> caller-owned Verified evidence
+    -> reclassify / replan
+    -> Terminal persistent resource
+    -> placement create/update/dispose
+```
+
+It does not expose Kitty image ids, placement ids, raw APC commands, terminal-brand tests, or backend-selection policy in its user-facing flow. When execution is unavailable or the semantic plan is not successful, it reports the semantic state and does not pretend the persistent operation ran.
+
+The solution compiles the sample for all supported TFMs; deterministic contract tests own simulated live execution coverage.
+
+## T1111-E — qualification and release closure
+
+Completed. The stable `1.11.1` release candidate advances:
+
+- repository/package version to `1.11.1` with no prerelease suffix;
+- NuGet release notes to the 1.11.1 integration contract;
+- root README installation/integration guidance;
+- final `CHANGELOG.md` 1.11.1 entry;
+- curated `docs/releases/1.11.1.md` notes;
+- dedicated release-closure record at `docs/T1111-E-1.11.1-Release-Closure.md`.
+
+The accepted stable release-candidate code/metadata head is:
+
+```text
+53ded168ae03d14e5490d290fe7730579a1456b3
+```
+
+and the qualifying pull-request workflow is:
+
+```text
+#1630 / 34705075656
+```
+
+That exact head passed:
+
+- Runtime Windows;
+- Runtime Linux;
+- Runtime macOS;
+- package candidate/public API freeze;
+- Package Foundation;
+- Package Presentation;
+- Package Semantic and hardening;
+- Package Stable 1.x release line;
+- validated package artifact.
+
+The package-candidate gate generated identical normalized public API snapshots for `net8.0`, `net9.0`, and `net10.0`, all matching the frozen fingerprint:
+
+```text
+9336a1f6def1c4b02e86db813bae27f45b95af33f47a2cf10dccd4d1d44324f2
+```
+
+Inspection of the produced `Icod.Terminal.1.11.1.nupkg` confirms every TFM dependency group contains only:
+
+```text
+Icod.TermInfo 1.11.0
+Icod.Timing   1.0.0
+```
+
+`Icod.TermInfo.Inspection` and `Icod.TermInfo.Source` are absent from the production package graph. The stable release-line package consumer and published `Icod.DCurses` hardening soak also passed on all three TFMs.
+
+This roadmap/status-only closure update contains no production code or release-metadata change. Its own pull-request workflow must pass the same matrix before PR #54 leaves draft status; no further roadmap mutation is required merely to insert that later run number.
+
+## Explicit exclusions
+
+Version 1.11.1 does **not** include:
+
+- a production dependency on `Icod.TermInfo.Inspection`;
+- a production dependency on `Icod.TermInfo.Source`;
+- new public Terminal planning/profile/evidence types;
+- direct ingestion of all eight TermInfo lifecycle dimensions into Terminal's coarse capability model;
+- an adapter NuGet package between TermInfo and Terminal;
+- changes to the persistent-raster wire protocol or runtime ownership semantics frozen by 1.11.0;
+- a table-driven rewrite of `TerminalTermInfoSemanticEvidence` unless scope is explicitly widened after maintainer review;
+- scene/window/cell/layout policy belonging to `Icod.DCurses`.
+
+## Approved future follow-up after 1.11.1
+
+The next independent internal cleanup is to table-drive `TerminalTermInfoSemanticEvidence` so exact TermInfo implementations and metadata-backed backend advertisements are described through reviewed immutable contracts instead of duplicated conditionals/switches.
+
+That work must preserve behavior, package dependencies, public API, and existing evidence semantics and should be reviewed independently from this integration patch.
+
+Static lifecycle-evidence ingestion and any adapter package remain later architectural decisions.
+
+## Release gate
+
+The repository's established progression remains:
+
+```text
+written contract
+    -> focused RED tests
+        -> minimal GREEN integration
+            -> sample/documentation closure
+                -> full Windows/Linux/macOS + package qualification
+                    -> exact-head acceptance
+```
+
+T1111-A through T1111-E are accepted. Once this status-only closure head passes the same Staging matrix, PR #54 may be marked ready for maintainer review. Merge, mainline Release validation, tag, and publication remain maintainer actions.

Icod.Terminal.csproj

@@ -39,7 +39,7 @@
 		<Title>Icod.Terminal</Title>
 		<Authors>Timothy J. Bruce</Authors>
 		<Description>Managed, cross-platform live-terminal session, endpoint, mode, input, lifecycle, and terminal-control foundation for .NET.</Description>
-		<PackageReleaseNotes>Icod.Terminal 1.11.0 adds backend-neutral persistent terminal-resident raster resources and placements through TerminalCapability.PersistentRasterGraphics, TerminalRasterResource, and TerminalRasterPlacement. It keeps Kitty protocol identities private, bounds ownership, invalidates stale terminal-resident identities instead of replaying hidden image copies, and preserves the stable 1.0 compatibility floor. Full notes: https://github.com/uniblab/Icod.Terminal/blob/main/docs/releases/1.11.0.md ; compatibility: https://github.com/uniblab/Icod.Terminal/blob/main/docs/Compatibility-and-Versioning.md</PackageReleaseNotes>
+		<PackageReleaseNotes>Icod.Terminal 1.11.1 adds the executable TermInfo 1.11 to Terminal 1.11 persistent-raster integration contract through a dedicated three-TFM contract-test project and non-packable sample. It preserves the 1.11.0 public API, persistent-raster runtime semantics, and production dependencies; Icod.TermInfo.Inspection 1.11.0 remains test/sample-only. Full notes: https://github.com/uniblab/Icod.Terminal/blob/main/docs/releases/1.11.1.md ; compatibility: https://github.com/uniblab/Icod.Terminal/blob/main/docs/Compatibility-and-Versioning.md</PackageReleaseNotes>
 		<PackageReadmeFile>README.md</PackageReadmeFile>
 		<PackageIcon>icon.png</PackageIcon>
 		<PackageProjectUrl>https://github.com/uniblab/Icod.Terminal</PackageProjectUrl>