@bevel-software/platform-core-backend 0.15.1 → 0.19.0

package/dist/modules/workspace/startup/steps/seed-tree.js

@@ -1,8 +1,11 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
-import { renderKbLayoutPlaceholders } from '@bevel-software/platform-shared';
+import { AGENTS_FILE, LEGACY_AGENTS_FILE, renderKbLayoutPlaceholders, } from '@bevel-software/platform-shared';
 import { renderRolesYaml } from '../../../access-model/render-roles-yaml.js';
-import { TEMPLATE_SOURCE_FALLBACKS, reservedRootDirs, templateSource } from './template-files.step.js';
+import { reservedRootDirs } from './template-files.step.js';
+import { TEMPLATE_SOURCE_FALLBACKS, TemplateSource } from './template-source.js';
+import { assertNotGitInternals, hasGitInternalsSegment } from '../../../../shared/git-internals.js';
+import { GitInternalsError } from '../../../../shared/domain-errors.js';
 /**
  * The empty-remote seed builder the runner takes as `buildSeedTree`: the full
  * template tree, every reserved root, and a generated roles.yaml. DIRECT fs
@@ -17,21 +20,52 @@ import { TEMPLATE_SOURCE_FALLBACKS, reservedRootDirs, templateSource } from './t
  * `extraRootDirs` is validated eagerly, at composition time: a bad value
  * should fail at boot beside the rest of the wiring, not mid-seed of
  * somebody's knowledge base.
+ *
+ * A factory over {@link KbSeedTree} rather than the class itself, because the
+ * runner's port is a function: it asks for a directory to be filled and gets
+ * back what was generated, and knows nothing of templates or disks.
  */
