@profullstack/board-saas 0.0.0-stage → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +93 -2
- package/bin/board-saas.js +10 -0
- package/package.json +52 -4
- package/public/app.js +95 -0
- package/public/index.html +103 -0
- package/public/style.css +46 -0
- package/src/cli.js +203 -0
- package/src/client.js +111 -0
- package/src/db.js +176 -0
- package/src/experts/cfo.md +27 -0
- package/src/experts/chair.md +55 -0
- package/src/experts/contrarian.md +26 -0
- package/src/experts/founder-time.md +27 -0
- package/src/experts/growth.md +26 -0
- package/src/experts/operator.md +28 -0
- package/src/experts.js +35 -0
- package/src/footers.js +52 -0
- package/src/llm.js +94 -0
- package/src/mail.js +58 -0
- package/src/mcp-stdio.js +24 -0
- package/src/mcp.js +113 -0
- package/src/meeting.js +195 -0
- package/src/pages.js +94 -0
- package/src/render-report.js +160 -0
- package/src/server.js +258 -0
- package/src/service.js +281 -0
- package/src/tui.js +119 -0
- package/src/validate.js +187 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Profullstack, Inc.
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,94 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Board as a Service
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
**https://board.saas.pit.world** (Moshpit name `board.saas`)
|
|
4
|
+
|
|
5
|
+
Paste a decision brief. Five AI advisors give independent verdicts, debate each other by
|
|
6
|
+
name, and a chair writes the minutes: the vote, where they clashed, the strongest dissent,
|
|
7
|
+
a recommendation and the one question you still need to answer. You get an interactive
|
|
8
|
+
report at a shareable link, downloadable as one HTML file.
|
|
9
|
+
|
|
10
|
+
The advisors are AI models running on the [c0mpute](https://c0mpute.com) peer network.
|
|
11
|
+
They are not real directors, and nothing here is legal, tax or investment advice.
|
|
12
|
+
|
|
13
|
+
It productizes the open-source [boardroom](https://github.com/profullstack/boardroom)
|
|
14
|
+
Claude Code plugin: the expert personas are its skill texts (`src/experts/*.md`), the
|
|
15
|
+
meeting follows its `commands/meet.md`, and the report is its `render-report.mjs`.
|
|
16
|
+
|
|
17
|
+
## The board
|
|
18
|
+
|
|
19
|
+
| id | Member | Lens |
|
|
20
|
+
| --- | --- | --- |
|
|
21
|
+
| cfo | The CFO | cash, runway, unit economics, payback |
|
|
22
|
+
| growth | The Growth Marketer | audience, distribution, revenue growth |
|
|
23
|
+
| operator | The Operator | systems, delegation readiness, execution |
|
|
24
|
+
| founder-time | The Founder-Time Strategist | founder hours, highest-value work |
|
|
25
|
+
| contrarian | The Contrarian Investor | inversion, reversibility, opportunity cost |
|
|
26
|
+
|
|
27
|
+
The chair runs the meeting and never votes.
|
|
28
|
+
|
|
29
|
+
## How a meeting runs
|
|
30
|
+
|
|
31
|
+
0. **Brief check.** The chair extracts the decision, options and constraints. If one is
|
|
32
|
+
missing it asks once (`needs_clarification`); anything still missing becomes a written
|
|
33
|
+
assumption.
|
|
34
|
+
1. **Verdicts.** Five calls in parallel; each sees only the brief.
|
|
35
|
+
2. **Debate.** Five calls in parallel; each reads all five named verdicts.
|
|
36
|
+
3. **Minutes.** One chair call. The vote table is built from what each member said.
|
|
37
|
+
|
|
38
|
+
Every answer is JSON, validated per round, retried once with the error spelled out. If
|
|
39
|
+
c0mpute cannot answer, the meeting fails with the real error and is refunded. There is no
|
|
40
|
+
paid-model fallback in the code at all.
|
|
41
|
+
|
|
42
|
+
## Pricing
|
|
43
|
+
|
|
44
|
+
First meeting free per email address, then $9 per meeting through CoinPay (crypto).
|
|
45
|
+
|
|
46
|
+
## Surfaces
|
|
47
|
+
|
|
48
|
+
All four are thin clients over the same HTTP API.
|
|
49
|
+
|
|
50
|
+
```sh
|
|
51
|
+
# CLI
|
|
52
|
+
npm i -g @profullstack/board-saas # or: curl -fsSL https://board.saas.pit.world/install.sh | sh
|
|
53
|
+
board-saas login you@example.com
|
|
54
|
+
board-saas meet "Decision: ... Options: ... Constraints: ..." --out report.html
|
|
55
|
+
board-saas get <id> | list | clarify <id> "<answers>" | report <id>
|
|
56
|
+
|
|
57
|
+
# TUI
|
|
58
|
+
board-saas tui
|
|
59
|
+
|
|
60
|
+
# MCP (tools: run_meeting, get_meeting)
|
|
61
|
+
claude mcp add --transport http board-saas https://board.saas.pit.world/mcp --header "Authorization: Bearer $BOARD_SAAS_KEY"
|
|
62
|
+
claude mcp add board-saas -- npx -y @profullstack/board-saas mcp # stdio
|
|
63
|
+
|
|
64
|
+
# HTTP API: https://board.saas.pit.world/api/v1
|
|
65
|
+
curl -X POST https://board.saas.pit.world/api/v1/auth/code -H 'content-type: application/json' -d '{"email":"you@example.com"}'
|
|
66
|
+
curl -X POST https://board.saas.pit.world/api/v1/auth/verify -H 'content-type: application/json' -d '{"email":"you@example.com","code":"123456"}'
|
|
67
|
+
curl -X POST https://board.saas.pit.world/api/v1/meetings -H "Authorization: Bearer $BOARD_SAAS_KEY" -H 'content-type: application/json' -d '{"brief":"..."}'
|
|
68
|
+
curl https://board.saas.pit.world/api/v1/meetings/<id>
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
## Running it
|
|
72
|
+
|
|
73
|
+
Node 22.6+ (uses `node:sqlite`). Configuration comes from the logicsrc vault
|
|
74
|
+
`profullstack/board-saas--prod` (synced into an env file by `deploy/deploy.sh`):
|
|
75
|
+
`C0MPUTE_API_KEY`, `C0MPUTE_MODELS`, `RESEND_API_KEY`, `BOARD_SAAS_ADMIN_KEY`,
|
|
76
|
+
`COINPAY_API_URL`, `COINPAY_BUSINESS_ID`, `COINPAY_API_KEY`, `COINPAY_WEBHOOK_SECRET`.
|
|
77
|
+
Optional: `C0MPUTE_SITE_URL` (the c0mpute-hosted copy of the front page), `PORT`,
|
|
78
|
+
`BOARD_DB`, `PUBLIC_URL`.
|
|
79
|
+
|
|
80
|
+
```sh
|
|
81
|
+
npm install
|
|
82
|
+
npm test
|
|
83
|
+
node scripts/build-static.mjs # ./site, footers baked in; published to c0mpute hosting
|
|
84
|
+
node src/server.js
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
Hosting: the front page is published on the c0mpute network (three self-healing copies)
|
|
88
|
+
and served at board.saas.pit.world by the app, which proxies it with its own build as the
|
|
89
|
+
fallback. The API, MCP endpoint and meeting runner are a systemd unit on dev2 behind the
|
|
90
|
+
Moshpit origin (`deploy/`).
|
|
91
|
+
|
|
92
|
+
## License
|
|
93
|
+
|
|
94
|
+
MIT
|
package/package.json
CHANGED
|
@@ -1,6 +1,54 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@profullstack/board-saas",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "0.1.1",
|
|
4
|
+
"description": "Board as a Service: paste a decision brief, five AI advisors (CFO, Growth, Operator, Founder-Time, Contrarian) debate it in three rounds and a chair writes the minutes. Web, HTTP API, CLI, TUI and MCP. Runs on c0mpute.",
|
|
5
|
+
"license": "MIT",
|
|
6
|
+
"type": "module",
|
|
7
|
+
"homepage": "https://board.saas.pit.world",
|
|
8
|
+
"repository": {
|
|
9
|
+
"type": "git",
|
|
10
|
+
"url": "git+https://github.com/profullstack/board-saas.git"
|
|
11
|
+
},
|
|
12
|
+
"bin": {
|
|
13
|
+
"board-saas": "bin/board-saas.js"
|
|
14
|
+
},
|
|
15
|
+
"exports": {
|
|
16
|
+
".": "./src/client.js",
|
|
17
|
+
"./client": "./src/client.js",
|
|
18
|
+
"./render-report": "./src/render-report.js"
|
|
19
|
+
},
|
|
20
|
+
"files": [
|
|
21
|
+
"bin",
|
|
22
|
+
"src",
|
|
23
|
+
"public",
|
|
24
|
+
"README.md",
|
|
25
|
+
"LICENSE"
|
|
26
|
+
],
|
|
27
|
+
"engines": {
|
|
28
|
+
"node": ">=22.6"
|
|
29
|
+
},
|
|
30
|
+
"scripts": {
|
|
31
|
+
"start": "node src/server.js",
|
|
32
|
+
"test": "node --test test/*.test.js",
|
|
33
|
+
"build:static": "node scripts/build-static.mjs"
|
|
34
|
+
},
|
|
35
|
+
"dependencies": {
|
|
36
|
+
"@profullstack/ai-providers": "^0.3.2",
|
|
37
|
+
"@profullstack/coinpay-onboard": "^0.5.1",
|
|
38
|
+
"@profullstack/cross-promo": "^0.2.0",
|
|
39
|
+
"@profullstack/footer": "latest",
|
|
40
|
+
"@profullstack/hqtui": "^0.12.0"
|
|
41
|
+
},
|
|
42
|
+
"keywords": [
|
|
43
|
+
"board of advisors",
|
|
44
|
+
"decision making",
|
|
45
|
+
"ai advisors",
|
|
46
|
+
"board meeting",
|
|
47
|
+
"c0mpute",
|
|
48
|
+
"mcp",
|
|
49
|
+
"mcp server",
|
|
50
|
+
"cli",
|
|
51
|
+
"tui",
|
|
52
|
+
"moshpit"
|
|
53
|
+
]
|
|
54
|
+
}
|
package/public/app.js
ADDED
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
// Board as a Service front page. Talks only to /api (absolute when served from the c0mpute
|
|
2
|
+
// gateway, which is a different origin). Auth is an API key kept in localStorage.
|
|
3
|
+
(function () {
|
|
4
|
+
'use strict';
|
|
5
|
+
var HOME = 'https://board.saas.pit.world';
|
|
6
|
+
var onHome = /(^|\.)board\.saas(\.pit\.world)?$/.test(location.hostname);
|
|
7
|
+
var API = onHome ? '' : HOME;
|
|
8
|
+
var KEY = 'board-saas:key';
|
|
9
|
+
var EMAIL = 'board-saas:email';
|
|
10
|
+
|
|
11
|
+
function store(k, v) { try { if (v === null) localStorage.removeItem(k); else localStorage.setItem(k, v); } catch (e) {} }
|
|
12
|
+
function load(k) { try { return localStorage.getItem(k); } catch (e) { return null; } }
|
|
13
|
+
|
|
14
|
+
var $ = function (id) { return document.getElementById(id); };
|
|
15
|
+
var form = $('meet-form'), brief = $('brief'), email = $('email'), code = $('code');
|
|
16
|
+
var codeRow = $('code-row'), status = $('status'), submit = $('submit');
|
|
17
|
+
var signedOut = $('signed-out'), signedIn = $('signed-in'), count = $('count');
|
|
18
|
+
|
|
19
|
+
var EXAMPLE = 'Decision: should I raise prices on my $29/month SaaS, and by how much?\n' +
|
|
20
|
+
'Options: keep $29; raise to $39 for new customers only; raise to $39 for everyone with 60 days notice; add a $79 tier and keep $29.\n' +
|
|
21
|
+
'Constraints: 410 paying customers, 3.1% monthly churn, solo founder working about 30 hours a week, 7 months of runway, no sales team.';
|
|
22
|
+
|
|
23
|
+
function say(text, bad) { status.textContent = text; status.className = 'status' + (bad ? ' bad' : ''); }
|
|
24
|
+
|
|
25
|
+
async function api(path, opts) {
|
|
26
|
+
opts = opts || {};
|
|
27
|
+
var headers = { 'content-type': 'application/json' };
|
|
28
|
+
var key = load(KEY);
|
|
29
|
+
if (key && opts.auth !== false) headers.authorization = 'Bearer ' + key;
|
|
30
|
+
var res = await fetch(API + path, { method: opts.method || 'GET', headers: headers, body: opts.body ? JSON.stringify(opts.body) : undefined });
|
|
31
|
+
var data = {};
|
|
32
|
+
try { data = await res.json(); } catch (e) {}
|
|
33
|
+
if (!res.ok) { var err = new Error(data.error || ('request failed (' + res.status + ')')); err.status = res.status; throw err; }
|
|
34
|
+
return data;
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
async function refreshAccount() {
|
|
38
|
+
var key = load(KEY);
|
|
39
|
+
if (!key) { signedOut.hidden = false; signedIn.hidden = true; return; }
|
|
40
|
+
try {
|
|
41
|
+
var a = await api('/api/v1/account');
|
|
42
|
+
signedOut.hidden = true; signedIn.hidden = false;
|
|
43
|
+
var what = a.free_meeting_available ? 'your free meeting is ready' : (a.credits > 0 ? a.credits + ' paid meeting(s) left' : 'next meeting is $' + a.price_usd + ' in crypto');
|
|
44
|
+
signedIn.innerHTML = '';
|
|
45
|
+
signedIn.appendChild(document.createTextNode('Signed in as ' + (a.email || 'admin') + ' · ' + what + ' · '));
|
|
46
|
+
var out = document.createElement('button');
|
|
47
|
+
out.type = 'button'; out.className = 'link'; out.textContent = 'sign out';
|
|
48
|
+
out.onclick = function () { store(KEY, null); refreshAccount(); };
|
|
49
|
+
signedIn.appendChild(out);
|
|
50
|
+
} catch (e) {
|
|
51
|
+
if (e.status === 401) { store(KEY, null); signedOut.hidden = false; signedIn.hidden = true; }
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
async function startMeeting() {
|
|
56
|
+
say('Convening the board…');
|
|
57
|
+
var m = await api('/api/v1/meetings', { method: 'POST', body: { brief: brief.value } });
|
|
58
|
+
if (m.status === 'awaiting_payment' && m.checkout_url) {
|
|
59
|
+
say('Your free meeting is used. Taking you to CoinPay to pay $' + m.price_usd + '…');
|
|
60
|
+
location.href = m.checkout_url;
|
|
61
|
+
return;
|
|
62
|
+
}
|
|
63
|
+
location.href = HOME + '/m/' + m.id;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
form.addEventListener('submit', async function (ev) {
|
|
67
|
+
ev.preventDefault();
|
|
68
|
+
if (brief.value.trim().length < 20) { say('Write a brief first: the decision, the options and the constraints.', true); brief.focus(); return; }
|
|
69
|
+
submit.disabled = true;
|
|
70
|
+
try {
|
|
71
|
+
if (load(KEY)) { await startMeeting(); return; }
|
|
72
|
+
if (!email.value.trim()) { say('Enter your email so we can confirm your free meeting.', true); email.focus(); return; }
|
|
73
|
+
if (codeRow.hidden) {
|
|
74
|
+
var r = await api('/api/v1/auth/code', { method: 'POST', auth: false, body: { email: email.value } });
|
|
75
|
+
store(EMAIL, email.value.trim());
|
|
76
|
+
codeRow.hidden = false; code.focus();
|
|
77
|
+
say(r.message + '. Enter it above, then press Start the meeting again.');
|
|
78
|
+
submit.textContent = 'Confirm code and start';
|
|
79
|
+
return;
|
|
80
|
+
}
|
|
81
|
+
var v = await api('/api/v1/auth/verify', { method: 'POST', auth: false, body: { email: email.value, code: code.value } });
|
|
82
|
+
store(KEY, v.api_key);
|
|
83
|
+
await startMeeting();
|
|
84
|
+
} catch (e) {
|
|
85
|
+
say(e.message, true);
|
|
86
|
+
} finally {
|
|
87
|
+
submit.disabled = false;
|
|
88
|
+
}
|
|
89
|
+
});
|
|
90
|
+
|
|
91
|
+
$('example').addEventListener('click', function () { brief.value = EXAMPLE; brief.dispatchEvent(new Event('input')); brief.focus(); });
|
|
92
|
+
brief.addEventListener('input', function () { count.textContent = brief.value.length + ' / 6000'; });
|
|
93
|
+
if (load(EMAIL)) email.value = load(EMAIL);
|
|
94
|
+
refreshAccount();
|
|
95
|
+
})();
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
<!doctype html>
|
|
2
|
+
<html lang="en">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="utf-8">
|
|
5
|
+
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
6
|
+
<title>Board as a Service</title>
|
|
7
|
+
<meta name="description" content="Paste a decision brief. Five AI advisors (CFO, Growth, Operator, Founder-Time, Contrarian) give verdicts, debate each other, and a chair writes the minutes. First meeting free, then $9 in crypto.">
|
|
8
|
+
<link rel="canonical" href="https://board.saas.pit.world/">
|
|
9
|
+
<meta property="og:title" content="Board as a Service">
|
|
10
|
+
<meta property="og:description" content="Five AI advisors and a chair, on any decision. Three rounds, one interactive report.">
|
|
11
|
+
<meta property="og:url" content="https://board.saas.pit.world/">
|
|
12
|
+
<link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'%3E%3Crect width='32' height='32' rx='7' fill='%232f5bd3'/%3E%3Ccircle cx='9' cy='12' r='3' fill='white'/%3E%3Ccircle cx='16' cy='10' r='3' fill='white'/%3E%3Ccircle cx='23' cy='12' r='3' fill='white'/%3E%3Crect x='6' y='18' width='20' height='5' rx='2' fill='white'/%3E%3C/svg%3E">
|
|
13
|
+
<link rel="stylesheet" href="style.css">
|
|
14
|
+
</head>
|
|
15
|
+
<body>
|
|
16
|
+
<main>
|
|
17
|
+
<header class="hero">
|
|
18
|
+
<p class="eyebrow">Board as a Service</p>
|
|
19
|
+
<h1>Put your decision in front of a board.</h1>
|
|
20
|
+
<p class="lede">Paste a decision brief. Five AI advisors give independent verdicts, argue with each other by name, and a chair writes the minutes: the vote, the clashes, the strongest dissent, a recommendation and the one question you still need to answer.</p>
|
|
21
|
+
<p class="honest">These advisors are AI models running on the <a href="https://c0mpute.com">c0mpute</a> peer network. They are not real directors and this is not legal, tax or investment advice.</p>
|
|
22
|
+
</header>
|
|
23
|
+
|
|
24
|
+
<section class="card" id="convene">
|
|
25
|
+
<h2>Convene the board</h2>
|
|
26
|
+
<form id="meet-form" novalidate>
|
|
27
|
+
<label for="brief">Your brief <span class="hint">the decision, the options, the constraints</span></label>
|
|
28
|
+
<textarea id="brief" name="brief" rows="8" maxlength="6000" required placeholder="Decision: who should my next hire be? Options: a video editor, a sales closer, or no hire yet. Constraints: $3,000/month budget, I work 4 days a week, cash runway is 9 months."></textarea>
|
|
29
|
+
<div class="row">
|
|
30
|
+
<button type="button" class="link" id="example">Use an example brief</button>
|
|
31
|
+
<span class="count" id="count">0 / 6000</span>
|
|
32
|
+
</div>
|
|
33
|
+
|
|
34
|
+
<div id="signed-out">
|
|
35
|
+
<label for="email">Email <span class="hint">your first meeting is free; we send a 6-digit code to confirm it is you</span></label>
|
|
36
|
+
<input id="email" name="email" type="email" autocomplete="email" placeholder="you@example.com">
|
|
37
|
+
<div id="code-row" hidden>
|
|
38
|
+
<label for="code">The 6-digit code we just emailed you</label>
|
|
39
|
+
<input id="code" name="code" inputmode="numeric" autocomplete="one-time-code" maxlength="6" placeholder="123456">
|
|
40
|
+
</div>
|
|
41
|
+
</div>
|
|
42
|
+
<p id="signed-in" hidden></p>
|
|
43
|
+
|
|
44
|
+
<button type="submit" class="primary" id="submit">Start the meeting</button>
|
|
45
|
+
<p class="status" id="status" role="status" aria-live="polite"></p>
|
|
46
|
+
</form>
|
|
47
|
+
</section>
|
|
48
|
+
|
|
49
|
+
<section>
|
|
50
|
+
<h2>How a meeting runs</h2>
|
|
51
|
+
<ol class="steps">
|
|
52
|
+
<li><strong>Brief check.</strong> The chair checks your brief has a decision, at least two options and your constraints. If something is missing it asks once, then works from assumptions it writes down.</li>
|
|
53
|
+
<li><strong>Round 1: verdicts.</strong> Each advisor sees only your brief and answers alone: a call, three reasons from its own frameworks, and one thing to watch out for.</li>
|
|
54
|
+
<li><strong>Round 2: debate.</strong> Each advisor reads all five verdicts with names attached and replies: who it agrees with, who is wrong and why, and whether it changed its mind.</li>
|
|
55
|
+
<li><strong>Round 3: minutes.</strong> The chair records the vote, where they clashed, the strongest dissent, a recommendation that respects your constraints, and the one question to answer before you decide.</li>
|
|
56
|
+
</ol>
|
|
57
|
+
<p>You get an interactive report at a link you can share and download: a tab per verdict, the debate as cards, and the minutes with a copy button. Meetings usually take 2 to 6 minutes, depending on how busy the network is.</p>
|
|
58
|
+
</section>
|
|
59
|
+
|
|
60
|
+
<section>
|
|
61
|
+
<h2>The board</h2>
|
|
62
|
+
<div class="board">
|
|
63
|
+
<article><h3>The CFO</h3><p>Cash, runway, unit economics and payback. Puts a number on everything.</p></article>
|
|
64
|
+
<article><h3>The Growth Marketer</h3><p>Audience, distribution and revenue growth. Finds the narrowest stage of the funnel.</p></article>
|
|
65
|
+
<article><h3>The Operator</h3><p>Systems, delegation readiness and execution. Documents before delegating.</p></article>
|
|
66
|
+
<article><h3>The Founder-Time Strategist</h3><p>Protects your hours and keeps you on the work only you can do.</p></article>
|
|
67
|
+
<article><h3>The Contrarian Investor</h3><p>Inversion, reversibility and opportunity cost. Looks for what everyone missed.</p></article>
|
|
68
|
+
<article class="chair"><h3>The Chair</h3><p>Runs the meeting, quotes everyone fairly, never votes, and will recommend against the majority when the dissent is stronger.</p></article>
|
|
69
|
+
</div>
|
|
70
|
+
</section>
|
|
71
|
+
|
|
72
|
+
<section>
|
|
73
|
+
<h2>Pricing</h2>
|
|
74
|
+
<p>Your first meeting is free, one per email address. After that a meeting is <strong>$9</strong>, paid in crypto through <a href="https://coinpayportal.com">CoinPay</a> (BTC, ETH, SOL, USDC, USDT and more). No card, no subscription. If the network cannot finish your meeting, you are not charged: the meeting is returned to your account and nothing is made up.</p>
|
|
75
|
+
</section>
|
|
76
|
+
|
|
77
|
+
<section id="surfaces">
|
|
78
|
+
<h2>API, CLI, MCP and TUI</h2>
|
|
79
|
+
<p>Everything the page does, a script or an agent can do. Sign in once to get an API key.</p>
|
|
80
|
+
<h3>CLI and TUI</h3>
|
|
81
|
+
<pre><code>npm i -g @profullstack/board-saas
|
|
82
|
+
board-saas login you@example.com
|
|
83
|
+
board-saas meet "Decision: ... Options: ... Constraints: ..."
|
|
84
|
+
board-saas tui</code></pre>
|
|
85
|
+
<h3>HTTP API</h3>
|
|
86
|
+
<pre><code>curl -X POST https://board.saas.pit.world/api/v1/meetings \
|
|
87
|
+
-H "Authorization: Bearer $BOARD_SAAS_KEY" \
|
|
88
|
+
-H "content-type: application/json" \
|
|
89
|
+
-d '{"brief":"Decision: ... Options: ... Constraints: ..."}'
|
|
90
|
+
curl https://board.saas.pit.world/api/v1/meetings/<id></code></pre>
|
|
91
|
+
<p><a href="https://board.saas.pit.world/api/v1">Full API reference</a></p>
|
|
92
|
+
<h3>MCP</h3>
|
|
93
|
+
<pre><code>claude mcp add --transport http board-saas https://board.saas.pit.world/mcp \
|
|
94
|
+
--header "Authorization: Bearer $BOARD_SAAS_KEY"
|
|
95
|
+
# or over stdio:
|
|
96
|
+
claude mcp add board-saas -- npx -y @profullstack/board-saas mcp</code></pre>
|
|
97
|
+
<p>Tools: <code>run_meeting</code> and <code>get_meeting</code>.</p>
|
|
98
|
+
</section>
|
|
99
|
+
</main>
|
|
100
|
+
<!--FOOTERS-->
|
|
101
|
+
<script src="app.js"></script>
|
|
102
|
+
</body>
|
|
103
|
+
</html>
|
package/public/style.css
ADDED
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
:root{--bg:#f7f6f3;--surface:#fff;--ink:#1d1d1b;--muted:#5f5e5a;--line:#e3e1db;--accent:#2f5bd3;--accent-ink:#fff;--warn:#fbf3e2;--warn-line:#e7c77a;--bad:#b3412e}
|
|
2
|
+
@media (prefers-color-scheme:dark){:root:not([data-theme="light"]){--bg:#141413;--surface:#1f1f1d;--ink:#ecebe6;--muted:#a3a29c;--line:#34332f;--accent:#8aa8ff;--accent-ink:#141413;--warn:#2b2516;--warn-line:#7a6430;--bad:#f08a76}}
|
|
3
|
+
:root[data-theme="dark"]{--bg:#141413;--surface:#1f1f1d;--ink:#ecebe6;--muted:#a3a29c;--line:#34332f;--accent:#8aa8ff;--accent-ink:#141413;--warn:#2b2516;--warn-line:#7a6430;--bad:#f08a76}
|
|
4
|
+
*{box-sizing:border-box}
|
|
5
|
+
body{margin:0;background:var(--bg);color:var(--ink);font:17px/1.6 system-ui,-apple-system,"Segoe UI",sans-serif}
|
|
6
|
+
main{max-width:860px;margin:0 auto;padding:40px 16px 48px}
|
|
7
|
+
a{color:var(--accent)}
|
|
8
|
+
h1{font-size:clamp(1.9rem,1.2rem + 3vw,2.8rem);line-height:1.15;margin:0 0 14px;letter-spacing:-.01em}
|
|
9
|
+
h2{font-size:1.35rem;margin:44px 0 12px}
|
|
10
|
+
h3{font-size:1.05rem;margin:18px 0 6px}
|
|
11
|
+
.eyebrow{text-transform:uppercase;letter-spacing:.08em;font-size:.8rem;font-weight:700;color:var(--accent);margin:0 0 8px}
|
|
12
|
+
.lede{font-size:1.15rem;margin:0 0 14px}
|
|
13
|
+
.honest{background:var(--warn);border:1px solid var(--warn-line);border-radius:10px;padding:10px 14px;font-size:.95rem;margin:0}
|
|
14
|
+
.card{background:var(--surface);border:1px solid var(--line);border-radius:14px;padding:20px;margin-top:28px}
|
|
15
|
+
.card h2{margin-top:0}
|
|
16
|
+
label{display:block;font-weight:600;margin:14px 0 6px}
|
|
17
|
+
.hint{font-weight:400;color:var(--muted);font-size:.9rem}
|
|
18
|
+
textarea,input{width:100%;font:inherit;color:var(--ink);background:var(--bg);border:1px solid var(--line);border-radius:10px;padding:10px 12px}
|
|
19
|
+
textarea{resize:vertical;min-height:170px}
|
|
20
|
+
textarea:focus,input:focus,button:focus-visible{outline:2px solid var(--accent);outline-offset:2px}
|
|
21
|
+
.row{display:flex;justify-content:space-between;align-items:center;gap:8px;margin-top:6px}
|
|
22
|
+
.count{color:var(--muted);font-size:.85rem}
|
|
23
|
+
button{font:inherit;cursor:pointer}
|
|
24
|
+
.link{background:none;border:0;color:var(--accent);padding:0;text-decoration:underline}
|
|
25
|
+
.primary{margin-top:18px;background:var(--accent);color:var(--accent-ink);border:0;border-radius:10px;padding:12px 20px;font-weight:700}
|
|
26
|
+
.primary[disabled]{opacity:.6;cursor:wait}
|
|
27
|
+
.status{min-height:1.5em;margin:12px 0 0}
|
|
28
|
+
.status.bad{color:var(--bad)}
|
|
29
|
+
#signed-in{margin:14px 0 0;color:var(--muted)}
|
|
30
|
+
.steps li{margin-bottom:10px}
|
|
31
|
+
.board{display:grid;grid-template-columns:repeat(auto-fill,minmax(min(100%,240px),1fr));gap:12px}
|
|
32
|
+
.board article{background:var(--surface);border:1px solid var(--line);border-radius:12px;padding:12px 16px}
|
|
33
|
+
.board article h3{margin:4px 0}
|
|
34
|
+
.board article p{margin:4px 0;color:var(--muted);font-size:.95rem}
|
|
35
|
+
.board .chair{border-color:var(--accent)}
|
|
36
|
+
pre{background:var(--surface);border:1px solid var(--line);border-radius:10px;padding:12px 14px;overflow-x:auto;font-size:.85rem;line-height:1.5}
|
|
37
|
+
code{font-family:ui-monospace,SFMono-Regular,Menlo,monospace}
|
|
38
|
+
.site-footer{max-width:860px;margin:0 auto;padding:16px;border-top:1px solid var(--line);color:var(--muted);font-size:.9rem}
|
|
39
|
+
.topbar{display:flex;flex-wrap:wrap;gap:8px 16px;align-items:center;justify-content:space-between;max-width:920px;margin:0 auto;padding:12px 16px;border-bottom:1px solid var(--line);font-size:.95rem}
|
|
40
|
+
.topbar a{font-weight:600}
|
|
41
|
+
.progress{list-style:none;padding:0}
|
|
42
|
+
.progress li{padding:6px 0;color:var(--muted)}
|
|
43
|
+
.progress li.now{color:var(--ink);font-weight:600}
|
|
44
|
+
.progress li.done{color:var(--ink)}
|
|
45
|
+
.progress li.done::before{content:"\2713 "}
|
|
46
|
+
.progress li.now::before{content:"\2192 "}
|
package/src/cli.js
ADDED
|
@@ -0,0 +1,203 @@
|
|
|
1
|
+
// board-saas: the CLI. A thin client over the HTTP API.
|
|
2
|
+
import { readFileSync, writeFileSync } from 'node:fs';
|
|
3
|
+
import { createInterface } from 'node:readline/promises';
|
|
4
|
+
import { BoardClient, loadConfig, saveConfig } from './client.js';
|
|
5
|
+
import { summarize } from './mcp.js';
|
|
6
|
+
|
|
7
|
+
const HELP = `board-saas: Board as a Service from the terminal (https://board.saas.pit.world)
|
|
8
|
+
Five AI advisors and a chair on any decision. The advisors are AI models, not real directors.
|
|
9
|
+
|
|
10
|
+
board-saas login [email] [--code 123456] email a sign-in code, save the API key
|
|
11
|
+
board-saas whoami your account: free meeting, credits
|
|
12
|
+
board-saas meet "<brief>" run a meeting and print the minutes
|
|
13
|
+
--file brief.txt read the brief from a file (or pipe it on stdin)
|
|
14
|
+
--out report.html save the interactive report
|
|
15
|
+
--no-wait start it and print the id
|
|
16
|
+
--json print the meeting JSON
|
|
17
|
+
board-saas get <id> [--json] a meeting's status or minutes
|
|
18
|
+
board-saas list your meetings
|
|
19
|
+
board-saas clarify <id> "<answers>" answer the chair's one round of questions
|
|
20
|
+
board-saas report <id> [--out file.html] download the report
|
|
21
|
+
board-saas tui the terminal dashboard
|
|
22
|
+
board-saas mcp MCP server over stdio (run_meeting, get_meeting)
|
|
23
|
+
board-saas serve run the server (operators)
|
|
24
|
+
|
|
25
|
+
Env: BOARD_SAAS_KEY (API key), BOARD_SAAS_URL (default https://board.saas.pit.world)`;
|
|
26
|
+
|
|
27
|
+
function parse(argv) {
|
|
28
|
+
const args = [];
|
|
29
|
+
const flags = {};
|
|
30
|
+
for (let i = 0; i < argv.length; i++) {
|
|
31
|
+
const a = argv[i];
|
|
32
|
+
if (a.startsWith('--')) {
|
|
33
|
+
const [k, v] = a.slice(2).split('=');
|
|
34
|
+
if (v !== undefined) flags[k] = v;
|
|
35
|
+
else if (argv[i + 1] && !argv[i + 1].startsWith('--') && ['code', 'file', 'out', 'url', 'key'].includes(k)) flags[k] = argv[++i];
|
|
36
|
+
else flags[k] = true;
|
|
37
|
+
} else if (a === '-o') flags.out = argv[++i];
|
|
38
|
+
else args.push(a);
|
|
39
|
+
}
|
|
40
|
+
return { args, flags };
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
async function readStdin() {
|
|
44
|
+
if (process.stdin.isTTY) return '';
|
|
45
|
+
const chunks = [];
|
|
46
|
+
for await (const c of process.stdin) chunks.push(c);
|
|
47
|
+
return Buffer.concat(chunks).toString('utf8');
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
async function ask(q) {
|
|
51
|
+
const rl = createInterface({ input: process.stdin, output: process.stderr });
|
|
52
|
+
try {
|
|
53
|
+
return (await rl.question(q)).trim();
|
|
54
|
+
} finally {
|
|
55
|
+
rl.close();
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
const err = (m) => process.stderr.write(`${m}\n`);
|
|
60
|
+
|
|
61
|
+
export async function main(argv = process.argv.slice(2)) {
|
|
62
|
+
const { args, flags } = parse(argv);
|
|
63
|
+
const cmd = args.shift() ?? (flags.version || flags.v ? 'version' : flags.help || flags.h ? 'help' : undefined);
|
|
64
|
+
const cfg = loadConfig();
|
|
65
|
+
if (flags.url) cfg.url = String(flags.url).replace(/\/+$/, '');
|
|
66
|
+
if (flags.key) cfg.key = String(flags.key);
|
|
67
|
+
const client = new BoardClient(cfg);
|
|
68
|
+
|
|
69
|
+
switch (cmd) {
|
|
70
|
+
case undefined:
|
|
71
|
+
case 'help':
|
|
72
|
+
case '--help':
|
|
73
|
+
case '-h':
|
|
74
|
+
console.log(HELP);
|
|
75
|
+
return 0;
|
|
76
|
+
|
|
77
|
+
case 'version':
|
|
78
|
+
case '--version': {
|
|
79
|
+
const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
|
|
80
|
+
console.log(pkg.version);
|
|
81
|
+
return 0;
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
case 'login': {
|
|
85
|
+
const email = args[0] || cfg.email || (await ask('Email: '));
|
|
86
|
+
let code = flags.code;
|
|
87
|
+
if (!code) {
|
|
88
|
+
const r = await client.sendCode(email);
|
|
89
|
+
err(r.message);
|
|
90
|
+
code = await ask('6-digit code: ');
|
|
91
|
+
}
|
|
92
|
+
const v = await client.verify(email, String(code));
|
|
93
|
+
const p = saveConfig({ url: cfg.url, key: v.api_key, email });
|
|
94
|
+
console.log(`signed in as ${v.account.email}; key saved to ${p}`);
|
|
95
|
+
console.log(v.account.free_meeting_available ? 'your free meeting is ready' : `${v.account.credits} paid meeting(s) left; next is $${v.account.price_usd}`);
|
|
96
|
+
return 0;
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
case 'whoami':
|
|
100
|
+
console.log(JSON.stringify(await client.account(), null, 2));
|
|
101
|
+
return 0;
|
|
102
|
+
|
|
103
|
+
case 'meet': {
|
|
104
|
+
let brief = args.join(' ').trim();
|
|
105
|
+
if (flags.file) brief = readFileSync(String(flags.file), 'utf8');
|
|
106
|
+
if (!brief) brief = (await readStdin()).trim();
|
|
107
|
+
if (!brief) {
|
|
108
|
+
err('give a brief: board-saas meet "Decision: ... Options: ... Constraints: ..."');
|
|
109
|
+
return 2;
|
|
110
|
+
}
|
|
111
|
+
if (!client.key) {
|
|
112
|
+
err('not signed in: run board-saas login <email> first (or set BOARD_SAAS_KEY)');
|
|
113
|
+
return 2;
|
|
114
|
+
}
|
|
115
|
+
let v = await client.runMeeting(brief);
|
|
116
|
+
if (v.status === 'awaiting_payment') {
|
|
117
|
+
console.log(`Your free meeting is used. Pay $${v.price_usd} in crypto to start this one:\n${v.checkout_url}\nThen: board-saas get ${v.id}`);
|
|
118
|
+
return 0;
|
|
119
|
+
}
|
|
120
|
+
err(`meeting ${v.id} started: ${v.url}`);
|
|
121
|
+
if (flags['no-wait']) {
|
|
122
|
+
console.log(v.id);
|
|
123
|
+
return 0;
|
|
124
|
+
}
|
|
125
|
+
let last = '';
|
|
126
|
+
v = await client.waitFor(v.id, {
|
|
127
|
+
onUpdate: (u) => {
|
|
128
|
+
const s = `${u.status}${u.progress?.stage && u.progress.stage !== u.status ? ` ${u.progress.stage}` : ''}${u.progress?.of ? ` ${u.progress.done}/${u.progress.of}` : ''}`;
|
|
129
|
+
if (s !== last) err(` ${s}`);
|
|
130
|
+
last = s;
|
|
131
|
+
},
|
|
132
|
+
});
|
|
133
|
+
if (v.status === 'needs_clarification') {
|
|
134
|
+
console.log(summarize(v));
|
|
135
|
+
if (process.stdin.isTTY) {
|
|
136
|
+
const answers = await ask('Your answers (one line, Enter to skip): ');
|
|
137
|
+
await client.clarify(v.id, answers);
|
|
138
|
+
v = await client.waitFor(v.id, { onUpdate: (u) => err(` ${u.status} ${u.progress?.stage ?? ''}`) });
|
|
139
|
+
} else {
|
|
140
|
+
console.log(`answer with: board-saas clarify ${v.id} "<answers>"`);
|
|
141
|
+
return 0;
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
if (flags.out && v.status === 'done') {
|
|
145
|
+
writeFileSync(String(flags.out), await client.reportHtml(v.id));
|
|
146
|
+
err(`report saved to ${flags.out}`);
|
|
147
|
+
}
|
|
148
|
+
console.log(flags.json ? JSON.stringify(v.meeting ?? v, null, 2) : summarize(v));
|
|
149
|
+
return v.status === 'done' ? 0 : 1;
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
case 'get': {
|
|
153
|
+
if (!args[0]) return err('usage: board-saas get <id>'), 2;
|
|
154
|
+
const v = await client.getMeeting(args[0]);
|
|
155
|
+
console.log(flags.json ? JSON.stringify(v, null, 2) : summarize(v));
|
|
156
|
+
return 0;
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
case 'list': {
|
|
160
|
+
const list = await client.listMeetings();
|
|
161
|
+
if (!list.length) console.log('no meetings yet');
|
|
162
|
+
for (const m of list) console.log(`${m.id} ${m.status.padEnd(20)} ${m.created_at.slice(0, 16)} ${m.brief.replace(/\s+/g, ' ').slice(0, 70)}`);
|
|
163
|
+
return 0;
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
case 'clarify': {
|
|
167
|
+
if (!args[0]) return err('usage: board-saas clarify <id> "<answers>"'), 2;
|
|
168
|
+
console.log(summarize(await client.clarify(args[0], args.slice(1).join(' '))));
|
|
169
|
+
return 0;
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
case 'report': {
|
|
173
|
+
if (!args[0]) return err('usage: board-saas report <id> [--out file.html]'), 2;
|
|
174
|
+
const html = await client.reportHtml(args[0]);
|
|
175
|
+
const out = flags.out ? String(flags.out) : `board-${args[0]}.html`;
|
|
176
|
+
writeFileSync(out, html);
|
|
177
|
+
console.log(out);
|
|
178
|
+
return 0;
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
case 'tui': {
|
|
182
|
+
const { runTui } = await import('./tui.js');
|
|
183
|
+
await runTui(client);
|
|
184
|
+
return 0;
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
case 'mcp': {
|
|
188
|
+
const { serveStdio } = await import('./mcp-stdio.js');
|
|
189
|
+
await serveStdio(client);
|
|
190
|
+
return 0;
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
case 'serve': {
|
|
194
|
+
const { startServer } = await import('./server.js');
|
|
195
|
+
startServer(process.env);
|
|
196
|
+
return new Promise(() => {});
|
|
197
|
+
}
|
|
198
|
+
|
|
199
|
+
default:
|
|
200
|
+
err(`unknown command: ${cmd}\n\n${HELP}`);
|
|
201
|
+
return 2;
|
|
202
|
+
}
|
|
203
|
+
}
|