dsh-knowhub 0.9.1 → 0.10.0

package/README.md

@@ -106,7 +106,7 @@ cmd /c mklink /J "$env:USERPROFILE\.dsh\profiles\knowhub\node_modules\dsh-knowhu
 ## 使用流程
 
 1. **新建知识库**：左侧栏「知枢」→「知识库」→「+ 新建」，选择生效范围（用户级 / 工作区级）、模型与策略。
-2. **初始化 Wiki**：在知识库详情点「初始化」，扫描工作区并生成候选草稿。
+2. **初始化知识**：在知识库详情点「初始化」，扫描工作区并按 Repo Wiki / 知识卡片 / 长期记忆三条线生成候选草稿。
 3. **审核**：右上「待审核」里逐条或批量审批；内容有改动可用「编辑后批准」，冲突可人工合并。
 4. **增量更新**：初始化完成后点「增量更新」，只对变更文件影响到的知识生成候选。
 5. **记忆与卡片**：会话中由 Agent 工具提议，或开启自动提炼；结果都在待审核里确认。
@@ -131,6 +131,15 @@ cmd /c mklink /J "$env:USERPROFILE\.dsh\profiles\knowhub\node_modules\dsh-knowhu
 - 弹窗统一使用 DSH 视觉规范：半透明遮罩 + 背景模糊、层级阴影、进出场动画；打开时锁定页面滚动，Esc 或点击遮罩关闭。
 - 表单内的字段校验仍在输入框旁就地提示；接口错误既进入浮层提示，也在受影响的区域给出定位。
 
