@nick848/fet 0.1.0 → 1.0.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 nick848
-
-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.
+MIT License
+
+Copyright (c) 2026 nick848
+
+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.

package/README.md

@@ -1,44 +1,101 @@
-# FET
-
-在项目中以 [OpenSpec](https://github.com/Fission-AI/OpenSpec) 为基座做**工作流编排**：`fet` 命令在前后挂钩子、管理 `openspec/fet-state.json`、生成上下文与工具技能（Cursor / OpenCode），并把 `openspec` CLI 透传执行。
-
-## 要求
-
-- Node.js **≥ 18**
-- 已安装 OpenSpec CLI（PATH 中的 `openspec`，否则将尝试 `npx @fission-ai/openspec`）
-
-## 安装
-
-```bash
-npm install -g @nick848/fet
-```
-
-## 常用命令
-
-| 命令 | 说明 |
-|------|------|
-| `fet init` | 初始化 OpenSpec + FET 状态、扫描上下文、生成工具文件（`--tool cursor \| opencode \| both`） |
-| `fet apply` / `fet validate` | 实施循环与任务校验 |
-| `fet verify` | 终验（`--auto` / `--done` 等） |
-| `fet doctor` | 诊断配置与 openspec 解析路径 |
-| `fet update-context` | 刷新 `AGENTS.md` 与 `openspec/config.yaml` 中的 FET 区块 |
-
-其余子命令多为对 `openspec` 的透传，详见 `fet --help`。
-
-## 文档
-
-仓库内 [DESIGN.md](./DESIGN.md) 为完整设计说明（威胁模型、状态机、与 OpenSpec 关系等）。
-
-## 维护者：发布到 npm
-
-1. 登录：`npm login`（首次）
-2. 确认版本号：编辑 `package.json` 的 `version`（语义化版本）
-3. 本地校验：`npm run build && npm test`
-4. 干跑包内容：`npm pack --dry-run`
-5. 发布（作用域包已设 `publishConfig.access: public`）：`npm publish`
-
-`prepublishOnly` 会在发布前自动执行 `npm run build && npm test`。
-
-## 开源协议
-
-MIT，见 [LICENSE](./LICENSE)。
+# FET
+
+FET is a frontend workflow orchestration CLI built around OpenSpec. It does not generate business code itself. Instead, it proxies OpenSpec commands, maintains local workflow state, generates auditable context files, and helps AI coding tools read the right project context.
+
+## Status
+
+This package is currently `0.3.0-dev`: a development build aimed at stabilizing the MVP before a public stable release. The supported surface includes:
+
+- `fet init`
+- `fet update-context`
+- `fet doctor`
+- OpenSpec proxy commands such as `fet propose`, `fet apply`, `fet sync`, `fet archive`
+- manual verification with `fet verify` and `fet verify --done`
+- Cursor project files generation and doctor checks
+- scanner support for package manager conflicts, TypeScript, basic workspaces, and common frontend frameworks
+
+`fet verify --auto` currently generates and optionally records an approved execution plan only. It does not run project scripts yet.
+
+Not stable yet:
+
+- Real OpenSpec compatibility is still limited to the currently tested command lifecycle.
+- Cursor integration writes project files and includes best-effort rule/skill guidance, but users should confirm their Cursor version recognizes the generated format.
+- CI configuration is included for Windows/macOS/Linux and Node 18/20/22; it still needs to run in a hosted repository before stable release.
+
+## Requirements
+
+- Node.js 18 or newer
+- OpenSpec CLI available on `PATH`
+
+Install OpenSpec if needed:
+
+```sh
+npm install -g @fission-ai/openspec
+```
+
+## Installation
+
+```sh
+npm install -g @nick848/fet
+```
+
+For local development:
+
+```sh
+npm install
+npm run build
+node dist/cli/index.js --help
+```
+
+## Quick Start
+
+In a project that should use OpenSpec:
+
+```sh
+fet init
+fet doctor
+```
+
+Then follow your OpenSpec workflow:
+
+```sh
+fet propose
+fet apply
+fet verify
+fet verify --done
+fet sync
+fet archive
+```
+
+## Generated Files
+
+FET may create or update:
+
+- `AGENTS.md`
+- `openspec/config.yaml` under the `fet:` namespace
+- `openspec/fet-state.json`
+- `openspec/changes/<change-id>/fet-state.json`
+- `openspec/changes/<change-id>/.fet/verify-instructions.md`
+- `.cursor/skills/fet-*/SKILL.md`
+- `.cursor/rules/fet-context.mdc`
+
+FET only owns marked managed regions. User content outside managed regions should be preserved.
+
+During `fet init`, FET also adds a managed block to `.gitignore` for local workflow state such as `openspec/fet-state.json`, lock files, and generated verify instructions.
+
+## Safety Model
+
+FET is a local workflow helper. It is not a sandbox, CI gate, or cryptographic audit system. Direct `openspec` calls can bypass FET workflow gates. Teams that require enforcement should repeat validation in CI and branch protection rules.
+
+## Development
+
+```sh
+npm run typecheck
+npm run test
+npm run build
+npm run release:check
+```
+
+## License
+
+MIT

package/dist/chunk-FZOVNHE7.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+
+// src/errors/codes.ts
+var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
+  ErrorCode2["Unknown"] = "UNKNOWN";
+  ErrorCode2["InvalidArguments"] = "INVALID_ARGUMENTS";
+  ErrorCode2["OpenSpecNotFound"] = "OPENSPEC_NOT_FOUND";
+  ErrorCode2["OpenSpecUnsupportedVersion"] = "OPENSPEC_UNSUPPORTED_VERSION";
+  ErrorCode2["OpenSpecCommandFailed"] = "OPENSPEC_COMMAND_FAILED";
+  ErrorCode2["OpenSpecStructureUnknown"] = "OPENSPEC_STRUCTURE_UNKNOWN";
+  ErrorCode2["StateSchemaUnsupported"] = "STATE_SCHEMA_UNSUPPORTED";
+  ErrorCode2["StateCorrupted"] = "STATE_CORRUPTED";
+  ErrorCode2["LockHeld"] = "LOCK_HELD";
+  ErrorCode2["UserCancelled"] = "USER_CANCELLED";
+  ErrorCode2["UnsafeScriptApprovalRequired"] = "UNSAFE_SCRIPT_APPROVAL_REQUIRED";
+  ErrorCode2["ToolAdapterConflict"] = "TOOL_ADAPTER_CONFLICT";
+  ErrorCode2["ConfigInvalid"] = "CONFIG_INVALID";
+  ErrorCode2["FileSystemError"] = "FILE_SYSTEM_ERROR";
+  return ErrorCode2;
+})(ErrorCode || {});
+function exitCodeForError(code) {
+  switch (code) {
+    case "INVALID_ARGUMENTS" /* InvalidArguments */:
+    case "CONFIG_INVALID" /* ConfigInvalid */:
+      return 2;
+    case "OPENSPEC_NOT_FOUND" /* OpenSpecNotFound */:
+    case "OPENSPEC_UNSUPPORTED_VERSION" /* OpenSpecUnsupportedVersion */:
+      return 3;
+    case "OPENSPEC_COMMAND_FAILED" /* OpenSpecCommandFailed */:
+      return 4;
+    case "OPENSPEC_STRUCTURE_UNKNOWN" /* OpenSpecStructureUnknown */:
+    case "STATE_SCHEMA_UNSUPPORTED" /* StateSchemaUnsupported */:
+    case "STATE_CORRUPTED" /* StateCorrupted */:
+    case "TOOL_ADAPTER_CONFLICT" /* ToolAdapterConflict */:
+    case "FILE_SYSTEM_ERROR" /* FileSystemError */:
+      return 5;
+    case "LOCK_HELD" /* LockHeld */:
+      return 6;
+    case "USER_CANCELLED" /* UserCancelled */:
+      return 7;
+    case "UNSAFE_SCRIPT_APPROVAL_REQUIRED" /* UnsafeScriptApprovalRequired */:
+      return 8;
+    case "UNKNOWN" /* Unknown */:
+    default:
+      return 1;
+  }
+}
+
+// src/errors/fet-error.ts
+var FetError = class extends Error {
+  code;
+  exitCode;
+  details;
+  recoverable;
+  suggestedCommand;
+  cause;
+  constructor(options) {
+    super(options.message);
+    this.name = "FetError";
+    this.code = options.code;
+    this.exitCode = exitCodeForError(options.code);
+    this.details = options.details;
+    this.recoverable = options.recoverable ?? true;
+    this.suggestedCommand = options.suggestedCommand;
+    this.cause = options.cause;
+  }
+  toJSON() {
+    return {
+      code: this.code,
+      exitCode: this.exitCode,
+      message: this.message,
+      details: this.details,
+      recoverable: this.recoverable,
+      suggestedCommand: this.suggestedCommand
+    };
+  }
+};
+function toFetError(error) {
+  if (error instanceof FetError) {
+    return error;
+  }
+  if (error instanceof Error) {
+    return new FetError({
+      code: "UNKNOWN" /* Unknown */,
+      message: error.message,
+      recoverable: false,
+      cause: error
+    });
+  }
+  return new FetError({
+    code: "UNKNOWN" /* Unknown */,
+    message: "Unknown error",
+    details: error,
+    recoverable: false
+  });
+}
+
+export {
+  ErrorCode,
+  exitCodeForError,
+  FetError,
+  toFetError
+};
+//# sourceMappingURL=chunk-FZOVNHE7.js.map

