@frankzhang2026/opencode-android-orchestrator 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.10.0 - 2026-09-11
+
+- Add automation configuration schema v5 with
+  `commitMessagePrefixMode`, defaulting to `required`.
+- Create and preserve the human-maintained
+  `automation/automation-commit-prefix` sidecar during init and upgrade without
+  adding it to the managed installation manifest.
+- Block new orchestrated tasks until the required prefix file contains exactly
+  one valid non-comment line, while keeping init, upgrade, doctor, and shadow
+  verification usable with the initial comments-only template.
+- Prefix both accepted task commits and abort recovery commits automatically,
+  read the latest value from the source worktree, and show the resulting message
+  in the human acceptance card without prompting on each commit.
+- Exclude the prefix sidecar from task scope, evidence, cleanliness, automated
+  staging, and plugin-created commits, including isolated-worktree execution.
+
 ## 0.9.0 - 2026-09-09
 
 - Make Gradle's evaluated project model authoritative for Android module

package/README.md

@@ -20,7 +20,9 @@ package, and removes the runtime GitHub/Superpowers plugin dependency. Version
 project-specific `AGENTS.md` content outside the managed marker block. Version
 `0.9.0` discovers Android modules from Gradle's evaluated runtime model, so
 dynamic settings logic and company convention plugins no longer leave modules
-or their focused-test tasks out of generated configuration.
+or their focused-test tasks out of generated configuration. Version `0.10.0`
+adds a user-maintained commit-message prefix that is read automatically for
+each task commit and blocks task startup until the required value is filled.
 
 ## Documentation
 
@@ -55,8 +57,9 @@ project builds retain their configured cache behavior.
 ## Quick start
 
 ```sh
-npx @frankzhang2026/opencode-android-orchestrator@0.9.0 init .
-npx @frankzhang2026/opencode-android-orchestrator@0.9.0 doctor .
+npx @frankzhang2026/opencode-android-orchestrator@0.10.0 init .
+$EDITOR automation/automation-commit-prefix
+npx @frankzhang2026/opencode-android-orchestrator@0.10.0 doctor .
 opencode --agent scheduled-planner .
 ```
 
@@ -66,7 +69,7 @@ a task contract without selecting a primary module. To intentionally restrict
 generated contracts to one module, opt into primary-module scope:
 
 ```sh
-npx @frankzhang2026/opencode-android-orchestrator@0.9.0 init . \
+npx @frankzhang2026/opencode-android-orchestrator@0.10.0 init . \
   --module-scope primary \
   --primary-module :mobile
 ```
@@ -94,14 +97,14 @@ For an existing manifest-managed installation whose generated module/task
 lists are incomplete, refresh all derived Gradle data in one upgrade:
 
 ```sh
-npx @frankzhang2026/opencode-android-orchestrator@0.9.0 upgrade . \
+npx @frankzhang2026/opencode-android-orchestrator@0.10.0 upgrade . \
   --refresh-gradle-discovery
 ```
 
 The refresh updates `androidProject.modules`, production/test paths, protected
 build files, and all five Gradle task groups together. Without the flag,
 upgrade preserves an intentionally customized task matrix. The explicit
-refresh is also allowed on an already installed `0.9.0` when the evaluated
+refresh is also allowed on an already installed `0.10.0` when the evaluated
 Gradle model has changed; an unchanged refresh remains byte-idempotent.
 
 ### Bundled workflow skills
@@ -146,13 +149,47 @@ unchanged. Android lint is disabled by default; setting `lintEnabled` to `true`
 runs the discovered `lintTasks` in those gates. Assemble, scope, evidence, and
 required device-test checks are unaffected by either flag.
 
-These two booleans are the operator-editable exceptions in the otherwise
-managed configuration. Change their values in place and commit the file before
+These two booleans and `commitMessagePrefixMode` are the operator-editable
+exceptions in the otherwise managed configuration. Change their values in
+place and commit the file before
 starting orchestration. Doctor accepts these policy changes and a later
 upgrade preserves them. Do not reformat or edit unrelated generated fields.
 Legacy installations without the fields receive `true` for unit tests and
 `false` for lint during upgrade.
 
