@fitlab-ai/agent-infra 0.7.2 → 0.7.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (126) hide show
  1. package/README.md +35 -787
  2. package/README.zh-CN.md +37 -762
  3. package/bin/cli.ts +1 -1
  4. package/dist/bin/cli.js +1 -1
  5. package/dist/lib/defaults.json +0 -1
  6. package/dist/lib/init.js +0 -3
  7. package/dist/lib/sandbox/commands/create.js +44 -3
  8. package/dist/lib/sandbox/commands/enter.js +13 -15
  9. package/dist/lib/sandbox/commands/list-running.js +36 -1
  10. package/dist/lib/sandbox/commands/ls.js +9 -4
  11. package/dist/lib/sandbox/commands/rm.js +99 -19
  12. package/dist/lib/sandbox/commands/start.js +36 -0
  13. package/dist/lib/sandbox/index.js +11 -1
  14. package/dist/lib/sandbox/readme-scaffold.js +6 -6
  15. package/dist/lib/table.js +11 -2
  16. package/dist/lib/task/artifacts.js +58 -0
  17. package/dist/lib/task/commands/cat.js +38 -0
  18. package/dist/lib/task/commands/files.js +47 -0
  19. package/dist/lib/task/commands/grep.js +143 -0
  20. package/dist/lib/task/commands/log.js +75 -0
  21. package/dist/lib/task/commands/ls.js +1 -1
  22. package/dist/lib/task/commands/show.js +5 -114
  23. package/dist/lib/task/commands/status.js +239 -0
  24. package/dist/lib/task/index.js +37 -0
  25. package/dist/lib/task/resolve-ref.js +150 -0
  26. package/dist/lib/task/short-id.js +10 -0
  27. package/dist/lib/update.js +25 -8
  28. package/lib/defaults.json +0 -1
  29. package/lib/init.ts +0 -10
  30. package/lib/sandbox/commands/create.ts +47 -4
  31. package/lib/sandbox/commands/enter.ts +33 -14
  32. package/lib/sandbox/commands/list-running.ts +43 -1
  33. package/lib/sandbox/commands/ls.ts +12 -4
  34. package/lib/sandbox/commands/rm.ts +128 -19
  35. package/lib/sandbox/commands/start.ts +61 -0
  36. package/lib/sandbox/index.ts +11 -1
  37. package/lib/sandbox/readme-scaffold.ts +6 -6
  38. package/lib/table.ts +14 -2
  39. package/lib/task/artifacts.ts +72 -0
  40. package/lib/task/commands/cat.ts +39 -0
  41. package/lib/task/commands/files.ts +53 -0
  42. package/lib/task/commands/grep.ts +147 -0
  43. package/lib/task/commands/log.ts +80 -0
  44. package/lib/task/commands/ls.ts +1 -1
  45. package/lib/task/commands/show.ts +5 -117
  46. package/lib/task/commands/status.ts +302 -0
  47. package/lib/task/index.ts +37 -0
  48. package/lib/task/resolve-ref.ts +160 -0
  49. package/lib/task/short-id.ts +10 -0
  50. package/lib/update.ts +28 -10
  51. package/package.json +1 -1
  52. package/templates/.agents/README.en.md +1 -0
  53. package/templates/.agents/README.zh-CN.md +1 -0
  54. package/templates/.agents/hooks/auto-resume.sh +21 -4
  55. package/templates/.agents/rules/README.en.md +41 -0
  56. package/templates/.agents/rules/README.zh-CN.md +40 -0
  57. package/templates/.agents/rules/debugging-guide.en.md +25 -0
  58. package/templates/.agents/rules/debugging-guide.zh-CN.md +25 -0
  59. package/templates/.agents/rules/next-step-output.en.md +6 -3
  60. package/templates/.agents/rules/next-step-output.zh-CN.md +6 -3
  61. package/templates/.agents/rules/pr-checks-commands.en.md +5 -0
  62. package/templates/.agents/rules/pr-checks-commands.github.en.md +62 -0
  63. package/templates/.agents/rules/pr-checks-commands.github.zh-CN.md +62 -0
  64. package/templates/.agents/rules/pr-checks-commands.zh-CN.md +5 -0
  65. package/templates/.agents/rules/pr-sync.github.en.md +7 -0
  66. package/templates/.agents/rules/pr-sync.github.zh-CN.md +7 -0
  67. package/templates/.agents/skills/analyze-task/SKILL.en.md +1 -1
  68. package/templates/.agents/skills/analyze-task/SKILL.zh-CN.md +1 -1
  69. package/templates/.agents/skills/block-task/SKILL.en.md +8 -1
  70. package/templates/.agents/skills/block-task/SKILL.zh-CN.md +8 -1
  71. package/templates/.agents/skills/cancel-task/SKILL.en.md +8 -1
  72. package/templates/.agents/skills/cancel-task/SKILL.zh-CN.md +8 -1
  73. package/templates/.agents/skills/check-task/SKILL.en.md +1 -1
  74. package/templates/.agents/skills/check-task/SKILL.zh-CN.md +1 -1
  75. package/templates/.agents/skills/close-codescan/SKILL.en.md +8 -1
  76. package/templates/.agents/skills/close-codescan/SKILL.zh-CN.md +8 -1
  77. package/templates/.agents/skills/close-dependabot/SKILL.en.md +8 -1
  78. package/templates/.agents/skills/close-dependabot/SKILL.zh-CN.md +8 -1
  79. package/templates/.agents/skills/code-task/SKILL.en.md +3 -1
  80. package/templates/.agents/skills/code-task/SKILL.zh-CN.md +3 -1
  81. package/templates/.agents/skills/commit/SKILL.en.md +2 -3
  82. package/templates/.agents/skills/commit/SKILL.zh-CN.md +2 -3
  83. package/templates/.agents/skills/commit/reference/task-status-update.en.md +31 -23
  84. package/templates/.agents/skills/commit/reference/task-status-update.zh-CN.md +31 -23
  85. package/templates/.agents/skills/complete-task/SKILL.en.md +36 -3
  86. package/templates/.agents/skills/complete-task/SKILL.zh-CN.md +36 -3
  87. package/templates/.agents/skills/create-pr/SKILL.en.md +16 -7
  88. package/templates/.agents/skills/create-pr/SKILL.zh-CN.md +16 -7
  89. package/templates/.agents/skills/create-pr/reference/comment-publish.en.md +1 -0
  90. package/templates/.agents/skills/create-pr/reference/comment-publish.zh-CN.md +1 -0
  91. package/templates/.agents/skills/create-task/SKILL.en.md +1 -1
  92. package/templates/.agents/skills/create-task/SKILL.zh-CN.md +1 -1
  93. package/templates/.agents/skills/import-codescan/SKILL.en.md +1 -1
  94. package/templates/.agents/skills/import-codescan/SKILL.zh-CN.md +1 -1
  95. package/templates/.agents/skills/import-dependabot/SKILL.en.md +1 -1
  96. package/templates/.agents/skills/import-dependabot/SKILL.zh-CN.md +1 -1
  97. package/templates/.agents/skills/import-issue/SKILL.en.md +1 -1
  98. package/templates/.agents/skills/import-issue/SKILL.zh-CN.md +1 -1
  99. package/templates/.agents/skills/plan-task/SKILL.en.md +1 -1
  100. package/templates/.agents/skills/plan-task/SKILL.zh-CN.md +1 -1
  101. package/templates/.agents/skills/review-analysis/SKILL.en.md +1 -1
  102. package/templates/.agents/skills/review-analysis/SKILL.zh-CN.md +1 -1
  103. package/templates/.agents/skills/review-code/SKILL.en.md +1 -1
  104. package/templates/.agents/skills/review-code/SKILL.zh-CN.md +1 -1
  105. package/templates/.agents/skills/review-plan/SKILL.en.md +1 -1
  106. package/templates/.agents/skills/review-plan/SKILL.zh-CN.md +1 -1
  107. package/templates/.agents/skills/update-agent-infra/scripts/sync-templates.js +0 -1
  108. package/templates/.agents/skills/watch-pr/SKILL.en.md +131 -0
  109. package/templates/.agents/skills/watch-pr/SKILL.zh-CN.md +131 -0
  110. package/templates/.agents/skills/watch-pr/config/verify.json +22 -0
  111. package/templates/.agents/skills/watch-pr/reference/monitor-and-heal.en.md +43 -0
  112. package/templates/.agents/skills/watch-pr/reference/monitor-and-heal.zh-CN.md +43 -0
  113. package/templates/.agents/templates/task.en.md +1 -0
  114. package/templates/.agents/templates/task.zh-CN.md +1 -0
  115. package/templates/.agents/workflows/bug-fix.en.yaml +6 -4
  116. package/templates/.agents/workflows/bug-fix.zh-CN.yaml +5 -4
  117. package/templates/.agents/workflows/feature-development.en.yaml +6 -4
  118. package/templates/.agents/workflows/feature-development.zh-CN.yaml +5 -4
  119. package/templates/.agents/workflows/refactoring.en.yaml +6 -4
  120. package/templates/.agents/workflows/refactoring.zh-CN.yaml +5 -4
  121. package/templates/.claude/commands/watch-pr.en.md +8 -0
  122. package/templates/.claude/commands/watch-pr.zh-CN.md +8 -0
  123. package/templates/.gemini/commands/_project_/watch-pr.en.toml +8 -0
  124. package/templates/.gemini/commands/_project_/watch-pr.zh-CN.toml +8 -0
  125. package/templates/.opencode/commands/watch-pr.en.md +11 -0
  126. package/templates/.opencode/commands/watch-pr.zh-CN.md +11 -0
