From 84eeaf8a130a6e070741fc36bb3a8bb44a0a08b6 Mon Sep 17 00:00:00 2001 From: NagyVikt Date: Fri, 8 May 2026 23:54:31 +0200 Subject: [PATCH] Remove broken Agentic-Flow submodule The prior repair added .gitmodules for examples/agentic-flow, but the pinned upstream checkout contains its own broken nested submodule metadata. A recursive GitHub checkout cleanup can still fail inside that source. Colony only uses Agentic-Flow as documentation-only research evidence, so keeping a live submodule is unnecessary release risk. Constraint: docs/agentic-bridge.md explicitly says Agentic-Flow must not become vendored source or a runtime dependency. Rejected: Keep the submodule with top-level metadata | recursive cleanup still fails when the submodule checkout is present locally or in any future submodule-enabled checkout. Rejected: Vendor selected Agentic-Flow files | violates the documentation-only source-use rule. Confidence: high Scope-risk: narrow Directive: Cite upstream Agentic-Flow URLs in docs; do not re-add examples/agentic-flow as a gitlink unless upstream nested submodule metadata is valid and CI cleanup is proven. Tested: git ls-files -s has no 160000 entries; git submodule foreach --recursive sh -c "git config --local --name-only --get-regexp 'core\.sshCommand' && git config --local --unset-all 'core.sshCommand' || :"; git diff --check Co-authored-by: OmX --- .gitmodules | 3 --- docs/agentic-bridge.md | 14 +++++++------- examples/agentic-flow | 1 - 3 files changed, 7 insertions(+), 11 deletions(-) delete mode 100644 .gitmodules delete mode 160000 examples/agentic-flow diff --git a/.gitmodules b/.gitmodules deleted file mode 100644 index 8a6c87c3..00000000 --- a/.gitmodules +++ /dev/null @@ -1,3 +0,0 @@ -[submodule "examples/agentic-flow"] - path = examples/agentic-flow - url = https://github.com/ruvnet/agentic-flow.git diff --git a/docs/agentic-bridge.md b/docs/agentic-bridge.md index 335c09fc..ffa2dd93 100644 --- a/docs/agentic-bridge.md +++ b/docs/agentic-bridge.md @@ -1,9 +1,9 @@ # Agentic Bridge Research Notes This document records the narrow patterns Colony should port from -`examples/agentic-flow` and `https://github.com/ruvnet/ruvector`. It is a -research anchor for waves 2-5, not an implementation spec and not permission to -vendor either project. +`https://github.com/ruvnet/agentic-flow` and `https://github.com/ruvnet/ruvector`. +It is a research anchor for waves 2-5, not an implementation spec and not +permission to vendor either project. ## Pattern catalog @@ -17,7 +17,7 @@ improvement chain by attempt. Colony gains a task-scoped observation kind for structured post-failure learning without changing the write path: handoff expiry, declined quota claims, and failed approaches can become searchable learning signals instead of prose-only notes. Evidence: -`examples/agentic-flow/src/controllers/reflexion-memory.ts`, +`https://github.com/ruvnet/agentic-flow/blob/f31065cabd423b53748fd94a86f9e2b919ee070b/src/controllers/reflexion-memory.ts`, `packages/core/src/task-thread.ts`, `packages/core/src/memory-store.ts`, `packages/storage/src/types.ts`. Rough effort: medium; schema/type changes plus three writer call sites and search/render support, but no external runtime. @@ -30,7 +30,7 @@ bounded retries with deterministic backoff around transient local operations such as embedding generation, GitHub/CLI polling, or bridge-status refresh. Colony gains less flaky wave execution while preserving explicit failure surface area when retries exhaust. Evidence: -`examples/agentic-flow/src/notifications/notification-manager.ts`, +`https://github.com/ruvnet/agentic-flow/blob/f31065cabd423b53748fd94a86f9e2b919ee070b/src/notifications/notification-manager.ts`, `packages/embedding/src/index.ts`, `packages/core/src/omx-runtime-summary.ts`. Rough effort: small-to-medium; one shared retry helper and focused adoption at callers that already have recoverable transient failures. @@ -105,8 +105,8 @@ backfill tests make this a later wave. may cite their files and URLs, but Colony must keep its own types, storage, tests, and release surface. - Documentation-only source use: do not vendor source from - `examples/agentic-flow` or `ruvnet/ruvector`; cite it as evidence and port - only the behavior shape that matches Colony invariants. + `ruvnet/agentic-flow` or `ruvnet/ruvector`; cite it as evidence and port only + the behavior shape that matches Colony invariants. ## Wave map diff --git a/examples/agentic-flow b/examples/agentic-flow deleted file mode 160000 index f31065ca..00000000 --- a/examples/agentic-flow +++ /dev/null @@ -1 +0,0 @@ -Subproject commit f31065cabd423b53748fd94a86f9e2b919ee070b