gitifact 0.4.3 → 0.5.0

package/dist/main.js

@@ -1926,13 +1926,13 @@ Expecting one of '${allowedValues.join("', '")}'`);
    * @param {string} source - expected values are default/config/env/cli/implied
    * @return {Command} `this` command for chaining
    */
-  setOptionValueWithSource(key, value, source) {
+  setOptionValueWithSource(key, value, source2) {
     if (this._storeOptionsAsProperties) {
       this[key] = value;
     } else {
       this._optionValues[key] = value;
     }
-    this._optionValueSources[key] = source;
+    this._optionValueSources[key] = source2;
     return this;
   }
   /**
@@ -1953,13 +1953,13 @@ Expecting one of '${allowedValues.join("', '")}'`);
    * @return {string}
    */
   getOptionValueSourceWithGlobals(key) {
-    let source;
+    let source2;
     this._getCommandAndAncestors().forEach((cmd) => {
       if (cmd.getOptionValueSource(key) !== void 0) {
-        source = cmd.getOptionValueSource(key);
+        source2 = cmd.getOptionValueSource(key);
       }
     });
-    return source;
+    return source2;
   }
   /**
    * Get user arguments from implied or explicit arguments.
@@ -2839,8 +2839,8 @@ Expecting one of '${allowedValues.join("', '")}'`);
     const getErrorMessage = (option2) => {
       const bestOption = findBestOptionFromValue(option2);
       const optionKey = bestOption.attributeName();
-      const source = this.getOptionValueSource(optionKey);
-      if (source === "env") {
+      const source2 = this.getOptionValueSource(optionKey);
+      if (source2 === "env") {
         return `environment variable '${bestOption.envVar}'`;
       }
       return `option '${bestOption.flags}'`;
@@ -3405,9 +3405,9 @@ var messages_default = {
   "config.invalidFields": "\uD504\uB85C\uC81D\uD2B8 \uC124\uC815\uC758 \uD544\uB4DC\uB098 \uAC12\uC774 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.",
   "config.jsonUnreadableShort": "\uC124\uC815 JSON\uC744 \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.",
   "config.schemaFields": "schemaVersion\uACFC baseline \uC124\uC815 \uD544\uB4DC\uB97C \uD655\uC778\uD558\uC138\uC694.",
-  "document.pathTooLong": "\uBB38\uC11C \uACBD\uB85C \uAE4A\uC774 \uB610\uB294 \uAE38\uC774 \uD55C\uB3C4\uB97C \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4: {path}",
-  "document.fileName": "\uBB38\uC11C \uD30C\uC77C \uC774\uB984\uC740 \uC18C\uBB38\uC790\xB7\uC22B\uC790\xB7\uD558\uC774\uD508\uACFC .md\uC5EC\uC57C \uD569\uB2C8\uB2E4: {path}",
-  "document.folderName": "\uBB38\uC11C \uD3F4\uB354 \uC774\uB984\uC740 \uC18C\uBB38\uC790\xB7\uC22B\uC790\xB7\uD558\uC774\uD508\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4: {path}",
+  "document.pathTooLong": "\uC704\uD0A4 \uD398\uC774\uC9C0 \uACBD\uB85C \uAE4A\uC774 \uB610\uB294 \uAE38\uC774 \uD55C\uB3C4\uB97C \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4: {path}",
+  "document.fileName": "\uC704\uD0A4 \uD398\uC774\uC9C0 \uD30C\uC77C \uC774\uB984\uC740 \uC18C\uBB38\uC790\xB7\uC22B\uC790\xB7\uD558\uC774\uD508\uACFC .md\uC5EC\uC57C \uD569\uB2C8\uB2E4(\uB8E8\uD2B8\uC758 README.md\xB7ARCHITECTURE.md \uAC19\uC740 \uB300\uBB38\uC790 \uC774\uB984 \uC608\uC678): {path}",
+  "document.folderName": "\uC704\uD0A4 \uD3F4\uB354 \uC774\uB984\uC740 \uC18C\uBB38\uC790\xB7\uC22B\uC790\xB7\uD558\uC774\uD508\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4: {path}",
   "design.invalidCharacters": "\uC798\uBABB\uB41C \uC124\uACC4 \uBB38\uC790\uC785\uB2C8\uB2E4.",
   "design.idMismatch": "\uC124\uACC4\uC758 gitifact-design ID\uB294 \uAC19\uC740 \uAE30\uB2A5\uC758 S-ID\uC5EC\uC57C \uD569\uB2C8\uB2E4.",
   "design.titleRequired": "\uC124\uACC4 \uC81C\uBAA9\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.",
@@ -3415,24 +3415,19 @@ var messages_default = {
   "design.singleTopHeading": "\uC124\uACC4 \uCD5C\uC0C1\uC704 \uC81C\uBAA9\uC740 \uD558\uB098\uB9CC \uC501\uB2C8\uB2E4.",
   "design.referenceFormat": "\uC124\uACC4\uC758 \uCC38\uC870 \uC8FC\uC11D \uD615\uC2DD\uC744 \uD655\uC778\uD558\uC138\uC694.",
   "design.unclosedFence": "\uC124\uACC4 \uCF54\uB4DC \uBE14\uB85D\uC774 \uB2EB\uD788\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.",
-  "document.unsupportedPath": "\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uBB38\uC11C \uACBD\uB85C: {path}",
-  "document.productOnly": "\uC81C\uD488 \uD3F4\uB354\uC5D0\uB294 PRODUCT.md \uD558\uB098\uB9CC \uB461\uB2C8\uB2E4: {path}",
+  "document.unsupportedPath": "\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uC704\uD0A4 \uACBD\uB85C: {path}",
   "document.invalidCharacters": "\uC798\uBABB\uB41C \uBB38\uC11C \uBB38\uC790: {path}",
-  "document.idRequired": "\uCCAB \uC904\uC5D0 \uC720\uD6A8\uD55C gitifact-{kind} \uC8FC\uC11D\uC774 \uD544\uC694\uD569\uB2C8\uB2E4: {path}",
   "document.titleRequired": "\uBB38\uC11C \uC81C\uBAA9\uC774 \uD544\uC694\uD569\uB2C8\uB2E4: {path}",
   "document.bodyRequired": "\uBB38\uC11C \uBCF8\uBB38\uC774 \uD544\uC694\uD569\uB2C8\uB2E4: {path}",
   "document.singleTopHeading": "\uBB38\uC11C \uCD5C\uC0C1\uC704 \uC81C\uBAA9\uC740 \uD558\uB098\uB9CC \uC501\uB2C8\uB2E4: {path}",
   "document.noMarkerInBody": "\uBB38\uC11C \uBCF8\uBB38\uC5D0\uB294 gitifact \uC8FC\uC11D\uC744 \uC4F0\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4: {path}",
   "document.unclosedFence": "\uBB38\uC11C \uCF54\uB4DC \uBE14\uB85D\uC774 \uB2EB\uD788\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4: {path}",
-  "document.kindSet": "\uBB38\uC11C \uC885\uB958 \uC9D1\uD569\uC774 \uC798\uBABB\uB410\uC2B5\uB2C8\uB2E4.",
-  "document.kindMismatch": "\uBB38\uC11C \uC885\uB958\uAC00 \uD3F4\uB354\uC640 \uB2E4\uB985\uB2C8\uB2E4: {path}",
-  "document.duplicateId": "\uC800\uC7A5\uC18C \uB0B4 \uC911\uBCF5 \uBB38\uC11C ID: {id}",
+  "document.duplicateId": "\uC800\uC7A5\uC18C \uB0B4 \uC911\uBCF5 \uC704\uD0A4 \uD398\uC774\uC9C0 ID: {id}",
   "document.caseOnlyPath": "\uB300\uC18C\uBB38\uC790\uB9CC \uB2E4\uB978 \uBB38\uC11C \uACBD\uB85C: {path}",
   "history.duplicateId": "\uC800\uC7A5\uC18C \uB0B4 \uC911\uBCF5 \uBCF4\uC870 \uAE30\uB85D ID: {id}",
   "spec.orphanFile": "\uC694\uAD6C\uC0AC\uD56D \uBB38\uC11C \uC5C6\uB294 \uC124\uACC4 \uB610\uB294 \uC774\uC720 \uD30C\uC77C: {path}",
   "spec.unsupportedPath": "\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uBA85\uC138 \uACBD\uB85C: {path}",
   "spec.invalidCharacters": "\uC798\uBABB\uB41C \uBA85\uC138 \uBB38\uC790: {path}",
-  "spec.idRequired": "\uCCAB \uC904\uC5D0 \uC720\uD6A8\uD55C gitifact-spec \uC8FC\uC11D\uC774 \uD544\uC694\uD569\uB2C8\uB2E4: {path}",
   "spec.requirementIdRequired": "\uC694\uAD6C\uC0AC\uD56D \uC81C\uBAA9 \uBC14\uB85C \uC544\uB798\uC5D0 \uC720\uD6A8\uD55C ID\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4: {path}",
   "spec.invalidFence": "\uC798\uBABB\uB41C \uCF54\uB4DC \uBE14\uB85D\uC785\uB2C8\uB2E4.",
   "spec.titleOnce": "\uBB38\uC11C \uC81C\uBAA9\uC740 \uCC98\uC74C\uC5D0 \uD55C \uBC88\uB9CC \uC501\uB2C8\uB2E4: {path}",
@@ -3460,10 +3455,8 @@ var messages_default = {
   "edit.emptyField": "\uBE48 \uD3B8\uC9D1 \uD544\uB4DC: {field}",
   "edit.invalidCharacters": "\uC798\uBABB\uB41C \uD3B8\uC9D1 \uBB38\uC790: {field}",
   "edit.specNotFound": "\uB300\uC0C1 \uBA85\uC138\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4: {path}",
-  "edit.noProductToDelete": "\uC0AD\uC81C\uD560 \uC81C\uD488 \uBB38\uC11C\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "edit.samePath": "\uC774\uBBF8 \uAC19\uC740 \uACBD\uB85C\uC785\uB2C8\uB2E4.",
   "edit.documentPathExists": "\uC774\uBBF8 \uC874\uC7AC\uD558\uB294 \uBB38\uC11C \uACBD\uB85C\uC785\uB2C8\uB2E4: {path}",
-  "edit.guideIdNotFound": "\uC9C0\uCE68 \uBB38\uC11C ID\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4: {id}",
   "edit.featureExists": "\uC774\uBBF8 \uC874\uC7AC\uD558\uB294 \uAE30\uB2A5\uC785\uB2C8\uB2E4.",
   "edit.noDesignToDelete": "\uC0AD\uC81C\uD560 \uC124\uACC4\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "edit.specIdNotFound": "\uBA85\uC138 ID\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
@@ -3473,7 +3466,7 @@ var messages_default = {
   "edit.bodyChangesDocumentStructure": "\uBCF8\uBB38\uC774 \uBB38\uC11C \uAD6C\uC870\uB97C \uBCC0\uACBD\uD569\uB2C8\uB2E4: {path}",
   "reason.keepEmptySpec": "\uAE30\uC874 \uC774\uC720\uB97C \uBCF4\uC874\uD560 \uBE48 \uBA85\uC138\uB97C \uB0A8\uACA8\uC8FC\uC138\uC694: {id}",
   "reason.committedImmutable": "\uCEE4\uBC0B\uB41C \uC774\uC720\uC758 \uC218\uC815\xB7\uC0AD\uC81C\xB7\uC7AC\uBC30\uCE58\uB294 \uD5C8\uC6A9\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4: {id}",
-  "reason.committedDocumentImmutable": "\uCEE4\uBC0B\uB41C \uBB38\uC11C \uC774\uC720\uC758 \uC218\uC815\xB7\uC0AD\uC81C\xB7\uC7AC\uBC30\uCE58\uB294 \uD5C8\uC6A9\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4: {kind}",
+  "reason.committedDocumentImmutable": "\uCEE4\uBC0B\uB41C \uC704\uD0A4 \uC774\uC720\uC758 \uC218\uC815\xB7\uC0AD\uC81C\xB7\uC7AC\uBC30\uCE58\uB294 \uD5C8\uC6A9\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.",
   "reason.count": "reasons\uB294 \uCD5C\uB300 100\uAC1C\uC758 \uBC30\uC5F4\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4.",
   "reason.idGenerated": "\uC798\uBABB\uB41C \uC774\uC720 ID \uC0DD\uC131 \uACB0\uACFC\uC785\uB2C8\uB2E4.",
   "reason.idUnavailable": "\uACE0\uC720 \uC774\uC720 ID\uB97C \uBC1C\uAE09\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.",
@@ -3482,7 +3475,6 @@ var messages_default = {
   "reason.documentWithRequirements": "\uBB38\uC11C \uC774\uC720\uC5D0\uB294 \uC694\uAD6C\uC0AC\uD56D\uC744 \uD568\uAED8 \uC9C0\uC815\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.",
   "reason.documentTargetInvalid": "\uBB38\uC11C \uC774\uC720 \uB300\uC0C1\uC774 \uC798\uBABB\uB410\uAC70\uB098 \uC911\uBCF5\uB429\uB2C8\uB2E4.",
   "reason.documentUnchanged": "\uCD5C\uC885 \uBCC0\uACBD\uC774 \uC5C6\uB294 \uBB38\uC11C\uC5D0 \uC774\uC720\uB97C \uBD99\uC77C \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: {id}",
-  "reason.singleDocumentKind": "\uD55C \uC774\uC720\uB294 \uD55C \uC885\uB958\uC758 \uBB38\uC11C\uB9CC \uB300\uC0C1\uC73C\uB85C \uD569\uB2C8\uB2E4.",
   "reason.invalidTarget": "\uC798\uBABB\uB41C \uC774\uC720 \uB300\uC0C1\uC785\uB2C8\uB2E4.",
   "reason.targetKind": "\uC774\uC720 \uB300\uC0C1 \uC885\uB958\uB97C \uD655\uC778\uD558\uC138\uC694.",
   "reason.targetInvalid": "\uC774\uC720 \uB300\uC0C1\uC774 \uC798\uBABB\uB410\uAC70\uB098 \uC911\uBCF5\uB429\uB2C8\uB2E4.",
@@ -3506,7 +3498,19 @@ var messages_default = {
   "changelog.duplicateSection": "\uAC19\uC740 \uBC84\uC804\uC5D0 {section} \uC808\uC774 \uB450 \uBC88 \uC788\uC2B5\uB2C8\uB2E4.",
   "changelog.itemOutsideSection": "\uC808 \uC81C\uBAA9(### Added|Changed|Removed|Fixed) \uC544\uB798\uC5D0\uB9CC \uD56D\uBAA9\uC744 \uC4F8 \uC218 \uC788\uC2B5\uB2C8\uB2E4.",
   "changelog.unknownLine": '\uC778\uC2DD\uD560 \uC218 \uC5C6\uB294 \uC904\uC785\uB2C8\uB2E4. \uBC84\uC804\uC740 "## X.Y.Z - YYYY-MM-DD", \uC808\uC740 "### Added|Changed|Removed|Fixed", \uD56D\uBAA9\uC740 "- "\uB85C \uC501\uB2C8\uB2E4: {text}',
-  "changelog.noVersions": "\uBC84\uC804\uC774 \uD558\uB098\uB3C4 \uC5C6\uC2B5\uB2C8\uB2E4."
+  "changelog.noVersions": "\uBC84\uC804\uC774 \uD558\uB098\uB3C4 \uC5C6\uC2B5\uB2C8\uB2E4.",
+  "frontmatter.required": "\uCCAB \uC904\uC5D0 --- \uB85C \uC2DC\uC791\uD558\uB294 frontmatter\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.",
+  "frontmatter.unclosed": "frontmatter\uB97C \uB2EB\uB294 --- \uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
+  "frontmatter.line": "\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 frontmatter \uC904\uC785\uB2C8\uB2E4: {line}",
+  "frontmatter.scalar": "frontmatter \uAC12\uC740 \uB530\uC634\uD45C \uC5C6\uB294 \uB2E8\uC21C \uBB38\uC790\uC5F4\uC774\uAC70\uB098 \uD070\uB530\uC634\uD45C \uBB38\uC790\uC5F4\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4: {value}",
+  "frontmatter.id": "frontmatter\uC758 id\uAC00 \uC720\uD6A8\uD55C {kind} ID\uAC00 \uC544\uB2D9\uB2C8\uB2E4.",
+  "frontmatter.unknownKey": "\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 frontmatter \uD0A4\uC785\uB2C8\uB2E4: {key}",
+  "source.invalid": "\uCC38\uACE0 \uBB38\uC11C \uD56D\uBAA9\uC740 title\uACFC path \uB610\uB294 url \uC911 \uD558\uB098, \uC120\uD0DD\uC801 note\uB85C \uAD6C\uC131\uD569\uB2C8\uB2E4.",
+  "source.url": "\uCC38\uACE0 \uBB38\uC11C url\uC740 http(s)\uC5EC\uC57C \uD569\uB2C8\uB2E4: {url}",
+  "source.path": "\uCC38\uACE0 \uBB38\uC11C path\uB294 .md\uB85C \uB05D\uB098\uB294 \uC0C1\uB300 \uACBD\uB85C\uC5EC\uC57C \uD569\uB2C8\uB2E4: {path}",
+  "edit.documentIdNotFound": "\uC704\uD0A4 \uD398\uC774\uC9C0 ID\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4: {id}",
+  "edit.invalidSources": "sources\uB294 \uCD5C\uB300 50\uAC1C\uC758 \uBC30\uC5F4\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4.",
+  "config.unsupportedSchema": "\uC774 \uD504\uB85C\uC81D\uD2B8\uC758 \uC800\uC7A5 \uADDC\uC57D(schemaVersion {version})\uC740 \uC774 CLI\uAC00 \uC77D\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC815\uC2DD \uBC84\uC804 \uC804 \uADDC\uC57D\uC740 \uC804\uD658\uD558\uC9C0 \uC54A\uC73C\uBA70 \uC0C8\uB85C init \uD569\uB2C8\uB2E4."
 };
 
 // ../../packages/core/dist/shared/i18n/index.js
@@ -3578,6 +3582,7 @@ function parseProjectConfig(text2) {
 }
 
 // ../../packages/core/dist/formats/spec-project.js
+var SCHEMA_VERSION = 2;
 function parseManagedConfig(text2) {
   let value;
   try {
@@ -3588,41 +3593,50 @@ function parseManagedConfig(text2) {
   if (!value || typeof value !== "object" || Array.isArray(value) || !("schemaVersion" in value))
     return parseProjectConfig(text2);
   const config2 = value;
-  if (Object.keys(config2).sort().join(",") !== "baseline,schemaVersion" || config2.schemaVersion !== 1)
+  if (Object.keys(config2).sort().join(",") !== "baseline,schemaVersion")
     throw new InitError("INVALID_CONFIG", t("config.schemaFields"));
+  if (config2.schemaVersion !== SCHEMA_VERSION)
+    throw new InitError("UNSUPPORTED_SCHEMA", t("config.unsupportedSchema", { version: String(config2.schemaVersion) }));
   const checked = parseProjectConfig(JSON.stringify({ kind: "tryce-project", format: "workflow-1", mode: "auto", baseline: config2.baseline }));
-  return { schemaVersion: 1, baseline: checked.baseline };
+  return { schemaVersion: SCHEMA_VERSION, baseline: checked.baseline };
 }
 
 // ../../packages/core/dist/formats/spec-preview.js
 var SpecPreviewError = class extends Error {
   code = "INVALID_SPEC_PREVIEW";
 };
-var DOCUMENT_KINDS = ["product", "guide"];
-var DOCUMENT_DIRS = { product: ".gitifact/product", guide: ".gitifact/guides" };
-var documentHistoryPath = (kind) => DOCUMENT_DIRS[kind] + "/history.jsonl";
-var PRODUCT_PATH = ".gitifact/product/PRODUCT.md";
-var PRODUCT_ASSET_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]{0,120}\.(?:png|jpe?g|gif|svg|webp)$/i;
-function isProductAssetPath(path3) {
-  const match = /^\.gitifact\/product\/([^/]+)$/.exec(path3);
-  return !!match && PRODUCT_ASSET_NAME.test(match[1]);
-}
+var WIKI_DIR = ".gitifact/wiki";
+var WIKI_HISTORY_PATH = WIKI_DIR + "/history.jsonl";
+var WIKI_ENTRY = "README.md";
+var WIKI_ENTRY_PATH = WIKI_DIR + "/" + WIKI_ENTRY;
+var ASSETS_DIR = ".gitifact/assets";
+var RECOMMENDED_ASSET_EXTENSIONS = ["png", "jpg", "jpeg", "gif", "webp", "svg", "pdf"];
+var ASSET_SIZE_LIMIT = 1024 * 1024;
+var ASSETS_TOTAL_LIMIT = 50 * 1024 * 1024;
 var token = "[a-z2-7]{10}";
 var STORE_DIR = ".gitifact";
 var LEGACY_STORE_DIR = ".tryce";
 var STORE_DIRS = [STORE_DIR, LEGACY_STORE_DIR];
 var marker = "(?:gitifact|tryce)";
-var recordPathPattern = /^(?:\.(?:gitifact|tryce)\/spec\/[^/]+\/(?:requirements\.md|design\.md|history\.jsonl)|\.gitifact\/(?:product|guides)\/(?:(?:[^/]+\/)*[^/]+\.md|history\.jsonl))$/;
-var documentPathPattern = /^\.gitifact\/(product|guides)\/((?:[^/]+\/)*[^/]+\.md)$/;
-var documentHistoryPattern = /^\.gitifact\/(product|guides)\/history\.jsonl$/;
-var kindOfDir = (dir) => dir === "product" ? "product" : "guide";
+var recordPathPattern = /^(?:\.(?:gitifact|tryce)\/spec\/[^/]+\/(?:requirements\.md|design\.md|history\.jsonl)|\.gitifact\/wiki\/(?:(?:[^/]+\/)*[^/]+\.md|history\.jsonl))$/;
+var documentPathPattern = /^\.gitifact\/wiki\/((?:[^/]+\/)*[^/]+\.md)$/;
+var documentHistoryPattern = /^\.gitifact\/wiki\/history\.jsonl$/;
 var nameToken = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+var segmentOk = (part) => !!part && part !== "." && part !== ".." && !/[\\:\0]/.test(part);
+function isAssetPath(path3) {
+  if (!path3.startsWith(ASSETS_DIR + "/"))
+    return false;
+  const parts = path3.slice(ASSETS_DIR.length + 1).split("/");
+  return parts.every(segmentOk) && parts.length <= 8 && path3.length <= 300;
+}
+var assetExtension = (path3) => (/\.([A-Za-z0-9]+)$/.exec(path3)?.[1] ?? "").toLowerCase();
+var rootUpperName = /^[A-Z][A-Z0-9]*(?:-[A-Z0-9]+)*\.md$/;
 function validateDocumentRelativePath(relative) {
   const parts = relative.split("/");
   if (relative.length > 200 || parts.length > 8)
     fail(t("document.pathTooLong", { path: relative }));
   const file2 = parts.pop();
-  if (!file2.endsWith(".md") || !nameToken.test(file2.slice(0, -3)))
+  if (!(parts.length === 0 && rootUpperName.test(file2)) && (!file2.endsWith(".md") || !nameToken.test(file2.slice(0, -3))))
     fail(t("document.fileName", { path: relative }));
   for (const part of parts)
     if (!nameToken.test(part) || part.length > 80)
@@ -3634,19 +3648,115 @@ var fail = (message) => {
   throw new SpecPreviewError(message);
 };
 var normalized = (value) => value.replace(/\r\n/g, "\n").trim();
+var scalar = (value) => {
+  const quoted = /^"((?:[^"\\]|\\["\\])*)"$/.exec(value);
+  if (quoted)
+    return quoted[1].replace(/\\(["\\])/g, "$1");
+  if (!value || /^["'#&*!|>%@`[{-]/.test(value) || /:\s|\s#/.test(value) || value !== value.trim())
+    fail(t("frontmatter.scalar", { value }));
+  return value;
+};
+var quote = (value) => /^[A-Za-z0-9가-힣./_][^"#:\\]*$/.test(value) && value === value.trim() && !/\s#|:\s/.test(value) && !/^(true|false|null|yes|no|~)$/i.test(value) && !/^\d/.test(value) ? value : '"' + value.replace(/[\\"]/g, "\\$&") + '"';
+function parseFrontmatter(lines, kind, legacyIds) {
+  const legacy = new RegExp(`^<!-- ${marker}-(?:${kind === "wiki" ? "product|guide" : kind}): (${legacyIds}-${token}) -->$`).exec(lines[0] ?? "");
+  if (legacy) {
+    lines.shift();
+    return { id: legacy[1] };
+  }
+  if (lines[0] !== "---")
+    fail(t("frontmatter.required"));
+  lines.shift();
+  const end = lines.indexOf("---");
+  if (end === -1)
+    fail(t("frontmatter.unclosed"));
+  const block = lines.splice(0, end);
+  lines.shift();
+  const fields2 = /* @__PURE__ */ new Map();
+  for (let i = 0; i < block.length; i++) {
+    const line = block[i];
+    if (!line.trim())
+      continue;
+    const entry2 = /^([a-z]+):(?: (.*))?$/.exec(line);
+    if (!entry2 || fields2.has(entry2[1]))
+      fail(t("frontmatter.line", { line }));
+    const [, key, value] = entry2;
+    if (key !== "sources") {
+      if (value === void 0)
+        fail(t("frontmatter.line", { line }));
+      fields2.set(key, scalar(value));
+      continue;
+    }
+    if (value !== void 0)
+      fail(t("frontmatter.line", { line }));
+    const sources2 = [];
+    while (i + 1 < block.length && /^  /.test(block[i + 1])) {
+      const item = block[++i];
+      const head = /^  - ([a-z]+): (.*)$/.exec(item);
+      if (!head)
+        fail(t("frontmatter.line", { line: item }));
+      const map2 = { [head[1]]: scalar(head[2]) };
+      while (i + 1 < block.length && /^    [a-z]+: /.test(block[i + 1])) {
+        const more = /^    ([a-z]+): (.*)$/.exec(block[++i]);
+        if (more[1] in map2)
+          fail(t("frontmatter.line", { line: block[i] }));
+        map2[more[1]] = scalar(more[2]);
+      }
+      sources2.push(validateSource(map2));
+    }
+    fields2.set("sources", sources2);
+  }
+  const id = fields2.get("id");
+  if (typeof id !== "string" || !new RegExp(`^(?:${legacyIds})-${token}$`).test(id))
+    fail(t("frontmatter.id", { kind }));
+  for (const key of fields2.keys())
+    if (key !== "id" && !(key === "sources" && kind === "design"))
+      fail(t("frontmatter.unknownKey", { key }));
+  const sources = fields2.get("sources");
+  return { id, ...Array.isArray(sources) ? { sources } : {} };
+}
+function validateSource(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value))
+    fail(t("source.invalid"));
+  const map2 = value;
+  const keys2 = Object.keys(map2).sort();
+  if (keys2.some((k) => !["title", "path", "url", "note"].includes(k)) || typeof map2.title !== "string" || !map2.title.trim() || "path" in map2 === "url" in map2)
+    fail(t("source.invalid"));
+  for (const key of keys2) {
+    const v = map2[key];
+    if (typeof v !== "string" || !v.trim() || /[\r\n\0]/.test(v) || v.length > 500)
+      fail(t("source.invalid"));
+  }
+  if (typeof map2.url === "string" && !/^https?:\/\/\S+$/.test(map2.url))
+    fail(t("source.url", { url: map2.url }));
+  if (typeof map2.path === "string" && (/^[a-z]+:/i.test(map2.path) || map2.path.startsWith("/") || !map2.path.endsWith(".md")))
+    fail(t("source.path", { path: map2.path }));
+  return { title: map2.title.trim(), ...map2.path !== void 0 ? { path: map2.path.trim() } : {}, ...map2.url !== void 0 ? { url: map2.url.trim() } : {}, ...map2.note !== void 0 ? { note: map2.note.trim() } : {} };
+}
+function renderFrontmatter(front) {
+  const lines = ["---", "id: " + front.id];
+  if (front.sources?.length) {
+    lines.push("sources:");
+    for (const s of front.sources) {
+      const entries = ["title", "path", "url", "note"].filter((k) => s[k] !== void 0).map((k) => k + ": " + quote(s[k]));
+      lines.push("  - " + entries[0], ...entries.slice(1).map((e) => "    " + e));
+    }
+  }
+  lines.push("---");
+  return lines.join("\n") + "\n";
+}
 function renderDesignPreview(id, design) {
-  return `<!-- gitifact-design: ${id} -->
-
+  return renderFrontmatter({ id, ...design.sources?.length ? { sources: design.sources } : {} }) + `
 # ${design.title}
 
 ${design.body}
 `;
 }
-function parseDesignPreview(source, specId) {
-  if (source.includes("\0") || /\r(?!\n)/.test(source))
+function parseDesignPreview(source2, specId) {
+  if (source2.includes("\0") || /\r(?!\n)/.test(source2))
     fail(t("design.invalidCharacters"));
-  const lines = normalized(source).split("\n");
-  if (!new RegExp(`^<!-- ${marker}-design: ${specId} -->$`).test(lines.shift() ?? ""))
+  const lines = normalized(source2).split("\n");
+  const front = parseFrontmatter(lines, "design", "S");
+  if (front.id !== specId)
     fail(t("design.idMismatch"));
   while (lines[0] === "")
     lines.shift();
@@ -3684,32 +3794,24 @@ function parseDesignPreview(source, specId) {
   }).join("\n");
   if (fence)
     fail(t("design.unclosedFence"));
-  return { title, body, requirements: [...references] };
+  return { title, body, requirements: [...references], sources: front.sources ?? [] };
 }
 function renderDocument(doc) {
-  return `<!-- gitifact-${doc.kind}: ${doc.id} -->
-
+  return renderFrontmatter({ id: doc.id }) + `
 # ${doc.title}
 
 ${doc.body}
 `;
 }