-export function buildSeedTree(templateDir, extraRootDirs, seedAdminEmails) {
-    const requiredDirs = reservedRootDirs(extraRootDirs);
-    return async (dir) => {
+export function buildSeedTree(disk, templateDir, extraRootDirs, seedAdminEmails) {
+    // Validated eagerly; resolved per seed. The core roots are live bindings the
+    // setup-completing save may configure after this builder was composed.
+    reservedRootDirs(extraRootDirs);
+    const seeder = new KbSeedTree(disk, new TemplateSource(disk, templateDir), extraRootDirs, seedAdminEmails);
+    return (dir) => seeder.seed(dir);
+}
+/**
+ * Seeding a fresh knowledge base into an empty directory.
+ *
+ * The walker and the template are held, not passed: every step of a seed —
+ * the tree copy, one file's copy, the link check — reads the SAME template
+ * through the SAME disk, and threading both through each helper's signature
+ * only created places where a future caller could pass a different one.
+ */
+class KbSeedTree {
+    disk;
+    templates;
+    extraRootDirs;
+    seedAdminEmails;
+    constructor(disk, templates, extraRootDirs, seedAdminEmails) {
+        this.disk = disk;
+        this.templates = templates;
+        this.extraRootDirs = extraRootDirs;
+        this.seedAdminEmails = seedAdminEmails;
+    }
+    /** Fill `dir` with a complete knowledge base; resolve to what was GENERATED. */
+    async seed(dir) {
         const generated = [];
-        await copyTemplateTree(templateDir, dir);
+        await this.copyTemplateTree(dir);
         // Reserved roots the template does not carry. Without this the seed commit
         // would hold only what the template has, and a distribution's own roots
         // would appear a step later, when the first startup phase tops them up —
         // the same folders, arriving in a second commit for no reason. Keyed on
         // the DIRECTORY's existence: a template already carrying content under a
         // root never gets a pointless placeholder beside it.
-        for (const rootDir of requiredDirs) {
+        // Resolved NOW, not when the builder was composed: a seed that runs on the
+        // save completing first-run setup must lay down the names that save applied.
+        for (const rootDir of reservedRootDirs(this.extraRootDirs)) {
             const abs = path.join(dir, rootDir);
-            const found = await lstatOrNull(abs);
+            const found = await this.disk.lstatOrNull(abs);
             if (found) {
                 if (found.isDirectory())
                     continue;
@@ -45,70 +79,113 @@ export function buildSeedTree(templateDir, extraRootDirs, seedAdminEmails) {
         }
         // Generated, never templated — see roles-yaml.step.ts. The runner refuses
         // to seed an empty remote with no admins, so the list is non-empty here.
-        await fs.writeFile(path.join(dir, 'roles.yaml'), renderRolesYaml(seedAdminEmails), 'utf8');
+        await fs.writeFile(path.join(dir, 'roles.yaml'), renderRolesYaml(this.seedAdminEmails), 'utf8');
         generated.push('roles.yaml');
         return generated;
-    };
-}
-/** Copy the entire template tree into `dest` (roles.yaml isn't in it — it's generated). */
-async function copyTemplateTree(templateDir, dest) {
-    const packableToReal = new Map(Object.entries(TEMPLATE_SOURCE_FALLBACKS).map(([real, packable]) => [packable, real]));
-    const walk = async (relDir) => {
-        const abs = path.join(templateDir, relDir);
-        const entries = await fs.readdir(abs, { withFileTypes: true });
-        for (const entry of entries) {
-            // Never copy a git dir: a KB_TEMPLATE_DIR that is itself a working tree
-            // (this repo in a Docker build) must not seed its history into the KB.
-            if (entry.name === '.git')
-                continue;
-            const rel = relDir ? path.join(relDir, entry.name) : entry.name;
-            if (entry.isDirectory()) {
-                await walk(rel);
-                continue;
-            }
-            // A packable spelling at the template root seeds under its REAL name
-            // — unless the template also carries the literal file (a
-            // distribution's own template), which wins and is copied by its own
-            // walk entry; copying the packable twin too would clobber it.
-            const realName = relDir === '' ? packableToReal.get(entry.name) : undefined;
-            if (realName !== undefined) {
-                if (!(await exists(path.join(templateDir, realName)))) {
-                    await copyTemplateFile(templateDir, realName, dest);
-                }
-                continue;
+    }
+    /** Copy the entire template tree into `dest` (roles.yaml isn't in it — it's generated). */
+    async copyTemplateTree(dest) {
+        // A template that is not there is a broken build, not an empty seed.
+        const templateStat = await this.templates.rootStat();
+        if (templateStat === null || !templateStat.isDirectory()) {
+            throw new Error(`KB template "${this.templates.root}" is not a directory.`);
+        }
+        // Never copy a git dir: a KB_TEMPLATE_DIR that is itself a working tree
+        // (this repo in a Docker build) must not seed its history into the KB.
+        // Every other entry is template content, dot-files included.
+        await this.disk.walk(this.templates.root, { skip: (e) => hasGitInternalsSegment(e.name), unreadable: 'throw' }, [
+            {
+                onFile: (relDir, name) => this.seedFile(relDir, name, dest),
+                onOther: async (relDir, entry) => {
+                    // A template may LINK to a file (a distribution's checkout, a Docker
+                    // build's copy): its content is template content, read through the
+                    // link and seeded under the link's own name like any file. Anything
+                    // else — a link to a folder or to nothing, a socket — is a broken
+                    // template, and the error says what was found.
+                    const rel = relDir ? path.join(relDir, entry.name) : entry.name;
+                    // A link whose target is inside a git folder is not template
+                    // content, whatever it is named: seeding it would copy a working
+                    // tree's `.git/config` into the KB as an ordinary file. The name
+                    // check above cannot see this — only the resolved target can.
+                    if (await linksIntoGitInternals(this.templates.root, rel))
+                        return;
+                    const target = await this.templates.statOf(rel);
+                    if (target === null || !target.isFile()) {
+                        const what = target === null ? 'nothing' : target.isDirectory() ? 'a directory' : 'a special file';
+                        throw new Error(`KB template entry "${rel}" ${entry.isSymbolicLink() ? `links to ${what}` : `is ${what}`} — a template holds regular files, or links to them.`);
+                    }
+                    await this.seedFile(relDir, entry.name, dest);
+                },
+            },
+        ]);
+    }
+    /** Seed one template file, by the name the walk saw it under. */
+    async seedFile(relDir, name, dest) {
+        // A packable spelling at the template root seeds under its REAL name
+        // — unless the template also carries the literal file (a
+        // distribution's own template), which wins and is copied by its own
+        // walk entry; copying the packable twin too would clobber it.
+        const realName = relDir === '' ? PACKABLE_TO_REAL.get(name) : undefined;
+        if (realName !== undefined) {
+            if (!(await this.templates.carries(realName))) {
+                await this.copyTemplateFile(realName, dest);
             }
-            await copyTemplateFile(templateDir, rel, dest);
+            return;
         }
-    };
-    await walk('');
-}
-/**
- * Copy one template file (by repo-relative path) into `dest`, creating
- * parents. Text files are RENDERED — the managed guide and the ignore file
- * name the three root folders, which a deployment may have renamed — and a
- * file without placeholders comes out byte-identical to its source.
- *
- * "Text" is decided by the BYTES, not the name: strict UTF-8 with no NUL.
- * A name-based rule mistook a hidden binary for text and re-encoded it;
- * anything that does not decode is copied byte for byte. Either way the
- * source's mode survives — a template script keeps its executable bit.
- */
-async function copyTemplateFile(templateDir, relPath, dest) {
-    const from = await templateSource(templateDir, relPath);
-    const to = path.join(dest, relPath);
-    await fs.mkdir(path.dirname(to), { recursive: true });
-    // A binary is spotted from its first bytes (a NUL turns up early in any
-    // real one) and streamed across without ever being read whole; only what
-    // may be text is read in full, and the full decode is still the judge.
-    const text = (await headHasNul(from)) ? null : asText(await fs.readFile(from));
-    if (text === null) {
-        await fs.copyFile(from, to);
+        // The agent guide ships under one name and lands under this deployment's.
+        // Done HERE rather than left to the top-up step, which would otherwise
+        // write the guide under its configured name and then delete the
+        // `AGENTS.md` this seed had just laid down — two commits saying opposite
+        // things about a knowledge base nobody had used yet.
+        if (relDir === '' && name === LEGACY_AGENTS_FILE) {
+            await this.copyTemplateFile(name, dest, AGENTS_FILE);
+            return;
+        }
+        // TWO template entries, ONE destination. A custom template that happens to
+        // carry a root file under the name THIS deployment gave its guide
+        // (`HEXIS.md` in the template, `HEXIS.md` in the setting) would be copied
+        // over the guide the branch above just wrote, or under it, depending on
+        // which order the walk happened to reach them in — and an empty deployment
+        // would be seeded with whichever won. The MANAGED guide wins, always: it
+        // is the file the platform owns, refreshes from the packaged template on
+        // every start and tells every agent to read. The twin is skipped, on the
+        // same reasoning as the packable spelling above.
+        if (relDir === '' && name === AGENTS_FILE && (await this.templates.carries(LEGACY_AGENTS_FILE))) {
+            return;
+        }
+        await this.copyTemplateFile(relDir ? path.join(relDir, name) : name, dest);
     }
-    else {
-        await fs.writeFile(to, renderKbLayoutPlaceholders(text), 'utf8');
+    /**
+     * Copy one template file (by repo-relative path) into `dest`, creating
+     * parents. `destRel` is the name it lands under when that differs from the
+     * template's — true of the agent guide and nothing else. Text files are RENDERED — the managed guide and the ignore file
+     * name the three root folders, which a deployment may have renamed — and a
+     * file without placeholders comes out byte-identical to its source.
+     *
+     * "Text" is decided by the BYTES, not the name: strict UTF-8 with no NUL.
+     * A name-based rule mistook a hidden binary for text and re-encoded it;
+     * anything that does not decode is copied byte for byte. Either way the
+     * source's mode survives — a template script keeps its executable bit.
+     */
+    async copyTemplateFile(relPath, dest, destRel = relPath) {
+        const from = await this.templates.pathOf(relPath);
+        const to = path.join(dest, destRel);
+        await fs.mkdir(path.dirname(to), { recursive: true });
+        // A binary is spotted from its first bytes (a NUL turns up early in any
+        // real one) and streamed across without ever being read whole; only what
+        // may be text is read in full, and the full decode is still the judge.
+        const text = (await headHasNul(from)) ? null : asText(await fs.readFile(from));
+        if (text === null) {
+            await fs.copyFile(from, to);
+        }
+        else {
+            await fs.writeFile(to, renderKbLayoutPlaceholders(text), 'utf8');
+        }
+        await fs.chmod(to, (await fs.stat(from)).mode & 0o777);
     }
-    await fs.chmod(to, (await fs.stat(from)).mode & 0o777);
 }
+/** The packable spelling a template may carry → the name it seeds under. */
+const PACKABLE_TO_REAL = new Map([...TEMPLATE_SOURCE_FALLBACKS].map(([real, packable]) => [packable, real]));
 /** Whether the first 8 KiB carry a NUL byte — the cheap half of "is this text". */
 async function headHasNul(file) {
     const handle = await fs.open(file, 'r');
@@ -132,22 +209,21 @@ function asText(bytes) {
         return null;
     }
 }
-async function exists(p) {
+/**
+ * Whether `rel` under `templateRoot` resolves inside a git folder — the
+ * template entry is a link, and following it would read the repository's own
+ * git data. Judged on the resolved path, so a link out of the template into
+ * some other checkout's `.git` counts too.
+ */
+async function linksIntoGitInternals(templateRoot, rel) {
     try {
-        await fs.access(p);
-        return true;
-    }
-    catch {
+        await assertNotGitInternals(templateRoot, rel);
         return false;
     }
-}
-/** `lstat` without the throw — null when nothing is at `p`. */
-async function lstatOrNull(p) {
-    try {
-        return await fs.lstat(p);
-    }
-    catch {
-        return null;
+    catch (err) {
+        if (err instanceof GitInternalsError)
+            return true;
+        throw err;
     }
 }
 //# sourceMappingURL=seed-tree.js.map

package/dist/modules/workspace/startup/steps/seed-tree.js.map

@@ -1 +1 @@
-{"version":3,"file":"seed-tree.js","sourceRoot":"","sources":["../../../../../src/modules/workspace/startup/steps/seed-tree.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"seed-tree.js","sourceRoot":"","sources":["../../../../../src/modules/workspace/startup/steps/seed-tree.ts"],"names":[],"mappings":"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"}

package/dist/modules/workspace/startup/steps/template-files.step.d.ts

@@ -1,3 +1,4 @@
+import { type IFsProbe } from '../../../../shared/fs.contract.js';
 import type { OnServerStart, ServerStartContext, StepResult } from '../on-server-start.js';
 /**
  * The **required scaffolding** — the minimum an operational KB needs. Any of
@@ -5,7 +6,7 @@ import type { OnServerStart, ServerStartContext, StepResult } from '../on-server
  * sample ontology is NOT (it only seeds a fully-empty repo, see seed-tree.ts).
  *
  * Two kinds:
- *  - {@link REQUIRED_FILES}: repo-root files added when the file is missing.
+ *  - {@link requiredFiles}: repo-root files added when the file is missing.
  *  - Reserved root dirs (core's two plus a distribution's `extraRootDirs`):
  *    when a dir is entirely absent it's created by adding its `<dir>/.gitkeep`.
  *    Keyed on the *directory's* existence, not the `.gitkeep` file — so a
@@ -16,22 +17,17 @@ import type { OnServerStart, ServerStartContext, StepResult } from '../on-server
  * generated from `ADMIN_EMAIL` (see roles-yaml.step.ts), so a repo can't be
  * seeded with a stale hard-coded Admin list.
  */
-export declare const REQUIRED_FILES: readonly string[];
+export declare function requiredFiles(): readonly string[];
+/** Whether `text` is a copy of the platform's managed guide, of any vintage. */
+export declare function isManagedGuide(text: string): boolean;
 /**
  * Repo-root files the startup phase GENERATES rather than copies — today just
  * `roles.yaml`, rendered from `ADMIN_EMAIL` (see roles-yaml.step.ts and
  * seed-tree.ts). Reserved-root validation must treat these exactly like
- * {@link REQUIRED_FILES}: a root claiming a generated name is the same silent
+ * {@link requiredFiles}: a root claiming a generated name is the same silent
  * typo with the same silent outcome.
  */
 export declare const GENERATED_FILES: readonly string[];
-/**
- * Destination name → the packable spelling the template may carry instead.
- * npm strips every file named `.gitignore` from a published tarball, so the
- * packaged template cannot ship one under its real name (see
- * {@link templateSource}).
- */
-export declare const TEMPLATE_SOURCE_FALLBACKS: Readonly<Record<string, string>>;
 /**
  * Core's guaranteed roots plus a distribution's extras, validated once at
  * composition time: every entry is joined onto the repo root and onto
@@ -42,20 +38,11 @@ export declare const TEMPLATE_SOURCE_FALLBACKS: Readonly<Record<string, string>>
  * paths can never disagree about what a deployment guarantees.
  */
 export declare function reservedRootDirs(extraRootDirs: readonly string[]): readonly string[];
-/**
- * Where `relPath`'s template content actually lives. npm refuses to pack
- * files named `.gitignore` — every such file is silently stripped from the
- * published tarball — so the packaged template ships the KB's gitignore
- * under a packable name and the seeder writes it to its real one. A
- * template carrying the literal file (a distribution's own
- * KB_TEMPLATE_DIR, or this repo's tree in a Docker build) wins outright:
- * the mapping is a fallback, never a rename.
- */
-export declare function templateSource(templateDir: string, relPath: string): Promise<string>;
 /**
  * The template top-up as an {@link OnServerStart} step: add any missing base
- * scaffolding to every PROTECTED branch, and keep the managed AGENTS.md
- * current. Drafts are deliberately out of scope — whatever the protected
+ * scaffolding to every PROTECTED branch, and keep the managed agent guide
+ * current — under whatever this deployment calls it, and taking its own
+ * stale `AGENTS.md` with it when that name was handed back to the customer. Drafts are deliberately out of scope — whatever the protected
  * branches gain, drafts fork from; a scaffolding addition on a draft would
  * surface as noise in its change request's diff. (Unlike the Groups→Plugins
  * rename, a missing file diffs as one file, not the whole tree — so the
@@ -68,8 +55,10 @@ export declare function templateSource(templateDir: string, relPath: string): Pr
  * contract for states a human must look at.
  */
 export declare class TemplateFilesStep implements OnServerStart {
+    private readonly disk;
+    private readonly extraRootDirs;
+    private readonly agentsFileLink;
     readonly name = "template-files";
-    private readonly requiredDirs;
     /**
      * @param extraRootDirs Additional root folders this distribution reserves,
      *                      on top of core's two. Their `.gitkeep` is written
@@ -77,9 +66,39 @@ export declare class TemplateFilesStep implements OnServerStart {
      *                      claim a root without also shipping a template entry
      *                      for it.
      */
-    constructor(extraRootDirs?: readonly string[]);
+    /**
+     * @param agentsFileLink Whether to keep the platform's pointer sentence in a
+     *                       customer-owned root `AGENTS.md` — a GETTER, because
+     *                       the setting behind it may be saved by the very
+     *                       first-run save that then runs this phase.
+     */
+    constructor(disk: IFsProbe, extraRootDirs?: readonly string[], agentsFileLink?: () => boolean);
     run(ctx: ServerStartContext): Promise<StepResult>;
     private topUp;
+    /**
+     * The root `AGENTS.md` on a deployment whose guide is called something else:
+     * removed when the platform can PROVE it wrote it, otherwise left alone —
+     * and, while the admin keeps the link setting on, given the one sentence
+     * that points at the guide beside it.
+     *
+     * Removal is gated on the managed header and nothing else. An admin who
+     * renames the guide on a knowledge base the platform seeded would otherwise
+     * be left with stale platform content sitting under the very name they
+     * wanted for their own file; an admin who renames it on a repository whose
+     * `AGENTS.md` is their own must find that file byte-for-byte untouched. The
+     * header is the one fact that tells the two apart, so it is the one thing
+     * asked.
+     *
+     * The pointer is bounded by three conditions, all of them the customer's to
+     * control: the admin keeps the setting on, the file exists (one is NEVER
+     * created for this), and the guide's name appears nowhere in the text. That
+     * last one is a plain content search on purpose — a mention in the
+     * customer's own words, a link, a heading, all count, and the platform stays
+     * out of a file it does not own.
+     *
+     * Returns the paths changed, for the note.
+     */
+    private reconcileLegacyGuide;
     /**
      * Which reserved roots are absent — and which are SQUATTED. `lstat`, not
      * `exists`: `fs.access` answers "is there something here?", which is true of
@@ -99,5 +118,58 @@ export declare class TemplateFilesStep implements OnServerStart {
      * distribution could not reserve one without forking the packaged template.
      */
     private ensureRequiredDirs;
+    /**
+     * Reconcile the platform's OWN rules in `.bevelignore`: every `respell` pair
+     * rewritten in place, every `add` pattern guaranteed present as a line, every
+     * `drop` pattern taken out. Returns the paths changed, for the note.
+     *
+     * Never rewrites the rest. The file is the operator's, and every rule already
+     * in it is theirs to keep: adding puts one line under a comment saying where
+     * it came from, and dropping removes exactly the line (and the comment) an
+     * earlier release put there — never a line the operator wrote. Absent file is
+     * a no-op — it means the template's copy (declared in the same step, and
+     * reconciled the same way at declaration) arrives with the right rules in it.
+     *
+     * Matched line-wise rather than by substring: a rule for `Plugins/AGENTS.md`
+     * is not a rule for the root `AGENTS.md`, and treating it as one would leave
+     * the mismatch this exists to close.
+     */
+    private reconcileIgnoreRules;
 }
+/**
+ * `text` without EVERY line that is exactly `pattern`, whoever wrote it, and
+ * without a platform comment sitting directly above one. The other drop keeps
+ * an operator's identical line; this one does not, and the difference is
+ * deliberate: the plugins-root rule was in the template from the first seed
+ * with no comment to know it by, so provenance cannot decide it — and the
+ * Skills & Tools sidebar now renders that root as a file tree read from the
+ * workspace tree, which the rule would empty. A `!pattern` negation is not
+ * the pattern and stays. A platform comment directly above a dropped line
+ * goes with it, and so does the blank line that opened an appended block —
+ * the same tidy-up `withoutPlatformIgnorePattern` does, so a file either
+ * step cleans reads the same afterwards.
+ *
+ * Exported for the Groups→Plugins step, which retires the same rules on the
+ * branches this step never visits (drafts).
+ */
+export declare function withoutIgnoreLine(text: string, pattern: string): string;
+/**
+ * `text` without the `AGENTS.md` line THE PLATFORM WROTE — under its own
+ * comment (either spelling), or in the slot at the end of the template's own
+ * repo-hygiene block ({@link TEMPLATE_HYGIENE_BLOCK_ABOVE_AGENTS_RULE}) — and
+ * without that comment.
+ *
+ * Called only when the guide has been renamed, which is what makes the line
+ * wrong: it hides a file the platform no longer owns. A `!AGENTS.md` negation
+ * is not the rule and stays, as everywhere else here.
+ */
+export declare function withoutPlatformAgentsRule(text: string): string;
+/**
+ * `text` with the platform's pointer sentence appended as its own paragraph.
+ *
+ * One blank line between the customer's last line and ours, whether or not
+ * their file ended in a newline: a sentence glued onto the end of their last
+ * paragraph would read as a continuation of something they wrote.
+ */
+export declare function withPointerSentence(text: string, agentsFile: string): string;
 //# sourceMappingURL=template-files.step.d.ts.map

package/dist/modules/workspace/startup/steps/template-files.step.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template-files.step.d.ts","sourceRoot":"","sources":["../../../../../src/modules/workspace/startup/steps/template-files.step.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAY,aAAa,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAErG;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAA6D,CAAC;AAE1G;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAAmB,CAAC;AAEjE;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEtE,CAAC;AA6CF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAcpF;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS1F;AAoBD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,IAAI,oBAAoB;IAEjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;IAEjD;;;;;;OAMG;gBACS,aAAa,GAAE,SAAS,MAAM,EAAO;IAI3C,GAAG,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;YAOzC,KAAK;IAqFnB;;;;;;;;;;OAUG;YACW,WAAW;IAiBzB;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;CAQ3B"}
+{"version":3,"file":"template-files.step.d.ts","sourceRoot":"","sources":["../../../../../src/modules/workspace/startup/steps/template-files.step.ts"],"names":[],"mappings":"AAcA,OAAO,EAA8B,KAAK,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAG9F,OAAO,KAAK,EAAY,aAAa,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAMrG;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,IAAI,SAAS,MAAM,EAAE,CAgBjD;AAwBD,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAAmB,CAAC;AA8CjE;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAcpF;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IAiBnD,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAlBjC,QAAQ,CAAC,IAAI,oBAAoB;IAEjC;;;;;;OAMG;IACH;;;;;OAKG;gBAEgB,IAAI,EAAE,QAAQ,EACd,aAAa,GAAE,SAAS,MAAM,EAAO,EACrC,cAAc,GAAE,MAAM,OAAoB;IAUvD,GAAG,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;YAOzC,KAAK;IA2JnB;;;;;;;;;;;;;;;;;;;;;;OAsBG;YACW,oBAAoB;IAoElC;;;;;;;;;;OAUG;YACW,WAAW;IAiBzB;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;;;;;;;;;;;;;;OAeG;YACW,oBAAoB;CAuCnC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAcvE;AAwCD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAwB9D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAG5E"}