@ggdna/dna-gg 1.2.0 → 1.4.0

package/README.md

@@ -52,10 +52,12 @@ All skills of this layer are prefixed with `gg-`:
   prompts wait in `~/.claude/pm-prompts/sessions/` and are committed to the
   branch `prompts` of that repo when a session starts or ends, under
   `doc/prompts/<first name>/<yyyy-mm>/<yyyy-mm-dd>_<repo>_<session>.md`.
-  The first name comes from the `Git` line of `doc/team/people.md` there,
-  an unknown email goes to `doc/prompts/_unknown/`. Only the prompts are
-  kept, never the answers; tokens and passwords are replaced by
-  `[redacted]`. No working tree is touched: the commit is built in a bare
+  The first name comes from `doc/team/people.md` there, found by the git
+  user name: a first name equal to it or to its first word, or a `Git`
+  line listing it. An unknown name goes to `doc/prompts/_unknown/`. No
+  e-mail address is read or written; the commits carry the neutral author
+  `pm-prompts`. Only the prompts are kept, never the answers; tokens and
+  passwords are replaced by `[redacted]`. No working tree is touched: the commit is built in a bare
   cache below `~/.claude/pm-prompts/repos/`. Needs `node` and `git`; a
   failure never stops a prompt and ends up in
   `~/.claude/pm-prompts/sync.log`.

package/dna/_generated.json

@@ -39,7 +39,7 @@
       "ecosystem": null,
       "resolvedVersion": null,
       "via": null,
