Updates

network-discovery/hyper-p2p-capability-discovery/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## [0.0.0-scaffold] — Wave 8
+
+- Registry scaffold: file tree, load smoke tests, docs stubs

network-discovery/hyper-p2p-capability-discovery/README.md

@@ -0,0 +1,28 @@
+# hyper-p2p-capability-discovery
+
+**Status:** scaffold (`0.0.0-scaffold`) · **Protocol:** `capability-discovery/v1` · **Wave:** 8
+
+Capability-based discovery.
+
+## Holepunch references (inspiration only)
+
+- (none yet)
+
+> This module composes on Hyperswarm/Hypercore — it does **not** re-implement upstream packages.
+
+## Composes with
+
+- (none yet)
+
+## Planned API
+
+- `constructor(opts)` — topic, optional keyPair
+- `getStats()` — scaffold counters
+- `ready()` — no-op until implemented
+- Domain methods — throw `not implemented: scaffold` until Wave 8+ pass
+
+## Layout
+
+`modules/network-discovery/hyper-p2p-capability-discovery/`
+
+See [`modules/_shared/MODULE_SYSTEM.md`](../../_shared/MODULE_SYSTEM.md).

network-discovery/hyper-p2p-capability-discovery/SCAFFOLD.json

@@ -0,0 +1,11 @@
+{
+  "name": "hyper-p2p-capability-discovery",
+  "category": "network-discovery",
+  "tier": "scaffold",
+  "protocol": "capability-discovery/v1",
+  "class": "HyperP2PCapabilityDiscovery",
+  "wave": 8,
+  "holepunch_refs": [],
+  "composes_with": [],
+  "status": "scaffold"
+}

network-discovery/hyper-p2p-capability-discovery/docs/api.md

@@ -0,0 +1,23 @@
+# hyper-p2p-capability-discovery API
+
+**Status:** scaffold · **Protocol:** `capability-discovery/v1`
+
+## Class `HyperP2PCapabilityDiscovery`
+
+Scaffold stub — methods throw `not implemented: scaffold` until promoted to production tier.
+
+### `constructor(opts?)`
+
+### `getStats()`
+
+Returns `{ created, errors, protocol, tier: 'scaffold' }`.
+
+### `ready()`
+
+Resolves immediately (no-op).
+
+## Wire (planned)
+
+| Message | Direction | Notes |
+|---------|-----------|-------|
+| TBD | gossip | Defined in implementation pass |

network-discovery/hyper-p2p-capability-discovery/docs/architecture.md

@@ -0,0 +1,15 @@
+# hyper-p2p-capability-discovery architecture
+
+**Tier:** scaffold · **Category:** `network-discovery`
+
+## Role
+
+Capability-based discovery.
+
+## Composition
+
+Uses `../../_shared/p2p-bare.js` for Hyperswarm + Protomux when implemented. Does **not** duplicate Holepunch core storage/transport.
+
+## Holepunch boundary
+
+Inspiration: n/a

network-discovery/hyper-p2p-capability-discovery/examples/basic.js

@@ -0,0 +1,8 @@
+require('bare-process/global')
+const { HyperP2PCapabilityDiscovery } = require('../index.js')
+
+async function main () {
+  const m = new HyperP2PCapabilityDiscovery()
+  console.log('[scaffold]', m.getStats())
+}
+main().catch(console.error)

network-discovery/hyper-p2p-capability-discovery/index.js

@@ -0,0 +1,25 @@
+require('bare-process/global')
+const EventEmitter = require('bare-events')
+
+const PROTOCOL = 'capability-discovery/v1'
+
+class HyperP2PCapabilityDiscovery extends EventEmitter {
+  constructor (opts = {}) {
+    super()
+    this.topic = opts.topic || null
+    this._stats = { created: 0, errors: 0 }
+  }
+
+  getStats () {
+    return { ...this._stats, protocol: PROTOCOL, tier: 'scaffold' }
+  }
+
+  async ready () { return true }
+
+  _notImplemented (method) {
+    this._stats.errors++
+    throw new Error(`not implemented: scaffold (${method})`)
+  }
+}
+
+module.exports = { HyperP2PCapabilityDiscovery, PROTOCOL }

network-discovery/hyper-p2p-capability-discovery/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "hyper-p2p-capability-discovery",
+  "version": "0.0.0-scaffold",
+  "description": "Capability-based discovery.",
+  "main": "index.js",
+  "type": "commonjs",
+  "license": "Apache-2.0",
+  "scripts": { "test": "brittle-bare test/test.js" },
+  "dependencies": {
+    "bare-events": "^2.8.0",
+    "bare-process": "^4.4.0",
+    "bare-timers": "^2.0.0",
+    "b4a": "^1.6.7",
+    "hypercore-crypto": "^3.0.0",
+    "protomux": "^3.0.0",
+    "compact-encoding": "^2.0.0"
+  },
+  "peerDependencies": { "hyperswarm": "^4.0.0", "bare": ">=1.0.0" },
+  "devDependencies": { "brittle": "^3.0.0" },
+  "imports": {
+    "process": { "bare": "bare-process", "default": "process" },
+    "events": { "bare": "bare-events", "default": "events" },
+    "timers": { "bare": "bare-timers", "default": "timers" }
+  }
+}

network-discovery/hyper-p2p-capability-discovery/test/test.js

@@ -0,0 +1,14 @@
+const test = require('brittle')
+const { HyperP2PCapabilityDiscovery, PROTOCOL } = require('../index.js')
+
+test('exports load', (t) => {
+  t.ok(HyperP2PCapabilityDiscovery)
+  t.is(PROTOCOL, 'capability-discovery/v1')
+})
+
+test('getStats shape', async (t) => {
+  const m = new HyperP2PCapabilityDiscovery()
+  const s = m.getStats()
+  t.is(s.tier, 'scaffold')
+  t.is(s.protocol, 'capability-discovery/v1')
+})