@fantasticit/sumi 0.0.0-stage → 0.5.0

package/node_modules/@sumi/create/dist/scaffold.d.ts

@@ -0,0 +1,29 @@
+/** 新项目模板目录（构建时从仓库的 templates/default 复制）。 */
+export declare const TEMPLATE_DIR: string;
+export interface ScaffoldOptions {
+    name?: string;
+    /** 启用的 AI 工具（写入配置的 agents）。 */
+    agents?: string[];
+    /** 当前 CLI 版本，精确写入配置。 */
+    cliVersion?: string;
+    /** 当前 CLI 构建身份，写入配置的 sumiBuild。 */
+    cliBuild?: string;
+}
+/** 创建新项目：复制完整模板，设置项目名与启用的 AI 工具。 */
+export declare function scaffold(target: string, options?: ScaffoldOptions): void;
+export interface InitResult {
+    written: string[];
+    skipped: string[];
+    zones: {
+        business: string[];
+        neutral: string[];
+    };
+}
+/** sumi 生成的 AI 工具适配文件：由工具生成，不参与格式等检查。 */
+export declare const GENERATED_ADAPTERS: string[];
+/**
+ * 在已有仓库中接入：写入 control 与 precedent 骨架、配置、入口文档与 OpenSpec 骨架，
+ * 不覆盖已有文件；现有顶层目录登记为 business 区或中立区。流程与入口文档取自模板的 init/ 目录，
+ * 区域、排除路径等取自模板配置；本函数不认识任何插件。
+ */
+export declare function initInto(root: string, options?: ScaffoldOptions): InitResult;

package/node_modules/@sumi/create/dist/scaffold.js

