Compare commits

...
Author SHA1 Message Date
Richard Zink e150de3c93 Release v202611-00055 2026-11-17 14:05:16 +01:00
Richard ZinkandClaude Sonnet 5.5 a0c95a035c New project: preselect the workspace, label the factory folder
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-17 14:05:15 +01:00
Richard Zink 843194b429 Release v202611-00054 2026-11-17 13:37:17 +01:00
Richard ZinkandClaude Sonnet 5.5 462171f27b README: explain the code factory
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-17 13:37:16 +01:00
Richard Zink 18818c1bd4 Release v202611-00053 2026-11-17 07:03:34 +01:00
Richard ZinkandClaude Sonnet 5.5 d644c97dd9 Changelog: unreleased entry
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-17 07:03:34 +01:00
Richard ZinkandClaude Sonnet 5.5 0a724142ff Factory: read the current version from the remote tags
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-17 06:58:14 +01:00
6 changed files with 137 additions and 6 deletions

No files matched your search

+21
View File
@@ -3,6 +3,27 @@
All notable changes to CodeCraft. Versions follow [Semantic Versioning](https://semver.org/); All notable changes to CodeCraft. Versions follow [Semantic Versioning](https://semver.org/);
until 1.0, minor versions may contain breaking changes. until 1.0, minor versions may contain breaking changes.
## [v202611-00055] – 2026-11-17
### Fixed
- **New project from a Git repository:** the wizard no longer clones into the factory area by default
("target folder already exists" when the factory had checked out the same repository); your workspace is
preselected, and the factory area is labelled as such in the folder list.
## [v202611-00053] – 2026-11-17
### Fixed
- **Factory versioning.** The current version is read from the tags on the forge, not from the checkout
(which kept tags that were deleted there and so counted from a stale version).
## [v202611-00054] – 2026-11-17
### Changed
- **README:** new "Code factory" section explaining phases, scope, planning chats, versions and releases.
## [v202611-00052] – 2026-11-17 ## [v202611-00052] – 2026-11-17
### Fixed ### Fixed
+86 -1
View File
@@ -11,7 +11,7 @@
</p> </p>
<p align="center"> <p align="center">
<img alt="Version v202611-00052" src="https://img.shields.io/badge/version-v202611--00052-d69e2e?style=flat-square"> <img alt="Version v202611-00055" src="https://img.shields.io/badge/version-v202611--00055-d69e2e?style=flat-square">
<img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-689d6a?style=flat-square"> <img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-689d6a?style=flat-square">
<img alt="Rust backend" src="https://img.shields.io/badge/backend-Rust-b7410e?style=flat-square&logo=rust"> <img alt="Rust backend" src="https://img.shields.io/badge/backend-Rust-b7410e?style=flat-square&logo=rust">
<img alt="React PWA" src="https://img.shields.io/badge/frontend-React%20PWA-2d81ff?style=flat-square&logo=react"> <img alt="React PWA" src="https://img.shields.io/badge/frontend-React%20PWA-2d81ff?style=flat-square&logo=react">
@@ -25,6 +25,7 @@
<a href="#models">Models</a> · <a href="#models">Models</a> ·
<a href="#terminal-client">Terminal client</a> · <a href="#terminal-client">Terminal client</a> ·
<a href="#automations">Automations</a> · <a href="#automations">Automations</a> ·
<a href="#code-factory">Code factory</a> ·
<a href="#integrations">Integrations</a> · <a href="#integrations">Integrations</a> ·
<a href="#users-and-security">Users</a> · <a href="#users-and-security">Users</a> ·
<a href="#statistics">Statistics</a> · <a href="#statistics">Statistics</a> ·
@@ -219,6 +220,90 @@ read and continue it.
**Webhooks** start an automation from outside, e.g. on every push: the request is checked with a **Webhooks** start an automation from outside, e.g. on every push: the request is checked with a
shared secret or a Gitea/GitHub HMAC signature, and its JSON payload is handed to the agent. shared secret or a Gitea/GitHub HMAC signature, and its JSON payload is handed to the agent.
## Code factory
The factory turns issues on your Git forge (Gitea, GitHub or GitLab) into reviewed, built, accepted and
merged changes – with agents doing the work and you deciding at the points that matter. It is
the **Factory** page in the sidebar; all chats it creates live in the sidebar folder *Factory*.
```
issue + label "factory"
│
▼
review ──► question (the agent asks in the issue; you answer, it continues)
│ └──► rejected (not buildable as written)
▼
approved ──► building ──► qa (acceptance) ──► done ──► PR merged ──► version + tag ──► closed
▲ │
└── rework ◄──┘ (up to N rounds, then failed)
```
**Phases.** Each phase is a normal CodeCraft chat in the sandbox, so you can open and read it.
The agent's answer ends with a JSON result that the factory parses; everything else is done by
the server.
1. **Review.** An agent reads the issue and the repository and decides: *approved*, *question*
(it comments in the issue and waits for your reply) or *rejected*. It also writes acceptance
scenarios. The scenarios are stored in the factory database and are **never shown to the
builder**, so the build cannot be tuned to the test.
2. **Build.** The builder works in its own git worktree on the branch `factory/issue-<n>`.
The server – not the agent – commits, pushes (never forced) and restores the spec file.
3. **Acceptance.** A different agent checks the pushed branch in a clean checkout against the
scenarios, using the repository's `.factory/setup.json` to build and start the app. Each
scenario ends as `pass`, `fail`, `unverified` or `out_of_scope`; the verdict comes from these
results, not from the model's opinion, and a run without any pass or fail counts as failed.
On *pass* the factory opens the pull request (if none is open) and comments a result table
in the issue. On *fail* the issue goes back to the build with the findings (*rework*).
4. **Done, merge, version.** You review the pull request in the factory (diff, description) and
merge it there. The factory then pulls the merge, gives the issue its version, commits
`VERSION`, pushes an annotated tag, comments on the issue and closes it.
Issue text is treated as data, never as instructions for the factory itself.
**Scope.** An issue body can contain `Spec: <file>` and `Scope: <deliverable>` lines. Review,
build and acceptance then restrict themselves to that deliverable, so a big specification is
built in small steps instead of one huge run. Without a `Scope:` line the review picks the
first unbuilt milestone of the spec. `Prerequisite:` lines name what must be merged first.
**Planning with a model.** Three chats help you create issues, without the usual review loop:
- **Spec chat** (*New project*): works out a specification with you and creates the repository
with `docs/specs/<name>.md`, the factory setup and the first issues.
- **Plan a feature**: you describe a feature or a bug; the model asks questions and ends with a
list of issues (title, description, scope, prerequisites).
- **Cut a milestone**: the model splits a milestone of the spec into numbered deliverables
(`M2.1 – …`).
*Create issues* shows the proposal for editing and files the issues on the forge. They get the
`factory` label only if you tick *Start right away*; by default you set the label yourself,
one after the other, because later issues build on the merged earlier ones.
**Versions and releases.** Every issue that is merged raises the version of the repository
(starting from the highest `vX.Y.Z` tag): a deliverable of a milestone raises the **patch**
number (0.0.1, 0.0.2, …); the **last** open deliverable of a milestone (`M<k>.<n>`) raises the
**minor** number and resets the patch (M1 complete → 0.1.0). Issues without a milestone
(bugs, features) raise the patch number. The factory writes the `VERSION` file, pushes the tag
`vX.Y.Z` and closes the issue. The **Release** button turns the current version into a
release, e.g. 0.x → 1.0.0: it builds what the repository's `.factory/release.json` describes
(Docker image for amd64 and arm64 pushed to your registry, a source zip, extra files by glob,
shell commands), tags it and creates the release on the forge with notes from the git log and
the files attached (Gitea and GitHub).
**Settings per repository** (*Factory → Repositories*, *New repository*): forge connection and token, label
(default `factory`), parallel runs, allowed issue authors (default: the token's owner), and per
phase the model, agent (CodeCraft or Claude Code), permission mode, timeout and tries on
technical failures, plus the number of rework rounds (default 2). Failed or rejected issues
can be restarted from the board, finished ones are closed with a comment.
**Files in the repository** (all optional, kept in `.factory/`):
| File | Purpose |
|---|---|
| `setup.json` | How acceptance installs and starts the app: `install`, `start`, `url` |
| `release.json` | Recipe for releases: image, platforms, Dockerfile, build args, commands, files |
Repositories are cloned into a separate factory area, not into your workspace, and agents never see the forge API token.
## Integrations ## Integrations
- **Telegram:** connect your own bot (*Settings → Account → Telegram*) and use CodeCraft from - **Telegram:** connect your own bot (*Settings → Account → Telegram*) and use CodeCraft from
+7 -2
View File
@@ -1830,8 +1830,13 @@ async fn list_roots(Extension(user): Extension<User>, State(app): State<AppState
.user_roots(Some(&user.id)) .user_roots(Some(&user.id))
.into_iter() .into_iter()
.map(|r| { .map(|r| {
let rel = r.strip_prefix(&ws).map(|p| p.display().to_string()).unwrap_or_default(); let name = match r.strip_prefix(&ws) {
json!({"path": r, "name": if rel.is_empty() { "/".to_string() } else { rel }}) Ok(p) if p.as_os_str().is_empty() => "/".to_string(),
Ok(p) => p.display().to_string(),
// Outside the workspace (e.g. the factory area): show where it is, not "workspace".
Err(_) => format!("{} (factory)", r.file_name().and_then(|n| n.to_str()).unwrap_or("")).replace(" ()", ""),
};
json!({"path": r, "name": name})
}) })
.collect(); .collect();
Json(json!(roots)) Json(json!(roots))
+10 -2
View File
@@ -80,8 +80,16 @@ pub fn next_version(cur: Ver, b: Bump) -> Ver {
/// Highest `vX.Y.Z` tag of the remote (0.0.0 when there is none). /// Highest `vX.Y.Z` tag of the remote (0.0.0 when there is none).
async fn tags_version(cfg: &RepoCfg, dir: &Path) -> Ver { async fn tags_version(cfg: &RepoCfg, dir: &Path) -> Ver {
let _ = git(cfg, dir, &["fetch", "--tags", "--force", "origin"]).await; // The remote is the truth: a local checkout keeps tags that were deleted on the forge.
git(cfg, dir, &["tag", "-l", "v[0-9]*"]).await.unwrap_or_default().lines().filter_map(parse_version).max().unwrap_or((0, 0, 0)) let remote = git(cfg, dir, &["ls-remote", "--tags", "--refs", "origin", "v[0-9]*"]).await;
let names: Vec<String> = match remote {
Ok(out) => out.lines().filter_map(|l| l.split("refs/tags/").nth(1)).map(str::to_string).collect(),
Err(_) => {
let _ = git(cfg, dir, &["fetch", "--tags", "--force", "origin"]).await;
git(cfg, dir, &["tag", "-l", "v[0-9]*"]).await.unwrap_or_default().lines().map(str::to_string).collect()
}
};
names.iter().filter_map(|t| parse_version(t)).max().unwrap_or((0, 0, 0))
} }
/// `git pull --ff-only` of the default branch in the main checkout, so everything that was merged /// `git pull --ff-only` of the default branch in the main checkout, so everything that was merged
+1 -1
View File
@@ -193,7 +193,7 @@ export function NewSession({ onMenu, onCreated }: { onMenu: () => void; onCreate
if (!model && config?.default_model) setModel(config.default_model); if (!model && config?.default_model) setModel(config.default_model);
}, [config, model]); }, [config, model]);
useEffect(() => { useEffect(() => {
if (!rootPath && roots.length) setRootPath(roots[roots.length - 1].path); if (!rootPath && roots.length) setRootPath(roots[0].path);
}, [roots, rootPath]); }, [roots, rootPath]);
// Old software is analysed in deep mode; websites default to clean room. // Old software is analysed in deep mode; websites default to clean room.
useEffect(() => { useEffect(() => {
+12
View File
@@ -3,6 +3,18 @@
* under "unreleased"; scripts/release.sh renames the key to the release version. * under "unreleased"; scripts/release.sh renames the key to the release version.
*/ */
export const WHATS_NEW: Record<string, { en: string[]; de: string[] }> = { export const WHATS_NEW: Record<string, { en: string[]; de: string[] }> = {
"202611-00055": {
en: ["Fixed: cloning a repository for a new project no longer ends up in the factory area"],
de: ["Behoben: Klonen eines Repositorys für ein neues Projekt landet nicht mehr in der Factory-Ablage"],
},
"202611-00054": {
en: ["README: new section explaining the code factory"],
de: ["README: neuer Abschnitt zur Code-Factory"],
},
"202611-00053": {
en: ["Factory: the current version is read from the tags on the forge"],
de: ["Factory: die aktuelle Version wird aus den Tags im Forge gelesen"],
},
"202611-00052": { "202611-00052": {
en: ["Factory: fixed versioning – deliverables raise the patch version, only the last one of a milestone raises the minor version"], en: ["Factory: fixed versioning – deliverables raise the patch version, only the last one of a milestone raises the minor version"],
de: ["Factory: Versionierung korrigiert – Deliverables erhöhen die Patch-Version, nur das letzte eines Meilensteins die Minor-Version"], de: ["Factory: Versionierung korrigiert – Deliverables erhöhen die Patch-Version, nur das letzte eines Meilensteins die Minor-Version"],