prizmkit 1.0.35 → 1.0.58

package/bundled/dev-pipeline/tests/test_update_bug_status.py

@@ -1,142 +0,0 @@
-"""Tests for update-bug-status.py."""
-
-import json
-import os
-import re
-import sys
-import pytest
-
-
-def _import_update_bug_status():
-    import importlib.util
-    path = os.path.join(
-        os.path.dirname(__file__), "..", "scripts", "update-bug-status.py"
-    )
-    spec = importlib.util.spec_from_file_location("update_bug_status", path)
-    mod = importlib.util.module_from_spec(spec)
-    sys.modules["update_bug_status"] = mod
-    spec.loader.exec_module(mod)
-    return mod
-
-
-ubs = _import_update_bug_status()
-now_iso = ubs.now_iso
-load_bug_status = ubs.load_bug_status
-save_bug_status = ubs.save_bug_status
-action_get_next = ubs.action_get_next
-SEVERITY_PRIORITY = ubs.SEVERITY_PRIORITY
-
-
-class TestNowIso:
-    def test_valid_format(self):
-        result = now_iso()
-        pattern = r"^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$"
-        assert re.match(pattern, result) is not None
-
-
-class TestLoadAndSaveBugStatus:
-    def test_round_trip(self, bugfix_state_dir):
-        bid = "B-001"
-        bdir = os.path.join(bugfix_state_dir, "bugs", bid)
-        os.makedirs(bdir, exist_ok=True)
-
-        data = {
-            "bug_id": bid,
-            "status": "in_progress",
-            "retry_count": 2,
-            "max_retries": 3,
-            "sessions": ["s-001"],
-            "last_session_id": "s-001",
-            "resume_from_phase": None,
-            "created_at": "2024-01-01T00:00:00Z",
-            "updated_at": "2024-01-01T01:00:00Z",
-        }
-        err = save_bug_status(bugfix_state_dir, bid, data)
-        assert err is None
-
-        loaded = load_bug_status(bugfix_state_dir, bid)
-        assert loaded["bug_id"] == bid
-        assert loaded["status"] == "in_progress"
-        assert loaded["retry_count"] == 2
-
-    def test_load_missing_returns_default(self, bugfix_state_dir):
-        result = load_bug_status(bugfix_state_dir, "B-999")
-        assert result["bug_id"] == "B-999"
-        assert result["status"] == "pending"
-        assert result["retry_count"] == 0
-
-    def test_load_invalid_json_returns_default(self, bugfix_state_dir):
-        bid = "B-BAD"
-        bdir = os.path.join(bugfix_state_dir, "bugs", bid)
-        os.makedirs(bdir, exist_ok=True)
-        with open(os.path.join(bdir, "status.json"), "w") as f:
-            f.write("not json!")
-        result = load_bug_status(bugfix_state_dir, bid)
-        assert result["status"] == "pending"
-
-
-class TestActionGetNext:
-    def test_selects_critical_before_medium(self, bugfix_state_dir, capsys):
-        bug_list = {
-            "bugs": [
-                {"id": "B-001", "title": "Low", "severity": "medium", "priority": 1},
-                {"id": "B-002", "title": "High", "severity": "critical", "priority": 2},
-            ]
-        }
-        action_get_next(bug_list, bugfix_state_dir)
-        captured = capsys.readouterr()
-        result = json.loads(captured.out)
-        assert result["bug_id"] == "B-002"
-        assert result["severity"] == "critical"
-
-    def test_same_severity_sorted_by_priority(self, bugfix_state_dir, capsys):
-        bug_list = {
-            "bugs": [
-                {"id": "B-001", "title": "P3", "severity": "high", "priority": 3},
-                {"id": "B-002", "title": "P1", "severity": "high", "priority": 1},
-            ]
-        }
-        action_get_next(bug_list, bugfix_state_dir)
-        captured = capsys.readouterr()
-        result = json.loads(captured.out)
-        assert result["bug_id"] == "B-002"
-
-    def test_all_completed_prints_pipeline_complete(self, bugfix_state_dir, capsys):
-        bug_list = {"bugs": [{"id": "B-001", "title": "Done", "severity": "low"}]}
-        # Mark as completed
-        bdir = os.path.join(bugfix_state_dir, "bugs", "B-001")
-        os.makedirs(bdir, exist_ok=True)
-        with open(os.path.join(bdir, "status.json"), "w") as f:
-            json.dump({"status": "completed"}, f)
-        action_get_next(bug_list, bugfix_state_dir)
-        captured = capsys.readouterr()
-        assert "PIPELINE_COMPLETE" in captured.out
-
-    def test_empty_bugs_prints_pipeline_complete(self, bugfix_state_dir, capsys):
-        action_get_next({"bugs": []}, bugfix_state_dir)
-        captured = capsys.readouterr()
-        assert "PIPELINE_COMPLETE" in captured.out
-
-    def test_prefers_in_progress_over_pending(self, bugfix_state_dir, capsys):
-        bug_list = {
-            "bugs": [
-                {"id": "B-001", "title": "Pending", "severity": "critical", "priority": 1},
-                {"id": "B-002", "title": "In Progress", "severity": "low", "priority": 2},
-            ]
-        }
-        # Mark B-002 as in_progress
-        bdir = os.path.join(bugfix_state_dir, "bugs", "B-002")
-        os.makedirs(bdir, exist_ok=True)
-        with open(os.path.join(bdir, "status.json"), "w") as f:
-            json.dump({"status": "in_progress", "retry_count": 0}, f)
-        action_get_next(bug_list, bugfix_state_dir)
-        captured = capsys.readouterr()
-        result = json.loads(captured.out)
-        assert result["bug_id"] == "B-002"
-
-
-class TestSeverityPriority:
-    def test_order(self):
-        assert SEVERITY_PRIORITY["critical"] < SEVERITY_PRIORITY["high"]
-        assert SEVERITY_PRIORITY["high"] < SEVERITY_PRIORITY["medium"]
-        assert SEVERITY_PRIORITY["medium"] < SEVERITY_PRIORITY["low"]

