@chinhae/atw-cli 0.2.6 → 0.2.8

package/dist/migrations/manifests/0.2.7.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.2.7",
+  "description": "Active-task pointers are no longer borrowed by count (#608 upstream); the Pi extension inherits a pointer only through the window's own session lineage and tells a fresh window to bind the sole in-progress task instead of asking.",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "resolve_active_task() no longer treats a sole runtime session file as proof of ownership: allow_single_session_fallback defaults to False and only inject-subagent-context.py opts in, because copilot/gemini/qoder child agents cannot inherit a parent session id (mirrors upstream Trellis #608). Main sessions on every platform therefore see no active task until task.py start binds the window. The Pi extension now moves the previous session's pointer to the new session when session_start reports reason=new or fork with a previousSessionFile — the lineage Pi itself declares for /clear and fork — so a /clear in the same window keeps its task without counting pointer files or trusting key prefixes (#512 holds). Its startup <ready> block also tells a fresh window with exactly one implement/accept-stage task assigned to the developer to run task.py start for it rather than asking whether to create a task, and to ask when several qualify or the only candidate is still in planning.",
+  "migrations": [],
+  "notes": "No migration required. Changed files are all tracked by atw update: .atw/scripts/common/active_task.py, the shared inject-subagent-context.py hook under each platform directory, and .pi/extensions/atw/index.ts. Expect one explicit task.py start per new window on every platform from now on; a Pi /clear keeps the binding automatically."
+}

package/dist/migrations/manifests/0.2.8.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.2.8",
+  "description": "Bundled skills now present themselves as ATW instead of Oxyteam in Codex and every other skill picker.",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "The display_name in every bundled skill's agents/openai.yaml still read \"Oxyteam …\", so Codex listed the skills under a name that no longer exists; all 18 now read \"ATW …\" (ATW Implement, ATW Spec, ATW Triage, …), matching the ATW Meta / ATW Session Insight convention already used elsewhere. Five SKILL.md headings (diagnosing-bugs, domain-modeling, improve-codebase-architecture, tickets, triage) carried the same stale title and were renamed alongside. No behaviour change.",
+  "migrations": [],
+  "notes": "No migration required. The 23 touched files live under the bundled skills that atw update tracks in every platform directory (.agents, .claude, .cursor, .omp, .opencode, .codex where present), so a plain atw update picks them up as Template updated."
+}

package/dist/templates/atw/scripts/common/active_task.py

