@projitect/blueprint 0.0.0-stage → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kapil Easwar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/add-sections.d.ts

@@ -0,0 +1,87 @@
+import { Effect } from "effect";
+import { Prompt } from "effect/unstable/cli";
+import type { Errors } from "@projitect/core";
+/**
+ * The shape of the `"projitect"` field in a blueprint package's `package.json`. Defines how
+ * `pjt add <pkg>` should splice into the user's `.pjt.ts`.
+ */
+export interface ProjitectPackageMetadata {
+    /**
+     * `"blueprint"` for single-call packages (e.g. one default export). `"blueprint-set"` for
+     * packages that expose multiple sections (e.g. `gitignores.macOs()`, `gitignores.node()`).
+     */
+    readonly type: "blueprint" | "blueprint-set";
+    /** The import statement to splice into `// pjt:imports`, e.g. `import { foo } from "foo"`. */
+    readonly import: string;
+    /** For `type: "blueprint"` only — the call template, e.g. `myBlueprint()`. */
+    readonly call?: string;
+    /** For `type: "blueprint-set"` only — substitute `{section}` with each chosen name. */
+    readonly callTemplate?: string;
+    /** For `type: "blueprint-set"` only — the list of available section names. */
+    readonly sections?: readonly string[];
+}
+/**
+ * Strategy for picking which sections of a `blueprint-set` package to splice.
+ *
+ *   - `"all"` — silent default; pick every section the package declares. Used when the caller
+ *     wants the legacy "no --section means everything" behavior.
+ *   - `{ kind: "explicit", sections }` — caller already knows. `--section macOs,node` lands here.
+ *   - `{ kind: "ask", choose }` — interactive: defer to the supplied callback (typically
+ *     `chooseSectionsInteractive`). The callback runs only when the installed package's metadata
+ *     says `type: "blueprint-set"` and exposes sections.
+ *
+ * `R` parametrizes the callback's requirement channel so the caller can hand us an Effect
+ * that needs `Prompt.Environment` (FileSystem | Path | Terminal).
+ */
+export type SectionStrategy<R = never> = {
+    readonly _tag: "All";
+} | {
+    readonly _tag: "Explicit";
+    readonly sections: readonly string[];
+} | {
+    readonly _tag: "Ask";
+    readonly choose: (metadata: ProjitectPackageMetadata) => Effect.Effect<readonly string[], Errors.ProjitectError, R>;
+};
+/**
+ * What the user wants spliced from a package. Cancellation is its own case so it can never be
+ * mistaken for "all":
+ *
+ *   - `All` — every declared section.
+ *   - `Chosen` — exactly these sections (non-empty).
+ *   - `Nothing` — the user picked no sections or quit the prompt; the host must not write.
+ */
+export type SectionSelection = {
+    readonly _tag: "All";
+} | {
+    readonly _tag: "Chosen";
+    readonly sections: readonly string[];
+} | {
+    readonly _tag: "Nothing";
+};
+/** Resolve which sections the user wants, per `strategy`. */
+export declare const resolveSections: <R>(params: {
+    readonly metadata: ProjitectPackageMetadata;
+    readonly strategy: SectionStrategy<R>;
+}) => Effect.Effect<SectionSelection, Errors.ProjitectError, R>;
+/**
+ * Compute the import line and call lines to splice for the selection. A `Nothing` selection
+ * yields no call lines and no sections; hosts check `selection._tag` and skip the write.
+ */
+export declare const computeSplice: (params: {
+    readonly metadata: ProjitectPackageMetadata;
+    readonly selection: SectionSelection;
+}) => {
+    readonly importLine: string;
+    readonly callLines: readonly string[];
+    readonly sectionsAdded: readonly string[];
+};
+/**
+ * Interactive section picker for a `type: "blueprint-set"` package. Ctrl-C yields an empty
+ * selection rather than crashing; `resolveSections` maps an empty `Ask` result to
+ * `Nothing`, so quitting never splices anything.
+ *
+ * Returns an empty selection if no sections are declared (defensive default — shouldn't happen
+ * for well-formed metadata, but we don't want to crash on a malformed package).
+ */
+export declare const chooseSectionsInteractive: (metadata: ProjitectPackageMetadata) => Effect.Effect<readonly string[], never, Prompt.Environment>;
+//# sourceMappingURL=add-sections.d.ts.map

