Skip to content

Latest commit

 

History

History
415 lines (353 loc) · 25.1 KB

github-tracking.md

File metadata and controls

415 lines (353 loc) · 25.1 KB

GitHub tracking adoption

Authorized scope

The owner explicitly approved a dedicated GitHub Project and linked issues during project initialization on 2026-11-10. Repository: Zanark/Intercom (public). Only the public-safe numbered workstreams are mirrored.

Tracking authority does not authorize commits, pushes, deployment, scheduling, Actions workflows, remote secrets, permission changes or private-continuity publication. The owner subsequently requested the initial documentation push; commit 3e2693cf2875af96f728e56a5066c7065aecaf93 was pushed to main. The later explicit research-push request completed as 20632243c38ae4a2689ffbdb676a2d70ff1c4a96, independently verified on main. Neither completed request was standing authority to publish later prototype work. The owner's subsequent explicit EXE-release request authorized committing/ pushing the .1 prototype and publishing its unsigned Windows prerelease. That completed publication is not standing authority for later .2/.3/.4/.5/.6 releases. The microphone request initially authorized input choice and brief device checks. Publication and asset receipts are recorded after independent verification, not inferred from the packaging command.

The owner subsequently authorized a repository testing action and explicitly approved committing/pushing only its changes and executing it against the published source, keeping the unfinished speech/controller rebuild local. The same follow-up restores transparent rising/falling logo fill, brightens both logo microphones and replaces the inspiration table with floating HTML. The workflow has main-push, pull-request and manual triggers, pinned actions, read-only contents access and no persisted checkout credential. Hosted tests receive no local credential runner/PAT, private Context Mesh or real session. They use disposable profiles/synthetic input; failure uploads are confined to the synthetic desktop-results directory for three days. This is not release, deployment, remote-secret or permission-change authority.

On 2026-11-13, after failed owner acceptance and a pause, the owner explicitly requested pushing the changes and recording the disappointment in the README and development journey. This authorizes publication of the reviewed pending public source/tests/documentation and the accountability record. It does not authorize further runtime implementation, owner-app interaction, a binary release, deployment, broader permissions or private logs/context publication.

Source of truth and operation

Local numbered .todo files own descriptions, tasks, dependencies, criteria, evidence, and completion. Each has a stable Workstream ID and GitHub issue backlink. Mirror that source in the issue body after a stable HTML marker: <!-- intercom-workstream:ic-01 --> or the corresponding ID.

This adoption is agent-driven manual reconciliation, not an automatic synchronizer. No daemon or repository-local sync runtime is installed. On an authorized workstream update:

  1. Read the local file, its linked issue, and its Project item.
  2. Check saved mapping and existing markers before creating anything.
  3. Compare the normalized body hash with the saved baseline below. Stop on unexpected issue-body edits or unexplained state changes. Preserve human comments; never silently overwrite conflicting content.
  4. Update the managed issue description from the public-safe workstream, excluding the self-referential GitHub issue line.
  5. Reconcile issue state and actual Project status separately.
  6. Read back body, state, Project membership/status, and local backlink.
  7. Record partial success explicitly and reuse saved IDs on retry.

Preview before creating a workstream issue. A failed/uncertain read is not an empty inventory. Do not delete issues/items or recreate a missing mapping without reconciling its stable marker. Remote board movement does not rewrite local status. New remote writes need applicable authority.

Status mapping

Use the Project's discovered built-in status options, recorded in the mapping below; do not guess option IDs.

Local status Issue Project stage
NOT_STARTED Open Todo
IN_PROGRESS Open In Progress
BLOCKED Open, blocker retained in body Todo unless already actively underway
DONE Closed / completed Done

Reopening a workstream reopens the same issue. Cancellation/supersession needs an explicit decision and must not be reported as completed.

Initial inventory and preview

Observed baseline: zero repository issues, no linked Project, and no existing owner Project named Intercom. Existing unrelated Projects remain untouched.

  • Include ic-01: repository foundation and continuity; initially active.
  • Include ic-02: product decisions and first-slice definition; not started.
  • Exclude 00_INDEX.todo: navigation, not a feature issue.
  • Exclude 03_DEVELOPMENT_LEDGER.todo: perpetual history, not a feature issue.
  • Never include .agent-context, raw chats, secrets, or private evidence.

Voice-assistant roadmap preview (2026-11-10)

