specdojo 0.3.1 → 0.4.0

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 (241) hide show
  1. package/CHANGELOG.md +47 -0
  2. package/README.md +77 -18
  3. package/dist/{catalog-build-references.js → catalog/build-references.js} +4 -4
  4. package/dist/catalog/build-render.js +32 -0
  5. package/dist/{catalog-build.js → catalog/build.js} +9 -9
  6. package/dist/{catalog.js → catalog/catalog.js} +10 -10
  7. package/dist/{catalog-generate.js → catalog/generate.js} +8 -8
  8. package/dist/catalog/paths.js +1 -0
  9. package/dist/{catalog-plan-generate.js → catalog/plan-generate.js} +4 -4
  10. package/dist/{catalog-plan.js → catalog/plan.js} +4 -4
  11. package/dist/{catalog-scaffold.js → catalog/scaffold.js} +3 -3
  12. package/dist/{agent.js → commands/agent.js} +11 -11
  13. package/dist/{build-command.js → commands/build.js} +2 -2
  14. package/dist/{init-command.js → commands/init.js} +98 -32
  15. package/dist/{orchestrator.js → commands/orchestrator.js} +2 -2
  16. package/dist/{watch.js → commands/watch.js} +3 -3
  17. package/dist/{dashboard-timeline.js → dashboard/dashboard-timeline.js} +2 -2
  18. package/dist/{dashboard.js → dashboard/dashboard.js} +11 -10
  19. package/dist/{dashboard-exec-records.js → dashboard/exec-records.js} +2 -2
  20. package/dist/{dashboard-routines.js → dashboard/routines.js} +6 -5
  21. package/dist/{dashboard-shared.js → dashboard/shared.js} +1 -1
  22. package/dist/{timeline-build.js → dashboard/timeline-build.js} +2 -1
  23. package/dist/{timeline.js → dashboard/timeline.js} +1 -1
  24. package/dist/{deliverable.js → deliverable/deliverable.js} +5 -5
  25. package/dist/{deliverable-trash.js → deliverable/trash.js} +5 -5
  26. package/dist/{devcontainer-command.js → devcontainer/command.js} +5 -3
  27. package/dist/{devcontainer-scaffold.js → devcontainer/scaffold.js} +94 -2
  28. package/dist/{doc-index.js → docs/doc-index.js} +1 -1
  29. package/dist/{frontmatter-namespace.js → docs/frontmatter-namespace.js} +1 -1
  30. package/dist/{index-command.js → docs/index-command.js} +1 -1
  31. package/dist/docs/template-resolution.js +1 -0
  32. package/dist/{viewpoint-document-kinds-check.js → docs/viewpoint-document-kinds-check.js} +1 -1
  33. package/dist/{yaml-pages-command.js → docs/yaml-pages-command.js} +1 -1
  34. package/dist/{yaml-pages.js → docs/yaml-pages.js} +2 -2
  35. package/dist/{exec-agent-config.js → exec/agent-config.js} +33 -4
  36. package/dist/{exec-agent-git-state.js → exec/agent-git-state.js} +1 -1
  37. package/dist/{exec-agent-protected-config.js → exec/agent-protected-config.js} +1 -1
  38. package/dist/{exec-commands.js → exec/commands.js} +22 -18
  39. package/dist/{exec-core.js → exec/core.js} +11 -11
  40. package/dist/{exec-events.js → exec/events.js} +2 -2
  41. package/dist/{exec-evidence.js → exec/evidence.js} +11 -6
  42. package/dist/exec/exec.js +2 -0
  43. package/dist/exec/format.js +1 -0
  44. package/dist/{exec-handoff.js → exec/handoff.js} +13 -12
  45. package/dist/{exec-limit.js → exec/limit.js} +93 -12
  46. package/dist/{exec-parent-validation.js → exec/parent-validation.js} +4 -4
  47. package/dist/{exec-pipeline-state.js → exec/pipeline-state.js} +16 -2
  48. package/dist/{exec-plans-core.js → exec/plans-core.js} +68 -114
  49. package/dist/{exec-plans-generation.js → exec/plans-generation.js} +53 -10
  50. package/dist/{exec-plans-storage.js → exec/plans-storage.js} +5 -5
  51. package/dist/{exec-plans.js → exec/plans.js} +3 -3
  52. package/dist/{exec-project.js → exec/project.js} +1 -1
  53. package/dist/{exec-protection-handoff.js → exec/protection-handoff.js} +3 -3
  54. package/dist/{exec-register-resume.js → exec/register-resume.js} +2 -2
  55. package/dist/{exec-register.js → exec/register.js} +92 -9
  56. package/dist/{exec-repo-integration-git.js → exec/repo-integration-git.js} +2 -2
  57. package/dist/{exec-repo-integration-sync.js → exec/repo-integration-sync.js} +4 -4
  58. package/dist/{exec-repo-integration.js → exec/repo-integration.js} +13 -10
  59. package/dist/{exec-repo-trace.js → exec/repo-trace.js} +3 -3
  60. package/dist/{exec-reporter-output.js → exec/reporter-output.js} +2 -2
  61. package/dist/{exec-reporter.js → exec/reporter.js} +29 -12
  62. package/dist/{exec-results.js → exec/results.js} +256 -22
  63. package/dist/{exec-run-agent-pipeline.js → exec/run/agent-pipeline.js} +32 -12
  64. package/dist/{exec-run-agent.js → exec/run/agent.js} +79 -27
  65. package/dist/{exec-run-in-place.js → exec/run/in-place.js} +56 -27
  66. package/dist/{exec-run-job.js → exec/run/job.js} +64 -35
  67. package/dist/{exec-run-lifecycle-commands.js → exec/run/lifecycle-commands.js} +30 -22
  68. package/dist/{exec-run-lock.js → exec/run/lock.js} +4 -3
  69. package/dist/{exec-run-mode-shared.js → exec/run/mode-shared.js} +3 -3
  70. package/dist/{exec-run-register-command.js → exec/run/register-command.js} +18 -10
  71. package/dist/{exec-run-register-core.js → exec/run/register-core.js} +46 -21
  72. package/dist/{exec-run-register-mode.js → exec/run/register-mode.js} +20 -16
  73. package/dist/{exec-run-register-resume.js → exec/run/register-resume.js} +22 -17
  74. package/dist/{exec-run-register-state.js → exec/run/register-state.js} +13 -10
  75. package/dist/{exec-run-register-worktree.js → exec/run/register-worktree.js} +54 -23
  76. package/dist/{exec-run.js → exec/run/run.js} +11 -11
  77. package/dist/{exec-run-schedule-mode.js → exec/run/schedule-mode.js} +17 -17
  78. package/dist/{exec-run-schedule-prepare.js → exec/run/schedule-prepare.js} +31 -18
  79. package/dist/{exec-run-schedule-task.js → exec/run/schedule-task.js} +45 -18
  80. package/dist/{exec-run-shared.js → exec/run/shared.js} +61 -11
  81. package/dist/{exec-schedule-calendar.js → exec/schedule/calendar.js} +1 -1
  82. package/dist/{exec-schedule-cpm.js → exec/schedule/cpm.js} +2 -2
  83. package/dist/{exec-schedule-gantt-chart-render.js → exec/schedule/gantt-chart-render.js} +2 -2
  84. package/dist/exec/schedule/gantt-chart.js +2 -0
  85. package/dist/{exec-schedule-hash.js → exec/schedule/hash.js} +2 -2
  86. package/dist/exec/schedule/index.js +1 -0
  87. package/dist/{exec-schedule-initial.js → exec/schedule/initial.js} +2 -2
  88. package/dist/{exec-schedule-progress.js → exec/schedule/progress.js} +2 -2
  89. package/dist/{exec-schedule-ready.js → exec/schedule/ready.js} +2 -2
  90. package/dist/{exec-schedule.js → exec/schedule/schedule.js} +11 -11
  91. package/dist/exec/shared.js +63 -0
  92. package/dist/exec/slot-lock.js +1 -0
  93. package/dist/{exec-strategy.js → exec/strategy.js} +2 -2
  94. package/dist/{exec-task-repos.js → exec/task-repos.js} +2 -2
  95. package/dist/{exec-task-view.js → exec/task-view.js} +4 -4
  96. package/dist/{exec-trial-commands.js → exec/trial-commands.js} +20 -22
  97. package/dist/{exec-trial-core.js → exec/trial-core.js} +6 -6
  98. package/dist/{exec-trial.js → exec/trial.js} +2 -2
  99. package/dist/{exec-worktree-command.js → exec/worktree-command.js} +25 -23
  100. package/dist/{exec-worktree-ops-commit.js → exec/worktree-ops-commit.js} +25 -60
  101. package/dist/{exec-worktree-ops-lifecycle.js → exec/worktree-ops-lifecycle.js} +13 -8
  102. package/dist/{exec-worktree-ops-merge.js → exec/worktree-ops-merge.js} +48 -7
  103. package/dist/{exec-worktree-ops.js → exec/worktree-ops.js} +3 -3
  104. package/dist/exec/worktree.js +305 -0
  105. package/dist/{grade-apply.js → grade/apply.js} +9 -9
  106. package/dist/{grade-command-apply.js → grade/command-apply.js} +7 -7
  107. package/dist/{grade-command-inspect.js → grade/command-inspect.js} +6 -6
  108. package/dist/{grade-command-plan.js → grade/command-plan.js} +5 -5
  109. package/dist/{grade-core.js → grade/core.js} +3 -3
  110. package/dist/grade/grade.js +19 -0
  111. package/dist/{grade-markdown.js → grade/markdown.js} +6 -6
  112. package/dist/{grade-pipeline-state.js → grade/pipeline-state.js} +4 -4
  113. package/dist/{grade-plan.js → grade/plan.js} +5 -5
  114. package/dist/{grade-result.js → grade/result.js} +5 -94
  115. package/dist/{grade-target-discovery.js → grade/target-discovery.js} +7 -7
  116. package/dist/{grade-targets.js → grade/targets.js} +11 -8
  117. package/dist/{job-definition.js → job/definition.js} +25 -6
  118. package/dist/{job.js → job/job.js} +12 -11
  119. package/dist/{kata-command.js → kata/command.js} +3 -3
  120. package/dist/{kata.js → kata/kata.js} +5 -5
  121. package/dist/register/approach.js +134 -0
  122. package/dist/{register-core.js → register/core.js} +13 -7
  123. package/dist/{register-create-commands.js → register/create-commands.js} +115 -8
  124. package/dist/{register-date.js → register/date.js} +1 -1
  125. package/dist/register/derivation.js +163 -0
  126. package/dist/{register-event-merge.js → register/event-merge.js} +32 -3
  127. package/dist/{register-events.js → register/events.js} +9 -3
  128. package/dist/{register-history.js → register/history.js} +7 -6
  129. package/dist/{register-item.js → register/item.js} +23 -5
  130. package/dist/register/lifecycle-lock.js +5 -0
  131. package/dist/{register-maintenance-commands.js → register/maintenance-commands.js} +13 -7
  132. package/dist/{register-migrate-timestamps.js → register/migrate-timestamps.js} +3 -3
  133. package/dist/{register-migration.js → register/migration.js} +4 -4
  134. package/dist/{register.js → register/register.js} +32 -27
  135. package/dist/{register-renumber.js → register/renumber.js} +38 -11
  136. package/dist/{register-transition-commands.js → register/transition-commands.js} +3 -3
  137. package/dist/{register-update.js → register/update.js} +5 -5
  138. package/dist/{register-views.js → register/views.js} +47 -7
  139. package/dist/{review-grade.js → review/grade.js} +2 -2
  140. package/dist/{review-plan.js → review/plan.js} +3 -3
  141. package/dist/{routine-definition.js → routine/definition.js} +2 -2
  142. package/dist/{routine.js → routine/routine.js} +49 -22
  143. package/dist/{schedule-approach.js → schedule/approach.js} +8 -8
  144. package/dist/{schedule-build.js → schedule/build.js} +7 -4
  145. package/dist/{schedule.js → schedule/schedule.js} +6 -6
  146. package/dist/{schedule-strategy-generate-document.js → schedule/strategy-generate-document.js} +2 -2
  147. package/dist/{schedule-strategy-generate-scope.js → schedule/strategy-generate-scope.js} +4 -4
  148. package/dist/{schedule-strategy-generate.js → schedule/strategy-generate.js} +10 -10
  149. package/dist/shared/agent-types.js +23 -0
  150. package/dist/shared/artifact-path.js +9 -0
  151. package/dist/{build-if-stale.js → shared/build-if-stale.js} +1 -1
  152. package/dist/{catalog-build-render.js → shared/catalog-render.js} +3 -32
  153. package/dist/{exec-slot-lock.js → shared/cross-process-lock.js} +3 -1
  154. package/dist/shared/fs.js +30 -0
  155. package/dist/{exec-worktree.js → shared/git.js} +83 -241
  156. package/dist/shared/grade-result.js +94 -0
  157. package/dist/{package-paths.js → shared/package-paths.js} +3 -3
  158. package/dist/shared/plan-templates.js +114 -0
  159. package/dist/{exec-provider-scaffold.js → shared/provider-scaffold.js} +3 -1
  160. package/dist/shared/random.js +4 -0
  161. package/dist/{exec-schedule-index.js → shared/schedule-index.js} +3 -1
  162. package/dist/shared/schedule-paths.js +9 -0
  163. package/dist/{specdojo-config.js → shared/specdojo-config.js} +93 -5
  164. package/dist/{exec-shared.js → shared/text.js} +0 -134
  165. package/dist/shared/time.js +28 -0
  166. package/dist/specdojo.js +22 -22
  167. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +29 -17
  168. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +1 -2
  169. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -2
  170. package/docs/ja/specdojo/exec-templates/xer-template.md +1 -3
  171. package/docs/ja/specdojo/exec-templates/xrp-job-template.md +6 -4
  172. package/docs/ja/specdojo/guides/exec-config-guide.md +91 -16
  173. package/docs/ja/specdojo/guides/exec-operation-guide.md +145 -12
  174. package/docs/ja/specdojo/guides/exec-worktree-guide.md +2 -0
  175. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +31 -0
  176. package/docs/ja/specdojo/guides/quick-start-guide.md +81 -16
  177. package/docs/ja/specdojo/guides/register-operation-guide.md +2 -1
  178. package/docs/ja/specdojo/guides/remote-host-development-guide.md +10 -1
  179. package/docs/ja/specdojo/guides/review-guide.md +1 -1
  180. package/docs/ja/specdojo/guides/routine-operation-guide.md +5 -5
  181. package/docs/ja/specdojo/guides/use-case-guide.md +1 -1
  182. package/docs/ja/specdojo/references/command-reference.md +52 -28
  183. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +17 -11
  184. package/docs/ja/specdojo/standards/job-definition-standard.md +20 -18
  185. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -2
  186. package/docs/ja/specdojo/templates/pjr-derived-items-template.md +22 -0
  187. package/docs/ja/specdojo/templates/pjr-index-template.md +1 -0
  188. package/docs/specdojo/schemas/v1/agent-members.schema.yaml +29 -2
  189. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +20 -0
  190. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +23 -0
  191. package/docs/specdojo/schemas/v1/job-run.schema.yaml +2 -2
  192. package/docs/specdojo/schemas/v1/job.schema.yaml +7 -0
  193. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +26 -0
  194. package/docs/specdojo/schemas/v1/register-events.schema.yaml +3 -0
  195. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +70 -7
  196. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +1 -1
  197. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -1
  198. package/package.json +1 -1
  199. package/templates/antigravity/README.md +5 -1
  200. package/templates/antigravity/agent-members-snippet.yaml +108 -12
  201. package/templates/antigravity/exec-defaults-snippet.yaml +8 -13
  202. package/templates/claude/README.md +27 -3
  203. package/templates/claude/agents/claude-executor.md +0 -1
  204. package/templates/claude/agents/claude-reporter.md +2 -1
  205. package/templates/claude/agents/claude-review-executor.md +0 -1
  206. package/templates/codex/README.md +23 -4
  207. package/templates/devcontainer/devcontainer.json +2 -2
  208. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +69 -0
  209. package/templates/devcontainer/remote-host/ssh-config.sample +16 -0
  210. package/templates/init-agent-members.yaml +75 -25
  211. package/templates/init-exec-defaults.yaml +24 -8
  212. package/templates/opencode/README.md +17 -3
  213. package/templates/opencode/agents/opencode-executor.md +0 -1
  214. package/templates/opencode/agents/opencode-reporter.md +2 -1
  215. package/templates/opencode/agents/opencode-review-executor.md +0 -1
  216. package/dist/exec-schedule-gantt-chart.js +0 -2
  217. package/dist/exec.js +0 -2
  218. package/dist/grade.js +0 -19
  219. package/templates/claude/agents/claude-expert-review-executor.md +0 -14
  220. /package/dist/{catalog-plan-prompt.js → catalog/plan-prompt.js} +0 -0
  221. /package/dist/{catalog-types.js → catalog/types.js} +0 -0
  222. /package/dist/{template-frontmatter.js → docs/template-frontmatter.js} +0 -0
  223. /package/dist/{role-types.js → exec/role-types.js} +0 -0
  224. /package/dist/{exec-schedule-gantt-chart-scope.js → exec/schedule/gantt-chart-scope.js} +0 -0
  225. /package/dist/{exec-types.js → exec/types.js} +0 -0
  226. /package/dist/{grade-command-shared.js → grade/command-shared.js} +0 -0
  227. /package/dist/{register-command-types.js → register/command-types.js} +0 -0
  228. /package/dist/{review-types.js → review/types.js} +0 -0
  229. /package/dist/{schedule-phase-sets.js → schedule/phase-sets.js} +0 -0
  230. /package/dist/{schedule-strategy-profiles.js → schedule/strategy-profiles.js} +0 -0
  231. /package/dist/{agent-response.js → shared/agent-response.js} +0 -0
  232. /package/dist/{catalog-paths.js → shared/catalog-paths.js} +0 -0
  233. /package/dist/{dist-freshness.js → shared/dist-freshness.js} +0 -0
  234. /package/dist/{git-environment.js → shared/git-environment.js} +0 -0
  235. /package/dist/{exec-format.js → shared/markdown-format.js} +0 -0
  236. /package/dist/{practice-id.js → shared/practice-id.js} +0 -0
  237. /package/dist/{spawn-self.js → shared/spawn-self.js} +0 -0
  238. /package/dist/{specdojo-gitignore.js → shared/specdojo-gitignore.js} +0 -0
  239. /package/dist/{template-resolution.js → shared/template-resolution.js} +0 -0
  240. /package/dist/{yaml-schema-modeline.js → shared/yaml-schema-modeline.js} +0 -0
  241. /package/dist/{yaml.js → shared/yaml.js} +0 -0
