@aacombarro89/praxis 0.1.0 → 0.1.1

package/README.md

@@ -0,0 +1,126 @@
+# Praxis
+
+**A CLI that installs an AI _methodology layer_ into a codebase** — the
+meta-development rules and authoring recipes that make AI coding agents produce
+correct, conformant work.
+
+Praxis is **not** implementation scaffolding and **not** a config-file
+generator. It writes _only_ the methodology layer — agent-instruction files,
+skills, slash commands, and its own manifest. It never touches your application
+code, dependencies, or runtime infrastructure.
+
+```bash
+npx @aacombarro89/praxis
+```
+
+## What it does
+
+Running `praxis` in a project:
+
+1. **Detects your stack** from project files — `pyproject.toml` /
+   `requirements.txt` / `setup.py` → `python-backend`; `package.json` → `node`;
+   a `react` dependency → both `node` and `react`.
+2. **Offers a first-run fork** — _Quick start_ (recommended defaults, preview
+   the diff, confirm) or _Customize_ (choose stacks, packages, and targets).
+3. **Composes the methodology into your repo** — it merges managed blocks into
+   files like `CLAUDE.md` without clobbering your own content, and records what
+   it did in a visible, committed, hand-editable manifest: `praxis.yaml`.
+
+It always previews a single diff before writing. Git is your undo.
+
+## Why it's different
+
+Compared to `/init`-style tools, Praxis adds two things they lack:
+
+- **A curated, opinionated methodology** — Layer 1 behavioral rules plus Layer 2
+  stack recipes, shipped as composable **packages**.
+- **A composition / merge step** that folds methodology into an _existing_
+  project without overwriting project-specific content.
+
+## The two layers
+
+- **Layer 1 (general, stack-agnostic).** Tool-neutral behavioral rules that
+  reduce common LLM coding mistakes, plus methodology-upkeep commands:
+  `karpathy-claude`, `wiki-memory`, `session-handoff`, `upkeep`,
+  `instruction-upkeep`, `safe-permissions`.
+- **Layer 2 (stack-specific recipes).** Authoring recipes for the stack you're
+  on — `node` (`node-recipes`, `node-testing`), `python-backend`
+  (`python-backend-recipes`, `python-testing`), and `react`
+  (`react-components`, `react-testing`).
+
+## The mental model — imperative entry, declarative truth
+
+This is the `npm install` pattern. One command (`praxis`) does the smart thing
+immediately and records the result in `praxis.yaml`. Thereafter the manifest is
+the source of truth: to customize, **edit `praxis.yaml`, then run `praxis
+sync`**. There is no `add`/`remove` — one obvious way to change things.
+
+```yaml
+# Edit this, then run `praxis sync`.
+version: 1
+methodology: "0.1.0"                 # pinned; `sync` offers to bump
+stacks: [node, react]                # detection-seeded, user-editable
+targets: [claude-code, agents-md]    # which agent files to emit
+packages:
+  - karpathy-claude                  # behavioral rules (Layer 1)
+  - wiki-memory                      # the knowledge-wiki command (Layer 1)
+  - node-recipes                     # Layer 2 craft (stack: node)
+  - react-components                 # Layer 2 craft (stack: react)
+```
+
+New methodology only reaches your repo on an explicit `sync` that bumps the
+pinned version — never behind your back.
+
+## Commands
+
+| Command        | What it does                                                                 |
+|----------------|------------------------------------------------------------------------------|
+| `praxis`       | First-run wizard; apply.                                                      |
+| `praxis sync`  | Reconcile the repo to `praxis.yaml`; offer newer methodology; diff + confirm. |
+| `praxis check` | Dry-run; report drift; non-zero exit for CI.                                  |
+
+`--yes` skips prompts (takes the Quick-start path) for non-interactive/CI use.
+
+## Tool-neutral by construction
+
+The methodology source is singular; Praxis _emits_ per-tool variants from it.
+**Claude Code** (`.claude/rules/`, skills, commands, `settings.json`) and the
+**`agents-md`** flat-file convention (`AGENTS.md`) are built today. Cursor is a
+planned target; Copilot/Windsurf/Roo are deferred until they land.
+
+## "Memory" means the agent's memory, not the app's
+
+In Praxis, _memory_ always refers to the **AI coding tool's** curated,
+file-based instruction layer (`CLAUDE.md`, the knowledge wiki, skills, decision
+notes) — not a runtime memory backend for your application (Mem0, Zep, Letta,
+etc.). Wiring a persistence backend into your app is implementation, and out of
+scope. The most Praxis ships on that topic is a Layer 2 _decision recipe_:
+guidance on whether you need runtime memory and how to choose — never the
+backend itself.
+
+## Developing Praxis
+
+Praxis is a TypeScript/Node CLI, and it self-hosts: it installs its own
+methodology and gates drift in its own CI.
+
+```bash
+npm run typecheck    # tsc --noEmit
+npm run build        # tsc → dist/
+npm test             # vitest over test/
+npm run conformance  # vitest over conformance/
+npm run selfcheck    # praxis check against this repo's emitted files
+```
+
+CI runs all five, in that order, on every push to `main` and every PR. Work
+lands on a feature branch and merges via PR — no direct pushes to `main`.
+
+- `src/` — CLI implementation (emit, sync, merge, manifest, packages,
+  permissions, plugins, anchors, init).
+- `packages/<layer>/<pkg>/` — methodology source (`layer1/`, `layer2/`, plus
+  thin `external/` plugin-marketplace packages).
+- `test/` — unit tests mirroring `src/`. `conformance/` — the CI-gated
+  conformance suite.
+- `docs/wiki/` — the durable, in-repo knowledge wiki and canonical design doc;
+  start at [`docs/wiki/index.md`](docs/wiki/index.md).
+
+See [`CLAUDE.md`](CLAUDE.md) for the project's non-negotiable rails.