The existing tracking authorization covers these public-safe workstream descriptions, not runtime execution or publication of private research:

  • Update existing ic-02 / #2 to IN_PROGRESS / Open / In Progress.
  • Add ic-04: existing Agency connector qualification; NOT_STARTED / Open / Todo.
  • Add ic-05: speech and wake qualification; NOT_STARTED / Open / Todo.
  • Add ic-06: gated desktop voice/mesh slice; NOT_STARTED / Open / Todo.
  • Add ic-07: gated reliability/lifecycle qualification; NOT_STARTED / Open / Todo.
  • Keep ic-01 / #1 unchanged. Continue excluding index, ledger, private continuity, audio, session catalog/transcripts and installation receipts.

Workstream IDs and file numbers stay stable; issue numbers are independent. Before mutation, verify the existing two body hashes/states and Project stages, inventory markers to prevent duplicate creation, then read back the final six issue-backed mappings. The preview itself is not a completion receipt.

Credentials

Use the shared manual's reviewed scripts/with_github_token.py runner with trusted gh commands. Never inspect, print, copy, or package its local .env, and never replace global authentication. This external runner is not a bundled Intercom dependency or a synchronizer; without it, provision authorized access locally without putting credentials in chat.

Verified mapping

Dedicated owner Project: https://github.com/users/Zanark/projects/13, title Intercom, private visibility. It is linked to Zanark/Intercom. Repository issues remain public; the private board is not a private-content upload boundary.

Workstream Local source Issue Project item ID
ic-01 TODO/01_PROJECT_FOUNDATION.todo #1 PVTI_lAHOAe2wCs4BrBRezhHi_ko
ic-02 TODO/02_PRODUCT_DECISIONS.todo #2 PVTI_lAHOAe2wCs4BrBRezhHi_lg
ic-04 TODO/04_AGENCY_CONNECTOR_PROOF.todo #3 PVTI_lAHOAe2wCs4BrBRezhHjXoI
ic-05 TODO/05_SPEECH_AND_WAKE_QUALIFICATION.todo #4 PVTI_lAHOAe2wCs4BrBRezhHjXsM
ic-06 TODO/06_DESKTOP_VOICE_MESH_SLICE.todo #5 PVTI_lAHOAe2wCs4BrBRezhHjXxs
ic-07 TODO/07_RELIABILITY_AND_LIFECYCLE.todo #6 PVTI_lAHOAe2wCs4BrBRezhHjX3c
ic-08 TODO/08_CONTEXT_RESEARCH.todo #7 PVTI_lAHOAe2wCs4BrBRezhINCpI
ic-09 TODO/09_INTEGRATED_VOICE_OVERLAY.todo #8 PVTI_lAHOAe2wCs4BrBRezhINCxs

Project node: PVT_kwHOAe2wCs4BrBRe. Status field: PVTSSF_lAHOAe2wCs4BrBRezhpVzH8. Discovered options: Todo f75ad846, In Progress 47fc9ee4, Done 98236657. Issue nodes: ic-01 I_kwDOVph7S88AAAABeBr3Dw; ic-02 I_kwDOVph7S88AAAABeBr5IA; ic-04 I_kwDOVph7S88AAAABeCG3oA; ic-05 I_kwDOVph7S88AAAABeCG83g; ic-06 I_kwDOVph7S88AAAABeCHBXg; ic-07 I_kwDOVph7S88AAAABeCHHsQ.

Initial foundation reconciliation on 2026-11-10 verified exactly two issues and issue-backed items: ic-01 CLOSED / COMPLETED / Done and ic-02 OPEN / Todo. Both original descriptions were compared before the foundation completion update; ic-02 required no mutation at that stage.

The later voice-roadmap reconciliation verified those saved body hashes, states, stages and identities before writing. It updated the same ic-02 issue to OPEN / In Progress and created ic-04 through ic-07 as OPEN / Todo. Independent full GraphQL read-back verifies exactly six issues, six unique issue-backed items, exact local description equality, all six backlinks, states/status option IDs, private Project visibility, and the sole repository link. ic-01's body and completion state remain unchanged. No background sync, hosted automation, private session output, or audio was published.

The subsequent speed-first/selectable-priority clarification updated the same ic-02, ic-05, ic-06 and ic-07 issues after all six prior body/state/stage baselines matched. Independent read-back again verified full description equality and unchanged issue/item identities and statuses. The hashes below include that clarification; no new issue, runtime or permission was introduced.

