archivebox-api 2.5.6__tar.gz → 2.5.7__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/CHANGELOG.md +5 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/PKG-INFO +1 -1
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/ontology/certification.json +1 -1
- archivebox_api-2.5.7/archivebox_api/skills/archivebox-api-development/SKILL.md +109 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api.egg-info/PKG-INFO +1 -1
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api.egg-info/SOURCES.txt +2 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/pyproject.toml +1 -1
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/release-readiness.json +126 -489
- archivebox_api-2.5.7/tests/test_archivebox_development_skill.py +41 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/.pre-commit-config.yaml +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/AGENTS.md +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/CLAUDE.md +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/LICENSE +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/MANIFEST.in +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/README.md +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/__init__.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/__main__.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/api/__init__.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/api/api_client_auth.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/api/api_client_base.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/api/api_client_cli.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/api/api_client_core.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/api_client.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/auth.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/connector_sources.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/kg_ingest.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/mcp_config.json +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/mcp_server.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/ontology/__init__.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/ontology/archivebox.ttl +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/ontology/fixtures/records.json +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/ontology/mappings/source.yaml +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/ontology/migrations/manifest.json +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/ontology/shapes/connector.shacl.ttl +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/prompts/web_archivist_specialist.json +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-api-operations/SKILL.md +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-api-operations/agents/openai.yaml +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-api-operations/references/catalog.md +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-kg-ingestion/SKILL.md +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-kg-ingestion/WORKFLOW.md +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-snapshot-search/SKILL.md +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-snapshot-search/WORKFLOW.md +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-web-archiving/SKILL.md +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-web-archiving/WORKFLOW.md +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/web_source.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/web_source_contract.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api.egg-info/dependency_links.txt +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api.egg-info/entry_points.txt +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api.egg-info/requires.txt +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api.egg-info/top_level.txt +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/mkdocs.yml +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/requirements.txt +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/setup.cfg +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/tests/conftest.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/tests/test_action_discovery.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/tests/test_archivebox_api_brute_force_coverage.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/tests/test_archivebox_coverage.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/tests/test_archivebox_coverage_extra.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/tests/test_basic.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/tests/test_conformance.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/tests/test_init_dynamics.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/tests/test_kg_ingest.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/tests/test_kg_media.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/tests/test_sdk_transport.py +0 -0
- {archivebox_api-2.5.6 → archivebox_api-2.5.7}/tests/test_web_source.py +0 -0
|
@@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file.
|
|
|
5
5
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
6
6
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
7
|
|
|
8
|
+
## [2.5.7] - 2026-10-27
|
|
9
|
+
|
|
10
|
+
### Added
|
|
11
|
+
- Add the ArchiveBox rapid-delivery development skill and its package-content contract test.
|
|
12
|
+
|
|
8
13
|
## [2.5.6] - 2026-10-24
|
|
9
14
|
|
|
10
15
|
### Changed
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: archivebox-api-development
|
|
3
|
+
skill_type: skill
|
|
4
|
+
description: >-
|
|
5
|
+
Develop and maintain the ArchiveBox connector while preserving its governed
|
|
6
|
+
API actions, web-source contract, credential boundary, package resources, and
|
|
7
|
+
public-first release evidence.
|
|
8
|
+
license: MIT
|
|
9
|
+
tags: [archivebox, connector, mcp, sdk, web-source, knowledge-graph]
|
|
10
|
+
metadata:
|
|
11
|
+
author: Genius
|
|
12
|
+
version: '0.1.0'
|
|
13
|
+
---
|
|
14
|
+
# ArchiveBox API Development
|
|
15
|
+
|
|
16
|
+
This is the repository development skill for `archivebox-api`. The owning central
|
|
17
|
+
delivery row is `PIPE-CONNSPEC-R103.4`; use this skill with the repository
|
|
18
|
+
`AGENTS.md`, the connector-content and web-source specifications, and the
|
|
19
|
+
focused tests.
|
|
20
|
+
|
|
21
|
+
## Repository and runtime map
|
|
22
|
+
|
|
23
|
+
- `archivebox_api/mcp_server.py` registers authentication, core, CLI, KG,
|
|
24
|
+
and web-source tools. Keep action names and the SDK Connector boundary stable.
|
|
25
|
+
- `archivebox_api/api_client.py` composes the authentication, core, and CLI
|
|
26
|
+
API wrappers. `archivebox_api/auth.py` injects endpoint credentials and the
|
|
27
|
+
SDK TLS profile through `get_client`; it must not persist secret values.
|
|
28
|
+
- `archivebox_api/connector_sources.py` is the live source and schema
|
|
29
|
+
declaration. Change declarations there rather than duplicating source IDs or
|
|
30
|
+
mappings in tool code.
|
|
31
|
+
- `archivebox_api/web_source.py` implements the SDK web-source contract:
|
|
32
|
+
keyless web discovery is separate from ArchiveBox REST authentication, while
|
|
33
|
+
extractor files use a logged-in Django session and bounded reads.
|
|
34
|
+
- `archivebox_api/kg_ingest.py` owns best-effort typed Snapshot, ArchiveResult,
|
|
35
|
+
Document, Chunk, Tag, and Blob ingestion through the SDK/epistemic-graph
|
|
36
|
+
boundary. Preserve stable IDs and no-op behavior when the engine is absent.
|
|
37
|
+
- `archivebox_api/skills/**`, `prompts/**`, `ontology/**`, and
|
|
38
|
+
`connectors/**` are package data. A skill change therefore needs a package
|
|
39
|
+
inclusion check before publication.
|
|
40
|
+
|
|
41
|
+
## Connection and security contract
|
|
42
|
+
|
|
43
|
+
The REST client uses `ARCHIVEBOX_BASE_URL` with the `ARCHIVEBOX_URL` alias.
|
|
44
|
+
Bearer/API-key and basic-auth values come from injected `ARCHIVEBOX_TOKEN`,
|
|
45
|
+
`ARCHIVEBOX_API_KEY`, `ARCHIVEBOX_USERNAME`, and `ARCHIVEBOX_PASSWORD`
|
|
46
|
+
settings. Keep secrets out of source, skills, fixtures, logs, and test output.
|
|
47
|
+
|
|
48
|
+
Use the SDK TLS policy selected by `ARCHIVEBOX_TLS_PROFILE` and
|
|
49
|
+
`ARCHIVEBOX_TLS_PROFILE_REF`; `ArchiveSession` must keep certificate and
|
|
50
|
+
hostname verification governed by the shared resolver. Preserve the supported
|
|
51
|
+
`stdio`, `streamable-http`, and `sse` transports, the
|
|
52
|
+
`MCP_TOOL_MODE` surface selection, `WEBTOOL`/`WEB_SOURCETOOL` toggles,
|
|
53
|
+
and the `ARCHIVEBOX_KG_AUTO_INGEST` opt-out. Do not add a provider-specific
|
|
54
|
+
credential store or a TLS bypass.
|
|
55
|
+
|
|
56
|
+
## Rapid delivery: the 5-minute contract
|
|
57
|
+
|
|
58
|
+
1. Read the owning connector-content and web-source specs, this skill,
|
|
59
|
+
`AGENTS.md`, and the directly bound tests before changing a surface.
|
|
60
|
+
2. Inspect the SDK `Connector`, action lists and dispatchers, API wrappers,
|
|
61
|
+
`ArchiveWebSource` session/refusal behavior, source declarations, KG
|
|
62
|
+
mappings, and package-data rules.
|
|
63
|
+
3. Make the smallest connector-owned change. Preserve public action/tool names,
|
|
64
|
+
source IDs and mappings, keyless web fallbacks, injected credentials, TLS
|
|
65
|
+
verification, bounded extractor reads, stable KG IDs, and canonical/legacy
|
|
66
|
+
server paths.
|
|
67
|
+
4. Run the smallest directly bound tests with
|
|
68
|
+
`uv run --locked --extra test pytest`, then run the repository hooks. Use
|
|
69
|
+
the approved narrow wrapper when the lane requires it; never bypass a hook or
|
|
70
|
+
failing gate.
|
|
71
|
+
5. If package content changes, advance the version with the repository's normal
|
|
72
|
+
release metadata, refresh `uv.lock`, and inspect the built wheel and sdist
|
|
73
|
+
for the intended `archivebox_api/skills/**` bytes before publication.
|
|
74
|
+
6. Treat Pages and containers as separate evidence. After the exact main commit
|
|
75
|
+
publishes, verify the Pages revision and `/spec-delivery/` artifacts. The
|
|
76
|
+
container workflow must wait for the exact public wheel guard; never move an
|
|
77
|
+
image pin before package proof.
|
|
78
|
+
|
|
79
|
+
## Focused validation
|
|
80
|
+
|
|
81
|
+
For client, action, source, or KG changes, run only the smallest relevant test
|
|
82
|
+
file and keep keyless, credentialed, unavailable-authority, and refusal paths
|
|
83
|
+
distinct. For this skill/package-data change, verify frontmatter, the required
|
|
84
|
+
rapid-delivery heading, ArchiveBox-specific source references, package-data
|
|
85
|
+
inclusion, and absence of token-like material without contacting an external
|
|
86
|
+
provider.
|
|
87
|
+
|
|
88
|
+
Use repository commands from `AGENTS.md`:
|
|
89
|
+
|
|
90
|
+
```bash
|
|
91
|
+
uv sync --locked
|
|
92
|
+
uv run --locked --extra test pytest -q tests/test_archivebox_development_skill.py
|
|
93
|
+
uvx pre-commit run --all-files
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
## Publication and Pages
|
|
97
|
+
|
|
98
|
+
`.github/workflows/pipeline.yml` publishes the package through
|
|
99
|
+
`Knuckles-Team/pipelines/.github/workflows/python_pipeline.yml@main` with
|
|
100
|
+
`connector: true`, then invokes the container pipeline with
|
|
101
|
+
`render_connector: true`. `.github/workflows/pages.yml` delegates the
|
|
102
|
+
README/docs path to `pages_pipeline.yml@main`. Keep package publication before
|
|
103
|
+
the generated connector image and preserve the public wheel/source fences.
|
|
104
|
+
|
|
105
|
+
A successful local test or workflow run is not package, Pages, or image proof.
|
|
106
|
+
Record the exact merged source, public wheel/sdist hashes, skill bytes, Pages
|
|
107
|
+
revision, and image digest separately. Do not hand-edit central Pipelines status,
|
|
108
|
+
promote a rollup from this skill change, or put credentials, provider data,
|
|
109
|
+
generated release artifacts, or bypass instructions in this skill.
|
|
@@ -38,6 +38,7 @@ archivebox_api/ontology/mappings/source.yaml
|
|
|
38
38
|
archivebox_api/ontology/migrations/manifest.json
|
|
39
39
|
archivebox_api/ontology/shapes/connector.shacl.ttl
|
|
40
40
|
archivebox_api/prompts/web_archivist_specialist.json
|
|
41
|
+
archivebox_api/skills/archivebox-api-development/SKILL.md
|
|
41
42
|
archivebox_api/skills/archivebox-api-operations/SKILL.md
|
|
42
43
|
archivebox_api/skills/archivebox-api-operations/agents/openai.yaml
|
|
43
44
|
archivebox_api/skills/archivebox-api-operations/references/catalog.md
|
|
@@ -52,6 +53,7 @@ tests/test_action_discovery.py
|
|
|
52
53
|
tests/test_archivebox_api_brute_force_coverage.py
|
|
53
54
|
tests/test_archivebox_coverage.py
|
|
54
55
|
tests/test_archivebox_coverage_extra.py
|
|
56
|
+
tests/test_archivebox_development_skill.py
|
|
55
57
|
tests/test_basic.py
|
|
56
58
|
tests/test_conformance.py
|
|
57
59
|
tests/test_init_dynamics.py
|
|
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
|
|
|
4
4
|
|
|
5
5
|
[project]
|
|
6
6
|
name = "archivebox-api"
|
|
7
|
-
version = "2.5.
|
|
7
|
+
version = "2.5.7"
|
|
8
8
|
description = "Pythonic ArchiveBox API Wrapper and Fast MCP Server for Agentic AI use!"
|
|
9
9
|
readme = "README.md"
|
|
10
10
|
classifiers = [ "Development Status :: 5 - Production/Stable", "License :: Public Domain", "Environment :: Console", "Operating System :: POSIX :: Linux", "Programming Language :: Python :: 3",]
|