@aacombarro89/praxis 0.1.11 → 0.1.13

package/packages/layer2/workspace/commands/workspace-upkeep.md

@@ -0,0 +1,56 @@
+---
+description: Hub-sovereign workspace upkeep — audit this hub and its cloned members, report drift and proposed edits, and apply only what the user confirms.
+argument-hint: [optional-member-or-area-to-focus]
+allowed-tools: Read, Glob, Bash(git log:*), Bash(npx @aacombarro89/praxis@latest check:*), Bash(npx @aacombarro89/praxis@latest sync:*), Bash(npx @aacombarro89/praxis check:*), Bash(npx @aacombarro89/praxis sync:*), Bash(praxis check:*), Bash(praxis sync:*)
+---
+
+Focus: {{arguments}} — if empty, cover the whole workspace at a high level.
+
+This is the hub-sovereign upkeep pass for a Praxis **workspace**: a meta-repo
+with independent git repos cloned beneath it. It sequences the hub's own
+upkeep, keeps the hub wiki's cross-repo knowledge current, fans work out to
+cloned members in **audit mode only**, and never edits a member repo without
+the user's explicit confirmation.
+
+1. **Read the workspace** from `praxis.yaml`'s `workspace:` section (members,
+   edges, contract pages). If it is absent, say so and stop — this command is
+   for a workspace hub only. Note any member whose directory isn't cloned yet;
+   skip it in the steps below and point at that repo's own clone/setup script
+   if one exists — never invent one.
+
+2. **Hub pass.** Perform `{{workflow:praxis-upkeep}}` for this repo. Its
+   `praxis check` output now includes member-anchor skips and the `Workspace:`
+   status line for this hub — read them, don't just exit-code them.
+
+3. **Workspace wiki currency.** Ensure the hub wiki has a system-map page (a
+   member table, the dependency edges, a contract-page index, cross-repo change
+   order, and an add-a-member checklist) consistent with `workspace:` in
+   `praxis.yaml` — the manifest is the source of truth for membership and
+   edges; the wiki holds the prose and contracts. Anchor member references with
+   `member:` anchors so `praxis check` trips on drift. This is wiki work: follow
+   `{{workflow:praxis-wiki}}`'s own conventions and confirmation gate before
+   creating or editing pages.
+
+4. **Member fan-out (report-first).** For each **cloned** member, produce a
+   per-member brief with `{{workflow:praxis-handoff}}` and delegate one
+   workstream per member — where the tool lacks subagent spawning, execute the
+   briefs sequentially instead. Each delegate works inside that member's own
+   directory, reads that repo's own agent instructions and rules first, then
+   runs its upkeep in **audit mode**: run `praxis check` there, assess
+   instruction/wiki currency, and **return proposed edits without applying
+   them**. Also have it flag any duplicated cross-repo integration prose that
+   belongs in the hub's contract pages instead.
+
+5. **Edge-based staleness judgment.** For each member with changes since its
+   relevant contract page was last touched (compare via `git log`), walk
+   `edges` where that member is the producer (`from`) and name each downstream
+   member plus its contract page as *likely stale* — a candidate for review,
+   not proof.
+
+6. **Consolidated report + apply opt-in.** Report: hub status; a per-member
+   table (cloned / onboarded / check result); proposed edits per member;
+   likely-stale contract pages; and a recommendation of the form "run
+   `{{workflow:praxis-upkeep}}` in `<member>`" for any member whose own upkeep
+   needs running. On explicit user confirmation, re-delegate to apply the
+   confirmed subset per member, so the user can review each member's own git
+   diff. Never edit a member's files without that confirmation.

package/packages/layer2/workspace/package.yaml

@@ -0,0 +1,14 @@
+# Package manifest (docs/wiki/packages-and-emit.md, D53). Ships a standing
+# reminder (rules.md) plus the /praxis-workspace-upkeep command
+# (commands/workspace-upkeep.md): hub-sovereign upkeep for a Praxis workspace —
+# a meta-repo with N independent git repos cloned beneath it, declared in this
+# repo's own `workspace:` praxis.yaml section. Gated on the `workspace`
+# pseudo-stack, which is derived from that section (never user-declarable in
+# `stacks:`, src/manifest.ts/src/packages.ts), so it never lands in an ordinary
+# repo. Requires wiki-memory/upkeep/session-handoff (D21): the command
+# delegates to all three rather than restating their steps.
+name: workspace
+layer: layer2
+stack: workspace
+provides: [rules, commands]
+requires: [wiki-memory, upkeep, session-handoff]

package/packages/layer2/workspace/rules.md

@@ -0,0 +1,17 @@
+## Workspace hub (Layer 2)
+
+This repo is a Praxis **workspace hub**: `workspace:` in `praxis.yaml` declares
+the member repos cloned beneath it and the dependency edges between them.
+
+Cross-repo knowledge — dependency edges, API contracts between members,
+cross-repo change order, the add-a-new-member checklist — lives in **this
+repo's wiki**, never duplicated into member wikis; members carry at most prose
+pointers up to it.
+
+Trigger: after any change with cross-repo impact (a producer API change, a new
+member, an edge change), or on a periodic sweep, run
+`{{workflow:praxis-workspace-upkeep}}` rather than fixing hub/member drift
+piecemeal.
+
+Sovereignty: never edit a member repo's files from the hub uninvited — audit,
+propose, and apply only what the user confirms.