The deep-research reconciliation compared all six saved bodies/states/stages again, updated only the existing ic-02 and ic-04 through ic-07 descriptions, and independently read back complete bodies, backlinks, identities, status option IDs, visibility and membership. All six original mappings and stages remain unchanged. The baselines below now include that research; no new issue/item, application runtime, commit or research push was created.

The separately authorized prototype reconciliation checked all six research baselines before writing. It updated only #2 and #5 descriptions and moved the existing #5 Project item to In Progress. Independent full read-back verified all six complete bodies, original issue/item identities, backlinks, states/status option IDs, private visibility and sole repository linkage. #1 remains CLOSED/COMPLETED/Done; #2 and #5 are OPEN/In Progress; #3, #4 and #6 remain OPEN/Todo. The early fixture UI does not complete the live voice/Agency criteria or waive #5's dependencies. Hashes below now include this milestone.

The 2026-11-11 release reconciliation again matched all six prior baselines before updating only the existing #2/#5 descriptions for microphone choice, packaging and verified prerelease publication. Independent full-body read-back verified all six descriptions, backlinks, original issue/item identities, states/stages, private Project visibility and sole repository membership. No stage changed and no issue/item was created; #5 remains In Progress because its integrated voice/Agency acceptance criteria remain open. The hashes below now include this release receipt.

The bounded voice-conversation reconciliation matched all six branding baselines before updating only existing #2/#3/#4/#5 descriptions. It moved the existing #3/#4 Project items to In Progress; no issue state, identity or membership changed. Independent complete-body read-back verified all six descriptions, backlinks, original issue/item IDs, status options, private visibility and sole repository linkage. #1 remains CLOSED/COMPLETED/Done; #2/#3/#4/#5 are OPEN/In Progress; #6 remains OPEN/Todo. No private target UUID, audio or raw session log was published. The .3 local candidate is not a new release.

The .4 complete-slice reconciliation matched all six conversation baselines before updating only existing #2/#3/#4/#5 descriptions. Independent read-back verified all six complete bodies, backlinks, original issue/item identities, states/status option IDs, private Project visibility and sole repository link. No state/stage or mapping changed; no new issue, item, commit, push or release. The updated evidence distinguishes native source work from packaged fixtures, saved-grant behavior from actual permission prompts, and manual terminal entry from automatic handoff. Full-product qualification workstreams remain open.

The .5 graph/window-controls reconciliation matched all six .4 baselines before updating only the existing #5 description. Independent complete-body read-back verified all six identities, backlinks, issue states, Project statuses/membership and private visibility. No state/stage change, new issue/item or release.

Managed-body conflict baselines

The .6 floating-controls reconciliation matched all six .5 baselines before updating only the existing #5 description. Independent complete-body read-back verified all six identities, backlinks, issue states, Project statuses/membership and private visibility. No state/stage change, new issue/item or release.

Compute SHA-256 over UTF-8 body text after converting CRLF to LF and stripping trailing whitespace only. The HTML identity marker is included. Local projection excludes only the GitHub issue: line. Before an update, compare the actual remote body against this saved baseline, then separately compare the new local projection. Update these hashes only after an authorized conflict-free write and exact read-back; never refresh them merely to hide a remote edit.

Workstream Verified remote body SHA-256
ic-01 452fec62b3a05c01027a3d0af899ea9e3d3e85375ab383d9595934f24657b6a8
ic-02 5fa92bc3e1d2f20a27fc5306664d4e4d599e704f8fc64208323afb19a9c894f6
ic-04 ac026513ad44f8548d9e3670037d5efcb2e94c9287728bf781e9f5e48efefd82
ic-05 a6124020b8f8ffc3dfb5f19b318f9a75da26ab52158b90216477e86be9ddcea7
ic-06 f6a7b7b302863c082e3230592d56795f5d3f5fd3c9faf66ad7838c6f4e51a86e
ic-07 599dd5c24fc3f41cc2b54c6844b32c145a99b7c57c5d9e36d4c38b88d9d6fe50
ic-08 1551c0bc9593a2b8775642c0a0824a99a9b94e936955c6d9e3d4678ba884465a
ic-09 677ba1c8df81bd7fd395e6c5cede096b5aef3894193373c522d5a1712f53e27d

