Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
69 changes: 64 additions & 5 deletions docs/apps-module-migrations.json
Original file line number Diff line number Diff line change
Expand Up @@ -21,9 +21,9 @@
"docs/module-layout.md",
"docs/operations.md",
"src/inferrsi/apps/api.py",
"src/inferrsi/apps/bridge.py",
"src/inferrsi/apps/candidate_provider.py",
"src/inferrsi/apps/delivery/__init__.py",
"src/inferrsi/apps/handoff/bridge.py",
"src/inferrsi/apps/handoff/candidate_provider.py",
"src/inferrsi/apps/storage/artifact_reader.py",
"src/inferrsi/apps/views/attempt.py",
"tests/check_installed.py",
Expand All @@ -50,7 +50,7 @@
"docs/module-layout.md",
"docs/operations.md",
"src/inferrsi/apps/api.py",
"src/inferrsi/apps/candidate_provider.py",
"src/inferrsi/apps/handoff/candidate_provider.py",
"src/inferrsi/apps/views/attempt.py",
"tests/check_installed.py",
"tests/test_apps_artifact_reader.py",
Expand All @@ -77,9 +77,9 @@
"docs/module-layout.md",
"docs/operations.md",
"src/inferrsi/apps/api.py",
"src/inferrsi/apps/bridge.py",
"src/inferrsi/apps/candidate_provider.py",
"src/inferrsi/apps/delivery/adapters.py",
"src/inferrsi/apps/handoff/bridge.py",
"src/inferrsi/apps/handoff/candidate_provider.py",
"src/inferrsi/apps/storage/archive.py",
"src/inferrsi/apps/storage/artifact_reader.py",
"src/inferrsi/apps/views/attempt.py",
Expand Down Expand Up @@ -108,5 +108,64 @@
"tests/test_first_wave_isolation_policy.py",
"tests/test_repository_packs_facade.py"
]
},
{
"old": "inferrsi.apps.bridge",
"canonical": "inferrsi.apps.handoff.bridge",
"exports": [
"execution_fields",
"verify_protocol",
"check_assessment_identity",
"bind_execution",
"to_evidence"
],
"consumers": [
"docs/apps-output.md",
"docs/architecture.md",
"docs/module-layout.md",
"docs/operations.md",
"src/inferrsi/apps/api.py",
"src/inferrsi/apps/handoff/candidate_provider.py",
"src/inferrsi/apps/views/attempt.py",
"tests/check_installed.py",
"tests/test_apps_evidence.py",
"tests/test_apps_execution_binding.py",
"tests/test_apps_generation_plan.py",
"tests/test_apps_module_migrations.py"
]
},
{
"old": "inferrsi.apps.context_provider",
"canonical": "inferrsi.apps.handoff.context_provider",
"exports": [
"DeliveredContextDraft",
"ContextProvider"
],
"consumers": [
"docs/apps-output.md",
"docs/architecture.md",
"docs/module-layout.md",
"docs/operations.md",
"tests/check_installed.py",
"tests/test_apps_context_provider.py",
"tests/test_apps_module_migrations.py",
"tests/test_harness_generation_seal.py"
]
},
{
"old": "inferrsi.apps.candidate_provider",
"canonical": "inferrsi.apps.handoff.candidate_provider",
"exports": [
"CandidateProvider"
],
"consumers": [
"docs/apps-output.md",
"docs/architecture.md",
"docs/module-layout.md",
"docs/operations.md",
"src/inferrsi/apps/api.py",
"tests/check_installed.py",
"tests/test_apps_module_migrations.py"
]
}
]
7 changes: 7 additions & 0 deletions docs/apps-output.md
Original file line number Diff line number Diff line change
Expand Up @@ -134,6 +134,13 @@ deadline. OperationRecipe v1 has no per-step timeout, so the step timeout
is null. The expected worker code digest comes from the fixed recipe.
The bound spec is handed to the host-supplied Harness execution port.

