folder-classifier 0.3.5__py3-none-any.whl → 0.3.6__py3-none-any.whl

folder_classifier/classifier.py

@@ -11,7 +11,7 @@ SYSTEM_PROMPT = """
 You are a strict text classifier.
 Output MUST be a single JSON object with exactly two keys: "category" and "reasoning".
 - "category" ∈ {"matter","other"} (lowercase).
-- "reasoning" ≤ 30 words, citing rule IDs (e.g., RC+R7 or R1+R3) and up to two brief evidence tokens.
+- "reasoning" ≤ 30 words, citing rule IDs (e.g., RC1+R7 or R1+R3) and up to two brief evidence tokens.
 - Do not include any double-quote (") characters inside the value of "reasoning"; use single quotes ' instead.
 - No backticks, no code fences, no extra text. Return one JSON object only.
 No step-by-step thinking. No extra keys. If unsure, choose "other".
@@ -29,26 +29,24 @@ Definitions
   (d) there are zero files with extensions anywhere in the tree, or
   (e) contents are exclusively non-legal domains (finance/accounting/IT/admin) with no legal-work indicators, or
   (f) the ROOT NAME is non-matter-specific, including either:
-      (f1) system/provenance roots (e.g., “CORTO Generated”, “Exports”, “Uploads”, “Dropbox Shared”, “OneDrive”, “SharePoint”,
-           “Archive”, “Backup”, “Temp”, “Incoming”, “Outbox”, “Bulk Import”), or
-      (f2) informal/placeholder roots lacking client/company/matter cues (e.g., “hello”, “test”, “misc”, “docs”, “files”,
-           “images”, “photos”, “scans”, “new folder”, “untitled”, “random”; very short single tokens with no digits).
+      (f1) system/provenance roots (e.g., “CORTO Generated”, “Exports”, “Uploads”, “Dropbox Shared”, “OneDrive”, “SharePoint”, “Archive”, “Backup”, “Temp”, “Incoming”, “Outbox”, “Bulk Import”), or
+      (f2) informal/placeholder roots lacking client/company/matter cues (e.g., “hello”, “test”, “misc”, “docs”, “files”, “images”, “new folder”, “untitled”, very short single tokens with no digits).
 
 Decision Rules (apply in order; case-insensitive)
 RC_container: Any indication the FOLDER TREE holds more than one distinct matter → category=other.
-  • Signals include: ≥2 top-level subfolders whose names match matter-like patterns (e.g., “<number> - <id>”, “<client> - <topic>”), even if those subfolders are empty.
-  • Repetitive top-level “matter-number” patterns also indicate a container.
-R0_subfolder: ROOT NAME equals a common matter subfolder/stage/type (e.g., Correspondence/Emails, File Notes/Attendance Notes, Searches/Certificates, Court Documents/Pleadings/Evidence/Disclosure/Discovery, Drafts/Final/Signed/Executed, Billing/Invoices/Time Records) → category=other.
-R7_files_present: Must contain ≥1 file with an extension (e.g., .pdf, .docx) anywhere in the tree; if none → category=other.
-R8_nonlegal_only: If the tree shows strong non-legal domain signals and NO legal-work indicators (R2–R4 or R6), classify as other.
-  • Finance/Accounting examples: BAS/IAS/GST/Tax Return, PAYG, payroll/timesheets/payslips, superannuation, Xero/MYOB/QuickBooks exports, GL/Trial Balance/Journals, bank statements, invoices/receipts, reconciliations, aged AR/AP, debtor/creditor lists, debtor collection schedules, AR “demand/reminder” letters in collections context.
-  • IT/Systems examples: backups, logs, source code, Git/DevOps, server/network/VPN, mailboxes, workspace/365 admin.
-  • Admin-only examples: generic receipts/vendor invoices/expenses without legal context.
-R9_non_matter_specific_rootname: ROOT NAME is non-matter-specific → category=other.
-  • R9a_system_provenance: matches system/provenance roots (generated/export/import/shared/archive/backup/temp/uploads/
-                           downloads/platform names like Dropbox/OneDrive/SharePoint).
-  • R9b_placeholder_informal: matches informal/placeholder roots with no client/company/matter cues (single common words,
-                              “new folder”, “untitled”, short tokens without digits).
+  • Signals: ≥2 top-level subfolders with matter-like names (e.g., “<number> - <id>”, “<client> - <topic>”), even if those subfolders are empty; repetitive top-level matter-number patterns.
+R0_subfolder: ROOT NAME equals a common matter subfolder/stage/type → category=other.
+R7_files_present: Must contain ≥1 file with an extension (e.g., .pdf, .docx) anywhere; if none → category=other.
+R8_nonlegal_only: Strong non-legal domain signals and NO legal-work indicators (R2–R4 or R6) → other.
+  • Finance/Accounting: BAS/IAS/GST/Tax Return, PAYG, payroll/timesheets/payslips, superannuation, Xero/MYOB/QuickBooks exports, GL/Trial Balance/Journals, bank statements, invoices/receipts, reconciliations, aged AR/AP, debtor/creditor lists, debtor collection schedules, AR “demand/reminder” letters in collections context.
+  • IT/Systems: backups, logs, source code, Git/DevOps, server/network/VPN, mailboxes, workspace/365 admin.
+  • Admin-only: generic receipts/vendor invoices/expenses without legal context.
+R9_non_matter_specific_rootname: Non-matter-specific ROOT NAME → category=other.
+  • R9a_system_provenance: generated/export/import/shared/archive/backup/temp/uploads/downloads/platform names (Dropbox/OneDrive/SharePoint, etc.).
+  • R9b_placeholder_informal: informal/placeholder words with no client/company/matter cues (“hello”, “test”, “misc”, “docs”, “files”, “new folder”, “untitled”, short tokens without digits).
+R10_legal_filename_semantics: If files exist but **no filename** in the tree is legal-sounding (and R2–R4/R6 are absent) → category=other.
+  • Legal-sounding filename cues (non-exhaustive): agreement/contract/deed/will/affidavit/statement/brief/advice/retainer/engagement/costs disclosure/pleadings/statement of claim/defence/court form/subpoena/orders/judgment/undertaking/notice/settlement/consent orders/particulars/summons/witness statement/statutory declaration.
+  • Generic/non-informative basenames (e.g., “test.pdf”, “doc1.pdf”, “file.pdf”, “notes.pdf”, “scan.pdf”, “image001.pdf”) **do not** count as legal-sounding.
 R1_rootname: ROOT NAME resembles a single matter/container (matter/case/file number; client/surname/company; or a combination like “12345 Smith”, “Smith – Contract Dispute”, “Brown – Lease Review”).
 R2_initial_docs: Early-stage matter docs (cost agreement/disclosure, retainer/engagement, intake/onboarding).
 R3_legal_docs: Legal document types (agreement, contract, deed, will, affidavit, statement, advice, brief, pleadings, court forms, subpoena, orders, judgment, undertaking, notice of appeal, docket/case forms).
@@ -61,8 +59,8 @@ Decision
 - Else if R0_subfolder → category=other (stop).
 - Else if NOT R7_files_present → category=other (stop).
 - Else if R8_nonlegal_only → category=other (stop).
-- Else if R9_generic_rootname → category=other (stop).
-- Else if R10_weak_rootname → category=other (stop).
+- Else if R9_non_matter_specific_rootname → category=other (stop).
+- Else if R10_legal_filename_semantics → category=other (stop).
 - Else if R1_rootname AND any of {R2, R3, R4, R6} AND no multi-matter signal → category=matter.
   (R5 is supportive only and cannot justify "matter" by itself.)
 - Else → category=other.
@@ -72,7 +70,7 @@ Normalization
 - Treat hyphens/underscores as separators. Ignore extensions for semantic matching beyond presence. Tolerate minor typos.
 
 Output (JSON only; no prose before/after):
-{"category": "<matter|other>", "reasoning": "<≤30 words citing R# and 1–2 evidence tokens>"}
+{"category": "<matter|other>", "reasoning": "≤30 words citing R# and 1–2 evidence tokens>"}
 
 FOLDER TREE:
 {folder_tree}

{folder_classifier-0.3.5.dist-info → folder_classifier-0.3.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: folder-classifier
-Version: 0.3.5
+Version: 0.3.6
 Summary: Deploy folder classifier API to a Ray cluster
 Author: Crispin Almodovar
 Author-email: 

{folder_classifier-0.3.5.dist-info → folder_classifier-0.3.6.dist-info}/RECORD

@@ -1,10 +1,10 @@
 folder_classifier/__init__.py,sha256=k0YWZyUNe7myJiKeX0OaXtJ30_3EGE-vsZiAUbqa-3E,46
 folder_classifier/app.py,sha256=5eaniDWZFBvyI9UN4vOCc6TQwgyptAUVhRVgfrjp2F4,1259
-folder_classifier/classifier.py,sha256=wUoDr8GXajKQPF_zYMeJutpCfuIYVAfAUVjsePfjcIM,8591
+folder_classifier/classifier.py,sha256=yK154rXr-AEKZuf1d4YKhgbcCcPFK8nfuk4osd7XtLc,8820
 folder_classifier/deploy.py,sha256=06UAxz40IaP28e_RRohJoFwPUrWTaMquGbDylI-oHWA,424
 folder_classifier/dto.py,sha256=KRHEfXKlsIYkBySwHOlo4k5Z4J_F3eR3PeEdUAwj8lI,819
 folder_classifier/util.py,sha256=-Ptxkba5UzmhLrqoiiKZS3G56_cuAMkWlTyHcqdJkg0,3160
-folder_classifier-0.3.5.dist-info/METADATA,sha256=uFoRyzCLh4Gxzak0XktEohvbfHbM7g4Ow3RMoHcZxUs,546
-folder_classifier-0.3.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-folder_classifier-0.3.5.dist-info/top_level.txt,sha256=36ugc9pEbNQ-mnzz4Ot2WVjY3t_LzAN6XOCjDFP4p4k,18
-folder_classifier-0.3.5.dist-info/RECORD,,
+folder_classifier-0.3.6.dist-info/METADATA,sha256=e4498y5SfYg3zXaG35qK78tWFwPQxoIvNgo17yK0NNQ,546
+folder_classifier-0.3.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+folder_classifier-0.3.6.dist-info/top_level.txt,sha256=36ugc9pEbNQ-mnzz4Ot2WVjY3t_LzAN6XOCjDFP4p4k,18
+folder_classifier-0.3.6.dist-info/RECORD,,