@@ -0,0 +1,134 @@
+import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, statSync, writeFileSync } from 'node:fs';
+import { basename, dirname, join, relative, resolve, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parseDocument } from 'yaml';
+/** 新项目模板目录（构建时从仓库的 templates/default 复制）。 */
+export const TEMPLATE_DIR = resolve(dirname(fileURLToPath(import.meta.url)), '..', 'template');
+const CONFIG = 'control/config.yaml';
+/** 模板中接入已有仓库专用的文件（按相对路径写入，取代模板根目录中的同名文件）。 */
+const INIT_DIR = 'init';
+function setConfig(root, patch) {
+    const path = join(root, CONFIG);
+    const doc = parseDocument(readFileSync(path, 'utf8'));
+    patch(doc);
+    writeFileSync(path, doc.toString({ flowCollectionPadding: false }));
+}
+/** 创建新项目：复制完整模板，设置项目名与启用的 AI 工具。 */
+export function scaffold(target, options = {}) {
+    if (existsSync(target) && readdirSync(target).length > 0)
+        throw new Error(`目标目录不为空：${target}`);
+    mkdirSync(target, { recursive: true });
+    // init/ 是接入已有仓库时使用的模板文件，新项目不复制。
+    cpSync(TEMPLATE_DIR, target, { recursive: true, filter: (src) => relative(TEMPLATE_DIR, src) !== INIT_DIR });
+    renameSync(join(target, 'gitignore'), join(target, '.gitignore'));
+    const pkgPath = join(target, 'package.json');
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+    pkg.name = options.name ?? basename(target);
+    writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`);
+    writeFileSync(join(target, 'AGENTS.md'), readFileSync(join(target, 'AGENTS.md'), 'utf8').replace('# my-app', `# ${pkg.name}`));
+    setConfig(target, (doc) => {
+        if (options.agents?.length)
+            doc.set('agents', options.agents);
+        if (options.cliVersion)
+            doc.set('sumi', options.cliVersion);
+        if (options.cliBuild)
+            doc.set('sumiBuild', options.cliBuild);
+    });
+}
+const BUSINESS_DIRS = new Set(['src', 'app', 'apps', 'lib', 'packages', 'server', 'client', 'web', 'api', 'services', 'test', 'tests']);
+/** sumi 生成的 AI 工具适配文件：由工具生成，不参与格式等检查。 */
+export const GENERATED_ADAPTERS = [
+    '.claude/skills/sumi-*/**',
+    '.claude/commands/sumi/**',
+    '.agents/skills/sumi-*/**',
+    '.agents/commands/sumi/**',
+    '.cursor/rules/sumi-*',
+    '.cursor/commands/sumi-*',
+];
+/** 列出目录下的全部文件（相对路径）。 */
+function filesUnder(dir) {
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir, { recursive: true })
+        .map((file) => String(file).replaceAll(sep, '/'))
+        .filter((rel) => statSync(join(dir, rel)).isFile())
+        .sort();
+}
+/**
+ * 在已有仓库中接入：写入 control 与 precedent 骨架、配置、入口文档与 OpenSpec 骨架，
+ * 不覆盖已有文件；现有顶层目录登记为 business 区或中立区。流程与入口文档取自模板的 init/ 目录，
+ * 区域、排除路径等取自模板配置；本函数不认识任何插件。
+ */
+export function initInto(root, options = {}) {
+    const written = [];
+    const skipped = [];
+    const write = (rel, content) => {
+        const full = join(root, rel);
+        if (existsSync(full))
+            return void skipped.push(rel);
+        mkdirSync(dirname(full), { recursive: true });
+        writeFileSync(full, content);
+        written.push(rel);
+    };
+    const template = parseDocument(readFileSync(join(TEMPLATE_DIR, CONFIG), 'utf8'));
+    const templateZones = (template.get('zones')?.toJSON() ?? {});
+    // 模板区域（business 之外）的顶层目录属于 sumi 自己，不登记为 business 或中立区。
+    const own = new Set([
+        'node_modules',
+        '.git',
+        ...Object.entries(templateZones)
+            .filter(([zone]) => zone !== 'business')
+            .flatMap(([, globs]) => globs.map((g) => g.split('/')[0])),
+    ]);
+    const business = [];
+    const neutral = [];
+    for (const name of readdirSync(root).sort()) {
+        if (own.has(name))
+            continue;
+        const isDir = statSync(join(root, name)).isDirectory();
+        if (isDir && BUSINESS_DIRS.has(name))
+            business.push(`${name}/**`);
+        else
+            neutral.push(isDir ? `${name}/**` : name);
+    }
+    for (const extra of ['AGENTS.md', '.claude/**', '.agents/**', '.cursor/**', '.codex/**'])
+        if (!neutral.includes(extra))
+            neutral.push(extra);
+    template.set('zones', { ...templateZones, business: business.length ? business : (templateZones.business ?? ['src/**']) });
+    template.set('neutral', neutral);
+    template.set('exclude', [
+        ...new Set([...(template.get('exclude')?.toJSON() ?? []), ...GENERATED_ADAPTERS]),
+    ]);
+    template.delete('groups');
+    if (options.agents?.length)
+        template.set('agents', options.agents);
+    if (options.cliVersion)
+        template.set('sumi', options.cliVersion);
+    if (options.cliBuild)
+        template.set('sumiBuild', options.cliBuild);
+    // 模板 init/ 中的文件按顶层目录成组写入：项目中已存在的顶层目录（例如已接入的 openspec/）整体跳过，不重新初始化。
+    const initFiles = filesUnder(join(TEMPLATE_DIR, INIT_DIR));
+    const existingTop = new Set(initFiles
+        .map((rel) => rel.split('/')[0])
+        .filter((top) => initFiles.some((f) => f.startsWith(`${top}/`)) && existsSync(join(root, top))));
+    for (const top of existingTop)
+        skipped.push(`${top}/（目录已存在）`);
+    for (const rel of initFiles) {
+        if (!existingTop.has(rel.split('/')[0]))
+            write(rel, readFileSync(join(TEMPLATE_DIR, INIT_DIR, rel), 'utf8'));
+    }
+    // 已经有项目配置（含旧位置）时不再写入，避免新位置遮住旧配置。
+    if (existsSync(join(root, 'sumi.config.yaml')))
+        skipped.push(CONFIG);
+    else
+        write(CONFIG, template.toString({ flowCollectionPadding: false }));
+    const gitignore = join(root, '.gitignore');
+    const lines = existsSync(gitignore) ? readFileSync(gitignore, 'utf8') : '';
+    if (!lines.split(/\r?\n/).includes('.sumi/')) {
+        const eol = lines.includes('\r\n') ? '\r\n' : '\n';
+        writeFileSync(gitignore, `${lines}${lines && !lines.endsWith('\n') ? eol : ''}.sumi/${eol}`);
+        written.push('.gitignore');
+    }
+    return { written, skipped, zones: { business, neutral } };
+}
+//# sourceMappingURL=scaffold.js.map

