Публічний реєстр
Звіт про здоров'я програмного забезпеченнясхема 0.34.0 · метрики 2.10.0 · 2026-09-12 21:55 UTC

csuzngjh / principles

Owner-governed behavior alignment and co-evolution system for AI agents. Distills agent behavioral evidence into reviewed, reversible principles.

TypeScriptMIT★ 1 зірка⑂ 1 форкз січ. 2026 р.Переглянути на GitHub ↗
ТипІнструмент командного рядкаДесктопний застосунокБібліотекаВебінтерфейсяк це визначено

csuzngjh/principles має індекс здоров’я 81 зі 100, що відповідає смузі «Відмінний». Найвищий показник — Vitality (90/100), найнижчий — Community & Adoption (47/100). Останнє оновлення — сьогодні. Більшість нещодавньої роботи виконує один учасник.

81
загалом / 100
Відмінний

Індекс здоров'я програмного забезпечення

Метрики згруповано у зважені категорії на шкалі 1–100. Загальна оцінка починається як їхнє зважене середнє, відкаліброване за розподілом публічного реєстру, тож діапазони мають перцентильний зміст; коли публічні дані активують Політику юрисдикцій високого ризику, рейтинг коригується й отримує верхню межу 34 («У зоні ризику»).

81
Винятковий93-100Верхній щабель реєстру (≈ топ-5%); відповідає практично всім перевіреним критеріям
Відмінний80-92Сильний за всіма напрямами; незначні прогалини
Добрий65-79Здоровий; прогалини обмежені та керовані
Помірний50-64Прийнятний, але з помітними прогалинами; рекомендовано перевірку
Слабкий35-49Суттєві недоліки в кількох сферах
У зоні ризику20-34Суттєві слабкі місця; впровадження потребує обережності
Критичний1-19Серйозні проблеми (покинутий, єдиний мейнтейнер, без базової гігієни)
ЖиттєздатністьСпільнота тавпровадженняСталість таврядуванняІнженернаякістьБезпекаГотовність доШІ

Профіль оцінок

Кожна вісь — окрема категорія. Форма важить більше, ніж середнє: здоровий об'єкт заповнює всю фігуру, тоді як профіль із піками та провалами означає, що сила в одному вимірі маскує ризик в іншому.

Зважений загальний бал 69 калібровано до 81 за шкалою опублікованого індексу (калібрування реєстру 2026-08-02).

Власність

PDОсобистий обліковий запис
9 підписників2 публічні репозиторіїз груд. 2014 р.

Цей репозиторій належить особистому обліковому запису. Проєкт з єдиним власником несе більший ризик безперервності, ніж підтримуваний організацією.

Пакетні екосистеми

РеєстрПакетВерсіяЗавантажень / місВерсіїОстання публікаціяТеги
npm@principles/pd-cli1.151.05 6971190 днів тому—
npm@principles/host-runtime0.5.03 600190 днів тому—
npm@principles/codex-adapter0.2.92 622133 дні тому—
npm@principles/install-layout0.2.42 35073 дні тому—
npmprinciples-disciple1.238.011 3973190 днів тому—
npm@principles/core1.281.015 6623000 днів тому—
npmcreate-principles-disciple1.139.013 6441440 днів томуopenclawprinciples-disciplecliinstallerinteractive

Метрики за категоріями

Життєздатність

Чи живий проєкт — чи пишеться код і чи виходять релізи?

90Відмінний · 21% загального індексу
Як обчислюється оцінка
36/36Свіжість push — останній push 0 дн. тому
18.7/36Ритм комітів — 27/52 тижнів із комітами
18/18Обсяг комітів — 3 155 комітів за останній рік
10/10OpenSSF Scorecard: Maintained — 30 commit(s) and 5 issue activity found in the last 90 days -- score normalized to 10
Використані вхідні дані
commits_last_year3 155
human_commit_share1
days_since_last_push0
active_weeks_last_year27
Як обчислюється оцінка
27/27Випускає релізи — опубліковано 71 релізів
36/36Свіжість релізів — останній реліз 0 дн. тому
27/27Ритм релізів — реліз кожні ~0,2 дн.
0/10OpenSSF Scorecard: Signed-Releases — немає даних
Використані вхідні дані
releases_count71
latest_release_tagv1.238.0
releases_from_tagsні
days_since_latest_release0
mean_days_between_releases0,2
Виключено з оцінювання (немає даних або не застосовно): OpenSSF Scorecard: Signed-Releases. Залишкові ваги перенормовано.

