@chinhae/atw-cli 0.5.0 → 0.7.0

package/dist/templates/pi/extensions/atw/index.ts.txt

@@ -4,6 +4,7 @@ import {
   openSync,
   readFileSync,
   readSync,
+  readdirSync,
   realpathSync,
   renameSync,
   statSync,
@@ -1180,6 +1181,55 @@ function inheritSessionPointer(
 // ── Workflow State Breadcrumb ─────────────────────────────────────────
 const WF_RE =
   /\[workflow-state:([A-Za-z0-9_-]+)\]\s*\n([\s\S]*?)\n\s*\[\/workflow-state:\1\]/g;
+// Mirrors select_platform_blocks() in .atw/scripts/common/workflow_phase.py:
+// keep only the `[Platform, ...]` blocks naming this platform, or every block
+// when none does; marker lines are always dropped.
+const PLATFORM_MARKER_RE = /^\[(\/?)([A-Za-z][^[\]]*)\]\s*$/;
+function selectPlatformBlocks(body: string, platform: string): string {
+  const norm = (s: string) => s.toLowerCase().replace(/[-_ ]/g, "");
+  const names = (m: RegExpMatchArray) => (m[2] ?? "").split(",").map((n) => norm(n.trim()));
+  const lines = body.split("\n");
+  const anyMatch = lines.some((l) => {
+    const m = l.match(PLATFORM_MARKER_RE);
+    return !!m && m[1] !== "/" && names(m).includes(norm(platform));
+  });
+  const out: string[] = [];
+  let keep = true;
+  for (const line of lines) {
+    const m = line.match(PLATFORM_MARKER_RE);
+    if (m) {
+      keep = m[1] === "/" || !anyMatch || names(m).includes(norm(platform));
+      continue;
+    }
+    if (keep) out.push(line);
+  }
+  return out.join("\n");
+}
+// Mirrors DECISION_LOG_REMINDER / has_decision_log() in the shared per-turn
+// Python hook: same sentence, implement or accept only.
+const DECISION_LOG_REMINDER =
+  "This task has a decision log: keep recording it at key points with `python3 ./.atw/scripts/decision_log.py`; in this conversation, the start row (`decision_log.py start`) goes in just before the first row you log — `add` and the other writing commands write it first when it is missing, so a conversation with nothing to log writes none; read the last rows they print, and when another conversation wrote in between they write only the start row and stop: read it, then run the same command again.";
+// Mirrors DECISION_LOG_ARCHIVE_REMINDER in the shared per-turn Python hook:
+// same sentence, accept only (with a log), placed before DECISION_LOG_REMINDER.
+const DECISION_LOG_ARCHIVE_REMINDER =
+  "This task has a decision log: once accepted, after the acceptance row and before `task.py archive`, log one row for the archive (`decision_log.py add`); it goes into the archive commit with the task.";
+// Mirrors DECISION_LOG_REPORT_REMINDER in the shared per-turn Python hook:
+// same sentence, implement or accept (with a log), just before DECISION_LOG_REMINDER.
+const DECISION_LOG_REPORT_REMINDER =
+  "This task has a decision log: when the user asks how things stand or for a report (汇报一下, 现在什么情况, what's the status, report), rebuild it from the task directory in four blocks — `python3 ./.atw/scripts/decision_log.py pending --report` prints the draft; post it in plain words, keep the plain-words lines it carries with noob mode on, and fill in what it marks. This is the task's report, not `atw-what-happened`: that skill only the user starts, and it tells what changed in this chat since their last message.";
+// Mirrors DECISION_LOG_NO_TASK_REPORT_REMINDER / any_task_has_decision_log() in
+// the shared per-turn Python hook: same sentence, no current task only.
+const DECISION_LOG_NO_TASK_REPORT_REMINDER =
+  "No task is current, but some task under `.atw/tasks/` has a decision log: when the user asks how things stand or for a report (汇报一下, 现在什么情况, what's the status, report), rebuild it from that task's directory in four blocks — list the active tasks with `python3 ./.atw/scripts/task.py list` and see which of their directories hold a `decision-log.md` (if the user named the task or said enough to tell which one, take that one; if not, only one, take it; several, ask the user which), then `python3 ./.atw/scripts/decision_log.py pending --report --task-dir <dir>` prints the draft; post it in plain words, keep the plain-words lines it carries with noob mode on, and fill in what it marks. This is the task's report, not `atw-what-happened`: that skill only the user starts, and it tells what changed in this chat since their last message.";
+// 只看 .atw/tasks/ 下一层，归档里的不算
+function anyTaskHasDecisionLog(root: string): boolean {
+  const tasks = join(root, ".atw", "tasks");
+  try {
+    return readdirSync(tasks).some((name) => exists(join(tasks, name, "decision-log.md")));
+  } catch {
+    return false;
+  }
+}
 function workflowBreadcrumb(root: string, key: string | null): string {
   const wf = readText(join(root, ".atw", "workflow.md"));
   if (!wf) return "";
@@ -1191,7 +1241,9 @@ function workflowBreadcrumb(root: string, key: string | null): string {
   }
   const dir = readTaskDir(root, key);
   let header = "Status: no_task",
-    lookup = "no_task";
+    lookup = "no_task",
+    decisionLog = false,
+    accept = false;
   if (dir) {
     try {
       const d = JSON.parse(readText(join(dir, "task.json"))) as JsonObject;
@@ -1200,11 +1252,23 @@ function workflowBreadcrumb(root: string, key: string | null): string {
       if (status) {
         header = `Task: ${id} (${status})`;
         lookup = status;
+        decisionLog =
+          (status === "implement" || status === "accept") &&
+          exists(join(dir, "decision-log.md"));
+        accept = status === "accept";
       }
     } catch {}
   }
-  const body = templates[lookup] ?? "Refer to workflow.md for current step.";
-  return `<workflow-state>\n${header}\n${body}\n</workflow-state>`;
+  const body = selectPlatformBlocks(
+    templates[lookup] ?? "Refer to workflow.md for current step.",
+    "Pi",
+  );
+  const tail = decisionLog
+    ? `${accept ? `\n${DECISION_LOG_ARCHIVE_REMINDER}` : ""}\n${DECISION_LOG_REPORT_REMINDER}\n${DECISION_LOG_REMINDER}`
+    : lookup === "no_task" && anyTaskHasDecisionLog(root)
+      ? `\n${DECISION_LOG_NO_TASK_REPORT_REMINDER}`
+      : "";
+  return `<workflow-state>\n${header}\n${body}${tail}\n</workflow-state>`;
 }
 
 // ── Session Overview ───────────────────────────────────────────────────
@@ -1250,16 +1314,16 @@ function buildStartupContext(
 ): string {
   const workflow = workflowOverview(root, key);
   // get_context.py puts a <conventions> block in the overview only for a
-  // `general` project. Its workflow has its own way to pick up unfinished
-  // work; the bare `task.py start` below is one the script refuses there.
+  // `general` project: there <ready> defers to <atw-workflow>, which has its
+  // own way to pick up unfinished work. In dev mode <ready> points to the
+  // per-turn no-task breadcrumb for binding an already-existing task.
   const ready = overview.includes("\n<conventions>\n")
     ? [
         "Do what <atw-workflow> above says for the current task's status. With no current task, it also says when to create one and how to pick up unfinished work.",
       ]
     : [
         "Use the current workflow state to decide whether to create, continue, or skip an ATW task.",
-        "When CURRENT TASK is (none) but ACTIVE TASKS lists exactly one task assigned to you that is already at the implement or accept stage, this window is merely not bound to it yet: run `python3 ./.atw/scripts/task.py start <task-dir>` for that task, then continue from its stage. Do not ask whether to create a new task in that case.",
-        "If several tasks qualify, or the only candidate is still in a planning stage (discover / specify / slice), ask which task to bind instead of running start: start moves a planning-stage task straight into implement.",
+        "With no current task, if the request is about a task that already exists — the user names it, or asks to continue or accept and only one open task fits — make it this session's task first, as the no-task breadcrumb says; do not ask whether to create a new one.",
       ];
   return [
     "<session-context>\nATW compact SessionStart context. Use it to orient the session; load details on demand.\n</session-context>",
@@ -2032,6 +2096,10 @@ export default function atwExtension(pi: {
     return undefined;
   });
   pi.on?.("before_agent_start", (event, ctx) => {
+    // Same switch as the other platforms' hooks: channel sets ATW_HOOKS=0 on
+    // its helpers, which must not receive prompts written for the main AI.
+    if (process.env.ATW_HOOKS === "0" || process.env.ATW_DISABLE_HOOKS === "1")
+      return undefined;
     const k = getKey(event, ctx);
     const key = cacheKey(k, ctx);
     const cur = (event as { systemPrompt?: string }).systemPrompt ?? "";
@@ -2089,4 +2157,9 @@ export default function atwExtension(pi: {
   pi.on?.("context", (event, ctx) => {
     getKey(event, ctx);
   });
+  // Compaction can fold the persisted runtime-context message into its
+  // summary. Forget what was sent so the next turn re-sends it unchanged.
+  pi.on?.("session_compact", () => {
+    lastSentRuntimeCtx.clear();
+  });
 }

package/dist/templates/shared-hooks/index.d.ts

@@ -11,7 +11,7 @@ export interface HookScript {
     /** Script content — no placeholders, ready to write directly */
     content: string;
 }
-export type SharedHookName = "session-start.py" | "inject-shell-session-context.py" | "inject-workflow-state.py" | "inject-subagent-context.py";
+export type SharedHookName = "session-start.py" | "inject-shell-session-context.py" | "inject-workflow-state.py" | "inject-subagent-context.py" | "show-notice.py";
 export type SharedHookPlatform = "claude" | "cursor" | "codex" | "gemini" | "qoder" | "copilot" | "codebuddy" | "droid" | "kiro" | "trae" | "zcode";
 /**
  * Which shared hooks each platform actually invokes. Single source of truth
@@ -51,6 +51,13 @@ export type SharedHookPlatform = "claude" | "cursor" | "codex" | "gemini" | "qod
  *   (per-turn breadcrumb), and `inject-subagent-context.py` (sub-agent
  *   spawn). The scripts emit a plain-text Kiro branch — Kiro adds a hook's
  *   stdout directly to the conversation context (no JSON envelope).
+ * - `show-notice.py` — Claude Code only (PostToolUse, matcher `Bash`): after
+ *   `cross_model_review.py afk-notice|prepare|prepare-log` it hands the
+ *   `notice` the script wrote to `.atw/.runtime/hook-notice.json` to Claude
+ *   Code as `systemMessage`, which Claude Code shows the user without the
+ *   model in between (task decision-log-afk ticket 26: Claude Code 2.1.302
+ *   rewrote the paragraph instead of posting it). Other platforms keep the
+ *   skills' "post it word for word".
  * - Claude Code `statusLine` is intentionally not installed by default.
  *   Users can add their own statusLine command in `.claude/settings.json`,
  *   or opt in to the ATW one via `atw init --with-statusline`

package/dist/templates/shared-hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/shared-hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,iCAAiC,GACjC,0BAA0B,GAC1B,4BAA4B,CAAC;AAEjC,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,OAAO,GACP,SAAS,GACT,WAAW,GACX,OAAO,GACP,MAAM,GACN,MAAM,GACN,OAAO,CAAC;AAEZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAC3C,kBAAkB,EAClB,SAAS,cAAc,EAAE,CAoD1B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,UAAU,EAAE,CAWnD;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,kBAAkB,GAC3B,UAAU,EAAE,CAGd"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/shared-hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,iCAAiC,GACjC,0BAA0B,GAC1B,4BAA4B,GAC5B,gBAAgB,CAAC;AAErB,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,OAAO,GACP,SAAS,GACT,WAAW,GACX,OAAO,GACP,MAAM,GACN,MAAM,GACN,OAAO,CAAC;AAEZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAC3C,kBAAkB,EAClB,SAAS,cAAc,EAAE,CAqD1B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,UAAU,EAAE,CAWnD;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,kBAAkB,GAC3B,UAAU,EAAE,CAGd"}

package/dist/templates/shared-hooks/index.js

@@ -51,6 +51,13 @@ function readTemplate(relativePath) {
  *   (per-turn breadcrumb), and `inject-subagent-context.py` (sub-agent
  *   spawn). The scripts emit a plain-text Kiro branch — Kiro adds a hook's
  *   stdout directly to the conversation context (no JSON envelope).
+ * - `show-notice.py` — Claude Code only (PostToolUse, matcher `Bash`): after
+ *   `cross_model_review.py afk-notice|prepare|prepare-log` it hands the
+ *   `notice` the script wrote to `.atw/.runtime/hook-notice.json` to Claude
+ *   Code as `systemMessage`, which Claude Code shows the user without the
+ *   model in between (task decision-log-afk ticket 26: Claude Code 2.1.302
+ *   rewrote the paragraph instead of posting it). Other platforms keep the
+ *   skills' "post it word for word".
  * - Claude Code `statusLine` is intentionally not installed by default.
  *   Users can add their own statusLine command in `.claude/settings.json`,
  *   or opt in to the ATW one via `atw init --with-statusline`
@@ -67,6 +74,7 @@ export const SHARED_HOOKS_BY_PLATFORM = {
         "session-start.py",
         "inject-workflow-state.py",
         "inject-subagent-context.py",
+        "show-notice.py",
     ],
     cursor: [
         "session-start.py",

package/dist/templates/shared-hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/shared-hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,SAAS,YAAY,CAAC,YAAoB;IACxC,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC;AA4BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAGjC;IACF,MAAM,EAAE;QACN,kBAAkB;QAClB,0BAA0B;QAC1B,4BAA4B;KAC7B;IACD,MAAM,EAAE;QACN,kBAAkB;QAClB,iCAAiC;QACjC,4BAA4B;KAC7B;IACD,KAAK,EAAE,CAAC,0BAA0B,EAAE,4BAA4B,CAAC;IACjE,MAAM,EAAE;QACN,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;KAC3B;IACD,KAAK,EAAE;QACL,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;KAC3B;IACD,OAAO,EAAE,CAAC,0BAA0B,CAAC;IACrC,SAAS,EAAE;QACT,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;QAC1B,4BAA4B;KAC7B;IACD,KAAK,EAAE;QACL,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;QAC1B,4BAA4B;KAC7B;IACD,IAAI,EAAE;QACJ,kBAAkB;QAClB,0BAA0B;QAC1B,4BAA4B;KAC7B;IACD,IAAI,EAAE;QACJ,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;KAC3B;IACD,KAAK,EAAE;QACL,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;QAC1B,4BAA4B;KAC7B;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC;SACjC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;SAChC,IAAI,EAAE,CAAC;IAEV,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAC7C,QAA4B;IAE5B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,wBAAwB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpE,OAAO,oBAAoB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACnE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/shared-hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,SAAS,YAAY,CAAC,YAAoB;IACxC,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC;AA6BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAGjC;IACF,MAAM,EAAE;QACN,kBAAkB;QAClB,0BAA0B;QAC1B,4BAA4B;QAC5B,gBAAgB;KACjB;IACD,MAAM,EAAE;QACN,kBAAkB;QAClB,iCAAiC;QACjC,4BAA4B;KAC7B;IACD,KAAK,EAAE,CAAC,0BAA0B,EAAE,4BAA4B,CAAC;IACjE,MAAM,EAAE;QACN,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;KAC3B;IACD,KAAK,EAAE;QACL,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;KAC3B;IACD,OAAO,EAAE,CAAC,0BAA0B,CAAC;IACrC,SAAS,EAAE;QACT,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;QAC1B,4BAA4B;KAC7B;IACD,KAAK,EAAE;QACL,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;QAC1B,4BAA4B;KAC7B;IACD,IAAI,EAAE;QACJ,kBAAkB;QAClB,0BAA0B;QAC1B,4BAA4B;KAC7B;IACD,IAAI,EAAE;QACJ,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;KAC3B;IACD,KAAK,EAAE;QACL,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;QAC1B,4BAA4B;KAC7B;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC;SACjC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;SAChC,IAAI,EAAE,CAAC;IAEV,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAC7C,QAA4B;IAE5B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,wBAAwB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpE,OAAO,oBAAoB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACnE,CAAC"}

package/dist/templates/shared-hooks/inject-workflow-state.py

@@ -160,13 +160,13 @@ def _resolve_active_task(root: Path, input_data: dict):
 
 def get_active_task(
     root: Path, input_data: dict
-) -> tuple[str, str, str] | None:
+) -> tuple[str, str, str, Path] | None:
     """Return active task data, a task-record error, or no task pointer.
 
-    ``(task_id, "task_error", source)`` is distinct from ``None``: a session
-    pointer can exist even when its task record is missing or unreadable, and
-    that state needs a diagnostic breadcrumb rather than the normal ``no_task``
-    prompt.
+    ``(task_id, "task_error", source, task_dir)`` is distinct from ``None``: a
+    session pointer can exist even when its task record is missing or
+    unreadable, and that state needs a diagnostic breadcrumb rather than the
+    normal ``no_task`` prompt.
     """
     active = _resolve_active_task(root, input_data)
     if not active.task_path:
@@ -176,23 +176,23 @@ def get_active_task(
     if not task_dir.is_absolute():
         task_dir = root / task_dir
     if active.stale:
-        return task_dir.name, f"stale_{active.source_type}", active.source
+        return task_dir.name, f"stale_{active.source_type}", active.source, task_dir
 
     task_json = task_dir / "task.json"
     if not task_json.is_file():
-        return task_dir.name, "task_error", active.source
+        return task_dir.name, "task_error", active.source, task_dir
     try:
         data = json.loads(task_json.read_text(encoding="utf-8"))
     except (json.JSONDecodeError, OSError):
-        return task_dir.name, "task_error", active.source
+        return task_dir.name, "task_error", active.source, task_dir
     if not isinstance(data, dict):
-        return task_dir.name, "task_error", active.source
+        return task_dir.name, "task_error", active.source, task_dir
 
     task_id = data.get("id") or task_dir.name
     status = data.get("status", "")
     if not isinstance(status, str) or not status:
-        return task_dir.name, "task_error", active.source
-    return task_id, status, active.source
+        return task_dir.name, "task_error", active.source, task_dir
+    return task_id, status, active.source, task_dir
 
 
 # ---------------------------------------------------------------------------
@@ -359,12 +359,80 @@ def resolve_breadcrumb_key(
     return status
 
 
+# 决定日志提醒：pi、omp 扩展里的 DECISION_LOG_REMINDER 与这里逐字相同。
+DECISION_LOG_REMINDER = (
+    "This task has a decision log: keep recording it at key points with "
+    "`python3 ./.atw/scripts/decision_log.py`; in this conversation, the "
+    "start row (`decision_log.py start`) goes in just before the first row you "
+    "log — `add` and the other writing commands write it first when it is "
+    "missing, so a conversation with nothing to log writes none; read the last "
+    "rows they print, and when another conversation wrote in between they "
+    "write only the start row and stop: read it, then run the same command "
+    "again."
+)
+# accept 阶段另加归档那一行的提醒，接在「Once accepted, run task.py archive」之后；pi、omp 扩展同名常量逐字相同
+DECISION_LOG_ARCHIVE_REMINDER = (
+    "This task has a decision log: once accepted, after the acceptance row "
+    "and before `task.py archive`, log one row for the archive "
+    "(`decision_log.py add`); it goes into the archive commit with the task."
+)
+# 用户问进度、要汇报时怎么拼（prd L 节）：implement、accept 有日志时都出，紧挨在 DECISION_LOG_REMINDER 之前；pi、omp 扩展同名常量逐字相同
+DECISION_LOG_REPORT_REMINDER = (
+    "This task has a decision log: when the user asks how things stand or for "
+    "a report (汇报一下, 现在什么情况, what's the status, report), rebuild it "
+    "from the task directory in four blocks — "
+    "`python3 ./.atw/scripts/decision_log.py pending --report` prints the "
+    "draft; post it in plain words, keep the plain-words lines it carries "
+    "with noob mode on, and fill in what it marks. This is the task's report, "
+    "not `atw-what-happened`: that skill only the user starts, and it tells "
+    "what changed in this chat since their last message."
+)
+# 没绑任务时问进度、要汇报（工单 27）：.atw/tasks/ 下有任务带日志时出；pi、omp 扩展同名常量逐字相同
+DECISION_LOG_NO_TASK_REPORT_REMINDER = (
+    "No task is current, but some task under `.atw/tasks/` has a decision "
+    "log: when the user asks how things stand or for a report (汇报一下, "
+    "现在什么情况, what's the status, report), rebuild it from that task's "
+    "directory in four blocks — list the active tasks with "
+    "`python3 ./.atw/scripts/task.py list` and see which of their directories "
+    "hold a `decision-log.md` (if the user named the task or said enough to "
+    "tell which one, take that one; if not, only one, take it; several, ask "
+    "the user which), then `python3 ./.atw/scripts/decision_log.py pending "
+    "--report --task-dir <dir>` prints the draft; post it in plain words, "
+    "keep the plain-words lines it carries with noob mode on, and fill in what "
+    "it marks. This is the task's report, not `atw-what-happened`: that skill "
+    "only the user starts, and it tells what changed in this chat since their "
+    "last message."
+)
+DECISION_LOG_STATUSES = ("implement", "accept")
+
+
+def has_decision_log(status: str, task_dir: Path) -> bool:
+    """Whether the breadcrumb carries DECISION_LOG_REMINDER: an implement or
+    accept task whose directory holds ``decision-log.md``. Planning stages
+    never do — their decisions are the user's and live in prd.md and tickets.
+    """
+    return status in DECISION_LOG_STATUSES and (task_dir / "decision-log.md").is_file()
+
+
+def any_task_has_decision_log(root: Path) -> bool:
+    """Whether a task directly under ``.atw/tasks/`` holds a ``decision-log.md``
+    file. One level only, so archived tasks never count; cheap enough to run
+    every turn.
+    """
+    try:
+        return any((d / "decision-log.md").is_file() for d in (root / ".atw" / "tasks").iterdir())
+    except OSError:
+        return False
+
+
 def build_breadcrumb(
     task_id: Optional[str],
     status: str,
     templates: dict[str, str],
     source: str | None = None,
     breadcrumb_key: str | None = None,
+    task_has_log: bool = False,
+    repo_has_task_log: bool = False,
 ) -> str:
     """Build the <workflow-state>...</workflow-state> block.
 
@@ -372,6 +440,14 @@ def build_breadcrumb(
     - Unknown status (no tag, or workflow.md missing) → generic
       "Refer to workflow.md for current step." line
     - `no_task` pseudo-status (task_id is None) → header omits task info
+    - ``task_has_log`` (the current task carries its decision log, see
+      ``has_decision_log``) →
+      DECISION_LOG_REMINDER as the block's last line,
+      DECISION_LOG_REPORT_REMINDER just before it, and in accept
+      DECISION_LOG_ARCHIVE_REMINDER before that
+    - ``repo_has_task_log`` (no current task, but some task under
+      ``.atw/tasks/`` has a decision log) →
+      DECISION_LOG_NO_TASK_REPORT_REMINDER as the block's last line
     """
     lookup_key = breadcrumb_key or status
     body = templates.get(lookup_key)
@@ -379,10 +455,38 @@ def build_breadcrumb(
         body = templates.get(status)
     if body is None:
         body = "Refer to workflow.md for current step."
+    if repo_has_task_log:
+        body = f"{body}\n{DECISION_LOG_NO_TASK_REPORT_REMINDER}"
+    if task_has_log:
+        if status == "accept":
+            body = f"{body}\n{DECISION_LOG_ARCHIVE_REMINDER}"
+        body = f"{body}\n{DECISION_LOG_REPORT_REMINDER}\n{DECISION_LOG_REMINDER}"
     header = f"Status: {status}" if task_id is None else f"Task: {task_id} ({status})"
     return f"<workflow-state>\n{header}\n{body}\n</workflow-state>"
 
 
+def _select_platform_blocks(root: Path, body: str, platform: str | None, config: dict) -> str:
+    """Keep only this platform's `[Platform]` block in a breadcrumb body.
+
+    The accept breadcrumb gives the cross-model review input once per tool;
+    a host handed all of them has picked another tool's form. A platform
+    with no block of its own gets every line (each names its tool). An
+    install whose scripts predate the helper gets the body unchanged.
+    """
+    scripts_dir = root / ".atw" / "scripts"
+    if str(scripts_dir) not in sys.path:
+        sys.path.insert(0, str(scripts_dir))
+    try:
+        from common.workflow_phase import (  # type: ignore[import-not-found]
+            resolve_effective_platform,
+            select_platform_blocks,
+        )
+    except Exception:
+        return body
+    effective = resolve_effective_platform(platform, config) if platform else None
+    return select_platform_blocks(body, effective)
+
+
 def _is_general_project(root: Path) -> bool:
     """Whether this is a `general` project, as `common.config` reads the mode.
 
@@ -473,20 +577,33 @@ def main() -> int:
 
     templates = load_breadcrumbs(root)
     platform = _detect_platform(data)
+    templates = {
+        key: _select_platform_blocks(root, body, platform, config)
+        for key, body in templates.items()
+    }
     task = get_active_task(root, data)
     if task is None:
         # No active task — still emit a breadcrumb nudging AI toward
         # atw-brainstorm + task.py create when user describes real work.
         no_task_key = resolve_breadcrumb_key("no_task", platform, config)
         breadcrumb = build_breadcrumb(
-            None, "no_task", templates, breadcrumb_key=no_task_key
+            None,
+            "no_task",
+            templates,
+            breadcrumb_key=no_task_key,
+            repo_has_task_log=any_task_has_decision_log(root),
         )
     else:
-        task_id, status, source = task
+        task_id, status, source, task_dir = task
         status_key = resolve_breadcrumb_key(status, platform, config)
         source_for_breadcrumb = None if platform == "codex" else source
         breadcrumb = build_breadcrumb(
-            task_id, status, templates, source_for_breadcrumb, breadcrumb_key=status_key
+            task_id,
+            status,
+            templates,
+            source_for_breadcrumb,
+            breadcrumb_key=status_key,
+            task_has_log=has_decision_log(status, task_dir),
         )
     if platform == "codex":
         parts: list[str] = []

package/dist/templates/shared-hooks/session-start.py

@@ -454,8 +454,10 @@ def _get_task_status(atw_dir: Path, input_data: dict, general: bool = False) ->
             )
         return (
             "Status: NO ACTIVE TASK\n"
-            "Next-Action: Classify the current turn before creating any ATW task. "
-            "Simple conversation / small task asks only whether this turn should create an ATW task. "
+            "Next-Action: If the request is about a task that already exists — the user names it, or asks to continue or accept and only one open task fits — make it this session's task first, as the no-task breadcrumb says; do not ask whether to create a new one. "
+            "Otherwise classify the current turn before creating any ATW task. "
+            "Simple conversation / small task asks whether this turn should create an ATW task. "
+            "In that ask, say what each answer means: without a task there is no requirements document (`prd.md`) and no formal acceptance (each requirement checked with evidence, the user signs off); a task adds writing the requirements, the user confirming the spec, implementing against it, and that acceptance before archiving. "
             "Complex task asks whether task creation and planning are allowed."
         )
 

package/dist/templates/shared-hooks/show-notice.py

@@ -0,0 +1,135 @@
+#!/usr/bin/env python3
+"""ATW start-notice hook (Claude Code PostToolUse, matcher ``Bash``).
+
+Claude Code 2.1.302 as the host rewrote the paragraph that
+``cross_model_review.py afk-notice`` / ``prepare`` / ``prepare-log`` print
+as ``notice`` instead of posting it word for word, however the skills put it
+(task decision-log-afk tickets 20, 23, 28, 26). So the script also writes the
+paragraph to ``.atw/.runtime/hook-notice.json``, and this hook, right after
+one of those commands ends, hands it to Claude Code as ``systemMessage``:
+Claude Code shows that to the user itself, the model never sees it. An
+``additionalContext`` line tells the model the paragraph has been shown, so it
+does not post it again.
+
+Verified on Claude Code 2.1.302 (``claude -p --output-format stream-json
+--verbose``): the message arrives as ``{"type":"system","subtype":
+"informational","content":"PostToolUse:Bash says: <text>"}`` (every line of
+the text gets that prefix), the session record keeps it as an
+``attachment`` of type ``hook_system_message`` with the text unchanged, and the
+model, asked to quote any hook message it saw, saw none.
+
+The file is shown once and then removed. Nothing is printed when the command
+is not one of the three, when the file was written by another of them, when
+it was written in another conversation (its ``session`` is the ATW context key
+``resolve_context_key`` gave the script; this hook computes the same key from
+its own input — when either side has none, it is shown as before), when there
+is no file, outside an ATW project, or with ATW hooks turned off.
+
+Claude Code caps ``systemMessage`` at 10,000 characters and replaces a longer
+one with a file path and a 2,000-character preview. A paragraph over
+``SHOW_LIMIT`` is therefore not shown at all: ``additionalContext`` tells the
+model to post it itself, word for word.
+
+The command names in ``COMMAND_RE`` are the script's ``NOTICE_COMMANDS``:
+change one, change the other.
+"""
+from __future__ import annotations
+
+import json
+import os
+import re
+import sys
+from pathlib import Path
+from typing import Optional
+
+NOTICE_FILE = Path(".atw") / ".runtime" / "hook-notice.json"
+# Claude Code 的上限是 10,000 字，留出余量
+SHOW_LIMIT = 8000
+COMMAND_RE = re.compile(r"cross_model_review\.py['\"]?\s+(afk-notice|prepare-log|prepare)(?![\w-])")
+SHOWN = (
+    "ATW: Claude Code has just shown the user the `notice` that `cross_model_review.py {command}` printed "
+    "({which}), word for word, as a message of its own. Do not post it again and do not reword it; "
+    "go on with the next step."
+)
+TOO_LONG = (
+    "ATW: the `notice` that `cross_model_review.py {command}` printed ({which}) is too long for Claude Code "
+    "to show whole ({length} characters, over {limit}), so it was not shown. Post it yourself, word for word, "
+    "as a message of its own, as the skill says."
+)
+
+
+def find_atw_root(start: Path) -> Optional[Path]:
+    cur = start.resolve()
+    for d in (cur, *cur.parents):
+        if (d / ".atw").is_dir():
+            return d
+    return None
+
+
+def _context_key(root: Path, data: dict) -> Optional[str]:
+    """ATW's own key for this conversation, the same way the script got it."""
+    scripts_dir = root / ".atw" / "scripts"
+    if str(scripts_dir) not in sys.path:
+        sys.path.insert(0, str(scripts_dir))
+    try:
+        from common.active_task import resolve_context_key  # type: ignore[import-not-found]
+    except ImportError:
+        return None
+    return resolve_context_key(data, platform="claude")
+
+
+def main() -> int:
+    if os.environ.get("ATW_HOOKS") == "0" or os.environ.get("ATW_DISABLE_HOOKS") == "1":
+        return 0
+    try:
+        # 按字节读、输出全用 ASCII 转义：Windows 上的默认编码碰不到中文
+        data = json.loads(sys.stdin.buffer.read().decode("utf-8", errors="replace"))
+    except (ValueError, OSError):
+        return 0
+    if not isinstance(data, dict) or data.get("tool_name") != "Bash":
+        return 0
+    tool_input = data.get("tool_input")
+    command = tool_input.get("command") if isinstance(tool_input, dict) else None
+    match = COMMAND_RE.search(command) if isinstance(command, str) else None
+    if match is None:
+        return 0
+    cwd = data.get("cwd")
+    root = find_atw_root(Path(cwd) if isinstance(cwd, str) and cwd else Path.cwd())
+    if root is None:
+        return 0
+    path = root / NOTICE_FILE
+    try:
+        saved = json.loads(path.read_text(encoding="utf-8"))
+    except (OSError, ValueError):
+        return 0
+    if not isinstance(saved, dict) or saved.get("command") != match.group(1):
+        return 0
+    text = saved.get("text")
+    if not isinstance(text, str) or not text:
+        return 0
+    written_in = saved.get("session")
+    here = _context_key(root, data) if written_in else None
+    if written_in and here and written_in != here:
+        # 别的对话写的：留给它，不在这里显示
+        return 0
+    path.unlink(missing_ok=True)
+    command_name = match.group(1)
+    which = {"zh": "the Chinese paragraph", "en": "the English paragraph"}.get(
+        saved.get("lang"), "both the Chinese and the English paragraph"
+    )
+    if len(text) > SHOW_LIMIT:
+        out: dict = {"hookSpecificOutput": {
+            "hookEventName": "PostToolUse",
+            "additionalContext": TOO_LONG.format(command=command_name, which=which, length=len(text), limit=SHOW_LIMIT),
+        }}
+    else:
+        out = {"systemMessage": text, "hookSpecificOutput": {
+            "hookEventName": "PostToolUse",
+            "additionalContext": SHOWN.format(command=command_name, which=which),
+        }}
+    print(json.dumps(out))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/dist/templates/snow/SNOW.md

@@ -50,7 +50,7 @@ the AI do the rest. There are no prompt commands to run and no project agents.
 
 | Capability                                 | Status                                                                       |
 | ------------------------------------------ | ---------------------------------------------------------------------------- |
-| Skills (`.snow/skills/atw-*/SKILL.md`)     | Works — the six skills of `general` mode                                     |
+| Skills (`.snow/skills/atw-*/SKILL.md`)     | Works — the seven skills of `general` mode                                   |
 | Context hooks (`.snow/hooks/`)             | Inject model context via stdout JSON + write `.snow/log/atw-context.txt`     |
 | Prompt commands, project agents            | None in `general` mode                                                       |
 

package/dist/utils/initialized.d.ts

@@ -0,0 +1,9 @@
+/** `.atw/` 里归用户、卸载后仍留着的条目。只剩它们时项目不算装了 ATW。 */
+export declare const ATW_ENTRIES_KEPT_BY_UNINSTALL: readonly string[];
+/**
+ * 项目里装没装 ATW：`.atw/` 存在，且不是只剩卸载后留下的用户条目。
+ * 不看 `.atw/.version`——早期版本装的项目可能没有它；空的 `.atw/` 照旧算装过
+ * （由各命令自己报清单缺失）。
+ */
+export declare function isAtwInitialized(cwd: string): boolean;
+//# sourceMappingURL=initialized.d.ts.map

package/dist/utils/initialized.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialized.d.ts","sourceRoot":"","sources":["../../src/utils/initialized.ts"],"names":[],"mappings":"AAKA,8CAA8C;AAC9C,eAAO,MAAM,6BAA6B,EAAE,SAAS,MAAM,EAE1D,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAWrD"}

package/dist/utils/initialized.js

@@ -0,0 +1,24 @@
+import fs from "node:fs";
+import path from "node:path";
+import { DIR_NAMES } from "../constants/paths.js";
+/** `.atw/` 里归用户、卸载后仍留着的条目。只剩它们时项目不算装了 ATW。 */
+export const ATW_ENTRIES_KEPT_BY_UNINSTALL = [
+    DIR_NAMES.SKILL_NOTES,
+];
+/**
+ * 项目里装没装 ATW：`.atw/` 存在，且不是只剩卸载后留下的用户条目。
+ * 不看 `.atw/.version`——早期版本装的项目可能没有它；空的 `.atw/` 照旧算装过
+ * （由各命令自己报清单缺失）。
+ */
+export function isAtwInitialized(cwd) {
+    let entries;
+    try {
+        entries = fs.readdirSync(path.join(cwd, DIR_NAMES.WORKFLOW));
+    }
+    catch {
+        return false;
+    }
+    return (entries.length === 0 ||
+        entries.some((entry) => !ATW_ENTRIES_KEPT_BY_UNINSTALL.includes(entry)));
+}
+//# sourceMappingURL=initialized.js.map

package/dist/utils/initialized.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialized.js","sourceRoot":"","sources":["../../src/utils/initialized.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,8CAA8C;AAC9C,MAAM,CAAC,MAAM,6BAA6B,GAAsB;IAC9D,SAAS,CAAC,WAAW;CACtB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,CACL,OAAO,CAAC,MAAM,KAAK,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,6BAA6B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CACxE,CAAC;AACJ,CAAC"}

package/dist/utils/managed-removal.d.ts

@@ -30,6 +30,8 @@ export interface ManagedRemovalPlan {
     deletions: PlannedDeletion[];
     modifications: PlannedModification[];
     removeAtwDir: boolean;
+    /** `.atw/` 里归用户、卸载留着的条目（磁盘上有的）；非空时 `.atw/` 只删其余条目。 */
+    keptAtwEntries: string[];
     allPosixPaths: string[];
 }
 export interface BuildManagedRemovalPlanOptions {