minutework 0.1.31 → 0.1.32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (99) hide show
  1. package/EXTERNAL_ALPHA.md +33 -33
  2. package/README.md +34 -34
  3. package/assets/claude-local/CLAUDE.md.template +12 -12
  4. package/assets/claude-local/skills/README.md +1 -1
  5. package/assets/claude-local/skills/app-pack-authoring/SKILL.md +3 -3
  6. package/assets/claude-local/skills/capability-gap-reporting/SKILL.md +3 -3
  7. package/assets/claude-local/skills/generated-workspace-architecture/SKILL.md +2 -2
  8. package/assets/claude-local/skills/layering-and-import-modes/SKILL.md +2 -2
  9. package/assets/claude-local/skills/openclaw-skill-importer/SKILL.md +2 -2
  10. package/assets/claude-local/skills/project-overview-and-strategy/SKILL.md +8 -8
  11. package/assets/claude-local/skills/published-web-and-mw-core-site/SKILL.md +2 -2
  12. package/assets/claude-local/skills/standalone-mobile-client/SKILL.md +1 -1
  13. package/assets/claude-local/skills/vuilder-discovery-output-contract/SKILL.md +6 -6
  14. package/assets/claude-local/skills/workspace-guidance-refresh/SKILL.md +4 -4
  15. package/assets/templates/fastapi-sidecar/pyproject.toml +1 -1
  16. package/assets/templates/fastapi-sidecar/src/fastapi_sidecar/main.py +1 -1
  17. package/assets/templates/mobile-app/.env.example +4 -4
  18. package/assets/templates/mobile-app/AGENTS.md +3 -3
  19. package/assets/templates/mobile-app/README.md +10 -10
  20. package/assets/templates/mobile-app/app/(app)/_layout.tsx +2 -2
  21. package/assets/templates/mobile-app/app/(app)/index.tsx +2 -2
  22. package/assets/templates/mobile-app/app/(auth)/login.tsx +3 -3
  23. package/assets/templates/mobile-app/app/_layout.tsx +1 -1
  24. package/assets/templates/mobile-app/babel.config.js +1 -1
  25. package/assets/templates/mobile-app/eas.json +1 -1
  26. package/assets/templates/mobile-app/expo-env.d.ts +1 -1
  27. package/assets/templates/mobile-app/metro.config.js +2 -2
  28. package/assets/templates/mobile-app/package.json +1 -1
  29. package/assets/templates/mobile-app/src/mw/client.ts +3 -3
  30. package/assets/templates/mobile-app/src/mw/contracts.ts +2 -2
  31. package/assets/templates/mobile-app/src/mw/endpoints.ts +2 -2
  32. package/assets/templates/mobile-app/src/mw/env.ts +4 -4
  33. package/assets/templates/mobile-app/src/mw/session.ts +1 -1
  34. package/assets/templates/mobile-app/template.json +1 -1
  35. package/assets/templates/mobile-app/tools/template/validate-template.mjs +2 -2
  36. package/assets/templates/mobile-app/tsconfig.json +1 -1
  37. package/assets/templates/next-tenant-app/.env.example +1 -1
  38. package/assets/templates/next-tenant-app/README.md +3 -3
  39. package/assets/templates/next-tenant-app/src/app/app/examples/runtime-commands/page.test.ts +2 -2
  40. package/assets/templates/next-tenant-app/src/app/app/page.test.ts +1 -1
  41. package/assets/templates/next-tenant-app/src/app/app/page.tsx +1 -1
  42. package/assets/templates/next-tenant-app/src/app/blog/[slug]/page.test.ts +1 -1
  43. package/assets/templates/next-tenant-app/src/app/docs/[...slug]/page.test.ts +1 -1
  44. package/assets/templates/next-tenant-app/src/app/login/page.test.ts +1 -1
  45. package/assets/templates/next-tenant-app/src/app/login/page.tsx +1 -1
  46. package/assets/templates/next-tenant-app/src/app/page.test.ts +2 -2
  47. package/assets/templates/next-tenant-app/src/app/pricing/page.test.ts +2 -2
  48. package/assets/templates/next-tenant-app/src/lib/content/__fixtures__/public-site-snapshot.ts +14 -14
  49. package/assets/templates/next-tenant-app/src/lib/content/adapter.server.test.ts +3 -3
  50. package/assets/templates/next-tenant-app/src/lib/content/adapter.server.ts +1 -1
  51. package/assets/templates/next-tenant-app/src/lib/content/empty-state.ts +3 -3
  52. package/assets/templates/next-tenant-app/src/lib/platform/env.server.test.ts +2 -2
  53. package/assets/templates/next-tenant-app/src/lib/platform/env.server.ts +1 -1
  54. package/assets/templates/next-tenant-app/src/lib/public-site.test.ts +1 -1
  55. package/assets/templates/next-tenant-app/tools/template/with-public-site-fixture.mjs +2 -2
  56. package/bin/minutework.js +1 -1
  57. package/dist/agent.js +7 -7
  58. package/dist/agent.js.map +1 -1
  59. package/dist/auth.js +7 -7
  60. package/dist/auth.js.map +1 -1
  61. package/dist/compile.js +5 -5
  62. package/dist/config.js +6 -6
  63. package/dist/config.js.map +1 -1
  64. package/dist/deploy.js +7 -7
  65. package/dist/deploy.js.map +1 -1
  66. package/dist/developer-client.js +2 -2
  67. package/dist/developer-client.js.map +1 -1
  68. package/dist/index.js +30 -30
  69. package/dist/index.js.map +1 -1
  70. package/dist/init.js +10 -10
  71. package/dist/init.js.map +1 -1
  72. package/dist/launcher.js +1 -1
  73. package/dist/launcher.js.map +1 -1
  74. package/dist/managed-engine.js +6 -6
  75. package/dist/managed-engine.js.map +1 -1
  76. package/dist/orchestrator-context.js +1 -1
  77. package/dist/orchestrator-context.js.map +1 -1
  78. package/dist/orchestrator.js +15 -15
  79. package/dist/orchestrator.js.map +1 -1
  80. package/dist/paths.js +1 -1
  81. package/dist/paths.js.map +1 -1
  82. package/dist/publish.js +3 -3
  83. package/dist/publish.js.map +1 -1
  84. package/dist/reporting.js +8 -8
  85. package/dist/reporting.js.map +1 -1
  86. package/dist/sandbox.js +5 -5
  87. package/dist/sandbox.js.map +1 -1
  88. package/dist/state.js +1 -1
  89. package/dist/state.js.map +1 -1
  90. package/dist/tokens.js +9 -9
  91. package/dist/tokens.js.map +1 -1
  92. package/dist/workspace-assets.js +6 -6
  93. package/dist/workspace-assets.js.map +1 -1
  94. package/dist/workspace.js +3 -3
  95. package/dist/workspace.js.map +1 -1
  96. package/package.json +2 -2
  97. package/vendor/workspace-mcp/context.d.ts +6 -6
  98. package/vendor/workspace-mcp/context.js +56 -56
  99. package/vendor/workspace-mcp/context.js.map +1 -1
