@captain_z/zsk 1.0.2 → 1.2.0

package/dist/core/raw-manifest.js

@@ -0,0 +1,53 @@
+import { createHash } from "node:crypto";
+import { readFile, writeFile, mkdir, stat } from "node:fs/promises";
+import { dirname, isAbsolute, resolve } from "node:path";
+export async function updateRawManifest(file, records) {
+    await mkdir(dirname(file), { recursive: true });
+    const manifest = {
+        version: 1,
+        resources: records,
+    };
+    await writeFile(file, `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
+}
+export async function describeResource(root, provider, source) {
+    const ref = source.path ?? source.output;
+    const fullPath = ref ? resolvePath(root, ref) : null;
+    const info = fullPath ? await safeStat(fullPath) : null;
+    return {
+        provider,
+        kind: source.kind ?? "local",
+        path: source.path,
+        output: source.output,
+        exists: Boolean(info),
+        size: info?.size ?? null,
+        hash: info && info.isFile ? await sha256(fullPath) : null,
+        syncedAt: new Date().toISOString(),
+        method: toMethod(source.kind),
+    };
+}
+function toMethod(kind) {
+    if (kind === "script")
+        return "script";
+    if (kind === "skill")
+        return "skill";
+    if (kind === "manual")
+        return "manual";
+    return "local";
+}
+async function safeStat(path) {
+    try {
+        const info = await stat(path);
+        return { size: info.size, isFile: info.isFile() };
+    }
+    catch {
+        return null;
+    }
+}
+async function sha256(path) {
+    const content = await readFile(path);
+    return createHash("sha256").update(content).digest("hex");
+}
+function resolvePath(root, value) {
+    return isAbsolute(value) ? value : resolve(root, value);
+}
+//# sourceMappingURL=raw-manifest.js.map

package/dist/core/raw-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-manifest.js","sourceRoot":"","sources":["../../src/core/raw-manifest.ts"],"names":[],"mappings":"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"}

package/dist/ui/prompts.d.ts

@@ -2,6 +2,7 @@ import { intro as clackIntro, outro as clackOutro, spinner as clackSpinner, note
 type Primitive = Readonly<string | boolean | number>;
 export declare function select<T extends Primitive>(message: string, options: Option<T>[], initialValue?: T): Promise<T>;
 export declare function groupMultiselect<T extends Primitive>(message: string, options: Record<string, Option<T>[]>, initialValues?: T[]): Promise<T[]>;
+export declare function multiselect<T extends Primitive>(message: string, options: Option<T>[], initialValues?: T[], maxItems?: number): Promise<T[]>;
 export declare function text(message: string, opts?: {
     placeholder?: string;
     validate?: (v: string) => string | undefined;

package/dist/ui/prompts.js

@@ -1,6 +1,6 @@
 // @clack/prompts wrappers with centralized isCancel handling.
 // All CLI interactive prompts go through this module so Ctrl+C is handled once.
-import { intro as clackIntro, outro as clackOutro, select as clackSelect, groupMultiselect as clackGroupMultiselect, confirm as clackConfirm, text as clackText, spinner as clackSpinner, note as clackNote, log, cancel, isCancel, } from "@clack/prompts";
+import { intro as clackIntro, outro as clackOutro, select as clackSelect, multiselect as clackMultiselect, groupMultiselect as clackGroupMultiselect, confirm as clackConfirm, text as clackText, spinner as clackSpinner, note as clackNote, log, cancel, isCancel, } from "@clack/prompts";
 function exitIfCancel(value) {
     if (isCancel(value)) {
         cancel("已取消");
@@ -22,6 +22,17 @@ export async function groupMultiselect(message, options, initialValues = []) {
     exitIfCancel(v);
     return v;
 }
+export async function multiselect(message, options, initialValues = [], maxItems = 12) {
+    const v = await clackMultiselect({
+        message,
+        options,
+        initialValues,
+        maxItems,
+        required: false,
+    });
+    exitIfCancel(v);
+    return v;
+}
 export async function text(message, opts = {}) {
     const v = await clackText({
         message,

package/dist/ui/prompts.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/ui/prompts.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,gFAAgF;AAEhF,OAAO,EACL,KAAK,IAAI,UAAU,EACnB,KAAK,IAAI,UAAU,EACnB,MAAM,IAAI,WAAW,EACrB,gBAAgB,IAAI,qBAAqB,EACzC,OAAO,IAAI,YAAY,EACvB,IAAI,IAAI,SAAS,EACjB,OAAO,IAAI,YAAY,EACvB,IAAI,IAAI,SAAS,EACjB,GAAG,EACH,MAAM,EACN,QAAQ,GAET,MAAM,gBAAgB,CAAC;AAIxB,SAAS,YAAY,CAAI,KAAiB;IACxC,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,CAAC,KAAK,CAAC,CAAC;QACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,OAAe,EACf,OAAoB,EACpB,YAAgB;IAEhB,MAAM,CAAC,GAAG,MAAM,WAAW,CAAI,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;IACnE,YAAY,CAAC,CAAC,CAAC,CAAC;IAChB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAe,EACf,OAAoC,EACpC,gBAAqB,EAAE;IAEvB,MAAM,CAAC,GAAG,MAAM,qBAAqB,CAAI;QACvC,OAAO;QACP,OAAO;QACP,aAAa;QACb,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IACH,YAAY,CAAC,CAAC,CAAC,CAAC;IAChB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,OAAe,EACf,OAGI,EAAE;IAEN,MAAM,CAAC,GAAG,MAAM,SAAS,CAAC;QACxB,OAAO;QACP,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC,CAAC;IACH,YAAY,CAAC,CAAC,CAAC,CAAC;IAChB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,OAAe,EACf,YAAY,GAAG,IAAI;IAEnB,MAAM,CAAC,GAAG,MAAM,YAAY,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;IACxD,YAAY,CAAC,CAAC,CAAC,CAAC;IAChB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,OAAO,EACL,UAAU,IAAI,KAAK,EACnB,UAAU,IAAI,KAAK,EACnB,YAAY,IAAI,OAAO,EACvB,SAAS,IAAI,IAAI,EACjB,GAAG,GACJ,CAAC"}
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/ui/prompts.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,gFAAgF;AAEhF,OAAO,EACL,KAAK,IAAI,UAAU,EACnB,KAAK,IAAI,UAAU,EACnB,MAAM,IAAI,WAAW,EACrB,WAAW,IAAI,gBAAgB,EAC/B,gBAAgB,IAAI,qBAAqB,EACzC,OAAO,IAAI,YAAY,EACvB,IAAI,IAAI,SAAS,EACjB,OAAO,IAAI,YAAY,EACvB,IAAI,IAAI,SAAS,EACjB,GAAG,EACH,MAAM,EACN,QAAQ,GAET,MAAM,gBAAgB,CAAC;AAIxB,SAAS,YAAY,CAAI,KAAiB;IACxC,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,CAAC,KAAK,CAAC,CAAC;QACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,OAAe,EACf,OAAoB,EACpB,YAAgB;IAEhB,MAAM,CAAC,GAAG,MAAM,WAAW,CAAI,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;IACnE,YAAY,CAAC,CAAC,CAAC,CAAC;IAChB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAe,EACf,OAAoC,EACpC,gBAAqB,EAAE;IAEvB,MAAM,CAAC,GAAG,MAAM,qBAAqB,CAAI;QACvC,OAAO;QACP,OAAO;QACP,aAAa;QACb,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IACH,YAAY,CAAC,CAAC,CAAC,CAAC;IAChB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAe,EACf,OAAoB,EACpB,gBAAqB,EAAE,EACvB,QAAQ,GAAG,EAAE;IAEb,MAAM,CAAC,GAAG,MAAM,gBAAgB,CAAI;QAClC,OAAO;QACP,OAAO;QACP,aAAa;QACb,QAAQ;QACR,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IACH,YAAY,CAAC,CAAC,CAAC,CAAC;IAChB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,OAAe,EACf,OAGI,EAAE;IAEN,MAAM,CAAC,GAAG,MAAM,SAAS,CAAC;QACxB,OAAO;QACP,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC,CAAC;IACH,YAAY,CAAC,CAAC,CAAC,CAAC;IAChB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,OAAe,EACf,YAAY,GAAG,IAAI;IAEnB,MAAM,CAAC,GAAG,MAAM,YAAY,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;IACxD,YAAY,CAAC,CAAC,CAAC,CAAC;IAChB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,OAAO,EACL,UAAU,IAAI,KAAK,EACnB,UAAU,IAAI,KAAK,EACnB,YAAY,IAAI,OAAO,EACvB,SAAS,IAAI,IAAI,EACjB,GAAG,GACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@captain_z/zsk",
-  "version": "1.0.2",
+  "version": "1.2.0",
   "description": "ZNorth Standard Kit — CLI installer for zsk skill bundles (npx @captain_z/zsk add)",
   "license": "MIT",
   "type": "module",
@@ -15,10 +15,11 @@
   ],
   "dependencies": {
     "@clack/prompts": "^0.9.0",
+    "ajv": "^8.17.1",
     "commander": "^12.1.0",
     "picocolors": "^1.1.1",
     "yaml": "^2.7.0",
-    "@captain_z/zsk-skills": "1.0.2"
+    "@captain_z/zsk-skills": "1.2.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",

package/templates/project-init/.issues/README.md

@@ -0,0 +1,26 @@
+# Issues
+
+`.issues/` stores local review findings, bug reports, screenshots, logs, reproduction evidence, and verification records created during project work.
+
+## Layout
+
+```text
+.issues/
+├── README.md
+├── _templates/
+│   └── issue.md
+└── {module}/
+    └── BUG-0001-short-slug/
+        ├── issue.md
+        ├── assets/
+        └── debug-logs/
+```
+
+## Rules
+
+- Keep one confirmed bug per `BUG-xxxx-short-slug/` directory.
+- Group related bugs under the same module directory.
+- Put bug-specific screenshots and runtime evidence under that bug's `assets/`.
+- Put bug-specific console logs, test output, and investigation logs under that bug's `debug-logs/`.
+- Do not place runtime screenshots, debug logs, or failed verification artifacts under `docs/`.
+- Do not place local verification artifacts under `.raws/`.

package/templates/project-init/.issues/_templates/issue.md

@@ -0,0 +1,44 @@
+# BUG-0000-short-description
+
+## Priority
+
+P1
+
+## Module
+
+`<module-id>`
+
+## Environment
+
+- Date: YYYY-MM-DD
+- Branch:
+- URL:
+- Command:
+- Browser:
+- Data source:
+
+## Reproduction Steps
+
+1. 
+
+## Actual Result
+
+
+## Expected Result
+
+
+## Logs And Evidence
+
+- `assets/<file>`:
+- `debug-logs/<file>`:
+
+## Impact
+
+
+## Root Cause / Hypothesis
+
+
+## Status
+
+- Status: Open
+- Retest:

package/templates/project-init/.raws/README.md

@@ -4,24 +4,26 @@
 
 ## 推荐内容
 
-| 文件 / 子目录 | 用途 | zsk skill 引用 |
+| 文件 / 子目录 | 用途 | zsk 配置入口 |
 | --- | --- | --- |
-| `SRS.md` | 原始需求文档（Software Requirements Spec） | `{{config.paths.srs}}` |
-| `FIGMA-INDEX.md` | 模块 → Figma URL / node-id 索引 | `{{config.paths.figma_index}}` |
-| `api-contracts/` | 后端 API 契约（OpenAPI / GraphQL schema） | `{{config.paths.api_contracts}}` |
-| `design-assets/{module}/{snapshot}/` | Figma 快照（由 `zsk:ue-mcp` 产出） | `{{config.paths.design_assets}}` |
+| `SRS.md` | 原始需求文档（Software Requirements Spec） | `zsk.config.yaml#sources.srs.path` |
+| `FIGMA-INDEX.md` | 模块 → Figma URL / node-id 索引 | `zsk.config.yaml#sources.figma_index.path` |
+| `api-contracts/` | 后端 API 契约（OpenAPI / GraphQL schema） | `zsk.config.yaml#sources.api_contracts.path` |
+| `design-assets/{module}/{snapshot}/` | Figma 快照（由 `zsk:ue-mcp` 产出） | `zsk.config.yaml#sources.design_assets.path` |
+| `testing/` | 原始测试用例、验收用例、提测测试包 | `docs/{module}/module.yaml` 的 `tests.raw_cases` |
+| `manifest.json` | 资源同步清单，由 `zsk prep` / `zsk sync` 维护 | N/A |
 
 ## 消费路径
 
-skill 通过 `project-config.md` frontmatter 的 `paths.*` 键找到本目录文件：
+skill 通过 `zsk.config.yaml` 和 `docs/{module}/module.yaml` 找到本目录文件：
 
 ```
-project-config.md:
-  paths:
-    srs: .raws/SRS.md
-    figma_index: .raws/FIGMA-INDEX.md
-    api_contracts: .raws/api-contracts
-    design_assets: .raws/design-assets
+zsk.config.yaml:
+  sources:
+    srs:
+      path: .raws/SRS.md
+    testing:
+      path: .raws/testing
 ```
 
 ## Git 状态建议
@@ -35,3 +37,4 @@ project-config.md:
 - **源文件不被 LLM 随意改写**：变更走人工/流程
 - **变更即新 snapshot**：Figma 更新→新 snapshot 目录，不覆盖历史
 - **编号锚稳定**：SRS 中的 `FR-001` / `US-001` / `AC-001` 一旦发布不改（仅废弃，合并/拆分留追踪）
+- **测试用例是一等资产**：原始测试用例保存在 `.raws/testing/`，派生测试矩阵和自动化映射写入 `docs/{module}/`

package/templates/project-init/.raws/api-contracts/README.md

@@ -0,0 +1,13 @@
+# API Contracts
+
+Store upstream API contracts here, grouped by service or provider.
+
+Recommended layout:
+
+```text
+.raws/api-contracts/
+└── {service}/
+    └── contracts/
+```
+
+Do not edit generated or upstream-owned contracts to match frontend assumptions. If a contract conflicts with SRS, test cases, or design assets, record an issue and resolve the decision in `docs/{module}/`.

package/templates/project-init/.raws/design-assets/README.md

@@ -0,0 +1,16 @@
+# Design Assets
+
+Store Figma, MCP, and design-source snapshots here.
+
+Recommended layout:
+
+```text
+.raws/design-assets/
+└── {module}/
+    └── {snapshot}/
+        ├── description.md
+        ├── screenshot-*.png
+        └── raw/
+```
+
+Treat each sync as a snapshot. Prefer adding a new snapshot over overwriting historical evidence.

package/templates/project-init/.raws/manifest.json

@@ -0,0 +1,4 @@
+{
+  "version": 1,
+  "resources": []
+}

package/templates/project-init/.raws/testing/README.md

@@ -0,0 +1,10 @@
+# Testing Sources
+
+Store original test assets here:
+
+- QA test cases
+- acceptance spreadsheets or exports
+- release test packs
+- manually supplied validation scenarios
+
+These are raw source facts. Derived scenario matrices and automated test mappings belong under `docs/{module}/`.

package/templates/project-init/.zsk/schemas/module.schema.json

@@ -0,0 +1,203 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://zsk.dev/schemas/module.schema.json",
+  "title": "ZSK Module Config",
+  "description": "Module-level resource, runtime, test, and output mapping for ZSK workflows.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["module", "sources", "tests", "outputs"],
+  "properties": {
+    "module": {
+      "description": "Module identity.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "description": "Stable module slug.",
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^[a-z0-9][a-z0-9-]*$"
+        },
+        "name": {
+          "description": "Human-readable module name.",
+          "type": "string",
+          "minLength": 1
+        },
+        "metadata": {
+          "$ref": "#/$defs/metadata"
+        }
+      }
+    },
+    "sources": {
+      "description": "Raw and derived resource inputs consumed by this module.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["testing"],
+      "properties": {
+        "srs": {
+          "$ref": "#/$defs/srsSource"
+        },
+        "api_contracts": {
+          "$ref": "#/$defs/pathList"
+        },
+        "testing": {
+          "$ref": "#/$defs/pathList"
+        },
+        "design_assets": {
+          "$ref": "#/$defs/pathList"
+        },
+        "figma": {
+          "$ref": "#/$defs/pathList"
+        },
+        "metadata": {
+          "$ref": "#/$defs/metadata"
+        }
+      }
+    },
+    "runtime": {
+      "description": "Optional runtime verification target.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["url"],
+      "properties": {
+        "url": {
+          "description": "Local or deployed URL used for runtime verification.",
+          "type": "string",
+          "minLength": 1
+        },
+        "tools": {
+          "description": "Preferred runtime verification tools.",
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/toolName"
+          },
+          "uniqueItems": true
+        },
+        "metadata": {
+          "$ref": "#/$defs/metadata"
+        }
+      }
+    },
+    "tests": {
+      "description": "Test asset mapping and TDD policy for this module.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["raw_cases", "derived_cases", "automated", "tdd_required"],
+      "properties": {
+        "raw_cases": {
+          "$ref": "#/$defs/pathList"
+        },
+        "derived_cases": {
+          "$ref": "#/$defs/pathList"
+        },
+        "automated": {
+          "description": "Executable test locations grouped by test level.",
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["unit", "integration", "e2e"],
+          "properties": {
+            "unit": {
+              "$ref": "#/$defs/pathList"
+            },
+            "integration": {
+              "$ref": "#/$defs/pathList"
+            },
+            "e2e": {
+              "$ref": "#/$defs/pathList"
+            },
+            "metadata": {
+              "$ref": "#/$defs/metadata"
+            }
+          }
+        },
+        "tdd_required": {
+          "description": "Whether AI coding must create/update failing tests before implementation.",
+          "type": "boolean"
+        },
+        "metadata": {
+          "$ref": "#/$defs/metadata"
+        }
+      }
+    },
+    "outputs": {
+      "description": "Module output locations for docs and issues.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["docs", "issues"],
+      "properties": {
+        "docs": {
+          "$ref": "#/$defs/pathRef"
+        },
+        "issues": {
+          "$ref": "#/$defs/pathRef"
+        },
+        "metadata": {
+          "$ref": "#/$defs/metadata"
+        }
+      }
+    },
+    "metadata": {
+      "$ref": "#/$defs/metadata"
+    }
+  },
+  "$defs": {
+    "pathRef": {
+      "description": "Project-relative path unless the value is intentionally absolute.",
+      "type": "string",
+      "minLength": 1
+    },
+    "pathList": {
+      "description": "List of project-relative paths or glob-like path patterns.",
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/pathRef"
+      },
+      "uniqueItems": true
+    },
+    "srsSource": {
+      "description": "SRS source path with optional section anchors.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path"],
+      "properties": {
+        "path": {
+          "$ref": "#/$defs/pathRef"
+        },
+        "sections": {
+          "description": "Relevant SRS sections for this module.",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "uniqueItems": true
+        },
+        "anchors": {
+          "description": "Stable raw-source anchors such as FR/AC IDs.",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "uniqueItems": true
+        },
+        "metadata": {
+          "$ref": "#/$defs/metadata"
+        }
+      }
+    },
+    "toolName": {
+      "description": "Known runtime/design verification tool.",
+      "type": "string",
+      "enum": ["computer_use", "browser_use", "figma_mcp", "script", "manual", "skill"]
+    },
+    "metadata": {
+      "description": "Explicit extension point for project-specific metadata.",
+      "type": "object",
+      "additionalProperties": {
+        "type": ["string", "number", "integer", "boolean", "null"]
+      }
+    }
+  }
+}