ws-spec-kit 0.1.0-beta.0

package/dist/storage/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/storage/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,GAAW,EAAE,IAAc;IACtD,OAAO,CAAC,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW,EAAE,IAAc;IACzD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE;QAClD,GAAG;QACH,QAAQ,EAAE,MAAM;QAChB,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;KAC5B,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW;IAC9C,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW;IAC5C,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,wBAAwB,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAClF,CAAC"}

package/dist/storage/project-config.d.ts

@@ -0,0 +1,11 @@
+import type { AdditionalGlobalRoot } from "../registry/skills/types.js";
+export declare class ProjectConfigError extends Error {
+    readonly code: `WSSPEC_${string}`;
+    constructor(code: `WSSPEC_${string}`, message: string);
+}
+export declare function additionalGlobalRootsFromConfig(raw: unknown): AdditionalGlobalRoot[];
+export declare function portableProjectConfigText(raw: unknown): string;
+export declare function rebindAdditionalGlobalRoots(input: {
+    root: string;
+    rootIds: readonly string[];
+}): Promise<AdditionalGlobalRoot[]>;

package/dist/storage/project-config.js

@@ -0,0 +1,60 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { parse, stringify } from "yaml";
+import { validate } from "../schemas/index.js";
+export class ProjectConfigError extends Error {
+    code;
+    constructor(code, message) {
+        super(`${code}: ${message}`);
+        this.code = code;
+        this.name = "ProjectConfigError";
+    }
+}
+function record(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value) ? value : undefined;
+}
+export function additionalGlobalRootsFromConfig(raw) {
+    const source = validate("builtin.application-project-config.v1", raw);
+    const skills = record(source.skills);
+    const configured = skills?.additionalGlobalRoots;
+    if (configured === undefined)
+        return [];
+    const roots = configured.map((root) => ({ ...root }));
+    if (new Set(roots.map(({ id }) => id)).size !== roots.length) {
+        throw new ProjectConfigError("WSSPEC_PROJECT_CONFIG_INVALID", "附加 Global Skill 根 ID 不能重复。");
+    }
+    return roots;
+}
+export function portableProjectConfigText(raw) {
+    const source = structuredClone(validate("builtin.application-project-config.v1", raw));
+    const skills = record(source.skills);
+    const roots = additionalGlobalRootsFromConfig(source);
+    if (skills !== undefined && roots.length > 0) {
+        skills.additionalGlobalRoots = roots.map(({ id }) => ({ id }));
+    }
+    return stringify(validate("builtin.application-project-config-snapshot.v1", source), { lineWidth: 0 });
+}
+export async function rebindAdditionalGlobalRoots(input) {
+    if (input.rootIds.length === 0)
+        return [];
+    let configText;
+    try {
+        configText = await readFile(path.join(input.root, ".wsspec", "config.yaml"), "utf8");
+    }
+    catch (caught) {
+        if (caught.code === "ENOENT") {
+            throw new ProjectConfigError("WSSPEC_GLOBAL_ROOT_NOT_CONFIGURED", "当前 host 缺少 Global Skill 根绑定配置。");
+        }
+        throw caught;
+    }
+    const raw = parse(configText);
+    const configured = new Map(additionalGlobalRootsFromConfig(raw).map((root) => [root.id, root]));
+    return input.rootIds.map((id) => {
+        const root = configured.get(id);
+        if (root === undefined) {
+            throw new ProjectConfigError("WSSPEC_GLOBAL_ROOT_NOT_CONFIGURED", `当前 host 配置未绑定 Global Skill 根 ${id}。`);
+        }
+        return root;
+    });
+}
+//# sourceMappingURL=project-config.js.map

package/dist/storage/project-config.js.map

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

package/dist/storage/repository.d.ts

@@ -0,0 +1,14 @@
+import type { RepositoryId } from "../domain/ids.js";
+export interface RepositoryIdentity {
+    version: 1;
+    repositoryId: RepositoryId;
+    repositoryRoot: string;
+    commonDir: string;
+}
+export declare class RepositoryError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare function loadRepository(cwd: string): Promise<RepositoryIdentity>;
+export declare function isRepositoryInitialized(cwd: string): Promise<boolean>;
+export declare function initRepository(cwd: string): Promise<RepositoryIdentity>;

