mirror of
https://github.com/dirtydishes/dreamio.git
synced 2026-06-06 13:37:24 +00:00
add webview inspection diagnostics
This commit is contained in:
parent
1563a4c067
commit
3df2e2b833
7 changed files with 169 additions and 2 deletions
BIN
.DS_Store
vendored
Normal file
BIN
.DS_Store
vendored
Normal file
Binary file not shown.
|
|
@ -0,0 +1,4 @@
|
|||
{"id":"int-e5b00c6b","kind":"field_change","created_at":"2026-05-24T14:59:43.843679Z","actor":"dirtydishes","issue_id":"dreamio-4yn","extra":{"field":"status","new_value":"closed","old_value":"open","reason":"Implemented the MVP WKWebView iOS shell, added run and validation documentation, and recorded current validation limits."}}
|
||||
{"id":"int-09793929","kind":"field_change","created_at":"2026-05-25T01:12:43.675806Z","actor":"dirtydishes","issue_id":"dreamio-a5b","extra":{"field":"status","new_value":"closed","old_value":"in_progress","reason":"Moved @pierre/diffs to devDependencies and ignored node_modules."}}
|
||||
{"id":"int-d8dc4ec5","kind":"field_change","created_at":"2026-05-25T01:25:35.590554Z","actor":"dirtydishes","issue_id":"dreamio-tnv","extra":{"field":"status","new_value":"closed","old_value":"in_progress","reason":"Added bundle metadata to Info.plist and validated processed app bundle identifier."}}
|
||||
{"id":"int-a86e17e0","kind":"field_change","created_at":"2026-05-25T02:34:54.605755Z","actor":"dirtydishes","issue_id":"dreamio-evt","extra":{"field":"status","new_value":"closed","old_value":"in_progress","reason":"Implemented debug-only WKWebView inspection, token-safe playback diagnostics, navigation logging, validation build, and turn documentation."}}
|
||||
142
AGENTS.md
142
AGENTS.md
|
|
@ -94,3 +94,145 @@ bd close <id> # Complete work
|
|||
- NEVER say "ready to push when you are" - YOU must push
|
||||
- If push fails, resolve and retry until it succeeds
|
||||
<!-- END BEADS INTEGRATION -->
|
||||
|
||||
## Required Turn Documentation
|
||||
|
||||
At the end of every completed implementation task, before final handoff, create a user-readable HTML document describing the work.
|
||||
|
||||
This documentation is mandatory whenever code, configuration, tests, or project files were changed.
|
||||
|
||||
### Precedence and classification
|
||||
|
||||
Use this decision order before creating a turn document:
|
||||
|
||||
1. Check the minor/trivial exemption checklist below first.
|
||||
2. If the task clearly matches an exemption, do not create a turn document.
|
||||
3. If the task is a clearly substantive implementation change, create a turn document.
|
||||
4. If classification is ambiguous or mixed, ask the user before creating a turn document.
|
||||
|
||||
The minor/trivial exemptions override the general mandatory turn-document rule.
|
||||
|
||||
For diff content in turn documentation (including "Code diffs" and "Relevant Diff Snippets"), use `@pierre/diffs` output by default. If `@pierre/diffs` is unavailable because of a real tool or blocking error, use a clearly labeled plain diff/code block fallback and note why.
|
||||
|
||||
### No turn document for minor/trivial checklist matches
|
||||
|
||||
Do not create a turn document when the change is minor/trivial and cleanly matches one of these categories:
|
||||
|
||||
- `AGENTS.md` changes or other documentation-only changes
|
||||
- Syntax-only fixes
|
||||
- Refactor-only changes with no behavior change
|
||||
- PR/conflict reconciliation work
|
||||
- Issue-tracker-only updates such as `beads/issues.json`
|
||||
- Support-file changes that only accompany one of the exempt categories above (for example lockfile or manifest updates required for docs-workflow changes)
|
||||
|
||||
If a change does not cleanly fit either exempt or substantive buckets, ask the user before creating a turn document.
|
||||
|
||||
### When making a minor update to a previous change, update the existing documentation instead of creating a new file. Use the following format:
|
||||
|
||||
**"New Changes as of {time and date at which the change was made}"**
|
||||
- **Summary of changes**
|
||||
- **Why this change was made**
|
||||
- **Code diffs** (use `@pierre/diffs` output by default; if unavailable, include a clearly labeled plain diff/code block and note why)
|
||||
- **Related issues or PRs**
|
||||
|
||||
Additionally, add a note to each section explaining why the changes were made.
|
||||
|
||||
### Location
|
||||
|
||||
Save the document in:
|
||||
|
||||
```text
|
||||
docs/turns/
|
||||
```
|
||||
|
||||
Use a clear timestamped filename:
|
||||
|
||||
```text
|
||||
docs/turns/YYYY-MM-DD-short-task-name.html
|
||||
```
|
||||
|
||||
Example:
|
||||
|
||||
```text
|
||||
docs/turns/2026-05-14-add-market-replay-controls.html
|
||||
```
|
||||
|
||||
### Format
|
||||
|
||||
Use the `impeccable` skill to structure and style the document as clean, readable HTML.
|
||||
|
||||
For this repository, `impeccable` is the styling and layout authority for turn documents when available. Do not apply global non-repo computer-task house styling to repository turn documents.
|
||||
|
||||
If the `impeccable` skill is unavailable or blocked by an actual tool/file error, still create a well-structured standalone HTML file with:
|
||||
|
||||
- A concise summary at the top
|
||||
- A detailed explanation of what changed
|
||||
- Relevant context or background
|
||||
- Specific code snippets or examples when helpful
|
||||
- Issues, limitations, tradeoffs, or mitigations
|
||||
- Validation performed, including tests, builds, linters, or manual checks
|
||||
- Any remaining follow-up work, with corresponding Beads issue IDs when applicable
|
||||
|
||||
### Required Sections
|
||||
|
||||
Each turn document must include these sections:
|
||||
|
||||
1. **Summary**
|
||||
2. **Changes Made**
|
||||
3. **Context**
|
||||
4. **Important Implementation Details**
|
||||
5. **Relevant Diff Snippets** (render with `@pierre/diffs` output by default; if unavailable, include a clearly labeled plain diff/code block and note why)
|
||||
6. **Expected Impact for End-Users**
|
||||
7. **Validation**
|
||||
8. **Issues, Limitations, and Mitigations**
|
||||
9. **Follow-up Work**
|
||||
|
||||
### Completion Rule
|
||||
|
||||
A task that requires a turn document is not complete until:
|
||||
|
||||
1. The Beads workflow is updated
|
||||
2. The turn document is created in `docs/turns`
|
||||
3. Relevant quality gates have passed or failures are documented
|
||||
4. Changes are committed
|
||||
5. `bd dolt push` succeeds
|
||||
6. `git push forgejo <branch>` succeeds
|
||||
7. `git status` shows the branch is up to date with `forgejo/<branch>`
|
||||
|
||||
For tasks that do require turn documentation, the document may be brief when scope is small, but it must clearly explain what changed and how it was validated.
|
||||
|
||||
## Plan Mode Documentation
|
||||
|
||||
When working in plan mode, do not modify implementation files.
|
||||
|
||||
At the end of plan mode, provide a concise summary of the plan and ask the user whether they want to proceed with implementation.
|
||||
|
||||
If the user asks to save the plan, create a user-readable HTML plan document in:
|
||||
|
||||
```text
|
||||
docs/plans/
|
||||
```
|
||||
|
||||
Use a clear timestamped filename:
|
||||
|
||||
```text
|
||||
docs/plans/YYYY-MM-DD-short-plan-name.html
|
||||
```
|
||||
|
||||
The plan document should be labeled clearly as a plan and should include:
|
||||
|
||||
1. **Plan Summary**
|
||||
2. **Goals**
|
||||
3. **Proposed Changes**
|
||||
4. **Relevant Context**
|
||||
5. **Implementation Steps**
|
||||
6. **Risks, Limitations, and Mitigations**
|
||||
7. **Open Questions**
|
||||
|
||||
Always do the following when you finish a task, finish the beads workflow and and make a commit:
|
||||
- Document the changes in a user-readable format
|
||||
- Use the impeccable skill to structure the document as HTML
|
||||
- Create a clear, concise summary of the changes at the top, followed by a detailed description of the changes, including any relevant context or background as well as specific code snippets or examples.
|
||||
- Note any relevant issues or limitations that were addressed or mitigated by the changes.
|
||||
- The HTML file should be stored in the `docs/turns` directory. It should include the current date and time, as well as a brief explanation of changes. e.g. docs/turns/YYYY-MM-DD-{description}.html
|
||||
|
||||
|
|
|
|||
|
|
@ -255,7 +255,7 @@
|
|||
buildSettings = {
|
||||
CODE_SIGN_STYLE = Automatic;
|
||||
CURRENT_PROJECT_VERSION = 1;
|
||||
DEVELOPMENT_TEAM = "";
|
||||
DEVELOPMENT_TEAM = C3V8C7JRTL;
|
||||
GENERATE_INFOPLIST_FILE = NO;
|
||||
INFOPLIST_FILE = Dreamio/Info.plist;
|
||||
LD_RUNPATH_SEARCH_PATHS = (
|
||||
|
|
@ -276,7 +276,7 @@
|
|||
buildSettings = {
|
||||
CODE_SIGN_STYLE = Automatic;
|
||||
CURRENT_PROJECT_VERSION = 1;
|
||||
DEVELOPMENT_TEAM = "";
|
||||
DEVELOPMENT_TEAM = C3V8C7JRTL;
|
||||
GENERATE_INFOPLIST_FILE = NO;
|
||||
INFOPLIST_FILE = Dreamio/Info.plist;
|
||||
LD_RUNPATH_SEARCH_PATHS = (
|
||||
|
|
|
|||
7
Dreamio.xcodeproj/project.xcworkspace/contents.xcworkspacedata
generated
Normal file
7
Dreamio.xcodeproj/project.xcworkspace/contents.xcworkspacedata
generated
Normal file
|
|
@ -0,0 +1,7 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<Workspace
|
||||
version = "1.0">
|
||||
<FileRef
|
||||
location = "self:">
|
||||
</FileRef>
|
||||
</Workspace>
|
||||
BIN
Dreamio.xcodeproj/project.xcworkspace/xcuserdata/kell.xcuserdatad/UserInterfaceState.xcuserstate
generated
Normal file
BIN
Dreamio.xcodeproj/project.xcworkspace/xcuserdata/kell.xcuserdatad/UserInterfaceState.xcuserstate
generated
Normal file
Binary file not shown.
|
|
@ -0,0 +1,14 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
|
||||
<plist version="1.0">
|
||||
<dict>
|
||||
<key>SchemeUserState</key>
|
||||
<dict>
|
||||
<key>Dreamio.xcscheme_^#shared#^_</key>
|
||||
<dict>
|
||||
<key>orderHint</key>
|
||||
<integer>0</integer>
|
||||
</dict>
|
||||
</dict>
|
||||
</dict>
|
||||
</plist>
|
||||
Loading…
Add table
Add a link
Reference in a new issue