+### Automatic commit-message prefix
+
+Automation configuration schema V5 adds this repository policy:
+
+```json
+{
+  "commitMessagePrefixMode": "required"
+}
+```
+
+`required` is the default. During `init` or `upgrade`, the plugin creates
+`automation/automation-commit-prefix` only when it does not already exist. The
+initial file contains comments but no value, so installation or upgrade still
+succeeds while new task startup remains blocked. Edit it once and put the
+current company text on exactly one non-comment line, for example:
+
+```text
+本周研发批次
+```
+
+The plugin reads that file automatically; it never asks for the value on each
+commit. A successful task commit becomes, for example,
+`本周研发批次 Implement Add profile validation (TASK-123)`, and an abort
+recovery commit receives the same current prefix. Change the one line whenever
+the company text changes; the next plugin-created commit uses the new value.
+
+The prefix file is human-owned, excluded from the 47 managed-file hashes and
+from task diffs, evidence, automated staging, and plugin-created commits, and
+preserved by upgrade and uninstall. Set `commitMessagePrefixMode` to `disabled`
+only when repository policy explicitly does not require a prefix. This setting
+governs commits made by the orchestrator; use a repository Git hook if manually
+created commits must also be enforced.
+
 ### Managed long-command timeout
 
 The plugin raises direct managed lifecycle commands such as `claim-task.sh`,
@@ -220,7 +257,10 @@ The install transaction manages 47 project-local paths:
 | Android automation config and task example | 2 | Generate from detected modules. |
 | `AGENTS.md` and OpenCode JSON/JSONC | 2 | Merge bounded content without replacing unrelated settings. |
 
-After installation, start the `scheduled-planner` and use its interactive flow.
+After installation or upgrade, fill the required commit-prefix file before
+starting `scheduled-planner`; preflight rejects a missing, comments-only,
+multi-value, oversized, or symbolic-link prefix file. Then use the planner's
+interactive flow.
 The `/acceptance <TASK-ID>`, `/resume-task <TASK-ID>`,
 `/resume-review <TASK-ID>`, and `/abort-task <TASK-ID>` commands are
 recovery/re-entry points; they do not replace the required fresh approval
@@ -240,6 +280,8 @@ Cache setting, `0.6.1` adds configurable long-command timeouts plus bounded
 baseline-interruption recovery, and `0.7.0` makes unit-test and lint gates
 repository-configurable. Version `0.8.0` moves the five required workflow
 skills into the npm package and removes their external plugin dependency.
+Version `0.9.0` makes Gradle's evaluated module model authoritative, and
+`0.10.0` adds the required user-maintained commit prefix and task-start gate.
 
 The cross-version plugin entry, OpenCode version doctor, Android/Gradle project
 discovery, audited V4 OpenCode/configuration resources, and all deterministic
@@ -304,7 +346,7 @@ Implemented checks include:
   Shell executable modes, merges OpenCode JSON/JSONC and one bounded AGENTS
   block, bootstraps the optional human-owned worktree allowlist when missing,
   and is byte-idempotent for an unchanged installed version
-- write-before-complete verification using the 44-case automation suite and a
+- write-before-complete verification using the 46-case automation suite and a
   read-only shadow run; any failure restores original files before reporting
   the error
 - an installation-aware, read-only doctor that authenticates the 47-file
@@ -382,7 +424,8 @@ preparation alone as resource installation;
 ## Init
 
 ```sh
-npx @frankzhang2026/opencode-android-orchestrator@0.9.0 init .
+npx @frankzhang2026/opencode-android-orchestrator@0.10.0 init .
+$EDITOR automation/automation-commit-prefix
 opencode --agent scheduled-planner .
 ```
 
@@ -503,7 +546,7 @@ the immediately preceding `question` result and bind at least the approval
 kind, task ID, session, message, relevant sealed SHA/branch, timestamp, and
 nonce. It must also retain fixed-script authentication, strict state
 preconditions, project/worktree bounds, abort propagation that terminates child
-processes, bounded structured output, exact per-agent permissions, the 44-case
+processes, bounded structured output, exact per-agent permissions, the 46-case
 transaction suite, and real `1.14.22`/`1.15.13` integration tests. Internal
 Coder/Reviewer transition scripts remain private orchestration details rather
 than public tools.

package/dist/config/commit-message-prefix.d.ts

