@hrg/gitignore 0.3.0 → 0.3.2

package/README.md

@@ -127,9 +127,10 @@ Steps 1–6 of [`plans/next-steps.md`](plans/next-steps.md) are implemented:
 - the corpus generator is [`conformance/from-git-check-ignore.mjs`](conformance/from-git-check-ignore.mjs), a
   separate step because it needs a checkout CI will not have.
 
-What remains is **publishing** (step 7), scheduled for **0.3.0**: [Publishing](#publishing) is the checklist, and once
-the version is on the registry, `fs-meta`'s path dependency (`../gitignore` in its `build.zig.zon`, `file:` in its
-`package.json`) becomes a version range, the way `hr.hrg:wyhash` is consumed. The Java and JS
+**0.3.0** is released — the same version on npm (`@hrg/gitignore`) and Maven Central (`hr.hrg:gitignore`):
+[Publishing](#publishing) records the release commands. `fs-meta`'s path dependency (`../gitignore` in its
+`build.zig.zon`, `file:` in its `package.json`) can therefore become a version range, the way `hr.hrg:wyhash` is
+consumed. The Java and JS
 ports still consume the vectors and the bench rather than re-deriving them, and a `bench/compare.mjs` that runs
 several ports in one table is a convenience, not a contract.
 
@@ -200,8 +201,8 @@ The package is `package.json` here (`"type": "module"`, `"sideEffects": false`,
 ```
 
 `pom.xml` builds the three matcher classes — `GitIgnoreFile`, `GitIgnoreRules` and the package-private `Glob` —
-with JDK 25. `bun java/run.mjs` remains the zero-build gate for the port. Until `0.3.0` is published, a machine
-needs the checkout installed once into the local repository:
+with JDK 25. `bun java/run.mjs` remains the zero-build gate for the port. A checkout can also be installed into the
+local repository once:
 
 ```text
 cd gitignore
@@ -259,23 +260,23 @@ The three JS columns are **the same vectors, the same port, three matching strat
   which is a pattern with `**` where the regex happened to be fast. That row is the open tuning question, not a settled
   result.
 
-The Java port still runs the full DP (4397 ms total, `backtrack` 3205 ms, `anchored` and `doublestar` regressed against its
-regex version). The same hybrid applies to it and is the next step; the numbers above are why it should be measured per
-workload rather than by the total.
-
+Both ports now run the same segment DP as the reference, with the ancestor memoisation that took them from 17x and 11x behind
+Zig to about 1.6x and 2.2x at the time it was measured - and the reference has since become roughly 10x faster than it started,
+so the relative gap moved again. The current numbers, the method, and every improvement (including what was measured and
+refuted) are in [doc/performance/](doc/performance/README.md) and [doc/measurement.md](doc/measurement.md).
 ### How these numbers are produced
 
 Cold-process runs, with start-up measured separately and subtracted. That is the honest number for a CLI and it is
-also noisy: the same Java build has reported `backtrack` at 3205 ms and 5129 ms. [+doc/measurement.md](doc/measurement.md)](doc/measurement.md) records the two measurement modes, the steady-state table (12 rounds inside one process) and every
+also noisy: the same Java build has reported `backtrack` at 3205 ms and 5129 ms. [doc/measurement.md](doc/measurement.md) records the two measurement modes, the steady-state table (12 rounds inside one process) and every
 strategy tried on the Java port with what it cost. The Java column above predates the literal-segment fast path.
 
 ### Two caveats
 
 - The runner measures a process; the start-up column is a subtraction, and on a loaded machine it is a noisy one. The
   large rows are far outside that noise; the small ones are not.
-- The ports are young. Their remaining distance to Zig is a design difference, not tuning: Java has not adopted the DP, and
-  neither port has the Zig implementation's per-chain indexing.
-
+- The ports are no longer "young" in the sense that mattered: the Java port adopted the segment DP, then literal segments, then
+  the ancestor memoisation, and the JS port did the same. What remains is the reference's own head start - it has three indexes
+  the ports do not have, and [doc/performance/shared.md](doc/performance/shared.md) is the list a new port should work through.
 ## Running the three
 
 ```text
@@ -286,3 +287,106 @@ bun bench/perf.mjs --repeat 3 \
   --port "js=bun js/decide.mjs --rules {rules} --paths {paths}" \
   --port "java=\"…\bin\java.exe\" -cp java/out hr.hrg.gitignore.Decide --rules {rules} --paths {paths}"
 ```
