@moretea-labs/forge 1.7.0 → 1.7.1

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 (175) hide show
  1. package/AGENTS.md +2 -0
  2. package/CHANGELOG.md +13 -0
  3. package/CLAUDE.md +2 -0
  4. package/THIRD_PARTY_NOTICES.md +1 -1
  5. package/agents/openai.yaml +1 -1
  6. package/assets/partials-agents/02-operating-mode.partial.md +2 -0
  7. package/assets/plugin-registry.v1.json +3 -3
  8. package/assets/skill-version.json +2 -2
  9. package/assets/templates/helpers/check-architecture-sync.sh +17 -0
  10. package/assets/templates/helpers/inspect-project-state.ts +8 -6
  11. package/assets/templates/helpers/migrate-workflow-docs.ts +9 -7
  12. package/assets/templates/helpers/workflow-contract.ts +5 -1
  13. package/docs/architecture/CURRENT.md +12 -4
  14. package/docs/forge-plugin-management.md +1 -1
  15. package/docs/operations/controller-performance-and-502.md +19 -0
  16. package/docs/operations/homebrew.md +2 -2
  17. package/package.json +5 -2
  18. package/scripts/architecture-event.ts +2 -820
  19. package/scripts/architecture-queue.sh +2 -645
  20. package/scripts/archive-architecture-request.sh +2 -242
  21. package/scripts/archive-workflow.sh +1 -291
  22. package/scripts/benchmark-work-efficiency.ts +0 -0
  23. package/scripts/capability-config.ts +2 -392
  24. package/scripts/capability-resolver.ts +2 -503
  25. package/scripts/capture-plan.sh +1 -332
  26. package/scripts/check-agent-tooling.sh +2 -1531
  27. package/scripts/check-architecture-sync.sh +2 -302
  28. package/scripts/check-brain-manifest.sh +2 -253
  29. package/scripts/check-context-files.sh +2 -47
  30. package/scripts/check-deploy-sql-order.sh +2 -115
  31. package/scripts/check-runtime-architecture.mjs +243 -16
  32. package/scripts/check-skill-version.ts +3 -191
  33. package/scripts/check-source-duplication.mjs +61 -0
  34. package/scripts/check-stable-baseline.ts +0 -0
  35. package/scripts/check-task-sync.sh +2 -63
  36. package/scripts/check-task-workflow.sh +2 -1000
  37. package/scripts/codex-handoff-resume.sh +2 -267
  38. package/scripts/context-contract-sync.sh +2 -514
  39. package/scripts/contract-run.ts +2 -463
  40. package/scripts/contract-worktree.sh +1 -702
  41. package/scripts/ensure-task-workflow.sh +1 -1192
  42. package/scripts/inspect-project-state.ts +4 -279
  43. package/scripts/lib/project-init-lib.sh +7 -2
  44. package/scripts/lib/run-forge-helper.sh +19 -0
  45. package/scripts/lib/run-forge-helper.ts +26 -0
  46. package/scripts/migrate-project-template.sh +1 -33
  47. package/scripts/migrate-workflow-docs.ts +4 -412
  48. package/scripts/new-plan.sh +1 -180
  49. package/scripts/new-spec.sh +1 -47
  50. package/scripts/new-sprint.sh +1 -46
  51. package/scripts/plan-to-todo.sh +1 -771
  52. package/scripts/prepare-codex-handoff.sh +2 -201
  53. package/scripts/prepare-handoff.sh +1 -78
  54. package/scripts/refresh-current-status.sh +2 -467
  55. package/scripts/run-governed-gate.ts +3 -0
  56. package/scripts/select-agent-context-blocks.sh +2 -64
  57. package/scripts/ship-worktrees.sh +1 -531
  58. package/scripts/sprint-backlog.sh +1 -834
  59. package/scripts/stage-runtime-release.ts +2 -1
  60. package/scripts/summarize-failures.sh +2 -123
  61. package/scripts/switch-plan.sh +1 -150
  62. package/scripts/sync-brain-docs.sh +2 -379
  63. package/scripts/sync-generated-authority.mjs +175 -0
  64. package/scripts/verify-contract.sh +2 -593
  65. package/scripts/verify-sprint.sh +1 -500
  66. package/scripts/workflow-contract.ts +4 -201
  67. package/scripts/workstream-sync.sh +2 -261
  68. package/src/cli/agent-jobs/executor-health.ts +1 -1
  69. package/src/cli/commands/plugin.ts +12 -3
  70. package/src/cli/controller/check-runner.ts +7 -2
  71. package/src/cli/controller/context-pack.ts +46 -21
  72. package/src/cli/github/contracts.ts +16 -0
  73. package/src/cli/github/github.ts +2 -16
  74. package/src/cli/github/session.ts +2 -1
  75. package/src/cli/local-bridge/facade-api.ts +37 -47
  76. package/src/cli/local-bridge/server.ts +2 -2
  77. package/src/cli/mcp/legacy-tool-service.ts +10 -33
  78. package/src/cli/mcp/post-finalize-work-attribution.ts +150 -0
  79. package/src/cli/mcp/repository-tools.ts +85 -89
  80. package/src/cli/mcp/server.ts +57 -13
  81. package/src/cli/mcp/tool-contract.ts +14 -0
  82. package/src/cli/mcp/toolset.ts +2 -2
  83. package/src/cli/mcp/transports/http.ts +23 -0
  84. package/src/cli/repositories/command-classifier.ts +2 -2
  85. package/src/cli/repositories/command-executor.ts +24 -6
  86. package/src/cli/repositories/repository-snapshot.ts +5 -2
  87. package/src/cli/repositories/structured-git.ts +57 -3
  88. package/src/cli/repository/inspector.ts +11 -3
  89. package/src/runtime/context/generic-lsp-provider.ts +1 -1
  90. package/src/runtime/context/semantic-navigation-contract.ts +61 -0
  91. package/src/runtime/context/semantic-navigation.ts +9 -61
  92. package/src/runtime/control-plane/execution/direct-edit-work-completion.ts +18 -25
  93. package/src/runtime/control-plane/execution/repository-work-attribution.ts +106 -0
  94. package/src/runtime/control-plane/execution/retained-work-resume.ts +203 -0
  95. package/src/runtime/control-plane/execution/work-completion-authority.ts +58 -0
  96. package/src/runtime/control-plane/execution/work-evidence-policy.ts +200 -0
  97. package/src/runtime/control-plane/execution/work-execution-support.ts +386 -0
  98. package/src/runtime/control-plane/execution/work-finalization-service.ts +1913 -0
  99. package/src/runtime/control-plane/execution/work-handle-authority.ts +96 -0
  100. package/src/runtime/control-plane/execution/work-handle-store.ts +1 -1
  101. package/src/runtime/control-plane/execution/work-operation-service.ts +468 -0
  102. package/src/runtime/control-plane/execution/work-path-scope.ts +37 -0
  103. package/src/runtime/control-plane/execution/work-preparation-service.ts +479 -0
  104. package/src/runtime/control-plane/execution/work-process-evidence.ts +129 -0
  105. package/src/runtime/control-plane/execution/work-task-receipt.ts +4 -43
  106. package/src/runtime/control-plane/execution/work-terminal-cleanup.ts +13 -3
  107. package/src/runtime/control-plane/execution/work-verification-context.ts +56 -0
  108. package/src/runtime/control-plane/execution/work-verification-service.ts +388 -0
  109. package/src/runtime/control-plane/execution/work-verification-snapshot.ts +5 -1
  110. package/src/runtime/control-plane/facade/controller-round-relay.ts +164 -37
  111. package/src/runtime/control-plane/facade/controller-session-store.ts +183 -24
  112. package/src/runtime/control-plane/facade/goal-workloop-access.ts +15 -1
  113. package/src/runtime/control-plane/facade/goal-workloop.ts +329 -148
  114. package/src/runtime/control-plane/facade/index.ts +2 -0
  115. package/src/runtime/control-plane/facade/plan-contract-store.ts +90 -22
  116. package/src/runtime/control-plane/facade/repository-work-admission.ts +147 -0
  117. package/src/runtime/control-plane/facade/requirement-authority.ts +83 -0
  118. package/src/runtime/control-plane/facade/types.ts +68 -5
  119. package/src/runtime/control-plane/facade/work-contract-store.ts +3 -209
  120. package/src/runtime/control-plane/facade/work-state-machine.ts +250 -0
  121. package/src/runtime/control-plane/global-scheduler/maintenance.ts +14 -7
  122. package/src/runtime/control-plane/global-scheduler/scheduler.ts +5 -1
  123. package/src/runtime/control-plane/launcher/chatgpt-work-binding-store.ts +13 -0
  124. package/src/runtime/control-plane/launcher/chatgpt-work-continuation.ts +15 -6
  125. package/src/runtime/control-plane/launcher/launch-reservation-store.ts +54 -5
  126. package/src/runtime/control-plane/launcher/thin-launcher.ts +56 -7
  127. package/src/runtime/control-plane/persistence/requirement-store.ts +0 -12
  128. package/src/runtime/control-plane/repo-actor/registry.ts +4 -2
  129. package/src/runtime/control-plane/routing/route-policy.ts +18 -6
  130. package/src/runtime/control-plane/routing/workspace-admission.ts +70 -0
  131. package/src/runtime/evidence/process-check-execution.ts +18 -0
  132. package/src/runtime/execution/jobs/child-reference.ts +6 -2
  133. package/src/runtime/execution/process-runtime/check-result.ts +53 -18
  134. package/src/runtime/execution/process-runtime/check-runner-sidecar.ts +7 -1
  135. package/src/runtime/execution/process-runtime/command-facade.ts +39 -17
  136. package/src/runtime/execution/process-runtime/lightweight-managed.ts +20 -3
  137. package/src/runtime/execution/process-runtime/persisted-check.ts +4 -1
  138. package/src/runtime/execution/process-runtime/runtime.ts +10 -0
  139. package/src/runtime/execution/process-runtime/types.ts +2 -12
  140. package/src/runtime/execution/work-activity.ts +21 -0
  141. package/src/runtime/execution/workers/executor.ts +18 -13
  142. package/src/runtime/gateway/mcp/execution-tools.ts +35 -2930
  143. package/src/runtime/gateway/mcp/legacy-ios-tool-adapter.ts +61 -0
  144. package/src/runtime/gateway/mcp/router.ts +2 -2
  145. package/src/runtime/gateway/mcp/runtime-tool-definitions.ts +21 -2
  146. package/src/runtime/gateway/mcp/runtime-tools.ts +805 -1009
  147. package/src/runtime/plugins/app-store-connect-adapter.ts +93 -28
  148. package/src/runtime/plugins/browser-adapter.ts +256 -1083
  149. package/src/runtime/plugins/browser-handoff-host.ts +2 -25
  150. package/src/runtime/plugins/browser-handoff.ts +18 -3
  151. package/src/runtime/plugins/browser-macos-bridge.ts +121 -16
  152. package/src/runtime/plugins/browser-manifest-surface.ts +603 -0
  153. package/src/runtime/plugins/browser-native-session-service.ts +222 -0
  154. package/src/runtime/plugins/browser-runtime-contract.ts +2 -0
  155. package/src/runtime/plugins/browser-runtime.ts +10 -0
  156. package/src/runtime/plugins/browser-session-store.ts +121 -0
  157. package/src/runtime/plugins/browser-session-types.ts +98 -0
  158. package/src/runtime/plugins/desktop-operator-registration.ts +4 -4
  159. package/src/runtime/plugins/external-adapter.ts +92 -58
  160. package/src/runtime/plugins/macos-capability-broker.ts +0 -8
  161. package/src/runtime/plugins/store.ts +66 -9
  162. package/src/runtime/plugins/types.ts +3 -1
  163. package/src/runtime/recovery/maintenance-executor.ts +61 -25
  164. package/src/runtime/root/package-connector-service.ts +46 -4
  165. package/src/runtime/root/package-runtime-release.ts +1 -1
  166. package/src/runtime/root/package-runtime-service.ts +33 -2
  167. package/src/runtime/root/release-manifest.ts +137 -16
  168. package/src/runtime/root/release-materialize.ts +109 -35
  169. package/src/runtime/root/types.ts +10 -0
  170. package/src/runtime/standalone-recovery/core.ts +425 -194
  171. package/src/runtime/standalone-recovery/entry.ts +1 -1
  172. package/src/runtime/standalone-recovery/installer.ts +1 -1
  173. package/src/runtime/workflow/schedules/engine.ts +113 -87
  174. package/src/runtime/workflow/schedules/settlement.ts +26 -23
  175. package/src/runtime/workflow/schedules/store.ts +79 -10
