Skip to content

Rewrite the front page around what FACTORY is #32

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
flujo-app merged 1 commit into from
Nov 11, 2026
Merged

Rewrite the front page around what FACTORY is #32

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions BRAIN_ONLINE_INTEGRATION.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -141,7 +141,7 @@ remains unverified. HTTP witness SHA-256:
`1e545a0d0dca944e0daaae73d21486e4e00a92e0ba90b4bf5bd7be5644361bb4`.

The private bearer file is
`C:\Users\Moe\Documents\ChatGPT\FACTORY\.factory\viewer\credential.json`.
`.factory\viewer\credential.json`.
It contains `{ "token": "..." }` under owner-only Windows permissions. Load it
only into the server-side brain-online adapter; never expose it to its browser,
Git, logs or process arguments. FACTORY's `loadViewerToken` checks file ownership,
Expand All @@ -152,7 +152,7 @@ commit. The currently running process was launched earlier from `8f5a940`:

```powershell
$factoryBuild = (git rev-parse HEAD).Trim()
& 'C:/Users/Moe/.cache/codex-runtimes/codex-primary-runtime/dependencies/node/bin/node.exe' bin/serve.mjs --database 'C:/Users/Moe/Documents/ChatGPT/FACTORY/.factory/federation-20261002/control.sqlite' --spending-ledger 'C:/Users/Moe/Documents/ChatGPT/FACTORY/.factory/spending.sqlite' --factory-id factory-live-pilot --token-file 'C:/Users/Moe/Documents/ChatGPT/FACTORY/.factory/viewer/credential.json' --modal-journals 'C:/Users/Moe/Documents/ChatGPT/FACTORY/.factory/viewer/modal-journals-20261003.private.json' --port 4344 --build-revision $factoryBuild
& 'node' bin/serve.mjs --database '.factory/federation-20261002/control.sqlite' --spending-ledger '.factory/spending.sqlite' --factory-id factory-live-pilot --token-file '.factory/viewer/credential.json' --modal-journals '.factory/viewer/modal-journals-20261003.private.json' --port 4344 --build-revision $factoryBuild
```

Shared paid reservations live separately in `.factory/spending.sqlite`: $10 Fly
Expand Down
32 changes: 16 additions & 16 deletions FACTORY_DESIGN.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Version 0.2 · October 2, 2026 · Discussion draft

The notebook below records the original design assessment. Subsequent implemented
and live-tested results are tracked separately in
[the qualification record](C:/Users/Moe/Documents/ChatGPT/FACTORY/QUALIFICATION.md).
[the qualification record](QUALIFICATION.md).

## Confirmed direction

Expand All @@ -16,7 +16,7 @@ constraints. Track accepted-delivery throughput as a complementary measure.
The owner also wants a network of FLUJO instances that can provision further
cloud instances, pursue different problems and competing approaches, communicate,
and monitor each other. The proposed architecture is a federation with delegated
budget and explicit authority; see [the federation design](C:/Users/Moe/Documents/ChatGPT/FACTORY/FEDERATION.md).
budget and explicit authority; see [the federation design](FEDERATION.md).

The factory should eventually govern its own routine work and improve its
methods. The operating model below is a proposal, not an implemented system or
Expand All @@ -30,8 +30,8 @@ interruptions, and shows what changed and why.

