@behaghel/pi-domain-tree 0.4.0 → 0.4.1

package/README.md

@@ -168,6 +168,8 @@ Rigor scales with classification:
 - **Supporting** domains: warning when missing
 - **Generic** domains: only when the integration boundary changes
 
+The Pi spec-on-touch guard permits `write` and `edit` of `.md` files directly in the owning domain's specification directory, including a missing or invalid `README.md`. This allows specification creation and repair without disabling enforcement. The directory is the explicit `spec:` override or, otherwise, the first `code:` path. Markdown elsewhere and non-Markdown files in that directory are not exempt. Core and shared-kernel code changes remain blocked until the domain's `README.md` passes normative validation; repairing it unlocks code changes in the same session.
+
 ## License
 
 `domain-tree` is free software licensed under the [Mozilla Public License 2.0](LICENSE).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@behaghel/pi-domain-tree",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Domain-driven structure with explicit groups, strict manifests, normative domain and system corpora, and specification-wiki integrity.",
   "type": "module",
   "license": "MPL-2.0",

package/pi/extension.ts

@@ -384,6 +384,13 @@ For detailed reference, load the \`domain-navigator\` skill.
 			const resolved = await resolveDomainForFile(targetPath, domainRoot, domainsCache);
 			if (!resolved) return; // not in any domain
 
+			// Specs must be writable before they can satisfy the code-change gate.
+			// Exempt only sibling Markdown in this owner's canonical spec directory.
+			const entry = entryForResolution(domainsCache, resolved);
+			const specDir = entry ? specDirForEntry(domainRoot, entry) : null;
+			const absoluteTarget = resolve(domainRoot, targetPath);
+			if (specDir && absoluteTarget.endsWith(".md") && dirname(absoluteTarget) === resolve(specDir)) return;
+
 			// Check spec-on-touch for core domains
 			const domainType = resolved.type;
 			if (domainType === "core" || domainType === "shared-kernel") {
@@ -399,8 +406,9 @@ For detailed reference, load the \`domain-navigator\` skill.
 							reason:
 								`⚠️ **Domain boundary violation: ${domainLabel}** (type: **core**)\n\n` +
 								`This is a **core** domain — it is the competitive advantage of the project. ` +
-								`No spec exists for this domain yet. **Spec required before any code change.**\n\n` +
-								`Use \`/domain-tree:init\` to scaffold the domain tree, or run \`/domain-tree:check\` to see the current state.`,
+								`No valid spec exists for this domain yet. **Spec required before any code change.**\n\n` +
+								`Create or repair the domain's \`README.md\`; specification Markdown edits are allowed. ` +
+								`Run \`/domain-tree:check\` for validation diagnostics.`,
 						};
 					}
 
@@ -410,7 +418,8 @@ For detailed reference, load the \`domain-navigator\` skill.
 							reason:
 								`⚠️ **Domain boundary violation: ${domainLabel}** (type: **shared-kernel**)\n\n` +
 								`This is **shared kernel** — changes affect ALL consuming domains. ` +
-								`No spec exists yet. **Spec required and all consumers must be notified.**\n\n` +
+								`No valid spec exists yet. **Spec required and all consumers must be notified.**\n\n` +
+								`Create or repair the domain's \`README.md\`; specification Markdown edits are allowed. ` +
 								`Check the context map in \`domains.yaml\` for which domains depend on this.`,
 						};
 					}