cc-session-tools 2.7.2__tar.gz → 2.8.0__tar.gz

{cc_session_tools-2.7.2/src/cc_session_tools.egg-info → cc_session_tools-2.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cc-session-tools
-Version: 2.7.2
+Version: 2.8.0
 Summary: Claude Code session management CLI tools (ccd, ccr, ccs, claude-code-usage, ccst) and hook library (cccs_hooks)
 Author: raffishquartan
 License: MIT License

{cc_session_tools-2.7.2 → cc_session_tools-2.8.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cc-session-tools"
-version = "2.7.2"
+version = "2.8.0"
 description = "Claude Code session management CLI tools (ccd, ccr, ccs, claude-code-usage, ccst) and hook library (cccs_hooks)"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -62,11 +62,11 @@ where = ["src"]
 # only filters within the file's *own* discovered package, and a wrongly
 # auto-discovered "cc_session_tools.skills.<name>.tests" package was never
 # covered by an exclude-package-data entry keyed just "cc_session_tools").
-exclude = ["cc_session_tools.skills", "cc_session_tools.skills.*", "cc_session_tools.config", "cc_session_tools.config.*"]
+exclude = ["cc_session_tools.skills", "cc_session_tools.skills.*", "cc_session_tools.config", "cc_session_tools.config.*", "cc_session_tools.prompts", "cc_session_tools.prompts.*"]
 
 [tool.setuptools.package-data]
 claude_code_usage = ["data/*.json"]
-cc_session_tools = ["skills/**/*", "config/*"]
+cc_session_tools = ["skills/**/*", "config/*", "prompts/**/*"]
 
 [tool.setuptools.exclude-package-data]
 cc_session_tools = ["**/tests/*", "**/__pycache__/*"]

{cc_session_tools-2.7.2 → cc_session_tools-2.8.0}/src/cc_session_tools/cli/ccst.py

@@ -122,6 +122,40 @@ def _discover_bundle() -> Path:
     )
 
 
+def _discover_prompts_dir() -> Path:
+    """Return the bundled prompts/ directory (pdata-migration follow-up prompts).
+
+    prompts/ is packaged inside cc_session_tools the same way skills/ and config/ are (see
+    _discover_source_dir) - src/cc_session_tools/cli/ccst.py -> ../prompts. No install-location
+    fallback, same reasoning as the other two: a fallback here would just mask a broken install.
+    """
+    candidate = Path(__file__).resolve().parent.parent / "prompts"
+    if candidate.is_dir():
+        return candidate
+    raise FileNotFoundError(
+        "Cannot locate bundled prompts/ directory. Run from the source tree or reinstall ccst."
+    )
+
+
+def _print_migration_prompt_reminders(*labeled_filenames: tuple[str, str]) -> None:
+    """Print one "<label>: <path>" reminder line per (label, filename) pair, for the bundled
+    prompts/ directory.
+
+    Best-effort, deliberately swallowing a missing prompts/ directory: these reminders are a
+    nicety layered on top of an otherwise-already-completed classification or migration, not
+    the operation itself — a broken/partial install must never turn a successful --write (rows
+    already written, files already cut over) or dry-run (proposal already written) into a
+    reported failure just because this follow-up reminder couldn't be printed.
+    """
+    try:
+        prompts_dir = _discover_prompts_dir()
+    except FileNotFoundError as exc:
+        print(f"({exc})", file=sys.stderr)
+        return
+    for label, filename in labeled_filenames:
+        print(f"{label}: {prompts_dir / filename}")
+
+
 # ---------- skills install ----------
 
 
@@ -1056,6 +1090,9 @@ def _cmd_pdata_init(args: argparse.Namespace) -> int:
             return 2
         print(result.report)
         print(f"\nProposal: {result.proposal_path}")
+        _print_migration_prompt_reminders(
+            ("After a successful --write, update project docs", "pdata-migration-claude-md-update.md"),
+        )
         return 0
 
     try:
@@ -1091,6 +1128,10 @@ def _cmd_pdata_init(args: argparse.Namespace) -> int:
         print()
         print(write_result.report)  # spec §7.1 step 4's diff report, for review
         print(f"\nVerify: ccst pdata verify --project {args.project} --full")
+        _print_migration_prompt_reminders(
+            ("Update project docs", "pdata-migration-claude-md-update.md"),
+            ("Update consuming skills", "pdata-migration-skills-update.md"),
+        )
         print("SUCCESS")
         return 0
 

{cc_session_tools-2.7.2 → cc_session_tools-2.8.0}/src/cc_session_tools/lib/pdata/init_paths.py

@@ -76,7 +76,7 @@ def backup_dir_override(rehearse: Path | None) -> Iterator[None]:
     whatever CCST_PDATA_BACKUP_DIR is already set to), by reusing this plan's own
     backup.BACKUP_DIR_ENV seam — mirrors project_db_dir_override's shape exactly.
     Without this, a rehearsed --write would still deposit a