package/dist/init.d.ts

@@ -38,8 +38,25 @@ export interface InitPreview {
     manifestYaml: string;
     /** Dry-run emit report: what files init would create/update. */
     report: SyncReport;
+    /**
+     * True when init would write the `.praxis-setup-pending` sentinel (fresh repo
+     * with no `CLAUDE.md` + `claude-code` in targets). WS1 uses this to surface
+     * the pending sentinel in the outro.
+     */
+    willWriteSentinel: boolean;
 }
 /** Compute everything init would do, writing nothing. */
 export declare function previewInit(cwd: string): InitPreview;
-/** Write `praxis.yaml` and apply the methodology files. */
-export declare function applyInit(cwd: string, manifest: Manifest): SyncReport;
+/** The transient sentinel written on fresh installs (D14). The onboarding bootstrap
+ *  rule triggers `/praxis-onboard`, which deletes it when done — one-shot, never
+ *  a managed/synced file. */
+export declare const SETUP_SENTINEL = ".praxis-setup-pending";
+/**
+ * Write the transient `.praxis-setup-pending` sentinel directly (outside the
+ * sync/emit pipeline) so `praxis check` never treats it as drift. Called only
+ * when `!ctx.hasClaudeMd && manifest.targets.includes("claude-code")`.
+ */
+export declare function writeSetupSentinel(cwd: string): void;
+/** Write `praxis.yaml`, apply the methodology files, and — for a fresh
+ *  Claude Code repo with no CLAUDE.md — write the onboarding sentinel (D14). */
+export declare function applyInit(cwd: string, manifest: Manifest, ctx: Pick<InitContext, "hasClaudeMd">): SyncReport;

package/dist/init.js

@@ -111,13 +111,43 @@ export function previewInit(cwd) {
         manifest,
         manifestYaml: renderManifestYaml(manifest),
         report: applyManifest(manifest, cwd, false),
+        willWriteSentinel: !ctx.hasClaudeMd && manifest.targets.includes("claude-code"),
     };
 }
