@synctek/forgeos 2.0.0

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAshBjB,CAAC"}

package/dist/tools.js

@@ -0,0 +1,513 @@
+export const TOOLS = [
+    {
+        name: "forge_init",
+        description: "Initialize a ForgeOS governance session. Returns project state, active work, governance rules, workflow runbook, and setup scorecard so you know immediately what steps remain.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "string",
+                    description: "Project ID to initialize",
+                },
+                developer_id: {
+                    type: "string",
+                    description: "Developer identifier (default: local)",
+                },
+            },
+            required: ["project_id"],
+        },
+    },
+    {
+        name: "forge_create_initiative",
+        description: "Create a new initiative to track a piece of work. Returns the initiative with a generated ID.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "string",
+                    description: "Project ID",
+                },
+                title: {
+                    type: "string",
+                    description: "Initiative title",
+                },
+                description: {
+                    type: "string",
+                    description: "What this initiative accomplishes",
+                },
+                priority: {
+                    type: "string",
+                    enum: ["low", "medium", "high", "critical"],
+                    description: "Priority level",
+                },
+            },
+            required: ["project_id", "title", "description"],
+        },
+    },
+    {
+        name: "forge_propose_changeset",
+        description: "Propose a changeset for an initiative. Engine computes risk score and determines required gates, roles, and evidence. Returns changeset with risk profile, gate pipeline, and an immediate gate recommendation so you have the full risk analysis in one call.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "string",
+                    description: "Project ID",
+                },
+                initiative_id: {
+                    type: "string",
+                    description: "Initiative this changeset belongs to",
+                },
+                description: {
+                    type: "string",
+                    description: "What changed and why",
+                },
+                files_changed: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "File paths that changed",
+                },
+                modules_affected: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Module/area names affected",
+                },
+                branch: {
+                    type: "string",
+                    description: "Git branch name (optional)",
+                },
+            },
+            required: [
+                "project_id",
+                "initiative_id",
+                "description",
+                "files_changed",
+                "modules_affected",
+            ],
+        },
+    },
+    {
+        name: "forge_get_profile",
+        description: "Fetch a reviewer persona profile for local subagent injection. If project context is provided, the profile is enriched with Shared Mind patterns. Use the returned system_prompt as the subagent's instructions.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                role: {
+                    type: "string",
+                    enum: [
+                        "architect",
+                        "qa_test",
+                        "security",
+                        "performance",
+                        "reliability",
+                        "accessibility",
+                        "docs_release",
+                    ],
+                    description: "Quality review role",
+                },
+                project_id: {
+                    type: "string",
+                    description: "Project ID for contextualization (optional)",
+                },
+                team_id: {
+                    type: "string",
+                    description: "Team ID for Shared Mind context (default: default)",
+                },
+                modules_affected: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Modules to focus on",
+                },
+                files_changed: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Files to focus on",
+                },
+            },
+            required: ["role"],
+        },
+    },
+    {
+        name: "forge_submit_evidence",
+        description: "Submit evidence (test results, scan outputs, etc.) for a changeset. Auto-populates gate evidence requirements.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "string",
+                    description: "Project ID",
+                },
+                changeset_id: {
+                    type: "string",
+                    description: "Changeset ID",
+                },
+                type: {
+                    type: "string",
+                    enum: [
+                        "unit_test",
+                        "coverage",
+                        "lint",
+                        "security_scan",
+                        "benchmark",
+                        "migration_plan",
+                        "ux_snapshot",
+                        "a11y_audit",
+                        "ai_review",
+                    ],
+                    description: "Evidence type",
+                },
+                summary: {
+                    type: "string",
+                    description: "Summary of the evidence",
+                },
+                file_refs: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "File references (optional)",
+                },
+            },
+            required: ["project_id", "changeset_id", "type", "summary"],
+        },
+    },
+    {
+        name: "forge_submit_review",
+        description: "Submit a complete review with findings and verdict. Creates and finalizes the review in one call.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "string",
+                    description: "Project ID",
+                },
+                changeset_id: {
+                    type: "string",
+                    description: "Changeset ID",
+                },
+                role: {
+                    type: "string",
+                    description: "Review role (e.g. security, architect)",
+                },
+                status: {
+                    type: "string",
+                    enum: ["approved", "blocked", "pending"],
+                    description: "Review verdict",
+                },
+                notes: {
+                    type: "string",
+                    description: "Review summary",
+                },
+                findings: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            category: { type: "string" },
+                            severity: {
+                                type: "string",
+                                enum: ["pass", "warning", "concern", "fail"],
+                            },
+                            observation: { type: "string" },
+                            recommendation: { type: "string" },
+                        },
+                        required: ["category", "severity", "observation"],
+                    },
+                    description: "Structured findings from the review",
+                },
+            },
+            required: [
+                "project_id",
+                "changeset_id",
+                "role",
+                "status",
+                "notes",
+                "findings",
+            ],
+        },
+    },
+    {
+        name: "forge_check_gates",
+        description: "Get the gate pipeline status for a changeset. Shows which gates are passed, pending, or failed, and what's needed to advance.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "string",
+                    description: "Project ID",
+                },
+                changeset_id: {
+                    type: "string",
+                    description: "Changeset ID",
+                },
+            },
+            required: ["project_id", "changeset_id"],
+        },
+    },
+    {
+        name: "forge_promote_gate",
+        description: "Promote a gate to passed status. Requirements (evidence + roles) must be met. Advances the pipeline to the next gate.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "string",
+                    description: "Project ID",
+                },
+                changeset_id: {
+                    type: "string",
+                    description: "Changeset ID",
+                },
+                gate_id: {
+                    type: "string",
+                    enum: [
+                        "intent",
+                        "design",
+                        "implementation",
+                        "verification",
+                        "hardening",
+                        "release",
+                    ],
+                    description: "Gate to promote",
+                },
+                promoted_by: {
+                    type: "string",
+                    description: "Who is promoting (default: local_agent)",
+                },
+            },
+            required: ["project_id", "changeset_id", "gate_id"],
+        },
+    },
+    {
+        name: "forge_release_check",
+        description: "Check if a changeset is ready to release. Returns can_release status and any remaining blockers.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "string",
+                    description: "Project ID",
+                },
+                changeset_id: {
+                    type: "string",
+                    description: "Changeset ID",
+                },
+            },
+            required: ["project_id", "changeset_id"],
+        },
+    },
+    {
+        name: "forge_query_mind",
+        description: "Search the Shared Mind for institutional knowledge. Returns patterns, anti-patterns, and lessons relevant to the context.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                team_id: {
+                    type: "string",
+                    description: "Team ID (default: default)",
+                },
+                context: {
+                    type: "string",
+                    description: "Search context (keywords, module names, etc.)",
+                },
+                domain: {
+                    type: "string",
+                    description: "Specific domain to search (optional)",
+                },
+            },
+            required: ["context"],
+        },
+    },
+    {
+        name: "forge_observe",
+        description: "Record an observation to the Shared Mind. Use when you discover patterns, anti-patterns, or lessons during development.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                team_id: {
+                    type: "string",
+                    description: "Team ID (default: default)",
+                },
+                domain: {
+                    type: "string",
+                    description: "Knowledge domain (e.g. module name, technology)",
+                },
+                observation_type: {
+                    type: "string",
+                    enum: [
+                        "pattern",
+                        "anti-pattern",
+                        "fix-recipe",
+                        "architecture-decision",
+                        "lesson",
+                    ],
+                    description: "Type of observation",
+                },
+                content: {
+                    type: "string",
+                    description: "What was observed",
+                },
+                confidence: {
+                    type: "number",
+                    description: "Confidence 0.0-1.0 (default: 0.8)",
+                },
+                tags: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Tags for categorization",
+                },
+            },
+            required: ["domain", "observation_type", "content"],
+        },
+    },
+    {
+        name: "forge_get_workflow",
+        description: "Get the current workflow state for an initiative. Shows which step the developer is on, what's needed next, and overall progress.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                initiative_id: {
+                    type: "string",
+                    description: "Initiative ID",
+                },
+            },
+            required: ["initiative_id"],
+        },
+    },
+    {
+        name: "forge_create_project",
+        description: "Create a new ForgeOS project. Projects are the top-level container for initiatives, changesets, and governance workflows.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "Project name (e.g., 'my-saas-app', 'mobile-backend')",
+                },
+                description: {
+                    type: "string",
+                    description: "Brief description of the project",
+                },
+                platform: {
+                    type: "string",
+                    enum: ["web", "mobile", "api", "cli", "desktop", "other"],
+                    description: "Target platform (e.g., 'web', 'mobile', 'api', 'cli')",
+                },
+            },
+            required: ["name"],
+        },
+    },
+    {
+        name: "forge_quickstart",
+        description: "Create a sandbox project and run a complete governance cycle in seconds. Perfect for first-time setup and testing. Returns the full report including project, initiative, changeset, gates, and next steps.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: "forge_discover",
+        description: "Analyze your repository and get a recommended governance configuration based on your tech stack. Returns recommended preset, template, evidence mapping, and CI hints.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                languages: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Programming languages detected in the repo (e.g. ['typescript', 'python'])",
+                },
+                ci_tools: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "CI/CD tools in use (e.g. ['github-actions', 'circleci'])",
+                },
+                test_frameworks: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Testing frameworks detected (e.g. ['jest', 'pytest'])",
+                },
+                team_size: {
+                    type: "number",
+                    description: "Approximate team size (headcount)",
+                },
+                repo_type: {
+                    type: "string",
+                    description: "Type of repository (e.g. 'monorepo', 'service', 'library', 'mobile-app')",
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: "forge_get_presets",
+        description: "List available governance presets (Startup, Enterprise, Regulated, Mobile Release QA). Returns all presets with descriptions so you can choose the right gate template for your project.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: "forge_configure_project_gates",
+        description: "Configure the governance gate template for a project. Use a preset name or provide a custom template. This sets which gates are required and what evidence is needed to advance.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "string",
+                    description: "Project ID",
+                },
+                preset: {
+                    type: "string",
+                    description: "Preset name to apply (e.g. 'startup', 'enterprise', 'regulated', 'mobile_release_qa'). Mutually exclusive with custom_template.",
+                },
+                custom_template: {
+                    type: "object",
+                    description: "Custom gate template object. Mutually exclusive with preset.",
+                },
+            },
+            required: ["project_id"],
+        },
+    },
+    {
+        name: "forge_recommend_gates",
+        description: "Get a gate recommendation for a changeset based on risk analysis. Review the recommendation and configure gates accordingly. Returns risk analysis, recommended gates, minimum gates, and rationale.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: {
+                    type: "string",
+                    description: "Project ID",
+                },
+                changeset_id: {
+                    type: "string",
+                    description: "Changeset ID to analyse",
+                },
+            },
+            required: ["project_id", "changeset_id"],
+        },
+    },
+    {
+        name: "forge_scorecard",
+        description: "Check your ForgeOS setup completeness. Shows which onboarding steps are done and what to do next. Use this to verify your environment is fully configured.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: "forge_workflow_template",
+        description: "Get copy-paste workflow templates for common scenarios (bugfix, feature, hotfix, release candidate). Omit template_id to get all templates.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                template_id: {
+                    type: "string",
+                    description: "Template ID to fetch (e.g. 'bugfix', 'feature', 'hotfix', 'release_candidate'). Omit to list all.",
+                },
+            },
+            required: [],
+        },
+    },
+];
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,iLAAiL;QACnL,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,0BAA0B;iBACxC;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,uCAAuC;iBACrD;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,CAAC;SACzB;KACF;IACD;QACE,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EACT,+FAA+F;QACjG,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,YAAY;iBAC1B;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,kBAAkB;iBAChC;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,mCAAmC;iBACjD;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAiB;oBACvB,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC;oBAC3C,WAAW,EAAE,gBAAgB;iBAC9B;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,EAAE,OAAO,EAAE,aAAa,CAAC;SACjD;KACF;IACD;QACE,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EACT,gQAAgQ;QAClQ,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,YAAY;iBAC1B;gBACD,aAAa,EAAE;oBACb,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,sCAAsC;iBACpD;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,sBAAsB;iBACpC;gBACD,aAAa,EAAE;oBACb,IAAI,EAAE,OAAgB;oBACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;oBAClC,WAAW,EAAE,yBAAyB;iBACvC;gBACD,gBAAgB,EAAE;oBAChB,IAAI,EAAE,OAAgB;oBACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;oBAClC,WAAW,EAAE,4BAA4B;iBAC1C;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,4BAA4B;iBAC1C;aACF;YACD,QAAQ,EAAE;gBACR,YAAY;gBACZ,eAAe;gBACf,aAAa;gBACb,eAAe;gBACf,kBAAkB;aACnB;SACF;KACF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,kNAAkN;QACpN,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAiB;oBACvB,IAAI,EAAE;wBACJ,WAAW;wBACX,SAAS;wBACT,UAAU;wBACV,aAAa;wBACb,aAAa;wBACb,eAAe;wBACf,cAAc;qBACf;oBACD,WAAW,EAAE,qBAAqB;iBACnC;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,6CAA6C;iBAC3D;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,oDAAoD;iBAClE;gBACD,gBAAgB,EAAE;oBAChB,IAAI,EAAE,OAAgB;oBACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;oBAClC,WAAW,EAAE,qBAAqB;iBACnC;gBACD,aAAa,EAAE;oBACb,IAAI,EAAE,OAAgB;oBACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;oBAClC,WAAW,EAAE,mBAAmB;iBACjC;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;KACF;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EACT,gHAAgH;QAClH,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,YAAY;iBAC1B;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,cAAc;iBAC5B;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAiB;oBACvB,IAAI,EAAE;wBACJ,WAAW;wBACX,UAAU;wBACV,MAAM;wBACN,eAAe;wBACf,WAAW;wBACX,gBAAgB;wBAChB,aAAa;wBACb,YAAY;wBACZ,WAAW;qBACZ;oBACD,WAAW,EAAE,eAAe;iBAC7B;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,yBAAyB;iBACvC;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,OAAgB;oBACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;oBAClC,WAAW,EAAE,4BAA4B;iBAC1C;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,CAAC;SAC5D;KACF;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EACT,mGAAmG;QACrG,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,YAAY;iBAC1B;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,cAAc;iBAC5B;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,wCAAwC;iBACtD;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAiB;oBACvB,IAAI,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC;oBACxC,WAAW,EAAE,gBAAgB;iBAC9B;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,gBAAgB;iBAC9B;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,OAAgB;oBACtB,KAAK,EAAE;wBACL,IAAI,EAAE,QAAiB;wBACvB,UAAU,EAAE;4BACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;4BACrC,QAAQ,EAAE;gCACR,IAAI,EAAE,QAAiB;gCACvB,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC;6BAC7C;4BACD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;4BACxC,cAAc,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;yBAC5C;wBACD,QAAQ,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,aAAa,CAAC;qBAClD;oBACD,WAAW,EAAE,qCAAqC;iBACnD;aACF;YACD,QAAQ,EAAE;gBACR,YAAY;gBACZ,cAAc;gBACd,MAAM;gBACN,QAAQ;gBACR,OAAO;gBACP,UAAU;aACX;SACF;KACF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,+HAA+H;QACjI,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,YAAY;iBAC1B;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,cAAc;iBAC5B;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,EAAE,cAAc,CAAC;SACzC;KACF;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,uHAAuH;QACzH,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,YAAY;iBAC1B;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,cAAc;iBAC5B;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAiB;oBACvB,IAAI,EAAE;wBACJ,QAAQ;wBACR,QAAQ;wBACR,gBAAgB;wBAChB,cAAc;wBACd,WAAW;wBACX,SAAS;qBACV;oBACD,WAAW,EAAE,iBAAiB;iBAC/B;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,yCAAyC;iBACvD;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,SAAS,CAAC;SACpD;KACF;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EACT,kGAAkG;QACpG,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,YAAY;iBAC1B;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,cAAc;iBAC5B;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,EAAE,cAAc,CAAC;SACzC;KACF;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,2HAA2H;QAC7H,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,4BAA4B;iBAC1C;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,+CAA+C;iBAC7D;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,sCAAsC;iBACpD;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;KACF;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,yHAAyH;QAC3H,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,4BAA4B;iBAC1C;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAiB;oBACvB,WAAW,EACT,iDAAiD;iBACpD;gBACD,gBAAgB,EAAE;oBAChB,IAAI,EAAE,QAAiB;oBACvB,IAAI,EAAE;wBACJ,SAAS;wBACT,cAAc;wBACd,YAAY;wBACZ,uBAAuB;wBACvB,QAAQ;qBACT;oBACD,WAAW,EAAE,qBAAqB;iBACnC;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,mBAAmB;iBACjC;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,mCAAmC;iBACjD;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,OAAgB;oBACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;oBAClC,WAAW,EAAE,yBAAyB;iBACvC;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,SAAS,CAAC;SACpD;KACF;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,mIAAmI;QACrI,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,aAAa,EAAE;oBACb,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,eAAe;iBAC7B;aACF;YACD,QAAQ,EAAE,CAAC,eAAe,CAAC;SAC5B;KACF;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,2HAA2H;QAC7H,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAiB;oBACvB,WAAW,EACT,sDAAsD;iBACzD;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,kCAAkC;iBAChD;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAiB;oBACvB,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC;oBACzD,WAAW,EACT,uDAAuD;iBAC1D;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;KACF;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,6MAA6M;QAC/M,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;SACb;KACF;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,wKAAwK;QAC1K,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,OAAgB;oBACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;oBAClC,WAAW,EAAE,4EAA4E;iBAC1F;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,OAAgB;oBACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;oBAClC,WAAW,EAAE,0DAA0D;iBACxE;gBACD,eAAe,EAAE;oBACf,IAAI,EAAE,OAAgB;oBACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;oBAClC,WAAW,EAAE,uDAAuD;iBACrE;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,mCAAmC;iBACjD;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,0EAA0E;iBACxF;aACF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,0LAA0L;QAC5L,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;SACb;KACF;IACD;QACE,IAAI,EAAE,+BAA+B;QACrC,WAAW,EACT,kLAAkL;QACpL,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,YAAY;iBAC1B;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,iIAAiI;iBAC/I;gBACD,eAAe,EAAE;oBACf,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,8DAA8D;iBAC5E;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,CAAC;SACzB;KACF;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EACT,sMAAsM;QACxM,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,YAAY;iBAC1B;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,yBAAyB;iBACvC;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,EAAE,cAAc,CAAC;SACzC;KACF;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,4JAA4J;QAC9J,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;SACb;KACF;IACD;QACE,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EACT,6IAA6I;QAC/I,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,WAAW,EAAE;oBACX,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,mGAAmG;iBACjH;aACF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;CACF,CAAC"}

