proofdeck 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 +201 -0
- package/NOTICE +23 -0
- package/README.md +152 -2
- package/README.zh-CN.md +152 -0
- package/bin/proofdeck.js +191 -0
- package/board/LICENSE +201 -0
- package/board/README.md +473 -0
- package/board/README.zh-CN.md +424 -0
- package/board/dist/_chk.db-shm +0 -0
- package/board/dist/_chk.db-wal +0 -0
- package/board/dist/adapters.d.ts +40 -0
- package/board/dist/adapters.d.ts.map +1 -0
- package/board/dist/adapters.js +124 -0
- package/board/dist/adapters.js.map +1 -0
- package/board/dist/board.d.ts +628 -0
- package/board/dist/board.d.ts.map +1 -0
- package/board/dist/board.js +2767 -0
- package/board/dist/board.js.map +1 -0
- package/board/dist/cli.d.ts +3 -0
- package/board/dist/cli.d.ts.map +1 -0
- package/board/dist/cli.js +1663 -0
- package/board/dist/cli.js.map +1 -0
- package/board/dist/config.d.ts +57 -0
- package/board/dist/config.d.ts.map +1 -0
- package/board/dist/config.js +99 -0
- package/board/dist/config.js.map +1 -0
- package/board/dist/db.d.ts +9 -0
- package/board/dist/db.d.ts.map +1 -0
- package/board/dist/db.js +506 -0
- package/board/dist/db.js.map +1 -0
- package/board/dist/git.d.ts +35 -0
- package/board/dist/git.d.ts.map +1 -0
- package/board/dist/git.js +147 -0
- package/board/dist/git.js.map +1 -0
- package/board/dist/index.d.ts +18 -0
- package/board/dist/index.d.ts.map +1 -0
- package/board/dist/index.js +13 -0
- package/board/dist/index.js.map +1 -0
- package/board/dist/mcp-config.d.ts +26 -0
- package/board/dist/mcp-config.d.ts.map +1 -0
- package/board/dist/mcp-config.js +88 -0
- package/board/dist/mcp-config.js.map +1 -0
- package/board/dist/mcp.d.ts +3 -0
- package/board/dist/mcp.d.ts.map +1 -0
- package/board/dist/mcp.js +949 -0
- package/board/dist/mcp.js.map +1 -0
- package/board/dist/quickstart.d.ts +75 -0
- package/board/dist/quickstart.d.ts.map +1 -0
- package/board/dist/quickstart.js +156 -0
- package/board/dist/quickstart.js.map +1 -0
- package/board/dist/serve.d.ts +10 -0
- package/board/dist/serve.d.ts.map +1 -0
- package/board/dist/serve.js +445 -0
- package/board/dist/serve.js.map +1 -0
- package/board/dist/signing.d.ts +18 -0
- package/board/dist/signing.d.ts.map +1 -0
- package/board/dist/signing.js +26 -0
- package/board/dist/signing.js.map +1 -0
- package/board/dist/sync.d.ts +49 -0
- package/board/dist/sync.d.ts.map +1 -0
- package/board/dist/sync.js +158 -0
- package/board/dist/sync.js.map +1 -0
- package/board/dist/types.d.ts +359 -0
- package/board/dist/types.d.ts.map +1 -0
- package/board/dist/types.js +20 -0
- package/board/dist/types.js.map +1 -0
- package/board/docs/adr/0001-shared-worktree-collision.md +102 -0
- package/board/docs/adr/0001-shared-worktree-collision.zh-CN.md +90 -0
- package/board/docs/attribution.md +123 -0
- package/board/docs/attribution.zh-CN.md +104 -0
- package/board/docs/development-workflow.md +81 -0
- package/board/docs/development-workflow.zh-CN.md +75 -0
- package/board/docs/diagrams/banner.png +0 -0
- package/board/docs/diagrams/banner.svg +1 -0
- package/board/docs/diagrams/before-after.png +0 -0
- package/board/docs/diagrams/before-after.svg +1 -0
- package/board/docs/diagrams/governance-chain.png +0 -0
- package/board/docs/diagrams/governance-chain.svg +1 -0
- package/board/docs/diagrams/value-flow.png +0 -0
- package/board/docs/diagrams/value-flow.svg +1 -0
- package/board/docs/entry-point.md +81 -0
- package/board/docs/entry-point.zh-CN.md +65 -0
- package/board/docs/kanban.png +0 -0
- package/board/docs/octoryn-mark.png +0 -0
- package/board/docs/registry-metadata.md +34 -0
- package/board/docs/registry-metadata.zh-CN.md +30 -0
- package/board/package.json +87 -0
- package/config.example.json +72 -0
- package/daemon.js +1148 -0
- package/docs/assets/demo.gif +0 -0
- package/docs/assets/logo-512.png +0 -0
- package/docs/assets/logo.svg +31 -0
- package/docs/assets/social-preview.png +0 -0
- package/docs/demo-run.mjs +61 -0
- package/docs/render-demo.py +94 -0
- package/docs/render-logo.py +101 -0
- package/docs/task-book.md +58 -0
- package/e2e/verify-acceptance.mjs +150 -0
- package/e2e/verify-antifraud.mjs +128 -0
- package/e2e/verify-caps.mjs +46 -0
- package/e2e/verify-checkpoint.mjs +208 -0
- package/e2e/verify-firstclass.mjs +110 -0
- package/e2e/verify-judge.mjs +52 -0
- package/e2e/verify-lease.mjs +95 -0
- package/e2e/verify-replay.mjs +92 -0
- package/e2e/verify-resilience.mjs +323 -0
- package/e2e/verify-review.mjs +86 -0
- package/e2e/verify-scheduling.mjs +110 -0
- package/e2e/verify-schema-evolution.mjs +107 -0
- package/e2e/verify-sla-digest.mjs +105 -0
- package/guard.js +97 -0
- package/lib/adapters/codex.js +206 -0
- package/lib/billing-convert.js +57 -0
- package/lib/board.js +46 -0
- package/lib/caps.js +35 -0
- package/lib/checkpoint.js +130 -0
- package/lib/gating.js +218 -0
- package/lib/guard-core.mjs +108 -0
- package/lib/http.js +161 -0
- package/lib/judge.js +89 -0
- package/lib/lease.js +93 -0
- package/lib/notify.js +56 -0
- package/lib/platform.js +120 -0
- package/lib/replay.js +68 -0
- package/lib/review.js +40 -0
- package/lib/runner.js +152 -0
- package/lib/schedule.js +59 -0
- package/lib/sla.js +42 -0
- package/lib/spans.js +36 -0
- package/lib/starve.js +43 -0
- package/lib/store.js +109 -0
- package/lib/supply.js +101 -0
- package/lib/usage.js +103 -0
- package/lib/verify.js +223 -0
- package/lib/watchdog-core.mjs +68 -0
- package/lib/watchdog-worker.mjs +75 -0
- package/package.json +55 -4
- package/scripts/run-daemon.sh +18 -0
- package/scripts/run-e2e.mjs +39 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 560" width="1200" height="560" role="img"><title>Before and after</title><desc>Comparison: without a shared board agents slam into one repo and conflict, blind and unattributed; with Octopus Blackboard the shared layer sits between them and produces a conflict-aware kanban, attribution, a review gate, and a tamper-evident audit.</desc><defs><marker id="ah" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" fill="#8a93a6"/></marker><marker id="ar" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" fill="#f06a6a"/></marker><marker id="ab" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" fill="#6ea8fe"/></marker><marker id="ag" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" fill="#4ec98a"/></marker><linearGradient id="brand" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#3b82f6"/><stop offset="0.55" stop-color="#8b5cf6"/><stop offset="1" stop-color="#d946ef"/></linearGradient></defs><rect width="1200" height="560" fill="#0f1115"/><rect x="40" y="44" width="520" height="452" rx="16" fill="#18141a" stroke="#2a2f3a"/><rect x="640" y="44" width="520" height="452" rx="16" fill="#141a16" stroke="#2a2f3a"/><text x="68" y="88" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="23" fill="#f06a6a" font-weight="700">Without a shared board</text><text x="668" y="88" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="23" fill="#4ec98a" font-weight="700">With Octopus Blackboard</text><rect x="68" y="116" width="112" height="38" rx="9" fill="#171a21" stroke="#2a2f3a"/><text x="124" y="140" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#c3cad6" text-anchor="middle" font-weight="500">Claude Code</text><rect x="668" y="116" width="112" height="38" rx="9" fill="#171a21" stroke="#6ea8fe"/><text x="724" y="140" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#c3cad6" text-anchor="middle" font-weight="500">Claude Code</text><rect x="192" y="116" width="112" height="38" rx="9" fill="#171a21" stroke="#2a2f3a"/><text x="248" y="140" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#c3cad6" text-anchor="middle" font-weight="500">Codex</text><rect x="792" y="116" width="112" height="38" rx="9" fill="#171a21" stroke="#6ea8fe"/><text x="848" y="140" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#c3cad6" text-anchor="middle" font-weight="500">Codex</text><rect x="316" y="116" width="112" height="38" rx="9" fill="#171a21" stroke="#2a2f3a"/><text x="372" y="140" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#c3cad6" text-anchor="middle" font-weight="500">Gemini</text><rect x="916" y="116" width="112" height="38" rx="9" fill="#171a21" stroke="#6ea8fe"/><text x="972" y="140" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#c3cad6" text-anchor="middle" font-weight="500">Gemini</text><rect x="440" y="116" width="112" height="38" rx="9" fill="#171a21" stroke="#2a2f3a"/><text x="496" y="140" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#c3cad6" text-anchor="middle" font-weight="500">Cursor</text><rect x="1040" y="116" width="112" height="38" rx="9" fill="#171a21" stroke="#6ea8fe"/><text x="1096" y="140" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#c3cad6" text-anchor="middle" font-weight="500">Cursor</text><line x1="124" y1="154" x2="232" y2="248" stroke="#f06a6a" stroke-width="2" opacity="0.9" marker-end="url(#ar)"/><line x1="248" y1="154" x2="276" y2="248" stroke="#f06a6a" stroke-width="2" opacity="0.9" marker-end="url(#ar)"/><line x1="372" y1="154" x2="324" y2="248" stroke="#f06a6a" stroke-width="2" opacity="0.9" marker-end="url(#ar)"/><line x1="496" y1="154" x2="368" y2="248" stroke="#f06a6a" stroke-width="2" opacity="0.9" marker-end="url(#ar)"/><rect x="200" y="250" width="200" height="58" rx="12" fill="#171a21" stroke="#f06a6a"/><text x="300" y="278" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="16" fill="#f06a6a" text-anchor="middle" font-weight="700">conflicts</text><text x="300" y="297" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="12" fill="#8a93a6" text-anchor="middle">blind · unattributed edits</text><text x="72" y="362" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#f06a6a" font-weight="700">✗</text><text x="96" y="362" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#f0857f" >duplicate edits, silently</text><text x="72" y="394" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#f06a6a" font-weight="700">✗</text><text x="96" y="394" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#f0857f" >no shared memory or handoffs</text><text x="72" y="426" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#f06a6a" font-weight="700">✗</text><text x="96" y="426" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#f0857f" >who wrote what? unknown</text><text x="72" y="458" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#f06a6a" font-weight="700">✗</text><text x="96" y="458" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#f0857f" >no audit, no review gate</text><rect x="664" y="204" width="472" height="58" rx="12" fill="#171a21" stroke="#6ea8fe"/><text x="900" y="230" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="16" fill="#e6e9ef" text-anchor="middle" font-weight="700">Octopus Blackboard</text><text x="900" y="250" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="12" fill="#8a93a6" text-anchor="middle">shared memory · hash-chained audit</text><line x1="724" y1="154" x2="760" y2="202" stroke="#6ea8fe" stroke-width="1.8" opacity="0.85" marker-end="url(#ab)"/><line x1="848" y1="154" x2="860" y2="202" stroke="#6ea8fe" stroke-width="1.8" opacity="0.85" marker-end="url(#ab)"/><line x1="972" y1="154" x2="950" y2="202" stroke="#6ea8fe" stroke-width="1.8" opacity="0.85" marker-end="url(#ab)"/><line x1="1096" y1="154" x2="1040" y2="202" stroke="#6ea8fe" stroke-width="1.8" opacity="0.85" marker-end="url(#ab)"/><line x1="724" y1="262" x2="724" y2="300" stroke="#4ec98a" stroke-width="1.8" opacity="0.85" marker-end="url(#ag)"/><rect x="668" y="302" width="112" height="42" rx="10" fill="#171a21" stroke="#4ec98a"/><text x="724" y="328" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="14" fill="#4ec98a" text-anchor="middle" font-weight="600">kanban</text><line x1="848" y1="262" x2="848" y2="300" stroke="#4ec98a" stroke-width="1.8" opacity="0.85" marker-end="url(#ag)"/><rect x="792" y="302" width="112" height="42" rx="10" fill="#171a21" stroke="#4ec98a"/><text x="848" y="328" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="14" fill="#4ec98a" text-anchor="middle" font-weight="600">attribution</text><line x1="972" y1="262" x2="972" y2="300" stroke="#4ec98a" stroke-width="1.8" opacity="0.85" marker-end="url(#ag)"/><rect x="916" y="302" width="112" height="42" rx="10" fill="#171a21" stroke="#4ec98a"/><text x="972" y="328" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="14" fill="#4ec98a" text-anchor="middle" font-weight="600">review gate</text><line x1="1096" y1="262" x2="1096" y2="300" stroke="#4ec98a" stroke-width="1.8" opacity="0.85" marker-end="url(#ag)"/><rect x="1040" y="302" width="112" height="42" rx="10" fill="#171a21" stroke="#4ec98a"/><text x="1096" y="328" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="14" fill="#4ec98a" text-anchor="middle" font-weight="600">audit</text><text x="672" y="380" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#4ec98a" font-weight="700">✓</text><text x="696" y="380" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#4ec98a" >see who's on what, live</text><text x="672" y="410" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#4ec98a" font-weight="700">✓</text><text x="696" y="410" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#4ec98a" >every commit attributed</text><text x="672" y="440" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#4ec98a" font-weight="700">✓</text><text x="696" y="440" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#4ec98a" >block unreviewed AI in CI</text><text x="672" y="470" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#4ec98a" font-weight="700">✓</text><text x="696" y="470" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#4ec98a" >signed, tamper-evident trail</text><circle cx="600" cy="278" r="24" fill="#14161c" stroke="#2a2f3a"/><text x="600" y="284" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#8a93a6" text-anchor="middle" font-weight="600">vs</text></svg>
|
|
Binary file
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1240 240" width="1240" height="240" role="img"><title>Accountability chain</title><desc>Governance chain: agent does work, attribute the commit, export/import, CI gate blocks unreviewed AI, human approves, merge — all recorded on the tamper-evident timeline.</desc><defs><marker id="ah" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" fill="#8a93a6"/></marker><marker id="ar" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" fill="#f06a6a"/></marker><marker id="ab" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" fill="#6ea8fe"/></marker><marker id="ag" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" fill="#4ec98a"/></marker><linearGradient id="brand" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#3b82f6"/><stop offset="0.55" stop-color="#8b5cf6"/><stop offset="1" stop-color="#d946ef"/></linearGradient></defs><rect width="1240" height="240" fill="#0f1115"/><text x="48" y="54" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="22" fill="#e6e9ef" font-weight="700">The AI-native accountability chain</text><rect x="48" y="92" width="170" height="66" rx="11" fill="#171a21" stroke="#2a2f3a"/><text x="133" y="120" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#e6e9ef" text-anchor="middle" font-weight="600">Agent does work</text><text x="133" y="140" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="12" fill="#8a93a6" text-anchor="middle">edits · commits</text><line x1="220" y1="125" x2="240" y2="125" stroke="#8a93a6" stroke-width="1.5" marker-end="url(#ah)"/><rect x="242" y="92" width="170" height="66" rx="11" fill="#171a21" stroke="#2a2f3a"/><text x="327" y="120" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#e6e9ef" text-anchor="middle" font-weight="600">Attribute commit</text><text x="327" y="140" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="12" fill="#8a93a6" text-anchor="middle">which agent · session</text><line x1="414" y1="125" x2="434" y2="125" stroke="#8a93a6" stroke-width="1.5" marker-end="url(#ah)"/><rect x="436" y="92" width="170" height="66" rx="11" fill="#171a21" stroke="#2a2f3a"/><text x="521" y="120" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#e6e9ef" text-anchor="middle" font-weight="600">Export / import</text><text x="521" y="140" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="12" fill="#8a93a6" text-anchor="middle">attribution travels</text><line x1="608" y1="125" x2="628" y2="125" stroke="#8a93a6" stroke-width="1.5" marker-end="url(#ah)"/><rect x="630" y="92" width="170" height="66" rx="11" fill="#171a21" stroke="#6ea8fe"/><text x="715" y="120" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#e6e9ef" text-anchor="middle" font-weight="600">CI gate</text><text x="715" y="140" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="12" fill="#8a93a6" text-anchor="middle">block unreviewed AI</text><line x1="802" y1="125" x2="822" y2="125" stroke="#8a93a6" stroke-width="1.5" marker-end="url(#ah)"/><rect x="824" y="92" width="170" height="66" rx="11" fill="#171a21" stroke="#4ec98a"/><text x="909" y="120" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#e6e9ef" text-anchor="middle" font-weight="600">Human approves</text><text x="909" y="140" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="12" fill="#8a93a6" text-anchor="middle">sign-off</text><line x1="996" y1="125" x2="1016" y2="125" stroke="#8a93a6" stroke-width="1.5" marker-end="url(#ah)"/><rect x="1018" y="92" width="170" height="66" rx="11" fill="#171a21" stroke="#4ec98a"/><text x="1103" y="120" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#e6e9ef" text-anchor="middle" font-weight="600">Merge</text><text x="1103" y="140" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="12" fill="#8a93a6" text-anchor="middle">accountable</text><text x="48" y="208" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="14" fill="#8a93a6" >Every step is recorded on the tamper-evident, hash-chained timeline — passively. The board never launches an agent.</text></svg>
|
|
Binary file
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1000 560" width="1000" height="560" role="img"><title>Value flow</title><desc>Value flow: four coding agents connect over MCP to the Octopus Blackboard which records and exposes but never orchestrates, producing a conflict-aware kanban, AI attribution, a CI review gate, and a tamper-evident audit trail.</desc><defs><marker id="ah" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" fill="#8a93a6"/></marker><marker id="ar" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" fill="#f06a6a"/></marker><marker id="ab" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" fill="#6ea8fe"/></marker><marker id="ag" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" fill="#4ec98a"/></marker><linearGradient id="brand" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#3b82f6"/><stop offset="0.55" stop-color="#8b5cf6"/><stop offset="1" stop-color="#d946ef"/></linearGradient></defs><rect width="1000" height="560" fill="#0f1115"/><text x="48" y="50" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="22" fill="#e6e9ef" font-weight="700">One shared blackboard turns blind agents into an accountable team</text><text x="48" y="76" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#8a93a6" >Four coding agents editing one repo — otherwise blind to each other</text><rect x="48" y="96" width="208" height="48" rx="9" fill="#171a21" stroke="#2a2f3a"/><text x="152" y="125" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#c3cad6" text-anchor="middle" font-weight="500">Claude Code</text><rect x="280" y="96" width="208" height="48" rx="9" fill="#171a21" stroke="#2a2f3a"/><text x="384" y="125" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#c3cad6" text-anchor="middle" font-weight="500">Codex</text><rect x="512" y="96" width="208" height="48" rx="9" fill="#171a21" stroke="#2a2f3a"/><text x="616" y="125" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#c3cad6" text-anchor="middle" font-weight="500">Gemini CLI</text><rect x="744" y="96" width="208" height="48" rx="9" fill="#171a21" stroke="#2a2f3a"/><text x="848" y="125" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#c3cad6" text-anchor="middle" font-weight="500">Cursor</text><line x1="152" y1="146" x2="152" y2="196" stroke="#8a93a6" stroke-width="1.5" marker-end="url(#ah)"/><line x1="384" y1="146" x2="384" y2="196" stroke="#8a93a6" stroke-width="1.5" marker-end="url(#ah)"/><line x1="616" y1="146" x2="616" y2="196" stroke="#8a93a6" stroke-width="1.5" marker-end="url(#ah)"/><line x1="848" y1="146" x2="848" y2="196" stroke="#8a93a6" stroke-width="1.5" marker-end="url(#ah)"/><rect x="48" y="200" width="904" height="112" rx="14" fill="#171a21" stroke="#6ea8fe"/><text x="500" y="236" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="22" fill="#e6e9ef" text-anchor="middle" font-weight="700">Octopus Blackboard</text><text x="500" y="262" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="14" fill="#c3cad6" text-anchor="middle">local SQLite · hash-chained, append-only audit log</text><text x="500" y="283" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="14" fill="#8a93a6" text-anchor="middle">agents read / write / subscribe over MCP — records and exposes, never orchestrates</text><text x="500" y="303" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="13" fill="#8a93a6" text-anchor="middle">holds: tasks · changes · decisions · evidence · risks · handoffs · attribution</text><line x1="200" y1="314" x2="200" y2="366" stroke="#8a93a6" stroke-width="1.5" marker-end="url(#ah)"/><line x1="420" y1="314" x2="420" y2="366" stroke="#8a93a6" stroke-width="1.5" marker-end="url(#ah)"/><line x1="640" y1="314" x2="640" y2="366" stroke="#8a93a6" stroke-width="1.5" marker-end="url(#ah)"/><line x1="810" y1="314" x2="810" y2="366" stroke="#8a93a6" stroke-width="1.5" marker-end="url(#ah)"/><rect x="48" y="368" width="208" height="64" rx="11" fill="#171a21" stroke="#4ec98a"/><text x="152" y="396" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#4ec98a" text-anchor="middle" font-weight="600">Live kanban</text><text x="152" y="416" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="13" fill="#8a93a6" text-anchor="middle">conflict-aware</text><rect x="280" y="368" width="208" height="64" rx="11" fill="#171a21" stroke="#4ec98a"/><text x="384" y="396" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#4ec98a" text-anchor="middle" font-weight="600">AI attribution</text><text x="384" y="416" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="13" fill="#8a93a6" text-anchor="middle">who produced what</text><rect x="512" y="368" width="208" height="64" rx="11" fill="#171a21" stroke="#4ec98a"/><text x="616" y="396" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#4ec98a" text-anchor="middle" font-weight="600">CI review gate</text><text x="616" y="416" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="13" fill="#8a93a6" text-anchor="middle">block unreviewed AI</text><rect x="744" y="368" width="208" height="64" rx="11" fill="#171a21" stroke="#4ec98a"/><text x="848" y="396" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="15" fill="#4ec98a" text-anchor="middle" font-weight="600">Audit trail</text><text x="848" y="416" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="13" fill="#8a93a6" text-anchor="middle">signed · anchorable</text><text x="48" y="470" font-family="ui-sans-serif, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-size="14" fill="#8a93a6" >Gray = the agents · blue = the shared layer · green = what you get</text></svg>
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
# Why adopt Blackboard first
|
|
2
|
+
|
|
3
|
+
[简体中文](./entry-point.zh-CN.md)
|
|
4
|
+
|
|
5
|
+
Most infrastructure asks you to change how you work before it gives you
|
|
6
|
+
anything back. Blackboard is the opposite: it is the **cheapest, lowest-risk
|
|
7
|
+
entry point** into the Octopus stack, and it pays off the moment a second agent
|
|
8
|
+
touches your repo.
|
|
9
|
+
|
|
10
|
+
## The one-minute case
|
|
11
|
+
|
|
12
|
+
- **One command.** `npx octopus-blackboard quickstart` initializes the board,
|
|
13
|
+
detects your MCP client, and hands you a paste-ready config. No account, no
|
|
14
|
+
server to run, no schema to design.
|
|
15
|
+
- **Works today, with tools you already have.** You do not need an orchestrator,
|
|
16
|
+
a scheduler, or the rest of the stack. Claude Code and Cursor pointed at the
|
|
17
|
+
same `.octoboard/` already share memory. That is the whole product.
|
|
18
|
+
- **Local-first and offline.** The board is a single SQLite file under
|
|
19
|
+
`.octoboard/`, discovered by walking up from your working directory like
|
|
20
|
+
`.git`. Nothing leaves your machine. No network call is required to read or
|
|
21
|
+
write it.
|
|
22
|
+
- **Additive, never in the way.** Blackboard is *not* an orchestrator. It does
|
|
23
|
+
not schedule agents, trigger them, or decide anything on their behalf. It
|
|
24
|
+
records and exposes; agents decide. You can stop using it and delete one
|
|
25
|
+
directory.
|
|
26
|
+
|
|
27
|
+
## What you actually get on day one
|
|
28
|
+
|
|
29
|
+
Two agents on the same repo are normally blind to each other — one refactors
|
|
30
|
+
auth while another rewrites the same file, context scatters across CLIs, and
|
|
31
|
+
nobody can replay what happened. With the board:
|
|
32
|
+
|
|
33
|
+
- **Shared coordination memory** — who is working on what, what changed, what
|
|
34
|
+
was decided, what risks are open, what was handed off to whom.
|
|
35
|
+
- **Conflict awareness** — the board never blocks; it *surfaces*. If two agents
|
|
36
|
+
claim the same key or touch the same task's files, both writes are recorded
|
|
37
|
+
and the second agent is warned.
|
|
38
|
+
- **A tamper-evident timeline** — every write appends a hash-chained entry to an
|
|
39
|
+
append-only log. The history is auditable and replayable, and any
|
|
40
|
+
after-the-fact edit to an earlier entry breaks verification.
|
|
41
|
+
|
|
42
|
+
## The timeline is the source of truth other tools build on
|
|
43
|
+
|
|
44
|
+
Blackboard is deliberately a **capture layer**. Its philosophy (since v0.2.1) is
|
|
45
|
+
simple: *protocols transport facts; consumers derive meaning.* The board records
|
|
46
|
+
what happened as plain, verifiable facts on the timeline. It does not try to
|
|
47
|
+
interpret them for you.
|
|
48
|
+
|
|
49
|
+
That is exactly what makes it a good *first* adoption. Because the timeline is a
|
|
50
|
+
neutral, tamper-evident record — not a proprietary workflow — anything you add
|
|
51
|
+
later reads from a foundation that is already trustworthy. You are not betting on
|
|
52
|
+
a workflow engine; you are writing down facts you will want regardless of what
|
|
53
|
+
else you adopt.
|
|
54
|
+
|
|
55
|
+
## Honest about the roadmap
|
|
56
|
+
|
|
57
|
+
To be clear about what exists versus what is planned:
|
|
58
|
+
|
|
59
|
+
- **Available today:** the local SQLite board, the CLI (`octoboard` /
|
|
60
|
+
`blackboard`), the MCP server any client can connect to, the hash-chained
|
|
61
|
+
timeline, sessions, provider-independent AI/human attribution keyed to Git
|
|
62
|
+
commits, reviews, the query layer, and the read-only `serve` dashboard.
|
|
63
|
+
- **On the roadmap (not yet here):** Postgres sync at scale and change
|
|
64
|
+
subscriptions are partially in place and hardening. Deeper integration with
|
|
65
|
+
other Octopus repos — for example, a richer bridge to **octopus-evidence** so
|
|
66
|
+
that evidence captured on the board flows into a dedicated evidence and
|
|
67
|
+
verification layer — is **future work, not a current feature.** Today
|
|
68
|
+
Blackboard stays a capture layer: it records evidence as facts, and leaves the
|
|
69
|
+
derivation of meaning to consumers. Do not adopt it expecting an
|
|
70
|
+
evidence-verification pipeline that is not yet built.
|
|
71
|
+
|
|
72
|
+
Adopt Blackboard first because it is useful *by itself*, on the tools you
|
|
73
|
+
already run, with nothing else installed. Everything else in the stack is
|
|
74
|
+
optional and additive on top of a timeline you can already trust.
|
|
75
|
+
|
|
76
|
+
## Next steps
|
|
77
|
+
|
|
78
|
+
- Run `npx octopus-blackboard quickstart` and paste the config it prints.
|
|
79
|
+
- Read the [README](../README.md) for the full CLI and MCP tool surface.
|
|
80
|
+
- See [`examples/two-agents.sh`](../examples/two-agents.sh) for the flagship
|
|
81
|
+
two-agent scenario end to end.
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
# 为什么先采用 Blackboard
|
|
2
|
+
|
|
3
|
+
[English](./entry-point.md)
|
|
4
|
+
|
|
5
|
+
大多数基础设施都要求你先改变工作方式,然后才给你回报。Blackboard 恰恰相反:它是
|
|
6
|
+
进入 Octopus 技术栈**成本最低、风险最小的入口**,而且在第二个智能体接触你的代码库
|
|
7
|
+
的那一刻就开始产生价值。
|
|
8
|
+
|
|
9
|
+
## 一分钟理由
|
|
10
|
+
|
|
11
|
+
- **一条命令。** `npx octopus-blackboard quickstart` 会初始化黑板、检测你的 MCP
|
|
12
|
+
客户端,并给出可直接粘贴的配置。无需账号、无需运行服务、无需设计任何表结构。
|
|
13
|
+
- **今天就能用,靠你已有的工具。** 你不需要编排器、调度器或技术栈的其余部分。让
|
|
14
|
+
Claude Code 和 Cursor 指向同一个 `.octoboard/`,它们就已经共享记忆了。这就是
|
|
15
|
+
完整的产品。
|
|
16
|
+
- **本地优先、可离线。** 黑板就是 `.octoboard/` 下的单个 SQLite 文件,从当前工作
|
|
17
|
+
目录向上查找(类似 `.git`)。任何数据都不会离开你的机器。读写它无需任何网络请求。
|
|
18
|
+
- **纯增量,绝不碍事。** Blackboard **不是**编排器。它不调度智能体、不触发它们、
|
|
19
|
+
也不替它们做任何决定。它只记录与呈现,由智能体决策。你可以随时停用它,删掉一个
|
|
20
|
+
目录即可。
|
|
21
|
+
|
|
22
|
+
## 第一天你实际得到什么
|
|
23
|
+
|
|
24
|
+
在同一个代码库上工作的两个智能体通常对彼此一无所知——一个在重构 auth,另一个在
|
|
25
|
+
改写同一个文件;上下文散落在各个 CLI 中;没人能回放发生了什么。有了黑板:
|
|
26
|
+
|
|
27
|
+
- **共享的协调记忆**——谁在做什么、改动了什么、决定了什么、有哪些未解风险、交接给
|
|
28
|
+
了谁。
|
|
29
|
+
- **冲突感知**——黑板从不阻塞,而是**呈现**。若两个智能体认领同一个键,或触碰同一
|
|
30
|
+
任务的文件,两次写入都会被记录,并向第二个智能体发出警告。
|
|
31
|
+
- **防篡改时间线**——每次写入都会向仅追加日志追加一条哈希链条目。历史可审计、可
|
|
32
|
+
回放,任何事后对早先条目的修改都会破坏校验。
|
|
33
|
+
|
|
34
|
+
## 时间线是其他工具赖以构建的事实来源
|
|
35
|
+
|
|
36
|
+
Blackboard 刻意定位为**捕获层**。它自 v0.2.1 起的哲学很简单:*协议传输事实,消费者
|
|
37
|
+
派生含义。* 黑板把发生的事情作为朴素、可校验的事实记录在时间线上,而不试图替你解读。
|
|
38
|
+
|
|
39
|
+
这正是它适合作为**第一个**采用对象的原因。因为时间线是一份中立、防篡改的记录——
|
|
40
|
+
而非某种专有工作流——你之后添加的任何东西,都是从一个已然可信的基础上读取。你并
|
|
41
|
+
非押注于某个工作流引擎,而只是写下无论今后采用什么都会需要的事实。
|
|
42
|
+
|
|
43
|
+
## 对路线图保持诚实
|
|
44
|
+
|
|
45
|
+
明确区分已有功能与规划中的功能:
|
|
46
|
+
|
|
47
|
+
- **今天已有:** 本地 SQLite 黑板、CLI(`octoboard` / `blackboard`)、任何客户端都
|
|
48
|
+
能连接的 MCP 服务器、哈希链时间线、会话、与 Git 提交挂钩的与厂商无关的 AI/人类
|
|
49
|
+
归因、评审、查询层,以及只读的 `serve` 仪表盘。
|
|
50
|
+
- **路线图上(尚未到来):** 规模化的 Postgres 同步与变更订阅已部分就位并在加固中。
|
|
51
|
+
与其他 Octopus 仓库的更深集成——例如与 **octopus-evidence** 更丰富的桥接,让黑板
|
|
52
|
+
上捕获的证据流入专门的证据与验证层——是**未来的工作,而非当前功能。** 今天
|
|
53
|
+
Blackboard 仍然是捕获层:它把证据作为事实记录,把含义的派生交给消费者。请不要抱着
|
|
54
|
+
一个尚未构建的证据验证流水线的预期去采用它。
|
|
55
|
+
|
|
56
|
+
先采用 Blackboard,是因为它**本身**就有用——在你已经运行的工具上,无需安装任何
|
|
57
|
+
其他东西。技术栈中的其余一切都是可选的,都是在一个你已经可以信任的时间线之上做
|
|
58
|
+
增量。
|
|
59
|
+
|
|
60
|
+
## 下一步
|
|
61
|
+
|
|
62
|
+
- 运行 `npx octopus-blackboard quickstart`,粘贴它打印的配置。
|
|
63
|
+
- 阅读 [README](../README.zh-CN.md) 了解完整的 CLI 与 MCP 工具面。
|
|
64
|
+
- 查看 [`examples/two-agents.sh`](../examples/two-agents.sh) 了解完整的双智能体旗舰
|
|
65
|
+
场景。
|
|
Binary file
|
|
Binary file
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# MCP registry metadata (local only — not submitted)
|
|
2
|
+
|
|
3
|
+
[简体中文](./registry-metadata.zh-CN.md)
|
|
4
|
+
|
|
5
|
+
This repo ships a [`server.json`](../server.json) at the root describing the
|
|
6
|
+
blackboard MCP server in the shape the official MCP registry expects. It exists
|
|
7
|
+
so the metadata is version-controlled, reviewable, and ready — **it is not a
|
|
8
|
+
submission.**
|
|
9
|
+
|
|
10
|
+
## Not submitted anywhere
|
|
11
|
+
|
|
12
|
+
No part of this repo posts to the external MCP registry or any third-party
|
|
13
|
+
service. Publishing `server.json` to a registry is a **separate, founder-gated
|
|
14
|
+
step** performed deliberately outside this codebase (e.g. via the registry's
|
|
15
|
+
own publisher CLI, with the appropriate namespace ownership proof). Nothing here
|
|
16
|
+
does it for you, and nothing here makes a network call to do it.
|
|
17
|
+
|
|
18
|
+
## Runtime note
|
|
19
|
+
|
|
20
|
+
The npm package is `octopus-blackboard`. Its published bin that starts the MCP
|
|
21
|
+
server over stdio is `octopus-blackboard-mcp` — that is the exact command the
|
|
22
|
+
`mcp-config` / `quickstart` snippets use:
|
|
23
|
+
|
|
24
|
+
```json
|
|
25
|
+
{ "command": "npx", "args": ["-y", "octopus-blackboard-mcp"] }
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
When this metadata is eventually submitted, confirm the registry entry resolves
|
|
29
|
+
to that same stdio entry point.
|
|
30
|
+
|
|
31
|
+
## Keeping it in sync
|
|
32
|
+
|
|
33
|
+
`version` in `server.json` mirrors `package.json`. Bump both together at release
|
|
34
|
+
time. (This onboarding cycle does **not** bump the version.)
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# MCP 注册表元数据(仅本地——未提交)
|
|
2
|
+
|
|
3
|
+
[English](./registry-metadata.md)
|
|
4
|
+
|
|
5
|
+
本仓库在根目录附带了一份 [`server.json`](../server.json),以官方 MCP 注册表期望的
|
|
6
|
+
结构描述了黑板 MCP 服务器。它的存在是为了让这份元数据纳入版本控制、可供评审、随时
|
|
7
|
+
就绪——**它并不是一次提交。**
|
|
8
|
+
|
|
9
|
+
## 未向任何地方提交
|
|
10
|
+
|
|
11
|
+
本仓库的任何部分都不会向外部 MCP 注册表或任何第三方服务发送内容。将 `server.json`
|
|
12
|
+
发布到注册表是一个**独立的、需创始人把关的步骤**,会在本代码库之外有意执行(例如
|
|
13
|
+
通过注册表自身的发布 CLI,并附带相应的命名空间所有权证明)。这里没有任何代码替你
|
|
14
|
+
执行它,也没有任何代码为此发起网络请求。
|
|
15
|
+
|
|
16
|
+
## 运行时说明
|
|
17
|
+
|
|
18
|
+
npm 包名为 `octopus-blackboard`。其发布的、通过 stdio 启动 MCP 服务器的 bin 是
|
|
19
|
+
`octopus-blackboard-mcp`——这正是 `mcp-config` / `quickstart` 片段所使用的命令:
|
|
20
|
+
|
|
21
|
+
```json
|
|
22
|
+
{ "command": "npx", "args": ["-y", "octopus-blackboard-mcp"] }
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
将来提交这份元数据时,请确认注册表条目解析到同一个 stdio 入口。
|
|
26
|
+
|
|
27
|
+
## 保持同步
|
|
28
|
+
|
|
29
|
+
`server.json` 中的 `version` 与 `package.json` 保持一致。发布时一并升级两者。(本次
|
|
30
|
+
上手周期**不**升级版本。)
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "octopus-blackboard",
|
|
3
|
+
"version": "0.3.1",
|
|
4
|
+
"mcpName": "io.github.octoryn/octopus-blackboard",
|
|
5
|
+
"description": "A shared memory and coordination layer for AI coding agents. Not an orchestrator — a blackboard.",
|
|
6
|
+
"license": "Apache-2.0",
|
|
7
|
+
"author": "Ran Tao <ran@octopusos.ai>",
|
|
8
|
+
"type": "module",
|
|
9
|
+
"keywords": [
|
|
10
|
+
"ai-agents",
|
|
11
|
+
"mcp",
|
|
12
|
+
"coordination",
|
|
13
|
+
"shared-memory",
|
|
14
|
+
"blackboard",
|
|
15
|
+
"audit-log",
|
|
16
|
+
"handoff",
|
|
17
|
+
"agent-os",
|
|
18
|
+
"local-first",
|
|
19
|
+
"sqlite"
|
|
20
|
+
],
|
|
21
|
+
"repository": {
|
|
22
|
+
"type": "git",
|
|
23
|
+
"url": "git+https://github.com/octoryn/octopus-blackboard.git"
|
|
24
|
+
},
|
|
25
|
+
"homepage": "https://github.com/octoryn/octopus-blackboard#readme",
|
|
26
|
+
"bugs": {
|
|
27
|
+
"url": "https://github.com/octoryn/octopus-blackboard/issues"
|
|
28
|
+
},
|
|
29
|
+
"main": "./dist/index.js",
|
|
30
|
+
"types": "./dist/index.d.ts",
|
|
31
|
+
"exports": {
|
|
32
|
+
".": {
|
|
33
|
+
"types": "./dist/index.d.ts",
|
|
34
|
+
"import": "./dist/index.js"
|
|
35
|
+
},
|
|
36
|
+
"./package.json": "./package.json"
|
|
37
|
+
},
|
|
38
|
+
"bin": {
|
|
39
|
+
"octoboard": "./dist/cli.js",
|
|
40
|
+
"blackboard": "./dist/cli.js",
|
|
41
|
+
"octopus-blackboard": "./dist/mcp.js",
|
|
42
|
+
"octopus-blackboard-mcp": "./dist/mcp.js"
|
|
43
|
+
},
|
|
44
|
+
"files": [
|
|
45
|
+
"dist",
|
|
46
|
+
"docs",
|
|
47
|
+
"README.md",
|
|
48
|
+
"LICENSE"
|
|
49
|
+
],
|
|
50
|
+
"scripts": {
|
|
51
|
+
"build": "tsc -p tsconfig.json",
|
|
52
|
+
"cli": "tsx src/cli.ts",
|
|
53
|
+
"mcp": "tsx src/mcp.ts",
|
|
54
|
+
"typecheck": "tsc -p tsconfig.json --noEmit",
|
|
55
|
+
"test": "vitest run",
|
|
56
|
+
"coverage": "vitest run --coverage",
|
|
57
|
+
"format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
|
|
58
|
+
"format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\"",
|
|
59
|
+
"lint": "eslint .",
|
|
60
|
+
"lint:fix": "eslint . --fix",
|
|
61
|
+
"prepublishOnly": "npm run build"
|
|
62
|
+
},
|
|
63
|
+
"dependencies": {
|
|
64
|
+
"@modelcontextprotocol/sdk": "^1.29.0",
|
|
65
|
+
"better-sqlite3": "^12.11.1",
|
|
66
|
+
"commander": "^15.0.0",
|
|
67
|
+
"zod": "^4.4.3"
|
|
68
|
+
},
|
|
69
|
+
"optionalDependencies": {
|
|
70
|
+
"pg": "^8.13.0"
|
|
71
|
+
},
|
|
72
|
+
"devDependencies": {
|
|
73
|
+
"@eslint/js": "^10.0.1",
|
|
74
|
+
"@types/better-sqlite3": "^7.6.13",
|
|
75
|
+
"@types/node": "^26.0.1",
|
|
76
|
+
"@vitest/coverage-v8": "^4.1.9",
|
|
77
|
+
"eslint": "^10.6.0",
|
|
78
|
+
"prettier": "^3.9.4",
|
|
79
|
+
"tsx": "^4.22.4",
|
|
80
|
+
"typescript": "^6.0.3",
|
|
81
|
+
"typescript-eslint": "^8.62.1",
|
|
82
|
+
"vitest": "^4.1.9"
|
|
83
|
+
},
|
|
84
|
+
"engines": {
|
|
85
|
+
"node": ">=22"
|
|
86
|
+
}
|
|
87
|
+
}
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$comment": "ProofDeck example configuration. Copy to daemon.config.json and edit. Paths shown are placeholders — every face points at a real coding-agent CLI on your machine.",
|
|
3
|
+
"board": {
|
|
4
|
+
"dir": "./.proofdeck",
|
|
5
|
+
"package": "./board",
|
|
6
|
+
"identity": "bridge",
|
|
7
|
+
"route": {
|
|
8
|
+
"bridge": "codex"
|
|
9
|
+
}
|
|
10
|
+
},
|
|
11
|
+
"http": {
|
|
12
|
+
"port": 8790,
|
|
13
|
+
"token": null
|
|
14
|
+
},
|
|
15
|
+
"runtime": {
|
|
16
|
+
"dryRun": false,
|
|
17
|
+
"autoAssign": true,
|
|
18
|
+
"reconcileMs": 60000,
|
|
19
|
+
"debounceMs": 50,
|
|
20
|
+
"maxConcurrentTotal": 2,
|
|
21
|
+
"heartbeatMs": 60000,
|
|
22
|
+
"supply": { "baseMs": 300000, "maxMs": 7200000, "logEveryMs": 600000 },
|
|
23
|
+
"notify": { "ownerSupply": false },
|
|
24
|
+
"stall": { "ms": 900000, "startupMs": 1200000 },
|
|
25
|
+
"lease": { "enabled": true, "ttlHours": 24, "sweepMs": 600000, "sessionMs": 600000 },
|
|
26
|
+
"watchdog": {
|
|
27
|
+
"enabled": true,
|
|
28
|
+
"heartbeatMs": 5000,
|
|
29
|
+
"staleMs": 300000,
|
|
30
|
+
"graceMs": 600000,
|
|
31
|
+
"checkMs": 10000,
|
|
32
|
+
"probeBudgetMs": 120000,
|
|
33
|
+
"probeAttemptMs": 8000
|
|
34
|
+
},
|
|
35
|
+
"priority": { "agingMs": 7200000 },
|
|
36
|
+
"retry": { "max": 2, "baseMs": 1800000, "maxMs": 14400000, "sweepMs": 60000 },
|
|
37
|
+
"verify": { "enabled": true },
|
|
38
|
+
"judge": { "enabled": true, "agent": "codex", "mode": "acceptance-only" },
|
|
39
|
+
"sla": { "enabled": true, "sweepMs": 300000 },
|
|
40
|
+
"digest": { "enabled": true, "everyMs": 21600000, "tickMs": 600000 }
|
|
41
|
+
},
|
|
42
|
+
"gating": {
|
|
43
|
+
"autoRisk": ["low"],
|
|
44
|
+
"blockImpact": ["high", "critical"],
|
|
45
|
+
"forbiddenTokens": [
|
|
46
|
+
"delete", "drop table", "rm -rf", "force push", "--force",
|
|
47
|
+
"danger-full-access", "bypass", "install", "publish", "deploy",
|
|
48
|
+
"credential", "secret", "api_key", "password", "token"
|
|
49
|
+
],
|
|
50
|
+
"ttlHours": 24,
|
|
51
|
+
"redactPatterns": [
|
|
52
|
+
"sk-[A-Za-z0-9_-]{12,}",
|
|
53
|
+
"Bearer\\s+[A-Za-z0-9._-]{16,}",
|
|
54
|
+
"(api[_-]?key|password|secret|token)\\s*[=:]\\s*\\S+"
|
|
55
|
+
]
|
|
56
|
+
},
|
|
57
|
+
"agents": {
|
|
58
|
+
"codex": {
|
|
59
|
+
"enabled": true,
|
|
60
|
+
"adapter": "codex",
|
|
61
|
+
"node": "node",
|
|
62
|
+
"script": "<path-to-your-codex-cli>/bin/codex.js",
|
|
63
|
+
"workdir": "./workdirs/codex",
|
|
64
|
+
"sandbox": "workspace-write",
|
|
65
|
+
"healthUrl": null,
|
|
66
|
+
"timeoutMs": 3600000,
|
|
67
|
+
"env": {},
|
|
68
|
+
"extraArgs": []
|
|
69
|
+
}
|
|
70
|
+
},
|
|
71
|
+
"owner": "you"
|
|
72
|
+
}
|