human-to-code 0.1.12 → 0.1.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (111) hide show
  1. package/Readme.md +33 -45
  2. package/assets/banner.svg +9 -14
  3. package/assets/brand/social-card.svg +6 -6
  4. package/dist/agents/direct/application.d.ts +7 -0
  5. package/dist/agents/direct/application.d.ts.map +1 -0
  6. package/dist/agents/direct/application.js +30 -0
  7. package/dist/agents/direct/application.js.map +1 -0
  8. package/dist/agents/direct/discovery.d.ts +4 -0
  9. package/dist/agents/direct/discovery.d.ts.map +1 -0
  10. package/dist/agents/direct/discovery.js +101 -0
  11. package/dist/agents/direct/discovery.js.map +1 -0
  12. package/dist/agents/direct/file-memory.d.ts +20 -0
  13. package/dist/agents/direct/file-memory.d.ts.map +1 -0
  14. package/dist/agents/direct/file-memory.js +174 -0
  15. package/dist/agents/direct/file-memory.js.map +1 -0
  16. package/dist/agents/direct/generation-client.d.ts +4 -0
  17. package/dist/agents/direct/generation-client.d.ts.map +1 -0
  18. package/dist/agents/direct/generation-client.js +56 -0
  19. package/dist/agents/direct/generation-client.js.map +1 -0
  20. package/dist/agents/direct/index.d.ts +10 -0
  21. package/dist/agents/direct/index.d.ts.map +1 -0
  22. package/dist/agents/direct/index.js +10 -0
  23. package/dist/agents/direct/index.js.map +1 -0
  24. package/dist/agents/direct/languages.d.ts +5 -0
  25. package/dist/agents/direct/languages.d.ts.map +1 -0
  26. package/dist/agents/direct/languages.js +17 -0
  27. package/dist/agents/direct/languages.js.map +1 -0
  28. package/dist/agents/direct/marker-parser.d.ts +8 -0
  29. package/dist/agents/direct/marker-parser.d.ts.map +1 -0
  30. package/dist/agents/direct/marker-parser.js +68 -0
  31. package/dist/agents/direct/marker-parser.js.map +1 -0
  32. package/dist/agents/direct/presentation.d.ts +4 -0
  33. package/dist/agents/direct/presentation.d.ts.map +1 -0
  34. package/dist/agents/direct/presentation.js +28 -0
  35. package/dist/agents/direct/presentation.js.map +1 -0
  36. package/dist/agents/direct/types.d.ts +74 -0
  37. package/dist/agents/direct/types.d.ts.map +1 -0
  38. package/dist/agents/direct/types.js +2 -0
  39. package/dist/agents/direct/types.js.map +1 -0
  40. package/dist/agents/guided/api-grounding.d.ts +6 -0
  41. package/dist/agents/guided/api-grounding.d.ts.map +1 -0
  42. package/dist/agents/guided/api-grounding.js +158 -0
  43. package/dist/agents/guided/api-grounding.js.map +1 -0
  44. package/dist/agents/guided/index.d.ts +7 -0
  45. package/dist/agents/guided/index.d.ts.map +1 -0
  46. package/dist/agents/guided/index.js +7 -0
  47. package/dist/agents/guided/index.js.map +1 -0
  48. package/dist/agents/guided/patch-diff.d.ts +4 -0
  49. package/dist/agents/guided/patch-diff.d.ts.map +1 -0
  50. package/dist/agents/guided/patch-diff.js +31 -0
  51. package/dist/agents/guided/patch-diff.js.map +1 -0
  52. package/dist/agents/guided/types.d.ts +55 -0
  53. package/dist/agents/guided/types.d.ts.map +1 -0
  54. package/dist/agents/guided/types.js +2 -0
  55. package/dist/agents/guided/types.js.map +1 -0
  56. package/dist/agents/guided/workflow.d.ts +17 -0
  57. package/dist/agents/guided/workflow.d.ts.map +1 -0
  58. package/dist/agents/guided/workflow.js +1360 -0
  59. package/dist/agents/guided/workflow.js.map +1 -0
  60. package/dist/agents/guided/workspace-policy.d.ts +9 -0
  61. package/dist/agents/guided/workspace-policy.d.ts.map +1 -0
  62. package/dist/agents/guided/workspace-policy.js +83 -0
  63. package/dist/agents/guided/workspace-policy.js.map +1 -0
  64. package/dist/cli.d.ts.map +1 -1
  65. package/dist/cli.js +7 -107
  66. package/dist/cli.js.map +1 -1
  67. package/dist/index.d.ts +3 -1
  68. package/dist/index.d.ts.map +1 -1
  69. package/dist/index.js +4 -1
  70. package/dist/index.js.map +1 -1
  71. package/dist/pipeline/simple.d.ts +3 -160
  72. package/dist/pipeline/simple.d.ts.map +1 -1
  73. package/dist/pipeline/simple.js +3 -502
  74. package/dist/pipeline/simple.js.map +1 -1
  75. package/dist/pipeline/workflow.d.ts +5 -66
  76. package/dist/pipeline/workflow.d.ts.map +1 -1
  77. package/dist/pipeline/workflow.js +5 -1642
  78. package/dist/pipeline/workflow.js.map +1 -1
  79. package/dist/prompts/direct-conversion.d.ts +13 -0
  80. package/dist/prompts/direct-conversion.d.ts.map +1 -0
  81. package/dist/prompts/direct-conversion.js +35 -0
  82. package/dist/prompts/direct-conversion.js.map +1 -0
  83. package/dist/prompts/guided-patch.d.ts +14 -0
  84. package/dist/prompts/guided-patch.d.ts.map +1 -0
  85. package/dist/prompts/guided-patch.js +41 -0
  86. package/dist/prompts/guided-patch.js.map +1 -0
  87. package/dist/prompts/guided-repair.d.ts +12 -0
  88. package/dist/prompts/guided-repair.d.ts.map +1 -0
  89. package/dist/prompts/guided-repair.js +30 -0
  90. package/dist/prompts/guided-repair.js.map +1 -0
  91. package/dist/prompts/index.d.ts +6 -0
  92. package/dist/prompts/index.d.ts.map +1 -0
  93. package/dist/prompts/index.js +6 -0
  94. package/dist/prompts/index.js.map +1 -0
  95. package/dist/prompts/provider-output.d.ts +4 -0
  96. package/dist/prompts/provider-output.d.ts.map +1 -0
  97. package/dist/prompts/provider-output.js +12 -0
  98. package/dist/prompts/provider-output.js.map +1 -0
  99. package/dist/providers/providers.d.ts.map +1 -1
  100. package/dist/providers/providers.js +2 -10
  101. package/dist/providers/providers.js.map +1 -1
  102. package/docs/ARCHITECTURE.md +30 -28
  103. package/docs/MODULES.md +46 -8
  104. package/docs/SCALABILITY.md +10 -8
  105. package/docs/roadmap/README.md +1 -1
  106. package/docs/roadmap/ruby.md +1 -1
  107. package/package.json +1 -8
  108. package/dist/pipeline/deep-agent.d.ts +0 -242
  109. package/dist/pipeline/deep-agent.d.ts.map +0 -1
  110. package/dist/pipeline/deep-agent.js +0 -265
  111. package/dist/pipeline/deep-agent.js.map +0 -1