Спільнота та впровадження

Чи має проєкт користувачів, завантаження, увагу та влаштовані умови для контриб’юторів?

47Слабкий · 17% загального індексу
Як обчислюється оцінка
0/60Зірки — 1 зірок
0/25Форки — 1 форків
0/15Спостерігачі — 0 спостерігачів
Використані вхідні дані
forks1
stars1
watchers0
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonbelow_threshold
Як обчислюється оцінка
22.5/22.5README
22.5/22.5Ліцензія — визнана ліцензія (MIT)
18/18Настанови CONTRIBUTING
0/13.5Кодекс поведінки
0/7.2Шаблон issue
6.3/6.3Шаблон PR
Використані вхідні дані
has_readmeтак
has_licenseтак
readme_badges4
has_contributingтак
has_issue_templateні
has_code_of_conductні
readme_badge_servicesshields.io
has_pull_request_templateтак
Як обчислюється оцінка
63.2/80Щомісячні завантаження — 54 972 завантажень/місяць у npm
0/20Залежні пакети в реєстрі — ця екосистема цього не повідомляє
Використані вхідні дані
packages@principles/pd-cli, @principles/host-runtime, @principles/codex-adapter, @principles/install-layout, principles-disciple, @principles/core, create-principles-disciple
dependents—
ecosystemsnpm
total_downloads—
monthly_downloads54 972
unverified_packages_excluded—
Виключено з оцінювання (немає даних або не застосовно): Залежні пакети в реєстрі. Залишкові ваги перенормовано.

Сталість та врядування

Чи переживе проєкт своїх людей — бас-фактор, реактивність, хто за ним стоїть і як супроводжуються пакети?

54Помірний · 23% загального індексу
Як обчислюється оцінка
9/54Бас-фактор — на 1 контриб’ютор(ів) припадає половина всіх комітів
0/22.5Розподіл комітів — головний контриб’ютор — автор 100% комітів
4.1/13.5Широта контриб’юторів — 3 контриб’юторів
0/10OpenSSF Scorecard: Contributors — project has 0 contributing companies or organizations -- score normalized to 0
Використані вхідні дані
bus_factor1
contributors_sampled3
top_contributor_share0,999
Як обчислюється оцінка
42/42Вирішення issue — закрито 100% issue
27.8/30Прийняття PR — злито 1 402/1 512 вирішених PR
0/13Newcomer PR acceptance — за 30 дн. не вирішено жодного PR від новачка
0/15OpenSSF Scorecard: Code-Review — Found 0/10 approved changesets -- score normalized to 0
Використані вхідні дані
merged_prs1 402
open_issues0
closed_issues135
prs_merged_7d59
prs_decided_7d60
prs_merged_30d59
prs_decided_30d60
issue_closed_ratio1
closed_unmerged_prs110
first_time_authors_30d0
first_time_prs_merged_30d0
first_time_prs_decided_30d0
Виключено з оцінювання (немає даних або не застосовно): Newcomer PR acceptance. Залишкові ваги перенормовано.
Як обчислюється оцінка
10/30Підтримка власника — особистий (користувацький) обліковий запис
0/20Верифікований домен — не застосовно до користувацьких облікових записів
7.2/25Охоплення власника — 9 підписників у csuzngjh
15.5/25Послужний список — 2 публічних репозиторіїв, вік облікового запису ~11 р.
Використані вхідні дані
followers9
owner_typeUser
is_verified—
owner_logincsuzngjh
public_repos2
account_age_days4 301
Виключено з оцінювання (немає даних або не застосовно): Верифікований домен. Залишкові ваги перенормовано.

Супровід пакетів