package/EXTERNAL_ALPHA.md CHANGED
@@ -1,35 +1,35 @@
1
- # PandaWork CLI External Alpha
1
+ # MinuteWork CLI External Alpha
2
2
 
3
- This document is the operator-facing onboarding contract for the first external PandaWork CLI alpha.
3
+ This document is the operator-facing onboarding contract for the first external MinuteWork CLI alpha.
4
4
 
5
5
  ## Supported paths
6
6
 
7
7
  Every supported external path starts with the same workspace/bootstrap flow:
8
8
 
9
9
  ```bash
10
- npx pandawork init my-site --starter tenant-app
10
+ npx minutework init my-site --starter tenant-app
11
11
  cd my-site
12
- npx pandawork login
13
- npx pandawork link
12
+ npx minutework login
13
+ npx minutework link
14
14
  ```
15
15
 
16
16
  From there, the current external alpha supports two post-link lanes.
17
17
 
18
18
  The shipped `tenant-app` starter is the combined web surface: public routes at
19
- the root, a private `/app` workspace, and a PandaWork-managed public-content
19
+ the root, a private `/app` workspace, and a MinuteWork-managed public-content
20
20
  path over the runtime-baseline `mw.core.site` contract.
21
21
 
22
22
  ### Developer-local broker lane
23
23
 
24
- Use `pandawork session` when you want PandaWork to assemble the workspace
24
+ Use `minutework session` when you want MinuteWork to assemble the workspace
25
25
  snapshot, choose a local workflow mode, and optionally launch the first shipped
26
26
  local coding engine.
27
27
 
28
28
  ```bash
29
- pandawork session start --mode human
30
- pandawork session start --mode ai --engine claude
31
- pandawork session status
32
- pandawork session resume
29
+ minutework session start --mode human
30
+ minutework session start --mode ai --engine claude
31
+ minutework session status
32
+ minutework session resume
33
33
  ```
34
34
 
35
35
  - `start` stores or updates the workspace preference, writes a bounded context
@@ -41,10 +41,10 @@ pandawork session resume
41
41
  - `human` and `ai` are alternative start modes, not a required sequence.
42
42
  - Claude is the only supported local coding engine today.
43
43
  - AI mode now auto-installs and auto-updates managed Claude Code under the
44
- machine-local PandaWork CLI state root and prefers that managed binary over
44
+ machine-local MinuteWork CLI state root and prefers that managed binary over
45
45
  any `claude` already on `PATH`.
46
- - Claude authentication still happens outside PandaWork. If Claude needs local
47
- login or approval, complete that in Claude itself and rerun the PandaWork
46
+ - Claude authentication still happens outside MinuteWork. If Claude needs local
47
+ login or approval, complete that in Claude itself and rerun the MinuteWork
48
48
  broker command.
49
49
 
50
50
  The broker state model is intentionally split:
@@ -52,7 +52,7 @@ The broker state model is intentionally split:
52
52
  - repo-local pointer and lock state under `.minutework/` tracks the current
53
53
  workspace session
54
54
  - machine-local preferences, per-session context packs, transcripts, and
55
- session history stay under the PandaWork CLI state root
55
+ session history stay under the MinuteWork CLI state root
56
56
 
57
57
  The broker fails closed when a live session is already active, the selected
58
58
  engine is missing, a prior running record has gone stale, or the launch is
@@ -74,7 +74,7 @@ trusted projects); `mcp/claude-desktop.sample.json` is included for Claude
74
74
  Desktop.
75
75
 
76
76
  Generated guidance and MCP wiring can be reconciled later with
77
- `pandawork workspace sync-assets`.
77
+ `minutework workspace sync-assets`.
78
78
 
79
79
  Runtime-only Claude hooks remain excluded from the generated workspace export.
80
80
 
@@ -84,28 +84,28 @@ Use the existing local preview/test loop and hosted preview deploy lane when
84
84
  you want to run the generated app locally or submit a hosted preview:
85
85
 
86
86
  ```bash
87
- pandawork dev
88
- pandawork test
89
- pandawork deploy --preview
87
+ minutework dev
88
+ minutework test
89
+ minutework deploy --preview
90
90
  ```
91
91
 