package/dist/storage/repository.js

@@ -0,0 +1,151 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { ulid } from "ulid";
+import { defaultProductPaths, defaultTestAssetPaths, testPathRules } from "../engine/tdd/types.js";
+import { parse, stringify } from "yaml";
+import { writeFileAtomic } from "./files.js";
+import { gitCommonDir, repositoryRoot } from "./git.js";
+export class RepositoryError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "RepositoryError";
+    }
+}
+const repositoryIdPattern = /^repo-[0-9A-HJKMNP-TV-Z]{26}$/;
+const artifactDraftIgnoreRule = ".acceptance/";
+async function ensureArtifactDraftIgnore(commonDir) {
+    const filename = path.join(commonDir, "info", "exclude");
+    let content = "";
+    try {
+        content = await readFile(filename, "utf8");
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+    }
+    const alreadyIgnored = content.split(/\r?\n/u)
+        .some((line) => line.trim() === artifactDraftIgnoreRule || line.trim() === `/${artifactDraftIgnoreRule}`);
+    if (alreadyIgnored)
+        return;
+    const separator = content === "" || content.endsWith("\n") ? "" : "\n";
+    await writeFileAtomic(filename, `${content}${separator}${artifactDraftIgnoreRule}\n`);
+}
+async function writeDefaultIfMissing(filename, content) {
+    try {
+        await readFile(filename, "utf8");
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+        await writeFileAtomic(filename, content);
+    }
+}
+async function readIdentityFile(root) {
+    const filename = path.join(root, ".wsspec", "repository.yaml");
+    let content;
+    try {
+        content = await readFile(filename, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            throw new RepositoryError("WSSPEC_REPOSITORY_NOT_INITIALIZED", "当前 Git 仓库尚未初始化 WSSpecKit。");
+        }
+        throw error;
+    }
+    const value = parse(content);
+    if (value.version !== 1 || typeof value.repositoryId !== "string" || !repositoryIdPattern.test(value.repositoryId)) {
+        throw new RepositoryError("WSSPEC_REPOSITORY_ID_INVALID", ".wsspec/repository.yaml 不符合 Work Item v1。 ");
+    }
+    if (Object.keys(value).some((key) => key !== "version" && key !== "repositoryId")) {
+        throw new RepositoryError("WSSPEC_REPOSITORY_ID_INVALID", ".wsspec/repository.yaml 包含未知字段。");
+    }
+    return { version: 1, repositoryId: value.repositoryId };
+}
+async function synchronizeCache(identity) {
+    const filename = path.join(identity.commonDir, "wsspec", "repository.json");
+    try {
+        const cached = JSON.parse(await readFile(filename, "utf8"));
+        if (cached.repositoryId !== identity.repositoryId) {
+            throw new RepositoryError("WSSPEC_REPOSITORY_ID_MISMATCH", "已提交仓库身份与 Git common-dir 缓存不一致。");
+        }
+        return;
+    }
+    catch (error) {
+        if (error instanceof RepositoryError)
+            throw error;
+        if (error.code !== "ENOENT")
+            throw error;
+    }
+    await writeFileAtomic(filename, `${JSON.stringify({ version: 1, repositoryId: identity.repositoryId, repositoryRoot: identity.repositoryRoot }, null, 2)}\n`);
+}
+export async function loadRepository(cwd) {
+    let root;
+    let commonDir;
+    try {
+        root = await repositoryRoot(cwd);
+        commonDir = await gitCommonDir(cwd);
+    }
+    catch {
+        throw new RepositoryError("WSSPEC_GIT_REPOSITORY_REQUIRED", "WSSpecKit 只能在 Git 仓库中运行。");
+    }
+    const file = await readIdentityFile(root);
+    const identity = { ...file, repositoryRoot: root, commonDir };
+    await synchronizeCache(identity);
+    return identity;
+}
+export async function isRepositoryInitialized(cwd) {
+    let root;
+    try {
+        root = await repositoryRoot(cwd);
+    }
+    catch {
+        throw new RepositoryError("WSSPEC_GIT_REPOSITORY_REQUIRED", "WSSpecKit 只能在 Git 仓库中运行。");
+    }
+    try {
+        await readIdentityFile(root);
+        return true;
+    }
+    catch (error) {
+        if (error instanceof RepositoryError && error.code === "WSSPEC_REPOSITORY_NOT_INITIALIZED")
+            return false;
+        throw error;
+    }
+}
+export async function initRepository(cwd) {
+    let root;
+    let commonDir;
+    try {
+        root = await repositoryRoot(cwd);
+        commonDir = await gitCommonDir(cwd);
+    }
+    catch {
+        throw new RepositoryError("WSSPEC_GIT_REPOSITORY_REQUIRED", "请先显式初始化 Git 仓库。");
+    }
+    await ensureArtifactDraftIgnore(commonDir);
+    const filename = path.join(root, ".wsspec", "repository.yaml");
+    try {
+        await readFile(filename, "utf8");
+        return loadRepository(root);
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+    }
+    const repositoryId = `repo-${ulid()}`;
+    await writeFileAtomic(filename, stringify({ version: 1, repositoryId }, { lineWidth: 0 }));
+    await writeDefaultIfMissing(path.join(root, ".wsspec", "config.yaml"), stringify({
+        version: 1,
+        testing: { pathRules: [...testPathRules], testAssetPaths: [...defaultTestAssetPaths], productPaths: [...defaultProductPaths] },
+    }, { lineWidth: 0 }));
+    await writeDefaultIfMissing(path.join(root, ".wsspec", "workflow.yaml"), stringify({
+        version: 1,
+        activeWorkflow: { ref: "builtin://workflows/feature-delivery", version: 1 },
+        profile: "auto",
+    }, { lineWidth: 0 }));
+    const identity = { version: 1, repositoryId, repositoryRoot: root, commonDir };
+    await synchronizeCache(identity);
+    return identity;
+}
+//# sourceMappingURL=repository.js.map