package/bundled/dev-pipeline/tests/test_update_feature_status.py

@@ -1,268 +0,0 @@
-"""Tests for update-feature-status.py."""
-
-import json
-import os
-import re
-import sys
-import pytest
-from types import SimpleNamespace
-
-
-def _import_update_feature_status():
-    import importlib.util
-    path = os.path.join(
-        os.path.dirname(__file__), "..", "scripts", "update-feature-status.py"
-    )
-    spec = importlib.util.spec_from_file_location("update_feature_status", path)
-    mod = importlib.util.module_from_spec(spec)
-    sys.modules["update_feature_status"] = mod
-    spec.loader.exec_module(mod)
-    return mod
-
-
-ufs = _import_update_feature_status()
-now_iso = ufs.now_iso
-load_feature_status = ufs.load_feature_status
-save_feature_status = ufs.save_feature_status
-_build_feature_slug = ufs._build_feature_slug
-_format_duration = ufs._format_duration
-_calc_feature_duration = ufs._calc_feature_duration
-
-
-class TestSessionStatusValues:
-    def test_contains_commit_missing(self):
-        assert "commit_missing" in ufs.SESSION_STATUS_VALUES
-
-    def test_contains_docs_missing(self):
-        assert "docs_missing" in ufs.SESSION_STATUS_VALUES
-
-
-class TestNowIso:
-    def test_returns_valid_iso_format(self):
-        result = now_iso()
-        # Should match YYYY-MM-DDTHH:MM:SSZ
-        pattern = r"^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$"
-        assert re.match(pattern, result) is not None
-
-    def test_returns_string(self):
-        assert isinstance(now_iso(), str)
-
-
-class TestLoadAndSaveFeatureStatus:
-    def test_round_trip(self, state_dir):
-        fid = "F-001"
-        # Create the feature directory
-        fdir = os.path.join(state_dir, "features", fid)
-        os.makedirs(fdir, exist_ok=True)
-
-        status_data = {
-            "feature_id": fid,
-            "status": "in_progress",
-            "retry_count": 1,
-            "max_retries": 3,
-            "sessions": ["s-001"],
-            "last_session_id": "s-001",
-            "resume_from_phase": "3",
-            "created_at": "2024-01-01T00:00:00Z",
-            "updated_at": "2024-01-01T01:00:00Z",
-        }
-        err = save_feature_status(state_dir, fid, status_data)
-        assert err is None
-
-        loaded = load_feature_status(state_dir, fid)
-        assert loaded["feature_id"] == fid
-        assert loaded["status"] == "in_progress"
-        assert loaded["retry_count"] == 1
-
-    def test_load_missing_returns_default(self, state_dir):
-        result = load_feature_status(state_dir, "F-999")
-        assert result["feature_id"] == "F-999"
-        assert result["status"] == "pending"
-        assert result["retry_count"] == 0
-
-    def test_load_invalid_json_returns_default(self, state_dir):
-        fid = "F-BAD"
-        fdir = os.path.join(state_dir, "features", fid)
-        os.makedirs(fdir, exist_ok=True)
-        with open(os.path.join(fdir, "status.json"), "w") as f:
-            f.write("{invalid json")
-        result = load_feature_status(state_dir, fid)
-        assert result["status"] == "pending"
-
-
-class TestBuildFeatureSlug:
-    def test_basic(self):
-        assert _build_feature_slug("F-001", "Project Setup") == "001-project-setup"
-
-    def test_special_chars(self):
-        result = _build_feature_slug("F-002", "Auth (OAuth2.0)")
-        assert result == "002-auth-oauth20"
-
-    def test_empty_title(self):
-        result = _build_feature_slug("F-003", "")
-        assert result == "003-feature"
-
-    def test_none_title(self):
-        result = _build_feature_slug("F-003", None)
-        assert result == "003-feature"
-
-    def test_lowercase_f(self):
-        result = _build_feature_slug("f-5", "Test")
-        assert result == "005-test"
-
-    def test_numeric_padding(self):
-        result = _build_feature_slug("F-1", "A")
-        assert result.startswith("001-")
-
-
-class TestFormatDuration:
-    def test_none(self):
-        assert _format_duration(None) == "N/A"
-
-    def test_seconds(self):
-        assert _format_duration(45) == "45s"
-
-    def test_minutes(self):
-        assert _format_duration(125) == "2m5s"
-
-    def test_hours(self):
-        assert _format_duration(3661) == "1h1m"
-
-    def test_zero(self):
-        assert _format_duration(0) == "0s"
-
-    def test_exact_minute(self):
-        assert _format_duration(60) == "1m0s"
-
-    def test_exact_hour(self):
-        assert _format_duration(3600) == "1h0m"
-
-
-class TestCalcFeatureDuration:
-    def test_valid_duration(self, state_dir):
-        fid = "F-001"
-        fdir = os.path.join(state_dir, "features", fid)
-        os.makedirs(fdir, exist_ok=True)
-        status = {
-            "created_at": "2024-01-01T00:00:00Z",
-            "updated_at": "2024-01-01T00:05:00Z",  # 300 seconds
-        }
-        with open(os.path.join(fdir, "status.json"), "w") as f:
-            json.dump(status, f)
-        result = _calc_feature_duration(state_dir, fid)
-        assert result == 300.0
-
-    def test_too_short_duration(self, state_dir):
-        fid = "F-002"
-        fdir = os.path.join(state_dir, "features", fid)
-        os.makedirs(fdir, exist_ok=True)
-        status = {
-            "created_at": "2024-01-01T00:00:00Z",
-            "updated_at": "2024-01-01T00:00:05Z",  # 5 seconds - below 10s threshold
-        }
-        with open(os.path.join(fdir, "status.json"), "w") as f:
-            json.dump(status, f)
-        result = _calc_feature_duration(state_dir, fid)
-        assert result is None
-
-    def test_missing_file(self, state_dir):
-        result = _calc_feature_duration(state_dir, "F-MISSING")
-        assert result is None
-
-    def test_missing_timestamps(self, state_dir):
-        fid = "F-003"
-        fdir = os.path.join(state_dir, "features", fid)
-        os.makedirs(fdir, exist_ok=True)
-        with open(os.path.join(fdir, "status.json"), "w") as f:
-            json.dump({"status": "pending"}, f)
-        result = _calc_feature_duration(state_dir, fid)
-        assert result is None
-
-
-class TestActionUpdateDegradedStatuses:
-    def test_commit_missing_updates_feature_state_without_cleanup(
-        self, feature_list_file, state_dir, monkeypatch, capsys
-    ):
-        called = {"cleanup": 0}
-
-        def _fake_cleanup(**_kwargs):
-            called["cleanup"] += 1
-            return []
-
-        monkeypatch.setattr(ufs, "cleanup_feature_artifacts", _fake_cleanup)
-
-        args = SimpleNamespace(
-            feature_id="F-001",
-            session_status="commit_missing",
-            session_id="s-commit-missing",
-            max_retries=3,
-            project_root=None,
-        )
-
-        ufs.action_update(args, feature_list_file, state_dir)
-        out = capsys.readouterr().out
-        summary = json.loads(out)
-
-        fs = ufs.load_feature_status(state_dir, "F-001")
-        assert fs["status"] == "commit_missing"
-        assert fs["retry_count"] == 1
-        assert summary["new_status"] == "commit_missing"
-        assert summary["degraded_reason"] == "commit_missing"
-        assert summary["restart_policy"] == "finalization_retry"
-        assert called["cleanup"] == 0
-
-        with open(feature_list_file, "r", encoding="utf-8") as f:
-            data = json.load(f)
-        f1 = next(x for x in data["features"] if x["id"] == "F-001")
-        assert f1["status"] == "commit_missing"
-
-    def test_docs_missing_reaches_failed_when_retry_exhausted(
-        self, feature_list_file, state_dir, monkeypatch, capsys
-    ):
-        called = {"cleanup": 0}
-
-        def _fake_cleanup(**_kwargs):
-            called["cleanup"] += 1
-            return []
-
-        monkeypatch.setattr(ufs, "cleanup_feature_artifacts", _fake_cleanup)
-
-        args = SimpleNamespace(
-            feature_id="F-001",
-            session_status="docs_missing",
-            session_id="s-docs-missing",
-            max_retries=1,
-            project_root=None,
-        )
-
-        ufs.action_update(args, feature_list_file, state_dir)
-        out = capsys.readouterr().out
-        summary = json.loads(out)
-
-        fs = ufs.load_feature_status(state_dir, "F-001")
-        assert fs["status"] == "failed"
-        assert fs["retry_count"] == 1
-        assert summary["new_status"] == "failed"
-        assert summary["degraded_reason"] == "docs_missing"
-        assert summary["restart_policy"] == "finalization_retry"
-        assert called["cleanup"] == 0
-
-        with open(feature_list_file, "r", encoding="utf-8") as f:
-            data = json.load(f)
-        f1 = next(x for x in data["features"] if x["id"] == "F-001")
-        assert f1["status"] == "failed"
-
-
-class TestActionStatusForDegradedStates:
-    def test_status_output_contains_degraded_counters(self, feature_list_file, state_dir, capsys):
-        # Update feature-list.json to set degraded statuses (single source of truth)
-        with open(feature_list_file, "r", encoding="utf-8") as f:
-            feature_list_data = json.load(f)
-
-        feature_list_data["features"][0]["status"] = "commit_missing"
-        feature_list_data["features"][1]["status"] = "docs_missing"
-
-        ufs.action_status(feature_list_data, state_dir)
-        out = capsys.readouterr().out
-
-        assert "Commit Missing: 1 | Docs Missing: 1" in out

