Skip to content

Latest commit

 

History

History
14 lines (12 loc) · 3.08 KB

AGENTS.md

File metadata and controls

14 lines (12 loc) · 3.08 KB

WebOS source organization rules

Source organization is complete. The current phase is site integration from the organized independent repositories, within the user's selected app/fix scope. Do not restart extraction, copy beta, pursue full beta parity or replace the existing interface. Latest user decisions supersede older migration plans/checkpoints. Read START-HERE.md for the current accepted release and next-work decisions.

  • Original /path/to/workspace/Documents/KSU.CODES is read-only. No checkout, reset, stash, clean, install, build or Git metadata writes there. Prefer GIT_OPTIONAL_LOCKS=0 for inspection.
  • Each meaningful app/component owns an independent repository; this parent pins them as submodules. Apps belong in apps/, platform services in platform/, reusable engines in engines/, libraries in libraries/, shared assets in assets/, build tooling in tooling/. No repository per helper/button.
  • The intended existing Desktop/Workspace source is platform/desktop/active-system/. Do not restore the rejected replacement from old branches/checkpoints, rewrite the viewer or make discretionary UI changes. The removed replacement builder/harnesses are not the development baseline.
  • Preserve source, local commits, staged/unstaged/untracked work and required inputs before changing ownership/refs. Keep raw recovery/state/evidence private outside Git/web roots. Do not commit credentials, private documents or real databases.
  • Temporary compiler/build output is disposable and must not be committed. Do not duplicate large working trees or build merely to validate source organization. Get approval for additional broad cleanup; the approved11 Cargo caches have already been deleted. Required vendored/runtime inputs are distinct from temporary compiler output.
  • Craft main/master tracks its verified public upstream; WebOS changes stay on a separate webos/... branch. Preserve all local work before moving refs. No upstream pushes, force pushes or history rewriting. Source organization does not authorize merging upstream functionality or advancing parent pins.
  • Do not change either website, routing, account data, services or deployment without separate explicit authorization. No external Git publication or messaging is authorized. Verified local bare origins/local commits and public upstream reads are allowed. Never guess a private Git address or weaken host-key checks.
  • Keep app/source originality, source-only cores, build inputs, dependency boundaries and actual production gaps explicit. Do not claim an app can be produced just because a directory or manifest exists. Do not weaken tests or fabricate compatibility.
  • Final output: a category-sorted component/app matrix with source location, entry/build recipe, human/background/server/browser/file/launcher relationships, functional priority and honest production readiness/gaps. Files/accounts/storage/runtime outrank games for functional WebOS, regardless of popularity.
  • Keep short factual updates, evidence and resumable checkpoints. Do not resume the retired broad-rebuild objective from historical documents. Read START-HERE.md for current source navigation.