92
- Combined **tenant-app + sidecar** workspaces keep sidecar setup explicit. Root `pnpm install` stays Node-only and does not run `poetry install` for you. If you need the sidecar, run `pnpm run install:sidecar` from the workspace root or `cd sidecar && poetry install` yourself before `pandawork dev` or `pandawork test`.
92
+ Combined **tenant-app + sidecar** workspaces keep sidecar setup explicit. Root `pnpm install` stays Node-only and does not run `poetry install` for you. If you need the sidecar, run `pnpm run install:sidecar` from the workspace root or `cd sidecar && poetry install` yourself before `minutework dev` or `minutework test`.
93
93
 
94
94
  For direct third-party web hosts such as Vercel, deploy `tenant-app` only. In Vercel, point the project Root Directory at `tenant-app`; the optional sidecar remains a separate Poetry-managed surface.
95
95
 
96
96
  For native mobile clients, use the `mobile` starter. It is a standalone Expo /
97
97
  React Native client that authenticates directly against the platform with the
98
98
  native session-token flow; it is distributed through EAS/App Store/Play Store
99
- instead of `pandawork deploy`.
99
+ instead of `minutework deploy`.
100
100
 
101
101
  Anything outside these lanes remains deferred, including `--live`,
102
102
  runtime-backed deploy targets, and additional local coding engines.
103
103
 
104
- If you run `pandawork init` **without** `--starter` in an interactive terminal, the CLI prompts for tenant-app, sidecar, mobile, common combinations, or base-only. In CI or scripts, use `--starter` or set `MW_CLI_NONINTERACTIVE=1` to skip the prompt (base-only scaffold).
104
+ If you run `minutework init` **without** `--starter` in an interactive terminal, the CLI prompts for tenant-app, sidecar, mobile, common combinations, or base-only. In CI or scripts, use `--starter` or set `MW_CLI_NONINTERACTIVE=1` to skip the prompt (base-only scaffold).
105
105
 
106
106
  ## What `link` does
107
107
 
108
- `pandawork link` is no longer tenant-only. It now:
108
+ `minutework link` is no longer tenant-only. It now:
109
109
 
110
110
  1. Resolves the active auth profile and workspace platform.
111
111
  2. Resolves or creates the tenant-scoped `PublishedWebProperty`.
@@ -133,7 +133,7 @@ If the workspace cannot compile hosted preview release metadata for the linked p
133
133
 
134
134
  ## What `deploy --preview` does
135
135
 
136
- `pandawork deploy --preview` is preview-only and guarded:
136
+ `minutework deploy --preview` is preview-only and guarded:
137
137
 
138
138
  1. Loads the active auth profile and linked workspace property.
139
139
  2. Re-runs validate and compile.
@@ -153,12 +153,12 @@ The CLI does not fabricate success. If the backend cannot materialize a hosted p
153
153
 
154
154
  ## Failure semantics
155
155
 
156
- - Missing auth: run `pandawork login`
157
- - Missing binding: run `pandawork link`
158
- - Missing stored broker preference before resume: run `pandawork session start --mode <human|ai>`
159
- - Missing Claude binary or local Claude auth for AI mode: let PandaWork retry the managed install when network access is available, or complete Claude authentication locally, then rerun `pandawork session start --mode ai --engine claude`
160
- - Live or stale local broker session state: inspect `pandawork session status`, let the live process exit, or rerun `pandawork session resume`
161
- - Missing property-scoped release metadata: fix `tenant-app/.env.example` and re-run `pandawork compile`
156
+ - Missing auth: run `minutework login`
157
+ - Missing binding: run `minutework link`
158
+ - Missing stored broker preference before resume: run `minutework session start --mode <human|ai>`
159
+ - Missing Claude binary or local Claude auth for AI mode: let MinuteWork retry the managed install when network access is available, or complete Claude authentication locally, then rerun `minutework session start --mode ai --engine claude`
160
+ - Live or stale local broker session state: inspect `minutework session status`, let the live process exit, or rerun `minutework session resume`
161
+ - Missing property-scoped release metadata: fix `tenant-app/.env.example` and re-run `minutework compile`
162
162
  - Unsupported release class: external alpha only supports hosted `ssr_container`
163
163
  - Missing provider/receipt substrate: deploy returns a typed failure receipt
164
164
  - Failed preview deploy with an existing preview target: the platform reports `rolled_back` with `previous_preview_preserved`
@@ -166,9 +166,9 @@ The CLI does not fabricate success. If the backend cannot materialize a hosted p
166
166
  ## CLI bug reports
167
167
 
168
168
  - The CLI automatically submits a sanitized bug report for failed commands unless `MW_CLI_BUG_REPORTS=never` is set (machine-readable `--json` verbs suppress this automatically).
169
- - Automatic reports keep a local JSON bundle under the PandaWork CLI state root for retry and support follow-up.
170
- - `pandawork report-bug --note "..."` sends a manual report for UX issues or suspicious behavior that did not crash.
171
- - `pandawork report-bug --last --note "..."` resends the last saved bundle with extra context.
169
+ - Automatic reports keep a local JSON bundle under the MinuteWork CLI state root for retry and support follow-up.
170
+ - `minutework report-bug --note "..."` sends a manual report for UX issues or suspicious behavior that did not crash.
171
+ - `minutework report-bug --last --note "..."` resends the last saved bundle with extra context.
172
172
  - Support should always ask for the printed `report_id` before requesting extra screenshots or logs.
173
173
 
174
174
  ## Release notes for operators
package/README.md CHANGED
@@ -1,31 +1,31 @@
1
- # PandaWork CLI
1
+ # MinuteWork CLI
2
2
 