@@ -1,203 +1,4 @@
1
1
  #!/bin/bash
2
2
  set -euo pipefail
3
-
4
- usage() {
5
- cat <<'USAGE_EOF'
6
- Usage: scripts/prepare-codex-handoff.sh [--reason <reason>] [--print-prompt]
7
- USAGE_EOF
8
- }
9
-
10
- reason="manual"
11
- print_prompt=0
12
-
13
- while [[ $# -gt 0 ]]; do
14
- case "$1" in
15
- --reason)
16
- reason="${2:-manual}"
17
- shift 2
18
- ;;
19
- --print-prompt)
20
- print_prompt=1
21
- shift
22
- ;;
23
- --help|-h)
24
- usage
25
- exit 0
26
- ;;
27
- *)
28
- echo "Unknown argument: $1" >&2
29
- usage >&2
30
- exit 1
31
- ;;
32
- esac
33
- done
34
-
35
- repo="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
36
- cd "$repo"
37
-
38
- if [[ -f "scripts/prepare-handoff.sh" ]]; then
39
- FORGE_SKIP_RESUME_REFRESH=1 bash scripts/prepare-handoff.sh "$reason"
40
- fi
41
-
42
- resume_args=(scripts/codex-handoff-resume.sh --cwd "$repo" --reason "$reason")
43
- if [[ "$print_prompt" -eq 1 ]]; then
44
- resume_args+=(--print-prompt)
45
- fi
46
-
47
- resume_output=""
48
- if [[ -f "scripts/codex-handoff-resume.sh" ]]; then
49
- resume_output="$(bash "${resume_args[@]}")"
50
- fi
51
-
52
- codex_home="${CODEX_HOME:-$HOME/.codex}"
53
- global_dir="$codex_home/handoffs"
54
- global_file="$global_dir/handoff-$(date '+%y%m%d').md"
55
- repo_handoff=".ai/harness/session/continuation.md"
56
- resume_file=".ai/harness/session/resume.md"
57
-
58
- mkdir -p "$global_dir"
59
-
60
- repo_key="$(printf '%s' "$repo" | shasum | awk '{print substr($1, 1, 12)}')"
61
-
62
- if command -v node >/dev/null 2>&1; then
63
- node - "$global_file" "$repo" "$repo_key" "$reason" "$repo_handoff" "$resume_file" <<'JS_EOF'
64
- const fs = require("fs");
65
- const path = require("path");
66
-
67
- const [, , globalFile, repo, repoKey, reason, repoHandoff, resumeFile] = process.argv;
68
-
69
- fs.mkdirSync(path.dirname(globalFile), { recursive: true });
70
- const start = `<!-- repo:${repoKey} start -->`;
71
- const end = `<!-- repo:${repoKey} end -->`;
72
-
73
- function pad(value) {
74
- return String(value).padStart(2, "0");
75
- }
76
-
77
- function yymmdd(date) {
78
- return `${String(date.getFullYear()).slice(-2)}${pad(date.getMonth() + 1)}${pad(date.getDate())}`;
79
- }
80
-
81
- function timestamp(date) {
82
- return [
83
- date.getFullYear(),
84
- pad(date.getMonth() + 1),
85
- pad(date.getDate()),
86
- ].join("-") + ` ${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`;
87
- }
88
-
89
- function readText(filePath, limit = 12000) {
90
- try {
91
- const text = fs.readFileSync(filePath, "utf8");
92
- return text.length <= limit ? text : `${text.slice(0, limit - 1)}...`;
93
- } catch {
94
- return "(missing)";
95
- }
96
- }
97
-
98
- const now = new Date();
99
- const header = `# Codex Handoff ${yymmdd(now)}\n\nFilesystem-first fallback handoffs for compact-independent Codex sessions.\n\n`;
100
- const section = [
101
- start,
102
- `## ${timestamp(now)} ${path.basename(repo)}`,
103
- "",
104
- `- cwd: \`${repo}\``,
105
- `- reason: \`${reason}\``,
106
- `- repo_handoff: \`${repoHandoff}\``,
107
- `- resume_packet: \`${resumeFile}\``,
108
- "",
109
- "### Repo Handoff",
110
- "",
111
- readText(path.join(repo, repoHandoff), 8000).trim(),
112
- "",
113
- "### Resume Packet",
114
- "",
115
- readText(path.join(repo, resumeFile), 8000).trim(),
116
- "",
117
- end,
118
- "",
119
- ].join("\n");
120
-
121
- let content = fs.existsSync(globalFile) ? fs.readFileSync(globalFile, "utf8") : header;
122
- if (content.includes(start) && content.includes(end)) {
123
- const [prefix, rest] = content.split(start, 2);
124
- const suffix = rest.split(end, 2)[1] ?? "";
125
- content = prefix + section + suffix.replace(/^\n+/, "");
126
- } else {
127
- if (!content.endsWith("\n")) {
128
- content += "\n";
129
- }
130
- content += section;
131
- }
132
-
133
- fs.writeFileSync(globalFile, content, "utf8");
134
- console.log(globalFile);
135
- JS_EOF
136
- else
137
- python3 - "$global_file" "$repo" "$repo_key" "$reason" "$repo_handoff" "$resume_file" <<'PY_EOF'
138
- from __future__ import annotations
139
-
140
- import sys
141
- from datetime import datetime
142
- from pathlib import Path
143
-
144
- global_file = Path(sys.argv[1])
145
- repo = Path(sys.argv[2])
146
- repo_key = sys.argv[3]
147
- reason = sys.argv[4]
148
- repo_handoff = Path(sys.argv[5])
149
- resume_file = Path(sys.argv[6])
150
-
151
- global_file.parent.mkdir(parents=True, exist_ok=True)
152
- start = f"<!-- repo:{repo_key} start -->"
153
- end = f"<!-- repo:{repo_key} end -->"
154
-
155
- def read_text(path: Path, limit: int = 12000) -> str:
156
- try:
157
- text = path.read_text(encoding="utf-8")
158
- except OSError:
159
- return "(missing)"
160
- return text if len(text) <= limit else text[: limit - 1] + "..."
161
-
162
- header = f"# Codex Handoff {datetime.now().strftime('%y%m%d')}\n\nFilesystem-first fallback handoffs for compact-independent Codex sessions.\n\n"
163
- section = "\n".join(
164
- [
165
- start,
166
- f"## {datetime.now().strftime('%Y-%m-%d %H:%M:%S')} {repo.name}",
167
- "",
168
- f"- cwd: `{repo}`",
169
- f"- reason: `{reason}`",
170
- f"- repo_handoff: `{repo_handoff}`",
171
- f"- resume_packet: `{resume_file}`",
172
- "",
173
- "### Repo Handoff",
174
- "",
175
- read_text(repo / repo_handoff, 8000).strip(),
176
- "",
177
- "### Resume Packet",
178
- "",
179
- read_text(repo / resume_file, 8000).strip(),
180
- "",
181
- end,
182
- "",
183
- ]
184
- )
185
-
186
- content = global_file.read_text(encoding="utf-8") if global_file.exists() else header
187
- if start in content and end in content:
188
- prefix, rest = content.split(start, 1)
189
- _, suffix = rest.split(end, 1)
190
- content = prefix + section + suffix.lstrip("\n")
191
- else:
192
- if not content.endswith("\n"):
193
- content += "\n"
194
- content += section
195
-
196
- global_file.write_text(content, encoding="utf-8")
197
- print(global_file)
198
- PY_EOF
199
- fi
200
-
201
- if [[ -n "$resume_output" ]]; then
202
- printf '%s\n' "$resume_output"
203
- fi
3
+ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
4
+ exec "$SCRIPT_DIR/lib/run-forge-helper.sh" "prepare-codex-handoff.sh" "$@"
@@ -1,81 +1,4 @@
1
1
  #!/bin/bash