package/dist/storage/repository.js.map

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

package/dist/storage/work-items.d.ts

@@ -0,0 +1,77 @@
+import type { RepositoryId, WorkItemId } from "../domain/ids.js";
+import { type NormalizedRequirementSource } from "../registry/connectors/requirement-source.js";
+interface PromptSource {
+    type: "prompt";
+    content: string;
+}
+interface FileSource {
+    type: "file";
+    path: string;
+}
+interface ExternalSource {
+    type: "issue";
+    provider: string;
+    id: string;
+    url?: string;
+}
+type ExternalCapturedSource = Omit<NormalizedRequirementSource, "type"> & {
+    type: "github.issue" | "gitlab.issue" | "feishu.document";
+};
+export interface CreateWorkItemInput {
+    root: string;
+    workItemId: WorkItemId;
+    title: string;
+    source: PromptSource | FileSource | ExternalSource;
+    createdAt?: string;
+    capturedSource?: {
+        type: "prompt" | "file";
+        origin: string;
+        text: string;
+        contentDigest: string;
+    } | ExternalCapturedSource;
+    application?: {
+        workflowText: string;
+        configText: string;
+        worktreeRoot?: string;
+        branchPrefix?: string;
+    };
+}
+export interface WorkItem {
+    version: 1;
+    workItemId: WorkItemId;
+    repositoryId: RepositoryId;
+    title: string;
+    createdAt: string;
+    status: "active";
+    execution: {
+        worktree: string;
+        branch: string;
+        baselineRevision: string;
+        baselineTreeDigest: string;
+        workflowDigest: string;
+        configDigest: string;
+        schemaDigest: string;
+    };
+    source: {
+        type: NormalizedRequirementSource["type"];
+        artifactId: string;
+        snapshot: string;
+        contentDigest: string;
+        artifactDigest: string;
+    };
+    bindings: {
+        issue: null;
+        knowledge: null;
+    };
+}
+export declare class WorkItemError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare function createWorkItem(input: CreateWorkItemInput): Promise<WorkItem>;
+export declare function creationOwnerForWorkItem(item: WorkItem): string;
+export declare function rollbackCreatedWorkItem(input: {
+    root: string;
+    item: WorkItem;
+}): Promise<void>;
+export {};