Skip to content

reference/cli.mdx:70 says os dev defaults to port 3002 — PR #143 measured 3000, and quickstart already says so #229

Description

@os-zhuang

Found by the repo:objectos execution seat (objectstack#9831) during the dispatch-time premise check for #150, which lands four lines below this one in the same file. Filed rather than folded into that card: #150 deletes a section documenting a command that does not exist, this corrects a falsified number — different defect, different fix, so folding them would be widening #150's surface on my own authority. #150's dispatch names this card in its exclusion list.

The contradiction, both halves on origin/main @ 09a0dd9

content/docs/reference/cli.mdx:70:

os dev # port 3002 by default

content/docs/quickstart.mdx:200-203 — text that PR #143 landed from measurement, replacing an earlier sentence that asserted 3002:

> Note the dev server asks for port 3000, the same port os start uses. If
> that port is taken it binds the next free one and says so:
> ↪ server bound to port 3001 (requested 3000).

So the corpus states both, four files apart, and the one that is wrong is the one filed under reference.

This is not a guess — the 3002 claim was already falsified once

The quickstart sentence was not edited for style. #141's re-arm record states the replaced sentence asserted port 3002 "which no boot produced", and the current text is a transcription of a real boot: it names the requested port, the collision behaviour, and the literal line the CLI prints on rebinding. That measurement was taken against @objectstack/cli 17.1.0 and reviewed at the ACCEPT of PR #143.

What was not done at the time is sweep for the same claim elsewhere — #143's file surface was quickstart.mdx alone, correctly. This is the residue of that scoping, exactly the shape #148 is to #102.

Why it is worth a card rather than a silent fix

reference/cli.mdx is where a reader goes to check a flag. A reader who wants os dev and os start running side by side reads line 70, concludes the two ports differ by default, and does not pass -p. What actually happens is that the second one collides on 3000 and silently moves to 3001 — so the reader's mental model of which server is on which port is wrong, and nothing errors to tell them.

Scope

Line 70's comment, plus whatever the honest replacement needs. Two things to decide, neither of them large:

  • Whether the one-line comment should carry the collision behaviour at all or just say # port 3000 and leave the fallback to the quickstart. A code-block comment is a poor place for two sentences; a short line under the block is the alternative.
  • Whether os dev -p 4002 on line 71 stays as the flag example. It is not wrong — -p takes any port — but 4002 was presumably chosen to read as "3002 plus a bit", so it may want to become 4000 once the default is corrected. Cosmetic, and explicitly not a reason to widen.

Do not sweep the locale siblings.quickstart.de/es/fr/ja/ko/zh-Hans/zh-Hant.mdx all still carry the 3002 banner and prose. Translations are never a dev agent's output in this repo and locale siblings go stale by design — they are the translation pass's input, not this card's.

Re-check

git grep -n '3002' origin/main -- content/docs/reference/cli.mdx
git show origin/main:content/docs/quickstart.mdx | sed -n '200,203p'

Related: #143 (the measurement), #141 (the card that watches this page's version-pinned claims), #150 (same file, deletes the os studio section four lines below).

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions

    , 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all
     blocks
    (function() {
    function addCopyButtons() {
    document.querySelectorAll('pre code').forEach(function(codeBlock) {
    if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
    codeBlock.parentElement.setAttribute('data-copy-added', 'true');
    var btn = document.createElement('button');
    btn.textContent = 'Copy';
    btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
    btn.onmouseover = function() { this.style.opacity = '1'; };
    btn.onmouseout = function() { this.style.opacity = '0.7'; };
    btn.onclick = function() {
    navigator.clipboard.writeText(codeBlock.textContent).then(function() {
    btn.textContent = 'Copied!';
    setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
    });
    };
    codeBlock.parentElement.style.position = 'relative';
    codeBlock.parentElement.appendChild(btn);
    });
    }
    addCopyButtons();
    // Re-run on dynamic content
    var observer = new MutationObserver(addCopyButtons);
    observer.observe(document.body, { childList: true, subtree: true });
    })();
    }
    } catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
    })();
    (function(){
    try {
    var __m = "github.com";
    var __re = new RegExp('^' + "github\\.com" + '
    `reference/cli.mdx:70` says `os dev` defaults to port 3002 — PR #143 measured 3000, and quickstart already says so · Issue #229 · objectstack-ai/objectos · GitHub
    Skip to content

    reference/cli.mdx:70 says os dev defaults to port 3002 — PR #143 measured 3000, and quickstart already says so #229

    Description

    @os-zhuang

    Found by the repo:objectos execution seat (objectstack#9831) during the dispatch-time premise check for #150, which lands four lines below this one in the same file. Filed rather than folded into that card: #150 deletes a section documenting a command that does not exist, this corrects a falsified number — different defect, different fix, so folding them would be widening #150's surface on my own authority. #150's dispatch names this card in its exclusion list.

    The contradiction, both halves on origin/main @ 09a0dd9

    content/docs/reference/cli.mdx:70:

    os dev # port 3002 by default

    content/docs/quickstart.mdx:200-203 — text that PR #143 landed from measurement, replacing an earlier sentence that asserted 3002:

    > Note the dev server asks for port 3000, the same port os start uses. If
    > that port is taken it binds the next free one and says so:
    > ↪ server bound to port 3001 (requested 3000).

    So the corpus states both, four files apart, and the one that is wrong is the one filed under reference.

    This is not a guess — the 3002 claim was already falsified once

    The quickstart sentence was not edited for style. #141's re-arm record states the replaced sentence asserted port 3002 "which no boot produced", and the current text is a transcription of a real boot: it names the requested port, the collision behaviour, and the literal line the CLI prints on rebinding. That measurement was taken against @objectstack/cli 17.1.0 and reviewed at the ACCEPT of PR #143.

    What was not done at the time is sweep for the same claim elsewhere — #143's file surface was quickstart.mdx alone, correctly. This is the residue of that scoping, exactly the shape #148 is to #102.

    Why it is worth a card rather than a silent fix

    reference/cli.mdx is where a reader goes to check a flag. A reader who wants os dev and os start running side by side reads line 70, concludes the two ports differ by default, and does not pass -p. What actually happens is that the second one collides on 3000 and silently moves to 3001 — so the reader's mental model of which server is on which port is wrong, and nothing errors to tell them.

    Scope

    Line 70's comment, plus whatever the honest replacement needs. Two things to decide, neither of them large:

    • Whether the one-line comment should carry the collision behaviour at all or just say # port 3000 and leave the fallback to the quickstart. A code-block comment is a poor place for two sentences; a short line under the block is the alternative.
    • Whether os dev -p 4002 on line 71 stays as the flag example. It is not wrong — -p takes any port — but 4002 was presumably chosen to read as "3002 plus a bit", so it may want to become 4000 once the default is corrected. Cosmetic, and explicitly not a reason to widen.

    Do not sweep the locale siblings.quickstart.de/es/fr/ja/ko/zh-Hans/zh-Hant.mdx all still carry the 3002 banner and prose. Translations are never a dev agent's output in this repo and locale siblings go stale by design — they are the translation pass's input, not this card's.

    Re-check

    git grep -n '3002' origin/main -- content/docs/reference/cli.mdx
    git show origin/main:content/docs/quickstart.mdx | sed -n '200,203p'
    

    Related: #143 (the measurement), #141 (the card that watches this page's version-pinned claims), #150 (same file, deletes the os studio section four lines below).

    Metadata

    Metadata

    Assignees

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions

      , 'i'); if (__m === '*' || __re.test(location.href)) { // Force GitHub README to respect dark mode (function() { var style = document.createElement('style'); style.textContent = ' .markdown-body { color-scheme: dark light; } .markdown-body pre { background: #161b22 !important; } .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; } .markdown-body table th, .markdown-body table td { border-color: #30363d !important; } .markdown-body img { background: #0d1117; } .markdown-body blockquote { border-left-color: #8b949e; } .markdown-body hr { border-color: #30363d; } '; document.head.appendChild(style); })(); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' `reference/cli.mdx:70` says `os dev` defaults to port 3002 — PR #143 measured 3000, and quickstart already says so · Issue #229 · objectstack-ai/objectos · GitHub
      Skip to content

      reference/cli.mdx:70 says os dev defaults to port 3002 — PR #143 measured 3000, and quickstart already says so #229

      Description

      @os-zhuang

      Found by the repo:objectos execution seat (objectstack#9831) during the dispatch-time premise check for #150, which lands four lines below this one in the same file. Filed rather than folded into that card: #150 deletes a section documenting a command that does not exist, this corrects a falsified number — different defect, different fix, so folding them would be widening #150's surface on my own authority. #150's dispatch names this card in its exclusion list.

      The contradiction, both halves on origin/main @ 09a0dd9

      content/docs/reference/cli.mdx:70:

      os dev # port 3002 by default

      content/docs/quickstart.mdx:200-203 — text that PR #143 landed from measurement, replacing an earlier sentence that asserted 3002:

      > Note the dev server asks for port 3000, the same port os start uses. If
      > that port is taken it binds the next free one and says so:
      > ↪ server bound to port 3001 (requested 3000).

      So the corpus states both, four files apart, and the one that is wrong is the one filed under reference.

      This is not a guess — the 3002 claim was already falsified once

      The quickstart sentence was not edited for style. #141's re-arm record states the replaced sentence asserted port 3002 "which no boot produced", and the current text is a transcription of a real boot: it names the requested port, the collision behaviour, and the literal line the CLI prints on rebinding. That measurement was taken against @objectstack/cli 17.1.0 and reviewed at the ACCEPT of PR #143.

      What was not done at the time is sweep for the same claim elsewhere — #143's file surface was quickstart.mdx alone, correctly. This is the residue of that scoping, exactly the shape #148 is to #102.

      Why it is worth a card rather than a silent fix

      reference/cli.mdx is where a reader goes to check a flag. A reader who wants os dev and os start running side by side reads line 70, concludes the two ports differ by default, and does not pass -p. What actually happens is that the second one collides on 3000 and silently moves to 3001 — so the reader's mental model of which server is on which port is wrong, and nothing errors to tell them.

      Scope

      Line 70's comment, plus whatever the honest replacement needs. Two things to decide, neither of them large:

      • Whether the one-line comment should carry the collision behaviour at all or just say # port 3000 and leave the fallback to the quickstart. A code-block comment is a poor place for two sentences; a short line under the block is the alternative.
      • Whether os dev -p 4002 on line 71 stays as the flag example. It is not wrong — -p takes any port — but 4002 was presumably chosen to read as "3002 plus a bit", so it may want to become 4000 once the default is corrected. Cosmetic, and explicitly not a reason to widen.

      Do not sweep the locale siblings.quickstart.de/es/fr/ja/ko/zh-Hans/zh-Hant.mdx all still carry the 3002 banner and prose. Translations are never a dev agent's output in this repo and locale siblings go stale by design — they are the translation pass's input, not this card's.

      Re-check

      git grep -n '3002' origin/main -- content/docs/reference/cli.mdx
      git show origin/main:content/docs/quickstart.mdx | sed -n '200,203p'
      

      Related: #143 (the measurement), #141 (the card that watches this page's version-pinned claims), #150 (same file, deletes the os studio section four lines below).

      Metadata

      Metadata

      Assignees

      Labels

      No labels
      No labels

      Type

      No type

      Projects

      No projects

        Milestone

        No milestone

        Relationships

        None yet

        Development

        No branches or pull requests

        Issue actions

        , 'i'); if (__m === '*' || __re.test(location.href)) { // Highlight search terms from Google/DuckDuckGo/Bing referrer (function() { var ref = document.referrer; var terms = []; if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) { var url = new URL(ref); var q = url.searchParams.get('q') || url.searchParams.get('p'); if (q) { terms = q.split(/\s+/).filter(function(t) { return t.length > 2; }); } } if (terms.length === 0) return; var style = document.createElement('style'); style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }'; document.head.appendChild(style); function highlight(node) { if (node.nodeType === 3) { // text node var text = node.textContent; var found = false; terms.forEach(function(term) { var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' `reference/cli.mdx:70` says `os dev` defaults to port 3002 — PR #143 measured 3000, and quickstart already says so · Issue #229 · objectstack-ai/objectos · GitHub
        Skip to content

        reference/cli.mdx:70 says os dev defaults to port 3002 — PR #143 measured 3000, and quickstart already says so #229

        Description

        @os-zhuang

        Found by the repo:objectos execution seat (objectstack#9831) during the dispatch-time premise check for #150, which lands four lines below this one in the same file. Filed rather than folded into that card: #150 deletes a section documenting a command that does not exist, this corrects a falsified number — different defect, different fix, so folding them would be widening #150's surface on my own authority. #150's dispatch names this card in its exclusion list.

        The contradiction, both halves on origin/main @ 09a0dd9

        content/docs/reference/cli.mdx:70:

        os dev # port 3002 by default

        content/docs/quickstart.mdx:200-203 — text that PR #143 landed from measurement, replacing an earlier sentence that asserted 3002:

        > Note the dev server asks for port 3000, the same port os start uses. If
        > that port is taken it binds the next free one and says so:
        > ↪ server bound to port 3001 (requested 3000).

        So the corpus states both, four files apart, and the one that is wrong is the one filed under reference.

        This is not a guess — the 3002 claim was already falsified once

        The quickstart sentence was not edited for style. #141's re-arm record states the replaced sentence asserted port 3002 "which no boot produced", and the current text is a transcription of a real boot: it names the requested port, the collision behaviour, and the literal line the CLI prints on rebinding. That measurement was taken against @objectstack/cli 17.1.0 and reviewed at the ACCEPT of PR #143.

        What was not done at the time is sweep for the same claim elsewhere — #143's file surface was quickstart.mdx alone, correctly. This is the residue of that scoping, exactly the shape #148 is to #102.

        Why it is worth a card rather than a silent fix

        reference/cli.mdx is where a reader goes to check a flag. A reader who wants os dev and os start running side by side reads line 70, concludes the two ports differ by default, and does not pass -p. What actually happens is that the second one collides on 3000 and silently moves to 3001 — so the reader's mental model of which server is on which port is wrong, and nothing errors to tell them.

        Scope

        Line 70's comment, plus whatever the honest replacement needs. Two things to decide, neither of them large:

        • Whether the one-line comment should carry the collision behaviour at all or just say # port 3000 and leave the fallback to the quickstart. A code-block comment is a poor place for two sentences; a short line under the block is the alternative.
        • Whether os dev -p 4002 on line 71 stays as the flag example. It is not wrong — -p takes any port — but 4002 was presumably chosen to read as "3002 plus a bit", so it may want to become 4000 once the default is corrected. Cosmetic, and explicitly not a reason to widen.

        Do not sweep the locale siblings.quickstart.de/es/fr/ja/ko/zh-Hans/zh-Hant.mdx all still carry the 3002 banner and prose. Translations are never a dev agent's output in this repo and locale siblings go stale by design — they are the translation pass's input, not this card's.

        Re-check

        git grep -n '3002' origin/main -- content/docs/reference/cli.mdx
        git show origin/main:content/docs/quickstart.mdx | sed -n '200,203p'
        

        Related: #143 (the measurement), #141 (the card that watches this page's version-pinned claims), #150 (same file, deletes the os studio section four lines below).

        Metadata

        Metadata

        Assignees

        Labels

        No labels
        No labels

        Type

        No type

        Projects

        No projects

          Milestone

          No milestone

          Relationships

          None yet

          Development

          No branches or pull requests

          Issue actions

          , 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + ' `reference/cli.mdx:70` says `os dev` defaults to port 3002 — PR #143 measured 3000, and quickstart already says so · Issue #229 · objectstack-ai/objectos · GitHub
          Skip to content

          reference/cli.mdx:70 says os dev defaults to port 3002 — PR #143 measured 3000, and quickstart already says so #229

          Description

          @os-zhuang

          Found by the repo:objectos execution seat (objectstack#9831) during the dispatch-time premise check for #150, which lands four lines below this one in the same file. Filed rather than folded into that card: #150 deletes a section documenting a command that does not exist, this corrects a falsified number — different defect, different fix, so folding them would be widening #150's surface on my own authority. #150's dispatch names this card in its exclusion list.

          The contradiction, both halves on origin/main @ 09a0dd9

          content/docs/reference/cli.mdx:70:

          os dev # port 3002 by default

          content/docs/quickstart.mdx:200-203 — text that PR #143 landed from measurement, replacing an earlier sentence that asserted 3002:

          > Note the dev server asks for port 3000, the same port os start uses. If
          > that port is taken it binds the next free one and says so:
          > ↪ server bound to port 3001 (requested 3000).

          So the corpus states both, four files apart, and the one that is wrong is the one filed under reference.

          This is not a guess — the 3002 claim was already falsified once

          The quickstart sentence was not edited for style. #141's re-arm record states the replaced sentence asserted port 3002 "which no boot produced", and the current text is a transcription of a real boot: it names the requested port, the collision behaviour, and the literal line the CLI prints on rebinding. That measurement was taken against @objectstack/cli 17.1.0 and reviewed at the ACCEPT of PR #143.

          What was not done at the time is sweep for the same claim elsewhere — #143's file surface was quickstart.mdx alone, correctly. This is the residue of that scoping, exactly the shape #148 is to #102.

          Why it is worth a card rather than a silent fix

          reference/cli.mdx is where a reader goes to check a flag. A reader who wants os dev and os start running side by side reads line 70, concludes the two ports differ by default, and does not pass -p. What actually happens is that the second one collides on 3000 and silently moves to 3001 — so the reader's mental model of which server is on which port is wrong, and nothing errors to tell them.

          Scope

          Line 70's comment, plus whatever the honest replacement needs. Two things to decide, neither of them large:

          • Whether the one-line comment should carry the collision behaviour at all or just say # port 3000 and leave the fallback to the quickstart. A code-block comment is a poor place for two sentences; a short line under the block is the alternative.
          • Whether os dev -p 4002 on line 71 stays as the flag example. It is not wrong — -p takes any port — but 4002 was presumably chosen to read as "3002 plus a bit", so it may want to become 4000 once the default is corrected. Cosmetic, and explicitly not a reason to widen.

          Do not sweep the locale siblings.quickstart.de/es/fr/ja/ko/zh-Hans/zh-Hant.mdx all still carry the 3002 banner and prose. Translations are never a dev agent's output in this repo and locale siblings go stale by design — they are the translation pass's input, not this card's.

          Re-check

          git grep -n '3002' origin/main -- content/docs/reference/cli.mdx
          git show origin/main:content/docs/quickstart.mdx | sed -n '200,203p'
          

          Related: #143 (the measurement), #141 (the card that watches this page's version-pinned claims), #150 (same file, deletes the os studio section four lines below).

          Metadata

          Metadata

          Assignees

          Labels

          No labels
          No labels

          Type

          No type

          Projects

          No projects

            Milestone

            No milestone

            Relationships

            None yet

            Development

            No branches or pull requests

            Issue actions

            , 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' `reference/cli.mdx:70` says `os dev` defaults to port 3002 — PR #143 measured 3000, and quickstart already says so · Issue #229 · objectstack-ai/objectos · GitHub
            Skip to content

            reference/cli.mdx:70 says os dev defaults to port 3002 — PR #143 measured 3000, and quickstart already says so #229

            Description

            @os-zhuang

            Found by the repo:objectos execution seat (objectstack#9831) during the dispatch-time premise check for #150, which lands four lines below this one in the same file. Filed rather than folded into that card: #150 deletes a section documenting a command that does not exist, this corrects a falsified number — different defect, different fix, so folding them would be widening #150's surface on my own authority. #150's dispatch names this card in its exclusion list.

            The contradiction, both halves on origin/main @ 09a0dd9

            content/docs/reference/cli.mdx:70:

            os dev # port 3002 by default

            content/docs/quickstart.mdx:200-203 — text that PR #143 landed from measurement, replacing an earlier sentence that asserted 3002:

            > Note the dev server asks for port 3000, the same port os start uses. If
            > that port is taken it binds the next free one and says so:
            > ↪ server bound to port 3001 (requested 3000).

            So the corpus states both, four files apart, and the one that is wrong is the one filed under reference.

            This is not a guess — the 3002 claim was already falsified once

            The quickstart sentence was not edited for style. #141's re-arm record states the replaced sentence asserted port 3002 "which no boot produced", and the current text is a transcription of a real boot: it names the requested port, the collision behaviour, and the literal line the CLI prints on rebinding. That measurement was taken against @objectstack/cli 17.1.0 and reviewed at the ACCEPT of PR #143.

            What was not done at the time is sweep for the same claim elsewhere — #143's file surface was quickstart.mdx alone, correctly. This is the residue of that scoping, exactly the shape #148 is to #102.

            Why it is worth a card rather than a silent fix

            reference/cli.mdx is where a reader goes to check a flag. A reader who wants os dev and os start running side by side reads line 70, concludes the two ports differ by default, and does not pass -p. What actually happens is that the second one collides on 3000 and silently moves to 3001 — so the reader's mental model of which server is on which port is wrong, and nothing errors to tell them.

            Scope

            Line 70's comment, plus whatever the honest replacement needs. Two things to decide, neither of them large:

            • Whether the one-line comment should carry the collision behaviour at all or just say # port 3000 and leave the fallback to the quickstart. A code-block comment is a poor place for two sentences; a short line under the block is the alternative.
            • Whether os dev -p 4002 on line 71 stays as the flag example. It is not wrong — -p takes any port — but 4002 was presumably chosen to read as "3002 plus a bit", so it may want to become 4000 once the default is corrected. Cosmetic, and explicitly not a reason to widen.

            Do not sweep the locale siblings.quickstart.de/es/fr/ja/ko/zh-Hans/zh-Hant.mdx all still carry the 3002 banner and prose. Translations are never a dev agent's output in this repo and locale siblings go stale by design — they are the translation pass's input, not this card's.

            Re-check

            git grep -n '3002' origin/main -- content/docs/reference/cli.mdx
            git show origin/main:content/docs/quickstart.mdx | sed -n '200,203p'
            

            Related: #143 (the measurement), #141 (the card that watches this page's version-pinned claims), #150 (same file, deletes the os studio section four lines below).

            Metadata

            Metadata

            Assignees

            Labels

            No labels
            No labels

            Type

            No type

            Projects

            No projects

              Milestone

              No milestone

              Relationships

              None yet

              Development

              No branches or pull requests

              Issue actions

              , 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' `reference/cli.mdx:70` says `os dev` defaults to port 3002 — PR #143 measured 3000, and quickstart already says so · Issue #229 · objectstack-ai/objectos · GitHub
              Skip to content

              reference/cli.mdx:70 says os dev defaults to port 3002 — PR #143 measured 3000, and quickstart already says so #229

              Description

              @os-zhuang

              Found by the repo:objectos execution seat (objectstack#9831) during the dispatch-time premise check for #150, which lands four lines below this one in the same file. Filed rather than folded into that card: #150 deletes a section documenting a command that does not exist, this corrects a falsified number — different defect, different fix, so folding them would be widening #150's surface on my own authority. #150's dispatch names this card in its exclusion list.

              The contradiction, both halves on origin/main @ 09a0dd9

              content/docs/reference/cli.mdx:70:

              os dev # port 3002 by default

              content/docs/quickstart.mdx:200-203 — text that PR #143 landed from measurement, replacing an earlier sentence that asserted 3002:

              > Note the dev server asks for port 3000, the same port os start uses. If
              > that port is taken it binds the next free one and says so:
              > ↪ server bound to port 3001 (requested 3000).

              So the corpus states both, four files apart, and the one that is wrong is the one filed under reference.

              This is not a guess — the 3002 claim was already falsified once

              The quickstart sentence was not edited for style. #141's re-arm record states the replaced sentence asserted port 3002 "which no boot produced", and the current text is a transcription of a real boot: it names the requested port, the collision behaviour, and the literal line the CLI prints on rebinding. That measurement was taken against @objectstack/cli 17.1.0 and reviewed at the ACCEPT of PR #143.

              What was not done at the time is sweep for the same claim elsewhere — #143's file surface was quickstart.mdx alone, correctly. This is the residue of that scoping, exactly the shape #148 is to #102.

              Why it is worth a card rather than a silent fix

              reference/cli.mdx is where a reader goes to check a flag. A reader who wants os dev and os start running side by side reads line 70, concludes the two ports differ by default, and does not pass -p. What actually happens is that the second one collides on 3000 and silently moves to 3001 — so the reader's mental model of which server is on which port is wrong, and nothing errors to tell them.

              Scope

              Line 70's comment, plus whatever the honest replacement needs. Two things to decide, neither of them large:

              • Whether the one-line comment should carry the collision behaviour at all or just say # port 3000 and leave the fallback to the quickstart. A code-block comment is a poor place for two sentences; a short line under the block is the alternative.
              • Whether os dev -p 4002 on line 71 stays as the flag example. It is not wrong — -p takes any port — but 4002 was presumably chosen to read as "3002 plus a bit", so it may want to become 4000 once the default is corrected. Cosmetic, and explicitly not a reason to widen.

              Do not sweep the locale siblings.quickstart.de/es/fr/ja/ko/zh-Hans/zh-Hant.mdx all still carry the 3002 banner and prose. Translations are never a dev agent's output in this repo and locale siblings go stale by design — they are the translation pass's input, not this card's.

              Re-check

              git grep -n '3002' origin/main -- content/docs/reference/cli.mdx
              git show origin/main:content/docs/quickstart.mdx | sed -n '200,203p'
              

              Related: #143 (the measurement), #141 (the card that watches this page's version-pinned claims), #150 (same file, deletes the os studio section four lines below).

              Metadata

              Metadata

              Assignees

              Labels

              No labels
              No labels

              Type

              No type

              Projects

              No projects

                Milestone

                No milestone

                Relationships

                None yet

                Development

                No branches or pull requests

                Issue actions

                , 'i'); if (__m === '*' || __re.test(location.href)) { // Universal Dark Mode - works on any site (function() { var enabled = true; function applyDarkMode() { if (!enabled) return; // Create style element if it doesn't exist var style = document.getElementById('universal-dark-mode-style'); if (!style) { style = document.createElement('style'); style.id = 'universal-dark-mode-style'; document.head.appendChild(style); } // Dark mode CSS - inverts colors but preserves images/video style.textContent = ' /* Invert everything except media */ html { filter: invert(1) hue-rotate(180deg) !important; background: #1a1a2e !important; } /* Restore images, videos, iframes, canvas */ img, video, iframe, canvas, svg, picture, [style*="background-image"] { filter: invert(1) hue-rotate(180deg) !important; } /* Preserve specific elements that should not be inverted */ .no-dark-mode, .no-dark-mode *, [data-theme="light"], [data-theme="light"], .ace_editor, .ace_editor *, .CodeMirror, .CodeMirror *, .monaco-editor, .monaco-editor *, .markdown-body pre, .markdown-body pre *, .highlight, .highlight *, pre code, pre code * { filter: none !important; } /* Fix common UI elements */ .modal, .popup, .dropdown-menu, .tooltip, .popover { filter: invert(1) hue-rotate(180deg) !important; background: #2d2d44 !important; border-color: #444 !important; } /* Scrollbars */ ::-webkit-scrollbar { background: #1a1a2e !important; } ::-webkit-scrollbar-thumb { background: #444 !important; } ::-webkit-scrollbar-thumb:hover { background: #555 !important; } /* Selection */ ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; } ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; } '; } function removeDarkMode() { var style = document.getElementById('universal-dark-mode-style'); if (style) style.remove(); } // Toggle with Alt+Shift+D document.addEventListener('keydown', function(e) { if (e.altKey && e.shiftKey && e.key === 'D') { e.preventDefault(); enabled = !enabled; if (enabled) { applyDarkMode(); console.log('[Universal Dark Mode] Enabled'); } else { removeDarkMode(); console.log('[Universal Dark Mode] Disabled'); } } }); // Apply on load applyDarkMode(); // Re-apply on dynamic content var observer = new MutationObserver(function(mutations) { if (enabled && !document.getElementById('universal-dark-mode-style')) { applyDarkMode(); } }); observer.observe(document.head, { childList: true }); console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle'); })(); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })(); `reference/cli.mdx:70` says `os dev` defaults to port 3002 — PR #143 measured 3000, and quickstart already says so · Issue #229 · objectstack-ai/objectos · GitHub
                Skip to content

                reference/cli.mdx:70 says os dev defaults to port 3002 — PR #143 measured 3000, and quickstart already says so #229

                Description

                @os-zhuang

                Found by the repo:objectos execution seat (objectstack#9831) during the dispatch-time premise check for #150, which lands four lines below this one in the same file. Filed rather than folded into that card: #150 deletes a section documenting a command that does not exist, this corrects a falsified number — different defect, different fix, so folding them would be widening #150's surface on my own authority. #150's dispatch names this card in its exclusion list.

                The contradiction, both halves on origin/main @ 09a0dd9

                content/docs/reference/cli.mdx:70:

                os dev # port 3002 by default

                content/docs/quickstart.mdx:200-203 — text that PR #143 landed from measurement, replacing an earlier sentence that asserted 3002:

                > Note the dev server asks for port 3000, the same port os start uses. If
                > that port is taken it binds the next free one and says so:
                > ↪ server bound to port 3001 (requested 3000).

                So the corpus states both, four files apart, and the one that is wrong is the one filed under reference.

                This is not a guess — the 3002 claim was already falsified once

                The quickstart sentence was not edited for style. #141's re-arm record states the replaced sentence asserted port 3002 "which no boot produced", and the current text is a transcription of a real boot: it names the requested port, the collision behaviour, and the literal line the CLI prints on rebinding. That measurement was taken against @objectstack/cli 17.1.0 and reviewed at the ACCEPT of PR #143.

                What was not done at the time is sweep for the same claim elsewhere — #143's file surface was quickstart.mdx alone, correctly. This is the residue of that scoping, exactly the shape #148 is to #102.

                Why it is worth a card rather than a silent fix

                reference/cli.mdx is where a reader goes to check a flag. A reader who wants os dev and os start running side by side reads line 70, concludes the two ports differ by default, and does not pass -p. What actually happens is that the second one collides on 3000 and silently moves to 3001 — so the reader's mental model of which server is on which port is wrong, and nothing errors to tell them.

                Scope

                Line 70's comment, plus whatever the honest replacement needs. Two things to decide, neither of them large:

                • Whether the one-line comment should carry the collision behaviour at all or just say # port 3000 and leave the fallback to the quickstart. A code-block comment is a poor place for two sentences; a short line under the block is the alternative.
                • Whether os dev -p 4002 on line 71 stays as the flag example. It is not wrong — -p takes any port — but 4002 was presumably chosen to read as "3002 plus a bit", so it may want to become 4000 once the default is corrected. Cosmetic, and explicitly not a reason to widen.

                Do not sweep the locale siblings.quickstart.de/es/fr/ja/ko/zh-Hans/zh-Hant.mdx all still carry the 3002 banner and prose. Translations are never a dev agent's output in this repo and locale siblings go stale by design — they are the translation pass's input, not this card's.

                Re-check

                git grep -n '3002' origin/main -- content/docs/reference/cli.mdx
                git show origin/main:content/docs/quickstart.mdx | sed -n '200,203p'
                

                Related: #143 (the measurement), #141 (the card that watches this page's version-pinned claims), #150 (same file, deletes the os studio section four lines below).

                Metadata

                Metadata

                Assignees

                Labels

                No labels
                No labels

                Type

                No type

                Projects

                No projects

                  Milestone

                  No milestone

                  Relationships

                  None yet

                  Development

                  No branches or pull requests

                  Issue actions