@captain_z/zsk 1.6.1 → 1.8.1

package/dist/core/raw-manifest.js

@@ -1,6 +1,6 @@
 import { createHash } from "node:crypto";
 import { readFile, writeFile, mkdir, stat } from "node:fs/promises";
-import { dirname, isAbsolute, resolve } from "node:path";
+import { dirname, isAbsolute, relative, resolve } from "node:path";
 export async function updateRawManifest(file, records) {
     await mkdir(dirname(file), { recursive: true });
     const manifest = {
@@ -9,6 +9,24 @@ export async function updateRawManifest(file, records) {
     };
     await writeFile(file, `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
 }
+export async function updateRawIndex(file, records) {
+    await mkdir(dirname(file), { recursive: true });
+    const rows = records.map((record) => {
+        const target = record.snapshot ?? record.output ?? record.sourcePath ?? describeOrigin(record.origin) ?? "";
+        return `| ${record.provider} | ${record.type} | ${record.status ?? record.method} | ${target} |`;
+    });
+    const content = [
+        "# Raw Source Index",
+        "",
+        "Immutable fact sources for this project. Generated by `zsk prep`.",
+        "",
+        "| Provider | Type | Status | Snapshot / Origin |",
+        "| --- | --- | --- | --- |",
+        rows.length > 0 ? rows.join("\n") : "|  |  |  |  |",
+        "",
+    ].join("\n");
+    await writeFile(file, content, "utf8");
+}
 export async function describeResource(root, provider, source) {
     const ref = source.snapshot ?? source.path ?? source.output ?? source.origin?.path;
     const fullPath = ref ? resolvePath(root, ref) : null;
@@ -20,6 +38,7 @@ export async function describeResource(root, provider, source) {
         origin: source.origin,
         snapshot: source.snapshot,
         output: source.output,
+        status: "configured",
         exists: Boolean(info),
         size: info?.size ?? null,
         hash: info && info.isFile ? await sha256(fullPath) : null,
@@ -27,6 +46,28 @@ export async function describeResource(root, provider, source) {
         method: toMethod(source),
     };
 }
+export async function describeDiscoveredResource(root, provider, type, path, status, note) {
+    const fullPath = resolvePath(root, path);
+    const info = await safeStat(fullPath);
+    return {
+        provider,
+        type,
+        originKind: "local",
+        origin: { kind: "local", path },
+        sourcePath: path,
+        status,
+        exists: Boolean(info),
+        size: info?.size ?? null,
+        hash: info && info.isFile ? await sha256(fullPath) : null,
+        syncedAt: new Date().toISOString(),
+        method: "local",
+        note,
+    };
+}
+export function projectRelative(root, path) {
+    const rel = relative(root, path);
+    return rel === "" || rel.startsWith("..") ? path : rel;
+}
 function toMethod(source) {
     if (source.kind === "script")
         return "script";
@@ -58,4 +99,10 @@ async function sha256(path) {
 function resolvePath(root, value) {
     return isAbsolute(value) ? value : resolve(root, value);
 }
+function describeOrigin(origin) {
+    if (!origin || typeof origin !== "object")
+        return null;
+    const value = origin;
+    return value.path ?? value.url ?? value.repository ?? value.note ?? null;
+}
 //# sourceMappingURL=raw-manifest.js.map

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

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

package/dist/core/scaffolder.js

@@ -40,14 +40,16 @@ export async function scaffoldTemplate(templateSubpath, target, opts = {}) {
 }
 async function copyRecursive(src, dst, overwrite, result, variables) {
     const entries = await readdir(src, { withFileTypes: true });
-    await mkdir(dst, { recursive: true });
+    let hasTemplateFile = false;
     for (const e of entries) {
         const srcPath = join(src, e.name);
         const dstPath = join(dst, applyTemplateVariables(e.name, variables));
         if (e.isDirectory()) {
-            await copyRecursive(srcPath, dstPath, overwrite, result, variables);
+            hasTemplateFile = (await copyRecursive(srcPath, dstPath, overwrite, result, variables)) || hasTemplateFile;
         }
         else {
+            hasTemplateFile = true;
+            await mkdir(dst, { recursive: true });
             if (!overwrite && (await fileExists(dstPath))) {
                 result.skipped.push(dstPath);
                 continue;
@@ -57,6 +59,7 @@ async function copyRecursive(src, dst, overwrite, result, variables) {
             result.written.push(dstPath);
         }
     }
+    return hasTemplateFile;
 }
 function applyTemplateVariables(value, variables) {
     let next = value;

package/dist/core/scaffolder.js.map

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

package/dist/core/workspace-layout.d.ts

@@ -0,0 +1,53 @@
+export declare const WORKSPACE_LAYOUT_VERSION = 2;
+export declare const DEFAULT_WORKSPACE_PATHS: {
+    readonly docs: ".zsk/docs";
+    readonly modules: ".zsk/modules";
+    readonly raws: ".zsk/raws";
+    readonly resources: ".zsk/resources";
+    readonly issues: ".zsk/issues";
+    readonly evidence: ".zsk/evidence";
+    readonly playwright: ".zsk/playwright";
+};
+export type WorkspaceLayoutConfig = {
+    paths?: {
+        docs?: string;
+        modules?: string;
+        resources?: string;
+        issues?: string;
+        evidence?: string;
+        playwright?: string;
+        plans?: string;
+        raws?: string;
+    };
+    modules?: {
+        index?: string;
+        root?: string;
+    };
+    automation?: {
+        demo?: {
+            evidenceDir?: string;
+            scenarioDir?: string;
+            bridge?: {
+                planFile?: string;
+                executionFile?: string;
+            };
+        };
+    };
+};
+export type WorkspaceLayout = {
+    version: number;
+    docsRoot: string;
+    modulesRoot: string;
+    resourcesRoot: string;
+    issuesRoot: string;
+    evidenceRoot: string;
+    playwrightRoot: string;
+};
+export type WorkspacePathKind = "config" | "workflowState" | "mcpPlaywrightConfig" | "docsRoot" | "projectConfig" | "systemSpec" | "modulesRoot" | "moduleIndex" | "moduleRoot" | "moduleConfig" | "moduleRuns" | "resourcesRoot" | "resourcesTesting" | "resourcesManifest" | "rawsRoot" | "rawsTesting" | "rawsManifest" | "issuesRoot" | "moduleIssues" | "evidenceRoot" | "moduleEvidence" | "demoEvidence" | "playwrightRoot" | "modulePlaywright" | "playwrightSpecs" | "playwrightTestPlans" | "playwrightAuth" | "playwrightAuthState" | "playwrightResults" | "playwrightReport" | "playwrightExecution" | "demoSessionCurrent" | "bridgeOperationPlan" | "bridgeExecution";
+export type WorkspacePathOptions = {
+    module?: string;
+};
+export declare function resolveWorkspaceLayout(config?: WorkspaceLayoutConfig): WorkspaceLayout;
+export declare function getWorkspacePath(config: WorkspaceLayoutConfig, kind: WorkspacePathKind, options?: WorkspacePathOptions): string;
+export declare function resolveWorkspacePath(root: string, config: WorkspaceLayoutConfig, kind: WorkspacePathKind, options?: WorkspacePathOptions): string;
+export declare function interpolateModulePath(value: string, moduleId: string): string;

package/dist/core/workspace-layout.js

@@ -0,0 +1,108 @@
+import { isAbsolute, join, resolve } from "node:path";
+export const WORKSPACE_LAYOUT_VERSION = 2;
+export const DEFAULT_WORKSPACE_PATHS = {
+    docs: ".zsk/docs",
+    modules: ".zsk/modules",
+    raws: ".zsk/raws",
+    resources: ".zsk/resources",
+    issues: ".zsk/issues",
+    evidence: ".zsk/evidence",
+    playwright: ".zsk/playwright",
+};
+export function resolveWorkspaceLayout(config = {}) {
+    const paths = config.paths ?? {};
+    const rawsRoot = paths.raws ?? paths.resources ?? DEFAULT_WORKSPACE_PATHS.raws;
+    return {
+        version: WORKSPACE_LAYOUT_VERSION,
+        docsRoot: paths.docs ?? DEFAULT_WORKSPACE_PATHS.docs,
+        modulesRoot: paths.modules ?? config.modules?.root ?? DEFAULT_WORKSPACE_PATHS.modules,
+        resourcesRoot: rawsRoot,
+        issuesRoot: paths.issues ?? DEFAULT_WORKSPACE_PATHS.issues,
+        evidenceRoot: paths.evidence ?? DEFAULT_WORKSPACE_PATHS.evidence,
+        playwrightRoot: paths.playwright ?? DEFAULT_WORKSPACE_PATHS.playwright,
+    };
+}
+export function getWorkspacePath(config, kind, options = {}) {
+    const layout = resolveWorkspaceLayout(config);
+    const moduleId = options.module;
+    switch (kind) {
+        case "config":
+            return join(".zsk", "config.yaml");
+        case "workflowState":
+            return join(".zsk", "workflow-state.json");
+        case "mcpPlaywrightConfig":
+            return join(".zsk", "mcp", "playwright.json");
+        case "docsRoot":
+            return layout.docsRoot;
+        case "projectConfig":
+            return join(layout.docsRoot, "PROJECT-CONFIG.md");
+        case "systemSpec":
+            return join(layout.docsRoot, "SYSTEM-SPEC.md");
+        case "modulesRoot":
+            return layout.modulesRoot;
+        case "moduleIndex":
+            return config.modules?.index ?? join(layout.modulesRoot, "_module-index.md");
+        case "moduleRoot":
+            return join(layout.modulesRoot, requireModuleId(kind, moduleId));
+        case "moduleConfig":
+            return join(layout.modulesRoot, requireModuleId(kind, moduleId), "module.yaml");
+        case "moduleRuns":
+            return join(layout.modulesRoot, requireModuleId(kind, moduleId), "runs");
+        case "rawsRoot":
+        case "resourcesRoot":
+            return layout.resourcesRoot;
+        case "rawsTesting":
+        case "resourcesTesting":
+            return join(layout.resourcesRoot, "qa", "testing");
+        case "rawsManifest":
+        case "resourcesManifest":
+            return join(layout.resourcesRoot, "manifest.json");
+        case "issuesRoot":
+            return layout.issuesRoot;
+        case "moduleIssues":
+            return join(layout.modulesRoot, requireModuleId(kind, moduleId), "_issues");
+        case "evidenceRoot":
+            return layout.evidenceRoot;
+        case "moduleEvidence":
+            return join(layout.modulesRoot, requireModuleId(kind, moduleId), "_evidence");
+        case "demoEvidence":
+            return join(layout.modulesRoot, requireModuleId(kind, moduleId), "_evidence", "demo");
+        case "playwrightRoot":
+            return layout.playwrightRoot;
+        case "modulePlaywright":
+            return join(layout.modulesRoot, requireModuleId(kind, moduleId), "_playwright");
+        case "playwrightSpecs":
+            return join(layout.modulesRoot, requireModuleId(kind, moduleId), "_playwright", "specs");
+        case "playwrightTestPlans":
+            return join(layout.modulesRoot, requireModuleId(kind, moduleId), "_playwright", "test-plans");
+        case "playwrightAuth":
+            return join(layout.modulesRoot, requireModuleId(kind, moduleId), "_playwright", ".auth");
+        case "playwrightAuthState":
+            return join(layout.modulesRoot, requireModuleId(kind, moduleId), "_playwright", ".auth", "user.json");
+        case "playwrightResults":
+            return join(layout.modulesRoot, requireModuleId(kind, moduleId), "_playwright", "results");
+        case "playwrightReport":
+            return join(layout.modulesRoot, requireModuleId(kind, moduleId), "_playwright", "report");
+        case "playwrightExecution":
+            return join(layout.modulesRoot, requireModuleId(kind, moduleId), "_playwright", "execution");
+        case "demoSessionCurrent":
+            return join(layout.modulesRoot, requireModuleId(kind, moduleId), "_playwright", "execution", "current.json");
+        case "bridgeOperationPlan":
+            return join(layout.modulesRoot, requireModuleId(kind, moduleId), "_playwright", "execution", "operation-plan.json");
+        case "bridgeExecution":
+            return join(layout.modulesRoot, requireModuleId(kind, moduleId), "_playwright", "execution", "playwright-execution.json");
+    }
+}
+export function resolveWorkspacePath(root, config, kind, options = {}) {
+    const workspacePath = getWorkspacePath(config, kind, options);
+    return isAbsolute(workspacePath) ? workspacePath : resolve(root, workspacePath);
+}
+export function interpolateModulePath(value, moduleId) {
+    return value.split("{module}").join(moduleId);
+}
+function requireModuleId(kind, moduleId) {
+    if (moduleId)
+        return moduleId;
+    throw new Error(`${kind} requires a module id`);
+}
+//# sourceMappingURL=workspace-layout.js.map

package/dist/core/workspace-layout.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@captain_z/zsk",
-  "version": "1.6.1",
+  "version": "1.8.1",
   "description": "ZNorth Standard Kit — CLI installer for zsk skill bundles (npx @captain_z/zsk add)",
   "license": "MIT",
   "type": "module",
@@ -20,7 +20,7 @@
     "commander": "^12.1.0",
     "picocolors": "^1.1.1",
     "yaml": "^2.7.0",
-    "@captain_z/zsk-skills": "1.6.1"
+    "@captain_z/zsk-skills": "1.8.1"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",

package/schemas/zsk-config.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://unpkg.com/@captain_z/zsk/schemas/zsk-config.schema.json",
   "title": "ZSK Project Config",
-  "description": "Project-level configuration for ZSK resource origins, workspace paths, tools, and module index locations.",
+      "description": "Project-level configuration for ZSK raw source origins, workspace paths, tools, and module index locations.",
   "type": "object",
   "additionalProperties": false,
   "required": ["project", "paths", "sources", "tools", "modules"],
@@ -28,28 +28,55 @@
         }
       }
     },
+    "layoutVersion": {
+      "description": "Workspace layout version. Version 2 keeps all zsk-managed outputs under .zsk/ by default and prefers paths.raws for fact sources.",
+      "type": "integer",
+      "minimum": 2
+    },
     "paths": {
       "description": "Top-level project knowledge workspace paths.",
       "type": "object",
       "additionalProperties": false,
-      "required": ["raws", "docs", "issues"],
+      "required": ["docs", "modules", "issues", "evidence", "playwright"],
+      "anyOf": [
+        {
+          "required": ["raws"]
+        },
+        {
+          "required": ["resources"]
+        }
+      ],
       "properties": {
-        "raws": {
+        "docs": {
           "$ref": "#/$defs/pathRef"
         },
-        "docs": {
+        "modules": {
+          "$ref": "#/$defs/pathRef"
+        },
+        "resources": {
+          "description": "Deprecated compatibility alias for paths.raws.",
+          "$ref": "#/$defs/pathRef"
+        },
+        "raws": {
+          "description": "Preferred immutable raw fact-source root.",
           "$ref": "#/$defs/pathRef"
         },
         "issues": {
           "$ref": "#/$defs/pathRef"
         },
+        "evidence": {
+          "$ref": "#/$defs/pathRef"
+        },
+        "playwright": {
+          "$ref": "#/$defs/pathRef"
+        },
         "metadata": {
           "$ref": "#/$defs/metadata"
         }
       }
     },
     "sources": {
-      "description": "Project-level resource origins. May be empty after init and filled by AI or zsk config setup.",
+      "description": "Project-level raw source origins. May be empty after init and filled by AI or zsk config setup.",
       "type": "object",
       "additionalProperties": {
         "$ref": "#/$defs/sourceRef"
@@ -75,7 +102,7 @@
           "uniqueItems": true
         },
         "design": {
-          "description": "Preferred tools for design and Figma resource capture.",
+          "description": "Preferred tools for design source and asset capture.",
           "type": "array",
           "items": {
             "$ref": "#/$defs/toolName"
@@ -121,7 +148,7 @@
           "properties": {
             "defaultMode": {
               "type": "string",
-              "enum": ["manual", "script", "playwright", "computer-use", "hybrid"]
+              "enum": ["manual", "script", "optimized", "playwright", "computer-use", "hybrid"]
             },
             "baseUrl": {
               "type": "string",
@@ -204,7 +231,7 @@
       }
     },
     "sync": {
-      "description": "Optional deterministic or AI-assisted raw resource sync configuration.",
+      "description": "Optional deterministic or AI-assisted raw source sync configuration.",
       "type": "object",
       "additionalProperties": {
         "$ref": "#/$defs/syncRef"
@@ -247,12 +274,12 @@
       }
     },
     "sourceType": {
-      "description": "Resource role.",
+      "description": "Raw source role.",
       "type": "string",
       "enum": ["srs", "prd", "design", "api_contract", "backend_repo", "test_case", "design_asset", "vendor_doc", "manual"]
     },
     "sourceRef": {
-      "description": "Resource source reference.",
+      "description": "Raw source reference.",
       "type": "object",
       "additionalProperties": false,
       "required": ["type", "origin"],
@@ -289,9 +316,18 @@
         {
           "$ref": "#/$defs/modaoOrigin"
         },
+        {
+          "$ref": "#/$defs/designOrigin"
+        },
         {
           "$ref": "#/$defs/openapiOrigin"
         },
+        {
+          "$ref": "#/$defs/jiraOrigin"
+        },
+        {
+          "$ref": "#/$defs/srsOrigin"
+        },
         {
           "$ref": "#/$defs/manualOrigin"
         }
@@ -339,7 +375,7 @@
       "properties": {
         "kind": {
           "type": "string",
-          "const": "git"
+          "enum": ["git", "git-submodule"]
         },
         "repository": {
           "type": "string",
@@ -401,6 +437,35 @@
         }
       }
     },
+    "designOrigin": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "provider"],
+      "properties": {
+        "kind": {
+          "type": "string",
+          "const": "design"
+        },
+        "provider": {
+          "type": "string",
+          "minLength": 1
+        },
+        "url": {
+          "type": "string",
+          "minLength": 1
+        },
+        "path": {
+          "$ref": "#/$defs/pathRef"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "metadata": {
+          "$ref": "#/$defs/metadata"
+        }
+      }
+    },
     "openapiOrigin": {
       "type": "object",
       "additionalProperties": false,
@@ -430,6 +495,71 @@
         }
       ]
     },
+    "jiraOrigin": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind"],
+      "properties": {
+        "kind": {
+          "type": "string",
+          "const": "jira"
+        },
+        "url": {
+          "type": "string",
+          "minLength": 1
+        },
+        "path": {
+          "$ref": "#/$defs/pathRef"
+        },
+        "jql": {
+          "type": "string",
+          "minLength": 1
+        },
+        "metadata": {
+          "$ref": "#/$defs/metadata"
+        }
+      },
+      "anyOf": [
+        {
+          "required": ["url"]
+        },
+        {
+          "required": ["path"]
+        },
+        {
+          "required": ["jql"]
+        }
+      ]
+    },
+    "srsOrigin": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind"],
+      "properties": {
+        "kind": {
+          "type": "string",
+          "const": "srs"
+        },
+        "url": {
+          "type": "string",
+          "minLength": 1
+        },
+        "path": {
+          "$ref": "#/$defs/pathRef"
+        },
+        "metadata": {
+          "$ref": "#/$defs/metadata"
+        }
+      },
+      "anyOf": [
+        {
+          "required": ["url"]
+        },
+        {
+          "required": ["path"]
+        }
+      ]
+    },
     "manualOrigin": {
       "type": "object",
       "additionalProperties": false,

package/templates/issue/default/issue.md

@@ -4,6 +4,10 @@
 
 __ISSUE_TYPE__
 
+## 作用域
+
+__ISSUE_SCOPE__
+
 ## 问题级别
 
 __SEVERITY__
@@ -62,11 +66,11 @@ __SEVERITY__
 ## Documentation Feedback
 
 - 需要反哺的文档：
-  - [ ] `docs/{module}/spec.md`
-  - [ ] `docs/{module}/design.md`
-  - [ ] `docs/{module}/tasks.md`
-  - [ ] `docs/SYSTEM-SPEC.md`
-  - [ ] `.zsk/learning/proposals`
+  - [ ] `.zsk/modules/{module}/spec.md`
+  - [ ] `.zsk/modules/{module}/design.md`
+  - [ ] `.zsk/modules/{module}/tasks.md`
+  - [ ] `.zsk/docs/SYSTEM-SPEC.md`
+  - [ ] `.zsk/raws`
 - 更新内容或 no-update rationale：
 - 反哺时机：修复通过 verify 且经用户/产品确认后执行
 

package/templates/module/frontend-module/design.md

@@ -1,5 +1,26 @@
 # __MODULE_NAME__ Design
 
+## Implementation Map
+
+| Requirement / AC | Surface | Files / Modules | Interface / State / Data Flow | Risk |
+| --- | --- | --- | --- | --- |
+| FR-001 / AC-001 |  |  |  |  |
+
+## Decisions
+
+| Decision | Alternatives Rejected | Rationale / Evidence | Rollback / Migration Note |
+| --- | --- | --- | --- |
+|  |  |  |  |
+
+## States And Failure Modes
+
+| State | User/System Observable Behavior | Test / Demo Evidence |
+| --- | --- | --- |
+| loading |  |  |
+| empty |  |  |
+| error |  |  |
+| permission |  |  |
+
 ## Playwright Locator And State Strategy
 
 | Scenario | Page / Route | Preferred Locator Strategy | State Coverage | API / Mock | Auth / Storage | Evidence |
@@ -11,6 +32,7 @@ Guidelines:
 - Prefer user-facing locators: `getByRole`, `getByLabel`, `getByPlaceholder`, `getByTestId`.
 - Add implementation tasks for missing accessible names, labels, or stable test ids.
 - Define auth/storage reuse before demo so Playwright can run repeatably.
+- Route unclear behavior back to spec instead of redesigning requirements here.
 
 ## Documentation Feedback
 

package/templates/module/frontend-module/module.yaml

@@ -9,19 +9,20 @@ sources: {}
 runtime:
   url: http://localhost:3000
   tools:
-    - playwright_mcp
+    - playwright_cli
     - playwright
     - computer_use
     - browser_use
 
 tests:
   raw_cases: []
-  derived_cases: []
+  derived_cases:
+    - __PLAYWRIGHT_TEST_PLANS__/test-plan.json
   automated:
     unit: []
     integration: []
     e2e:
-      - __DOCS_OUTPUT__/scenarios
+      - __PLAYWRIGHT_SPECS__
   tdd_required: true
 
 outputs: