@abloh/core 1.0.2-staging.34894792218 → 1.0.2-staging.34908219256

package/dist/index.d.ts

@@ -7762,6 +7762,29 @@ type InitAbortLockfileCombination = "generated" | "not-generated";
  * confirmed the files, keeping the bytes first so the set lands whole or not at all. This family is
  * that put-back failing.
  */
+/**
+ * A FILE `abloh init` WROTE THAT THE PLAN IS MADE OF, AND THIS REPOSITORY IGNORES.
+ *
+ * `abloh.yml`, `.abloh/setup.sh` and abloh's own workflow are read out of a pull request's MERGE
+ * BASE, so a repository whose ignore rules keep one out of the commit has no setup at all - which
+ * `angular-ui/ui-router` met as a warning at init time and a refusal on its next run, naming a file
+ * init had just reported writing (round 5 v3, D3). A GENERATED SUPPORT FILE is the other half of
+ * the same reading and is deliberately not here: it stays on disk uncommitted and is named once.
+ */
+interface InitIgnoredContract {
+    kind: "init-ignored-contract";
+    /** the ignored file, repo-relative */
+    path: string;
+    /** any others in the same state, named so one edit can cover them */
+    others: readonly string[];
+    /** the single `!` line that undoes it, naming the outermost ignored ancestor */
+    unIgnore: string;
+    /** `<pattern> at <file>:<line>`, verbatim from git, or null where git did not say */
+    rule: string | null;
+    /** the ignore file to write the `!` line into, or null where git did not say */
+    ignoreFile: string | null;
+}
+type InitIgnoredContractCombination = "named" | "unnamed";
 interface InitRestore {
     kind: "init-restore";
     /** The file, repo-relative, or nothing where the restore succeeded. */
@@ -7999,7 +8022,7 @@ interface SetupStatement {
     statement: "no-job-to-ride" | "trial-complete";
 }
 type SetupStatementCombination = SetupStatement["statement"];
-type SetupFacts = SetupAnswer | SetupJobReading | SetupStepPlacementFacts | SetupStepWritten | SetupCiStepsRead | SetupRideOutcome | SetupPullRequestStep | SetupToolFailure | SetupCallerJob | SetupTrialReceipt | SetupTrialContract | SetupTrialPlan | SetupReceiptProblem | SetupRewrites | SetupReportSize | SetupPrivateRegistry | SetupUnsatisfiableCheck | SetupScriptRun | InitPin | InitValidationPrepare | InitValidationLedger | InitLocalTrial | InitCommit | InitWorkspaceDraft | InitDerivedCommand | InitAbortLockfile | InitRestore | InitAbortFiles | InitAbort | InitAnswer | ManifestPin | ImageReference | NodeRuntime | SetupStatement;
+type SetupFacts = SetupAnswer | SetupJobReading | SetupStepPlacementFacts | SetupStepWritten | SetupCiStepsRead | SetupRideOutcome | SetupPullRequestStep | SetupToolFailure | SetupCallerJob | SetupTrialReceipt | SetupTrialContract | SetupTrialPlan | SetupReceiptProblem | SetupRewrites | SetupReportSize | SetupPrivateRegistry | SetupUnsatisfiableCheck | SetupScriptRun | InitPin | InitValidationPrepare | InitValidationLedger | InitLocalTrial | InitCommit | InitWorkspaceDraft | InitDerivedCommand | InitAbortLockfile | InitIgnoredContract | InitRestore | InitAbortFiles | InitAbort | InitAnswer | ManifestPin | ImageReference | NodeRuntime | SetupStatement;
 
 /**
  * THE THREE STATES A MEASUREMENT MAY BE IN, AND THE TWO THINGS THE THIRD ONE MAY BECOME.
@@ -10584,6 +10607,19 @@ declare const MESSAGE_MAPPINGS: {
             };
         };
     };
+    "init-ignored-contract": {
+        select: (facts: InitIgnoredContract) => InitIgnoredContractCombination;
+        rows: {
+            named: (facts: InitIgnoredContract) => {
+                kind: "message";
+                refusal: Refusal;
+            };
+            unnamed: (facts: InitIgnoredContract) => {
+                kind: "message";
+                refusal: Refusal;
+            };
+        };
+    };
     "init-restore": {
         select: (facts: InitRestore) => InitRestoreCombination;
         rows: {
@@ -21004,6 +21040,28 @@ declare const REFUSAL_REGISTRY: {
      * OWNED BY THE MACHINE, because the write abloh is retrying is one it has already made once. What
      * the maintainer needs is the path, which is why the sentence carries it.
      */
+    readonly "init-contract-file-ignored": {
+        readonly factFamily: "init-ignored-contract";
+        readonly stage: "init";
+        readonly owner: "repository";
+        readonly privacy: "authored";
+        readonly destinations: readonly ("artifact" | "terminal" | "markdown" | "job-log" | "check" | "slack" | "web" | "setup-comment" | "playground")[];
+        readonly summary: (facts: {
+            path?: string;
+            others?: readonly string[];
+            rule?: string;
+            unIgnore?: string;
+            ignoreFile?: string;
+        }) => string;
+        readonly remedy: (facts: {
+            path?: string;
+            others?: readonly string[];
+            rule?: string;
+            unIgnore?: string;
+            ignoreFile?: string;
+        }) => RefusalRemedy;
+        readonly evidence: readonly EvidenceSlot[];
+    };
     readonly "init-restore-failed": {
         readonly factFamily: "init-restore";
         readonly stage: "init";

package/dist/index.js

@@ -13273,6 +13273,40 @@ var REFUSAL_REGISTRY = {
    * OWNED BY THE MACHINE, because the write abloh is retrying is one it has already made once. What
    * the maintainer needs is the path, which is why the sentence carries it.
    */
+  /*
+   * A CONTRACT FILE THIS REPOSITORY'S OWN IGNORE RULES KEEP OUT OF THE COMMIT.
+   *
+   * `abloh.yml`, `.abloh/setup.sh` and abloh's own workflow ARE the plan, and a run reads them out
+   * of a pull request's merge base - so a repository that cannot commit one has no setup, whatever
+   * else init did. `angular-ui/ui-router` (round 5 v3, D3) got a warning here and the refusal one
+   * run later, naming a file `abloh init` had just reported writing and telling them to run the
+   * command they had just run.
+   *
+   * A GENERATED SUPPORT FILE IS THE OTHER HALF AND IS NOT THIS. The lockfile is written for the
+   * install step to read, its value is that it is on disk, and the 2026-08-26 ruling deliberately
+   * leaves the ignore rule alone - so it stays uncommitted and the ending names it (census run 11,
+   * 2026-09-14). The two answers come off the file's KIND and never off its name.
+   *
+   * THE REMEDY IS GIT'S OWN ANSWER, not a sentence written beside the code: `check-ignore -v` named
+   * the pattern, the file and the line, and the `!` line points at the OUTERMOST ignored ancestor
+   * because git never descends into an excluded directory.
+   */
+  "init-contract-file-ignored": {
+    factFamily: "init-ignored-contract",
+    stage: "init",
+    owner: "repository",
+    privacy: "authored",
+    destinations: LOCAL_ONLY,
+    summary: (facts) => {
+      const also = (facts?.others ?? []).length === 0 ? "" : ` and ${quoted3([...facts?.others ?? []])}`;
+      const rule = facts?.rule === void 0 || facts.rule === "" ? "" : ` - your own ${facts.rule}`;
+      return `abloh cannot commit ${facts?.path ?? "the contract"}${also}, and abloh measures what your repository carries${rule}`;
+    },
+    remedy: (facts) => customerAction(
+      `Add \`${facts?.unIgnore ?? "!abloh.yml"}\` to ${facts?.ignoreFile ?? ".gitignore"}, then run abloh init again.`
+    ),
+    evidence: NO_EVIDENCE
+  },
   "init-restore-failed": {
     factFamily: "init-restore",
     stage: "init",
@@ -17671,6 +17705,31 @@ var SETUP_MAPPINGS = {
       }))
     }
   },
