mirror of https://github.com/openprose/prose.git synced 2026-09-19 05:55:05 +08:00

Files

T

irl-dan 63c8ce4b23 Migrate std and co into packages/ monorepo layout

Move the standard library (previously `github.com/openprose/std`) and
the company-as-prose library (previously local dir
`/Users/sl/code/openprose/company-as-prose`) into this repository
under `packages/std/` and `packages/co/` respectively.

Motivation: concentrate attention on one repository so stars,
discussions, and issues aggregate. `openprose/std` was a genuinely
useful asset nobody could find because ~50 stars on its own repo
told a much worse story than 1,106 stars on `openprose/prose`
would have. Same logic applies to co.

Layout choice: `packages/{std,co}/` rather than `std/` + `co/` at
the repo root. Root siblings accumulate over time, and a flat
top-level made future libraries (hub, kit, dev, etc.) compete with
spec infrastructure. `packages/` is bounded — new libraries land
there without cluttering root. Matches pnpm/Deno/monorepo tooling
conventions.

Changes:

- New: `packages/std/` (copied from openprose/std, `.git` excluded)
- New: `packages/co/` (copied from company-as-prose, README updated
  for new name and location)
- `packages/std/README.md`: updated shorthand expansion reference
- `packages/co/README.md`: renamed "company-as-prose" to "co" in
  self-references, added std-vs-co split heuristic, updated
  `prose run` examples to use `co/` shorthand
- `skills/open-prose/deps.md`:
  - `std/` shorthand now expands to
    `github.com/openprose/prose/packages/std/`
  - `co/` shorthand added, expands to
    `github.com/openprose/prose/packages/co/`
  - Both shorthands resolve into the same clone of
    `openprose/prose` under `.deps/github.com/openprose/prose/`;
    `packages/std/` and `packages/co/` are sibling subdirectories
  - `prose.lock` format row updated to `host/owner/repo sha`
    (matches the explicit-host resolution that landed in #35)
  - `.deps/` directory structure example redrawn to show the
    `{host}/{owner}/{repo}/packages/{std,co}/...` shape
  - Error message and Interaction tables refreshed accordingly
  - Resolution Algorithm step 1 now documents both shorthands
- `skills/open-prose/forme.md`: Step 2 resolution list updated to
  include co/ shorthand and the host-keyed `.deps/` layout
- `skills/open-prose/help.md`: Q&A "How do dependencies work?"
  rewritten to name both shorthands and the new explicit-host model
- `skills/open-prose/state/filesystem.md`: `.deps/` directory
  tree re-drawn to include the `{host}/` layer with std/co as
  sibling packages inside the clone
- `skills/open-prose/guidance/patterns.md`,
  `skills/open-prose/guidance/antipatterns.md`: examples now use
  the `std/` shorthand or explicit `github.com/...` rather than
  the deprecated bare `openprose/std/` form
- `skills/open-prose/examples/registry-import/index.md`: sample
  service reference switched to `std/evals/inspector`
- `README.md`: Stdlib badge replaced with internal `packages/std/`
  link plus new `packages/co/` link; "Standard Library" section
  rewritten as "Libraries" with both packages described

Out of scope for this PR (deliberately):
- Tooling changes to `prose install` and Forme's `.deps/` writer
  to adopt the `{host}/{owner}/{repo}/` layout in practice — this
  PR is spec-only. Existing tooling continues to work against
  whatever layout it currently implements; the spec now describes
  the target.
- Retiring the `openprose/std` GitHub repo. Delete that repo
  separately after this merges.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-04-21 14:14:31 -07:00

2.4 KiB

Raw Permalink Blame History

name, kind

name	kind
fan-out	composite

Fan-Out

Parallel delegation without reduction. Send briefs to N delegates, collect all results. The parent decides how to use them.

Metadata

version: 0.1.0
role: coordinator

Runtime

state.reads: &controlState
state.writes: &controlState

Slots

delegates

Shape

self: dispatch briefs to delegates in parallel, collect all results, return collection
delegates:
- delegate_1..delegate_N: execute assigned brief
prohibited: merging or synthesizing results — that is the parent's job

Requires

&controlState exists at __controlState with: delegates: string[] -- component names for each delegate briefs: string[] -- one brief per delegate (same length as delegates) OR a single string applied to all delegates

Ensures

Each delegate receives exactly one brief
All delegates execute in parallel
No delegate knows other delegates exist
Results are returned as an ordered array matching the input delegates
No merging or synthesis — the raw results are the output
&controlState.result contains the array of all delegate outputs
&controlState.results contains the same array (keyed alias)

Delegation

const { delegates, briefs, task_brief } = __controlState;

// Normalize briefs: single string broadcasts to all, array maps 1:1
const briefList = Array.isArray(briefs)
  ? briefs
  : delegates.map(() => briefs || task_brief);

// All delegates run in parallel
const results = await Promise.all(
  delegates.map((delegate, i) => {
    return rlm(briefList[i], null, { use: delegate });
  })
);

__controlState.result = results;
__controlState.results = results;
return(results);

Notes

No delegate knows other delegates exist. Each receives a brief and returns a result. The fan-out control collects results but does not interpret them — interpretation is the parent's responsibility.

Different from map-reduce: map-reduce includes a reducer that merges results into a single output. Fan-out returns the raw collection. Use fan-out when the parent needs to see all results individually (e.g., to compare, to select, to present side-by-side). Use map-reduce when the goal is a single merged artifact.

Different from race: fan-out waits for ALL delegates. Race returns the FIRST acceptable result and cancels the rest.

2.4 KiB Raw Permalink Blame History