3
- PandaWork CLI for initializing a workspace, authenticating against a PandaWork platform, linking a repo to a tenant-scoped public-site property, launching developer-local session broker flows, running local preview/test loops, submitting hosted preview deploys, and publishing app packs to the marketplace through the publication-review gate.
3
+ MinuteWork CLI for initializing a workspace, authenticating against a MinuteWork platform, linking a repo to a tenant-scoped public-site property, launching developer-local session broker flows, running local preview/test loops, submitting hosted preview deploys, and publishing app packs to the marketplace through the publication-review gate.
4
4
 
5
- The npm package is still published as `minutework` for compatibility. Use `pandawork` for new commands; the existing `minutework` command remains supported.
5
+ The npm package and primary command are `minutework`. The `pandawork` command remains available only as a compatibility alias for older installs and scripts.
6
6
 
7
7
  ## External alpha scope
8
8
 
9
9
  The current external alpha is intentionally narrow:
10
10
 
11
11
  - Starters: `tenant-app` (the deployable web surface), `sidecar` (local/internal runtime surface), and `mobile` (init-only native client)
12
- - Developer-local broker surface: `pandawork session start|resume|status`
12
+ - Developer-local broker surface: `minutework session start|resume|status`
13
13
  - Hosted release class: `ssr_container`
14
- - Deploy surface: `pandawork deploy --preview`
14
+ - Deploy surface: `minutework deploy --preview`
15
15
  - Deferred: `--live`, additional local coding engines, sidecar/runtime-backed deploys, and the commercial marketplace listing/pricing layer
16
- - Marketplace publish: `pandawork publish` submits the compiled, digest-bound app pack through the platform publication-review + attestation gate and publishes it to the public marketplace catalog **only** on an approved (or approved-with-warnings) attestation; a rejected attestation prints the review findings and exits 1 without publishing
16
+ - Marketplace publish: `minutework publish` submits the compiled, digest-bound app pack through the platform publication-review + attestation gate and publishes it to the public marketplace catalog **only** on an approved (or approved-with-warnings) attestation; a rejected attestation prints the review findings and exits 1 without publishing
17
17
 
18
18
  The shipped `tenant-app` starter is the combined web surface: public routes at
19
19
  the root plus a private `/app` workspace. Public-site content follows the
20
- PandaWork-managed `mw.core.site` baseline and published-snapshot flow.
20
+ MinuteWork-managed `mw.core.site` baseline and published-snapshot flow.
21
21
 
22
22
  The CLI fails closed when the backend cannot provide typed release metadata, deploy status, receipts, activation state, or rollback state. It does not claim a successful deploy when the provider substrate is unavailable.
23
23
 
24
24
  ## Install
25
25
 
26
26
  ```bash
27
- npx pandawork --help
28
- npx pandawork --version
27
+ npx minutework --help
28
+ npx minutework --version
29
29
  ```
30
30
 
31
31
  For repeat use in a local environment:
@@ -41,10 +41,10 @@ The package currently ships on a `0.x` alpha channel. Publish from this repo wit
41
41
  Start with the shared setup:
42
42
 
43
43
  ```bash
44
- npx pandawork init my-site --starter tenant-app
44
+ npx minutework init my-site --starter tenant-app
45
45
  cd my-site
46
- npx pandawork login
47
- npx pandawork link
46
+ npx minutework login
47
+ npx minutework link
48
48
  ```
49
49
 
50
50
  After `link`, the current alpha has two supported lanes (both `tenant-app`).
@@ -52,7 +52,7 @@ After `link`, the current alpha has two supported lanes (both `tenant-app`).
52
52
  For a native mobile client, scaffold the **`mobile`** starter instead:
53
53
 
54
54
  ```bash
55
- npx pandawork init my-app --starter mobile
55
+ npx minutework init my-app --starter mobile
56
56
  ```
57
57
 
58
58
  It is **init-only** and bring-your-own-UI: a minimal Expo (React Native) client
@@ -60,34 +60,34 @@ that authenticates **directly** against the platform with a native device-flow
60
60
  session token (PKCE authorize -> exchange -> bearer + refresh in the device
61
61
  keychain), not the `tenant-app` BFF cookie path. There is no `link`/`deploy`
62
62
  lane for it — distribution is your own EAS pipeline (`eas build`/`eas submit`,
63
- EAS Update), not `pandawork deploy`.
63
+ EAS Update), not `minutework deploy`.
64
64
 
65
65
  ### Developer-local broker lane
66
66
 
67
- Use this lane when you want PandaWork to assemble a bounded workspace context,
67
+ Use this lane when you want MinuteWork to assemble a bounded workspace context,
68
68
  persist broker state locally, and either prepare a human-mode session or launch
69
69
  the first supported local coding engine.
70
70
 
71
71
  ```bash
72
- pandawork session start --mode human
73
- pandawork session start --mode ai --engine claude
74
- pandawork session status
75
- pandawork session resume
72
+ minutework session start --mode human
73
+ minutework session start --mode ai --engine claude
74
+ minutework session status
75
+ minutework session resume
76
76
  ```
77
77
 
78
78
  - `human` and `ai` are alternative start modes, not a required sequence.
79
79
  - Claude is the only supported local coding engine today.
80
80
  - AI mode launches Claude with explicit workspace MCP bootstrap plus a bounded
81
- PandaWork context pack instead of relying on implicit shell state.
82
- - PandaWork now installs and updates managed Claude Code automatically under
81
+ MinuteWork context pack instead of relying on implicit shell state.
82
+ - MinuteWork now installs and updates managed Claude Code automatically under
83
83
  the machine-local CLI state root when AI mode needs it, and prefers that
84
84
  managed Claude binary over any `claude` already on `PATH`.