The 2026-11-13 accountability reconciliation compared the existing #6/#8 body hashes, states and original Project items before updating only those two descriptions. Independent complete-body/state/item/stage/backlink read-back verified #6 remains OPEN / In Progress and #8 remains CLOSED / Done for its bounded technical scope, explicitly not overall owner acceptance. Private Project visibility and sole Intercom repository linkage were verified. No new issue/item, comment rewrite, stage change or runtime fix was made. The updated baselines above include the failed acceptance and permission blocker. Index and perpetual ledger remain excluded from feature tracking.

The 2026-11-13 clarification-reply reconciliation verified the existing ic05/#4 body baseline, OPEN/In Progress state, issue/item identity, private Project13, status options and sole linked repository before updating its public-safe body. Independent full readback verified exact body, unchanged issue/item/stage and local backlink before recording the new baseline. No new issue, stage change, other item update, source publication or remote release was performed.

The 2026-11-12 integrated .16 reconciliation first verified all six prior body/state/stage/identity baselines, the private Project and sole linked repo. It updated existing #4/#5 without changing their In Progress stages and created the public-safe ic08/#7 and ic09/#8 mirrors as CLOSED/completed/Done items. Independent complete body/state/Project readback verified all four changes and all four untouched originals. Local backlinks preserve those identities. This is bounded technical completion, not human acceptance or remote release.

The subsequent .17 portable/diagnostic reconciliation compared ic07/#6's saved body, OPEN state, original issue/item identities and Todo stage before writing. Only that existing public-safe description and its existing Project item changed; the issue remains OPEN and its item is now In Progress. Independent full-body/state/item/status/backlink readback verifies the update, private Project visibility, exact status options and sole repository linkage. Two bounded tasks are technically complete; broader lifecycle acceptance stays open. No new issue/item, source publication, private log or remote release.

The accumulated ic06 source exceeded GitHub's 65,536-character body limit. Before any writes, its 20,016-character historical completion log was moved verbatim into the existing perpetual ledger, retaining a current Completion log and explicit link in the stable workstream. Preserved text SHA-256: 490e86b6c3abd797d2fdbceab87caebe552b062795ef206eb3238c7f733e6830. No evidence was truncated and no duplicate feature issue was created. The existing credential runner verified Zanark. Its gh project shorthand could not resolve the owner type; explicit read-only GraphQL established the actual configuration before trusted, scoped API writes. No auth settings, visibility, permissions, source commit/push/tag or hosted automation changed.

The approved glass/water publication matched all six saved body/state/Project baselines before updating only #5 with the reviewed visual-only workstream projection. Full independent readback verified all six bodies and unchanged issue/item identities, private Project membership and stages; #5 remains OPEN / In Progress. Owner visual acceptance, exact-source checks and five refreshed GIF/still pairs are recorded separately from human speech or release qualification. Unfinished speech/controller drafts remain outside this public projection. Earlier media milestones below are historical.

The earlier glass-bubble README refresh matched #5's saved body baseline before adding only its two media tasks and public-safe capture evidence/log to the existing projection. Exact full-body read-back and the original Project-item node verified #5 remains OPEN / In Progress on private Project 13, with the same issue/item identities and unchanged stage. Other issues were not changed or requalified in this narrow update. At that milestone, source/media stayed local; unfinished runtime drafts are not exported, committed, pushed or released.

The final README refinement reconciliation matched all six saved baselines, then updated only #5 with the short inspiration/larger photo, smooth unbanded microphones, restored original logo geometry, glowing waves, dense fictional application demos and supplied wallpaper. Independent full-body readback verified all six issue identities/states and the unchanged complete Project. Unfinished speech/controller drafts remain outside the public projection; ic-06 stays OPEN / In Progress. No release or runtime switch is implied.

The switchboard-inspiration reconciliation matched all six saved baselines before updating only existing #5's public-safe README task/evidence/log. Independent complete-body read-back verified all six original bodies (apart from #5's intended additions), issue/item identities, states and private Project membership/stages. No speech draft, new issue/item or release change. The owner separately authorized a coherent README/media push and explicitly confirmed permission to publish the supplied historical photograph.

The GUI/microphone-artwork follow-up checked all six saved body/state/Project baselines, then updated only existing #5's artwork-only projection: restored wordmark font, matching microphone pigment and isolated GUI recordings. Independent full read-back verified all six bodies, original identities, states and Project membership/stages. No dirty speech draft was exported, issue/item created, state moved, commit pushed or release changed.