100Винятковий
Як обчислюється оцінка
25/25Опубліковано й доступно — 7 пакет(ів) у npm
35/35Свіжість публікацій — остання публікація 0 дн. тому
20/20Історія версій — 319 опублікованих версій
20/20Не застарілий — активний, не deprecated і не yanked
Використані вхідні дані
packages@principles/pd-cli, @principles/host-runtime, @principles/codex-adapter, @principles/install-layout, principles-disciple, @principles/core, create-principles-disciple
ecosystemsnpm
any_deprecatedні
min_days_since_publish0

Інженерна якість

Чи наявні базові інженерні практики та документація?

86Відмінний · 19% загального індексу
Як обчислюється оцінка
24/24Процеси CI — 18 процес(ів) CI
24/24Наявні тести
16/16Конфігурація лінтера — eslint.config.js
0/9.6Pre-commit-хуки
0/6.4.editorconfig
20/20OpenSSF Scorecard: CI-Tests — 10 out of 10 merged PRs checked by a CI test -- score normalized to 10
Використані вхідні дані
has_ciтак
has_testsтак
has_editorconfigні
has_linter_configтак
has_precommit_configні

Документація

90Відмінний
Як обчислюється оцінка
30/30README
25/25Каталог документації
15/15Сайт документації / домашня сторінка — https://principles-website.pages.dev
10/10Опис репозиторію
10/10Теми — 12 тем
0/10Wiki
Використані вхідні дані
topicsai-agent, monorepo, openclaw, openclaw-plugin, principles, self-improving, sqlite, typescript, pain-signals, agent-governance, co-evolution, alignment-layer
has_wikiні
homepagehttps://principles-website.pages.dev
docs_sitehttps://principles-website.pages.dev
has_readmeтак
has_docs_dirтак
has_descriptionтак

Безпека

Чи міцні видимі практики безпеки й ланцюга постачання, без непослабленої пов’язаності з юрисдикціями високого ризику?

67Добрий · 16% загального індексу
Як обчислюється оцінка
7.5/7.5Binary-Artifacts — no binaries found in the repo
0/7.5Branch-Protection — немає даних
2.5/2.5CI-Tests — 10 out of 10 merged PRs checked by a CI test -- score normalized to 10
0/2.5CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected
0/7.5Code-Review — Found 0/10 approved changesets -- score normalized to 0
0/2.5Contributors — project has 0 contributing companies or organizations -- score normalized to 0
10/10Dangerous-Workflow — no dangerous workflow patterns detected
7.5/7.5Dependency-Update-Tool — update tool detected
5/5Fuzzing — project is fuzzed
2.5/2.5Ліцензія — license file detected
7.5/7.5Maintained — 30 commit(s) and 5 issue activity found in the last 90 days -- score normalized to 10
5/5Packaging — packaging workflow detected
3/5Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 6
5/5SAST — SAST tool is run on all commits
5/5Security-Policy — security policy file detected
0/7.5Signed-Releases — немає даних
0/7.5Token-Permissions — detected GitHub workflow tokens with excessive permissions
0/7.5Vulnerabilities — 36 existing vulnerabilities detected
Використані вхідні дані
sourceopenssf_scorecard
checks_evaluated16
scorecard_versionv5.5.0
checks_inconclusive2
scorecard_aggregate6,7
Виключено з оцінювання (немає даних або не застосовно): Branch-Protection, Signed-Releases. Залишкові ваги перенормовано.

Готовність до ШІ

Наскільки репозиторій оснащений для розробки та супроводу за участі ШІ-агентів? Має свідомо малу вагу (4%): агентний інструментарій — реальний сигнал супроводу, але репозиторій без нього все одно може отримати 100/100.

