Marshal belongs under Pueblo because Pueblo is the Adobe craft district: the place where Photoshop, Desk, Xtools, JSX, Acrobat-facing projection, and image/container craft are explained as a coherent production world. Marshal is not a side document beside Pueblo. It is a sub-Pen inside Pueblo because Marshal is the portable vessel form that lets Pueblo craft travel.
The Marshal Plan establishes how a PSD can become a portable operational object. It may carry a RunTree in XMP, attach or reference supporting material, preserve enough context for restartability, and provide Desk/JSX/Photoshop with a current resident target. The image is not just art. It is also a vessel.
This document is delivered as Marshal.html.773. The prior 771 attempt is not repaired. It is superseded. Ordination doctrine requires forward motion: when an issued ordinal is wrong, the answer is the next ordination, not a corrected pocket under the same witness.
The live file remains Marshal.html. The audit file remains Marshal.html.773. The source delivery pocket remains pocket773/Pueblo/Marshal.html.773.
Pueblo already states the essential craft laws: Photoshop is an actuator, Desk is the compiler, Pueblo is the craft, and persistence lives outside JSX. Marshal does not overturn those laws. It gives them a portable vessel.
| Actor | Marshal relationship |
|---|---|
| FireDance / F:ire | Orchestrates, watches, provisions, and resumes movement. It remains the interpreter/execution world. |
| Desk | Compiles intent into one-shot Photoshop actions and can read/write Marshal state through defined interfaces. |
| Photoshop | Acts on the resident PSD. It is not the system of record, but the current Marshal may be the vessel being acted upon. |
| Xtools / P:xto | Provides field tools and callable Photoshop-side routines that can be wrapped by Desk or invoked through Pueblo craft law. |
| A:gent | Observes, explains, repairs, and guides Marshal-bearing workflows when a branch needs rescue or interpretation. |
A Marshal PSD is the portable deployment vessel for a branch of work. It can contain the visible image, the layer structure, XMP metadata, embedded or attached references, and the RunTree fragment that tells the system where the object stands and what it can do next.
Marshal PSD visible composition Photoshop layers XMP-contained tree field Yml-safe encoded XML / RunTree fragment references to packages, Office/PDF/SQLite payloads current route and recovery state
The vessel idea matters because it converts a Photoshop document from a passive output into an operational carrier. A client can receive a Marshal and begin from a living plan rather than from a static art file.
The XMP field is treated like a drive embodiment. It is not a casual comment dump. It is a contained tree surface. Because Yml mapping can preserve XML-valid names and attributes, the RunTree can carry meaningful mantle names, route hints, proc/status state, and queue or recovery markers without forcing the PSD itself to understand every external system.
This is why Marshal belongs in the same strategic family as WebDAV, B:ase, Zipool, and S:end. Each is a way for the Tree to appear in a different embodiment. Marshal is the PSD/XMP embodiment.
Only one Marshal from a particular tree directory should be treated as resident at a time. The resident Marshal gives Photoshop-side operations a stable target. JSX does not have to discover the universe every time; it can operate through a known current vessel.
tree directory
current resident Marshal.psd
Desk compiles
JSX acts
Photoshop changes layers
FireDance observes results
Marshal XMP carries state forward
This is what prevents the old “robot script has to do it all right now” problem. Work can be deposited, polled, resumed, copied, or redirected because the vessel has state and address.
Marshal is a restartability device. The PSD can be moved, copied, handed off, sent to a client, returned, or routed through a different machine while retaining enough structured state to know what it is and what should happen next.
- Failed action can leave status rather than losing meaning.
- Recovery can occur from the vessel rather than from memory of a conversation.
- A:gent can inspect the branch, report what is wrong, and recommend the next safe action.
- FireDance can resume from visible file/state surfaces instead of hidden process state.
The Marshal Plan allows the PSD to carry or coordinate more than pixels. It can organize the practical payload universe surrounding a job.
| Payload type | Marshal role |
|---|---|
| JSX / Desk instructions | Stored or referenced as the next executable plan. |
| Office / Excel | Attached or referenced for tabular, pricing, order, or production data. |
| SQLite | Self-contained data packet for portable job state or local application structure. |
| Projected outward through X:pdf as a delivery/container artifact. | |
| Images and rasters | Native Photoshop layer assets or external support files. |
The direction is important: the PSD/Marshal world remains the authority, while PDF and other external documents are often projections from that authority rather than the source of it.
A Marshal can travel. That is the point of the plan. A Marshal can be transferred to another node, copied into another hierarchy, delivered to a client, or used as a broadcast vessel for a set of related operations.
The location of the Marshal gives operations both source and destination. Different Marshals at different hierarchy nodes can be copied between, compared, or used to route instructions and results.
Pueblo craft → Marshal vessel → client Photoshop / local FireDance / cloud-facing branch → returned or synchronized state → A:gent inspection and next instruction
The Marshal Plan can support capability-style security without pretending that secrecy must hide everything. Much of a payload can be visible while the next valid capability, key, route, or token remains protected and rotating.
At the doctrine level, the key point is not to describe covert mechanics. The key point is that authorization should be treated as current capability, not as a permanent static secret.
Marshal is deeply tied to the mantle grammar now used across PhoMaster. The relevant neighbors are:
- P:ho for vessel/package identity.
- P:kgs for package surfaces and carried payload groups.
- P:xto for xtools and Photoshop field tools.
- X:tre for tree projection and tree impact.
- X:pdf for PDF projection from the Marshal authority.
- F:run for runtime execution in FireDance/Robot/Bin territory.
- A:way / A:see / A:do for agent steering, observation, and action.
The route may be native, proxy, or venting. If a mantle can wisely pass a request toward a better final destination, it may do so. If observation says no, it should return eson rather than pretending to continue.
Marshal is not merely P:ho doctrine because the working body is Adobe-centered. It is a Photoshop PSD plan. It involves layer organization, XMP, JSX, Desk, Xtools, Acrobat/PDF projection, and Adobe operation. Pueblo is therefore the right Pen home.
That does not mean Pueblo owns every future Marshal. It means Pueblo owns the craft doctrine for how the Adobe-world Marshal is built, edited, acted upon, and projected.
The Marshal Plan should now grow toward implementation in stages:
- Define the XMP/Yml field layout used to carry the RunTree fragment.
- Define the current-resident Marshal rule for Photoshop sessions.
- Define Desk interfaces for reading and writing Marshal state.
- Define Xtools wrappers that are safe in Photoshop 27.2+ and Pueblo-class execution.
- Define X:pdf projection from Marshal PSD into outward PDF artifacts.
- Define A:gent inspection and remediation prompts for Marshal-bearing jobs.
- Define S:end and Zipool carriage where Marshal-related payloads need delivery or publication.