| Responsibility | Owner-designated chat | Observed context on October 2 |
| --- | --- | --- |
| User experience / avatar interface | [Plan Fujo’s avatar interface](codex://threads/01a0fe99-5cef-76b2-8a84-67e9ee3f6d71) | Active interface implementation; its avatar/world connects to FLUJO's existing backend capabilities |
| FLUJO development | [Clarify task request](codex://threads/01a0feb8-d78c-7b03-8e13-caae7b35e4fb) | Owner-designated development chat; retrieved history contains only a placeholder and clarification reply |
| User experience / avatar interface | Plan Fujo’s avatar interface | Active interface implementation; its avatar/world connects to FLUJO's existing backend capabilities |
| FLUJO development | Clarify task request | Owner-designated development chat; retrieved history contains only a placeholder and clarification reply |
| Factory operating model and federation | This FACTORY chat | Architecture discussion and design artifacts |

These are ownership/context references. No assignments or messages were sent to
Expand Down Expand Up @@ -300,12 +300,12 @@ now uses budget-only policy at paused epoch 5/revision 92, preserving its missio
budget and historical records; see [BUDGET_GROWTH.md](BUDGET_GROWTH.md).

The local recovery pilot is executable in this repository. Its saved evidence at
[the October 2 recovery report](C:/Users/Moe/Documents/ChatGPT/FACTORY/evidence/local-recovery-20261002/report.json)
the October 2 recovery report
records real Git mutation followed by process termination before receipt,
positive destination reconciliation, rejected stale authority and one delivered
candidate. Both candidate implementations are fixed fixtures. This qualifies a
local control/recovery mechanism, not model-driven FLUJO development or network
failover. See [README.md](README.md) for reproducible commands and boundaries.
failover. See [the pilot notes](PILOT_NOTES.md) for reproducible commands and boundaries.

## Decisions still open

Expand All @@ -320,16 +320,16 @@ failover. See [README.md](README.md) for reproducible commands and boundaries.

## Local evidence reviewed

- [FLUJO foundation contracts](C:/Users/Moe/Documents/GitHub/FLUJO/docs/architecture/enduring-agent-foundation-contracts.md)
- [Behavior learning](C:/Users/Moe/Documents/GitHub/FLUJO/src/backend/services/enduringAgents/behaviorLearning.ts)
- [Behavior outcomes](C:/Users/Moe/Documents/GitHub/FLUJO/src/backend/services/enduringAgents/behaviorOutcome.ts)
- [Outcome policy](C:/Users/Moe/Documents/GitHub/FLUJO/src/backend/services/enduringAgents/behaviorOutcomePolicy.ts)
- [Persona review and delivery handoff](C:/Users/Moe/Documents/GitHub/FLUJO/docs/audits/2026-09-21-persona-review-handoff.md)
- [Runtime acceptance scope](C:/Users/Moe/Documents/GitHub/FLUJO/docs/performance/persona-runtime-soak-acceptance.md)
- [Hackathon product boundary](C:/Users/Moe/Documents/GitHub/factored-hackathon-2026/docs/FLUJO_PRODUCT_BOUNDARY.md)
- [Hackathon supervision](C:/Users/Moe/Documents/GitHub/factored-hackathon-2026/docs/HACKATHON_SUPERVISION.md)
- [Local CI policy](C:/Users/Moe/Documents/GitHub/factored-hackathon-2026/docs/LOCAL_CI.md)
- [Recorded October 2 pause and release handoff](C:/Users/Moe/.codex/visualizations/2026/10/01/01a0f97d-c4fa-7d51-bf5c-50edd8e7b1f4/manual-release/SESSION_HANDOFF_PAUSED.md)
- [FLUJO foundation contracts](https://github.com/mario-andreschak/FLUJO/blob/main/docs/architecture/enduring-agent-foundation-contracts.md)
- [Behavior learning](https://github.com/mario-andreschak/FLUJO/blob/main/src/backend/services/enduringAgents/behaviorLearning.ts)
- [Behavior outcomes](https://github.com/mario-andreschak/FLUJO/blob/main/src/backend/services/enduringAgents/behaviorOutcome.ts)
- [Outcome policy](https://github.com/mario-andreschak/FLUJO/blob/main/src/backend/services/enduringAgents/behaviorOutcomePolicy.ts)
- Persona review and delivery handoff
- [Runtime acceptance scope](https://github.com/mario-andreschak/FLUJO/blob/main/docs/performance/persona-runtime-soak-acceptance.md)
- Hackathon product boundary
- Hackathon supervision
- Local CI policy
- Recorded October 2 pause and release handoff
- Selected coordination chats: `2h - FLUJO team coordinator`, `Inspect deployment
and progress`, `1h - PR review automation`, and `24h - Fly deployment`.
- [Official Codex App Server documentation](https://learn.chatgpt.com/docs/app-server).
14 changes: 7 additions & 7 deletions FEDERATION.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ throughput measure. Compare task classes and include review, integration and rew
The owner's larger vision is a network of FLUJO instances that can deploy further
cloud instances, work on separate problems or competing approaches, communicate,
and monitor one another. This document extends the
[factory notebook](C:/Users/Moe/Documents/ChatGPT/FACTORY/FACTORY_DESIGN.md).
[factory notebook](FACTORY_DESIGN.md).

## A cell is a complete local work system

Expand Down Expand Up @@ -223,7 +223,7 @@ separate clean `flujo-cloud` checkout at `c36ceef`. The cached newer FLUJO remot
ref is context, not a claim about the currently deployed fleet.

The local source audit found a portable workspace-snapshot cloud-worker path in
[Hot-clone workspace](C:/Users/Moe/Documents/GitHub/FLUJO/docs/features/hot-clone-workspace.md).
[Hot-clone workspace](https://github.com/mario-andreschak/FLUJO/blob/main/docs/features/hot-clone-workspace.md).
Its documentation delegates Fly lifecycle, tunneling, forwarding and teardown to
a separate `flujo-cloud` bridge and validates worker compatibility.

Expand All @@ -232,8 +232,8 @@ The bridge already exposes a shared `ManagedCloud` application service with
operation records a durable attempt before provisioning, pins a compatible image,
and binds credentials to the deployment journal. `call` forwards an existing Flow
request. These are concrete foundations for a factory provisioning capability.
See [the cloud architecture](C:/Users/Moe/Documents/GitHub/flujo-cloud/docs/architecture.md)
and [ManagedCloud](C:/Users/Moe/Documents/GitHub/flujo-cloud/lib/managed.mjs:253).
See [the cloud architecture](https://github.com/flujo-app/flujo-cloud/blob/main/docs/architecture.md)
and [ManagedCloud](https://github.com/flujo-app/flujo-cloud/blob/main/lib/managed.mjs#L253).

The bridge exposes CLI/application-service operations. The factory adds a private
MCP capacity tool, authenticated peer inbox and controller-admitted adapter.
Expand Down Expand Up @@ -281,8 +281,8 @@ cross-host consensus. Remote MCP task polling can resume observation against a
matching server identity, but its documented restart path does not retrieve and
deliver results after the originating run is gone. These existing mechanisms
cannot substitute for a durable cross-cell work/result protocol. See
[the local lease boundary](C:/Users/Moe/Documents/GitHub/FLUJO/docs/architecture/enduring-agent-foundation-contracts.md:52)
and [remote task recovery](C:/Users/Moe/Documents/GitHub/FLUJO/src/backend/services/mcp/remoteTaskResume.ts:3).
[the local lease boundary](https://github.com/mario-andreschak/FLUJO/blob/main/docs/architecture/enduring-agent-foundation-contracts.md#L52)
and [remote task recovery](https://github.com/mario-andreschak/FLUJO/blob/main/src/backend/services/mcp/remoteTaskResume.ts#L3).

Established background patterns include lease-based coordination and durable
workflow history/recovery. Kubernetes documents leases for heartbeats and leader
Expand All @@ -297,7 +297,7 @@ The first partial live delegation proof has now passed: real parent/child FLUJO
workers, coordinator-mediated child admission, independent review, owned teardown
and a separate same-host provider witness. It does not yet qualify the full
experiment below. Exact evidence and remaining scope are in
[the qualification record](C:/Users/Moe/Documents/ChatGPT/FACTORY/QUALIFICATION.md).
[the qualification record](QUALIFICATION.md).

1. Select one bounded FLUJO improvement and a common acceptance contract.
2. Provision one cloud development cell and an independently hosted watcher,
Expand Down
Loading
Loading