Skip to content

fix(download): suggest filed-return download paths#26

Merged
lamemustafa merged 8 commits into
masterfrom
tapish-codex/pack-multi-year-downloads
Jun 30, 2026
Merged

fix(download): suggest filed-return download paths#26
lamemustafa merged 8 commits into
masterfrom
tapish-codex/pack-multi-year-downloads

Conversation

@lamemustafa

@lamemustafa lamemustafa commented Jun 29, 2026

Copy link
Copy Markdown
Owner

Summary

Suggest deterministic Pack download paths for filed-return PDF downloads and persist single-period completion summaries for popup status.

Root Cause / Decision Record

  • The live GST flow could reach the correct filed GSTR-3B page, but the browser/native download surface could still produce poor file placement or stale popup status.
  • A broader pure-MV3 direct-request/blob-capture experiment was reviewed and removed because live testing did not prove no-dialog PDF completion and it expanded sensitive PDF-byte handling.
  • This is the smallest safe fix: use Chrome's download filename suggestion hook for matching GST PDF downloads, keep completion evidence tied to chrome.downloads, and keep full-year ledger state authoritative.

Scope

  • Runtime: Adds a filename suggester around the portal-click download path and shares the safe filed-return filename builder with direct downloads.
  • Tests: Adds filename-suggester tests and extends full-year/single-period flow-runner coverage.
  • Docs/governance: None.
  • Explicitly out of scope: No GSTIN/PAN path segments, no browser setting changes, no native-helper/CDP path, no request-discovery replay, no blob/data-url PDF capture.

Pack Workflow Preflight

  • pnpm workflow:preflight was run before editing/push, or the skip reason is documented.
  • This PR was opened from a Pack branch, not master.
  • I checked latest master Pack AGENTS guidance or recorded the stale-guidance warning.
  • PR body keeps the required Pack privacy/review/verification checklist visible.

Preflight note: pnpm workflow:preflight hung silently in the pnpm wrapper in this Codex shell, but the underlying script passed with node scripts/check-pack-workflow-preflight.mjs.

Privacy And Data-Flow Impact

  • No new browser permissions.
  • No new host permissions.
  • No new network calls.
  • No analytics, telemetry, ads, or session replay.
  • No credential, OTP, CAPTCHA, cookie, token, GST file, or taxpayer-data capture.
  • Public copy and privacy declarations are updated if behaviour changed.

No public copy or privacy declaration change is needed: the change is local download filename suggestion and session summary persistence only.

Sensitive Surface Review

  • Current tab / portal target binding is preserved or intentionally changed.
  • Download completion remains evidence-backed and fail-closed.
  • Ambiguous side-effect delivery cannot be reported as confirmed success.
  • Service-worker durability impact is understood and documented.
  • Real taxpayer data, local paths, raw URLs/referrers, and portal HTML are absent from the diff.

The suggested filename includes only product folder, GST area, fiscal year, filing type, and period. It deliberately excludes GSTIN/PAN/taxpayer names and does not persist local filesystem paths.

Chrome Web Store Impact

  • This PR does not claim Chrome Web Store readiness, approval, or submission.
  • Full fiscal year remains source-build alpha unless every gate in docs/PUBLICATION_READINESS.md is checked.
  • Store copy, README status, Privacy QA, and reviewer instructions were reviewed if user-facing behavior changed.
  • CI ZIP creation is treated as package verification only, not store-submission sign-off.

Verification

  • pnpm install --frozen-lockfile
  • pnpm audit --audit-level high
  • pnpm exec wxt prepare
  • pnpm exec prettier --check .
  • pnpm exec eslint . --max-warnings 0
  • pnpm exec tsc --noEmit
  • pnpm exec vitest run
  • pnpm exec wxt build
  • node scripts/verify-extension-package.mjs .output/chrome-mv3
  • pnpm exec wxt zip
  • node scripts/verify-extension-zip.mjs
  • git diff --check
  • pnpm review:gate -- --strict-head-review --required-review-author chatgpt-codex-connector --wait-head-review-ms 180000 before merge/readiness claim, or reason not run: ran and timed out because no current-head chatgpt-codex-connector review was produced for 3da297078e6973a770aea0d8cb95f7e96cf366c2.

