artifact-chain-assistant 0.14.2 → 0.15.0

package/adapters/claude/scripts/batch-merge.mjs

@@ -3,6 +3,7 @@
 
 import { readdir, readFile } from 'node:fs/promises';
 import { join, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
 
 /**
  * Severity ordering for status/decision aggregation.
@@ -250,7 +251,7 @@ export async function batchMerge(resultsDir, options = {}) {
 }
 
 // CLI entry point
-const isMain = import.meta.url === `file://${process.argv[1]}`;
+const isMain = Boolean(process.argv[1]) && import.meta.url === pathToFileURL(process.argv[1]).href;
 if (isMain) {
   const args = process.argv.slice(2);
   const resultsDir = args[0];

package/adapters/claude/scripts/batch-split.mjs

@@ -3,6 +3,7 @@
 
 import { readdir, readFile, stat } from 'node:fs/promises';
 import { join, relative, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
 
 /**
  * Recursively collect all .md files under a directory.
@@ -154,7 +155,7 @@ export async function batchSplit(targetDir, options = {}) {
 }
 
 // CLI entry point
-const isMain = import.meta.url === `file://${process.argv[1]}`;
+const isMain = Boolean(process.argv[1]) && import.meta.url === pathToFileURL(process.argv[1]).href;
 if (isMain) {
   const args = process.argv.slice(2);
   const targetDir = args[0];

package/adapters/claude/scripts/check-workflow-profile.mjs

@@ -6,6 +6,7 @@
 // @decision D-ACA-17
 // Thin CLI wrapper. scripts/lib/workflow-profile.mjs is the single resolver.
 import { resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
 import { buildCheckerOutput } from './lib/workflow-profile.mjs';
 import { checkAdoptionReadiness } from './lib/adoption-readiness.mjs';
 
@@ -32,7 +33,7 @@ export async function checkWorkflowProfile({ root = process.cwd(), action = 'rev
   };
 }
 
-const isMain = import.meta.url === `file://${process.argv[1]}`;
+const isMain = Boolean(process.argv[1]) && import.meta.url === pathToFileURL(process.argv[1]).href;
 if (isMain) {
   const args = process.argv.slice(2);
   const value = flag => {

package/adapters/claude/scripts/lib/adoption-readiness.mjs

@@ -1,23 +1,17 @@
-import { existsSync, statSync } from 'node:fs';
+import { existsSync, readFileSync, statSync } from 'node:fs';
 import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
-import { loadArtifactGraphConfig } from './artifact-graph-runtime.mjs';
+import { loadArtifactGraphConfig, loadProjectArtifactProfiles } from './artifact-graph-runtime.mjs';
 import { buildCheckerOutput, loadProfile } from './workflow-profile.mjs';
 
 const PROJECT_SHAPES = ['cli-library', 'web', 'desktop', 'skill-plugin'];
 const ADOPTION_STAGES = ['initial', 'legacy-backfill', 'daily-iteration'];
-
-const STAGE_CANDIDATES = {
-  initial: ['requirement', 'feature', 'decision'],
-  'legacy-backfill': ['feature', 'scenario', 'decision', 'design', 'test'],
-  'daily-iteration': ['requirement', 'spec', 'feature', 'scenario', 'decision', 'design', 'test'],
-};
-
-const SHAPE_CANDIDATES = {
-  'cli-library': ['cli_contract'],
-  web: ['ui_contract', 'api_contract'],
-  desktop: ['ui_contract', 'ipc_contract', 'e2e_test'],
-  'skill-plugin': ['agent_skill', 'hook_policy', 'prompt_packet'],
-};
+const APPLICABILITY = Object.freeze({
+  common_minimum: 'common_minimum',
+  project_standard: 'project_standard',
+  lifecycle: 'lifecycle',
+  conditional: 'conditional',
+  project_extra: 'project_extra',
+});
 
 const TEMPLATE_PATHS = {
   requirement: 'templates/core/requirement-entry.starter.md',
@@ -35,12 +29,166 @@ const TEMPLATE_PATHS = {
   agent_skill: 'templates/extended/agent/agent_skill/starter.md',
   hook_policy: 'templates/extended/agent/hook_policy/starter.md',
   prompt_packet: 'templates/extended/agent/prompt_packet/starter.md',
+  data_contract: 'templates/extended/contracts/data_contract/starter.md',
+  release_policy: 'templates/extended/governance/release_policy/starter.md',
+  domain_model: 'templates/extended/domain/domain_model/starter.md',
 };
 
 function unique(values) {
   return [...new Set(values)];
 }
 
+function flowMappingKeys(text) {
+  const keys = [];
+  let depth = 0;
+  let index = 0;
+  let quote = null;
+  let collect = false;
+  let token = '';
+  let expectKey = false;
+  while (index < text.length) {
+    const char = text[index];
+    if (quote) {
+      if (char === '\\' && quote === '"') {
+        if (collect) token += text[index + 1] ?? '';
+        index += 2;
+        continue;
+      }
+      if (char === quote) {
+        quote = null;
+        index += 1;
+        continue;
+      }
+      if (collect) token += char;
+      index += 1;
+      continue;
+    }
+    if (char === '"' || char === "'") {
+      quote = char;
+      if (depth === 1 && expectKey) {
+        collect = true;
+        expectKey = false;
+        token = '';
+      }
+      index += 1;
+      continue;
+    }
+    if (char === '{' || char === '[') {
+      depth += 1;
+      if (char === '{' && depth === 1) expectKey = true;
+      index += 1;
+      continue;
+    }
+    if (char === '}' || char === ']') {
+      depth -= 1;
+      collect = false;
+      token = '';
+      if (depth === 0) break;
+      index += 1;
+      continue;
+    }
+    if (depth === 1 && expectKey) {
+      if (char === ' ' || char === '\t' || char === '\n' || char === '\r' || char === ',') {
+        index += 1;
+        continue;
+      }
+      if (/[A-Za-z]/u.test(char)) {
+        collect = true;
+        expectKey = false;
+        token = char;
+        index += 1;
+        continue;
+      }
+    }
+    if (collect) {
+      if (/[A-Za-z0-9_-]/u.test(char)) {
+        token += char;
+        index += 1;
+        continue;
+      }
+      if (char === ' ' || char === '\t') {
+        index += 1;
+        continue;
+      }
+      if (char === ':') {
+        if (/^[A-Za-z][A-Za-z0-9_-]*$/u.test(token)) keys.push(token);
+        collect = false;
+        token = '';
+        index += 1;
+        continue;
+      }
+      collect = false;
+      token = '';
+    }
+    if (char === ',' && depth === 1) expectKey = true;
+    index += 1;
+  }
+  return keys;
+}
+
+function blockMappingKeys(source, typesIndex) {
+  const lineStart = source.lastIndexOf('\n', typesIndex) + 1;
+  const lineEnd = source.indexOf('\n', typesIndex);
+  const typesLine = source.slice(lineStart, lineEnd < 0 ? source.length : lineEnd);
+  const indent = (typesLine.match(/^[ \t]*/u)?.[0] ?? '').length;
+  if (lineEnd < 0) return [];
+  const keys = [];
+  let childIndent = null;
+  for (const line of source.slice(lineEnd + 1).split('\n')) {
+    if (/^[ \t]*#/u.test(line) || /^[ \t]*$/u.test(line)) continue;
+    const leading = line.match(/^[ \t]*/u)?.[0] ?? '';
+    if (leading.includes('\t') || leading.length <= indent) break;
+    childIndent ??= leading.length;
+    if (leading.length !== childIndent) continue;
+    const key = line.slice(leading.length).match(/^(?:([A-Za-z][A-Za-z0-9_-]*)|"([A-Za-z][A-Za-z0-9_-]*)"|'([A-Za-z][A-Za-z0-9_-]*)')[ \t]*:/u);
+    if (key) keys.push(key[1] ?? key[2] ?? key[3]);
+  }
+  return keys;
+}
+
+function declaredConfigTypeNames(source) {
+  if (typeof source !== 'string' || source.length === 0) return [];
+  const match = /(?:^|\n)types:[ \t]*/u.exec(source);
+  if (!match) return [];
+  const typesIndex = match.index + match[0].indexOf('types:');
+  const rest = source.slice(typesIndex + 'types:'.length).replace(/^[ \t]+/u, '');
+  if (rest.startsWith('{')) return flowMappingKeys(rest);
+  return blockMappingKeys(source, typesIndex);
+}
+
+function addCandidate(map, type, applicability, condition = null) {
+  const current = map.get(type) ?? { type, applicability: [], condition: null };
+  if (!current.applicability.includes(applicability)) current.applicability.push(applicability);
+  if (condition && !current.condition) current.condition = condition;
+  map.set(type, current);
+}
+
+function candidatesFromProfiles(profiles, projectShape, adoptionStage) {
+  const map = new Map();
+  for (const type of profiles.common_minimum ?? []) {
+    addCandidate(map, type, APPLICABILITY.common_minimum);
+  }
+  const standard = profiles.project_standards?.[projectShape];
+  for (const type of standard?.additional_types ?? []) {
+    addCandidate(map, type, APPLICABILITY.project_standard);
+  }
+  for (const entry of profiles.lifecycle ?? []) {
+    if (entry.adoption_stages?.includes(adoptionStage)) {
+      addCandidate(map, entry.type, APPLICABILITY.lifecycle, entry.condition ?? null);
+    }
+  }
+  for (const entry of profiles.conditional ?? []) {
+    if (entry.project_shapes?.includes(projectShape)) {
+      addCandidate(map, entry.type, APPLICABILITY.conditional, entry.condition ?? null);
+    }
+  }
+  return map;
+}
+
+function isStandardApplicability(applicability) {
+  return applicability.includes(APPLICABILITY.common_minimum) || applicability.includes(APPLICABILITY.project_standard);
+}
+
 function contained(root, target) {
   const rel = relative(root, target);
   return rel === '' || (!rel.startsWith(`..${sep}`) && rel !== '..' && !isAbsolute(rel));
@@ -150,26 +298,39 @@ export async function checkAdoptionReadiness({
   const projectRoot = resolve(root);
   const pluginRoot = resolve(import.meta.dirname, '..', '..');
   const hasConfig = existsSync(join(projectRoot, 'artifact-graph.config.yaml'));
-  const [configResult, loadedProfile] = await Promise.all([
+  const [configResult, loadedProfile, profilesResult] = await Promise.all([
     loadArtifactGraphConfig({ projectRoot, env }),
     loadProfile({ root: projectRoot, profilePath }),
+    loadProjectArtifactProfiles({ projectRoot, env }),
   ]);
   const schema = configResult.ok && hasConfig ? configResult.schema : null;
-  const configuredTypes = schema ? Object.keys(schema.types ?? {}) : [];
+  const configRaw = hasConfig ? readFileSync(join(projectRoot, 'artifact-graph.config.yaml'), 'utf8') : '';
+  const declaredTypes = hasConfig ? declaredConfigTypeNames(configRaw) : [];
   const profiledTypes = loadedProfile.data ? profileTypes(loadedProfile.data) : [];
-  const candidates = unique([...STAGE_CANDIDATES[adoptionStage], ...SHAPE_CANDIDATES[projectShape]]);
-  const evidenceTypes = new Set([...configuredTypes, ...profiledTypes, ...selectedTypes]);
-  const enabledTypes = candidates.filter(type => evidenceTypes.has(type));
-  const candidateTypes = candidates.map(type => ({
-    type,
-    enabled: enabledTypes.includes(type),
+  const evidenceTypes = unique([...declaredTypes, ...profiledTypes, ...selectedTypes]);
+  const candidateMap = profilesResult.ok
+    ? candidatesFromProfiles(profilesResult.profiles, projectShape, adoptionStage)
+    : new Map();
+  for (const type of evidenceTypes) {
+    if (!candidateMap.has(type)) addCandidate(candidateMap, type, APPLICABILITY.project_extra);
+  }
+  const candidates = [...candidateMap.values()];
+  const enabledTypes = candidates.filter(item => evidenceTypes.includes(item.type)).map(item => item.type);
+  const candidateTypes = candidates.map(item => ({
+    type: item.type,
+    enabled: enabledTypes.includes(item.type),
+    applicability: item.applicability,
+    condition: item.condition,
     sources: [
-      ...(configuredTypes.includes(type) ? ['effective-config'] : []),
-      ...(profiledTypes.includes(type) ? ['workflow-profile'] : []),
-      ...(selectedTypes.includes(type) ? ['explicit-selection'] : []),
+      ...(declaredTypes.includes(item.type) ? ['effective-config'] : []),
+      ...(profiledTypes.includes(item.type) ? ['workflow-profile'] : []),
+      ...(selectedTypes.includes(item.type) ? ['explicit-selection'] : []),
     ],
-    template_available: Boolean(TEMPLATE_PATHS[type] && existsSync(join(pluginRoot, TEMPLATE_PATHS[type]))),
+    template_available: Boolean(TEMPLATE_PATHS[item.type] && existsSync(join(pluginRoot, TEMPLATE_PATHS[item.type]))),
   }));
+  const missingStandardTypes = candidateTypes
+    .filter(item => isStandardApplicability(item.applicability) && !item.enabled)
+    .map(item => item.type);
   const artifacts = [];
 
   for (const type of enabledTypes) {
@@ -212,17 +373,38 @@ export async function checkAdoptionReadiness({
 
   const ready = artifacts.length > 0 && artifacts.every(item => item.registration.ready && item.template.ready && item.methods.generate.status === 'OK' && item.methods.review.status === 'OK');
   const diagnostics = [];
+  const profileContract = profilesResult.ok
+    ? {
+        status: 'OK',
+        schema_version: profilesResult.profiles.schema_version,
+        source: 'artifact-graph/project-artifact-profiles',
+        reason: null,
+      }
+    : {
+        status: 'UNAVAILABLE',
+        schema_version: null,
+        source: 'artifact-graph/project-artifact-profiles',
+        reason: profilesResult.reason,
+      };
+  if (!profilesResult.ok) {
+    diagnostics.push(`Project artifact profiles unavailable: ${profilesResult.reason}. List-dependent recommendations are paused; copied STAGE/SHAPE tables are not used.`);
+  }
   if (!configResult.ok) diagnostics.push(`Effective artifact-graph config unavailable: ${configResult.reason}`);
   if (loadedProfile.error) diagnostics.push(loadedProfile.error);
+  if (missingStandardTypes.length > 0) {
+    diagnostics.push(`Common or skill-plugin standard types are visible and not adopted: ${missingStandardTypes.join(', ')}. Reading the list does not enable them.`);
+  }
   if (enabledTypes.length === 0) diagnostics.push('No candidate artifact type is enabled by effective config, workflow profile, or explicit selection.');
   if (!ready && enabledTypes.length > 0) diagnostics.push('One or more enabled artifact types are not fully ready; inspect each item.gaps.');
   return {
-    status: ready ? 'OK' : 'NEEDS_INPUT',
+    status: profilesResult.ok && ready ? 'OK' : 'NEEDS_INPUT',
     root: projectRoot,
     project_shape: projectShape,
     adoption_stage: adoptionStage,
+    profile_contract: profileContract,
     candidate_types: candidateTypes,
     enabled_types: enabledTypes,
+    missing_standard_types: missingStandardTypes,
     artifacts,
     diagnostics,
     next: ready

package/adapters/claude/scripts/lib/artifact-graph-runtime.mjs

@@ -119,6 +119,76 @@ export async function loadArtifactGraphConfig({ projectRoot, env } = {}) {
   }
 }
 
+const PROFILES_SUBPATH = './project-artifact-profiles';
+const PROFILES_SCHEMA_VERSION = '1.0';
+
+function profilesExportPath(packageJson) {
+  const exported = packageJson.exports?.[PROFILES_SUBPATH];
+  if (typeof exported === 'string' && exported.length > 0) return exported;
+  if (exported && typeof exported === 'object') {
+    if (typeof exported.default === 'string' && exported.default.length > 0) return exported.default;
+    if (typeof exported.import === 'string' && exported.import.length > 0) return exported.import;
+  }
+  return null;
+}
+
+function profilesContractValid(raw) {
+  return Boolean(
+    raw
+      && raw.schema_version === PROFILES_SCHEMA_VERSION
+      && Array.isArray(raw.common_minimum)
+      && raw.common_minimum.length > 0
+      && raw.project_standards
+      && typeof raw.project_standards === 'object'
+      && Array.isArray(raw.lifecycle)
+      && Array.isArray(raw.conditional),
+  );
+}
+
+/**
+ * Load the static project-artifact-profiles JSON from the resolved artifact-graph package.
+ * Missing export or incompatible schema_version fail closed; callers must not fall back to copied tables.
+ * The subpath is a candidate contract until a later provider publishes it; it is not a published 0.14.1 API.
+ */
+export async function loadProjectArtifactProfiles({ projectRoot, env } = {}) {
+  const runtime = await inspectArtifactGraphRuntime({ projectRoot: resolve(projectRoot), env });
+  if (!runtime.ok) {
+    return { ok: false, runtime, profiles: null, reason: runtime.reason };
+  }
+  try {
+    const packageRoot = dirname(runtime.packagePath);
+    const packageJson = JSON.parse(await readFile(runtime.packagePath, 'utf8'));
+    const exportPath = profilesExportPath(packageJson);
+    if (!exportPath) {
+      return {
+        ok: false,
+        runtime,
+        profiles: null,
+        reason: 'profiles_export_missing',
+        remediation: 'Resolved artifact-graph package does not export artifact-graph/project-artifact-profiles. Pause list-dependent recommendations; do not use a copied STAGE/SHAPE table. This subpath is a candidate contract, not a published 0.14.1 API.',
+      };
+    }
+    const raw = JSON.parse(await readFile(join(packageRoot, exportPath), 'utf8'));
+    if (!profilesContractValid(raw)) {
+      return {
+        ok: false,
+        runtime,
+        profiles: null,
+        reason: 'profiles_schema_incompatible',
+        remediation: `project-artifact-profiles schema_version is ${raw?.schema_version ?? 'missing'}, expected ${PROFILES_SCHEMA_VERSION}. Pause list-dependent recommendations; do not use a copied STAGE/SHAPE table.`,
+      };
+    }
+    return { ok: true, runtime, profiles: raw, reason: null };
+  } catch (error) {
+    return {
+      ok: false,
+      runtime,
+      profiles: null,
+      reason: `profiles_load_failed: ${error.message}`,
+    };
+  }
+}
+
 /**
  * Resolve a path to its realpath if it exists and is executable (X_OK).
  */

package/adapters/claude/skills/artifact-chain-bootstrap/SKILL.md

@@ -37,25 +37,31 @@ initialization, migration, or repair of project setup, not for routine feature w
 
 Use only artifact types that have stable local sources.
 
-The assistant may maintain a broad reusable catalog, but bootstrap must enable a small
+The published lists live in `artifact-graph/project-artifact-profiles` (`schema_version` `1.0`).
+Graph owns `common_minimum` and approved `project_standards`. This assistant reads that JSON
+through the resolved artifact-graph package, then checks registration, starter templates, and
+methods. If the subpath is missing or `schema_version` is not `1.0`, report the gap and pause
+only list-dependent recommendations; do not fall back to a copied STAGE/SHAPE table.
+
+The assistant may maintain a broad reusable catalog of templates, but bootstrap must enable a small
 project-specific profile. Treat extended artifact types as opt-in starter guidance, not
-global policy.
+global policy. Reading the published lists does not enable types.
 
 **Starter Templates**: The plugin provides starter templates for extended types in
 `templates/extended/`. These are onboarding guidance, not project authority. After bootstrap,
 projects should copy relevant templates to `artifacts/templates/` and customize them locally.
 
-| Project shape | Start with | Usually defer |
+| Project shape | Start from published lists | Usually defer |
 | --- | --- | --- |
-| Docs/planning repo | `feature`, `scenario`, `decision`, `design` | `test`, `e2e_test` until trace comments/tests exist |
-| TypeScript library or CLI | `feature`, `decision`, `design`, `test`; add `cli_contract` only when CLI/API docs exist | `scenario` if no scenario scripts exist |
-| API service | `feature`, `scenario`, `decision`, `design`, `test`; add `api_contract` and `data_contract` only when local contract files exist | `ui_contract`, `ipc_contract` |
-| Enterprise Java/Spring or JVM service | `feature`, `scenario`, `decision`, `design`, `test`; add `api_contract`, `data_contract`, `integration_contract`, `batch_job_contract`, `database_migration`, `security_review`, `performance_budget`, `deployment_manifest`, or `runbook` only from local evidence | `ui_contract`, `ipc_contract`, agent-specific artifacts |
-| Desktop or full-stack app | `feature`, `scenario`, `decision`, `design`, `test`, `e2e_test`; add `ui_contract`, `ipc_contract`, `api_contract`, or `data_contract` only from local evidence | custom entities until registry format is stable |
-| Agent or plugin toolkit | `feature`, `scenario`, `decision`, `design`, `test`; add `agent_skill`, `hook_policy`, or `prompt_packet` only when local skill/hook/prompt files exist | release governance types unless this project owns releases |
-| Parent or release governance repo | `feature`, `scenario`, `decision`, `design`, `e2e_test`; add `release_policy`, `publish_skill`, or `oss_compliance` only when local release files exist | product UI/API contracts |
+| Docs/planning repo | common minimum `feature`, `scenario`, `design`; add `decision` when a choice must be traced | `test`, `e2e_test` until trace comments/tests exist |
+| TypeScript library or CLI (`cli-library`) | common minimum; add `cli_contract` only when CLI/API docs exist | capability types without local evidence |
+| API service (`web`) | common minimum; add `api_contract` and `data_contract` only when local contract files exist | `ui_contract`, `ipc_contract` |
+| Enterprise Java/Spring or JVM service | common minimum; add `api_contract`, `data_contract`, `integration_contract`, `batch_job_contract`, `database_migration`, `security_review`, `performance_budget`, `deployment_manifest`, or `runbook` only from local evidence | `ui_contract`, `ipc_contract`, agent-specific artifacts |
+| Desktop or full-stack app (`desktop`) | common minimum; add `ui_contract`, `ipc_contract`, `api_contract`, or `data_contract` only from local evidence | custom entities until registry format is stable |
+| Agent or plugin toolkit (`skill-plugin`) | common minimum plus skill-plugin standard `agent_skill`, `e2e_test`; add `hook_policy` or `prompt_packet` only when local hook/prompt files exist | release governance types unless this project owns releases |
+| Parent or release governance repo | common minimum; add `release_policy`, `publish_skill`, or `oss_compliance` only when local release files exist | product UI/API contracts |
 | Existing mature artifact repo | types already present in `artifacts/**` | any type without templates or ID rules |
-| Small project trying artifact-chain for the first time | `feature`, `decision`, `test` | everything else until useful |
+| Small project trying artifact-chain for the first time | common minimum `feature`, `scenario`, `design` | everything else until useful |
 
 Prefer a small correct graph over a large noisy one. Add more types only after the project has
 templates, ID patterns, and review rules for them. See `../../EXTENDED-ARTIFACT-CATALOG.md` for
@@ -63,7 +69,7 @@ per-type recommended paths, ID patterns, lifecycle rules, and review checkpoints
 
 ### 形态与采用阶段的实际就绪度
 
-把项目实际证据归到一种形态：`cli-library`、`web`、`desktop` 或 `skill-plugin`；再选择当前阶段：`initial`（初建）、`legacy-backfill`（存量补档）或 `daily-iteration`（日常迭代）。运行同一个只读计算入口：
+把项目实际证据归到一种形态：`cli-library`、`web`、`desktop` 或 `skill-plugin`；再选当前阶段：`initial`（初建）、`legacy-backfill`（存量补档）或 `daily-iteration`（日常迭代）。候选来自 Graph 公开清单。共同最小三项 `feature`、`scenario`、`design` 始终可见，但可见不等于已启用。只有 `skill-plugin` 另有类别标准 `agent_skill` 与 `e2e_test`。阶段项按生命周期出现：`requirement` 在 `initial` 与 `daily-iteration`；`spec` 只在 `daily-iteration`；`decision` 在三个阶段都出现。接口、钩子、提示和发布类按能力出现。阶段项和能力项都只是候选，配置、profile 或用户明确选择之前不得启用。共同最小或技能族标准还没采用时，必须在结果里看得见。运行同一个只读计算入口：
 
 ```bash
 node <plugin-root>/scripts/check-workflow-profile.mjs \
@@ -74,15 +80,17 @@ node <plugin-root>/scripts/check-workflow-profile.mjs \
   --format json
 ```
 
-`--types` 只传已经由用户明确选择、但尚未写入配置或 profile 的类型；没有这种选择时省略。形态只产生候选，不证明项目拥有对应能力。库没有 CLI、静态 Web 没有 API、技能插件没有 hook 时，让相应契约留在 `candidate_types`，不要要求补齐。以脚本结果为准：
-
-- `candidate_types` 列出形态和阶段建议，并说明是否由有效配置、已有 profile 或明确选择启用；
-- `enabled_types` 只包含有上述依据的候选，候选本身不算缺口；
-- `registration.ready` 同时检查有效类型、ID 模式、路径声明和目录；
-- `template.ready` 检查插件 starter 是否真实存在；
-- `methods.generate` 与 `methods.review` 复用当前 workflow profile 解析结果；需求/SPEC 的直接制作入口标为 `bundled-skill`，没有审阅方法时如实报告缺口；
-- `project_specific_method_ready` 只在实际解析到 `project-worker` 时为 true；`bundled-skill`、`public-worker` 和 `project-worker` 分开报告；
-- `gaps` 给出当前组合缺少的类型、目录、模板或方法，不把缺口写成已启用能力。
+`--types` 只传用户已经明确选择、但还没写入配置或 profile 的类型；没有这种选择时省略。形态只产生候选，不证明项目已经有对应能力。库没有 CLI、静态 Web 没有 API、技能插件没有 hook 时，把相应契约留在 `candidate_types`，不要要求补齐。项目已有配置或方法绑定里的额外类型必须保留。公开清单读不到，或 `schema_version` 不是 `1.0` 时，只暂停依赖清单的推荐路径，不回退复制表；已有额外类型仍保留。以检查结果为准：
+
+- `profile_contract` 说明公开清单是否读到、`schema_version` 是否为 `1.0`；读不到或版本不兼容时只暂停清单推荐，不回退复制表。它不充当 `registration.ready` 的开关。
+- `candidate_types` 列出共同最小、类别标准、阶段项、能力项和项目追加，并用 `applicability` 区分来源；`enabled` 只在有效配置、已有 profile 或明确选择时为 true。
+- `missing_standard_types` 列出尚未采用的共同最小或技能族标准项。读清单成功不能当成已经采用。它和 `gaps` 分开看。
+- `enabled_types` 只包含有上述依据的候选，候选本身不算缺口。
+- `registration.ready` 同时检查有效类型、ID 模式、路径声明和目录。
+- `template.ready` 检查插件 starter 是否真实存在。
+- `methods.generate` 与 `methods.review` 复用当前 workflow profile 解析结果；需求/SPEC 的直接制作入口标为 `bundled-skill`，没有审阅方法时如实报告缺口。
+- `project_specific_method_ready` 只在实际解析到 `project-worker` 时为 true；`bundled-skill`、`public-worker` 和 `project-worker` 分开报告。
+- `gaps` 给出当前组合缺少的目录、模板或方法。清单可读不能掩盖模板或方法未就绪。
 
 无配置项目仍能用 `artifact-chain-requirements` 把想法保存到 `artifacts/requirements/`。不要为了收集需求先强迫用户完成 bootstrap；需要把需求纳入图、建立当前制品或运行专业方法时，再按这里的结果补最小配置。
 

package/adapters/claude/templates/core/e2e_test/starter.md

@@ -2,21 +2,23 @@
 id: {E2E_TEST_ID}
 title: {标题}
 status: draft
+test_batch: {TEST_BATCH}
 related_features: []
 related_scenarios: []
+scope: {FEATURE_ID}
+ac_coverage: {}
 ---
 
 # {E2E_TEST_ID}: {标题}
 
 <!-- 本模板是插件 starter 指导，项目本地模板可完全覆盖 -->
+<!-- 用例标题必须是 `## TC-nnn:` 或 `### TC-nnn:`，内核按该标题解析节点；`主场景` 标题不会生成 TC 节点。 -->
 
 ## 测试目标
 
 {描述这个端到端测试要验证的完整用户流程}
 
-## 测试场景
-
-### 主场景：{场景名称}
+## TC-001: {主场景名称}
 
 **前置条件**：
 - {条件 1}
@@ -31,40 +33,40 @@ related_scenarios: []
 - {结果 1}
 - {结果 2}
 
-### 备选场景：{场景名称}
+**后置清理**：
+- {清理 1}
 
-{同上结构}
+**覆盖场景**： {SCENARIO_ID}
+**覆盖功能**： {FEATURE_ID}(AC1)
+**优先级**： P0
 
-## 测试数据
+## TC-002: {备选场景名称}
 
-{描述测试所需的数据准备}
+**前置条件**：
+- {条件 1}
 
-## 环境要求
+**测试步骤**：
+1. {步骤 1}
 
-{列出测试环境的特殊要求}
+**预期结果**：
+- {结果 1}
 
-## 自动化脚本
+**后置清理**：
+- {清理 1}
 
-{如果适用，关联自动化测试脚本路径}
+**覆盖场景**： {SCENARIO_ID}
+**覆盖功能**： {FEATURE_ID}(AC1)
+**优先级**： P1
 
-```typescript
-// 示例：Playwright E2E 测试
-import { test, expect } from '@playwright/test';
+## 测试数据
 
-test('{测试名称}', async ({ page }) => {
-  await page.goto('{URL}');
-  await page.click('{选择器}');
-  await expect(page.locator('{选择器}')).toHaveText('{预期文本}');
-});
-```
+{描述测试所需的数据准备}
+
+## 环境要求
+
+{列出测试环境的特殊要求}
 
 ## 关联制品
 
 - 功能特性：{related_features}
 - 场景：{related_scenarios}
-
-## 变更日志
-
-| 日期 | 变更 | 作者 |
-|------|------|------|
-| {YYYY-MM-DD} | 初始草稿 | {作者} |

package/adapters/codex/.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "artifact-chain-assistant",
   "displayName": "Artifact Chain Assistant",
-  "version": "0.14.2",
+  "version": "0.15.0",
   "description": "Artifact-chain intake, review/repair/batch/audit workflows, diagnostics, and version-lock maintenance helpers.",
   "author": {
     "name": "广州市风荷科技有限公司"

package/adapters/codex/EXTENDED-ARTIFACT-CATALOG.md

@@ -14,8 +14,8 @@ plugin README and INSTALL.md. This document covers opt-in types beyond the core
 
 | Layer | Scope | Responsibility for Extended Types |
 | --- | --- | --- |
-| **artifact-graph** | Deterministic graph capabilities | Reads type definitions from config; indexes artifacts; provides context/packet/validate. Does **not** ship default paths or ID patterns for extended types. Types without configured paths are not indexed. |
-| **artifact-chain-assistant** | General assistant guidance | Provides starter templates, profile suggestions, and generic review checklists. **Templates are guidance, not authority.** Project-local templates and review skills override plugin suggestions. |
+| **artifact-graph** | Deterministic graph capabilities, plus the published common-minimum and project-type standard lists at `artifact-graph/project-artifact-profiles` | Reads type definitions from config; indexes artifacts; provides context/packet/validate. Ships recommendation lists only; it does **not** auto-enable types or ship default paths or ID patterns for extended types. Types without configured paths are not indexed. |
+| **artifact-chain-assistant** | General assistant guidance | Reads the Graph lists, then provides starter templates, adoption-readiness checks, and generic review checklists. **Templates are guidance, not authority.** The assistant does not keep a second list source of truth. Project-local templates and review skills override plugin suggestions. |
 | **Target project** | Final working method | Decides which extended types to enable; maintains config, local templates, review skills, and ID rules. **Project-local overrides plugin suggestions.** Enables new types progressively as maturity grows. |
 
 ## Extended Artifact Type Catalog
@@ -90,15 +90,19 @@ has corresponding files or processes.
 ## Bootstrap Trimming Strategy
 
 Bootstrap selects a **minimum viable profile** rather than enabling all known types.
+The published lists are `artifact-graph/project-artifact-profiles`. Reading them does not enable types.
 
 Rules:
 
-1. **Core set always enabled**: `feature`, `scenario`, `decision`, `design`, `test`, `e2e_test`.
-2. **Contracts by evidence**: Enable only when the project has corresponding interface files (e.g., OpenAPI spec, CLI entry, IPC channel definition).
-3. **Domain/data by project shape**: Enterprise Java/DDD projects may enable `domain_model`; projects with databases may enable `database_migration`.
-4. **Ops by operational process**: Enable only when the project has deployment configs, security review processes, or operational manuals.
-5. **Agent/hook by local files**: Enable only when the project has `skills/`, `policies/`, or hook config files.
-6. **Progressive expansion**: As project maturity grows, add new types in `artifact-graph.config.yaml`. Existing artifacts and traceability relationships are unaffected.
+1. **Common minimum is visible, not auto-enabled**: `feature`, `scenario`, `design`. Missing items stay visible until the project adopts them.
+2. **Only `skill-plugin` has an approved category standard**: it adds `agent_skill` and `e2e_test` on top of the common minimum. Other shapes use the common minimum plus matching stage and capability candidates.
+3. **Stage items stay candidates**: `requirement`, `spec`, and `decision` appear for matching adoption stages and are enabled only by config, profile, or explicit selection.
+4. **Contracts by evidence**: Enable `cli_contract`, `api_contract`, `ui_contract`, `ipc_contract`, or `data_contract` only when the project has corresponding interface files.
+5. **Domain/data by project shape**: Enterprise Java/DDD projects may enable `domain_model`; projects with databases may enable `database_migration`.
+6. **Ops by operational process**: Enable only when the project has deployment configs, security review processes, or operational manuals.
+7. **Agent/hook by local files**: `hook_policy` and `prompt_packet` remain capability candidates for `skill-plugin`; enable them only when the project has `skills/`, `policies/`, or hook config files.
+8. **Release by duty**: Enable `release_policy` and related types only when the project owns publish and distribution.
+9. **Progressive expansion**: As project maturity grows, add new types in `artifact-graph.config.yaml`. Existing extras and traceability relationships are kept.
 
 After bootstrap, the enabled types, paths, and ID patterns are recorded in
 `artifact-graph.config.yaml`. Deferred types and their evidence conditions are documented in the