package/dist/chunk-FZOVNHE7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors/codes.ts","../src/errors/fet-error.ts"],"sourcesContent":["export enum ErrorCode {\n  Unknown = \"UNKNOWN\",\n  InvalidArguments = \"INVALID_ARGUMENTS\",\n  OpenSpecNotFound = \"OPENSPEC_NOT_FOUND\",\n  OpenSpecUnsupportedVersion = \"OPENSPEC_UNSUPPORTED_VERSION\",\n  OpenSpecCommandFailed = \"OPENSPEC_COMMAND_FAILED\",\n  OpenSpecStructureUnknown = \"OPENSPEC_STRUCTURE_UNKNOWN\",\n  StateSchemaUnsupported = \"STATE_SCHEMA_UNSUPPORTED\",\n  StateCorrupted = \"STATE_CORRUPTED\",\n  LockHeld = \"LOCK_HELD\",\n  UserCancelled = \"USER_CANCELLED\",\n  UnsafeScriptApprovalRequired = \"UNSAFE_SCRIPT_APPROVAL_REQUIRED\",\n  ToolAdapterConflict = \"TOOL_ADAPTER_CONFLICT\",\n  ConfigInvalid = \"CONFIG_INVALID\",\n  FileSystemError = \"FILE_SYSTEM_ERROR\"\n}\n\nexport function exitCodeForError(code: ErrorCode): number {\n  switch (code) {\n    case ErrorCode.InvalidArguments:\n    case ErrorCode.ConfigInvalid:\n      return 2;\n    case ErrorCode.OpenSpecNotFound:\n    case ErrorCode.OpenSpecUnsupportedVersion:\n      return 3;\n    case ErrorCode.OpenSpecCommandFailed:\n      return 4;\n    case ErrorCode.OpenSpecStructureUnknown:\n    case ErrorCode.StateSchemaUnsupported:\n    case ErrorCode.StateCorrupted:\n    case ErrorCode.ToolAdapterConflict:\n    case ErrorCode.FileSystemError:\n      return 5;\n    case ErrorCode.LockHeld:\n      return 6;\n    case ErrorCode.UserCancelled:\n      return 7;\n    case ErrorCode.UnsafeScriptApprovalRequired:\n      return 8;\n    case ErrorCode.Unknown:\n    default:\n      return 1;\n  }\n}\n","import { ErrorCode, exitCodeForError } from \"./codes.js\";\n\nexport interface FetErrorOptions {\n  code: ErrorCode;\n  message: string;\n  details?: unknown;\n  recoverable?: boolean;\n  suggestedCommand?: string;\n  cause?: unknown;\n}\n\nexport class FetError extends Error {\n  readonly code: ErrorCode;\n  readonly exitCode: number;\n  readonly details?: unknown;\n  readonly recoverable: boolean;\n  readonly suggestedCommand?: string;\n  override readonly cause?: unknown;\n\n  constructor(options: FetErrorOptions) {\n    super(options.message);\n    this.name = \"FetError\";\n    this.code = options.code;\n    this.exitCode = exitCodeForError(options.code);\n    this.details = options.details;\n    this.recoverable = options.recoverable ?? true;\n    this.suggestedCommand = options.suggestedCommand;\n    this.cause = options.cause;\n  }\n\n  toJSON() {\n    return {\n      code: this.code,\n      exitCode: this.exitCode,\n      message: this.message,\n      details: this.details,\n      recoverable: this.recoverable,\n      suggestedCommand: this.suggestedCommand\n    };\n  }\n}\n\nexport function toFetError(error: unknown): FetError {\n  if (error instanceof FetError) {\n    return error;\n  }\n\n  if (error instanceof Error) {\n    return new FetError({\n      code: ErrorCode.Unknown,\n      message: error.message,\n      recoverable: false,\n      cause: error\n    });\n  }\n\n  return new FetError({\n    code: ErrorCode.Unknown,\n    message: \"Unknown error\",\n    details: error,\n    recoverable: false\n  });\n}\n"],"mappings":";;;AAAO,IAAK,YAAL,kBAAKA,eAAL;AACL,EAAAA,WAAA,aAAU;AACV,EAAAA,WAAA,sBAAmB;AACnB,EAAAA,WAAA,sBAAmB;AACnB,EAAAA,WAAA,gCAA6B;AAC7B,EAAAA,WAAA,2BAAwB;AACxB,EAAAA,WAAA,8BAA2B;AAC3B,EAAAA,WAAA,4BAAyB;AACzB,EAAAA,WAAA,oBAAiB;AACjB,EAAAA,WAAA,cAAW;AACX,EAAAA,WAAA,mBAAgB;AAChB,EAAAA,WAAA,kCAA+B;AAC/B,EAAAA,WAAA,yBAAsB;AACtB,EAAAA,WAAA,mBAAgB;AAChB,EAAAA,WAAA,qBAAkB;AAdR,SAAAA;AAAA,GAAA;AAiBL,SAAS,iBAAiB,MAAyB;AACxD,UAAQ,MAAM;AAAA,IACZ,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL;AACE,aAAO;AAAA,EACX;AACF;;;AChCO,IAAM,WAAN,cAAuB,MAAM;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACS;AAAA,EAElB,YAAY,SAA0B;AACpC,UAAM,QAAQ,OAAO;AACrB,SAAK,OAAO;AACZ,SAAK,OAAO,QAAQ;AACpB,SAAK,WAAW,iBAAiB,QAAQ,IAAI;AAC7C,SAAK,UAAU,QAAQ;AACvB,SAAK,cAAc,QAAQ,eAAe;AAC1C,SAAK,mBAAmB,QAAQ;AAChC,SAAK,QAAQ,QAAQ;AAAA,EACvB;AAAA,EAEA,SAAS;AACP,WAAO;AAAA,MACL,MAAM,KAAK;AAAA,MACX,UAAU,KAAK;AAAA,MACf,SAAS,KAAK;AAAA,MACd,SAAS,KAAK;AAAA,MACd,aAAa,KAAK;AAAA,MAClB,kBAAkB,KAAK;AAAA,IACzB;AAAA,EACF;AACF;AAEO,SAAS,WAAW,OAA0B;AACnD,MAAI,iBAAiB,UAAU;AAC7B,WAAO;AAAA,EACT;AAEA,MAAI,iBAAiB,OAAO;AAC1B,WAAO,IAAI,SAAS;AAAA,MAClB;AAAA,MACA,SAAS,MAAM;AAAA,MACf,aAAa;AAAA,MACb,OAAO;AAAA,IACT,CAAC;AAAA,EACH;AAEA,SAAO,IAAI,SAAS;AAAA,IAClB;AAAA,IACA,SAAS;AAAA,IACT,SAAS;AAAA,IACT,aAAa;AAAA,EACf,CAAC;AACH;","names":["ErrorCode"]}