+## 捆绑技能：Archify 绘图
+
+本包捆绑了 [Archify](https://github.com/tt-a1i/archify) 3.2.0 技能（位于 `skills/archify/`），安装 KnowHub 后 DSH 的技能系统即可加载它，用一句话让 Agent 绘制可交互的图：架构图（architecture）、流程图（workflow）、时序图（sequence）、数据流图（dataflow）、状态机（lifecycle）、ER 图（erd）、类图（class）、树形知识图谱（tree）、时间线（timeline）与瀑布图（waterfall），产出为独立 HTML 文件落在工作区（默认 `.archify/` 目录）。
+
+- 用法示例：在 DSH 对话中点名技能，如「Use the archify skill to map this repository's runtime architecture」或「用 archify 把这个项目的模块关系画成 tree 图」。
+- 捆绑机制与上游官方适配包 `@tt-a1i/archify-dsh` 一致（通过 `cordis.patch.yml` 注册文件系统技能提供方）；**不要再同时安装 `@tt-a1i/archify-dsh`**，功能重复。同名个人/项目技能的优先级高于本捆绑版本。
+- 为控制包体积，捆绑时仅剔除了 `examples/` 下 15 个已渲染的示例 HTML（约 13MB，技能文档与运行均不引用它们）；其余文件与上游 3.2.0 保持一致。
+- 许可：Archify 技能为 Apache-2.0，其 `LICENSE`、`LICENSE-MIT`、`NOTICE`、`THIRD_PARTY_NOTICES.md` 均随附在 `skills/archify/` 内；KnowHub 本体仍为 MIT。
+
 ## 常见问题
 
 **初始化或增量任务失败，提示模型调用失败怎么办？**

package/cordis.patch.yml

@@ -13,3 +13,13 @@
     # 客户端半边（node 侧为空壳）：dsh.client 声明让客户端模块系统把它编入 window.__DSH_BOOT__
     - id: knowhub-ui
       name: dsh-knowhub
+
+    # 捆绑 Archify 技能（架构图 / 流程图 / 时序图 / 树形知识图谱等，Archify 3.2.0，Apache-2.0）：
+    # 技能文件随本包分发在 skills/archify，机制与上游 @tt-a1i/archify-dsh 适配包一致；
+    # bundledSkillDir 锚定本包的安装位置解析，不拼宿主路径。与 @tt-a1i/archify-dsh 二选一安装，不要同装。
+    - id: knowhub-archify-skill
+      name: '@deepseek-ai/dsh-skill-filesystem'
+      config:
+        providerName: archify-plugin
+        includeDefaultRoots: true
+        bundledSkillDir: !!js process.getBuiltinModule('node:path').join(process.getBuiltinModule('node:path').dirname(process.getBuiltinModule('node:module').createRequire(baseUrl).resolve('dsh-knowhub/package.json')), 'skills')

package/lib/host/pipeline/initialize.js

@@ -1,5 +1,5 @@
 /**
- * 初始化流水线（M2）：真实扫描 → 文件索引 → 用知识库绑定模型生成 Wiki 候选 → 存为待审核草稿。
+ * 初始化流水线（M2）：真实扫描 → 文件索引 → 用知识库绑定模型按内容区（Repo Wiki / 知识卡片 / 长期记忆）生成知识候选 → 存为待审核草稿。
  *
  * 硬约束（对应规范 §4 / §14.2 / §14.3）：
  * - 模型只用 knowledge_base.model_provider + model_id，绝不回退到全局默认；目录里找不到即报错；
@@ -33,19 +33,29 @@ export class InitError extends Error {
 }
 const DOC_KINDS = new Set(['wiki', 'decision', 'issue', 'todo', 'memory', 'convention', 'preference']);
 const STRATEGY_LIMITS = {
-    economy: { maxFiles: 12000, maxHashes: 1500, maxContextChars: 12000, maxTokens: 10000, wikiPages: 2 },
-    balanced: { maxFiles: 20000, maxHashes: 3000, maxContextChars: 20000, maxTokens: 20000, wikiPages: 4 },
-    quality: { maxFiles: 30000, maxHashes: 6000, maxContextChars: 30000, maxTokens: 50000, wikiPages: 7 },
+    economy: { maxFiles: 12000, maxHashes: 1500, maxContextChars: 20000, maxTokens: 10000, wikiPages: 2 },
+    balanced: { maxFiles: 20000, maxHashes: 3000, maxContextChars: 40000, maxTokens: 20000, wikiPages: 4 },
+    quality: { maxFiles: 30000, maxHashes: 6000, maxContextChars: 60000, maxTokens: 50000, wikiPages: 7 },
 };
 function planCalls(strategy) {
-    const base = [{ purpose: 'wiki-overview', topics: ['项目总览', '技术栈与依赖'] }];
+    const overview = { purpose: 'wiki-overview', area: 'wiki', topics: ['项目总览', '技术栈与依赖'] };
+    const cardsCore = { purpose: 'cards-core', area: 'cards', topics: ['技术选型与决策', '已知问题与风险'] };
     if (strategy === 'economy')
-        return base;
-    const second = { purpose: 'wiki-architecture', topics: ['系统架构', '核心模块'] };
+        return [overview, cardsCore];
+    const architecture = { purpose: 'wiki-architecture', area: 'wiki', topics: ['系统架构', '核心模块'] };
+    const memoryCore = { purpose: 'memory-core', area: 'memory', topics: ['项目背景与长期事实', '项目约定与协作偏好'] };
     if (strategy === 'balanced')
-        return [...base, second];
-    return [...base, second, { purpose: 'wiki-interfaces', topics: ['关键接口与数据流', '技术选型与决策记录', '已知问题与待确认事项'] }];
+        return [overview, architecture, cardsCore, memoryCore];
+    return [
+        overview,
+        architecture,
+        { purpose: 'wiki-interfaces', area: 'wiki', topics: ['关键接口与数据流'] },
+        cardsCore,
+        { purpose: 'cards-actions', area: 'cards', topics: ['待办事项与待确认问题'] },
+        memoryCore,
+    ];
 }
+const AREA_LABELS = { wiki: 'Repo Wiki', cards: '知识卡片', memory: '长期记忆' };
 function updateKbStatus(db, kbId, status, detail) {
     run(db, 'UPDATE knowledge_bases SET status = ?, status_detail = ?, updated_at = ? WHERE id = ?', [status, JSON.stringify(detail).slice(0, 4000), Date.now(), kbId]);
 }
@@ -74,7 +84,30 @@ export function sanitizeModelText(text, secrets) {
 function escapeRegex(value) {
     return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
-function buildContext(index, strategy) {
+/** 读取关键文件摘录补强上下文：README 优先、其次入口文件；只读已进入索引的文件（敏感文件已被索引排除），读不到就跳过。 */
+async function readKeyFileSnippets(root, index) {
+    const known = new Set(index.files.map((file) => file.path));
+    const picks = [];
+    const readme = index.files.find((file) => /^readme(\.[a-z-]+)?\.md$/i.test(file.path));
+    if (readme)
+        picks.push({ path: readme.path, cap: 6000 });
+    for (const hint of index.stack.entryHints.slice(0, 2)) {
+        if (known.has(hint) && hint !== readme?.path)
+            picks.push({ path: hint, cap: 2500 });
+    }
+    const snippets = [];
+    for (const pick of picks) {
+        try {
+            const text = await fs.readFile(join(root, pick.path), 'utf8');
+            snippets.push({ path: pick.path, text: text.slice(0, pick.cap) });
+        }
+        catch {
+            // 读不到就跳过，不阻断初始化。
+        }
+    }
+    return snippets;
+}
+function buildContext(index, strategy, keySnippets = []) {
     const limits = STRATEGY_LIMITS[strategy];
     const parts = [];
     parts.push('项目根：<项目根>');
@@ -94,6 +127,13 @@ function buildContext(index, strategy) {
     parts.push(index.files.slice(0, fileLimit).map((file) => file.path).join('\n'));
     if (index.files.length > fileLimit)
         parts.push('…（其余 ' + (index.files.length - fileLimit) + ' 个文件未列出）');
+    if (keySnippets.length > 0) {
+        parts.push('关键文件内容摘录：');
+        for (const snippet of keySnippets) {
+            parts.push('--- ' + snippet.path + ' ---');
+            parts.push(snippet.text);
+        }
+    }
     if (index.configSnippets.length > 0) {
         parts.push('关键配置摘要：');
         for (const snippet of index.configSnippets) {
@@ -104,20 +144,65 @@ function buildContext(index, strategy) {
     const text = parts.join('\n');
     return text.length > limits.maxContextChars ? text.slice(0, limits.maxContextChars) + '\n…（上下文已按策略截断）' : text;
 }
-function buildPrompt(topics, context) {
+function strictRules() {
     return [
-        '你是知枢 KnowHub 的项目文档分析器。请只依据下面提供的仓库事实，生成 Repo Wiki 候选文档。',
         '严格要求：',
         '1. 只输出一个 JSON 对象，不要输出任何解释、前后缀或 Markdown 代码围栏之外的文字。',
-        '2. 不得编造未在上下文中出现的模块职责、接口、依赖或决策；无法确认的内容写入 uncertain 数组。',
-        '3. 文档正文使用简体中文 Markdown；涉及文件时使用相对路径（如 src/host/tasks.ts）。',
-        '4. 每条文档必须给出 sources，值为上方文件清单中真实存在的相对路径；没有可引用文件时 sources 为空数组。',
+        '2. 不得编造未在上下文中出现的模块职责、接口、依赖、决策或事实；无法确认的内容写入 uncertain 数组，证据不足的条目宁可不写。',
+        '3. 正文使用简体中文 Markdown；涉及文件时使用相对路径（如 src/host/tasks.ts）。',
+        '4. 每条必须给出 sources，值为上方文件清单中真实存在的相对路径；没有可引用文件时 sources 为空数组。',
         '5. 不得输出密钥、凭据、绝对路径或完整环境变量值。',
+        '6. 不要写「该模块负责相关功能」这类空话；每句话都要落到上下文中可核对的事实上。',
+    ];
+}
+function buildPrompt(planned, context) {
+    if (planned.area === 'cards') {
+        return [
+            '你是知枢 KnowHub 的项目知识分析器。请只依据下面提供的仓库事实，提炼「知识卡片」候选：结论先行、短小具体的卡片，而不是长篇文档。',
+            ...strictRules(),
+            '',
+            '需要提炼的主题：' + planned.topics.join('、'),
+            '每个主题提炼 1-3 张卡片；没有足够证据的主题直接跳过，不要硬凑。',
+            'kind 只能是 decision / issue / todo / convention 之一：',
+            '- decision（技术选型与决策）：正文写清选了什么、为什么、代价或替代方案；',
+            '- issue（已知问题与风险）：正文写清现象、影响范围与证据文件；',
+            '- todo（待办与待确认）：正文写清待办或待确认什么、为什么重要；',
+            '- convention（项目约定）：正文写清约定内容与适用范围（如目录组织、命名、提交或测试约定）。',
+            '每张卡片正文 80-400 字，第一句就是结论。',
+            '输出 JSON 结构：',
+            '{"documents":[{"title":"卡片标题","kind":"decision","tags":["标签"],"confidence":0.6,"sources":["相对路径"],"body":"Markdown 正文","uncertain":["待确认事项"]}]}',
+            '',
+            '仓库事实：',
+            context,
+        ].join('\n');
+    }
+    if (planned.area === 'memory') {
+        return [
+            '你是知枢 KnowHub 的长期记忆分析器。请只依据下面提供的仓库事实，提炼值得长期保存、跨会话复用的「长期记忆」候选。',
+            ...strictRules(),
+            '',
+            '需要提炼的主题：' + planned.topics.join('、'),
+            'kind 只能是 memory / preference 之一：',
+            '- memory（长期事实）：项目目标与背景、当前阶段与里程碑、稳定的技术事实与边界——只记长期有效的内容，不记一次性细节；',
+            '- preference（偏好与约定倾向）：从文档与配置中能明确看出的协作或工程偏好；看不出就不要写这一类。',
+            '每个主题提炼 1-2 条；每条正文 2-6 句完整中文，先给事实，再给一句理由或来源说明。',
+            '输出 JSON 结构：',
+            '{"documents":[{"title":"记忆标题","kind":"memory","tags":["标签"],"confidence":0.6,"sources":["相对路径"],"body":"Markdown 正文","uncertain":["待确认事项"]}]}',
+            '',
+            '仓库事实：',
+            context,
+        ].join('\n');
+    }
+    return [
+        '你是知枢 KnowHub 的项目文档分析器。请只依据下面提供的仓库事实，生成 Repo Wiki 候选文档。',
+        ...strictRules(),
         '',
-        '需要生成的文档主题：' + topics.join('、'),
+        '需要生成的文档主题：' + planned.topics.join('、'),
+        '每个主题必须恰好生成一篇文档，标题与主题对应。',
+        '正文结构建议：先一段概述，再用小标题展开结构与要点；每篇 300-1200 字。',
         '输出 JSON 结构：',
         '{"documents":[{"title":"文档标题","kind":"wiki","tags":["标签"],"confidence":0.6,"sources":["相对路径"],"body":"Markdown 正文","uncertain":["待确认事项"]}]}',
-        'kind 只能是 wiki / decision / issue / todo 之一：架构、模块、总览、技术栈用 wiki；技术选型理由用 decision；已知问题用 issue；待确认事项用 todo。',
+        'kind 只能是 wiki：本轮只生成 Repo Wiki 文档。',
         '',
         '仓库事实：',
         context,
@@ -216,29 +301,34 @@ export async function runInitialize(deps) {
         if (!modelAvailable)
             throw new InitError('MODEL_NOT_AVAILABLE', '知识库绑定的模型已不可用（提供方 ' + kb.modelProvider + ' / 模型 ' + kb.modelId + '）。请在知识库设置中重新选择模型；插件不会自动改用其它模型。');
         log('info', '使用知识库绑定模型：' + kb.modelProvider + ' / ' + kb.modelId);
-        // 4) 按策略调用模型生成候选
+        // 4) 按策略调用模型生成候选（三条线分别规划，单线失败不拖垮整轮）
         const calls = planCalls(strategy);
-        const context = buildContext(index, strategy);
+        const keySnippets = await readKeyFileSnippets(root, index);
+        if (keySnippets.length > 0)
+            log('info', '已读取 ' + keySnippets.length + ' 个关键文件的内容摘录补强上下文');
+        const context = buildContext(index, strategy, keySnippets);
         const knownPaths = new Set(index.files.map((file) => file.path));
         const created = [];
         const conflicts = [];
         const rejected = [];
+        const callFailures = [];
         let documentsSeen = 0;
         const callSummaries = [];
         const secrets = { root, storageRoot };
-        currentStage = '生成 Wiki 候选';
+        currentStage = '生成知识候选';
         for (let position = 0; position < calls.length; position += 1) {
             const planned = calls[position];
             if (!planned)
                 continue;
             ensureNotAborted(signal);
             const percent = 40 + Math.round((position / calls.length) * 45);
-            progress(percent, '调用模型生成：' + planned.topics.join('、'));
-            const prompt = buildPrompt(planned.topics, context);
+            progress(percent, '调用模型生成' + AREA_LABELS[planned.area] + '：' + planned.topics.join('、'));
+            const prompt = buildPrompt(planned, context);
             log('info', '调用模型（' + planned.purpose + '，主题：' + planned.topics.join('、') + '，提示长度 ' + prompt.length + ' 字符）');
             // 推理模型可能把 token 预算耗在思考上导致输出被截断：识别出来并加倍预算重试一次。
             let budget = limits.maxTokens;
             let parsed = null;
+            let callFailure = null;
             for (let attempt = 1;; attempt += 1) {
                 ensureNotAborted(signal);
                 const result = await runModelCall(ctx, {
@@ -279,9 +369,28 @@ export async function runInitialize(deps) {
                     budget = nextBudget;
                     continue;
                 }
-                throw new InitError(output.code, output.message);
+                // 单条线的输出问题（截断重试后仍失败 / 结构不合法）只跳过本条线，其余线继续；
+                // 全部线都失败时在收尾处按优先级抛出最可操作的错误（见下方收尾判断）。
+                callFailure = { code: output.code, message: output.message };
+                break;
+            }
+            if (callFailure) {
+                callFailures.push({ purpose: planned.purpose, code: callFailure.code, message: callFailure.message });
+                log('warn', '本轮生成失败，已跳过（' + planned.purpose + '，' + callFailure.code + '）：' + callFailure.message);
+                continue;
+            }
+            let validated;
+            try {
+                validated = validateDocuments(parsed, knownPaths, secrets);
+            }
+            catch (validationError) {
+                if (validationError instanceof InitError && validationError.code === 'MODEL_OUTPUT_INVALID') {
+                    callFailures.push({ purpose: planned.purpose, code: validationError.code, message: validationError.message });
+                    log('warn', '本轮生成失败，已跳过（' + planned.purpose + '，' + validationError.code + '）：' + validationError.message);
+                    continue;
+                }
+                throw validationError;
             }
-            const validated = validateDocuments(parsed, knownPaths, secrets);
             rejected.push(...validated.rejected);
             documentsSeen += validated.documents.length;
             if (validated.rejected.length > 0)
@@ -322,11 +431,18 @@ export async function runInitialize(deps) {
                     run(db, 'INSERT INTO sources (id, doc_id, candidate_id, kind, ref, locator, excerpt_hash, verified, created_at) VALUES (?, ?, NULL, ?, ?, ?, ?, 1, ?)', [newId('src'), doc.id, 'file', source, candidate.title, contentHash(source).slice(0, 16), Date.now()]);
                 }
                 created.push({ id: doc.id, title: doc.title });
-                log('info', '已创建 Wiki 候选草稿「' + doc.title + '」（来源文件 ' + candidate.sources.length + ' 个，可信度 ' + candidate.confidence.toFixed(2) + '）');
+                log('info', '已创建候选草稿「' + doc.title + '」（来源文件 ' + candidate.sources.length + ' 个，可信度 ' + candidate.confidence.toFixed(2) + '）');
             }
         }
         if (created.length === 0 && conflicts.length === 0) {
-            throw new InitError('NO_DOCUMENT_CREATED', '本次没有创建任何 Wiki 候选（模型输出未通过校验）');
+            // 全部线都失败：优先报截断（有明确的换模型/升档建议），其次报输出不合法，最后才是无产出。
+            const truncatedFailure = callFailures.find((failure) => failure.code === 'MODEL_OUTPUT_TRUNCATED');
+            if (truncatedFailure)
+                throw new InitError('MODEL_OUTPUT_TRUNCATED', truncatedFailure.message);
+            const invalidFailure = callFailures.find((failure) => failure.code === 'MODEL_OUTPUT_INVALID');
+            if (invalidFailure)
+                throw new InitError('MODEL_OUTPUT_INVALID', invalidFailure.message);
+            throw new InitError('NO_DOCUMENT_CREATED', '本次没有创建任何知识候选（模型输出未通过校验）');
         }
         if (created.length === 0) {
             // 幂等重跑：模型给出的主题都已在库中（草稿或已批准）。不视为失败，也不覆盖任何已有知识。
@@ -343,6 +459,7 @@ export async function runInitialize(deps) {
             documents: created,
             conflicts,
             rejected,
+            failures: callFailures,
             index: { fileCount: index.fileCount, textFileCount: index.textFileCount, byLanguage: index.byLanguage.slice(0, 8), excludedDirs: index.excludedDirs, skippedSensitive: index.skippedSensitive, skippedSymlinks: index.skippedSymlinks, truncated: index.truncated },
             workspace: { id: workspace.id, title: workspace.title, path: root },
             finishedAt: new Date().toISOString(),
@@ -360,7 +477,7 @@ export async function runInitialize(deps) {
             updatedAt: summary.finishedAt,
         }, null, 2) + '\n');
         progress(100, '完成');
-        log('info', '初始化完成：候选文档 ' + created.length + ' 篇，冲突 ' + conflicts.length + ' 条，模型调用 ' + calls.length + ' 次');
+        log('info', '初始化完成：候选文档 ' + created.length + ' 篇，冲突 ' + conflicts.length + ' 条，模型调用 ' + calls.length + ' 次' + (callFailures.length > 0 ? '，其中 ' + callFailures.length + ' 条线生成失败已跳过' : ''));
         return { documents: created.length, conflicts: conflicts.length, files: index.fileCount, calls: calls.length, model: summary.model, purposes: calls.map((call) => call.purpose) };
     }
     catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-knowhub",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "description": "知枢 KnowHub — DSH 全局知识中心与项目长期记忆：知识库、Repo Wiki、审核与版本、增量更新、检索与上下文注入、自动提炼、备份恢复、中文面板",
   "license": "MIT",
   "type": "module",
@@ -52,7 +52,8 @@
     "cordis.patch.yml",
     "README.md",
     "LICENSE",
-    "assets"
+    "assets",
+    "skills"
   ],
   "devDependencies": {
     "@types/node": "^22.19.0",

package/skills/archify/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/skills/archify/LICENSE-MIT

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 tt-a1i (Archify)
+Copyright (c) 2025 Cocoon AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/archify/NOTICE

@@ -0,0 +1,26 @@
+Archify
+Copyright (c) 2026 tt-a1i (Archify)
+Copyright (c) 2025 Cocoon AI
+
+Archify is distributed under the Apache License, Version 2.0 (LICENSE),
+except where a file, package manifest, or third-party notice specifies otherwise.
+The separately versioned DeepSeek Harness adapter remains MIT; its bundled
+Skill retains the license of the immutable source selected in release.json.
+
+Code and contributions received under the MIT License through pre-transition
+commit 25cf37080fc8b1dbe758a4efc3935b55f3327083 remain available under their
+original terms. Previously published releases keep their existing licenses. The complete historical MIT
+copyright and permission notice is preserved in LICENSE-MIT. This transition
+does not revoke existing MIT grants or assert a new patent grant on behalf
+of historical contributors.
+
+Archify originated from Cocoon-AI/architecture-diagram-generator:
+https://github.com/Cocoon-AI/architecture-diagram-generator
+
+Third-party components retain their own licenses; see THIRD_PARTY_NOTICES.md
+and the license files beside those components. Names and logos do not imply
+official endorsement, and the software license grants no general trademark
+permission.
+
+These software licenses cover Archify's embedded runtime and templates, not
+ownership of a user's authored content, business data, or source repository.