@@ -0,0 +1,163 @@
1
+ import { existsSync } from "node:fs";
2
+ import { resolve } from "node:path";
3
+ import { getProjectRegisterPath, loadConfig, specdojoRootDir, } from "../shared/specdojo-config.js";
4
+ import { loadRegisterItemDocs, PJR_ID_RE } from "./item.js";
5
+ const QUALIFIED_REGISTER_ITEM_REF_RE = /^([a-z][a-z0-9-]*):(PJR-[0-9ABCDEFGHJKMNPQRSTVWXYZ]{4})$/;
6
+ export function parseRegisterItemRef(value, currentProjectId) {
7
+ if (PJR_ID_RE.test(value))
8
+ return { projectId: currentProjectId, itemId: value };
9
+ const match = QUALIFIED_REGISTER_ITEM_REF_RE.exec(value);
10
+ return match ? { projectId: match[1], itemId: match[2] } : undefined;
11
+ }
12
+ export function normalizeDerivedFrom(values, options) {
13
+ if (values === undefined)
14
+ return undefined;
15
+ const refs = [...new Set(values.map((value) => value.trim()).filter(Boolean))];
16
+ if (refs.includes("-")) {
17
+ if (!options.allowRemove)
18
+ throw new Error("--from - is only valid with register update");
19
+ if (refs.length !== 1)
20
+ throw new Error("--from - cannot be combined with other item IDs");
21
+ return undefined;
22
+ }
23
+ if (refs.length === 0)
24
+ throw new Error("--from must contain a register item ID");
25
+ return refs;
26
+ }
27
+ function configuredItemIds(config, projectId) {
28
+ const project = config.projects[projectId];
29
+ if (!project)
30
+ return undefined;
31
+ const registerPath = getProjectRegisterPath(project);
32
+ if (!registerPath) {
33
+ throw new Error(`Cannot verify derived_from item in configured project ${projectId}: project_register_path is not set`);
34
+ }
35
+ const absolutePath = resolve(specdojoRootDir(), registerPath);
36
+ return new Set(loadRegisterItemDocs(absolutePath).map((doc) => doc.id));
37
+ }
38
+ function validateDerivedFromWithConfig(opts, config, idsByProject) {
39
+ for (const ref of opts.derivedFrom) {
40
+ const parsed = parseRegisterItemRef(ref, opts.projectId);
41
+ if (!parsed) {
42
+ throw new Error(`Invalid --from item ID: "${ref}". Use PJR-XXXX or <project-id>:PJR-XXXX`);
43
+ }
44
+ if (parsed.projectId === opts.projectId && parsed.itemId === opts.itemId) {
45
+ throw new Error(`Item ${opts.itemId} cannot derive from itself`);
46
+ }
47
+ if (!config.projects[parsed.projectId])
48
+ continue;
49
+ let ids = idsByProject.get(parsed.projectId);
50
+ if (!idsByProject.has(parsed.projectId)) {
51
+ ids = configuredItemIds(config, parsed.projectId);
52
+ idsByProject.set(parsed.projectId, ids);
53
+ }
54
+ if (!ids?.has(parsed.itemId)) {
55
+ throw new Error(`Derived-from item not found: ${ref} (searched configured project ${parsed.projectId})`);
56
+ }
57
+ }
58
+ }
59
+ export function validateDerivedFrom(opts) {
60
+ if (!opts.derivedFrom)
61
+ return;
62
+ const { config } = loadConfig();
63
+ if (!config)
64
+ throw new Error("register commands require specdojo.config.json");
65
+ validateDerivedFromWithConfig({ ...opts, derivedFrom: opts.derivedFrom }, config, new Map());
66
+ }
67
+ export function validateDerivedFromDocs(paths) {
68
+ const docs = loadRegisterItemDocs(paths.projectRegisterPath);
69
+ const derivedDocs = docs.filter((doc) => doc.item.derivedFrom !== undefined);
70
+ if (derivedDocs.length === 0)
71
+ return [];
72
+ let config;
73
+ try {
74
+ ({ config } = loadConfig());
75
+ }
76
+ catch (error) {
77
+ return [`derived_from: ${error instanceof Error ? error.message : String(error)}`];
78
+ }
79
+ if (!config)
80
+ return ["derived_from: register commands require specdojo.config.json"];
81
+ const errors = [];
82
+ const idsByProject = new Map([
83
+ [paths.projectId, new Set(docs.map((doc) => doc.id))],
84
+ ]);
85
+ for (const doc of derivedDocs) {
86
+ try {
87
+ validateDerivedFromWithConfig({
88
+ projectId: paths.projectId,
89
+ itemId: doc.id,
90
+ derivedFrom: doc.item.derivedFrom,
91
+ }, config, idsByProject);
92
+ }
93
+ catch (error) {
94
+ errors.push(`${doc.filename}: ${error instanceof Error ? error.message : String(error)}`);
95
+ }
96
+ }
97
+ return errors;
98
+ }
99
+ function configuredExternalRegisterDirectories(paths) {
100
+ let config;
101
+ try {
102
+ ({ config } = loadConfig());
103
+ }
104
+ catch {
105
+ // `init --dry-run` may intentionally preserve an existing, non-SpecDojo config file.
106
+ // The current project can still produce an empty/local derivation view in that case.
107
+ return [];
108
+ }
109
+ if (!config)
110
+ return [];
111
+ const configuredCurrent = config.projects[paths.projectId];
112
+ const configuredCurrentPath = configuredCurrent
113
+ ? getProjectRegisterPath(configuredCurrent)
114
+ : undefined;
115
+ if (!configuredCurrentPath ||
116
+ resolve(specdojoRootDir(), configuredCurrentPath) !== resolve(paths.projectRegisterPath)) {
117
+ return [];
118
+ }
119
+ return Object.entries(config.projects).flatMap(([projectId, project]) => {
120
+ if (projectId === paths.projectId)
121
+ return [];
122
+ const registerPath = getProjectRegisterPath(project);
123
+ if (!registerPath)
124
+ return [];
125
+ const absolutePath = resolve(specdojoRootDir(), registerPath);
126
+ return existsSync(absolutePath) ? [{ projectId, registerPath: absolutePath }] : [];
127
+ });
128
+ }
129
+ export function collectDerivedRegisterRelations(paths, currentItems) {
130
+ const relations = [];
131
+ const collect = (projectId, items) => {
132
+ for (const item of items) {
133
+ for (const ref of item.item.derivedFrom ?? []) {
134
+ const source = parseRegisterItemRef(ref, projectId);
135
+ if (!source || source.projectId !== paths.projectId)
136
+ continue;
137
+ relations.push({
138
+ sourceId: source.itemId,
139
+ derivedProjectId: projectId,
140
+ derivedItem: item.item,
141
+ derivedTicketPath: item.ticketPath,
142
+ });
143
+ }
144
+ }
145
+ };
146
+ collect(paths.projectId, currentItems.flatMap((view) => view.ticketPath ? [{ item: view.item, ticketPath: view.ticketPath }] : []));
147
+ for (const project of configuredExternalRegisterDirectories(paths)) {
148
+ collect(project.projectId, loadRegisterItemDocs(project.registerPath).map((doc) => ({
149
+ item: doc.item,
150
+ ticketPath: doc.path,
151
+ })));
152
+ }
153
+ return relations.sort((left, right) => {
154
+ if (left.sourceId !== right.sourceId)
155
+ return left.sourceId < right.sourceId ? -1 : 1;
156
+ if (left.derivedProjectId !== right.derivedProjectId) {
157
+ return left.derivedProjectId < right.derivedProjectId ? -1 : 1;
158
+ }
159
+ if (left.derivedItem.id === right.derivedItem.id)
160
+ return 0;
161
+ return left.derivedItem.id < right.derivedItem.id ? -1 : 1;
162
+ });
163
+ }
@@ -1,9 +1,10 @@
1
1
  // 統合 merge で登録簿の記帳ファイルが競合したときの解決処理。イベントファイルは追記型の記録なので、
