v0.9.0

Smartappli · web-flow · commit d1af6ee7bdfb · 2026-03-16T20:05:11.000+01:00
diff --git a/docs/certification.md b/docs/certification.md
@@ -1,6 +1,6 @@
-# Compatibility certification notes for PyBehaviorLog 0.8.9
+# Compatibility certification notes for PyBehaviorLog 0.9
 
-PyBehaviorLog 0.8.9 introduces a small built-in compatibility corpus and round-trip comparison helpers.
+PyBehaviorLog 0.9 introduces a small built-in compatibility corpus and round-trip comparison helpers.
 
 ## Included fixture families
 
@@ -14,7 +14,7 @@ These fixtures are intentionally compact. They are meant to verify the documente
 
 ## Round-trip strategy
 
-The 0.8.9 test suite validates compatibility with this workflow:
+The 0.9 test suite validates compatibility with this workflow:
 
 1. Import a BORIS or CowLog fixture.
 2. Persist the imported content in the Django data model.
@@ -38,7 +38,7 @@ This allows CI to focus on semantic equivalence instead of raw JSON shape differ
 
 ## Current scope
 
-0.8.9 improves confidence, but it is still not a blanket claim of universal compatibility with every historical BORIS or CowLog artifact.
+0.9 improves confidence, but it is still not a blanket claim of universal compatibility with every historical BORIS or CowLog artifact.
 
 What it does provide is a **repeatable, testable certification baseline** for the documented exchange families that the project already supports.
 
@@ -53,6 +53,16 @@ A future certification pass can extend the fixture corpus with:
 - gold files captured from real-world operator datasets
 
 
-## Additional notes for 0.8.9
+## Additional notes for 0.9
 
-Version 0.8.9 extends the compatibility and review toolchain with server-side undo/redo for event operations, broader BORIS-style spreadsheet imports, and richer handling of picture-based media paths and image sequences.
+Version 0.9 extends the compatibility and review toolchain with server-side undo/redo for event operations, broader BORIS-style spreadsheet imports, and richer handling of picture-based media paths and image sequences.
+
+
+## Operational additions in 0.9
+
+Version 0.9 adds a project lifecycle layer on top of the existing compatibility tooling:
+
+- project import as a **new project** from BORIS project JSON or PyBehaviorLog bundles
+- project cloning for parallel review, training, or branching workflows
+- deployment-oriented `/health/` and `/release.json` endpoints
+- management commands for bundle export and release reporting
diff --git a/docs/compatibility.md b/docs/compatibility.md
@@ -1,10 +1,10 @@
-# Compatibility profile for PyBehaviorLog 0.8.9
+# Compatibility profile for PyBehaviorLog 0.9
 
-PyBehaviorLog 0.8.9 strengthens interoperability with BORIS and CowLog around the formats and workflows that are publicly documented.
+PyBehaviorLog 0.9 strengthens interoperability with BORIS and CowLog around the formats and workflows that are publicly documented.
 
 ## BORIS coverage
 
-### Implemented in 0.8.9
+### Implemented in 0.9
 
 - BORIS-compatible observation JSON export
 - BORIS-compatible project JSON export
@@ -28,7 +28,7 @@ The safest paths are:
 
 ## CowLog coverage
 
-### Implemented in 0.8.9
+### Implemented in 0.9
 
 - Import of documented CowLog-like plain-text coding result files
 - Export of CowLog-compatible plain-text result files
@@ -37,7 +37,7 @@ The safest paths are:
 
 ### Current positioning
 
-CowLog compatibility in 0.8.9 focuses on the **documented plain-text coding result workflow**.
+CowLog compatibility in 0.9 focuses on the **documented plain-text coding result workflow**.
 
 CowLog plain-text exports do not preserve all PyBehaviorLog/BORIS semantics with the same fidelity, especially for:
 
@@ -51,7 +51,7 @@ For those cases, BORIS JSON and PyBehaviorLog JSON remain the preferred intercha
 
 ## Built-in certification baseline
 
-Version 0.8.9 adds a compact fixture corpus and automated round-trip tests for:
+Version 0.9 adds a compact fixture corpus and automated round-trip tests for:
 
 - BORIS observation JSON
 - BORIS project JSON
@@ -61,7 +61,7 @@ Those fixtures are executed in the Django test suite and compared through normal
 
 ## Compatibility reports
 
-PyBehaviorLog 0.8.9 adds machine-readable compatibility reports at both project and session level.
+PyBehaviorLog 0.9 adds machine-readable compatibility reports at both project and session level.
 
 They summarize:
 