package/bundled/skills/prizm-kit/assets/codebuddy-md-template.md

@@ -1,35 +0,0 @@
-## PrizmKit Documentation Framework
-
-This project uses PrizmKit with the Prizm documentation system for AI-optimized progressive context loading.
-
-### Progressive Loading Protocol
-- ON SESSION START: Always read `.prizm-docs/root.prizm` first (L0 — project map)
-- ON TASK: Read L1 (`.prizm-docs/<module>.prizm`) for relevant modules referenced in MODULE_INDEX
-- ON FILE EDIT: Read L2 (`.prizm-docs/<module>/<submodule>.prizm`) before modifying files. Pay attention to TRAPS and DECISIONS.
-- NEVER load all .prizm docs at once. Load only what is needed for the current task.
-
-### Auto-Update Protocol
-- BEFORE EVERY COMMIT: Update affected `.prizm-docs/` files
-- The UserPromptSubmit hook will remind you automatically
-- Use `prizmkit-committer` skill for the complete commit workflow
-
-### Doc Format Rules
-- All `.prizm` files use KEY: value format, not prose
-- Size limits: L0 = 4KB, L1 = 3KB, L2 = 5KB
-- Arrow notation (->) indicates load pointers to other .prizm docs
-- DECISIONS and CHANGELOG are append-only (never delete entries)
-
-### Creating New L2 Docs
-- When you first modify files in a sub-module that has no L2 doc:
-  1. Read the source files in that sub-module
-  2. Generate a new L2 `.prizm` file following Prizm specification
-  3. Add a pointer in the parent L1 doc's SUBDIRS section
-
-### Fast Path for Simple Changes
-Not every change needs the full spec -> plan -> tasks workflow. Use fast path for:
-- Bug fixes with clear root cause, config tweaks, typo fixes, simple refactors
-- Documentation-only changes, test additions for existing code
-- Directly use `prizmkit.implement` with inline task description, then `prizmkit.commit`
-
-Use the full workflow (specify -> plan -> tasks -> analyze -> implement) for:
-- New features, multi-file coordinated changes, architectural decisions, data model or API changes