-/** Write `praxis.yaml` and apply the methodology files. */
-export function applyInit(cwd, manifest) {
+/** The transient sentinel written on fresh installs (D14). The onboarding bootstrap
+ *  rule triggers `/praxis-onboard`, which deletes it when done — one-shot, never
+ *  a managed/synced file. */
+export const SETUP_SENTINEL = ".praxis-setup-pending";
+const SENTINEL_CONTENT = `# .praxis-setup-pending
+#
+# This file was written by \`praxis init\` to signal that project-owned sections
+# of CLAUDE.md haven't been authored yet for this fresh install.
+#
+# At the start of the next session your AI coding agent will offer to run
+# /praxis-onboard, which guides you through writing the build/run/test commands,
+# project layout, conventions, and always-do rules for this repo.
+#
+# /praxis-onboard deletes this file when it finishes — making onboarding
+# one-shot. You can also delete this file yourself to skip onboarding.
+`;
+/**
+ * Write the transient `.praxis-setup-pending` sentinel directly (outside the
+ * sync/emit pipeline) so `praxis check` never treats it as drift. Called only
+ * when `!ctx.hasClaudeMd && manifest.targets.includes("claude-code")`.
+ */
+export function writeSetupSentinel(cwd) {
+    writeFileSync(join(cwd, SETUP_SENTINEL), SENTINEL_CONTENT, "utf8");
+}
+/** Write `praxis.yaml`, apply the methodology files, and — for a fresh
+ *  Claude Code repo with no CLAUDE.md — write the onboarding sentinel (D14). */
+export function applyInit(cwd, manifest, ctx) {
     const path = join(cwd, MANIFEST_FILE);
     mkdirSync(dirname(path), { recursive: true });
     writeFileSync(path, renderManifestYaml(manifest), "utf8");
-    return applyManifest(manifest, cwd, true);
+    const report = applyManifest(manifest, cwd, true);
+    if (!ctx.hasClaudeMd && manifest.targets.includes("claude-code")) {
+        writeSetupSentinel(cwd);
+    }
+    return report;
 }
 //# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAA0C,MAAM,eAAe,CAAC;AACpG,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,aAAa,EAAmB,MAAM,WAAW,CAAC;AAqB3D,MAAM,aAAa,GAAG,aAAa,CAAC;AAEpC,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,GAAG,GAAG,CAAC,GAAW,EAAW,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAEjE,MAAM,MAAM,GAAY,EAAE,CAAC;IAE3B,gEAAgE;IAChE,IAAI,GAAG,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,kBAAkB,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QACxE,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAChC,CAAC;IAED,6BAA6B;IAC7B,IAAI,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;QACxB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEpB,qEAAqE;QACrE,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC;YAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAGzB,CAAC;YACF,MAAM,IAAI,GAAG,EAAE,GAAG,GAAG,CAAC,YAAY,EAAE,GAAG,GAAG,CAAC,eAAe,EAAE,CAAC;YAC7D,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;gBACpB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,2EAA2E;QAC7E,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzD,OAAO;QACL,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC;QACnB,WAAW,EAAE,GAAG,CAAC,WAAW,CAAC;QAC7B,WAAW,EAAE,GAAG,CAAC,WAAW,CAAC;QAC7B,cAAc,EAAE,GAAG,CAAC,aAAa,CAAC;QAClC,cAAc,EAAE,OAAO;KACxB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,GAAgB;IAC9C,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;IAChC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAEhD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;QAC9B,IAAI,GAAG,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;aAAM,IAAI,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7E,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QACD,mDAAmD;IACrD,CAAC;IAED,MAAM,CAAC,IAAI,EAAE,CAAC;IACd,MAAM,CAAC,IAAI,EAAE,CAAC;IAEd,MAAM,QAAQ,GAAa;QACzB,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,mBAAmB;QAChC,OAAO,EAAE,CAAC,aAAa,EAAE,WAAW,CAAC;QACrC,QAAQ,EAAE,CAAC,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC;KACjC,CAAC;IACF,IAAI,GAAG,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,cAAc,CAAC;IACvC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAe,EACf,QAAkB,EAClB,OAAiB;IAEjB,MAAM,QAAQ,GAAa;QACzB,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,mBAAmB;QAChC,OAAO;QACP,QAAQ;KACT,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC;IAC3B,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;8DAC8D;AAC9D,MAAM,UAAU,kBAAkB,CAAC,QAAkB;IACnD,MAAM,KAAK,GAAG;QACZ,iFAAiF;QACjF,oEAAoE;QACpE,YAAY,QAAQ,CAAC,OAAO,EAAE;QAC9B,iBAAiB,QAAQ,CAAC,WAAW,GAAG;KACzC,CAAC;IACF,IAAI,QAAQ,CAAC,MAAM,EAAE,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnF,KAAK,CAAC,IAAI,CAAC,aAAa,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxD,KAAK,CAAC,IAAI,CAAC,cAAc,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1D,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;AAgBD,yDAAyD;AACzD,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACtC,OAAO;QACL,GAAG;QACH,QAAQ;QACR,YAAY,EAAE,kBAAkB,CAAC,QAAQ,CAAC;QAC1C,MAAM,EAAE,aAAa,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC;QAC3C,iBAAiB,EAAE,CAAC,GAAG,CAAC,WAAW,IAAI,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;KAChF,CAAC;AACJ,CAAC;AAED;;6BAE6B;AAC7B,MAAM,CAAC,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAEtD,MAAM,gBAAgB,GAAG;;;;;;;;;;;CAWxB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;AACrE,CAAC;AAED;gFACgF;AAChF,MAAM,UAAU,SAAS,CACvB,GAAW,EACX,QAAkB,EAClB,GAAqC;IAErC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IACtC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAClD,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACjE,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/program.js

@@ -161,7 +161,10 @@ async function runInit(opts) {
         const manifestYaml = renderManifestYaml(manifest);
         const report = applyManifest(manifest, cwd, false);
         note(manifestYaml.trimEnd(), "praxis.yaml (proposed)");
-        note(formatPlan(report, "init"), "Will write");
+        const freshHarness = !ctx.hasClaudeMd && manifest.targets.includes("claude-code");
+        const willWritePlan = formatPlan(report, "init");
+        const sentinelLine = freshHarness ? "\n  + .praxis-setup-pending  (onboarding sentinel)" : "";
+        note(willWritePlan + sentinelLine, "Will write");
         if (!opts.yes) {
             const ok = await confirm({ message: "Apply these changes?" });
             if (isCancel(ok) || !ok) {
@@ -169,8 +172,34 @@ async function runInit(opts) {
                 return;
             }
         }
-        applyInit(cwd, manifest);
-        outro("Done. Run `praxis check` anytime to verify the repo is in sync.");
+        applyInit(cwd, manifest, ctx);
+        const SKILLS = "/praxis-instructions  /praxis-wiki  /praxis-handoff\n  /praxis-upkeep  /praxis-onboard";
+        if (freshHarness) {
+            note([
+                "Open Claude Code in this repo.",
+                "It will offer to run /praxis-onboard automatically (one-shot bootstrap).",
+                "Or run /init then /praxis-onboard yourself to author project facts.",
+                "",
+                "Installed skills:",
+                `  ${SKILLS}`,
+                "",
+                "Run `praxis check` anytime to verify the repo is in sync (good for CI).",
+            ].join("\n"), "Next steps");
+            outro("Methodology layer installed. Open Claude Code to complete onboarding.");
+        }
+        else {
+            note([
+                "Your CLAUDE.md was left untouched (existing harness preserved).",
+                ".claude/rules load automatically — no edits needed.",
+                "",
+                "Installed skills:",
+                `  ${SKILLS}`,
+                "",
+                "To tune: edit `praxis.yaml`, then run `praxis sync`.",
+                "Run `praxis check` anytime to verify the repo is in sync (good for CI).",
+            ].join("\n"), "Next steps");
+            outro("Methodology layer installed.");
+        }
     }
     catch (err) {
         cancel(`praxis: ${err.message}`);

package/dist/program.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aacombarro89/praxis",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A CLI that installs an AI methodology layer into a codebase.",
   "type": "module",
   "bin": {

package/packages/layer1/instruction-upkeep/commands/{audit.md → instructions.md}

@@ -1,10 +1,10 @@
 ---
-description: Audit the authored instruction files (CLAUDE.md, .claude/rules) against the project's current state and bring them back in line.
+description: Keep the authored instruction files (CLAUDE.md, .claude/rules) current with the project's state and complete against the standard rubric.
 ---
 
-Audit scope: $ARGUMENTS
+Scope: $ARGUMENTS
 
-This audits the **authored instruction layer** — `CLAUDE.md` and
+This updates the **authored instruction layer** — `CLAUDE.md` and
 `.claude/rules` — not the tool's native auto-memory and not any 3rd-party
 agent-memory system. Those are out of scope.
 

package/packages/layer1/instruction-upkeep/package.yaml

@@ -1,5 +1,5 @@
 # Package manifest (docs/wiki/packages-and-emit.md, D20). This package provides a standing
-# reminder (rules.md) plus the /praxis-audit command (commands/audit.md) that
+# reminder (rules.md) plus the /praxis-instructions command (commands/instructions.md) that
 # keeps the authored instruction layer (CLAUDE.md, .claude/rules) current —
 # never the tool's native auto-memory, never a 3rd-party memory system
 # (docs/wiki/onboarding.md).

package/packages/layer1/instruction-upkeep/rules.md

@@ -13,9 +13,12 @@ and complete:
   a fact that isn't backed by the code, config, or the user's answer.
 - Prefer linking a canonical source (e.g. an architecture doc) over restating
   its facts — restated facts drift independently of their source.
+- If a *derived overview* like `README.md` exists, check it hasn't drifted from
+  its canonical sources — being a restatement of them, it drifts by
+  construction; reconcile it to the source rather than the reverse.
 - When instruction files include `praxisAnchors` frontmatter, keep those anchors
   resolving. `praxis check` hard-fails broken `path`, `command`, and `section`
   anchors; staleness signals are future advisory work.
-- Make instruction-layer changes through `/praxis-audit`, not ad-hoc edits — run
+- Make instruction-layer changes through `/praxis-instructions`, not ad-hoc edits — run
   it when unsure whether the instruction files still match the project, or whether
   they cover the sections above.

package/packages/layer1/onboarding/commands/onboard.md

@@ -0,0 +1,59 @@
+---
+description: Author the project-owned sections of CLAUDE.md for a fresh Praxis install — build/run/test commands, layout, conventions, and always-do rules. One-shot: deletes .praxis-setup-pending when done.
+---
+
+Scope: $ARGUMENTS
+
+This authors the **project-owned** sections of `CLAUDE.md` — not the
+methodology layer (that is managed by Praxis's owned `.claude/rules/` files).
+Praxis never calls an LLM (D12); never edits `CLAUDE.md` directly (D13). The
+**agent** writes the facts, guided by the steps below, asking the user for
+anything it cannot infer.
+
+1. **Bulk discovery — lean on the tool's native `/init` first.** If `CLAUDE.md`
+   does not yet exist (or is empty), suggest running the tool's built-in `/init`
+   command so the model can auto-discover repository facts (files, build config,
+   README). Incorporate any useful output into the project-owned sections below,
+   rather than restating it from scratch.
+
+2. **Check detected stacks (if known).** Read `praxis.yaml` for the `stacks:`
+   field. If stacks are declared, tailor the sections below to those stacks (e.g.
+   for `node`, prefer `npm run …` commands; for `python-backend`, prefer `pytest`
+   / `poetry` patterns; for `react`, note the dev server and component test
+   runner). Never invent stack facts — confirm them from config files
+   (`package.json`, `pyproject.toml`, etc.).
+
+3. **Author the four rubric sections.** For each section, read the project's
+   config files and recent git history, then write only what is verifiably true.
+   Ask the user before adding anything that isn't clear from the code:
+
+   - **Build / test / run commands** — the exact commands to typecheck, build,
+     run the test suite, and start the app. Include any CI commands that differ
+     from local. Never guess; confirm from `package.json` scripts, `Makefile`,
+     `pyproject.toml`, etc.
+   - **Project layout** — key directories and their purpose. One sentence per
+     entry is enough; link canonical docs rather than restating their content.
+   - **Key conventions** — branch/PR flow, what a change must ship with (tests,
+     docs update, etc.), naming conventions, anything a newcomer would violate.
+   - **Always-do rules** — the small set of non-negotiable habits (e.g. "run
+     `praxis check` before pushing", "never commit secrets"). Keep this list
+     short; a long always-do list is never read.
+
+4. **Ask the user for anything not inferable.** If a section can't be filled from
+   config files, git history, or the `/init` output, ask a targeted question
+   rather than inventing a plausible answer. Content inclusion bar: a fact only
+   enters if it's backed by the code, config, a canonical doc, or the user.
+
+5. **Write only project-owned content.** Never put content inside a Praxis
+   managed block (a `<!-- praxis-start … -->` / `<!-- praxis-end … -->` region).
+   Project facts belong in the free-prose sections the author controls; Praxis
+   owns only its own managed blocks.
+
+6. **Delete `.praxis-setup-pending`** to make this one-shot. Once the rubric
+   sections are authored and the user is satisfied, remove the sentinel file
+   from the repo root. This prevents the bootstrap rule (`.claude/rules/
+   praxis-onboarding.md`) from re-offering onboarding on the next session.
+
+7. **Report what was written / left.** Summarise which rubric sections were
+   filled, which were left empty (and why — e.g. "no build step detected"), and
+   any follow-up items for the user.

package/packages/layer1/onboarding/package.yaml

@@ -0,0 +1,8 @@
+# Package manifest (docs/wiki/packages-and-emit.md, D20). This package provides a bootstrap
+# rule (rules.md) that self-terminates after first-run onboarding, and the /praxis-onboard
+# command (commands/onboard.md) that guides the agent through authoring project facts
+# (build/run/test, layout, conventions) — never authoring them directly (D12/D13).
+# Part of the D14 onboarding mechanism (docs/wiki/onboarding.md).
+name: onboarding
+layer: layer1
+provides: [rules, commands]

package/packages/layer1/onboarding/rules.md

@@ -0,0 +1,14 @@
+## First-run onboarding
+
+At the start of work, check for the `.praxis-setup-pending` sentinel file in
+the repo root. Its presence means this is a fresh Praxis install and the
+project-owned sections of `CLAUDE.md` haven't been authored yet.
+
+- **If the sentinel is present:** offer to run `/praxis-onboard`. Once the
+  skill completes it deletes the sentinel — making this check one-shot and
+  self-terminating. Never nag when the sentinel is absent.
+- **If the sentinel is absent:** do nothing here. The ongoing instruction
+  upkeep path (`/praxis-instructions`) handles currency after initial setup.
+
+Cross-references: `/praxis-onboard` (first-run authoring),
+`/praxis-instructions` (ongoing upkeep — D22/D23, [onboarding](../../../docs/wiki/onboarding.md)).

package/packages/layer1/upkeep/commands/upkeep.md

@@ -17,7 +17,7 @@ independently of its canonical home.
    conflicts or broken anchors, surface them as-is. This step needs no LLM
    judgment — do it first so the semantic passes below build on a known-good
    baseline.
-2. **Instruction layer.** Perform the audit defined by `/praxis-audit`,
+2. **Instruction layer.** Perform the update defined by `/praxis-instructions`,
    scoped to the focus above. Follow that command's own steps; do not
    re-derive them here.
 3. **Wiki.** Perform the wiki maintenance defined by `/praxis-wiki`, scoped to

package/packages/layer1/upkeep/package.yaml

@@ -1,7 +1,7 @@
 # Package manifest (docs/wiki/packages-and-emit.md, D29). Ships a standing reminder
 # (rules.md) plus the /praxis-upkeep command (commands/upkeep.md): one entry point
 # that runs the deterministic `praxis check` drift gate and then both semantic-drift
-# passes — the instruction-layer audit (/praxis-audit) and the wiki lint
+# passes — the instruction-layer update (/praxis-instructions) and the wiki lint
 # (/praxis-wiki Phase 4) — and reports one consolidated result. Layer 1 /
 # stack- & tool-agnostic; defers to those two commands rather than restating
 # their steps, so the detail can't drift independently of its canonical home.

package/packages/layer1/upkeep/rules.md

@@ -7,6 +7,6 @@ longer matches the code, an unsynced emit — or when work produces new durable
 knowledge to file (a decision, a new package), run `/praxis-upkeep` rather than
 letting the gap persist, fixing it ad hoc, or invoking the sub-skills piecemeal.
 It is the single front gate: it sequences `praxis check` and fully delegates to
-`/praxis-audit` (instruction layer) and `/praxis-wiki` (knowledge wiki). The
+`/praxis-instructions` (instruction layer) and `/praxis-wiki` (knowledge wiki). The
 command itself only sequences and reports; the sub-skills make any edits, each
 behind its own confirmation gate.

package/packages/layer1/wiki-memory/commands/wiki.md

@@ -11,7 +11,7 @@ of long-lived knowledge that a future session reads instead of re-deriving. This
 is the agent's cross-session memory **of the project** — version-controlled and
 shared with the team. It is NOT a per-session handoff (transient — that is
 `/praxis-handoff`) and NOT the authored instruction layer (`CLAUDE.md`,
-`.claude/rules` — that is `/praxis-audit`).
+`.claude/rules` — that is `/praxis-instructions`).
 
 The wiki has two kinds of durable knowledge:
 - **Derived summaries** compress code, config, and canonical docs. The underlying
@@ -81,7 +81,7 @@ Health-check the wiki and fix what you can (ask before large deletions):
 - **Contradictions** — derived summaries that disagree with current code/config
   lose to the source; fix the wiki. Canonical-intent entries are different: if
   code and intent diverge, report the drift and route it to a decision/update
-  step (or `/praxis-audit` for instruction-layer changes) instead of deciding
+  step (or `/praxis-instructions` for instruction-layer changes) instead of deciding
   automatically. Two wiki entries that disagree resolve to the more recent /
   authoritative / better-supported claim, with the resolution noted.
 - **Stale claims** — derived facts the current code has invalidated: fix or

package/dist/external.d.ts

@@ -1,61 +0,0 @@
-import { z } from "zod";
-import type { Manifest, Target } from "./manifest.js";
-declare const lockEntrySchema: z.ZodObject<{
-    name: z.ZodString;
-    spec: z.ZodArray<z.ZodString>;
-    targets: z.ZodArray<z.ZodString>;
-}, z.core.$strict>;
-declare const lockSchema: z.ZodObject<{
-    version: z.ZodLiteral<1>;
-    installed: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        name: z.ZodString;
-        spec: z.ZodArray<z.ZodString>;
-        targets: z.ZodArray<z.ZodString>;
-    }, z.core.$strict>>>;
-}, z.core.$strict>;
-export type LockEntry = z.infer<typeof lockEntrySchema>;
-export type Lock = z.infer<typeof lockSchema>;
-export declare const EMPTY_LOCK: Lock;
-export type ExternalActionKind = "install" | "reinstall" | "skip" | "orphan";
-export interface ExternalAction {
-    kind: ExternalActionKind;
-    name: string;
-    /** Targets the action applies to (the intersection of manifest.targets and
-     *  the package's declared external.targets — empty if fully quarantined out). */
-    targets: Target[];
-    /** argv to run for install/reinstall; the declared uninstall argv for
-     *  orphan (undefined if the package declared none — warn-only removal). */
-    command?: string[];
-}
-/**
- * Decide what `sync` would do with every selected external package, against
- * the current lock. Pure: the lock is injected so this is testable without
- * disk, and it performs no execution itself.
- *
- * - `install`: no lock entry for this package yet.
- * - `reinstall`: lock entry exists but its spec/targets no longer match the
- *   package's current declaration (the manifest changed under it).
- * - `skip`: lock entry matches exactly — idempotent no-op.
- * - `orphan`: a lock entry exists for a package no longer selected (or with
- *   no targets left after quarantine) — offer to remove, never silently.
- */
-export declare function planExternal(manifest: Manifest, lock: Lock): ExternalAction[];
-/** Runs one argv in `cwd`. The real implementation for `executeAction`'s
- *  injected runner — uses `execFileSync` (argv form, no shell string) so
- *  there is no pipe/shell-injection surface from a pinned command. */
-export declare function runCommand(command: string[], cwd: string): void;
-export type CommandRunner = (command: string[], cwd: string) => void;
-/** Execute one planned action via the injected runner. Tests pass a stub
- *  runner so they never actually shell out. No-op for `skip`, and for
- *  `orphan` when the package declared no `uninstall` (Praxis doesn't own
- *  those files and never deletes them on the user's behalf). */
-export declare function executeAction(action: ExternalAction, cwd: string, runner?: CommandRunner): void;
-/** Read `praxis-external.lock` from `cwd`, or the empty lock if absent. */
-export declare function readLock(cwd: string): Lock;
-/** Apply a list of executed actions to a lock, returning the next lock.
- *  Pure — the caller decides whether/when to persist it. */
-export declare function applyActionsToLock(lock: Lock, actions: ExternalAction[]): Lock;
-/** Persist the lock to `praxis-external.lock` at `cwd`, sorted for a stable
- *  diff (deterministic, reviewable — no timestamps anywhere in the file). */
-export declare function writeLock(cwd: string, lock: Lock): void;
-export {};

package/dist/external.js

@@ -1,155 +0,0 @@
-import { execFileSync } from "node:child_process";
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-import { z } from "zod";
-import { resolvePackages } from "./packages.js";
-/**
- * External installer packages (docs/wiki/external-packages.md, the bounded
- * execution relaxation — see docs/wiki/decisions.md). A "rules"/"permissions"/
- * "commands" package ships tool-neutral source that the *pure* emit pipeline
- * (src/emit.ts) translates and writes. An "external" package ships no source
- * at all — only a pinned install command that some other tool (npx/git) runs
- * to drop its own already-tool-shaped files into the methodology layer (e.g.
- * `.claude/skills/…`).
- *
- * That's side-effecting and untranslatable, so it never becomes an `EmitOp`.
- * This module is the separate, explicit seam: `planExternal` decides *what*
- * would happen (pure, no I/O — same plan/apply split as src/emit.ts +
- * src/sync.ts), and `executeAction` is the one place that actually shells out,
- * with the runner injected so tests never really execute a command.
- */
-const LOCK_FILE = "praxis-external.lock";
-// One row per (package, target) pair Praxis has installed. No timestamps —
-// the pinned spec is the whole identity, so the lock is stable in git and
-// re-syncing is deterministic: same spec ⇒ same action.
-const lockEntrySchema = z.strictObject({
-    name: z.string().min(1),
-    spec: z.array(z.string().min(1)).min(1),
-    targets: z.array(z.string().min(1)).min(1),
-});
-const lockSchema = z.strictObject({
-    version: z.literal(1),
-    installed: z.array(lockEntrySchema).default([]),
-});
-export const EMPTY_LOCK = { version: 1, installed: [] };
-/**
- * Decide what `sync` would do with every selected external package, against
- * the current lock. Pure: the lock is injected so this is testable without
- * disk, and it performs no execution itself.
- *
- * - `install`: no lock entry for this package yet.
- * - `reinstall`: lock entry exists but its spec/targets no longer match the
- *   package's current declaration (the manifest changed under it).
- * - `skip`: lock entry matches exactly — idempotent no-op.
- * - `orphan`: a lock entry exists for a package no longer selected (or with
- *   no targets left after quarantine) — offer to remove, never silently.
- */
-export function planExternal(manifest, lock) {
-    const packages = resolvePackages(manifest.packages).filter((p) => p.provides.includes("external"));
-    const manifestTargets = new Set(manifest.targets);
-    const actions = [];
-    const seen = new Set();
-    for (const pkg of packages) {
-        const block = pkg.external;
-        if (!block)
-            continue; // schema guarantees this is unreachable; guard for type-narrowing only
-        const targets = block.targets.filter((t) => manifestTargets.has(t));
-        seen.add(pkg.name);
-        const existing = lock.installed.find((e) => e.name === pkg.name);
-        if (targets.length === 0) {
-            // Fully quarantined out for this manifest's targets: nothing to run. If a
-            // prior sync installed it for targets no longer selected, that's an orphan.
-            if (existing) {
-                actions.push({ kind: "orphan", name: pkg.name, targets: existing.targets, command: block.uninstall });
-            }
-            continue;
-        }
-        if (!existing) {
-            actions.push({ kind: "install", name: pkg.name, targets, command: block.command });
-            continue;
-        }
-        const specMatches = arraysEqual(existing.spec, block.command) && arraysEqual([...existing.targets].sort(), [...targets].sort());
-        actions.push(specMatches
-            ? { kind: "skip", name: pkg.name, targets }
-            : { kind: "reinstall", name: pkg.name, targets, command: block.command });
-    }
-    // Lock entries for packages no longer selected at all are orphans too.
-    for (const entry of lock.installed) {
-        if (seen.has(entry.name))
-            continue;
-        const uninstall = lookupUninstall(entry.name);
-        actions.push({ kind: "orphan", name: entry.name, targets: entry.targets, command: uninstall });
-    }
-    return actions;
-}
-/** Look up a previously-installed package's declared uninstall argv, if the
- *  package is still discoverable (it may have been removed entirely from
- *  `packages/external/`, in which case removal stays warn-only). */
-function lookupUninstall(name) {
-    try {
-        return resolvePackages([name])[0]?.external?.uninstall;
-    }
-    catch {
-        return undefined;
-    }
-}
-function arraysEqual(a, b) {
-    return a.length === b.length && a.every((v, i) => v === b[i]);
-}
-/** Runs one argv in `cwd`. The real implementation for `executeAction`'s
- *  injected runner — uses `execFileSync` (argv form, no shell string) so
- *  there is no pipe/shell-injection surface from a pinned command. */
-export function runCommand(command, cwd) {
-    if (command.length === 0)
-        throw new Error("runCommand: empty argv");
-    const [bin, ...args] = command;
-    execFileSync(bin, args, { cwd, stdio: "inherit" });
-}
-/** Execute one planned action via the injected runner. Tests pass a stub
- *  runner so they never actually shell out. No-op for `skip`, and for
- *  `orphan` when the package declared no `uninstall` (Praxis doesn't own
- *  those files and never deletes them on the user's behalf). */
-export function executeAction(action, cwd, runner = runCommand) {
-    if (action.kind === "skip")
-        return;
-    if (action.kind === "orphan" && !action.command)
-        return; // warn-only; caller reports it
-    if (!action.command)
-        return;
-    runner(action.command, cwd);
-}
-/** Read `praxis-external.lock` from `cwd`, or the empty lock if absent. */
-export function readLock(cwd) {
-    const path = join(cwd, LOCK_FILE);
-    if (!existsSync(path))
-        return EMPTY_LOCK;
-    const raw = JSON.parse(readFileSync(path, "utf8"));
-    return lockSchema.parse(raw);
-}
-/** Apply a list of executed actions to a lock, returning the next lock.
- *  Pure — the caller decides whether/when to persist it. */
-export function applyActionsToLock(lock, actions) {
-    let installed = lock.installed;
-    for (const action of actions) {
-        if (action.kind === "install" || action.kind === "reinstall") {
-            installed = [
-                ...installed.filter((e) => e.name !== action.name),
-                { name: action.name, spec: action.command ?? [], targets: action.targets },
-            ];
-        }
-        else if (action.kind === "orphan") {
-            installed = installed.filter((e) => e.name !== action.name);
-        }
-    }
-    return { version: 1, installed };
-}
-/** Persist the lock to `praxis-external.lock` at `cwd`, sorted for a stable
- *  diff (deterministic, reviewable — no timestamps anywhere in the file). */
-export function writeLock(cwd, lock) {
-    const sorted = {
-        version: 1,
-        installed: [...lock.installed].sort((a, b) => a.name.localeCompare(b.name)),
-    };
-    writeFileSync(join(cwd, LOCK_FILE), `${JSON.stringify(sorted, null, 2)}\n`, "utf8");
-}
-//# sourceMappingURL=external.js.map

package/dist/external.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"external.js","sourceRoot":"","sources":["../src/external.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;;;;;;;;;;;GAcG;AAEH,MAAM,SAAS,GAAG,sBAAsB,CAAC;AAEzC,2EAA2E;AAC3E,0EAA0E;AAC1E,wDAAwD;AACxD,MAAM,eAAe,GAAG,CAAC,CAAC,YAAY,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CAC3C,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG,CAAC,CAAC,YAAY,CAAC;IAChC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAChD,CAAC,CAAC;AAKH,MAAM,CAAC,MAAM,UAAU,GAAS,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;AAe9D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,QAAkB,EAAE,IAAU;IACzD,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IACnG,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC;QAC3B,IAAI,CAAC,KAAK;YAAE,SAAS,CAAC,uEAAuE;QAC7F,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,CAAW,CAAC,CAAC,CAAC;QAC3F,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEnB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,0EAA0E;YAC1E,4EAA4E;YAC5E,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAmB,EAAE,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;YACpH,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACnF,SAAS;QACX,CAAC;QAED,MAAM,WAAW,GACf,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9G,OAAO,CAAC,IAAI,CACV,WAAW;YACT,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE;YAC3C,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAC3E,CAAC;IACJ,CAAC;IAED,uEAAuE;IACvE,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,SAAS;QACnC,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAmB,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7G,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;oEAEoE;AACpE,SAAS,eAAe,CAAC,IAAY;IACnC,IAAI,CAAC;QACH,OAAO,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,CAAW,EAAE,CAAW;IAC3C,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AAED;;sEAEsE;AACtE,MAAM,UAAU,UAAU,CAAC,OAAiB,EAAE,GAAW;IACvD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACpE,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC;IAC/B,YAAY,CAAC,GAAa,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;AAC/D,CAAC;AAID;;;gEAGgE;AAChE,MAAM,UAAU,aAAa,CAAC,MAAsB,EAAE,GAAW,EAAE,SAAwB,UAAU;IACnG,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO;IACnC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,CAAC,+BAA+B;IACxF,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO;IAC5B,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AAC9B,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAClC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,UAAU,CAAC;IACzC,MAAM,GAAG,GAAY,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5D,OAAO,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED;4DAC4D;AAC5D,MAAM,UAAU,kBAAkB,CAAC,IAAU,EAAE,OAAyB;IACtE,IAAI,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAC/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC7D,SAAS,GAAG;gBACV,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC;gBAClD,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE;aAC3E,CAAC;QACJ,CAAC;aAAM,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACpC,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC;AACnC,CAAC;AAED;6EAC6E;AAC7E,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,IAAU;IAC/C,MAAM,MAAM,GAAS;QACnB,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;KAC5E,CAAC;IACF,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACtF,CAAC"}