dreamcycle 0.2.0__tar.gz

dreamcycle-0.2.0/.gitignore

@@ -0,0 +1,13 @@
+.venv/
+__pycache__/
+*.py[cod]
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+build/
+dist/
+dreamcycle-data/
+*.log
+.env

dreamcycle-0.2.0/ARCHITECTURE.md

@@ -0,0 +1,397 @@
+# DreamCycle Architecture
+
+DreamCycle is a **memory-native learning loop for local AI**. It lives beside a
+vendor's application and model server, adding durable memory and guarded model
+improvement without taking ownership of the entire platform.
+
+Created by **Kenny Jin**.
+
+## The Short Version
+
+An application sends DreamCycle useful interactions. DreamCycle stores them as
+scoped L2 memories, recalls relevant experience during later requests, and lets
+people explicitly approve the best interactions for training. A dream cycle
+builds a dataset, trains a candidate adapter, evaluates it, and changes the
+active adapter only when the candidate passes the configured gates.
+
+```text
+Memory makes the model useful across sessions.
+Review makes the data intentional.
+Evaluation makes improvement measurable.
+Rollback makes promotion reversible.
+```
+
+DreamCycle improves behavior at three layers:
+
+1. **Prompt lift:** retrieved memory changes the context sent to the next model
+   request.
+2. **Local weight lift:** reviewed examples train and evaluate local adapters.
+3. **Cloud dataset lift:** approved examples can be exported for provider-owned
+   cloud fine-tuning workflows.
+
+The first layer can help any OpenAI-compatible endpoint immediately. The second
+layer is directly implemented for local LoRA adapters. The third layer is an
+integration boundary: DreamCycle can produce the reviewed dataset and provenance,
+but the cloud provider still owns upload, hosted training, deployment, billing,
+and model-version policy.
+
+## System Map
+
+```mermaid
+flowchart TB
+    subgraph Vendor["Vendor platform"]
+        UI["Product UI, agent, or automation"]
+        Runtime["Existing local-model runtime"]
+    end
+
+    subgraph DreamCycle["DreamCycle add-on"]
+        Auth["API-key identity binding"]
+        API["Vendor memory API"]
+        Proxy["Chat Completions proxy"]
+        Memory["Scoped memory service"]
+        Jobs["Cycle job manager"]
+        Dataset["Reviewed dataset forge"]
+        Trainer["Local adapter trainer"]
+        Evaluator["Candidate arena"]
+        Adapters["Adapter vault and rollback"]
+    end
+
+    PG[("PostgreSQL + pgvector")]
+    Embed["Local embedding model"]
+    Base["Local base model"]
+
+    UI -->|"SDK calls"| Auth
+    UI -->|"OpenAI-compatible request"| Auth
+    Auth --> API
+    Auth --> Proxy
+    API --> Memory
+    Proxy --> Memory
+    Memory <--> PG
+    Memory --> Embed
+    Proxy --> Runtime
+    API --> Jobs
+    Jobs --> Dataset
+    Dataset --> PG
+    Dataset --> Trainer
+    Trainer --> Base
+    Trainer --> Evaluator
+    Evaluator -->|"pass"| Adapters
+    Evaluator -->|"reject"| Jobs
+    Adapters -.->|"vendor loads active adapter"| Runtime
+```
+
+## Three Integration Shapes
+
+### 1. Drop-In Proxy
+
+Use this when the product already supports an OpenAI-compatible Chat
+Completions base URL.
+
+```mermaid
+sequenceDiagram
+    participant App as Vendor application
+    participant DC as DreamCycle proxy
+    participant DB as PostgreSQL memory
+    participant LM as Local model server
+
+    App->>DC: POST /v1/chat/completions
+    DC->>DC: Bind API key to namespace and user
+    opt Retrieve mode
+        DC->>DB: Vector recall using latest user text
+        DB-->>DC: Scoped L2 memories
+        DC->>DC: Add bounded untrusted memory context
+    end
+    DC->>LM: Forward request with separate upstream key
+    LM-->>DC: Completion or SSE stream
+    DC-->>App: Preserve model response
+    DC->>DB: Atomically store completed user and assistant turn
+```
+
+The inbound DreamCycle key never goes to the model server. Retrieval or
+post-response recording failures do not erase an otherwise successful model
+response. A stopped proxy is still an availability failure, because an extra
+network hop cannot fail open when the hop itself is gone.
+
+### 2. Vendor SDK
+
+Use this when the Python platform wants explicit control.
+
+```text
+DreamCycleClient
+  health()
+  record()
+  record_turn()
+  recall()
+  review()
+  delete()
+  start_cycle()
+  cycle_status()
+  active_adapter()
+  rollback_adapter()
+```
+
+The SDK talks only to the sidecar contract. It does not need to import the
+vendor's inference engine or know how its UI works.
+
+### 3. Embedded Engine
+
+Use this when the host is already Python and does not want another process.
+
+```mermaid
+flowchart LR
+    Host["Python host process"] --> Memory["PostgresMemory"]
+    Host --> Cycle["DreamCycle"]
+    Memory <--> PG[("PostgreSQL + pgvector")]
+    Cycle --> Trainer["Vendor or built-in trainer"]
+    Cycle --> Evaluator["Vendor or built-in evaluator"]
+    Cycle --> Adapter["AdapterManager"]
+```
+
+HTTP, embedding, and training dependencies remain optional. Importing the core
+package does not load those stacks.
+
+## Model Improvement Layers
+
+```mermaid
+flowchart TB
+    Input["Completed interaction"] --> Memory["Scoped L2/L3 memory"]
+
+    Memory --> Recall["Prompt lift"]
+    Recall --> Compatible["Local or OpenAI-compatible endpoint"]
+
+    Memory --> Review["Human review gate"]
+    Review --> Dataset["Approved train/eval dataset"]
+    Dataset --> LocalTrain["Local LoRA adapter training"]
+    LocalTrain --> Eval["Evaluation gate"]
+    Eval -->|"pass"| Promote["Promote local adapter"]
+    Eval -->|"fail"| Reject["Keep current adapter"]
+
+    Dataset -.-> CloudHandoff["Provider dataset handoff"]
+    CloudHandoff -.-> Provider["Official cloud fine-tuning workflow"]
+```
+
+DreamCycle directly owns memory, review state, dataset assembly, local adapter
+training, evaluation, and local promotion. It does not directly mutate hosted
+model weights. For cloud models, DreamCycle's role is to make the prompt better
+through recall and to make the fine-tuning input cleaner when a vendor chooses
+to use a provider's official training pipeline.
+
+## Memory Model
+
+DreamCycle treats memory as two related layers rather than one giant prompt
+history.
+
+```mermaid
+flowchart LR
+    Turn["Completed interaction"] --> L2["L2 episodic memory"]
+    L2 --> Recall["Vector recall"]
+    L2 --> Review["Human review decision"]
+    L2 -->|"provenance"| L3["L3 durable knowledge"]
+    Review -->|"approved"| Dataset["Training candidate"]
+    Review -->|"rejected"| Stop["Excluded from training"]
+```
+
+### L2: Episodic Memory
+
+L2 stores what happened:
+
+- user and assistant content;
+- role and source;
+- conversation and trace identity;
+- importance and success state;
+- review and training approval state;
+- classification and metadata;
+- local embedding and distance score.
+
+The user and assistant sides of a completed turn are written in one PostgreSQL
+transaction. Captured assistant turns begin with `reviewed=false` and
+`approved_for_training=false`.
+
+### L3: Durable Knowledge
+
+L3 stores what the system has intentionally distilled:
+
+- vector-searchable knowledge nodes;
+- typed relationships between nodes;
+- confidence and metadata;
+- provenance links back to L2 memories.
+
+L3 promotion rejects source IDs outside the current namespace and user scope.
+This keeps a durable claim connected to the evidence that produced it.
+
+## Identity Is a Server Decision
+
+```mermaid
+flowchart LR
+    KeyA["API key A"] --> Alice["namespace: product / user: alice"]
+    KeyB["API key B"] --> Bob["namespace: product / user: bob"]
+    Alice --> RowsA["Alice memory rows"]
+    Bob --> RowsB["Bob memory rows"]
+```
+
+The API key map lives in sidecar configuration. Request bodies do not contain a
+trusted namespace or user override. Unknown body fields are rejected, and every
+PostgreSQL memory query includes both scope values.
+
+This is intentionally simpler than asking every vendor endpoint to reproduce a
+tenant policy system.
+
+## The Guarded Dream Cycle
+
+The cycle is a model-improvement state machine, not a promise that every fine
+tune deserves promotion.
+
+```mermaid
+stateDiagram-v2
+    [*] --> Queued
+    Queued --> DatasetBuild: worker starts
+    DatasetBuild --> Skipped: insufficient reviewed data
+    DatasetBuild --> Training: valid train and evaluation split
+    Training --> Failed: trainer error
+    Training --> Benchmark: candidate adapter produced
+    Benchmark --> Rejected: quality gate fails
+    Benchmark --> Shadow: shadow evaluation configured
+    Benchmark --> Promotion: benchmark passes
+    Shadow --> Rejected: shadow gate fails
+    Shadow --> Promotion: shadow gate passes
+    Promotion --> Completed: active pointer updated
+    Promotion --> Failed: atomic activation fails
+    Skipped --> [*]
+    Rejected --> [*]
+    Completed --> [*]
+    Failed --> [*]
+```
+
+### Dataset Forge
+
+Only successful assistant memories that are explicitly reviewed and approved
+can become candidates. Whole conversations stay on one side of the train and
+held-out evaluation split to reduce leakage.
+
+### Candidate Arena
+
+The built-in evaluator compares candidate and baseline perplexity. Products can
+replace it with an evaluator that measures coding accuracy, tool selection,
+classification quality, policy adherence, or another domain-specific target.
+
+### Adapter Vault
+
+Promotion copies a candidate into a versioned directory and atomically updates
+the active pointer. The previous pointer gives the operator one-step rollback.
+Candidate and active paths are constrained to configured roots.
+
+## Failure Semantics
+
+DreamCycle tries to make failure boring and visible.
+
+| Failure | Behavior |
+|---|---|
+| Bad or missing sidecar key | `401`; no memory operation |
+| Namespace/user override in body | Validation error |
+| Missing proxy configuration | `503`; no fake inference success |
+| Upstream connection unavailable | Bounded `502` |
+| Memory recall fails during proxying | Model request continues without recalled context |
+| Memory write fails after model success | Model response remains valid; warning/log is emitted |
+| Stream ends before `[DONE]` | Partial assistant output is not stored as complete |
+| Cycle already active for identity | `409`; no competing local cycle |
+| Training is not configured | `503`; no fake queued job |
+| Candidate fails evaluation | Rejected; active adapter is unchanged |
+| Promotion fails | Failed report; active pointer is not relabeled as success |
+
+## Process and Deployment Boundaries
+
+```mermaid
+flowchart TB
+    subgraph TrustedHost["Trusted local host or private network"]
+        App["Vendor application"]
+        DC["DreamCycle sidecar"]
+        LM["Local model server"]
+        DB[("PostgreSQL + pgvector")]
+        Models["Local embedding and base models"]
+        Data["Per-identity adapter data"]
+    end
+
+    App --> DC
+    DC --> LM
+    DC --> DB
+    DC --> Models
+    DC --> Data
+```
+
+The sidecar binds to loopback by default. DreamCycle does not provide TLS
+termination, rate limiting, dynamic key reload, or a hosted control plane in
+0.2.0. Operators exposing it beyond a trusted host must add those controls.
+
+Cycle jobs and same-identity locks are process-local. They are truthful for one
+sidecar process but are not a distributed scheduler and do not survive restart.
+
+## Package Boundaries
+
+```text
+dreamcycle/
+  adapters.py            atomic promotion and rollback
+  cycle.py               guarded orchestration state machine
+  dataset.py             reviewed dataset construction
+  evaluation.py          quality and shadow gates
+  memory/
+    postgres.py          direct L2 and L3 PostgreSQL owner
+    embeddings.py        local or application-owned embeddings
+    schema.py            pgvector schema and indexes
+  sdk/
+    client.py            synchronous vendor SDK
+    models.py            dependency-light SDK results
+  server/
+    auth.py              API-key identity binding
+    app.py               HTTP contract
+    jobs.py              asynchronous cycle state
+    proxy.py             Chat Completions forwarding and capture
+    runtime.py           environment composition
+    service.py           transport-independent operations
+  training/
+    transformers.py      optional Transformers and PEFT implementation
+```
+
+One module owns one cohesive responsibility. Core imports remain independent of
+FastAPI, HTTPX, Transformers, PEFT, and PyTorch until those features are
+explicitly requested.
+
+## What DreamCycle Does Not Own
+
+- The vendor's UI, agent framework, or product workflow.
+- The local model server and its availability.
+- Consent, retention, deletion, and permission to train.
+- Model licensing or rights to collected data.
+- Cloud fine-tuning uploads, hosted training jobs, deployment, billing, and
+  model-version policy.
+- Production TLS, external authentication, and network policy.
+- Loading the promoted adapter into every possible inference runtime.
+- Proof that a generic metric represents the vendor's real product quality.
+
+Those boundaries are deliberate. DreamCycle should be useful as an add-on,
+not become another platform a vendor has to rebuild around.
+
+## Design Principles
+
+1. **Local first:** model data and model paths stay local by default.
+2. **Scope every memory operation:** identity comes from trusted configuration.
+3. **Review before training:** observation is not consent to fine-tune.
+4. **Evaluate before promotion:** training success is not quality evidence.
+5. **Preserve rollback:** model changes should be reversible.
+6. **Keep failures truthful:** no queued, routed, or partial state becomes fake
+   success.
+7. **Stay vendor-neutral:** protocols and HTTP contracts beat framework lock-in.
+8. **Separate prompt lift from weight lift:** recalled context can improve
+   behavior immediately, while training and promotion remain explicit workflows.
+
+## Current Limits
+
+- Chat compatibility is limited to `POST /v1/chat/completions`.
+- The SDK is synchronous in 0.2.0.
+- Cycle state is in process and non-durable.
+- Local model servers may differ in undocumented compatibility behavior.
+- Cloud model fine-tuning is export/integration work, not an automatic hosted
+  provider call in the core package.
+- Real model quality depends on the data, base model, evaluator, and hardware.
+
+These limits are tracked openly because a credible learning system needs clear
+boundaries as much as it needs ambitious terminology.