2
2
  set -euo pipefail
3
-
4
3
  SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
5
- if REPO_ROOT="$(git -C "$SCRIPT_DIR" rev-parse --show-toplevel 2>/dev/null)"; then
6
- cd "$REPO_ROOT"
7
- elif [[ "$SCRIPT_DIR" == */.ai/harness/scripts ]]; then
8
- cd "$SCRIPT_DIR/../../.."
9
- else
10
- cd "$SCRIPT_DIR/.."
11
- fi
12
-
13
- reason="manual"
14
- mode="write"
15
- while [[ $# -gt 0 ]]; do
16
- case "$1" in
17
- --reason)
18
- reason="${2:-}"
19
- [[ -n "$reason" ]] || { echo "prepare-handoff: --reason requires a value" >&2; exit 2; }
20
- shift 2
21
- ;;
22
- --status)
23
- mode="status"
24
- shift
25
- ;;
26
- --help|-h)
27
- cat <<'USAGE_EOF'
28
- Usage: scripts/prepare-handoff.sh [reason]
29
- scripts/prepare-handoff.sh --reason <reason>
30
- scripts/prepare-handoff.sh --status
31
- USAGE_EOF
32
- exit 0
33
- ;;
34
- *)
35
- reason="$1"
36
- shift
37
- ;;
38
- esac
39
- done
40
-
41
- if [[ -f ".ai/hooks/lib/workflow-state.sh" ]]; then
42
- # shellcheck source=/dev/null
43
- . ".ai/hooks/lib/workflow-state.sh"
44
- if [[ "$mode" == "status" ]]; then
45
- echo "Active plan: $(get_active_plan || printf '(none)')"
46
- echo "Active contract: $(workflow_active_contract || printf '(none)')"
47
- echo "Review file: $(workflow_active_review || printf '(none)')"
48
- echo "Handoff: $(workflow_session_continuation_file)"
49
- echo "Resume packet: $(workflow_resume_packet_file)"
50
- echo "Checks: $(workflow_checks_file)"
51
- exit 0
52
- fi
53
- workflow_write_session_continuation "$reason"
54
- echo "Updated $(workflow_session_continuation_file)"
55
- if [[ "${FORGE_SKIP_RESUME_REFRESH:-0}" != "1" && -f "scripts/codex-handoff-resume.sh" ]]; then
56
- bash scripts/codex-handoff-resume.sh --cwd "$(pwd -P)" --reason "$reason" >/dev/null
57
- fi
58
- exit 0
59
- fi
60
-
61
- if [[ "$mode" == "status" ]]; then
62
- echo "Active plan: (none)"
63
- echo "Active contract: (none)"
64
- echo "Review file: (none)"
65
- echo "Handoff: .ai/harness/session/continuation.md"
66
- echo "Resume packet: .ai/harness/session/resume.md"
67
- echo "Checks: .ai/harness/checks/latest.json"
68
- exit 0
69
- fi
70
-
71
- mkdir -p .ai/harness/session .ai/harness/controller/packets .ai/harness/projections .ai/harness/transfers
72
- cat > .ai/harness/session/continuation.md <<EOF_HANDOFF
73
- # Forge Session Continuation Snapshot
74
-
75
- > **Generated**: $(date '+%Y-%m-%d %H:%M:%S')
76
- > **Reason**: ${reason}
77
- EOF_HANDOFF
78
- echo "Updated .ai/harness/session/continuation.md"
79
- if [[ "${FORGE_SKIP_RESUME_REFRESH:-0}" != "1" && -f "scripts/codex-handoff-resume.sh" ]]; then
80
- bash scripts/codex-handoff-resume.sh --cwd "$(pwd -P)" --reason "$reason" >/dev/null
81
- fi
4
+ exec "$SCRIPT_DIR/lib/run-forge-helper.sh" "prepare-handoff.sh" "$@"