@haaaiawd/anws 2.1.2 → 2.2.1

package/README.md

@@ -3,8 +3,8 @@
 <img src="assets/logo-cli.png" width="260" alt="Anws">
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
-[![Version](https://img.shields.io/badge/version-v2.0.3-7FB5B6)](https://github.com/Haaaiawd/Anws/releases)
-[![Targets](https://img.shields.io/badge/Targets-Windsurf%20%7C%20Claude%20Code%20%7C%20Copilot%20%7C%20Cursor%20%7C%20Codex%20Preview%20%7C%20OpenCode%20%7C%20Trae%20%7C%20Qoder%20%7C%20Kilo%20Code-blueviolet)](https://github.com/Haaaiawd/Anws)
+[![Version](https://img.shields.io/badge/version-v2.2.1-7FB5B6)](https://github.com/Haaaiawd/ANWS/releases)
+[![Targets](https://img.shields.io/badge/Targets-Windsurf%20%7C%20Claude%20Code%20%7C%20Copilot%20%7C%20Cursor%20%7C%20Codex%20Preview%20%7C%20OpenCode%20%7C%20Trae%20%7C%20Qoder%20%7C%20Kilo%20Code-blueviolet)](https://github.com/Haaaiawd/ANWS)
 
 [English](./README.md) | [中文](./README_CN.md)
 
@@ -58,6 +58,30 @@ Anws addresses those problems with:
 
 ---
 
+## What's New in v2.2.0
+
+`v2.2.0` closes the loop between design review, task review, implementation, and upgrade safety.
+
+- **Closed-loop challenge review**
+  - `/challenge` now combines `design-reviewer`, `task-reviewer`, and `code-reviewer`
+  - implementation drift is reviewed against PRD, Architecture, ADR, System Design, and `05_TASKS.md`
+  - findings are written into `07_CHALLENGE_REPORT.md` with contract-first severity semantics
+
+- **Code fidelity evidence layer**
+  - new `code-reviewer` skill checks Contract Drift, Task Drift, Test Drift, Missing Change Backflow, and foundational test gaps
+  - the review is static and evidence-based, so it does not pretend runtime validation has passed
+
+- **Contract closure across workflows**
+  - `blueprint`, `task-planner`, `task-reviewer`, `challenge`, `change`, and `forge` now carry public contract coverage explicitly
+  - API, CLI, config, file format, error, persistence, and verification responsibilities are tracked as first-class workflow concerns
+
+- **Forge verification gate**
+  - `/forge` reads the latest `07_CHALLENGE_REPORT.md` before implementation work continues
+  - unresolved Critical findings block forge; unresolved High findings require explicit human sign-off
+  - high-risk implementation waves can run `code-reviewer` before manual verification
+
+---
+
 ## What's New in v2.0.0
 
 `v2.0.0` is a **major release**. It is not just a template refresh; it upgrades the project protocol.
@@ -213,9 +237,9 @@ Use Anws as a lifecycle, not just a folder pack.
 | `/genesis` | Start from zero with PRD and architecture | Vague idea | PRD, architecture, ADRs |
 | `/probe` | Analyze a legacy codebase before change | Existing code | Risk report |
 | `/design-system` | Design one system in depth | Architecture overview | System design doc |
-| `/challenge` | Review design or tasks with adversarial pressure | Docs / tasks | Challenge report |
+| `/challenge` | Review design, tasks, and implementation fidelity with adversarial pressure | Docs / tasks / code | Challenge report |
 | `/blueprint` | Break architecture into executable work | PRD + architecture | `05_TASKS.md` |
-| `/forge` | Turn approved tasks into code | Tasks | Working implementation |
+| `/forge` | Turn approved tasks into code with challenge-report and contract gates | Tasks + review state | Working implementation |
 | `/change` | Modify an existing task only | Small scoped change | Updated task/design docs |
 | `/explore` | Research ambiguous or strategic topics | Topic | Exploration report |
 | `/craft` | Create workflows, skills, and prompts | Creation request | Reusable assets |

package/lib/manifest.js

@@ -1,209 +1,210 @@
-'use strict';
-
-const { getTarget } = require('./adapters');
-
-/**
- * MANAGED_FILES — anws 托管文件清单
- *
- * 此数组列出 anws 包负责管理的所有文件路径（相对于目标项目根目录）。
- */
-const RESOURCE_REGISTRY = [
-  { id: 'blueprint', type: 'workflow', source: '.agents/workflows/blueprint.md', fileName: 'blueprint.md' },
-  { id: 'challenge', type: 'workflow', source: '.agents/workflows/challenge.md', fileName: 'challenge.md' },
-  { id: 'change', type: 'workflow', source: '.agents/workflows/change.md', fileName: 'change.md' },
-  { id: 'craft', type: 'workflow', source: '.agents/workflows/craft.md', fileName: 'craft.md' },
-  { id: 'design-system', type: 'workflow', source: '.agents/workflows/design-system.md', fileName: 'design-system.md' },
-  { id: 'explore', type: 'workflow', source: '.agents/workflows/explore.md', fileName: 'explore.md' },
-  { id: 'forge', type: 'workflow', source: '.agents/workflows/forge.md', fileName: 'forge.md' },
-  { id: 'genesis', type: 'workflow', source: '.agents/workflows/genesis.md', fileName: 'genesis.md' },
-  { id: 'probe', type: 'workflow', source: '.agents/workflows/probe.md', fileName: 'probe.md' },
-  { id: 'quickstart', type: 'workflow', source: '.agents/workflows/quickstart.md', fileName: 'quickstart.md' },
-  { id: 'upgrade', type: 'workflow', source: '.agents/workflows/upgrade.md', fileName: 'upgrade.md' },
-  { id: 'anws-system', type: 'skill', source: '.agents/skills/anws-system/SKILL.md', fileName: 'anws-system/SKILL.md', targets: ['codex', 'trae'] },
-  { id: 'concept-modeler', type: 'skill', source: '.agents/skills/concept-modeler/SKILL.md', fileName: 'concept-modeler/SKILL.md' },
-  { id: 'design-reviewer', type: 'skill', source: '.agents/skills/design-reviewer/SKILL.md', fileName: 'design-reviewer/SKILL.md' },
-  { id: 'nexus-mapper', type: 'skill', source: '.agents/skills/nexus-mapper/SKILL.md', fileName: 'nexus-mapper/SKILL.md' },
-  { id: 'nexus-mapper-language-customization', type: 'skill', source: '.agents/skills/nexus-mapper/references/language-customization.md', fileName: 'nexus-mapper/references/language-customization.md' },
-  { id: 'nexus-mapper-output-schema', type: 'skill', source: '.agents/skills/nexus-mapper/references/output-schema.md', fileName: 'nexus-mapper/references/output-schema.md' },
-  { id: 'nexus-mapper-probe-protocol', type: 'skill', source: '.agents/skills/nexus-mapper/references/probe-protocol.md', fileName: 'nexus-mapper/references/probe-protocol.md' },
-  { id: 'nexus-mapper-extract-ast', type: 'skill', source: '.agents/skills/nexus-mapper/scripts/extract_ast.py', fileName: 'nexus-mapper/scripts/extract_ast.py' },
-  { id: 'nexus-mapper-git-detective', type: 'skill', source: '.agents/skills/nexus-mapper/scripts/git_detective.py', fileName: 'nexus-mapper/scripts/git_detective.py' },
-  { id: 'nexus-mapper-languages', type: 'skill', source: '.agents/skills/nexus-mapper/scripts/languages.json', fileName: 'nexus-mapper/scripts/languages.json' },
-  { id: 'nexus-mapper-query-graph', type: 'skill', source: '.agents/skills/nexus-mapper/scripts/query_graph.py', fileName: 'nexus-mapper/scripts/query_graph.py' },
-  { id: 'nexus-mapper-requirements', type: 'skill', source: '.agents/skills/nexus-mapper/scripts/requirements.txt', fileName: 'nexus-mapper/scripts/requirements.txt' },
-  { id: 'report-template', type: 'skill', source: '.agents/skills/report-template/SKILL.md', fileName: 'report-template/SKILL.md' },
-  { id: 'report-template-reference', type: 'skill', source: '.agents/skills/report-template/references/REPORT_TEMPLATE.md', fileName: 'report-template/references/REPORT_TEMPLATE.md' },
-  { id: 'runtime-inspector', type: 'skill', source: '.agents/skills/runtime-inspector/SKILL.md', fileName: 'runtime-inspector/SKILL.md' },
-  { id: 'sequential-thinking', type: 'skill', source: '.agents/skills/sequential-thinking/SKILL.md', fileName: 'sequential-thinking/SKILL.md' },
-  { id: 'spec-writer', type: 'skill', source: '.agents/skills/spec-writer/SKILL.md', fileName: 'spec-writer/SKILL.md' },
-  { id: 'spec-writer-prd-template', type: 'skill', source: '.agents/skills/spec-writer/references/prd_template.md', fileName: 'spec-writer/references/prd_template.md' },
-  { id: 'system-architect', type: 'skill', source: '.agents/skills/system-architect/SKILL.md', fileName: 'system-architect/SKILL.md' },
-  { id: 'system-architect-rfc-template', type: 'skill', source: '.agents/skills/system-architect/references/rfc_template.md', fileName: 'system-architect/references/rfc_template.md' },
-  { id: 'system-designer', type: 'skill', source: '.agents/skills/system-designer/SKILL.md', fileName: 'system-designer/SKILL.md' },
-  { id: 'system-designer-detail-template', type: 'skill', source: '.agents/skills/system-designer/references/system-design-detail-template.md', fileName: 'system-designer/references/system-design-detail-template.md' },
-  { id: 'system-designer-template', type: 'skill', source: '.agents/skills/system-designer/references/system-design-template.md', fileName: 'system-designer/references/system-design-template.md' },
-  { id: 'task-planner', type: 'skill', source: '.agents/skills/task-planner/SKILL.md', fileName: 'task-planner/SKILL.md' },
-  { id: 'task-planner-template', type: 'skill', source: '.agents/skills/task-planner/references/TASK_TEMPLATE.md', fileName: 'task-planner/references/TASK_TEMPLATE.md' },
-  { id: 'task-reviewer', type: 'skill', source: '.agents/skills/task-reviewer/SKILL.md', fileName: 'task-reviewer/SKILL.md' },
-  { id: 'tech-evaluator', type: 'skill', source: '.agents/skills/tech-evaluator/SKILL.md', fileName: 'tech-evaluator/SKILL.md' },
-  { id: 'tech-evaluator-adr-template', type: 'skill', source: '.agents/skills/tech-evaluator/references/ADR_TEMPLATE.md', fileName: 'tech-evaluator/references/ADR_TEMPLATE.md' }
-];
-
-function toArray(value) {
-  return Array.isArray(value) ? value : [value];
-}
-
-function toProjectionFileName(resource, projectionType, targetId) {
-  if ((targetId === 'codex' || targetId === 'trae') && projectionType === 'skills' && resource.type === 'workflow') {
-    return `anws-system/references/${resource.id}.md`;
-  }
-  if (projectionType === 'commands') {
-    return `${resource.id}.md`;
-  }
-  if (projectionType === 'prompts') {
-    return targetId === 'copilot' ? `${resource.id}.prompt.md` : `${resource.id}.md`;
-  }
-  if (projectionType === 'agents') {
-    return `${resource.id}.md`;
-  }
-  return resource.fileName;
-}
-
-function buildProjectionEntries(targetId) {
-  const target = getTarget(targetId);
-  const typeMap = target.projectionTypes;
-
-  return RESOURCE_REGISTRY.flatMap((resource) => {
-    if (resource.targets && !resource.targets.includes(target.id)) {
-      return [];
-    }
-    const projectionTypes = typeMap[resource.type];
-    if (!projectionTypes) {
-      return [];
-    }
-
-    return toArray(projectionTypes).map((projectionType) => {
-      const outputFileName = toProjectionFileName(resource, projectionType, target.id);
-      return {
-        ...resource,
-        projectionType,
-        outputRoot: target.projections[projectionType],
-        outputPath: `${target.projections[projectionType]}/${outputFileName}`
-      };
-    });
-  });
-}
-
-function buildManagedManifest(targetIds = ['antigravity']) {
-  return toArray(targetIds).flatMap((targetId) => {
-    const target = getTarget(targetId);
-    const entries = buildProjectionEntries(target.id).map((entry) => ({
-      ...entry,
-      targetId: target.id,
-      targetLabel: target.label,
-      ownershipKey: `${target.id}:${entry.outputPath}`
-    }));
-
-    if (!target.rootAgentFile) {
-      return entries;
-    }
-
-    return [
-      {
-        id: 'root-agents',
-        type: 'root',
-        source: 'AGENTS.md',
-        fileName: 'AGENTS.md',
-        projectionType: 'rootAgentFile',
-        outputRoot: '.',
-        outputPath: 'AGENTS.md',
-        targetId: target.id,
-        targetLabel: target.label,
-        ownershipKey: `${target.id}:AGENTS.md`
-      },
-      ...entries
-    ];
-  });
-}
-
-function buildProjectionPlan(targetIds = ['antigravity'], resources = RESOURCE_REGISTRY) {
-  return toArray(targetIds).map((targetId) => {
-    const target = getTarget(targetId);
-    const typeMap = target.projectionTypes;
-    const projectionEntries = resources.flatMap((resource) => {
-      if (resource.targets && !resource.targets.includes(target.id)) {
-        return [];
-      }
-      const projectionTypes = typeMap[resource.type];
-      if (!projectionTypes) {
-        return [];
-      }
-
-      return toArray(projectionTypes).map((projectionType) => {
-        const outputFileName = toProjectionFileName(resource, projectionType, target.id);
-        const outputPath = `${target.projections[projectionType]}/${outputFileName}`;
-        return {
-          ...resource,
-          projectionType,
-          outputRoot: target.projections[projectionType],
-          outputPath,
-          targetId: target.id,
-          targetLabel: target.label,
-          ownershipKey: `${target.id}:${outputPath}`
-        };
-      });
-    });
-
-    const managedFiles = target.rootAgentFile
-      ? ['AGENTS.md', ...projectionEntries.map((item) => item.outputPath)]
-      : projectionEntries.map((item) => item.outputPath);
-
-    return {
-      target,
-      targetId: target.id,
-      targetLabel: target.label,
-      managedFiles,
-      userProtectedFiles: buildUserProtectedFiles(target.id),
-      projectionEntries,
-      ownership: projectionEntries.map((item) => item.ownershipKey)
-    };
-  });
-}
-
-function buildManagedFiles(targetId = 'antigravity') {
-  return buildManagedManifest(targetId).map((item) => item.outputPath);
-}
-
-function buildUserProtectedFiles(targetId = 'antigravity') {
-  const target = getTarget(targetId);
-  return target.rootAgentFile ? ['AGENTS.md'] : [];
-}
-
-function findByType(type) {
-  return RESOURCE_REGISTRY.filter((item) => item.type === type);
-}
-
-const MANAGED_FILES = buildManagedFiles('antigravity');
-
-/**
- * USER_PROTECTED_FILES — 用户保护文件
- *
- * 这些文件在项目初始化后通常会包含特定于项目的配置。
- * anws update 默认会跳过这些文件。
- */
-const USER_PROTECTED_FILES = buildUserProtectedFiles('antigravity');
-
-module.exports = {
-  RESOURCE_REGISTRY,
-  buildManagedManifest,
-  buildProjectionPlan,
-  buildManagedFiles,
-  buildProjectionEntries,
-  buildUserProtectedFiles,
-  findByType,
-  MANAGED_FILES,
-  USER_PROTECTED_FILES
-};
-
-
-
+'use strict';
+
+const { getTarget } = require('./adapters');
+
+/**
+ * MANAGED_FILES — anws 托管文件清单
+ *
+ * 此数组列出 anws 包负责管理的所有文件路径（相对于目标项目根目录）。
+ */
+const RESOURCE_REGISTRY = [
+  { id: 'blueprint', type: 'workflow', source: '.agents/workflows/blueprint.md', fileName: 'blueprint.md' },
+  { id: 'challenge', type: 'workflow', source: '.agents/workflows/challenge.md', fileName: 'challenge.md' },
+  { id: 'change', type: 'workflow', source: '.agents/workflows/change.md', fileName: 'change.md' },
+  { id: 'craft', type: 'workflow', source: '.agents/workflows/craft.md', fileName: 'craft.md' },
+  { id: 'design-system', type: 'workflow', source: '.agents/workflows/design-system.md', fileName: 'design-system.md' },
+  { id: 'explore', type: 'workflow', source: '.agents/workflows/explore.md', fileName: 'explore.md' },
+  { id: 'forge', type: 'workflow', source: '.agents/workflows/forge.md', fileName: 'forge.md' },
+  { id: 'genesis', type: 'workflow', source: '.agents/workflows/genesis.md', fileName: 'genesis.md' },
+  { id: 'probe', type: 'workflow', source: '.agents/workflows/probe.md', fileName: 'probe.md' },
+  { id: 'quickstart', type: 'workflow', source: '.agents/workflows/quickstart.md', fileName: 'quickstart.md' },
+  { id: 'upgrade', type: 'workflow', source: '.agents/workflows/upgrade.md', fileName: 'upgrade.md' },
+  { id: 'anws-system', type: 'skill', source: '.agents/skills/anws-system/SKILL.md', fileName: 'anws-system/SKILL.md', targets: ['codex', 'trae'] },
+  { id: 'concept-modeler', type: 'skill', source: '.agents/skills/concept-modeler/SKILL.md', fileName: 'concept-modeler/SKILL.md' },
+  { id: 'code-reviewer', type: 'skill', source: '.agents/skills/code-reviewer/SKILL.md', fileName: 'code-reviewer/SKILL.md' },
+  { id: 'design-reviewer', type: 'skill', source: '.agents/skills/design-reviewer/SKILL.md', fileName: 'design-reviewer/SKILL.md' },
+  { id: 'nexus-mapper', type: 'skill', source: '.agents/skills/nexus-mapper/SKILL.md', fileName: 'nexus-mapper/SKILL.md' },
+  { id: 'nexus-mapper-language-customization', type: 'skill', source: '.agents/skills/nexus-mapper/references/language-customization.md', fileName: 'nexus-mapper/references/language-customization.md' },
+  { id: 'nexus-mapper-output-schema', type: 'skill', source: '.agents/skills/nexus-mapper/references/output-schema.md', fileName: 'nexus-mapper/references/output-schema.md' },
+  { id: 'nexus-mapper-probe-protocol', type: 'skill', source: '.agents/skills/nexus-mapper/references/probe-protocol.md', fileName: 'nexus-mapper/references/probe-protocol.md' },
+  { id: 'nexus-mapper-extract-ast', type: 'skill', source: '.agents/skills/nexus-mapper/scripts/extract_ast.py', fileName: 'nexus-mapper/scripts/extract_ast.py' },
+  { id: 'nexus-mapper-git-detective', type: 'skill', source: '.agents/skills/nexus-mapper/scripts/git_detective.py', fileName: 'nexus-mapper/scripts/git_detective.py' },
+  { id: 'nexus-mapper-languages', type: 'skill', source: '.agents/skills/nexus-mapper/scripts/languages.json', fileName: 'nexus-mapper/scripts/languages.json' },
+  { id: 'nexus-mapper-query-graph', type: 'skill', source: '.agents/skills/nexus-mapper/scripts/query_graph.py', fileName: 'nexus-mapper/scripts/query_graph.py' },
+  { id: 'nexus-mapper-requirements', type: 'skill', source: '.agents/skills/nexus-mapper/scripts/requirements.txt', fileName: 'nexus-mapper/scripts/requirements.txt' },
+  { id: 'report-template', type: 'skill', source: '.agents/skills/report-template/SKILL.md', fileName: 'report-template/SKILL.md' },
+  { id: 'report-template-reference', type: 'skill', source: '.agents/skills/report-template/references/REPORT_TEMPLATE.md', fileName: 'report-template/references/REPORT_TEMPLATE.md' },
+  { id: 'runtime-inspector', type: 'skill', source: '.agents/skills/runtime-inspector/SKILL.md', fileName: 'runtime-inspector/SKILL.md' },
+  { id: 'sequential-thinking', type: 'skill', source: '.agents/skills/sequential-thinking/SKILL.md', fileName: 'sequential-thinking/SKILL.md' },
+  { id: 'spec-writer', type: 'skill', source: '.agents/skills/spec-writer/SKILL.md', fileName: 'spec-writer/SKILL.md' },
+  { id: 'spec-writer-prd-template', type: 'skill', source: '.agents/skills/spec-writer/references/prd_template.md', fileName: 'spec-writer/references/prd_template.md' },
+  { id: 'system-architect', type: 'skill', source: '.agents/skills/system-architect/SKILL.md', fileName: 'system-architect/SKILL.md' },
+  { id: 'system-architect-rfc-template', type: 'skill', source: '.agents/skills/system-architect/references/rfc_template.md', fileName: 'system-architect/references/rfc_template.md' },
+  { id: 'system-designer', type: 'skill', source: '.agents/skills/system-designer/SKILL.md', fileName: 'system-designer/SKILL.md' },
+  { id: 'system-designer-detail-template', type: 'skill', source: '.agents/skills/system-designer/references/system-design-detail-template.md', fileName: 'system-designer/references/system-design-detail-template.md' },
+  { id: 'system-designer-template', type: 'skill', source: '.agents/skills/system-designer/references/system-design-template.md', fileName: 'system-designer/references/system-design-template.md' },
+  { id: 'task-planner', type: 'skill', source: '.agents/skills/task-planner/SKILL.md', fileName: 'task-planner/SKILL.md' },
+  { id: 'task-planner-template', type: 'skill', source: '.agents/skills/task-planner/references/TASK_TEMPLATE.md', fileName: 'task-planner/references/TASK_TEMPLATE.md' },
+  { id: 'task-reviewer', type: 'skill', source: '.agents/skills/task-reviewer/SKILL.md', fileName: 'task-reviewer/SKILL.md' },
+  { id: 'tech-evaluator', type: 'skill', source: '.agents/skills/tech-evaluator/SKILL.md', fileName: 'tech-evaluator/SKILL.md' },
+  { id: 'tech-evaluator-adr-template', type: 'skill', source: '.agents/skills/tech-evaluator/references/ADR_TEMPLATE.md', fileName: 'tech-evaluator/references/ADR_TEMPLATE.md' }
+];
+
+function toArray(value) {
+  return Array.isArray(value) ? value : [value];
+}
+
+function toProjectionFileName(resource, projectionType, targetId) {
+  if ((targetId === 'codex' || targetId === 'trae') && projectionType === 'skills' && resource.type === 'workflow') {
+    return `anws-system/references/${resource.id}.md`;
+  }
+  if (projectionType === 'commands') {
+    return `${resource.id}.md`;
+  }
+  if (projectionType === 'prompts') {
+    return targetId === 'copilot' ? `${resource.id}.prompt.md` : `${resource.id}.md`;
+  }
+  if (projectionType === 'agents') {
+    return `${resource.id}.md`;
+  }
+  return resource.fileName;
+}
+
+function buildProjectionEntries(targetId) {
+  const target = getTarget(targetId);
+  const typeMap = target.projectionTypes;
+
+  return RESOURCE_REGISTRY.flatMap((resource) => {
+    if (resource.targets && !resource.targets.includes(target.id)) {
+      return [];
+    }
+    const projectionTypes = typeMap[resource.type];
+    if (!projectionTypes) {
+      return [];
+    }
+
+    return toArray(projectionTypes).map((projectionType) => {
+      const outputFileName = toProjectionFileName(resource, projectionType, target.id);
+      return {
+        ...resource,
+        projectionType,
+        outputRoot: target.projections[projectionType],
+        outputPath: `${target.projections[projectionType]}/${outputFileName}`
+      };
+    });
+  });
+}
+
+function buildManagedManifest(targetIds = ['antigravity']) {
+  return toArray(targetIds).flatMap((targetId) => {
+    const target = getTarget(targetId);
+    const entries = buildProjectionEntries(target.id).map((entry) => ({
+      ...entry,
+      targetId: target.id,
+      targetLabel: target.label,
+      ownershipKey: `${target.id}:${entry.outputPath}`
+    }));
+
+    if (!target.rootAgentFile) {
+      return entries;
+    }
+
+    return [
+      {
+        id: 'root-agents',
+        type: 'root',
+        source: 'AGENTS.md',
+        fileName: 'AGENTS.md',
+        projectionType: 'rootAgentFile',
+        outputRoot: '.',
+        outputPath: 'AGENTS.md',
+        targetId: target.id,
+        targetLabel: target.label,
+        ownershipKey: `${target.id}:AGENTS.md`
+      },
+      ...entries
+    ];
+  });
+}
+
+function buildProjectionPlan(targetIds = ['antigravity'], resources = RESOURCE_REGISTRY) {
+  return toArray(targetIds).map((targetId) => {
+    const target = getTarget(targetId);
+    const typeMap = target.projectionTypes;
+    const projectionEntries = resources.flatMap((resource) => {
+      if (resource.targets && !resource.targets.includes(target.id)) {
+        return [];
+      }
+      const projectionTypes = typeMap[resource.type];
+      if (!projectionTypes) {
+        return [];
+      }
+
+      return toArray(projectionTypes).map((projectionType) => {
+        const outputFileName = toProjectionFileName(resource, projectionType, target.id);
+        const outputPath = `${target.projections[projectionType]}/${outputFileName}`;
+        return {
+          ...resource,
+          projectionType,
+          outputRoot: target.projections[projectionType],
+          outputPath,
+          targetId: target.id,
+          targetLabel: target.label,
+          ownershipKey: `${target.id}:${outputPath}`
+        };
+      });
+    });
+
+    const managedFiles = target.rootAgentFile
+      ? ['AGENTS.md', ...projectionEntries.map((item) => item.outputPath)]
+      : projectionEntries.map((item) => item.outputPath);
+
+    return {
+      target,
+      targetId: target.id,
+      targetLabel: target.label,
+      managedFiles,
+      userProtectedFiles: buildUserProtectedFiles(target.id),
+      projectionEntries,
+      ownership: projectionEntries.map((item) => item.ownershipKey)
+    };
+  });
+}
+
+function buildManagedFiles(targetId = 'antigravity') {
+  return buildManagedManifest(targetId).map((item) => item.outputPath);
+}
+
+function buildUserProtectedFiles(targetId = 'antigravity') {
+  const target = getTarget(targetId);
+  return target.rootAgentFile ? ['AGENTS.md'] : [];
+}
+
+function findByType(type) {
+  return RESOURCE_REGISTRY.filter((item) => item.type === type);
+}
+
+const MANAGED_FILES = buildManagedFiles('antigravity');
+
+/**
+ * USER_PROTECTED_FILES — 用户保护文件
+ *
+ * 这些文件在项目初始化后通常会包含特定于项目的配置。
+ * anws update 默认会跳过这些文件。
+ */
+const USER_PROTECTED_FILES = buildUserProtectedFiles('antigravity');
+
+module.exports = {
+  RESOURCE_REGISTRY,
+  buildManagedManifest,
+  buildProjectionPlan,
+  buildManagedFiles,
+  buildProjectionEntries,
+  buildUserProtectedFiles,
+  findByType,
+  MANAGED_FILES,
+  USER_PROTECTED_FILES
+};
+
+
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haaaiawd/anws",
-  "version": "2.1.2",
+  "version": "2.2.1",
   "description": "Anws — A spec-driven workflow framework for AI-assisted development. Empowers prompt engineers to build production-ready software through structured PRD → Architecture → Task decomposition. Works with Claude Code, GitHub Copilot, Cursor, Windsurf, and any tool that reads AGENTS.md.",
   "keywords": [
     "anws",
@@ -17,10 +17,10 @@
     "cursor",
     "windsurf"
   ],
-  "homepage": "https://github.com/Haaaiawd/Anws",
+  "homepage": "https://github.com/Haaaiawd/ANWS",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Haaaiawd/Anws.git"
+    "url": "git+https://github.com/Haaaiawd/ANWS.git"
   },
   "author": "haaaiawd <1134180104@qq.com>",
   "license": "MIT",