cfsa-antigravity 3.1.0 → 3.1.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.
- package/README.md +2 -1
- package/bin/cli.mjs +2 -1
- package/package.json +1 -1
- package/template/.agent/workflows/sync-kit.md +9 -4
- package/template/.claude/skills/sync-kit/SKILL.md +2 -2
- package/template/.codex/skills/sync-kit/SKILL.md +2 -2
- package/template/.factory/README.md +4 -3
- package/template/.factory/skills/sync-kit/SKILL.md +2 -2
- package/template/.memory/pipeline/kit-sync.md +11 -0
- package/template/docs/progress-state-catalog.md +9 -0
- package/template/.agent/kit-sync.md +0 -6
- package/template/.claude/kit-sync.md +0 -6
- package/template/.codex/kit-sync.md +0 -6
- package/template/.factory/kit-sync.md +0 -6
package/README.md
CHANGED
|
@@ -135,7 +135,7 @@ The kit evolves independently of your project. To pull improvements into an exis
|
|
|
135
135
|
This performs a **semantic merge** — it applies new workflows, skills, and rules from the upstream kit while preserving your project-specific values (tech stack, validation commands, filled placeholders). It will never overwrite your project decisions.
|
|
136
136
|
|
|
137
137
|
- First sync does a full comparison; subsequent syncs are incremental (commit-scoped)
|
|
138
|
-
- Tracks sync state in
|
|
138
|
+
- Tracks sync state in `.memory/pipeline/kit-sync.md` so every runtime uses the same update baseline
|
|
139
139
|
- Flags any structural migrations needed (e.g., ideation format changes)
|
|
140
140
|
|
|
141
141
|
## What Init Adds
|
|
@@ -145,6 +145,7 @@ A fresh `init` now installs:
|
|
|
145
145
|
- `docs/`
|
|
146
146
|
- shared `.memory/`
|
|
147
147
|
- the shared memory MCP server/runtime under `.memory/mcp-server/`
|
|
148
|
+
- canonical kit sync state at `.memory/pipeline/kit-sync.md`
|
|
148
149
|
- the rest of the `.memory` scaffold needed to compile graph/index artifacts locally
|
|
149
150
|
|
|
150
151
|
Tool-specific MCP client config (such as `.mcp.json`) is user-managed and documented above.
|
package/bin/cli.mjs
CHANGED
|
@@ -45,7 +45,7 @@ const RUNTIME_DISPLAY = {
|
|
|
45
45
|
function discoverRuntimes() {
|
|
46
46
|
if (!existsSync(TEMPLATE_DIR)) return [];
|
|
47
47
|
return readdirSync(TEMPLATE_DIR, { withFileTypes: true })
|
|
48
|
-
.filter(e => e.isDirectory() &&
|
|
48
|
+
.filter(e => e.isDirectory() && Object.hasOwn(RUNTIME_DISPLAY, e.name))
|
|
49
49
|
.map(e => {
|
|
50
50
|
const meta = RUNTIME_DISPLAY[e.name];
|
|
51
51
|
return {
|
|
@@ -732,6 +732,7 @@ function cmdStatus() {
|
|
|
732
732
|
|
|
733
733
|
const memoryChecks = [
|
|
734
734
|
{ path: ".memory", label: "Unified memory root" },
|
|
735
|
+
{ path: ".memory/pipeline/kit-sync.md", label: "Kit sync state" },
|
|
735
736
|
{ path: ".memory/mcp-server/daemon.mjs", label: "Memory MCP daemon" },
|
|
736
737
|
{ path: ".memory/mcp-server/client.mjs", label: "Memory MCP client" },
|
|
737
738
|
{ path: ".memory/runtime", label: "Memory daemon runtime dir" },
|
package/package.json
CHANGED
|
@@ -16,10 +16,10 @@ Pull improvements from the upstream [cfsa-antigravity](https://github.com/Repair
|
|
|
16
16
|
|
|
17
17
|
## 0. Read sync state
|
|
18
18
|
|
|
19
|
-
Read `.
|
|
19
|
+
Read `.memory/pipeline/kit-sync.md` in the project root.
|
|
20
20
|
|
|
21
21
|
- **File exists** → extract `last_synced_commit`, `upstream`, and `kit_version` values. Proceed to Step 1.
|
|
22
|
-
- **File missing** → **HARD STOP**: "No sync tracking file found. This file is auto-generated during kit installation. To fix: run `npx cfsa-antigravity init --force` to reinstall the kit with sync tracking, or manually create `.
|
|
22
|
+
- **File missing** → **HARD STOP**: "No sync tracking file found. This file is auto-generated during kit installation. To fix: run `npx cfsa-antigravity init --force` to reinstall the kit with sync tracking, or manually create `.memory/pipeline/kit-sync.md` with the upstream URL and the commit hash of your last known kit version."
|
|
23
23
|
|
|
24
24
|
---
|
|
25
25
|
|
|
@@ -237,7 +237,7 @@ Read the upstream repository's `package.json` file and extract the `"version"` f
|
|
|
237
237
|
|
|
238
238
|
**Validation gate**: Before writing, verify the extracted version matches `/^\d+\.\d+\.\d+$/`. If it doesn't (e.g., it's `main`, `latest`, or empty) → **STOP**: "Could not extract a valid semver version from the upstream package.json. Found: `[value]`. Check that the upstream URL is correct and the package.json has a valid `version` field."
|
|
239
239
|
|
|
240
|
-
Write or update `.
|
|
240
|
+
Write or update `.memory/pipeline/kit-sync.md`:
|
|
241
241
|
|
|
242
242
|
```markdown
|
|
243
243
|
# Kit Sync State
|
|
@@ -246,6 +246,11 @@ upstream: https://github.com/RepairYourTech/cfsa-antigravity
|
|
|
246
246
|
last_synced_commit: <current upstream HEAD commit hash — full 40-char SHA>
|
|
247
247
|
last_synced_at: <ISO 8601 timestamp, e.g. 2026-03-17T16:04:40Z>
|
|
248
248
|
kit_version: <semver from upstream package.json "version" field, e.g. 2.10.0>
|
|
249
|
+
installed_runtimes:
|
|
250
|
+
- agent
|
|
251
|
+
- codex
|
|
252
|
+
- claude
|
|
253
|
+
- factory
|
|
249
254
|
```
|
|
250
255
|
|
|
251
256
|
This file is committed to the project repo — it records which kit version the project is on and serves as the baseline for the next sync.
|
|
@@ -259,4 +264,4 @@ This file is committed to the project repo — it records which kit version the
|
|
|
259
264
|
| **Net-new from kit** | Copy directly | N/A |
|
|
260
265
|
| **Both exist — no project values** | Overwrite with upstream | N/A |
|
|
261
266
|
| **Both exist — has project values** | Semantic merge (Step 3) | N/A |
|
|
262
|
-
| **Project-only** | **DO NOT overwrite** | **DO audit for integration gaps** (Step 5) |
|
|
267
|
+
| **Project-only** | **DO NOT overwrite** | **DO audit for integration gaps** (Step 5) |
|
|
@@ -13,11 +13,11 @@ parameters:
|
|
|
13
13
|
|
|
14
14
|
## Step-by-Step
|
|
15
15
|
|
|
16
|
-
1. Read `.
|
|
16
|
+
1. Read `.memory/pipeline/kit-sync.md` state and validate baseline.
|
|
17
17
|
2. Fetch upstream and diff changed files since last synced commit.
|
|
18
18
|
3. Classify changes (net-new, overwrite-safe, semantic-merge required, project-only).
|
|
19
19
|
4. Apply semantic merges for placeholder/value-bearing files.
|
|
20
20
|
5. Copy net-new files and run ideation-structure migration checks.
|
|
21
21
|
6. Audit project-only files for integration gaps.
|
|
22
22
|
7. Validate, review diff, and scan for unresolved placeholders.
|
|
23
|
-
8. Update `.
|
|
23
|
+
8. Update `.memory/pipeline/kit-sync.md` with new commit/version/timestamp.
|
|
@@ -13,11 +13,11 @@ parameters:
|
|
|
13
13
|
|
|
14
14
|
## Step-by-Step
|
|
15
15
|
|
|
16
|
-
1. Read `.
|
|
16
|
+
1. Read `.memory/pipeline/kit-sync.md` state and validate baseline.
|
|
17
17
|
2. Fetch upstream and diff changed files since last synced commit.
|
|
18
18
|
3. Classify changes (net-new, overwrite-safe, semantic-merge required, project-only).
|
|
19
19
|
4. Apply semantic merges for placeholder/value-bearing files.
|
|
20
20
|
5. Copy net-new files and run ideation-structure migration checks.
|
|
21
21
|
6. Audit project-only files for integration gaps.
|
|
22
22
|
7. Validate, review diff, and scan for unresolved placeholders.
|
|
23
|
-
8. Update `.
|
|
23
|
+
8. Update `.memory/pipeline/kit-sync.md` with new commit/version/timestamp.
|
|
@@ -8,12 +8,13 @@ This directory contains the CFSA (Constraint-First Specification Architecture) p
|
|
|
8
8
|
.factory/
|
|
9
9
|
├── skills/ # All pipeline skills (workflows, utilities, rules, setup)
|
|
10
10
|
├── skill-library/ # Stack-specific skills provisioned by bootstrap
|
|
11
|
-
|
|
12
|
-
└── kit-sync.md # Upstream sync tracking
|
|
11
|
+
└── instructions/ # Template files with {{PLACEHOLDER}} markers
|
|
13
12
|
|
|
14
13
|
Project root:
|
|
15
14
|
└── .memory/
|
|
16
|
-
└── pipeline/
|
|
15
|
+
└── pipeline/
|
|
16
|
+
├── progress/ # Canonical pipeline progress tracking for all runtimes
|
|
17
|
+
└── kit-sync.md # Canonical upstream sync tracking
|
|
17
18
|
|
|
18
19
|
Factory should connect as an MCP client to the shared daemon rather than spawning its own memory server.
|
|
19
20
|
|
|
@@ -13,11 +13,11 @@ parameters:
|
|
|
13
13
|
|
|
14
14
|
## Step-by-Step
|
|
15
15
|
|
|
16
|
-
1. Read `.
|
|
16
|
+
1. Read `.memory/pipeline/kit-sync.md` state and validate baseline.
|
|
17
17
|
2. Fetch upstream and diff changed files since last synced commit.
|
|
18
18
|
3. Classify changes (net-new, overwrite-safe, semantic-merge required, project-only).
|
|
19
19
|
4. Apply semantic merges for placeholder/value-bearing files.
|
|
20
20
|
5. Copy net-new files and run ideation-structure migration checks.
|
|
21
21
|
6. Audit project-only files for integration gaps.
|
|
22
22
|
7. Validate, review diff, and scan for unresolved placeholders.
|
|
23
|
-
8. Update `.
|
|
23
|
+
8. Update `.memory/pipeline/kit-sync.md` with new commit/version/timestamp.
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
# Kit Sync State
|
|
2
|
+
|
|
3
|
+
upstream: https://github.com/RepairYourTech/cfsa-antigravity
|
|
4
|
+
last_synced_commit: ffcecaa0f7172ca4b4186d4b2ceb52a7b2a2597f
|
|
5
|
+
last_synced_at: 2026-05-03T19:53:05Z
|
|
6
|
+
kit_version: 3.1.1
|
|
7
|
+
installed_runtimes:
|
|
8
|
+
- agent
|
|
9
|
+
- codex
|
|
10
|
+
- claude
|
|
11
|
+
- factory
|
|
@@ -12,6 +12,14 @@ All runtimes must read and write pipeline progress at:
|
|
|
12
12
|
|
|
13
13
|
This path owns phase progress, slice checklists, session logs, and the spec-pipeline tracker.
|
|
14
14
|
|
|
15
|
+
Kit installation sync state is also project-owned and lives at:
|
|
16
|
+
|
|
17
|
+
```text
|
|
18
|
+
.memory/pipeline/kit-sync.md
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
This path owns the upstream URL, last synced commit, last synced timestamp, kit version, and installed runtime list.
|
|
22
|
+
|
|
15
23
|
## Runtime Paths
|
|
16
24
|
|
|
17
25
|
The following paths are not canonical progress stores and must not be referenced by workflow, skill, rule, or instruction files as active state locations:
|
|
@@ -37,6 +45,7 @@ These paths may appear only as legacy migration source paths.
|
|
|
37
45
|
| Kit architecture docs | Reclassified runtime-local progress folders as legacy migration inputs only |
|
|
38
46
|
| Template build/check scripts | Moved scaffold and integrity checks to `.memory/pipeline/progress/` |
|
|
39
47
|
| Shipped scaffold | Removed pre-shipped runtime progress folders; added `.memory/pipeline/progress/` scaffold |
|
|
48
|
+
| Kit sync state | Moved upstream sync baseline from runtime folders to `.memory/pipeline/kit-sync.md` |
|
|
40
49
|
|
|
41
50
|
## Intentional Legacy References
|
|
42
51
|
|