package/dist/add-sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-sections.d.ts","sourceRoot":"","sources":["../src/add-sections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAS,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAE7C;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,eAAe,CAAA;IAC5C,8FAA8F;IAC9F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,uFAAuF;IACvF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACtC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,KAAK,IACjC;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;CAAE,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACnE;IACE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,CACf,QAAQ,EAAE,wBAAwB,KAC/B,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,CAAA;CAChE,CAAA;AAEL;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;CAAE,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACjE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAA;AAKhC,6DAA6D;AAC7D,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,QAAQ;IACzC,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAA;IAC3C,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;CACtC,KAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,CAa3D,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ;IACpC,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAA;IAC3C,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAA;CACrC,KAAG;IACF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAA;CA0B1C,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,GACpC,UAAU,wBAAwB,KACjC,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,WAAW,CAS5D,CAAA"}

package/dist/add-sections.js

@@ -0,0 +1,60 @@
+import { Array, Effect, Match } from "effect";
+import { Prompt } from "effect/unstable/cli";
+const chosenOr = (sections, whenEmpty) => Array.isReadonlyArrayNonEmpty(sections) ? { _tag: "Chosen", sections } : whenEmpty;
+/** Resolve which sections the user wants, per `strategy`. */
+export const resolveSections = (params) => {
+    const { metadata, strategy } = params;
+    // Section strategy only matters for blueprint-sets. For `type: "blueprint"` the selection is
+    // ignored — `computeSplice` emits a single non-templated call line.
+    if (metadata.type === "blueprint") {
+        return Effect.succeed({ _tag: "All" });
+    }
+    return Match.valueTags(strategy, {
+        All: () => Effect.succeed({ _tag: "All" }),
+        Explicit: (explicit) => Effect.succeed(chosenOr(explicit.sections, { _tag: "All" })),
+        Ask: (ask) => Effect.map(ask.choose(metadata), (picked) => chosenOr(picked, { _tag: "Nothing" })),
+    });
+};
+/**
+ * Compute the import line and call lines to splice for the selection. A `Nothing` selection
+ * yields no call lines and no sections; hosts check `selection._tag` and skip the write.
+ */
+export const computeSplice = (params) => {
+    const { metadata, selection } = params;
+    if (metadata.type === "blueprint") {
+        const call = metadata.call ?? "/* TODO: replace with the blueprint call from the package's README */";
+        return {
+            importLine: metadata.import,
+            callLines: [`${call},`],
+            sectionsAdded: [],
+        };
+    }
+    // Blueprint-set
+    const allSections = metadata.sections ?? [];
+    const chosen = Match.value(selection).pipe(Match.tag("All", () => allSections), Match.tag("Chosen", (picked) => picked.sections.filter((s) => allSections.includes(s))), Match.tag("Nothing", () => []), Match.exhaustive);
+    const template = metadata.callTemplate ?? "{section}()";
+    return {
+        importLine: metadata.import,
+        callLines: chosen.map((s) => `${template.replace("{section}", s)},`),
+        sectionsAdded: chosen,
+    };
+};
+/**
+ * Interactive section picker for a `type: "blueprint-set"` package. Ctrl-C yields an empty
+ * selection rather than crashing; `resolveSections` maps an empty `Ask` result to
+ * `Nothing`, so quitting never splices anything.
+ *
+ * Returns an empty selection if no sections are declared (defensive default — shouldn't happen
+ * for well-formed metadata, but we don't want to crash on a malformed package).
+ */
+export const chooseSectionsInteractive = (metadata) => {
+    const sections = metadata.sections ?? [];
+    if (!Array.isReadonlyArrayNonEmpty(sections)) {
+        return Effect.succeed([]);
+    }
+    return Prompt.multiSelect({
+        message: "Pick sections to add (space to toggle, enter to confirm):",
+        choices: sections.map((name) => ({ title: name, value: name })),
+    }).pipe(Effect.catchTag("QuitError", () => Effect.succeed([])));
+};
+//# sourceMappingURL=add-sections.js.map

package/dist/add-sections.js.map

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

package/dist/constructors.d.ts

