@fenglimg/fabric-shared 1.7.0 → 1.8.0-rc.2

package/dist/chunk-3SZRB42B.js

@@ -0,0 +1,90 @@
+// src/errors/fabric-error.ts
+var FabricError = class extends Error {
+  actionHint;
+  fixable;
+  details;
+  constructor(message, opts) {
+    super(message);
+    if (!opts.actionHint || opts.actionHint.length === 0) {
+      throw new Error("FabricError: actionHint is required and must be non-empty");
+    }
+    this.name = this.constructor.name;
+    this.actionHint = opts.actionHint;
+    this.fixable = opts.fixable ?? false;
+    this.details = opts.details;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      code: this.code,
+      message: this.message,
+      actionHint: this.actionHint,
+      fixable: this.fixable,
+      ...this.details !== void 0 ? { details: this.details } : {}
+    };
+  }
+};
+
+// src/errors/config-error.ts
+var ConfigError = class extends FabricError {
+  httpStatus = 400;
+};
+var ConfigPathInvalidError = class extends ConfigError {
+  code = "config_path_invalid";
+};
+var GenericConfigError = class extends ConfigError {
+  code = "config_error";
+};
+
+// src/errors/rule-error.ts
+var RuleError = class extends FabricError {
+  httpStatus = 422;
+};
+var RuleValidationError = class extends RuleError {
+  code = "rule_validation_error";
+};
+
+// src/errors/io-error.ts
+var IOFabricError = class extends FabricError {
+  httpStatus = 500;
+};
+var PathEscapeError = class extends IOFabricError {
+  code = "PATH_OUTSIDE_PROJECT_ROOT";
+  httpStatus = 403;
+};
+var GenericIOError = class extends IOFabricError {
+  code = "io_error";
+};
+
+// src/errors/mcp-error.ts
+var MCPError = class extends FabricError {
+};
+var McpToolError = class extends MCPError {
+  code = "mcp_tool_error";
+  httpStatus = 500;
+};
+
+// src/errors/init-error.ts
+var InitError = class extends FabricError {
+  httpStatus = 500;
+};
+var InitFrameworkUnknownError = class extends InitError {
+  code = "init_framework_unknown";
+};
+
+export {
+  FabricError,
+  ConfigError,
+  ConfigPathInvalidError,
+  GenericConfigError,
+  RuleError,
+  RuleValidationError,
+  IOFabricError,
+  PathEscapeError,
+  GenericIOError,
+  MCPError,
+  McpToolError,
+  InitError,
+  InitFrameworkUnknownError
+};

package/dist/{chunk-5H2PVNB2.js → chunk-BLXHC5HA.js}

