feat: prepare IC Copilot public launch

Author: mwsp-code

.devcontainer/devcontainer.json

@@ -0,0 +1,19 @@
+{
+  "name": "IC Copilot",
+  "build": {
+    "dockerfile": "../Dockerfile",
+    "context": ".."
+  },
+  "overrideCommand": true,
+  "remoteUser": "appuser",
+  "forwardPorts": [8501],
+  "postCreateCommand": "python -m pip install -e '.[dev]'",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "ms-python.python",
+        "charliermarsh.ruff"
+      ]
+    }
+  }
+}

.dockerignore

@@ -0,0 +1,13 @@
+.git
+.github
+.idea
+.pytest_cache
+__pycache__
+*.pyc
+*.log
+.env
+.env.local
+data/*.db
+data/*.sqlite*
+venv
+docs/launch

.github/ISSUE_TEMPLATE/adr_profile.yml

@@ -0,0 +1,33 @@
+name: Add or improve an ADR/FPI profile
+description: Propose a cross-listed security identity and reporting profile.
+title: "[ADR/FPI] "
+labels: ["data coverage", "good first issue"]
+body:
+  - type: input
+    id: security
+    attributes:
+      label: Security and issuer
+      placeholder: BABA / 9988.HK - Alibaba Group Holding Limited
+    validations:
+      required: true
+  - type: textarea
+    id: identity
+    attributes:
+      label: Identity details
+      description: Include ADR ratio, ordinary listing, reporting currency, home exchange, fiscal year-end, and primary forms.
+    validations:
+      required: true
+  - type: textarea
+    id: sources
+    attributes:
+      label: Official sources
+      description: List issuer IR and exchange/regulator URLs. Do not paste credentials or licensed full text.
+    validations:
+      required: true
+  - type: textarea
+    id: tests
+    attributes:
+      label: Proposed fixtures
+      description: Explain identity, ratio, currency, and filing-form tests.
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/bug.yml

@@ -0,0 +1,50 @@
+name: Bug report
+description: Report a reproducible app, provider, parser, or research-workflow defect.
+title: "[Bug]: "
+labels: [bug]
+body:
+  - type: markdown
+    attributes:
+      value: Never include API keys, proxy credentials, licensed reports, or local databases.
+  - type: input
+    id: ticker
+    attributes:
+      label: Ticker or demo
+      placeholder: AAPL, BABA, or frozen demo
+  - type: dropdown
+    id: profile
+    attributes:
+      label: Research profile
+      options: [Fast Screening, Adaptive IC Research, Deep Initiation, Investigate This Event, Frozen demo]
+  - type: textarea
+    id: behavior
+    attributes:
+      label: What happened?
+      description: Include the visible error and the workflow stage.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+    validations:
+      required: true
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Reproduction steps
+    validations:
+      required: true
+  - type: input
+    id: environment
+    attributes:
+      label: Environment
+      placeholder: Windows 11, Python 3.11, Streamlit 1.x
+  - type: checkboxes
+    id: safety
+    attributes:
+      label: Safety check
+      options:
+        - label: I removed credentials, private research, and licensed full text.
+          required: true
+

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,9 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Research methodology discussion
+    url: https://github.com/mwsp-code/IC-Copilot/discussions
+    about: Discuss research design, playbooks, evidence gates, and roadmap ideas.
+  - name: Security report
+    url: https://github.com/mwsp-code/IC-Copilot/security/policy
+    about: Report credential, source-integrity, or local API vulnerabilities privately.
+

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,26 @@
+name: Feature request
+description: Propose an analyst workflow or contributor improvement.
+title: "[Feature]: "
+labels: [enhancement]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Analyst or contributor problem
+    validations:
+      required: true
+  - type: textarea
+    id: workflow
+    attributes:
+      label: Proposed workflow
+    validations:
+      required: true
+  - type: textarea
+    id: integrity
+    attributes:
+      label: Evidence, licensing, and failure-state considerations
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance criteria
+

.github/ISSUE_TEMPLATE/sector_playbook.yml

@@ -0,0 +1,30 @@
+name: Sector or industry playbook
+description: Add material drivers, KPIs, peers, valuation methods, and falsification tests.
+title: "[Playbook]: "
+labels: [sector-playbook, good-first-issue]
+body:
+  - type: input
+    id: sector
+    attributes:
+      label: Sector or industry
+    validations:
+      required: true
+  - type: textarea
+    id: economics
+    attributes:
+      label: Business economics and material KPIs
+    validations:
+      required: true
+  - type: textarea
+    id: peers
+    attributes:
+      label: Curated peers and selection rationale
+  - type: textarea
+    id: valuation
+    attributes:
+      label: Valuation and credit methods
+  - type: textarea
+    id: tests
+    attributes:
+      label: Confirmation, contradiction, and fixture cases
+

.github/ISSUE_TEMPLATE/source_adapter.yml

@@ -0,0 +1,42 @@
+name: Source adapter proposal
+description: Propose or implement a registered official, market, macro, or research provider.
+title: "[Source]: "
+labels: [source-adapter]
+body:
+  - type: input
+    id: provider
+    attributes:
+      label: Provider and endpoint family
+    validations:
+      required: true
+  - type: dropdown
+    id: tier
+    attributes:
+      label: Proposed source tier
+      options: [Tier 1 primary, Tier 2 official/context, Tier 3 licensed/reporting, Tier 4 unofficial/narrative]
+  - type: textarea
+    id: fields
+    attributes:
+      label: Research fields and causal-bridge use
+    validations:
+      required: true
+  - type: textarea
+    id: licensing
+    attributes:
+      label: Authentication, entitlement, licensing, and retention policy
+    validations:
+      required: true
+  - type: textarea
+    id: fallback
+    attributes:
+      label: Failure classification and fallback
+  - type: checkboxes
+    id: contract
+    attributes:
+      label: Adapter contract
+      options:
+        - label: I will preserve timestamps, citations, units, currencies, provider health, and no-lookahead eligibility.
+          required: true
+        - label: Normal tests will use fixtures and require no live credentials.
+          required: true
+

.github/dependabot.yml

@@ -0,0 +1,12 @@
+version: 2
+updates:
+  - package-ecosystem: pip
+    directory: "/"
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 5
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: monthly
+

.github/pull_request_template.md

@@ -0,0 +1,23 @@
+## What changed
+
+Describe the user or research problem and the smallest useful change.
+
+## Evidence integrity
+
+- [ ] Source URL, publication/filing time, period, unit, and currency are preserved.
+- [ ] Missing values remain `Unknown` rather than zero.
+- [ ] No-lookahead behavior is preserved.
+- [ ] LLM output cannot introduce unsupported facts, citations, targets, or promotion.
+- [ ] No credentials, licensed full text, databases, logs, or vendor payloads are included.
+
+## Verification
+
+- [ ] Targeted tests added or updated.
+- [ ] Full test suite passes.
+- [ ] Streamlit startup smoke check passes when UI behavior changed.
+- [ ] Screenshots included for visible UI changes.
+
+## Data and licensing
+
+List new providers, endpoints, licensing constraints, retention rules, and fallbacks.
+