2
2
  // 両側のイベントの和集合(同一 id は 1 件)を時刻順に並べ、`previous_event_id` の連鎖を張り直す。
3
3
  // 個票は exec branch 側を基準にし、統合先だけにあるイベントが変えたフィールドのうち、frontmatter の
4
- // 単純な値へ写せるもの(type / priority / owner / due)だけをイベントから再構築する。
5
- import { readRegisterEventsFromContent, serializeRegisterEvents, } from "./register-events.js";
6
- import { applyRegisterItemFields, CELL_NONE, CELL_TODO, REMOVE_REGISTER_ITEM_FIELD, } from "./register-item.js";
4
+ // 単純な値へ写せるもの(type / priority / owner / due / approach / targets /
5
+ // derived_from)だけを再構築する。
6
+ import { readRegisterEventsFromContent, serializeRegisterEvents, } from "./events.js";
7
+ import { applyRegisterItemFields, CELL_NONE, CELL_TODO, REMOVE_REGISTER_ITEM_FIELD, } from "./item.js";
7
8
  function hasStatusChange(event) {
8
9
  return event.changes.some((change) => change.field === "status");
9
10
  }
@@ -136,6 +137,34 @@ function fieldUpdateFromChange(change) {
136
137
  ? null
137
138
  : value,
138
139
  };
