gitifact 0.4.3 → 0.4.4

package/dist/i18n/ko/block.md

@@ -1,11 +1,19 @@
+## Gitifact Guide
+
 gitifact v{version} · {language} · 저장 규약 schemaVersion 1
+
 CLI: 모든 명령은 `gitifact <cmd>`로 실행한다. 프로젝트 지침이 다른 실행 방법을 지정하면 그것을 따른다.
 
-시작할 때:
+### 시작할 때
+
+- `gitifact` 명령이 없으면 이 프로젝트에 참여하는 데 필요한 CLI가 설치되지 않은 것이다. 사용자에게 알리고 동의를 받아 `npm install -g gitifact@{version}`으로 설치한 뒤 진행한다. 설치하지 못하면 명세 저장·커밋을 추측으로 대신하지 않는다.
 - `gitifact spec working`으로 제품 설명·지침·기능 명세를 읽고 git status와 기존 staging을 확인한다.
 - 이 블록은 요약이다. 상세 형식은 `gitifact docs <topic>`으로 읽고 기억으로 채우지 않는다.
 
-무엇을 요구사항으로 남기는가 (제품 동작과 유지할 제약만):
+### 무엇을 요구사항으로 남기는가
+
+제품 동작과 유지할 제약만 남긴다.
+
 | 요청 | 처리 |
 | --- | --- |
 | 게시물을 삭제할 수 있게 해주세요 | 요구사항으로 정리한다 |
@@ -13,7 +21,8 @@ CLI: 모든 명령은 `gitifact <cmd>`로 실행한다. 프로젝트 지침이
 | 지금 푸시해주세요 | 작업 지시다. 등록하지 않는다 |
 | 외부 서비스 없이 동작해야 합니다 | 제품 제약으로 명세에 반영한다 |
 
-규칙:
+### 규칙
+
 - 명세를 저장하기 전에 `gitifact docs spec`을 읽는다. ID는 CLI가 발급한 값만 쓴다.
 - 새 기능은 requirements.md와 design.md를 함께 정리한다(`gitifact docs design`). 요구사항만 요청받으면 따른다.
 - 커밋 요청을 받으면 `gitifact docs commit`을 읽고 명세·이유·코드·테스트를 함께 커밋한다.
@@ -23,11 +32,14 @@ CLI: 모든 명령은 `gitifact <cmd>`로 실행한다. 프로젝트 지침이
 - save·commit 입력 JSON은 `spec working`이 알려 준 inputs 경로에 쓴다. 성공하면 CLI가 지운다. 조회 결과와 docs 출력은 파일로 저장하지 않고 필요할 때 다시 실행한다.
 - 사용자가 요구사항·프로젝트 현황·변경 이력을 보여 달라고 하면 `gitifact browser`를 백그라운드로 실행하고 출력된 URL을 알려 준다. 채팅 요약으로 대신하지 않는다.
 
-MORE CLI:
-  docs <topic>     {topics}
-  spec working     현재 명세·제품·지침 전체, stamp, 입력 파일 경로 (--stamp, --feature <이름>, --ids)
-  spec save        --file <json|->: 요구사항·설계·문서 저장
-  spec commit      --file <json|->: 변경 이유 기록과 커밋을 한 번에
-  browser          읽기 전용 브라우저 서버 실행, URL 출력 후 계속 실행
-  update           새 버전 확인과 설치 안내, 이 블록을 현재 버전으로 갱신
-  init             처음 도입할 때 설정과 이 블록을 만든다
+### 명령
+
+- `docs <topic>`: {topics}
+- `spec working`: 현재 명세·제품·지침 전체, stamp, 입력 파일 경로 (`--stamp`, `--feature <이름>`, `--ids`)
+- `spec save --file <json|->`: 요구사항·설계·문서 저장
+- `spec commit --file <json|->`: 변경 이유 기록과 커밋을 한 번에
+- `browser`: 읽기 전용 브라우저 서버 실행, URL 출력 후 계속 실행
+- `update [--commit]`: 새 버전 확인과 설치 안내, 이 블록을 현재 버전으로 갱신. `--commit`은 블록만 바뀐 파일을 고정 메시지로 커밋한다
+- `init`: 처음 도입할 때 설정과 이 블록을 만든다
+
+---

package/dist/i18n/ko/changelog.md