77Добрий · 4% загального індексу
Як обчислюється оцінка
45/45Інструкції для агентів — AGENTS.md, CLAUDE.md, GEMINI.md, packages/openclaw-plugin/src/core/AGENTS.md, packages/openclaw-plugin/src/hooks/AGENTS.md, packages/openclaw-plugin/templates/langs/en/core/AGENTS.md, packages/openclaw-plugin/templates/langs/zh/core/AGENTS.md, packages/website/video/homepage-demo/AGENTS.md, packages/website/video/homepage-demo/CLAUDE.md
0/15Машиночитана документація (llms.txt)
36.8/40Читабельна історія комітів — намір зазначено у 69 з 100 людських комітів (структурований заголовок або пояснювальний текст)
Використані вхідні дані
has_llms_txtні
llms_txt_url—
legible_history_share0,69
agent_instruction_filesAGENTS.md, CLAUDE.md, GEMINI.md, packages/openclaw-plugin/src/core/AGENTS.md, packages/openclaw-plugin/src/hooks/AGENTS.md, packages/openclaw-plugin/templates/langs/en/core/AGENTS.md, packages/openclaw-plugin/templates/langs/zh/core/AGENTS.md, packages/website/video/homepage-demo/AGENTS.md, packages/website/video/homepage-demo/CLAUDE.md
agent_instruction_max_bytes43 264
Як обчислюється оцінка
0/18Розгортання однією командою
22/22Автоматизовані тести
11/11Конфігурація лінтера / форматера — eslint.config.js
11/11Статична перевірка типів — packages/codex-adapter/tsconfig.json, packages/create-principles-disciple/tsconfig.json, packages/host-runtime/tsconfig.json, packages/install-layout/tsconfig.json, packages/openclaw-plugin/tsconfig.json, packages/pd-cli/tsconfig.json, packages/pd-companion/tsconfig.json, packages/pd-console/tests/ai-user/tsconfig.json, packages/pd-console/tests/e2e/tsconfig.json, packages/pd-console/tsconfig.json, packages/principles-core/tsconfig.json, scripts/nocturnal/tsconfig.json, tests/e2e-fixtures/trap-01-circular-dep/tsconfig.json, tsconfig.json
10/10Відтворюване середовище — Dockerfile, lockfile
0/10Підтверджена практика роботи з агентами — серед останніх 100 комітів немає створених агентом
5/8Автоматизоване супроводження — автоматизацію залежностей налаштовано, але у вибірці комітів її не видно
6/10OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 6
Використані вхідні дані
has_nixні
has_testsтак
lockfilespackage-lock.json
has_dockerfileтак
typed_languageтак
bootstrap_files—
has_devcontainerні
has_linter_configтак
typecheck_configspackages/codex-adapter/tsconfig.json, packages/create-principles-disciple/tsconfig.json, packages/host-runtime/tsconfig.json, packages/install-layout/tsconfig.json, packages/openclaw-plugin/tsconfig.json, packages/pd-cli/tsconfig.json, packages/pd-companion/tsconfig.json, packages/pd-console/tests/ai-user/tsconfig.json, packages/pd-console/tests/e2e/tsconfig.json, packages/pd-console/tsconfig.json, packages/principles-core/tsconfig.json, scripts/nocturnal/tsconfig.json, tests/e2e-fixtures/trap-01-circular-dep/tsconfig.json, tsconfig.json
agent_commit_share0
toolchain_manifests—
dependency_bot_commit_share0
Як обчислюється оцінка
45/45Типізований код — TypeScript (статично типізована)
54.3/55Керовані розміри файлів — 26/2 053 файлів вихідного коду понад 60 КБ
Використані вхідні дані
primary_languageTypeScript
largest_source_bytes203 327
source_files_sampled2 053
oversized_source_files26

Ключові факти

1зірок GitHub
3контриб'юторів
3 155комітів за останні 12 місяців
0днів від останнього пушу
71релізів
1бас-фактор
0відкритих issue
npmпакетних екосистем

Попередження щодо збору даних

  • Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
  • Star history carried forward from 2026-06-22: GitHub restricted the stargazers API to repository admins, so it can no longer be collected. The repository has 1 stars today.
  • Could not fetch npm package '@principles/nocturnal-benchmark' from its registry
  • GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository
  • deps.dev does not index npm:@principles/pd-cli@1.151.0; advisories assessed against the repository dependency graph instead

Докладніше

Історія зірок і форків 1 ★ / 1 ⇿
1Зірки
1Форки
28Релізи