package/node_modules/@sumi/create/dist/scaffold.js.map

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

package/node_modules/@sumi/create/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@sumi/create",
+  "version": "0.5.0",
+  "description": "Sumi 脚手架与项目模板（由 sumi init 调用）",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "yaml": "2.9.1"
+  },
+  "files": [
+    "dist",
+    "template"
+  ]
+}

package/node_modules/@sumi/create/template/.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

package/node_modules/@sumi/create/template/.prettierignore

@@ -0,0 +1,5 @@
+.claude/
+.agents/
+.cursor/
+pnpm-lock.yaml
+openspec/

package/node_modules/@sumi/create/template/.prettierrc

@@ -0,0 +1 @@
+{ "singleQuote": true, "printWidth": 140 }

package/node_modules/@sumi/create/template/AGENTS.md

@@ -0,0 +1,28 @@
+# my-app
+
+一句话说明：（请补充项目用途）。始终用简体中文与用户交流。
+
+本项目由 sumi 纳管，CLI 已随仓库锁定；不需要也不应依赖全局安装。
+
+## 流程
+
+- 改动代码后运行 `node ./control/bin/sumi.cjs run check`，按简报中的 next 处理，直到退出码为 0。
+- 推进一个 OpenSpec change：`node ./control/bin/sumi.cjs run change --label change=<名称> --label stage=propose|apply|archive`。
+- 接线有疑问时运行 `node ./control/bin/sumi.cjs doctor`。
+
+## 层结构
+
+- `src/`：business 层，业务代码。
+- `control/`：control 层，流程、插件、评审准则、决策记录与指标基线。
+- `precedents/`：判例层，业务中确定下来、反向约束后续实现的约束。
+- `openspec/`：业务行为规格。
+
+## 不可妥协约束
+
+- 不得绕过 git hook，人工确认只能由人在终端完成 [plugin:gov/protected-paths]
+- 用户要求创建或更新 PR 时，当前 head 的 Sumi 审查报告必须发布成功后才能宣告完成 [plugin:gov/protected-paths]
+- 除配置模块外，business 区禁止直接读取 process.env [prec:no-env-in-business]
+
+## 能力边界
+
+本地防线针对的是顺手修改规则、伪造记录与习惯性跳过 hook；拥有完整 shell 权限、存心对抗的代理无法在本地被彻底阻止。需要更强保证时，可在自有 CI 中运行同一个 `sumi gate`。

package/node_modules/@sumi/create/template/control/config.yaml