@@ -1,3 +1,12 @@
+## 0.4.4 - 2026-09-17
+### Added
+- `update --commit`이 블록 안만 바뀐 지침 파일을 `chore(gitifact): refresh GITIFACT block to v<버전>` 메시지로 그 파일만 커밋합니다. 다른 staging은 그대로 남고 훅·서명도 평소대로 실행됩니다. 블록 밖에도 수정이 있거나, 추적하지 않는 파일이거나, Git이 커밋을 거부하면 커밋하지 않고 이유를 알립니다.
+- GITIFACT 블록이 `gitifact` 명령이 없는 환경을 안내합니다. 에이전트는 사용자에게 알리고 동의를 받아 블록에 적힌 버전으로 설치합니다.
+### Changed
+- GITIFACT 블록을 `## Gitifact Guide` 제목, 절 제목, 목록으로 정리하고 끝에 구분선을 넣었습니다. Markdown으로 볼 때 명령 목록이 한 줄로 합쳐지지 않습니다. `update` 또는 `init`을 다시 실행하면 갱신됩니다.
+- 브라우저의 업데이트 안내 문장이 설치 후 `gitifact update --commit`을 실행하도록 안내합니다.
+- `update` 출력 계약이 version 2가 되었습니다. 커밋 결과를 담는 `commit` 필드가 추가됐습니다.
+
 ## 0.4.3 - 2026-09-17
 ### Fixed
 - 브라우저의 새 버전 안내 창에서 제목과 닫기 버튼이 창 가장자리에 붙어 잘려 보이던 문제를 고쳤습니다.

package/dist/i18n/ko/docs/workflow.md

@@ -4,7 +4,7 @@
 
 ## 시작과 형식 확인
 
-현재 경로·브랜치·Git 상태와 기존 staging을 확인하고 적용되는 AGENTS.md·CLAUDE.md를 원문으로 읽는다. 지침에서 지정한 CLI를 사용한다. 아래 `gitifact`는 그 실행 방법을 뜻한다. CLI가 없다면 설치·전역 설정 변경을 임의로 하지 않고 가능한 조사부터 진행한다.
+현재 경로·브랜치·Git 상태와 기존 staging을 확인하고 적용되는 AGENTS.md·CLAUDE.md를 원문으로 읽는다. 지침에서 지정한 CLI를 사용한다. 아래 `gitifact`는 그 실행 방법을 뜻한다. CLI가 없다면 이 프로젝트에 참여하는 데 필요한 도구가 빠진 것이다. 설치·전역 설정 변경을 임의로 하지 않고, 사용자에게 알린 뒤 동의를 받아 블록 첫머리에 적힌 버전으로 설치한다(`npm install -g gitifact@<버전>`). 설치 전에는 가능한 조사부터 진행하고 명세 저장·커밋을 추측으로 대신하지 않는다.
 
 설정과 실제 파일, CLI 도움말을 함께 확인해 다음 중 하나의 흐름을 선택한다. 명령이 존재한다는 사실만으로 프로젝트 사용이나 전환이 허용되지는 않는다.
 
@@ -12,7 +12,7 @@
 - **기존 형식:** workflow-1·prototype-1·init-1 설정은 현재 CLI가 조회·기록하지 않는다. 기존 기록을 삭제하거나 새 형식으로 가장하지 않고, 기존 기록을 읽으려면 0.4.0 이하 CLI가 필요하다고 알린다.
 - **미도입:** 도입이 허용됐으면 Git 상태와 지침을 확인하고 `init --dry-run`, `init`으로 연결한다. Git 저장소가 없으면 Git 생성 권한을 확인한다. 기존 변경과 staging을 보존한다.
 
