celestial-astrology 0.1.0__tar.gz

celestial_astrology-0.1.0/.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

celestial_astrology-0.1.0/.github/workflows/checks.yml

@@ -0,0 +1,55 @@
+name: Checks
+
+on:
+  push:
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  quality:
+    name: quality (${{ matrix.os }}, ${{ matrix.python }})
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 15
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            python: "3.11"
+            uv-artifact: uv-x86_64-unknown-linux-gnu.tar.gz
+            uv-checksum: 68a509da24b06b4223a1c0175fb5eb5bc79342b76cbeff0cfe51ac3f5b17b6b2
+          - os: ubuntu-latest
+            python: "3.14"
+            uv-artifact: uv-x86_64-unknown-linux-gnu.tar.gz
+            uv-checksum: 68a509da24b06b4223a1c0175fb5eb5bc79342b76cbeff0cfe51ac3f5b17b6b2
+          - os: macos-latest
+            python: "3.14"
+            uv-artifact: uv-aarch64-apple-darwin.tar.gz
+            uv-checksum: 5bb0e5fe008a773c3dbcb97ff79cd89e1241464fe9d2f986d52ad8f1b037bd62
+          - os: windows-latest
+            python: "3.14"
+            uv-artifact: uv-x86_64-pc-windows-msvc.zip
+            uv-checksum: 4c4d49d8738847d9b71ba319e49a5688c93eac0fe6204b1df24e98528dddf39a
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: ${{ matrix.python }}
+      - uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7
+        name: Verify and install ${{ matrix.uv-artifact }}
+        env:
+          # setup-uv skips archive verification on a tool-cache hit.
+          # setup-uv 命中工具缓存时会跳过归档校验。
+          RUNNER_TOOL_CACHE: ${{ runner.temp }}/astrology-uv-${{ github.run_id }}-${{ github.run_attempt }}
+        with:
+          version: "0.12.5"
+          # Digests cover the named archives from astral-sh/uv release 0.12.5.
+          # 摘要对应 astral-sh/uv 0.12.5 发布中上面具名的归档。
+          checksum: ${{ matrix.uv-checksum }}
+          enable-cache: false
+      - run: uv sync --locked --python ${{ matrix.python }}
+      - run: uv run --locked python tools/check.py

