looply-cli 0.0.0-stage → 0.2.0

package/dist/scope-rule.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPureAddition = isPureAddition;
+exports.scopeViolations = scopeViolations;
+exports.describeScopeViolations = describeScopeViolations;
+const glob_1 = require("./glob");
+/**
+ * Does this status introduce a path that did not exist in the base?
+ *
+ * 🔴 DELIBERATELY AN ALLOW-LIST, NOT A DENY-LIST. A status this function has
+ * never heard of returns `false` and the path is refused under an additive
+ * grant. That is the direction an interlock has to fail in: a wrong refusal is
+ * loud, visible in the abort, and fixed by widening the grant — a wrong pass
+ * lets a worker rewrite a file the operator believed was frozen, and nothing
+ * says it happened.
+ *
+ * Accepted:
+ *   `??`  untracked — the ordinary shape of a new file, with `-uall` listing it
+ *         individually rather than collapsing it into its directory
+ *   `A `  added to the index
+ *   `AM`  added, then further modified in the worktree. Still a file that did
+ *         not exist in the base; the modification is to the round's own new
+ *         content and takes nothing away.
+ *
+ * Refused, each for a stated reason:
+ *   `AD`  added then deleted — the net effect is no file, and calling that an
+ *         addition would let a delete-recreate-delete sequence read as clean.
+ *   `R`/`C`  rename and copy. `changedEntries` emits BOTH ends of these with
+ *         the same status, so accepting the destination would also accept the
+ *         source — a rename out of an additive path would be permitted by the
+ *         very rule that names renaming as forbidden.
+ *   `T`   type or mode change, which the decision names explicitly.
+ *   everything else, including the unmerged states.
+ */
+function isPureAddition(status) {
+    if (status === '??')
+        return true;
+    if (status.length >= 1 && status[0] === 'A') {
+        const worktree = status.length >= 2 ? status[1] : ' ';
+        return worktree === ' ' || worktree === 'M';
+    }
+    return false;
+}
+/**
+ * A path this fold will not reason about.
+ *
+ * A `..` segment cannot be matched honestly against a glob — `src/**` does not
+ * match `src/../etc/passwd`, so the path would pass the scope check while
+ * naming a file outside it. git does not produce such paths, which is exactly
+ * why a caller that somehow supplies one is handing over something unexpected,
+ * and an interlock's answer to unexpected is no.
+ */
+function unanalysable(path) {
+    const n = (0, glob_1.normalizePath)(path);
+    if (n === '')
+        return true;
+    return n.split('/').includes('..');
+}
+/**
+ * Every changed entry the declared scope does not permit, with the reason.
+ *
+ * Returns `[]` when the project declared no scope — the legacy contract — and
+ * for a diff that stays inside its grant.
+ */
+function scopeViolations(entries, scope) {
+    // Absent scope keeps its documented behaviour: no constraint. An explicitly
+    // declared empty scope does NOT take this door — it falls through and denies
+    // every path, which is the whole point of distinguishing the two.
+    if (scope.declared !== true)
+        return [];
+    const out = [];
+    for (const entry of entries) {
+        if (unanalysable(entry.path)) {
+            out.push({
+                path: entry.path,
+                status: entry.status,
+                kind: 'unanalysable',
+                because: 'the path cannot be matched against a scope pattern',
+            });
+            continue;
+        }
+        const free = (0, glob_1.matchesAny)(entry.path, scope.free);
+        if (free)
+            continue;
+        const additive = (0, glob_1.matchesAny)(entry.path, scope.additive);
+        if (!additive) {
+            out.push({
+                path: entry.path,
+                status: entry.status,
+                kind: 'outside-scope',
+                because: 'the path is in neither scope.free nor scope.additive',
+            });
+            continue;
+        }
+        if (!isPureAddition(entry.status)) {
+            out.push({
+                path: entry.path,
+                status: entry.status,
+                kind: 'additive-modify',
+                because: `scope.additive permits adding a file, and this entry is ${JSON.stringify(entry.status)}`,
+            });
+        }
+    }
+    return out;
+}
+/** One line a person can read, for the abort's reason field. */
+function describeScopeViolations(violations) {
+    const modify = violations.filter((v) => v.kind === 'additive-modify').length;
+    const outside = violations.filter((v) => v.kind === 'outside-scope').length;
+    const odd = violations.filter((v) => v.kind === 'unanalysable').length;
+    const parts = [];
+    if (modify > 0) {
+        parts.push(`${modify} existing ${modify === 1 ? 'file' : 'files'} changed under an additive-only grant`);
+    }
+    if (outside > 0)
+        parts.push(`${outside} outside the declared scope`);
+    if (odd > 0)
+        parts.push(`${odd} with a path that cannot be matched`);
+    return `the round changed paths its scope does not permit: ${parts.join(', ')}`;
+}
+//# sourceMappingURL=scope-rule.js.map

package/dist/scope-rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-rule.js","sourceRoot":"","sources":["../src/scope-rule.ts"],"names":[],"mappings":"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"}