140
+ case "approach":
141
+ return { approach: isUnset ? REMOVE_REGISTER_ITEM_FIELD : value };
142
+ case "targets": {
143
+ if (isUnset)
144
+ return { targets: REMOVE_REGISTER_ITEM_FIELD };
145
+ try {
146
+ const parsed = JSON.parse(value);
147
+ return Array.isArray(parsed) && parsed.every((target) => typeof target === "string")
148
+ ? { targets: parsed }
149
+ : undefined;
150
+ }
151
+ catch {
152
+ return undefined;
153
+ }
154
+ }
155
+ case "derived_from": {
156
+ if (isUnset)
157
+ return { derived_from: REMOVE_REGISTER_ITEM_FIELD };
158
+ try {
159
+ const parsed = JSON.parse(value);
160
+ return Array.isArray(parsed) && parsed.every((ref) => typeof ref === "string")
161
+ ? { derived_from: parsed }
162
+ : undefined;
163
+ }
164
+ catch {
165
+ return undefined;
166
+ }
167
+ }
139
168
  default:
140
169
  return undefined;
141
170
  }
@@ -3,9 +3,9 @@
3
3
  import { createHash, randomUUID } from "node:crypto";
4
4
  import { existsSync, readdirSync, readFileSync } from "node:fs";
5
5
  import { join } from "node:path";
6
- import { dump, load } from "./yaml.js";
7
- import { CELL_NONE, displayIdFromTicketFilename, readRegisterItemContent, readSpecdojoFields, toDisplayItem, updateSpecdojoFields, VALID_STATUSES, } from "./register-item.js";
8
- import { isUtcIsoSeconds, nowUtcIsoSeconds } from "./exec-shared.js";
6
+ import { dump, load } from "../shared/yaml.js";
7
+ import { CELL_NONE, displayIdFromTicketFilename, readRegisterItemContent, readSpecdojoFields, toDisplayItem, updateSpecdojoFields, VALID_STATUSES, } from "./item.js";
8
+ import { isUtcIsoSeconds, nowUtcIsoSeconds } from "../shared/time.js";
9
9
  export const REGISTER_EVENTS_DIRNAME = "events";