@@ -84,14 +84,24 @@ If you want to move toward a stronger "certified compatibility" claim, use this
 That approach is the right path toward a future compatibility certification release.
 
 
-### Added in 0.8.9
+### Added in 0.9
 
 - BORIS-style tabular session imports from CSV, TSV, and XLSX files
 - relative media paths included in project/session JSON payloads and reproducibility bundles
 - lightweight media diagnostics for compatible local audio files, including waveform previews and a coarse spectrogram
 - additional HTML and SQL exports for review and downstream analysis pipelines
 
 
-## Additional notes for 0.8.9
+## Additional notes for 0.9
 
-Version 0.8.9 extends the compatibility and review toolchain with server-side undo/redo for event operations, broader BORIS-style spreadsheet imports, and richer handling of picture-based media paths and image sequences.
+Version 0.9 extends the compatibility and review toolchain with server-side undo/redo for event operations, broader BORIS-style spreadsheet imports, and richer handling of picture-based media paths and image sequences.
+
+
+## Operational additions in 0.9
+
+Version 0.9 adds a project lifecycle layer on top of the existing compatibility tooling:
+
+- project import as a **new project** from BORIS project JSON or PyBehaviorLog bundles
+- project cloning for parallel review, training, or branching workflows
+- deployment-oriented `/health/` and `/release.json` endpoints
+- management commands for bundle export and release reporting
diff --git a/docs/fao_translation_review.md b/docs/fao_translation_review.md
@@ -1,12 +1,12 @@
-# FAO language review package for PyBehaviorLog 0.8.9
+# FAO language review package for PyBehaviorLog 0.9
 
 This document is a preparation pack for native review of the six supported FAO languages:
 English, Arabic, Chinese (Simplified), Spanish, French, and Russian.
 
 ## Scope
 
 The application already contains translation catalogs for the core user interface.
-Version 0.8.9 adds new user-facing strings in the following areas:
+Version 0.9 adds new user-facing strings in the following areas:
 
 - BORIS project import
 - interactive timeline selection
diff --git a/docs/roadmap.md b/docs/roadmap.md
@@ -0,0 +1,16 @@
+# PyBehaviorLog 0.9 operational roadmap
+
+Version 0.9 focuses on project lifecycle operations rather than adding another isolated coding feature.
+
+## Added in 0.9
+
+- Create a new project directly from a BORIS project file or a PyBehaviorLog reproducibility bundle.
+- Clone an existing project for iterative coding or teaching workflows.
+- Expose release metadata and health endpoints for deployment tooling.
+- Add management commands to integrate export and release inspection into CI/CD or scheduled jobs.
+
+## Next candidates after 0.9
+
+- Segment-level assignment and review queues.
+- More advanced media diagnostics across video/audio/image directories.
+- Larger compatibility certification corpus for BORIS and CowLog round-trips.
diff --git a/templates/base.html b/templates/base.html
@@ -4,7 +4,7 @@
 <head>
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1">
-    <title>{% block title %}PyBehaviorLog 0.8.9{% endblock %}</title>
+    <title>{% block title %}PyBehaviorLog 0.9{% endblock %}</title>
     <link rel="stylesheet" href="{% static 'tracker/app.css' %}">
 </head>
 <body>
@@ -14,7 +14,7 @@
                 <a class="brand-mark" href="{% url 'tracker:home' %}">PB</a>
                 <div>
                     <p class="eyebrow">{% trans 'Behavioral coding studio' %}</p>
-                    <h1 class="brand-title"><a href="{% url 'tracker:home' %}">PyBehaviorLog 0.8.9</a></h1>
+                    <h1 class="brand-title"><a href="{% url 'tracker:home' %}">PyBehaviorLog 0.9</a></h1>
                 </div>
             </div>
             <div class="utility-row">
diff --git a/templates/tracker/home.html b/templates/tracker/home.html
@@ -9,9 +9,12 @@
 <header class="page-header">
     <div>
         <h1>{% trans 'My PyBehaviorLog projects' %}</h1>
-        <p>{% trans 'Version 0.8.9 adds server-side undo and redo, richer BORIS-style spreadsheet imports, stronger image-sequence diagnostics, and a more certifiable coding workflow.' %}</p>
+        <p>{% trans 'Version 0.9 adds project lifecycle operations: import as a new project, project cloning, release metadata, and deployment-oriented health checks.' %}</p>
+    </div>
+    <div class="action-stack compact">
+        <a href="{% url 'tracker:project_create' %}" role="button">{% trans 'New project' %}</a>
+        <a href="{% url 'tracker:project_import_create' %}" role="button" class="secondary">{% trans 'Import as new project' %}</a>
     </div>