@@ -0,0 +1,103 @@
+import { Effect } from "effect";
+import type { Blueprint, Permission, Errors, BlueprintFileSystem } from "@projitect/core";
+import { ChangeSet } from "@projitect/core";
+/**
+ * Spec for a region-mode blueprint: replace or insert the marked section in a shared text file.
+ * Multiple blueprints can coexist in the same file as long as they use different `ownerId`s.
+ */
+export interface RegionFileSpec {
+    readonly id: string;
+    readonly version: string;
+    readonly description?: string;
+    readonly path: string;
+    readonly commentPrefix?: string;
+    /**
+     * Optional closing delimiter for prefix/suffix-pair comment styles. Set to `" -->"` for
+     * HTML/MDX. Leave undefined (default) for single-prefix styles like `#` and `//`.
+     */
+    readonly commentSuffix?: string;
+    readonly content: string;
+    readonly extraPermissions?: readonly Permission.Permission[];
+}
+/**
+ * Create a region-mode blueprint. The blueprint's `id` doubles as the region's `ownerId`.
+ * `commentPrefix` defaults to `#` (suitable for `.gitignore` / YAML / shell).
+ *
+ * For HTML / MDX / XML files, prefer the `markdownSection` helper — it sets the right
+ * prefix and suffix pair for you. For ignore-style files, prefer `ignoreSection` — same
+ * shape with a name that documents its intent.
+ */
+export declare const regionFile: (spec: RegionFileSpec) => Blueprint.Blueprint;
+/**
+ * Spec for a merge-mode blueprint: deep-merge a partial value into a structured (JSON) file.
+ * The `ownedKeys` list declares which dotted-path keys this blueprint claims — two blueprints
+ * claiming the same key is a `pjt.plan.conflict-merge` error.
+ */
+export interface JsonMergeSpec {
+    readonly id: string;
+    readonly version: string;
+    readonly description?: string;
+    readonly path: string;
+    readonly ownedKeys: readonly string[];
+    readonly value: unknown;
+    readonly extraPermissions?: readonly Permission.Permission[];
+}
+/**
+ * Create a merge-mode blueprint for a JSON file (typically `package.json` / `tsconfig.json`).
+ */
+export declare const jsonMerge: (spec: JsonMergeSpec) => Blueprint.Blueprint;
+/**
+ * Spec for an owned-mode blueprint: this blueprint owns the file's entire content. Any other
+ * blueprint touching the same path is a `pjt.plan.conflict-owned` error.
+ */
+export interface OwnFileSpec {
+    readonly id: string;
+    readonly version: string;
+    readonly description?: string;
+    readonly path: string;
+    readonly content: string;
+    /** Directory the file's owner manages; empty directories are pruned up to it on removal. */
+    readonly ownedDir?: string;
+    readonly extraPermissions?: readonly Permission.Permission[];
+}
+export declare const ownFile: (spec: OwnFileSpec) => Blueprint.Blueprint;
+/**
+ * Spec for a seed-mode blueprint: write the file at first build, never enforce it again. Useful
+ * for templates the project maintainer is expected to customize (e.g. README, initial `.pjt.ts`).
+ */
+export interface SeedFileSpec {
+    readonly id: string;
+    readonly version: string;
+    readonly description?: string;
+    readonly path: string;
+    readonly content: string;
+    readonly extraPermissions?: readonly Permission.Permission[];
+}
+export declare const seedFile: (spec: SeedFileSpec) => Blueprint.Blueprint;
+/**
+ * Spec for a post-apply command: after every file operation has succeeded, `pjt build` and
+ * `pjt remodel` run `fix` from the project root. `check` is the command that reports whether the
+ * fix is needed. The blueprint declares an `exec` permission for each of the two command lines.
+ */
+export interface ExecSpec {
+    readonly id: string;
+    readonly version: string;
+    readonly description?: string;
+    readonly check: string;
+    readonly fix: string;
+    readonly extraPermissions?: readonly Permission.Permission[];
+}
+export declare const exec: (spec: ExecSpec) => Blueprint.Blueprint;
+/**
+ * Build a blueprint from a user-supplied plan Effect. Use this when your plan needs to read
+ * existing files, branch on detected state, or compose multiple operations.
+ */
+export interface ComputedSpec {
+    readonly id: string;
+    readonly version: string;
+    readonly description?: string;
+    readonly permissions: readonly Permission.Permission[];
+    readonly plan: Effect.Effect<ChangeSet.ChangeSet, Errors.BlueprintError, BlueprintFileSystem>;
+}
+export declare const computed: (spec: ComputedSpec) => Blueprint.Blueprint;
+//# sourceMappingURL=constructors.d.ts.map

