@polymorphism-tech/morph-spec 8.47.0 → 9.1.0

package/src/commands/project/claim.js

@@ -1,24 +1,3 @@
-/**
- * `morph-spec claim [feature] [--release] [--list]` — the manual half of
- * advisory feature ownership (B1).
- *
- * Claims are acquired and heartbeaten AUTOMATICALLY (SessionStart hook +
- * telemetry hook), so the operator never has to remember anything. This command
- * exists for the two cases automation cannot cover:
- *   - a session that died without releasing, leaving a claim that keeps
- *     warning everyone until its TTL expires (`--release`);
- *   - an operator switching this SAME session/tree to a different feature
- *     mid-task. `morph-spec claim <feature>` (no flags) ACQUIRES it, moving
- *     the tree's previous claim in the same step — a manual release-then-
- *     reclaim was observed to just not happen mid-task, and the silent no-op
- *     this used to be (any unclaimed feature name printed "nothing here" and
- *     changed nothing) was worse: it looked like a query, not a skipped write.
- *
- * `--list` forces the read-only view even when a feature is named. `--release`
- * is the only other mutation. Always exits 0 except on a genuine misuse — the
- * claim system is advisory and must never become a source of hard failures.
- */
-
 import chalk from 'chalk';
 import { execSync } from 'child_process';
 import { resolve } from 'path';
@@ -31,7 +10,6 @@ import {
   claimAge,
 } from '../../../framework/hooks/shared/claim-registry.js';
 
-/** Resolve the repo's shared git common dir — where claims live. */
 function gitCommonDirOf(cwd) {
   const root = resolvePrimaryRoot(cwd);
   const common = execSync('git rev-parse --git-common-dir', { cwd: root, stdio: 'pipe' }).toString().trim();
@@ -41,15 +19,8 @@ function gitCommonDirOf(cwd) {
 const norm = (p) => String(p ?? '').replace(/\\/g, '/');
 
 /**
- * Acquire `feature`'s claim, moving it in the same step if this tree already
- * holds a live claim on a different feature.
- *
- * "This tree's own claim" is identified by PATH, not session id: the CLI has
- * no access to the Claude Code session id SessionStart stamps (that only
- * reaches hooks, via stdin JSON) — path is the one honest signal a manual
- * invocation shares with the automatic claim it may be replacing. Re-using
- * that claim's session id when re-acquiring keeps the move from reading as a
- * takeover of a stranger.
+ * Moves this tree's live claim, identified by PATH: the CLI never sees the session id
+ * SessionStart stamps. Reusing that claim's session id keeps the move from reading as a takeover.
  */
 function acquireOrMove(feature, { cwd, gitCommonDir, json }) {
   const here = norm(cwd);
@@ -84,10 +55,6 @@ function acquireOrMove(feature, { cwd, gitCommonDir, json }) {
   process.exit(0);
 }
 
-/**
- * @param {string|undefined} feature
- * @param {{ release?: boolean, list?: boolean, json?: boolean, cwd?: string }} [options]
- */
 export function claimCommand(feature, options = {}) {
   const cwd = options.cwd || process.cwd();
   if (!isGitRepo(cwd)) {
@@ -120,27 +87,16 @@ export function claimCommand(feature, options = {}) {
     process.exit(0);
   }
 
-  // `morph-spec claim <feature>` (no --release, no --list) is the manual
-  // acquire/move half of B1 — automation (SessionStart + heartbeat) covers the
-  // common case; this covers switching this session to a different feature
-  // mid-task without a release-then-reclaim dance. `--list` forces the
-  // read-only view below even when a feature is named.
   if (feature && !options.list) {
     acquireOrMove(feature, { cwd, gitCommonDir, json: options.json });
     return;
   }
 
-  // No feature (or explicit --list): the read-only board, whole or filtered.
   const all = listClaims(gitCommonDir);
   const scoped = feature ? all.filter((c) => c.feature === feature) : all;
 
-  // Um claim morto NÃO é limpo do registro — ele só para de avisar (o TTL de
-  // 30 min o mata, `live` é computado na leitura). O efeito colateral é que o
-  // board acumula: features encerradas há 20h e 73h apareciam no `--list` como
-  // se fossem informação. Um quadro de avisos onde quase nada é aviso ensina a
-  // não olhar o quadro. Por padrão mostramos só o que ainda avisa; `--all`
-  // devolve o registro inteiro, e o rodapé conta o que ficou de fora para a
-  // omissão nunca ser silenciosa.
+  // Claim morto segue no registro (`live` é computado na leitura): por padrão só o que ainda
+  // avisa; `--all` devolve tudo e o rodapé conta o que ficou de fora.
   const rows = options.all ? scoped : scoped.filter((c) => c.live);
   const hidden = scoped.length - rows.length;
 

package/src/commands/project/doctor-procs.js

@@ -134,7 +134,7 @@ export async function doctorProcsCommand(targetPath, options = {}) {
     const { afterHeavyRun } = await import('../../lib/heavy/cleanup.js');
     report.prune = report.procs.status === 'ok' ? pruneOrphans(report.procs.rows, options.pruneDeps) : [];
     report.buildServer = afterHeavyRun({
-      projectPath: targetPath, config: readHeavyConfig(targetPath), scope: 'prune', deps: options.cleanupDeps,
+      projectPath: targetPath, config: readHeavyConfig(targetPath), deps: options.cleanupDeps,
     });
   }