-    <a href="{% url 'tracker:project_create' %}" role="button">{% trans 'New project' %}</a>
 </header>
 
 <section class="card-grid">
@@ -38,6 +41,7 @@ <h3><a href="{{ project.get_absolute_url }}">{{ project.name }}</a></h3>
                 <a href="{{ project.get_absolute_url }}" role="button" class="secondary">{% trans 'Open' %}</a>
                 <a href="{% url 'tracker:project_analytics' project.pk %}" role="button" class="outline">{% trans 'Analytics' %}</a>
                 <a href="{% url 'tracker:project_export_ethogram' project.pk %}" role="button" class="outline">{% trans 'Ethogram JSON' %}</a>
+                {% if project.owner_id == user.id %}<a href="{% url 'tracker:project_clone' project.pk %}" role="button" class="outline">{% trans 'Clone' %}</a>{% endif %}
             </div>
         </article>
     {% empty %}
diff --git a/templates/tracker/project_clone_form.html b/templates/tracker/project_clone_form.html
@@ -0,0 +1,18 @@
+{% extends 'base.html' %}
+{% load i18n %}
+{% block title %}{% trans 'Clone project' %}{% endblock %}
+{% block content %}
+<article class="auth-card wide-card">
+    <h1>{% trans 'Clone project' %}</h1>
+    <p>{% trans 'Source project' %}: <a href="{{ project.get_absolute_url }}">{{ project.name }}</a></p>
+    <p class="muted">{% trans 'Cloning duplicates the project structure, ethogram, templates, keyboard profiles, and optionally the current sessions and video asset metadata.' %}</p>
+    <form method="post">
+        {% csrf_token %}
+        {{ form.as_p }}
+        <div class="action-stack">
+            <button type="submit">{% trans 'Clone project' %}</button>
+            <a href="{{ project.get_absolute_url }}" role="button" class="secondary">{% trans 'Back' %}</a>
+        </div>
+    </form>
+</article>
+{% endblock %}
diff --git a/templates/tracker/project_detail.html b/templates/tracker/project_detail.html
@@ -25,6 +25,7 @@ <h1>{{ project.name }}</h1>
         {% if can_manage_members %}
             <a href="{% url 'tracker:project_import_ethogram' project.pk %}" role="button" class="secondary">{% trans 'Import ethogram' %}</a>
             <a href="{% url 'tracker:project_import_boris_json' project.pk %}" role="button" class="secondary">{% trans 'Import compatibility project' %}</a>
+            <a href="{% url 'tracker:project_clone' project.pk %}" role="button" class="secondary">{% trans 'Clone project' %}</a>
             <a href="{% url 'tracker:project_update' project.pk %}" role="button" class="contrast">{% trans 'Settings' %}</a>
         {% endif %}
     </div>
@@ -44,7 +45,7 @@ <h3>{% trans 'Quick overview' %}</h3>
     </article>
     <article>
         <h3>{% trans 'Team and reproducibility' %}</h3>
-        <p>{% trans 'This project now tracks explicit roles, reusable keyboard profiles, and a reproducibility export bundle for scientific archiving.' %}</p>
+        <p>{% trans 'This project now tracks explicit roles, reusable keyboard profiles, reproducibility bundles, and can be cloned or imported into new projects for operational reuse.' %}</p>
     </article>
 </section>
 
diff --git a/templates/tracker/project_import_create.html b/templates/tracker/project_import_create.html
@@ -0,0 +1,17 @@
+{% extends 'base.html' %}
+{% load i18n %}
+{% block title %}{% trans 'Import a new project' %}{% endblock %}
+{% block content %}
+<article class="auth-card wide-card">
+    <h1>{% trans 'Import as a new project' %}</h1>
+    <p class="muted">{% trans 'Create a brand new project directly from a BORIS project JSON or a PyBehaviorLog reproducibility bundle ZIP/JSON.' %}</p>
+    <form method="post" enctype="multipart/form-data">
+        {% csrf_token %}
+        {{ form.as_p }}
+        <div class="action-stack">
+            <button type="submit">{% trans 'Create imported project' %}</button>
+            <a href="{% url 'tracker:home' %}" role="button" class="secondary">{% trans 'Back' %}</a>
+        </div>
+    </form>
+</article>
+{% endblock %}