package/dist/constructors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constructors.d.ts","sourceRoot":"","sources":["../src/constructors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEtC,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACzF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,UAAU,CAAC,UAAU,EAAE,CAAA;CAC7D;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,cAAc,KAAG,SAAS,CAAC,SAoB1D,CAAA;AAEF;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,UAAU,CAAC,UAAU,EAAE,CAAA;CAC7D;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,aAAa,KAAG,SAAS,CAAC,SAmBxD,CAAA;AAEF;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,4FAA4F;IAC5F,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,UAAU,CAAC,UAAU,EAAE,CAAA;CAC7D;AAED,eAAO,MAAM,OAAO,GAAI,MAAM,WAAW,KAAG,SAAS,CAAC,SAepD,CAAA;AAEF;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,UAAU,CAAC,UAAU,EAAE,CAAA;CAC7D;AAED,eAAO,MAAM,QAAQ,GAAI,MAAM,YAAY,KAAG,SAAS,CAAC,SActD,CAAA;AAEF;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,UAAU,CAAC,UAAU,EAAE,CAAA;CAC7D;AAED,eAAO,MAAM,IAAI,GAAI,MAAM,QAAQ,KAAG,SAAS,CAAC,SAa9C,CAAA;AAEF;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,CAAC,UAAU,EAAE,CAAA;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAA;CAC9F;AAED,eAAO,MAAM,QAAQ,GAAI,MAAM,YAAY,KAAG,SAAS,CAAC,SAMtD,CAAA"}

package/dist/constructors.js

@@ -0,0 +1,88 @@
+import { Array, Effect } from "effect";
+import { StructX } from "@nunofyobiz/effect-extras";
+import { ChangeSet } from "@projitect/core";
+/**
+ * Create a region-mode blueprint. The blueprint's `id` doubles as the region's `ownerId`.
+ * `commentPrefix` defaults to `#` (suitable for `.gitignore` / YAML / shell).
+ *
+ * For HTML / MDX / XML files, prefer the `markdownSection` helper — it sets the right
+ * prefix and suffix pair for you. For ignore-style files, prefer `ignoreSection` — same
+ * shape with a name that documents its intent.
+ */
+export const regionFile = (spec) => ({
+    id: spec.id,
+    version: spec.version,
+    ...StructX.defined("description", spec.description),
+    permissions: [
+        { kind: "write", glob: spec.path },
+        { kind: "read", glob: spec.path },
+        ...(spec.extraPermissions ?? []),
+    ],
+    plan: Effect.succeed(ChangeSet.of(ChangeSet.RegionOp.make({
+        ownerId: spec.id,
+        path: spec.path,
+        commentPrefix: spec.commentPrefix ?? "#",
+        ...StructX.defined("commentSuffix", spec.commentSuffix),
+        content: spec.content,
+    }))),
+});
+/**
+ * Create a merge-mode blueprint for a JSON file (typically `package.json` / `tsconfig.json`).
+ */
+export const jsonMerge = (spec) => ({
+    id: spec.id,
+    version: spec.version,
+    ...StructX.defined("description", spec.description),
+    permissions: [
+        { kind: "write", glob: spec.path },
+        { kind: "read", glob: spec.path },
+        ...(spec.extraPermissions ?? []),
+    ],
+    plan: Effect.succeed(ChangeSet.of(ChangeSet.MergeOp.make({
+        ownerId: spec.id,
+        path: spec.path,
+        ownedKeys: spec.ownedKeys,
+        value: spec.value,
+    }))),
+});
+export const ownFile = (spec) => ({
+    id: spec.id,
+    version: spec.version,
+    ...StructX.defined("description", spec.description),
+    permissions: [{ kind: "write", glob: spec.path }, ...(spec.extraPermissions ?? [])],
+    plan: Effect.succeed(ChangeSet.of(ChangeSet.OwnedOp.make({
+        ownerId: spec.id,
+        path: spec.path,
+        content: spec.content,
+        ...StructX.defined("ownedDir", spec.ownedDir),
+    }))),
+});
+export const seedFile = (spec) => ({
+    id: spec.id,
+    version: spec.version,
+    ...StructX.defined("description", spec.description),
+    permissions: [{ kind: "write", glob: spec.path }, ...(spec.extraPermissions ?? [])],
+    plan: Effect.succeed(ChangeSet.of(ChangeSet.SeedOp.make({
+        ownerId: spec.id,
+        path: spec.path,
+        content: spec.content,
+    }))),
+});
+export const exec = (spec) => ({
+    id: spec.id,
+    version: spec.version,
+    ...StructX.defined("description", spec.description),
+    permissions: [
+        ...Array.dedupe([spec.fix, spec.check]).map((command) => ({ kind: "exec", command })),
+        ...(spec.extraPermissions ?? []),
+    ],
+    plan: Effect.succeed(ChangeSet.of(ChangeSet.ExecOp.make({ ownerId: spec.id, command: spec.fix, check: spec.check }))),
+});
+export const computed = (spec) => ({
+    id: spec.id,
+    version: spec.version,
+    ...StructX.defined("description", spec.description),
+    permissions: spec.permissions,
+    plan: spec.plan,
+});
+//# sourceMappingURL=constructors.js.map

