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.
Files changed (65) hide show
  1. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/CHANGELOG.md +5 -0
  2. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/PKG-INFO +1 -1
  3. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/ontology/certification.json +1 -1
  4. archivebox_api-2.5.7/archivebox_api/skills/archivebox-api-development/SKILL.md +109 -0
  5. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api.egg-info/PKG-INFO +1 -1
  6. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api.egg-info/SOURCES.txt +2 -0
  7. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/pyproject.toml +1 -1
  8. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/release-readiness.json +126 -489
  9. archivebox_api-2.5.7/tests/test_archivebox_development_skill.py +41 -0
  10. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/.pre-commit-config.yaml +0 -0
  11. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/AGENTS.md +0 -0
  12. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/CLAUDE.md +0 -0
  13. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/LICENSE +0 -0
  14. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/MANIFEST.in +0 -0
  15. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/README.md +0 -0
  16. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/__init__.py +0 -0
  17. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/__main__.py +0 -0
  18. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/api/__init__.py +0 -0
  19. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/api/api_client_auth.py +0 -0
  20. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/api/api_client_base.py +0 -0
  21. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/api/api_client_cli.py +0 -0
  22. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/api/api_client_core.py +0 -0
  23. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/api_client.py +0 -0
  24. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/auth.py +0 -0
  25. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/connector_sources.py +0 -0
  26. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/kg_ingest.py +0 -0
  27. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/mcp_config.json +0 -0
  28. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/mcp_server.py +0 -0
  29. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/ontology/__init__.py +0 -0
  30. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/ontology/archivebox.ttl +0 -0
  31. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/ontology/fixtures/records.json +0 -0
  32. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/ontology/mappings/source.yaml +0 -0
  33. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/ontology/migrations/manifest.json +0 -0
  34. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/ontology/shapes/connector.shacl.ttl +0 -0
  35. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/prompts/web_archivist_specialist.json +0 -0
  36. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-api-operations/SKILL.md +0 -0
  37. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-api-operations/agents/openai.yaml +0 -0
  38. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-api-operations/references/catalog.md +0 -0
  39. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-kg-ingestion/SKILL.md +0 -0
  40. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-kg-ingestion/WORKFLOW.md +0 -0
  41. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-snapshot-search/SKILL.md +0 -0
  42. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-snapshot-search/WORKFLOW.md +0 -0
  43. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-web-archiving/SKILL.md +0 -0
  44. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/skills/archivebox-web-archiving/WORKFLOW.md +0 -0
  45. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/web_source.py +0 -0
  46. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api/web_source_contract.py +0 -0
  47. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api.egg-info/dependency_links.txt +0 -0
  48. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api.egg-info/entry_points.txt +0 -0
  49. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api.egg-info/requires.txt +0 -0
  50. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/archivebox_api.egg-info/top_level.txt +0 -0
  51. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/mkdocs.yml +0 -0
  52. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/requirements.txt +0 -0
  53. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/setup.cfg +0 -0
  54. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/tests/conftest.py +0 -0
  55. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/tests/test_action_discovery.py +0 -0
  56. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/tests/test_archivebox_api_brute_force_coverage.py +0 -0
  57. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/tests/test_archivebox_coverage.py +0 -0
  58. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/tests/test_archivebox_coverage_extra.py +0 -0
  59. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/tests/test_basic.py +0 -0
  60. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/tests/test_conformance.py +0 -0
  61. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/tests/test_init_dynamics.py +0 -0
  62. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/tests/test_kg_ingest.py +0 -0
  63. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/tests/test_kg_media.py +0 -0
  64. {archivebox_api-2.5.6 → archivebox_api-2.5.7}/tests/test_sdk_transport.py +0 -0
  65. {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
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: archivebox-api
3
- Version: 2.5.6
3
+ Version: 2.5.7
4
4
  Summary: Pythonic ArchiveBox API Wrapper and Fast MCP Server for Agentic AI use!
5
5
  Author-email: Repository Maintainers <maintainers@knuckles.team>
6
6
  License: MIT
@@ -29,5 +29,5 @@
29
29
  "signer": "UNSIGNED-PREVIEW",
30
30
  "signing_public_key": "",
31
31
  "status": "source-validated",
32
- "validated_at": "2026-10-24T07:40:18Z"
32
+ "validated_at": "2026-10-27T02:14:50Z"
33
33
  }
@@ -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.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: archivebox-api
3
- Version: 2.5.6
3
+ Version: 2.5.7
4
4
  Summary: Pythonic ArchiveBox API Wrapper and Fast MCP Server for Agentic AI use!
5
5
  Author-email: Repository Maintainers <maintainers@knuckles.team>
6
6
  License: MIT
@@ -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.6"
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",]