@@ -0,0 +1,38 @@
1
+ import fs from 'node:fs';
2
+ import { resolveTaskRef } from "../resolve-ref.js";
3
+ import { resolveArtifact } from "../artifacts.js";
4
+ const USAGE = `Usage: ai task cat <N | #N | TASK-id> <artifact | N>
5
+
6
+ Prints a task artifact's raw content to stdout.
7
+ <ref> Bare numeric / '#N' short id, or a full TASK-YYYYMMDD-HHMMSS id.
8
+ <artifact | N> Artifact filename (with or without '.md'), or the number from 'ai task files'.
9
+ `;
10
+ function cat(args = []) {
11
+ if (args[0] === '--help' || args[0] === '-h') {
12
+ process.stdout.write(USAGE);
13
+ return;
14
+ }
15
+ if (args.length < 2) {
16
+ process.stdout.write(USAGE);
17
+ process.exitCode = 1;
18
+ return;
19
+ }
20
+ const resolved = resolveTaskRef(args[0]);
21
+ if (!resolved.ok) {
22
+ process.stderr.write(`ai task cat: ${resolved.message}\n`);
23
+ process.exitCode = 1;
24
+ return;
25
+ }
26
+ let artifactPath;
27
+ try {
28
+ artifactPath = resolveArtifact(resolved.taskDir, args[1]);
29
+ }
30
+ catch (e) {
31
+ process.stderr.write(`ai task cat: ${e.message}\n`);
32
+ process.exitCode = 1;
33
+ return;
34
+ }
35
+ process.stdout.write(fs.readFileSync(artifactPath, 'utf8'));
36
+ }
37
+ export { cat };
38
+ //# sourceMappingURL=cat.js.map
@@ -0,0 +1,47 @@
1
+ import { formatTable } from "../../table.js";
2
+ import { resolveTaskRef } from "../resolve-ref.js";
3
+ import { enumerateArtifacts } from "../artifacts.js";
4
+ const USAGE = `Usage: ai task files <N | #N | TASK-id>
5
+
6
+ Lists the artifacts in a task directory with stable numbers.
7
+ <ref> Bare numeric / '#N' short id, or a full TASK-YYYYMMDD-HHMMSS id.
8
+
9
+ Columns: # (artifact number, usable with 'ai task cat') / NAME / SIZE (bytes) / MTIME
10
+ `;
11
+ const TABLE_HEADERS = ['#', 'NAME', 'SIZE', 'MTIME'];
12
+ function pad2(n) {
13
+ return String(n).padStart(2, '0');
14
+ }
15
+ function formatMtime(mtimeMs) {
16
+ const d = new Date(mtimeMs);
17
+ return (`${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())} ` +
18
+ `${pad2(d.getHours())}:${pad2(d.getMinutes())}:${pad2(d.getSeconds())}`);
19
+ }
20
+ function files(args = []) {
21
+ if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
22
+ process.stdout.write(USAGE);
23
+ if (args.length === 0)
24
+ process.exitCode = 1;
25
+ return;
26
+ }
27
+ const resolved = resolveTaskRef(args[0]);
28
+ if (!resolved.ok) {
29
+ process.stderr.write(`ai task files: ${resolved.message}\n`);
30
+ process.exitCode = 1;
31
+ return;
32
+ }
33
+ const artifacts = enumerateArtifacts(resolved.taskDir);
34
+ // Show the name without the `.md` suffix so the NAME column is exactly what
35
+ // `ai task cat <ref> <name>` accepts (the resolver re-adds `.md`).
36
+ const rows = artifacts.map((a) => [
37
+ String(a.index),
38
+ a.name.replace(/\.md$/, ''),
39
+ String(a.size),
40
+ formatMtime(a.mtimeMs)
41
+ ]);
42
+ for (const line of formatTable(TABLE_HEADERS, rows, { zebra: Boolean(process.stdout.isTTY) })) {
43
+ process.stdout.write(`${line}\n`);
44
+ }
45
+ }
46
+ export { files };
47
+ //# sourceMappingURL=files.js.map
@@ -0,0 +1,143 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { resolveTaskRef, detectRepoRoot, enumerateTaskDirs } from "../resolve-ref.js";
4
+ import { enumerateArtifacts, resolveArtifact } from "../artifacts.js";
5
+ import { loadShortIdByTaskId } from "../short-id.js";
6
+ const USAGE = `Usage: ai task grep <pattern> [ref] [artifact | N]
7
+
8
+ Literal (non-regex) line search across task artifacts.
9
+ <pattern> Literal substring to match (NOT a regex). Case-sensitive by default.
10
+ [ref] Bare numeric / '#N' short id, or a full TASK-YYYYMMDD-HHMMSS id.
11
+ Omit to scan every task under active / blocked / completed
12
+ (archive is skipped). With a ref, narrows to that single task
13
+ (a TASK-id ref can also resolve an archived task).
14
+ [artifact | N] Only valid with <ref>. Artifact filename (with or without '.md')
15
+ or the number from 'ai task files'. Narrows to a single artifact.
16
+
17
+ Options:
18
+ -i, --ignore-case Case-insensitive matching.
19
+ -- Treat the rest as positional (use for patterns starting with '-').
20
+
21
+ Output: '{taskId} [#short] {fileStem}:{line}: {matched-line}' (short id only for active tasks).
22
+ Exits 1 with no output when nothing matches.
23
+ `;
24
+ function makeMatcher(pattern, ignoreCase) {
25
+ if (ignoreCase) {
26
+ const needle = pattern.toLowerCase();
27
+ return (line) => line.toLowerCase().includes(needle);
28
+ }
29
+ return (line) => line.includes(pattern);
30
+ }
31
+ // Split content into lines with grep-like semantics: a trailing newline does
32
+ // not yield a phantom final empty line, but genuine interior blank lines stay.
33
+ function splitLines(content) {
34
+ const lines = content.split(/\r?\n/);
35
+ if (lines.length > 0 && lines[lines.length - 1] === '')
36
+ lines.pop();
37
+ return lines;
38
+ }
39
+ function scanArtifact(taskId, shortToken, artifactPath, matcher, emit) {
40
+ const content = fs.readFileSync(artifactPath, 'utf8');
41
+ const stem = path.basename(artifactPath).replace(/\.md$/, '');
42
+ const prefix = shortToken ? `${taskId} ${shortToken}` : taskId;
43
+ let count = 0;
44
+ splitLines(content).forEach((line, i) => {
45
+ if (matcher(line)) {
46
+ emit(`${prefix} ${stem}:${i + 1}: ${line}\n`);
47
+ count++;
48
+ }
49
+ });
50
+ return count;
51
+ }
52
+ function grep(args = []) {
53
+ const positional = [];
54
+ let ignoreCase = false;
55
+ let optsEnded = false;
56
+ for (const a of args) {
57
+ if (!optsEnded && a === '--') {
58
+ optsEnded = true;
59
+ continue;
60
+ }
61
+ if (!optsEnded && (a === '-h' || a === '--help')) {
62
+ process.stdout.write(USAGE);
63
+ return;
64
+ }
65
+ if (!optsEnded && (a === '-i' || a === '--ignore-case')) {
66
+ ignoreCase = true;
67
+ continue;
68
+ }
69
+ if (!optsEnded && a.startsWith('-') && a !== '-') {
70
+ process.stderr.write(`ai task grep: unknown flag: ${a}\n`);
71
+ process.exitCode = 1;
72
+ return;
73
+ }
74
+ positional.push(a);
75
+ }
76
+ if (positional.length === 0) {
77
+ process.stdout.write(USAGE);
78
+ process.exitCode = 1;
79
+ return;
80
+ }
81
+ if (positional.length > 3) {
82
+ process.stderr.write('ai task grep: too many arguments\n');
83
+ process.exitCode = 1;
84
+ return;
85
+ }
86
+ const [pattern, ref, artifactOrN] = positional;
87
+ const matcher = makeMatcher(pattern, ignoreCase);
88
+ const chunks = [];
89
+ const emit = (line) => chunks.push(line);
90
+ let total = 0;
91
+ if (ref === undefined) {
92
+ // No ref: full scan across active / blocked / completed (no archive).
93
+ let repoRoot;
94
+ try {
95
+ repoRoot = detectRepoRoot();
96
+ }
97
+ catch (e) {
98
+ process.stderr.write(`ai task grep: ${e.message}\n`);
99
+ process.exitCode = 1;
100
+ return;
101
+ }
102
+ const shortMap = loadShortIdByTaskId(repoRoot);
103
+ for (const { taskId, taskDir } of enumerateTaskDirs(repoRoot)) {
104
+ const shortToken = shortMap.get(taskId);
105
+ for (const a of enumerateArtifacts(taskDir)) {
106
+ total += scanArtifact(taskId, shortToken, a.path, matcher, emit);
107
+ }
108
+ }
109
+ }
110
+ else {
111
+ const resolved = resolveTaskRef(ref);
112
+ if (!resolved.ok) {
113
+ process.stderr.write(`ai task grep: ${resolved.message}\n`);
114
+ process.exitCode = 1;
115
+ return;
116
+ }
117
+ const shortToken = loadShortIdByTaskId(resolved.repoRoot).get(resolved.taskId);
118
+ if (artifactOrN !== undefined) {
119
+ let artifactPath;
120
+ try {
121
+ artifactPath = resolveArtifact(resolved.taskDir, artifactOrN);
122
+ }
123
+ catch (e) {
124
+ process.stderr.write(`ai task grep: ${e.message}\n`);
125
+ process.exitCode = 1;
126
+ return;
127
+ }
128
+ total += scanArtifact(resolved.taskId, shortToken, artifactPath, matcher, emit);
129
+ }
130
+ else {
131
+ for (const a of enumerateArtifacts(resolved.taskDir)) {
132
+ total += scanArtifact(resolved.taskId, shortToken, a.path, matcher, emit);
133
+ }
134
+ }
135
+ }
136
+ if (total === 0) {
137
+ process.exitCode = 1;
138
+ return;
139
+ }
140
+ process.stdout.write(chunks.join(''));
141
+ }
142
+ export { grep };
143
+ //# sourceMappingURL=grep.js.map
@@ -0,0 +1,75 @@
1
+ import fs from 'node:fs';
2
+ import { formatTable } from "../../table.js";
3
+ import { resolveTaskRef } from "../resolve-ref.js";
4
+ const USAGE = `Usage: ai task log <N | #N | TASK-id>
5
+
6
+ Renders a task's activity log as a chronological timeline table.
7
+ <ref> Bare numeric / '#N' short id, or a full TASK-YYYYMMDD-HHMMSS id.
8
+
9
+ Columns: # (timeline position) / TIME / STEP / AGENT / NOTE
10
+ `;
11
+ const TABLE_HEADERS = ['#', 'TIME', 'STEP', 'AGENT', 'NOTE'];
12
+ // The activity-log H2 heading is language-dependent (zh template / en template).
13
+ const HEADING_RE = /^##\s+(活动日志|Activity Log)\s*$/;
14
+ const NEXT_H2_RE = /^##\s/;
15
+ // `- {time} — **{step}** by {agent} — {note}` ; the separator is an em-dash
16
+ // (U+2014). STEP/AGENT are non-greedy so a note that itself contains ' — ' or
17
+ // '→' is not mis-split; NOTE greedily takes the rest of the line.
18
+ const ENTRY_RE = /^- (\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}[+-]\d{2}:\d{2}) — \*\*(.+?)\*\* by (.+?) — (.*)$/;
19
+ function parseActivityLog(content) {
20
+ const lines = content.split('\n');
21
+ let i = 0;
22
+ while (i < lines.length && !HEADING_RE.test(lines[i]))
23
+ i += 1;
24
+ if (i >= lines.length)
25
+ return { sectionFound: false, entries: [] };
26
+ const parsed = [];
27
+ for (let j = i + 1; j < lines.length; j += 1) {
28
+ if (NEXT_H2_RE.test(lines[j]))
29
+ break;
30
+ const m = ENTRY_RE.exec(lines[j]);
31
+ if (!m)
32
+ continue; // skip blank / non-entry / malformed lines
33
+ parsed.push({
34
+ entry: { time: m[1], step: m[2], agent: m[3], note: m[4] },
35
+ epoch: Date.parse(m[1].replace(' ', 'T')),
36
+ order: parsed.length
37
+ });
38
+ }
39
+ // Ascending by time; stable tie-break on original order for equal timestamps.
40
+ parsed.sort((a, b) => a.epoch - b.epoch || a.order - b.order);
41
+ return { sectionFound: true, entries: parsed.map((p) => p.entry) };
42
+ }
43
+ function log(args = []) {
44
+ if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
45
+ process.stdout.write(USAGE);
46
+ if (args.length === 0)
47
+ process.exitCode = 1;
48
+ return;
49
+ }
50
+ const resolved = resolveTaskRef(args[0]);
51
+ if (!resolved.ok) {
52
+ process.stderr.write(`ai task log: ${resolved.message}\n`);
53
+ process.exitCode = 1;
54
+ return;
55
+ }
56
+ const content = fs.readFileSync(resolved.taskMdPath, 'utf8');
57
+ const { sectionFound, entries } = parseActivityLog(content);
58
+ if (!sectionFound) {
59
+ process.stderr.write(`ai task log: no activity log section ('## 活动日志' or '## Activity Log') found in task ${resolved.taskId}\n`);
60
+ process.exitCode = 1;
61
+ return;
62
+ }
63
+ if (entries.length === 0) {
64
+ process.stderr.write(`ai task log: no activity log entries found in task ${resolved.taskId}\n`);
65
+ process.exitCode = 1;
66
+ return;
67
+ }
68
+ const rows = entries.map((e, idx) => [String(idx + 1), e.time, e.step, e.agent, e.note]);
69
+ for (const line of formatTable(TABLE_HEADERS, rows, { zebra: Boolean(process.stdout.isTTY) })) {
70
+ process.stdout.write(`${line}\n`);
71
+ }
72
+ process.stdout.write(`Total: ${entries.length} entries\n`);
73
+ }
74
+ export { log, parseActivityLog };
75
+ //# sourceMappingURL=log.js.map
@@ -113,7 +113,7 @@ function ls(args = []) {
113
113
  r.branch,
114
114
  r.title
115
115
  ]);