package/dist/constructors.js.map

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

package/dist/detect.d.ts

@@ -0,0 +1,19 @@
+import { Effect } from "effect";
+import { BlueprintFileSystem } from "@projitect/core";
+import type { Errors } from "@projitect/core";
+export type PackageManager = "pnpm" | "npm" | "yarn" | "bun";
+/**
+ * Inspect lockfiles to determine which package manager the project uses. Reads (in order):
+ * `pnpm-lock.yaml`, `bun.lockb`, `yarn.lock`, `package-lock.json`. Falls back to `npm` if none
+ * are present.
+ *
+ * Returns the detected manager; the blueprint must declare `read:` permission on the relevant
+ * lockfile path globs (e.g. `pnpm-lock.yaml`).
+ */
+export declare const detectPackageManager: Effect.Effect<PackageManager, Errors.FsPermissionDenied | Errors.FsReadFailed, BlueprintFileSystem>;
+/**
+ * Read and parse `package.json` from the project root. Returns the parsed object as `unknown` —
+ * blueprints should decode it with a `Schema` if they need typed access to fields.
+ */
+export declare const readPackageJson: Effect.Effect<unknown, Errors.FsReadFailed | Errors.FsPermissionDenied, BlueprintFileSystem>;
+//# sourceMappingURL=detect.d.ts.map

package/dist/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAE7C,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAA;AAE5D;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,CAC9C,cAAc,EACd,MAAM,CAAC,kBAAkB,GAAG,MAAM,CAAC,YAAY,EAC/C,mBAAmB,CAgBnB,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,CACzC,OAAO,EACP,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,kBAAkB,EAC/C,mBAAmB,CAKnB,CAAA"}

package/dist/detect.js

@@ -0,0 +1,36 @@
+import { Effect } from "effect";
+import { BlueprintFileSystem } from "@projitect/core";
+/**
+ * Inspect lockfiles to determine which package manager the project uses. Reads (in order):
+ * `pnpm-lock.yaml`, `bun.lockb`, `yarn.lock`, `package-lock.json`. Falls back to `npm` if none
+ * are present.
+ *
+ * Returns the detected manager; the blueprint must declare `read:` permission on the relevant
+ * lockfile path globs (e.g. `pnpm-lock.yaml`).
+ */
+export const detectPackageManager = Effect.gen(function* () {
+    const fs = yield* BlueprintFileSystem;
+    if (yield* fs.exists("pnpm-lock.yaml")) {
+        return "pnpm";
+    }
+    if (yield* fs.exists("bun.lockb")) {
+        return "bun";
+    }
+    if (yield* fs.exists("yarn.lock")) {
+        return "yarn";
+    }
+    if (yield* fs.exists("package-lock.json")) {
+        return "npm";
+    }
+    return "npm";
+});
+/**
+ * Read and parse `package.json` from the project root. Returns the parsed object as `unknown` —
+ * blueprints should decode it with a `Schema` if they need typed access to fields.
+ */
+export const readPackageJson = Effect.gen(function* () {
+    const fs = yield* BlueprintFileSystem;
+    const raw = yield* fs.readFile("package.json");
+    return JSON.parse(raw);
+});
+//# sourceMappingURL=detect.js.map

