{
  "schema": "jp.website.connected-source-sheets.v1",
  "version": "V000009",
  "auditedAtNpt": "2026-11-17",
  "repository": "FabinGurung/jp-estimating-and-boq",
  "folderName": "Cost Estimation — Working Google Sheets",
  "folderUrl": "https://drive.google.com/drive/folders/1v0yTowZ8mbTtT7euPgrPeEndFKPPH0IU",
  "owner": "Cost Estimation — original working sheets and source custody",
  "policy": "Eight original working/reference Cost Estimation Google Sheets are registered: four established authenticated source-import paths, two optional manual-only aggregate readers (Vendor Bills V000004 and Contractor Bills V000002; neither proven authenticated), and two reference/template Sheets. One permanent editable Drive authority per source; no archived duplicate becomes LIVE. GitHub Pages is public-safe counts only, never private invoice rows or payments. No cron, no periodic intervals. Controlled updates use A7 PRE → same live ID → source QA → POST.",
  "records": [
    {
      "ref": "JP-AEC-RATE-MASTER",
      "title": "Construction Rate and Cost References",
      "authority": "Original generic cost/rate master Sheet",
      "usedFor": "Rate source/reference for the existing analysis workbench",
      "usagePage": "rate-workbench.html",
      "publicationStatus": "Reusable reference workbook; not an authenticated scheduled rates feed",
      "originalFolder": "04_COST_RATE_REFERENCES / 01_AEC_COST_RATE_MASTER__LIVE_REGISTER",
      "kind": "working_reference",
      "doesNotImply": "Current approved district/standard rates",
      "fetchContract": {
        "mode": "REFERENCE_ONLY",
        "importer": null,
        "readTabs": [],
        "output": "rate-workbench.html",
        "approval": "Not an authenticated current-rate feed"
      }
    },
    {
      "ref": "RE-AMRIT-RATE-LIVE",
      "title": "Amrit Rawat — Site Construction Rates (Indicative)",
      "authority": "One permanent LIVE client-specific 32-row indicative rate Sheet",
      "usedFor": "Project rate assumptions (14 plinth + 12 trade + 6 daily wages)",
      "usagePage": "projects/rohini/ward-14/amrit-rawat/cost-planning.html",
      "publicationStatus": "Authenticated source read verified; 32 rates remain indicative and unapproved",
      "originalFolder": "Rohini / Ward 14 / 14_Amrit_Rawat",
      "kind": "client_live_source",
      "doesNotImply": "Measured quantities or approved contract unit rates",
      "fetchContract": {
        "mode": "AUTHENTICATED_ON_MANUAL_INVOKED_WORKFLOW",
        "importer": "scripts/sync-amrit-rawat-rates.mjs",
        "readTabs": [
          "01_PLINTH_RATES",
          "02_TRADE_RATES",
          "03_DAILY_WAGES",
          "90_VERSION_HISTORY"
        ],
        "output": "projects/rohini/ward-14/amrit-rawat/rates.public.json",
        "approval": "USER_SUPPLIED_INDICATIVE_NOT_APPROVED",
        "trigger": "Manual main Amrit rate-sync workflow; versioned source change and research-branch deploy"
      }
    },
    {
      "ref": "RE-AMRIT-QTO-BOQ-LIVE",
      "title": "Amrit Rawat — Measurements, BOQ, Cost Summary and Bills",
      "authority": "One permanent LIVE project measurement and billing workbook",
      "usedFor": "Project entry register, future verified QTO/BOQ/AOC and contractor/vendor invoices",
      "usagePage": "projects/rohini/ward-14/amrit-rawat/measurements/index.html",
      "publicationStatus": "Authenticated during Pages deployment; no verified measurements or approved rates admitted at the latest recorded check",
      "originalFolder": "Rohini / Ward 14 / 14_Amrit_Rawat",
      "kind": "client_live_source",
      "doesNotImply": "Completed measured work, payable certificate or money paid",
      "fetchContract": {
        "mode": "AUTHENTICATED_ON_MANUAL_INVOKED_PAGES_DEPLOY",
        "importer": "scripts/build_amrit_project_from_google_sheets.py",
        "readTabs": [
          "01_MEASUREMENTS",
          "02_RATE_SELECTIONS",
          "03_BOQ",
          "04_AOC",
          "05_CONTRACTOR_RA",
          "06_VENDOR_INVOICES",
          "07_PAYMENT_ALLOCATIONS",
          "90_VERSION_HISTORY"
        ],
        "output": "projects/rohini/ward-14/amrit-rawat/project-costing.json",
        "approval": "Only independently verified measurements and approved rate selections admitted; never infer approved BOQ or payable bills",
        "trigger": "Manual Cost Estimation Pages refresh or user-authorized publishing commit"
      }
    },
    {
      "ref": "JP-COSTING-MASTER-TEMPLATE",
      "title": "Construction Costing — Reusable Workbook Template",
      "authority": "Reusable blank template, NOT a project LIVE input",
      "usedFor": "New project workbook schema and training (no live project facts)",
      "usagePage": "measurements-boq.html",
      "publicationStatus": "Blank reusable template; not an active project feed",
      "originalFolder": "03_JP_Cost_Estimation / 02_HUMAN_WORKING_SHEETS",
      "kind": "template_only",
      "doesNotImply": "A sixth project source or a payable BOQ",
      "fetchContract": {
        "mode": "TEMPLATE_ONLY_NO_FETCH",
        "importer": null,
        "readTabs": [],
        "output": "measurements-boq.html",
        "approval": "No client data authority"
      }
    },
    {
      "ref": "RE-KKG-FINANCE-LIVE",
      "title": "Krishna Kumar Gupta — Payments to Projects — LIVE — V1.1",
      "authority": "Rohini Engineering and Builders, 14 Bishal Paija; NEW clean native three-tab LIVE ID after A7 V000007 retirement of the old 20-tab source. V000002 control; 27 directly editable vendor mini-tables, 74 original unique payment IDs, formula-linked amount/discount/QR and Total. Google Drive remains private source authority.",
      "usedFor": "Source-recorded Rohini Bishal Paija project payments with live human-maintained vendor mini-tables; 74 original events and 27 original vendor IDs reconciled; Amount/QR/Discount separately preserved. Financial certification pending.",
      "usagePage": "finance-dashboard.html",
      "publicationStatus": "KKG V1.1 / V000002: Drive source native three-tab / manual mini-table QA confirmed. Existing GitHub WIF authenticated source reader replaced, but a fresh V1.1 GitHub Pages read must be independently verified before claiming public-current publication.",
      "originalFolder": "03_JP_Cost_Estimation / 02_HUMAN_WORKING_SHEETS / Cost Estimation — Working Google Sheets",
      "kind": "finance_live_source",
      "doesNotImply": "Actual approved bank payment, certified contractor bill, Fabin Gurung accounting or cross-project allocation",
      "fetchContract": {
        "mode": "AUTHENTICATED_ON_MANUAL_INVOKED_PAGES_DEPLOY",
        "importer": "scripts/build_finance_from_google_sheets.py",
        "readTabs": [
          "Total",
          "Bishal Paija",
          "00_SYSTEM_MEMORY"
        ],
        "output": "finance-public-snapshot.json",
        "approval": "Rohini Bishal Paija private V1.1 LIVE source only; 74 original events and 27 vendor groups source-reconciled. No bank/tax approval or cross-company join.",
        "trigger": "User-invoked Research Pages deploy with existing WIF identity: exact one governed LIVE-title Drive metadata discovery; NEVER the retired V0.5 source ID. Read only three native V1.1 tabs and validate each vendor mini-table against linked summary and Total. No cron."
      },
      "controlVersion": "V000002",
      "presentationVersion": "V1.1 — 3 visible native tabs, 27 mini-tables, source only not bank-certified"
    },
    {
      "ref": "JP-FABIN-PAYMENTS-LIVE",
      "title": "Fabin Gurung — Payments to Projects — Working v0.7",
      "authority": "Existing native LIVE Fabin payment source; control version V000004, 439 normalized source events remain V000001",
      "usedFor": "Authenticated per-project source-reported Finance aggregates; does not certify paid expenditure or disclose private transaction-level data",
      "usagePage": "finance.html",
      "publicationStatus": "HISTORICALLY_AUTHENTICATED_BUT_CURRENTLY_BLOCKED: the Fabin source changed to eight active tabs with consolidated 00_SYSTEM_MEMORY; old adapter still requires missing normalized source tabs. New authenticated read FAILED on 17 Nov 2026 (Actions 44040022127); tracked in Estimation issue #62. Do not claim current fresh Fabin data. Original Google Sheet is unchanged by this publishing repair.",
      "originalFolder": "Historical finance and purchasing evidence under 03_JP_Cost_Estimation / 03_PROJECT_PAYMENT_REGISTERS; LIVE source now in 02_HUMAN_WORKING_SHEETS",
      "kind": "finance_live_source",
      "doesNotImply": "A current successfully refreshed Fabin source after 17 Nov 2026; no payment approval, verified project IDs, evidence approval, or Basketball/Prithivi deduplication",
      "fetchContract": {
        "mode": "AUTHENTICATED_ON_MANUAL_INVOKED_PAGES_DEPLOY",
        "importer": "scripts/build_fabin_finance_from_google_sheets.py",
        "readTabs": [
          "00_MANIFEST",
          "01_PROJECTS",
          "02_PARTY_REGISTER",
          "03_PAYMENT_EVENTS",
          "04_RECONCILIATION",
          "05_PROJECT_SUMMARY",
          "06_REVIEW_QUEUE",
          "90_VERSION_HISTORY",
          "Total",
          "04_Basketball",
          "09_prithivi Mandi",
          "14_kharika_poudel",
          "13_hari_baral",
          "31_sharada_adhikari",
          "14_bishal_paija"
        ],
        "output": "fabin-payments-public.json",
        "approval": "SOURCE_REPORTED_NOT_APPROVED; 19/19 Basketball/Prithivi overlaps deferred; Hari Baral NPR 500 top summary linked in V000004, source arithmetic now matches but payment not certified",
        "trigger": "Normal publishing runs currently blocked by current source-tab drift; previous authenticated reads were valid at their original publication time, but current Fabin importer must be updated under issue #62. On the explicitly authorized one-time [vendor-manual-read] release ONLY, Fabin source is deliberately skipped with a written warning, without touching Fabin Sheets."
      }
    },
    {
      "ref": "JP-VENDOR-BILLS-LIVE",
      "title": "Vendor Bills — Working Register — LIVE",
      "authority": "Permanent native working register within Cost Estimation; 35 original source tabs and 11 derived/guide/control tabs, human-first arrangement V000004; original Excel retained",
      "usedFor": "Supplier bills, invoices and detail/delivery evidence; project/vendor source summaries, review queue and manual normalization QA",
      "usagePage": "memory-posters.html#vendor-bills-intake",
      "publicationStatus": "Public deployed sourceMode is determined by the current vendor-bills-status.v1.json: VERIFIED_SNAPSHOT or MANUAL_AUTHENTICATED_READ. User-authorized source read requested 17 Nov; never infer live status merely from an Actions build.",
      "originalFolder": "03_JP_Cost_Estimation / 02_HUMAN_WORKING_SHEETS / Cost Estimation — Working Google Sheets",
      "kind": "vendor_bills_manual_source",
      "doesNotImply": "An approved bill, verified supplier/legal identity, certified project expenditure, or proof of money paid; source evidence remains in private Drive",
      "controlVersion": "V000004",
      "normalizedDataVersion": "V000001",
      "liveTabCount": 46,
      "originalSourceTabs": 35,
      "fetchContract": {
        "mode": "OPTIONAL_AUTHENTICATED_ON_MANUAL_DISPATCH",
        "importer": "scripts/build_vendor_bills_public.py",
        "readTabs": [
          "00_MANIFEST",
          "VB_SOURCE_INDEX",
          "VB_BILL_RECORDS",
          "VB_DETAIL_ROWS",
          "VB_RECONCILIATION",
          "VB_REVIEW_QUEUE"
        ],
        "output": "data/vendor-bills-status.v1.json",
        "approval": "0 APPROVED; 509 OPEN; candidate project and supplier mappings not verified; 2 Hari Baral differences unresolved",
        "trigger": "Explicit workflow_dispatch with require_live_sheets=true, or a user-authorized publishing commit tagged [vendor-manual-read]. Existing WIF Google Viewer account finds one exact-title LIVE workbook by Drive metadata when optional JP_VENDOR_BILLS_SHEET_ID private secret is absent. Only successful verified read may publish MANUAL_AUTHENTICATED_READ.",
        "historicalPublication": "GitHub Pages push deploys VERIFIED_SNAPSHOT, independent of Google Sheets direct access",
        "privacy": "Source ID and invoice data remain in private Drive; exact-title discovery fails on missing/ambiguous source. Existing publisher Viewer access granted 17 Nov 2026."
      }
    },
    {
      "ref": "JP-CONTRACTOR-BILLS-LIVE",
      "title": "03 — Bill of Contractors — Working Register — LIVE",
      "authority": "Permanent native contractor work-claim register in Cost Estimation; 6 original source tabs preserved plus 2 controls and 10 CT_ human/normalized QA tabs, A7 V000002 PRE/POST, normalized data V000001",
      "usedFor": "Contractor work claim summaries, line descriptions, source rates/dates, historical overlap comparisons, project/party candidate mapping, manual evidence review; not a certified payable or payment register",
      "usagePage": "memory-posters.html#contractor-bills-intake",
      "publicationStatus": "A 17 Nov 2026 manually authorized GitHub Actions run verified MANUAL_AUTHENTICATED_READ V000002 (6 source tabs, 80 rows, 2 claims, 33 work items, 16 OPEN reviews). The checked-in JSON remains a VERIFIED_SNAPSHOT fallback on ordinary builds.",
      "originalFolder": "03_JP_Cost_Estimation / 02_HUMAN_WORKING_SHEETS / Cost Estimation — Working Google Sheets",
      "kind": "contractor_bills_manual_source",
      "doesNotImply": "Contractor certificate, quantity measurement approval, legally verified party, correct project allocation, supplier invoice or money paid; private original and A7 audit in restricted Google Drive",
      "controlVersion": "V000002",
      "normalizedDataVersion": "V000001",
      "liveTabCount": 18,
      "originalSourceTabs": 6,
      "fetchContract": {
        "mode": "OPTIONAL_AUTHENTICATED_ON_MANUAL_DISPATCH",
        "importer": "scripts/build_contractor_bills_public.py",
        "readTabs": [
          "00_MANIFEST",
          "CT_CLAIM_REGISTER",
          "CT_WORK_ITEMS",
          "CT_HISTORICAL_ROWS",
          "CT_RECONCILIATION",
          "CT_REVIEW_QUEUE",
          "CT_SOURCE_INDEX",
          "Hari_Chaudhari",
          "Khem_Bahadur_Thapa"
        ],
        "output": "data/contractor-bills-status.v1.json",
        "approval": "0 APPROVED claims; 16 OPEN evidence flags; candidate party/project identities and units unverified; 34 overlapping historical rows excluded from sums",
        "trigger": "Explicit manual research Pages workflow_dispatch with require_contractor_live=true, OR a user-authorized publishing commit tagged [contractor-manual-read]. Existing WIF Google identity discovers the single viewer-shared exact-title LIVE workbook by Drive metadata if JP_CONTRACTOR_BILLS_SHEET_ID private secret is absent; only a verified read may publish MANUAL_AUTHENTICATED_READ.",
        "historicalPublication": "GitHub Pages push deploys VERIFIED_SNAPSHOT V000002; manual authenticated read is NOT implied",
        "privacy": "Never commit the live Sheet ID, private bills or row-level values. Optional secret override, or exact LIVE-title discovery through Drive metadata with existing viewer-shared WIF identity."
      }
    }
  ],
  "exclusions": [
    "PRE/POST version archives",
    "Unadmitted intake copies",
    "Superseded workbooks",
    "PDF/CAD originals",
    "GitHub JSON publication snapshots",
    "Communication & Web repository's source Sheets"
  ],
  "notes": [
    "The original five Google Sheet IDs did not change; the sixth Fabin working native Sheet was added without changing its ID. All six now share the same Cost Estimation Google Sheets source folder.",
    "Fabin Finance and Purchasing evidence folder moved into 03_JP_Cost_Estimation / 03_PROJECT_PAYMENT_REGISTERS with its original folder ID. Restricted worker Money & Goods folder was moved separately to Fishtail Builders / Manpower, not to Cost Estimation.",
    "Tab names, source rows and existing formulas in both finance source workbooks remain authoritative. A7 PRE/POST archives remain in dedicated per-subject version folders.",
    "Amrit rates and measurements plus KKG and Fabin Finance are four authenticated live inputs; generic rate references and costing template are not live project data.",
    "Fabin V000004: Hari Baral party was linked into the original top summary, removing the NPR 500 arithmetic discrepancy; the historical correction remains in PRE/POST. The 19/19 Prithivi duplicate source events remain pending owner review. No payments were certified.",
    "The legacy 34-Sheet Operations/Website Source Directory is a historical cross-topic source index, not the current Cost Estimation publisher roster. Its data should be consumed through dedicated owning repositories with explicit source/readback status.",
    "Individual private Sheet IDs and payment rows are omitted from the public machine inventory; GitHub uses the existing read-only WIF service-account identity.",
    "No cron or unattended source-refresh interval is approved; the default-branch daily-named workflow filenames are retained only to preserve existing GitHub workflow links and are now manual workflow_dispatch routes.",
    "Vendor Bills LIVE is the seventh working/reference Sheet; A7 V000004 rearranged tabs human-first without changing 35 original source worksheet names or any invoice values. Full private QA and PRE/POST log stay in the existing audit Google Doc in the same restricted working folder.",
    "Vendor Bills is an OPTIONAL manual authenticated fetch, unlike the four pre-existing authenticated paths. Its currently verified V000004 publication remains a snapshot. The associated read-only Google identity and repository secret must be confirmed via a distinct manually dispatched workflow.",
    "Contractor Bills V000002 is the eighth official working/reference Google Sheet. The original live native ID was retained and moved into the Cost Estimation working folder; all 6 source tabs, original formulas and original Excel evidence were preserved, two empty tabs hidden not deleted. A7 PRE/POST and private contractor QA Doc are in their governed folders.",
    "User-made Vendor Bills manual duplicate created 16 Nov 2026 was archived in its Vendor Bills history folder as MANUAL_COPY, not a formal PRE/POST nor another LIVE authority; original Vendor Bills ID unaffected.",
    "Contractor Bills new aggregate is a VERIFIED_SNAPSHOT. Configured optional manual authenticated source adapter still requires user-side private secret and Google IAM read access; do not label it a live Google read before verified Actions evidence.",
    "17 Nov 2026: service account jp-pages-publisher granted Viewer to the original Contractor Bills LIVE Google Sheet; optional manual importer now supports exact-title Drive metadata discovery. No new GitHub secret is strictly required for a unique shared file. The authenticated read must still pass an Actions run; ordinary pushes retain VERIFIED_SNAPSHOT.",
    "17 Nov 2026: Krishna Kumar Gupta original permanent working Sheet V000005 aligned to Fabin source governance: Total, Bishal Paija linked five-column mini-tables and 00_SYSTEM_MEMORY added; original 27/74 records and native tables unchanged; PRE/POST archived privately.",
    "17 Nov 2026: Vendor Bills publisher service account granted Viewer on exact original LIVE file; authenticated optional importer now resolves the unique exact title using existing WIF/Drive metadata without new secret. Manual or user-authorized marked push required; ordinary push retains snapshot.",
    "Public source role cards must read the deployed aggregate's sourceMode for Vendor and Contractor; a configured adapter or GitHub success alone does not certify a current authenticated source read.",
    "17 Nov 2026 deployment issue #62: original Fabin workbook currently has 8 tabs (Total, six human project tabs, 00_SYSTEM_MEMORY), while old authenticated script expects removed 00_MANIFEST, 01_PROJECTS, 03_PAYMENT_EVENTS, etc. The earlier authenticated source path is presently incompatible. A Vendor-only manual release may bypass that single failed reader with explicit warning, but other source adapters and Fabin source cells must remain untouched.",
    "17 Nov 2026: Krishna Kumar Gupta old 20-tab v0.5 working source retired to A7 history after full PRE; new native V1.1 (V000002) has exactly Total / Bishal Paija / 00_SYSTEM_MEMORY. 27 vendor mini-tables, 74 original entries with separate amount/discount/QR; new V000002 PRE/POST archived privately. Estimation reader now discovers unique exact LIVE title and validates schema with WIF; live publication must be independently QA-confirmed."
  ],
  "operatorPolicy": {
    "mode": "MANUAL_FIRST_NO_CRON",
    "userInitiatedTriggers": [
      "Manual workflow_dispatch from GitHub Actions",
      "User-authorized repository edit/push that invokes the existing Pages build"
    ],
    "automatedIntervalMinutes": null,
    "templateTestHarness": "NOT_BUILT",
    "liveSourceAuthority": "Existing Google Sheets in their owning Drive area",
    "sourceMutationsByPages": false,
    "privacy": "PUBLIC_SITE_HAS_SOURCE_NAMES_ROLES_AND_TABS_ONLY; NEVER_PRIVATE_SHEET_IDS_OR_RAW_PAYMENT_ROWS",
    "publishingBranch": "research/open-estimation-engine-v0.1",
    "manualPagesWorkflow": ".github/workflows/cost-estimation-daily-pages-refresh.yml",
    "researchPagesWorkflow": ".github/workflows/deploy-research-pages.yml",
    "amritRatesManualWorkflow": ".github/workflows/amrit-rawat-daily-sheet-sync.yml",
    "updatedOn": "2026-11-17",
    "claim": "Current live source-read status must be separately verified: KKG and Amrit authenticated reader earlier pass, Vendor/Contractor explicitly manual, Fabin current importer on HOLD due eight-tab schema drift tracked issue #62. Vendor-only marked deploy bypasses Fabin with explicit warning, not a current Fabin read. No scheduled intervals."
  }
}
