Factory docs, home
Page navigation

Pre-release documentation. Proposed designs are labelled in the page; acceptance evidence is maintained in the build review. Local paths appear as placeholders. Current state: Build review.

Visual understanding · Workflow diagrams

These are information-flow diagrams, not import graphs. Arrows mean a caller passes or records information; they do not imply automatic dispatch. Contracts own exact field names and bounds; the build review owns current acceptance.

Research semantics

Input supplier: Caller with retained native Research collections. Input: Original semantic commission, native quote pins, source classes, fixed shared allowance and explicit shadow policy. Research semantics: Reverify selected native quotes and retain bounded injected triage and synthesis. Output: Attributed Signals, synthesis and parked or policy-evaluated shadow. Consumer: Owner preparing an explicit Guidance decision or Research handoff. Boundary: No transport, live model or admission authority. Unknown contacts retain their full reservation and are never retried; v1 collection still makes zero model calls.

Feed it: Original semantic commission, native quote pins, source classes, fixed shared allowance and explicit shadow policy. Supplier: Caller with retained native Research collections.

Use its result: Attributed Signals, synthesis and parked or policy-evaluated shadow. Consumer: Owner preparing an explicit Guidance decision or Research handoff.

Boundary: No transport, live model or admission authority. Unknown contacts retain their full reservation and are never retried; v1 collection still makes zero model calls.

Human guide · Exact contract · Open full-size diagram

Knowledge

Input supplier: Caller with genuine native owners and a qualified current physical fence. Input: Reviewed lessons, authenticated independent reports, exact native source and Guidance pins, query and immutable plan alternatives. Knowledge: Retain loss-accounted history; retrieve current support and record bounded deterministic advice. Output: Historical Learning and Use receipts, current support and advised plan or explicit abstention. Consumer: Owner and separately authorised planning or Factory caller. Boundary: Keyword matching supplies no semantic advantage or execution authority. Historical use is not current advice; forbidden, conflicting or incomplete support requires abstention.

Feed it: Reviewed lessons, authenticated independent reports, exact native source and Guidance pins, query and immutable plan alternatives. Supplier: Caller with genuine native owners and a qualified current physical fence.

Use its result: Historical Learning and Use receipts, current support and advised plan or explicit abstention. Consumer: Owner and separately authorised planning or Factory caller.

Boundary: Keyword matching supplies no semantic advantage or execution authority. Historical use is not current advice; forbidden, conflicting or incomplete support requires abstention.

Human guide · Exact contract · Open full-size diagram

Milestone objectives

Input supplier: Qualified caller or local Dashboard. Input: Product, objective, original command ID, allowance and authority fence. Milestone objectives: Retain objectives, revisions and one explicit next priority. Output: Retained milestone and attributed plan trajectory. Consumer: Owner and separately qualified planning caller. Boundary: No automatic Research, work-ticket admission or resource-adjusted ETA. Completion needs current observed criteria.

Feed it: Product, objective, original command ID, allowance and authority fence. Supplier: Qualified caller or local Dashboard.

Use its result: Retained milestone and attributed plan trajectory. Consumer: Owner and separately qualified planning caller.

Boundary: No automatic Research, work-ticket admission or resource-adjusted ETA. Completion needs current observed criteria.

Human guide · Exact contract · Open full-size diagram

Milestone research handoff

Input supplier: Qualified retained Research reader. Input: Original retained Research handoff, milestone intent and commission, original command identity. Milestone research handoff: Prepare a bounded unassessed draft and its original M01 request. Output: Unassessed first-plan draft and original M01 admission request. Consumer: Qualified milestone caller. Boundary: Starts no Research or work and admits nothing. Current review, records, authority and original-ID replay belong to the caller and M01 host.

Feed it: Original retained Research handoff, milestone intent and commission, original command identity. Supplier: Qualified retained Research reader.

Use its result: Unassessed first-plan draft and original M01 admission request. Consumer: Qualified milestone caller.

Boundary: Starts no Research or work and admits nothing. Current review, records, authority and original-ID replay belong to the caller and M01 host.

Human guide · Exact contract · Open full-size diagram

Milestone work brief

Input supplier: Qualified milestone snapshot reader. Input: One selected retained implementation generation and optional reviewed detail. Milestone work brief: Copy the selected plan into a bounded unadmitted brief. Output: Work brief with criteria, dependencies, dates, counts and unknowns. Consumer: Separately qualified implementation owner. Boundary: A captured plan is not work admission, current authority or a delivery estimate. Copied dates retain attribution.

Feed it: One selected retained implementation generation and optional reviewed detail. Supplier: Qualified milestone snapshot reader.

Use its result: Work brief with criteria, dependencies, dates, counts and unknowns. Consumer: Separately qualified implementation owner.

Boundary: A captured plan is not work admission, current authority or a delivery estimate. Copied dates retain attribution.

Human guide · Exact contract · Open full-size diagram

Research jobs

Input supplier: Commissioned source-collection caller. Input: Question, guidance, public-source commission, fixed allowance and permission. Research jobs: Collect once and retain attributed untriaged observations. Output: Retained report, coverage and short citations. Consumer: Independent reviewer and optional milestone handoff. Boundary: No default model, source access, schedule or work ticket. Restart and changed question cannot renew the original allowance.

