doc-atlas 0.6.1__tar.gz

doc_atlas-0.6.1/.github/copilot-instructions.md

@@ -0,0 +1,42 @@
+<!-- docmancer:start -->
+# docmancer
+
+Docmancer compresses documentation context so coding agents spend tokens on code, not on rereading raw docs. It ingests local files, fetches public docs, indexes everything locally with SQLite FTS5, and returns compact context packs with source attribution.
+
+Executable: `/Users/gaurangtorvekar/Documents/coding/personal/kytona_stuff/devrel/docmancer_stuff/docmancer/.venv/bin/docmancer --config /private/var/folders/fj/87wdckpn2j7fhjysk511vt3m0000gn/T/docmancer-live-cli.8UadQL/project/docmancer.yaml`
+
+**All commands below use `docmancer` as shorthand for the full executable path above.**
+
+Use docmancer when the user asks about library docs, API references, vendor docs, version-specific behavior, offline docs, or wants to add docs before answering a technical question.
+
+## Workflow
+
+1. Run `docmancer list` to see indexed docs.
+2. Run `docmancer query "question"` when relevant docs are present.
+3. If local docs are missing and the user approves the path, run `docmancer ingest <path>`.
+4. If URL docs are missing and the user approves the source, run `docmancer add <url>`.
+5. Use the returned sections as source-grounded context for the answer or code change.
+
+## Core Commands
+
+```bash
+docmancer setup
+docmancer ingest ./docs
+docmancer add https://docs.example.com
+docmancer update
+docmancer query "how to authenticate"
+docmancer query "how to authenticate" --limit 10
+docmancer query "how to authenticate" --expand
+docmancer query "how to authenticate" --expand page
+docmancer query "how to authenticate" --format json
+docmancer list
+docmancer inspect
+docmancer remove <source>
+docmancer doctor
+docmancer fetch <url> --output <dir>
+```
+
+`query` prints estimated raw docs tokens, context-pack tokens, percent saved, and agentic runway. Prefer the compact default. Use `--expand` for adjacent sections; use `--expand page` only when the surrounding page is necessary.
+
+When documentation context is relevant, do not rely only on model memory or latest-only hosted docs. Query docmancer first, then cite or summarize the relevant local sections in the response.
+<!-- docmancer:end -->

doc_atlas-0.6.1/.github/workflows/ci.yml

@@ -0,0 +1,31 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest tests/ -v

doc_atlas-0.6.1/.github/workflows/publish.yml

@@ -0,0 +1,97 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  push:
+    tags:
+      # Glob (not regex): three-part semver tags like v0.1.1
+      - "v*.*.*"
+      - "*.*.*"
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
+
+jobs:
+  smoke-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+
+      - name: Install package and build tools
+        run: pip install -e ".[dev]" build twine "hatchling<1.27"
+
+      - name: Verify tag matches package version
+        env:
+          RELEASE_TAG: ${{ github.event.release.tag_name || github.ref_name }}
+        run: |
+          TAG="${RELEASE_TAG#v}"
+          PKG="$(python -c "from docmancer._version import __version__; print(__version__)")"
+          if [[ "$TAG" != "$PKG" ]]; then
+            echo "::error::Git tag $RELEASE_TAG does not match docmancer._version ($PKG). Bump docmancer/_version.py before tagging."
+            exit 1
+          fi
+
+      - name: Run tests
+        run: pytest tests/ -v
+
+      - name: Run smoke CLI checks
+        run: |
+          doc-atlas --help
+          TMP_DIR="$(mktemp -d)"
+          doc-atlas init --dir "$TMP_DIR"
+          test -f "$TMP_DIR/docmancer.yaml"
+          doc-atlas doctor --config "$TMP_DIR/docmancer.yaml"
+
+      - name: Build artifacts
+        run: python -m build --no-isolation
+
+      - name: Check artifacts
+        run: python -m twine check dist/*
+
+  build:
+    needs: smoke-test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+
+      - name: Install build tools
+        run: pip install build twine "hatchling<1.27"
+
+      - name: Build
+        run: python -m build --no-isolation
+
+      - name: Check artifacts
+        run: python -m twine check dist/*
+
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-pypi:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: release
+    steps:
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

doc_atlas-0.6.1/.gitignore

@@ -0,0 +1,28 @@
+.claude/
+__pycache__/
+*.pyc
+.pytest_cache/
+.qdrant/
+.venv/
+dist/
+build/
+coverage/
+.DS_Store
+.worktrees/
+.docmancer/
+.docs-kit/
+downloaded-docs/
+/release-patch-pypi.sh
+/repush-release-tag.sh
+docs/
+!docs/
+docs/*
+!docs/capabilities.md
+!docs/context7-docmancer-comparison.md
+!docs/DOCMANCER_PRODUCT_BRIEF.md
+!docs/mcp-docs-server.md
+!docs/project-docs-demo.md
+!docs/project-docs-mcp-workflow.md
+!docmancer/docs/
+!docmancer/docs/*.py
+scripts/*.log

doc_atlas-0.6.1/.idea/.gitignore

@@ -0,0 +1,3 @@
+# Default ignored files
+/shelf/
+/workspace.xml