@seanmars/tospec 0.19.0-beta.7 → 0.20.0

package/dist/commands/workflow/status.js

@@ -1,31 +1,37 @@
-/**
- * Status Command
- *
- * Displays artifact completion status for a change.
- */
+/** `tospec status` — artifact completion for one change, or for every change. */
 import { getChangeDir } from '../../core/planning-home.js';
 import { resolveRootForCommand, toPlanningHome, toRootOutput, } from '../../core/root-selection.js';
 import { loadChangeContext, formatChangeStatus, } from '../../core/artifact-graph/index.js';
-import { validateChangeExists, validateSchemaExists, getAvailableChanges, getStatusIndicator, } from './shared.js';
+import { validateChangeExists, validateSchemaExists, assertChangeSchema, getAvailableChanges, getStatusIndicator, } from './shared.js';
 import { emitSuccess, asStatus } from '../shared-output.js';
+import { findTicketPath } from '../../utils/item-discovery.js';
+import { printProjectConfigDiagnostics } from '../../core/project-config.js';
 /**
  * The `--all --json` failure null-shape. Root selection resolves inside this
  * module while thrown errors are caught by the CLI wrapper, so both call sites
- * reference this one constant rather than each spelling the shape out.
+ * reference this one constant.
+ */
+export const BATCH_STATUS_FAILURE_PAYLOAD = { changes: null, root: null };
+/**
+ * The single-change `--json` failure null-shape. Flat payload, like
+ * `instructions` and `show`, so it nulls a key its success output really carries
+ * (`changeName`) — otherwise a caller cannot tell this envelope from an
+ * unrelated error document.
+ * decisions/20260917_155623-flat-json-payloads-null-a-real-success-key.md
  */
