feat: support simple projects and root Git repositories
Allow registering a single Git repository at the engineering project root with --path . while retaining path safety checks. Document Git-optional projects first and cover plain folders, root repositories, and multiple repositories in process tests and native smoke scenarios. Validated with 23 passing tests and macOS ARM64 native smoke checks for all three layouts.
This commit is contained in:
+15
-2
@@ -6,6 +6,18 @@ The engineering root is the parent of `.ai-engineering`. Repository paths resolv
|
||||
against that root, independently of the CLI's current directory. Discovery searches
|
||||
upward or accepts an explicit `--project` root (or `.ai-engineering` directory).
|
||||
|
||||
An engineering project may be a simple source folder without Git, one Git repository,
|
||||
or a workspace containing several repositories. All three use the same Work protocol.
|
||||
Initialize directly in the folder that represents the desired project scope. An empty
|
||||
`repositories: []` is valid; Works need no repository references to persist discussions,
|
||||
decisions, artifacts and context. Git is invoked only when inspecting registered
|
||||
repositories. Without repository references, a Work has no Git revision snapshots.
|
||||
|
||||
For a single Git repository at the engineering root, register it with `path: "."`
|
||||
and `type: linked-git`. Registration remains explicit; initialization does not create
|
||||
or register a Git repository. For multiple repositories, register their relative
|
||||
subdirectory paths as in the example below.
|
||||
|
||||
```yaml
|
||||
schemaVersion: 1
|
||||
project:
|
||||
@@ -30,8 +42,9 @@ never executable through this release. Unknown fields and schema versions fail v
|
||||
|
||||
Absolute repository paths, `..` components, backslashes and symlinks beneath the root
|
||||
are rejected, including links that point inside the root. This stricter initial rule
|
||||
avoids ambiguous link policies. Repositories cannot be the engineering root or live
|
||||
inside `.ai-engineering`. Git inspection verifies an independent repository top-level;
|
||||
avoids ambiguous link policies. A linked Git repository may be the engineering root;
|
||||
repositories cannot live inside `.ai-engineering`. Git inspection verifies the registered
|
||||
path is a repository top-level;
|
||||
submodule registration additionally verifies its superproject. Paths must exist.
|
||||
No submodules are automatically created, moved or updated.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user