package/dist/trust/chain.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Hash-chain primitives for the ForgeOS Trust Ledger.
+ *
+ * Binary-compatible with the Python ledger.py implementation.
+ *
+ * Chain hash formula (matches Python _compute_chain_hash):
+ *   chain_hash = SHA-256("{seq}:{prev_hash}:{payload_hash}:{timestamp}")
+ *
+ * Payload hash formula (matches Python _sha256_dict):
+ *   payload_hash = SHA-256(JSON.stringify(payload, sortedKeys))
+ *   where JSON uses ensure_ascii=false equivalent (UTF-8) and sort_keys=True.
+ *
+ * The genesis sentinel is "GENESIS" (matches Python GENESIS_SENTINEL),
+ * NOT a zero-filled hex string.
+ */
+/** Genesis sentinel value — used as prev_hash for the first entry. */
+export declare const GENESIS_SENTINEL = "GENESIS";
+/** Schema version constant matching the Python implementation. */
+export declare const SCHEMA_VERSION = "1.0";
+/** Valid entry types — must match Python ENTRY_TYPES (§5.3 of architecture spec). */
+export declare const ENTRY_TYPES: Set<string>;
+/**
+ * Compute the chain hash for a ledger entry.
+ *
+ * Formula: SHA-256("{seq}:{prev_hash}:{payload_hash}:{timestamp}")
+ *
+ * This exactly replicates Python's:
+ *   material = f"{seq}:{prev_hash}:{payload_hash}:{timestamp}"
+ *   return hashlib.sha256(material.encode("utf-8")).hexdigest()
+ *
+ * @param seq - Zero-based integer sequence number of the entry.
+ * @param prevHash - chain_hash of the previous entry, or GENESIS_SENTINEL for seq 0.
+ * @param payloadHash - SHA-256 hex digest of the payload dict.
+ * @param timestamp - ISO 8601 UTC timestamp string.
+ * @returns 64-character hex SHA-256 digest.
+ */
+export declare function computeChainHash(seq: number, prevHash: string, payloadHash: string, timestamp: string): string;
+/**
+ * Compute the payload hash for a ledger entry.
+ *
+ * Replicates Python's _sha256_dict:
+ *   canonical = json.dumps(d, ensure_ascii=False, sort_keys=True)
+ *   return hashlib.sha256(canonical.encode("utf-8")).hexdigest()
+ *
+ * Keys are sorted recursively at the top level only (matching Python's
+ * sort_keys=True which sorts only the top-level dict keys in standard
+ * json.dumps — nested dicts are sorted too since Python json.dumps
+ * sort_keys=True applies recursively).
+ *
+ * IMPORTANT: JSON.stringify with a replacer that sorts keys at every
+ * level is required for full binary compatibility with Python's
+ * json.dumps(..., sort_keys=True) which sorts ALL nested dict keys.
+ *
+ * @param payload - The payload dict to hash.
+ * @returns 64-character hex SHA-256 digest.
+ */
+export declare function computePayloadHash(payload: Record<string, unknown>): string;
+/**
+ * JSON serialization matching Python's json.dumps(d, ensure_ascii=False, sort_keys=True).
+ *
+ * CRITICAL compatibility requirement:
+ * Python's json.dumps uses ": " (space after colon) and ", " (space after comma)
+ * as default separators. JavaScript's JSON.stringify uses ":" and "," (no spaces).
+ * For binary hash compatibility, we must reproduce Python's exact output.
+ *
+ * Python also sorts ALL dict keys recursively (sort_keys=True applies at every
+ * nesting level). JavaScript's JSON.stringify does not sort keys.
+ *
+ * Python's ensure_ascii=False means non-ASCII chars pass through unescaped.
+ * JavaScript's JSON.stringify also does not escape non-ASCII chars by default.
+ *
+ * This function produces output IDENTICAL to Python's json.dumps with those
+ * settings, enabling cross-language hash chain verification.
+ *
+ * @param value - Value to stringify.
+ * @returns JSON string matching Python's json.dumps output exactly.
+ */
+export declare function sortedJsonStringify(value: unknown): string;
+/**
+ * Serialize value to JSON matching Python's json.dumps(ensure_ascii=False, sort_keys=True).
+ *
+ * Uses ": " after colons and ", " after commas — exactly Python's default separators.
+ * Sorts all object keys recursively. Does not escape non-ASCII characters.
+ */
+export declare function pythonJsonDumps(value: unknown): string;
+//# sourceMappingURL=chain.d.ts.map

package/dist/trust/chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../../src/trust/chain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAE1C,kEAAkE;AAClE,eAAO,MAAM,cAAc,QAAQ,CAAC;AAEpC,qFAAqF;AACrF,eAAO,MAAM,WAAW,aAQtB,CAAC;AAEH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,MAAM,CAGR;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAG3E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAyBtD"}