context-packs 0.1.0 → 0.1.1

package/README.md

@@ -9,7 +9,7 @@ A context pack is a folder in a git repo holding rules every agent session shoul
 Run it with npx:
 
 ```bash
-npx github:mjewell/context-packs <command>
+npx context-packs <command>
 ```
 
 It syncs the current folder. Pass `--dir <folder>` before the command to sync another.
@@ -21,7 +21,7 @@ This repo is also a Claude Code plugin with a `/context-packs` skill, which runs
 ## Use it
 
 ```bash
-npx github:mjewell/context-packs add team-rules https://github.com/acme/agent-rules.git --path context
+npx context-packs add team-rules https://github.com/acme/agent-rules.git --path context
 ```
 
 That writes two blocks into `AGENTS.md`: a header block explaining context packs, and one for the pack. It also copies the pack's doc sets into `docs/agents/packs/team-rules/`, and creates `CLAUDE.md` as a symlink to `AGENTS.md`, so Claude Code reads the same file. Commit the result.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-packs",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Sync shared agent rules and docs into each repo's AGENTS.md",
   "license": "MIT",
   "bin": {
@@ -13,5 +13,8 @@
   "engines": {
     "node": ">=18"
   },
-  "repository": "github:mjewell/context-packs"
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mjewell/context-packs.git"
+  }
 }

package/src/blocks.py

@@ -19,10 +19,12 @@ BLOCK = re.compile(r'^<!-- context-packs:start (\S+)((?: \S+)*) -->\n(.*?)'
 
 
 class Region(NamedTuple):
-    """Where AGENTS.md's context-packs blocks sit, the packs they hold, and the doc sets each installed."""
+    """Where AGENTS.md's context-packs blocks sit, each block's text by name, the packs they hold, and the doc sets
+    each installed."""
     text: str
     start: int
     end: int
+    blocks: Dict[str, str]
     packs: List[Pack]
     installed: Dict[str, List[str]]
 
@@ -110,4 +112,5 @@ def region(repo):
             sys.exit(f'context-packs: {agents_md}: the {name} block or a doc in {PACKS / name} was edited since '
                      'the last sync. Move the change into its context pack or outside them, revert it, '
                      'then sync again.')
-    return Region(text, blocks[0].start(), blocks[-1].end(), packs, current)
+    return Region(text, blocks[0].start(), blocks[-1].end(), {m.group(1): m.group(0) for m in blocks}, packs,
+                  current)

package/src/cli.py

@@ -11,6 +11,7 @@ import shutil
 import sys
 
 import origins
+import report
 from blocks import HEADER, HEADER_RULES, HEADER_START, block, region, snapshot
 from packs import LOCAL, PACKS, Pack, Source, fetch
 
@@ -139,23 +140,26 @@ def main():
         for gone in {p.name for p in found.packs} - {p.name for p in packs}:
             if (repo / PACKS / gone).exists():
                 shutil.rmtree(repo / PACKS / gone)
-        blocks = [block(HEADER_START, HEADER_RULES)]
+        blocks = {HEADER: block(HEADER_START, HEADER_RULES)}
         for source in sources:
             if source.pack.local:
-                blocks.append(block(starts[source.pack.name], bodies[source.pack.name]))
+                blocks[source.pack.name] = block(starts[source.pack.name], bodies[source.pack.name])
                 continue
             synced = repo / source.pack.synced
             if synced.exists():
                 shutil.rmtree(synced)
             for name in chosen[source.pack.name]:
                 source.copy(name, synced)
-            blocks.append(block(starts[source.pack.name], bodies[source.pack.name], snapshot(synced)))
+            blocks[source.pack.name] = block(starts[source.pack.name], bodies[source.pack.name], snapshot(synced))
         if (repo / PACKS).is_dir() and not any((repo / PACKS).iterdir()):
             (repo / PACKS).rmdir()
-        text = found.text[:found.start] + '\n'.join(blocks) + found.text[found.end:]
+        text = found.text[:found.start] + '\n'.join(blocks.values()) + found.text[found.end:]
+        created = not (repo / 'AGENTS.md').exists()
         (repo / 'AGENTS.md').write_bytes(text.encode('utf-8'))
         if not linked:
             claude_md.symlink_to('AGENTS.md')
+        for line in report.changes(found, packs, chosen, blocks, created, linked):
+            print(line)
 
 
 if __name__ == '__main__':

package/src/report.py

@@ -0,0 +1,43 @@
+"""What a sync changed, in lines for the person who ran it."""
+from blocks import HEADER
+from origins import COMMIT
+
+
+def short(ref):
+    """ref as git shows it: a commit abbreviated, a tag in full."""
+    return ref[:7] if COMMIT.fullmatch(ref) else ref
+
+
+def at(pack):
+    """Where the pack is pinned, or nothing for one that syncs from the repo's working tree."""
+    return f' @ {short(pack.ref)}' if pack.ref else ''
+
+
+def sets(names):
+    return ', '.join(names) or 'none'
+
+
+def changes(found, after, chosen, blocks, created, linked):
+    """Lines describing what the sync did: whether it created AGENTS.md or found CLAUDE.md already linked to it, and
+    how the packs found in AGENTS.md became the packs after it, with chosen holding the doc sets each pack installs
+    and blocks the text the sync wrote for each."""
+    before = found.packs
+    old = {p.name: p for p in before}
+    new = {p.name for p in after}
+    lines = (['Created AGENTS.md'] * created + ['Linked CLAUDE.md to AGENTS.md'] * (not linked)
+             + ['Updated the header block'] * (not created and found.blocks[HEADER] != blocks[HEADER]))
+    for pack in after:
+        was = old.get(pack.name)
+        if not was:
+            docs = chosen[pack.name]
+            lines.append(f'{pack.name}: added{at(pack)}' + f' (docs: {sets(docs)})' * bool(docs))
+        elif was.ref != pack.ref:
+            lines.append(f'{pack.name}: {short(was.ref)} → {short(pack.ref)}')
+        elif not pack.local and found.installed[pack.name] != chosen[pack.name]:
+            lines.append(f'{pack.name}: doc sets {sets(found.installed[pack.name])} → {sets(chosen[pack.name])}')
+        elif found.blocks[pack.name] != blocks[pack.name]:
+            lines.append(f'{pack.name}: changed')
+    lines += [f'{p.name}: removed' for p in before if p.name not in new]
+    if lines:
+        return lines
+    return [f'Nothing changed: {", ".join(p.name + at(p) for p in after) or "no packs installed"}']