10
10
  export const REGISTER_EVENTS_SCHEMA_MODELINE = "# yaml-language-server: $schema=../../../../../../specdojo/schemas/v1/register-events.schema.yaml";
11
11
  export const REGISTER_EVENT_FIELDS = [
@@ -20,6 +20,9 @@ export const REGISTER_EVENT_FIELDS = [
20
20
  "completed",
21
21
  "conclusion",
22
22
  "block_reason",
23
+ "approach",
24
+ "targets",
25
+ "derived_from",
23
26
  ];
24
27
  export const REGISTER_EVENT_ACTIONS = [
25
28
  "add",
@@ -68,6 +71,9 @@ export function registerEventFieldValues(content, filename, timeZone) {
68
71
  completed: item.completed,
69
72
  conclusion: item.conclusion,
70
73
  block_reason: parsed.blockReason,
74
+ approach: item.approach ?? CELL_NONE,
75
+ targets: item.targets ? JSON.stringify(item.targets) : CELL_NONE,
76
+ derived_from: item.derivedFrom ? JSON.stringify(item.derivedFrom) : CELL_NONE,
71
77
  };
72
78
  }
73
79
  function isUnsetFieldValue(value) {
@@ -2,14 +2,15 @@
2
2
  // 未移行の期間だけ Git 差分を読み、event の開始時刻より前の legacy 履歴として統合する。
3
3
  //
4
4
  // 比較対象は生成される登録項目一覧の列(ステータス・タイトル・説明・分類・優先度・担当・
5
- // 登録日・期限・完了日・結論)に、待機時のブロック理由を加える。ブロック理由は一覧には
6
- // 表示しないが、conclusion と用途を分けた後も監査できるよう履歴の比較対象にする。
5
+ // 登録日・期限・完了日・結論)に、待機時のブロック理由と approach / targets /
6
+ // derived_from を加える。
7
+ // 一覧に表示しない構造化フィールドも、個票の更新履歴として監査できるよう比較対象にする。
7
8
  import { existsSync, readdirSync, readFileSync } from "node:fs";
8
9
  import { basename, join } from "node:path";
9
- import { displayIdFromTicketFilename, isPlaceholderCell } from "./register-item.js";
10
- import { gitOutput, gitResult } from "./exec-worktree.js";
11
- import { DEFAULT_REGISTER_DATE_TIMEZONE } from "./specdojo-config.js";
12
- import { REGISTER_EVENT_FIELDS, REGISTER_EVENTS_DIRNAME, displayIdFromRegisterEventFilename, readRegisterEventsFromContent, registerEventFieldValues, } from "./register-events.js";
10
+ import { displayIdFromTicketFilename, isPlaceholderCell } from "./item.js";
11
+ import { gitOutput, gitResult } from "../shared/git.js";
12
+ import { DEFAULT_REGISTER_DATE_TIMEZONE } from "../shared/specdojo-config.js";
13
+ import { REGISTER_EVENT_FIELDS, REGISTER_EVENTS_DIRNAME, displayIdFromRegisterEventFilename, readRegisterEventsFromContent, registerEventFieldValues, } from "./events.js";
13
14
  // 比較する項目と出力順。登録項目一覧の列順(ID と個票リンクを除く)に合わせる。
14
15
  export const REGISTER_HISTORY_FIELDS = REGISTER_EVENT_FIELDS;
15
16
  // git log の1コミット分の区切り(レコード分離子)とヘッダー項目の区切り(単位分離子)。
@@ -5,9 +5,9 @@
5
5
  // 表示 ID・タイトル・説明は frontmatter に重複させず、`id` / H1 / 本文から導出する。
6
6
  import { existsSync, readdirSync, readFileSync } from "node:fs";
7
7
  import { join } from "node:path";
8
- import { dump, load } from "./yaml.js";
9
- import { inlineCodeAnglePlaceholders } from "./exec-shared.js";
10
- import { registerDateFromTimestamp } from "./register-date.js";
8
+ import { dump, load } from "../shared/yaml.js";
9
+ import { inlineCodeAnglePlaceholders } from "../shared/text.js";
10
+ import { registerDateFromTimestamp } from "./date.js";
11
11
  export const VALID_STATUSES = [
12
12
  "open",
13
13
  "in-progress",
@@ -64,6 +64,8 @@ const SPECDOJO_KEY_ORDER = [
64
64
  "completed_at",
65
65
  "block_reason",
66
66
  "conclusion",
67
+ "derived_from",
68
+ "approach",
67
69
  "targets",
68
70
  ];
69
71
  // ================================
@@ -92,8 +94,15 @@ export function ticketRefCell(filename) {
92
94
  return `[${filename.replace(/\.md$/, "")}](./${filename})`;
93
95
  }
94
96
  // 表セルへ埋め込むために1行化し、列区切りの `|` をエスケープする。
95
- function toCell(text) {
96
- return text.replace(/\r?\n/g, " ").replace(/\s+/g, " ").replace(/\|/g, "\\|").trim();
97
+ // すでにエスケープ済みの `\|` は再エスケープせず、複数回の呼び出しに対して冪等にする。
98
+ export function toCell(text) {
99
+ if (typeof text !== "string")
100
+ return "";
101
+ return text
102
+ .replace(/\r?\n/g, " ")
103
+ .replace(/\s+/g, " ")
104
+ .replace(/(?<!\\)((\\\\)*)\|/g, "$1\\|")
105
+ .trim();
97
106
  }
98
107
  // H1(`# PJR-XXXX タイトル`)からタイトルを導出する。表示 ID の接頭辞は取り除く。
99
108
  export function titleFromBody(body, id) {
@@ -159,6 +168,10 @@ export function readRegisterItemContent(content, filename) {
159
168
  const targets = Array.isArray(fields.targets)
160
169
  ? fields.targets.filter((entry) => typeof entry === "string" && entry.trim() !== "")
161
170
  : undefined;
171
+ const approach = asString(fields.approach);
172
+ const derivedFrom = Array.isArray(fields.derived_from)
173
+ ? fields.derived_from.filter((entry) => typeof entry === "string" && entry.trim() !== "")
174
+ : undefined;
162
175
  const item = {
163
176
  id,
164
177
  status: asString(fields.item_status) ?? "open",
@@ -175,7 +188,9 @@ export function readRegisterItemContent(content, filename) {
175
188
  completedAt: asString(fields.completed_at) ?? CELL_NONE,
176
189
  conclusion: asString(fields.conclusion) ?? CELL_NONE,
177
190
  ticket: ticketRefCell(filename),
191
+ ...(approach ? { approach } : {}),
178
192
  ...(targets && targets.length > 0 ? { targets } : {}),
193
+ ...(derivedFrom && derivedFrom.length > 0 ? { derivedFrom } : {}),
179
194
  };
180
195
  return {
181
196
  id,
@@ -295,6 +310,9 @@ export function registerItemFieldsFromItem(item) {
295
310
  conclusion: isPlaceholderCell(item.conclusion)
296
311
  ? null
297
312
  : inlineCodeAnglePlaceholders(item.conclusion.trim()),
313
+ ...(item.approach ? { approach: item.approach } : {}),
314
+ ...(item.targets && item.targets.length > 0 ? { targets: item.targets } : {}),
315
+ ...(item.derivedFrom && item.derivedFrom.length > 0 ? { derived_from: item.derivedFrom } : {}),
298
316
  };
299
317
  }
300
318
  function orderSpecdojoKeys(fields) {
@@ -0,0 +1,5 @@
1
+ import { join } from "node:path";
2
+ // register の個票更新・view 再生成・commit を、exec run を含む全プロセス間で直列化する。
3
+ export function registerLifecyclePoolPath(executionPath) {
4
+ return join(executionPath, "exec", ".locks", "exec-lifecycle");
5
+ }
@@ -1,9 +1,10 @@
1
1
  import { existsSync, writeFileSync } from "node:fs";
2
- import { collectRegisterHistoryEvents, formatRegisterHistoryEvents } from "./register-history.js";
3
- import { createGitTimestampResolver, planRegisterTimestampMigration, summarizeTimestampMigration, } from "./register-migrate-timestamps.js";
4
- import { registerEventFilePath, validateRegisterEventDocs } from "./register-events.js";
5
- import { validateRegisterItemDocs } from "./register-item.js";
6
- import { specdojoRootDir } from "./specdojo-config.js";
2
+ import { collectRegisterHistoryEvents, formatRegisterHistoryEvents } from "./history.js";
3
+ import { createGitTimestampResolver, planRegisterTimestampMigration, summarizeTimestampMigration, } from "./migrate-timestamps.js";
4
+ import { registerEventFilePath, validateRegisterEventDocs } from "./events.js";
5
+ import { validateRegisterItemDocs } from "./item.js";
6
+ import { specdojoRootDir } from "../shared/specdojo-config.js";
7
+ import { validateDerivedFromDocs } from "./derivation.js";
7
8
  export function registerMaintenanceCommands(reg, dependencies) {
8
9
  const { addProjectOption, addRegisterCommitOptions, applyRegisterMigrationPlan, generateDerivedViewFiles, loadItemForUpdate, migrateEmbeddedRegisterEvents, migrateRegisterEventsFromGit, parseHistoryIds, planRegisterMigration, planRenumber, printCommandError, registerEventActor, renumberPjrItem, repoRelativePathspec, resolveRegisterPaths, runRegisterMutation, validBuildScopes, writeDerivedViews, } = dependencies;
9
10
  // --- migrate ---
@@ -86,9 +87,14 @@ export function registerMaintenanceCommands(reg, dependencies) {
86
87
  throw new Error(`Invalid scope: "${opts.scope}". Must be one of: ${validBuildScopes.join(", ")}`);
87
88
  }
88
89
  const validation = validateRegisterItemDocs(paths.projectRegisterPath);
90
+ const derivationErrors = validateDerivedFromDocs(paths);
89
91
  const eventErrors = validateRegisterEventDocs(paths.projectRegisterPath, paths.registerDateTimeZone);
90
- if (validation.errors.length > 0 || eventErrors.length > 0) {
91
- throw new Error(`Invalid register item files:\n${[...validation.errors, ...eventErrors].join("\n")}`);
92
+ if (validation.errors.length > 0 || derivationErrors.length > 0 || eventErrors.length > 0) {
93
+ throw new Error(`Invalid register item files:\n${[
94
+ ...validation.errors,
95
+ ...derivationErrors,
96
+ ...eventErrors,
97
+ ].join("\n")}`);
92
98
  }
93
99
  const views = generateDerivedViewFiles(paths, scope);
94
100
  if (opts.dryRun) {
@@ -12,9 +12,9 @@
12
12
  // 後になっている項目では、追加コミットの時刻は起票時刻ではない)。
13
13
  import { readdirSync, readFileSync } from "node:fs";
14
14
  import { join, relative, sep } from "node:path";
15
- import { applyRegisterItemTimestamps, displayIdFromTicketFilename, readRegisterItemContent, readRegisterItemLegacyDates, } from "./register-item.js";
16
- import { normalizeRegisterTimestamp, REGISTER_FALLBACK_TIME_OF_DAY, registerDateFromTimestamp, timestampFromDateInTimeZone, } from "./register-date.js";
17
- import { gitResult } from "./exec-worktree.js";
15
+ import { applyRegisterItemTimestamps, displayIdFromTicketFilename, readRegisterItemContent, readRegisterItemLegacyDates, } from "./item.js";
16
+ import { normalizeRegisterTimestamp, REGISTER_FALLBACK_TIME_OF_DAY, registerDateFromTimestamp, timestampFromDateInTimeZone, } from "./date.js";
17
+ import { gitResult } from "../shared/git.js";
18
18
  // git log の1行書式。コミットハッシュも ISO 日付も空白を含まないため、空白で分割できる。
19
19
  const COMMIT_LOG_FORMAT = "--format=%H %aI";
20
20
  // 完了日を記録する終端状態。deferred は終端だが完了日を持たないため含めない。
@@ -1,10 +1,10 @@
1
1
  import { randomUUID } from "node:crypto";
2
2
  import { existsSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
3
3
  import { basename, dirname, join } from "node:path";
4
- import { buildRegisterItemContent, locateRegisterTable, parsePjrIndex, slugify, validateFields, } from "./register-core.js";
5
- import { applyRegisterItemFields, loadRegisterItemDocs, prependRegisterItemDescription, readRegisterItemContent, registerItemFieldsFromItem, setRegisterItemTitle, } from "./register-item.js";
6
- import { resolveSpecdojoTemplatePath } from "./template-resolution.js";
7
- import { loadRegisterItems } from "./register-views.js";
4
+ import { buildRegisterItemContent, locateRegisterTable, parsePjrIndex, slugify, validateFields, } from "./core.js";
5
+ import { applyRegisterItemFields, loadRegisterItemDocs, prependRegisterItemDescription, readRegisterItemContent, registerItemFieldsFromItem, setRegisterItemTitle, } from "./item.js";
6
+ import { resolveSpecdojoTemplatePath } from "../docs/template-resolution.js";
7
+ import { loadRegisterItems } from "./views.js";
8
8
  const REGISTER_ITEM_VALUE_KEYS = [
9
9
  "id",
10
10
  "status",
@@ -1,29 +1,29 @@
1
1
  import { existsSync, readFileSync } from "node:fs";
2
2
  import { relative, sep } from "node:path";
3
- import { execLifecyclePoolPath } from "./exec-run-lock.js";
4
- import { CrossProcessMutex } from "./exec-slot-lock.js";
5
- import { inlineCodeAnglePlaceholders } from "./exec-shared.js";
6
- import { repoRelative, stageCommitTargets, worktreeStatusPaths } from "./exec-worktree-ops.js";
7
- import { gitOutput, gitResult } from "./exec-worktree.js";
8
- import { atomicWriteFile, buildRegisterItemContent, derivedTopicNeedsWarning, generatePjrId, printDerivedTopicWarning, registerEventActor, REGISTER_TOPIC_RE, resolveRegisterPaths, slugify, validateFields, } from "./register-core.js";
9
- import { registerCreateCommands, registerUpdateCommand } from "./register-create-commands.js";
10
- import { normalizeRegisterTimestamp } from "./register-date.js";
11
- import { appendRegisterEvent, deterministicRegisterEventId, readEmbeddedRegisterEvents, readRegisterEventsFromContent, registerEventFilePath, removeEmbeddedRegisterEvents, serializeRegisterEvents, validateRegisterEventDocs, } from "./register-events.js";
12
- import { collectRegisterHistoryEvents } from "./register-history.js";
13
- import { loadRegisterItemDocs, PJR_ID_ALPHABET, PJR_ID_RE, TERMINAL_STATUSES_SET, validateRegisterItemDocs, VALID_PRIORITIES, VALID_STATUSES, VALID_TYPES, } from "./register-item.js";
14
- import { registerMaintenanceCommands } from "./register-maintenance-commands.js";
15
- import { applyRegisterMigrationPlan, planRegisterMigration } from "./register-migration.js";
16
- import { planRenumber, planRetopic, renumberPjrItem, retopicPjrItem, ticketTopicFromFilename, } from "./register-renumber.js";
17
- import { registerTransitionCommands } from "./register-transition-commands.js";
18
- import { applyItemUpdate, assertTerminalOperationAllowed, loadItemForUpdate, updateTicketStatusForItem, } from "./register-update.js";
19
- import { generateDerivedViewFiles, loadRegisterItems, VALID_BUILD_SCOPES, writeDerivedViews, } from "./register-views.js";
20
- import { specdojoRootDir } from "./specdojo-config.js";
21
- export { PJR_ID_ALPHABET, PJR_ID_RE, TERMINAL_STATUSES_SET, VALID_PRIORITIES, VALID_STATUSES, VALID_TYPES, };
22
- export { REGISTER_TOPIC_RE, VALID_TICKET_STATUSES, buildRegisterItemContent, extractTableHeading, findMarkdownReferenceFiles, generatePjrId, injectRegisterRows, parsePjrIndex, resolveRegisterPaths, } from "./register-core.js";
23
- export { applyRegisterMigrationPlan, planRegisterMigration, } from "./register-migration.js";
24
- export { findItemById, findRegisterItem, generateDerivedViewFiles, injectViewSlots, loadRegisterItems, sortByRegisteredDesc, } from "./register-views.js";
25
- export { parseTicketFilename, updateTicketFrontmatterStatus, updateTicketStatusForItem, } from "./register-update.js";
26
- export { planRenumber, planRetopic, renumberPjrItem, renumberReferences, renumberTicketContent, retopicPjrItem, ticketTopicFromFilename, } from "./register-renumber.js";
3
+ import { CrossProcessMutex } from "../shared/cross-process-lock.js";
4
+ import { gitOutput, gitResult, repoRelative, stageCommitTargets, worktreeStatusPaths, } from "../shared/git.js";
5
+ import { inlineCodeAnglePlaceholders } from "../shared/text.js";
6
+ import { atomicWriteFile, buildRegisterItemContent, derivedTopicNeedsWarning, generatePjrId, printDerivedTopicWarning, registerEventActor, REGISTER_TOPIC_RE, resolveRegisterPaths, slugify, validateFields, } from "./core.js";
7
+ import { registerCreateCommands, registerUpdateCommand } from "./create-commands.js";
8
+ import { normalizeRegisterTimestamp } from "./date.js";
9
+ import { validateDerivedFromDocs } from "./derivation.js";
10
+ import { appendRegisterEvent, deterministicRegisterEventId, readEmbeddedRegisterEvents, readRegisterEventsFromContent, registerEventFilePath, removeEmbeddedRegisterEvents, serializeRegisterEvents, validateRegisterEventDocs, } from "./events.js";
11
+ import { collectRegisterHistoryEvents } from "./history.js";
12
+ import { loadRegisterItemDocs, PJR_ID_ALPHABET, PJR_ID_RE, TERMINAL_STATUSES_SET, toCell, validateRegisterItemDocs, VALID_PRIORITIES, VALID_STATUSES, VALID_TYPES, } from "./item.js";
13
+ import { registerMaintenanceCommands } from "./maintenance-commands.js";
14
+ import { applyRegisterMigrationPlan, planRegisterMigration } from "./migration.js";
15
+ import { planRenumber, planRetopic, renumberPjrItem, retopicPjrItem, ticketTopicFromFilename, } from "./renumber.js";
16
+ import { registerTransitionCommands } from "./transition-commands.js";
17
+ import { applyItemUpdate, assertTerminalOperationAllowed, loadItemForUpdate, updateTicketStatusForItem, } from "./update.js";
18
+ import { generateDerivedViewFiles, loadRegisterItems, VALID_BUILD_SCOPES, writeDerivedViews, } from "./views.js";
19
+ import { specdojoRootDir } from "../shared/specdojo-config.js";
20
+ import { registerLifecyclePoolPath } from "./lifecycle-lock.js";
21
+ export { PJR_ID_ALPHABET, PJR_ID_RE, TERMINAL_STATUSES_SET, toCell, VALID_PRIORITIES, VALID_STATUSES, VALID_TYPES, };
22
+ export { REGISTER_TOPIC_RE, VALID_TICKET_STATUSES, buildRegisterItemContent, extractTableHeading, findMarkdownReferenceFiles, generatePjrId, injectRegisterRows, parsePjrIndex, resolveRegisterPaths, } from "./core.js";
23
+ export { applyRegisterMigrationPlan, planRegisterMigration, } from "./migration.js";
24
+ export { findItemById, findRegisterItem, generateDerivedViewFiles, injectViewSlots, loadRegisterItems, sortByRegisteredDesc, } from "./views.js";
25
+ export { parseTicketFilename, updateTicketFrontmatterStatus, updateTicketStatusForItem, } from "./update.js";
26
+ export { planRenumber, planRetopic, renumberPjrItem, renumberReferences, renumberTicketContent, retopicPjrItem, ticketTopicFromFilename, } from "./renumber.js";
27
27
  // 作成する個票ファイル名と割り当て ID を算出する純粋関数。I/O を持たず、
28
28
  // フィールド検証と ID 衝突検知だけを行う。ID を省略するとランダムに採番する。
29
29
  export function planRegisterItem(opts) {
@@ -81,9 +81,14 @@ function defaultRegisterCommitMessage(command, result) {
81
81
  }
82
82
  function rebuildRegisterViews(paths) {
83
83
  const validation = validateRegisterItemDocs(paths.projectRegisterPath);
84
+ const derivationErrors = validateDerivedFromDocs(paths);
84
85
  const eventErrors = validateRegisterEventDocs(paths.projectRegisterPath, paths.registerDateTimeZone);
85
- if (validation.errors.length > 0 || eventErrors.length > 0) {
86
- throw new Error(`Invalid register item files:\n${[...validation.errors, ...eventErrors].join("\n")}`);
86
+ if (validation.errors.length > 0 || derivationErrors.length > 0 || eventErrors.length > 0) {
87
+ throw new Error(`Invalid register item files:\n${[
88
+ ...validation.errors,
89
+ ...derivationErrors,
90
+ ...eventErrors,
91
+ ].join("\n")}`);
87
92
  }
88
93
  writeDerivedViews(paths, "all");
89
94
  }
@@ -141,7 +146,7 @@ async function runRegisterMutation(command, opts, mutate) {
141
146
  if (!paths.executionPath) {
142
147
  throw new Error(`Execution path is not configured for project ${paths.projectId}`);
143
148
  }
144
- const mutex = new CrossProcessMutex(execLifecyclePoolPath(paths.executionPath), {
149
+ const mutex = new CrossProcessMutex(registerLifecyclePoolPath(paths.executionPath), {
145
150
  actor: registerEventActor(opts),
146
151
  label: `register ${command}`,
147
152
  }, {
@@ -1,12 +1,12 @@
1
1
  import { existsSync, readFileSync, unlinkSync } from "node:fs";
2
2
  import { basename, join } from "node:path";
3
- import { atomicWriteFile, findMarkdownReferenceFiles, formatTableRow, isTableSeparator, parsePjrIndex, parseTableCells, prepareRegisterEventFile, REGISTER_SECTION_RE, REGISTER_TOPIC_RE, } from "./register-core.js";
4
- import { appendRegisterEvent, buildRegisterEvent, registerEventFilePath, } from "./register-events.js";
5
- import { parseSpecdojoDocument } from "./frontmatter-namespace.js";
6
- import { applyRegisterItemFields, PJR_ID_RE, registerItemFieldsFromItem, REMOVE_REGISTER_ITEM_FIELD, setRegisterItemDescription, setRegisterItemTitle, ticketRefCell, toDisplayItem, } from "./register-item.js";
7
- import { specdojoRootDir } from "./specdojo-config.js";
8
- import { loadItemForUpdate } from "./register-update.js";
9
- import { findRegisterItem, loadRegisterItems, writeDerivedViews } from "./register-views.js";
3
+ import { atomicWriteFile, findMarkdownReferenceFiles, formatTableRow, isTableSeparator, parsePjrIndex, parseTableCells, prepareRegisterEventFile, REGISTER_SECTION_RE, REGISTER_TOPIC_RE, } from "./core.js";
4
+ import { appendRegisterEvent, buildRegisterEvent, registerEventFilePath } from "./events.js";
5
+ import { parseSpecdojoDocument } from "../docs/frontmatter-namespace.js";
6
+ import { applyRegisterItemFields, PJR_ID_RE, readRegisterItemContent, readSpecdojoFields, registerItemFieldsFromItem, REMOVE_REGISTER_ITEM_FIELD, setRegisterItemDescription, setRegisterItemTitle, ticketRefCell, toDisplayItem, } from "./item.js";
7
+ import { specdojoRootDir } from "../shared/specdojo-config.js";
8
+ import { loadItemForUpdate } from "./update.js";
9
+ import { findRegisterItem, loadRegisterItems, writeDerivedViews } from "./views.js";
10
10
  // ================================
11
11
  // Renumber (duplicate ID recovery)
12
12
  // ================================
@@ -66,6 +66,31 @@ export function renumberReferences(content, fromDocId, toDocId) {
66
66
  return { content, changed: false };
67
67
  return { content: content.split(fromDocId).join(toDocId), changed: true };
68
68
  }
69
+ // `derived_from` は文書 ID ではなく表示 ID を保持するため、通常の wikilink / targets の
70
+ // 置換とは分けて frontmatter の配列だけを更新する。同一 project の短縮形と、別 project
71
+ // から参照する project 修飾形の両方を対象にする。
72
+ function renumberDerivedFromReferences(content, filename, sourceProjectId, fromId, toId) {
73
+ const parsed = readRegisterItemContent(content, filename);
74
+ if (!parsed?.item.derivedFrom)
75
+ return { content, changed: false };
76
+ const docId = readSpecdojoFields(content).id;
77
+ const referencingProjectId = typeof docId === "string" && docId.includes(":") ? docId.split(":", 1)[0] : undefined;
78
+ let changed = false;
79
+ const derivedFrom = parsed.item.derivedFrom.map((ref) => {
80
+ if (referencingProjectId === sourceProjectId && ref === fromId) {
81
+ changed = true;
82
+ return toId;
83
+ }
84
+ if (ref === `${sourceProjectId}:${fromId}`) {
85
+ changed = true;
86
+ return `${sourceProjectId}:${toId}`;
87
+ }
88
+ return ref;
89
+ });
90
+ return changed
91
+ ? { content: applyRegisterItemFields(content, { derived_from: derivedFrom }), changed }
92
+ : { content, changed };
93
+ }
69
94
  // topic 変更で書き換える全ファイルを事前に算出する。参照の更新範囲は renumber と
70
95
  // 同じく docs/ja 配下(生成物を除く)とし、文書 ID を含む wikilink / targets を
71
96
  // 付け替える。衝突や個票 ID の不整合は、書き込み前に検出する。
@@ -231,7 +256,7 @@ export function planRenumber(paths, fromId, toId) {
231
256
  if (hasIndexRow) {
232
257
  writes.push({ path: paths.pjrIndexPath, content: newIndexContent });
233
258
  }
234
- // 参照リンク・targets の付け替え(doc id を持つ個票がある場合のみ)。
259
+ // 参照リンク・targets・derived_from の付け替え(doc id を持つ個票がある場合のみ)。
235
260
  if (fromDocId && toDocId) {
236
261
  const root = specdojoRootDir();
237
262
  const referenceFiles = findMarkdownReferenceFiles(root);
@@ -241,9 +266,11 @@ export function planRenumber(paths, fromId, toId) {
241
266
  if (ticketRename && absPath === ticketRename.from)
242
267
  continue;
243
268
  const content = readFileSync(absPath, "utf8");
244
- const { content: replaced, changed } = renumberReferences(content, fromDocId, toDocId);
245
- if (changed)
246
- writes.push({ path: absPath, content: replaced });
269
+ const docReferenceUpdate = renumberReferences(content, fromDocId, toDocId);
270
+ const derivedFromUpdate = renumberDerivedFromReferences(docReferenceUpdate.content, basename(absPath), paths.projectId, fromId, toId);
271
+ if (docReferenceUpdate.changed || derivedFromUpdate.changed) {
272
+ writes.push({ path: absPath, content: derivedFromUpdate.content });
273
+ }
247
274
  }
248
275
  }
249
276
  return { writes, ticketRename };
@@ -1,6 +1,6 @@
1
- import { inlineCodeAnglePlaceholders } from "./exec-shared.js";
2
- import { nowUtcTimestamp } from "./register-date.js";
3
- import { CELL_NONE } from "./register-item.js";
1
+ import { inlineCodeAnglePlaceholders } from "../shared/text.js";
2
+ import { nowUtcTimestamp } from "./date.js";
3
+ import { CELL_NONE } from "./item.js";
4
4
  export function registerTransitionCommands(reg, dependencies) {
5
5
  const { addProjectOption, addRegisterCommitOptions, applyItemUpdate, assertRegisterItemCommitTargetsClean, assertTerminalOperationAllowed, loadItemForUpdate, parseRegisterTimestampOption, registerEventActor, runRegisterMutation, updateTicketStatusForItem, } = dependencies;
6
6
  // --- close ---
@@ -1,10 +1,10 @@
1
1
  import { existsSync, readFileSync } from "node:fs";
2
2
  import { basename, join } from "node:path";
3
- import { atomicWriteFile, prepareRegisterEventFile } from "./register-core.js";
4
- import { buildRegisterEvent } from "./register-events.js";
5
- import { parseSpecdojoDocument } from "./frontmatter-namespace.js";
6
- import { applyRegisterItemFields, formatRegisterItemFields, PJR_ID_RE, registerItemFieldsFromItem, REMOVE_REGISTER_ITEM_FIELD, setRegisterItemDescription, setRegisterItemTitle, TERMINAL_STATUSES_SET, } from "./register-item.js";
7
- import { findRegisterItem, loadRegisterItems, writeDerivedViews } from "./register-views.js";
3
+ import { atomicWriteFile, prepareRegisterEventFile } from "./core.js";
4
+ import { buildRegisterEvent } from "./events.js";
5
+ import { parseSpecdojoDocument } from "../docs/frontmatter-namespace.js";
6
+ import { applyRegisterItemFields, formatRegisterItemFields, PJR_ID_RE, registerItemFieldsFromItem, REMOVE_REGISTER_ITEM_FIELD, setRegisterItemDescription, setRegisterItemTitle, TERMINAL_STATUSES_SET, } from "./item.js";
7
+ import { findRegisterItem, loadRegisterItems, writeDerivedViews } from "./views.js";
8
8
  // 更新対象の登録項目を解決する。個票ファイルが無い項目は、書き込み先(正本)が無いため
9
9
  // 更新できない。移行が済んでいない旧項目に当たった場合は、個票化を促して中断する。
10
10
  export function loadItemForUpdate(paths, id, guard) {