@polymorphism-tech/morph-spec 10.2.0 → 10.5.3

package/src/lib/verify/detached.js

@@ -0,0 +1,156 @@
+import { spawn } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { closeSync, existsSync, mkdirSync, openSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { setTimeout as sleep } from 'node:timers/promises';
+import { backgroundArgs } from '../../../framework/hooks/shared/background-spawn.js';
+import { heavyDir } from '../../../framework/hooks/shared/heavy-holders.js';
+import { pidAlive } from '../../../framework/hooks/shared/process-alive.js';
+import { treeFingerprint } from '../git/tree-fingerprint.js';
+
+export const DETACH_STAGE_ENV = 'MORPH_VERIFY_STAGE';
+export const DETACH_RUN_ENV = 'MORPH_VERIFY_RUN';
+export const DETACH_WORKER_ENV = 'MORPH_VERIFY_WORKER_PID';
+
+const POLL_MS = 2_000;
+const MAX_RUN_MS = 3 * 60 * 60_000;
+
+export const EXIT_BUSY = 3;
+
+export function runPaths(cwd, feature, env = process.env) {
+  const id = createHash('sha1').update(`${cwd}\0${feature}`).digest('hex').slice(0, 12);
+  const base = join(heavyDir(env), `verify-${id}`);
+  return { run: `${base}.json`, exit: `${base}.exit`, out: `${base}.out`, err: `${base}.err` };
+}
+
+const readJson = (path) => {
+  try {
+    return JSON.parse(readFileSync(path, 'utf8'));
+  } catch {
+    return null;
+  }
+};
+
+const readExit = (path) => {
+  try {
+    return Number.parseInt(readFileSync(path, 'utf8'), 10);
+  } catch {
+    return null;
+  }
+};
+
+const readText = (path) => {
+  try {
+    return readFileSync(path, 'utf8');
+  } catch {
+    return '';
+  }
+};
+
+const removeRun = (paths) => {
+  for (const file of Object.values(paths)) rmSync(file, { force: true });
+};
+
+export function matchesRun(record, { key, args }) {
+  return record?.key === key && JSON.stringify(record.args) === JSON.stringify(args);
+}
+
+export function isRunning(record, paths, { isAlive = pidAlive, now = Date.now } = {}) {
+  if (!record || existsSync(paths.exit)) return false;
+  return isAlive(record.pid) && now() - record.startedAt < MAX_RUN_MS;
+}
+
+export const runFilesOf = (runFile) => ({
+  run: runFile,
+  exit: runFile.replace(/\.json$/, '.exit'),
+  out: runFile.replace(/\.json$/, '.out'),
+  err: runFile.replace(/\.json$/, '.err'),
+});
+
+function spawnStage(stage, { argv, cwd, env, paths, script, spawnFn = spawn }) {
+  mkdirSync(join(paths.run, '..'), { recursive: true });
+  const out = openSync(paths.out, 'a');
+  const err = openSync(paths.err, 'a');
+  try {
+    const args = [script, ...argv];
+    const child = spawnFn(process.execPath, stage === 'launch' ? args : backgroundArgs(args), {
+      cwd,
+      detached: true,
+      windowsHide: true,
+      stdio: ['ignore', out, err],
+      env: { ...env, [DETACH_STAGE_ENV]: stage, [DETACH_RUN_ENV]: paths.run },
+    });
+    child.unref();
+    return child;
+  } finally {
+    closeSync(out);
+    closeSync(err);
+  }
+}
+
+export function markWorkerExit(runFile, { processRef = process } = {}) {
+  const exitFile = runFilesOf(runFile).exit;
+  processRef.once('exit', (code) => {
+    try {
+      writeFileSync(exitFile, String(code ?? 1));
+    } catch {}
+  });
+}
+
+/**
+ * The launcher exists to die: killing a process tree walks parent pids, so a worker whose
+ * parent has exited is out of reach of whatever kills the session's background shell.
+ */
+export function launchWorker({ env = process.env, cwd = process.cwd(), argv, script = process.argv[1], spawnFn }) {
+  const runFile = env[DETACH_RUN_ENV];
+  const paths = runFilesOf(runFile);
+  const child = spawnStage('worker', { argv, cwd, env, paths, script, spawnFn });
+  writeFileSync(runFile, JSON.stringify({ ...readJson(runFile), pid: child.pid }));
+  spawnStage('watchdog', {
+    argv, cwd, env: { ...env, [DETACH_WORKER_ENV]: String(child.pid) }, paths, script, spawnFn,
+  });
+}
+
+export async function superviseVerify({
+  feature, args, cwd = process.cwd(), env = process.env, script = process.argv[1], log = (m) => process.stderr.write(`${m}\n`),
+  deps = {},
+}) {
+  const {
+    fingerprint = treeFingerprint, spawnFn, isAlive = pidAlive, now = Date.now, wait = sleep, pollMs = POLL_MS,
+  } = deps;
+  const paths = runPaths(cwd, feature, env);
+  const key = fingerprint(cwd);
+  let record = readJson(paths.run);
+  const liveness = { isAlive, now };
+
+  if (isRunning(record, paths, liveness) && !matchesRun(record, { key, args })) {
+    log('verify: outra rodada desta feature ainda corre, sobre outra árvore; espero ela acabar');
+    while (isRunning(record, paths, liveness)) await wait(pollMs);
+    record = null;
+  }
+
+  const attachable = matchesRun(record, { key, args }) && (isRunning(record, paths, liveness) || existsSync(paths.exit));
+  if (attachable) {
+    log(`verify: retomo a rodada destacada iniciada às ${new Date(record.startedAt).toLocaleTimeString()}`);
+  } else {
+    removeRun(paths);
+    mkdirSync(join(paths.run, '..'), { recursive: true });
+    record = { pid: null, key, args, startedAt: now() };
+    writeFileSync(paths.run, JSON.stringify(record));
+    spawnStage('launch', { argv: args, cwd, env, paths, script, spawnFn });
+  }
+
+  while (!existsSync(paths.exit)) {
+    const current = readJson(paths.run);
+    const launching = !current?.pid && now() - record.startedAt < 30_000;
+    if (!launching && !isRunning(current, paths, liveness)) break;
+    await wait(pollMs);
+  }
+
+  const exitCode = readExit(paths.exit);
+  const stdout = readText(paths.out);
+  const stderr = readText(paths.err);
+  removeRun(paths);
+  const died = exitCode === null || (exitCode === EXIT_BUSY && !stdout.trim());
+  return { exitCode: exitCode ?? EXIT_BUSY, stdout, stderr, died };
+}

package/src/utils/hooks-installer.js

@@ -3,6 +3,7 @@ import { readFile } from 'fs/promises';
 import { existsSync, readdirSync } from 'fs';
 import { homedir } from 'os';
 import { realEffects } from '../lib/installers/effects.js';
+import { CPU_SHARE_ENVS, cpuShareOf, readHeavyConfig } from '../../framework/hooks/shared/heavy-config.js';
 
 const HOOKS_VERSION = '3.17.0';
 
@@ -275,6 +276,13 @@ export async function installClaudeHooks(targetPath, { fx = realEffects() } = {}
     settings.plansDirectory = '.morph/plans';
   }
 
+  // What runs outside the queue (a loose `dotnet test`) keeps to a run's share too; a value already here stays.
+  const heavy = readHeavyConfig(targetPath);
+  if (heavy.yieldToUser) {
+    const share = String(cpuShareOf(heavy.slots));
+    settings.env = { ...Object.fromEntries(CPU_SHARE_ENVS.map((name) => [name, share])), ...settings.env };
+  }
+
   settings._morph_managed = settings._morph_managed || {};
   settings._morph_managed.hooks_version = HOOKS_VERSION;
   settings._morph_managed.hooks_installed = [...new Set(MORPH_HOOKS.map(h => h.event))];

package/framework/templates/.idea/morph-templates.xml

@@ -1,92 +0,0 @@
-<templateSet group="MORPH Templates">
-  <template name="morph-pascal" value="{{pascalCase $FEATURE_NAME$}}" description="Convert to PascalCase (UserAuth)" toReformat="false" toShortenFQNames="true">
-    <variable name="FEATURE_NAME" expression="" defaultValue="&quot;FEATURE_NAME&quot;" alwaysStopAt="true" />
-    <context>
-      <option name="OTHER" value="true" />
-    </context>
-  </template>
-
-  <template name="morph-camel" value="{{camelCase $FEATURE_NAME$}}" description="Convert to camelCase (userAuth)" toReformat="false" toShortenFQNames="true">
-    <variable name="FEATURE_NAME" expression="" defaultValue="&quot;FEATURE_NAME&quot;" alwaysStopAt="true" />
-    <context>
-      <option name="OTHER" value="true" />
-    </context>
-  </template>
-
-  <template name="morph-snake" value="{{snakeCase $FEATURE_NAME$}}" description="Convert to snake_case (user_auth)" toReformat="false" toShortenFQNames="true">
-    <variable name="FEATURE_NAME" expression="" defaultValue="&quot;FEATURE_NAME&quot;" alwaysStopAt="true" />
-    <context>
-      <option name="OTHER" value="true" />
-    </context>
-  </template>
-
-  <template name="morph-title" value="{{titleCase $FEATURE_NAME$}}" description="Convert to Title Case (User Auth)" toReformat="false" toShortenFQNames="true">
-    <variable name="FEATURE_NAME" expression="" defaultValue="&quot;FEATURE_NAME&quot;" alwaysStopAt="true" />
-    <context>
-      <option name="OTHER" value="true" />
-    </context>
-  </template>
-
-  <template name="morph-kebab" value="{{kebabCase $FEATURE_NAME$}}" description="Convert to kebab-case (user-auth)" toReformat="false" toShortenFQNames="true">
-    <variable name="FEATURE_NAME" expression="" defaultValue="&quot;FEATURE_NAME&quot;" alwaysStopAt="true" />
-    <context>
-      <option name="OTHER" value="true" />
-    </context>
-  </template>
-
-  <template name="morph-if" value="{{#if $CONDITION$}}&#10;  $END$&#10;{{/if}}" description="Handlebars if block" toReformat="false" toShortenFQNames="true">
-    <variable name="CONDITION" expression="" defaultValue="&quot;condition&quot;" alwaysStopAt="true" />
-    <context>
-      <option name="OTHER" value="true" />
-    </context>
-  </template>
-
-  <template name="morph-if-else" value="{{#if $CONDITION$}}&#10;  $TRUE_BRANCH$&#10;{{else}}&#10;  $FALSE_BRANCH$&#10;{{/if}}" description="Handlebars if-else block" toReformat="false" toShortenFQNames="true">
-    <variable name="CONDITION" expression="" defaultValue="&quot;condition&quot;" alwaysStopAt="true" />
-    <variable name="TRUE_BRANCH" expression="" defaultValue="&quot;&quot;" alwaysStopAt="true" />
-    <variable name="FALSE_BRANCH" expression="" defaultValue="&quot;&quot;" alwaysStopAt="true" />
-    <context>
-      <option name="OTHER" value="true" />
-    </context>
-  </template>
-
-  <template name="morph-each" value="{{#each $ITEMS$}}&#10;  {{this.$PROPERTY$}}&#10;{{/each}}" description="Handlebars each loop" toReformat="false" toShortenFQNames="true">
-    <variable name="ITEMS" expression="" defaultValue="&quot;items&quot;" alwaysStopAt="true" />
-    <variable name="PROPERTY" expression="" defaultValue="&quot;name&quot;" alwaysStopAt="true" />
-    <context>
-      <option name="OTHER" value="true" />
-    </context>
-  </template>
-
-  <template name="morph-service" value="namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}}.Services;&#10;&#10;public class {{pascalCase FEATURE_NAME}}Service(&#10;    I{{pascalCase FEATURE_NAME}}Repository repository,&#10;    ILogger&lt;{{pascalCase FEATURE_NAME}}Service&gt; logger) : I{{pascalCase FEATURE_NAME}}Service&#10;{&#10;    public async Task&lt;{{pascalCase FEATURE_NAME}}Dto?&gt; GetByIdAsync(int id, CancellationToken cancellationToken = default)&#10;    {&#10;        $END$&#10;    }&#10;}" description="MORPH .NET Service class template" toReformat="false" toShortenFQNames="true">
-    <context>
-      <option name="C_SHARP" value="true" />
-    </context>
-  </template>
-
-  <template name="morph-repository" value="public class {{pascalCase FEATURE_NAME}}Repository(AppDbContext context) : I{{pascalCase FEATURE_NAME}}Repository&#10;{&#10;    private readonly DbSet&lt;{{pascalCase FEATURE_NAME}}&gt; _dbSet = context.Set&lt;{{pascalCase FEATURE_NAME}}&gt;();&#10;&#10;    public async Task&lt;{{pascalCase FEATURE_NAME}}?&gt; GetByIdAsync(int id, CancellationToken cancellationToken = default)&#10;    {&#10;        $END$&#10;    }&#10;}" description="MORPH .NET Repository class template" toReformat="false" toShortenFQNames="true">
-    <context>
-      <option name="C_SHARP" value="true" />
-    </context>
-  </template>
-
-  <template name="morph-component" value="@page &quot;/{{kebabCase FEATURE_NAME}}&quot;&#10;@inject I{{pascalCase FEATURE_NAME}}Service {{pascalCase FEATURE_NAME}}Service&#10;@inject ILogger&lt;{{pascalCase FEATURE_NAME}}Page&gt; Logger&#10;&#10;&lt;PageTitle&gt;{{pascalCase FEATURE_NAME}}&lt;/PageTitle&gt;&#10;&#10;&lt;div class=&quot;container-fluid&quot;&gt;&#10;    $END$&#10;&lt;/div&gt;&#10;&#10;@code {&#10;&#10;}" description="MORPH Blazor component template" toReformat="false" toShortenFQNames="true">
-    <context>
-      <option name="HTML" value="true" />
-    </context>
-  </template>
-
-  <template name="morph-migration" value="public partial class Add{{pascalCase FEATURE_NAME}} : Migration&#10;{&#10;    protected override void Up(MigrationBuilder migrationBuilder)&#10;    {&#10;        migrationBuilder.CreateTable(&#10;            name: &quot;{{pascalCase FEATURE_NAME}}s&quot;,&#10;            columns: table =&gt; new&#10;            {&#10;                Id = table.Column&lt;int&gt;(type: &quot;int&quot;, nullable: false)&#10;                    .Annotation(&quot;SqlServer:Identity&quot;, &quot;1, 1&quot;),&#10;                $END$&#10;            },&#10;            constraints: table =&gt;&#10;            {&#10;                table.PrimaryKey(&quot;PK_{{pascalCase FEATURE_NAME}}s&quot;, x =&gt; x.Id);&#10;            });&#10;    }&#10;&#10;    protected override void Down(MigrationBuilder migrationBuilder)&#10;    {&#10;        migrationBuilder.DropTable(name: &quot;{{pascalCase FEATURE_NAME}}s&quot;);&#10;    }&#10;}" description="MORPH EF Core migration template" toReformat="false" toShortenFQNames="true">
-    <context>
-      <option name="C_SHARP" value="true" />
-    </context>
-  </template>
-
-  <template name="morph-ts-contract" value="export interface {{pascalCase FEATURE_NAME}} {&#10;  id: number;&#10;  $FIELD1$&#10;}&#10;&#10;export interface Create{{pascalCase FEATURE_NAME}}Request {&#10;  $FIELD2$&#10;}&#10;&#10;export interface Update{{pascalCase FEATURE_NAME}}Request {&#10;  $END$&#10;}" description="MORPH TypeScript contract template" toReformat="false" toShortenFQNames="true">
-    <variable name="FIELD1" expression="" defaultValue="&quot;&quot;" alwaysStopAt="true" />
-    <variable name="FIELD2" expression="" defaultValue="&quot;&quot;" alwaysStopAt="true" />
-    <context>
-      <option name="TypeScript" value="true" />
-    </context>
-  </template>
-</templateSet>

package/framework/templates/.vscode/morph-templates.code-snippets

@@ -1,186 +0,0 @@
-{
-  "MORPH Template - PascalCase": {
-    "prefix": "morph-pascal",
-    "body": ["{{pascalCase ${1:FEATURE_NAME}}}"],
-    "description": "Convert to PascalCase (UserAuth)"
-  },
-  "MORPH Template - camelCase": {
-    "prefix": "morph-camel",
-    "body": ["{{camelCase ${1:FEATURE_NAME}}}"],
-    "description": "Convert to camelCase (userAuth)"
-  },
-  "MORPH Template - snake_case": {
-    "prefix": "morph-snake",
-    "body": ["{{snakeCase ${1:FEATURE_NAME}}}"],
-    "description": "Convert to snake_case (user_auth)"
-  },
-  "MORPH Template - Title Case": {
-    "prefix": "morph-title",
-    "body": ["{{titleCase ${1:FEATURE_NAME}}}"],
-    "description": "Convert to Title Case (User Auth)"
-  },
-  "MORPH Template - kebab-case": {
-    "prefix": "morph-kebab",
-    "body": ["{{kebabCase ${1:FEATURE_NAME}}}"],
-    "description": "Convert to kebab-case (user-auth)"
-  },
-  "MORPH Template - UPPER_SNAKE_CASE": {
-    "prefix": "morph-upper-snake",
-    "body": ["{{upperSnakeCase ${1:FEATURE_NAME}}}"],
-    "description": "Convert to UPPER_SNAKE_CASE (USER_AUTH)"
-  },
-  "MORPH Template - Conditional If": {
-    "prefix": "morph-if",
-    "body": [
-      "{{#if ${1:condition}}}",
-      "  $2",
-      "{{/if}}"
-    ],
-    "description": "Handlebars if block"
-  },
-  "MORPH Template - Conditional If-Else": {
-    "prefix": "morph-if-else",
-    "body": [
-      "{{#if ${1:condition}}}",
-      "  $2",
-      "{{else}}",
-      "  $3",
-      "{{/if}}"
-    ],
-    "description": "Handlebars if-else block"
-  },
-  "MORPH Template - Each Loop": {
-    "prefix": "morph-each",
-    "body": [
-      "{{#each ${1:items}}}",
-      "  {{this.$2}}",
-      "{{/each}}"
-    ],
-    "description": "Handlebars each loop"
-  },
-  "MORPH Template - Unless": {
-    "prefix": "morph-unless",
-    "body": [
-      "{{#unless ${1:condition}}}",
-      "  $2",
-      "{{/unless}}"
-    ],
-    "description": "Handlebars unless block"
-  },
-  "MORPH Template - .NET Service Class": {
-    "prefix": "morph-service",
-    "body": [
-      "namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}}.Services;",
-      "",
-      "public class {{pascalCase FEATURE_NAME}}Service(",
-      "    I{{pascalCase FEATURE_NAME}}Repository repository,",
-      "    ILogger<{{pascalCase FEATURE_NAME}}Service> logger) : I{{pascalCase FEATURE_NAME}}Service",
-      "{",
-      "    public async Task<{{pascalCase FEATURE_NAME}}Dto?> GetByIdAsync(int id, CancellationToken cancellationToken = default)",
-      "    {",
-      "        $1",
-      "    }",
-      "}"
-    ],
-    "description": "MORPH .NET Service class template"
-  },
-  "MORPH Template - .NET Repository Class": {
-    "prefix": "morph-repository",
-    "body": [
-      "public class {{pascalCase FEATURE_NAME}}Repository(AppDbContext context) : I{{pascalCase FEATURE_NAME}}Repository",
-      "{",
-      "    private readonly DbSet<{{pascalCase FEATURE_NAME}}> _dbSet = context.Set<{{pascalCase FEATURE_NAME}}>();",
-      "",
-      "    public async Task<{{pascalCase FEATURE_NAME}}?> GetByIdAsync(int id, CancellationToken cancellationToken = default)",
-      "    {",
-      "        $1",
-      "    }",
-      "}"
-    ],
-    "description": "MORPH .NET Repository class template"
-  },
-  "MORPH Template - Blazor Component": {
-    "prefix": "morph-component",
-    "body": [
-      "@page \"/{{kebabCase FEATURE_NAME}}\"",
-      "@inject I{{pascalCase FEATURE_NAME}}Service {{pascalCase FEATURE_NAME}}Service",
-      "@inject ILogger<{{pascalCase FEATURE_NAME}}Page> Logger",
-      "",
-      "<PageTitle>{{pascalCase FEATURE_NAME}}</PageTitle>",
-      "",
-      "<div class=\"container-fluid\">",
-      "    $1",
-      "</div>",
-      "",
-      "@code {",
-      "    $2",
-      "}"
-    ],
-    "description": "MORPH Blazor component template"
-  },
-  "MORPH Template - EF Core Migration": {
-    "prefix": "morph-migration",
-    "body": [
-      "public partial class Add{{pascalCase FEATURE_NAME}} : Migration",
-      "{",
-      "    protected override void Up(MigrationBuilder migrationBuilder)",
-      "    {",
-      "        migrationBuilder.CreateTable(",
-      "            name: \"{{pascalCase FEATURE_NAME}}s\",",
-      "            columns: table => new",
-      "            {",
-      "                Id = table.Column<int>(type: \"int\", nullable: false)",
-      "                    .Annotation(\"SqlServer:Identity\", \"1, 1\"),",
-      "                $1",
-      "            },",
-      "            constraints: table =>",
-      "            {",
-      "                table.PrimaryKey(\"PK_{{pascalCase FEATURE_NAME}}s\", x => x.Id);",
-      "            });",
-      "    }",
-      "",
-      "    protected override void Down(MigrationBuilder migrationBuilder)",
-      "    {",
-      "        migrationBuilder.DropTable(name: \"{{pascalCase FEATURE_NAME}}s\");",
-      "    }",
-      "}"
-    ],
-    "description": "MORPH EF Core migration template"
-  },
-  "MORPH Template - Hangfire Job": {
-    "prefix": "morph-job",
-    "body": [
-      "public class {{pascalCase FEATURE_NAME}}ProcessorJob(",
-      "    I{{pascalCase FEATURE_NAME}}Service service,",
-      "    ILogger<{{pascalCase FEATURE_NAME}}ProcessorJob> logger) : I{{pascalCase FEATURE_NAME}}ProcessorJob",
-      "{",
-      "    [AutomaticRetry(Attempts = 3, DelaysInSeconds = new[] { 60, 300, 900 })]",
-      "    [Queue(\"default\")]",
-      "    [JobDisplayName(\"{{pascalCase FEATURE_NAME}} Processing - ID: {0}\")]",
-      "    public async Task ExecuteAsync(int id, CancellationToken cancellationToken)",
-      "    {",
-      "        $1",
-      "    }",
-      "}"
-    ],
-    "description": "MORPH Hangfire job template"
-  },
-  "MORPH Template - TypeScript Contract": {
-    "prefix": "morph-ts-contract",
-    "body": [
-      "export interface {{pascalCase FEATURE_NAME}} {",
-      "  id: number;",
-      "  $1",
-      "}",
-      "",
-      "export interface Create{{pascalCase FEATURE_NAME}}Request {",
-      "  $2",
-      "}",
-      "",
-      "export interface Update{{pascalCase FEATURE_NAME}}Request {",
-      "  $3",
-      "}"
-    ],
-    "description": "MORPH TypeScript contract template"
-  }
-}