@blxzer/cursor-trellis 0.1.0

package/dist/utils/workflow-resolver.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Workflow template resolver.
+ *
+ * Centralizes how `trellis init --workflow` and `trellis workflow` discover and
+ * fetch workflow.md content. Reuses `template-fetcher` helpers for registry
+ * parsing, index probing, and git/http transport. The `native` workflow is a
+ * virtual entry resolved directly from the bundled `workflowMdTemplate` to
+ * avoid a duplicate file on disk that could drift out of sync.
+ *
+ * Boundary: command-layer callers (init.ts, commands/workflow.ts) should NOT
+ * touch raw marketplace structures. They go through `resolveWorkflowTemplate`
+ * and `listWorkflowTemplates` only.
+ */
+/**
+ * The id used to refer to the bundled native workflow.
+ *
+ * Treated as Trellis-managed for hash-tracking: when this id is selected by
+ * `init --workflow` or `trellis workflow`, `.trellis/workflow.md` stays in
+ * `.template-hashes.json`. Any other id is user-managed local workflow and
+ * must be removed from the hash file (the durable-state contract in
+ * design.md "Durable-state contract").
+ */
+export declare const NATIVE_WORKFLOW_ID = "native";
+/**
+ * Resolved workflow template entry.
+ *
+ * `content` is the workflow.md body bytes (LF-normalized in storage).
+ * `path` is the marketplace-relative path for remote entries, or
+ *   `bundled:trellis/workflow.md` for the native virtual entry.
+ */
+export interface ResolvedWorkflowTemplate {
+    id: string;
+    type: "workflow";
+    name: string;
+    description?: string;
+    path: string;
+    content: string;
+    /** Where the content came from (for error messages). */
+    source: "bundled" | "marketplace";
+}
+/**
+ * Workflow template listing (metadata only, no content).
+ */
+export interface WorkflowTemplateListing {
+    id: string;
+    type: "workflow";
+    name: string;
+    description?: string;
+    path: string;
+    source: "bundled" | "marketplace";
+}
+export interface WorkflowResolveOptions {
+    /**
+     * Optional marketplace source (giget-style or HTTPS URL).
+     * Omitted = use the default marketplace via TEMPLATE_INDEX_URL.
+     */
+    source?: string;
+}
+export declare class WorkflowResolveError extends Error {
+    constructor(message: string);
+}
+/**
+ * List available workflow templates from the default marketplace (or a
+ * user-supplied source). The bundled native entry is always included first.
+ *
+ * Returns metadata only — no content is fetched. Use `resolveWorkflowTemplate`
+ * to fetch the actual workflow.md bytes for a chosen id.
+ *
+ * Network errors are surfaced as `errorMessage`. The native entry is still
+ * returned so callers can fall back to it offline.
+ */
+export declare function listWorkflowTemplates(options?: WorkflowResolveOptions): Promise<{
+    templates: WorkflowTemplateListing[];
+    errorMessage?: string;
+}>;
+/**
+ * Resolve a workflow id to its content.
+ *
+ * - `native` → bundled `workflowMdTemplate` (offline, never errors).
+ * - other id → fetch index via `template-fetcher`, find the matching
+ *   `type: "workflow"` entry, then fetch its single file content.
+ *
+ * Errors are workflow-specific (do NOT reuse "spec template not found" copy).
+ */
+export declare function resolveWorkflowTemplate(id: string, options?: WorkflowResolveOptions): Promise<ResolvedWorkflowTemplate>;
+//# sourceMappingURL=workflow-resolver.d.ts.map

package/dist/utils/workflow-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/workflow-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAkBH;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,MAAM,EAAE,SAAS,GAAG,aAAa,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,aAAa,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B;AA+DD;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC;IACT,SAAS,EAAE,uBAAuB,EAAE,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC,CA6BD;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,wBAAwB,CAAC,CAoDnC"}

package/dist/utils/workflow-resolver.js