-    <project>-<epoch>.tar.gz into the same directory a genuine production
+    <project>-<YYYYMMDD-HHMMSS>.tar.gz into the same directory a genuine production
     migration's backup would use, indistinguishable by filename. No-op when
     rehearse is None."""
     if rehearse is None:

{cc_session_tools-2.7.2 → cc_session_tools-2.8.0}/src/cc_session_tools/lib/pdata/init_service.py

@@ -164,7 +164,7 @@ def write(
     # A's CCST_PROJECT_DB_DIR seam), backup_dir_override redirects where
     # backup.create_backup() below writes its tar.gz (this module's own
     # CCST_PDATA_BACKUP_DIR seam). Without the second seam, a rehearsed --write
-    # would still deposit a real <project>-<epoch>.tar.gz into the production
+    # would still deposit a real <project>-<YYYYMMDD-HHMMSS>.tar.gz into the production
     # backup directory — indistinguishable by filename from a genuine migration's
     # backup. Both are no-ops when rehearse is None.
     with (

cc_session_tools-2.8.0/src/cc_session_tools/prompts/pdata-migration-claude-md-update.md

@@ -0,0 +1,10 @@
+# pdata migration — project doc update (PLACEHOLDER)
+
+Status: **PLACEHOLDER** — this prompt's real step-by-step content is deliberately gated on a
+design conversation about `~/cc/<project>` scaffolding conventions (2026-08-20). See:
+
+`docs/superpowers/specs/2026-08-20-pdata-migration-prompts-design.md` (§"Prompt content —
+informed by a first-pass survey, not fully speced here").
+
+Do not run this prompt expecting real guidance yet — it exists only so `ccst pdata init` has a
+real, bundled file to point at ahead of that conversation happening.

cc_session_tools-2.8.0/src/cc_session_tools/prompts/pdata-migration-skills-update.md

@@ -0,0 +1,10 @@
+# pdata migration — consuming-skills update (PLACEHOLDER)
+
+Status: **PLACEHOLDER** — this prompt's real step-by-step content is deliberately gated on the
+same design conversation as the doc-update prompt. See:
+
+`docs/superpowers/specs/2026-08-20-pdata-migration-prompts-design.md` (§"Prompt content —
+informed by a first-pass survey, not fully speced here").
+
+Do not run this prompt expecting real guidance yet — it exists only so `ccst pdata init` has a
+real, bundled file to point at ahead of that conversation happening.

{cc_session_tools-2.7.2 → cc_session_tools-2.8.0/src/cc_session_tools.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cc-session-tools
-Version: 2.7.2
+Version: 2.8.0
 Summary: Claude Code session management CLI tools (ccd, ccr, ccs, claude-code-usage, ccst) and hook library (cccs_hooks)
 Author: raffishquartan
 License: MIT License

{cc_session_tools-2.7.2 → cc_session_tools-2.8.0}/src/cc_session_tools.egg-info/SOURCES.txt

@@ -91,6 +91,8 @@ src/cc_session_tools/lib/scheduler/store.py
 src/cc_session_tools/lib/scheduler/surface.py
 src/cc_session_tools/lib/scheduler/throttle.py
 src/cc_session_tools/lib/scheduler/worker.py
+src/cc_session_tools/prompts/pdata-migration-claude-md-update.md
+src/cc_session_tools/prompts/pdata-migration-skills-update.md
 src/cc_session_tools/skills/analyse-cc-usage/SKILL.md
 src/cc_session_tools/skills/context-override/SKILL.md
 src/cc_session_tools/skills/delete-sessions/SKILL.md

cc_session_tools-2.8.0/tests/test_ccst_bundle_discovery.py

@@ -0,0 +1,91 @@
+"""Tests for ccst.py's `_discover_source_dir`/`_discover_bundle`/`_discover_prompts_dir` —
+must resolve the bundled skills/, config/, and prompts/ correctly whether cc_session_tools is
+running from an editable source checkout or an installed wheel, since all three layouts place
+cc_session_tools/skills/, cc_session_tools/config/, and cc_session_tools/prompts/ at the same
+relative depth from this module (src/cc_session_tools/cli/ccst.py -> ../skills, ../config,
+../prompts)."""
+from __future__ import annotations
+
+from pathlib import Path
+
+import pytest
+
+from cc_session_tools.cli import ccst
+
+
+def test_discover_source_dir_finds_the_real_bundled_skills_dir():
+    result = ccst._discover_source_dir()
+    assert result.is_dir()
+    assert result.name == "skills"
+    # Sits directly inside the cc_session_tools package, not at the repo root -
+    # this is what makes it resolve the same way in an installed wheel.
+    assert result.parent.name == "cc_session_tools"
+    assert (result / "delete-sessions" / "SKILL.md").is_file()
+
+
+def test_discover_bundle_finds_the_real_bundled_hooks_bundle_json():
+    result = ccst._discover_bundle()
+    assert result.is_file()
+    assert result.name == "hooks-bundle.json"
+    assert result.parent.name == "config"
+    assert result.parent.parent.name == "cc_session_tools"
+
+
+def test_discover_source_dir_raises_clearly_when_package_relocated_away(monkeypatch, tmp_path):
+    """Simulate a broken install (module file present, no sibling skills/ dir) -
+    must fail loudly, not silently return an unrelated directory."""
+    fake_module_file = tmp_path / "cc_session_tools" / "cli" / "ccst.py"
+    fake_module_file.parent.mkdir(parents=True)
+    fake_module_file.touch()
+    monkeypatch.setattr(ccst, "__file__", str(fake_module_file))
+
+    with pytest.raises(FileNotFoundError, match="Cannot locate bundled skills"):
+        ccst._discover_source_dir()
+
+
+def test_discover_bundle_raises_clearly_when_package_relocated_away(monkeypatch, tmp_path):
+    fake_module_file = tmp_path / "cc_session_tools" / "cli" / "ccst.py"
+    fake_module_file.parent.mkdir(parents=True)
+    fake_module_file.touch()
+    monkeypatch.setattr(ccst, "__file__", str(fake_module_file))
+
+    with pytest.raises(FileNotFoundError, match="Cannot locate bundled config/hooks-bundle.json"):
+        ccst._discover_bundle()
+
+
+def test_discover_prompts_dir_finds_the_real_bundled_prompts():
+    result = ccst._discover_prompts_dir()
+    assert result.is_dir()
+    assert result.name == "prompts"
+    assert result.parent.name == "cc_session_tools"
+    assert (result / "pdata-migration-claude-md-update.md").is_file()
+    assert (result / "pdata-migration-skills-update.md").is_file()
+
+
+def test_discover_prompts_dir_raises_clearly_when_package_relocated_away(monkeypatch, tmp_path):
+    fake_module_file = tmp_path / "cc_session_tools" / "cli" / "ccst.py"
+    fake_module_file.parent.mkdir(parents=True)
+    fake_module_file.touch()
+    monkeypatch.setattr(ccst, "__file__", str(fake_module_file))
+
+    with pytest.raises(FileNotFoundError, match="Cannot locate bundled prompts"):
+        ccst._discover_prompts_dir()
+
+
+def test_print_migration_prompt_reminders_degrades_gracefully_when_prompts_dir_missing(
+    monkeypatch, capsys
+):
+    """Regression test: these reminders are a nicety layered on top of an
+    already-completed classification or migration, not the operation itself — a
+    broken/partial install must not raise and turn a completed --write into a
+    reported failure just because the bundled prompts/ directory is missing."""
+    def _raise() -> Path:
+        raise FileNotFoundError("Cannot locate bundled prompts/ directory.")
+
+    monkeypatch.setattr(ccst, "_discover_prompts_dir", _raise)
+
+    ccst._print_migration_prompt_reminders(("Update project docs", "some-prompt.md"))
+
+    captured = capsys.readouterr()
+    assert captured.out == ""  # nothing bogus printed to stdout (would land in --write's log)
+    assert "Cannot locate bundled prompts" in captured.err

{cc_session_tools-2.7.2 → cc_session_tools-2.8.0}/tests/test_ccst_pdata_init_cli.py

@@ -47,6 +47,16 @@ def test_pdata_init_dry_run_classifies_and_writes_proposal(base_env, tmp_path):
     assert (project_dir / ".ccst-pdata-proposal.json").exists()
 
 
+def test_pdata_init_dry_run_prints_doc_update_prompt_path(base_env, tmp_path):
+    project_dir = tmp_path / "projects" / "demo"
+    project_dir.mkdir(parents=True)
+    (project_dir / "ideas.csv").write_text("idea\nfirst\n")
+
+    r = _run(base_env, "pdata", "init", "--project", "demo")
+    assert r.returncode == 0, r.stderr
+    assert "pdata-migration-claude-md-update.md" in r.stdout
+
+
 def test_pdata_init_rejects_bad_project_name(base_env):
     r = _run(base_env, "pdata", "init", "--project", "../escape")
     assert r.returncode == 2
@@ -175,6 +185,8 @@ def test_pdata_init_write_success_ends_with_success_sentinel_and_verify_command(
 
     assert r_write.returncode == 0, r_write.stderr
     assert "ccst pdata verify --project demo --full" in r_write.stdout
+    assert "pdata-migration-claude-md-update.md" in r_write.stdout
+    assert "pdata-migration-skills-update.md" in r_write.stdout
     assert r_write.stdout.rstrip().splitlines()[-1] == "SUCCESS"
 
     log_content = (project_dir / "ccst-pdata-init-write.log").read_text()

cc_session_tools-2.7.2/tests/test_ccst_bundle_discovery.py

@@ -1,52 +0,0 @@
-"""Tests for ccst.py's `_discover_source_dir`/`_discover_bundle` — must resolve the
-bundled skills/ and config/ correctly whether cc_session_tools is running from an
-editable source checkout or an installed wheel, since both layouts place
-cc_session_tools/skills/ and cc_session_tools/config/ at the same relative depth from
-this module (src/cc_session_tools/cli/ccst.py -> ../skills, ../config)."""
-from __future__ import annotations
-
-from pathlib import Path
-
-import pytest
-
-from cc_session_tools.cli import ccst
-
-
-def test_discover_source_dir_finds_the_real_bundled_skills_dir():
-    result = ccst._discover_source_dir()
-    assert result.is_dir()
-    assert result.name == "skills"
-    # Sits directly inside the cc_session_tools package, not at the repo root -
-    # this is what makes it resolve the same way in an installed wheel.
-    assert result.parent.name == "cc_session_tools"
-    assert (result / "delete-sessions" / "SKILL.md").is_file()
-
-
-def test_discover_bundle_finds_the_real_bundled_hooks_bundle_json():
-    result = ccst._discover_bundle()
-    assert result.is_file()
-    assert result.name == "hooks-bundle.json"
-    assert result.parent.name == "config"
-    assert result.parent.parent.name == "cc_session_tools"
-
-
-def test_discover_source_dir_raises_clearly_when_package_relocated_away(monkeypatch, tmp_path):
-    """Simulate a broken install (module file present, no sibling skills/ dir) -
-    must fail loudly, not silently return an unrelated directory."""
-    fake_module_file = tmp_path / "cc_session_tools" / "cli" / "ccst.py"
-    fake_module_file.parent.mkdir(parents=True)
-    fake_module_file.touch()
-    monkeypatch.setattr(ccst, "__file__", str(fake_module_file))
-
-    with pytest.raises(FileNotFoundError, match="Cannot locate bundled skills"):
-        ccst._discover_source_dir()
-
-
-def test_discover_bundle_raises_clearly_when_package_relocated_away(monkeypatch, tmp_path):
-    fake_module_file = tmp_path / "cc_session_tools" / "cli" / "ccst.py"
-    fake_module_file.parent.mkdir(parents=True)
-    fake_module_file.touch()
-    monkeypatch.setattr(ccst, "__file__", str(fake_module_file))
-
-    with pytest.raises(FileNotFoundError, match="Cannot locate bundled config/hooks-bundle.json"):
-        ccst._discover_bundle()