@relipa/ai-flow-kit 0.1.7-beta.0 → 0.1.7

package/README.md

@@ -459,12 +459,17 @@ ak validate src/Payment.java --ruleset strict
 
 ### `ak memory`
 
-Save/search team knowledge.
+Draft, submit, and remove entries in the `99.Memory/` Project Brain (`AK-Docs/99.Memory/`) — see [Memory-Architecture-v1.0.md](docs/internal/Memory-Architecture-v1.0.md). Drafts are local-only until submitted; PM reviews and merges the Merge Request before a memory becomes team-visible.
 
 ```bash
-ak memory save "payment-flow" "Payment flow description..."
-ak memory search "payment"
-ak memory list
+ak memory draft --category 01.Lessons/dev --function-id F-003_Payment \
+  --slug prevent-429-error --content "..." --tags payment,http-429 --workflows coding
+
+ak memory list                 # local pending drafts (this machine only)
+ak memory list --approved      # team-approved memories
+
+ak memory submit <pendingPath> --title "..."   # move draft to destination, open MR
+ak memory remove <path> --title "..." --reason "..."  # propose removal (soft by default)
 ```
 
 ---
@@ -584,6 +589,27 @@ Then run `ak update` or `ak sync-skills` to apply.
 
 > Summary of major changes per version. See full details in [CHANGELOG.md](docs/common/CHANGELOG.md).
 
+### v0.1.7 — 2026-07-20
+- **`99.Memory/` Project Brain (Phase 1):** New git-based, human-approved team knowledge base in `AK-Docs/99.Memory/` — replaces the dead `.aiflow/memory/` JSON store. AI drafts lessons/facts/decisions locally; a human submits them via Merge Request, PM approves.
+- **`ak memory draft|list|submit|remove`:** New CLI (`scripts/memory-store.js` + rewritten `scripts/memory.js`), reusing the same branch-then-MR pattern as `ak docs branch`/`ak docs submit`.
+- **Session-start auto-recall:** `session-start.js` now loads the memory index plus the top-N memories relevant to the active ticket's functionId/workflow/tags into every session automatically.
+- **Retrospect step added to every Gate workflow** (DEV, BA, QA): drafts a memory at the end of each gate — and immediately when a human gives `BUG:`/`REVISION:` feedback, not deferred to hindsight.
+- **`ak init`/`ak update`** auto-bootstrap the `99.Memory/` skeleton, committed locally but never auto-pushed (`main` is a protected branch).
+- Docs: new `docs/internal/Memory-Architecture-v1.0.md` describing the 4 operating flows (Init/Store/Load/Remove) and the scoring model.
+
+### v0.1.6 — 2026-07-13
+- **Mandatory Source & Docs sync at the start of every Gate** across DEV/TESTER/EXECUTE/BA/QA workflows — a shared pre-flight procedure pulls the source repo plus `AK-Docs`/`Shared-Docs` before each gate; failures warn but never block.
+- **New `gen-doc` task type (2-Gate):** lightweight flow for ad-hoc documentation tasks — plan → generate + self-review, no TDD/coding gates.
+- **Figma wired into the DEV workflow end-to-end (Gate 1→4):** design fetched once and cached, then reused through spec/implementation/review; new anti-429 rate-limit guard for Figma MCP calls.
+- **`ak docs branch` / `ak docs submit`:** new CLI for the AI to create a docs branch and open a Merge Request — the same "never commits/pushes unasked" guarantee as elsewhere, extended to `AK-Docs`/`Shared-Docs`.
+- Fixed: `ak prompt <type>` and `ak init`'s `.gitignore` still referencing the deprecated `plan/` convention.
+
+### v0.1.5 — 2026-07-01
+- **DEV workflow output migrated `plan/[ticket-id]/` → `AK-Docs/04.Coding/`** — same folder-per-feature/file-per-ticket convention BA/QA already used; new Gate 3 (`03.TDD-Notes/`) and Gate 5 (`05.Pull-Requests/`) artifacts.
+- **Mandatory `functionId` pre-flight** extended to the DEV workflow (BA/QA already had it) — resolved from context, inferred from input, or asked directly; no gate output is written without it.
+- **New `/coding` slash command** — manual fallback to start/resume the DEV workflow when the SessionStart auto-start message doesn't re-fire (e.g. ticket switched via `ak use` in another terminal while a session is already open).
+- Testing skills consolidated into `custom/skills/test-skills/`; skill filenames standardized to English kebab-case.
+
 ### v0.1.4 — 2026-06-29
 - **Create Spec Flow (4-Gate BA Workflow):** New `taskType: "spec"` — Q&A Analysis → Prototype Design → UC Spec. AI follows UCflow process guided by `ba-skills/` sub-skills.
 - **Create Testcase Flow (4-Gate QA Workflow):** New `taskType: "testcase"` — Requirement Analysis → Scenario Building → Detailed TC Design → Review & Optimize. AI applies BVA, Equivalence Partitioning, Decision Table techniques.