@@ -0,0 +1,59 @@
+# sumi 项目配置：兼容的 CLI 版本、档位、区域、启用的插件包与 AI 工具。规则本身写在插件、判例与准则里，不写在这里。
+sumi: '>=0.0.0'
+tiers: [delta, runtime, full]
+zones:
+  business: ['src/**']
+  control: ['control/**']
+  precedent: ['precedents/**']
+  openspec: ['openspec/**']
+neutral:
+  - AGENTS.md
+  - package.json
+  - pnpm-lock.yaml
+  - package-lock.json
+  - tsconfig.json
+  - eslint.config.mjs
+  - .prettierrc
+  - .prettierignore
+  - .gitignore
+  - .gitattributes
+  - '.claude/**'
+  - '.agents/**'
+  - '.cursor/**'
+  - '.codex/**'
+  - 'docs/**'
+exclude:
+  - 'control/bin/**'
+  - 'control/vendor/**'
+  - 'precedents/*/fixtures/**'
+  - '.claude/skills/sumi-*/**'
+  - '.claude/commands/sumi/**'
+  - '.agents/skills/sumi-*/**'
+  - '.agents/commands/sumi/**'
+  - '.cursor/rules/sumi-*'
+  - '.cursor/commands/sumi-*'
+packages:
+  - '@sumi/plugins-core'
+  - '@sumi/plugins-governance'
+  - '@sumi/plugins-review'
+  - '@sumi/plugins-precedent'
+  - '@sumi/plugins-openspec'
+plugins: [control/plugins]
+agents: [claude]
+groups:
+  checks:
+    - core/format
+    - core/lint
+    - core/typecheck
+    - core/test-affected
+    - openspec/validate
+    - core/coverage
+    - core/layer-boundary
+    - core/control-docs
+    - core/agent-drift
+    - gov/protected-paths
+    - prec/selftest
+    - core/ratchet
+gate:
+  # 推送门禁：在被推送提交的独立检出中按锁文件安装依赖，再按 runtime 档运行 check（含类型检查、测试与评审）
+  tier: runtime

package/node_modules/@sumi/create/template/control/decisions/0001-config-module.md

@@ -0,0 +1,15 @@
+# 0001 配置统一经配置模块读取
+
+- 状态：已采纳
+
+## 背景
+
+环境变量散落在各处时，缺省值、类型转换与校验各写一份，改名或新增配置容易漏改。
+
+## 决定
+
+所有环境与配置读取集中在 `src/config.ts`，其余模块从它导入 [prec:no-env-in-business]。
+
+## 后果
+
+新增配置只改一处；测试时可以替换配置模块。

package/node_modules/@sumi/create/template/control/flows/change.flow.yaml

@@ -0,0 +1,14 @@
+id: change
+purpose: 按 OpenSpec 生命周期推进一个 change（--label change=<名称> --label stage=propose|apply|archive）
+steps:
+  - use: prec/planner
+  - use: openspec/planner
+  - use: openspec/change-tasks
+  - use: group:checks
+    when: tier == full
+  # 评审在 runtime 及以上档位运行且必需：推送门禁（gate.tier: runtime）要求先在工作区完成评审
+  - id: review/architecture
+    use: review/rubric
+    when: tier >= runtime
+    with: { rubric: architecture }
+  - use: prec/harvest

package/node_modules/@sumi/create/template/control/flows/check.flow.yaml

@@ -0,0 +1,25 @@
+id: check
+purpose: 每次改动后运行；提交前与推送前也运行它
+steps:
+  - use: prec/planner
+  - use: openspec/planner
+  - use: core/format
+    parallel: true
+  - use: core/lint
+    parallel: true
+  - use: core/typecheck
+    parallel: true
+  - use: core/test-affected
+  - use: openspec/validate
+  - use: core/coverage
+  - use: core/layer-boundary
+  - use: core/control-docs
+  - use: core/agent-drift
+  - use: gov/protected-paths
+  - use: prec/selftest
+  - use: core/ratchet
+  # 评审在 runtime 及以上档位运行且必需：推送门禁（gate.tier: runtime）要求先在工作区完成评审
+  - id: review/architecture
+    use: review/rubric
+    when: tier >= runtime
+    with: { rubric: architecture }

package/node_modules/@sumi/create/template/control/rubrics/architecture.yaml

@@ -0,0 +1,14 @@
+id: architecture
+items:
+  - id: R1
+    question: 新增的业务代码是否经配置模块读取环境与配置，而不是直接读取进程环境？
+    pass: 只有 src/config.ts 读取 process.env，其余模块从它导入
+    scope: ['src/**']
+  - id: R2
+    question: 模块边界是否与业务领域一致，没有跨领域的直接依赖？
+    pass: 每个模块只依赖本领域与公共模块
+    scope: ['src/**']
+  - id: R3
+    question: control 文档中的规则是否都有执行者（插件、判例或准则条目），而不是只靠文字？
+    pass: 每条规范性语句都带有执行者引用
+    scope: ['control/**', 'AGENTS.md']

