@c4a/context 0.7.13 → 0.7.14-beta.1

package/docs/guides/package-outputs.md

@@ -480,3 +480,24 @@ Only approved selected content is exported. A map or article change invalidates
 both website and LLMS outputs; failure preserves the previous staged package.
 Standalone `llmsPackage()` uses the same map organization and supplies the full
 text and raw article files alongside its template-rendered `llms.txt` index.
+
+## Links to a deployed website
+
+After a website has been built and deployed, record its complete public root:
+
+```bash
+context package site-url <package-name> https://example.com/docs/
+```
+
+This command adds optional `site_url` to the existing `context.site-output/v1`
+map, in both the website and knowledge package. It normalizes a trailing slash,
+rejects credentials/query/fragment, and never contacts the URL. The address
+includes the deployment subpath; resolve `pages[].site_path` against it without
+adding `base` again. Rebuilds preserve the address from the previous website
+map and distribute the refreshed mapping with the package. Deleting dist also
+deletes this optional delivery metadata: record it again from the deployment
+result instead of guessing a hostname. No new workspace configuration is needed.
+
+The address is an access hint, not proof of publication or content freshness.
+Query Skills use it only to append related links in the final summary, with no
+network probes or version checks. Packages without the map work as before.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/context",
-  "version": "0.7.13",
+  "version": "0.7.14-beta.1",
   "type": "module",
   "description": "Declarative SDK for Context knowledge sources, workflows, review, and package outputs",
   "license": "MIT",

package/templates/package-templates/kb/skills/knowledge-query/SKILL.md

@@ -133,3 +133,20 @@ Update the description, routing table, and package-boundary guidance to match
 the actual package. If the generic behavior is intentionally sufficient,
 explicitly accept the unchanged default during Context package-template review.
 --}}
+
+## Website links in the final summary
+
+After answering from the pages actually read, optionally append one or more
+related document links in the final summary. Read `context-site-map.json` from
+the selected package (or its sibling website output in a workspace). Match the
+read page to `pages[].package_path` or `approved_path`; use its `title` and resolve
+`site_path` relative to `site_url`. The URL already includes the deployment base
+path: do not prepend `base` again. Only cite matched articles, deduplicate links,
+and do not invent section anchors.
+
+This is a local formatting step, not retrieval or validation. Do not probe URLs,
+make HTTP/HEAD requests, open a browser, inspect a deployment platform, or check
+remote versions to add links. Never build, publish or update metadata for this
+purpose. If the map, URL or matching page is absent or malformed, keep the local
+citation and continue silently. A configured URL does not prove that the site
+contains the current local revision; do not claim online verification.

package/templates/package-templates.zh-CN/kb/skills/knowledge-query/SKILL.md

@@ -97,3 +97,16 @@ node <当前 knowledge-query Skill 目录>/scripts/search.mjs --query '<关键
 
 这是可直接工作的通用查询 Skill。正式发布前，如果知识包存在专用术语、常见用户意图、推荐入口、已知边界或固定任务流程，作者应修改 description、路由表和包边界说明；如果通用行为已经足够，应在 Context 的包模板 Review 中明确接受未修改模板。
 --}}
+
+## 总结中的网站文档链接
+
+完成正文检索和回答后，仅在最终总结中按需附上一篇或多篇实际读取过的相关文档链接。
+从当前知识包读取 `context-site-map.json`，按命中文章的包内路径匹配
+`pages[].package_path`，使用 `title` 作链接文字，将 `site_path` 相对
+`site_url` 拼接。`site_url` 已包含站点子路径，不再重复拼接 `base`。
+同一文章只列一次，不凭标题推测页面地址或章节锚点。
+
+这是本地引用格式化，不是检索前置步骤：不要为地址发起 HTTP/HEAD 请求、打开浏览器、
+查询部署平台或远端版本，也不触发构建、发布或元数据修改。映射、地址或匹配项缺失、
+格式不正确时沿用本地引用即可，不阻塞回答，不要求用户补配置。
+记录的链接不证明线上内容与本地版本一致，不声称已验证网站。