@@ -0,0 +1,31 @@
+export declare const COMMIT_MESSAGE_PREFIX_RELATIVE_PATH = "automation/automation-commit-prefix";
+export declare const INITIAL_COMMIT_MESSAGE_PREFIX_CONTENT: string;
+export declare const COMMIT_MESSAGE_PREFIX_FILE_MAX_BYTES = 4096;
+export declare const COMMIT_MESSAGE_PREFIX_MAX_BYTES = 256;
+export type CommitMessagePrefixMode = "required" | "disabled";
+export declare const DEFAULT_COMMIT_MESSAGE_PREFIX_MODE: CommitMessagePrefixMode;
+export declare function isCommitMessagePrefixMode(value: unknown): value is CommitMessagePrefixMode;
+export type CommitMessagePrefixInspectionStatus = "disabled" | "missing" | "unconfigured" | "configured" | "invalid";
+export interface CommitMessagePrefixInspection {
+    path: string;
+    mode: CommitMessagePrefixMode;
+    status: CommitMessagePrefixInspectionStatus;
+    prefix: string | null;
+    details: readonly string[];
+}
+export type CommitMessagePrefixInitializationStatus = "disabled" | "created-unconfigured" | "existing-unconfigured" | "existing-configured";
+export interface CommitMessagePrefixInitialization {
+    path: string;
+    mode: CommitMessagePrefixMode;
+    status: CommitMessagePrefixInitializationStatus;
+}
+export type CommitMessagePrefixErrorCode = "COMMIT_MESSAGE_PREFIX_INVALID" | "COMMIT_MESSAGE_PREFIX_ROLLBACK_FAILED" | "COMMIT_MESSAGE_PREFIX_WRITE_FAILED";
+export declare class CommitMessagePrefixError extends Error {
+    readonly code: CommitMessagePrefixErrorCode;
+    readonly details: readonly string[];
+    constructor(code: CommitMessagePrefixErrorCode, message: string, details?: readonly string[]);
+}
+export declare function inspectCommitMessagePrefix(targetDirectory: string, mode: CommitMessagePrefixMode): CommitMessagePrefixInspection;
+export declare function initializeCommitMessagePrefix(targetDirectory: string, mode: CommitMessagePrefixMode): CommitMessagePrefixInitialization;
+export declare function rollbackCommitMessagePrefixInitialization(initialization: CommitMessagePrefixInitialization): void;
+//# sourceMappingURL=commit-message-prefix.d.ts.map

package/dist/config/commit-message-prefix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-message-prefix.d.ts","sourceRoot":"","sources":["../../src/config/commit-message-prefix.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,mCAAmC,wCACT,CAAC;AACxC,eAAO,MAAM,qCAAqC,QAItC,CAAC;AACb,eAAO,MAAM,oCAAoC,OAAQ,CAAC;AAC1D,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAEnD,MAAM,MAAM,uBAAuB,GAAG,UAAU,GAAG,UAAU,CAAC;AAE9D,eAAO,MAAM,kCAAkC,EAAE,uBACrC,CAAC;AAEb,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,uBAAuB,CAElC;AAED,MAAM,MAAM,mCAAmC,GAC3C,UAAU,GACV,SAAS,GACT,cAAc,GACd,YAAY,GACZ,SAAS,CAAC;AAEd,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,uBAAuB,CAAC;IAC9B,MAAM,EAAE,mCAAmC,CAAC;IAC5C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,MAAM,uCAAuC,GAC/C,UAAU,GACV,sBAAsB,GACtB,uBAAuB,GACvB,qBAAqB,CAAC;AAE1B,MAAM,WAAW,iCAAiC;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,uBAAuB,CAAC;IAC9B,MAAM,EAAE,uCAAuC,CAAC;CACjD;AAED,MAAM,MAAM,4BAA4B,GACpC,+BAA+B,GAC/B,uCAAuC,GACvC,oCAAoC,CAAC;AAEzC,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;gBAGlC,IAAI,EAAE,4BAA4B,EAClC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,SAAS,MAAM,EAAO;CAOlC;AA4BD,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE,uBAAuB,GAC5B,6BAA6B,CAqF/B;AAcD,wBAAgB,6BAA6B,CAC3C,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE,uBAAuB,GAC5B,iCAAiC,CAoCnC;AAED,wBAAgB,yCAAyC,CACvD,cAAc,EAAE,iCAAiC,GAChD,IAAI,CA8BN"}