package/node_modules/@sumi/create/template/eslint.config.mjs

@@ -0,0 +1,9 @@
+import js from '@eslint/js';
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+  { ignores: ['**/dist/**', '**/node_modules/**', '.sumi/**', 'precedents/*/fixtures/**'] },
+  js.configs.recommended,
+  ...tseslint.configs.recommended,
+  { languageOptions: { globals: { process: 'readonly', console: 'readonly' } } },
+);

package/node_modules/@sumi/create/template/gitignore

@@ -0,0 +1,4 @@
+node_modules
+dist/
+coverage/
+.sumi/

package/node_modules/@sumi/create/template/init/AGENTS.md

@@ -0,0 +1,27 @@
+# my-app
+
+一句话说明：（请补充项目用途）。始终用简体中文与用户交流。
+
+本项目由 Sumi 纳管，CLI 已随仓库锁定；不需要也不应依赖全局安装。统一通过 `node ./control/bin/sumi.cjs` 运行。
+
+## 流程
+
+- 改动代码后运行 `node ./control/bin/sumi.cjs run check`，按简报中的 next 处理，直到退出码为 0。
+- 推进一个 OpenSpec change：`node ./control/bin/sumi.cjs run change --label change=<名称> --label stage=propose|apply|archive`。
+- 接线有疑问时运行 `node ./control/bin/sumi.cjs doctor`。
+
+## 层结构
+
+- `src/`：business 层，业务代码。
+- `control/`：control 层，流程、插件、评审准则、决策记录与指标基线。
+- `precedents/`：判例层，业务中确定下来、反向约束后续实现的约束。
+- `openspec/`：业务行为规格。
+
+## 不可妥协约束
+
+- 不得绕过 git hook，人工确认只能由人在终端完成 [plugin:gov/protected-paths]
+- 用户要求创建或更新 PR 时，当前 head 的 Sumi 审查报告必须发布成功后才能宣告完成 [plugin:gov/protected-paths]
+
+## 能力边界
+
+本地防线针对的是顺手修改规则、伪造记录与习惯性跳过 hook；拥有完整 shell 权限、存心对抗的代理无法在本地被彻底阻止。需要更强保证时，可在自有 CI 中运行同一个 `sumi gate`。

package/node_modules/@sumi/create/template/init/control/flows/check.flow.yaml

@@ -0,0 +1,20 @@
+id: check
+purpose: 每次改动后运行；提交前与推送前也运行它
+# 接入已有仓库时使用的 check 流程：sumi init 会去掉运行前提（插件的 needs）不满足的步骤。
+# 项目原有的入口文档属于纳管债务，由纳管流程处理，这里的文档检查只扫描 control 区。
+steps:
+  - use: prec/planner
+  - use: openspec/planner
+  - use: core/format
+  - use: core/lint
+  - use: core/typecheck
+  - use: core/test-affected
+  - use: openspec/validate
+  - use: core/layer-boundary
+  - use: core/control-docs
+    with:
+      paths: ['control/**/*.md']
+  - use: core/agent-drift
+  - use: gov/protected-paths
+  - use: prec/selftest
+  - use: core/ratchet

package/node_modules/@sumi/create/template/init/control/rubrics/architecture.yaml

@@ -0,0 +1,14 @@
+id: architecture
+items:
+  - id: R1
+    question: 新增的业务代码是否经配置模块读取环境与配置，而不是直接读取进程环境？
+    pass: 只有 src/config.ts 读取 process.env，其余模块从它导入
+    scope: ['src/**']
+  - id: R2
+    question: 模块边界是否与业务领域一致，没有跨领域的直接依赖？
+    pass: 每个模块只依赖本领域与公共模块
+    scope: ['src/**']
+  - id: R3
+    question: control 文档中的规则是否都有执行者（插件、判例或准则条目），而不是只靠文字？
+    pass: 每条规范性语句都带有执行者引用
+    scope: ['control/**', 'AGENTS.md']

package/node_modules/@sumi/create/template/init/openspec/config.yaml

@@ -0,0 +1 @@
+schema: spec-driven

