@psiclawops/hypermem 0.1.0

package/ARCHITECTURE.md

@@ -0,0 +1,296 @@
+# HyperMem Architecture
+
+_Agent-centric memory that outlives sessions._
+
+---
+
+## Memory Layers
+
+```
+L1  Redis (Hot)              Active session working memory
+     │                       Slots: system, identity, messages, facts, context
+     │                       Sub-millisecond reads, evicts on session end
+     │                       Fleet cache: agent profiles, fleet summary
+     │
+L2  Agent Messages DB        Raw conversation history (per agent)
+     │  messages.db           Write-heavy, rotatable (100MB / 90 days)
+     │  messages_YYYYQN.db    Rotated archives, read-only
+     │
+L3  Agent Vectors DB         Semantic search index (per agent)
+     │  vectors.db            Index rebuilt from L2+L4 (reconstructable)
+     │                        KNN search via sqlite-vec (nomic-embed-text, 768d)
+     │                        Rate-limited embedding via token bucket
+     │
+L4  Library DB               Fleet-wide structured knowledge
+        library.db            Facts, knowledge, preferences, fleet registry
+                              Episodes, topics, work items, system state
+                              Desired state, agent capabilities
+                              Knowledge graph (DAG links between entities)
+```
+
+## Database Schema
+
+### messages.db (per agent, schema v3)
+- `agent_meta` — agent metadata
+- `conversations` — session tracking
+- `messages` — raw message log (text, tool calls, tool results)
+- `schema_version` — migration tracking
+- **Rotation:** When size > 100MB or age > 90 days, renamed to `messages_YYYYQN.db`
+- **WAL mode** with checkpoint on rotation
+
+### vectors.db (per agent)
+- `vec_facts` — 768-dimensional vectors for facts (sqlite-vec virtual table)
+- `vec_knowledge` — vectors for knowledge entries
+- `vec_episodes` — vectors for episode descriptions
+- `vec_sessions` — vectors for session summaries
+- `vec_index_map` — tracks what's been indexed (source_table, source_id, source_db)
+- `embedding_cache` — avoids redundant Ollama API calls
+
+### library.db (shared, schema v5)
+- `facts` — verifiable claims with confidence, domain, expiry, supersedes chains
+- `knowledge` — domain/key/value structured data
+- `knowledge_links` — DAG edges between entities (fact↔fact, fact↔knowledge, etc.)
+- `episodes` — significant events with impact and participants
+- `topics` — cross-session thread tracking
+- `preferences` — operator/user behavioral patterns
+- `fleet_agents` — agent registry with tier, org, capabilities (JSON)
+- `fleet_orgs` — organizational structure
+- `agent_capabilities` — queryable skills, tools, MCP servers per agent
+- `agent_desired_state` — intended configuration vs. actual (drift detection)
+- `agent_config_events` — change audit trail
+- `system_registry` — service state tracking
+- `system_events` — service lifecycle events
+- `work_items` — work queue entries with FTS5
+- `session_registry` — session lifecycle tracking
+
+## Compositor
+
+Assembles LLM prompts from all four layers with token budgeting:
+
+```
+User message arrives
+  │
+  ├── L1 Redis: system prompt, identity, cached slots
+  ├── L2 Messages: recent conversation history (budget-truncated)
+  ├── L3 Vectors: KNN semantic recall on user's latest message
+  │     └── Related facts/knowledge/episodes with relevance scores
+  ├── L4 Library: structured knowledge injection
+  │     ├── Facts (up to 30% of remaining budget): active, non-expired, sorted by confidence
+  │     ├── Knowledge (up to 20% of remaining): grouped by domain, top 15 entries
+  │     └── Preferences (up to 10% of remaining): behavioral patterns, grouped by subject
+  └── Cross-session (up to 20% of remaining): context from related sessions
+```
+
+Each slot gets a proportional budget cap. Smart truncation at line boundaries.
+Multi-provider output: Anthropic and OpenAI message formats.
+
+### Tuning Parameters (TUNE-001–007)
+
+Compositor behavior is tuned via parameters tracked in `tune/TUNING_REGISTRY.md`:
+
+| ID | Parameter | Value | Effect |
+|---|---|---|---|
+| TUNE-001 | Semantic recall min RRF score | 0.008 | Drops noise results from hybrid search |
+| TUNE-002 | Facts confidence floor | 0.5 | Excludes low-confidence facts from injection |
+| TUNE-003 | Differentiated fact confidence | 0.60–0.75 by type | Decisions/incidents score higher than config/prefs |
+| TUNE-004 | config_change episode significance | 0.5 (was 0.4) | Config changes no longer silently dropped |
+| TUNE-005 | Extraction slot guard | suppress on default | No-op when strategy is lightweight/default |
+| TUNE-006 | Advisor slot guard | suppress bare seat list | No-op when no domain routes matched |
+| TUNE-007 | Identity anchor guard | suppress on default identity | No-op when identity resolves to 'default' |
+
+### Safety Mechanisms
+
+- **Budget safety valve:** Post-assembly check — if estimated tokens exceed budget × 1.05, trims oldest history messages until under budget. System/identity/current prompt are never touched.
+- **Compaction fence:** Per-conversation boundary protecting the LLM's recent tail from compaction. Only moves forward (monotone progress). No fence = no compaction (explicit opt-in).
+- **Preservation gate:** Nomic-space geometric verification that summaries stay faithful to source content. Centroid alignment + source coverage → combined score (threshold: 0.65).
+
+## Fleet Cache (Redis Hot Layer)
+
+```
+fleet:agent:{id}   — Composite profile: registry + capabilities + desired state
+fleet:summary      — Fleet-wide stats: agent count, drift count, tier breakdown
+```
+
+- **Cache-aside** on reads: Redis first, SQLite fallback, warm on miss
+- **Write-through invalidation** on fleet mutations
+- **Hydration** on gateway startup: bulk-populate from library.db
+- TTL: agent profiles 10min, summary 2min
+
+## Knowledge Graph
+
+DAG traversal over `knowledge_links` for relationship discovery:
+
+- **Entity types:** fact, knowledge, topic, episode, agent, preference
+- **Link types:** supports, contradicts, supersedes, references, derived_from, depends_on, extends, covers, related, authored_by
+- **BFS traversal:** configurable depth, result limit, direction filter, type filter
+- **Shortest path:** between any two entities
+- **Analytics:** most-connected entities, link count by type
+
+## Rate Limiter
+
+Token-bucket rate limiter for embedding API calls:
+
+- Burst capacity with steady refill (default: 5/s, burst 10)
+- Priority queue: high (user-facing recall) > normal > low (batch indexing)
+- Reserved tokens for high-priority requests
+- `createRateLimitedEmbedder()` wraps any embedding function
+
+## Cross-Agent Access Control
+
+Visibility-tiered access model for cross-agent knowledge queries:
+
+- **`fleet`** — visible to all agents (default tier)
+- **`org`** — visible to agents in the same organizational unit
+- **`council`** — visible to council-tier agents and the org lead
+- **`private`** — visible only to the owning agent
+
+### Org Registry
+
+`visibilityFilter()` resolves access levels using an `OrgRegistry` — a mapping of agents to tiers, orgs, and capabilities. Currently loaded from a hardcoded `defaultOrgRegistry()` in `cross-agent.ts`.
+
+**Known limitation:** This duplicates fleet structure that lives authoritatively in `fleet_agents` + `fleet_orgs` in library.db. Near-term roadmap item: replace with live-loaded registry from library.db, with the hardcoded version as cold-start fallback only.
+
+### Unknown Agent Fallback (Restrictive Default)
+
+When a target agent is not found in the registry, `visibilityFilter()` applies a **restrictive default**: fleet-only visibility with a logged warning. This is a deliberate safety-side behavior — unknown agents see only fleet-visible data rather than failing the query entirely. The warning surfaces registry gaps for operators to fix.
+
+This means:
+- Queries succeed but return a narrowed result set
+- New agents provisioned in the DB but not yet in the registry will have reduced cross-agent visibility until registered
+- The warning message names the missing agent and suggests adding it to the registry
+
+## Context Engine Plugin
+
+`plugin/src/index.ts` — OpenClaw context engine plugin (replaces basic hook integration):
+
+```
+gateway:startup     → Init HyperMem, auto-rotate DBs, hydrate fleet cache
+agent:bootstrap     → Warm session (history, facts, profile → Redis)
+context:assemble    → Full four-layer prompt assembly within token budget
+agent:afterTurn     → Ingest new messages to SQLite + Redis, trigger background indexer
+```
+
+Registers with `ownsCompaction: true` — runtime skips legacy compaction entirely.
+Deployed as managed hook at `~/.openclaw/hooks/hypermem-core/handler.js`.
+
+### Plugin Data Flow
+
+```
+                    ┌──────────────────────────────────────────────────┐
+                    │             REDIS (L1 Hot Layer)                  │
+                    │                                                  │
+                    │  hm:{a}:{s}:history  ── Session archive (250 cap │
+                    │    (append-only)        at bootstrap, 1000 soft  │
+                    │                         cap ongoing)             │
+                    │                                                  │
+                    │  hm:{a}:{s}:window   ── Submission buffer        │
+                    │    (compositor output)   (120s TTL)              │
+                    │                                                  │
+                    │  hm:{a}:{s}:cursor   ── Last-sent pointer        │
+                    │    (compositor metadata)  (24h TTL)              │
+                    │                                                  │
+                    │  hm:{a}:{s}:system   ── System prompt slot       │
+                    │  hm:{a}:{s}:identity ── Identity slot            │
+                    │  hm:{a}:{s}:facts    ── Cached facts slot        │
+                    │  hm:{a}:{s}:context  ── Cross-session slot       │
+                    └──────────────────────────────────────────────────┘
+
+Data Flow (current — P0 stabilized, window/cursor active):
+
+  bootstrap()                     assemble()                   afterTurn()
+  ───────────                     ──────────                   ───────────
+  ▸ sessionExists() → skip if hot  compose()                    slice(prePromptCount)
+  ▸ SQLite ─→ warmSession()        ─→ getHistory(limit) ✅      ─→ record*Message()
+           ─→ pushHistory(250)     ─→ dedup by id               ─→ pushHistory(1, dedup)
+           ─→ Redis :history       ─→ budget assembly            ─→ Redis :history
+                                   ─→ write :window (120s)      ─→ invalidateWindow()
+                                   ─→ write :cursor (24h)       ─→ background indexer
+                                   ─→ → runtime → provider
+
+### Key Invariants
+
+1. Redis `history` is the warm archive. Append-only. Nothing reads it for direct submission.
+2. Redis `window` is the compositor's output cache. Written ONLY by `compose()`. Read ONLY by `assemble()`. Invalidated by `afterTurn`.
+3. Redis `cursor` tracks the newest message in the last window. Used by background indexer for high-signal mining.
+4. `warmSession()` seeds `history` only (capped at 250). Never writes `window`.
+5. `pushHistory()` tail-checks before append (no duplicate IDs in Redis list).
+6. `compose()` deduplicates history by `id` before budget assembly.
+7. `getHistory()` honors its `limit` parameter on BOTH Redis and SQLite paths.
+
+Design spec: `specs/HYPERMEM_QUEUE_SPLIT.md`
+Incident history: `specs/HYPERMEM_INCIDENT_HISTORY.md`
+
+### Open Items (Tracked)
+
+| Item | WQ | Status | Notes |
+|---|---|---|---|
+| Cross-session context boundary markers | WQ-20260402-001 | 🟡 OPEN | `buildCrossSessionContext()` renders flat previews, no per-message boundaries or sender identity. Incident 6. |
+| Cursor durability (SQLite dual-write) | — | 🟡 DEFERRED | Cursor TTL = 24h. Dual-write to SQLite required before background indexer reads cursor. Gate 2. |
+| Plugin type unification | — | 🟡 DEFERRED | Plugin uses dynamic imports; can't use TS types from core. Shims are intentional. Structural change needed. |
+| ACA Step 4 — retrieval stubs replace static files | — | 🔲 PENDING | `systemPromptAddition` carries governance doc chunks instead of embedding full workspace files. Blocked on Step 3 ✅ |
+| ACA Step 5 — governance context assembly | — | 🔲 PENDING | Full on-demand assembly replaces static prompt injection. Requires Step 4. |
+
+### Runtime Contract
+
+**Exclusive dispatch:** The OpenClaw runtime calls either `afterTurn()` OR `ingest()`/`ingestBatch()`, never both. Since HyperMem implements `afterTurn`, it must handle message ingestion there. `ingest()` exists for API compatibility but is never called by the runtime in practice.
+
+**Provider translation:** The plugin sets `skipProviderTranslation: true` on compose requests. The compositor returns NeutralMessages; the plugin converts to AgentMessages. The runtime handles provider-specific translation. Two-stage translation (compositor → provider format → plugin → agent format) was the root cause of Incident 1 (silent tool call drops).
+
+## Module Map (29 files, ~12,300 lines)
+
+| Module | Lines | Layer | Purpose |
+|---|---|---|---|
+| `index.ts` | ~1,340 | All | Facade — all public API |
+| `compositor.ts` | ~1,140 | L1-L4 | Prompt assembly + token budgeting + safety valve + window/cursor write |
+| `library-schema.ts` | ~780 | L4 | Library schema v5 + migrations |
+| `background-indexer.ts` | ~680 | L2-L4 | LLM-powered extraction framework |
+| `vector-store.ts` | ~600 | L3 | Semantic search + embedding |
+| `hybrid-retrieval.ts` | ~450 | L3-L4 | FTS5 + KNN with Reciprocal Rank Fusion |
+| `fleet-store.ts` | ~440 | L4 | Fleet registry + capabilities |
+| `db.ts` | ~440 | - | Database manager + rotation |
+| `knowledge-graph.ts` | ~420 | L4 | DAG traversal + shortest path |
+| `redis.ts` | ~530 | L1 | Redis operations, window cache, cursor, fleet cache |
+| `doc-chunker.ts` | ~400 | - | Section-aware markdown/file parser |
+| `work-store.ts` | ~400 | L4 | Work queue + FTS5 |
+| `provider-translator.ts` | ~390 | - | Neutral ↔ provider format conversion |
+| `doc-chunk-store.ts` | ~375 | L4 | Chunk storage + deduplication |
+| `message-store.ts` | ~370 | L2 | Conversation recording + querying |
+| `types.ts` | ~370 | - | Shared type definitions + SessionCursor |
+| `cross-agent.ts` | ~330 | L2-L4 | Cross-agent knowledge queries + visibility |
+| `desired-state-store.ts` | ~310 | L4 | Config drift detection |
+| `knowledge-store.ts` | ~300 | L4 | Domain/key/value structured data |
+| `secret-scanner.ts` | ~285 | - | Credential/secret detection |
+| `system-store.ts` | ~250 | L4 | Service state tracking |
+| `seed.ts` | ~250 | L4 | Workspace seeder + collection inference |
+| `fact-store.ts` | ~230 | L4 | Facts with confidence + expiry |
+| `rate-limiter.ts` | ~230 | L3 | Token-bucket for embedding API |
+| `schema.ts` | ~200 | L2 | Messages schema + migrations |
+| `episode-store.ts` | ~180 | L4 | Significant event tracking |
+| `preference-store.ts` | ~170 | L4 | Operator behavioral patterns |
+| `topic-store.ts` | ~160 | L4 | Cross-session thread tracking |
+| `plugin/src/index.ts` | ~590 | - | OpenClaw context engine plugin + window invalidation |
+
+## Test Coverage (105 assertions, 11 suites)
+
+_Test count reflects assertions, not individual test blocks. Suites contain inline assertions._
+
+| Suite | Key coverage |
+|---|---|
+| smoke | End-to-end create/write/read/close, provider translation |
+| redis-integration | Redis ops, slots, history limits, window cache, cursor, warming, dedup |
+| cross-agent | Cross-agent queries, fleet search, visibility tiers |
+| vector-search | Embedding, KNN, batch indexing |
+| library | All L4 collections (facts → desired state) |
+| compositor | Four-layer composition, budgets, providers, safety valve, Gate 1 |
+| fleet-cache | Redis fleet cache, hydration, cache-aside |
+| rotation | DB rotation, auto-rotate, collision handling |
+| knowledge-graph | DAG traversal, shortest path, analytics |
+| rate-limiter | Token bucket, priority, timeout, embedder |
+| doc-chunker | Markdown/file chunking, section-aware parsing, seeder |
+
+## Dependencies
+
+- `node:sqlite` (Node 22+ built-in) — zero-dependency SQLite
+- `ioredis` — Redis client
+- `sqlite-vec` — optional, vector search extension
+- Ollama (localhost:11434) — optional, embedding generation

package/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding any notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 PsiClawOps
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.