+## Publishing to npm
+
+```text
+cd <this checkout>
+bun js/conformance.mjs          # 34/34, the vectors are the gate
+bun pm pack --dry-run           # 4 files: package.json, README.md, js/gitignore.mjs, js/glob.mjs
+npm publish                     # publishConfig supplies --access public
+```
+
+**It needs a live token.** Measured on 2026-10-24: `npm whoami` answered `401 Unauthorized` with the token in
+`~/.npmrc`, and `npm publish` reported `404 Not Found - @hrg/gitignore@0.3.1`. npm answers 404 rather than 403 when a
+token cannot publish to a scope, so the 404 is the *symptom* of an expired/revoked token, not of a missing package
+(`npm owner ls @hrg/gitignore` works and names `hrgdavor`, and 0.3.0 is on the registry). Fix with `npm login`, then
+publish; no change to this repository is needed.
+
+`fs-meta` pins `"@hrg/gitignore": "0.3.0"` exactly, which is the published version. Bump that one line to `"0.3.1"` when
+npm has it.
+## Publishing the Maven artifact
+
+The release is **0.3.0**, the same version as `build.zig.zon` and `package.json`. Publishing is deliberate now:
+the Central publisher lives only in [`pom-release.xml`](pom-release.xml), and `pom.xml` has no publisher at all.
+
+### Why the publisher is not in `pom.xml`, and never in a profile
+
+Maven reads `<extensions>true</extensions>` only from a POM's **top-level `<build>`**, never from a profile. The
+publisher was once declared in the `publish` profile; it silently never loaded, so `deploy` staged a bundle and
+stopped — no upload, and not a word about "central" in the log. That is the failure this layout prevents.
+
+Declaring it in `pom.xml`'s top-level `<build>` does load it, but then *every* build loads it and a bare
+`mvn deploy` publishes to Central whether or not `-Ppublish` was passed. So the publisher is kept out of `pom.xml`
+entirely and exists only in `pom-release.xml`, in that POM's top-level `<build>`.
+
+The guard has two halves:
+
+- `pom.xml` sets `maven.deploy.skip=true`. `mvn deploy` on it reaches `maven-deploy-plugin` and logs
+  `Skipping artifact deployment`; it uploads nothing, and the publisher is not on the build's classpath at all.
+- `pom-release.xml` is a copy of `pom.xml` plus the publisher. It keeps `maven.deploy.skip=true` too: that property
+  disables `maven-deploy-plugin`, **not** the Central publisher, which is a separate goal at the same phase. If the
+  extension ever failed to load, the release would do nothing rather than fall back to a direct deploy. Verified with
+  the plugin: with `maven.deploy.skip=true`, `central-publishing:0.6.0:publish` still runs and logs
+  `Skipping Central Publishing at user's request.` when `-DskipPublishing=true` is passed.
+
+`pom-release.xml` is a **copy**, not a child: Maven 3.9.9 rejects a jar-packaged POM as a parent
+(`Invalid packaging for parent POM ... must be "pom" but is "jar"`), and Maven has no POM include. Everything is
+duplicated; only the comment block and the publisher plugin are meant to differ. [`scripts/check-poms.mjs`](scripts/check-poms.mjs)
+strips comments, removes the publisher, and fails if anything else differs; it also asserts that both POMs declare the
+same version. Run `bun scripts/check-poms.mjs` after editing either POM, and copy `pom.xml` again in the same commit.
+
+### The release command
+
+**On this machine `mvn` is `mvnd` (native mode), not the real Maven, and it refuses `-Dmvnd.noDaemon`.** Releasing uses
+the unpacked real Maven in `.tmp/maven/` (Maven 3.9.9), with JDK 25:
+
+```text
+$env:JAVA_HOME = 'C:\Program Files\Java\jdk-25'
+$env:MAVEN_GPG_PASSPHRASE = '<your passphrase>'
+.tmp\maven\apache-maven-3.9.9\bin\mvn.cmd -f pom-release.xml -Ppublish -DskipTests package
+.tmp\maven\apache-maven-3.9.9\bin\mvn.cmd -f pom-release.xml -Ppublish -Dgpg.skip=false -DskipTests deploy
+```
+
+The first command checks that the binary, sources and javadoc jars all appear in `target/`; the second is the release.
+`-Ppublish` adds `maven-source-plugin`, `maven-javadoc-plugin` and `maven-gpg-plugin` (the profile is in both POMs).
+`gpg.skip` defaults to `true`, so nothing signs unless `-Dgpg.skip=false` is passed.
+
+To exercise the release path **without uploading**, pass the publisher's own switch:
+
+```text
+.tmp\maven\apache-maven-3.9.9\bin\mvn.cmd -f pom-release.xml -DskipTests -DskipPublishing=true deploy
+```
+
+That runs `central-publishing:0.6.0:publish`, stages and bundles locally, logs
+`Skipping Central Publishing at user's request.`, and stops before the upload. **Do not** prove the release path with a
+bare `deploy`.
+
+Requirements, learned from a project of this author's that publishes this way (`dia-log`):
+
+- `~/.m2/settings.xml` has a server with id **`central`** carrying the Sonatype token.
+- **The signing passphrase comes from `MAVEN_GPG_PASSPHRASE`**, not from `settings.xml`: the plugin deprecates
+  `passphraseServerId` (it warns that a passphrase in a file can leak), and the profile passes
+  `--pinentry-mode loopback` so gpg reads the environment instead of trying to open a prompt that a batch build cannot
+  answer. Measured on this machine: with the variable set, a wrong value produces `gpg: signing failed: Bad passphrase`
+  (proving the passphrase reaches the key); with it unset the agent answers `Operation cancelled`, which is what a GUI-less
+  run looks like. A passphrase stored in `settings.xml` under the old id is ignored now.
+- `gpg.skip` defaults to `true`, so a local build never signs; the release passes `-Dgpg.skip=false`.
+- The Central publisher takes over the `deploy` phase and suppresses `maven-deploy-plugin`, so the
+  `distributionManagement` in both POMs (Sonatype's `maven-releases` endpoint) is not a second upload path. The
+  publisher uses `skipPublishing` to stop before the upload and the `central` server for credentials; it does **not**
+  use `altDeploymentRepository`.
+- The version comes from the POM (`0.3.0`), and `build.zig.zon`/`package.json` must agree — they do.
+
+Afterwards, `fs-meta` resolves `hr.hrg:gitignore` from the repository like any other artifact; it no longer needs the local
+`mvn install`.
+## Checks
+
+```text
+bun scripts/check-verdicts.mjs         # the three implementations agree, byte for byte
+bun scripts/check-verdicts.mjs --json  # one NDJSON object per workload
+```
+
+The 34 conformance vectors say what the matcher must decide; this says that the three implementations decide the *same thing*
+on the six bench workloads — 10,000 verdicts, compared byte for byte, with the first differing line named on failure. A missing
+binary is exit 2 with the build command, never a skip. It exists because twice in this project's history "the vectors pass" was
+mistaken for "the ports agree", and the comparison had been run by hand in scratch files that were never committed.

package/js/gitignore.mjs

@@ -216,9 +216,16 @@ export function parseGitignore(relativeDirectory, text) {
         }
         scoped = relativePath.slice(prefix.length);
       }
