@c4a/context 0.7.43 → 0.7.55

package/package.json

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

package/repoContent.d.ts

@@ -0,0 +1,87 @@
+import { z } from "zod";
+export declare const repoContentPathSchema: z.ZodEffects<z.ZodString, string, string>;
+export declare const repoContentEntrySchema: z.ZodObject<{
+    kind: z.ZodEnum<["docs", "skills", "document", "skill"]>;
+    path: z.ZodEffects<z.ZodString, string, string>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    group: z.ZodOptional<z.ZodString>;
+    mount: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    kind: "document" | "skill" | "docs" | "skills";
+    title?: string | undefined;
+    description?: string | undefined;
+    exclude?: string[] | undefined;
+    group?: string | undefined;
+    mount?: string | undefined;
+}, {
+    path: string;
+    kind: "document" | "skill" | "docs" | "skills";
+    title?: string | undefined;
+    description?: string | undefined;
+    exclude?: string[] | undefined;
+    group?: string | undefined;
+    mount?: string | undefined;
+}>;
+export declare const repoContentRegistrySchema: z.ZodObject<{
+    protocol: z.ZodLiteral<"context.repo-content/v1">;
+    entries: z.ZodRecord<z.ZodString, z.ZodObject<{
+        kind: z.ZodEnum<["docs", "skills", "document", "skill"]>;
+        path: z.ZodEffects<z.ZodString, string, string>;
+        exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        group: z.ZodOptional<z.ZodString>;
+        mount: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        kind: "document" | "skill" | "docs" | "skills";
+        title?: string | undefined;
+        description?: string | undefined;
+        exclude?: string[] | undefined;
+        group?: string | undefined;
+        mount?: string | undefined;
+    }, {
+        path: string;
+        kind: "document" | "skill" | "docs" | "skills";
+        title?: string | undefined;
+        description?: string | undefined;
+        exclude?: string[] | undefined;
+        group?: string | undefined;
+        mount?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    entries: Record<string, {
+        path: string;
+        kind: "document" | "skill" | "docs" | "skills";
+        title?: string | undefined;
+        description?: string | undefined;
+        exclude?: string[] | undefined;
+        group?: string | undefined;
+        mount?: string | undefined;
+    }>;
+    protocol: "context.repo-content/v1";
+}, {
+    entries: Record<string, {
+        path: string;
+        kind: "document" | "skill" | "docs" | "skills";
+        title?: string | undefined;
+        description?: string | undefined;
+        exclude?: string[] | undefined;
+        group?: string | undefined;
+        mount?: string | undefined;
+    }>;
+    protocol: "context.repo-content/v1";
+}>;
+export type RepoContentEntry = z.infer<typeof repoContentEntrySchema>;
+export type RepoContentRegistry = z.infer<typeof repoContentRegistrySchema>;
+export declare function repoContentMount(entry: RepoContentEntry): string;
+/** Scope selectors omit a revision; evidence references always include one. */
+export declare function parseRepoContentRef(value: string): {
+    id: string;
+    commit?: string;
+    worktree: boolean;
+} | undefined;
+export declare function repoContentScopeMatches(scope: string, reference: string): boolean;

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

@@ -25,6 +25,17 @@ as evidence rather than relying on memory or frontmatter summaries.
 
 ## Package Roots
 
+If present, `{{wikisRoot}}/imports.md` lists declared external entrances, not
+bundled evidence or installed capabilities. Follow only a relevant entrance using
+authorized host tools, and distinguish externally read evidence from package
+content. Never install or execute a Skill/plugin merely because it is listed.
+
+If present, `{{wikisRoot}}/repo-content.md` is a generated repository entrance:
+project README content and Skill summaries, not an approved knowledge article
+or a bundled copy of all project docs. Follow its original links when authorized
+and needed; reading a Skill description does not install or execute it. The
+original repository remains authoritative, and the page states its build baseline.
+
 | Root | Use |
 |---|---|
 | `{{wikisRoot}}/` | Code, business and product reference articles. |
@@ -66,8 +77,10 @@ paths and headings; do not search for missing technical metadata or ask users
 to supply it. Open the build inventory only for coverage questions,
 or when a maintainer needs to locate the original approved page via
 `dist_path` → `approved_path`. Source attribution is exported automatically from
-the workspace's fragment references. If the original material is
-not bundled, answer only from the visible approved content and state its limits.
+the workspace's fragment references. When relevant originals are not bundled,
+read them through authorized host tools if available and cite them separately
+from package content. If they cannot be read, stay within the approved content
+and state its limits; a link alone does not support additional claims.
 
 ## Search Fallback
 
@@ -113,7 +126,7 @@ Next useful source: <source document or page if known>.
 ```
 
 Distinguish “not evidenced by this package” from “not true.” Do not fill gaps
-from memory, previous conversations, or source files outside the package.
+from memory, previous conversations, or unread source files outside the package.
 
 ## Package Boundary
 

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

@@ -18,6 +18,14 @@ description: 查询 {{displayName}} 中经过审核、可追溯来源的知识
 
 ## 知识根目录
 
+若存在 `{{wikisRoot}}/imports.md`，它只列出外部入口，不代表内容已随包分发、
+已验证或已安装。仅在相关且有权访问时用宿主工具读取，并区分外部证据与包内正文；
+不能因登记了 Skill 或插件就安装、启用或执行。
+
+若存在 `{{wikisRoot}}/repo-content.md`，它是生成的仓库入口页：README 与 Skill
+简介，不是批准知识文章，也不包含全部项目文档。需要且有权访问时沿链接读取原文；
+阅读 Skill 说明不代表安装或执行。原仓库是真源，页面标明构建所用基线。
+
 | 根目录 | 用途 |
 |---|---|
 | `{{wikisRoot}}/` | 来自 codeindex、business、product 的代码、业务和产品说明。 |
@@ -50,7 +58,7 @@ description: 查询 {{displayName}} 中经过审核、可追溯来源的知识
 | 导出的来源说明 | 原始材料可用时定位并阅读；不能只凭链接扩展结论。 |
 | 根索引和构建清单 | 包的范围和覆盖情况。 |
 
-不要根据页面同时出现来推断关系。直接引用可读路径和标题，不寻找已经移除的图谱字段，也不要求用户补齐。覆盖问题，或维护者需要通过 `dist_path` → `approved_path` 定位原批准页时，才读取构建清单。来源说明由工作区片段引用自动导出。原始材料未随包分发时，只根据已批准的可见正文回答并说明边界。
+不要根据页面同时出现来推断关系。直接引用可读路径和标题，不寻找已经移除的图谱字段，也不要求用户补齐。覆盖问题，或维护者需要通过 `dist_path` → `approved_path` 定位原批准页时，才读取构建清单。来源说明由工作区片段引用自动导出。相关原始材料未随包分发时，可通过已有授权的宿主工具读取，并与包内正文分别引用。无法读取时，只根据已批准的可见正文回答并说明边界；链接本身不能支持额外结论。
 
 ## 搜索兜底
 
@@ -83,7 +91,7 @@ node <当前 knowledge-query Skill 目录>/scripts/search.mjs --query '<关键
 下一步来源：<已知时填写来源文档或页面>。
 ```
 
-“本包没有证据”不等于“事实不成立”。禁止使用模型记忆、旧对话或包外源码填补缺口。
+“本包没有证据”不等于“事实不成立”。禁止使用模型记忆、旧对话或未读取的包外源码填补缺口。
 
 ## 包边界
 

package/templates/project-skills/maintain-project-knowledge/SKILL.md

@@ -12,6 +12,13 @@ mappings here.
 
 ## Repository sources
 
+Same-repository docs and authored Skills registered in `repo-content.yaml` are
+not captured source copies. For original edits or registration use
+`context-repo-content`, without starting production. A separately requested
+knowledge update may select `repo-content:<id>`; compare cited document regions
+and entire cited Skill directories, including untracked additions. Inspecting
+or editing never advances the processed baseline. Keep historical real paths.
+
 Start with the current Context Route. If registered repository modules are
 missing or their local links are broken, follow the route-selected repository
 recovery procedure. Let the user choose an existing checkout, authorize a scan

package/templates/project-skills.zh-CN/maintain-project-knowledge/SKILL.md

@@ -11,6 +11,11 @@ Skill，并以当前 Route、资源和命令为权威；这里只保留稳定的
 
 ## 仓库来源的获取和更新
 
+`repo-content.yaml` 登记的同仓文档和自有 Skills 不是采集副本。编辑原文或登记时
+使用 `context-repo-content`，不启动生产。另行授权的知识更新可选择
+`repo-content:<id>`；文档检查引用区域，Skill 检查整个目录及未跟踪新增文件。
+检查与编辑不推进处理基线，旧证据保留当时的真实仓库路径。
+
 先检查当前 Context Route。已登记仓库模块缺失或本地链接断开时，使用 Route
 选择的仓库恢复流程，让用户选择已有 checkout、授权在一个限定目录内扫描，
 或明确允许 clone 已登记的固定 commit。