@@ -32,7 +32,7 @@ var enMessages = {
   "cli.bootstrap.description": "Install Fabric bootstrap prompts for supported AI clients.",
   "cli.bootstrap.install.description": "Copy Fabric bootstrap templates into native client locations.",
   "cli.bootstrap.install.args.clients.description": "Optional comma-separated client filter, for example claude,cursor,codex.",
-  "cli.bootstrap.install.no-targets": "No bootstrap targets detected. Pass --clients claude,cursor,windsurf,roo,gemini,codex to install explicitly.",
+  "cli.bootstrap.install.no-targets": "No bootstrap targets detected. Pass --clients claude,cursor,codex to install explicitly.",
   "cli.bootstrap.install.installed": "Installed {path}",
   "cli.bootstrap.install.skipped-header": "Skipped {path}: Fabric Bootstrap header already present.",
   "cli.bootstrap.install.prepended": "Prepended {path}",
@@ -40,19 +40,23 @@ var enMessages = {
   "cli.config.description": "Manage Fabric MCP client configuration.",
   "cli.config.clients.claude": "Claude Code CLI",
   "cli.config.install.description": "Install Fabric MCP server entries into detected client configs.",
-  "cli.config.install.args.clients.description": "Optional comma-separated client filter, for example cursor,codex,gemini.",
+  "cli.config.install.args.clients.description": "Optional comma-separated client filter, for example cursor,codex.",
   "cli.config.install.args.dry-run.description": "Preview detected write operations without modifying files.",
-  "cli.config.errors.unknown-client": 'Unknown client "{client}". Use a comma-separated list such as cursor,codex,gemini.',
+  "cli.config.errors.unknown-client": 'Unknown client "{client}". Use a comma-separated list such as cursor,codex.',
   "cli.config.errors.expected-object": "Expected object in {path}",
   "cli.config.install.no-configs": "No Fabric MCP client config detected. Create the client directory or set clientPaths in fabric.config.json.",
   "cli.config.install.no-config-path": "Skipping {client}: no config path detected.",
   "cli.config.install.dry-run": "[dry-run] {client}: would write {path}",
   "cli.config.install.wrote": "{client}: wrote {path}",
   "cli.doctor.description": "Run Fabric target-state diagnostics.",
+  "doctor.section.fixable": "Fixable errors:",
+  "doctor.section.manual": "Manual errors:",
+  "doctor.section.warnings": "Warnings:",
   "cli.doctor.args.target.description": "Target project path. Defaults to CLI arg, EXTERNAL_FIXTURE_PATH, fabric.config.json, then cwd.",
   "cli.doctor.args.fix.description": "Repair deterministic derived Fabric state, including meta, rule-test index, bootstrap, and events ledger.",
   "cli.doctor.args.json.description": "Print the doctor report as JSON.",
   "cli.doctor.args.strict.description": "Treat warnings as failures.",
+  "cli.doctor.args.force.description": "Run even if a serve process appears to hold the lock.",
   "cli.hooks.description": "Manage Fabric Git hook templates.",
   "cli.hooks.install.description": "Install the Fabric Husky pre-commit hook template.",
   "cli.hooks.install.args.target.description": "Target project path, default is the current working directory.",
@@ -85,6 +89,11 @@ var enMessages = {
   "cli.init.mcp.install.invalid": 'Invalid --mcp-install value "{value}" \u2014 falling back to global',
   "cli.init.mcp.local.installing": "Running {manager} add -D @fenglimg/fabric-server...",
   "cli.init.mcp.local.installed": "Installed to devDependencies",
+  "cli.init.mcp.scope.description": "Claude MCP config scope: project (writes .mcp.json) or user (writes ~/.claude.json)",
+  "cli.init.mcp.scope.invalid": 'Invalid --scope value "{value}" \u2014 falling back to project',
+  "cli.init.mcp.scope.project": "Writes .mcp.json in project root (per Claude Code spec)",
+  "cli.init.mcp.scope.user": "Writes ~/.claude.json (user-scoped, applies to all projects)",
+  "cli.init.wizard.mcp-scope": "Claude MCP config scope (project/.mcp.json or user/~/.claude.json) [{defaultValue}]",
   "cli.init.created-path": "{label} {path}",
   "cli.init.skipped-existing-path": "{label} {path}: already exists.",
   "cli.init.force.overwritten": "Overwritten",
@@ -156,9 +165,9 @@ var enMessages = {
   "cli.init.capabilities.follow-up.install": "install client assets",
   "cli.init.capabilities.follow-up.manual": "manual step required",
   "cli.init.next-step.message": "run fab hooks install to add the Day 4 pre-commit pipeline.",
-  "cli.init.reason-message.claude-body": ".fabric/forensic.json is ready; use the agents-md-init skill to finish internal Fabric initialization.",
+  "cli.init.reason-message.claude-body": ".fabric/forensic.json is ready; use the fabric-init skill to finish internal Fabric initialization.",
   "cli.init.reason-message.codex-body": ".fabric/forensic.json is ready; continue with the repo skill at .agents/skills/fabric-init/SKILL.md and enable features.codex_hooks = true for Codex hooks.",
-  "cli.init.reason-message.multi-body": ".fabric/forensic.json is ready; continue in your installed client flow: Claude can use agents-md-init, and Codex can use .agents/skills/fabric-init/SKILL.md with features.codex_hooks = true.",
+  "cli.init.reason-message.multi-body": ".fabric/forensic.json is ready; continue in your installed client flow: Claude can use fabric-init, and Codex can use .agents/skills/fabric-init/SKILL.md with features.codex_hooks = true.",
   "cli.init.reason-message.installable-body": ".fabric/forensic.json is ready; some detected clients support Fabric follow-up but still need client assets installed.",
   "cli.init.reason-message.manual-body": ".fabric/forensic.json is ready; some detected clients still need manual follow-up because no Fabric skill is installed for them yet.",
   "cli.init.codex-hooks.created": "{label} {path} with Codex hooks config (requires features.codex_hooks = true).",
@@ -208,6 +217,7 @@ var enMessages = {
   "cli.serve.args.host.description": "Listen host, default 127.0.0.1. Set FABRIC_AUTH_TOKEN to enable Bearer auth for non-localhost binding.",
   "cli.serve.args.target.description": "Target project path. Defaults to CLI arg, EXTERNAL_FIXTURE_PATH, fabric.config.json, then cwd.",
   "cli.serve.args.debug.description": "Print target resolution details to stderr.",
+  "cli.serve.args.force.description": "Force-acquire the serve lock even if another serve process appears to be running.",
   "cli.serve.ready.title": "Fabric Dashboard",
   "cli.serve.warning.host-fallback": "--host {host} requires FABRIC_AUTH_TOKEN; falling back to 127.0.0.1 for safety",
   "cli.serve.error.port-in-use": "Port {port} in use - try --port {nextPort}",
@@ -457,7 +467,7 @@ var zhCNMessages = {
   "cli.bootstrap.description": "\u4E3A\u652F\u6301\u7684 AI \u5BA2\u6237\u7AEF\u5B89\u88C5 Fabric \u5F15\u5BFC\u63D0\u793A\u6A21\u677F\u3002",
   "cli.bootstrap.install.description": "\u5C06 Fabric \u5F15\u5BFC\u6A21\u677F\u590D\u5236\u5230\u5404\u5BA2\u6237\u7AEF\u7684\u539F\u751F\u4F4D\u7F6E\u3002",
   "cli.bootstrap.install.args.clients.description": "\u53EF\u9009\u7684\u9017\u53F7\u5206\u9694\u5BA2\u6237\u7AEF\u8FC7\u6EE4\u5668\uFF0C\u4F8B\u5982 claude,cursor,codex\u3002",
-  "cli.bootstrap.install.no-targets": "\u672A\u68C0\u6D4B\u5230\u53EF\u5B89\u88C5\u7684 bootstrap \u76EE\u6807\u3002\u53EF\u663E\u5F0F\u4F20\u5165 --clients claude,cursor,windsurf,roo,gemini,codex\u3002",
+  "cli.bootstrap.install.no-targets": "\u672A\u68C0\u6D4B\u5230\u53EF\u5B89\u88C5\u7684 bootstrap \u76EE\u6807\u3002\u53EF\u663E\u5F0F\u4F20\u5165 --clients claude,cursor,codex\u3002",
   "cli.bootstrap.install.installed": "\u5DF2\u5B89\u88C5 {path}",
   "cli.bootstrap.install.skipped-header": "\u5DF2\u8DF3\u8FC7 {path}\uFF1AFabric Bootstrap \u5934\u90E8\u5DF2\u5B58\u5728\u3002",
   "cli.bootstrap.install.prepended": "\u5DF2\u524D\u7F6E\u5199\u5165 {path}",
@@ -465,19 +475,23 @@ var zhCNMessages = {
   "cli.config.description": "\u7BA1\u7406 Fabric MCP \u5BA2\u6237\u7AEF\u914D\u7F6E\u3002",
   "cli.config.clients.claude": "Claude Code CLI",
   "cli.config.install.description": "\u5C06 Fabric MCP \u670D\u52A1\u7AEF\u6761\u76EE\u5B89\u88C5\u5230\u68C0\u6D4B\u5230\u7684\u5BA2\u6237\u7AEF\u914D\u7F6E\u4E2D\u3002",
-  "cli.config.install.args.clients.description": "\u53EF\u9009\u7684\u9017\u53F7\u5206\u9694\u5BA2\u6237\u7AEF\u8FC7\u6EE4\u5668\uFF0C\u4F8B\u5982 cursor,codex,gemini\u3002",
+  "cli.config.install.args.clients.description": "\u53EF\u9009\u7684\u9017\u53F7\u5206\u9694\u5BA2\u6237\u7AEF\u8FC7\u6EE4\u5668\uFF0C\u4F8B\u5982 cursor,codex\u3002",
   "cli.config.install.args.dry-run.description": "\u4EC5\u9884\u89C8\u5C06\u8981\u53D1\u751F\u7684\u5199\u5165\u64CD\u4F5C\uFF0C\u4E0D\u4FEE\u6539\u6587\u4EF6\u3002",
-  "cli.config.errors.unknown-client": "\u672A\u77E5\u5BA2\u6237\u7AEF\u201C{client}\u201D\u3002\u8BF7\u4F7F\u7528\u9017\u53F7\u5206\u9694\u5217\u8868\uFF0C\u4F8B\u5982 cursor,codex,gemini\u3002",
+  "cli.config.errors.unknown-client": "\u672A\u77E5\u5BA2\u6237\u7AEF\u201C{client}\u201D\u3002\u8BF7\u4F7F\u7528\u9017\u53F7\u5206\u9694\u5217\u8868\uFF0C\u4F8B\u5982 cursor,codex\u3002",
   "cli.config.errors.expected-object": "{path} \u4E2D\u5E94\u4E3A\u5BF9\u8C61\u3002",
   "cli.config.install.no-configs": "\u672A\u68C0\u6D4B\u5230 Fabric MCP \u5BA2\u6237\u7AEF\u914D\u7F6E\u3002\u8BF7\u521B\u5EFA\u5BA2\u6237\u7AEF\u76EE\u5F55\uFF0C\u6216\u5728 fabric.config.json \u4E2D\u8BBE\u7F6E clientPaths\u3002",
   "cli.config.install.no-config-path": "\u8DF3\u8FC7 {client}\uFF1A\u672A\u68C0\u6D4B\u5230\u914D\u7F6E\u8DEF\u5F84\u3002",
   "cli.config.install.dry-run": "[dry-run] {client}\uFF1A\u5C06\u5199\u5165 {path}",
   "cli.config.install.wrote": "{client}\uFF1A\u5DF2\u5199\u5165 {path}",
   "cli.doctor.description": "\u8FD0\u884C Fabric \u76EE\u6807\u6001\u8BCA\u65AD\u3002",
+  "doctor.section.fixable": "\u53EF\u4FEE\u590D\u9519\u8BEF\uFF1A",
+  "doctor.section.manual": "\u9700\u624B\u52A8\u4FEE\u590D\uFF1A",
+  "doctor.section.warnings": "\u8B66\u544A\uFF1A",
   "cli.doctor.args.target.description": "\u76EE\u6807\u9879\u76EE\u8DEF\u5F84\u3002\u9ED8\u8BA4\u4F9D\u6B21\u4F7F\u7528 CLI \u53C2\u6570\u3001EXTERNAL_FIXTURE_PATH\u3001fabric.config.json\u3001\u5F53\u524D\u76EE\u5F55\u3002",
   "cli.doctor.args.fix.description": "\u4FEE\u590D\u786E\u5B9A\u6027\u6D3E\u751F\u7684 Fabric \u72B6\u6001\uFF0C\u5305\u62EC meta\u3001rule-test index\u3001bootstrap \u548C events ledger\u3002",
   "cli.doctor.args.json.description": "\u4EE5 JSON \u8F93\u51FA doctor \u62A5\u544A\u3002",
   "cli.doctor.args.strict.description": "\u5C06 warning \u4E5F\u89C6\u4E3A\u5931\u8D25\u3002",
+  "cli.doctor.args.force.description": "\u5373\u4F7F serve \u8FDB\u7A0B\u6301\u6709\u9501\uFF0C\u4E5F\u5F3A\u5236\u8FD0\u884C\u3002",
   "cli.hooks.description": "\u7BA1\u7406 Fabric Git \u94A9\u5B50\u6A21\u677F\u3002",
   "cli.hooks.install.description": "\u5B89\u88C5 Fabric Husky pre-commit \u94A9\u5B50\u6A21\u677F\u3002",
   "cli.hooks.install.args.target.description": "\u76EE\u6807\u9879\u76EE\u8DEF\u5F84\uFF0C\u9ED8\u8BA4\u4E3A\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55\u3002",
@@ -510,6 +524,11 @@ var zhCNMessages = {
   "cli.init.mcp.install.invalid": "\u65E0\u6548\u7684 --mcp-install \u503C\u201C{value}\u201D\uFF0C\u5C06\u56DE\u9000\u5230 global",
   "cli.init.mcp.local.installing": "\u6B63\u5728\u8FD0\u884C {manager} add -D @fenglimg/fabric-server...",
   "cli.init.mcp.local.installed": "\u5DF2\u5B89\u88C5\u5230 devDependencies",
+  "cli.init.mcp.scope.description": "Claude MCP \u914D\u7F6E\u8303\u56F4\uFF1Aproject\uFF08\u5199\u5165 .mcp.json\uFF09\u6216 user\uFF08\u5199\u5165 ~/.claude.json\uFF09",
+  "cli.init.mcp.scope.invalid": "\u65E0\u6548\u7684 --scope \u503C\u201C{value}\u201D\uFF0C\u5C06\u56DE\u9000\u5230 project",
+  "cli.init.mcp.scope.project": "\u5199\u5165\u9879\u76EE\u6839\u76EE\u5F55\u7684 .mcp.json\uFF08\u7B26\u5408 Claude Code \u89C4\u8303\uFF09",
+  "cli.init.mcp.scope.user": "\u5199\u5165 ~/.claude.json\uFF08\u7528\u6237\u8303\u56F4\uFF0C\u9002\u7528\u4E8E\u6240\u6709\u9879\u76EE\uFF09",
+  "cli.init.wizard.mcp-scope": "Claude MCP \u914D\u7F6E\u8303\u56F4\uFF08project/.mcp.json \u6216 user/~/.claude.json\uFF09[{defaultValue}]",
   "cli.init.created-path": "{label} {path}",
   "cli.init.skipped-existing-path": "{label} {path}\uFF1A\u5DF2\u5B58\u5728\u3002",
   "cli.init.force.overwritten": "\u5DF2\u8986\u76D6",
@@ -581,9 +600,9 @@ var zhCNMessages = {
   "cli.init.capabilities.follow-up.install": "\u5B89\u88C5\u5BA2\u6237\u7AEF\u8D44\u4EA7",
   "cli.init.capabilities.follow-up.manual": "\u9700\u8981\u624B\u52A8\u540E\u7EED\u5904\u7406",
   "cli.init.next-step.message": "\u8FD0\u884C fab hooks install \u4EE5\u6DFB\u52A0\u7B2C 4 \u5929\u7684 pre-commit \u6D41\u6C34\u7EBF\u3002",
-  "cli.init.reason-message.claude-body": ".fabric/forensic.json \u5DF2\u5C31\u7EEA\uFF1B\u8BF7\u4F7F\u7528 agents-md-init skill \u5B8C\u6210 Fabric \u5185\u90E8\u521D\u59CB\u5316\u3002",
+  "cli.init.reason-message.claude-body": ".fabric/forensic.json \u5DF2\u5C31\u7EEA\uFF1B\u8BF7\u4F7F\u7528 fabric-init skill \u5B8C\u6210 Fabric \u5185\u90E8\u521D\u59CB\u5316\u3002",
   "cli.init.reason-message.codex-body": ".fabric/forensic.json \u5DF2\u5C31\u7EEA\uFF1B\u8BF7\u7EE7\u7EED\u4F7F\u7528\u4ED3\u5E93\u5185\u7684 .agents/skills/fabric-init/SKILL.md\uFF0C\u5E76\u4E3A Codex hooks \u542F\u7528 features.codex_hooks = true\u3002",
-  "cli.init.reason-message.multi-body": ".fabric/forensic.json \u5DF2\u5C31\u7EEA\uFF1B\u8BF7\u6309\u5DF2\u5B89\u88C5\u5BA2\u6237\u7AEF\u7EE7\u7EED\u540E\u7EED\u6D41\u7A0B\uFF1AClaude \u4F7F\u7528 agents-md-init\uFF0CCodex \u4F7F\u7528 .agents/skills/fabric-init/SKILL.md\uFF0C\u5E76\u542F\u7528 features.codex_hooks = true\u3002",
+  "cli.init.reason-message.multi-body": ".fabric/forensic.json \u5DF2\u5C31\u7EEA\uFF1B\u8BF7\u6309\u5DF2\u5B89\u88C5\u5BA2\u6237\u7AEF\u7EE7\u7EED\u540E\u7EED\u6D41\u7A0B\uFF1AClaude \u4F7F\u7528 fabric-init\uFF0CCodex \u4F7F\u7528 .agents/skills/fabric-init/SKILL.md\uFF0C\u5E76\u542F\u7528 features.codex_hooks = true\u3002",
   "cli.init.reason-message.installable-body": ".fabric/forensic.json \u5DF2\u5C31\u7EEA\uFF1B\u90E8\u5206\u5DF2\u68C0\u6D4B\u5230\u7684\u5BA2\u6237\u7AEF\u5DF2\u652F\u6301 Fabric \u540E\u7EED\u63A5\u529B\uFF0C\u4F46\u4ECD\u9700\u5B89\u88C5\u5BA2\u6237\u7AEF\u8D44\u4EA7\u3002",
   "cli.init.reason-message.manual-body": ".fabric/forensic.json \u5DF2\u5C31\u7EEA\uFF1B\u90E8\u5206\u5DF2\u68C0\u6D4B\u5230\u7684\u5BA2\u6237\u7AEF\u5C1A\u672A\u5B89\u88C5 Fabric skill\uFF0C\u9700\u8981\u624B\u52A8\u5B8C\u6210\u540E\u7EED\u521D\u59CB\u5316\u3002",
   "cli.init.codex-hooks.created": "{label} {path}\uFF0C\u5E76\u5199\u5165 Codex hooks \u914D\u7F6E\uFF08\u9700\u542F\u7528 features.codex_hooks = true\uFF09\u3002",
@@ -633,6 +652,7 @@ var zhCNMessages = {
   "cli.serve.args.host.description": "\u76D1\u542C\u4E3B\u673A\uFF0C\u9ED8\u8BA4 127.0.0.1\u3002\u82E5\u9700\u7ED1\u5B9A\u5230\u975E localhost\uFF0C\u8BF7\u8BBE\u7F6E FABRIC_AUTH_TOKEN \u4EE5\u542F\u7528 Bearer \u9274\u6743\u3002",
   "cli.serve.args.target.description": "\u76EE\u6807\u9879\u76EE\u8DEF\u5F84\u3002\u9ED8\u8BA4\u4F9D\u6B21\u4F7F\u7528 CLI \u53C2\u6570\u3001EXTERNAL_FIXTURE_PATH\u3001fabric.config.json\u3001\u5F53\u524D\u76EE\u5F55\u3002",
   "cli.serve.args.debug.description": "\u5C06\u76EE\u6807\u89E3\u6790\u7EC6\u8282\u8F93\u51FA\u5230 stderr\u3002",
+  "cli.serve.args.force.description": "\u5373\u4F7F\u53E6\u4E00\u4E2A serve \u8FDB\u7A0B\u6B63\u5728\u8FD0\u884C\uFF0C\u4E5F\u5F3A\u5236\u83B7\u53D6 serve \u9501\u3002",
   "cli.serve.ready.title": "Fabric \u4EEA\u8868\u76D8",
   "cli.serve.warning.host-fallback": "--host {host} \u9700\u8981 FABRIC_AUTH_TOKEN\uFF1B\u4E3A\u5B89\u5168\u8D77\u89C1\u5DF2\u56DE\u9000\u5230 127.0.0.1",
   "cli.serve.error.port-in-use": "\u7AEF\u53E3 {port} \u5DF2\u88AB\u5360\u7528\uFF0C\u53EF\u5C1D\u8BD5 --port {nextPort}",

package/dist/chunk-GI6L6VTT.js

@@ -0,0 +1,176 @@
+// src/detector.ts
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+function detectFramework(root) {
+  const evidence = [];
+  const creatorConfigPath = join(root, "project.config.json");
+  if (existsSync(creatorConfigPath)) {
+    const version = readCreatorVersion(creatorConfigPath);
+    return {
+      kind: "cocos-creator",
+      version,
+      subkind: inferCocosSubkind(root, version),
+      evidence: version === "unknown" ? ["project.config.json"] : [`project.config.json: creator.version=${version}`],
+      framework: "cocos-creator",
+      confidence: "HIGH",
+      ast_evidence: [],
+      co_packages: collectProjectFileEvidence(root, ["package.json", "tsconfig.json"])
+    };
+  }
+  const packageJsonPath = join(root, "package.json");
+  if (existsSync(packageJsonPath)) {
+    const packageJson = readPackageJson(packageJsonPath);
+    const creatorVersion = packageJson.creator?.version;
+    if (typeof creatorVersion === "string" && creatorVersion.trim().length > 0) {
+      const deps2 = collectDependencyVersions(packageJson);
+      return {
+        kind: "cocos-creator",
+        version: creatorVersion,
+        subkind: inferCocosSubkind(root, creatorVersion),
+        evidence: [`package.json: creator.version=${creatorVersion}`],
+        framework: "cocos-creator",
+        confidence: "HIGH",
+        ast_evidence: [],
+        co_packages: collectCoPackages(deps2, "cocos-creator", root)
+      };
+    }
+    const deps = collectDependencyVersions(packageJson);
+    for (const [dependencyName, kind] of [
+      ["next", "next"],
+      ["vite", "vite"],
+      ["react", "react"],
+      ["vue", "vue"]
+    ]) {
+      if (deps.has(dependencyName)) {
+        const version = deps.get(dependencyName) ?? "unknown";
+        evidence.push(`package.json dependency: ${dependencyName}@${version}`);
+        return {
+          kind,
+          version,
+          subkind: inferPackageSubkind(kind),
+          evidence,
+          framework: kind,
+          confidence: determinePackageConfidence(kind, deps, root),
+          ast_evidence: [],
+          co_packages: collectCoPackages(deps, kind, root)
+        };
+      }
+    }
+    evidence.push("package.json");
+  }
+  if (existsSync(join(root, "Cargo.toml"))) {
+    return {
+      kind: "rust",
+      version: "unknown",
+      subkind: "cargo-project",
+      evidence: ["Cargo.toml"],
+      framework: "rust",
+      confidence: "HIGH",
+      ast_evidence: [],
+      co_packages: collectProjectFileEvidence(root, ["Cargo.lock"])
+    };
+  }
+  if (existsSync(join(root, "pyproject.toml"))) {
+    return {
+      kind: "python",
+      version: "unknown",
+      subkind: "pyproject",
+      evidence: ["pyproject.toml"],
+      framework: "python",
+      confidence: "HIGH",
+      ast_evidence: [],
+      co_packages: collectProjectFileEvidence(root, ["uv.lock", "poetry.lock", "requirements.txt"])
+    };
+  }
+  return {
+    kind: "unknown",
+    version: "unknown",
+    subkind: "unknown",
+    evidence,
+    framework: "unknown",
+    confidence: "LOW",
+    ast_evidence: [],
+    co_packages: []
+  };
+}
+function readPackageJson(packageJsonPath) {
+  try {
+    return JSON.parse(readFileSync(packageJsonPath, "utf8"));
+  } catch {
+    return {};
+  }
+}
+function readCreatorVersion(creatorConfigPath) {
+  try {
+    const creatorConfig = JSON.parse(readFileSync(creatorConfigPath, "utf8"));
+    return creatorConfig.creator?.version ?? "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+function collectDependencyVersions(packageJson) {
+  return new Map([
+    ...Object.entries(packageJson.dependencies ?? {}),
+    ...Object.entries(packageJson.devDependencies ?? {}),
+    ...Object.entries(packageJson.peerDependencies ?? {}),
+    ...Object.entries(packageJson.optionalDependencies ?? {})
+  ]);
+}
+function inferCocosSubkind(root, version) {
+  const majorVersion = Number.parseInt(version.split(".")[0] ?? "", 10);
+  if (majorVersion === 2) {
+    return "javascript-traditional";
+  }
+  if (majorVersion >= 3) {
+    return "typescript-component";
+  }
+  return existsSync(join(root, "tsconfig.json")) ? "typescript-component" : "javascript-traditional";
+}
+function inferPackageSubkind(kind) {
+  switch (kind) {
+    case "next":
+      return "next-application";
+    case "vite":
+      return "vite-application";
+    case "react":
+      return "react-application";
+    case "vue":
+      return "vue-application";
+    default:
+      return "unknown";
+  }
+}
+function determinePackageConfidence(kind, deps, root) {
+  const coPackages = collectCoPackages(deps, kind, root);
+  return coPackages.length > 0 ? "HIGH" : "MEDIUM";
+}
+function collectCoPackages(deps, kind, root) {
+  const expectedPackagesByFramework = {
+    next: ["react", "react-dom", "typescript"],
+    vite: ["@vitejs/plugin-react", "@vitejs/plugin-vue", "typescript", "react", "vue"],
+    react: ["react-dom", "@types/react", "@types/react-dom"],
+    vue: ["@vitejs/plugin-vue", "typescript"],
+    "cocos-creator": ["typescript"]
+  };
+  const expectedProjectFilesByFramework = {
+    next: ["next.config.js", "next.config.mjs", "next.config.ts", "tsconfig.json"],
+    vite: ["vite.config.js", "vite.config.mjs", "vite.config.ts", "tsconfig.json"],
+    react: ["tsconfig.json"],
+    vue: ["vue.config.js", "vite.config.ts", "tsconfig.json"],
+    "cocos-creator": ["project.config.json", "tsconfig.json"]
+  };
+  return [
+    ...compactStrings((expectedPackagesByFramework[kind] ?? []).map((packageName) => deps.has(packageName) ? packageName : null)),
+    ...collectProjectFileEvidence(root, expectedProjectFilesByFramework[kind] ?? [])
+  ];
+}
+function collectProjectFileEvidence(root, relativePaths) {
+  return relativePaths.filter((relativePath) => existsSync(join(root, relativePath)));
+}
+function compactStrings(values) {
+  return [...new Set(values.filter((value) => value !== null && value !== void 0 && value.length > 0))];
+}
+
+export {
+  detectFramework
+};

package/dist/chunk-KV27CZH3.js

@@ -0,0 +1,223 @@
+// src/schemas/api-contracts.ts
+import { z } from "zod";
+var structuredWarningSchema = z.object({
+  code: z.string(),
+  file: z.string(),
+  line: z.number().optional(),
+  action_hint: z.string()
+});
+var _ruleDescriptionSchema = z.object({
+  summary: z.string(),
+  intent_clues: z.array(z.string()),
+  tech_stack: z.array(z.string()),
+  impact: z.array(z.string()),
+  must_read_if: z.string(),
+  entities: z.array(z.string()).optional()
+});
+var _descriptionIndexItemSchema = z.object({
+  stable_id: z.string(),
+  level: z.enum(["L0", "L1", "L2"]),
+  required: z.boolean(),
+  selectable: z.boolean(),
+  description: _ruleDescriptionSchema
+});
+var _requirementProfileSchema = z.object({
+  target_path: z.string(),
+  path_segments: z.array(z.string()),
+  extension: z.string(),
+  inferred_domain: z.array(z.string()),
+  known_tech: z.array(z.string()),
+  user_intent: z.string(),
+  intent_tokens: z.array(z.string()),
+  impact_hints: z.array(z.string()),
+  detected_entities: z.array(z.string())
+});
+var _selectionPolicySchema = z.object({
+  required_levels: z.tuple([z.literal("L0"), z.literal("L2")]),
+  ai_selectable_levels: z.tuple([z.literal("L1")]),
+  final_fetch_rule: z.literal("required_stable_ids + ai_selected_l1_stable_ids")
+});
+var planContextInputSchema = z.object({
+  paths: z.array(z.string()).min(1).describe("Candidate file paths to build neutral rule selection context for"),
+  intent: z.string().optional().describe("User-stated requirement or implementation intent; used only to build a neutral requirement profile"),
+  known_tech: z.array(z.string()).optional().describe("Known technologies involved in the requirement profile"),
+  detected_entities: z.record(z.array(z.string())).optional().describe("Optional path-keyed detected entities for the requirement profile"),
+  client_hash: z.string().optional().describe("Revision hash from a prior fab_plan_context response; enables stale detection"),
+  correlation_id: z.string().optional().describe("Optional caller-provided correlation id for Event Ledger records"),
+  session_id: z.string().optional().describe("Optional caller-provided session id for Event Ledger records")
+});
+var planContextOutputSchema = z.object({
+  revision_hash: z.string(),
+  stale: z.boolean(),
+  selection_token: z.string(),
+  entries: z.array(
+    z.object({
+      path: z.string(),
+      requirement_profile: _requirementProfileSchema,
+      description_index: z.array(_descriptionIndexItemSchema),
+      required_stable_ids: z.array(z.string()),
+      ai_selectable_stable_ids: z.array(z.string()),
+      initial_selected_stable_ids: z.array(z.string()),
+      selection_policy: _selectionPolicySchema
+    })
+  ),
+  shared: z.object({
+    required_stable_ids: z.array(z.string()),
+    ai_selectable_stable_ids: z.array(z.string()),
+    description_index: z.array(_descriptionIndexItemSchema),
+    preflight_diagnostics: z.array(
+      z.object({
+        code: z.literal("missing_description"),
+        severity: z.literal("warn"),
+        message: z.string(),
+        stable_ids: z.array(z.string()).optional(),
+        path: z.string().optional()
+      })
+    )
+  }),
+  warnings: z.array(structuredWarningSchema).optional()
+});
+var planContextAnnotations = {
+  readOnlyHint: true,
+  idempotentHint: true,
+  destructiveHint: false,
+  openWorldHint: false,
+  title: "Plan rule context"
+};
+var _rulesEntrySchema = z.object({ path: z.string(), content: z.string() });
+var _humanLockedSchema = z.object({ file: z.string(), excerpt: z.string() });
+var _descriptionStubSchema = z.object({ path: z.string(), description: z.string() });
+var getRulesInputSchema = z.object({
+  path: z.string().describe("Target file path to query rules for"),
+  client_hash: z.string().optional().describe("Revision hash from prior fab_get_rules response; enables stale detection"),
+  correlation_id: z.string().optional().describe("Optional caller-provided correlation id for Event Ledger records"),
+  session_id: z.string().optional().describe("Optional caller-provided session id for Event Ledger records")
+});
+var getRulesOutputSchema = z.object({
+  revision_hash: z.string(),
+  stale: z.boolean(),
+  rules: z.object({
+    L0: z.string(),
+    L1: z.array(_rulesEntrySchema),
+    L2: z.array(_rulesEntrySchema),
+    human_locked_nearby: z.array(_humanLockedSchema),
+    description_stubs: z.array(_descriptionStubSchema).optional()
+  }),
+  warnings: z.array(structuredWarningSchema).optional()
+});
+var getRulesAnnotations = {
+  readOnlyHint: true,
+  idempotentHint: true,
+  destructiveHint: false,
+  openWorldHint: false,
+  title: "Get rule content"
+};
+var RULE_SECTION_NAMES_TUPLE = ["MISSION_STATEMENT", "MANDATORY_INJECTION", "BUSINESS_LOGIC_CHUNKS", "CONTEXT_INFO"];
+var ruleSectionsInputSchema = z.object({
+  selection_token: z.string().min(1).describe("Selection token returned by fab_plan_context"),
+  sections: z.array(z.enum(RULE_SECTION_NAMES_TUPLE)).min(1).describe("Structured rule sections to fetch"),
+  ai_selected_stable_ids: z.array(z.string()).describe("AI-selected L1 stable_ids chosen from fab_plan_context ai_selectable_stable_ids"),
+  ai_selection_reasons: z.record(z.string().min(1)).describe("Reason for each AI-selected L1 stable_id"),
+  correlation_id: z.string().optional().describe("Optional caller-provided correlation id for Event Ledger records"),
+  session_id: z.string().optional().describe("Optional caller-provided session id for Event Ledger records")
+});
+var ruleSectionsOutputSchema = z.object({
+  revision_hash: z.string(),
+  precedence: z.tuple([z.literal("L2"), z.literal("L1"), z.literal("L0")]),
+  selected_stable_ids: z.array(z.string()),
+  rules: z.array(
+    z.object({
+      stable_id: z.string(),
+      level: z.enum(["L0", "L1", "L2"]),
+      path: z.string(),
+      sections: z.record(z.string())
+    })
+  ),
+  diagnostics: z.array(
+    z.object({
+      code: z.literal("missing_section"),
+      severity: z.literal("warn"),
+      stable_id: z.string(),
+      section: z.enum(RULE_SECTION_NAMES_TUPLE),
+      message: z.string()
+    })
+  ),
+  warnings: z.array(structuredWarningSchema).optional()
+});
+var ruleSectionsAnnotations = {
+  readOnlyHint: true,
+  idempotentHint: true,
+  destructiveHint: false,
+  openWorldHint: false,
+  title: "Filter rule sections"
+};
+var ledgerSourceSchema = z.enum(["ai", "human"]);
+var timestampFilterSchema = z.preprocess((value) => {
+  if (value === void 0 || value === null || value === "") {
+    return void 0;
+  }
+  if (typeof value === "number") {
+    return value;
+  }
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    if (trimmed.length === 0) {
+      return void 0;
+    }
+    if (/^\d+$/.test(trimmed)) {
+      return Number.parseInt(trimmed, 10);
+    }
+    const parsed = Date.parse(trimmed);
+    return Number.isNaN(parsed) ? value : parsed;
+  }
+  return value;
+}, z.number().int().nonnegative());
+var ledgerQuerySchema = z.object({
+  source: ledgerSourceSchema.optional(),
+  since: timestampFilterSchema.optional()
+});
+var historyStateQuerySchema = z.object({
+  ledger_id: z.string().trim().min(1).optional(),
+  ts: timestampFilterSchema.optional()
+}).superRefine((value, ctx) => {
+  const provided = [value.ledger_id, value.ts].filter((entry) => entry !== void 0);
+  if (provided.length !== 1) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: "Provide exactly one of ledger_id or ts.",
+      path: ["ledger_id"]
+    });
+  }
+});
+var humanLockApproveRequestSchema = z.object({
+  file: z.string().min(1),
+  start_line: z.number().int().positive(),
+  end_line: z.number().int().positive(),
+  new_hash: z.string().min(1)
+});
+var humanLockFileParamsSchema = z.object({
+  file: z.string().min(1)
+});
+var annotateIntentRequestSchema = z.object({
+  ledger_entry_id: z.string().min(1),
+  annotation: z.string().trim().min(1)
+});
+
+export {
+  structuredWarningSchema,
+  planContextInputSchema,
+  planContextOutputSchema,
+  planContextAnnotations,
+  getRulesInputSchema,
+  getRulesOutputSchema,
+  getRulesAnnotations,
+  ruleSectionsInputSchema,
+  ruleSectionsOutputSchema,
+  ruleSectionsAnnotations,
+  ledgerSourceSchema,
+  ledgerQuerySchema,
+  historyStateQuerySchema,
+  humanLockApproveRequestSchema,
+  humanLockFileParamsSchema,
+  annotateIntentRequestSchema
+};