These reconciliations used the same saved issue/item identities on read-back and confirmed no duplicates. Automated retry, reopening, and conflict tests are not claimed because no sync runtime was introduced.

The .7 voice-profile reconciliation matched all six .6 baselines before updating only existing #5's description. Independent complete-body read-back verified all six identities, backlinks, issue states, Project statuses/membership and private visibility. No new issue/item, state/stage change or publication. Local installed voices and native/profile checks are implemented; the required richer synthesis engine and human/performance acceptance remain explicitly open.

The subsequent owner-authorized .7 publication reconciliation matched all six voice-profile baselines before updating only existing #5's description with the verified source/tag, release and anonymous-download receipts. Independent complete-body read-back verified all six backlinks, issue/item identities, states, Project stages/membership and private visibility. No new issue/item or completion/state change. The release tag remains at the qualified source; the separate receipt-doc commit does not move it or replace either release.

The animated-README reconciliation matched all six publication baselines before updating only existing #5's description with the qualified presentation milestone. Independent complete-body read-back verified #5 equals its local projection; the other five issues are unchanged. All six original issue/item identities, states and Project stages, private visibility and sole repository membership remain intact. No new issue/item, product completion, source push or release.

The node-inspection reconciliation matched all six animated-README baselines before updating only existing #5's description with the local source milestone. Independent complete-body read-back matches the local projection; the other five issues are unchanged. Original identities, issue states, Project stages, private visibility and sole-repository membership remain intact. No new issue/item, package, commit, push or release; ic-06 remains In Progress.

The microphone-fix reconciliation matched all six node-inspection baselines before updating only existing #5's description. Independent complete-body read-back equals the local projection; the other five issues are unchanged. Original identities, issue states, Project stages, private visibility and sole-repository membership remain intact. The .8 executable is a separate local candidate, not a new release. No new issue/item or completion/state change; physical-device and broader product acceptance remain open.

The owner subsequently authorized committing and pushing the animated README and node-inspection source changes. This is separate from the completed .7 prerelease and does not authorize replacing its source tag, binary or assets.

The whole-repository reorganization matched all six saved baselines before updating the same #1-#5 descriptions with rebased source/documentation paths and ic-06 qualification evidence. Complete independent read-back verifies all six bodies, original issue/item identities, backlinks, issue states and Project stages, private visibility and sole-repository membership. #6 is unchanged; no issue/item or status was created. ic-06 remains In Progress. The owner's explicit reorganization-and-push request authorizes that source commit/push, not a release/tag, binary upload or active-app restart.

The owner's subsequent explicit push-and-release request authorized the new unsigned .12 prerelease. Qualified source 48ceeb9ed4d60f08a28528e03040cd595fb1f944 was pushed and tagged separately from the publication receipt. Release 441617942 was checked as a draft, published nondraft/prerelease and anonymously downloaded; EXE/checksum bytes match the local package. Previous .7/.1 releases/tags and local .11 remain unchanged. After all six body/state/Project baselines matched, only existing #5's description was updated with the final evidence. Independent full-body read-back verified all six original identities, states, backlinks and private Project stages/membership. ic-06 remains In Progress; no new issue/item, stable-release promotion, additional real task or active-app restart.

The focused-glass controls/live-waves/README-wings reconciliation checked all six saved baselines before updating only existing #5. Independent fresh full GraphQL read-back equals every local public-safe projection using the documented line-ending/trailing-newline normalization. All six original issue/item IDs, states, backlinks, private Project stages and membership remain unchanged. ic-06 stays In Progress. The separately qualified same-version candidate is local/unpublished; no new issue, source push, tag, release or user-app update.

The frosted sea-glass artwork reconciliation matched all six saved baselines and HEAD workstream projections before updating only existing #5. Independent full GraphQL read-back verifies its artwork-only staged projection; the other five bodies, all six original identities/backlinks/states, private Project membership and status options remain unchanged. ic-06 stays In Progress. Unfinished local speech/orchestration drafts are intentionally excluded from this publication and remote projection; their qualification remains open. No new issue/item, runtime change, tag, release or user-app update.

The ethereal-waves/brush-wordmark follow-up matched all six saved baselines before updating only existing #5's artwork-only projection. Independent full read-back verified its exact description and all six original issue/item identities, states, private Project membership and status options. Unfinished speech drafts remain excluded; ic-06 stays In Progress. Tracking is updated, but the follow-up artwork has not been committed, pushed or released.