Additional focused verification:

  • pnpm exec vitest run tests/background/filed-returns-flow-runner.test.ts tests/background/download-filename-suggester.test.ts tests/background/download-observer.test.ts
  • node scripts/check-pack-workflow-preflight.mjs

Artifact Evidence

PR Review Follow-Up

  • GitHub Actions completed.
  • Autogenerated Codex/bot review comments inspected after checks completed for the latest head SHA.
  • Inline review threads are resolved, outdated, or answered with evidence.
  • No commits were pushed after the last required human/bot review without re-review.
  • Any follow-up PRs are listed here instead of being left implicit.
Thread/comment Disposition Commit or evidence
Current-head Codex review follow-up @codex review was acknowledged with an eyes reaction, but no formal review or inline comments were produced before the strict 180s gate timed out for 3da297078e6973a770aea0d8cb95f7e96cf366c2.

Screenshots

Use synthetic data only.

DCO

  • Commits include Signed-off-by: trailers.

Signed-off-by: Tapish Khandelwal <tapishkhandelwal13@gmail.com>
@lamemustafa lamemustafa force-pushed the tapish-codex/pack-multi-year-downloads branch from 5222f64 to 3da2970 Compare June 29, 2026 17:20
@lamemustafa lamemustafa marked this pull request as ready for review June 29, 2026 17:24
@lamemustafa

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 3da297078e

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread src/background/download-filename-suggester.ts Outdated
Comment thread src/background/filed-returns-flow-runner.ts Outdated
Comment thread src/background/filed-returns-download-trigger.ts Outdated
Comment thread src/background/filed-returns-flow-runner.ts Outdated
Signed-off-by: Tapish Khandelwal <tapishkhandelwal13@gmail.com>

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f1c8f4e3c7

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread src/background/download-correlation.ts Outdated
Comment thread src/background/filed-returns-flow-runner.ts
Signed-off-by: Tapish Khandelwal <tapishkhandelwal13@gmail.com>
@lamemustafa

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: dce4ed7eb9

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread src/background/filed-returns-flow-runner.ts Outdated
Comment thread src/background/download-filename-suggester.ts Outdated
Comment thread src/background/filed-returns-current-state.ts Outdated
Comment thread src/background/filed-returns-download-trigger.ts
Signed-off-by: Tapish Khandelwal <tapishkhandelwal13@gmail.com>
@lamemustafa

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 47001a808b

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread src/background/filed-returns-flow-runner.ts Outdated
Signed-off-by: Tapish Khandelwal <tapishkhandelwal13@gmail.com>
@lamemustafa

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 02cf54506a

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread src/background/download-filename-suggester.ts Outdated
Comment thread src/background/filed-returns-flow-runner.ts
Comment thread src/background/filed-returns-flow-runner.ts
Comment thread src/background/download-correlation.ts Outdated
@lamemustafa

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f0597a8939

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread src/background/filed-returns-download-trigger.ts
Comment thread src/background/filed-returns-current-state.ts Outdated
Comment thread src/background/filed-returns-target-review.ts
@lamemustafa

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 0a20d622ec

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread src/background/filed-returns-current-state.ts
Comment thread src/background/filed-returns-download-trigger.ts
Comment thread src/background/filed-returns-flow-runner.ts Outdated
@lamemustafa

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Swish!

Reviewed commit: 774d8f4257

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@lamemustafa lamemustafa merged commit 94f0456 into master Jun 30, 2026
12 checks passed
@lamemustafa lamemustafa deleted the tapish-codex/pack-multi-year-downloads branch June 30, 2026 06:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant