Create a StarIntel actor
Goal
Create an actor in the runtime that actually owns the requested execution boundary.
Requires current lost-rob0t/star-lang and StarIntel server repositories.
Input
The actor's purpose, inputs, outputs, effects, deployment target, state/lifecycle requirements, and failure semantics.
Output
An executable actor plus contract tests, registration/startup wiring, and a matching manifest or canonical record when required.
Choose the runtime
- Use final
starlang-runtime for deterministic local Common Lisp actors.
- Use a
starintel-server Common Lisp plugin actor when it must run inside the production Sento actor system or consume the current RabbitMQ target flow.
- Use
create-external-actor only to register an external boundary; current final Star-Lang does not yet dispatch it.
- An Auto-Dig
actor-manifest document describes an actor. It does not instantiate or deploy one.
Read references/runtime-boundaries.md for the current implementation split.
Workflow
- Inspect the current runtime's repository instructions, exported packages, tests, and one maintained actor with the same deployment model.
- Define one stable name and canonical
star://<domain>:<address>:<actor> URI whose actor component matches the name.
- Define accepted and produced message contracts, validators, mailbox capacity, state ownership, restart policy, capabilities, and effect ports.
- Keep network, process, storage, and broker effects behind explicit adapters; keep message/state transitions deterministic.
- Implement one canonical handler and registration path. Remove obsolete duplicate paths encountered in scope.
- Add tests for registration, happy path, invalid input/output, mailbox bounds, state rollback, handler failure, restart/generation, shutdown, and the real adapter boundary used.
- Wire startup only through the runtime's maintained hook or composition root.
- Run focused ASDF tests and the complete owning repository gate.
Rules
- Do not call a manifest, package shell, or registered external reference an executing actor.
- Do not add a second parser, dispatcher, mailbox, or transport path beside the current authority.
- Stable actor identity and runtime instance/generation are different values.
- Document actual supported behavior; keep prototype-only or unavailable operations explicit.
1---2name: starintel-actor-create3description: starintel, actors, star-lang, sento, plugins, manifests, testing4---56# Create a StarIntel actor78## Goal910Create an actor in the runtime that actually owns the requested execution boundary.1112Requires current `lost-rob0t/star-lang` and StarIntel server repositories.1314## Input1516The actor's purpose, inputs, outputs, effects, deployment target, state/lifecycle requirements, and failure semantics.1718## Output1920An executable actor plus contract tests, registration/startup wiring, and a matching manifest or canonical record when required.2122## Choose the runtime23241. Use final `starlang-runtime` for deterministic local Common Lisp actors.252. Use a `starintel-server` Common Lisp plugin actor when it must run inside the production Sento actor system or consume the current RabbitMQ target flow.263. Use `create-external-actor` only to register an external boundary; current final Star-Lang does not yet dispatch it.274. An Auto-Dig `actor-manifest` document describes an actor. It does not instantiate or deploy one.2829Read [references/runtime-boundaries.md](references/runtime-boundaries.md) for the current implementation split.3031## Workflow32331. Inspect the current runtime's repository instructions, exported packages, tests, and one maintained actor with the same deployment model.342. Define one stable name and canonical `star://<domain>:<address>:<actor>` URI whose actor component matches the name.353. Define accepted and produced message contracts, validators, mailbox capacity, state ownership, restart policy, capabilities, and effect ports.364. Keep network, process, storage, and broker effects behind explicit adapters; keep message/state transitions deterministic.375. Implement one canonical handler and registration path. Remove obsolete duplicate paths encountered in scope.386. Add tests for registration, happy path, invalid input/output, mailbox bounds, state rollback, handler failure, restart/generation, shutdown, and the real adapter boundary used.397. Wire startup only through the runtime's maintained hook or composition root.408. Run focused ASDF tests and the complete owning repository gate.4142## Rules4344- Do not call a manifest, package shell, or registered external reference an executing actor.45- Do not add a second parser, dispatcher, mailbox, or transport path beside the current authority.46- Stable actor identity and runtime instance/generation are different values.47- Document actual supported behavior; keep prototype-only or unavailable operations explicit.