-init은 `.gitifact/config.json`과 도입 기준선을 만들고, AGENTS.md 등 에이전트 지침 파일에 `<!-- GITIFACT:START -->`와 `<!-- GITIFACT:END -->` 사이의 블록을 쓴다. 마커 바깥의 내용은 건드리지 않는다. 요구사항·커밋은 만들지 않는다. 블록은 규칙의 요약이며, 상세 형식은 `gitifact docs <topic>`으로 읽는다. CLI를 업데이트한 뒤 `update`(또는 `init`)를 실행하면 블록이 갱신된다. `update`는 새 버전 여부와 설치 방법도 알려 주며 설치를 직접 실행하지는 않는다.
+init은 `.gitifact/config.json`과 도입 기준선을 만들고, AGENTS.md 등 에이전트 지침 파일에 `<!-- GITIFACT:START -->`와 `<!-- GITIFACT:END -->` 사이의 블록을 쓴다. 마커 바깥의 내용은 건드리지 않는다. 요구사항·커밋은 만들지 않는다. 블록은 규칙의 요약이며, 상세 형식은 `gitifact docs <topic>`으로 읽는다. CLI를 업데이트한 뒤 `update`(또는 `init`)를 실행하면 블록이 갱신된다. `update`는 새 버전 여부와 설치 방법도 알려 주며 설치를 직접 실행하지는 않는다. 사용자가 업데이트를 요청하면 `update --commit`을 쓴다. 블록 안만 바뀐 지침 파일을 `chore(gitifact): refresh GITIFACT block to v<버전>` 메시지로 그 파일만 커밋하고, 다른 staging은 그대로 둔다. 블록 밖에도 수정이 있거나 추적하지 않는 파일이거나 Git이 커밋을 거부하면 커밋하지 않고 `commit.reason`으로 알린다. 이때 에이전트가 메시지를 바꿔 대신 커밋하지 않고 사용자에게 알린다.
 
 구형 기록의 자동 마이그레이션은 아직 없다. 명시적인 전환 작업은 필요한 요구사항을 검증한 뒤 합의한 보존·제거 범위로 처리한다. init을 재실행하거나 설정을 임의 변경해 전환을 우회하지 않는다.
 

package/dist/main.js

@@ -24563,11 +24563,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-v2.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 updateV2 = external_exports.discriminatedUnion("ok", [
   external_exports.strictObject({
     contract: external_exports.literal("update"),
-    version: external_exports.literal(1),
+    version: external_exports.literal(2),
     ok: external_exports.literal(true),
     cliVersion: external_exports.string().min(1),
     update: updateStateV1,
@@ -24575,9 +24584,10 @@ 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()) })
+    agentDocs: external_exports.strictObject({ state: external_exports.enum(["refreshed", "current", "not-initialized", "no-block"]), paths: 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(2), ok: external_exports.literal(false), error: external_exports.strictObject({ code: external_exports.string(), message: external_exports.string() }) })
 ]);
 
 // src/shared/i18n/ko/messages.json
@@ -24814,6 +24824,7 @@ var messages_default2 = {
   "docs.summary.product": "PRODUCT.md\uC640 guides \uBB38\uC11C\uC758 \uC5ED\uD560\uACFC \uC800\uC7A5 \uBA85\uB839",
   "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,11 +24835,17 @@ 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.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."
 };
 
@@ -26204,7 +26221,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;
@@ -26219,31 +26268,72 @@ async function refreshBlocks(cwd, version2, env, controls) {
   if (config2 === void 0) return { state: "not-initialized", paths: [] };
   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 };
+  if (plan.paths.length === 0) return { state: "no-block", paths: [], root };
+  if (plan.writes.length === 0) return { state: "current", paths: plan.paths, 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, 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 updateV2.parse({
     contract: "update",
-    version: 1,
+    version: 2,
     ok: true,
     cliVersion: version2,
     update,
     install: update.status === "available" ? { npmGlobal: npmGlobalInstall(update.latestVersion) } : null,
-    agentDocs
+    agentDocs: { state: agentDocs.state, paths: agentDocs.paths },
+    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,11 +26343,19 @@ 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"));
+    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(updateV2.parse({ contract: "update", version: 2, ok: false, error: failure2 })) + "\n");
     process.exitCode = 1;
   }
 }
@@ -27039,16 +27137,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.4.4").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.4.4"));
+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.4"));
 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.4.4"));
 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");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitifact",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "Git-backed requirements and change history for coding agents.",
   "license": "MIT",
   "repository": {
@@ -36,8 +36,8 @@
   "devDependencies": {
     "commander": "15.0.0",
     "esbuild": "0.28.2",
-    "@gitifact/contracts": "0.0.0",
-    "@gitifact/core": "0.0.0"
+    "@gitifact/core": "0.0.0",
+    "@gitifact/contracts": "0.0.0"
   },
   "scripts": {
     "build": "node scripts/build.mjs",