package/dist/self-repo-id.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The declared repository at this working directory, or `null` when nothing
+ * declared resolves to here — which the cross-repo fold reads as "not
+ * established" rather than "no need is circular".
+ *
+ * 🔴 `resolve` ALONE IS NOT ENOUGH TO DECIDE "SAME DIRECTORY". Windows paths
+ * are case-insensitive and `resolve` is not, so a config naming this very
+ * directory in different casing compared unequal and a circular need went
+ * unrecognised. `realpathSync.native` asks the filesystem instead of the
+ * string: it returns the canonical casing, and resolves junctions and symlinks
+ * on the way — which matters here, because worktrees on this machine are
+ * junctions.
+ */
+export declare function selfRepoId(declared: readonly {
+    id: string;
+    path: string;
+}[], cwd: string): string | null;
+//# sourceMappingURL=self-repo-id.d.ts.map

package/dist/self-repo-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-repo-id.d.ts","sourceRoot":"","sources":["../src/self-repo-id.ts"],"names":[],"mappings":"AA8CA;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMxG"}

package/dist/self-repo-id.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selfRepoId = selfRepoId;
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * WHICH DECLARED REPOSITORY IS THIS ONE — by path, never by name.
+ *
+ * ⚠️ `path` is the only thing that says "this is me". The id is an identity a
+ * compatible set names and carries no location, and `name` in `project:` is a
+ * different namespace again — matching on either would make a project that
+ * happened to share a word with a sibling declare itself circular.
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * 🔴 IT LIVES HERE, AND NOT IN `bin.ts`, BECAUSE OF WHERE IT USED TO LIVE.
+ *
+ * It was written into the CLI entry point for convenience, and its spec
+ * therefore imported `./bin`. That made **two** suites importing the entry
+ * point, and the gate then failed twice — intermittently, once in `R3-A-4` and
+ * again in `R3-A-9` — with both of them unable to parse `bin.ts` at all:
+ *
+ *   SyntaxError: Invalid or unexpected token
+ *   ({"Object.<anonymous>":function(…){#!/usr/bin/env node
+ *
+ * The shebang reaching the runtime untransformed is what a half-written
+ * transform cache entry looks like, and two workers racing to write the entry
+ * for the same file is how you get one. ⚠️ **It passed four whole gates in
+ * between**, which is why an isolated pass settled nothing and why clearing the
+ * cache looked like a fix when it was only a reshuffle.
+ *
+ * One importer of the entry point cannot race another. The admission spec has a
+ * real reason to import `bin.ts` — it drives `main` through the actual command
+ * line. A path helper has none.
+ */
+function canonicalDir(p) {
+    try {
+        return fs_1.realpathSync.native(p);
+    }
+    catch {
+        /**
+         * ⚠️ THROWS FOR A PATH THAT DOES NOT EXIST, which is ordinary: a declared
+         * sibling may simply not be cloned here. The fallback keeps the comparison
+         * honest without inventing a filesystem answer — case-folded where the
+         * platform folds case, exact where it does not.
+         */
+        return process.platform === 'win32' ? p.toLowerCase() : p;
+    }
+}
+/**
+ * The declared repository at this working directory, or `null` when nothing
+ * declared resolves to here — which the cross-repo fold reads as "not
+ * established" rather than "no need is circular".
+ *
+ * 🔴 `resolve` ALONE IS NOT ENOUGH TO DECIDE "SAME DIRECTORY". Windows paths
+ * are case-insensitive and `resolve` is not, so a config naming this very
+ * directory in different casing compared unequal and a circular need went
+ * unrecognised. `realpathSync.native` asks the filesystem instead of the
+ * string: it returns the canonical casing, and resolves junctions and symlinks
+ * on the way — which matters here, because worktrees on this machine are
+ * junctions.
+ */
+function selfRepoId(declared, cwd) {
+    const here = canonicalDir((0, path_1.resolve)(cwd));
+    for (const d of declared) {
+        if (canonicalDir((0, path_1.resolve)(cwd, d.path)) === here)
+            return d.id;
+    }
+    return null;
+}
+//# sourceMappingURL=self-repo-id.js.map

package/dist/self-repo-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-repo-id.js","sourceRoot":"","sources":["../src/self-repo-id.ts"],"names":[],"mappings":";;AA2DA,gCAMC;AAjED,2BAAkC;AAClC,+BAA+B;AAE/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,SAAS,YAAY,CAAC,CAAS;IAC7B,IAAI,CAAC;QACH,OAAO,iBAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP;;;;;WAKG;QACH,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,UAAU,CAAC,QAAiD,EAAE,GAAW;IACvF,MAAM,IAAI,GAAG,YAAY,CAAC,IAAA,cAAO,EAAC,GAAG,CAAC,CAAC,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,YAAY,CAAC,IAAA,cAAO,EAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI;YAAE,OAAO,CAAC,CAAC,EAAE,CAAC;IAC/D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}