-export const BATCH_STATUS_FAILURE_PAYLOAD = { changes: null };
-// -----------------------------------------------------------------------------
-// Command Implementation
-// -----------------------------------------------------------------------------
+export const STATUS_FAILURE_PAYLOAD = { changeName: null, root: null };
 export async function statusCommand(options) {
     if (options.all && options.change) {
         throw new Error('The --all and --change options are mutually exclusive.');
     }
-    // The batch null-shape rides along so a root-selection failure under
-    // --all --json still carries `changes: null` rather than an empty payload.
+    // No implicit root: it resolves only when no ancestor holds a `tospec/` dir,
+    // and status would then answer "No active changes." with exit 0 about a
+    // directory that is not a project — the vacuous pass `validate`, `list` and
+    // `archive` also refuse.
     const root = await resolveRootForCommand(options, {
         json: options.json,
-        failurePayload: options.all ? BATCH_STATUS_FAILURE_PAYLOAD : undefined,
+        allowImplicitRoot: false,
+        failurePayload: options.all ? BATCH_STATUS_FAILURE_PAYLOAD : STATUS_FAILURE_PAYLOAD,
     });
     if (!root) {
         return;
@@ -34,20 +40,33 @@ export async function statusCommand(options) {
     const projectRoot = root.path;
     const rootOutput = toRootOutput(root);
     const newChangeHint = 'tospec new change <name>';
-    // Single definition of "load one change's status" so the batch and
-    // single-change payloads cannot drift apart.
+    // One definition of "load a change's status", so the batch and single-change
+    // payloads cannot drift apart.
     const loadStatus = (changeName) => formatChangeStatus(loadChangeContext(projectRoot, changeName, options.schema, {
         changeDir: getChangeDir(planningHome, changeName),
         planningHome,
     }));
-    // Handle no-changes case gracefully — status is informational,
-    // so "no changes" is a valid state, not an error.
+    // The ticket lives outside the change dir under a CLI-generated timestamp, so
+    // it appears in no artifact path; without this an agent has to glob
+    // `tospec/tickets/` and match frontmatter by hand.
+    const loadStatusWithTicket = async (changeName) => ({
+        ...loadStatus(changeName),
+        ticketPath: (await findTicketPath(projectRoot, changeName)) ?? null,
+    });
+    // `--schema` is judged on its own, before anything about changes is read: a
+    // wrong name is wrong whatever else was passed, and checking it later sends
+    // the caller to create a change first. `decision` is refused too, since it
+    // would plan an artifact at `tospec/changes/<change>/decision.md` — the orphan
+    // `instructions` and `new change` already refuse.
+    if (options.schema) {
+        validateSchemaExists(options.schema, projectRoot);
+        assertChangeSchema(options.schema);
+    }
+    // A change's schema falls back to the project config, so a config that no
+    // longer parses changes what this command reports — say so, once.
+    printProjectConfigDiagnostics(projectRoot);
+    // "No changes" is a valid state for an informational command, not an error.
     if (!options.change) {
-        // Validated before the no-changes early return so a bogus --schema fails
-        // the same way whether or not any change exists yet.
-        if (options.all && options.schema) {
-            validateSchemaExists(options.schema, projectRoot);
-        }
         const available = await getAvailableChanges(projectRoot, root.changesDir);
         if (available.length === 0) {
             if (options.json) {
@@ -58,15 +77,27 @@ export async function statusCommand(options) {
             return;
         }
         if (options.all) {
-            // readdir order is platform-dependent; sort with the comparator
-            // `validate --all` uses so both batch commands order a change set alike.
+            // readdir order is platform-dependent; the comparator is the one
+            // `validate --all` uses, so both batch commands order a change set alike.
             const entries = [];
+            // Top-level copies of the per-entry failures, for the `status` array the
+            // partial envelope carries: `list --json` and `validate --all --json`
+            // report an unreadable change there too, so a caller reads one place.
+            const diagnostics = [];
             for (const changeName of available.sort((a, b) => a.localeCompare(b))) {
                 try {
-                    entries.push(loadStatus(changeName));
+                    entries.push(await loadStatusWithTicket(changeName));
                 }
                 catch (error) {
-                    entries.push({ changeName, status: [asStatus(error, 'change_error')] });
+                    const diagnostic = asStatus(error, 'change_error');
+                    entries.push({ changeName, status: [diagnostic] });
+                    diagnostics.push({
+                        ...diagnostic,
+                        code: 'change_unreadable',
+                        message: `Change '${changeName}' could not be read: ${diagnostic.message}`,
+                        target: getChangeDir(planningHome, changeName),
+                        fix: `Fix ${changeName}'s .tospec.yaml, or move the directory out of tospec/changes/.`,
+                    });
                 }
             }
             // `artifacts` is what a loaded status has and a diagnostic entry does not.
@@ -74,8 +105,7 @@ export async function statusCommand(options) {
             if (options.json) {
                 // The full envelope is emitted even on partial failure: dropping the
                 // report to report the failure would lose every change that did load.
-                // Same shape as `validate --all`, which carries per-item issues too.
-                emitSuccess({ changes: entries }, rootOutput);
+                emitSuccess({ changes: entries, ...(diagnostics.length ? { status: diagnostics } : {}) }, rootOutput);
             }
             else {
                 entries.forEach((entry, index) => {
@@ -96,33 +126,34 @@ export async function statusCommand(options) {
             }
             return;
         }
-        // Changes exist but neither --change nor --all was given. Name --all here
-        // too: it is the other way to answer this prompt, and a caller who wants
-        // every change should not have to find it in --help.
+        // Changes exist but neither --change nor --all was given, so name both ways
+        // to answer this prompt.
         throw new Error(`Missing required option --change (or --all for every active change). Available changes:\n  ${available.join('\n  ')}`);
     }
     const changeName = await validateChangeExists(options.change, projectRoot, root.changesDir, { newChangeHint });
-    // Validate schema if explicitly provided
-    if (options.schema) {
-        validateSchemaExists(options.schema, projectRoot);
-    }
-    // loadChangeContext will auto-detect schema from metadata if not provided
-    const status = loadStatus(changeName);
+    // The schema comes from the change's metadata when not given.
     if (options.json) {
-        emitSuccess({ ...status }, rootOutput);
+        emitSuccess({ ...(await loadStatusWithTicket(changeName)) }, rootOutput);
         return;
     }
+    const status = loadStatus(changeName);
     printStatusText(status);
 }
 export function printStatusText(status) {
-    const doneCount = status.artifacts.filter((a) => a.status === 'done').length;
-    const total = status.artifacts.length;
+    // Counted against the same definition `graph.isComplete` uses: an optional
+    // artifact nobody wrote and one the change declared away are not outstanding
+    // work, so counting them prints "Progress: 1/2" above "All artifacts
+    // complete!". One that *was* written reports `done` and counts.
+    const counted = status.artifacts.filter((a) => a.status !== 'optional' && a.status !== 'skipped');
+    const doneCount = counted.filter((a) => a.status === 'done').length;
+    const setAside = status.artifacts.length - counted.length;
     console.log(`Change: ${status.changeName}`);
     console.log(`Schema: ${status.schemaName}`);
     if (status.changeRoot) {
         console.log(`Change root: ${status.changeRoot}`);
     }
-    console.log(`Progress: ${doneCount}/${total} artifacts complete`);
+    const setAsideNote = setAside > 0 ? ` (${setAside} not required)` : '';
+    console.log(`Progress: ${doneCount}/${counted.length} artifacts complete${setAsideNote}`);
     console.log();
     for (const artifact of status.artifacts) {
         const indicator = getStatusIndicator(artifact.status);
@@ -133,6 +164,14 @@ export function printStatusText(status) {
         if (artifact.status === 'stub') {
             line += ' (stub: file exists but is empty or template-identical — fill it in)';
         }
+        // `optional` and `skipped` share a marker; the label says whether writing
+        // it is still on the table.
+        if (artifact.status === 'optional') {
+            line += ' (optional: not written — write it if this change needs it)';
+        }
+        if (artifact.status === 'skipped') {
+            line += ' (skipped: this change declared it away)';
+        }
         console.log(line);
     }
     for (const diagnostic of status.status ?? []) {

package/dist/commands/workflow/status.js.map

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

package/dist/commands/workflow/templates.d.ts

@@ -1,8 +1,9 @@
+/** `tospec templates` — resolved template paths for a schema's artifacts. */
 /**
- * Templates Command
- *
- * Shows resolved template paths for all artifacts in a schema.
+ * The `--json` null-shape. Exported so the commander-level shape table and this
+ * command's own catch block read one object rather than two literals that drift.
  */
+export declare const TEMPLATES_FAILURE_PAYLOAD: Record<string, unknown>;
 export interface TemplatesOptions {
     schema?: string;
     json?: boolean;
@@ -11,6 +12,12 @@ export interface TemplateInfo {
     artifactId: string;
     templatePath: string;
     source: 'project' | 'user' | 'package';
+    /**
+     * False when the schema names a template file that is not on disk. Composing
+     * the path without checking reports success for a path that ENOENTs, while
+     * `instructions` for the same schema fails outright.
+     */
+    exists: boolean;
 }
 export declare function templatesCommand(options: TemplatesOptions): Promise<void>;
 //# sourceMappingURL=templates.d.ts.map

package/dist/commands/workflow/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/commands/workflow/templates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;CACxC;AAMD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiE/E"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/commands/workflow/templates.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAc7E;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAG7D,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;IACvC;;;;OAIG;IACH,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8D/E"}

package/dist/commands/workflow/templates.js

@@ -1,23 +1,25 @@
-/**
- * Templates Command
- *
- * Shows resolved template paths for all artifacts in a schema.
- */
+/** `tospec templates` — resolved template paths for a schema's artifacts. */
 import path from 'path';
-import { resolveSchema, getSchemaDir, ArtifactGraph, } from '../../core/artifact-graph/index.js';
+import * as fs from 'fs';
+import { resolveSchema, getSchemaDirWithSource, ArtifactGraph, } from '../../core/artifact-graph/index.js';
 import { FileSystemUtils } from '../../utils/file-system.js';
 import { validateSchemaExists, DEFAULT_SCHEMA } from './shared.js';
 import { emitSuccess } from '../shared-output.js';
 import { resolveRootForCommand, toRootOutput } from '../../core/root-selection.js';
-// -----------------------------------------------------------------------------
-// Command Implementation
-// -----------------------------------------------------------------------------
+/**
+ * The `--json` null-shape. Exported so the commander-level shape table and this
+ * command's own catch block read one object rather than two literals that drift.
+ */
+export const TEMPLATES_FAILURE_PAYLOAD = {
+    templates: null,
+    root: null,
+};
 export async function templatesCommand(options) {
-    // Same root resolution as every other command — a subdirectory of a
-    // tospec project resolves the project root, not the bare cwd (report 4.3).
+    // Same root resolution as every other command: a subdirectory of a project
+    // resolves the project root, not the bare cwd.
     const root = await resolveRootForCommand(options, {
         json: options.json,
-        failurePayload: { templates: null },
+        failurePayload: TEMPLATES_FAILURE_PAYLOAD,
     });
     if (!root) {
         return;
@@ -26,46 +28,43 @@ export async function templatesCommand(options) {
     const schemaName = validateSchemaExists(options.schema ?? DEFAULT_SCHEMA, projectRoot);
     const schema = resolveSchema(schemaName, projectRoot);
     const graph = ArtifactGraph.fromSchema(schema);
-    const schemaDir = getSchemaDir(schemaName, projectRoot);
-    // Determine the source (project, user, or package)
-    const { getUserSchemasDir, getProjectSchemasDir, } = await import('../../core/artifact-graph/resolver.js');
-    const projectSchemasDir = getProjectSchemasDir(projectRoot);
-    const userSchemasDir = getUserSchemasDir();
-    // Determine source by checking if schemaDir is inside each base directory
-    // Using path.relative is more robust than startsWith for path comparisons
-    const isInsideDir = (child, parent) => {
-        const relative = path.relative(parent, child);
-        return !relative.startsWith('..') && !path.isAbsolute(relative);
-    };
-    let source;
-    if (isInsideDir(schemaDir, projectSchemasDir)) {
-        source = 'project';
-    }
-    else if (isInsideDir(schemaDir, userSchemasDir)) {
-        source = 'user';
-    }
-    else {
-        source = 'package';
-    }
-    const templates = graph.getAllArtifacts().map((artifact) => ({
-        artifactId: artifact.id,
-        templatePath: FileSystemUtils.canonicalizeExistingPath(path.join(schemaDir, 'templates', artifact.template)),
-        source,
+    // The layer comes from the resolver that picked the directory rather than
+    // being re-derived here, so there is only one answer to "which layer won".
+    const { dir: schemaDir, source } = getSchemaDirWithSource(schemaName, projectRoot);
+    const templates = graph.getAllArtifacts().map((artifact) => {
+        const templatePath = path.join(schemaDir, 'templates', artifact.template);
+        return {
+            artifactId: artifact.id,
+            templatePath: FileSystemUtils.canonicalizeExistingPath(templatePath),
+            source,
+            exists: fs.existsSync(templatePath),
+        };
+    });
+    const missing = templates.filter((t) => !t.exists);
+    // Reported, not thrown: the other artifacts' paths are still correct, and
+    // exit stays 0 because nothing the caller asked for failed.
+    const missingDiagnostics = missing.map((t) => ({
+        severity: 'warning',
+        code: 'template_file_missing',
+        message: `Schema '${schemaName}' declares template '${t.artifactId}' at ${t.templatePath}, but that file does not exist. tospec instructions ${t.artifactId} will fail until it is created.`,
     }));
     if (options.json) {
         const output = {};
         for (const t of templates) {
-            output[t.artifactId] = { path: t.templatePath, source: t.source };
+            output[t.artifactId] = { path: t.templatePath, source: t.source, exists: t.exists };
         }
-        emitSuccess({ templates: output }, toRootOutput(root));
+        emitSuccess({ templates: output, ...(missingDiagnostics.length ? { status: missingDiagnostics } : {}) }, toRootOutput(root));
         return;
     }
+    for (const diagnostic of missingDiagnostics) {
+        console.error(`Warning: ${diagnostic.message}`);
+    }
     console.log(`Schema: ${schemaName}`);
     console.log(`Source: ${source}`);
     console.log();
     for (const t of templates) {
         console.log(`${t.artifactId}:`);
-        console.log(`  ${t.templatePath}`);
+        console.log(`  ${t.templatePath}${t.exists ? '' : '  (missing)'}`);
     }
 }
 //# sourceMappingURL=templates.js.map

package/dist/commands/workflow/templates.js.map

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

package/dist/core/archive.d.ts

@@ -1,14 +1,14 @@
 import { formatTimestamp } from '../utils/timestamp.js';
-/**
- * Archive directory names are always CLI-generated from this — agents must
- * never assemble the timestamp themselves. Alias of the shared
- * `formatTimestamp` (ticket filenames use the same helper).
- */
+/** Alias of `formatTimestamp`: agents must never assemble archive stamps by hand. */
 export declare const formatArchiveStamp: typeof formatTimestamp;
 /**
- * Extracts the first `Conclusion: PASS|FAIL` conclusion line from a
- * sync-report.md body, per the format `tospec-sync`'s instruction
- * produces. Returns null when no conclusion line is found (unparseable report).
+ * Returns null when no conclusion is found, when the line is an unfilled
+ * template (`Conclusion: PASS | FAIL`), or when two conclusions disagree —
+ * each must leave the `--require-sync` gate shut.
+ *
+ * Fenced lines are masked because the `tospec-sync` skill documents this format
+ * *inside* a fence: a report quoting the template carries a `Conclusion: PASS`
+ * that was never a verdict.
  */
 export declare function parseSyncReportConclusion(content: string): 'PASS' | 'FAIL' | null;
 export interface ArchiveOptions {
@@ -20,10 +20,9 @@ export interface ArchiveOptions {
     json?: boolean;
 }
 /**
- * Move a directory from src to dest. On Windows, fs.rename() often fails with
- * EPERM when the directory is non-empty or another process has it open (IDE,
- * file watcher, antivirus). Fall back to copy-then-remove when rename fails
- * with EPERM or EXDEV. Exported for migrate's two-phase promotion.
+ * On Windows fs.rename() often fails with EPERM when the directory is non-empty
+ * or another process has it open (IDE, watcher, antivirus), so EPERM/EXDEV fall
+ * back to copy-then-remove. Exported for migrate's two-phase promotion.
  */
 export declare function moveDirectory(src: string, dest: string): Promise<void>;
 /** Like moveDirectory but for a single file (copyFile fallback on Windows EPERM/EXDEV). */
@@ -32,18 +31,24 @@ export declare class ArchiveCommand {
     execute(changeName?: string, options?: ArchiveOptions): Promise<void>;
     private printJsonFailure;
     /**
-     * One archive gate. JSON mode is non-interactive, so a blocked path throws;
-     * human mode prompts; `--yes` downgrades either to a warning. Returns false
-     * when the user declines, and the caller returns null.
-     *
-     * The gates used to be written out longhand at each site and had to stay in
-     * step by hand for the "every blocked path throws in JSON mode" invariant.
+     * One archive gate, so the "every blocked path throws in JSON mode" invariant
+     * lives in one place. JSON mode throws; human mode prompts; `--yes` downgrades
+     * either to a warning. False means the user declined.
      */
     private gate;
     /**
-     * Shared archive flow. In human mode (json=false) prompts and prose match
-     * the historical behavior and cancellations return null. In JSON mode no
-     * prose reaches stdout and every blocked path throws.
+     * Required artifacts the change never produced, in schema order. Reads the
+     * same graph `tospec status` does, so the two cannot disagree about what
+     * "required" means; `skipped` and `optional` are legitimate absences.
+     *
+     * An unloadable graph returns nothing rather than throwing: this gate must not
+     * become a second way for archive to fail. Whatever broke the load is
+     * validation's to report.
+     */
+    private findMissingRequiredArtifacts;
+    /**
+     * Shared archive flow. Human mode prompts and returns null on cancellation;
+     * JSON mode keeps stdout clean and throws from every blocked path.
      */
     private run;
     private selectChange;

package/dist/core/archive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/core/archive.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAQxD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,wBAAkB,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAYjF;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAoDD;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAe5E;AAgED,2FAA2F;AAC3F,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYvE;AAED,qBAAa,cAAc;IACnB,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC9E;IAED,OAAO,CAAC,gBAAgB;IAiBxB;;;;;;;OAOG;YACW,IAAI;IA+BlB;;;;OAIG;YACW,GAAG;YA4YH,YAAY;CAwC3B"}
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/core/archive.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AASxD,qFAAqF;AACrF,eAAO,MAAM,kBAAkB,wBAAkB,CAAC;AAKlD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAoBjF;AASD,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAwDD;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAc5E;AAuDD,2FAA2F;AAC3F,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYvE;AASD,qBAAa,cAAc;IACnB,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC9E;IAED,OAAO,CAAC,gBAAgB;IAiBxB;;;;OAIG;YACW,IAAI;IAiClB;;;;;;;;OAQG;IACH,OAAO,CAAC,4BAA4B;IAqBpC;;;OAGG;YACW,GAAG;YA0fH,YAAY;CAoC3B"}