-function parseDocument(path3, source) {
+function parseDocument(path3, source2) {
   const match = documentPathPattern.exec(path3);
   if (!match)
     fail(t("document.unsupportedPath", { path: path3 }));
-  const kind = kindOfDir(match[1]);
-  if (kind === "product") {
-    if (path3 !== PRODUCT_PATH)
-      fail(t("document.productOnly", { path: path3 }));
-  } else
-    validateDocumentRelativePath(match[2]);
-  if (source.includes("\0") || /\r(?!\n)/.test(source))
+  validateDocumentRelativePath(match[1]);
+  if (source2.includes("\0") || /\r(?!\n)/.test(source2))
     fail(t("document.invalidCharacters", { path: path3 }));
-  const lines = normalized(source).split("\n");
-  const id = new RegExp(`^<!-- gitifact-${kind}: ([PG]-${token}) -->$`).exec(lines.shift() ?? "")?.[1];
-  if (!id || id[0] !== (kind === "product" ? "P" : "G"))
-    return fail(t("document.idRequired", { kind, path: path3 }));
+  const lines = normalized(source2).split("\n");
+  const { id } = parseFrontmatter(lines, "wiki", "W");
   while (lines[0] === "")
     lines.shift();
   const heading = lines.shift();
@@ -3738,58 +3840,49 @@ function parseDocument(path3, source) {
   }
   if (fence)
     fail(t("document.unclosedFence", { path: path3 }));
-  return { id, kind, path: path3, title, body };
-}
-function parseDocumentFiles(files) {
-  const sets = DOCUMENT_KINDS.map((kind) => ({ kind, documents: [], history: parsePreviewHistory(files.get(documentHistoryPath(kind)) ?? "", "documents") }));
-  for (const [path3, source] of files) {
-    if (!documentPathPattern.test(path3))
-      continue;
-    const doc = parseDocument(path3, source);
-    sets.find((s) => s.kind === doc.kind).documents.push(doc);
-  }
-  for (const set2 of sets)
-    set2.documents.sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
-  validateDocumentSets(sets);
-  return sets;
-}
-function validateDocumentSets(sets) {
+  return { id, path: path3, title, body };
+}
+function parseWikiFiles(files) {
+  const wiki = { documents: [], history: parsePreviewHistory(files.get(WIKI_HISTORY_PATH) ?? "", "documents") };
+  for (const [path3, source2] of files)
+    if (documentPathPattern.test(path3))
+      wiki.documents.push(parseDocument(path3, source2));
+  wiki.documents.sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
+  validateWiki(wiki);
+  return wiki;
+}
+function validateWiki(wiki) {
   const ids = /* @__PURE__ */ new Set();
   const paths2 = /* @__PURE__ */ new Set();
   const historyIds = /* @__PURE__ */ new Set();
-  if (sets.map((s) => s.kind).sort().join(",") !== "guide,product")
-    fail(t("document.kindSet"));
-  for (const set2 of sets) {
-    for (const d of set2.documents) {
-      if (d.kind !== set2.kind)
-        fail(t("document.kindMismatch", { path: d.path }));
-      if (ids.has(d.id))
-        fail(t("document.duplicateId", { id: d.id }));
-      ids.add(d.id);
-      const lower = d.path.toLowerCase();
-      if (paths2.has(lower))
-        fail(t("document.caseOnlyPath", { path: d.path }));
-      paths2.add(lower);
-    }
-    for (const h of set2.history) {
-      if (historyIds.has(h.id))
-        fail(t("history.duplicateId", { id: h.id }));
-      historyIds.add(h.id);
-    }
+  for (const d of wiki.documents) {
+    if (ids.has(d.id))
+      fail(t("document.duplicateId", { id: d.id }));
+    ids.add(d.id);
+    const lower = d.path.toLowerCase();
+    if (paths2.has(lower))
+      fail(t("document.caseOnlyPath", { path: d.path }));
+    paths2.add(lower);
+  }
+  for (const h of wiki.history) {
+    if (historyIds.has(h.id))
+      fail(t("history.duplicateId", { id: h.id }));
+    historyIds.add(h.id);
   }
 }
-var emptyDocumentSets = () => DOCUMENT_KINDS.map((kind) => ({ kind, documents: [], history: [] }));
-var asBundle = (value) => Array.isArray(value) ? { specs: value, documents: emptyDocumentSets() } : value;
+var emptyWiki = () => ({ documents: [], history: [] });
+var emptyBundle = () => ({ specs: [], wiki: emptyWiki() });
+var asBundle = (value) => Array.isArray(value) ? { specs: value, wiki: emptyWiki() } : value;
 function parsePreviewBundle(files) {
-  const bundle = { specs: parsePreviewFiles(files), documents: parseDocumentFiles(files) };
+  const bundle = { specs: parsePreviewFiles(files), wiki: parseWikiFiles(files) };
   validateBundle(bundle);
   return bundle;
 }
 function validateBundle(bundle) {
   validatePreviewSnapshot(bundle.specs);
-  validateDocumentSets(bundle.documents);
+  validateWiki(bundle.wiki);
   const ids = /* @__PURE__ */ new Set();
-  for (const h of [...bundle.specs.flatMap((s) => s.history), ...bundle.documents.flatMap((d) => d.history)]) {
+  for (const h of [...bundle.specs.flatMap((s) => s.history), ...bundle.wiki.history]) {
     if (ids.has(h.id))
       fail(t("history.duplicateId", { id: h.id }));
     ids.add(h.id);
@@ -3799,28 +3892,92 @@ function designReferenceWarnings(specs) {
   const known = new Set(specs.flatMap((s) => s.requirements.map((r) => r.id)));
   return specs.flatMap((s) => (s.design?.requirements ?? []).filter((id) => !known.has(id)).map((id) => ({ specId: s.id, requirement: id, code: "MISSING_DESIGN_REFERENCE" })));
 }
+function resolveLink(from, link3) {
+  const bare = link3.replace(/[?#].*$/, "");
+  if (!bare || /^[a-z][a-z0-9+.-]*:/i.test(bare) || bare.startsWith("/") || bare.startsWith("//"))
+    return null;
+  const parts = from.split("/").slice(0, -1);
+  for (const part of decodeSafe(bare).split("/")) {
+    if (part === "" || part === ".")
+      continue;
+    if (part === "..") {
+      if (!parts.length)
+        return null;
+      parts.pop();
+      continue;
+    }
+    if (/[\\:\0]/.test(part))
+      return null;
+    parts.push(part);
+  }
+  return parts.join("/");
+}
+var decodeSafe = (value) => {
+  try {
+    return decodeURIComponent(value);
+  } catch {
+    return value;
+  }
+};
+function extractLinks(body) {
+  const links = [];
+  let fence;
+  for (const line of body.split("\n")) {
+    if (fence) {
+      if (new RegExp(`^ {0,3}${fence.char}{${fence.size},}\\s*$`).test(line))
+        fence = void 0;
+      continue;
+    }
+    const open6 = /^ {0,3}(`{3,}|~{3,})/.exec(line);
+    if (open6) {
+      fence = { char: open6[1][0], size: open6[1].length };
+      continue;
+    }
+    for (const m of line.replace(/`[^`]*`/g, "").matchAll(/!?\[[^\]]*\]\((?:<([^>]+)>|([^)\s]+))(?:\s+"[^"]*")?\)/g))
+      links.push(m[1] ?? m[2]);
+  }
+  return links;
+}
+function documentLinks(bundle) {
+  const out = [];
+  const collect = (from, links) => {
+    for (const link3 of links) {
+      const target = resolveLink(from, link3);
+      if (target !== null)
+        out.push({ from, link: link3, target });
+    }
+  };
+  for (const s of bundle.specs) {
+    collect(s.path, extractLinks(s.description + "\n" + s.requirements.map((r) => r.body).join("\n")));
+    if (s.design) {
+      const path3 = s.path.replace(/requirements\.md$/, "design.md");
+      collect(path3, [...extractLinks(s.design.body), ...s.design.sources.flatMap((x) => x.path ? [x.path] : [])]);
+    }
+  }
+  for (const d of bundle.wiki.documents)
+    collect(d.path, extractLinks(d.body));
+  return out;
+}
 function parsePreviewFiles(files) {
   const specs = [];
-  for (const [path3, source] of files) {
+  for (const [path3, source2] of files) {
     if (documentPathPattern.test(path3) || documentHistoryPattern.test(path3))
       continue;
     if (path3.endsWith("/requirements.md")) {
-      specs.push(parseSpecPreview(path3, source, files.get(path3.replace(/requirements\.md$/, "history.jsonl")) ?? "", files.get(path3.replace(/requirements\.md$/, "design.md"))));
+      specs.push(parseSpecPreview(path3, source2, files.get(path3.replace(/requirements\.md$/, "history.jsonl")) ?? "", files.get(path3.replace(/requirements\.md$/, "design.md"))));
     } else if (!files.has(path3.replace(/(?:history\.jsonl|design\.md)$/, "requirements.md")))
       fail(t("spec.orphanFile", { path: path3 }));
   }
   validatePreviewSnapshot(specs);
   return specs;
 }
-function parseSpecPreview(path3, source, history = "", designSource) {
+function parseSpecPreview(path3, source2, history = "", designSource) {
   if (!/^\.(?:gitifact|tryce)\/spec\/[^/]+\/requirements\.md$/.test(path3))
     fail(t("spec.unsupportedPath", { path: path3 }));
-  if (source.includes("\0") || source.includes("\r") && /\r(?!\n)/.test(source))
+  if (source2.includes("\0") || source2.includes("\r") && /\r(?!\n)/.test(source2))
     fail(t("spec.invalidCharacters", { path: path3 }));
-  const lines = normalized(source).split("\n");
-  const specMatch = new RegExp(`^<!-- ${marker}-spec: (S-${token}) -->$`).exec(lines[0] ?? "");
-  if (!specMatch)
-    fail(t("spec.idRequired", { path: path3 }));
+  const lines = normalized(source2).split("\n");
+  const specId = parseFrontmatter(lines, "spec", "S").id;
   let title = "";
   let description = "";
   let current;
@@ -3833,7 +3990,7 @@ function parseSpecPreview(path3, source, history = "", designSource) {
     else
       description += line + "\n";
   };
-  for (let i = 1; i < lines.length; i++) {
+  for (let i = 0; i < lines.length; i++) {
     const line = lines[i];
     if (waitingId) {
       const match = new RegExp(`^<!-- ${marker}-req: (R-${token}) -->$`).exec(line);
@@ -3890,13 +4047,13 @@ function parseSpecPreview(path3, source, history = "", designSource) {
       fail(t("spec.emptyOrDuplicateRequirement", { id: r.id }));
     ids.add(r.id);
   }
-  return { id: specMatch[1], path: path3, title, description: normalized(description), requirements, history: parsePreviewHistory(history), ...designSource === void 0 ? {} : { design: parseDesignPreview(designSource, specMatch[1]) } };
+  return { id: specId, path: path3, title, description: normalized(description), requirements, history: parsePreviewHistory(history), ...designSource === void 0 ? {} : { design: parseDesignPreview(designSource, specId) } };
 }
-function parsePreviewHistory(source, scope = "spec") {
+function parsePreviewHistory(source2, scope = "spec") {
   const records = [];
   const ids = /* @__PURE__ */ new Set();
   const shapes = scope === "spec" ? ["id,reason,requirements", "designs,id,reason,requirements"] : ["documents,id,reason,requirements"];
-  for (const line of source.replace(/\r\n/g, "\n").split("\n")) {
+  for (const line of source2.replace(/\r\n/g, "\n").split("\n")) {
     if (!line.trim())
       continue;
     let value;
@@ -3908,7 +4065,7 @@ function parsePreviewHistory(source, scope = "spec") {
     if (!value || typeof value !== "object" || Array.isArray(value))
       fail(t("history.invalidRecord"));
     const r = value;
-    if (!shapes.includes(Object.keys(r).sort().join(",")) || typeof r.id !== "string" || !new RegExp(`^H-${token}$`).test(r.id) || ids.has(r.id) || typeof r.reason !== "string" || !r.reason.trim() || !Array.isArray(r.requirements) || !r.requirements.length && !Array.isArray(r.designs) && !Array.isArray(r.documents) || r.documents !== void 0 && (r.requirements.length || !Array.isArray(r.documents) || !r.documents.length || r.documents.some((id) => typeof id !== "string" || !/^[PG]-[a-z2-7]{10}$/.test(id)) || new Set(r.documents).size !== r.documents.length) || r.designs !== void 0 && (!Array.isArray(r.designs) || !r.designs.length || r.designs.some((id) => typeof id !== "string" || !/^S-[a-z2-7]{10}$/.test(id)) || new Set(r.designs).size !== r.designs.length) || r.requirements.some((id) => typeof id !== "string" || !reqId.test(id)) || new Set(r.requirements).size !== r.requirements.length)
+    if (!shapes.includes(Object.keys(r).sort().join(",")) || typeof r.id !== "string" || !new RegExp(`^H-${token}$`).test(r.id) || ids.has(r.id) || typeof r.reason !== "string" || !r.reason.trim() || !Array.isArray(r.requirements) || !r.requirements.length && !Array.isArray(r.designs) && !Array.isArray(r.documents) || r.documents !== void 0 && (r.requirements.length || !Array.isArray(r.documents) || !r.documents.length || r.documents.some((id) => typeof id !== "string" || !/^W-[a-z2-7]{10}$/.test(id)) || new Set(r.documents).size !== r.documents.length) || r.designs !== void 0 && (!Array.isArray(r.designs) || !r.designs.length || r.designs.some((id) => typeof id !== "string" || !/^S-[a-z2-7]{10}$/.test(id)) || new Set(r.designs).size !== r.designs.length) || r.requirements.some((id) => typeof id !== "string" || !reqId.test(id)) || new Set(r.requirements).size !== r.requirements.length)
       fail(t("history.invalidFields"));
     ids.add(r.id);
     records.push({ id: r.id, requirements: r.requirements, ...r.designs === void 0 ? {} : { designs: r.designs }, ...r.documents === void 0 ? {} : { documents: r.documents }, reason: r.reason });
@@ -3935,6 +4092,7 @@ function validatePreviewSnapshot(specs) {
     }
   }
 }
+var sameEntry = (a, b) => a.title === b.title && a.body === b.body && JSON.stringify(a.sources ?? []) === JSON.stringify(b.sources ?? []);
 function compareSpecPreviews(before, after) {
   validatePreviewSnapshot(before);
   validatePreviewSnapshot(after);
@@ -3944,7 +4102,7 @@ function compareSpecPreviews(before, after) {
   for (const [specs, map2] of [[before, prev], [after, next]])
     for (const s of specs)
       if (s.design)
-        map2.set(s.id, { id: s.id, title: s.design.title, body: s.design.body, specId: s.id, path: s.path.replace(/requirements\.md$/, "design.md") });
+        map2.set(s.id, { id: s.id, title: s.design.title, body: s.design.body, specId: s.id, path: s.path.replace(/requirements\.md$/, "design.md"), sources: s.design.sources });
   const previousHistory = new Map(before.flatMap((s) => s.history.map((h) => [h.id, h])));
   const reasons = after.flatMap((s) => s.history).filter((h) => {
     const old = previousHistory.get(h.id);
@@ -3963,7 +4121,7 @@ function compareSpecPreviews(before, after) {
     else {
       if (from.specId !== to.specId || id.startsWith("S-") && storeRelative(from.path) !== storeRelative(to.path))
         types.push("moved");
-      if (from.title !== to.title || from.body !== to.body)
+      if (!sameEntry(from, to))
         types.push("modified");
     }
     return types.length ? [{ id, types, before: from, after: to, kind: id.startsWith("S-") ? "design" : "requirement", reasons: reasons.filter((h) => [...h.requirements, ...h.designs ?? []].includes(id)) }] : [];
@@ -3985,14 +4143,14 @@ function compareSpecPreviews(before, after) {
   });
   return { specChanges, changes };
 }
-function compareDocumentSets(before, after) {
-  validateDocumentSets(before);
-  validateDocumentSets(after);
-  const index = (sets) => new Map(sets.flatMap((s) => s.documents.map((d) => [d.id, { id: d.id, title: d.title, body: d.body, specId: d.kind, path: d.path }])));
+function compareWikis(before, after) {
+  validateWiki(before);
+  validateWiki(after);
+  const index = (wiki) => new Map(wiki.documents.map((d) => [d.id, { id: d.id, title: d.title, body: d.body, specId: "wiki", path: d.path }]));
   const prev = index(before);
   const next = index(after);
-  const previousHistory = new Map(before.flatMap((s) => s.history.map((h) => [h.id, h])));
-  const reasons = after.flatMap((s) => s.history).filter((h) => {
+  const previousHistory = new Map(before.history.map((h) => [h.id, h]));
+  const reasons = after.history.filter((h) => {
     const old = previousHistory.get(h.id);
     if (old && JSON.stringify(old) !== JSON.stringify(h))
       fail(t("history.changed", { id: h.id }));
@@ -4012,8 +4170,7 @@ function compareDocumentSets(before, after) {
       if (from.title !== to.title || from.body !== to.body)
         types.push("modified");
     }
-    const kind = (to ?? from).specId;
-    return types.length ? [{ id, types, before: from, after: to, kind, reasons: reasons.filter((h) => (h.documents ?? []).includes(id)) }] : [];
+    return types.length ? [{ id, types, before: from, after: to, kind: "wiki", reasons: reasons.filter((h) => (h.documents ?? []).includes(id)) }] : [];
   });
   const changed = new Set(changes.map((c) => c.id));
   for (const h of reasons)
@@ -4027,7 +4184,7 @@ function comparePreviewBundles(before, after) {
   validateBundle(a);
   validateBundle(b);
   const specs = compareSpecPreviews(a.specs, b.specs);
-  return { specChanges: specs.specChanges, changes: [...specs.changes, ...compareDocumentSets(a.documents, b.documents)] };
+  return { specChanges: specs.specChanges, changes: [...specs.changes, ...compareWikis(a.wiki, b.wiki)] };
 }
 
 // ../../packages/core/dist/formats/changelog.js
@@ -4106,8 +4263,7 @@ function previewPath(feature2) {
   return `.gitifact/spec/${feature2}/requirements.md`;
 }
 function renderSpecPreview(spec2) {
-  return `<!-- gitifact-spec: ${spec2.id} -->
-
+  return renderFrontmatter({ id: spec2.id }) + `
 # ${spec2.title}
 
 ` + (spec2.description ? spec2.description + "\n\n" : "") + spec2.requirements.map((r) => `## ${r.title}
@@ -4119,11 +4275,11 @@ ${r.body}
 function editSpecPreview(original, input2, generate) {
   if (!Array.isArray(input2) || !input2.length || input2.length > 100)
     fail2(t("edit.operationCount"));
-  const source = asBundle(original);
-  const specs = source.specs.map((s) => ({ ...s, requirements: s.requirements.map((r) => ({ ...r })), history: s.history.map((h) => ({ ...h, requirements: [...h.requirements] })) }));
-  const documents = source.documents.map((set2) => ({ ...set2, documents: set2.documents.map((d) => ({ ...d })), history: set2.history.map((h) => ({ ...h })) }));
-  validateBundle({ specs, documents });
-  const used = /* @__PURE__ */ new Set([...specs.flatMap((s) => [s.id, ...s.requirements.map((r) => r.id)]), ...documents.flatMap((d) => d.documents.map((x) => x.id))]);
+  const source2 = asBundle(original);
+  const specs = source2.specs.map((s) => ({ ...s, requirements: s.requirements.map((r) => ({ ...r })), history: s.history.map((h) => ({ ...h, requirements: [...h.requirements] })) }));
+  const wiki = { documents: source2.wiki.documents.map((d) => ({ ...d })), history: source2.wiki.history.map((h) => ({ ...h })) };
+  validateBundle({ specs, wiki });
+  const used = /* @__PURE__ */ new Set([...specs.flatMap((s) => [s.id, ...s.requirements.map((r) => r.id)]), ...wiki.documents.map((x) => x.id)]);
   const allocate = (prefix) => {
     for (let attempt = 0; attempt < 100; attempt++) {
       const id = generate(prefix);
@@ -4147,14 +4303,12 @@ function editSpecPreview(original, input2, generate) {
       update: ["type", "id", "title", "body"],
       move: ["type", "id", "feature"],
       "rename-spec": ["type", "id", "title"],
-      "set-design": ["type", "feature", "title", "body"],
+      "set-design": ["type", "feature", "title", "body", "sources"],
       "delete-design": ["type", "feature"],
       "create-doc": ["type", "path", "title", "body"],
       "update-doc": ["type", "id", "title", "body"],
       "move-doc": ["type", "id", "path"],
-      "delete-doc": ["type", "id"],
-      "set-product": ["type", "title", "body"],
-      "delete-product": ["type"]
+      "delete-doc": ["type", "id"]
     };
     const type = String(op.type);
     const fields2 = schemas[type];
@@ -4174,41 +4328,24 @@ function editSpecPreview(original, input2, generate) {
       const path3 = previewPath(str("feature"));
       return specs.find((s) => s.path === path3) ?? fail2(t("edit.specNotFound", { path: path3 }));
     };
-    if (type === "set-product" || type === "delete-product") {
-      const set2 = documents.find((s) => s.kind === "product");
-      const existing = set2.documents[0];
-      if (type === "delete-product") {
-        if (!existing)
-          fail2(t("edit.noProductToDelete"));
-        set2.documents = [];
-        results.push({ type, id: existing.id });
-      } else {
-        const doc = { id: existing?.id ?? allocate("P"), kind: "product", path: PRODUCT_PATH, title: str("title"), body: str("body") };
-        set2.documents = [doc];
-        results.push({ type, id: doc.id });
-      }
-      continue;
-    }
     if (type.endsWith("-doc")) {
-      const all = () => documents.filter((set2) => set2.kind === "guide").flatMap((set2) => set2.documents);
-      const documentPath = (kind, self) => {
+      const documentPath = (self) => {
         const relative = str("path");
         validateDocumentRelativePath(relative);
-        const path3 = `${DOCUMENT_DIRS[kind]}/${relative}`;
+        const path3 = `${WIKI_DIR}/${relative}`;
         if (self && self.path === path3)
           fail2(t("edit.samePath"));
-        if (all().some((d) => d !== self && d.path.toLowerCase() === path3.toLowerCase()))
+        if (wiki.documents.some((d) => d !== self && d.path.toLowerCase() === path3.toLowerCase()))
           fail2(t("edit.documentPathExists", { path: path3 }));
         return path3;
       };
       const find = () => {
         const id = str("id");
-        return all().find((d) => d.id === id) ?? fail2(t("edit.guideIdNotFound", { id }));
+        return wiki.documents.find((d) => d.id === id) ?? fail2(t("edit.documentIdNotFound", { id }));
       };
       if (type === "create-doc") {
-        const kind = "guide";
-        const doc = { id: allocate("G"), kind, path: documentPath(kind), title: str("title"), body: str("body") };
-        documents.find((s) => s.kind === kind).documents.push(doc);
+        const doc = { id: allocate("W"), path: documentPath(), title: str("title"), body: str("body") };
+        wiki.documents.push(doc);
         results.push({ type, id: doc.id });
       } else if (type === "update-doc") {
         const doc = find();
@@ -4217,12 +4354,11 @@ function editSpecPreview(original, input2, generate) {
         results.push({ type, id: doc.id });
       } else if (type === "move-doc") {
         const doc = find();
-        doc.path = documentPath(doc.kind, doc);
+        doc.path = documentPath(doc);
         results.push({ type, id: doc.id });
       } else {
         const doc = find();
-        const set2 = documents.find((s) => s.kind === doc.kind);
-        set2.documents = set2.documents.filter((d) => d.id !== doc.id);
+        wiki.documents = wiki.documents.filter((d) => d.id !== doc.id);
         results.push({ type, id: doc.id });
       }
       continue;
@@ -4245,8 +4381,16 @@ function editSpecPreview(original, input2, generate) {
         if (!spec2.design)
           fail2(t("edit.noDesignToDelete"));
         delete spec2.design;
-      } else
-        spec2.design = parseDesignPreview(renderDesignPreview(spec2.id, { title: str("title"), body: str("body") }), spec2.id);
+      } else {
+        let sources = [];
+        const list = op.sources;
+        if (list !== void 0) {
+          if (!Array.isArray(list) || list.length > 50)
+            return fail2(t("edit.invalidSources"));
+          sources = list.map(validateSource);
+        }
+        spec2.design = parseDesignPreview(renderDesignPreview(spec2.id, { title: str("title"), body: str("body"), sources }), spec2.id);
+      }
       results.push({ type, id: spec2.id });
     } else if (type === "rename-spec") {
       const spec2 = specs.find((s) => s.id === str("id")) ?? fail2(t("edit.specIdNotFound"));
@@ -4254,13 +4398,13 @@ function editSpecPreview(original, input2, generate) {
       results.push({ type, id: spec2.id });
     } else {
       const id = str("id");
-      const source2 = specs.find((s) => s.requirements.some((r) => r.id === id)) ?? fail2(t("edit.requirementIdNotFound"));
-      const req = source2.requirements.find((r) => r.id === id);
+      const source3 = specs.find((s) => s.requirements.some((r) => r.id === id)) ?? fail2(t("edit.requirementIdNotFound"));
+      const req = source3.requirements.find((r) => r.id === id);
       if (type === "move") {
         const destination = target();
-        if (source2 === destination)
+        if (source3 === destination)
           fail2(t("edit.sameSpec"));
-        source2.requirements = source2.requirements.filter((r) => r.id !== id);
+        source3.requirements = source3.requirements.filter((r) => r.id !== id);
         destination.requirements.push(req);
       } else {
         req.title = str("title");
@@ -4274,14 +4418,12 @@ function editSpecPreview(original, input2, generate) {
     if (JSON.stringify({ ...parsed, history: spec2.history }) !== JSON.stringify(spec2))
       fail2(t("edit.bodyChangesSpecStructure"));
   }
-  for (const set2 of documents) {
-    set2.documents.sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
-    for (const doc of set2.documents)
-      if (JSON.stringify(parseDocument(doc.path, renderDocument(doc))) !== JSON.stringify(doc))
-        fail2(t("edit.bodyChangesDocumentStructure", { path: doc.path }));
-  }
-  validateBundle({ specs, documents });
-  return { specs, documents, results };
+  wiki.documents.sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
+  for (const doc of wiki.documents)
+    if (JSON.stringify(parseDocument(doc.path, renderDocument(doc))) !== JSON.stringify(doc))
+      fail2(t("edit.bodyChangesDocumentStructure", { path: doc.path }));
+  validateBundle({ specs, wiki });
+  return { specs, wiki, results };
 }
 
 // ../../packages/core/dist/use-cases/prepare-spec-preview.js
@@ -4295,7 +4437,7 @@ function pendingPreviewReasons(before, current) {
   const b = asBundle(current);
   return [
     ...b.specs.flatMap((s) => s.history.slice(a.specs.find((p) => p.id === s.id)?.history.length ?? 0).map((h) => ({ specId: s.id, path: historyPath(s), ...h }))),
-    ...b.documents.flatMap((d) => d.history.slice(a.documents.find((p) => p.kind === d.kind)?.history.length ?? 0).map((h) => ({ kind: d.kind, path: documentHistoryPath(d.kind), ...h })))
+    ...b.wiki.history.slice(a.wiki.history.length).map((h) => ({ kind: "wiki", path: WIKI_HISTORY_PATH, ...h }))
   ];
 }
 function finalSpecPreviewChanges(beforeValue, currentValue) {
@@ -4310,14 +4452,11 @@ function finalSpecPreviewChanges(beforeValue, currentValue) {
     if (next && !equal(next.history.slice(0, previous.history.length), previous.history))
       fail3(t("reason.committedImmutable", { id: previous.id }));
   }
-  for (const previous of before.documents) {
-    const next = current.documents.find((s) => s.kind === previous.kind);
-    if (!equal(next.history.slice(0, previous.history.length), previous.history))
-      fail3(t("reason.committedDocumentImmutable", { kind: previous.kind }));
-  }
+  if (!equal(current.wiki.history.slice(0, before.wiki.history.length), before.wiki.history))
+    fail3(t("reason.committedDocumentImmutable"));
   const clean = {
     specs: current.specs.map((s) => ({ ...s, history: before.specs.find((p) => p.id === s.id)?.history ?? [] })),
-    documents: current.documents.map((d) => ({ ...d, history: before.documents.find((p) => p.kind === d.kind)?.history ?? [] }))
+    wiki: { documents: current.wiki.documents, history: before.wiki.history }
   };
   return comparePreviewBundles(before, clean);
 }
@@ -4332,8 +4471,8 @@ function prepareSpecPreview(beforeValue, currentValue, baseFiles, currentFiles,
   const writes = /* @__PURE__ */ new Map();
   const pending = /* @__PURE__ */ new Map();
   const covered = /* @__PURE__ */ new Set();
-  const used = new Set([...before.flatMap((s) => s.history), ...current.flatMap((s) => s.history), ...beforeBundle.documents.flatMap((d) => d.history), ...currentBundle.documents.flatMap((d) => d.history)].map((h) => h.id));
-  const documentPending = /* @__PURE__ */ new Map();
+  const used = new Set([...before.flatMap((s) => s.history), ...current.flatMap((s) => s.history), ...beforeBundle.wiki.history, ...currentBundle.wiki.history].map((h) => h.id));
+  const wikiPending = [];
   const allocate = () => {
     for (let attempt = 0; attempt < 100; attempt++) {
       const id = generate();
@@ -4359,21 +4498,16 @@ function prepareSpecPreview(beforeValue, currentValue, baseFiles, currentFiles,
       if (raw.requirements.length)
         fail3(t("reason.documentWithRequirements"));
       const ids = raw.documents;
-      let kind;
       for (const value2 of ids) {
-        if (typeof value2 !== "string" || !/^[PG]-[a-z2-7]{10}$/.test(value2) || covered.has(value2))
+        if (typeof value2 !== "string" || !/^W-[a-z2-7]{10}$/.test(value2) || covered.has(value2))
           return fail3(t("reason.documentTargetInvalid"));
-        const change2 = delta.changes.find((c) => c.id === value2) ?? fail3(t("reason.documentUnchanged", { id: value2 }));
-        if (kind && change2.kind !== kind)
-          fail3(t("reason.singleDocumentKind"));
-        kind = change2.kind;
+        if (!delta.changes.some((c) => c.id === value2))
+          fail3(t("reason.documentUnchanged", { id: value2 }));
         covered.add(value2);
       }
       const documents = [...ids].sort();
-      const set2 = currentBundle.documents.find((d) => d.kind === kind);
-      const oldCount = beforeBundle.documents.find((d) => d.kind === kind)?.history.length ?? 0;
-      const reusable = set2.history.slice(oldCount).find((h) => h.reason === reason && equal([...h.documents ?? []].sort(), documents));
-      documentPending.set(kind, [...documentPending.get(kind) ?? [], { id: reusable?.id ?? allocate(), requirements: [], documents, reason }]);
+      const reusable = currentBundle.wiki.history.slice(beforeBundle.wiki.history.length).find((h) => h.reason === reason && equal([...h.documents ?? []].sort(), documents));
+      wikiPending.push({ id: reusable?.id ?? allocate(), requirements: [], documents, reason });
       continue;
     }
     for (const value2 of [...raw.requirements, ...raw.designs ?? []]) {
@@ -4401,34 +4535,32 @@ function prepareSpecPreview(beforeValue, currentValue, baseFiles, currentFiles,
       pending.set(specId, [...pending.get(specId) ?? [], record3]);
     }
   }
+  const historyText = (base, records) => {
+    let text2 = base ?? "";
+    if (records.length)
+      text2 += (text2 && !text2.endsWith("\n") ? "\n" : "") + records.map((h) => JSON.stringify(h) + "\n").join("");
+    return base !== void 0 || records.length ? text2 : null;
+  };
   for (const spec2 of current) {
     const old = before.find((s) => s.id === spec2.id);
     const base = old ? baseFiles.get(historyPath(old)) : void 0;
     const records = (pending.get(spec2.id) ?? []).sort((a, b) => (a.requirements[0] ?? a.designs[0]) < (b.requirements[0] ?? b.designs[0]) ? -1 : 1);
-    let text2 = base ?? "";
-    if (records.length)
-      text2 += (text2 && !text2.endsWith("\n") ? "\n" : "") + records.map((h) => JSON.stringify(h) + "\n").join("");
     const path3 = historyPath(spec2);
-    const next = base !== void 0 || records.length ? text2 : null;
+    const next = historyText(base, records);
     if ((currentFiles.get(path3) ?? null) !== next)
       writes.set(path3, next);
   }
-  for (const set2 of currentBundle.documents) {
-    const path3 = documentHistoryPath(set2.kind);
-    const base = baseFiles.get(path3);
-    const records = (documentPending.get(set2.kind) ?? []).sort((a, b) => a.documents[0] < b.documents[0] ? -1 : 1);
-    let text2 = base ?? "";
-    if (records.length)
-      text2 += (text2 && !text2.endsWith("\n") ? "\n" : "") + records.map((h) => JSON.stringify(h) + "\n").join("");
-    const next = base !== void 0 || records.length ? text2 : null;
-    if ((currentFiles.get(path3) ?? null) !== next)
-      writes.set(path3, next);
+  {
+    const records = wikiPending.sort((a, b) => a.documents[0] < b.documents[0] ? -1 : 1);
+    const next = historyText(baseFiles.get(WIKI_HISTORY_PATH), records);
+    if ((currentFiles.get(WIKI_HISTORY_PATH) ?? null) !== next)
+      writes.set(WIKI_HISTORY_PATH, next);
   }
   return {
     writes,
     changes: delta.changes,
     specChanges: delta.specChanges,
-    reasons: [...[...pending].flatMap(([specId, records]) => records.map((record3) => ({ specId, ...record3 }))), ...[...documentPending].flatMap(([kind, records]) => records.map((record3) => ({ kind, ...record3 })))],
+    reasons: [...[...pending].flatMap(([specId, records]) => records.map((record3) => ({ specId, ...record3 }))), ...wikiPending.map((record3) => ({ kind: "wiki", ...record3 }))],
     withoutReason: delta.changes.filter((c) => !covered.has(c.id)).map((c) => c.id)
   };
 }
@@ -4629,7 +4761,7 @@ function createRepositoryReader(cwd, options = {}) {
           return output2;
         };
         const discover = async () => {
-          const scalar = async (flag) => decodeGitLine(await invoke(["rev-parse", "--path-format=absolute", flag]));
+          const scalar2 = async (flag) => decodeGitLine(await invoke(["rev-parse", "--path-format=absolute", flag]));
           const flags = ["--is-bare-repository", "--is-inside-git-dir", "--is-inside-work-tree"];
           const paths2 = ["--show-toplevel", "--absolute-git-dir", "--git-common-dir", "--show-object-format"];
           let combined;
@@ -4646,7 +4778,7 @@ function createRepositoryReader(cwd, options = {}) {
           }
           if (bare === "true" || internal === "true" || inside !== "true") throw new RepositoryReadError("UNSUPPORTED_REPOSITORY");
           let values = combined.slice(3);
-          if (values.length !== paths2.length) values = await Promise.all(paths2.map(scalar));
+          if (values.length !== paths2.length) values = await Promise.all(paths2.map(scalar2));
           const [rootPath, gitDir, commonDir, objectFormat] = values;
           if (objectFormat !== "sha1" && objectFormat !== "sha256") throw new RepositoryReadError("GIT_UNSUPPORTED");
           return { rootPath, gitDir, commonDir, objectFormat };
@@ -5381,10 +5513,10 @@ function cached(getter) {
 function nullish(input2) {
   return input2 === null || input2 === void 0;
 }
-function cleanRegex(source) {
-  const start = source.startsWith("^") ? 1 : 0;
-  const end = source.endsWith("$") ? source.length - 1 : source.length;
-  return source.slice(start, end);
+function cleanRegex(source2) {
+  const start = source2.startsWith("^") ? 1 : 0;
+  const end = source2.endsWith("$") ? source2.length - 1 : source2.length;
+  return source2.slice(start, end);
 }
 function floatSafeRemainder(val, step) {
   const ratio = val / step;
@@ -5452,28 +5584,28 @@ function putProp(target, key, value) {
   else
     target[key] = value;
 }
-function mirrorShape(target, source, keys2, wrap) {
-  const raw = sourceShape(source);
+function mirrorShape(target, source2, keys2, wrap) {
+  const raw = sourceShape(source2);
   for (const key of keys2) {
     const desc = Object.getOwnPropertyDescriptor(raw, key);
     if (!desc.enumerable)
       continue;
     if (desc.get) {
       deferProp(target, key, () => {
-        const value = source._zod.def.shape[key];
+        const value = source2._zod.def.shape[key];
         return wrap ? wrap(value, key) : value;
       });
     } else
       putProp(target, key, wrap ? wrap(desc.value, key) : desc.value);
   }
 }
-function mirrorProps(target, source) {
-  for (const key of Reflect.ownKeys(source)) {
-    const desc = Object.getOwnPropertyDescriptor(source, key);
+function mirrorProps(target, source2) {
+  for (const key of Reflect.ownKeys(source2)) {
+    const desc = Object.getOwnPropertyDescriptor(source2, key);
     if (!desc.enumerable)
       continue;
     if (desc.get)
-      deferProp(target, key, () => source[key]);
+      deferProp(target, key, () => source2[key]);
     else
       putProp(target, key, desc.value);
   }
@@ -6686,8 +6818,8 @@ var creditCard = /^\d(?:[ -]?\d){11,18}$/;
 var currencyCode = /^(?:AED|AFN|ALL|AMD|AOA|ARS|AUD|AWG|AZN|BAM|BBD|BDT|BHD|BIF|BMD|BND|BOB|BOV|BRL|BSD|BTN|BWP|BYN|BZD|CAD|CDF|CHE|CHF|CHW|CLF|CLP|CNY|COP|COU|CRC|CUP|CVE|CZK|DJF|DKK|DOP|DZD|EGP|ERN|ETB|EUR|FJD|FKP|GBP|GEL|GHS|GIP|GMD|GNF|GTQ|GYD|HKD|HNL|HTG|HUF|IDR|ILS|INR|IQD|IRR|ISK|JMD|JOD|JPY|KES|KGS|KHR|KMF|KPW|KRW|KWD|KYD|KZT|LAK|LBP|LKR|LRD|LSL|LYD|MAD|MDL|MGA|MKD|MMK|MNT|MOP|MRU|MUR|MVR|MWK|MXN|MXV|MYR|MZN|NAD|NGN|NIO|NOK|NPR|NZD|OMR|PAB|PEN|PGK|PHP|PKR|PLN|PYG|QAR|RON|RSD|RUB|RWF|SAR|SBD|SCR|SDG|SEK|SGD|SHP|SLE|SOS|SRD|SSP|STN|SVC|SYP|SZL|THB|TJS|TMT|TND|TOP|TRY|TTD|TWD|TZS|UAH|UGX|USD|USN|UYI|UYU|UYW|UZS|VED|VES|VND|VUV|WST|XAD|XAF|XAG|XAU|XBA|XBB|XBC|XBD|XCD|XCG|XDR|XOF|XPD|XPF|XPT|XSU|XTS|XUA|XXX|YER|ZAR|ZMW|ZWG)$/;
 var iban = /^[A-Z]{2}(?!00|01|99)\d{2}[A-Z0-9]{11,30}$/;
 var dateSource = `(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))`;
-function anchor(source) {
-  return new RegExp(`^${source}$`);
+function anchor(source2) {
+  return new RegExp(`^${source2}$`);
 }
 var date = /* @__PURE__ */ anchor(dateSource);
 function timeSource(args) {
@@ -9510,11 +9642,11 @@ var $ZodTemplateLiteral = /* @__PURE__ */ $constructor("$ZodTemplateLiteral", (i
   const regexParts = [];
   for (const part of def.parts) {
     if (typeof part === "object" && part !== null) {
-      const source = partPattern(part);
-      if (!source) {
+      const source2 = partPattern(part);
+      if (!source2) {
         throw new Error(`Invalid template literal part, no pattern found: ${[...part._zod.traits].shift()}`);
       }
-      regexParts.push(cleanRegex(source));
+      regexParts.push(cleanRegex(source2));
     } else if (part === null || primitiveTypes.has(typeof part)) {
       regexParts.push(escapeRegex(`${part}`));
     } else {
@@ -17640,9 +17772,9 @@ function withParser(schema, parser) {
     installCompiledUserMethods(clone2, schema, parser);
   return clone2;
 }
-function installCompiledUserMethods(target, source, parser) {
+function installCompiledUserMethods(target, source2, parser) {
   const targetAny = target;
-  const sourceAny = source;
+  const sourceAny = source2;
   if (typeof sourceAny.safeParse === "function") {
     const originalSafeParse = sourceAny.safeParse;
     targetAny.safeParse = (data, params) => {
@@ -20237,10 +20369,10 @@ function _stringFormat(Class2, format, fnOrRegex, _params = {}) {
 
 // ../../node_modules/.pnpm/zod@4.6.4/node_modules/zod/v4/core/to-json-schema.js
 function assignProps(target, ...sources) {
-  for (const source of sources) {
-    for (const key of Reflect.ownKeys(source)) {
-      if (Object.prototype.propertyIsEnumerable.call(source, key)) {
-        assignProp(target, key, source[key]);
+  for (const source2 of sources) {
+    for (const key of Reflect.ownKeys(source2)) {
+      if (Object.prototype.propertyIsEnumerable.call(source2, key)) {
+        assignProp(target, key, source2[key]);
       }
     }
   }
@@ -24463,7 +24595,7 @@ var projectInitV4 = external_exports.discriminatedUnion("ok", [
     outcome: external_exports.enum(["planned", "created", "already-initialized"]),
     rootPath: external_exports.string(),
     configPath: external_exports.literal(".gitifact/config.json"),
-    schemaVersion: external_exports.literal(1),
+    schemaVersion: external_exports.literal(2),
     baseline: external_exports.discriminatedUnion("kind", [
       external_exports.strictObject({ kind: external_exports.literal("empty") }),
       external_exports.strictObject({ kind: external_exports.literal("commit"), objectFormat: external_exports.enum(["sha1", "sha256"]), commit: external_exports.string() })
@@ -24473,25 +24605,26 @@ var projectInitV4 = external_exports.discriminatedUnion("ok", [
   external_exports.strictObject({ contract: external_exports.literal("project-init"), version: external_exports.literal(4), ok: external_exports.literal(false), error: external_exports.strictObject({ code: external_exports.string(), message: external_exports.string() }) })
 ]);
 
-// ../../packages/contracts/dist/versions/browser-specs-v1.js
+// ../../packages/contracts/dist/versions/browser-specs-v2.js
 var requirement = external_exports.strictObject({ id: external_exports.string(), title: external_exports.string(), body: external_exports.string() });
 var contributor = external_exports.strictObject({ email: external_exports.string(), name: external_exports.string(), commits: external_exports.number().int().nonnegative(), latest: external_exports.string() });
+var source = external_exports.strictObject({ title: external_exports.string(), path: external_exports.string().optional(), url: external_exports.string().optional(), note: external_exports.string().optional() });
 var feature = external_exports.strictObject({
   id: external_exports.string(),
   path: external_exports.string(),
   title: external_exports.string(),
   description: external_exports.string(),
   requirements: external_exports.array(requirement),
-  design: external_exports.strictObject({ title: external_exports.string(), body: external_exports.string(), requirements: external_exports.array(external_exports.string()) }).optional(),
+  design: external_exports.strictObject({ title: external_exports.string(), body: external_exports.string(), requirements: external_exports.array(external_exports.string()), sources: external_exports.array(source) }).optional(),
   // Authors of commits touching the feature folder (current or legacy store) and the latest such commit; empty until first committed.
   contributors: external_exports.array(contributor),
   updatedAt: external_exports.string().nullable()
 });
-var snapshot = requirement.extend({ specId: external_exports.string(), path: external_exports.string() }).nullable();
-var document = external_exports.strictObject({ id: external_exports.string(), kind: external_exports.enum(["product", "guide"]), path: external_exports.string(), title: external_exports.string(), body: external_exports.string(), updatedAt: external_exports.string().nullable() });
-var browserSpecsV1 = external_exports.strictObject({
+var snapshot = requirement.extend({ specId: external_exports.string(), path: external_exports.string(), sources: external_exports.array(source).optional() }).nullable();
+var document = external_exports.strictObject({ id: external_exports.string(), path: external_exports.string(), title: external_exports.string(), body: external_exports.string(), updatedAt: external_exports.string().nullable() });
+var browserSpecsV2 = external_exports.strictObject({
   contract: external_exports.literal("browser-specs"),
-  version: external_exports.literal(1),
+  version: external_exports.literal(2),
   sessionId: external_exports.string(),
   head: external_exports.string().nullable(),
   observedAt: external_exports.string(),
@@ -24507,7 +24640,7 @@ var browserSpecsV1 = external_exports.strictObject({
     committer: external_exports.string(),
     message: external_exports.string(),
     id: external_exports.string(),
-    kind: external_exports.enum(["requirement", "design", "product", "guide"]).optional(),
+    kind: external_exports.enum(["requirement", "design", "wiki"]).optional(),
     types: external_exports.array(external_exports.enum(["created", "modified", "moved", "deleted"])),
     before: snapshot,
     after: snapshot,
@@ -24563,11 +24696,20 @@ var browserSessionV2 = external_exports.strictObject({
   update: updateStateV1
 });
 
-// ../../packages/contracts/dist/versions/update-v1.js
-var updateV1 = external_exports.discriminatedUnion("ok", [
+// ../../packages/contracts/dist/versions/update-v3.js
+var commitReason = external_exports.enum(["untracked", "other-changes", "commit-failed"]);
+var agentDocsCommit = external_exports.strictObject({
+  state: external_exports.enum(["not-requested", "nothing", "committed", "skipped"]),
+  commit: external_exports.string().nullable(),
+  paths: external_exports.array(external_exports.string()),
+  message: external_exports.string().nullable(),
+  reason: commitReason.nullable(),
+  detail: external_exports.string().nullable()
+}).refine((value) => value.state === "committed" === (value.commit !== null) && value.state === "skipped" === (value.reason !== null), "commit is set exactly when committed, reason exactly when skipped.");
+var updateV3 = external_exports.discriminatedUnion("ok", [
   external_exports.strictObject({
     contract: external_exports.literal("update"),
-    version: external_exports.literal(1),
+    version: external_exports.literal(3),
     ok: external_exports.literal(true),
     cliVersion: external_exports.string().min(1),
     update: updateStateV1,
@@ -24575,9 +24717,11 @@ var updateV1 = external_exports.discriminatedUnion("ok", [
     install: external_exports.strictObject({ npmGlobal: external_exports.string().min(1) }).nullable(),
     // refreshed: blocks whose version line differed were rewritten. current: every block already matched.
     // not-initialized: no .gitifact config here, so only the version check ran. no-block: no file carries a block.
-    agentDocs: external_exports.strictObject({ state: external_exports.enum(["refreshed", "current", "not-initialized", "no-block"]), paths: external_exports.array(external_exports.string()) })
+    // missing: files `gitifact init` would add and update does not create, e.g. CLAUDE.md when only AGENTS.md has the block.
+    agentDocs: external_exports.strictObject({ state: external_exports.enum(["refreshed", "current", "not-initialized", "no-block"]), paths: external_exports.array(external_exports.string()), missing: external_exports.array(external_exports.string()) }),
+    commit: agentDocsCommit
   }),
-  external_exports.strictObject({ contract: external_exports.literal("update"), version: external_exports.literal(1), ok: external_exports.literal(false), error: external_exports.strictObject({ code: external_exports.string(), message: external_exports.string() }) })
+  external_exports.strictObject({ contract: external_exports.literal("update"), version: external_exports.literal(3), ok: external_exports.literal(false), error: external_exports.strictObject({ code: external_exports.string(), message: external_exports.string() }) })
 ]);
 
 // src/shared/i18n/ko/messages.json
@@ -24595,7 +24739,7 @@ var messages_default2 = {
   "help.initRemoveAgents": "GITIFACT \uBE14\uB85D\uC744 \uC81C\uAC70",
   "help.initSkipAgents": "\uC9C0\uCE68 \uD30C\uC77C\uC744 \uAC74\uB4DC\uB9AC\uC9C0 \uC54A\uC74C",
   "help.docs": "\uC5D0\uC774\uC804\uD2B8\uC6A9 \uC791\uC5C5 \uC9C0\uCE68 \uCD9C\uB825 (\uC8FC\uC81C \uC5C6\uC774 \uC2E4\uD589\uD558\uBA74 \uBAA9\uB85D)",
-  "help.docsTopic": "workflow, spec, design, product, commit \uC911 \uD558\uB098",
+  "help.docsTopic": "workflow, spec, design, wiki, commit \uC911 \uD558\uB098",
   "help.migrate": ".tryce \uC800\uC7A5\uC18C\uB97C .gitifact\uB85C \uC804\uD658 (\uACBD\uB85C\uC640 \uB9C8\uCEE4\uB9CC \uBC14\uAFB8\uACE0 ID\xB7\uC774\uC720\xB7\uC774\uB825\uC740 \uBCF4\uC874)",
   "help.migrateDryRun": "\uD30C\uC77C\uC744 \uBC14\uAFB8\uC9C0 \uC54A\uACE0 \uC804\uD658 \uACC4\uD68D \uD655\uC778",
   "help.spec": "Markdown \uBA85\uC138 \uC791\uC131\xB7\uC870\uD68C\xB7Git \uAE30\uB85D",
@@ -24612,11 +24756,11 @@ var messages_default2 = {
   "help.specDiffFrom": "\uC774\uC804 \uCEE4\uBC0B",
   "help.specDiffTo": "\uC774\uD6C4 \uCEE4\uBC0B",
   "help.specChanges": "HEAD \uB300\uBE44 \uCD5C\uC885 \uBA85\uC138 \uCC28\uC774\uC640 \uBBF8\uCEE4\uBC0B \uC774\uC720 \uC870\uD68C",
-  "help.specWorking": "\uD604\uC7AC \uBA85\uC138\xB7\uC81C\uD488\xB7\uC9C0\uCE68 \uC804\uCCB4\uC640 stamp, \uC785\uB825 \uD30C\uC77C \uACBD\uB85C \uC870\uD68C",
+  "help.specWorking": "\uD604\uC7AC \uBA85\uC138\xB7\uC704\uD0A4 \uC804\uCCB4\uC640 stamp, \uC785\uB825 \uD30C\uC77C \uACBD\uB85C \uC870\uD68C",
   "help.specWorkingStamp": "stamp\uC640 \uC785\uB825 \uD30C\uC77C \uACBD\uB85C\uB9CC \uCD9C\uB825",
-  "help.specWorkingFeature": "\uD55C \uAE30\uB2A5 \uD3F4\uB354\uC758 \uBA85\uC138\uB9CC \uCD9C\uB825 (\uC81C\uD488\xB7\uC9C0\uCE68 \uC81C\uC678)",
+  "help.specWorkingFeature": "\uD55C \uAE30\uB2A5 \uD3F4\uB354\uC758 \uBA85\uC138\uB9CC \uCD9C\uB825 (\uC704\uD0A4 \uC81C\uC678)",
   "help.specWorkingIds": "\uBCF8\uBB38 \uC5C6\uC774 ID\xB7\uC81C\uBAA9\xB7\uACBD\uB85C\uB9CC \uCD9C\uB825",
-  "help.specSave": "\uC694\uAD6C\uC0AC\uD56D\xB7\uC124\uACC4\xB7\uBB38\uC11C \uC800\uC7A5",
+  "help.specSave": "\uC694\uAD6C\uC0AC\uD56D\xB7\uC124\uACC4\xB7\uC704\uD0A4 \uC800\uC7A5",
   "help.specRead": "\uCEE4\uBC0B \uC2DC\uC810\uC758 \uBA85\uC138 \uC870\uD68C",
   "help.specDiff": "\uB450 \uCEE4\uBC0B \uC0AC\uC774\uC758 \uBA85\uC138 \uBCC0\uACBD \uC870\uD68C",
   "git.operationInProgress": "Git \uC791\uC5C5\uC774 \uC9C4\uD589 \uC911\uC785\uB2C8\uB2E4: {marker}",
@@ -24712,7 +24856,6 @@ var messages_default2 = {
   "server.crossSite": "\uC678\uBD80 \uD398\uC774\uC9C0\uC758 \uC694\uCCAD\uC744 \uD5C8\uC6A9\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.",
   "server.noQuery": "\uC870\uD68C \uC778\uC790\uB97C \uBC1B\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.",
   "server.methodNotAllowed": "\uD5C8\uC6A9\uD558\uC9C0 \uC54A\uB294 \uBA54\uC11C\uB4DC\uC785\uB2C8\uB2E4.",
-  "server.productImageNotFound": "\uC81C\uD488 \uC774\uBBF8\uC9C0\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "server.apiNotFound": "API\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "server.sessionChanged": "\uC11C\uBC84 \uC138\uC158\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4. \uB2E4\uC2DC \uC5F0\uACB0\uD558\uC138\uC694.",
   "server.badRange": "\uC870\uD68C \uBC94\uC704\uB97C \uD655\uC778\uD558\uC138\uC694.",
@@ -24810,10 +24953,10 @@ var messages_default2 = {
   "browser.assetsUnreadable": "\uBE0C\uB77C\uC6B0\uC800 \uBE4C\uB4DC \uC790\uC0B0\uC744 \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. pnpm build\uB85C \uB2E4\uC2DC \uBE4C\uB4DC\uD558\uC138\uC694.",
   "docs.summary.workflow": "\uC2DC\uC791 \uC2DC \uD655\uC778\uD560 \uAC83, \uC694\uAD6C\uC0AC\uD56D\uC73C\uB85C \uB0A8\uAE38 \uC694\uCCAD\uC758 \uAD6C\uBD84, \uB9C8\uBB34\uB9AC \uBCF4\uACE0",
   "docs.summary.spec": "\uC0AC\uC6A9\uC790 \uC2A4\uD1A0\uB9AC\xB7\uC218\uC6A9 \uC870\uAC74 \uD615\uC2DD, ID \uADDC\uCE59, spec save \uC785\uB825",
-  "docs.summary.design": "design.md \uBAA9\uCC28, \uCC38\uC870 \uC8FC\uC11D, \uAC1C\uC815 \uBC29\uC2DD",
-  "docs.summary.product": "PRODUCT.md\uC640 guides \uBB38\uC11C\uC758 \uC5ED\uD560\uACFC \uC800\uC7A5 \uBA85\uB839",
+  "docs.summary.design": "design.md \uBAA9\uCC28, \uCC38\uC870 \uC8FC\uC11D\uACFC \uCC38\uACE0 \uBB38\uC11C, \uAC1C\uC815 \uBC29\uC2DD",
   "docs.summary.commit": "spec commit \uC785\uB825, \uC774\uC720 \uAE30\uB85D, \uC2E4\uD328 \uD6C4 \uBCF5\uAD6C",
   "help.browserNoUpdateCheck": "\uC0C8 \uBC84\uC804 \uD655\uC778\uC744 \uC704\uD55C npm \uB808\uC9C0\uC2A4\uD2B8\uB9AC \uC870\uD68C\uB97C \uB054 (GITIFACT_NO_UPDATE_CHECK\uC640 \uAC19\uC74C)",
+  "help.updateCommit": "\uAC31\uC2E0\uD55C GITIFACT \uBE14\uB85D\uC774 HEAD\uC640 \uBE14\uB85D \uC548\uC5D0\uC11C\uB9CC \uB2E4\uB974\uBA74 \uADF8 \uD30C\uC77C\uB9CC \uACE0\uC815 \uBA54\uC2DC\uC9C0\uB85C \uCEE4\uBC0B",
   "help.update": "\uC0C8 \uBC84\uC804 \uD655\uC778\uACFC \uC124\uCE58 \uBC29\uBC95 \uC548\uB0B4, \uD504\uB85C\uC81D\uD2B8 \uC9C0\uCE68 \uD30C\uC77C\uC758 GITIFACT \uBE14\uB85D\uC744 \uD604\uC7AC \uBC84\uC804\uC73C\uB85C \uAC31\uC2E0",
   "server.badLanguage": "\uC5B8\uC5B4 \uCF54\uB4DC\uB97C \uD655\uC778\uD558\uC138\uC694.",
   "server.changelogNotFound": "\uD328\uCE58\uB178\uD2B8\uB97C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.",
@@ -24824,12 +24967,24 @@ var messages_default2 = {
   "update.text.disabled": "\uC0C8 \uBC84\uC804 \uD655\uC778\uC774 \uAEBC\uC838 \uC788\uC2B5\uB2C8\uB2E4.",
   "update.text.unavailable": "\uC0C8 \uBC84\uC804\uC744 \uD655\uC778\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uB124\uD2B8\uC6CC\uD06C \uC5F0\uACB0\uC744 \uD655\uC778\uD558\uC138\uC694.",
   "update.text.install": "npm \uC804\uC5ED \uC124\uCE58\uC6A9: {command}",
-  "update.text.afterInstall": "\uC124\uCE58\uD55C \uB4A4 gitifact update\uB97C \uB2E4\uC2DC \uC2E4\uD589\uD558\uBA74 \uC9C0\uCE68 \uBE14\uB85D\uC774 \uC0C8 \uBC84\uC804\uC73C\uB85C \uAC31\uC2E0\uB429\uB2C8\uB2E4.",
+  "update.text.afterInstall": "\uC124\uCE58\uD55C \uB4A4 gitifact update --commit\uC744 \uB2E4\uC2DC \uC2E4\uD589\uD558\uBA74 \uC9C0\uCE68 \uBE14\uB85D\uC774 \uC0C8 \uBC84\uC804\uC73C\uB85C \uAC31\uC2E0\uB418\uACE0 \uCEE4\uBC0B\uB429\uB2C8\uB2E4.",
   "update.text.blockRefreshed": "\uC9C0\uCE68 \uBE14\uB85D \uAC31\uC2E0: {paths}",
   "update.text.blockCurrent": "\uC9C0\uCE68 \uBE14\uB85D\uC740 \uC774\uBBF8 \uD604\uC7AC \uBC84\uC804\uC785\uB2C8\uB2E4: {paths}",
   "update.text.noBlock": "GITIFACT \uBE14\uB85D\uC774 \uC788\uB294 \uC9C0\uCE68 \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. gitifact init\uC73C\uB85C \uC124\uCE58\uD558\uC138\uC694.",
   "update.text.notInitialized": "\uCD08\uAE30\uD654\uB41C \uD504\uB85C\uC81D\uD2B8\uAC00 \uC544\uB2C8\uC5B4\uC11C \uBC84\uC804\uB9CC \uD655\uC778\uD588\uC2B5\uB2C8\uB2E4.",
-  "update.failed": "\uC5C5\uB370\uC774\uD2B8 \uD655\uC778\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4."
+  "update.text.missing": "{paths} \uD30C\uC77C\uC774 \uC5C6\uC5B4 Claude Code\uAC00 AGENTS.md\uC758 \uC9C0\uCE68\uC744 \uC77D\uC9C0 \uBABB\uD569\uB2C8\uB2E4. gitifact init\uC744 \uB2E4\uC2DC \uC2E4\uD589\uD558\uBA74 AGENTS.md\uB97C \uAC00\uC838\uC624\uB294 \uD30C\uC77C\uC744 \uB9CC\uB4ED\uB2C8\uB2E4.",
+  "update.text.committed": "\uC9C0\uCE68 \uBE14\uB85D \uCEE4\uBC0B: {commit} ({paths})",
+  "update.text.commitNothing": "\uCEE4\uBC0B\uD560 \uC9C0\uCE68 \uBE14\uB85D \uBCC0\uACBD\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
+  "update.text.commitSkipped.untracked": "\uCEE4\uBC0B\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. Git\uC774 \uCD94\uC801\uD558\uC9C0 \uC54A\uB294 \uC9C0\uCE68 \uD30C\uC77C\uC785\uB2C8\uB2E4: {paths}",
+  "update.text.commitSkipped.other-changes": "\uCEE4\uBC0B\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uBE14\uB85D \uBC16\uC5D0\uB3C4 \uCEE4\uBC0B\uB418\uC9C0 \uC54A\uC740 \uC218\uC815\uC774 \uC788\uC2B5\uB2C8\uB2E4: {paths}",
+  "update.text.commitSkipped.commit-failed": "\uCEE4\uBC0B\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. git commit\uC774 \uAC70\uBD80\uB410\uACE0 \uAC31\uC2E0\uD55C \uD30C\uC77C\uC740 \uADF8\uB300\uB85C \uB0A8\uC544 \uC788\uC2B5\uB2C8\uB2E4: {paths}",
+  "update.commitResultUnknown": "\uCEE4\uBC0B \uACB0\uACFC\uB97C \uD655\uC778\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. HEAD {commit}\uC758 \uBD80\uBAA8\uC640 \uBCC0\uACBD \uD30C\uC77C\uC744 \uC9C1\uC811 \uD655\uC778\uD558\uC138\uC694.",
+  "update.failed": "\uC5C5\uB370\uC774\uD2B8 \uD655\uC778\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4.",
+  "docs.summary.wiki": "\uD504\uB85C\uC81D\uD2B8 \uC704\uD0A4\uC758 \uD615\uC2DD\uACFC \uC800\uC7A5 \uBA85\uB839, \uC5D0\uC14B \uADDC\uCE59, \uC774 \uD504\uB85C\uC81D\uD2B8\uC758 \uC704\uD0A4 \uC6B4\uC601 \uBC29\uCE68(wiki/README.md)",
+  "server.assetNotFound": "\uC5D0\uC14B\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
+  "docs.wikiPolicyProject": "\uC6B4\uC601 \uBC29\uCE68 (.gitifact/wiki/README.md)",
+  "docs.wikiPolicyDefault": "\uC6B4\uC601 \uBC29\uCE68 (\uAE30\uBCF8\uAC12. .gitifact/wiki/README.md\uAC00 \uC5C6\uC5B4 \uB0B4\uC7A5 \uBC29\uCE68\uC744 \uC2E3\uB294\uB2E4)",
+  "init.wikiReadmeTitle": "\uC704\uD0A4 \uC6B4\uC601 \uBC29\uCE68"
 };
 
 // src/shared/i18n/index.ts
@@ -24905,8 +25060,8 @@ async function runStatus(format) {
 import { createServer } from "node:http";
 import { randomUUID as randomUUID4 } from "node:crypto";
 import { fileURLToPath } from "node:url";
-import { lstat as lstat3, readFile as readFile4 } from "node:fs/promises";
-import { join as join4 } from "node:path";
+import { lstat as lstat4, readFile as readFile4 } from "node:fs/promises";
+import { join as join5 } from "node:path";
 
 // src/server/assets.ts
 import { readdir, readFile } from "node:fs/promises";
@@ -24939,6 +25094,7 @@ function contentType(path3) {
   if (/\.jpe?g$/.test(path3)) return "image/jpeg";
   if (path3.endsWith(".gif")) return "image/gif";
   if (path3.endsWith(".webp")) return "image/webp";
+  if (path3.endsWith(".pdf")) return "application/pdf";
   return "application/octet-stream";
 }
 
@@ -25045,7 +25201,7 @@ function commandScoped(key, load) {
 }
 
 // src/adapters/git/spec-preview-reader.ts
-var RECORD_PATHSPECS = [...STORE_DIRS.map((d) => d + "/spec/"), ...Object.values(DOCUMENT_DIRS).map((d) => d + "/")];
+var RECORD_PATHSPECS = [...STORE_DIRS.map((d) => d + "/spec/"), WIKI_DIR + "/"];
 var LegacyBaselineError = class extends SpecPreviewError {
 };
 function specPreviewReader(cwd) {
@@ -25079,7 +25235,7 @@ function specPreviewReader(cwd) {
         const [, mode, oid2, stage, path3] = match;
         if (!["100644", "100755"].includes(mode) || stage !== "0") throw new SpecPreviewError(t2("reader.stagingConflictOrLink"));
         if (!recordPathPattern.test(path3)) {
-          if (/^\.gitifact\/(?:product|guides)\//.test(path3)) continue;
+          if (path3.startsWith(WIKI_DIR + "/")) continue;
           throw new SpecPreviewError(t2("reader.stagingUnsupported"));
         }
         files.set(path3, oid2);
@@ -25175,38 +25331,85 @@ function specPreviewReader(cwd) {
 }
 
 // src/adapters/filesystem/spec-preview-store.ts
-import { lstat as lstat2, readdir as readdir2, readFile as readFile3, mkdir as mkdir2, writeFile, rename, unlink as unlink2, rmdir } from "node:fs/promises";
-import { join as join3, dirname } from "node:path";
+import { lstat as lstat3, readdir as readdir3, readFile as readFile3, mkdir as mkdir2, writeFile, rename, unlink as unlink2, rmdir } from "node:fs/promises";
+import { join as join4, dirname } from "node:path";
 import { createHash as createHash2, randomBytes } from "node:crypto";
 
-// src/adapters/filesystem/config-file.ts
-import { lstat, readFile as readFile2, realpath, mkdir, open as open2, link, unlink } from "node:fs/promises";
+// src/adapters/filesystem/working-warnings.ts
+import { lstat, readdir as readdir2 } from "node:fs/promises";
 import { join as join2 } from "node:path";
+var info = async (path3) => lstat(path3).catch((e) => {
+  if (e.code === "ENOENT") return void 0;
+  throw e;
+});
+var posix = (path3) => path3.split("\\").join("/");
+async function listAssets(root) {
+  const out = [];
+  async function visit2(relative, depth) {
+    const stat3 = await info(join2(root, relative));
+    if (!stat3 || stat3.isSymbolicLink()) return;
+    if (stat3.isDirectory()) {
+      if (depth > 8 || out.length > 4e3) return;
+      for (const name of (await readdir2(join2(root, relative))).sort()) await visit2(relative + "/" + name, depth + 1);
+    } else if (stat3.isFile()) out.push({ path: posix(relative), bytes: stat3.size });
+  }
+  await visit2(ASSETS_DIR, 0);
+  return out;
+}
+async function workingWarnings(root, bundle) {
+  const warnings = designReferenceWarnings(bundle.specs);
+  const records = /* @__PURE__ */ new Set([...bundle.specs.flatMap((s) => [s.path, ...s.design ? [s.path.replace(/requirements\.md$/, "design.md")] : []]), ...bundle.wiki.documents.map((d) => d.path)]);
+  const assets = await listAssets(root);
+  const assetPaths = new Set(assets.map((a) => a.path));
+  const referenced = /* @__PURE__ */ new Set();
+  for (const { from, link: link3, target } of documentLinks(bundle)) {
+    if (records.has(target)) continue;
+    if (assetPaths.has(target)) {
+      referenced.add(target);
+      continue;
+    }
+    const stat3 = target.startsWith(".gitifact/") ? void 0 : await info(join2(root, ...target.split("/")));
+    if (!stat3?.isFile()) warnings.push({ code: "MISSING_LINK_TARGET", path: from, target, link: link3 });
+  }
+  let total = 0;
+  for (const asset of assets) {
+    total += asset.bytes;
+    if (asset.bytes > ASSET_SIZE_LIMIT) warnings.push({ code: "ASSET_SIZE", path: asset.path, bytes: asset.bytes });
+    if (!RECOMMENDED_ASSET_EXTENSIONS.includes(assetExtension(asset.path))) warnings.push({ code: "ASSET_EXTENSION", path: asset.path });
+    if (!referenced.has(asset.path)) warnings.push({ code: "UNREFERENCED_ASSET", path: asset.path });
+  }
+  if (total > ASSETS_TOTAL_LIMIT) warnings.push({ code: "ASSETS_TOTAL_SIZE", bytes: total });
+  return warnings;
+}
+
+// src/adapters/filesystem/config-file.ts
+import { lstat as lstat2, readFile as readFile2, realpath, mkdir, open as open2, link, unlink } from "node:fs/promises";
+import { join as join3 } from "node:path";
 import { randomUUID as randomUUID3 } from "node:crypto";
 var missing = (error62) => error62.code === "ENOENT";
-var fileInfo = (path3) => lstat(path3).catch((error62) => {
+var fileInfo = (path3) => lstat2(path3).catch((error62) => {
   if (missing(error62)) return void 0;
   throw error62;
 });
 async function configDirectory(root) {
-  const path3 = join2(root, ".gitifact");
-  const info5 = await fileInfo(path3);
-  if (info5 && (!info5.isDirectory() || info5.isSymbolicLink())) throw new InitError("PATH_CONFLICT", t2("config.storeNotDirectory"));
-  return info5;
+  const path3 = join3(root, ".gitifact");
+  const info7 = await fileInfo(path3);
+  if (info7 && (!info7.isDirectory() || info7.isSymbolicLink())) throw new InitError("PATH_CONFLICT", t2("config.storeNotDirectory"));
+  return info7;
 }
 async function readConfigFile(root) {
   await configDirectory(root);
-  const path3 = join2(root, ".gitifact", "config.json");
-  const info5 = await fileInfo(path3);
-  if (!info5) {
-    if (await fileInfo(join2(root, ".tryce", "config.json"))) throw new InitError("MIGRATION_REQUIRED", t2("config.migrateFirst"));
+  const path3 = join3(root, ".gitifact", "config.json");
+  const info7 = await fileInfo(path3);
+  if (!info7) {
+    if (await fileInfo(join3(root, ".tryce", "config.json"))) throw new InitError("MIGRATION_REQUIRED", t2("config.migrateFirst"));
     return void 0;
   }
-  if (!info5.isFile() || info5.isSymbolicLink() || info5.size > 65536) throw new InitError("PATH_CONFLICT", t2("config.fileShape"));
+  if (!info7.isFile() || info7.isSymbolicLink() || info7.size > 65536) throw new InitError("PATH_CONFLICT", t2("config.fileShape"));
   const bytes = await readFile2(path3);
   const after = await fileInfo(path3);
   await configDirectory(root);
-  if (!after || after.ino !== info5.ino || after.dev !== info5.dev || after.mtimeMs !== info5.mtimeMs || bytes.length > 65536) {
+  if (!after || after.ino !== info7.ino || after.dev !== info7.dev || after.mtimeMs !== info7.mtimeMs || bytes.length > 65536) {
     throw new InitError("INPUT_CHANGED", t2("config.changedWhileReading"));
   }
   try {
@@ -25216,7 +25419,7 @@ async function readConfigFile(root) {
   }
 }
 async function publishConfig(root, text2, recheck, beforePublish) {
-  const directory = join2(root, ".gitifact");
+  const directory = join3(root, ".gitifact");
   await configDirectory(root);
   await mkdir(directory).catch((error62) => {
     if (error62.code !== "EEXIST") throw error62;
@@ -25229,7 +25432,7 @@ async function publishConfig(root, text2, recheck, beforePublish) {
       throw new InitError("INPUT_CHANGED", t2("config.directoryChanged"));
     }
   };
-  const temporary = join2(directory, ".init-" + randomUUID3() + ".tmp");
+  const temporary = join3(directory, ".init-" + randomUUID3() + ".tmp");
   const handle = await open2(temporary, "wx", 384);
   const tempOwner = await handle.stat();
   try {
@@ -25246,7 +25449,7 @@ async function publishConfig(root, text2, recheck, beforePublish) {
     const bytes = await readFile2(temporary, "utf8");
     if (bytes !== text2) throw new InitError("INPUT_CHANGED", t2("config.temporaryChanged"));
     parseManagedConfig(bytes);
-    await link(temporary, join2(directory, "config.json"));
+    await link(temporary, join3(directory, "config.json"));
   } finally {
     await unchanged();
     const current = await fileInfo(temporary);
@@ -25258,14 +25461,14 @@ async function publishConfig(root, text2, recheck, beforePublish) {
 var fail4 = (message) => {
   throw new SpecPreviewError(message);
 };
-var info = async (path3) => lstat2(path3).catch((e) => {
+var info2 = async (path3) => lstat3(path3).catch((e) => {
   if (e.code === "ENOENT") return void 0;
   throw e;
 });
 var digest = (value) => createHash2("sha256").update(value).digest("hex");
 var LEGACY_LOCKS = ["tryce-spec-preview.lock", "tryce-spec-commit.lock"];
 async function failOnLegacyLock(gitDir) {
-  for (const name of LEGACY_LOCKS) if (await info(join3(gitDir, name))) fail4(t2("store.legacyLock", { path: join3(gitDir, name) }));
+  for (const name of LEGACY_LOCKS) if (await info2(join4(gitDir, name))) fail4(t2("store.legacyLock", { path: join4(gitDir, name) }));
 }
 var decode3 = (bytes) => new TextDecoder("utf-8", { fatal: true, ignoreBOM: true }).decode(bytes);
 var generatePreviewId = (prefix) => prefix + "-" + [...randomBytes(10)].map((n) => "abcdefghijklmnopqrstuvwxyz234567"[n & 31]).join("");
@@ -25275,48 +25478,48 @@ async function snapshot2(root) {
   const files = /* @__PURE__ */ new Map();
   let count = 0;
   let bytes = 0;
-  const parent = await info(join3(root, ".gitifact"));
+  const parent = await info2(join4(root, ".gitifact"));
   if (parent && (!parent.isDirectory() || parent.isSymbolicLink())) fail4(t2("store.storeNotDirectory"));
-  if (!parent && await info(join3(root, ".tryce"))) fail4(t2("store.migrateFirst"));
+  if (!parent && await info2(join4(root, ".tryce"))) fail4(t2("store.migrateFirst"));
   const config2 = await readConfigFile(root);
-  if (config2 !== void 0 && !("schemaVersion" in parseManagedConfig(config2)) || await info(join3(root, "specs"))) fail4(t2("store.legacyProject"));
+  if (config2 !== void 0 && !("schemaVersion" in parseManagedConfig(config2)) || await info2(join4(root, "specs"))) fail4(t2("store.legacyProject"));
   async function visit2(path3, depth, documents) {
-    const stat3 = await info(join3(root, path3));
+    const stat3 = await info2(join4(root, path3));
     if (!stat3) return;
     if (stat3.isSymbolicLink() || !stat3.isDirectory() && !stat3.isFile()) fail4(t2("store.linkOrSpecial", { path: path3 }));
     if (++count > 4e3) fail4(t2("store.tooManyFiles"));
     if (stat3.isDirectory()) {
       if (depth > (documents ? 8 : 1)) fail4(t2("store.tooDeep", { path: path3 }));
-      for (const name of (await readdir2(join3(root, path3))).sort()) await visit2(path3 + "/" + name, depth + 1, documents);
+      for (const name of (await readdir3(join4(root, path3))).sort()) await visit2(path3 + "/" + name, depth + 1, documents);
     } else {
       if (path3.endsWith("/tryce.json")) fail4(t2("store.legacyJson"));
       if (documents ? !(path3.endsWith(".md") || depth === 1 && path3.endsWith("/history.jsonl")) : !/\/(requirements\.md|design\.md|history\.jsonl)$/.test(path3)) return;
       if (!recordPathPattern.test(path3) || path3.startsWith(".tryce/")) fail4(t2("store.unsupportedPath", { path: path3 }));
       if (stat3.nlink !== 1 || stat3.size > 1024 * 1024) fail4(t2("store.hardLinkOrSize"));
-      const raw = await readFile3(join3(root, path3));
+      const raw = await readFile3(join4(root, path3));
       bytes += raw.length;
       if (raw.length > 1024 * 1024 || bytes > 16 * 1024 * 1024) fail4(t2("store.sizeLimit"));
       files.set(path3, decode3(raw));
     }
   }
   await visit2(".gitifact/spec", 0, false);
-  for (const dir of Object.values(DOCUMENT_DIRS)) await visit2(dir, 0, true);
+  await visit2(WIKI_DIR, 0, true);
   const bundle = parsePreviewBundle(files);
-  return { files, specs: bundle.specs, documents: bundle.documents, bundle, config: config2, stamp: digest(JSON.stringify([...files].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) + (config2 ?? "")) };
+  return { root, files, specs: bundle.specs, wiki: bundle.wiki, bundle, config: config2, stamp: digest(JSON.stringify([...files].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) + (config2 ?? "")) };
 }
 async function readWorkingPreviewState(cwd) {
   const { root, gitDir } = await specPreviewReader(cwd).location();
   await failOnLegacyLock(gitDir);
-  if (await info(join3(gitDir, "gitifact-spec-preview.lock"))) fail4(t2("store.locked"));
+  if (await info2(join4(gitDir, "gitifact-spec-preview.lock"))) fail4(t2("store.locked"));
   const first = await snapshot2(root);
   const second = await snapshot2(root);
   if (first.stamp !== second.stamp) fail4(t2("store.changedWhileReading"));
-  if (await info(join3(gitDir, "gitifact-spec-preview.lock"))) fail4(t2("store.lockedWhileReading"));
+  if (await info2(join4(gitDir, "gitifact-spec-preview.lock"))) fail4(t2("store.lockedWhileReading"));
   return first;
 }
 async function readWorkingPreview(cwd) {
-  const { stamp, specs, documents } = await readWorkingPreviewState(cwd);
-  return { stamp, specs, documents, warnings: designReferenceWarnings(specs) };
+  const { root, stamp, specs, wiki, bundle } = await readWorkingPreviewState(cwd);
+  return { stamp, specs, wiki, warnings: await workingWarnings(root, bundle) };
 }
 async function saveWorkingPreview(cwd, input2, publish = rename) {
   if (!input2 || typeof input2 !== "object" || Array.isArray(input2)) fail4(t2("store.invalidInput"));
@@ -25330,8 +25533,8 @@ async function saveWorkingPreview(cwd, input2, publish = rename) {
       if (!old || renderSpecPreview(old) !== renderSpecPreview(spec2)) writes.set(spec2.path, renderSpecPreview(spec2));
       if (JSON.stringify(old?.design) !== JSON.stringify(spec2.design)) writes.set(spec2.path.replace(/requirements\.md$/, "design.md"), spec2.design ? renderDesignPreview(spec2.id, spec2.design) : null);
     }
-    const previousDocs = before.documents.flatMap((s) => s.documents);
-    const nextDocs = result.documents.flatMap((s) => s.documents);
+    const previousDocs = before.wiki.documents;
+    const nextDocs = result.wiki.documents;
     for (const doc of nextDocs) {
       const old = previousDocs.find((d) => d.id === doc.id);
       if (old && old.path !== doc.path) writes.set(old.path, null);
@@ -25345,7 +25548,7 @@ var readLockedPreviewState = (root) => snapshot2(root);
 async function previewTransaction(cwd, expected2, build, publish = rename, afterPublish) {
   const { root, gitDir } = await specPreviewReader(cwd).location();
   await failOnLegacyLock(gitDir);
-  const lock = join3(gitDir, "gitifact-spec-preview.lock");
+  const lock = join4(gitDir, "gitifact-spec-preview.lock");
   try {
     await mkdir2(lock);
   } catch (e) {
@@ -25358,7 +25561,7 @@ async function previewTransaction(cwd, expected2, build, publish = rename, after
   const published = [];
   let keepRecovery = false;
   async function directory(path3) {
-    const stat3 = await info(path3);
+    const stat3 = await info2(path3);
     if (stat3) {
       if (!stat3.isDirectory() || stat3.isSymbolicLink()) fail4(t2("store.notDirectory", { path: path3 }));
       return;
@@ -25382,14 +25585,14 @@ async function previewTransaction(cwd, expected2, build, publish = rename, after
       else finalFiles.set(c.path, c.after);
     }
     if (finalFiles.size > 2e3 || [...finalFiles.values()].reduce((n, s) => n + Buffer.byteLength(s), 0) > 16 * 1024 * 1024) fail4(t2("store.totalLimit"));
-    await writeFile(join3(lock, "recovery.json"), JSON.stringify({ root, changed }), { flag: "wx" });
+    await writeFile(join4(lock, "recovery.json"), JSON.stringify({ root, changed }), { flag: "wx" });
     for (const c of changed) {
       if (c.after === null) {
         temporary.push("");
         continue;
       }
-      await directory(dirname(join3(root, c.path)));
-      const temp = join3(dirname(join3(root, c.path)), ".gitifact-save-" + randomBytes(12).toString("hex"));
+      await directory(dirname(join4(root, c.path)));
+      const temp = join4(dirname(join4(root, c.path)), ".gitifact-save-" + randomBytes(12).toString("hex"));
       await writeFile(temp, c.after, { flag: "wx" });
       temporary.push(temp);
     }
@@ -25397,8 +25600,8 @@ async function previewTransaction(cwd, expected2, build, publish = rename, after
     await result.recheck?.();
     for (let i = 0; i < changed.length; i++) {
       const c = changed[i];
-      const path3 = join3(root, c.path);
-      const stat3 = await info(path3);
+      const path3 = join4(root, c.path);
+      const stat3 = await info2(path3);
       if (stat3?.isSymbolicLink() || stat3 && !stat3.isFile() || (stat3 ? decode3(await readFile3(path3)) : null) !== c.before) fail4(t2("store.changedBeforeWrite"));
       if (c.after === null) await unlink2(path3);
       else await publish(temporary[i], path3);
@@ -25408,7 +25611,7 @@ async function previewTransaction(cwd, expected2, build, publish = rename, after
     if (after.stamp !== digest(JSON.stringify([...finalFiles].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) + (before.config ?? ""))) fail4(t2("store.changedWhileWriting"));
     await result.recheck?.();
     await afterPublish?.(after);
-    return { ...result.data, stamp: after.stamp, paths: changed.map((c) => c.path), specs: after.specs, documents: after.documents, warnings: designReferenceWarnings(after.specs) };
+    return { ...result.data, stamp: after.stamp, paths: changed.map((c) => c.path), specs: after.specs, wiki: after.wiki, warnings: await workingWarnings(root, after.bundle) };
   } catch (error62) {
     if (error62 instanceof PreservedPreviewError) {
       keepRecovery = true;
@@ -25416,15 +25619,15 @@ async function previewTransaction(cwd, expected2, build, publish = rename, after
     }
     for (const c of [...published].reverse()) {
       try {
-        const path3 = join3(root, c.path);
-        const stat3 = await info(path3);
+        const path3 = join4(root, c.path);
+        const stat3 = await info2(path3);
         if (c.after === null ? !!stat3 : !stat3?.isFile() || stat3.isSymbolicLink() || decode3(await readFile3(path3)) !== c.after) {
           keepRecovery = true;
           continue;
         }
         if (c.before === null) await unlink2(path3);
         else {
-          const temp = join3(dirname(path3), ".gitifact-restore-" + randomBytes(12).toString("hex"));
+          const temp = join4(dirname(path3), ".gitifact-restore-" + randomBytes(12).toString("hex"));
           temporary.push(temp);
           await writeFile(temp, c.before, { flag: "wx" });
           await rename(temp, path3);
@@ -25442,7 +25645,7 @@ async function previewTransaction(cwd, expected2, build, publish = rename, after
     for (const path3 of [...createdDirs].reverse()) await rmdir(path3).catch(() => {
     });
     if (!keepRecovery) {
-      await unlink2(join3(lock, "recovery.json")).catch((e) => {
+      await unlink2(join4(lock, "recovery.json")).catch((e) => {
         if (e.code !== "ENOENT") throw e;
       });
       await rmdir(lock);
@@ -25484,8 +25687,8 @@ function createSpecBrowserReader(root, sessionId, inherited = process.env) {
     if (cursor > 0 && expectedHead !== base.head) throw new SpecPreviewError(t2("specReader.historyChanged"));
     const current = await readWorkingPreviewState(root);
     const bare = current.specs.map(({ history: _history, ...s }) => ({ ...s, contributors: [], updatedAt: null }));
-    const bareDocuments = current.documents.flatMap((set2) => set2.documents).map((d) => ({ ...d, updatedAt: null }));
-    if (!base.head) return browserSpecsV1.parse({ contract: "browser-specs", version: 1, sessionId, head: null, observedAt: (/* @__PURE__ */ new Date()).toISOString(), working: bare.length > 0 || bareDocuments.length > 0, features: bare, documents: bareDocuments, events: [], contributors: [], contributorsLimited: false, nextCursor: null, boundary: false });
+    const bareDocuments = current.wiki.documents.map((d) => ({ ...d, updatedAt: null }));
+    if (!base.head) return browserSpecsV2.parse({ contract: "browser-specs", version: 2, sessionId, head: null, observedAt: (/* @__PURE__ */ new Date()).toISOString(), working: bare.length > 0 || bareDocuments.length > 0, features: bare, documents: bareDocuments, events: [], contributors: [], contributorsLimited: false, nextCursor: null, boundary: false });
     const head = base.head;
     const features = await Promise.all(bare.map(async (feature2) => {
       const folder = feature2.path.replace(/^\.(?:gitifact|tryce)\/(spec\/[^/]+)\/requirements\.md$/, "$1");
@@ -25501,7 +25704,7 @@ function createSpecBrowserReader(root, sessionId, inherited = process.env) {
       return { ...feature2, contributors: [...people.values()].sort((a, b) => b.commits - a.commits), updatedAt: lines[0]?.split("\0")[2] ?? null };
     }));
     const documents = await Promise.all(bareDocuments.map(async (doc) => ({ ...doc, updatedAt: (await git(["log", "--format=%aI", "--max-count=1", head, "--", doc.path])).trim() || null })));
-    const documentDirs = Object.values(DOCUMENT_DIRS);
+    const documentDirs = [WIKI_DIR];
     const [rows, dirty] = await Promise.all([
       git([
         "log",
@@ -25535,7 +25738,7 @@ function createSpecBrowserReader(root, sessionId, inherited = process.env) {
       const [commit, parents, author, email3, date5, committer, message] = row.split("\0");
       if (!commit || author === void 0 || email3 === void 0 || !date5 || committer === void 0 || message === void 0) throw new SpecPreviewError(t2("specReader.historyUnreadable"));
       const after = await snapshot3(commit);
-      let before = { specs: [], documents: [{ kind: "product", documents: [], history: [] }, { kind: "guide", documents: [], history: [] }] };
+      let before = emptyBundle();
       const parent = parents?.split(" ")[0];
       if (parent) {
         try {
@@ -25562,9 +25765,9 @@ function createSpecBrowserReader(root, sessionId, inherited = process.env) {
       }));
     }));
     if (await readHead() !== head || (await readWorkingPreviewState(root)).stamp !== current.stamp) throw new SpecPreviewError(t2("specReader.projectChanged"));
-    return browserSpecsV1.parse({
+    return browserSpecsV2.parse({
       contract: "browser-specs",
-      version: 1,
+      version: 2,
       sessionId,
       head,
       observedAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -25658,18 +25861,27 @@ async function startBrowserServer(options) {
     if (api) {
       if (request.headers["sec-fetch-site"] === "cross-site" && !allowedOrigin) return fail8(response, 403, "FORBIDDEN", t2("server.crossSite"));
       if (url2.search && path3 !== "/api/v1/specs" && path3 !== "/api/v1/changelog") return fail8(response, 400, "BAD_REQUEST", t2("server.noQuery"));
-      if (path3.startsWith("/api/v1/product/assets/")) {
-        const name = path3.slice("/api/v1/product/assets/".length);
+      if (path3.startsWith("/api/v1/assets/")) {
+        const relative = path3.slice("/api/v1/assets/".length);
+        const assetPath2 = ASSETS_DIR + "/" + relative;
         if (request.method !== "GET") {
           response.setHeader("Allow", "GET");
           return fail8(response, 405, "METHOD_NOT_ALLOWED", t2("server.methodNotAllowed"));
         }
-        if (!isProductAssetPath(".gitifact/product/" + name)) return fail8(response, 404, "NOT_FOUND", t2("server.productImageNotFound"));
-        const file2 = join4(initial.repository.rootPath, ".gitifact", "product", name);
-        const stat3 = await lstat3(file2).catch(() => void 0);
-        if (!stat3?.isFile() || stat3.isSymbolicLink() || stat3.size > 5 * 1024 * 1024) return fail8(response, 404, "NOT_FOUND", t2("server.productImageNotFound"));
+        if (!isAssetPath(assetPath2)) return fail8(response, 404, "NOT_FOUND", t2("server.assetNotFound"));
+        const file2 = join5(initial.repository.rootPath, ...assetPath2.split("/"));
+        const stat3 = await lstat4(file2).catch(() => void 0);
+        if (!stat3?.isFile() || stat3.isSymbolicLink() || stat3.size > 20 * 1024 * 1024) return fail8(response, 404, "NOT_FOUND", t2("server.assetNotFound"));
         const bytes = await readFile4(file2);
-        response.writeHead(200, { "Content-Type": contentType(name.toLowerCase()), "Cache-Control": "no-cache", "Content-Length": bytes.length });
+        const extension = assetExtension(relative);
+        const inline = ["png", "jpg", "jpeg", "gif", "webp", "svg"].includes(extension);
+        response.writeHead(200, {
+          "Content-Type": contentType("." + extension),
+          "Cache-Control": "no-cache",
+          "Content-Length": bytes.length,
+          "Content-Security-Policy": "default-src 'none'; sandbox",
+          "Content-Disposition": inline ? "inline" : 'attachment; filename="' + encodeURIComponent(relative.split("/").pop()) + '"'
+        });
         response.end(bytes);
         return;
       }
@@ -25833,13 +26045,13 @@ async function runBrowser(options, version2) {
 }
 
 // src/commands/spec-init.ts
-import { readdir as readdir3 } from "node:fs/promises";
-import { join as join7 } from "node:path";
+import { mkdir as mkdir4, readdir as readdir4, writeFile as writeFile2 } from "node:fs/promises";
+import { join as join9 } from "node:path";
 
 // src/adapters/git/init-repository.ts
 import { createHash as createHash3 } from "node:crypto";
 import { readFile as readFile5 } from "node:fs/promises";
-import { join as join5 } from "node:path";
+import { join as join6 } from "node:path";
 function initRepository(cwd, inherited = process.env) {
   const env = { ...inherited, GIT_OPTIONAL_LOCKS: "0", GIT_NO_LAZY_FETCH: "1", GIT_TERMINAL_PROMPT: "0", GIT_LITERAL_PATHSPECS: "1", LC_ALL: "C" };
   const runner = createGitRunner();
@@ -25859,7 +26071,7 @@ function initRepository(cwd, inherited = process.env) {
       const gitDir = locations.length === 2 ? locations[0] : decodeGitLine(await git(["rev-parse", "--absolute-git-dir"], root));
       const indexPath = locations.length === 2 ? locations[1] : decodeGitLine(await git(["rev-parse", "--path-format=absolute", "--git-path", "index"], root));
       for (const marker2 of ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply", "sequencer", "BISECT_START", "index.lock"]) {
-        if (await fileInfo(join5(gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker2 }));
+        if (await fileInfo(join6(gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker2 }));
       }
       if (state.changes.some((change2) => change2.kind === "unmerged")) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.resolveConflicts"));
       const index = await readFile5(indexPath).catch((error62) => {
@@ -25897,22 +26109,22 @@ function initRepository(cwd, inherited = process.env) {
 
 // src/adapters/filesystem/managed-file.ts
 import { open as open3, readFile as readFile6, mkdir as mkdir3, realpath as realpath2, rename as rename2, link as link2, unlink as unlink3 } from "node:fs/promises";
-import { join as join6, dirname as dirname2 } from "node:path";
+import { join as join7, dirname as dirname2 } from "node:path";
 import { randomUUID as randomUUID5 } from "node:crypto";
 var DEFAULT_LIMIT = 1024 * 1024;
 async function managedPath(root, path3, create = false) {
   let full = root;
   const parts = path3.split("/");
   for (let i = 0; i < parts.length; i++) {
-    full = join6(full, parts[i]);
-    let info5 = await fileInfo(full);
-    if (!info5 && create && i < parts.length - 1) {
+    full = join7(full, parts[i]);
+    let info7 = await fileInfo(full);
+    if (!info7 && create && i < parts.length - 1) {
       await mkdir3(full).catch((error62) => {
         if (error62.code !== "EEXIST") throw error62;
       });
-      info5 = await fileInfo(full);
+      info7 = await fileInfo(full);
     }
-    if (info5 && (info5.isSymbolicLink() || (i < parts.length - 1 ? !info5.isDirectory() : !info5.isFile()))) {
+    if (info7 && (info7.isSymbolicLink() || (i < parts.length - 1 ? !info7.isDirectory() : !info7.isFile()))) {
       throw new InitError("PATH_CONFLICT", t2("managedFile.notRegularPath", { path: path3 }));
     }
   }
@@ -25952,7 +26164,7 @@ async function managedWrite(root, path3, previous, next, recheck) {
     if (previous !== null) await unlink3(full);
     return;
   }
-  const temp = join6(directory, ".gitifact-managed-" + randomUUID5() + ".tmp");
+  const temp = join7(directory, ".gitifact-managed-" + randomUUID5() + ".tmp");
   const handle = await open3(temp, "wx", 384);
   const tempOwner = await handle.stat();
   try {
@@ -25978,14 +26190,53 @@ async function managedWrite(root, path3, previous, next, recheck) {
 import { readFile as readFile8 } from "node:fs/promises";
 
 // src/commands/docs.ts
-import { readFile as readFile7 } from "node:fs/promises";
-var docTopics = ["workflow", "spec", "design", "product", "commit"];
+import { lstat as lstat5, readFile as readFile7 } from "node:fs/promises";
+import { dirname as dirname3, join as join8 } from "node:path";
+var docTopics = ["workflow", "spec", "design", "wiki", "commit"];
 var isDocTopic = (value) => docTopics.includes(value);
-var readBundled = (topic, lang) => readFile7(new URL("./i18n/" + lang + "/docs/" + topic + ".md", import.meta.url), "utf8");
+var readBundledDoc = (name, lang) => readFile7(new URL("./i18n/" + lang + "/docs/" + name + ".md", import.meta.url), "utf8");
+var info3 = (path3) => lstat5(path3).catch((e) => {
+  if (e.code === "ENOENT") return void 0;
+  throw e;
+});
 function listDocTopics(lang = defaultLanguage2) {
   const width = Math.max(...docTopics.map((topic) => topic.length));
   return docTopics.map((topic) => topic.padEnd(width) + "  " + t2(`docs.summary.${topic}`, {}, lang)).join("\n") + "\n";
 }
+async function findProjectRoot(cwd) {
+  for (let dir = cwd; ; dir = dirname3(dir)) {
+    if ((await info3(join8(dir, ".gitifact", "config.json")))?.isFile()) return dir;
+    if (dirname3(dir) === dir) return void 0;
+  }
+}
+async function readWikiPolicy(root) {
+  if (!root) return void 0;
+  const path3 = join8(root, ...WIKI_ENTRY_PATH.split("/"));
+  const stat3 = await info3(path3);
+  if (!stat3?.isFile() || stat3.size > 1024 * 1024) return void 0;
+  const lines = (await readFile7(path3, "utf8")).replace(/\r\n/g, "\n").split("\n");
+  if (lines[0] === "---") {
+    const end = lines.indexOf("---", 1);
+    if (end > 0) lines.splice(0, end + 1);
+  }
+  while (lines.length && !lines[0].trim()) lines.shift();
+  if (lines[0]?.startsWith("# ")) lines.shift();
+  let fence = false;
+  const body = lines.map((line) => {
+    if (/^ {0,3}(`{3,}|~{3,})/.test(line)) fence = !fence;
+    return !fence && /^#{1,5} /.test(line) ? "#" + line : line;
+  }).join("\n").trim();
+  return body || void 0;
+}
+async function renderDoc(topic, controls = {}, lang = defaultLanguage2) {
+  const read = controls.readDoc ?? readBundledDoc;
+  const format = (await read(topic, lang)).trimEnd();
+  if (topic !== "wiki") return format + "\n";
+  const own2 = await readWikiPolicy(await findProjectRoot(controls.cwd ?? process.cwd()));
+  const policy = own2 ?? (await read("wiki.default", lang)).trim().replace(/^(#{1,5}) /gm, "#$1 ");
+  const heading = own2 ? t2("docs.wikiPolicyProject", {}, lang) : t2("docs.wikiPolicyDefault", {}, lang);
+  return format + "\n\n## " + heading + "\n\n" + policy + "\n";
+}
 async function runDocs(topic, controls = {}) {
   if (topic === void 0) {
     process.stdout.write(listDocTopics());
@@ -25997,7 +26248,7 @@ async function runDocs(topic, controls = {}) {
     process.exitCode = 1;
     return;
   }
-  process.stdout.write(await (controls.readDoc ?? readBundled)(topic, defaultLanguage2));
+  process.stdout.write(await renderDoc(topic, controls));
 }
 
 // src/commands/agent-block.ts
@@ -26038,6 +26289,16 @@ function isWrapperFile(text2) {
   const lines = own2.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
   return lines.length > 0 && lines.every((line) => /^@(?:\.\/)?[^\s]+$/.test(line) && candidatePaths.includes(line.replace(/^@(?:\.\/)?/, "")));
 }
+var CLAUDE_WRAPPER_PATH = "CLAUDE.md";
+function claudeWrapperFor(agents) {
+  return "@AGENTS.md" + eolOf(agents);
+}
+function isGeneratedClaudeWrapper(text2) {
+  return text2.trim() === "@AGENTS.md";
+}
+function lacksClaudeFile(existing) {
+  return !existing.has("CLAUDE.md") && !existing.has(".claude/CLAUDE.md");
+}
 function resolveAgentPaths(preset, existing) {
   if (preset && preset !== "all") {
     const order = agentPresets[preset];
@@ -26071,7 +26332,7 @@ function removeBlock(text2, boilerplate) {
 }
 
 // src/commands/agent-docs.ts
-var skippedAgentDocs = { mode: "skip", paths: [], writes: [] };
+var skippedAgentDocs = { mode: "skip", paths: [], writes: [], missing: [] };
 async function planAgentDocs(root, options) {
   if (options.skip) return skippedAgentDocs;
   const existing = /* @__PURE__ */ new Map();
@@ -26089,7 +26350,12 @@ async function planAgentDocs(root, options) {
       paths2.push(path3);
       writes.push({ path: path3, previous: text2, next: removeBlock(text2, boilerplateFor(path3)) });
     }
-    return { mode: "remove", paths: paths2, writes };
+    const wrapper = existing.get(CLAUDE_WRAPPER_PATH);
+    if (writes.some((write) => write.path === "AGENTS.md" && write.next === null) && wrapper !== void 0 && isGeneratedClaudeWrapper(wrapper)) {
+      paths2.push(CLAUDE_WRAPPER_PATH);
+      writes.push({ path: CLAUDE_WRAPPER_PATH, previous: wrapper, next: null });
+    }
+    return { mode: "remove", paths: paths2, writes, missing: [] };
   }
   const block = await renderAgentBlock(options.version, options);
   const { inject, create } = options.onlyExisting ? { inject: candidatePaths.filter((path3) => existing.has(path3) && findBlock(existing.get(path3)) && !isWrapperFile(existing.get(path3))), create: null } : resolveAgentPaths(options.agent, existing);
@@ -26103,11 +26369,19 @@ async function planAgentDocs(root, options) {
     paths2.push(create);
     writes.push({ path: create, previous: null, next: injectBlock(null, block, boilerplateFor(create)) });
   }
+  const missing2 = [];
+  if (paths2.includes("AGENTS.md") && lacksClaudeFile(existing)) {
+    if (options.onlyExisting) missing2.push(CLAUDE_WRAPPER_PATH);
+    else {
+      paths2.push(CLAUDE_WRAPPER_PATH);
+      writes.push({ path: CLAUDE_WRAPPER_PATH, previous: null, next: claudeWrapperFor(existing.get("AGENTS.md") ?? null) });
+    }
+  }
   for (const [path3, text2] of existing) {
     if (paths2.includes(path3) || !isWrapperFile(text2) || !findBlock(text2)) continue;
     writes.push({ path: path3, previous: text2, next: removeBlock(text2, boilerplateFor(path3)) });
   }
-  return { mode: "install", paths: paths2, writes };
+  return { mode: "install", paths: paths2, writes, missing: missing2 };
 }
 async function applyAgentDocs(root, plan, recheck) {
   for (const write of plan.writes) await managedWrite(root, write.path, write.previous, write.next, recheck);
@@ -26115,7 +26389,7 @@ async function applyAgentDocs(root, plan, recheck) {
 }
 
 // src/commands/spec-init.ts
-async function initializeSpecProject(cwd, dryRun = false, env = process.env, beforePublish, agentDocs) {
+async function initializeSpecProject(cwd, dryRun = false, env = process.env, beforePublish, agentDocs, readDoc = (name) => readBundledDoc(name, defaultLanguage2)) {
   const repo = initRepository(cwd, env);
   const first = await repo.inspect();
   const root = first.state.repository.rootPath;
@@ -26146,14 +26420,14 @@ async function initializeSpecProject(cwd, dryRun = false, env = process.env, bef
   if (old !== void 0) return existing(old);
   if (first.trackedConfig) throw new InitError("CONFIG_DELETED", t2("init.configDeleted"));
   const checkRecords = async () => {
-    if (await fileInfo(join7(root, "specs"))) throw new InitError("EXISTING_RECORDS", t2("init.existingSpecs"));
-    const entries = await readdir3(join7(root, ".gitifact")).catch((e) => {
+    if (await fileInfo(join9(root, "specs"))) throw new InitError("EXISTING_RECORDS", t2("init.existingSpecs"));
+    const entries = await readdir4(join9(root, ".gitifact")).catch((e) => {
       if (e.code === "ENOENT") return [];
       throw e;
     });
     if (entries.some((name) => !/^\.init-[a-f0-9-]+\.tmp$/.test(name))) throw new InitError("EXISTING_RECORDS", t2("init.orphanStore"));
   };
-  const config2 = { schemaVersion: 1, baseline: first.state.head.commit ? { kind: "commit", objectFormat: first.state.repository.objectFormat, commit: first.state.head.commit } : { kind: "empty" } };
+  const config2 = { schemaVersion: SCHEMA_VERSION, baseline: first.state.head.commit ? { kind: "commit", objectFormat: first.state.repository.objectFormat, commit: first.state.head.commit } : { kind: "empty" } };
   const text2 = JSON.stringify(config2, null, 2) + "\n";
   const recheck = async () => {
     await checkRecords();
@@ -26177,8 +26451,22 @@ async function initializeSpecProject(cwd, dryRun = false, env = process.env, bef
   };
   await published();
   await applyAgentDocs(root, docsPlan, published);
+  await writeWikiPolicy(root, readDoc);
   return result(config2, "created");
 }
+async function writeWikiPolicy(root, readDoc) {
+  if (await fileInfo(join9(root, ...WIKI_DIR.split("/")))) return;
+  const template = await readDoc("wiki.default").catch((e) => {
+    if (e.code === "ENOENT") return void 0;
+    throw e;
+  });
+  if (template === void 0) return;
+  const doc = { id: generatePreviewId("W"), path: WIKI_ENTRY_PATH, title: t2("init.wikiReadmeTitle"), body: template.trim() };
+  const text2 = renderDocument(doc);
+  parseDocument(doc.path, text2);
+  await mkdir4(join9(root, ...WIKI_DIR.split("/")), { recursive: true });
+  await writeFile2(join9(root, ...WIKI_ENTRY_PATH.split("/")), text2, { flag: "wx" });
+}
 
 // src/commands/init.ts
 async function runInit(options, version2) {
@@ -26193,7 +26481,7 @@ async function runInit(options, version2) {
     if (!dto.ok) throw new Error("unreachable");
     const docs = dto.agentDocs.mode === "skip" ? t2("init.text.skipped") : dto.agentDocs.paths.join(", ") + (dto.agentDocs.mode === "remove" ? " (" + t2("init.text.blockRemoved") + ")" : dto.outcome === "planned" ? " (" + t2("init.text.blockPlanned") + ")" : " (" + t2("init.text.blockUpdated") + ")");
     process.stdout.write(options.format === "text" ? `${dto.outcome}: ${dto.rootPath}/.gitifact/config.json
-${t2("init.text.storage")}: schemaVersion 1
+${t2("init.text.storage")}: schemaVersion ${dto.schemaVersion}
 ${t2("init.text.agentDocs")}: ${docs}
 ` : JSON.stringify(dto) + "\n");
   } catch (error62) {
@@ -26204,7 +26492,39 @@ ${t2("init.text.agentDocs")}: ${docs}
   }
 }
 
+// src/adapters/git/agent-docs-commit.ts
+function agentDocsGit(root, inherited = process.env) {
+  const env = { ...inherited, GIT_OPTIONAL_LOCKS: "0", GIT_NO_LAZY_FETCH: "1", GIT_TERMINAL_PROMPT: "0", GIT_LITERAL_PATHSPECS: "1", LC_ALL: "C" };
+  const runner = createGitRunner();
+  const git = (args, acceptedExitCodes = [0]) => runner(
+    ["-c", "core.fsmonitor=false", ...args],
+    { cwd: root, env, timeoutMs: 12e4, maxBytes: 16 * 1024 * 1024, acceptedExitCodes }
+  );
+  return {
+    async head() {
+      return (await git(["rev-parse", "-q", "--verify", "HEAD^{commit}"], [0, 1])).toString("utf8").trim() || null;
+    },
+    // The committed text of a path, or null when HEAD does not track it.
+    async committed(head, path3) {
+      if ((await git(["ls-tree", "-z", head, "--", path3])).length === 0) return null;
+      return (await git(["cat-file", "blob", head + ":" + path3])).toString("utf8");
+    },
+    // `--only` commits the working content of these paths and leaves every other staged entry staged. Hooks and signing stay on.
+    async commitOnly(paths2, message) {
+      await git(["commit", "--only", "-m", message, "--", ...paths2]);
+    },
+    async changedPaths(commit) {
+      return (await git(["diff-tree", "--no-commit-id", "--name-only", "--no-renames", "-r", "-z", "--root", commit])).toString("utf8").split("\0").filter(Boolean).sort();
+    },
+    async parents(commit) {
+      return (await git(["rev-list", "--parents", "-n", "1", commit])).toString("utf8").trim().split(" ").slice(1);
+    }
+  };
+}
+
 // src/commands/update.ts
+var blockCommitMessage = (version2) => "chore(gitifact): refresh GITIFACT block to v" + version2;
+var commitState = (state, extra = {}) => ({ state, commit: null, paths: [], message: null, reason: null, detail: null, ...extra });
 async function refreshBlocks(cwd, version2, env, controls) {
   const repo = initRepository(cwd, env);
   let first;
@@ -26213,37 +26533,79 @@ async function refreshBlocks(cwd, version2, env, controls) {
     first = await repo.inspect();
     config2 = await readConfigFile(first.state.repository.rootPath);
   } catch (error62) {
-    if (error62 instanceof RepositoryReadError && error62.code === "NOT_A_REPOSITORY" || error62 instanceof InitError && error62.code === "MIGRATION_REQUIRED") return { state: "not-initialized", paths: [] };
+    if (error62 instanceof RepositoryReadError && error62.code === "NOT_A_REPOSITORY" || error62 instanceof InitError && error62.code === "MIGRATION_REQUIRED") return { state: "not-initialized", paths: [], missing: [] };
     throw error62;
   }
-  if (config2 === void 0) return { state: "not-initialized", paths: [] };
+  if (config2 === void 0) return { state: "not-initialized", paths: [], missing: [] };
   const root = first.state.repository.rootPath;
   const plan = await planAgentDocs(root, { version: version2, onlyExisting: true, ...controls });
-  if (plan.paths.length === 0) return { state: "no-block", paths: [] };
-  if (plan.writes.length === 0) return { state: "current", paths: plan.paths };
+  const { missing: missing2 } = plan;
+  if (plan.paths.length === 0) return { state: "no-block", paths: [], missing: missing2, root };
+  if (plan.writes.length === 0) return { state: "current", paths: plan.paths, missing: missing2, root, candidates: plan.paths };
   const unchanged = async () => {
     if ((await repo.inspect()).stamp !== first.stamp || await readConfigFile(root) !== config2) throw new InitError("INPUT_CHANGED", t2("init.inputChanged"));
   };
-  return { state: "refreshed", paths: await applyAgentDocs(root, plan, unchanged) };
+  const applied = await applyAgentDocs(root, plan, unchanged);
+  return { state: "refreshed", paths: applied, missing: missing2, root, candidates: plan.paths };
+}
+function outsideBlock(text2) {
+  const normalized2 = text2.replace(/\r\n/g, "\n");
+  try {
+    const found = findBlock(normalized2);
+    return found ? normalized2.slice(0, found.start) + AGENT_START + normalized2.slice(found.end) : null;
+  } catch {
+    return null;
+  }
+}
+async function commitBlocks(docs, version2, env) {
+  if (!docs.root || !docs.candidates?.length) return commitState("nothing");
+  const git = agentDocsGit(docs.root, env);
+  const head = await git.head();
+  const changed = [];
+  for (const path3 of docs.candidates) {
+    const working = await managedRead(docs.root, path3);
+    const committed = head ? await git.committed(head, path3) : null;
+    if (working === null) continue;
+    if (committed === null) return commitState("skipped", { paths: [path3], reason: "untracked" });
+    if (committed.replace(/\r\n/g, "\n") === working.replace(/\r\n/g, "\n")) continue;
+    const before = outsideBlock(committed);
+    if (before === null || before !== outsideBlock(working)) return commitState("skipped", { paths: [path3], reason: "other-changes" });
+    changed.push(path3);
+  }
+  if (changed.length === 0) return commitState("nothing");
+  const message = blockCommitMessage(version2);
+  let failure2;
+  try {
+    await git.commitOnly(changed, message);
+  } catch (error62) {
+    failure2 = error62;
+  }
+  const after = await git.head();
+  if (!after || after === head) return commitState("skipped", { paths: changed, reason: "commit-failed", detail: failure2 instanceof Error ? failure2.message : null });
+  const parents = await git.parents(after);
+  if (parents.length !== 1 || parents[0] !== head) throw new InitError("COMMIT_RESULT_UNKNOWN", t2("update.commitResultUnknown", { commit: after }));
+  return commitState("committed", { commit: after, paths: await git.changedPaths(after), message });
 }
 async function updateCommand(cwd, version2, env = process.env, controls = {}) {
   const [update, agentDocs] = await Promise.all([
     updateCheckDisabled(env) ? disabledUpdate : resolveUpdate(version2, controls.fetchLatest ?? fetchLatestVersion, void 0, controls.timeoutMs),
     refreshBlocks(cwd, version2, env, controls)
   ]);
-  return updateV1.parse({
+  const commit = controls.commit ? await commitBlocks(agentDocs, version2, env) : commitState("not-requested");
+  return updateV3.parse({
     contract: "update",
-    version: 1,
+    version: 3,
     ok: true,
     cliVersion: version2,
     update,
     install: update.status === "available" ? { npmGlobal: npmGlobalInstall(update.latestVersion) } : null,
-    agentDocs
+    agentDocs: { state: agentDocs.state, paths: agentDocs.paths, missing: agentDocs.missing },
+    commit
   });
 }
 async function runUpdate(options, version2) {
   try {
-    const dto = await updateCommand(process.cwd(), version2);
+    const dto = await updateCommand(process.cwd(), version2, process.env, { commit: !!options.commit });
     if (!dto.ok) throw new Error("unreachable");
     if (options.format !== "text") {
       process.stdout.write(JSON.stringify(dto) + "\n");
@@ -26253,22 +26615,31 @@ async function runUpdate(options, version2) {
     lines.push(dto.update.status === "available" ? t2("update.text.available", { version: dto.update.latestVersion }) : dto.update.status === "up-to-date" ? t2("update.text.upToDate") : dto.update.status === "disabled" ? t2("update.text.disabled") : t2("update.text.unavailable"));
     if (dto.install) lines.push(t2("update.text.install", { command: dto.install.npmGlobal }), t2("update.text.afterInstall"));
     lines.push(dto.agentDocs.state === "refreshed" ? t2("update.text.blockRefreshed", { paths: dto.agentDocs.paths.join(", ") }) : dto.agentDocs.state === "current" ? t2("update.text.blockCurrent", { paths: dto.agentDocs.paths.join(", ") }) : dto.agentDocs.state === "no-block" ? t2("update.text.noBlock") : t2("update.text.notInitialized"));
+    if (dto.agentDocs.missing.length) lines.push(t2("update.text.missing", { paths: dto.agentDocs.missing.join(", ") }));
+    const { commit } = dto;
+    if (commit.state === "committed") lines.push(t2("update.text.committed", { commit: commit.commit.slice(0, 12), paths: commit.paths.join(", ") }));
+    else if (commit.state === "nothing") lines.push(t2("update.text.commitNothing"));
+    else if (commit.state === "skipped") {
+      const paths2 = commit.paths.join(", ");
+      const text2 = commit.reason === "untracked" ? t2("update.text.commitSkipped.untracked", { paths: paths2 }) : commit.reason === "other-changes" ? t2("update.text.commitSkipped.other-changes", { paths: paths2 }) : t2("update.text.commitSkipped.commit-failed", { paths: paths2 });
+      lines.push(text2 + (commit.detail ? " (" + commit.detail + ")" : ""));
+    }
     process.stdout.write(lines.join("\n") + "\n");
   } catch (error62) {
     const known = error62 instanceof InitError || error62 instanceof RepositoryReadError;
     const failure2 = { code: known ? error62.code : "UPDATE_FAILED", message: known ? error62.message : t2("update.failed") };
-    process.stderr.write(options.format === "text" ? failure2.code + ": " + failure2.message + "\n" : JSON.stringify(updateV1.parse({ contract: "update", version: 1, ok: false, error: failure2 })) + "\n");
+    process.stderr.write(options.format === "text" ? failure2.code + ": " + failure2.message + "\n" : JSON.stringify(updateV3.parse({ contract: "update", version: 3, ok: false, error: failure2 })) + "\n");
     process.exitCode = 1;
   }
 }
 
 // src/commands/spec-preview.ts
-import { join as join13 } from "node:path";
+import { join as join15 } from "node:path";
 import { readFile as readFile12, stat as stat2 } from "node:fs/promises";
 
 // src/adapters/filesystem/spec-preview-prepare.ts
-import { lstat as lstat4 } from "node:fs/promises";
-import { join as join8 } from "node:path";
+import { lstat as lstat6 } from "node:fs/promises";
+import { join as join10 } from "node:path";
 import { createHash as createHash4 } from "node:crypto";
 var fail5 = (message) => {
   throw new SpecPreviewError(message);
@@ -26281,7 +26652,7 @@ async function readPreviewContext(cwd) {
   const { gitDir } = await reader.location();
   const checkOperation = async () => {
     for (const name of ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply"]) {
-      const exists = await lstat4(join8(gitDir, name)).catch((e) => {
+      const exists = await lstat6(join10(gitDir, name)).catch((e) => {
         if (e.code === "ENOENT") return void 0;
         throw e;
       });
@@ -26335,9 +26706,9 @@ async function verifyPreparedPreview(cwd, input2, staged) {
   if (staged) {
     const index = await c.reader.index();
     if (index.size !== current.files.size) fail5(t2("prepare.stagingScope"));
-    for (const [path3, source] of current.files) {
+    for (const [path3, source2] of current.files) {
       const oid2 = index.get(path3);
-      const bytes = Buffer.from(source);
+      const bytes = Buffer.from(source2);
       const hash3 = createHash4(oid2?.length === 64 ? "sha256" : "sha1").update(`blob ${bytes.length}\0`).update(bytes).digest("hex");
       if (oid2 !== hash3) fail5(t2("prepare.stagingContent", { path: path3 }));
     }
@@ -26350,26 +26721,26 @@ async function verifyPreparedPreview(cwd, input2, staged) {
 
 // src/adapters/filesystem/agent-inputs.ts
 import { createHash as createHash5, randomBytes as randomBytes2 } from "node:crypto";
-import { lstat as lstat5, mkdir as mkdir4, readdir as readdir4, realpath as realpath3, unlink as unlink4, writeFile as writeFile2 } from "node:fs/promises";
+import { lstat as lstat7, mkdir as mkdir5, readdir as readdir5, realpath as realpath3, unlink as unlink4, writeFile as writeFile3 } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { basename, dirname as dirname3, join as join9 } from "node:path";
+import { basename, dirname as dirname4, join as join11 } from "node:path";
 var maxAge = 7 * 24 * 60 * 60 * 1e3;
-var info2 = (path3) => lstat5(path3).catch((e) => {
+var info4 = (path3) => lstat7(path3).catch((e) => {
   if (e.code === "ENOENT") return void 0;
   throw e;
 });
 var comparable = (path3) => process.platform === "win32" ? path3.toLowerCase() : path3;
 async function candidates(root, controls) {
   const key = createHash5("sha256").update(comparable(await realpath3(root))).digest("hex").slice(0, 16);
-  return { system: join9((controls.tmpdir ?? tmpdir)(), "gitifact", key), project: join9(root, ".gitifact", "tmp") };
+  return { system: join11((controls.tmpdir ?? tmpdir)(), "gitifact", key), project: join11(root, ".gitifact", "tmp") };
 }
 async function writable(directory) {
   try {
-    await mkdir4(directory, { recursive: true });
-    const stat3 = await info2(directory);
+    await mkdir5(directory, { recursive: true });
+    const stat3 = await info4(directory);
     if (!stat3?.isDirectory() || stat3.isSymbolicLink()) return false;
-    const probe = join9(directory, ".probe-" + randomBytes2(8).toString("hex"));
-    await writeFile2(probe, "", { flag: "wx" });
+    const probe = join11(directory, ".probe-" + randomBytes2(8).toString("hex"));
+    await writeFile3(probe, "", { flag: "wx" });
     await unlink4(probe);
     return true;
   } catch {
@@ -26382,28 +26753,28 @@ async function prepareAgentInputs(root, controls = {}) {
   if (await writable(system)) directory = system;
   else if (await writable(project)) {
     directory = project;
-    await writeFile2(join9(project, ".gitignore"), "*\n", { flag: "wx" }).catch((e) => {
+    await writeFile3(join11(project, ".gitignore"), "*\n", { flag: "wx" }).catch((e) => {
       if (e.code !== "EEXIST") throw e;
     });
   }
   if (!directory) return void 0;
   const now = (controls.now ?? Date.now)();
-  for (const name of await readdir4(directory).catch(() => [])) {
+  for (const name of await readdir5(directory).catch(() => [])) {
     if (name === ".gitignore") continue;
-    const stat3 = await info2(join9(directory, name)).catch(() => void 0);
-    if (stat3?.isFile() && now - stat3.mtimeMs > maxAge) await unlink4(join9(directory, name)).catch(() => void 0);
+    const stat3 = await info4(join11(directory, name)).catch(() => void 0);
+    if (stat3?.isFile() && now - stat3.mtimeMs > maxAge) await unlink4(join11(directory, name)).catch(() => void 0);
   }
-  return { save: join9(directory, "save.json"), commit: join9(directory, "commit.json") };
+  return { save: join11(directory, "save.json"), commit: join11(directory, "commit.json") };
 }
 async function discardAgentInput(root, file2, controls = {}) {
   try {
-    const stat3 = await info2(file2);
+    const stat3 = await info4(file2);
     if (!stat3?.isFile() || stat3.isSymbolicLink()) return false;
-    const parent = comparable(await realpath3(dirname3(file2)));
+    const parent = comparable(await realpath3(dirname4(file2)));
     const { system, project } = await candidates(root, controls);
     let managed = false;
     for (const directory of [system, project]) {
-      if (await info2(directory) && comparable(await realpath3(directory)) === parent) managed = true;
+      if (await info4(directory) && comparable(await realpath3(directory)) === parent) managed = true;
     }
     if (!managed || basename(file2) === ".gitignore") return false;
     await unlink4(file2);
@@ -26415,13 +26786,13 @@ async function discardAgentInput(root, file2, controls = {}) {
 
 // src/commands/spec-preview-commit.ts
 import { randomUUID as randomUUID6 } from "node:crypto";
-import { readFile as readFile10, mkdir as mkdir5, open as open4, rename as rename3, unlink as unlink5, rmdir as rmdir2, writeFile as writeFile3 } from "node:fs/promises";
-import { join as join11 } from "node:path";
+import { readFile as readFile10, mkdir as mkdir6, open as open4, rename as rename3, unlink as unlink5, rmdir as rmdir2, writeFile as writeFile4 } from "node:fs/promises";
+import { join as join13 } from "node:path";
 
 // src/commands/spec-commit-files.ts
 import { createHash as createHash6 } from "node:crypto";
-import { lstat as lstat6, readFile as readFile9 } from "node:fs/promises";
-import { join as join10 } from "node:path";
+import { lstat as lstat8, readFile as readFile9 } from "node:fs/promises";
+import { join as join12 } from "node:path";
 var fail6 = (message) => {
   throw new SpecPreviewError(message);
 };
@@ -26430,7 +26801,7 @@ var optional2 = (path3) => readFile9(path3).catch((e) => {
   if (e.code === "ENOENT") return null;
   throw e;
 });
-var info3 = (path3) => lstat6(path3).catch((e) => {
+var info5 = (path3) => lstat8(path3).catch((e) => {
   if (e.code === "ENOENT") return void 0;
   throw e;
 });
@@ -26442,11 +26813,11 @@ async function fingerprint(root, path3) {
   validPath2(path3);
   const parts = path3.split("/");
   for (let i = 1; i <= parts.length; i++) {
-    const target = join10(root, ...parts.slice(0, i));
-    const stat3 = await info3(target);
+    const target = join12(root, ...parts.slice(0, i));
+    const stat3 = await info5(target);
     if (!stat3) return null;
     if (stat3.isSymbolicLink() || (i < parts.length ? !stat3.isDirectory() : !stat3.isFile())) fail6(t2("commitFiles.linkOrDirectory"));
-    if (i < parts.length && await info3(join10(target, ".git"))) fail6(t2("commitFiles.nestedRepository"));
+    if (i < parts.length && await info5(join12(target, ".git"))) fail6(t2("commitFiles.nestedRepository"));
     if (i === parts.length) {
       if (stat3.nlink !== 1 || stat3.size > 16 * 1024 * 1024) fail6(t2("commitFiles.hardLinkOrSize"));
       return hash2(Buffer.concat([Buffer.from(String(stat3.mode & 73) + "\0"), await readFile9(target)]));
@@ -26477,9 +26848,9 @@ function policyPaths(files) {
   return [...all].sort();
 }
 async function checkLegacySelection(root, selected) {
-  const legacyJson = /^\.(?:gitifact|tryce)\/(?:spec\/[^/]+\/tryce\.json|notes\/N-[a-f0-9-]+\.json|mode-[a-f0-9-]+\.json|config\.(?:init-1|prototype-1)\.[a-f0-9]+\.json)$/;
+  const legacyJson = /^\.(?:gitifact|tryce)\/(?:spec\/[^/]+\/tryce\.json|notes\/N-[a-f0-9-]+\.json|mode-[a-f0-9-]+\.json|config\.(?:init-1|prototype-1)\.[a-f0-9]+\.json)$|^\.gitifact\/(?:product|guides|overrides)\/.+$/;
   for (const p of selected.filter((p2) => p2.startsWith(".gitifact/") && !record2(p2) && p2 !== ".gitifact/config.json")) {
-    if (isProductAssetPath(p)) continue;
+    if (isAssetPath(p)) continue;
     if (!legacyJson.test(p) || await fingerprint(root, p) !== null) fail6(t2("commitFiles.legacyDeleteOnly", { path: p }));
   }
   for (const p of selected.filter((p2) => p2.startsWith(".tryce/"))) {
@@ -26512,8 +26883,8 @@ async function previewCommit(cwd, action, input2) {
   });
   const indexPath = (await git(["rev-parse", "--path-format=absolute", "--git-path", "index"])).toString("utf8").trim();
   const staged = async (index) => (await git(["diff", "--cached", "--ita-visible-in-index", "--name-only", "--no-renames", "-z"], index)).toString("utf8").split("\0").filter(Boolean).sort();
-  const busy = join11(gitDir, "gitifact-spec-commit.lock");
-  if (await info3(busy)) fail6(t2("commit.busy", { path: busy }));
+  const busy = join13(gitDir, "gitifact-spec-commit.lock");
+  if (await info5(busy)) fail6(t2("commit.busy", { path: busy }));
   if ((await staged()).length) fail6(t2("commit.existingStagingPlan"));
   const request = object3(input2);
   let plan;
@@ -26570,33 +26941,33 @@ async function previewCommit(cwd, action, input2) {
   if (!("plan" in refreshed) || refreshed.plan.digest !== plan.digest) fail6(t2("commit.planStale"));
   const before = await reader.baseline();
   const original = await optional2(indexPath);
-  await mkdir5(busy);
-  const draftLock = join11(gitDir, "gitifact-spec-preview.lock");
+  await mkdir6(busy);
+  const draftLock = join13(gitDir, "gitifact-spec-preview.lock");
   let draftOwned = false;
   let indexLock;
   let uncertain = false;
   let commitStarted = false;
-  const temporary = join11(gitDir, "gitifact-commit-index-" + randomUUID6());
+  const temporary = join13(gitDir, "gitifact-commit-index-" + randomUUID6());
   const checkFiles = async () => {
     for (const f of [...plan.files, ...plan.context]) if (f.hash !== await fingerprint(root, f.path)) fail6(t2("commit.fileChangedPreparing", { path: f.path }));
     if ((await readLockedPreviewState(root)).stamp !== object3(plan.verification).stamp) fail6(t2("commit.specsChangedPreparing"));
-    for (const name of ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply"]) if (await info3(join11(gitDir, name))) fail6(t2("commit.integrationStarted"));
+    for (const name of ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply"]) if (await info5(join13(gitDir, name))) fail6(t2("commit.integrationStarted"));
   };
   try {
     await verifyPreparedPreview(cwd, plan.verification, false);
-    await mkdir5(draftLock);
+    await mkdir6(draftLock);
     draftOwned = true;
     indexLock = await open4(indexPath + ".lock", "wx", 384);
     if (plan.index !== hash2(await optional2(indexPath) ?? Buffer.alloc(0)) || (await staged()).length) fail6(t2("commit.indexChangedLocked"));
-    await writeFile3(join11(busy, "recovery.json"), JSON.stringify({ before, originalIndex: original?.toString("base64") ?? null, temporary, plan }));
-    if (original) await writeFile3(temporary, original, { flag: "wx" });
+    await writeFile4(join13(busy, "recovery.json"), JSON.stringify({ before, originalIndex: original?.toString("base64") ?? null, temporary, plan }));
+    if (original) await writeFile4(temporary, original, { flag: "wx" });
     else await git(["read-tree", "--empty"], temporary);
     await git(["add", "--", ...selected], temporary);
     const actual = await staged(temporary);
     if (!actual.length || actual.some((p) => !selected.includes(p))) fail6(t2("commit.unexpectedFiles"));
     for (const file2 of plan.files.filter((f) => record2(f.path) && f.hash !== null)) {
       const stagedBytes = await git(["show", ":" + file2.path], temporary);
-      if (!stagedBytes.equals(await readFile10(join11(root, file2.path)))) fail6(t2("commit.filterChanged"));
+      if (!stagedBytes.equals(await readFile10(join13(root, file2.path)))) fail6(t2("commit.filterChanged"));
     }
     await checkFiles();
     if (JSON.stringify(before) !== JSON.stringify(await reader.baseline())) fail6(t2("commit.headChanged"));
@@ -26635,7 +27006,7 @@ async function previewCommit(cwd, action, input2) {
       });
       await unlink5(temporary).catch(() => {
       });
-      await unlink5(join11(busy, "recovery.json")).catch(() => {
+      await unlink5(join13(busy, "recovery.json")).catch(() => {
       });
       await rmdir2(busy);
       if (draftOwned) await rmdir2(draftLock);
@@ -26645,8 +27016,8 @@ async function previewCommit(cwd, action, input2) {
 
 // src/commands/spec-commit.ts
 import { createHash as createHash8, randomUUID as randomUUID7 } from "node:crypto";
-import { mkdir as mkdir6, open as open5, readFile as readFile11, rename as rename4, rmdir as rmdir3, unlink as unlink6, writeFile as writeFile4 } from "node:fs/promises";
-import { join as join12 } from "node:path";
+import { mkdir as mkdir7, open as open5, readFile as readFile11, rename as rename4, rmdir as rmdir3, unlink as unlink6, writeFile as writeFile5 } from "node:fs/promises";
+import { join as join14 } from "node:path";
 var fields = ["reasons", "paths", "message", "authorization", "requirements", "policyFiles", "expected"];
 var integration = ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply"];
 var same2 = (a, b) => JSON.stringify(a) === JSON.stringify(b);
@@ -26685,9 +27056,9 @@ async function specCommit(cwd, input2, dryRun) {
     ...stdin ? { input: stdin } : {}
   });
   const staged = async (index) => (await git(["diff", "--cached", "--ita-visible-in-index", "--name-only", "--no-renames", "-z"], index)).toString("utf8").split("\0").filter(Boolean).sort();
-  const busy = join12(gitDir, "gitifact-spec-commit.lock");
+  const busy = join14(gitDir, "gitifact-spec-commit.lock");
   await failOnLegacyLock(gitDir);
-  if (await info3(busy)) fail6(t2("commit.busy", { path: busy }));
+  if (await info5(busy)) fail6(t2("commit.busy", { path: busy }));
   if ((await staged()).length) fail6(t2("commit.existingStaging"));
   const indexHash = hash2(await optional2(indexPath) ?? Buffer.alloc(0));
   const current = c.working;
@@ -26737,16 +27108,16 @@ async function specCommit(cwd, input2, dryRun) {
   const trailers = [
     ...requirements.map((id) => "Gitifact-Req: " + id),
     ...prepared.changes.filter((c2) => c2.kind === "design").map((c2) => "Gitifact-Design: " + c2.id),
-    ...prepared.changes.filter((c2) => c2.kind === "product" || c2.kind === "guide").map((c2) => "Gitifact-Doc: " + c2.id)
+    ...prepared.changes.filter((c2) => c2.kind === "wiki").map((c2) => "Gitifact-Doc: " + c2.id)
   ];
-  const temporary = join12(gitDir, "gitifact-commit-index-" + randomUUID7());
+  const temporary = join14(gitDir, "gitifact-commit-index-" + randomUUID7());
   let owned = false;
   let uncertain = false;
   let indexLock;
   let committed;
   try {
     try {
-      await mkdir6(busy);
+      await mkdir7(busy);
       owned = true;
     } catch (e) {
       if (e.code === "EEXIST") fail6(t2("commit.busy", { path: busy }));
@@ -26760,8 +27131,8 @@ async function specCommit(cwd, input2, dryRun) {
         if (hash2(original ?? Buffer.alloc(0)) !== indexHash || (await staged()).length) fail6(t2("commit.indexChanged"));
         const locked = await hashes([.../* @__PURE__ */ new Set([...selected, ...contextPaths])]);
         for (const [path3, value] of started) if (locked.get(path3) !== value) fail6(t2("commit.fileChangedRunning", { path: path3 }));
-        await writeFile4(join12(busy, "recovery.json"), JSON.stringify({ before: c.base, originalIndex: original?.toString("base64") ?? null, temporary, paths: selected, message, requirements }));
-        if (original) await writeFile4(temporary, original, { flag: "wx" });
+        await writeFile5(join14(busy, "recovery.json"), JSON.stringify({ before: c.base, originalIndex: original?.toString("base64") ?? null, temporary, paths: selected, message, requirements }));
+        if (original) await writeFile5(temporary, original, { flag: "wx" });
         else await git(["read-tree", "--empty"], temporary);
         await git(["add", "--", ...stageable], temporary);
         const actual = await staged(temporary);
@@ -26776,7 +27147,7 @@ async function specCommit(cwd, input2, dryRun) {
             const size = Number(header[2]);
             if (end < 0 || header[1] !== "blob" || !Number.isSafeInteger(size) || output2[end + 1 + size] !== 10) fail6(t2("commit.stagedUnreadable", { path: path3 }));
             const staged2 = output2.subarray(end + 1, end + 1 + size);
-            const file2 = await readFile11(join12(root, path3));
+            const file2 = await readFile11(join14(root, path3));
             if (!staged2.equals(file2) && !staged2.equals(Buffer.from(file2.toString("latin1").replace(/\r\n/g, "\n"), "latin1"))) fail6(t2("commit.filterChanged"));
             offset = end + size + 2;
           }
@@ -26784,7 +27155,7 @@ async function specCommit(cwd, input2, dryRun) {
         const again = await hashes([...locked.keys()]);
         for (const [path3, value] of locked) if (again.get(path3) !== value) fail6(t2("commit.fileChangedPreparing", { path: path3 }));
         if ((await readLockedPreviewState(root)).stamp !== published.stamp) fail6(t2("commit.specsChangedPreparing"));
-        for (const name of integration) if (await info3(join12(gitDir, name))) fail6(t2("commit.integrationStarted"));
+        for (const name of integration) if (await info5(join14(gitDir, name))) fail6(t2("commit.integrationStarted"));
         if (!same2(c.base, await c.reader.baseline())) fail6(t2("commit.headChanged"));
         const tree = (await git(["write-tree"], temporary)).toString("utf8").trim();
         commitStarted = true;
@@ -26826,7 +27197,7 @@ async function specCommit(cwd, input2, dryRun) {
       await unlink6(temporary).catch(() => {
       });
       if (owned) {
-        await unlink6(join12(busy, "recovery.json")).catch(() => {
+        await unlink6(join14(busy, "recovery.json")).catch(() => {
         });
         await rmdir3(busy);
       }
@@ -26843,7 +27214,7 @@ async function execute(action, options, controls) {
   try {
     const guard = specPreviewReader(process.cwd());
     const { root, gitDir, objectFormat } = await guard.location();
-    for (const marker2 of operations) if (await fileInfo(join13(gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker2 }));
+    for (const marker2 of operations) if (await fileInfo(join15(gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker2 }));
     if (await guard.hasUnmerged()) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.resolveConflicts"));
     const raw = await readConfigFile(root);
     if (raw === void 0) throw new SpecPreviewError(t2("preview.notInitialized"));
@@ -26875,7 +27246,7 @@ async function execute(action, options, controls) {
     if (action === "read") {
       const commit = await reader.resolve(options.ref ?? "HEAD");
       const bundle = await reader.readBundle(commit);
-      process.stdout.write(JSON.stringify({ ...envelope, ok: true, commit, specs: bundle.specs, documents: bundle.documents }) + "\n");
+      process.stdout.write(JSON.stringify({ ...envelope, ok: true, commit, specs: bundle.specs, wiki: bundle.wiki }) + "\n");
     } else {
       const [from, to] = await Promise.all([reader.resolve(options.from), reader.resolve(options.to)]);
       const [before, after] = await Promise.all([reader.readBundle(from), reader.readBundle(to)]);
@@ -26888,8 +27259,8 @@ async function execute(action, options, controls) {
   }
 }
 async function readInputFile(path3) {
-  const source = await stat2(path3);
-  if (!source.isFile() || source.size > 1024 * 1024) throw new SpecPreviewError(t2("preview.inputFile"));
+  const source2 = await stat2(path3);
+  if (!source2.isFile() || source2.size > 1024 * 1024) throw new SpecPreviewError(t2("preview.inputFile"));
   return readFile12(path3);
 }
 async function readStdin(stream) {
@@ -26904,29 +27275,29 @@ async function readStdin(stream) {
 }
 function narrowWorking(working, options, inputs) {
   if (options.stamp) return { stamp: working.stamp, inputs };
-  let { specs, documents, warnings } = working;
+  let { specs, wiki, warnings } = working;
   if (options.feature !== void 0) {
     specs = specs.filter((s) => s.path === ".gitifact/spec/" + options.feature + "/requirements.md");
     if (!specs.length) throw new SpecPreviewError(t2("preview.unknownFeature", { feature: options.feature }));
-    documents = [];
-    warnings = warnings.filter((w) => w.specId === specs[0].id);
+    wiki = { documents: [], history: [] };
+    warnings = warnings.filter((w) => w.code === "MISSING_DESIGN_REFERENCE" && w.specId === specs[0].id);
   }
-  if (!options.ids) return { stamp: working.stamp, inputs, specs, documents, warnings };
+  if (!options.ids) return { stamp: working.stamp, inputs, specs, wiki, warnings };
   return {
     stamp: working.stamp,
     inputs,
     warnings,
     specs: specs.map((s) => ({ id: s.id, path: s.path, title: s.title, design: s.design?.title ?? null, requirements: s.requirements.map((r) => ({ id: r.id, title: r.title })) })),
-    documents: documents.map((set2) => ({ kind: set2.kind, documents: set2.documents.map((d) => ({ id: d.id, path: d.path, title: d.title })) }))
+    wiki: { documents: wiki.documents.map((d) => ({ id: d.id, path: d.path, title: d.title })) }
   };
 }
 
 // src/commands/migrate.ts
-import { lstat as lstat8, readdir as readdir5, readFile as readFile13, rename as rename5, writeFile as writeFile5, unlink as unlink7 } from "node:fs/promises";
-import { join as join14 } from "node:path";
+import { lstat as lstat10, readdir as readdir6, readFile as readFile13, rename as rename5, writeFile as writeFile6, unlink as unlink7 } from "node:fs/promises";
+import { join as join16 } from "node:path";
 import { randomBytes as randomBytes3 } from "node:crypto";
 var operations2 = ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply", "sequencer", "BISECT_START", "index.lock"];
-var info4 = (path3) => lstat8(path3).catch((e) => {
+var info6 = (path3) => lstat10(path3).catch((e) => {
   if (e.code === "ENOENT") return void 0;
   throw e;
 });
@@ -26937,40 +27308,40 @@ var fail7 = (code, message) => {
 async function migrateStore(cwd, dryRun = false) {
   const reader = specPreviewReader(cwd);
   const { root, gitDir } = await reader.location();
-  for (const marker3 of operations2) if (await info4(join14(gitDir, marker3))) fail7("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker3 }));
+  for (const marker3 of operations2) if (await info6(join16(gitDir, marker3))) fail7("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker3 }));
   if (await reader.hasUnmerged()) fail7("GIT_OPERATION_IN_PROGRESS", t2("git.resolveConflicts"));
-  for (const name of [...LEGACY_LOCKS, "gitifact-spec-preview.lock", "gitifact-spec-commit.lock"]) if (await info4(join14(gitDir, name))) fail7("LOCKED", t2("migrate.locked", { path: join14(gitDir, name) }));
-  const from = join14(root, ".tryce");
-  const to = join14(root, ".gitifact");
-  const fromInfo = await info4(from);
-  if (await info4(to)) fail7("ALREADY_MIGRATED", t2("migrate.alreadyMigrated"));
+  for (const name of [...LEGACY_LOCKS, "gitifact-spec-preview.lock", "gitifact-spec-commit.lock"]) if (await info6(join16(gitDir, name))) fail7("LOCKED", t2("migrate.locked", { path: join16(gitDir, name) }));
+  const from = join16(root, ".tryce");
+  const to = join16(root, ".gitifact");
+  const fromInfo = await info6(from);
+  if (await info6(to)) fail7("ALREADY_MIGRATED", t2("migrate.alreadyMigrated"));
   if (!fromInfo) return fail7("NOTHING_TO_MIGRATE", t2("migrate.nothingToMigrate"));
   if (!fromInfo.isDirectory() || fromInfo.isSymbolicLink()) fail7("PATH_CONFLICT", t2("migrate.notDirectory"));
-  const configInfo = await info4(join14(from, "config.json"));
+  const configInfo = await info6(join16(from, "config.json"));
   if (!configInfo?.isFile() || configInfo.isSymbolicLink()) fail7("NOT_INITIALIZED", t2("migrate.noConfig"));
-  const config2 = parseManagedConfig(decode4(await readFile13(join14(from, "config.json"))));
+  const config2 = parseManagedConfig(decode4(await readFile13(join16(from, "config.json"))));
   if (!("schemaVersion" in config2)) fail7("UNSUPPORTED_FORMAT", t2("migrate.legacyJson"));
-  const top = (await readdir5(from)).sort();
+  const top = (await readdir6(from)).sort();
   if (top.some((name) => name !== "config.json" && name !== "spec")) fail7("UNSUPPORTED_FORMAT", t2("migrate.extraEntries"));
   const files = /* @__PURE__ */ new Map();
   const rewrites = [];
   const legacyRecords = [];
   const marker2 = /^<!-- tryce-(spec|req|design|ref): /;
   if (top.includes("spec")) {
-    for (const feature2 of (await readdir5(join14(from, "spec"))).sort()) {
-      const dir = join14(from, "spec", feature2);
-      const stat3 = await info4(dir);
+    for (const feature2 of (await readdir6(join16(from, "spec"))).sort()) {
+      const dir = join16(from, "spec", feature2);
+      const stat3 = await info6(dir);
       if (!stat3?.isDirectory() || stat3.isSymbolicLink()) fail7("UNSUPPORTED_FORMAT", t2("migrate.notSpecFolder", { feature: feature2 }));
-      for (const name of (await readdir5(dir)).sort()) {
+      for (const name of (await readdir6(dir)).sort()) {
         if (!["requirements.md", "design.md", "history.jsonl", "tryce.json"].includes(name)) fail7("UNSUPPORTED_FORMAT", t2("migrate.unsupportedFile", { feature: feature2, name }));
-        const fileStat = await info4(join14(dir, name));
+        const fileStat = await info6(join16(dir, name));
         if (!fileStat?.isFile() || fileStat.isSymbolicLink() || fileStat.nlink !== 1 || fileStat.size > 1024 * 1024) fail7("UNSUPPORTED_FORMAT", t2("migrate.fileTooLarge", { name }));
         const newPath = `.gitifact/spec/${feature2}/${name}`;
         if (name === "tryce.json") {
           legacyRecords.push(newPath);
           continue;
         }
-        const text2 = decode4(await readFile13(join14(dir, name)));
+        const text2 = decode4(await readFile13(join16(dir, name)));
         if (name === "history.jsonl") {
           files.set(newPath, text2);
           continue;
@@ -27015,9 +27386,9 @@ async function migrateStore(cwd, dryRun = false) {
   if (dryRun) return result("planned");
   await rename5(from, to);
   for (const r of rewrites) {
-    const full = join14(root, r.path);
-    const temp = join14(root, ".gitifact", "spec", ".gitifact-migrate-" + randomBytes3(8).toString("hex"));
-    await writeFile5(temp, r.content, { flag: "wx" });
+    const full = join16(root, r.path);
+    const temp = join16(root, ".gitifact", "spec", ".gitifact-migrate-" + randomBytes3(8).toString("hex"));
+    await writeFile6(temp, r.content, { flag: "wx" });
     try {
       await rename5(temp, full);
     } finally {
@@ -27039,16 +27410,16 @@ async function runMigrate(options) {
 }
 
 // src/main.ts
-var program2 = new Command().name("gitifact").description(t2("help.program")).version("0.4.3").allowExcessArguments(false).addHelpText("after", "\n" + t2("help.notYet")).action(() => program2.outputHelp());
+var program2 = new Command().name("gitifact").description(t2("help.program")).version("0.5.0").allowExcessArguments(false).addHelpText("after", "\n" + t2("help.notYet")).action(() => program2.outputHelp());
 program2.command("status").description(t2("help.status")).allowExcessArguments(false).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).action(async (options) => {
   await runStatus(options.format);
 });
-program2.command("browser").description(t2("help.browser")).allowExcessArguments(false).option("--port <port>", t2("help.browserPort"), parsePort, 0).option("--dev", t2("help.browserDev")).option("--no-update-check", t2("help.browserNoUpdateCheck")).action((options) => runBrowser(options, "0.4.3"));
-program2.command("init").description(t2("help.init")).allowExcessArguments(false).option("--dry-run", t2("help.initDryRun")).addOption(new Option("--agent <agent>", t2("help.initAgent")).choices([...agentPresetNames])).addOption(new Option("--remove-agents", t2("help.initRemoveAgents")).conflicts("skipAgents")).option("--skip-agents", t2("help.initSkipAgents")).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).action((options) => runInit(options, "0.4.3"));
+program2.command("browser").description(t2("help.browser")).allowExcessArguments(false).option("--port <port>", t2("help.browserPort"), parsePort, 0).option("--dev", t2("help.browserDev")).option("--no-update-check", t2("help.browserNoUpdateCheck")).action((options) => runBrowser(options, "0.5.0"));
+program2.command("init").description(t2("help.init")).allowExcessArguments(false).option("--dry-run", t2("help.initDryRun")).addOption(new Option("--agent <agent>", t2("help.initAgent")).choices([...agentPresetNames])).addOption(new Option("--remove-agents", t2("help.initRemoveAgents")).conflicts("skipAgents")).option("--skip-agents", t2("help.initSkipAgents")).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).action((options) => runInit(options, "0.5.0"));
 program2.command("docs").description(t2("help.docs")).argument("[topic]", t2("help.docsTopic")).allowExcessArguments(false).action(async (topic) => {
   await runDocs(topic);
 });
-program2.command("update").description(t2("help.update")).allowExcessArguments(false).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).action((options) => runUpdate(options, "0.4.3"));
+program2.command("update").description(t2("help.update")).allowExcessArguments(false).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).option("--commit", t2("help.updateCommit")).action((options) => runUpdate(options, "0.5.0"));
 program2.command("migrate").description(t2("help.migrate")).allowExcessArguments(false).option("--dry-run", t2("help.migrateDryRun")).action(runMigrate);
 var spec = program2.command("spec").description(t2("help.spec"));
 var replaced = t2("help.deprecated");