+  "init-ignored-contract": {
+    /* THE RULE IS THE ONE FACT THAT CAN BE ABSENT - git answers the path without naming a pattern
+       where an ignore file is unreadable - and the remedy is the same edit either way. */
+    select: (facts) => facts.rule === null ? "unnamed" : "named",
+    rows: {
+      named: (facts) => message(refuse("init-contract-file-ignored", {
+        facts: {
+          path: facts.path,
+          others: facts.others,
+          rule: facts.rule ?? "",
+          unIgnore: facts.unIgnore,
+          ignoreFile: facts.ignoreFile ?? ".gitignore"
+        }
+      })),
+      unnamed: (facts) => message(refuse("init-contract-file-ignored", {
+        facts: {
+          path: facts.path,
+          others: facts.others,
+          rule: "",
+          unIgnore: facts.unIgnore,
+          ignoreFile: facts.ignoreFile ?? ".gitignore"
+        }
+      }))
+    }
+  },
   "init-restore": {
     select: (facts) => facts.path === null ? "restored" : "failed",
     rows: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abloh/core",
-  "version": "1.0.2-staging.34894792218",
+  "version": "1.0.2-staging.34908219256",
   "description": "Abloh core: normalized results contract, diff scoping, policy, findings, scoring. \"name\" will publish under the @abloh scope.",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",