package/dist/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAKrD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAI7B,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IACtB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,mBAAmB,CAAA;IACrC,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACvC,OAAO,MAAe,CAAA;IACxB,CAAC;IACD,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QAClC,OAAO,KAAc,CAAA;IACvB,CAAC;IACD,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QAClC,OAAO,MAAe,CAAA;IACxB,CAAC;IACD,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC1C,OAAO,KAAc,CAAA;IACvB,CAAC;IACD,OAAO,KAAc,CAAA;AACvB,CAAC,CAAC,CAAA;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAIxB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IACtB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,mBAAmB,CAAA;IACrC,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAA;IAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAA;AACnC,CAAC,CAAC,CAAA"}

package/dist/directory.d.ts

@@ -0,0 +1,17 @@
+import type { Blueprint } from "@projitect/core";
+/**
+ * Scope children to a subdirectory. Inside a `directory(name, [...])` group, every child
+ * blueprint's `path` is reinterpreted relative to `name/`, and write permissions outside the
+ * subtree are stripped from the children's declared `Permission`s.
+ *
+ * Implementation note: `directory` returns a `DirectoryBlueprint` — a tagged variant that the
+ * planner unpacks. Authors should treat the return value as opaque.
+ */
+export interface DirectoryBlueprint {
+    readonly _tag: "Directory";
+    readonly name: string;
+    readonly children: readonly (Blueprint.Blueprint | DirectoryBlueprint)[];
+}
+export declare const directory: (name: string, children: readonly (Blueprint.Blueprint | DirectoryBlueprint)[]) => DirectoryBlueprint;
+export declare const isDirectoryBlueprint: (v: Blueprint.Blueprint | DirectoryBlueprint) => v is DirectoryBlueprint;
+//# sourceMappingURL=directory.d.ts.map

package/dist/directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.d.ts","sourceRoot":"","sources":["../src/directory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,SAAS,CAAC,SAAS,GAAG,kBAAkB,CAAC,EAAE,CAAA;CACzE;AAED,eAAO,MAAM,SAAS,GACpB,MAAM,MAAM,EACZ,UAAU,SAAS,CAAC,SAAS,CAAC,SAAS,GAAG,kBAAkB,CAAC,EAAE,KAC9D,kBAID,CAAA;AAEF,eAAO,MAAM,oBAAoB,GAC/B,GAAG,SAAS,CAAC,SAAS,GAAG,kBAAkB,KAE1C,CAAC,IAAI,kBAAsD,CAAA"}

package/dist/directory.js

@@ -0,0 +1,8 @@
+import { Predicate } from "effect";
+export const directory = (name, children) => ({
+    _tag: "Directory",
+    name,
+    children,
+});
+export const isDirectoryBlueprint = (v) => Predicate.hasProperty(v, "_tag");
+//# sourceMappingURL=directory.js.map