package/dist/config/commit-message-prefix.js

@@ -0,0 +1,155 @@
+import { lstatSync, readFileSync, unlinkSync, writeFileSync, } from "node:fs";
+import { join } from "node:path";
+import { TextDecoder } from "node:util";
+export const COMMIT_MESSAGE_PREFIX_RELATIVE_PATH = "automation/automation-commit-prefix";
+export const INITIAL_COMMIT_MESSAGE_PREFIX_CONTENT = [
+    "# 必填：请在下一行填写当前 Git 提交文案前缀",
+    "# 示例：XXX",
+    "",
+].join("\n");
+export const COMMIT_MESSAGE_PREFIX_FILE_MAX_BYTES = 4_096;
+export const COMMIT_MESSAGE_PREFIX_MAX_BYTES = 256;
+export const DEFAULT_COMMIT_MESSAGE_PREFIX_MODE = "required";
+export function isCommitMessagePrefixMode(value) {
+    return value === "required" || value === "disabled";
+}
+export class CommitMessagePrefixError extends Error {
+    code;
+    details;
+    constructor(code, message, details = []) {
+        super(message);
+        this.name = "CommitMessagePrefixError";
+        this.code = code;
+        this.details = details;
+    }
+}
+function filesystemErrorCode(error) {
+    if (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        typeof error.code === "string") {
+        return error.code;
+    }
+    return null;
+}
+function invalidInspection(path, mode, detail) {
+    return {
+        path,
+        mode,
+        status: "invalid",
+        prefix: null,
+        details: [detail],
+    };
+}
+export function inspectCommitMessagePrefix(targetDirectory, mode) {
+    const path = join(targetDirectory, ...COMMIT_MESSAGE_PREFIX_RELATIVE_PATH.split("/"));
+    if (mode === "disabled") {
+        return { path, mode, status: "disabled", prefix: null, details: [] };
+    }
+    let stats;
+    try {
+        stats = lstatSync(path);
+    }
+    catch (error) {
+        if (filesystemErrorCode(error) === "ENOENT") {
+            return { path, mode, status: "missing", prefix: null, details: [] };
+        }
+        return invalidInspection(path, mode, error instanceof Error ? error.message : String(error));
+    }
+    if (stats.isSymbolicLink() || !stats.isFile()) {
+        return invalidInspection(path, mode, "The commit-message prefix must be a regular file, not a symlink or directory.");
+    }
+    if (stats.size > COMMIT_MESSAGE_PREFIX_FILE_MAX_BYTES) {
+        return invalidInspection(path, mode, `The commit-message prefix file exceeds ${String(COMMIT_MESSAGE_PREFIX_FILE_MAX_BYTES)} bytes.`);
+    }
+    let content;
+    try {
+        content = new TextDecoder("utf-8", { fatal: true }).decode(readFileSync(path));
+    }
+    catch (error) {
+        return invalidInspection(path, mode, `The commit-message prefix file is unreadable or is not valid UTF-8: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const activeLines = content
+        .split(/\r?\n/)
+        .filter((line) => line.trim().length > 0 && !line.trimStart().startsWith("#"));
+    if (activeLines.length === 0) {
+        return { path, mode, status: "unconfigured", prefix: null, details: [] };
+    }
+    if (activeLines.length !== 1) {
+        return invalidInspection(path, mode, "The commit-message prefix file must contain exactly one non-comment line.");
+    }
+    const prefix = activeLines[0];
+    if (prefix !== prefix.trim()) {
+        return invalidInspection(path, mode, "The commit-message prefix must not have leading or trailing whitespace.");
+    }
+    if (/[\u0000-\u001f\u007f]/u.test(prefix)) {
+        return invalidInspection(path, mode, "The commit-message prefix must not contain control characters.");
+    }
+    if (Buffer.byteLength(prefix, "utf8") > COMMIT_MESSAGE_PREFIX_MAX_BYTES) {
+        return invalidInspection(path, mode, `The commit-message prefix exceeds ${String(COMMIT_MESSAGE_PREFIX_MAX_BYTES)} UTF-8 bytes.`);
+    }
+    return { path, mode, status: "configured", prefix, details: [] };
+}
+function assertUsableInspection(inspection) {
+    if (inspection.status === "invalid") {
+        throw new CommitMessagePrefixError("COMMIT_MESSAGE_PREFIX_INVALID", "The commit-message prefix file is invalid.", [inspection.path, ...inspection.details]);
+    }
+}
+export function initializeCommitMessagePrefix(targetDirectory, mode) {
+    const initial = inspectCommitMessagePrefix(targetDirectory, mode);
+    assertUsableInspection(initial);
+    if (initial.status === "disabled") {
+        return { path: initial.path, mode, status: "disabled" };
+    }
+    if (initial.status === "configured") {
+        return { path: initial.path, mode, status: "existing-configured" };
+    }
+    if (initial.status === "unconfigured") {
+        return { path: initial.path, mode, status: "existing-unconfigured" };
+    }
+    try {
+        writeFileSync(initial.path, INITIAL_COMMIT_MESSAGE_PREFIX_CONTENT, {
+            flag: "wx",
+            mode: 0o644,
+        });
+        return { path: initial.path, mode, status: "created-unconfigured" };
+    }
+    catch (error) {
+        if (filesystemErrorCode(error) === "EEXIST") {
+            const concurrent = inspectCommitMessagePrefix(targetDirectory, mode);
+            assertUsableInspection(concurrent);
+            if (concurrent.status === "configured") {
+                return { path: concurrent.path, mode, status: "existing-configured" };
+            }
+            if (concurrent.status === "unconfigured") {
+                return { path: concurrent.path, mode, status: "existing-unconfigured" };
+            }
+        }
+        throw new CommitMessagePrefixError("COMMIT_MESSAGE_PREFIX_WRITE_FAILED", `Unable to create the commit-message prefix file: ${initial.path}`, [error instanceof Error ? error.message : String(error)]);
+    }
+}
+export function rollbackCommitMessagePrefixInitialization(initialization) {
+    if (initialization.status !== "created-unconfigured") {
+        return;
+    }
+    try {
+        const stats = lstatSync(initialization.path);
+        const content = readFileSync(initialization.path, "utf8");
+        if (stats.isSymbolicLink() ||
+            !stats.isFile() ||
+            content !== INITIAL_COMMIT_MESSAGE_PREFIX_CONTENT) {
+            throw new Error("The automatically created prefix file changed and was preserved.");
+        }
+        unlinkSync(initialization.path);
+    }
+    catch (error) {
+        if (filesystemErrorCode(error) === "ENOENT") {
+            return;
+        }
+        throw new CommitMessagePrefixError("COMMIT_MESSAGE_PREFIX_ROLLBACK_FAILED", "The automatically created commit-message prefix file could not be rolled back safely.", [
+            error instanceof Error ? error.message : String(error),
+            `Preserved path: ${initialization.path}`,
+        ]);
+    }
+}
+//# sourceMappingURL=commit-message-prefix.js.map

package/dist/config/commit-message-prefix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-message-prefix.js","sourceRoot":"","sources":["../../src/config/commit-message-prefix.ts"],"names":[],"mappings":"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"}

package/dist/config/verification-policy.d.ts

@@ -1,7 +1,9 @@
+import { type CommitMessagePrefixMode } from "./commit-message-prefix.js";
 export declare const AUTOMATION_CONFIG_RELATIVE_PATH = "automation/config.json";
 export declare const DEFAULT_LINT_ENABLED = false;
 export declare const DEFAULT_UNIT_TESTS_ENABLED = true;
 export interface VerificationPolicy {
+    commitMessagePrefixMode: CommitMessagePrefixMode;
     lintEnabled: boolean;
     unitTestsEnabled: boolean;
 }
@@ -11,9 +13,9 @@ interface ContentFingerprint {
 }
 /**
  * Accept an otherwise byte-identical generated configuration when an operator
- * changed only the two supported verification-policy booleans. Enumerating the
- * previous boolean states lets upgrades authenticate the remaining managed
- * content against the installed manifest without storing another file copy.
+ * changed only supported operator policy fields. Enumerating prior states lets
+ * upgrades authenticate the remaining managed content against the installed
+ * manifest without storing another file copy.
  */
 export declare function matchesManifestModuloVerificationPolicy(content: Uint8Array, expected: ContentFingerprint): boolean;
 export {};

package/dist/config/verification-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verification-policy.d.ts","sourceRoot":"","sources":["../../src/config/verification-policy.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,+BAA+B,2BAA2B,CAAC;AACxE,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAC1C,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,UAAU,kBAAkB;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAsBD;;;;;GAKG;AACH,wBAAgB,uCAAuC,CACrD,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAwCT"}
+{"version":3,"file":"verification-policy.d.ts","sourceRoot":"","sources":["../../src/config/verification-policy.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,4BAA4B,CAAC;AAEpC,eAAO,MAAM,+BAA+B,2BAA2B,CAAC;AACxE,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAC1C,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC,uBAAuB,EAAE,uBAAuB,CAAC;IACjD,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,UAAU,kBAAkB;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAiCD;;;;;GAKG;AACH,wBAAgB,uCAAuC,CACrD,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAkDT"}

package/dist/config/verification-policy.js

@@ -1,4 +1,5 @@
 import { createHash } from "node:crypto";
+import { DEFAULT_COMMIT_MESSAGE_PREFIX_MODE, isCommitMessagePrefixMode, } from "./commit-message-prefix.js";
 export const AUTOMATION_CONFIG_RELATIVE_PATH = "automation/config.json";
 export const DEFAULT_LINT_ENABLED = false;
 export const DEFAULT_UNIT_TESTS_ENABLED = true;
@@ -16,11 +17,19 @@ function setOptionalBoolean(value, key, configured) {
         value[key] = configured;
     }
 }
+function setOptionalCommitMessagePrefixMode(value, configured) {
+    if (configured === undefined) {
+        delete value.commitMessagePrefixMode;
+    }
+    else {
+        value.commitMessagePrefixMode = configured;
+    }
+}
 /**
  * Accept an otherwise byte-identical generated configuration when an operator
- * changed only the two supported verification-policy booleans. Enumerating the
- * previous boolean states lets upgrades authenticate the remaining managed
- * content against the installed manifest without storing another file copy.
+ * changed only supported operator policy fields. Enumerating prior states lets
+ * upgrades authenticate the remaining managed content against the installed
+ * manifest without storing another file copy.
  */
 export function matchesManifestModuloVerificationPolicy(content, expected) {
     if (content.byteLength === expected.size &&
@@ -38,19 +47,29 @@ export function matchesManifestModuloVerificationPolicy(content, expected) {
         return false;
     }
     if (typeof parsed.lintEnabled !== "boolean" ||
-        typeof parsed.unitTestsEnabled !== "boolean") {
+        typeof parsed.unitTestsEnabled !== "boolean" ||
+        (parsed.commitMessagePrefixMode !== undefined &&
+            !isCommitMessagePrefixMode(parsed.commitMessagePrefixMode))) {
         return false;
     }
     const states = [undefined, false, true];
-    for (const unitTestsEnabled of states) {
-        for (const lintEnabled of states) {
-            const candidate = { ...parsed };
-            setOptionalBoolean(candidate, "unitTestsEnabled", unitTestsEnabled);
-            setOptionalBoolean(candidate, "lintEnabled", lintEnabled);
-            const rendered = Buffer.from(`${JSON.stringify(candidate, null, 2)}\n`);
-            if (rendered.byteLength === expected.size &&
-                sha256(rendered) === expected.sha256) {
-                return true;
+    const prefixModes = [
+        undefined,
+        DEFAULT_COMMIT_MESSAGE_PREFIX_MODE,
+        "disabled",
+    ];
+    for (const commitMessagePrefixMode of prefixModes) {
+        for (const unitTestsEnabled of states) {
+            for (const lintEnabled of states) {
+                const candidate = { ...parsed };
+                setOptionalCommitMessagePrefixMode(candidate, commitMessagePrefixMode);
+                setOptionalBoolean(candidate, "unitTestsEnabled", unitTestsEnabled);
+                setOptionalBoolean(candidate, "lintEnabled", lintEnabled);
+                const rendered = Buffer.from(`${JSON.stringify(candidate, null, 2)}\n`);
+                if (rendered.byteLength === expected.size &&
+                    sha256(rendered) === expected.sha256) {
+                    return true;
+                }
             }
         }
     }

package/dist/config/verification-policy.js.map

@@ -1 +1 @@
-{"version":3,"file":"verification-policy.js","sourceRoot":"","sources":["../../src/config/verification-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,MAAM,+BAA+B,GAAG,wBAAwB,CAAC;AACxE,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAC1C,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAY/C,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,MAAM,CAAC,OAAmB;IACjC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,kBAAkB,CACzB,KAA8B,EAC9B,GAA6B,EAC7B,UAA+B;IAE/B,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;IAC1B,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uCAAuC,CACrD,OAAmB,EACnB,QAA4B;IAE5B,IACE,OAAO,CAAC,UAAU,KAAK,QAAQ,CAAC,IAAI;QACpC,MAAM,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,MAAM,EACnC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAY,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IACE,OAAO,MAAM,CAAC,WAAW,KAAK,SAAS;QACvC,OAAO,MAAM,CAAC,gBAAgB,KAAK,SAAS,EAC5C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAqC,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1E,KAAK,MAAM,gBAAgB,IAAI,MAAM,EAAE,CAAC;QACtC,KAAK,MAAM,WAAW,IAAI,MAAM,EAAE,CAAC;YACjC,MAAM,SAAS,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;YAChC,kBAAkB,CAAC,SAAS,EAAE,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;YACpE,kBAAkB,CAAC,SAAS,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;YAC1D,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YACxE,IACE,QAAQ,CAAC,UAAU,KAAK,QAAQ,CAAC,IAAI;gBACrC,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,MAAM,EACpC,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"verification-policy.js","sourceRoot":"","sources":["../../src/config/verification-policy.ts"],"names":[],"mappings":"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"}

package/dist/doctor/installation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installation.d.ts","sourceRoot":"","sources":["../../src/doctor/installation.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,eAAO,MAAM,2BAA2B,KAAK,CAAC;AA+mB9C,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,MAAM,GACtB,SAAS,WAAW,EAAE,CA4DxB"}
+{"version":3,"file":"installation.d.ts","sourceRoot":"","sources":["../../src/doctor/installation.ts"],"names":[],"mappings":"AA0CA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAusB9C,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,MAAM,GACtB,SAAS,WAAW,EAAE,CA6DxB"}

package/dist/doctor/installation.js

@@ -3,6 +3,7 @@ import { lstatSync, readFileSync, } from "node:fs";
 import { join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { DEFAULT_LONG_COMMAND_TIMEOUT_MS } from "../config/long-command-timeout.js";
+import { COMMIT_MESSAGE_PREFIX_RELATIVE_PATH, DEFAULT_COMMIT_MESSAGE_PREFIX_MODE, inspectCommitMessagePrefix, isCommitMessagePrefixMode, } from "../config/commit-message-prefix.js";
 import { AUTOMATION_CONFIG_RELATIVE_PATH, DEFAULT_LINT_ENABLED, DEFAULT_UNIT_TESTS_ENABLED, matchesManifestModuloVerificationPolicy, } from "../config/verification-policy.js";
 import { isModuleScope, planAdaptiveProjectTemplates, } from "../installer/adaptive-templates.js";
 import { planAgentsConfigMerge } from "../installer/agents-config.js";
@@ -257,6 +258,7 @@ function blockedInstallationChecks(reason) {
         blockedCheck("managed-permissions", "Managed permissions", reason),
         blockedCheck("installation-backups", "Installation backups", reason),
         blockedCheck("managed-configuration", "Managed configuration", reason),
+        blockedCheck("commit-message-prefix", "Commit-message prefix", reason),
     ];
 }
 function managedResourceCheck(manifest, inspections) {
@@ -445,6 +447,17 @@ function managedConfigurationCheck(targetDirectory, manifest, inspections) {
                 unitTestsEnabled,
             };
         }
+        const commitMessagePrefixMode = automationConfig.commitMessagePrefixMode ??
+            DEFAULT_COMMIT_MESSAGE_PREFIX_MODE;
+        if (!isCommitMessagePrefixMode(commitMessagePrefixMode)) {
+            throw new Error("commitMessagePrefixMode must be either required or disabled");
+        }
+        if (automationConfig.commitMessagePrefixMode === undefined) {
+            comparableAutomationConfig = {
+                ...comparableAutomationConfig,
+                commitMessagePrefixMode,
+            };
+        }
         const longCommandTimeoutMs = automationConfig.longCommandTimeoutMs ?? DEFAULT_LONG_COMMAND_TIMEOUT_MS;
         if (typeof longCommandTimeoutMs !== "number") {
             throw new Error("longCommandTimeoutMs must be a number");
@@ -461,6 +474,7 @@ function managedConfigurationCheck(targetDirectory, manifest, inspections) {
             gradleVerification: automationConfig.gradleVerification,
             lintEnabled,
             unitTestsEnabled,
+            commitMessagePrefixMode,
             longCommandTimeoutMs,
         });
         if (!jsonMatches(comparableAutomationConfig, expected.automationConfig)) {
@@ -471,6 +485,7 @@ function managedConfigurationCheck(targetDirectory, manifest, inspections) {
             details.push(`Automation default module: ${primaryModule}`);
             details.push(`Unit-test verification: ${unitTestsEnabled ? "enabled" : "disabled"}`);
             details.push(`Android lint verification: ${lintEnabled ? "enabled" : "disabled"}`);
+            details.push(`Commit-message prefix mode: ${commitMessagePrefixMode}`);
         }
         const taskExample = JSON.parse(inspectedText("automation/tasks/TASK-TEMPLATE.json.example", inspections));
         if (!jsonMatches(taskExample, expected.taskContractExample)) {
@@ -490,6 +505,68 @@ function managedConfigurationCheck(targetDirectory, manifest, inspections) {
         details: failures.length === 0 ? details : failures,
     };
 }
+function commitMessagePrefixCheck(targetDirectory, inspections) {
+    let mode;
+    try {
+        const automationConfig = JSON.parse(inspectedText(AUTOMATION_CONFIG_RELATIVE_PATH, inspections));
+        if (!isRecord(automationConfig)) {
+            throw new Error("automation config must be a JSON object");
+        }
+        const configuredMode = automationConfig.commitMessagePrefixMode ??
+            DEFAULT_COMMIT_MESSAGE_PREFIX_MODE;
+        if (!isCommitMessagePrefixMode(configuredMode)) {
+            throw new Error("commitMessagePrefixMode must be either required or disabled");
+        }
+        mode = configuredMode;
+    }
+    catch (error) {
+        return {
+            id: "commit-message-prefix",
+            label: "Commit-message prefix",
+            status: "fail",
+            summary: "Commit-message prefix policy could not be inspected.",
+            details: errorDetails(error),
+        };
+    }
+    const inspection = inspectCommitMessagePrefix(targetDirectory, mode);
+    if (inspection.status === "disabled") {
+        return {
+            id: "commit-message-prefix",
+            label: "Commit-message prefix",
+            status: "pass",
+            summary: "Commit-message prefixing is disabled by automation configuration.",
+            details: [],
+        };
+    }
+    if (inspection.status === "configured") {
+        return {
+            id: "commit-message-prefix",
+            label: "Commit-message prefix",
+            status: "pass",
+            summary: "The required user-maintained commit-message prefix is configured.",
+            details: [inspection.path],
+        };
+    }
+    if (inspection.status === "missing" || inspection.status === "unconfigured") {
+        return {
+            id: "commit-message-prefix",
+            label: "Commit-message prefix",
+            status: "warn",
+            summary: "New automation tasks are blocked until the commit-message prefix is filled.",
+            details: [
+                inspection.path,
+                `Put exactly one non-comment prefix line in ${COMMIT_MESSAGE_PREFIX_RELATIVE_PATH}.`,
+            ],
+        };
+    }
+    return {
+        id: "commit-message-prefix",
+        label: "Commit-message prefix",
+        status: "fail",
+        summary: "The required commit-message prefix file is invalid.",
+        details: [inspection.path, ...inspection.details],
+    };
+}
 export function installationDoctorChecks(targetDirectory) {
     let manifest;
     try {
@@ -537,6 +614,7 @@ export function installationDoctorChecks(targetDirectory) {
         managedPermissionCheck(manifest, inspections),
         installationBackupCheck(targetDirectory, manifest),
         managedConfigurationCheck(targetDirectory, manifest, inspections),
+        commitMessagePrefixCheck(targetDirectory, inspections),
     ];
 }
 //# sourceMappingURL=installation.js.map