@captain_z/zsk 1.0.1 → 1.1.0

package/dist/core/config.js

@@ -0,0 +1,191 @@
+import { Ajv } from "ajv/dist/ajv.js";
+import { readFile, readdir, access, stat } from "node:fs/promises";
+import { isAbsolute, join, relative, resolve } from "node:path";
+import YAML from "yaml";
+import { resolveTemplatesRoot } from "./scaffolder.js";
+const PROJECT_SCHEMA = "zsk-config.schema.json";
+const MODULE_SCHEMA = "module.schema.json";
+export async function checkProjectConfig(target) {
+    const root = resolve(target);
+    const issues = [];
+    const projectFile = join(root, "zsk.config.yaml");
+    const project = await readYaml(projectFile, issues);
+    const projectSchema = await readSchema(root, PROJECT_SCHEMA);
+    validateWithSchema(projectFile, project, projectSchema, issues);
+    const projectConfig = isObject(project) ? project : {};
+    const moduleFiles = await findModuleConfigFiles(root, projectConfig);
+    const moduleSchema = await readSchema(root, MODULE_SCHEMA);
+    for (const file of moduleFiles) {
+        const moduleConfig = await readYaml(file, issues);
+        validateWithSchema(file, moduleConfig, moduleSchema, issues);
+        validateModuleBoundaries(root, projectConfig, file, moduleConfig, issues);
+    }
+    validateProjectBoundaries(root, projectConfig, projectFile, issues);
+    return {
+        ok: issues.length === 0,
+        issues,
+        project,
+        moduleFiles,
+    };
+}
+export async function readProjectConfig(target) {
+    const file = join(resolve(target), "zsk.config.yaml");
+    const content = await readFile(file, "utf8");
+    const parsed = YAML.parse(content);
+    return isObject(parsed) ? parsed : {};
+}
+export async function findModuleConfigFiles(root, projectConfig) {
+    const docsRoot = resolvePath(root, projectConfig.modules?.root ?? "docs");
+    try {
+        const entries = await readdir(docsRoot, { withFileTypes: true });
+        const files = [];
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            if (entry.name.startsWith("_"))
+                continue;
+            if (entry.name === "system")
+                continue;
+            const file = join(docsRoot, entry.name, "module.yaml");
+            if (await exists(file))
+                files.push(file);
+        }
+        return files.sort();
+    }
+    catch {
+        return [];
+    }
+}
+export function formatConfigIssues(issues) {
+    return issues
+        .map((issue) => `${issue.file}${issue.path ? ` ${issue.path}` : ""}: ${issue.message}`)
+        .join("\n");
+}
+async function readYaml(file, issues) {
+    try {
+        const content = await readFile(file, "utf8");
+        return YAML.parse(content);
+    }
+    catch (error) {
+        issues.push({
+            file,
+            path: "",
+            message: error instanceof Error ? error.message : String(error),
+        });
+        return null;
+    }
+}
+async function readSchema(root, name) {
+    const local = join(root, ".zsk", "schemas", name);
+    if (await exists(local))
+        return JSON.parse(await readFile(local, "utf8"));
+    const templatesRoot = await resolveTemplatesRoot();
+    const bundled = join(templatesRoot, "project-init", ".zsk", "schemas", name);
+    return JSON.parse(await readFile(bundled, "utf8"));
+}
+function validateWithSchema(file, data, schema, issues) {
+    const ajv = new Ajv({ allErrors: true, strict: false });
+    const validate = ajv.compile(schema);
+    if (validate(data))
+        return;
+    for (const error of validate.errors ?? []) {
+        issues.push({
+            file,
+            path: formatSchemaPath(error),
+            message: error.message ?? "schema validation failed",
+        });
+    }
+}
+function validateProjectBoundaries(root, config, file, issues) {
+    const raws = config.paths?.raws ?? ".raws";
+    const docs = config.paths?.docs ?? "docs";
+    const issueRoot = config.paths?.issues ?? ".issues";
+    validateRelativeInside(root, raws, file, "/paths/raws", issues);
+    validateRelativeInside(root, docs, file, "/paths/docs", issues);
+    validateRelativeInside(root, issueRoot, file, "/paths/issues", issues);
+    const rawRoot = resolvePath(root, raws);
+    for (const [name, source] of Object.entries(config.sources ?? {})) {
+        if (!source)
+            continue;
+        if (source.kind === "local" && source.path) {
+            validateUnder(root, source.path, rawRoot, file, `/sources/${name}/path`, issues);
+            continue;
+        }
+        if ((source.kind === "script" || source.kind === "skill") && source.output) {
+            validateUnder(root, source.output, rawRoot, file, `/sources/${name}/output`, issues);
+        }
+    }
+}
+function validateModuleBoundaries(root, projectConfig, file, moduleData, issues) {
+    if (!isObject(moduleData))
+        return;
+    const moduleConfig = moduleData;
+    const docsRoot = resolvePath(root, projectConfig.paths?.docs ?? "docs");
+    const issueRoot = resolvePath(root, projectConfig.paths?.issues ?? ".issues");
+    if (moduleConfig.outputs?.docs) {
+        validateUnder(root, moduleConfig.outputs.docs, docsRoot, file, "/outputs/docs", issues);
+    }
+    if (moduleConfig.outputs?.issues) {
+        validateUnder(root, moduleConfig.outputs.issues, issueRoot, file, "/outputs/issues", issues);
+    }
+}
+function validateRelativeInside(root, value, file, path, issues) {
+    if (isAbsolute(value))
+        return;
+    const target = resolve(root, value);
+    if (isInside(root, target))
+        return;
+    issues.push({
+        file,
+        path,
+        message: "relative path must stay inside the project root",
+    });
+}
+function validateUnder(root, value, expectedRoot, file, path, issues) {
+    const target = resolvePath(root, value);
+    if (isInside(expectedRoot, target))
+        return;
+    issues.push({
+        file,
+        path,
+        message: `path must stay under ${expectedRoot}`,
+    });
+}
+function resolvePath(root, value) {
+    return isAbsolute(value) ? value : resolve(root, value);
+}
+function isInside(root, target) {
+    const rel = relative(root, target);
+    return rel === "" || (!rel.startsWith("..") && !isAbsolute(rel));
+}
+function formatSchemaPath(error) {
+    const path = error.instancePath || "/";
+    if (error.keyword === "required" && typeof error.params === "object") {
+        const missing = error.params.missingProperty;
+        if (missing)
+            return `${path === "/" ? "" : path}/${missing}`;
+    }
+    return path;
+}
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function pathStat(path) {
+    try {
+        const info = await stat(path);
+        return { size: info.size };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/raw-manifest.d.ts

@@ -0,0 +1,21 @@
+export type RawResourceRecord = {
+    provider: string;
+    kind: string;
+    path?: string;
+    output?: string;
+    exists: boolean;
+    size: number | null;
+    hash: string | null;
+    syncedAt: string;
+    method: "local" | "script" | "skill" | "manual";
+};
+export type RawManifest = {
+    version: number;
+    resources: RawResourceRecord[];
+};
+export declare function updateRawManifest(file: string, records: RawResourceRecord[]): Promise<void>;
+export declare function describeResource(root: string, provider: string, source: {
+    kind?: string;
+    path?: string;
+    output?: string;
+}): Promise<RawResourceRecord>;

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@captain_z/zsk",
-  "version": "1.0.1",
+  "version": "1.1.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.1"
+    "@captain_z/zsk-skills": "1.1.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}/`.