package/dist/directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.js","sourceRoot":"","sources":["../src/directory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAiBlC,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,IAAY,EACZ,QAA+D,EAC3C,EAAE,CAAC,CAAC;IACxB,IAAI,EAAE,WAAW;IACjB,IAAI;IACJ,QAAQ;CACT,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,CAA2C,EAElB,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @projitect/blueprint
+ *
+ * Authoring SDK for blueprint packages. Blueprint authors compose these primitives — the
+ * `BlueprintFileSystem` service for FS access, the four ownership-mode constructors
+ * (`regionFile` / `jsonMerge` / `ownFile` / `seedFile`), the post-apply `exec` constructor, the section helpers
+ * (`markdownSection`, `ignoreSection`), the `directory` scope transform, and detectors for
+ * common project introspection.
+ *
+ * Authors use Effect's own control-flow combinators (`Effect.gen`, `Effect.all`, `Effect.if`,
+ * `Effect.when`, `Effect.unless`, `Effect.forEach`) for sequencing and conditionals — we do
+ * not ship duplicates.
+ */
+export * from "./constructors.js";
+export * from "./sections.js";
+export * from "./directory.js";
+export * from "./detect.js";
+export * from "./splice.js";
+export * from "./add-sections.js";
+export { BlueprintFileSystem } from "@projitect/core";
+export { Blueprint, ChangeSet, Permission, Errors } from "@projitect/core";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -0,0 +1,22 @@
+/**
+ * @projitect/blueprint
+ *
+ * Authoring SDK for blueprint packages. Blueprint authors compose these primitives — the
+ * `BlueprintFileSystem` service for FS access, the four ownership-mode constructors
+ * (`regionFile` / `jsonMerge` / `ownFile` / `seedFile`), the post-apply `exec` constructor, the section helpers
+ * (`markdownSection`, `ignoreSection`), the `directory` scope transform, and detectors for
+ * common project introspection.
+ *
+ * Authors use Effect's own control-flow combinators (`Effect.gen`, `Effect.all`, `Effect.if`,
+ * `Effect.when`, `Effect.unless`, `Effect.forEach`) for sequencing and conditionals — we do
+ * not ship duplicates.
+ */
+export * from "./constructors.js";
+export * from "./sections.js";
+export * from "./directory.js";
+export * from "./detect.js";
+export * from "./splice.js";
+export * from "./add-sections.js";
+export { BlueprintFileSystem } from "@projitect/core";
+export { Blueprint, ChangeSet, Permission, Errors } from "@projitect/core";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/sections.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Section helpers — thin wrappers around `regionFile` that bake in the right comment
+ * delimiters for two common file shapes:
+ *
+ *  - **`markdownSection`** for HTML/MDX/XML files where comments need a closing `-->`.
+ *    The fenced region renders invisible in markdown output — readers never see the markers.
+ *    Useful for README.md, AGENTS.md, CONTRIBUTING.md, generated MDX docs, etc.
+ *
+ *  - **`ignoreSection`** for `#`-comment "ignore"-style files. Same shape as the gitignore
+ *    convention; the helper exists because the name documents intent better than a bare
+ *    `regionFile({ commentPrefix: "#" })` does, and the surface guides authors toward the
+ *    right primitive when they're scaffolding a `.eslintignore` / `.prettierignore` /
+ *    `.dockerignore` / `.npmignore` blueprint.
+ *
+ * Both helpers re-emit the underlying `RegionFileSpec`-shaped result of `regionFile`, so
+ * everything that works for `regionFile` works for these (extra permissions, descriptions,
+ * etc.). They aren't shipped as separate npm packages because there's no opinionated content
+ * to bundle — the blueprint author always provides their own.
+ */
+import type { Blueprint, Permission } from "@projitect/core";
+export interface SectionSpec {
+    readonly id: string;
+    readonly version: string;
+    readonly description?: string;
+    readonly path: string;
+    readonly content: string;
+    readonly extraPermissions?: readonly Permission.Permission[];
+}
+/**
+ * Region-mode blueprint for HTML / MDX / XML files. The fence is rendered as two HTML
+ * comments on their own lines:
+ *
+ *     <!-- pjt:<owner-id> start -->
+ *     <body>
+ *     <!-- pjt:<owner-id> end -->
+ *
+ * The markers don't render in HTML output (they're comments), so readers of the published
+ * file never see them. `pjt inspect` flags hand-edits between the markers; lines outside
+ * the fence belong to the user.
+ *
+ * @example
+ * ```ts
+ * markdownSection({
+ *   id: "my-org:readme:badges",
+ *   version: "1.0.0",
+ *   path: "README.md",
+ *   content: "![ci](https://example.com/badge.svg)\n",
+ * })
+ * ```
+ */
+export declare const markdownSection: (spec: SectionSpec) => Blueprint.Blueprint;
+/**
+ * Region-mode blueprint for `#`-comment ignore-style files: `.gitignore`, `.eslintignore`,
+ * `.prettierignore`, `.dockerignore`, `.npmignore`, etc. The fence is two `#`-prefixed lines
+ * on either side of the section content:
+ *
+ *     # pjt:<owner-id> start
+ *     <body>
+ *     # pjt:<owner-id> end
+ *
+ * Equivalent to `regionFile({ commentPrefix: "#", ... })`, but the name documents the
+ * intent and makes the right primitive easy to find.
+ *
+ * @example
+ * ```ts
+ * ignoreSection({
+ *   id: "my-org:eslintignore:generated",
+ *   version: "1.0.0",
+ *   path: ".eslintignore",
+ *   content: "dist/\nbuild/\ncoverage/\n",
+ * })
+ * ```
+ */
+export declare const ignoreSection: (spec: SectionSpec) => Blueprint.Blueprint;
+//# sourceMappingURL=sections.d.ts.map

package/dist/sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections.d.ts","sourceRoot":"","sources":["../src/sections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAG5D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,UAAU,CAAC,UAAU,EAAE,CAAA;CAC7D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,WAAW,KAAG,SAAS,CAAC,SAU1D,CAAA;AAEJ;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,WAAW,KAAG,SAAS,CAAC,SASxD,CAAA"}