@bovinphang/craft-common 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bovin Phang
+
+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/README.md

@@ -1,3 +1,13 @@
-# Temporary Holding Version
+# craft-common
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Craft AI Coding 的公共能力包，由 frontend-craft 和backend-craft 自动交付；用户无需手动安装第三个插件。
+
+公共能力使用 `cc-*` 标识。此仓库是公共 Skill、资源与方法的唯一维护来源，产品中的对应目录由固定版本生成并校验。
+
+开发要求 Node.js >=22 和 pnpm 12.4.1。使用 `pnpm install`、`pnpm lint`、`pnpm typecheck`、`pnpm test`、`pnpm build` 校验。
+
+提供可编辑 draw.io、结构化技术图表、源码核验、文档事实同步、诊断、行为保持重构和 TDD 七个公共入口，并包含对应的中英文内容及完整运行资源。
+
+共享安装协议以真实 Skill 目标定位消费者，检查精确版本、语言和内容摘要，在事务中更新产品文件与公共账本；卸载保留其他消费者及用户修改。原生插件双产品去重需另外按 Runtime 验证。
+
+消费和维护约定见[消费指南](docs/consuming-common.md)。公共包和前端 3.0 的公开发布仍是独立发布步骤，仓库中的本地验证不代表 npm registry 已有可下载版本。

package/dist/content/catalog.d.ts

@@ -0,0 +1,4 @@
+import type { ContentCatalog, InstallLanguage } from "./types.js";
+export type MethodName = "source-driven-development" | "doc-sync" | "debug" | "refactoring" | "tdd";
+export declare function readMethodResource(packageRoot: string, method: MethodName, language: InstallLanguage): Buffer;
+export declare function readContentCatalog(packageRoot: string, language: InstallLanguage): ContentCatalog;

package/dist/content/resources.d.ts

@@ -0,0 +1,2 @@
+import type { ContentFile } from "./types.js";
+export declare function collectSkillResources(skillRoot: string): ContentFile[];

package/dist/content/types.d.ts

@@ -0,0 +1,21 @@
+export type InstallLanguage = "en" | "zh-CN";
+export type ContentFile = {
+    relativePath: string;
+    hash: string;
+};
+export type SkillRecord = {
+    id: string;
+    version: string;
+    sourcePackage: string;
+    repository: string;
+    files: ContentFile[];
+};
+export type ContentCatalog = {
+    schemaVersion: 1;
+    packageName: "@bovinphang/craft-common";
+    packageVersion: string;
+    language: InstallLanguage;
+    root: string;
+    skills: SkillRecord[];
+    digest: string;
+};

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./content/types.js";
+export { readContentCatalog, readMethodResource, type MethodName, } from "./content/catalog.js";
+export { collectSkillResources } from "./content/resources.js";
+export * from "./install/types.js";
+export { resolveSharedIdentity } from "./install/identity.js";
+export { planSharedDeployment } from "./install/planner.js";
+export { executeSharedPlan, recoverSharedTransaction, } from "./install/transaction.js";