@@ -0,0 +1,55 @@
1
+ import type { ProjectProfileV1 } from "../../analysis/analyzer.ts";
2
+ import type { ConfigV1 } from "../../config/config.ts";
3
+ import type { ChangeContractV1, RunStatus, UsageSummaryV1, ValidationReportV1 } from "../../core/contracts.ts";
4
+ import type { RunStore } from "../../pipeline/run-store.ts";
5
+ import type { validateBaselineAndCandidate } from "../../pipeline/validation.ts";
6
+ import type { ProviderAdapter } from "../../providers/provider.ts";
7
+ export interface ProviderCertificationV1 {
8
+ matrixKey: string;
9
+ certified: boolean;
10
+ reason: string;
11
+ }
12
+ export interface RunCertificationV1 {
13
+ schemaVersion: 1;
14
+ supportMatrixVersion: string;
15
+ provider: ProviderCertificationV1;
16
+ profileCertified: boolean;
17
+ certified: boolean;
18
+ reasons: string[];
19
+ }
20
+ export interface GenerateRunOptions {
21
+ root: string;
22
+ profile: ProjectProfileV1;
23
+ contract: ChangeContractV1;
24
+ config: ConfigV1;
25
+ provider: ProviderAdapter;
26
+ store?: RunStore;
27
+ offline?: boolean;
28
+ signal?: AbortSignal;
29
+ }
30
+ export interface WorkflowOutcome {
31
+ runId: string;
32
+ status: RunStatus;
33
+ diagnostics: string[];
34
+ diff?: string;
35
+ report?: ValidationReportV1;
36
+ /** Cumulative provider usage for runs that reached the provider. */
37
+ usage?: UsageSummaryV1;
38
+ /** Fixed CLI exit code when status alone cannot distinguish the failure. */
39
+ exitCode?: number;
40
+ }
41
+ export interface ValidateStoredRunOptions {
42
+ runId: string;
43
+ store?: RunStore;
44
+ sandboxImage?: string;
45
+ dockerBinary?: string;
46
+ manualChecksPassed?: boolean;
47
+ /** Present only for guided validation; standalone validate never guesses credentials. */
48
+ provider?: ProviderAdapter;
49
+ /** Must exactly match the configuration persisted during generation. */
50
+ config?: ConfigV1;
51
+ signal?: AbortSignal;
52
+ /** Deterministic test seam; production always uses the strong-sandbox runner. */
53
+ validationRunner?: typeof validateBaselineAndCandidate;
54
+ }
55
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agents/guided/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EACV,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AACjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,CAAC,CAAC;IACjB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,uBAAuB,CAAC;IAClC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,gBAAgB,CAAC;IAC1B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,QAAQ,CAAC;IACjB,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,oEAAoE;IACpE,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,yFAAyF;IACzF,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,wEAAwE;IACxE,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,OAAO,4BAA4B,CAAC;CACxD"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agents/guided/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,17 @@
1
+ /** Auditable generation, isolated validation, and explicit application workflow. */
2
+ import { type ProjectProfileV1 } from "../../analysis/analyzer.ts";
3
+ import { type ConfigV1 } from "../../config/config.ts";
4
+ import { type ChangeContractV1 } from "../../core/contracts.ts";
5
+ import { type ContextManifestV1 } from "../../context/context.ts";
6
+ import { RunStore } from "../../pipeline/run-store.ts";
7
+ import type { GenerateRunOptions, ValidateStoredRunOptions, WorkflowOutcome } from "./types.ts";
8
+ export type { GenerateRunOptions, ProviderCertificationV1, RunCertificationV1, ValidateStoredRunOptions, WorkflowOutcome, } from "./types.ts";
9
+ export { createValidationPlan, resolveWorkspaceConfig } from "./workspace-policy.ts";
10
+ export { renderPatchDiff } from "./patch-diff.ts";
11
+ export declare function buildContextPreview(rootInput: string, profile: ProjectProfileV1, contract: ChangeContractV1, config: ConfigV1, offline?: boolean): Promise<ContextManifestV1>;
12
+ export declare function generateRun(input: GenerateRunOptions): Promise<WorkflowOutcome>;
13
+ export declare function validateStoredRun(options: ValidateStoredRunOptions): Promise<WorkflowOutcome>;
14
+ export declare function applyVerifiedRun(runId: string, store?: RunStore): Promise<WorkflowOutcome>;
15
+ export declare function rollbackAppliedRun(runId: string, store?: RunStore): Promise<WorkflowOutcome>;
16
+ export declare function rootRelative(root: string, path: string): string;
17
+ //# sourceMappingURL=workflow.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../src/agents/guided/workflow.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAMpF,OAAO,EAA0C,KAAK,gBAAgB,EAA2B,MAAM,4BAA4B,CAAC;AAGpI,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAQL,KAAK,gBAAgB,EAStB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAalC,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAavD,OAAO,KAAK,EACV,kBAAkB,EAGlB,wBAAwB,EACxB,eAAe,EAChB,MAAM,YAAY,CAAC;AAIpB,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAwPlD,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EAAE,QAAQ,EAChB,OAAO,UAA0C,GAChD,OAAO,CAAC,iBAAiB,CAAC,CAsB5B;AAmGD,wBAAsB,WAAW,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CA0KrF;AAkpBD,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,eAAe,CAAC,CAGnG;AAoJD,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,WAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CA+CtG;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,WAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CA6CxG;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI/D"}