celestial_astrology-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,176 @@
+name: Release
+
+on:
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+    inputs:
+      version:
+        description: Release version already committed on main
+        required: true
+        type: string
+      sha:
+        description: Full lowercase SHA of current main
+        required: true
+        type: string
+
+permissions: {}
+
+concurrency:
+  group: astrology-release-${{ github.ref }}
+  cancel-in-progress: false
+
+env:
+  RELEASE_VERSION: ${{ inputs.version }}
+  RELEASE_SHA: ${{ inputs.sha || github.sha }}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    permissions:
+      contents: read
+    outputs:
+      version: ${{ steps.release.outputs.version }}
+      source_sha: ${{ steps.release.outputs.source_sha }}
+      sdist_name: ${{ steps.release.outputs.sdist_name }}
+      wheel_name: ${{ steps.release.outputs.wheel_name }}
+      sdist_sha256: ${{ steps.release.outputs.sdist_sha256 }}
+      wheel_sha256: ${{ steps.release.outputs.wheel_sha256 }}
+      artifact_id: ${{ steps.upload.outputs.artifact-id }}
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          ref: ${{ github.sha }}
+          persist-credentials: false
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.14"
+      - uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7.6.0
+        env:
+          RUNNER_TOOL_CACHE: ${{ runner.temp }}/astrology-release-build-${{ github.run_id }}-${{ github.run_attempt }}
+        with:
+          version: "0.12.5"
+          checksum: "68a509da24b06b4223a1c0175fb5eb5bc79342b76cbeff0cfe51ac3f5b17b6b2"
+          enable-cache: false
+      - run: uv sync --locked --python 3.14
+      - run: uv run --locked python tools/release.py validate
+      - run: uv run --locked python tools/check.py --artifacts-dir dist/packages
+        env:
+          SCRATCH: ${{ runner.temp }}
+      - id: release
+        run: uv run --locked python tools/release.py prepare
+      - id: upload
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: celestial-astrology-${{ steps.release.outputs.version }}-${{ github.run_id }}
+          path: dist/
+          if-no-files-found: error
+          overwrite: false
+          retention-days: 14
+
+  consume:
+    needs: build
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 15
+    permissions:
+      contents: read
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            python: "3.11"
+            uv-checksum: "68a509da24b06b4223a1c0175fb5eb5bc79342b76cbeff0cfe51ac3f5b17b6b2"
+          - os: ubuntu-latest
+            python: "3.12"
+            uv-checksum: "68a509da24b06b4223a1c0175fb5eb5bc79342b76cbeff0cfe51ac3f5b17b6b2"
+          - os: ubuntu-latest
+            python: "3.13"
+            uv-checksum: "68a509da24b06b4223a1c0175fb5eb5bc79342b76cbeff0cfe51ac3f5b17b6b2"
+          - os: ubuntu-latest
+            python: "3.14"
+            uv-checksum: "68a509da24b06b4223a1c0175fb5eb5bc79342b76cbeff0cfe51ac3f5b17b6b2"
+          - os: ubuntu-24.04-arm
+            python: "3.14"
+            uv-checksum: "9bf43b4d1a07665bf64d4c4e710930b382321a785e0eb10aac07f46471f86a31"
+          - os: macos-latest
+            python: "3.14"
+            uv-checksum: "5bb0e5fe008a773c3dbcb97ff79cd89e1241464fe9d2f986d52ad8f1b037bd62"
+          - os: windows-latest
+            python: "3.14"
+            uv-checksum: "4c4d49d8738847d9b71ba319e49a5688c93eac0fe6204b1df24e98528dddf39a"
+    env:
+      RELEASE_VERSION: ${{ needs.build.outputs.version }}
+      RELEASE_SHA: ${{ needs.build.outputs.source_sha }}
+      SDIST_SHA256: ${{ needs.build.outputs.sdist_sha256 }}
+      WHEEL_SHA256: ${{ needs.build.outputs.wheel_sha256 }}
+      PYTHON_VERSION: ${{ matrix.python }}
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          ref: ${{ needs.build.outputs.source_sha }}
+          persist-credentials: false
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: ${{ matrix.python }}
+      - uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7.6.0
+        env:
+          RUNNER_TOOL_CACHE: ${{ runner.temp }}/astrology-release-consume-${{ github.run_id }}-${{ github.run_attempt }}
+        with:
+          version: "0.12.5"
+          checksum: ${{ matrix.uv-checksum }}
+          enable-cache: false
+      - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        with:
+          artifact-ids: ${{ needs.build.outputs.artifact_id }}
+          path: dist
+          digest-mismatch: error
+      - run: uv sync --locked --python "$PYTHON_VERSION"
+        shell: bash
+      - run: uv run --locked python tools/release.py consume
+        env:
+          SCRATCH: ${{ runner.temp }}
+
+  publish-pypi:
+    if: github.event_name == 'workflow_dispatch' && github.ref == 'refs/heads/main'
+    needs: [build, consume]
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        with:
+          artifact-ids: ${{ needs.build.outputs.artifact_id }}
+          path: dist
+          digest-mismatch: error
+      - name: Verify exact publication files
+        shell: bash
+        env:
+          DIST_DIR: dist
+          RELEASE_VERSION: ${{ needs.build.outputs.version }}
+          SDIST_NAME: ${{ needs.build.outputs.sdist_name }}
+          WHEEL_NAME: ${{ needs.build.outputs.wheel_name }}
+          SDIST_SHA256: ${{ needs.build.outputs.sdist_sha256 }}
+          WHEEL_SHA256: ${{ needs.build.outputs.wheel_sha256 }}
+        run: |
+          set -euo pipefail
+          [[ "$RELEASE_VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]] || exit 1
+          [[ "$SDIST_NAME" == "celestial_astrology-${RELEASE_VERSION}.tar.gz" ]] || exit 1
+          [[ "$WHEEL_NAME" == "celestial_astrology-${RELEASE_VERSION}-py3-none-any.whl" ]] || exit 1
+          [[ "$SDIST_SHA256" =~ ^[0-9a-f]{64}$ && "$WHEEL_SHA256" =~ ^[0-9a-f]{64}$ ]] || exit 1
+          [[ -d "$DIST_DIR" && ! -L "$DIST_DIR" ]] || exit 1
+          [[ -d "$DIST_DIR/packages" && ! -L "$DIST_DIR/packages" ]] || exit 1
+          [[ $(find "$DIST_DIR/packages" -mindepth 1 -maxdepth 1 | wc -l) -eq 2 ]] || exit 1
+          [[ -f "$DIST_DIR/packages/$SDIST_NAME" && ! -L "$DIST_DIR/packages/$SDIST_NAME" ]] || exit 1
+          [[ -f "$DIST_DIR/packages/$WHEEL_NAME" && ! -L "$DIST_DIR/packages/$WHEEL_NAME" ]] || exit 1
+          printf '%s  %s\n' "$SDIST_SHA256" "$DIST_DIR/packages/$SDIST_NAME" \
+            "$WHEEL_SHA256" "$DIST_DIR/packages/$WHEEL_NAME" | sha256sum -c -
+      - uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # v1.14.3
+        with:
+          repository-url: https://upload.pypi.org/legacy/
+          packages-dir: dist/packages
+          attestations: true
+          skip-existing: false

celestial_astrology-0.1.0/AGENTS.md

@@ -0,0 +1,87 @@
+# Agent instructions
+
+## Scope
+
+This is a Python Western astrology library in its initialization stage. Read
+`README.md`, `docs/en/architecture.md`, `docs/en/knowledge.md`, and the relevant
+issue before implementing a feature. GitHub issues hold the implementation scope
+and acceptance criteria.
+
+Use celestial-calendar for time scales, ephemerides, and house geometry. This
+repository owns birth-input interpretation, astrological classifications, rule
+variants, chart composition, and serialization.
+
+## Domain contracts
+
+- Preserve original birth records separately from resolved calculation instants.
+  Missing time and location remain explicit; do not manufacture noon or a location.
+- Distinguish physical objects, mathematical points, and constructed chart points.
+  Name node and apogee definitions rather than using an ambiguous accuracy switch.
+- Keep astronomical values separate from signs, house placement, and aspects.
+- Record resolved models, versions, and configuration. A failed requested house
+  system must not silently become another system.
+- Cite the sources and applicability of astrological rules. Represent conflicting
+  traditions as named variants; confirm unresolved definitions before encoding them.
+- Begin with a concrete celestial adapter. Add shared abstractions only when
+  actual implementations or callers need them.
+
+## Python
+
+Use complete type annotations, snake_case modules and functions, PascalCase types,
+and two-space indentation. Inputs, configuration, rules, and results are immutable
+by default; frozen dataclasses must also isolate mutable members and caller-owned
+data. Prefer ordinary pure functions and declarative tables for data-shaped rules.
+Keep I/O, native initialization, caches, and other effects explicit at their
+owning boundary. Avoid global mutable configuration and silent substitutions.
+
+Definitions belong to their domain; entry points compose them. Add shared
+abstractions only for concrete callers. Names and types carry meaning; comments
+explain reasons or constraints. Public input checks must work under `python -O`.
+
+Python 3.11–3.14 is supported. Use `uv sync --locked`, then
+`uv run --locked python tools/check.py` for the same checks as CI. Configuration
+and pinned tool versions live in `pyproject.toml` and `uv.lock`. Change both when
+updating dependencies and verify the minimum and maximum Python versions.
+The development package provides a tropical natal chart API and
+chart-independent knowledge queries. Importing it initializes no native
+astronomy.
+
+## Knowledge and documentation
+
+Use English for PR and issue titles/bodies, comments, and review replies. English
+is the primary documentation language; maintain matching Chinese pages.
+
+The repository is also a knowledge base. Concepts, source records, rule variants,
+and statements need stable, language-independent identities. Knowledge queries
+must work without a chart or native astronomy initialization. Keep source status,
+prerequisite status, default-output eligibility, and chart matching distinct.
+
+Keep executable rules in their owning domain; reference them from knowledge and
+generate reference tables from that source. Original quotations, translations,
+and project-authored explanations remain distinguishable. Preserve uncertainty
+and incomplete prerequisites instead of turning them into applicable conclusions.
+
+Provide Chinese and English README, guides, and public reference documentation.
+Update matching pages together; public docstring summaries and contracts are
+bilingual. Identifiers, signatures, units, defaults, and machine-readable rule
+definitions have one source. Check translation coverage and review semantic
+equivalence; original quotations are not rewritten to match prose style.
+
+This file is the single agent-instruction source; reader documentation follows the
+bilingual paths above. Create source modules only when they contain functionality.
+
+## Verification and delivery
+
+Test domain boundaries and independently sourced reference cases with explicit
+configuration and tolerances. A serialization round trip checks preservation;
+recomputation and external references check different properties.
+
+Run the complete check command before submitting. Demonstrate that new checks
+reject representative defects. Review source fidelity, aliasing, unnecessary
+abstractions, translation meaning, and gaps in the tested domain separately from
+automated results. Record commands actually executed and unresolved limits in
+the PR. Contribution guides in `docs/en/` and `docs/zh-CN/` explain these checks.
+
+Use synthetic or appropriately anonymized examples. Public files and discussions
+must contain only project-relevant information. Commit through the maintainer's
+approved signing path. Merges and releases require explicit authorization.

celestial_astrology-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 0xf3cd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

celestial_astrology-0.1.0/MANIFEST.in

@@ -0,0 +1,7 @@
+include .gitattributes AGENTS.md README.zh-CN.md uv.lock
+include .github/workflows/checks.yml .github/workflows/release.yml
+recursive-include docs *.md *.py *.html
+recursive-include tests *.py
+recursive-include tests/reference *.json *.txt
+recursive-include tools *.py
+prune .review

celestial_astrology-0.1.0/PKG-INFO

@@ -0,0 +1,220 @@
+Metadata-Version: 2.4
+Name: celestial-astrology
+Version: 0.1.0
+Summary: Reproducible Western astrology charts and sourced knowledge
+License-Expression: MIT
+Project-URL: Documentation, https://0xf3cd.github.io/astrology/
+Project-URL: Repository, https://github.com/0xf3cd/astrology
+Project-URL: Issues, https://github.com/0xf3cd/astrology/issues
+Requires-Python: <3.15,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: celestial-calendar==0.8.0
+Requires-Dist: tzdata==2026.5
+Dynamic: license-file
+
+# celestial-astrology
+
+[English](https://0xf3cd.github.io/astrology/README.html) | [简体中文](https://0xf3cd.github.io/astrology/README.zh-CN.html)
+
+A Python library for reproducible Western astrology charts and knowledge queries. It uses
+[celestial-calendar](https://github.com/0xf3cd/celestial-calendar) for astronomy and
+keeps astrological rules, their sources, and their variants in this repository.
+
+The package provides immutable [birth records and modern time
+resolution](https://0xf3cd.github.io/astrology/docs/en/birth.html), [requested chart configuration](https://0xf3cd.github.io/astrology/docs/en/configuration.html),
+[tropical natal chart calculation](https://0xf3cd.github.io/astrology/docs/en/chart.html), [chart records and text output](https://0xf3cd.github.io/astrology/docs/en/records.html), an independent
+[knowledge catalog](https://0xf3cd.github.io/astrology/docs/en/knowledge.html), quality checks, and bilingual
+[API documentation](https://0xf3cd.github.io/astrology/docs/en/reference.html). The astronomy library is imported only
+when calculation or replay is requested, so importing the package or querying knowledge never
+initializes it.
+See [Contributing](https://0xf3cd.github.io/astrology/docs/en/contributing.html) to run the checks.
+
+Installation follows the astronomy dependency: celestial-calendar 0.8.0 publishes
+wheels for Linux x86_64 and aarch64, macOS 14+ arm64 and Windows amd64, and no source
+distribution. On any other platform this package cannot be installed, and
+knowledge browsing is not available either.
+
+## Install a release
+
+`celestial-astrology` is the distribution name; the Python import is `astrology`.
+Do not install the unrelated PyPI project named `astrology`.
+
+Use **Python 3.11–3.14** on one of the platforms listed above.
+
+Linux/macOS (replace `python3.14` with your supported Python version):
+
+```sh
+python3.14 -m venv .venv
+.venv/bin/python -m pip install "celestial-astrology==0.1.0"
+```
+
+Windows PowerShell:
+
+```powershell
+py -3.14 -m venv .venv
+.venv\Scripts\python.exe -m pip install "celestial-astrology==0.1.0"
+```
+
+Runtime dependencies remain exactly pinned to `celestial-calendar==0.8.0` and
+`tzdata==2026.5`. This can conflict with applications requiring another version.
+See the [release notes](https://0xf3cd.github.io/astrology/docs/en/releases.html).
+
+## Install from source
+
+For the exact source
+revision used by the documentation, use the snapshot command on the
+[documentation home](https://0xf3cd.github.io/astrology/). To install your downloaded
+or cloned source checkout instead, run these commands from its root. Installation
+needs network access for build dependencies and the pinned runtime packages.
+
+Linux/macOS (replace `python3.14` with your supported Python version):
+
+```sh
+python3.14 -m venv .venv
+.venv/bin/python -m pip install .
+```
+
+Windows PowerShell:
+
+```powershell
+py -3.14 -m venv .venv
+.venv\Scripts\python.exe -m pip install .
+```
+
+These commands install your source checkout. Development checks use `uv sync --locked` as
+described in the contribution guide.
+
+## First chart
+
+Save this Python script as `first_chart.py`; it is not an interactive transcript.
+Run `.venv/bin/python first_chart.py` on Linux/macOS, or
+`.venv\Scripts\python.exe first_chart.py` in PowerShell.
+The input has an explicit UTC offset and synthetic coordinates. No aspects are requested.
+
+```python
+from datetime import date, time, timedelta
+from astrology import (
+  BirthRecord,
+  Body,
+  ChartConfig,
+  FixedOffset,
+  HouseSystem,
+  Location,
+  TimePrecision,
+  natal_chart,
+  prepare_natal_input,
+)
+
+record = BirthRecord(
+  date(2000, 1, 1),
+  time(12, 0),
+  FixedOffset(timedelta(0)),
+  Location(0, 0),
+  TimePrecision.MINUTE,
+  {"example": "synthetic"},
+)
+config = ChartConfig(HouseSystem.WHOLE_SIGN, (Body.SUN, Body.MOON), ())
+chart = natal_chart(prepare_natal_input(record), config)
+print(chart.provenance.astrology_version)
+print(chart.resolved.utc.isoformat())
+for placement in chart.placements:
+  print(f"{placement.identity.value}: {placement.sign.value}")
+```
+
+Output:
+
+```text
+0.1.0
+2000-01-01T12:00:00+00:00
+sun: capricorn
+moon: scorpio
+```
+
+Unknown time or missing location is rejected, not replaced with noon or an inferred
+place. Undefined requested house geometry raises `ChartDomainError` without a
+fallback. See the [chart guide](https://0xf3cd.github.io/astrology/docs/en/chart.html)
+for admitted domains, and the [record guide](https://0xf3cd.github.io/astrology/docs/en/records.html)
+for save/restore/recompute and bilingual text tables.
+
+## First knowledge lookup
+
+Save this separate script as `first_knowledge.py` and run it with the same
+virtual-environment Python. It reads the packaged catalog without a chart or
+native astronomy initialization; installation still has the platform limits above.
+
+```python
+from astrology import load_catalog
+
+catalog = load_catalog()
+print(catalog.concept("body.sun").name.text("en"))
+print(catalog.lookup("Sol")[0].identifier)
+```
+
+Output:
+
+```text
+Sun
+body.sun
+```
+
+Browse the [complete catalog](https://0xf3cd.github.io/astrology/docs/en/catalog.html)
+or [public API](https://0xf3cd.github.io/astrology/docs/en/reference.html).
+The shared documentation search may return either language; Chinese queries use
+character pairs, not semantic matching or dictionary segmentation.
+
+## First release
+
+The first target is a modern tropical, geocentric natal chart from a known birth
+time and location:
+
+- Preserve the birth record, resolve its timezone explicitly, and retain the
+  resulting time scales and calculation provenance.
+- Compute the Sun, Moon, eight planets, and explicitly selected lunar nodes.
+- Support Whole Sign, Equal, and Placidus houses, with explicit failures where a
+  requested geometry is undefined.
+- Derive signs, two-dimensional house placement (longitude only, without object latitude), and the five major
+  aspects with configurable orbs and local applying/separating status.
+- Return immutable structured results, a text table, and a versioned serialization
+  that retains inputs, configuration, astronomical values, and model identities.
+
+Positions, axes, cusps, signs, house placement, aspects, text output and versioned
+records are implemented. Restoration preserves stored results without native
+astronomy; replay explicitly checks available versions and models.
+
+See the [v0.1.0 milestone](https://github.com/0xf3cd/astrology/milestone/1) for
+delivery tasks and acceptance criteria.
+
+## Design boundaries
+
+- [Repository structure and calculation boundaries](https://0xf3cd.github.io/astrology/docs/en/architecture.html)
+- [Knowledge organization and bilingual documentation](https://0xf3cd.github.io/astrology/docs/en/knowledge.html)
+- [Development and review conventions](https://0xf3cd.github.io/astrology/docs/en/contributing.html)
+
+Knowledge browsing is a first-release goal in its own right: readers should be
+able to find a concept, its rule variants, and its sources without creating a
+chart or loading the native astronomy library. Source status, applicability, and
+display eligibility are recorded separately.
+
+Project guides and public reference documentation are provided in Chinese and
+English. Both languages refer to the same identifiers, executable rules, and
+source records. Quotations retain their original language; translations are
+identified as translations.
+
+## Later work
+
+- [Techniques and presentation](https://github.com/0xf3cd/astrology/milestone/2):
+  transits and returns, relationship charts, tradition-specific rules, additional
+  objects, and chart views.
+- [Advanced and historical research](https://github.com/0xf3cd/astrology/milestone/3):
+  directions, progressions, uncertain birth times, historical inputs, spatial
+  house placement, and sourced interpretation.
+
+These milestones track directions without assigning release dates. Each technique
+needs a named definition, sources, and reference cases before implementation.
+
+## License
+
+[MIT](https://github.com/0xf3cd/astrology/blob/main/LICENSE) covers project code, translations and authored explanations.
+Historical excerpts retain the reproduction status recorded in their
+[source records](https://0xf3cd.github.io/astrology/docs/en/knowledge.html#knowledge-source-definitions-en).