Parfii-bot
|
f2358397c9
|
docs: README bio-framing + PHILOSOPHY + security hardening
- README rewritten with bioinspired framing: KeiSeiKit as living
neural structure of Kei (DNA / REM / Deep Sleep / creator lineage).
All counts verified against source: 36 crates, 12 agents, 43 skills,
12 hooks, 82 blocks.
- docs/PHILOSOPHY.md new 11.4 KB deep-dive on the substrate
thesis, the 4-layer architecture, and roadmap (federation / signing
/ marketplace / visualization as Wave 14+).
- .gitignore hardened: .env, secrets/, *.pem, *.key, id_rsa*,
id_ed25519*, .claude/secrets/ — public-repo safe. .env.example
and .env.template re-included.
- docs/SECURITY.md: secret hygiene section with revoke-and-rotate
protocol + canonical ~/.claude/secrets/.env reference (RULE 0.8).
Verified clean: defensive grep for sk-ant-, ghp_, private keys,
token/key assignments = zero hits across tree.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
2026-04-23 15:44:52 +08:00 |
|
Parfii-bot
|
5113c35914
|
docs(w12b): refresh counts across README / INSTALL / REFERENCE after v0.23-v0.27
9 stale count references updated:
- README.md: 12 agents / 43 skills / 12 hooks / 82 blocks / 36 primitives
- docs/INSTALL.md: 33→36 (full profile), new crates enumerated
- docs/REFERENCE.md: 25→36 crates, 10→12 hooks, 39→43 skills; v0.27
note on 11 crates awaiting full per-crate REFERENCE entries
- docs/ARCHITECTURE.md: 10→12 hooks (added capability hooks)
- docs/SUBSTRATE-SCHEMA.md: 25→36 crates (count-only refresh, locked)
- docs/SECURITY.md: battle matrix floors 79/39/10 → 82/43/12
- PLUGIN.md: 24→36 Rust primitives
NOT modified (intentional):
- CHANGELOG.md (auto-generated by kei-changelog)
- docs/WHY.md (stable philosophy)
- docs/TAXONOMY.md (vocab stable)
- docs/HANDOFF-WAKE.md (historical snapshot, frozen by design)
- docs/CONVERGENCE-PLAN.md (strategy analysis, frozen)
- docs/AGENT-SUBSTRATE-SCHEMA.md (phase plan counts are plan-of-record,
not current state)
- SCHEMA-LOCKED.md / SCHEMA-UNLOCKED.md / AGENT-ROLES.md (registry)
- USB-BRAIN-GUIDE-* (platform guides, no counts)
Follow-up flagged: REFERENCE.md needs per-crate expansion for 11 new
crates (kei-agent-runtime, kei-capability, kei-provision, etc). That's
doc rewrite not audit — separate PR.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
2026-04-23 14:44:31 +08:00 |
|
Parfii-bot
|
ce9ba61ee0
|
docs(readme): split 89 KB monolith into hero-pitch + 6 docs/ files
README down from 89 KB to 7.8 KB (11x reduction, target was 10-15 KB).
Visitor-facing README now loads in one screen — hero + 3 killer features
+ what-it-solves + quick install + docs index.
Extracted 6 new files under docs/:
- INSTALL.md (15 KB) — prerequisites, profiles, interactive install,
MCP binary, keisei CLI intro, runtime hook controls, what-you-get table
- REFERENCE.md (35 KB) — every one of 25 Rust primitives + 13 shell
primitives + 10 hooks + 39 skills with actual CLI surface (clap flags,
exit codes, env vars, state paths), keisei CLI deep-dive, 12 pipelines
- ARCHITECTURE.md (11 KB) — build pipeline, creating-a-new-agent,
adding custom blocks/manifests, agents overview, cross-tool bridges,
meta-composer, regen counts, workflow-file editing protocol
- SLEEP-LAYER.md (11 KB) — three-phase nightly cycle diagram,
session self-audit (RULE 0.14), Cloud REM sync, sleep-on-it incubation,
deep-sleep NREM consolidation with 4-primitive pipeline + example
- SECURITY.md (7.6 KB) — threat surface table + 8 mitigations in detail
(memory-repo privacy, secrets-guard patterns, supply-chain SHA pinning,
S3 SSRF, brain path/name validation, exFAT warning, battle matrix)
- WHY.md (3.6 KB) — full 'From the author' manifesto restored from
git history (pre-1f3aaca product pivot). Medium/dev.to-friendly for
virality, separate from the product README
New docs cross-link each other + README has docs index in tail.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
2026-04-22 22:20:22 +08:00 |
|