package/docs/common/CHANGELOG.md

@@ -9,6 +9,22 @@ Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [0.1.7] - 2026-07-20
+
+### Added
+
+- **`99.Memory/` Project Brain — Phase 1** (`docs/internal/Memory-Architecture-v1.0.md`, v1.1). A git-based, human-approved team knowledge base living inside `AK-Docs/99.Memory/`, replacing the legacy `.aiflow/memory/` JSON store whose only "auto-load" function was dead code no hook ever called. AI now accumulates lessons/facts/decisions across tasks, scored and recalled automatically at session start.
+  - **`scripts/memory-store.js`** — new engine: `99.Memory/` skeleton bootstrap; `mem-<functionId>-<slug>` id scheme with folder-per-functionId layout (`_global/` for cross-project facts, flat for `glossary`/`decisions`); hand-rolled frontmatter parse/serialize (no new YAML dependency); dedup-aware draft creation (a repeated slug in the same folder surfaces as a conflict instead of silently duplicating); the §5.2 scoring formula (folder/workflow/tag match, confidence, staleness decay, pending penalty); the Layer-2 relevant-set loader (top-N within a token budget); a local hit-count ledger. Deliberately **dependency-free** (no `fs-extra`/`chalk`) — this file is copied standalone into `.claude/lib/memory-store.js` in every project so the session-start hook can `require()` it without the kit's own `node_modules`.
+  - **`scripts/memory.js`** — full rewrite: `ak memory draft|list|submit|remove`, replacing the old `save/get/list/search/delete/clear`. `submit`/`remove` reuse `scripts/docs-branch.js`'s existing branch-then-MR mechanism — same "AI drafts, human approves via Merge Request" model already used by `ak docs branch`/`ak docs submit`.
+  - **`scripts/hooks/session-start.js`** — new step: injects Layer 1 (`MEMORY.md` index, always) + Layer 2 (top-N scored memories relevant to the active ticket's functionId/workflow/tags, budget-capped) into session context. Pulls `AK-Docs` with a short timeout first; a failed/offline pull only logs a warning and falls back to the local copy, never blocks the session.
+  - **`scripts/init.js` / `scripts/update.js`** — auto-bootstrap the `99.Memory/` skeleton and gitignore its `_pending/` folder (local-only drafts) the first time `AK-Docs` is present. Both are committed locally on whatever branch is checked out but **never auto-pushed**, since `main` is a protected branch and pushing is left to a human.
+  - **`custom/templates/memory/`** — `99.Memory/` skeleton tree, the memory-item frontmatter template, a GitLab MR template, a `CODEOWNERS` snippet, and reference `memory-lint`/`memory-finalize` CI job YAML (copyable snippets for a project admin to wire into a live pipeline — not auto-applied, no live GitLab project to attach them to from the kit itself).
+  - **New "Retrospect + propose memory draft" step** added to all 4 Gate workflows — `review-plan` (Gate 4), `create-spec-workflow` (Gate 4), `create-testcase-workflow` (Gate 4), and `gate-workflow`'s gen-doc flow (Gate 2). Human review feedback (`BUG: ...`, `REVISION: ...`) is captured as a memory draft **immediately when given**, before the fix/update — not deferred to a generic end-of-gate retrospective where it could get lost or diluted.
+
+### Changed
+
+- `.aiflow/memory/` (JSON key/value store) and its `save/get/search/delete/clear` commands are retired outright — superseded by `99.Memory/`, no backward-compat shim (nothing else in the kit read that store).
+
 ## [0.1.6] - 2026-07-13
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relipa/ai-flow-kit",
-  "version": "0.1.7-beta.0",
+  "version": "0.1.7",
   "description": "All-in-one AI Flow Kit for team development with Claude AI - skills, templates, and MCP adapters",
   "author": "Example Team",
   "publishConfig": {