@@ -648,17 +648,15 @@ def resolve_active_task(
     platform_input: dict[str, Any] | None = None,
     platform: str | None = None,
     *,
-    allow_single_session_fallback: bool = True,
+    allow_single_session_fallback: bool = False,
     allow_environment_context: bool = True,
 ) -> ActiveTask:
     """Resolve the active task from session runtime state only.
 
-    A stale session task is returned as stale. Missing context identity or a
-    missing/empty session context falls back to single-session inference: if
-    exactly one session file exists in the runtime, return its task with
-    source_type="session-fallback" — covers pull-based platform sub-agents
-    (copilot, gemini, qoder) that don't inherit the parent's session id. ≥2
-    files or 0 files yield ActiveTask(None) — refuses to guess across windows.
+    A stale session task is returned as stale.
+    Missing or unmatched session identity does not infer ownership from the
+    number of session files. Pull-based child-agent callers that cannot inherit
+    a parent identity must opt into the compatibility fallback explicitly.
     """
     context_key = resolve_context_key(
         platform_input,

package/dist/templates/common/bundled-skills/atw-askme/agents/openai.yaml

@@ -1,5 +1,5 @@
 interface:
-  display_name: "Oxyteam Ask Me"
+  display_name: "ATW Ask Me"
   short_description: "通过访谈完善计划"
 policy:
   allow_implicit_invocation: false

package/dist/templates/common/bundled-skills/atw-askme-with-docs/agents/openai.yaml

@@ -1,5 +1,5 @@
 interface:
-  display_name: "Oxyteam Ask Me with Docs"
+  display_name: "ATW Ask Me with Docs"
   short_description: "设计访谈计划并编写其文档"
 policy:
   allow_implicit_invocation: false

package/dist/templates/common/bundled-skills/atw-code-review/agents/openai.yaml

@@ -1,3 +1,3 @@
 interface:
-  display_name: "Oxyteam Code Review"
+  display_name: "ATW Code Review"
   short_description: "审查标准和规范的差异"

package/dist/templates/common/bundled-skills/atw-codebase-design/agents/openai.yaml

@@ -1,3 +1,3 @@
 interface:
-  display_name: "Oxyteam Codebase Design"
+  display_name: "ATW Codebase Design"
   short_description: "深度模块设计术语"

package/dist/templates/common/bundled-skills/atw-diagnosing-bugs/SKILL.md

@@ -3,7 +3,7 @@ name: atw-diagnosing-bugs
 description: "用于排查顽固错误和性能退化的诊断循环。当用户说“诊断”/“调试这个”，或报告某功能失效、抛出异常、失败或运行缓慢时，请使用此循环。"
 ---
 
-# Oxyteam Diagnosing Bugs
+# ATW Diagnosing Bugs
 
 A discipline for hard bugs. Skip phases only when explicitly justified.
 

package/dist/templates/common/bundled-skills/atw-diagnosing-bugs/agents/openai.yaml

@@ -1,3 +1,3 @@
 interface:
-  display_name: "Oxyteam Diagnosing Bugs"
+  display_name: "ATW Diagnosing Bugs"
   short_description: "诊断棘手的问题和回归问题"

package/dist/templates/common/bundled-skills/atw-domain-modeling/SKILL.md

@@ -3,7 +3,7 @@ name: atw-domain-modeling
 description: "构建并完善项目的领域模型。适用于讨论代码库术语、编写或编辑 CONTEXT.md 文件，以及记录或编辑 ADR 时。"
 ---
 
-# Oxyteam Domain Modeling
+# ATW Domain Modeling
 
 Actively build and sharpen the project's domain model as you design. This is the *active* discipline — challenging terms, inventing edge-case scenarios, and writing the glossary and decisions down the moment they crystallise. (Merely *reading* `CONTEXT.md` for vocabulary is not this skill — that's a one-line habit any skill can do. This skill is for when you're changing the model, not just consuming it.)
 

package/dist/templates/common/bundled-skills/atw-domain-modeling/agents/openai.yaml

@@ -1,3 +1,3 @@
 interface:
-  display_name: "Oxyteam Domain Modeling"
+  display_name: "ATW Domain Modeling"
   short_description: "构建并优化领域模型"

package/dist/templates/common/bundled-skills/atw-handoff/agents/openai.yaml

@@ -1,5 +1,5 @@
 interface:
-  display_name: "Oxyteam Handoff"
+  display_name: "ATW Handoff"
   short_description: "将一次对话浓缩为一次交接"
 policy:
   allow_implicit_invocation: false

package/dist/templates/common/bundled-skills/atw-implement/agents/openai.yaml

@@ -1,5 +1,5 @@
 interface:
-  display_name: "Oxyteam Implement"
+  display_name: "ATW Implement"
   short_description: "根据规格说明或工单进行开发"
 policy:
   allow_implicit_invocation: false

package/dist/templates/common/bundled-skills/atw-improve-codebase-architecture/SKILL.md

@@ -4,7 +4,7 @@ description: "扫描代码库以发现可深入挖掘的机会，将其以可视
 disable-model-invocation: true
 ---
 
-# Oxyteam Improve Codebase Architecture
+# ATW Improve Codebase Architecture
 
 Surface architectural friction and propose **deepening opportunities** — refactors that turn shallow modules into deep ones. The aim is testability and AI-navigability.
 

package/dist/templates/common/bundled-skills/atw-improve-codebase-architecture/agents/openai.yaml

@@ -1,5 +1,5 @@
 interface:
-  display_name: "Oxyteam Improve Codebase Architecture"
+  display_name: "ATW Improve Codebase Architecture"
   short_description: "发现并深入访谈架构改进机会"
 policy:
   allow_implicit_invocation: false

package/dist/templates/common/bundled-skills/atw-interview/agents/openai.yaml

@@ -1,3 +1,3 @@
 interface:
-  display_name: "Oxyteam Interview"
+  display_name: "ATW Interview"
   short_description: "通过决策树逐轮澄清计划、方案和关键决策"

package/dist/templates/common/bundled-skills/atw-map/agents/openai.yaml

@@ -1,5 +1,5 @@
 interface:
-  display_name: "Oxyteam Map"
+  display_name: "ATW Map"
   short_description: "将大型工作任务映射为决策工单"
 policy:
   allow_implicit_invocation: false

package/dist/templates/common/bundled-skills/atw-merge/agents/openai.yaml

@@ -1,3 +1,3 @@
 interface:
-  display_name: "Oxyteam Merge"
+  display_name: "ATW Merge"
   short_description: "解决合并与变基冲突"

package/dist/templates/common/bundled-skills/atw-prototype/agents/openai.yaml

@@ -1,3 +1,3 @@
 interface:
-  display_name: "Oxyteam Prototype"
+  display_name: "ATW Prototype"
   short_description: "用于解答设计问题的原型"

package/dist/templates/common/bundled-skills/atw-research/agents/openai.yaml

@@ -1,3 +1,3 @@
 interface:
-  display_name: "Oxyteam Research"
+  display_name: "ATW Research"
   short_description: "来自高可信度来源的研究"

package/dist/templates/common/bundled-skills/atw-spec/agents/openai.yaml

@@ -1,5 +1,5 @@
 interface:
-  display_name: "Oxyteam Spec"
+  display_name: "ATW Spec"
   short_description: "将对话转化为技术规格书"
 policy:
   allow_implicit_invocation: false

package/dist/templates/common/bundled-skills/atw-tdd/agents/openai.yaml

@@ -1,3 +1,3 @@
 interface:
-  display_name: "Oxyteam TDD"
+  display_name: "ATW TDD"
   short_description: "测试驱动的红-绿-重构"

package/dist/templates/common/bundled-skills/atw-tickets/SKILL.md

@@ -4,7 +4,7 @@ description: "将计划、规格说明或当前对话拆分为一组“追踪子
 disable-model-invocation: true
 ---
 
-# Oxyteam Tickets
+# ATW Tickets
 
 Break a plan, spec, or conversation into a set of **tickets** — tracer-bullet vertical slices, each declaring the tickets that **block** it.
 

package/dist/templates/common/bundled-skills/atw-tickets/agents/openai.yaml

@@ -1,5 +1,5 @@
 interface:
-  display_name: "Oxyteam Tickets"
+  display_name: "ATW Tickets"
   short_description: "将计划拆分为“追踪子弹”工单"
 policy:
   allow_implicit_invocation: false

package/dist/templates/common/bundled-skills/atw-triage/SKILL.md

@@ -4,7 +4,7 @@ description: "通过由分流角色组成的状态机处理问题和外部PR—
 disable-model-invocation: true
 ---
 
-# Oxyteam Triage
+# ATW Triage
 
 Move issues on the project issue tracker through a small state machine of triage roles.
 

package/dist/templates/common/bundled-skills/atw-triage/agents/openai.yaml

@@ -1,5 +1,5 @@
 interface:
-  display_name: "Oxyteam Triage"
+  display_name: "ATW Triage"
   short_description: "通过分诊角色处理问题"
 policy:
   allow_implicit_invocation: false

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

@@ -1,4 +1,13 @@
-import { existsSync, readFileSync, realpathSync, statSync } from "node:fs";
+import {
+  closeSync,
+  existsSync,
+  openSync,
+  readFileSync,
+  readSync,
+  realpathSync,
+  renameSync,
+  statSync,
+} from "node:fs";
 import { createHash, randomBytes } from "node:crypto";
 import {
   delimiter,
@@ -1055,17 +1064,19 @@ function parseAgentFM(c: string): AgentConfig {
   return cfg;
 }
 
+function keyForSessionId(sessionId: string): string {
+  const normalized = sessionId.replace(/[^A-Za-z0-9._-]+/g, "_");
+  if (!normalized) return `pi_${hash(sessionId)}`;
+  return `pi_${normalized}${normalized === sessionId ? "" : `_${hash(sessionId)}`}`;
+}
+
 function contextKey(input?: unknown, ctx?: PiExtensionContext): string | null {
   const sessionId =
     callStr(ctx?.sessionManager?.getSessionId, ctx?.sessionManager) ??
     str(process.env.PI_SESSION_ID) ??
     str(process.env.PI_SESSIONID) ??
     lookupStr(input, ["session_id", "sessionId", "sessionID"]);
-  if (sessionId) {
-    const normalized = sessionId.replace(/[^A-Za-z0-9._-]+/g, "_");
-    if (!normalized) return `pi_${hash(sessionId)}`;
-    return `pi_${normalized}${normalized === sessionId ? "" : `_${hash(sessionId)}`}`;
-  }
+  if (sessionId) return keyForSessionId(sessionId);
   const transcriptPath =
     callStr(ctx?.sessionManager?.getSessionFile, ctx?.sessionManager) ??
     lookupStr(input, ["transcript_path", "transcriptPath", "transcript"]);
@@ -1117,6 +1128,55 @@ function readTaskDir(root: string, key: string | null): string | null {
   }
 }
 
+// ── Session lineage ───────────────────────────────────────────────────
+// 只读 pi 会话文件的首行头部拿会话 id；会话文件可能很大，不整读。
+function readSessionHeaderId(sessionFile: string): string | null {
+  let fd: number | null = null;
+  try {
+    fd = openSync(sessionFile, "r");
+    const buf = Buffer.alloc(65536);
+    const n = readSync(fd, buf, 0, buf.length, 0);
+    const line = buf.toString("utf-8", 0, n).split("\n")[0] ?? "";
+    const header = JSON.parse(line) as JsonObject;
+    return header.type === "session" ? str(header.id) : null;
+  } catch {
+    return null;
+  } finally {
+    if (fd !== null) closeSync(fd);
+  }
+}
+
+// 同一窗口用 /clear（reason=new）或 fork 换出新会话时，把前一个会话的活动任务指针
+// 搬到新会话名下。只认 pi 在 session_start 事件里给出的 previousSessionFile 这条
+// 明确血缘，不看运行时目录里有几个指针、也不看前缀（#512）。新开的窗口
+// （reason=startup）没有前身，什么都不继承。搬移而非复制，避免 /clear 链条堆积指针。
+function inheritSessionPointer(
+  root: string,
+  key: string | null,
+  event: unknown,
+): boolean {
+  if (!key || !isObj(event)) return false;
+  const reason = str(event.reason);
+  const previous = str(event.previousSessionFile);
+  if ((reason !== "new" && reason !== "fork") || !previous) return false;
+  const parentId = readSessionHeaderId(previous);
+  if (!parentId) return false;
+  const parentKey = keyForSessionId(parentId);
+  if (parentKey === key) return false;
+  const dir = join(root, ".atw", ".runtime", "sessions");
+  const ownPath = join(dir, `${key}.json`);
+  const parentPath = join(dir, `${parentKey}.json`);
+  try {
+    if (existsSync(ownPath) || !existsSync(parentPath)) return false;
+    const ctx = JSON.parse(readText(parentPath)) as JsonObject;
+    if (!str(ctx.current_task)) return false;
+    renameSync(parentPath, ownPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 // ── Workflow State Breadcrumb ─────────────────────────────────────────
 const WF_RE =
   /\[workflow-state:([A-Za-z0-9_-]+)\]\s*\n([\s\S]*?)\n\s*\[\/workflow-state:\1\]/g;
@@ -1194,7 +1254,13 @@ function buildStartupContext(
     FIRST_REPLY_NOTICE,
     overview,
     workflow,
-    "<ready>\nUse the current workflow state to decide whether to create, continue, or skip an ATW task.\n</ready>",
+    [
+      "<ready>",
+      "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.",
+      "</ready>",
+    ].join("\n"),
   ]
     .filter(Boolean)
     .join("\n\n");
@@ -1916,7 +1982,8 @@ export default function atwExtension(pi: {
 
   // Events
   pi.on?.("session_start", (event, ctx) => {
-    getKey(event, ctx);
+    const k = getKey(event, ctx);
+    inheritSessionPointer(resolveRoot(ctx), k, event);
     ctx?.ui?.notify?.(
       "ATW project context is available. Use /atw-start to bootstrap or /atw-continue to resume.",
       "info",

package/dist/templates/shared-hooks/inject-subagent-context.py

@@ -1093,7 +1093,11 @@ def main():
 
     # Get current task directory. May be None here — the AGENTS_REQUIRE_TASK
     # check below is what refuses to continue without one.
-    task_dir = get_current_task(repo_root, input_data)
+    task_dir = get_current_task(
+        repo_root,
+        input_data,
+        allow_single_session_fallback=True,
+    )
 
     # implement/check need task directory
     if subagent_type in AGENTS_REQUIRE_TASK:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chinhae/atw-cli",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "A Team Workflow — an AI coding workflow framework that encodes your team's conventions into the process",
   "type": "module",
   "main": "./dist/index.js",
@@ -33,7 +33,7 @@
     "inquirer": "^9.3.7",
     "undici": "^6.21.0",
     "zod": "^4.4.2",
-    "@chinhae/atw-core": "0.2.6"
+    "@chinhae/atw-core": "0.2.8"
   },
   "devDependencies": {
     "@eslint/js": "^9.18.0",