ctxr-cli 0.5.0 → 0.6.0

package/dist/commands/publish-new.js

@@ -0,0 +1,86 @@
+import { existsSync } from 'node:fs';
+import { mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { PublishReservedSlugError, PublishSlugExistsError } from '../core/errors.js';
+import { ExitCode } from '../core/exit-codes.js';
+import { writeFileAtomic } from '../core/fs/atomic.js';
+export const requires = { store: 'required' };
+/** publish spec: reserved for frozen snapshots — a living page's slug must never collide with this shape. */
+const RESERVED_SLUG_PATTERN = /^\d{4}-/;
+function pageSkeleton(slug, dateCreated) {
+    return [
+        '<!doctype html>',
+        '<html lang="en">',
+        '<head>',
+        '<meta charset="utf-8">',
+        '<meta name="viewport" content="width=device-width, initial-scale=1">',
+        `<title>${slug}</title>`,
+        '<style>',
+        '@media print {',
+        '  .no-print { display: none; }',
+        '}',
+        '</style>',
+        '</head>',
+        '<body>',
+        `<p class="meta"><span>${dateCreated}</span> &middot; <a href="./README.md">spec</a></p>`,
+        '<main>',
+        '<!-- Build the bespoke representation here. -->',
+        '</main>',
+        '</body>',
+        '</html>',
+        '',
+    ].join('\n');
+}
+function readmeSkeleton(slug, dateCreated) {
+    return [
+        `# ${slug}`,
+        '',
+        `date-created: ${dateCreated}`,
+        '',
+        '## Intent',
+        '',
+        "One sentence: what does this page let the viewer DO that its source notes couldn't?",
+        '',
+        '## Source notes',
+        '',
+        'Wikilinks back into the store. The notes are the source of truth; this page is a representation of them.',
+        '',
+        '## Audience & use',
+        '',
+        'Who is this for, and in what setting will they use it?',
+        '',
+        '## Spec / prompt',
+        '',
+        'The brief that produced index.html. Keep this so the page is regenerable.',
+        '',
+    ].join('\n');
+}
+/**
+ * publish spec: fixes a page's identity once. Refuses a slug that collides
+ * with the reserved dated-snapshot naming pattern, and never overwrites an
+ * existing page folder — the caller updates in place by editing the
+ * existing files directly, never by re-running this command.
+ */
+export async function execute(store, flags) {
+    if (RESERVED_SLUG_PATTERN.test(flags.slug)) {
+        throw new PublishReservedSlugError(flags.slug);
+    }
+    const relativePath = path.join(store.config.publish.path, flags.slug).split(path.sep).join('/');
+    const absolutePath = path.join(store.root, relativePath);
+    if (existsSync(absolutePath)) {
+        throw new PublishSlugExistsError(flags.slug, relativePath);
+    }
+    const dateCreated = new Date().toISOString().slice(0, 10);
+    await mkdir(absolutePath, { recursive: true });
+    await writeFileAtomic(path.join(absolutePath, 'index.html'), pageSkeleton(flags.slug, dateCreated));
+    await writeFileAtomic(path.join(absolutePath, 'README.md'), readmeSkeleton(flags.slug, dateCreated));
+    return {
+        exitCode: ExitCode.Ok,
+        data: { slug: flags.slug, path: relativePath },
+        findings: [],
+        humanSummary: `Created "${relativePath}".`,
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+//# sourceMappingURL=publish-new.js.map

package/dist/commands/publish-new.js.map

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

package/dist/commands/serve.d.ts

@@ -0,0 +1,32 @@
+import type { CommandOutcome, CommandRequires } from '../core/command.js';
+import type { RunEnv } from '../core/env.js';
+import type { Store } from '../core/store.js';
+export declare const requires: CommandRequires;
+export interface ServeFlags {
+    port: number;
+    host: string;
+}
+export interface ServeData {
+    url: string;
+    port: number;
+    host: string;
+    root: string;
+}
+/**
+ * Defaults to loopback so an invocation with no `--host` keeps today's
+ * behavior exactly. `--host` exists for an operator who has deliberately
+ * decided to put something else (a reverse proxy, a tunnel sharing this
+ * process's network namespace) in front and knows what binding wider than
+ * loopback exposes — this command still applies no requester filtering of
+ * its own regardless of bind address; that judgment is entirely the
+ * caller's.
+ */
+export declare const DEFAULT_HOST = "127.0.0.1";
+/**
+ * cli-contract spec (local-browsing-surface D5): resolves the moment the
+ * listener is ready, so `runCommand()` emits exactly one envelope before
+ * any request is served — the listener itself keeps the process alive
+ * afterward, with no change to how `run()`/`bin.ts` end.
+ */
+export declare function execute(env: RunEnv, store: Store, flags: ServeFlags): Promise<CommandOutcome<ServeData>>;
+//# sourceMappingURL=serve.d.ts.map

package/dist/commands/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AAE/D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,cAAc,CAAC;AAwIxC;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CA2B9G"}

package/dist/commands/serve.js

@@ -0,0 +1,170 @@
+import { readFile } from 'node:fs/promises';
+import { createServer } from 'node:http';
+import path from 'node:path';
+import { buildLinkResolver } from '../core/browse/link-resolver.js';
+import { escapeHtml, renderNoteBody } from '../core/browse/render.js';
+import { buildRouteTable, publishSlugs } from '../core/browse/routes.js';
+import { readStylesheet, renderShell } from '../core/browse/templates.js';
+import { ExitCode } from '../core/exit-codes.js';
+export const requires = { store: 'required' };
+/**
+ * Defaults to loopback so an invocation with no `--host` keeps today's
+ * behavior exactly. `--host` exists for an operator who has deliberately
+ * decided to put something else (a reverse proxy, a tunnel sharing this
+ * process's network namespace) in front and knows what binding wider than
+ * loopback exposes — this command still applies no requester filtering of
+ * its own regardless of bind address; that judgment is entirely the
+ * caller's.
+ */
+export const DEFAULT_HOST = '127.0.0.1';
+const CONTENT_TYPES = {
+    '.html': 'text/html; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.mjs': 'text/javascript; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.ico': 'image/x-icon',
+    '.txt': 'text/plain; charset=utf-8',
+    '.md': 'text/markdown; charset=utf-8',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+};
+function contentTypeFor(filePath) {
+    return CONTENT_TYPES[path.extname(filePath).toLowerCase()] ?? 'application/octet-stream';
+}
+/** Requirement: an unbuilt derived artifact reports how to build it, rather than an opaque 404. */
+function buildHint(command) {
+    return `<div class="ctxr-build-hint">Not built yet. Run <code>${escapeHtml(command)}</code> and reload.</div>`;
+}
+function renderIndex(table) {
+    const notes = [...table.notes.keys()].sort();
+    const catalogSections = [...table.catalog.keys()].sort();
+    const slugs = publishSlugs(table);
+    const listItems = (items, hrefFor) => items.length > 0
+        ? items.map((item) => `<li><a href="${hrefFor(item)}">${escapeHtml(item)}</a></li>`).join('\n')
+        : '<li>none yet</li>';
+    return [
+        '<h1>contexture</h1>',
+        `<p>${notes.length} note(s), ${catalogSections.length} catalog section(s), ${slugs.length} published page(s).</p>`,
+        '<h2>Notes</h2>',
+        `<ul class="ctxr-index">${listItems(notes, (p) => `/notes/${encodeURI(p)}`)}</ul>`,
+        '<h2>Catalog</h2>',
+        `<ul class="ctxr-index">${listItems(catalogSections, (id) => `/catalog/${encodeURIComponent(id)}`)}</ul>`,
+        '<h2>Graph</h2>',
+        '<p><a href="/graph">graph document</a></p>',
+        '<h2>Published pages</h2>',
+        `<ul class="ctxr-index">${listItems(slugs, (slug) => `/publish/${encodeURIComponent(slug)}/index.html`)}</ul>`,
+    ].join('\n');
+}
+function send(res, method, status, contentType, body) {
+    const buffer = Buffer.isBuffer(body) ? body : Buffer.from(body, 'utf8');
+    res.writeHead(status, { 'Content-Type': contentType, 'Content-Length': buffer.length });
+    res.end(method === 'HEAD' ? undefined : buffer);
+}
+/** Reads a derived document, rendering `hint` instead of 404ing when it hasn't been built yet. */
+async function readDerivedDocument(absolutePath) {
+    try {
+        return { text: await readFile(absolutePath, 'utf8') };
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return { hint: true };
+        throw err;
+    }
+}
+async function handleRequest(store, stderr, req, res) {
+    const method = req.method ?? 'GET';
+    const pathname = decodeURIComponent(new URL(req.url ?? '/', 'http://localhost').pathname);
+    stderr.write(`${method} ${pathname}\n`);
+    if (method !== 'GET' && method !== 'HEAD') {
+        send(res, method, 405, 'text/plain; charset=utf-8', 'method not allowed\n');
+        return;
+    }
+    const table = await buildRouteTable(store);
+    const resolveLink = buildLinkResolver([...table.notes.values()]);
+    if (pathname === '/') {
+        send(res, method, 200, 'text/html; charset=utf-8', await renderShell('contexture', renderIndex(table)));
+        return;
+    }
+    if (pathname === '/assets/style.css') {
+        send(res, method, 200, 'text/css; charset=utf-8', await readStylesheet());
+        return;
+    }
+    if (pathname === '/graph') {
+        const doc = await readDerivedDocument(table.graphDocumentPath);
+        const body = 'hint' in doc ? buildHint('ctxr graph build') : renderNoteBody(doc.text, resolveLink);
+        send(res, method, 200, 'text/html; charset=utf-8', await renderShell('graph', body));
+        return;
+    }
+    if (pathname.startsWith('/notes/')) {
+        const note = table.notes.get(pathname.slice('/notes/'.length));
+        if (!note) {
+            send(res, method, 404, 'text/plain; charset=utf-8', 'not found\n');
+            return;
+        }
+        send(res, method, 200, 'text/html; charset=utf-8', await renderShell(note.path, renderNoteBody(note.body, resolveLink)));
+        return;
+    }
+    if (pathname.startsWith('/catalog/')) {
+        const sectionId = pathname.slice('/catalog/'.length);
+        const section = table.catalog.get(sectionId);
+        if (!section) {
+            send(res, method, 404, 'text/plain; charset=utf-8', 'not found\n');
+            return;
+        }
+        const doc = await readDerivedDocument(section.absolutePath);
+        const body = 'hint' in doc ? buildHint('ctxr catalog build') : renderNoteBody(doc.text, resolveLink);
+        send(res, method, 200, 'text/html; charset=utf-8', await renderShell(sectionId, body));
+        return;
+    }
+    if (pathname.startsWith('/publish/')) {
+        const file = table.publishFiles.get(pathname.slice('/publish/'.length));
+        if (!file) {
+            send(res, method, 404, 'text/plain; charset=utf-8', 'not found\n');
+            return;
+        }
+        send(res, method, 200, contentTypeFor(file.absolutePath), await readFile(file.absolutePath));
+        return;
+    }
+    send(res, method, 404, 'text/plain; charset=utf-8', 'not found\n');
+}
+/**
+ * cli-contract spec (local-browsing-surface D5): resolves the moment the
+ * listener is ready, so `runCommand()` emits exactly one envelope before
+ * any request is served — the listener itself keeps the process alive
+ * afterward, with no change to how `run()`/`bin.ts` end.
+ */
+export async function execute(env, store, flags) {
+    const server = createServer((req, res) => {
+        handleRequest(store, env.io.stderr, req, res).catch((err) => {
+            env.io.stderr.write(`serve: ${err instanceof Error ? err.message : String(err)}\n`);
+            if (!res.headersSent)
+                send(res, req.method ?? 'GET', 500, 'text/plain; charset=utf-8', 'internal error\n');
+            else
+                res.end();
+        });
+    });
+    const host = flags.host;
+    await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(flags.port, host, resolve);
+    });
+    const address = server.address();
+    const port = typeof address === 'object' && address !== null ? address.port : flags.port;
+    const url = `http://${host}:${port}/`;
+    return {
+        exitCode: ExitCode.Ok,
+        data: { url, port, host, root: store.root },
+        findings: [],
+        humanSummary: `serving ${store.root} at ${url}`,
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+//# sourceMappingURL=serve.js.map

package/dist/commands/serve.js.map

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

package/dist/commands/update.js

@@ -10,13 +10,13 @@ export const requires = { store: 'required' };
  * touched. Idempotent: a current store reports nothing changed.
  */
 export async function execute(env, store) {
-    const { changed } = await reconcileStore(env, store.root, store.config);
-    const adapterFiles = await generateAdapterOutputs(store);
+    const { changed, findings } = await reconcileStore(env, store.root, store.config);
+    const adapterFiles = await generateAdapterOutputs(env.git, store);
     const all = [...new Set([...changed, ...adapterFiles.filter((f) => f.changed).map((f) => f.path)])];
     return {
         exitCode: ExitCode.Ok,
         data: { changed: all },
-        findings: [],
+        findings,
         humanSummary: all.length === 0 ? 'Store is already up to date.' : `Updated ${all.length} contexture-owned file(s).`,
         storeRoot: store.root,
         schemaVersion: store.config.schema_version,

package/dist/commands/update.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,CAAC,MAAM,QAAQ,GAAoB,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAO/D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,KAAY;IACrD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxE,MAAM,YAAY,GAAG,MAAM,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACzD,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpG,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,EAAE;QACrB,IAAI,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE;QACtB,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,MAAM,4BAA4B;QACnH,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,cAAc;KAC3C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,CAAC,MAAM,QAAQ,GAAoB,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAO/D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,KAAY;IACrD,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAClF,MAAM,YAAY,GAAG,MAAM,sBAAsB,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAClE,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpG,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,EAAE;QACrB,IAAI,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE;QACtB,QAAQ;QACR,YAAY,EAAE,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,MAAM,4BAA4B;QACnH,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,cAAc;KAC3C,CAAC;AACJ,CAAC"}

package/dist/config/defaults.d.ts

@@ -30,12 +30,17 @@ export declare const DEFAULT_VISIBILITY_CONTEXT = "private";
  */
 export declare const DEFAULT_DERIVED_PATHS: readonly ['.contexture/cache/'];
 /**
- * harness-portability spec (entry-doc-generation D5): contexture-owned
- * skills are copied here (`<slug>/SKILL.md`), defaulting to the directory
- * harnesses with skill auto-discovery read — one file, one hop. A store
- * driven by another harness points this at that harness's skills directory.
+ * harness-portability spec (vendored-craft-skills): the ecosystem's
+ * cross-harness canonical skills location — the directory the majority of
+ * agent runtimes read natively, with no bridge required. A harness that
+ * reads its own branded directory instead (e.g. Claude Code's
+ * `.claude/skills/`) gets that directory bridged to this one; see
+ * `core/harness/bridge.ts`. A store driven by no auto-discovering harness
+ * can still point this anywhere.
  */
-export declare const DEFAULT_SKILLS_PATH = ".claude/skills/";
+export declare const DEFAULT_SKILLS_PATH = ".agents/skills/";
+/** harness-portability spec (vendored-craft-skills): the shipped vendored skill set, installed by default and refreshed by update. */
+export declare const DEFAULT_VENDORED_SKILLS: readonly ['frontend-design'];
 /**
  * harness-portability spec: the guidance directory holding contexture's
  * shipped baseline convention file, the operator's own convention files
@@ -44,10 +49,21 @@ export declare const DEFAULT_SKILLS_PATH = ".claude/skills/";
  * context-organize) the mission document.
  */
 export declare const DEFAULT_GUIDANCE_PATH = ".contexture/guidance/";
-/** The shipped, contexture-owned baseline convention — never hand-edited; refreshed by `ctxr update` like a skill copy. */
-export declare const DEFAULT_BASELINE_CONVENTION_FILE_NAME = "baseline-convention.md";
-/** The operator-authored convention file seeded at init. */
-export declare const DEFAULT_CUSTOM_CONVENTION_FILE_NAME = "custom-convention.md";
+/** The shipped, contexture-owned baseline conventions — never hand-edited; refreshed by `ctxr update` like a skill copy. */
+export declare const DEFAULT_BASELINE_CONVENTIONS_FILE_NAME = "baseline-conventions.md";
+/**
+ * The baseline file's pre-rename name. `syncBaselineConventions` removes it
+ * when it still carries the managed-owner header, so the rename leaves no
+ * orphan — the guidance directory is scanned wholesale, so an orphan would
+ * be inlined into AGENTS.md a second time rather than merely sitting unused.
+ */
+export declare const LEGACY_BASELINE_CONVENTION_FILE_NAME = "baseline-convention.md";
+/**
+ * The operator-authored conventions file seeded at init: this store's house
+ * rules, layered on the shipped baseline and winning where the two speak to
+ * the same thing.
+ */
+export declare const DEFAULT_HOUSE_CONVENTIONS_FILE_NAME = "house-conventions.md";
 /** context-organize spec: the store's standing current-state document's filename, under the guidance directory. */
 export declare const DEFAULT_MISSION_FILE_NAME = "mission.md";
 /** context-organize spec: `organize.mission_path`'s shipped default — every store gets a mission document from `init` onward, seeded there. */
@@ -69,14 +85,14 @@ export declare const DEFAULT_GRAPH_SETTINGS: {
 export declare const DEFAULT_WORKTREES_PATH = ".worktrees/";
 /** Branch names for session worktrees are prefixed so they're recognizable and sweep-safe. */
 export declare const DEFAULT_SESSION_BRANCH_PREFIX = "session/";
-/** write-lifecycle spec: worktrees are ctxr-owned (not externally provided) unless a store opts in. */
-export declare const DEFAULT_WORKSPACES_EXTERNAL = false;
 /** write-lifecycle spec: pre-commit's diff-size ceiling, in total changed lines. */
 export declare const DEFAULT_DIFF_SIZE_CEILING_LINES = 2000;
 /** context-catalog spec: where per-section catalog files live — tracked (never gitignored), since glosses are authored. */
 export declare const DEFAULT_CATALOG_PATH = ".contexture/catalog/";
 /** context-catalog spec: a section exceeding this triggers a failing doctor check, not a silent slowdown. */
 export declare const DEFAULT_CATALOG_SECTION_MAX_BYTES: number;
+/** publish spec: where published pages live — tracked, authored-but-tool-owned, excluded from retrieval like the catalog and skill pack. */
+export declare const DEFAULT_PUBLISH_PATH = ".contexture/publish/";
 /** disclosure-policy spec: v1 ships with no audiences pre-declared internal, and no hard walls — an explicit, empty starting point the operator opts into. */
 export declare const DEFAULT_INTERNAL_AUDIENCES: readonly string[];
 export declare const DEFAULT_HARD_WALLS: readonly HardWallConfig[];
@@ -84,15 +100,21 @@ export declare const DEFAULT_HARD_WALLS: readonly HardWallConfig[];
 export declare const DEFAULT_INBOX_PATH = "inbox/";
 /** store-primitives-from-migration-audit spec (D2): the shipped tracking-parameter list source check strips before comparing URL identities. */
 export declare const DEFAULT_TRACKING_PARAMS: string[];
-/** context-organize spec: archive's destination, decoupled from any taxonomy layer name. */
-export declare const DEFAULT_ARCHIVE_PATH = "archive/";
+/**
+ * context-organize spec: archive's destination, decoupled from any taxonomy
+ * layer name. This is the fallback for a taxonomy that declares none of its
+ * own — a shipped profile with a retirement layer (PARA's Archives) supplies
+ * its `archiveDestination` at init instead, so a PARA store is never born
+ * pointing at a directory its own taxonomy doesn't declare.
+ */
+export declare const DEFAULT_ARCHIVE_DESTINATION = "archive/";
 /** store-primitives-from-migration-audit spec (D4): grace period, in days, before a stale rollup is reported. */
 export declare const DEFAULT_ROLLUP_STALE_DAYS = 7;
 /**
- * adapters spec: init registers both shipped builtins by default, so
- * out-of-the-box UX (a PR opened on session submit, a generated CLAUDE.md)
- * keeps working without the operator hand-writing config — each is just as
- * removable from this list as it was addable.
+ * adapters spec: init registers the shipped builtin by default, so
+ * out-of-the-box UX (a generated CLAUDE.md) keeps working without the
+ * operator hand-writing config — it is just as removable from this list as
+ * it was addable.
  */
 export declare const DEFAULT_ADAPTERS: readonly AdapterDeclaration[];
 //# sourceMappingURL=defaults.d.ts.map

package/dist/config/defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEtE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,4BAA4B,SAAS,CAAC;AAEnD;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,UAAU,CAAC;AAEtD,gFAAgF;AAChF,eAAO,MAAM,0BAA0B,YAAY,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,YAAI,oBAAoB,CAAU,CAAC;AAErE;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AAErD;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D,2HAA2H;AAC3H,eAAO,MAAM,qCAAqC,2BAA2B,CAAC;AAE9E,4DAA4D;AAC5D,eAAO,MAAM,mCAAmC,yBAAyB,CAAC;AAE1E,mHAAmH;AACnH,eAAO,MAAM,yBAAyB,eAAe,CAAC;AAEtD,+IAA+I;AAC/I,eAAO,MAAM,oBAAoB,oCAAyD,CAAC;AAE3F,yIAAyI;AACzI,eAAO,MAAM,4BAA4B,QAAY,CAAC;AAEtD,0DAA0D;AAC1D,eAAO,MAAM,qBAAqB,YAAI,cAAc,CAAU,CAAC;AAE/D,oHAAoH;AACpH,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAAO,CAAC;AAEvD,8HAA8H;AAC9H,eAAO,MAAM,sBAAsB;IACjC,aAAa;IACb,OAAO;IACP,UAAU;IACV,sBAAsB,EAAQ,MAAM,EAAE;CACvC,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,sBAAsB,gBAAgB,CAAC;AAEpD,8FAA8F;AAC9F,eAAO,MAAM,6BAA6B,aAAa,CAAC;AAExD,uGAAuG;AACvG,eAAO,MAAM,2BAA2B,QAAQ,CAAC;AAEjD,oFAAoF;AACpF,eAAO,MAAM,+BAA+B,OAAO,CAAC;AAEpD,2HAA2H;AAC3H,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAE3D,6GAA6G;AAC7G,eAAO,MAAM,iCAAiC,QAAY,CAAC;AAE3D,8JAA8J;AAC9J,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAAO,CAAC;AAChE,eAAO,MAAM,kBAAkB,EAAE,SAAS,cAAc,EAAO,CAAC;AAEhE,uGAAuG;AACvG,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C,gJAAgJ;AAChJ,eAAO,MAAM,uBAAuB,UAA6F,CAAC;AAElI,4FAA4F;AAC5F,eAAO,MAAM,oBAAoB,aAAa,CAAC;AAE/C,iHAAiH;AACjH,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,kBAAkB,EAGzD,CAAC"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEtE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,4BAA4B,SAAS,CAAC;AAEnD;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,UAAU,CAAC;AAEtD,gFAAgF;AAChF,eAAO,MAAM,0BAA0B,YAAY,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,YAAI,oBAAoB,CAAU,CAAC;AAErE;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AAErD,sIAAsI;AACtI,eAAO,MAAM,uBAAuB,YAAI,iBAAiB,CAAU,CAAC;AAEpE;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D,4HAA4H;AAC5H,eAAO,MAAM,sCAAsC,4BAA4B,CAAC;AAEhF;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,2BAA2B,CAAC;AAE7E;;;;GAIG;AACH,eAAO,MAAM,mCAAmC,yBAAyB,CAAC;AAE1E,mHAAmH;AACnH,eAAO,MAAM,yBAAyB,eAAe,CAAC;AAEtD,+IAA+I;AAC/I,eAAO,MAAM,oBAAoB,oCAAyD,CAAC;AAE3F,yIAAyI;AACzI,eAAO,MAAM,4BAA4B,QAAY,CAAC;AAEtD,0DAA0D;AAC1D,eAAO,MAAM,qBAAqB,YAAI,cAAc,CAAU,CAAC;AAE/D,oHAAoH;AACpH,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAAO,CAAC;AAEvD,8HAA8H;AAC9H,eAAO,MAAM,sBAAsB;IACjC,aAAa;IACb,OAAO;IACP,UAAU;IACV,sBAAsB,EAAQ,MAAM,EAAE;CACvC,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,sBAAsB,gBAAgB,CAAC;AAEpD,8FAA8F;AAC9F,eAAO,MAAM,6BAA6B,aAAa,CAAC;AAGxD,oFAAoF;AACpF,eAAO,MAAM,+BAA+B,OAAO,CAAC;AAEpD,2HAA2H;AAC3H,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAE3D,6GAA6G;AAC7G,eAAO,MAAM,iCAAiC,QAAY,CAAC;AAE3D,4IAA4I;AAC5I,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAE3D,8JAA8J;AAC9J,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAAO,CAAC;AAChE,eAAO,MAAM,kBAAkB,EAAE,SAAS,cAAc,EAAO,CAAC;AAEhE,uGAAuG;AACvG,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C,gJAAgJ;AAChJ,eAAO,MAAM,uBAAuB,UAA6F,CAAC;AAElI;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,aAAa,CAAC;AAEtD,iHAAiH;AACjH,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,kBAAkB,EAAwD,CAAC"}

package/dist/config/defaults.js

@@ -29,12 +29,17 @@ export const DEFAULT_VISIBILITY_CONTEXT = 'private';
  */
 export const DEFAULT_DERIVED_PATHS = ['.contexture/cache/'];
 /**
- * harness-portability spec (entry-doc-generation D5): contexture-owned
- * skills are copied here (`<slug>/SKILL.md`), defaulting to the directory
- * harnesses with skill auto-discovery read — one file, one hop. A store
- * driven by another harness points this at that harness's skills directory.
+ * harness-portability spec (vendored-craft-skills): the ecosystem's
+ * cross-harness canonical skills location — the directory the majority of
+ * agent runtimes read natively, with no bridge required. A harness that
+ * reads its own branded directory instead (e.g. Claude Code's
+ * `.claude/skills/`) gets that directory bridged to this one; see
+ * `core/harness/bridge.ts`. A store driven by no auto-discovering harness
+ * can still point this anywhere.
  */
-export const DEFAULT_SKILLS_PATH = '.claude/skills/';
+export const DEFAULT_SKILLS_PATH = '.agents/skills/';
+/** harness-portability spec (vendored-craft-skills): the shipped vendored skill set, installed by default and refreshed by update. */
+export const DEFAULT_VENDORED_SKILLS = ['frontend-design'];
 /**
  * harness-portability spec: the guidance directory holding contexture's
  * shipped baseline convention file, the operator's own convention files
@@ -43,10 +48,21 @@ export const DEFAULT_SKILLS_PATH = '.claude/skills/';
  * context-organize) the mission document.
  */
 export const DEFAULT_GUIDANCE_PATH = '.contexture/guidance/';
-/** The shipped, contexture-owned baseline convention — never hand-edited; refreshed by `ctxr update` like a skill copy. */
-export const DEFAULT_BASELINE_CONVENTION_FILE_NAME = 'baseline-convention.md';
-/** The operator-authored convention file seeded at init. */
-export const DEFAULT_CUSTOM_CONVENTION_FILE_NAME = 'custom-convention.md';
+/** The shipped, contexture-owned baseline conventions — never hand-edited; refreshed by `ctxr update` like a skill copy. */
+export const DEFAULT_BASELINE_CONVENTIONS_FILE_NAME = 'baseline-conventions.md';
+/**
+ * The baseline file's pre-rename name. `syncBaselineConventions` removes it
+ * when it still carries the managed-owner header, so the rename leaves no
+ * orphan — the guidance directory is scanned wholesale, so an orphan would
+ * be inlined into AGENTS.md a second time rather than merely sitting unused.
+ */
+export const LEGACY_BASELINE_CONVENTION_FILE_NAME = 'baseline-convention.md';
+/**
+ * The operator-authored conventions file seeded at init: this store's house
+ * rules, layered on the shipped baseline and winning where the two speak to
+ * the same thing.
+ */
+export const DEFAULT_HOUSE_CONVENTIONS_FILE_NAME = 'house-conventions.md';
 /** context-organize spec: the store's standing current-state document's filename, under the guidance directory. */
 export const DEFAULT_MISSION_FILE_NAME = 'mission.md';
 /** context-organize spec: `organize.mission_path`'s shipped default — every store gets a mission document from `init` onward, seeded there. */
@@ -68,14 +84,14 @@ export const DEFAULT_GRAPH_SETTINGS = {
 export const DEFAULT_WORKTREES_PATH = '.worktrees/';
 /** Branch names for session worktrees are prefixed so they're recognizable and sweep-safe. */
 export const DEFAULT_SESSION_BRANCH_PREFIX = 'session/';
-/** write-lifecycle spec: worktrees are ctxr-owned (not externally provided) unless a store opts in. */
-export const DEFAULT_WORKSPACES_EXTERNAL = false;
 /** write-lifecycle spec: pre-commit's diff-size ceiling, in total changed lines. */
 export const DEFAULT_DIFF_SIZE_CEILING_LINES = 2000;
 /** context-catalog spec: where per-section catalog files live — tracked (never gitignored), since glosses are authored. */
 export const DEFAULT_CATALOG_PATH = '.contexture/catalog/';
 /** context-catalog spec: a section exceeding this triggers a failing doctor check, not a silent slowdown. */
 export const DEFAULT_CATALOG_SECTION_MAX_BYTES = 32 * 1024;
+/** publish spec: where published pages live — tracked, authored-but-tool-owned, excluded from retrieval like the catalog and skill pack. */
+export const DEFAULT_PUBLISH_PATH = '.contexture/publish/';
 /** disclosure-policy spec: v1 ships with no audiences pre-declared internal, and no hard walls — an explicit, empty starting point the operator opts into. */
 export const DEFAULT_INTERNAL_AUDIENCES = [];
 export const DEFAULT_HARD_WALLS = [];
@@ -83,18 +99,21 @@ export const DEFAULT_HARD_WALLS = [];
 export const DEFAULT_INBOX_PATH = 'inbox/';
 /** store-primitives-from-migration-audit spec (D2): the shipped tracking-parameter list source check strips before comparing URL identities. */
 export const DEFAULT_TRACKING_PARAMS = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid'];
-/** context-organize spec: archive's destination, decoupled from any taxonomy layer name. */
-export const DEFAULT_ARCHIVE_PATH = 'archive/';
+/**
+ * context-organize spec: archive's destination, decoupled from any taxonomy
+ * layer name. This is the fallback for a taxonomy that declares none of its
+ * own — a shipped profile with a retirement layer (PARA's Archives) supplies
+ * its `archiveDestination` at init instead, so a PARA store is never born
+ * pointing at a directory its own taxonomy doesn't declare.
+ */
+export const DEFAULT_ARCHIVE_DESTINATION = 'archive/';
 /** store-primitives-from-migration-audit spec (D4): grace period, in days, before a stale rollup is reported. */
 export const DEFAULT_ROLLUP_STALE_DAYS = 7;
 /**
- * adapters spec: init registers both shipped builtins by default, so
- * out-of-the-box UX (a PR opened on session submit, a generated CLAUDE.md)
- * keeps working without the operator hand-writing config — each is just as
- * removable from this list as it was addable.
+ * adapters spec: init registers the shipped builtin by default, so
+ * out-of-the-box UX (a generated CLAUDE.md) keeps working without the
+ * operator hand-writing config — it is just as removable from this list as
+ * it was addable.
  */
-export const DEFAULT_ADAPTERS = [
-    { id: 'github', kind: 'forge' },
-    { id: 'claude-code', kind: 'harness-generation' },
-];
+export const DEFAULT_ADAPTERS = [{ id: 'claude-code', kind: 'harness-generation' }];
 //# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,MAAM,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,OAAO,CAAC;AAEtD,gFAAgF;AAChF,MAAM,CAAC,MAAM,0BAA0B,GAAG,SAAS,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,oBAAoB,CAAU,CAAC;AAErE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAE7D,2HAA2H;AAC3H,MAAM,CAAC,MAAM,qCAAqC,GAAG,wBAAwB,CAAC;AAE9E,4DAA4D;AAC5D,MAAM,CAAC,MAAM,mCAAmC,GAAG,sBAAsB,CAAC;AAE1E,mHAAmH;AACnH,MAAM,CAAC,MAAM,yBAAyB,GAAG,YAAY,CAAC;AAEtD,+IAA+I;AAC/I,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,qBAAqB,GAAG,yBAAyB,EAAE,CAAC;AAE3F,yIAAyI;AACzI,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,GAAG,IAAI,CAAC;AAEtD,0DAA0D;AAC1D,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,cAAc,CAAU,CAAC;AAE/D,oHAAoH;AACpH,MAAM,CAAC,MAAM,iBAAiB,GAAsB,EAAE,CAAC;AAEvD,8HAA8H;AAC9H,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,aAAa,EAAE,CAAC;IAChB,OAAO,EAAE,CAAC;IACV,UAAU,EAAE,EAAE;IACd,sBAAsB,EAAE,EAAc;CACvC,CAAC;AAEF,wFAAwF;AACxF,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAC;AAEpD,8FAA8F;AAC9F,MAAM,CAAC,MAAM,6BAA6B,GAAG,UAAU,CAAC;AAExD,uGAAuG;AACvG,MAAM,CAAC,MAAM,2BAA2B,GAAG,KAAK,CAAC;AAEjD,oFAAoF;AACpF,MAAM,CAAC,MAAM,+BAA+B,GAAG,IAAI,CAAC;AAEpD,2HAA2H;AAC3H,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAE3D,6GAA6G;AAC7G,MAAM,CAAC,MAAM,iCAAiC,GAAG,EAAE,GAAG,IAAI,CAAC;AAE3D,8JAA8J;AAC9J,MAAM,CAAC,MAAM,0BAA0B,GAAsB,EAAE,CAAC;AAChE,MAAM,CAAC,MAAM,kBAAkB,GAA8B,EAAE,CAAC;AAEhE,uGAAuG;AACvG,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAE3C,gJAAgJ;AAChJ,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAElI,4FAA4F;AAC5F,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAE/C,iHAAiH;AACjH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAkC;IAC7D,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE;IAC/B,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,oBAAoB,EAAE;CAClD,CAAC"}
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,MAAM,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,OAAO,CAAC;AAEtD,gFAAgF;AAChF,MAAM,CAAC,MAAM,0BAA0B,GAAG,SAAS,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,oBAAoB,CAAU,CAAC;AAErE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAErD,sIAAsI;AACtI,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,iBAAiB,CAAU,CAAC;AAEpE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAE7D,4HAA4H;AAC5H,MAAM,CAAC,MAAM,sCAAsC,GAAG,yBAAyB,CAAC;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,wBAAwB,CAAC;AAE7E;;;;GAIG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,sBAAsB,CAAC;AAE1E,mHAAmH;AACnH,MAAM,CAAC,MAAM,yBAAyB,GAAG,YAAY,CAAC;AAEtD,+IAA+I;AAC/I,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,qBAAqB,GAAG,yBAAyB,EAAE,CAAC;AAE3F,yIAAyI;AACzI,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,GAAG,IAAI,CAAC;AAEtD,0DAA0D;AAC1D,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,cAAc,CAAU,CAAC;AAE/D,oHAAoH;AACpH,MAAM,CAAC,MAAM,iBAAiB,GAAsB,EAAE,CAAC;AAEvD,8HAA8H;AAC9H,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,aAAa,EAAE,CAAC;IAChB,OAAO,EAAE,CAAC;IACV,UAAU,EAAE,EAAE;IACd,sBAAsB,EAAE,EAAc;CACvC,CAAC;AAEF,wFAAwF;AACxF,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAC;AAEpD,8FAA8F;AAC9F,MAAM,CAAC,MAAM,6BAA6B,GAAG,UAAU,CAAC;AAGxD,oFAAoF;AACpF,MAAM,CAAC,MAAM,+BAA+B,GAAG,IAAI,CAAC;AAEpD,2HAA2H;AAC3H,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAE3D,6GAA6G;AAC7G,MAAM,CAAC,MAAM,iCAAiC,GAAG,EAAE,GAAG,IAAI,CAAC;AAE3D,4IAA4I;AAC5I,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAE3D,8JAA8J;AAC9J,MAAM,CAAC,MAAM,0BAA0B,GAAsB,EAAE,CAAC;AAChE,MAAM,CAAC,MAAM,kBAAkB,GAA8B,EAAE,CAAC;AAEhE,uGAAuG;AACvG,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAE3C,gJAAgJ;AAChJ,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAElI;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,UAAU,CAAC;AAEtD,iHAAiH;AACjH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAkC,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAAC"}