package/node_modules/@sumi/create/template/init/precedents/registry.yaml

@@ -0,0 +1 @@
+precedents: []

package/node_modules/@sumi/create/template/openspec/config.yaml

@@ -0,0 +1 @@
+schema: spec-driven

package/node_modules/@sumi/create/template/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "my-app",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "check": "node ./control/bin/sumi.cjs run check",
+    "doctor": "node ./control/bin/sumi.cjs doctor"
+  },
+  "devDependencies": {
+    "@eslint/js": "9.39.5",
+    "@fission-ai/openspec": "1.14.1",
+    "@types/node": "22.20.5",
+    "@vitest/coverage-v8": "3.2.7",
+    "eslint": "9.39.5",
+    "prettier": "3.9.9",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.71.1",
+    "vitest": "3.2.7"
+  }
+}

package/node_modules/@sumi/create/template/precedents/no-env-in-business/check.mjs

@@ -0,0 +1,36 @@
+// 判例 no-env-in-business 的检查器：遵循插件协议，从标准输入读取上下文，输出结果。
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+let input = '';
+for await (const chunk of process.stdin) input += chunk;
+const ctx = JSON.parse(input);
+const findings = [];
+for (const file of ctx.files) {
+  if (!file.endsWith('.ts') || file === 'src/config.ts' || !existsSync(join(ctx.repoRoot, file))) continue;
+  readFileSync(join(ctx.repoRoot, file), 'utf8')
+    .split('\n')
+    .forEach((line, i) => {
+      if (line.includes('process.env')) {
+        findings.push({
+          id: `F${findings.length + 1}`,
+          rule: 'no-env',
+          severity: 'error',
+          message: '请从 src/config.ts 导入配置',
+          file,
+          line: i + 1,
+        });
+      }
+    });
+}
+const status = findings.length ? 'fail' : 'pass';
+process.stdout.write(
+  JSON.stringify({
+    status,
+    summary: status === 'pass' ? '未直接读取 process.env' : `${findings.length} 处直接读取`,
+    findings,
+    checked: ctx.files,
+    evidence: [],
+  }),
+);
+process.exitCode = status === 'pass' ? 0 : 1;

package/node_modules/@sumi/create/template/precedents/no-env-in-business/fixtures/compliant/src/a.ts

@@ -0,0 +1,3 @@
+import { config } from './config.js';
+
+export const apiBase = config.apiBase;

package/node_modules/@sumi/create/template/precedents/no-env-in-business/fixtures/violating/src/a.ts

@@ -0,0 +1 @@
+export const apiBase = process.env.API_BASE;

package/node_modules/@sumi/create/template/precedents/no-env-in-business/precedent.yaml

@@ -0,0 +1,9 @@
+id: no-env-in-business
+statement: business 区除配置模块外不得直接读取 process.env
+severity: error
+triggers: ['src/**/*.ts']
+source:
+  adr: control/decisions/0001-config-module.md
+enforcer:
+  type: checker
+  command: [node, ./check.mjs]

package/node_modules/@sumi/create/template/precedents/registry.yaml

@@ -0,0 +1,3 @@
+precedents:
+  - id: no-env-in-business
+    status: active

package/node_modules/@sumi/create/template/src/config.ts

@@ -0,0 +1,4 @@
+/** 配置模块：环境与配置只在这里读取。 */
+export const config = {
+  appName: process.env.APP_NAME ?? 'app',
+};

package/node_modules/@sumi/create/template/src/index.test.ts

@@ -0,0 +1,6 @@
+import { expect, test } from 'vitest';
+import { greet } from './index.js';
+
+test('greet', () => {
+  expect(greet('世界')).toBe('你好，世界（app）');
+});

package/node_modules/@sumi/create/template/src/index.ts

@@ -0,0 +1,5 @@
+import { config } from './config.js';
+
+export function greet(name: string): string {
+  return `你好，${name}（${config.appName}）`;
+}

package/node_modules/@sumi/create/template/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "ES2023",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "types": ["node"]
+  },
+  "include": ["src"]
+}