@peterxiaoyang/superspec 0.1.13 → 0.1.14

package/dist/src/init_cli.js

@@ -1,5 +1,5 @@
 import { block, commandExists, GuardError, printDecision, reason, runCommand, openspec_cli_probe, parseDecisionOutputFormat, REQUIRED_OPENSPEC_MIN_VERSION, } from "./core.js";
-import { forced_openspec_install_plan, project_init, recommended_openspec_install_plan } from "./project_init.js";
+import { ensure_openspec_chinese_context, forced_openspec_install_plan, project_init, recommended_openspec_install_plan } from "./project_init.js";
 import { install_workflow, uninstall_workflow, update_workflow } from "./install_engine.js";
 import { homedir } from "node:os";
 import { resolve } from "node:path";
@@ -320,6 +320,11 @@ function run_init(args, scope) {
         summary = engineDecision(`${gatePrefix}_update`, targetRoot, update_workflow(targetRoot, { scope }), [
             scope === "project" ? "review *.new files for user-modified surfaces, then rerun superspec check check-init" : "review *.new files for user-modified user-level surfaces",
         ]);
+        if (scope === "project" && summary.allowed) {
+            const act = ensure_openspec_chinese_context(targetRoot);
+            if (Array.isArray(summary.actions))
+                summary.actions.push(act);
+        }
     }
     else if (scope === "user") {
         summary = engineDecision("user_install", targetRoot, install_workflow(targetRoot, { force: args.force, scope: "user" }), [

package/dist/src/packet_render.js

@@ -10,7 +10,7 @@ import { final_verification_evidences, index_evidence, live_pass, live_user_conf
 import { file_blob_sha, dirty_worktree_paths } from "./git.js";
 import { preset_upgrade_reasons, preset_upgrade_required_from_context } from "./archive.js";
 import { state_corrupt_reasons, state_stale_reasons } from "./state.js";
-import { parse_tasks, resolve_test_contract_command, splitList, task_apply_execution_surface, task_apply_execution_surface_reasons, test_contract_invariant_refs_by_test, } from "./tasks.js";
+import { parse_tasks, resolve_test_contract_command, splitList, task_apply_execution_surface, task_apply_execution_surface_reasons, tasks_structure_hash, test_contract_invariant_refs_by_test, } from "./tasks.js";
 import { APPLY_CODE_REVIEW_REPORT_REQUIRED_FIELDS, APPLY_EXECUTOR_REPORT_REQUIRED_FIELDS, APPLY_TEST_RUNNER_REPORT_REQUIRED_FIELDS, APPLY_VERIFIER_REPORT_REQUIRED_FIELDS, apply_worker_implementation_fingerprint, apply_worker_executor_input_ref_digest, apply_worker_protected_path_refs, compute_apply_worker_freshness, fingerprint_digest, fingerprint_matches, pinned_artifact_ref_reasons as shared_pinned_artifact_ref_reasons, pre_edit_evidence_ref_reasons, pre_edit_worker_test_run_reasons, read_pinned_artifact_json, worker_input_ref_digest, worker_test_run_reasons, } from "./apply_worker_chain.js";
 import { apply_worker_chain_lifecycle_state } from "./apply_worker_chain_lifecycle.js";
 import { PACKAGE_ROOT } from "./install_engine.js";
@@ -400,6 +400,14 @@ function workflow_packet(ctx, gateRaw, taskId) {
         diagnostic_command: gate_recheck_command(ctx.change, gate, taskId, true),
         must_read_refs: workflow_gate_refs(ctx, gate),
     };
+    // Surface tasks_structure_hash directly in the agent-facing packet so apply_isolation and
+    // scope_expansion human confirmations can be constructed without a second status/json detour
+    // or source-code inspection to find the current tasks.md structural fingerprint.
+    if (gate === "apply_ready" || gate === "task_edit" || gate === "task_complete" || gate === "task_reopen") {
+        const currentTasksStructureHash = tasks_structure_hash(ctx.changeRoot);
+        if (currentTasksStructureHash)
+            packet.tasks_structure_hash = currentTasksStructureHash;
+    }
     const cliSurfaces = openspec_cli_surfaces_for_gate(ctx.change, gate);
     if (cliSurfaces.length > 0)
         packet.openspec_cli_surfaces = cliSurfaces;

package/dist/src/packet_schema.d.ts

@@ -1,6 +1,6 @@
 export type PacketOutputFormat = "agent" | "prompt";
 export type PinnedRef = {
-    root: "repo" | "change";
+    root: "repo" | "change" | "superspec";
     path: string;
     blob_sha: string;
 };
@@ -19,6 +19,7 @@ export type WorkflowPacket = {
     current_gate: string;
     task_id?: string;
     status: "allowed" | "blocked";
+    tasks_structure_hash?: string;
     top_blockers?: string[];
     blocker_count?: number;
     has_more_blockers?: boolean;

package/dist/src/project_init.d.ts

@@ -1,4 +1,5 @@
 import { type JsonMap, type OpenspecCliProbe } from "./core.ts";
+import { type EngineAction } from "./install_engine.ts";
 export declare const OPENSPEC_NPM_PACKAGE = "@fission-ai/openspec";
 export declare const OPENSPEC_INSTALL_DOC_URL = "https://github.com/Fission-AI/OpenSpec#readme";
 export type OpenspecInstallPlan = {
@@ -26,6 +27,7 @@ export declare function openspec_cli_requirement_message(probe: OpenspecCliProbe
         cwd?: string;
     }) => boolean;
 }): string;
+export declare function ensure_openspec_chinese_context(repoRoot: string): EngineAction;
 export declare function project_init(repoRootRaw?: string, opts?: {
     force?: boolean;
 }): JsonMap;

package/dist/src/project_init.js

@@ -1,5 +1,5 @@
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
-import { join, resolve } from "node:path";
+import { dirname, join, resolve } from "node:path";
 import { REQUIRED_SUPERSPEC_AGENT_ROLES, REQUIRED_OPENSPEC_MIN_VERSION, block, commandExists, openspec_cli_probe, reason, read_agent_toml_name, } from "./core.js";
 import { install_workflow } from "./install_engine.js";
 export const OPENSPEC_NPM_PACKAGE = "@fission-ai/openspec";
@@ -136,9 +136,33 @@ function ensureSuperSpecWorkflow(repoRoot, actions, force) {
     }
     return result.problems;
 }
+const OPENSPEC_CONFIG_REL = "openspec/config.yaml";
+const ZH_CTX = '所有文档必须使用中文编写。需求描述应使用"应当"或"必须"等词汇。';
+export function ensure_openspec_chinese_context(repoRoot) {
+    const p = join(repoRoot, OPENSPEC_CONFIG_REL);
+    if (existsSync(p) && statSync(p).isFile()) {
+        const t = readFileSync(p, "utf8");
+        if (/context:[\s\S]*?所有文档必须使用中文/u.test(t))
+            return { action: `configure ${OPENSPEC_CONFIG_REL}`, status: "ok", detail: "OpenSpec 中文语境已存在" };
+        if (/^context:/mu.test(t)) {
+            const u = t.replace(/^context:\s*[|>]?\s*\n(?:[ \t].*\n)*/mu, `context: |\n  ${ZH_CTX}\n`);
+            mkdirSync(dirname(p), { recursive: true });
+            writeFileSync(p, u, "utf8");
+            return { action: `configure ${OPENSPEC_CONFIG_REL}`, status: "updated", detail: "OpenSpec context 已替换为简体中文语境" };
+        }
+        const s = t.endsWith("\n") ? "\ncontext: |\n" : "\n\ncontext: |\n";
+        mkdirSync(dirname(p), { recursive: true });
+        writeFileSync(p, `${t}${s}  ${ZH_CTX}\n`, "utf8");
+        return { action: `configure ${OPENSPEC_CONFIG_REL}`, status: "updated", detail: "OpenSpec context 已追加简体中文语境" };
+    }
+    mkdirSync(dirname(p), { recursive: true });
+    writeFileSync(p, `context: |\n  ${ZH_CTX}\n`, "utf8");
+    return { action: `configure ${OPENSPEC_CONFIG_REL}`, status: "created", detail: "OpenSpec 输出语言已设为简体中文" };
+}
 export function project_init(repoRootRaw = process.cwd(), opts = {}) {
     const repoRoot = resolve(repoRootRaw);
     const actions = [];
+    actions.push(ensure_openspec_chinese_context(repoRoot));
     const problems = [
         ...ensureOpenSpecCliSurface(repoRoot, actions),
         ...ensureSuperSpecWorkflow(repoRoot, actions, opts.force === true),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peterxiaoyang/superspec",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "description": "SuperSpec workflow package: guard runtime, generic workflow templates, and Codex adapter payload.",
   "repository": {
     "type": "git",

package/templates/workflow/skills/superspec-propose/SKILL.md

@@ -22,7 +22,7 @@ metadata:
 
 ## 阶段职责
 
-Propose 把 discovery 转成 OpenSpec proposal package，并补 SuperSpec 业务约束和测试契约。负责的文件是 `proposal.md`、`specs/**/*.md`、`design.md`、`tasks.md`、`.superspec/artifacts/business-invariants.md`、`.superspec/artifacts/test-contract.md`。本阶段不改实现代码。
+Propose 把 discovery 转成 OpenSpec proposal package，并按阶段生成 SuperSpec 业务约束和测试契约辅助文档。负责产出 `proposal.md`、`specs/**/*.md`、`design.md`、`tasks.md`，以及在需要时新建或更新 `.superspec/artifacts/business-invariants.md`、`.superspec/artifacts/test-contract.md`。本阶段不改实现代码。
 
 ## 第一条必跑命令
 
@@ -49,7 +49,10 @@ openspec instructions <artifact-id> --change "<change>" --json
 1. 运行 `openspec status --change "<change>" --json`，取 artifact 顺序、状态和 `resolvedOutputPath`。
 2. 每个 artifact（proposal/specs/design/tasks）运行 `openspec instructions <artifact-id> --change "<change>" --json`，取回 template/rules/context/instruction/dependencies。
 3. 先读 dependencies 列出的已完成 artifact，再按 template 写到 `resolvedOutputPath`；context/rules 是对作者的约束，不写进产出文件。
-4. sidecar（`.superspec/artifacts/business-invariants.md`、`.superspec/artifacts/test-contract.md`）用 SuperSpec 内置模板，写到 change 内 `.superspec/artifacts/`。
+4. 辅助文档（`.superspec/artifacts/business-invariants.md`、`.superspec/artifacts/test-contract.md`）如果尚不存在，就按 SuperSpec 内置模板在 change 内 `.superspec/artifacts/` 新建；已存在则基于当前阶段要求更新。
+5. `invariants_reviewed` 的 `workflow-packet` 会下发 `business_invariants_template` 与 `business_invariants_rules`；必须按该骨架直接填写，不得改成段落/列表。
+6. `test_contract_drafted` 的 `workflow-packet` 会下发 `test_contract_template` 与 `test_contract_rules`；必须按该骨架直接填写，不得改成段落/列表。
+7. `business-invariants.md` 的 `## Invariants` / `## Mapping` 和 `test-contract.md` 的 `## 测试覆盖矩阵` 必须保持 Markdown 表格，列名原样保留。
 
 ## Packet 驱动的阶段门