Home /Modules/api/philosophers.html

philosophers.html

api/sleela/3.1/version-016/package/philosophers.html · 416 line(s) · html

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Package philosophers — SleelaDoc API</title>
<link rel="stylesheet" href="../style.css">

</head>
<body>
<header class="top">
  <div class="brand"><a href="../index.html">SleelaDoc API</a></div>
  <div class="tag">HTML documentation for the SLeeLa standard library (/lib)</div>
</header>
<div class="wrap">
<nav class="side">
  <a href="../index.html"><strong>Home</strong></a>
  <a href="../packages.html"><strong>All packages</strong></a>
  <a href="../glossary.html"><strong>Glossary</strong></a>
  <a href="../authorship.html"><strong>Authorship</strong></a>
  <h2>Packages</h2><ul>
<li><a href="../package/advantage.html">advantage</a></li>
<li><a href="../package/alphabet.html">alphabet</a></li>
<li><a href="../package/antivirus.html">antivirus</a></li>
<li><a href="../package/api.html">api</a></li>
<li><a href="../package/array.html">array</a></li>
<li><a href="../package/audio.html">audio</a></li>
<li><a href="../package/autocad.html">autocad</a></li>
<li><a href="../package/ballum.html">ballum</a></li>
<li><a href="../package/bash.html">bash</a></li>
<li><a href="../package/boolean.html">boolean</a></li>
<li><a href="../package/cdma.html">cdma</a></li>
<li><a href="../package/char.html">char</a></li>
<li><a href="../package/character.html">character</a></li>
<li><a href="../package/character-recognition.html">character-recognition</a></li>
<li><a href="../package/churn.html">churn</a></li>
<li><a href="../package/citizen.html">citizen</a></li>
<li><a href="../package/codecs.html">codecs</a></li>
<li><a href="../package/collections.html">collections</a></li>
<li><a href="../package/common-rails.html">common-rails</a></li>
<li><a href="../package/compiler.html">compiler</a></li>
<li><a href="../package/compression.html">compression</a></li>
<li><a href="../package/config.html">config</a></li>
<li><a href="../package/connector.html">connector</a></li>
<li><a href="../package/coorenagraph.html">coorenagraph</a></li>
<li><a href="../package/core.html">core</a></li>
<li><a href="../package/cpu.html">cpu</a></li>
<li><a href="../package/crypto.html">crypto</a></li>
<li><a href="../package/data.html">data</a></li>
<li><a href="../package/data-structures.html">data-structures</a></li>
<li><a href="../package/database.html">database</a></li>
<li><a href="../package/debugger.html">debugger</a></li>
<li><a href="../package/decompiler.html">decompiler</a></li>
<li><a href="../package/deliberation.html">deliberation</a></li>
<li><a href="../package/drivers.html">drivers</a></li>
<li><a href="../package/examples.html">examples</a></li>
<li><a href="../package/filesystem.html">filesystem</a></li>
<li><a href="../package/gameplay.html">gameplay</a></li>
<li><a href="../package/governance.html">governance</a></li>
<li><a href="../package/gui.html">gui</a></li>
<li><a href="../package/guidoc.html">guidoc</a></li>
<li><a href="../package/hotlink.html">hotlink</a></li>
<li><a href="../package/html.html">html</a></li>
<li><a href="../package/http.html">http</a></li>
<li><a href="../package/http-1.0.html">http-1.0</a></li>
<li><a href="../package/http-2.0.html">http-2.0</a></li>
<li><a href="../package/http-3.0.html">http-3.0</a></li>
<li><a href="../package/http-4.0.html">http-4.0</a></li>
<li><a href="../package/http-5.0.html">http-5.0</a></li>
<li><a href="../package/http-6.0.html">http-6.0</a></li>
<li><a href="../package/http-7.0.html">http-7.0</a></li>
<li><a href="../package/http-8.0.html">http-8.0</a></li>
<li><a href="../package/http-9.0.html">http-9.0</a></li>
<li><a href="../package/http-servers.html">http-servers</a></li>
<li><a href="../package/ide.html">ide</a></li>
<li><a href="../package/ide-workbench.html">ide-workbench</a></li>
<li><a href="../package/idea.html">idea</a></li>
<li><a href="../package/inference-model.html">inference-model</a></li>
<li><a href="../package/inputs.html">inputs</a></li>
<li><a href="../package/international-criminal-court.html">international-criminal-court</a></li>
<li><a href="../package/io.html">io</a></li>
<li><a href="../package/java.html">java</a></li>
<li><a href="../package/java28.html">java28</a></li>
<li><a href="../package/journey.html">journey</a></li>
<li><a href="../package/languages.html">languages</a></li>
<li><a href="../package/large-language-models.html">large-language-models</a></li>
<li><a href="../package/ledger.html">ledger</a></li>
<li><a href="../package/linux-editors.html">linux-editors</a></li>
<li><a href="../package/manifesto.html">manifesto</a></li>
<li><a href="../package/math.html">math</a></li>
<li><a href="../package/memory.html">memory</a></li>
<li><a href="../package/modules.html">modules</a></li>
<li><a href="../package/moral-capacitor.html">moral-capacitor</a></li>
<li><a href="../package/munction.html">munction</a></li>
<li><a href="../package/native.html">native</a></li>
<li><a href="../package/net.html">net</a></li>
<li><a href="../package/neural-nets.html">neural-nets</a></li>
<li><a href="../package/nordshrift.html">nordshrift</a></li>
<li><a href="../package/observer.html">observer</a></li>
<li><a href="../package/opcodes.html">opcodes</a></li>
<li><a href="../package/operating-system.html">operating-system</a></li>
<li><a href="../package/os-level-support.html">os-level-support</a></li>
<li><a href="../package/philosophers.html">philosophers</a></li>
<li><a href="../package/philosophy.html">philosophy</a></li>
<li><a href="../package/politico.html">politico</a></li>
<li><a href="../package/process.html">process</a></li>
<li><a href="../package/psychiatry.html">psychiatry</a></li>
<li><a href="../package/public.html">public</a></li>
<li><a href="../package/reflection.html">reflection</a></li>
<li><a href="../package/regex.html">regex</a></li>
<li><a href="../package/registry.html">registry</a></li>
<li><a href="../package/rmi.html">rmi</a></li>
<li><a href="../package/rrs.html">rrs</a></li>
<li><a href="../package/runtime.html">runtime</a></li>
<li><a href="../package/security.html">security</a></li>
<li><a href="../package/server-edition.html">server-edition</a></li>
<li><a href="../package/signal-processing.html">signal-processing</a></li>
<li><a href="../package/sldocument.html">sldocument</a></li>
<li><a href="../package/sleela.html">sleela</a></li>
<li><a href="../package/sleela-sql.html">sleela-sql</a></li>
<li><a href="../package/sleela-terminal.html">sleela-terminal</a></li>
<li><a href="../package/sleeladoc.html">sleeladoc</a></li>
<li><a href="../package/slrtp.html">slrtp</a></li>
<li><a href="../package/social-model.html">social-model</a></li>
<li><a href="../package/softlisten.html">softlisten</a></li>
<li><a href="../package/sommeliers.html">sommeliers</a></li>
<li><a href="../package/spatial.html">spatial</a></li>
<li><a href="../package/sst.html">sst</a></li>
<li><a href="../package/synchro.html">synchro</a></li>
<li><a href="../package/systems.html">systems</a></li>
<li><a href="../package/telephony-skya.html">telephony-skya</a></li>
<li><a href="../package/terminal.html">terminal</a></li>
<li><a href="../package/terminal_pixel.html">terminal_pixel</a></li>
<li><a href="../package/text.html">text</a></li>
<li><a href="../package/ui.html">ui</a></li>
<li><a href="../package/us-infrastructure.html">us-infrastructure</a></li>
<li><a href="../package/user-interface.html">user-interface</a></li>
<li><a href="../package/video.html">video</a></li>
<li><a href="../package/vm.html">vm</a></li>
<li><a href="../package/web-server-technology.html">web-server-technology</a></li>
<li><a href="../package/website.html">website</a></li>
<li><a href="../package/wifi.html">wifi</a></li>
<li><a href="../package/xlt.html">xlt</a></li>
<li><a href="../package/xml.html">xml</a></li>
</ul>
</nav>
<main>
<div class="crumbs"><a href="../index.html">Home</a> &rsaquo; <a href="../packages.html">Packages</a> &rsaquo; philosophers</div>
<h1>Package <code>philosophers</code></h1>
<div class="lead">This package contains <strong>9</strong> source unit(s) defining <strong>9</strong> class(es) / struct(s). Each unit below lists its fields (the values it stores) and methods (the actions it performs), with a plain explanation of each.</div>
<input class="search" placeholder="Filter on this page (Ctrl+F also works)…" oninput="flt(this.value)">
<h2 class="section" data-u="philosophers-demo">philosophers-demo <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/philosophers/philosophers-demo.sleela)</span></h2>
<div data-u="philosophers-demo philosophersdemo">
<h3 id="PhilosophersDemo">PhilosophersDemo <span class="pill">class</span></h3>
<p class="desc">builds the canonical chain Constructor() :: Patch :: Constructor :: Aim :: Guide, weighs favor on the Notice of Approach, runs a time-bounded contract, and lets the object live free.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>main</code></td><td><span class="sig">void main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slconstructorcontract">SLConstructorContract <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/philosophers/SLConstructorContract.sleela)</span></h2>
<div data-u="slconstructorcontract slconstructorcontract">
<h3 id="SLConstructorContract">SLConstructorContract <span class="pill">class</span></h3>
<p class="desc">The time-bounded contract of the instantiative moment -- the Constructor is of nature and time, and that moment does not outstay ~2 minutes.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>MAX_SECONDS</code></td><td><span class="sig">static final int MAX_SECONDS = 120</span></td><td class="desc">--- the two-minute boundary and the phases of the moment --------------- The instantiative moment runs no more than about two minutes.</td></tr>
<tr><td><code>PHASE_SEALED</code></td><td><span class="sig">static final int PHASE_SEALED = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>PHASE_OPEN</code></td><td><span class="sig">static final int PHASE_OPEN = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>PHASE_CLOSED</code></td><td><span class="sig">static final int PHASE_CLOSED = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>PHASE_FREE</code></td><td><span class="sig">static final int PHASE_FREE = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>clock</code></td><td><span class="sig">int clock</span></td><td class="desc">the clock of the moment, in seconds; only ever advanced ahead</td></tr>
<tr><td><code>phase</code></td><td><span class="sig">int phase</span></td><td class="desc">the current phase of the moment</td></tr>
<tr><td><code>free</code></td><td><span class="sig">int free</span></td><td class="desc">1 once the object has been declared to live free of the moment</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>create</code></td><td><span class="sig">void create()</span></td><td class="desc">Prepare a sealed contract. The moment has not opened.</td></tr>
<tr><td><code>open</code></td><td><span class="sig">void open()</span></td><td class="desc">Open the instantiative moment. The clock starts at zero.</td></tr>
<tr><td><code>tickAhead</code></td><td><span class="sig">int tickAhead(int seconds)</span></td><td class="desc">The perpetual whistle of time, kept as &quot;ahead&quot;: advance the clock forward by a number of seconds. Backward or zero ticks are ignored (time only ever goes ahead). When the clock reaches the two-minute boundary the moment closes on its own. Returns the clock after the tick.</td></tr>
<tr><td><code>withinContract</code></td><td><span class="sig">boolean withinContract()</span></td><td class="desc">Is the moment still inside its two-minute contract?</td></tr>
<tr><td><code>clampSeconds</code></td><td><span class="sig">int clampSeconds(int seconds)</span></td><td class="desc">Clamp a requested duration (seconds) into [1, MAX_SECONDS]. Offered so a caller never has to name this class&#x27;s MAX_SECONDS constant directly.</td></tr>
<tr><td><code>maxSeconds</code></td><td><span class="sig">int maxSeconds()</span></td><td class="desc">The two-minute boundary, as a method, for callers that need the number.</td></tr>
<tr><td><code>sealMoment</code></td><td><span class="sig">void sealMoment()</span></td><td class="desc">Close the moment deliberately (e.g. construction finished before 2 min). Named sealMoment() rather than close(): a bare close() collides with the reserved Munction reach-handle built-in, so the contract uses its own name.</td></tr>
<tr><td><code>liberate</code></td><td><span class="sig">boolean liberate()</span></td><td class="desc">Declare the object free: it now lives on, released from the moment that made it. Only a closed moment can be freed; the whistle never runs back.</td></tr>
<tr><td><code>livesFree</code></td><td><span class="sig">boolean livesFree()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getClock</code></td><td><span class="sig">int getClock()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getPhase</code></td><td><span class="sig">int getPhase()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>phaseText</code></td><td><span class="sig">String phaseText()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slfavormechanism">SLFavorMechanism <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/philosophers/SLFavorMechanism.sleela)</span></h2>
<div data-u="slfavormechanism slfavormechanism">
<h3 id="SLFavorMechanism">SLFavorMechanism <span class="pill">class</span></h3>
<p class="desc">The Favor Mechanism -- it catches the facts and sayings of Approach at the time of the Constructor call and decides runnability.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>FAVOR_WITHHELD</code></td><td><span class="sig">static final int FAVOR_WITHHELD = 0</span></td><td class="desc">--- favor verdicts -----------------------------------------------------</td></tr>
<tr><td><code>FAVOR_GRANTED</code></td><td><span class="sig">static final int FAVOR_GRANTED = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>noticeCaught</code></td><td><span class="sig">int noticeCaught</span></td><td class="desc">the running tally of Notice caught at the Time of the call</td></tr>
<tr><td><code>quorum</code></td><td><span class="sig">int quorum</span></td><td class="desc">the least Notice that must be caught for favor to be granted</td></tr>
<tr><td><code>verdict</code></td><td><span class="sig">int verdict</span></td><td class="desc">the last verdict rendered (FAVOR_WITHHELD / FAVOR_GRANTED)</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>create</code></td><td><span class="sig">void create()</span></td><td class="desc">Prepare the mechanism with a default quorum of one caught Notice.</td></tr>
<tr><td><code>setQuorum</code></td><td><span class="sig">void setQuorum(int q)</span></td><td class="desc">Set how much Notice the Approach must earn before favor can be granted. A quorum below one is lifted to one: favor is never free.</td></tr>
<tr><td><code>getQuorum</code></td><td><span class="sig">int getQuorum()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>catchNotice</code></td><td><span class="sig">void catchNotice(String saying)</span></td><td class="desc">Catch one fact/saying of Approach. Each caught Notice raises the tally.</td></tr>
<tr><td><code>getNoticeCaught</code></td><td><span class="sig">int getNoticeCaught()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>weigh</code></td><td><span class="sig">int weigh()</span></td><td class="desc">Weigh the Notice and render a verdict. Favor is granted only when the caught Notice meets or exceeds the quorum. Returns the verdict code.</td></tr>
<tr><td><code>granted</code></td><td><span class="sig">boolean granted()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>verdictText</code></td><td><span class="sig">String verdictText()</span></td><td class="desc">The verdict as readable text, for banners and contracts.</td></tr>
<tr><td><code>reset</code></td><td><span class="sig">void reset()</span></td><td class="desc">Reset the mechanism for a fresh Constructor call, keeping the quorum.</td></tr>
</table>
</div>
<h2 class="section" data-u="slordain">SLOrdain <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/philosophers/SLOrdain.sleela)</span></h2>
<div data-u="slordain slordain">
<h3 id="SLOrdain">SLOrdain <span class="pill">class</span></h3>
<p class="desc">Ordain -- the ordinality itself. Not a Guide and not a seating, but the orthogonal principle of rank and order that stands across all twenty-one seatings at once.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>CROWN</code></td><td><span class="sig">static final int CROWN = 20</span></td><td class="desc">--- the axis of order ---------------------------------------------------- The ordaining crown: the seating the whole chain answers to (Approval).</td></tr>
<tr><td><code>FLOOR</code></td><td><span class="sig">static final int FLOOR = 0</span></td><td class="desc">The floor of the register: the first seating (Approach).</td></tr>
<tr><td><code>CATEGORIES</code></td><td><span class="sig">static final int CATEGORIES = 7</span></td><td class="desc">The number of categories that Ordain ranks over the sequence.</td></tr>
<tr><td><code>register</code></td><td><span class="sig">SLPhilosopherSeating register</span></td><td class="desc">the register whose order Ordain reads (orthogonal, not seated within it)</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>create</code></td><td><span class="sig">void create()</span></td><td class="desc">Prepare the ordinality over a fresh register.</td></tr>
<tr><td><code>readOver</code></td><td><span class="sig">void readOver(SLPhilosopherSeating r)</span></td><td class="desc">Read over an existing register instead of the fresh one.</td></tr>
<tr><td><code>ordains</code></td><td><span class="sig">boolean ordains(int ordinal)</span></td><td class="desc">Is this ordinal ordained (a real, ranked seating)? Orthogonality means Ordain itself is never one of them, so it answers about others only.</td></tr>
<tr><td><code>rank</code></td><td><span class="sig">int rank(int ordinal)</span></td><td class="desc">The rank of an ordinal: its distance up from the floor (0 at Approach, 20 at Approval). This is the ordinality -- the order-number of the seat.</td></tr>
<tr><td><code>toCrown</code></td><td><span class="sig">int toCrown(int ordinal)</span></td><td class="desc">How near a seating stands to the ordaining crown: 0 at the crown itself, growing with distance below it. The chain answers upward, so nearness to the crown is nearness to Approval.</td></tr>
<tr><td><code>ordainingCategory</code></td><td><span class="sig">int ordainingCategory(int ordinal)</span></td><td class="desc">The category that ordains a seating (which of the seven phases ranks it).</td></tr>
<tr><td><code>ordainingCategoryName</code></td><td><span class="sig">String ordainingCategoryName(int ordinal)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isCrown</code></td><td><span class="sig">boolean isCrown(int ordinal)</span></td><td class="desc">Is this the ordaining crown itself (Approval, the seat answered to)?</td></tr>
<tr><td><code>reading</code></td><td><span class="sig">String reading(int ordinal)</span></td><td class="desc">A one-line reading of an ordinal&#x27;s place in the order, e.g. &quot;Aim: rank 6, category Intent, 14 below the crown (Approval)&quot;.</td></tr>
</table>
</div>
<h2 class="section" data-u="slpackage">SLPackage <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/philosophers/SLPackage.sleela)</span></h2>
<div data-u="slpackage slpackage">
<h3 id="SLPackage">SLPackage <span class="pill">class</span></h3>
<p class="desc">Defines the SLeeLa standard-library package for philosophers.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>MODULE</code></td><td><span class="sig">static final String MODULE = &quot;philosophers&quot;</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>moduleName</code></td><td><span class="sig">String moduleName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slphilosopherchain">SLPhilosopherChain <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/philosophers/SLPhilosopherChain.sleela)</span></h2>
<div data-u="slphilosopherchain slphilosopherchain">
<h3 id="SLPhilosopherChain">SLPhilosopherChain <span class="pill">class</span></h3>
<p class="desc">A Constructor&#x27;s chain of growths, written with &quot;::&quot; between one growth and the next -- Constructor() :: Patch :: Constructor :: Aim :: Guide.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>GROWTH</code></td><td><span class="sig">static final String GROWTH = &quot; :: &quot;</span></td><td class="desc">the growth separator: one growth :: the next</td></tr>
<tr><td><code>ROOT</code></td><td><span class="sig">static final String ROOT = &quot;Constructor()&quot;</span></td><td class="desc">the base of the chain is always a Constructor() call</td></tr>
<tr><td><code>seating</code></td><td><span class="sig">SLPhilosopherSeating seating</span></td><td class="desc">the seating register governing how many Guides this chain may hold</td></tr>
<tr><td><code>guides</code></td><td><span class="sig">SLPhilosopherGuide[] guides</span></td><td class="desc">the Guides of this chain, in order (index 0 is the first after the root)</td></tr>
<tr><td><code>count</code></td><td><span class="sig">int count</span></td><td class="desc">how many Guides have been seated</td></tr>
<tr><td><code>refusedFlag</code></td><td><span class="sig">int refusedFlag</span></td><td class="desc">1 if a seat request was refused because the chain was at capacity</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>create</code></td><td><span class="sig">void create()</span></td><td class="desc">Prepare an empty chain at the default (band 0 -&gt; 21) capacity.</td></tr>
<tr><td><code>admit</code></td><td><span class="sig">int admit(int band)</span></td><td class="desc">Admit a signed band of additional seatings before building the chain. Returns the band actually admitted (clamped into [-2,+6]).</td></tr>
<tr><td><code>capacity</code></td><td><span class="sig">int capacity()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>size</code></td><td><span class="sig">int size()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>refused</code></td><td><span class="sig">boolean refused()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>seat</code></td><td><span class="sig">int seat(String guideName, int seatOrdinal, boolean carriesFavor)</span></td><td class="desc">Seat one named Guide onto the given seating ordinal. An approving Guide carries favor (Gold); a growing Guide carries Green. Returns the Guide&#x27;s index, or -1 when the chain is already at its admitted capacity.</td></tr>
<tr><td><code>at</code></td><td><span class="sig">SLPhilosopherGuide at(int i)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>broadcast</code></td><td><span class="sig">int broadcast(String impart)</span></td><td class="desc">Broadcast one context/impart to every seated Guide; each matching Guide counts the match. Returns how many Guides matched this impart.</td></tr>
<tr><td><code>disposeAll</code></td><td><span class="sig">void disposeAll()</span></td><td class="desc">Dispose every Guide after the object lives free. Idempotent per Guide.</td></tr>
<tr><td><code>render</code></td><td><span class="sig">String render()</span></td><td class="desc">Render the canonical chain text, e.g. &quot;Constructor() :: Patch :: Constructor :: Aim :: Guide&quot;. Built with &quot;+&quot; so no bridged char op is needed; this is the text an editor colors.</td></tr>
<tr><td><code>colorManifest</code></td><td><span class="sig">String colorManifest()</span></td><td class="desc">A compact color manifest for the editor: the color impart of each Guide in order, joined with &quot;::&quot;, e.g. &quot;Gold/Yellow :: Green :: Gold/Yellow&quot;.</td></tr>
</table>
</div>
<h2 class="section" data-u="slphilosopherconstructor">SLPhilosopherConstructor <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/philosophers/SLPhilosopherConstructor.sleela)</span></h2>
<div data-u="slphilosopherconstructor slphilosopherconstructor">
<h3 id="SLPhilosopherConstructor">SLPhilosopherConstructor <span class="pill">class</span></h3>
<p class="desc">The perfect Constructor -- it seats its Guides, opens a time-bounded contract, weighs favor, runs, and then lets the object live free.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>chain</code></td><td><span class="sig">SLPhilosopherChain chain</span></td><td class="desc">the chain of growths this Constructor declares</td></tr>
<tr><td><code>favor</code></td><td><span class="sig">SLFavorMechanism favor</span></td><td class="desc">the Favor Mechanism that weighs Notice at call time</td></tr>
<tr><td><code>contract</code></td><td><span class="sig">SLConstructorContract contract</span></td><td class="desc">the time-bounded contract of the instantiative moment</td></tr>
<tr><td><code>ran</code></td><td><span class="sig">int ran</span></td><td class="desc">1 once the Constructor has actually run to completion</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>create</code></td><td><span class="sig">void create()</span></td><td class="desc">Prepare the Constructor with an empty chain, a fresh Favor Mechanism, and a sealed contract.</td></tr>
<tr><td><code>admit</code></td><td><span class="sig">int admit(int band)</span></td><td class="desc">Admit a signed seating band in [-2,+6]; returns the band admitted.</td></tr>
<tr><td><code>guide</code></td><td><span class="sig">int guide(String name, int seatOrdinal, boolean carriesFavor)</span></td><td class="desc">Seat one named Guide; returns its index or -1 when at capacity.</td></tr>
<tr><td><code>requireNotice</code></td><td><span class="sig">void requireNotice(int quorum)</span></td><td class="desc">Set how much Notice the Approach must earn for favor.</td></tr>
<tr><td><code>run</code></td><td><span class="sig">boolean run(String[] imparts, int seconds)</span></td><td class="desc">Run the instantiative moment. The caller first provides the facts/sayings of Approach as imparts; this method opens the contract, broadcasts each impart to the Guides, catches the matched Notice into the Favor Mechanism, weighs favor, and -- only on granted favor -- runs for the given duration, closes the moment, disposes the Guides, and liberates the object. Returns true when the object was constructed and now lives free.</td></tr>
<tr><td><code>constructed</code></td><td><span class="sig">boolean constructed()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>chainText</code></td><td><span class="sig">String chainText()</span></td><td class="desc">--- output surface -----------------------------------------------------</td></tr>
<tr><td><code>colorManifest</code></td><td><span class="sig">String colorManifest()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>verdict</code></td><td><span class="sig">String verdict()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>clock</code></td><td><span class="sig">int clock()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>phase</code></td><td><span class="sig">String phase()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>capacity</code></td><td><span class="sig">int capacity()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>guides</code></td><td><span class="sig">int guides()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>report</code></td><td><span class="sig">String report()</span></td><td class="desc">A single-line report of quality, effect and output after construction.</td></tr>
</table>
</div>
<h2 class="section" data-u="slphilosopherguide">SLPhilosopherGuide <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/philosophers/SLPhilosopherGuide.sleela)</span></h2>
<div data-u="slphilosopherguide slphilosopherguide">
<h3 id="SLPhilosopherGuide">SLPhilosopherGuide <span class="pill">class</span></h3>
<p class="desc">One Guide -- a single growth in a Constructor&#x27;s chain, with its color impart and its listener for contexts and imparts.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>COLOR_NONE</code></td><td><span class="sig">static final int COLOR_NONE = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>COLOR_GOLD</code></td><td><span class="sig">static final int COLOR_GOLD = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>COLOR_GREEN</code></td><td><span class="sig">static final int COLOR_GREEN = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>name</code></td><td><span class="sig">String name</span></td><td class="desc">--- a Guide&#x27;s own name, seating and impart ----------------------------- the name as written in the chain, e.g. &quot;Patch&quot;, &quot;Aim&quot;, &quot;Guide&quot;</td></tr>
<tr><td><code>seat</code></td><td><span class="sig">int seat</span></td><td class="desc">the seating ordinal this Guide claims (see SLPhilosopherSeating)</td></tr>
<tr><td><code>approving</code></td><td><span class="sig">int approving</span></td><td class="desc">1 when this Guide carries approving favor forward, else 0</td></tr>
<tr><td><code>matched</code></td><td><span class="sig">int matched</span></td><td class="desc">a small count of contexts/imparts this Guide has matched so far</td></tr>
<tr><td><code>disposed</code></td><td><span class="sig">int disposed</span></td><td class="desc">1 once this Guide has been disposed after the object lives free</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>create</code></td><td><span class="sig">void create()</span></td><td class="desc">Prepare an empty, uncolored Guide.</td></tr>
<tr><td><code>sit</code></td><td><span class="sig">void sit(String guideName, int seatOrdinal, boolean carriesFavor)</span></td><td class="desc">Name a Guide onto a seating. An approving Guide carries favor (Gold); a still-growing Guide carries Green.</td></tr>
<tr><td><code>getName</code></td><td><span class="sig">String getName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getSeat</code></td><td><span class="sig">int getSeat()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>isApproving</code></td><td><span class="sig">boolean isApproving()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getMatched</code></td><td><span class="sig">int getMatched()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>color</code></td><td><span class="sig">int color()</span></td><td class="desc">The editor color impart for this Guide. Idempotent: the same Guide always reports the same color for the same impart, and asking never mutates it.</td></tr>
<tr><td><code>colorName</code></td><td><span class="sig">String colorName()</span></td><td class="desc">The color impart as text, for banners and editor manifests.</td></tr>
<tr><td><code>listen</code></td><td><span class="sig">boolean listen(String impart)</span></td><td class="desc">Listen for a context/impart at Constructor-call time. A Guide matches when the impart is non-null and names this Guide&#x27;s seating or its own name; the match is counted so the Favor Mechanism can weigh Notice over Time.</td></tr>
<tr><td><code>dispose</code></td><td><span class="sig">void dispose()</span></td><td class="desc">Dispose this Guide after the object lives free of its instantiative moment. Disposal is idempotent and produces the Guide&#x27;s final effect: it stops listening and keeps its matched tally as its output of record.</td></tr>
<tr><td><code>isDisposed</code></td><td><span class="sig">boolean isDisposed()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slphilosopherseating">SLPhilosopherSeating <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/philosophers/SLPhilosopherSeating.sleela)</span></h2>
<div data-u="slphilosopherseating slphilosopherseating">
<h3 id="SLPhilosopherSeating">SLPhilosopherSeating <span class="pill">class</span></h3>
<p class="desc">The twenty-one catalogued &quot;seatings&quot; a perfect Constructor can admit -- each a Guide/Wisdom slot that governs the maturation of principle over a static constructor.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>BASE_SEATINGS</code></td><td><span class="sig">static final int BASE_SEATINGS = 21</span></td><td class="desc">--- the finitude of a perfect Constructor ------------------------------ BASE seatings that every perfect Constructor approves by default.</td></tr>
<tr><td><code>ADDITIONAL_MIN</code></td><td><span class="sig">static final int ADDITIONAL_MIN = -2</span></td><td class="desc">The signed band of additional seatings a Constructor may admit.</td></tr>
<tr><td><code>ADDITIONAL_MAX</code></td><td><span class="sig">static final int ADDITIONAL_MAX = 6</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>MIN_CAPACITY</code></td><td><span class="sig">static final int MIN_CAPACITY = 19</span></td><td class="desc">Admitted capacity therefore lives in [MIN_CAPACITY, MAX_CAPACITY].</td></tr>
<tr><td><code>MAX_CAPACITY</code></td><td><span class="sig">static final int MAX_CAPACITY = 27</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SEAT_APPROACH</code></td><td><span class="sig">static final int SEAT_APPROACH = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SEAT_NOTICE</code></td><td><span class="sig">static final int SEAT_NOTICE = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SEAT_WARRANT</code></td><td><span class="sig">static final int SEAT_WARRANT = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SEAT_PATCH</code></td><td><span class="sig">static final int SEAT_PATCH = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SEAT_SEED</code></td><td><span class="sig">static final int SEAT_SEED = 4</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SEAT_FRAME</code></td><td><span class="sig">static final int SEAT_FRAME = 5</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SEAT_AIM</code></td><td><span class="sig">static final int SEAT_AIM = 6</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SEAT_COURSE</code></td><td><span class="sig">static final int SEAT_COURSE = 7</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SEAT_MEASURE</code></td><td><span class="sig">static final int SEAT_MEASURE = 8</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SEAT_HEALTH</code></td><td><span class="sig">static final int SEAT_HEALTH = 9</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SEAT_VIGOR</code></td><td><span class="sig">static final int SEAT_VIGOR = 10</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SEAT_PATTERN</code></td><td><span class="sig">static final int SEAT_PATTERN = 11</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SEAT_GUIDE</code></td><td><span class="sig">static final int SEAT_GUIDE = 12</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SEAT_MINISTRY</code></td><td><span class="sig">static final int SEAT_MINISTRY = 13</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SEAT_COUNSEL</code></td><td><span class="sig">static final int SEAT_COUNSEL = 14</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SEAT_OFFICE</code></td><td><span class="sig">static final int SEAT_OFFICE = 15</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SEAT_SAINT</code></td><td><span class="sig">static final int SEAT_SAINT = 16</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SEAT_FAVOR</code></td><td><span class="sig">static final int SEAT_FAVOR = 17</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SEAT_IMPART</code></td><td><span class="sig">static final int SEAT_IMPART = 18</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SEAT_CONFORM</code></td><td><span class="sig">static final int SEAT_CONFORM = 19</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>SEAT_APPROVAL</code></td><td><span class="sig">static final int SEAT_APPROVAL = 20</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>CAT_ADMISSION</code></td><td><span class="sig">static final int CAT_ADMISSION = 0</span></td><td class="desc">--- the seven categories (the ordinal ternary phases) -------------------</td></tr>
<tr><td><code>CAT_INCEPTION</code></td><td><span class="sig">static final int CAT_INCEPTION = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>CAT_INTENT</code></td><td><span class="sig">static final int CAT_INTENT = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>CAT_VITALITY</code></td><td><span class="sig">static final int CAT_VITALITY = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>CAT_GOVERNANCE</code></td><td><span class="sig">static final int CAT_GOVERNANCE = 4</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>CAT_STANDING</code></td><td><span class="sig">static final int CAT_STANDING = 5</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>CAT_CLOSURE</code></td><td><span class="sig">static final int CAT_CLOSURE = 6</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>additional</code></td><td><span class="sig">int additional</span></td><td class="desc">the number of additional seatings this register has admitted, in band</td></tr>
<tr><td><code>capacity</code></td><td><span class="sig">int capacity</span></td><td class="desc">admitted capacity = BASE + additional, clamped to [MIN, MAX]</td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>create</code></td><td><span class="sig">void create()</span></td><td class="desc">Prepare the register at the default (band = 0) capacity.</td></tr>
<tr><td><code>admit</code></td><td><span class="sig">int admit(int band)</span></td><td class="desc">Admit a signed number of additional seatings. Out-of-band requests are clamped into [ADDITIONAL_MIN, ADDITIONAL_MAX]; the method returns the band actually admitted so the caller learns the truth rather than a silent lie.</td></tr>
<tr><td><code>getCapacity</code></td><td><span class="sig">int getCapacity()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getAdditional</code></td><td><span class="sig">int getAdditional()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>seats</code></td><td><span class="sig">boolean seats(int ordinal)</span></td><td class="desc">Is an ordinal a real seating in the current admitted capacity?</td></tr>
<tr><td><code>inBand</code></td><td><span class="sig">boolean inBand(int band)</span></td><td class="desc">Is a band value inside the signed admission band?</td></tr>
<tr><td><code>seatName</code></td><td><span class="sig">String seatName(int ordinal)</span></td><td class="desc">The human name of a baseline seating ordinal, or &quot;unseated&quot; past 20.</td></tr>
<tr><td><code>category</code></td><td><span class="sig">int category(int ordinal)</span></td><td class="desc">The category ordinal (0..6) of a baseline seating, or -1 if unseated. Each category holds three consecutive seatings, so the category is the seating ordinal divided by three.</td></tr>
<tr><td><code>categoryName</code></td><td><span class="sig">String categoryName(int cat)</span></td><td class="desc">The human name of a category ordinal (0..6), or &quot;none&quot;.</td></tr>
<tr><td><code>seatCategoryName</code></td><td><span class="sig">String seatCategoryName(int ordinal)</span></td><td class="desc">The category name of a seating ordinal directly, or &quot;none&quot; if unseated.</td></tr>
</table>
</div>
<script>function flt(q){q=q.toLowerCase();document.querySelectorAll('[data-u]').forEach(function(el){el.style.display = el.getAttribute('data-u').indexOf(q)>=0||q==''?'':'none';});}</script>
<footer>
Generated by <code>tools/generate-sleeladoc-api.py</code> from the live
<code>/lib</code> tree on 2026-11-14 09:44 UTC.
SleelaDoc — the SLeeLa documentation brand. SLeeLa — MEARVK LLC · Max Rupplin · UNCW, NCSU, Harvard · 2026 · George Soros 2507-2608.
</footer>
</main>
</div>
</body>
</html>