85
- - Claude authentication still happens outside PandaWork. If Claude needs local
85
+ - Claude authentication still happens outside MinuteWork. If Claude needs local
86
86
  login or account approval, complete that in Claude itself and rerun the
87
- PandaWork session command.
87
+ MinuteWork session command.
88
88
  - Current-session coordination stays repo-local under `.minutework/`, while
89
89
  preferences, per-session context packs, transcripts, and session history stay
90
- machine-local under the PandaWork CLI state root.
90
+ machine-local under the MinuteWork CLI state root.
91
91
  - The broker fails closed on live overlap, missing engine binaries, stale
92
92
  session records, interrupts, and launch failures instead of allowing
93
93
  overlapping phantom sessions.
@@ -104,7 +104,7 @@ pandawork session resume
104
104
  trusted projects); `mcp/claude-desktop.sample.json` is included for Claude
105
105
  Desktop.
106
106
  - Managed guidance and MCP wiring can be refreshed later with
107
- `pandawork workspace sync-assets`.
107
+ `minutework workspace sync-assets`.
108
108
  - Runtime-only Claude hooks are not exported into the generated workspace.
109
109
 
110
110
  ### Local preview and deploy lane
@@ -113,12 +113,12 @@ Use this lane when you want the workspace-local preview/test loop or a hosted
113
113
  preview deploy:
114
114
 
115
115
  ```bash
116
- pandawork dev
117
- pandawork test
118
- pandawork deploy --preview
116
+ minutework dev
117
+ minutework test
118
+ minutework deploy --preview
119
119
  ```
120
120
 
121
- Combined **tenant-app + sidecar** workspaces keep sidecar setup explicit. Root `pnpm install` stays Node-only and does not run `poetry install` for you. If you need the sidecar, run `pnpm run install:sidecar` from the workspace root or `cd sidecar && poetry install` yourself before `pandawork dev` or `pandawork test`. Sidecar-only scaffolds have no root `package.json`; install Python deps once inside `sidecar/` before running local sidecar workflows.
121
+ Combined **tenant-app + sidecar** workspaces keep sidecar setup explicit. Root `pnpm install` stays Node-only and does not run `poetry install` for you. If you need the sidecar, run `pnpm run install:sidecar` from the workspace root or `cd sidecar && poetry install` yourself before `minutework dev` or `minutework test`. Sidecar-only scaffolds have no root `package.json`; install Python deps once inside `sidecar/` before running local sidecar workflows.
122
122
 
123
123
  For direct third-party web hosts such as Vercel, deploy `tenant-app` only. In Vercel, point the project Root Directory at `tenant-app`; the optional sidecar remains a separate Poetry-managed surface.
124
124
 
@@ -148,20 +148,20 @@ For direct third-party web hosts such as Vercel, deploy `tenant-app` only. In Ve
148
148
 
149
149
  ## Bug reporting
150
150
 
151
- CLI failures automatically send a sanitized diagnostic report to the PandaWork platform unless `MW_CLI_BUG_REPORTS=never` is set.
151
+ CLI failures automatically send a sanitized diagnostic report to the MinuteWork platform unless `MW_CLI_BUG_REPORTS=never` is set.
152
152
 
153
153
  - Machine-readable verbs run with `--json` suppress automatic reporting; rely on the result envelope and exit code instead.
154
154
 
155
155
  - Automatic reports never include raw `.env` contents, tokens, source files, or full local paths.
156
- - The CLI keeps a local report bundle under the PandaWork state root so you can retry or inspect what was sent.
157
- - Use `pandawork report-bug --note "what happened"` for manual reports.
158
- - Use `pandawork report-bug --last --note "extra context"` to resend the last saved bundle with more detail.
156
+ - The CLI keeps a local report bundle under the MinuteWork state root so you can retry or inspect what was sent.
157
+ - Use `minutework report-bug --note "what happened"` for manual reports.
158
+ - Use `minutework report-bug --last --note "extra context"` to resend the last saved bundle with more detail.
159
159
 
160
160
  ## Requirements
161
161
 
162
162
  - Node.js 18 or newer
