Skip to content
Closed
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
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
2 changes: 1 addition & 1 deletion apps/docs/docs/devtool/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,7 @@ The DevTool remembers the last session you had open under each copy and offers i

### Opening a session from a link

Add `?session=<id>` to the DevTool's address to open one session directly, for example `http://localhost:4200/?session=dsx_8f1c…`. A tool that knows which run you care about can link straight to it this way; App Lab's *Open trace* does.
Add `?session=<id>` to the DevTool's address to open one session directly, for example `http://localhost:4200/?session=dsx_8f1c…`. A tool that knows which run you care about can link straight to it this way; shift-manager's *Open trace* does.

The DevTool reads the session, finds the flow copy that owns it, and opens both. If no listed copy owns it, it belongs to another user, or the server refuses the read, nothing opens and the header says why. The link only works against a DevTool that talks to the server holding that session, so a Lab with in-memory stores has to be served by the same process.

Expand Down
4 changes: 2 additions & 2 deletions docs/atlas/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ issue identifiers; anything under `apps/docs/` is published and may not.
## Contents

- `conductor.html` — encyclopedia of the old Conductor run. D-12 retired the
product name; DevForce and Pentest Lab are sibling Labs on Workforce. Product lock lives on the
product name; DevTeam and Pentest Lab are sibling Labs on Workforce. Product lock lives on the
Workforce atlas.
- `framework.html` — the framework architecture atlas: every package and
system in `@flow-state-dev`, how they compose, and the open refactor
Expand All @@ -29,7 +29,7 @@ issue identifiers; anything under `apps/docs/` is published and may not.
map; skills and boards share one name → `BlockDefinition` list.
W3 grows the file-convention surface (kinds + blocks scan as the code
door). `defineAgent` / `materializeAgent` are invent-kill / placeholder —
do not teach them as the path. DevForce (software eng) and Pentest Lab
do not teach them as the path. DevTeam (software eng) and Pentest Lab
(FIX-1355) are sibling consumer Labs on this surface (D-12) — neither is
hosted; do not supersede thin-pentest. Pentest's proof has landed as
`goals/pentest-lab/` and re-runs; that is evidence, not an application.
Expand Down
6 changes: 3 additions & 3 deletions docs/atlas/conductor.html
Original file line number Diff line number Diff line change
Expand Up @@ -228,7 +228,7 @@ <h1>Drive this project with the thing we're building</h1>
<span><span class="tag t-real">exists &middot; lab</span> shipped on main under <code>labs/conductor</code>; not yet a framework block</span>
</div>
<p class="sib">Two names collide on this page, and every use keeps them apart. The board's <code>dispatcher: "topological"</code> is an ordering <em>strategy</em> (exists); the <code>dispatcher()</code> of section 6 is a block <em>factory</em>, and it exists. This page's <code>inbox/**</code> is the <em>question collection</em>; the dispatch-protocol design's &#8220;one inbox per flow&#8221; is the <em>typed entry set</em>.</p>
<p class="sib">Workforce is the Layer&nbsp;2 product. The product name Conductor is <strong>retired</strong>; this page is the encyclopedia of the old run. DevForce and Pentest Lab are sibling Labs on Workforce &#8212; neither hosted, and neither a sibling product. The lock lives on the <a href="workforce.html#conductor">Workforce atlas &#167;16</a>. Do not grow Conductor-only surfaces that skip Workforce (park the #1612 console half).</p>
<p class="sib">Workforce is the Layer&nbsp;2 product. The product name Conductor is <strong>retired</strong>; this page is the encyclopedia of the old run. DevTeam and Pentest Lab are sibling Labs on Workforce &#8212; neither hosted, and neither a sibling product. The lock lives on the <a href="workforce.html#conductor">Workforce atlas &#167;16</a>. Do not grow Conductor-only surfaces that skip Workforce (park the #1612 console half).</p>
</header>

<section id="what">
Expand Down Expand Up @@ -1724,7 +1724,7 @@ <h3>Per board</h3>

<div class="note">
<span class="lbl">Workforce is the product. Conductor is the old-run name</span>
<p>Supersedes the older &#8220;harness to drive / layer to choose / stay separate tracks&#8221; note. Workforce is the Layer&nbsp;2 product. The product name Conductor is retired. DevForce and Pentest Lab are sibling Labs on that product &#8212; neither hosted. One harness-manager stack &#8212; <code>@flow-state-dev/harness-manager</code>. Do not grow a Conductor-only path beside Workforce. Lock and retired-name claims: <a href="workforce.html#conductor">Workforce atlas &#167;16</a>. Demo nouns: <a href="workforce.html#lab">&#167;03</a>.</p>
<p>Supersedes the older &#8220;harness to drive / layer to choose / stay separate tracks&#8221; note. Workforce is the Layer&nbsp;2 product. The product name Conductor is retired. DevTeam and Pentest Lab are sibling Labs on that product &#8212; neither hosted. One harness-manager stack &#8212; <code>@flow-state-dev/harness-manager</code>. Do not grow a Conductor-only path beside Workforce. Lock and retired-name claims: <a href="workforce.html#conductor">Workforce atlas &#167;16</a>. Demo nouns: <a href="workforce.html#lab">&#167;03</a>.</p>
<p>What remains open on this page is mechanical, not product: if a role block needs an agent materialized, somebody writes the <code>MaterializeAgentFn</code>, and where <em>that</em> implementation lives is the question to ask with the first real role block in front of us (thread 11). That is implementer, not a sibling-ship fork.</p>
</div>
</section>
Expand Down Expand Up @@ -2061,7 +2061,7 @@ <h5>10 &middot; Nothing measures the criterion</h5>

<div class="tension">
<h5>11 &middot; Which layer of workforce do Conductor&#8217;s roles sit on?</h5>
<p><strong>Product fork closed, and the mechanical half has closed too &#8212; by deletion.</strong> Workforce is the product; the name Conductor is retired. DevForce and Pentest Lab are sibling Labs on Workforce, not sibling ships. See <a href="workforce.html#conductor">Workforce atlas &#167;16</a>.</p>
<p><strong>Product fork closed, and the mechanical half has closed too &#8212; by deletion.</strong> Workforce is the product; the name Conductor is retired. DevTeam and Pentest Lab are sibling Labs on Workforce, not sibling ships. See <a href="workforce.html#conductor">Workforce atlas &#167;16</a>.</p>
<p>This thread used to ask where <code>materializeAgent</code> should live, and surveyed a wrapper &#8212; <code>agentBlock</code> over <code>materializeAgent</code> over <code>createAgentRegistry</code>, with <code>defineAgent</code> beside them. <strong>None of that ships any more.</strong> FIX-1344 removed <code>defineAgent</code>, <code>createAgentRegistry</code>, <code>materializeAgent</code> and <code>agentBlock</code> from <code>@flow-state-dev/workforce</code> (<code>packages/workforce/CHANGELOG.md</code>), and with them <code>materialize-agent.ts</code>, <code>resolve-persona.ts</code> and <code>resolveAgentPersona</code>. So the question is not which layer to take the wrapper from. There is no wrapper.</p>
<p>What the survey got right survived the deletion, which is worth keeping rather than discarding with the rest. The pieces it identified as the useful core do live in <code>@flow-state-dev/orchestration</code> and always did: <code>workerInputSchema</code> and <code>buildUserMessage</code> in <code>packages/orchestration/src/skills/worker-materializer.ts</code>, <code>taskTools</code> in <code>task-tools-capability.ts</code>. The persona types <code>PersonaSource</code> and <code>PersonaInlineConfig</code> live in <code>@flow-state-dev/core</code> (<code>packages/core/src/types/agent.ts</code>). And materializing a role as a block is now a <strong>seam a host fills</strong> rather than a function a package exports: <code>MaterializeAgentFn</code> is a type in core, orchestration's <code>materializeWorker</code> takes one injected, and no package in this repo implements it.</p>
<p><strong>Resolved, though not by either fork winning.</strong> The leaning recorded here was &#8220;move the agent-as-block piece down into orchestration&#8221;; what happened instead is that the piece was deleted and the injection point kept. A role block in this design therefore adopts neither package for this purpose &#8212; which is the outcome the leaning was reaching for, arrived at by subtraction. What workforce ships instead is the seat factory: <code>hireWorkforce</code> over <code>WORKER.md</code> records, plus <code>defineAgentWorkerFlow</code> for the built-in kind.</p>
Expand Down
6 changes: 3 additions & 3 deletions docs/atlas/framework.html
Original file line number Diff line number Diff line change
Expand Up @@ -663,7 +663,7 @@ <h3>One request, all the way down</h3>

<section id="workforce-layer">
<div class="sec-head"><span class="sec-num">04</span><h2>Workforce: the Layer 2 product, not a Layer 1 type</h2></div>
<p class="lede">Workforce is the shippable Layer&nbsp;2 product — roster / teams + seats + channels + thin helpers. DevForce (software eng) and Pentest Lab (FIX-1355) are sibling consumers on it (D-12), not sibling ships — <a href="workforce.html#lab">Workforce atlas &#167;03</a>. The package hires file-declared workers into flow instances, supplies the built-in agent worker kind, loads resources and skills, and opens channels. It does not provide an Agent factory. The product lock and the honesty tags live on the <a href="workforce.html">Workforce atlas</a>. Channels are L2 — one roster (system + helper-minted), Collab later, not W2 — <a href="workforce.html#collab">Workforce atlas &#167;14</a>. When DM / channel vs dispatch: <a href="workforce.html#when">Workforce atlas &#167;08</a>. W3 is the file-convention surface (kinds + blocks scan as the code door; seats stay <code>WORKER.md</code>) — <a href="workforce.html#vision">Workforce atlas &#167;03</a> / <a href="workforce.html#doors">&#167;04</a>. Do not mint Team / Channel / MessageBoard here, and do not fold Workforce into core.</p>
<p class="lede">Workforce is the shippable Layer&nbsp;2 product — roster / teams + seats + channels + thin helpers. DevTeam (software eng) and Pentest Lab (FIX-1355) are sibling consumers on it (D-12), not sibling ships — <a href="workforce.html#lab">Workforce atlas &#167;03</a>. The package hires file-declared workers into flow instances, supplies the built-in agent worker kind, loads resources and skills, and opens channels. It does not provide an Agent factory. The product lock and the honesty tags live on the <a href="workforce.html">Workforce atlas</a>. Channels are L2 — one roster (system + helper-minted), Collab later, not W2 — <a href="workforce.html#collab">Workforce atlas &#167;14</a>. When DM / channel vs dispatch: <a href="workforce.html#when">Workforce atlas &#167;08</a>. W3 is the file-convention surface (kinds + blocks scan as the code door; seats stay <code>WORKER.md</code>) — <a href="workforce.html#vision">Workforce atlas &#167;03</a> / <a href="workforce.html#doors">&#167;04</a>. Do not mint Team / Channel / MessageBoard here, and do not fold Workforce into core.</p>

<h3>What exists</h3>
<p><code>core</code> declares the thin <code>Agent</code> and <code>AgentRegistry</code> extension contracts used by skills delegation. Applications using an <code>agent-ref</code> skill supply the registry and materializer. <code>@flow-state-dev/workforce</code> does not export <code>defineAgent</code>, <code>createAgentRegistry</code>, <code>materializeAgent</code>, or <code>agentBlock</code>. Its workers are generators or flows with instructions, a model, and tools; its seats are flow instances. See the <a href="workforce.html#fence">Workforce atlas &#167;04</a>.</p>
Expand Down Expand Up @@ -749,7 +749,7 @@ <h3>What "a team" would mean, given what already exists</h3>
<h5>Closed: a team is not a Layer 1 type</h5>
<p>Everything below workforce got built because a running system needed it. Workforce is the one layer specified top-down — the <code>Agent</code> type carries two fields nothing resolves, and its capability factory returns a name and a TODO. That is the shape tenet 3 warns about: a contract taken on before there was a caller.</p>
<p>The generous reading is that it is a placeholder held deliberately while the layers underneath matured — and they did mature; seven of the ten needs above are now met by systems that did not exist when <code>Agent</code> was first written.</p>
<p>Closed: a team is <strong>not</strong> a first-class Layer&nbsp;1 primitive. A roster is the seat-list; a team is that roster plus shared channels plus dispatch as Layer&nbsp;2. A seat is a flow instance, not an Agent catalog row. Product Agent is later Layer&nbsp;2. <code>Agent</code> / <code>AgentRegistry</code> are the old surface &#8212; honesty lives on the <a href="workforce.html#fence">Workforce atlas &#167;04</a>. Workforce is the product; DevForce and Pentest Lab are sibling Labs on it &#8212; <a href="workforce.html#conductor">Workforce atlas &#167;16</a>. Readiness gaps live on that page &#8212; <a href="workforce.html#gaps">&#167;19</a> &#8212; not as new Layer&nbsp;1 nouns.</p>
<p>Closed: a team is <strong>not</strong> a first-class Layer&nbsp;1 primitive. A roster is the seat-list; a team is that roster plus shared channels plus dispatch as Layer&nbsp;2. A seat is a flow instance, not an Agent catalog row. Product Agent is later Layer&nbsp;2. <code>Agent</code> / <code>AgentRegistry</code> are the old surface &#8212; honesty lives on the <a href="workforce.html#fence">Workforce atlas &#167;04</a>. Workforce is the product; DevTeam and Pentest Lab are sibling Labs on it &#8212; <a href="workforce.html#conductor">Workforce atlas &#167;16</a>. Readiness gaps live on that page &#8212; <a href="workforce.html#gaps">&#167;19</a> &#8212; not as new Layer&nbsp;1 nouns.</p>
</div>
</section>

Expand Down Expand Up @@ -1752,7 +1752,7 @@ <h3>Skills</h3>

<h3>Workforce</h3>
<p>A composition package for hiring workers, defining the built-in agent worker flow, loading file-declared resources and skills, generating resource maps, defining personas, and opening channels. Its root exports include <code>hireWorkforce</code>, <code>defineAgentWorkerFlow</code>, <code>definePersona</code>, <code>createWorkforceCapability</code>, resource helpers, worker schemas, and the channel surface. It does not export an Agent factory. Workers are generators or flows with instructions, a model, and tools; seats are flow instances. See the <a href="workforce.html#fence">Workforce atlas</a>.</p>
<p>What the package does and does not yet do is <a href="#workforce-layer">&sect;04</a>. The product lock &#8212; Workforce as the Layer&nbsp;2 surface, DevForce and Pentest Lab as sibling Labs on it &#8212; is the <a href="workforce.html">Workforce atlas</a>, not this inventory.</p>
<p>What the package does and does not yet do is <a href="#workforce-layer">&sect;04</a>. The product lock &#8212; Workforce as the Layer&nbsp;2 surface, DevTeam and Pentest Lab as sibling Labs on it &#8212; is the <a href="workforce.html">Workforce atlas</a>, not this inventory.</p>

<h3>Thought fabric</h3>
<p><code>@thought-fabric/core</code> is a separate namespace for cognitive-architecture primitives built on FSD rather than part of it: <strong>attention</strong> (salience scoring, relevance filtering), <strong>identity</strong> (constitution, perspective system with its own capability), and <strong>metacognition</strong> (bias detection). Its naming convention encodes category by word order — <code>perspectiveObserve</code> is a block, <code>addPerspective</code> is a helper — so the inversion signals the kind without documentation.</p>
Expand Down
4 changes: 2 additions & 2 deletions docs/atlas/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ <h1>Atlas</h1>
<a href="conductor.html">Conductor</a>
<p class="what">
Encyclopedia of the old Conductor run. The product name is retired;
DevForce and Pentest Lab are sibling Labs on Workforce. Product lock is on the Workforce
DevTeam and Pentest Lab are sibling Labs on Workforce. Product lock is on the Workforce
atlas.
</p>
</li>
Expand All @@ -44,7 +44,7 @@ <h1>Atlas</h1>
<a href="workforce.html">Workforce</a>
<p class="what">
The Layer 2 product — roster / teams + seats + channels + thin
helpers. DevForce and Pentest Lab are sibling consumers on it,
helpers. DevTeam and Pentest Lab are sibling consumers on it,
not sibling ships.
</p>
</li>
Expand Down
Loading
Loading