@@ -0,0 +1,265 @@
+/**
+ * Workflow template resolver.
+ *
+ * Centralizes how `trellis init --workflow` and `trellis workflow` discover and
+ * fetch workflow.md content. Reuses `template-fetcher` helpers for registry
+ * parsing, index probing, and git/http transport. The `native` workflow is a
+ * virtual entry resolved directly from the bundled `workflowMdTemplate` to
+ * avoid a duplicate file on disk that could drift out of sync.
+ *
+ * Boundary: command-layer callers (init.ts, commands/workflow.ts) should NOT
+ * touch raw marketplace structures. They go through `resolveWorkflowTemplate`
+ * and `listWorkflowTemplates` only.
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { workflowMdTemplate } from "../templates/trellis/index.js";
+import { TIMEOUTS, TEMPLATE_INDEX_URL, RegistryBackendError, parseRegistrySource, probeRegistryIndex, } from "./template-fetcher.js";
+/**
+ * The id used to refer to the bundled native workflow.
+ *
+ * Treated as Trellis-managed for hash-tracking: when this id is selected by
+ * `init --workflow` or `trellis workflow`, `.trellis/workflow.md` stays in
+ * `.template-hashes.json`. Any other id is user-managed local workflow and
+ * must be removed from the hash file (the durable-state contract in
+ * design.md "Durable-state contract").
+ */
+export const NATIVE_WORKFLOW_ID = "native";
+export class WorkflowResolveError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "WorkflowResolveError";
+    }
+}
+/**
+ * Bundled native workflow entry — virtual, resolved without network access.
+ */
+function nativeListingEntry() {
+    return {
+        id: NATIVE_WORKFLOW_ID,
+        type: "workflow",
+        name: "Native Trellis Workflow",
+        description: "Default Trellis Plan / Execute / Finish workflow bundled with the CLI",
+        path: "bundled:trellis/workflow.md",
+        source: "bundled",
+    };
+}
+function nativeResolvedEntry() {
+    return {
+        ...nativeListingEntry(),
+        content: workflowMdTemplate,
+    };
+}
+function parseSourceOrThrow(source) {
+    try {
+        return parseRegistrySource(source);
+    }
+    catch (err) {
+        throw new WorkflowResolveError(`Invalid workflow marketplace source "${source}": ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+async function fetchWorkflowEntries(registry, indexUrl) {
+    const probe = await probeRegistryIndex(indexUrl, registry);
+    if (probe.error) {
+        return {
+            templates: [],
+            backend: probe.backend,
+            errorMessage: probe.error.message,
+        };
+    }
+    if (probe.isNotFound) {
+        return {
+            templates: [],
+            backend: probe.backend,
+            errorMessage: "No marketplace index.json found at the configured source. Workflow templates require an index.json.",
+        };
+    }
+    return { templates: probe.templates, backend: probe.backend };
+}
+/**
+ * List available workflow templates from the default marketplace (or a
+ * user-supplied source). The bundled native entry is always included first.
+ *
+ * Returns metadata only — no content is fetched. Use `resolveWorkflowTemplate`
+ * to fetch the actual workflow.md bytes for a chosen id.
+ *
+ * Network errors are surfaced as `errorMessage`. The native entry is still
+ * returned so callers can fall back to it offline.
+ */
+export async function listWorkflowTemplates(options = {}) {
+    const result = [nativeListingEntry()];
+    let registry;
+    let indexUrl = TEMPLATE_INDEX_URL;
+    if (options.source) {
+        registry = parseSourceOrThrow(options.source);
+        indexUrl = `${registry.rawBaseUrl}/index.json`;
+    }
+    const fetched = await fetchWorkflowEntries(registry, indexUrl);
+    if (fetched.errorMessage) {
+        return { templates: result, errorMessage: fetched.errorMessage };
+    }
+    for (const t of fetched.templates) {
+        if (t.type !== "workflow")
+            continue;
+        if (t.id === NATIVE_WORKFLOW_ID)
+            continue;
+        result.push({
+            id: t.id,
+            type: "workflow",
+            name: t.name,
+            ...(t.description ? { description: t.description } : {}),
+            path: t.path,
+            source: "marketplace",
+        });
+    }
+    return { templates: result };
+}
+/**
+ * Resolve a workflow id to its content.
+ *
+ * - `native` → bundled `workflowMdTemplate` (offline, never errors).
+ * - other id → fetch index via `template-fetcher`, find the matching
+ *   `type: "workflow"` entry, then fetch its single file content.
+ *
+ * Errors are workflow-specific (do NOT reuse "spec template not found" copy).
+ */
+export async function resolveWorkflowTemplate(id, options = {}) {
+    if (id === NATIVE_WORKFLOW_ID) {
+        return nativeResolvedEntry();
+    }
+    let registry;
+    let indexUrl = TEMPLATE_INDEX_URL;
+    if (options.source) {
+        registry = parseSourceOrThrow(options.source);
+        indexUrl = `${registry.rawBaseUrl}/index.json`;
+    }
+    const fetched = await fetchWorkflowEntries(registry, indexUrl);
+    if (fetched.errorMessage) {
+        throw new WorkflowResolveError(`Could not fetch workflow template index: ${fetched.errorMessage}`);
+    }
+    const entry = fetched.templates.find((t) => t.id === id && t.type === "workflow");
+    if (!entry) {
+        const available = fetched.templates
+            .filter((t) => t.type === "workflow")
+            .map((t) => t.id);
+        const hint = available.length > 0
+            ? ` Available workflow templates: ${available.join(", ")}`
+            : "";
+        throw new WorkflowResolveError(`Workflow template "${id}" not found in marketplace index.${hint}`);
+    }
+    if (!entry.path?.endsWith(".md")) {
+        throw new WorkflowResolveError(`Workflow template "${id}" has invalid path "${entry.path}" — must point to a workflow.md file.`);
+    }
+    const backend = fetched.backend;
+    const content = await fetchWorkflowFile(entry.path, registry, backend);
+    return {
+        id: entry.id,
+        type: "workflow",
+        name: entry.name,
+        ...(entry.description ? { description: entry.description } : {}),
+        path: entry.path,
+        content,
+        source: "marketplace",
+    };
+}
+async function fetchWorkflowFile(relativePath, registry, backend) {
+    validateWorkflowPath(relativePath);
+    const useGit = registry?.preferGit ?? backend === "git";
+    if (registry && useGit) {
+        return fetchWorkflowFileGit(registry, relativePath);
+    }
+    const rawBase = registry
+        ? registry.rawBaseUrl
+        : TEMPLATE_INDEX_URL.replace(/\/index\.json$/, "");
+    return fetchWorkflowFileHttp(rawBase, relativePath);
+}
+async function fetchWorkflowFileHttp(rawBaseUrl, relativePath) {
+    const url = `${rawBaseUrl.replace(/\/$/, "")}/${relativePath}`;
+    try {
+        const res = await fetch(url, {
+            signal: AbortSignal.timeout(TIMEOUTS.DOWNLOAD_MS),
+        });
+        if (res.status === 404) {
+            throw new WorkflowResolveError(`Workflow template file not found at ${url}.`);
+        }
+        if (!res.ok) {
+            throw new WorkflowResolveError(`Could not fetch workflow template (HTTP ${res.status}) from ${url}.`);
+        }
+        return await res.text();
+    }
+    catch (err) {
+        if (err instanceof WorkflowResolveError)
+            throw err;
+        throw new WorkflowResolveError(`Workflow template download failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+function validateWorkflowPath(relativePath) {
+    const normalized = relativePath.replace(/\\/g, "/");
+    if (normalized.startsWith("/") ||
+        normalized.split("/").some((part) => part === "..")) {
+        throw new WorkflowResolveError(`Workflow template path "${relativePath}" must stay inside the marketplace root.`);
+    }
+}
+async function fetchWorkflowFileGit(registry, relativePath) {
+    // Single shallow clone of the registry ref, then read one file. We don't
+    // share clone state with template-fetcher's downloadGitRegistryPath because
+    // workflow resolution is a single-file fetch (not a directory copy).
+    const { execFile } = await import("node:child_process");
+    const dir = await fs.promises.mkdtemp(path.join(os.tmpdir(), "trellis-workflow-"));
+    function run(args) {
+        return new Promise((resolve, reject) => {
+            execFile("git", args, {
+                encoding: "utf-8",
+                maxBuffer: 10 * 1024 * 1024,
+                timeout: TIMEOUTS.DOWNLOAD_MS,
+            }, (error) => {
+                if (error)
+                    reject(error);
+                else
+                    resolve();
+            });
+        });
+    }
+    try {
+        try {
+            await run([
+                "clone",
+                "--filter=blob:none",
+                "--no-checkout",
+                registry.gitUrl,
+                dir,
+            ]);
+            await run(["-C", dir, "fetch", "--depth", "1", "origin", registry.ref]);
+            await run(["-C", dir, "checkout", "--detach", "FETCH_HEAD"]);
+        }
+        catch (err) {
+            throw new RegistryBackendError("network", `Could not clone registry ${registry.gitUrl}#${registry.ref}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        const subdir = registry.subdir.length > 0 ? registry.subdir : ".";
+        const sourceRoot = path.resolve(dir, subdir);
+        const candidatePath = path.resolve(sourceRoot, relativePath);
+        const rel = path.relative(sourceRoot, candidatePath);
+        if (rel.startsWith("..") || path.isAbsolute(rel)) {
+            throw new WorkflowResolveError(`Workflow template path "${relativePath}" escapes the marketplace root.`);
+        }
+        if (!fs.existsSync(candidatePath)) {
+            throw new WorkflowResolveError(`Workflow template file "${relativePath}" not found in ${registry.gitUrl}#${registry.ref}.`);
+        }
+        return await fs.promises.readFile(candidatePath, "utf-8");
+    }
+    catch (err) {
+        if (err instanceof WorkflowResolveError)
+            throw err;
+        if (err instanceof RegistryBackendError) {
+            throw new WorkflowResolveError(err.message);
+        }
+        throw new WorkflowResolveError(`Workflow template download failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    finally {
+        await fs.promises.rm(dir, { recursive: true, force: true }).catch(() => {
+            // best-effort cleanup; the OS will reap tmp dirs eventually
+        });
+    }
+}
+//# sourceMappingURL=workflow-resolver.js.map

package/dist/utils/workflow-resolver.js.map

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

package/package.json

@@ -0,0 +1,137 @@
+{
+  "name": "@blxzer/cursor-trellis",
+  "version": "0.1.0",
+  "description": "AI capabilities grow like ivy — Trellis provides the structure to guide them along a disciplined path",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "trellis": "./bin/trellis.js",
+    "tl": "./bin/trellis.js",
+    "smart-search": "./bin/smart-search.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "ai",
+    "workflow",
+    "cursor",
+    "claude",
+    "iflow",
+    "cli",
+    "developer-tools",
+    "agent",
+    "memory",
+    "trellis"
+  ],
+  "author": "Mindfold LLC",
+  "license": "AGPL-3.0-only",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "figlet": "^1.9.4",
+    "giget": "^3.1.1",
+    "inquirer": "^9.3.7",
+    "undici": "^6.21.0",
+    "zod": "^4.4.2",
+    "@blxzer/cursor-trellis-core": "0.1.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.18.0",
+    "@types/figlet": "^1.7.0",
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.17.10",
+    "@vitest/coverage-v8": "^4.0.18",
+    "basedpyright": "^1.37.2",
+    "eslint": "^9.18.0",
+    "prettier": "^3.4.2",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.21.0",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=18.17.0"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "scripts/postinstall.js",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "vendor/smart-search/LICENSE",
+    "vendor/smart-search/README.md",
+    "vendor/smart-search/README.zh-CN.md",
+    "vendor/smart-search/npm/bin/smart-search.js",
+    "vendor/smart-search/npm/scripts/postinstall.js",
+    "vendor/smart-search/npm/scripts/resolve-prerelease-version.js",
+    "vendor/smart-search/npm/scripts/set-package-version.js",
+    "vendor/smart-search/npm/scripts/sync-python-version.js",
+    "vendor/smart-search/npm/scripts/test-wrapper-repair.js",
+    "vendor/smart-search/npm/scripts/test.js",
+    "vendor/smart-search/package.json",
+    "vendor/smart-search/pyproject.toml",
+    "vendor/smart-search/skills/smart-search-cli/SKILL.md",
+    "vendor/smart-search/skills/smart-search-cli/agents/openai.yaml",
+    "vendor/smart-search/skills/smart-search-cli/examples/batch-search.md",
+    "vendor/smart-search/skills/smart-search-cli/examples/evidence-gathering.md",
+    "vendor/smart-search/skills/smart-search-cli/references/cli-contract.md",
+    "vendor/smart-search/src/smart_search/__init__.py",
+    "vendor/smart-search/src/smart_search/assets/skills/smart-search-cli/SKILL.md",
+    "vendor/smart-search/src/smart_search/assets/skills/smart-search-cli/agents/openai.yaml",
+    "vendor/smart-search/src/smart_search/assets/skills/smart-search-cli/examples/batch-search.md",
+    "vendor/smart-search/src/smart_search/assets/skills/smart-search-cli/examples/evidence-gathering.md",
+    "vendor/smart-search/src/smart_search/assets/skills/smart-search-cli/references/cli-contract.md",
+    "vendor/smart-search/src/smart_search/cli.py",
+    "vendor/smart-search/src/smart_search/config.py",
+    "vendor/smart-search/src/smart_search/logger.py",
+    "vendor/smart-search/src/smart_search/providers/__init__.py",
+    "vendor/smart-search/src/smart_search/providers/base.py",
+    "vendor/smart-search/src/smart_search/providers/context7.py",
+    "vendor/smart-search/src/smart_search/providers/exa.py",
+    "vendor/smart-search/src/smart_search/providers/jina.py",
+    "vendor/smart-search/src/smart_search/providers/openai_compatible.py",
+    "vendor/smart-search/src/smart_search/providers/zhipu.py",
+    "vendor/smart-search/src/smart_search/service.py",
+    "vendor/smart-search/src/smart_search/sources.py",
+    "vendor/smart-search/src/smart_search/utils.py"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/blxzer77/cursor-trellis.git"
+  },
+  "scripts": {
+    "build": "pnpm run clean && tsc && pnpm run copy-templates",
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "copy-templates": "node scripts/copy-templates.js",
+    "postinstall": "node scripts/postinstall.js",
+    "sync:smart-search": "node scripts/sync-smart-search-vendor.js",
+    "check:smart-search": "node scripts/check-smart-search-vendor.js",
+    "check:pack-files": "node scripts/check-cli-pack-files.js",
+    "check:release-pack": "node scripts/check-release-pack-contents.js",
+    "copy:release-assets": "node scripts/copy-release-assets.js",
+    "sync:pack-files": "node scripts/sync-cli-pack-files.js",
+    "dev": "tsc --watch",
+    "start": "node ./dist/cli/index.js",
+    "test": "vitest run --maxWorkers=4",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/ test/",
+    "lint:fix": "eslint src/ test/ --fix",
+    "format": "prettier --write src/",
+    "format:check": "prettier --check src/",
+    "typecheck": "tsc --noEmit",
+    "lint:py": "basedpyright",
+    "lint:all": "pnpm lint && pnpm lint:py",
+    "release": "node scripts/release.js patch",
+    "release:minor": "node scripts/release.js minor",
+    "release:major": "node scripts/release.js major",
+    "release:beta": "node scripts/release.js beta",
+    "release:rc": "node scripts/release.js rc",
+    "release:promote": "node scripts/release.js promote",
+    "release:publish": "node scripts/publish-packages.js",
+    "release:publish:dry": "node scripts/publish-packages.js --dry-run",
+    "manifest": "node scripts/create-manifest.js"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+
+import { spawnSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const packageRoot = path.resolve(
+  path.dirname(fileURLToPath(import.meta.url)),
+  "..",
+);
+const vendorRoot = path.join(packageRoot, "vendor", "smart-search");
+const smartSearchPostinstall = path.join(
+  vendorRoot,
+  "npm",
+  "scripts",
+  "postinstall.js",
+);
+
+if (process.env.TRELLIS_SKIP_SMART_SEARCH_POSTINSTALL === "1") {
+  console.log(
+    "Skipping smart-search runtime setup (TRELLIS_SKIP_SMART_SEARCH_POSTINSTALL=1).",
+  );
+  process.exit(0);
+}
+
+if (!fs.existsSync(smartSearchPostinstall)) {
+  console.error(
+    `Trellis smart-search runtime setup script was not found: ${smartSearchPostinstall}`,
+  );
+  process.exit(1);
+}
+
+const result = spawnSync(process.execPath, [smartSearchPostinstall], {
+  cwd: vendorRoot,
+  stdio: "inherit",
+  windowsHide: true,
+});
+
+if (result.error) {
+  console.error(`Trellis smart-search runtime setup failed: ${result.error.message}`);
+  process.exit(1);
+}
+
+process.exit(result.status ?? 1);

package/vendor/smart-search/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 GuDaStudio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.