+      // Split once for every `**` rule of this file, and only if one of them is reached: a file whose patterns all
+      // compile to a regex pays no split at all (the `*.log`-shaped rule sets of the small workloads).
+      let segments = null;
       for (let index = rules.length - 1; index >= 0; index--) {
-        if (matches(rules[index], scoped, isDirectory)) {
-          return !rules[index].negated;
+        const rule = rules[index];
+        if (rule.segments !== null && segments === null) {
+          segments = scoped.split('/');
+        }
+        if (matches(rule, scoped, isDirectory, segments)) {
+          return !rule.negated;
         }
       }
       return undefined;
@@ -286,13 +293,20 @@ export function readGitignore(directoryPath, relativeDirectory) {
  */
 export class GitIgnoreRules {
   #stack = [];
+  // A directory's answer, keyed by its path relative to the walk root. A path list visits the same directories over
+  // and over (`backtrack` asks about 84,000 ancestor directories that are 42 distinct ones), and the rules are a
+  // snapshot, so the answer cannot change while the stack is unchanged. `push`/`pop` clear it: they are the only
+  // things that change which files govern a directory, and a cached "excluded" must never outlive them.
+  #excluded = new Map();
 
   push(file) {
     this.#stack.push(file);
+    this.#excluded.clear();
   }
 
   pop() {
     this.#stack.pop();
+    this.#excluded.clear();
   }
 
   get depth() {
@@ -305,10 +319,17 @@ export class GitIgnoreRules {
       return true;
     }
     // An excluded directory is never entered, so a rule for a file inside it cannot re-include that file: ask the
-    // ancestors, deepest first. A parent that a later rule re-includes answers false and is skipped.
-    const segments = relativePath.split('/');
-    for (let count = segments.length - 1; count >= 1; count -= 1) {
-      if (this.decideDirect(segments.slice(0, count).join('/'), true) === true) {
+    // ancestors, deepest first. A parent that a later rule re-includes answers false and is skipped. The ancestor is
+    // found by walking the separators backwards, so no ancestor costs a split and a join — one substring, which is
+    // also the memo's key.
+    for (let slash = relativePath.lastIndexOf('/'); slash >= 0; slash = relativePath.lastIndexOf('/', slash - 1)) {
+      const ancestor = relativePath.slice(0, slash);
+      let excluded = this.#excluded.get(ancestor);
+      if (excluded === undefined) {
+        excluded = this.decideDirect(ancestor, true) === true;
+        this.#excluded.set(ancestor, excluded);
+      }
+      if (excluded) {
         return true;
       }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hrg/gitignore",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "git's .gitignore (wildmatch) semantics: one matcher, shared by the Zig, JavaScript and Java ports.",
   "license": "LicenseRef-GPL-3.0-with-Commons-Clause",
   "author": "Davor Hrg",
@@ -27,6 +27,8 @@
     "access": "public"
   },
   "scripts": {
-    "conformance": "bun js/conformance.mjs"
+    "conformance": "bun js/conformance.mjs",
+    "test": "bun test",
+    "java": "bun java/run.mjs"
   }
 }