Feed it: Question, guidance, public-source commission, fixed allowance and permission. Supplier: Commissioned source-collection caller.

Use its result: Retained report, coverage and short citations. Consumer: Independent reviewer and optional milestone handoff.

Boundary: No default model, source access, schedule or work ticket. Restart and changed question cannot renew the original allowance.

Human guide · Exact contract · Open full-size diagram

Intelligence

Input supplier: Canonical policy and caller task. Input: Task identity, approved ordered models, effort and route facts. Intelligence: Select without silently substituting; retain refusal reasons. Output: Pinned model selection or unavailable decision. Consumer: Future task admission and configured Producers. Boundary: Selection is not qualification. No runtime provider is qualified by this registry and no model starts on import.

Feed it: Task identity, approved ordered models, effort and route facts. Supplier: Canonical policy and caller task.

Use its result: Pinned model selection or unavailable decision. Consumer: Future task admission and configured Producers.

Boundary: Selection is not qualification. No runtime provider is qualified by this registry and no model starts on import.

Human guide · Exact contract · Open full-size diagram

Lifecycle schedule

Input supplier: Commission and caller clock. Input: Product rhythms, timezone, occurrence ID and fixed weekly limits. Lifecycle schedule: Admit, defer and reconcile bounded discovery occurrences. Output: Occurrence state and estimated-token ledger. Consumer: Future scheduled discovery controller; capacity adapter reads ledger. Boundary: Passive bookkeeping starts no timer or provider call. Unknown calls stay debited at their bound; limits never grow.

Feed it: Product rhythms, timezone, occurrence ID and fixed weekly limits. Supplier: Commission and caller clock.

Use its result: Occurrence state and estimated-token ledger. Consumer: Future scheduled discovery controller; capacity adapter reads ledger.

Boundary: Passive bookkeeping starts no timer or provider call. Unknown calls stay debited at their bound; limits never grow.

Human guide · Exact contract · Open full-size diagram

Discovery sources

Input supplier: Caller commissioning public sources. Input: Approved addresses, occurrence, request bounds, transport and cache. Discovery sources: Read allowed sources; normalise, fingerprint and verify quotes. Output: Captures, novelty, coverage and checkable Citations. Consumer: Future Research intake and synthesis. Boundary: Loopback proof only. Cached text lasts 35 days; expired quotes are unverifiable. Page instructions carry no authority.

Feed it: Approved addresses, occurrence, request bounds, transport and cache. Supplier: Caller commissioning public sources.

Use its result: Captures, novelty, coverage and checkable Citations. Consumer: Future Research intake and synthesis.

Boundary: Loopback proof only. Cached text lasts 35 days; expired quotes are unverifiable. Page instructions carry no authority.

Human guide · Exact contract · Open full-size diagram

Temporal planning

Input supplier: Caller evidence snapshots. Input: Attributed dates, source revisions, dependencies, policy and clock. Temporal Planning: Evaluate date relationships without adding precision. Output: Conflicts, constraints and unknowns. Consumer: Caller evaluating a dated plan. Boundary: Dates do not prove release. No capacity forecast, reservation, Commitment approval or dispatch.

Feed it: Attributed dates, source revisions, dependencies, policy and clock. Supplier: Caller evidence snapshots.

Use its result: Conflicts, constraints and unknowns. Consumer: Caller evaluating a dated plan.

Boundary: Dates do not prove release. No capacity forecast, reservation, Commitment approval or dispatch.

Human guide · Exact contract · Open full-size diagram

Capacity planning

Input supplier: Caller quota and work observations. Input: Native-unit quota windows, charges, reserves and reviewed scenarios. Capacity Planning: Derive residual capacity and conditional completion ranges. Output: Headroom, deficits, ranges and explicit assumptions. Consumer: Caller; Factory capacity command reads schedule ledger. Boundary: No provider queried or quota reserved. Factory headroom is its own admission ceiling, not observed subscription quota.

Feed it: Native-unit quota windows, charges, reserves and reviewed scenarios. Supplier: Caller quota and work observations.

Use its result: Headroom, deficits, ranges and explicit assumptions. Consumer: Caller; Factory capacity command reads schedule ledger.

Boundary: No provider queried or quota reserved. Factory headroom is its own admission ceiling, not observed subscription quota.

Human guide · Exact contract · Open full-size diagram

Material timing

Input supplier: Caller with approved material facts. Input: Pinned material revisions, calendar rules, slots and obligations. Material Timing: Evaluate eligible material slots and known exclusions. Output: Eligible, excluded or unknown slot evaluations. Consumer: Caller deciding when material may fit. Boundary: Neither approves content nor publishes it. Source authenticity, withdrawal and coverage belong to the host.

Feed it: Pinned material revisions, calendar rules, slots and obligations. Supplier: Caller with approved material facts.

Use its result: Eligible, excluded or unknown slot evaluations. Consumer: Caller deciding when material may fit.

Boundary: Neither approves content nor publishes it. Source authenticity, withdrawal and coverage belong to the host.

Human guide · Exact contract · Open full-size diagram

Source: docs/explanation/visual-planning.md