Коли додано кожну зірку й форк — зібрано з GitHub і згруповано за днями. Кумулятивне зростання розміщено просто над денними додаваннями, з яких воно складається, тож їх видно одне проти одного: рівномірне органічне накопичення виглядає зовсім інакше, ніж різкий короткочасний сплеск. Там, де цю різницю можна виміряти, її подано як автентичність росту.

Історію зірок показано станом на 2026-06-22. У липні 2026 року GitHub обмежив доступ до API stargazers адміністраторами репозиторію, тож цей ряд більше не продовжується; загальна кількість зірок вище лишається актуальною.

0001111112026-062026-072026-08
Мажорні 0Мінорні 14Патчі 13
OpenSSF Scorecard 6.7 / 10
6.7сукупно

Незалежна, не прив'язана до інструментів оцінка безпеки від відкритого проєкту OpenSSF Scorecard. Кожна перевірка винагороджує практику безпеки, а не інструмент конкретного постачальника. Перевірки, які Scorecard не зміг визначити, позначено н/д і виключено з оцінки безпеки (вони ніколи не зараховуються як нуль).Scorecard v5.5.0 · 2026-09-12 21:54 UTC

10Binary-Artifactsno binaries found in the repo
н/дBranch-Protectioninternal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md
10CI-Tests10 out of 10 merged PRs checked by a CI test -- score normalized to 10
0CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
0Code-ReviewFound 0/10 approved changesets -- score normalized to 0
0Contributorsproject has 0 contributing companies or organizations -- score normalized to 0
10Dangerous-Workflowno dangerous workflow patterns detected
10Dependency-Update-Toolupdate tool detected
10Fuzzingproject is fuzzed
10Licenselicense file detected
10Maintained30 commit(s) and 5 issue activity found in the last 90 days -- score normalized to 10
10Packagingpackaging workflow detected
6Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 6
10SASTSAST tool is run on all commits
10Security-Policysecurity policy file detected
н/дSigned-Releasesno releases found
0Token-Permissionsdetected GitHub workflow tokens with excessive permissions
0Vulnerabilities36 existing vulnerabilities detected
Прямі залежності 72
РеєстрПакетОбмеження версіїМаніфест
npmglob^13.0.6package.json
npm@principles/core^1.74.1packages/codex-adapter/package.json
npm@principles/host-runtime^0.1.0packages/codex-adapter/package.json
npm@principles/install-layout^0.2.0packages/codex-adapter/package.json
npm@principles/install-layout^0.2.0packages/create-principles-disciple/package.json
npm@tufjs/models3.0.1packages/create-principles-disciple/package.json
npm@inquirer/prompts^8.7.1packages/create-principles-disciple/package.json
npmcommander^14.0.3packages/create-principles-disciple/package.json
npmfs-extra^11.4.0packages/create-principles-disciple/package.json
npmjs-yaml^5.3.0packages/create-principles-disciple/package.json
npmora^9.4.1packages/create-principles-disciple/package.json
npmpicocolors^1.0.0packages/create-principles-disciple/package.json
npmsemver^7.8.5packages/create-principles-disciple/package.json
npmtar^7.5.22packages/create-principles-disciple/package.json
npmtuf-js3.1.0packages/create-principles-disciple/package.json
npm@principles/core^1.74.1packages/host-runtime/package.json
npm@principles/install-layout^0.2.0packages/host-runtime/package.json
npmbetter-sqlite3^13.0.3packages/host-runtime/package.json
npmjs-yaml^5.2.0packages/host-runtime/package.json
npm@principles/core^1.74.1packages/openclaw-plugin/package.json
npm@sinclair/typebox^0.34.48packages/openclaw-plugin/package.json
npmbetter-sqlite3^13.0.3packages/openclaw-plugin/package.json
npmcommander^12.0.0packages/openclaw-plugin/package.json
npmjs-yaml^5.2.0packages/openclaw-plugin/package.json
npmmicromatch^4.0.8packages/openclaw-plugin/package.json
npm@principles/core^1.74.1packages/pd-cli/package.json
npm@principles/codex-adapter^0.1.0packages/pd-cli/package.json
npm@principles/host-runtime^0.1.0packages/pd-cli/package.json
npm@principles/install-layout^0.2.0packages/pd-cli/package.json
npmprinciples-disciple^1.74.1packages/pd-cli/package.json
npmbetter-sqlite3^13.0.3packages/pd-cli/package.json
npmcommander^12.0.0packages/pd-cli/package.json
npmjs-yaml^4.1.1packages/pd-cli/package.json
npm@principles/install-layout^0.2.0packages/pd-companion/package.json
npm@fontsource/jetbrains-mono^5.2.8packages/pd-console/package.json
npm@principles/core*packages/pd-console/package.json
npm@principles/host-runtime*packages/pd-console/package.json
npm@principles/install-layout^0.2.0packages/pd-console/package.json
npmcreate-principles-disciple*packages/pd-console/package.json
npmprinciples-disciple*packages/pd-console/package.json
npm@radix-ui/react-alert-dialog^1.1.15packages/pd-console/package.json
npm@radix-ui/react-dialog^1.1.15packages/pd-console/package.json
npm@radix-ui/react-select^2.3.7packages/pd-console/package.json
npm@radix-ui/react-slot^1.2.4packages/pd-console/package.json
npm@radix-ui/react-tooltip^1.2.11packages/pd-console/package.json
npm@sinclair/typebox^0.34.48packages/pd-console/package.json
npm@tailwindcss/postcss^4.3.3packages/pd-console/package.json
npm@tailwindcss/vite^4.3.3packages/pd-console/package.json
npmautoprefixer^10.5.5packages/pd-console/package.json
npmbetter-sqlite3^13.0.3packages/pd-console/package.json
npmclass-variance-authority^0.7.1packages/pd-console/package.json
npmclsx^2.1.1packages/pd-console/package.json
npmi18next^26.4.2packages/pd-console/package.json
npmjs-yaml^4.2.0packages/pd-console/package.json
npmlucide-react^1.28.0packages/pd-console/package.json
npmpostcss^8.5.14packages/pd-console/package.json
npmpostcss-cli^11.0.1packages/pd-console/package.json
npmreact^19.2.8packages/pd-console/package.json
npmreact-dom^19.2.8packages/pd-console/package.json
npmreact-i18next^17.0.11packages/pd-console/package.json
npmreact-router-dom^7.18.3packages/pd-console/package.json
npmsemver^7.8.5packages/pd-console/package.json
npmsonner^2.0.7packages/pd-console/package.json
npmtailwind-merge^3.6.0packages/pd-console/package.json
npmtailwindcss^4.3.3packages/pd-console/package.json
npm@earendil-works/pi-agent-core^0.84.1packages/principles-core/package.json
npm@earendil-works/pi-ai^0.84.2packages/principles-core/package.json
npm@sinclair/typebox^0.34.48packages/principles-core/package.json
npmbetter-sqlite3^13.0.3packages/principles-core/package.json
npmjs-yaml^4.1.1packages/principles-core/package.json
npmtypebox^1.3.16packages/principles-core/package.json
npmundici^7.25.0packages/principles-core/package.json
Усі залежності не зібрано

Не вдалося зібрати розв'язаний набір залежностей для цього звіту: GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository

Звіт у форматі JSON машиночитний

Зворотний зв’язок

Помітили щось хибне у цьому звіті або маєте чим поділитися? Неправильні вимірювання, непомічені інструменти, ідеї, запитання — усе доречно. Кожне повідомлення читається й отримує відповідь.

Повідомлення збережеться під час входу.

Оцінки — це сигнали, а не гарантії. Вони відображають публічно видимі практики на GitHub — це не аудит коду й не гарантія безпеки.

Відсутні дані виключаються, а ваги перенормовуються — нуль за відсутність ніколи не ставиться. Методологія версіонована й відкрита: метрики v2.10.0, схема v0.34.0 — повна методологія · вікі метрик.

Як окремий результат виглядає на тлі всього реєстру: сукупна статистика — npm.