-      "hash": "0x815024b382c3d167"
+      "hash": "0xcda6ccaeb5d52dd1"
     }
   ],
   "claude": {
@@ -59,7 +59,7 @@
     },
     {
       "path": ".claude/hooks/pm-prompts.mjs",
-      "hash": "0x988aed96a8073727"
+      "hash": "0xf4266eea17b3b9c1"
     },
     {
       "path": ".claude/settings.json",
@@ -107,7 +107,7 @@
     },
     {
       "path": "doc/guides/develop-guide.md",
-      "hash": "0x39718de56fdb48f0"
+      "hash": "0xed4328d138fe76ef"
     },
     {
       "path": "doc/guides/develop-without-ai-guide.md",
@@ -115,7 +115,7 @@
     },
     {
       "path": "doc/guides/for-ai/ai-dev-guide.md",
-      "hash": "0x551a079b4eed0462"
+      "hash": "0xb6eecdb4c7a1ebe8"
     },
     {
       "path": "doc/guides/index-guide.md",

package/dna/doc/guides/develop-guide.md

@@ -47,6 +47,8 @@ Use the following skills in Claude
 When the repo belongs to a project management repo, every prompt you write
 to Claude Code is kept there, under `doc/prompts/<your first name>/` on the
 branch `prompts`. Only the prompts, not the answers. Tokens and passwords
-are replaced by `[redacted]`. Your first name comes from the `Git` line of
-`doc/team/people.md` in the project management repo; add your git email
-there, or your prompts land in `doc/prompts/_unknown/`.
+are replaced by `[redacted]`. Your first name comes from
+`doc/team/people.md` in the project management repo: the person whose
+first name is your git user name or its first word, or whose `Git` line
+lists your git user name. Otherwise your prompts land in
+`doc/prompts/_unknown/`. Your e-mail address never goes there.

package/dna/doc/guides/for-ai/ai-dev-guide.md

@@ -169,7 +169,9 @@ ticket.
   [Describe every repo in its own terms](#describe-every-repo-in-its-own-terms)).
   Keep every repo in its scope while you code: stop and propose a split,
   a new repo or a move as soon as code does not fit (see
-  [Keep every repo in its scope](#keep-every-repo-in-its-scope))
+  [Keep every repo in its scope](#keep-every-repo-in-its-scope)).
+  Before each change, if the repo has `doc/guides/architecture-guide.md`,
+  decide where the code goes as its `@placement` describes
 - Plan only: skip this step. The following steps then apply to the project
   management repo only.
 

package/dna/dot-claude/hooks/pm-prompts.mjs

@@ -238,7 +238,7 @@ export function onPrompt(input) {
       started: new Date().toISOString(),
       folder: path.basename(projectDir),
       repos,
-      email: git(['-C', projectDir, 'config', 'user.email']).out,
+      name: git(['-C', projectDir, 'config', 'user.name']).out,
       targets,
     });
   }
@@ -299,28 +299,35 @@ export function slug(name) {
     .replace(/^-+|-+$/g, '');
 }
 
-/** The first name in [peopleMd] whose `Git` line lists [email]. */
-export function personOf(email, peopleMd) {
-  if (!email) return '';
+/**
+ * The first name in [peopleMd] for the git user name [gitName]: the person
+ * whose `Git` line lists it, else the person whose first name is the git
+ * name or its first word. E-mail addresses play no part.
+ */
+export function personOf(gitName, peopleMd) {
+  const wanted = (gitName ?? '').trim().toLowerCase();
+  if (!wanted) return '';
+  const byFirstName = new Map();
   let name = '';
   for (const line of peopleMd.split(/\r?\n/)) {
     const heading = line.match(/^##\s+(.+?)\s*$/);
     if (heading) {
       name = heading[1];
+      byFirstName.set(name.toLowerCase(), name);
       continue;
     }
-    const emails = line.match(/^\s*-\s*Git:\s*(.+)$/i);
+    const names = line.match(/^\s*-\s*Git:\s*(.+)$/i);
     if (
       name &&
-      emails &&
-      emails[1]
-        .split(/[,;\s]+/)
-        .some((e) => e.toLowerCase() === email.toLowerCase())
+      names &&
+      names[1].split(/[,;]/).some((n) => n.trim().toLowerCase() === wanted)
     ) {
       return name;
     }
   }
-  return '';
+  return (
+    byFirstName.get(wanted) ?? byFirstName.get(wanted.split(/\s+/)[0]) ?? ''
+  );
 }
 
 /** Where the prompts of a session go in the project management repo. */
@@ -336,7 +343,7 @@ export function renderHead(meta, person) {
   const lines = [
     `# ${localDate(meta.started)} · ${meta.folder} · ${String(meta.session).slice(0, 8)}`,
     '',
-    `- Person: ${person || meta.email || 'unknown'}`,
+    `- Person: ${person || meta.name || 'unknown'}`,
   ];
   const repos = meta.repos ?? [];
   if (repos.length === 1 && repos[0] === meta.folder) {
@@ -399,16 +406,15 @@ function fetchBranch(dir) {
   return git(['-C', dir, 'rev-parse', ref]).out;
 }
 
-function identityEnv(dir) {
-  const env = { ...gitEnv };
-  if (!git(['-C', dir, 'config', 'user.name']).out) {
-    env.GIT_AUTHOR_NAME = env.GIT_COMMITTER_NAME = 'pm-prompts';
-  }
-  if (!git(['-C', dir, 'config', 'user.email']).out) {
-    env.GIT_AUTHOR_EMAIL = env.GIT_COMMITTER_EMAIL = 'pm-prompts@localhost';
-  }
-  return env;
-}
+// The prompts are committed under a neutral identity, so the e-mail address
+// of the developer never reaches the project management repo.
+const identityEnv = {
+  ...gitEnv,
+  GIT_AUTHOR_NAME: 'pm-prompts',
+  GIT_COMMITTER_NAME: 'pm-prompts',
+  GIT_AUTHOR_EMAIL: 'pm-prompts@localhost',
+  GIT_COMMITTER_EMAIL: 'pm-prompts@localhost',
+};
 
 // Commits the not yet pushed prompts of [sessions] to the prompts branch of
 // [url]. Returns how many prompts of each session the branch now holds.
@@ -421,7 +427,7 @@ function pushTarget(url, sessions) {
       os.tmpdir(),
       `pm-prompts-${process.pid}-${Date.now()}.index`,
     );
-    const env = { ...identityEnv(dir), GIT_INDEX_FILE: index };
+    const env = { ...identityEnv, GIT_INDEX_FILE: index };
     try {
       const read = base
         ? git(['-C', dir, 'read-tree', base], { env })
@@ -433,8 +439,8 @@ function pushTarget(url, sessions) {
         const fresh = session.prompts.slice(pushed);
         done.set(file, session.prompts.length);
         if (!fresh.length) continue;
-        const person = personOf(session.meta.email, people);
-        names.add(person || session.meta.email || 'unknown');
+        const person = personOf(session.meta.name, people);
+        names.add(person || session.meta.name || 'unknown');
         const target = promptsPath(session.meta, person);
         const existing = base
           ? git(['-C', dir, 'cat-file', '-p', `${base}:${target}`])

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggdna/dna-gg",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "DNA layer: gg CLI workflow guides, repo setup scripts and CI check",
   "keywords": [
     "dna",