pkc-js · SilentStars

Telegram group for this repo https://t.me/pkc_js

pkc-js is the TypeScript SDK for PKC (Public Key Communities), a serverless, decentralized social protocol built on IPFS, IPNS, and libp2p pubsub. It powers all PKC clients: CLI, Electron desktop, and web.

Glossary:

CID: https://docs.ipfs.io/concepts/content-addressing/
IPNS: https://docs.ipfs.io/concepts/ipns/#example-ipns-setup-with-cli
IPNS name: hash of a public key, the private key is used by community owners for signing IPNS records, and by authors for signing posts and comments
Pubsub topic: the string to publish/subscribe to in the pubsub https://github.com/ipfs/js-ipfs/blob/master/docs/core-api/PUBSUB.md#ipfspubsubsubscribetopic-handler-options and https://github.com/libp2p/specs/blob/master/pubsub/gossipsub/gossipsub-v1.0.md#topic-membership
IPNS record: https://github.com/ipfs/specs/blob/master/IPNS.md#ipns-record
IPNS signature: https://github.com/ipfs/notes/issues/249
PKC signature types: https://github.com/pkcprotocol/pkc-js/blob/master/docs/signatures.md
PKC encryption types: https://github.com/pkcprotocol/pkc-js/blob/master/docs/encryption.md

Note: IPFS files are immutable, fetched by…

score = signal / reach signal = 0.25·commit_velocity // commits in last 90 days (cap 30) + 0.20·contributor_work // unique authors × velocity (cap 100) + 0.20·issue_resolution // closed ÷ total issues + 0.20·fork_ratio // forks ÷ stars (proxy for real usage) + 0.10·release_cadence // releases in 90 days (cap 3) + age_bonus // +0 to +0.30 after 6 months + homepage_bonus // +0.05 if homepage is set reach = log₁₀(stars + watchers + 10)█

health = 0.35·recency // days since last commit (90d decay) + 0.25·cadence // commit rhythm consistency + 0.20·issue_health // closed ÷ total issues + 0.20·pr_health // merged ÷ total PRs█

Healthy 80 – 100 active, responsive, regular releases Stable 60 – 79 maintained, steady, no alarms Quiet 40 – 59 slowing down — watch this one At Risk 0 – 39 going dark · candidate for rescue█

solo_builder one person holds > 80% of commits (last 180d) needs_contributors has open "help wanted" or "good first issue" labels hidden_gem < 100 stars · active in last 3 months · documented legacy_hero repo > 5 years old · committed this year fork_magnet forks/stars > 0.5 · used as template or dependency release_machine 5+ releases in the last 90 days under_pressure > 10 open issues · ≤ 2 contributors · health ≥ 60 community_watch watchers > stars · devs tracking before the public community_hub GitHub Discussions enabled · > 20 discussions funded maintainer has active funding channel█