163
163
  - [Poetry](https://python-poetry.org/) on `PATH` when your workspace includes the FastAPI sidecar and you plan to run it locally (then run `pnpm run install:sidecar` or `cd sidecar && poetry install`)
164
- - A PandaWork platform that exposes the developer CLI auth and public-site preview deploy endpoints
164
+ - A MinuteWork platform that exposes the developer CLI auth and public-site preview deploy endpoints
165
165
  - An auth profile with interactive developer access, or a deploy token that includes `deploy.preview.request`
166
166
 
167
167
  If the hosted preview provider is not configured, preview deploy returns a typed failure or rollback-preserved receipt instead of a fake success.
@@ -1,6 +1,6 @@
1
- # PandaWork Builder
1
+ # MinuteWork Builder
2
2
 
3
- Use this workspace to build or extend PandaWork app packs. `tenant-app`,
3
+ Use this workspace to build or extend MinuteWork app packs. `tenant-app`,
4
4
  `sidecar`, and optional `mobile` are implementation surfaces; choose the
5
5
  smallest surface that fits the request.
6
6
 
@@ -10,27 +10,27 @@ private authenticated workspace under `/app`.
10
10
  `mobile` is the standalone Expo/React Native client starter. It talks directly
11
11
  to the platform with native device-flow auth and bearer tokens; it is not a
12
12
  `tenant-app` BFF cookie client and not a `sidecar`. It ships through the
13
- developer's own EAS/App Store/Play Store pipeline, not `pandawork deploy`.
13
+ developer's own EAS/App Store/Play Store pipeline, not `minutework deploy`.
14
14
 
15
15
  ## Refresh Managed Guidance
16
16
 
17
17
  If this workspace's exported guidance looks stale or a newly added skill is
18
- missing, run `pandawork workspace sync-assets` from the workspace root. See
18
+ missing, run `minutework workspace sync-assets` from the workspace root. See
19
19
  `skills/workspace-guidance-refresh/SKILL.md` for the managed refresh flow.
20
20
 
21
21
  ## Workspace MCP
22
22
 
23
- The PandaWork workspace MCP server exposes read-only context tools (workspace
23
+ The MinuteWork workspace MCP server exposes read-only context tools (workspace
24
24
  snapshot, schema status, capability inventory, deploy status, and a workspace
25
25
  doctor; tool names are prefixed `minutework_`). Prefer these over guessing at
26
26
  workspace state. It is wired for Cursor (`.cursor/mcp.json`) and Codex
27
27
  (`.codex/config.toml`, loaded for trusted projects); for Claude Desktop, copy
28
28
  `mcp/claude-desktop.sample.json`. Refresh all of this with
29
- `pandawork workspace sync-assets`.
29
+ `minutework workspace sync-assets`.
30
30
 
31
31
  ## Skills
32
32
 
33
- This workspace includes PandaWork architecture skills under `skills/`. Your IDE
33
+ This workspace includes MinuteWork architecture skills under `skills/`. Your IDE
34
34
  coding agent can use them as reference: browse `skills/` and read the relevant
35
35
  `SKILL.md` when a topic matches your task. In Claude Code these skills load
36
36
  automatically and `/skill-name` invokes one directly; other agents (Codex,
@@ -39,7 +39,7 @@ Cursor) can open the files directly or ask "What skills are available?".
39
39
  ## Project Orientation Fast Path
40
40
 
41
41
  When the user asks broad context questions like "what is this project about?",
42
- "what can we build with PandaWork?", "can we build our own product or make an
42
+ "what can we build with MinuteWork?", "can we build our own product or make an
43
43
  existing product agentic?", "how do OSS products fit?", or "what is the
44
44
  ontology/network effect?", do not wait for them to name skills one by one. Read
45
45
  `skills/project-overview-and-strategy/SKILL.md` first, then pull the routed
@@ -108,7 +108,7 @@ a concrete backend responsibility such as:
108
108
  - Builder may adopt open-source libraries, frameworks, and products inside the
109
109
  sandbox when that produces a better result than bespoke code.
110
110
  - Prefer this solution order before writing greenfield code:
111
- - existing PandaWork substrate
111
+ - existing MinuteWork substrate
112
112
  - reviewed capability skill or `catalog_native`
113
113
  - app-pack/schema/flow extension
114
114
  - adopt OSS when it clearly fits
@@ -118,11 +118,11 @@ a concrete backend responsibility such as:
118
118
  - If a strong OSS product already solves the problem well, prefer integrating,
119
119
  wrapping, or governing it instead of rebuilding it from scratch.
120
120
  - Never treat imported OSS as a direct runtime install contract; normalize it
121
- into governed PandaWork artifacts or keep it external through `attached_app`.
121
+ into governed MinuteWork artifacts or keep it external through `attached_app`.
122
122
 
123
123
  ## Compose Before Rebuild
124
124
 
125
- - Compose shared PandaWork substrate first: baseline capabilities, runtime
125
+ - Compose shared MinuteWork substrate first: baseline capabilities, runtime
126
126
  primitives, reviewed capability skills, app packs, overlays, and hosted
127
127
  publication flows.
128
128
  - For external collaboration, start from the native substrate: shadow tenant,
@@ -234,7 +234,7 @@ a concrete backend responsibility such as:
234
234
  the property uses `runtime_local_sidecar`; publish immutable runtime content
235
235
  first.
236
236
  - Do not treat `attached_app` as a third serving mode; keep the foreign renderer
237
- and deploy pipeline external while PandaWork governs drafts, approvals, and
237
+ and deploy pipeline external while MinuteWork governs drafts, approvals, and
238
238
  publish actions.
239
239
  - Do not invent a separate guest-account or inbox-routing model when the
240
240
  existing shadow identity, alias, route, and thread substrate fits.
@@ -1,6 +1,6 @@
1
1
  # Builder Skills
2
2
 
3
- Place focused PandaWork architecture skills here.
3
+ Place focused MinuteWork architecture skills here.
4
4
 
5
5
  These files are part of the canonical Builder common bundle and are allowlisted
6
6
  for developer-local export. Skills are shared across all engine renderers.
@@ -7,12 +7,12 @@ description: "Deciding the shipped product shape, choosing between tenant-app an
7
7
 
8
8
  An `app pack` is the shipped product unit.
9
9
 
10
- - Compose shared PandaWork substrate first: baseline capabilities, runtime
10
+ - Compose shared MinuteWork substrate first: baseline capabilities, runtime
11
11
  primitives, reviewed capability skills, app packs, overlays, and hosted
12
12
  publication flows.
13
13
  - Templates are governed starters, not the full limit of what Builder may use.
14
14
  - Builder may adopt open-source libraries, frameworks, and products inside the
15
- sandbox when that reduces bespoke code and still preserves the PandaWork
15
+ sandbox when that reduces bespoke code and still preserves the MinuteWork
16
16
  contract boundaries.
17
17
  - Start with declarative schema/manifests and add code surfaces only when needed.
18
18
  - Use `tenant-app` for the combined public-site plus private-app web surface.
@@ -42,7 +42,7 @@ An `app pack` is the shipped product unit.
42
42
  - Public-site authoring should stay CMS/runtime-backed, while anonymous live
43
43
  delivery should prefer published snapshots.
44
44
  - Prefer this decision order before writing greenfield code:
45
- - reuse existing PandaWork substrate or a reviewed capability skill
45
+ - reuse existing MinuteWork substrate or a reviewed capability skill
46
46
  - extend app-pack/schema/flow surfaces
47
47
  - adopt a strong OSS library or product when it clearly fits
48
48
  - use `attached_app` when the foreign system should stay its own subsystem
@@ -1,12 +1,12 @@
1
1
  ---
2
2
  name: capability-gap-reporting
3
- description: "A request does not cleanly fit current PandaWork substrate and a capability gap needs to be recorded."
3
+ description: "A request does not cleanly fit current MinuteWork substrate and a capability gap needs to be recorded."
4
4
  ---
5
5
 
6
6
  # Capability Gap Reporting
7
7
 
8
8
  Use this skill when a generated workspace discovers that the requested
9
- implementation does not cleanly fit current PandaWork substrate.
9
+ implementation does not cleanly fit current MinuteWork substrate.
10
10
 
11
11
  - Record architecture gaps in `.minutework/runtime/capability-gap-report.json`.
12
12
  - Keep the report sanitized and tenant-safe. Do not include secrets, raw
@@ -52,5 +52,5 @@ implementation does not cleanly fit current PandaWork substrate.
52
52
  - `attached_app` when the right home is an attached-app integration surface
53
53
  rather than shared core substrate.
54
54
  - Prefer one concrete gap per missing shared capability.
55
- - Use gap reports to tell humans where PandaWork needs new substrate. Do not
55
+ - Use gap reports to tell humans where MinuteWork needs new substrate. Do not
56
56
  treat them as automatic implementation instructions.
@@ -8,10 +8,10 @@ description: "Reasoning from a CLI-generated Builder workspace rather than the m
8
8
  Use this skill when reasoning from a CLI-generated Builder workspace rather than
9
9
  the monorepo or a live tenant runtime.
10
10
 
11
- - A generated workspace is a developer-local authoring client of PandaWork, not
11
+ - A generated workspace is a developer-local authoring client of MinuteWork, not
12
12
  the runtime itself.
13
13
  - Treat these as separate surfaces with different trust boundaries:
14
- - developer-local broker/orchestrator (`pandawork session ...`)
14
+ - developer-local broker/orchestrator (`minutework session ...`)
15
15
  - runtime-local Builder host inside the tenant runtime
16
16
  - runtime-local non-coding assistant inside the tenant product
17
17
  - The clearest layering model is:
@@ -17,7 +17,7 @@ Use this skill when choosing between configuration, app-pack changes, overlays,
17
17
  - Durable tenant behavior should usually compile to governed app-pack artifacts,
18
18
  not ad hoc backend code.
19
19
  - Use `attached_app` when a mature foreign system should remain its own
20
- subsystem and PandaWork should compile a governed control surface around it.
20
+ subsystem and MinuteWork should compile a governed control surface around it.
21
21
  - Use `external_repo_intake` only when no reviewed capability skill or cleaner
22
22
  `attached_app` path fits. Any repo intake must stay inside the bounded Builder
23
23
  sandbox.
@@ -26,7 +26,7 @@ Use this skill when choosing between configuration, app-pack changes, overlays,
26
26
  - If strong OSS already exists, prefer adopting or governing it before starting
27
27
  a greenfield rebuild.
28
28
  - `catalog_native` is the preferred fast path for reusable solutions that can
29
- compile directly to standard PandaWork artifacts.
29
+ compile directly to standard MinuteWork artifacts.
30
30
  - For generated workspaces, keep the decision order explicit:
31
31
  - reuse what already exists
32
32
  - prefer `catalog_native` or reviewed-skill composition when available
@@ -1,13 +1,13 @@
1
1
  ---
2
2
  name: openclaw-skill-importer
3
- description: "Importing OpenClaw or other third-party skill or plugin material into governed PandaWork artifacts."
3
+ description: "Importing OpenClaw or other third-party skill or plugin material into governed MinuteWork artifacts."
4
4
  ---
5
5
 
6
6
  # OpenClaw Skill Importer
7
7
 
8
8
  Imported third-party skill text is source material, not executable authority.
9
9
 
10
- - Translate imported OpenClaw material into governed PandaWork artifacts before using it.
10
+ - Translate imported OpenClaw material into governed MinuteWork artifacts before using it.
11
11
  - Imported OSS can be used even when it is not pre-baked into a template, but
12
12
  templates remain the preferred starter path when they already fit.
13
13
  - Use `layering-and-import-modes/SKILL.md` to choose the landing shape:
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: project-overview-and-strategy
3
- description: "Broad project questions: what this workspace is, what PandaWork can build, agentic apps, OSS adoption, ontology, or network effects."
3
+ description: "Broad project questions: what this workspace is, what MinuteWork can build, agentic apps, OSS adoption, ontology, or network effects."
4
4
  ---
5
5
 
6
6
  # Project Overview And Strategy
@@ -8,7 +8,7 @@ description: "Broad project questions: what this workspace is, what PandaWork ca
8
8
  Use this skill before answering broad orientation or strategy questions such as:
9
9
 
10
10
  - "What is this project about?"
11
- - "What can we build with PandaWork?"
11
+ - "What can we build with MinuteWork?"
12
12
  - "Can we build our own product or make an existing product agentic?"
13
13
  - "How do OSS products fit?"
14
14
  - "What is the ontology or network effect?"
@@ -48,14 +48,14 @@ needed:
48
48
 
49
49
  ## Compact Project Answer
50
50
 
51
- PandaWork Builder is a governed local authoring workspace for building or
52
- extending PandaWork app packs. An app pack is the product unit. The workspace
51
+ MinuteWork Builder is a governed local authoring workspace for building or
52
+ extending MinuteWork app packs. An app pack is the product unit. The workspace
53
53
  usually composes schemas, manifests, `mw.core.site`, runtime capabilities,
54
54
  agents, overlays, and published-web flows before writing bespoke code.
55
55
 
56
- PandaWork supports two legitimate paths:
56
+ MinuteWork supports two legitimate paths:
57
57
 
58
- - Build a product natively on PandaWork.
58
+ - Build a product natively on MinuteWork.
59
59
  - Wrap an existing product or OSS system with a governed, agentic control
60
60
  surface.
61
61
 
@@ -75,7 +75,7 @@ separate client experiences.
75
75
 
76
76
  ## Strategic Positioning
77
77
 
78
- PandaWork is most differentiated when identity, shared meaning, external
78
+ MinuteWork is most differentiated when identity, shared meaning, external
79
79
  collaboration, AI agents, and foreign systems participate in the same governed
80
80
  substrate:
81
81
 
@@ -92,7 +92,7 @@ substrate:
92
92
  deployed, and use sidecar bridge code plus runtime agents/tool packs to make
93
93
  it governed and agentic.
94
94
  - Build-native is appropriate when the capability is central, reusable, and
95
- should become PandaWork substrate. Greenfield is last after existing
95
+ should become MinuteWork substrate. Greenfield is last after existing
96
96
  substrate, reviewed skills, app-pack extension, OSS adoption, and
97
97
  `attached_app` have been considered.
98
98
 
@@ -1,12 +1,12 @@
1
1
  ---
2
2
  name: published-web-and-mw-core-site
3
- description: "Public-site delivery, published-web flows, mw.core.site baseline, or the default PandaWork site model."
3
+ description: "Public-site delivery, published-web flows, mw.core.site baseline, or the default MinuteWork site model."
4
4
  ---
5
5
 
6
6
  # Published Web And mw.core.site
7
7
 
8
8
  Use this skill when the request touches public-site delivery, published-web
9
- flows, or the default PandaWork site model.
9
+ flows, or the default MinuteWork site model.
10
10
 
11
11
  - Treat `mw.core.site` as a runtime baseline capability that already exists.
12
12
  - For Vuilder-owned public websites, read
@@ -109,4 +109,4 @@ boundary.
109
109
  - The `mobile` starter is **init-only**. Scaffolding it lands the app in the
110
110
  workspace; it does not deploy it.
111
111
  - Distribution is the developer's own pipeline: EAS Build, TestFlight, and the
112
- Play Store. It is **not** `pandawork deploy`.
112
+ Play Store. It is **not** `minutework deploy`.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: vuilder-discovery-output-contract
3
- description: "Constrain Vuilder discovery to AI-native service operations and PandaWork-buildable delivery systems instead of generic startup ideas."
3
+ description: "Constrain Vuilder discovery to AI-native service operations and MinuteWork-buildable delivery systems instead of generic startup ideas."
4
4
  ---
5
5
 
6
6
  # Vuilder Discovery Output Contract
@@ -22,7 +22,7 @@ Each card must describe:
22
22
  - an AI-native service outcome the operator can credibly deliver
23
23
  - the buyer or internal team receiving that service outcome
24
24
  - evidence from the user's profile that makes the operator credible
25
- - the PandaWork delivery system Builder can prepare
25
+ - the MinuteWork delivery system Builder can prepare
26
26
  - the first workflow the system should support
27
27
  - the runtime records, AI workers, Builder surfaces, and artifacts involved
28
28
  - capability gap candidates for unsupported substrate
@@ -30,7 +30,7 @@ Each card must describe:
30
30
  Discovery should ask:
31
31
 
32
32
  > What service outcome can this operator credibly deliver, and what
33
- > PandaWork-supported system can Builder create to help deliver it?
33
+ > MinuteWork-supported system can Builder create to help deliver it?
34
34
 
35
35
  Do not ask:
36
36
 
@@ -38,7 +38,7 @@ Do not ask:
38
38
 
39
39
  ## Builder Constraints
40
40
 
41
- - Compose shared PandaWork substrate before bespoke code.
41
+ - Compose shared MinuteWork substrate before bespoke code.
42
42
  - Treat the app pack as the shipped product unit.
43
43
  - Check shell fit first for member-facing collaboration and operator work.
44
44
  - Use `tenant-app` only for public surfaces or explicit standalone UI
@@ -72,7 +72,7 @@ cards before it saves proposal fields:
72
72
 
73
73
  - `extract_workflows_from_context` for repeatable work, bottlenecks, buyers, and
74
74
  AI workforce jobs already implied by the user's context.
75
- - `search_industry_examples` for curated PandaWork service-business patterns.
75
+ - `search_industry_examples` for curated MinuteWork service-business patterns.
76
76
  This is not open web search.
77
77
  - `estimate_market_pricing` for bounded pilot and retainer ranges with explicit
78
78
  assumptions and uncertainty.
@@ -125,7 +125,7 @@ Use the `DiscoveryBuildCardV1` shape:
125
125
  - `paid_blueprint_will_create`
126
126
  - optional `service_packaging`
127
127
 
128
- Plain-language fields are user-facing. They must express PandaWork's loop:
128
+ Plain-language fields are user-facing. They must express MinuteWork's loop:
129
129
  build the AI workforce from work the operator already does, use it first under
130
130
  their own judgment, then sell it back to their industry. Do not expose Builder
131
131
  jargon such as app pack, schemas, runtime records, right rail, runtime agent seed,