`inferrsi.apps.handoff.bridge` owns that binding and the fixed evidence
projection. `handoff.context_provider` delivers Knowledge bytes for Harness to
seal, and `handoff.candidate_provider` owns generation planning and candidate
collection. `inferrsi.apps.api.CandidateProvider` exports the same canonical
class. The three former Apps modules retain their registered public exports;
the original attempt, public port signatures and fixed references are unchanged.

## Fixed artifact reader

`inferrsi.apps.storage.artifact_reader.ArtifactReader(storage_config)` implements
Expand Down
4 changes: 4 additions & 0 deletions docs/architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -190,6 +190,10 @@ src/inferrsi/
__init__.py Import-free initializer
repository_packs.py Neutral REPO_TYPES and pack.json reader; imports no inferrsi module
apps/
handoff/
bridge.py Bind preparations to specs and fixed records to evidence
context_provider.py Deliver Knowledge bytes and pins for Harness sealing
candidate_provider.py Plan generation and collect fixed candidate outputs
storage/
archive.py Immutable preparations/assessments and manifest.json/result.json
artifact_reader.py Read verified artifacts through authorized mounts
Expand Down
21 changes: 19 additions & 2 deletions docs/module-layout.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,8 +41,25 @@ through these exports; new pickles use the canonical definition. The retired
root `inferrsi.evidence_paths` has no alias and remains unavailable.

Shim removal requires a separate reviewed PR recording consumer migration,
wheel and plugin validation, and the first removal version. Handoff, workflows
and integrations remain subsequent #490 slices.
wheel and plugin validation, and the first removal version. Workflows,
integrations and integrated acceptance remain subsequent #490 slices.

### Apps handoff migration

`apps/handoff/bridge.py` binds fixed preparations to execution specifications
and projects saved records into evidence. `context_provider.py` delivers actual
Knowledge bytes and pins for Harness sealing. `candidate_provider.py` plans
generation and collects candidates from fixed Harness records. These modules
consume `apps/storage/`; storage never imports back into handoff.

The three former Apps paths retain explicit public exports recorded in the
[migration inventory](apps-module-migrations.json). `apps.api.CandidateProvider`
and the former provider module export the one class defined in
`apps/handoff/candidate_provider.py`. `EvaluationPort` remains defined in
`apps/api.py`. The handoff initializer imports nothing, and importing either
path performs no Knowledge reads, device probes, process launches or service
registration. Harness owns the sealed context, original attempt and request
digest; these ownership boundaries and DTOs remain unchanged.

### Core and technical packages

Expand Down
4 changes: 4 additions & 0 deletions docs/operations.md
Original file line number Diff line number Diff line change
Expand Up @@ -357,6 +357,10 @@ creation helper is `inferrsi.apps.storage.evidence_layout.ensure_evidence_layout
The CLI entry remains `inferrsi.apps.cli:main`. See the
[output contract](apps-output.md) and [migration inventory](apps-module-migrations.json)
for the retained old Apps imports and canonical storage paths.
`inferrsi.apps.handoff.bridge`, `handoff.context_provider` and
`handoff.candidate_provider` implement execution/evidence binding, context
delivery and generation handoff. The API still exports the one canonical
`CandidateProvider`; `EvaluationPort` remains defined in `apps.api`.

### Inspect/prepare — `doctor`, `plan`, `--dry-run`

Expand Down
11 changes: 8 additions & 3 deletions src/inferrsi/apps/api.py
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,14 @@
from inferrsi.harness.errors import PublicError
from inferrsi.harness.execution_spec import request_digest

from .bridge import bind_execution as _bind_prepared_execution
from .bridge import check_assessment_identity, execution_fields, to_evidence, verify_protocol
from .candidate_provider import CandidateProvider as CandidateProvider
from .handoff.bridge import bind_execution as _bind_prepared_execution
from .handoff.bridge import (
check_assessment_identity,
execution_fields,
to_evidence,
verify_protocol,
)
from .handoff.candidate_provider import CandidateProvider as CandidateProvider
from .storage.archive import (
ResourceReader,
RunOutput,
Expand Down
Loading
Loading