package/bundled/skills/prizm-kit/assets/hooks/prizm-commit-hook.json

@@ -1,15 +0,0 @@
-{
-  "hooks": {
-    "UserPromptSubmit": [
-      {
-        "matcher": "\\b(commit|Commit|push|Push|finish|Finish|ship|Ship|merge|Merge|pull request|Pull Request|pr|PR)\\b|提交|推送|收尾|完成任务|合并|发版|发布",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "echo 'PRIZMKIT_DOC_UPDATE_REQUIRED: Before committing, you MUST update .prizm-docs/ per Prizm auto-update protocol. Steps: 1) Run git diff --cached --name-status. 2) Map changed files to modules via root.prizm MODULE_INDEX. 3) Read and update affected .prizm files (only changed sections). 4) Append to changelog.prizm. 5) Stage .prizm files with git add .prizm-docs/. 6) Then proceed with commit using prizmkit-committer workflow. RULES: Never rewrite entire .prizm files. Never add prose. Only update affected sections.'"
-          }
-        ]
-      }
-    ]
-  }
-}

package/bundled/skills/prizmkit-summarize/SKILL.md

@@ -1,51 +0,0 @@
----
-name: "prizmkit-summarize"
-description: "Archive completed features to REGISTRY.md. Extracts metadata from specs, scans code, updates feature index. Invoke after code review passes or feature is done. (project)"
----
-
-# PrizmKit Summarize
-
-Archive completed features to the feature registry. Extracts metadata from specs and code, generates a registry entry, and appends a changelog record. Idempotent — re-running produces the same output.
-
-## Commands
-
-### prizmkit.summarize
-
-Archive a completed feature to the registry.
-
-**PRECONDITION:** `spec.md`, `plan.md`, `tasks.md` exist in `.prizmkit/specs/###-feature-name/`
-
-**STEPS:**
-
-1. Read `spec.md`, `plan.md`, `tasks.md`
-2. Analyze `tasks.md` completion rate — warn if < 100%
-3. Scan actual code directories for core file paths
-4. Generate REGISTRY entry:
-   - Feature number and name
-   - Branch name
-   - Status (complete/partial)
-   - Key files and directories
-   - API endpoints added/modified
-   - Data model changes
-   - Completion date
-5. Append to `.prizmkit/specs/REGISTRY.md` (create from template `${SKILL_DIR}/assets/registry-template.md` if not exists)
-6. Append changelog entry
-7. Output: registry entry summary
-
-**KEY RULES:**
-- Idempotent: same input MUST produce same output on re-run
-- If `tasks.md` completion < 100%, status is "Partial" with warning
-- REGISTRY.md is append-only — never modify existing entries
-- Changelog entries use format: `YYYY-MM-DD | [###] [Feature Name] | [Status]`
-- If REGISTRY.md does not exist, create it from template before appending
-- **Bug fixes MUST NOT create new REGISTRY.md entries.** Bugs are refinements of incomplete existing features, not new functionality. Bug fix commits should only update the original feature's changelog, not generate a new registry entry. Do NOT invoke this skill for bug fix commits.
-
-**HANDOFF:** `prizmkit.specify` (start next feature) or `prizmkit.retrospective` (extract lessons)
-
-## Template
-
-The registry template is located at `${SKILL_DIR}/assets/registry-template.md`.
-
-## Output
-
-- `.prizmkit/specs/REGISTRY.md` — Updated with new feature entry and changelog record

