[EPIC][cyber-harness] Generic Prolog-RLM cyber reasoning harness for Hackmode/Hackpert #409
Labels
No labels
bug
documentation
duplicate
enhancement
good first issue
help wanted
invalid
question
wontfix
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
nsaspy/prolog-rlm#409
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Mission
Build the generic Prolog-RLM harness contract needed by Hackmode/Hackpert for cyber reasoning, while preserving the canonical repository boundary in #141.
This is the upstream half of
lost-rob0t/hackmode#28.The target is not to move Hackmode, Hackpert, cyber tools, target state, Tek9, LISH, or operation authority into
prolog-rlm. The target is to makeprolog-rlmexpose a complete reusable reasoning/expert/session interface that Hackmode can consume as its symbolic / recursive / generative reasoning tier.Dependency direction remains:
prolog-rlmmust not import or depend on Hackmode product code.Existing authorities to reuse
direct,symbolic,symbolic-recursive,auto.lost-rob0t/hackmode#24— Hackpert expert layer over canonical Hackmode state.lost-rob0t/hackmode#27— Hackpert active typed action/state-delta orchestration.lost-rob0t/hackmode#29— open objective loop; authority mode is orthogonal to reasoning strategy.lost-rob0t/hackmode#28— downstream Prolog-RLM generative/escalation integration.Do not create another scheduler, provider runtime, capability model, authority plane, effect ledger, verifier stack, or model history.
Critical semantic split
Hackmode already has two independent axes. Preserve them exactly.
Host authority — owned by Hackmode
passivemeans reasoning/inspection only.activemeans Hackmode may admit typed effects through its own scope/capability/provider/state boundary.Reasoning strategy — owned by Prolog-RLM
A strategy switch is never an authority change.
Examples:
Moving from symbolic to direct or recursive reasoning must not grant a tool, widen target scope, mutate Hackmode state, or bypass Hackmode's active-effect admission.
Canonical flow
The model never directly owns the Hackmode effect path.
Track A — first-class host harness/session contract
Expose a reusable host-facing boundary sufficient for a non-Prolog product such as Common Lisp Hackmode to create and drive a Prolog-RLM run without reimplementing runtime semantics.
The boundary should support semantics equivalent to:
Exact API/transport follows current repository conventions. Prefer the canonical machine/runtime protocol and public library APIs; do not add a Hackmode-only wire protocol if the generic one can be extended.
Stable run/session/correlation identities are required.
Track B — host capability adapter contract
A downstream host must be able to expose typed capabilities to Prolog-RLM while keeping concrete implementations downstream.
Required invariants:
Hackmode owns concrete recon, browser, fuzzing, capture, network, provider, mutation, and persistence implementations.
Track C — cyber expert/profile composition without cyber authority in core
The core should support a host-defined cyber expert/profile catalog using #376's generic expert contract rather than hard-coding exploit logic into the runtime.
A downstream profile should be able to register expert roles such as:
Those names are examples of downstream registrations, not a fixed core ontology.
Core owns selection/invocation/explanation mechanics. Hackmode owns the actual cyber facts, expert rule packs, target semantics, operation policies, and executable cyber capabilities.
Track D — Hackpert reasoning-mode convergence
Make
lost-rob0t/hackmode#29/#28able to adapt cleanly to #335 instead of maintaining a second incompatible reasoning-mode enum.Required mapping direction:
The integration must expose requested/effective mode and selection reason to Hackmode so LISH can explain transitions.
Symbolic-first / direct-fallback policy may be a Hackmode policy over the generic core modes; it must not require a forked Prolog-RLM runtime.
Track E — bounded graph/KB/context projection
Hackmode must be able to provide operation knowledge without giving Prolog-RLM direct Tek9 authority.
Support reusable typed projections/references for:
Large context should use existing external-context/retrieval mechanisms rather than flattening the entire Hackmode graph into one model prompt.
Prolog-derived conclusions must remain distinguishable from host-observed evidence.
Track F — explicit generative fallback
Support Hackmode's intended escalation use from
hackmode#28:Requirements:
Track G — verification and objective preservation
Hackmode's objective/SPEC is the definition of success. Reasoning mode changes, recursion, model fallback, or repair cannot rewrite it to manufacture completion.
The harness must allow downstream domain-specific verification while using the generic Spec/Verify/evidence contract.
Final success requires fresh evidence satisfying the unchanged Frozen Spec/objective. Model prose is not proof.
Track H — deterministic cyber-harness conformance fixture
Add a synthetic/local fixture, not a real-world target, proving the host contract end to end.
Fixture should model a tiny operation with:
No Internet access or external target is required for the core conformance test.
Acceptance
prolog-rlmhas one generic host harness/session surface sufficient for Hackmode without importing Hackmode code.passive|activeauthority remains orthogonal todirect|symbolic|symbolic-recursive|autoreasoning.Downstream integration acceptance (
lost-rob0t/hackmode)This upstream epic is complete only when Hackmode can consume the public contract to advance
hackmode#28without a private duplicate Prolog runtime protocol.At minimum the downstream proof should show:
Product UI, concrete cyber providers/tools, Tek9 mutation, StarLang actor topology, operation storage, and LISH command implementation remain downstream Hackmode work.
Migration / issue reconciliation
lost-rob0t/hackmode#24,#27, and#29remain current downstream architecture and should not be replaced by this epic.lost-rob0t/hackmode#28becomes the downstream integration counterpart and should be updated/cross-linked to this epic.Non-goals
prolog-rlm.First implementation slice
Before coding, inspect current public machine/library interfaces and #335/#376/#387 exact-head implementation state. Then TDD the smallest generic host-run + capability request/result round trip needed by Hackmode, using a deterministic in-process or fixture host adapter.
Do not start by adding cyber-specific tools.
No harness will live in hackmode.
No hackmode front-end code will live here.
Prog rlm is simply a langraph, rlm, langchain in prolog with symbolic reasoning provided for consumers of this flake.
ZeroForge public symbolic-port track
lost-rob0t/hackmode#190now explicitly authorizes the public symbolic reimplementation of useful ZeroForge behavior inside Hackmode/Hackpert.Reusable private/reference-semantics -> public symbolic artifact machinery is tracked in #390.
#389 remains the generic cyber host/session/capability harness. Do not add a ZeroForge-specific runtime protocol here; ZeroForge-derived behavior should arrive as ordinary expert/rule/plan/verification artifacts composed through #376/#390 and consumed by Hackmode through this harness.