Skip to content

Repository files navigation

Silo

npm versionnpm downloadslicensenodeCIExplore on DeepWiki

Reusable knowledge for research sprints.

Instead of starting every sprint from scratch, pull in battle-tested constraint sets, risk patterns, and decision templates. Grab a starter pack in one command:

npx @grainulation/silo pull compliance --into ./claims.json

Install

npm install -g @grainulation/silo

Built-in packs

24 knowledge packs with 268 curated claims. Run silo packs for the current list with descriptions. The core domain packs:

PackClaimsWhat's inside
api-design13REST conventions, versioning, pagination, error formats, GraphQL tradeoffs
architecture12Monolith vs micro, build vs buy, SQL vs NoSQL decision claims
ci-cd12CI/CD pipeline patterns, caching, rollback strategies
compliance14HIPAA, SOC 2, GDPR constraint sets with regulatory citations
data-engineering12ETL patterns, data quality, warehouse design
frontend12Frontend architecture, performance, accessibility patterns
migration10Database/cloud/framework migration risks and patterns
observability12Logging, metrics, tracing, alerting patterns
security12Security constraints, threat models, authentication patterns
team-process12Team workflow, code review, incident response patterns
testing10Testing strategies, coverage, test architecture

Also includes: adr, architecture-decision, coverage-ramp, incident-postmortem, qa-simulation, vendor-eval, 5 hackathon packs. The full list is silo packs.

Quick start

# See available packs
silo packs
# Pull compliance constraints into your sprint
silo pull compliance --into ./claims.json
# Pull only GDPR constraints
silo pull compliance --into ./claims.json --type constraint
# Search across stored claims
silo search "encryption at rest"# Store your sprint's findings for reuse
silo store "q4-migration-findings" --from ./claims.json
# List everything in your silo
silo list

CLI

CommandDescription
silo listList all stored collections
silo pull <pack> --into <file>Pull claims into a claims file
silo store <name> --from <file>Store claims from a sprint
silo search <query>Full-text search across claims
silo packsList available knowledge packs
silo publish <name> --collections <ids>Bundle collections into a pack
silo install <file>Install a pack from a JSON file
`silo fetch [--mode autoconcise
`silo cache statsclear

Testing

npm test# unit + extraction tests (no network)
npm run test:live # includes live regression fixtures (FETCH_LIVE=1)

How it works

Silo uses your filesystem for storage (~/.silo by default). No database, no network calls, no accounts.

When you pull, Silo re-prefixes claim IDs to avoid collisions, deduplicates against existing claims, and merges into your claims.json.

When you store, Silo hashes the content for versioning, saves to ~/.silo/claims/, and updates the search index.

Programmatic API

const{ Store }=require("@grainulation/silo/lib/store");const{ Search }=require("@grainulation/silo/lib/search");const{ ImportExport }=require("@grainulation/silo/lib/import-export");conststore=newStore().init();constsearch=newSearch(store);constio=newImportExport(store);constresults=search.query("encryption",{type: "constraint"});io.pull("compliance","./claims.json");io.push("./claims.json","my-sprint-findings");

Zero third-party dependencies

Depends only on @grainulation/barn (internal ecosystem utilities); no third-party runtime deps. Node built-ins otherwise. Filesystem-based storage. Works offline.

Part of the grainulation ecosystem

ToolRole
wheatResearch engine -- grow structured evidence
farmerPermission dashboard -- approve AI actions in real time
barnShared tools -- templates, validators, sprint detection
millFormat conversion -- export to PDF, CSV, slides, 26 formats
siloKnowledge storage -- reusable claim libraries and packs
harvestAnalytics -- cross-sprint patterns and prediction scoring
orchardOrchestration -- multi-sprint coordination and dependencies
grainulationUnified CLI -- single entry point to the ecosystem

Releases

See CHANGELOG.md for release history.

License

MIT

About

Persistent knowledge packs for AI agents. Store, search, and serve claims across sessions

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Contributors

Languages