package/bundled/skills/prizmkit-summarize/assets/registry-template.md

@@ -1,18 +0,0 @@
-# PrizmKit Feature Registry
-
-> Auto-generated by prizmkit-summarize. Do not edit manually.
-
-## Features
-
-### [###] [Feature Name]
-- **Branch**: ###-feature-name
-- **Status**: Complete | Partial
-- **Date**: YYYY-MM-DD
-- **Key Files**: [list]
-- **API Changes**: [summary]
-- **Data Changes**: [summary]
-
----
-
-## Changelog
-- YYYY-MM-DD | [###] [Feature Name] | [Status]

package/bundled/templates/hooks/commit-intent-claude.json

@@ -1,26 +0,0 @@
-{
-  "hooks": {
-    "UserPromptSubmit": [
-      {
-        "matcher": "\\b(commit|Commit|push|Push|finish|Finish|ship|Ship|merge|Merge|pull request|Pull Request|pr|PR)\\b|提交|推送|收尾|完成任务|合并|发版|发布",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "SRC=$(git diff --cached --name-only 2>/dev/null | grep -cE '\\.(ts|tsx|js|jsx|py|go|rs|java)$'); if [ \"$SRC\" -gt 0 ]; then PRIZM=$(git diff --cached --name-only 2>/dev/null | grep -c '^\\.prizm-docs/'); if [ \"$PRIZM\" -gt 0 ]; then echo \"PRIZMKIT_DOC_STATUS: $SRC source file(s) staged | .prizm-docs/ updated ($PRIZM file(s))\"; else echo \"PRIZMKIT_DOC_STATUS: $SRC source file(s) staged | .prizm-docs/ NOT UPDATED — update if this is a feature change\"; fi; fi"
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Bash",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "if echo \"$CLAUDE_TOOL_INPUT\" 2>/dev/null | grep -qE 'git (commit|merge|rebase)' 2>/dev/null; then DRIFT=$(sh .prizmkit/scripts/diff-prizm-docs.sh 2>/dev/null); if [ -n \"$DRIFT\" ]; then echo \"PRIZMKIT_DRIFT_DETECTED: prizm-docs structural differences found after git operation:\"; echo \"$DRIFT\"; echo \"Please update affected .prizm-docs/ files using /prizmkit-prizm-docs.\"; fi; fi"
-          }
-        ]
-      }
-    ]
-  }
-}