dreamcycle-0.2.0/AUTHORS.md

@@ -0,0 +1,5 @@
+# Authors
+
+DreamCycle was created by [Kenny Jin](https://github.com/kenjix217).
+
+Contributors are credited through the Git history and release notes.

dreamcycle-0.2.0/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+All notable changes to DreamCycle are documented here.
+
+## 0.2.0 - 2026-07-16
+
+- Added the authenticated vendor SDK and standalone memory sidecar.
+- Added observe and retrieve modes for an OpenAI-compatible Chat Completions proxy.
+- Added asynchronous dream-cycle jobs and adapter status/rollback endpoints.
+- Relicensed the unreleased project from MIT to Apache-2.0 and added `NOTICE`.
+- Added a product-focused README and GitHub-rendered architecture guide.
+- Added a Docker Compose five-minute memory quickstart.
+- Added PyPI trusted publishing through GitHub Actions.
+- Standardized public attribution to Kenny Jin.
+
+## 0.1.0 - 2026-07-16
+
+- Extracted the Dream Cycle orchestration into an independent Python package.
+- Added direct PostgreSQL/pgvector L2 episodic memory.
+- Added L3 knowledge nodes, relationships, and L2 provenance.
+- Added deterministic reviewed-memory train/evaluation dataset generation.
+- Added guarded adapter evaluation, promotion, and rollback.
+- Added optional Transformers/PEFT LoRA training and perplexity evaluation.
+- Added typed events, reports, examples, tests, and initial project metadata.

dreamcycle-0.2.0/CONTRIBUTING.md

@@ -0,0 +1,34 @@
+# Contributing
+
+Contributions should keep DreamCycle independent, local-first, and truthful
+about model quality.
+
+## Development Setup
+
+```bash
+python3 -m venv .venv
+.venv/bin/python -m pip install -e '.[dev]'
+.venv/bin/python -m pytest
+.venv/bin/python -m ruff check .
+```
+
+The development extra includes the SDK and sidecar test stack. Install
+`.[training]` only when changing the Transformers/PEFT implementation. Use a
+small local Hugging Face model for manual checks; tests must not download models
+or require a GPU.
+
+## Change Requirements
+
+- Keep one module responsible for one coherent behavior.
+- Preserve namespace and user-scope filters in every database query.
+- Never accept namespace or user scope from an authenticated sidecar request.
+- Never forward the inbound DreamCycle API key to a model server.
+- Add tests for success, rejection, and real failure paths.
+- Do not add cloud egress, model uploads, or credential persistence by default.
+- Do not add AGPL dependencies.
+- Do not report training completion as model improvement without evaluator
+  evidence.
+- Update public docs and the changelog when behavior changes.
+
+PostgreSQL integration tests require `DREAMCYCLE_TEST_DSN`. They create and
+remove a unique test schema.

dreamcycle-0.2.0/LICENSE

@@ -0,0 +1,201 @@
+                                 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 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 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 those 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
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   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.

dreamcycle-0.2.0/NOTICE

@@ -0,0 +1,4 @@
+DreamCycle
+Copyright 2026 Kenny Jin
+
+This product includes software developed by Kenny Jin.