116
- for (const line of formatTable(TABLE_HEADERS, tableRows)) {
116
+ for (const line of formatTable(TABLE_HEADERS, tableRows, { zebra: Boolean(process.stdout.isTTY) })) {
117
117
  process.stdout.write(`${line}\n`);
118
118
  }
119
119
  process.stdout.write(`Total: ${rows.length} tasks\n`);
@@ -1,7 +1,5 @@
1
1
  import fs from 'node:fs';
2
- import path from 'node:path';
3
- import { execFileSync, spawnSync } from 'node:child_process';
4
- import { normalizeShortIdInput } from "../short-id.js";
2
+ import { resolveTaskRef } from "../resolve-ref.js";
5
3
  const USAGE = `Usage: ai task show <N | #N | TASK-id>
6
4
 
7
5
  Prints the task.md content for the matching task.
@@ -9,84 +7,6 @@ Prints the task.md content for the matching task.
9
7
  '#N' Compatibility form for old commands.
10
8
  TASK-YYYYMMDD-HHMMSS Locates a task in active / blocked / completed / archive.
11
9
  `;
12
- const TASK_ID_RE = /^TASK-\d{8}-\d{6}$/;
13
- // Flat-structured workspace dirs that hold tasks under `{dir}/{taskId}/task.md`.
14
- // Note: `archive` uses a three-level YYYY/MM/DD layout and is handled separately.
15
- const FLAT_WORKSPACE_DIRS = ['active', 'blocked', 'completed'];
16
- function detectRepoRoot() {
17
- try {
18
- return execFileSync('git', ['rev-parse', '--show-toplevel'], {
19
- encoding: 'utf8',
20
- stdio: ['pipe', 'pipe', 'pipe']
21
- }).trim();
22
- }
23
- catch {
24
- throw new Error('ai task: current directory is not inside a git repository');
25
- }
26
- }
27
- function readShortIdLength(repoRoot) {
28
- try {
29
- const cfg = JSON.parse(fs.readFileSync(path.join(repoRoot, '.agents', '.airc.json'), 'utf8'));
30
- const v = cfg?.task?.shortIdLength;
31
- if (typeof v === 'number' && Number.isFinite(v) && v >= 1)
32
- return v;
33
- }
34
- catch {
35
- // fall through to default
36
- }
37
- return 2;
38
- }
39
- function resolveShortIdToTaskId(arg, repoRoot) {
40
- const scriptPath = path.join(repoRoot, '.agents', 'scripts', 'task-short-id.js');
41
- if (!fs.existsSync(scriptPath)) {
42
- throw new Error(`task-short-id.js not found at ${scriptPath}`);
43
- }
44
- const result = spawnSync('node', [scriptPath, 'resolve', arg], {
45
- encoding: 'utf8',
46
- cwd: repoRoot
47
- });
48
- if (result.status !== 0) {
49
- throw new Error((result.stderr || '').trim() || `failed to resolve '${arg}'`);
50
- }
51
- return result.stdout.trim();
52
- }
53
- function listSortedNumeric(dir, width) {
54
- if (!fs.existsSync(dir))
55
- return [];
56
- const pattern = new RegExp(`^\\d{${width}}$`);
57
- return fs
58
- .readdirSync(dir)
59
- .filter((entry) => pattern.test(entry))
60
- .sort()
61
- .reverse();
62
- }
63
- function findInArchive(repoRoot, taskId) {
64
- // archive-tasks SKILL writes to .agents/workspace/archive/YYYY/MM/DD/{taskId}/task.md
65
- // where YYYY/MM/DD comes from completed_at (or updated_at fallback) — NOT from
66
- // the task id's creation date. So we cannot derive the path from taskId alone;
67
- // walk the bounded YYYY/MM/DD tree instead. Newest-first to favor recent archives.
68
- const archiveDir = path.join(repoRoot, '.agents', 'workspace', 'archive');
69
- for (const year of listSortedNumeric(archiveDir, 4)) {
70
- const yearDir = path.join(archiveDir, year);
71
- for (const month of listSortedNumeric(yearDir, 2)) {
72
- const monthDir = path.join(yearDir, month);
73
- for (const day of listSortedNumeric(monthDir, 2)) {
74
- const candidate = path.join(monthDir, day, taskId, 'task.md');
75
- if (fs.existsSync(candidate))
76
- return candidate;
77
- }
78
- }
79
- }
80
- return null;
81
- }
82
- function findTaskMd(repoRoot, taskId) {
83
- for (const sub of FLAT_WORKSPACE_DIRS) {
84
- const candidate = path.join(repoRoot, '.agents', 'workspace', sub, taskId, 'task.md');
85
- if (fs.existsSync(candidate))
86
- return candidate;
87
- }
88
- return findInArchive(repoRoot, taskId);
89
- }
90
10
  function show(args = []) {
91
11
  if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
92
12
  process.stdout.write(USAGE);
@@ -94,42 +14,13 @@ function show(args = []) {
94
14
  process.exitCode = 1;
95
15
  return;
96
16
  }
97
- const repoRoot = detectRepoRoot();
98
- const arg = args[0];
99
- let taskId;
100
- if (TASK_ID_RE.test(arg)) {
101
- taskId = arg;
102
- }
103
- else {
104
- const shortIdLength = readShortIdLength(repoRoot);
105
- const normalized = normalizeShortIdInput(arg, { shortIdLength });
106
- if (normalized.kind === 'error') {
107
- process.stderr.write(`ai task show: ${normalized.message}\n`);
108
- process.exitCode = 1;
109
- return;
110
- }
111
- if (normalized.kind === 'pass') {
112
- process.stderr.write(`ai task show: '${arg}' is not a valid short id or TASK-id; ` +
113
- `expected bare digits, '#N', or 'TASK-YYYYMMDD-HHMMSS'\n`);
114
- process.exitCode = 1;
115
- return;
116
- }
117
- try {
118
- taskId = resolveShortIdToTaskId(normalized.value, repoRoot);
119
- }
120
- catch (e) {
121
- process.stderr.write(`ai task show: ${e.message}\n`);
122
- process.exitCode = 1;
123
- return;
124
- }
125
- }
126
- const taskMdPath = findTaskMd(repoRoot, taskId);
127
- if (!taskMdPath) {
128
- process.stderr.write(`ai task show: task ${taskId} not found in active / blocked / completed / archive\n`);
17
+ const resolved = resolveTaskRef(args[0]);
18
+ if (!resolved.ok) {
19
+ process.stderr.write(`ai task show: ${resolved.message}\n`);
129
20
  process.exitCode = 1;
130
21
  return;
131
22
  }
132
- process.stdout.write(fs.readFileSync(taskMdPath, 'utf8'));
23
+ process.stdout.write(fs.readFileSync(resolved.taskMdPath, 'utf8'));
133
24
  }
134
25
  export { show };
135
26
  //# sourceMappingURL=show.js.map